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
@@ -0,0 +1,31 @@
1
+ # devcontour-harness 0.1.0-alpha.38
2
+
3
+ Вопрос исполнителя не тратит попытку. `stateVersion` и `policyVersion`
4
+ прежние.
5
+
6
+ ## Изменения
7
+
8
+ - **Остановка вопросом.** Отказ `needs-input` возвращает попытку в предел
9
+ `maxAttempts` и не тратит предел незасчитанных отказов. Ответ на вопрос,
10
+ заданный на последней попытке, применяется (`applyInput`, `carryInput`)
11
+ без `reset`; следующая выдача получает тот же номер попытки. Повтора без
12
+ ответа по-прежнему нет: вопрос держит выдачу до применения.
13
+ - **Предел остановок вопросом.** Ответ может дать модель (режим `agent`),
14
+ а отмена с повтором закрывает вопрос без ответа, поэтому возврат
15
+ ограничен: поручение получает не больше `maxAttempts` остановок вопросом,
16
+ возвращающих попытку, за всю жизнь; сброс попыток их не возвращает.
17
+ Следующая остановка вопросом засчитывается как обычная попытка, и цикл
18
+ «вопрос → ответ → применение» кончается исчерпанием попыток. Новой
19
+ настройки нет: счёт ведётся по записям попыток.
20
+ - **События и отчёт.** `attempt.diagnosed` остановки вопросом пишет
21
+ `counted: false`, сверх предела — `counted: true`. Отчёт считает
22
+ засчитанные попытки по тому же правилу: остановка вопросом не засчитана,
23
+ только если её `attempt.diagnosed` пишет `counted: false`. Остановку и её
24
+ продолжение с тем же номером попытки различает `failureKind: needs-input`
25
+ записи попытки.
26
+
27
+ ## Обновление
28
+
29
+ Формат состояния прежний. Работы, остановленные вопросом до обновления,
30
+ хранят прежний счётчик попыток; их прежние остановки вопросом входят в
31
+ счёт предела. Подробнее — `docs/upgrade.md`.
@@ -0,0 +1,38 @@
1
+ # devcontour-harness 0.1.0-alpha.39
2
+
3
+ Ревью интеграции видит только изменения своего поручения; короткие пределы
4
+ gates защищены от нагрузки хоста. `stateVersion` и `policyVersion` прежние.
5
+
6
+ ## Изменения
7
+
8
+ - **База ревью интеграции.** Diff ревью интеграции считается от target, на
9
+ который сделано слияние (первый родитель integration SHA), а не от базы
10
+ попытки. Раньше работа, принятая в target после начала попытки (две группы
11
+ или доски в одной очереди), попадала в diff, и reviewer отклонял поручение
12
+ за файлы, которых оно не меняло. Запрос reviewer называет эту базу
13
+ (`Base commit`). Ключи записанного ревью (SHA, область) прежние;
14
+ `shas.base` результата по-прежнему — база попытки.
15
+ - **Интеграция без слияния — явный отказ.** Кандидат с изменениями обязан
16
+ дать ровно слияние target и кандидата (родители: target, кандидат). Если
17
+ кандидат уже входит в target и слияние нового коммита не создало, попытка
18
+ отказывает классом `merge` до gates и ревью интеграции, target не
19
+ продвигается.
20
+ - **Нижняя граница предела gate.** Новое необязательное поле политики
21
+ `gateTimeoutFloorMs` (целое, 1000–600 000 мс, без умолчания): действующий
22
+ предел каждого исполнения gate — `max(gate.timeoutMs, gateTimeoutFloorMs)`
23
+ на кандидате, интеграции, у потребителей, в приёмке группы и доски, в
24
+ совместной проверке, при установке зависимостей до исполнителя, при
25
+ подтверждении случая и в проверках reviewer. Объявленный `timeoutMs` не
26
+ меняется. Граница не больше `runTimeoutMs`, иначе политика отклоняется.
27
+ Политика без поля сохраняет digest и поведение. `timeoutMs` gate — защита
28
+ от зависания, а не предел производительности: бюджеты производительности
29
+ проверяются внутри самой проверки.
30
+ - **Текст отказа по пределу.** Gate, превысивший предел, называет
31
+ действующий предел в секундах и объявленный, если его подняла граница,
32
+ например: «превысила timeout: предел 30 с (объявлен 10 с, поднят
33
+ gateTimeoutFloorMs)».
34
+
35
+ ## Обновление
36
+
37
+ Формат состояния прежний. Поле `gateTimeoutFloorMs` меняет digest политики,
38
+ в которую добавлено. Подробнее — `docs/upgrade.md`.
@@ -0,0 +1,27 @@
1
+ # devcontour-harness 0.1.0-alpha.40
2
+
3
+ Проверки reviewer при ревью интеграции согласованы с базой, которую видит
4
+ reviewer. `stateVersion` и `policyVersion` прежние.
5
+
6
+ ## Изменения
7
+
8
+ - **База проверок reviewer при ревью интеграции.** С 0.1.0-alpha.39 diff
9
+ ревью интеграции считается от target, на который сделано слияние (первый
10
+ родитель integration SHA), но инструмент проверок reviewer
11
+ (`trustedBase` спецификации probe) по-прежнему сравнивал входы установки
12
+ зависимостей с базой попытки. Теперь `trustedBase` — база самого ревью:
13
+ у интеграции — target слияния (тот же коммит, что `Base commit` запроса),
14
+ у кандидата — база попытки, как раньше. Когда target сдвинулся после
15
+ начала попытки, отказ установки в проверке reviewer распознаётся как
16
+ `dependency-network` относительно того target, на котором проверяется
17
+ слияние.
18
+ - Без изменений: `shas.base` результата, записи попытки и проверка
19
+ «изменений нет» (кандидат совпадает с базой попытки) по-прежнему
20
+ используют базу попытки. Gates и шаги `prepare` интеграции тоже
21
+ по-прежнему передают базу попытки как `trustedBase`: если target
22
+ сдвинулся и lock-файл слияния отличается от базы попытки, отказ реестра
23
+ там классифицируется как `gate`, а не `dependency-network`.
24
+
25
+ ## Обновление
26
+
27
+ Формат состояния и политики прежний. Подробнее — `docs/upgrade.md`.
@@ -0,0 +1,49 @@
1
+ # devcontour-harness 0.1.0-alpha.41
2
+
3
+ Два исправления проверок кандидата, найденные на живом прогоне мобильного
4
+ продукта. `stateVersion` и `policyVersion` прежние.
5
+
6
+ ## Изменения
7
+
8
+ - **Gate удаляет и переименовывает прежний вывод в своём worktree.** На
9
+ macOS песочница gate закрывала каталоги IDE шаблонами
10
+ `<существующий каталог>/*/.idea`. sandbox-runtime закрепляет базу каждого
11
+ шаблона и её предков от удаления и переноса, поэтому каждый каталог,
12
+ существовавший в worktree к запуску gate (до глубины перечисления),
13
+ нельзя было удалить или переименовать. Gate, который сначала убирает свой
14
+ прежний вывод (например, `expo export` поверх папки, оставленной
15
+ самопроверкой исполнителя), падал с `EPERM rmdir` и тратил попытки как
16
+ провал gate. Теперь один символ первого сегмента под корнем записан
17
+ классом (`<корень>/[s]rc/*/.idea`): шаблон закрывает те же пути, а его
18
+ база — корень checkout. Создание и запись под теми же именами закрыты
19
+ как прежде, в любом регистре. Ядро больше не мешает переносу каталога,
20
+ внутри которого лежит существующий `.idea`/`.vscode`: такой перенос с
21
+ подложенной конфигурацией и удаление прежней конфигурации вместе с
22
+ родителем ловит сверка защищённых путей до и после gate (нарушение
23
+ области `scope-violation`). Сверка теперь считает нарушением и
24
+ исчезнувший защищённый путь с содержимым; пустые служебные каталоги
25
+ исчезать могут. Запись вне worktree не открывается.
26
+ - **Отказ песочницы в удалении каталога — отказ окружения.** Если ядро
27
+ всё же отказало gate в удалении или переносе каталога внутри worktree,
28
+ это `environment` с причиной `sandbox-filesystem`, а не `gate`, только
29
+ когда выполнено всё: отказ подтверждён журналом песочницы, каталог по
30
+ политике закреплён запретом записи (база или предок шаблона), и gate
31
+ упал с EPERM, назвав этот путь. Настоящий провал теста с проглоченной
32
+ неудачной уборкой остаётся провалом gate.
33
+ - **Повтор таймаута gate кандидата под нагрузкой.** Gate кандидата,
34
+ исчерпавший свой предел времени (не отмена попытки), когда средняя
35
+ нагрузка хоста за минуту не ниже 2 на ядро, повторяется один раз на том
36
+ же SHA тем же механизмом, что повтор интеграции: повтор прошёл —
37
+ `recheck.outcome: flaky`, попытка продолжается; снова таймаут или другой
38
+ провал — `confirmed`, отказ `gate` засчитывается как прежде. Нагрузка
39
+ названа в сводке записи; берётся меньшая из снятых до запуска gate и в
40
+ момент таймаута, поэтому gate, перегрузивший процессор сам, повтора не
41
+ получает. Таймаут на свободной машине, контрпример свойства, провал,
42
+ записанный в JUnit до таймаута (он назван в сводке), и прочие провалы не
43
+ повторяются; таймаут молча не проходит.
44
+ - Один повтор gate допускается на каждую фазу попытки: повтор кандидата не
45
+ отнимает повтор интеграции.
46
+
47
+ ## Обновление
48
+
49
+ Формат состояния и политики прежний. Подробнее — `docs/upgrade.md`.
@@ -0,0 +1,44 @@
1
+ # devcontour-harness 0.1.0-alpha.42
2
+
3
+ Остаточные исправления после alpha.41: сверка защищённых путей вокруг
4
+ подготовки фазы, более узкое правило отказа среды при удалении каталога и
5
+ тексты отказов. `stateVersion` и `policyVersion` прежние.
6
+
7
+ ## Изменения
8
+
9
+ - **Подготовка фазы не меняет конфигурацию молча.** Шаги lifecycle
10
+ `setup`/`ready`, хранилище зависимостей и шаги `prepare` задаёт политика,
11
+ и исполняются они вне песочницы. Под песочницей ОС защищённые пути
12
+ теперь сверяются и вокруг них: снимок до запуска окружения фазы, сверка
13
+ сразу после `prepare`, до черновика, установки зависимостей исполнителя и
14
+ gates. Фаза без подготовки дерево не обходит.
15
+ - Вложенный `.git`, созданный подготовкой (подмодули, клоны менеджеров
16
+ зависимостей), разрешён и принадлежит подготовке: сверки исполнителя,
17
+ установки и gates той же фазы не считают нарушением его исчезновение
18
+ (уборку переносом родителя). Изменение такого `.git`, в том числе
19
+ подмена другим `.git` переносом на его место, остаётся нарушением
20
+ `scope-violation`.
21
+ - Конфигурация IDE, агента, shell и корневого `.git`, созданная,
22
+ изменённая или удалённая подготовкой, — отказ с причиной
23
+ `sandbox-policy` и путями в сообщении. В попытке (кандидат, интеграция,
24
+ интеграция потребителя) это отказ окружения: попытка не засчитана,
25
+ выдача остановлена. В `gates-at` — ошибка команды. В подтверждении
26
+ контрпримера — исход `inconclusive`. Совместная проверка рабочей области
27
+ этой сверки не получает.
28
+ - Отчёт называет причину `sandbox-policy` «sandbox policy not built, or
29
+ protected paths changed before work».
30
+ - **EPERM и путь — в одной строке, отдельным словом.** Отказ песочницы в
31
+ удалении или переносе закреплённого каталога становится отказом окружения
32
+ `sandbox-filesystem`, только если одна строка вывода gate содержит и
33
+ EPERM, и этот путь отдельным словом (абсолютный, в том числе через `/var`,
34
+ или относительно `cwd` gate). Короткое имя в другой строке, соседний
35
+ `.claude-old` или `~/.claude` больше не переводят настоящий провал теста
36
+ в отказ окружения. Базы закреплённых каталогов перечисляются один раз на
37
+ разбор отказов.
38
+ - **«Создал, изменил или удалил».** Отказы исполнителя и установки
39
+ зависимостей называют и удаление защищённых путей, которое сверка ловит
40
+ с alpha.41; текст gate уже говорил так.
41
+
42
+ ## Обновление
43
+
44
+ Формат состояния и политики прежний. Подробнее — `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
  План составляет сам ведущий агент: отдельная модель-планировщик не
@@ -158,8 +158,8 @@ Isolation `os` пишет только в worktree и временный кат
158
158
  скачивает через прокси песочницы.
159
159
 
160
160
  Исполнитель и проверки ревьюера переменную `npm_config_store_dir` не получают: их окружение строится
161
- отдельно. Установка исполнителя до первого gate поэтому на seed не опирается и идёт как без
162
- хранилища.
161
+ отдельно. Зависимости в дерево исполнителя ставит controller до его работы
162
+ ([ниже](#зависимости-исполнителя)) — в окружении фазы, то есть уже с хранилищем.
163
163
 
164
164
  | Исход | Что происходит |
165
165
  | --------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
@@ -208,6 +208,61 @@ Isolation `os` пишет только в worktree и временный кат
208
208
  `dependency-store.json` в её артефактах. Другие менеджеры добавляются записью в таблице `managers`
209
209
  (`verification/dependency-store.ts`); пока поддержан только pnpm.
210
210
 
211
+ ## Зависимости исполнителя
212
+
213
+ Песочница Claude Code закрывает запись в `**/.idea` и `**/.vscode` от рабочего каталога исполнителя
214
+ без возможности снять запрет настройками, а у codex по умолчанию нет сети: установка пакетов
215
+ самим исполнителем не проходит, и до сдачи работы он не может собрать проект и запустить тесты.
216
+ Поэтому перед исполнителем controller сам исполняет в его дереве **gates установки** попытки —
217
+ обязательные gates, чей argv однозначно установка известным менеджером (`npm ci|install`,
218
+ `pnpm install|fetch`, `yarn`; скрипты, `npx` и shell не подходят), в их порядке:
219
+
220
+ - после `prepare`, хранилища зависимостей и наложения черновика прежней попытки (манифесты, которые
221
+ он меняет, ставятся сразу), до снимка защищённых путей исполнителя и его вызова. `dependsOn` gate
222
+ установки не исполняется: проверки, от которых он зависит, остаются gates кандидата. Если
223
+ установка есть ещё и в `prepare`, менеджер запустится дважды; второй раз обычно ничего не делает;
224
+ - под той же изоляцией, что и gate, при любом `isolation.mode`: в `os` — песочница проверки с
225
+ записью только в дерево, сетью `isolation.domains` и сверкой защищённых путей; в `none` — без
226
+ песочницы, так же, как исполняются сами gates (выбор `none` уже разрешает gates работать на хосте);
227
+ в окружении фазы, с `timeoutMs` gate;
228
+ - **evidence не пишется**: настоящий gate установки по-прежнему исполняется на SHA кандидата после
229
+ сдачи работы и остаётся единственным свидетельством.
230
+
231
+ Следы установки исполнителю не вменяются и в его коммит не попадают (он коммитит дерево целиком):
232
+
233
+ - каждый новый каталог `node_modules` — в корне, в пакетах workspace и внутри каталогов, уже бывших
234
+ неотслеживаемыми (например, созданных `prepare`), — скрывается от git собственным `.gitignore`, как
235
+ копия хранилища. Поиск — обход дерева без перехода по ссылкам, без спуска в `node_modules` и с
236
+ пределом в 200 000 элементов; недоделанный обход назван в квитанции (`incomplete`);
237
+ - прочие неотслеживаемые и не игнорируемые пути, которых до установки не было (сборка `dist/`,
238
+ сгенерированный код, журналы менеджера), удаляются; пустые каталоги остаются (git их не видит).
239
+ Пути, бывшие до установки, и содержимое прежних `node_modules` не трогаются; вложенный репозиторий
240
+ не удаляется и называется в `kept`;
241
+ - отслеживаемые файлы (lockfile, манифест), которые установка изменила, возвращаются к прежним байтам —
242
+ базы или наложенного черновика, — HEAD к базе; это считается отказом установки.
243
+
244
+ Заметка исполнителю при успехе: зависимости поставлены controller, установку не запускать. Фраза о
245
+ том, что lockfiles и манифесты менять нельзя, добавляется, только если все манифесты и lockfiles в
246
+ каталогах установки лежат в `protectedPaths`. Убранные пути названы числом и первыми именами. Отказ
247
+ (код выхода, сеть, timeout) попытку не роняет: исполнитель получает заметку «Dependencies were not
248
+ installed before your turn (gate "…")», в которой сводка вывода (не больше 400 символов) приведена
249
+ строкой JSON и помечена как недоверенный вывод инструмента, а не указания; стадия
250
+ `writer-dependencies` в `timings` закрывается исходом `failed`. Исключение — защищённый путь
251
+ (конфигурация IDE, shell, git или Claude), созданный или изменённый установкой: над деревом базы это
252
+ отказ среды `environment` с причиной `sandbox-policy`, над наложенным черновиком (манифесты писал
253
+ прежний исполнитель) — `scope-violation`, как у gate кандидата. Взятый кандидат прежней попытки
254
+ исполнителя не вызывает, и установки до него нет. Журналы и квитанция `writer-dependencies.json`
255
+ (`installed`, `failed`, `frozen`, `sealed`, `removed`, `removedCount`, `kept`, `incomplete`) — в
256
+ `artifacts/<попытка>/candidate/writer-dependencies/`.
257
+
258
+ Gate установки кандидата исполняется в том же дереве и переиспользует его `node_modules`, которые
259
+ исполнитель мог изменить: `pnpm install --frozen-lockfile` сверяет lockfile, но не содержимое уже
260
+ установленных пакетов. Integration исполняется в новом checkout с чистой установкой; именно она
261
+ подтверждает, что результат собирается из lockfile.
262
+
263
+ Выключить: `"writerDependencies": false` в репозитории политики. Без поля — включено, digest
264
+ политики прежний.
265
+
211
266
  ## Диагностика: doctor и preflight
212
267
 
213
268
  `harness doctor --policy policy.json` (или `--state`) добавляет `toolchains[]` — по
package/docs/upgrade.md CHANGED
@@ -529,6 +529,246 @@ null` и этого правила засчитанных попыток: ист
529
529
  остановить writers и восстановить копию каталога состояния, снятую до
