@rt-tools/agent-kit 0.9.1 → 0.11.0

package/README.md

@@ -228,6 +228,11 @@ npx agent-kit init --laws access,delivery,verifiability
 - **`skip`** — ресурсы, от которых проект отказался, теми же идентификаторами. Вычитает из
   выбранного, поэтому отказ от одного закона не требует переписывать весь список. Правила при
   отвергнутом законе и паттерны при них перечислять не надо: их снимает каскад.
+- **`rolesOff`** — роли, вызов которых дерево перестало считать обязательным, именами файлов
+  ролей без расширения. Гард при такой роли выходит молча, а сама роль остаётся разложенной и
+  зовётся руками. От `skip` отличается тем, что ничего не убирает: отказ от файла роли снял бы
+  её вместе с возможностью позвать, а гард при ней остался бы лежать и отбивать. Настройка,
+  которую не прочитать, выключением не считается — гард судит, как судил.
 
 ## Надстройки
 

package/assets/agents/conscience.md

@@ -0,0 +1,58 @@
+---
+name: conscience
+description: Читает разборы происшествий этого дерева и запись текущего хода и называет промах, который в нём повторяется. Файлов не правит, морали не читает. Использовать на завершении хода, на отказе гарда и после признания промаха.
+tools: Read, Grep, Glob, Bash
+---
+
+Ты смотришь на то, что исполнитель делает прямо сейчас, и говоришь, случалось ли это раньше.
+Отвечаешь **по-русски**.
+
+Разборы происшествий объясняют механизм промаха, но читает их только тот, кто открывает каталог
+сам. Промах, о котором надо напомнить, — ровно тот, о котором исполнитель в эту минуту не
+помнит: один класс промаха приезжал в приём трижды за трое суток, и под каждый раз уже была
+заведена задача.
+
+## Что тебе приходит
+
+- Путь к каталогу разборов происшествий.
+- Что исполнитель делал за этот ход: команды, правки, что он сказал владельцу.
+
+## Как ты работаешь
+
+Читаешь разборы — заголовки и раздел о механизме. Затем сверяешь их с тем, что было в ходе, и
+ищешь совпадение по **механизму**, а не по словам: тот же способ ошибиться, а не та же тема.
+
+Совпадением считается, например:
+
+- ход кончился отчётом о сделанном, а работа стоит;
+- утверждение о дереве сделано без команды, которая его подтверждает;
+- «проверено» названо о наборе уже того, что гоняет конвейер;
+- отбитая гардом правка положена другим способом;
+- следующая задача названа словами и не взята;
+- работа отдана владельцу и брошена в черновике.
+
+Находку возвращаешь так, первой строкой и машиночитаемо:
+
+```
+СОВЕСТЬ: повтор
+РАЗБОР: <имя файла разбора>
+ЧТО СЕЙЧАС: <что исполнитель делает в этом ходе, одной фразой>
+ЧЕМ КОНЧИЛОСЬ ТОГДА: <чем это кончилось в разборе, одной фразой>
+```
+
+Повтора нет — одна строка и ничего больше:
+
+```
+СОВЕСТЬ: чисто
+```
+
+## Чего ты не делаешь
+
+- Не пересказываешь разбор целиком: исполнителю нужно узнать себя, а не прочитать статью.
+- Не читаешь морали и не оцениваешь исполнителя: ты называешь механизм и его цену, а стыдить —
+  не работа.
+- Не выдумываешь повтора, чтобы не отвечать «чисто». Ложная находка стоит дороже пропущенной:
+  после второй такой тебя перестанут читать.
+- Не правишь файлов и не заводишь новых разборов: ты читаешь те, что есть.
+- Не советуешь, что делать дальше: решение — за исполнителем, твоё дело — чтобы он решал,
+  зная.

package/assets/agents/prose-editor.md

