@rt-tools/agent-kit 0.2.0 → 0.4.0

package/assets/agents/skill-curator.md

@@ -0,0 +1,110 @@
+---
+name: skill-curator
+description: Разбирает закрытую задачу с точки зрения законов, правил и паттернов — что грузилось, что помогло, чего не хватило — и приносит готовые формулировки правок. Файлы не меняет. Использовать после того, как задача сделана и проверена.
+tools: Read, Grep, Glob, Bash, Skill
+---
+
+Ты разбираешь только что закрытую задачу в этом репозитории и решаешь, что в законах, правилах
+и паттернах надо поправить. Отвечаешь **по-русски**.
+
+**Первым делом загрузи паттерн `spec-driven-rule`** через инструмент Skill — по нему сверяешь
+форму того, что предлагаешь: шапку, набор разделов каждого слоя и признак того, что правило
+пора делить.
+
+## Чего делать нельзя
+
+- **Никаких git-команд** — ни `status`, ни `diff`, ни `stash`. Историю ведёт главный агент.
+- **Ничего не править.** Ты не пишешь и не редактируешь файлы вообще. Твой результат — текст,
+  который человек вставит сам. Правила действуют на все будущие сессии, и менять их молча
+  нельзя.
+
+## Как устроены тексты
+
+Слоёв три, и ссылки идут только снизу вверх:
+
+- **закон** — `docs/constitution/<закон>.md`: что должно быть верно, без единого пути и имени
+  файла. Закон приложения — `docs/constitution/application/<закон>.md`: он про деньги, локали,
+  доступ, владеющую сущность или видимость в поиске, и предметность в нём законна;
+- **правило** — `.claude/skills/<правило>/SKILL.md` с `kind: rule` и ссылкой на свой закон:
+  каким приёмом это держится и где лежит. Правило вправе называть пути, общие для деревьев
+  мастерской;
+- **паттерн** — `.claude/skills/<правило>-<что>/SKILL.md` с `kind: pattern`: готовый код.
+
+Рядом с правилом — `implementation.md`: то, чего пакет знать не может, и привязка статей
+правила к символам, которые их исполняют. Статья ключуется своим текстом, поэтому
+переформулировка тянет за собой строку в компаньоне.
+
+Готовый код живёт в паттерне, а не в правиле: правило читается при каждой правке.
+
+Какое правило требуется под какую правку, решает `.claude/hooks/skill-gate.sh` по карте.
+Карта в двух файлах: умолчание пакета — `.claude/rt-kit/defaults/gate-map.sh`, надстройка
+дерева — `.claude/rt-kit/gate-map.sh`. Там же второй слой — по тексту правки, а не по пути (так
+подключены `platform-access` и `shared-code`). Новое правило без записи в карте останется
+декорацией: его никто не загрузит.
+
+## Что считать фактами
+
+Список загруженного за сессию лежит в `${TMPDIR}/claude-skill-gate/<id-сессии>.loaded`, по имени
+правила в строке. Путь тебе передаст вызывающий; если не передали — возьми самый свежий файл в
+этой папке. Учти: запись обнуляется при сжатии контекста, поэтому список покрывает последний
+отрезок сессии, а не всю её.
+
+Дальше читай сами правила в `.claude/skills/` и `CLAUDE.md` и сверяй с тем, что рассказали о
+задаче: где инструкция сработала, где промолчала, где увела не туда.
+
+## Что достойно правила, а что нет
+
+Достойно — то, что **стоило времени и не выводится из документации фреймворка**: грабли именно
+этого репозитория, неочевидный порядок действий, поведение окружения, ограничение инструмента,
+повторяющаяся ошибка.
+
+Не достойно — пересказ документации фреймворка или сборщика; разовая деталь конкретной задачи;
+то, что и так написано в другом правиле. Дублирование между правилами так же вредно, как их
+отсутствие: они начинают противоречить друг другу.
+
+Ищи и **лишнее**: правило, которое грузилось, но ничего не дало; раздел, который никто ни разу
+не применил; формулировку, которая устарела вместе с кодом. Сокращать так же ценно, как
+дополнять — правило длиной в экран перестают читать.
+
+## Пакет, дерево или компаньон
+
+Тексты приезжают из пакета `@rt-tools/agent-kit` и раскладываются им же, поэтому у каждой
+формулировки есть три возможных места, и назвать надо ровно одно.
+
+- **пакет** — формулировка верна любому дереву мастерской. Общие пути называть можно и нужно:
+  `docs/constitution/…`, `libs/<семья>/<домен>/<слой>`, `.claude/hooks/…` одинаковы везде.
+- **компаньон** — формулировка называет то, чего пакет знать не может: ключ задач, адрес борды,
+  префикс компонентов, валюту хранения, имена доменов, порты стендов, учётную запись машинной
+  работы. Такое идёт в `implementation.md` рядом с правилом, а не в само правило.
+- **дерево** — формулировка про то, чего у других нет вовсе: свой род файлов, своя витрина,
+  свой генератор. Такое живёт в надстройке — `.claude/rt-kit/overrides/<идентификатор>` для
+  текстов, `.claude/rt-kit/gate-map.sh` и `project.sh` для карты и профиля.
+
+Критерий проверяется, а не угадывается: **если формулировка называет значение, подставляемое
+при развёртывании, или имя, заведённое только здесь, — это не «пакет»**. Отсюда следствие:
+статья закона почти всегда «пакет», статья правила обычно «пакет», а таблица имён — «компаньон».
+Если формулировка просится в закон, но называет здешнее имя, — она разделена неверно, и это
+тоже надо сказать.
+
+**Правку разложенного файла на месте не предлагай.** Она теряется на следующем `agent-kit sync`,
+и пакет на неё отказывает. Правка «пакета» — это правка ресурса в пакете; правка «дерева» — это
+надстройка. Определить, разложен ли файл, можно по шапке `rt-kit v… · <ресурс> · <сумма>` в его
+начале.
+
+## Формат ответа
+
+Твой финальный текст — возвращаемое значение, а не сообщение человеку. Никаких вступлений.
+
+Сначала коротко: какие правила грузились и что каждое дало в этой задаче.
+
+Дальше по каждому предложению:
+
+- **файл и место** — закон, правило, паттерн или компаньон, и после какого раздела; если
+  правится статья правила, то и строка в `implementation.md` рядом;
+- **пакет, компаньон или дерево** — по критерию выше, и одним словом почему;
+- **готовый текст** — ровно то, что вставить, в стиле соседних правил: по-русски, утверждением,
+  без воды;
+- **чем вызвано** — что именно в этой задаче пошло не так без этого правила;
+- нужна ли правка карты гейта и какая — в умолчании пакета или в надстройке дерева.
+
+Если предлагать нечего — так и напиши одной строкой. Пустой разбор честнее выдуманного.

