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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (129) hide show
  1. package/README.md +56 -2
  2. package/docs/architecture.md +28 -4
  3. package/docs/contracts.md +294 -51
  4. package/docs/release-notes/0.1.0-alpha.36.md +26 -0
  5. package/docs/release-notes/0.1.0-alpha.37.md +40 -0
  6. package/docs/release-notes/0.1.0-alpha.38.md +31 -0
  7. package/docs/release-notes/0.1.0-alpha.39.md +38 -0
  8. package/docs/release-notes/0.1.0-alpha.40.md +27 -0
  9. package/docs/release-notes/0.1.0-alpha.41.md +49 -0
  10. package/docs/release-notes/0.1.0-alpha.42.md +44 -0
  11. package/docs/standalone.md +20 -0
  12. package/docs/toolchains.md +57 -2
  13. package/docs/upgrade.md +240 -0
  14. package/lib/agents/review-probe.d.ts +3 -1
  15. package/lib/agents/review-probe.js +8 -4
  16. package/lib/agents/schemas.d.ts +84 -2
  17. package/lib/agents/schemas.js +49 -1
  18. package/lib/cli.js +149 -1
  19. package/lib/contracts/cli.d.ts +1495 -170
  20. package/lib/contracts/cli.js +232 -2
  21. package/lib/contracts/diagnosis.d.ts +8 -4
  22. package/lib/contracts/diagnosis.js +3 -0
  23. package/lib/contracts/errors.d.ts +7 -1
  24. package/lib/contracts/errors.js +6 -0
  25. package/lib/contracts/events.d.ts +453 -60
  26. package/lib/contracts/events.js +79 -0
  27. package/lib/contracts/execution.d.ts +270 -50
  28. package/lib/contracts/execution.js +45 -3
  29. package/lib/contracts/failure.d.ts +14 -1
  30. package/lib/contracts/failure.js +9 -1
  31. package/lib/contracts/handoff.d.ts +70 -20
  32. package/lib/contracts/handoff.js +42 -1
  33. package/lib/contracts/index.d.ts +1 -0
  34. package/lib/contracts/index.js +1 -0
  35. package/lib/contracts/input-state.d.ts +13 -0
  36. package/lib/contracts/input-state.js +32 -0
  37. package/lib/contracts/input.d.ts +442 -0
  38. package/lib/contracts/input.js +321 -0
  39. package/lib/contracts/planning.d.ts +2 -0
  40. package/lib/contracts/policy.d.ts +36 -2
  41. package/lib/contracts/policy.js +61 -2
  42. package/lib/contracts/ports.d.ts +54 -0
  43. package/lib/contracts/project.d.ts +127 -0
  44. package/lib/contracts/project.js +99 -0
  45. package/lib/contracts/published.d.ts +604 -92
  46. package/lib/contracts/published.js +4 -1
  47. package/lib/contracts/repair-policy.d.ts +20 -0
  48. package/lib/contracts/repair-policy.js +34 -0
  49. package/lib/contracts/report.d.ts +53 -21
  50. package/lib/contracts/report.js +33 -2
  51. package/lib/contracts/result.d.ts +26 -24
  52. package/lib/contracts/review.d.ts +47 -8
  53. package/lib/contracts/review.js +21 -1
  54. package/lib/control/harness.d.ts +2555 -51
  55. package/lib/control/harness.js +112 -6
  56. package/lib/control/recovery.d.ts +2 -2
  57. package/lib/control/report.js +1 -0
  58. package/lib/control/status.d.ts +30 -22
  59. package/lib/control/status.js +11 -1
  60. package/lib/control/workflow.d.ts +8 -8
  61. package/lib/engine/budget.d.ts +86 -3
  62. package/lib/engine/budget.js +45 -10
  63. package/lib/engine/engine.d.ts +3091 -85
  64. package/lib/engine/engine.js +1229 -106
  65. package/lib/engine/input-policy.d.ts +68 -0
  66. package/lib/engine/input-policy.js +285 -0
  67. package/lib/engine/input-requests.d.ts +64 -0
  68. package/lib/engine/input-requests.js +187 -0
  69. package/lib/engine/joint-runner.js +2 -2
  70. package/lib/engine/measured.d.ts +6 -1
  71. package/lib/engine/measured.js +12 -1
  72. package/lib/engine/prompt.d.ts +4 -2
  73. package/lib/engine/prompt.js +3 -1
  74. package/lib/engine/property-recovery.js +2 -0
  75. package/lib/engine/repair.d.ts +2 -0
  76. package/lib/engine/repair.js +10 -3
  77. package/lib/engine/runner.d.ts +44 -4
  78. package/lib/engine/runner.js +347 -35
  79. package/lib/environment/isolation.d.ts +41 -1
  80. package/lib/environment/isolation.js +167 -5
  81. package/lib/environment/lifecycle.d.ts +54 -2
  82. package/lib/environment/lifecycle.js +96 -4
  83. package/lib/explain/state.d.ts +16 -2
  84. package/lib/explain/state.js +254 -77
  85. package/lib/handoff/markdown.js +10 -0
  86. package/lib/handoff/pack.js +42 -1
  87. package/lib/index.d.ts +10 -0
  88. package/lib/index.js +10 -0
  89. package/lib/init/inspect.d.ts +34 -0
  90. package/lib/init/inspect.js +292 -0
  91. package/lib/init/project.js +14 -31
  92. package/lib/integrations/connector/commands.d.ts +12 -12
  93. package/lib/integrations/connector/config.d.ts +4 -4
  94. package/lib/integrations/connector/delivery.d.ts +1 -1
  95. package/lib/integrations/relay-v2/protocol.d.ts +4 -4
  96. package/lib/profiles/resolve.d.ts +2 -1
  97. package/lib/projections/enums.d.ts +1 -1
  98. package/lib/projections/enums.js +4 -0
  99. package/lib/projections/index.d.ts +1 -0
  100. package/lib/projections/index.js +1 -0
  101. package/lib/projections/input.d.ts +17 -0
  102. package/lib/projections/input.js +28 -0
  103. package/lib/projections/stop.d.ts +40 -1
  104. package/lib/projections/stop.js +87 -4
  105. package/lib/report/compute.d.ts +4 -1
  106. package/lib/report/compute.js +41 -6
  107. package/lib/report/document.js +3 -2
  108. package/lib/storage/document.d.ts +66 -28
  109. package/lib/testing/index.d.ts +1 -1
  110. package/lib/testing/index.js +1 -1
  111. package/lib/testing/store-contract.d.ts +8 -1
  112. package/lib/testing/store-contract.js +194 -1
  113. package/lib/verification/confirm.d.ts +3 -3
  114. package/lib/verification/confirm.js +6 -4
  115. package/lib/verification/corpus.d.ts +9 -9
  116. package/lib/verification/gates-at.js +3 -1
  117. package/lib/verification/gates.d.ts +154 -1
  118. package/lib/verification/gates.js +378 -11
  119. package/package.json +1 -1
  120. package/schemas/execution-document.schema.json +130 -0
  121. package/schemas/execution-policy.schema.json +31 -0
  122. package/schemas/handoff-pack.schema.json +146 -4
  123. package/schemas/input-request.schema.json +665 -0
  124. package/schemas/project-facts.schema.json +393 -0
  125. package/schemas/result-envelope.schema.json +1 -0
  126. package/schemas/run-event.schema.json +625 -0
  127. package/schemas/run-result.schema.json +1 -0
  128. package/schemas/stop-diagnosis.schema.json +5 -1
  129. package/schemas/value-report.schema.json +78 -7