@@ -0,0 +1,44 @@
+---
+name: prose-editor
+description: Переписывает абзац, который отбила проверка слога, простыми словами и не меняя смысла. Возвращает переписанный текст и список того, что изменил. Использовать, когда гард слога отбил правку.
+tools: Read, Grep
+---
+
+Ты переписываешь текст, который проверка слога назвала канцелярским. Отвечаешь **по-русски**.
+
+Проверка видит слова и длину предложения, а читатель спотыкается о другое: о мысль, растянутую
+на три придаточных, о подлежащее, которое потерялось, о вывод, спрятанный в конце периода.
+Поэтому текст читаешь целиком, а не по одной находке.
+
+## Что тебе приходит
+
+- Абзац или несколько.
+- Находки проверки: что нашли и чем предложено заменить.
+
+## Как ты работаешь
+
+Переписываешь так, как пишут люди, которым есть что сказать:
+
+- Подлежащее называет того, кто действует. Не «производится проверка», а «проверка идёт» или
+  «гард проверяет».
+- Одно предложение — одна мысль. Длинное делишь, а не сокращаешь до телеграммы.
+- Слово выбираешь короткое и обычное, если длинное не значит чего-то другого.
+- Отглагольное существительное разворачиваешь в глагол: «осуществление записи» — «записывает».
+- Цепочку родительных падежей разбираешь: «проверка полноты набора правил дерева» — «проверка
+  смотрит, все ли правила дерева на месте».
+- Вывод ставишь первым, объяснение — вторым. Читатель бросает на середине, и бросить он должен
+  уже зная главное.
+
+**Смысла не меняешь.** Утверждение, которого в исходном тексте не было, не появляется; условие,
+которое там стояло, не пропадает. Не понял, о чём фраза, — так и говоришь: «эта фраза мне
+непонятна, перепиши сам» — вместо того чтобы придумать за автора.
+
+Возвращаешь две вещи: переписанный текст целиком и список того, что изменил, — строкой на
+правку.
+
+## Чего ты не делаешь
+
+- Не украшаешь: живой слог — это не метафоры, а понятные фразы.
+- Не сокращаешь ради краткости. Текст, из которого выкинули половину, короче и хуже.
+- Не правишь файлов: ты возвращаешь текст, вставляет его исполнитель.
+- Не споришь с проверкой и не оправдываешь находку: твоё дело — переписать.

package/assets/agents/strict-teacher.md

@@ -0,0 +1,59 @@
+---
+name: strict-teacher
+description: Спрашивает исполнителя по содержанию правил, которые он за эту сессию загрузил, и выносит вердикт — усвоено или нет. Файлов не меняет, вопросов владельцу не задаёт. Использовать на старте сессии до первой правки и перед снятием черновика с PR.
+tools: Read, Grep, Glob
+---
+
+Ты проверяешь, усвоил ли исполнитель правила, которые он в этой сессии загрузил. Отвечаешь
+**по-русски**.
+
+Загруженное правило и прочитанное правило — разные вещи. Правило на четыре сотни строк уезжает
+в контекст целиком, а исполняется выборочно: промахи случаются после того, как правило было
+загружено, и именно поэтому проверка нужна.
+
+## Что тебе приходит
+
+- Список правил, загруженных за эту сессию, — путями к файлам.
+- Ответы исполнителя, если это второй твой вызов.
+
+## Как ты работаешь
+
+**Первый вызов — вопросы.** Читаешь названные правила целиком. Выбираешь пять вопросов, и
+выбираешь их так:
+
+- Спрашиваешь то, что меняет действие, а не формулировку: порядок шагов, границу требования,
+  что делать при отказе, чего делать нельзя. Вопрос «как называется раздел» проверяет память о
+  тексте, а не усвоение правила.
+- Берёшь вопросы из разных мест правила, а не из одного раздела: усвоенным считается правило
+  целиком.
+- Спрашиваешь то, в чём ошибиться дорого. Если у правила есть раздел о промахах, разобранных в
+  этом дереве, один вопрос берёшь оттуда.
+- Не задаёшь вопросов с ответом «да» или «нет»: угаданный ответ неотличим от знания.
+
+Вопросы возвращаешь нумерованным списком, без ответов и без подсказок.
+
+**Второй вызов — вердикт.** Тебе приходят ответы. Каждый сверяешь с текстом правила, а не со
+своим мнением о том, как надо: правило — источник, ты — читатель.
+
+Ответ засчитывается, если он называет то же действие, что и правило. Пересказ другими словами —
+засчитывается; названное действие, которого в правиле нет, — нет; ответ «в правиле про это не
+сказано», когда сказано, — нет.
+
+Вердикт возвращаешь так, первой строкой и машиночитаемо:
+
+```
+ЭКЗАМЕН: сдано 4 из 5
+НЕ УСВОЕНО: <путь к правилу> — <что именно не усвоено, одной фразой>
+```
+
+Сдано — это пять из пяти. Любой незасчитанный ответ означает, что правило перечитывается
+целиком, а не тот его кусок, о котором спрашивали: исполнитель, которому показали ответ, знает
+одну строку, а не правило.
+
+## Чего ты не делаешь
+
+- Не правишь файлов и не предлагаешь правок в правила: твой предмет — исполнитель, а не текст.
+- Не задаёшь вопросов владельцу: ты возвращаешь текст главному агенту.
+- Не показываешь ответов вместе с вопросами и не подсказываешь при провале: назвать, что не
+  усвоено, — твоя работа; научить — работа правила.
+- Не смягчаешь вердикт. «Почти верно» — это не сдано.

