devcontour-harness 0.1.0-alpha.29 → 0.1.0-alpha.30

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (65) hide show
  1. package/README.md +30 -2
  2. package/docs/architecture.md +64 -0
  3. package/docs/compatibility.md +15 -14
  4. package/docs/contracts.md +244 -26
  5. package/docs/release-notes/0.1.0-alpha.30.md +40 -0
  6. package/docs/review-probes.md +17 -17
  7. package/docs/upgrade.md +93 -0
  8. package/lib/agents/review-probe.d.ts +1 -0
  9. package/lib/agents/review-probe.js +20 -0
  10. package/lib/cli.js +57 -1
  11. package/lib/contracts/cli.d.ts +1150 -22
  12. package/lib/contracts/cli.js +129 -4
  13. package/lib/contracts/events.d.ts +642 -3
  14. package/lib/contracts/events.js +48 -0
  15. package/lib/contracts/index.d.ts +1 -0
  16. package/lib/contracts/index.js +1 -0
  17. package/lib/contracts/ports.d.ts +5 -1
  18. package/lib/contracts/published.d.ts +559 -2
  19. package/lib/contracts/published.js +2 -0
  20. package/lib/contracts/report.d.ts +1149 -0
  21. package/lib/contracts/report.js +401 -0
  22. package/lib/control/harness.d.ts +454 -1
  23. package/lib/control/harness.js +83 -1
  24. package/lib/control/report-file.d.ts +19 -0
  25. package/lib/control/report-file.js +85 -0
  26. package/lib/control/report.d.ts +9 -0
  27. package/lib/control/report.js +27 -0
  28. package/lib/engine/engine.d.ts +5 -1
  29. package/lib/engine/engine.js +49 -7
  30. package/lib/engine/runner.js +5 -2
  31. package/lib/environment/dependency-network.d.ts +42 -0
  32. package/lib/environment/dependency-network.js +413 -0
  33. package/lib/environment/lifecycle.d.ts +3 -1
  34. package/lib/environment/lifecycle.js +22 -4
  35. package/lib/environment/process.d.ts +5 -0
  36. package/lib/environment/process.js +38 -0
  37. package/lib/explain/state.d.ts +38 -0
  38. package/lib/explain/state.js +19 -11
  39. package/lib/index.d.ts +2 -0
  40. package/lib/index.js +2 -0
  41. package/lib/projections/attempt.d.ts +101 -0
  42. package/lib/projections/attempt.js +64 -0
  43. package/lib/projections/index.d.ts +2 -1
  44. package/lib/projections/index.js +2 -1
  45. package/lib/projections/stop.d.ts +19 -0
  46. package/lib/projections/stop.js +33 -27
  47. package/lib/report/compute.d.ts +72 -0
  48. package/lib/report/compute.js +1219 -0
  49. package/lib/report/document.d.ts +27 -0
  50. package/lib/report/document.js +206 -0
  51. package/lib/report/format.d.ts +23 -0
  52. package/lib/report/format.js +53 -0
  53. package/lib/report/html.d.ts +7 -0
  54. package/lib/report/html.js +109 -0
  55. package/lib/report/index.d.ts +4 -0
  56. package/lib/report/index.js +7 -0
  57. package/lib/report/markdown.d.ts +7 -0
  58. package/lib/report/markdown.js +112 -0
  59. package/lib/storage/sqlite.d.ts +19 -0
  60. package/lib/storage/sqlite.js +61 -6
  61. package/lib/verification/gates.d.ts +6 -0
  62. package/lib/verification/gates.js +15 -0
  63. package/package.json +5 -1
  64. package/schemas/run-event.schema.json +95 -0
  65. package/schemas/value-report.schema.json +2541 -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.29` — предварительный выпуск (alpha). Договоры
8
+ > Статус: `0.1.0-alpha.30` — предварительный выпуск (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.29 # точная версия
31
+ npm install --save-exact devcontour-harness@0.1.0-alpha.30 # точная версия
32
32
  # или: npm install --save-exact devcontour-harness@alpha # текущая alpha
33
33
  npx harness --version
34
34
  ```
@@ -102,12 +102,34 @@ git rev-parse refs/heads/harness/accepted # совпадает с data.result.
102
102
  | `worktree-cleanup --state D [--dry-run]` | Уборка деревьев завершённых попыток |
103
103
  | `profile --profile ID [--repository D]` | Разрешение профиля стека без команд проекта |
104
104
  | `doctor` | Версии, runtime, sandbox, совместимость состояния |
105
+ | `report --state D [--format md\|html]` | Отчёт об эффекте по данным проекта |
105
106
 
106
107
  stdout — один JSON (`devcontour-harness/v1alpha1`), диагностика — stderr. Exit
107
108
  codes: 0 успех, 2 неверный вход, 3 отказ/блокировка, 4 инфраструктура.
108
109
  `HARNESS_CODEX_BIN` и `HARNESS_CLAUDE_BIN` подменяют исполняемые файлы runtime
109
110
  — например, fixture executable в тестах (это не живая модель).
110
111
 
