@mikitasazan/notify 1.7.0 → 1.8.0

package/dist/cli-flags.js

@@ -14,7 +14,7 @@ export const KNOWN_FLAGS = new Set([
     'command', 'command-note', 'commit-body', 'commit-title', 'commit-url', 'detail',
     'expected', 'filename', 'item',
     'item-group', 'job', 'key', 'last-seen', 'line', 'logs', 'note',
-    'number', 'path', 'period', 'project', 'reviewer', 'stat', 'status',
+    'aside', 'number', 'path', 'period', 'project', 'reviewer', 'stat', 'status',
     'target', 'title', 'url', 'via', 'workflow-name', 'workflow-url',
     // Флаги без значения. Живут здесь же, чтобы разбор и список не разошлись.
     'json', 'recovered', 'dry-run'

package/dist/cli.js

@@ -236,6 +236,7 @@ else {
                 project: project(),
                 job: one('job') ?? '(no name)',
                 status: jobStatus(),
+                aside: one('aside'),
                 expected: one('expected'),
                 lastSeen: one('last-seen'),
                 stats: pairs('stat'),
@@ -254,7 +255,9 @@ else {
                 type: 'report',
                 project: project(),
                 title: one('title') ?? '(no title)',
-                period: one('period'),
+                // `--period` is the old spelling of `--aside`; both fill the same
+                // slot, and two senders still use the old one.
+                aside: one('aside') ?? one('period'),
                 lines: pairs('line'),
                 items: items(),
                 url: one('url')

package/dist/events.d.ts

@@ -111,6 +111,14 @@ export type NotifyEvent = Keyed & (
      * ПОЛНОМУ тегу. Один поток на задачу это чинит.
      */
     status: 'ok' | 'fail' | 'disabled' | 'silent';
+    /**
+     * The one qualifier the name needs to be readable on its own, printed in
+     * brackets right after it: `Yandex game import (reporting again)`. It is
+     * the same slot a report uses for the day it covers. Anything that is a
+     * FACT about the job goes in a row of its own; this is for the word that
+     * finishes the name.
+     */
+    aside?: string;
     /** Как часто задача обязана отмечаться — для `silent` и для возврата из него. */
     expected?: string;
     /** Когда её видели в последний раз. */
@@ -162,7 +170,13 @@ export type NotifyEvent = Keyed & (
     type: 'report';
     project: Project;
     title: string;
-    period?: string;
+    /**
+     * Printed in brackets after the title — which day the report covers, or
+     * which day its arrows are measured against. Same slot, same name, as a
+     * job's. `period` is the old spelling of this field and the CLI still
+     * accepts `--period` for it.
+     */
+    aside?: string;
     /** Пусто/не передано, когда используются `groups` — два вида отчёта не смешиваются в одном событии. */
     lines?: Array<[label: string, value: string | number, group?: string]>;
     /**

package/dist/render.js

@@ -414,6 +414,10 @@ const renderDeploy = (e) => {
         ...twoBlocks([field('Target', e.target), field('Reason', e.note)], [fieldLink('Commit', e.commitUrl, e.commit), titleField(e.commitTitle), bodyQuote(e.commitBody)])
     ]);
 };
+const schedule = (expected, lastSeen, lastLabel) => {
+    const rows = [field('Expected', expected), field(lastLabel, lastSeen)].filter((r) => r !== null);
+    return rows.length > 0 ? ['', group('Schedule'), ...rows] : [];
+};
 const renderJob = (e) => {
     const icon = iconFor(e);
     const hasItems = (e.items ?? []).length > 0;
@@ -429,12 +433,13 @@ const renderJob = (e) => {
     // 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),
+        typeLine(icon, 'Job', e.job, e.workflowUrl ?? e.url, e.aside),
         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),
+        // The timetable is a different subject from this event: how often the task
+        // owes a sign of life and when it last gave one. It stood in a bare run
+        // under `Reason:` and read as more of the same. `Last run` when the task
+        // is alive, `Last seen` when it is not — one timestamp, two questions.
+        ...schedule(e.expected, e.lastSeen, e.status === 'silent' ? 'Last seen' : 'Last run'),
         ...labelled(e.stats),
         hasItems ? '' : null,
         // Heading ONLY for `disabled`. It used to print for any job carrying a
@@ -459,7 +464,7 @@ const renderReport = (e) => {
         // without a word.
         const numbers = labelled(e.lines);
         return join([
-            typeLine(iconFor(e), 'Report', e.title, e.url, e.period),
+            typeLine(iconFor(e), 'Report', e.title, e.url, e.aside),
             // Rows with no group of their own sit flush against the header instead of
             // forming a separate slab under a blank line. `labelled` puts the blank
             // line before the first group itself, so there is none here.
@@ -472,7 +477,7 @@ const renderReport = (e) => {
     return join([
         // 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, e.period),
+        typeLine(iconFor(e), 'Report', e.title, e.url, e.aside),
         // Flush against the header — see the branch above.
         ...labelled(e.lines),
         items.length > 0 ? '' : null,
@@ -555,8 +560,7 @@ const renderHeartbeatMiss = (e) => {
         // copy of that watchdog can, and the card it gets must obey the template.
         typeLine(icon, 'Heartbeat', e.job, undefined, action),
         field('Reason', e.note),
-        field('Expected', e.expected),
-        field(e.recovered ? 'Last run' : 'Last seen', e.lastSeen)
+        ...schedule(e.expected, e.lastSeen, e.recovered ? 'Last run' : 'Last seen')
     ]);
 };
 const RENDERERS = {

package/package.json

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