@mikitasazan/notify 1.4.0 → 1.4.2

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 { 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;')
@@ -46,12 +77,27 @@ export const clampMessage = (text, limit = 4000) => {
     // Telegram отвечает на такое 400 — то есть карточка пропадала целиком, а
     // отправитель с `|| true` этого не замечал. Нашёл Codex; воспроизводится
     // отчётом с именем группы в 5000 знаков.
-    const tail = ['b', 'a', 'i', 'u', 'code', 'blockquote']
-        .filter((t) => {
-        const opened = (body.match(new RegExp(`<${t}[ >]`, 'g')) ?? []).length;
-        const closed = (body.match(new RegExp(`</${t}>`, 'g')) ?? []).length;
-        return opened > closed;
-    })
+    //
+    // Порядок закрытия — обратный порядку ОТКРЫТИЯ, а не фиксированный список.
+    // Фиксированный список закрывал `<i><u>` как `</i></u>`: тегов поровну,
+    // счётчик сходится, вложенность нарушена, и Telegram отвечает тем же 400.
+    // Второй заход того же бага (25.08.2026), поэтому теперь порядок берётся из
+    // самого текста: последний открытый закрывается первым.
+    const open = [];
+    const tagRe = /<(\/?)(b|a|i|u|code|blockquote)[ >]/g;
+    for (let m = tagRe.exec(body); m !== null; m = tagRe.exec(body)) {
+        if (m[1] === '/') {
+            const at = open.lastIndexOf(m[2]);
+            if (at !== -1) {
+                open.splice(at, 1);
+            }
+        }
+        else {
+            open.push(m[2]);
+        }
+    }
+    const tail = open
+        .reverse()
         .map((t) => `</${t}>`)
         .join('');
     return `${body}${tail}\n…`;
@@ -103,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. */
@@ -125,6 +188,14 @@ const note = (text) => {
     const body = esc(text);
     return body.length > EXPAND_AT ? `<blockquote expandable>${body}</blockquote>` : `<blockquote>${body}</blockquote>`;
 };
+/**
+ * Цитата с подписью. Голая цитата читается как продолжение поля над ней:
+ * владелец спросил про строку, которой открыта сессия, «что значит этот текст,
+ * откуда он берётся» — и был прав, в карточке это нигде не сказано. Подпись
+ * стоит отдельной строкой, потому что сам текст в поле не помещается: поле
+ * держит одну строку и обрезает.
+ */
+const quoted = (label, text) => text ? `<b>${esc(cap(label))}</b>\n${note(text)}` : null;
 const join = (parts) => parts.filter((p) => p !== null).join('\n');
 /** Плоский список позиций (без ярлыков) — job/report без групп. */
 const bullets = (items, numbered) => (items ?? []).map((it, i) => groupItem(it, i, numbered));
@@ -148,19 +219,23 @@ const renderGroup = (g) => [
  */
 const titleField = (title) => field('Title', title);
 const bodyQuote = (body) => body ? note(body) : null;
-// Значок = статус сообщения, не тип события. Ровно четыре на весь пакет —
-// закреплённая легенда в форумах обещает это владельцу как факт, не как
-// приближение. 🔴 сломалось, 🚨 инцидент, ✅ прошло, ℹ️ к сведению.
-const ICON = { red: '🔴', alarm: '🚨', ok: '✅', info: 'ℹ️' };
+// Значок и его закон живут в 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`: половина отправителей шлёт ссылку на прогон под именем
@@ -168,23 +243,45 @@ 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('Via', runUrl, mechanism(e.workflowName, e.via, runUrl)),
         '',
         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)
+        field('Reason', e.note)
     ]);
 };
 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([
@@ -195,8 +292,15 @@ 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),
+        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),
         ...(e.stats ?? []).map(([label, value]) => field(label, value)),
         hasItems ? '' : null,
         // Heading ONLY for `disabled`. It used to print for any job carrying a
