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

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 (47) hide show
  1. package/README.md +14 -2
  2. package/docs/architecture.md +16 -0
  3. package/docs/compatibility.md +1 -0
  4. package/docs/contracts.md +33 -0
  5. package/docs/release-notes/0.1.0-alpha.28.md +37 -0
  6. package/docs/release-notes/0.1.0-alpha.29.md +32 -0
  7. package/docs/review-probes.md +13 -10
  8. package/docs/toolchains.md +12 -1
  9. package/docs/upgrade.md +43 -0
  10. package/lib/agents/review-probe.js +18 -0
  11. package/lib/contracts/cli.d.ts +25 -21
  12. package/lib/contracts/diagnosis.d.ts +1 -1
  13. package/lib/contracts/events.d.ts +6 -6
  14. package/lib/contracts/execution.d.ts +268 -16
  15. package/lib/contracts/execution.js +3 -1
  16. package/lib/contracts/policy.d.ts +7 -5
  17. package/lib/contracts/policy.js +19 -2
  18. package/lib/contracts/profiles.d.ts +2 -0
  19. package/lib/contracts/published.d.ts +218 -20
  20. package/lib/contracts/result.d.ts +268 -12
  21. package/lib/contracts/result.js +66 -0
  22. package/lib/control/harness.d.ts +52 -7
  23. package/lib/control/recovery.d.ts +1 -1
  24. package/lib/engine/engine.d.ts +117 -12
  25. package/lib/engine/joint-runner.d.ts +96 -6
  26. package/lib/engine/joint-runner.js +13 -0
  27. package/lib/environment/isolation.d.ts +23 -1
  28. package/lib/environment/isolation.js +61 -2
  29. package/lib/environment/os-tools.d.ts +3 -1
  30. package/lib/environment/os-tools.js +3 -1
  31. package/lib/environment/process.d.ts +6 -0
  32. package/lib/environment/process.js +4 -2
  33. package/lib/profiles/resolve.d.ts +2 -0
  34. package/lib/storage/document.d.ts +132 -12
  35. package/lib/verification/dependency-store.d.ts +13 -1
  36. package/lib/verification/dependency-store.js +99 -25
  37. package/lib/verification/file-digests.d.ts +33 -0
  38. package/lib/verification/file-digests.js +121 -0
  39. package/lib/verification/gate-artifacts.d.ts +34 -0
  40. package/lib/verification/gate-artifacts.js +303 -0
  41. package/lib/verification/gates.d.ts +28 -4
  42. package/lib/verification/gates.js +113 -11
  43. package/lib/verification/joint.d.ts +48 -3
  44. package/package.json +1 -1
  45. package/schemas/execution-document.schema.json +372 -0
  46. package/schemas/execution-policy.schema.json +22 -0
  47. package/schemas/joint-verification.schema.json +279 -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.27` — предварительный выпуск (alpha). Договоры
8
+ > Статус: `0.1.0-alpha.29` — предварительный выпуск (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.27 # точная версия
31
+ npm install --save-exact devcontour-harness@0.1.0-alpha.29 # точная версия
32
32
  # или: npm install --save-exact devcontour-harness@alpha # текущая alpha
33
33
  npx harness --version
34
34
  ```
