@rt-tools/agent-kit 0.11.0 → 0.13.0

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

@@ -0,0 +1,87 @@
+/**
+ * Состояние прогонов и выкатки у хостинга: что встало на вершине, чем кончилось и на сколько
+ * прод отстал от главной ветки.
+ *
+ * Отдельным файлом, а не внутри работы с очередью: у очереди свой предмет — задачи, колонки и
+ * заявки, — а здесь спрашивают конвейер. Вместе они переросли предел длины файла, и делить их
+ * по предмету дешевле, чем по числу строк: правку прогонов и правку очереди делают разные
+ * работы.
+ *
+ * Нет сети или нет токена — вызовы бросают `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());
+}

package/assets/checks/board.github.mjs

@@ -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>` — имя ветки, отведённой под задачу */

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, 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);
@@ -252,10 +256,11 @@ try {
             claimed.set(titleNumber, pull.number);
         }
 
-        // Папка задачи, лежащая в ветке открытого PR, — единственное расхождение, которое
-        // сверка обязана назвать ДО слияния: гард судит её на слиянии, а слияние нажимает
-        // человек в браузере, где хуков нет вовсе. Сказанная после, эта строка уже не чинится
-        // тем же PR — работа перешла дальше, и на разбор заводится вторая задача.
+        // Папка задачи, лежащая в ветке открытого PR, — расхождение с первой минуты заявки:
+        // уборка стоит до её открытия, и открытие с лежащей папкой отбивает гард поставки.
+        // Дошедшая сюда папка означает обход — либо заявку, открытую мимо гарда. Сказанная
+        // после слияния, эта строка уже не чинится тем же PR: работа перешла дальше, и на
+        // разбор заводится вторая задача.
         if (HAS_PIPELINE && pull.headRefOid) {
             checkHeadRun(pull, options);
         }
@@ -266,7 +271,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 +317,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-file-size.mjs

@@ -35,8 +35,18 @@ import { join } from 'node:path';
 import { allowlistOf, baselineOf, CONFIG, ROOT, parseAllowlist } from './rt-kit-checks.config.mjs';
 
 const ALLOWLIST = allowlistOf('file-size');
-/** Предел один на все роды файлов: своё число каждому роду — спор о числе на каждой правке. */
+/** Пределов два: код и текст слоя правил. Какой из них применён, каждая строка отказа называет. */
 const LIMIT = CONFIG.fileSizeLimit;
+const PROSE_LIMIT = CONFIG.proseSizeLimit ?? CONFIG.fileSizeLimit;
+/** Корни текста слоя правил; дерево, их не назвавшее, судится одним пределом. */
+const PROSE_ROOTS = CONFIG.proseRoots ?? [];
+
+/** Предел для файла и имя предела для отказа: по корню, а не по расширению — код лежит и в `.md`. */
+function limitOf(path) {
+    return PROSE_ROOTS.some((root) => root && path.startsWith(root))
+        ? { limit: PROSE_LIMIT, title: 'предел текста' }
+        : { limit: LIMIT, title: 'предел кода' };
+}
 
 /** Роды файлов, которых не читает линтер. Код остаётся за ним. */
 const JUDGED = ['.md', '.scss', '.html', '.js', '.mjs', '.sh'];
