devcontour-harness 0.1.0-alpha.24 → 0.1.0-alpha.26

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 (50) hide show
  1. package/README.md +44 -2
  2. package/docs/architecture.md +13 -0
  3. package/docs/compatibility.md +2 -0
  4. package/docs/connectors.md +69 -3
  5. package/docs/contracts.md +15 -1
  6. package/docs/release-notes/0.1.0-alpha.25.md +33 -0
  7. package/docs/release-notes/0.1.0-alpha.26.md +35 -0
  8. package/docs/review-protocol.md +9 -1
  9. package/lib/agents/cli-adapter.d.ts +6 -0
  10. package/lib/agents/cli-adapter.js +12 -2
  11. package/lib/agents/review-probe.d.ts +5 -0
  12. package/lib/agents/review-probe.js +29 -9
  13. package/lib/agents/schemas.d.ts +4 -0
  14. package/lib/agents/schemas.js +3 -1
  15. package/lib/cli.js +9 -5
  16. package/lib/contracts/cli.d.ts +60 -1
  17. package/lib/contracts/cli.js +36 -2
  18. package/lib/contracts/failure.js +1 -1
  19. package/lib/contracts/ports.d.ts +17 -0
  20. package/lib/contracts/review.d.ts +69 -0
  21. package/lib/contracts/review.js +29 -14
  22. package/lib/contracts/work.d.ts +6 -0
  23. package/lib/contracts/work.js +13 -12
  24. package/lib/control/review.js +9 -2
  25. package/lib/engine/engine.js +4 -2
  26. package/lib/engine/prompt.js +8 -2
  27. package/lib/engine/runner.js +7 -3
  28. package/lib/environment/bounded-read.d.ts +12 -0
  29. package/lib/environment/bounded-read.js +40 -0
  30. package/lib/integrations/connector/commands.d.ts +35 -7
  31. package/lib/integrations/connector/commands.js +52 -7
  32. package/lib/integrations/connector/config.d.ts +37 -0
  33. package/lib/integrations/connector/config.js +37 -5
  34. package/lib/integrations/connector/delivery.js +17 -1
  35. package/lib/integrations/connector/index.d.ts +2 -2
  36. package/lib/integrations/connector/index.js +1 -1
  37. package/lib/integrations/connector/snapshot.d.ts +10 -8
  38. package/lib/integrations/connector/snapshot.js +78 -8
  39. package/lib/integrations/connector/source.d.ts +8 -2
  40. package/lib/integrations/connector/source.js +32 -6
  41. package/lib/integrations/connector/summary.d.ts +6 -0
  42. package/lib/integrations/connector/summary.js +5 -0
  43. package/lib/integrations/connector/testing.js +18 -0
  44. package/lib/integrations/relay-v1/index.js +6 -4
  45. package/lib/integrations/relay-v2/protocol.js +8 -6
  46. package/lib/verification/confirm.js +10 -2
  47. package/lib/verification/gates.js +34 -12
  48. package/lib/verification/joint.d.ts +120 -1
  49. package/lib/verification/joint.js +38 -1
  50. package/package.json +6 -3
package/README.md CHANGED
@@ -5,7 +5,7 @@ Headless-движок исполнения инженерных поручени
5
5
  интеграция с принятой веткой через compare-and-swap и машинный результат с SHA
6
6
  и доказательствами.
7
7
 
