devcontour-harness 0.1.0-alpha.21 → 0.1.0-alpha.23
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 +21 -2
- package/docs/architecture.md +10 -1
- package/docs/compatibility.md +11 -11
- package/docs/contracts.md +17 -2
- package/docs/quickstart.md +1 -1
- package/docs/release-notes/0.1.0-alpha.22.md +57 -0
- package/docs/release-notes/0.1.0-alpha.23.md +122 -0
- package/docs/toolchains.md +2 -1
- package/docs/upgrade.md +17 -17
- package/lib/agents/cli-adapter.js +1 -0
- package/lib/agents/review-probe.d.ts +1 -0
- package/lib/agents/review-probe.js +4 -0
- package/lib/cli.js +1 -1
- package/lib/contracts/cli.d.ts +20 -0
- package/lib/contracts/cli.js +11 -0
- package/lib/contracts/ports.d.ts +6 -0
- package/lib/control/base-move.d.ts +2 -0
- package/lib/control/base-move.js +13 -2
- package/lib/control/doctor.d.ts +10 -0
- package/lib/control/doctor.js +19 -3
- package/lib/control/harness.d.ts +6 -0
- package/lib/control/harness.js +2 -0
- package/lib/engine/joint-runner.d.ts +5 -0
- package/lib/engine/joint-runner.js +28 -5
- package/lib/engine/runner.d.ts +18 -0
- package/lib/engine/runner.js +73 -10
- package/lib/environment/checkout-root.d.ts +78 -0
- package/lib/environment/checkout-root.js +133 -0
- package/lib/environment/git-trust.js +4 -0
- package/lib/environment/isolation.d.ts +48 -9
- package/lib/environment/isolation.js +132 -37
- package/lib/index.d.ts +5 -0
- package/lib/index.js +5 -0
- package/lib/verification/confirm.d.ts +7 -4
- package/lib/verification/confirm.js +4 -2
- package/lib/verification/gates-at.d.ts +9 -5
- package/lib/verification/gates-at.js +30 -5
- package/lib/verification/gates.d.ts +13 -4
- package/lib/verification/gates.js +15 -2
- package/lib/verification/spike.d.ts +7 -4
- package/lib/verification/spike.js +4 -2
- package/package.json +1 -1
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.23` — предварительный выпуск (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.23 # точная версия
|
|
32
32
|
# или: npm install --save-exact devcontour-harness@alpha # текущая alpha
|
|
33
33
|
npx harness --version
|
|
34
34
|
```
|
|
@@ -123,6 +123,25 @@ PASS» нет. Адаптеры хоста реализуют порты `Execut
|
|
|
123
123
|
`devcontour-harness/schemas/<имя>.schema.json`. Декларации используют типы
|
|
124
124
|
Node.js: TypeScript-потребителю нужен `@types/node` (или `skipLibCheck`).
|
|
125
125
|
|
|
126
|
+
## Выпуск 0.1.0-alpha.23
|
|
127
|
+
|
|
128
|
+
Рабочие деревья попыток вне дерева человека: если каталог состояния лежит
|
|
129
|
+
внутри репозитория (встроенное размещение), checkout кандидата, снимки
|
|
130
|
+
зависимостей и деревья проверок создаются под корнем вне дерева — заданным
|
|
131
|
+
хостом (`checkoutRoot`) или в кэше пользователя. Инструменты, ищущие
|
|
132
|
+
конфигурацию вверх по дереву, больше не получают EPERM на закрытом
|
|
133
|
+
`package.json` репозитория; такой отказ песочницы, подтверждённый журналом
|
|
134
|
+
ядра, — сбой среды с путём. Подробно —
|
|
135
|
+
[заметки выпуска](docs/release-notes/0.1.0-alpha.23.md).
|
|
136
|
+
|
|
137
|
+
## Выпуск 0.1.0-alpha.22
|
|
138
|
+
|
|
139
|
+
Ужесточение сверки защищённых путей: имена сравниваются без регистра
|
|
140
|
+
(`.Claude/settings.json` на APFS — то же, что `.claude/settings.json`), путь,
|
|
141
|
+
который сверка не может прочитать, — отказ с путём в сообщении, а не пропуск,
|
|
142
|
+
пустой защищённый каталог, открытый на запись всем, и FIFO внутри —
|
|
143
|
+
нарушение. Подробно — [заметки выпуска](docs/release-notes/0.1.0-alpha.22.md).
|
|
144
|
+
|
|
126
145
|
## Выпуск 0.1.0-alpha.21
|
|
127
146
|
|
|
128
147
|
Исправление сверки защищённых путей: пустые служебные каталоги, которые CLI
|
package/docs/architecture.md
CHANGED
|
@@ -589,7 +589,16 @@ executable. Live smoke — отдельный opt-in с явно заданны
|
|
|
589
589
|
(служебный `.claude/.cc-writes` CLI исполнителя) нарушением не считается,
|
|
590
590
|
если до снимка пути не было или он тоже был без файлов; любой файл или
|
|
591
591
|
символьная ссылка внутри, правка прежнего пути с файлами и замена файла
|
|
592
|
-
`.git` каталогом — нарушение.
|
|
592
|
+
`.git` каталогом — нарушение. Пустым деревом не считаются FIFO, сокеты и
|
|
593
|
+
прочие не-каталоги, а также каталог, открытый на запись всем
|
|
594
|
+
(`mode & 0o002`; запись группе при umask 002 разрешена): у такого каталога
|
|
595
|
+
права входят в подпись. Имена
|
|
596
|
+
сравниваются без регистра (на APFS и NTFS `.Claude/settings.json` хост
|
|
597
|
+
читает как `.claude/settings.json`); Seatbelt на таком томе и сам закрывает
|
|
598
|
+
запреты в любом регистре. Путь, который сверка не может прочитать (любая
|
|
599
|
+
ошибка, кроме ENOENT: каталог без права поиска, `.claude` с mode 000), —
|
|
600
|
+
отказ сверки с путём в сообщении: до работы — класс `environment`, после
|
|
601
|
+
работы исполнителя или gate — `scope-violation`.
|
|
593
602
|
- **Классификация отказов песочницы.** Отказ — класс `environment` только
|
|
594
603
|
тогда, когда журнал ядра macOS подтвердил отказ обязательного запрета внутри
|
|
595
604
|
дерева проверки: команда начинается с уникального токена, и записи srt этой
|
package/docs/compatibility.md
CHANGED
|
@@ -148,17 +148,17 @@ 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
|
|
157
|
-
| Receipt среды | `environment.json` `version: 1`
|
|
158
|
-
| Отчёт свойств, договор проверки, корпус | `version: 1`
|
|
159
|
-
| Владение репозиторием | `<git-common-dir>/devcontour-owner.json`
|
|
160
|
-
| Ресурсы | Отдельная база блокировок ресурсов `resources.sqlite`: блокировки устройств и портов, а не состояние исполнения
|
|
161
|
-
| Probe ревьюера | MCP-сервер `devcontour_probe`, инструмент `run_check`; протокол — построчный JSON-RPC (stdio), журнал `probes.jsonl`
|
|
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
|
+
| Владение репозиторием | `<git-common-dir>/devcontour-owner.json` |
|
|
160
|
+
| Ресурсы | Отдельная база блокировок ресурсов `resources.sqlite`: блокировки устройств и портов, а не состояние исполнения |
|
|
161
|
+
| Probe ревьюера | MCP-сервер `devcontour_probe`, инструмент `run_check`; протокол — построчный JSON-RPC (stdio), журнал `probes.jsonl` |
|
|
162
162
|
|
|
163
163
|
## Переменные окружения gates
|
|
164
164
|
|
package/docs/contracts.md
CHANGED
|
@@ -593,8 +593,23 @@ manifestDigest, impact?, evidence[], error?}`. Смена любого SHA де
|
|
|
593
593
|
исполнения: адаптер хоста находит по нему свои сведения; в запросе модели их нет.
|
|
594
594
|
|
|
595
595
|
`Runner` принимает от хоста: `context(work)` — снимок контекста, в том числе
|
|
596
|
-
асинхронно; `stateDirFor(repositoryId)` — каталог
|
|
597
|
-
|
|
596
|
+
асинхронно; `stateDirFor(repositoryId)` — каталог артефактов попыток
|
|
597
|
+
репозитория (без него — `stateDir`), а при прежнем размещении и их рабочих
|
|
598
|
+
деревьев; `checkoutRoot` — корень рабочих деревьев, снимков зависимостей и
|
|
599
|
+
деревьев проверок потребителей (`<checkoutRoot>/<repositoryId>/worktrees/<runId>`
|
|
600
|
+
и т. д.; так же — `checkoutRoot` у `Harness`, `JointRunner`, `runGatesAt` и
|
|
601
|
+
`moveBase`). Без него корень выбирает `chooseCheckoutRoot`: каталог состояния
|
|
602
|
+
внутри репозитория политики или закрытого песочницей пути — кэш пользователя
|
|
603
|
+
вне дерева (macOS `~/Library/Caches/devcontour-harness/<hash>`, Linux
|
|
604
|
+
`$XDG_CACHE_HOME` или `~/.cache/devcontour-harness/<hash>`, `<hash>` —
|
|
605
|
+
устойчивый хэш каталога состояния), иначе прежнее место. Кэш на другом томе,
|
|
606
|
+
чем репозиторий, корень внутри репозитория, закрытого пути или каталога
|
|
607
|
+
состояния, каталог-ссылка или чужой каталог — прежнее место и пояснение
|
|
608
|
+
(`note`; заданный хостом такой корень — `INVALID_INPUT`). Корень закрыт
|
|
609
|
+
песочнице целиком, свои деревья проверки открыты; корни кэша не убираются при
|
|
610
|
+
переносе workspace — их удаляют вручную; `Runner.checkoutRoot()`
|
|
611
|
+
и `doctor` называют действующий корень. Корень лучше держать на томе
|
|
612
|
+
репозиториев: менеджеры пакетов ставят зависимости жёсткими ссылками и reflink;
|
|
598
613
|
`hooks` — точки расширения, которые добавляют сведения хоста, но не решают
|
|
599
614
|
приёмку: `prepared({work, attempt, baseSha})` — база известна, работа не
|
|
600
615
|
начата (отказ — отказ попытки, `BlockedError` — отказ окружения);
|
package/docs/quickstart.md
CHANGED
|
@@ -0,0 +1,57 @@
|
|
|
1
|
+
# devcontour-harness 0.1.0-alpha.22
|
|
2
|
+
|
|
3
|
+
Ужесточение сверки защищённых путей вокруг исполнителя и gates. Включает всё из
|
|
4
|
+
[0.1.0-alpha.21](0.1.0-alpha.21.md). Формат состояния, gates, правила находок,
|
|
5
|
+
принятие target ref и `maxAttempts` не менялись.
|
|
6
|
+
|
|
7
|
+
## Что исправлено
|
|
8
|
+
|
|
9
|
+
- **Имена без регистра.** На нечувствительной к регистру ФС (APFS по
|
|
10
|
+
умолчанию, NTFS) `.Claude/settings.json`, `.VSCode/tasks.json`, вложенный
|
|
11
|
+
`sub/.GIT` или `.Bashrc` хост читает как имена нижнего регистра, а сверка
|
|
12
|
+
сравнивала имена точно и их пропускала. Теперь защищённые имена сравниваются
|
|
13
|
+
без регистра на любой платформе; на чувствительной к регистру ФС такое имя
|
|
14
|
+
тоже нарушение — создавать его незачем. Отказ обязательного запрета из
|
|
15
|
+
журнала ядра узнаётся в любом регистре (`.IDEA/x` — «каталог IDE .idea»).
|
|
16
|
+
Запреты записи sandbox-runtime менять не потребовалось: проба под песочницей
|
|
17
|
+
на APFS показала, что Seatbelt сам отказывает в `.IDEA/x`, `.VSCode/x`,
|
|
18
|
+
`.Bashrc`, `.Claude/commands/x` и `x/.GIT/hooks/x`.
|
|
19
|
+
- **Непрочитанный путь — отказ, а не пропуск.** Ошибка `lstat`, `readdir` или
|
|
20
|
+
`readlink`, кроме ENOENT, раньше превращалась в «пути нет»: `chmod 0444 sub`
|
|
21
|
+
прятал `sub/.claude/settings.json`, каталог без права чтения не
|
|
22
|
+
перечислялся. Теперь это отказ сверки с путём и кодом ошибки в сообщении
|
|
23
|
+
(«нет доступа к sub/.claude (EACCES)»), и так же для пустого `.claude` с
|
|
24
|
+
правами 000. До работы исполнителя или gate — класс `environment`; после —
|
|
25
|
+
`scope-violation`.
|
|
26
|
+
- **Открытые каталоги не пустые.** Пустое дерево каталогов (служебный
|
|
27
|
+
`.claude/.cc-writes`) по-прежнему не нарушение, только если ни один каталог
|
|
28
|
+
в нём не открыт на запись всем (`mode & 0o002`); запись группе (umask 002,
|
|
29
|
+
`.claude` с правами 775) разрешена. Подпись каталога
|
|
30
|
+
несёт права: смена прав защищённого каталога с файлами — тоже изменение.
|
|
31
|
+
FIFO, сокет и прочие не-каталоги внутри — содержимое, а не пустое дерево.
|
|
32
|
+
|
|
33
|
+
## Совместимость
|
|
34
|
+
|
|
35
|
+
Формат состояния и публичный API не меняются. Матрица —
|
|
36
|
+
[upgrade](../upgrade.md). Каталог checkout, который нельзя прочитать (вне
|
|
37
|
+
`node_modules`), теперь останавливает gate с классом `environment` вместо
|
|
38
|
+
молчаливого пропуска. Пустой `.claude` с правами 775, который CLI исполнителя
|
|
39
|
+
создаёт при umask 002, нарушением не считается; открытый всем (777) — считается.
|
|
40
|
+
|
|
41
|
+
## Проверка выпуска
|
|
42
|
+
|
|
43
|
+
Тесты `sandbox-install`: SBX06 — FIFO в `.claude/.cc-writes` нарушение; SBX08 —
|
|
44
|
+
`.Claude`, `.VSCode`, вложенный `.GIT`, `.Bashrc`, `.MCP.json` нарушение,
|
|
45
|
+
пустой `.CLAUDE/.cc-writes` — нет, обязательный запрет узнаётся в любом
|
|
46
|
+
регистре; SBX09 — каталог без права поиска, неперечисляемый каталог и `.claude`
|
|
47
|
+
с правами 000 — отказ с путём; SBX10 — пустой каталог 777/757 и смена прав
|
|
48
|
+
каталога с файлами — нарушение, 775 (umask 002) — нет; SBX11 под песочницей ОС — `.IDEA` закрыт ядром,
|
|
49
|
+
`.Claude/settings.json` в существующий `.claude` и спрятанный `chmod`
|
|
50
|
+
`sub/.claude` — `scope-violation`. Тест `runner` T05 под песочницей ОС:
|
|
51
|
+
`.Claude/settings.json`, `.cc-writes` с правами 777 и `src/.claude` с правами
|
|
52
|
+
000 — `scope-violation`. Мутанты обнаруживаются: точное сравнение имён и
|
|
53
|
+
правила — SBX08; ошибка `lstat` как «пути нет», пропуск неперечисляемого
|
|
54
|
+
каталога, непрочитанный каталог как пустой — SBX09; без проверки записи всем, с проверкой и записи группе и без
|
|
55
|
+
прав в подписи — SBX10; не-каталог как пустой — SBX06; без класса
|
|
56
|
+
`scope-violation` для непрочитанного пути — SBX11 (gates) и T05 (runner).
|
|
57
|
+
Полный `npm run check`. Живые модели не вызывались.
|
|
@@ -0,0 +1,122 @@
|
|
|
1
|
+
# devcontour-harness 0.1.0-alpha.23
|
|
2
|
+
|
|
3
|
+
Рабочие деревья попыток вне дерева человека. Включает всё из
|
|
4
|
+
[0.1.0-alpha.22](0.1.0-alpha.22.md). Формат состояния, gates, правила находок,
|
|
5
|
+
принятие target ref и `maxAttempts` не менялись.
|
|
6
|
+
|
|
7
|
+
## Что исправлено
|
|
8
|
+
|
|
9
|
+
- **Checkout кандидата больше не вложен в репозиторий.** При встроенном
|
|
10
|
+
размещении каталог состояния лежит внутри репозитория человека
|
|
11
|
+
(`<W>/.devcontour-local`), и движок создавал рабочие деревья внутри него.
|
|
12
|
+
Песочница закрывает `<W>` целиком и открывает только сам checkout, поэтому
|
|
13
|
+
инструменты, которые ищут конфигурацию вверх по дереву (browserslist через
|
|
14
|
+
babel в jest-expo, поиск корня монорепозитория Metro/Expo, postcss,
|
|
15
|
+
tsconfig, prettier), получали на `stat('<W>/package.json')` EPERM вместо
|
|
16
|
+
ENOENT и падали: gate `mobile-test` не проходил при любом коде. Без
|
|
17
|
+
песочницы те же инструменты прочитали бы конфигурацию рабочего дерева
|
|
18
|
+
человека. Теперь рабочие деревья попыток (`…/worktrees/<runId>` и
|
|
19
|
+
`…-integration`), снимки зависимостей, деревья проверок потребителей,
|
|
20
|
+
проверки на SHA (`runGatesAt`), деревья слияния переноса базы (`moveBase`),
|
|
21
|
+
эксперименты выполнимости, подтверждение случаев и компоненты совместной
|
|
22
|
+
проверки создаются под корнем вне дерева:
|
|
23
|
+
`<checkoutRoot>/<repositoryId>/<вид>/<id>`. Артефакты и логи остаются в
|
|
24
|
+
каталоге состояния.
|
|
25
|
+
- **Выбор корня.** Хост задаёт корень явно — `checkoutRoot` у `Runner`,
|
|
26
|
+
`Harness`, `JointRunner`, `runGatesAt` и `moveBase`. Без него
|
|
27
|
+
`chooseCheckoutRoot` выбирает кэш пользователя, если каталог состояния (или
|
|
28
|
+
каталог попыток компонента) лежит внутри репозитория политики или внутри
|
|
29
|
+
закрытого песочницей пути: macOS `~/Library/Caches/devcontour-harness/<hash>`,
|
|
30
|
+
Linux `$XDG_CACHE_HOME/devcontour-harness/<hash>` или
|
|
31
|
+
`~/.cache/devcontour-harness/<hash>`; `<hash>` — устойчивый хэш настоящего
|
|
32
|
+
пути каталога состояния. Иначе (отдельное размещение) деревья остаются на
|
|
33
|
+
прежнем месте. Менеджеры пакетов (pnpm store) ставят зависимости жёсткими
|
|
34
|
+
ссылками и reflink только в пределах одного тома: если кэш на другом томе,
|
|
35
|
+
чем репозиторий, корень остаётся прежним, а причина видна в `note`.
|
|
36
|
+
Действующий корень называют `Runner.checkoutRoot()` и `harness doctor
|
|
37
|
+
--state` (поле `checkouts`).
|
|
38
|
+
- **Проверка корня.** Корень внутри репозитория политики, закрытого пути или
|
|
39
|
+
каталога состояния (например, `XDG_CACHE_HOME=<W>/.cache`) вернул бы ту же
|
|
40
|
+
вложенность: выбранный по умолчанию такой корень не используется (прежнее
|
|
41
|
+
место и пояснение в `note`), заданный хостом — ошибка `INVALID_INPUT`.
|
|
42
|
+
Каталоги кэша (`devcontour-harness` и `<hash>`) создаются с правами 0700;
|
|
43
|
+
каталог-ссылка или каталог другого пользователя — отказ с пояснением
|
|
44
|
+
(заданный корень — ошибка).
|
|
45
|
+
- **Песочница.** Корень вне дерева закрыт целиком, как каталог состояния:
|
|
46
|
+
деревья других попыток не прочитать, в том числе появившиеся после
|
|
47
|
+
построения политики. Свои деревья проверки — checkout, дерево integration
|
|
48
|
+
или потребителя, снимки зависимостей, scratch — открыты более конкретным
|
|
49
|
+
разрешением (`checkouts` в границе проверки, `SandboxSpec` и спецификации
|
|
50
|
+
probe ревьюера). Поиск конфигурации вверх по дереву от своего checkout при
|
|
51
|
+
этом не ломается: в корне нет файлов конфигурации, Seatbelt на `stat`
|
|
52
|
+
отсутствующего файла под запретом отвечает ENOENT, а метаданные каталогов-
|
|
53
|
+
предков открыты. На Linux — та же схема, что прежде у worktree внутри закрытого каталога состояния (разрешение внутри запрета bubblewrap sandbox-runtime); под песочницей проверено на macOS, на Linux — не прогонялось.
|
|
54
|
+
- **Класс отказа.** Отказ чтения или `stat`, который журнал ядра (macOS)
|
|
55
|
+
подтвердил для тега этой проверки, — класс `environment` с путём и
|
|
56
|
+
правилом, только в форме поиска вверх по дереву: закрытый файл лежит прямо
|
|
57
|
+
в строгом предке рабочего каталога проверки, и проверка упала с EPERM на
|
|
58
|
+
нём (путь назван в её выводе). Чтение другого закрытого пути (`~/.ssh`,
|
|
59
|
+
файл в подкаталоге репозитория) с напечатанным EPERM, отказ, который
|
|
60
|
+
проверка пережила, и обычный провал тестов остаются `gate`. Отказ среды
|
|
61
|
+
не тратит попытку и останавливает очередь до решения человека, поэтому
|
|
62
|
+
признак узкий.
|
|
63
|
+
- **Git хоста.** Если файл `.git` созданного хостом рабочего дерева удалён,
|
|
64
|
+
git хоста над ним не запускается: иначе он ушёл бы в репозиторий предка
|
|
65
|
+
(при прежнем размещении — в checkout человека).
|
|
66
|
+
|
|
67
|
+
## Миграция и совместимость
|
|
68
|
+
|
|
69
|
+
Формат состояния и прежние поля API не меняются; новые — необязательные
|
|
70
|
+
(`checkoutRoot`, `checkouts` в `SandboxSpec`, границе проверки и `doctor`).
|
|
71
|
+
Матрица — [upgrade](../upgrade.md). Рабочие деревья, созданные прежними
|
|
72
|
+
версиями внутри каталога состояния, остаются там и убираются как раньше: по
|
|
73
|
+
пути, записанному в попытке (`finishCleanup`, `harness cleanup`), и через
|
|
74
|
+
`git worktree remove`/`prune` основного репозитория. Новые попытки создают
|
|
75
|
+
деревья под новым корнем. Если хост меняет `checkoutRoot` между падением
|
|
76
|
+
процесса и очисткой, окружение прерванной попытки под прежним корнем
|
|
77
|
+
`finishCleanup` не трогает — очистите его до смены корня.
|
|
78
|
+
|
|
79
|
+
Корни кэша не убираются, когда workspace переносят или удаляют: после
|
|
80
|
+
попыток в них остаются пустые каталоги видов (`worktrees`, `dependencies`…).
|
|
81
|
+
Каталог `~/Library/Caches/devcontour-harness/<hash>` (Linux —
|
|
82
|
+
`$XDG_CACHE_HOME/devcontour-harness/<hash>` или
|
|
83
|
+
`~/.cache/devcontour-harness/<hash>`), каталог состояния которого больше не
|
|
84
|
+
используется, можно удалить вручную, когда harness не запущен; действующий
|
|
85
|
+
корень называет `doctor`. Компоненты совместной проверки лежат в
|
|
86
|
+
`<root>/.joint/<id>`: имя с точки не совпадает ни с одним ID репозитория.
|
|
87
|
+
|
|
88
|
+
Хосту со встроенным размещением ничего передавать не обязательно: выбор по
|
|
89
|
+
умолчанию уже выносит деревья в кэш пользователя. Явный `checkoutRoot` на томе
|
|
90
|
+
репозиториев нужен, если кэш пользователя на другом томе или хост хочет
|
|
91
|
+
держать деревья в своём каталоге.
|
|
92
|
+
|
|
93
|
+
## Проверка выпуска
|
|
94
|
+
|
|
95
|
+
Тест `checkout-root`: CR01 — выбор корня на macOS и Linux (XDG, относительный
|
|
96
|
+
XDG игнорируется), устойчивый хэш (тот же путь через symlink — тот же корень),
|
|
97
|
+
отдельное размещение без изменений, заданный корень; CR02 — кэш на другом
|
|
98
|
+
томе — прежнее место с пояснением; CR03 — корень закрыт целиком, свои деревья
|
|
99
|
+
открыты; CR04 — git хоста доверяет деревьям вне дерева, подмена и удаление
|
|
100
|
+
`.git` дерева — отказ, дерево прежней версии в каталоге состояния убирается,
|
|
101
|
+
`prune` снимает удалённое мимо git; CR05 — классификация отказа чтения (форма
|
|
102
|
+
поиска вверх, EPERM с путём; `~/.ssh` и файл в подкаталоге — нет); CR06 под
|
|
103
|
+
песочницей ОС — gate, ищущий `package.json` вверх, вне дерева проходит, а
|
|
104
|
+
соседняя попытка закрыта; внутри закрытого репозитория — EPERM и класс
|
|
105
|
+
`environment` с путём; прочитанный с EPERM `~/.ssh` или файл подкаталога
|
|
106
|
+
репозитория и настоящий провал — `gate`; CR07 и CR08 — попытка движка при
|
|
107
|
+
встроенном размещении с заданным корнем и с кэшем пользователя проходит gate
|
|
108
|
+
обеих фаз под песочницей ОС, в дереве человека рабочих деревьев нет; CR09 —
|
|
109
|
+
отдельное размещение на прежнем месте; CR10 — `runGatesAt`, CR11 —
|
|
110
|
+
`moveBase` вне дерева; CR12 под песочницей ОС — дерево другой попытки,
|
|
111
|
+
созданное во время проверки, ей не прочитать; CR13 — корень внутри
|
|
112
|
+
репозитория, каталога состояния или закрытого пути, ссылка и чужой владелец
|
|
113
|
+
— отказ, каталоги кэша 0700. Мутанты обнаруживаются: без проверки
|
|
114
|
+
вложенности — CR01, CR02, CR08; без заданного корня — CR01, CR07, CR10,
|
|
115
|
+
CR11; хэш по сырому пути — CR01; без проверки тома — CR02; относительный XDG —
|
|
116
|
+
CR01; без класса для чтения — CR05, CR06; без требования EPERM — CR05; без
|
|
117
|
+
формы поиска вверх — CR05; без более конкретного открытого пути — CR05;
|
|
118
|
+
корень вне дерева не закрыт — CR03, CR12; удалённый `.git` дерева не отказ —
|
|
119
|
+
CR04; кэш или заданный корень внутри репозитория приняты, без 0700, ссылка
|
|
120
|
+
или чужой владелец приняты — CR13; рабочее дерево попытки на прежнем месте —
|
|
121
|
+
CR07 падает тем же EPERM на `package.json` репозитория, что и на пилоте.
|
|
122
|
+
Полный `npm run check`. Живые модели не вызывались.
|
package/docs/toolchains.md
CHANGED
|
@@ -83,7 +83,8 @@ export PATH="$PWD/node_modules/.bin:$PATH"
|
|
|
83
83
|
## Cache и изменяемые каталоги
|
|
84
84
|
|
|
85
85
|
Каждая попытка исполняется в своём worktree (`<state>/repos/<repo>/worktrees/<attempt>` и
|
|
86
|
-
`…-integration
|
|
86
|
+
`…-integration`; если каталог состояния лежит внутри репозитория — под корнем вне дерева
|
|
87
|
+
`<checkoutRoot>/<repo>/worktrees/<attempt>`), и `prepare` устанавливает зависимости заново в нём. Изменяемые артефакты
|
|
87
88
|
одной попытки другой не видны.
|
|
88
89
|
|
|
89
90
|
| Допустимый общий cache (content-addressed, вне worktree) | Изменяемое, только внутри worktree попытки |
|
package/docs/upgrade.md
CHANGED
|
@@ -21,23 +21,23 @@
|
|
|
21
21
|
|
|
22
22
|
## Матрица форматов
|
|
23
23
|
|
|
24
|
-
| Состояние, записанное… | Читает 0.1.0-alpha.1 | Читает 0.1.0-alpha.2 | Читает 0.1.0-alpha.6 | Читает 0.1.0-alpha.7 | Читает 0.1.0-alpha.8 | Читает 0.1.0-alpha.9 | Читает 0.1.0-alpha.10 | Читает 0.1.0-alpha.11 | Читает 0.1.0-alpha.12 | Читает 0.1.0-alpha.13 | Читает 0.1.0-alpha.14 | Читает 0.1.0-alpha.15 | Читает 0.1.0-alpha.16 | Читает 0.1.0-alpha.17 | Читает 0.1.0-alpha.18 | Читает 0.1.0-alpha.19 | Читает 0.1.0-alpha.20 | Читает 0.1.0-alpha.21 | Пишет поверх | Примечание |
|
|
25
|
-
| ----------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------ | ------------------------ | ----------------------- | ----------------------- | ----------------------- | ----------------------- | ----------------------- | ----------------------- | ----------------------- | ----------------------- | ----------------------- | ----------------------- | ----------------------- | ----------------------- | ----------------------- | --------------------- | --------------------- | --------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
|
26
|
-
| standalone `stateVersion: 1` версией alpha.1 | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | одна база SQLite: документ, события, локальные записи |
|
|
27
|
-
| хост, центральная база | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да | данные не переносятся; новые поля необязательны |
|
|
28
|
-
| хост, базы компонентов | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да | нужна копия всех баз при остановленных writers |
|
|
29
|
-
| alpha.2 после штатной остановки controller | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | роль controller снята — нового поля в состоянии нет |
|
|
30
|
-
| alpha.2 с живой или брошенной ролью controller | **нет**, отказ до записи | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | — | роль хранит `engineVersion`; строгая схема alpha.1 его не знает → откат через копию |
|
|
31
|
-
| alpha.4 с совместной проверкой | **нет**, отказ до записи | **нет**, отказ до записи | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | — | проверка хранит `engineVersion`; прежние версии его не знают → откат через копию |
|
|
32
|
-
| alpha.6 standalone с записями ревью нового протокола или доставкой `uncertain` | **нет**, отказ до записи | **нет**, отказ до записи | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | — | `reviewRound`, `findings[].id/status`, статус доставки `uncertain`; alpha.4/alpha.5 отказывают `STATE_VERSION_UNSUPPORTED` до записи → откат через копию |
|
|
33
|
-
| alpha.6, хост DevContour (адаптер alpha.4) | — | — | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да | да | да | адаптер DevContour alpha.4 открывает такое состояние без отказа и пишет роль controller и события; новые поля сохраняются → для отката всё равно копия |
|
|
34
|
-
| alpha.7 с новым `inspection` ревью кода | не проверялось | не проверялось | **нет** (строгая схема) | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | — | новые значения `source`, `exitCode: null`, `origins`/`context`/`excluded`; строгая схема alpha.6 их не принимает, поведение прежних версий при открытии не проверялось → откат через копию |
|
|
35
|
-
| alpha.14 с договором проверки `reference` или `gates` обязательства | не проверялось | не проверялось | не проверялось | **нет** (строгая схема) | **нет** (строгая схема) | **нет** (строгая схема) | **нет** (строгая схема) | **нет** (строгая схема) | **нет** (строгая схема) | **нет** (строгая схема) | да | да | да | да | да | да | да | да | — | контракт хранится строгой схемой (`contract-documents`): прежние версии новых полей `gates`, `verification`, `reference` не знают → откат через копию |
|
|
36
|
-
| alpha.17 с `interrupted`, `inputClasses`, `classified`, `neutralFailures`, `alreadySatisfied` в evidence ревью или классом отказа `unfinished`/`needs-lead` | не проверялось | не проверялось | не проверялось | **нет** (строгая схема) | **нет** (строгая схема) | **нет** (строгая схема) | **нет** (строгая схема) | **нет** (строгая схема) | **нет** (строгая схема) | **нет** (строгая схема) | **нет** (строгая схема) | **нет** (строгая схема) | **нет** (строгая схема) | да | да | да | да | да | — | попытка (`interrupted`, `inputClasses`, `classified`), поручение (`neutralFailures`), `alreadySatisfied` evidence ревью и классы отказа `unfinished`, `needs-lead` — новые значения строгих схем; прежние версии их отклоняют → откат через копию |
|
|
37
|
-
| alpha.19 с `recheck` в evidence gate или областью gates длиннее 20 | не проверялось | не проверялось | не проверялось | **нет** (строгая схема) | **нет** (строгая схема) | **нет** (строгая схема) | **нет** (строгая схема) | **нет** (строгая схема) | **нет** (строгая схема) | **нет** (строгая схема) | **нет** (строгая схема) | **нет** (строгая схема) | **нет** (строгая схема) | **нет** (строгая схема) | **нет** (строгая схема) | да | да | да | — | evidence gate и событие `attempt.gate` (`recheck`), области gates поручения, задачи, потребителя и `alreadySatisfied` до 100 — новые значения строгих схем; прежние версии их отклоняют → откат через копию |
|
|
38
|
-
| неизвестная `stateVersion` | нет, отказ до записи | нет, отказ до записи | нет, отказ до записи | нет, отказ до записи | нет, отказ до записи | нет, отказ до записи | нет, отказ до записи | нет, отказ до записи | нет, отказ до записи | нет, отказ до записи | нет, отказ до записи | нет, отказ до записи | нет, отказ до записи | нет, отказ до записи | нет, отказ до записи | нет, отказ до записи | нет, отказ до записи | нет, отказ до записи | нет | `STATE_VERSION_UNSUPPORTED`, exit 4 |
|
|
39
|
-
|
|
40
|
-
Столбец alpha.2 относится и к alpha.3; alpha.4 и alpha.5 читают все строки, кроме неизвестной `stateVersion` и строк alpha.6 с новыми полями (standalone — отказ до записи) и строки alpha.7. alpha.8, alpha.9, alpha.10, alpha.11, alpha.12 и alpha.13 формат состояния не меняют и читают всё, что читает alpha.7; alpha.14 и alpha.15 (локальные, не опубликованы) и alpha.16 читают всё, что читает alpha.13, и добавляют необязательные поля договора проверки (строка alpha.14). alpha.17 читает всё, что читает alpha.16, и добавляет необязательные поля попытки, поручения и evidence ревью и классы отказа `unfinished` и `needs-lead` (строка alpha.17); alpha.18 формат состояния не меняет и читает всё, что читает alpha.17. alpha.19 читает всё, что читает alpha.18, и добавляет необязательное поле `recheck` evidence gate и области gates до 100 (строка alpha.19); alpha.20 и alpha.
|
|
24
|
+
| Состояние, записанное… | Читает 0.1.0-alpha.1 | Читает 0.1.0-alpha.2 | Читает 0.1.0-alpha.6 | Читает 0.1.0-alpha.7 | Читает 0.1.0-alpha.8 | Читает 0.1.0-alpha.9 | Читает 0.1.0-alpha.10 | Читает 0.1.0-alpha.11 | Читает 0.1.0-alpha.12 | Читает 0.1.0-alpha.13 | Читает 0.1.0-alpha.14 | Читает 0.1.0-alpha.15 | Читает 0.1.0-alpha.16 | Читает 0.1.0-alpha.17 | Читает 0.1.0-alpha.18 | Читает 0.1.0-alpha.19 | Читает 0.1.0-alpha.20 | Читает 0.1.0-alpha.21 | Читает 0.1.0-alpha.22 | Читает 0.1.0-alpha.23 | Пишет поверх | Примечание |
|
|
25
|
+
| ----------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------ | ------------------------ | ----------------------- | ----------------------- | ----------------------- | ----------------------- | ----------------------- | ----------------------- | ----------------------- | ----------------------- | ----------------------- | ----------------------- | ----------------------- | ----------------------- | ----------------------- | --------------------- | --------------------- | --------------------- | --------------------- | --------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
|
26
|
+
| standalone `stateVersion: 1` версией alpha.1 | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | одна база SQLite: документ, события, локальные записи |
|
|
27
|
+
| хост, центральная база | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да | данные не переносятся; новые поля необязательны |
|
|
28
|
+
| хост, базы компонентов | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да | нужна копия всех баз при остановленных writers |
|
|
29
|
+
| alpha.2 после штатной остановки controller | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | роль controller снята — нового поля в состоянии нет |
|
|
30
|
+
| alpha.2 с живой или брошенной ролью controller | **нет**, отказ до записи | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | — | роль хранит `engineVersion`; строгая схема alpha.1 его не знает → откат через копию |
|
|
31
|
+
| alpha.4 с совместной проверкой | **нет**, отказ до записи | **нет**, отказ до записи | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | — | проверка хранит `engineVersion`; прежние версии его не знают → откат через копию |
|
|
32
|
+
| alpha.6 standalone с записями ревью нового протокола или доставкой `uncertain` | **нет**, отказ до записи | **нет**, отказ до записи | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | — | `reviewRound`, `findings[].id/status`, статус доставки `uncertain`; alpha.4/alpha.5 отказывают `STATE_VERSION_UNSUPPORTED` до записи → откат через копию |
|
|
33
|
+
| alpha.6, хост DevContour (адаптер alpha.4) | — | — | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да | да | да | да | да | адаптер DevContour alpha.4 открывает такое состояние без отказа и пишет роль controller и события; новые поля сохраняются → для отката всё равно копия |
|
|
34
|
+
| alpha.7 с новым `inspection` ревью кода | не проверялось | не проверялось | **нет** (строгая схема) | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | — | новые значения `source`, `exitCode: null`, `origins`/`context`/`excluded`; строгая схема alpha.6 их не принимает, поведение прежних версий при открытии не проверялось → откат через копию |
|
|
35
|
+
| alpha.14 с договором проверки `reference` или `gates` обязательства | не проверялось | не проверялось | не проверялось | **нет** (строгая схема) | **нет** (строгая схема) | **нет** (строгая схема) | **нет** (строгая схема) | **нет** (строгая схема) | **нет** (строгая схема) | **нет** (строгая схема) | да | да | да | да | да | да | да | да | да | да | — | контракт хранится строгой схемой (`contract-documents`): прежние версии новых полей `gates`, `verification`, `reference` не знают → откат через копию |
|
|
36
|
+
| alpha.17 с `interrupted`, `inputClasses`, `classified`, `neutralFailures`, `alreadySatisfied` в evidence ревью или классом отказа `unfinished`/`needs-lead` | не проверялось | не проверялось | не проверялось | **нет** (строгая схема) | **нет** (строгая схема) | **нет** (строгая схема) | **нет** (строгая схема) | **нет** (строгая схема) | **нет** (строгая схема) | **нет** (строгая схема) | **нет** (строгая схема) | **нет** (строгая схема) | **нет** (строгая схема) | да | да | да | да | да | да | да | — | попытка (`interrupted`, `inputClasses`, `classified`), поручение (`neutralFailures`), `alreadySatisfied` evidence ревью и классы отказа `unfinished`, `needs-lead` — новые значения строгих схем; прежние версии их отклоняют → откат через копию |
|
|
37
|
+
| alpha.19 с `recheck` в evidence gate или областью gates длиннее 20 | не проверялось | не проверялось | не проверялось | **нет** (строгая схема) | **нет** (строгая схема) | **нет** (строгая схема) | **нет** (строгая схема) | **нет** (строгая схема) | **нет** (строгая схема) | **нет** (строгая схема) | **нет** (строгая схема) | **нет** (строгая схема) | **нет** (строгая схема) | **нет** (строгая схема) | **нет** (строгая схема) | да | да | да | да | да | — | evidence gate и событие `attempt.gate` (`recheck`), области gates поручения, задачи, потребителя и `alreadySatisfied` до 100 — новые значения строгих схем; прежние версии их отклоняют → откат через копию |
|
|
38
|
+
| неизвестная `stateVersion` | нет, отказ до записи | нет, отказ до записи | нет, отказ до записи | нет, отказ до записи | нет, отказ до записи | нет, отказ до записи | нет, отказ до записи | нет, отказ до записи | нет, отказ до записи | нет, отказ до записи | нет, отказ до записи | нет, отказ до записи | нет, отказ до записи | нет, отказ до записи | нет, отказ до записи | нет, отказ до записи | нет, отказ до записи | нет, отказ до записи | нет, отказ до записи | нет, отказ до записи | нет | `STATE_VERSION_UNSUPPORTED`, exit 4 |
|
|
39
|
+
|
|
40
|
+
Столбец alpha.2 относится и к alpha.3; alpha.4 и alpha.5 читают все строки, кроме неизвестной `stateVersion` и строк alpha.6 с новыми полями (standalone — отказ до записи) и строки alpha.7. alpha.8, alpha.9, alpha.10, alpha.11, alpha.12 и alpha.13 формат состояния не меняют и читают всё, что читает alpha.7; alpha.14 и alpha.15 (локальные, не опубликованы) и alpha.16 читают всё, что читает alpha.13, и добавляют необязательные поля договора проверки (строка alpha.14). alpha.17 читает всё, что читает alpha.16, и добавляет необязательные поля попытки, поручения и evidence ревью и классы отказа `unfinished` и `needs-lead` (строка alpha.17); alpha.18 формат состояния не меняет и читает всё, что читает alpha.17. alpha.19 читает всё, что читает alpha.18, и добавляет необязательное поле `recheck` evidence gate и области gates до 100 (строка alpha.19); alpha.20, alpha.21, alpha.22 и alpha.23 формат состояния не меняют и читают всё, что читает alpha.19. Каждая следующая версия добавляет сюда свой столбец. Отказ неизвестного
|
|
41
41
|
формата до записи проверяют тесты совместимости пакета
|
|
42
42
|
<!-- repo-only -->(`tests/compatibility.test.ts`)<!-- /repo-only -->.
|
|
43
43
|
|
|
@@ -176,6 +176,7 @@ export function cliAdapter(runtime, options = {}) {
|
|
|
176
176
|
readable: [...(r.sandbox.readable ?? []), ...(review ? [r.cwd] : [])],
|
|
177
177
|
domains: r.sandbox.network.domains,
|
|
178
178
|
...(options.controllerEntries ? { entries: options.controllerEntries } : {}),
|
|
179
|
+
...(r.sandbox.checkouts?.length ? { checkouts: r.sandbox.checkouts } : {}),
|
|
179
180
|
});
|
|
180
181
|
const argv = runtime === 'codex'
|
|
181
182
|
? [
|
|
@@ -49,6 +49,8 @@ export const probeSpec = z.object({
|
|
|
49
49
|
/** Закрытое проверке и открытое на чтение — граница reviewer. */
|
|
50
50
|
controller: z.array(z.string()),
|
|
51
51
|
readable: z.array(z.string()),
|
|
52
|
+
/** Корни рабочих деревьев вне каталога состояния (закрыты целиком). */
|
|
53
|
+
checkouts: z.array(z.string()).optional(),
|
|
52
54
|
isolation: z.object({ mode: z.enum(['os', 'none']), domains: z.array(z.string()) }),
|
|
53
55
|
commandTimeoutMs: z.number().int().min(1000),
|
|
54
56
|
budgetMs: z.number().int().min(1000),
|
|
@@ -367,6 +369,7 @@ export class ReviewProbes {
|
|
|
367
369
|
write: [],
|
|
368
370
|
readable: this.spec.readable,
|
|
369
371
|
controller: this.spec.controller,
|
|
372
|
+
...(this.spec.checkouts?.length ? { checkouts: this.spec.checkouts } : {}),
|
|
370
373
|
// Настройки песочницы — свои у каждого запуска: одновременные
|
|
371
374
|
// вызовы иначе переписывали друг другу границы записи.
|
|
372
375
|
settingsDir: join(this.spec.settingsDir, runId),
|
|
@@ -507,6 +510,7 @@ export class ReviewProbes {
|
|
|
507
510
|
write: [scratch],
|
|
508
511
|
readable: this.spec.readable,
|
|
509
512
|
controller: this.spec.controller,
|
|
513
|
+
...(this.spec.checkouts?.length ? { checkouts: this.spec.checkouts } : {}),
|
|
510
514
|
settingsDir: join(this.spec.settingsDir, runId),
|
|
511
515
|
});
|
|
512
516
|
finished = r;
|
package/lib/cli.js
CHANGED
package/lib/contracts/cli.d.ts
CHANGED
|
@@ -1351,6 +1351,16 @@ export declare const doctorDataSchema: z.ZodObject<{
|
|
|
1351
1351
|
attempts: z.ZodArray<z.ZodString>;
|
|
1352
1352
|
}, z.core.$strict>>;
|
|
1353
1353
|
}, z.core.$strict>>;
|
|
1354
|
+
checkouts: z.ZodOptional<z.ZodObject<{
|
|
1355
|
+
placement: z.ZodEnum<{
|
|
1356
|
+
configured: "configured";
|
|
1357
|
+
"in-place": "in-place";
|
|
1358
|
+
cache: "cache";
|
|
1359
|
+
"cross-volume": "cross-volume";
|
|
1360
|
+
}>;
|
|
1361
|
+
root: z.ZodOptional<z.ZodString>;
|
|
1362
|
+
note: z.ZodOptional<z.ZodString>;
|
|
1363
|
+
}, z.core.$strict>>;
|
|
1354
1364
|
toolchains: z.ZodOptional<z.ZodArray<z.ZodObject<{
|
|
1355
1365
|
repositoryId: z.ZodString;
|
|
1356
1366
|
root: z.ZodString;
|
|
@@ -4005,6 +4015,16 @@ export declare const cliDataSchemas: {
|
|
|
4005
4015
|
attempts: z.ZodArray<z.ZodString>;
|
|
4006
4016
|
}, z.core.$strict>>;
|
|
4007
4017
|
}, z.core.$strict>>;
|
|
4018
|
+
checkouts: z.ZodOptional<z.ZodObject<{
|
|
4019
|
+
placement: z.ZodEnum<{
|
|
4020
|
+
configured: "configured";
|
|
4021
|
+
"in-place": "in-place";
|
|
4022
|
+
cache: "cache";
|
|
4023
|
+
"cross-volume": "cross-volume";
|
|
4024
|
+
}>;
|
|
4025
|
+
root: z.ZodOptional<z.ZodString>;
|
|
4026
|
+
note: z.ZodOptional<z.ZodString>;
|
|
4027
|
+
}, z.core.$strict>>;
|
|
4008
4028
|
toolchains: z.ZodOptional<z.ZodArray<z.ZodObject<{
|
|
4009
4029
|
repositoryId: z.ZodString;
|
|
4010
4030
|
root: z.ZodString;
|
package/lib/contracts/cli.js
CHANGED
|
@@ -644,6 +644,17 @@ export const doctorDataSchema = z.strictObject({
|
|
|
644
644
|
.optional(),
|
|
645
645
|
})
|
|
646
646
|
.optional(),
|
|
647
|
+
/**
|
|
648
|
+
* Корень рабочих деревьев попыток: вне дерева (`cache`, `configured`) или
|
|
649
|
+
* прежнее место (`in-place`, `cross-volume` — кэш на другом томе).
|
|
650
|
+
*/
|
|
651
|
+
checkouts: z
|
|
652
|
+
.strictObject({
|
|
653
|
+
placement: z.enum(['configured', 'in-place', 'cache', 'cross-volume']),
|
|
654
|
+
root: z.string().optional(),
|
|
655
|
+
note: z.string().optional(),
|
|
656
|
+
})
|
|
657
|
+
.optional(),
|
|
647
658
|
/** Диагностика toolchain репозиториев политики; есть, когда задана политика. */
|
|
648
659
|
toolchains: z.array(toolchainReportSchema).optional(),
|
|
649
660
|
problems: z.array(z.string()),
|
package/lib/contracts/ports.d.ts
CHANGED
|
@@ -97,6 +97,12 @@ export interface SandboxSpec {
|
|
|
97
97
|
denied: string[];
|
|
98
98
|
/** Что внутри закрытого снова открыто на чтение (свой worktree внутри каталога состояния). */
|
|
99
99
|
readable?: string[];
|
|
100
|
+
/**
|
|
101
|
+
* Корни рабочих деревьев вне каталога состояния: закрыты целиком, как
|
|
102
|
+
* каталог состояния; свой checkout открыт более конкретным разрешением
|
|
103
|
+
* (`writable`, `readable`).
|
|
104
|
+
*/
|
|
105
|
+
checkouts?: string[];
|
|
100
106
|
network: {
|
|
101
107
|
domains: string[];
|
|
102
108
|
};
|
|
@@ -33,6 +33,8 @@ export declare function moveBase(input: {
|
|
|
33
33
|
policy: ExecutionPolicy;
|
|
34
34
|
baseDir: string;
|
|
35
35
|
stateDir: string;
|
|
36
|
+
/** Корень дерева слияния (`checkout-root.ts`); без него — выбор по каталогу состояния. */
|
|
37
|
+
checkoutRoot?: string;
|
|
36
38
|
only?: Record<string, string>;
|
|
37
39
|
move?: RefMove;
|
|
38
40
|
}): Promise<{
|