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

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 (49) hide show
  1. package/README.md +11 -2
  2. package/docs/contracts.md +107 -1
  3. package/docs/release-notes/0.1.0-alpha.45.md +77 -0
  4. package/docs/upgrade.md +60 -18
  5. package/lib/contracts/cli.d.ts +67 -0
  6. package/lib/contracts/cli.js +6 -1
  7. package/lib/contracts/events.d.ts +5 -0
  8. package/lib/contracts/events.js +2 -0
  9. package/lib/contracts/execution.d.ts +39 -0
  10. package/lib/contracts/execution.js +15 -2
  11. package/lib/contracts/policy.d.ts +39 -0
  12. package/lib/contracts/policy.js +64 -0
  13. package/lib/contracts/profiles.d.ts +6 -0
  14. package/lib/contracts/published.d.ts +69 -0
  15. package/lib/contracts/result.d.ts +91 -0
  16. package/lib/contracts/result.js +31 -1
  17. package/lib/contracts/review.d.ts +1 -1
  18. package/lib/control/harness.d.ts +24 -2
  19. package/lib/engine/engine.d.ts +18 -3
  20. package/lib/engine/engine.js +74 -8
  21. package/lib/engine/result.js +7 -3
  22. package/lib/engine/runner.d.ts +8 -0
  23. package/lib/engine/runner.js +91 -3
  24. package/lib/environment/git-trust.js +3 -0
  25. package/lib/environment/process.d.ts +2 -0
  26. package/lib/environment/process.js +7 -1
  27. package/lib/explain/state.js +1 -1
  28. package/lib/index.d.ts +1 -0
  29. package/lib/index.js +1 -0
  30. package/lib/integrations/connector/history.js +1 -1
  31. package/lib/integrations/connector/summary.js +2 -1
  32. package/lib/profiles/resolve.d.ts +6 -0
  33. package/lib/projections/attempt.d.ts +4 -2
  34. package/lib/projections/attempt.js +14 -1
  35. package/lib/report/compute.js +4 -3
  36. package/lib/storage/document.d.ts +26 -2
  37. package/lib/verification/acceptance.d.ts +12 -0
  38. package/lib/verification/acceptance.js +62 -7
  39. package/lib/verification/applicability.d.ts +134 -0
  40. package/lib/verification/applicability.js +373 -0
  41. package/lib/verification/gates.d.ts +6 -0
  42. package/lib/verification/proof.d.ts +18 -4
  43. package/lib/verification/proof.js +52 -9
  44. package/package.json +1 -1
  45. package/schemas/execution-document.schema.json +73 -1
  46. package/schemas/execution-policy.schema.json +38 -0
  47. package/schemas/result-envelope.schema.json +138 -2
  48. package/schemas/run-event.schema.json +4 -0
  49. 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.45` — предварительный выпуск (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.45 # точная версия
32
32
  # или: npm install --save-exact devcontour-harness@alpha # текущая alpha
33
33
  npx harness --version
34
34
  ```
