@rt-tools/agent-kit 0.8.1 → 0.8.3

package/README.md

@@ -63,6 +63,7 @@ npx agent-kit sync --check
 | `agents`, `commands`, `workflows` | `.claude/` | роли, слеш-команды и многошаговые прогоны |
 | `checks` | `tools/` | проверки, которые зовёт гейт |
 | `templates` | `.claude/rt-kit/templates/` | формы правила, паттерна, компаньона и надстроек |
+| `samples` | `docs/` | образцы, которые копируют в рабочий файл: папка задачи, спек домена |
 
 Правило, паттерн и скил ложатся одинаково — все три скилы; различает их `kind` во вступлении
 файла. Скил без закона стоит рядом с лестницей, а не в ней: он не про то, что должно быть верно
@@ -289,36 +290,41 @@ npx agent-kit stats --json       # то же машиночитаемо
 
 ```bash
 npx agent-kit propose --dry-run   # что уехало бы
-npx agent-kit propose             # завести записи в очереди работ пакета
+npx agent-kit propose             # отправить груз в приём
 ```
 
-Наружу уезжает **только адрес «пакет»** и вместе с ним — сводка наблюдений: без цифр
-предложение читается как мнение. Отправленное помечается ссылкой в том же файле и второй раз не
-уезжает. Куда отправлять, пакет берёт из своего манифеста, а не из зашитого в код адреса.
+Груз уезжает при каждом прогоне тремя родами: **сводка наблюдений со снимком надстроек**,
+**предложения** с адресом «пакет» — когда они есть — и **разборы происшествий**. Прогон без
+замечаний тоже говорит, чем пользовались, чем не пользовались ни разу и что дерево
+переопределило. Отправленное предложение помечается в том же файле и второй раз не уезжает.
 
-Перед отправкой текст сверяется на адрес дерева — абсолютный путь, имя корня, адрес удалённого
-репозитория. Нашлось — отказ с номером строки, и отбивается вся отправка целиком: «уехало два из
-трёх» читается как «всё в порядке». Файл уезжает в чужой репозиторий, и запрет называть чужое
-дерево держится проверкой, а не памятью того, кто пишет.
+Уезжает груз в **закрытый приём**, а не в открытую очередь работ: сводка говорит о рабочих
+привычках команды — чем пользуются, обо что спотыкаются, сколько раз признавали промах. Адрес
+приёма объявлен настройкой дерева, а не зашит в код пакета.
+
+Перед отправкой сводка и тексты предложений сверяются на адрес дерева — абсолютный путь, имя
+корня, адрес удалённого репозитория. Нашлось — отказ с номером строки, и отбивается вся отправка
+целиком: «уехало два из трёх» читается как «всё в порядке». Разбор происшествия проверкой не
+накрыт: он по устройству называет файлы дерева, где промах случился.
 
 ### Что для этого нужно
 
-Своего сервера у механизма нет, ключей и учётных записей он не заводит. Наблюдения и сводка
-живут целиком на машине; в сеть ходит только отправка, и только по команде человека.
+Наблюдения и сводка живут целиком на машине; в сеть ходит только отправка, и только по команде
+человека. Приём — своя служба, а не чужая: она поднимается там, где решит владелец пакета.
 
 | Где | Что нужно |
 | --- | --- |
 | у потребителя | `jq` — его требуют и сами гарды |
-| у потребителя | помощник хостинга, вошедший в любую учётную запись: запись заводится от её имени |
-| в репозитории пакета | метка, по которой сведение находит предложения, — заводится один раз |
+| у потребителя | адрес приёма ключом `intake` в `.claude/rt-kit.json` |
+| у потребителя | токен дерева в файле вне дерева, названном ключом `token` |
+| у приёма | заведённое дерево: токен выдаёт его команда и печатает один раз |
 
-```bash
-gh label create agent-kit-feedback --description 'Предложение по слою правил, пришедшее из дерева'
-```
+Признак, которым дерево представляется приёму, считается хешем от адреса его удалённого
+репозитория: адрес по нему не восстанавливается, а у двух рабочих копий одного репозитория он
+один. Репозитория нет — признак называется ключом `tree`.
 
