devcontour-harness 0.1.0-alpha.23 → 0.1.0-alpha.25
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 +46 -2
- package/docs/architecture.md +26 -1
- package/docs/quickstart.md +1 -1
- package/docs/release-notes/0.1.0-alpha.24.md +49 -0
- package/docs/release-notes/0.1.0-alpha.25.md +33 -0
- package/docs/upgrade.md +29 -17
- package/lib/contracts/ports.d.ts +17 -0
- package/lib/control/doctor.js +1 -0
- package/lib/engine/engine.js +4 -2
- package/lib/engine/prompt.js +8 -2
- package/lib/environment/checkout-root.d.ts +3 -2
- package/lib/environment/checkout-root.js +15 -6
- package/lib/environment/git-trust.js +3 -1
- package/lib/environment/isolation.d.ts +2 -1
- package/lib/environment/isolation.js +16 -2
- package/lib/environment/process.js +16 -7
- package/lib/verification/gates.js +10 -5
- package/lib/verification/joint.d.ts +120 -1
- package/lib/verification/joint.js +38 -1
- package/package.json +5 -2
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.25` — предварительный выпуск (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.25 # точная версия
|
|
32
32
|
# или: npm install --save-exact devcontour-harness@alpha # текущая alpha
|
|
33
33
|
npx harness --version
|
|
34
34
|
```
|
|
@@ -123,6 +123,23 @@ PASS» нет. Адаптеры хоста реализуют порты `Execut
|
|
|
123
123
|
`devcontour-harness/schemas/<имя>.schema.json`. Декларации используют типы
|
|
124
124
|
Node.js: TypeScript-потребителю нужен `@types/node` (или `skipLibCheck`).
|
|
125
125
|
|
|
126
|
+
## Выпуск 0.1.0-alpha.25
|
|
127
|
+
|
|
128
|
+
Native reviewer получает явное `previous: []` при пустой истории находок;
|
|
129
|
+
валидный JUnit сохраняется и при ненулевом коде gate. Хост может закрепить
|
|
130
|
+
границу бюджета успешно принятого цикла совместной проверки без сброса
|
|
131
|
+
попыток новым ID или сменой политики. Подробно —
|
|
132
|
+
[заметки выпуска](docs/release-notes/0.1.0-alpha.25.md).
|
|
133
|
+
|
|
134
|
+
## Выпуск 0.1.0-alpha.24
|
|
135
|
+
|
|
136
|
+
Диагностика корня рабочих деревьев ничего не создаёт; новые корни и их
|
|
137
|
+
родители создаются с правами 0700, в том числе при отсутствующем каталоге
|
|
138
|
+
кэша пользователя. Корень не может содержать репозиторий или состояние.
|
|
139
|
+
Отказ чтения учётных данных не переводится в класс `environment` даже при
|
|
140
|
+
поиске файла вверх по дереву. Подробно —
|
|
141
|
+
[заметки выпуска](docs/release-notes/0.1.0-alpha.24.md).
|
|
142
|
+
|
|
126
143
|
## Выпуск 0.1.0-alpha.23
|
|
127
144
|
|
|
128
145
|
Рабочие деревья попыток вне дерева человека: если каталог состояния лежит
|
|
@@ -364,6 +381,33 @@ npm run check # lint, typecheck, схемы, сборка, тесты,
|
|
|
364
381
|
npm run format:check
|
|
365
382
|
```
|
|
366
383
|
|
|
384
|
+
Три уровня проверки — от итерации над исправлением до выпуска:
|
|
385
|
+
|
|
386
|
+
| Уровень | Команда | Что запускает |
|
|
387
|
+
| --------------------- | ----------------------------------------- | -------------------------------------------------------------------------------------- |
|
|
388
|
+
| На каждое исправление | `npm run test:affected [-- --base <ref>]` | тест-файлы, в статическое замыкание которых входит изменённый файл |
|
|
389
|
+
| Быстрый | `npm run test:fast` | весь suite без медленного яруса (тесты дольше ~60 с) |
|
|
390
|
+
| Полный release check | `npm run check` | lint, typecheck, схемы, сборка, весь suite с полным размером оракулов, проверка архива |
|
|
391
|
+
|
|
392
|
+
- `test:affected` сравнивает с merge-base с `master` (или с `--base`) и
|
|
393
|
+
учитывает индекс, рабочее дерево и неотслеживаемые файлы. Замыкание идёт
|
|
394
|
+
от `tests/*.test.ts` по относительным путям (`import`, `import()`,
|
|
395
|
+
`new URL(…)`) через helpers и `src/`; barrel-модули уточняются по
|
|
396
|
+
импортированным именам. Изменение вне `src/` и `tests/*.test.ts`
|
|
397
|
+
(package.json, tsconfig, scripts, helpers и fixtures тестов, profiles,
|
|
398
|
+
schemas, docs), удалённый или недостижимый файл `src/` — весь suite.
|
|
399
|
+
Выбор и причина печатаются перед запуском. `npm run check:fast` —
|
|
400
|
+
статические шаги и `test:affected`.
|
|
401
|
+
- Медленный ярус — список `slowTests` в `scripts/test.mjs` (начала имён
|
|
402
|
+
тестов). `npm test` и `npm run check` выполняют его, как и раньше.
|
|
403
|
+
- Оракул H1 (`tests/explain-differential.test.ts`) сохраняет 100
|
|
404
|
+
детерминированных случаев в обычном, выборочном и полном прогоне
|
|
405
|
+
(`DIFF_N` переопределяет); быстрый ярус явно исключает этот тест.
|
|
406
|
+
- Статические шаги `npm run check` (lint, typecheck, schemas:check) идут
|
|
407
|
+
параллельно; сборка, тесты и проверка архива — после них, по очереди.
|
|
408
|
+
- Все режимы запускают тесты одинаково: отдельный процесс на файл, tsx, не
|
|
409
|
+
более четырёх файлов одновременно.
|
|
410
|
+
|
|
367
411
|
Тесты используют настоящие временные Git-репозитории, SQLite и fixture
|
|
368
412
|
executables CLI codex/claude; живые модели не вызываются. Результаты
|
|
369
413
|
fixture-тестов не являются проверкой качества моделей.
|
package/docs/architecture.md
CHANGED
|
@@ -167,6 +167,19 @@ runtime-граф пакета.
|
|
|
167
167
|
(`BasisProvider.jointPolicyDigest/jointSpecDigest`); продуктовые условия
|
|
168
168
|
каждой записи — `HostGuards.joint`. `jointResult(workIds, id)` оценивает
|
|
169
169
|
указанную проверку.
|
|
170
|
+
- **Бюджет принятого цикла.** Без дополнения хоста `maxAttempts` ограничивает
|
|
171
|
+
всю историю одного набора поручений. Хост может передать через
|
|
172
|
+
`BasisProvider.jointBudgetCheckpoints` принятые им успешные проверки и
|
|
173
|
+
неизменяемые снимки IDs завершённых проверок на момент принятия. Движок
|
|
174
|
+
проверяет каждую границу: успешная проверка и весь непустой снимок должны
|
|
175
|
+
существовать, принадлежать тому же набору и быть завершены; снимок включает
|
|
176
|
+
саму принятую проверку, без повторов. Вне объединения этих снимков все
|
|
177
|
+
следующие проверки набора разделяют общий предел. Один PASS без принятия,
|
|
178
|
+
новый ID набора хоста, смена политики или постановки бюджет не закрывают.
|
|
179
|
+
Хост отвечает за доверенную локальную acceptance и сохранение снимка;
|
|
180
|
+
активные проверки в него не входят. Hook выполняется внутри транзакции
|
|
181
|
+
начала: ошибка откатывает всю запись. Снимки бюджета не заменяют gates,
|
|
182
|
+
доказательства на SHA или основание оптимизации `affected`.
|
|
170
183
|
- **Расход ревью плана.** Вызов о графе закрепляет за расходом группу и
|
|
171
184
|
поручения из входного графа — и до его регистрации; повтор после
|
|
172
185
|
исчерпания бюджета поручения или группы отклоняется до вызова.
|
|
@@ -605,11 +618,23 @@ executable. Live smoke — отдельный opt-in с явно заданны
|
|
|
605
618
|
проверки отличаются от чужих. Текст вывода свидетельством не служит, запись
|
|
606
619
|
вне дерева — ошибка кода (`gate`). На Linux такого свидетельства нет, и
|
|
607
620
|
отказ остаётся `gate`.
|
|
621
|
+
- **Корень рабочих деревьев.** При состоянии внутри репозитория checkout
|
|
622
|
+
размещается в кэше пользователя вне дерева; хост может задать
|
|
623
|
+
`checkoutRoot`. Корень не должен ни лежать внутри репозитория, состояния
|
|
624
|
+
или закрытого пути, ни содержать их. Новые каталоги корня и недостающие
|
|
625
|
+
родители создаются с mode 0700; существующие каталоги пользователя не
|
|
626
|
+
меняются. `doctor` рассчитывает корень без создания каталогов. Отказ
|
|
627
|
+
чтения конфигурации в предке рабочего каталога может стать `environment`
|
|
628
|
+
только при подтверждении журналом ядра и EPERM с путём в выводе;
|
|
629
|
+
учётные данные (в том числе `~/.npmrc`) всегда исключены из этого правила.
|
|
630
|
+
Закрытие соседних деревьев запрещает чтение их содержимого. Оно не скрывает
|
|
631
|
+
само существование пути: на macOS разные ответы ENOENT/EPERM могут раскрыть
|
|
632
|
+
этот факт. Это ограничение песочницы, а не гарантия конфиденциальности имён.
|
|
608
633
|
- **Git хоста над деревом проверки.** Каждый вызов git хоста сначала сверяет,
|
|
609
634
|
куда git придёт: файл `.git` дерева, созданного `worktree add`, не изменён;
|
|
610
635
|
gitdir и общий каталог лежат вне дерева и согласованы; `commondir`/`gitdir`
|
|
611
636
|
в обычном `.git` и вложенный репозиторий внутри известного дерева — отказ
|
|
612
|
-
(`scope-violation` в gate). Поверх — `-c core.fsmonitor=
|
|
637
|
+
(`scope-violation` в gate). Поверх — `-c core.fsmonitor= -c
|
|
613
638
|
core.hooksPath=/dev/null -c protocol.ext.allow=never`: hooks репозитория при
|
|
614
639
|
коммитах harness не исполняются.
|
|
615
640
|
- **Чего ещё нет.** Регрессионных тестов в песочнице для запретов `.git`, для
|
package/docs/quickstart.md
CHANGED
|
@@ -0,0 +1,49 @@
|
|
|
1
|
+
# devcontour-harness 0.1.0-alpha.24
|
|
2
|
+
|
|
3
|
+
Исправления выбора корня рабочих деревьев и диагностики после alpha.23.
|
|
4
|
+
Форматы состояния и политики, публичные поля API и обязательные проверки
|
|
5
|
+
приёмки не меняются.
|
|
6
|
+
|
|
7
|
+
## Изменения
|
|
8
|
+
|
|
9
|
+
- **Диагностика без записи.** `harness doctor` рассчитывает корень checkout,
|
|
10
|
+
проверяет существующие каталоги и сообщает выбранное размещение, не
|
|
11
|
+
создавая кэш, заданный корень или их родителей.
|
|
12
|
+
- **Отдельный корень.** Заданный `checkoutRoot` не может быть предком
|
|
13
|
+
репозитория, каталога состояния или закрытого пути. Как прежде, он не
|
|
14
|
+
может лежать внутри них. Символическая ссылка вместо заданного корня и
|
|
15
|
+
ошибки чтения его метаданных отклоняются; отсутствие каталога допустимо.
|
|
16
|
+
- **Права и отсутствующий кэш.** Новый корень и недостающие родители
|
|
17
|
+
создаются с mode 0700, включая заданный хостом корень. На Linux отсутствие
|
|
18
|
+
`~/.cache` больше не возвращает рабочие деревья внутрь репозитория;
|
|
19
|
+
недостающие каталоги кэша создаются. Права существующих каталогов
|
|
20
|
+
пользователя не меняются.
|
|
21
|
+
- **Класс отказа чтения.** Учётные данные исключены из перевода отказа в
|
|
22
|
+
`environment`: чтение `~/.npmrc`, `~/.netrc` и других защищённых путей
|
|
23
|
+
остаётся ошибкой gate, даже если путь лежит в предке cwd и журнал ядра
|
|
24
|
+
подтверждает отказ. Это не меняет само запрещение чтения.
|
|
25
|
+
|
|
26
|
+
## Совместимость и ограничения
|
|
27
|
+
|
|
28
|
+
Для обновления и отката применяются прежние правила `engineVersion`:
|
|
29
|
+
остановить writers, сохранить копию состояния, проверить её новой версией
|
|
30
|
+
и возобновить одним controller. Состояние не преобразуется; alpha.23
|
|
31
|
+
читает записи alpha.24. Хостам с корнем-предком или ссылкой вместо корня
|
|
32
|
+
нужно указать отдельный каталог. Матрица — [обновление](../upgrade.md).
|
|
33
|
+
|
|
34
|
+
Содержимое соседних рабочих деревьев закрыто песочницей. На macOS различие
|
|
35
|
+
ENOENT и EPERM может раскрыть существование пути; скрытие имён или самого
|
|
36
|
+
факта существования не гарантируется. Проверка ОС выполняется на macOS;
|
|
37
|
+
Linux-выбор корня покрывается проверками путей и файловой системы, без
|
|
38
|
+
заявления о запуске Linux-песочницы.
|
|
39
|
+
|
|
40
|
+
## Проверки
|
|
41
|
+
|
|
42
|
+
CR14 проверяет исключение всех известных путей учётных данных из класса
|
|
43
|
+
`environment`; CR15 — корни-предки, создание с mode 0700 и отказ по ссылке;
|
|
44
|
+
CR16 — создание отсутствующих родителей кэша и выбор без записи на macOS
|
|
45
|
+
и Linux. Тест doctor проверяет отсутствие новых файлов и каталогов после
|
|
46
|
+
диагностики кэша и явно заданного корня. Прежние CR01–CR13 проверяют
|
|
47
|
+
изолированные Git-деревья, gates обеих фаз, проверку на SHA, перенос базы
|
|
48
|
+
и закрытие соседней попытки. Выпускной маршрут — `npm run check`, включая
|
|
49
|
+
установку архива и цикл на fixture runtime; живые модели для него не нужны.
|
|
@@ -0,0 +1,33 @@
|
|
|
1
|
+
# devcontour-harness 0.1.0-alpha.25
|
|
2
|
+
|
|
3
|
+
Уточнение запроса ревью, сохранение отчётов упавших проверок и необязательная
|
|
4
|
+
граница бюджета принятых циклов для хостов. Форматы состояния и политики,
|
|
5
|
+
обязательные gates, fencing и привязка доказательств к SHA не меняются.
|
|
6
|
+
|
|
7
|
+
## Изменения
|
|
8
|
+
|
|
9
|
+
- **Пустая история находок.** Native reviewer явно получает требование
|
|
10
|
+
`previous: []`, если controller ещё не выдавал находок. Ошибки прежних
|
|
11
|
+
попыток и наблюдения gates остаются диагностическим контекстом; их нельзя
|
|
12
|
+
превращать в ссылки на придуманные ID. Строгая проверка ответа и повтор
|
|
13
|
+
после ошибки протокола сохраняются.
|
|
14
|
+
- **Отчёт при ненулевом коде.** Читаемый валидный JUnit сохраняется рядом с
|
|
15
|
+
логом gate и при ненулевом коде команды, с прежней проверкой границ пути
|
|
16
|
+
и маскированием секретов. Отчёт не превращает отказ в успех и не меняет
|
|
17
|
+
класс настоящего отказа песочницы.
|
|
18
|
+
- **Бюджет принятого цикла.** Опциональный
|
|
19
|
+
`BasisProvider.jointBudgetCheckpoints` сообщает успешно принятые хостом
|
|
20
|
+
проверки и неизменяемые снимки IDs завершённых проверок на момент принятия.
|
|
21
|
+
Движок проверяет границы и считает все последующие попытки того же набора
|
|
22
|
+
вне объединения снимков. Новый ID набора, политика или постановка бюджет
|
|
23
|
+
не закрывают; одного PASS без принятия недостаточно. Без hook действует
|
|
24
|
+
прежний предел всей истории набора. Хост отвечает за доверенную локальную
|
|
25
|
+
acceptance и сохранение снимка; активные проверки в снимок не входят.
|
|
26
|
+
|
|
27
|
+
## Обновление
|
|
28
|
+
|
|
29
|
+
Пакет alpha.24 остаётся неизменным. Перед обновлением остановите writers и
|
|
30
|
+
сохраните копию состояния. Активные попытки и совместные проверки закреплены
|
|
31
|
+
за начавшей их версией движка: новая версия их не продолжает. Преобразование
|
|
32
|
+
состояния не требуется. Новые сведения о продуктовой acceptance хранит хост;
|
|
33
|
+
hook не выдаёт перенесённую историю за локальный запуск проверок.
|
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 | Читает 0.1.0-alpha.22 | Читает 0.1.0-alpha.23 | Пишет поверх
|
|
25
|
-
| ----------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------ | ------------------------ | ----------------------- | ----------------------- | ----------------------- | ----------------------- | ----------------------- | ----------------------- | ----------------------- | ----------------------- | ----------------------- | ----------------------- | ----------------------- | ----------------------- | ----------------------- | --------------------- | --------------------- | --------------------- | --------------------- | --------------------- |
|
|
26
|
-
| standalone `stateVersion: 1` версией alpha.1 | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да
|
|
27
|
-
| хост, центральная база | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да
|
|
28
|
-
| хост, базы компонентов | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да
|
|
29
|
-
| alpha.2 после штатной остановки controller | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да
|
|
30
|
-
| alpha.2 с живой или брошенной ролью controller | **нет**, отказ до записи | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | —
|
|
31
|
-
| alpha.4 с совместной проверкой | **нет**, отказ до записи | **нет**, отказ до записи | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | —
|
|
32
|
-
| alpha.6 standalone с записями ревью нового протокола или доставкой `uncertain` | **нет**, отказ до записи | **нет**, отказ до записи | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | —
|
|
33
|
-
| alpha.6, хост DevContour (адаптер alpha.4) | — | — | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да | да | да | да | да | адаптер DevContour alpha.4 открывает такое состояние без отказа и пишет роль controller и события; новые поля сохраняются → для отката всё равно копия
|
|
34
|
-
| alpha.7 с новым `inspection` ревью кода | не проверялось | не проверялось | **нет** (строгая схема) | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | —
|
|
35
|
-
| alpha.14 с договором проверки `reference` или `gates` обязательства | не проверялось | не проверялось | не проверялось | **нет** (строгая схема) | **нет** (строгая схема) | **нет** (строгая схема) | **нет** (строгая схема) | **нет** (строгая схема) | **нет** (строгая схема) | **нет** (строгая схема) | да | да | да | да | да | да | да | да | да | да | —
|
|
36
|
-
| alpha.17 с `interrupted`, `inputClasses`, `classified`, `neutralFailures`, `alreadySatisfied` в evidence ревью или классом отказа `unfinished`/`needs-lead` | не проверялось | не проверялось | не проверялось | **нет** (строгая схема) | **нет** (строгая схема) | **нет** (строгая схема) | **нет** (строгая схема) | **нет** (строгая схема) | **нет** (строгая схема) | **нет** (строгая схема) | **нет** (строгая схема) | **нет** (строгая схема) | **нет** (строгая схема) | да | да | да | да | да | да | да | —
|
|
37
|
-
| alpha.19 с `recheck` в evidence gate или областью gates длиннее 20 | не проверялось | не проверялось | не проверялось | **нет** (строгая схема) | **нет** (строгая схема) | **нет** (строгая схема) | **нет** (строгая схема) | **нет** (строгая схема) | **нет** (строгая схема) | **нет** (строгая схема) | **нет** (строгая схема) | **нет** (строгая схема) | **нет** (строгая схема) | **нет** (строгая схема) | **нет** (строгая схема) | да | да | да | да | да | —
|
|
38
|
-
| неизвестная `stateVersion` | нет, отказ до записи | нет, отказ до записи | нет, отказ до записи | нет, отказ до записи | нет, отказ до записи | нет, отказ до записи | нет, отказ до записи | нет, отказ до записи | нет, отказ до записи | нет, отказ до записи | нет, отказ до записи | нет, отказ до записи | нет, отказ до записи | нет, отказ до записи | нет, отказ до записи | нет, отказ до записи | нет, отказ до записи | нет, отказ до записи | нет, отказ до записи | нет, отказ до записи | нет
|
|
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.
|
|
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 | Читает 0.1.0-alpha.24 | Пишет поверх | Примечание |
|
|
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.24 формат состояния не меняют и читают всё, что читает alpha.19. Каждая следующая версия добавляет сюда свой столбец. Отказ неизвестного
|
|
41
41
|
формата до записи проверяют тесты совместимости пакета
|
|
42
42
|
<!-- repo-only -->(`tests/compatibility.test.ts`)<!-- /repo-only -->.
|
|
43
43
|
|
|
@@ -155,6 +155,18 @@ recovery.
|
|
|
155
155
|
поля; признак выполнения — `mode`, а не наличие кода 0. Откат — как для alpha.6: только
|
|
156
156
|
восстановлением копии состояния, сделанной до обновления.
|
|
157
157
|
|
|
158
|
+
### alpha.24: выбор корня и диагностика
|
|
159
|
+
|
|
160
|
+
Форматы состояния, политики и публичные поля API прежние. Диагностика
|
|
161
|
+
`doctor` не создаёт каталоги корня рабочих деревьев. Корень, заданный
|
|
162
|
+
хостом, отклоняется, если он содержит репозиторий, каталог состояния или
|
|
163
|
+
закрытый путь; символическая ссылка вместо корня тоже отклоняется.
|
|
164
|
+
Назначьте отдельный каталог рядом с ними. Новые каталоги создаются с mode
|
|
165
|
+
0700, существующие права не меняются. Состояние alpha.24 читает alpha.23;
|
|
166
|
+
при откате возвращается прежнее поведение выбора корня и классификации
|
|
167
|
+
отказа чтения учётных данных. Подробнее —
|
|
168
|
+
[заметки выпуска](release-notes/0.1.0-alpha.24.md).
|
|
169
|
+
|
|
158
170
|
## Перед обновлением
|
|
159
171
|
|
|
160
172
|
1. **Остановить записывающих.** Запретить новые выдачи (`harness pause`),
|
package/lib/contracts/ports.d.ts
CHANGED
|
@@ -295,6 +295,13 @@ export interface ResultSink {
|
|
|
295
295
|
result: RunResult;
|
|
296
296
|
}): Promise<DeliveryOutcome>;
|
|
297
297
|
}
|
|
298
|
+
/** Принятая доверенным хостом граница завершённого цикла совместной проверки. */
|
|
299
|
+
export interface JointBudgetCheckpoint {
|
|
300
|
+
/** Успешная проверка, которую хост действительно принял. */
|
|
301
|
+
readonly verificationId: string;
|
|
302
|
+
/** Неизменяемый снимок завершённых проверок при принятии, включая verificationId. */
|
|
303
|
+
readonly settledVerificationIds: readonly string[];
|
|
304
|
+
}
|
|
298
305
|
/**
|
|
299
306
|
* Основания согласования и попыток. Формулы digest — договор хоста:
|
|
300
307
|
* DevContour вычисляет их по сохранённым формулам (они включают поля
|
|
@@ -326,6 +333,16 @@ export interface BasisProvider {
|
|
|
326
333
|
* сверяется; при начале проверки её ещё нет.
|
|
327
334
|
*/
|
|
328
335
|
jointSpecDigest?(workIds: string[], view: ExecutionView, verificationId?: string): string;
|
|
336
|
+
/**
|
|
337
|
+
* Принятые хостом циклы проверки этого набора. Только доверенная локальная
|
|
338
|
+
* acceptance закрывает их бюджет: один passed без принятия недостаточен.
|
|
339
|
+
* Снимки фиксируются при acceptance и не расширяются при чтении. Все
|
|
340
|
+
* последующие проверки набора разделяют бюджет вне объединения снимков,
|
|
341
|
+
* независимо от ID набора хоста, политики, постановки и порядка истории.
|
|
342
|
+
* Без hook сохраняется предел всей истории sameWorks. Вызывается внутри
|
|
343
|
+
* транзакции jointStart; исключение откатывает начало проверки.
|
|
344
|
+
*/
|
|
345
|
+
jointBudgetCheckpoints?(workIds: string[], view: ExecutionView): readonly JointBudgetCheckpoint[];
|
|
329
346
|
/**
|
|
330
347
|
* Основание эпизода разбора по свойству (постановка и контракты поручения)
|
|
331
348
|
* по формуле хоста; без неё — формула harness (`episodeBasis`). Хост с
|
package/lib/control/doctor.js
CHANGED
|
@@ -107,6 +107,7 @@ checkouts) {
|
|
|
107
107
|
stateDirs: [stateDir],
|
|
108
108
|
repositories: policy.repositories.map((r) => isAbsolute(r.path) ? r.path : resolve(checkouts.baseDir, r.path)),
|
|
109
109
|
hidden: credentialPaths(),
|
|
110
|
+
create: false,
|
|
110
111
|
...(checkouts.checkoutRoot ? { configured: checkouts.checkoutRoot } : {}),
|
|
111
112
|
})
|
|
112
113
|
: undefined;
|
package/lib/engine/engine.js
CHANGED
|
@@ -11,7 +11,7 @@ import { contractDocuments, corpusBindingHolds, effectiveChecks, episodeBasis, o
|
|
|
11
11
|
import { afterFailure, afterSuccess, blocksClaim, closeIfBasisChanged, } from "./property-recovery.js";
|
|
12
12
|
import { REQUIREMENT_GATE } from "../verification/requirements.js";
|
|
13
13
|
import { pinnedCorpus, propertyProofProblem } from "../verification/acceptance.js";
|
|
14
|
-
import { jointImpact, jointPolicyDigest, jointSpecDigest, publicJoint, sameWorks, } from "../verification/joint.js";
|
|
14
|
+
import { jointImpact, jointPolicyDigest, jointSpecDigest, publicJoint, sameWorks, jointBudgetAttempts, } from "../verification/joint.js";
|
|
15
15
|
/** Префикс причины неудавшегося продления: первая причина не затирается следствиями. */
|
|
16
16
|
export const HEARTBEAT_FAILED = 'Продление владения не удалось';
|
|
17
17
|
const iso = (ms) => new Date(ms).toISOString();
|
|
@@ -2070,7 +2070,9 @@ export class Engine {
|
|
|
2070
2070
|
payload: { verificationId: v.id, status: 'failed', error },
|
|
2071
2071
|
});
|
|
2072
2072
|
}
|
|
2073
|
-
const previous = tx
|
|
2073
|
+
const previous = jointBudgetAttempts(tx, input.workIds, this.host.basis.jointBudgetCheckpoints
|
|
2074
|
+
? this.host.basis.jointBudgetCheckpoints([...input.workIds], tx)
|
|
2075
|
+
: []);
|
|
2074
2076
|
if (previous.length >= this.policy.maxAttempts)
|
|
2075
2077
|
throw new HarnessError('ATTEMPTS_EXHAUSTED', 'Исчерпан предел совместных проверок этого набора');
|
|
2076
2078
|
const works = input.workIds.map((id) => tx.work(id));
|
package/lib/engine/prompt.js
CHANGED
|
@@ -24,8 +24,12 @@ export const CLOSED_FINDINGS_HEADER = 'Closed or withdrawn review findings (hist
|
|
|
24
24
|
* writer — открытые находки, которые нужно устранить.
|
|
25
25
|
*/
|
|
26
26
|
export function findingsText(history, review) {
|
|
27
|
-
if (!history
|
|
27
|
+
if (!history)
|
|
28
28
|
return '';
|
|
29
|
+
if (!history.findings.length)
|
|
30
|
+
return review
|
|
31
|
+
? 'There are no controller-issued review findings. Return `previous` as exactly []. Historical attempt errors and gate observations are not review findings: do not invent or compute ids for them.'
|
|
32
|
+
: '';
|
|
29
33
|
const open = history.findings.filter((f) => f.status === 'open');
|
|
30
34
|
const closed = history.findings.filter((f) => f.status !== 'open');
|
|
31
35
|
const brief = (f) => ({
|
|
@@ -108,7 +112,9 @@ export function prompt(input) {
|
|
|
108
112
|
JSON.stringify(attempt.dependencies)
|
|
109
113
|
: '',
|
|
110
114
|
'Gates that prove this work: ' + JSON.stringify(input.gates),
|
|
111
|
-
|
|
115
|
+
(review && input.findings
|
|
116
|
+
? 'Historical attempt errors and gate observations (diagnostic context only). Only controller-issued ids in the review findings sections below may appear in `previous`; do not derive ids from this history: '
|
|
117
|
+
: 'Previous attempts, with the findings each review left. Address every finding that is still open first and say what you changed for it: ') +
|
|
112
118
|
JSON.stringify(previousAttempts(input.history, attempt.id)),
|
|
113
119
|
findingsText(input.findings, !!review),
|
|
114
120
|
!review && attempt.continuedFrom?.applied
|
|
@@ -13,7 +13,8 @@
|
|
|
13
13
|
*
|
|
14
14
|
* Поэтому корень рабочих деревьев выбирается так:
|
|
15
15
|
* - корень, заданный хостом (`checkoutRoot`), — как есть, если он не внутри
|
|
16
|
-
* репозитория, закрытого пути или каталога состояния
|
|
16
|
+
* репозитория, закрытого пути или каталога состояния и не содержит их
|
|
17
|
+
* (иначе отказ); недостающий корень и его родители создаются с mode 0700;
|
|
17
18
|
* - каталог состояния внутри репозитория политики или внутри закрытого
|
|
18
19
|
* песочницей пути — каталог кэша пользователя вне дерева: macOS
|
|
19
20
|
* `~/Library/Caches/devcontour-harness/<hash>`, Linux
|
|
@@ -56,7 +57,7 @@ export interface CheckoutRootInput {
|
|
|
56
57
|
/** Номер тома пути (`stat.dev`); тест подменяет его. */
|
|
57
58
|
device?: (path: string) => number | undefined;
|
|
58
59
|
/**
|
|
59
|
-
* Создать
|
|
60
|
+
* Создать корень и недостающих родителей (0700). Без записи (`false`, диагностика) —
|
|
60
61
|
* только проверка существующих.
|
|
61
62
|
*/
|
|
62
63
|
create?: boolean;
|
|
@@ -14,7 +14,7 @@ export function realish(path) {
|
|
|
14
14
|
return parent === absolute ? absolute : join(realish(parent), basename(absolute));
|
|
15
15
|
}
|
|
16
16
|
}
|
|
17
|
-
const within = (path, root) => path === root || path.startsWith(root + sep);
|
|
17
|
+
const within = (path, root) => path === root || path.startsWith(root.endsWith(sep) ? root : root + sep);
|
|
18
18
|
/** Номер тома ближайшего существующего предка пути. */
|
|
19
19
|
function deviceOf(path) {
|
|
20
20
|
for (let dir = resolve(path);; dir = dirname(dir)) {
|
|
@@ -47,11 +47,13 @@ function unsafeDir(path, create, uid) {
|
|
|
47
47
|
try {
|
|
48
48
|
stat = lstatSync(path);
|
|
49
49
|
}
|
|
50
|
-
catch {
|
|
50
|
+
catch (error) {
|
|
51
|
+
if (error.code !== 'ENOENT')
|
|
52
|
+
return `${path} не прочитан: ${error.code ?? String(error)}`;
|
|
51
53
|
if (!create)
|
|
52
54
|
return undefined;
|
|
53
55
|
try {
|
|
54
|
-
mkdirSync(path, { mode: 0o700 });
|
|
56
|
+
mkdirSync(path, { recursive: true, mode: 0o700 });
|
|
55
57
|
stat = lstatSync(path);
|
|
56
58
|
}
|
|
57
59
|
catch (error) {
|
|
@@ -73,6 +75,7 @@ export function chooseCheckoutRoot(input) {
|
|
|
73
75
|
// Корень внутри репозитория, закрытого пути или каталога состояния вернул
|
|
74
76
|
// бы ту же вложенность (или открыл бы закрытое).
|
|
75
77
|
const enclosing = (root) => [...repos, ...hidden, ...states].find((p) => within(root, p));
|
|
78
|
+
const enclosed = (root) => [...repos, ...hidden, ...states].find((p) => within(p, root));
|
|
76
79
|
const uid = input.uid !== undefined ? input.uid : process.getuid?.();
|
|
77
80
|
const create = input.create ?? true;
|
|
78
81
|
if (input.configured) {
|
|
@@ -80,7 +83,10 @@ export function chooseCheckoutRoot(input) {
|
|
|
80
83
|
const inside = enclosing(root);
|
|
81
84
|
if (inside)
|
|
82
85
|
throw new HarnessError('INVALID_INPUT', `checkoutRoot ${root} внутри ${inside}: корень рабочих деревьев должен лежать вне репозиториев, закрытых путей и каталога состояния`);
|
|
83
|
-
const
|
|
86
|
+
const contains = enclosed(root);
|
|
87
|
+
if (contains)
|
|
88
|
+
throw new HarnessError('INVALID_INPUT', `checkoutRoot ${root} содержит ${contains}: корень рабочих деревьев не должен быть предком репозиториев, закрытых путей или каталога состояния`);
|
|
89
|
+
const unsafe = unsafeDir(resolve(input.configured), create, uid);
|
|
84
90
|
if (unsafe)
|
|
85
91
|
throw new HarnessError('INVALID_INPUT', 'checkoutRoot: ' + unsafe);
|
|
86
92
|
return { root, placement: 'configured' };
|
|
@@ -99,6 +105,9 @@ export function chooseCheckoutRoot(input) {
|
|
|
99
105
|
const inside = enclosing(realish(root));
|
|
100
106
|
if (inside)
|
|
101
107
|
return stay(`каталог кэша ${root} внутри ${inside}`);
|
|
108
|
+
const contains = enclosed(realish(root));
|
|
109
|
+
if (contains)
|
|
110
|
+
return stay(`каталог кэша ${root} содержит ${contains}`);
|
|
102
111
|
const device = input.device ?? deviceOf;
|
|
103
112
|
const at = device(root);
|
|
104
113
|
const other = repos.find((r) => {
|
|
@@ -110,8 +119,8 @@ export function chooseCheckoutRoot(input) {
|
|
|
110
119
|
placement: 'cross-volume',
|
|
111
120
|
note: `каталог кэша ${root} на другом томе, чем репозиторий ${other}: жёсткие ссылки и reflink менеджера пакетов там не работают, рабочие деревья остаются в каталоге состояния ${nested} (внутри закрытого дерева инструменты, ищущие конфигурацию вверх по дереву, получат EPERM); задайте checkoutRoot на томе репозитория`,
|
|
112
121
|
};
|
|
113
|
-
//
|
|
114
|
-
//
|
|
122
|
+
// Недостающие родители кэша создаются с теми же закрытыми правами;
|
|
123
|
+
// существующие каталоги пользователя не меняются.
|
|
115
124
|
for (const dir of [base, root]) {
|
|
116
125
|
const unsafe = unsafeDir(dir, create, uid);
|
|
117
126
|
if (unsafe)
|
|
@@ -20,7 +20,9 @@ import { basename, dirname, join, resolve, sep } from 'node:path';
|
|
|
20
20
|
*/
|
|
21
21
|
export const gitHardening = [
|
|
22
22
|
'-c',
|
|
23
|
-
'
|
|
23
|
+
// Older Git treats 'false' as a hook executable; empty disables the hook
|
|
24
|
+
// there and is false for versions supporting the built-in fsmonitor.
|
|
25
|
+
'core.fsmonitor=',
|
|
24
26
|
'-c',
|
|
25
27
|
'core.hooksPath=/dev/null',
|
|
26
28
|
'-c',
|
|
@@ -192,7 +192,8 @@ export declare function hiddenReadRule(policy: Isolation, path: string): string
|
|
|
192
192
|
* вверх по дереву и на EPERM (в отличие от ENOENT) падают. Нужны все
|
|
193
193
|
* признаки — запись ядра для тега этой проверки, форма поиска вверх
|
|
194
194
|
* (каталог файла — строгий предок `cwd`) и EPERM с этим путём в выводе
|
|
195
|
-
* (`output`).
|
|
195
|
+
* (`output`). Учётные данные исключены даже при такой форме пути
|
|
196
|
+
* (`~/.npmrc` тоже лежит в предке checkout). Чтение другого закрытого пути (`~/.ssh/id_rsa`), отказ,
|
|
196
197
|
* который проверка пережила, и обычный провал тестов отказом среды не
|
|
197
198
|
* становятся: отказ среды не тратит попытку и останавливает очередь.
|
|
198
199
|
*/
|
|
@@ -461,13 +461,23 @@ const mentions = (output, path) => output.includes(path) ||
|
|
|
461
461
|
* вверх по дереву и на EPERM (в отличие от ENOENT) падают. Нужны все
|
|
462
462
|
* признаки — запись ядра для тега этой проверки, форма поиска вверх
|
|
463
463
|
* (каталог файла — строгий предок `cwd`) и EPERM с этим путём в выводе
|
|
464
|
-
* (`output`).
|
|
464
|
+
* (`output`). Учётные данные исключены даже при такой форме пути
|
|
465
|
+
* (`~/.npmrc` тоже лежит в предке checkout). Чтение другого закрытого пути (`~/.ssh/id_rsa`), отказ,
|
|
465
466
|
* который проверка пережила, и обычный провал тестов отказом среды не
|
|
466
467
|
* становятся: отказ среды не тратит попытку и останавливает очередь.
|
|
467
468
|
*/
|
|
468
469
|
export function sandboxDenials(violations, policy, output, cwd) {
|
|
469
470
|
const found = new Map();
|
|
470
471
|
const eperm = output !== undefined && /\bEPERM\b|operation not permitted/i.test(output);
|
|
472
|
+
const credentials = credentialPaths().flatMap((path) => {
|
|
473
|
+
try {
|
|
474
|
+
return [path, realpathSync(path)];
|
|
475
|
+
}
|
|
476
|
+
catch {
|
|
477
|
+
return [path];
|
|
478
|
+
}
|
|
479
|
+
});
|
|
480
|
+
const credential = (path) => credentials.some((root) => path === root || path.startsWith(root + sep));
|
|
471
481
|
// Поиск вверх: файл лежит прямо в строгом предке рабочего каталога.
|
|
472
482
|
const walkUp = (path) => cwd !== undefined && cwd.startsWith(dirname(path) + sep);
|
|
473
483
|
for (const v of violations) {
|
|
@@ -475,7 +485,11 @@ export function sandboxDenials(violations, policy, output, cwd) {
|
|
|
475
485
|
continue;
|
|
476
486
|
const rule = v.operation.startsWith('file-write')
|
|
477
487
|
? mandatoryDenyRule(policy, v.path)
|
|
478
|
-
: v.operation.startsWith('file-read') &&
|
|
488
|
+
: v.operation.startsWith('file-read') &&
|
|
489
|
+
!credential(v.path) &&
|
|
490
|
+
eperm &&
|
|
491
|
+
walkUp(v.path) &&
|
|
492
|
+
mentions(output, v.path)
|
|
479
493
|
? hiddenReadRule(policy, v.path)
|
|
480
494
|
: undefined;
|
|
481
495
|
if (rule)
|
|
@@ -149,13 +149,22 @@ export async function command(argv, cwd, options = {}) {
|
|
|
149
149
|
return;
|
|
150
150
|
}
|
|
151
151
|
if (mark) {
|
|
152
|
-
|
|
153
|
-
|
|
154
|
-
|
|
155
|
-
|
|
156
|
-
|
|
157
|
-
|
|
158
|
-
|
|
152
|
+
let pipeTimer;
|
|
153
|
+
try {
|
|
154
|
+
const bounded = await Promise.race([
|
|
155
|
+
closed.then(() => true),
|
|
156
|
+
new Promise((r) => {
|
|
157
|
+
pipeTimer = setTimeout(() => r(false), 3000);
|
|
158
|
+
}),
|
|
159
|
+
]);
|
|
160
|
+
if (!bounded) {
|
|
161
|
+
child.stdout.destroy();
|
|
162
|
+
child.stderr.destroy();
|
|
163
|
+
}
|
|
164
|
+
}
|
|
165
|
+
finally {
|
|
166
|
+
if (pipeTimer)
|
|
167
|
+
clearTimeout(pipeTimer);
|
|
159
168
|
}
|
|
160
169
|
}
|
|
161
170
|
const rest = stdoutDecoder.end();
|
|
@@ -537,6 +537,16 @@ export async function runGate(run) {
|
|
|
537
537
|
if (result.timedOut || signal.aborted)
|
|
538
538
|
throw new Error('Проверка прервана или превысила timeout');
|
|
539
539
|
if (result.code !== 0) {
|
|
540
|
+
// Сохраняем валидный отчёт и при отказе команды, до классификации
|
|
541
|
+
// песочницы: после очистки worktree иначе остаётся только хвост лога.
|
|
542
|
+
const counts = reportPath
|
|
543
|
+
? await readReport(reportPath, cwd, redact).catch(() => undefined)
|
|
544
|
+
: undefined;
|
|
545
|
+
if (counts) {
|
|
546
|
+
manifest = counts;
|
|
547
|
+
await mkdir(artifactDir, { recursive: true });
|
|
548
|
+
await writeFile(join(artifactDir, `${gate.id}.xml`), redact(counts.xml));
|
|
549
|
+
}
|
|
540
550
|
const blocked = run.policy.isolation.mode === 'os'
|
|
541
551
|
? sandboxBlockedHosts(result.stdout + '\n' + result.stderr, run.policy.isolation.domains)
|
|
542
552
|
: [];
|
|
@@ -560,11 +570,6 @@ export async function runGate(run) {
|
|
|
560
570
|
(denied.length > 3 ? ` и ещё ${denied.length - 3}` : '') +
|
|
561
571
|
`. Код выхода ${result.code}: ${diagnostic(result.stderr, result.stdout, redact)}`);
|
|
562
572
|
}
|
|
563
|
-
const counts = reportPath
|
|
564
|
-
? await readReport(reportPath, cwd, redact).catch(() => undefined)
|
|
565
|
-
: undefined;
|
|
566
|
-
if (counts)
|
|
567
|
-
manifest = counts;
|
|
568
573
|
throw new Error([
|
|
569
574
|
`Код выхода ${result.code}`,
|
|
570
575
|
counts?.failures ? `упали ${failedCases(counts)}` : '',
|
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
import { type ExecutionPolicy, type ExecutionView, type JointVerification, type JointVerificationState } from '../contracts/index.ts';
|
|
1
|
+
import { type ExecutionPolicy, type ExecutionView, type JointVerification, type JointVerificationState, type JointBudgetCheckpoint } from '../contracts/index.ts';
|
|
2
2
|
/**
|
|
3
3
|
* Совместная проверка закреплённой комбинации SHA репозиториев.
|
|
4
4
|
*
|
|
@@ -16,6 +16,125 @@ export declare function jointPolicyDigest(policy: ExecutionPolicy): string;
|
|
|
16
16
|
export declare function jointSpecDigest(view: ExecutionView, workIds: string[]): string;
|
|
17
17
|
/** Один и тот же набор поручений — один предмет проверки, независимо от порядка. */
|
|
18
18
|
export declare const sameWorks: (a: string[], b: string[]) => boolean;
|
|
19
|
+
/** Незакрытые принятием попытки; checkpoints доверенного хоста проверяются целиком. */
|
|
20
|
+
export declare function jointBudgetAttempts(view: ExecutionView, workIds: string[], checkpoints: readonly JointBudgetCheckpoint[]): ({
|
|
21
|
+
status: "active";
|
|
22
|
+
apiVersion: "devcontour-harness/v1alpha1";
|
|
23
|
+
id: string;
|
|
24
|
+
startedAt: string;
|
|
25
|
+
policyDigest: string;
|
|
26
|
+
specDigest: string;
|
|
27
|
+
workIds: string[];
|
|
28
|
+
evidence: {
|
|
29
|
+
gate: string;
|
|
30
|
+
passed: boolean;
|
|
31
|
+
command: string[];
|
|
32
|
+
exitCode: number;
|
|
33
|
+
log: string;
|
|
34
|
+
digest: string;
|
|
35
|
+
summary: string;
|
|
36
|
+
artifacts: {
|
|
37
|
+
path: string;
|
|
38
|
+
digest: string;
|
|
39
|
+
}[];
|
|
40
|
+
durationMs?: number | undefined;
|
|
41
|
+
}[];
|
|
42
|
+
token: string;
|
|
43
|
+
leaseUntil: number;
|
|
44
|
+
manifest?: Record<string, {
|
|
45
|
+
sha: string;
|
|
46
|
+
tree: string;
|
|
47
|
+
}> | undefined;
|
|
48
|
+
manifestDigest?: string | undefined;
|
|
49
|
+
impact?: {
|
|
50
|
+
changed: string[];
|
|
51
|
+
affected: string[];
|
|
52
|
+
gateIds: string[];
|
|
53
|
+
mode: "all" | "affected";
|
|
54
|
+
reason: string;
|
|
55
|
+
baseline?: string | undefined;
|
|
56
|
+
} | undefined;
|
|
57
|
+
engineVersion?: string | undefined;
|
|
58
|
+
} | {
|
|
59
|
+
status: "failed";
|
|
60
|
+
finishedAt: string;
|
|
61
|
+
error: string;
|
|
62
|
+
apiVersion: "devcontour-harness/v1alpha1";
|
|
63
|
+
id: string;
|
|
64
|
+
startedAt: string;
|
|
65
|
+
policyDigest: string;
|
|
66
|
+
specDigest: string;
|
|
67
|
+
workIds: string[];
|
|
68
|
+
evidence: {
|
|
69
|
+
gate: string;
|
|
70
|
+
passed: boolean;
|
|
71
|
+
command: string[];
|
|
72
|
+
exitCode: number;
|
|
73
|
+
log: string;
|
|
74
|
+
digest: string;
|
|
75
|
+
summary: string;
|
|
76
|
+
artifacts: {
|
|
77
|
+
path: string;
|
|
78
|
+
digest: string;
|
|
79
|
+
}[];
|
|
80
|
+
durationMs?: number | undefined;
|
|
81
|
+
}[];
|
|
82
|
+
token: string;
|
|
83
|
+
leaseUntil: number;
|
|
84
|
+
manifest?: Record<string, {
|
|
85
|
+
sha: string;
|
|
86
|
+
tree: string;
|
|
87
|
+
}> | undefined;
|
|
88
|
+
manifestDigest?: string | undefined;
|
|
89
|
+
impact?: {
|
|
90
|
+
changed: string[];
|
|
91
|
+
affected: string[];
|
|
92
|
+
gateIds: string[];
|
|
93
|
+
mode: "all" | "affected";
|
|
94
|
+
reason: string;
|
|
95
|
+
baseline?: string | undefined;
|
|
96
|
+
} | undefined;
|
|
97
|
+
engineVersion?: string | undefined;
|
|
98
|
+
} | {
|
|
99
|
+
status: "passed";
|
|
100
|
+
finishedAt: string;
|
|
101
|
+
manifest: Record<string, {
|
|
102
|
+
sha: string;
|
|
103
|
+
tree: string;
|
|
104
|
+
}>;
|
|
105
|
+
manifestDigest: string;
|
|
106
|
+
apiVersion: "devcontour-harness/v1alpha1";
|
|
107
|
+
id: string;
|
|
108
|
+
startedAt: string;
|
|
109
|
+
policyDigest: string;
|
|
110
|
+
specDigest: string;
|
|
111
|
+
workIds: string[];
|
|
112
|
+
evidence: {
|
|
113
|
+
gate: string;
|
|
114
|
+
passed: boolean;
|
|
115
|
+
command: string[];
|
|
116
|
+
exitCode: number;
|
|
117
|
+
log: string;
|
|
118
|
+
digest: string;
|
|
119
|
+
summary: string;
|
|
120
|
+
artifacts: {
|
|
121
|
+
path: string;
|
|
122
|
+
digest: string;
|
|
123
|
+
}[];
|
|
124
|
+
durationMs?: number | undefined;
|
|
125
|
+
}[];
|
|
126
|
+
token: string;
|
|
127
|
+
leaseUntil: number;
|
|
128
|
+
impact?: {
|
|
129
|
+
changed: string[];
|
|
130
|
+
affected: string[];
|
|
131
|
+
gateIds: string[];
|
|
132
|
+
mode: "all" | "affected";
|
|
133
|
+
reason: string;
|
|
134
|
+
baseline?: string | undefined;
|
|
135
|
+
} | undefined;
|
|
136
|
+
engineVersion?: string | undefined;
|
|
137
|
+
})[];
|
|
19
138
|
/** Gates совместной проверки в порядке их зависимостей. */
|
|
20
139
|
export declare function orderedWorkspaceGates(gates: ExecutionPolicy['workspaceGates']): ({
|
|
21
140
|
kind: "test";
|
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
import { digestOf, } from "../contracts/index.js";
|
|
1
|
+
import { digestOf, HarnessError, } from "../contracts/index.js";
|
|
2
2
|
/**
|
|
3
3
|
* Совместная проверка закреплённой комбинации SHA репозиториев.
|
|
4
4
|
*
|
|
@@ -38,6 +38,43 @@ export function jointSpecDigest(view, workIds) {
|
|
|
38
38
|
}
|
|
39
39
|
/** Один и тот же набор поручений — один предмет проверки, независимо от порядка. */
|
|
40
40
|
export const sameWorks = (a, b) => JSON.stringify([...a].sort()) === JSON.stringify([...b].sort());
|
|
41
|
+
/** Незакрытые принятием попытки; checkpoints доверенного хоста проверяются целиком. */
|
|
42
|
+
export function jointBudgetAttempts(view, workIds, checkpoints) {
|
|
43
|
+
const invalid = () => {
|
|
44
|
+
throw new HarnessError('INVALID_INPUT', 'Невалидная принятая граница бюджета совместных проверок');
|
|
45
|
+
};
|
|
46
|
+
if (!Array.isArray(checkpoints))
|
|
47
|
+
invalid();
|
|
48
|
+
const settled = new Set();
|
|
49
|
+
const anchors = new Set();
|
|
50
|
+
for (const checkpoint of checkpoints) {
|
|
51
|
+
if (!checkpoint ||
|
|
52
|
+
typeof checkpoint.verificationId !== 'string' ||
|
|
53
|
+
!checkpoint.verificationId.length ||
|
|
54
|
+
!Array.isArray(checkpoint.settledVerificationIds))
|
|
55
|
+
invalid();
|
|
56
|
+
const { verificationId, settledVerificationIds: ids } = checkpoint;
|
|
57
|
+
const anchor = view.verification(verificationId);
|
|
58
|
+
if (anchors.has(verificationId) ||
|
|
59
|
+
!anchor ||
|
|
60
|
+
anchor.status !== 'passed' ||
|
|
61
|
+
!sameWorks(anchor.workIds, workIds) ||
|
|
62
|
+
!ids.length ||
|
|
63
|
+
new Set(ids).size !== ids.length ||
|
|
64
|
+
!ids.includes(verificationId))
|
|
65
|
+
invalid();
|
|
66
|
+
anchors.add(verificationId);
|
|
67
|
+
for (const id of ids) {
|
|
68
|
+
if (typeof id !== 'string' || !id.length)
|
|
69
|
+
invalid();
|
|
70
|
+
const v = view.verification(id);
|
|
71
|
+
if (!v || (v.status !== 'passed' && v.status !== 'failed') || !sameWorks(v.workIds, workIds))
|
|
72
|
+
invalid();
|
|
73
|
+
settled.add(id);
|
|
74
|
+
}
|
|
75
|
+
}
|
|
76
|
+
return view.verifications().filter((v) => sameWorks(v.workIds, workIds) && !settled.has(v.id));
|
|
77
|
+
}
|
|
41
78
|
/** Gates совместной проверки в порядке их зависимостей. */
|
|
42
79
|
export function orderedWorkspaceGates(gates) {
|
|
43
80
|
const byId = new Map(gates.map((g) => [g.id, g]));
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "devcontour-harness",
|
|
3
|
-
"version": "0.1.0-alpha.
|
|
3
|
+
"version": "0.1.0-alpha.25",
|
|
4
4
|
"description": "Headless execution harness: work graph, isolated attempts, gates, independent reviews and accepted results.",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"license": "MIT",
|
|
@@ -82,9 +82,12 @@
|
|
|
82
82
|
"schemas:check": "node --import tsx scripts/build-schemas.ts --check",
|
|
83
83
|
"lint": "eslint .",
|
|
84
84
|
"test": "node scripts/test.mjs",
|
|
85
|
+
"test:fast": "node scripts/test.mjs --fast",
|
|
86
|
+
"test:affected": "node scripts/test.mjs --affected",
|
|
85
87
|
"test:integration": "node --import tsx --test --test-concurrency=1 --test-timeout=1800000 tests/integration/*.test.ts",
|
|
86
88
|
"test:package": "npm run build && node scripts/smoke-package.mjs",
|
|
87
|
-
"check": "
|
|
89
|
+
"check": "node scripts/static-checks.mjs && npm run build && node scripts/test.mjs --release && node scripts/smoke-package.mjs",
|
|
90
|
+
"check:fast": "node scripts/static-checks.mjs && node scripts/test.mjs --affected",
|
|
88
91
|
"format": "prettier --write .",
|
|
89
92
|
"format:check": "prettier --check .",
|
|
90
93
|
"check:install": "node scripts/install-check.mjs"
|