devcontour-harness 0.1.0-alpha.20 → 0.1.0-alpha.21
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 +6 -2
- package/docs/quickstart.md +1 -1
- package/docs/release-notes/0.1.0-alpha.21.md +42 -0
- package/docs/upgrade.md +17 -17
- package/lib/environment/isolation.d.ts +9 -1
- package/lib/environment/isolation.js +30 -7
- 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.21` — предварительный выпуск (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.21 # точная версия
|
|
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.21
|
|
127
|
+
|
|
128
|
+
Исправление сверки защищённых путей: пустые служебные каталоги, которые CLI
|
|
129
|
+
исполнителя создаёт рядом с записанными файлами (`.claude/.cc-writes`), больше
|
|
130
|
+
не отклоняют попытку как `scope-violation`. Файл или символьная ссылка внутри
|
|
131
|
+
защищённого пути по-прежнему нарушение. Подробно —
|
|
132
|
+
[заметки выпуска](docs/release-notes/0.1.0-alpha.21.md).
|
|
133
|
+
|
|
126
134
|
## Выпуск 0.1.0-alpha.20
|
|
127
135
|
|
|
128
136
|
Исправление containment: отсоединившийся потомок проверки с очищенным
|
package/docs/architecture.md
CHANGED
|
@@ -585,7 +585,11 @@ executable. Live smoke — отдельный opt-in с явно заданны
|
|
|
585
585
|
проекта, ими не закрыт. До и после каждого gate и вокруг работы исполнителя
|
|
586
586
|
сравнивается снимок защищённых имён вне `node_modules` (каталоги IDE,
|
|
587
587
|
конфигурация shell и git, `.claude`, `.git`); новое или изменённое — класс
|
|
588
|
-
`scope-violation` с путями в сообщении.
|
|
588
|
+
`scope-violation` с путями в сообщении. Дерево из одних пустых каталогов
|
|
589
|
+
(служебный `.claude/.cc-writes` CLI исполнителя) нарушением не считается,
|
|
590
|
+
если до снимка пути не было или он тоже был без файлов; любой файл или
|
|
591
|
+
символьная ссылка внутри, правка прежнего пути с файлами и замена файла
|
|
592
|
+
`.git` каталогом — нарушение.
|
|
589
593
|
- **Классификация отказов песочницы.** Отказ — класс `environment` только
|
|
590
594
|
тогда, когда журнал ядра macOS подтвердил отказ обязательного запрета внутри
|
|
591
595
|
дерева проверки: команда начинается с уникального токена, и записи srt этой
|
|
@@ -601,7 +605,7 @@ core.hooksPath=/dev/null -c protocol.ext.allow=never`: hooks репозитор
|
|
|
601
605
|
коммитах harness не исполняются.
|
|
602
606
|
- **Чего ещё нет.** Регрессионных тестов в песочнице для запретов `.git`, для
|
|
603
607
|
сверки после переноса каталога и для отказа по пределу перечисления пока
|
|
604
|
-
нет: эти пути покрыты только тестами SBX01–
|
|
608
|
+
нет: эти пути покрыты только тестами SBX01–SBX07 и модульными тестами
|
|
605
609
|
`git-trust`.
|
|
606
610
|
- **Секреты.** Значения секретов маскируются во всём сохраняемом: логах,
|
|
607
611
|
артефактах ревью, evidence, событиях и результате.
|
package/docs/quickstart.md
CHANGED
|
@@ -0,0 +1,42 @@
|
|
|
1
|
+
# devcontour-harness 0.1.0-alpha.21
|
|
2
|
+
|
|
3
|
+
Исправление сверки защищённых путей: попытки исполнителя Claude Code снова
|
|
4
|
+
принимаются. Включает всё из [0.1.0-alpha.20](0.1.0-alpha.20.md). Формат
|
|
5
|
+
состояния, gates, правила находок, принятие target ref и `maxAttempts` не
|
|
6
|
+
менялись.
|
|
7
|
+
|
|
8
|
+
## Что исправлено
|
|
9
|
+
|
|
10
|
+
- **Пустые служебные каталоги исполнителя — не нарушение.** С alpha.19
|
|
11
|
+
защищённые имена вне `node_modules` (каталоги IDE, конфигурация shell и git,
|
|
12
|
+
`.claude`, `.git`) сверяются до и после работы исполнителя и каждого gate.
|
|
13
|
+
CLI Claude Code создаёт пустой каталог `.claude/.cc-writes` (права 700) в
|
|
14
|
+
каждом каталоге, где пишет файл, и любая попытка с записью отклонялась как
|
|
15
|
+
`scope-violation` («Исполнитель создал или изменил защищённые пути…»). Теперь
|
|
16
|
+
дерево из одних каталогов, без файлов и символьных ссылок, нарушением не
|
|
17
|
+
считается, если до снимка пути не было или он тоже был без файлов: исполняемой
|
|
18
|
+
конфигурации в нём нет. Правило общее, не только для `.claude`, и действует и
|
|
19
|
+
вокруг исполнителя, и вокруг gates.
|
|
20
|
+
- **Остальное по-прежнему нарушение.** Любой файл или символьная ссылка внутри
|
|
21
|
+
(`.claude/settings.json`, файл в `.claude/.cc-writes/`, `.vscode/tasks.json`),
|
|
22
|
+
любое изменение защищённого пути, где раньше были файлы (в том числе
|
|
23
|
+
`.git/hooks` с образцами), подложенные `.git/config` и hook. Корневой `.git`
|
|
24
|
+
сверяется и как элемент: файл `.git` worktree, заменённый каталогом, —
|
|
25
|
+
нарушение, даже если внутри одни пустые каталоги.
|
|
26
|
+
|
|
27
|
+
## Совместимость
|
|
28
|
+
|
|
29
|
+
Формат состояния и публичный API не меняются. Матрица —
|
|
30
|
+
[upgrade](../upgrade.md).
|
|
31
|
+
|
|
32
|
+
## Проверка выпуска
|
|
33
|
+
|
|
34
|
+
Новые тесты `sandbox-install` SBX06 и SBX07 проверяют сверку снимков: пустые
|
|
35
|
+
`.claude/.cc-writes` в корне и во вложенных каталогах и пустой `.vscode` не
|
|
36
|
+
нарушение; файл, ссылка, правка прежнего `.claude`, hook, замена файла `.git`
|
|
37
|
+
и вложенный `.git`-файл — нарушение. Тест `runner` T05 под песочницей ОС:
|
|
38
|
+
исполнитель, оставивший `.claude/.cc-writes`, принимается; добавивший
|
|
39
|
+
`.claude/settings.json` — `scope-violation`. Мутанты обнаруживаются: без
|
|
40
|
+
исправления падают SBX06 и T05, правило «любой `.claude` разрешён» — SBX06,
|
|
41
|
+
без отдельной подписи корневого `.git` — SBX07. Полный `npm run check`.
|
|
42
|
+
Живые модели не вызывались.
|
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 | Пишет поверх | Примечание |
|
|
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 формат состояния не
|
|
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.21 формат состояния не меняют и читают всё, что читает alpha.19. Каждая следующая версия добавляет сюда свой столбец. Отказ неизвестного
|
|
41
41
|
формата до записи проверяют тесты совместимости пакета
|
|
42
42
|
<!-- repo-only -->(`tests/compatibility.test.ts`)<!-- /repo-only -->.
|
|
43
43
|
|
|
@@ -175,7 +175,15 @@ export declare function sandboxDenials(violations: SandboxViolation[], policy: I
|
|
|
175
175
|
* закрыты; сверка снимков до и после проверки находит такой результат.
|
|
176
176
|
*/
|
|
177
177
|
export declare function protectedSnapshot(root: string): Map<string, string>;
|
|
178
|
-
/**
|
|
178
|
+
/**
|
|
179
|
+
* Защищённые пути, которые появились или изменились после снимка `before`.
|
|
180
|
+
*
|
|
181
|
+
* Пустые каталоги (только каталоги, рекурсивно) нарушением не считаются,
|
|
182
|
+
* если до снимка пути не было или он тоже был без файлов: исполняемой
|
|
183
|
+
* конфигурации в них нет, а CLI исполнителя создаёт такие служебные каталоги
|
|
184
|
+
* (`.claude/.cc-writes`) рядом с каждым записанным файлом. Путь, где раньше
|
|
185
|
+
* были файлы, по-прежнему нарушение при любом изменении.
|
|
186
|
+
*/
|
|
179
187
|
export declare function protectedChanges(before: Map<string, string>, root: string): string[];
|
|
180
188
|
/**
|
|
181
189
|
* Команда проверки внутри sandbox-runtime.
|
|
@@ -439,6 +439,8 @@ export function sandboxDenials(violations, policy) {
|
|
|
439
439
|
/** Имена, которые проверка и исполнитель не создают и не меняют. */
|
|
440
440
|
const protectedNames = new Set([...DANGEROUS_FILES, ...ideDirectories, '.claude', '.git']);
|
|
441
441
|
const snapshotLimit = 200_000;
|
|
442
|
+
/** Подпись каталога, в дереве которого нет ни файлов, ни символьных ссылок. */
|
|
443
|
+
const emptyTree = 'd:empty';
|
|
442
444
|
/**
|
|
443
445
|
* Защищённые элементы checkout вне `node_modules`: путь → подпись.
|
|
444
446
|
*
|
|
@@ -467,10 +469,13 @@ export function protectedSnapshot(root) {
|
|
|
467
469
|
return 'l:' + readlinkSync(path);
|
|
468
470
|
if (!stat.isDirectory())
|
|
469
471
|
return `f:${stat.size}:${stat.mtimeMs}:${stat.ino}`;
|
|
470
|
-
const
|
|
471
|
-
|
|
472
|
-
|
|
473
|
-
|
|
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(',')}]`;
|
|
474
479
|
};
|
|
475
480
|
const walk = (dir) => {
|
|
476
481
|
let entries;
|
|
@@ -485,7 +490,10 @@ export function protectedSnapshot(root) {
|
|
|
485
490
|
const path = join(dir, entry.name);
|
|
486
491
|
if (entry.name === '.git' && dir === root && entry.isDirectory()) {
|
|
487
492
|
// Обычный `.git`: объекты и индекс меняет и git хоста; сверяются
|
|
488
|
-
// только конфигурация, hooks и перенаправления.
|
|
493
|
+
// только конфигурация, hooks и перенаправления. Сам вид элемента
|
|
494
|
+
// тоже: файл `.git` worktree, заменённый каталогом, — изменение,
|
|
495
|
+
// даже если внутри одни пустые каталоги.
|
|
496
|
+
found.set(path, 'd:git');
|
|
489
497
|
for (const name of ['config', 'hooks', ...gitRedirects])
|
|
490
498
|
found.set(join(path, name), signature(join(path, name)));
|
|
491
499
|
continue;
|
|
@@ -501,11 +509,26 @@ export function protectedSnapshot(root) {
|
|
|
501
509
|
walk(root);
|
|
502
510
|
return found;
|
|
503
511
|
}
|
|
504
|
-
/**
|
|
512
|
+
/**
|
|
513
|
+
* Защищённые пути, которые появились или изменились после снимка `before`.
|
|
514
|
+
*
|
|
515
|
+
* Пустые каталоги (только каталоги, рекурсивно) нарушением не считаются,
|
|
516
|
+
* если до снимка пути не было или он тоже был без файлов: исполняемой
|
|
517
|
+
* конфигурации в них нет, а CLI исполнителя создаёт такие служебные каталоги
|
|
518
|
+
* (`.claude/.cc-writes`) рядом с каждым записанным файлом. Путь, где раньше
|
|
519
|
+
* были файлы, по-прежнему нарушение при любом изменении.
|
|
520
|
+
*/
|
|
505
521
|
export function protectedChanges(before, root) {
|
|
506
522
|
const after = protectedSnapshot(root);
|
|
507
523
|
return [...after]
|
|
508
|
-
.filter(([path, sig]) =>
|
|
524
|
+
.filter(([path, sig]) => {
|
|
525
|
+
if (sig === 'missing')
|
|
526
|
+
return false;
|
|
527
|
+
const was = before.get(path) ?? 'missing';
|
|
528
|
+
if (sig === emptyTree && (was === 'missing' || was === emptyTree))
|
|
529
|
+
return false;
|
|
530
|
+
return was !== sig;
|
|
531
|
+
})
|
|
509
532
|
.map(([path]) => path);
|
|
510
533
|
}
|
|
511
534
|
/**
|
package/package.json
CHANGED