devcontour-harness 0.1.0-alpha.46 → 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.
- package/README.md +11 -2
- package/docs/compatibility.md +4 -1
- package/docs/contracts.md +7 -1
- package/docs/release-notes/0.1.0-alpha.47.md +138 -0
- package/docs/upgrade.md +62 -0
- package/lib/agents/review-probe.js +8 -3
- package/lib/contracts/cli.d.ts +10 -0
- package/lib/contracts/events.d.ts +13 -1
- package/lib/contracts/events.js +2 -0
- package/lib/contracts/execution.d.ts +1 -0
- package/lib/contracts/execution.js +8 -0
- package/lib/contracts/ports.d.ts +54 -0
- package/lib/contracts/published.d.ts +7 -0
- package/lib/contracts/report.d.ts +4 -0
- package/lib/control/harness.d.ts +1 -1
- package/lib/engine/classify.d.ts +6 -0
- package/lib/engine/classify.js +26 -0
- package/lib/engine/engine.d.ts +13 -0
- package/lib/engine/engine.js +46 -2
- package/lib/engine/runner.d.ts +11 -6
- package/lib/engine/runner.js +90 -22
- package/lib/environment/host-load.d.ts +12 -0
- package/lib/environment/host-load.js +7 -0
- package/lib/environment/lifecycle.d.ts +12 -1
- package/lib/environment/lifecycle.js +19 -2
- package/lib/environment/process.d.ts +71 -1
- package/lib/environment/process.js +149 -31
- package/lib/index.d.ts +4 -0
- package/lib/index.js +6 -0
- package/lib/report/document.js +2 -0
- package/lib/storage/sqlite.d.ts +47 -4
- package/lib/storage/sqlite.js +279 -34
- package/lib/testing/store-contract.d.ts +9 -0
- package/lib/testing/store-contract.js +235 -0
- package/lib/verification/gates-at.js +15 -1
- package/lib/verification/gates.d.ts +3 -10
- package/lib/verification/gates.js +136 -15
- package/lib/verification/reaped.d.ts +24 -0
- package/lib/verification/reaped.js +24 -0
- package/package.json +1 -1
- package/schemas/execution-document.schema.json +4 -0
- package/schemas/run-event.schema.json +2 -0
- 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.
|
|
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.
|
|
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,15 @@ 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
|
+
|
|
152
161
|
## Выпуск 0.1.0-alpha.46
|
|
153
162
|
|
|
154
163
|
Выдача не начинается, пока хост ждёт подтверждения перенесённой базы
|
package/docs/compatibility.md
CHANGED
|
@@ -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
|
@@ -1084,7 +1084,13 @@ hadAttempt}`. `engine.cancel(workId, reason?, by?)` (CLI `cancel` — `operator`
|
|
|
1084
1084
|
точке обнаружения (`TaskFailure.diagnosis`); `transport`, `preflight`
|
|
1085
1085
|
(`BlockedError` до работы), `provider-auth`, `provider-limit`, `stalled`,
|
|
1086
1086
|
`shutdown` (прерывание штатной остановкой), `lease-expired` — по классу отказа
|
|
1087
|
-
и его признакам; `
|
|
1087
|
+
и его признакам; `process-reap` — потомков сдерживаемой команды (gate,
|
|
1088
|
+
вызова runtime) не удалось остановить или пересчитать (`ReapFailure`):
|
|
1089
|
+
проверка не пройдена и на том же дереве не повторяется;
|
|
1090
|
+
`cleanup` — ресурсы попытки не освобождены: не убраны временные каталоги
|
|
1091
|
+
завершившейся проверки или не завершилась очистка окружения (lifecycle
|
|
1092
|
+
teardown) без отказа самой работы; при отказе работы класс и причина — его
|
|
1093
|
+
(`CleanupFailure.original`); `other` — отказ окружения без известной причины; `none` —
|
|
1088
1094
|
отказ не окружения. Хост, вызывающий `engine.fail`, может передать
|
|
1089
1095
|
`options.cause`; движок приводит её к классу (у отказа не окружения — всегда
|
|
1090
1096
|
`none`). `counted` — отказ засчитан в предел попыток (`maxAttempts`): не
|
|
@@ -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
|
@@ -859,6 +859,68 @@ 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
|
+
|
|
862
924
|
### 0.1.0-alpha.46: ожидание проверки базы, исходы заданий, провайдеры условных gates
|
|
863
925
|
|
|
864
926
|
Номера форматов и формат состояния прежние (`stateVersion: 1`,
|
|
@@ -11,7 +11,8 @@ import { idSchema, relativePathSchema, sha256, TaskFailure, gateTimeoutMs, } fro
|
|
|
11
11
|
import { dependencyNetworkFailure, dependencyNetworkMessage, } from "../environment/dependency-network.js";
|
|
12
12
|
import { osToolEnv } from "../environment/os-tools.js";
|
|
13
13
|
import { redactor } from "../environment/redaction.js";
|
|
14
|
-
import { completedCheck, freshnessEnv, propertyReportEnv, junitSummary, runCheck, sandboxBlockedHosts, } from "../verification/gates.js";
|
|
14
|
+
import { completedCheck, freshnessEnv, propertyReportEnv, junitSummary, reapedFailure, runCheck, sandboxBlockedHosts, } from "../verification/gates.js";
|
|
15
|
+
import { ReapFailure } from "../environment/process.js";
|
|
15
16
|
/**
|
|
16
17
|
* Пробные проверки reviewer под пределами harness.
|
|
17
18
|
*
|
|
@@ -339,7 +340,9 @@ export class ReviewProbes {
|
|
|
339
340
|
exitCode: done.timedOut || signal.aborted ? null : done.code,
|
|
340
341
|
stdout: tail(done.stdout),
|
|
341
342
|
stderr: tail(done.stderr),
|
|
342
|
-
note:
|
|
343
|
+
note: (error instanceof ReapFailure
|
|
344
|
+
? 'Проверка завершилась, но её потомки не остановлены или не пересчитаны — отказ среды после исхода: '
|
|
345
|
+
: 'Проверка завершилась, но controller не убрал её временные каталоги — отказ среды после исхода: ') +
|
|
343
346
|
message,
|
|
344
347
|
}
|
|
345
348
|
: signal.aborted && !launch.started
|
|
@@ -665,7 +668,9 @@ export class ReviewProbes {
|
|
|
665
668
|
// процесса: код и вывод завершившейся проверки остаются в результате.
|
|
666
669
|
outcome = launch.started
|
|
667
670
|
? {
|
|
668
|
-
...environment(
|
|
671
|
+
...environment(reapedFailure(error)
|
|
672
|
+
? `Gate завершился, но его потомки не остановлены или не пересчитаны: ${message}.`
|
|
673
|
+
: `Gate запустился, но его evidence не сохранено: ${message}.`),
|
|
669
674
|
...((finished ??= completedCheck(error))
|
|
670
675
|
? {
|
|
671
676
|
exitCode: finished.timedOut || signal.aborted ? null : finished.code,
|
package/lib/contracts/cli.d.ts
CHANGED
|
@@ -1449,6 +1449,8 @@ export declare const eventsDataSchema: z.ZodObject<{
|
|
|
1449
1449
|
"dependency-network": "dependency-network";
|
|
1450
1450
|
"provider-limit": "provider-limit";
|
|
1451
1451
|
"lease-expired": "lease-expired";
|
|
1452
|
+
"process-reap": "process-reap";
|
|
1453
|
+
cleanup: "cleanup";
|
|
1452
1454
|
}>;
|
|
1453
1455
|
counted: z.ZodBoolean;
|
|
1454
1456
|
}, z.core.$strict> | z.ZodObject<{
|
|
@@ -1948,6 +1950,8 @@ export declare const eventsDataSchema: z.ZodObject<{
|
|
|
1948
1950
|
"dependency-network": "dependency-network";
|
|
1949
1951
|
"provider-limit": "provider-limit";
|
|
1950
1952
|
"lease-expired": "lease-expired";
|
|
1953
|
+
"process-reap": "process-reap";
|
|
1954
|
+
cleanup: "cleanup";
|
|
1951
1955
|
}>;
|
|
1952
1956
|
counted: z.ZodBoolean;
|
|
1953
1957
|
}, z.core.$strict> | z.ZodObject<{
|
|
@@ -4273,6 +4277,8 @@ export declare const cliDataSchemas: {
|
|
|
4273
4277
|
"dependency-network": "dependency-network";
|
|
4274
4278
|
"provider-limit": "provider-limit";
|
|
4275
4279
|
"lease-expired": "lease-expired";
|
|
4280
|
+
"process-reap": "process-reap";
|
|
4281
|
+
cleanup: "cleanup";
|
|
4276
4282
|
}>;
|
|
4277
4283
|
counted: z.ZodBoolean;
|
|
4278
4284
|
}, z.core.$strict> | z.ZodObject<{
|
|
@@ -4772,6 +4778,8 @@ export declare const cliDataSchemas: {
|
|
|
4772
4778
|
"dependency-network": "dependency-network";
|
|
4773
4779
|
"provider-limit": "provider-limit";
|
|
4774
4780
|
"lease-expired": "lease-expired";
|
|
4781
|
+
"process-reap": "process-reap";
|
|
4782
|
+
cleanup: "cleanup";
|
|
4775
4783
|
}>;
|
|
4776
4784
|
counted: z.ZodBoolean;
|
|
4777
4785
|
}, z.core.$strict> | z.ZodObject<{
|
|
@@ -7146,6 +7154,8 @@ export declare const cliDataSchemas: {
|
|
|
7146
7154
|
"dependency-network": "dependency-network";
|
|
7147
7155
|
"provider-limit": "provider-limit";
|
|
7148
7156
|
"lease-expired": "lease-expired";
|
|
7157
|
+
"process-reap": "process-reap";
|
|
7158
|
+
cleanup: "cleanup";
|
|
7149
7159
|
}>;
|
|
7150
7160
|
count: z.ZodNumber;
|
|
7151
7161
|
counted: z.ZodNumber;
|
|
@@ -5,7 +5,7 @@ import { z } from 'zod';
|
|
|
5
5
|
* транспорт), а не разбором текста потом. `none` — отказ не окружения
|
|
6
6
|
* (код, ревью, область); `other` — отказ окружения без известной причины.
|
|
7
7
|
*/
|
|
8
|
-
export declare const environmentCauses: readonly ["sandbox-launch", "sandbox-network", "sandbox-filesystem", "sandbox-policy", "dependency-network", "provider-auth", "provider-limit", "transport", "preflight", "lease-expired", "stalled", "shutdown", "other", "none"];
|
|
8
|
+
export declare const environmentCauses: readonly ["sandbox-launch", "sandbox-network", "sandbox-filesystem", "sandbox-policy", "dependency-network", "provider-auth", "provider-limit", "transport", "preflight", "lease-expired", "stalled", "shutdown", "process-reap", "cleanup", "other", "none"];
|
|
9
9
|
export declare const environmentCauseSchema: z.ZodEnum<{
|
|
10
10
|
preflight: "preflight";
|
|
11
11
|
transport: "transport";
|
|
@@ -21,6 +21,8 @@ export declare const environmentCauseSchema: z.ZodEnum<{
|
|
|
21
21
|
"dependency-network": "dependency-network";
|
|
22
22
|
"provider-limit": "provider-limit";
|
|
23
23
|
"lease-expired": "lease-expired";
|
|
24
|
+
"process-reap": "process-reap";
|
|
25
|
+
cleanup: "cleanup";
|
|
24
26
|
}>;
|
|
25
27
|
export type EnvironmentCause = (typeof environmentCauses)[number];
|
|
26
28
|
/** Кто повторил поручение (`work.retried`): `host` — хост не назвал актёра. */
|
|
@@ -269,6 +271,8 @@ export declare const eventPayloads: {
|
|
|
269
271
|
"dependency-network": "dependency-network";
|
|
270
272
|
"provider-limit": "provider-limit";
|
|
271
273
|
"lease-expired": "lease-expired";
|
|
274
|
+
"process-reap": "process-reap";
|
|
275
|
+
cleanup: "cleanup";
|
|
272
276
|
}>;
|
|
273
277
|
counted: z.ZodBoolean;
|
|
274
278
|
}, z.core.$strict>;
|
|
@@ -871,6 +875,8 @@ export declare const runEventSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
|
|
|
871
875
|
"dependency-network": "dependency-network";
|
|
872
876
|
"provider-limit": "provider-limit";
|
|
873
877
|
"lease-expired": "lease-expired";
|
|
878
|
+
"process-reap": "process-reap";
|
|
879
|
+
cleanup: "cleanup";
|
|
874
880
|
}>;
|
|
875
881
|
counted: z.ZodBoolean;
|
|
876
882
|
}, z.core.$strict> | z.ZodObject<{
|
|
@@ -1370,6 +1376,8 @@ export declare const runEventSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
|
|
|
1370
1376
|
"dependency-network": "dependency-network";
|
|
1371
1377
|
"provider-limit": "provider-limit";
|
|
1372
1378
|
"lease-expired": "lease-expired";
|
|
1379
|
+
"process-reap": "process-reap";
|
|
1380
|
+
cleanup: "cleanup";
|
|
1373
1381
|
}>;
|
|
1374
1382
|
counted: z.ZodBoolean;
|
|
1375
1383
|
}, z.core.$strict> | z.ZodObject<{
|
|
@@ -1899,6 +1907,8 @@ export declare const readRunEventSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
|
|
|
1899
1907
|
"dependency-network": "dependency-network";
|
|
1900
1908
|
"provider-limit": "provider-limit";
|
|
1901
1909
|
"lease-expired": "lease-expired";
|
|
1910
|
+
"process-reap": "process-reap";
|
|
1911
|
+
cleanup: "cleanup";
|
|
1902
1912
|
}>;
|
|
1903
1913
|
counted: z.ZodBoolean;
|
|
1904
1914
|
}, z.core.$strict> | z.ZodObject<{
|
|
@@ -2398,6 +2408,8 @@ export declare const readRunEventSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
|
|
|
2398
2408
|
"dependency-network": "dependency-network";
|
|
2399
2409
|
"provider-limit": "provider-limit";
|
|
2400
2410
|
"lease-expired": "lease-expired";
|
|
2411
|
+
"process-reap": "process-reap";
|
|
2412
|
+
cleanup: "cleanup";
|
|
2401
2413
|
}>;
|
|
2402
2414
|
counted: z.ZodBoolean;
|
|
2403
2415
|
}, z.core.$strict> | z.ZodObject<{
|
package/lib/contracts/events.js
CHANGED
|
@@ -4231,6 +4231,7 @@ export declare const executionDocumentSchema: z.ZodObject<{
|
|
|
4231
4231
|
leaseUntil: z.ZodNumber;
|
|
4232
4232
|
engineVersion: z.ZodOptional<z.ZodString>;
|
|
4233
4233
|
}, z.core.$strict>>;
|
|
4234
|
+
leaseRows: z.ZodOptional<z.ZodLiteral<true>>;
|
|
4234
4235
|
sequence: z.ZodNumber;
|
|
4235
4236
|
}, z.core.$strict>;
|
|
4236
4237
|
export type ExecutionDocument = z.infer<typeof executionDocumentSchema>;
|
|
@@ -1139,6 +1139,14 @@ export const executionDocumentSchema = z.strictObject({
|
|
|
1139
1139
|
verifications: z.array(jointVerificationStateSchema).default([]),
|
|
1140
1140
|
control: controlStateSchema,
|
|
1141
1141
|
controller: controllerLeaseSchema.optional(),
|
|
1142
|
+
/**
|
|
1143
|
+
* Метка D53: сроки аренды активных попыток держат строки таблицы
|
|
1144
|
+
* `leases`, а `leaseUntil` попытки в документе — не источник (для отладки).
|
|
1145
|
+
* Прежние версии не знают поля и отказывают до любой записи (строгая
|
|
1146
|
+
* схема). Ставится первой строкой аренды вместе с переносом сроков всех
|
|
1147
|
+
* активных попыток; снимается шагом вниз (`stepDownLeases`).
|
|
1148
|
+
*/
|
|
1149
|
+
leaseRows: z.literal(true).optional(),
|
|
1142
1150
|
sequence: z.number().int().min(0),
|
|
1143
1151
|
});
|
|
1144
1152
|
/** Текст, который хранит fencing-токен, — проверка утечки в тестах и адаптерах. */
|
package/lib/contracts/ports.d.ts
CHANGED
|
@@ -25,6 +25,34 @@ export interface ExecutionView {
|
|
|
25
25
|
activeAttempts?(): AttemptState[];
|
|
26
26
|
verification(id: string): JointVerificationState | undefined;
|
|
27
27
|
verifications(): JointVerificationState[];
|
|
28
|
+
/**
|
|
29
|
+
* Аренда активной попытки — строка хранилища (D53), без проекции всей
|
|
30
|
+
* попытки и без чтения документа. `undefined` — у попытки нет аренды
|
|
31
|
+
* (она не активна, строки нет или token строки не её). Необязательный
|
|
32
|
+
* метод: адаптер, у которого он есть, обязан иметь и `renewLease`,
|
|
33
|
+
* `dataVersion` — тогда продление идёт строкой (`activeLeases` — по
|
|
34
|
+
* желанию: движок его не вызывает).
|
|
35
|
+
*
|
|
36
|
+
* Продление строкой проверяет политику и guards полностью (`withAttempt`)
|
|
37
|
+
* не на каждом продлении, а когда сменилась `dataVersion` или с прошлой
|
|
38
|
+
* полной проверки прошёл `leaseMs`. Условие guard хоста, которое хранится
|
|
39
|
+
* вне записей с `dataVersion`, движок замечает не позже чем через
|
|
40
|
+
* ~`leaseMs + leaseMs/3` (интервал продления — `leaseMs/3`), а не на
|
|
41
|
+
* следующем продлении.
|
|
42
|
+
*/
|
|
43
|
+
attemptLease?(id: string): AttemptLease | undefined;
|
|
44
|
+
/**
|
|
45
|
+
* Аренды активных попыток, ещё действующие в момент `at` (`leaseUntil > at`).
|
|
46
|
+
* Необязателен и движком не вызывается — для хоста и диагностики.
|
|
47
|
+
*/
|
|
48
|
+
activeLeases?(at: number): AttemptLease[];
|
|
49
|
+
/**
|
|
50
|
+
* Счётчик версии данных: меняется при каждой фиксации, которая записала
|
|
51
|
+
* записи модели, локальные записи или события, и не меняется продлением
|
|
52
|
+
* аренды (`renewLease`). По нему движок решает, нужна ли продлению полная
|
|
53
|
+
* проверка политики и guards.
|
|
54
|
+
*/
|
|
55
|
+
dataVersion?(): number;
|
|
28
56
|
/**
|
|
29
57
|
* Локальные записи исполнения, адресуемые `(namespace, owner, key)`.
|
|
30
58
|
* Пространства и схемы — `localSchemas`; `owner` — репозиторий, за которым
|
|
@@ -53,6 +81,24 @@ export interface ExecutionTransaction extends ExecutionView {
|
|
|
53
81
|
setController(lease: ControllerLease | undefined): void;
|
|
54
82
|
putLocal<N extends LocalNamespace>(namespace: N, owner: string, key: string, value: LocalValue<N>): void;
|
|
55
83
|
emit(event: RunEventDraft): void;
|
|
84
|
+
/**
|
|
85
|
+
* Условное продление одной строки аренды (D53): срок становится `until`,
|
|
86
|
+
* только если строка `(kind, id)` есть, её token, владелец и версия движка
|
|
87
|
+
* совпадают с переданными и срок ещё не истёк (`leaseUntil > now`).
|
|
88
|
+
* `true` — продлено. Записи модели, события и `dataVersion` не меняются.
|
|
89
|
+
* Истёкший срок не продлевается даже прежним token.
|
|
90
|
+
*/
|
|
91
|
+
renewLease?(kind: LeaseKind, id: string, token: string, owner: string, engineVersion: string | undefined, until: number, now: number): boolean;
|
|
92
|
+
}
|
|
93
|
+
/** Вид аренды, которую хранилище держит строкой. Пока только попытки. */
|
|
94
|
+
export type LeaseKind = 'attempt';
|
|
95
|
+
/** Строка аренды попытки: кто держит попытку и до какого момента. */
|
|
96
|
+
export interface AttemptLease {
|
|
97
|
+
id: string;
|
|
98
|
+
token: string;
|
|
99
|
+
owner: string;
|
|
100
|
+
engineVersion: string | undefined;
|
|
101
|
+
leaseUntil: number;
|
|
56
102
|
}
|
|
57
103
|
/** Результат транзакции не может быть Promise: внутри нельзя ждать внешней работы. */
|
|
58
104
|
export type NotPromise<T> = T extends PromiseLike<unknown> ? never : T;
|
|
@@ -72,6 +118,14 @@ export type NotPromise<T> = T extends PromiseLike<unknown> ? never : T;
|
|
|
72
118
|
* - событие фиксируется вместе с транзакцией, даже если она не изменила
|
|
73
119
|
* записей модели (только `emit` или только локальная запись и `emit`);
|
|
74
120
|
* - `kind === 'heartbeat'` продлевает только сроки владения и не создаёт события;
|
|
121
|
+
* у адаптера со строками аренды (`renewLease`) продление попытки меняет
|
|
122
|
+
* только её строку: документ, записи модели и `dataVersion` прежние;
|
|
123
|
+
* - аренда попытки (D53): `putAttempt` активной попытки пишет её строку
|
|
124
|
+
* аренды (token, владелец, версия движка, `leaseUntil`) той же
|
|
125
|
+
* транзакцией, неактивной — удаляет; чтение попытки (`attempt`,
|
|
126
|
+
* `attempts`, `activeAttempts`) отдаёт срок из строки, пока token строки
|
|
127
|
+
* равен token попытки, а без такой строки у активной попытки срок 0
|
|
128
|
+
* (аренды нет). Правило «максимум строки и документа» не действует;
|
|
75
129
|
* - внутри `fn` допустим один синхронный внешний эффект — CAS продвижения
|
|
76
130
|
* target ref (`git update-ref <ref> <new> <old>`) при приёмке: он
|
|
77
131
|
* выполняется до фиксации, и его отказ откатывает транзакцию. Падение
|
|
@@ -1916,6 +1916,8 @@ export declare const publishedSchemas: {
|
|
|
1916
1916
|
"dependency-network": "dependency-network";
|
|
1917
1917
|
"provider-limit": "provider-limit";
|
|
1918
1918
|
"lease-expired": "lease-expired";
|
|
1919
|
+
"process-reap": "process-reap";
|
|
1920
|
+
cleanup: "cleanup";
|
|
1919
1921
|
}>;
|
|
1920
1922
|
counted: z.ZodBoolean;
|
|
1921
1923
|
}, z.core.$strict> | z.ZodObject<{
|
|
@@ -2415,6 +2417,8 @@ export declare const publishedSchemas: {
|
|
|
2415
2417
|
"dependency-network": "dependency-network";
|
|
2416
2418
|
"provider-limit": "provider-limit";
|
|
2417
2419
|
"lease-expired": "lease-expired";
|
|
2420
|
+
"process-reap": "process-reap";
|
|
2421
|
+
cleanup: "cleanup";
|
|
2418
2422
|
}>;
|
|
2419
2423
|
counted: z.ZodBoolean;
|
|
2420
2424
|
}, z.core.$strict> | z.ZodObject<{
|
|
@@ -4102,6 +4106,7 @@ export declare const publishedSchemas: {
|
|
|
4102
4106
|
leaseUntil: z.ZodNumber;
|
|
4103
4107
|
engineVersion: z.ZodOptional<z.ZodString>;
|
|
4104
4108
|
}, z.core.$strict>>;
|
|
4109
|
+
leaseRows: z.ZodOptional<z.ZodLiteral<true>>;
|
|
4105
4110
|
sequence: z.ZodNumber;
|
|
4106
4111
|
}, z.core.$strict>;
|
|
4107
4112
|
readonly 'stack-profile': z.ZodObject<{
|
|
@@ -4994,6 +4999,8 @@ export declare const publishedSchemas: {
|
|
|
4994
4999
|
"dependency-network": "dependency-network";
|
|
4995
5000
|
"provider-limit": "provider-limit";
|
|
4996
5001
|
"lease-expired": "lease-expired";
|
|
5002
|
+
"process-reap": "process-reap";
|
|
5003
|
+
cleanup: "cleanup";
|
|
4997
5004
|
}>;
|
|
4998
5005
|
count: z.ZodNumber;
|
|
4999
5006
|
counted: z.ZodNumber;
|
|
@@ -551,6 +551,8 @@ export declare const valueReportSchema: z.ZodObject<{
|
|
|
551
551
|
"dependency-network": "dependency-network";
|
|
552
552
|
"provider-limit": "provider-limit";
|
|
553
553
|
"lease-expired": "lease-expired";
|
|
554
|
+
"process-reap": "process-reap";
|
|
555
|
+
cleanup: "cleanup";
|
|
554
556
|
}>;
|
|
555
557
|
count: z.ZodNumber;
|
|
556
558
|
counted: z.ZodNumber;
|
|
@@ -1174,6 +1176,8 @@ export declare const reportDataSchema: z.ZodUnion<readonly [z.ZodObject<{
|
|
|
1174
1176
|
"dependency-network": "dependency-network";
|
|
1175
1177
|
"provider-limit": "provider-limit";
|
|
1176
1178
|
"lease-expired": "lease-expired";
|
|
1179
|
+
"process-reap": "process-reap";
|
|
1180
|
+
cleanup: "cleanup";
|
|
1177
1181
|
}>;
|
|
1178
1182
|
count: z.ZodNumber;
|
|
1179
1183
|
counted: z.ZodNumber;
|
package/lib/control/harness.d.ts
CHANGED
|
@@ -3809,7 +3809,7 @@ export declare class Harness {
|
|
|
3809
3809
|
timeLimit: number;
|
|
3810
3810
|
causes: {
|
|
3811
3811
|
rows: {
|
|
3812
|
-
cause: "preflight" | "transport" | "none" | "other" | "provider-auth" | "stalled" | "shutdown" | "sandbox-launch" | "sandbox-network" | "sandbox-filesystem" | "sandbox-policy" | "dependency-network" | "provider-limit" | "lease-expired";
|
|
3812
|
+
cause: "preflight" | "transport" | "none" | "other" | "provider-auth" | "stalled" | "shutdown" | "sandbox-launch" | "sandbox-network" | "sandbox-filesystem" | "sandbox-policy" | "dependency-network" | "provider-limit" | "lease-expired" | "process-reap" | "cleanup";
|
|
3813
3813
|
count: number;
|
|
3814
3814
|
counted: number;
|
|
3815
3815
|
}[];
|
package/lib/engine/classify.d.ts
CHANGED
|
@@ -1,5 +1,11 @@
|
|
|
1
1
|
import { BlockedError, type EnvironmentCause, type FailureKind } from '../contracts/index.ts';
|
|
2
2
|
export { BlockedError };
|
|
3
|
+
/**
|
|
4
|
+
* Отказ, по которому судится попытка: у незавершённой очистки окружения —
|
|
5
|
+
* исходный отказ работы (`CleanupFailure.original`, через все вложенные
|
|
6
|
+
* очистки), иначе сам отказ.
|
|
7
|
+
*/
|
|
8
|
+
export declare function failureOrigin(error: unknown): unknown;
|
|
3
9
|
/**
|
|
4
10
|
* Отказ провайдера, а не работы: он повторится на любой следующей выдаче.
|
|
5
11
|
* Список узкий намеренно — временные ошибки сети сюда не входят.
|