112
+ ## Что вы увидите: отчёт
113
+
114
+ `harness report --state D --format html --out report.html` строит по
115
+ каталогу состояния один HTML-файл (или Markdown, или JSON в конверте): что
116
+ дал harness на этом проекте. Сводка — не больше пяти чисел с основанием:
117
+ сколько поручений принято и сколько с первой попытки, сколько вернули
118
+ проверки, ревью или правило области до слияния, срок от согласования до
119
+ приёмки, известный расход на принятое поручение и доля отказов окружения.
120
+ Дальше — разделы о дефектах, автономности, скорости, расходе, окружении,
121
+ неделях, таблица поручений и «Ограничения и неизвестное».
122
+
123
+ Отчёт показывает только наблюдения: счёт и длительности из записанного
124
+ состояния, без «сэкономленных часов» и сравнения «до и после». Неизвестное
125
+ не превращается в ноль («≥ $5.73», «unknown»); процент — от 20 в
126
+ знаменателе, медиана — от 5 значений, меньше трёх принятых поручений —
127
+ «недостаточно данных». Тексты prompt, находок и ошибок, токены и домашний
128
+ каталог в отчёт не попадают; `--no-titles` убирает и заголовки. Тот же
129
+ каталог — те же байты: момент отчёта — последняя метка времени в данных.
130
+ Хост строит тот же отчёт из своего хранилища: `valueReport` из
131
+ `devcontour-harness/report`. Подробно — [ValueReport](docs/contracts.md#valuereport).
132
+
111
133
  ## Библиотека
112
134
 
113
135
  ```js
@@ -124,6 +146,12 @@ PASS» нет. Адаптеры хоста реализуют порты `Execut
124
146
  `devcontour-harness/schemas/<имя>.schema.json`. Декларации используют типы
125
147
  Node.js: TypeScript-потребителю нужен `@types/node` (или `skipLibCheck`).
126
148
 
149
+ ## Выпуск 0.1.0-alpha.30
150
+
151
+ Отчёт об эффекте `harness report`, события стадий и `status --detail` для
152
+ наблюдения за попыткой, сетевые отказы установки зависимостей — отказ среды.
153
+ Подробно — [заметки выпуска](docs/release-notes/0.1.0-alpha.30.md).
154
+
127
155
  ## Выпуск 0.1.0-alpha.29
128
156
 
129
157
  Проверки под нагрузкой машины стартуют надёжно, а несостоявшийся старт песочницы
@@ -689,6 +689,70 @@ executable. Live smoke — отдельный opt-in с явно заданны
689
689
  каталогах: srt ищет его через `which` с таймаутом в секунду, и под
690
690
  нагрузкой машины такой поиск отказывал до запуска команды. Не найденный
691
691
  так shell по-прежнему ищет `which`.
692
+ - **Сеть и реестр при установке зависимостей.** Упавшая установка
693
+ зависимостей — класс `environment` с причиной `dependency-network`, а не
694
+ `gate`, только при всех условиях
695
+ <!-- repo-only -->(`src/environment/dependency-network.ts`)<!-- /repo-only -->:
696
+ - **Команда.** argv закреплён политикой (gate попытки или шаг `prepare`) и
697
+ сам является установкой: `npm install|i|ci|clean-install`, `pnpm
698
+ install|i|fetch`, `yarn [install]`, в том числе через `corepack` (и
699
+ `corepack pnpm@9`), по абсолютному пути и с `.cmd`. До подкоманды —
700
+ только известные опции; `--`, неизвестная опция без `=`, `npm run …`,
701
+ `npx`, `pnpm exec`, shell и собственные скрипты — не установка.
702
+ - **Входы как в базе.** Входы менеджера в проверяемом дереве совпадают с
703
+ базой попытки (`baseSha`): `.npmrc`, `.yarnrc`, `.yarnrc.yml`, pnpmfile,
704
+ `pnpm-workspace.yaml`, lockfiles, `.pnp.*` и все `.gitignore` — побайтно; в
705
+ каждом `package.json` — поля зависимостей, `overrides`, `resolutions`,
706
+ `pnpm`, `packageManager`, `workspaces` и скрипты установки. Файлы дерева
707
+ находит обход файловой системы, а не индекс git: манифест, скрытый
708
+ `.gitignore` или `.git/info/exclude`, менеджер всё равно найдёт по глобу
709
+ workspace. Обход не заходит в `node_modules`, `.git` и копию хранилища
710
+ зависимостей в корне (`.pnpm-store`), ссылки не разыменовывает; каждая
711
+ символическая ссылка дерева должна быть в базе с той же целью. Symlink
712
+ вместо файла, удаление или новый файл — расхождение. Без базы (проверка
713
+ потребителя, `runGatesAt`, lifecycle) классификации нет. На integration
714
+ сверка идёт с той же базой: правки целевой ветки после неё дают
715
+ расхождение, и отказ остаётся `gate`.
716
+ - **База не исполняет кода при установке.** Ни в одном `package.json` базы
717
+ нет скриптов установки (`preinstall`, `install`, `postinstall`,
718
+ `prepublish`, `prepare` и соседних, `dependencies`), нет pnpmfile и
719
+ `.pnp.*`, а `.npmrc`, `.yarnrc*` и `pnpm-workspace.yaml` не ссылаются на
720
+ код (`pnpmfile`, `node-options`, `script-shell`, `yarnPath`, `plugins` и
721
+ подобные). Такой скрипт базы мог бы исполнить исходник кандидата, и
722
+ выводу установки верить было бы нельзя.
723
+ - **Менеджер вышел сам** с кодом 1–127; выход по сигналу или без кода — не
724
+ его отчёт.
725
+ - **Отчёт в формате менеджера.** Заголовок ошибки pnpm (`ERR_PNPM_FETCH_403`,
726
+ `ECONNRESET` в узких пробелах), строка `npm error code …`, строка yarn
727
+ `error An unexpected error occurred: …`. Каждый названный код — сетевой:
728
+ HTTP 403, 407, 408, 429 или 5xx реестра, `FETCH_ERROR`, errno соединения,
729
+ TLS или сертификат. Каждая строка ошибки yarn несёт сетевую подпись. В
730
+ выводе нет признака ошибки проекта: lockfile, нет версии или пакета, 404,
731
+ peer-зависимости, упавший скрипт, целостность. Сетевые слова в выводе
732
+ скриптов, эхо команды npm и предупреждения повтора pnpm не засчитываются.
733
+
734
+ Сообщение начинается с `dependency-network:` и подписи — его показывают
735
+ `explain`, `result` и история попыток. Дальше отказ ведёт себя как любой
736
+ отказ окружения: попытку не тратит, ставит паузу `runtime`, повтор
737
+ восстановлением берёт того же кандидата и заново гоняет проверки, второй
738
+ одинаковый отказ останавливает работу, на поручение действует
739
+ `MAX_NEUTRAL_FAILURES`. Reviewer probe такого gate (с базой попытки) получает
740
+ `error`/`environment`.
741
+
742
+ Почему подделка не проходит. Отказ, причина которого в правке кандидата
743
+ (реестр в `.npmrc`, URL tarball, новый пакет, закрытый прокси, свой
744
+ pnpmfile или скрипт установки), — расхождение входов с базой, и он остаётся
745
+ `gate`: его видит и чинит следующая попытка, а очередь не встаёт. Напечатать
746
+ строки менеджера кандидат может только кодом, который менеджер исполняет при
747
+ установке, — его нет ни в базе, ни в дереве. Скрипт, убивший менеджер,
748
+ оставляет выход по сигналу. Остаётся настоящий отказ сети или реестра на
749
+ входах базы.
750
+
751
+ Отладчик менеджера (`SIGUSR1` открывает инспектор Node) кодом кандидата
752
+ не достижим: при совпадающих входах и базе без кода установки менеджер не
753
+ исполняет кода дерева. Поэтому `--disable-sigusr1` в `NODE_OPTIONS`
754
+ установки не добавляется — он менял бы окружение команды проекта.
755
+
692
756
  - **Корень рабочих деревьев.** При состоянии внутри репозитория checkout
693
757
  размещается в кэше пользователя вне дерева; хост может задать
694
758
  `checkoutRoot`. Корень не должен ни лежать внутри репозитория, состояния
@@ -148,20 +148,21 @@ Standalone-хост использует `digestOf` (SHA-256 каноничес
148
148
 
149
149
  ## Сохраняемые форматы
150
150
 
151
- | Что | Правило |
152
- | --------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
153
- | Состояние `version: 1` | Читается как есть; иная версия отклоняется до записи |
154
- | Типы событий журнала | Прежние строки, см. `transactionKinds` |
155
- | Ветки | Целевая `devcontour/accepted` (в политике `refs/heads/devcontour/accepted`), ветки попыток `devcontour/run-<runId>` |
156
- | Каталоги попыток | `worktrees/<runId>`, `worktrees/<runId>-integration`, `artifacts/<runId>/…`, `dependencies/<runId>/manifest.json`; при каталоге состояния внутри репозитория деревья и снимки — под корнем вне дерева `<checkoutRoot>/<repositoryId>/…` (alpha.23) |
157
- | Receipt среды | `environment.json` `version: 1` |
158
- | Отчёт свойств, договор проверки, корпус | `version: 1` |
159
- | Хранилище зависимостей | Необязательное `repositories[].dependencyStore`: без поля политика, её digest и каталоги прежние. Каталог `dependency-store` закрыт профилю codex для всех установок, как и другие служебные каталоги; seed другого формата не используется ни как попадание, ни как основа сборки: он пересобирается и вытесняется |
160
- | Artifacts gates | Необязательное `repositories[].gates[].artifacts`: без поля политика и её digest прежние. Поле `artifactFiles` в evidence gate и в записи совместной проверки необязательно: прежние записи читаются как есть |
161
- | Владение репозиторием | `<git-common-dir>/devcontour-owner.json` |
162
- | Ресурсы | Отдельная база блокировок ресурсов `resources.sqlite`: блокировки устройств и портов, а не состояние исполнения. Таблица `seed_pins` создаётся только при первом обращении хранилища зависимостей |
163
- | Снимок коннектора | Поля `proof` и `baseline` manifest необязательны: прежние записи читаются как есть. Без `baseline` в конфигурации ревизия, graph digest и context digest те же, что в прежних версиях |
164
- | Probe ревьюера | MCP-сервер `devcontour_probe`, инструмент `run_check`; протокол — построчный JSON-RPC (stdio), журнал `probes.jsonl` |
151
+ | Что | Правило |
152
+ | --------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
153
+ | Состояние `version: 1` | Читается как есть; иная версия отклоняется до записи |
154
+ | Типы событий журнала | Прежние строки, см. `transactionKinds` |
155
+ | События стадий | Тип `attempt.stage` (не выпущено): границы стадий попытки: `started` и не больше одного `finished` на замер `AttemptState.timings` (стадия утратившей владение попытки остаётся открытой); документ состояния и digest политики прежние. Тип, которого читатель не знает, читается как `{type: 'unknown', original}` без нагрузки. Версии до этой событие разбирают строго: после отката ниже неё `events` отказывает на странице с ним (upgrade.md) |
156
+ | Ветки | Целевая `devcontour/accepted` (в политике `refs/heads/devcontour/accepted`), ветки попыток `devcontour/run-<runId>` |
157
+ | Каталоги попыток | `worktrees/<runId>`, `worktrees/<runId>-integration`, `artifacts/<runId>/…`, `dependencies/<runId>/manifest.json`; при каталоге состояния внутри репозитория деревья и снимки — под корнем вне дерева `<checkoutRoot>/<repositoryId>/…` (alpha.23) |
158
+ | Receipt среды | `environment.json` `version: 1` |
159
+ | Отчёт свойств, договор проверки, корпус | `version: 1` |
160
+ | Хранилище зависимостей | Необязательное `repositories[].dependencyStore`: без поля политика, её digest и каталоги прежние. Каталог `dependency-store` закрыт профилю codex для всех установок, как и другие служебные каталоги; seed другого формата не используется ни как попадание, ни как основа сборки: он пересобирается и вытесняется |
161
+ | Artifacts gates | Необязательное `repositories[].gates[].artifacts`: без поля политика и её digest прежние. Поле `artifactFiles` в evidence gate и в записи совместной проверки необязательно: прежние записи читаются как есть |
162
+ | Владение репозиторием | `<git-common-dir>/devcontour-owner.json` |
163
+ | Ресурсы | Отдельная база блокировок ресурсов `resources.sqlite`: блокировки устройств и портов, а не состояние исполнения. Таблица `seed_pins` создаётся только при первом обращении хранилища зависимостей |
164
+ | Снимок коннектора | Поля `proof` и `baseline` manifest необязательны: прежние записи читаются как есть. Без `baseline` в конфигурации ревизия, graph digest и context digest те же, что в прежних версиях |
165
+ | Probe ревьюера | MCP-сервер `devcontour_probe`, инструмент `run_check`; протокол — построчный JSON-RPC (stdio), журнал `probes.jsonl` |
165
166
 
166
167
  ## Переменные окружения gates
167
168
 
package/docs/contracts.md CHANGED
@@ -32,7 +32,8 @@ refs, варианты исходов. Связи **между** значени
32
32
 
33
33
  Опубликованы: `work-order`, `work-graph`, `execution-policy`,
34
34
  `context-snapshot`, `contract-document`, `run-result`, `result-envelope`,
35
- `run-event`, `review-record`, `joint-verification`, `execution-document`.
35
+ `run-event`, `review-record`, `joint-verification`, `execution-document`,
36
+ `value-report` (отчёт `harness report`, см. «ValueReport»).
36
37
 
37
38
  ## Версии
38
39
 
@@ -619,6 +620,40 @@ manifestDigest, impact?, evidence[], error?}`. Смена любого SHA де
619
620
  схема: лишних полей нет, поэтому токен владения, секрет или объект попытки в
620
621
  событие не попадает.
621
622
 
623
+ `attempt.stage` — граница стадии попытки: `{timingId, stage, phase:
624
+ 'started'|'finished', at, durationMs?, outcome?: 'passed'|'failed'}`, конверт
625
+ несёт `graphId`, `workId`, `runId`, `attempt`. Стадии — те же, что замеры
626
+ `AttemptState.timings`: `dependency-store`, `implementation` /
627
+ `implementation-reuse`, `candidate-environment:<шаг>`, `integration-wait`,
628
+ `<фаза>-test:<gate>`, `<фаза>-consumer:<репозиторий>:<gate>`,
629
+ `<фаза>-recheck:<gate>`, `<фаза>-review`, `integration-environment:<шаг>`,
630
+ `integration-consumer-environment:<репозиторий>:<шаг>`. На стадию — одно
631
+ `started` и не больше одного `finished` (у него `durationMs` и `outcome`);
632
+ `at` и `durationMs` — по часам движка и совпадают с замером. Событие пишется
633
+ в той же транзакции `run.timing.started`/`run.timing.finished`, что и замер,
634
+ под fencing: утративший владение не пишет ни замера, ни события. Повторное
635
+ закрытие замера ничего не меняет и событий не создаёт.
636
+
637
+ `finished` может не прийти: поздний finish владельца, утратившего срок,
638
+ отклоняется (runner его не повторяет), упавший процесс его не пишет, а `adopt`
639
+ и recovery открытые замеры прежнего владельца не закрывают. Такая стадия
640
+ остаётся открытой и в замере, и в журнале; её конец — событие конца попытки
641
+ (`attempt.expired`, `attempt.failed`, `attempt.cancelled`,
642
+ `attempt.recovered`, `work.accepted`). Потребитель журнала обязан обрабатывать
643
+ незакрытые стадии.
644
+
645
+ Чтение журнала терпимо к типам более новых версий: событие типа, которого нет
646
+ в `eventPayloads`, возвращается как `UnknownRunEvent` —
647
+ `{apiVersion, seq, at, graphId?, workId?, runId?, attempt?, type: 'unknown',
648
+ original}` (исходный тип, не длиннее 200 символов; нагрузка не возвращается).
649
+ `RunEvent` = известные события (`KnownRunEvent`) | `UnknownRunEvent`: нагрузка
650
+ доступна после сужения по `type` (`e.type !== 'unknown'`) или у
651
+ `KnownRunEvent`. Тип `ExecutionStore.events()` прежний (`RunEvent[]`), поэтому
652
+ хранилища хоста, возвращающие или делегирующие события, компилируются без
653
+ изменений. Разбор — `readRunEvent`, схема чтения — `readRunEventSchema`. Запись строгая
654
+ (`runEventSchema`, опубликованная `run-event`): `unknown` записать нельзя;
655
+ известный тип с нарушенной нагрузкой при чтении — отказ.
656
+
622
657
  `transactionKinds` — имена транзакций исполнения; совпадают с сохранёнными
623
658
  типами событий журнала хоста (`run.claimed`, `task.done`, `run.failed`,
624
659
  `scheduler.error`, …). `workflow.updated` пишет только локальные записи
@@ -640,6 +675,120 @@ manifestDigest, impact?, evidence[], error?}`. Смена любого SHA де
640
675
  (`policy.applied`, `policy.reconfigure`). `base.moved` — проверка владения
641
676
  операцией и CAS-сдвиг ref базы; записей и событий не создаёт.
642
677
 
678
+ ### ValueReport
679
+
680
+ Отчёт об эффекте (`harness report`, `valueReport` из `devcontour-harness/report`
681
+ и корня пакета; `reportVersion: 1`, `valueReportSchema`,
682
+ `schemas/value-report.schema.json`). Отвечает на вопрос «что дал harness на
683
+ этом проекте» данными самого проекта: только наблюдения (счёт и
684
+ длительности), без «сэкономленных часов» и сравнения «с harness и без»
685
+ (базы до harness в состоянии нет).
686
+
687
+ Вход (`ValueReportInput`) — те же формы, что у `ExecutionView`: `works`,
688
+ `attempts`, `calls` (`locals('usage')`), `reviews` (`locals('reviews')`),
689
+ `events`, `graphs`. `collectReportInput(store)` собирает его из любого
690
+ `ExecutionStore` одним `read` и страницами `events` по 500; `Harness.report()`
691
+ — то же по каталогу состояния. Параметры: `since` (включительно; ISO-время с
692
+ поясом, дата `YYYY-MM-DD` или `Nd`/`Nw` до `asOf`), `until` (не
693
+ включительно), `asOf`, `noTitles`, `label`, `stateDir`, `harnessVersion`.
694
+ `reportMarkdown(report)` и `reportHtml(report)` — чистые рендеры: те же
695
+ разделы и числа; HTML — один файл без скриптов, шрифтов, изображений и
696
+ внешних ссылок (CSP `default-src 'none'; style-src 'unsafe-inline'; img-src
697
+ data:`), светлая и тёмная схема по `prefers-color-scheme`, таблицы
698
+ прокручиваются на ширине телефона, столбики недель (inline SVG) — от 3
699
+ активных недель. Модуль `devcontour-harness/report` без `node:*` и без zod.
700
+
701
+ **Детерминизм.** Тот же вход и параметры — те же байты JSON, Markdown и HTML
702
+ при любом порядке входных массивов, часах и часовом поясе. `asOf` по
703
+ умолчанию — последняя метка времени в данных (событие, начало или конец
704
+ попытки и вызова, раунд ревью), не часы; с `until` раньше неё — `until`.
705
+ Время — UTC ISO, недели — ISO (понедельник, UTC), числа без локали.
706
+
707
+ **Определения.**
708
+
709
+ - Принятое поручение — `WorkState.status = done` с успешной попыткой;
710
+ принявшая попытка — последняя `succeeded`. Поручение `done` без успешной
711
+ попытки не имеет времени приёмки и не входит в принятые ни в каком окне
712
+ (`coverage.doneWithoutAttempt`). В окно входят: принятые — по времени
713
+ приёмки, попытки и вызовы — по началу, раунды ревью и события — по своему
714
+ времени.
715
+ - Попытки поручения считаются по записям попыток, а не по
716
+ `WorkState.attempt` (сброс возвращает счётчик к 0).
717
+ - Корзины отказа попытки (`failureBucketOf`): `defect` (`gate`, `review`,
718
+ `scope-violation`), `incomplete` (`empty-result`, `unfinished`,
719
+ `needs-lead`), `integration` (`stale-base`, `merge`), `environment`
720
+ (`environment`, `provider-auth`, `blocked`, истёкшее владение), `time-limit`
721
+ (`timeout`), `tool` (`review-protocol`), `operator` (`cancelled`), `budget`,
722
+ `unknown`, `unclassified` (попытка без класса — записана до
723
+ классификации; не «дефект»). Прерванная штатной остановкой
724
+ (`interrupted: shutdown`) — не отказ, считается отдельно.
725
+ - Первая попытка — у принятого поручения засчитанная попытка одна
726
+ (засчитанные — без `environment` и прерываний); если, кроме принявшей,
727
+ засчитаны только отказы без класса, — неизвестно (`unknown`, `bound:
728
+ lower`). `firstPassRaw` — попытка вообще одна.
729
+ - Возвращено (`sentBack`) — принятое поручение с попыткой `defect` до
730
+ принявшей. Поручения, у которых до приёмки только отказы без класса
731
+ (`unknown`, `unclassified`), не считаются, а идут в `unknown`: тогда
732
+ `bound: lower` («≥ N», «M more without a class»). Без них, но если часть
733
+ поручений вернули только отказы gate подготовки (установка зависимостей,
734
+ возможна сеть; `sentBackSetupOnly`), — `bound: upper`; оба сомнения
735
+ сразу — `bound: unknown` и диапазон `sentBackRange` («1–3 of 5»); иначе
736
+ `exact`.
737
+ - Ревью после зелёных gates (`afterGreenGates`) — ревью кандидата отклонило,
738
+ хотя каждый обязательный gate прошёл на том же SHA (и той же версии
739
+ проверок); диагностика, не точность reviewer.
740
+ - Срок от согласования до приёмки — от `wait.approvedAt` первой попытки
741
+ (иначе `WorkState.approvedAt`, его переписывает повторное согласование —
742
+ `leadTimeFallback`) до конца принявшей попытки; включает очередь и паузы.
743
+ - Расход: известная цена — правило `knownCost`; на принятое поручение —
744
+ известный расход окна / принятые окна. `callsRecorded` попытки значит
745
+ «учёт её вызовов полон», а не «вызовы есть»: записи вызовов попытки без
746
+ флага входят в её расход, но лишь нижней границей
747
+ (`attemptsPartialCalls`); без флага и без записей расход неизвестен
748
+ (`attemptsWithoutCalls`). `bound: exact` — только если все вызовы окна
749
+ завершены с полными счётчиками и ценой и у всех попыток окна учёт полон;
750
+ иначе `lower` («≥»); без единой известной цены при неизвестных —
751
+ `unknown` (`value: null`), не `$0`. Расход отклонённых попыток
752
+ (`cost.rejected`) и расход отказов окружения (`environment.neutral`) —
753
+ одна и та же атрибуция по всем завершённым попыткам окна.
754
+ - Действия человека — только записи с актёром-человеком: решения recovery
755
+ с источником `operator`. Удержания (`work.held`) и отмены попыток актёра
756
+ не называют (удерживают и операции хоста, например смена контракта): они
757
+ показаны отдельно (`holds`, `cancelledAttempts`) и в действия человека не
758
+ входят. Повторы, сбросы, отмена без попытки и сдвиг базы пока не
759
+ записываются: `withAction` — нижняя граница, «без действий человека»
760
+ (`withoutAction`) пока не измеримо (`value: null`, `bound: unknown`),
761
+ `retries`/`resets`/`baseMoves` — `null`.
762
+ - Отказы окружения (`environment.share`) — среди классифицированных; если
763
+ есть отказы только в gates подготовки (`setupCheckFailures`), доля —
764
+ нижняя граница («at least», «M more may be environment»).
765
+ - Паузы — `control.paused` до следующего `control.resumed` (открытая — до
766
+ `asOf`); время паузы — её пересечение с окном. Согласования — события
767
+ `graph.approved` для графов, у которых такие события есть; для прочих —
768
+ текущее согласование графа в состоянии (`source: state` или `mixed`); нет
769
+ ни того ни другого — `source: none`, число неизвестно, а не ноль.
770
+
771
+ **Малые выборки и неизвестное.** `ReportMeasure` — `{value, n, unknown,
772
+ bound}`, `bound` — `exact | lower | upper | unknown`; неизвестное не
773
+ показывается нулём. Процент — только при знаменателе от 20, иначе «k of n».
774
+ Медиана и p75 — от 5 значений, иначе `null` и значения в `values`. Меньше 3
775
+ принятых поручений в окне — `summary.status: not-enough-data` (сырые
776
+ счётчики вместо заголовочных чисел). Сводка — не больше 5 чисел (принятые и
777
+ первая попытка, возвращено, срок, расход на принятое, отказы окружения),
778
+ каждое с предложением и основанием (`basis`). Раздел `limitations` есть
779
+ всегда: постоянные ограничения и найденные в данных (попытки без класса,
780
+ без замеров, без учёта вызовов, вызовы без цены, начало событий, смена
781
+ версии движка, усечения).
782
+
783
+ **Приватность и пределы.** В отчёт попадают только перечисленные поля: нет
784
+ prompt, вывода runtime, текстов находок, ошибок и причин, fencing-токенов.
785
+ Пути evidence — относительно `stateDir`; путь вне него — `…/<имя файла>`,
786
+ домашний каталог не печатается. `noTitles` убирает заголовки поручений и
787
+ метку проекта. Пределы (`REPORT_LIMITS`): 50 строк поручений (новые сверху),
788
+ 50 ссылок evidence, 12 активных недель (ранние свёрнуты в `earlier`,
789
+ недели без активности — `gap`), 50 строк gates и стадий; JSON ≤ 512 КБ,
790
+ HTML ≤ 1 МБ. Усечение отмечено флагом и ограничением.
791
+
643
792
  ## Порты
644
793
 
645
794
  | Порт | Договор |
@@ -771,36 +920,105 @@ stdout — один JSON `CliEnvelope`: `{apiVersion, command, ok: true, data}`
771
920
  читающие на отсутствующем каталоге отвечают `NOT_FOUND` и ничего не создают.
772
921
  Бинарник не хранит настроек проекта и не помнит «последний активный проект».
773
922
 
774
- | Команда | Аргументы | Пишет | `data` | Повтор |
775
- | ------------------ | -------------------------------------------------------------------------------------- | ----- | ---------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------ |
776
- | `validate` | `--graph F --policy F [--context F]` | нет | digests, число поручений | Чистая функция входов |
777
- | `review-plan` | `--state D --graph F --policy F --author A [--context F]` | да | `ReviewRecord` | Тот же digest и автор, уже согласованные, — тот же раунд без вызова модели; автор, не допускаемый правилом вендора, — `REVIEWER_SAME_VENDOR` до вызова |
778
- | `review-contract` | `--state D --contract F --policy F --author A` | да | `ReviewRecord` | Как `review-plan` |
779
- | `approve` | `--state D --subject ID --digest H` | да | subject, digest, at | Тот же digest — без изменений; только `approvalMode: operator` |
780
- | `run` | `--state D --graph F --policy F [--context F] [--sink file:D] [--once]` | да | граф, поручения и их блокеры, задание `workflow` | Та же редакция продолжает работу; другой digest той же редакции — `REVISION_CONFLICT` |
781
- | `status` | `--state D [--graph ID]` | нет | очередь, графы, поручения с блокерами, бюджеты | Только чтение |
782
- | `events` | `--state D [--after N] [--limit 1–500]` | нет | события, `next` | Только чтение |
783
- | `pause` | `--state D` | да | `ControlState` | Без изменений |
784
- | `resume` | `--state D` | да | `ControlState` | Решение человека: снимает паузу оператора, штатной остановки и отказа runtime вместе с её классами; паузу операции reconfigure — `PAUSED` |
785
- | `cancel` | `--state D --work ID [--reason T]` | да | статус поручения | Отменённое — без изменений; это не retry |
786
- | `retry` | `--state D --work ID [--reset --reason T]` | да | статус поручения | В пределах `maxAttempts` и бюджета; `--reset` с причиной сбрасывает счётчик попыток, но не учёт расходов |
787
- | `result` | `--state D --work ID` | нет | `ResultEnvelope` | Только чтение |
788
- | `deliver` | `--state D --work ID --sink file:D` | да | `ResultEnvelope` | Доставленное не доставляется повторно; моделей и интеграции нет |
789
- | `cleanup` | `--state D --run ID` | да | исход очистки попытки |
790
- | `worktree-cleanup` | `--state D [--dry-run]` | да | счётчики и `worktrees[]` с действием и причиной отказа |
791
- | `profile` | `--profile ID\|./F [--repository D]` | нет | закрепление (`pin`) и разрешённый профиль | Чистая функция файлов профиля; команды проекта не исполняются |
792
- | `doctor` | `[--state D] [--policy F]` | нет | версии, runtime, sandbox, совместимость состояния и версии движка в нём | Без live-вызова модели |
793
- | `init` | `--repository D [--profile P] [--writer R] [--state D] [--plan]` | да | план файлов, `created`, `manifest`, `facts`, `toolchain`, `next` | Create-only `.harness/`, manifest до политики, политика последней; повтор — `created: []`; иное решение — `PATH_CONFLICT` |
794
- | `explain` | `--state D --policy F [--work ID]` | нет | `diagnoses[]` (`StopDiagnosis`) | Только чтение: без повторов, вызовов моделей и изменений состояния |
795
- | `plan-request` | `--brief F --policy F [--context F] [--contracts D] [--requirements [R:]F]… [--human]` | нет | `prompt`, `readOnly`, `recommendedTasks`, `maxTasks`, `basis`, `facts` (`PlanningFacts`) | Чистая функция входов: та же постановка и те же факты — тот же prompt и `basis`; модель не вызывается |
796
- | `plan-check` | `--draft F --policy F [--context F] [--contracts D] [--brief F [--basis H]]` | нет | `issues`, `checkPlan`; без проблем — `graph`, `graphDigest`, `basis` | Чистая функция входов и `HEAD` источников требований; согласования не выдаёт, gates не запускает; расхождение `--basis` — `APPROVAL_STALE` |
797
- | `capabilities` | — | нет | каталог общих операций (`OperationCatalog`) | Чистая функция установленной версии пакета |
798
- | `--version` | — | нет | версия пакета и API | — |
923
+ | Команда | Аргументы | Пишет | `data` | Повтор |
924
+ | ------------------ | --------------------------------------------------------------------------------------------------------- | ----- | ---------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------ |
925
+ | `validate` | `--graph F --policy F [--context F]` | нет | digests, число поручений | Чистая функция входов |
926
+ | `review-plan` | `--state D --graph F --policy F --author A [--context F]` | да | `ReviewRecord` | Тот же digest и автор, уже согласованные, — тот же раунд без вызова модели; автор, не допускаемый правилом вендора, — `REVIEWER_SAME_VENDOR` до вызова |
927
+ | `review-contract` | `--state D --contract F --policy F --author A` | да | `ReviewRecord` | Как `review-plan` |
928
+ | `approve` | `--state D --subject ID --digest H` | да | subject, digest, at | Тот же digest — без изменений; только `approvalMode: operator` |
929
+ | `run` | `--state D --graph F --policy F [--context F] [--sink file:D] [--once]` | да | граф, поручения и их блокеры, задание `workflow` | Та же редакция продолжает работу; другой digest той же редакции — `REVISION_CONFLICT` |
930
+ | `status` | `--state D [--graph ID] [--detail]` | нет | очередь, графы, поручения с блокерами, бюджеты; с `--detail` — `detail` | Только чтение |
931
+ | `events` | `--state D [--after N] [--limit 1–500]` | нет | события (неизвестный тип — `unknown`), `next` | Только чтение |
932
+ | `pause` | `--state D` | да | `ControlState` | Без изменений |
933
+ | `resume` | `--state D` | да | `ControlState` | Решение человека: снимает паузу оператора, штатной остановки и отказа runtime вместе с её классами; паузу операции reconfigure — `PAUSED` |
934
+ | `cancel` | `--state D --work ID [--reason T]` | да | статус поручения | Отменённое — без изменений; это не retry |
935
+ | `retry` | `--state D --work ID [--reset --reason T]` | да | статус поручения | В пределах `maxAttempts` и бюджета; `--reset` с причиной сбрасывает счётчик попыток, но не учёт расходов |
936
+ | `result` | `--state D --work ID` | нет | `ResultEnvelope` | Только чтение |
937
+ | `deliver` | `--state D --work ID --sink file:D` | да | `ResultEnvelope` | Доставленное не доставляется повторно; моделей и интеграции нет |
938
+ | `cleanup` | `--state D --run ID` | да | исход очистки попытки |
939
+ | `worktree-cleanup` | `--state D [--dry-run]` | да | счётчики и `worktrees[]` с действием и причиной отказа |
940
+ | `profile` | `--profile ID\|./F [--repository D]` | нет | закрепление (`pin`) и разрешённый профиль | Чистая функция файлов профиля; команды проекта не исполняются |
941
+ | `doctor` | `[--state D] [--policy F]` | нет | версии, runtime, sandbox, совместимость состояния и версии движка в нём | Без live-вызова модели |
942
+ | `init` | `--repository D [--profile P] [--writer R] [--state D] [--plan]` | да | план файлов, `created`, `manifest`, `facts`, `toolchain`, `next` | Create-only `.harness/`, manifest до политики, политика последней; повтор — `created: []`; иное решение — `PATH_CONFLICT` |
943
+ | `explain` | `--state D --policy F [--work ID]` | нет | `diagnoses[]` (`StopDiagnosis`) | Только чтение: без повторов, вызовов моделей и изменений состояния |
944
+ | `report` | `--state D [--since T\|Nd\|Nw] [--until T] [--as-of T] [--format json\|md\|html] [--no-titles] [--out F]` | нет | `ValueReport`; с `--out` — `{out, format, bytes, asOf}` | Только чтение; те же данные и параметры — те же байты |
945
+ | `plan-request` | `--brief F --policy F [--context F] [--contracts D] [--requirements [R:]F]… [--human]` | нет | `prompt`, `readOnly`, `recommendedTasks`, `maxTasks`, `basis`, `facts` (`PlanningFacts`) | Чистая функция входов: та же постановка и те же факты — тот же prompt и `basis`; модель не вызывается |
946
+ | `plan-check` | `--draft F --policy F [--context F] [--contracts D] [--brief F [--basis H]]` | нет | `issues`, `checkPlan`; без проблем — `graph`, `graphDigest`, `basis` | Чистая функция входов и `HEAD` источников требований; согласования не выдаёт, gates не запускает; расхождение `--basis` — `APPROVAL_STALE` |
947
+ | `capabilities` | — | нет | каталог общих операций (`OperationCatalog`) | Чистая функция установленной версии пакета |
948
+ | `--version` | — | нет | версия пакета и API | — |
799
949
 
800
950
  Полная форма каждой команды — `cliCommands` (аргументы, обязательность,
801
951
  идемпотентность, отказы exit 3). Все команды реализованы. `run` принимает `--author` (по умолчанию `external`) — автора графа для ревью плана. `HARNESS_CODEX_BIN` и `HARNESS_CLAUDE_BIN` подменяют исполняемые файлы runtime (fixture executables в тестах).
802
952
  `init --plan` ничего не пишет (exit 3 при конфликтах или неготовом toolchain). `--human` принимают только `init`, `explain` и `plan-request` (печатает prompt): успешный ответ — текст для человека, отказ — тот же JSON-конверт, exit code одинаков; у прочих команд флаг — `INVALID_INPUT`. `plan-check` с проблемами отвечает `ok: true` с данными, exit — по классу первой проблемы; draft — `schemas/plan-draft.schema.json` (`planDraftSchema`). Маршрут самостоятельного проекта и планирование — [standalone](standalone.md).
803
953
 
954
+ **`report`.** Читает каталог состояния только для чтения и строит
955
+ `ValueReport` (`valueReport`); `binding.json` не нужен. Чтение однократное
956
+ (`SqliteExecutionStore.readOnce`): база без журнала (`-wal`, `-journal`)
957
+ открывается неизменяемой (`immutable=1`) — в каталоге не появляется ни одного
958
+ файла; после чтения проверяется, что журнал не появился, а размер и время
959
+ основного файла прежние, иначе (писатель начал работу или журнал уже был)
960
+ чтение повторяется обычным открытием только для чтения. Долгоживущие
961
+ дескрипторы (`status`, `events`, `result`, `explain`, `Harness.open` с
962
+ `readOnlyState`) открываются обычным чтением: с блокировками SQLite они
963
+ видят новые фиксации, а у WAL-базы появляются пустые служебные
964
+ `-wal`/`-shm` (данных в них нет). `--format json` (по умолчанию) — обычный конверт. `--format
965
+ md|html` — документированное исключение, как `--human`: успешный ответ
966
+ печатается текстом без конверта (данные перед этим проверены схемой), отказ
967
+ — тот же JSON-конверт и тот же exit code. `--out F` записывает отчёт
968
+ выбранного формата во временный файл того же каталога и переименовывает
969
+ его поверх цели (запись не идёт сквозь symlink или жёсткую ссылку; права
970
+ прежнего файла сохраняются, новый — `0600`; при неполной записи временный
971
+ файл удаляется);
972
+ `PATH_CONFLICT` — цель не обычный файл, symlink, файл с несколькими жёсткими
973
+ ссылками или путь внутри каталога состояния; отсутствующий каталог —
974
+ `INVALID_INPUT`; stdout — конверт `{out, format, bytes, asOf}`. Неверное
975
+ окно (`--since` не раньше `--until`, время без пояса) — `INVALID_INPUT`;
976
+ нет каталога — `NOT_FOUND`, каталог не создаётся. Флаги `--since`,
977
+ `--until`, `--as-of`, `--format`, `--no-titles` принимает только `report`.
978
+ Пределы размера (JSON 512 КБ, HTML и Markdown 1 МБ) проверяют сами
979
+ `valueReport` и рендеры (`assertReportBytes`, `INTERNAL`).
980
+
981
+ **Причина отказа окружения `dependency-network`.** Установка зависимостей,
982
+ упавшая на сети или реестре пакетов, получает класс `environment`, а не `gate`
983
+ (правило — [архитектура](architecture.md#что-гарантируется), «Сеть и реестр при установке зависимостей»). Отдельного поля
984
+ причины нет: схема состояния прежняя, а `failureKind` — `environment`.
985
+ Причину несёт начало текста отказа: `<фаза>/<gate>: dependency-network: …` у
986
+ gate, `dependency-network: … Шаг <id>: …` у шага `prepare`. Текст
987
+ попадает в `WorkState.failure`, `AttemptState.error`, `summary` evidence gate и в
988
+ `message` диагноза `explain` (`cause: environment`, `action: fix-environment`).
989
+ У reviewer probe такой gate — `status: error`, `failure: environment`, `note`
990
+ начинается с `dependency-network:`. Хост, который сам вызывает `runGate`,
991
+ передаёт базу попытки в необязательном `GateRun.trustedBase`: без неё
992
+ классификации нет и отказ остаётся `gate`. То же поле есть в описании probe
993
+ (`trustedBase`).
994
+
995
+ **`status --detail`.** Без флага ответ `status` прежний. С флагом добавляется
996
+ `detail: {at, queue, attempts}` — снимок наблюдателя по часам движка:
997
+
998
+ - `queue` — почему стоит выдача: `paused`, `reason` и `detail` (`queueStop`;
999
+ у паузы отказа runtime `detail` — сообщение последнего отказа её классов),
1000
+ `since`, `operation`, `failures` (классы отказа паузы runtime) и кто и что её
1001
+ снимает — `code`, `cause`, `actor`, `action` (`queuePause`, то же
1002
+ рассуждение, что у `explain` на claim). Паузу, которую снимет следующий
1003
+ run (очередь ещё не запускали, штатная остановка, применимый запрос
1004
+ политики), `explain` считает снятой; `queue` показывает её с
1005
+ `liftedByRun: true` и тем же диагнозом, что у готового поручения в
1006
+ `explain`: `NOT_READY`, `not-ready`, `controller`, `wait`.
1007
+ - `attempts[]` — активные попытки (`attemptView`): `runId`, `workId`,
1008
+ `attempt`, `phase`, `runtime`, `model?`, `startedAt`, `elapsedMs`; `stage`
1009
+ — последний незакрытый замер (`name`, `family` — имя до `:`, `startedAt`,
1010
+ `elapsedMs`; при равном начале — позже записанный); `lease` — `owner`,
1011
+ `leaseUntil`, `leaseMs`, `sinceHeartbeatMs` (от последнего heartbeat,
1012
+ `leaseUntil − leaseMs`; нет при сроке `0` — владение отозвано) и `stale`
1013
+ (срок истёк). `leaseMs` — из политики процесса, который читает: у CLI —
1014
+ `binding.json` каталога состояния. `gates` — обязательные gates текущей фазы
1015
+ (интеграции в `integrating`, иначе кандидата) по последней записи каждого на
1016
+ текущем SHA фазы, без проверок потребителей: `passed + failed + remaining =
1017
+ required`.
1018
+
1019
+ `attemptView` и `queuePause` — чистые проекции `devcontour-harness/projections`:
1020
+ хост строит тот же вид по своей попытке.
1021
+
804
1022
  **Общие операции и граница транспорта.** `init`, `explain`, `plan-request`,
805
1023
  `plan-check` и `capabilities` — общие операции агентского слоя
806
1024
  (`sharedOperations`): описание, `readOnly` (= `!writes`), вход (по `args`) и
@@ -0,0 +1,40 @@
1
+ # devcontour-harness 0.1.0-alpha.30
2
+
3
+ Видно, что дал harness и что он делает сейчас: отчёт об эффекте по истории
4
+ работы, события стадий попытки и подробный `status`. Сетевые отказы установки
5
+ зависимостей больше не считаются дефектами проекта. Обязательные gates,
6
+ fencing и привязка доказательств к SHA не меняются; формат состояния прежний.
7
+
8
+ ## Изменения
9
+
10
+ - **`harness report`.** Отчёт по каталогу состояния в JSON, Markdown или
11
+ одном HTML-файле без внешних ресурсов: принятые поручения и первая попытка,
12
+ возвраты проверками и ревью до merge, срок от согласования до приёмки,
13
+ расход на поручение, отказы окружения, недели и ограничения. Неизвестное
14
+ показано как «≥», «≤», диапазон или «неизвестно», а не ноль; на малых
15
+ выборках — «N из M» без процентов. Тот же отчёт — функция `valueReport`
16
+ (`devcontour-harness/report`, без `node:*`) для хоста. Отчёт только читает:
17
+ однократное чтение не оставляет файлов в каталоге состояния.
18
+ - **События стадий.** `attempt.stage` (`started`/`finished`) для каждой
19
+ измеряемой стадии попытки: хранилище зависимостей, подготовка, реализация,
20
+ каждый gate, ревью, интеграция. Пишутся в тех же fenced-транзакциях, что и
21
+ тайминги; стадия попытки, потерявшей lease, остаётся открытой до события
22
+ завершения попытки.
23
+ - **`status --detail`.** Текущая стадия и время активных попыток, свежесть
24
+ lease, счёт обязательных gates текущей фазы и вид остановки очереди — тем же
25
+ рассуждением, что и `explain`. Проекция `attemptView` для хостов.
26
+ - **Чтение незнакомых событий.** События неизвестного типа читаются как
27
+ `unknown`, а не ломают `events`. Тип `RunEvent` включает этот вариант: код,
28
+ читающий `payload`, сужает по `type` или использует `KnownRunEvent`.
29
+ - **Сеть и реестр при установке зависимостей.** Упавшая установка — отказ
30
+ среды с причиной `dependency-network`, только если команда — установка из
31
+ политики, входы менеджера пакетов совпадают с базой попытки, база не
32
+ исполняет кода при установке, менеджер вышел сам и назвал только сетевые
33
+ коды. Всё, что изменил кандидат, остаётся провалом проверки.
34
+
35
+ ## Обновление
36
+
37
+ Пакет alpha.29 остаётся неизменным. Формат состояния (`stateVersion: 1`) и
38
+ политики прежний. Откат ниже этой версии не прочитает страницу событий с
39
+ `attempt.stage`: откатывайтесь вместе с копией состояния, снятой до
40
+ обновления. Подробнее — `docs/upgrade.md`.