devcontour-harness 0.1.0-alpha.34 → 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 (125) hide show
  1. package/README.md +22 -2
  2. package/docs/contracts.md +309 -35
  3. package/docs/release-notes/0.1.0-alpha.35.md +27 -0
  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/standalone.md +20 -0
  7. package/docs/toolchains.md +57 -2
  8. package/docs/upgrade.md +143 -0
  9. package/lib/agents/cli-adapter.d.ts +10 -1
  10. package/lib/agents/cli-adapter.js +38 -7
  11. package/lib/agents/schemas.d.ts +84 -2
  12. package/lib/agents/schemas.js +49 -1
  13. package/lib/agents/usage.d.ts +9 -0
  14. package/lib/agents/usage.js +22 -1
  15. package/lib/cli.js +149 -1
  16. package/lib/contracts/cli.d.ts +1544 -171
  17. package/lib/contracts/cli.js +233 -2
  18. package/lib/contracts/diagnosis.d.ts +10 -4
  19. package/lib/contracts/diagnosis.js +4 -0
  20. package/lib/contracts/errors.d.ts +9 -1
  21. package/lib/contracts/errors.js +8 -0
  22. package/lib/contracts/events.d.ts +468 -60
  23. package/lib/contracts/events.js +79 -0
  24. package/lib/contracts/execution.d.ts +301 -50
  25. package/lib/contracts/execution.js +60 -0
  26. package/lib/contracts/failure.d.ts +20 -3
  27. package/lib/contracts/failure.js +14 -2
  28. package/lib/contracts/handoff.d.ts +79 -20
  29. package/lib/contracts/handoff.js +42 -1
  30. package/lib/contracts/index.d.ts +1 -0
  31. package/lib/contracts/index.js +1 -0
  32. package/lib/contracts/input-state.d.ts +13 -0
  33. package/lib/contracts/input-state.js +32 -0
  34. package/lib/contracts/input.d.ts +442 -0
  35. package/lib/contracts/input.js +321 -0
  36. package/lib/contracts/planning.d.ts +4 -0
  37. package/lib/contracts/policy.d.ts +17 -2
  38. package/lib/contracts/policy.js +31 -2
  39. package/lib/contracts/ports.d.ts +64 -2
  40. package/lib/contracts/project.d.ts +127 -0
  41. package/lib/contracts/project.js +99 -0
  42. package/lib/contracts/published.d.ts +631 -92
  43. package/lib/contracts/published.js +4 -1
  44. package/lib/contracts/repair-policy.d.ts +30 -1
  45. package/lib/contracts/repair-policy.js +52 -0
  46. package/lib/contracts/report.d.ts +55 -21
  47. package/lib/contracts/report.js +33 -2
  48. package/lib/contracts/result.d.ts +28 -24
  49. package/lib/contracts/review.d.ts +47 -8
  50. package/lib/contracts/review.js +21 -1
  51. package/lib/control/harness.d.ts +2555 -51
  52. package/lib/control/harness.js +112 -6
  53. package/lib/control/recovery.d.ts +2 -2
  54. package/lib/control/report.js +1 -0
  55. package/lib/control/status.d.ts +30 -22
  56. package/lib/control/status.js +11 -1
  57. package/lib/control/workflow.d.ts +8 -8
  58. package/lib/engine/budget.d.ts +86 -3
  59. package/lib/engine/budget.js +45 -10
  60. package/lib/engine/classify.js +1 -1
  61. package/lib/engine/engine.d.ts +3091 -83
  62. package/lib/engine/engine.js +1209 -101
  63. package/lib/engine/failure.d.ts +1 -1
  64. package/lib/engine/failure.js +1 -1
  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/measured.d.ts +6 -1
  70. package/lib/engine/measured.js +12 -1
  71. package/lib/engine/prompt.d.ts +4 -2
  72. package/lib/engine/prompt.js +13 -1
  73. package/lib/engine/property-recovery.js +4 -0
  74. package/lib/engine/repair.d.ts +2 -0
  75. package/lib/engine/repair.js +13 -4
  76. package/lib/engine/reuse.js +2 -0
  77. package/lib/engine/runner.d.ts +33 -4
  78. package/lib/engine/runner.js +275 -23
  79. package/lib/environment/lifecycle.d.ts +8 -0
  80. package/lib/environment/lifecycle.js +15 -2
  81. package/lib/explain/state.d.ts +16 -2
  82. package/lib/explain/state.js +262 -79
  83. package/lib/handoff/markdown.js +10 -0
  84. package/lib/handoff/pack.js +42 -1
  85. package/lib/index.d.ts +11 -1
  86. package/lib/index.js +11 -1
  87. package/lib/init/inspect.d.ts +34 -0
  88. package/lib/init/inspect.js +292 -0
  89. package/lib/init/project.js +14 -31
  90. package/lib/integrations/connector/commands.d.ts +12 -12
  91. package/lib/integrations/connector/config.d.ts +4 -4
  92. package/lib/integrations/connector/delivery.d.ts +1 -1
  93. package/lib/integrations/relay-v2/protocol.d.ts +4 -4
  94. package/lib/profiles/resolve.d.ts +2 -1
  95. package/lib/projections/enums.d.ts +1 -1
  96. package/lib/projections/enums.js +4 -0
  97. package/lib/projections/index.d.ts +1 -0
  98. package/lib/projections/index.js +1 -0
  99. package/lib/projections/input.d.ts +17 -0
  100. package/lib/projections/input.js +28 -0
  101. package/lib/projections/stop.d.ts +42 -1
  102. package/lib/projections/stop.js +117 -6
  103. package/lib/report/compute.d.ts +4 -1
  104. package/lib/report/compute.js +26 -0
  105. package/lib/report/document.js +2 -1
  106. package/lib/storage/document.d.ts +68 -28
  107. package/lib/testing/index.d.ts +1 -1
  108. package/lib/testing/index.js +1 -1
  109. package/lib/testing/store-contract.d.ts +8 -1
  110. package/lib/testing/store-contract.js +194 -1
  111. package/lib/verification/confirm.d.ts +3 -3
  112. package/lib/verification/corpus.d.ts +9 -9
  113. package/lib/verification/gates.d.ts +119 -0
  114. package/lib/verification/gates.js +311 -4
  115. package/package.json +1 -1
  116. package/schemas/execution-document.schema.json +141 -0
  117. package/schemas/execution-policy.schema.json +26 -0
  118. package/schemas/handoff-pack.schema.json +155 -4
  119. package/schemas/input-request.schema.json +665 -0
  120. package/schemas/project-facts.schema.json +393 -0
  121. package/schemas/result-envelope.schema.json +2 -0
  122. package/schemas/run-event.schema.json +628 -0
  123. package/schemas/run-result.schema.json +2 -0
  124. package/schemas/stop-diagnosis.schema.json +7 -1
  125. package/schemas/value-report.schema.json +79 -7