8
- > Статус: `0.1.0-alpha.24` — предварительный выпуск (alpha). Договоры
8
+ > Статус: `0.1.0-alpha.26` — предварительный выпуск (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.24 # точная версия
31
+ npm install --save-exact devcontour-harness@0.1.0-alpha.26 # точная версия
32
32
  # или: npm install --save-exact devcontour-harness@alpha # текущая alpha
33
33
  npx harness --version
34
34
  ```
@@ -123,6 +123,21 @@ PASS» нет. Адаптеры хоста реализуют порты `Execut
123
123
  `devcontour-harness/schemas/<имя>.schema.json`. Декларации используют типы
124
124
  Node.js: TypeScript-потребителю нужен `@types/node` (или `skipLibCheck`).
125
125
 
126
+ ## Выпуск 0.1.0-alpha.26
127
+
128
+ Базовая линия коннектора для зависимостей, закрытых до подключения harness;
129
+ `source-snapshot` работает с пакетами контекста; первая ошибка компилятора
130
+ сохраняется в итоге gate; zod 4.6.7 и пределы вывода runtime. Подробно —
131
+ [заметки выпуска](docs/release-notes/0.1.0-alpha.26.md).
132
+
133
+ ## Выпуск 0.1.0-alpha.25
134
+
135
+ Native reviewer получает явное `previous: []` при пустой истории находок;
136
+ валидный JUnit сохраняется и при ненулевом коде gate. Хост может закрепить
137
+ границу бюджета успешно принятого цикла совместной проверки без сброса
138
+ попыток новым ID или сменой политики. Подробно —
139
+ [заметки выпуска](docs/release-notes/0.1.0-alpha.25.md).
140
+
126
141
  ## Выпуск 0.1.0-alpha.24
127
142
 
128
143
  Диагностика корня рабочих деревьев ничего не создаёт; новые корни и их
@@ -373,6 +388,33 @@ npm run check # lint, typecheck, схемы, сборка, тесты,
373
388
  npm run format:check
374
389
  ```
375
390
 
391
+ Три уровня проверки — от итерации над исправлением до выпуска:
392
+
393
+ | Уровень | Команда | Что запускает |
394
+ | --------------------- | ----------------------------------------- | -------------------------------------------------------------------------------------- |
395
+ | На каждое исправление | `npm run test:affected [-- --base <ref>]` | тест-файлы, в статическое замыкание которых входит изменённый файл |
396
+ | Быстрый | `npm run test:fast` | весь suite без медленного яруса (тесты дольше ~60 с) |
397
+ | Полный release check | `npm run check` | lint, typecheck, схемы, сборка, весь suite с полным размером оракулов, проверка архива |
398
+
399
+ - `test:affected` сравнивает с merge-base с `master` (или с `--base`) и
400
+ учитывает индекс, рабочее дерево и неотслеживаемые файлы. Замыкание идёт
401
+ от `tests/*.test.ts` по относительным путям (`import`, `import()`,
402
+ `new URL(…)`) через helpers и `src/`; barrel-модули уточняются по
403
+ импортированным именам. Изменение вне `src/` и `tests/*.test.ts`
404
+ (package.json, tsconfig, scripts, helpers и fixtures тестов, profiles,
405
+ schemas, docs), удалённый или недостижимый файл `src/` — весь suite.
406
+ Выбор и причина печатаются перед запуском. `npm run check:fast` —
407
+ статические шаги и `test:affected`.
408
+ - Медленный ярус — список `slowTests` в `scripts/test.mjs` (начала имён
409
+ тестов). `npm test` и `npm run check` выполняют его, как и раньше.
410
+ - Оракул H1 (`tests/explain-differential.test.ts`) сохраняет 100
411
+ детерминированных случаев в обычном, выборочном и полном прогоне
412
+ (`DIFF_N` переопределяет); быстрый ярус явно исключает этот тест.
413
+ - Статические шаги `npm run check` (lint, typecheck, schemas:check) идут
414
+ параллельно; сборка, тесты и проверка архива — после них, по очереди.
415
+ - Все режимы запускают тесты одинаково: отдельный процесс на файл, tsx, не
416
+ более четырёх файлов одновременно.
417
+
376
418
  Тесты используют настоящие временные Git-репозитории, SQLite и fixture
377
419
  executables CLI codex/claude; живые модели не вызываются. Результаты
378
420
  fixture-тестов не являются проверкой качества моделей.
@@ -167,6 +167,19 @@ runtime-граф пакета.
167
167
  (`BasisProvider.jointPolicyDigest/jointSpecDigest`); продуктовые условия
168
168
  каждой записи — `HostGuards.joint`. `jointResult(workIds, id)` оценивает
169
169
  указанную проверку.
170
+ - **Бюджет принятого цикла.** Без дополнения хоста `maxAttempts` ограничивает
171
+ всю историю одного набора поручений. Хост может передать через
172
+ `BasisProvider.jointBudgetCheckpoints` принятые им успешные проверки и
173
+ неизменяемые снимки IDs завершённых проверок на момент принятия. Движок
174
+ проверяет каждую границу: успешная проверка и весь непустой снимок должны
175
+ существовать, принадлежать тому же набору и быть завершены; снимок включает
176
+ саму принятую проверку, без повторов. Вне объединения этих снимков все
177
+ следующие проверки набора разделяют общий предел. Один PASS без принятия,
178
+ новый ID набора хоста, смена политики или постановки бюджет не закрывают.
179
+ Хост отвечает за доверенную локальную acceptance и сохранение снимка;
180
+ активные проверки в него не входят. Hook выполняется внутри транзакции
181
+ начала: ошибка откатывает всю запись. Снимки бюджета не заменяют gates,
182
+ доказательства на SHA или основание оптимизации `affected`.
170
183
  - **Расход ревью плана.** Вызов о графе закрепляет за расходом группу и
171
184
  поручения из входного графа — и до его регистрации; повтор после
172
185
  исчерпания бюджета поручения или группы отклоняется до вызова.
@@ -158,6 +158,7 @@ Standalone-хост использует `digestOf` (SHA-256 каноничес
158
158
  | Отчёт свойств, договор проверки, корпус | `version: 1` |
159
159
  | Владение репозиторием | `<git-common-dir>/devcontour-owner.json` |
160
160
  | Ресурсы | Отдельная база блокировок ресурсов `resources.sqlite`: блокировки устройств и портов, а не состояние исполнения |
161
+ | Снимок коннектора | Поля `proof` и `baseline` manifest необязательны: прежние записи читаются как есть. Без `baseline` в конфигурации ревизия, graph digest и context digest те же, что в прежних версиях |
161
162
  | Probe ревьюера | MCP-сервер `devcontour_probe`, инструмент `run_check`; протокол — построчный JSON-RPC (stdio), журнал `probes.jsonl` |
162
163
 
163
164
  ## Переменные окружения gates
@@ -182,6 +183,7 @@ Gates, шаги подготовки и проверки потребителе
182
183
  | Reviewer задаётся правилом | `different-vendor` по умолчанию; `same-vendor-allowed` включается явно |
183
184
  | Токены вне журнала | Исправление утечки: прежде `run.claimed` и `run.recovered` записывали в журнал попытку целиком, с fencing-токеном. Новые события пишутся без токенов; при выдаче старых событий наружу (CLI, HTTP, RunEvent) токены удаляются. Историю базы физически не переписываем |
184
185
  | История находок ревью | Reviewer называет состояние прежних находок; прежние попытки читаются без статусов; ревью кода ведёт историю находок поручения с ID controller, находки записей alpha.5 получают детерминированный ID (review-protocol.md) |
186
+ | Пределы ответа runtime | Действуют на границе приёма (contracts.md): схемы состояния, `schemas/*.schema.json` и digest политики не менялись, `storedReviewResultSchema` читает прежние `review.json`. Хост, разбирающий ответы через `reviewResultSchema`, получает новый предел |
185
187
 
186
188
  ## Состояние standalone
187
189
 
@@ -39,6 +39,7 @@ npx harness approve --state ../state --subject <graphId> --digest <graphDigest>
39
39
  # С --source внешние предпосылки (зависимости, выполненные через этот
40
40
  # коннектор) допускаются по решению источника (trusts) и доступности SHA в
41
41
  # target ref — те же правила, что у run; без --source доверенных receipt нет.
42
+ # Так же допускаются зависимости из baseline (см. «Базовая линия»).
42
43
  # В approvalMode: agent ревью плана выполняется в шаге 5 автоматически.
43
44
 
44
45
  # 5. Запуск: задачи перечитываются, semantic digest сверяется с закреплённым
@@ -113,6 +114,7 @@ CLI: 0 — успех, 2 — неверный вход, 3 — отказ/бло
113
114
  | `repository` | ID репозитория политики (и путь для сверки) |
114
115
  | `tasks[]` | Задачи: `ref` (постоянный ID или ключ), роль, `writeScope`, `gates`, сопоставление критериев, обязательные документы |
115
116
  | `tasks[].criteria[]` | Критерий (`id` или точный `title`) → `gate` и `testId` JUnit; `evidence: "gate"` — достаточно прошедшего gate (явный выбор) |
117
+ | `baseline` | Зависимости, закрытые до внедрения harness и принятые человеком: `sha`, `tasks`, `reason` (см. «Базовая линия») |
116
118
  | `tasks[].context` | Локальные пакеты контекста поручения — каталоги `<contextDir>/<id>` (например, `controller-mode`); закрепляются в снимке |
117
119
  | `completion` | `complete` — закрыть по правилам backend (по умолчанию в `done`); `review-only` — перевести в `review`/`column` и оставить человеку; `historicalComment` — при конфликте постановки записать явно исторический комментарий |
118
120
  | `eligibility.columns` | Колонки, из которых задача допускается к запуску (`done`/`cancelled` — никогда) |
@@ -138,11 +140,74 @@ reviewer, `references/` закрепляется digest без вложения.
138
140
  принятого результата конфликтом.
139
141
  - Нет каталога или пакета — `NOT_READY` до чтения backend; пакет через
140
142
  symlink — `INVALID_INPUT`. `source-check` называет то и другое в `problems`.
143
+ - Пакет вне договора источника контекста (больше 30 файлов или 60 справок,
144
+ имя файла с `*`, `?`, `:` и т. п.) — `LIMIT_EXCEEDED` в `problems` снимка и
145
+ `source-check`: запуск отказывает до согласования, а не после него.
141
146
  - Пределы контекста (файл, сумма, не больше 30 источников вместе с
142
147
  контекстами задач) проверяются при снимке: превышение — `LIMIT_EXCEEDED`, и
143
148
  задача не допускается к запуску.
144
149
  - Без поля снимок, ревизия и digest задачи те же, что в прежних версиях.
145
150
 
151
+ ### Базовая линия
152
+
153
+ В существующем проекте история закрыта вручную: receipt этого коннектора у неё
154
+ нет и получить его задним числом нельзя, поэтому задача, зависящая от такой
155
+ истории, не запускается (`DEPENDENCY_UNPROVEN`). Человек принимает такие
156
+ зависимости явно:
157
+
158
+ ```json
159
+ {
160
+ "baseline": {
161
+ "sha": "4f2c9a1e7b3d5c806e1f2a9d4b7c3e5f60a1b2c3",
162
+ "tasks": ["PRODUCT-1", "PRODUCT-2"],
163
+ "reason": "Closed by hand before the harness was adopted"
164
+ }
165
+ }
166
+ ```
167
+
168
+ - `sha` — полный SHA коммита (40 hex), `tasks` — точные ключи задач backend,
169
+ `reason` — непустая причина. Шаблонов, даты отсечения и общего переключателя
170
+ нет; лишнее поле, короткий SHA, повтор ключа или задача самой конфигурации —
171
+ `INVALID_INPUT`.
172
+ - Завершённая зависимость вне графа без receipt и с ключом в `tasks` становится
173
+ обычной предпосылкой: `resultSha` = `sha`, репозиторий — репозиторий
174
+ зависимой задачи, `receipt: {kind: 'trusted', issuer, digest}`, где digest —
175
+ запись базовой линии. Если у зависимости есть настоящий receipt, действует
176
+ он. Незавершённая остаётся `DEPENDENCY_UNFINISHED`, не указанная —
177
+ `DEPENDENCY_UNPROVEN`. Одна зависимость у задач разных репозиториев —
178
+ отказ: базовая линия — один коммит.
179
+ - `trusts` принимает такую предпосылку, только если digest и SHA совпадают с
180
+ **загруженной сейчас** конфигурацией, а backend подтверждает, что ключ — та
181
+ самая задача (чтение задачи; ошибка backend — отказ, а не «нет записи»).
182
+ Движок, как и для любой предпосылки, проверяет доступность SHA в target ref.
183
+ - Любая правка `baseline` меняет ревизию набора задач, даже если запись не
184
+ использована: `run --source` по прежнему снимку отказывает `APPROVAL_STALE`,
185
+ нужны новые `source-snapshot`, ревью плана и согласование. Semantic digest
186
+ задачи не меняется: доставка принятого результата конфликтом не становится.
187
+ - Происхождение видно: `proof: 'baseline'` у зависимости и `baseline` в
188
+ manifest, в ответах `source-snapshot`, `run --source` и `source-status`,
189
+ строка «Зависимости без доказательства» в итоге для задачи. Предпосылка
190
+ графа сама происхождение не несёт, поэтому `explain` его не показывает.
191
+
192
+ **Что это доказывает.** Только то, что указанный коммит есть в target ref и что
193
+ человек записал своё решение. Что работа задачи действительно входит в этот
194
+ коммит, никто не проверял: SHA общий для всех ключей, gates и ревью по нему не
195
+ запускались. Это решение оператора, а не receipt.
196
+
197
+ **Кто может её изменить.** С `baseline` файл конфигурации обязан лежать вне
198
+ репозиториев политики или внутри их `protectedPaths`: `.harness/connector.json`
199
+ при политике из `harness init` подходит (`.harness/` защищён). Иначе
200
+ `review-plan --source` и `run --source` отказывают `NOT_READY`, а `source-check`
201
+ с `--policy` называет это в `problems`. Ссылка на файл разрешается до проверки.
202
+ Runner отклоняет результат попытки, меняющий защищённый путь, а при
203
+ `isolation.mode: "os"` запись вне рабочего дерева запрещена и самому процессу.
204
+ Защита действует против писателя поручения, а не против того, кто запускает
205
+ harness: controller с доступом к файлу может его изменить, и при
206
+ `approvalMode: agent` человек такую правку не согласует. При `isolation.mode:
207
+ "none"` запрет записи вне дерева держится только на самом runtime. Конфигурация,
208
+ переданная библиотеке объектом, и прямой `Harness.run({ source })` мимо
209
+ `Connector.run` этой проверки не проходят: там за файл отвечает вызывающий код.
210
+
146
211
  ### Идентичность и снимок
147
212
 
148
213
  - Идентичность задачи — `<provider>:<projectId>:<постоянный ID>`; ID поручения
@@ -164,12 +229,13 @@ reviewer, `references/` закрепляется digest без вложения.
164
229
  manifest (`truncated`) либо опускаются с записью в `missing` снимка.
165
230
  - Eligibility проверяется отдельно от digest: `done`/`cancelled`, колонка вне
166
231
  `eligibility.columns`, незавершённая зависимость, зависимость в `done` без
167
- receipt этого коннектора. Колонка, в которую задачу перевела наша
232
+ receipt этого коннектора и без записи в `baseline`. Колонка, в которую задачу перевела наша
168
233
  подтверждённая доставка той же постановки, повтор не блокирует.
169
234
  - Статус `done` зависимости — не доказательство: предпосылка зависимой
170
235
  задачи появляется только из receipt доставки этого коннектора (издатель —
171
- ID коннектора, digest сверяется с его состоянием), и движок дополнительно
172
- проверяет доступность result SHA в target ref.
236
+ ID коннектора, digest сверяется с его состоянием) или из явной записи
237
+ человека в `baseline`, и движок дополнительно проверяет доступность SHA в
238
+ target ref.
173
239
 
174
240
  ## Доставка: протокол и гарантии
175
241
 
package/docs/contracts.md CHANGED
@@ -87,7 +87,11 @@ SHA-256 канонического JSON (`canonicalJson`: ключи по пор
87
87
  Доверие к `trusted` решает `WorkSource.trusts`: `Harness.run({ source })`
88
88
  спрашивает источник графа (его `id` обязан совпасть с `graph.source.connector`);
89
89
  без источника доверенных receipt нет. В обоих случаях движок проверяет, что
90
- result SHA доступен в target ref.
90
+ result SHA доступен в target ref. Коннектор задач выдаёт `trusted` и для
91
+ явной записи человека (`baseline`, см. [connectors.md](connectors.md)): форма
92
+ предпосылки та же, происхождение (`proof: 'receipt' | 'baseline'`) записано в
93
+ manifest снимка и в необязательном поле `baseline` ответов `source-snapshot`,
94
+ `source-status` и `run --source`.
91
95
 
92
96
  ### ExecutionPolicy
93
97
 
@@ -324,6 +328,16 @@ Runtime возвращает сырой ответ; движок разбира
324
328
  аддитивное поле `reviewRound`, находки — `id`/`status`, ссылки результата —
325
329
  `review`. Правила — [docs/review-protocol.md](review-protocol.md).
326
330
 
331
+ Ответ runtime ограничен на границе приёма. В `reviewResultSchema` — не больше
332
+ 500 элементов в `findings` и в `previous` (`REVIEW_ITEMS_LIMIT`; те же
333
+ `maxItems` объявляет wire-схема CLI runtime); файл ответа codex — не больше
334
+ 4 МиБ (`CODEX_RESULT_LIMIT`), читается с границей, без перехода по symlink, а
335
+ файл больше предела удаляется: он не прошёл маскирование. Сверх предела — обычный
336
+ отказ попытки: у reviewer ошибка протокола `schema`, у исполнителя класс
337
+ `unknown` без автоматического повтора. Записанное прежними версиями читается
338
+ без этих пределов: `review.json` — `storedReviewResultSchema`, а `ReviewRecord`
339
+ и evidence пределов не получили.
340
+
327
341
  ## Выходы
328
342
 
329
343
  ### RunResult
@@ -0,0 +1,33 @@
1
+ # devcontour-harness 0.1.0-alpha.25
2
+
3
+ Уточнение запроса ревью, сохранение отчётов упавших проверок и необязательная
4
+ граница бюджета принятых циклов для хостов. Форматы состояния и политики,
5
+ обязательные gates, fencing и привязка доказательств к SHA не меняются.
6
+
7
+ ## Изменения
8
+
9
+ - **Пустая история находок.** Native reviewer явно получает требование
10
+ `previous: []`, если controller ещё не выдавал находок. Ошибки прежних
11
+ попыток и наблюдения gates остаются диагностическим контекстом; их нельзя
12
+ превращать в ссылки на придуманные ID. Строгая проверка ответа и повтор
13
+ после ошибки протокола сохраняются.
14
+ - **Отчёт при ненулевом коде.** Читаемый валидный JUnit сохраняется рядом с
15
+ логом gate и при ненулевом коде команды, с прежней проверкой границ пути
16
+ и маскированием секретов. Отчёт не превращает отказ в успех и не меняет
17
+ класс настоящего отказа песочницы.
18
+ - **Бюджет принятого цикла.** Опциональный
19
+ `BasisProvider.jointBudgetCheckpoints` сообщает успешно принятые хостом
20
+ проверки и неизменяемые снимки IDs завершённых проверок на момент принятия.
21
+ Движок проверяет границы и считает все последующие попытки того же набора
22
+ вне объединения снимков. Новый ID набора, политика или постановка бюджет
23
+ не закрывают; одного PASS без принятия недостаточно. Без hook действует
24
+ прежний предел всей истории набора. Хост отвечает за доверенную локальную
25
+ acceptance и сохранение снимка; активные проверки в снимок не входят.
26
+
27
+ ## Обновление
28
+
29
+ Пакет alpha.24 остаётся неизменным. Перед обновлением остановите writers и
30
+ сохраните копию состояния. Активные попытки и совместные проверки закреплены
31
+ за начавшей их версией движка: новая версия их не продолжает. Преобразование
32
+ состояния не требуется. Новые сведения о продуктовой acceptance хранит хост;
33
+ hook не выдаёт перенесённую историю за локальный запуск проверок.
@@ -0,0 +1,35 @@
1
+ # devcontour-harness 0.1.0-alpha.26
2
+
3
+ Базовая линия коннектора для существующих проектов, исправление снимка с
4
+ пакетами контекста, причина отказа gate в итоге проверки, обновление
5
+ зависимостей и пределы недоверенного вывода runtime. Обязательные gates,
6
+ fencing и привязка доказательств к SHA не меняются.
7
+
8
+ ## Изменения
9
+
10
+ - **Базовая линия коннектора.** Поле `baseline` конфигурации (`sha`, `tasks`,
11
+ `reason`) допускает завершённую зависимость, закрытую вне harness, если она
12
+ названа по ключу, а SHA достижим в target ref. Настоящий receipt важнее.
13
+ В снимке такая зависимость отмечена `proof: baseline`: это решение человека,
14
+ а не доказательство. С `baseline` конфигурация обязана лежать вне
15
+ репозиториев политики или в `protectedPaths`.
16
+ - **`source-snapshot` с пакетами контекста.** CLI больше не падает с INTERNAL
17
+ на поле `localContext`. Пакет вне договора источника и недопустимый
18
+ `writeScope` отказывают раньше и с именем поля. Нарушение договора вывода
19
+ показывает пути полей.
20
+ - **Причина отказа gate.** Первая ошибка компилятора с координатами
21
+ дописывается перед прежним хвостом вывода: хвост не меняется, поэтому
22
+ отпечаток отказа не теряет различий. Окно отпечатка расширено до 4000
23
+ символов; некоторые длинные отказы получат новый отпечаток.
24
+ - **Зависимости.** zod 4.6.7, node-forge 1.4.2, fast-uri 3.1.9. Транзитивный
25
+ zod 3.25.76 в sandbox-runtime остаётся: исправленного выпуска 3.x нет.
26
+ - **Пределы вывода runtime.** `findings` и `previous` — до 500, Codex
27
+ `result.json` — до 4 МиБ с ограниченным чтением, файл результата проверки —
28
+ до 1 МиБ, массивы ответов Relay — до 10 000. Сверх предела — обычный отказ
29
+ попытки с причиной. Сохранённые записи читаются без этих пределов.
30
+
31
+ ## Обновление
32
+
33
+ Пакет alpha.25 остаётся неизменным. Перед обновлением остановите writers и
34
+ сохраните копию состояния. Преобразование состояния не требуется. Хостам с
35
+ собственным zod нужна та же версия 4.6.7, чтобы осталась одна копия.
@@ -74,6 +74,13 @@ ID: дедупликации по тексту нет, поэтому повто
74
74
 
75
75
  `note`, оставленная открытой явным переходом, не мешает `approved: true`.
76
76
 
77
+ **Пределы.** В ответе не больше 500 находок и 500 переходов
78
+ (`REVIEW_ITEMS_LIMIT`): больше — ошибка `schema` с путём `findings` или
79
+ `previous`. Файл ответа codex больше предела — ошибка `schema` с путём
80
+ `(response)`, как и нечитаемый ответ. Если открытых находок поручения больше
81
+ 500, раунд не записать: попытка останавливается с `review-protocol` до вызова
82
+ reviewer.
83
+
77
84
  **Атомарность.** Ответ проверяется целиком до любой записи. Невалидный ответ
78
85
  не закрывает ни одной находки, не создаёт новых и не даёт PASS: он
79
86
  сохраняется только как диагностика (сырой ответ — в своём `review.json`,
@@ -208,7 +215,8 @@ id = digestOf({ v: 'legacy-1', scope, evidence: e.id, runId, phase, sha, index,
208
215
  `technicalReview` (ревью плана и контракта) применяет то же правило
209
216
  атомарности: невалидный ответ (вне схемы или с нарушением `reviewIssues`)
210
217
  не применяет переходы и не добавляет находок; раунд записывается
211
- неодобренным с причинами. Повторно найденная закрытая находка с тем же ID
218
+ неодобренным с причинами (у ответа вне схемы — путь поля и сообщение первой
219
+ ошибки). Повторно найденная закрытая находка с тем же ID
212
220
  открывается снова, а не отбрасывается как дубликат. Формат `ReviewRecord`
213
221
  не меняется.
214
222
 
@@ -1,6 +1,12 @@
1
1
  import type { z } from 'zod';
2
2
  import type { ProbeServer, RuntimeAdapter, toolProfileSchema } from '../contracts/index.ts';
3
3
  type ToolProfile = z.infer<typeof toolProfileSchema>;
4
+ /**
5
+ * Предел файла ответа codex: вдвое выше хвоста stdout, в котором приходит ответ
6
+ * claude (2 000 000 символов). Ответ модели на порядки меньше, а разбор
7
+ * файла на пределе занимает меньше 100 МБ кучи.
8
+ */
9
+ export declare const CODEX_RESULT_LIMIT: number;
4
10
  /** Встроенные инструменты исполнителя claude, когда профиль их не называет; shell — в песочнице ОС. */
5
11
  export declare const claudeWriterTools: readonly ["Read", "Glob", "Grep", "Edit", "Write", "Bash"];
6
12
  /** Может ли reviewer запускать проверки: у claude — только Bash, явно данный профилем. */
@@ -1,7 +1,8 @@
1
1
  import { appendFileSync } from 'node:fs';
2
- import { mkdir, mkdtemp, readFile, writeFile } from 'node:fs/promises';
2
+ import { mkdir, mkdtemp, rm, writeFile } from 'node:fs/promises';
3
3
  import { homedir, tmpdir } from 'node:os';
4
4
  import { join } from 'node:path';
5
+ import { OversizedFile, readBounded } from "../environment/bounded-read.js";
5
6
  import { command } from "../environment/process.js";
6
7
  import { claudeFileDenies, claudeFileTools, claudeSandbox, codexPermissions, isolation, } from "../environment/isolation.js";
7
8
  import { redactor } from "../environment/redaction.js";
@@ -9,6 +10,12 @@ import { inspectReview } from "./inspect.js";
9
10
  import { probeCallMs, probeServer, probeTool } from "./review-probe.js";
10
11
  import { claudeResult, runtimeEvents } from "./runtime-events.js";
11
12
  import { runtimeVersion, unknownUsage, usageStream } from "./usage.js";
13
+ /**
14
+ * Предел файла ответа codex: вдвое выше хвоста stdout, в котором приходит ответ
15
+ * claude (2 000 000 символов). Ответ модели на порядки меньше, а разбор
16
+ * файла на пределе занимает меньше 100 МБ кучи.
17
+ */
18
+ export const CODEX_RESULT_LIMIT = 4 * 1024 * 1024;
12
19
  /** Встроенные инструменты исполнителя claude, когда профиль их не называет; shell — в песочнице ОС. */
13
20
  export const claudeWriterTools = ['Read', 'Glob', 'Grep', 'Edit', 'Write', 'Bash'];
14
21
  const writerTools = (profile) => profile?.claudeTools ?? claudeWriterTools;
@@ -370,7 +377,7 @@ export function cliAdapter(runtime, options = {}) {
370
377
  let output;
371
378
  try {
372
379
  if (runtime === 'codex') {
373
- const cleaned = redact(await readFile(resultPath, 'utf8'));
380
+ const cleaned = redact(await readBounded(resultPath, CODEX_RESULT_LIMIT));
374
381
  await writeFile(resultPath, cleaned);
375
382
  output = JSON.parse(cleaned);
376
383
  }
@@ -386,6 +393,9 @@ export function cliAdapter(runtime, options = {}) {
386
393
  }
387
394
  }
388
395
  catch (error) {
396
+ // Непрочитанный файл не замаскирован: на диске он не остаётся.
397
+ if (error instanceof OversizedFile)
398
+ await rm(resultPath, { force: true }).catch(() => undefined);
389
399
  return {
390
400
  ...base,
391
401
  status: 'failed',
@@ -84,6 +84,11 @@ export declare const probeSpec: z.ZodObject<{
84
84
  artifacts: z.ZodOptional<z.ZodString>;
85
85
  }, z.core.$strip>;
86
86
  export type ProbeSpec = z.infer<typeof probeSpec>;
87
+ /**
88
+ * Спецификация вне пределов — отказ среды, названный controller до запуска:
89
+ * иначе сервер проверок упал бы при старте, и reviewer получил бы отказ без причины.
90
+ */
91
+ export declare function assertProbeSpec(spec: ProbeSpec): void;
87
92
  export declare const probeInput: z.ZodObject<{
88
93
  argv: z.ZodOptional<z.ZodArray<z.ZodString>>;
89
94
  gate: z.ZodOptional<z.ZodString>;
@@ -7,7 +7,7 @@ import { dirname, join, relative, resolve, sep } from 'node:path';
7
7
  import { createInterface } from 'node:readline';
8
8
  import { fileURLToPath } from 'node:url';
9
9
  import { z } from 'zod';
10
- import { idSchema, relativePathSchema, sha256, } from "../contracts/index.js";
10
+ import { idSchema, relativePathSchema, sha256, TaskFailure, } from "../contracts/index.js";
11
11
  import { osToolEnv } from "../environment/os-tools.js";
12
12
  import { redactor } from "../environment/redaction.js";
13
13
  import { completedCheck, freshnessEnv, propertyReportEnv, junitSummary, runCheck, sandboxBlockedHosts, } from "../verification/gates.js";
@@ -33,11 +33,17 @@ import { completedCheck, freshnessEnv, propertyReportEnv, junitSummary, runCheck
33
33
  */
34
34
  export const probeServer = 'devcontour_probe';
35
35
  export const probeTool = 'run_check';
36
+ /**
37
+ * Предел списков спецификации probe. Спецификацию пишет controller, но она
38
+ * читается отдельным процессом: файл, выросший сверх любой разумной политики,
39
+ * не разворачивается в ошибку на каждый элемент.
40
+ */
41
+ const PROBE_LIST_LIMIT = 10_000;
36
42
  /** Объявленный gate в виде, в каком его исполняет probe: копия из эффективной политики. */
37
43
  export const probeGate = z.strictObject({
38
44
  id: idSchema,
39
45
  kind: z.enum(['test', 'check']),
40
- command: z.array(z.string().min(1)).min(1),
46
+ command: z.array(z.string().min(1)).min(1).max(PROBE_LIST_LIMIT),
41
47
  cwd: relativePathSchema.optional(),
42
48
  timeoutMs: z.number().positive(),
43
49
  report: z.strictObject({ type: z.literal('junit'), path: relativePathSchema }).optional(),
@@ -47,22 +53,25 @@ export const probeGate = z.strictObject({
47
53
  export const probeSpec = z.object({
48
54
  cwd: z.string().min(1),
49
55
  /** Закрытое проверке и открытое на чтение — граница reviewer. */
50
- controller: z.array(z.string()),
51
- readable: z.array(z.string()),
56
+ controller: z.array(z.string()).max(PROBE_LIST_LIMIT),
57
+ readable: z.array(z.string()).max(PROBE_LIST_LIMIT),
52
58
  /** Корни рабочих деревьев вне каталога состояния (закрыты целиком). */
53
- checkouts: z.array(z.string()).optional(),
54
- isolation: z.object({ mode: z.enum(['os', 'none']), domains: z.array(z.string()) }),
59
+ checkouts: z.array(z.string()).max(PROBE_LIST_LIMIT).optional(),
60
+ isolation: z.object({
61
+ mode: z.enum(['os', 'none']),
62
+ domains: z.array(z.string()).max(PROBE_LIST_LIMIT),
63
+ }),
55
64
  commandTimeoutMs: z.number().int().min(1000),
56
65
  budgetMs: z.number().int().min(1000),
57
66
  /** Момент, к которому ревью должно быть готово дать заключение (epoch ms). */
58
67
  deadline: z.number().int(),
59
68
  /** Переменные окружения, передаваемые по имени; значения на диск не пишутся. */
60
- env: z.array(z.string()),
61
- secrets: z.array(z.string()),
69
+ env: z.array(z.string()).max(PROBE_LIST_LIMIT),
70
+ secrets: z.array(z.string()).max(PROBE_LIST_LIMIT),
62
71
  settingsDir: z.string().min(1),
63
72
  log: z.string().min(1),
64
73
  /** Объявленные gates, которые reviewer может запустить по ID. */
65
- gates: z.array(probeGate).optional(),
74
+ gates: z.array(probeGate).max(PROBE_LIST_LIMIT).optional(),
66
75
  /** Фаза и SHA ревью: записываются в каждый запуск gate. */
67
76
  phase: z.string().optional(),
68
77
  sha: z.string().optional(),
@@ -82,6 +91,17 @@ export const probeSpec = z.object({
82
91
  /** Каталог controller для отчётов и журналов запусков gate; вне проверяемого дерева. */
83
92
  artifacts: z.string().optional(),
84
93
  });
94
+ /**
95
+ * Спецификация вне пределов — отказ среды, названный controller до запуска:
96
+ * иначе сервер проверок упал бы при старте, и reviewer получил бы отказ без причины.
97
+ */
98
+ export function assertProbeSpec(spec) {
99
+ const parsed = probeSpec.safeParse(spec);
100
+ if (parsed.success)
101
+ return;
102
+ const issue = parsed.error.issues[0];
103
+ throw new TaskFailure('environment', `Спецификация проверок ревью вне схемы: ${issue?.path.join('.')}: ${issue?.message}`);
104
+ }
85
105
  export const probeInput = z
86
106
  .strictObject({
87
107
  argv: z.array(z.string().min(1)).min(1).max(64).optional(),
@@ -121,6 +121,7 @@ export declare const reviewOutputSchema: {
121
121
  };
122
122
  findings: {
123
123
  type: string;
124
+ maxItems: number;
124
125
  items: {
125
126
  type: string;
126
127
  additionalProperties: boolean;
@@ -195,6 +196,7 @@ export declare const reviewOutputSchema: {
195
196
  };
196
197
  previous: {
197
198
  type: string;
199
+ maxItems: number;
198
200
  items: {
199
201
  type: string;
200
202
  additionalProperties: boolean;
@@ -322,6 +324,7 @@ export declare const alreadySatisfiedReviewOutputSchema: {
322
324
  };
323
325
  findings: {
324
326
  type: string;
327
+ maxItems: number;
325
328
  items: {
326
329
  type: string;
327
330
  additionalProperties: boolean;
@@ -396,6 +399,7 @@ export declare const alreadySatisfiedReviewOutputSchema: {
396
399
  };
397
400
  previous: {
398
401
  type: string;
402
+ maxItems: number;
399
403
  items: {
400
404
  type: string;
401
405
  additionalProperties: boolean;
@@ -1,4 +1,4 @@
1
- import { FINDING_BASIS_PATTERN, FINDING_ID_PATTERN, findingStatuses } from "../contracts/review.js";
1
+ import { FINDING_BASIS_PATTERN, FINDING_ID_PATTERN, REVIEW_ITEMS_LIMIT, findingStatuses, } from "../contracts/review.js";
2
2
  /**
3
3
  * JSON Schema структурированного ответа для CLI runtime. Codex требует
4
4
  * закрытые объекты, где каждое свойство обязательно (необязательность —
@@ -60,6 +60,7 @@ export const reviewOutputSchema = {
60
60
  discoveries: { type: 'array', maxItems: 20, items: discovery },
61
61
  findings: {
62
62
  type: 'array',
63
+ maxItems: REVIEW_ITEMS_LIMIT,
63
64
  items: {
64
65
  type: 'object',
65
66
  additionalProperties: false,
@@ -115,6 +116,7 @@ export const reviewOutputSchema = {
115
116
  },
116
117
  previous: {
117
118
  type: 'array',
119
+ maxItems: REVIEW_ITEMS_LIMIT,
118
120
  items: {
119
121
  type: 'object',
120
122
  additionalProperties: false,
package/lib/cli.js CHANGED
@@ -3,7 +3,8 @@ import { execFileSync } from 'node:child_process';
3
3
  import { existsSync, lstatSync, readFileSync, readdirSync, writeFileSync, mkdirSync, } from 'node:fs';
4
4
  import { basename, dirname, join, resolve } from 'node:path';
5
5
  import { parseArgs } from 'node:util';
6
- import { API_VERSION, HarnessError, authorSchema, cliCommands, cliDataSchemas, contextSnapshotSchema, contractDocumentSchema, errorCodes, executionPolicySchema, exitCodeOf, exitCodes, } from "./contracts/index.js";
6
+ import { z } from 'zod';
7
+ import { API_VERSION, HarnessError, authorSchema, cliCommands, cliDataSchemas, contractViolation, contextSnapshotSchema, contractDocumentSchema, errorCodes, executionPolicySchema, exitCodeOf, exitCodes, } from "./contracts/index.js";
7
8
  import { HARNESS_VERSION } from "./package.js";
8
9
  import { validateInputs } from "./validate.js";
9
10
  import { Harness } from "./control/harness.js";
@@ -335,6 +336,7 @@ async function run(argv) {
335
336
  try {
336
337
  if (connector.id !== graph.source.connector)
337
338
  throw new HarnessError('INVALID_INPUT', `Граф из источника ${graph.source.connector}, передан источник ${connector.id}`);
339
+ connector.assertBaselineProtected(b.policy, b.baseDir);
338
340
  const trusted = new Set();
339
341
  for (const p of graph.prerequisites)
340
342
  if (p.receipt.kind === 'trusted' && (await connector.source.trusts(p)))
@@ -486,10 +488,10 @@ async function run(argv) {
486
488
  return { command, data: { pin: profilePin(profile), profile } };
487
489
  }
488
490
  case 'source-check': {
489
- const policyOf = v.policy ? loadPolicy(v.policy).policy : undefined;
490
- const connector = await connectorOf(need('source'), v.state ?? '.', policyOf);
491
+ const loaded = v.policy ? loadPolicy(v.policy) : undefined;
492
+ const connector = await connectorOf(need('source'), v.state ?? '.', loaded?.policy);
491
493
  try {
492
- const data = await connector.check(policyOf);
494
+ const data = await connector.check(loaded?.policy, loaded?.baseDir);
493
495
  const ok = data.connected && data.projectMatches && data.problems.length === 0;
494
496
  return { command, data, code: ok ? exitCodes.ok : exitCodes.refused };
495
497
  }
@@ -650,7 +652,9 @@ catch (error) {
650
652
  : error instanceof TypeError &&
651
653
  error.code?.startsWith('ERR_PARSE_ARGS')
652
654
  ? new HarnessError('INVALID_INPUT', error.message)
653
- : new HarnessError('INTERNAL', error?.message ?? String(error));
655
+ : error instanceof z.ZodError
656
+ ? contractViolation(error)
657
+ : new HarnessError('INTERNAL', error?.message ?? String(error));
654
658
  code = exitCodeOf(known);
655
659
  const command = argv[0] && argv[0] in cliCommands ? argv[0] : null;
656
660
  envelope = { apiVersion: API_VERSION, command, ok: false, error: known.toJSON() };