devcontour-harness 0.1.0-alpha.45 → 0.1.0-alpha.47

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 (53) hide show
  1. package/README.md +20 -2
  2. package/docs/architecture.md +8 -0
  3. package/docs/compatibility.md +4 -1
  4. package/docs/contracts.md +25 -5
  5. package/docs/release-notes/0.1.0-alpha.46.md +63 -0
  6. package/docs/release-notes/0.1.0-alpha.47.md +138 -0
  7. package/docs/upgrade.md +119 -19
  8. package/lib/agents/review-probe.js +8 -3
  9. package/lib/contracts/cli.d.ts +11 -0
  10. package/lib/contracts/events.d.ts +13 -1
  11. package/lib/contracts/events.js +2 -0
  12. package/lib/contracts/execution.d.ts +1 -0
  13. package/lib/contracts/execution.js +13 -0
  14. package/lib/contracts/handoff.d.ts +1 -0
  15. package/lib/contracts/handoff.js +6 -1
  16. package/lib/contracts/ports.d.ts +54 -0
  17. package/lib/contracts/published.d.ts +8 -0
  18. package/lib/contracts/report.d.ts +4 -0
  19. package/lib/control/harness.d.ts +1 -1
  20. package/lib/control/workflow.d.ts +5 -1
  21. package/lib/control/workflow.js +18 -3
  22. package/lib/engine/classify.d.ts +6 -0
  23. package/lib/engine/classify.js +26 -0
  24. package/lib/engine/engine.d.ts +25 -2
  25. package/lib/engine/engine.js +76 -7
  26. package/lib/engine/runner.d.ts +11 -6
  27. package/lib/engine/runner.js +107 -34
  28. package/lib/environment/host-load.d.ts +12 -0
  29. package/lib/environment/host-load.js +7 -0
  30. package/lib/environment/lifecycle.d.ts +12 -1
  31. package/lib/environment/lifecycle.js +19 -2
  32. package/lib/environment/process.d.ts +71 -1
  33. package/lib/environment/process.js +149 -31
  34. package/lib/handoff/pack.js +7 -1
  35. package/lib/index.d.ts +5 -1
  36. package/lib/index.js +7 -1
  37. package/lib/report/document.js +2 -0
  38. package/lib/storage/sqlite.d.ts +47 -4
  39. package/lib/storage/sqlite.js +279 -34
  40. package/lib/testing/store-contract.d.ts +9 -0
  41. package/lib/testing/store-contract.js +235 -0
  42. package/lib/verification/applicability.d.ts +25 -2
  43. package/lib/verification/applicability.js +34 -1
  44. package/lib/verification/gates-at.js +15 -1
  45. package/lib/verification/gates.d.ts +3 -10
  46. package/lib/verification/gates.js +136 -15
  47. package/lib/verification/reaped.d.ts +24 -0
  48. package/lib/verification/reaped.js +24 -0
  49. package/package.json +1 -1
  50. package/schemas/execution-document.schema.json +4 -0
  51. package/schemas/handoff-pack.schema.json +4 -0
  52. package/schemas/run-event.schema.json +2 -0
  53. package/schemas/value-report.schema.json +3 -1
package/README.md CHANGED
@@ -5,7 +5,7 @@ Headless-движок исполнения инженерных поручени
5
5
  интеграция с принятой веткой через compare-and-swap и машинный результат с SHA
6
6
  и доказательствами.
7
7
 
