@rt-tools/agent-kit 0.22.0 → 0.23.0

package/assets/checks/board-long-work.github.mjs

@@ -0,0 +1,101 @@
+/**
+ * Работа, которую одним заходом не закрыть: метка карточки против записи в линии работ.
+ *
+ * Своим файлом по той же причине, что и связь с эпиком: сверка очереди работ и без них стоит у
+ * предела длины, а читают эти проверки порознь.
+ *
+ * Помечена такая работа в двух местах, и одна метка без другой лжёт молча: исполнитель открывает
+ * карточку раньше, чем линию работ, а планирует по линии. Карточка без записи обещает
+ * многозаходность, которой линия не знает; запись без метки оставляет карточку выглядеть работой
+ * на один заход — и следующий заход берёт её, рассчитывая закрыть за раз.
+ */
+import { existsSync, readdirSync, readFileSync } from 'node:fs';
+import { join } from 'node:path';
+
+import { TASK_KEY } from './board.mjs';
+import { CONFIG, ROOT } from './rt-kit-checks.config.mjs';
+
+/**
+ * Метка многозаходной карточки и каталог линий работ. Не названо любое из двух — связь не
+ * судится вовсе: отличить многозаходную карточку от обычной станет нечем, а каталог линий у
+ * каждого дерева свой.
+ */
+const LONG_LABEL = CONFIG.longWork?.label ?? '';
+const PLANS_DIR = CONFIG.longWork?.plansDir ?? '';
+
+/** Строки линий работ, где стоит слово метки: только они считаются записью о многозаходности. */
+function markedRows() {
+    const dir = join(ROOT, PLANS_DIR);
+    if (!existsSync(dir)) {
+        return null;
+    }
+
+    const rows = [];
+    for (const name of readdirSync(dir).filter((one) => one.endsWith('.md'))) {
+        for (const line of readFileSync(join(dir, name), 'utf8').split('\n')) {
+            if (line.includes(LONG_LABEL)) {
+                rows.push({ file: name, line });
+            }
+        }
+    }
+
+    return rows;
+}
+
+/**
+ * Связь метки с линией работ, прочитанная в обе стороны.
+ *
+ * Записью считается строка, где стоят и слово метки, и номер задачи. Голое упоминание номера не
+ * годится: линия работ называет все свои задачи, и большинство из них однозаходные — обратная
+ * сторона краснела бы на каждой.
+ *
+ * Судится только открытое, как и вся остальная сверка: закрытая задача — история, и строку о ней
+ * нечем закрыть.
+ */
+export function checkLongWork(open, report) {
+    if (!LONG_LABEL || !PLANS_DIR) {
+        return;
+    }
+
+    const rows = markedRows();
+    if (rows === null) {
+        report(`каталога линий работ «${PLANS_DIR}» нет на диске — многозаходную работу сверять не с чем`);
+
+        return;
+    }
+
+    // Номера, названные в помеченных строках. Ключ задачи и решётка читаются оба: линия пишется
+    // человеком, и форма номера в ней от строки к строке разная.
+    const written = new Set();
+    const whereWritten = new Map();
+    for (const row of rows) {
+        for (const match of row.line.matchAll(new RegExp(`(?:#|${TASK_KEY}-)(\\d+)`, 'g'))) {
+            const number = Number(match[1]);
+            written.add(number);
+            if (!whereWritten.has(number)) {
+                whereWritten.set(number, row.file);
+            }
+        }
+    }
+
+    const labelled = new Set(
+        open.filter((issue) => (issue.labels ?? []).some((label) => label.name === LONG_LABEL)).map((issue) => issue.number)
+    );
+
+    for (const number of labelled) {
+        if (!written.has(number)) {
+            report(
+                `#${number}: помечена как «${LONG_LABEL}», а в линиях работ «${PLANS_DIR}» такой строки нет — планируют по линии, а не по карточке`
+            );
+        }
+    }
+
+    // Обратная сторона: линия знает работу многозаходной, а карточка выглядит работой на один
+    // заход — и следующий заход берёт её, рассчитывая закрыть за раз.
+    const byNumber = new Set(open.map((issue) => issue.number));
+    for (const number of written) {
+        if (byNumber.has(number) && !labelled.has(number)) {
+            report(`#${number}: линия работ «${whereWritten.get(number)}» знает её многозаходной, а метки «${LONG_LABEL}» на карточке нет`);
+        }
+    }
+}

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

