@rt-tools/agent-kit 0.12.0 → 0.14.0

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

@@ -0,0 +1,132 @@
+/**
+ * Состояние прогонов и выкатки у хостинга: что встало на вершине, чем кончилось и на сколько
+ * прод отстал от главной ветки.
+ *
+ * Отдельным файлом, а не внутри работы с очередью: у очереди свой предмет — задачи, колонки и
+ * заявки, — а здесь спрашивают конвейер. Вместе они переросли предел длины файла, и делить их
+ * по предмету дешевле, чем по числу строк: правку прогонов и правку очереди делают разные
+ * работы.
+ *
+ * Нет сети или нет токена — вызовы бросают `OfflineError`, как и остальная работа с хостингом:
+ * невозможность спросить расхождением не считается.
+ */
+import { OWNER, REPO, gh } from './board.mjs';
+
+/**
+ * Сколько прогонов завелось на этой вершине.
+ *
+ * Спрашивается вершина, а не ветка: прогон промежуточного коммита о состоянии вершины не
+ * говорит ничего, а список прогонов ветки отдаёт их вперемешку.
+ */
+export function runsOnHead(sha, options) {
+    const answer = gh(['api', `repos/${OWNER}/${REPO}/actions/runs?head_sha=${sha}&per_page=1`, '--jq', '.total_count'], options);
+    return Number(String(answer).trim());
+}
+
+/**
+ * Коммит последней успешной выкатки и то, на сколько от него ушла главная ветка.
+ *
+ * Спрашивается сама выкатка, а не последний прогон главной ветки. Там, где выкатку запускают
+ * рукой, слияние прода не двигает вовсе, и прогон главной о нём не говорит ничего: прод
+ * отставал на 476 коммитов, а сверка молчала. Судится только завершённая успехом выкатка —
+ * идущая ещё может кончиться чем угодно.
+ *
+ * Возвращает `null`, если выкаток не было ни одной: это не расхождение, а нечего сравнивать.
+ */
+export function deployLag(workflow, mainBranch, options) {
+    const runs = gh(
+        [
+            'api',
+            `repos/${OWNER}/${REPO}/actions/workflows/${encodeURIComponent(workflow)}/runs` +
+                '?status=success&per_page=1',
+            '--jq',
+            '[.workflow_runs[] | {sha: .head_sha, at: .created_at}] | first // empty',
+        ],
+        options
+    );
+    const last = String(runs).trim();
+    if (!last) {
+        return null;
+    }
+
+    const run = JSON.parse(last);
+    const behind = gh(
+        ['api', `repos/${OWNER}/${REPO}/compare/${run.sha}...${encodeURIComponent(mainBranch)}`, '--jq', '.ahead_by'],
+        options
+    );
+    return { sha: run.sha, at: run.at, behind: Number(String(behind).trim()) };
+}
+
+/**
+ * Чем кончились прогоны на этой вершине: `success`, если все завершились успехом, `running`,
+ * если хоть один ещё идёт, `failure` — если хоть один упал. Прогонов нет вовсе — `none`.
+ *
+ * Цвет спрашивается отдельно от факта: факт отвечает на вопрос «событие дошло», цвет — на
+ * вопрос «работу можно отдавать». Второй вопрос задаётся там, где готовое стоит черновиком.
+ */
+export function verdictOnHead(sha, options) {
+    const answer = gh(
+        [
+            'api',
+            `repos/${OWNER}/${REPO}/actions/runs?head_sha=${sha}&per_page=20`,
+            '--jq',
+            '[.workflow_runs[] | {status, conclusion}] | if length == 0 then "none"' +
+                ' elif any(.status != "completed") then "running"' +
+                ' elif any(.conclusion != "success") then "failure"' +
+                ' else "success" end',
+        ],
+        options
+    );
+    return String(answer).trim();
+}
+
+/** Когда вершина легла в ветку — по времени коммита у хостинга, а не по местным часам ветки. */
+export function headCommittedAt(sha, options) {
+    const answer = gh(['api', `repos/${OWNER}/${REPO}/commits/${sha}`, '--jq', '.commit.committer.date'], options);
+    return Date.parse(String(answer).trim());
+}
+
+/**
+ * Прогоны вершины, вытесненные из очереди конвейера.
+ *
+ * Группа очереди бережёт идущий прогон и не бережёт ждущего: хостинг держит в группе один
+ * ждущий, и следующий встающий вытесняет прежний. Вытесненный завершается отменой и в списке
+ * неотличим от упавшего, хотя ветку не проверял ни строчкой.
+ *
+ * Отличает их число заданий. Отмена — общее слово для двух случаев: у прогона, остановленного
+ * на ходу, задания есть и журналы у них читаются; у вытесненного из очереди их ноль, потому что
+ * он не начинался. Замером по семи отменённым прогонам дерева: шесть с нулём заданий и один
+ * остановленный на ходу с одним.
+ *
+ * Число заданий спрашивается отдельным вызовом и только у отменённых: спрошенное у каждого
+ * прогона стоило бы вызова на прогон при каждой сверке.
+ *
+ * Зелёный прогон на той же вершине снимает ответ целиком — вытесненный за ним уже перезапущен,
+ * и говорить о нём нечего.
+ */
+export function evictedOnHead(sha, options) {
+    const answer = gh(
+        [
+            'api',
+            `repos/${OWNER}/${REPO}/actions/runs?head_sha=${sha}&per_page=20`,
+            '--jq',
+            '[.workflow_runs[] | {id, status, conclusion}] | tojson',
+        ],
+        options
+    );
+    const runs = JSON.parse(String(answer).trim() || '[]');
+    if (runs.some((run) => run.status === 'completed' && run.conclusion === 'success')) {
+        return [];
+    }
+
+    return runs
+        .filter((run) => run.status === 'completed' && run.conclusion === 'cancelled')
+        .filter((run) => jobCount(run.id, options) === 0)
+        .map((run) => run.id);
+}
+
+/** Сколько заданий завелось у прогона. Ноль означает, что он не начинался вовсе. */
+function jobCount(id, options) {
+    const answer = gh(['api', `repos/${OWNER}/${REPO}/actions/runs/${id}/jobs?per_page=1`, '--jq', '.total_count'], options);
+    return Number(String(answer).trim());
+}

