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.
- package/README.md +44 -2
- package/docs/architecture.md +13 -0
- 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.25.md +33 -0
- 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/ports.d.ts +17 -0
- 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/engine.js +4 -2
- package/lib/engine/prompt.js +8 -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 +34 -12
- package/lib/verification/joint.d.ts +120 -1
- package/lib/verification/joint.js +38 -1
- 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.
|
|
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,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-тестов не являются проверкой качества моделей.
|
package/docs/architecture.md
CHANGED
|
@@ -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
|
исчерпания бюджета поручения или группы отклоняется до вызова.
|
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,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, чтобы осталась одна копия.
|
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() };
|