package/README.md CHANGED
@@ -5,7 +5,7 @@ Headless-движок исполнения инженерных поручени
5
5
  интеграция с принятой веткой через compare-and-swap и машинный результат с SHA
6
6
  и доказательствами.
7
7
 
8
- > Статус: `0.1.0-alpha.34` — предварительный выпуск (alpha). Договоры
8
+ > Статус: `0.1.0-alpha.37` — предварительный выпуск (alpha). Договоры
9
9
  > `v1alpha1` могут измениться между alpha-версиями; закрепляйте точную версию.
10
10
  > Файл → ревью плана → кандидат → интеграция → принятие → результат JSON, с
11
11
  > ограниченным восстановлением, повторным использованием кандидата, бюджетами,
@@ -28,7 +28,7 @@ Headless-движок исполнения инженерных поручени
28
28
  Из npm — точная версия (воспроизводимо) или последняя alpha по тегу:
29
29
 
30
30
  ```sh
31
- npm install --save-exact devcontour-harness@0.1.0-alpha.34 # точная версия
31
+ npm install --save-exact devcontour-harness@0.1.0-alpha.37 # точная версия
32
32
  # или: npm install --save-exact devcontour-harness@alpha # текущая alpha
33
33
  npx harness --version
34
34
  ```
@@ -104,6 +104,7 @@ git rev-parse refs/heads/harness/accepted # совпадает с data.result.
104
104
  | `doctor` | Версии, runtime, sandbox, совместимость состояния |
105
105
  | `report --state D [--format md\|html]` | Отчёт об эффекте по данным проекта |
106
106
  | `handoff --state D [--format md] [--intent T]…` | Пакет передачи контекста новой сессии агента |
107
+ | `input-list / input-show / input-answer …` | Вопрос исполнителя: ответ, снимок, применение |
107
108
 
108
109
  stdout — один JSON (`devcontour-harness/v1alpha1`), диагностика — stderr. Exit
109
110
  codes: 0 успех, 2 неверный вход, 3 отказ/блокировка, 4 инфраструктура.
