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

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 (129) hide show
  1. package/README.md +56 -2
  2. package/docs/architecture.md +28 -4
  3. package/docs/contracts.md +294 -51
  4. package/docs/release-notes/0.1.0-alpha.36.md +26 -0
  5. package/docs/release-notes/0.1.0-alpha.37.md +40 -0
  6. package/docs/release-notes/0.1.0-alpha.38.md +31 -0
  7. package/docs/release-notes/0.1.0-alpha.39.md +38 -0
  8. package/docs/release-notes/0.1.0-alpha.40.md +27 -0
  9. package/docs/release-notes/0.1.0-alpha.41.md +49 -0
  10. package/docs/release-notes/0.1.0-alpha.42.md +44 -0
  11. package/docs/standalone.md +20 -0
  12. package/docs/toolchains.md +57 -2
  13. package/docs/upgrade.md +240 -0
  14. package/lib/agents/review-probe.d.ts +3 -1
  15. package/lib/agents/review-probe.js +8 -4
  16. package/lib/agents/schemas.d.ts +84 -2
  17. package/lib/agents/schemas.js +49 -1
  18. package/lib/cli.js +149 -1
  19. package/lib/contracts/cli.d.ts +1495 -170
  20. package/lib/contracts/cli.js +232 -2
  21. package/lib/contracts/diagnosis.d.ts +8 -4
  22. package/lib/contracts/diagnosis.js +3 -0
  23. package/lib/contracts/errors.d.ts +7 -1
  24. package/lib/contracts/errors.js +6 -0
  25. package/lib/contracts/events.d.ts +453 -60
  26. package/lib/contracts/events.js +79 -0
  27. package/lib/contracts/execution.d.ts +270 -50
  28. package/lib/contracts/execution.js +45 -3
  29. package/lib/contracts/failure.d.ts +14 -1
  30. package/lib/contracts/failure.js +9 -1
  31. package/lib/contracts/handoff.d.ts +70 -20
  32. package/lib/contracts/handoff.js +42 -1
  33. package/lib/contracts/index.d.ts +1 -0
  34. package/lib/contracts/index.js +1 -0
  35. package/lib/contracts/input-state.d.ts +13 -0
  36. package/lib/contracts/input-state.js +32 -0
  37. package/lib/contracts/input.d.ts +442 -0
  38. package/lib/contracts/input.js +321 -0
  39. package/lib/contracts/planning.d.ts +2 -0
  40. package/lib/contracts/policy.d.ts +36 -2
  41. package/lib/contracts/policy.js +61 -2
  42. package/lib/contracts/ports.d.ts +54 -0
  43. package/lib/contracts/project.d.ts +127 -0
  44. package/lib/contracts/project.js +99 -0
  45. package/lib/contracts/published.d.ts +604 -92
  46. package/lib/contracts/published.js +4 -1
  47. package/lib/contracts/repair-policy.d.ts +20 -0
  48. package/lib/contracts/repair-policy.js +34 -0
  49. package/lib/contracts/report.d.ts +53 -21
  50. package/lib/contracts/report.js +33 -2
  51. package/lib/contracts/result.d.ts +26 -24
  52. package/lib/contracts/review.d.ts +47 -8
  53. package/lib/contracts/review.js +21 -1
  54. package/lib/control/harness.d.ts +2555 -51
  55. package/lib/control/harness.js +112 -6
  56. package/lib/control/recovery.d.ts +2 -2
  57. package/lib/control/report.js +1 -0
  58. package/lib/control/status.d.ts +30 -22
  59. package/lib/control/status.js +11 -1
  60. package/lib/control/workflow.d.ts +8 -8
  61. package/lib/engine/budget.d.ts +86 -3
  62. package/lib/engine/budget.js +45 -10
  63. package/lib/engine/engine.d.ts +3091 -85
  64. package/lib/engine/engine.js +1229 -106
  65. package/lib/engine/input-policy.d.ts +68 -0
  66. package/lib/engine/input-policy.js +285 -0
  67. package/lib/engine/input-requests.d.ts +64 -0
  68. package/lib/engine/input-requests.js +187 -0
  69. package/lib/engine/joint-runner.js +2 -2
  70. package/lib/engine/measured.d.ts +6 -1
  71. package/lib/engine/measured.js +12 -1
  72. package/lib/engine/prompt.d.ts +4 -2
  73. package/lib/engine/prompt.js +3 -1
  74. package/lib/engine/property-recovery.js +2 -0
  75. package/lib/engine/repair.d.ts +2 -0
  76. package/lib/engine/repair.js +10 -3
  77. package/lib/engine/runner.d.ts +44 -4
  78. package/lib/engine/runner.js +347 -35
  79. package/lib/environment/isolation.d.ts +41 -1
  80. package/lib/environment/isolation.js +167 -5
  81. package/lib/environment/lifecycle.d.ts +54 -2
  82. package/lib/environment/lifecycle.js +96 -4
  83. package/lib/explain/state.d.ts +16 -2
  84. package/lib/explain/state.js +254 -77
  85. package/lib/handoff/markdown.js +10 -0
  86. package/lib/handoff/pack.js +42 -1
  87. package/lib/index.d.ts +10 -0
  88. package/lib/index.js +10 -0
  89. package/lib/init/inspect.d.ts +34 -0
  90. package/lib/init/inspect.js +292 -0
  91. package/lib/init/project.js +14 -31
  92. package/lib/integrations/connector/commands.d.ts +12 -12
  93. package/lib/integrations/connector/config.d.ts +4 -4
  94. package/lib/integrations/connector/delivery.d.ts +1 -1
  95. package/lib/integrations/relay-v2/protocol.d.ts +4 -4
  96. package/lib/profiles/resolve.d.ts +2 -1
  97. package/lib/projections/enums.d.ts +1 -1
  98. package/lib/projections/enums.js +4 -0
  99. package/lib/projections/index.d.ts +1 -0
  100. package/lib/projections/index.js +1 -0
  101. package/lib/projections/input.d.ts +17 -0
  102. package/lib/projections/input.js +28 -0
  103. package/lib/projections/stop.d.ts +40 -1
  104. package/lib/projections/stop.js +87 -4
  105. package/lib/report/compute.d.ts +4 -1
  106. package/lib/report/compute.js +41 -6
  107. package/lib/report/document.js +3 -2
  108. package/lib/storage/document.d.ts +66 -28
  109. package/lib/testing/index.d.ts +1 -1
  110. package/lib/testing/index.js +1 -1
  111. package/lib/testing/store-contract.d.ts +8 -1
  112. package/lib/testing/store-contract.js +194 -1
  113. package/lib/verification/confirm.d.ts +3 -3
  114. package/lib/verification/confirm.js +6 -4
  115. package/lib/verification/corpus.d.ts +9 -9
  116. package/lib/verification/gates-at.js +3 -1
  117. package/lib/verification/gates.d.ts +154 -1
  118. package/lib/verification/gates.js +378 -11
  119. package/package.json +1 -1
  120. package/schemas/execution-document.schema.json +130 -0
  121. package/schemas/execution-policy.schema.json +31 -0
  122. package/schemas/handoff-pack.schema.json +146 -4
  123. package/schemas/input-request.schema.json +665 -0
  124. package/schemas/project-facts.schema.json +393 -0
  125. package/schemas/result-envelope.schema.json +1 -0
  126. package/schemas/run-event.schema.json +625 -0
  127. package/schemas/run-result.schema.json +1 -0
  128. package/schemas/stop-diagnosis.schema.json +5 -1
  129. package/schemas/value-report.schema.json +78 -7
