@mikitasazan/notify 1.4.1 → 1.4.3

package/README.md

@@ -85,36 +85,42 @@ notify report --project playhub --json < payload.json   # весь объект
 | `pr` | событие пул-реквеста | `project`, `action`, `number`, `title` |
 | `issue` | событие задачи | `project`, `action`, `number`, `title` |
 | `incident` | приложение сломалось прямо сейчас | `project`, `title` |
-| `heartbeat_miss` | задача не отметилась вовремя | `project`, `job` |
-| `file` | файл-вложение с подписью-карточкой | `project`, `title`, `path` |
+| `session` | рабочая сессия на маке в беде | `project`, `action` |
+| `heartbeat_miss` | УСТАРЕЛ, молчание — это `job --status silent` | `project`, `job` |
+
+Отдельного вида «файл» нет: `--path` применим к ЛЮБОМУ событию, и тогда
+карточка едет подписью к вложению (подпись у Telegram ограничена 1024 знаками,
+а не 4000). Слово `file` осталось псевдонимом и собирает `report` с вложением —
+старый отправитель не замолкает.
 
 Полные сигнатуры — `src/events.ts`.
 
-**Ключ задачи.** Последняя строка каждой карточки — `#проект/ключ` в `<code>`.
-По нему дневной разборщик сверяет «это 🔴 уже закрыто более поздней карточкой
+**Ключ задачи.** Первая строка каждой карточки — два тега: `#тип #ключ`.
+По ним дневной разборщик сверяет «это 🔴 уже закрыто более поздней карточкой
 той же задачи?» без сравнения человеческих формулировок. Явный `--key`
 побеждает; без него ключ выводится из заголовка и меняется вместе с ним —
 регулярный отправитель передаёт `--key` явно. В stdout CLI ключ не попадает.
 
 **Единственная дверь для свободного HTML** — `sendReport()` (`report --json` у
 аналитик): плотную строку дневного отчёта не разложить в `label=value` не
-испортив. Стандартизирован транспорт, формат — нет, и только здесь.
+испортив. Стандартизирован транспорт, формат тела — нет, и только здесь.
+Строку тегов `#report #ключ` пакет ставит и здесь: тег — фильтр владельца, к
+формату тела он отношения не имеет. Без явного ключа берётся `daily`.
 
 **Неизвестный проект** не роняет вызвавший крон (код возврата 0), но больше и
 не исчезает молча: в mac-config Ops уходит красная карточка «notify: событие
 потеряно». До 18.08.2026 опечатка в `--project` терялась без следа неделями.
 
-`--action` у `pr`: `opened`, `ready_for_review`, `review_requested`, `approved`,
-`changes_requested`, `merged`, `closed`. У `issue`: `opened`, `assigned`,
-`closed`. Принимаются и сырые имена GitHub (`reopened`,
-`review_request_removed`). Неизвестное действие — ошибка разбора, а не молчаливая
-подмена: иначе «запрошены правки» приехали бы как «открыт».
-
-**Но из GitHub в «⚙️ Ops» уходит не всё, что пакет умеет нарисовать.**
-`ready_for_review` и `review_requested` рендерятся (их можно послать вручную из
-CLI), однако общий workflow `.github/workflows/ops-notify.yml` их отбрасывает:
-оба сообщают про PR, который уже объявлен открытым, и открытие одного PR давало
-три карточки подряд. Правило владельца от 27.07.2026 — одна новость, одна
+`--action` у `pr`: `opened`, `approved`, `changes_requested`, `merged`,
+`closed`. У `issue`: `opened`, `assigned`, `closed`. Сырые имена GitHub, которые
+означают то же самое, сводятся к ним: `reopened`, `ready_for_review` и
+`review_requested` — это всё `opened`. Неизвестное действие — ошибка разбора, а
+не молчаливая подмена: иначе «запрошены правки» приехали бы как «открыт».
+
+**Из GitHub в «⚙️ Ops» уходит не всё, что там происходит.** Общий workflow
+`.github/workflows/ops-notify.yml` отбрасывает `ready_for_review` и
+`review_requested` ещё на входе: оба сообщают про PR, который уже объявлен
+открытым, и открытие одного PR давало три карточки подряд. Правило владельца от 27.07.2026 — одна новость, одна
 карточка: **открыт → вердикт ревью (👍 / 📝) → закрыт или смёржен**. Белый список
 живёт в общем workflow, а не в подписках проектов, потому что подписка обязана
 лежать в вызывающем репозитории и в четырёх проектах расходится сама собой;

package/dist/cli-flags.js

