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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (116) hide show
  1. package/README.md +16 -2
  2. package/docs/contracts.md +261 -33
  3. package/docs/release-notes/0.1.0-alpha.36.md +26 -0
  4. package/docs/release-notes/0.1.0-alpha.37.md +40 -0
  5. package/docs/standalone.md +20 -0
  6. package/docs/toolchains.md +57 -2
  7. package/docs/upgrade.md +108 -0
  8. package/lib/agents/schemas.d.ts +84 -2
  9. package/lib/agents/schemas.js +49 -1
  10. package/lib/cli.js +149 -1
  11. package/lib/contracts/cli.d.ts +1495 -170
  12. package/lib/contracts/cli.js +232 -2
  13. package/lib/contracts/diagnosis.d.ts +8 -4
  14. package/lib/contracts/diagnosis.js +3 -0
  15. package/lib/contracts/errors.d.ts +7 -1
  16. package/lib/contracts/errors.js +6 -0
  17. package/lib/contracts/events.d.ts +453 -60
  18. package/lib/contracts/events.js +79 -0
  19. package/lib/contracts/execution.d.ts +270 -50
  20. package/lib/contracts/execution.js +41 -0
  21. package/lib/contracts/failure.d.ts +14 -1
  22. package/lib/contracts/failure.js +9 -1
  23. package/lib/contracts/handoff.d.ts +70 -20
  24. package/lib/contracts/handoff.js +42 -1
  25. package/lib/contracts/index.d.ts +1 -0
  26. package/lib/contracts/index.js +1 -0
  27. package/lib/contracts/input-state.d.ts +13 -0
  28. package/lib/contracts/input-state.js +32 -0
  29. package/lib/contracts/input.d.ts +442 -0
  30. package/lib/contracts/input.js +321 -0
  31. package/lib/contracts/planning.d.ts +2 -0
  32. package/lib/contracts/policy.d.ts +17 -2
  33. package/lib/contracts/policy.js +31 -2
  34. package/lib/contracts/ports.d.ts +54 -0
  35. package/lib/contracts/project.d.ts +127 -0
  36. package/lib/contracts/project.js +99 -0
  37. package/lib/contracts/published.d.ts +603 -92
  38. package/lib/contracts/published.js +4 -1
  39. package/lib/contracts/repair-policy.d.ts +20 -0
  40. package/lib/contracts/repair-policy.js +34 -0
  41. package/lib/contracts/report.d.ts +53 -21
  42. package/lib/contracts/report.js +33 -2
  43. package/lib/contracts/result.d.ts +26 -24
  44. package/lib/contracts/review.d.ts +47 -8
  45. package/lib/contracts/review.js +21 -1
  46. package/lib/control/harness.d.ts +2555 -51
  47. package/lib/control/harness.js +112 -6
  48. package/lib/control/recovery.d.ts +2 -2
  49. package/lib/control/report.js +1 -0
  50. package/lib/control/status.d.ts +30 -22
  51. package/lib/control/status.js +11 -1
  52. package/lib/control/workflow.d.ts +8 -8
  53. package/lib/engine/budget.d.ts +86 -3
  54. package/lib/engine/budget.js +45 -10
  55. package/lib/engine/engine.d.ts +3091 -85
  56. package/lib/engine/engine.js +1206 -101
  57. package/lib/engine/input-policy.d.ts +68 -0
  58. package/lib/engine/input-policy.js +285 -0
  59. package/lib/engine/input-requests.d.ts +64 -0
  60. package/lib/engine/input-requests.js +187 -0
  61. package/lib/engine/measured.d.ts +6 -1
  62. package/lib/engine/measured.js +12 -1
  63. package/lib/engine/prompt.d.ts +4 -2
  64. package/lib/engine/prompt.js +3 -1
  65. package/lib/engine/property-recovery.js +2 -0
  66. package/lib/engine/repair.d.ts +2 -0
  67. package/lib/engine/repair.js +10 -3
  68. package/lib/engine/runner.d.ts +33 -4
  69. package/lib/engine/runner.js +266 -23
  70. package/lib/environment/lifecycle.d.ts +8 -0
  71. package/lib/environment/lifecycle.js +15 -2
  72. package/lib/explain/state.d.ts +16 -2
  73. package/lib/explain/state.js +254 -77
  74. package/lib/handoff/markdown.js +10 -0
  75. package/lib/handoff/pack.js +42 -1
  76. package/lib/index.d.ts +10 -0
  77. package/lib/index.js +10 -0
  78. package/lib/init/inspect.d.ts +34 -0
  79. package/lib/init/inspect.js +292 -0
  80. package/lib/init/project.js +14 -31
  81. package/lib/integrations/connector/commands.d.ts +12 -12
  82. package/lib/integrations/connector/config.d.ts +4 -4
  83. package/lib/integrations/connector/delivery.d.ts +1 -1
  84. package/lib/integrations/relay-v2/protocol.d.ts +4 -4
  85. package/lib/profiles/resolve.d.ts +2 -1
  86. package/lib/projections/enums.d.ts +1 -1
  87. package/lib/projections/enums.js +4 -0
  88. package/lib/projections/index.d.ts +1 -0
  89. package/lib/projections/index.js +1 -0
  90. package/lib/projections/input.d.ts +17 -0
  91. package/lib/projections/input.js +28 -0
  92. package/lib/projections/stop.d.ts +40 -1
  93. package/lib/projections/stop.js +87 -4
  94. package/lib/report/compute.d.ts +4 -1
  95. package/lib/report/compute.js +25 -0
  96. package/lib/report/document.js +1 -0
  97. package/lib/storage/document.d.ts +66 -28
  98. package/lib/testing/index.d.ts +1 -1
  99. package/lib/testing/index.js +1 -1
  100. package/lib/testing/store-contract.d.ts +8 -1
  101. package/lib/testing/store-contract.js +194 -1
  102. package/lib/verification/confirm.d.ts +3 -3
  103. package/lib/verification/corpus.d.ts +9 -9
  104. package/lib/verification/gates.d.ts +119 -0
  105. package/lib/verification/gates.js +311 -4
  106. package/package.json +1 -1
  107. package/schemas/execution-document.schema.json +130 -0
  108. package/schemas/execution-policy.schema.json +26 -0
  109. package/schemas/handoff-pack.schema.json +146 -4
  110. package/schemas/input-request.schema.json +665 -0
  111. package/schemas/project-facts.schema.json +393 -0
  112. package/schemas/result-envelope.schema.json +1 -0
  113. package/schemas/run-event.schema.json +625 -0
  114. package/schemas/run-result.schema.json +1 -0
  115. package/schemas/stop-diagnosis.schema.json +5 -1
  116. package/schemas/value-report.schema.json +78 -7
