devcontour-harness 0.1.0-alpha.37 → 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.
package/README.md CHANGED
@@ -5,7 +5,7 @@ Headless-движок исполнения инженерных поручени
5
5
  интеграция с принятой веткой через compare-and-swap и машинный результат с SHA
6
6
  и доказательствами.
7
7
 
8
- > Статус: `0.1.0-alpha.37` — предварительный выпуск (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.37 # точная версия
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
  ```
@@ -149,6 +149,46 @@ PASS» нет. Адаптеры хоста реализуют порты `Execut
149
149
  `devcontour-harness/schemas/<имя>.schema.json`. Декларации используют типы
150
150
  Node.js: TypeScript-потребителю нужен `@types/node` (или `skipLibCheck`).
151
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
+
152
192
  ## Выпуск 0.1.0-alpha.37
153
193
 
154
194
  Вопрос исполнителя (`inputRequest`, политика `inputPolicy`, ответ с ревью
@@ -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
  прочие не-каталоги, а также каталог, открытый на запись всем
package/docs/contracts.md CHANGED
@@ -97,21 +97,22 @@ manifest снимка и в необязательном поле `baseline` о
97
97
 
98
98
  ### ExecutionPolicy
99
99
 
100
- | Поле | Смысл |
101
- | ------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
102
- | `policyVersion`, `mode` | `1`; `live` или `fixture` (runtime `fixture` только в нём) |
103
- | `repositories[]` | ID, путь, `targetRef` по правилам `git check-ref-format`, `dependsOn`, gates (`test` с обязательным JUnit внутри worktree, `check`), группы gates (≤100), защищённые и генерируемые пути, среда, lifecycle, шаги подготовки, сборки зависимостей и preflight |
104
- | `workspaceGates[]`, `verificationMode`, `workspaceLifecycle` | Gates совместной проверки комбинации репозиториев; `all` или `affected`; окружение совместной проверки |
105
- | `roles{}` | `writer`, `writePaths`, своё правило `review` кода, `requiresContract` |
106
- | `review.code / plan / contract` | `{reviewer, vendor}`; reviewer задан явно |
107
- | `approvalMode` | `agent` или `operator` для технического согласования |
108
- | `isolation` | `{mode: 'os' \| 'none', domains[]}`, по умолчанию `os` |
109
- | `toolProfiles{}`, `environment`, `lifecycle`, `resources[]` | Инструменты (у профиля — встроенные инструменты claude, shell и сеть codex, MCP-серверы `mcp{}`: stdio-команда или http-адрес, только перечисленные `tools`, учётные данные — именами переменных `env`/`bearerTokenEnv`, передаются CLI по имени), среда, ресурсы (порты 1024–65535) |
110
- | `concurrency`, `leaseMs`, `runTimeoutMs`, `reviewProbes` | Пределы исполнения |
111
- | `maxAttempts`, `repairBudget`, `reuseImplementation` | Повторы и повторное использование кандидата |
112
- | `stallSweep{intervalMs, quietMs, stalledMs, action}` | Необязательное: обход зависших попыток controller ([ниже](#зависшие-попытки)); нет поля — 30 000 / 180 000 / 600 000 мс и `report`, умолчание не подставляется и digest политики не меняет |
113
- | `reviewProtocolRetries` | Необязательное: дополнительные вызовы reviewer кода при ошибке протокола ответа (0–2; нет поля — 1, умолчание не подставляется и digest политики не меняет), [review-protocol.md](review-protocol.md) |
114
- | `budgets{work, group, total, onUnknown}`, `prices[]` | Пределы USD и/или времени; тарифы |
100
+ | Поле | Смысл |
101
+ | ------------------------------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
102
+ | `policyVersion`, `mode` | `1`; `live` или `fixture` (runtime `fixture` только в нём) |
103
+ | `repositories[]` | ID, путь, `targetRef` по правилам `git check-ref-format`, `dependsOn`, gates (`test` с обязательным JUnit внутри worktree, `check`), группы gates (≤100), защищённые и генерируемые пути, среда, lifecycle, шаги подготовки, сборки зависимостей и preflight |
104
+ | `workspaceGates[]`, `verificationMode`, `workspaceLifecycle` | Gates совместной проверки комбинации репозиториев; `all` или `affected`; окружение совместной проверки |
105
+ | `roles{}` | `writer`, `writePaths`, своё правило `review` кода, `requiresContract` |
106
+ | `review.code / plan / contract` | `{reviewer, vendor}`; reviewer задан явно |
107
+ | `approvalMode` | `agent` или `operator` для технического согласования |
108
+ | `isolation` | `{mode: 'os' \| 'none', domains[]}`, по умолчанию `os` |
109
+ | `toolProfiles{}`, `environment`, `lifecycle`, `resources[]` | Инструменты (у профиля — встроенные инструменты claude, shell и сеть codex, MCP-серверы `mcp{}`: stdio-команда или http-адрес, только перечисленные `tools`, учётные данные — именами переменных `env`/`bearerTokenEnv`, передаются CLI по имени), среда, ресурсы (порты 1024–65535) |
110
+ | `concurrency`, `leaseMs`, `runTimeoutMs`, `reviewProbes` | Пределы исполнения |
111
+ | `maxAttempts`, `repairBudget`, `reuseImplementation` | Повторы и повторное использование кандидата |
112
+ | `stallSweep{intervalMs, quietMs, stalledMs, action}` | Необязательное: обход зависших попыток controller ([ниже](#зависшие-попытки)); нет поля — 30 000 / 180 000 / 600 000 мс и `report`, умолчание не подставляется и digest политики не меняет |
113
+ | `reviewProtocolRetries` | Необязательное: дополнительные вызовы reviewer кода при ошибке протокола ответа (0–2; нет поля — 1, умолчание не подставляется и digest политики не меняет), [review-protocol.md](review-protocol.md) |
114
+ | `gateTimeoutFloorMs` | Необязательное: нижняя граница предела времени каждого исполнения gate, мс (1000–600 000). Действующий предел — `max(gate.timeoutMs, gateTimeoutFloorMs)` на всех фазах (кандидат, интеграция, потребители, совместная проверка, проверки reviewer); объявленный `timeoutMs` в политике не меняется. Отказ по пределу называет действующий предел в секундах и объявленный, если его подняла граница. Граница не больше `runTimeoutMs`, иначе политика отклоняется. Нет поля — объявленный предел; умолчание не подставляется и digest политики не меняет. `timeoutMs` gate — защита от зависания, а не предел производительности: бюджеты производительности проверяются внутри самой проверки |
115
+ | `budgets{work, group, total, onUnknown}`, `prices[]` | Пределы USD и/или времени; тарифы |
115
116
 
116
117
  Переменные `HARNESS_*` и `DEVCONTOUR_*` политика задать не может.
117
118
 
@@ -738,7 +739,7 @@ HEAD и области записи: нарушение области оста
738
739
 
739
740
  | Ответ | Исход |
740
741
  | ------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------- |
741
- | `completed: false`, вопрос не ниже порога | `needs-input`: попытка засчитана, черновик — `AttemptState.partial`, запрос `pending` в той же транзакции, что отказ |
742
+ | `completed: false`, вопрос не ниже порога | `needs-input`: попытка не засчитана, черновик — `AttemptState.partial`, запрос `pending` в той же транзакции, что отказ |
742
743
  | `completed: false`, вопрос ниже порога | `unfinished` (нарушение запроса); вопрос записан отклонённым (`cancelled`, `closed.by: controller`) и работу не держит |
743
744
  | `completed: false` без вопроса | `unfinished`, как прежде |
744
745
  | `completed: true`, допущение не ниже порога | `needs-input` без кандидата: самое серьёзное допущение становится вопросом (вариант `chosen` — выбор исполнителя) |
@@ -747,7 +748,18 @@ HEAD и области записи: нарушение области оста
747
748
 
748
749
  `needs-input` — класс отказа без автоматического повтора
749
750
  (`repairPolicy['needs-input']`: `stop`, выдачу не останавливает), корзина
750
- отчёта `input`, код остановки `INPUT_REQUIRED` (класс `refused`).
751
+ отчёта `input`, код остановки `INPUT_REQUIRED` (класс `refused`). Остановка
752
+ вопросом возвращает попытку в предел `maxAttempts` и не тратит предел
753
+ незасчитанных отказов: ответ на вопрос последней попытки применяется без
754
+ сброса. Возврат ограничен: поручение получает не больше `maxAttempts`
755
+ остановок вопросом, возвращающих попытку, за всю жизнь (счёт — по записям
756
+ попыток с `failureKind: needs-input`, кроме прерванных остановкой
757
+ controller; сброс попыток его не обнуляет). Следующая остановка вопросом
758
+ засчитывается как обычная попытка (`counted: true`), поэтому цикл «вопрос →
759
+ ответ → применение» и обход вопроса отменой с повтором кончаются
760
+ исчерпанием попыток, даже если отвечает модель. Остановка, вернувшая
761
+ попытку, и её продолжение имеют один номер попытки; различает их
762
+ `failureKind: needs-input` записи и `counted` в `attempt.diagnosed`.
751
763
 
752
764
  **Канонический запрос** (`InputRequest`, `schemas/input-request.schema.json`)
753
765
  хранится в локальном пространстве `input-requests` у владельца — репозитория
@@ -956,9 +968,12 @@ hadAttempt}`. `engine.cancel(workId, reason?, by?)` (CLI `cancel` — `operator`
956
968
  отказ не окружения. Хост, вызывающий `engine.fail`, может передать
957
969
  `options.cause`; движок приводит её к классу (у отказа не окружения — всегда
958
970
  `none`). `counted` — отказ засчитан в предел попыток (`maxAttempts`): не
959
- засчитаны отказы до работы (`blocked`), окружения и провайдера, истёкшее
960
- владение и прерывание остановкой; зависание (`stalled`) засчитано. Отчёт
961
- считает попытки засчитанными по тому же правилу. Отказ до работы с классом
971
+ засчитаны отказы до работы (`blocked`), окружения и провайдера, остановка
972
+ вопросом (`needs-input`) в пределах своего предела, истёкшее владение и
973
+ прерывание остановкой;
974
+ зависание (`stalled`) засчитано. Отчёт
975
+ считает попытки засчитанными по тому же правилу; остановку вопросом — по
976
+ `counted` её `attempt.diagnosed` (без события — засчитана). Отказ до работы с классом
962
977
  не окружения получает причину `preflight`. Текста отказа в событии
963
978
  нет.
964
979
 
@@ -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`.
package/docs/upgrade.md CHANGED
@@ -637,6 +637,138 @@ null` и этого правила засчитанных попыток: ист
637
637
  обновления, вместе с прежней версией пакета; поле `inputPolicy` убрать из
638
638
  политики.
639
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
+
640
772
  ## Перед обновлением
641
773
 
642
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. Пусто, если запускать нечего.