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.
Files changed (80) hide show
  1. package/README.md +16 -2
  2. package/docs/architecture.md +59 -0
  3. package/docs/compatibility.md +25 -11
  4. package/docs/connectors.md +72 -3
  5. package/docs/contracts.md +60 -24
  6. package/docs/release-notes/0.1.0-alpha.26.md +35 -0
  7. package/docs/release-notes/0.1.0-alpha.27.md +36 -0
  8. package/docs/review-protocol.md +16 -2
  9. package/docs/toolchains.md +83 -0
  10. package/docs/upgrade.md +10 -0
  11. package/lib/agents/cli-adapter.d.ts +6 -0
  12. package/lib/agents/cli-adapter.js +12 -2
  13. package/lib/agents/review-probe.d.ts +5 -0
  14. package/lib/agents/review-probe.js +29 -9
  15. package/lib/agents/schemas.d.ts +4 -0
  16. package/lib/agents/schemas.js +3 -1
  17. package/lib/cli.js +22 -5
  18. package/lib/contracts/cli.d.ts +184 -1
  19. package/lib/contracts/cli.js +102 -2
  20. package/lib/contracts/failure.js +1 -1
  21. package/lib/contracts/policy.d.ts +30 -0
  22. package/lib/contracts/policy.js +23 -0
  23. package/lib/contracts/published.d.ts +8 -0
  24. package/lib/contracts/review.d.ts +69 -0
  25. package/lib/contracts/review.js +29 -14
  26. package/lib/contracts/work.d.ts +6 -0
  27. package/lib/contracts/work.js +13 -12
  28. package/lib/control/harness.d.ts +12 -0
  29. package/lib/control/harness.js +4 -0
  30. package/lib/control/review.js +14 -2
  31. package/lib/engine/joint-runner.js +34 -1
  32. package/lib/engine/runner.d.ts +29 -0
  33. package/lib/engine/runner.js +207 -5
  34. package/lib/engine/worktree-cleanup.d.ts +131 -0
  35. package/lib/engine/worktree-cleanup.js +520 -0
  36. package/lib/environment/bounded-read.d.ts +12 -0
  37. package/lib/environment/bounded-read.js +40 -0
  38. package/lib/environment/isolation.d.ts +1 -0
  39. package/lib/environment/isolation.js +2 -1
  40. package/lib/environment/os-tools.d.ts +4 -2
  41. package/lib/environment/os-tools.js +4 -2
  42. package/lib/environment/process.d.ts +5 -0
  43. package/lib/environment/process.js +40 -17
  44. package/lib/environment/resources.d.ts +9 -0
  45. package/lib/environment/resources.js +24 -0
  46. package/lib/index.d.ts +1 -0
  47. package/lib/index.js +1 -0
  48. package/lib/integrations/connector/commands.d.ts +37 -8
  49. package/lib/integrations/connector/commands.js +61 -8
  50. package/lib/integrations/connector/config.d.ts +37 -0
  51. package/lib/integrations/connector/config.js +37 -5
  52. package/lib/integrations/connector/delivery.js +17 -1
  53. package/lib/integrations/connector/index.d.ts +2 -2
  54. package/lib/integrations/connector/index.js +1 -1
  55. package/lib/integrations/connector/snapshot.d.ts +10 -8
  56. package/lib/integrations/connector/snapshot.js +78 -8
  57. package/lib/integrations/connector/source.d.ts +8 -2
  58. package/lib/integrations/connector/source.js +32 -6
  59. package/lib/integrations/connector/store.d.ts +1 -1
  60. package/lib/integrations/connector/store.js +11 -6
  61. package/lib/integrations/connector/summary.d.ts +6 -0
  62. package/lib/integrations/connector/summary.js +5 -0
  63. package/lib/integrations/connector/testing.js +18 -0
  64. package/lib/integrations/relay-v1/index.js +6 -4
  65. package/lib/integrations/relay-v2/protocol.js +8 -6
  66. package/lib/profiles/resolve.d.ts +6 -0
  67. package/lib/toolchains/inspect.d.ts +1 -1
  68. package/lib/toolchains/inspect.js +29 -1
  69. package/lib/toolchains/probe.d.ts +16 -0
  70. package/lib/toolchains/probe.js +20 -0
  71. package/lib/verification/confirm.d.ts +3 -1
  72. package/lib/verification/confirm.js +26 -4
  73. package/lib/verification/dependencies.d.ts +3 -0
  74. package/lib/verification/dependencies.js +11 -0
  75. package/lib/verification/dependency-store.d.ts +117 -0
  76. package/lib/verification/dependency-store.js +811 -0
  77. package/lib/verification/gates-at.js +18 -0
  78. package/lib/verification/gates.js +24 -7
  79. package/package.json +2 -2
  80. package/schemas/execution-policy.schema.json +34 -0
