devcontour-harness 0.1.0-alpha.44 → 0.1.0-alpha.46

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (57) hide show
  1. package/README.md +20 -2
  2. package/docs/architecture.md +8 -0
  3. package/docs/contracts.md +122 -2
  4. package/docs/release-notes/0.1.0-alpha.45.md +77 -0
  5. package/docs/release-notes/0.1.0-alpha.46.md +63 -0
  6. package/docs/upgrade.md +98 -18
  7. package/lib/contracts/cli.d.ts +68 -0
  8. package/lib/contracts/cli.js +6 -1
  9. package/lib/contracts/events.d.ts +5 -0
  10. package/lib/contracts/events.js +2 -0
  11. package/lib/contracts/execution.d.ts +39 -0
  12. package/lib/contracts/execution.js +20 -2
  13. package/lib/contracts/handoff.d.ts +1 -0
  14. package/lib/contracts/handoff.js +6 -1
  15. package/lib/contracts/policy.d.ts +39 -0
  16. package/lib/contracts/policy.js +64 -0
  17. package/lib/contracts/profiles.d.ts +6 -0
  18. package/lib/contracts/published.d.ts +70 -0
  19. package/lib/contracts/result.d.ts +91 -0
  20. package/lib/contracts/result.js +31 -1
  21. package/lib/contracts/review.d.ts +1 -1
  22. package/lib/control/harness.d.ts +24 -2
  23. package/lib/control/workflow.d.ts +5 -1
  24. package/lib/control/workflow.js +18 -3
  25. package/lib/engine/engine.d.ts +30 -5
  26. package/lib/engine/engine.js +104 -13
  27. package/lib/engine/result.js +7 -3
  28. package/lib/engine/runner.d.ts +8 -0
  29. package/lib/engine/runner.js +96 -3
  30. package/lib/environment/git-trust.js +3 -0
  31. package/lib/environment/process.d.ts +2 -0
  32. package/lib/environment/process.js +7 -1
  33. package/lib/explain/state.js +1 -1
  34. package/lib/handoff/pack.js +7 -1
  35. package/lib/index.d.ts +1 -0
  36. package/lib/index.js +1 -0
  37. package/lib/integrations/connector/history.js +1 -1
  38. package/lib/integrations/connector/summary.js +2 -1
  39. package/lib/profiles/resolve.d.ts +6 -0
  40. package/lib/projections/attempt.d.ts +4 -2
  41. package/lib/projections/attempt.js +14 -1
  42. package/lib/report/compute.js +4 -3
  43. package/lib/storage/document.d.ts +26 -2
  44. package/lib/verification/acceptance.d.ts +12 -0
  45. package/lib/verification/acceptance.js +62 -7
  46. package/lib/verification/applicability.d.ts +157 -0
  47. package/lib/verification/applicability.js +406 -0
  48. package/lib/verification/gates.d.ts +6 -0
  49. package/lib/verification/proof.d.ts +18 -4
  50. package/lib/verification/proof.js +52 -9
  51. package/package.json +1 -1
  52. package/schemas/execution-document.schema.json +73 -1
  53. package/schemas/execution-policy.schema.json +38 -0
  54. package/schemas/handoff-pack.schema.json +4 -0
  55. package/schemas/result-envelope.schema.json +138 -2
  56. package/schemas/run-event.schema.json +4 -0
  57. package/schemas/run-result.schema.json +138 -2
package/README.md CHANGED
@@ -5,7 +5,7 @@ Headless-движок исполнения инженерных поручени
5
5
  интеграция с принятой веткой через compare-and-swap и машинный результат с SHA
6
6
  и доказательствами.
7
7
 
8
- > Статус: `0.1.0-alpha.44` — предварительный выпуск (alpha). Договоры
8
+ > Статус: `0.1.0-alpha.46` — предварительный выпуск (alpha). Договоры
9
9
  > `v1alpha1` могут измениться между alpha-версиями; закрепляйте точную версию.
10
10
  > Файл → ревью плана → кандидат → интеграция → принятие → результат JSON, с
11
11
  > ограниченным восстановлением, повторным использованием кандидата, бюджетами,
@@ -28,7 +28,7 @@ Headless-движок исполнения инженерных поручени
28
28
  Из npm — точная версия (воспроизводимо) или последняя alpha по тегу:
29
29
 
30
30
  ```sh
31
- npm install --save-exact devcontour-harness@0.1.0-alpha.44 # точная версия
31
+ npm install --save-exact devcontour-harness@0.1.0-alpha.46 # точная версия
32
32
  # или: npm install --save-exact devcontour-harness@alpha # текущая alpha
33
33
  npx harness --version
34
34
  ```