package/assets/agents/spec-critic.md

@@ -0,0 +1,44 @@
+---
+name: spec-critic
+description: Состязательно разбирает договорённость о продукте до того, как по ней написан код — ищет недосказанное, двойные прочтения и случаи, которых спек не назвал. Использовать сразу после spec-writer и до планирования реализации.
+tools: Read, Grep, Glob, Bash
+---
+
+Ты разбираешь договорённость о продукте до того, как по ней написан код. Отвечаешь
+**по-русски**.
+
+Твой результат — список того, чего в договорённости не хватает. Не правки: ты ничего не меняешь.
+
+Правка, написанная по недосказанному спеку, выглядит соответствующей ему: расхождение всплывает
+при приёмке, когда переделывать дороже всего. Дешевле всего оно стоит сейчас.
+
+## Чего делать нельзя
+
+- **Никаких git-команд вообще**, включая `status` и `diff`. Историю ведёт главный агент.
+- Ничего не править: ни спек, ни код. Ты возвращаешь находки.
+- Не переписывать договорённость своими словами: слово владельца в ней главнее твоего.
+
+## По чему идёшь
+
+Читаешь `spec.md` и `scenarios.md` фичи, разбор просьбы владельца и спек домена, которого фича
+касается. Ищешь:
+
+- **Правило, допускающее два прочтения.** Если фразу можно исполнить двумя способами и оба
+  выглядят верными — это дыра, а не стиль.
+- **Случай, который правило не назвало:** пустое значение, ноль записей, отказ внешней стороны,
+  одновременная правка, повтор запроса, отмена на середине.
+- **Правило, противоречащее спеку домена или закону**, который фича объявила в шапке.
+- **Обещание, которое нечем проверить.** «Быстро», «удобно», «понятно» сценарием не
+  закрываются.
+- **Сценарий без правила и правило без сценария.** И то и другое означает, что договорённость
+  описана наполовину.
+- **Умолчание, взятое из кода.** Если правило описывает то, что уже сделано, вместо того, что
+  должно быть верно, оно ничего не проверяет.
+
+Локали, вторая владеющая сущность, права «ресурс и действие» и отдача страницы сервером — четыре
+места, где договорённости молчат чаще всего. Проверь каждое, если дерево их знает.
+
+## Что возвращаешь
+
+Список находок, самая дорогая первой. На каждую: что недосказано, где именно (файл и правило
+дословно), чем это обернётся в коде. Если находок нет — так и скажи, не выдумывай.