@@ -10,8 +10,9 @@
  */
 export const KNOWN_FLAGS = new Set([
     'action', 'actor', 'assignee', 'author', 'body', 'branch', 'commit',
-    'commit-body', 'commit-title', 'commit-url', 'detail', 'expected',
-    'filename', 'item', 'job', 'key', 'last-seen', 'line', 'logs', 'note',
+    'id', 'opened', 'reason', 'workdir',
+    'command', 'command-note', 'commit-body', 'commit-title', 'commit-url', 'detail',
+    'expected', 'filename', 'item', 'job', 'key', 'last-seen', 'line', 'logs', 'note',
     'number', 'path', 'period', 'project', 'reviewer', 'stat', 'status',
     'target', 'title', 'url', 'via', 'workflow-name', 'workflow-url',
     // Флаги без значения. Живут здесь же, чтобы разбор и список не разошлись.

package/dist/cli.js

@@ -106,16 +106,32 @@ const items = () => (flags.get('item') ?? []).map((raw) => {
     const idx = raw.lastIndexOf('|');
     return idx === -1 ? { text: raw } : { text: raw.slice(0, idx), url: raw.slice(idx + 1) };
 });
+/**
+ * `--stat "label=value"`, и с 25.08.2026 — `--stat "Group | label=value"`:
+ * имя группы, вертикальная черта, ярлык. Черта выбрана потому, что её нет ни
+ * в одном живом ярлыке, а двоеточие есть («Eval: bot answer quality») и
+ * равенство занято значением. Пробелы вокруг черты необязательны.
+ *
+ * Без черты всё как было — так шлют больше двадцати отправителей, и ни один
+ * из них менять не нужно.
+ */
 const pairs = (key) => (flags.get(key) ?? []).map((s) => {
     const idx = s.indexOf('=');
-    return idx === -1 ? [s, ''] : [s.slice(0, idx), s.slice(idx + 1)];
+    const head = idx === -1 ? s : s.slice(0, idx);
+    const value = idx === -1 ? '' : s.slice(idx + 1);
+    const bar = head.indexOf('|');
+    return bar === -1
+        ? [head, value]
+        : [head.slice(bar + 1).trim(), value, head.slice(0, bar).trim()];
 });
 const project = () => one('project');
 const PR_ALIASES = {
     opened: 'opened',
     reopened: 'opened',
-    ready_for_review: 'ready_for_review',
-    review_requested: 'review_requested',
+    // A PR that is already announced is not announced again: both of these mean
+    // "this PR now wants eyes", which is what `opened` already says.
+    ready_for_review: 'opened',
+    review_requested: 'opened',
     approved: 'approved',
     changes_requested: 'changes_requested',
     merged: 'merged',
@@ -165,6 +181,9 @@ const jobStatus = () => {
     if (raw === 'disabled') {
         return 'disabled';
     }
+    if (raw === 'silent') {
+        return 'silent';
+    }
     return raw === 'ok' || raw === 'success' || raw === 'passed' || raw === '0' ? 'ok' : 'fail';
 };
 let event;
@@ -206,9 +225,14 @@ else {
                 project: project(),
                 job: one('job') ?? '(no name)',
                 status: jobStatus(),
+                expected: one('expected'),
+                lastSeen: one('last-seen'),
                 stats: pairs('stat'),
                 items: items(),
                 note: one('note'),
+                command: one('command'),
+                commandNote: one('command-note'),
+                logs: one('logs'),
                 workflowUrl: one('workflow-url'),
                 workflowName: one('workflow-name'),
                 url: one('url')
@@ -268,6 +292,21 @@ else {
                 url: one('url')
             };
             break;
+        case 'session':
+            event = {
+                type: 'session',
+                project: project(),
+                action: one('action') ?? 'in trouble',
+                id: one('id'),
+                workdir: one('workdir'),
+                reason: one('reason'),
+                opened: one('opened'),
+                command: one('command'),
+                commandNote: one('command-note'),
+                // Only two states here, so `disabled` must not leak in from jobStatus.
+                status: jobStatus() === 'ok' ? 'ok' : 'fail'
+            };
+            break;
         case 'incident':
             event = {
                 type: 'incident',
@@ -289,21 +328,19 @@ else {
                 note: one('note')
             };
             break;
-        case 'file': {
-            const path = one('path');
-            if (!path) {
-                parseErrors.push('--path: required for a file event');
-            }
+        // `file` is no longer a kind of event — an attachment is a property any
+        // card may have. The word is kept as an alias so senders that still say
+        // `notify file` deliver a report card with the log attached, instead of
+        // falling into the unknown-type branch and going silent.
+        case 'file':
             event = {
-                type: 'file',
+                type: 'report',
                 project: project(),
                 title: one('title') ?? '(no title)',
-                path: path ?? '',
-                filename: one('filename'),
-                note: one('note')
+                period: one('note'),
+                lines: []
             };
             break;
-        }
         default:
             // В parseErrors, а не просто в лог: иначе неизвестный тип уходил в
             // тишину — событие не собиралось, ошибок разбора не было, и CLI выходил
@@ -316,6 +353,12 @@ else {
 // key в самом объекте, отсутствие флага не должно его затирать.
 if (event) {
     event.key = one('key') ?? event.key;
+    // --path is applicable to any type too, for the same reason --key is.
+    event.path = one('path') ?? event.path;
+    event.filename = one('filename') ?? event.filename;
+}
+if (event?.filename && !event.path) {
+    parseErrors.push('--filename: given without --path, so there is no file to name');
 }
 // Ошибки разбора — до отправки: лучше внятно сказать, что не так с командой,
 // чем прислать сообщение с «true» вместо ссылки или 🔴 на успешном деплое.

package/dist/events.d.ts

@@ -22,8 +22,18 @@ export type Project = 'playhub' | 'one-q' | 'arvent' | 'game-publisher' | 'vault
  * потоком по словам `sent|failed|skipped`) ключ не попадает никогда — новое
  * слово там ослепило бы сторожа.
  */
+/**
+ * Общая часть любого события. `path` — локальный файл, который едет ВМЕСТЕ с
+ * карточкой: карточка становится подписью к вложению. Отдельного вида `file`
+ * нет с 25.08.2026 — прогон Arvent слал вердикт и лог двумя карточками про
+ * одну новость.
+ */
 type Keyed = {
     key?: string;
+    /** Локальный файл; карточка уедет как подпись к нему (лимит подписи 1024). */
+    path?: string;
+    /** Имя файла в чате; по умолчанию — имя из `path`. */
+    filename?: string;
 };
 /**
  * Позиция списка внутри сообщения: задача из дайджеста, упавшая проверка,
@@ -78,12 +88,56 @@ export type NotifyEvent = Keyed & (
     type: 'job';
     project: Project;
     job: string;
-    /** `disabled` — задача выключена извне (например GitHub Actions кончил бесплатные минуты), не провалилась сама. */
-    status: 'ok' | 'fail' | 'disabled';
-    stats?: Array<[label: string, value: string | number]>;
+    /**
+     * `disabled` — задача выключена извне (например GitHub Actions кончил
+     * бесплатные минуты), не провалилась сама.
+     *
+     * `silent` — задача не отчиталась в срок: она не упала, она вообще не
+     * подала признаков жизни. Это состояние ЗАДАЧИ, а не отдельный вид
+     * события — оно жило типом `heartbeat_miss`, и владелец справедливо
+     * спросил, почему задача по расписанию у него под двумя разными тегами.
+     * Хуже того: сторож молчания шлёт тот же машинный ключ, что и сама
+     * задача, так что красная карточка `#heartbeat #daily_import` не
+     * закрывалась зелёной `#job #daily_import` — разборщик ищет пару по
+     * ПОЛНОМУ тегу. Один поток на задачу это чинит.
+     */
+    status: 'ok' | 'fail' | 'disabled' | 'silent';
+    /** Как часто задача обязана отмечаться — для `silent` и для возврата из него. */
+    expected?: string;
+    /** Когда её видели в последний раз. */
+    lastSeen?: string;
+    /**
+     * Цифры от отправителя. Третий элемент — ИМЯ ГРУППЫ, под которой строка
+     * встанет. Владелец шесть раз просил группы, и каждый раз отправитель
+     * уже пытался их изобразить подручным: скобками в ярлыке
+     * («GA4 users (sum of days)»), значком в начале строки (🆕 против ⚠),
+     * лишней строкой внизу. Группировать было нечем — теперь есть.
+     *
+     * Без третьего элемента строка идёт без заголовка, как раньше: все
+     * существующие отправители продолжают работать не меняясь.
+     */
+    stats?: Array<[label: string, value: string | number, group?: string]>;
     /** Детали: что именно упало, замечания прогона; у `disabled` — список выключенных процессов (каждый со своей ссылкой). */
     items?: Item[];
     note?: string;
+    /**
+     * A command for him to run, rendered monospaced so Telegram makes it
+     * tap-to-copy. For the case where the card names something on this Mac
+     * that no URL can reach — a stopped local session, a latch file.
+     */
+    command?: string;
+    /**
+     * WHAT that command does. The owner, on a bare `rm` in a card: "я сейчас
+     * введу её и сделаю хуй пойми что, я ж не знаю, что делаю". A command he
+     * cannot read is one he cannot run, so it never travels alone.
+     */
+    commandNote?: string;
+    /**
+     * A local log path — monospaced, not a link, same as on an incident.
+     * It used to be glued onto the end of the reason sentence behind a
+     * colon, which is what made a red card read as one long run-on line.
+     */
+    logs?: string;
     workflowUrl?: string;
     /** Название прогона для видимого текста ссылки (по умолчанию — `open`). */
     workflowName?: string;
@@ -101,7 +155,7 @@ export type NotifyEvent = Keyed & (
     title: string;
     period?: string;
     /** Пусто/не передано, когда используются `groups` — два вида отчёта не смешиваются в одном событии. */
-    lines?: Array<[label: string, value: string | number]>;
+    lines?: Array<[label: string, value: string | number, group?: string]>;
     /**
      * Список позиций со ссылками — для дайджестов задач, где ценность в
      * самих названиях, а не в цифре. Рендерятся отдельным блоком после
@@ -153,7 +207,7 @@ export type NotifyEvent = Keyed & (
  | {
     type: 'pr';
     project: Project;
-    action: 'opened' | 'ready_for_review' | 'review_requested' | 'approved' | 'changes_requested' | 'merged' | 'closed';
+    action: 'opened' | 'approved' | 'changes_requested' | 'merged' | 'closed';
     number: number;
     title: string;
     /** PR description — quoted on its own; the title is the `Title:` field above it. */
@@ -185,7 +239,47 @@ export type NotifyEvent = Keyed & (
     logs?: string;
     url?: string;
 }
-/** Задача не отметилась вовремя — сторож молчания (heartbeat). */
+/**
+ * A working session on this Mac is in trouble — not a job, not a workflow.
+ * It went out as `job` at first and read wrong: `#job` promises something
+ * scheduled that ran and failed, and the owner rightly asked what a burning
+ * session was doing under that heading.
+ *
+ * What makes it its own type rather than an `incident`: a session has an
+ * identity nothing else here has — an id, a working directory, and the line
+ * he typed to start it, which is the ONLY thing that tells two of his open
+ * sessions apart.
+ */
+ | {
+    type: 'session';
+    project: Project;
+    /** What happened, as the second line reads it: `Session: burning the limit`. */
+    action: string;
+    /** The session's own id — the identifier field, first, as everywhere else. */
+    id?: string;
+    /** Working directory name, when several sessions opened with a similar line. */
+    workdir?: string;
+    /** One line of measurement: what the guard saw. */
+    reason?: string;
+    /**
+     * The line he opened the session with. Quoted, never a field: it is his
+     * own writing, it runs long, and a field would clip it to one short line
+     * — which is exactly how the first version of this card lost it.
+     */
+    opened?: string;
+    /** A command for him to run, monospaced so Telegram makes it copyable. */
+    command?: string;
+    /** WHAT that command does — see the note on `job.commandNote`. */
+    commandNote?: string;
+    /** `fail` red, `ok` green — a session that recovered is not an alarm. */
+    status?: 'fail' | 'ok';
+}
+/**
+ * УСТАРЕЛО с 1.4.2: используйте `job` со статусом `silent`. Тип остаётся,
+ * потому что сторож молчания живёт на сервере и до выкатки шлёт именно его —
+ * убрать значит потерять карточку молчания ровно тогда, когда она нужна.
+ * Новых вызовов не добавлять.
+ */
  | {
     type: 'heartbeat_miss';
     project: Project;
@@ -196,26 +290,47 @@ export type NotifyEvent = Keyed & (
     recovered?: boolean;
     /** Готовое предложение-причина; без него собирается из lastSeen/expected. */
     note?: string;
-}
-/**
- * Файл-вложение (sendDocument) с подписью-карточкой. Появился, когда
- * eval-отчёт Arvent слал файл голым curl мимо пакета: без ретраев файл
- * терялся в любую сетевую икоту, а chat_id и номер вкладки жили копией,
- * которая устаревает молча. Маршрут — тот же `ROUTES`, транспорт — с теми
- * же повторами. Подпись у Telegram ограничена 1024 символами — режется
- * тем же безопасным клампом.
- */
- | {
-    type: 'file';
-    project: Project;
-    title: string;
-    /** Путь к локальному файлу. */
-    path: string;
-    /** Имя файла в чате; по умолчанию — имя из `path`. */
-    filename?: string;
-    note?: string;
 });
 export type EventType = NotifyEvent['type'];
 /** Красное = со звуком. Всё остальное — тихо. (Отдельной темы «инциденты» больше нет — авария видна в ленте проекта.) */
+/**
+ * Словарь значков. Два закона, и оба поставлены владельцем 25.08.2026:
+ *
+ * 1. ВНУТРИ одного тега у каждого слова свой значок. Раньше значков было
+ *    ровно четыре на весь пакет, и `Issue: opened` с `Issue: assigned`
+ *    выглядели одинаково, а у задачи три разных беды — fail, disabled,
+ *    silent — были одним и тем же красным кругом.
+ * 2. МЕЖДУ тегами одинаковый смысл выглядит одинаково. `fail` — это 🔴 и в
+ *    выкатке, и в CI, и в задаче; «появилось новое» — 🆕 и у задачи на доске,
+ *    и у PR, и у файла.
+ *
+ * И третий, который держит первые два честными: у значка фиксированный звук.
+ * Не у события, не у статуса — у значка. Пока звук выводился отдельным
+ * правилом, `🔴 PR: changes_requested` приходила беззвучно.
+ */
+export declare const ICON: {
+    readonly ok: "✅";
+    readonly red: "🔴";
+    readonly alarm: "🚨";
+    readonly off: "🚫";
+    readonly unknown: "❓";
+    readonly fresh: "🆕";
+    readonly taken: "🙋";
+    readonly landed: "🎉";
+    readonly discarded: "🗑️";
+    readonly approved: "👍";
+    readonly changes: "📝";
+    readonly info: "ℹ️";
+};
+/** The sound is a property of the icon, and of nothing else. */
+export declare const LOUD: ReadonlySet<string>;
+export declare const PR_ICON: Record<Extract<NotifyEvent, {
+    type: 'pr';
+}>['action'], string>;
+export declare const ISSUE_ICON: Record<Extract<NotifyEvent, {
+    type: 'issue';
+}>['action'], string>;
+/** Одно место, где решается значок карточки, — и рендер, и звук берут его отсюда. */
+export declare const iconFor: (e: NotifyEvent) => string;
 export declare const severity: (e: NotifyEvent) => "info" | "error";
 export {};

package/dist/events.js

@@ -10,19 +10,82 @@
  * Тогда старый вызывающий код и новый пакет совместимы в обе стороны.
  */
 /** Красное = со звуком. Всё остальное — тихо. (Отдельной темы «инциденты» больше нет — авария видна в ленте проекта.) */
-export const severity = (e) => {
-    if (e.type === 'heartbeat_miss') {
-        return e.recovered ? 'info' : 'error';
-    }
-    if (e.type === 'incident') {
-        return 'error';
-    }
-    // `disabled` рисуется красным (`ICON.red` в render.ts) ровно как `fail` —
-    // задача не работает, что бы ни было тому причиной. Молчаливая отправка
-    // красной карточки без звука хуже отсутствия карточки: авария выглядит
-    // аварией, но не будит (тот же довод, что уже был у `fail`).
-    if ('status' in e && (e.status === 'fail' || e.status === 'disabled')) {
-        return 'error';
+/**
+ * Словарь значков. Два закона, и оба поставлены владельцем 25.08.2026:
+ *
+ * 1. ВНУТРИ одного тега у каждого слова свой значок. Раньше значков было
+ *    ровно четыре на весь пакет, и `Issue: opened` с `Issue: assigned`
+ *    выглядели одинаково, а у задачи три разных беды — fail, disabled,
+ *    silent — были одним и тем же красным кругом.
+ * 2. МЕЖДУ тегами одинаковый смысл выглядит одинаково. `fail` — это 🔴 и в
+ *    выкатке, и в CI, и в задаче; «появилось новое» — 🆕 и у задачи на доске,
+ *    и у PR, и у файла.
+ *
+ * И третий, который держит первые два честными: у значка фиксированный звук.
+ * Не у события, не у статуса — у значка. Пока звук выводился отдельным
+ * правилом, `🔴 PR: changes_requested` приходила беззвучно.
+ */
+export const ICON = {
+    ok: '✅', // passed, closed, done
+    red: '🔴', // broken
+    alarm: '🚨', // burning right now
+    off: '🚫', // switched off — it will not run until someone turns it back on
+    unknown: '❓', // did not report: alive or dead is unknown
+    fresh: '🆕', // something new appeared
+    taken: '🙋', // someone took it
+    landed: '🎉', // merged — the work is in
+    discarded: '🗑️', // closed without reaching the result
+    approved: '👍', // a human approved it
+    changes: '📝', // a human wants edits — not a failure, and not loud
+    info: 'ℹ️' // a summary, for information
+};
+/** The sound is a property of the icon, and of nothing else. */
+export const LOUD = new Set([ICON.red, ICON.alarm, ICON.off, ICON.unknown]);
+export const PR_ICON = {
+    opened: ICON.fresh,
+    approved: ICON.approved,
+    changes_requested: ICON.changes,
+    merged: ICON.landed,
+    closed: ICON.discarded
+};
+export const ISSUE_ICON = {
+    opened: ICON.fresh,
+    assigned: ICON.taken,
+    closed: ICON.ok
+};
+const JOB_ICON = {
+    ok: ICON.ok,
+    fail: ICON.red,
+    disabled: ICON.off,
+    silent: ICON.unknown
+};
+/** Одно место, где решается значок карточки, — и рендер, и звук берут его отсюда. */
+export const iconFor = (e) => {
+    switch (e.type) {
+        case 'deploy':
+        case 'ci':
+            return e.status === 'ok' ? ICON.ok : ICON.red;
+        case 'job':
+            return JOB_ICON[e.status];
+        case 'session':
+            return e.status === 'ok' ? ICON.ok : ICON.alarm;
+        case 'incident':
+            return ICON.alarm;
+        case 'heartbeat_miss':
+            return e.recovered ? ICON.ok : ICON.unknown;
+        case 'pr':
+            return PR_ICON[e.action];
+        case 'issue':
+            return ISSUE_ICON[e.action];
+        case 'report':
+            return ICON.info;
     }
-    return 'info';
+};
+export const severity = (e) => {
+    // ONE law: the icon decides the sound. There is no second list of "which
+    // events are bad" to keep in sync with the icons — keeping two lists is how
+    // `🔴 PR: changes_requested` ended up arriving MUTED, the only red card in
+    // the package that did not ring, because severity() looked at `status` and a
+    // pull request has an `action`.
+    return LOUD.has(iconFor(e)) ? 'error' : 'info';
 };

package/dist/index.d.ts

@@ -1,4 +1,5 @@
 export type { EventType, NotifyEvent, Project } from './events.ts';
 export { severity } from './events.ts';
 export { notify, sendReport } from './send.ts';
+export { render } from './render.ts';
 export type { SendResult } from './send.ts';

package/dist/index.js

@@ -1,2 +1,6 @@
 export { severity } from "./events.js";
 export { notify, sendReport } from "./send.js";
+// `render` наружу — чтобы отправитель мог положить на диск РОВНО ту карточку,
+// которая уехала, а не свою вторую версию текста. Сборка копии вручную уже
+// расходилась с отправленным.
+export { render } from "./render.js";

package/dist/render.d.ts

@@ -19,7 +19,7 @@
  * строка разделяет БЛОКИ ПО СМЫСЛУ (шапка / суть / действия), не механически
  * после каждой строки.
  */
-import type { NotifyEvent } from './events.ts';
+import { type NotifyEvent } from './events.ts';
 /** Экранируется ВСЁ, что пришло снаружи — теги ставит только шаблон. */
 export declare const esc: (v: unknown) => string;
 /**
@@ -36,6 +36,7 @@ export declare const esc: (v: unknown) => string;
  *    повторяем — сообщение исчезало совсем.
  */
 export declare const clampMessage: (text: string, limit?: number) => string;
+export declare const slug: (raw: string) => string;
 /**
  * Экземпляр-тег: что именно это конкретное событие (ветка, окружение,
  * задача, номер) — по нему разборщик сверяет 🔴 с более поздней зелёной
@@ -45,6 +46,14 @@ export declare const clampMessage: (text: string, limit?: number) => string;
  * заголовок и есть единственное стабильное поле).
  */
 export declare const eventKey: (e: NotifyEvent) => string;
+/**
+ * Строка тегов для свободного HTML (`sendReport`). Тег — это ФИЛЬТР владельца,
+ * и к формату тела он отношения не имеет: дневной отчёт остаётся свободным
+ * текстом, но перестаёт быть единственной карточкой без тегов. Раньше ключ
+ * висел хвостом в `<i><code>#ключ</code></i>` — это старый формат, до того как
+ * теги переехали первой строкой.
+ */
+export declare const reportTags: (key: string) => string;
 /**
  * Рендерит событие в готовый HTML-текст, обрезанный под лимит Telegram.
  * Теги — ПЕРВАЯ строка, добавляются до обрезки (не после, как раньше): они

package/dist/render.js

@@ -1,5 +1,36 @@
+/**
+ * Один рендерер на тип события, все по одному каркасу — утверждён
+ * владельцем 20.08.2026 после ~15 живых раундов в тестовом форуме:
+ *
+ *   #тип #экземпляр
+ *   значок <b>Тип:</b> действие
+ *
+ *   <b>Ярлык:</b> значение
+ *   <blockquote>цитата чужого текста — тело коммита, тело задачи</blockquote>
+ *
+ *   <i><u>Группа</u></i>
+ *   <b>#N (overdue):</b> <a>заголовок</a>
+ *
+ *   <b>Ярлык:</b> значение   ← действия/направления
+ *
+ * Три уровня начертания, никогда не смешиваются: поле — жирный ярлык с
+ * большой буквы + обычное значение; группа — курсив+подчёркивание, без
+ * жирности и без двоеточия; строка 2 (тип) — тот же закон поля. Пустая
+ * строка разделяет БЛОКИ ПО СМЫСЛУ (шапка / суть / действия), не механически
+ * после каждой строки.
+ */
+import { ICON, LOUD, iconFor } from "./events.js";
 /** Первая буква — заглавная, остальное как есть (ga4/GitHub остаются собой). */
-const cap = (s) => (s.length > 0 ? s.charAt(0).toUpperCase() + s.slice(1) : s);
+/**
+ * Ярлык с большой буквы — но НЕ у имени, которое пишется со строчной нарочно:
+ * `iOS` превращалось в `IOS`. Признак — вторая буква заглавная.
+ */
+const cap = (s) => {
+    if (s.length === 0 || /^[a-z][A-Z]/.test(s)) {
+        return s;
+    }
+    return s.charAt(0).toUpperCase() + s.slice(1);
+};
 /** Экранируется ВСЁ, что пришло снаружи — теги ставит только шаблон. */
 export const esc = (v) => String(v ?? '')
     .replace(/&/g, '&amp;')
@@ -118,6 +149,23 @@ const fieldLink = (label, url, text) => {
 const fieldAction = (label, url, text) => url ? `<b>${esc(cap(label))}:</b> <a href="${esc(url)}">${esc(text ?? 'open')}</a>` : null;
 /** Моноширинное поле — путь/команда для копирования, не ссылка. */
 const fieldCode = (label, value) => value ? `<b>${esc(cap(label))}:</b> <code>${esc(value)}</code>` : null;
+/**
+ * Строка, которая просит что-то ОТ ВЛАДЕЛЬЦА, а не сообщает факт. Она уже
+ * стояла последней и через пустую строку, и всё равно читалась как рядовое
+ * поле среди пяти других. Маркер `▶` — единственное отличие: заголовок группы
+ * здесь был бы третьей строкой разметки на карточку из шести (25.08.2026, два
+ * ревью против группировки), а маркер не тратит ни одной.
+ */
+/**
+ * Действие: что сделать и чем. Без объяснения команда НЕ печатается вовсе —
+ * владелец на голую `rm` в карточке: «я ж не знаю, что делаю». Молча уронить
+ * строку лучше, чем показать ему команду, которую он не может прочитать;
+ * отправителя при этом ловит тест каталога, а не тишина в чате.
+ */
+const fieldRun = (value, why) => {
+    const explain = field('To do', why);
+    return value && explain !== null ? [explain, `▶ <code>${esc(value)}</code>`] : [];
+};
 /** Заголовок группы: курсив + подчёркивание, без жирности, без двоеточия. */
 const group = (name) => `<i><u>${esc(cap(name))}</u></i>`;
 /** Позиция внутри группы: `<b>label:</b> <a>text</a>` — либо простая маркированная/нумерованная строка без label. */
@@ -140,7 +188,36 @@ const note = (text) => {
     const body = esc(text);
     return body.length > EXPAND_AT ? `<blockquote expandable>${body}</blockquote>` : `<blockquote>${body}</blockquote>`;
 };
-const join = (parts) => parts.filter((p) => p !== null).join('\n');
+/**
+ * Цитата с подписью. Голая цитата читается как продолжение поля над ней:
+ * владелец спросил про строку, которой открыта сессия, «что значит этот текст,
+ * откуда он берётся» — и был прав, в карточке это нигде не сказано. Подпись
+ * стоит отдельной строкой, потому что сам текст в поле не помещается: поле
+ * держит одну строку и обрезает.
+ */
+const quoted = (label, text) => text ? `<b>${esc(cap(label))}</b>\n${note(text)}` : null;
+/**
+ * Склейка карточки. Пустая строка здесь — знак смены блока, а не отступ:
+ * две подряд означают пустой блок, ведущая — блок, которого нет. Обе
+ * появляются, когда часть полей не пришла, и обе схлопываются тут, а не
+ * в каждом рендерере по отдельности.
+ */
+const join = (parts) => {
+    const out = [];
+    for (const part of parts) {
+        if (part === null) {
+            continue;
+        }
+        if (part === '' && (out.length === 0 || out[out.length - 1] === '')) {
+            continue;
+        }
+        out.push(part);
+    }
+    while (out.length > 0 && out[out.length - 1] === '') {
+        out.pop();
+    }
+    return out.join('\n');
+};
 /** Плоский список позиций (без ярлыков) — job/report без групп. */
 const bullets = (items, numbered) => (items ?? []).map((it, i) => groupItem(it, i, numbered));
 /** Именованная группа целиком: заголовок + позиции, разделены строкой пустоты внутри вызова через join. */
@@ -163,19 +240,94 @@ const renderGroup = (g) => [
  */
 const titleField = (title) => field('Title', title);
 const bodyQuote = (body) => body ? note(body) : null;
-// Значок = статус сообщения, не тип события. Ровно четыре на весь пакет —
-// закреплённая легенда в форумах обещает это владельцу как факт, не как
-// приближение. 🔴 сломалось, 🚨 инцидент, ✅ прошло, ℹ️ к сведению.
-const ICON = { red: '🔴', alarm: '🚨', ok: '✅', info: 'ℹ️' };
+/**
+ * Строки с ярлыками, разложенные по группам, которые назвал сам отправитель.
+ *
+ * Закон простой и считается программой: назвал группу — заголовок печатается.
+ * Всегда, сколько бы строк в ней ни было и сколько бы групп ни оказалось.
+ * Порог «две и больше» я пробовал и снял: у карточки резервных копий все
+ * цифры лежат в одной группе, а над ними — рассказ о прогоне, и порог гасил
+ * ровно тот шов, ради которого владелец всё это и просил.
+ *
+ * Так же уходит и риск «одна и та же карточка выглядит по-разному в разные
+ * дни»: вид зависит от того, что отправитель НАЗВАЛ в коде, а не от того,
+ * сколько строк набралось сегодня.
+ *
+ * Порядок групп — порядок первого появления у отправителя: он знает, что
+ * важнее. Строки без имени идут первыми и без заголовка — это факты о самой
+ * карточке, а не о каком-то из её предметов.
+ */
+const labelled = (rows) => {
+    const list = rows ?? [];
+    const names = [...new Set(list.map(([, , g]) => g).filter((g) => !!g))];
+    if (names.length === 0) {
+        return list.map(([label, value]) => field(label, value)).filter((l) => l !== null);
+    }
+    const out = [];
+    const bare = list.filter(([, , g]) => !g);
+    for (const [label, value] of bare) {
+        const line = field(label, value);
+        if (line !== null) {
+            out.push(line);
+        }
+    }
+    for (const name of names) {
+        // Пустая строка перед КАЖДЫМ заголовком, включая первый: над ним всегда
+        // стоят поля самой карточки (Task, Period), и без шва заголовок читался
+        // как ещё одна их строка. Двойных пустот бояться не нужно — их схлопывает
+        // `join`.
+        out.push('');
+        out.push(group(name));
+        for (const [label, value] of list.filter(([, , g]) => g === name)) {
+            const line = field(label, value);
+            if (line !== null) {
+                out.push(line);
+            }
+        }
+    }
+    return out;
+};
+/**
+ * Блоки, которыми владеет сам рендерер, — у выкатки и проверки их два, и они
+ * про разные вещи: `Run` это сам прогон и его обстоятельства, `Change` это
+ * изменение, из-за которого он случился. Владелец на CI-карточке: «commit,
+ * actor, workflow — не знаю, всё так сумбурно».
+ *
+ * Заголовок печатается у КАЖДОГО непустого блока, а не только когда их два.
+ * Сначала было «два и больше», ради экономии строки на зелёной карточке, и
+ * это оказалось ошибкой: у зелёной выкатки нет ни цели, ни причины, блок один,
+ * заголовки пропадали — и один и тот же вид уведомления выглядел в разные дни
+ * по-разному. Владелец дважды спросил «почему здесь нет групп», глядя именно
+ * на зелёную. Строка заголовка стоит дешевле, чем необходимость каждый раз
+ * заново искать глазами, где что.
+ */
+const twoBlocks = (run, change) => {
+    const live = (rows) => rows.filter((r) => r !== null && r !== '');
+    const out = [];
+    for (const [name, rows] of [['Run', live(run)], ['Change', live(change)]]) {
+        if (rows.length > 0) {
+            out.push('', group(name), ...rows);
+        }
+    }
+    return out;
+};
+// Значок и его закон живут в events.ts: от него зависит и звук.
 /** Строка 2: значок вне жирного, `<b>Тип:</b> действие` — то же поле, не особый случай. */
 // `action` объявлен строкой, но приходит и из `--json`, и из прямых вызовов на
 // JS, где типов нет. Пустое или отсутствующее значение давало строку `ℹ️ null`
 // прямо во второй строке карточки. Пустая строка честнее: поле просто исчезает.
-const typeLine = (icon, type, action) => {
+// A link belongs on the NAME of the thing it opens, never on a separate row
+// whose only text is the verb `open`. The owner read `Details: open` under a
+// report and asked what "open" was — the answer is the report itself, which was
+// sitting three lines above as dead text. So line 2 takes an optional URL and
+// the action text becomes the link: `Report: <a>Analytics for 12.08</a>`.
+const typeLine = (icon, type, action, url) => {
     // `field` возвращает null на пустом значении, а интерполяция null в шаблон
     // печатает слово «null». Так вторая строка карточки становилась `ℹ️ null` —
     // достижимо через `--json` и прямой вызов на JS, где типов нет.
-    const line = field(type, action);
+    // `action || 'open'` in the linked case: an empty title must not swallow the
+    // link, which would be the one thing the card cannot afford to lose.
+    const line = url ? fieldLink(type, url, action || 'open') : field(type, action);
     return line === null ? `${icon} <b>${esc(cap(type))}</b>` : `${icon} ${line}`;
 };
 // `workflowUrl ?? url`: половина отправителей шлёт ссылку на прогон под именем
@@ -183,23 +335,40 @@ const typeLine = (icon, type, action) => {
 // только `workflowUrl`, поэтому красная карточка приходила БЕЗ ЕДИНОЙ ССЫЛКИ
 // на логи. Отвергать `--url` было бы честнее по имени и хуже по делу: намерение
 // однозначно, а карточка без ссылки бесполезна ровно тогда, когда нужна.
+/**
+ * What to call the thing that ran. The workflow's own name first — it is the
+ * only text here that identifies THIS run. Then the caller's own word for the
+ * mechanism (`manual, from the Mac`). Last resort `the run`, and only when a
+ * link exists: losing the link to the logs on a red card is the one loss this
+ * format cannot afford, and a row that says nothing is still better than a
+ * card with nowhere to click. No live sender reaches that last resort — the
+ * GitHub Action always fills the workflow name, and the hand-run scripts send
+ * no run link at all.
+ */
+const mechanism = (workflowName, via, runUrl) => workflowName ?? via ?? (runUrl ? 'the run' : undefined);
+// The name of what ran sits WITH the type line, not eight lines below it.
+// `Deploy: fail` and `by what means it ran` answer one question, and the owner
+// read the two rows as unrelated things. It used to be one fact split in two:
+// `Via: GitHub Actions` in the middle of the card and a trailing
+// `Workflow: <run>` in the actions block. On one-q that trailing row rendered
+// `Workflow: Deploy` — the link text repeating the word on line 2 and naming
+// nothing.
+//
+// The link text is the workflow's OWN name, never the platform: `GitHub
+// Actions` is identical on every card in every repository, so clicking it told
+// the owner nothing about where he was going. `manual, from the Mac` stays
+// unlinked, because a hand deploy has no run to open.
 const renderDeploy = (e) => {
-    const icon = e.status === 'ok' ? ICON.ok : ICON.red;
+    const icon = iconFor(e);
+    const runUrl = e.workflowUrl ?? e.url;
     return join([
         typeLine(icon, 'Deploy', e.status),
-        '',
-        fieldLink('Commit', e.commitUrl, e.commit),
-        titleField(e.commitTitle),
-        bodyQuote(e.commitBody),
-        field('Via', e.via),
-        field('Target', e.target),
-        field('Reason', e.note),
-        e.workflowUrl ?? e.url ? '' : null,
-        fieldAction('Workflow', e.workflowUrl ?? e.url, e.workflowName)
+        fieldLink('Via', runUrl, mechanism(e.workflowName, e.via, runUrl)),
+        ...twoBlocks([field('Target', e.target), field('Reason', e.note)], [fieldLink('Commit', e.commitUrl, e.commit), titleField(e.commitTitle), bodyQuote(e.commitBody)])
     ]);
 };
 const renderJob = (e) => {
-    const icon = e.status === 'fail' || e.status === 'disabled' ? ICON.red : ICON.ok;
+    const icon = iconFor(e);
     const hasItems = (e.items ?? []).length > 0;
     const disabledList = hasItems && e.status === 'disabled';
     return join([
@@ -210,77 +379,79 @@ const renderJob = (e) => {
         // repeating the label of the line right above it reads as a mistake.
         // Until now the name was dropped entirely — every caller passed it and the
         // owner only ever saw it as the small grey instance tag.
-        field('Task', e.job),
+        // The run link rides on the task's own name. It used to sit at the bottom
+        // as `Workflow: open` — every job caller passes a URL and none passes a
+        // workflow name, so that row was the bare verb the owner objected to.
+        fieldLink('Task', e.workflowUrl ?? e.url, e.job),
         field('Reason', e.note),
-        ...(e.stats ?? []).map(([label, value]) => field(label, value)),
+        field('Expected', e.expected),
+        // `Last run` when the task is alive, `Last seen` when it is not: the same
+        // timestamp answers two different questions.
+        field(e.status === 'silent' ? 'Last seen' : 'Last run', e.lastSeen),
+        ...labelled(e.stats),
         hasItems ? '' : null,
         // Heading ONLY for `disabled`. It used to print for any job carrying a
         // list, so playhub's daily card of newly published games was headed
         // "Disabled workflows".
         disabledList ? group('Disabled workflows') : null,
         ...(hasItems ? bullets(e.items, disabledList) : []),
-        e.workflowUrl ?? e.url ? '' : null,
-        fieldAction('Workflow', e.workflowUrl ?? e.url, e.workflowName)
+        e.command || e.logs ? '' : null,
+        fieldCode('Log', e.logs),
+        ...fieldRun(e.command, e.commandNote),
+        // Kept only when the caller actually names the workflow — a named row is a
+        // second, different destination; an unnamed one repeats the Task link.
+        e.workflowName && (e.workflowUrl ?? e.url) ? '' : null,
+        e.workflowName ? fieldAction('Workflow', e.workflowUrl ?? e.url, e.workflowName) : null
     ]);
 };
 const renderReport = (e) => {
     if (e.groups && e.groups.length > 0) {
         const body = e.groups.flatMap((g, i) => (i === 0 ? renderGroup(g) : ['', ...renderGroup(g)]));
+        // `lines` и `groups` вместе, а не «или»: раньше ветка с группами печатала
+        // ТОЛЬКО группы, и цифры отчёта молча исчезали. Поймано 25.08.2026 при
+        // переводе утреннего отчёта PlayHub на типизированное событие.
+        const numbers = labelled(e.lines);
         return join([
-            typeLine(ICON.info, 'Report', e.period ? `${e.title} · ${e.period}` : e.title),
+            typeLine(iconFor(e), 'Report', e.title, e.url),
+            // Период стоит ВПЛОТНУЮ к названию, без пустой строки, по тому же
+            // закону, что `Via` у выкатки и `Check` у проверки: строка, которая
+            // уточняет вторую строку, живёт рядом с ней, а не в блоке фактов.
+            // Владелец: «период пошёл не туда, он же должен быть рядом с датой».
+            field('Period', e.period),
             '',
-            ...body,
-            e.url ? '' : null,
-            fieldAction('Details', e.url, undefined)
+            ...numbers,
+            body.length > 0 ? '' : null,
+            ...body
         ]);
     }
     const items = bullets(e.items, false);
     return join([
-        typeLine(ICON.info, 'Report', e.period ? `${e.title} · ${e.period}` : e.title),
+        // Both analytics jobs send a link to the day's snapshot in docs/. It used to
+        // hang off a trailing `Details: open` row; now it is the report's own name.
+        typeLine(iconFor(e), 'Report', e.title, e.url),
+        // Вплотную к названию — см. соседнюю ветку.
+        field('Period', e.period),
         '',
-        ...(e.lines ?? []).map(([label, value]) => field(label, value)),
+        ...labelled(e.lines),
         items.length > 0 ? '' : null,
-        ...items,
-        // Обе аналитики шлют сюда ссылку на снимок дня в docs/. Рендер её не читал,
-        // и дневной отчёт приходил без единственного способа посмотреть подробности.
-        e.url ? '' : null,
-        fieldAction('Details', e.url, undefined)
+        ...items
     ]);
 };
+// Same law as the deploy card, one row up: what ran is named beside the type
+// line and carries the link to its run. The label is `Check` and not `Via`
+// because here the name answers WHICH gate spoke — `nightly`, `Quality` —
+// while on a deploy it answers by what means the code was shipped.
 const renderCi = (e) => {
-    const icon = e.status === 'ok' ? ICON.ok : ICON.red;
+    const icon = iconFor(e);
+    const runUrl = e.workflowUrl ?? e.url;
     return join([
         typeLine(icon, 'CI', e.status),
-        '',
-        fieldLink('Commit', e.commitUrl, e.commit),
-        titleField(e.commitTitle),
-        bodyQuote(e.commitBody),
-        field('Actor', e.actor),
-        field('Reason', e.note),
-        e.workflowUrl ?? e.url ? '' : null,
-        fieldAction('Workflow', e.workflowUrl ?? e.url, e.workflowName)
+        fieldLink('Check', runUrl, mechanism(e.workflowName, undefined, runUrl)),
+        ...twoBlocks([field('Actor', e.actor), field('Reason', e.note)], [fieldLink('Commit', e.commitUrl, e.commit), titleField(e.commitTitle), bodyQuote(e.commitBody)])
     ]);
 };
-// PR/Issue: значок теперь по статусу (четыре на пакет), не по действию —
-// `merged`/`approved` = успех, `changes_requested` = требует внимания,
-// остальное = к сведению. Слово действия само по себе уже говорит, что
-// произошло (`opened`, `ready_for_review` и т.д.), значок дублировать не должен.
-const PR_ICON = {
-    opened: ICON.info,
-    ready_for_review: ICON.info,
-    review_requested: ICON.info,
-    approved: ICON.ok,
-    changes_requested: ICON.red,
-    merged: ICON.ok,
-    closed: ICON.info
-};
-const ISSUE_ICON = {
-    opened: ICON.info,
-    assigned: ICON.info,
-    closed: ICON.ok
-};
 const renderPr = (e) => join([
-    typeLine(PR_ICON[e.action], 'PR', e.action),
+    typeLine(iconFor(e), 'PR', e.action),
     '',
     // Идентификатор первым, заголовок под ним: так вещь читается «#118, вот
     // такая», а не «вот такая, кстати #118» — и так её пишет сам GitHub.
@@ -294,7 +465,7 @@ const renderPr = (e) => join([
     field('Reviewer', e.reviewer)
 ]);
 const renderIssue = (e) => join([
-    typeLine(ISSUE_ICON[e.action], 'Issue', e.action),
+    typeLine(iconFor(e), 'Issue', e.action),
     '',
     fieldLink('Number', e.url, `#${e.number}`),
     titleField(e.title),
@@ -303,7 +474,7 @@ const renderIssue = (e) => join([
     field('Assignee', e.assignee)
 ]);
 const renderIncident = (e) => join([
-    typeLine(ICON.alarm, 'Incident', 'open'),
+    typeLine(iconFor(e), 'Incident', 'open'),
     '',
     // `detail` is a diagnosis of several lines (vault greps three of them plus a
     // log path). It used to go through `field`, which keeps only the first line,
@@ -311,18 +482,33 @@ const renderIncident = (e) => join([
     // commit now: short label, full text quoted under it.
     // Ярлык `Title`, а не `Reason`: у аварии заголовок — такой же заголовок,
     // как у коммита и задачи, и называться в одной карточке он должен так же.
-    titleField(e.title),
+    // Same rule as the report: the link rides on the incident's own title
+    // rather than on a trailing row whose only text is the word `open`.
+    fieldLink('Title', e.url, e.title),
     e.detail && e.detail !== e.title ? note(e.detail) : null,
-    e.logs || e.url ? '' : null,
-    fieldCode('Logs', e.logs),
-    fieldAction('Workflow', e.url, undefined)
+    e.logs ? '' : null,
+    fieldCode('Logs', e.logs)
 ]);
 // Раньше всё это склеивалось в одну строку `Reason:` через тире: «имя — no
 // reports — expected X, last seen Y». Каждая другая карточка кладёт факт на
 // свою строку с ярлыком, и владелец справедливо спросил, зачем тут отдельный
 // формат. Отдельного формата больше нет.
+// A session in trouble. Same law as every other card: identifier first, then
+// the facts as fields, then his own words as a quote — never as a field, which
+// keeps one line and clipped the name of the very session the card is about.
+const renderSession = (e) => join([
+    typeLine(iconFor(e), 'Session', e.action),
+    '',
+    field('Id', e.id),
+    field('Project', e.workdir),
+    field('Reason', e.reason),
+    e.opened ? '' : null,
+    quoted('Opened with', e.opened),
+    e.command ? '' : null,
+    ...fieldRun(e.command, e.commandNote)
+]);
 const renderHeartbeatMiss = (e) => {
-    const icon = e.recovered ? ICON.ok : ICON.red;
+    const icon = iconFor(e);
     const action = e.recovered ? 'ok' : 'miss';
     return join([
         typeLine(icon, 'Heartbeat', action),
@@ -333,16 +519,6 @@ const renderHeartbeatMiss = (e) => {
         field(e.recovered ? 'Last run' : 'Last seen', e.lastSeen)
     ]);
 };
-// Подпись файла — та же карточка, но лимит Telegram у caption свой: 1024.
-const renderFile = (e) => join([
-    typeLine(ICON.info, 'File', 'new'),
-    '',
-    // Раньше здесь стояло `field('Title', e.note ?? e.title)`: подпись файла
-    // приходила под ярлыком заголовка, а сам заголовок из карточки исчезал.
-    // Один ярлык — один смысл: Title это title, Reason это note.
-    field('Title', e.title),
-    field('Reason', e.note)
-]);
 const RENDERERS = {
     deploy: renderDeploy,
     job: renderJob,
@@ -351,8 +527,8 @@ const RENDERERS = {
     pr: renderPr,
     issue: renderIssue,
     incident: renderIncident,
-    heartbeat_miss: renderHeartbeatMiss,
-    file: renderFile
+    session: renderSession,
+    heartbeat_miss: renderHeartbeatMiss
 };
 // Тег наверху карточки И машинный ключ разборщика — ОДНО И ТО ЖЕ значение
 // (решение владельца 20.08.2026): раньше это были два разных представления
@@ -361,7 +537,7 @@ const RENDERERS = {
 // разрывает Telegram-хэштег на середине слова (`#mac-config` линкуется
 // только как `#mac`), а тег ДОЛЖЕН быть кликабельным — это и есть фильтр
 // «показать всю историю этого экземпляра», которым владелец пользуется вживую.
-const slug = (raw) => raw
+export const slug = (raw) => raw
     .toLowerCase()
     .replace(/[^\p{L}\p{N}]+/gu, '_')
     .replace(/^_+|_+$/g, '')
@@ -377,8 +553,8 @@ const TYPE_TAG = {
     pr: 'pr',
     issue: 'issue',
     incident: 'incident',
-    heartbeat_miss: 'heartbeat',
-    file: 'file'
+    session: 'session',
+    heartbeat_miss: 'heartbeat'
 };
 /**
  * Экземпляр-тег: что именно это конкретное событие (ветка, окружение,
@@ -400,8 +576,11 @@ export const eventKey = (e) => {
                 return slug(e.job);
             case 'report':
             case 'incident':
-            case 'file':
                 return slug(e.title);
+            // NOT the session id: an id is unique per session, so the tag would be
+            // new every time and nothing could ever be paired with anything.
+            case 'session':
+                return slug(e.action);
             case 'pr':
                 return `p${e.number}`;
             case 'issue':
@@ -410,7 +589,36 @@ export const eventKey = (e) => {
     };
     return e.key ? slug(e.key) : fallback();
 };
-const tagsLine = (e) => `#${TYPE_TAG[e.type]} #${esc(eventKey(e))}`;
+/**
+ * Третий тег — ИСХОД, и он есть всегда. Владелец: «не хватает тега fail или
+ * похожего, чтобы фейлы можно было группировать и ок можно было группировать».
+ * Одно нажатие в Telegram собирает все падения проекта разом, каким бы типом
+ * они ни пришли — выкатка, проверка, задача по расписанию, авария.
+ *
+ * Значение берётся у ЗНАЧКА, а не у слова статуса, и это не мелочь: значок уже
+ * единственный источник правды про звук, и второй список «что считать
+ * падением» разошёлся бы с первым — так уже было, когда красная карточка
+ * приходила беззвучной. Громкий значок — `#fail`, зелёный — `#ok`, всё
+ * остальное (завели задачу, открыли PR, попросили правки, отчёт) — `#news`:
+ * это новость, а не приговор робота.
+ */
+const OK_ICONS = new Set([ICON.ok, ICON.landed, ICON.approved]);
+const outcomeTag = (e) => {
+    const icon = iconFor(e);
+    if (LOUD.has(icon)) {
+        return 'fail';
+    }
+    return OK_ICONS.has(icon) ? 'ok' : 'news';
+};
+const tagsLine = (e) => `#${TYPE_TAG[e.type]} #${esc(eventKey(e))} #${outcomeTag(e)}`;
+/**
+ * Строка тегов для свободного HTML (`sendReport`). Тег — это ФИЛЬТР владельца,
+ * и к формату тела он отношения не имеет: дневной отчёт остаётся свободным
+ * текстом, но перестаёт быть единственной карточкой без тегов. Раньше ключ
+ * висел хвостом в `<i><code>#ключ</code></i>` — это старый формат, до того как
+ * теги переехали первой строкой.
+ */
+export const reportTags = (key) => `#report #${esc(slug(key))}`;
 /**
  * Рендерит событие в готовый HTML-текст, обрезанный под лимит Telegram.
  * Теги — ПЕРВАЯ строка, добавляются до обрезки (не после, как раньше): они
@@ -430,6 +638,7 @@ export const render = (e) => {
     // clampMessage может выйти за переданный limit на хвост закрывающих тегов и
     // многоточие — минус 40 оставляет ему этот запас. У сообщений свой запас уже
     // есть (4000 против 4096 у Telegram), у caption лимит 1024 настоящий.
-    const budget = Math.max(64, e.type === 'file' ? 1024 - tags.length - 40 : 4000 - tags.length - 1);
+    // Карточка с вложением — это подпись, поэтому бюджет выбирается по `path`.
+    const budget = Math.max(64, e.path ? 1024 - tags.length - 40 : 4000 - tags.length - 1);
     return `${tags}\n${clampMessage(renderer(e), budget)}`;
 };

package/dist/routes.js

@@ -34,7 +34,7 @@ export const targets = (e) => {
     // Возвращаем пустой список, а не падаем: уведомление не имеет права уронить
     // вызвавший его деплой или крон (в bash с `set -e` падение было бы фатальным).
     if (!forum) {
-        console.error(`[notify] неизвестный проект «${e.project}» — известны: ${Object.keys(ROUTES).join(', ')}`);
+        console.error(`[notify] unknown project "${e.project}" — known: ${Object.keys(ROUTES).join(', ')}`);
         return [];
     }
     return [{ chat: forum.chat, thread: forum.ops, silent: severity(e) === 'info' }];

package/dist/send.js

@@ -15,7 +15,7 @@
 import { execFileSync } from 'node:child_process';
 import { readFileSync } from 'node:fs';
 import { basename } from 'node:path';
-import { clampMessage, render } from "./render.js";
+import { clampMessage, render, reportTags } from "./render.js";
 import { ROUTES, targets } from "./routes.js";
 const log = (msg) => {
     // stderr, не stdout — stdout зарезервирован под возможный машинный вывод CLI.
@@ -279,7 +279,8 @@ export const notify = async (e) => {
         await reportLostProject(e.project, String(e.type));
         return 'skipped';
     }
-    if (e.type === 'file') {
+    // A card with a file becomes the caption of that file — one card, not two.
+    if (e.path) {
         return sendFile(e);
     }
     return deliver(targets(e), render(e));
@@ -310,7 +311,8 @@ export const sendReport = async (project, html, key) => {
     }
     const forum = ROUTES[project];
     // Без проекта — как и render.ts: карточка уже лежит в форуме своего
-    // проекта, дублировать его в теге незачем.
-    const tag = key ? `\n<i><code>#${key}</code></i>` : '';
-    return deliver([{ chat: forum.chat, thread: forum.ops, silent: true }], clampMessage(html) + tag);
+    // проекта, дублировать его в теге незачем. Строка тегов ПЕРВАЯ и до обрезки,
+    // как у любой другой карточки.
+    const tags = reportTags(key ?? 'daily');
+    return deliver([{ chat: forum.chat, thread: forum.ops, silent: true }], `${tags}\n${clampMessage(html, Math.max(64, 4000 - tags.length - 1))}`);
 };

package/dist/setup.js

@@ -23,21 +23,21 @@ const createTopic = async (token, chat, name, color) => {
         });
         const body = (await res.json());
         if (!body.ok || !body.result) {
-            log(`не удалось создать «${name}»: ${body.description ?? `HTTP ${res.status}`}`);
+            log(`could not create "${name}": ${body.description ?? `HTTP ${res.status}`}`);
             return null;
         }
         return body.result.message_thread_id;
     }
     catch (err) {
         // Сеть/таймаут/нечитаемый ответ — не роняем CLI (его контракт: всегда exit 0).
-        log(`не удалось создать «${name}»: ${err instanceof Error ? err.message : String(err)}`);
+        log(`could not create "${name}": ${err instanceof Error ? err.message : String(err)}`);
         return null;
     }
 };
 export const setupTopic = async (chatId, projectKey) => {
     const token = process.env.OPS_BOT_TOKEN?.trim();
     if (!token) {
-        log('нет OPS_BOT_TOKEN — не могу создать вкладки');
+        log('no OPS_BOT_TOKEN — cannot create the tabs');
         return;
     }
     const ops = await createTopic(token, chatId, '⚙️ Ops', 9367192);
@@ -45,16 +45,16 @@ export const setupTopic = async (chatId, projectKey) => {
     // Частичный успех: если создался только Ops — печатаем его, иначе повторный
     // запуск создал бы ДРУГУЮ тему Ops, а старый id потерялся бы.
     if (ops === null) {
-        log('Ops не создан — проверь: бот админ группы с правом «Управление темами», темы включены?');
+        log('Ops was not created — check: is the bot a group admin with "Manage topics", and are topics on?');
         return;
     }
     if (dev === null) {
-        log(`Ops создан (id=${ops}), Dev нет — добавь Dev вручную или повтори, и возьми ops=${ops}`);
-        log('добавь в src/routes.ts (dev подставь после):');
-        log(`  ${JSON.stringify(projectKey)}: { chat: '${chatId}', ops: ${ops}, dev: <вставь> },`);
+        log(`Ops created (id=${ops}), Dev was not — add Dev by hand or run again, and keep ops=${ops}`);
+        log('add to src/routes.ts (fill dev in afterwards):');
+        log(`  ${JSON.stringify(projectKey)}: { chat: '${chatId}', ops: ${ops}, dev: <fill in> },`);
         return;
     }
-    log(`вкладки созданы: Ops=${ops}, Dev=${dev}`);
-    log('добавь в src/routes.ts:');
+    log(`tabs created: Ops=${ops}, Dev=${dev}`);
+    log('add to src/routes.ts:');
     log(`  ${JSON.stringify(projectKey)}: { chat: '${chatId}', ops: ${ops}, dev: ${dev} },`);
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mikitasazan/notify",
-  "version": "1.4.1",
+  "version": "1.4.3",
   "description": "Единая типизированная отправка Telegram-уведомлений (форум-темы, маршрутизация, ретраи) для всех проектов",
   "type": "module",
   "license": "MIT",
@@ -33,7 +33,8 @@
     "build": "tsc -p tsconfig.build.json",
     "prepare": "tsc -p tsconfig.build.json",
     "typecheck": "tsc --noEmit -p tsconfig.json",
-    "test": "node --test src/*.test.ts"
+    "test": "node --test src/*.test.ts",
+    "catalogue": "npm run build && node catalogue/build.mjs && node catalogue/assemble.mjs"
   },
   "devDependencies": {
     "@types/node": "^24.13.3",