package/README.md CHANGED
@@ -5,7 +5,7 @@ Headless-движок исполнения инженерных поручени
5
5
  интеграция с принятой веткой через compare-and-swap и машинный результат с SHA
6
6
  и доказательствами.
7
7
 
8
- > Статус: `0.1.0-alpha.35` — предварительный выпуск (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.35 # точная версия
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,19 @@ 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
+
151
165
  ## Выпуск 0.1.0-alpha.35
152
166
 
153
167
  Нехватка окна контекста claude — отдельный класс отказа `context-exhausted`
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`,
@@ -704,6 +709,192 @@ fencing; само состояние между переходами не пер
704
709
  переиспользуется (`reusableFailures`). Причина `attempt.diagnosed` — `none`,
705
710
  `counted: true`.
706
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
+
707
898
  ### RunEvent
708
899
 
709
900
  `{apiVersion, seq, at, type, graphId?, workId?, runId?, attempt?, payload}`.
@@ -1073,6 +1264,34 @@ Markdown хост учитывает, уменьшая `maxBytes`. Маску и
1073
1264
  своих значений хост составляет из `policySecrets(policy, env?)`,
1074
1265
  `redactor` и `composeRedactors` корня пакета.
1075
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
+
1076
1295
  Весь пакет — один снимок хранилища: `handoffPack` выполняет status,
1077
1296
  диагнозы и чтение заданий графов внутри одного `read`
1078
1297
  (`SqliteExecutionStore.read` вложенным чтением использует снимок внешнего,
@@ -1090,6 +1309,7 @@ controller — `next` «ждать до `leaseUntil` или проверить
1090
1309
  | `HostGuards` | `claimable`, `claimBarrier`, `current`, `beforeAccept` — дополнительные запреты хоста в той же транзакции; необязательный `busy(view)` — работы хоста (поставка, preview), которых применение новой политики дожидается так же, как попыток; необязательный `joint(verification, view, kind)` — продуктовые условия совместной проверки в каждой её записи, кроме продления срока |
1091
1310
  | `ContractApprovals` (необязательный `ExecutionHost.contracts`) | `approved({id, digest}, view)` — хост, ведущий согласование контрактов сам, подтверждает редакцию этого digest (`null`) или называет причину; без порта согласованием служит одобренный последний раунд технического ревью этого digest при текущем назначении reviewer. Записи ревью из сведений хоста не создаются |
1092
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` и раунды ревью плана |
1093
1313
  | `BudgetScopes` | Группа поручения, её состав, атрибуция прежних записей вызовов |
1094
1314
  | `RuntimeAdapter` | `capabilities()`, `invoke(request, signal)`: сессия `fresh` для reviewer и planner (`continue` — только writer той же попытки), JSON Schema ответа, сообщённая модель и версия runtime, usage, диагностика, отмена дерева процессов; необязательный `probe` — сервер проверок reviewer кода (команда, имена переменных окружения, предел команды), адаптер подключает его как MCP-сервер `devcontour_probe` |
1095
1315
  | `WorkSource` | `fetch(ref)` с редакцией; `revision(ref)`; `trusts(prerequisite)`, по умолчанию нет |
@@ -1164,12 +1384,12 @@ subjects)`: `subjects.input(kind, id, view)` задаёт digest входа и
1164
1384
  `HarnessError {code, class, message, issues[{path, message}]}`; класс задаёт
1165
1385
  exit code CLI.
1166
1386
 
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` |
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` |
1173
1393
 
1174
1394
  Exit 1 не используется: им Node завершает процесс при необработанном
1175
1395
  исключении.
@@ -1213,33 +1433,41 @@ stdout — один JSON `CliEnvelope`: `{apiVersion, command, ok: true, data}`
1213
1433
  читающие на отсутствующем каталоге отвечают `NOT_FOUND` и ничего не создают.
1214
1434
  Бинарник не хранит настроек проекта и не помнит «последний активный проект».
1215
1435
 
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 | — |
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 | — |
1243
1471
 
1244
1472
  Полная форма каждой команды — `cliCommands` (аргументы, обязательность,
1245
1473
  идемпотентность, отказы 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`.
