devcontour-harness 0.1.0-alpha.31 → 0.1.0-alpha.35
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 +28 -3
- package/docs/architecture.md +12 -0
- package/docs/compatibility.md +21 -18
- package/docs/contracts.md +189 -21
- 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/release-notes/0.1.0-alpha.35.md +27 -0
- package/docs/upgrade.md +172 -0
- package/lib/agents/cli-adapter.d.ts +10 -1
- package/lib/agents/cli-adapter.js +38 -7
- package/lib/agents/usage.d.ts +9 -0
- package/lib/agents/usage.js +22 -1
- package/lib/cli.js +2 -2
- package/lib/contracts/cli.d.ts +344 -6
- package/lib/contracts/cli.js +1 -0
- package/lib/contracts/diagnosis.d.ts +3 -1
- package/lib/contracts/diagnosis.js +1 -0
- package/lib/contracts/errors.d.ts +3 -1
- package/lib/contracts/errors.js +2 -0
- package/lib/contracts/events.d.ts +365 -4
- package/lib/contracts/events.js +63 -2
- package/lib/contracts/execution.d.ts +32 -1
- package/lib/contracts/execution.js +19 -0
- package/lib/contracts/failure.d.ts +12 -3
- package/lib/contracts/failure.js +10 -2
- package/lib/contracts/handoff.d.ts +17 -0
- package/lib/contracts/handoff.js +17 -3
- package/lib/contracts/planning.d.ts +2 -0
- package/lib/contracts/ports.d.ts +10 -2
- package/lib/contracts/published.d.ts +205 -3
- package/lib/contracts/repair-policy.d.ts +10 -1
- package/lib/contracts/repair-policy.js +18 -0
- package/lib/contracts/report.d.ts +118 -2
- package/lib/contracts/report.js +61 -3
- package/lib/contracts/result.d.ts +2 -0
- package/lib/control/base-move.d.ts +7 -2
- package/lib/control/base-move.js +14 -1
- package/lib/control/harness.d.ts +54 -18
- package/lib/control/harness.js +8 -96
- 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 +25 -11
- package/lib/engine/engine.js +78 -5
- package/lib/engine/failure.d.ts +1 -1
- package/lib/engine/failure.js +1 -1
- package/lib/engine/prompt.js +11 -1
- package/lib/engine/property-recovery.js +2 -0
- package/lib/engine/repair.js +4 -2
- package/lib/engine/reuse.js +2 -0
- package/lib/engine/runner.js +13 -5
- package/lib/environment/isolation.d.ts +67 -3
- package/lib/environment/isolation.js +148 -5
- package/lib/environment/lifecycle.js +1 -1
- package/lib/explain/state.d.ts +26 -5
- package/lib/explain/state.js +39 -4
- package/lib/handoff/index.d.ts +1 -1
- package/lib/handoff/markdown.js +4 -2
- package/lib/handoff/pack.d.ts +38 -8
- package/lib/handoff/pack.js +57 -18
- package/lib/index.d.ts +19 -4
- package/lib/index.js +19 -3
- package/lib/integrations/connector/testing.js +1 -1
- package/lib/projections/next.d.ts +3 -1
- package/lib/projections/next.js +4 -1
- package/lib/projections/stop.d.ts +14 -1
- package/lib/projections/stop.js +68 -11
- package/lib/report/compute.js +229 -21
- package/lib/report/document.js +32 -8
- package/lib/storage/document.d.ts +8 -6
- package/lib/verification/gates.js +20 -4
- package/package.json +1 -1
- package/schemas/execution-document.schema.json +11 -0
- package/schemas/handoff-pack.schema.json +15 -0
- package/schemas/result-envelope.schema.json +1 -0
- package/schemas/run-event.schema.json +322 -0
- package/schemas/run-result.schema.json +1 -0
- package/schemas/stop-diagnosis.schema.json +2 -0
- package/schemas/value-report.schema.json +236 -3
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.35` — предварительный выпуск (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.35 # точная версия
|
|
32
32
|
# или: npm install --save-exact devcontour-harness@alpha # текущая alpha
|
|
33
33
|
npx harness --version
|
|
34
34
|
```
|
|
@@ -129,7 +129,8 @@ codes: 0 успех, 2 неверный вход, 3 отказ/блокиров
|
|
|
129
129
|
каталог в отчёт не попадают; `--no-titles` убирает и заголовки. Тот же
|
|
130
130
|
каталог — те же байты: момент отчёта — последняя метка времени в данных.
|
|
131
131
|
Хост строит тот же отчёт из своего хранилища: `valueReport` из
|
|
132
|
-
`devcontour-harness/report
|
|
132
|
+
`devcontour-harness/report`, файл отчёта — `writeReportFile` из корня пакета.
|
|
133
|
+
Подробно — [ValueReport](docs/contracts.md#valuereport).
|
|
133
134
|
|
|
134
135
|
## Библиотека
|
|
135
136
|
|
|
@@ -147,6 +148,30 @@ PASS» нет. Адаптеры хоста реализуют порты `Execut
|
|
|
147
148
|
`devcontour-harness/schemas/<имя>.schema.json`. Декларации используют типы
|
|
148
149
|
Node.js: TypeScript-потребителю нужен `@types/node` (или `skipLibCheck`).
|
|
149
150
|
|
|
151
|
+
## Выпуск 0.1.0-alpha.35
|
|
152
|
+
|
|
153
|
+
Нехватка окна контекста claude — отдельный класс отказа `context-exhausted`
|
|
154
|
+
с кодом `CONTEXT_EXHAUSTED` и короткой политикой повторов. Подробно —
|
|
155
|
+
[заметки выпуска](docs/release-notes/0.1.0-alpha.35.md).
|
|
156
|
+
|
|
157
|
+
## Выпуск 0.1.0-alpha.34
|
|
158
|
+
|
|
159
|
+
События повторов, отмен, сдвигов базы и причин отказа среды; отчёт об
|
|
160
|
+
эффекте различает ручные и автоматические действия. Подробно —
|
|
161
|
+
[заметки выпуска](docs/release-notes/0.1.0-alpha.34.md).
|
|
162
|
+
|
|
163
|
+
## Выпуск 0.1.0-alpha.33
|
|
164
|
+
|
|
165
|
+
Пакет передачи и `explain` без ложных решений по отменённым работам и без
|
|
166
|
+
повтора расхода ревью плана у каждого поручения. Подробно —
|
|
167
|
+
[заметки выпуска](docs/release-notes/0.1.0-alpha.33.md).
|
|
168
|
+
|
|
169
|
+
## Выпуск 0.1.0-alpha.32
|
|
170
|
+
|
|
171
|
+
Пакет передачи контекста для хоста без экземпляра `Harness` и под его предел
|
|
172
|
+
ответа, экспорт `policySecrets` и `writeReportFile`, песочница при глубоком
|
|
173
|
+
TMPDIR. Подробно — [заметки выпуска](docs/release-notes/0.1.0-alpha.32.md).
|
|
174
|
+
|
|
150
175
|
## Выпуск 0.1.0-alpha.31
|
|
151
176
|
|
|
152
177
|
Controller сам замечает зависшие попытки и проверки (`stallSweep`, отказ
|
package/docs/architecture.md
CHANGED
|
@@ -648,6 +648,18 @@ executable. Live smoke — отдельный opt-in с явно заданны
|
|
|
648
648
|
вложенные `.git` на любой глубине тоже закрыты (на Linux — только
|
|
649
649
|
существующий файл `.git`). Дерево больше предела перечисления — отказ
|
|
650
650
|
проверки классом `environment`, а не молча урезанные запреты.
|
|
651
|
+
Свои unix-сокеты srt создаёт во временном каталоге своего процесса, а путь
|
|
652
|
+
сокета ограничен (`sun_path`: 104 байта на macOS, 108 на Linux). Если путь
|
|
653
|
+
в TMPDIR процесса не укладывается, srt получает свой каталог под `/tmp`
|
|
654
|
+
(`dc-srt-<pid>-*`, `mkdtemp`, `0700`), который удаляется после проверки;
|
|
655
|
+
каталоги, брошенные упавшим controller (свои, ни каталог, ни записи прямо
|
|
656
|
+
в нём не менялись дольше суток, процесс создателя завершён), убираются при
|
|
657
|
+
создании нового — через переименование в `.dc-srt-rm-*` и повторную
|
|
658
|
+
проверку. Свежая запись внутри держит каталог: srt переживает controller,
|
|
659
|
+
убитый SIGKILL, а контейнер с общим `/tmp` не видит создателя из другого
|
|
660
|
+
пространства pid. Команде внутри
|
|
661
|
+
по-прежнему передаётся её scratch. Не создаётся и этот каталог — отказ
|
|
662
|
+
проверки классом `environment` с TMPDIR в тексте до запуска команды.
|
|
651
663
|
- **Сверка защищённых путей.** Запреты песочницы проверяют только путь
|
|
652
664
|
операции: каталог, собранный в `node_modules` и перенесённый в дерево
|
|
653
665
|
проекта, ими не закрыт. До и после каждого gate и вокруг работы исполнителя
|
package/docs/compatibility.md
CHANGED
|
@@ -42,9 +42,11 @@ coordinator. `Store.change(type, fn)` открывает `BEGIN IMMEDIATE` (вл
|
|
|
42
42
|
`Store.change` события не записал, а у транзакции есть нейтральные
|
|
43
43
|
события. Изменения остальных методов `Store` не требуется.
|
|
44
44
|
Транзакции только локальных записей (`workflow.updated`, `usage.recorded`,
|
|
45
|
-
`checks.recorded`)
|
|
46
|
-
|
|
47
|
-
`
|
|
45
|
+
`checks.recorded`) событий не создают: адаптер выполняет их как
|
|
46
|
+
`Store.atomic` без `Store.change`, как DevContour сейчас пишет учёт вызовов
|
|
47
|
+
и очередь ведущего. `base.moved` (проверка владения и сдвиг ref) записей не
|
|
48
|
+
меняет, но пишет событие `base.moved`: адаптер добавляет его
|
|
49
|
+
`Store.appendEvent`, как любое нейтральное событие без изменения документа.
|
|
48
50
|
5. **Курсор.** `seq` нейтрального события = `id события журнала × 1024 + индекс` (не больше 1024 событий на транзакцию — с запасом для графа из 500 поручений; больше — отказ транзакции).
|
|
49
51
|
`ExecutionStore.events(after)` строит `RunEvent` из `harnessEvents` строго
|
|
50
52
|
по возрастанию `seq`; события прежних версий без `harnessEvents` в
|
|
@@ -148,21 +150,22 @@ Standalone-хост использует `digestOf` (SHA-256 каноничес
|
|
|
148
150
|
|
|
149
151
|
## Сохраняемые форматы
|
|
150
152
|
|
|
151
|
-
| Что | Правило
|
|
152
|
-
| --------------------------------------- |
|
|
153
|
-
| Состояние `version: 1` | Читается как есть; иная версия отклоняется до записи
|
|
154
|
-
| Типы событий журнала | Прежние строки, см. `transactionKinds`
|
|
155
|
-
| События стадий | Тип `attempt.stage` (не выпущено): границы стадий попытки: `started` и не больше одного `finished` на замер `AttemptState.timings` (стадия утратившей владение попытки остаётся открытой); документ состояния и digest политики прежние. Тип, которого читатель не знает, читается как `{type: 'unknown', original}` без нагрузки. Версии до этой событие разбирают строго: после отката ниже неё `events` отказывает на странице с ним (upgrade.md)
|
|
156
|
-
|
|
|
157
|
-
|
|
|
158
|
-
|
|
|
159
|
-
|
|
|
160
|
-
|
|
|
161
|
-
|
|
|
162
|
-
|
|
|
163
|
-
|
|
|
164
|
-
|
|
|
165
|
-
|
|
|
153
|
+
| Что | Правило |
|
|
154
|
+
| --------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
|
|
155
|
+
| Состояние `version: 1` | Читается как есть; иная версия отклоняется до записи |
|
|
156
|
+
| Типы событий журнала | Прежние строки, см. `transactionKinds` |
|
|
157
|
+
| События стадий | Тип `attempt.stage` (не выпущено): границы стадий попытки: `started` и не больше одного `finished` на замер `AttemptState.timings` (стадия утратившей владение попытки остаётся открытой); документ состояния и digest политики прежние. Тип, которого читатель не знает, читается как `{type: 'unknown', original}` без нагрузки. Версии до этой событие разбирают строго: после отката ниже неё `events` отказывает на странице с ним (upgrade.md) |
|
|
158
|
+
| События вмешательств и причин отказа | Типы `work.retried`, `work.cancelled`, `base.moved`, `attempt.diagnosed` (не выпущено): актёр повтора, отмены и сдвига базы, причина отказа окружения; пишутся в транзакции изменения. Документ состояния и digest политики прежние. Версии с терпимым чтением (alpha.30 и новее) читают их как `{type: 'unknown', original}`; ниже — `events` отказывает на странице с ними (upgrade.md). Перечни `cause` и `by` строгие: новое значение в будущей версии — изменение договора, и эта версия отклонит такое событие при чтении (известный тип с нарушенной нагрузкой), поэтому новое значение добавляется только вместе с новым типом события или с изменением правила чтения |
|
|
159
|
+
| Ветки | Целевая `devcontour/accepted` (в политике `refs/heads/devcontour/accepted`), ветки попыток `devcontour/run-<runId>` |
|
|
160
|
+
| Каталоги попыток | `worktrees/<runId>`, `worktrees/<runId>-integration`, `artifacts/<runId>/…`, `dependencies/<runId>/manifest.json`; при каталоге состояния внутри репозитория деревья и снимки — под корнем вне дерева `<checkoutRoot>/<repositoryId>/…` (alpha.23) |
|
|
161
|
+
| Receipt среды | `environment.json` `version: 1` |
|
|
162
|
+
| Отчёт свойств, договор проверки, корпус | `version: 1` |
|
|
163
|
+
| Хранилище зависимостей | Необязательное `repositories[].dependencyStore`: без поля политика, её digest и каталоги прежние. Каталог `dependency-store` закрыт профилю codex для всех установок, как и другие служебные каталоги; seed другого формата не используется ни как попадание, ни как основа сборки: он пересобирается и вытесняется |
|
|
164
|
+
| Artifacts gates | Необязательное `repositories[].gates[].artifacts`: без поля политика и её digest прежние. Поле `artifactFiles` в evidence gate и в записи совместной проверки необязательно: прежние записи читаются как есть |
|
|
165
|
+
| Владение репозиторием | `<git-common-dir>/devcontour-owner.json` |
|
|
166
|
+
| Ресурсы | Отдельная база блокировок ресурсов `resources.sqlite`: блокировки устройств и портов, а не состояние исполнения. Таблица `seed_pins` создаётся только при первом обращении хранилища зависимостей |
|
|
167
|
+
| Снимок коннектора | Поля `proof` и `baseline` manifest необязательны: прежние записи читаются как есть. Без `baseline` в конфигурации ревизия, graph digest и context digest те же, что в прежних версиях |
|
|
168
|
+
| Probe ревьюера | MCP-сервер `devcontour_probe`, инструмент `run_check`; протокол — построчный JSON-RPC (stdio), журнал `probes.jsonl` |
|
|
166
169
|
|
|
167
170
|
## Переменные окружения gates
|
|
168
171
|
|
package/docs/contracts.md
CHANGED
|
@@ -660,6 +660,50 @@ fencing; само состояние между переходами не пер
|
|
|
660
660
|
причину `stalled` у работающего поручения: при `report` действует человек
|
|
661
661
|
(`fix-environment`), при `stop` — controller.
|
|
662
662
|
|
|
663
|
+
### Нехватка окна контекста
|
|
664
|
+
|
|
665
|
+
Отказ класса `context-exhausted` — исполнителю или reviewer не хватило окна
|
|
666
|
+
контекста модели внутри попытки. Класс ставится по признаку, который сообщил
|
|
667
|
+
сам runtime, а не по тексту причины: адаптер claude читает `terminal_reason`
|
|
668
|
+
итогового события `result` потока `stream-json` и выставляет
|
|
669
|
+
`RuntimeResponse.diagnostics.contextExhausted` — предел окна
|
|
670
|
+
(`ContextLimit`). Записанные на живом CLI признаки:
|
|
671
|
+
|
|
672
|
+
- `prompt_too_long` на первом ходе (`num_turns` ≤ 1) → `prompt-too-long` —
|
|
673
|
+
запрос отклонён: уже подсказка с контекстом больше окна, сжимать нечего.
|
|
674
|
+
Тот же признак после ходов работы или без `num_turns` (не записан, вывод
|
|
675
|
+
инструментов заполнил окно) → `blocking-limit`;
|
|
676
|
+
- `blocking_limit` → `blocking-limit` — CLI сам остановил ход у предела окна.
|
|
677
|
+
Записан с выключенным автоматическим сжатием через `DISABLE_AUTO_COMPACT=1`.
|
|
678
|
+
`autoCompactEnabled: false` в `--settings` сжатие тоже выключает (проверено),
|
|
679
|
+
но исход у предела окна с ним не записан; путь «сжатие включено, но не
|
|
680
|
+
помогло» не проверен.
|
|
681
|
+
|
|
682
|
+
В обоих случаях CLI выходил с кодом 1, `is_error: true`, текст `result`
|
|
683
|
+
начинался с `Prompt is too long`; признак учитывается и при коде 0. Текст
|
|
684
|
+
отказа попытки постоянный (`claude: не хватило окна контекста модели`), предел
|
|
685
|
+
— данными (`AttemptState.contextLimit`), текст runtime — в журнале вызова:
|
|
686
|
+
отпечаток один при любом пределе и любых числах токенов, а «401» или «429» в
|
|
687
|
+
числах токенов текстовый разбор принял бы за отказ провайдера. Успешное
|
|
688
|
+
автоматическое сжатие (`system`/`compact_boundary`) — не отказ: вызов
|
|
689
|
+
продолжается и завершается своим исходом; число сжатий и `terminal_reason`
|
|
690
|
+
пишутся в `runtime.json` вызова (`compactions`, `terminalReason`). У codex
|
|
691
|
+
признак пока не распознаётся: его отказ классифицируется как прежде.
|
|
692
|
+
|
|
693
|
+
Попытка засчитывается в `maxAttempts`: отказ говорит о размере задачи, а не
|
|
694
|
+
об окружении, и выдачу не останавливает. Повторы (`repairRepeats`): у
|
|
695
|
+
`blocking-limit` — один (`repairPolicy['context-exhausted'].repeats`), и
|
|
696
|
+
следующая попытка writer получает в подсказке указание держать контекст малым
|
|
697
|
+
(читать только нужные файлы и строки, не выводить большие файлы и длинный
|
|
698
|
+
вывод команд); у `prompt-too-long` — ни одного: повтор только удлинил бы
|
|
699
|
+
подсказку. Предел берётся у последней попытки с отказом
|
|
700
|
+
(`lastContextLimit`); отпечаток у обоих пределов один. Дальше задачу нужно разделить или сократить её контекст:
|
|
701
|
+
код остановки `CONTEXT_EXHAUSTED` (класс `refused`), `explain` — ведущий,
|
|
702
|
+
`diagnose-failure`. Корзина отчёта — `incomplete`; разбор свойства
|
|
703
|
+
(`property-recovery`) такой отказ не считает, кандидат после отказа reviewer
|
|
704
|
+
переиспользуется (`reusableFailures`). Причина `attempt.diagnosed` — `none`,
|
|
705
|
+
`counted: true`.
|
|
706
|
+
|
|
663
707
|
### RunEvent
|
|
664
708
|
|
|
665
709
|
`{apiVersion, seq, at, type, graphId?, workId?, runId?, attempt?, payload}`.
|
|
@@ -687,6 +731,46 @@ fencing; само состояние между переходами не пер
|
|
|
687
731
|
'stop'|'report', snapshot?}`; `joint.liveness` — то же с `verificationId`; `action` и `snapshot` — только у `stalled` (см. «Зависшие
|
|
688
732
|
попытки»).
|
|
689
733
|
|
|
734
|
+
`work.retried` — поручение возвращено в очередь `engine.retry`: `{by:
|
|
735
|
+
'operator'|'recovery'|'host', reset, spent?, reasonLength?}`. `by` — третий
|
|
736
|
+
аргумент `retry(workId, reset?, by?)`: CLI `retry` передаёт `operator`,
|
|
737
|
+
восстановление очереди (`repair`, эпизод по свойству) — `recovery`, хост без
|
|
738
|
+
актёра — `host` (по умолчанию). `reset` — сброс исчерпанного предела; `spent` —
|
|
739
|
+
засчитанные попытки до сброса (сброс обнуляет `WorkState.attempt`),
|
|
740
|
+
`reasonLength` — длина причины сброса; текста причины в событии нет. Повтор
|
|
741
|
+
без изменения (поручение уже в очереди) и отказ повтора событий не создают.
|
|
742
|
+
|
|
743
|
+
`work.cancelled` — поручение отменено: `{by: 'operator'|'host'|'graph',
|
|
744
|
+
hadAttempt}`. `engine.cancel(workId, reason?, by?)` (CLI `cancel` — `operator`,
|
|
745
|
+
по умолчанию `host`); `graph` — новая редакция графа убрала поручение.
|
|
746
|
+
`hadAttempt` — отменена и активная попытка: её `attempt.cancelled` идёт в той
|
|
747
|
+
же транзакции перед `work.cancelled`, у которого тогда те же `runId` и
|
|
748
|
+
`attempt`. Повторная отмена отменённого событий не создаёт.
|
|
749
|
+
|
|
750
|
+
`base.moved` — сдвиг ref базы `fencedRefMove(store, fence, timeoutMs?, by?)`:
|
|
751
|
+
`{by: 'operator'|'controller'|'host'}` (по умолчанию `host`), одно событие на
|
|
752
|
+
репозиторий, в той же транзакции, что проверка владения и `git update-ref`.
|
|
753
|
+
Отказ проверки или Git (CAS) отменяет и событие. `moveBase` без `move` событий
|
|
754
|
+
не пишет: у него нет хранилища.
|
|
755
|
+
|
|
756
|
+
`attempt.diagnosed` — причина отказа попытки: `{failureKind, cause, counted}`,
|
|
757
|
+
конверт несёт `graphId`, `workId`, `runId`, `attempt`. Пишется сразу за
|
|
758
|
+
`attempt.failed` (и `attempt.expired`) в той же транзакции под fencing.
|
|
759
|
+
`cause` (`environmentCauses`): `sandbox-launch`, `sandbox-network`,
|
|
760
|
+
`sandbox-filesystem`, `sandbox-policy`, `dependency-network` — ставит gate в
|
|
761
|
+
точке обнаружения (`TaskFailure.diagnosis`); `transport`, `preflight`
|
|
762
|
+
(`BlockedError` до работы), `provider-auth`, `provider-limit`, `stalled`,
|
|
763
|
+
`shutdown` (прерывание штатной остановкой), `lease-expired` — по классу отказа
|
|
764
|
+
и его признакам; `other` — отказ окружения без известной причины; `none` —
|
|
765
|
+
отказ не окружения. Хост, вызывающий `engine.fail`, может передать
|
|
766
|
+
`options.cause`; движок приводит её к классу (у отказа не окружения — всегда
|
|
767
|
+
`none`). `counted` — отказ засчитан в предел попыток (`maxAttempts`): не
|
|
768
|
+
засчитаны отказы до работы (`blocked`), окружения и провайдера, истёкшее
|
|
769
|
+
владение и прерывание остановкой; зависание (`stalled`) засчитано. Отчёт
|
|
770
|
+
считает попытки засчитанными по тому же правилу. Отказ до работы с классом
|
|
771
|
+
не окружения получает причину `preflight`. Текста отказа в событии
|
|
772
|
+
нет.
|
|
773
|
+
|
|
690
774
|
`finished` может не прийти: поздний finish владельца, утратившего срок,
|
|
691
775
|
отклоняется (runner его не повторяет), упавший процесс его не пишет, а `adopt`
|
|
692
776
|
и recovery открытые замеры прежнего владельца не закрывают. Такая стадия
|
|
@@ -726,7 +810,7 @@ original}` (исходный тип, не длиннее 200 символов;
|
|
|
726
810
|
(`joint.started`, `joint.finished`). `config.started`, `config.reconfigure-*`
|
|
727
811
|
и `config.reconfigured` меняют применённую политику и запрос операции
|
|
728
812
|
(`policy.applied`, `policy.reconfigure`). `base.moved` — проверка владения
|
|
729
|
-
операцией и CAS-сдвиг ref базы; записей
|
|
813
|
+
операцией и CAS-сдвиг ref базы; записей не создаёт, событие — `base.moved`.
|
|
730
814
|
|
|
731
815
|
### ValueReport
|
|
732
816
|
|
|
@@ -749,7 +833,14 @@ original}` (исходный тип, не длиннее 200 символов;
|
|
|
749
833
|
внешних ссылок (CSP `default-src 'none'; style-src 'unsafe-inline'; img-src
|
|
750
834
|
data:`), светлая и тёмная схема по `prefers-color-scheme`, таблицы
|
|
751
835
|
прокручиваются на ширине телефона, столбики недель (inline SVG) — от 3
|
|
752
|
-
активных недель. Модуль `devcontour-harness/report` без `node:*` и без zod.
|
|
836
|
+
активных недель. Модуль `devcontour-harness/report` без `node:*` и без zod. Запись
|
|
837
|
+
файла отчёта (`report --out`) — `writeReportFile(out, stateDir, text)` из
|
|
838
|
+
корня пакета (не из `./report`: она использует `node:fs`): текст пишется во
|
|
839
|
+
временный файл каталога цели и переименовывается поверх цели, без записи
|
|
840
|
+
сквозь symlink и жёсткие ссылки; цель внутри каталога состояния, symlink,
|
|
841
|
+
не обычный файл или файл с `nlink > 1` — `PATH_CONFLICT`, недоступный
|
|
842
|
+
каталог — `INVALID_INPUT`; права прежнего файла сохраняются, новый —
|
|
843
|
+
`REPORT_FILE_MODE` (`0600`).
|
|
753
844
|
|
|
754
845
|
**Детерминизм.** Тот же вход и параметры — те же байты JSON, Markdown и HTML
|
|
755
846
|
при любом порядке входных массивов, часах и часовом поясе. `asOf` по
|
|
@@ -769,7 +860,7 @@ data:`), светлая и тёмная схема по `prefers-color-scheme`,
|
|
|
769
860
|
`WorkState.attempt` (сброс возвращает счётчик к 0).
|
|
770
861
|
- Корзины отказа попытки (`failureBucketOf`): `defect` (`gate`, `review`,
|
|
771
862
|
`scope-violation`), `incomplete` (`empty-result`, `unfinished`,
|
|
772
|
-
`needs-lead`), `integration` (`stale-base`, `merge`), `environment`
|
|
863
|
+
`needs-lead`, `context-exhausted`), `integration` (`stale-base`, `merge`), `environment`
|
|
773
864
|
(`environment`, `provider-auth`, `blocked`, истёкшее владение), `time-limit`
|
|
774
865
|
(`timeout`), `tool` (`review-protocol`), `operator` (`cancelled`), `budget`,
|
|
775
866
|
`unknown`, `unclassified` (попытка без класса — записана до
|
|
@@ -803,15 +894,48 @@ lower`). `firstPassRaw` — попытка вообще одна.
|
|
|
803
894
|
иначе `lower` («≥»); без единой известной цены при неизвестных —
|
|
804
895
|
`unknown` (`value: null`), не `$0`. Расход отклонённых попыток
|
|
805
896
|
(`cost.rejected`) и расход отказов окружения (`environment.neutral`) —
|
|
806
|
-
одна и та же атрибуция по всем завершённым попыткам окна.
|
|
897
|
+
одна и та же атрибуция по всем завершённым попыткам окна. `environment.neutral`
|
|
898
|
+
— вся корзина `environment`, включая зависания (`stalled`), хотя они
|
|
899
|
+
засчитаны в предел попыток.
|
|
900
|
+
- Пробел записи определяется по порядку журнала (`seq`), а не по времени:
|
|
901
|
+
`at` события — часы записи, время попытки — часы движка.
|
|
807
902
|
- Действия человека — только записи с актёром-человеком: решения recovery
|
|
808
|
-
с источником `operator
|
|
809
|
-
не называют (удерживают и
|
|
810
|
-
показаны отдельно (`holds
|
|
811
|
-
|
|
812
|
-
|
|
813
|
-
|
|
814
|
-
|
|
903
|
+
с источником `operator`, повторы и отмены с `by: operator` (`work.retried`,
|
|
904
|
+
`work.cancelled`). Удержания (`work.held`) актёра не называют (удерживают и
|
|
905
|
+
операции хоста, например смена контракта): они показаны отдельно (`holds`)
|
|
906
|
+
и в действия человека не входят; так же `cancelledAttempts` — отменённые
|
|
907
|
+
попытки по записям попыток. Повторы восстановлением (`recovery`), сдвиги
|
|
908
|
+
базы controller и отмены новой редакцией графа — автоматические.
|
|
909
|
+
- Вмешательства по событиям (`actions.recorded`): числа в окне по актёрам —
|
|
910
|
+
повторы, сбросы, отмены (и отмены без активной попытки), сдвиги базы.
|
|
911
|
+
Запись начинается с первого события версии, которая их пишет
|
|
912
|
+
(`work.retried`, `work.cancelled`, `base.moved`, `attempt.diagnosed`;
|
|
913
|
+
`recorded.from`); раньше него действие могло быть, но не записано. Нет ни
|
|
914
|
+
одного такого события в журнале — `recorded: null`, `withAction` — нижняя
|
|
915
|
+
граница, «без действий человека» (`withoutAction`) не измеримо (`value:
|
|
916
|
+
null`, `bound: unknown`). С записью: `recorded.bound: lower`, если в окне
|
|
917
|
+
есть попытки, события или принятые поручения раньше `from` или пробел записи
|
|
918
|
+
(`gaps`: новая попытка после отказа или отмены без `work.retried` и без новой
|
|
919
|
+
редакции графа между ними — работала версия без этих событий, например
|
|
920
|
+
после отката и повторного обновления), иначе `exact`. Пробел, не оставивший
|
|
921
|
+
такой попытки, не обнаруживается — это постоянное ограничение. Суммы
|
|
922
|
+
`retries`/`resets` — только при `bound: exact`, иначе `null` (числа по
|
|
923
|
+
актёрам с границей — в `recorded`). Сдвиги базы — всегда нижняя граница
|
|
924
|
+
(`baseMovesBound: lower`, сумма `baseMoves` всегда `null`): перенос вне
|
|
925
|
+
`fencedRefMove` (`moveBase` без `move`) не пишется; к поручениям они не
|
|
926
|
+
относятся.
|
|
927
|
+
- Поручение «без действий человека» известно, если оно начато не раньше
|
|
928
|
+
`from` (начало — согласование первой попытки `wait.approvedAt`, иначе
|
|
929
|
+
`WorkState.approvedAt`, иначе начало первой попытки), без пробела записи,
|
|
930
|
+
и у него нет действий без актёра: повтора или отмены хостом (`host`) и
|
|
931
|
+
удержания (`work.held` — его ставят и человек, и операции хоста). Прочие
|
|
932
|
+
принятые без действия оператора идут в `unknown` обеих мер (`bound:
|
|
933
|
+
lower`).
|
|
934
|
+
- Подпричины окружения (`environment.causes`): отказы окружения окна по
|
|
935
|
+
`attempt.diagnosed` своей попытки — строки `{cause, count, counted}` (по
|
|
936
|
+
убыванию числа); отказ без события (записан раньше) — `undiagnosed`, тогда
|
|
937
|
+
`bound: lower`. Нет ни одного `attempt.diagnosed` в журнале — `causes:
|
|
938
|
+
null`.
|
|
815
939
|
- Отказы окружения (`environment.share`) — среди классифицированных; если
|
|
816
940
|
есть отказы только в gates подготовки (`setupCheckFailures`), доля —
|
|
817
941
|
нижняя граница («at least», «M more may be environment»).
|
|
@@ -844,7 +968,7 @@ HTML ≤ 1 МБ. Усечение отмечено флагом и ограни
|
|
|
844
968
|
|
|
845
969
|
### HandoffPack
|
|
846
970
|
|
|
847
|
-
Пакет передачи контекста (`harness handoff`, `handoffPack(
|
|
971
|
+
Пакет передачи контекста (`harness handoff`, `handoffPack(source, options)`
|
|
848
972
|
и `handoffMarkdown(pack)` из корня пакета; `handoffVersion: 1`,
|
|
849
973
|
`handoffPackSchema`, `schemas/handoff-pack.schema.json`). Ведущий агент хоста,
|
|
850
974
|
который ведёт доску через много попыток, начинает новую сессию с пакета, а не
|
|
@@ -866,6 +990,16 @@ HTML ≤ 1 МБ. Усечение отмечено флагом и ограни
|
|
|
866
990
|
`next` — кто и что делает (по диагнозу `explain`; стадия и свойство — по
|
|
867
991
|
`nextAction`);
|
|
868
992
|
- `stops` — диагнозы `explain` без проб runtime, кроме `action: none`.
|
|
993
|
+
Отменённая работа (и упавшая с классом `cancelled`) — остановка
|
|
994
|
+
(`CANCELLED`, lead `replan-dependents`), только пока от неё прямо зависит
|
|
995
|
+
незавершённая работа (не `done` и не `cancelled`); ждущую через
|
|
996
|
+
отменённую же промежуточную ведёт диагноз той. Без таких работ у
|
|
997
|
+
отменённой действия нет (`action: none`): в общий `explain` и пакет она не
|
|
998
|
+
входит, explain этой работы (`--work`) её показывает. Упавшая отменой
|
|
999
|
+
открыта, а движок её не повторяет: без ждущих — решение человека (user
|
|
1000
|
+
`user-decision`: `harness retry` или отмена), шаг `nextAction` —
|
|
1001
|
+
`cancelled`. Любая отмена в группе останавливает её автоматическое
|
|
1002
|
+
восстановление: диагноз упавшей сестры называет отменённую работу.
|
|
869
1003
|
Остановка выдачи общей паузой очереди — одна запись с `queue: true` без
|
|
870
1004
|
`workId`; одинаковые остановки на выдаче у разных поручений тоже
|
|
871
1005
|
свёрнуты; `works` — первые 20 затронутых, `worksCount` — сколько всего.
|
|
@@ -874,7 +1008,14 @@ HTML ≤ 1 МБ. Усечение отмечено флагом и ограни
|
|
|
874
1008
|
`failureKind`, код (`stopCodeOf`), текст ошибки и текущий статус
|
|
875
1009
|
поручения (`workStatus`);
|
|
876
1010
|
- `budgets` — общий бюджет и бюджеты групп (с `--graph` — только его
|
|
877
|
-
группа), бюджеты поручений — только с расходом или не в
|
|
1011
|
+
группа), бюджеты поручений — только с расходом или не в пределах и со
|
|
1012
|
+
своими вызовами (попытки, вызовы о поручении). Вызов о группе (ревью и
|
|
1013
|
+
проверка плана) засчитывается целиком бюджету каждого её открытого
|
|
1014
|
+
поручения (так действует ограничение поручения), но в строках группы и
|
|
1015
|
+
`total` — один раз; поручение, весь расход которого — такие вызовы, не
|
|
1016
|
+
перечисляется (`truncated.budgetsShared`), если только его строка не
|
|
1017
|
+
держит выдачу (превышена или не определена при `onUnknown: stop`): тогда
|
|
1018
|
+
она показана как ограничение поручения. Строка бюджета:
|
|
878
1019
|
сообщено (`reportedUsd`) и оценено (`estimatedUsd`) против предела, время,
|
|
879
1020
|
`complete` и причины неполноты (вызовы без стоимости, незавершённые,
|
|
880
1021
|
брошенные, попытки без учёта); при неполном расходе сумма — нижняя граница
|
|
@@ -900,13 +1041,38 @@ escape-последовательностей терминала (ANSI CSI, OSC)
|
|
|
900
1041
|
остановки, строки бюджетов» (`truncated.bySize`), отказа по размеру нет.
|
|
901
1042
|
Сколько записей каждого списка не вошло — `truncated`; бюджеты поручений в
|
|
902
1043
|
пределах и без расхода не показываются намеренно и считаются отдельно
|
|
903
|
-
(`budgetsWithin`),
|
|
1044
|
+
(`budgetsWithin`), как и бюджеты поручений только с расходом вызовов о
|
|
1045
|
+
группе (`budgetsShared`), усечённые и отброшенные намерения — `intentions` и
|
|
904
1046
|
`intentionsDropped`. Тексты из хранилища маскируются по значениям секретов
|
|
905
1047
|
политики из окружения читающего процесса (`policySecrets`, как у
|
|
906
1048
|
коннектора): секрет, которого в этом окружении нет, маска не знает —
|
|
907
1049
|
библиотеке можно передать свою `redact`. Fencing-токены в пакет не
|
|
908
1050
|
попадают.
|
|
909
1051
|
|
|
1052
|
+
**Хост.** Источник пакета — `HandoffSource`: `{ engine, policy, workflows }`,
|
|
1053
|
+
где `engine` — `Engine` над хранилищем хоста, `policy` — его
|
|
1054
|
+
`ExecutionPolicy`, `workflows` — `list()` заданий (пакет и диагнозы берут
|
|
1055
|
+
задания `kind: "graph"`) и `continues(job, view, { reconfigureApplies })`,
|
|
1056
|
+
продолжит ли очередь задание сама. `Harness` удовлетворяет типу структурно;
|
|
1057
|
+
хост со своим движком передаёт свой адаптер заданий без экземпляра
|
|
1058
|
+
`Harness`. Состояние доски над тем же источником — `statusOf(source,
|
|
1059
|
+
graphId?, { detail })` (`Harness.status` — та же функция).
|
|
1060
|
+
|
|
1061
|
+
Параметры `handoffPack`: `graphId`, `intentions`, `redact`, а также
|
|
1062
|
+
`maxBytes` — предел хоста в байтах UTF-8, целое от `HANDOFF_MIN_BYTES`
|
|
1063
|
+
(4 КБ) до `HANDOFF_MAX_BYTES` (по умолчанию), иначе `INVALID_INPUT`; порядок
|
|
1064
|
+
отбрасывания и счётчики `truncated` те же, что у предела по умолчанию, а
|
|
1065
|
+
`bySize` значит «записи отброшены ради предела», а не «пакет уложился».
|
|
1066
|
+
Сводка, очередь, идущие попытки, задания и `next` не отбрасываются, поэтому
|
|
1067
|
+
уложиться не гарантируется: размер результата хост проверяет сам.
|
|
1068
|
+
`HANDOFF_MIN_BYTES` — нижняя граница, ниже которой не помещается даже обычный
|
|
1069
|
+
минимальный пакет, а не гарантия. `measure` — что укладывается в предел: `json` (по умолчанию) —
|
|
1070
|
+
сериализованный пакет; `markdown` — и JSON, и `handoffMarkdown(pack)`
|
|
1071
|
+
(Markdown бывает длиннее JSON: «|» в ячейке экранируется). Свой раздел
|
|
1072
|
+
Markdown хост учитывает, уменьшая `maxBytes`. Маску из секретов политики и
|
|
1073
|
+
своих значений хост составляет из `policySecrets(policy, env?)`,
|
|
1074
|
+
`redactor` и `composeRedactors` корня пакета.
|
|
1075
|
+
|
|
910
1076
|
Весь пакет — один снимок хранилища: `handoffPack` выполняет status,
|
|
911
1077
|
диагнозы и чтение заданий графов внутри одного `read`
|
|
912
1078
|
(`SqliteExecutionStore.read` вложенным чтением использует снимок внешнего,
|
|
@@ -980,7 +1146,9 @@ git хоста над checkout с чужим кодом (`hostGitArgs`, `assertT
|
|
|
980
1146
|
`binding`, его дополнительные границы — `boundary`), проверка
|
|
981
1147
|
переносимого результата (`resultProblems`), классы и правила отказов
|
|
982
1148
|
(`BlockedError`, `TaskFailure`, `classifyFailure`, `failureFingerprint`,
|
|
983
|
-
`repairPolicy`, `
|
|
1149
|
+
`repairPolicy`, `repairRepeats` — повторы одного отпечатка с учётом предела
|
|
1150
|
+
окна контекста, `lastContextLimit` — предел последней попытки с отказом,
|
|
1151
|
+
`repairDecision`), раунд технического ревью
|
|
984
1152
|
(`technicalReview`), точка сбоя подтверждения корпуса для тестов
|
|
985
1153
|
(`caseHooks`). Глубокие импорты `lib/...` не поддерживаются.
|
|
986
1154
|
|
|
@@ -996,12 +1164,12 @@ subjects)`: `subjects.input(kind, id, view)` задаёт digest входа и
|
|
|
996
1164
|
`HarnessError {code, class, message, issues[{path, message}]}`; класс задаёт
|
|
997
1165
|
exit code CLI.
|
|
998
1166
|
|
|
999
|
-
| Exit | Класс | Коды
|
|
1000
|
-
| ---- | ---------------- |
|
|
1001
|
-
| 0 | успех | —
|
|
1002
|
-
| 2 | `input` | `INVALID_INPUT`, `UNSUPPORTED_COMMAND`, `UNSUPPORTED_VERSION`, `GRAPH_*`, `GATE_*`, `REVIEWER_*`, `RESPONSE_TOO_LARGE`
|
|
1003
|
-
| 3 | `refused` | `APPROVAL_STALE`, `APPROVAL_REQUIRED`, `LEASE_STALE`, `CONTROLLER_BUSY`, `PAUSED`, `NOT_READY`, `SCOPE_VIOLATION`, `GATE_FAILED`, `REVIEW_REJECTED`, `BUDGET_EXHAUSTED`, `BUDGET_UNKNOWN`, `ATTEMPTS_EXHAUSTED`, `REVISION_CONFLICT`, `CANCELLED`, `NOT_FOUND`, `PATH_CONFLICT` |
|
|
1004
|
-
| 4 | `infrastructure` | `STATE_VERSION_UNSUPPORTED`, `RUNTIME_UNAVAILABLE`, `REVIEW_PROTOCOL_INVALID`, `SANDBOX_UNAVAILABLE`, `GIT_FAILED`, `STORAGE_FAILED`, `DELIVERY_FAILED`, `INTERNAL`
|
|
1167
|
+
| Exit | Класс | Коды |
|
|
1168
|
+
| ---- | ---------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
|
1169
|
+
| 0 | успех | — |
|
|
1170
|
+
| 2 | `input` | `INVALID_INPUT`, `UNSUPPORTED_COMMAND`, `UNSUPPORTED_VERSION`, `GRAPH_*`, `GATE_*`, `REVIEWER_*`, `RESPONSE_TOO_LARGE` |
|
|
1171
|
+
| 3 | `refused` | `APPROVAL_STALE`, `APPROVAL_REQUIRED`, `LEASE_STALE`, `CONTROLLER_BUSY`, `PAUSED`, `NOT_READY`, `SCOPE_VIOLATION`, `GATE_FAILED`, `REVIEW_REJECTED`, `BUDGET_EXHAUSTED`, `BUDGET_UNKNOWN`, `ATTEMPTS_EXHAUSTED`, `CONTEXT_EXHAUSTED`, `REVISION_CONFLICT`, `CANCELLED`, `NOT_FOUND`, `PATH_CONFLICT` |
|
|
1172
|
+
| 4 | `infrastructure` | `STATE_VERSION_UNSUPPORTED`, `RUNTIME_UNAVAILABLE`, `REVIEW_PROTOCOL_INVALID`, `SANDBOX_UNAVAILABLE`, `GIT_FAILED`, `STORAGE_FAILED`, `DELIVERY_FAILED`, `INTERNAL` |
|
|
1005
1173
|
|
|
1006
1174
|
Exit 1 не используется: им Node завершает процесс при необработанном
|
|
1007
1175
|
исключении.
|
|
@@ -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`.
|