package/assets/checks/board.github.mjs

@@ -19,7 +19,7 @@
  * функции возвращают `null`, командный режим печатает `{"offline":true}`.
  */
 import { execFileSync } from 'node:child_process';
-import { existsSync, readFileSync, readdirSync } from 'node:fs';
+import { existsSync, readFileSync, readdirSync, writeFileSync } from 'node:fs';
 import { homedir } from 'node:os';
 import { join } from 'node:path';
 
@@ -256,46 +256,6 @@ export function fetchOpenPulls(options) {
     );
 }
 
-/**
- * Сколько прогонов завелось на этой вершине.
- *
- * Спрашивается вершина, а не ветка: прогон промежуточного коммита о состоянии вершины не
- * говорит ничего, а список прогонов ветки отдаёт их вперемешку.
- */
-export function runsOnHead(sha, options) {
-    const answer = gh(['api', `repos/${OWNER}/${REPO}/actions/runs?head_sha=${sha}&per_page=1`, '--jq', '.total_count'], options);
-    return Number(String(answer).trim());
-}
-
-/**
- * Чем кончились прогоны на этой вершине: `success`, если все завершились успехом, `running`,
- * если хоть один ещё идёт, `failure` — если хоть один упал. Прогонов нет вовсе — `none`.
- *
- * Цвет спрашивается отдельно от факта: факт отвечает на вопрос «событие дошло», цвет — на
- * вопрос «работу можно отдавать». Второй вопрос задаётся там, где готовое стоит черновиком.
- */
-export function verdictOnHead(sha, options) {
-    const answer = gh(
-        [
-            'api',
-            `repos/${OWNER}/${REPO}/actions/runs?head_sha=${sha}&per_page=20`,
-            '--jq',
-            '[.workflow_runs[] | {status, conclusion}] | if length == 0 then "none"' +
-                ' elif any(.status != "completed") then "running"' +
-                ' elif any(.conclusion != "success") then "failure"' +
-                ' else "success" end',
-        ],
-        options
-    );
-    return String(answer).trim();
-}
-
-/** Когда вершина легла в ветку — по времени коммита у хостинга, а не по местным часам ветки. */
-export function headCommittedAt(sha, options) {
-    const answer = gh(['api', `repos/${OWNER}/${REPO}/commits/${sha}`, '--jq', '.commit.committer.date'], options);
-    return Date.parse(String(answer).trim());
-}
-
 /** `[<КЛЮЧ>-<номер>]` в начале заголовка — единственная форма номера в названиях */
 export const TITLE_NUMBER = new RegExp(`^\\[${TASK_KEY}-(\\d+)\\]\\s+\\S`);
 /** `<КЛЮЧ>-<номер>-<slug>` — имя ветки, отведённой под задачу */