@@ -148,6 +149,25 @@ PASS» нет. Адаптеры хоста реализуют порты `Execut
148
149
  `devcontour-harness/schemas/<имя>.schema.json`. Декларации используют типы
149
150
  Node.js: TypeScript-потребителю нужен `@types/node` (или `skipLibCheck`).
150
151
 
152
+ ## Выпуск 0.1.0-alpha.37
153
+
154
+ Вопрос исполнителя (`inputRequest`, политика `inputPolicy`, ответ с ревью
155
+ контекста и переносом в новую редакцию) и диагностика остановок для многих
156
+ работ за одно чтение (`workIds`, `budgetBlocksOf`). Подробно —
157
+ [заметки выпуска](docs/release-notes/0.1.0-alpha.37.md).
158
+
159
+ ## Выпуск 0.1.0-alpha.36
160
+
161
+ Факты проекта только для чтения (`inspectProject`, договор `project-facts`) и
162
+ установка зависимостей исполнителя до его запуска. Подробно —
163
+ [заметки выпуска](docs/release-notes/0.1.0-alpha.36.md).
164
+
165
+ ## Выпуск 0.1.0-alpha.35
166
+
167
+ Нехватка окна контекста claude — отдельный класс отказа `context-exhausted`
168
+ с кодом `CONTEXT_EXHAUSTED` и короткой политикой повторов. Подробно —
169
+ [заметки выпуска](docs/release-notes/0.1.0-alpha.35.md).
170
+
151
171
  ## Выпуск 0.1.0-alpha.34
152
172
 
153
173
  События повторов, отмен, сдвигов базы и причин отказа среды; отчёт об
package/docs/contracts.md CHANGED
@@ -125,6 +125,11 @@ manifest снимка и в необязательном поле `baseline` о
125
125
  gate установки остаётся обычным `pnpm install --frozen-lockfile`.
126
126
  Подробности и граница доверия — [toolchains](toolchains.md#хранилище-зависимостей).
127
127
 
128
+ `repositories[].writerDependencies` — необязательное: `false` выключает установку зависимостей
129
+ в дереве исполнителя до его работы (gates установки попытки под изоляцией gate, без evidence,
130
+ стадия `writer-dependencies` в `timings`). Нет поля — включено, умолчание не подставляется и
131
+ digest политики не меняет. Подробно — [toolchains](toolchains.md#зависимости-исполнителя).
132
+
128
133
  Квитанция `dependency-store.json` лежит в артефактах фазы: `outcome`
129
134
  (`hit` — lockfile checkout равен lockfile seed; `partial` — seed другого
130
135
  lockfile, установка докачивает разницу; `miss` — обычная установка), `seed`,
@@ -660,6 +665,236 @@ fencing; само состояние между переходами не пер
660
665
  причину `stalled` у работающего поручения: при `report` действует человек
661
666
  (`fix-environment`), при `stop` — controller.
662
667
 
668
+ ### Нехватка окна контекста
669
+
670
+ Отказ класса `context-exhausted` — исполнителю или reviewer не хватило окна
671
+ контекста модели внутри попытки. Класс ставится по признаку, который сообщил
672
+ сам runtime, а не по тексту причины: адаптер claude читает `terminal_reason`
673
+ итогового события `result` потока `stream-json` и выставляет
674
+ `RuntimeResponse.diagnostics.contextExhausted` — предел окна
675
+ (`ContextLimit`). Записанные на живом CLI признаки:
676
+
677
+ - `prompt_too_long` на первом ходе (`num_turns` ≤ 1) → `prompt-too-long` —
678
+ запрос отклонён: уже подсказка с контекстом больше окна, сжимать нечего.
679
+ Тот же признак после ходов работы или без `num_turns` (не записан, вывод
680
+ инструментов заполнил окно) → `blocking-limit`;
681
+ - `blocking_limit` → `blocking-limit` — CLI сам остановил ход у предела окна.
682
+ Записан с выключенным автоматическим сжатием через `DISABLE_AUTO_COMPACT=1`.
683
+ `autoCompactEnabled: false` в `--settings` сжатие тоже выключает (проверено),
684
+ но исход у предела окна с ним не записан; путь «сжатие включено, но не
685
+ помогло» не проверен.
686
+
687
+ В обоих случаях CLI выходил с кодом 1, `is_error: true`, текст `result`
688
+ начинался с `Prompt is too long`; признак учитывается и при коде 0. Текст
689
+ отказа попытки постоянный (`claude: не хватило окна контекста модели`), предел
690
+ — данными (`AttemptState.contextLimit`), текст runtime — в журнале вызова:
691
+ отпечаток один при любом пределе и любых числах токенов, а «401» или «429» в
692
+ числах токенов текстовый разбор принял бы за отказ провайдера. Успешное
693
+ автоматическое сжатие (`system`/`compact_boundary`) — не отказ: вызов
694
+ продолжается и завершается своим исходом; число сжатий и `terminal_reason`
695
+ пишутся в `runtime.json` вызова (`compactions`, `terminalReason`). У codex
696
+ признак пока не распознаётся: его отказ классифицируется как прежде.
697
+
698
+ Попытка засчитывается в `maxAttempts`: отказ говорит о размере задачи, а не
699
+ об окружении, и выдачу не останавливает. Повторы (`repairRepeats`): у
700
+ `blocking-limit` — один (`repairPolicy['context-exhausted'].repeats`), и
701
+ следующая попытка writer получает в подсказке указание держать контекст малым
702
+ (читать только нужные файлы и строки, не выводить большие файлы и длинный
703
+ вывод команд); у `prompt-too-long` — ни одного: повтор только удлинил бы
704
+ подсказку. Предел берётся у последней попытки с отказом
705
+ (`lastContextLimit`); отпечаток у обоих пределов один. Дальше задачу нужно разделить или сократить её контекст:
706
+ код остановки `CONTEXT_EXHAUSTED` (класс `refused`), `explain` — ведущий,
707
+ `diagnose-failure`. Корзина отчёта — `incomplete`; разбор свойства
708
+ (`property-recovery`) такой отказ не считает, кандидат после отказа reviewer
709
+ переиспользуется (`reusableFailures`). Причина `attempt.diagnosed` — `none`,
710
+ `counted: true`.
711
+
712
+ ### Вопрос исполнителя
713
+
714
+ Writer, которому для продолжения нужно решение человека или ведущего,
715
+ отвечает `completed: false` и вопросом `inputRequest` (`inputQuestionSchema`:
716
+ текст до 1500 знаков, до шести вариантов с последствием, рекомендуемый
717
+ вариант, самооценка серьёзности 1–10, основание, затронутые критические
718
+ области `contract | acceptance | product | api | migration`). Развилки,
719
+ которые он решил сам, — `assumptions[]` (вопрос, выбор, основание,
720
+ серьёзность, области; до 20). `completed: true` вместе с вопросом невалиден.
721
+ Поля необязательны: ответ прежнего формата — ответ без вопроса и допущений.
722
+ Wire-схема CLI runtime объявляет оба поля (`inputRequest` — объект или
723
+ `null`).
724
+
725
+ **Политика вопросов** — `ExecutionPolicy.inputPolicy`
726
+ (`{threshold: 1–11, criticalPaths: []}`; нет поля — порог 7 без критических
727
+ путей, умолчание в политику не подставляется). Порог закрепляется в попытке
728
+ при выдаче (`AttemptState.inputPolicy`) и в `executionDigest` не входит: смена
729
+ порога действует со следующей попытки без нового согласования. Порог и шкала
730
+ называются в запросе writer. Действующая серьёзность — самооценка, поднятая
731
+ до 10 минимумами, которые модель понизить не может: вопрос или допущение
732
+ называет критическую область или сам оценён потолком 10 (`declared`) либо попытка изменила путь из
733
+ `criticalPaths` (`critical-path`).
734
+
735
+ Исход ответа writer (`evaluateInput`) — после проверок защищённых путей,
736
+ HEAD и области записи: нарушение области остаётся `scope-violation` и не
737
+ прячется за вопрос.
738
+
739
+ | Ответ | Исход |
740
+ | ------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------- |
741
+ | `completed: false`, вопрос не ниже порога | `needs-input`: попытка засчитана, черновик — `AttemptState.partial`, запрос `pending` в той же транзакции, что отказ |
742
+ | `completed: false`, вопрос ниже порога | `unfinished` (нарушение запроса); вопрос записан отклонённым (`cancelled`, `closed.by: controller`) и работу не держит |
743
+ | `completed: false` без вопроса | `unfinished`, как прежде |
744
+ | `completed: true`, допущение не ниже порога | `needs-input` без кандидата: самое серьёзное допущение становится вопросом (вариант `chosen` — выбор исполнителя) |
745
+ | `completed: true`, допущения ниже порога | Допущения пишутся в попытку (`AttemptState.assumptions`), запрос reviewer их перечисляет; работа идёт дальше |
746
+ | Порог 11 (автономный режим) | Остановок нет; все допущения записаны; критические — неблокирующие запросы ведущему (`kind: follow-up`); согласованное состояние не меняется |
747
+
748
+ `needs-input` — класс отказа без автоматического повтора
749
+ (`repairPolicy['needs-input']`: `stop`, выдачу не останавливает), корзина
750
+ отчёта `input`, код остановки `INPUT_REQUIRED` (класс `refused`).
751
+
752
+ **Канонический запрос** (`InputRequest`, `schemas/input-request.schema.json`)
753
+ хранится в локальном пространстве `input-requests` у владельца — репозитория
754
+ поручения. ID (`IR-<24 hex>`) выдаёт controller детерминированно от попытки.
755
+ Вопрос и основание исходной попытки (`originBasis`: источник, digests графа,
756
+ постановки, политики, снимок контекста или `null`, база, закреплённая
757
+ `inputPolicy`) неизменяемы; ответы (`answers[]`, до 20) только дополняются;
758
+ `version` — CAS записи. Эти правила проверяет движок (записи — только через
759
+ его операции); от хранилища договор (`executionStoreContract`) требует хранить
760
+ запись целиком и отдавать её в списке без владельца с `owner` и `key`.
761
+ Жизненный цикл: `pending → answered → applied`,
762
+ альтернативные окончания — `cancelled` и `superseded` (с `successor`).
763
+
764
+ **Блокировка.** Блокирующий запрос в `pending` или `answered` сам держит
765
+ работу: claim его не выдаёт (и после новой редакции графа с согласованием),
766
+ `retry` — в том числе со сбросом — отказывает `INPUT_REQUIRED`, `repairDecision`
767
+ такую работу не чинит и не останавливает ею восстановление группы, приёмка
768
+ (`finish`) отказывает. `WorkState.hold` не занимается: снятие чужого
769
+ удержания ожидание ответа не обходит. Отмена работы закрывает её открытые
770
+ запросы.
771
+
772
+ **Продолжение.**
773
+
774
+ 1. `answerInput(id, {text, optionId?, kind, actor, messageRef?},
775
+ expectedVersion)` — новая версия ответа с `answerDigest`; работу ответ не
776
+ возобновляет. Тот же текст, вариант и вид — прежний ответ без записи.
777
+ `kind: requirement-change` — изменение требований: старый запрос
778
+ заменяется (`supersedeInput`) ссылкой на новую ревизию, а не
779
+ продолжается.
780
+ 2. `Harness.inputContext(id, {messages?})` — неизменяемый снимок: действующий
781
+ снимок графа и источник `input-answer` (`inputContextSource`): файл
782
+ `input/<id>.md` (вопрос, варианты, ответ) и справка
783
+ `input/<id>.manifest.json` (`{requestId, answerDigest, revision,
784
+ messages[{id, revision, digest}]}`). Версия ответа — в `version`
785
+ источника (`r<N>`), не в `revision`. Снимок хранится по digest, но не
786
+ активируется.
787
+ 3. Ревью этого снимка — обычный `review-plan --context`. Согласование им не
788
+ меняется: попытки графа сохраняют своё. `approve` со снимком, где ответ не
789
+ применён, — `INPUT_REQUIRED`; `run` с таким снимком отказывает тем же кодом
790
+ до вызова модели.
791
+ 4. `proposeTarget(id, contextDigest)` — основание продолжения (только чтение)
792
+ и причины, по которым применение сейчас откажет.
793
+ 5. `applyInput(id, {answerDigest, expectedVersion, contextDigest,
794
+ targetDigest, actor, reset?})` — одна транзакция: точная версия запроса и
795
+ последний ответ, вид `clarification`, работа всё ещё в исходной остановке
796
+ (последняя попытка — попытка вопроса), неизменные граф и постановка,
797
+ политика процесса применена, снимок несёт ровно этот ответ (manifest),
798
+ проверки `approve` (`approvalCheck`: раунд ревью этого снимка, в режиме
799
+ `agent` одобренный, актёр — режим политики) и пересчитанное основание
800
+ совпадает с `targetDigest`. Затем — активация согласования снимка, запрос
801
+ `applied` с `target` и обычный повтор (`retryIn`: те же правила, без
802
+ сброса, если сброс не назван). Модель не вызывается; пауза оператора и
803
+ чужие удержания остаются. Идут попытки графа или совместная проверка —
804
+ `{applied: false, active}`, запрос и согласование не меняются; исчерпаны попытки или бюджет —
805
+ `{applied: false, blocker}`, запрос остаётся `answered`. Повтор того же
806
+ применения — `{applied: true, changed: false}`.
807
+ 6. Claim закрепляет действующий снимок (`pinned.contextDigest`) и связывает
808
+ ответ с попыткой (`AttemptState.input`) только при совпадении применённого
809
+ основания с основанием выдачи. Runner загружает снимок по закреплению:
810
+ writer и оба reviewer видят одни и те же байты. «Передано исполнителю»
811
+ (`delivered`, событие `input.delivered`) — только по началу вызова writer
812
+ этой попытки, один раз, под fencing; apply и claim доставку не
813
+ подтверждают.
814
+
815
+ **Исходная остановка** держится, пока работа на попытке вопроса
816
+ (остановлена `needs-input` или готова после устаревшего применения) и её
817
+ собственная постановка прежняя — по содержанию без ревизии источника
818
+ (`originBasis.contentDigest`, у цели — `target.contentDigest`): пересинхронизация
819
+ трекера одной ревизией ни остановку, ни применённый ответ не обесценивает. Граф целиком не
820
+ сравнивается: согласование или добавление другой работы того же графа (у
821
+ DevContour граф — активная ревизия доски) остановку и применённый ответ не
822
+ обесценивает.
823
+
824
+ **Устаревшее применение.** Если до выдачи попытки с ответом сменились
825
+ постановка работы, политика или действующий снимок (новый снимок не несёт
826
+ этот ответ), транзакция claim возвращает запрос в `answered` с причиной
827
+ (`stale.reason`: `order | policy | context`, событие `input.stale`; значение
828
+ `graph` больше не ставится): работа не выдаётся без ответа и ждёт нового
829
+ снимка, ревью и `applyInput` (готовая работа на исходной попытке применяется
830
+ так же, как остановленная). Снимок, который несёт тот же ответ (например, с
831
+ ответом на второй вопрос графа), основание не обесценивает.
832
+
833
+ **Новая редакция постановки.** Если постановка самой работы изменилась,
834
+ продолжение исходной остановки невозможно (`applyInput` и `proposeTarget`
835
+ называют выход). Выход с сохранением ответа: `supersedeInput` (преемник —
836
+ новая редакция работы), затем `inputContext` (принимает заменённый вопрос с
837
+ ответом), `review-plan` со снимком и перенос: `carryInput(id, {contextDigest,
838
+ actor})` — одна транзакция с правилом переноса, отсутствием неприменённых
839
+ ответов в снимке, барьером политики, ревью и актёром по правилам хоста
840
+ (`InputHost.review`) или `approvalRules`, без идущих попыток графа
841
+ (`{carried: false, active}`), пределами попыток и бюджета до активации
842
+ (`{carried: false, blocker}`), активацией (`InputHost.activate` с `mode:
843
+ 'carry'` или согласование графа), записью цели в заменённый запрос и обычным
844
+ повтором работы, остановленной вопросом (иной отказ остаётся по своим
845
+ правилам). Перенесённый ответ связывается с попыткой при выдаче и
846
+ подтверждается вызовом writer, как применённый; если до выдачи согласование
847
+ ушло на снимок без него, цель снимается, `stale` записывается (состояние
848
+ `carry-stale`), и работа ждёт: выходы — новый перенос или снять перенесённый
849
+ ответ (`cancelInput`), тогда работа продолжится без него; запись замены
850
+ (преемник, `carry`, причина) остаётся в `closed.previous`. Изменение требований сравнивается по содержанию постановки
851
+ без ревизии источника (`originBasis.contentDigest`). Экспортированный
852
+ `unappliedInputs` требует правило переноса движка (`mayCarry`, проще —
853
+ `Engine.unappliedInputs`). У standalone тот же снимок можно согласовать и
854
+ обычным `approve`/`run`. Перенос решается в момент переноса
855
+ (`Engine.carryAllowed`), а не замены: уточнение — когда исходная остановка
856
+ уже не держится, изменение требований — только когда изменилась постановка
857
+ самой работы; только последняя версия ответа. Порядок «замена, затем новая
858
+ редакция» тоже ведёт к переносу; `closed.carry` — сведение о моменте замены.
859
+ Пока остановка держится, продолжение — только `applyInput`. Снимок с новым
860
+ ответом не становится действующим и через `approve`/`run`, пока в графе идут
861
+ попытки (`NOT_READY`; `run` отказывает до ревью). `inputContext` отказывает
862
+ для неблокирующих и закрытых без замены запросов.
863
+
864
+ **Закреплённый снимок.** У попытки с `pinned.contextDigest` записанный
865
+ снимок контекста обязан совпасть с закреплённым — при записи контекста
866
+ runner и при приёмке (`APPROVAL_STALE`): загрузчик хоста, не учитывающий
867
+ закрепление, отказывает до вызова writer; не найденный закреплённый снимок —
868
+ отказ этой работы при загрузке (`needs-lead`, причина `preflight`, попытка не
869
+ засчитана, очередь не останавливается; explain — фаза `preflight` и неполные
870
+ входы работы, `StopInput.work.preflight`). `InputHost.contextDigestOf`:
871
+ `null` — снимок «без контекста» (загрузчик обязан вернуть пусто),
872
+ `undefined` — хост не связывает согласование с контекстом (проверки нет).
873
+
874
+ **Вопрос вне схемы.** Пределы вопроса называются в запросе writer; схема
875
+ договора строгая. Ответ вне схемы, в котором есть вопрос, controller приводит
876
+ к схеме (усекает текст, исправляет ID вариантов, оставляет шесть вариантов,
877
+ ограничивает серьёзность) и решает как обычно; что исправлено — в поле запроса
878
+ `normalized`. Ответ вне схемы без вопроса — отказ, как прежде. Вопрос и
879
+ допущения маскируются полным окружением вызова до записи; решения взятого
880
+ кандидата переоцениваются по политике новой попытки, решения продолжаемого
881
+ черновика видят writer и reviewer.
882
+
883
+ События `input.requested`, `input.answered`, `input.applied`,
884
+ `input.closed`, `input.delivered` и `attempt.assumptions` несут ID, digests и
885
+ числа — без текста вопросов, ответов и допущений.
886
+
887
+ **Проекции.** `status`: у поручения `input {requestId, state, version,
888
+ severity}` (`awaiting-answer | answered-not-applied | applied-awaiting-claim
889
+ | delivered`) и число неблокирующих запросов `followUps`. `explain`:
890
+ ожидание ответа — человек, `answer-input`; ответ без применения — ведущий,
891
+ `apply-input` с причиной, по которой применение сейчас откажет; сообщение
892
+ называет усечённый вопрос, варианты, версию и digest ответа, число решений
893
+ исполнителя; неблокирующие запросы — отдельные диагнозы ведущего. Пакет
894
+ передачи — блок `inputs` (усечённый вопрос, варианты, версия, digest и
895
+ начало ответа до 500 знаков, digests основания). Отчёт — только числа
896
+ (`inputs`): ответ целиком в отчёт не попадает.
897
+
663
898
  ### RunEvent
664
899
 
665
900
  `{apiVersion, seq, at, type, graphId?, workId?, runId?, attempt?, payload}`.
@@ -816,7 +1051,7 @@ data:`), светлая и тёмная схема по `prefers-color-scheme`,
816
1051
  `WorkState.attempt` (сброс возвращает счётчик к 0).
