devcontour-harness 0.1.0-alpha.23 → 0.1.0-alpha.24

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 CHANGED
@@ -5,7 +5,7 @@ Headless-движок исполнения инженерных поручени
5
5
  интеграция с принятой веткой через compare-and-swap и машинный результат с SHA
6
6
  и доказательствами.
7
7
 
8
- > Статус: `0.1.0-alpha.23` — предварительный выпуск (alpha). Договоры
8
+ > Статус: `0.1.0-alpha.24` — предварительный выпуск (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.23 # точная версия
31
+ npm install --save-exact devcontour-harness@0.1.0-alpha.24 # точная версия
32
32
  # или: npm install --save-exact devcontour-harness@alpha # текущая alpha
33
33
  npx harness --version
34
34
  ```
@@ -123,6 +123,15 @@ PASS» нет. Адаптеры хоста реализуют порты `Execut
123
123
  `devcontour-harness/schemas/<имя>.schema.json`. Декларации используют типы
124
124
  Node.js: TypeScript-потребителю нужен `@types/node` (или `skipLibCheck`).
125
125
 
126
+ ## Выпуск 0.1.0-alpha.24
127
+
128
+ Диагностика корня рабочих деревьев ничего не создаёт; новые корни и их
129
+ родители создаются с правами 0700, в том числе при отсутствующем каталоге
130
+ кэша пользователя. Корень не может содержать репозиторий или состояние.
131
+ Отказ чтения учётных данных не переводится в класс `environment` даже при
132
+ поиске файла вверх по дереву. Подробно —
133
+ [заметки выпуска](docs/release-notes/0.1.0-alpha.24.md).
134
+
126
135
  ## Выпуск 0.1.0-alpha.23
127
136
 
128
137
  Рабочие деревья попыток вне дерева человека: если каталог состояния лежит
@@ -605,11 +605,23 @@ executable. Live smoke — отдельный opt-in с явно заданны
605
605
  проверки отличаются от чужих. Текст вывода свидетельством не служит, запись
606
606
  вне дерева — ошибка кода (`gate`). На Linux такого свидетельства нет, и
607
607
  отказ остаётся `gate`.
608
+ - **Корень рабочих деревьев.** При состоянии внутри репозитория checkout
609
+ размещается в кэше пользователя вне дерева; хост может задать
610
+ `checkoutRoot`. Корень не должен ни лежать внутри репозитория, состояния
611
+ или закрытого пути, ни содержать их. Новые каталоги корня и недостающие
612
+ родители создаются с mode 0700; существующие каталоги пользователя не
613
+ меняются. `doctor` рассчитывает корень без создания каталогов. Отказ
614
+ чтения конфигурации в предке рабочего каталога может стать `environment`
615
+ только при подтверждении журналом ядра и EPERM с путём в выводе;
616
+ учётные данные (в том числе `~/.npmrc`) всегда исключены из этого правила.
617
+ Закрытие соседних деревьев запрещает чтение их содержимого. Оно не скрывает
618
+ само существование пути: на macOS разные ответы ENOENT/EPERM могут раскрыть
619
+ этот факт. Это ограничение песочницы, а не гарантия конфиденциальности имён.
608
620
  - **Git хоста над деревом проверки.** Каждый вызов git хоста сначала сверяет,
609
621
  куда git придёт: файл `.git` дерева, созданного `worktree add`, не изменён;
610
622
  gitdir и общий каталог лежат вне дерева и согласованы; `commondir`/`gitdir`
611
623
  в обычном `.git` и вложенный репозиторий внутри известного дерева — отказ
612
- (`scope-violation` в gate). Поверх — `-c core.fsmonitor=false -c
624
+ (`scope-violation` в gate). Поверх — `-c core.fsmonitor= -c
613
625
  core.hooksPath=/dev/null -c protocol.ext.allow=never`: hooks репозитория при
614
626
  коммитах harness не исполняются.
615
627
  - **Чего ещё нет.** Регрессионных тестов в песочнице для запретов `.git`, для
@@ -13,7 +13,7 @@
13
13
  ```sh
14
14
  mkdir harness-demo && cd harness-demo
15
15
  npm init -y >/dev/null
16
- npm install --save-exact devcontour-harness@0.1.0-alpha.23
16
+ npm install --save-exact devcontour-harness@0.1.0-alpha.24
17
17
  npx harness --version
18
18
  npx harness doctor
19
19
  ```
@@ -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; живые модели для него не нужны.
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 | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | одна база SQLite: документ, события, локальные записи |
27
- | хост, центральная база | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да | данные не переносятся; новые поля необязательны |
28
- | хост, базы компонентов | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да | нужна копия всех баз при остановленных writers |
29
- | alpha.2 после штатной остановки controller | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | роль controller снята — нового поля в состоянии нет |
30
- | alpha.2 с живой или брошенной ролью controller | **нет**, отказ до записи | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | — | роль хранит `engineVersion`; строгая схема alpha.1 его не знает → откат через копию |
31
- | alpha.4 с совместной проверкой | **нет**, отказ до записи | **нет**, отказ до записи | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | — | проверка хранит `engineVersion`; прежние версии его не знают → откат через копию |
32
- | alpha.6 standalone с записями ревью нового протокола или доставкой `uncertain` | **нет**, отказ до записи | **нет**, отказ до записи | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | — | `reviewRound`, `findings[].id/status`, статус доставки `uncertain`; alpha.4/alpha.5 отказывают `STATE_VERSION_UNSUPPORTED` до записи → откат через копию |
33
- | alpha.6, хост DevContour (адаптер alpha.4) | — | — | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да (через адаптер) | да | да | да | да | да | адаптер DevContour alpha.4 открывает такое состояние без отказа и пишет роль controller и события; новые поля сохраняются → для отката всё равно копия |
34
- | alpha.7 с новым `inspection` ревью кода | не проверялось | не проверялось | **нет** (строгая схема) | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | да | — | новые значения `source`, `exitCode: null`, `origins`/`context`/`excluded`; строгая схема alpha.6 их не принимает, поведение прежних версий при открытии не проверялось → откат через копию |
35
- | alpha.14 с договором проверки `reference` или `gates` обязательства | не проверялось | не проверялось | не проверялось | **нет** (строгая схема) | **нет** (строгая схема) | **нет** (строгая схема) | **нет** (строгая схема) | **нет** (строгая схема) | **нет** (строгая схема) | **нет** (строгая схема) | да | да | да | да | да | да | да | да | да | да | — | контракт хранится строгой схемой (`contract-documents`): прежние версии новых полей `gates`, `verification`, `reference` не знают → откат через копию |
36
- | alpha.17 с `interrupted`, `inputClasses`, `classified`, `neutralFailures`, `alreadySatisfied` в evidence ревью или классом отказа `unfinished`/`needs-lead` | не проверялось | не проверялось | не проверялось | **нет** (строгая схема) | **нет** (строгая схема) | **нет** (строгая схема) | **нет** (строгая схема) | **нет** (строгая схема) | **нет** (строгая схема) | **нет** (строгая схема) | **нет** (строгая схема) | **нет** (строгая схема) | **нет** (строгая схема) | да | да | да | да | да | да | да | — | попытка (`interrupted`, `inputClasses`, `classified`), поручение (`neutralFailures`), `alreadySatisfied` evidence ревью и классы отказа `unfinished`, `needs-lead` — новые значения строгих схем; прежние версии их отклоняют → откат через копию |
37
- | alpha.19 с `recheck` в evidence gate или областью gates длиннее 20 | не проверялось | не проверялось | не проверялось | **нет** (строгая схема) | **нет** (строгая схема) | **нет** (строгая схема) | **нет** (строгая схема) | **нет** (строгая схема) | **нет** (строгая схема) | **нет** (строгая схема) | **нет** (строгая схема) | **нет** (строгая схема) | **нет** (строгая схема) | **нет** (строгая схема) | **нет** (строгая схема) | да | да | да | да | да | — | evidence gate и событие `attempt.gate` (`recheck`), области gates поручения, задачи, потребителя и `alreadySatisfied` до 100 — новые значения строгих схем; прежние версии их отклоняют → откат через копию |
38
- | неизвестная `stateVersion` | нет, отказ до записи | нет, отказ до записи | нет, отказ до записи | нет, отказ до записи | нет, отказ до записи | нет, отказ до записи | нет, отказ до записи | нет, отказ до записи | нет, отказ до записи | нет, отказ до записи | нет, отказ до записи | нет, отказ до записи | нет, отказ до записи | нет, отказ до записи | нет, отказ до записи | нет, отказ до записи | нет, отказ до записи | нет, отказ до записи | нет, отказ до записи | нет, отказ до записи | нет | `STATE_VERSION_UNSUPPORTED`, exit 4 |
39
-
40
- Столбец alpha.2 относится и к alpha.3; alpha.4 и alpha.5 читают все строки, кроме неизвестной `stateVersion` и строк alpha.6 с новыми полями (standalone — отказ до записи) и строки alpha.7. alpha.8, alpha.9, alpha.10, alpha.11, alpha.12 и alpha.13 формат состояния не меняют и читают всё, что читает alpha.7; alpha.14 и alpha.15 (локальные, не опубликованы) и alpha.16 читают всё, что читает alpha.13, и добавляют необязательные поля договора проверки (строка alpha.14). alpha.17 читает всё, что читает alpha.16, и добавляет необязательные поля попытки, поручения и evidence ревью и классы отказа `unfinished` и `needs-lead` (строка alpha.17); alpha.18 формат состояния не меняет и читает всё, что читает alpha.17. alpha.19 читает всё, что читает alpha.18, и добавляет необязательное поле `recheck` evidence gate и области gates до 100 (строка alpha.19); alpha.20, alpha.21, alpha.22 и alpha.23 формат состояния не меняют и читают всё, что читает alpha.19. Каждая следующая версия добавляет сюда свой столбец. Отказ неизвестного
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`),
@@ -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;
@@ -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
- * Создать каталоги кэша (0700). Без записи (`false`, диагностика) —
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 unsafe = unsafeDir(root, false, uid);
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
- // проверяются каталог harness и каталог этого состояния.
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
- 'core.fsmonitor=false',
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`). Чтение другого закрытого пути (`~/.ssh/id_rsa`), отказ,
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`). Чтение другого закрытого пути (`~/.ssh/id_rsa`), отказ,
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') && eperm && walkUp(v.path) && mentions(output, v.path)
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
- const bounded = await Promise.race([
153
- closed.then(() => true),
154
- new Promise((r) => setTimeout(() => r(false), 3000)),
155
- ]);
156
- if (!bounded) {
157
- child.stdout.destroy();
158
- child.stderr.destroy();
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();
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "devcontour-harness",
3
- "version": "0.1.0-alpha.23",
3
+ "version": "0.1.0-alpha.24",
4
4
  "description": "Headless execution harness: work graph, isolated attempts, gates, independent reviews and accepted results.",
5
5
  "type": "module",
6
6
  "license": "MIT",