package/docs/contracts.md CHANGED
@@ -97,21 +97,22 @@ manifest снимка и в необязательном поле `baseline` о
97
97
 
98
98
  ### ExecutionPolicy
99
99
 
100
- | Поле | Смысл |
101
- | ------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
102
- | `policyVersion`, `mode` | `1`; `live` или `fixture` (runtime `fixture` только в нём) |
103
- | `repositories[]` | ID, путь, `targetRef` по правилам `git check-ref-format`, `dependsOn`, gates (`test` с обязательным JUnit внутри worktree, `check`), группы gates (≤100), защищённые и генерируемые пути, среда, lifecycle, шаги подготовки, сборки зависимостей и preflight |
104
- | `workspaceGates[]`, `verificationMode`, `workspaceLifecycle` | Gates совместной проверки комбинации репозиториев; `all` или `affected`; окружение совместной проверки |
105
- | `roles{}` | `writer`, `writePaths`, своё правило `review` кода, `requiresContract` |
106
- | `review.code / plan / contract` | `{reviewer, vendor}`; reviewer задан явно |
107
- | `approvalMode` | `agent` или `operator` для технического согласования |
108
- | `isolation` | `{mode: 'os' \| 'none', domains[]}`, по умолчанию `os` |
109
- | `toolProfiles{}`, `environment`, `lifecycle`, `resources[]` | Инструменты (у профиля — встроенные инструменты claude, shell и сеть codex, MCP-серверы `mcp{}`: stdio-команда или http-адрес, только перечисленные `tools`, учётные данные — именами переменных `env`/`bearerTokenEnv`, передаются CLI по имени), среда, ресурсы (порты 1024–65535) |
110
- | `concurrency`, `leaseMs`, `runTimeoutMs`, `reviewProbes` | Пределы исполнения |
111
- | `maxAttempts`, `repairBudget`, `reuseImplementation` | Повторы и повторное использование кандидата |
112
- | `stallSweep{intervalMs, quietMs, stalledMs, action}` | Необязательное: обход зависших попыток controller ([ниже](#зависшие-попытки)); нет поля — 30 000 / 180 000 / 600 000 мс и `report`, умолчание не подставляется и digest политики не меняет |
113
- | `reviewProtocolRetries` | Необязательное: дополнительные вызовы reviewer кода при ошибке протокола ответа (0–2; нет поля — 1, умолчание не подставляется и digest политики не меняет), [review-protocol.md](review-protocol.md) |
114
- | `budgets{work, group, total, onUnknown}`, `prices[]` | Пределы USD и/или времени; тарифы |
100
+ | Поле | Смысл |
101
+ | ------------------------------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
102
+ | `policyVersion`, `mode` | `1`; `live` или `fixture` (runtime `fixture` только в нём) |
103
+ | `repositories[]` | ID, путь, `targetRef` по правилам `git check-ref-format`, `dependsOn`, gates (`test` с обязательным JUnit внутри worktree, `check`), группы gates (≤100), защищённые и генерируемые пути, среда, lifecycle, шаги подготовки, сборки зависимостей и preflight |
104
+ | `workspaceGates[]`, `verificationMode`, `workspaceLifecycle` | Gates совместной проверки комбинации репозиториев; `all` или `affected`; окружение совместной проверки |
105
+ | `roles{}` | `writer`, `writePaths`, своё правило `review` кода, `requiresContract` |
106
+ | `review.code / plan / contract` | `{reviewer, vendor}`; reviewer задан явно |
107
+ | `approvalMode` | `agent` или `operator` для технического согласования |
108
+ | `isolation` | `{mode: 'os' \| 'none', domains[]}`, по умолчанию `os` |
109
+ | `toolProfiles{}`, `environment`, `lifecycle`, `resources[]` | Инструменты (у профиля — встроенные инструменты claude, shell и сеть codex, MCP-серверы `mcp{}`: stdio-команда или http-адрес, только перечисленные `tools`, учётные данные — именами переменных `env`/`bearerTokenEnv`, передаются CLI по имени), среда, ресурсы (порты 1024–65535) |
110
+ | `concurrency`, `leaseMs`, `runTimeoutMs`, `reviewProbes` | Пределы исполнения |
111
+ | `maxAttempts`, `repairBudget`, `reuseImplementation` | Повторы и повторное использование кандидата |
112
+ | `stallSweep{intervalMs, quietMs, stalledMs, action}` | Необязательное: обход зависших попыток controller ([ниже](#зависшие-попытки)); нет поля — 30 000 / 180 000 / 600 000 мс и `report`, умолчание не подставляется и digest политики не меняет |
113
+ | `reviewProtocolRetries` | Необязательное: дополнительные вызовы reviewer кода при ошибке протокола ответа (0–2; нет поля — 1, умолчание не подставляется и digest политики не меняет), [review-protocol.md](review-protocol.md) |
114
+ | `gateTimeoutFloorMs` | Необязательное: нижняя граница предела времени каждого исполнения gate, мс (1000–600 000). Действующий предел — `max(gate.timeoutMs, gateTimeoutFloorMs)` на всех фазах (кандидат, интеграция, потребители, совместная проверка, проверки reviewer); объявленный `timeoutMs` в политике не меняется. Отказ по пределу называет действующий предел в секундах и объявленный, если его подняла граница. Граница не больше `runTimeoutMs`, иначе политика отклоняется. Нет поля — объявленный предел; умолчание не подставляется и digest политики не меняет. `timeoutMs` gate — защита от зависания, а не предел производительности: бюджеты производительности проверяются внутри самой проверки |
115
+ | `budgets{work, group, total, onUnknown}`, `prices[]` | Пределы USD и/или времени; тарифы |
115
116
 
116
117
  Переменные `HARNESS_*` и `DEVCONTOUR_*` политика задать не может.
117
118
 
@@ -125,6 +126,11 @@ manifest снимка и в необязательном поле `baseline` о
125
126
  gate установки остаётся обычным `pnpm install --frozen-lockfile`.
126
127
  Подробности и граница доверия — [toolchains](toolchains.md#хранилище-зависимостей).
127
128
 
129
+ `repositories[].writerDependencies` — необязательное: `false` выключает установку зависимостей
130
+ в дереве исполнителя до его работы (gates установки попытки под изоляцией gate, без evidence,
131
+ стадия `writer-dependencies` в `timings`). Нет поля — включено, умолчание не подставляется и
132
+ digest политики не меняет. Подробно — [toolchains](toolchains.md#зависимости-исполнителя).
133
+
128
134
  Квитанция `dependency-store.json` лежит в артефактах фазы: `outcome`
129
135
  (`hit` — lockfile checkout равен lockfile seed; `partial` — seed другого
130
136
  lockfile, установка докачивает разницу; `miss` — обычная установка), `seed`,
@@ -704,6 +710,203 @@ fencing; само состояние между переходами не пер
704
710
  переиспользуется (`reusableFailures`). Причина `attempt.diagnosed` — `none`,
705
711
  `counted: true`.
706
712
 
713
+ ### Вопрос исполнителя
714
+
715
+ Writer, которому для продолжения нужно решение человека или ведущего,
716
+ отвечает `completed: false` и вопросом `inputRequest` (`inputQuestionSchema`:
717
+ текст до 1500 знаков, до шести вариантов с последствием, рекомендуемый
718
+ вариант, самооценка серьёзности 1–10, основание, затронутые критические
719
+ области `contract | acceptance | product | api | migration`). Развилки,
720
+ которые он решил сам, — `assumptions[]` (вопрос, выбор, основание,
721
+ серьёзность, области; до 20). `completed: true` вместе с вопросом невалиден.
722
+ Поля необязательны: ответ прежнего формата — ответ без вопроса и допущений.
723
+ Wire-схема CLI runtime объявляет оба поля (`inputRequest` — объект или
724
+ `null`).
725
+
726
+ **Политика вопросов** — `ExecutionPolicy.inputPolicy`
727
+ (`{threshold: 1–11, criticalPaths: []}`; нет поля — порог 7 без критических
728
+ путей, умолчание в политику не подставляется). Порог закрепляется в попытке
729
+ при выдаче (`AttemptState.inputPolicy`) и в `executionDigest` не входит: смена
730
+ порога действует со следующей попытки без нового согласования. Порог и шкала
731
+ называются в запросе writer. Действующая серьёзность — самооценка, поднятая
732
+ до 10 минимумами, которые модель понизить не может: вопрос или допущение
733
+ называет критическую область или сам оценён потолком 10 (`declared`) либо попытка изменила путь из
734
+ `criticalPaths` (`critical-path`).
735
+
736
+ Исход ответа writer (`evaluateInput`) — после проверок защищённых путей,
737
+ HEAD и области записи: нарушение области остаётся `scope-violation` и не
738
+ прячется за вопрос.
739
+
740
+ | Ответ | Исход |
741
+ | ------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------- |
742
+ | `completed: false`, вопрос не ниже порога | `needs-input`: попытка не засчитана, черновик — `AttemptState.partial`, запрос `pending` в той же транзакции, что отказ |
743
+ | `completed: false`, вопрос ниже порога | `unfinished` (нарушение запроса); вопрос записан отклонённым (`cancelled`, `closed.by: controller`) и работу не держит |
744
+ | `completed: false` без вопроса | `unfinished`, как прежде |
745
+ | `completed: true`, допущение не ниже порога | `needs-input` без кандидата: самое серьёзное допущение становится вопросом (вариант `chosen` — выбор исполнителя) |
746
+ | `completed: true`, допущения ниже порога | Допущения пишутся в попытку (`AttemptState.assumptions`), запрос reviewer их перечисляет; работа идёт дальше |
747
+ | Порог 11 (автономный режим) | Остановок нет; все допущения записаны; критические — неблокирующие запросы ведущему (`kind: follow-up`); согласованное состояние не меняется |
748
+
749
+ `needs-input` — класс отказа без автоматического повтора
750
+ (`repairPolicy['needs-input']`: `stop`, выдачу не останавливает), корзина
751
+ отчёта `input`, код остановки `INPUT_REQUIRED` (класс `refused`). Остановка
752
+ вопросом возвращает попытку в предел `maxAttempts` и не тратит предел
753
+ незасчитанных отказов: ответ на вопрос последней попытки применяется без
754
+ сброса. Возврат ограничен: поручение получает не больше `maxAttempts`
755
+ остановок вопросом, возвращающих попытку, за всю жизнь (счёт — по записям
756
+ попыток с `failureKind: needs-input`, кроме прерванных остановкой
757
+ controller; сброс попыток его не обнуляет). Следующая остановка вопросом
758
+ засчитывается как обычная попытка (`counted: true`), поэтому цикл «вопрос →
759
+ ответ → применение» и обход вопроса отменой с повтором кончаются
760
+ исчерпанием попыток, даже если отвечает модель. Остановка, вернувшая
761
+ попытку, и её продолжение имеют один номер попытки; различает их
762
+ `failureKind: needs-input` записи и `counted` в `attempt.diagnosed`.
763
+
764
+ **Канонический запрос** (`InputRequest`, `schemas/input-request.schema.json`)
765
+ хранится в локальном пространстве `input-requests` у владельца — репозитория
766
+ поручения. ID (`IR-<24 hex>`) выдаёт controller детерминированно от попытки.
767
+ Вопрос и основание исходной попытки (`originBasis`: источник, digests графа,
768
+ постановки, политики, снимок контекста или `null`, база, закреплённая
769
+ `inputPolicy`) неизменяемы; ответы (`answers[]`, до 20) только дополняются;
770
+ `version` — CAS записи. Эти правила проверяет движок (записи — только через
771
+ его операции); от хранилища договор (`executionStoreContract`) требует хранить
772
+ запись целиком и отдавать её в списке без владельца с `owner` и `key`.
773
+ Жизненный цикл: `pending → answered → applied`,
774
+ альтернативные окончания — `cancelled` и `superseded` (с `successor`).
775
+
776
+ **Блокировка.** Блокирующий запрос в `pending` или `answered` сам держит
777
+ работу: claim его не выдаёт (и после новой редакции графа с согласованием),
778
+ `retry` — в том числе со сбросом — отказывает `INPUT_REQUIRED`, `repairDecision`
779
+ такую работу не чинит и не останавливает ею восстановление группы, приёмка
780
+ (`finish`) отказывает. `WorkState.hold` не занимается: снятие чужого
781
+ удержания ожидание ответа не обходит. Отмена работы закрывает её открытые
782
+ запросы.
783
+
784
+ **Продолжение.**
785
+
786
+ 1. `answerInput(id, {text, optionId?, kind, actor, messageRef?},
787
+ expectedVersion)` — новая версия ответа с `answerDigest`; работу ответ не
788
+ возобновляет. Тот же текст, вариант и вид — прежний ответ без записи.
789
+ `kind: requirement-change` — изменение требований: старый запрос
790
+ заменяется (`supersedeInput`) ссылкой на новую ревизию, а не
791
+ продолжается.
792
+ 2. `Harness.inputContext(id, {messages?})` — неизменяемый снимок: действующий
793
+ снимок графа и источник `input-answer` (`inputContextSource`): файл
794
+ `input/<id>.md` (вопрос, варианты, ответ) и справка
795
+ `input/<id>.manifest.json` (`{requestId, answerDigest, revision,
796
+ messages[{id, revision, digest}]}`). Версия ответа — в `version`
797
+ источника (`r<N>`), не в `revision`. Снимок хранится по digest, но не
798
+ активируется.
799
+ 3. Ревью этого снимка — обычный `review-plan --context`. Согласование им не
800
+ меняется: попытки графа сохраняют своё. `approve` со снимком, где ответ не
801
+ применён, — `INPUT_REQUIRED`; `run` с таким снимком отказывает тем же кодом
802
+ до вызова модели.
803
+ 4. `proposeTarget(id, contextDigest)` — основание продолжения (только чтение)
804
+ и причины, по которым применение сейчас откажет.
805
+ 5. `applyInput(id, {answerDigest, expectedVersion, contextDigest,
806
+ targetDigest, actor, reset?})` — одна транзакция: точная версия запроса и
807
+ последний ответ, вид `clarification`, работа всё ещё в исходной остановке
808
+ (последняя попытка — попытка вопроса), неизменные граф и постановка,
809
+ политика процесса применена, снимок несёт ровно этот ответ (manifest),
810
+ проверки `approve` (`approvalCheck`: раунд ревью этого снимка, в режиме
811
+ `agent` одобренный, актёр — режим политики) и пересчитанное основание
812
+ совпадает с `targetDigest`. Затем — активация согласования снимка, запрос
813
+ `applied` с `target` и обычный повтор (`retryIn`: те же правила, без
814
+ сброса, если сброс не назван). Модель не вызывается; пауза оператора и
815
+ чужие удержания остаются. Идут попытки графа или совместная проверка —
816
+ `{applied: false, active}`, запрос и согласование не меняются; исчерпаны попытки или бюджет —
817
+ `{applied: false, blocker}`, запрос остаётся `answered`. Повтор того же
818
+ применения — `{applied: true, changed: false}`.
819
+ 6. Claim закрепляет действующий снимок (`pinned.contextDigest`) и связывает
820
+ ответ с попыткой (`AttemptState.input`) только при совпадении применённого
821
+ основания с основанием выдачи. Runner загружает снимок по закреплению:
822
+ writer и оба reviewer видят одни и те же байты. «Передано исполнителю»
823
+ (`delivered`, событие `input.delivered`) — только по началу вызова writer
824
+ этой попытки, один раз, под fencing; apply и claim доставку не
825
+ подтверждают.
826
+
827
+ **Исходная остановка** держится, пока работа на попытке вопроса
828
+ (остановлена `needs-input` или готова после устаревшего применения) и её
829
+ собственная постановка прежняя — по содержанию без ревизии источника
830
+ (`originBasis.contentDigest`, у цели — `target.contentDigest`): пересинхронизация
831
+ трекера одной ревизией ни остановку, ни применённый ответ не обесценивает. Граф целиком не
832
+ сравнивается: согласование или добавление другой работы того же графа (у
833
+ DevContour граф — активная ревизия доски) остановку и применённый ответ не
834
+ обесценивает.
835
+
836
+ **Устаревшее применение.** Если до выдачи попытки с ответом сменились
837
+ постановка работы, политика или действующий снимок (новый снимок не несёт
838
+ этот ответ), транзакция claim возвращает запрос в `answered` с причиной
839
+ (`stale.reason`: `order | policy | context`, событие `input.stale`; значение
840
+ `graph` больше не ставится): работа не выдаётся без ответа и ждёт нового
841
+ снимка, ревью и `applyInput` (готовая работа на исходной попытке применяется
842
+ так же, как остановленная). Снимок, который несёт тот же ответ (например, с
843
+ ответом на второй вопрос графа), основание не обесценивает.
844
+
845
+ **Новая редакция постановки.** Если постановка самой работы изменилась,
846
+ продолжение исходной остановки невозможно (`applyInput` и `proposeTarget`
847
+ называют выход). Выход с сохранением ответа: `supersedeInput` (преемник —
848
+ новая редакция работы), затем `inputContext` (принимает заменённый вопрос с
849
+ ответом), `review-plan` со снимком и перенос: `carryInput(id, {contextDigest,
850
+ actor})` — одна транзакция с правилом переноса, отсутствием неприменённых
851
+ ответов в снимке, барьером политики, ревью и актёром по правилам хоста
852
+ (`InputHost.review`) или `approvalRules`, без идущих попыток графа
853
+ (`{carried: false, active}`), пределами попыток и бюджета до активации
854
+ (`{carried: false, blocker}`), активацией (`InputHost.activate` с `mode:
855
+ 'carry'` или согласование графа), записью цели в заменённый запрос и обычным
856
+ повтором работы, остановленной вопросом (иной отказ остаётся по своим
857
+ правилам). Перенесённый ответ связывается с попыткой при выдаче и
858
+ подтверждается вызовом writer, как применённый; если до выдачи согласование
859
+ ушло на снимок без него, цель снимается, `stale` записывается (состояние
860
+ `carry-stale`), и работа ждёт: выходы — новый перенос или снять перенесённый
861
+ ответ (`cancelInput`), тогда работа продолжится без него; запись замены
862
+ (преемник, `carry`, причина) остаётся в `closed.previous`. Изменение требований сравнивается по содержанию постановки
863
+ без ревизии источника (`originBasis.contentDigest`). Экспортированный
864
+ `unappliedInputs` требует правило переноса движка (`mayCarry`, проще —
865
+ `Engine.unappliedInputs`). У standalone тот же снимок можно согласовать и
866
+ обычным `approve`/`run`. Перенос решается в момент переноса
867
+ (`Engine.carryAllowed`), а не замены: уточнение — когда исходная остановка
868
+ уже не держится, изменение требований — только когда изменилась постановка
869
+ самой работы; только последняя версия ответа. Порядок «замена, затем новая
870
+ редакция» тоже ведёт к переносу; `closed.carry` — сведение о моменте замены.
871
+ Пока остановка держится, продолжение — только `applyInput`. Снимок с новым
872
+ ответом не становится действующим и через `approve`/`run`, пока в графе идут
873
+ попытки (`NOT_READY`; `run` отказывает до ревью). `inputContext` отказывает
874
+ для неблокирующих и закрытых без замены запросов.
875
+
876
+ **Закреплённый снимок.** У попытки с `pinned.contextDigest` записанный
877
+ снимок контекста обязан совпасть с закреплённым — при записи контекста
878
+ runner и при приёмке (`APPROVAL_STALE`): загрузчик хоста, не учитывающий
879
+ закрепление, отказывает до вызова writer; не найденный закреплённый снимок —
880
+ отказ этой работы при загрузке (`needs-lead`, причина `preflight`, попытка не
881
+ засчитана, очередь не останавливается; explain — фаза `preflight` и неполные
882
+ входы работы, `StopInput.work.preflight`). `InputHost.contextDigestOf`:
883
+ `null` — снимок «без контекста» (загрузчик обязан вернуть пусто),
884
+ `undefined` — хост не связывает согласование с контекстом (проверки нет).
885
+
886
+ **Вопрос вне схемы.** Пределы вопроса называются в запросе writer; схема
887
+ договора строгая. Ответ вне схемы, в котором есть вопрос, controller приводит
888
+ к схеме (усекает текст, исправляет ID вариантов, оставляет шесть вариантов,
889
+ ограничивает серьёзность) и решает как обычно; что исправлено — в поле запроса
890
+ `normalized`. Ответ вне схемы без вопроса — отказ, как прежде. Вопрос и
891
+ допущения маскируются полным окружением вызова до записи; решения взятого
892
+ кандидата переоцениваются по политике новой попытки, решения продолжаемого
893
+ черновика видят writer и reviewer.
894
+
895
+ События `input.requested`, `input.answered`, `input.applied`,
896
+ `input.closed`, `input.delivered` и `attempt.assumptions` несут ID, digests и
897
+ числа — без текста вопросов, ответов и допущений.
898
+
899
+ **Проекции.** `status`: у поручения `input {requestId, state, version,
900
+ severity}` (`awaiting-answer | answered-not-applied | applied-awaiting-claim
901
+ | delivered`) и число неблокирующих запросов `followUps`. `explain`:
902
+ ожидание ответа — человек, `answer-input`; ответ без применения — ведущий,
903
+ `apply-input` с причиной, по которой применение сейчас откажет; сообщение
904
+ называет усечённый вопрос, варианты, версию и digest ответа, число решений
905
+ исполнителя; неблокирующие запросы — отдельные диагнозы ведущего. Пакет
906
+ передачи — блок `inputs` (усечённый вопрос, варианты, версия, digest и
907
+ начало ответа до 500 знаков, digests основания). Отчёт — только числа
908
+ (`inputs`): ответ целиком в отчёт не попадает.
909
+
707
910
  ### RunEvent
708
911
 
709
912
  `{apiVersion, seq, at, type, graphId?, workId?, runId?, attempt?, payload}`.
@@ -765,9 +968,12 @@ hadAttempt}`. `engine.cancel(workId, reason?, by?)` (CLI `cancel` — `operator`
765
968
  отказ не окружения. Хост, вызывающий `engine.fail`, может передать
766
969
  `options.cause`; движок приводит её к классу (у отказа не окружения — всегда
767
970
  `none`). `counted` — отказ засчитан в предел попыток (`maxAttempts`): не
768
- засчитаны отказы до работы (`blocked`), окружения и провайдера, истёкшее
769
- владение и прерывание остановкой; зависание (`stalled`) засчитано. Отчёт
770
- считает попытки засчитанными по тому же правилу. Отказ до работы с классом
971
+ засчитаны отказы до работы (`blocked`), окружения и провайдера, остановка
972
+ вопросом (`needs-input`) в пределах своего предела, истёкшее владение и
973
+ прерывание остановкой;
974
+ зависание (`stalled`) засчитано. Отчёт
975
+ считает попытки засчитанными по тому же правилу; остановку вопросом — по
976
+ `counted` её `attempt.diagnosed` (без события — засчитана). Отказ до работы с классом
771
977
  не окружения получает причину `preflight`. Текста отказа в событии
772
978
  нет.
773
979
 
@@ -1073,6 +1279,34 @@ Markdown хост учитывает, уменьшая `maxBytes`. Маску и
1073
1279
  своих значений хост составляет из `policySecrets(policy, env?)`,
1074
1280
  `redactor` и `composeRedactors` корня пакета.
1075
1281
 
1282
+ **Диагноз по состоянию.** `stopInputsOf(source, { maxAttempts,
1283
+ repairBudget, workId?, workIds? })` из корня пакета (источник тот же —
1284
+ `StopSource`) даёт входы `explainStop` за одно чтение. Без выбора — доска:
1285
+ отменённая работа, которую никто не ждёт, в неё не входит. `workId` — одна
1286
+ работа (её показывает и отменённую). `workIds` — набор: входы каждой работы
1287
+ те же, что у вызова с её `workId` (в том числе отменённой без ждущих), в
1288
+ порядке состояния независимо от порядка в запросе; вход роли controller —
1289
+ первым, запросы ведущему — после работ. Неизвестная работа — `NOT_FOUND`,
1290
+ `workId` вместе с `workIds` — `INVALID_INPUT`, пустой набор — без работ.
1291
+ Общее для работ (прогноз групп, обратные зависимости, запросы, попытки,
1292
+ записи вызовов, статусы бюджетов) читается один раз за вызов: набор и доска
1293
+ линейны по числу работ. Порты хоста по-прежнему спрашиваются о каждой
1294
+ работе: `basis.orderDigest`, `guards.claimable`, `budgets.groupOf` при
1295
+ пределе группы и `budgets.members` для прежних записей вызовов без
1296
+ закреплённой группы (`subjectId` без `groupId`, которые не закрепил
1297
+ `pinLegacyCalls`). Бюджетные блоки многих работ хост получает из
1298
+ `Engine.budgetBlocksOf(workIds | undefined, view)`: за одно чтение, для
1299
+ набора или (без `workIds`) всех работ вида — `Map` работа → причина или
1300
+ `undefined`, по каждой то же, что `budgetBlockOf(workId, view)` на момент
1301
+ вызова. `budgetBlockOf(workId, view, records?)` принимает уже прочитанные
1302
+ записи вызовов, `repairDecision(view, works, { budgetLeft, maxAttempts,
1303
+ blocking? })` — вопрос, держащий работу (по умолчанию `blockingRequest`).
1304
+ `Engine.budgetBlockers(view)` и `Engine.approvalStaleness(view)` —
1305
+ внутренние помощники диагноза: функция, которую они возвращают, считает
1306
+ общее один раз на момент создания (`at` бюджетов фиксирован) и верна
1307
+ только внутри того же чтения; хост их не держит между чтениями и
1308
+ пользуется `budgetBlocksOf` и `stopInputsOf`.
1309
+
1076
1310
  Весь пакет — один снимок хранилища: `handoffPack` выполняет status,
1077
1311
  диагнозы и чтение заданий графов внутри одного `read`
1078
1312
  (`SqliteExecutionStore.read` вложенным чтением использует снимок внешнего,
@@ -1090,6 +1324,7 @@ controller — `next` «ждать до `leaseUntil` или проверить
1090
1324
  | `HostGuards` | `claimable`, `claimBarrier`, `current`, `beforeAccept` — дополнительные запреты хоста в той же транзакции; необязательный `busy(view)` — работы хоста (поставка, preview), которых применение новой политики дожидается так же, как попыток; необязательный `joint(verification, view, kind)` — продуктовые условия совместной проверки в каждой её записи, кроме продления срока |
1091
1325
  | `ContractApprovals` (необязательный `ExecutionHost.contracts`) | `approved({id, digest}, view)` — хост, ведущий согласование контрактов сам, подтверждает редакцию этого digest (`null`) или называет причину; без порта согласованием служит одобренный последний раунд технического ревью этого digest при текущем назначении reviewer. Записи ревью из сведений хоста не создаются |
1092
1326
  | `ExecutionHost.readyAt` (необязательный) | `readyAt(work, view)` — когда поручение стало готово к выдаче (согласовано и дождалось зависимостей) по сведениям хоста; движок пишет его в `wait.readyAt` новой попытки в транзакции выдачи. Нет порта или `undefined` — время неизвестно и не выдумывается |
1327
+ | `InputHost` (необязательный `ExecutionHost.input`) | Продолжение после ответа у хоста, который ведёт согласование сам: `contextDigestOf(work, view)` — действующий снимок, который claim закрепит; `review(work, contextDigest, actor, view, request)` — раунд ревью цели по правилам хоста или отказ; `activate(tx, work, target, request)` — активация цели в транзакции `applyInput` или `carryInput` (`request`: `{id, answerDigest, mode: apply \| carry}`); необязательный `snapshot(digest, view)` — снимок для сверки manifest ответа. Без порта — `graph.approval` и раунды ревью плана |
1093
1328
  | `BudgetScopes` | Группа поручения, её состав, атрибуция прежних записей вызовов |
1094
1329
  | `RuntimeAdapter` | `capabilities()`, `invoke(request, signal)`: сессия `fresh` для reviewer и planner (`continue` — только writer той же попытки), JSON Schema ответа, сообщённая модель и версия runtime, usage, диагностика, отмена дерева процессов; необязательный `probe` — сервер проверок reviewer кода (команда, имена переменных окружения, предел команды), адаптер подключает его как MCP-сервер `devcontour_probe` |
1095
1330
  | `WorkSource` | `fetch(ref)` с редакцией; `revision(ref)`; `trusts(prerequisite)`, по умолчанию нет |
@@ -1164,12 +1399,12 @@ subjects)`: `subjects.input(kind, id, view)` задаёт digest входа и
1164
1399
  `HarnessError {code, class, message, issues[{path, message}]}`; класс задаёт
1165
1400
  exit code CLI.
1166
1401
 
1167
- | Exit | Класс | Коды |
1168
- | ---- | ---------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
1169
- | 0 | успех | — |
1170
- | 2 | `input` | `INVALID_INPUT`, `UNSUPPORTED_COMMAND`, `UNSUPPORTED_VERSION`, `GRAPH_*`, `GATE_*`, `REVIEWER_*`, `RESPONSE_TOO_LARGE` |
1171
- | 3 | `refused` | `APPROVAL_STALE`, `APPROVAL_REQUIRED`, `LEASE_STALE`, `CONTROLLER_BUSY`, `PAUSED`, `NOT_READY`, `SCOPE_VIOLATION`, `GATE_FAILED`, `REVIEW_REJECTED`, `BUDGET_EXHAUSTED`, `BUDGET_UNKNOWN`, `ATTEMPTS_EXHAUSTED`, `CONTEXT_EXHAUSTED`, `REVISION_CONFLICT`, `CANCELLED`, `NOT_FOUND`, `PATH_CONFLICT` |
1172
- | 4 | `infrastructure` | `STATE_VERSION_UNSUPPORTED`, `RUNTIME_UNAVAILABLE`, `REVIEW_PROTOCOL_INVALID`, `SANDBOX_UNAVAILABLE`, `GIT_FAILED`, `STORAGE_FAILED`, `DELIVERY_FAILED`, `INTERNAL` |
1402
+ | Exit | Класс | Коды |
1403
+ | ---- | ---------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
1404
+ | 0 | успех | — |
1405
+ | 2 | `input` | `INVALID_INPUT`, `UNSUPPORTED_COMMAND`, `UNSUPPORTED_VERSION`, `GRAPH_*`, `GATE_*`, `REVIEWER_*`, `RESPONSE_TOO_LARGE` |
1406
+ | 3 | `refused` | `APPROVAL_STALE`, `APPROVAL_REQUIRED`, `LEASE_STALE`, `CONTROLLER_BUSY`, `PAUSED`, `NOT_READY`, `SCOPE_VIOLATION`, `GATE_FAILED`, `REVIEW_REJECTED`, `BUDGET_EXHAUSTED`, `BUDGET_UNKNOWN`, `ATTEMPTS_EXHAUSTED`, `CONTEXT_EXHAUSTED`, `INPUT_REQUIRED`, `REVISION_CONFLICT`, `CANCELLED`, `NOT_FOUND`, `PATH_CONFLICT` |
1407
+ | 4 | `infrastructure` | `STATE_VERSION_UNSUPPORTED`, `RUNTIME_UNAVAILABLE`, `REVIEW_PROTOCOL_INVALID`, `SANDBOX_UNAVAILABLE`, `GIT_FAILED`, `STORAGE_FAILED`, `DELIVERY_FAILED`, `INTERNAL` |
1173
1408
 
1174
1409
  Exit 1 не используется: им Node завершает процесс при необработанном
1175
1410
  исключении.
@@ -1213,33 +1448,41 @@ stdout — один JSON `CliEnvelope`: `{apiVersion, command, ok: true, data}`
1213
1448
  читающие на отсутствующем каталоге отвечают `NOT_FOUND` и ничего не создают.
1214
1449
  Бинарник не хранит настроек проекта и не помнит «последний активный проект».
1215
1450
 
1216
- | Команда | Аргументы | Пишет | `data` | Повтор |
1217
- | ------------------ | --------------------------------------------------------------------------------------------------------- | ----- | ---------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------ |
1218
- | `validate` | `--graph F --policy F [--context F]` | нет | digests, число поручений | Чистая функция входов |
1219
- | `review-plan` | `--state D --graph F --policy F --author A [--context F]` | да | `ReviewRecord` | Тот же digest и автор, уже согласованные, — тот же раунд без вызова модели; автор, не допускаемый правилом вендора, — `REVIEWER_SAME_VENDOR` до вызова |
1220
- | `review-contract` | `--state D --contract F --policy F --author A` | да | `ReviewRecord` | Как `review-plan` |
1221
- | `approve` | `--state D --subject ID --digest H` | да | subject, digest, at | Тот же digest — без изменений; только `approvalMode: operator` |
1222
- | `run` | `--state D --graph F --policy F [--context F] [--sink file:D] [--once]` | да | граф, поручения и их блокеры, задание `workflow` | Та же редакция продолжает работу; другой digest той же редакции — `REVISION_CONFLICT` |
1223
- | `status` | `--state D [--graph ID] [--detail]` | нет | очередь, графы, поручения с блокерами, бюджеты; с `--detail` — `detail` | Только чтение |
1224
- | `events` | `--state D [--after N] [--limit 1–500]` | нет | события (неизвестный тип — `unknown`), `next` | Только чтение |
1225
- | `pause` | `--state D` | да | `ControlState` | Без изменений |
1226
- | `resume` | `--state D` | да | `ControlState` | Решение человека: снимает паузу оператора, штатной остановки и отказа runtime вместе с её классами; паузу операции reconfigure — `PAUSED` |
1227
- | `cancel` | `--state D --work ID [--reason T]` | да | статус поручения | Отменённое — без изменений; это не retry |
1228
- | `retry` | `--state D --work ID [--reset --reason T]` | да | статус поручения | В пределах `maxAttempts` и бюджета; `--reset` с причиной сбрасывает счётчик попыток, но не учёт расходов |
1229
- | `result` | `--state D --work ID` | нет | `ResultEnvelope` | Только чтение |
1230
- | `deliver` | `--state D --work ID --sink file:D` | да | `ResultEnvelope` | Доставленное не доставляется повторно; моделей и интеграции нет |
1231
- | `cleanup` | `--state D --run ID` | да | исход очистки попытки |
1232
- | `worktree-cleanup` | `--state D [--dry-run]` | да | счётчики и `worktrees[]` с действием и причиной отказа |
1233
- | `profile` | `--profile ID\|./F [--repository D]` | нет | закрепление (`pin`) и разрешённый профиль | Чистая функция файлов профиля; команды проекта не исполняются |
1234
- | `doctor` | `[--state D] [--policy F]` | нет | версии, runtime, sandbox, совместимость состояния и версии движка в нём | Без live-вызова модели |
1235
- | `init` | `--repository D [--profile P] [--writer R] [--state D] [--plan]` | да | план файлов, `created`, `manifest`, `facts`, `toolchain`, `next` | Create-only `.harness/`, manifest до политики, политика последней; повтор — `created: []`; иное решение — `PATH_CONFLICT` |
1236
- | `explain` | `--state D --policy F [--work ID]` | нет | `diagnoses[]` (`StopDiagnosis`) | Только чтение: без повторов, вызовов моделей и изменений состояния |
1237
- | `report` | `--state D [--since T\|Nd\|Nw] [--until T] [--as-of T] [--format json\|md\|html] [--no-titles] [--out F]` | нет | `ValueReport`; с `--out` — `{out, format, bytes, asOf}` | Только чтение; те же данные и параметры — те же байты |
1238
- | `handoff` | `--state D [--graph ID] [--intent T]… [--format json\|md]` | нет | `HandoffPack`; с `--format md` — Markdown без конверта | Только чтение; агент добавляет только намерения |
1239
- | `plan-request` | `--brief F --policy F [--context F] [--contracts D] [--requirements [R:]F]… [--human]` | нет | `prompt`, `readOnly`, `recommendedTasks`, `maxTasks`, `basis`, `facts` (`PlanningFacts`) | Чистая функция входов: та же постановка и те же факты — тот же prompt и `basis`; модель не вызывается |
1240
- | `plan-check` | `--draft F --policy F [--context F] [--contracts D] [--brief F [--basis H]]` | нет | `issues`, `checkPlan`; без проблем — `graph`, `graphDigest`, `basis` | Чистая функция входов и `HEAD` источников требований; согласования не выдаёт, gates не запускает; расхождение `--basis` — `APPROVAL_STALE` |
1241
- | `capabilities` | — | нет | каталог общих операций (`OperationCatalog`) | Чистая функция установленной версии пакета |
1242
- | `--version` | — | нет | версия пакета и API | — |
1451
+ | Команда | Аргументы | Пишет | `data` | Повтор |
1452
+ | ------------------ | ---------------------------------------------------------------------------------------------------------- | ----- | ---------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------ |
1453
+ | `validate` | `--graph F --policy F [--context F]` | нет | digests, число поручений | Чистая функция входов |
1454
+ | `review-plan` | `--state D --graph F --policy F --author A [--context F]` | да | `ReviewRecord` | Тот же digest и автор, уже согласованные, — тот же раунд без вызова модели; автор, не допускаемый правилом вендора, — `REVIEWER_SAME_VENDOR` до вызова |
1455
+ | `review-contract` | `--state D --contract F --policy F --author A` | да | `ReviewRecord` | Как `review-plan` |
1456
+ | `approve` | `--state D --subject ID --digest H` | да | subject, digest, at | Тот же digest — без изменений; только `approvalMode: operator` |
1457
+ | `run` | `--state D --graph F --policy F [--context F] [--sink file:D] [--once]` | да | граф, поручения и их блокеры, задание `workflow` | Та же редакция продолжает работу; другой digest той же редакции — `REVISION_CONFLICT` |
1458
+ | `status` | `--state D [--graph ID] [--detail]` | нет | очередь, графы, поручения с блокерами, бюджеты; с `--detail` — `detail` | Только чтение |
1459
+ | `events` | `--state D [--after N] [--limit 1–500]` | нет | события (неизвестный тип — `unknown`), `next` | Только чтение |
1460
+ | `pause` | `--state D` | да | `ControlState` | Без изменений |
1461
+ | `resume` | `--state D` | да | `ControlState` | Решение человека: снимает паузу оператора, штатной остановки и отказа runtime вместе с её классами; паузу операции reconfigure — `PAUSED` |
1462
+ | `cancel` | `--state D --work ID [--reason T]` | да | статус поручения | Отменённое — без изменений; это не retry |
1463
+ | `retry` | `--state D --work ID [--reset --reason T]` | да | статус поручения | В пределах `maxAttempts` и бюджета; `--reset` с причиной сбрасывает счётчик попыток, но не учёт расходов |
1464
+ | `result` | `--state D --work ID` | нет | `ResultEnvelope` | Только чтение |
1465
+ | `deliver` | `--state D --work ID --sink file:D` | да | `ResultEnvelope` | Доставленное не доставляется повторно; моделей и интеграции нет |
1466
+ | `cleanup` | `--state D --run ID` | да | исход очистки попытки |
1467
+ | `worktree-cleanup` | `--state D [--dry-run]` | да | счётчики и `worktrees[]` с действием и причиной отказа |
1468
+ | `profile` | `--profile ID\|./F [--repository D]` | нет | закрепление (`pin`) и разрешённый профиль | Чистая функция файлов профиля; команды проекта не исполняются |
1469
+ | `doctor` | `[--state D] [--policy F]` | нет | версии, runtime, sandbox, совместимость состояния и версии движка в нём | Без live-вызова модели |
1470
+ | `init` | `--repository D [--profile P] [--writer R] [--state D] [--plan]` | да | план файлов, `created`, `manifest`, `facts`, `toolchain`, `next` | Create-only `.harness/`, manifest до политики, политика последней; повтор — `created: []`; иное решение — `PATH_CONFLICT` |
1471
+ | `explain` | `--state D --policy F [--work ID]` | нет | `diagnoses[]` (`StopDiagnosis`) | Только чтение: без повторов, вызовов моделей и изменений состояния |
1472
+ | `report` | `--state D [--since T\|Nd\|Nw] [--until T] [--as-of T] [--format json\|md\|html] [--no-titles] [--out F]` | нет | `ValueReport`; с `--out` — `{out, format, bytes, asOf}` | Только чтение; те же данные и параметры — те же байты |
1473
+ | `handoff` | `--state D [--graph ID] [--intent T]… [--format json\|md]` | нет | `HandoffPack`; с `--format md` — Markdown без конверта | Только чтение; агент добавляет только намерения |
1474
+ | `plan-request` | `--brief F --policy F [--context F] [--contracts D] [--requirements [R:]F]… [--human]` | нет | `prompt`, `readOnly`, `recommendedTasks`, `maxTasks`, `basis`, `facts` (`PlanningFacts`) | Чистая функция входов: та же постановка и те же факты — тот же prompt и `basis`; модель не вызывается |
1475
+ | `plan-check` | `--draft F --policy F [--context F] [--contracts D] [--brief F [--basis H]]` | нет | `issues`, `checkPlan`; без проблем — `graph`, `graphDigest`, `basis` | Чистая функция входов и `HEAD` источников требований; согласования не выдаёт, gates не запускает; расхождение `--basis` — `APPROVAL_STALE` |
1476
+ | `input-list` | `--state D [--work ID]` | нет | запросы: ID, поручение, вид, состояние, серьёзность, версия — без текста | Только чтение |
1477
+ | `input-show` | `--state D --request ID` | нет | `InputRequest` | Только чтение |
1478
+ | `input-answer` | `--state D --request ID --text T [--option ID] [--kind K] [--actor A] --request-version N` | да | запрос, ответ, `changed` | Тот же текст, вариант и вид — прежний ответ; иначе новая версия при совпадении версии (CAS) |
1479
+ | `input-context` | `--state D --request ID --out F` | да | `requestId`, `answerDigest`, `digest`, `out` | Тот же ответ и тот же действующий снимок — тот же digest; снимок не активируется |
1480
+ | `input-target` | `--state D --request ID --context-digest H` | нет | основание продолжения и `problems` | Только чтение |
1481
+ | `input-apply` | `--state D --request ID --answer H --request-version N --context-digest H --target H [--reset --reason T]` | да | `applied`, `changed`, поручение; `active` или `blocker` | Повтор — без изменений и второй попытки; не применено — exit 3, запрос прежний |
1482
+ | `input-cancel` | `--state D --request ID --request-version N --reason T` | да | `lifecycle`, `version`, `changed` | Отменённый — без изменений |
1483
+ | `input-supersede` | `--state D --request ID --request-version N --reason T --successor ID` | да | `lifecycle`, `version`, `changed` | Заменённый — без изменений |
1484
+ | `capabilities` | — | нет | каталог общих операций (`OperationCatalog`) | Чистая функция установленной версии пакета |
1485
+ | `--version` | — | нет | версия пакета и API | — |
1243
1486
 
1244
1487
  Полная форма каждой команды — `cliCommands` (аргументы, обязательность,
1245
1488
  идемпотентность, отказы exit 3). Все команды реализованы. `run` принимает `--author` (по умолчанию `external`) — автора графа для ревью плана. `HARNESS_CODEX_BIN` и `HARNESS_CLAUDE_BIN` подменяют исполняемые файлы runtime (fixture executables в тестах).
@@ -0,0 +1,26 @@
1
+ # devcontour-harness 0.1.0-alpha.36
2
+
3
+ Факты проекта только для чтения и установка зависимостей исполнителя до его
4
+ запуска. `stateVersion` и `policyVersion` прежние.
5
+
6
+ ## Изменения
7
+
8
+ - **Факты проекта.** `inspectProject({ repository })` из корня пакета и
9
+ договор `project-facts`: Git (корень, связанное рабочее дерево, база, ветка,
10
+ первые 50 изменённых путей и их общее число), lockfiles, менеджер пакетов,
11
+ профили, скрипты, проверки, инструменты и CLI runtimes (`available`,
12
+ `missing`, `version-error`; авторизация `unknown`) с диагностиками и
13
+ действиями. Инспекция ничего не пишет (в том числе индекс `.git`) и не
14
+ исполняет скрипты проекта; `init` использует те же Git-факты.
15
+ - **Зависимости исполнителя.** Перед исполнителем, после наложения черновика
16
+ прежней попытки, controller исполняет в его дереве обязательные gates
17
+ установки попытки под изоляцией gate, без evidence (стадия
18
+ `writer-dependencies`). Следы установки в работу исполнителя не попадают;
19
+ правка отслеживаемых файлов откатывается (`reverted`). Отключение —
20
+ `repositories[].writerDependencies: false`.
21
+
22
+ ## Обновление
23
+
24
+ Новые поля необязательны, но строгая схема прежних версий не принимает
25
+ `writerDependencies`: при откате уберите его из политики. Подробнее —
26
+ `docs/upgrade.md` и `docs/toolchains.md`.
@@ -0,0 +1,40 @@
1
+ # devcontour-harness 0.1.0-alpha.37
2
+
3
+ Вопрос исполнителя: writer останавливается на развилке, ответ проходит ревью
4
+ контекста и применяется к следующей попытке. Диагностика остановок для многих
5
+ работ за одно чтение. `stateVersion` и `policyVersion` прежние.
6
+
7
+ ## Изменения
8
+
9
+ - **Вопрос исполнителя.** Необязательные `inputRequest` и `assumptions` в
10
+ ответе writer, политика `inputPolicy {threshold 1–11, criticalPaths}`
11
+ (порог по умолчанию 7, 11 — автономный режим), локальное пространство
12
+ `input-requests`, класс отказа `needs-input` и код `INPUT_REQUIRED`.
13
+ Ответ, снимок контекста с ответом, его ревью, применение, замена и перенос
14
+ ответа в новую редакцию; команды CLI `input-*`; необязательный порт
15
+ `ExecutionHost.input`. Подробно — `docs/contracts.md#вопрос-исполнителя`.
16
+ - **Диагностика многих работ.** `stopInputsOf(source, { maxAttempts,
17
+ repairBudget, workIds })`: каждая работа из `workIds` получает то же, что
18
+ вызов с её `workId`, в порядке состояния; неизвестный ID — `NOT_FOUND`,
19
+ `workId` вместе с `workIds` — `INVALID_INPUT`. Вызов для всей доски и для
20
+ набора читает общие данные один раз и линеен по числу работ и связей.
21
+ - **Помощники движка** (каждый действителен только внутри своего чтения):
22
+ `Engine.approvalStaleness(view)`, `Engine.budgetBlockers(view)`,
23
+ `Engine.budgetBlocksOf(workIds | undefined, view)` — блокировки бюджета
24
+ набора работ за одно чтение, значение равно `budgetBlockOf(workId, view)`.
25
+ Необязательные `records` у `budgetBlockOf` и `blocking` у `repairDecision`.
26
+ - **Перенос ответа.** Снятие устаревшего перенесённого ответа сохраняет
27
+ запись замены в `closed.previous`.
28
+ - **Объяснение.** Работа, отказавшая до старта (не засчитанная попытка,
29
+ например без закреплённого снимка контекста), объясняется фазой `preflight`;
30
+ `StopInput.work.preflight` — новое поле. Класс отказа `needs-lead` и его
31
+ правила прежние.
32
+ - **Отчёт.** `report.inputs.carryStale` считает вопросы с устаревшим
33
+ перенесённым ответом; `report.inputs.closed` их больше не считает.
34
+
35
+ ## Обновление
36
+
37
+ Новое аддитивно; схемы прежних версий не принимают новые необязательные поля
38
+ (`inputPolicy`, `closed.previous`, `inputs.carryStale`): при откате уберите
39
+ их или восстановите копию каталога состояния, снятую до обновления.
40
+ Подробнее — `docs/upgrade.md`.