package/assets/checks/board.github.mjs

@@ -203,13 +203,55 @@ export function fetchIssue(number, options) {
     }
 }
 
+/**
+ * Состояние заявки в терминах поставки: существует, черновик ли она и есть ли у неё разбор —
+ * запрошенный ревьювер либо уже оставленный отзыв.
+ *
+ * Ревьювера до этой правки не спрашивал никто: он жил прозой в паттерне о коммите и PR, и
+ * запрос разбора на самого себя хостинг принимает молча — разбор при этом выглядит
+ * запрошенным, а его нет.
+ */
+export function pullState(ref, options) {
+    // Ссылка на заявку необязательна: клиент хостинга без неё берёт заявку текущей ветки, и
+    // это самая короткая форма вызова. Требовать номер значило бы молча пропускать её.
+    const target = ref === undefined || ref === null || `${ref}`.trim() === '' ? [] : [`${ref}`.trim()];
+    let pull;
+    try {
+        pull = ghJson(['pr', 'view', ...target, '--json', 'number,isDraft,reviewRequests,latestReviews,author,mergeable'], options);
+    } catch (error) {
+        if (error instanceof OfflineError) {
+            throw error;
+        }
+        return { exists: false };
+    }
+    if (!pull) {
+        return { exists: false };
+    }
+    const requested = (pull.reviewRequests ?? []).map((entry) => entry.login ?? entry.name ?? '').filter(Boolean);
+    const reviewed = (pull.latestReviews ?? []).map((entry) => entry.author?.login ?? '').filter(Boolean);
+    const reviewers = [...new Set([...requested, ...reviewed])];
+    return {
+        exists: true,
+        number: pull.number ?? null,
+        draft: pull.isDraft === true,
+        author: pull.author?.login ?? null,
+        reviewers,
+        reviewed: reviewers.filter((login) => login !== (pull.author?.login ?? null)).length > 0,
+        // Конфликт приезжает в отданную заявку чужим слиянием, без единого действия её автора:
+        // хостинг считает сливаемость заново после каждой правки главной ветки. Судится только
+        // прямое «конфликтует»: `UNKNOWN` означает, что хостинг ещё считает, и читать его как
+        // конфликт значило бы отбивать работу на каждой свежей вершине.
+        conflicting: pull.mergeable === 'CONFLICTING',
+    };
+}
+
 /**
  * Вершина берётся вместе с остальным: спросить её потом значило бы второй вызов на каждый PR,
  * а судят по ней и папку задачи, и прогон.
  */
 export function fetchOpenPulls(options) {
     return ghJson(
-        ['pr', 'list', '--state', 'open', '--limit', '200', '--json', 'number,title,headRefName,headRefOid,isDraft,body'],
+        ['pr', 'list', '--state', 'open', '--limit', '200', '--json', 'number,title,headRefName,headRefOid,isDraft,body,mergeable'],
         options
     );
 }
