devcontour-harness 0.1.0-alpha.45 → 0.1.0-alpha.46
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/architecture.md +8 -0
- package/docs/contracts.md +18 -4
- package/docs/release-notes/0.1.0-alpha.46.md +63 -0
- package/docs/upgrade.md +57 -19
- package/lib/contracts/cli.d.ts +1 -0
- package/lib/contracts/execution.js +5 -0
- package/lib/contracts/handoff.d.ts +1 -0
- package/lib/contracts/handoff.js +6 -1
- package/lib/contracts/published.d.ts +1 -0
- package/lib/control/workflow.d.ts +5 -1
- package/lib/control/workflow.js +18 -3
- package/lib/engine/engine.d.ts +12 -2
- package/lib/engine/engine.js +30 -5
- package/lib/engine/runner.js +17 -12
- package/lib/handoff/pack.js +7 -1
- package/lib/index.d.ts +1 -1
- package/lib/index.js +1 -1
- package/lib/verification/applicability.d.ts +25 -2
- package/lib/verification/applicability.js +34 -1
- package/package.json +1 -1
- package/schemas/handoff-pack.schema.json +4 -0
package/README.md
CHANGED
|
@@ -5,7 +5,7 @@ Headless-движок исполнения инженерных поручени
|
|
|
5
5
|
интеграция с принятой веткой через compare-and-swap и машинный результат с SHA
|
|
6
6
|
и доказательствами.
|
|
7
7
|
|
|
8
|
-
> Статус: `0.1.0-alpha.
|
|
8
|
+
> Статус: `0.1.0-alpha.46` — предварительный выпуск (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.46 # точная версия
|
|
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.46
|
|
153
|
+
|
|
154
|
+
Выдача не начинается, пока хост ждёт подтверждения перенесённой базы
|
|
155
|
+
(`base-check`), и восстановление отказа не снимает такую паузу. Остановленные
|
|
156
|
+
задания технической очереди получают время и событие исхода, пакет передачи —
|
|
157
|
+
ключ задания в `repairs`, а условный gate потребителя исполняется, когда SHA
|
|
158
|
+
его провайдера сдвинулся с зелёного SHA.
|
|
159
|
+
Подробно — [заметки выпуска](docs/release-notes/0.1.0-alpha.46.md).
|
|
160
|
+
|
|
152
161
|
## Выпуск 0.1.0-alpha.45
|
|
153
162
|
|
|
154
163
|
Gate задачи может объявить `when: { paths: [...] }`: runner исполняет его,
|
package/docs/architecture.md
CHANGED
|
@@ -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 и
|
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
|
-
(`
|
|
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`.
|
|
256
|
+
`providerMovement`, `notApplicableProblem`, `gateDigest`. У `gateDecisions`
|
|
257
|
+
вход `providersMoved` необязателен: без него провайдеры считаются не
|
|
258
|
+
сдвинувшимися — вызывающий ручается, что `changedFor` даёт зелёный SHA только
|
|
259
|
+
под теми же SHA провайдеров (runner передаёт его всегда). Основание включает версию harness:
|
|
248
260
|
после обновления пакета каждый условный gate исполняется один раз. Не входят
|
|
249
261
|
в основание образ контейнера по изменяемому тегу и переменные окружения
|
|
250
262
|
хоста, передаваемые по имени (`environment.inherit`): их смену gate не видит.
|
|
@@ -1340,7 +1352,9 @@ HTML ≤ 1 МБ. Усечение отмечено флагом и ограни
|
|
|
1340
1352
|
`complete` и причины неполноты (вызовы без стоимости, незавершённые,
|
|
1341
1353
|
брошенные, попытки без учёта); при неполном расходе сумма — нижняя граница
|
|
1342
1354
|
(«≥ $X (неполно: …)» в Markdown), остаток — `null`. `repairs` —
|
|
1343
|
-
восстановления незавершённых заданий
|
|
1355
|
+
восстановления незавершённых заданий графов: `graphId`, `key` (ключ
|
|
1356
|
+
задания; у графа после новой редакции их несколько, и прежнее — `stale`),
|
|
1357
|
+
`status` задания, `used` и `budget`; у пакетов прежних версий `key` нет;
|
|
1344
1358
|
- `next` — следующий шаг доски: первое решение; иначе идущая попытка со
|
|
1345
1359
|
свежим сроком владения — ждать (без controller — до `leaseUntil`); попытка
|
|
1346
1360
|
с истёкшим сроком или очередь без 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 без изменений состояния.
|
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,44 @@ alpha.45 матрицы форматов — новый вид evidence и но
|
|
|
859
859
|
копию. Без условных gates таких записей нет, и откат возможен без
|
|
860
860
|
изменений состояния.
|
|
861
861
|
|
|
862
|
+
### 0.1.0-alpha.46: ожидание проверки базы, исходы заданий, провайдеры условных gates
|
|
863
|
+
|
|
864
|
+
Номера форматов и формат состояния прежние (`stateVersion: 1`,
|
|
865
|
+
`policyVersion: 1`); новых строк матрицы нет. Изменения — поведение и
|
|
866
|
+
необязательные поля.
|
|
867
|
+
|
|
868
|
+
- **Ожидание `base-check` держит выдачу.** Пока в `control.waits` есть запись
|
|
869
|
+
`base-check`, `Engine.claim` не выдаёт работу при любом `paused`;
|
|
870
|
+
`blockers()` без паузы называет причину кодом `PAUSED`. `clearFailure`,
|
|
871
|
+
снявший последний класс паузы `runtime` под таким ожиданием, переводит
|
|
872
|
+
паузу в `base-check` (`pausedAt` — время перехода, событие
|
|
873
|
+
`control.paused` с этой причиной); `queuePause` — ожидание controller.
|
|
874
|
+
`resume()` прежний и остаётся единственным маршрутом движка, снимающим
|
|
875
|
+
ожидание («подтвердить базу и начать»). Хост DevContour в своём цикле
|
|
876
|
+
ведущего переводит паузу сам (`settleFailure`) и `clearFailure` в этот
|
|
877
|
+
момент не вызывает; оба перехода ставят время паузы на момент перехода.
|
|
878
|
+
- **Исходы заданий технической очереди.** `WorkflowQueue.fail()` добавляет в
|
|
879
|
+
историю событие нового статуса (`failed`, `stale`, `queued` у прерванной
|
|
880
|
+
стадии) и ставит `finishedAt` у `failed` и `stale`; `claim()` ставит
|
|
881
|
+
`finishedAt`, когда останавливает задание; `retry()` снимает его и
|
|
882
|
+
добавляет событие `queued`. Задания без `finishedAt` читаются как прежде.
|
|
883
|
+
Хост, возвращающий задание в очередь сам, снимает `finishedAt` сам.
|
|
884
|
+
- **`repairs[].key` пакета передачи.** Строка восстановлений несёт
|
|
885
|
+
необязательный ключ задания рядом со статусом; пакеты без него допустимы.
|
|
886
|
+
Прежняя версия (строгая схема) пакет с ключом отклоняет — пакеты
|
|
887
|
+
строятся по запросу.
|
|
888
|
+
- **Провайдеры условных gates.** Условный gate с зелёным SHA исполняется,
|
|
889
|
+
если SHA провайдера (`dependsOn` репозитория и все репозитории снимков
|
|
890
|
+
зависимостей, в том числе транзитивные) отличается от снимка принятой
|
|
891
|
+
попытки зелёного SHA или снимка нет у одной из попыток, — что бы ни
|
|
892
|
+
сдвинуло провайдера. Artifacts не сравниваются; смену `dependencyBuild`
|
|
893
|
+
провайдера при том же SHA правило не видит. `gateDecisions` получает
|
|
894
|
+
необязательный вход `providersMoved`: без него провайдеры считаются не
|
|
895
|
+
сдвинувшимися (вызывающий ручается за них; runner передаёт его всегда).
|
|
896
|
+
Новые экспорты — `providerMovement`, тип `ProviderSnapshot`.
|
|
897
|
+
- Откат на alpha.45 возможен без изменений состояния; пакет передачи с
|
|
898
|
+
`repairs[].key` alpha.45 не читает.
|
|
899
|
+
|
|
862
900
|
## Перед обновлением
|
|
863
901
|
|
|
864
902
|
1. **Остановить записывающих.** Запретить новые выдачи (`harness pause`),
|
package/lib/contracts/cli.d.ts
CHANGED
|
@@ -999,8 +999,13 @@ export const workflowJobSchema = z.strictObject({
|
|
|
999
999
|
token: z.string().optional(),
|
|
1000
1000
|
leaseUntil: z.number().int().min(0).optional(),
|
|
1001
1001
|
startedAt: isoTimeSchema,
|
|
1002
|
+
/**
|
|
1003
|
+
* Время окончания: `completed`, `failed`, `stale`. Повтор человека его
|
|
1004
|
+
* снимает. У заданий, остановленных прежними версиями, может отсутствовать.
|
|
1005
|
+
*/
|
|
1002
1006
|
finishedAt: isoTimeSchema.optional(),
|
|
1003
1007
|
error: z.string().optional(),
|
|
1008
|
+
/** События стадий: захват (`running`), исход (`completed`, `failed`, `stale`, `queued`), восстановления. */
|
|
1004
1009
|
history: z.array(z.strictObject({ at: isoTimeSchema, stage: z.number().int().min(0), event: z.string() })),
|
|
1005
1010
|
});
|
|
1006
1011
|
/* ------------------------------------------------------------------ */
|
package/lib/contracts/handoff.js
CHANGED
|
@@ -267,10 +267,15 @@ export const handoffPackSchema = z.strictObject({
|
|
|
267
267
|
})),
|
|
268
268
|
})
|
|
269
269
|
.optional(),
|
|
270
|
-
/**
|
|
270
|
+
/**
|
|
271
|
+
* Восстановления заданий графов: потрачено против бюджета. `key` — ключ
|
|
272
|
+
* задания (у графа после новой редакции их несколько: прежнее — `stale`);
|
|
273
|
+
* `status` — статус задания. У пакетов прежних версий ключа нет.
|
|
274
|
+
*/
|
|
271
275
|
repairs: z
|
|
272
276
|
.array(z.strictObject({
|
|
273
277
|
graphId: idSchema,
|
|
278
|
+
key: digestSchema.optional(),
|
|
274
279
|
status: z.string().max(40),
|
|
275
280
|
used: count,
|
|
276
281
|
budget: count,
|
|
@@ -5679,6 +5679,7 @@ export declare const publishedSchemas: {
|
|
|
5679
5679
|
}, z.core.$strict>>;
|
|
5680
5680
|
repairs: z.ZodArray<z.ZodObject<{
|
|
5681
5681
|
graphId: z.ZodString;
|
|
5682
|
+
key: z.ZodOptional<z.ZodString>;
|
|
5682
5683
|
status: z.ZodString;
|
|
5683
5684
|
used: z.ZodNumber;
|
|
5684
5685
|
budget: z.ZodNumber;
|
|
@@ -221,7 +221,11 @@ export declare class WorkflowQueue {
|
|
|
221
221
|
finishedAt?: string | undefined;
|
|
222
222
|
error?: string | undefined;
|
|
223
223
|
};
|
|
224
|
-
/**
|
|
224
|
+
/**
|
|
225
|
+
* Отказ стадии: прерванная — снова в очереди, изменившийся вход — `stale`,
|
|
226
|
+
* иначе `failed`. Новый статус — событие истории; остановленное задание
|
|
227
|
+
* (`failed`, `stale`) получает время окончания.
|
|
228
|
+
*/
|
|
225
229
|
fail(job: WorkflowJob, message: string, interrupted?: boolean): void;
|
|
226
230
|
/**
|
|
227
231
|
* Записать восстановление и выполнить его одной транзакцией. Счётчик и само
|
package/lib/control/workflow.js
CHANGED
|
@@ -166,6 +166,8 @@ export class WorkflowQueue {
|
|
|
166
166
|
next.leaseUntil = this.now() + this.policy.leaseMs;
|
|
167
167
|
next.attempts = job.attempts + 1;
|
|
168
168
|
}
|
|
169
|
+
if (next.status !== 'running')
|
|
170
|
+
next.finishedAt = iso(this.now());
|
|
169
171
|
next.history.push({ at: iso(this.now()), stage: job.stage, event: next.status });
|
|
170
172
|
tx.putLocal('workflow-jobs', WorkflowQueue.owner(owner), key, next);
|
|
171
173
|
return next.status === 'running' ? next : undefined;
|
|
@@ -232,16 +234,24 @@ export class WorkflowQueue {
|
|
|
232
234
|
return next;
|
|
233
235
|
});
|
|
234
236
|
}
|
|
235
|
-
/**
|
|
237
|
+
/**
|
|
238
|
+
* Отказ стадии: прерванная — снова в очереди, изменившийся вход — `stale`,
|
|
239
|
+
* иначе `failed`. Новый статус — событие истории; остановленное задание
|
|
240
|
+
* (`failed`, `stale`) получает время окончания.
|
|
241
|
+
*/
|
|
236
242
|
fail(job, message, interrupted = false) {
|
|
237
243
|
this.store.transact('workflow.updated', (tx) => {
|
|
238
244
|
const current = tx.local('workflow-jobs', WorkflowQueue.owner(job.owner), job.key);
|
|
239
245
|
if (!current || current.token !== job.token || current.status !== 'running')
|
|
240
246
|
return;
|
|
247
|
+
const at = iso(this.now());
|
|
248
|
+
const status = !this.current(job, tx) ? 'stale' : interrupted ? 'queued' : 'failed';
|
|
241
249
|
const next = {
|
|
242
250
|
...current,
|
|
243
|
-
status
|
|
251
|
+
status,
|
|
244
252
|
error: message.slice(0, 1000),
|
|
253
|
+
history: [...current.history, { at, stage: current.stage, event: status }],
|
|
254
|
+
...(status === 'queued' ? {} : { finishedAt: at }),
|
|
245
255
|
};
|
|
246
256
|
delete next.token;
|
|
247
257
|
delete next.leaseUntil;
|
|
@@ -274,8 +284,13 @@ export class WorkflowQueue {
|
|
|
274
284
|
throw new HarnessError('NOT_READY', 'Повтор задания недоступен; проверьте статус и попытки');
|
|
275
285
|
if (!this.current(job, tx))
|
|
276
286
|
throw new HarnessError('APPROVAL_STALE', 'Вход задания изменился: нужно новое задание');
|
|
277
|
-
const next = {
|
|
287
|
+
const next = {
|
|
288
|
+
...job,
|
|
289
|
+
status: 'queued',
|
|
290
|
+
history: [...job.history, { at: iso(this.now()), stage: job.stage, event: 'queued' }],
|
|
291
|
+
};
|
|
278
292
|
delete next.error;
|
|
293
|
+
delete next.finishedAt;
|
|
279
294
|
tx.putLocal('workflow-jobs', WorkflowQueue.owner(owner), key, next);
|
|
280
295
|
return next;
|
|
281
296
|
});
|
package/lib/engine/engine.d.ts
CHANGED
|
@@ -495,7 +495,10 @@ export declare class Engine {
|
|
|
495
495
|
* Снять паузу — решение человека (семантика DevContour `pause(false)`):
|
|
496
496
|
* снимает паузу оператора, штатной остановки и отказа runtime вместе с её
|
|
497
497
|
* классами отказов. Паузу операции reconfigure снимает только сама
|
|
498
|
-
* операция: `PAUSED`.
|
|
498
|
+
* операция: `PAUSED`. Это и явный маршрут человека «подтвердить базу и
|
|
499
|
+
* начать»: `resume` снимает ожидания `base-check`. Других путей снять их у
|
|
500
|
+
* движка нет — пока такое ожидание есть, `claim` не выдаёт работу при
|
|
501
|
+
* любом значении `paused`.
|
|
499
502
|
*/
|
|
500
503
|
resume(): {
|
|
501
504
|
control: {
|
|
@@ -527,7 +530,14 @@ export declare class Engine {
|
|
|
527
530
|
};
|
|
528
531
|
changed: boolean;
|
|
529
532
|
};
|
|
530
|
-
/**
|
|
533
|
+
/**
|
|
534
|
+
* Снять паузу отказа после устранения причины: только названные классы.
|
|
535
|
+
* Пока есть ожидание `base-check`, пауза остаётся и переходит в паузу
|
|
536
|
+
* `base-check`: устранённый отказ не подтверждает перенесённую базу (это
|
|
537
|
+
* делает человек через `resume`), а пауза `runtime` без классов отказа
|
|
538
|
+
* звала бы чинить окружение. Новая причина — новая пауза: `pausedAt` —
|
|
539
|
+
* время перехода (как у перехода хоста DevContour).
|
|
540
|
+
*/
|
|
531
541
|
clearFailure(kinds: FailureKind[]): {
|
|
532
542
|
paused: boolean;
|
|
533
543
|
pauseReason?: "operator" | "runtime" | "shutdown" | "base-check" | "reconfigure" | undefined;
|
package/lib/engine/engine.js
CHANGED
|
@@ -17,6 +17,8 @@ import { jointImpact, jointPolicyDigest, jointSpecDigest, publicJoint, sameWorks
|
|
|
17
17
|
/** Префикс причины неудавшегося продления: первая причина не затирается следствиями. */
|
|
18
18
|
export const HEARTBEAT_FAILED = 'Продление владения не удалось';
|
|
19
19
|
const iso = (ms) => new Date(ms).toISOString();
|
|
20
|
+
/** Хост ждёт подтверждения перенесённой базы: выдача закрыта при любом `paused`. */
|
|
21
|
+
const awaitsBaseCheck = (control) => (control.waits ?? []).some((w) => w.kind === 'base-check');
|
|
20
22
|
/** Содержание поручения без номера редакции источника: одинаковое содержание — та же работа. */
|
|
21
23
|
const contentDigest = (order) => digestOf({ ...order, source: { connector: order.source.connector, ref: order.source.ref } });
|
|
22
24
|
/**
|
|
@@ -557,7 +559,10 @@ export class Engine {
|
|
|
557
559
|
* Снять паузу — решение человека (семантика DevContour `pause(false)`):
|
|
558
560
|
* снимает паузу оператора, штатной остановки и отказа runtime вместе с её
|
|
559
561
|
* классами отказов. Паузу операции reconfigure снимает только сама
|
|
560
|
-
* операция: `PAUSED`.
|
|
562
|
+
* операция: `PAUSED`. Это и явный маршрут человека «подтвердить базу и
|
|
563
|
+
* начать»: `resume` снимает ожидания `base-check`. Других путей снять их у
|
|
564
|
+
* движка нет — пока такое ожидание есть, `claim` не выдаёт работу при
|
|
565
|
+
* любом значении `paused`.
|
|
561
566
|
*/
|
|
562
567
|
resume() {
|
|
563
568
|
return this.tx('scheduler.started', (tx) => {
|
|
@@ -583,21 +588,35 @@ export class Engine {
|
|
|
583
588
|
return { control: next, changed: true };
|
|
584
589
|
});
|
|
585
590
|
}
|
|
586
|
-
/**
|
|
591
|
+
/**
|
|
592
|
+
* Снять паузу отказа после устранения причины: только названные классы.
|
|
593
|
+
* Пока есть ожидание `base-check`, пауза остаётся и переходит в паузу
|
|
594
|
+
* `base-check`: устранённый отказ не подтверждает перенесённую базу (это
|
|
595
|
+
* делает человек через `resume`), а пауза `runtime` без классов отказа
|
|
596
|
+
* звала бы чинить окружение. Новая причина — новая пауза: `pausedAt` —
|
|
597
|
+
* время перехода (как у перехода хоста DevContour).
|
|
598
|
+
*/
|
|
587
599
|
clearFailure(kinds) {
|
|
588
600
|
return this.tx('scheduler.started', (tx) => {
|
|
589
601
|
const control = tx.control();
|
|
590
602
|
const left = (control.pauseFailures ?? []).filter((k) => !kinds.includes(k));
|
|
591
603
|
if (left.length === (control.pauseFailures ?? []).length)
|
|
592
604
|
return control;
|
|
593
|
-
const
|
|
605
|
+
const cleared = !left.length && control.pauseReason === 'runtime';
|
|
606
|
+
const waits = cleared && awaitsBaseCheck(control);
|
|
594
607
|
const next = {
|
|
595
608
|
...control,
|
|
596
609
|
pauseFailures: left.length ? left : undefined,
|
|
597
|
-
...(
|
|
610
|
+
...(cleared
|
|
611
|
+
? waits
|
|
612
|
+
? { pauseReason: 'base-check', pausedAt: iso(this.now()) }
|
|
613
|
+
: { paused: false, pauseReason: undefined, pausedAt: undefined }
|
|
614
|
+
: {}),
|
|
598
615
|
};
|
|
599
616
|
tx.setControl(next);
|
|
600
|
-
if (
|
|
617
|
+
if (waits)
|
|
618
|
+
tx.emit({ type: 'control.paused', payload: { reason: 'base-check' } });
|
|
619
|
+
else if (cleared)
|
|
601
620
|
tx.emit({ type: 'control.resumed', payload: { reason: 'runtime' } });
|
|
602
621
|
return next;
|
|
603
622
|
});
|
|
@@ -834,6 +853,8 @@ export class Engine {
|
|
|
834
853
|
code: 'PAUSED',
|
|
835
854
|
message: 'Очередь на паузе: ' + (view.control().pauseReason ?? 'operator'),
|
|
836
855
|
});
|
|
856
|
+
else if (awaitsBaseCheck(view.control()))
|
|
857
|
+
out.push({ code: 'PAUSED', message: 'Очередь ждёт подтверждения перенесённой базы' });
|
|
837
858
|
const reconfigure = this.reconfiguring(view);
|
|
838
859
|
if (reconfigure)
|
|
839
860
|
out.push({
|
|
@@ -931,6 +952,10 @@ export class Engine {
|
|
|
931
952
|
throw new HarnessError('CONTROLLER_BUSY', 'Выдавать попытки может только действующий controller');
|
|
932
953
|
if (tx.control().paused || this.host.guards.claimBarrier(tx))
|
|
933
954
|
return undefined;
|
|
955
|
+
// Перенесённая база не подтверждена хостом: снятый мимо `resume` флаг
|
|
956
|
+
// паузы (например, восстановлением отказа) выдачу не открывает.
|
|
957
|
+
if (awaitsBaseCheck(tx.control()))
|
|
958
|
+
return undefined;
|
|
934
959
|
// Пока операция применяет политику, попытки не выдаются, даже если
|
|
935
960
|
// человек снял паузу: попытка под прежней политикой не нужна.
|
|
936
961
|
if (this.reconfiguring(tx))
|
package/lib/engine/runner.js
CHANGED
|
@@ -21,7 +21,7 @@ import { GateTimeout, prepareWriterDependencies, draftTouchesInstall, runGate, w
|
|
|
21
21
|
import { ActivityScope, activityScope } from "../environment/activity.js";
|
|
22
22
|
import { StallSweep, StalledError, stallMessage, livenessPayload, } from "./stall-sweep.js";
|
|
23
23
|
import { orderedScope } from "../verification/gate-scope.js";
|
|
24
|
-
import { changedPaths, gateBasis, gateDecisions, proofGates, } from "../verification/applicability.js";
|
|
24
|
+
import { changedPaths, gateBasis, gateDecisions, proofGates, providerMovement, } from "../verification/applicability.js";
|
|
25
25
|
import { alreadySatisfiedVerdict, contractCheckGates, withinWriteScope, } from "../verification/already-satisfied.js";
|
|
26
26
|
import { assertDependencies, dependencyFreshness, removeSnapshots, snapshotDependencies, } from "../verification/dependencies.js";
|
|
27
27
|
import { CleanupFailure, cleanupEnvironment } from "../environment/lifecycle.js";
|
|
@@ -1747,23 +1747,23 @@ export class Runner {
|
|
|
1747
1747
|
.attempts()
|
|
1748
1748
|
.filter((x) => x.status === 'succeeded' && x.repositoryId === repo.id && x.integrationSha)
|
|
1749
1749
|
.sort((x, y) => (y.finishedAt ?? '').localeCompare(x.finishedAt ?? '')));
|
|
1750
|
+
// Снимок провайдеров текущей попытки — закреплённый в хранилище до реализации.
|
|
1751
|
+
const providers = this.engine.read((v) => v.attempt(attempt.id)?.dependencies);
|
|
1750
1752
|
const diffs = new Map();
|
|
1751
1753
|
const changed = new Map();
|
|
1754
|
+
const moved = new Map();
|
|
1752
1755
|
for (const gate of gates) {
|
|
1753
1756
|
if (!gate.when || proof.has(gate.id))
|
|
1754
1757
|
continue;
|
|
1755
1758
|
const basis = gateBasis(this.policy, repo, gate, this.engine.version);
|
|
1756
|
-
const
|
|
1757
|
-
|
|
1758
|
-
|
|
1759
|
-
|
|
1760
|
-
|
|
1761
|
-
|
|
1762
|
-
|
|
1763
|
-
|
|
1764
|
-
e.gateBasis === basis))
|
|
1765
|
-
.map((x) => x.integrationSha)),
|
|
1766
|
-
].slice(0, 50);
|
|
1759
|
+
const passed = greens.filter((x) => x.evidence.some((e) => e.kind === 'test' &&
|
|
1760
|
+
e.phase === 'integration' &&
|
|
1761
|
+
e.sha === x.integrationSha &&
|
|
1762
|
+
e.gate === gate.id &&
|
|
1763
|
+
e.consumer === undefined &&
|
|
1764
|
+
e.passed &&
|
|
1765
|
+
e.gateBasis === basis));
|
|
1766
|
+
const shas = [...new Set(passed.map((x) => x.integrationSha))].slice(0, 50);
|
|
1767
1767
|
let anchor;
|
|
1768
1768
|
for (const green of shas)
|
|
1769
1769
|
if (await git(cwd, 'merge-base', '--is-ancestor', green, base).then(() => true, () => false)) {
|
|
@@ -1772,6 +1772,10 @@ export class Runner {
|
|
|
1772
1772
|
}
|
|
1773
1773
|
if (!anchor)
|
|
1774
1774
|
continue;
|
|
1775
|
+
// Gate потребителя зависит и от провайдеров: их база с зелёного SHA
|
|
1776
|
+
// сравнивается со снимком попытки (`providerMovement`).
|
|
1777
|
+
const green = passed.find((x) => x.integrationSha === anchor);
|
|
1778
|
+
moved.set(gate.id, providerMovement(repo.dependsOn, green.dependencies, providers));
|
|
1775
1779
|
if (!diffs.has(anchor))
|
|
1776
1780
|
diffs.set(anchor, await changedPaths(cwd, [
|
|
1777
1781
|
{ from: anchor, to: candidate },
|
|
@@ -1784,6 +1788,7 @@ export class Runner {
|
|
|
1784
1788
|
scope: gates,
|
|
1785
1789
|
proof,
|
|
1786
1790
|
changedFor: (gate) => changed.get(gate.id),
|
|
1791
|
+
providersMoved: (gate) => moved.get(gate.id),
|
|
1787
1792
|
});
|
|
1788
1793
|
for (const d of decisions)
|
|
1789
1794
|
if (!d.run && d.record)
|
package/lib/handoff/pack.js
CHANGED
|
@@ -374,7 +374,13 @@ function build(h, options, maxBytes, measure) {
|
|
|
374
374
|
const repairsAll = h.workflows
|
|
375
375
|
.list()
|
|
376
376
|
.filter((j) => j.kind === 'graph' && graphIds.has(j.id) && j.status !== 'completed')
|
|
377
|
-
.map((j) => ({
|
|
377
|
+
.map((j) => ({
|
|
378
|
+
graphId: j.id,
|
|
379
|
+
key: j.key,
|
|
380
|
+
status: j.status,
|
|
381
|
+
used: j.repairs ?? 0,
|
|
382
|
+
budget: repairBudget,
|
|
383
|
+
}));
|
|
378
384
|
const repairs = repairsAll.slice(0, HANDOFF_LIMITS.repairs);
|
|
379
385
|
const controller = status.controller
|
|
380
386
|
? {
|
package/lib/index.d.ts
CHANGED
|
@@ -69,7 +69,7 @@ export { runGatesAt, type GatesAtContext, type GatesAtInput, type GatesAtResult,
|
|
|
69
69
|
export { dependencyStoreRoot, materializeStore, type StoreContext, type StoreReceipt, } from './verification/dependency-store.ts';
|
|
70
70
|
export { explicitPrerequisites, gatePrerequisites, orderedScope, standaloneScope, } from './verification/gate-scope.ts';
|
|
71
71
|
export { requirementProof, uncoveredGates, unprovenReason } from './verification/proof.ts';
|
|
72
|
-
export { changedPaths, coverageChanges, gateBasis, gateDecisions, gatePathRegExp, matchingPaths, notApplicableProblem, pathApplicability, proofGates, type ChangedPaths, type GateDecision, type PathDecision, } from './verification/applicability.ts';
|
|
72
|
+
export { changedPaths, coverageChanges, gateBasis, gateDecisions, gatePathRegExp, matchingPaths, notApplicableProblem, pathApplicability, proofGates, providerMovement, type ChangedPaths, type GateDecision, type PathDecision, type ProviderSnapshot, } from './verification/applicability.ts';
|
|
73
73
|
export { ReviewProbes, probeLimits, observeReproductions } from './agents/review-probe.ts';
|
|
74
74
|
export { composeRedactors, outputRedactor,
|
|
75
75
|
/**
|
package/lib/index.js
CHANGED
|
@@ -69,7 +69,7 @@ export { runGatesAt, } from "./verification/gates-at.js";
|
|
|
69
69
|
export { dependencyStoreRoot, materializeStore, } from "./verification/dependency-store.js";
|
|
70
70
|
export { explicitPrerequisites, gatePrerequisites, orderedScope, standaloneScope, } from "./verification/gate-scope.js";
|
|
71
71
|
export { requirementProof, uncoveredGates, unprovenReason } from "./verification/proof.js";
|
|
72
|
-
export { changedPaths, coverageChanges, gateBasis, gateDecisions, gatePathRegExp, matchingPaths, notApplicableProblem, pathApplicability, proofGates, } from "./verification/applicability.js";
|
|
72
|
+
export { changedPaths, coverageChanges, gateBasis, gateDecisions, gatePathRegExp, matchingPaths, notApplicableProblem, pathApplicability, proofGates, providerMovement, } from "./verification/applicability.js";
|
|
73
73
|
export { ReviewProbes, probeLimits, observeReproductions } from "./agents/review-probe.js";
|
|
74
74
|
export { composeRedactors, outputRedactor,
|
|
75
75
|
/**
|
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
import { type ExecutionPolicy, type ContractDocument, type GateApplicability, type GatePolicy, type WorkOrder } from '../contracts/index.ts';
|
|
1
|
+
import { type ExecutionPolicy, type ContractDocument, type AttemptState, type GateApplicability, type GatePolicy, type WorkOrder } from '../contracts/index.ts';
|
|
2
2
|
/**
|
|
3
3
|
* Применимость gate с `when.paths`. Решение принимает controller по
|
|
4
4
|
* настоящему diff фазы из Git, а не по заявлению исполнителя. Правило
|
|
@@ -75,6 +75,20 @@ export declare function pathApplicability(repo: {
|
|
|
75
75
|
* обязательства). Их доказательство — только исполнение.
|
|
76
76
|
*/
|
|
77
77
|
export declare function proofGates(order: Pick<WorkOrder, 'requirements' | 'properties'>, contracts: readonly ContractDocument[]): Set<string>;
|
|
78
|
+
/** Снимок провайдера, против которого шла попытка (`AttemptState.dependencies`). */
|
|
79
|
+
export type ProviderSnapshot = Pick<NonNullable<AttemptState['dependencies']>[number], 'repositoryId' | 'sha'>;
|
|
80
|
+
/**
|
|
81
|
+
* Почему база провайдеров сдвинулась с зелёного SHA gate, или undefined.
|
|
82
|
+
* Провайдеры — `dependsOn` репозитория и все репозитории снимков (в том числе
|
|
83
|
+
* транзитивные). Сдвиг — другой SHA провайдера; снимок провайдера, которого
|
|
84
|
+
* нет у зелёной попытки или у текущей (запись прежней версии, новый
|
|
85
|
+
* провайдер), — тоже сдвиг: изменение провайдера меняет вход gate
|
|
86
|
+
* потребителя, даже если diff потребителя не задел его путей. Artifacts
|
|
87
|
+
* провайдера не сравниваются: их пересобирают в каждой попытке, и
|
|
88
|
+
* невоспроизводимая сборка давала бы сдвиг на каждой; при том же SHA их
|
|
89
|
+
* вход — тот же источник.
|
|
90
|
+
*/
|
|
91
|
+
export declare function providerMovement(providers: readonly string[], green: readonly ProviderSnapshot[] | undefined, current: readonly ProviderSnapshot[] | undefined): string | undefined;
|
|
78
92
|
export interface GateDecisionInput {
|
|
79
93
|
repo: {
|
|
80
94
|
gates: GatePolicy[];
|
|
@@ -88,6 +102,14 @@ export interface GateDecisionInput {
|
|
|
88
102
|
* SHA фазы; undefined — такого SHA нет, и gate исполняется.
|
|
89
103
|
*/
|
|
90
104
|
changedFor(gate: GatePolicy): ChangedPaths | undefined;
|
|
105
|
+
/**
|
|
106
|
+
* Почему база провайдеров сдвинулась с того же зелёного SHA
|
|
107
|
+
* (`providerMovement`), или undefined. Спрашивается только у условного gate
|
|
108
|
+
* с зелёным SHA. Без поля провайдеры считаются не сдвинувшимися: вызывающий
|
|
109
|
+
* ручается, что `changedFor` даёт зелёный SHA только под теми же SHA
|
|
110
|
+
* провайдеров (или что провайдеров нет). Runner его передаёт всегда.
|
|
111
|
+
*/
|
|
112
|
+
providersMoved?(gate: GatePolicy): string | undefined;
|
|
91
113
|
/** `proofGates` поручения. */
|
|
92
114
|
proof: ReadonlySet<string>;
|
|
93
115
|
}
|
|
@@ -100,7 +122,8 @@ export interface GateDecision {
|
|
|
100
122
|
/**
|
|
101
123
|
* Решения по области фазы. Gate без `when` исполняется всегда. Условный
|
|
102
124
|
* исполняется, если: он доказывает требование или договор; среди предков
|
|
103
|
-
* базы нет его зелёного SHA под тем же основанием (`changedFor`);
|
|
125
|
+
* базы нет его зелёного SHA под тем же основанием (`changedFor`); с этого
|
|
126
|
+
* зелёного SHA сдвинулась база провайдеров (`providersMoved`); diff
|
|
104
127
|
* неизвестен, пуст или задевает его путь или неявный вход; он — предпосылка
|
|
105
128
|
* (`gatePrerequisites`: `dependsOn` или более ранний check gate) исполняемого
|
|
106
129
|
* gate области. Иначе — запись `not-applicable`.
|
|
@@ -293,10 +293,40 @@ export function proofGates(order, contracts) {
|
|
|
293
293
|
}
|
|
294
294
|
return out;
|
|
295
295
|
}
|
|
296
|
+
/**
|
|
297
|
+
* Почему база провайдеров сдвинулась с зелёного SHA gate, или undefined.
|
|
298
|
+
* Провайдеры — `dependsOn` репозитория и все репозитории снимков (в том числе
|
|
299
|
+
* транзитивные). Сдвиг — другой SHA провайдера; снимок провайдера, которого
|
|
300
|
+
* нет у зелёной попытки или у текущей (запись прежней версии, новый
|
|
301
|
+
* провайдер), — тоже сдвиг: изменение провайдера меняет вход gate
|
|
302
|
+
* потребителя, даже если diff потребителя не задел его путей. Artifacts
|
|
303
|
+
* провайдера не сравниваются: их пересобирают в каждой попытке, и
|
|
304
|
+
* невоспроизводимая сборка давала бы сдвиг на каждой; при том же SHA их
|
|
305
|
+
* вход — тот же источник.
|
|
306
|
+
*/
|
|
307
|
+
export function providerMovement(providers, green, current) {
|
|
308
|
+
const ids = [
|
|
309
|
+
...new Set([
|
|
310
|
+
...providers,
|
|
311
|
+
...(green ?? []).map((d) => d.repositoryId),
|
|
312
|
+
...(current ?? []).map((d) => d.repositoryId),
|
|
313
|
+
]),
|
|
314
|
+
].sort();
|
|
315
|
+
for (const id of ids) {
|
|
316
|
+
const from = green?.find((d) => d.repositoryId === id);
|
|
317
|
+
const to = current?.find((d) => d.repositoryId === id);
|
|
318
|
+
if (!from || !to)
|
|
319
|
+
return `снимок провайдера ${id} ${from ? 'попытки' : 'зелёного SHA'} неизвестен`;
|
|
320
|
+
if (from.sha !== to.sha)
|
|
321
|
+
return `база провайдера ${id} сдвинулась: ${from.sha.slice(0, 12)} → ${to.sha.slice(0, 12)}`;
|
|
322
|
+
}
|
|
323
|
+
return undefined;
|
|
324
|
+
}
|
|
296
325
|
/**
|
|
297
326
|
* Решения по области фазы. Gate без `when` исполняется всегда. Условный
|
|
298
327
|
* исполняется, если: он доказывает требование или договор; среди предков
|
|
299
|
-
* базы нет его зелёного SHA под тем же основанием (`changedFor`);
|
|
328
|
+
* базы нет его зелёного SHA под тем же основанием (`changedFor`); с этого
|
|
329
|
+
* зелёного SHA сдвинулась база провайдеров (`providersMoved`); diff
|
|
300
330
|
* неизвестен, пуст или задевает его путь или неявный вход; он — предпосылка
|
|
301
331
|
* (`gatePrerequisites`: `dependsOn` или более ранний check gate) исполняемого
|
|
302
332
|
* gate области. Иначе — запись `not-applicable`.
|
|
@@ -314,6 +344,9 @@ export function gateDecisions(input) {
|
|
|
314
344
|
run: true,
|
|
315
345
|
reason: 'нет зелёного SHA gate под тем же основанием среди предков базы',
|
|
316
346
|
};
|
|
347
|
+
const moved = input.providersMoved?.(gate);
|
|
348
|
+
if (moved)
|
|
349
|
+
return { gate, run: true, reason: moved };
|
|
317
350
|
const path = pathApplicability(input.repo, gate, changed);
|
|
318
351
|
return path.applies
|
|
319
352
|
? { gate, run: true, reason: path.reason }
|
package/package.json
CHANGED