package/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.42` — предварительный выпуск (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.42 # точная версия
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,59 @@ PASS» нет. Адаптеры хоста реализуют порты `Execut
148
149
  `devcontour-harness/schemas/<имя>.schema.json`. Декларации используют типы
149
150
  Node.js: TypeScript-потребителю нужен `@types/node` (или `skipLibCheck`).
150
151
 
152
+ ## Выпуск 0.1.0-alpha.42
153
+
154
+ Подготовка фазы (lifecycle, хранилище зависимостей, `prepare`), изменившая
155
+ конфигурацию IDE, агента, shell или корневого git в дереве, — отказ с
156
+ причиной `sandbox-policy` вместо молчаливого прохода; вложенные `.git`
157
+ (подмодули, клоны зависимостей) подготовке разрешены и принадлежат ей. Отказ
158
+ песочницы в удалении закреплённого каталога — отказ окружения, только когда
159
+ EPERM и путь названы отдельным словом в одной строке вывода. Подробно —
160
+ [заметки выпуска](docs/release-notes/0.1.0-alpha.42.md).
161
+
162
+ ## Выпуск 0.1.0-alpha.41
163
+
164
+ Gate может удалить и переименовать прежний вывод в своём worktree под
165
+ песочницей macOS; gate кандидата, исчерпавший предел времени под высокой
166
+ нагрузкой хоста, повторяется один раз на том же SHA. Подробно —
167
+ [заметки выпуска](docs/release-notes/0.1.0-alpha.41.md).
168
+
169
+ ## Выпуск 0.1.0-alpha.40
170
+
171
+ Проверки reviewer при ревью интеграции сравнивают входы установки
172
+ зависимостей с target, на который сделано слияние, — той же базой, что
173
+ называет запрос reviewer. Подробно —
174
+ [заметки выпуска](docs/release-notes/0.1.0-alpha.40.md).
175
+
176
+ ## Выпуск 0.1.0-alpha.39
177
+
178
+ Ревью интеграции сравнивает с актуальным target, а не с базой попытки, и не
179
+ видит чужую уже принятую работу. Необязательное поле политики
180
+ `gateTimeoutFloorMs` поднимает короткие пределы gates. Интеграция без
181
+ слияния кандидата с target отказывает явно. Подробно —
182
+ [заметки выпуска](docs/release-notes/0.1.0-alpha.39.md).
183
+
184
+ ## Выпуск 0.1.0-alpha.38
185
+
186
+ Остановка вопросом исполнителя (`needs-input`) больше не тратит попытку:
187
+ ответ на вопрос последней попытки применяется без сброса. Таких остановок у
188
+ поручения — не больше `maxAttempts`; следующие засчитываются как обычные
189
+ попытки, поэтому цикл вопросов ограничен. Подробно —
190
+ [заметки выпуска](docs/release-notes/0.1.0-alpha.38.md).
191
+
192
+ ## Выпуск 0.1.0-alpha.37
193
+
194
+ Вопрос исполнителя (`inputRequest`, политика `inputPolicy`, ответ с ревью
195
+ контекста и переносом в новую редакцию) и диагностика остановок для многих
196
+ работ за одно чтение (`workIds`, `budgetBlocksOf`). Подробно —
197
+ [заметки выпуска](docs/release-notes/0.1.0-alpha.37.md).
198
+
199
+ ## Выпуск 0.1.0-alpha.36
200
+
201
+ Факты проекта только для чтения (`inspectProject`, договор `project-facts`) и
202
+ установка зависимостей исполнителя до его запуска. Подробно —
203
+ [заметки выпуска](docs/release-notes/0.1.0-alpha.36.md).
204
+
151
205
  ## Выпуск 0.1.0-alpha.35
