devcontour-harness 0.1.0-alpha.21 → 0.1.0-alpha.22
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 +10 -2
- package/docs/architecture.md +10 -1
- package/docs/quickstart.md +1 -1
- package/docs/release-notes/0.1.0-alpha.22.md +57 -0
- package/docs/upgrade.md +17 -17
- package/lib/engine/runner.js +25 -3
- package/lib/environment/isolation.d.ts +19 -5
- package/lib/environment/isolation.js +90 -29
- package/lib/verification/gates.js +12 -1
- 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.22` — предварительный выпуск (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.22 # точная версия
|
|
32
32
|
# или: npm install --save-exact devcontour-harness@alpha # текущая alpha
|
|
33
33
|
npx harness --version
|
|
34
34
|
```
|
|
@@ -123,6 +123,14 @@ PASS» нет. Адаптеры хоста реализуют порты `Execut
|
|
|
123
123
|
`devcontour-harness/schemas/<имя>.schema.json`. Декларации используют типы
|
|
124
124
|
Node.js: TypeScript-потребителю нужен `@types/node` (или `skipLibCheck`).
|
|
125
125
|
|
|
126
|
+
## Выпуск 0.1.0-alpha.22
|
|
127
|
+
|
|
128
|
+
Ужесточение сверки защищённых путей: имена сравниваются без регистра
|
|
129
|
+
(`.Claude/settings.json` на APFS — то же, что `.claude/settings.json`), путь,
|
|
130
|
+
который сверка не может прочитать, — отказ с путём в сообщении, а не пропуск,
|
|
131
|
+
пустой защищённый каталог, открытый на запись всем, и FIFO внутри —
|
|
132
|
+
нарушение. Подробно — [заметки выпуска](docs/release-notes/0.1.0-alpha.22.md).
|
|
133
|
+
|
|
126
134
|
## Выпуск 0.1.0-alpha.21
|
|
127
135
|
|
|
128
136
|
Исправление сверки защищённых путей: пустые служебные каталоги, которые 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/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`. Живые модели не вызывались.
|
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 | Пишет поверх | Примечание |
|
|
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.19. Каждая следующая версия добавляет сюда свой столбец. Отказ неизвестного
|
|
41
41
|
формата до записи проверяют тесты совместимости пакета
|
|
42
42
|
<!-- repo-only -->(`tests/compatibility.test.ts`)<!-- /repo-only -->.
|
|
43
43
|
|
package/lib/engine/runner.js
CHANGED
|
@@ -5,7 +5,7 @@ import { mkdir, readFile, readdir, realpath, rm, writeFile } from 'node:fs/promi
|
|
|
5
5
|
import { isAbsolute, join, relative, resolve } from 'node:path';
|
|
6
6
|
import { roleBinding, selectReviewer, mcpEnvironment, HarnessError, digestOf, contextDigest, implementationResultSchema, codeReviewHistory, codeReviewScope, checkCodeReview, logicalReview, DEFAULT_REVIEW_PROTOCOL_RETRIES, reviewResultSchema, sha256, } from "../contracts/index.js";
|
|
7
7
|
import { git, hostGitArgs } from "../environment/process.js";
|
|
8
|
-
import { protectedChanges, protectedSnapshot } from "../environment/isolation.js";
|
|
8
|
+
import { protectedChanges, protectedSnapshot, SandboxPolicyError, } from "../environment/isolation.js";
|
|
9
9
|
import { executionEnvironment, runSteps, withEnvironment } from "../environment/lifecycle.js";
|
|
10
10
|
import { redactDeep } from "../environment/redaction.js";
|
|
11
11
|
import { alreadySatisfiedReviewOutputSchema, implementationOutputSchema, reviewOutputSchema, } from "../agents/schemas.js";
|
|
@@ -766,7 +766,18 @@ export class Runner {
|
|
|
766
766
|
// Защищённые пути до работы исполнителя: перенос каталога,
|
|
767
767
|
// собранного там, где запрет песочницы не действует, виден
|
|
768
768
|
// только сверкой.
|
|
769
|
-
|
|
769
|
+
// Непрочитанный до работы путь — отказ среды: исполнитель
|
|
770
|
+
// его ещё не трогал.
|
|
771
|
+
let guarded;
|
|
772
|
+
try {
|
|
773
|
+
if (this.policy.isolation.mode === 'os')
|
|
774
|
+
guarded = protectedSnapshot(cwd);
|
|
775
|
+
}
|
|
776
|
+
catch (error) {
|
|
777
|
+
if (error instanceof SandboxPolicyError)
|
|
778
|
+
throw new TaskFailure('environment', error.message);
|
|
779
|
+
throw error;
|
|
780
|
+
}
|
|
770
781
|
const response = await this.call(this.adapter(attempt.runtime), {
|
|
771
782
|
task: 'implement',
|
|
772
783
|
attempt,
|
|
@@ -804,7 +815,18 @@ export class Runner {
|
|
|
804
815
|
result.data.summary.slice(0, 500));
|
|
805
816
|
this.engine.heartbeat(attempt.id, attempt.token);
|
|
806
817
|
signal.throwIfAborted();
|
|
807
|
-
|
|
818
|
+
// После работы непрочитанный путь закрыл исполнитель —
|
|
819
|
+
// нарушение области, как и созданный защищённый путь.
|
|
820
|
+
let planted = [];
|
|
821
|
+
try {
|
|
822
|
+
if (guarded)
|
|
823
|
+
planted = protectedChanges(guarded, cwd);
|
|
824
|
+
}
|
|
825
|
+
catch (error) {
|
|
826
|
+
if (error instanceof SandboxPolicyError)
|
|
827
|
+
throw new TaskFailure('scope-violation', error.message);
|
|
828
|
+
throw error;
|
|
829
|
+
}
|
|
808
830
|
if (planted.length)
|
|
809
831
|
throw new TaskFailure('scope-violation', 'Исполнитель создал или изменил защищённые пути (конфигурация IDE, shell, git или Claude): ' +
|
|
810
832
|
planted
|
|
@@ -114,6 +114,15 @@ export declare function isolationSupport(): {
|
|
|
114
114
|
* «кроме node_modules», поэтому дерево перечисляется: новый каталог глубже
|
|
115
115
|
* существующего уровня не закрыт (у srt на Linux закрыты только уже
|
|
116
116
|
* существующие файлы до глубины 3).
|
|
117
|
+
* - Регистр. Правила srt (`subpath`, `regex`) записаны в нижнем регистре, но
|
|
118
|
+
* Seatbelt на нечувствительном к регистру томе (APFS по умолчанию)
|
|
119
|
+
* сравнивает путь без регистра: проба под песочницей отказывает в записи в
|
|
120
|
+
* `.IDEA/x`, `.VSCode/x`, `.Bashrc`, `.Claude/commands/x` и `x/.GIT/hooks/x`
|
|
121
|
+
* так же, как в именах нижнего регистра. На Linux ФС обычно различает
|
|
122
|
+
* регистр, и `.Claude` хост не читает как `.claude`. Имена, которых в
|
|
123
|
+
* запретах нет (`.claude/settings.json` в любом регистре), и пути глубже
|
|
124
|
+
* перечисленных уровней ловит сверка снимков (`protectedSnapshot`) — она
|
|
125
|
+
* сравнивает имена без регистра везде.
|
|
117
126
|
*
|
|
118
127
|
* Путь с символами глоба нельзя записать шаблоном без риска не совпасть ни
|
|
119
128
|
* с чем; тогда возвращается `undefined`, и srt остаётся в прежнем каталоге с
|
|
@@ -178,11 +187,16 @@ export declare function protectedSnapshot(root: string): Map<string, string>;
|
|
|
178
187
|
/**
|
|
179
188
|
* Защищённые пути, которые появились или изменились после снимка `before`.
|
|
180
189
|
*
|
|
181
|
-
*
|
|
182
|
-
*
|
|
183
|
-
*
|
|
184
|
-
*
|
|
185
|
-
*
|
|
190
|
+
* Путь, который сверка не может прочитать (кроме ENOENT), — `SandboxPolicyError`
|
|
191
|
+
* из снимка, а не пропуск: вызывающий решает, отказ ли это среды (снимок до
|
|
192
|
+
* работы) или нарушение области (после).
|
|
193
|
+
*
|
|
194
|
+
* Пустые каталоги (только каталоги, рекурсивно, без записи всем)
|
|
195
|
+
* нарушением не считаются, если до снимка пути не было или он тоже был без
|
|
196
|
+
* файлов: исполняемой конфигурации в них нет, а CLI исполнителя создаёт
|
|
197
|
+
* такие служебные каталоги (`.claude/.cc-writes`) рядом с каждым записанным
|
|
198
|
+
* файлом. Путь, где раньше были файлы, по-прежнему нарушение при любом
|
|
199
|
+
* изменении.
|
|
186
200
|
*/
|
|
187
201
|
export declare function protectedChanges(before: Map<string, string>, root: string): string[];
|
|
188
202
|
/**
|
|
@@ -220,6 +220,15 @@ export function isolationSupport() {
|
|
|
220
220
|
* «кроме node_modules», поэтому дерево перечисляется: новый каталог глубже
|
|
221
221
|
* существующего уровня не закрыт (у srt на Linux закрыты только уже
|
|
222
222
|
* существующие файлы до глубины 3).
|
|
223
|
+
* - Регистр. Правила srt (`subpath`, `regex`) записаны в нижнем регистре, но
|
|
224
|
+
* Seatbelt на нечувствительном к регистру томе (APFS по умолчанию)
|
|
225
|
+
* сравнивает путь без регистра: проба под песочницей отказывает в записи в
|
|
226
|
+
* `.IDEA/x`, `.VSCode/x`, `.Bashrc`, `.Claude/commands/x` и `x/.GIT/hooks/x`
|
|
227
|
+
* так же, как в именах нижнего регистра. На Linux ФС обычно различает
|
|
228
|
+
* регистр, и `.Claude` хост не читает как `.claude`. Имена, которых в
|
|
229
|
+
* запретах нет (`.claude/settings.json` в любом регистре), и пути глубже
|
|
230
|
+
* перечисленных уровней ловит сверка снимков (`protectedSnapshot`) — она
|
|
231
|
+
* сравнивает имена без регистра везде.
|
|
223
232
|
*
|
|
224
233
|
* Путь с символами глоба нельзя записать шаблоном без риска не совпасть ни
|
|
225
234
|
* с чем; тогда возвращается `undefined`, и srt остаётся в прежнем каталоге с
|
|
@@ -331,7 +340,11 @@ export function mandatoryDenyRule(policy, path) {
|
|
|
331
340
|
const root = policy.write.find((w) => path === w || path.startsWith(w + sep));
|
|
332
341
|
if (!root)
|
|
333
342
|
return undefined;
|
|
334
|
-
const
|
|
343
|
+
const raw = relative(root, path).split(sep);
|
|
344
|
+
// Seatbelt на нечувствительном к регистру томе (APFS по умолчанию) отказывает
|
|
345
|
+
// и в `.IDEA/x`, и в `.Claude/commands`: имена сравниваются без регистра.
|
|
346
|
+
// `node_modules` — как в перечислении `protectedWriteDenies`, точно.
|
|
347
|
+
const parts = raw.map((p) => p.toLowerCase());
|
|
335
348
|
const at = (i, ...names) => names.every((n, k) => parts[i + k] === n);
|
|
336
349
|
const rule = (what) => `обязательный запрет записи sandbox-runtime: ${what}`;
|
|
337
350
|
for (let i = 0; i < parts.length; i++) {
|
|
@@ -339,18 +352,18 @@ export function mandatoryDenyRule(policy, path) {
|
|
|
339
352
|
if (DANGEROUS_FILES.includes(name) && i === parts.length - 1)
|
|
340
353
|
return rule(name);
|
|
341
354
|
// Каталоги IDE внутри дерева зависимостей открыты (`protectedWriteDenies`).
|
|
342
|
-
if (ideDirectories.includes(name) && !
|
|
355
|
+
if (ideDirectories.includes(name) && !raw.slice(0, i).includes('node_modules'))
|
|
343
356
|
return rule(`каталог IDE ${name}`);
|
|
344
357
|
if (at(i, '.git', 'hooks') || at(i, '.git', 'config'))
|
|
345
|
-
return rule(
|
|
358
|
+
return rule(raw.slice(i, i + 2).join('/'));
|
|
346
359
|
if (name === '.git' && i === 0 && parts.length === 1)
|
|
347
360
|
return rule('файл .git рабочего дерева');
|
|
348
361
|
if (name === '.git' && i === 0 && gitRedirects.includes(parts[1] ?? ''))
|
|
349
|
-
return rule(`.git/${
|
|
362
|
+
return rule(`.git/${raw[1]}`);
|
|
350
363
|
if (name === '.git' && i > 0)
|
|
351
364
|
return rule('вложенный репозиторий .git');
|
|
352
365
|
if (at(i, '.claude', 'commands') || at(i, '.claude', 'agents'))
|
|
353
|
-
return rule(
|
|
366
|
+
return rule(raw.slice(i, i + 2).join('/'));
|
|
354
367
|
}
|
|
355
368
|
return undefined;
|
|
356
369
|
}
|
|
@@ -436,11 +449,31 @@ export function sandboxDenials(violations, policy) {
|
|
|
436
449
|
}
|
|
437
450
|
return [...found].map(([path, rule]) => ({ path, rule }));
|
|
438
451
|
}
|
|
439
|
-
/**
|
|
452
|
+
/**
|
|
453
|
+
* Имена, которые проверка и исполнитель не создают и не меняют.
|
|
454
|
+
*
|
|
455
|
+
* Сравниваются без регистра на любой платформе: на APFS и NTFS `.Claude`,
|
|
456
|
+
* `.VSCode` или `.Bashrc` хост читает как `.claude`, `.vscode`, `.bashrc`.
|
|
457
|
+
* На чувствительной к регистру ФС такое имя никто не читает, но и создавать
|
|
458
|
+
* его незачем — лишняя строгость дешевле развилки по ФС.
|
|
459
|
+
*/
|
|
440
460
|
const protectedNames = new Set([...DANGEROUS_FILES, ...ideDirectories, '.claude', '.git']);
|
|
461
|
+
const isProtected = (name) => protectedNames.has(name.toLowerCase());
|
|
441
462
|
const snapshotLimit = 200_000;
|
|
442
|
-
/**
|
|
463
|
+
/**
|
|
464
|
+
* Подпись каталога, в дереве которого нет ни файлов, ни символьных ссылок, и
|
|
465
|
+
* ни один каталог не открыт на запись всем (`mode & 0o002`): такой каталог —
|
|
466
|
+
* место, куда любой пользователь положит конфигурацию после сверки. Запись
|
|
467
|
+
* группе разрешена: при umask 002 (общие и dev-машины) CLI исполнителя
|
|
468
|
+
* создаёт `.claude` с правами 775.
|
|
469
|
+
*/
|
|
443
470
|
const emptyTree = 'd:empty';
|
|
471
|
+
/** Ошибка доступа к пути, которую сверка не может обойти: отказ, а не пропуск. */
|
|
472
|
+
const unreadable = (root, path, error) => {
|
|
473
|
+
const code = error?.code ?? String(error);
|
|
474
|
+
throw new SandboxPolicyError(`сверка защищённых путей не выполнена: нет доступа к ${relative(root, path) || '.'} (${code}) — путь, который нельзя прочитать, мог скрыть конфигурацию IDE, shell, git или Claude`);
|
|
475
|
+
};
|
|
476
|
+
const missing = (error) => error?.code === 'ENOENT';
|
|
444
477
|
/**
|
|
445
478
|
* Защищённые элементы checkout вне `node_modules`: путь → подпись.
|
|
446
479
|
*
|
|
@@ -459,36 +492,59 @@ export function protectedSnapshot(root) {
|
|
|
459
492
|
const signature = (path) => {
|
|
460
493
|
count();
|
|
461
494
|
let stat;
|
|
495
|
+
// Только ENOENT значит «пути нет». Любой другой отказ (EACCES под
|
|
496
|
+
// каталогом без права поиска, каталог mode 000) — отказ сверки: иначе
|
|
497
|
+
// `chmod 0444 sub` спрятал бы `sub/.claude/settings.json`.
|
|
462
498
|
try {
|
|
463
499
|
stat = lstatSync(path);
|
|
464
500
|
}
|
|
465
|
-
catch {
|
|
466
|
-
|
|
501
|
+
catch (error) {
|
|
502
|
+
if (missing(error))
|
|
503
|
+
return 'missing';
|
|
504
|
+
return unreadable(root, path, error);
|
|
505
|
+
}
|
|
506
|
+
try {
|
|
507
|
+
if (stat.isSymbolicLink())
|
|
508
|
+
return 'l:' + readlinkSync(path);
|
|
509
|
+
// Не каталог и не ссылка — файл, FIFO, сокет, устройство: всё это
|
|
510
|
+
// содержимое, пустым деревом не бывает.
|
|
511
|
+
if (!stat.isDirectory())
|
|
512
|
+
return `f:${stat.size}:${stat.mtimeMs}:${stat.ino}`;
|
|
513
|
+
const mode = stat.mode & 0o7777;
|
|
514
|
+
const names = readdirSync(path).sort();
|
|
515
|
+
const inner = names.map((name) => signature(join(path, name)));
|
|
516
|
+
// Дерево из одних закрытых для чужой записи каталогов не несёт ни
|
|
517
|
+
// конфигурации, ни ссылки наружу: его подпись одна для любого такого
|
|
518
|
+
// дерева (см. `protectedChanges`). Открытый всем каталог
|
|
519
|
+
// подписывается с правами и потому виден как изменение.
|
|
520
|
+
if ((mode & 0o002) === 0 && inner.every((sig) => sig === emptyTree))
|
|
521
|
+
return emptyTree;
|
|
522
|
+
return `d:${stat.ino}:${mode.toString(8)}[${names.map((name, i) => `${name}=${inner[i]}`).join(',')}]`;
|
|
523
|
+
}
|
|
524
|
+
catch (error) {
|
|
525
|
+
if (error instanceof SandboxPolicyError)
|
|
526
|
+
throw error;
|
|
527
|
+
if (missing(error))
|
|
528
|
+
return 'missing';
|
|
529
|
+
return unreadable(root, path, error);
|
|
467
530
|
}
|
|
468
|
-
if (stat.isSymbolicLink())
|
|
469
|
-
return 'l:' + readlinkSync(path);
|
|
470
|
-
if (!stat.isDirectory())
|
|
471
|
-
return `f:${stat.size}:${stat.mtimeMs}:${stat.ino}`;
|
|
472
|
-
const names = readdirSync(path).sort();
|
|
473
|
-
const inner = names.map((name) => signature(join(path, name)));
|
|
474
|
-
// Дерево из одних каталогов не несёт ни конфигурации, ни ссылки наружу:
|
|
475
|
-
// его подпись одна для любого такого дерева (см. `protectedChanges`).
|
|
476
|
-
if (inner.every((sig) => sig === emptyTree))
|
|
477
|
-
return emptyTree;
|
|
478
|
-
return `d:${stat.ino}[${names.map((name, i) => `${name}=${inner[i]}`).join(',')}]`;
|
|
479
531
|
};
|
|
480
532
|
const walk = (dir) => {
|
|
481
533
|
let entries;
|
|
482
534
|
try {
|
|
483
535
|
entries = readdirSync(dir, { withFileTypes: true });
|
|
484
536
|
}
|
|
485
|
-
catch {
|
|
486
|
-
|
|
537
|
+
catch (error) {
|
|
538
|
+
// Исчезнувший каталог сверять нечего; непрочитанный мог спрятать
|
|
539
|
+
// защищённое имя — отказ.
|
|
540
|
+
if (missing(error))
|
|
541
|
+
return;
|
|
542
|
+
return unreadable(root, dir, error);
|
|
487
543
|
}
|
|
488
544
|
for (const entry of entries) {
|
|
489
545
|
count();
|
|
490
546
|
const path = join(dir, entry.name);
|
|
491
|
-
if (entry.name === '.git' && dir === root && entry.isDirectory()) {
|
|
547
|
+
if (entry.name.toLowerCase() === '.git' && dir === root && entry.isDirectory()) {
|
|
492
548
|
// Обычный `.git`: объекты и индекс меняет и git хоста; сверяются
|
|
493
549
|
// только конфигурация, hooks и перенаправления. Сам вид элемента
|
|
494
550
|
// тоже: файл `.git` worktree, заменённый каталогом, — изменение,
|
|
@@ -498,7 +554,7 @@ export function protectedSnapshot(root) {
|
|
|
498
554
|
found.set(join(path, name), signature(join(path, name)));
|
|
499
555
|
continue;
|
|
500
556
|
}
|
|
501
|
-
if (
|
|
557
|
+
if (isProtected(entry.name)) {
|
|
502
558
|
found.set(path, signature(path));
|
|
503
559
|
continue;
|
|
504
560
|
}
|
|
@@ -512,11 +568,16 @@ export function protectedSnapshot(root) {
|
|
|
512
568
|
/**
|
|
513
569
|
* Защищённые пути, которые появились или изменились после снимка `before`.
|
|
514
570
|
*
|
|
515
|
-
*
|
|
516
|
-
*
|
|
517
|
-
*
|
|
518
|
-
*
|
|
519
|
-
*
|
|
571
|
+
* Путь, который сверка не может прочитать (кроме ENOENT), — `SandboxPolicyError`
|
|
572
|
+
* из снимка, а не пропуск: вызывающий решает, отказ ли это среды (снимок до
|
|
573
|
+
* работы) или нарушение области (после).
|
|
574
|
+
*
|
|
575
|
+
* Пустые каталоги (только каталоги, рекурсивно, без записи всем)
|
|
576
|
+
* нарушением не считаются, если до снимка пути не было или он тоже был без
|
|
577
|
+
* файлов: исполняемой конфигурации в них нет, а CLI исполнителя создаёт
|
|
578
|
+
* такие служебные каталоги (`.claude/.cc-writes`) рядом с каждым записанным
|
|
579
|
+
* файлом. Путь, где раньше были файлы, по-прежнему нарушение при любом
|
|
580
|
+
* изменении.
|
|
520
581
|
*/
|
|
521
582
|
export function protectedChanges(before, root) {
|
|
522
583
|
const after = protectedSnapshot(root);
|
|
@@ -511,7 +511,18 @@ export async function runGate(run) {
|
|
|
511
511
|
});
|
|
512
512
|
exitCode = result.code;
|
|
513
513
|
log += result.stdout + '\n' + result.stderr;
|
|
514
|
-
|
|
514
|
+
// Путь, который после проверки не прочитать, проверка и закрыла: это
|
|
515
|
+
// нарушение области, а не отказ среды (снимок до проверки прочитался).
|
|
516
|
+
let planted = [];
|
|
517
|
+
try {
|
|
518
|
+
if (before)
|
|
519
|
+
planted = protectedChanges(before, root);
|
|
520
|
+
}
|
|
521
|
+
catch (error) {
|
|
522
|
+
if (error instanceof SandboxPolicyError)
|
|
523
|
+
kind = 'scope-violation';
|
|
524
|
+
throw error instanceof SandboxPolicyError ? new Error(error.message) : error;
|
|
525
|
+
}
|
|
515
526
|
if (planted.length) {
|
|
516
527
|
kind = 'scope-violation';
|
|
517
528
|
throw new Error('проверка создала или изменила защищённые пути (конфигурация IDE, shell, git или Claude): ' +
|
package/package.json
CHANGED