@@ -390,6 +432,19 @@ if (isEntryPoint && process.argv[2] === 'task') {
     }
 }
 
+if (isEntryPoint && process.argv[2] === 'pr') {
+    try {
+        process.stdout.write(`${JSON.stringify(pullState(process.argv[3]))}\n`);
+    } catch (error) {
+        if (error instanceof OfflineError) {
+            process.stdout.write('{"offline":true}\n');
+        } else {
+            process.stdout.write(`${JSON.stringify({ error: String(error.message ?? error) })}\n`);
+            process.exit(1);
+        }
+    }
+}
+
 // Перевод колонки правит борду. Токен машинной записи здесь необязателен: не назвавшее его
 // дерево правит борду учётной записью, под которой залогинен клиент хостинга. Требование
 // токена держало бы очередь работ у дерева, машинной записи не заводившего, и у дерева, чью

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

@@ -178,6 +178,28 @@ function checkReadyDraft(pull, options) {
     );
 }
 
+/**
+ * Заявка, конфликтующая с главной веткой.
+ *
+ * Конфликт приезжает в отданную заявку чужим слиянием, без единого действия её автора: основание,
+ * проверенное на открытии, устаревает в ту минуту, когда владелец влил соседнюю работу. Гард
+ * снятия черновика сюда не достаёт — он судит один ход, а заявка стоит в очереди днями.
+ *
+ * Судится только прямое «конфликтует»: `UNKNOWN` означает, что хостинг сливаемость ещё считает,
+ * и строка о нём краснела бы на каждой свежей вершине. Две заявки так и ушли в разбор с
+ * конфликтом — разбор `docs/postmortems/2026-08-20-drafts-cleared-without-re-reading-pr-state.md`.
+ */
+function checkConflicting(pull) {
+    if (pull.mergeable !== 'CONFLICTING') {
+        return;
+    }
+
+    report(
+        `PR #${pull.number}: конфликтует с главной веткой — влей её в ветку задачи, разбери конфликт и запушь; ` +
+            `слить эту заявку владелец не может, а по странице это видно только внутри неё`
+    );
+}
+
 let checked = { issues: 0, pulls: 0 };
 
 // Черновики судятся по диску и потому проверяются всегда: связи для этого не нужно.
@@ -238,6 +260,8 @@ try {
             checkHeadRun(pull, options);
         }
 
