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.
- package/README.md +14 -2
- package/docs/architecture.md +16 -0
- package/docs/compatibility.md +1 -0
- package/docs/contracts.md +33 -0
- package/docs/release-notes/0.1.0-alpha.28.md +37 -0
- package/docs/release-notes/0.1.0-alpha.29.md +32 -0
- package/docs/review-probes.md +13 -10
- package/docs/toolchains.md +12 -1
- package/docs/upgrade.md +43 -0
- package/lib/agents/review-probe.js +18 -0
- package/lib/contracts/cli.d.ts +25 -21
- package/lib/contracts/diagnosis.d.ts +1 -1
- package/lib/contracts/events.d.ts +6 -6
- package/lib/contracts/execution.d.ts +268 -16
- package/lib/contracts/execution.js +3 -1
- package/lib/contracts/policy.d.ts +7 -5
- package/lib/contracts/policy.js +19 -2
- package/lib/contracts/profiles.d.ts +2 -0
- package/lib/contracts/published.d.ts +218 -20
- package/lib/contracts/result.d.ts +268 -12
- package/lib/contracts/result.js +66 -0
- package/lib/control/harness.d.ts +52 -7
- package/lib/control/recovery.d.ts +1 -1
- package/lib/engine/engine.d.ts +117 -12
- package/lib/engine/joint-runner.d.ts +96 -6
- package/lib/engine/joint-runner.js +13 -0
- package/lib/environment/isolation.d.ts +23 -1
- package/lib/environment/isolation.js +61 -2
- package/lib/environment/os-tools.d.ts +3 -1
- package/lib/environment/os-tools.js +3 -1
- package/lib/environment/process.d.ts +6 -0
- package/lib/environment/process.js +4 -2
- package/lib/profiles/resolve.d.ts +2 -0
- package/lib/storage/document.d.ts +132 -12
- package/lib/verification/dependency-store.d.ts +13 -1
- package/lib/verification/dependency-store.js +99 -25
- package/lib/verification/file-digests.d.ts +33 -0
- package/lib/verification/file-digests.js +121 -0
- package/lib/verification/gate-artifacts.d.ts +34 -0
- package/lib/verification/gate-artifacts.js +303 -0
- package/lib/verification/gates.d.ts +28 -4
- package/lib/verification/gates.js +113 -11
- package/lib/verification/joint.d.ts +48 -3
- package/package.json +1 -1
- package/schemas/execution-document.schema.json +372 -0
- package/schemas/execution-policy.schema.json +22 -0
- 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.
|
|
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.
|
|
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` для
|
package/docs/architecture.md
CHANGED
|
@@ -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`. Корень не должен ни лежать внутри репозитория, состояния
|
package/docs/compatibility.md
CHANGED
|
@@ -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`).
|
package/docs/review-probes.md
CHANGED
|
@@ -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`), в песочнице — обёртка
|
|
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
|
| ----------------------------------------------------------------------------------------- | ------------ |
|
package/docs/toolchains.md
CHANGED
|
@@ -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,
|
package/lib/contracts/cli.d.ts
CHANGED
|
@@ -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";
|