devcontour-harness 0.1.0-alpha.35 → 0.1.0-alpha.37

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 (116) hide show
  1. package/README.md +16 -2
  2. package/docs/contracts.md +261 -33
  3. package/docs/release-notes/0.1.0-alpha.36.md +26 -0
  4. package/docs/release-notes/0.1.0-alpha.37.md +40 -0
  5. package/docs/standalone.md +20 -0
  6. package/docs/toolchains.md +57 -2
  7. package/docs/upgrade.md +108 -0
  8. package/lib/agents/schemas.d.ts +84 -2
  9. package/lib/agents/schemas.js +49 -1
  10. package/lib/cli.js +149 -1
  11. package/lib/contracts/cli.d.ts +1495 -170
  12. package/lib/contracts/cli.js +232 -2
  13. package/lib/contracts/diagnosis.d.ts +8 -4
  14. package/lib/contracts/diagnosis.js +3 -0
  15. package/lib/contracts/errors.d.ts +7 -1
  16. package/lib/contracts/errors.js +6 -0
  17. package/lib/contracts/events.d.ts +453 -60
  18. package/lib/contracts/events.js +79 -0
  19. package/lib/contracts/execution.d.ts +270 -50
  20. package/lib/contracts/execution.js +41 -0
  21. package/lib/contracts/failure.d.ts +14 -1
  22. package/lib/contracts/failure.js +9 -1
  23. package/lib/contracts/handoff.d.ts +70 -20
  24. package/lib/contracts/handoff.js +42 -1
  25. package/lib/contracts/index.d.ts +1 -0
  26. package/lib/contracts/index.js +1 -0
  27. package/lib/contracts/input-state.d.ts +13 -0
  28. package/lib/contracts/input-state.js +32 -0
  29. package/lib/contracts/input.d.ts +442 -0
  30. package/lib/contracts/input.js +321 -0
  31. package/lib/contracts/planning.d.ts +2 -0
  32. package/lib/contracts/policy.d.ts +17 -2
  33. package/lib/contracts/policy.js +31 -2
  34. package/lib/contracts/ports.d.ts +54 -0
  35. package/lib/contracts/project.d.ts +127 -0
  36. package/lib/contracts/project.js +99 -0
  37. package/lib/contracts/published.d.ts +603 -92
  38. package/lib/contracts/published.js +4 -1
  39. package/lib/contracts/repair-policy.d.ts +20 -0
  40. package/lib/contracts/repair-policy.js +34 -0
  41. package/lib/contracts/report.d.ts +53 -21
  42. package/lib/contracts/report.js +33 -2
  43. package/lib/contracts/result.d.ts +26 -24
  44. package/lib/contracts/review.d.ts +47 -8
  45. package/lib/contracts/review.js +21 -1
  46. package/lib/control/harness.d.ts +2555 -51
  47. package/lib/control/harness.js +112 -6
  48. package/lib/control/recovery.d.ts +2 -2
  49. package/lib/control/report.js +1 -0
  50. package/lib/control/status.d.ts +30 -22
  51. package/lib/control/status.js +11 -1
  52. package/lib/control/workflow.d.ts +8 -8
  53. package/lib/engine/budget.d.ts +86 -3
  54. package/lib/engine/budget.js +45 -10
  55. package/lib/engine/engine.d.ts +3091 -85
  56. package/lib/engine/engine.js +1206 -101
  57. package/lib/engine/input-policy.d.ts +68 -0
  58. package/lib/engine/input-policy.js +285 -0
  59. package/lib/engine/input-requests.d.ts +64 -0
  60. package/lib/engine/input-requests.js +187 -0
  61. package/lib/engine/measured.d.ts +6 -1
  62. package/lib/engine/measured.js +12 -1
  63. package/lib/engine/prompt.d.ts +4 -2
  64. package/lib/engine/prompt.js +3 -1
  65. package/lib/engine/property-recovery.js +2 -0
  66. package/lib/engine/repair.d.ts +2 -0
  67. package/lib/engine/repair.js +10 -3
  68. package/lib/engine/runner.d.ts +33 -4
  69. package/lib/engine/runner.js +266 -23
  70. package/lib/environment/lifecycle.d.ts +8 -0
  71. package/lib/environment/lifecycle.js +15 -2
  72. package/lib/explain/state.d.ts +16 -2
  73. package/lib/explain/state.js +254 -77
  74. package/lib/handoff/markdown.js +10 -0
  75. package/lib/handoff/pack.js +42 -1
  76. package/lib/index.d.ts +10 -0
  77. package/lib/index.js +10 -0
  78. package/lib/init/inspect.d.ts +34 -0
  79. package/lib/init/inspect.js +292 -0
  80. package/lib/init/project.js +14 -31
  81. package/lib/integrations/connector/commands.d.ts +12 -12
  82. package/lib/integrations/connector/config.d.ts +4 -4
  83. package/lib/integrations/connector/delivery.d.ts +1 -1
  84. package/lib/integrations/relay-v2/protocol.d.ts +4 -4
  85. package/lib/profiles/resolve.d.ts +2 -1
  86. package/lib/projections/enums.d.ts +1 -1
  87. package/lib/projections/enums.js +4 -0
  88. package/lib/projections/index.d.ts +1 -0
  89. package/lib/projections/index.js +1 -0
  90. package/lib/projections/input.d.ts +17 -0
  91. package/lib/projections/input.js +28 -0
  92. package/lib/projections/stop.d.ts +40 -1
  93. package/lib/projections/stop.js +87 -4
  94. package/lib/report/compute.d.ts +4 -1
  95. package/lib/report/compute.js +25 -0
  96. package/lib/report/document.js +1 -0
  97. package/lib/storage/document.d.ts +66 -28
  98. package/lib/testing/index.d.ts +1 -1
  99. package/lib/testing/index.js +1 -1
  100. package/lib/testing/store-contract.d.ts +8 -1
  101. package/lib/testing/store-contract.js +194 -1
  102. package/lib/verification/confirm.d.ts +3 -3
  103. package/lib/verification/corpus.d.ts +9 -9
  104. package/lib/verification/gates.d.ts +119 -0
  105. package/lib/verification/gates.js +311 -4
  106. package/package.json +1 -1
  107. package/schemas/execution-document.schema.json +130 -0
  108. package/schemas/execution-policy.schema.json +26 -0
  109. package/schemas/handoff-pack.schema.json +146 -4
  110. package/schemas/input-request.schema.json +665 -0
  111. package/schemas/project-facts.schema.json +393 -0
  112. package/schemas/result-envelope.schema.json +1 -0
  113. package/schemas/run-event.schema.json +625 -0
  114. package/schemas/run-result.schema.json +1 -0
  115. package/schemas/stop-diagnosis.schema.json +5 -1
  116. package/schemas/value-report.schema.json +78 -7
