@mikitasazan/notify 1.4.3 → 1.4.5

package/dist/cli-flags.js

@@ -12,7 +12,8 @@ export const KNOWN_FLAGS = new Set([
     'action', 'actor', 'assignee', 'author', 'body', 'branch', 'commit',
     'id', 'opened', 'reason', 'workdir',
     'command', 'command-note', 'commit-body', 'commit-title', 'commit-url', 'detail',
-    'expected', 'filename', 'item', 'job', 'key', 'last-seen', 'line', 'logs', 'note',
+    'expected', 'filename', 'item',
+    'item-group', '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

@@ -101,11 +101,22 @@ const num = (key) => {
     }
     return n;
 };
-// --item "текст" или --item "текст|https://ссылка"
-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) };
-});
+/**
+ * `--item "текст"` или `--item "текст|https://ссылка"`.
+ *
+ * Имя группы у позиции нельзя передать так же, как у `--stat`: черта здесь
+ * уже занята ссылкой. Поэтому `--item-group "Red checks"` — одно имя на все
+ * позиции этого вызова. Списки у отправителей однородные (красные проверки,
+ * выключенные процессы), а разнородный список — это `--json`.
+ */
+const items = () => {
+    const name = flags.get('item-group')?.[0];
+    return (flags.get('item') ?? []).map((raw) => {
+        const idx = raw.lastIndexOf('|');
+        const base = idx === -1 ? { text: raw } : { text: raw.slice(0, idx), url: raw.slice(idx + 1) };
+        return name ? { ...base, group: name } : base;
+    });
+};
 /**
  * `--stat "label=value"`, и с 25.08.2026 — `--stat "Group | label=value"`:
  * имя группы, вертикальная черта, ярлык. Черта выбрана потому, что её нет ни

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 & (
 /** Выкатка кода на сервер. */

package/dist/render.js

@@ -164,7 +164,11 @@ const fieldCode = (label, value) => value ? `<b>${esc(cap(label))}:</b> <code>${
  */
 const fieldRun = (value, why) => {
     const explain = field('To do', why);
-    return value && explain !== null ? [explain, `▶ <code>${esc(value)}</code>`] : [];
+    // Без значка. `▶` был единственным символом такого рода на все двадцать
+    // видов карточек, и владелец справедливо спросил, что он значит: ничего,
+    // чего не сказала бы строка `To do:` над ним и моноширинный шрифт под ним —
+    // Telegram делает такую строку копируемой по нажатию сам.
+    return value && explain !== null ? [explain, `<code>${esc(value)}</code>`] : [];
 };
 /** Заголовок группы: курсив + подчёркивание, без жирности, без двоеточия. */
 const group = (name) => `<i><u>${esc(cap(name))}</u></i>`;
@@ -219,7 +223,27 @@ const join = (parts) => {
     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),
@@ -371,18 +395,23 @@ const renderJob = (e) => {
     const icon = iconFor(e);
     const hasItems = (e.items ?? []).length > 0;
     const disabledList = hasItems && e.status === 'disabled';
+    // The NAME goes on the type line, the way `Report:` and `Issue:` carry
+    // theirs. It used to sit a line below under a second label, `Task:`, and
+    // the owner asked what a task is doing on a card headed Job — nothing: they
+    // 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;
     return join([
-        typeLine(icon, 'Job', e.status),
-        '',
-        // The name is NOT the type line: line 2 is `Job: fail` by the format's own
-        // rule, so the name is its own field. Called `Task:` and not `Job:` because
-        // 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.
-        // 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),
+        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
@@ -418,7 +447,11 @@ const renderReport = (e) => {
             // уточняет вторую строку, живёт рядом с ней, а не в блоке фактов.
             // Владелец: «период пошёл не туда, он же должен быть рядом с датой».
             field('Period', e.period),
-            '',
+            // Строки БЕЗ группы идут вплотную к шапке, а не отдельным куском под
+            // пустой строкой: это факты про сам отчёт — период, номер, — а не про
+            // то, о чём он. Владелец: «number отдельно и период отдельно, непонятно,
+            // куда их относить». `labelled` сам ставит пустую строку перед первой
+            // группой, поэтому её здесь больше нет.
             ...numbers,
             body.length > 0 ? '' : null,
             ...body
@@ -431,7 +464,7 @@ const renderReport = (e) => {
         typeLine(iconFor(e), 'Report', e.title, e.url),
         // Вплотную к названию — см. соседнюю ветку.
         field('Period', e.period),
-        '',
+        // Вплотную к шапке — см. соседнюю ветку.
         ...labelled(e.lines),
         items.length > 0 ? '' : null,
         ...items

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mikitasazan/notify",
-  "version": "1.4.3",
+  "version": "1.4.5",
   "description": "Единая типизированная отправка Telegram-уведомлений (форум-темы, маршрутизация, ретраи) для всех проектов",
   "type": "module",
   "license": "MIT",