8
- > Статус: `0.1.0-alpha.45` — предварительный выпуск (alpha). Договоры
8
+ > Статус: `0.1.0-alpha.47` — предварительный выпуск (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.45 # точная версия
31
+ npm install --save-exact devcontour-harness@0.1.0-alpha.47 # точная версия
32
32
  # или: npm install --save-exact devcontour-harness@alpha # текущая alpha
33
33
  npx harness --version
34
34
  ```
@@ -149,6 +149,24 @@ PASS» нет. Адаптеры хоста реализуют порты `Execut
149
149
  `devcontour-harness/schemas/<имя>.schema.json`. Декларации используют типы
150
150
  Node.js: TypeScript-потребителю нужен `@types/node` (или `skipLibCheck`).
151
151
 
152
+ ## Выпуск 0.1.0-alpha.47
153
+
154
+ Аренда идущей попытки — строка хранилища, а не поле документа состояния:
155
+ продление меняет одну строку и не читает и не переписывает документ, а
156
+ политика и guards проверяются полностью при изменении данных и раз в срок
157
+ аренды. Прежняя версия отказывает до записи на базе с такими строками; для
158
+ отката есть шаг вниз (`stepDownLeases`).
159
+ Подробно — [заметки выпуска](docs/release-notes/0.1.0-alpha.47.md).
160
+
161
+ ## Выпуск 0.1.0-alpha.46
162
+
163
+ Выдача не начинается, пока хост ждёт подтверждения перенесённой базы
164
+ (`base-check`), и восстановление отказа не снимает такую паузу. Остановленные
165
+ задания технической очереди получают время и событие исхода, пакет передачи —
166
+ ключ задания в `repairs`, а условный gate потребителя исполняется, когда SHA
167
+ его провайдера сдвинулся с зелёного SHA.
168
+ Подробно — [заметки выпуска](docs/release-notes/0.1.0-alpha.46.md).
169
+
152
170
  ## Выпуск 0.1.0-alpha.45
153
171
 
154
172
  Gate задачи может объявить `when: { paths: [...] }`: runner исполняет его,
@@ -294,6 +294,14 @@ runtime-граф пакета.
294
294
  осталось классов. Поэтому разовый отказ окружения под циклом восстановления
295
295
  останавливает выдачу только до его следующего шага, а без цикла пауза стоит
296
296
  до решения человека. Пауза человека этим не снимается.
297
+ - **Ожидание проверки базы.** Пока в `control.waits` есть запись
298
+ `base-check` (хост перенёс базу и ещё не подтвердил её), `claim` не выдаёт
299
+ работу при любом значении `paused`, а `clearFailure`, снявший последний
300
+ класс отказа паузы `runtime`, не снимает паузу, а переводит её в
301
+ `base-check` (`pausedAt` — время перехода; событие `control.paused` с этой причиной; `queuePause` —
302
+ ожидание controller, а не «исправить окружение»). Снимает ожидание только
303
+ `resume` — явный маршрут человека «подтвердить базу и начать»; `blockers`
304
+ называет причину кодом `PAUSED`.
297
305
  - **Gates на SHA вне попытки.** `runGatesAt` исполняет названные gates
298
306
  компонента на закреплённом SHA так же, как integration поручения:
299
307
  отдельное рабочее дерево, снимки зависимостей, ресурсы, lifecycle и
@@ -53,7 +53,10 @@ coordinator. `Store.change(type, fn)` открывает `BEGIN IMMEDIATE` (вл
53
53
  нейтральный поток не попадают и читаются хостом как раньше.
54
54
  6. Возврат Promise из `fn` отклоняется до записи.
55
55
  7. `heartbeat` — `Store.change('heartbeat', …)`: растёт только счётчик сроков,
56
- события нет.
56
+ события нет. Аренда попыток (D53) — строки `leases` в базе документа
57
+ попытки (у компонента — в его базе): продление (`renewLease`) меняет одну
58
+ строку и документ не открывает; в документе у активной попытки —
59
+ метка `leaseUntil: -1`, которую прежняя версия отклоняет до записи.
57
60
  8. Приёмка: CAS `git update-ref <target> <integration> <base>` выполняется
58
61
  внутри внешней транзакции до фиксации (как сейчас `finish(…, publish)`).
59
62
 
package/docs/contracts.md CHANGED
@@ -218,8 +218,17 @@ Diff — `git diff --no-renames --no-ext-diff --no-textconv --no-relative
218
218
  `.nvmrc`, `Cargo.*`, `go.mod`/`go.sum`/`go.work`, `pyproject.toml`,
219
219
  `poetry.lock`, `uv.lock`, `Pipfile*`, `requirements*.txt`, `Gemfile*`,
220
220
  `composer.*`, `.gitattributes`, `.gitmodules`, `.lfsconfig`) или путь,
221
- названный в argv команды gate (с учётом `cwd`); он — предпосылка
222
- (`gatePrerequisites`) исполняемого gate области. Общие настройки инструментов
221
+ названный в argv команды gate (с учётом `cwd`); с зелёного SHA сдвинулась
222
+ база провайдеров (`providerMovement`): у провайдера из `dependsOn`
223
+ репозитория или из снимков зависимостей (`AttemptState.dependencies`, в том
224
+ числе транзитивного) другой SHA, чем у принятой попытки зелёного SHA, либо
225
+ снимка нет у одной из попыток — изменение провайдера меняет вход gate
226
+ потребителя, даже если diff потребителя не задел его путей (artifacts
227
+ провайдера, пересобираемые в каждой попытке, не сравниваются: при том же SHA
228
+ невоспроизводимая сборка не должна отключать условные gates; смену
229
+ `dependencyBuild` провайдера при том же SHA правило не видит); он —
230
+ предпосылка (`gatePrerequisites`) исполняемого gate области. Отключить это
231
+ правило у gate нельзя. Общие настройки инструментов
223
232
  неявными входами **не** считаются — их перечисляют в `when.paths` сами:
224
233
  корневые `tsconfig*.json`, `eslint.config.*`, `vitest/jest/playwright.config.*`,
225
234
  `Makefile`, `Dockerfile`, `.env*`, скрипты, вызванные косвенно (например из
@@ -244,7 +253,10 @@ Diff — `git diff --no-renames --no-ext-diff --no-textconv --no-relative
244
253
  неприменимые gates ссылками evidence вида `not-applicable` с `notApplicable`.
245
254
  Функции: `changedPaths`, `coverageChanges`, `gateBasis`, `gateDecisions`,
246
255
  `pathApplicability`, `matchingPaths`, `gatePathRegExp`, `proofGates`,
247
- `notApplicableProblem`, `gateDigest`. Основание включает версию harness:
256
+ `providerMovement`, `notApplicableProblem`, `gateDigest`. У `gateDecisions`
257
+ вход `providersMoved` необязателен: без него провайдеры считаются не
258
+ сдвинувшимися — вызывающий ручается, что `changedFor` даёт зелёный SHA только
259
+ под теми же SHA провайдеров (runner передаёт его всегда). Основание включает версию harness:
248
260
  после обновления пакета каждый условный gate исполняется один раз. Не входят
249
261
  в основание образ контейнера по изменяемому тегу и переменные окружения
250
262
  хоста, передаваемые по имени (`environment.inherit`): их смену gate не видит.
@@ -1072,7 +1084,13 @@ hadAttempt}`. `engine.cancel(workId, reason?, by?)` (CLI `cancel` — `operator`
1072
1084
  точке обнаружения (`TaskFailure.diagnosis`); `transport`, `preflight`
1073
1085
  (`BlockedError` до работы), `provider-auth`, `provider-limit`, `stalled`,
1074
1086
  `shutdown` (прерывание штатной остановкой), `lease-expired` — по классу отказа
1075
- и его признакам; `other` — отказ окружения без известной причины; `none` —
1087
+ и его признакам; `process-reap` — потомков сдерживаемой команды (gate,
1088
+ вызова runtime) не удалось остановить или пересчитать (`ReapFailure`):
1089
+ проверка не пройдена и на том же дереве не повторяется;
1090
+ `cleanup` — ресурсы попытки не освобождены: не убраны временные каталоги
1091
+ завершившейся проверки или не завершилась очистка окружения (lifecycle
1092
+ teardown) без отказа самой работы; при отказе работы класс и причина — его
1093
+ (`CleanupFailure.original`); `other` — отказ окружения без известной причины; `none` —
1076
1094
  отказ не окружения. Хост, вызывающий `engine.fail`, может передать
1077
1095
  `options.cause`; движок приводит её к классу (у отказа не окружения — всегда
1078
1096
  `none`). `counted` — отказ засчитан в предел попыток (`maxAttempts`): не
@@ -1340,7 +1358,9 @@ HTML ≤ 1 МБ. Усечение отмечено флагом и ограни
1340
1358
  `complete` и причины неполноты (вызовы без стоимости, незавершённые,
1341
1359
  брошенные, попытки без учёта); при неполном расходе сумма — нижняя граница
1342
1360
  («≥ $X (неполно: …)» в Markdown), остаток — `null`. `repairs` —
1343
- восстановления незавершённых заданий графов;
1361
+ восстановления незавершённых заданий графов: `graphId`, `key` (ключ
1362
+ задания; у графа после новой редакции их несколько, и прежнее — `stale`),
1363
+ `status` задания, `used` и `budget`; у пакетов прежних версий `key` нет;
1344
1364
  - `next` — следующий шаг доски: первое решение; иначе идущая попытка со
1345
1365
  свежим сроком владения — ждать (без controller — до `leaseUntil`); попытка
1346
1366
  с истёкшим сроком или очередь без controller — `command: "harness run"` (run истечёт брошенную
@@ -0,0 +1,63 @@
1
+ # devcontour-harness 0.1.0-alpha.46
2
+
3
+ Исправления, найденные хостом в работе: выдача не начинается на
4
+ неподтверждённой базе, у остановленных заданий технической очереди есть
5
+ время и событие исхода, пакет передачи различает задания одного графа по
6
+ ключу, а условный gate потребителя исполняется, когда сдвинулся его
7
+ провайдер. `stateVersion` и `policyVersion` прежние; формат состояния не
8
+ меняется.
9
+
10
+ ## Изменения
11
+
12
+ - **Ожидание проверки базы.** Пока в `control.waits` есть запись
13
+ `base-check`, `Engine.claim` не выдаёт работу при любом значении `paused`;
14
+ `blockers()` без паузы называет причину (`PAUSED`, «Очередь ждёт
15
+ подтверждения перенесённой базы»).
16
+ - **`clearFailure` под ожиданием базы.** Снятие последнего класса паузы
17
+ `runtime` при ожидании `base-check` не снимает паузу и не оставляет
18
+ `runtime` без классов: пауза становится `base-check`, `pausedAt` — время
19
+ перехода, событие `control.paused` с причиной `base-check`. `queuePause`
20
+ показывает ожидание controller (`not-ready`/`wait`), а не «исправить
21
+ окружение». `resume()` прежний: это явный маршрут человека «подтвердить
22
+ базу и начать», он снимает ожидания `base-check`.
23
+ - **Исход заданий технической очереди.** `WorkflowQueue.fail()` добавляет
24
+ событие истории нового статуса (`failed`, `stale` или `queued` у
25
+ прерванной стадии) и ставит `finishedAt` у `failed` и `stale`; `claim()`
26
+ ставит `finishedAt`, останавливая задание (вход изменился, попытки
27
+ исчерпаны); `retry()` снимает `finishedAt` и добавляет событие `queued`.
28
+ - **Ключ задания в `repairs`.** Строки `repairs[]` пакета передачи несут
29
+ необязательный `key` задания рядом с его `status`; сборщик ставит его
30
+ всегда.
31
+ - **Провайдеры условных gates.** Условный gate (`when.paths`) с зелёным SHA
32
+ исполняется, если SHA провайдера отличается от снимка принятой попытки
33
+ зелёного SHA или снимка нет у одной из попыток — что бы ни сдвинуло
34
+ провайдера (работа harness в другом графе или более ранней задаче,
35
+ коммиты мимо harness). Провайдеры — `dependsOn` репозитория и все
36
+ репозитории снимков зависимостей, в том числе транзитивные. Artifacts
37
+ провайдера, пересобираемые в каждой попытке, не сравниваются; смену
38
+ `dependencyBuild` провайдера при том же SHA правило не видит.
39
+ - **Новые экспорты.** `providerMovement`, тип `ProviderSnapshot`;
40
+ `gateDecisions` принимает необязательный `providersMoved`.
41
+
42
+ ## Совместимость
43
+
44
+ - `providersMoved` необязателен: без него провайдеры считаются не
45
+ сдвинувшимися — вызывающий ручается, что `changedFor` даёт зелёный SHA
46
+ только под теми же SHA провайдеров. Так вызывает DevContour (перенос
47
+ базы, `sameProviders`); прежние вызовы компилируются и ведут себя как
48
+ раньше. Runner передаёт его всегда.
49
+ - Условные gates потребителей исполняются чаще: всякий раз, когда SHA
50
+ провайдера отличается от снимка зелёной попытки.
51
+ - DevContour переводит паузу в `base-check` сам (`settleFailure` в цикле
52
+ ведущего) и в этот момент `clearFailure` не вызывает; `checkBase` доходит
53
+ до проверки через `settleFailure`. Оба перехода ставят `pausedAt` на
54
+ момент перехода. Убирая `settleFailure` в пользу `clearFailure`, хост
55
+ сверяет и событие журнала (`control.paused` против своего
56
+ `base.check.resumed-wait`).
57
+ - История заданий получает события исхода; читатели «последнего события»
58
+ видят исход, а не `running`. `finishedAt` у `failed` и `stale` — настоящее
59
+ время окончания. Хост, возвращающий задание в очередь сам, снимает
60
+ `finishedAt` сам.
61
+ - Пакет передачи с `repairs[].key` прежняя версия (строгая схема)
62
+ отклоняет; пакеты строятся по запросу. Формат состояния прежний — откат
63
+ на alpha.45 без изменений состояния.
@@ -0,0 +1,138 @@
1
+ # devcontour-harness 0.1.0-alpha.47
2
+
3
+ Аренда идущей попытки переходит из документа состояния в строку хранилища
4
+ (D53). Продление владения больше не разбирает и не переписывает документ:
5
+ на большом состоянии это была заметная доля синхронной работы основного
6
+ потока, из-за которой продление опаздывало и попытка истекала под нагрузкой
7
+ хоста. `stateVersion` и `policyVersion` прежние.
8
+
9
+ ## Изменения
10
+
11
+ - **`ExecutionStore`: строки аренды.** Новые необязательные методы
12
+ `ExecutionView.attemptLease(id)`, `dataVersion()`, `activeLeases(at)` и
13
+ `ExecutionTransaction.renewLease(kind, id, token, owner, engineVersion,
14
+ until, now)`. Адаптер, объявивший `attemptLease`, `dataVersion` и
15
+ `renewLease`, держит срок активной попытки строкой: `putAttempt` пишет
16
+ или удаляет её той же транзакцией, чтение попытки отдаёт срок строки
17
+ (0 без строки с её token). `renewLease` — условное продление (тот же
18
+ token, владелец и версия движка, срок не истёк). `activeLeases` по
19
+ желанию: движок его не вызывает.
20
+ - **`Engine.heartbeat`.** У такого адаптера продление — одна строка.
21
+ Политика и guards проверяются полностью при смене `dataVersion` и не реже
22
+ раза в `leaseMs`; истёкший срок не продлевается и прежним token.
23
+ - **Standalone SQLite.** Таблица `leases`, метка документа `leaseRows`,
24
+ перенос сроков активных попыток одной транзакцией с меткой (при первой
25
+ строке и при открытии базы с активными попытками без метки),
26
+ `stepDownLeases()` для отката. Документ читается при первом обращении и
27
+ пишется, только если записи модели изменились; формат проверяется в
28
+ каждой транзакции, если базу меняло другое соединение.
29
+ - **`executionStoreContract`** проверяет строки аренды на каждом переходе
30
+ (выдача, продление, отказы по token, владельцу, версии движка и сроку,
31
+ завершение, adopt, отклонённый recovery, откат). Адаптер без методов
32
+ строк распознаётся сам; объявить их частично нельзя.
33
+ - **Неостановленные процессы команды — отказ окружения.** Если после
34
+ сдерживаемой команды (gate, вызов runtime) её потомков не удалось
35
+ остановить или пересчитать (`ps` не ответил под нагрузкой хоста), отказ
36
+ теперь `ReapFailure` класса `environment` с новой причиной
37
+ `process-reap` (`environmentCauses`), попытка не засчитывается.
38
+ Прежде тот же отказ был `gate` в gate (засчитывался и мог повториться на
39
+ том же дереве интеграции) и `unknown` в вызове runtime (останавливал
40
+ восстановление). Сдерживание прежнее: проверка не пройдена, повтора gate
41
+ интеграции на том же дереве нет. Текст называет команду, её PID и код
42
+ выхода, что не остановлено (PID или почему нет перечня) и нагрузку хоста
43
+ вместо «-1». Отказ перечня процессов повторяется до трёх раз за одну
44
+ остановку, прежде чем она сдаётся. Снимок нагрузки хоста вынесен в
45
+ `environment/host-load.ts` (`hostLoad` по-прежнему экспортирует и
46
+ `verification/gates.ts`).
47
+ - **Неосвобождённые ресурсы попытки — тоже окружение, но не заслоняют
48
+ отказ работы.** Gate, чья команда прошла, но controller не убрал её
49
+ временные каталоги (scratch, метки старта, каталог srt), не пройден с
50
+ классом `environment` и новой причиной `cleanup` (прежде `gate`); упавший
51
+ gate остаётся `gate` с кодом выхода и провалом, а отказ уборки дописан к
52
+ тексту (прежде текст был только об уборке). `CleanupFailure` (незавершённая
53
+ очистка окружения) несёт исходный отказ работы в `cause`
54
+ (`CleanupFailure.original`, `extend`): класс, причина, свойства и вопрос
55
+ попытки — его; без исходного отказа — `environment`/`cleanup` (прежде класс
56
+ угадывался по тексту — `unknown` или даже `timeout`). `withSuffix`
57
+ сохраняет `CleanupFailure`. Новая функция `failureOrigin` в
58
+ `engine/classify.ts`.
59
+ - **Неостановленные потомки не теряются и закрывают дерево.**
60
+ - Отказ остановки потомков проверки остаётся первичным, когда следом не
61
+ удалась уборка её временных каталогов (прежде его заменял отказ уборки:
62
+ класс `gate`, повтор gate интеграции на том же дереве); к повтору после
63
+ неудачного старта песочницы не приписывается исход прежнего запуска.
64
+ - Перечень процессов неполон — не «живых нет»: отказ `ps -axo` и `lsof`
65
+ при остановке повторяется и затем даёт `ReapFailure`, как отказ `ps -E`
66
+ (прежде команда считалась завершённой, и gate мог пройти).
67
+ - `ReapFailure` несёт исход команды (`result`). Провал, который назвала
68
+ сама команда (код выхода, упавшие тесты, контрпример свойства), остаётся
69
+ `gate` и засчитывается, неостановленные потомки дописаны к тексту (то же
70
+ правило, что у неубранных каталогов); таймаут и прерывание без
71
+ названного провала — `environment`/`process-reap`. В обоих случаях
72
+ отказ — `ReapedGate`: ни повтора gate на этом дереве (интеграции и
73
+ таймаута), ни следующих gates (`runGatesAt`).
74
+ - Исход проверки с неостановленными потомками разбирается полностью
75
+ (`runCheck`: повтор не стартовавшей песочницы, журнал отказов ядра):
76
+ отказ запуска песочницы и отказ файловой песочницы остаются отказами
77
+ среды (`sandbox-launch`, `sandbox-filesystem`), не засчитываются.
78
+ - **Правило интеграции.** Провал gate интеграции при неостановленных
79
+ потомках, названный только ненулевым кодом выхода и ничем больше (ни
80
+ упавшего или пропущенного теста, ни свойства, покрытия или отчёта, ни
81
+ правки закреплённого корпуса, ни правки HEAD или отслеживаемых файлов),
82
+ после того как кандидат этот gate прошёл, — `environment`/`process-reap`,
83
+ не засчитывается: `ps`, не уложившийся в предел, — свидетельство
84
+ перегрузки хоста (семейство D52), а повтора на этом дереве нет. Любой
85
+ названный провал остаётся `gate` и засчитывается.
86
+ - Установка зависимостей до исполнителя с неостановленными потомками
87
+ роняет попытку (`environment`/`process-reap`), а не остаётся заметкой.
88
+ - Попытка, чьи потомки не остановлены (вызов исполнителя, установка), не
89
+ оставляет черновика для следующей попытки — при любом исходе, в том
90
+ числе штатной остановке controller и зависании: изменения сохраняются
91
+ только файлом `artifacts/<попытка>/implementation/partial.patch`, путь
92
+ назван в тексте отказа; автоматически он не применяется.
93
+ - Если потомки не остановлены и у не стартовавшего запуска песочницы, и
94
+ у повторного, текст и исход отказа — повторного (стартовавшего) запуска,
95
+ PID потомков — обоих.
96
+ - `withSuffix` сохраняет `ReapedGate` и `ReapFailure`; отказ обработчика
97
+ вывода не заслоняет неостановленных потомков.
98
+ - Отказ окружения на попытке без изменений остаётся отказом окружения, а
99
+ не `empty-result`.
100
+ - `failureOrigin` раскрывает вложенные `CleanupFailure` до исходного
101
+ отказа.
102
+ - **Корень пакета** экспортирует `ReapFailure`, `reapFailure` (текст и
103
+ класс отказа остановки потомков для хоста со своим запуском команд),
104
+ `hostLoad`, `loadText`, `HostLoad`, `CleanupFailure` и `failureOrigin`.
105
+ `processInventory.tool` — точка подмены запуска `ps`/`lsof` для тестов.
106
+
107
+ ## Известные пределы
108
+
109
+ - Пережившие остановку потомки прежней попытки (`ReapFailure.survivors`)
110
+ перед gates следующей попытки не перепроверяются: через общие ресурсы
111
+ (порт, кеш пакетов, локальная база) или без изоляции они могут уронить её
112
+ gate, и такой провал засчитывается.
113
+ - Если предел времени попытки истёк во время gate, а остановка потомков
114
+ затем не удалась, отказ записывается `environment`/`process-reap`, а не
115
+ `timeout` (не засчитывается; ограничен пределом отказов окружения).
116
+
117
+ ## Совместимость
118
+
119
+ - База с меткой `leaseRows` прежней версией не открывается (строгая схема,
120
+ отказ до записи). Откат: остановить очередь, `stepDownLeases()`, затем
121
+ прежний пакет. **Откат возможен, только пока в журнале нет событий с
122
+ новыми причинами** (`attempt.diagnosed` с `cause: process-reap` или
123
+ `cleanup`, см. ниже): после `stepDownLeases()` прежняя версия базу
124
+ откроет, но чтение журнала (`events()`: доска, отчёт, повтор) упадёт на
125
+ первом таком событии, и исправить базу прежняя версия не сможет. Перед
126
+ обновлением сохраните копию базы; если такие события уже записаны —
127
+ оставайтесь на 0.1.0-alpha.47 (или верните копию, потеряв работу после
128
+ неё).
129
+ - Открытие базы для записи при идущих попытках прежней версии прерывает их
130
+ на её следующем продлении: остановите прежний процесс до обновления.
131
+ - Адаптеры прежнего договора без методов строк работают как раньше
132
+ (продление через `putAttempt`).
133
+ - Условие guard хоста вне записей с `dataVersion` замечается не позже чем
134
+ через ~`leaseMs + leaseMs/3`.
135
+ - Новые причины `process-reap` и `cleanup` в `attempt.diagnosed` и в отчёте: хост,
136
+ сверяющий причины со своим перечнем, должен их знать; прежняя версия
137
+ такие события не читает (строгий разбор известных типов), поэтому откат
138
+ после первого такого события закрыт — см. первый пункт.
package/docs/upgrade.md CHANGED
@@ -21,25 +21,25 @@
21
21
 
22
22
  ## Матрица форматов
23
23
 
24
- | Состояние, записанное… | Читает 0.1.0-alpha.1 | Читает 0.1.0-alpha.2 | Читает 0.1.0-alpha.6 | Читает 0.1.0-alpha.7 | Читает 0.1.0-alpha.8 | Читает 0.1.0-alpha.9 | Читает 0.1.0-alpha.10 | Читает 0.1.0-alpha.11 | Читает 0.1.0-alpha.12 | Читает 0.1.0-alpha.13 | Читает 0.1.0-alpha.14 | Читает 0.1.0-alpha.15 | Читает 0.1.0-alpha.16 | Читает 0.1.0-alpha.17 | Читает 0.1.0-alpha.18 | Читает 0.1.0-alpha.19 | Читает 0.1.0-alpha.20 | Читает 0.1.0-alpha.21 | Читает 0.1.0-alpha.22 | Читает 0.1.0-alpha.23 | Читает 0.1.0-alpha.24 | Читает 0.1.0-alpha.44 | Читает 0.1.0-alpha.45 | Пишет поверх | Примечание |
25
- | ----------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------ | ------------------------ | ----------------------- | ----------------------- | ----------------------- | ----------------------- | ----------------------- | ----------------------- | ----------------------- | ----------------------- | ----------------------- | ----------------------- | ----------------------- | ----------------------- | ----------------------- | ----------------------- | ----------------------- | ----------------------- | ----------------------- | ----------------------- | ----------------------- | ----------------------- | --------------------- | ------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
26
- | standalone `stateVersion: 1` версией alpha.1 | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | одна база SQLite: документ, события, локальные записи |
27
- | хост, центральная база | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да | данные не переносятся; новые поля необязательны |
28
- | хост, базы компонентов | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да | нужна копия всех баз при остановленных writers |
29
- | alpha.2 после штатной остановки controller | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | роль controller снята — нового поля в состоянии нет |
30
- | alpha.2 с живой или брошенной ролью controller | **нет**, отказ до записи | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | — | роль хранит `engineVersion`; строгая схема alpha.1 его не знает → откат через копию |
31
- | alpha.4 с совместной проверкой | **нет**, отказ до записи | **нет**, отказ до записи | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | — | проверка хранит `engineVersion`; прежние версии его не знают → откат через копию |
32
- | alpha.6 standalone с записями ревью нового протокола или доставкой `uncertain` | **нет**, отказ до записи | **нет**, отказ до записи | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | — | `reviewRound`, `findings[].id/status`, статус доставки `uncertain`; alpha.4/alpha.5 отказывают `STATE_VERSION_UNSUPPORTED` до записи → откат через копию |
33
- | alpha.6, хост DevContour (адаптер alpha.4) | — | — | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да | да | да | да | да | да | да | да | да | адаптер DevContour alpha.4 открывает такое состояние без отказа и пишет роль controller и события; новые поля сохраняются → для отката всё равно копия |
34
- | alpha.7 с новым `inspection` ревью кода | не проверялось | не проверялось | **нет** (строгая схема) | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | — | новые значения `source`, `exitCode: null`, `origins`/`context`/`excluded`; строгая схема alpha.6 их не принимает, поведение прежних версий при открытии не проверялось → откат через копию |
35
- | alpha.14 с договором проверки `reference` или `gates` обязательства | не проверялось | не проверялось | не проверялось | **нет** (строгая схема) | **нет** (строгая схема) | **нет** (строгая схема) | **нет** (строгая схема) | **нет** (строгая схема) | **нет** (строгая схема) | **нет** (строгая схема) | да | да | да | да | да | да | да | да | да | да | да | да | да | — | контракт хранится строгой схемой (`contract-documents`): прежние версии новых полей `gates`, `verification`, `reference` не знают → откат через копию |
36
- | alpha.17 с `interrupted`, `inputClasses`, `classified`, `neutralFailures`, `alreadySatisfied` в evidence ревью или классом отказа `unfinished`/`needs-lead` | не проверялось | не проверялось | не проверялось | **нет** (строгая схема) | **нет** (строгая схема) | **нет** (строгая схема) | **нет** (строгая схема) | **нет** (строгая схема) | **нет** (строгая схема) | **нет** (строгая схема) | **нет** (строгая схема) | **нет** (строгая схема) | **нет** (строгая схема) | да | да | да | да | да | да | да | да | да | да | — | попытка (`interrupted`, `inputClasses`, `classified`), поручение (`neutralFailures`), `alreadySatisfied` evidence ревью и классы отказа `unfinished`, `needs-lead` — новые значения строгих схем; прежние версии их отклоняют → откат через копию |
37
- | alpha.19 с `recheck` в evidence gate или областью gates длиннее 20 | не проверялось | не проверялось | не проверялось | **нет** (строгая схема) | **нет** (строгая схема) | **нет** (строгая схема) | **нет** (строгая схема) | **нет** (строгая схема) | **нет** (строгая схема) | **нет** (строгая схема) | **нет** (строгая схема) | **нет** (строгая схема) | **нет** (строгая схема) | **нет** (строгая схема) | **нет** (строгая схема) | да | да | да | да | да | да | да | да | — | evidence gate и событие `attempt.gate` (`recheck`), области gates поручения, задачи, потребителя и `alreadySatisfied` до 100 — новые значения строгих схем; прежние версии их отклоняют → откат через копию |
38
- | alpha.44 с `interrupted` совместной проверки или записями `joint-budget-resets` | не проверялось | не проверялось | не проверялось | **нет** (строгая схема) | **нет** (строгая схема) | **нет** (строгая схема) | **нет** (строгая схема) | **нет** (строгая схема) | **нет** (строгая схема) | **нет** (строгая схема) | **нет** (строгая схема) | **нет** (строгая схема) | **нет** (строгая схема) | **нет** (строгая схема) | **нет** (строгая схема) | **нет** (строгая схема) | **нет** (строгая схема) | **нет** (строгая схема) | **нет** (строгая схема) | **нет** (строгая схема) | **нет** (строгая схема) | да | да | — | необязательное поле совместной проверки и новое пространство локальных записей; прежние версии, включая alpha.25–alpha.43, их не знают и отклоняют → откат через копию |
39
- | alpha.45 с evidence `not-applicable` или полями `gateBasis` и `notApplicable` | не проверялось | не проверялось | не проверялось | **нет** (строгая схема) | **нет** (строгая схема) | **нет** (строгая схема) | **нет** (строгая схема) | **нет** (строгая схема) | **нет** (строгая схема) | **нет** (строгая схема) | **нет** (строгая схема) | **нет** (строгая схема) | **нет** (строгая схема) | **нет** (строгая схема) | **нет** (строгая схема) | **нет** (строгая схема) | **нет** (строгая схема) | **нет** (строгая схема) | **нет** (строгая схема) | **нет** (строгая схема) | **нет** (строгая схема) | **нет** (строгая схема) | да | — | новый вид evidence и необязательные поля записи gate; прежние версии, включая alpha.44, их не знают и отклоняют → откат через копию |
40
- | неизвестная `stateVersion` | нет, отказ до записи | нет, отказ до записи | нет, отказ до записи | нет, отказ до записи | нет, отказ до записи | нет, отказ до записи | нет, отказ до записи | нет, отказ до записи | нет, отказ до записи | нет, отказ до записи | нет, отказ до записи | нет, отказ до записи | нет, отказ до записи | нет, отказ до записи | нет, отказ до записи | нет, отказ до записи | нет, отказ до записи | нет, отказ до записи | нет, отказ до записи | нет, отказ до записи | нет, отказ до записи | нет, отказ до записи | нет, отказ до записи | нет | `STATE_VERSION_UNSUPPORTED`, exit 4 |
41
-
42
- Столбец alpha.2 относится и к alpha.3; alpha.4 и alpha.5 читают все строки, кроме неизвестной `stateVersion` и строк alpha.6 с новыми полями (standalone — отказ до записи) и строки alpha.7. alpha.8, alpha.9, alpha.10, alpha.11, alpha.12 и alpha.13 формат состояния не меняют и читают всё, что читает alpha.7; alpha.14 и alpha.15 (локальные, не опубликованы) и alpha.16 читают всё, что читает alpha.13, и добавляют необязательные поля договора проверки (строка alpha.14). alpha.17 читает всё, что читает alpha.16, и добавляет необязательные поля попытки, поручения и evidence ревью и классы отказа `unfinished` и `needs-lead` (строка alpha.17); alpha.18 формат состояния не меняет и читает всё, что читает alpha.17. alpha.19 читает всё, что читает alpha.18, и добавляет необязательное поле `recheck` evidence gate и области gates до 100 (строка alpha.19); alpha.20, alpha.21, alpha.22, alpha.23 и alpha.24 формат состояния не меняют и читают всё, что читает alpha.19. alpha.44 читает всё, что читают прежние версии, и добавляет необязательное поле `interrupted` совместной проверки и пространство локальных записей `joint-budget-resets` (строка alpha.44). alpha.45 читает всё, что читает alpha.44, и добавляет вид evidence `not-applicable` и необязательные поля `gateBasis` и `notApplicable` записи gate (строка alpha.45). Каждая следующая версия добавляет сюда свой столбец. Отказ неизвестного
24
+ | Состояние, записанное… | Читает 0.1.0-alpha.1 | Читает 0.1.0-alpha.2 | Читает 0.1.0-alpha.6 | Читает 0.1.0-alpha.7 | Читает 0.1.0-alpha.8 | Читает 0.1.0-alpha.9 | Читает 0.1.0-alpha.10 | Читает 0.1.0-alpha.11 | Читает 0.1.0-alpha.12 | Читает 0.1.0-alpha.13 | Читает 0.1.0-alpha.14 | Читает 0.1.0-alpha.15 | Читает 0.1.0-alpha.16 | Читает 0.1.0-alpha.17 | Читает 0.1.0-alpha.18 | Читает 0.1.0-alpha.19 | Читает 0.1.0-alpha.20 | Читает 0.1.0-alpha.21 | Читает 0.1.0-alpha.22 | Читает 0.1.0-alpha.23 | Читает 0.1.0-alpha.24 | Читает 0.1.0-alpha.44 | Читает 0.1.0-alpha.45 | Читает 0.1.0-alpha.46 | Пишет поверх | Примечание |
25
+ | ----------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------ | ------------------------ | ----------------------- | ----------------------- | ----------------------- | ----------------------- | ----------------------- | ----------------------- | ----------------------- | ----------------------- | ----------------------- | ----------------------- | ----------------------- | ----------------------- | ----------------------- | ----------------------- | ----------------------- | ----------------------- | ----------------------- | ----------------------- | ----------------------- | ----------------------- | --------------------- | --------------------- | ------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
26
+ | standalone `stateVersion: 1` версией alpha.1 | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | одна база SQLite: документ, события, локальные записи |
27
+ | хост, центральная база | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да | данные не переносятся; новые поля необязательны |
28
+ | хост, базы компонентов | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да | нужна копия всех баз при остановленных writers |
29
+ | alpha.2 после штатной остановки controller | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | роль controller снята — нового поля в состоянии нет |
30
+ | alpha.2 с живой или брошенной ролью controller | **нет**, отказ до записи | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | — | роль хранит `engineVersion`; строгая схема alpha.1 его не знает → откат через копию |
31
+ | alpha.4 с совместной проверкой | **нет**, отказ до записи | **нет**, отказ до записи | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | — | проверка хранит `engineVersion`; прежние версии его не знают → откат через копию |
32
+ | alpha.6 standalone с записями ревью нового протокола или доставкой `uncertain` | **нет**, отказ до записи | **нет**, отказ до записи | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | — | `reviewRound`, `findings[].id/status`, статус доставки `uncertain`; alpha.4/alpha.5 отказывают `STATE_VERSION_UNSUPPORTED` до записи → откат через копию |
33
+ | alpha.6, хост DevContour (адаптер alpha.4) | — | — | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да | да | да | да | да | да | да | да | да | да | адаптер DevContour alpha.4 открывает такое состояние без отказа и пишет роль controller и события; новые поля сохраняются → для отката всё равно копия |
34
+ | alpha.7 с новым `inspection` ревью кода | не проверялось | не проверялось | **нет** (строгая схема) | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | — | новые значения `source`, `exitCode: null`, `origins`/`context`/`excluded`; строгая схема alpha.6 их не принимает, поведение прежних версий при открытии не проверялось → откат через копию |
35
+ | alpha.14 с договором проверки `reference` или `gates` обязательства | не проверялось | не проверялось | не проверялось | **нет** (строгая схема) | **нет** (строгая схема) | **нет** (строгая схема) | **нет** (строгая схема) | **нет** (строгая схема) | **нет** (строгая схема) | **нет** (строгая схема) | да | да | да | да | да | да | да | да | да | да | да | да | да | да | — | контракт хранится строгой схемой (`contract-documents`): прежние версии новых полей `gates`, `verification`, `reference` не знают → откат через копию |
36
+ | alpha.17 с `interrupted`, `inputClasses`, `classified`, `neutralFailures`, `alreadySatisfied` в evidence ревью или классом отказа `unfinished`/`needs-lead` | не проверялось | не проверялось | не проверялось | **нет** (строгая схема) | **нет** (строгая схема) | **нет** (строгая схема) | **нет** (строгая схема) | **нет** (строгая схема) | **нет** (строгая схема) | **нет** (строгая схема) | **нет** (строгая схема) | **нет** (строгая схема) | **нет** (строгая схема) | да | да | да | да | да | да | да | да | да | да | да | — | попытка (`interrupted`, `inputClasses`, `classified`), поручение (`neutralFailures`), `alreadySatisfied` evidence ревью и классы отказа `unfinished`, `needs-lead` — новые значения строгих схем; прежние версии их отклоняют → откат через копию |
37
+ | alpha.19 с `recheck` в evidence gate или областью gates длиннее 20 | не проверялось | не проверялось | не проверялось | **нет** (строгая схема) | **нет** (строгая схема) | **нет** (строгая схема) | **нет** (строгая схема) | **нет** (строгая схема) | **нет** (строгая схема) | **нет** (строгая схема) | **нет** (строгая схема) | **нет** (строгая схема) | **нет** (строгая схема) | **нет** (строгая схема) | **нет** (строгая схема) | да | да | да | да | да | да | да | да | да | — | evidence gate и событие `attempt.gate` (`recheck`), области gates поручения, задачи, потребителя и `alreadySatisfied` до 100 — новые значения строгих схем; прежние версии их отклоняют → откат через копию |
38
+ | alpha.44 с `interrupted` совместной проверки или записями `joint-budget-resets` | не проверялось | не проверялось | не проверялось | **нет** (строгая схема) | **нет** (строгая схема) | **нет** (строгая схема) | **нет** (строгая схема) | **нет** (строгая схема) | **нет** (строгая схема) | **нет** (строгая схема) | **нет** (строгая схема) | **нет** (строгая схема) | **нет** (строгая схема) | **нет** (строгая схема) | **нет** (строгая схема) | **нет** (строгая схема) | **нет** (строгая схема) | **нет** (строгая схема) | **нет** (строгая схема) | **нет** (строгая схема) | **нет** (строгая схема) | да | да | да | — | необязательное поле совместной проверки и новое пространство локальных записей; прежние версии, включая alpha.25–alpha.43, их не знают и отклоняют → откат через копию |
39
+ | alpha.45 с evidence `not-applicable` или полями `gateBasis` и `notApplicable` | не проверялось | не проверялось | не проверялось | **нет** (строгая схема) | **нет** (строгая схема) | **нет** (строгая схема) | **нет** (строгая схема) | **нет** (строгая схема) | **нет** (строгая схема) | **нет** (строгая схема) | **нет** (строгая схема) | **нет** (строгая схема) | **нет** (строгая схема) | **нет** (строгая схема) | **нет** (строгая схема) | **нет** (строгая схема) | **нет** (строгая схема) | **нет** (строгая схема) | **нет** (строгая схема) | **нет** (строгая схема) | **нет** (строгая схема) | **нет** (строгая схема) | да | да | — | новый вид evidence и необязательные поля записи gate; прежние версии, включая alpha.44, их не знают и отклоняют → откат через копию |
40
+ | неизвестная `stateVersion` | нет, отказ до записи | нет, отказ до записи | нет, отказ до записи | нет, отказ до записи | нет, отказ до записи | нет, отказ до записи | нет, отказ до записи | нет, отказ до записи | нет, отказ до записи | нет, отказ до записи | нет, отказ до записи | нет, отказ до записи | нет, отказ до записи | нет, отказ до записи | нет, отказ до записи | нет, отказ до записи | нет, отказ до записи | нет, отказ до записи | нет, отказ до записи | нет, отказ до записи | нет, отказ до записи | нет, отказ до записи | нет, отказ до записи | нет, отказ до записи | нет | `STATE_VERSION_UNSUPPORTED`, exit 4 |
41
+
42
+ Столбец alpha.2 относится и к alpha.3; alpha.4 и alpha.5 читают все строки, кроме неизвестной `stateVersion` и строк alpha.6 с новыми полями (standalone — отказ до записи) и строки alpha.7. alpha.8, alpha.9, alpha.10, alpha.11, alpha.12 и alpha.13 формат состояния не меняют и читают всё, что читает alpha.7; alpha.14 и alpha.15 (локальные, не опубликованы) и alpha.16 читают всё, что читает alpha.13, и добавляют необязательные поля договора проверки (строка alpha.14). alpha.17 читает всё, что читает alpha.16, и добавляет необязательные поля попытки, поручения и evidence ревью и классы отказа `unfinished` и `needs-lead` (строка alpha.17); alpha.18 формат состояния не меняет и читает всё, что читает alpha.17. alpha.19 читает всё, что читает alpha.18, и добавляет необязательное поле `recheck` evidence gate и области gates до 100 (строка alpha.19); alpha.20, alpha.21, alpha.22, alpha.23 и alpha.24 формат состояния не меняют и читают всё, что читает alpha.19. alpha.44 читает всё, что читают прежние версии, и добавляет необязательное поле `interrupted` совместной проверки и пространство локальных записей `joint-budget-resets` (строка alpha.44). alpha.45 читает всё, что читает alpha.44, и добавляет вид evidence `not-applicable` и необязательные поля `gateBasis` и `notApplicable` записи gate (строка alpha.45). alpha.46 формат состояния не меняет и читает всё, что читает alpha.45. Каждая следующая версия добавляет сюда свой столбец. Отказ неизвестного
43
43
  формата до записи проверяют тесты совместимости пакета
44
44
  <!-- repo-only -->(`tests/compatibility.test.ts`)<!-- /repo-only -->.
45
45
 
@@ -859,6 +859,106 @@ alpha.45 матрицы форматов — новый вид evidence и но
859
859
  копию. Без условных gates таких записей нет, и откат возможен без
860
860
  изменений состояния.
861
861
 
862
+ ### 0.1.0-alpha.47: аренда попыток строкой (D53)
863
+
864
+ `stateVersion` и `policyVersion` прежние. Новое — строки аренды попыток и
865
+ метка документа standalone; договор `ExecutionStore` расширен
866
+ необязательными методами.
867
+
868
+ - **`ExecutionStore`.** Новые необязательные методы: `ExecutionView.attemptLease(id)`,
869
+ `activeLeases(at)`, `dataVersion()` и `ExecutionTransaction.renewLease(kind,
870
+ id, token, owner, engineVersion, until, now)`. Адаптер, у которого они
871
+ есть, держит срок аренды активной попытки строкой: `putAttempt` активной
872
+ попытки пишет её строку той же транзакцией, неактивной — удаляет; чтение
873
+ попытки отдаёт срок строки, пока token строки равен token попытки, иначе 0.
874
+ `renewLease` продлевает строку условно (тот же token, владелец и версия
875
+ движка, срок ещё не истёк) и не меняет записей модели, событий и
876
+ `dataVersion`. Общий набор `executionStoreContract` проверяет это для
877
+ каждого перехода; адаптер прежнего договора передаёт `{ leaseRows: false }`.
878
+ - **`Engine.heartbeat`.** С такими методами продление — одна строка: документ
879
+ не читается и не пишется. Политика и guards проверяются полностью
880
+ (`withAttempt`), когда сменилась `dataVersion` или с прошлой полной
881
+ проверки прошёл `leaseMs`. Истёкший срок не продлевается и прежним token.
882
+ Без методов — прежний путь (`putAttempt` со сроком).
883
+ - **Standalone SQLite.** Таблица `leases(kind, id, token, owner, engine,
884
+ until)` и метка документа `leaseRows: true`. Первая строка ставит метку и
885
+ переносит в строки сроки всех активных попыток одной транзакцией; открытие
886
+ базы с активными попытками без метки делает это сразу. Документ читается при
887
+ первом обращении к записям модели и пишется, только если транзакция их
888
+ изменила. **Прежняя версия отклоняет документ с меткой до записи**
889
+ (строгая схема). Откат: остановить очередь, `SqliteExecutionStore.stepDownLeases()`
890
+ (срок строки — в документ, метка и строки сняты одной транзакцией), затем
891
+ вернуть прежний пакет; не открывать базу новой версией между ними.
892
+ **Откат возможен, только пока в журнале нет `attempt.diagnosed` с новыми
893
+ причинами `process-reap` или `cleanup`**: прежняя версия разбирает
894
+ известные события строго, и `events()` (доска, отчёт, повтор) упадёт на
895
+ первом таком событии, а исправить базу она не сможет. Проверка перед
896
+ откатом (по `state.sqlite`):
897
+
898
+ ```sql
899
+ SELECT count(*) FROM events
900
+ WHERE json_extract(data, '$.type') = 'attempt.diagnosed'
901
+ AND json_extract(data, '$.payload.cause') IN ('process-reap', 'cleanup');
902
+ ```
903
+
904
+ Не 0 — оставаться на 0.1.0-alpha.47 или вернуть копию базы, снятую до
905
+ обновления (работа после неё теряется). Копию базы снимайте перед
906
+ обновлением.
907
+
908
+ - **Перед обновлением остановите прежний процесс.** Открытие базы новой
909
+ версией для записи при идущих попытках переносит их сроки в строки и
910
+ ставит метку: работающая очередь прежней версии на следующем продлении
911
+ получает отказ и прерывает все свои попытки (двойного владения нет, но
912
+ работа теряется до истечения и повтора). Останавливайте прежний `run` до
913
+ первой команды новой версии.
914
+ - **Граница проверки политики.** Продление строкой проверяет политику и
915
+ guards полностью, когда сменилась `dataVersion` или с прошлой полной
916
+ проверки прошёл `leaseMs`. Условие guard хоста, хранящееся вне записей с
917
+ `dataVersion`, замечается не позже чем через ~`leaseMs + leaseMs/3`, а не
918
+ на следующем продлении.
919
+ - **Формат проверяется и в продлении.** Транзакция, в том числе только
920
+ продлевающая строку, разбирает документ строгой схемой, если его могло
921
+ изменить другое соединение (`PRAGMA data_version`): документ более новой
922
+ версии — отказ до записи, как прежде.
923
+
924
+ ### 0.1.0-alpha.46: ожидание проверки базы, исходы заданий, провайдеры условных gates
925
+
926
+ Номера форматов и формат состояния прежние (`stateVersion: 1`,
927
+ `policyVersion: 1`); новых строк матрицы нет. Изменения — поведение и
928
+ необязательные поля.
929
+
930
+ - **Ожидание `base-check` держит выдачу.** Пока в `control.waits` есть запись
931
+ `base-check`, `Engine.claim` не выдаёт работу при любом `paused`;
932
+ `blockers()` без паузы называет причину кодом `PAUSED`. `clearFailure`,
933
+ снявший последний класс паузы `runtime` под таким ожиданием, переводит
934
+ паузу в `base-check` (`pausedAt` — время перехода, событие
935
+ `control.paused` с этой причиной); `queuePause` — ожидание controller.
936
+ `resume()` прежний и остаётся единственным маршрутом движка, снимающим
937
+ ожидание («подтвердить базу и начать»). Хост DevContour в своём цикле
938
+ ведущего переводит паузу сам (`settleFailure`) и `clearFailure` в этот
939
+ момент не вызывает; оба перехода ставят время паузы на момент перехода.
940
+ - **Исходы заданий технической очереди.** `WorkflowQueue.fail()` добавляет в
941
+ историю событие нового статуса (`failed`, `stale`, `queued` у прерванной
942
+ стадии) и ставит `finishedAt` у `failed` и `stale`; `claim()` ставит
943
+ `finishedAt`, когда останавливает задание; `retry()` снимает его и
944
+ добавляет событие `queued`. Задания без `finishedAt` читаются как прежде.
945
+ Хост, возвращающий задание в очередь сам, снимает `finishedAt` сам.
946
+ - **`repairs[].key` пакета передачи.** Строка восстановлений несёт
947
+ необязательный ключ задания рядом со статусом; пакеты без него допустимы.
948
+ Прежняя версия (строгая схема) пакет с ключом отклоняет — пакеты
949
+ строятся по запросу.
950
+ - **Провайдеры условных gates.** Условный gate с зелёным SHA исполняется,
951
+ если SHA провайдера (`dependsOn` репозитория и все репозитории снимков
952
+ зависимостей, в том числе транзитивные) отличается от снимка принятой
953
+ попытки зелёного SHA или снимка нет у одной из попыток, — что бы ни
954
+ сдвинуло провайдера. Artifacts не сравниваются; смену `dependencyBuild`
955
+ провайдера при том же SHA правило не видит. `gateDecisions` получает
956
+ необязательный вход `providersMoved`: без него провайдеры считаются не
957
+ сдвинувшимися (вызывающий ручается за них; runner передаёт его всегда).
958
+ Новые экспорты — `providerMovement`, тип `ProviderSnapshot`.
959
+ - Откат на alpha.45 возможен без изменений состояния; пакет передачи с
960
+ `repairs[].key` alpha.45 не читает.
961
+
862
962
  ## Перед обновлением
863
963
 
864
964
  1. **Остановить записывающих.** Запретить новые выдачи (`harness pause`),