@@ -204,68 +308,65 @@ const renderJob = (e) => {
         // "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 = (e.lines ?? []).map(([label, value]) => field(label, value));
         return join([
-            typeLine(ICON.info, 'Report', e.period ? `${e.title} · ${e.period}` : e.title),
+            typeLine(iconFor(e), 'Report', e.title, e.url),
             '',
-            ...body,
-            e.url ? '' : null,
-            fieldAction('Details', e.url, undefined)
+            field('Period', e.period),
+            ...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),
         '',
+        // 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)),
         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('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),
-        e.workflowUrl ?? e.url ? '' : null,
-        fieldAction('Workflow', e.workflowUrl ?? e.url, e.workflowName)
+        field('Reason', e.note)
     ]);
 };
-// 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.
@@ -279,7 +380,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),
@@ -288,7 +389,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,
@@ -296,18 +397,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),
@@ -318,16 +434,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,
@@ -336,8 +442,8 @@ const RENDERERS = {
     pr: renderPr,
     issue: renderIssue,
     incident: renderIncident,
-    heartbeat_miss: renderHeartbeatMiss,
-    file: renderFile
+    session: renderSession,
+    heartbeat_miss: renderHeartbeatMiss
 };
 // Тег наверху карточки И машинный ключ разборщика — ОДНО И ТО ЖЕ значение
 // (решение владельца 20.08.2026): раньше это были два разных представления
