devcontour-harness 0.1.0-alpha.42 → 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 (65) hide show
  1. package/README.md +25 -2
  2. package/docs/architecture.md +38 -3
  3. package/docs/contracts.md +117 -3
  4. package/docs/release-notes/0.1.0-alpha.43.md +40 -0
  5. package/docs/release-notes/0.1.0-alpha.44.md +44 -0
  6. package/docs/release-notes/0.1.0-alpha.45.md +77 -0
  7. package/docs/upgrade.md +107 -17
  8. package/lib/contracts/cli.d.ts +115 -4
  9. package/lib/contracts/cli.js +6 -1
  10. package/lib/contracts/events.d.ts +65 -5
  11. package/lib/contracts/events.js +18 -1
  12. package/lib/contracts/execution.d.ts +76 -0
  13. package/lib/contracts/execution.js +35 -2
  14. package/lib/contracts/policy.d.ts +39 -0
  15. package/lib/contracts/policy.js +64 -0
  16. package/lib/contracts/profiles.d.ts +6 -0
  17. package/lib/contracts/published.d.ts +97 -2
  18. package/lib/contracts/report.d.ts +8 -0
  19. package/lib/contracts/report.js +7 -1
  20. package/lib/contracts/result.d.ts +93 -0
  21. package/lib/contracts/result.js +37 -1
  22. package/lib/contracts/review.d.ts +1 -1
  23. package/lib/control/harness.d.ts +29 -2
  24. package/lib/engine/engine.d.ts +54 -6
  25. package/lib/engine/engine.js +191 -24
  26. package/lib/engine/joint-runner.d.ts +2 -0
  27. package/lib/engine/joint-runner.js +13 -3
  28. package/lib/engine/result.js +7 -3
  29. package/lib/engine/runner.d.ts +8 -0
  30. package/lib/engine/runner.js +91 -3
  31. package/lib/environment/git-trust.js +3 -0
  32. package/lib/environment/isolation.d.ts +1 -1
  33. package/lib/environment/isolation.js +38 -4
  34. package/lib/environment/process.d.ts +2 -0
  35. package/lib/environment/process.js +7 -1
  36. package/lib/explain/state.js +1 -1
  37. package/lib/index.d.ts +1 -0
  38. package/lib/index.js +1 -0
  39. package/lib/integrations/connector/history.js +1 -1
  40. package/lib/integrations/connector/summary.js +2 -1
  41. package/lib/profiles/resolve.d.ts +6 -0
  42. package/lib/projections/attempt.d.ts +4 -2
  43. package/lib/projections/attempt.js +14 -1
  44. package/lib/report/compute.js +7 -3
  45. package/lib/report/document.js +1 -1
  46. package/lib/storage/document.d.ts +28 -2
  47. package/lib/testing/store-contract.d.ts +8 -2
  48. package/lib/testing/store-contract.js +56 -1
  49. package/lib/verification/acceptance.d.ts +12 -0
  50. package/lib/verification/acceptance.js +62 -7
  51. package/lib/verification/applicability.d.ts +134 -0
  52. package/lib/verification/applicability.js +373 -0
  53. package/lib/verification/gates.d.ts +6 -0
  54. package/lib/verification/joint.d.ts +179 -1
  55. package/lib/verification/joint.js +23 -3
  56. package/lib/verification/proof.d.ts +18 -4
  57. package/lib/verification/proof.js +52 -9
  58. package/package.json +1 -1
  59. package/schemas/execution-document.schema.json +77 -1
  60. package/schemas/execution-policy.schema.json +38 -0
  61. package/schemas/joint-verification.schema.json +4 -0
  62. package/schemas/result-envelope.schema.json +138 -2
  63. package/schemas/run-event.schema.json +100 -0
  64. package/schemas/run-result.schema.json +138 -2
  65. package/schemas/value-report.schema.json +20 -0
package/README.md CHANGED
@@ -5,7 +5,7 @@ Headless-движок исполнения инженерных поручени
5
5
  интеграция с принятой веткой через compare-and-swap и машинный результат с SHA
6
6
  и доказательствами.
7
7
 