530
530
  обновления, вместе с прежней версией пакета.
531
531
 
532
+ ### 0.1.0-alpha.36: зависимости исполнителя и факты проекта
533
+
534
+ Номера форматов прежние (`stateVersion: 1`, `policyVersion: 1`); без
535
+ `repositories[].writerDependencies` политика и её digest не меняются. Новое
536
+ поведение включено по умолчанию и действует при любом `isolation.mode` (при
537
+ `none` — без песочницы, как gates): перед исполнителем, после наложения
538
+ черновика прежней попытки, controller исполняет в его дереве обязательные gates
539
+ установки попытки под изоляцией gate, без evidence. Отказ — заметка
540
+ исполнителю (вывод установки — строкой JSON с пометкой «untrusted»);
541
+ защищённый путь над базой — `environment`/`sandbox-policy`, над черновиком —
542
+ `scope-violation`. Следы установки не попадают в работу исполнителя: новые
543
+ `node_modules` где угодно в дереве скрыты собственным `.gitignore`, прочие
544
+ новые неотслеживаемые пути убраны (квитанция `removed`), правка отслеживаемых
545
+ файлов откатывается. Попытка получает стадию `writer-dependencies` в
546
+ `timings`. Поле необязательно, строгая схема прежних версий его не принимает:
547
+ при откате уберите его из политики. Подробнее —
548
+ [зависимости исполнителя](toolchains.md#зависимости-исполнителя).
549
+
550
+ ### 0.1.0-alpha.37: вопросы исполнителя и диагностика многих работ
551
+
552
+ Номера форматов прежние (`stateVersion: 1`, `policyVersion: 1`, `apiVersion`
553
+ прежний); новое — аддитивно, подробности — [вопрос исполнителя](contracts.md#вопрос-исполнителя):
554
+
555
+ - **Политика.** Необязательное `inputPolicy {threshold 1–11, criticalPaths}`;
556
+ без поля политика и её digest прежние, порог — 7. В `executionDigest` поле
557
+ не входит: его смена не требует нового согласования графа и действует со
558
+ следующей попытки.
559
+ - **Ответ writer.** Необязательные `inputRequest` и `assumptions`;
560
+ wire-схема CLI runtime объявляет оба поля. `completed: true` с вопросом —
561
+ ответ вне схемы. Ответ прежнего формата читается как прежде.
562
+ - **Состояние.** Локальное пространство `input-requests` (`InputRequest`,
563
+ `schemas/input-request.schema.json`); необязательные поля попытки
564
+ `inputPolicy`, `assumptions`, `input` и `pinned.contextDigest`. Класс
565
+ отказа `needs-input`. Состояние без вопросов читается без изменений: запросов
566
+ нет, выдача и повтор прежние.
567
+ - **Коды и журнал.** `INPUT_REQUIRED` (класс `refused`, exit code 3; в
568
+ отказах `run`, `retry`, `approve`); события `input.requested`,
569
+ `input.answered`, `input.applied`, `input.closed`, `input.delivered`,
570
+ `attempt.assumptions`, `input.stale` (ID, digests и числа); типы
571
+ транзакций `input.*`. Необязательные поля запроса `stale` и `normalized`.
572
+ Причина остановки `needs-input`, действия `answer-input` и `apply-input`.
573
+ - **Проекции.** `status`: `works[].input`, `works[].followUps`; пакет передачи:
574
+ блок `inputs` и `truncated.inputs`; отчёт: блок `inputs` (только числа) и
575
+ корзина отказов `input`.
576
+ - **Порты.** Необязательный `ExecutionHost.input` (`InputHost`) для хоста,
577
+ ведущего согласование сам; `RunnerOptions.context(work, attempt)` получает
578
+ выданную попытку (снимок загружается по `attempt.pinned.contextDigest`);
579
+ `measuredInvoke` — необязательный `onStart(callId)` (доставку ответа
580
+ runner подтверждает не им, а ответом runtime, отличным от `unavailable`). Набор
581
+ `executionStoreContract` проверяет пространство `input-requests`;
582
+ `sampleInputRequest`/`answeredInputRequest` экспортированы из
583
+ `devcontour-harness/testing`.
584
+ - **CLI.** Команды `input-list`, `input-show`, `input-answer`,
585
+ `input-context`, `input-target`, `input-apply`, `input-cancel`,
586
+ `input-supersede`.
587
+ - **Хост с портом согласования.** `InputHost.review` и `activate`
588
+ получают запрос (`{id, answerDigest, mode}`); перенос ответа заменённого
589
+ запроса — `Engine.proposeCarry` и `Engine.carryInput` (`expectedVersion`,
590
+ `targetDigest`; `Harness.proposeCarry`/`carryInput`). Экспортированный
591
+ `unappliedInputs` требует `mayCarry`. `originBasis.contentDigest` —
592
+ необязательное поле запроса, `target.contentDigest` — цели; состояние
593
+ вопроса `carry-stale` (status, handoff); `cancelInput` снимает устаревший
594
+ перенесённый ответ. Не найденный закреплённый снимок держит только свою
595
+ работу (`needs-lead`, не засчитана), очередь не останавливается. Исходная остановка и
596
+ устаревание применённого ответа сравнивают постановку самой работы, а не
597
+ digest графа. Попытка с `pinned.contextDigest` отказывает, если загрузчик
598
+ контекста хоста вернул другой снимок. `implementationOutputSchema`
599
+ (wire-схема ответа writer) экспортирован корнем пакета.
600
+ - **Маскирование.** Ответ writer маскируется полным окружением вызова до
601
+ разбора: `hooks.implemented` получает уже замаскированный `output`
602
+ (`summary`, `discoveries`). Наследуемые переменные (`environment.inherit`)
603
+ маскируются, если значение не короче 8 знаков или имя похоже на секрет
604
+ (TOKEN, SECRET, PASSWORD, API_KEY, CREDENTIAL, AUTH, PRIVATE; значение от 4
605
+ знаков); объявленные `secrets` — всегда. Не маскируются только наследуемые
606
+ значения короче 8 знаков без секретного имени (`FORCE_COLOR=1`, `CI=true`):
607
+ прежде они вырезались из каждой строки вывода проверок и ответов. Короткий
608
+ секрет без секретного имени объявите в `secrets`.
609
+ - **Поведение `unfinished`.** Защищённые пути, HEAD и область записи
610
+ проверяются до решения о вопросе и незавершённости для любого ответа
611
+ writer. Прежде `completed: false` с правкой вне области получал
612
+ `unfinished` и продолжался с черновика в области; теперь это
613
+ `scope-violation` (повтор по его правилу), как у готовой реализации.
614
+
615
+ - **Диагностика многих работ.** `stopInputsOf` принимает `workIds`;
616
+ `Engine.budgetBlocksOf(workIds | undefined, view)` даёт блокировки бюджета
617
+ набора работ за одно чтение (значение равно `budgetBlockOf`). Вызов для
618
+ всей доски линеен по числу работ. Поведение прежнее.
619
+ - **Перенос и объяснение.** Снятие устаревшего перенесённого ответа хранит
620
+ запись замены в `closed.previous`; отказ до старта попытки объясняется фазой
621
+ `preflight` (`StopInput.work.preflight`).
622
+ - **Отчёт.** `report.inputs.carryStale` — новое число; `report.inputs.closed`
623
+ больше не считает вопросы с устаревшим перенесённым ответом.
624
+
625
+ Читатель со строгой схемой прежней версии `ValueReport`, `HandoffPack`,
626
+ `StopDiagnosis`, `RunEvent`, `RunResult` или ответа `status` отклонит новые
627
+ значения и поля: обновить схему вместе с пакетом. Хост с собственным
628
+ хранилищем (DevContour) хранит `input-requests` у владельца-компонента, а
629
+ адаптер прогоняет расширенный `executionStoreContract`.
630
+
631
+ **Откат.** Документ состояния разбирается строго: прежние версии отказывают
632
+ до записи на попытке с полями `inputPolicy`, `assumptions`, `input` или
633
+ `pinned.contextDigest` (их пишет каждая новая выдача) и на отказе
634
+ `needs-input`; записи `input-requests` прежняя версия не читает. Путь —
635
+ строка «Новая версия уже изменила формат» таблицы [«Откат»](#откат):
636
+ остановить writers и восстановить копию каталога состояния, снятую до
637
+ обновления, вместе с прежней версией пакета; поле `inputPolicy` убрать из
638
+ политики.
639
+
640
+ ### 0.1.0-alpha.38: вопрос не тратит попытку
641
+
642
+ Номера форматов прежние (`stateVersion: 1`, `policyVersion: 1`). Остановка
643
+ `needs-input` возвращает попытку в предел `maxAttempts` и не тратит предел
644
+ незасчитанных отказов: ответ на вопрос последней попытки применяется
645
+ (`applyInput`, `carryInput`) без `reset`. `attempt.diagnosed` такой остановки
646
+ пишет `counted: false`; отчёт считает засчитанные попытки по тому же правилу,
647
+ поэтому принятая после вопроса работа может стать «с первой попытки».
648
+ Возврат ограничен: поручение получает не больше `maxAttempts` остановок
649
+ вопросом, возвращающих попытку, за всю жизнь (счёт по записям попыток,
650
+ сброс его не обнуляет); следующая засчитывается как обычная попытка
651
+ (`counted: true`), и цикл вопросов кончается исчерпанием попыток. Новой
652
+ настройки нет. Работы, остановленные вопросом до обновления, хранят прежний
653
+ счётчик: продолжение после исчерпания по-прежнему требует сброса с
654
+ причиной; их прежние остановки вопросом входят в счёт предела. Хост,
655
+ требовавший `reset` после вопроса на последней попытке, может это требование
656
+ снять, пока предел остановок вопросом не исчерпан. Откат возможен без
657
+ изменений состояния.
658
+
659
+ ### 0.1.0-alpha.39: база ревью интеграции, нижняя граница предела gate
660
+
661
+ Номера форматов прежние (`stateVersion: 1`, `policyVersion: 1`). Ревью
662
+ интеграции получает diff от target, на который сделано слияние, и называет
663
+ его в `Base commit`; база попытки остаётся в `shas.base` результата и в
664
+ записях попытки. Кандидат с изменениями, уже входящий в target, отказывает
665
+ классом `merge` до проверок интеграции, а не проверяется на коммите без
666
+ слияния. Необязательное поле политики `gateTimeoutFloorMs` (1000–600 000 мс,
667
+ не больше `runTimeoutMs`) поднимает предел каждого исполнения gate до этой
668
+ границы; без поля поведение и digest политики прежние, с полем digest
669
+ меняется, и попытки, выданные под прежней политикой, под новой не
670
+ принимаются. Текст отказа gate по пределу дополнен действующим и объявленным
671
+ пределом: читатель, сравнивавший текст целиком, сверяет по началу
672
+ `Проверка прервана или превысила timeout`. Откат возможен без изменений
673
+ состояния; поле `gateTimeoutFloorMs` перед откатом убрать из политики.
674
+
675
+ ### 0.1.0-alpha.40: база проверок reviewer при ревью интеграции
676
+
677
+ Номера форматов прежние (`stateVersion: 1`, `policyVersion: 1`). В
678
+ спецификации проверок reviewer (`probe.json` в каталоге ревью) поле
679
+ `trustedBase` у ревью интеграции — target, на который сделано слияние
680
+ (первый родитель integration SHA), как `Base commit` запроса; у ревью
681
+ кандидата — по-прежнему база попытки. От `trustedBase` зависит только
682
+ распознавание отказа установки зависимостей как `dependency-network`.
683
+ `shas.base` результата и записи попытки не меняются; gates и шаги `prepare`
684
+ интеграции по-прежнему передают базу попытки как `trustedBase` (отказ
685
+ реестра там при сдвинутом target — класс `gate`, а не `dependency-network`).
686
+ Откат возможен без изменений состояния.
687
+
688
+ ### 0.1.0-alpha.41: удаление каталогов в песочнице gate, повтор таймаута кандидата
689
+
690
+ Номера форматов прежние (`stateVersion: 1`, `policyVersion: 1`).
691
+
692
+ - Песочница gate на macOS больше не закрепляет существующие каталоги
693
+ worktree от удаления и переноса: запреты каталогов IDE записаны
694
+ шаблонами с базой в корне checkout (`<корень>/[s]rc/*/.idea` вместо
695
+ `<корень>/src/*/.idea`) в `isolation.json` настроек gate. Создание и
696
+ запись закрыты для тех же путей; перенос или удаление каталога с
697
+ существующим `.idea`/`.vscode` внутри ядро больше не запрещает — его ловит
698
+ сверка защищённых путей. Сверка (gate, исполнитель, установка
699
+ зависимостей) теперь считает нарушением области и исчезнувший защищённый
700
+ путь с содержимым; текст отказа gate — «проверка создала, изменила или
701
+ удалила защищённые пути». Отказ ядра в удалении каталога, закреплённого
702
+ запретом, — отказ окружения `sandbox-filesystem`, а не `gate`, когда gate
703
+ упал с EPERM, назвав этот путь.
704
+ - Нагрузка для повтора таймаута — меньшая из снятых до запуска gate и в
705
+ момент таймаута. Провал, записанный в JUnit до таймаута, повтора не
706
+ получает и добавлен в сводку (`; до таймаута упали …`).
707
+ - Gate кандидата, исчерпавший свой предел времени при средней нагрузке
708
+ хоста за минуту не ниже 2 на ядро, повторяется один раз на том же
709
+ candidate SHA. Вторая запись evidence несёт `recheck: {of, outcome}` с
710
+ `phase: candidate` — поле то же, что у повтора интеграции с alpha.19.
711
+ Движок допускает один повтор на фазу попытки (прежде — один на попытку).
712
+ Сводка отказа по таймауту дополнена нагрузкой хоста
713
+ (`…, нагрузка хоста <x> на <n> ядер`): читатель, сравнивавший текст
714
+ целиком, сверяет по началу `Проверка прервана или превысила timeout`.
715
+ Строка отчёта `Integration check rechecks` переименована в
716
+ `Gate rechecks (…)` и считает повторы обеих фаз.
717
+ - Откат возможен без изменений состояния. Попытку, у которой уже есть
718
+ повтор gate кандидата, прежняя версия не даст повторить на интеграции
719
+ (у неё один повтор на попытку): провал gate интеграции у такой попытки
720
+ засчитывается сразу.
721
+
722
+ ### 0.1.0-alpha.42: сверка защищённых путей вокруг подготовки фазы
723
+
724
+ Номера форматов прежние (`stateVersion: 1`, `policyVersion: 1`).
725
+
726
+ - Под песочницей ОС (`isolation.mode: os`) защищённые пути сверяются и
727
+ вокруг подготовки фазы: снимок до lifecycle `setup`/`ready`, сверка сразу
728
+ после шагов `prepare`. Фаза без lifecycle, `prepare` и хранилища
729
+ зависимостей дерево не обходит.
730
+ - Вложенный `.git` (файл подмодуля после `git submodule update --init`,
731
+ клоны менеджеров зависимостей: `swift package resolve`,
732
+ `terraform init` с git-модулями, `mix deps.get`,
733
+ `composer install --prefer-source`, git-гемы Bundler), созданный или
734
+ изменённый подготовкой, разрешён. Он переходит во владение подготовки:
735
+ сверки исполнителя, установки зависимостей и gates той же фазы не
736
+ считают нарушением только его исчезновение. Изменение, в том числе
737
+ подмена другим `.git` (с другим `gitdir`) переносом на его место, —
738
+ по-прежнему `scope-violation`. В песочнице gate запись и удаление самого
739
+ вложенного `.git` (`rm -rf` его каталога) закрыты обязательным запретом
740
+ sandbox-runtime, а перенос родителя наружу (во временный каталог gate)
741
+ разрешён: так gate убирает фикстуру подготовки, и исчезновение пути,
742
+ которым владеет подготовка, не засчитывается.
743
+ - Конфигурация IDE и агента (`.idea`, `.vscode`, `.claude`), shell
744
+ (`.bashrc`, `.zshrc` и соседние), `.gitconfig`, `.gitmodules`,
745
+ `.mcp.json` и корневой `.git`, созданные, изменённые или удалённые
746
+ подготовкой, — отказ с текстом «Подготовка окружения (…) создала,
747
+ изменила или удалила защищённые пути …» и причиной `sandbox-policy`
748
+ (в отчёте — «sandbox policy not built, or protected paths changed
749
+ before work»). Держите такие пути вне worktree. Следствие зависит от
750
+ места:
751
+ - кандидат, интеграция и интеграция потребителя в попытке — отказ
752
+ окружения `environment` без траты попытки, выдача останавливается
753
+ до правки политики;
754
+ - `gates-at` — ошибка команды, попытки и очереди нет;
755
+ - подтверждение контрпримера — исход `inconclusive` («проверка не
756
+ выполнилась: …»), корпус не меняется.
757
+ - Совместная проверка рабочей области (joint) сверки подготовки не
758
+ получает, как и сверки gate.
759
+ - Отказ ядра в удалении закреплённого каталога — отказ окружения
760
+ `sandbox-filesystem` только тогда, когда одна строка вывода gate содержит
761
+ и EPERM, и этот путь отдельным словом: абсолютный (в том числе `/var`
762
+ вместо `/private/var`) или относительно `cwd` gate. Перед путём — начало
763
+ строки, пробел, кавычка, `(`, `[`, `=` или `<`; после — конец строки,
764
+ пробел, кавычка, `:`, `/`, `,`, `;`, `)`, `]`, `>` или точка в конце
765
+ предложения. `.claude-old`, `.claude.bak` и `~/.claude/…` каталог
766
+ `.claude` не называют. Иначе провал остаётся `gate`.
767
+ - Тексты отказов исполнителя и установки зависимостей говорят «создал,
768
+ изменил или удалил защищённые пути» (прежде «создал или изменил»):
769
+ читатель, сравнивавший текст, сверяет по `защищённые пути`.
770
+ - Откат возможен без изменений состояния.
771
+
532
772
  ## Перед обновлением
533
773
 
534
774
  1. **Остановить записывающих.** Запретить новые выдачи (`harness pause`),
@@ -231,7 +231,9 @@ export declare function serveReviewProbes(probes: ReviewProbes, input?: NodeJS.R
231
231
  pending: Set<Promise<unknown>>;
232
232
  };
233
233
  /** Объявленные gates репозитория в виде спецификации probe. */
234
- export declare function probeGates(gates: GatePolicy[]): ProbeGate[];
234
+ export declare function probeGates(gates: GatePolicy[], policy?: {
235
+ gateTimeoutFloorMs?: number | undefined;
236
+ }): ProbeGate[];
235
237
  /**
236
238
  * Часть запроса reviewer о запуске объявленных gates: готовый вызов по ID,
237
239
  * без самостоятельного env-wrapper. Пусто, если запускать нечего.
@@ -7,7 +7,7 @@ import { dirname, join, relative, resolve, sep } from 'node:path';
7
7
  import { createInterface } from 'node:readline';
8
8
  import { fileURLToPath } from 'node:url';
9
9
  import { z } from 'zod';
10
- import { idSchema, relativePathSchema, sha256, TaskFailure, } from "../contracts/index.js";
10
+ import { idSchema, relativePathSchema, sha256, TaskFailure, gateTimeoutMs, } from "../contracts/index.js";
11
11
  import { dependencyNetworkFailure, dependencyNetworkMessage, } from "../environment/dependency-network.js";
12
12
  import { osToolEnv } from "../environment/os-tools.js";
13
13
  import { redactor } from "../environment/redaction.js";
@@ -76,7 +76,11 @@ export const probeSpec = z.object({
76
76
  /** Фаза и SHA ревью: записываются в каждый запуск gate. */
77
77
  phase: z.string().optional(),
78
78
  sha: z.string().optional(),
79
- /** SHA базы попытки: только с ним gate установки может стать `dependency-network`. */
79
+ /**
80
+ * SHA базы ревью: у кандидата — база попытки, у интеграции — target, на
81
+ * который сделано слияние (первый родитель integration SHA). Только с ним
82
+ * gate установки может стать `dependency-network`.
83
+ */
80
84
  trustedBase: z.string().optional(),
81
85
  /**
82
86
  * Вызов reviewer, которому принадлежит журнал: попытка harness, фаза, SHA
@@ -789,13 +793,13 @@ export function serveReviewProbes(probes, input = process.stdin, output = proces
789
793
  return { lines, pending };
790
794
  }
791
795
  /** Объявленные gates репозитория в виде спецификации probe. */
792
- export function probeGates(gates) {
796
+ export function probeGates(gates, policy = {}) {
793
797
  return gates.map((g) => ({
794
798
  id: g.id,
795
799
  kind: g.kind,
796
800
  command: g.command,
797
801
  ...(g.cwd ? { cwd: g.cwd } : {}),
798
- timeoutMs: g.timeoutMs,
802
+ timeoutMs: gateTimeoutMs(g, policy),
799
803
  ...(g.report ? { report: { type: g.report.type, path: g.report.path } } : {}),
800
804
  ...(g.property ? { property: true } : {}),
801
805
  }));