@@ -149,6 +149,15 @@ PASS» нет. Адаптеры хоста реализуют порты `Execut
149
149
  `devcontour-harness/schemas/<имя>.schema.json`. Декларации используют типы
150
150
  Node.js: TypeScript-потребителю нужен `@types/node` (или `skipLibCheck`).
151
151
 
152
+ ## Выпуск 0.1.0-alpha.45
153
+
154
+ Gate задачи может объявить `when: { paths: [...] }`: runner исполняет его,
155
+ только если настоящий diff Git от последнего зелёного SHA gate задевает эти
156
+ пути или неявные входы, а иначе пишет evidence `not-applicable` — не PASS и
157
+ не провал. Хост проверяет пропущенные gates набора на итоговом SHA через
158
+ `coverageChanges` и `uncoveredGates`; git хоста не читает объекты замены.
159
+ Подробно — [заметки выпуска](docs/release-notes/0.1.0-alpha.45.md).
160
+
152
161
  ## Выпуск 0.1.0-alpha.44
153
162
 
154
163
  Совместная проверка, прерванная до результата gates (остановка хоста,
package/docs/contracts.md CHANGED
@@ -173,6 +173,100 @@ 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`); он — предпосылка
222
+ (`gatePrerequisites`) исполняемого gate области. Общие настройки инструментов
223
+ неявными входами **не** считаются — их перечисляют в `when.paths` сами:
224
+ корневые `tsconfig*.json`, `eslint.config.*`, `vitest/jest/playwright.config.*`,
225
+ `Makefile`, `Dockerfile`, `.env*`, скрипты, вызванные косвенно (например из
226
+ `package.json`). Иначе gate не исполняется, а runner пишет запись evidence
227
+ вида `not-applicable` (`passed: false`, `exitCode: -1`, без команды и лога) с
228
+ полем `notApplicable`: `gateDigest`, `patterns`, `ranges[]` `{from, to}`
229
+ (`ranges[0].from` — зелёный SHA, последний `to` — SHA фазы), `count`, первые
230
+ 50 путей не длиннее 1000 символов `files`, `pathsDigest` — SHA-256
231
+ отсортированного полного списка, разделённого NUL. Событие `attempt.gate`
232
+ такой записи несёт `notApplicable: true`. Исполненный условный gate пишет в
233
+ свою запись `test` поле `gateBasis`.
234
+
235
+ Неприменимость — не PASS. `Engine.evidence` принимает её только на SHA фазы
236
+ попытки (diff кончается на нём) и только пока на этом SHA нет записи `test`
237
+ того же gate. Приёмка (`finish`) и получатель receipt (`resultProblems`)
238
+ решают по записи `test`, если она есть, и засчитывают неприменимость
239
+ обязательному gate только без неё и только когда: у gate в их политике есть
240
+ `when` с тем же `gateDigest`; gate не из `proofGates` поручения; ни один
241
+ исполненный gate той же фазы не опирается на него как на предпосылку.
242
+ Доказательство требования (`requirementProof`, testcase) и договора проверки
243
+ (`propertyProofProblem`) читает только записи `test`. Receipt перечисляет
244
+ неприменимые gates ссылками evidence вида `not-applicable` с `notApplicable`.
245
+ Функции: `changedPaths`, `coverageChanges`, `gateBasis`, `gateDecisions`,
246
+ `pathApplicability`, `matchingPaths`, `gatePathRegExp`, `proofGates`,
247
+ `notApplicableProblem`, `gateDigest`. Основание включает версию harness:
248
+ после обновления пакета каждый условный gate исполняется один раз. Не входят
249
+ в основание образ контейнера по изменяемому тегу и переменные окружения
250
+ хоста, передаваемые по имени (`environment.inherit`): их смену gate не видит.
251
+ `matchingPaths` и `gatePathRegExp` намеренно расширяют совпадение (регистр,
252
+ NFC, каталоги-предки) и годятся только там, где совпадение исполняет
253
+ проверку, а не разрешает запись.
254
+
255
+ Покрытие набора поручений (`uncoveredGates(repositories, works, changes?)`,
256
+ `Engine.uncoveredGates(workIds, changes?, finalShas?)`): gate с `when`, признанный
257
+ неприменимым на integration хотя бы одним поручением, решается по
258
+ объединённому diff набора `changes[repositoryId]`. Его строит
259
+ `coverageChanges(repoPath, evidence, finalSha)`: от зелёного SHA каждой такой
260
+ записи (`notApplicable.ranges[0].from`) до итогового SHA. Diff засчитывается,
261
+ только если он полон, у всех пар один конец — итоговый SHA репозитория из
262
+ `finalShas` — и среди начал есть зелёный SHA
263
+ каждой записи неприменимости gate; иначе он считается отсутствующим. Задетый
264
+ diff — или без `changes`, или под другим определением gate — gate непокрыт,
265
+ даже если другое поручение его прошло, и хост исполняет его один раз на
266
+ итоговом SHA (`runGatesAt`); не задетый — не пробел. Для политики без `when`
267
+ правило прежнее. Совместная проверка (`workspaceGates`, `JointRunner`) не
268
+ меняется.
269
+
176
270
  `policyDigest(policy)` — digest загруженной политики целиком: им сверяются
177
271
  применённая политика (`control.appliedPolicy`) и запрос операции
178
272
  `control.reconfigure`. `executionDigest(policy)` — digest исполнительной
@@ -356,7 +450,7 @@ writer и reviewer кода получают список файлов набо
356
450
  | `GraphState` | Граф, его digest, digest политики, техническое согласование (с `approval.context` — снимок контекста, который видел reviewer плана; только он исполняется и принимается) |