@@ -346,7 +452,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, '')
@@ -362,8 +468,8 @@ const TYPE_TAG = {
     pr: 'pr',
     issue: 'issue',
     incident: 'incident',
-    heartbeat_miss: 'heartbeat',
-    file: 'file'
+    session: 'session',
+    heartbeat_miss: 'heartbeat'
 };
 /**
  * Экземпляр-тег: что именно это конкретное событие (ветка, окружение,
@@ -385,8 +491,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':
@@ -396,6 +505,14 @@ export const eventKey = (e) => {
     return e.key ? slug(e.key) : fallback();
 };
 const tagsLine = (e) => `#${TYPE_TAG[e.type]} #${esc(eventKey(e))}`;
+/**
+ * Строка тегов для свободного HTML (`sendReport`). Тег — это ФИЛЬТР владельца,
+ * и к формату тела он отношения не имеет: дневной отчёт остаётся свободным
+ * текстом, но перестаёт быть единственной карточкой без тегов. Раньше ключ
+ * висел хвостом в `<i><code>#ключ</code></i>` — это старый формат, до того как
+ * теги переехали первой строкой.
+ */
+export const reportTags = (key) => `#report #${esc(slug(key))}`;
 /**
  * Рендерит событие в готовый HTML-текст, обрезанный под лимит Telegram.
  * Теги — ПЕРВАЯ строка, добавляются до обрезки (не после, как раньше): они
@@ -409,12 +526,13 @@ export const render = (e) => {
     // строка, и неизвестное значение роняло процесс через `renderer is not a
     // function`. Падать из-за уведомления нельзя.
     if (typeof renderer !== 'function') {
-        throw new Error(`неизвестный тип события: ${String(e.type)}`);
+        throw new Error(`unknown event type: ${String(e.type)}`);
     }
     const tags = tagsLine(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.
@@ -89,7 +89,7 @@ const attempt = async (token, target, text) => {
         // почему уведомления пропали, невозможно — а разбираться будет не
         // разработчик, а владелец.
         const detail = (await res.json().catch(() => null));
-        log(`HTTP ${res.status}: ${detail?.description ?? 'без описания'} — не повторяем, ошибка постоянная`);
+        log(`HTTP ${res.status}: ${detail?.description ?? 'no description'} — permanent error, not retried`);
         return { outcome: 'fail' };
     }
     catch (err) {
@@ -99,7 +99,7 @@ const attempt = async (token, target, text) => {
         // на таймауте останавливаемся и честно пишем 'failed': лишняя копия аварии
         // хуже, чем пропущенная строка в логе, а сообщение, скорее всего, ушло.
         if (err instanceof Error && err.name === 'TimeoutError') {
-            log('таймаут ответа — не повторяем: сообщение могло уже уйти');
+            log('answer timed out — not retried: the message may already be out');
             return { outcome: 'fail' };
         }
         // Сюда попадают отказы соединения (DNS, TLS, сеть недоступна) — запрос
@@ -109,7 +109,7 @@ const attempt = async (token, target, text) => {
         // отсутствие дублей невозможно без idempotency-key у Bot API (его нет).
         // Логика прежняя: дубль на редком reset — меньшее зло, чем потеря
         // сообщения на частом сетевом сбое.
-        log('fetch не прошёл, пробуем curl…');
+        log('fetch did not go through, trying curl…');
         const curl = sendViaCurl(token, target, text);
         return curl === 'retry' ? { outcome: 'retry', waitMs: 1000 } : { outcome: curl };
     }
@@ -130,14 +130,14 @@ const sendOne = async (token, target, text) => {
         }
         waitMs = result.waitMs;
     }
-    log('исчерпаны попытки отправки');
+    log('out of send attempts');
     return 'failed';
 };
 /** Общий хвост для `notify` и `sendReport`: токен, цели, последовательная отправка. */
 const deliver = async (where, text) => {
     const token = process.env.OPS_BOT_TOKEN?.trim();
     if (!token) {
-        log('нет OPS_BOT_TOKEN — сообщение не отправлено');
+        log('skipped: no OPS_BOT_TOKEN, the message was not sent');
         return 'skipped';
     }
     // Токен interpolируется в URL и в curl-конфиг (`url = "...bot${token}..."`).
@@ -145,7 +145,7 @@ const deliver = async (where, text) => {
     // строки/`?` сломало бы разбор (инъекция директивы curl или query-хвост).
     // Это требует покорёженного секрета, но проверка копеечная.
     if (!/^\d+:[A-Za-z0-9_-]+$/.test(token)) {
-        log('OPS_BOT_TOKEN не похож на токен Telegram — отправка отменена');
+        log('failed: OPS_BOT_TOKEN does not look like a Telegram token, send cancelled');
         return 'skipped';
     }
     if (where.length === 0) {
@@ -196,27 +196,27 @@ const sendFileOnce = async (token, target, e, caption) => {
             return { outcome: 'retry', waitMs: 1000 };
         }
         const detail = (await res.json().catch(() => null));
-        log(`HTTP ${res.status}: ${detail?.description ?? 'без описания'} — не повторяем, ошибка постоянная`);
+        log(`HTTP ${res.status}: ${detail?.description ?? 'no description'} — permanent error, not retried`);
         return { outcome: 'fail' };
     }
     catch (err) {
         if (err instanceof Error && err.name === 'TimeoutError') {
-            log('таймаут ответа — не повторяем: файл мог уже уйти');
+            log('answer timed out — not retried: the file may already be out');
             return { outcome: 'fail' };
         }
         // Файл не читается (нет на диске, нет прав) — постоянная ошибка.
         if (err instanceof Error && 'code' in err) {
-            log(`файл не отправлен: ${err.message}`);
+            log(`failed to send the file: ${err.message}`);
             return { outcome: 'fail' };
         }
-        log(`сеть не пустила файл: ${err instanceof Error ? err.message : String(err)}`);
+        log(`the network refused the file: ${err instanceof Error ? err.message : String(err)}`);
         return { outcome: 'retry', waitMs: 1000 };
     }
 };
 const sendFile = async (e) => {
     const token = process.env.OPS_BOT_TOKEN?.trim();
     if (!token || !/^\d+:[A-Za-z0-9_-]+$/.test(token)) {
-        log('нет валидного OPS_BOT_TOKEN — файл не отправлен');
+        log('skipped: no valid OPS_BOT_TOKEN, the file was not sent');
         return 'skipped';
     }
     const where = targets(e);
@@ -261,13 +261,13 @@ const sendFile = async (e) => {
 const reportLostProject = async (project, kind) => {
     // Локальный лог называет и допустимые написания — это единственная
     // диагностика, доступная на машине, где случилась опечатка.
-    log(`неизвестный проект «${String(project)}» — известны: ${Object.keys(ROUTES).join(', ')}`);
+    log(`unknown project "${String(project)}" — known: ${Object.keys(ROUTES).join(', ')}`);
     const lost = {
         type: 'job',
         project: 'mac-config',
-        job: 'notify: событие потеряно',
+        job: 'notify: an event was lost',
         status: 'fail',
-        note: `проект «${String(project)}» не в ROUTES — событие «${kind}» никуда не доставлено`,
+        note: `project "${String(project)}" is not in ROUTES — event "${kind}" went nowhere`,
         key: 'notify-unknown-project'
     };
     await deliver(targets(lost), render(lost)).catch(() => undefined);
@@ -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))}`);
 };