@rt-tools/agent-kit 0.8.1 → 0.8.2

package/README.md

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

package/assets/agents/qa-engineer.md

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

package/assets/checks/board.github.mjs

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

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

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

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

@@ -31,12 +31,13 @@ import {
     REPO,
     STATUS_FIELD_ID,
     TASK_KEY,
-    TOKEN_PATH,
     botToken,
+    describeTaskState,
     gh,
     ghJson,
     graphql,
     numberFromTitle,
+    taskState,
 } from './board.mjs';
 
 function parseArgs(argv) {
@@ -94,10 +95,13 @@ if (args.slug !== null && !/^[a-z0-9][a-z0-9-]*$/.test(args.slug)) {
     fail('slug — строчные латинские буквы, цифры и дефисы: имя ветки читают в списке из полусотни строк');
 }
 
-const token = botToken();
-if (!token) {
-    fail(`нет токена бота (${TOKEN_PATH}): задача завелась бы от чужого имени`);
-}
+/**
+ * Токен машинной записи необязателен: не назвавшее его дерево заводит задачу учётной записью,
+ * под которой залогинен клиент хостинга. Требование токена держало бы заведение задач у дерева,
+ * машинной записи не заводившего, и у дерева, чью запись ограничил хостинг, — а без заведения
+ * не начинается никакая работа вовсе. Кто именно завёл задачу, читается у неё самой.
+ */
+const token = botToken() ?? undefined;
 
 let number = null;
 try {
@@ -194,5 +198,29 @@ adoptDraft();
 
 console.log(`[${TASK_KEY}-${number}] ${args.title}`);
 console.log(`https://github.com/${OWNER}/${REPO}/issues/${number}`);
+
+/**
+ * Пятый шаг: заведение подтверждается ответом очереди работ, а не выводом этой команды.
+ *
+ * Все четыре шага выше отвечают за свои вызовы и молчат о том, видна ли задача тому, кто по
+ * ней придёт. Шестнадцать заведений подряд так и напечатали номер со ссылкой, не попав в
+ * очередь ни одно: учётная запись была ограничена хостингом, вызовы при этом отказа не дали.
+ */
+let answer;
+try {
+    answer = describeTaskState(number, taskState(number, { token }));
+} catch (error) {
+    const reason = error instanceof OfflineError ? error.message : String(error.message ?? error);
+    answer = describeTaskState(number, { offline: reason });
+}
+for (const line of answer.lines) {
+    (answer.ok ? console.log : console.error)(`task-new: ${line}`);
+}
+
 console.log(`\nВетка заводится отдельным вызовом:\n  git checkout -b ${branch}`);
 console.log(`Взятая в работу задача переставляется на борде:\n  npm run task:move -- ${number} ${IN_PROGRESS_STATUS}`);
+
+if (!answer.ok) {
+    console.error(`task-new: проверь очередь работ целиком — npm run check:board`);
+    process.exit(1);
+}

package/assets/commands/agent-kit-digest.md

@@ -12,17 +12,22 @@ argument-hint: '[пусто | --days N]'
 
 ## 1. Собери, что пришло
 
+Груз уезжает в приём, а не в очередь работ: сводка говорит о рабочих привычках команды, и в
+открытой очереди это выложено всему свету. Записи приёма читает его админка; пока её нет,
+собранное читается запросом к его хранилищу — как именно, сказано в компаньоне этой команды.
+
+Записи, заведённые прежним порядком, лежат в очереди работ и никуда не делись:
+
 ```bash
-gh issue list --label agent-kit-feedback --state open --limit 100 \
+gh issue list --label agent-kit-feedback --state all --limit 100 \
     --json number,title,body,createdAt
 ```
 
 Помощник хостинга и учётная запись машинной работы у каждого дерева свои — как их звать здесь,
 сказано в компаньоне правила `git-workflow`.
 
-Каждая запись заведена командой `agent-kit propose` из дерева, где пакет стоит. В теле — ресурс,
-место, повод, готовый текст и сводка наблюдений того дерева. Имени дерева там нет намеренно:
-различать их можно только по сводке и по времени.
+В каждой записи — ресурс, место, повод и готовый текст. Признак дерева, приехавший с грузом,
+адреса дерева не выдаёт: он считается хешем и по нему различают деревья, а не находят их.
 
 Своё дерево тоже потребитель — его наблюдения читаются прямо:
 
@@ -79,5 +84,5 @@ gh issue close <номер> --comment 'Вошло в #<номер задачи>.
 одна фраза о том, что менялось и почему. Журнал изменений при выпуске собирается из заголовков,
 и переписывать их задним числом — работа заново.
 
-**Выпуск отсюда не запускается.** Это отдельное решение владельца: слияние отчёта пакета не
+**Выпуск отсюда не запускается.** Это отдельное решение владельца: слияние PR пакета не
 публикует. Скажи, что накопилось на выпуск, и остановись.

package/assets/commands/next-session.md

@@ -6,7 +6,7 @@ argument-hint: '[пусто | <что дописать в передачу от
 Закрой заход: приведи дерево к главной ветке, убери влитые ветки и напиши передачу для
 следующего захода. Дописка владельца к передаче: `$ARGUMENTS`
 
-Вызывается **последним действием захода** — после того, как работа закоммичена, а отчёт открыт
+Вызывается **последним действием захода** — после того, как работа закоммичена, а PR открыт
 или влит. Команда ничего не мержит, не пушит и не открывает: закрытие захода — уборка, а не
 поставка.
 
@@ -45,7 +45,7 @@ branch="$(git branch --show-current)"
 ```
 
 Работа идёт **по правилу**, если имя ветки несёт номер задачи — это `rt_task_branch_ok` из
-профиля — или если в каталоге папок задач лежит папка с именем ветки. Отчёт **влит**, когда
+профиля — или если в каталоге папок задач лежит папка с именем ветки. PR **влит**, когда
 коммиты ветки уже есть в удалённой главной:
 
 ```bash
@@ -54,7 +54,7 @@ git merge-base --is-ancestor HEAD "origin/${RT_MAIN_BRANCH:-main}" && echo вл
 
 ## 4. Приведи дерево к главной ветке
 
-- **Работа по правилу и отчёт влит** — задача закрыта, ветка больше не нужна:
+- **Работа по правилу и PR влит** — задача закрыта, ветка больше не нужна:
 
     ```bash
     git switch "${RT_MAIN_BRANCH:-main}" && git pull --ff-only
@@ -116,7 +116,7 @@ mkdir -p "${RT_HANDOFF_DIR:-.claude/handoff}"
 
 ## Чего команда не делает
 
-- не мержит отчёт и не пушит: это поставка, и вслепую она не делается;
+- не мержит PR и не пушит: это поставка, и вслепую она не делается;
 - не сносит невлитую ветку и не трогает папку задачи;
 - не коммитит передачу — она лежит вне дерева намеренно, иначе рядом с ходом работы заводится
   вторая запись об одном и том же.

package/assets/commands/skill-curator.md

@@ -61,23 +61,25 @@ cp .claude/rt-kit/templates/proposal.md .claude/rt-kit/proposals/$(date +%F)-<в
 Дальше — по блоку на предложение, заголовком `## <адрес> · <ресурс>`. Адрес роль уже поставила,
 твоё дело — не потерять его и не переписать текст своими словами.
 
-Файл читает `agent-kit propose`: по заголовку он отбирает то, что уезжает в репозиторий пакета.
-Блок без адреса в заголовке не уедет никуда и останется лежать молча.
+Файл читает `agent-kit propose`: по заголовку он отбирает то, что уезжает в приём. Блок без
+адреса в заголовке не уедет никуда и останется лежать молча.
 
 ## 5. Отправь то, что адресовано пакету
 
 ```bash
 npx agent-kit propose --dry-run     # что уехало бы
-npx agent-kit propose               # завести запись в очереди работ пакета
+npx agent-kit propose               # отправить груз в приём
 ```
 
-Уезжают только блоки с адресом «пакет», и вместе с ними — сводка наблюдений: без цифр
-предложение читается как мнение. Отправленное помечается ссылкой в том же файле и второй раз
-не уезжает.
+Груз уезжает при каждом прогоне: сводка наблюдений со снимком надстроек, предложения с адресом
+«пакет» — когда они есть, — и разборы происшествий. Прогон без замечаний тоже говорит, чем
+пользовались, чем не пользовались ни разу и что дерево переопределило. Отправленное предложение
+помечается в том же файле и второй раз не уезжает.
 
-Отправка отказывает, если в тексте предложения нашёлся адрес этого дерева — путь, имя корня,
-чужой репозиторий. Это не придирка: файл уезжает в чужой репозиторий целиком. Правь текст, а не
-обходи проверку.
+Отправка отказывает, если адрес этого дерева нашёлся в сводке или в тексте предложения — путь,
+имя корня, чужой репозиторий. Это не придирка: груз уезжает наружу целиком. Правь текст, а не
+обходи проверку. Разбор происшествия проверкой не накрыт: он по устройству называет файлы
+дерева, где промах случился.
 
 ## 6. Отдай результат владельцу
 

package/assets/defaults/gate-map.sh

@@ -40,6 +40,13 @@ skill_for_default() {
     case "$kind" in
         edit)
             case "$target" in
+                # Надстройка над разложенным текстом — правка того же текста: путь другой, а
+                # предмет тот же. Ветка стоит первой, потому что путь надстройки кончается тем
+                # же именем файла, что и разложенная копия, и ветки ниже разобрали бы её по
+                # расширению — то есть правилом формулировок вместо правила устройства.
+                */.claude/rt-kit/overrides/laws/* | */.claude/rt-kit/overrides/rules/* | */.claude/rt-kit/overrides/patterns/*)
+                    printf '%s\n' 'spec-driven' ;;
+
                 # Правило и паттерн — такая же договорённость, как спек: обязательные разделы,
                 # утверждение с привязкой, граница между статьёй закона и утверждением правила.
                 # Ветка стоит раньше общего исключения и раньше `*.md`: под исключением текст
@@ -138,9 +145,9 @@ skill_for_default() {
                 || rt_gate_invokes "$target" "[^[:space:]]*task:new" \
                 || rt_gate_invokes "$target" "prisma[[:space:]]+(migrate|db)"; then
                 printf '%s\n' 'git-workflow'
-            # Правка тела отчёта через клиент хостинга ловится двумя признаками сразу — вызовом
+            # Правка тела PR через клиент хостинга ловится двумя признаками сразу — вызовом
             # клиента И адресом запроса: одного слова о заявке мало, оно попадает в строку любой
-            # команды, которая о ней пишет. Тело отчёта не читает ни одна проверка, и утверждение
+            # команды, которая о ней пишет. Тело PR не читает ни одна проверка, и утверждение
             # о дереве стареет в нём молча.
             elif rt_gate_invokes "$target" "(gh|glab)[[:space:]]+api" \
                 && printf '%s' "$target" | grep -qE '(-X|--method)[[:space:]]+(PATCH|PUT).*(pulls|merge_requests)/[0-9]+'; then
@@ -154,8 +161,8 @@ skill_for_default() {
                 printf '%s\n' 'git-workflow'
             fi
 
-            # Слияние отчёта — последний момент, когда папку закрытой задачи ещё можно разобрать
-            # тем же отчётом: после слияния сверка очереди её видит, а отвечать за неё уже
+            # Слияние PR — последний момент, когда папку закрытой задачи ещё можно разобрать
+            # тем же PR: после слияния сверка очереди её видит, а отвечать за неё уже
             # некому. Требуется ВТОРЫМ слоем, дополнительно к правилу поставки.
             rt_gate_invokes "$target" "(gh[[:space:]]+pr|glab[[:space:]]+mr)[[:space:]]+merge" \
                 && printf '%s\n' 'task-flow'

package/assets/defaults/project.sh

@@ -166,6 +166,36 @@ rt_is_app_code_default() {
     esac
 }
 
+# Пишет ли команда оболочки файл. Успех — да, и тогда пути из неё судятся тем же признаком,
+# что и путь из вызова инструмента правки.
+#
+# Гарды подписаны на инструменты правки файла, и этого мало: ту же правку кладут командой —
+# перенаправлением, `tee`, `sed -i`, интерпретатором с heredoc. Отбитая правка дважды за один
+# заход легла именно так, и не увидел этого никто: в дереве она неотличима от положенной
+# инструментом. Разбор — `2026-08-15-guard-denied-shell-wrote-anyway.md`.
+#
+# Список намеренно широк, и цена этого названа: команда чтения, в которой стоит имя
+# интерпретатора, будет отбита наравне с командой правки. Узкий список стоил бы дороже —
+# пропущенная форма записи возвращает обход целиком, а найти её можно только промахом.
+rt_shell_writes_default() {
+    printf '%s' "$1" | grep -Eq \
+        '>>?[[:space:]]*[^|&>[:space:]]|\btee\b|\bsed\b[^|]*-i|\bperl\b[^|]*-i|\bpython3?\b|\bnode\b|\bruby\b|\bdd\b[^|]*of=|\bcp\b|\bmv\b|\brm\b|\btouch\b|\btruncate\b|\binstall\b|\bpatch\b|\bgit[[:space:]]+(checkout|restore|apply|stash)\b'
+}
+
+# Пути, названные командой оболочки. Печатает по одному в строке; судит их зовущий.
+#
+# Разбирать оболочку по-настоящему нечем — здесь и не разбирают: из текста вынимается всё, что
+# похоже на путь, и каждое отдаётся признаку. Лишнее он отсеет сам, а пропущенное вернуло бы
+# обход. Кавычки и heredoc снимаются заменой на пробел: путь внутри них тот же самый.
+rt_shell_paths_default() {
+    printf '%s' "$1" \
+        | tr "\"'\`(),;=" '        ' \
+        | tr '[:space:]' '\n' \
+        | grep -E '^[A-Za-z0-9_@.-]*/[A-Za-z0-9_@./-]+$' \
+        | sed 's|^\./||' \
+        | sort -u
+}
+
 # Имя ветки, с которой разрешено открывать заявку на слияние: в имени стоит номер задачи.
 # Приставка — либо род правки, либо метка очереди работ: обе формы носят номер, а он и нужен.
 #
@@ -201,6 +231,20 @@ RT_BOARD_CHECK_CMD="${RT_BOARD_CHECK_CMD:-npm run check:board}"
 # Учётная запись, которую ставят исполнителем. Умолчание молчит: у каждого дерева она своя.
 RT_TASK_BOT="${RT_TASK_BOT:-}"
 
+# Почта, которой подписан коммит машинной учётной записи. Целым значением, а не образцом:
+# служебный адрес хостинга состоит из числа, логина и домена, а сопоставляется по числу — логин
+# рядом с ним не сверяет никто. Образец «число, плюс, логин» прошёл бы с чужим числом, то есть
+# ровно с тем промахом, ради которого гард поставки подпись и читает.
+#
+# Отсюда же он берёт логин машинной записи — левой частью адреса, до собаки и после плюса.
+# Вторым свойством логин не объявляется: два объявления одного имени разошлись бы молча.
+# Исполнитель задачи для этого не годится — там, где хостинг ограничил машинную запись,
+# исполнителем ставят человека, а коммит остаётся машинным.
+#
+# Умолчание молчит, и тогда подпись не судится: своей машинной записи у пакета нет, а выдуманная
+# отбивала бы работу в чужом дереве.
+RT_COMMIT_EMAIL="${RT_COMMIT_EMAIL:-}"
+
 # Состояние задачи одним объектом: exists, open, onBoard, assigned, numbered. Спрашивает
 # помощника очереди работ — того же, которым пользуются сверка и команда заведения, чтобы
 # гард и очередь одинаково понимали «задача в порядке». Нет узла, нет помощника, нет сети —
@@ -259,6 +303,8 @@ 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_shell_writes() { rt_shell_writes_default "$@"; }
+rt_shell_paths() { rt_shell_paths_default "$@"; }
 rt_qa_decorative() { rt_qa_decorative_default "$@"; }
 rt_task_state() { rt_task_state_default "$@"; }
 rt_report_body() { rt_report_body_default "$@"; }