@rt-tools/agent-kit 0.17.0 → 0.19.0

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

@@ -0,0 +1,123 @@
+/**
+ * Связь задачи с эпиком. Живёт своим файлом: сверка очереди работ и без неё стоит у предела
+ * длины, а читают эти две проверки порознь.
+ */
+import { existsSync, readFileSync } from 'node:fs';
+import { join } from 'node:path';
+
+import { TASK_KEY } from './board.mjs';
+import { CONFIG, ROOT } from './rt-kit-checks.config.mjs';
+
+/**
+ * Метка карточки эпика. Не названа — связь не судится: отличить карточку эпика от обычной
+ * задачи станет нечем.
+ */
+const EPIC_LABEL = CONFIG.board?.epicLabel ?? '';
+
+/**
+ * Строки состава эпика — те, что стоят в таблице с колонкой «Задача».
+ *
+ * Замысел эпика держит и другие таблицы: источники находок, состав семей, счёт пунктов. Номера,
+ * взятые из всего текста и даже из всех таблиц, делали бы задачей эпика всё, что он упомянул, —
+ * прошлый эпик, из находок которого он вырос, разбор, задачу соседнего дерева.
+ */
+function planRows(plan) {
+    const rows = [];
+    let inside = false;
+    for (const line of plan.split('\n')) {
+        const isRow = line.trimStart().startsWith('|');
+        if (!isRow) {
+            inside = false;
+            continue;
+        }
+        if (!inside) {
+            // Граница слова здесь не годится: `\b` знает только латиницу, и с кириллицей она не
+            // совпадает никогда — проверка молчала бы на любом замысле.
+            inside = /\|[^|]*Задача/.test(line);
+            continue;
+        }
+        rows.push(line);
+    }
+    return rows.join('\n');
+}
+
+/**
+ * Связь задачи с эпиком, прочитанная в обе стороны.
+ *
+ * Задача, заведённая под эпик, называет его в теле, а замысел эпика называет её со своей
+ * стороны. Односторонняя привязка выглядит целой ровно так же, как двусторонняя: читатель
+ * приходит то от замысла эпика, то от его карточки, и вторая сторона существует только для одного из
+ * них. Держалась она подражанием — пока тело писали с образца соседней задачи того же эпика,
+ * строка ехала вместе с формой, а задача, заведённая посреди работы находкой, писалась не с
+ * образца.
+ *
+ * Путь к замыслу берётся из тела карточки эпика: называть его она обязана и так, а настройка
+ * каталога завела бы второй источник правды. Путём считается написание с каталогом — голое имя
+ * файла в теле встречается прозой и уводило бы проверку на первое же упоминание. Замысла нет на
+ * диске — это своё расхождение: карточка ссылается в пустоту.
+ *
+ * Судится только открытое, как и вся остальная сверка: закрытая задача эпика — история, и
+ * строку о ней нечем закрыть.
+ */
+export function checkEpicLinks(open, report) {
+    // Метка не названа — карточку эпика отличить от обычной задачи нечем, и проверка молчит.
+    // Молчит именно так, а не «эпиков нет»: дерево без эпиков и дерево, не назвавшее метки,
+    // здесь неразличимы.
+    if (!EPIC_LABEL) {
+        return;
+    }
+
+    const byNumber = new Map(open.map((issue) => [issue.number, issue]));
+    const epics = open.filter((issue) => (issue.labels ?? []).some((label) => label.name === EPIC_LABEL));
+    const listedBy = new Map();
+    // Эпики, состав которых прочитать не вышло. Их задачи обратной стороной не судятся: о
+    // непрочитанном замысле уже сказано своей строкой, и четыре строки «задачи нет в замысле»
+    // рядом с ней говорят о том же промахе ещё раз, называя виноватыми чужие задачи.
+    const unreadable = new Set();
+
+    for (const epic of epics) {
+        const planPath = String(epic.body ?? '').match(/(?:^|[\s(`])([\w.-]+(?:\/[\w.-]+)+\.md)/)?.[1] ?? null;
+        if (planPath === null) {
+            report(`#${epic.number}: карточка эпика не называет путь к замыслу — состав эпика читать негде`);
+            unreadable.add(epic.number);
+            continue;
+        }
+        if (!existsSync(join(ROOT, planPath))) {
+            report(`#${epic.number}: замысла эпика «${planPath}» нет на диске — карточка ссылается в пустоту`);
+            unreadable.add(epic.number);
+            continue;
+        }
+
+        const plan = readFileSync(join(ROOT, planPath), 'utf8');
+        const mentions = planRows(plan).matchAll(new RegExp(`(?:#|${TASK_KEY}-)(\\d+)`, 'g'));
+        const numbers = new Set([...mentions].map((match) => Number(match[1])));
+        for (const number of numbers) {
+            if (number === epic.number || !byNumber.has(number)) {
+                continue;
+            }
+            listedBy.set(number, epic.number);
+            const body = String(byNumber.get(number).body ?? '');
+            if (!new RegExp(`(?:#|${TASK_KEY}-)${epic.number}\\b`).test(body)) {
+                report(
+                    `#${number}: замысел эпика #${epic.number} задачу называет, а её тело эпика — нет. Допиши строку «Задача эпика #${epic.number}, замысел — ${planPath}»`
+                );
+            }
+        }
+    }
+
+    // Обратная сторона: тело назвало эпик, а замысел эпика этой задачи не знает. Читается
+    // это как задача под эпиком, но «взять следующую» её не отдаст никогда.
+    const epicNumbers = new Set(epics.map((issue) => issue.number));
+    for (const issue of open) {
+        if (epicNumbers.has(issue.number)) {
+            continue;
+        }
+        const named = String(issue.body ?? '').match(new RegExp(`эпика?\\s+(?:#|${TASK_KEY}-)(\\d+)`, 'i'))?.[1];
+        if (named === undefined || !epicNumbers.has(Number(named)) || unreadable.has(Number(named))) {
+            continue;
+        }
+        if (listedBy.get(issue.number) !== Number(named)) {
+            report(`#${issue.number}: тело называет эпик #${named}, а в его замысле задачи нет — «взять следующую» её не отдаст`);
+        }
+    }
+}

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

@@ -0,0 +1,121 @@
+#!/usr/bin/env node
+/**
+ * Вызов клиента хостинга: как его находят, чем подписывают и что считается временным отказом.
+ *
+ * Отделено от работы с очередью работ потому, что предмет здесь другой — не задача и не колонка,
+ * а сам вызов: где взять исполняемый файл, каким токеном его подписать, что читать как «сети
+ * нет» и что повторить. Вместе с очередью это переросло предел длины файла.
+ */
+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';
+
+const BOARD = CONFIG.board ?? {};
+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';
+}
+
+/**
+ * Токен машинной записи лежит вне репозитория и в вывод не попадает. Его отсутствие — не отказ:
+ * дерево, не назвавшее токена в `board.tokenPath`, работает с очередью учётной записью, под
+ * которой залогинен клиент хостинга.
+ */
+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
+    );
+}
+
+/**
+ * Отказ, который проходит сам: хостинг ответил, но не смог.
+ *
+ * Отличается от отказа по существу тем, что повтор его снимает: пятисотые коды, шлюз и его
+ * таймаут. Отказ по праву, по несуществующей записи и по незнакомой колонке сюда не попадают —
+ * они не пройдут и на третий раз, а ждать заставят.
+ */
+function isUnavailable(stderr) {
+    return /HTTP 50[0234]\b|Bad Gateway|Service Unavailable|Gateway Time-?out|Server Error/i.test(stderr);
+}
+
+/** Сколько раз пробовать вызов, который отбит недоступностью хостинга. */
+const TRIES = 3;
+
+/**
+ * Пауза перед следующей попыткой, вдвое длиннее прежней. Синхронная: вызов хостинга здесь тоже
+ * синхронный, и уводить его в обещание пришлось бы вместе со всеми, кто его зовёт.
+ *
+ * Число берётся из окружения ради проб: своей паузы им не нужно, а ждать три секунды на каждый
+ * сценарий они не обязаны.
+ */
+const PAUSE_MS = Number(process.env.RT_GH_RETRY_MS ?? 1000) || 0;
+
+function pause(ms) {
+    if (ms > 0) {
+        Atomics.wait(new Int32Array(new SharedArrayBuffer(4)), 0, 0, ms);
+    }
+}
+
+export function gh(args, { token } = {}) {
+    const env = { ...process.env };
+    if (token) {
+        env.GH_TOKEN = token;
+    }
+
+    let waited = PAUSE_MS;
+    for (let attempt = 1; ; attempt += 1) {
+        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 недоступен');
+            }
+            // Правило требует двигать колонку тем же движением, что и работу, а хостинг отвечал
+            // недоступностью час подряд: без повтора исполнитель либо крутит вызов руками, либо
+            // оставляет колонку отставшей — и находит это сверка уже после открытия заявки.
+            if (isUnavailable(stderr) && attempt < TRIES) {
+                pause(waited);
+                waited *= 2;
+                continue;
+            }
+            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);
+}