-Метки нет — отправка отказывает, и понять причину по сообщению помощника нельзя: про метку,
-доступ и собственное отсутствие он говорит одинаково глухо. Поэтому отказ команды называет все
-три сам.
+Адреса нет, токена нет, токен отозван — отправка отказывает ненулевым кодом и называет, чего
+именно не хватило и где это объявляется. Молчаливая отправка выглядела бы работающей.
 
 ## Роли и конвейеры
 
@@ -356,7 +362,7 @@ gh label create agent-kit-feedback --description 'Предложение по с
 | `/agent-kit-digest` | `commands/agent-kit-digest.md` | сводит накопленные предложения и наблюдения в правки ресурсов  |
 
 `/next-session` приводит дерево к главной ветке — переходом на неё, если работа шла по правилу и
-отчёт влит, и вливанием в текущую ветку во всех прочих случаях, — снимает влитые локальные
+PR влит, и вливанием в текущую ветку во всех прочих случаях, — снимает влитые локальные
 ветки, называет невлитые и пишет передачу для следующего захода. Незакоммиченная правка
 останавливает её до первого действия; поставки она не касается.
 

package/assets/agents/qa-engineer.md

@@ -8,7 +8,7 @@ tools: Read, Grep, Glob, Bash, Write, Edit, Skill, mcp__claude-in-chrome__select
 `CLAUDE.md` и в правилах `testing` и `browser-verification`, а не предполагай. Отвечаешь
 **по-русски**.
 
-Твоя задача — найти, где сделанное не работает, а не подтвердить, что работает. Отчёт без
+Твоя задача — найти, где сделанное не работает, а не подтвердить, что работает. PR без
 единой находки допустим только тогда, когда ты честно пытался её получить.
 
 ## Чего делать нельзя

package/assets/agents/rules-reviewer.md