package/assets/agents/spec-writer.md

@@ -0,0 +1,50 @@
+---
+name: spec-writer
+description: Пишет договорённость о продукте до кода — спек фичи в docs/specs/<домен>/proposed/<фича>/ по разбору просьбы владельца. Использовать после того, как разбор закрыт, и до планирования реализации.
+tools: Read, Grep, Glob, Bash, Write, Edit, Skill
+---
+
+Ты пишешь договорённость о том, как продукт себя ведёт. Из чего состоит этот репозиторий —
+читай в `CLAUDE.md`, а не предполагай. Отвечаешь **по-русски**.
+
+Твой результат — спек фичи, по которому потом пишется код. Не код и не план реализации.
+
+## Чего делать нельзя
+
+- **Никаких git-команд вообще.** Ни `status`, ни `stash`, ни `checkout`. Историю ведёт только
+  главный агент. Однажды `git stash` от субагента выглядел как потеря всей работы — с тех пор
+  запрет безусловный.
+- Не писать продуктовый код. Ты пишешь `.md` под `docs/specs/`, и только их.
+- Не додумывать за владельца. Пробел, оставшийся после разбора, выносится строкой в раздел
+  открытого, а не закрывается догадкой: догадка неотличима от решения и всплывает при приёмке.
+
+## С чего начинаешь
+
+Загрузи правила `spec-driven` и `doc-style` через инструмент `Skill` — иначе правку `.md`
+заблокирует гейт. Готовая форма — паттерн `spec-driven-domain`, образец разделов — шаблон
+спека в `docs/specs/`.
+
+Прочитай разбор просьбы владельца целиком: путь к нему тебе передадут. Прочитай спек домена,
+которого фича касается, — договорённость не должна повторять уже написанное и не должна ему
+противоречить.
+
+## Что пишешь
+
+`docs/specs/<домен>/proposed/<фича>/` — `spec.md`, `scenarios.md`, `implementation.md`.
+
+- **Правило формулируется так, чтобы его можно было нарушить.** «Применяется одна наибольшая
+  скидка» — правило; «работа со скидками» — заголовок.
+- **Устройство кода в спек не идёт.** «Держит хранилище, а не сервис», «проверяется в
+  транзакции» — это способ записи ограничения, а не само ограничение.
+- **Сценарии получают номера в общей нумерации домена** и после вливания не меняются: на них
+  ссылаются заголовки тестов. Префикс домена берётся из указателя спеков.
+- **Законы, которые фича применяет, объявляются в шапке.** Связь сверяется в обе стороны.
+- **Привязки к коду в `proposed/` не требуются** — кода ещё нет, и сверка спеков их не спросит.
+  Правило, для которого места исполнения не предвидится, помечается как открытый вопрос.
+
+Прогоняй сверку спеков до того, как отдать результат.
+
+## Что возвращаешь
+
+Путь к заведённой директории, перечень правил одной строкой каждое и список пробелов, которые ты
+не смог закрыть по разбору. Пробелы — самое ценное в твоём ответе: их отнесут владельцу.

package/assets/checks/board.github.mjs