package/assets/checks/board.github.mjs

@@ -18,13 +18,16 @@
  * Нет сети или нет токена — это не расхождение, а невозможность проверить:
  * функции возвращают `null`, командный режим печатает `{"offline":true}`.
  */
-import { execFileSync } from 'node:child_process';
 import { existsSync, readFileSync, readdirSync, writeFileSync } from 'node:fs';
-import { homedir } from 'node:os';
 import { join } from 'node:path';
 
+import { OfflineError, botToken, gh, ghJson, graphql } from './board-gh.mjs';
 import { CONFIG, ROOT } from './rt-kit-checks.config.mjs';
 
+// Наружу клиент уезжает отсюда прежним именем: его зовут у борды три соседних модуля и команды
+// дерева, и переписывать их ради переезда объявления значило бы платить за деление файла дважды.
+export { OfflineError, botToken, gh, ghJson, graphql };
+
 /**
  * Адрес борды и её колонки живут в `.claude/rt-kit/checks.json`: идентификаторы проекта, поля
  * и вариантов выдаёт сам GitHub при заведении борды, и угадать их нельзя. Пустое значение
@@ -69,72 +72,6 @@ if (PROJECT_ID && !TASK_KEY) {
 }
 /** Кого запрашивают на разбор: без ревьювера PR не попадает во входящие владельца. */
 export const REVIEWER = BOARD.reviewer ?? '';