@@ -0,0 +1,83 @@
+---
+name: rules-reviewer
+description: Читает семью текстов слоя правил целиком — закон, все правила под ним и все паттерны при них — и ищет то, чего не считает машина: два текста, говорящих об одном разное, и случай, которого не назвал ни один. Файлов не правит. Использовать перед выпуском новой редакции пакета правил и после правки закона или правила.
+tools: Read, Grep, Glob, Bash
+---
+
+Ты читаешь семью текстов слоя правил и ищешь расхождения смысла. Отвечаешь **по-русски**.
+
+Твой результат — список находок. Не правки: ты ничего не меняешь.
+
+Промах в этих текстах уезжает ко всем деревьям разом и находит его тот, кто пошёл за правилом и
+сделал не то. Считаемое — недостающий раздел, правило без паттерна, имя соседа, которому ничего
+не отвечает — уже ловит проверка. Тебе остаётся то, что видно только чтением.
+
+## Чего делать нельзя
+
+- **Никаких git-команд вообще**, включая `status` и `diff`. Историю ведёт главный агент.
+- Ничего не править: ни закон, ни правило, ни паттерн. Ты возвращаешь находки.
+- Не пересказывать найденное своими словами: находка без дословной цитаты не проверяется ничем,
+  и человек не отличит настоящее расхождение от твоего прочтения.
+- Не считать того, что уже считает проверка полноты текстов. Повтор её вывода вытесняет из
+  ответа то, ради чего тебя и звали.
+- Не судить о дереве, в котором ты запущен. Тексты пакета переносятся, и что из них разложено
+  здесь — не их предмет.
+
+## По чему идёшь
+
+Семья — это **один закон, все правила под ним и все паттерны при этих правилах**. Имя закона
+тебе даёт вызывающий. Пакет целиком не читается: текстов в нём больше десяти тысяч строк, и
+прочитанные разом они дают крошку по каждому файлу вместо находок.
+
+Правило принадлежит закону по полю `law:` в его шапке, паттерн правилу — по полю `rule:`.
+Приставка имени ненадёжна: её несут не все.
+
+**Все виды правила читаются, а не выбранный.** У одного ресурса бывает несколько редакций —
+`git-workflow.github`, `git-workflow.gitlab`, `git-workflow.azure`. Дерево раскладывает одну, и
+остальные не читает никто: разойдясь, они молчат до первого дерева, выбравшего другую.
+
+**Суффикс требования видом не является.** `entity-conventions.needs-admin`,
+`observability.needs-app` — правила, которые дерево берёт, только объявив нужную черту. В поле
+`rule:` у паттерна стоит голое имя, без обоих суффиксов: собранная по имени с суффиксом семья
+приходит без паттернов, и пустота эта выглядит как их отсутствие. Пришедшая к тебе семья без
+единого паттерна — повод сказать об этом, а не молча разобрать что дали.
+
+Ищешь два рода находок, и они разные.
+
+**Расхождение — два места, говорящих об одном разное.** Правило требует того, что паттерн при
+соседнем правиле запрещает. Закон называет одно число, правило — другое. Паттерн показывает
+приём, который правило объявило отвергнутым. Сюда же — одно понятие под двумя именами и одно имя
+над двумя понятиями.
+
+**Пробел — случай, которого не назвал ни один текст семьи.** Статья закона, под которую ни в
+одном правиле нет ни строки. Развилка, у которой описана одна ветка из двух. Отказ, о котором
+сказано, что он бывает, и не сказано, что делать. Раздел «Чего из закона здесь нет», который
+молчит о том, чего в дереве действительно нет.
+
+**Граф хода — такое же место расхождения, как проза.** Он стоит в правиле разделом «Ход»
+блоком `mermaid` и изображает тот же ход, что описан ниже словами: ветка графа, которой в прозе нет, и статья, до
+которой по графу не дойти, — расхождение того же рода, что и два текста об одном. Правится он тем
+же изменением, что и проза, и разойдясь, обе стороны читаются как действующие.
+
+Три места, где расхождения заводятся чаще прочего, — проверь каждое:
+
+- **«Чего из закона здесь нет»** — его не читает ни одна сверка, и неправда живёт в нём сколько
+  угодно: раздел говорит об отсутствии механизма, а механизм давно заведён, и заметить это может
+  только тот, кто пошёл его искать.
+- **Числа** — счёт правил, статей, шагов, строк. Они стареют без единой правки рядом.
+- **Ловушки** — их пишут по случаю и не перечитывают: приём, который они запрещают, мог с тех
+  пор стать рабочим.
+
+## Что возвращаешь
+
+Список находок, самая дорогая первой. Роды не смешивай — сперва расхождения, потом пробелы.
+
+У **расхождения**: имена обоих ресурсов, обе цитаты дословно, и одной фразой — чем именно они
+расходятся и что исполнитель сделает не так, пойдя за той или другой.
+
+У **пробела**: имя ресурса, в котором его недостаёт, цитата места, где он должен был стоять
+(или имя раздела, если места нет вовсе), и что случится, когда этот случай наступит. Второй
+цитаты у пробела не бывает — не выдумывай её.
+
+Находок нет — так и скажи. Пустой ответ дешевле выдуманного: по выдуманному правят настоящие
+тексты.

package/assets/checks/board.github.mjs

@@ -45,7 +45,7 @@ export const STATUS_FIELD_ID = BOARD.statusFieldId ?? '';
 export const STATUS_OPTIONS = BOARD.statusOptions ?? {};
 /** Колонка вновь заведённой задачи */
 export const BACKLOG_OPTION_ID = STATUS_OPTIONS.backlog?.id ?? '';
-/** Колонка задачи, взятой в работу, и задачи, отчёт по которой ждёт разбора */
+/** Колонка задачи, взятой в работу, и задачи, PR по которой ждёт разбора */
 export const IN_PROGRESS_STATUS = 'in-progress';
 export const IN_REVIEW_STATUS = 'in-review';
 /** Учётная запись машинной работы — та же, от которой идут коммиты */
