devcontour-harness 0.1.0-alpha.30 → 0.1.0-alpha.34
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 +43 -16
- package/docs/architecture.md +12 -0
- package/docs/compatibility.md +21 -18
- package/docs/contracts.md +270 -12
- package/docs/release-notes/0.1.0-alpha.31.md +44 -0
- package/docs/release-notes/0.1.0-alpha.32.md +33 -0
- package/docs/release-notes/0.1.0-alpha.33.md +29 -0
- package/docs/release-notes/0.1.0-alpha.34.md +32 -0
- package/docs/upgrade.md +181 -0
- package/lib/agents/cli-adapter.js +1 -0
- package/lib/cli.js +25 -3
- package/lib/contracts/cli.d.ts +1381 -18
- package/lib/contracts/cli.js +43 -1
- package/lib/contracts/diagnosis.d.ts +2 -1
- package/lib/contracts/diagnosis.js +1 -0
- package/lib/contracts/events.d.ts +760 -5
- package/lib/contracts/events.js +109 -3
- package/lib/contracts/execution.d.ts +112 -1
- package/lib/contracts/execution.js +38 -0
- package/lib/contracts/failure.d.ts +6 -1
- package/lib/contracts/failure.js +5 -1
- package/lib/contracts/handoff.d.ts +702 -0
- package/lib/contracts/handoff.js +305 -0
- package/lib/contracts/index.d.ts +1 -0
- package/lib/contracts/index.js +1 -0
- package/lib/contracts/policy.d.ts +27 -1
- package/lib/contracts/policy.js +38 -2
- package/lib/contracts/published.d.ts +1016 -3
- package/lib/contracts/published.js +2 -0
- package/lib/contracts/repair-policy.js +5 -0
- package/lib/contracts/report.d.ts +118 -2
- package/lib/contracts/report.js +61 -3
- package/lib/control/base-move.d.ts +7 -2
- package/lib/control/base-move.js +14 -1
- package/lib/control/harness.d.ts +81 -19
- package/lib/control/harness.js +8 -93
- package/lib/control/recovery.d.ts +1 -1
- package/lib/control/status.d.ts +235 -0
- package/lib/control/status.js +101 -0
- package/lib/engine/budget.d.ts +78 -0
- package/lib/engine/budget.js +13 -2
- package/lib/engine/classify.d.ts +14 -1
- package/lib/engine/classify.js +34 -0
- package/lib/engine/engine.d.ts +31 -11
- package/lib/engine/engine.js +99 -5
- package/lib/engine/joint-runner.d.ts +6 -0
- package/lib/engine/joint-runner.js +20 -4
- package/lib/engine/property-recovery.js +1 -0
- package/lib/engine/reuse.js +1 -0
- package/lib/engine/runner.d.ts +8 -0
- package/lib/engine/runner.js +120 -16
- package/lib/engine/stall-sweep.d.ts +137 -0
- package/lib/engine/stall-sweep.js +393 -0
- package/lib/environment/activity.d.ts +34 -0
- package/lib/environment/activity.js +55 -0
- package/lib/environment/isolation.d.ts +67 -3
- package/lib/environment/isolation.js +148 -5
- package/lib/environment/lifecycle.js +2 -1
- package/lib/environment/process.d.ts +7 -1
- package/lib/environment/process.js +14 -0
- package/lib/environment/redaction.d.ts +2 -0
- package/lib/environment/redaction.js +19 -0
- package/lib/explain/state.d.ts +26 -5
- package/lib/explain/state.js +41 -0
- package/lib/handoff/index.d.ts +2 -0
- package/lib/handoff/index.js +3 -0
- package/lib/handoff/markdown.d.ts +6 -0
- package/lib/handoff/markdown.js +155 -0
- package/lib/handoff/pack.d.ts +79 -0
- package/lib/handoff/pack.js +531 -0
- package/lib/index.d.ts +19 -3
- package/lib/index.js +18 -1
- package/lib/integrations/connector/redact.d.ts +2 -13
- package/lib/integrations/connector/redact.js +2 -21
- package/lib/integrations/connector/testing.js +1 -1
- package/lib/projections/attempt.d.ts +28 -0
- package/lib/projections/attempt.js +14 -0
- package/lib/projections/next.d.ts +3 -1
- package/lib/projections/next.js +4 -1
- package/lib/projections/stop.d.ts +22 -1
- package/lib/projections/stop.js +73 -15
- package/lib/report/compute.js +229 -21
- package/lib/report/document.js +31 -7
- package/lib/storage/document.d.ts +28 -6
- package/lib/storage/sqlite.d.ts +2 -0
- package/lib/storage/sqlite.js +9 -1
- package/lib/verification/gates-at.d.ts +11 -1
- package/lib/verification/gates-at.js +28 -2
- package/lib/verification/gates.d.ts +3 -1
- package/lib/verification/gates.js +25 -4
- package/package.json +1 -1
- package/schemas/execution-document.schema.json +68 -0
- package/schemas/execution-policy.schema.json +32 -0
- package/schemas/handoff-pack.schema.json +1430 -0
- package/schemas/run-event.schema.json +679 -0
- package/schemas/stop-diagnosis.schema.json +1 -0
- package/schemas/value-report.schema.json +236 -3
|
@@ -0,0 +1,44 @@
|
|
|
1
|
+
# devcontour-harness 0.1.0-alpha.31
|
|
2
|
+
|
|
3
|
+
Controller сам замечает зависшие попытки и проверки, не дожидаясь вопроса
|
|
4
|
+
человека, а новая сессия ведущего агента начинает с пакета передачи из
|
|
5
|
+
хранилища, а не с пересказа прошлой. Обязательные gates, fencing и привязка
|
|
6
|
+
доказательств к SHA не меняются; `stateVersion` и `policyVersion` прежние.
|
|
7
|
+
|
|
8
|
+
## Изменения
|
|
9
|
+
|
|
10
|
+
- **Обход зависаний.** Controller, ведущий очередь, раз в
|
|
11
|
+
`stallSweep.intervalMs` оценивает исполняющиеся попытки: вывод, начало и
|
|
12
|
+
конец команд, границы стадий и прирост процессорного времени дерева
|
|
13
|
+
процессов. Состояния `active` → `quiet` → `stalled` пишутся в
|
|
14
|
+
`AttemptState.liveness` и событием `attempt.liveness` под fencing; у
|
|
15
|
+
совместной проверки — `joint.liveness`, у `runGatesAt` — `onLiveness` и
|
|
16
|
+
`liveness[]` результата. Цикл ожидания, рождающий процессы без прогресса,
|
|
17
|
+
движением не считается. На `stalled` — снимок процессов (команды под маской
|
|
18
|
+
среды) и хвост вывода в `artifacts/<runId>/stall-<эпизод>.json`.
|
|
19
|
+
- **Политика `stallSweep`.** `{intervalMs, quietMs, stalledMs, action}`;
|
|
20
|
+
без поля — 30 с / 3 мин / 10 мин и `report` (только сообщить). `stop`
|
|
21
|
+
останавливает попытку отказом нового класса `stalled`: повтор или правка
|
|
22
|
+
среды, а не правка кода (`repairPolicy.stalled`). Поле — надзор, в digest
|
|
23
|
+
исполнения не входит: основания попыток и reuse не меняются.
|
|
24
|
+
- **Живость в `status`, `status --detail` и `explain`.** `works[].liveness`
|
|
25
|
+
у активной попытки без движения, `detail.attempts[].liveness`, причина
|
|
26
|
+
`stalled` у работающего поручения с действием человека или controller.
|
|
27
|
+
- **`harness handoff`.** Пакет передачи контекста из одного снимка
|
|
28
|
+
хранилища: активные и незавершённые попытки, открытые поручения со
|
|
29
|
+
следующим шагом, остановки (решения первыми), последние провалы, бюджеты и
|
|
30
|
+
следующий шаг доски; агент добавляет только намерения (`--intent`). JSON
|
|
31
|
+
по умолчанию, `--format md` — Markdown; `--graph` сужает до одного графа.
|
|
32
|
+
Размер ограничен 256 КБ с отбрасыванием записей по порядку важности,
|
|
33
|
+
тексты очищены от управляющих последовательностей и маскируются по
|
|
34
|
+
секретам политики. Библиотека: `handoffPack`, `handoffMarkdown`,
|
|
35
|
+
`handoffPackSchema`, схема `schemas/handoff-pack.schema.json`.
|
|
36
|
+
- **Вложенное чтение хранилища.** `SqliteExecutionStore.read` внутри другого
|
|
37
|
+
`read` использует снимок внешнего, без второго `BEGIN`.
|
|
38
|
+
|
|
39
|
+
## Обновление
|
|
40
|
+
|
|
41
|
+
Пакет alpha.30 остаётся неизменным. Обход включён по умолчанию (`report`),
|
|
42
|
+
поэтому первая же затихшая попытка запишет `liveness` в документ состояния, а
|
|
43
|
+
alpha.30 и ниже такой документ не прочитают. Откатывайтесь вместе с копией
|
|
44
|
+
состояния, снятой до обновления. Подробнее — `docs/upgrade.md`.
|
|
@@ -0,0 +1,33 @@
|
|
|
1
|
+
# devcontour-harness 0.1.0-alpha.32
|
|
2
|
+
|
|
3
|
+
Хост строит пакет передачи контекста над своим движком без экземпляра
|
|
4
|
+
`Harness` и под свой предел ответа, а проверки в песочнице стартуют и при
|
|
5
|
+
глубоком TMPDIR. Форматы состояния, политики, событий и `HandoffPack`
|
|
6
|
+
прежние.
|
|
7
|
+
|
|
8
|
+
## Изменения
|
|
9
|
+
|
|
10
|
+
- **Пакет передачи для хоста.** `handoffPack(source, options)` принимает
|
|
11
|
+
`HandoffSource` (`{ engine, policy, workflows }`); `Harness` ему
|
|
12
|
+
удовлетворяет. `statusOf(source, graphId?, { detail })` — состояние доски
|
|
13
|
+
над движком и политикой. Параметры `maxBytes` (от 4096 байт до 256 КБ) и
|
|
14
|
+
`measure` (`json` | `markdown`) подгоняют пакет тем же порядком
|
|
15
|
+
отбрасывания под меньший предел; `truncated.bySize` значит «записи
|
|
16
|
+
отброшены», размер результата хост проверяет сам.
|
|
17
|
+
- **Экспорты из корня пакета.** `policySecrets` (секреты политики для маски
|
|
18
|
+
хоста), `writeReportFile`, `REPORT_FILE_MODE`, `ReportFileIo` (запись
|
|
19
|
+
отчёта, как у `harness report --out`), `HANDOFF_MIN_BYTES`.
|
|
20
|
+
`devcontour-harness/report` по-прежнему без `node:*`.
|
|
21
|
+
- **Песочница при глубоком TMPDIR.** Когда путь unix-сокета sandbox-runtime
|
|
22
|
+
не помещается в предел ОС (104 байта на macOS, 108 на Linux), srt получает
|
|
23
|
+
короткий каталог `/tmp/dc-srt-<pid>-*` с правами `0700`, который
|
|
24
|
+
удаляется после проверки. Брошенные каталоги этого пользователя, где ничего
|
|
25
|
+
не менялось больше суток и создателя нет, убираются при создании нового.
|
|
26
|
+
Если короткий каталог недоступен — отказ среды с TMPDIR в тексте. Раньше
|
|
27
|
+
проверка падала с `listen EINVAL` и не считалась отказом среды.
|
|
28
|
+
- Строка Markdown об урезании пакета — «Пакет урезан по пределу размера».
|
|
29
|
+
|
|
30
|
+
## Обновление
|
|
31
|
+
|
|
32
|
+
Пакет alpha.31 остаётся неизменным. Состояние и политика не меняются, откат
|
|
33
|
+
копии не требует. Подробнее — `docs/upgrade.md`.
|
|
@@ -0,0 +1,29 @@
|
|
|
1
|
+
# devcontour-harness 0.1.0-alpha.33
|
|
2
|
+
|
|
3
|
+
Пакет передачи и `explain` на долгой истории больше не начинают с ложных
|
|
4
|
+
решений: отменённая работа — решение ведущего, только пока от неё ждёт
|
|
5
|
+
незавершённая работа, а расход ревью плана не повторяется строкой у каждого
|
|
6
|
+
поручения. Форматы состояния, политики и событий прежние; `handoffVersion` — 1.
|
|
7
|
+
|
|
8
|
+
## Изменения
|
|
9
|
+
|
|
10
|
+
- **Отменённые без ждущих.** `CANCELLED` → `replan-dependents` только при
|
|
11
|
+
прямо зависящей незавершённой работе, сообщение называет ждущих. Без них
|
|
12
|
+
отменённая работа в общий `explain` и в `stops`/`next` пакета не входит;
|
|
13
|
+
`explain --work` показывает её с `action: none`.
|
|
14
|
+
- **Упавшая с классом `cancelled`.** Движок её не повторяет, поэтому без
|
|
15
|
+
ждущих это решение человека: `harness retry` или отмена (`user-decision`,
|
|
16
|
+
`nextAction` — шаг `cancelled`), а не «повтор в пределах бюджета».
|
|
17
|
+
- **Группа без восстановления из-за отмены.** Диагноз упавшей работы называет
|
|
18
|
+
отменённую, из-за которой движок не восстанавливает группу.
|
|
19
|
+
- **Бюджеты в пакете передачи.** Вызов о группе (ревью и проверка плана)
|
|
20
|
+
по-прежнему засчитывается бюджету каждого открытого поручения группы, но
|
|
21
|
+
строки поручений, весь расход которых — такие вызовы и которые выдачу не
|
|
22
|
+
держат, в пакет не входят; их число — `truncated.budgetsShared` (по
|
|
23
|
+
умолчанию 0). Блокирующие строки остаются.
|
|
24
|
+
|
|
25
|
+
## Обновление
|
|
26
|
+
|
|
27
|
+
Пакет alpha.32 остаётся неизменным. Состояние не меняется, откат копии не
|
|
28
|
+
требует. Внешний валидатор со строгой прежней схемой пакета передачи
|
|
29
|
+
обновляется вместе с harness. Подробнее — `docs/upgrade.md`.
|
|
@@ -0,0 +1,32 @@
|
|
|
1
|
+
# devcontour-harness 0.1.0-alpha.34
|
|
2
|
+
|
|
3
|
+
Отчёт об эффекте различает, кто действовал: повторы, сбросы, отмены и
|
|
4
|
+
сдвиги базы записываются событиями с исполнителем, а отказы среды — с
|
|
5
|
+
причиной. Неизвестное по-прежнему не показывается нулём. `stateVersion`,
|
|
6
|
+
`policyVersion` и `reportVersion` прежние.
|
|
7
|
+
|
|
8
|
+
## Изменения
|
|
9
|
+
|
|
10
|
+
- **События вмешательств.** `work.retried {by, reset, spent?, reasonLength?}`
|
|
11
|
+
(оператор, восстановление или хост; текст причины не хранится),
|
|
12
|
+
`work.cancelled {by, hadAttempt}`, `base.moved {by}` — в той же транзакции
|
|
13
|
+
и под тем же fencing, что и изменение. `retry`, `cancel` и `fencedRefMove`
|
|
14
|
+
принимают необязательного исполнителя; CLI передаёт `operator`.
|
|
15
|
+
- **Причина отказа.** `attempt.diagnosed {failureKind, cause, counted}` сразу
|
|
16
|
+
после `attempt.failed` или `attempt.expired`: запуск, сеть или файлы
|
|
17
|
+
песочницы, сеть зависимостей, авторизация или лимит провайдера, транспорт,
|
|
18
|
+
предварительная проверка, истёкшая аренда, зависание, остановка.
|
|
19
|
+
- **Отчёт.** Ручные и автоматические действия считаются раздельно с начала
|
|
20
|
+
записи событий; задача, к которой прикасались хост без исполнителя или
|
|
21
|
+
пауза, — «неизвестно». Сдвиги базы — всегда нижняя граница. Пропуск записи
|
|
22
|
+
(новая попытка без события повтора) отчёт находит по порядку журнала и
|
|
23
|
+
показывает окно нижней границей. Причины отказов среды — строками, без
|
|
24
|
+
причины — числом. Попытка с исходом `stalled` теперь засчитывается, как в
|
|
25
|
+
движке.
|
|
26
|
+
|
|
27
|
+
## Обновление
|
|
28
|
+
|
|
29
|
+
Пакет alpha.33 остаётся неизменным. Новые события прежние версии с alpha.30
|
|
30
|
+
читают как `unknown`; ниже — откат вместе с копией состояния. Строгий
|
|
31
|
+
внешний валидатор отчёта обновляется вместе с harness. Подробнее —
|
|
32
|
+
`docs/upgrade.md`.
|
package/docs/upgrade.md
CHANGED
|
@@ -313,6 +313,187 @@ install|fetch` или `yarn install`;
|
|
|
313
313
|
возвращается прежняя классификация; уже записанные попытки сохраняют свой
|
|
314
314
|
класс.
|
|
315
315
|
|
|
316
|
+
### alpha.31: обход зависаний
|
|
317
|
+
|
|
318
|
+
Номера форматов прежние (`stateVersion: 1`, `policyVersion: 1`), новое —
|
|
319
|
+
аддитивно:
|
|
320
|
+
|
|
321
|
+
- **Состояние.** Необязательное поле `AttemptState.liveness` (`state`, `at`,
|
|
322
|
+
`lastMovementAt`, `activity`, `action`, `artifact`) и класс отказа
|
|
323
|
+
`stalled` в `failureKind`. Поле пишется только на переходах живости.
|
|
324
|
+
- **Политика.** Необязательное поле
|
|
325
|
+
`stallSweep{intervalMs, quietMs, stalledMs, action}` и
|
|
326
|
+
`repairPolicy.stalled`. Без поля обход идёт с
|
|
327
|
+
умолчаниями (30 000 / 180 000 / 600 000 мс, `report`); умолчание в
|
|
328
|
+
политику не подставляется, digest политики и digest исполнения прежние,
|
|
329
|
+
поэтому основания попыток и reuse кандидатов после обновления не меняются.
|
|
330
|
+
- **Журнал.** События `attempt.liveness` и `joint.liveness`. Файлы снимков
|
|
331
|
+
`artifacts/<runId>/stall-<эпизод>.json` в каталоге состояния.
|
|
332
|
+
- **Хост.** `runGatesAt` принимает `onLiveness` и возвращает `liveness[]`;
|
|
333
|
+
`status` — `works[].liveness`, `status --detail` —
|
|
334
|
+
`detail.attempts[].liveness`.
|
|
335
|
+
|
|
336
|
+
**Откат.** Документ состояния и политика разбираются строго: alpha.30 и ниже
|
|
337
|
+
отказывают на документе, где у попытки есть `liveness` или отказ `stalled`, и
|
|
338
|
+
на политике с `stallSweep`. Обход включён по умолчанию, поэтому такой документ
|
|
339
|
+
появляется с первой затихшей попыткой. Путь — строка «Новая версия уже
|
|
340
|
+
изменила формат» таблицы [«Откат»](#откат): остановить writers, восстановить
|
|
341
|
+
копию каталога состояния, снятую до обновления, вместе с прежней версией
|
|
342
|
+
пакета и убрать `stallSweep` из политики. События `attempt.liveness` alpha.30
|
|
343
|
+
читает как `unknown`.
|
|
344
|
+
|
|
345
|
+
### alpha.31: пакет передачи контекста
|
|
346
|
+
|
|
347
|
+
Только чтение: формат состояния, политики и событий не меняется. Новое —
|
|
348
|
+
команда
|
|
349
|
+
`harness handoff --state D [--graph ID] [--intent T]… [--format json|md]`,
|
|
350
|
+
функции `handoffPack` и `handoffMarkdown` и схема
|
|
351
|
+
`handoffPackSchema` (`schemas/handoff-pack.schema.json`, `handoffVersion: 1`)
|
|
352
|
+
из корня пакета. `handoffPack` вызывает `read` хранилища вложенно;
|
|
353
|
+
`SqliteExecutionStore` во вложенном чтении использует снимок внешнего, без
|
|
354
|
+
второго `BEGIN`. Хранилище хоста со своим `read` должно допускать вложенный
|
|
355
|
+
вызов.
|
|
356
|
+
|
|
357
|
+
**Откат.** Ниже этой версии команды `handoff` нет; состояние она не меняла,
|
|
358
|
+
поэтому откат пакета копии не требует.
|
|
359
|
+
|
|
360
|
+
### alpha.32: пакет передачи контекста для хоста
|
|
361
|
+
|
|
362
|
+
Только чтение и только аддитивно: формат состояния, политики, событий и
|
|
363
|
+
`HandoffPack` (`handoffVersion: 1`, `schemas/handoff-pack.schema.json`) не
|
|
364
|
+
меняется. Новое в корне пакета:
|
|
365
|
+
|
|
366
|
+
- `handoffPack(source, options)` принимает `HandoffSource`
|
|
367
|
+
(`{ engine, policy, workflows: { list, continues } }`) — `Harness` ему
|
|
368
|
+
удовлетворяет, прежние вызовы не меняются; хосту со своим `Engine` больше
|
|
369
|
+
не нужен экземпляр `Harness`. `statusOf(source, graphId?, { detail })` —
|
|
370
|
+
состояние доски над движком и политикой (`Harness.status` вызывает её же),
|
|
371
|
+
типы `HandoffSource`, `StatusSource`, `StopSource` (`stopInputsOf`
|
|
372
|
+
принимает тот же источник).
|
|
373
|
+
- Параметры `maxBytes` (от `HANDOFF_MIN_BYTES` = 4096 до `HANDOFF_MAX_BYTES`)
|
|
374
|
+
и `measure` (`json` | `markdown`) — тот же порядок отбрасывания под
|
|
375
|
+
меньший предел ответа хоста.
|
|
376
|
+
- `policySecrets(policy, env?)` экспортирован: маску хоста можно составить
|
|
377
|
+
из секретов политики тем же обходом (`composeRedactors`).
|
|
378
|
+
|
|
379
|
+
Строка Markdown об урезании теперь «Пакет урезан по пределу размера» без
|
|
380
|
+
числа: предел задаёт вызывающий.
|
|
381
|
+
|
|
382
|
+
**Откат.** Состояние не меняется, копия не нужна. Хост, вызвавший
|
|
383
|
+
`handoffPack` с узким источником, `maxBytes` или `measure`, либо
|
|
384
|
+
импортировавший `statusOf`, `policySecrets` или `HANDOFF_MIN_BYTES`, при
|
|
385
|
+
откате возвращается к прежнему коду (экземпляр `Harness`, свой обход
|
|
386
|
+
секретов и своя подгонка размера).
|
|
387
|
+
|
|
388
|
+
### alpha.32: запись файла отчёта для хоста
|
|
389
|
+
|
|
390
|
+
Только аддитивно: форматы не меняются. Из корня пакета экспортированы
|
|
391
|
+
`writeReportFile(out, stateDir, text)`, `REPORT_FILE_MODE` и тип
|
|
392
|
+
`ReportFileIo` — та же запись, что у `harness report --out`. В
|
|
393
|
+
`devcontour-harness/report` её нет: модуль остаётся без `node:*`.
|
|
394
|
+
|
|
395
|
+
**Откат.** Состояние не меняется. Хост, импортировавший `writeReportFile`,
|
|
396
|
+
при откате возвращается к своей копии записи.
|
|
397
|
+
|
|
398
|
+
### alpha.32: песочница при глубоком TMPDIR
|
|
399
|
+
|
|
400
|
+
Форматы не меняются. Раньше при глубоком TMPDIR процесса controller путь
|
|
401
|
+
unix-сокета sandbox-runtime превышал предел (104 байта на macOS, 108 на
|
|
402
|
+
Linux), srt падал до запуска команды (`listen EINVAL`), и проверка не
|
|
403
|
+
стартовала. Теперь srt в этом случае получает короткий каталог
|
|
404
|
+
`/tmp/dc-srt-<pid>-*` (`0700`, удаляется после проверки; брошенные упавшим controller каталоги, где ничего не менялось дольше суток и процесса создателя нет, убираются при создании нового). Если и он недоступен —
|
|
405
|
+
отказ среды (`environment`) с TMPDIR в тексте.
|
|
406
|
+
|
|
407
|
+
**Откат.** Состояние не меняется. На прежней версии при глубоком TMPDIR
|
|
408
|
+
проверки в песочнице снова не стартуют: задайте короткий TMPDIR.
|
|
409
|
+
|
|
410
|
+
### alpha.33: отменённые без ждущих и расход ревью плана в пакете передачи
|
|
411
|
+
|
|
412
|
+
Форматы состояния, политики и событий прежние; `handoffVersion` — 1.
|
|
413
|
+
|
|
414
|
+
- Отменённая работа (и упавшая с классом `cancelled`) — решение ведущего
|
|
415
|
+
(`CANCELLED`, `replan-dependents`), только пока от неё прямо зависит
|
|
416
|
+
незавершённая работа (не `done` и не `cancelled`); сообщение называет
|
|
417
|
+
ждущих. Отменённая без таких работ в общий `explain` и в `stops`/`next`
|
|
418
|
+
пакета передачи не входит (как принятая); `explain --work` этой работы
|
|
419
|
+
показывает её с `action: none`. Упавшая отменой без ждущих — решение
|
|
420
|
+
человека (user `user-decision`: `harness retry` или отмена), а не повтор:
|
|
421
|
+
`nextAction` для неё — `user-decision` на шаге `cancelled`. Диагноз упавшей
|
|
422
|
+
работы, чью группу движок не восстанавливает из-за отмены, называет
|
|
423
|
+
отменённую.
|
|
424
|
+
Раньше доска, где все зависимые отменённых тоже отменены или приняты,
|
|
425
|
+
начиналась с решения «перепланировать», которое нечего было делать.
|
|
426
|
+
- Вызов о группе (ревью и проверка плана) по-прежнему засчитывается целиком
|
|
427
|
+
бюджету каждого её открытого поручения — так действует ограничение
|
|
428
|
+
поручения; в строках группы и `total` он учтён один раз, суммы не
|
|
429
|
+
завышены. Пакет передачи больше не перечисляет бюджеты поручений, весь
|
|
430
|
+
расход которых — такие вызовы, кроме тех, что держат выдачу (превышены
|
|
431
|
+
или не определены при `onUnknown: stop`): их число — новое поле
|
|
432
|
+
`truncated.budgetsShared` (в схеме необязательное, по умолчанию 0: пакеты
|
|
433
|
+
прежних версий разбираются). `handoffVersion` остаётся 1, поэтому внешний
|
|
434
|
+
валидатор со строгой прежней схемой пакета
|
|
435
|
+
(`schemas/handoff-pack.schema.json`) обновляется вместе с harness: прежняя
|
|
436
|
+
схема новое поле отклонит. `status` бюджеты поручений показывает как
|
|
437
|
+
прежде.
|
|
438
|
+
|
|
439
|
+
**Откат.** Состояние не меняется; прежняя версия снова показывает такие
|
|
440
|
+
отменённые как решение и повторяет строку бюджета у каждого поручения.
|
|
441
|
+
|
|
442
|
+
### alpha.34: события вмешательств и причин отказа
|
|
443
|
+
|
|
444
|
+
Формат состояния (`stateVersion: 1`), политики и её digest прежние: в документ
|
|
445
|
+
состояния не добавлено ни одного поля. Новое в журнале (`docs/contracts.md`,
|
|
446
|
+
`RunEvent`):
|
|
447
|
+
|
|
448
|
+
- `work.retried {by, reset, spent?, reasonLength?}` — повтор поручения.
|
|
449
|
+
`engine.retry(workId, reset?, by?)` принимает актёра: CLI `retry` —
|
|
450
|
+
`operator`, восстановление очереди — `recovery`, по умолчанию `host`.
|
|
451
|
+
Текста причины сброса в событии нет, только длина.
|
|
452
|
+
- `work.cancelled {by, hadAttempt}` — отмена поручения, в том числе без
|
|
453
|
+
активной попытки и новой редакцией графа (`by: graph`).
|
|
454
|
+
`engine.cancel(workId, reason?, by?)`; CLI `cancel` — `operator`.
|
|
455
|
+
- `base.moved {by}` — сдвиг ref базы `fencedRefMove(store, fence, timeoutMs?,
|
|
456
|
+
by?)`, `by` — `operator`, `controller` или `host` (по умолчанию). Хост,
|
|
457
|
+
сдвигающий базу перемоткой очереди, передаёт `controller`, ручной перенос —
|
|
458
|
+
`operator`. Транзакция `base.moved` теперь пишет событие: адаптер хоста,
|
|
459
|
+
выполнявший её без событий, должен записать его так же, как другие
|
|
460
|
+
нейтральные события без изменения документа.
|
|
461
|
+
- `attempt.diagnosed {failureKind, cause, counted}` — причина отказа попытки
|
|
462
|
+
рядом с `attempt.failed` и `attempt.expired`. Хост, вызывающий
|
|
463
|
+
`engine.fail` сам, может передать `options.cause`; `TaskFailure` принимает
|
|
464
|
+
причину четвёртым аргументом (`diagnosis`).
|
|
465
|
+
|
|
466
|
+
Отчёт (`ValueReport`, `reportVersion: 1`): `autonomy.actions.recorded`
|
|
467
|
+
(актёры вмешательств по событиям или `null`), суммы `retries`/`resets` по
|
|
468
|
+
событиям — только точные (иначе `null`), `baseMoves` — всегда `null` (сдвиг
|
|
469
|
+
вне `fencedRefMove` не пишется, число по актёрам — нижняя граница),
|
|
470
|
+
`withAction`/`withoutAction` с записью — точные или нижняя граница
|
|
471
|
+
(удержанные поручения — неизвестны); `environment.causes` — подпричины или
|
|
472
|
+
`null`; предел `limitations` — 40. Засчитанные попытки (первая попытка,
|
|
473
|
+
попыток на принятое) считаются по правилу движка: зависание (`stalled`)
|
|
474
|
+
теперь засчитано. Без новых событий отчёт прежний, кроме поля `recorded:
|
|
475
|
+
null` и этого правила засчитанных попыток: история с зависаниями даёт
|
|
476
|
+
другие числа первой попытки и попыток на принятое. Читатель, проверявший отчёт
|
|
477
|
+
строгой схемой прежней версии, отклонит новое поле и непустые `causes`:
|
|
478
|
+
обновить схему вместе с пакетом.
|
|
479
|
+
|
|
480
|
+
**Откат.** Версии с терпимым чтением событий (alpha.30 – alpha.33) читают
|
|
481
|
+
новые события как `{type: 'unknown', original}` без нагрузки: очередь,
|
|
482
|
+
`status`, `result`, `events` и `report` работают, а отчёт снова показывает
|
|
483
|
+
вмешательства как «не записано». Ниже alpha.30 `harness events` и чтение
|
|
484
|
+
журнала хостом отказывают на первой странице с новым событием — путь тот же,
|
|
485
|
+
что для `attempt.stage` (alpha.30): восстановить копию каталога состояния,
|
|
486
|
+
снятую до обновления. Удалять или переписывать события ради отката нельзя.
|
|
487
|
+
Хост, передававший `by` в `retry`, `cancel` или `fencedRefMove`, при откате
|
|
488
|
+
убирает аргумент (прежние версии его игнорируют только в JavaScript без
|
|
489
|
+
проверки типов).
|
|
490
|
+
|
|
491
|
+
Откат с последующим повторным обновлением оставляет пробел записи: повторы,
|
|
492
|
+
отмены и сдвиги базы, сделанные прежней версией, событий не имеют. Отчёт
|
|
493
|
+
находит пробел, только если он оставил новую попытку после отказа или отмены
|
|
494
|
+
без записанного повтора (`recorded.gaps`, ограничение `recording-gap`); иной
|
|
495
|
+
пробел не виден, и отчёт всегда называет это ограничением (`rollback-gap`).
|
|
496
|
+
|
|
316
497
|
## Перед обновлением
|
|
317
498
|
|
|
318
499
|
1. **Остановить записывающих.** Запретить новые выдачи (`harness pause`),
|
|
@@ -296,6 +296,7 @@ export function cliAdapter(runtime, options = {}) {
|
|
|
296
296
|
const telemetry = usageStream(runtime);
|
|
297
297
|
try {
|
|
298
298
|
result = await command(argv, r.cwd, {
|
|
299
|
+
activity: { kind: 'agent', label: `${runtime} ${r.task}`.slice(0, 300) },
|
|
299
300
|
contain: { dirs: review ? [] : r.sandbox.writable },
|
|
300
301
|
onRawStdout: (text) => {
|
|
301
302
|
telemetry.push(text);
|
package/lib/cli.js
CHANGED
|
@@ -25,6 +25,7 @@ import { SqliteExecutionStore } from "./storage/sqlite.js";
|
|
|
25
25
|
import { collectReportInput } from "./control/report.js";
|
|
26
26
|
import { writeReportFile } from "./control/report-file.js";
|
|
27
27
|
import { valueReport, reportHtml, reportMarkdown } from "./report/index.js";
|
|
28
|
+
import { handoffMarkdown, handoffPack } from "./handoff/index.js";
|
|
28
29
|
const usage = `harness ${HARNESS_VERSION}
|
|
29
30
|
|
|
30
31
|
Использование: harness <команда> [параметры]
|
|
@@ -221,6 +222,7 @@ const options = {
|
|
|
221
222
|
'as-of': { type: 'string' },
|
|
222
223
|
format: { type: 'string' },
|
|
223
224
|
'no-titles': { type: 'boolean' },
|
|
225
|
+
intent: { type: 'string', multiple: true },
|
|
224
226
|
};
|
|
225
227
|
/** Новые флаги H1 допустимы только у своих команд; прежние команды их не принимают. */
|
|
226
228
|
const flagOwners = {
|
|
@@ -237,8 +239,9 @@ const flagOwners = {
|
|
|
237
239
|
since: ['report'],
|
|
238
240
|
until: ['report'],
|
|
239
241
|
'as-of': ['report'],
|
|
240
|
-
format: ['report'],
|
|
242
|
+
format: ['report', 'handoff'],
|
|
241
243
|
'no-titles': ['report'],
|
|
244
|
+
intent: ['handoff'],
|
|
242
245
|
};
|
|
243
246
|
/** Явное человеческое представление успешного ответа (`--human`). */
|
|
244
247
|
const presenters = {
|
|
@@ -474,8 +477,8 @@ async function run(argv) {
|
|
|
474
477
|
data: await h.deliver(need('work'), sinkOf(need('sink'), h, b.baseDir)),
|
|
475
478
|
};
|
|
476
479
|
const result = command === 'cancel'
|
|
477
|
-
? h.engine.cancel(need('work'), v.reason)
|
|
478
|
-
: h.engine.retry(need('work'), v.reset ? { reason: need('reason') } : undefined);
|
|
480
|
+
? h.engine.cancel(need('work'), v.reason, 'operator')
|
|
481
|
+
: h.engine.retry(need('work'), v.reset ? { reason: need('reason') } : undefined, 'operator');
|
|
479
482
|
return {
|
|
480
483
|
command,
|
|
481
484
|
data: {
|
|
@@ -629,6 +632,25 @@ async function run(argv) {
|
|
|
629
632
|
data: { out: v.out, format, bytes: Buffer.byteLength(text), asOf: report.window.asOf },
|
|
630
633
|
};
|
|
631
634
|
}
|
|
635
|
+
case 'handoff': {
|
|
636
|
+
const format = v.format ?? 'json';
|
|
637
|
+
if (format !== 'json' && format !== 'md')
|
|
638
|
+
throw new HarnessError('INVALID_INPUT', '--format: для handoff ожидается json или md', [
|
|
639
|
+
{ path: ['--format'], message: format },
|
|
640
|
+
]);
|
|
641
|
+
const h = open(need('state'), binding(need('state')), 'state');
|
|
642
|
+
try {
|
|
643
|
+
const data = handoffPack(h, {
|
|
644
|
+
...optional('graphId', v.graph),
|
|
645
|
+
...optional('intentions', v.intent),
|
|
646
|
+
});
|
|
647
|
+
// JSON-конверт по умолчанию; --format md — текст, как у report. Отказ — JSON.
|
|
648
|
+
return { command, data, ...(format === 'md' ? { text: handoffMarkdown(data) } : {}) };
|
|
649
|
+
}
|
|
650
|
+
finally {
|
|
651
|
+
h.close();
|
|
652
|
+
}
|
|
653
|
+
}
|
|
632
654
|
case 'plan-request': {
|
|
633
655
|
const b = loadPolicy(need('policy'));
|
|
634
656
|
const first = b.policy.repositories[0]?.id ?? 'main';
|