-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';
-}
-
-/**
- * Токен машинной записи лежит вне репозитория и в вывод не попадает. Его отсутствие — не отказ:
- * дерево, не назвавшее токена в `board.tokenPath`, работает с очередью учётной записью, под
- * которой залогинен клиент хостинга.
- */
-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);
-}
-
 /**
  * Тикеты, стоящие на борде, и элементы борды, тикетами не являющиеся. У каждого тикета —
  * его элемент борды и колонка: переставить задачу можно только по идентификатору элемента,
@@ -189,7 +126,12 @@ export function moveTask(number, status, options) {
 }
 
 export function fetchIssues(state, options) {
-    return ghJson(['issue', 'list', '--state', state, '--limit', '400', '--json', 'number,title,state,assignees,labels'], options);
+    // Тело берётся вместе со списком, а не поштучным вызовом на задачу: связь с эпиком читается
+    // как раз в нём, а четыреста вызовов вида «покажи одну задачу» стоили бы дороже всей сверки.
+    return ghJson(
+        ['issue', 'list', '--state', state, '--limit', '400', '--json', 'number,title,state,assignees,labels,body'],
+        options,
+    );
 }
 
 export function fetchIssue(number, options) {
@@ -237,8 +179,7 @@ export function pullState(ref, options) {
         author: pull.author?.login ?? null,
         reviewers,
         reviewed: reviewers.filter((login) => login !== (pull.author?.login ?? null)).length > 0,
-        // Конфликт приезжает в отданную заявку чужим слиянием, без единого действия её автора:
-        // хостинг считает сливаемость заново после каждой правки главной ветки. Судится только
+        // Конфликт приезжает чужим слиянием, без единого действия автора заявки. Судится только
         // прямое «конфликтует»: `UNKNOWN` означает, что хостинг ещё считает, и читать его как
         // конфликт значило бы отбивать работу на каждой свежей вершине.
         conflicting: pull.mergeable === 'CONFLICTING',
@@ -246,9 +187,30 @@ export function pullState(ref, options) {
 }
 
 /**
- * Вершина берётся вместе с остальным: спросить её потом значило бы второй вызов на каждый PR,
- * а судят по ней и папку задачи, и прогон.
+ * На сколько коммитов ветка заявки позади главной. Гард судит основание в минуту открытия, а
+ * заявка стоит днями: влитого за это время не видит ни он, ни зелёный прогон. Сравнить нечем —
+ * ноль: сверка без доступа отбивала бы работу вместо промаха; без сети летит отказ, как везде.
  */