@@ -149,6 +149,24 @@ PASS» нет. Адаптеры хоста реализуют порты `Execut
149
149
  `devcontour-harness/schemas/<имя>.schema.json`. Декларации используют типы
150
150
  Node.js: TypeScript-потребителю нужен `@types/node` (или `skipLibCheck`).
151
151
 
152
+ ## Выпуск 0.1.0-alpha.46
153
+
154
+ Выдача не начинается, пока хост ждёт подтверждения перенесённой базы
155
+ (`base-check`), и восстановление отказа не снимает такую паузу. Остановленные
156
+ задания технической очереди получают время и событие исхода, пакет передачи —
157
+ ключ задания в `repairs`, а условный gate потребителя исполняется, когда SHA
158
+ его провайдера сдвинулся с зелёного SHA.
159
+ Подробно — [заметки выпуска](docs/release-notes/0.1.0-alpha.46.md).
160
+
161
+ ## Выпуск 0.1.0-alpha.45
162
+
163
+ Gate задачи может объявить `when: { paths: [...] }`: runner исполняет его,
164
+ только если настоящий diff Git от последнего зелёного SHA gate задевает эти
165
+ пути или неявные входы, а иначе пишет evidence `not-applicable` — не PASS и
166
+ не провал. Хост проверяет пропущенные gates набора на итоговом SHA через
167
+ `coverageChanges` и `uncoveredGates`; git хоста не читает объекты замены.
168
+ Подробно — [заметки выпуска](docs/release-notes/0.1.0-alpha.45.md).
169
+
152
170
  ## Выпуск 0.1.0-alpha.44
153
171
 
154
172
  Совместная проверка, прерванная до результата gates (остановка хоста,
@@ -294,6 +294,14 @@ runtime-граф пакета.
294
294
  осталось классов. Поэтому разовый отказ окружения под циклом восстановления
295
295
  останавливает выдачу только до его следующего шага, а без цикла пауза стоит
296
296
  до решения человека. Пауза человека этим не снимается.
297
+ - **Ожидание проверки базы.** Пока в `control.waits` есть запись
298
+ `base-check` (хост перенёс базу и ещё не подтвердил её), `claim` не выдаёт
299
+ работу при любом значении `paused`, а `clearFailure`, снявший последний
300
+ класс отказа паузы `runtime`, не снимает паузу, а переводит её в
301
+ `base-check` (`pausedAt` — время перехода; событие `control.paused` с этой причиной; `queuePause` —
302
+ ожидание controller, а не «исправить окружение»). Снимает ожидание только
303
+ `resume` — явный маршрут человека «подтвердить базу и начать»; `blockers`
304
+ называет причину кодом `PAUSED`.
297
305
  - **Gates на SHA вне попытки.** `runGatesAt` исполняет названные gates
298
306
  компонента на закреплённом SHA так же, как integration поручения:
299
307
  отдельное рабочее дерево, снимки зависимостей, ресурсы, lifecycle и
package/docs/contracts.md CHANGED
@@ -173,6 +173,112 @@ lockfile, установка докачивает разницу; `miss` — о
173
173
  `artifacts[]`; их копии с теми же правилами пишутся в `artifactFiles` записи
174
174
  совместной проверки (`<каталог проверки>/<gate>.artifacts/`).
175
175
 
176
+ `repositories[].gates[].when` — необязательное условие применимости gate
177
+ задачи: `{ paths: [...] }`, 1–64 шаблона путей **от корня репозитория**
178
+ (POSIX-glob: `**` целым сегментом — любое число сегментов, `*` и `?` — внутри
179
+ сегмента, `{a,b}` без вложенности; без `..` и `.` (в том числе внутри `{}`),
180
+ пустых сегментов, ведущего `/`, `\`, `[]` и отрицания). Шаблон привязан к
181
+ корню, как не принято в gitignore: `*.md` задевает только файлы корня, для
182
+ любой глубины — `**/*.md`; `**` внутри `{}` целым сегментом не считается.
183
+ Шаблон задевает всё внутри совпавшего каталога (`web` и `web/` задевают
184
+ `web/a.ts`), а изменённый путь, который сам — каталог-предок буквального
185
+ префикса шаблона, задевает его (`vendor/lib/**` — gitlink `vendor/lib`, файл
186
+ `vendor` на месте каталога), как и путь, чьи сегменты совпадают с первыми
187
+ сегментами шаблона до `**` (`packages/*/src/**` — gitlink `packages/ui`).
188
+ Подмодули и ссылки под `**` называют в `when.paths` явно. Сравнение — без учёта регистра и в NFC: лишнее
189
+ совпадение только чаще исполняет gate. Без поля поведение и digest политики
190
+ прежние. `policyIssues` отклоняет репозиторий, у которого нет ни одного test
191
+ gate без `when`, и `when` у генеративного gate (`property`). У
192
+ `workspaceGates` поля нет (строгая схема его отклоняет). В режиме порядка
193
+ массива (gate без `dependsOn`) каждый более ранний check gate — предпосылка
194
+ следующих, поэтому `when` у check gate перед безусловным test gate не
195
+ действует: gate исполняется всегда.
196
+
197
+ Решение принимает runner в каждой фазе попытки по настоящему diff Git, а не по
198
+ отчёту исполнителя. Опора — **последний зелёный SHA** gate: integration SHA
199
+ принятой попытки этого репозитория, где gate прошёл под тем же основанием
200
+ `gateBasis` (определение `gateDigest`, описания его ресурсов, определения и
201
+ ресурсы его предпосылок `gatePrerequisites` транзитивно, окружение,
202
+ lifecycle, `prepare`, хранилище зависимостей и toolchain репозитория,
203
+ изоляция, версия harness) и который — предок базы попытки. Нет такого SHA —
204
+ gate исполняется. Diff кандидата — `зелёный..candidate`, интеграции — ещё и
205
+ `зелёный..integration`: всё, что попало в target после зелёного SHA (другие
206
+ задачи, задачи с суженной областью, коммиты мимо harness), входит в решение.
207
+ Diff — `git diff --no-renames --no-ext-diff --no-textconv --no-relative
208
+ --ignore-submodules=none --name-only` с `--no-replace-objects` (его несёт
209
+ `gitHardening`, то есть каждый вызов git хоста через `hostGitArgs`); переименование даёт оба пути, удаление, смена
210
+ режима и gitlink — свои пути. Есть `refs/replace/*` или `info/grafts` — diff
211
+ неполон. Условный gate **исполняется**, если: он назван требованием
212
+ поручения, договором проверки (свойство, эталон, обязательство) или это
213
+ `requirement-source` (`proofGates`); зелёного SHA нет; diff не прочитан,
214
+ неполон, больше 5000 путей или пуст (попытка без изменений); diff задевает
215
+ шаблон `when.paths`; diff задевает неявный вход — `protectedPaths`, каталог
216
+ `.harness/`, в любом каталоге манифест, lockfile, файл версии инструментов
217
+ или настройка checkout (`package.json`, lockfiles npm/pnpm/yarn/bun, `.npmrc`,
218
+ `.nvmrc`, `Cargo.*`, `go.mod`/`go.sum`/`go.work`, `pyproject.toml`,
219
+ `poetry.lock`, `uv.lock`, `Pipfile*`, `requirements*.txt`, `Gemfile*`,
220
+ `composer.*`, `.gitattributes`, `.gitmodules`, `.lfsconfig`) или путь,
221
+ названный в argv команды gate (с учётом `cwd`); с зелёного SHA сдвинулась
222
+ база провайдеров (`providerMovement`): у провайдера из `dependsOn`
223
+ репозитория или из снимков зависимостей (`AttemptState.dependencies`, в том
224
+ числе транзитивного) другой SHA, чем у принятой попытки зелёного SHA, либо
225
+ снимка нет у одной из попыток — изменение провайдера меняет вход gate
226
+ потребителя, даже если diff потребителя не задел его путей (artifacts
227
+ провайдера, пересобираемые в каждой попытке, не сравниваются: при том же SHA
228
+ невоспроизводимая сборка не должна отключать условные gates; смену
229
+ `dependencyBuild` провайдера при том же SHA правило не видит); он —
230
+ предпосылка (`gatePrerequisites`) исполняемого gate области. Отключить это
231
+ правило у gate нельзя. Общие настройки инструментов
232
+ неявными входами **не** считаются — их перечисляют в `when.paths` сами:
233
+ корневые `tsconfig*.json`, `eslint.config.*`, `vitest/jest/playwright.config.*`,
234
+ `Makefile`, `Dockerfile`, `.env*`, скрипты, вызванные косвенно (например из
235
+ `package.json`). Иначе gate не исполняется, а runner пишет запись evidence
236
+ вида `not-applicable` (`passed: false`, `exitCode: -1`, без команды и лога) с
237
+ полем `notApplicable`: `gateDigest`, `patterns`, `ranges[]` `{from, to}`
238
+ (`ranges[0].from` — зелёный SHA, последний `to` — SHA фазы), `count`, первые
239
+ 50 путей не длиннее 1000 символов `files`, `pathsDigest` — SHA-256
240
+ отсортированного полного списка, разделённого NUL. Событие `attempt.gate`
241
+ такой записи несёт `notApplicable: true`. Исполненный условный gate пишет в
242
+ свою запись `test` поле `gateBasis`.
243
+
244
+ Неприменимость — не PASS. `Engine.evidence` принимает её только на SHA фазы
245
+ попытки (diff кончается на нём) и только пока на этом SHA нет записи `test`
246
+ того же gate. Приёмка (`finish`) и получатель receipt (`resultProblems`)
247
+ решают по записи `test`, если она есть, и засчитывают неприменимость
248
+ обязательному gate только без неё и только когда: у gate в их политике есть
249
+ `when` с тем же `gateDigest`; gate не из `proofGates` поручения; ни один
250
+ исполненный gate той же фазы не опирается на него как на предпосылку.
251
+ Доказательство требования (`requirementProof`, testcase) и договора проверки
252
+ (`propertyProofProblem`) читает только записи `test`. Receipt перечисляет
253
+ неприменимые gates ссылками evidence вида `not-applicable` с `notApplicable`.
254
+ Функции: `changedPaths`, `coverageChanges`, `gateBasis`, `gateDecisions`,
255
+ `pathApplicability`, `matchingPaths`, `gatePathRegExp`, `proofGates`,
256
+ `providerMovement`, `notApplicableProblem`, `gateDigest`. У `gateDecisions`
257
+ вход `providersMoved` необязателен: без него провайдеры считаются не
258
+ сдвинувшимися — вызывающий ручается, что `changedFor` даёт зелёный SHA только
259
+ под теми же SHA провайдеров (runner передаёт его всегда). Основание включает версию harness:
260
+ после обновления пакета каждый условный gate исполняется один раз. Не входят
261
+ в основание образ контейнера по изменяемому тегу и переменные окружения
262
+ хоста, передаваемые по имени (`environment.inherit`): их смену gate не видит.
263
+ `matchingPaths` и `gatePathRegExp` намеренно расширяют совпадение (регистр,
264
+ NFC, каталоги-предки) и годятся только там, где совпадение исполняет
265
+ проверку, а не разрешает запись.
266
+
267
+ Покрытие набора поручений (`uncoveredGates(repositories, works, changes?)`,
268
+ `Engine.uncoveredGates(workIds, changes?, finalShas?)`): gate с `when`, признанный
269
+ неприменимым на integration хотя бы одним поручением, решается по
270
+ объединённому diff набора `changes[repositoryId]`. Его строит
271
+ `coverageChanges(repoPath, evidence, finalSha)`: от зелёного SHA каждой такой
272
+ записи (`notApplicable.ranges[0].from`) до итогового SHA. Diff засчитывается,
273
+ только если он полон, у всех пар один конец — итоговый SHA репозитория из
274
+ `finalShas` — и среди начал есть зелёный SHA
275
+ каждой записи неприменимости gate; иначе он считается отсутствующим. Задетый
276
+ diff — или без `changes`, или под другим определением gate — gate непокрыт,
277
+ даже если другое поручение его прошло, и хост исполняет его один раз на
278
+ итоговом SHA (`runGatesAt`); не задетый — не пробел. Для политики без `when`
279
+ правило прежнее. Совместная проверка (`workspaceGates`, `JointRunner`) не
280
+ меняется.
281
+
176
282
  `policyDigest(policy)` — digest загруженной политики целиком: им сверяются
177
283
  применённая политика (`control.appliedPolicy`) и запрос операции
178
284
  `control.reconfigure`. `executionDigest(policy)` — digest исполнительной
@@ -356,7 +462,7 @@ writer и reviewer кода получают список файлов набо
356
462
  | `GraphState` | Граф, его digest, digest политики, техническое согласование (с `approval.context` — снимок контекста, который видел reviewer плана; только он исполняется и принимается) |
357
463
  | `WorkState` | Закреплённое поручение, статус, попытки, результат, класс отказа, согласованные digests, удержание, блок бюджета, версия корпуса, эпизод восстановления по свойству |
358
464
  | `AttemptState` | Владение (`token`, `owner`, `leaseUntil`), runtime и reviewer, фаза, SHA, evidence, раскрытые gates, потребители и что у них проверено, версия проверок, контекст, зависимости и свежесть, основание и источник reuse, черновик, выбор из очереди, замеры, `engineVersion`, `consumerVersion` |
359
- | `EvidenceRecord` | Фаза, SHA, gate, исход, команда, лог, digest, testcases, отчёт свойств, осмотр ревью, версия проверок |
465
+ | `EvidenceRecord` | Фаза, SHA, gate, исход (`test`, `review`, `not-applicable`), команда, лог, digest, testcases, отчёт свойств, осмотр ревью, версия проверок |
360
466
  | `ControlState` | Пауза и её причина, классы отказов, ожидания, применённая политика, reconfigure |
361
467
  | `ControllerLease` | Единственный действующий controller; `engineVersion` (с 0.1.0-alpha.2) — версия движка процесса: роль другой версии или без версии не перенимается, пока она жива |
362
468
  | `CallRecord` | Вызов модели: стадия, runtime, сообщённая модель, версия, исход, процесс, монотонное время, закреплённая атрибуция (`workId`, `groupId`, `workIds`), вид предмета (`subjectKind`: поручение, группа, прочее), счётчики, стоимость и её источник |
@@ -556,6 +662,18 @@ Schema строит подделку каждого поля (другое зн
556
662
  | `evidence[].summary` | сведение | описание записи |
557
663
  | `evidence[].consumer` | ожидание получателя | объявленный потребитель |
558
664
  | `evidence[].checks` | ожидание получателя | версия проверок, вычисленная получателем, у каждой записи |
665
+ | `evidence[].notApplicable` | согласованность | только у записи not-applicable: обычный gate с when, не доказательство и не предпосылка исполненного |
666
+ | `evidence[].notApplicable.gateDigest` | ожидание получателя | digest определения gate у получателя |
667
+ | `evidence[].notApplicable.patterns` | сведение | пути when; их задаёт определение gate |
668
+ | `evidence[].notApplicable.patterns[]` | сведение | пути when; их задаёт определение gate |
669
+ | `evidence[].notApplicable.ranges` | сведение | diff фазы — наблюдение Git исполнителя |
670
+ | `evidence[].notApplicable.ranges[]` | сведение | diff фазы — наблюдение Git исполнителя |
671
+ | `evidence[].notApplicable.ranges[].from` | сведение | diff фазы — наблюдение Git исполнителя |
672
+ | `evidence[].notApplicable.ranges[].to` | сведение | diff фазы — наблюдение Git исполнителя |
673
+ | `evidence[].notApplicable.count` | сведение | diff фазы — наблюдение Git исполнителя |
674
+ | `evidence[].notApplicable.files` | сведение | diff фазы — наблюдение Git исполнителя |
675
+ | `evidence[].notApplicable.files[]` | сведение | diff фазы — наблюдение Git исполнителя |
676
+ | `evidence[].notApplicable.pathsDigest` | сведение | diff фазы — наблюдение Git исполнителя |
559
677
  | `evidence[].tests` | ожидание получателя | доказательство названного testcase решающей записью |
560
678
  | `evidence[].tests[]` | ожидание получателя | элемент названного testcase; прочие элементы — сведения |
561
679
  | `evidence[].tests[].id` | ожидание получателя | ID названного testcase |
@@ -1234,7 +1352,9 @@ HTML ≤ 1 МБ. Усечение отмечено флагом и ограни
1234
1352
  `complete` и причины неполноты (вызовы без стоимости, незавершённые,
1235
1353
  брошенные, попытки без учёта); при неполном расходе сумма — нижняя граница
1236
1354
  («≥ $X (неполно: …)» в Markdown), остаток — `null`. `repairs` —
1237
- восстановления незавершённых заданий графов;
1355
+ восстановления незавершённых заданий графов: `graphId`, `key` (ключ
1356
+ задания; у графа после новой редакции их несколько, и прежнее — `stale`),
1357
+ `status` задания, `used` и `budget`; у пакетов прежних версий `key` нет;
1238
1358
  - `next` — следующий шаг доски: первое решение; иначе идущая попытка со
1239
1359
  свежим сроком владения — ждать (без controller — до `leaseUntil`); попытка
1240
1360
  с истёкшим сроком или очередь без controller — `command: "harness run"` (run истечёт брошенную
@@ -0,0 +1,77 @@
1
+ # devcontour-harness 0.1.0-alpha.45
2
+
3
+ Gate задачи может быть условным: `when: { paths: [...] }`. Runner решает по
4
+ настоящему diff Git, а не по отчёту исполнителя, и за неприменимый gate
5
+ пишет evidence `not-applicable`, которое не считается ни PASS, ни провалом.
6
+ `stateVersion` и `policyVersion` прежние; политика без `when` даёт прежние
7
+ digest и поведение.
8
+
9
+ ## Изменения
10
+
11
+ - **Условные gates.** `repositories[].gates[].when.paths` — 1–64 шаблона
12
+ путей от корня репозитория (POSIX-glob `**`, `*`, `?`, `{a,b}` без
13
+ вложенности; без `..`, `.`, ведущего `/`, `\`, `[]` и отрицания).
14
+ Совпадение без учёта регистра и в NFC; шаблон задевает всё внутри
15
+ совпавшего каталога и каталоги-предки своего буквального префикса
16
+ (gitlink подмодуля). `policyIssues` требует у репозитория хотя бы один
17
+ test gate без `when` и отклоняет `when` у генеративного gate
18
+ (`property`); у `workspaceGates` поля нет.
19
+ - **Решение от последнего зелёного SHA.** Опора — integration SHA принятой
20
+ попытки репозитория, где gate прошёл под тем же основанием `gateBasis`
21
+ (определение gate и его ресурсы, транзитивные предпосылки, окружение,
22
+ lifecycle, `prepare`, хранилище зависимостей, toolchain, изоляция, версия
23
+ harness) и который — предок базы попытки. Diff кандидата —
24
+ `зелёный..candidate`, интеграции — ещё и `зелёный..integration`, так что
25
+ коммиты других задач и мимо harness входят в решение. Gate исполняется,
26
+ если зелёного SHA нет; diff не прочитан, неполон, больше 5000 путей или
27
+ пуст; задет шаблон `when.paths`; задет неявный вход (`protectedPaths`,
28
+ `.harness/`, манифесты, lockfiles, файлы версий инструментов,
29
+ `.gitattributes`, `.gitmodules`, `.lfsconfig` в любом каталоге, пути из
30
+ argv команды gate); gate нужен доказательству поручения (`proofGates`) или
31
+ он — предпосылка исполняемого gate. Общие настройки инструментов
32
+ перечисляют в `when.paths` сами.
33
+ - **Evidence `not-applicable`.** Запись `passed: false`, `exitCode: -1`, без
34
+ команды и лога, с полем `notApplicable` (`gateDigest`, `patterns`,
35
+ `ranges`, `count`, первые 50 путей `files`, `pathsDigest`). Исполненный
36
+ условный gate пишет в запись `test` поле `gateBasis`. Событие
37
+ `attempt.gate` несёт `notApplicable: true`, ссылка evidence receipt — вид
38
+ `not-applicable`, проекция попытки — `gates.notApplicable`. Приёмка и
39
+ получатель receipt засчитывают неприменимость только обычному gate с тем
40
+ же `gateDigest`, не нужному доказательству и не опоре исполненного gate;
41
+ запись `test` того же gate и SHA решает раньше. Доказательства
42
+ требований, testcase и свойств читают только записи `test`.
43
+ - **Покрытие набора на итоговом SHA.**
44
+ `coverageChanges(repoPath, evidence, finalSha)` строит объединённый diff
45
+ от зелёного SHA каждой записи неприменимости до итогового SHA;
46
+ `uncoveredGates(repositories, works, changes, finalShas)` и
47
+ `Engine.uncoveredGates(workIds, changes, finalShas)` считают пропущенный
48
+ gate непокрытым, если diff его задевает, отсутствует, неполон, кончается
49
+ не на `finalShas[repo]`, не начинается от зелёного SHA каждой записи или
50
+ записан под другим определением gate. Хост исполняет такие gates один раз
51
+ через `runGatesAt`. Совместная проверка не меняется.
52
+ - **Защита git хоста.** `gitHardening` несёт `--no-replace-objects` (и
53
+ `GIT_NO_REPLACE_OBJECTS=1` для дочерних git): объекты замены не влияют на
54
+ diff, требования, область записи и применимость; `refs/replace/*` или
55
+ `info/grafts` делают diff неполным. Diff применимости идёт с
56
+ `--no-renames`, `--no-ext-diff`, `--no-textconv`, `--no-relative` и
57
+ `--ignore-submodules=none`, так что смена gitlink подмодуля видна.
58
+ - **Новые экспорты.** `changedPaths`, `coverageChanges`, `gateBasis`,
59
+ `gateDecisions`, `gatePathRegExp`, `matchingPaths`, `notApplicableProblem`,
60
+ `pathApplicability`, `proofGates`, типы `ChangedPaths`, `GateDecision`,
61
+ `PathDecision`.
62
+
63
+ ## Совместимость
64
+
65
+ - Прежний хост читает `attempt.gate` с `notApplicable: true` как провал, а
66
+ прежний получатель receipt отклоняет вид ссылки `not-applicable`: хост
67
+ понимает новый вид evidence до того, как в политике появится `when`.
68
+ - Хост со своим хранилищем сохраняет вид `not-applicable` и поля `gateBasis`
69
+ и `notApplicable` и показывает неприменимый gate отдельно от PASS и
70
+ провала. Хост, проверяющий профиль набора на итоговом SHA, передаёт
71
+ `changes` из `coverageChanges`, `finalShas` и gates политики harness.
72
+ - Основание включает версию harness: после обновления каждый условный gate
73
+ исполняется один раз. Добавление `when` меняет digest политики —
74
+ согласования, привязанные к нему, повторяют.
75
+ - Состояние с evidence `not-applicable` или полями `gateBasis` и
76
+ `notApplicable` прежние версии отклоняют: откат — через копию. Без
77
+ условных gates откат возможен без изменений состояния.
@@ -0,0 +1,63 @@
1
+ # devcontour-harness 0.1.0-alpha.46
2
+
3
+ Исправления, найденные хостом в работе: выдача не начинается на
4
+ неподтверждённой базе, у остановленных заданий технической очереди есть
5
+ время и событие исхода, пакет передачи различает задания одного графа по
6
+ ключу, а условный gate потребителя исполняется, когда сдвинулся его
7
+ провайдер. `stateVersion` и `policyVersion` прежние; формат состояния не
8
+ меняется.
9
+
10
+ ## Изменения
11
+
12
+ - **Ожидание проверки базы.** Пока в `control.waits` есть запись
13
+ `base-check`, `Engine.claim` не выдаёт работу при любом значении `paused`;
14
+ `blockers()` без паузы называет причину (`PAUSED`, «Очередь ждёт
15
+ подтверждения перенесённой базы»).
16
+ - **`clearFailure` под ожиданием базы.** Снятие последнего класса паузы
17
+ `runtime` при ожидании `base-check` не снимает паузу и не оставляет
18
+ `runtime` без классов: пауза становится `base-check`, `pausedAt` — время
19
+ перехода, событие `control.paused` с причиной `base-check`. `queuePause`
20
+ показывает ожидание controller (`not-ready`/`wait`), а не «исправить
21
+ окружение». `resume()` прежний: это явный маршрут человека «подтвердить
22
+ базу и начать», он снимает ожидания `base-check`.
23
+ - **Исход заданий технической очереди.** `WorkflowQueue.fail()` добавляет
24
+ событие истории нового статуса (`failed`, `stale` или `queued` у
25
+ прерванной стадии) и ставит `finishedAt` у `failed` и `stale`; `claim()`
26
+ ставит `finishedAt`, останавливая задание (вход изменился, попытки
27
+ исчерпаны); `retry()` снимает `finishedAt` и добавляет событие `queued`.
28
+ - **Ключ задания в `repairs`.** Строки `repairs[]` пакета передачи несут
29
+ необязательный `key` задания рядом с его `status`; сборщик ставит его
30
+ всегда.
31
+ - **Провайдеры условных gates.** Условный gate (`when.paths`) с зелёным SHA
32
+ исполняется, если SHA провайдера отличается от снимка принятой попытки
33
+ зелёного SHA или снимка нет у одной из попыток — что бы ни сдвинуло
34
+ провайдера (работа harness в другом графе или более ранней задаче,
35
+ коммиты мимо harness). Провайдеры — `dependsOn` репозитория и все
36
+ репозитории снимков зависимостей, в том числе транзитивные. Artifacts
37
+ провайдера, пересобираемые в каждой попытке, не сравниваются; смену
38
+ `dependencyBuild` провайдера при том же SHA правило не видит.
39
+ - **Новые экспорты.** `providerMovement`, тип `ProviderSnapshot`;
40
+ `gateDecisions` принимает необязательный `providersMoved`.
41
+
42
+ ## Совместимость
43
+
44
+ - `providersMoved` необязателен: без него провайдеры считаются не
45
+ сдвинувшимися — вызывающий ручается, что `changedFor` даёт зелёный SHA
46
+ только под теми же SHA провайдеров. Так вызывает DevContour (перенос
47
+ базы, `sameProviders`); прежние вызовы компилируются и ведут себя как
48
+ раньше. Runner передаёт его всегда.
49
+ - Условные gates потребителей исполняются чаще: всякий раз, когда SHA
50
+ провайдера отличается от снимка зелёной попытки.
51
+ - DevContour переводит паузу в `base-check` сам (`settleFailure` в цикле
52
+ ведущего) и в этот момент `clearFailure` не вызывает; `checkBase` доходит
53
+ до проверки через `settleFailure`. Оба перехода ставят `pausedAt` на
54
+ момент перехода. Убирая `settleFailure` в пользу `clearFailure`, хост
55
+ сверяет и событие журнала (`control.paused` против своего
56
+ `base.check.resumed-wait`).
57
+ - История заданий получает события исхода; читатели «последнего события»
58
+ видят исход, а не `running`. `finishedAt` у `failed` и `stale` — настоящее
59
+ время окончания. Хост, возвращающий задание в очередь сам, снимает
60
+ `finishedAt` сам.
61
+ - Пакет передачи с `repairs[].key` прежняя версия (строгая схема)
62
+ отклоняет; пакеты строятся по запросу. Формат состояния прежний — откат
63
+ на alpha.45 без изменений состояния.
package/docs/upgrade.md CHANGED
@@ -21,24 +21,25 @@
21
21
 
22
22
  ## Матрица форматов
23
23
 
24
- | Состояние, записанное… | Читает 0.1.0-alpha.1 | Читает 0.1.0-alpha.2 | Читает 0.1.0-alpha.6 | Читает 0.1.0-alpha.7 | Читает 0.1.0-alpha.8 | Читает 0.1.0-alpha.9 | Читает 0.1.0-alpha.10 | Читает 0.1.0-alpha.11 | Читает 0.1.0-alpha.12 | Читает 0.1.0-alpha.13 | Читает 0.1.0-alpha.14 | Читает 0.1.0-alpha.15 | Читает 0.1.0-alpha.16 | Читает 0.1.0-alpha.17 | Читает 0.1.0-alpha.18 | Читает 0.1.0-alpha.19 | Читает 0.1.0-alpha.20 | Читает 0.1.0-alpha.21 | Читает 0.1.0-alpha.22 | Читает 0.1.0-alpha.23 | Читает 0.1.0-alpha.24 | Читает 0.1.0-alpha.44 | Пишет поверх | Примечание |
25
- | ----------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------ | ------------------------ | ----------------------- | ----------------------- | ----------------------- | ----------------------- | ----------------------- | ----------------------- | ----------------------- | ----------------------- | ----------------------- | ----------------------- | ----------------------- | ----------------------- | ----------------------- | ----------------------- | ----------------------- | ----------------------- | ----------------------- | ----------------------- | ----------------------- | --------------------- | ------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
26
- | standalone `stateVersion: 1` версией alpha.1 | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | одна база SQLite: документ, события, локальные записи |
27
- | хост, центральная база | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да | данные не переносятся; новые поля необязательны |
28
- | хост, базы компонентов | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да | нужна копия всех баз при остановленных writers |
29
- | alpha.2 после штатной остановки controller | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | роль controller снята — нового поля в состоянии нет |
30
- | alpha.2 с живой или брошенной ролью controller | **нет**, отказ до записи | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | — | роль хранит `engineVersion`; строгая схема alpha.1 его не знает → откат через копию |
31
- | alpha.4 с совместной проверкой | **нет**, отказ до записи | **нет**, отказ до записи | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | — | проверка хранит `engineVersion`; прежние версии его не знают → откат через копию |
32
- | alpha.6 standalone с записями ревью нового протокола или доставкой `uncertain` | **нет**, отказ до записи | **нет**, отказ до записи | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | — | `reviewRound`, `findings[].id/status`, статус доставки `uncertain`; alpha.4/alpha.5 отказывают `STATE_VERSION_UNSUPPORTED` до записи → откат через копию |
33
- | alpha.6, хост DevContour (адаптер alpha.4) | — | — | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да | да | да | да | да | да | да | да | адаптер DevContour alpha.4 открывает такое состояние без отказа и пишет роль controller и события; новые поля сохраняются → для отката всё равно копия |
34
- | alpha.7 с новым `inspection` ревью кода | не проверялось | не проверялось | **нет** (строгая схема) | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | — | новые значения `source`, `exitCode: null`, `origins`/`context`/`excluded`; строгая схема alpha.6 их не принимает, поведение прежних версий при открытии не проверялось → откат через копию |
35
- | alpha.14 с договором проверки `reference` или `gates` обязательства | не проверялось | не проверялось | не проверялось | **нет** (строгая схема) | **нет** (строгая схема) | **нет** (строгая схема) | **нет** (строгая схема) | **нет** (строгая схема) | **нет** (строгая схема) | **нет** (строгая схема) | да | да | да | да | да | да | да | да | да | да | да | да | — | контракт хранится строгой схемой (`contract-documents`): прежние версии новых полей `gates`, `verification`, `reference` не знают → откат через копию |
36
- | alpha.17 с `interrupted`, `inputClasses`, `classified`, `neutralFailures`, `alreadySatisfied` в evidence ревью или классом отказа `unfinished`/`needs-lead` | не проверялось | не проверялось | не проверялось | **нет** (строгая схема) | **нет** (строгая схема) | **нет** (строгая схема) | **нет** (строгая схема) | **нет** (строгая схема) | **нет** (строгая схема) | **нет** (строгая схема) | **нет** (строгая схема) | **нет** (строгая схема) | **нет** (строгая схема) | да | да | да | да | да | да | да | да | да | — | попытка (`interrupted`, `inputClasses`, `classified`), поручение (`neutralFailures`), `alreadySatisfied` evidence ревью и классы отказа `unfinished`, `needs-lead` — новые значения строгих схем; прежние версии их отклоняют → откат через копию |
37
- | alpha.19 с `recheck` в evidence gate или областью gates длиннее 20 | не проверялось | не проверялось | не проверялось | **нет** (строгая схема) | **нет** (строгая схема) | **нет** (строгая схема) | **нет** (строгая схема) | **нет** (строгая схема) | **нет** (строгая схема) | **нет** (строгая схема) | **нет** (строгая схема) | **нет** (строгая схема) | **нет** (строгая схема) | **нет** (строгая схема) | **нет** (строгая схема) | да | да | да | да | да | да | да | — | evidence gate и событие `attempt.gate` (`recheck`), области gates поручения, задачи, потребителя и `alreadySatisfied` до 100 — новые значения строгих схем; прежние версии их отклоняют → откат через копию |
38
- | alpha.44 с `interrupted` совместной проверки или записями `joint-budget-resets` | не проверялось | не проверялось | не проверялось | **нет** (строгая схема) | **нет** (строгая схема) | **нет** (строгая схема) | **нет** (строгая схема) | **нет** (строгая схема) | **нет** (строгая схема) | **нет** (строгая схема) | **нет** (строгая схема) | **нет** (строгая схема) | **нет** (строгая схема) | **нет** (строгая схема) | **нет** (строгая схема) | **нет** (строгая схема) | **нет** (строгая схема) | **нет** (строгая схема) | **нет** (строгая схема) | **нет** (строгая схема) | **нет** (строгая схема) | да | — | необязательное поле совместной проверки и новое пространство локальных записей; прежние версии, включая alpha.25–alpha.43, их не знают и отклоняют → откат через копию |
39
- | неизвестная `stateVersion` | нет, отказ до записи | нет, отказ до записи | нет, отказ до записи | нет, отказ до записи | нет, отказ до записи | нет, отказ до записи | нет, отказ до записи | нет, отказ до записи | нет, отказ до записи | нет, отказ до записи | нет, отказ до записи | нет, отказ до записи | нет, отказ до записи | нет, отказ до записи | нет, отказ до записи | нет, отказ до записи | нет, отказ до записи | нет, отказ до записи | нет, отказ до записи | нет, отказ до записи | нет, отказ до записи | нет, отказ до записи | нет | `STATE_VERSION_UNSUPPORTED`, exit 4 |
40
-
41
- Столбец alpha.2 относится и к alpha.3; alpha.4 и alpha.5 читают все строки, кроме неизвестной `stateVersion` и строк alpha.6 с новыми полями (standalone — отказ до записи) и строки alpha.7. alpha.8, alpha.9, alpha.10, alpha.11, alpha.12 и alpha.13 формат состояния не меняют и читают всё, что читает alpha.7; alpha.14 и alpha.15 (локальные, не опубликованы) и alpha.16 читают всё, что читает alpha.13, и добавляют необязательные поля договора проверки (строка alpha.14). alpha.17 читает всё, что читает alpha.16, и добавляет необязательные поля попытки, поручения и evidence ревью и классы отказа `unfinished` и `needs-lead` (строка alpha.17); alpha.18 формат состояния не меняет и читает всё, что читает alpha.17. alpha.19 читает всё, что читает alpha.18, и добавляет необязательное поле `recheck` evidence gate и области gates до 100 (строка alpha.19); alpha.20, alpha.21, alpha.22, alpha.23 и alpha.24 формат состояния не меняют и читают всё, что читает alpha.19. alpha.44 читает всё, что читают прежние версии, и добавляет необязательное поле `interrupted` совместной проверки и пространство локальных записей `joint-budget-resets` (строка alpha.44). Каждая следующая версия добавляет сюда свой столбец. Отказ неизвестного
24
+ | Состояние, записанное… | Читает 0.1.0-alpha.1 | Читает 0.1.0-alpha.2 | Читает 0.1.0-alpha.6 | Читает 0.1.0-alpha.7 | Читает 0.1.0-alpha.8 | Читает 0.1.0-alpha.9 | Читает 0.1.0-alpha.10 | Читает 0.1.0-alpha.11 | Читает 0.1.0-alpha.12 | Читает 0.1.0-alpha.13 | Читает 0.1.0-alpha.14 | Читает 0.1.0-alpha.15 | Читает 0.1.0-alpha.16 | Читает 0.1.0-alpha.17 | Читает 0.1.0-alpha.18 | Читает 0.1.0-alpha.19 | Читает 0.1.0-alpha.20 | Читает 0.1.0-alpha.21 | Читает 0.1.0-alpha.22 | Читает 0.1.0-alpha.23 | Читает 0.1.0-alpha.24 | Читает 0.1.0-alpha.44 | Читает 0.1.0-alpha.45 | Читает 0.1.0-alpha.46 | Пишет поверх | Примечание |
25
+ | ----------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------ | ------------------------ | ----------------------- | ----------------------- | ----------------------- | ----------------------- | ----------------------- | ----------------------- | ----------------------- | ----------------------- | ----------------------- | ----------------------- | ----------------------- | ----------------------- | ----------------------- | ----------------------- | ----------------------- | ----------------------- | ----------------------- | ----------------------- | ----------------------- | ----------------------- | --------------------- | --------------------- | ------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
26
+ | standalone `stateVersion: 1` версией alpha.1 | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | одна база SQLite: документ, события, локальные записи |
27
+ | хост, центральная база | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да | данные не переносятся; новые поля необязательны |
28
+ | хост, базы компонентов | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да | нужна копия всех баз при остановленных writers |
29
+ | alpha.2 после штатной остановки controller | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | роль controller снята — нового поля в состоянии нет |
30
+ | alpha.2 с живой или брошенной ролью controller | **нет**, отказ до записи | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | — | роль хранит `engineVersion`; строгая схема alpha.1 его не знает → откат через копию |
31
+ | alpha.4 с совместной проверкой | **нет**, отказ до записи | **нет**, отказ до записи | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | — | проверка хранит `engineVersion`; прежние версии его не знают → откат через копию |
32
+ | alpha.6 standalone с записями ревью нового протокола или доставкой `uncertain` | **нет**, отказ до записи | **нет**, отказ до записи | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | — | `reviewRound`, `findings[].id/status`, статус доставки `uncertain`; alpha.4/alpha.5 отказывают `STATE_VERSION_UNSUPPORTED` до записи → откат через копию |
33
+ | alpha.6, хост DevContour (адаптер alpha.4) | — | — | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да | да | да | да | да | да | да | да | да | да | адаптер DevContour alpha.4 открывает такое состояние без отказа и пишет роль controller и события; новые поля сохраняются → для отката всё равно копия |
34
+ | alpha.7 с новым `inspection` ревью кода | не проверялось | не проверялось | **нет** (строгая схема) | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | — | новые значения `source`, `exitCode: null`, `origins`/`context`/`excluded`; строгая схема alpha.6 их не принимает, поведение прежних версий при открытии не проверялось → откат через копию |
35
+ | alpha.14 с договором проверки `reference` или `gates` обязательства | не проверялось | не проверялось | не проверялось | **нет** (строгая схема) | **нет** (строгая схема) | **нет** (строгая схема) | **нет** (строгая схема) | **нет** (строгая схема) | **нет** (строгая схема) | **нет** (строгая схема) | да | да | да | да | да | да | да | да | да | да | да | да | да | да | — | контракт хранится строгой схемой (`contract-documents`): прежние версии новых полей `gates`, `verification`, `reference` не знают → откат через копию |
36
+ | alpha.17 с `interrupted`, `inputClasses`, `classified`, `neutralFailures`, `alreadySatisfied` в evidence ревью или классом отказа `unfinished`/`needs-lead` | не проверялось | не проверялось | не проверялось | **нет** (строгая схема) | **нет** (строгая схема) | **нет** (строгая схема) | **нет** (строгая схема) | **нет** (строгая схема) | **нет** (строгая схема) | **нет** (строгая схема) | **нет** (строгая схема) | **нет** (строгая схема) | **нет** (строгая схема) | да | да | да | да | да | да | да | да | да | да | да | — | попытка (`interrupted`, `inputClasses`, `classified`), поручение (`neutralFailures`), `alreadySatisfied` evidence ревью и классы отказа `unfinished`, `needs-lead` — новые значения строгих схем; прежние версии их отклоняют → откат через копию |
37
+ | alpha.19 с `recheck` в evidence gate или областью gates длиннее 20 | не проверялось | не проверялось | не проверялось | **нет** (строгая схема) | **нет** (строгая схема) | **нет** (строгая схема) | **нет** (строгая схема) | **нет** (строгая схема) | **нет** (строгая схема) | **нет** (строгая схема) | **нет** (строгая схема) | **нет** (строгая схема) | **нет** (строгая схема) | **нет** (строгая схема) | **нет** (строгая схема) | да | да | да | да | да | да | да | да | да | — | evidence gate и событие `attempt.gate` (`recheck`), области gates поручения, задачи, потребителя и `alreadySatisfied` до 100 — новые значения строгих схем; прежние версии их отклоняют → откат через копию |
38
+ | alpha.44 с `interrupted` совместной проверки или записями `joint-budget-resets` | не проверялось | не проверялось | не проверялось | **нет** (строгая схема) | **нет** (строгая схема) | **нет** (строгая схема) | **нет** (строгая схема) | **нет** (строгая схема) | **нет** (строгая схема) | **нет** (строгая схема) | **нет** (строгая схема) | **нет** (строгая схема) | **нет** (строгая схема) | **нет** (строгая схема) | **нет** (строгая схема) | **нет** (строгая схема) | **нет** (строгая схема) | **нет** (строгая схема) | **нет** (строгая схема) | **нет** (строгая схема) | **нет** (строгая схема) | да | да | да | — | необязательное поле совместной проверки и новое пространство локальных записей; прежние версии, включая alpha.25–alpha.43, их не знают и отклоняют → откат через копию |
39
+ | alpha.45 с evidence `not-applicable` или полями `gateBasis` и `notApplicable` | не проверялось | не проверялось | не проверялось | **нет** (строгая схема) | **нет** (строгая схема) | **нет** (строгая схема) | **нет** (строгая схема) | **нет** (строгая схема) | **нет** (строгая схема) | **нет** (строгая схема) | **нет** (строгая схема) | **нет** (строгая схема) | **нет** (строгая схема) | **нет** (строгая схема) | **нет** (строгая схема) | **нет** (строгая схема) | **нет** (строгая схема) | **нет** (строгая схема) | **нет** (строгая схема) | **нет** (строгая схема) | **нет** (строгая схема) | **нет** (строгая схема) | да | да | — | новый вид evidence и необязательные поля записи gate; прежние версии, включая alpha.44, их не знают и отклоняют → откат через копию |
40
+ | неизвестная `stateVersion` | нет, отказ до записи | нет, отказ до записи | нет, отказ до записи | нет, отказ до записи | нет, отказ до записи | нет, отказ до записи | нет, отказ до записи | нет, отказ до записи | нет, отказ до записи | нет, отказ до записи | нет, отказ до записи | нет, отказ до записи | нет, отказ до записи | нет, отказ до записи | нет, отказ до записи | нет, отказ до записи | нет, отказ до записи | нет, отказ до записи | нет, отказ до записи | нет, отказ до записи | нет, отказ до записи | нет, отказ до записи | нет, отказ до записи | нет, отказ до записи | нет | `STATE_VERSION_UNSUPPORTED`, exit 4 |
41
+
42
+ Столбец alpha.2 относится и к alpha.3; alpha.4 и alpha.5 читают все строки, кроме неизвестной `stateVersion` и строк alpha.6 с новыми полями (standalone — отказ до записи) и строки alpha.7. alpha.8, alpha.9, alpha.10, alpha.11, alpha.12 и alpha.13 формат состояния не меняют и читают всё, что читает alpha.7; alpha.14 и alpha.15 (локальные, не опубликованы) и alpha.16 читают всё, что читает alpha.13, и добавляют необязательные поля договора проверки (строка alpha.14). alpha.17 читает всё, что читает alpha.16, и добавляет необязательные поля попытки, поручения и evidence ревью и классы отказа `unfinished` и `needs-lead` (строка alpha.17); alpha.18 формат состояния не меняет и читает всё, что читает alpha.17. alpha.19 читает всё, что читает alpha.18, и добавляет необязательное поле `recheck` evidence gate и области gates до 100 (строка alpha.19); alpha.20, alpha.21, alpha.22, alpha.23 и alpha.24 формат состояния не меняют и читают всё, что читает alpha.19. alpha.44 читает всё, что читают прежние версии, и добавляет необязательное поле `interrupted` совместной проверки и пространство локальных записей `joint-budget-resets` (строка alpha.44). alpha.45 читает всё, что читает alpha.44, и добавляет вид evidence `not-applicable` и необязательные поля `gateBasis` и `notApplicable` записи gate (строка alpha.45). alpha.46 формат состояния не меняет и читает всё, что читает alpha.45. Каждая следующая версия добавляет сюда свой столбец. Отказ неизвестного
42
43
  формата до записи проверяют тесты совместимости пакета
43
44
  <!-- repo-only -->(`tests/compatibility.test.ts`)<!-- /repo-only -->.
44
45
 
@@ -817,6 +818,85 @@ alpha.44 матрицы форматов — новое поле и новое
817
818
  версии отклоняют (строгая схема): откат — через копию. Состояние без них
818
819
  откатывается без изменений.
819
820
 
821
+ ### 0.1.0-alpha.45: условные gates (`when.paths`)
822
+
823
+ Номера форматов прежние (`stateVersion: 1`, `policyVersion: 1`); строка
824
+ alpha.45 матрицы форматов — новый вид evidence и новые поля. Политика без
825
+ `when` даёт прежние digest и поведение.
826
+
827
+ - Gate задачи принимает `when: { paths: [...] }`. Runner решает в каждой
828
+ фазе по diff Git от последнего зелёного SHA gate и пишет за неприменимый
829
+ gate evidence вида `not-applicable` (`passed: false`, поле
830
+ `notApplicable`); исполненный условный gate пишет `gateBasis`. Событие
831
+ `attempt.gate` получает необязательное `notApplicable: true`, ссылка
832
+ evidence receipt — вид `not-applicable` и поле `notApplicable`, проекция
833
+ попытки — `gates.notApplicable`. Правила — `docs/contracts.md`
834
+ («ExecutionPolicy»).
835
+ - Весь git хоста идёт с `--no-replace-objects` (`gitHardening`): замены
836
+ объектов не влияют на diff, требования, область записи и применимость.
837
+ - **Хост до обновления.** Прежний хост читает `attempt.gate` с
838
+ `passed: false` и `notApplicable: true` как провал gate, а прежний
839
+ получатель receipt отклоняет вид ссылки `not-applicable` (строгая схема).
840
+ Оба исхода — в безопасную сторону, но хост (DevContour) обязан понять новый
841
+ вид evidence до того, как в политике появится `when`.
842
+ - Хост со своим хранилищем сохраняет новый вид evidence и поля `gateBasis`
843
+ и `notApplicable`; в представлениях показывает неприменимый gate отдельно
844
+ от PASS и провала и не считает его ни тем, ни другим. Доказательства
845
+ testcase и сценариев читают только записи `test`.
846
+ - Хост, который проверяет полный профиль набора на итоговом SHA
847
+ (`uncoveredGates` → `runGatesAt`), передаёт `changes`, построенный
848
+ `coverageChanges(repoPath, evidence, finalSha)`, итоговые SHA `finalShas`
849
+ и gates политики harness.
850
+ Diff, не начинающийся от зелёного SHA каждой записи неприменимости, неполный
851
+ или с разными концами, считается отсутствующим: такой gate исполняется на
852
+ итоговом SHA.
853
+ - Добавление или смена `when`, ресурсов, предпосылок, окружения, подготовки
854
+ или версии harness меняет основание gate: первый прогон после этого исполняет его.
855
+ Добавление `when` меняет digest политики — согласования, привязанные к
856
+ нему, нужно повторить.
857
+ - Состояние с evidence `not-applicable` или полями `gateBasis` и
858
+ `notApplicable` прежние версии отклоняют (строгая схема): откат — через
859
+ копию. Без условных gates таких записей нет, и откат возможен без
860
+ изменений состояния.
861
+
862
+ ### 0.1.0-alpha.46: ожидание проверки базы, исходы заданий, провайдеры условных gates
863
+
864
+ Номера форматов и формат состояния прежние (`stateVersion: 1`,
865
+ `policyVersion: 1`); новых строк матрицы нет. Изменения — поведение и
866
+ необязательные поля.
867
+
868
+ - **Ожидание `base-check` держит выдачу.** Пока в `control.waits` есть запись
869
+ `base-check`, `Engine.claim` не выдаёт работу при любом `paused`;
870
+ `blockers()` без паузы называет причину кодом `PAUSED`. `clearFailure`,
871
+ снявший последний класс паузы `runtime` под таким ожиданием, переводит
872
+ паузу в `base-check` (`pausedAt` — время перехода, событие
873
+ `control.paused` с этой причиной); `queuePause` — ожидание controller.
874
+ `resume()` прежний и остаётся единственным маршрутом движка, снимающим
875
+ ожидание («подтвердить базу и начать»). Хост DevContour в своём цикле
876
+ ведущего переводит паузу сам (`settleFailure`) и `clearFailure` в этот
877
+ момент не вызывает; оба перехода ставят время паузы на момент перехода.
878
+ - **Исходы заданий технической очереди.** `WorkflowQueue.fail()` добавляет в
879
+ историю событие нового статуса (`failed`, `stale`, `queued` у прерванной
880
+ стадии) и ставит `finishedAt` у `failed` и `stale`; `claim()` ставит
881
+ `finishedAt`, когда останавливает задание; `retry()` снимает его и
882
+ добавляет событие `queued`. Задания без `finishedAt` читаются как прежде.
883
+ Хост, возвращающий задание в очередь сам, снимает `finishedAt` сам.
884
+ - **`repairs[].key` пакета передачи.** Строка восстановлений несёт
885
+ необязательный ключ задания рядом со статусом; пакеты без него допустимы.
886
+ Прежняя версия (строгая схема) пакет с ключом отклоняет — пакеты
887
+ строятся по запросу.
888
+ - **Провайдеры условных gates.** Условный gate с зелёным SHA исполняется,
889
+ если SHA провайдера (`dependsOn` репозитория и все репозитории снимков
890
+ зависимостей, в том числе транзитивные) отличается от снимка принятой
891
+ попытки зелёного SHA или снимка нет у одной из попыток, — что бы ни
892
+ сдвинуло провайдера. Artifacts не сравниваются; смену `dependencyBuild`
893
+ провайдера при том же SHA правило не видит. `gateDecisions` получает
894
+ необязательный вход `providersMoved`: без него провайдеры считаются не
895
+ сдвинувшимися (вызывающий ручается за них; runner передаёт его всегда).
896
+ Новые экспорты — `providerMovement`, тип `ProviderSnapshot`.
897
+ - Откат на alpha.45 возможен без изменений состояния; пакет передачи с
898
+ `repairs[].key` alpha.45 не читает.
899
+
820
900
  ## Перед обновлением
821
901
 
822
902
  1. **Остановить записывающих.** Запретить новые выдачи (`harness pause`),