devcontour-harness 0.1.0-alpha.37 → 0.1.0-alpha.44
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 +56 -2
- package/docs/architecture.md +64 -5
- package/docs/contracts.md +45 -22
- package/docs/release-notes/0.1.0-alpha.38.md +31 -0
- package/docs/release-notes/0.1.0-alpha.39.md +38 -0
- package/docs/release-notes/0.1.0-alpha.40.md +27 -0
- package/docs/release-notes/0.1.0-alpha.41.md +49 -0
- package/docs/release-notes/0.1.0-alpha.42.md +44 -0
- package/docs/release-notes/0.1.0-alpha.43.md +40 -0
- package/docs/release-notes/0.1.0-alpha.44.md +44 -0
- package/docs/upgrade.md +197 -17
- package/lib/agents/review-probe.d.ts +3 -1
- package/lib/agents/review-probe.js +8 -4
- package/lib/contracts/cli.d.ts +48 -4
- package/lib/contracts/events.d.ts +60 -5
- package/lib/contracts/events.js +16 -1
- package/lib/contracts/execution.d.ts +37 -0
- package/lib/contracts/execution.js +24 -3
- package/lib/contracts/policy.d.ts +19 -0
- package/lib/contracts/policy.js +30 -0
- package/lib/contracts/published.d.ts +29 -2
- package/lib/contracts/report.d.ts +8 -0
- package/lib/contracts/report.js +7 -1
- package/lib/contracts/result.d.ts +2 -0
- package/lib/contracts/result.js +6 -0
- package/lib/control/harness.d.ts +5 -0
- package/lib/engine/engine.d.ts +36 -3
- package/lib/engine/engine.js +140 -21
- package/lib/engine/joint-runner.d.ts +2 -0
- package/lib/engine/joint-runner.js +14 -4
- package/lib/engine/runner.d.ts +11 -0
- package/lib/engine/runner.js +82 -13
- package/lib/environment/isolation.d.ts +41 -1
- package/lib/environment/isolation.js +203 -7
- package/lib/environment/lifecycle.d.ts +46 -2
- package/lib/environment/lifecycle.js +81 -2
- package/lib/report/compute.js +19 -6
- package/lib/report/document.js +3 -3
- package/lib/storage/document.d.ts +2 -0
- package/lib/testing/store-contract.d.ts +8 -2
- package/lib/testing/store-contract.js +56 -1
- package/lib/verification/confirm.js +6 -4
- package/lib/verification/gates-at.js +3 -1
- package/lib/verification/gates.d.ts +36 -2
- package/lib/verification/gates.js +71 -11
- package/lib/verification/joint.d.ts +179 -1
- package/lib/verification/joint.js +23 -3
- package/package.json +1 -1
- package/schemas/execution-document.schema.json +4 -0
- package/schemas/execution-policy.schema.json +5 -0
- package/schemas/joint-verification.schema.json +4 -0
- package/schemas/run-event.schema.json +96 -0
- package/schemas/value-report.schema.json +20 -0
package/README.md
CHANGED
|
@@ -5,7 +5,7 @@ Headless-движок исполнения инженерных поручени
|
|
|
5
5
|
интеграция с принятой веткой через compare-and-swap и машинный результат с SHA
|
|
6
6
|
и доказательствами.
|
|
7
7
|
|
|
8
|
-
> Статус: `0.1.0-alpha.
|
|
8
|
+
> Статус: `0.1.0-alpha.44` — предварительный выпуск (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.
|
|
31
|
+
npm install --save-exact devcontour-harness@0.1.0-alpha.44 # точная версия
|
|
32
32
|
# или: npm install --save-exact devcontour-harness@alpha # текущая alpha
|
|
33
33
|
npx harness --version
|
|
34
34
|
```
|
|
@@ -149,6 +149,60 @@ PASS» нет. Адаптеры хоста реализуют порты `Execut
|
|
|
149
149
|
`devcontour-harness/schemas/<имя>.schema.json`. Декларации используют типы
|
|
150
150
|
Node.js: TypeScript-потребителю нужен `@types/node` (или `skipLibCheck`).
|
|
151
151
|
|
|
152
|
+
## Выпуск 0.1.0-alpha.44
|
|
153
|
+
|
|
154
|
+
Совместная проверка, прерванная до результата gates (остановка хоста,
|
|
155
|
+
потеря владения, истёкший срок), больше не тратит предел проверок набора;
|
|
156
|
+
явный сброс бюджета с причиной снимает только проверки без результата gates.
|
|
157
|
+
Подробно — [заметки выпуска](docs/release-notes/0.1.0-alpha.44.md).
|
|
158
|
+
|
|
159
|
+
## Выпуск 0.1.0-alpha.43
|
|
160
|
+
|
|
161
|
+
Исчезновение вложенного `.git` подготовки засчитывается только за
|
|
162
|
+
настоящими родительскими каталогами; подпись защищённого файла включает
|
|
163
|
+
ctime, так что правка с восстановленным mtime не проходит незамеченной.
|
|
164
|
+
Подробно — [заметки выпуска](docs/release-notes/0.1.0-alpha.43.md).
|
|
165
|
+
|
|
166
|
+
## Выпуск 0.1.0-alpha.42
|
|
167
|
+
|
|
168
|
+
Подготовка фазы (lifecycle, хранилище зависимостей, `prepare`), изменившая
|
|
169
|
+
конфигурацию IDE, агента, shell или корневого git в дереве, — отказ с
|
|
170
|
+
причиной `sandbox-policy` вместо молчаливого прохода; вложенные `.git`
|
|
171
|
+
(подмодули, клоны зависимостей) подготовке разрешены и принадлежат ей. Отказ
|
|
172
|
+
песочницы в удалении закреплённого каталога — отказ окружения, только когда
|
|
173
|
+
EPERM и путь названы отдельным словом в одной строке вывода. Подробно —
|
|
174
|
+
[заметки выпуска](docs/release-notes/0.1.0-alpha.42.md).
|
|
175
|
+
|
|
176
|
+
## Выпуск 0.1.0-alpha.41
|
|
177
|
+
|
|
178
|
+
Gate может удалить и переименовать прежний вывод в своём worktree под
|
|
179
|
+
песочницей macOS; gate кандидата, исчерпавший предел времени под высокой
|
|
180
|
+
нагрузкой хоста, повторяется один раз на том же SHA. Подробно —
|
|
181
|
+
[заметки выпуска](docs/release-notes/0.1.0-alpha.41.md).
|
|
182
|
+
|
|
183
|
+
## Выпуск 0.1.0-alpha.40
|
|
184
|
+
|
|
185
|
+
Проверки reviewer при ревью интеграции сравнивают входы установки
|
|
186
|
+
зависимостей с target, на который сделано слияние, — той же базой, что
|
|
187
|
+
называет запрос reviewer. Подробно —
|
|
188
|
+
[заметки выпуска](docs/release-notes/0.1.0-alpha.40.md).
|
|
189
|
+
|
|
190
|
+
## Выпуск 0.1.0-alpha.39
|
|
191
|
+
|
|
192
|
+
Ревью интеграции сравнивает с актуальным target, а не с базой попытки, и не
|
|
193
|
+
видит чужую уже принятую работу. Необязательное поле политики
|
|
194
|
+
`gateTimeoutFloorMs` поднимает короткие пределы gates. Интеграция без
|
|
195
|
+
слияния кандидата с target отказывает явно. Подробно —
|
|
196
|
+
[заметки выпуска](docs/release-notes/0.1.0-alpha.39.md).
|
|
197
|
+
|
|
198
|
+
## Выпуск 0.1.0-alpha.38
|
|
199
|
+
|
|
200
|
+
Остановка вопросом исполнителя (`needs-input`) больше не тратит попытку:
|
|
201
|
+
ответ на вопрос последней попытки применяется без сброса. Таких остановок у
|
|
202
|
+
поручения — не больше `maxAttempts`; следующие засчитываются как обычные
|
|
203
|
+
попытки, поэтому цикл вопросов ограничен. Подробно —
|
|
204
|
+
[заметки выпуска](docs/release-notes/0.1.0-alpha.38.md).
|
|
205
|
+
|
|
152
206
|
## Выпуск 0.1.0-alpha.37
|
|
153
207
|
|
|
154
208
|
Вопрос исполнителя (`inputRequest`, политика `inputPolicy`, ответ с ревью
|
package/docs/architecture.md
CHANGED
|
@@ -180,6 +180,37 @@ runtime-граф пакета.
|
|
|
180
180
|
активные проверки в него не входят. Hook выполняется внутри транзакции
|
|
181
181
|
начала: ошибка откатывает всю запись. Снимки бюджета не заменяют gates,
|
|
182
182
|
доказательства на SHA или основание оптимизации `affected`.
|
|
183
|
+
- **Прерванная совместная проверка.** Владелец, закрывающий проверку отказом,
|
|
184
|
+
может назвать её прерванной: `jointFail(id, token, error, { interrupted })`.
|
|
185
|
+
`JointRunner` называет так остановку хоста (внешний сигнал, не обход
|
|
186
|
+
зависших) и потерю владения (`LEASE_STALE` при продлении или записи);
|
|
187
|
+
истёкшую проверку, которую закрывает следующий `jointStart` или сброс
|
|
188
|
+
бюджета, — движок сам. Движок сохраняет отметку (`interrupted: true` в
|
|
189
|
+
проверке и в `joint.finished`) только у проверки без evidence; с evidence
|
|
190
|
+
это обычный отказ. Флаг хоста движок не перепроверяет: отказ до gates,
|
|
191
|
+
названный хостом прерыванием, считается прерыванием. Прерванные проверки
|
|
192
|
+
не тратят `maxAttempts` набора; у них свой предел `MAX_NEUTRAL_FAILURES`,
|
|
193
|
+
как у незасчитанных отказов окружения поручений. Отказ gate, отказ до gates
|
|
194
|
+
без отметки (результат поручения вне target ref, отказ подготовки) и
|
|
195
|
+
прерывание после evidence тратят предел, как раньше.
|
|
196
|
+
- **Явный сброс бюджета.** `engine.jointBudgetReset(workIds, { reason, actor })`
|
|
197
|
+
— выход оператора или хоста из исчерпанного предела набора без принятия:
|
|
198
|
+
только при исчерпании (`maxAttempts` или предел прерываний), без живой
|
|
199
|
+
проверки этого набора и с причиной; истёкшая незакрытая проверка набора
|
|
200
|
+
закрывается в той же транзакции. Сброс снимает только завершённые
|
|
201
|
+
проверки набора без результата gates — прерванные и отказы до gates, в том
|
|
202
|
+
числе записанные прежними версиями без отметки. Проверки с evidence тратят
|
|
203
|
+
предел и после сброса, как и успешные проверки без принятия (в том числе
|
|
204
|
+
без evidence). Сброс, после которого оставшиеся проверки набора всё равно
|
|
205
|
+
исчерпывают предел (или снимать нечего), отклоняется `ATTEMPTS_EXHAUSTED` и
|
|
206
|
+
не записывается — дальше только принятие хостом или новый набор.
|
|
207
|
+
Запись `joint-budget-resets` у `@workspace` хранит причину, актёра и
|
|
208
|
+
снимок IDs снятых проверок; событие `joint.budget-reset` несёт набор,
|
|
209
|
+
актёра, их число и длину причины; отчёт об эффекте считает сбросы по
|
|
210
|
+
актёру (`autonomy.actions.recorded.jointResets`). Граница — снимок IDs, а
|
|
211
|
+
не время, как у `jointBudgetCheckpoints`. `actor` называет вызывающий, число
|
|
212
|
+
сбросов не ограничено: код хоста не сбрасывает бюджет автоматически в
|
|
213
|
+
ответ на `ATTEMPTS_EXHAUSTED`, сброс — решение человека с причиной.
|
|
183
214
|
- **Расход ревью плана.** Вызов о графе закрепляет за расходом группу и
|
|
184
215
|
поручения из входного графа — и до его регистрации; повтор после
|
|
185
216
|
исчерпания бюджета поручения или группы отклоняется до вызова.
|
|
@@ -624,6 +655,17 @@ executable. Live smoke — отдельный opt-in с явно заданны
|
|
|
624
655
|
Провал, в отчёте которого названо проваленное свойство или случай корпуса,
|
|
625
656
|
не повторяется: это найденный контрпример, и удачный второй запуск
|
|
626
657
|
недетерминированной проверки его не отменяет.
|
|
658
|
+
- **Повтор таймаута кандидата под нагрузкой.** Gate кандидата, исчерпавший
|
|
659
|
+
свой предел времени (не отмена попытки), когда средняя нагрузка хоста за
|
|
660
|
+
минуту не ниже 2 на ядро (`HOST_LOAD_RECHECK_PER_CPU`; меньшая из снятых до
|
|
661
|
+
запуска gate и в момент таймаута), controller один раз
|
|
662
|
+
на попытку повторяет на том же candidate SHA. Нагрузка названа в сводке
|
|
663
|
+
записи. Повтор прошёл — `recheck.outcome: flaky`, попытка не тратится;
|
|
664
|
+
снова таймаут или другой провал — `confirmed`, отказ `gate` засчитывается
|
|
665
|
+
как прежде. Таймаут на свободной машине, провал, записанный в JUnit или
|
|
666
|
+
отчёт свойств до таймаута, и прочие провалы кандидата не повторяются. Лог — в `candidate/recheck/`, замер — стадия
|
|
667
|
+
`candidate-recheck:<gate>`. У каждой фазы попытки свой единственный повтор:
|
|
668
|
+
повтор кандидата бюджет повтора интеграции не тратит.
|
|
627
669
|
- **Атомарная приёмка.** Продвижение target ref — compare-and-swap внутри
|
|
628
670
|
транзакции приёмки. Чужой коммит в target ref не теряется: попытка начнётся
|
|
629
671
|
от новой базы. Падение между update-ref и записью принятия восстанавливается
|
|
@@ -664,15 +706,32 @@ executable. Live smoke — отдельный opt-in с явно заданны
|
|
|
664
706
|
операции: каталог, собранный в `node_modules` и перенесённый в дерево
|
|
665
707
|
проекта, ими не закрыт. До и после каждого gate и вокруг работы исполнителя
|
|
666
708
|
сравнивается снимок защищённых имён вне `node_modules` (каталоги IDE,
|
|
667
|
-
конфигурация shell и git, `.claude`, `.git`);
|
|
668
|
-
`scope-violation` с путями в сообщении.
|
|
669
|
-
(
|
|
670
|
-
|
|
709
|
+
конфигурация shell и git, `.claude`, `.git`); новое, изменённое или
|
|
710
|
+
исчезнувшее с содержимым — класс `scope-violation` с путями в сообщении.
|
|
711
|
+
Подготовка фазы (lifecycle `setup`/`ready`, хранилище зависимостей, шаги
|
|
712
|
+
`prepare`) идёт вне песочницы: снимок до неё сверяется сразу после
|
|
713
|
+
`prepare` (`preparationGuard`; фаза без подготовки дерево не обходит).
|
|
714
|
+
Вложенный `.git`, созданный или изменённый там (подмодули, клоны
|
|
715
|
+
зависимостей), разрешён и записывается в `execution.prepared`: сверки
|
|
716
|
+
исполнителя, установки и gates той же фазы не считают только его
|
|
717
|
+
исчезновение (уборку переносом родителя), и только если родители от корня
|
|
718
|
+
до первого исчезнувшего звена — настоящие каталоги; изменение, подмена
|
|
719
|
+
другим `.git` и родитель, заменённый символьной ссылкой или файлом,
|
|
720
|
+
остаются нарушением. Остальные защищённые пути, изменённые подготовкой, — отказ с
|
|
721
|
+
причиной `sandbox-policy` и путями в сообщении: в попытке — отказ
|
|
722
|
+
окружения, в `gates-at` — ошибка команды, в подтверждении контрпримера —
|
|
723
|
+
`inconclusive`. Совместная проверка рабочей области этой сверки не
|
|
724
|
+
получает. Дерево из
|
|
725
|
+
одних пустых каталогов (служебный `.claude/.cc-writes` CLI исполнителя)
|
|
726
|
+
нарушением не считается, если до снимка пути не было или он тоже был без
|
|
727
|
+
файлов; любой файл или
|
|
671
728
|
символьная ссылка внутри, правка прежнего пути с файлами и замена файла
|
|
672
729
|
`.git` каталогом — нарушение. Пустым деревом не считаются FIFO, сокеты и
|
|
673
730
|
прочие не-каталоги, а также каталог, открытый на запись всем
|
|
674
731
|
(`mode & 0o002`; запись группе при umask 002 разрешена): у такого каталога
|
|
675
|
-
права входят в подпись.
|
|
732
|
+
права входят в подпись. Файл сравнивается по inode, размеру, mtime и
|
|
733
|
+
ctime: правку на месте, после которой `utimes` вернул mtime, выдаёт ctime;
|
|
734
|
+
её же меняют chmod/chown и новая жёсткая ссылка на защищённый файл. Имена
|
|
676
735
|
сравниваются без регистра (на APFS и NTFS `.Claude/settings.json` хост
|
|
677
736
|
читает как `.claude/settings.json`); Seatbelt на таком томе и сам закрывает
|
|
678
737
|
запреты в любом регистре. Путь, который сверка не может прочитать (любая
|
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
|
-
| `
|
|
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
|
|
|
@@ -367,7 +368,9 @@ writer и reviewer кода получают список файлов набо
|
|
|
367
368
|
техническая очередь ведущего, `contract-documents` — документы контрактов,
|
|
368
369
|
прошедшие ревью, по digest, `spikes` — эксперименты выполнимости
|
|
369
370
|
репозитория, `reproductions` — реестр воспроизведений из находок ревью по
|
|
370
|
-
|
|
371
|
+
поручениям, `input-requests` — вопросы исполнителей и ответы на них,
|
|
372
|
+
`joint-budget-resets` — явные сбросы бюджета совместных проверок набора).
|
|
373
|
+
`owner` — репозиторий или `@workspace`.
|
|
371
374
|
|
|
372
375
|
## Ответы исполнителей
|
|
373
376
|
|
|
@@ -738,7 +741,7 @@ HEAD и области записи: нарушение области оста
|
|
|
738
741
|
|
|
739
742
|
| Ответ | Исход |
|
|
740
743
|
| ------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------- |
|
|
741
|
-
| `completed: false`, вопрос не ниже порога | `needs-input`: попытка засчитана, черновик — `AttemptState.partial`, запрос `pending` в той же транзакции, что отказ
|
|
744
|
+
| `completed: false`, вопрос не ниже порога | `needs-input`: попытка не засчитана, черновик — `AttemptState.partial`, запрос `pending` в той же транзакции, что отказ |
|
|
742
745
|
| `completed: false`, вопрос ниже порога | `unfinished` (нарушение запроса); вопрос записан отклонённым (`cancelled`, `closed.by: controller`) и работу не держит |
|
|
743
746
|
| `completed: false` без вопроса | `unfinished`, как прежде |
|
|
744
747
|
| `completed: true`, допущение не ниже порога | `needs-input` без кандидата: самое серьёзное допущение становится вопросом (вариант `chosen` — выбор исполнителя) |
|
|
@@ -747,7 +750,18 @@ HEAD и области записи: нарушение области оста
|
|
|
747
750
|
|
|
748
751
|
`needs-input` — класс отказа без автоматического повтора
|
|
749
752
|
(`repairPolicy['needs-input']`: `stop`, выдачу не останавливает), корзина
|
|
750
|
-
отчёта `input`, код остановки `INPUT_REQUIRED` (класс `refused`).
|
|
753
|
+
отчёта `input`, код остановки `INPUT_REQUIRED` (класс `refused`). Остановка
|
|
754
|
+
вопросом возвращает попытку в предел `maxAttempts` и не тратит предел
|
|
755
|
+
незасчитанных отказов: ответ на вопрос последней попытки применяется без
|
|
756
|
+
сброса. Возврат ограничен: поручение получает не больше `maxAttempts`
|
|
757
|
+
остановок вопросом, возвращающих попытку, за всю жизнь (счёт — по записям
|
|
758
|
+
попыток с `failureKind: needs-input`, кроме прерванных остановкой
|
|
759
|
+
controller; сброс попыток его не обнуляет). Следующая остановка вопросом
|
|
760
|
+
засчитывается как обычная попытка (`counted: true`), поэтому цикл «вопрос →
|
|
761
|
+
ответ → применение» и обход вопроса отменой с повтором кончаются
|
|
762
|
+
исчерпанием попыток, даже если отвечает модель. Остановка, вернувшая
|
|
763
|
+
попытку, и её продолжение имеют один номер попытки; различает их
|
|
764
|
+
`failureKind: needs-input` записи и `counted` в `attempt.diagnosed`.
|
|
751
765
|
|
|
752
766
|
**Канонический запрос** (`InputRequest`, `schemas/input-request.schema.json`)
|
|
753
767
|
хранится в локальном пространстве `input-requests` у владельца — репозитория
|
|
@@ -956,9 +970,12 @@ hadAttempt}`. `engine.cancel(workId, reason?, by?)` (CLI `cancel` — `operator`
|
|
|
956
970
|
отказ не окружения. Хост, вызывающий `engine.fail`, может передать
|
|
957
971
|
`options.cause`; движок приводит её к классу (у отказа не окружения — всегда
|
|
958
972
|
`none`). `counted` — отказ засчитан в предел попыток (`maxAttempts`): не
|
|
959
|
-
засчитаны отказы до работы (`blocked`), окружения и провайдера,
|
|
960
|
-
|
|
961
|
-
|
|
973
|
+
засчитаны отказы до работы (`blocked`), окружения и провайдера, остановка
|
|
974
|
+
вопросом (`needs-input`) в пределах своего предела, истёкшее владение и
|
|
975
|
+
прерывание остановкой;
|
|
976
|
+
зависание (`stalled`) засчитано. Отчёт
|
|
977
|
+
считает попытки засчитанными по тому же правилу; остановку вопросом — по
|
|
978
|
+
`counted` её `attempt.diagnosed` (без события — засчитана). Отказ до работы с классом
|
|
962
979
|
не окружения получает причину `preflight`. Текста отказа в событии
|
|
963
980
|
нет.
|
|
964
981
|
|
|
@@ -998,7 +1015,13 @@ original}` (исходный тип, не длиннее 200 символов;
|
|
|
998
1015
|
транзакциями `recovery.*`, отказом и выдачей (`work.recovery`).
|
|
999
1016
|
`workspace.verification.started`, `workspace.manifest`, `workspace.evidence`,
|
|
1000
1017
|
`workspace.verified`, `workspace.failed` — транзакции совместной проверки
|
|
1001
|
-
(`joint.started`, `joint.finished
|
|
1018
|
+
(`joint.started`, `joint.finished`; у прерванной до результата gates —
|
|
1019
|
+
`interrupted: true`). `workspace.budget-reset` — явный сброс бюджета
|
|
1020
|
+
совместных проверок набора: запись `joint-budget-resets` и событие
|
|
1021
|
+
`joint.budget-reset`. Договор хранилища (`executionStoreContract`)
|
|
1022
|
+
проверяет, что адаптер сохраняет `interrupted` совместной проверки и
|
|
1023
|
+
пространство `joint-budget-resets`; хост, который заводит проверку своей
|
|
1024
|
+
операцией, передаёт её в необязательном `startVerification`. `config.started`, `config.reconfigure-*`
|
|
1002
1025
|
и `config.reconfigured` меняют применённую политику и запрос операции
|
|
1003
1026
|
(`policy.applied`, `policy.reconfigure`). `base.moved` — проверка владения
|
|
1004
1027
|
операцией и CAS-сдвиг ref базы; записей не создаёт, событие — `base.moved`.
|
|
@@ -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`.
|
|
@@ -0,0 +1,40 @@
|
|
|
1
|
+
# devcontour-harness 0.1.0-alpha.43
|
|
2
|
+
|
|
3
|
+
Остаточные исправления сверки защищённых путей после alpha.42: исчезновение
|
|
4
|
+
вложенного `.git` подготовки засчитывается только за настоящими каталогами,
|
|
5
|
+
подпись защищённого файла включает ctime. `stateVersion` и `policyVersion`
|
|
6
|
+
прежние.
|
|
7
|
+
|
|
8
|
+
## Изменения
|
|
9
|
+
|
|
10
|
+
- **Исчезновение `.git` подготовки — только за настоящими каталогами.**
|
|
11
|
+
Вложенный `.git`, созданный подготовкой, по-прежнему может исчезнуть
|
|
12
|
+
(уборка переносом родителя). Исчезновением теперь считается только путь,
|
|
13
|
+
родители которого от корня до первого исчезнувшего звена — настоящие
|
|
14
|
+
каталоги. Родитель, заменённый символьной ссылкой или файлом, — нарушение
|
|
15
|
+
`scope-violation` (во время подготовки — `sandbox-policy`): прежде обход
|
|
16
|
+
дерева не заходил в ссылку, и `.git` за ней выглядел убранным.
|
|
17
|
+
- **Подпись защищённого файла с ctime.** Сверка сравнивает файл по inode,
|
|
18
|
+
размеру, mtime и ctime. Правка на месте в перенесённом наружу родителе,
|
|
19
|
+
после которой `utimes` вернул mtime, больше не проходит незамеченной.
|
|
20
|
+
chmod/chown, новая жёсткая ссылка и изменение расширенных атрибутов
|
|
21
|
+
защищённого файла — тоже изменение. Подпись каталогов прежняя.
|
|
22
|
+
- **Подмодуль из индекса переносом не убрать.** Документация называет это
|
|
23
|
+
явно: git хоста видит удаление отслеживаемого пути, и gate проваливается
|
|
24
|
+
проверкой отслеживаемых файлов; уборка такого подмодуля — дело подготовки
|
|
25
|
+
или teardown.
|
|
26
|
+
|
|
27
|
+
## Совместимость
|
|
28
|
+
|
|
29
|
+
- Шаг подготовки или установки, который меняет права (`chmod -R`), делает
|
|
30
|
+
жёсткие ссылки (`cp -al`) или пишет расширенные атрибуты файлов `.idea`,
|
|
31
|
+
`.vscode`, `.claude` или `.git` в дереве, теперь получает отказ
|
|
32
|
+
(`sandbox-policy` при подготовке, `scope-violation` в работе исполнителя,
|
|
33
|
+
установки или gate). Держите такие шаги вне проверяемого дерева. На macOS
|
|
34
|
+
ctime меняет и запись расширенных атрибутов приложениями хоста (например,
|
|
35
|
+
открытие файла в Finder) — не открывайте защищённые файлы worktree во
|
|
36
|
+
время фазы.
|
|
37
|
+
- Окно между снимком и сверкой прежнее: процесс фазы, переживший её конец,
|
|
38
|
+
может изменить дерево после сверки. Сверка рассчитана на завершённые
|
|
39
|
+
процессы фазы.
|
|
40
|
+
- Откат возможен без изменений состояния.
|
|
@@ -0,0 +1,44 @@
|
|
|
1
|
+
# devcontour-harness 0.1.0-alpha.44
|
|
2
|
+
|
|
3
|
+
Совместная проверка, прерванная до результата gates, больше не тратит
|
|
4
|
+
предел проверок набора, а исчерпанный набор можно освободить явным сбросом
|
|
5
|
+
с причиной. `stateVersion` и `policyVersion` прежние.
|
|
6
|
+
|
|
7
|
+
## Изменения
|
|
8
|
+
|
|
9
|
+
- **Прерванная совместная проверка не тратит предел набора.** `JointRunner`
|
|
10
|
+
называет прерыванием остановку хоста (внешний сигнал, не обход зависших)
|
|
11
|
+
и потерю владения (`LEASE_STALE`); истёкшую проверку, которую закрывает
|
|
12
|
+
следующий `jointStart`, — движок сам. Движок сохраняет `interrupted: true`
|
|
13
|
+
(и в `joint.finished`) только у проверки без evidence. Отказ gate, отказ
|
|
14
|
+
до gates без отметки (результат поручения вне target ref, отказ
|
|
15
|
+
подготовки) и прерывание после evidence тратят предел, как раньше. У
|
|
16
|
+
прерываний свой предел `MAX_NEUTRAL_FAILURES`, как у незасчитанных отказов
|
|
17
|
+
окружения поручений. Текст `ATTEMPTS_EXHAUSTED` называет число и выход.
|
|
18
|
+
- **Явный сброс бюджета.** `engine.jointBudgetReset(workIds, { reason, actor })`
|
|
19
|
+
освобождает исчерпанный набор, снимая только его завершённые проверки без
|
|
20
|
+
результата gates, в том числе отказы, записанные прежними версиями без
|
|
21
|
+
отметки. Результаты gates тратят предел и после сброса. Сброс, после
|
|
22
|
+
которого набор всё равно исчерпан (результатами gates или успешными
|
|
23
|
+
проверками без принятия), или которому нечего снимать, отклоняется
|
|
24
|
+
`ATTEMPTS_EXHAUSTED` и не записывается. Истёкшую проверку набора сброс
|
|
25
|
+
сначала закрывает. Причина, актёр и IDs снятых проверок хранятся в
|
|
26
|
+
пространстве `joint-budget-resets`, событие — `joint.budget-reset`; отчёт
|
|
27
|
+
об эффекте считает сбросы по актёру (`autonomy.actions.recorded.jointResets`).
|
|
28
|
+
- **Договор хранилища.** `executionStoreContract` проверяет, что адаптер
|
|
29
|
+
сохраняет `interrupted` совместной проверки и пространство
|
|
30
|
+
`joint-budget-resets`; хост, заводящий проверку своей операцией, передаёт
|
|
31
|
+
`startVerification`.
|
|
32
|
+
|
|
33
|
+
## Совместимость
|
|
34
|
+
|
|
35
|
+
- Хост со своим хранилищем отображает `interrupted` проверки и пространство
|
|
36
|
+
`joint-budget-resets`, иначе прерванные проверки по-прежнему тратят предел.
|
|
37
|
+
Хост передаёт `JointRunner.run` сигнал своей остановки. Сброс бюджета —
|
|
38
|
+
действие оператора с причиной, а не автоматический ответ хоста на
|
|
39
|
+
`ATTEMPTS_EXHAUSTED`.
|
|
40
|
+
- Проверки, прерванные до этого выпуска, отметки не имеют; набор,
|
|
41
|
+
исчерпанный ими, освобождает `jointBudgetReset`.
|
|
42
|
+
- Состояние с `interrupted` или записями `joint-budget-resets` прежние
|
|
43
|
+
версии отклоняют: откат — через копию. Без них откат возможен без
|
|
44
|
+
изменений состояния.
|