devcontour-harness 0.1.0-alpha.25 → 0.1.0-alpha.27
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 +16 -2
- package/docs/architecture.md +59 -0
- package/docs/compatibility.md +25 -11
- package/docs/connectors.md +72 -3
- package/docs/contracts.md +60 -24
- package/docs/release-notes/0.1.0-alpha.26.md +35 -0
- package/docs/release-notes/0.1.0-alpha.27.md +36 -0
- package/docs/review-protocol.md +16 -2
- package/docs/toolchains.md +83 -0
- package/docs/upgrade.md +10 -0
- 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 +22 -5
- package/lib/contracts/cli.d.ts +184 -1
- package/lib/contracts/cli.js +102 -2
- package/lib/contracts/failure.js +1 -1
- package/lib/contracts/policy.d.ts +30 -0
- package/lib/contracts/policy.js +23 -0
- package/lib/contracts/published.d.ts +8 -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/harness.d.ts +12 -0
- package/lib/control/harness.js +4 -0
- package/lib/control/review.js +14 -2
- package/lib/engine/joint-runner.js +34 -1
- package/lib/engine/runner.d.ts +29 -0
- package/lib/engine/runner.js +207 -5
- package/lib/engine/worktree-cleanup.d.ts +131 -0
- package/lib/engine/worktree-cleanup.js +520 -0
- package/lib/environment/bounded-read.d.ts +12 -0
- package/lib/environment/bounded-read.js +40 -0
- package/lib/environment/isolation.d.ts +1 -0
- package/lib/environment/isolation.js +2 -1
- package/lib/environment/os-tools.d.ts +4 -2
- package/lib/environment/os-tools.js +4 -2
- package/lib/environment/process.d.ts +5 -0
- package/lib/environment/process.js +40 -17
- package/lib/environment/resources.d.ts +9 -0
- package/lib/environment/resources.js +24 -0
- package/lib/index.d.ts +1 -0
- package/lib/index.js +1 -0
- package/lib/integrations/connector/commands.d.ts +37 -8
- package/lib/integrations/connector/commands.js +61 -8
- 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/store.d.ts +1 -1
- package/lib/integrations/connector/store.js +11 -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/profiles/resolve.d.ts +6 -0
- package/lib/toolchains/inspect.d.ts +1 -1
- package/lib/toolchains/inspect.js +29 -1
- package/lib/toolchains/probe.d.ts +16 -0
- package/lib/toolchains/probe.js +20 -0
- package/lib/verification/confirm.d.ts +3 -1
- package/lib/verification/confirm.js +26 -4
- package/lib/verification/dependencies.d.ts +3 -0
- package/lib/verification/dependencies.js +11 -0
- package/lib/verification/dependency-store.d.ts +117 -0
- package/lib/verification/dependency-store.js +811 -0
- package/lib/verification/gates-at.js +18 -0
- package/lib/verification/gates.js +24 -7
- package/package.json +2 -2
- package/schemas/execution-policy.schema.json +34 -0
package/docs/toolchains.md
CHANGED
|
@@ -13,6 +13,7 @@ Python/uv — отдельные toolchain. Единого «типа проек
|
|
|
13
13
|
| Каталог | `gates[].cwd`; у шага `prepare` — собственный флаг инструмента (`pnpm --dir`, `npm --prefix`, `uv --directory`, `go -C`) |
|
|
14
14
|
| Окружение | `environment` политики/репозитория (`values`, `inherit`, `secrets`) |
|
|
15
15
|
| Проверенные версии инструментов и явный выбор менеджера пакетов | `repositories[].toolchain` (`tools`, `packageManagers`), необязательно |
|
|
16
|
+
| Общие пакеты между worktree без скачивания | `repositories[].dependencyStore`, необязательно ([хранилище зависимостей](#хранилище-зависимостей)) |
|
|
16
17
|
|
|
17
18
|
`toolchain` — необязательное аддитивное поле: политики и профили без него сохраняют прежний
|
|
18
19
|
digest. `tools` — `{ "gotestsum": "1.12.3" }` (названные компоненты версии совпадают) или
|
|
@@ -114,6 +115,88 @@ Isolation `os` пишет только в worktree и временный кат
|
|
|
114
115
|
песочнице cache-каталоги (`GOCACHE`, `UV_CACHE_DIR`, store) нужно указать доступными или
|
|
115
116
|
использовать `isolation.mode: none`, как в примерах. Установка (`prepare`) идёт вне песочницы.
|
|
116
117
|
|
|
118
|
+
## Хранилище зависимостей
|
|
119
|
+
|
|
120
|
+
Свежий worktree в песочнице не видит общий store менеджера и скачивает все пакеты заново.
|
|
121
|
+
Настройка одной строкой в политике снимает это для pnpm без скрипта в проекте:
|
|
122
|
+
|
|
123
|
+
```json
|
|
124
|
+
{ "id": "app", "dependencyStore": { "manager": "pnpm" } }
|
|
125
|
+
```
|
|
126
|
+
|
|
127
|
+
Необязательные поля: `lockfile` (`pnpm-lock.yaml`), `maxBytes` (8 ГиБ), `timeoutMs` (600 000).
|
|
128
|
+
`timeoutMs` — верхний предел, общий для сборки и ожидания чужой сборки; действует ещё и треть
|
|
129
|
+
остатка времени фазы: при `runTimeoutMs` 900 000 это 300 000 мс. Проект, чьей сборке этого мало,
|
|
130
|
+
поднимает `runTimeoutMs`, иначе получает `miss`. Если остаётся меньше 30 000 мс или меньше трёх четвертей полного бюджета, когда он сам мал, сборка не начинается.
|
|
131
|
+
В `isolation.domains` должен быть реестр, например `registry.npmjs.org`: seed собирается в той же
|
|
132
|
+
песочнице, что и проверки. Другой реестр задаётся через `environment` как `npm_config_registry`;
|
|
133
|
+
`.npmrc` проекта в сборку не попадает, поэтому реестр, настроенный только там, даёт `miss`.
|
|
134
|
+
|
|
135
|
+
Проверенные версии pnpm: от 9.15.0, ниже 10.27.0. На итоговом коде настоящими прогонами проверены
|
|
136
|
+
9.15.0, 10.12.3, 10.13.1 и 10.26.0. С 10.27.0 `pnpm fetch` кладёт в store символическую ссылку
|
|
137
|
+
`v10/projects/<hash>`, а seed со ссылками отклоняется; с 11.0.0 pnpm ещё и не читает
|
|
138
|
+
`npm_config_store_dir`. Версия берётся из PATH и из поля `packageManager`; вне диапазона, а также
|
|
139
|
+
когда менеджер не найден, его версия не определена или `package.json` не читается, хранилище не меняет ни окружение, ни дерево:
|
|
140
|
+
установка идёт как без него, причина — в квитанции и предупреждении `doctor`.
|
|
141
|
+
|
|
142
|
+
Как это работает:
|
|
143
|
+
|
|
144
|
+
1. Перед `prepare` каждого checkout, а у совместной проверки — перед её gates, harness читает
|
|
145
|
+
lockfile из `targetRef`. Seed этого lockfile есть — используется, нет — собирается:
|
|
146
|
+
`pnpm fetch` в каталоге только с lockfile, поэтому `.npmrc`, `.pnpmfile.cjs` и
|
|
147
|
+
`pnpm-workspace.yaml` проекта не участвуют и его хуки не исполняются. Новый seed начинается с
|
|
148
|
+
клона предыдущего: сдвиг lockfile докачивает только разницу. Параллельные проверки ждут одну
|
|
149
|
+
сборку.
|
|
150
|
+
2. Seed клонируется в `<checkout>/.pnpm-store` (копия-при-записи на APFS и reflink-томах, иначе
|
|
151
|
+
обычная копия, если хватает места), копия сверяется с манифестом, менеджер получает путь через
|
|
152
|
+
`npm_config_store_dir`. Каталог скрыт от git собственным `.gitignore`.
|
|
153
|
+
3. Gate установки — обычный `pnpm install --frozen-lockfile`. Он берёт пакеты из копии, а чего нет,
|
|
154
|
+
скачивает через прокси песочницы.
|
|
155
|
+
|
|
156
|
+
Исполнитель и проверки ревьюера переменную `npm_config_store_dir` не получают: их окружение строится
|
|
157
|
+
отдельно. Установка исполнителя до первого gate поэтому на seed не опирается и идёт как без
|
|
158
|
+
хранилища.
|
|
159
|
+
|
|
160
|
+
| Исход | Что происходит |
|
|
161
|
+
| --------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
|
162
|
+
| Seed того же lockfile | `hit`: скачивать нечего |
|
|
163
|
+
| Lockfile checkout другой, или сборка нового seed не удалась | `partial`: установка докачивает разницу |
|
|
164
|
+
| Seed нет, сборка не удалась, не хватает места | `miss`: обычная установка; очередь не останавливается, попытка не тратится |
|
|
165
|
+
| Отказ, зависящий от самого lockfile: патчи (`patchedDependencies`, сборка видит только lockfile), пустой seed, seed сверх предела | `miss`; этот lockfile не собирается, пока не изменится |
|
|
166
|
+
| Истёк бюджет хранилища: реестр висит или чужая сборка идёт долго | `miss` или старый seed; время фазы остаётся работе, отменяет фазу только отмена попытки или оператора. Пометку об отказе ставит только сборка, начатая с полным бюджетом (не меньше трёх четвертей): опоздавшая фаза другим сборку не закрывает |
|
|
167
|
+
| Сборка не удалась недавно | 10 минут новых сборок этого lockfile нет: отказавший реестр не отнимает `timeoutMs` у каждой попытки |
|
|
168
|
+
| Seed изменён | Отказ с причиной в `refused`, seed удаляется и собирается заново |
|
|
169
|
+
| `isolation.mode: none` или `.pnpm-store` уже есть в дереве | `miss`: без границы seed не используется, в занятый путь harness не пишет |
|
|
170
|
+
|
|
171
|
+
Граница доверия:
|
|
172
|
+
|
|
173
|
+
- Seed строится только из lockfile целевой ветки. Сам harness не даёт кандидату запустить сборку или
|
|
174
|
+
выбрать её содержимое: его lockfile лишь сравнивается с seed.
|
|
175
|
+
- **Условие:** шаги `prepare` и `lifecycle` идут на хосте вне песочницы, а на integration — над слитым
|
|
176
|
+
деревом. Шаг, исполняющий код кандидата (скрипт из репозитория), работает с правами controller и
|
|
177
|
+
может изменить seed и базу закреплений. Граница seed держится только там, где эти шаги кода
|
|
178
|
+
кандидата не исполняют. `doctor` предупреждает о `dependencyStore` рядом с непустым `prepare`.
|
|
179
|
+
- Seeds лежат под корнем рабочих деревьев или в каталоге состояния, закрытых песочницей на чтение
|
|
180
|
+
и запись. Манифест закреплён digest в базе ресурсов, вне дерева seed.
|
|
181
|
+
- Проверяются байты копии, а не источника: те, что прочитает менеджер.
|
|
182
|
+
- Копия принадлежит своему checkout, в seed ничего не возвращается. Integration и следующая попытка
|
|
183
|
+
получают новую копию. Поэтому байты seed проверены всегда, а докачанные байты и всё, что
|
|
184
|
+
исполнитель изменил в своём дереве, доверены не больше, чем его `node_modules`: они не выходят
|
|
185
|
+
за пределы этого дерева.
|
|
186
|
+
|
|
187
|
+
Диск: хранятся два последних по использованию seed в пределах `maxBytes`, остальное и брошенные
|
|
188
|
+
сборки убираются при публикации нового. Seed больше предела размера или 150 000 файлов не публикуется. Копия лежит в checkout и входит в
|
|
189
|
+
сверку защищённых путей (предел 200 000 элементов), поэтому checkout, который вместе с копией превысил
|
|
190
|
+
бы 180 000 элементов, получает `miss`, а не отказ проверки. Сборка от прежнего seed, упёршаяся в предел, повторяется с пустого: основа копит старые пакеты. При любом пределе дерево и окружение остаются как без хранилища, если только прежний seed не подошёл как частичное попадание. Отказ по `maxBytes` действует, пока предел не изменён. Копии уходят вместе с
|
|
191
|
+
рабочими деревьями. Seeds лежат в `<корень>/<repo>/dependency-store`, а без корня вне дерева — в
|
|
192
|
+
`<state>/dependency-store/<repo>`; их можно удалить, когда harness не запущен, и они соберутся заново.
|
|
193
|
+
|
|
194
|
+
`doctor` предупреждает об отсутствии менеджера и lockfile, о версии вне диапазона и о непустом
|
|
195
|
+
`prepare`; это предупреждения: запуск идёт, установка обычная. Эксперимент выполнимости (`spike`)
|
|
196
|
+
хранилища не получает: у него нет `prepare`, его команду задаёт оператор. Что в итоге произошло в конкретной фазе, показывает
|
|
197
|
+
`dependency-store.json` в её артефактах. Другие менеджеры добавляются записью в таблице `managers`
|
|
198
|
+
(`verification/dependency-store.ts`); пока поддержан только pnpm.
|
|
199
|
+
|
|
117
200
|
## Диагностика: doctor и preflight
|
|
118
201
|
|
|
119
202
|
`harness doctor --policy policy.json` (или `--state`) добавляет `toolchains[]` — по
|
package/docs/upgrade.md
CHANGED
|
@@ -167,6 +167,16 @@ recovery.
|
|
|
167
167
|
отказа чтения учётных данных. Подробнее —
|
|
168
168
|
[заметки выпуска](release-notes/0.1.0-alpha.24.md).
|
|
169
169
|
|
|
170
|
+
### alpha.27: хранилище зависимостей
|
|
171
|
+
|
|
172
|
+
Форматы состояния и публичные поля API прежние; без
|
|
173
|
+
`repositories[].dependencyStore` политика и её digest не меняются. Поле
|
|
174
|
+
необязательно, строгая схема прежних версий его не принимает: при откате
|
|
175
|
+
уберите его из политики. Каталог `dependency-store` в состоянии и таблицу
|
|
176
|
+
`seed_pins` в `resources.sqlite` прежние версии не читают. Подробнее —
|
|
177
|
+
[заметки выпуска](release-notes/0.1.0-alpha.27.md) и
|
|
178
|
+
[хранилище зависимостей](toolchains.md#хранилище-зависимостей).
|
|
179
|
+
|
|
170
180
|
## Перед обновлением
|
|
171
181
|
|
|
172
182
|
1. **Остановить записывающих.** Запретить новые выдачи (`harness pause`),
|
|
@@ -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";
|
|
@@ -209,6 +210,7 @@ const options = {
|
|
|
209
210
|
basis: { type: 'string' },
|
|
210
211
|
contracts: { type: 'string' },
|
|
211
212
|
requirements: { type: 'string', multiple: true },
|
|
213
|
+
'dry-run': { type: 'boolean' },
|
|
212
214
|
};
|
|
213
215
|
/** Новые флаги H1 допустимы только у своих команд; прежние команды их не принимают. */
|
|
214
216
|
const flagOwners = {
|
|
@@ -220,6 +222,7 @@ const flagOwners = {
|
|
|
220
222
|
brief: ['plan-request', 'plan-check'],
|
|
221
223
|
contracts: ['plan-request', 'plan-check'],
|
|
222
224
|
requirements: ['plan-request'],
|
|
225
|
+
'dry-run': ['worktree-cleanup'],
|
|
223
226
|
};
|
|
224
227
|
/** Явное человеческое представление успешного ответа (`--human`). */
|
|
225
228
|
const presenters = {
|
|
@@ -335,6 +338,7 @@ async function run(argv) {
|
|
|
335
338
|
try {
|
|
336
339
|
if (connector.id !== graph.source.connector)
|
|
337
340
|
throw new HarnessError('INVALID_INPUT', `Граф из источника ${graph.source.connector}, передан источник ${connector.id}`);
|
|
341
|
+
connector.assertBaselineProtected(b.policy, b.baseDir);
|
|
338
342
|
const trusted = new Set();
|
|
339
343
|
for (const p of graph.prerequisites)
|
|
340
344
|
if (p.receipt.kind === 'trusted' && (await connector.source.trusts(p)))
|
|
@@ -479,6 +483,17 @@ async function run(argv) {
|
|
|
479
483
|
h.close();
|
|
480
484
|
}
|
|
481
485
|
}
|
|
486
|
+
case 'worktree-cleanup': {
|
|
487
|
+
const dryRun = !!v['dry-run'];
|
|
488
|
+
const h = open(need('state'), binding(need('state')), dryRun ? 'state' : false);
|
|
489
|
+
try {
|
|
490
|
+
const data = await h.cleanupWorktrees({ dryRun });
|
|
491
|
+
return { command, data, ...(data.failed ? { code: 4 } : {}) };
|
|
492
|
+
}
|
|
493
|
+
finally {
|
|
494
|
+
h.close();
|
|
495
|
+
}
|
|
496
|
+
}
|
|
482
497
|
case 'profile': {
|
|
483
498
|
const profile = resolveProfile(need('profile'), {
|
|
484
499
|
...(v.repository ? { repository: v.repository } : {}),
|
|
@@ -486,10 +501,10 @@ async function run(argv) {
|
|
|
486
501
|
return { command, data: { pin: profilePin(profile), profile } };
|
|
487
502
|
}
|
|
488
503
|
case 'source-check': {
|
|
489
|
-
const
|
|
490
|
-
const connector = await connectorOf(need('source'), v.state ?? '.',
|
|
504
|
+
const loaded = v.policy ? loadPolicy(v.policy) : undefined;
|
|
505
|
+
const connector = await connectorOf(need('source'), v.state ?? '.', loaded?.policy);
|
|
491
506
|
try {
|
|
492
|
-
const data = await connector.check(
|
|
507
|
+
const data = await connector.check(loaded?.policy, loaded?.baseDir);
|
|
493
508
|
const ok = data.connected && data.projectMatches && data.problems.length === 0;
|
|
494
509
|
return { command, data, code: ok ? exitCodes.ok : exitCodes.refused };
|
|
495
510
|
}
|
|
@@ -650,7 +665,9 @@ catch (error) {
|
|
|
650
665
|
: error instanceof TypeError &&
|
|
651
666
|
error.code?.startsWith('ERR_PARSE_ARGS')
|
|
652
667
|
? new HarnessError('INVALID_INPUT', error.message)
|
|
653
|
-
:
|
|
668
|
+
: error instanceof z.ZodError
|
|
669
|
+
? contractViolation(error)
|
|
670
|
+
: new HarnessError('INTERNAL', error?.message ?? String(error));
|
|
654
671
|
code = exitCodeOf(known);
|
|
655
672
|
const command = argv[0] && argv[0] in cliCommands ? argv[0] : null;
|
|
656
673
|
envelope = { apiVersion: API_VERSION, command, ok: false, error: known.toJSON() };
|