@@ -158,8 +158,8 @@ Isolation `os` пишет только в worktree и временный кат
158
158
  скачивает через прокси песочницы.
159
159
 
160
160
  Исполнитель и проверки ревьюера переменную `npm_config_store_dir` не получают: их окружение строится
161
- отдельно. Установка исполнителя до первого gate поэтому на seed не опирается и идёт как без
162
- хранилища.
161
+ отдельно. Зависимости в дерево исполнителя ставит controller до его работы
162
+ ([ниже](#зависимости-исполнителя)) — в окружении фазы, то есть уже с хранилищем.
163
163
 
164
164
  | Исход | Что происходит |
165
165
  | --------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
@@ -208,6 +208,61 @@ Isolation `os` пишет только в worktree и временный кат
208
208
  `dependency-store.json` в её артефактах. Другие менеджеры добавляются записью в таблице `managers`
209
209
  (`verification/dependency-store.ts`); пока поддержан только pnpm.
210
210
 
211
+ ## Зависимости исполнителя
212
+
213
+ Песочница Claude Code закрывает запись в `**/.idea` и `**/.vscode` от рабочего каталога исполнителя
214
+ без возможности снять запрет настройками, а у codex по умолчанию нет сети: установка пакетов
215
+ самим исполнителем не проходит, и до сдачи работы он не может собрать проект и запустить тесты.
216
+ Поэтому перед исполнителем controller сам исполняет в его дереве **gates установки** попытки —
217
+ обязательные gates, чей argv однозначно установка известным менеджером (`npm ci|install`,
218
+ `pnpm install|fetch`, `yarn`; скрипты, `npx` и shell не подходят), в их порядке:
219
+
220
+ - после `prepare`, хранилища зависимостей и наложения черновика прежней попытки (манифесты, которые
221
+ он меняет, ставятся сразу), до снимка защищённых путей исполнителя и его вызова. `dependsOn` gate
222
+ установки не исполняется: проверки, от которых он зависит, остаются gates кандидата. Если
223
+ установка есть ещё и в `prepare`, менеджер запустится дважды; второй раз обычно ничего не делает;
224
+ - под той же изоляцией, что и gate, при любом `isolation.mode`: в `os` — песочница проверки с
225
+ записью только в дерево, сетью `isolation.domains` и сверкой защищённых путей; в `none` — без
226
+ песочницы, так же, как исполняются сами gates (выбор `none` уже разрешает gates работать на хосте);
227
+ в окружении фазы, с `timeoutMs` gate;
228
+ - **evidence не пишется**: настоящий gate установки по-прежнему исполняется на SHA кандидата после
229
+ сдачи работы и остаётся единственным свидетельством.
230
+
231
+ Следы установки исполнителю не вменяются и в его коммит не попадают (он коммитит дерево целиком):
232
+
233
+ - каждый новый каталог `node_modules` — в корне, в пакетах workspace и внутри каталогов, уже бывших
234
+ неотслеживаемыми (например, созданных `prepare`), — скрывается от git собственным `.gitignore`, как
235
+ копия хранилища. Поиск — обход дерева без перехода по ссылкам, без спуска в `node_modules` и с
236
+ пределом в 200 000 элементов; недоделанный обход назван в квитанции (`incomplete`);
237
+ - прочие неотслеживаемые и не игнорируемые пути, которых до установки не было (сборка `dist/`,
238
+ сгенерированный код, журналы менеджера), удаляются; пустые каталоги остаются (git их не видит).
239
+ Пути, бывшие до установки, и содержимое прежних `node_modules` не трогаются; вложенный репозиторий
240
+ не удаляется и называется в `kept`;
241
+ - отслеживаемые файлы (lockfile, манифест), которые установка изменила, возвращаются к прежним байтам —
242
+ базы или наложенного черновика, — HEAD к базе; это считается отказом установки.
243
+
244
+ Заметка исполнителю при успехе: зависимости поставлены controller, установку не запускать. Фраза о
245
+ том, что lockfiles и манифесты менять нельзя, добавляется, только если все манифесты и lockfiles в
246
+ каталогах установки лежат в `protectedPaths`. Убранные пути названы числом и первыми именами. Отказ
247
+ (код выхода, сеть, timeout) попытку не роняет: исполнитель получает заметку «Dependencies were not
248
+ installed before your turn (gate "…")», в которой сводка вывода (не больше 400 символов) приведена
249
+ строкой JSON и помечена как недоверенный вывод инструмента, а не указания; стадия
250
+ `writer-dependencies` в `timings` закрывается исходом `failed`. Исключение — защищённый путь
251
+ (конфигурация IDE, shell, git или Claude), созданный или изменённый установкой: над деревом базы это
252
+ отказ среды `environment` с причиной `sandbox-policy`, над наложенным черновиком (манифесты писал
253
+ прежний исполнитель) — `scope-violation`, как у gate кандидата. Взятый кандидат прежней попытки
254
+ исполнителя не вызывает, и установки до него нет. Журналы и квитанция `writer-dependencies.json`
255
+ (`installed`, `failed`, `frozen`, `sealed`, `removed`, `removedCount`, `kept`, `incomplete`) — в
256
+ `artifacts/<попытка>/candidate/writer-dependencies/`.
257
+
258
+ Gate установки кандидата исполняется в том же дереве и переиспользует его `node_modules`, которые
259
+ исполнитель мог изменить: `pnpm install --frozen-lockfile` сверяет lockfile, но не содержимое уже
260
+ установленных пакетов. Integration исполняется в новом checkout с чистой установкой; именно она
261
+ подтверждает, что результат собирается из lockfile.
262
+
263
+ Выключить: `"writerDependencies": false` в репозитории политики. Без поля — включено, digest
264
+ политики прежний.
265
+
211
266
  ## Диагностика: doctor и preflight
212
267
 
213
268
  `harness doctor --policy policy.json` (или `--state`) добавляет `toolchains[]` — по
package/docs/upgrade.md CHANGED
@@ -529,6 +529,114 @@ null` и этого правила засчитанных попыток: ист
529
529
  остановить writers и восстановить копию каталога состояния, снятую до
530
530
  обновления, вместе с прежней версией пакета.
531
531
 
532
+ ### 0.1.0-alpha.36: зависимости исполнителя и факты проекта
533
+
534
+ Номера форматов прежние (`stateVersion: 1`, `policyVersion: 1`); без
535
+ `repositories[].writerDependencies` политика и её digest не меняются. Новое
536
+ поведение включено по умолчанию и действует при любом `isolation.mode` (при
537
+ `none` — без песочницы, как gates): перед исполнителем, после наложения
538
+ черновика прежней попытки, controller исполняет в его дереве обязательные gates
539
+ установки попытки под изоляцией gate, без evidence. Отказ — заметка
540
+ исполнителю (вывод установки — строкой JSON с пометкой «untrusted»);
541
+ защищённый путь над базой — `environment`/`sandbox-policy`, над черновиком —
542
+ `scope-violation`. Следы установки не попадают в работу исполнителя: новые
543
+ `node_modules` где угодно в дереве скрыты собственным `.gitignore`, прочие
544
+ новые неотслеживаемые пути убраны (квитанция `removed`), правка отслеживаемых
545
+ файлов откатывается. Попытка получает стадию `writer-dependencies` в
546
+ `timings`. Поле необязательно, строгая схема прежних версий его не принимает:
547
+ при откате уберите его из политики. Подробнее —
548
+ [зависимости исполнителя](toolchains.md#зависимости-исполнителя).
549
+
550
+ ### 0.1.0-alpha.37: вопросы исполнителя и диагностика многих работ
551
+
552
+ Номера форматов прежние (`stateVersion: 1`, `policyVersion: 1`, `apiVersion`
553
+ прежний); новое — аддитивно, подробности — [вопрос исполнителя](contracts.md#вопрос-исполнителя):
554
+
555
+ - **Политика.** Необязательное `inputPolicy {threshold 1–11, criticalPaths}`;
556
+ без поля политика и её digest прежние, порог — 7. В `executionDigest` поле
557
+ не входит: его смена не требует нового согласования графа и действует со
558
+ следующей попытки.
559
+ - **Ответ writer.** Необязательные `inputRequest` и `assumptions`;
560
+ wire-схема CLI runtime объявляет оба поля. `completed: true` с вопросом —
561
+ ответ вне схемы. Ответ прежнего формата читается как прежде.
562
+ - **Состояние.** Локальное пространство `input-requests` (`InputRequest`,
563
+ `schemas/input-request.schema.json`); необязательные поля попытки
564
+ `inputPolicy`, `assumptions`, `input` и `pinned.contextDigest`. Класс
565
+ отказа `needs-input`. Состояние без вопросов читается без изменений: запросов
566
+ нет, выдача и повтор прежние.
567
+ - **Коды и журнал.** `INPUT_REQUIRED` (класс `refused`, exit code 3; в
568
+ отказах `run`, `retry`, `approve`); события `input.requested`,
569
+ `input.answered`, `input.applied`, `input.closed`, `input.delivered`,
570
+ `attempt.assumptions`, `input.stale` (ID, digests и числа); типы
571
+ транзакций `input.*`. Необязательные поля запроса `stale` и `normalized`.
572
+ Причина остановки `needs-input`, действия `answer-input` и `apply-input`.
573
+ - **Проекции.** `status`: `works[].input`, `works[].followUps`; пакет передачи:
574
+ блок `inputs` и `truncated.inputs`; отчёт: блок `inputs` (только числа) и
575
+ корзина отказов `input`.
576
+ - **Порты.** Необязательный `ExecutionHost.input` (`InputHost`) для хоста,
577
+ ведущего согласование сам; `RunnerOptions.context(work, attempt)` получает
578
+ выданную попытку (снимок загружается по `attempt.pinned.contextDigest`);
579
+ `measuredInvoke` — необязательный `onStart(callId)` (доставку ответа
580
+ runner подтверждает не им, а ответом runtime, отличным от `unavailable`). Набор
581
+ `executionStoreContract` проверяет пространство `input-requests`;
582
+ `sampleInputRequest`/`answeredInputRequest` экспортированы из
583
+ `devcontour-harness/testing`.
584
+ - **CLI.** Команды `input-list`, `input-show`, `input-answer`,
585
+ `input-context`, `input-target`, `input-apply`, `input-cancel`,
586
+ `input-supersede`.
587
+ - **Хост с портом согласования.** `InputHost.review` и `activate`
588
+ получают запрос (`{id, answerDigest, mode}`); перенос ответа заменённого
589
+ запроса — `Engine.proposeCarry` и `Engine.carryInput` (`expectedVersion`,
590
+ `targetDigest`; `Harness.proposeCarry`/`carryInput`). Экспортированный
591
+ `unappliedInputs` требует `mayCarry`. `originBasis.contentDigest` —
592
+ необязательное поле запроса, `target.contentDigest` — цели; состояние
593
+ вопроса `carry-stale` (status, handoff); `cancelInput` снимает устаревший
594
+ перенесённый ответ. Не найденный закреплённый снимок держит только свою
595
+ работу (`needs-lead`, не засчитана), очередь не останавливается. Исходная остановка и
596
+ устаревание применённого ответа сравнивают постановку самой работы, а не
597
+ digest графа. Попытка с `pinned.contextDigest` отказывает, если загрузчик
598
+ контекста хоста вернул другой снимок. `implementationOutputSchema`
599
+ (wire-схема ответа writer) экспортирован корнем пакета.
600
+ - **Маскирование.** Ответ writer маскируется полным окружением вызова до
601
+ разбора: `hooks.implemented` получает уже замаскированный `output`
602
+ (`summary`, `discoveries`). Наследуемые переменные (`environment.inherit`)
603
+ маскируются, если значение не короче 8 знаков или имя похоже на секрет
604
+ (TOKEN, SECRET, PASSWORD, API_KEY, CREDENTIAL, AUTH, PRIVATE; значение от 4
605
+ знаков); объявленные `secrets` — всегда. Не маскируются только наследуемые
606
+ значения короче 8 знаков без секретного имени (`FORCE_COLOR=1`, `CI=true`):
607
+ прежде они вырезались из каждой строки вывода проверок и ответов. Короткий
608
+ секрет без секретного имени объявите в `secrets`.
609
+ - **Поведение `unfinished`.** Защищённые пути, HEAD и область записи
610
+ проверяются до решения о вопросе и незавершённости для любого ответа
611
+ writer. Прежде `completed: false` с правкой вне области получал
612
+ `unfinished` и продолжался с черновика в области; теперь это
613
+ `scope-violation` (повтор по его правилу), как у готовой реализации.
614
+
615
+ - **Диагностика многих работ.** `stopInputsOf` принимает `workIds`;
616
+ `Engine.budgetBlocksOf(workIds | undefined, view)` даёт блокировки бюджета
617
+ набора работ за одно чтение (значение равно `budgetBlockOf`). Вызов для
618
+ всей доски линеен по числу работ. Поведение прежнее.
619
+ - **Перенос и объяснение.** Снятие устаревшего перенесённого ответа хранит
620
+ запись замены в `closed.previous`; отказ до старта попытки объясняется фазой
621
+ `preflight` (`StopInput.work.preflight`).
622
+ - **Отчёт.** `report.inputs.carryStale` — новое число; `report.inputs.closed`
623
+ больше не считает вопросы с устаревшим перенесённым ответом.
624
+
625
+ Читатель со строгой схемой прежней версии `ValueReport`, `HandoffPack`,
626
+ `StopDiagnosis`, `RunEvent`, `RunResult` или ответа `status` отклонит новые
627
+ значения и поля: обновить схему вместе с пакетом. Хост с собственным
628
+ хранилищем (DevContour) хранит `input-requests` у владельца-компонента, а
629
+ адаптер прогоняет расширенный `executionStoreContract`.
630
+
631
+ **Откат.** Документ состояния разбирается строго: прежние версии отказывают
632
+ до записи на попытке с полями `inputPolicy`, `assumptions`, `input` или
633
+ `pinned.contextDigest` (их пишет каждая новая выдача) и на отказе
634
+ `needs-input`; записи `input-requests` прежняя версия не читает. Путь —
635
+ строка «Новая версия уже изменила формат» таблицы [«Откат»](#откат):
636
+ остановить writers и восстановить копию каталога состояния, снятую до
637
+ обновления, вместе с прежней версией пакета; поле `inputPolicy` убрать из
638
+ политики.
639
+
532
640
  ## Перед обновлением
533
641
 
534
642
  1. **Остановить записывающих.** Запретить новые выдачи (`harness pause`),
@@ -42,6 +42,88 @@ export declare const implementationOutputSchema: {
42
42
  required: string[];
43
43
  };
44
44
  };
45
+ inputRequest: {
46
+ type: string[];
47
+ additionalProperties: boolean;
48
+ properties: {
49
+ question: {
50
+ type: string;
51
+ };
52
+ options: {
53
+ type: string;
54
+ maxItems: 6;
55
+ items: {
56
+ type: string;
57
+ additionalProperties: boolean;
58
+ properties: {
59
+ id: {
60
+ type: string;
61
+ };
62
+ label: {
63
+ type: string;
64
+ };
65
+ consequence: {
66
+ type: string[];
67
+ };
68
+ };
69
+ required: string[];
70
+ };
71
+ };
72
+ recommended: {
73
+ type: string[];
74
+ };
75
+ severity: {
76
+ type: string;
77
+ minimum: number;
78
+ maximum: number;
79
+ };
80
+ rationale: {
81
+ type: string;
82
+ };
83
+ affects: {
84
+ type: string;
85
+ maxItems: 5;
86
+ items: {
87
+ type: string;
88
+ enum: ("acceptance" | "contract" | "product" | "api" | "migration")[];
89
+ };
90
+ };
91
+ };
92
+ required: string[];
93
+ };
94
+ assumptions: {
95
+ type: string;
96
+ maxItems: 20;
97
+ items: {
98
+ type: string;
99
+ additionalProperties: boolean;
100
+ properties: {
101
+ question: {
102
+ type: string;
103
+ };
104
+ chosen: {
105
+ type: string;
106
+ };
107
+ rationale: {
108
+ type: string;
109
+ };
110
+ severity: {
111
+ type: string;
112
+ minimum: number;
113
+ maximum: number;
114
+ };
115
+ affects: {
116
+ type: string;
117
+ maxItems: 5;
118
+ items: {
119
+ type: string;
120
+ enum: ("acceptance" | "contract" | "product" | "api" | "migration")[];
121
+ };
122
+ };
123
+ };
124
+ required: string[];
125
+ };
126
+ };
45
127
  };
46
128
  required: string[];
47
129
  };
@@ -207,7 +289,7 @@ export declare const reviewOutputSchema: {
207
289
  };
208
290
  status: {
209
291
  type: string;
210
- enum: ("open" | "closed" | "withdrawn")[];
292
+ enum: ("closed" | "open" | "withdrawn")[];
211
293
  };
212
294
  basis: {
213
295
  type: string;
@@ -410,7 +492,7 @@ export declare const alreadySatisfiedReviewOutputSchema: {
410
492
  };
411
493
  status: {
412
494
  type: string;
413
- enum: ("open" | "closed" | "withdrawn")[];
495
+ enum: ("closed" | "open" | "withdrawn")[];
414
496
  };
415
497
  basis: {
416
498
  type: string;
@@ -1,4 +1,5 @@
1
1
  import { FINDING_BASIS_PATTERN, FINDING_ID_PATTERN, REVIEW_ITEMS_LIMIT, findingStatuses, } from "../contracts/review.js";
2
+ import { INPUT_LIMITS, INPUT_SEVERITY_MAX, criticalAreas } from "../contracts/input.js";
2
3
  /**
3
4
  * JSON Schema структурированного ответа для CLI runtime. Codex требует
4
5
  * закрытые объекты, где каждое свойство обязательно (необязательность —
@@ -19,6 +20,51 @@ const discovery = {
19
20
  },
20
21
  required: ['kind', 'title', 'path', 'line', 'observation', 'consequence', 'reproduction'],
21
22
  };
23
+ const areas = {
24
+ type: 'array',
25
+ maxItems: criticalAreas.length,
26
+ items: { type: 'string', enum: [...criticalAreas] },
27
+ };
28
+ const severity = { type: 'integer', minimum: 1, maximum: INPUT_SEVERITY_MAX };
29
+ /** Вопрос исполнителя (`inputQuestionSchema`); `null` — вопроса нет. */
30
+ const inputRequest = {
31
+ type: ['object', 'null'],
32
+ additionalProperties: false,
33
+ properties: {
34
+ question: { type: 'string' },
35
+ options: {
36
+ type: 'array',
37
+ maxItems: INPUT_LIMITS.options,
38
+ items: {
39
+ type: 'object',
40
+ additionalProperties: false,
41
+ properties: {
42
+ id: { type: 'string' },
43
+ label: { type: 'string' },
44
+ consequence: { type: ['string', 'null'] },
45
+ },
46
+ required: ['id', 'label', 'consequence'],
47
+ },
48
+ },
49
+ recommended: { type: ['string', 'null'] },
50
+ severity,
51
+ rationale: { type: 'string' },
52
+ affects: areas,
53
+ },
54
+ required: ['question', 'options', 'recommended', 'severity', 'rationale', 'affects'],
55
+ };
56
+ const assumption = {
57
+ type: 'object',
58
+ additionalProperties: false,
59
+ properties: {
60
+ question: { type: 'string' },
61
+ chosen: { type: 'string' },
62
+ rationale: { type: 'string' },
63
+ severity,
64
+ affects: areas,
65
+ },
66
+ required: ['question', 'chosen', 'rationale', 'severity', 'affects'],
67
+ };
22
68
  export const implementationOutputSchema = {
23
69
  type: 'object',
24
70
  additionalProperties: false,
@@ -26,8 +72,10 @@ export const implementationOutputSchema = {
26
72
  completed: { type: 'boolean' },
27
73
  summary: { type: 'string' },
28
74
  discoveries: { type: 'array', maxItems: 20, items: discovery },
75
+ inputRequest,
76
+ assumptions: { type: 'array', maxItems: INPUT_LIMITS.assumptions, items: assumption },
29
77
  },
30
- required: ['completed', 'summary', 'discoveries'],
78
+ required: ['completed', 'summary', 'discoveries', 'inputRequest', 'assumptions'],
31
79
  };
32
80
  export const reviewOutputSchema = {
33
81
  type: 'object',
package/lib/cli.js CHANGED
@@ -4,7 +4,7 @@ import { existsSync, lstatSync, readFileSync, readdirSync, writeFileSync, mkdirS
4
4
  import { basename, dirname, join, resolve } from 'node:path';
5
5
  import { parseArgs } from 'node:util';
6
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
+ import { API_VERSION, HarnessError, authorSchema, cliCommands, cliDataSchemas, contractViolation, contextSnapshotSchema, contractDocumentSchema, digestSchema, errorCodes, executionPolicySchema, exitCodeOf, exitCodes, } from "./contracts/index.js";
8
8
  import { HARNESS_VERSION } from "./package.js";
9
9
  import { validateInputs } from "./validate.js";
10
10
  import { Harness } from "./control/harness.js";
@@ -26,6 +26,7 @@ import { collectReportInput } from "./control/report.js";
26
26
  import { writeReportFile } from "./control/report-file.js";
27
27
  import { valueReport, reportHtml, reportMarkdown } from "./report/index.js";
28
28
  import { handoffMarkdown, handoffPack } from "./handoff/index.js";
29
+ import { inputStateOf } from "./projections/input.js";
29
30
  const usage = `harness ${HARNESS_VERSION}
30
31
 
31
32
  Использование: harness <команда> [параметры]
@@ -223,6 +224,16 @@ const options = {
223
224
  format: { type: 'string' },
224
225
  'no-titles': { type: 'boolean' },
225
226
  intent: { type: 'string', multiple: true },
227
+ request: { type: 'string' },
228
+ text: { type: 'string' },
229
+ option: { type: 'string' },
230
+ kind: { type: 'string' },
231
+ actor: { type: 'string' },
232
+ 'request-version': { type: 'string' },
233
+ 'context-digest': { type: 'string' },
234
+ answer: { type: 'string' },
235
+ target: { type: 'string' },
236
+ successor: { type: 'string' },
226
237
  };
227
238
  /** Новые флаги H1 допустимы только у своих команд; прежние команды их не принимают. */
228
239
  const flagOwners = {
@@ -242,6 +253,24 @@ const flagOwners = {
242
253
  format: ['report', 'handoff'],
243
254
  'no-titles': ['report'],
244
255
  intent: ['handoff'],
256
+ request: [
257
+ 'input-show',
258
+ 'input-answer',
259
+ 'input-context',
260
+ 'input-target',
261
+ 'input-apply',
262
+ 'input-cancel',
263
+ 'input-supersede',
264
+ ],
265
+ text: ['input-answer'],
266
+ option: ['input-answer'],
267
+ kind: ['input-answer'],
268
+ actor: ['input-answer'],
269
+ 'request-version': ['input-answer', 'input-apply', 'input-cancel', 'input-supersede'],
270
+ 'context-digest': ['input-target', 'input-apply'],
271
+ answer: ['input-apply'],
272
+ target: ['input-apply'],
273
+ successor: ['input-supersede'],
245
274
  };
246
275
  /** Явное человеческое представление успешного ответа (`--human`). */
247
276
  const presenters = {
@@ -710,6 +739,125 @@ async function run(argv) {
710
739
  : undefined, b && v.state ? { baseDir: b.baseDir } : undefined),
711
740
  };
712
741
  }
742
+ case 'input-list':
743
+ case 'input-show':
744
+ case 'input-target': {
745
+ const h = open(need('state'), binding(need('state')), 'state');
746
+ try {
747
+ if (command === 'input-show')
748
+ return { command, data: h.inputRequest(need('request')) };
749
+ if (command === 'input-target') {
750
+ const { request, target, problems } = h.proposeTarget(need('request'), parseWith(digestSchema, need('context-digest'), 'context-digest'));
751
+ return {
752
+ command,
753
+ data: { requestId: request.id, ...optional('target', target), problems },
754
+ };
755
+ }
756
+ return {
757
+ command,
758
+ data: {
759
+ requests: h.inputRequests(v.work ? { workId: v.work } : {}).map((r) => ({
760
+ id: r.id,
761
+ workId: r.workId,
762
+ kind: r.kind,
763
+ blocking: r.blocking,
764
+ lifecycle: r.lifecycle,
765
+ ...optional('state', inputStateOf(r)),
766
+ severity: r.effectiveSeverity,
767
+ version: r.version,
768
+ answers: r.answers.length,
769
+ createdAt: r.createdAt,
770
+ })),
771
+ },
772
+ };
773
+ }
774
+ finally {
775
+ h.close();
776
+ }
777
+ }
778
+ case 'input-answer':
779
+ case 'input-context':
780
+ case 'input-apply':
781
+ case 'input-cancel':
782
+ case 'input-supersede': {
783
+ const b = binding(need('state'));
784
+ const h = open(need('state'), b, false);
785
+ const version = () => {
786
+ const n = Number(need('request-version'));
787
+ if (!Number.isSafeInteger(n) || n < 1)
788
+ throw new HarnessError('INVALID_INPUT', '--request-version: целое ≥ 1');
789
+ return n;
790
+ };
791
+ try {
792
+ const id = need('request');
793
+ if (command === 'input-answer') {
794
+ const kind = parseWith(z.enum(['clarification', 'requirement-change']), v.kind ?? 'clarification', 'kind');
795
+ const actor = parseWith(z.enum(['operator', 'lead']), v.actor ?? 'operator', 'actor');
796
+ return {
797
+ command,
798
+ data: h.answerInput(id, {
799
+ text: need('text'),
800
+ ...optional('optionId', v.option),
801
+ kind,
802
+ actor: { kind: actor },
803
+ }, version()),
804
+ };
805
+ }
806
+ if (command === 'input-context') {
807
+ const out = resolve(need('out'));
808
+ const { requestId, answerDigest, digest, snapshot } = h.inputContext(id);
809
+ writeFileSync(out, JSON.stringify(snapshot, null, 2) + '\n');
810
+ return { command, data: { requestId, answerDigest, digest, out } };
811
+ }
812
+ if (command === 'input-apply') {
813
+ const result = h.applyInput(id, {
814
+ answerDigest: parseWith(digestSchema, need('answer'), 'answer'),
815
+ expectedVersion: version(),
816
+ contextDigest: parseWith(digestSchema, need('context-digest'), 'context-digest'),
817
+ targetDigest: parseWith(digestSchema, need('target'), 'target'),
818
+ actor: b.policy.approvalMode,
819
+ ...(v.reset ? { reset: { reason: need('reason') } } : {}),
820
+ });
821
+ return {
822
+ command,
823
+ data: {
824
+ requestId: id,
825
+ applied: result.applied,
826
+ changed: result.changed,
827
+ lifecycle: result.request.lifecycle,
828
+ ...('work' in result && result.work
829
+ ? {
830
+ work: {
831
+ id: result.work.id,
832
+ status: result.work.status,
833
+ attempt: result.work.attempt,
834
+ },
835
+ }
836
+ : {}),
837
+ ...('active' in result && result.active ? { active: result.active } : {}),
838
+ ...('joint' in result && result.joint ? { joint: true } : {}),
839
+ ...('blocker' in result && result.blocker ? { blocker: result.blocker } : {}),
840
+ },
841
+ ...(result.applied ? {} : { code: exitCodes.refused }),
842
+ };
843
+ }
844
+ const closed = command === 'input-cancel'
845
+ ? h.cancelInput(id, { by: 'operator', reason: need('reason') }, version())
846
+ : h.supersedeInput(id, { by: 'operator', reason: need('reason'), successor: need('successor') }, version());
847
+ return {
848
+ command,
849
+ data: {
850
+ requestId: id,
851
+ lifecycle: closed.request.lifecycle,
852
+ version: closed.request.version,
853
+ changed: closed.changed,
854
+ },
855
+ };
856
+ }
857
+ finally {
858
+ h.close();
859
+ }
860
+ }
713
861
  }
714
862
  }
715
863
  const argv = process.argv.slice(2);