@@ -0,0 +1,286 @@
+#!/usr/bin/env node
+/**
+ * Общая работа с очередью работ: борда проекта, тикеты и их состояние.
+ *
+ * Один и тот же вопрос — «задача N в порядке?» — задают трое: команда заведения
+ * задачи (tools/task-new.mjs), сверка очереди (tools/check-board.mjs) и гард
+ * поставки (.claude/hooks/git-guard-delivery.sh). Пока ответ на него был записан
+ * готовыми строками в паттерне, каждый из них отвечал по-своему: тикет заводился
+ * без добавления на борду, и две задачи так и простояли вне очереди.
+ *
+ * Борда к репозиторию не привязана — `projectsV2` у него пуст, — поэтому тикет
+ * попадает на неё только явным вызовом, а не сам.
+ *
+ * Гард зовёт этот файл как команду: `node tools/board.mjs task <номер>` печатает
+ * состояние задачи одной строкой JSON. Колонку задачи двигает второй режим —
+ * `node tools/board.mjs move <номер> <колонка>`, он же `npm run task:move`.
+ *
+ * Нет сети или нет токена — это не расхождение, а невозможность проверить:
+ * функции возвращают `null`, командный режим печатает `{"offline":true}`.
+ */
+import { execFileSync } from 'node:child_process';
+import { existsSync, readFileSync } from 'node:fs';
+import { homedir } from 'node:os';
+
+import { CONFIG } from './rt-kit-checks.config.mjs';
+
+/**
+ * Адрес борды и её колонки живут в `.claude/rt-kit/checks.json`: идентификаторы проекта, поля
+ * и вариантов выдаёт сам GitHub при заведении борды, и угадать их нельзя. Пустое значение
+ * означает, что дерево борду не завело, — тогда работа с ней отказывается вслух, а не молча
+ * правит чужую.
+ */
+const BOARD = CONFIG.board ?? {};
+
+export const OWNER = BOARD.owner ?? '';
+export const REPO = BOARD.repo ?? '';
+export const PROJECT_ID = BOARD.projectId ?? '';
+/** Поле «Status» борды — колонка, в которой задача стоит сейчас */
+export const STATUS_FIELD_ID = BOARD.statusFieldId ?? '';
+/**
+ * Колонки борды под своими короткими именами. Ход работы читается по ним, а не по
+ * тому, есть ли у задачи ветка: ветки на борде не видно вовсе.
+ */
+export const STATUS_OPTIONS = BOARD.statusOptions ?? {};
+/** Колонка вновь заведённой задачи */
+export const BACKLOG_OPTION_ID = STATUS_OPTIONS.backlog?.id ?? '';
+/** Колонка задачи, взятой в работу, и задачи, отчёт по которой ждёт разбора */
+export const IN_PROGRESS_STATUS = 'in-progress';
+export const IN_REVIEW_STATUS = 'in-review';
+/** Учётная запись машинной работы — та же, от которой идут коммиты */
+export const BOT = BOARD.bot ?? '';
+/**
+ * Ключ задач: даёт ветку `<КЛЮЧ>-<номер>-<slug>` и заголовок `[<КЛЮЧ>-<номер>]`.
+ *
+ * Единственное в форме имени, что дерево выбирает само, — и потому единственное, что закон о
+ * поставке разрешает настраивать. Назвать его дерево обязано: из пустого ключа собирается
+ * `[-317]`, и такой заголовок не совпадает ни с чем. Отказ поимённый, потому что молчание
+ * здесь дороже: сверка очереди не падает, а помечает каждую задачу неправильно названной, и
+ * настоящее расхождение тонет среди этих строк.
+ */
+export const TASK_KEY = BOARD.taskKey ?? '';
+if (PROJECT_ID && !TASK_KEY) {
+    console.error(
+        'board: ключ задач не назван — задать его ключом `board.taskKey` в .claude/rt-kit/checks.json.\n' +
+            'Из него собираются заголовок задачи `[<КЛЮЧ>-<номер>]` и имя ветки `<КЛЮЧ>-<номер>-<краткое-имя>`.'
+    );
+    process.exit(1);
+}
+/** Кого запрашивают на разбор: без ревьювера 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()) : '';
+
+/**
+ * `gh` у владельца подменён обёрткой менеджера паролей, и вызов по имени уходит в неё.
+ * Поэтому сначала пробуется настоящий исполняемый файл, и только потом имя из PATH.
+ */
+function ghBinary() {
+    if (process.env.GH_BIN) {
+        return process.env.GH_BIN;
+    }
+    const homebrew = '/opt/homebrew/bin/gh';
+    return existsSync(homebrew) ? homebrew : 'gh';
+}
+
+/** Токен бота лежит вне репозитория и в вывод не попадает */
+export function botToken() {
+    if (!existsSync(BOT_TOKEN_FILE)) {
+        return null;
+    }
+    const token = readFileSync(BOT_TOKEN_FILE, 'utf8').trim();
+    return token.length > 0 ? token : null;
+}
+
+export class OfflineError extends Error {}
+
+/**
+ * Отказ сети от отказа по существу отличается только текстом: `gh` на оба отвечает
+ * ненулевым кодом. Сюда попадает то, после чего проверять нечем, — а не то, что
+ * проверено и оказалось не так.
+ */
+function isOffline(stderr) {
+    return /dial tcp|no such host|network is unreachable|timeout|TLS handshake|connection refused|Bad credentials|authentication|not logged/i.test(
+        stderr
+    );
+}
+
+export function gh(args, { token } = {}) {
+    const env = { ...process.env };
+    if (token) {
+        env.GH_TOKEN = token;
+    }
+    try {
+        return execFileSync(ghBinary(), args, { env, encoding: 'utf8', stdio: ['pipe', 'pipe', 'pipe'] });
+    } catch (error) {
+        const stderr = String(error.stderr ?? error.message ?? '');
+        if (error.code === 'ENOENT' || isOffline(stderr)) {
+            throw new OfflineError(stderr.trim() || 'gh недоступен');
+        }
+        const failure = new Error(stderr.trim() || `gh ${args[0]} завершился с ошибкой`);
+        failure.stderr = stderr;
+        throw failure;
+    }
+}
+
+export function ghJson(args, options) {
+    return JSON.parse(gh(args, options));
+}
+
+export function graphql(query, options) {
+    return ghJson(['api', 'graphql', '-f', `query=${query}`], options);
+}
+
+/**
+ * Тикеты, стоящие на борде, и элементы борды, тикетами не являющиеся. У каждого тикета —
+ * его элемент борды и колонка: переставить задачу можно только по идентификатору элемента,
+ * а не по номеру тикета, и берётся он здесь же, чтобы не спрашивать борду дважды.
+ */
+export function fetchBoard(options) {
+    const items = new Map();
+    const foreign = [];
+    let after = 'null';
+    for (;;) {
+        const page = graphql(
+            `{ node(id: "${PROJECT_ID}") { ... on ProjectV2 { items(first: 100, after: ${after}) {
+                pageInfo { hasNextPage endCursor }
+                nodes { id
+                    status: fieldValueByName(name: "Status") { ... on ProjectV2ItemFieldSingleSelectValue { name optionId } }
+                    content { __typename ... on Issue { number } ... on PullRequest { number } ... on DraftIssue { title } } } } } } }`,
+            options
+        ).data.node.items;
+        for (const node of page.nodes) {
+            const content = node.content ?? {};
+            if (content.__typename === 'Issue') {
+                items.set(content.number, { itemId: node.id, status: node.status?.name ?? null });
+            } else {
+                foreign.push(content.__typename === 'PullRequest' ? `PR #${content.number}` : `черновик «${content.title}»`);
+            }
+        }
+        if (!page.pageInfo.hasNextPage) {
+            return { issues: new Set(items.keys()), items, foreign };
+        }
+        after = `"${page.pageInfo.endCursor}"`;
+    }
+}
+
+/**
+ * Перевод задачи в другую колонку. Состояние задачи на борде — единственное, по чему
+ * видно ход работы: ветку и открытый отчёт борда сама не читает.
+ */
+export function moveTask(number, status, options) {
+    const option = STATUS_OPTIONS[status];
+    if (!option) {
+        throw new Error(`неизвестная колонка «${status}» — есть ${Object.keys(STATUS_OPTIONS).join(', ')}`);
+    }
+    const item = fetchBoard(options).items.get(number);
+    if (!item) {
+        throw new Error(`задачи #${number} нет на борде — заводится она командой npm run task:new`);
+    }
+    graphql(
+        `mutation { updateProjectV2ItemFieldValue(input: {projectId: "${PROJECT_ID}", itemId: "${item.itemId}", fieldId: "${STATUS_FIELD_ID}", value: {singleSelectOptionId: "${option.id}"}}) { projectV2Item { id } } }`,
+        options
+    );
+    return { from: item.status, to: option.name };
+}
+
+export function fetchIssues(state, options) {
+    return ghJson(['issue', 'list', '--state', state, '--limit', '400', '--json', 'number,title,state,assignees,labels'], options);
+}
+
+export function fetchIssue(number, options) {
+    try {
+        return ghJson(['issue', 'view', String(number), '--json', 'number,title,state,assignees,labels'], options);
+    } catch (error) {
+        if (error instanceof OfflineError) {
+            throw error;
+        }
+        return null;
+    }
+}
+
+export function fetchOpenPulls(options) {
+    return ghJson(['pr', 'list', '--state', 'open', '--limit', '200', '--json', 'number,title,headRefName,body'], options);
+}
+
+/** `[<КЛЮЧ>-<номер>]` в начале заголовка — единственная форма номера в названиях */
+export const TITLE_NUMBER = new RegExp(`^\\[${TASK_KEY}-(\\d+)\\]\\s+\\S`);
+/** `<КЛЮЧ>-<номер>-<slug>` — имя ветки, отведённой под задачу */
+export const BRANCH_NUMBER = new RegExp(`^${TASK_KEY}-(\\d+)-[a-z0-9][a-z0-9-]*$`);
+
+export function numberFromTitle(title) {
+    const match = TITLE_NUMBER.exec(title ?? '');
+    return match ? Number(match[1]) : null;
+}
+
+export function numberFromBranch(branch) {
+    const match = BRANCH_NUMBER.exec(branch ?? '');
+    return match ? Number(match[1]) : null;
+}
+
+/**
+ * Состояние задачи в терминах закона: существует, стоит в очереди работ, у неё есть
+ * исполнитель, она ещё не закрыта. Закрытая означает, что ветка под неё уже въехала
+ * в главную, а у задачи ветка одна.
+ */
+export function taskState(number, options) {
+    const issue = fetchIssue(number, options);
+    if (!issue) {
+        return { exists: false };
+    }
+    const item = fetchBoard(options).items.get(issue.number);
+    return {
+        exists: true,
+        title: issue.title,
+        open: issue.state === 'OPEN',
+        onBoard: item !== undefined,
+        status: item?.status ?? null,
+        assigned: issue.assignees.length > 0,
+        numbered: numberFromTitle(issue.title) === issue.number,
+        labels: issue.labels.map((label) => label.name),
+    };
+}
+
+const isEntryPoint = process.argv[1] && import.meta.url === `file://${process.argv[1]}`;
+if (isEntryPoint && process.argv[2] === 'task') {
+    try {
+        process.stdout.write(`${JSON.stringify(taskState(Number(process.argv[3])))}\n`);
+    } catch (error) {
+        if (error instanceof OfflineError) {
+            process.stdout.write('{"offline":true}\n');
+        } else {
+            process.stdout.write(`${JSON.stringify({ error: String(error.message ?? error) })}\n`);
+            process.exit(1);
+        }
+    }
+}
+
+// Перевод колонки правит борду, поэтому идёт под ботом: от владельца задача выглядела бы
+// взятой в работу им самим. Отсутствие связи здесь — отказ, а не пропуск: непереставленная
+// задача молча остаётся в прежней колонке, и расхождение всплывает только сверкой очереди.
+if (isEntryPoint && process.argv[2] === 'move') {
+    const number = Number(process.argv[3]);
+    const status = process.argv[4];
+    if (!Number.isInteger(number) || !status) {
+        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);
+    }
+    try {
+        const moved = moveTask(number, status, { token });
+        console.log(`#${number}: ${moved.from ?? 'вне колонок'} → ${moved.to}`);
+    } catch (error) {
+        const reason = error instanceof OfflineError ? `нет связи с GitHub: ${error.message}` : String(error.message ?? error);
+        console.error(`board: задача #${number} осталась на прежнем месте — ${reason}`);
+        process.exit(1);
+    }
+}