@@ -78,7 +88,7 @@ const tracked = trackedFiles().filter(judged);
 
 for (const path of tracked) {
     const lines = lineCount(path);
-    if (lines > LIMIT) {
+    if (lines > limitOf(path).limit) {
         tooLong.set(path, lines);
     }
 }
@@ -95,7 +105,10 @@ const gone = [...known.keys()].filter((path) => !existsSync(join(ROOT, path)));
 const shrunk = [...known.keys()].filter((path) => !tooLong.has(path) && existsSync(join(ROOT, path)));
 
 const problems = [
-    ...fresh.map(([path, lines]) => `${path}: ${lines} строк, предел ${LIMIT} — делить, а не дописывать строку в ${ALLOWLIST}`),
+    ...fresh.map(([path, lines]) => {
+        const { limit, title } = limitOf(path);
+        return `${path}: ${lines} строк, ${title} ${limit} — делить, а не дописывать строку в ${ALLOWLIST}`;
+    }),
     ...gone.map((path) => `${path}: строка в ${ALLOWLIST} устарела — файла в дереве нет`),
     ...shrunk.map((path) => `${path}: значится в ${ALLOWLIST}, но уже короче предела — строку убрать`),
 ];
@@ -107,7 +120,9 @@ if (problems.length > 0) {
     process.exit(1);
 }
 
+const limits = PROSE_ROOTS.length > 0 ? `предел кода ${LIMIT}, предел текста ${PROSE_LIMIT}` : `предел ${LIMIT}`;
+
 console.log(
-    `check-file-size: проверено ${tracked.length} файлов, длиннее ${LIMIT} строк ${tooLong.size}, ` +
+    `check-file-size: проверено ${tracked.length} файлов, ${limits}, длиннее предела ${tooLong.size}, ` +
         `из них принято ${accepted.size}, долг ${debt.size} — новых нет`
 );

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/check-state-next.mjs

@@ -31,6 +31,13 @@ import { join } from 'node:path';
 
 const ROOT = process.cwd();
 const RULE = join(ROOT, '.claude/skills/task-flow/SKILL.md');
+/**
+ * Правило хода захода: граница состояния живёт там, а не в правиле ведения работы.
+ * Разделились они, когда правило ведения работы вышло за предел длины: ход работы
+ * остался в одном, выходы хода уехали в другое. Дерево, где разложено только первое,
+ * судится по нему одному — второго файла у него нет.
+ */
+const TURN_RULE = join(ROOT, '.claude/skills/turn-conduct/SKILL.md');
 const SKILLS = join(ROOT, '.claude/skills');
 const MAP = join(ROOT, '.claude/rt-kit/defaults/turn-map.md');
 const LAW = join(ROOT, 'docs/constitution/work-conduct.md');
@@ -167,8 +174,9 @@ if (counted === 0) {
     problems.push('ни одного раздела состояния не нашлось: паттерны не разложены или заголовки в них другие');
 }
 
-if (!ruleText.includes(BOUNDARY)) {
-    problems.push(`правило ведения работы о границе состояния молчит: строки «${BOUNDARY}» в нём нет`);
+const turnText = existsSync(TURN_RULE) ? readFileSync(TURN_RULE, 'utf8') : '';
+if (!ruleText.includes(BOUNDARY) && !turnText.includes(BOUNDARY)) {
+    problems.push(`правило хода захода о границе состояния молчит: строки «${BOUNDARY}» в нём нет`);
 }
 
 for (const [file, what] of [

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

@@ -67,10 +67,24 @@ const DEFAULTS = {
      */
     generatedDirs: [],
     /**
-     * Предел длины файла — одно число на все роды: своё число каждому роду означает спор о
-     * числе на каждой правке, а не о длине файла.
+     * Предел длины файла для кода и обвязки. Родов у него по-прежнему не два десятка, а два:
+     * код и текст слоя правил. Спорить о числе на каждой правке нечему — оба числа стоят
+     * здесь и меняются работой, а не по ходу.
      */
     fileSizeLimit: 500,
+    /**
+     * Предел длины текста слоя правил — закона, правила, паттерна, холодной части и их
+     * источников. Он ниже предела кода вдвое, и это не строгость ради строгости: текст, не
+     * влезающий на экран целиком, дописывают в конец, не перечитав начала, — так в одном файле
+     * и оказываются два ответа на один вопрос. У кода от этого спасает линтер, у текста —
+     * только это число.
+     */
+    proseSizeLimit: 300,
+    /**
+     * Корни, под которыми лежит текст слоя правил, и его источники. Файл отсюда судится
+     * пределом текста, всё остальное — пределом кода. Пусто — предел один на всё дерево.
+     */
+    proseRoots: [],
     /**
      * Внешние пакеты, чьи перечисления считаются наравне с либами: своё перечисление под уже
      * объявленный там набор — такая же копия, как и между двумя либами. Каждая запись — имя
@@ -129,6 +143,18 @@ const DEFAULTS = {
         stepPattern: '^\\s*-\\s*name:\\s*(.+?)\\s*$',
         steps: {},
     },
+    /**
+     * Выкатка. `workflow` — файл рабочего потока, которым прод выкатывают; пусто — сверка
+     * прода молчит вслух. `mainBranch` — ветка, с которой прод сравнивают.
+     *
+     * Спрашивается именно последняя успешная выкатка, а не последний прогон главной ветки:
+     * там, где выкатку запускают рукой, прогон главной о проде не говорит ничего, и прод,
+     * отставший на сотни коммитов, не виден ничему.
+     */
+    deploy: {
+        workflow: '',
+        mainBranch: 'main',
+    },
     /** Очередь работ: владелец, репозиторий, борда и учётная запись машинной работы. */
     board: {
         owner: '',

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
 }
 
@@ -317,9 +356,17 @@ RT_TASK_TITLE_RE="${RT_TASK_TITLE_RE:-^\[[A-Za-z]+-[0-9]+\][[:space:]]+[^[:space
 RT_TASK_NEW_CMD="${RT_TASK_NEW_CMD:-npm run task:new}"
 RT_BOARD_CHECK_CMD="${RT_BOARD_CHECK_CMD:-npm run check:board}"
 
-# Учётная запись, которую ставят исполнителем. Умолчание молчит: у каждого дерева она своя.
+# Учётная запись, которую ставят исполнителем и которой открывают заявку. Умолчание молчит: у
+# каждого дерева она своя, а у иного её нет вовсе.
 RT_TASK_BOT="${RT_TASK_BOT:-}"
 
+# Чем вызову подставляют токен машинной записи и как эта подстановка выглядит целиком. Клиент
+# хостинга держит две записи сразу — залогиненную и ту, чей токен стоит в окружении вызова, — и
+# из текста команды видно только явную подстановку. Оба умолчания молчат: дерево без отдельной
+# машинной записи автора заявки не судит вовсе.
+RT_PULL_TOKEN_VAR="${RT_PULL_TOKEN_VAR:-}"
+RT_PULL_TOKEN_HINT="${RT_PULL_TOKEN_HINT:-}"
+
 # Команда перевода задачи между колонками очереди работ и имя первой колонки — той, из которой
 # задача уходит, когда её берут в работу. Имя без умолчания: колонки дерево называет своими
 # словами, а выдуманное не совпало бы ни с чем и молча выключило бы проверку колонки.
@@ -412,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/defaults/turn-map.md

@@ -1,7 +1,8 @@
 # Карта хода
 
 Это не правило, а его короткая выжимка: правило объясняет, карта называет. Полный текст —
-скил `task-flow`; он же называет паттерн, который ведёт каждое состояние.
+скил `task-flow`; он же называет паттерн, который ведёт каждое состояние. Чем ход
+кончается — скил `turn-conduct` под тем же законом.
 
 Состояние работы объявлено строкой в разделе «Где стоим» хода работы. Пока обязательное
 действие не сделано, работа стоит в том же состоянии.
@@ -19,8 +20,8 @@
 | `этапы-кончились`         | прогнать набор и открыть PR черновиком                 | `task-flow-close`  |
 | `работа-отдана`           | взять следующую задачу                                 | `task-flow-resume` |
 | `разбор-кончился`         | влить договорённость, привести тексты, разобрать папку | `task-flow-close`  |
-| `папка-разобрана`         | снять черновик и попросить влить                       | `task-flow-close`  |
-| `влито`                   | разбор работы правилами и сверка очереди               | `task-flow-close`  |
+| `папка-разобрана`         | снять черновик и попросить влить                       | `task-flow-archive` |
+| `влито`                   | разбор работы правилами и сверка очереди               | `task-flow-archive` |
 
 Ни у одного состояния обязательное действие не звучит как «ждать». Прогон, разбор владельцем и
 слияние идут без исполнителя и от взгляда быстрее не становятся.
@@ -41,6 +42,7 @@
 остановки там — страховка на случай, когда сжатие не пришло.
 
 Всё остальное — продолжение хода. Ходом не кончаются: коммит, записанный замысел, закрытый
-разбор просьбы, прочитанная договорённость, зелёная проверка, сводка о чужом шаге и объявление
-намерения. Переход из состояния в состояние — тем более: обязательное действие сделано, и
-следующее делается тем же ходом. Названо может быть только сделанное.
+разбор просьбы, прочитанная договорённость, зелёная проверка, сводка о чужом шаге, объявление
+намерения и названная, но не запущенная команда. Переход из состояния в состояние — тем более:
+обязательное действие сделано, и следующее делается тем же ходом. Названо может быть только
+сделанное.

package/assets/hooks/browser-guard-device-id.sh

@@ -12,8 +12,10 @@
 # ОТКАЗ В ПОЛЬЗУ РАБОТЫ: помощник не назвал профиль — пропуск.
 
 . "$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)/utf8.sh" 2>/dev/null || true
+. "$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)/hook-input.sh" 2>/dev/null || true
 
-input="$(cat 2>/dev/null)"
+rt_hook_read
+input="$RT_HOOK_INPUT"
 
 device_id="$("${CLAUDE_PROJECT_DIR:-.}/.claude/hooks/browser-device-id.sh" 2>/dev/null)"
 [ -z "$device_id" ] && exit 0

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

@@ -15,8 +15,10 @@
 # FAIL-OPEN when browser-device-id.sh prints nothing.
 
 . "$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)/utf8.sh" 2>/dev/null || true
+. "$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)/hook-input.sh" 2>/dev/null || true
 
-input="$(cat 2>/dev/null)"
+rt_hook_read
+input="$RT_HOOK_INPUT"
 
 device_id="$("${CLAUDE_PROJECT_DIR:-.}/.claude/hooks/browser-device-id.sh" 2>/dev/null)"
 [ -z "$device_id" ] && exit 0

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

@@ -14,13 +14,15 @@
 # ОТКАЗ В ПОЛЬЗУ РАБОТЫ: помощник не назвал профиль — пропуск.
 
 . "$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)/utf8.sh" 2>/dev/null || true
+. "$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)/hook-input.sh" 2>/dev/null || true
 
-input="$(cat 2>/dev/null)"
+rt_hook_read
+input="$RT_HOOK_INPUT"
 
 device_id="$("${CLAUDE_PROJECT_DIR:-.}/.claude/hooks/browser-device-id.sh" 2>/dev/null)"
 [ -z "$device_id" ] && exit 0
 
-tool="$(printf '%s' "$input" | jq -r '.tool_name // empty' 2>/dev/null)"
+tool="$(rt_hook_tool)"
 
 # shellcheck disable=SC1090
 [ -f "$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)/deny-tail.sh" ] \
@@ -45,7 +47,7 @@ case "$tool" in
     *) exit 0 ;;
 esac
 
-cmd="$(printf '%s' "$input" | jq -r '.tool_input.command // empty' 2>/dev/null)"
+cmd="$(rt_hook_cmd)"
 [ -z "$cmd" ] && exit 0
 
 if [ "$tool" = "mcp__webstorm__execute_tool" ] && command -v perl >/dev/null 2>&1; then
@@ -78,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' \

package/assets/hooks/browser-guard-require-select.sh

@@ -21,13 +21,15 @@
 # ОТКАЗ В ПОЛЬЗУ РАБОТЫ: помощник не назвал профиль — пропуск.
 
 . "$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)/utf8.sh" 2>/dev/null || true
+. "$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)/hook-input.sh" 2>/dev/null || true
 
-input="$(cat 2>/dev/null)"
+rt_hook_read
+input="$RT_HOOK_INPUT"
 
 device_id="$("${CLAUDE_PROJECT_DIR:-.}/.claude/hooks/browser-device-id.sh" 2>/dev/null)"
 [ -z "$device_id" ] && exit 0
 
-tool="$(printf '%s' "$input" | jq -r '.tool_name // empty' 2>/dev/null)"
+tool="$(rt_hook_tool)"
 # У перечисления, переключения и самого выбора свои гарды.
 case "$tool" in
     *list_connected_browsers|*switch_browser|*select_browser) exit 0 ;;