@@ -124,6 +124,18 @@ PASS» нет. Адаптеры хоста реализуют порты `Execut
124
124
  `devcontour-harness/schemas/<имя>.schema.json`. Декларации используют типы
125
125
  Node.js: TypeScript-потребителю нужен `@types/node` (или `skipLibCheck`).
126
126
 
127
+ ## Выпуск 0.1.0-alpha.29
128
+
129
+ Проверки под нагрузкой машины стартуют надёжно, а несостоявшийся старт песочницы
130
+ назван отказом среды; копия хранилища зависимостей готовится примерно в 4 раза быстрее.
131
+ Подробно — [заметки выпуска](docs/release-notes/0.1.0-alpha.29.md).
132
+
133
+ ## Выпуск 0.1.0-alpha.28
134
+
135
+ Файлы, которые gate оставляет в дереве (скриншоты, отчёты), сохраняются как
136
+ доказательства рядом с его логом, с digest и пределами.
137
+ Подробно — [заметки выпуска](docs/release-notes/0.1.0-alpha.28.md).
138
+
127
139
  ## Выпуск 0.1.0-alpha.27
128
140
 
129
141
  Хранилище зависимостей pnpm в политике, команда `worktree-cleanup` для
@@ -673,6 +673,22 @@ executable. Live smoke — отдельный opt-in с явно заданны
673
673
  проверки отличаются от чужих. Текст вывода свидетельством не служит, запись
674
674
  вне дерева — ошибка кода (`gate`). На Linux такого свидетельства нет, и
675
675
  отказ остаётся `gate`.
676
+ - **Запуск песочницы.** Признак старта — токен, который обёртка внутри
677
+ песочницы печатает в stderr перед `exec` команды, и метка-файл рядом.
678
+ Токен ищется и вырезается в сыром stderr до маски секретов: маска по
679
+ значениям окружения (`1`, `8080`) иначе задевала бы его. Метку команда
680
+ может стереть — каталог метки ей открыт на запись, — а напечатанный токен
681
+ нет; подделка токена лишь признаёт старт. Без токена и метки команда точно
682
+ не начиналась: запуск повторяется (до трёх попыток с паузой 0,5 и 1 с).
683
+ Если песочница не запустила её и тогда, а весь stderr состоит только из
684
+ строк известного отказа запуска srt (поиск shell или порождение процесса
685
+ песочницы), gate не проходит с классом `environment`; прочие отказы srt до
686
+ старта могут зависеть от содержимого дерева (на Linux — сборка запретов и
687
+ монтирований по дереву) и остаются `gate`. На Linux эта классификация не
688
+ проверялась. Процесс srt находит shell по PATH сам, только в абсолютных
689
+ каталогах: srt ищет его через `which` с таймаутом в секунду, и под
690
+ нагрузкой машины такой поиск отказывал до запуска команды. Не найденный
691
+ так shell по-прежнему ищет `which`.
676
692
  - **Корень рабочих деревьев.** При состоянии внутри репозитория checkout
677
693
  размещается в кэше пользователя вне дерева; хост может задать
678
694
  `checkoutRoot`. Корень не должен ни лежать внутри репозитория, состояния
@@ -157,6 +157,7 @@ Standalone-хост использует `digestOf` (SHA-256 каноничес
157
157
  | Receipt среды | `environment.json` `version: 1` |
158
158
  | Отчёт свойств, договор проверки, корпус | `version: 1` |
159
159
  | Хранилище зависимостей | Необязательное `repositories[].dependencyStore`: без поля политика, её digest и каталоги прежние. Каталог `dependency-store` закрыт профилю codex для всех установок, как и другие служебные каталоги; seed другого формата не используется ни как попадание, ни как основа сборки: он пересобирается и вытесняется |
160
+ | Artifacts gates | Необязательное `repositories[].gates[].artifacts`: без поля политика и её digest прежние. Поле `artifactFiles` в evidence gate и в записи совместной проверки необязательно: прежние записи читаются как есть |
160
161
  | Владение репозиторием | `<git-common-dir>/devcontour-owner.json` |
161
162
  | Ресурсы | Отдельная база блокировок ресурсов `resources.sqlite`: блокировки устройств и портов, а не состояние исполнения. Таблица `seed_pins` создаётся только при первом обращении хранилища зависимостей |
162
163
  | Снимок коннектора | Поля `proof` и `baseline` manifest необязательны: прежние записи читаются как есть. Без `baseline` в конфигурации ревизия, graph digest и context digest те же, что в прежних версиях |
package/docs/contracts.md CHANGED
@@ -131,6 +131,39 @@ lockfile, установка докачивает разницу; `miss` — о
131
131
  Исключение `materializeStore` бросает только при отмене переданного `signal`. Коды `doctor`:
132
132
  предупреждения `LOCKFILE_MISSING`, `TOOL_MISSING`, `DEPENDENCY_STORE`.
133
133
 
134
+ `repositories[].gates[].artifacts` — необязательный список (1–16) путей
135
+ относительно корня дерева: файлы или каталоги, которые gate оставляет как
136
+ доказательство (например, снимки экрана визуального теста). Без поля поведение
137
+ и digest политики прежние. Повторы и пути внутри уже объявленного каталога
138
+ объединяются. После gate — и при успехе, и при провале — harness копирует
139
+ подходящие файлы в `<артефакты фазы>/<gate>.artifacts/<путь>` (в ID gate точки
140
+ нет, поэтому каталог не совпадает с каталогами других gates и фаз; прежние
141
+ копии этого gate в нём заменяются) и пишет в evidence поле `artifactFiles`:
142
+ `dir`, `files[]` (`path`, `sha256`, `bytes`, `redacted` — в текстовой копии
143
+ замаскирован секрет окружения) и `skipped[]` (`path`, `reason`, `detail`) с
144
+ `skippedMore` для пропусков сверх 100. Копируются только обычные файлы `.png`,
145
+ `.json`, `.txt`, `.xml`, `.log` с одной жёсткой ссылкой: не больше 64 файлов,
146
+ 8 МБ на файл и 20 МБ всего, обход каталогов — до 4096 записей. Ссылки не
147
+ разыменовываются (ни сам путь, ни его компоненты, ни записи каталога); файл,
148
+ который перед чтением разрешается вне дерева, не копируется (`outside`).
149
+ Остаточный риск: между этой проверкой и открытием файла каталог-предок можно
150
+ подменить ссылкой наружу. Сделать это может только процесс, переживший gate;
151
+ потомков gate harness завершает до копирования в обоих режимах изоляции.
152
+ Секрет окружения в текстовой копии маскируется по байтам; файл, в котором
153
+ секрет остался после маски (например, текст в UTF-16), не текстовый файл с
154
+ секретом в байтах и файл с секретом в имени не копируются (`secret`).
155
+ Отменённая проверка не копирует ничего и прежние копии не удаляет. Причины
156
+ пропуска: `missing`, `symlink`, `outside`, `not-regular`, `hardlink`,
157
+ `secret`, `extension`, `file-limit`, `total-limit`, `count-limit`,
158
+ `scan-limit`, `copy-failed` (в том числе отмена проверки). Исход gate от
159
+ копирования не зависит: превышение пределов и отказ записи не делают
160
+ проваленный gate прошедшим и прошедший — проваленным, а названы в evidence.
161
+ Каталог копий, совпадающий с деревом проверки, содержащий его или лежащий
162
+ внутри него, не удаляется: отказ записывается как `copy-failed`.
163
+ `workspaceGates[].artifacts` по-прежнему обязаны существовать и хешируются в
164
+ `artifacts[]`; их копии с теми же правилами пишутся в `artifactFiles` записи
165
+ совместной проверки (`<каталог проверки>/<gate>.artifacts/`).
166
+
134
167
  `policyDigest(policy)` — digest загруженной политики целиком: им сверяются
135
168
  применённая политика (`control.appliedPolicy`) и запрос операции
136
169
  `control.reconfigure`. `executionDigest(policy)` — digest исполнительной
@@ -0,0 +1,37 @@
1
+ # devcontour-harness 0.1.0-alpha.28
2
+
3
+ Файлы, которые gate оставляет в рабочем дереве, — скриншоты визуальной
4
+ проверки, отчёты, JSON наблюдений — теперь сохраняются как доказательства
5
+ вместе с логом gate. Обязательные gates, fencing и привязка доказательств к SHA
6
+ не меняются; исход gate от копирования не зависит.
7
+
8
+ ## Изменения
9
+
10
+ - **`artifacts` у gate поручения.** Необязательный список из 1–16 путей
11
+ репозитория (файлы или каталоги). После gate — пройден он или нет — обычные
12
+ файлы `.png .json .txt .xml .log` копируются в `<каталог фазы>/<gate>.artifacts/`.
13
+ Пределы: 64 файла, 8 МБ на файл, 20 МБ всего, 4096 просмотренных элементов
14
+ каталога.
15
+ - **Запись в evidence.** Новое необязательное поле `artifactFiles`: каталог,
16
+ `files[]` с путём, sha256 и размером копии, `skipped[]` с причиной (`missing`,
17
+ `symlink`, `hardlink`, `outside`, `not-regular`, `extension`, `secret`,
18
+ `file-limit`, `total-limit`, `count-limit`, `scan-limit`, `copy-failed`).
19
+ Ничего не пропадает молча.
20
+ - **Граница доверия.** Символические ссылки не разыменовываются ни на каком
21
+ уровне, жёсткие ссылки и пути вне дерева пропускаются. Секреты окружения в
22
+ текстовых копиях маскируются побайтно; файл, в котором секрет остаётся
23
+ (двоичный, UTF-16), не копируется. Имя файла с секретом — тоже пропуск.
24
+ Каталог копий очищается перед прогоном с защитой от удаления дерева;
25
+ отменённая проверка ничего не копирует и не удаляет.
26
+ - **Совместные проверки.** Gates workspace с объявленными `artifacts` теперь
27
+ сохраняют и сами копии, а не только digest.
28
+ - **Остаточный риск.** Процесс, переживший gate, при `isolation: none` может
29
+ подменить родительский каталог ссылкой между проверкой и открытием файла;
30
+ harness останавливает дочерние процессы gate до копирования.
31
+
32
+ ## Обновление
33
+
34
+ Пакет alpha.27 остаётся неизменным. Перед обновлением остановите writers и
35
+ сохраните копию состояния. Без `artifacts` политика и её digest не меняются.
36
+ Состояние с `artifactFiles` читает только alpha.28 и новее: откат — через копию
37
+ состояния. Подробнее — `docs/upgrade.md`.
@@ -0,0 +1,32 @@
1
+ # devcontour-harness 0.1.0-alpha.29
2
+
3
+ Проверки в песочнице ОС больше не срываются под нагрузкой машины, а копия
4
+ хранилища зависимостей готовится примерно в 4 раза быстрее. Обязательные gates,
5
+ fencing, привязка доказательств к SHA и граница доверия хранилища не меняются.
6
+
7
+ ## Изменения
8
+
9
+ - **Старт песочницы под нагрузкой.** sandbox-runtime искал shell через `which`
10
+ с таймаутом в секунду на каждый запуск; под нагрузкой проверка не стартовала
11
+ с ошибкой «Shell 'bash' not found in PATH», похожей на провал проекта. Теперь
12
+ shell находится без дочернего процесса и только в абсолютных каталогах PATH.
13
+ - **Доказанный старт.** Обёртка печатает в stderr случайный токен перед `exec`;
14
+ он ищется в сыром потоке до маски секретов. Команда, стёршая свою метку
15
+ старта, больше не считается не запущенной и не повторяется.
16
+ - **Отказ среды вместо провала проекта.** Если песочница так и не запустила
17
+ команду, а stderr состоит только из известных строк отказа запуска, gate
18
+ получает класс `environment` с понятным сообщением; probe reviewer —
19
+ `error`/`environment`. Прочие отказы до старта остаются провалом проверки.
20
+ На Linux классификация не проверялась.
21
+ - **Хранилище зависимостей быстрее.** На macOS копия seed делается одним
22
+ `clonefile(2)` каталога (при отказе — прежними порциями `cp -c`), байты и права
23
+ копии сверяются с закреплённым манифестом в пуле потоков. Seed 433 МБ /
24
+ 36 690 файлов: подготовка копии 2,35 с вместо 9,2 с.
25
+ - **Новый отказ.** Файл seed с setuid, setgid или sticky отклоняется (pnpm таких
26
+ не создаёт); удаление копий снимает BSD-флаги вроде `uchg`.
27
+
28
+ ## Обновление
29
+
30
+ Пакет alpha.28 остаётся неизменным. Форматы состояния, политики и манифест seed
31
+ прежние; seeds и копии подходят обеим версиям. Откат возвращает прежний поиск
32
+ shell и прежнюю классификацию отказов запуска (`gate`).
@@ -75,14 +75,14 @@ To run a declared gate, call run_check with exactly {"gate":"domain"}, {"gate":"
75
75
 
76
76
  ## Статусы
77
77
 
78
- | `status` | `failure` | Смысл |
79
- | ------------------------------ | ------------- | --------------------------------------------------------------------------------------------------------------------------------------- |
80
- | `passed` | — | код 0 и (для gate с отчётом) свежий JUnit без failures и skips |
81
- | `failed` | — | код ≠ 0 или упали testcases: наблюдение о коде |
82
- | `failed` | `report` | код 0, но отчёт `missing`/`stale`/`corrupt`/`unsafe`: не прохождение и не находка в коде |
83
- | `error` | `environment` | путь отчёта зашит в argv, отказ записи (EPERM/EACCES) мимо `HARNESS_REPORT_PATH`, отказ scratch, сеть закрыта песочницей, нет песочницы |
84
- | `timeout`, `cancelled` | — | команда остановлена вместе с потомками |
85
- | `budget-exhausted`, `rejected` | — | команда не запускалась |
78
+ | `status` | `failure` | Смысл |
79
+ | ------------------------------ | ------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
80
+ | `passed` | — | код 0 и (для gate с отчётом) свежий JUnit без failures и skips |
81
+ | `failed` | — | код ≠ 0 или упали testcases: наблюдение о коде |
82
+ | `failed` | `report` | код 0, но отчёт `missing`/`stale`/`corrupt`/`unsafe`: не прохождение и не находка в коде |
83
+ | `error` | `environment` | путь отчёта зашит в argv, отказ записи (EPERM/EACCES) мимо `HARNESS_REPORT_PATH`, отказ scratch, сеть закрыта песочницей, нет песочницы, песочница не запустила команду |
84
+ | `timeout`, `cancelled` | — | команда остановлена вместе с потомками |
85
+ | `budget-exhausted`, `rejected` | — | команда не запускалась |
86
86
 
87
87
  Ошибка среды и ошибка отчёта — не находка в коде; находка, сославшаяся на запуск с
88
88
  `failure: environment`, не получает `observed`.
@@ -109,8 +109,11 @@ target ref.
109
109
  ### Граница старта
110
110
 
111
111
  Запуск probe засчитывается по признаку `started` из `runCheck`: без песочницы — процесс порождён
112
- (событие `spawn`), в песочнице — обёртка создала метку старта перед `exec` (запуск самой обёртки
113
- не считается). Признак отмечается на границе и переживает исключение после неё.
112
+ (событие `spawn`), в песочнице — обёртка напечатала токен старта в stderr или создала метку перед
113
+ `exec` (запуск самой обёртки не считается). Признак отмечается на границе и переживает исключение
114
+ после неё. Без токена и метки запуск повторяется (до трёх попыток); песочница, так и не запустившая
115
+ команду, когда весь stderr — только строки известного отказа запуска srt (`Error: Shell '…' not
116
+ found in PATH`, `Failed to execute command: …`), даёт `error`/`environment`.
114
117
 
115
118
  | Событие | В `commands` |
116
119
  | ----------------------------------------------------------------------------------------- | ------------ |
@@ -150,6 +150,10 @@ Isolation `os` пишет только в worktree и временный кат
150
150
  2. Seed клонируется в `<checkout>/.pnpm-store` (копия-при-записи на APFS и reflink-томах, иначе
151
151
  обычная копия, если хватает места), копия сверяется с манифестом, менеджер получает путь через
152
152
  `npm_config_store_dir`. Каталог скрыт от git собственным `.gitignore`.
153
+ На macOS клон делается одним `clonefile(2)` всего каталога (через `/usr/bin/osascript`;
154
+ если вызов не удался — `cp -c` порциями), а сверка читает и хэширует файлы копии в
155
+ нескольких потоках: seed из 37 тысяч файлов и 430 МБ на APFS разворачивается и сверяется
156
+ примерно за 2–3 с, а не за 8–9.
153
157
  3. Gate установки — обычный `pnpm install --frozen-lockfile`. Он берёт пакеты из копии, а чего нет,
154
158
  скачивает через прокси песочницы.
155
159
 
@@ -178,7 +182,14 @@ Isolation `os` пишет только в worktree и временный кат
178
182
  кандидата не исполняют. `doctor` предупреждает о `dependencyStore` рядом с непустым `prepare`.
179
183
  - Seeds лежат под корнем рабочих деревьев или в каталоге состояния, закрытых песочницей на чтение
180
184
  и запись. Манифест закреплён digest в базе ресурсов, вне дерева seed.
181
- - Проверяются байты копии, а не источника: те, что прочитает менеджер.
185
+ - Проверяются байты копии, а не источника: те, что прочитает менеджер. Ускорение этого не
186
+ меняет: каждый файл копии открывается с `O_NOFOLLOW`, а хэш, права и тип берутся с того же
187
+ дескриптора, что и байты; ссылка, каталог или канал на месте файла — отказ. `O_NOFOLLOW`
188
+ защищает только последний компонент пути: каталог по пути к файлу, подменённый ссылкой между
189
+ обходом и чтением, не обнаруживается. Такая подмена требует процесса, который пишет в checkout
190
+ во время развёртывания, то есть до `prepare` и gates этого checkout; это вне модели угроз,
191
+ как и прежде (прежние `lstat` и `readFile` следовали и по последнему компоненту). Setuid, setgid и sticky у файлов seed — отказ, BSD-флаги вроде `uchg`
192
+ копия наследует, как и при `cp -c`, а удаление копии и seed их снимает.
182
193
  - Копия принадлежит своему checkout, в seed ничего не возвращается. Integration и следующая попытка
183
194
  получают новую копию. Поэтому байты seed проверены всегда, а докачанные байты и всё, что
184
195
  исполнитель изменил в своём дереве, доверены не больше, чем его `node_modules`: они не выходят
package/docs/upgrade.md CHANGED
@@ -177,6 +177,49 @@ recovery.
177
177
  [заметки выпуска](release-notes/0.1.0-alpha.27.md) и
178
178
  [хранилище зависимостей](toolchains.md#хранилище-зависимостей).
179
179
 
180
+ ### alpha.28: артефакты gates
181
+
182
+ Форматы состояния и публичные поля API прежние; без
183
+ `repositories[].gates[].artifacts` политика и её digest не меняются. Поле
184
+ необязательно, строгая схема прежних версий его не принимает: при откате
185
+ уберите его из политики. Новое необязательное поле `artifactFiles` в evidence
186
+ gate и в записи совместной проверки прежние версии не знают: состояние с ним
187
+ читает только эта версия и новее, откат — через копию состояния. Копии
188
+ лежат в каталоге артефактов фазы (`<gate>.artifacts/`) и при откате не нужны.
189
+ Подробнее — [заметки выпуска](release-notes/0.1.0-alpha.28.md) и
190
+ [договоры](contracts.md#executionpolicy).
191
+
192
+ ### alpha.29: запуск песочницы проверок
193
+
194
+ Форматы состояния, политики и публичные поля API прежние. sandbox-runtime
195
+ искал shell через `which` с таймаутом в секунду на каждый запуск проверки; под
196
+ нагрузкой машины поиск не успевал, и проверка не стартовала с ошибкой
197
+ «Shell 'bash' not found in PATH». Теперь процесс srt находит shell по PATH сам,
198
+ без порождения `which`, и только в абсолютных каталогах PATH; не найденный
199
+ shell по-прежнему ищет `which`. Старт команды доказывает токен, который обёртка
200
+ печатает в stderr перед `exec`; он ищется и вырезается в сыром потоке до маски
201
+ секретов: стёртая командой
202
+ метка-файл больше не выдаёт стартовавшую команду за не запущенную, и такая
203
+ команда не повторяется. Если песочница не запустила команду и после повторов
204
+ (до трёх попыток, только пока нет ни метки, ни токена), а весь stderr — только
205
+ строки известного отказа запуска srt (`Error: Shell '…' not found in PATH`,
206
+ `Failed to execute command: …`), gate не
207
+ проходит с классом `environment` и сообщением «песочница ОС не запустила
208
+ команду проверки», а не как провал проекта с кодом выхода; probe reviewer в
209
+ этом случае — `error`/`environment`. Прочие отказы srt до старта остаются
210
+ провалом проверки (`gate`). При откате возвращается прежний поиск shell и
211
+ прежняя классификация (`gate`).
212
+
213
+ ### alpha.29: быстрее копия хранилища зависимостей
214
+
215
+ Форматы состояния, манифест seed, политика и граница доверия прежние: сверяются
216
+ те же байты и права копии по тому же закреплённому манифесту. На macOS копия
217
+ делается одним `clonefile(2)` каталога через `/usr/bin/osascript`, при его отказе —
218
+ прежними порциями `cp -c`; сверка идёт в потоках. Новое: файл seed с setuid,
219
+ setgid или sticky — отказ (pnpm таких не создаёт). Откат — установка прежней
220
+ версии, seeds и копии подходят обеим. Подробнее —
221
+ [хранилище зависимостей](toolchains.md#хранилище-зависимостей).
222
+
180
223
  ## Перед обновлением
181
224
 
182
225
  1. **Остановить записывающих.** Запретить новые выдачи (`harness pause`),
@@ -408,6 +408,16 @@ export class ReviewProbes {
408
408
  ...(gate ? { failure: 'environment' } : {}),
409
409
  }
410
410
  : {};
411
+ // Песочница так и не запустила команду: исполнять было нечего.
412
+ if (r.launchFailed && !r.timedOut && !signal.aborted)
413
+ return {
414
+ status: 'error',
415
+ failure: 'environment',
416
+ exitCode: r.code,
417
+ stdout: tail(r.stdout),
418
+ stderr: tail(r.stderr),
419
+ note: `Песочница ОС не запустила команду (попыток: ${r.attempts}): команда не исполнялась. Это ошибка среды, а не находка в коде.`,
420
+ };
411
421
  return {
412
422
  ...hint,
413
423
  status: signal.aborted
@@ -569,6 +579,14 @@ export class ReviewProbes {
569
579
  status: 'timeout',
570
580
  note: `Gate не завершился за ${limitMs} мс и остановлен вместе с потомками; это наблюдение, а не доказанный дефект. ${observation}`,
571
581
  };
582
+ else if (r.launchFailed)
583
+ outcome = {
584
+ ...base,
585
+ ...streams,
586
+ status: 'error',
587
+ failure: 'environment',
588
+ note: `Песочница ОС не запустила gate (попыток: ${r.attempts}): команда не исполнялась. Это ошибка среды, а не находка в коде.`,
589
+ };
572
590
  else if (blocked.length)
573
591
  outcome = {
574
592
  ...base,
@@ -498,8 +498,8 @@ export declare const statusDataSchema: z.ZodObject<{
498
498
  gate: "gate";
499
499
  unknown: "unknown";
500
500
  review: "review";
501
- environment: "environment";
502
501
  cancelled: "cancelled";
502
+ environment: "environment";
503
503
  timeout: "timeout";
504
504
  "provider-auth": "provider-auth";
505
505
  "stale-base": "stale-base";
@@ -749,8 +749,8 @@ export declare const eventsDataSchema: z.ZodObject<{
749
749
  gate: "gate";
750
750
  unknown: "unknown";
751
751
  review: "review";
752
- environment: "environment";
753
752
  cancelled: "cancelled";
753
+ environment: "environment";
754
754
  timeout: "timeout";
755
755
  "provider-auth": "provider-auth";
756
756
  "stale-base": "stale-base";
@@ -790,8 +790,8 @@ export declare const eventsDataSchema: z.ZodObject<{
790
790
  gate: "gate";
791
791
  unknown: "unknown";
792
792
  review: "review";
793
- environment: "environment";
794
793
  cancelled: "cancelled";
794
+ environment: "environment";
795
795
  timeout: "timeout";
796
796
  "provider-auth": "provider-auth";
797
797
  "stale-base": "stale-base";
@@ -1011,8 +1011,8 @@ export declare const eventsDataSchema: z.ZodObject<{
1011
1011
  gate: "gate";
1012
1012
  unknown: "unknown";
1013
1013
  review: "review";
1014
- environment: "environment";
1015
1014
  cancelled: "cancelled";
1015
+ environment: "environment";
1016
1016
  timeout: "timeout";
1017
1017
  "provider-auth": "provider-auth";
1018
1018
  "stale-base": "stale-base";
@@ -1052,8 +1052,8 @@ export declare const eventsDataSchema: z.ZodObject<{
1052
1052
  gate: "gate";
1053
1053
  unknown: "unknown";
1054
1054
  review: "review";
1055
- environment: "environment";
1056
1055
  cancelled: "cancelled";
1056
+ environment: "environment";
1057
1057
  timeout: "timeout";
1058
1058
  "provider-auth": "provider-auth";
1059
1059
  "stale-base": "stale-base";
@@ -1277,8 +1277,8 @@ export declare const controlDataSchema: z.ZodObject<{
1277
1277
  gate: "gate";
1278
1278
  unknown: "unknown";
1279
1279
  review: "review";
1280
- environment: "environment";
1281
1280
  cancelled: "cancelled";
1281
+ environment: "environment";
1282
1282
  timeout: "timeout";
1283
1283
  "provider-auth": "provider-auth";
1284
1284
  "stale-base": "stale-base";
@@ -1469,6 +1469,7 @@ export declare const profileDataSchema: z.ZodObject<{
1469
1469
  type: z.ZodLiteral<"junit">;
1470
1470
  path: z.ZodString;
1471
1471
  }, z.core.$strict>;
1472
+ artifacts: z.ZodOptional<z.ZodArray<z.ZodString>>;
1472
1473
  id: z.ZodString;
1473
1474
  command: z.ZodArray<z.ZodString>;
1474
1475
  timeoutMs: z.ZodDefault<z.ZodNumber>;
@@ -1484,6 +1485,7 @@ export declare const profileDataSchema: z.ZodObject<{
1484
1485
  type: z.ZodLiteral<"junit">;
1485
1486
  path: z.ZodString;
1486
1487
  }, z.core.$strict>>;
1488
+ artifacts: z.ZodOptional<z.ZodArray<z.ZodString>>;
1487
1489
  id: z.ZodString;
1488
1490
  command: z.ZodArray<z.ZodString>;
1489
1491
  timeoutMs: z.ZodDefault<z.ZodNumber>;
@@ -1814,6 +1816,7 @@ export declare const worktreeCleanupDataSchema: z.ZodObject<{
1814
1816
  remove: "remove";
1815
1817
  }>;
1816
1818
  reason: z.ZodOptional<z.ZodEnum<{
1819
+ "scan-limit": "scan-limit";
1817
1820
  active: "active";
1818
1821
  recoverable: "recoverable";
1819
1822
  "cleanup-pending": "cleanup-pending";
@@ -1821,7 +1824,6 @@ export declare const worktreeCleanupDataSchema: z.ZodObject<{
1821
1824
  "unknown-attempt": "unknown-attempt";
1822
1825
  untrusted: "untrusted";
1823
1826
  "embedded-repository": "embedded-repository";
1824
- "scan-limit": "scan-limit";
1825
1827
  "scan-failed": "scan-failed";
1826
1828
  "read-only-path": "read-only-path";
1827
1829
  "undecodable-path": "undecodable-path";
@@ -2010,8 +2012,8 @@ export declare const explainDataSchema: z.ZodObject<{
2010
2012
  gate: "gate";
2011
2013
  unknown: "unknown";
2012
2014
  review: "review";
2013
- environment: "environment";
2014
2015
  cancelled: "cancelled";
2016
+ environment: "environment";
2015
2017
  timeout: "timeout";
2016
2018
  "provider-auth": "provider-auth";
2017
2019
  "stale-base": "stale-base";
@@ -2289,8 +2291,8 @@ export declare const cliDataSchemas: {
2289
2291
  gate: "gate";
2290
2292
  unknown: "unknown";
2291
2293
  review: "review";
2292
- environment: "environment";
2293
2294
  cancelled: "cancelled";
2295
+ environment: "environment";
2294
2296
  timeout: "timeout";
2295
2297
  "provider-auth": "provider-auth";
2296
2298
  "stale-base": "stale-base";
@@ -2540,8 +2542,8 @@ export declare const cliDataSchemas: {
2540
2542
  gate: "gate";
2541
2543
  unknown: "unknown";
2542
2544
  review: "review";
2543
- environment: "environment";
2544
2545
  cancelled: "cancelled";
2546
+ environment: "environment";
2545
2547
  timeout: "timeout";
2546
2548
  "provider-auth": "provider-auth";
2547
2549
  "stale-base": "stale-base";
@@ -2581,8 +2583,8 @@ export declare const cliDataSchemas: {
2581
2583
  gate: "gate";
2582
2584
  unknown: "unknown";
2583
2585
  review: "review";
2584
- environment: "environment";
2585
2586
  cancelled: "cancelled";
2587
+ environment: "environment";
2586
2588
  timeout: "timeout";
2587
2589
  "provider-auth": "provider-auth";
2588
2590
  "stale-base": "stale-base";
@@ -2802,8 +2804,8 @@ export declare const cliDataSchemas: {
2802
2804
  gate: "gate";
2803
2805
  unknown: "unknown";
2804
2806
  review: "review";
2805
- environment: "environment";
2806
2807
  cancelled: "cancelled";
2808
+ environment: "environment";
2807
2809
  timeout: "timeout";
2808
2810
  "provider-auth": "provider-auth";
2809
2811
  "stale-base": "stale-base";
@@ -2843,8 +2845,8 @@ export declare const cliDataSchemas: {
2843
2845
  gate: "gate";
2844
2846
  unknown: "unknown";
2845
2847
  review: "review";
2846
- environment: "environment";
2847
2848
  cancelled: "cancelled";
2849
+ environment: "environment";
2848
2850
  timeout: "timeout";
2849
2851
  "provider-auth": "provider-auth";
2850
2852
  "stale-base": "stale-base";
@@ -2980,8 +2982,8 @@ export declare const cliDataSchemas: {
2980
2982
  gate: "gate";
2981
2983
  unknown: "unknown";
2982
2984
  review: "review";
2983
- environment: "environment";
2984
2985
  cancelled: "cancelled";
2986
+ environment: "environment";
2985
2987
  timeout: "timeout";
2986
2988
  "provider-auth": "provider-auth";
2987
2989
  "stale-base": "stale-base";
@@ -3035,8 +3037,8 @@ export declare const cliDataSchemas: {
3035
3037
  gate: "gate";
3036
3038
  unknown: "unknown";
3037
3039
  review: "review";
3038
- environment: "environment";
3039
3040
  cancelled: "cancelled";
3041
+ environment: "environment";
3040
3042
  timeout: "timeout";
3041
3043
  "provider-auth": "provider-auth";
3042
3044
  "stale-base": "stale-base";
@@ -3195,8 +3197,8 @@ export declare const cliDataSchemas: {
3195
3197
  kind: z.ZodEnum<{
3196
3198
  check: "check";
3197
3199
  test: "test";
3198
- property: "property";
3199
3200
  review: "review";
3201
+ property: "property";
3200
3202
  consumer: "consumer";
3201
3203
  }>;
3202
3204
  phase: z.ZodEnum<{
@@ -3417,8 +3419,8 @@ export declare const cliDataSchemas: {
3417
3419
  kind: z.ZodEnum<{
3418
3420
  check: "check";
3419
3421
  test: "test";
3420
- property: "property";
3421
3422
  review: "review";
3423
+ property: "property";
3422
3424
  consumer: "consumer";
3423
3425
  }>;
3424
3426
  phase: z.ZodEnum<{
@@ -3617,8 +3619,8 @@ export declare const cliDataSchemas: {
3617
3619
  kind: z.ZodEnum<{
3618
3620
  check: "check";
3619
3621
  test: "test";
3620
- property: "property";
3621
3622
  review: "review";
3623
+ property: "property";
3622
3624
  consumer: "consumer";
3623
3625
  }>;
3624
3626
  phase: z.ZodEnum<{
@@ -3839,8 +3841,8 @@ export declare const cliDataSchemas: {
3839
3841
  kind: z.ZodEnum<{
3840
3842
  check: "check";
3841
3843
  test: "test";
3842
- property: "property";
3843
3844
  review: "review";
3845
+ property: "property";
3844
3846
  consumer: "consumer";
3845
3847
  }>;
3846
3848
  phase: z.ZodEnum<{
@@ -3974,6 +3976,7 @@ export declare const cliDataSchemas: {
3974
3976
  remove: "remove";
3975
3977
  }>;
3976
3978
  reason: z.ZodOptional<z.ZodEnum<{
3979
+ "scan-limit": "scan-limit";
3977
3980
  active: "active";
3978
3981
  recoverable: "recoverable";
3979
3982
  "cleanup-pending": "cleanup-pending";
@@ -3981,7 +3984,6 @@ export declare const cliDataSchemas: {
3981
3984
  "unknown-attempt": "unknown-attempt";
3982
3985
  untrusted: "untrusted";
3983
3986
  "embedded-repository": "embedded-repository";
3984
- "scan-limit": "scan-limit";
3985
3987
  "scan-failed": "scan-failed";
3986
3988
  "read-only-path": "read-only-path";
3987
3989
  "undecodable-path": "undecodable-path";
@@ -4033,6 +4035,7 @@ export declare const cliDataSchemas: {
4033
4035
  type: z.ZodLiteral<"junit">;
4034
4036
  path: z.ZodString;
4035
4037
  }, z.core.$strict>;
4038
+ artifacts: z.ZodOptional<z.ZodArray<z.ZodString>>;
4036
4039
  id: z.ZodString;
4037
4040
  command: z.ZodArray<z.ZodString>;
4038
4041
  timeoutMs: z.ZodDefault<z.ZodNumber>;
@@ -4048,6 +4051,7 @@ export declare const cliDataSchemas: {
4048
4051
  type: z.ZodLiteral<"junit">;
4049
4052
  path: z.ZodString;
4050
4053
  }, z.core.$strict>>;
4054
+ artifacts: z.ZodOptional<z.ZodArray<z.ZodString>>;
4051
4055
  id: z.ZodString;
4052
4056
  command: z.ZodArray<z.ZodString>;
4053
4057
  timeoutMs: z.ZodDefault<z.ZodNumber>;
@@ -4411,8 +4415,8 @@ export declare const cliDataSchemas: {
4411
4415
  gate: "gate";
4412
4416
  unknown: "unknown";
4413
4417
  review: "review";
4414
- environment: "environment";
4415
4418
  cancelled: "cancelled";
4419
+ environment: "environment";
4416
4420
  timeout: "timeout";
4417
4421
  "provider-auth": "provider-auth";
4418
4422
  "stale-base": "stale-base";
@@ -46,8 +46,8 @@ export declare const stopDiagnosisSchema: z.ZodObject<{
46
46
  gate: "gate";
47
47
  unknown: "unknown";
48
48
  review: "review";
49
- environment: "environment";
50
49
  cancelled: "cancelled";
50
+ environment: "environment";
51
51
  timeout: "timeout";
52
52
  "provider-auth": "provider-auth";
53
53
  "stale-base": "stale-base";