@mikitasazan/notify 1.4.0 → 1.4.2

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

@@ -26,13 +26,25 @@ import { render } from "./render.js";
 import { notify } from "./send.js";
 import { setupTopic } from "./setup.js";
 const log = (msg) => console.error(`[notify] ${msg}`);
+/**
+ * Anything taken from the caller and echoed into a message goes through this.
+ *
+ * `sent`, `failed` and `skipped` are a CONTRACT: `notify-fail.sh` greps
+ * `^\[notify\] sent$`, the server-side silence watchdog matches `*sent*`, and
+ * `action.yml` warns on `*failed*|*skipped*`. An input value carrying one of
+ * those words puts it on stderr — `notify sent --project=x` printed
+ * `unknown event type: sent`, and the watchdog read a card that was never
+ * delivered as delivered, then stopped repeating the alarm. Found by Codex,
+ * 25.08.2026.
+ */
+const safe = (v) => String(v ?? '').replace(/\b(sent|failed|skipped)\b/gi, (w) => `${w[0]}·${w.slice(1)}`);
 const args = process.argv.slice(2);
 const command = args[0];
 if (command === 'setup') {
     const [, chatId, projectKey] = args;
     if (!chatId || !projectKey) {
-        log('использование: notify setup <chat_id форума> <ключ-проекта>');
-        log('  сначала создай группу, включи в ней «Темы» и добавь бота админом');
+        log('usage: notify setup <forum chat_id> <project key>');
+        log('  create the group first, turn Topics on in it, add the bot as admin');
         process.exit(0);
     }
     await setupTopic(chatId, projectKey);
@@ -45,7 +57,7 @@ const BOOLEAN_FLAGS = new Set(['json', 'recovered', 'dry-run']);
 for (let i = 1; i < args.length; i++) {
     const arg = args[i];
     if (!arg.startsWith('--')) {
-        parseErrors.push(`stray argument with no flag: "${arg}"`);
+        parseErrors.push(`stray argument with no flag: "${safe(arg)}"`);
         continue;
     }
     // Форма `--key=value` обязательна для значений, начинающихся с `--`
@@ -67,7 +79,7 @@ for (let i = 1; i < args.length; i++) {
     // ТЕРЯЛОСЬ ВСЁ сообщение, а `--status` без значения рисовал 🔴 на
     // успешном деплое. Теперь это явная ошибка разбора.
     if (next === undefined || next.startsWith('--')) {
-        parseErrors.push(`flag --${key} with no value`);
+        parseErrors.push(`flag --${safe(key)} with no value`);
         continue;
     }
     i++;
@@ -76,7 +88,7 @@ for (let i = 1; i < args.length; i++) {
 const one = (key) => flags.get(key)?.[0];
 for (const key of flags.keys()) {
     if (!KNOWN_FLAGS.has(key)) {
-        parseErrors.push(`unknown flag --${key}`);
+        parseErrors.push(`unknown flag --${safe(key)}`);
     }
 }
 // Число с явной ошибкой разбора, иначе рендер рисовал «PR #NaN».
@@ -84,7 +96,7 @@ const num = (key) => {
     const raw = one(key);
     const n = Number(raw);
     if (raw === undefined || Number.isNaN(n)) {
-        parseErrors.push(`--${key}: ожидается число, получено «${raw ?? ''}»`);
+        parseErrors.push(`--${safe(key)}: expected a number, got "${safe(raw)}"`);
         return 0;
     }
     return n;
@@ -102,8 +114,10 @@ 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',
@@ -121,7 +135,7 @@ const ISSUE_ALIASES = {
 const prAction = (raw) => {
     const hit = PR_ALIASES[(raw ?? '').toLowerCase()];
     if (!hit) {
-        parseErrors.push(`--action: unknown PR action "${raw ?? ''}" (${Object.keys(PR_ALIASES).join(', ')})`);
+        parseErrors.push(`--action: unknown PR action "${safe(raw)}" (${Object.keys(PR_ALIASES).join(', ')})`);
         return 'opened';
     }
     return hit;
@@ -153,6 +167,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;
@@ -166,7 +183,7 @@ if (flags.has('json')) {
     catch (err) {
         // Тоже в parseErrors: обе аналитики зовут CLI через `|| true`, и молчащий
         // разбор JSON означал бы зелёный крон без дневного отчёта.
-        parseErrors.push(`--json from stdin did not parse: ${err instanceof Error ? err.message : String(err)}`);
+        parseErrors.push(`--json from stdin did not parse: ${safe(err instanceof Error ? err.message : err)}`);
     }
 }
 else {
@@ -192,11 +209,16 @@ else {
             event = {
                 type: 'job',
                 project: project(),
-                job: one('job') ?? '(без имени)',
+                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')
@@ -206,7 +228,7 @@ else {
             event = {
                 type: 'report',
                 project: project(),
-                title: one('title') ?? '(без заголовка)',
+                title: one('title') ?? '(no title)',
                 period: one('period'),
                 lines: pairs('line'),
                 items: items(),
@@ -236,7 +258,7 @@ else {
                 project: project(),
                 action: prAction(one('action')),
                 number: num('number'),
-                title: one('title') ?? '(без заголовка)',
+                title: one('title') ?? '(no title)',
                 body: one('body'),
                 author: one('author'),
                 reviewer: one('reviewer'),
@@ -249,18 +271,33 @@ else {
                 project: project(),
                 action: issueAction(one('action')),
                 number: num('number'),
-                title: one('title') ?? '(без заголовка)',
+                title: one('title') ?? '(no title)',
                 body: one('body'),
                 author: one('author'),
                 assignee: one('assignee'),
                 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',
                 project: project(),
-                title: one('title') ?? '(без заголовка)',
+                title: one('title') ?? '(no title)',
                 detail: one('detail'),
                 logs: one('logs'),
                 url: one('url')
@@ -270,33 +307,31 @@ else {
             event = {
                 type: 'heartbeat_miss',
                 project: project(),
-                job: one('job') ?? '(без имени)',
+                job: one('job') ?? '(no name)',
                 lastSeen: one('last-seen'),
                 expected: one('expected'),
                 recovered: flags.has('recovered'),
                 note: one('note')
             };
             break;
-        case 'file': {
-            const path = one('path');
-            if (!path) {
-                parseErrors.push('--path: обязателен для file');
-            }
+        // `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') ?? '(без заголовка)',
-                path: path ?? '',
-                filename: one('filename'),
-                note: one('note')
+                title: one('title') ?? '(no title)',
+                period: one('note'),
+                lines: []
             };
             break;
-        }
         default:
             // В parseErrors, а не просто в лог: иначе неизвестный тип уходил в
             // тишину — событие не собиралось, ошибок разбора не было, и CLI выходил
             // нулём, ничего не отправив и ничего об этом не сказав.
-            parseErrors.push(`unknown event type: ${command ?? '(none given)'}`);
+            parseErrors.push(`unknown event type: ${safe(command ?? '(none given)')}`);
     }
 }
 // --key применим к любому типу — одна точка вместо строки в каждом case
@@ -304,6 +339,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» вместо ссылки или 🔴 на успешном деплое.
@@ -343,7 +384,7 @@ if (event) {
     catch (err) {
         // Слово `failed` — контракт, тот же, что у ошибки разбора выше. Без него
         // исключение при отправке читалось сторожами как «ничего не случилось».
-        log(`failed: ${err instanceof Error ? err.message : String(err)}`);
+        log(`failed: ${safe(err instanceof Error ? err.message : err)}`);
     }
 }
 process.exit(0);

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;
 };
 /**
  * Позиция списка внутри сообщения: задача из дайджеста, упавшая проверка,
@@ -49,12 +59,12 @@ export type NotifyEvent = Keyed & (
     commit?: string;
     /** Ссылка на коммит — строка «коммит» становится кликабельной. */
     commitUrl?: string;
-    /** Заголовок коммита — рендерится рядом с телом в цитате. */
+    /** Заголовок коммита — рендерится полем `Title:`, тело идёт цитатой ниже. */
     commitTitle?: string;
     /** Тело коммита, если есть — та же цитата, что и заголовок. */
     commitBody?: string;
     workflowUrl?: string;
-    /** Название прогона для видимого текста ссылки (по умолчанию — просто "run"). */
+    /** Название прогона для видимого текста ссылки (по умолчанию — `open`). */
     workflowName?: string;
     url?: string;
     /**
@@ -78,14 +88,48 @@ export type NotifyEvent = Keyed & (
     type: 'job';
     project: Project;
     job: string;
-    /** `disabled` — задача выключена извне (например GitHub Actions кончил бесплатные минуты), не провалилась сама. */
-    status: 'ok' | 'fail' | 'disabled';
+    /**
+     * `disabled` — задача выключена извне (например GitHub Actions кончил
+     * бесплатные минуты), не провалилась сама.
+     *
+     * `silent` — задача не отчиталась в срок: она не упала, она вообще не
+     * подала признаков жизни. Это состояние ЗАДАЧИ, а не отдельный вид
+     * события — оно жило типом `heartbeat_miss`, и владелец справедливо
+     * спросил, почему задача по расписанию у него под двумя разными тегами.
+     * Хуже того: сторож молчания шлёт тот же машинный ключ, что и сама
+     * задача, так что красная карточка `#heartbeat #daily_import` не
+     * закрывалась зелёной `#job #daily_import` — разборщик ищет пару по
+     * ПОЛНОМУ тегу. Один поток на задачу это чинит.
+     */
+    status: 'ok' | 'fail' | 'disabled' | 'silent';
+    /** Как часто задача обязана отмечаться — для `silent` и для возврата из него. */
+    expected?: string;
+    /** Когда её видели в последний раз. */
+    lastSeen?: string;
     stats?: Array<[label: string, value: string | number]>;
     /** Детали: что именно упало, замечания прогона; у `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;
-    /** Название прогона для видимого текста ссылки (по умолчанию — просто "run"). */
+    /** Название прогона для видимого текста ссылки (по умолчанию — `open`). */
     workflowName?: string;
     /**
      * Запасное имя для ссылки на прогон: половина отправителей шлёт её как
@@ -139,9 +183,9 @@ export type NotifyEvent = Keyed & (
      * schedule, a manual press. Renders as `Reason:`, same as on deploy.
      */
     note?: string;
-    /** Ссылка на прогон (workflow run) — отдельно от `url`, который у CI не используется. */
+    /** Ссылка на прогон (workflow run) — отдельно от `url` — запасной для `workflowUrl`. */
     workflowUrl?: string;
-    /** Название прогона для видимого текста ссылки (по умолчанию — просто "run"). */
+    /** Название прогона для видимого текста ссылки (по умолчанию — `open`). */
     workflowName?: string;
     url?: string;
 }
@@ -153,7 +197,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 +229,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 +280,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';