152
206
 
153
207
  Нехватка окна контекста claude — отдельный класс отказа `context-exhausted`
@@ -624,6 +624,17 @@ executable. Live smoke — отдельный opt-in с явно заданны
624
624
  Провал, в отчёте которого названо проваленное свойство или случай корпуса,
625
625
  не повторяется: это найденный контрпример, и удачный второй запуск
626
626
  недетерминированной проверки его не отменяет.
627
+ - **Повтор таймаута кандидата под нагрузкой.** Gate кандидата, исчерпавший
628
+ свой предел времени (не отмена попытки), когда средняя нагрузка хоста за
629
+ минуту не ниже 2 на ядро (`HOST_LOAD_RECHECK_PER_CPU`; меньшая из снятых до
630
+ запуска gate и в момент таймаута), controller один раз
631
+ на попытку повторяет на том же candidate SHA. Нагрузка названа в сводке
632
+ записи. Повтор прошёл — `recheck.outcome: flaky`, попытка не тратится;
633
+ снова таймаут или другой провал — `confirmed`, отказ `gate` засчитывается
634
+ как прежде. Таймаут на свободной машине, провал, записанный в JUnit или
635
+ отчёт свойств до таймаута, и прочие провалы кандидата не повторяются. Лог — в `candidate/recheck/`, замер — стадия
636
+ `candidate-recheck:<gate>`. У каждой фазы попытки свой единственный повтор:
637
+ повтор кандидата бюджет повтора интеграции не тратит.
627
638
  - **Атомарная приёмка.** Продвижение target ref — compare-and-swap внутри
628
639
  транзакции приёмки. Чужой коммит в target ref не теряется: попытка начнётся
629
640
  от новой базы. Падение между update-ref и записью принятия восстанавливается
@@ -664,10 +675,23 @@ executable. Live smoke — отдельный opt-in с явно заданны
664
675
  операции: каталог, собранный в `node_modules` и перенесённый в дерево
665
676
  проекта, ими не закрыт. До и после каждого gate и вокруг работы исполнителя
666
677
  сравнивается снимок защищённых имён вне `node_modules` (каталоги IDE,
667
- конфигурация shell и git, `.claude`, `.git`); новое или изменённое — класс
668
- `scope-violation` с путями в сообщении. Дерево из одних пустых каталогов
669
- (служебный `.claude/.cc-writes` CLI исполнителя) нарушением не считается,
670
- если до снимка пути не было или он тоже был без файлов; любой файл или
678
+ конфигурация shell и git, `.claude`, `.git`); новое, изменённое или
679
+ исчезнувшее с содержимым — класс `scope-violation` с путями в сообщении.
680
+ Подготовка фазы (lifecycle `setup`/`ready`, хранилище зависимостей, шаги
681
+ `prepare`) идёт вне песочницы: снимок до неё сверяется сразу после
682
+ `prepare` (`preparationGuard`; фаза без подготовки дерево не обходит).
683
+ Вложенный `.git`, созданный или изменённый там (подмодули, клоны
684
+ зависимостей), разрешён и записывается в `execution.prepared`: сверки
685
+ исполнителя, установки и gates той же фазы не считают только его
686
+ исчезновение (уборку переносом родителя); изменение и подмена другим
687
+ `.git` остаются нарушением. Остальные защищённые пути, изменённые подготовкой, — отказ с
688
+ причиной `sandbox-policy` и путями в сообщении: в попытке — отказ
689
+ окружения, в `gates-at` — ошибка команды, в подтверждении контрпримера —
690
+ `inconclusive`. Совместная проверка рабочей области этой сверки не
691
+ получает. Дерево из
692
+ одних пустых каталогов (служебный `.claude/.cc-writes` CLI исполнителя)
693
+ нарушением не считается, если до снимка пути не было или он тоже был без
694
+ файлов; любой файл или
671
695
  символьная ссылка внутри, правка прежнего пути с файлами и замена файла
672
696
  `.git` каталогом — нарушение. Пустым деревом не считаются FIFO, сокеты и
673
697
  прочие не-каталоги, а также каталог, открытый на запись всем