@@ -109,6 +109,26 @@ realpath корня, поэтому повтор и новая сессия на
109
109
  дописывает недостающее; `status: complete` — только при валидных manifest и
110
110
  политике.
111
111
 
112
+ ## Факты репозитория без записи
113
+
114
+ `inspectProject({ repository })` из корня пакета — библиотечная инспекция до
115
+ любой подготовки (схема `project-facts`): Git-корень, вид worktree, base SHA,
116
+ ветка, незакоммиченные изменения, их число (`changeCount`) и первые 50 путей; lockfiles корня и менеджер пакетов
117
+ (`detected`, `ambiguous`, `none`) с полем `packageManager`; подходящие
118
+ встроенные профили с digest; scripts корневого `package.json` и похожие на
119
+ проверки (`checks`); версии git, node и менеджера с требуемой версией и её
120
+ источником; наличие CLI `claude`/`codex` — `available`, `missing` или
121
+ `version-error`, авторизация всегда `unknown`. `diagnostics` — коды с
122
+ `severity` (`blocker`, `warning`, `info`), текстом и следующим действием;
123
+ `ready` — нет блокирующих.
124
+
125
+ Инспекция ничего не создаёт (`.harness`, state, refs, индекс Git), не
126
+ исполняет scripts манифестов и не вызывает модели: единственные процессы —
127
+ Git без optional locks и пробы `--version` во временном каталоге. Маркеры
128
+ DevContour и готовый `.harness/` — факты (`info`), а не отказ. `init`
129
+ определяет корень и профиль тем же алгоритмом; хост применяет к фактам свои
130
+ правила размещения.
131
+
112
132
  ## Планирование
113
133
 
114
134
  План составляет сам ведущий агент: отдельная модель-планировщик не