817
1052
  - Корзины отказа попытки (`failureBucketOf`): `defect` (`gate`, `review`,
818
1053
  `scope-violation`), `incomplete` (`empty-result`, `unfinished`,
819
- `needs-lead`), `integration` (`stale-base`, `merge`), `environment`
1054
+ `needs-lead`, `context-exhausted`), `integration` (`stale-base`, `merge`), `environment`
820
1055
  (`environment`, `provider-auth`, `blocked`, истёкшее владение), `time-limit`
821
1056
  (`timeout`), `tool` (`review-protocol`), `operator` (`cancelled`), `budget`,
822
1057
  `unknown`, `unclassified` (попытка без класса — записана до
@@ -1029,6 +1264,34 @@ Markdown хост учитывает, уменьшая `maxBytes`. Маску и
1029
1264
  своих значений хост составляет из `policySecrets(policy, env?)`,
1030
1265
  `redactor` и `composeRedactors` корня пакета.
1031
1266
 
1267
+ **Диагноз по состоянию.** `stopInputsOf(source, { maxAttempts,
1268
+ repairBudget, workId?, workIds? })` из корня пакета (источник тот же —
1269
+ `StopSource`) даёт входы `explainStop` за одно чтение. Без выбора — доска:
1270
+ отменённая работа, которую никто не ждёт, в неё не входит. `workId` — одна
1271
+ работа (её показывает и отменённую). `workIds` — набор: входы каждой работы
1272
+ те же, что у вызова с её `workId` (в том числе отменённой без ждущих), в
1273
+ порядке состояния независимо от порядка в запросе; вход роли controller —
1274
+ первым, запросы ведущему — после работ. Неизвестная работа — `NOT_FOUND`,
1275
+ `workId` вместе с `workIds` — `INVALID_INPUT`, пустой набор — без работ.
1276
+ Общее для работ (прогноз групп, обратные зависимости, запросы, попытки,
1277
+ записи вызовов, статусы бюджетов) читается один раз за вызов: набор и доска
1278
+ линейны по числу работ. Порты хоста по-прежнему спрашиваются о каждой
1279
+ работе: `basis.orderDigest`, `guards.claimable`, `budgets.groupOf` при
1280
+ пределе группы и `budgets.members` для прежних записей вызовов без
1281
+ закреплённой группы (`subjectId` без `groupId`, которые не закрепил
1282
+ `pinLegacyCalls`). Бюджетные блоки многих работ хост получает из
1283
+ `Engine.budgetBlocksOf(workIds | undefined, view)`: за одно чтение, для
1284
+ набора или (без `workIds`) всех работ вида — `Map` работа → причина или
1285
+ `undefined`, по каждой то же, что `budgetBlockOf(workId, view)` на момент
1286
+ вызова. `budgetBlockOf(workId, view, records?)` принимает уже прочитанные
1287
+ записи вызовов, `repairDecision(view, works, { budgetLeft, maxAttempts,
1288
+ blocking? })` — вопрос, держащий работу (по умолчанию `blockingRequest`).
1289
+ `Engine.budgetBlockers(view)` и `Engine.approvalStaleness(view)` —
1290
+ внутренние помощники диагноза: функция, которую они возвращают, считает
1291
+ общее один раз на момент создания (`at` бюджетов фиксирован) и верна
1292
+ только внутри того же чтения; хост их не держит между чтениями и
1293
+ пользуется `budgetBlocksOf` и `stopInputsOf`.
1294
+
1032
1295
  Весь пакет — один снимок хранилища: `handoffPack` выполняет status,
1033
1296
  диагнозы и чтение заданий графов внутри одного `read`
1034
1297
  (`SqliteExecutionStore.read` вложенным чтением использует снимок внешнего,
@@ -1046,6 +1309,7 @@ controller — `next` «ждать до `leaseUntil` или проверить
1046
1309
  | `HostGuards` | `claimable`, `claimBarrier`, `current`, `beforeAccept` — дополнительные запреты хоста в той же транзакции; необязательный `busy(view)` — работы хоста (поставка, preview), которых применение новой политики дожидается так же, как попыток; необязательный `joint(verification, view, kind)` — продуктовые условия совместной проверки в каждой её записи, кроме продления срока |
1047
1310
  | `ContractApprovals` (необязательный `ExecutionHost.contracts`) | `approved({id, digest}, view)` — хост, ведущий согласование контрактов сам, подтверждает редакцию этого digest (`null`) или называет причину; без порта согласованием служит одобренный последний раунд технического ревью этого digest при текущем назначении reviewer. Записи ревью из сведений хоста не создаются |
1048
1311
  | `ExecutionHost.readyAt` (необязательный) | `readyAt(work, view)` — когда поручение стало готово к выдаче (согласовано и дождалось зависимостей) по сведениям хоста; движок пишет его в `wait.readyAt` новой попытки в транзакции выдачи. Нет порта или `undefined` — время неизвестно и не выдумывается |
1312
+ | `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` и раунды ревью плана |
1049
1313
  | `BudgetScopes` | Группа поручения, её состав, атрибуция прежних записей вызовов |
1050
1314
  | `RuntimeAdapter` | `capabilities()`, `invoke(request, signal)`: сессия `fresh` для reviewer и planner (`continue` — только writer той же попытки), JSON Schema ответа, сообщённая модель и версия runtime, usage, диагностика, отмена дерева процессов; необязательный `probe` — сервер проверок reviewer кода (команда, имена переменных окружения, предел команды), адаптер подключает его как MCP-сервер `devcontour_probe` |
1051
1315
  | `WorkSource` | `fetch(ref)` с редакцией; `revision(ref)`; `trusts(prerequisite)`, по умолчанию нет |
@@ -1102,7 +1366,9 @@ git хоста над checkout с чужим кодом (`hostGitArgs`, `assertT
1102
1366
  `binding`, его дополнительные границы — `boundary`), проверка
1103
1367
  переносимого результата (`resultProblems`), классы и правила отказов
1104
1368
  (`BlockedError`, `TaskFailure`, `classifyFailure`, `failureFingerprint`,
1105
- `repairPolicy`, `repairDecision`), раунд технического ревью
1369
+ `repairPolicy`, `repairRepeats` — повторы одного отпечатка с учётом предела
1370
+ окна контекста, `lastContextLimit` — предел последней попытки с отказом,
1371
+ `repairDecision`), раунд технического ревью
1106
1372
  (`technicalReview`), точка сбоя подтверждения корпуса для тестов
1107
1373
  (`caseHooks`). Глубокие импорты `lib/...` не поддерживаются.
1108
1374
 
@@ -1118,12 +1384,12 @@ subjects)`: `subjects.input(kind, id, view)` задаёт digest входа и
1118
1384
  `HarnessError {code, class, message, issues[{path, message}]}`; класс задаёт
1119
1385
  exit code CLI.
1120
1386
 
1121
- | Exit | Класс | Коды |
1122
- | ---- | ---------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
1123
- | 0 | успех | — |
1124
- | 2 | `input` | `INVALID_INPUT`, `UNSUPPORTED_COMMAND`, `UNSUPPORTED_VERSION`, `GRAPH_*`, `GATE_*`, `REVIEWER_*`, `RESPONSE_TOO_LARGE` |
1125
- | 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`, `REVISION_CONFLICT`, `CANCELLED`, `NOT_FOUND`, `PATH_CONFLICT` |
1126
- | 4 | `infrastructure` | `STATE_VERSION_UNSUPPORTED`, `RUNTIME_UNAVAILABLE`, `REVIEW_PROTOCOL_INVALID`, `SANDBOX_UNAVAILABLE`, `GIT_FAILED`, `STORAGE_FAILED`, `DELIVERY_FAILED`, `INTERNAL` |
1387
+ | Exit | Класс | Коды |
1388
+ | ---- | ---------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
1389
+ | 0 | успех | — |
1390
+ | 2 | `input` | `INVALID_INPUT`, `UNSUPPORTED_COMMAND`, `UNSUPPORTED_VERSION`, `GRAPH_*`, `GATE_*`, `REVIEWER_*`, `RESPONSE_TOO_LARGE` |
1391
+ | 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` |
1392
+ | 4 | `infrastructure` | `STATE_VERSION_UNSUPPORTED`, `RUNTIME_UNAVAILABLE`, `REVIEW_PROTOCOL_INVALID`, `SANDBOX_UNAVAILABLE`, `GIT_FAILED`, `STORAGE_FAILED`, `DELIVERY_FAILED`, `INTERNAL` |
1127
1393
 
1128
1394
  Exit 1 не используется: им Node завершает процесс при необработанном
1129
1395
  исключении.
@@ -1167,33 +1433,41 @@ stdout — один JSON `CliEnvelope`: `{apiVersion, command, ok: true, data}`
1167
1433
  читающие на отсутствующем каталоге отвечают `NOT_FOUND` и ничего не создают.
1168
1434
  Бинарник не хранит настроек проекта и не помнит «последний активный проект».
1169
1435
 
1170
- | Команда | Аргументы | Пишет | `data` | Повтор |
1171
- | ------------------ | --------------------------------------------------------------------------------------------------------- | ----- | ---------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------ |
1172
- | `validate` | `--graph F --policy F [--context F]` | нет | digests, число поручений | Чистая функция входов |
1173
- | `review-plan` | `--state D --graph F --policy F --author A [--context F]` | да | `ReviewRecord` | Тот же digest и автор, уже согласованные, — тот же раунд без вызова модели; автор, не допускаемый правилом вендора, — `REVIEWER_SAME_VENDOR` до вызова |
1174
- | `review-contract` | `--state D --contract F --policy F --author A` | да | `ReviewRecord` | Как `review-plan` |
1175
- | `approve` | `--state D --subject ID --digest H` | да | subject, digest, at | Тот же digest — без изменений; только `approvalMode: operator` |
1176
- | `run` | `--state D --graph F --policy F [--context F] [--sink file:D] [--once]` | да | граф, поручения и их блокеры, задание `workflow` | Та же редакция продолжает работу; другой digest той же редакции — `REVISION_CONFLICT` |
1177
- | `status` | `--state D [--graph ID] [--detail]` | нет | очередь, графы, поручения с блокерами, бюджеты; с `--detail` — `detail` | Только чтение |
1178
- | `events` | `--state D [--after N] [--limit 1–500]` | нет | события (неизвестный тип — `unknown`), `next` | Только чтение |
1179
- | `pause` | `--state D` | да | `ControlState` | Без изменений |
1180
- | `resume` | `--state D` | да | `ControlState` | Решение человека: снимает паузу оператора, штатной остановки и отказа runtime вместе с её классами; паузу операции reconfigure — `PAUSED` |
1181
- | `cancel` | `--state D --work ID [--reason T]` | да | статус поручения | Отменённое — без изменений; это не retry |
1182
- | `retry` | `--state D --work ID [--reset --reason T]` | да | статус поручения | В пределах `maxAttempts` и бюджета; `--reset` с причиной сбрасывает счётчик попыток, но не учёт расходов |
1183
- | `result` | `--state D --work ID` | нет | `ResultEnvelope` | Только чтение |
1184
- | `deliver` | `--state D --work ID --sink file:D` | да | `ResultEnvelope` | Доставленное не доставляется повторно; моделей и интеграции нет |
1185
- | `cleanup` | `--state D --run ID` | да | исход очистки попытки |
1186
- | `worktree-cleanup` | `--state D [--dry-run]` | да | счётчики и `worktrees[]` с действием и причиной отказа |
1187
- | `profile` | `--profile ID\|./F [--repository D]` | нет | закрепление (`pin`) и разрешённый профиль | Чистая функция файлов профиля; команды проекта не исполняются |
1188
- | `doctor` | `[--state D] [--policy F]` | нет | версии, runtime, sandbox, совместимость состояния и версии движка в нём | Без live-вызова модели |
1189
- | `init` | `--repository D [--profile P] [--writer R] [--state D] [--plan]` | да | план файлов, `created`, `manifest`, `facts`, `toolchain`, `next` | Create-only `.harness/`, manifest до политики, политика последней; повтор — `created: []`; иное решение — `PATH_CONFLICT` |
1190
- | `explain` | `--state D --policy F [--work ID]` | нет | `diagnoses[]` (`StopDiagnosis`) | Только чтение: без повторов, вызовов моделей и изменений состояния |
1191
- | `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}` | Только чтение; те же данные и параметры — те же байты |
1192
- | `handoff` | `--state D [--graph ID] [--intent T]… [--format json\|md]` | нет | `HandoffPack`; с `--format md` — Markdown без конверта | Только чтение; агент добавляет только намерения |
1193
- | `plan-request` | `--brief F --policy F [--context F] [--contracts D] [--requirements [R:]F]… [--human]` | нет | `prompt`, `readOnly`, `recommendedTasks`, `maxTasks`, `basis`, `facts` (`PlanningFacts`) | Чистая функция входов: та же постановка и те же факты — тот же prompt и `basis`; модель не вызывается |
1194
- | `plan-check` | `--draft F --policy F [--context F] [--contracts D] [--brief F [--basis H]]` | нет | `issues`, `checkPlan`; без проблем — `graph`, `graphDigest`, `basis` | Чистая функция входов и `HEAD` источников требований; согласования не выдаёт, gates не запускает; расхождение `--basis` — `APPROVAL_STALE` |
1195
- | `capabilities` | — | нет | каталог общих операций (`OperationCatalog`) | Чистая функция установленной версии пакета |
1196
- | `--version` | — | нет | версия пакета и API | — |
1436
+ | Команда | Аргументы | Пишет | `data` | Повтор |
1437
+ | ------------------ | ---------------------------------------------------------------------------------------------------------- | ----- | ---------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------ |
1438
+ | `validate` | `--graph F --policy F [--context F]` | нет | digests, число поручений | Чистая функция входов |
1439
+ | `review-plan` | `--state D --graph F --policy F --author A [--context F]` | да | `ReviewRecord` | Тот же digest и автор, уже согласованные, — тот же раунд без вызова модели; автор, не допускаемый правилом вендора, — `REVIEWER_SAME_VENDOR` до вызова |
1440
+ | `review-contract` | `--state D --contract F --policy F --author A` | да | `ReviewRecord` | Как `review-plan` |
1441
+ | `approve` | `--state D --subject ID --digest H` | да | subject, digest, at | Тот же digest — без изменений; только `approvalMode: operator` |
1442
+ | `run` | `--state D --graph F --policy F [--context F] [--sink file:D] [--once]` | да | граф, поручения и их блокеры, задание `workflow` | Та же редакция продолжает работу; другой digest той же редакции — `REVISION_CONFLICT` |
1443
+ | `status` | `--state D [--graph ID] [--detail]` | нет | очередь, графы, поручения с блокерами, бюджеты; с `--detail` — `detail` | Только чтение |
1444
+ | `events` | `--state D [--after N] [--limit 1–500]` | нет | события (неизвестный тип — `unknown`), `next` | Только чтение |
1445
+ | `pause` | `--state D` | да | `ControlState` | Без изменений |
1446
+ | `resume` | `--state D` | да | `ControlState` | Решение человека: снимает паузу оператора, штатной остановки и отказа runtime вместе с её классами; паузу операции reconfigure — `PAUSED` |
1447
+ | `cancel` | `--state D --work ID [--reason T]` | да | статус поручения | Отменённое — без изменений; это не retry |
1448
+ | `retry` | `--state D --work ID [--reset --reason T]` | да | статус поручения | В пределах `maxAttempts` и бюджета; `--reset` с причиной сбрасывает счётчик попыток, но не учёт расходов |
1449
+ | `result` | `--state D --work ID` | нет | `ResultEnvelope` | Только чтение |
1450
+ | `deliver` | `--state D --work ID --sink file:D` | да | `ResultEnvelope` | Доставленное не доставляется повторно; моделей и интеграции нет |
1451
+ | `cleanup` | `--state D --run ID` | да | исход очистки попытки |
1452
+ | `worktree-cleanup` | `--state D [--dry-run]` | да | счётчики и `worktrees[]` с действием и причиной отказа |
1453
+ | `profile` | `--profile ID\|./F [--repository D]` | нет | закрепление (`pin`) и разрешённый профиль | Чистая функция файлов профиля; команды проекта не исполняются |
1454
+ | `doctor` | `[--state D] [--policy F]` | нет | версии, runtime, sandbox, совместимость состояния и версии движка в нём | Без live-вызова модели |
1455
+ | `init` | `--repository D [--profile P] [--writer R] [--state D] [--plan]` | да | план файлов, `created`, `manifest`, `facts`, `toolchain`, `next` | Create-only `.harness/`, manifest до политики, политика последней; повтор — `created: []`; иное решение — `PATH_CONFLICT` |
1456
+ | `explain` | `--state D --policy F [--work ID]` | нет | `diagnoses[]` (`StopDiagnosis`) | Только чтение: без повторов, вызовов моделей и изменений состояния |
1457
+ | `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}` | Только чтение; те же данные и параметры — те же байты |
1458
+ | `handoff` | `--state D [--graph ID] [--intent T]… [--format json\|md]` | нет | `HandoffPack`; с `--format md` — Markdown без конверта | Только чтение; агент добавляет только намерения |
1459
+ | `plan-request` | `--brief F --policy F [--context F] [--contracts D] [--requirements [R:]F]… [--human]` | нет | `prompt`, `readOnly`, `recommendedTasks`, `maxTasks`, `basis`, `facts` (`PlanningFacts`) | Чистая функция входов: та же постановка и те же факты — тот же prompt и `basis`; модель не вызывается |
1460
+ | `plan-check` | `--draft F --policy F [--context F] [--contracts D] [--brief F [--basis H]]` | нет | `issues`, `checkPlan`; без проблем — `graph`, `graphDigest`, `basis` | Чистая функция входов и `HEAD` источников требований; согласования не выдаёт, gates не запускает; расхождение `--basis` — `APPROVAL_STALE` |
1461
+ | `input-list` | `--state D [--work ID]` | нет | запросы: ID, поручение, вид, состояние, серьёзность, версия — без текста | Только чтение |
1462
+ | `input-show` | `--state D --request ID` | нет | `InputRequest` | Только чтение |
1463
+ | `input-answer` | `--state D --request ID --text T [--option ID] [--kind K] [--actor A] --request-version N` | да | запрос, ответ, `changed` | Тот же текст, вариант и вид — прежний ответ; иначе новая версия при совпадении версии (CAS) |
1464
+ | `input-context` | `--state D --request ID --out F` | да | `requestId`, `answerDigest`, `digest`, `out` | Тот же ответ и тот же действующий снимок — тот же digest; снимок не активируется |
1465
+ | `input-target` | `--state D --request ID --context-digest H` | нет | основание продолжения и `problems` | Только чтение |
1466
+ | `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, запрос прежний |
1467
+ | `input-cancel` | `--state D --request ID --request-version N --reason T` | да | `lifecycle`, `version`, `changed` | Отменённый — без изменений |
1468
+ | `input-supersede` | `--state D --request ID --request-version N --reason T --successor ID` | да | `lifecycle`, `version`, `changed` | Заменённый — без изменений |
1469
+ | `capabilities` | — | нет | каталог общих операций (`OperationCatalog`) | Чистая функция установленной версии пакета |
1470
+ | `--version` | — | нет | версия пакета и API | — |
1197
1471
 
1198
1472
  Полная форма каждой команды — `cliCommands` (аргументы, обязательность,
1199
1473
  идемпотентность, отказы exit 3). Все команды реализованы. `run` принимает `--author` (по умолчанию `external`) — автора графа для ревью плана. `HARNESS_CODEX_BIN` и `HARNESS_CLAUDE_BIN` подменяют исполняемые файлы runtime (fixture executables в тестах).
@@ -0,0 +1,27 @@
1
+ # devcontour-harness 0.1.0-alpha.35
2
+
3
+ Нехватка окна контекста claude — свой класс отказа `context-exhausted`
4
+ вместо `unknown`: короткая политика повторов, собственный код остановки и
5
+ понятная причина. `stateVersion` и `policyVersion` прежние.
6
+
7
+ ## Изменения
8
+
9
+ - **Класс отказа.** `context-exhausted` распознаётся по `terminal_reason`
10
+ результата claude. `prompt_too_long` на первом ходе (`num_turns` ≤ 1) —
11
+ `contextLimit: prompt-too-long`, без повтора: поручение не помещается в
12
+ окно, повтор того же входа бесполезен. `blocking_limit` или переполнение
13
+ после ходов работы — `blocking-limit`, один повтор. Попытка засчитывается.
14
+ - **Остановка.** Код `CONTEXT_EXHAUSTED` (класс `refused`, exit code 3) в
15
+ `stopReason`, `explain` и пакете передачи; в отчёте — корзина `incomplete`.
16
+ Сообщение стабильное; подсказка о сокращении поручения — только у writer.
17
+ - **API.** `repairRepeats` и `lastContextLimit` экспортированы рядом с
18
+ `repairPolicy`; порт runtime получил необязательное
19
+ `RuntimeResponse.diagnostics.contextExhausted`.
20
+
21
+ ## Обновление
22
+
23
+ Новые значения аддитивны, но документ состояния разбирается строго:
24
+ alpha.34 и ниже не читают состояние с отказом `context-exhausted`. Откат —
25
+ вместе с копией каталога состояния, снятой до обновления. Строгие внешние
26
+ валидаторы `RunResult`, отчёта, пакета передачи и диагноза остановки
27
+ обновляются вместе с harness. Подробнее — `docs/upgrade.md`.
@@ -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`.