@@ -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, readFile, writeFile } from 'node:fs/promises';
2
+ import { mkdir, mkdtemp, rm, writeFile } from 'node:fs/promises';
3
3
  import { homedir, tmpdir } from 'node:os';
4
4
  import { join } from 'node:path';
5
+ import { OversizedFile, readBounded } from "../environment/bounded-read.js";
5
6
  import { command } from "../environment/process.js";
6
7
  import { claudeFileDenies, claudeFileTools, claudeSandbox, codexPermissions, isolation, } from "../environment/isolation.js";
7
8
  import { redactor } from "../environment/redaction.js";
@@ -9,6 +10,12 @@ import { inspectReview } from "./inspect.js";
9
10
  import { probeCallMs, probeServer, probeTool } from "./review-probe.js";
10
11
  import { claudeResult, runtimeEvents } from "./runtime-events.js";
11
12
  import { runtimeVersion, unknownUsage, usageStream } from "./usage.js";
13
+ /**
14
+ * Предел файла ответа codex: вдвое выше хвоста stdout, в котором приходит ответ
15
+ * claude (2 000 000 символов). Ответ модели на порядки меньше, а разбор
16
+ * файла на пределе занимает меньше 100 МБ кучи.
17
+ */
18
+ export const CODEX_RESULT_LIMIT = 4 * 1024 * 1024;
12
19
  /** Встроенные инструменты исполнителя claude, когда профиль их не называет; shell — в песочнице ОС. */
13
20
  export const claudeWriterTools = ['Read', 'Glob', 'Grep', 'Edit', 'Write', 'Bash'];
14
21
  const writerTools = (profile) => profile?.claudeTools ?? claudeWriterTools;