+export function behindMain(branch, mainBranch, options) {
+    if (!OWNER || !REPO || !branch || !mainBranch) {
+        return 0;
+    }
+    try {
+        const behind = gh(
+            ['api', `repos/${OWNER}/${REPO}/compare/${encodeURIComponent(mainBranch)}...${encodeURIComponent(branch)}`, '--jq', '.behind_by'],
+            options
+        );
+        return Number(String(behind).trim()) || 0;
+    } catch (error) {
+        if (error instanceof OfflineError) {
+            throw error;
+        }
+        return 0;
+    }
+}
+
+/** Вершина берётся вместе с остальным: по ней судят и папку задачи, и прогон, а спросить её
+ * потом значило бы второй вызов на каждый PR. */
 export function fetchOpenPulls(options) {
     return ghJson(
         ['pr', 'list', '--state', 'open', '--limit', '200', '--json', 'number,title,headRefName,headRefOid,isDraft,body,mergeable'],
@@ -256,6 +218,32 @@ export function fetchOpenPulls(options) {
     );
 }
 
+/**
+ * Свои открытые заявки, помеченные конфликтующими. Спрашивается это в минуту, когда берётся
+ * новая работа: пока отданное конфликтует, влить его человек не может, и каждая следующая
+ * заявка прибавляет к очереди ещё одну, которую придётся догонять.
+ *
+ * Свои — значит открытые машинной записью дерева. Дерево, её не назвавшее, не спрашивается
+ * вовсе: `@me` отвечал бы учётной записью, под которой залогинен клиент хостинга, а это чаще
+ * всего владелец, и его заявки исполнителю не чинить.
+ *
+ * Судится только прямое `CONFLICTING`. `UNKNOWN` означает, что хостинг ещё считает сливаемость
+ * — он пересчитывает её после каждой правки главной ветки, — и читать его как конфликт значило
+ * бы отбивать работу на каждой свежей вершине.
+ */
+export function conflictingPulls(options) {
+    if (!BOT) {
+        return null;
+    }
+    const pulls = ghJson(['pr', 'list', '--author', BOT, '--state', 'open', '--limit', '100', '--json', 'number,headRefName,mergeable'], options);
+    if (!Array.isArray(pulls)) {
+        return null;
+    }
+    return pulls
+        .filter((pull) => pull.mergeable === 'CONFLICTING')
+        .map((pull) => ({ number: pull.number ?? null, branch: pull.headRefName ?? '' }));
+}
+
 /** `[<КЛЮЧ>-<номер>]` в начале заголовка — единственная форма номера в названиях */
 export const TITLE_NUMBER = new RegExp(`^\\[${TASK_KEY}-(\\d+)\\]\\s+\\S`);
 /** `<КЛЮЧ>-<номер>-<slug>` — имя ветки, отведённой под задачу */
@@ -447,6 +435,22 @@ if (isEntryPoint && process.argv[2] === 'pr') {
     }
 }
 