357
451
  | `WorkState` | Закреплённое поручение, статус, попытки, результат, класс отказа, согласованные digests, удержание, блок бюджета, версия корпуса, эпизод восстановления по свойству |
358
452
  | `AttemptState` | Владение (`token`, `owner`, `leaseUntil`), runtime и reviewer, фаза, SHA, evidence, раскрытые gates, потребители и что у них проверено, версия проверок, контекст, зависимости и свежесть, основание и источник reuse, черновик, выбор из очереди, замеры, `engineVersion`, `consumerVersion` |
359
- | `EvidenceRecord` | Фаза, SHA, gate, исход, команда, лог, digest, testcases, отчёт свойств, осмотр ревью, версия проверок |
453
+ | `EvidenceRecord` | Фаза, SHA, gate, исход (`test`, `review`, `not-applicable`), команда, лог, digest, testcases, отчёт свойств, осмотр ревью, версия проверок |
360
454
  | `ControlState` | Пауза и её причина, классы отказов, ожидания, применённая политика, reconfigure |
361
455
  | `ControllerLease` | Единственный действующий controller; `engineVersion` (с 0.1.0-alpha.2) — версия движка процесса: роль другой версии или без версии не перенимается, пока она жива |
362
456
  | `CallRecord` | Вызов модели: стадия, runtime, сообщённая модель, версия, исход, процесс, монотонное время, закреплённая атрибуция (`workId`, `groupId`, `workIds`), вид предмета (`subjectKind`: поручение, группа, прочее), счётчики, стоимость и её источник |
@@ -556,6 +650,18 @@ Schema строит подделку каждого поля (другое зн
556
650
  | `evidence[].summary` | сведение | описание записи |
557
651
  | `evidence[].consumer` | ожидание получателя | объявленный потребитель |
558
652
  | `evidence[].checks` | ожидание получателя | версия проверок, вычисленная получателем, у каждой записи |
653
+ | `evidence[].notApplicable` | согласованность | только у записи not-applicable: обычный gate с when, не доказательство и не предпосылка исполненного |
654
+ | `evidence[].notApplicable.gateDigest` | ожидание получателя | digest определения gate у получателя |
655
+ | `evidence[].notApplicable.patterns` | сведение | пути when; их задаёт определение gate |
656
+ | `evidence[].notApplicable.patterns[]` | сведение | пути when; их задаёт определение gate |
657
+ | `evidence[].notApplicable.ranges` | сведение | diff фазы — наблюдение Git исполнителя |
658
+ | `evidence[].notApplicable.ranges[]` | сведение | diff фазы — наблюдение Git исполнителя |
659
+ | `evidence[].notApplicable.ranges[].from` | сведение | diff фазы — наблюдение Git исполнителя |
660
+ | `evidence[].notApplicable.ranges[].to` | сведение | diff фазы — наблюдение Git исполнителя |
661
+ | `evidence[].notApplicable.count` | сведение | diff фазы — наблюдение Git исполнителя |
662
+ | `evidence[].notApplicable.files` | сведение | diff фазы — наблюдение Git исполнителя |
663
+ | `evidence[].notApplicable.files[]` | сведение | diff фазы — наблюдение Git исполнителя |
664
+ | `evidence[].notApplicable.pathsDigest` | сведение | diff фазы — наблюдение Git исполнителя |
559
665
  | `evidence[].tests` | ожидание получателя | доказательство названного testcase решающей записью |
560
666
  | `evidence[].tests[]` | ожидание получателя | элемент названного testcase; прочие элементы — сведения |
561
667
  | `evidence[].tests[].id` | ожидание получателя | ID названного testcase |
@@ -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 откат возможен без изменений состояния.
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 | Пишет поверх | Примечание |
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). Каждая следующая версия добавляет сюда свой столбец. Отказ неизвестного
42
43
  формата до записи проверяют тесты совместимости пакета
43
44
  <!-- repo-only -->(`tests/compatibility.test.ts`)<!-- /repo-only -->.
44
45
 
@@ -817,6 +818,47 @@ 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
+
820
862
  ## Перед обновлением
821
863
 
822
864
  1. **Остановить записывающих.** Запретить новые выдачи (`harness pause`),