@@ -69,12 +69,6 @@ if (PROJECT_ID && !TASK_KEY) {
 }
 /** Кого запрашивают на разбор: без ревьювера PR не попадает во входящие владельца. */
 export const REVIEWER = BOARD.reviewer ?? '';
-/**
- * Где лежит токен машинной учётной записи — так, как это назвало дерево. Идёт в текст отказа:
- * зашитый путь послал бы чужое дерево заводить файл, который никто не читает.
- */
-export const TOKEN_PATH = BOARD.tokenPath || 'путь не назван в .claude/rt-kit/checks.json';
-
 const BOT_TOKEN_FILE = BOARD.tokenPath ? BOARD.tokenPath.replace(/^~/, homedir()) : '';
 
 /**
@@ -89,7 +83,11 @@ function ghBinary() {
     return existsSync(homebrew) ? homebrew : 'gh';
 }
 
-/** Токен бота лежит вне репозитория и в вывод не попадает */
+/**
+ * Токен машинной записи лежит вне репозитория и в вывод не попадает. Его отсутствие — не отказ:
+ * дерево, не назвавшее токена в `board.tokenPath`, работает с очередью учётной записью, под
+ * которой залогинен клиент хостинга.
+ */
 export function botToken() {
     if (!existsSync(BOT_TOKEN_FILE)) {
         return null;
@@ -172,7 +170,7 @@ export function fetchBoard(options) {
 
 /**
  * Перевод задачи в другую колонку. Состояние задачи на борде — единственное, по чему
- * видно ход работы: ветку и открытый отчёт борда сама не читает.
+ * видно ход работы: ветку и открытый PR борда сама не читает.
  */
 export function moveTask(number, status, options) {
     const option = STATUS_OPTIONS[status];
@@ -284,11 +282,53 @@ export function taskState(number, options) {
         onBoard: item !== undefined,
         status: item?.status ?? null,
         assigned: issue.assignees.length > 0,
+        assignees: issue.assignees.map((assignee) => assignee.login),
         numbered: numberFromTitle(issue.title) === issue.number,
         labels: issue.labels.map((label) => label.name),
     };
 }
 
+/**
+ * Ответ очереди работ о заведённой задаче, сложенный в строки, и приговор: обеспечена работа
+ * или нет.
+ *
+ * Отделено от вызовов сети намеренно. Заведение кончается не выводом команды, а ответом
+ * очереди, и решение о том, что напечатать и чем кончиться, — это то самое место, где
+ * шестнадцать задач подряд прошли как успешные, не попав в очередь ни одна. Внутри вызовов
+ * сети оно проверяется только живой бордой, то есть не проверяется никогда.
+ *
+ * `state` — то, что вернул `taskState`, либо `{ offline: <причина> }`, если спросить не удалось.
+ */
+export function describeTaskState(number, state) {
+    if (state?.offline) {
+        return {
+            ok: false,
+            lines: [
+                `в очереди работ: спросить не удалось — ${state.offline}`,
+                'состояние очереди неизвестно, и заведённым это не считается',
+            ],
+        };
+    }
+    if (!state?.exists) {
+        return { ok: false, lines: [`задачи #${number} у хостинга нет — заведение не состоялось`] };
+    }
+    if (!state.onBoard) {
+        return {
+            ok: false,
+            lines: [`в очереди работ: НЕТ`, 'задача, которой нет в очереди, работой не обеспечена — по ней никто не придёт'],
+        };
+    }
+
+    const column = state.status ? `колонка «${state.status}»` : 'колонки нет';
+    if (!state.assigned) {
+        return {
+            ok: false,
+            lines: [`в очереди работ: ${column}, исполнителя нет`, 'ничья задача стоит в очереди невидимой для того, кто её делает'],
+        };
+    }
+    return { ok: true, lines: [`в очереди работ: ${column}, исполнитель ${state.assignees.join(', ')}`] };
+}
+
 const isEntryPoint = process.argv[1] && import.meta.url === `file://${process.argv[1]}`;
 if (isEntryPoint && process.argv[2] === 'task') {
     try {
@@ -303,9 +343,12 @@ if (isEntryPoint && process.argv[2] === 'task') {
     }
 }
 
-// Перевод колонки правит борду, поэтому идёт под ботом: от владельца задача выглядела бы
-// взятой в работу им самим. Отсутствие связи здесь — отказ, а не пропуск: непереставленная
-// задача молча остаётся в прежней колонке, и расхождение всплывает только сверкой очереди.
+// Перевод колонки правит борду. Токен машинной записи здесь необязателен: не назвавшее его
+// дерево правит борду учётной записью, под которой залогинен клиент хостинга. Требование
+// токена держало бы очередь работ у дерева, машинной записи не заводившего, и у дерева, чью
+// запись ограничил хостинг. Отсутствие связи при этом — по-прежнему отказ, а не пропуск:
+// непереставленная задача молча остаётся в прежней колонке, и расхождение всплывает только
+// сверкой очереди.
 if (isEntryPoint && process.argv[2] === 'move') {
     const number = Number(process.argv[3]);
     const status = process.argv[4];
@@ -313,11 +356,7 @@ if (isEntryPoint && process.argv[2] === 'move') {
         console.error(`board: нужен номер задачи и колонка — node tools/board.mjs move 263 ${IN_PROGRESS_STATUS}`);
         process.exit(1);
     }
-    const token = botToken();
-    if (!token) {
-        console.error(`board: нет токена бота (${TOKEN_PATH}) — борда правится машинной учётной записью`);
-        process.exit(1);
-    }
+    const token = botToken() ?? undefined;
     try {
         const moved = moveTask(number, status, { token });
         console.log(`#${number}: ${moved.from ?? 'вне колонок'} → ${moved.to}`);

package/assets/checks/check-board.github.mjs

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
 /**
- * Сверка очереди работ с тем, что закон о поставке требует от задачи и её отчёта.
+ * Сверка очереди работ с тем, что закон о поставке требует от задачи и её PR.
  *
  * Гард поставки отбивает промах в момент, когда его совершают, но действует только
  * на команды агента: тикет, заведённый мимо него, и PR, открытый руками, он не
@@ -15,7 +15,7 @@
  * PR, — а проверка, требующая невыполнимого, обходится, а не исполняется. Имя ветки
  * стережёт гард в момент `git checkout -b` и `gh pr create`.
  *
- * Колонку задачи судит по её отчёту: открытый PR означает разбор, отсутствие — нет.
+ * Колонку задачи судит по её PR: открытый PR означает разбор, отсутствие — нет.
  * Момент, когда задачу берут в работу, отсюда не виден вовсе — ветки на борде нет, —
  * и «In progress» здесь не требуется ни от кого.
  *
@@ -29,13 +29,16 @@ import { join } from 'node:path';
 
 import {
     IN_REVIEW_STATUS,
+    OWNER,
     OfflineError,
+    REPO,
     STATUS_OPTIONS,
     TASK_KEY,
     botToken,
     fetchBoard,
     fetchIssues,
     fetchOpenPulls,
+    gh,
     numberFromTaskDir,
     numberFromTitle,
     taskDirs,
@@ -73,6 +76,34 @@ function closesNumbers(body) {
     return [...String(body ?? '').matchAll(/\bCloses\s+#(\d+)\b/gi)].map((match) => Number(match[1]));
 }
 
+/**
+ * Строка обхода в теле PR. Форма та же, что читает гард поставки: строку она начинает и
+ * подстановки не принимает — иначе текст, называющий эту строку, снимает требование сам собой.
+ */
+const FOLDER_SKIP = /^[ \t]*Task-folder-skip:[ \t]*[^\s<"'][^\s"']{2,}/im;
+
+/**
+ * Везёт ли ветка PR папку своей задачи.
+ *
+ * Спрашивается ветка, а не рабочее дерево: папка, снесённая на машине и не закоммиченная,
+ * въедет вместе с веткой. Локальных ссылок тут мало — ветка PR может быть не подтянута
+ * сюда вовсе, — поэтому содержимое берётся у хостинга. Отказ «нет такого пути» означает, что
+ * папки нет; всё остальное поднимается выше и разбирается как отсутствие связи.
+ */
+function folderInBranch(branch, options) {
+    const path = `${CONFIG.tasksDir}/${branch}`;
+    try {
+        gh(['api', `repos/${OWNER}/${REPO}/contents/${path}?ref=${encodeURIComponent(branch)}`, '--jq', 'length'], options);
+        return path;
+    } catch (error) {
+        if (error instanceof OfflineError) {
+            throw error;
+        }
+
+        return null;
+    }
+}
+
 let checked = { issues: 0, pulls: 0 };
 
 // Черновики судятся по диску и потому проверяются всегда: связи для этого не нужно.
@@ -88,7 +119,7 @@ try {
     checked = { issues: issues.length, pulls: pulls.length };
 
     for (const item of board.foreign) {
-        report(`борда: ${item} — на борде стоят задачи, а не отчёты о них`);
+        report(`борда: ${item} — на борде стоят задачи, а не PR о них`);
     }
     // Борду проверяем только у открытых задач. Закрытая ушла из очереди мержем, и колонки под
     // неё у борды нет: строку о ней нечем закрыть. Шесть таких строк висели в каждом прогоне и
@@ -124,9 +155,22 @@ try {
         } else {
             claimed.set(titleNumber, pull.number);
         }
+
+        // Папка задачи, лежащая в ветке открытого PR, — единственное расхождение, которое
+        // сверка обязана назвать ДО слияния: гард судит её на слиянии, а слияние нажимает
+        // человек в браузере, где хуков нет вовсе. Сказанная после, эта строка уже не чинится
+        // тем же PR — работа перешла дальше, и на разбор заводится вторая задача.
+        if (!FOLDER_SKIP.test(String(pull.body ?? '')) && pull.headRefName) {
+            const folder = folderInBranch(pull.headRefName, options);
+            if (folder !== null) {
+                report(
+                    `PR #${pull.number}: ветка везёт папку задачи «${folder}/» — разбери её этим же PR или поставь в тело строку «Task-folder-skip: <причина>»`
+                );
+            }
+        }
     }
 
-    // Колонка задачи и её отчёт сверяются в обе стороны: открытый PR при задаче в «Backlog»
+    // Колонка задачи и её PR сверяются в обе стороны: открытый PR при задаче в «Backlog»
     // читается как работа, к которой не приступали, а «In review» без открытого PR — как
     // разбор, которого никто не ждёт.
     for (const issue of open) {
@@ -134,7 +178,7 @@ try {
         const pull = claimed.get(issue.number);
         if (pull !== undefined && status !== IN_REVIEW) {
             report(
-                `#${issue.number}: отчёт PR #${pull} открыт, а задача стоит «${status ?? 'вне колонок'}» — npm run task:move -- ${issue.number} ${IN_REVIEW_STATUS}`
+                `#${issue.number}: PR #${pull} открыт, а задача стоит «${status ?? 'вне колонок'}» — npm run task:move -- ${issue.number} ${IN_REVIEW_STATUS}`
             );
         }
         if (pull === undefined && status === IN_REVIEW) {

package/assets/checks/check-dupes.mjs

@@ -36,8 +36,9 @@
  *
  * Ненулевой код возврата и перечень расхождений.
  */
-import { readFileSync, readdirSync } from 'node:fs';
-import { join } from 'node:path';
+import { createRequire } from 'node:module';
+import { existsSync, readFileSync, readdirSync } from 'node:fs';
+import { dirname, join } from 'node:path';
 
 import { allowlistOf, CONFIG, ROOT } from './rt-kit-checks.config.mjs';
 
@@ -76,6 +77,56 @@ function collectFiles(dir) {
     return files;
 }
 
+/**
+ * Каталог объявлений внешнего пакета — разрешением модуля, а не путём в `node_modules`.
+ *
+ * Точек разрешения несколько: корень дерева и каждый его подпроект, объявивший этот пакет
+ * зависимостью. Пакет подпроекта в корне не лежит вовсе, и разрешение от корня его не находит;
+ * менеджер при этом вправе держать рядом несколько версий сразу, и обход хранилища по образцу
+ * пути выбрал бы ту, которую никто не ставит.
+ *
+ * Не нашлось — `null`, и внешние наборы просто не считаются: дерево без этого пакета должно
+ * получать сверку своих повторов, а не отказ чтения каталога.
+ */
+function resolveExternalDir({ package: name, dir }) {
+    for (const from of [ROOT, ...holdersOf(name)]) {
+        try {
+            const manifest = createRequire(join(from, 'package.json')).resolve(`${name}/package.json`);
+            const found = join(dirname(manifest), dir);
+            if (existsSync(found)) {
+                return found;
+            }
+        } catch {
+            // Эта точка пакета не видит — пробуется следующая.
+        }
+    }
+
+    return null;
+}
+
+/** Подпроекты, объявившие пакет зависимостью: их манифесты и есть точки разрешения. */
+function holdersOf(name) {
+    const found = [];
+    for (const root of SOURCE_ROOTS) {
+        if (!existsSync(join(ROOT, root))) {
+            continue;
+        }
+        for (const entry of readdirSync(join(ROOT, root), { withFileTypes: true })) {
+            const manifest = join(ROOT, root, entry.name, 'package.json');
+            if (!entry.isDirectory() || !existsSync(manifest)) {
+                continue;
+            }
+            const declared = JSON.parse(readFileSync(manifest, 'utf8'));
+            const fields = [declared.dependencies, declared.peerDependencies, declared.devDependencies];
+            if (fields.some((field) => field?.[name])) {
+                found.push(join(ROOT, root, entry.name));
+            }
+        }
+    }
+
+    return found;
+}
+
 /** Корень либы: путь до каталога `src`. Повтор внутри одной либы повтором не считается */
 function libOf(path) {
     const parts = path.split('/');
@@ -116,8 +167,13 @@ const MIN_TABLE_PAIRS = 2;
 /**
  * Пакеты, чьи наборы считаются наравне с либами. Своё перечисление под уже
  * объявленный там набор — такая же копия, как и между двумя либами.
+ *
+ * Имя пакета и каталог внутри него объявляет дерево; путь в `node_modules` здесь не
+ * зашивается. Пакет, объявленный зависимостью подпроекта, в корневом `node_modules` не лежит
+ * вовсе — менеджер держит его в своём хранилище, — и проверка кончалась отказом чтения
+ * каталога, не дойдя до сверки ни разу.
  */
-const EXTERNAL_ENUM_SOURCES = ['node_modules/@rt-tools/utils/esm/lib/interfaces'];
+const EXTERNAL_ENUM_SOURCES = CONFIG.externalEnums ?? [];
 
 const exportsByName = new Map();
 const settingsByName = new Map();
@@ -188,10 +244,14 @@ for (const path of SOURCE_ROOTS.flatMap((root) => collectFiles(root))) {
     collectEnums(text, lib);
 }
 
-for (const dir of EXTERNAL_ENUM_SOURCES) {
-    for (const entry of readdirSync(join(ROOT, dir), { withFileTypes: true })) {
+for (const source of EXTERNAL_ENUM_SOURCES) {
+    const dir = resolveExternalDir(source);
+    if (!dir) {
+        continue;
+    }
+    for (const entry of readdirSync(dir, { withFileTypes: true })) {
         if (entry.isFile() && entry.name.endsWith('.d.ts')) {
-            collectEnums(readFileSync(join(ROOT, dir, entry.name), 'utf8'), dir.replace('node_modules/', ''));
+            collectEnums(readFileSync(join(dir, entry.name), 'utf8'), `${source.package}/${source.dir}`);
         }
     }
 }