@@ -65,6 +65,40 @@ export function deployLag(workflow, mainBranch, options) {
     return { sha: run.sha, at: run.at, behind: Number(String(behind).trim()) };
 }
 
+/**
+ * Чем кончилась последняя выкатка: `success`, `failure`, `running` либо `none`, если её не
+ * запускали ни разу.
+ *
+ * Спрашивается отдельно от отставания прода. Отставание считается по последней УСПЕШНОЙ выкатке,
+ * и две разные беды выглядят через него одинаково: выкатку не запускали и выкатка упала. Ведут
+ * они к разному — первую запускают, вторую читают журналом и чинят, — а четыре слияния подряд
+ * уехали поверх поломки, которую принёс первый, и прод простоял почти два часа.
+ *
+ * Идущая выкатка расхождением не считается: она ещё может кончиться успехом.
+ */
+export function lastDeploy(workflow, options) {
+    const runs = gh(
+        [
+            'api',
+            `repos/${OWNER}/${REPO}/actions/workflows/${encodeURIComponent(workflow)}/runs?per_page=1`,
+            '--jq',
+            '[.workflow_runs[] | {status, conclusion, sha: .head_sha, at: .created_at, url: .html_url}] | first // empty',
+        ],
+        options
+    );
+    const last = String(runs).trim();
+    if (!last) {
+        return { verdict: 'none' };
+    }
+
+    const run = JSON.parse(last);
+    if (run.status !== 'completed') {
+        return { verdict: 'running', ...run };
+    }
+
+    return { verdict: run.conclusion === 'success' ? 'success' : 'failure', ...run };
+}
+
 /**
  * Чем кончились прогоны на этой вершине: `success`, если все завершились успехом, `running`,
  * если хоть один ещё идёт, `failure` — если хоть один упал. Прогонов нет вовсе — `none`.

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

@@ -50,7 +50,8 @@ import {
     taskDirs,
 } from './board.mjs';
 import { onlyIgnoredPaths } from './board-paths.mjs';
-import { HAS_PIPELINE, deployLag, evictedOnHead, headCommittedAt, runsOnHead, verdictOnHead } from './board-runs.mjs';
+import { checkLongWork } from './board-long-work.mjs';
+import { HAS_PIPELINE, deployLag, evictedOnHead, headCommittedAt, lastDeploy, runsOnHead, verdictOnHead } from './board-runs.mjs';
 import { checkEpicLinks } from './board-epics.mjs';
 import { similarTitles } from './board-titles.mjs';
 import { CONFIG, ROOT } from './rt-kit-checks.config.mjs';
@@ -317,6 +318,7 @@ try {
 
     similarTitles(open);
     checkEpicLinks(open, report);
+    checkLongWork(open, report);
 
     const openNumbers = new Set(open.map((issue) => issue.number));
     const claimed = new Map();
@@ -415,7 +417,8 @@ try {
 // сколько угодно коммитов, и заметить это неоткуда.
 if (!offline && DEPLOY_WORKFLOW) {
     try {
-        const lag = deployLag(DEPLOY_WORKFLOW, MAIN_BRANCH, { token: botToken() ?? undefined });
+        const token = botToken() ?? undefined;
+        const lag = deployLag(DEPLOY_WORKFLOW, MAIN_BRANCH, { token });
         if (lag === null) {
             report(`выкаток по «${DEPLOY_WORKFLOW}» не было ни одной — сравнить прод не с чем`);
         } else if (lag.behind > 0) {
@@ -423,6 +426,17 @@ if (!offline && DEPLOY_WORKFLOW) {
                 `прод отстал от «${MAIN_BRANCH}» на ${lag.behind} коммитов: последняя выкатка — ${lag.sha.slice(0, 8)} от ${String(lag.at).slice(0, 10)}`
             );
         }
+
+        // Отчего прод отстал, отставание не говорит: оно считается по последней УСПЕШНОЙ
+        // выкатке, и «не запускали» с «упала» выглядят через него одинаково. Ведут они к
+        // разному — первую запускают, вторую читают журналом и чинят.
+        const deploy = lastDeploy(DEPLOY_WORKFLOW, { token });
+        if (deploy.verdict === 'failure') {
+            report(
+                `выкатка «${DEPLOY_WORKFLOW}» упала на ${String(deploy.sha).slice(0, 8)} от ${String(deploy.at).slice(0, 10)}: ` +
+                    `главная ветка впереди прода, и слияния поверх уедут туда же — ${deploy.url}`
+            );
+        }
     } catch (error) {
         if (error instanceof OfflineError) {
             console.log(`check-board: прод не сверялся — ${error.message}`);

package/assets/checks/check-reuse.mjs

@@ -137,7 +137,10 @@ if (process.argv.includes('--baseline')) {
 }
 
 const problems = [
-    ...fresh.map((finding) => `${finding.key} — готовое: ${finding.instead}`),
+    // Готовое названо оговоркой намеренно: признак судит тег, а место показа — нет. Замена своего
+    // абзаца отказа на готовый компонент того же экрана закрывает признак и оставляет нарушение
+    // на месте — так починили тринадцать шаблонов сразу. Строка вывода — измерение, а не задание.
+    ...fresh.map((finding) => `${finding.key} — готовое (если место показа верно): ${finding.instead}`),
     ...stale.map((key) => `${key}: значится в ${ALLOWLIST}, а в дереве такого расхождения больше нет — строку поправить или убрать`),
 ];
 

package/assets/checks/check-schema-drift.mjs

@@ -83,6 +83,43 @@ function shadowAddresses(url) {
 // которой нечего смотреть, поломкой не является.
 const SKIP = Number(process.env.RT_SKIP_CODE ?? 7);
 
+/**
+ * Тронула ли ветка хранилище — схему либо каталог миграций.
+ *
+ * Пропуск проверки законен ровно до этой черты. База на машине разработчика бывает погашена
+ * буднично, и отбивать за это пуш документации не за что; но ветка, правившая миграции, без
+ * прогона цепочки уезжает в главную вслепую — и падает не у неё, а на выкатке. Так и упал прод:
+ * пять полей появились в схеме без миграций, часть страниц стала отвечать «не найдено», полчаса
+ * недоступности, чинили откатом. Гейт при этом был зелёным: проверка вернула код пропуска.
+ *
+ * Смотрятся обе стороны — незакоммиченное в рабочем дереве и вклад ветки от главной. Одного
+ * вклада мало: правка, ещё не попавшая в коммит, уходит тем же пушем следом.
+ *
+ * ОТКАЗ В ПОЛЬЗУ РАБОТЫ: нет git, нет главной ветки, вызов упал — считается, что не тронула.
+ * Проверка, отбивающая пуш по своей слепоте, хуже пропуска: чинить в ней нечего.
+ */
+function touchedStorage() {
+    const paths = [CONFIG.schemaFile, CONFIG.migrationsDir].filter(Boolean);
+    if (!paths.length) {
+        return false;
+    }
+
+    const git = (args) => {
+        const out = spawnSync('git', args, { cwd: ROOT, encoding: 'utf8' });
+
+        return out.status === 0 ? (out.stdout ?? '') : '';
+    };
+
+    // Главная ветка берётся удалённой ссылкой: локальная — снимок последнего подтягивания, и
+    // вклад, посчитанный от неё, врёт ровно в ту сторону, где проверка молчит.
+    const main = CONFIG.mainBranch ?? 'main';
+    const base = [`origin/${main}`, main].find((ref) => git(['rev-parse', '--verify', '--quiet', ref]).trim()) ?? '';
+
+    const changed = [git(['status', '--porcelain']), base ? git(['diff', '--name-only', `${base}...HEAD`]) : ''].join('\n');
+
+    return paths.some((one) => changed.split('\n').some((line) => line.includes(one)));
+}
+
 function prisma(args, url) {
     return spawnSync('npx', ['prisma', ...args], {
         cwd: ROOT,
@@ -103,9 +140,7 @@ async function withServiceClient(serviceUrl, run) {
         // Погашенный докер — обычное состояние машины, а не повод не дать запушить
         // документацию.
         if (SERVER_DOWN_CODES.includes(error?.code)) {
-            console.log('check-schema-drift: база недоступна — сверять негде');
-
-            return SKIP;
+            return unavailable('база недоступна');
         }
         throw error;
     }
@@ -117,6 +152,32 @@ async function withServiceClient(serviceUrl, run) {
     }
 }
 
+/**
+ * Ответ на «проверять негде»: пропуск либо отказ — смотря тронула ли ветка хранилище.
+ *
+ * Отказ называет, чем поднять базу. Сказанное только «негде» исполнитель читает как разрешение:
+ * поднимать её он не обязан, а гейт зелёный.
+ */
+function unavailable(why) {
+    if (!touchedStorage()) {
+        console.log(`check-schema-drift: ${why} — сверять негде`);
+
+        return SKIP;
+    }
+
+    console.error(`check-schema-drift: ${why}, а ветка правила схему или миграции — сверять негде, но было чем\n`);
+    console.error(
+        'Цепочка миграций на пустом хранилище — единственное место, где виден их настоящий порядок:\n' +
+            'метку времени ставит момент создания, и миграция из ветки, начатой раньше, встаёт перед той,\n' +
+            'от которой зависит. На развёрнутом хранилище разработчика она ложится, на чистом падает — и\n' +
+            'видно это в первый раз на выкатке.\n\n' +
+            'Подними базу и повтори; когда её под рукой нет, цепочка гоняется на одноразовом контейнере —\n' +
+            'готовые команды в паттерне `git-workflow-migration`.'
+    );
+
+    return 1;
+}
+
 async function main() {
     // Незаданное имя спрашивается отдельно от несуществующего файла. Склеенное с корнем, пустое
     // имя даёт сам корень — а он есть всегда, и проверка шла дальше, будто схема на месте.
@@ -135,9 +196,7 @@ async function main() {
 
     const url = databaseUrl();
     if (!url) {
-        console.log('check-schema-drift: адрес базы не задан — сверять негде');
-
-        return SKIP;
+        return unavailable('адрес базы не задан');
     }
 
     if (PRODUCTION_MARKS.some((mark) => url.includes(mark))) {

package/assets/checks/rt-kit-checks.config.mjs

@@ -175,6 +175,19 @@ const DEFAULTS = {
         workflow: '',
         mainBranch: 'main',
     },
+    /**
+     * Работа, которую одним заходом не закрыть. `label` — метка такой карточки; `plansDir` —
+     * каталог, где живут линии работ. Метка и запись в линии сверяются в обе стороны: одна без
+     * другой лжёт молча, потому что исполнитель открывает карточку раньше, чем линию, а
+     * планирует по линии.
+     *
+     * Не названо любое из двух — связь не судится вовсе: отличить многозаходную карточку от
+     * обычной станет нечем, а каталог линий у каждого дерева свой.
+     */
+    longWork: {
+        label: '',
+        plansDir: '',
+    },
     /** Очередь работ: владелец, репозиторий, борда и учётная запись машинной работы. */
     board: {
         owner: '',

package/assets/checks/signals.mjs

@@ -48,6 +48,46 @@ function readBundle(name) {
     return parseSignals(readFileSync(path, 'utf8'));
 }
 
+/** Признак, ищущий нативный тег: `<input\\b`, `<textarea\\b`, `<select\\b`. */
+const NATIVE_TAG = /^<([a-z]+)\\b$/;
+
+/** Спецзнаки выражения в имени директивы: имя приходит из настройки дерева, а не из кода. */
+function escaped(name) {
+    return name.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+}
+
+/**
+ * Директивы своей дизайн-системы вычёркиваются из признаков нативных тегов.
+ *
+ * Источник вида в дереве бывает не один: панель владельца собирается набором кита, публичный
+ * сайт — своей системой, и закон о единообразии разводит их по приложениям. Директива такой
+ * системы стоит на нативном теге ровно так же, как директива кнопки кита, — и признак кнопки её
+ * уже вырезает своим `strip`, а признаки поля, области текста и списка не вырезают ничего: форма,
+ * собранная из готового своего, числится расхождением целиком, пять полей из пяти.
+ *
+ * Список директив называет дерево — ключом `reuse.kitDirectives`. Не назвало — не вырезается
+ * ничего, и дерево с одним источником вида ведёт себя как прежде.
+ */
+export function withKitDirectives(signals, directives) {
+    const names = (directives ?? []).filter(Boolean).map(escaped);
+    if (names.length === 0) {
+        return signals;
+    }
+
+    const alternatives = names.join('|');
+
+    return signals.map((signal) => {
+        const tag = NATIVE_TAG.exec(signal.find ?? '')?.[1];
+        if (!tag || signal.ext !== '.html') {
+            return signal;
+        }
+
+        const own = `<${tag}\\b[^>]*(?:${alternatives})[^>]*>`;
+
+        return { ...signal, strip: signal.strip ? `${signal.strip}|${own}` : own };
+    });
+}
+
 /**
  * Признаки объявленных наборов, а поверх них — свои признаки дерева.
  *
@@ -84,5 +124,5 @@ export function loadSignals(config, root) {
         );
     }
 
-    return [...byKey.values()];
+    return withKitDirectives([...byKey.values()], config.kitDirectives);
 }

package/assets/commands/next-session.md

@@ -54,12 +54,19 @@ git merge-base --is-ancestor HEAD "origin/${RT_MAIN_BRANCH:-main}" && echo вл
 
 ## 4. Приведи дерево к главной ветке
 
-- **Работа по правилу и PR влит** — задача закрыта, ветка больше не нужна:
+- **Работа по правилу и PR влит** — задача закрыта, ветка больше не нужна. Локальная главная
+  двигается до удалённой без перехода на неё:
 
     ```bash
-    git switch "${RT_MAIN_BRANCH:-main}" && git pull --ff-only
+    git fetch origin "${RT_MAIN_BRANCH:-main}:${RT_MAIN_BRANCH:-main}"
     ```
 
+    Рабочее дерево при этом не трогается вовсе, поэтому шаг исполним и тогда, когда в нём лежит
+    незакоммиченное — а лежит оно там по слову самой этой команды, велевшей шагом раньше его не
+    трогать. Переход на главную нужен, только чтобы там работать; уборке он не нужен, а
+    `git pull` на ветке задачи тянет не главную вовсе и отвечает «no such ref was fetched»:
+    ветку к этой минуте уже сняли с удалённого слиянием заявки.
+
 - **Всё остальное** — работа не кончилась, и ветка остаётся местом, где она продолжится:
 
     ```bash
@@ -74,17 +81,21 @@ git merge-base --is-ancestor HEAD "origin/${RT_MAIN_BRANCH:-main}" && echo вл
 Снимаются только влитые в главную: их коммиты есть в ней, и восстанавливать нечего.
 
 ```bash
-git branch --merged "${RT_MAIN_BRANCH:-main}" \
+git branch --merged "origin/${RT_MAIN_BRANCH:-main}" \
     | grep -vE "^\*|^\s*${RT_MAIN_BRANCH:-main}$" \
     | xargs -r git branch -d
 ```
 
+Влитость судится от удалённой ссылки, а не от локальной главной: локальная отстаёт молча, и
+влитая ветка при ней числится невлитой. Три ветки так показались несущими по два коммита мимо
+главной, а мимо удалённой у них было ноль — заход кончился бы списком невлитого, которого нет.
+
 Невлитую ветку **не сноси**. Назови её владельцу вместе с числом коммитов, которых нет в
 главной, — по ним видно, что именно потеряется, если её снести:
 
 ```bash
-for b in $(git branch --no-merged "${RT_MAIN_BRANCH:-main}" --format='%(refname:short)'); do
-    printf '%s: %s коммитов мимо главной\n' "$b" "$(git rev-list --count "${RT_MAIN_BRANCH:-main}..$b")"
+for b in $(git branch --no-merged "origin/${RT_MAIN_BRANCH:-main}" --format='%(refname:short)'); do
+    printf '%s: %s коммитов мимо главной\n' "$b" "$(git rev-list --count "origin/${RT_MAIN_BRANCH:-main}..$b")"
 done
 ```
 

package/assets/defaults/project.sh

@@ -241,6 +241,21 @@ rt_task_branch_ok_default() {
         | grep -qE '^([A-Z]+-)?[0-9]+-[a-z0-9][a-z0-9-]*$|^(feat|fix|refactor|docs|chore|style|perf|test|build|ci)/[0-9]+-[a-z0-9][a-z0-9-]*$'
 }
 
+# Номер задачи из имени ветки. Второй вопрос к тому же имени: форма отвечает «годится ли»,
+# а это — «какой он», и свести их в одно нельзя: одна возвращает код, другой строку.
+#
+# Формы те же, что знает проверка формы выше: приставкой стоит либо ключ задач через дефис,
+# либо род правки через косую черту, либо её нет вовсе. Разойдясь с ней, разбор оставит форму
+# законной, а номер пустым — и сверка номера ветки с номером заголовка заявки пропустится молча,
+# выглядя при этом сошедшейся.
+#
+# Хвост после номера здесь не судится намеренно: `RT-9_guest` — это промах в разделителе, а не
+# осознанно беззадачная ветка, и номер из неё вынуть надо, чтобы форму имени было с чем сверить.
+# Требование дефиса оставляло такое имя без номера, и гард пропускал его как ветку под пробу.
+rt_task_branch_number_default() {
+    printf '%s' "$1" | sed -nE 's#^([A-Za-z]+[-/])?([0-9]+).*#\2#p'
+}
+
 # Адрес боевого хранилища: образец, по которому его узнают в командной строке — порт туннеля,
 # хост, домен. Любая запись по нему отбивается совсем, и опт-аут не действует. Умолчание
 # молчит: чужой адрес здесь опаснее неназванного — он отбивал бы работу с локальной базой.
@@ -384,6 +399,7 @@ rt_push_docs_only() { rt_push_docs_only_default "$@"; }
 rt_docs_pair_for() { rt_docs_pair_for_default "$@"; }
 rt_lint_for() { rt_lint_for_default "$@"; }
 rt_task_branch_ok() { rt_task_branch_ok_default "$@"; }
+rt_task_branch_number() { rt_task_branch_number_default "$@"; }
 rt_reinvented_in() { rt_reinvented_in_default "$@"; }
 rt_is_app_code() { rt_is_app_code_default "$@"; }
 # Каталог источников пакета правил в этом дереве, от корня. Пусто — дерево пакета не везёт, и

package/assets/hooks/browser-guard-no-asking.sh

@@ -12,6 +12,10 @@
 # being about which Chrome profile to automate. Anchor on selection phrasing instead
 # (deviceId, "which/what browser", "какой браузер").
 #
+# The Russian pronoun is spelled out case by case on purpose: an optional ending would leave a
+# bare "как" in the pattern, and "какие браузеры поддерживаем" — a support question, not a
+# selection one — got denied by exactly that.
+#
 # FAIL-OPEN when browser-device-id.sh prints nothing.
 
 # Своё имя в наблюдениях: отбой пишет общий хвост отказа, а не сам гард.
@@ -29,7 +33,7 @@ device_id="$("${CLAUDE_PROJECT_DIR:-.}/.claude/hooks/browser-device-id.sh" 2>/de
 questions="$(printf '%s' "$input" | jq -r '[.tool_input.questions[]? | .question, .header, (.options[]?.label)] | join(" ")' 2>/dev/null)"
 [ -z "$questions" ] && exit 0
 
-printf '%s' "$questions" | grep -qiE 'deviceid|device id|(which|what|pick|choose|select)[^.]{0,25}\bbrowser\b|\bbrowser\b[^.]{0,25}(profile|to use)|как(ой|ую)?[^.]{0,15}браузер|брауз[а-я]*[^.]{0,20}(использовать|выбрать|выбор|нужен|запустить)' || exit 0
+printf '%s' "$questions" | grep -qiE 'deviceid|device id|(which|what|pick|choose|select)[^.]{0,25}\bbrowser\b|\bbrowser\b[^.]{0,25}(profile|to use)|как(ой|ую|им|ого)[^.]{0,15}браузер|брауз[а-я]*[^.]{0,20}(использовать|выбрать|выбор|нужен|запустить)' || exit 0
 
 # Общий хвост отказа: два законных хода и законная форма обхода, если она у отказа есть. Файл
 # может быть не разложен — тогда хвоста нет, а причина отказа остаётся прежней.

package/assets/hooks/git-guard-delivery.sh

@@ -25,6 +25,7 @@
 #
 # Что здесь чем зовётся, знает профиль дерева:
 #   rt_task_branch_ok    — форма имени ветки под задачу;
+#   rt_task_branch_number — номер задачи из этого имени: приставкой бывает и род правки;
 #   RT_TASK_TITLE_RE     — форма номера в заголовке заявки;
 #   rt_task_state        — состояние задачи одним объектом (existsize, open, onBoard, assigned,
 #                          numbered); молчание значит «спросить некого»;
@@ -95,6 +96,7 @@ done
 [ -f "$rt_hooks_dir/profile-check.sh" ] && . "$rt_hooks_dir/profile-check.sh"
 command -v rt_needs >/dev/null 2>&1 || rt_needs() { command -v "$1" >/dev/null 2>&1; }
 rt_needs rt_task_branch_ok git-guard-delivery || exit 0
+rt_needs rt_task_branch_number git-guard-delivery || exit 0
 
 title_re="${RT_TASK_TITLE_RE:-^\[[A-Za-z]+-[0-9]+\][[:space:]]+[^[:space:]]}"
 task_new="${RT_TASK_NEW_CMD:-npm run task:new}"
@@ -146,10 +148,9 @@ deny() {
     exit 0
 }
 
-# Несошедшиеся условия копятся и называются разом. Отказ по первому промаху заставляет чинить
-# их по одному: исполнитель правит основание, повторяет вызов, упирается в заголовок, правит
-# заголовок, упирается в задачу — и цена отказа растёт на каждом круге, хотя всё несошедшееся
-# было известно уже на первом. Готовность к поставке — одно состояние, и называется оно целиком.
+# Несошедшиеся условия копятся и называются разом: отказ по первому промаху заставляет чинить их
+# по одному — правка основания, повтор, заголовок, снова повтор, задача, — хотя всё несошедшееся
+# известно уже на первом круге. Готовность к поставке — одно состояние, и называется оно целиком.
 faults=''
 
 fault() {
@@ -163,10 +164,9 @@ fault() {
 # shellcheck disable=SC1090
 [ -f "$rt_hooks_dir/git-guard-delivery-folder.sh" ] && . "$rt_hooks_dir/git-guard-delivery-folder.sh" 2>/dev/null
 
-# Конфликтующая своя заявка: тот же приём, что у папки и подписи, — свой предмет живёт
-# помощником рядом. Зовётся он до всех ярусов ниже и судит не готовность этой работы, а право
-# брать следующую: пока отданное конфликтует, его чинят первым действием хода. Нет помощника —
-# ярус не судится, а работа идёт дальше.
+# Конфликтующая своя заявка: тот же приём, что у папки и подписи. Зовётся помощник до всех ярусов
+# ниже и судит не готовность этой работы, а право брать следующую: пока отданное конфликтует, его
+# чинят первым действием хода. Нет помощника — ярус не судится, а работа идёт дальше.
 # shellcheck disable=SC1090
 [ -f "$rt_hooks_dir/git-guard-delivery-conflict.sh" ] && . "$rt_hooks_dir/git-guard-delivery-conflict.sh" 2>/dev/null
 command -v rt_delivery_conflict >/dev/null 2>&1 && rt_delivery_conflict
@@ -225,10 +225,14 @@ fi
 if [ -n "$branch_arg" ]; then
     # Имя, притворяющееся веткой под задачу, но не совпадающее с формой, — это промах в имени,
     # а не осознанная беззадачная ветка. Ловится до первого коммита.
-    if printf '%s' "$branch_arg" | grep -qiE '^[A-Za-z]+-[0-9]+'; then
+    # Номер вынимает профиль: своя регулярка знала одну приставку — ключ задач, — и ветка вида
+    # `feat/88-slug`, законная по форме того же профиля, номера не давала вовсе. Проверка формы
+    # при заведении не срабатывала на ней ни разу, а сверка номеров пропускалась молча.
+    number_arg="$(rt_task_branch_number "$branch_arg")"
+    if [ -n "$number_arg" ]; then
         rt_task_branch_ok "$branch_arg" \
             || deny "BLOCKED: имя ветки «${branch_arg}» не той формы, что принята здесь. Номер у ветки тот же, что у задачи и у заголовка заявки на слияние."
-        check_task "$(printf '%s' "$branch_arg" | sed -nE 's/^[A-Za-z]+-([0-9]+).*/\1/p')" "ветка «${branch_arg}»"
+        check_task "$number_arg" "ветка «${branch_arg}»"
 
         # Условия поставки, известные уже здесь, спрашиваются здесь. Прежде их спрашивали на
         # пуше и на открытии PR — то есть после того, как работа сделана: основание чинится
@@ -374,7 +378,7 @@ branch="$(git branch --show-current 2>/dev/null)"
 rt_task_branch_ok "$branch" \
     || deny "BLOCKED: заявка с ветки «${branch}», за которой не стоит задачи. Правка начинается с задачи, видимой в очереди работ: заведи её — ${task_new} — и перенеси работу в ветку с её номером."
 
-number="$(printf '%s' "$branch" | sed -nE 's/^[A-Za-z]+-([0-9]+).*/\1/p')"
+number="$(rt_task_branch_number "$branch")"
 
 title=''
 if command -v perl >/dev/null 2>&1; then

package/assets/hooks/git-guard-push-tests.sh

@@ -154,6 +154,28 @@ if [ -z "$failed" ] && [ -n "$skipped" ]; then
     printf 'гейт пуша: набор прошёл, но эти проверки смотреть было не на что:\n%s\n' "$skipped" >&2
 fi
 
+# Чем набор гейта уже набора конвейера — сказанное один раз за сессию.
+#
+# Правило поставки требует, чтобы гейт не был уже конвейера, а собрать это требование нечем:
+# файл конвейера у каждого дерева свой, и вывести из него шаги набора пакет не может. Молчание
+# при этом читается как «проверено всё»: расхождение узнаётся из красного конвейера после
+# заявки, когда правка уже отдана человеку.
+#
+# Отметка живёт в каталоге временных файлов, как у слова о нехватке функции профиля: на каждый
+# пуш та же строка повторялась бы за заход десятки раз и перестала бы читаться.
+gap_key="$(printf '%s' "$input" | jq -r '.session_id // empty' 2>/dev/null)"
+[ -z "$gap_key" ] && gap_key="$(date +%Y%m%d 2>/dev/null || printf 'nosession')"
+gap_mark="${TMPDIR:-/tmp}/rt-kit-push-gate-gap-$gap_key"
+if [ ! -f "$gap_mark" ]; then
+    printf 'гейт пуша: набор гейта — не набор конвейера. Сборка образов, снимки показа и проверка
+' >&2
+    printf 'собранных пакетов в него не входят: что в нём стоит, показывает разбор состояния
+' >&2
+    printf '(agent-kit doctor, раздел «набор перед пушем»), — прогони недостающее до заявки.
+' >&2
+    : >"$gap_mark" 2>/dev/null || true
+fi
+
 [ -z "$failed" ] && exit 0
 
 # Хвост вывода, а не весь: у прогонщика он длинный, а нужна причина отказа.

package/assets/hooks/glossary-load.sh

@@ -15,11 +15,32 @@ GLOSSARY="${CLAUDE_PROJECT_DIR:-.}/docs/GLOSSARY.md"
 [ -f "$GLOSSARY" ] || exit 0
 command -v jq >/dev/null 2>&1 || exit 0
 
+# Где слово заводят. Словарь бывает разложен пакетом — тогда правка на его месте теряется на
+# следующей раскладке, а до тех пор раскладка отказывает по нему целиком. Вводная, которую читает
+# каждая сессия, обязана вести в надстройку: она — единственный текст о словаре, доезжающий до
+# читателя гарантированно, и, ведя в собранный файл, она отменяет собой всё сказанное на других
+# слоях. Опровержение стоит строкой ниже, в шапке раскладки, но читается служебной строкой сборки:
+# начинается оно с версии и суммы, а не со слова.
+#
+# Адрес выводится из идентификатора ресурса в самой шапке, а не зашивается: каталог надстроек у
+# каждого дерева свой, и зашитый путь врал бы в первом же, которое держит их иначе. Шапки нет —
+# словарь принадлежит дереву целиком, и «заводится здесь же» верно как есть.
+header="$(head -1 "$GLOSSARY" 2>/dev/null)"
+resource="$(printf '%s' "$header" | sed -n 's/.*rt-kit v[^ ]* · \([^ ]*\) · .*/\1/p')"
+
+if [ -n "$resource" ]; then
+    where="$(printf 'Словарь разложен пакетом и на месте не правится: новое слово идёт в надстройку\n.claude/rt-kit/overrides/%s — она сливается по разделу «## » и раскладку переживает.\n' "$resource")"
+else
+    where='Словарь принадлежит дереву целиком: новое слово заводится в нём же той же правкой.
+'
+fi
+
 {
     printf 'СЛОВАРЬ ПРОЕКТА — `docs/GLOSSARY.md`, ниже целиком.\n\n'
     printf 'Слово отсюда употребляется в том значении, что здесь: и в файлах, и в ответах владельцу.\n'
     printf 'Раздел «Так не пишем» действует так же — левая колонка не пишется и не произносится нигде.\n'
-    printf 'Слова, которого здесь нет, у читателя нет тоже: оно либо заводится здесь же той же правкой,\n'
-    printf 'либо заменяется тем, что уже есть.\n\n'
+    printf 'Слова, которого здесь нет, у читателя нет тоже: оно вводится тем же изменением, которым\n'
+    printf 'впервые употреблено, либо заменяется тем, что уже есть.\n'
+    printf '%s\n' "$where"
     cat "$GLOSSARY"
 } | jq -Rs '{hookSpecificOutput:{hookEventName:"SessionStart",additionalContext:.}}'