devcontour-harness 0.1.0-alpha.26 → 0.1.0-alpha.28
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 +15 -2
- package/docs/architecture.md +59 -0
- package/docs/compatibility.md +25 -12
- package/docs/connectors.md +5 -2
- package/docs/contracts.md +80 -25
- package/docs/release-notes/0.1.0-alpha.27.md +36 -0
- package/docs/release-notes/0.1.0-alpha.28.md +37 -0
- package/docs/review-protocol.md +10 -4
- package/docs/toolchains.md +83 -0
- package/docs/upgrade.md +22 -0
- package/lib/cli.js +13 -0
- package/lib/contracts/cli.d.ts +147 -19
- package/lib/contracts/cli.js +66 -0
- 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 +37 -5
- package/lib/contracts/policy.js +42 -2
- package/lib/contracts/profiles.d.ts +2 -0
- package/lib/contracts/published.d.ts +226 -20
- package/lib/contracts/result.d.ts +268 -12
- package/lib/contracts/result.js +66 -0
- package/lib/control/harness.d.ts +64 -7
- package/lib/control/harness.js +4 -0
- package/lib/control/recovery.d.ts +1 -1
- package/lib/control/review.js +6 -1
- package/lib/engine/engine.d.ts +117 -12
- package/lib/engine/joint-runner.d.ts +96 -6
- package/lib/engine/joint-runner.js +47 -1
- package/lib/engine/runner.d.ts +29 -0
- package/lib/engine/runner.js +200 -2
- package/lib/engine/worktree-cleanup.d.ts +131 -0
- package/lib/engine/worktree-cleanup.js +520 -0
- package/lib/environment/isolation.d.ts +1 -0
- package/lib/environment/isolation.js +2 -1
- package/lib/environment/os-tools.d.ts +4 -2
- package/lib/environment/os-tools.js +4 -2
- package/lib/environment/process.d.ts +5 -0
- package/lib/environment/process.js +40 -17
- package/lib/environment/resources.d.ts +9 -0
- package/lib/environment/resources.js +24 -0
- package/lib/index.d.ts +1 -0
- package/lib/index.js +1 -0
- package/lib/integrations/connector/commands.d.ts +2 -1
- package/lib/integrations/connector/commands.js +10 -2
- package/lib/integrations/connector/store.d.ts +1 -1
- package/lib/integrations/connector/store.js +11 -6
- package/lib/profiles/resolve.d.ts +8 -0
- package/lib/storage/document.d.ts +132 -12
- package/lib/toolchains/inspect.d.ts +1 -1
- package/lib/toolchains/inspect.js +29 -1
- package/lib/toolchains/probe.d.ts +16 -0
- package/lib/toolchains/probe.js +20 -0
- package/lib/verification/confirm.d.ts +3 -1
- package/lib/verification/confirm.js +16 -2
- package/lib/verification/dependencies.d.ts +3 -0
- package/lib/verification/dependencies.js +11 -0
- package/lib/verification/dependency-store.d.ts +117 -0
- package/lib/verification/dependency-store.js +811 -0
- package/lib/verification/gate-artifacts.d.ts +34 -0
- package/lib/verification/gate-artifacts.js +303 -0
- package/lib/verification/gates-at.js +18 -0
- package/lib/verification/gates.js +15 -0
- 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 +56 -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.28` — предварительный выпуск (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.28 # точная версия
|
|
32
32
|
# или: npm install --save-exact devcontour-harness@alpha # текущая alpha
|
|
33
33
|
npx harness --version
|
|
34
34
|
```
|
|
@@ -99,6 +99,7 @@ git rev-parse refs/heads/harness/accepted # совпадает с data.result.
|
|
|
99
99
|
| `status / events / result --state D` | Чтение без побочных эффектов |
|
|
100
100
|
| `pause / resume / cancel / retry --state D` | Управление очередью и поручением |
|
|
101
101
|
| `deliver --state D --work ID --sink file:D` | Повтор доставки без моделей и интеграции |
|
|
102
|
+
| `worktree-cleanup --state D [--dry-run]` | Уборка деревьев завершённых попыток |
|
|
102
103
|
| `profile --profile ID [--repository D]` | Разрешение профиля стека без команд проекта |
|
|
103
104
|
| `doctor` | Версии, runtime, sandbox, совместимость состояния |
|
|
104
105
|
|
|
@@ -123,6 +124,18 @@ PASS» нет. Адаптеры хоста реализуют порты `Execut
|
|
|
123
124
|
`devcontour-harness/schemas/<имя>.schema.json`. Декларации используют типы
|
|
124
125
|
Node.js: TypeScript-потребителю нужен `@types/node` (или `skipLibCheck`).
|
|
125
126
|
|
|
127
|
+
## Выпуск 0.1.0-alpha.28
|
|
128
|
+
|
|
129
|
+
Файлы, которые gate оставляет в дереве (скриншоты, отчёты), сохраняются как
|
|
130
|
+
доказательства рядом с его логом, с digest и пределами.
|
|
131
|
+
Подробно — [заметки выпуска](docs/release-notes/0.1.0-alpha.28.md).
|
|
132
|
+
|
|
133
|
+
## Выпуск 0.1.0-alpha.27
|
|
134
|
+
|
|
135
|
+
Хранилище зависимостей pnpm в политике, команда `worktree-cleanup` для
|
|
136
|
+
деревьев завершённых попыток и более дешёвый поиск оставшихся процессов.
|
|
137
|
+
Подробно — [заметки выпуска](docs/release-notes/0.1.0-alpha.27.md).
|
|
138
|
+
|
|
126
139
|
## Выпуск 0.1.0-alpha.26
|
|
127
140
|
|
|
128
141
|
Базовая линия коннектора для зависимостей, закрытых до подключения harness;
|
package/docs/architecture.md
CHANGED
|
@@ -195,6 +195,61 @@ runtime-граф пакета.
|
|
|
195
195
|
записываются туда же. `Harness.cleanup(runId)` повторяет teardown по
|
|
196
196
|
сохранённым `environment.json` и затем убирает деревья, повторный вызов —
|
|
197
197
|
`nothing-pending`.
|
|
198
|
+
- **Деревья закончившихся попыток.** Попытка убирает свои деревья сама; после
|
|
199
|
+
падения процесса или отказа удаления они остаются. `harness worktree-cleanup
|
|
200
|
+
--state <каталог> [--dry-run]` (`Harness.cleanupWorktrees`) убирает их, и
|
|
201
|
+
правило у него одно: в сомнении дерево остаётся, а отказ назван.
|
|
202
|
+
- Остаются ветки попыток, коммиты, достижимые из ref общего репозитория, и
|
|
203
|
+
артефакты. Вершина, которую держат только `refs/worktree`, `refs/bisect` или
|
|
204
|
+
`refs/rewritten`, не считается достижимой: они исчезают вместе с деревом, и
|
|
205
|
+
её коммиты собрал бы gc. Такая вершина — отказ.
|
|
206
|
+
- Неподтверждённые правки сначала сохраняются патчем
|
|
207
|
+
`uncommitted-<дерево>[-N].patch` в артефактах попытки. Уже лежащий патч не
|
|
208
|
+
перезаписывается. Патч применяется `git apply --index` поверх вершины; до
|
|
209
|
+
удаления проверено, что он даёт то же дерево.
|
|
210
|
+
- Игнорируемые файлы (`.env`, зависимости, сборка) патч **не сохраняет**: они
|
|
211
|
+
исчезают вместе с деревом, а их число и верхние пути перечислены в поле
|
|
212
|
+
`ignored` ответа, в том числе при `--dry-run`. Dry run не пишет ни состояние,
|
|
213
|
+
ни артефакты, ни индекс дерева.
|
|
214
|
+
- Отказывают поимённо (`reason`): идущая попытка (`active`), последняя попытка
|
|
215
|
+
незакрытой работы (`recoverable`), незавершённая очистка (`cleanup-pending`,
|
|
216
|
+
сначала `cleanup --run`), нечитаемая запись очистки
|
|
217
|
+
(`cleanup-unreadable`), дерево без попытки (`unknown-attempt`), подменённый
|
|
218
|
+
`.git` (`untrusted`), вложенный репозиторий где угодно в дереве, включая
|
|
219
|
+
игнорируемое и `node_modules`, и gitlink индекса (`embedded-repository`),
|
|
220
|
+
недостижимая вершина (`unreachable-head`), отличие действующего `.gitignore`
|
|
221
|
+
от вершины или правило `info/exclude`, скрывающее путь в дереве
|
|
222
|
+
(`ignore-rules-changed`), признаки
|
|
223
|
+
assume-unchanged и skip-worktree (`hidden-changes`), игнорируемый файл, добавленный в индекс через `git add -f`
|
|
224
|
+
и отсутствующий в вершине (`staged-ignored`), проиндексированная версия,
|
|
225
|
+
отличная и от вершины, и от файла дерева (`staged-differs`; индекс, равный
|
|
226
|
+
файлу, правки не теряет), настроенный clean-фильтр
|
|
227
|
+
на пути дерева (`clean-filter`), дерево под `git worktree lock`
|
|
228
|
+
(`worktree-locked`), имя пути не в UTF-8 (`undecodable-path`), каталог только
|
|
229
|
+
для чтения (`read-only-path`), обход дерева, упёршийся в предел или в отказ
|
|
230
|
+
чтения (`scan-limit`, `scan-failed`), патч, не прошедший проверку
|
|
231
|
+
(`patch-unusable`).
|
|
232
|
+
- Правила `core.excludesFile` только показываются в `ignored` и не отказывают:
|
|
233
|
+
они не принадлежат попытке, и обычно это глобальные настройки человека.
|
|
234
|
+
- Перед самым удалением вершина, статус и дерево правок сверяются с тем, на чём
|
|
235
|
+
основано решение, и отличие даёт `tree-changed`; патч строится от той же
|
|
236
|
+
закреплённой вершины, что и в записи. Узкое окно остаётся: запись после сверки
|
|
237
|
+
(или во время удаления) не будет замечена, поэтому команду запускают, когда в
|
|
238
|
+
деревьях никто не работает.
|
|
239
|
+
- Отказ git посреди удаления — `failed` с `removalStarted`: `registered` и
|
|
240
|
+
`treePresent` говорят, что осталось, а часть файлов могла уже исчезнуть. Запись
|
|
241
|
+
`worktree-cleanup-<дерево>.json` в артефактах хранит указатель на патч и
|
|
242
|
+
пишется до удаления: сигнала «git начал удалять» нет. Следующий запуск называет
|
|
243
|
+
такое дерево `removal-incomplete` с тем же `patch` и `record` и не трогает его.
|
|
244
|
+
Выйти из этого состояния: разобрать остаток дерева вручную, при необходимости
|
|
245
|
+
убрать его (`git worktree prune` снимет регистрацию) и удалить файл `record`;
|
|
246
|
+
дерево в порядке — после удаления `record` следующий запуск проверит его
|
|
247
|
+
заново. Дерево на диске без регистрации и без записи — `not-registered`.
|
|
248
|
+
- Одновременно идёт один запуск на каталог состояния: второй получает
|
|
249
|
+
`NOT_READY`. Замок умершего процесса снимается сам; пустой замок и замок с
|
|
250
|
+
живым PID остаются, а ошибка называет файл, который надо удалить, когда
|
|
251
|
+
запуска нет. Замок сверяет PID, поэтому каталог состояния должен принадлежать
|
|
252
|
+
одному пространству PID.
|
|
198
253
|
- **Покрытие gates.** `uncoveredGates` засчитывает только evidence попыток под
|
|
199
254
|
текущим основанием политики: тот же ID gate с другой командой — другая
|
|
200
255
|
проверка.
|
|
@@ -630,6 +685,10 @@ executable. Live smoke — отдельный opt-in с явно заданны
|
|
|
630
685
|
Закрытие соседних деревьев запрещает чтение их содержимого. Оно не скрывает
|
|
631
686
|
само существование пути: на macOS разные ответы ENOENT/EPERM могут раскрыть
|
|
632
687
|
этот факт. Это ограничение песочницы, а не гарантия конфиденциальности имён.
|
|
688
|
+
- **Хранилище зависимостей.** Необязательно (`repositories[].dependencyStore`). Seed собирается
|
|
689
|
+
только из lockfile целевой ветки, в песочнице проверок и в каталоге без файлов проекта; лежит в
|
|
690
|
+
закрытом месте, закреплён вне своего дерева и в checkout попадает клоном со сверкой байтов копии.
|
|
691
|
+
Обратного пути из checkout нет. Подробно — в [toolchains](toolchains.md#хранилище-зависимостей).
|
|
633
692
|
- **Git хоста над деревом проверки.** Каждый вызов git хоста сначала сверяет,
|
|
634
693
|
куда git придёт: файл `.git` дерева, созданного `worktree add`, не изменён;
|
|
635
694
|
gitdir и общий каталог лежат вне дерева и согласованы; `commondir`/`gitdir`
|
package/docs/compatibility.md
CHANGED
|
@@ -148,18 +148,20 @@ 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
|
-
|
|
|
160
|
-
|
|
|
161
|
-
|
|
|
162
|
-
|
|
|
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` |
|
|
163
165
|
|
|
164
166
|
## Переменные окружения gates
|
|
165
167
|
|
|
@@ -175,6 +177,17 @@ Gates, шаги подготовки и проверки потребителе
|
|
|
175
177
|
`HARNESS_*` с теми же значениями. Оба пространства резервирует controller:
|
|
176
178
|
политика не может задать переменные с этими префиксами.
|
|
177
179
|
|
|
180
|
+
Если у репозитория объявлено `dependencyStore`, переменную `npm_config_store_dir` с путём к хранилищу
|
|
181
|
+
этого checkout получают шаги `prepare`, `dependencyBuild` снимка, gates фазы, gates совместной
|
|
182
|
+
проверки и `teardown`; она заменяет значение из `environment` политики. Не получают её шаги `setup` и
|
|
183
|
+
`ready` (идут раньше), исполнитель и проверки ревьюера: их окружение строится отдельно. Переменная
|
|
184
|
+
задаётся и при промахе, когда `.pnpm-store` создан в дереве. Она не задаётся при `isolation.mode: none`,
|
|
185
|
+
занятом пути `.pnpm-store`, менеджере, который не найден, с неопределённой версией или версией вне
|
|
186
|
+
проверенного диапазона, нечитаемом `package.json`, при превышении любого предела (`maxBytes`, файлов
|
|
187
|
+
seed, элементов checkout, размера lockfile) и при отказе записи в дерево: там окружение и дерево как
|
|
188
|
+
без хранилища. Исключение: если новый lockfile упёрся в предел, а прежний seed подходит, он
|
|
189
|
+
используется как частичное попадание, и переменная задаётся.
|
|
190
|
+
|
|
178
191
|
## Что меняется намеренно
|
|
179
192
|
|
|
180
193
|
| Изменение | Следствие |
|
package/docs/connectors.md
CHANGED
|
@@ -182,8 +182,11 @@ reviewer, `references/` закрепляется digest без вложения.
|
|
|
182
182
|
Движок, как и для любой предпосылки, проверяет доступность SHA в target ref.
|
|
183
183
|
- Любая правка `baseline` меняет ревизию набора задач, даже если запись не
|
|
184
184
|
использована: `run --source` по прежнему снимку отказывает `APPROVAL_STALE`,
|
|
185
|
-
нужны новые `source-snapshot`, ревью плана и согласование.
|
|
186
|
-
|
|
185
|
+
нужны новые `source-snapshot`, ревью плана и согласование. Возврат к прежней
|
|
186
|
+
редакции (постановки или `baseline`) тоже снимается `source-snapshot`: запись
|
|
187
|
+
снимка остаётся прежней (`created: false`), но снова становится последней.
|
|
188
|
+
Semantic digest задачи не меняется: доставка принятого результата конфликтом
|
|
189
|
+
не становится.
|
|
187
190
|
- Происхождение видно: `proof: 'baseline'` у зависимости и `baseline` в
|
|
188
191
|
manifest, в ответах `source-snapshot`, `run --source` и `source-status`,
|
|
189
192
|
строка «Зависимости без доказательства» в итоге для задачи. Предпосылка
|
package/docs/contracts.md
CHANGED
|
@@ -112,6 +112,58 @@ manifest снимка и в необязательном поле `baseline` о
|
|
|
112
112
|
|
|
113
113
|
Переменные `HARNESS_*` и `DEVCONTOUR_*` политика задать не может.
|
|
114
114
|
|
|
115
|
+
`repositories[].dependencyStore` — необязательное хранилище зависимостей
|
|
116
|
+
репозитория: `{manager: 'pnpm', lockfile, maxBytes, timeoutMs}`. Умолчания:
|
|
117
|
+
`pnpm-lock.yaml`, 8 ГиБ, 600 000 мс. Без поля поведение и digest политики прежние.
|
|
118
|
+
С полем harness сам держит seed по lockfile `targetRef` и разворачивает его в
|
|
119
|
+
каждый checkout: попытка, integration, потребители, `runGatesAt`, проверка
|
|
120
|
+
примера, снимки с `dependencyBuild` и совместная проверка, где `prepare` нет.
|
|
121
|
+
Проекту не нужны ни свой скрипт, ни шаг `prepare`, ни запись в `.gitignore`;
|
|
122
|
+
gate установки остаётся обычным `pnpm install --frozen-lockfile`.
|
|
123
|
+
Подробности и граница доверия — [toolchains](toolchains.md#хранилище-зависимостей).
|
|
124
|
+
|
|
125
|
+
Квитанция `dependency-store.json` лежит в артефактах фазы: `outcome`
|
|
126
|
+
(`hit` — lockfile checkout равен lockfile seed; `partial` — seed другого
|
|
127
|
+
lockfile, установка докачивает разницу; `miss` — обычная установка), `seed`,
|
|
128
|
+
`mode` (`clone` или `copy`), `built`, `files`, `bytes`, `durationMs`, `reason`,
|
|
129
|
+
`refused[]`. Попытка получает этап `dependency-store` в `timings`. Экспорт:
|
|
130
|
+
`materializeStore`, `dependencyStoreRoot`, типы `StoreContext`, `StoreReceipt`. `StoreContext.deadline` — момент окончания времени фазы, `phaseMs` — полная длина её предела: сборка и ожидание чужой сборки занимают не больше трети остатка.
|
|
131
|
+
Исключение `materializeStore` бросает только при отмене переданного `signal`. Коды `doctor`:
|
|
132
|
+
предупреждения `LOCKFILE_MISSING`, `TOOL_MISSING`, `DEPENDENCY_STORE`.
|
|
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
|
+
|
|
115
167
|
`policyDigest(policy)` — digest загруженной политики целиком: им сверяются
|
|
116
168
|
применённая политика (`control.appliedPolicy`) и запрос операции
|
|
117
169
|
`control.reconfigure`. `executionDigest(policy)` — digest исполнительной
|
|
@@ -333,8 +385,9 @@ Runtime возвращает сырой ответ; движок разбира
|
|
|
333
385
|
`maxItems` объявляет wire-схема CLI runtime); файл ответа codex — не больше
|
|
334
386
|
4 МиБ (`CODEX_RESULT_LIMIT`), читается с границей, без перехода по symlink, а
|
|
335
387
|
файл больше предела удаляется: он не прошёл маскирование. Сверх предела — обычный
|
|
336
|
-
|
|
337
|
-
|
|
388
|
+
отказ: у reviewer кода ошибка протокола `schema`, у исполнителя класс `unknown`
|
|
389
|
+
без автоматического повтора, у ревью плана и контракта — `RUNTIME_UNAVAILABLE`
|
|
390
|
+
с причиной. Записанное прежними версиями читается
|
|
338
391
|
без этих пределов: `review.json` — `storedReviewResultSchema`, а `ReviewRecord`
|
|
339
392
|
и evidence пределов не получили.
|
|
340
393
|
|
|
@@ -718,29 +771,31 @@ stdout — один JSON `CliEnvelope`: `{apiVersion, command, ok: true, data}`
|
|
|
718
771
|
читающие на отсутствующем каталоге отвечают `NOT_FOUND` и ничего не создают.
|
|
719
772
|
Бинарник не хранит настроек проекта и не помнит «последний активный проект».
|
|
720
773
|
|
|
721
|
-
| Команда
|
|
722
|
-
|
|
|
723
|
-
| `validate`
|
|
724
|
-
| `review-plan`
|
|
725
|
-
| `review-contract`
|
|
726
|
-
| `approve`
|
|
727
|
-
| `run`
|
|
728
|
-
| `status`
|
|
729
|
-
| `events`
|
|
730
|
-
| `pause`
|
|
731
|
-
| `resume`
|
|
732
|
-
| `cancel`
|
|
733
|
-
| `retry`
|
|
734
|
-
| `result`
|
|
735
|
-
| `deliver`
|
|
736
|
-
| `
|
|
737
|
-
| `
|
|
738
|
-
| `
|
|
739
|
-
| `
|
|
740
|
-
| `
|
|
741
|
-
| `
|
|
742
|
-
| `
|
|
743
|
-
|
|
|
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 | — |
|
|
744
799
|
|
|
745
800
|
Полная форма каждой команды — `cliCommands` (аргументы, обязательность,
|
|
746
801
|
идемпотентность, отказы exit 3). Все команды реализованы. `run` принимает `--author` (по умолчанию `external`) — автора графа для ревью плана. `HARNESS_CODEX_BIN` и `HARNESS_CLAUDE_BIN` подменяют исполняемые файлы runtime (fixture executables в тестах).
|
|
@@ -0,0 +1,36 @@
|
|
|
1
|
+
# devcontour-harness 0.1.0-alpha.27
|
|
2
|
+
|
|
3
|
+
Хранилище зависимостей pnpm, объявляемое в политике, команда уборки рабочих
|
|
4
|
+
деревьев завершённых попыток, более дешёвый поиск оставшихся процессов и
|
|
5
|
+
отказ до заведомо безуспешного вызова ревьюера. Обязательные gates, fencing и
|
|
6
|
+
привязка доказательств к SHA не меняются.
|
|
7
|
+
|
|
8
|
+
## Изменения
|
|
9
|
+
|
|
10
|
+
- **Хранилище зависимостей.** Необязательное поле
|
|
11
|
+
`repositories[].dependencyStore` (`manager: 'pnpm'`, `lockfile`, `maxBytes`,
|
|
12
|
+
`timeoutMs`). Seed собирается только из lockfile целевого ref и копируется
|
|
13
|
+
в `<checkout>/.pnpm-store`. Исход пишется в `dependency-store.json`: `hit`,
|
|
14
|
+
`partial` или `miss`. Отказ хранилища не стоит попытки: установка идёт
|
|
15
|
+
обычным путём. Поддержан pnpm `>=9.15.0 <10.27.0`; границы описаны в
|
|
16
|
+
`docs/compatibility.md`. Linux не проверялся.
|
|
17
|
+
- **`harness worktree-cleanup --state S [--dry-run]`.** Удаляет
|
|
18
|
+
зарегистрированные деревья завершённых попыток; ветки, объекты и артефакты
|
|
19
|
+
остаются. Незакоммиченные правки сначала сохраняются в patch. Дерево, которое
|
|
20
|
+
нельзя доказуемо восстановить, не удаляется, а отказ назван. Деревья с Git
|
|
21
|
+
LFS отказываются намеренно.
|
|
22
|
+
- **Поиск потомков.** Проверяются только процессы моложе команды: около 26 мс
|
|
23
|
+
вместо 341 мс на команду.
|
|
24
|
+
- **Ревью.** Проверка плана и договора останавливается до вызова, который не
|
|
25
|
+
может завершиться успешно. Открытые находки считаются по ID перед пределом
|
|
26
|
+
раунда.
|
|
27
|
+
- **Коннектор.** Понятный отказ, если конфигурация с baseline исчезла после
|
|
28
|
+
загрузки; `source-snapshot` снова закрепляет более раннюю ревизию.
|
|
29
|
+
- **Тесты.** У каждого прогона свой временный каталог, который удаляется в
|
|
30
|
+
конце; чувствительные к нагрузке тесты ждут событий, а не таймеров.
|
|
31
|
+
|
|
32
|
+
## Обновление
|
|
33
|
+
|
|
34
|
+
Пакет alpha.26 остаётся неизменным. Перед обновлением остановите writers и
|
|
35
|
+
сохраните копию состояния. Преобразование состояния не требуется. Без поля
|
|
36
|
+
`dependencyStore` поведение установки не меняется.
|
|
@@ -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`.
|
package/docs/review-protocol.md
CHANGED
|
@@ -76,9 +76,10 @@ ID: дедупликации по тексту нет, поэтому повто
|
|
|
76
76
|
|
|
77
77
|
**Пределы.** В ответе не больше 500 находок и 500 переходов
|
|
78
78
|
(`REVIEW_ITEMS_LIMIT`): больше — ошибка `schema` с путём `findings` или
|
|
79
|
-
`previous`. Файл ответа codex больше предела — ошибка `schema` с
|
|
80
|
-
`(response)`, как и нечитаемый
|
|
81
|
-
|
|
79
|
+
`previous`. Файл ответа codex больше предела в ревью кода — ошибка `schema` с
|
|
80
|
+
путём `(response)`, как и нечитаемый ответ; в ревью плана и контракта это
|
|
81
|
+
отказ `RUNTIME_UNAVAILABLE` (§8). Если открытых находок поручения больше 500,
|
|
82
|
+
раунд не записать: попытка останавливается с `review-protocol` до вызова
|
|
82
83
|
reviewer.
|
|
83
84
|
|
|
84
85
|
**Атомарность.** Ответ проверяется целиком до любой записи. Невалидный ответ
|
|
@@ -218,7 +219,12 @@ id = digestOf({ v: 'legacy-1', scope, evidence: e.id, runId, phase, sha, index,
|
|
|
218
219
|
неодобренным с причинами (у ответа вне схемы — путь поля и сообщение первой
|
|
219
220
|
ошибки). Повторно найденная закрытая находка с тем же ID
|
|
220
221
|
открывается снова, а не отбрасывается как дубликат. Формат `ReviewRecord`
|
|
221
|
-
не меняется.
|
|
222
|
+
не меняется. Если открытых находок предмета больше 500
|
|
223
|
+
(`REVIEW_ITEMS_LIMIT`), ответ не смог бы назвать их все: раунд
|
|
224
|
+
останавливается отказом `REVIEW_PROTOCOL_INVALID` до вызова reviewer.
|
|
225
|
+
Ответ, который адаптер не смог прочитать (в том числе файл ответа codex
|
|
226
|
+
больше предела), не становится раундом: это отказ `RUNTIME_UNAVAILABLE` с
|
|
227
|
+
причиной, без записи в историю.
|
|
222
228
|
|
|
223
229
|
## 9. Адаптеры без протокола переходов (совместимость хостов)
|
|
224
230
|
|
package/docs/toolchains.md
CHANGED
|
@@ -13,6 +13,7 @@ Python/uv — отдельные toolchain. Единого «типа проек
|
|
|
13
13
|
| Каталог | `gates[].cwd`; у шага `prepare` — собственный флаг инструмента (`pnpm --dir`, `npm --prefix`, `uv --directory`, `go -C`) |
|
|
14
14
|
| Окружение | `environment` политики/репозитория (`values`, `inherit`, `secrets`) |
|
|
15
15
|
| Проверенные версии инструментов и явный выбор менеджера пакетов | `repositories[].toolchain` (`tools`, `packageManagers`), необязательно |
|
|
16
|
+
| Общие пакеты между worktree без скачивания | `repositories[].dependencyStore`, необязательно ([хранилище зависимостей](#хранилище-зависимостей)) |
|
|
16
17
|
|
|
17
18
|
`toolchain` — необязательное аддитивное поле: политики и профили без него сохраняют прежний
|
|
18
19
|
digest. `tools` — `{ "gotestsum": "1.12.3" }` (названные компоненты версии совпадают) или
|
|
@@ -114,6 +115,88 @@ Isolation `os` пишет только в worktree и временный кат
|
|
|
114
115
|
песочнице cache-каталоги (`GOCACHE`, `UV_CACHE_DIR`, store) нужно указать доступными или
|
|
115
116
|
использовать `isolation.mode: none`, как в примерах. Установка (`prepare`) идёт вне песочницы.
|
|
116
117
|
|
|
118
|
+
## Хранилище зависимостей
|
|
119
|
+
|
|
120
|
+
Свежий worktree в песочнице не видит общий store менеджера и скачивает все пакеты заново.
|
|
121
|
+
Настройка одной строкой в политике снимает это для pnpm без скрипта в проекте:
|
|
122
|
+
|
|
123
|
+
```json
|
|
124
|
+
{ "id": "app", "dependencyStore": { "manager": "pnpm" } }
|
|
125
|
+
```
|
|
126
|
+
|
|
127
|
+
Необязательные поля: `lockfile` (`pnpm-lock.yaml`), `maxBytes` (8 ГиБ), `timeoutMs` (600 000).
|
|
128
|
+
`timeoutMs` — верхний предел, общий для сборки и ожидания чужой сборки; действует ещё и треть
|
|
129
|
+
остатка времени фазы: при `runTimeoutMs` 900 000 это 300 000 мс. Проект, чьей сборке этого мало,
|
|
130
|
+
поднимает `runTimeoutMs`, иначе получает `miss`. Если остаётся меньше 30 000 мс или меньше трёх четвертей полного бюджета, когда он сам мал, сборка не начинается.
|
|
131
|
+
В `isolation.domains` должен быть реестр, например `registry.npmjs.org`: seed собирается в той же
|
|
132
|
+
песочнице, что и проверки. Другой реестр задаётся через `environment` как `npm_config_registry`;
|
|
133
|
+
`.npmrc` проекта в сборку не попадает, поэтому реестр, настроенный только там, даёт `miss`.
|
|
134
|
+
|
|
135
|
+
Проверенные версии pnpm: от 9.15.0, ниже 10.27.0. На итоговом коде настоящими прогонами проверены
|
|
136
|
+
9.15.0, 10.12.3, 10.13.1 и 10.26.0. С 10.27.0 `pnpm fetch` кладёт в store символическую ссылку
|
|
137
|
+
`v10/projects/<hash>`, а seed со ссылками отклоняется; с 11.0.0 pnpm ещё и не читает
|
|
138
|
+
`npm_config_store_dir`. Версия берётся из PATH и из поля `packageManager`; вне диапазона, а также
|
|
139
|
+
когда менеджер не найден, его версия не определена или `package.json` не читается, хранилище не меняет ни окружение, ни дерево:
|
|
140
|
+
установка идёт как без него, причина — в квитанции и предупреждении `doctor`.
|
|
141
|
+
|
|
142
|
+
Как это работает:
|
|
143
|
+
|
|
144
|
+
1. Перед `prepare` каждого checkout, а у совместной проверки — перед её gates, harness читает
|
|
145
|
+
lockfile из `targetRef`. Seed этого lockfile есть — используется, нет — собирается:
|
|
146
|
+
`pnpm fetch` в каталоге только с lockfile, поэтому `.npmrc`, `.pnpmfile.cjs` и
|
|
147
|
+
`pnpm-workspace.yaml` проекта не участвуют и его хуки не исполняются. Новый seed начинается с
|
|
148
|
+
клона предыдущего: сдвиг lockfile докачивает только разницу. Параллельные проверки ждут одну
|
|
149
|
+
сборку.
|
|
150
|
+
2. Seed клонируется в `<checkout>/.pnpm-store` (копия-при-записи на APFS и reflink-томах, иначе
|
|
151
|
+
обычная копия, если хватает места), копия сверяется с манифестом, менеджер получает путь через
|
|
152
|
+
`npm_config_store_dir`. Каталог скрыт от git собственным `.gitignore`.
|
|
153
|
+
3. Gate установки — обычный `pnpm install --frozen-lockfile`. Он берёт пакеты из копии, а чего нет,
|
|
154
|
+
скачивает через прокси песочницы.
|
|
155
|
+
|
|
156
|
+
Исполнитель и проверки ревьюера переменную `npm_config_store_dir` не получают: их окружение строится
|
|
157
|
+
отдельно. Установка исполнителя до первого gate поэтому на seed не опирается и идёт как без
|
|
158
|
+
хранилища.
|
|
159
|
+
|
|
160
|
+
| Исход | Что происходит |
|
|
161
|
+
| --------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
|
162
|
+
| Seed того же lockfile | `hit`: скачивать нечего |
|
|
163
|
+
| Lockfile checkout другой, или сборка нового seed не удалась | `partial`: установка докачивает разницу |
|
|
164
|
+
| Seed нет, сборка не удалась, не хватает места | `miss`: обычная установка; очередь не останавливается, попытка не тратится |
|
|
165
|
+
| Отказ, зависящий от самого lockfile: патчи (`patchedDependencies`, сборка видит только lockfile), пустой seed, seed сверх предела | `miss`; этот lockfile не собирается, пока не изменится |
|
|
166
|
+
| Истёк бюджет хранилища: реестр висит или чужая сборка идёт долго | `miss` или старый seed; время фазы остаётся работе, отменяет фазу только отмена попытки или оператора. Пометку об отказе ставит только сборка, начатая с полным бюджетом (не меньше трёх четвертей): опоздавшая фаза другим сборку не закрывает |
|
|
167
|
+
| Сборка не удалась недавно | 10 минут новых сборок этого lockfile нет: отказавший реестр не отнимает `timeoutMs` у каждой попытки |
|
|
168
|
+
| Seed изменён | Отказ с причиной в `refused`, seed удаляется и собирается заново |
|
|
169
|
+
| `isolation.mode: none` или `.pnpm-store` уже есть в дереве | `miss`: без границы seed не используется, в занятый путь harness не пишет |
|
|
170
|
+
|
|
171
|
+
Граница доверия:
|
|
172
|
+
|
|
173
|
+
- Seed строится только из lockfile целевой ветки. Сам harness не даёт кандидату запустить сборку или
|
|
174
|
+
выбрать её содержимое: его lockfile лишь сравнивается с seed.
|
|
175
|
+
- **Условие:** шаги `prepare` и `lifecycle` идут на хосте вне песочницы, а на integration — над слитым
|
|
176
|
+
деревом. Шаг, исполняющий код кандидата (скрипт из репозитория), работает с правами controller и
|
|
177
|
+
может изменить seed и базу закреплений. Граница seed держится только там, где эти шаги кода
|
|
178
|
+
кандидата не исполняют. `doctor` предупреждает о `dependencyStore` рядом с непустым `prepare`.
|
|
179
|
+
- Seeds лежат под корнем рабочих деревьев или в каталоге состояния, закрытых песочницей на чтение
|
|
180
|
+
и запись. Манифест закреплён digest в базе ресурсов, вне дерева seed.
|
|
181
|
+
- Проверяются байты копии, а не источника: те, что прочитает менеджер.
|
|
182
|
+
- Копия принадлежит своему checkout, в seed ничего не возвращается. Integration и следующая попытка
|
|
183
|
+
получают новую копию. Поэтому байты seed проверены всегда, а докачанные байты и всё, что
|
|
184
|
+
исполнитель изменил в своём дереве, доверены не больше, чем его `node_modules`: они не выходят
|
|
185
|
+
за пределы этого дерева.
|
|
186
|
+
|
|
187
|
+
Диск: хранятся два последних по использованию seed в пределах `maxBytes`, остальное и брошенные
|
|
188
|
+
сборки убираются при публикации нового. Seed больше предела размера или 150 000 файлов не публикуется. Копия лежит в checkout и входит в
|
|
189
|
+
сверку защищённых путей (предел 200 000 элементов), поэтому checkout, который вместе с копией превысил
|
|
190
|
+
бы 180 000 элементов, получает `miss`, а не отказ проверки. Сборка от прежнего seed, упёршаяся в предел, повторяется с пустого: основа копит старые пакеты. При любом пределе дерево и окружение остаются как без хранилища, если только прежний seed не подошёл как частичное попадание. Отказ по `maxBytes` действует, пока предел не изменён. Копии уходят вместе с
|
|
191
|
+
рабочими деревьями. Seeds лежат в `<корень>/<repo>/dependency-store`, а без корня вне дерева — в
|
|
192
|
+
`<state>/dependency-store/<repo>`; их можно удалить, когда harness не запущен, и они соберутся заново.
|
|
193
|
+
|
|
194
|
+
`doctor` предупреждает об отсутствии менеджера и lockfile, о версии вне диапазона и о непустом
|
|
195
|
+
`prepare`; это предупреждения: запуск идёт, установка обычная. Эксперимент выполнимости (`spike`)
|
|
196
|
+
хранилища не получает: у него нет `prepare`, его команду задаёт оператор. Что в итоге произошло в конкретной фазе, показывает
|
|
197
|
+
`dependency-store.json` в её артефактах. Другие менеджеры добавляются записью в таблице `managers`
|
|
198
|
+
(`verification/dependency-store.ts`); пока поддержан только pnpm.
|
|
199
|
+
|
|
117
200
|
## Диагностика: doctor и preflight
|
|
118
201
|
|
|
119
202
|
`harness doctor --policy policy.json` (или `--state`) добавляет `toolchains[]` — по
|