@@ -370,7 +377,7 @@ export function cliAdapter(runtime, options = {}) {
370
377
  let output;
371
378
  try {
372
379
  if (runtime === 'codex') {
373
- const cleaned = redact(await readFile(resultPath, 'utf8'));
380
+ const cleaned = redact(await readBounded(resultPath, CODEX_RESULT_LIMIT));
374
381
  await writeFile(resultPath, cleaned);
375
382
  output = JSON.parse(cleaned);
376
383
  }
@@ -386,6 +393,9 @@ export function cliAdapter(runtime, options = {}) {
386
393
  }
387
394
  }
388
395
  catch (error) {
396
+ // Непрочитанный файл не замаскирован: на диске он не остаётся.
397
+ if (error instanceof OversizedFile)
398
+ await rm(resultPath, { force: true }).catch(() => undefined);
389
399
  return {
390
400
  ...base,
391
401
  status: 'failed',
@@ -84,6 +84,11 @@ export declare const probeSpec: z.ZodObject<{
84
84
  artifacts: z.ZodOptional<z.ZodString>;
85
85
  }, z.core.$strip>;
86
86
  export type ProbeSpec = z.infer<typeof probeSpec>;
87
+ /**
88
+ * Спецификация вне пределов — отказ среды, названный controller до запуска:
89
+ * иначе сервер проверок упал бы при старте, и reviewer получил бы отказ без причины.
90
+ */
91
+ export declare function assertProbeSpec(spec: ProbeSpec): void;
87
92
  export declare const probeInput: z.ZodObject<{
88
93
  argv: z.ZodOptional<z.ZodArray<z.ZodString>>;
89
94
  gate: z.ZodOptional<z.ZodString>;
@@ -7,7 +7,7 @@ import { dirname, join, relative, resolve, sep } from 'node:path';
7
7
  import { createInterface } from 'node:readline';
8
8
  import { fileURLToPath } from 'node:url';
9
9
  import { z } from 'zod';
10
- import { idSchema, relativePathSchema, sha256, } from "../contracts/index.js";
10
+ import { idSchema, relativePathSchema, sha256, TaskFailure, } from "../contracts/index.js";
11
11
  import { osToolEnv } from "../environment/os-tools.js";
12
12
  import { redactor } from "../environment/redaction.js";
13
13
  import { completedCheck, freshnessEnv, propertyReportEnv, junitSummary, runCheck, sandboxBlockedHosts, } from "../verification/gates.js";
@@ -33,11 +33,17 @@ import { completedCheck, freshnessEnv, propertyReportEnv, junitSummary, runCheck
33
33
  */
34
34
  export const probeServer = 'devcontour_probe';
35
35
  export const probeTool = 'run_check';
36
+ /**
37
+ * Предел списков спецификации probe. Спецификацию пишет controller, но она
38
+ * читается отдельным процессом: файл, выросший сверх любой разумной политики,
39
+ * не разворачивается в ошибку на каждый элемент.
40
+ */
41
+ const PROBE_LIST_LIMIT = 10_000;
36
42
  /** Объявленный gate в виде, в каком его исполняет probe: копия из эффективной политики. */
37
43
  export const probeGate = z.strictObject({
38
44
  id: idSchema,
39
45
  kind: z.enum(['test', 'check']),
40
- command: z.array(z.string().min(1)).min(1),
46
+ command: z.array(z.string().min(1)).min(1).max(PROBE_LIST_LIMIT),
41
47
  cwd: relativePathSchema.optional(),
42
48
  timeoutMs: z.number().positive(),
43
49
  report: z.strictObject({ type: z.literal('junit'), path: relativePathSchema }).optional(),
@@ -47,22 +53,25 @@ export const probeGate = z.strictObject({
47
53
  export const probeSpec = z.object({
48
54
  cwd: z.string().min(1),
49
55
  /** Закрытое проверке и открытое на чтение — граница reviewer. */
50
- controller: z.array(z.string()),
51
- readable: z.array(z.string()),
56
+ controller: z.array(z.string()).max(PROBE_LIST_LIMIT),
57
+ readable: z.array(z.string()).max(PROBE_LIST_LIMIT),
52
58
  /** Корни рабочих деревьев вне каталога состояния (закрыты целиком). */
53
- checkouts: z.array(z.string()).optional(),
54
- isolation: z.object({ mode: z.enum(['os', 'none']), domains: z.array(z.string()) }),
59
+ checkouts: z.array(z.string()).max(PROBE_LIST_LIMIT).optional(),
60
+ isolation: z.object({
61
+ mode: z.enum(['os', 'none']),
62
+ domains: z.array(z.string()).max(PROBE_LIST_LIMIT),
63
+ }),
55
64
  commandTimeoutMs: z.number().int().min(1000),
56
65
  budgetMs: z.number().int().min(1000),
57
66
  /** Момент, к которому ревью должно быть готово дать заключение (epoch ms). */
58
67
  deadline: z.number().int(),
59
68
  /** Переменные окружения, передаваемые по имени; значения на диск не пишутся. */
60
- env: z.array(z.string()),
61
- secrets: z.array(z.string()),
69
+ env: z.array(z.string()).max(PROBE_LIST_LIMIT),
70
+ secrets: z.array(z.string()).max(PROBE_LIST_LIMIT),
62
71
  settingsDir: z.string().min(1),
63
72
  log: z.string().min(1),
64
73
  /** Объявленные gates, которые reviewer может запустить по ID. */
65
- gates: z.array(probeGate).optional(),
74
+ gates: z.array(probeGate).max(PROBE_LIST_LIMIT).optional(),
66
75
  /** Фаза и SHA ревью: записываются в каждый запуск gate. */
67
76
  phase: z.string().optional(),
68
77
  sha: z.string().optional(),
@@ -82,6 +91,17 @@ export const probeSpec = z.object({
82
91
  /** Каталог controller для отчётов и журналов запусков gate; вне проверяемого дерева. */
83
92
  artifacts: z.string().optional(),
84
93
  });
94
+ /**
95
+ * Спецификация вне пределов — отказ среды, названный controller до запуска:
96
+ * иначе сервер проверок упал бы при старте, и reviewer получил бы отказ без причины.
97
+ */
98
+ export function assertProbeSpec(spec) {
99
+ const parsed = probeSpec.safeParse(spec);
100
+ if (parsed.success)
101
+ return;
102
+ const issue = parsed.error.issues[0];
103
+ throw new TaskFailure('environment', `Спецификация проверок ревью вне схемы: ${issue?.path.join('.')}: ${issue?.message}`);
104
+ }
85
105
  export const probeInput = z
86
106
  .strictObject({
87
107
  argv: z.array(z.string().min(1)).min(1).max(64).optional(),
@@ -121,6 +121,7 @@ export declare const reviewOutputSchema: {
121
121
  };
122
122
  findings: {
123
123
  type: string;
124
+ maxItems: number;
124
125
  items: {
125
126
  type: string;
126
127
  additionalProperties: boolean;
@@ -195,6 +196,7 @@ export declare const reviewOutputSchema: {
195
196
  };
196
197
  previous: {
197
198
  type: string;
199
+ maxItems: number;
198
200
  items: {
199
201
  type: string;
200
202
  additionalProperties: boolean;
@@ -322,6 +324,7 @@ export declare const alreadySatisfiedReviewOutputSchema: {
322
324
  };
323
325
  findings: {
324
326
  type: string;
327
+ maxItems: number;
325
328
  items: {
326
329
  type: string;
327
330
  additionalProperties: boolean;
@@ -396,6 +399,7 @@ export declare const alreadySatisfiedReviewOutputSchema: {
396
399
  };
397
400
  previous: {
398
401
  type: string;
402
+ maxItems: number;
399
403
  items: {
400
404
  type: string;
401
405
  additionalProperties: boolean;
@@ -1,4 +1,4 @@
1
- import { FINDING_BASIS_PATTERN, FINDING_ID_PATTERN, findingStatuses } from "../contracts/review.js";
1
+ import { FINDING_BASIS_PATTERN, FINDING_ID_PATTERN, REVIEW_ITEMS_LIMIT, findingStatuses, } from "../contracts/review.js";
2
2
  /**
3
3
  * JSON Schema структурированного ответа для CLI runtime. Codex требует
4
4
  * закрытые объекты, где каждое свойство обязательно (необязательность —
@@ -60,6 +60,7 @@ export const reviewOutputSchema = {
60
60
  discoveries: { type: 'array', maxItems: 20, items: discovery },
61
61
  findings: {
62
62
  type: 'array',
63
+ maxItems: REVIEW_ITEMS_LIMIT,
63
64
  items: {
64
65
  type: 'object',
65
66
  additionalProperties: false,
@@ -115,6 +116,7 @@ export const reviewOutputSchema = {
115
116
  },
116
117
  previous: {
117
118
  type: 'array',
119
+ maxItems: REVIEW_ITEMS_LIMIT,
118
120
  items: {
119
121
  type: 'object',
120
122
  additionalProperties: false,
package/lib/cli.js CHANGED
@@ -3,7 +3,8 @@ import { execFileSync } from 'node:child_process';
3
3
  import { existsSync, lstatSync, readFileSync, readdirSync, writeFileSync, mkdirSync, } from 'node:fs';
4
4
  import { basename, dirname, join, resolve } from 'node:path';
5
5
  import { parseArgs } from 'node:util';
6
- import { API_VERSION, HarnessError, authorSchema, cliCommands, cliDataSchemas, contextSnapshotSchema, contractDocumentSchema, errorCodes, executionPolicySchema, exitCodeOf, exitCodes, } from "./contracts/index.js";
6
+ import { z } from 'zod';
7
+ import { API_VERSION, HarnessError, authorSchema, cliCommands, cliDataSchemas, contractViolation, contextSnapshotSchema, contractDocumentSchema, errorCodes, executionPolicySchema, exitCodeOf, exitCodes, } from "./contracts/index.js";
7
8
  import { HARNESS_VERSION } from "./package.js";
8
9
  import { validateInputs } from "./validate.js";
9
10
  import { Harness } from "./control/harness.js";
@@ -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 policyOf = v.policy ? loadPolicy(v.policy).policy : undefined;
490
- const connector = await connectorOf(need('source'), v.state ?? '.', policyOf);
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(policyOf);
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
- : new HarnessError('INTERNAL', error?.message ?? String(error));
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() };