+        checkConflicting(pull);
+
         if (!FOLDER_SKIP.test(String(pull.body ?? '')) && pull.headRefName) {
             const folder = folderInBranch(pull.headRefName, options);
             if (folder !== null) {

package/assets/checks/check-doc-paths.mjs

@@ -30,7 +30,7 @@ import { spawnSync } from 'node:child_process';
 import { existsSync, readFileSync, readdirSync } from 'node:fs';
 import { join } from 'node:path';
 
-import { allowlistOf, CONFIG, ROOT } from './rt-kit-checks.config.mjs';
+import { allowlistOf, CONFIG, ROOT, parseAllowlist } from './rt-kit-checks.config.mjs';
 
 const ALLOWLIST = allowlistOf('doc-paths');
 // `worktrees` — копии репозитория под каталогом агента: их документы описывают раскладку
@@ -76,17 +76,6 @@ const problems = [];
 const indexProblems = [];
 const report = (doc, line, path) => problems.push(`${doc}:${line}: нет файла \`${path}\``);
 
-function readAllowlist() {
-    const path = join(ROOT, ALLOWLIST);
-    if (!existsSync(path)) {
-        return { files: [], paths: [] };
-    }
-
-    const raw = JSON.parse(readFileSync(path, 'utf8'));
-
-    return { files: raw.files ?? [], paths: raw.paths ?? [] };
-}
-
 function collectDocs(dir = '.') {
     const entries = readdirSync(join(ROOT, dir), { withFileTypes: true });
     const found = [];
@@ -307,9 +296,9 @@ function reportIndex() {
     );
 }
 
-const allowlist = readAllowlist();
-const allowedPaths = new Set(allowlist.paths);
-const collected = collectDocs().filter((doc) => !allowlist.files.includes(doc) && !isSkipped(doc));
+const allowlist = parseAllowlist('doc-paths', ['files', 'paths']);
+const allowedPaths = new Set(allowlist.paths.keys());
+const collected = collectDocs().filter((doc) => !allowlist.files.has(doc) && !isSkipped(doc));
 const dropped = droppedByGit(collected);
 const docs = collected.filter((doc) => !dropped.has(doc));
 

package/assets/checks/check-dupes.mjs

@@ -40,7 +40,7 @@ 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';
+import { allowlistOf, baselineOf, CONFIG, ROOT, parseAllowlist } from './rt-kit-checks.config.mjs';
 
 const ALLOWLIST = allowlistOf('dupes');
 /**
@@ -57,9 +57,9 @@ const SKIPPED_DIRS = CONFIG.skippedDirs;
 /** Минимум членов, при котором совпадение набора перечислений о чём-то говорит */
 const MIN_ENUM_MEMBERS = 2;
 
-const allowlist = JSON.parse(readFileSync(join(ROOT, ALLOWLIST), 'utf8'));
-const known = new Set([...(allowlist.accepted ?? []), ...(allowlist.debt ?? [])]);
-const debt = new Set(allowlist.debt ?? []);
+const allowlist = parseAllowlist('dupes');
+const known = allowlist.keys;
+const debt = new Set(allowlist.debt.keys());
 
 function collectFiles(dir) {
     const files = [];
@@ -318,8 +318,7 @@ const fresh = findings.filter((finding) => !known.has(finding.key));
 const staleKeys = [...known].filter((key) => !findings.some((finding) => finding.key === key));
 
 if (process.argv.includes('--baseline')) {
-    const keys = findings.map((finding) => finding.key).sort();
-    console.log(JSON.stringify({ ...allowlist, debt: keys }, null, 4));
+    console.log(baselineOf(findings.map((finding) => finding.key).sort(), allowlist));
     process.exit(0);
 }
 

package/assets/checks/check-file-size.mjs

@@ -32,7 +32,7 @@ import { execFileSync } from 'node:child_process';
 import { existsSync, readFileSync } from 'node:fs';
 import { join } from 'node:path';
 
-import { allowlistOf, CONFIG, ROOT } from './rt-kit-checks.config.mjs';
+import { allowlistOf, baselineOf, CONFIG, ROOT, parseAllowlist } from './rt-kit-checks.config.mjs';
 
 const ALLOWLIST = allowlistOf('file-size');
 /** Предел один на все роды файлов: своё число каждому роду — спор о числе на каждой правке. */
@@ -69,23 +69,9 @@ function lineCount(path) {
  * не пустой список, а нечитаемая настройка, и молчать о ней нельзя. Пустой список законен
  * ровно один раз — в дереве, где длинных файлов нет вовсе.
  */
-function readKnown() {
-    const path = join(ROOT, ALLOWLIST);
-    if (!existsSync(path)) {
-        return { accepted: [], debt: [] };
-    }
-    try {
-        const parsed = JSON.parse(readFileSync(path, 'utf8'));
-
-        return { accepted: parsed.accepted ?? [], debt: parsed.debt ?? [] };
-    } catch (error) {
-        console.error(`check-file-size: список известного не прочитан — ${ALLOWLIST}: ${error.message}`);
-        process.exit(1);
-    }
-}
-
-const { accepted, debt } = readKnown();
-const known = new Map([...accepted.map((path) => [path, 'принято']), ...debt.map((path) => [path, 'долг'])]);
+const allowlist = parseAllowlist('file-size');
+const { accepted, debt } = allowlist;
+const known = new Map([...[...accepted.keys()].map((path) => [path, 'принято']), ...[...debt.keys()].map((path) => [path, 'долг'])]);
 
 const tooLong = new Map();
 const tracked = trackedFiles().filter(judged);
@@ -98,7 +84,7 @@ for (const path of tracked) {
 }
 
 if (process.argv.includes('--baseline')) {
-    console.log(JSON.stringify({ accepted, debt: [...tooLong.keys()].sort() }, null, 4));
+    console.log(baselineOf([...tooLong.keys()].sort(), allowlist));
     process.exit(0);
 }
 
@@ -123,5 +109,5 @@ if (problems.length > 0) {
 
 console.log(
     `check-file-size: проверено ${tracked.length} файлов, длиннее ${LIMIT} строк ${tooLong.size}, ` +
-        `из них принято ${accepted.length}, долг ${debt.length} — новых нет`
+        `из них принято ${accepted.size}, долг ${debt.size} — новых нет`
 );

package/assets/checks/check-prose-style.mjs

@@ -0,0 +1,137 @@
+#!/usr/bin/env node
+/**
+ * Проверка слога: канцелярит и обороты, которых в этом дереве не пишут.
+ *
+ * Правило о текстах требует простых слов, а проверки на это не было: формулировочные
+ * договорённости закон оставлял автору целиком, и держались они памятью того, кто пишет.
+ * Держались плохо — владелец читает написанное и видит машинный слог там, где договорённость
+ * требует человеческого.
+ *
+ * Ловится не стиль вообще, а перечисленные признаки, и каждый назван вместе с заменой: список
+ * запретов без замены читается как запрет писать, и автор обходит его, а не правит текст.
+ *
+ * Чего проверка не видит и видеть не будет: связности, повторов мысли, верности утверждения.
+ * Абзац из коротких предложений с чистыми словами проходит её целиком, ничего при этом не
+ * значая. Это её граница, а не обещание.
+ *
+ * Ненулевой код возврата и перечень находок: файл, строка, что нашли, чем заменить.
+ *
+ * Границы слова пишутся оглядкой на буквы, а не `\b`: он считается по ASCII, кириллица под `\w`
+ * не подпадает, и образец с ним молча не срабатывает ни разу.
+ */
+import { readFileSync } from 'node:fs';
+
+/** Предел длины предложения в словах. Дальше читатель теряет начало. */
+const WORDS_LIMIT = 40;
+
+/**
+ * Признаки канцелярита. Каждый — образец и то, чем его заменить: без замены находка
+ * читается как запрет писать.
+ */
+const MARKS = [
+    [/(?<![а-яёА-ЯЁ])является(?![а-яёА-ЯЁ])/giu, 'сказать глаголом: «это», «работает», «стоит»'],
+    [/(?<![а-яёА-ЯЁ])осуществля(ет|ется|ть)(?![а-яёА-ЯЁ])/giu, 'назвать само действие: «делает», «идёт»'],
+    [/(?<![а-яёА-ЯЁ])производится(?![а-яёА-ЯЁ])/giu, 'кто производит — тот и подлежащее'],
+    [/(?<![а-яёА-ЯЁ])в целях(?![а-яёА-ЯЁ])/giu, '«чтобы»'],
+    [/(?<![а-яёА-ЯЁ])с целью(?![а-яёА-ЯЁ])/giu, '«чтобы»'],
+    [/(?<![а-яёА-ЯЁ])в случае, если(?![а-яёА-ЯЁ])/giu, '«если»'],
+    [/(?<![а-яёА-ЯЁ])при условии, что(?![а-яёА-ЯЁ])/giu, '«если»'],
+    [/(?<![а-яёА-ЯЁ])в рамках(?![а-яёА-ЯЁ])/giu, 'назвать отношение прямо: «в», «при», «для»'],
+    [/(?<![а-яёА-ЯЁ])на основании(?![а-яёА-ЯЁ])/giu, '«по»'],
+    [/(?<![а-яёА-ЯЁ])посредством(?![а-яёА-ЯЁ])/giu, '«через», «командой», «вызовом»'],
+    [/(?<![а-яёА-ЯЁ])данн(ый|ая|ое|ые)(?![а-яёА-ЯЁ])/giu, '«этот» или ничего'],
+    [/(?<![а-яёА-ЯЁ])соответствующ(ий|ая|ее|ие)(?![а-яёА-ЯЁ])/giu, 'назвать, чему именно соответствует'],
+    [/(?<![а-яёА-ЯЁ])необходимо(?![а-яёА-ЯЁ])/giu, '«надо» или повелительное наклонение'],
+    [/(?<![а-яёА-ЯЁ])должен быть (выполнен|произведён|осуществлён)(?![а-яёА-ЯЁ])/giu, 'сказать, кто это делает'],
+    [/(?<![а-яёА-ЯЁ])имеет место(?![а-яёА-ЯЁ])/giu, '«есть», «случается»'],
+    [/(?<![а-яёА-ЯЁ])в дальнейшем(?![а-яёА-ЯЁ])/giu, '«дальше», «потом»'],
+    [/(?<![а-яёА-ЯЁ])таким образом(?![а-яёА-ЯЁ])/giu, 'убрать или сказать, что из чего следует'],
+    [/(?<![а-яёА-ЯЁ])следует отметить(?![а-яёА-ЯЁ])/giu, 'убрать: если стоит отметить — отмечай'],
+    [/(?<![а-яёА-ЯЁ])как уже было сказано(?![а-яёА-ЯЁ])/giu, 'убрать: сказанное дважды не становится вернее'],
+];
+
+/** Слова левой колонки словаря: они не пишутся и не произносятся нигде. */
+const GLOSSARY_BANS = [
+    [/(?<![а-яёА-ЯЁ])таск[аиуе](?![а-яёА-ЯЁ])/giu, 'задача'],
+    [/(?<![а-яёА-ЯЁ])тикет[а-яё]*(?![а-яёА-ЯЁ])/giu, 'задача'],
+    [/(?<![а-яёА-ЯЁ])пул-реквест[а-яё]*(?![а-яёА-ЯЁ])/giu, 'PR'],
+    [/(?<![а-яёА-ЯЁ])джоб[аыуе](?![а-яёА-ЯЁ])/giu, 'шаг конвейера'],
+    [/(?<![а-яёА-ЯЁ])пайплайн[а-яё]*(?![а-яёА-ЯЁ])/giu, 'конвейер'],
+    [/(?<![а-яёА-ЯЁ])хендофф[а-яё]*(?![а-яёА-ЯЁ])/giu, 'передача'],
+    [/(?<![а-яёА-ЯЁ])бэклог[а-яё]*(?![а-яёА-ЯЁ])/giu, 'очередь работ'],
+    [/(?<![а-яёА-ЯЁ])скилл[а-яё]*(?![а-яёА-ЯЁ])/giu, 'правило, паттерн или скил без закона'],
+];
+
+const CODE_FENCE = /^\s*```/;
+
+/**
+ * Заголовки, которые совпадают с образцом канцелярита, но прозой не являются: это имена
+ * обязательных разделов спека, и набор разделов требует их дословно.
+ *
+ * Перечислены поимённо, а не сняты правилом: слово «данные» в предложении канцеляритом быть не
+ * перестаёт — «данные требования» ловится по-прежнему. Без этого исключения ни один новый спек
+ * не написать вовсе: набор разделов требует заголовок, а проверка слога его отбивает, и оба
+ * требования верны каждое по-своему.
+ */
+const HEADING_EXCEPTIONS = new Set(['Данные']);
+
+/** Заголовок, чьё имя названо исключением: судить в нём нечего — это имя раздела, а не фраза. */
+function isExemptHeading(line) {
+    const heading = line.match(/^\s*#{1,6}\s+(.+?)\s*$/);
+
+    return heading !== null && HEADING_EXCEPTIONS.has(heading[1]);
+}
+
+/** Строки вне блоков кода: в блоках лежат команды и вывод, и слог там не судится. */
+function proseLines(text) {
+    const out = [];
+    let inFence = false;
+    text.split('\n').forEach((line, index) => {
+        if (CODE_FENCE.test(line)) {
+            inFence = !inFence;
+            return;
+        }
+        if (inFence) return;
+        if (isExemptHeading(line)) return;
+        out.push([index + 1, line]);
+    });
+    return out;
+}
+
+/** Находки одной строки: образец, что нашли, чем заменить. */
+function findingsIn(line) {
+    const found = [];
+    [...MARKS, ...GLOSSARY_BANS].forEach(([re, fix]) => {
+        const hit = line.match(re);
+        if (hit) found.push([hit[0], fix]);
+    });
+    return found;
+}
+
+/** Слишком длинное предложение: читатель теряет начало раньше, чем автор доходит до конца. */
+function longSentences(line) {
+    return line
+        .split(/(?<=[.!?])\s+/)
+        .filter((sentence) => sentence.trim().split(/\s+/).length > WORDS_LIMIT)
+        .map((sentence) => [`${sentence.trim().split(/\s+/).length} слов в предложении`, `делить: предел ${WORDS_LIMIT}`]);
+}
+
+export function checkProse(text) {
+    return proseLines(text).flatMap(([number, line]) =>
+        [...findingsIn(line), ...longSentences(line)].map(([what, fix]) => ({ line: number, what, fix }))
+    );
+}
+
+const files = process.argv.slice(2);
+if (files.length > 0) {
+    const problems = files.flatMap((file) =>
+        checkProse(readFileSync(file, 'utf8')).map((p) => `  ${file}:${p.line} — «${p.what}» → ${p.fix}`)
+    );
+    if (problems.length > 0) {
+        console.error(`check-prose-style: находок ${problems.length}\n`);
+        problems.forEach((p) => console.error(p));
+        console.error('\nСлог — правило о текстах. Проверка видит перечисленные признаки и только их.');
+        process.exit(1);
+    }
+    console.log(`check-prose-style: проверено файлов ${files.length}, находок нет`);
+}

package/assets/checks/check-reuse.mjs

@@ -25,7 +25,7 @@
 import { readFileSync, readdirSync } from 'node:fs';
 import { join } from 'node:path';
 
-import { allowlistOf, CONFIG, ROOT } from './rt-kit-checks.config.mjs';
+import { allowlistOf, baselineOf, CONFIG, ROOT, parseAllowlist } from './rt-kit-checks.config.mjs';
 import { loadSignals } from './signals.mjs';
 
 const ALLOWLIST = allowlistOf('reuse');
@@ -97,9 +97,9 @@ function withoutMarked(text) {
     return lines.filter((line, index) => !line.includes('native-ok') && !lines[index - 1]?.includes('native-ok')).join('\n');
 }
 
-const allowlist = JSON.parse(readFileSync(join(ROOT, ALLOWLIST), 'utf8'));
-const known = new Set([...(allowlist.accepted ?? []), ...(allowlist.debt ?? [])]);
-const debt = new Set(allowlist.debt ?? []);
+const allowlist = parseAllowlist('reuse');
+const known = allowlist.keys;
+const debt = new Set(allowlist.debt.keys());
 
 const findings = [];
 for (const root of SOURCE_ROOTS) {
@@ -122,7 +122,7 @@ const fresh = findings.filter((finding) => !known.has(finding.key));
 const stale = [...known].filter((key) => !findings.some((finding) => finding.key === key));
 
 if (process.argv.includes('--baseline')) {
-    console.log(JSON.stringify({ ...allowlist, debt: findings.map((finding) => finding.key).sort() }, null, 4));
+    console.log(baselineOf(findings.map((finding) => finding.key).sort(), allowlist));
     process.exit(0);
 }