8
- > Статус: `0.1.0-alpha.42` — предварительный выпуск (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.42 # точная версия
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,29 @@ 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
+
161
+ ## Выпуск 0.1.0-alpha.44
162
+
163
+ Совместная проверка, прерванная до результата gates (остановка хоста,
164
+ потеря владения, истёкший срок), больше не тратит предел проверок набора;
165
+ явный сброс бюджета с причиной снимает только проверки без результата gates.
166
+ Подробно — [заметки выпуска](docs/release-notes/0.1.0-alpha.44.md).
167
+
168
+ ## Выпуск 0.1.0-alpha.43
169
+
170
+ Исчезновение вложенного `.git` подготовки засчитывается только за
171
+ настоящими родительскими каталогами; подпись защищённого файла включает
172
+ ctime, так что правка с восстановленным mtime не проходит незамеченной.
173
+ Подробно — [заметки выпуска](docs/release-notes/0.1.0-alpha.43.md).
174
+
152
175
  ## Выпуск 0.1.0-alpha.42
153
176
 
154
177
  Подготовка фазы (lifecycle, хранилище зависимостей, `prepare`), изменившая
@@ -180,6 +180,37 @@ runtime-граф пакета.
180
180
  активные проверки в него не входят. Hook выполняется внутри транзакции
181
181
  начала: ошибка откатывает всю запись. Снимки бюджета не заменяют gates,
182
182
  доказательства на SHA или основание оптимизации `affected`.
183
+ - **Прерванная совместная проверка.** Владелец, закрывающий проверку отказом,
184
+ может назвать её прерванной: `jointFail(id, token, error, { interrupted })`.
185
+ `JointRunner` называет так остановку хоста (внешний сигнал, не обход
186
+ зависших) и потерю владения (`LEASE_STALE` при продлении или записи);
187
+ истёкшую проверку, которую закрывает следующий `jointStart` или сброс
188
+ бюджета, — движок сам. Движок сохраняет отметку (`interrupted: true` в
189
+ проверке и в `joint.finished`) только у проверки без evidence; с evidence
190
+ это обычный отказ. Флаг хоста движок не перепроверяет: отказ до gates,
191
+ названный хостом прерыванием, считается прерыванием. Прерванные проверки
192
+ не тратят `maxAttempts` набора; у них свой предел `MAX_NEUTRAL_FAILURES`,
193
+ как у незасчитанных отказов окружения поручений. Отказ gate, отказ до gates
194
+ без отметки (результат поручения вне target ref, отказ подготовки) и
195
+ прерывание после evidence тратят предел, как раньше.
196
+ - **Явный сброс бюджета.** `engine.jointBudgetReset(workIds, { reason, actor })`
197
+ — выход оператора или хоста из исчерпанного предела набора без принятия:
198
+ только при исчерпании (`maxAttempts` или предел прерываний), без живой
199
+ проверки этого набора и с причиной; истёкшая незакрытая проверка набора
200
+ закрывается в той же транзакции. Сброс снимает только завершённые
201
+ проверки набора без результата gates — прерванные и отказы до gates, в том
202
+ числе записанные прежними версиями без отметки. Проверки с evidence тратят
203
+ предел и после сброса, как и успешные проверки без принятия (в том числе
204
+ без evidence). Сброс, после которого оставшиеся проверки набора всё равно
205
+ исчерпывают предел (или снимать нечего), отклоняется `ATTEMPTS_EXHAUSTED` и
206
+ не записывается — дальше только принятие хостом или новый набор.
207
+ Запись `joint-budget-resets` у `@workspace` хранит причину, актёра и
208
+ снимок IDs снятых проверок; событие `joint.budget-reset` несёт набор,
209
+ актёра, их число и длину причины; отчёт об эффекте считает сбросы по
210
+ актёру (`autonomy.actions.recorded.jointResets`). Граница — снимок IDs, а
211
+ не время, как у `jointBudgetCheckpoints`. `actor` называет вызывающий, число
212
+ сбросов не ограничено: код хоста не сбрасывает бюджет автоматически в
213
+ ответ на `ATTEMPTS_EXHAUSTED`, сброс — решение человека с причиной.
183
214
  - **Расход ревью плана.** Вызов о графе закрепляет за расходом группу и
184
215
  поручения из входного графа — и до его регистрации; повтор после
185
216
  исчерпания бюджета поручения или группы отклоняется до вызова.
@@ -683,8 +714,10 @@ executable. Live smoke — отдельный opt-in с явно заданны
683
714
  Вложенный `.git`, созданный или изменённый там (подмодули, клоны
684
715
  зависимостей), разрешён и записывается в `execution.prepared`: сверки
685
716
  исполнителя, установки и gates той же фазы не считают только его
686
- исчезновение (уборку переносом родителя); изменение и подмена другим
687
- `.git` остаются нарушением. Остальные защищённые пути, изменённые подготовкой, — отказ с
717
+ исчезновение (уборку переносом родителя), и только если родители от корня
718
+ до первого исчезнувшего звена — настоящие каталоги; изменение, подмена
719
+ другим `.git` и родитель, заменённый символьной ссылкой или файлом,
720
+ остаются нарушением. Остальные защищённые пути, изменённые подготовкой, — отказ с
688
721
  причиной `sandbox-policy` и путями в сообщении: в попытке — отказ
689
722
  окружения, в `gates-at` — ошибка команды, в подтверждении контрпримера —
690
723
  `inconclusive`. Совместная проверка рабочей области этой сверки не
@@ -696,7 +729,9 @@ executable. Live smoke — отдельный opt-in с явно заданны
696
729
  `.git` каталогом — нарушение. Пустым деревом не считаются FIFO, сокеты и
697
730
  прочие не-каталоги, а также каталог, открытый на запись всем
698
731
  (`mode & 0o002`; запись группе при umask 002 разрешена): у такого каталога
699
- права входят в подпись. Имена
732
+ права входят в подпись. Файл сравнивается по inode, размеру, mtime и
733
+ ctime: правку на месте, после которой `utimes` вернул mtime, выдаёт ctime;
734
+ её же меняют chmod/chown и новая жёсткая ссылка на защищённый файл. Имена
700
735
  сравниваются без регистра (на APFS и NTFS `.Claude/settings.json` хост
701
736
  читает как `.claude/settings.json`); Seatbelt на таком томе и сам закрывает
702
737
  запреты в любом регистре. Путь, который сверка не может прочитать (любая
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`: поручение, группа, прочее), счётчики, стоимость и её источник |
@@ -368,7 +462,9 @@ writer и reviewer кода получают список файлов набо
368
462
  техническая очередь ведущего, `contract-documents` — документы контрактов,
369
463
  прошедшие ревью, по digest, `spikes` — эксперименты выполнимости
370
464
  репозитория, `reproductions` — реестр воспроизведений из находок ревью по
371
- поручениям). `owner` — репозиторий или `@workspace`.
465
+ поручениям, `input-requests` — вопросы исполнителей и ответы на них,
466
+ `joint-budget-resets` — явные сбросы бюджета совместных проверок набора).
467
+ `owner` — репозиторий или `@workspace`.
372
468
 
373
469
  ## Ответы исполнителей
374
470
 
@@ -554,6 +650,18 @@ Schema строит подделку каждого поля (другое зн
554
650
  | `evidence[].summary` | сведение | описание записи |
555
651
  | `evidence[].consumer` | ожидание получателя | объявленный потребитель |
556
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 исполнителя |
557
665
  | `evidence[].tests` | ожидание получателя | доказательство названного testcase решающей записью |
558
666
  | `evidence[].tests[]` | ожидание получателя | элемент названного testcase; прочие элементы — сведения |
559
667
  | `evidence[].tests[].id` | ожидание получателя | ID названного testcase |
@@ -1013,7 +1121,13 @@ original}` (исходный тип, не длиннее 200 символов;
1013
1121
  транзакциями `recovery.*`, отказом и выдачей (`work.recovery`).
1014
1122
  `workspace.verification.started`, `workspace.manifest`, `workspace.evidence`,
1015
1123
  `workspace.verified`, `workspace.failed` — транзакции совместной проверки
1016
- (`joint.started`, `joint.finished`). `config.started`, `config.reconfigure-*`
1124
+ (`joint.started`, `joint.finished`; у прерванной до результата gates —
1125
+ `interrupted: true`). `workspace.budget-reset` — явный сброс бюджета
1126
+ совместных проверок набора: запись `joint-budget-resets` и событие
1127
+ `joint.budget-reset`. Договор хранилища (`executionStoreContract`)
1128
+ проверяет, что адаптер сохраняет `interrupted` совместной проверки и
1129
+ пространство `joint-budget-resets`; хост, который заводит проверку своей
1130
+ операцией, передаёт её в необязательном `startVerification`. `config.started`, `config.reconfigure-*`
1017
1131
  и `config.reconfigured` меняют применённую политику и запрос операции
1018
1132
  (`policy.applied`, `policy.reconfigure`). `base.moved` — проверка владения
1019
1133
  операцией и CAS-сдвиг ref базы; записей не создаёт, событие — `base.moved`.
@@ -0,0 +1,40 @@
1
+ # devcontour-harness 0.1.0-alpha.43
2
+
3
+ Остаточные исправления сверки защищённых путей после alpha.42: исчезновение
4
+ вложенного `.git` подготовки засчитывается только за настоящими каталогами,
5
+ подпись защищённого файла включает ctime. `stateVersion` и `policyVersion`
6
+ прежние.
7
+
8
+ ## Изменения
9
+
10
+ - **Исчезновение `.git` подготовки — только за настоящими каталогами.**
11
+ Вложенный `.git`, созданный подготовкой, по-прежнему может исчезнуть
12
+ (уборка переносом родителя). Исчезновением теперь считается только путь,
13
+ родители которого от корня до первого исчезнувшего звена — настоящие
14
+ каталоги. Родитель, заменённый символьной ссылкой или файлом, — нарушение
15
+ `scope-violation` (во время подготовки — `sandbox-policy`): прежде обход
16
+ дерева не заходил в ссылку, и `.git` за ней выглядел убранным.
17
+ - **Подпись защищённого файла с ctime.** Сверка сравнивает файл по inode,
18
+ размеру, mtime и ctime. Правка на месте в перенесённом наружу родителе,
19
+ после которой `utimes` вернул mtime, больше не проходит незамеченной.
20
+ chmod/chown, новая жёсткая ссылка и изменение расширенных атрибутов
21
+ защищённого файла — тоже изменение. Подпись каталогов прежняя.
22
+ - **Подмодуль из индекса переносом не убрать.** Документация называет это
23
+ явно: git хоста видит удаление отслеживаемого пути, и gate проваливается
24
+ проверкой отслеживаемых файлов; уборка такого подмодуля — дело подготовки
25
+ или teardown.
26
+
27
+ ## Совместимость
28
+
29
+ - Шаг подготовки или установки, который меняет права (`chmod -R`), делает
30
+ жёсткие ссылки (`cp -al`) или пишет расширенные атрибуты файлов `.idea`,
31
+ `.vscode`, `.claude` или `.git` в дереве, теперь получает отказ
32
+ (`sandbox-policy` при подготовке, `scope-violation` в работе исполнителя,
33
+ установки или gate). Держите такие шаги вне проверяемого дерева. На macOS
34
+ ctime меняет и запись расширенных атрибутов приложениями хоста (например,
35
+ открытие файла в Finder) — не открывайте защищённые файлы worktree во
36
+ время фазы.
37
+ - Окно между снимком и сверкой прежнее: процесс фазы, переживший её конец,
38
+ может изменить дерево после сверки. Сверка рассчитана на завершённые
39
+ процессы фазы.
40
+ - Откат возможен без изменений состояния.
@@ -0,0 +1,44 @@
1
+ # devcontour-harness 0.1.0-alpha.44
2
+
3
+ Совместная проверка, прерванная до результата gates, больше не тратит
4
+ предел проверок набора, а исчерпанный набор можно освободить явным сбросом
5
+ с причиной. `stateVersion` и `policyVersion` прежние.
6
+
7
+ ## Изменения
8
+
9
+ - **Прерванная совместная проверка не тратит предел набора.** `JointRunner`
10
+ называет прерыванием остановку хоста (внешний сигнал, не обход зависших)
11
+ и потерю владения (`LEASE_STALE`); истёкшую проверку, которую закрывает
12
+ следующий `jointStart`, — движок сам. Движок сохраняет `interrupted: true`
13
+ (и в `joint.finished`) только у проверки без evidence. Отказ gate, отказ
14
+ до gates без отметки (результат поручения вне target ref, отказ
15
+ подготовки) и прерывание после evidence тратят предел, как раньше. У
16
+ прерываний свой предел `MAX_NEUTRAL_FAILURES`, как у незасчитанных отказов
17
+ окружения поручений. Текст `ATTEMPTS_EXHAUSTED` называет число и выход.
18
+ - **Явный сброс бюджета.** `engine.jointBudgetReset(workIds, { reason, actor })`
19
+ освобождает исчерпанный набор, снимая только его завершённые проверки без
20
+ результата gates, в том числе отказы, записанные прежними версиями без
21
+ отметки. Результаты gates тратят предел и после сброса. Сброс, после
22
+ которого набор всё равно исчерпан (результатами gates или успешными
23
+ проверками без принятия), или которому нечего снимать, отклоняется
24
+ `ATTEMPTS_EXHAUSTED` и не записывается. Истёкшую проверку набора сброс
25
+ сначала закрывает. Причина, актёр и IDs снятых проверок хранятся в
26
+ пространстве `joint-budget-resets`, событие — `joint.budget-reset`; отчёт
27
+ об эффекте считает сбросы по актёру (`autonomy.actions.recorded.jointResets`).
28
+ - **Договор хранилища.** `executionStoreContract` проверяет, что адаптер
29
+ сохраняет `interrupted` совместной проверки и пространство
30
+ `joint-budget-resets`; хост, заводящий проверку своей операцией, передаёт
31
+ `startVerification`.
32
+
33
+ ## Совместимость
34
+
35
+ - Хост со своим хранилищем отображает `interrupted` проверки и пространство
36
+ `joint-budget-resets`, иначе прерванные проверки по-прежнему тратят предел.
37
+ Хост передаёт `JointRunner.run` сигнал своей остановки. Сброс бюджета —
38
+ действие оператора с причиной, а не автоматический ответ хоста на
39
+ `ATTEMPTS_EXHAUSTED`.
40
+ - Проверки, прерванные до этого выпуска, отметки не имеют; набор,
41
+ исчерпанный ими, освобождает `jointBudgetReset`.
42
+ - Состояние с `interrupted` или записями `joint-budget-resets` прежние
43
+ версии отклоняют: откат — через копию. Без них откат возможен без
44
+ изменений состояния.
@@ -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 откат возможен без изменений состояния.