+// Свои конфликтующие заявки одной строкой JSON: `{"conflicting":[{"number":…,"branch":…}]}`.
+// Зовёт её гард поставки перед тем, как пустить взятие новой работы. Дерево без машинной записи
+// отвечает пустым списком: спрашивать не о ком.
+if (isEntryPoint && process.argv[2] === 'conflicts') {
+    try {
+        process.stdout.write(`${JSON.stringify({ conflicting: conflictingPulls() ?? [] })}\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);
+        }
+    }
+}
+
 // Перевод колонки правит борду. Токен машинной записи здесь необязателен: не назвавшее его
 // дерево правит борду учётной записью, под которой залогинен клиент хостинга. Требование
 // токена держало бы очередь работ у дерева, машинной записи не заводившего, и у дерева, чью

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

@@ -42,6 +42,7 @@ import {
     fetchBoard,
     fetchIssues,
     fetchOpenPulls,
+    behindMain,
     gh,
     ghJson,
     numberFromTaskDir,
@@ -50,6 +51,7 @@ import {
 } from './board.mjs';
 import { onlyIgnoredPaths } from './board-paths.mjs';
 import { HAS_PIPELINE, deployLag, evictedOnHead, headCommittedAt, runsOnHead, verdictOnHead } from './board-runs.mjs';
+import { checkEpicLinks } from './board-epics.mjs';
 import { similarTitles } from './board-titles.mjs';
 import { CONFIG, ROOT } from './rt-kit-checks.config.mjs';
 
@@ -70,6 +72,18 @@ const RUN_GRACE_MINUTES = 10;
  * Рабочий поток выкатки и ветка, с которой прод сравнивают. Не назвав потока, дерево сверки
  * прода не получает — и сверка говорит об этом вслух: молчание читалось бы как «прод сошёлся».
  */
+/**
+ * Метки, которыми в очереди работ помечен груз — присланные деревьями разборы происшествий и
+ * предложения. Задачами они не являются: заголовок у них без номера, исполнителя нет, на борде
+ * их нет, — и сверка печатала на каждую по три строки, среди которых настоящее расхождение уже
+ * не читалось. Заводить такие записи в очередь перестали, а заведённые прежним порядком оттуда
+ * никуда не денутся: закрывать их — решение владельца, а не сверки.
+ *
+ * Имя метки называет дерево: у каждого оно своё, а выдуманное умолчание не совпало бы ни с чем
+ * и молча выключило бы отсев. Дерево, метки не назвавшее, судится как прежде.
+ */
+const CARGO_LABELS = new Set(CONFIG.board?.cargoLabels ?? []);
+
 const DEPLOY_WORKFLOW = CONFIG.deploy?.workflow ?? '';
 const MAIN_BRANCH = CONFIG.deploy?.mainBranch ?? 'main';
 
@@ -265,7 +279,7 @@ function checkConflicting(pull) {
     );
 }
 
-let checked = { issues: 0, pulls: 0 };
+let checked = { issues: 0, pulls: 0, cargo: 0 };
 
 // Черновики судятся по диску и потому проверяются всегда: связи для этого не нужно.
 checkDrafts();
@@ -275,9 +289,13 @@ try {
     const options = { token: botToken() ?? undefined };
     const board = fetchBoard(options);
     const issues = fetchIssues('all', options);
-    const open = issues.filter((issue) => issue.state === 'OPEN');
+    const allOpen = issues.filter((issue) => issue.state === 'OPEN');
+    // Отсев идёт один раз и до всех проверок задачи: помеченная запись не задача целиком, а не
+    // наполовину, — её не судят ни заголовком, ни исполнителем, ни бордой, ни сводкой совпавших
+    // заголовков, ни связью с эпиком.
+    const open = CARGO_LABELS.size === 0 ? allOpen : allOpen.filter((issue) => !(issue.labels ?? []).some((label) => CARGO_LABELS.has(label.name)));
     const pulls = fetchOpenPulls(options);
-    checked = { issues: issues.length, pulls: pulls.length };
+    checked = { issues: issues.length, pulls: pulls.length, cargo: allOpen.length - open.length };
 
     for (const item of board.foreign) {
         report(`борда: ${item} — на борде стоят задачи, а не PR о них`);
@@ -298,6 +316,7 @@ try {
     }
 
     similarTitles(open);
+    checkEpicLinks(open, report);
 
     const openNumbers = new Set(open.map((issue) => issue.number));
     const claimed = new Map();
@@ -330,6 +349,17 @@ try {
 
         checkConflicting(pull);
 
+        // Отставание заявки от главной ветки: гард судит основание один раз, в минуту открытия,
+        // а заявка стоит днями. Влитая с отставанием, она везёт в главную сочетание, которого не
+        // проверял никто, — и по странице заявки этого не видно: прогон на ней зелёный.
+        const behind = behindMain(pull.headRefName, MAIN_BRANCH, options);
+        if (behind > 0) {
+            report(
+                `PR #${pull.number}: ветка отстала от «${MAIN_BRANCH}» на ${behind} коммитов — прогон шёл от основания, ` +
+                    `которого в главной ветке уже нет. Влей главную, пересмотри набор проверок по тому, что ветка везёт теперь, и прогони заново`
+            );
+        }
+
         if (!FOLDER_SKIP.test(String(pull.body ?? '')) && pull.headRefName) {
             const folder = folderInBranch(pull.headRefName, options);
             if (folder !== null) {
@@ -407,6 +437,12 @@ if (!offline && !DEPLOY_WORKFLOW) {
     console.log('check-board: прод с главной веткой не сверялся — рабочий поток выкатки в настройке дерева не назван');
 }
 
+// Отсеянное называется числом: молчаливый отсев неотличим от сломанной сверки — метка,
+// названная с опечаткой, выключила бы проверку целиком и не сказала бы об этом.
+if (!offline && checked.cargo > 0) {
+    console.log(`check-board: записей груза в очереди ${checked.cargo} — задачами они не судятся`);
+}
+
 if (!offline && !HAS_PIPELINE) {
     console.log('check-board: прогоны на вершинах не спрашивались — файла конвейера в дереве нет');
 }