@astrofoundry/pi-astro 0.40.7 → 0.40.9

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -1,6 +1,5 @@
1
1
  import { describe, expect, it } from "vitest";
2
2
  import type { ArcaneReport } from "./daily-report.ts";
3
- import { headlineOf } from "./security-monitor.ts";
4
3
  import type { ToolsReport } from "./tools-report.ts";
5
4
  import { agoSeconds, arcaneSummary, backupStatus, dnsStatus, edgeStatus, identityStatus, inferenceStatus, mediaStatus, networkStatus, problemText, proxmoxStatus, summaryText, toolsSummary } from "./daily-run.ts";
6
5
 
@@ -160,8 +159,4 @@ describe("report summaries", () => {
160
159
  messageId: "8",
161
160
  });
162
161
  });
163
-
164
- it("takes the security report's headline without its name", () => {
165
- expect(headlineOf("**Security Daily Report:** quiet day (24 h to 05:00 CET)\nCrowdSec · 19 bans")).toBe("quiet day (24 h to 05:00 CET)");
166
- });
167
162
  });
@@ -13,6 +13,11 @@ export interface MessageComponent {
13
13
  label?: string;
14
14
  custom_id?: string;
15
15
  disabled?: boolean;
16
+ /** A Container's accent bar, RGB. */
17
+ accent_color?: number;
18
+ /** A Separator's visible line and its spacing (1 small, 2 large). */
19
+ divider?: boolean;
20
+ spacing?: number;
16
21
  }
17
22
 
18
23
  /** A message body for interaction webhooks: plain `content`, or `components` with the IS_COMPONENTS_V2 flag. */
