devcontour-harness 0.1.0-alpha.25 → 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.
- package/README.md +9 -2
- package/docs/compatibility.md +2 -0
- package/docs/connectors.md +69 -3
- package/docs/contracts.md +15 -1
- package/docs/release-notes/0.1.0-alpha.26.md +35 -0
- package/docs/review-protocol.md +9 -1
- package/lib/agents/cli-adapter.d.ts +6 -0
- package/lib/agents/cli-adapter.js +12 -2
- package/lib/agents/review-probe.d.ts +5 -0
- package/lib/agents/review-probe.js +29 -9
- package/lib/agents/schemas.d.ts +4 -0
- package/lib/agents/schemas.js +3 -1
- package/lib/cli.js +9 -5
- package/lib/contracts/cli.d.ts +60 -1
- package/lib/contracts/cli.js +36 -2
- package/lib/contracts/failure.js +1 -1
- package/lib/contracts/review.d.ts +69 -0
- package/lib/contracts/review.js +29 -14
- package/lib/contracts/work.d.ts +6 -0
- package/lib/contracts/work.js +13 -12
- package/lib/control/review.js +9 -2
- package/lib/engine/runner.js +7 -3
- package/lib/environment/bounded-read.d.ts +12 -0
- package/lib/environment/bounded-read.js +40 -0
- package/lib/integrations/connector/commands.d.ts +35 -7
- package/lib/integrations/connector/commands.js +52 -7
- package/lib/integrations/connector/config.d.ts +37 -0
- package/lib/integrations/connector/config.js +37 -5
- package/lib/integrations/connector/delivery.js +17 -1
- package/lib/integrations/connector/index.d.ts +2 -2
- package/lib/integrations/connector/index.js +1 -1
- package/lib/integrations/connector/snapshot.d.ts +10 -8
- package/lib/integrations/connector/snapshot.js +78 -8
- package/lib/integrations/connector/source.d.ts +8 -2
- package/lib/integrations/connector/source.js +32 -6
- package/lib/integrations/connector/summary.d.ts +6 -0
- package/lib/integrations/connector/summary.js +5 -0
- package/lib/integrations/connector/testing.js +18 -0
- package/lib/integrations/relay-v1/index.js +6 -4
- package/lib/integrations/relay-v2/protocol.js +8 -6
- package/lib/verification/confirm.js +10 -2
- package/lib/verification/gates.js +24 -7
- package/package.json +2 -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.
|
|
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.
|
|
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,13 @@ 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
|
+
|
|
126
133
|
## Выпуск 0.1.0-alpha.25
|
|
127
134
|
|
|
128
135
|
Native reviewer получает явное `previous: []` при пустой истории находок;
|
package/docs/compatibility.md
CHANGED
|
@@ -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
|
|
package/docs/connectors.md
CHANGED
|
@@ -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
|
-
проверяет доступность
|
|
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,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, чтобы осталась одна копия.
|
package/docs/review-protocol.md
CHANGED
|
@@ -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
|
-
неодобренным с
|
|
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,
|
|
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
|
|
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({
|
|
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(),
|
package/lib/agents/schemas.d.ts
CHANGED
|
@@ -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;
|
package/lib/agents/schemas.js
CHANGED
|
@@ -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 {
|
|
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
|
|
490
|
-
const connector = await connectorOf(need('source'), v.state ?? '.',
|
|
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(
|
|
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
|
-
:
|
|
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() };
|
package/lib/contracts/cli.d.ts
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
import { z } from 'zod';
|
|
2
2
|
import { API_VERSION } from './version.ts';
|
|
3
|
-
import { type ErrorCode } from './errors.ts';
|
|
3
|
+
import { HarnessError, type ErrorCode } from './errors.ts';
|
|
4
4
|
/**
|
|
5
5
|
* Договор CLI `harness`.
|
|
6
6
|
*
|
|
@@ -1165,6 +1165,11 @@ export declare const runDataSchema: z.ZodObject<{
|
|
|
1165
1165
|
graphId: z.ZodString;
|
|
1166
1166
|
digest: z.ZodString;
|
|
1167
1167
|
resumed: z.ZodBoolean;
|
|
1168
|
+
baseline: z.ZodOptional<z.ZodObject<{
|
|
1169
|
+
sha: z.ZodString;
|
|
1170
|
+
reason: z.ZodString;
|
|
1171
|
+
tasks: z.ZodArray<z.ZodString>;
|
|
1172
|
+
}, z.core.$strict>>;
|
|
1168
1173
|
works: z.ZodArray<z.ZodObject<{
|
|
1169
1174
|
id: z.ZodString;
|
|
1170
1175
|
status: z.ZodEnum<{
|
|
@@ -1597,16 +1602,37 @@ export declare const sourceCheckDataSchema: z.ZodObject<{
|
|
|
1597
1602
|
}, z.core.$strict>;
|
|
1598
1603
|
problems: z.ZodArray<z.ZodString>;
|
|
1599
1604
|
}, z.core.$strict>;
|
|
1605
|
+
/** Закреплённый локальный пакет `tasks[].context`: то, что называет manifest снимка. */
|
|
1606
|
+
export declare const localContextManifestSchema: z.ZodObject<{
|
|
1607
|
+
id: z.ZodString;
|
|
1608
|
+
digest: z.ZodString;
|
|
1609
|
+
files: z.ZodNumber;
|
|
1610
|
+
references: z.ZodNumber;
|
|
1611
|
+
bytes: z.ZodNumber;
|
|
1612
|
+
}, z.core.$strict>;
|
|
1613
|
+
export type LocalContextManifest = z.infer<typeof localContextManifestSchema>;
|
|
1600
1614
|
export declare const sourceSnapshotDataSchema: z.ZodObject<{
|
|
1601
1615
|
connector: z.ZodString;
|
|
1602
1616
|
graphId: z.ZodString;
|
|
1603
1617
|
graphDigest: z.ZodString;
|
|
1604
1618
|
contextDigest: z.ZodString;
|
|
1619
|
+
localContext: z.ZodOptional<z.ZodArray<z.ZodObject<{
|
|
1620
|
+
id: z.ZodString;
|
|
1621
|
+
digest: z.ZodString;
|
|
1622
|
+
files: z.ZodNumber;
|
|
1623
|
+
references: z.ZodNumber;
|
|
1624
|
+
bytes: z.ZodNumber;
|
|
1625
|
+
}, z.core.$strict>>>;
|
|
1605
1626
|
revision: z.ZodString;
|
|
1606
1627
|
created: z.ZodBoolean;
|
|
1607
1628
|
eligible: z.ZodBoolean;
|
|
1608
1629
|
problems: z.ZodArray<z.ZodString>;
|
|
1609
1630
|
truncated: z.ZodArray<z.ZodString>;
|
|
1631
|
+
baseline: z.ZodOptional<z.ZodObject<{
|
|
1632
|
+
sha: z.ZodString;
|
|
1633
|
+
reason: z.ZodString;
|
|
1634
|
+
tasks: z.ZodArray<z.ZodString>;
|
|
1635
|
+
}, z.core.$strict>>;
|
|
1610
1636
|
tasks: z.ZodArray<z.ZodObject<{
|
|
1611
1637
|
identity: z.ZodString;
|
|
1612
1638
|
key: z.ZodString;
|
|
@@ -1631,6 +1657,11 @@ export declare const sourceStatusDataSchema: z.ZodObject<{
|
|
|
1631
1657
|
snapshot: z.ZodOptional<z.ZodObject<{
|
|
1632
1658
|
revision: z.ZodString;
|
|
1633
1659
|
graphId: z.ZodString;
|
|
1660
|
+
baseline: z.ZodOptional<z.ZodObject<{
|
|
1661
|
+
sha: z.ZodString;
|
|
1662
|
+
reason: z.ZodString;
|
|
1663
|
+
tasks: z.ZodArray<z.ZodString>;
|
|
1664
|
+
}, z.core.$strict>>;
|
|
1634
1665
|
}, z.core.$strict>>;
|
|
1635
1666
|
ownership: z.ZodObject<{
|
|
1636
1667
|
stateDir: z.ZodString;
|
|
@@ -2089,6 +2120,11 @@ export declare const cliDataSchemas: {
|
|
|
2089
2120
|
graphId: z.ZodString;
|
|
2090
2121
|
digest: z.ZodString;
|
|
2091
2122
|
resumed: z.ZodBoolean;
|
|
2123
|
+
baseline: z.ZodOptional<z.ZodObject<{
|
|
2124
|
+
sha: z.ZodString;
|
|
2125
|
+
reason: z.ZodString;
|
|
2126
|
+
tasks: z.ZodArray<z.ZodString>;
|
|
2127
|
+
}, z.core.$strict>>;
|
|
2092
2128
|
works: z.ZodArray<z.ZodObject<{
|
|
2093
2129
|
id: z.ZodString;
|
|
2094
2130
|
status: z.ZodEnum<{
|
|
@@ -4529,11 +4565,23 @@ export declare const cliDataSchemas: {
|
|
|
4529
4565
|
graphId: z.ZodString;
|
|
4530
4566
|
graphDigest: z.ZodString;
|
|
4531
4567
|
contextDigest: z.ZodString;
|
|
4568
|
+
localContext: z.ZodOptional<z.ZodArray<z.ZodObject<{
|
|
4569
|
+
id: z.ZodString;
|
|
4570
|
+
digest: z.ZodString;
|
|
4571
|
+
files: z.ZodNumber;
|
|
4572
|
+
references: z.ZodNumber;
|
|
4573
|
+
bytes: z.ZodNumber;
|
|
4574
|
+
}, z.core.$strict>>>;
|
|
4532
4575
|
revision: z.ZodString;
|
|
4533
4576
|
created: z.ZodBoolean;
|
|
4534
4577
|
eligible: z.ZodBoolean;
|
|
4535
4578
|
problems: z.ZodArray<z.ZodString>;
|
|
4536
4579
|
truncated: z.ZodArray<z.ZodString>;
|
|
4580
|
+
baseline: z.ZodOptional<z.ZodObject<{
|
|
4581
|
+
sha: z.ZodString;
|
|
4582
|
+
reason: z.ZodString;
|
|
4583
|
+
tasks: z.ZodArray<z.ZodString>;
|
|
4584
|
+
}, z.core.$strict>>;
|
|
4537
4585
|
tasks: z.ZodArray<z.ZodObject<{
|
|
4538
4586
|
identity: z.ZodString;
|
|
4539
4587
|
key: z.ZodString;
|
|
@@ -4558,6 +4606,11 @@ export declare const cliDataSchemas: {
|
|
|
4558
4606
|
snapshot: z.ZodOptional<z.ZodObject<{
|
|
4559
4607
|
revision: z.ZodString;
|
|
4560
4608
|
graphId: z.ZodString;
|
|
4609
|
+
baseline: z.ZodOptional<z.ZodObject<{
|
|
4610
|
+
sha: z.ZodString;
|
|
4611
|
+
reason: z.ZodString;
|
|
4612
|
+
tasks: z.ZodArray<z.ZodString>;
|
|
4613
|
+
}, z.core.$strict>>;
|
|
4561
4614
|
}, z.core.$strict>>;
|
|
4562
4615
|
ownership: z.ZodObject<{
|
|
4563
4616
|
stateDir: z.ZodString;
|
|
@@ -4728,6 +4781,12 @@ export declare const cliErrorSchema: z.ZodObject<{
|
|
|
4728
4781
|
message: z.ZodString;
|
|
4729
4782
|
}, z.core.$strict>>;
|
|
4730
4783
|
}, z.core.$strict>;
|
|
4784
|
+
/**
|
|
4785
|
+
* Нарушение схемы внутри harness (ответ команды вне договора, собственная
|
|
4786
|
+
* запись) — дефект, а не ошибка ввода: INTERNAL с путями полей вместо дампа
|
|
4787
|
+
* ZodError в сообщении.
|
|
4788
|
+
*/
|
|
4789
|
+
export declare const contractViolation: (error: z.ZodError) => HarnessError;
|
|
4731
4790
|
export type CliEnvelope<C extends CliCommand | 'version' = CliCommand | 'version'> = {
|
|
4732
4791
|
apiVersion: typeof API_VERSION;
|
|
4733
4792
|
command: C;
|