devcontour-harness 0.1.0-alpha.19 → 0.1.0-alpha.20
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/quickstart.md +1 -1
- package/docs/release-notes/0.1.0-alpha.20.md +42 -0
- package/docs/upgrade.md +17 -17
- package/lib/agents/review-probe.js +2 -1
- package/lib/environment/live-calls.js +3 -2
- package/lib/environment/os-tools.d.ts +15 -0
- package/lib/environment/os-tools.js +35 -0
- package/lib/environment/process.js +23 -5
- 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.20` — предварительный выпуск (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.20 # точная версия
|
|
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.20
|
|
127
|
+
|
|
128
|
+
Исправление containment: отсоединившийся потомок проверки с очищенным
|
|
129
|
+
окружением, найденный только по каталогу, больше не переживает проверку на
|
|
130
|
+
машине с неанглийской локалью. Вывод `ps` и `lsof` разбирается при любой
|
|
131
|
+
локали пользователя; нечитаемое время старта не освобождает процесс от
|
|
132
|
+
остановки. Подробно — [заметки выпуска](docs/release-notes/0.1.0-alpha.20.md).
|
|
133
|
+
|
|
126
134
|
## Выпуск 0.1.0-alpha.19
|
|
127
135
|
|
|
128
136
|
Провал gate интеграции после зелёного кандидата повторяется один раз
|
package/docs/quickstart.md
CHANGED
|
@@ -0,0 +1,42 @@
|
|
|
1
|
+
# devcontour-harness 0.1.0-alpha.20
|
|
2
|
+
|
|
3
|
+
Исправление containment на машинах с неанглийской локалью. Включает всё из
|
|
4
|
+
[0.1.0-alpha.19](0.1.0-alpha.19.md). Формат состояния, gates, правила
|
|
5
|
+
находок, изоляция, принятие target ref и `maxAttempts` не менялись.
|
|
6
|
+
|
|
7
|
+
## Что исправлено
|
|
8
|
+
|
|
9
|
+
- **Потомок проверки не переживает её при любой локали.** Ядро находит
|
|
10
|
+
отсоединившегося потомка с очищенным окружением по текущему каталогу внутри
|
|
11
|
+
каталогов проверки и отсекает процессы старше команды по времени старта из
|
|
12
|
+
`ps -o lstart=`. Утилиты наследовали локаль пользователя: в `ru_RU.UTF-8`
|
|
13
|
+
`ps` печатает «среда, 28 октября 2026 г. 16:42:10», `Date.parse` его не
|
|
14
|
+
читает, и такой потомок считался старше команды и оставался жить. Теперь
|
|
15
|
+
каждая системная утилита, чей вывод разбирается (`ps`, `lsof`, `sysctl`,
|
|
16
|
+
`ps` ревью-зонда), запускается с `LC_TIME`, `LC_NUMERIC` и `LC_MESSAGES` в
|
|
17
|
+
локали C (`osToolEnv`).
|
|
18
|
+
- **Кириллица в пути каталога.** `LC_ALL=C` не подходит: в локали C `lsof`
|
|
19
|
+
экранирует байты не-ASCII путей (`\xd0\xbb…`), и каталог с кириллицей не
|
|
20
|
+
узнавался. Кодировка символов остаётся пользовательской (значение `LC_ALL`
|
|
21
|
+
переносится в `LC_CTYPE`), а экранирование `lsof` снимается (`lsofName`),
|
|
22
|
+
если локаль пользователя сама C.
|
|
23
|
+
- **Нечитаемое время старта — не исключение.** Процесс с текущим каталогом
|
|
24
|
+
внутри каталогов проверки, время старта которого не прочитано,
|
|
25
|
+
останавливается: эти каталоги принадлежат только проверке. Не
|
|
26
|
+
останавливается только процесс, о котором точно известно, что он старше
|
|
27
|
+
команды (например, терминал, открытый в worktree раньше), и процесс, которого
|
|
28
|
+
нет в снимке таблицы процессов (в их числе сам `lsof`).
|
|
29
|
+
|
|
30
|
+
## Совместимость
|
|
31
|
+
|
|
32
|
+
Формат состояния и публичный API не меняются (`osToolEnv` и `lsofName` —
|
|
33
|
+
внутренние). Матрица — [upgrade](../upgrade.md).
|
|
34
|
+
|
|
35
|
+
## Проверка выпуска
|
|
36
|
+
|
|
37
|
+
Новый тест `process` T30 воспроизводит потомка с очищенным окружением при
|
|
38
|
+
локали `ru_RU.UTF-8` и при локали C с кириллицей в имени каталога: на
|
|
39
|
+
alpha.19 он оставался жив, мутанты без фиксированной локали и без снятия
|
|
40
|
+
экранирования `lsof` тест обнаруживает. Модульный тест `os-tools` проверяет
|
|
41
|
+
окружение утилит и снятие экранирования. Полный `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 | Пишет поверх | Примечание |
|
|
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). Каждая следующая версия добавляет сюда свой столбец. Отказ неизвестного
|
|
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 формат состояния не меняет и читает всё, что читает alpha.19. Каждая следующая версия добавляет сюда свой столбец. Отказ неизвестного
|
|
41
41
|
формата до записи проверяют тесты совместимости пакета
|
|
42
42
|
<!-- repo-only -->(`tests/compatibility.test.ts`)<!-- /repo-only -->.
|
|
43
43
|
|
|
@@ -8,6 +8,7 @@ import { createInterface } from 'node:readline';
|
|
|
8
8
|
import { fileURLToPath } from 'node:url';
|
|
9
9
|
import { z } from 'zod';
|
|
10
10
|
import { idSchema, relativePathSchema, sha256, } from "../contracts/index.js";
|
|
11
|
+
import { osToolEnv } from "../environment/os-tools.js";
|
|
11
12
|
import { redactor } from "../environment/redaction.js";
|
|
12
13
|
import { completedCheck, freshnessEnv, propertyReportEnv, junitSummary, runCheck, sandboxBlockedHosts, } from "../verification/gates.js";
|
|
13
14
|
/**
|
|
@@ -974,7 +975,7 @@ async function probeProcesses(runId) {
|
|
|
974
975
|
}
|
|
975
976
|
});
|
|
976
977
|
}
|
|
977
|
-
const stdout = await new Promise((resolve) => execFile('ps', ['-Eww', '-ax', '-o', 'pid=,pgid=,command='], { encoding: 'utf8', maxBuffer: 64_000_000, timeout: 10000 }, (error, out) => resolve(error ? '' : out)));
|
|
978
|
+
const stdout = await new Promise((resolve) => execFile('ps', ['-Eww', '-ax', '-o', 'pid=,pgid=,command='], { encoding: 'utf8', env: osToolEnv(), maxBuffer: 64_000_000, timeout: 10000 }, (error, out) => resolve(error ? '' : out)));
|
|
978
979
|
return stdout.split('\n').flatMap((line) => {
|
|
979
980
|
const m = /^\s*(\d+)\s+(\d+)\s+(.*)$/.exec(line);
|
|
980
981
|
return m && m[3].includes(needle) && Number(m[1]) !== own
|
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
import { randomUUID } from 'node:crypto';
|
|
2
|
-
import { osTool } from "./os-tools.js";
|
|
2
|
+
import { osTool, osToolEnv } from "./os-tools.js";
|
|
3
3
|
import { execFileSync } from 'node:child_process';
|
|
4
4
|
import { readFileSync } from 'node:fs';
|
|
5
5
|
import { registerMonotonic, registerProcess } from "../engine/usage.js";
|
|
@@ -9,7 +9,7 @@ export function processStartedAt(pid) {
|
|
|
9
9
|
try {
|
|
10
10
|
const out = execFileSync(osTool('ps'), ['-o', 'lstart=', '-p', String(pid)], {
|
|
11
11
|
encoding: 'utf8',
|
|
12
|
-
env:
|
|
12
|
+
env: osToolEnv(),
|
|
13
13
|
stdio: ['ignore', 'pipe', 'ignore'],
|
|
14
14
|
timeout: 2000,
|
|
15
15
|
}).trim();
|
|
@@ -59,6 +59,7 @@ export const BOOT_ID = (() => {
|
|
|
59
59
|
try {
|
|
60
60
|
const out = execFileSync(osTool('sysctl'), ['-n', 'kern.boottime'], {
|
|
61
61
|
encoding: 'utf8',
|
|
62
|
+
env: osToolEnv(),
|
|
62
63
|
stdio: ['ignore', 'pipe', 'ignore'],
|
|
63
64
|
timeout: 2000,
|
|
64
65
|
});
|
|
@@ -14,3 +14,18 @@ export declare const OS_TOOL_CANDIDATES: {
|
|
|
14
14
|
export type OsTool = keyof typeof OS_TOOL_CANDIDATES;
|
|
15
15
|
/** Исполняемый файл утилиты: первый существующий штатный путь, иначе имя для PATH. */
|
|
16
16
|
export declare function osTool(name: OsTool, candidates?: readonly string[]): string;
|
|
17
|
+
/**
|
|
18
|
+
* Окружение утилиты, чей вывод ядро разбирает: даты, числа и сообщения — в
|
|
19
|
+
* локали C при любой локали пользователя. В ru_RU `ps -o lstart=` печатает
|
|
20
|
+
* «среда, 28 октября 2026 г. 16:42:10», и `Date.parse` его не читает. Только
|
|
21
|
+
* LC_CTYPE остаётся пользовательским: в локали C `lsof` экранирует байты
|
|
22
|
+
* не-ASCII путей (`\xd0\xbb…`), и каталог с кириллицей не узнаётся. Поэтому не
|
|
23
|
+
* `LC_ALL=C`: LC_ALL перекрыл бы LC_CTYPE, и его значение переносится в LC_CTYPE.
|
|
24
|
+
*/
|
|
25
|
+
export declare function osToolEnv(env?: NodeJS.ProcessEnv): NodeJS.ProcessEnv;
|
|
26
|
+
/**
|
|
27
|
+
* Имя файла из вывода `lsof`: в локали без UTF-8 он экранирует байты вне
|
|
28
|
+
* ASCII как `\xNN`, обратную косую — как `\\`, управляющие — как `\t`, `\n` и
|
|
29
|
+
* т. п. Здесь экранирование снимается, и путь сравним с настоящим.
|
|
30
|
+
*/
|
|
31
|
+
export declare function lsofName(name: string): string;
|
|
@@ -33,3 +33,38 @@ export function osTool(name, candidates = OS_TOOL_CANDIDATES[name]) {
|
|
|
33
33
|
resolved.set(name, found);
|
|
34
34
|
return found;
|
|
35
35
|
}
|
|
36
|
+
/**
|
|
37
|
+
* Окружение утилиты, чей вывод ядро разбирает: даты, числа и сообщения — в
|
|
38
|
+
* локали C при любой локали пользователя. В ru_RU `ps -o lstart=` печатает
|
|
39
|
+
* «среда, 28 октября 2026 г. 16:42:10», и `Date.parse` его не читает. Только
|
|
40
|
+
* LC_CTYPE остаётся пользовательским: в локали C `lsof` экранирует байты
|
|
41
|
+
* не-ASCII путей (`\xd0\xbb…`), и каталог с кириллицей не узнаётся. Поэтому не
|
|
42
|
+
* `LC_ALL=C`: LC_ALL перекрыл бы LC_CTYPE, и его значение переносится в LC_CTYPE.
|
|
43
|
+
*/
|
|
44
|
+
export function osToolEnv(env = process.env) {
|
|
45
|
+
const { LC_ALL, ...rest } = env;
|
|
46
|
+
const ctype = LC_ALL || env.LC_CTYPE || env.LANG;
|
|
47
|
+
return {
|
|
48
|
+
...rest,
|
|
49
|
+
LC_TIME: 'C',
|
|
50
|
+
LC_NUMERIC: 'C',
|
|
51
|
+
LC_MESSAGES: 'C',
|
|
52
|
+
...(ctype ? { LC_CTYPE: ctype } : {}),
|
|
53
|
+
};
|
|
54
|
+
}
|
|
55
|
+
/**
|
|
56
|
+
* Имя файла из вывода `lsof`: в локали без UTF-8 он экранирует байты вне
|
|
57
|
+
* ASCII как `\xNN`, обратную косую — как `\\`, управляющие — как `\t`, `\n` и
|
|
58
|
+
* т. п. Здесь экранирование снимается, и путь сравним с настоящим.
|
|
59
|
+
*/
|
|
60
|
+
export function lsofName(name) {
|
|
61
|
+
if (!name.includes('\\'))
|
|
62
|
+
return name;
|
|
63
|
+
const simple = { b: 8, t: 9, n: 10, f: 12, r: 13, '\\': 92 };
|
|
64
|
+
const bytes = name.split(/(\\x[0-9a-fA-F]{2}|\\[btnfr\\])/).flatMap((part, i) => {
|
|
65
|
+
if (i % 2 === 0)
|
|
66
|
+
return [...Buffer.from(part, 'utf8')];
|
|
67
|
+
return [part[1] === 'x' ? parseInt(part.slice(2), 16) : simple[part[1]]];
|
|
68
|
+
});
|
|
69
|
+
return Buffer.from(bytes).toString('utf8');
|
|
70
|
+
}
|
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
import { spawn, spawnSync, execFile } from 'node:child_process';
|
|
2
|
-
import { osTool } from "./os-tools.js";
|
|
2
|
+
import { lsofName, osTool, osToolEnv } from "./os-tools.js";
|
|
3
3
|
import { randomUUID } from 'node:crypto';
|
|
4
4
|
import { readdirSync, readFileSync, readlinkSync, realpathSync } from 'node:fs';
|
|
5
5
|
import { StringDecoder } from 'node:string_decoder';
|
|
@@ -200,6 +200,7 @@ function captureProcessTree(pid) {
|
|
|
200
200
|
};
|
|
201
201
|
const result = spawnSync(osTool('ps'), ['-axo', 'pid=,ppid=,pgid=,comm='], {
|
|
202
202
|
encoding: 'utf8',
|
|
203
|
+
env: osToolEnv(),
|
|
203
204
|
timeout: 250,
|
|
204
205
|
maxBuffer: 1_000_000,
|
|
205
206
|
});
|
|
@@ -259,10 +260,13 @@ export async function git(cwd, ...args) {
|
|
|
259
260
|
forgetWorktree(removed);
|
|
260
261
|
return result.stdout.trim();
|
|
261
262
|
}
|
|
262
|
-
/**
|
|
263
|
+
/**
|
|
264
|
+
* Вывод системной утилиты или null, если она не выполнилась. Не блокирует
|
|
265
|
+
* event loop. Локаль фиксирована (`osToolEnv`): вывод разбирается.
|
|
266
|
+
*/
|
|
263
267
|
function output(command, args, timeout) {
|
|
264
268
|
return new Promise((resolve) => {
|
|
265
|
-
execFile(command, args, { encoding: 'utf8', timeout, maxBuffer: 64_000_000 }, (error, stdout) => resolve(error ? null : stdout));
|
|
269
|
+
execFile(command, args, { encoding: 'utf8', env: osToolEnv(), timeout, maxBuffer: 64_000_000 }, (error, stdout) => resolve(error ? null : stdout));
|
|
266
270
|
});
|
|
267
271
|
}
|
|
268
272
|
/** Процессы пользователя, в окружении которых есть метка. */
|
|
@@ -334,7 +338,18 @@ async function inside(dirs, since) {
|
|
|
334
338
|
}
|
|
335
339
|
});
|
|
336
340
|
const started = new Map((await processTable()).map((r) => [r.pid, Date.parse(r.start)]));
|
|
337
|
-
|
|
341
|
+
// Нечитаемое время старта — не повод оставить процесс: каталоги принадлежат
|
|
342
|
+
// только этой команде, и утечка её потомка хуже ошибочной остановки.
|
|
343
|
+
// Отсекается только процесс, о котором точно известно, что он старше
|
|
344
|
+
// команды. Процесса нет в снимке — он запущен после снимка; это и сам
|
|
345
|
+
// lsof с текущим каталогом внутри, поэтому такой процесс не берётся: его
|
|
346
|
+
// потомка найдёт следующий проход.
|
|
347
|
+
const fresh = (pid) => {
|
|
348
|
+
if (!started.has(pid))
|
|
349
|
+
return false;
|
|
350
|
+
const at = started.get(pid);
|
|
351
|
+
return !Number.isFinite(at) || at >= since - 1000;
|
|
352
|
+
};
|
|
338
353
|
const within = (path) => dirs.some((d) => path === d || path.startsWith(d + '/'));
|
|
339
354
|
if (process.platform === 'linux')
|
|
340
355
|
return readdirSync('/proc').flatMap((entry) => {
|
|
@@ -355,7 +370,10 @@ async function inside(dirs, since) {
|
|
|
355
370
|
for (const line of (stdout ?? '').split('\n')) {
|
|
356
371
|
if (line.startsWith('p'))
|
|
357
372
|
pid = Number(line.slice(1));
|
|
358
|
-
else if (line.startsWith('n') &&
|
|
373
|
+
else if (line.startsWith('n') &&
|
|
374
|
+
within(lsofName(line.slice(1))) &&
|
|
375
|
+
pid !== process.pid &&
|
|
376
|
+
fresh(pid))
|
|
359
377
|
pids.push(pid);
|
|
360
378
|
}
|
|
361
379
|
return pids;
|
package/package.json
CHANGED