@@ -297,15 +297,17 @@ describe("security monitor", () => {
297
297
  );
298
298
  h.answers.set("arcane images vulnerabilities summary", () => JSON.stringify({ totalImages: 57, scannedImages: 57, summary: { critical: 1 } }));
299
299
  h.answers.set("arcane images vulnerabilities list", () => JSON.stringify({ data: [{ vulnerabilityId: "CVE-7", pkgName: "zlib", fixedVersion: "1.3.1", ignored: false, imageName: "nginx:latest" }] }));
300
- await h.monitor.dailyReport(SCHEDULE, "2026-10-21");
301
- const text = h.rest.messages[0].message.content;
302
- expect(text).toContain("Arcane images · 1 critical CVE whose package has a fix, in 1 image · waiting on the publisher: nginx 1");
300
+ const summary = await h.monitor.dailyReport(SCHEDULE, "2026-10-21");
301
+ expect(h.rest.messages).toEqual([]);
302
+ const text = JSON.stringify(h.rest.components[0].components);
303
+ expect(text).toContain("🐳 **Arcane images** · 1 critical CVE whose package has a fix, in 1 image\\n- waiting on the publisher: nginx 1");
303
304
  expect(h.calls).toContainEqual(["arcane", "images", "list", "--all"]);
304
305
  expect(h.calls).toContainEqual(["arcane", "images", "vulnerabilities", "list", "--severity", "critical", "--all"]);
305
- expect(text.split("\n")[0]).toBe("**Security Daily Report:** quiet day (24 h to 06:05 CEST)");
306
- expect(text).toContain("CrowdSec · 2 bans, all front door SNI scanning");
307
- expect(text).toContain("Vulnerabilities · 1 new CVE on 1 host: CVE-1 (openssl, High 7.5) on dmz · fixed versions exist");
308
- expect(h.rest.messages[0].message.mentionUsers).toBeUndefined();
306
+ expect(summary).toEqual({ headline: "quiet day (24 h to 06:05 CEST)", tagged: false, messageId: "100" });
307
+ expect(text).toContain("## 🛡️ Security Daily Report\\n🟢 quiet day · 24 h to 06:05 CEST");
308
+ expect(text).toContain("🚫 **CrowdSec** · 2 bans, all front door SNI scanning");
309
+ expect(text).toContain("📦 **Host packages** · 1 new CVE on 1 host, fixed versions exist\\n- CVE-1 (openssl, High 7.5) on dmz");
310
+ expect(h.rest.components[0].mentionUsers).toBeUndefined();
309
311
  expect(readReportState("security")).toMatchObject({ date: "2026-10-21", status: "sent" });
310
312
  expect(readSecurityState().vulns.reported["dmz|CVE-1"]).toMatchObject({ fix: true });
311
313
  expect(h.calls.find((c) => c[1] === "wazuh-vuln-events")).toEqual(["security", "wazuh-vuln-events", "2"]);
@@ -1,4 +1,3 @@
1
- import { chunkMessage } from "./chunk.ts";
2
1
  import { readPostedArcane } from "./daily-report.ts";
3
2
  import { type DiscordConfig, isOwner, type ReportSchedule, reportSchedule } from "./config.ts";
4
3
  import { KeyedQueue } from "./media.ts";
@@ -17,8 +16,7 @@ import {
17
16
  classify,
18
17
  clockText,
19
18
  crlFromEvents,
20
- dailyNeedsOwner,
21
- dailyText,
19
+ dailyCard,
22
20
  healthChange,
23
21
  type ImageOffer,
24
22
  imageOffers,
@@ -39,6 +37,7 @@ import {
39
37
  parseSecurityButton,
40
38
  type PatchingFacts,
41
39
  type PostedAlert,
40
+ type ReportCard,
42
41
  pruneState,
43
42
  readSecurityState,
44
43
  repeatText,
@@ -50,7 +49,7 @@ import {
50
49
  type WazuhEvent,
51
50
  wazuhDigest,
52
51
  weekRange,
53
- weeklyText,
52
+ weeklyCard,
54
53
  writeSecurityState,
55
54
  } from "./security.ts";
56
55
 
@@ -98,11 +97,6 @@ export interface PostedSummary {
98
97
  messageId: string;
99
98
  }
100
99
 
101
- /** The report's first line without its bold name: `quiet day (24 h to 05:00 CET)`. */
102
- export function headlineOf(text: string): string {
103
- return text.split("\n")[0].replace(/^\*\*[^*]+\*\*\s*/, "");
104
- }
105
-
106
100
  const MINUTE = 60_000;
107
101
  const DAY = 86_400_000;
108
102
  export const POLL_MS = 2 * MINUTE;
@@ -461,14 +455,8 @@ export class SecurityMonitor {
461
455
  return { images, offers: imageOffers(readPostedArcane()?.stacks ?? []), ...(arcaneChannelId ? { arcaneChannelId } : {}) };
462
456
  }
463
457
 
464
- private async postReport(channelId: string, text: string, mention: boolean): Promise<string> {
465
- const owners = this.owners();
466
- let first = "";
467
- for (const chunk of chunkMessage(text)) {
468
- const posted = await this.deps.rest.createMessage(channelId, { content: chunk, ...(mention ? { mentionUsers: owners } : {}) });
469
- first ||= posted.id;
470
- }
471
- return first;
458
+ private async postReport(channelId: string, report: ReportCard): Promise<string> {
459
+ return (await this.deps.rest.createComponentsMessage(channelId, report.components, report.mention ? this.owners() : undefined)).id;
472
460
  }
473
461
 
474
462
  /** Posts the Security Daily Report; returns its headline and whether it tagged the owners, for the morning summary. */
@@ -491,11 +479,11 @@ export class SecurityMonitor {
491
479
  if (this.deps.stopping()) return;
492
480
  const data = { until: clockText(new Date(now).toISOString(), s.timeZone).replace(/^\d+ \w+ /, ""), crowdsec, wazuh, found: vulns?.found ?? null, closed: vulns?.closed ?? null, attention, ...images };
493
481
  writeReportState("security", { date, status: "sending" });
494
- const text = dailyText(data, this.owners());
495
- const id = await this.postReport(s.channelId, text, dailyNeedsOwner(data));
482
+ const report = dailyCard(data, this.owners());
483
+ const id = await this.postReport(s.channelId, report);
496
484
  writeReportState("security", { date, status: "sent", messageId: id });
497
485
  this.deps.log(`security report ${date}: posted`);
498
- return { headline: headlineOf(text), tagged: dailyNeedsOwner(data), messageId: id };
486
+ return { headline: report.headline, tagged: report.mention, messageId: id };
499
487
  }
500
488
 
501
489
  async weeklyReport(s: ReportSchedule, date: string): Promise<PostedSummary | undefined> {
@@ -538,6 +526,7 @@ export class SecurityMonitor {
538
526
  crl: events ? crlFromEvents(events, now) : ("unknown" as const),
539
527
  backups: archives ? { guests: archives, restic: resticText === null ? null : resticStatus(resticText) } : null,
540
528
  ...images,
529
+ alerts: state.alerts,
541
530
  last24h: {
542
531
  bans: lastDay?.count ?? null,
543
532
  wazuh: lastDayEvents?.length ?? null,
@@ -548,12 +537,12 @@ export class SecurityMonitor {
548
537
  },
549
538
  };
550
539
  if (this.deps.stopping()) return;
551
- const report = weeklyText(data, this.owners());
540
+ const report = weeklyCard(data, this.owners());
552
541
  writeReportState("security-weekly", { date, status: "sending" });
553
- const id = await this.postReport(s.channelId, report.text, report.mention);
542
+ const id = await this.postReport(s.channelId, report);
554
543
  writeReportState("security-weekly", { date, status: "sent", messageId: id });
555
544
  this.deps.log(`security weekly report ${date}: posted`);
556
- return { headline: headlineOf(report.text), tagged: report.mention, messageId: id };
545
+ return { headline: report.headline, tagged: report.mention, messageId: id };
557
546
  }
558
547
 
559
548
  // ------------------------------------------------------------ buttons
@@ -1,5 +1,6 @@
1
1
  import { describe, expect, it } from "vitest";
2
2
  import { validateConfig } from "./config.ts";
3
+ import type { MessageComponent } from "./rest.ts";
3
4
  import { isDue, MONDAY, zonedWeekday } from "./reports.ts";
4
5
  import {
5
6
  ACK_ID,
@@ -15,8 +16,8 @@ import {
15
16
  crlFromEvents,
16
17
  crowdsecDailyLine,
17
18
  crowdsecWeeklyLine,
19
+ dailyCard,
18
20
  dailyNeedsOwner,
19
- dailyText,
20
21
  emptyState,
21
22
  healthChange,
22
23
  healthLine,
@@ -42,16 +43,18 @@ import {
42
43
  offeredImages,
43
44
  parseImageVulns,
44
45
  nasOutage,
46
+ needsYou,
45
47
  noteNas,
46
48
  repeatText,
47
49
  resticStatus,
50
+ section,
48
51
  type VulnEvent,
49
52
  vulnLine,
50
53
  vulnWindow,
51
54
  type WazuhEvent,
52
55
  wazuhDigest,
53
56
  weekChange,
54
- weeklyText,
57
+ weeklyCard,
55
58
  weekRange,
56
59
  } from "./security.ts";
57
60
 
@@ -64,6 +67,11 @@ function event(over: Partial<WazuhEvent> = {}): WazuhEvent {
64
67
 
65
68
  const deploy = event({ id: "d1", rule: "100020", level: 10, description: "Deployment file changed: /opt/docker/grimoire/compose.yaml. Check against the approved GitOps change.", path: "/opt/docker/grimoire/compose.yaml", event: "modified", sha256: "a".repeat(64) });
66
69
 
70
+ /** Every Text Display of a card, in order. */
71
+ function texts(components: readonly MessageComponent[]): string[] {
72
+ return components.flatMap((c) => [...(c.content === undefined ? [] : [c.content]), ...texts(c.components ?? [])]);
73
+ }
74
+
67
75
  function posted(over: Partial<PostedAlert> = {}): PostedAlert {
68
76
  return { messageId: "m1", channelId: "c1", key: alertKey(deploy), event: deploy, count: 1, repeat: "first time this week", postedAt: "2026-10-20T12:51:00Z", investigation: "none", ...over };
69
77
  }
@@ -216,7 +224,7 @@ describe("health", () => {
216
224
  expect(parseAttention(attention)).toMatchObject({ bouncers: 1, oldestPullSeconds: 4, agentsTotal: 8, agentsActive: 7, issues: [{ code: "wazuh-agent:dmz" }] });
217
225
  expect(parseAttention({ bouncer: {} })).toBeNull();
218
226
  expect(healthLine(parseAttention({ ...attention, health_issues: [] }))).toBe("Health · 7/8 Wazuh agents active · bouncer pulled 4 s ago");
219
- expect(healthLine(parseAttention(attention))).toBe("Health · Wazuh agent dmz is Disconnected");
227
+ expect(healthLine(parseAttention(attention))).toBe("Health · 1 issue · Wazuh agent dmz is Disconnected");
220
228
  expect(healthLine(null)).toBe("Health · the check failed");
221
229
  });
222
230
 
@@ -349,11 +357,11 @@ describe("vulnerabilities", () => {
349
357
  vuln({ cve: "CVE-2025-68745", package: "linux-image-cloud-amd64", agent: "dmz", severity: "-", score: -1, condition: "Package default status" }),
350
358
  vuln({ cve: "CVE-2025-68745", package: "linux-image-cloud-amd64", agent: "identity", severity: "-", score: -1, condition: "Package default status" }),
351
359
  ];
352
- expect(vulnLine(found)).toBe("Vulnerabilities · 1 new CVE on 2 hosts: CVE-2025-68745 (linux-image-cloud-amd64) on dmz, identity · no fixed version yet");
353
- expect(vulnLine([])).toBe("Vulnerabilities · nothing new");
354
- expect(vulnLine(null)).toBe("Vulnerabilities · the check failed");
360
+ expect(vulnLine(found)).toBe("Host packages · 1 new CVE on 2 hosts, no fixed version yet · CVE-2025-68745 (linux-image-cloud-amd64) on dmz, identity");
361
+ expect(vulnLine([])).toBe("Host packages · no new CVEs");
362
+ expect(vulnLine(null)).toBe("Host packages · the check failed");
355
363
  const many = ["A", "B", "C", "D"].map((c, i) => vuln({ cve: `CVE-${c}`, score: 5 + i }));
356
- expect(vulnLine(many)).toBe("Vulnerabilities · 4 new CVEs on 1 host: CVE-D (libfoo, High 8.0) on arcane · CVE-C (libfoo, High 7.0) on arcane · CVE-B (libfoo, High 6.0) on arcane · +1 more CVEs · fixed versions exist");
364
+ expect(vulnLine(many)).toBe("Host packages · 4 new CVEs on 1 host, fixed versions exist · CVE-D (libfoo, High 8.0) on arcane · CVE-C (libfoo, High 7.0) on arcane · CVE-B (libfoo, High 6.0) on arcane · +1 more CVEs");
357
365
  const closed = [
358
366
  vuln({ agent: "frontdoor-1337", cve: "CVE-2026-50252", package: "libunbound8", version: "1.26.0-1", status: "Solved", severity: "Critical", score: 9.8 }),
359
367
  vuln({ agent: "dmz", cve: "CVE-X", package: "openssl", version: "3.5.1", status: "Solved", score: 5 }),
@@ -361,7 +369,7 @@ describe("vulnerabilities", () => {
361
369
  vuln({ agent: "dmz", cve: "CVE-Z", package: "openssl", version: "3.5.1", status: "Solved", score: 6 }),
362
370
  ];
363
371
  expect(patchLine(closed)).toBe(
364
- "Patches · frontdoor-1337: libunbound8 replaced 1.26.0-1, closes CVE-2026-50252 (Critical 9.8) · dmz: openssl replaced 3.5.1, closes 3 CVEs: CVE-Y (High 7.0), CVE-Z (High 6.0), +1 more",
372
+ "Patches · 4 CVEs closed by 2 package updates · frontdoor-1337: libunbound8 replaced 1.26.0-1, closes CVE-2026-50252 (Critical 9.8) · dmz: openssl replaced 3.5.1, closes 3 CVEs: CVE-Y (High 7.0), CVE-Z (High 6.0), +1 more",
365
373
  );
366
374
  expect(patchLine([])).toBe("Patches · none");
367
375
  });
@@ -458,32 +466,51 @@ describe("Arcane image scans", () => {
458
466
  });
459
467
  });
460
468
 
469
+ describe("report cards", () => {
470
+ it("puts a line's label in bold with its summary and one bullet per detail", () => {
471
+ expect(section("🚫", "CrowdSec · 3 bans · 2 IPs · top sources: US 2")).toBe("🚫 **CrowdSec** · 3 bans\n- 2 IPs\n- top sources: US 2");
472
+ expect(section("👁️", "Wazuh · no alerts at level 10+")).toBe("👁️ **Wazuh** · no alerts at level 10+");
473
+ expect(section("📦", "Host packages")).toBe("📦 **Host packages**");
474
+ });
475
+ });
476
+
461
477
  describe("daily report", () => {
462
478
  const attention = parseAttention({ checked_at: "x", bouncer: { count: 1, oldest_pull_seconds: 6 }, wazuh_agents: { total: 8, active: 8 }, health_issues: [] });
463
479
 
464
- it("reads quiet day and tags nobody when nothing is open", () => {
480
+ it("reads quiet day in a green card and tags nobody when nothing is open", () => {
465
481
  const data = { until: "06:00 CEST", crowdsec: summary(), wazuh: wazuhDigest([], {}, () => false), found: [], closed: [], attention, images: { scanned: 57, total: 57, critical: [] }, offers: new Map() };
466
- expect(dailyText(data, [OWNER])).toBe(
467
- [
468
- "**Security Daily Report:** quiet day (24 h to 06:00 CEST)",
469
- "CrowdSec · 19 bans, all front door SNI scanning · 2 repeat offenders now banned longer: 1 × 7 days, 1 × 24 h · top sources: US 12, BE 3, BG 2; AS396982 GOOGLE-CLOUD-PLATFORM 8",
470
- "Wazuh · no alerts at level 10+",
471
- "Vulnerabilities · nothing new",
472
- "Patches · none",
473
- "Arcane images · no critical CVE with a fix (57 of 57 images scanned)",
474
- "Health · 8/8 Wazuh agents active · bouncer pulled 6 s ago",
475
- ].join("\n"),
476
- );
482
+ const report = dailyCard(data, [OWNER]);
483
+ expect(report.headline).toBe("quiet day (24 h to 06:00 CEST)");
484
+ expect(report.mention).toBe(false);
485
+ expect(report.components).toEqual([
486
+ {
487
+ type: 17,
488
+ accent_color: 0x57f287,
489
+ components: [
490
+ { type: 10, content: "## 🛡️ Security Daily Report\n🟢 quiet day · 24 h to 06:00 CEST" },
491
+ { type: 14, divider: true, spacing: 1 },
492
+ { type: 10, content: "🚫 **CrowdSec** · 19 bans, all front door SNI scanning\n- 2 repeat offenders now banned longer: 1 × 7 days, 1 × 24 h\n- top sources: US 12, BE 3, BG 2; AS396982 GOOGLE-CLOUD-PLATFORM 8" },
493
+ { type: 10, content: "👁️ **Wazuh** · no alerts at level 10+" },
494
+ { type: 10, content: "📦 **Host packages** · no new CVEs" },
495
+ { type: 10, content: "🩹 **Patches** · none" },
496
+ { type: 10, content: "🐳 **Arcane images** · no critical CVE with a fix (57 of 57 images scanned)" },
497
+ { type: 10, content: "🩺 **Health** · 8/8 Wazuh agents active\n- bouncer pulled 6 s ago" },
498
+ ],
499
+ },
500
+ ]);
477
501
  expect(dailyNeedsOwner(data)).toBe(false);
478
502
  expect(dailyNeedsOwner({ ...data, images: null })).toBe(true);
479
503
  });
480
504
 
481
- it("names urgent alerts and failed checks in the headline and tags the owner while something is open", () => {
505
+ it("names urgent alerts and failed checks in an orange card and tags the owner while something is open", () => {
482
506
  const wazuh = wazuhDigest([event({ rule: "5712", level: 12, description: "brute force" })], {}, () => false);
483
507
  const data = { until: "06:00 CEST", crowdsec: null, wazuh, found: [], closed: [], attention, images: { scanned: 57, total: 57, critical: [] }, offers: new Map() };
484
- const text = dailyText(data, [OWNER]);
485
- expect(text.split("\n")[0]).toBe("**Security Daily Report:** 1 urgent alert, 1 check failed (24 h to 06:00 CEST)");
486
- expect(text.endsWith(`<@${OWNER}>`)).toBe(true);
508
+ const report = dailyCard(data, [OWNER]);
509
+ expect(report.headline).toBe("1 urgent alert, 1 check failed (24 h to 06:00 CEST)");
510
+ expect(report.mention).toBe(true);
511
+ expect(report.components[0].accent_color).toBe(0xe67e22);
512
+ expect(texts(report.components)[0]).toBe("## 🛡️ Security Daily Report\n🟠 1 urgent alert, 1 check failed · 24 h to 06:00 CEST");
513
+ expect(report.components[1]).toEqual({ type: 10, content: `<@${OWNER}>` });
487
514
  });
488
515
  });
489
516
 
@@ -506,42 +533,61 @@ describe("weekly report", () => {
506
533
  last24h: { bans: 16, wazuh: 0, urgent: 0, found: 0, closed: 2, health: 0 },
507
534
  images: { scanned: 57, total: 57, critical: [] } as ImageVulnFacts | null,
508
535
  offers: new Map<string, ImageOffer>(),
536
+ alerts: [],
509
537
  };
510
538
 
511
- it("follows the approved layout and says when nothing needs the owner", () => {
512
- const out = weeklyText(base, [OWNER]);
539
+ it("lays out a green card with one section per area when nothing needs the owner", () => {
540
+ const out = weeklyCard(base, [OWNER]);
513
541
  expect(out.mention).toBe(false);
514
- expect(out.text).toBe(
515
- [
516
- "**Security Weekly Report:** 13–19 Oct 2026 · 🟢 no incident · nothing needs you",
517
- "CrowdSec · 121 bans (−8 % vs last week) · 118 IPs · longest: 1 × 7 days · scenarios: front door SNI scanning 16 % · top sources: US 12, BE 3, BG 2; AS396982 GOOGLE-CLOUD-PLATFORM 8",
518
- "Wazuh · no alerts at level 10+",
519
- "Vulnerabilities · 0 new · 0 closed by patches · 0 open with a fixed version",
520
- "Patching · 14 package installs on 2 hosts · 0 CVEs closed · agent restarts: frontdoor-1337 19 Oct · reboot pending: none",
521
- "Arcane images · no critical CVE with a fix (57 of 57 images scanned)",
522
- "Health · 8/8 Wazuh agents active · bouncer pulled 4 s ago · RADIUS CRL: no renewal warning (it warns 30 days ahead)",
523
- "Backups · Proxmox: the only guest backed up within 48 h, last 20 Oct 02:30 CEST · restic check: success 18 Oct 04:00",
524
- "Needs you · nothing",
525
- "Last 24 h · 16 bans · 0 Wazuh alerts at level 10+ · 0 new CVEs · 2 CVEs closed · health ok",
526
- ].join("\n"),
527
- );
542
+ expect(out.headline).toBe("13–19 Oct 2026 · 🟢 no incident · nothing needs you");
543
+ expect(out.components).toHaveLength(1);
544
+ expect(out.components[0].accent_color).toBe(0x57f287);
545
+ expect(texts(out.components)).toEqual([
546
+ "## 🛡️ Security Weekly Report · 13–19 Oct 2026\n🟢 no incident · nothing needs you",
547
+ "🚫 **CrowdSec** · 121 bans (−8 % vs last week)\n- 118 IPs\n- longest: 1 × 7 days\n- scenarios: front door SNI scanning 16 %\n- top sources: US 12, BE 3, BG 2; AS396982 GOOGLE-CLOUD-PLATFORM 8",
548
+ "👁️ **Wazuh** · no alerts at level 10+",
549
+ "📦 **Host packages** · 0 new CVEs\n- 0 closed by patches\n- 0 open with a fixed version",
550
+ "🩹 **Patching** · 14 package installs on 2 hosts\n- 0 CVEs closed\n- agent restarts: frontdoor-1337 19 Oct\n- reboot pending: none",
551
+ "🐳 **Arcane images** · no critical CVE with a fix (57 of 57 images scanned)",
552
+ "🩺 **Health** · 8/8 Wazuh agents active\n- bouncer pulled 4 s ago\n- RADIUS CRL: no renewal warning (it warns 30 days ahead)",
553
+ "💾 **Backups** · Proxmox: the only guest backed up within 48 h, last 20 Oct 02:30 CEST\n- restic check: success 18 Oct 04:00",
554
+ "-# Last 24 h · 16 bans · 0 Wazuh alerts at level 10+ · 0 new CVEs · 2 CVEs closed · health ok",
555
+ ]);
556
+ const one = weeklyCard({ ...base, last24h: { bans: 1, wazuh: 1, urgent: 1, found: 1, closed: 1, health: 1 } }, [OWNER]);
557
+ expect(texts(one.components).at(-1)).toBe("-# Last 24 h · 1 ban · 1 Wazuh alert at level 10+ (1 urgent) · 1 new CVE · 1 CVE closed · 1 health issue");
528
558
  });
529
559
 
530
- it("lists what needs the owner and tags them", () => {
560
+ it("lists what needs the owner first and tags them", () => {
531
561
  const stale = { ...base.backups, guests: [{ vmid: "106", name: "observability", last: Date.parse("2026-10-15T00:30:00Z") / 1000 }], restic: { result: "exit-code", at: "18 Oct 04:00" } };
532
562
  const fix: ReportedVuln = { agent: "dmz", cve: "CVE-1", package: "openssl", version: "1", severity: "High", score: 7, fix: true, since: "2026-10-10T00:00:00Z" };
533
- const out = weeklyText({ ...base, backups: stale, openWithFix: [fix], crl: { days: 23, warned: "2026-10-19T04:00:00Z" }, patching: { ...base.patching, rebootPending: ["dmz"] }, wazuh: wazuhDigest([{ ...deploy, id: "u1" }], {}, () => false) }, [OWNER]);
563
+ const out = weeklyCard({ ...base, backups: stale, openWithFix: [fix], crl: { days: 23, warned: "2026-10-19T04:00:00Z" }, patching: { ...base.patching, rebootPending: ["dmz"] }, wazuh: wazuhDigest([{ ...deploy, id: "u1" }], {}, () => false) }, [OWNER]);
534
564
  expect(out.mention).toBe(true);
535
- expect(out.text).toContain("🟠 1 urgent alert · 6 items need you");
536
- expect(out.text).toContain(
537
- "Needs you · 1) 1 unexplained deployment change this week; Investigate on the alert 2) reboot dmz to load installed updates 3) 1 CVE with a fixed version still open after 3 days (dmz); unattended-upgrades may be stuck 4) renew the RADIUS CRL (wifi-device.sh renew-crl), 23 days left 5) no Proxmox backup within 48 h for observability 6) the restic check ended with exit-code",
565
+ expect(out.components[0].accent_color).toBe(0xe67e22);
566
+ const shown = texts(out.components);
567
+ expect(shown[0]).toBe("## 🛡️ Security Weekly Report · 13–19 Oct 2026\n🟠 1 urgent alert · 6 items need you");
568
+ expect(shown[1]).toBe(
569
+ "### Needs you\n1. 1 unexplained deployment change this week; Investigate on the alert\n2. reboot dmz to load installed updates\n3. 1 CVE with a fixed version still open after 3 days (dmz); unattended-upgrades may be stuck\n4. renew the RADIUS CRL (wifi-device.sh renew-crl), 23 days left\n5. no Proxmox backup within 48 h for observability\n6. the restic check ended with exit-code",
538
570
  );
539
- expect(out.text).toContain("RADIUS CRL: renew within 23 days (warned 19 Oct)");
571
+ expect(out.components[0].components?.map((c) => c.type).slice(0, 5)).toEqual([10, 14, 10, 14, 10]);
572
+ expect(shown.join("\n")).toContain("- RADIUS CRL: renew within 23 days (warned 19 Oct)");
573
+ expect(out.components.at(-1)).toEqual({ type: 10, content: `<@${OWNER}>` });
540
574
  const offers = imageOffers([{ stack: "mealie", lines: [{ ref: "ghcr.io/mealie-recipes/mealie:latest" }], actionable: true, state: "offered" }]);
541
- const withImages = weeklyText({ ...base, offers, images: { scanned: 57, total: 57, critical: [{ id: "CVE-9", pkg: "openssl", image: "ghcr.io/mealie-recipes/mealie:1" }] } }, [OWNER]);
542
- expect(withImages.text).toContain("Needs you · 1) update mealie in the Arcane Daily Report: the newer image replaces one with a critical CVE");
543
- expect(weeklyText({ ...base, images: null }, [OWNER]).text).toContain("1) 1 check of this report failed");
544
- expect(out.text.endsWith(`<@${OWNER}>`)).toBe(true);
575
+ const withImages = weeklyCard({ ...base, offers, images: { scanned: 57, total: 57, critical: [{ id: "CVE-9", pkg: "openssl", image: "ghcr.io/mealie-recipes/mealie:1" }] } }, [OWNER]);
576
+ expect(texts(withImages.components)[1]).toBe("### Needs you\n1. update mealie in the Arcane Daily Report: the newer image replaces one with a critical CVE");
577
+ expect(needsYou({ ...base, images: null })).toEqual(["1 check of this report failed; the bridge log on Cortex has the reason"]);
578
+ });
579
+
580
+ it("names each unacknowledged alert and says when it never reached Discord", () => {
581
+ const setup = event({ id: "s1", rule: "100021", level: 10, timestamp: "2026-10-19T21:31:28.085+0000", path: "/etc/sudoers.d/spc-arcane", event: "added" });
582
+ const test1 = event({ id: "t1", rule: "100021", level: 10, timestamp: "2026-10-21T21:47:18.458+0000", path: "/etc/sudoers.d/zz-alert-test", event: "added" });
583
+ const test2 = event({ id: "t2", rule: "100021", level: 10, timestamp: "2026-10-21T21:48:01.868+0000", path: "/etc/sudoers.d/zz-alert-test", event: "deleted" });
584
+ const brute = event({ id: "b1", rule: "5712", level: 12, description: "sshd: brute force trying to get access to the system." });
585
+ const wazuh = wazuhDigest([setup, test1, test2, brute], {}, (e) => e.id === "b1");
586
+ expect(needsYou({ ...base, wazuh, alerts: [{ key: alertKey(test1), channelId: "c9" }] })).toEqual([
587
+ "urgent alert never posted, so it has no Acknowledge button: `/etc/sudoers.d/spc-arcane` added on arcane, 19 Oct 23:31 CEST; check that it was expected",
588
+ "urgent alert not acknowledged: `/etc/sudoers.d/zz-alert-test` deleted on arcane × 2, last 21 Oct 23:48 CEST; Acknowledge it in <#c9>",
589
+ ]);
590
+ expect(needsYou({ ...base, wazuh: wazuhDigest([brute], {}, () => false) })).toEqual(["urgent alert never posted, so it has no Acknowledge button: sshd: brute force trying to get access to the system on arcane, 20 Oct 14:50 CEST; check that it was expected"]);
545
591
  });
546
592
 
547
593
  it("names the week before the Monday it is posted on", () => {
@@ -9,8 +9,8 @@ import type { MessageComponent } from "./rest.ts";
9
9
 
10
10
  export type { AlertSummary, VulnEvent, WazuhEvent };
11
11
 
12
- export const DAILY_PREFIX = "Security Daily Report:";
13
- export const WEEKLY_PREFIX = "Security Weekly Report:";
12
+ export const DAILY_PREFIX = "Security Daily Report";
13
+ export const WEEKLY_PREFIX = "Security Weekly Report";
14
14
  /** Wazuh levels from here on page at once; our own rules page at level 10 by rule id. */
15
15
  export const URGENT_LEVEL = 11;
16
16
  /** The poller and the reports read Wazuh from this level: every rule of ours is level 10. */
@@ -350,7 +350,7 @@ export function checksRecoveredText(what: string): string {
350
350
 
351
351
  export function healthLine(a: Attention | null): string {
352
352
  if (!a) return "Health · the check failed";
353
- if (a.issues.length > 0) return `Health · ${a.issues.map((i) => escapeDiscord(i.message.replace(/\.$/, ""))).join(" · ")}`;
353
+ if (a.issues.length > 0) return `Health · ${a.issues.length} issue${a.issues.length === 1 ? "" : "s"} · ${a.issues.map((i) => escapeDiscord(i.message.replace(/\.$/, ""))).join(" · ")}`;
354
354
  const pull = a.oldestPullSeconds === null ? "no bouncer pull recorded" : `bouncer pulled ${a.oldestPullSeconds} s ago`;
355
355
  return `Health · ${a.agentsActive ?? "?"}/${a.agentsTotal ?? "?"} Wazuh agents active · ${pull}`;
356
356
  }
@@ -521,8 +521,8 @@ function severityText(e: { severity: string; score: number | null }): string {
521
521
  }
522
522
 
523
523
  export function vulnLine(found: readonly VulnEvent[] | null, maxShown = 3): string {
524
- if (!found) return "Vulnerabilities · the check failed";
525
- if (found.length === 0) return "Vulnerabilities · nothing new";
524
+ if (!found) return "Host packages · the check failed";
525
+ if (found.length === 0) return "Host packages · no new CVEs";
526
526
  const byCve = new Map<string, { e: VulnEvent; hosts: string[]; fix: boolean }>();
527
527
  for (const e of found) {
528
528
  const key = `${e.cve}|${e.package}`;
@@ -541,7 +541,7 @@ export function vulnLine(found: readonly VulnEvent[] | null, maxShown = 3): stri
541
541
  const fixes = groups.filter((g) => g.fix).length;
542
542
  const fixText = fixes === 0 ? "no fixed version yet" : fixes === groups.length ? "fixed versions exist" : `fixed version exists for ${fixes}`;
543
543
  const hosts = new Set(found.map((e) => e.agent)).size;
544
- return `Vulnerabilities · ${groups.length} new CVE${groups.length === 1 ? "" : "s"} on ${hosts} host${hosts === 1 ? "" : "s"}: ${shown.join(" · ")}${more} · ${fixText}`;
544
+ return `Host packages · ${groups.length} new CVE${groups.length === 1 ? "" : "s"} on ${hosts} host${hosts === 1 ? "" : "s"}, ${fixText} · ${shown.join(" · ")}${more}`;
545
545
  }
546
546
 
547
547
  export function patchLine(closed: readonly VulnEvent[] | null, label = "Patches", maxShown = 3): string {
@@ -563,7 +563,8 @@ export function patchLine(closed: readonly VulnEvent[] | null, label = "Patches"
563
563
  return `${escapeDiscord(g.agent)}: ${escapeDiscord(g.pkg)} replaced ${escapeDiscord(g.version)}, ${what}`;
564
564
  });
565
565
  const more = groups.length > maxShown ? ` · +${groups.length - maxShown} more packages` : "";
566
- return `${label} · ${shown.join(" · ")}${more}`;
566
+ const cves = new Set(closed.map((e) => `${e.agent}|${e.cve}`)).size;
567
+ return `${label} · ${cves} CVE${cves === 1 ? "" : "s"} closed by ${groups.length} package update${groups.length === 1 ? "" : "s"} · ${shown.join(" · ")}${more}`;
567
568
  }
568
569
 
569
570
  // ---------------------------------------------------------------- Arcane image scans
@@ -717,6 +718,30 @@ export function imageVulnLine(facts: ImageVulnFacts | null, offers: ReadonlyMap<
717
718
 
718
719
  // ---------------------------------------------------------------- reports
719
720
 
721
+ const GREEN = 0x57f287;
722
+ const ORANGE = 0xe67e22;
723
+ const SEPARATOR: MessageComponent = { type: 14, divider: true, spacing: 1 };
724
+
725
+ /** A report line `Label · summary · detail · …` as the label in bold with its summary, then one bullet per detail. */
726
+ export function section(icon: string, line: string): string {
727
+ const [label, summary, ...details] = line.split(" · ");
728
+ return [`${icon} **${label}**${summary === undefined ? "" : ` · ${summary}`}`, ...details.map((d) => `- ${d}`)].join("\n");
729
+ }
730
+
731
+ /** A posted report: one Container, orange while something needs the owners, and their mention below it. */
732
+ export interface ReportCard {
733
+ /** The state without the report's name, for the morning summary: `quiet day (24 h to 06:00 CEST)`. */
734
+ headline: string;
735
+ mention: boolean;
736
+ components: MessageComponent[];
737
+ }
738
+
739
+ /** Text Displays in groups divided by separators. */
740
+ function card(groups: readonly (readonly string[])[], attention: boolean, mention: string | null): MessageComponent[] {
741
+ const components = groups.filter((g) => g.length > 0).flatMap((g, i) => [...(i > 0 ? [SEPARATOR] : []), ...g.map((content): MessageComponent => ({ type: 10, content }))]);
742
+ return [{ type: 17, accent_color: attention ? ORANGE : GREEN, components }, ...(mention ? [{ type: 10, content: mention }] : [])];
743
+ }
744
+
720
745
  export interface DailyData {
721
746
  /** Local time the report covers up to, already formatted (`06:00 CEST`). */
722
747
  until: string;
@@ -750,11 +775,22 @@ export function dailyNeedsOwner(d: DailyData): boolean {
750
775
  return (d.attention?.issues.length ?? 0) > 0 || failures(d) > 0;
751
776
  }
752
777
 
753
- export function dailyText(d: DailyData, owners: readonly string[]): string {
754
- const head = `**${DAILY_PREFIX}** ${headline(d.wazuh.urgent, d.wazuh.unexplained.length, d.attention?.issues.length ?? 0, failures(d))} (24 h to ${d.until})`;
755
- const lines = [head, crowdsecDailyLine(d.crowdsec), d.wazuh.line, vulnLine(d.found), patchLine(d.closed), imageVulnLine(d.images, d.offers, d.arcaneChannelId), healthLine(d.attention)];
756
- if (dailyNeedsOwner(d)) lines.push(mentionLine(owners));
757
- return lines.join("\n");
778
+ export function dailyCard(d: DailyData, owners: readonly string[]): ReportCard {
779
+ const state = headline(d.wazuh.urgent, d.wazuh.unexplained.length, d.attention?.issues.length ?? 0, failures(d));
780
+ const mention = dailyNeedsOwner(d);
781
+ const sections = [
782
+ section("🚫", crowdsecDailyLine(d.crowdsec)),
783
+ section("👁️", d.wazuh.line),
784
+ section("📦", vulnLine(d.found)),
785
+ section("🩹", patchLine(d.closed)),
786
+ section("🐳", imageVulnLine(d.images, d.offers, d.arcaneChannelId)),
787
+ section("🩺", healthLine(d.attention)),
788
+ ];
789
+ return {
790
+ headline: `${state} (24 h to ${d.until})`,
791
+ mention,
792
+ components: card([[`## 🛡️ ${DAILY_PREFIX}\n${state === "quiet day" ? "🟢" : "🟠"} ${state} · 24 h to ${d.until}`], sections], state !== "quiet day", mention ? mentionLine(owners) : null),
793
+ };
758
794
  }
759
795
 
760
796
  export interface PatchingFacts {
@@ -790,6 +826,8 @@ export interface WeeklyData {
790
826
  images: ImageVulnFacts | null;
791
827
  offers: ReadonlyMap<string, ImageOffer>;
792
828
  arcaneChannelId?: string;
829
+ /** Alerts posted to Discord, to tell an unacknowledged alert from one that was never posted. */
830
+ alerts: readonly Pick<PostedAlert, "key" | "channelId">[];
793
831
  last24h: { bans: number | null; wazuh: number | null; urgent: number; found: number | null; closed: number | null; health: number | null };
794
832
  }
795
833
 
@@ -856,12 +894,25 @@ function crlText(crl: WeeklyData["crl"], timeZone: string): string {
856
894
  return `RADIUS CRL: renew within ${crl.days} days (warned ${dayText(crl.warned, timeZone)})`;
857
895
  }
858
896
 
897
+ /** One item per alert key the owners did not acknowledge: what changed, when, and where to acknowledge it, if anywhere. */
898
+ function unacknowledgedItems(d: WeeklyData): string[] {
899
+ const groups = new Map<string, WazuhEvent[]>();
900
+ for (const e of d.wazuh.unacknowledged) if (e.rule !== DEPLOYMENT_RULE) groups.set(alertKey(e), [...(groups.get(alertKey(e)) ?? []), e]);
901
+ return [...groups.entries()].map(([key, events]) => {
902
+ const last = events.reduce((a, b) => (Date.parse(b.timestamp) > Date.parse(a.timestamp) ? b : a));
903
+ const what = last.path ? `\`${last.path.replace(/`/g, "'")}\` ${escapeDiscord(last.event ?? "changed")}` : escapeDiscord(issueLabel(last));
904
+ const when = events.length > 1 ? ` × ${events.length}, last ${clockText(last.timestamp, d.timeZone)}` : `, ${clockText(last.timestamp, d.timeZone)}`;
905
+ const posted = d.alerts.find((a) => a.key === key);
906
+ const fact = `${what} on ${escapeDiscord(last.agent)}${when}`;
907
+ return posted ? `urgent alert not acknowledged: ${fact}; Acknowledge it in <#${posted.channelId}>` : `urgent alert never posted, so it has no Acknowledge button: ${fact}; check that it was expected`;
908
+ });
909
+ }
910
+
859
911
  export function needsYou(d: WeeklyData): string[] {
860
912
  const items: string[] = [];
861
913
  for (const i of d.attention?.issues ?? []) items.push(escapeDiscord(i.message.replace(/\.$/, "")));
862
914
  if (d.wazuh.unexplained.length > 0) items.push(`${d.wazuh.unexplained.length} unexplained deployment change${d.wazuh.unexplained.length === 1 ? "" : "s"} this week; Investigate on the alert`);
863
- const urgentLeft = d.wazuh.unacknowledged.filter((e) => e.rule !== DEPLOYMENT_RULE).length;
864
- if (urgentLeft > 0) items.push(`${urgentLeft} urgent alert${urgentLeft === 1 ? "" : "s"} this week not acknowledged`);
915
+ items.push(...unacknowledgedItems(d));
865
916
  if (d.patching && d.patching.rebootPending.length > 0) items.push(`reboot ${d.patching.rebootPending.map(escapeDiscord).join(", ")} to load installed updates`);
866
917
  const stuck = d.openWithFix.filter((v) => d.now - Date.parse(v.since) > 3 * DAY);
867
918
  if (stuck.length > 0) items.push(`${stuck.length} CVE${stuck.length === 1 ? "" : "s"} with a fixed version still open after 3 days (${[...new Set(stuck.map((v) => v.agent))].map(escapeDiscord).join(", ")}); unattended-upgrades may be stuck`);
@@ -879,33 +930,36 @@ export function needsYou(d: WeeklyData): string[] {
879
930
  }
880
931
 
881
932
  function lastDayLine(l: WeeklyData["last24h"]): string {
882
- const n = (v: number | null, what: string) => (v === null ? `${what} unknown` : `${v} ${what}`);
883
- return `Last 24 h · ${n(l.bans, "bans")} · ${n(l.wazuh, "Wazuh alerts at level 10+")}${l.urgent > 0 ? ` (${l.urgent} urgent)` : ""} · ${n(l.found, "new CVEs")} · ${n(l.closed, "CVEs closed")} · ${l.health === null ? "health unknown" : l.health === 0 ? "health ok" : `${l.health} health issues`}`;
933
+ const n = (v: number | null, one: string, many: string) => (v === null ? `${many} unknown` : `${v} ${v === 1 ? one : many}`);
934
+ const health = l.health === null ? "health unknown" : l.health === 0 ? "health ok" : n(l.health, "health issue", "health issues");
935
+ return `Last 24 h · ${n(l.bans, "ban", "bans")} · ${n(l.wazuh, "Wazuh alert at level 10+", "Wazuh alerts at level 10+")}${l.urgent > 0 ? ` (${l.urgent} urgent)` : ""} · ${n(l.found, "new CVE", "new CVEs")} · ${n(l.closed, "CVE closed", "CVEs closed")} · ${health}`;
884
936
  }
885
937
 
886
- export function weeklyText(d: WeeklyData, owners: readonly string[]): { text: string; mention: boolean } {
938
+ export function weeklyCard(d: WeeklyData, owners: readonly string[]): ReportCard {
887
939
  const items = needsYou(d);
888
940
  const incidents = d.wazuh.urgent;
889
941
  const state = incidents === 0 ? "🟢 no incident" : `🟠 ${incidents} urgent alert${incidents === 1 ? "" : "s"}`;
890
942
  const needs = items.length === 0 ? "nothing needs you" : `${items.length} item${items.length === 1 ? "" : "s"} need${items.length === 1 ? "s" : ""} you`;
891
943
  const tracking = d.trackingSince && d.now - Date.parse(d.trackingSince) < 30 * DAY ? ` (tracked since ${dayText(d.trackingSince, d.timeZone)})` : "";
892
944
  const fixable = d.openWithFix.length;
893
- const found = d.found === null ? "new: unknown" : `${new Set(d.found.map((e) => `${e.agent}|${e.cve}`)).size} new`;
894
- const closed = d.closed === null ? "closed: unknown" : `${new Set(d.closed.map((e) => `${e.agent}|${e.cve}`)).size} closed by patches`;
895
- const lines = [
896
- `**${WEEKLY_PREFIX}** ${d.range} · ${state} · ${needs}`,
897
- crowdsecWeeklyLine(d.crowdsec, d.previousBans),
898
- d.wazuh.line,
899
- `Vulnerabilities · ${found} · ${closed} · ${fixable} open with a fixed version${tracking}`,
900
- patchingLine(d.patching, d.closed, d.timeZone),
901
- imageVulnLine(d.images, d.offers, d.arcaneChannelId),
902
- `${healthLine(d.attention)} · ${crlText(d.crl, d.timeZone)}`,
903
- backupLine(d.backups, d.now, d.timeZone),
904
- `Needs you · ${items.length === 0 ? "nothing" : items.map((t, i) => `${i + 1}) ${t}`).join(" ")}`,
905
- lastDayLine(d.last24h),
945
+ const cveCount = (events: readonly VulnEvent[]) => new Set(events.map((e) => `${e.agent}|${e.cve}`)).size;
946
+ const found = d.found === null ? "new CVEs: unknown" : `${cveCount(d.found)} new CVE${cveCount(d.found) === 1 ? "" : "s"}`;
947
+ const closed = d.closed === null ? "closed: unknown" : `${cveCount(d.closed)} closed by patches`;
948
+ const sections = [
949
+ section("🚫", crowdsecWeeklyLine(d.crowdsec, d.previousBans)),
950
+ section("👁️", d.wazuh.line),
951
+ section("📦", `Host packages · ${found} · ${closed} · ${fixable} open with a fixed version${tracking}`),
952
+ section("🩹", patchingLine(d.patching, d.closed, d.timeZone)),
953
+ section("🐳", imageVulnLine(d.images, d.offers, d.arcaneChannelId)),
954
+ section("🩺", `${healthLine(d.attention)} · ${crlText(d.crl, d.timeZone)}`),
955
+ section("💾", backupLine(d.backups, d.now, d.timeZone)),
906
956
  ];
907
- if (items.length > 0) lines.push(mentionLine(owners));
908
- return { text: lines.join("\n"), mention: items.length > 0 };
957
+ const needsBlock = items.length === 0 ? [] : [`### Needs you\n${items.map((t, i) => `${i + 1}. ${t}`).join("\n")}`];
958
+ return {
959
+ headline: `${d.range} · ${state} · ${needs}`,
960
+ mention: items.length > 0,
961
+ components: card([[`## 🛡️ ${WEEKLY_PREFIX} · ${d.range}\n${state} · ${needs}`], needsBlock, sections, [`-# ${lastDayLine(d.last24h)}`]], incidents > 0 || items.length > 0, items.length > 0 ? mentionLine(owners) : null),
962
+ };
909
963
  }
910
964
 
911
965
  /** `13–19 Oct 2026` for the seven local days before `date` (`YYYY-MM-DD`, a Monday). */
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@astrofoundry/pi-astro",
3
- "version": "0.40.7",
3
+ "version": "0.40.9",
4
4
  "description": "Personal pi customizations (extensions, subagents, skills, prompts, themes) for the pi coding agent.",
5
5
  "keywords": [
6
6
  "pi-package"
@@ -57,7 +57,7 @@ Wrappers ship as TypeScript and run under Node 24 type stripping: erasable synta
57
57
  - `entry/specialist-install.sh` runs as root, so it runs only `/usr/bin`, `/bin`, `/usr/sbin`, `/sbin` and the Node it installed, never Homebrew or anything else the main user can write; it checks that `/usr/local/libexec/specialist-node` (and each `specialist-<tool>` folder) and its parents belong to root and are writable by nobody else. Arguments are checked before the root test (tests exercise that part). Downloads go to a root-only temporary directory and are verified before use: Node against `SHASUMS256.txt` and the LTS flag in `index.json`, npm tarballs against the registry's `sha512` integrity, arcane-cli against the release's checksums file. Inside `/Users/specialist` it works only as `specialist` (`sudo -u specialist -H`), from a staging directory root hands over, so a link the specialist plants cannot redirect a root write. Each component switches by rename after a check (every installed wrapper's `--help`, `--version` of the new binary) and restores the previous copy when the check fails. Older versions are refused; `rollback` swaps current and previous. `python`, `gcloud`, `bw`, and `jq` follow the same rules: version folders under `/usr/local/libexec/specialist-<tool>/` behind the links `current` and `previous`, sealed `root:wheel` and not writable by others, smoke-tested as `specialist` before `current` moves; `python` refuses a switch that breaks the current gcloud. Consumers use the `current` paths: `provision.sh` for `bw` and `jq`, `edge.json` for `gcloud` and `gcloudPython`. Nothing a wrapper runs with secrets may come from Homebrew.
58
58
  - `main()` waits for stdout and stderr to flush before `process.exit`: on a pipe, exiting right after a write drops everything past the 64 KiB buffer, which cut large answers such as `projects list --all` until 2026-09-25 (`lib/flush.test.ts`).
59
59
  - `arcane update-report [--all]` is `lib/image-updates.ts` over `lib/registry.ts`: a fresh `images updates check --all`, then `projects list --all` for the stack and service of each image reference, then the registries' tag lists and manifest digests (anonymous bearer tokens from each registry's challenge; digests by HEAD, which Docker Hub does not count as a pull; lscr.io is read from ghcr.io). A floating or major-series tag is resolved to the release tag whose digest matches the running and the latest build, searching the newest tags of the three commonest release shapes; a fixed tag is compared with the newest tag of the same shape; a digest pin with the newest release. Checks older than one minute before the run count as stale and show as unknown. Private images (anonymous access refused with 401 or 403) are excluded from rows, counts, and table, listed in `privateImages`, and counted in the summary line. The table is fixed-width text for a code block, because Discord renders no Markdown tables. The answer adds `holds` from `update-holds.json` at origin's branch head (`git show`, no working-tree read), or `holdsError` when that file is malformed.
60
- - `arcane stack-update <stack> [--confirm]` (`lib/stack-update.ts` for the pure parts) is deterministic: refuses `arcane`, held stacks (the checkout's `update-holds.json` after `pull --ff-only`; a malformed file is an error), a dirty or ahead checkout, stopped stacks, and an update across a major version without `--confirm` (which the gate turns into an owner approval). Pending rows come from a fresh per-image check resolved like `update-report`. `edit tag`/`edit digest` rows rewrite `image:` lines that name exactly the old reference (`replaceImageRef`, quoted or not, trailing comment kept) in the sync's `composePath`, then commit, push, and wait for `gitops list` to report success at that commit (20 min, polled every 30 s). Then `projects redeploy <stack> --yes` (35 min), container checks through `containers list --all` and `containers get` (`composeInfo.projectName`, health; 5 min, polled every 15 s), and a fresh check that each service is current. A failure after a commit reverts, pushes, waits for the sync, redeploys, and checks again (`rolled back`); a pull-only failure stays `failed`. Every outcome prints JSON with `status` and exits 0. Worst case about 125 minutes, so the gate's `timeoutMs` for arcane must exceed it (8,100,000). The checkout is not locked, so an agent call and a bridge click at the same time can collide on it; the bridge runs one Arcane update at a time.
60
+ - `arcane stack-update <stack> [--confirm]` (`lib/stack-update.ts` for the pure parts) is deterministic: refuses `arcane`, held stacks (the checkout's `update-holds.json` after `pull --ff-only`; a malformed file is an error), a dirty or ahead checkout, stopped stacks, and an update across a major version without `--confirm` (which the gate turns into an owner approval). Pending rows come from a fresh per-image check resolved like `update-report`. `edit tag`/`edit digest` rows rewrite `image:` lines that name exactly the old reference (`replaceImageRef`, quoted or not, trailing comment kept) in the sync's `composePath`, then commit, push, and wait for `gitops list` to report success at that commit (20 min, polled every 30 s). Then `projects redeploy <stack> --yes` (35 min), container checks through `containers list --all` and `containers get` (`composeInfo.projectName`, health; 5 min, polled every 15 s; a job that exited with code 0 counts as done whatever health its image's inherited check left, as bigcapital's migration did on 2026-10-28), and a fresh check that each service is current. A failure after a commit reverts, pushes, waits for the sync, redeploys, and checks again (`rolled back`); a pull-only failure stays `failed`. Every outcome prints JSON with `status` and exits 0. Worst case about 125 minutes, so the gate's `timeoutMs` for arcane must exceed it (8,100,000). The checkout is not locked, so an agent call and a bridge click at the same time can collide on it; the bridge runs one Arcane update at a time.
61
61
  - `arcane host <command>` runs over the forced-command key of user `spc-arcane` on VM 100. `HOST_COMMANDS` in `lib/arcane-host.ts` must list exactly the operations of `entry/remote/spc-arcane-op.py` (a test compares them); the tracked copies live in the arcane repository's `host/` (`spc-arcane-host-entry`, `spc-arcane-op`, `spc-arcane-sudoers`, `spc-arcane-install.sh`) with the probes in `host/spc-arcane-probes/`. The entry only splits words (letters, digits, space, `._:/+-`) and hands them to `sudo -n /usr/local/sbin/spc-arcane-op`, the one command its sudoers line allows; the op checks the name and every argument and runs the reviewed arcane-ops probes, which print only allowlisted fields. Manager steps (`manager-*`) are internal to `manager-upgrade`/`manager-rollback` and refused through `host`. Nothing on the host deletes data: a manager rollback restores the image and Compose file, not the data volume (R3 stays manual), `db-restore` only fills an empty database, and dumps are never pruned by the tool. `host-audit` compares the host's hashes with `host/<name>` of the `arcane-gitops` checkout after a pull.
62
62
  - `arcane manager-upgrade <version>` (`lib/arcane-manager.ts`) follows arcane/AGENTS.md "Manager upgrades": the official image's revision label must equal the release tag's commit (GitHub API), `manager-prepare` records `compose.before.yaml` and every container before the pin commit, the pin goes through the `arcane-gitops` checkout (`git` is exported from `lib/repo.ts` for this), the wait polls `gitops list` and the deployed Compose hash every 30 s for up to 30 minutes, then pull, cold backup, `up -d --no-deps --pull never`, and checks. Any failure before the restart reverts the pin (`stopped`); a failed check after it reverts the pin and runs `manager-rollback` (`rolled back`). The answer always exits 0 with `status`, so the bridge and the agent both see it.
63
63
  - `media` runs trendarr unchanged: `trendarrCli` in `media.json` is its `dist/cli.js`, started with `process.execPath` because sudo's PATH has no node. Each call gets `HOME` set to a fresh `0700` directory under `~/.specialists/work/media/` that holds only `.trendarr/config.json` (`0600`, trendarr's own schema, built from the note fields and `media.json`) and is removed in `finally`; trendarr reads no environment variables and has no config flag, and Node's `os.homedir()` follows `$HOME` on POSIX. Every call passes `--json`; `init` is refused. An add prints trendarr's per-ID `results` and exits 0 even when trendarr exits 1 for a failed ID, because the gate shows only stderr on failure; other failures carry trendarr's stderr without its `warning:` lines, which go into the JSON as `warnings`. The bridge's slash commands and Add buttons call the same wrapper through the entry point (`extensions/astro-discord/media.ts`).
@@ -92,6 +92,11 @@ describe("stack health after a redeploy", () => {
92
92
  expect(containersProblem([up("db", { health: "unhealthy" }), up("app", { health: "starting" })], 2)).toBe("health: db (unhealthy), app (starting)");
93
93
  });
94
94
 
95
+ it("ignores the health a finished job inherited from its image", () => {
96
+ expect(containersProblem([up("db"), up("migration", { running: false, state: "exited", exitCode: 0, health: "unhealthy" })], 2)).toBeNull();
97
+ expect(containersProblem([up("db"), up("migration", { running: false, state: "exited", exitCode: 1, health: "unhealthy" })], 2)).toBe("not running: migration");
98
+ });
99
+
95
100
  it("names running containers left on an older image than their tag, not finished jobs", () => {
96
101
  expect(containersProblem([up("db", { stale: true }), up("redis", { stale: true }), up("app")], 3)).toBe("still on an older image than its tag: db, redis");
97
102
  expect(containersProblem([up("init", { running: false, state: "exited", exitCode: 0, stale: true })], 1)).toBeNull();
@@ -106,7 +106,9 @@ export function isStaleImage(image: unknown): boolean {
106
106
 
107
107
  /**
108
108
  * Why the stack is not healthy yet, or null when every container runs (or, as
109
- * a one-shot job, exited with code 0) and none is unhealthy or still starting.
109
+ * a one-shot job, exited with code 0) and no running one is unhealthy or still
110
+ * starting. A finished job keeps the health status of a check inherited from
111
+ * its image (bigcapital's migration reads "unhealthy"), so its health is not read.
110
112
  */
111
113
  export function containersProblem(containers: readonly StackContainer[], expected: number): string | null {
112
114
  if (containers.length < expected) return `${containers.length} of ${expected} services have a container`;
@@ -114,7 +116,7 @@ export function containersProblem(containers: readonly StackContainer[], expecte
114
116
  if (down.length > 0) return `not running: ${down.join(", ")}`;
115
117
  const old = containers.filter((c) => c.running === true && c.stale).map((c) => c.name);
116
118
  if (old.length > 0) return `still on an older image than its tag: ${old.join(", ")}`;
117
- const sick = containers.filter((c) => c.health === "unhealthy" || c.health === "starting").map((c) => `${c.name} (${c.health})`);
119
+ const sick = containers.filter((c) => c.running === true && (c.health === "unhealthy" || c.health === "starting")).map((c) => `${c.name} (${c.health})`);
118
120
  return sick.length > 0 ? `health: ${sick.join(", ")}` : null;
119
121
  }
120
122