@mikitasazan/notify 1.6.1 → 1.7.0

package/dist/render.d.ts

@@ -46,6 +46,24 @@ export declare const slug: (raw: string) => string;
  * заголовок и есть единственное стабильное поле).
  */
 export declare const eventKey: (e: NotifyEvent) => string;
+/**
+ * Третий тег — ИСХОД, и он есть всегда. Владелец: «не хватает тега fail или
+ * похожего, чтобы фейлы можно было группировать и ок можно было группировать».
+ * Одно нажатие в Telegram собирает все падения проекта разом, каким бы типом
+ * они ни пришли — выкатка, проверка, задача по расписанию, авария.
+ *
+ * The value comes from the ICON, never from the status word. The icon is
+ * already the single source of truth for the sound, and a second list of "what
+ * counts as broken" would drift from the first — it already did once, when a
+ * red card arrived silent.
+ *
+ * One icon meaning, one tag. A watchdog that SWITCHED SOMETHING OFF is not a
+ * failure and must not be filed under the same word as one: the owner read
+ * `#fail` under a 🚫 and said so. Nor is a task that has simply gone quiet —
+ * nobody knows yet whether it broke, and `#unknown` is the honest word for it.
+ */
+export declare const OUTCOME_TAG: Readonly<Record<string, string>>;
+export declare const outcomeTag: (e: NotifyEvent) => string;
 /**
  * Строка тегов для свободного HTML (`sendReport`). Тег — это ФИЛЬТР владельца,
  * и к формату тела он отношения не имеет: дневной отчёт остаётся свободным

package/dist/render.js

@@ -19,7 +19,7 @@
  * строка разделяет БЛОКИ ПО СМЫСЛУ (шапка / суть / действия), не механически
  * после каждой строки.
  */
-import { ICON, LOUD, iconFor } from "./events.js";
+import { ICON, iconFor } from "./events.js";
 /** Первая буква — заглавная, остальное как есть (ga4/GitHub остаются собой). */
 /**
  * Ярлык с большой буквы — но НЕ у имени, которое пишется со строчной нарочно:
@@ -332,15 +332,22 @@ const labelled = (rows) => {
  * на зелёную. Строка заголовка стоит дешевле, чем необходимость каждый раз
  * заново искать глазами, где что.
  */
+/**
+ * A deploy or a check has two subjects: the run itself and the commit it went
+ * out with. Facts about the RUN touch the type line with no heading, because
+ * the type line already names the run — that is how every job card is built,
+ * and `Reason:` must not sit against the name on one card and under a heading
+ * on another. Facts about the COMMIT are a different subject, so they keep a
+ * heading of their own.
+ *
+ * The `Run` heading is gone for the same reason the word `open` went: it
+ * announced what line 2 had already said.
+ */
 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;
+    const runRows = live(run);
+    const changeRows = live(change);
+    return [...runRows, ...(changeRows.length > 0 ? ['', group('Change'), ...changeRows] : [])];
 };
 // Значок и его закон живут в events.ts: от него зависит и звук.
 /** Строка 2: значок вне жирного, `<b>Тип:</b> действие` — то же поле, не особый случай. */
@@ -417,17 +424,12 @@ const renderJob = (e) => {
     // were two words for one thing, and the outcome that took the first line is
     // already the icon, and now the third tag too.
     //
-    // `disabled` and `silent` keep a word of their own. A red mark reads as
-    // "it broke", and neither of those is that: one was switched off on purpose
-    // and the other has not been heard from at all.
-    const state = e.status === 'disabled'
-        ? 'switched off, not broken'
-        : e.status === 'silent'
-            ? 'no word from it at all'
-            : undefined;
+    // There is no `State:` row. It said "switched off, not broken" under a 🚫
+    // and "no word from it at all" under a ❓ — the third way of saying what the
+    // icon says and what the third tag now says too. The icon table on the
+    // catalogue page defines both marks.
     return join([
         typeLine(icon, 'Job', e.job, e.workflowUrl ?? e.url),
-        field('State', state),
         field('Reason', e.note),
         field('Expected', e.expected),
         // `Last run` when the task is alive, `Last seen` when it is not: the same
@@ -633,21 +635,28 @@ export const eventKey = (e) => {
  * Одно нажатие в Telegram собирает все падения проекта разом, каким бы типом
  * они ни пришли — выкатка, проверка, задача по расписанию, авария.
  *
- * Значение берётся у ЗНАЧКА, а не у слова статуса, и это не мелочь: значок уже
- * единственный источник правды про звук, и второй список «что считать
- * падением» разошёлся бы с первым — так уже было, когда красная карточка
- * приходила беззвучной. Громкий значок — `#fail`, зелёный — `#ok`, всё
- * остальное (завели задачу, открыли PR, попросили правки, отчёт) — `#news`:
- * это новость, а не приговор робота.
+ * The value comes from the ICON, never from the status word. The icon is
+ * already the single source of truth for the sound, and a second list of "what
+ * counts as broken" would drift from the first — it already did once, when a
+ * red card arrived silent.
+ *
+ * One icon meaning, one tag. A watchdog that SWITCHED SOMETHING OFF is not a
+ * failure and must not be filed under the same word as one: the owner read
+ * `#fail` under a 🚫 and said so. Nor is a task that has simply gone quiet —
+ * nobody knows yet whether it broke, and `#unknown` is the honest word for it.
  */
-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';
+export const OUTCOME_TAG = {
+    [ICON.red]: 'fail',
+    [ICON.alarm]: 'fail',
+    [ICON.off]: 'off',
+    [ICON.unknown]: 'unknown',
+    [ICON.ok]: 'ok',
+    [ICON.landed]: 'ok',
+    [ICON.approved]: 'ok'
 };
+// Everything left over — a task was opened, a PR opened, edits asked for, a
+// digest — is news: something happened, no verdict was passed.
+export const outcomeTag = (e) => OUTCOME_TAG[iconFor(e)] ?? '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.6.1",
+  "version": "1.7.0",
   "description": "Единая типизированная отправка Telegram-уведомлений (форум-темы, маршрутизация, ретраи) для всех проектов",
   "type": "module",
   "license": "MIT",