Skip MSBuild on run-aspire.cmd when binaries are still newer than sources.

dotnet run always evaluates the Aspire graph. A second launch after Ctrl+C should not wait on that. Co-authored-by: Cursor <cursoragent@cursor.com>
2026-08-20 08:45:44 +03:00
parent 7266678ee9
commit 9bd1b8eea0
9 changed files with 504 additions and 13 deletions
@@ -0,0 +1,34 @@
+# Вне очереди
+
+Задачи, которых нет в срезах 1–9. Это срез без номера, чтобы не спорить со срезом 10.
+Каждый раздел — отдельная договорённость; фазы живут в индексе в секции «Вне очереди».
+
+## Пропуск сборки при запуске
+
+### Зачем
+
+`run-aspire.cmd` каждый раз вызывает `dotnet run`, а тот — MSBuild графа Aspire, даже когда
+исходники не менялись. Повторный запуск после Ctrl+C стоит десятки секунд впустую: SDK
+пересчитывает хост, хотя dll на месте.
+
+### Было / Стало / Почему
+
+**Было.** Скрипт всегда `dotnet run --project src/HSchool.AppHost`. Аргументы проходили насквозь.
+
+**Стало.** Если `HSchool.AppHost.dll` и `HSchool.Server.dll` новее входов (C#, csproj, props,
+`global.json`), скрипт делает `dotnet run --no-build`. Иначе — `dotnet build`, потом `--no-build`.
+`--rebuild` собирает всегда. Конфигурация (`-c` / `--configuration`) выбирает, какие dll сравнивать;
+по умолчанию Debug, как у `dotnet run`.
+
+**Почему.** Инкрементальный MSBuild всё равно оценивает Aspire SDK. `--no-build` это пропускает.
+Клиентский TypeScript и JSONC модов не входы: Vite и каталог читают диск (`ContentRoot`), а не
+`bin`. Тестовые проекты AppHost не ссылается — их правки запуск не пересобирают.
+
+Правила «устарел ли билд» живут в `tools/apphost-uptodate.ps1` (то, что вызывает `.cmd`) и в
+`LaunchBuildStamp` (то, что проверяют тесты). Менять надо оба.
+
+### Что не входит
+
+Голый `dotnet run --project src/HSchool.AppHost` по-прежнему собирает — так удобнее агентам с
+грязным деревом. Linux-обёртки нет: точка входа Windows — `.cmd`. Протокол, HTTP и сейв не
+трогаем.
@@ -0,0 +1,45 @@
+# Фаза 49. Пропуск сборки при запуске
+
+## Зависимости
+
+Нет. Скрипт запуска уже есть.
+
+## Зачем
+
+Повторный `run-aspire.cmd` без правок в C# не должен ждать MSBuild графа Aspire. Сборка нужна
+только когда входы новее dll или когда просили `--rebuild`.
+
+## Задачи
+
+- [x] `tools/apphost-uptodate.ps1`: выход 0, если AppHost и Server dll новее входов; 1 — если
+      нет dll или вход новее. Входы: `*.cs` / `*.csproj` / `*.props` под `src/` без `bin` /
+      `obj` / `node_modules`, плюс `global.json`, `Directory.Build.props`, `Directory.Packages.props`.
+      TypeScript и JSONC не входы
+- [x] `run-aspire.cmd` вызывает проверку; при 0 — `dotnet run --no-build` и пишет, что сборка
+      пропущена; иначе `dotnet build`, затем `--no-build`. `--rebuild` всегда собирает и не
+      уходит в AppHost. `-c` / `--configuration` выбирают папку `bin`
+- [x] `LaunchBuildStamp` с теми же правилами, тесты на временных папках без `AppHostFixture`
+- [x] `AGENTS.md` и `README.md`: повторный запуск без правок — `run-aspire.cmd`; голый
+      `dotnet run` по-прежнему собирает. `--rebuild` упомянут
+
+## Тесты, без которых фаза не закрыта
+
+- [x] Нет dll — нужно собирать
+- [x] Dll новее всех входов — пропускать
+- [x] `.cs` новее dll — собирать
+- [x] `.ts` или `.jsonc` новее dll — пропускать
+- [x] Файл в `bin` / `obj` / `node_modules` не считается входом
+- [x] `Directory.Packages.props` новее dll — собирать
+- [x] `-c Release` смотрит `bin/Release`, а не Debug
+
+## Критерий готовности
+
+- Два запуска `run-aspire.cmd` подряд без правок: второй пишет, что сборка пропущена, и
+  стартует AppHost
+- `run-aspire.cmd --rebuild` собирает даже со свежими dll
+- `dotnet test` проходит; тесты штампа не поднимают хост
+
+## Стоп
+
+Не менять Aspire-граф, протокол, сейвы. Не вшивать `--no-build` в голый `dotnet run`. Не
+сканировать `tests/` и не считать клиентский TS поводом пересобрать сервер.
@@ -222,3 +222,11 @@
 | [47. Пак romance](47-romance-pack.md) | ⬜ | Ориентация, симпатия, пара 18+, патч тем |

 46 стоит на 37 и 42; 47 — на 42 и 23. `example` не трогать.
+
+## Вне очереди
+
+Не срез 10: задачи вне игровых срезов. Дизайн: [`../design/off-queue.md`](../design/off-queue.md).
+
+| Фаза | Статус | Зачем |
+| --- | --- | --- |
+| [49. Пропуск сборки при запуске](49-skip-stale-build.md) | 🔄 | `run-aspire.cmd` не гоняет MSBuild, если dll свежие |