@mikitasazan/notify 1.4.2 → 1.4.4

package/dist/cli.js

@@ -106,9 +106,23 @@ 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 = {

package/dist/events.d.ts

@@ -45,10 +45,19 @@ type Keyed = {
  * рендерится как обычная нумерованная/маркированная строка — так уже
  * работают дайджест-задачи и список выключенных workflow.
  */
+/**
+ * `group` — имя блока, под которым позиция встанет. Тот же закон, что у
+ * `lines` и `stats`: без имени позиция идёт в общий список, как раньше.
+ *
+ * Заведено потому, что список импорта смешивал три РАЗНЫЕ вещи в одном
+ * перечне и различал их значком в начале строки: 🆕 вышло сегодня,
+ * 🔁 вышло из очереди, ⚠ не вышло совсем. Значок делал работу заголовка.
+ */
 export type Item = {
     text: string;
     url?: string;
     label?: string;
+    group?: string;
 };
 export type NotifyEvent = Keyed & (
 /** Выкатка кода на сервер. */
@@ -106,7 +115,17 @@ export type NotifyEvent = Keyed & (
     expected?: string;
     /** Когда её видели в последний раз. */
     lastSeen?: string;
-    stats?: Array<[label: string, value: string | number]>;
+    /**
+     * Цифры от отправителя. Третий элемент — ИМЯ ГРУППЫ, под которой строка
+     * встанет. Владелец шесть раз просил группы, и каждый раз отправитель
+     * уже пытался их изобразить подручным: скобками в ярлыке
+     * («GA4 users (sum of days)»), значком в начале строки (🆕 против ⚠),
+     * лишней строкой внизу. Группировать было нечем — теперь есть.
+     *
+     * Без третьего элемента строка идёт без заголовка, как раньше: все
+     * существующие отправители продолжают работать не меняясь.
+     */
+    stats?: Array<[label: string, value: string | number, group?: string]>;
     /** Детали: что именно упало, замечания прогона; у `disabled` — список выключенных процессов (каждый со своей ссылкой). */
     items?: Item[];
     note?: string;
@@ -145,7 +164,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]>;
     /**
      * Список позиций со ссылками — для дайджестов задач, где ценность в
      * самих названиях, а не в цифре. Рендерятся отдельным блоком после

package/dist/render.js

@@ -19,7 +19,7 @@
  * строка разделяет БЛОКИ ПО СМЫСЛУ (шапка / суть / действия), не механически
  * после каждой строки.
  */
-import { iconFor } from "./events.js";
+import { ICON, LOUD, iconFor } from "./events.js";
 /** Первая буква — заглавная, остальное как есть (ga4/GitHub остаются собой). */
 /**
  * Ярлык с большой буквы — но НЕ у имени, которое пишется со строчной нарочно:
@@ -196,9 +196,50 @@ const note = (text) => {
  * держит одну строку и обрезает.
  */
 const quoted = (label, text) => text ? `<b>${esc(cap(label))}</b>\n${note(text)}` : null;
-const join = (parts) => parts.filter((p) => p !== null).join('\n');
+/**
+ * Склейка карточки. Пустая строка здесь — знак смены блока, а не отступ:
+ * две подряд означают пустой блок, ведущая — блок, которого нет. Обе
+ * появляются, когда часть полей не пришла, и обе схлопываются тут, а не
+ * в каждом рендерере по отдельности.
+ */
+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));
+/**
+ * Позиции списка. Именованная группа ВСЕГДА печатает свой заголовок — тот же
+ * закон, что у `labelled`: карточка одного типа не должна выглядеть по-разному
+ * в разные дни. Нумерация идёт внутри блока, а не сквозная: «1, 2» под своим
+ * заголовком читается, сквозная «3, 4» под вторым — нет.
+ */
+const bullets = (items, numbered) => {
+    const list = items ?? [];
+    const names = [...new Set(list.map((it) => it.group).filter((g) => !!g))];
+    if (names.length === 0) {
+        return list.map((it, i) => groupItem(it, i, numbered));
+    }
+    const out = [];
+    list.filter((it) => !it.group).forEach((it, i) => out.push(groupItem(it, i, numbered)));
+    for (const name of names) {
+        out.push('');
+        out.push(group(name));
+        list.filter((it) => it.group === name).forEach((it, i) => out.push(groupItem(it, i, numbered)));
+    }
+    return out;
+};
 /** Именованная группа целиком: заголовок + позиции, разделены строкой пустоты внутри вызова через join. */
 const renderGroup = (g) => [
     group(g.name),
@@ -219,6 +260,77 @@ const renderGroup = (g) => [
  */
 const titleField = (title) => field('Title', title);
 const bodyQuote = (body) => body ? note(body) : null;
+/**
+ * Строки с ярлыками, разложенные по группам, которые назвал сам отправитель.
+ *
+ * Закон простой и считается программой: назвал группу — заголовок печатается.
+ * Всегда, сколько бы строк в ней ни было и сколько бы групп ни оказалось.
+ * Порог «две и больше» я пробовал и снял: у карточки резервных копий все
+ * цифры лежат в одной группе, а над ними — рассказ о прогоне, и порог гасил
+ * ровно тот шов, ради которого владелец всё это и просил.
+ *
+ * Так же уходит и риск «одна и та же карточка выглядит по-разному в разные
+ * дни»: вид зависит от того, что отправитель НАЗВАЛ в коде, а не от того,
+ * сколько строк набралось сегодня.
+ *
+ * Порядок групп — порядок первого появления у отправителя: он знает, что
+ * важнее. Строки без имени идут первыми и без заголовка — это факты о самой
+ * карточке, а не о каком-то из её предметов.
+ */
+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`, и из прямых вызовов на
@@ -272,12 +384,7 @@ const renderDeploy = (e) => {
     return join([
         typeLine(icon, 'Deploy', e.status),
         fieldLink('Via', runUrl, mechanism(e.workflowName, e.via, runUrl)),
-        '',
-        fieldLink('Commit', e.commitUrl, e.commit),
-        titleField(e.commitTitle),
-        bodyQuote(e.commitBody),
-        field('Target', e.target),
-        field('Reason', e.note)
+        ...twoBlocks([field('Target', e.target), field('Reason', e.note)], [fieldLink('Commit', e.commitUrl, e.commit), titleField(e.commitTitle), bodyQuote(e.commitBody)])
     ]);
 };
 const renderJob = (e) => {
@@ -301,7 +408,7 @@ const renderJob = (e) => {
         // `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),
-        ...(e.stats ?? []).map(([label, value]) => field(label, value)),
+        ...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
@@ -323,11 +430,15 @@ const renderReport = (e) => {
         // `lines` и `groups` вместе, а не «или»: раньше ветка с группами печатала
         // ТОЛЬКО группы, и цифры отчёта молча исчезали. Поймано 25.08.2026 при
         // переводе утреннего отчёта PlayHub на типизированное событие.
-        const numbers = (e.lines ?? []).map(([label, value]) => field(label, value));
+        const numbers = labelled(e.lines);
         return join([
             typeLine(iconFor(e), 'Report', e.title, e.url),
-            '',
+            // Период стоит ВПЛОТНУЮ к названию, без пустой строки, по тому же
+            // закону, что `Via` у выкатки и `Check` у проверки: строка, которая
+            // уточняет вторую строку, живёт рядом с ней, а не в блоке фактов.
+            // Владелец: «период пошёл не туда, он же должен быть рядом с датой».
             field('Period', e.period),
+            '',
             ...numbers,
             body.length > 0 ? '' : null,
             ...body
@@ -338,11 +449,10 @@ const renderReport = (e) => {
         // 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),
-        '',
-        // The period used to ride on the type line after a middot, which made the
-        // clickable name longer than the name and put two facts on one line.
+        // Вплотную к названию — см. соседнюю ветку.
         field('Period', e.period),
-        ...(e.lines ?? []).map(([label, value]) => field(label, value)),
+        '',
+        ...labelled(e.lines),
         items.length > 0 ? '' : null,
         ...items
     ]);
@@ -357,12 +467,7 @@ const renderCi = (e) => {
     return join([
         typeLine(icon, 'CI', e.status),
         fieldLink('Check', runUrl, mechanism(e.workflowName, undefined, runUrl)),
-        '',
-        fieldLink('Commit', e.commitUrl, e.commit),
-        titleField(e.commitTitle),
-        bodyQuote(e.commitBody),
-        field('Actor', e.actor),
-        field('Reason', e.note)
+        ...twoBlocks([field('Actor', e.actor), field('Reason', e.note)], [fieldLink('Commit', e.commitUrl, e.commit), titleField(e.commitTitle), bodyQuote(e.commitBody)])
     ]);
 };
 const renderPr = (e) => join([
@@ -504,7 +609,28 @@ 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`). Тег — это ФИЛЬТР владельца,
  * и к формату тела он отношения не имеет: дневной отчёт остаётся свободным

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mikitasazan/notify",
-  "version": "1.4.2",
+  "version": "1.4.4",
   "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",