@@ -327,6 +287,48 @@ export function numberFromTaskDir(name) {
  * Вглубь спускаемся ровно на один уровень: в имени ветки одна косая, а всё, что глубже, папкой
  * задачи уже не будет — зато туда попал бы архив, если дерево держит его внутри.
  */
+/** Шапка раскладки: по ней разложенную копию узнаёт и гард места правки. */
+const STAMP = /^<!-- rt-kit v[^\n]*-->\n/m;
+
+/**
+ * Снять с копий образца шапку раскладки.
+ *
+ * Образец разложен пакетом и шапку несёт по праву: его кладёт и обновляет раскладка. Копия под
+ * задачу — уже текст проекта, тем же доводом, каким пакет кладёт без шапки черновик компаньона:
+ * с первой правки сверять в ней нечего.
+ *
+ * Оставленная в копии, шапка отбивает первую же правку разбора просьбы — то есть первое движение
+ * любой работы, — и отказ уводит править образец пакета вместо копии под задачу. Снималась она
+ * тремя строками руками, каждой работой заново.
+ *
+ * Возвращает имена файлов, с которых шапка снята: по ним сценарий и судит, что снятие работает,
+ * а вызывающий — что папка собрана.
+ */
+export function unstampFolder(folder) {
+    const cleaned = [];
+
+    if (!existsSync(folder)) {
+        return cleaned;
+    }
+
+    for (const name of readdirSync(folder)) {
+        if (!name.endsWith('.md')) {
+            continue;
+        }
+
+        const path = join(folder, name);
+        const before = readFileSync(path, 'utf8');
+        const after = before.replace(STAMP, '');
+
+        if (after !== before) {
+            writeFileSync(path, after);
+            cleaned.push(name);
+        }
+    }
+
+    return cleaned;
+}
+
 export function taskDirs(dir = join(ROOT, CONFIG.tasksDir), prefix = '') {
     if (!existsSync(dir)) {
         return [];

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

@@ -43,13 +43,11 @@ import {
     fetchIssues,
     fetchOpenPulls,
     gh,
-    headCommittedAt,
     numberFromTaskDir,
     numberFromTitle,
-    runsOnHead,
     taskDirs,
-    verdictOnHead,
 } from './board.mjs';
+import { deployLag, evictedOnHead, headCommittedAt, runsOnHead, verdictOnHead } from './board-runs.mjs';
 import { CONFIG, ROOT } from './rt-kit-checks.config.mjs';
 
 const IN_REVIEW = STATUS_OPTIONS[IN_REVIEW_STATUS].name;
@@ -67,6 +65,12 @@ const RUN_GRACE_MINUTES = 10;
  */
 const PIPELINE = CONFIG.pushGate?.pipelineFile ?? '';
 const HAS_PIPELINE = PIPELINE !== '' && existsSync(join(ROOT, PIPELINE));
+/**
+ * Рабочий поток выкатки и ветка, с которой прод сравнивают. Не назвав потока, дерево сверки
+ * прода не получает — и сверка говорит об этом вслух: молчание читалось бы как «прод сошёлся».
+ */
+const DEPLOY_WORKFLOW = CONFIG.deploy?.workflow ?? '';
+const MAIN_BRANCH = CONFIG.deploy?.mainBranch ?? 'main';
 
 const problems = [];
 const report = (message) => problems.push(message);
@@ -136,6 +140,10 @@ function folderInBranch(branch, options) {
  * промежутке значила бы «подожди», а не «чини».
  */
 function checkHeadRun(pull, options) {
+    if (checkEvicted(pull, options)) {
+        return;
+    }
+
     if (runsOnHead(pull.headRefOid, options) > 0) {
         checkReadyDraft(pull, options);
         return;
@@ -153,6 +161,36 @@ function checkHeadRun(pull, options) {
     );
 }
 
+/**
+ * Прогон вершины, вытесненный из очереди конвейера.
+ *
+ * Группа очереди бережёт идущий прогон и не бережёт ждущего: хостинг держит в группе один
+ * ждущий, и следующий встающий вытесняет прежний. Ветка за таким прогоном не проверялась ни
+ * строчкой, а по очереди работ выглядит проверенной — прогон на вершине есть, и сверка считает
+ * именно факт.
+ *
+ * Судится раньше отсутствия прогона и раньше цвета: иначе одна вершина получает две строки об
+ * одном. Отвечает `true`, когда строка сказана, и остальные проверки вершины пропускаются.
+ *
+ * Строка называет обе команды и в том порядке, в каком их зовут. Перезапуск отбивает гард, пока
+ * за тот же ход не читался журнал этого задания, и порядок в строке выполняет требование сам:
+ * исполнитель зовёт написанное и не упирается в отказ на втором шаге.
+ */
+function checkEvicted(pull, options) {
+    const evicted = evictedOnHead(pull.headRefOid, options);
+    if (evicted.length === 0) {
+        return false;
+    }
+
+    const run = evicted[0];
+    report(
+        `PR #${pull.number}: прогон ${run} на вершине ${pull.headRefOid.slice(0, 8)} вытеснен из очереди конвейера — ` +
+            `заданий у него ноль, ветка не проверялась, а в списке он выглядит упавшим; ` +
+            `прочитай прогон и перезапусти его (gh run view ${run} && gh run rerun ${run})`
+    );
+    return true;
+}
+
 /**
  * Готовая работа, оставленная черновиком.
  *
@@ -252,10 +290,11 @@ try {
             claimed.set(titleNumber, pull.number);
         }
 
-        // Папка задачи, лежащая в ветке открытого PR, — единственное расхождение, которое
-        // сверка обязана назвать ДО слияния: гард судит её на слиянии, а слияние нажимает
-        // человек в браузере, где хуков нет вовсе. Сказанная после, эта строка уже не чинится
-        // тем же PR — работа перешла дальше, и на разбор заводится вторая задача.
+        // Папка задачи, лежащая в ветке открытого PR, — расхождение с первой минуты заявки:
+        // уборка стоит до её открытия, и открытие с лежащей папкой отбивает гард поставки.
+        // Дошедшая сюда папка означает обход — либо заявку, открытую мимо гарда. Сказанная
+        // после слияния, эта строка уже не чинится тем же PR: работа перешла дальше, и на
+        // разбор заводится вторая задача.
         if (HAS_PIPELINE && pull.headRefOid) {
             checkHeadRun(pull, options);
         }
@@ -266,7 +305,7 @@ try {
             const folder = folderInBranch(pull.headRefName, options);
             if (folder !== null) {
                 report(
-                    `PR #${pull.number}: ветка везёт папку задачи «${folder}/» — разбери её этим же PR или поставь в тело строку «Task-folder-skip: <причина>»`
+                    `PR #${pull.number}: ветка везёт папку задачи «${folder}/» — заявка открывается после уборки. Разбери её этим же PR или поставь в тело строку «Task-folder-skip: <причина>»`
                 );
             }
         }
@@ -312,7 +351,33 @@ try {
     }
 }
 
+// Прод сверяется с главной веткой по последней успешной выкатке. Задача уходит из очереди
+// слиянием, но слияние — ещё не прод: там, где выкатку запускают рукой, между ними может лечь
+// сколько угодно коммитов, и заметить это неоткуда.
+if (!offline && DEPLOY_WORKFLOW) {
+    try {
+        const lag = deployLag(DEPLOY_WORKFLOW, MAIN_BRANCH, { token: botToken() ?? undefined });
+        if (lag === null) {
+            report(`выкаток по «${DEPLOY_WORKFLOW}» не было ни одной — сравнить прод не с чем`);
+        } else if (lag.behind > 0) {
+            report(
+                `прод отстал от «${MAIN_BRANCH}» на ${lag.behind} коммитов: последняя выкатка — ${lag.sha.slice(0, 8)} от ${String(lag.at).slice(0, 10)}`
+            );
+        }
+    } catch (error) {
+        if (error instanceof OfflineError) {
+            console.log(`check-board: прод не сверялся — ${error.message}`);
+        } else {
+            throw error;
+        }
+    }
+}
+
 // Непроверенное называется вслух: молчание о прогонах читалось бы как «прогоны на месте».
+if (!offline && !DEPLOY_WORKFLOW) {
+    console.log('check-board: прод с главной веткой не сверялся — рабочий поток выкатки в настройке дерева не назван');
+}
+
 if (!offline && !HAS_PIPELINE) {
     console.log('check-board: прогоны на вершинах не спрашивались — файла конвейера в дереве нет');
 }

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

@@ -111,6 +111,15 @@ async function withServiceClient(serviceUrl, run) {
 }
 
 async function main() {
+    // Незаданное имя спрашивается отдельно от несуществующего файла. Склеенное с корнем, пустое
+    // имя даёт сам корень — а он есть всегда, и проверка шла дальше, будто схема на месте.
+    // Дерево без хранилища так и говорит: имени нет, сверять нечего.
+    if (!CONFIG.schemaFile) {
+        console.log('check-schema-drift: имя файла схемы не задано — сверять нечего');
+
+        return 0;
+    }
+
     if (!existsSync(join(ROOT, CONFIG.schemaFile))) {
         console.log('check-schema-drift: схемы нет — сверять нечего');
 
@@ -162,9 +171,14 @@ async function main() {
                 return 1;
             }
             if (diff.status !== 0) {
-                console.log('check-schema-drift: сверка не отработала — пропущено');
+                // Ни «сошлось», ни «разошлось» — сама команда сравнения не отработала. Пропуск
+                // здесь неотличим от сошедшихся миграций, и именно им проверка молчала о пустом
+                // имени схемы: с ним она звала сравнение без обязательного довода, а отказ
+                // читался зелёным гейтом.
+                console.error('check-schema-drift: сравнение не отработало\n');
+                console.error(`${diff.stdout ?? ''}${diff.stderr ?? ''}`);
 
-                return 0;
+                return 1;
             }
 
             console.log('check-schema-drift: миграции и схема сошлись');
@@ -179,8 +193,17 @@ async function main() {
 main().then(
     (code) => process.exit(code),
     (error) => {
-        // Сбой самой проверки пуш не держит: сломанная обвязка не должна мешать работать
-        console.log(`check-schema-drift: проверка не отработала (${error?.message ?? error}) — пропущено`);
-        process.exit(0);
+        // Сломанная обвязка — не пропуск, а отказ. «Проверять негде» проверка говорит сама и
+        // раньше: нет схемы, нет адреса, адрес боевой, сервер не отвечает — всё это законные
+        // выходы нулём, и каждый назван своей строкой. Сюда доходит то, чего она не предвидела,
+        // и молчаливый ноль здесь означает «гейт зелен, потому что сверять не получилось».
+        // Отличить его от «сверено и сошлось» нечем: за таким нулём проверка простояла
+        // выключенной, пока её не позвали руками.
+        console.error(`check-schema-drift: проверка не отработала — ${error?.message ?? error}\n`);
+        console.error(
+            'Это отказ самой проверки, а не расхождение схемы. Почини обвязку: недостающий пакет ставится в корень,\n' +
+                'пустое имя схемы или каталога миграций задаётся в настройке проверок дерева.'
+        );
+        process.exit(1);
     }
 );

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

@@ -143,6 +143,18 @@ const DEFAULTS = {
         stepPattern: '^\\s*-\\s*name:\\s*(.+?)\\s*$',
         steps: {},
     },
+    /**
+     * Выкатка. `workflow` — файл рабочего потока, которым прод выкатывают; пусто — сверка
+     * прода молчит вслух. `mainBranch` — ветка, с которой прод сравнивают.
+     *
+     * Спрашивается именно последняя успешная выкатка, а не последний прогон главной ветки:
+     * там, где выкатку запускают рукой, прогон главной о проде не говорит ничего, и прод,
+     * отставший на сотни коммитов, не виден ничему.
+     */
+    deploy: {
+        workflow: '',
+        mainBranch: 'main',
+    },
     /** Очередь работ: владелец, репозиторий, борда и учётная запись машинной работы. */
     board: {
         owner: '',

package/assets/checks/task-new.github.mjs

@@ -17,7 +17,7 @@
  * Тело читается со стандартного ввода. Автор и исполнитель — учётная запись бота,
  * та же, от которой идут коммиты; `--assignee` перекрывает исполнителя.
  */
-import { existsSync, readFileSync, renameSync, writeFileSync } from 'node:fs';
+import { cpSync, existsSync, readFileSync, renameSync, writeFileSync } from 'node:fs';
 import { dirname, join, resolve } from 'node:path';
 import { fileURLToPath } from 'node:url';
 
@@ -38,6 +38,7 @@ import {
     graphql,
     numberFromTitle,
     taskState,
+    unstampFolder,
 } from './board.mjs';
 
 function parseArgs(argv) {
@@ -161,6 +162,7 @@ const branch = args.slug ? `${TASK_KEY}-${number}-${args.slug}` : `${TASK_KEY}-$
  * `docs/tasks/_draft-<slug>`. Оставленный черновиком, он остаётся вне истории, а следующий
  * заход его не находит: хук запуска ищет папку по имени ветки.
  */
+
 function adoptDraft() {
     if (!args.slug) {
         console.log(`\nПапка задачи: --slug не задан, переименовать черновик нечем.`);
@@ -174,10 +176,20 @@ function adoptDraft() {
         console.log(`\nПапка задачи уже на месте: docs/tasks/${branch}/`);
     } else if (existsSync(draft)) {
         renameSync(draft, target);
+        // Черновик тоже собирают с образца, и шапка в нём та же: снимается она и здесь.
+        unstampFolder(target);
         console.log(`\nПапка задачи: docs/tasks/_draft-${args.slug}/ → docs/tasks/${branch}/`);
     } else {
-        console.log(`\nПапка задачи собирается с образца:\n  cp -r docs/tasks/_template docs/tasks/${branch}`);
-        return;
+        const template = join(root, 'docs/tasks/_template');
+
+        if (!existsSync(template)) {
+            console.log(`\nПапки задачи нет, и собрать её не с чего: образца ${'docs/tasks/_template'} в дереве не лежит`);
+            return;
+        }
+
+        cpSync(template, target, { recursive: true });
+        unstampFolder(target);
+        console.log(`\nПапка задачи собрана с образца: docs/tasks/${branch}/`);
     }
 
     // Шапку замысла читает гард: по ней он находит договорённость о продукте. Номер в ней

package/assets/commands/feedback.md

@@ -70,11 +70,19 @@ cp .claude/rt-kit/templates/proposal.md \
 
 - **место:** раздел «<заголовок>», в конец
 - **повод:** что в этой работе пошло не так без этого правила
+- **ближайшее:** «<точная строка ресурса, к которой это ближе всего>» — <чего она не покрывает>
 
 > Готовый текст правки — ровно то, что вставить, в стиле соседних правил: по-русски,
 > утверждением, без воды.
 ```
 
+**Строка «ближайшее» обязательна, и она единственная, которую проверяет машина.** Цитата ищется
+в ресурсе, и ненайденная отбивает блок: либо ресурс не читали, либо утверждение с тех пор
+переписано. Ближайшего нет вовсе — так и пишется: «нет». Написана она затем, чтобы ресурс был
+прочитан: разбор кончается предложением дописать статью в тот же ресурс, который промах уже
+описывал, и вторая статья о том же дороже, чем её отсутствие. Отбитый блок остаётся лежать с
+отметкой и причиной — видно, что разбор был, и видно, почему он не стал правкой.
+
 Повод пишется от случая, а не от желания: «здесь было неудобно» правилом не становится. Слово
 пользователя пересказывается его смыслом, а не твоими выводами о том, как надо было бы.
 

package/assets/defaults/project.sh

@@ -277,11 +277,50 @@ rt_shell_paths_default() {
             }')"
     fi
 
-    printf '%s' "$text" \
-        | tr "(),;=" '     ' \
-        | tr '[:space:]' '\n' \
-        | grep -E '^[A-Za-z0-9_@.-]*/[A-Za-z0-9_@./-]+$' \
-        | sed 's|^\./||' \
+    # Пути берутся только у тех кусков команды, которые пишут. Прежде брались у всей строки
+    # целиком, и команда чтения, сцепленная с записью, отдавала свои пути как цели записи:
+    # `python3 <<PY … PY` рядом с `grep -n … projects/…` отбивался за правку кода, которой в нём
+    # не было. Отбитий, пришедшихся не на правку файла, набиралось большинство, и цену платил
+    # тот, кто просто читал соседний файл в той же строке.
+    #
+    # Кусок — строка верхнего уровня, а внутри неё `;`, `&&` и `||`. Тело heredoc от своей
+    # команды не отрывается: оно едет вместе с ней одним куском, потому что путь записи
+    # интерпретатора стоит именно там.
+    printf '%s' "$text" | awk '
+        function trim(s) { sub(/^[ \t]+/, "", s); sub(/[ \t]+$/, "", s); return s }
+        function flush(  n, i, part) {
+            if (chunk == "") { return }
+            if (tag != "") { part = chunk; gsub(/\n/, " ", part); print part; chunk = ""; return }
+            n = split(chunk, parts, /;|&&|\|\|/)
+            for (i = 1; i <= n; i++) { print parts[i] }
+            chunk = ""
+        }
+        tag != "" {
+            chunk = chunk "\n" $0
+            if (trim($0) == tag) { flush(); tag = "" }
+            next
+        }
+        {
+            chunk = $0
+            if (match($0, /<<-?[ \t]*[A-Za-z_][A-Za-z0-9_]*/)) {
+                t = substr($0, RSTART, RLENGTH)
+                sub(/^<<-?[ \t]*/, "", t)
+                tag = t
+                next
+            }
+            flush()
+        }
+        END { if (chunk != "") { part = chunk; gsub(/\n/, " ", part); print part } }
+    ' \
+        | while IFS= read -r piece; do
+            [ -z "$piece" ] && continue
+            rt_shell_writes "$piece" || continue
+            printf '%s' "$piece" \
+                | tr "(),;=" '     ' \
+                | tr '[:space:]' '\n' \
+                | grep -E '^[A-Za-z0-9_@.-]*/[A-Za-z0-9_@./-]+$' \
+                | sed 's|^\./||'
+        done \
         | sort -u
 }
 
@@ -420,8 +459,14 @@ rt_lint_for() { rt_lint_for_default "$@"; }
 rt_task_branch_ok() { rt_task_branch_ok_default "$@"; }
 rt_reinvented_in() { rt_reinvented_in_default "$@"; }
 rt_is_app_code() { rt_is_app_code_default "$@"; }
+# Каталог источников пакета правил в этом дереве, от корня. Пусто — дерево пакета не везёт, и
+# адрес правки у него один: надстройка. Дерево, которое пакет и разрабатывает, называет каталог
+# сам — иначе гард места правки посылал бы его в надстройку вместо источника.
+rt_kit_sources_dir_default() { printf ''; }
+
 rt_shell_writes() { rt_shell_writes_default "$@"; }
 rt_shell_paths() { rt_shell_paths_default "$@"; }
+rt_kit_sources_dir() { rt_kit_sources_dir_default "$@"; }
 rt_qa_decorative() { rt_qa_decorative_default "$@"; }
 rt_task_state() { rt_task_state_default "$@"; }
 rt_pull_state() { rt_pull_state_default "$@"; }

package/assets/hooks/browser-guard-no-other-drivers.sh

@@ -80,7 +80,7 @@ esac
 # помечают движок в прогоне сквозных спек, — такой образец отбил бы сам прогон в день, когда
 # появился. Поэтому якорь на границе команды и требование похожего на исполняемый файл слова,
 # а не значения флага.
-printf '%s' "$cmd" | grep -qE '(^|[;&|(]|[[:space:]]&&|[[:space:]]\|\|)[[:space:]]*(/[^[:space:]]*/)?(google-chrome|chromium)([[:space:]]|$)' \
+printf '%s' "$cmd" | grep -qE "${RT_CMD_BOUND}(/[^[:space:]]*/)?(google-chrome|chromium)([[:space:]]|\$)" \
     && deny "Прямой запуск бинарника браузера обходит закреплённый профиль."
 
 printf '%s' "$cmd" | grep -qF 'Google Chrome.app/Contents/MacOS' \