@kal-elsam/kairo-runtime 0.8.0 → 0.10.0

package/README.md

@@ -16,8 +16,11 @@ as a technical alias).
 Kairo Runtime and prints a migration warning. Prefer `@kal-elsam/kairo-runtime` and the
 `kairo` CLI for new installs. See [`packages/harness-bridge/README.md`](packages/harness-bridge/README.md).
 
-Terminal UX aims for Pi-like clarity (clear modes, non-interactive flags, extensible
-commands) without depending on Pi as a runtime or adding a Pi adapter.
+Terminal UX is **terminal-first**: bare `kairo` opens the Ink Control Center (or Setup
+when unconfigured). Explicit commands (`setup`, `status`, `sync`, `doctor`, `monitor`,
+`shell`, …) keep their current behavior. Progressive disclosure keeps paths and IDs in
+Details, list caps honest (`… N more`), and Callout reserved for status — never for
+primary values. No web loopback / `kairo ui` in this release.
 
 - **npm:** https://www.npmjs.com/package/@kal-elsam/kairo-runtime
 - **repo:** https://github.com/Kal-elSam/harness
@@ -32,26 +35,49 @@ npx @kal-elsam/kairo-runtime
 kairo
 ```
 
-**First run** (no `~/.harness/state.json`): interactive onboarding → safe diagnosis →
-setup with confirmation → full-screen operations cockpit.
+**First run** (no `~/.harness/state.json`): semantic Setup (Detect → Agents →
+Components → Preview → Confirm) → full-screen Control Center.
 
-**Later runs** (state present): full-screen Control Center that explains what Kairo
-does, shows coverage/integrity, evidence-backed proposals, and the next governance
-action (scan → evidence → preview → confirm → apply → re-scan → recovery). Runs stay
-secondary. Layout adapts to terminal size:
+**Later runs** (state present): semantic Cockpit — Overview, Governance, Activity,
+Orchestration, Usage, Settings — plus Alerts inbox. Layout adapts to terminal size:
 
 | Mode | Size | Layout |
 |------|------|--------|
-| Wide | ≥100 cols × ≥28 rows | Nav + Home/content + system |
-| Compact | ≥72×20 | Nav + Home/content (readiness embedded) |
-| Minimal | 60–71 cols or short height | Selected section + essential readiness/next/recent |
+| Wide | ≥100 cols × ≥28 rows | TopBar + nav strip + main panel + footer |
+| Compact | ≥72×20 | Same single-panel shell (tighter lists) |
+| Minimal | 60–71 cols or short height | Selected section + essential readiness/next |
 | Below gate | <60 cols | Explicit TTY fallback (Ink disabled) |
 
-Keys: `↑↓` navigate (selection explanation updates) · `Enter` open ·
-`Esc` back (exit only from Home) · `R` refresh/retry · `C` cancel run · `?` help.
-`Tab` switches region only when content is interactive (run lists / New run).
+Keys: `↑↓` navigate · `Enter` open/activate · `/` actions palette ·
+`Esc` back (exit only from Overview) · `R` refresh/retry · `C` cancel run ·
+`?` help. `Tab` switches region when content is interactive (runs, alerts,
+Activity, Settings, launch).
 
-Navigation labels: Home · Running now · History · Agents · New run · System health.
+Navigation: Overview · Governance · Activity · Orchestration · Usage · Settings.
+
+### Monitor (opt-in)
+
+```bash
+kairo monitor enable
+kairo monitor status
+kairo monitor tick
+kairo monitor disable
+```
+
+Scans governance drift and orphan/failed runs into the alert store. On macOS,
+`enable` can install a LaunchAgent; other OS degrade honestly. Notifications fire
+only when a new alert claim succeeds.
+
+### Settings (curated integrations)
+
+Settings browses a curated catalog (pinned `pi-usage-widget@0.2.1`, MIT).
+Preview → confirm shows an in-session confirmation receipt (`wroteFiles: false`);
+it does not persist or install anything.
+
+### Usage evidence
+
+Usage shows measured budget pairs, profile limits, and finite run `tokenUsage`
+fields only. It never invents totals, costs, or savings.
 
 Respects `NO_COLOR`, `HARNESS_ASCII=1`, and `HARNESS_INK=0`. Status is always labeled
 in text, never color alone.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kal-elsam/kairo-runtime",
-  "version": "0.8.0",
+  "version": "0.10.0",
   "description": "Kairo Runtime — local agent operating system for Codex, Cursor, Claude, Pi, Engram, and Graphify.",
   "type": "module",
   "homepage": "https://github.com/Kal-elSam/harness#readme",

package/scripts/cockpit-smoke.mjs

@@ -26,7 +26,7 @@ const root = join(dirname(fileURLToPath(import.meta.url)), "..");
 const require = createRequire(import.meta.url);
 const pkg = require(join(root, "package.json"));
 
-assert.equal(pkg.version, "0.8.0");
+assert.equal(pkg.version, "0.10.0");
 assert.ok(pkg.dependencies["ansi-escapes"]);
 
 assert.equal(resolveLayoutMode({ columns: 120, rows: 40 }), LAYOUT_MODES.WIDE);
@@ -85,7 +85,7 @@ const asciiNav = buildNavModel({
 assert.equal(asciiNav.items[1].marker, ">");
 assert.equal(asciiNav.items[0].current, true);
 assert.equal(asciiNav.items[1].selected, true);
-assert.match(asciiNav.explanation, /Detected agents|IDEs|models|Harness|modules/i);
+assert.match(asciiNav.explanation, /Repair|Govern|Activity|Usage|Settings|Overview/i);
 
 function applyKey(state, keyAction) {
   const routed = routeCockpitKey(state, keyAction);
@@ -98,7 +98,7 @@ function smokeNavigation(layoutMode) {
     layoutMode,
     region: layoutMode === LAYOUT_MODES.MINIMAL ? COCKPIT_REGIONS.CONTENT : COCKPIT_REGIONS.NAV
   });
-  const diagnosticsIndex = COCKPIT_NAV.findIndex((item) => item.id === "changes");
+  const diagnosticsIndex = COCKPIT_NAV.findIndex((item) => item.id === "governance");
   while (state.navIndex < diagnosticsIndex) {
     state = applyKey(state, { type: "arrow", direction: "down" });
   }
@@ -108,7 +108,7 @@ function smokeNavigation(layoutMode) {
 
   state = applyKey(state, { type: "arrow", direction: "up" });
   state = applyKey(state, { type: "enter" });
-  assert.equal(state.view, ORCHESTRATOR_VIEWS.MODULES);
+  assert.equal(state.view, ORCHESTRATOR_VIEWS.HOME);
   assert.equal(state.region, COCKPIT_REGIONS.NAV);
 
   const footer = buildFooterModel({
@@ -132,7 +132,7 @@ const proposalLines = formatProposalLines([
     id: "setup-local",
     severity: "high",
     title: "Finish local setup",
-    destination: "changes",
+    destination: "setup",
     evidence: [{ type: "status", source: "status.overall", ref: "missing" }]
   }
 ], {
@@ -143,7 +143,7 @@ const proposalLines = formatProposalLines([
     requestBudgetTokens: 10
   }
 });
-assert.match(proposalLines.join("\n"), /\[HIGH\] Finish local setup → changes/);
+assert.match(proposalLines.join("\n"), /\[HIGH\] Finish local setup → setup/);
 assert.match(proposalLines.join("\n"), /Budget · stable 1\/10/);
 assert.match(proposalLines.join("\n"), /evidence: status\.overall/);
 

package/scripts/ux-prototype-tty.mjs

@@ -0,0 +1,9 @@
+#!/usr/bin/env node
+/** Manual TTY gate: Home → Setup → Overview. No writes. Esc exits. */
+import React from "react";
+import { render } from "ink";
+import { TaskFlowApp } from "../src/global/ink/ux/task-flow-app.js";
+
+const app = render(React.createElement(TaskFlowApp, {
+  onExit: () => app.unmount()
+}));

package/src/cli.js

@@ -39,6 +39,7 @@ import { runOrchestratorDiagnostics, runOrchestratorShell } from "./global/orche
 import { runIntelligenceCli } from "./global/intelligence-cli.js";
 import { runGlobalRun, runGlobalRuns } from "./global/runtime/run-cli.js";
 import { runGlobalReview, runGlobalReviews } from "./global/runtime/review/review-cli.js";
+import { runGlobalMonitor } from "./global/runtime/monitor/monitor-cli.js";
 import { normalizeRunStrategy } from "./global/runtime/run-strategy.js";
 import {
   LEGACY_PACKAGE_NAME,
@@ -119,6 +120,9 @@ export async function runCli(argv) {
     case "reviews":
       await runGlobalReviews(optionsWithPolicy, packageManifest);
       return;
+    case "monitor":
+      await runGlobalMonitor(optionsWithPolicy, packageManifest, { packageRoot });
+      return;
     case "intelligence":
       await runIntelligenceCli(optionsWithPolicy, packageManifest);
       return;
@@ -423,6 +427,10 @@ export function parseArgs(argv) {
     parseIntelligenceAction(args, options);
   }
 
+  if (command === "monitor") {
+    parseMonitorAction(args, options);
+  }
+
   for (let index = 0; index < args.length; index += 1) {
     const arg = args[index];
 
@@ -678,6 +686,19 @@ function parseReviewsAction(args, options) {
   }
 }
 
+function parseMonitorAction(args, options) {
+  const action = args[0];
+  if (!action || action.startsWith("-")) {
+    options.monitorAction = "status";
+    return;
+  }
+  if (!new Set(["enable", "disable", "status", "tick"]).has(action)) {
+    throw new Error(`Unknown monitor action "${action}". Use enable, disable, status, or tick.`);
+  }
+  args.shift();
+  options.monitorAction = action;
+}
+
 function parseIntelligenceAction(args, options) {
   const action = args[0];
   if (!action || action.startsWith("-")) {
@@ -736,6 +757,7 @@ function normalizeCommand(command) {
   if (command === "runs") return "runs";
   if (command === "review") return "review";
   if (command === "reviews") return "reviews";
+  if (command === "monitor") return "monitor";
   if (command === "intelligence" || command === "intel") return "intelligence";
   if (command === "setup") return "setup";
   if (command === "status") return "status";
@@ -863,6 +885,7 @@ Commands:
   runs       List, inspect, or cancel agent runs under ~/.harness/runs/.
   review     Bounded read-only review via Codex or Pi; receipts under ~/.harness/reviews/.
   reviews    List or show prior review receipts (secret-free).
+  monitor    Opt-in anomaly monitor (enable|disable|status|tick). macOS LaunchAgent; notify shell:false.
   orchestrator  Read-only capability registry diagnostics (--json supported).
   intelligence  Harness Engineering layer: backends, context packs, routing, budgets.
              Local-first (Ollama). Cloud only with --cloud-consent.
@@ -891,7 +914,7 @@ Commands:
 
 JSON output (--json on supported commands):
   status, sync, doctor, adapters, explain, diff, history, history last,
-  policy (show/set/reset), report
+  policy (show/set/reset), report, monitor
   Human text remains the default. See README.md for examples and field notes.
 
 Version:

package/src/global/control-plane-proposals.js

@@ -12,6 +12,7 @@ export const PROPOSAL_SEVERITY = Object.freeze({
 });
 
 export const PROPOSAL_DESTINATION = Object.freeze({
+  SETUP: "setup",
   CHANGES: "changes",
   CONTROL_CENTER: "control-center",
   IDES: "ides",
@@ -48,7 +49,7 @@ export function buildControlPlaneProposals({
       PROPOSAL_SEVERITY.HIGH,
       "Finish local setup",
       status?.nextAction ?? "Configure the local ecosystem before applying repairs.",
-      PROPOSAL_DESTINATION.CHANGES,
+      PROPOSAL_DESTINATION.SETUP,
       [
         ev("status", "status.overall", status?.overall ?? "missing"),
         ev("health", "control-plane.health", health ?? "NOT_CONFIGURED")

package/src/global/control-plane-snapshot.js

@@ -66,7 +66,7 @@ export function resolveControlPlaneCta({ health, status, diff } = {}) {
         title: "Finish local setup",
         detail: status?.nextAction
           ?? `Run ${formatCliCommand("setup")} to configure the local ecosystem.`,
-        destination: "changes"
+        destination: "setup"
       };
     case CONTROL_PLANE_HEALTH.ACTION_REQUIRED:
       return {

package/src/global/global-doctor.js

@@ -11,6 +11,7 @@ import {
   BACKEND_IDS,
   inspectIntelligenceBackends
 } from "./intelligence/index.js";
+import { monitorDoctorCheck } from "./runtime/monitor/monitor.js";
 
 export async function runGlobalDoctorChecks(homeDir, {
   packageRoot,
@@ -43,6 +44,7 @@ export async function runGlobalDoctorChecks(homeDir, {
   }
 
   checks.push(await intelligenceProvidersCheck({ env, fetchImpl, inspectBackends }));
+  checks.push(await monitorDoctorCheck(homeDir));
 
   const hasMissing = checks.some((check) => check.status === "missing");
   const hasStale = checks.some((check) => check.status === "stale");

package/src/global/ink/cockpit/primitives.js

@@ -1,6 +1,6 @@
 import React from "react";
 import { Box, Text } from "ink";
-import { COCKPIT_COLORS, statusColor } from "../theme.js";
+import { COCKPIT_COLORS, resolveInkColor, statusColor } from "../theme.js";
 
 export function CockpitBadge({ label, kind = "ready", colorEnabled = true }) {
   return React.createElement(Text, {
@@ -8,53 +8,81 @@ export function CockpitBadge({ label, kind = "ready", colorEnabled = true }) {
   }, label);
 }
 
-export function CockpitEmptyState({ title, message, hint }) {
+export function CockpitEmptyState({ title, message, hint, colorEnabled = true }) {
   return React.createElement(Box, { flexDirection: "column", marginY: 1 },
-    title && React.createElement(Text, { bold: true, color: COCKPIT_COLORS.secondary }, title),
+    title && React.createElement(Text, {
+      bold: true,
+      color: resolveInkColor(colorEnabled, COCKPIT_COLORS.secondary)
+    }, title),
     message && React.createElement(Text, null, message),
-    hint && React.createElement(Text, { color: COCKPIT_COLORS.muted }, hint)
+    hint && React.createElement(Text, {
+      color: resolveInkColor(colorEnabled, COCKPIT_COLORS.muted)
+    }, hint)
   );
 }
 
-export function CockpitPanel({ title, focused = false, width, children }) {
+export function CockpitPanel({ title, focused = false, width, children, colorEnabled = true }) {
   return React.createElement(Box, {
     flexDirection: "column",
     width,
     borderStyle: "single",
-    borderColor: focused ? COCKPIT_COLORS.primary : COCKPIT_COLORS.muted,
+    borderColor: resolveInkColor(
+      colorEnabled,
+      focused ? COCKPIT_COLORS.primary : COCKPIT_COLORS.muted
+    ),
     paddingX: 1,
     flexGrow: 1
   },
     title && React.createElement(Text, {
       bold: true,
-      color: focused ? COCKPIT_COLORS.primary : COCKPIT_COLORS.secondary
+      color: resolveInkColor(
+        colorEnabled,
+        focused ? COCKPIT_COLORS.primary : COCKPIT_COLORS.secondary
+      )
+    }, title),
+    children
+  );
+}
+
+export function CockpitSection({ title, children, colorEnabled = true }) {
+  return React.createElement(Box, { flexDirection: "column", marginBottom: 1 },
+    title && React.createElement(Text, {
+      bold: true,
+      color: resolveInkColor(colorEnabled, COCKPIT_COLORS.secondary)
     }, title),
     children
   );
 }
 
+export function CockpitKeyHint({ keys, label, colorEnabled = true }) {
+  return React.createElement(Text, {
+    color: resolveInkColor(colorEnabled, COCKPIT_COLORS.muted)
+  }, `${keys} ${label}`);
+}
+
 export function CockpitTopBar({ model, colorEnabled = true }) {
   return React.createElement(Box, { justifyContent: "space-between", width: "100%" },
     React.createElement(Text, {
       bold: true,
-      color: colorEnabled ? COCKPIT_COLORS.primary : undefined
+      color: resolveInkColor(colorEnabled, COCKPIT_COLORS.primary)
     }, `╭─ ${model.brand} ─ ${model.status}`),
     React.createElement(Text, {
-      color: colorEnabled ? COCKPIT_COLORS.muted : undefined
+      color: resolveInkColor(colorEnabled, COCKPIT_COLORS.muted)
     }, `${model.projectLabel} ─╮`)
   );
 }
 
+/** Vertical nav list (legacy / tests). Prefer CockpitNavStrip in the shell. */
 export function CockpitNav({ model, colorEnabled = true }) {
   return React.createElement(Box, { flexDirection: "column" },
     model.items.map((item) => {
       const suffix = item.current && !item.selected ? " (open)" : "";
       const color = item.focused
-        ? (colorEnabled ? COCKPIT_COLORS.primary : undefined)
+        ? resolveInkColor(colorEnabled, COCKPIT_COLORS.primary)
         : item.selected
-          ? (colorEnabled ? COCKPIT_COLORS.secondary : undefined)
+          ? resolveInkColor(colorEnabled, COCKPIT_COLORS.secondary)
           : item.current
-            ? (colorEnabled ? COCKPIT_COLORS.muted : undefined)
+            ? resolveInkColor(colorEnabled, COCKPIT_COLORS.muted)
             : undefined;
       return React.createElement(Text, {
         key: item.id,
@@ -63,16 +91,75 @@ export function CockpitNav({ model, colorEnabled = true }) {
       }, `${item.marker} ${item.label}${suffix}`);
     }),
     model.explanation && React.createElement(Text, {
-      color: COCKPIT_COLORS.muted
+      color: resolveInkColor(colorEnabled, COCKPIT_COLORS.muted)
     }, model.explanation)
   );
 }
 
+function stripLabel(item, { compact }) {
+  if (!compact) return item.label;
+  return item.label.split(/[&·]/)[0].trim().split(/\s+/)[0];
+}
+
+/** Horizontal navigation strip under the top bar. */
+export function CockpitNavStrip({
+  model,
+  colorEnabled = true,
+  layoutMode = "compact",
+  focused = false
+}) {
+  const compact = layoutMode !== "wide";
+  const parts = model.items.map((item) => {
+    const label = stripLabel(item, { compact });
+    const suffix = item.current && !item.selected ? "*" : "";
+    const color = item.focused
+      ? resolveInkColor(colorEnabled, COCKPIT_COLORS.primary)
+      : item.selected
+        ? resolveInkColor(colorEnabled, COCKPIT_COLORS.secondary)
+        : resolveInkColor(colorEnabled, COCKPIT_COLORS.muted);
+    return React.createElement(Text, {
+      key: item.id,
+      bold: item.focused || item.selected,
+      color
+    }, `${item.marker}${label}${suffix}`);
+  });
+
+  const joined = [];
+  parts.forEach((node, index) => {
+    if (index > 0) {
+      joined.push(React.createElement(Text, {
+        key: `sep-${index}`,
+        color: resolveInkColor(colorEnabled, COCKPIT_COLORS.muted)
+      }, " · "));
+    }
+    joined.push(node);
+  });
+
+  return React.createElement(Box, {
+    flexDirection: "column",
+    width: "100%",
+    borderStyle: "single",
+    borderColor: resolveInkColor(
+      colorEnabled,
+      focused ? COCKPIT_COLORS.primary : COCKPIT_COLORS.muted
+    ),
+    paddingX: 1
+  },
+    React.createElement(Box, { flexDirection: "row", flexWrap: "wrap" }, ...joined),
+    model.explanation && React.createElement(Text, {
+      color: resolveInkColor(colorEnabled, COCKPIT_COLORS.muted)
+    }, model.explanation)
+  );
+}
+
+/** Kept for model tests; no longer rendered in the shell. */
 export function CockpitSystemStrip({ model, colorEnabled = true }) {
   return React.createElement(Box, { flexDirection: "column" },
     model.rows.map((row) =>
       React.createElement(Text, { key: row.key },
-        React.createElement(Text, { color: COCKPIT_COLORS.muted }, `${row.key.padEnd(7)}`),
+        React.createElement(Text, {
+          color: resolveInkColor(colorEnabled, COCKPIT_COLORS.muted)
+        }, `${row.key.padEnd(7)}`),
         React.createElement(CockpitBadge, {
           label: row.value,
           kind: row.kind,
@@ -83,56 +170,46 @@ export function CockpitSystemStrip({ model, colorEnabled = true }) {
   );
 }
 
-export function CockpitFooter({ model }) {
-  return React.createElement(Box, { flexDirection: "column" },
-    React.createElement(Text, { color: COCKPIT_COLORS.muted },
-      `├${"─".repeat(62)}┤`
-    ),
-    React.createElement(Text, { color: COCKPIT_COLORS.muted }, `│ ${model.text}`),
-    React.createElement(Text, { color: COCKPIT_COLORS.muted },
-      `╰${"─".repeat(62)}╯`
-    )
+export function CockpitFooter({ model, columns = 80, colorEnabled = true }) {
+  const width = Math.max(24, Math.min(Number(columns) || 80, 120));
+  const bar = Math.max(20, width - 2);
+  const muted = resolveInkColor(colorEnabled, COCKPIT_COLORS.muted);
+  return React.createElement(Box, { flexDirection: "column", width: "100%" },
+    React.createElement(Text, { color: muted }, `├${"─".repeat(bar)}┤`),
+    React.createElement(Text, { color: muted }, `│ ${model.text}`),
+    React.createElement(Text, { color: muted }, `╰${"─".repeat(bar)}╯`)
   );
 }
 
+/**
+ * Responsive single-panel shell: TopBar → NavStrip → Main → Footer.
+ * SYSTEM side column removed (diagnostics via Enter/detail in later slices).
+ */
 export function CockpitShell({
   topBar,
   footer,
   layoutMode,
   nav,
-  system,
   navFocused,
   contentFocused,
-  systemFocused,
   colorEnabled = true,
+  columns = 80,
   children
 }) {
-  const showNav = layoutMode === "wide" || layoutMode === "compact";
-  const showSystem = layoutMode === "wide";
-
   return React.createElement(Box, { flexDirection: "column", width: "100%" },
     React.createElement(CockpitTopBar, { model: topBar, colorEnabled }),
-    layoutMode === "minimal" && nav && React.createElement(Box, { marginY: 0 },
-      React.createElement(Text, { color: COCKPIT_COLORS.muted }, "Nav: "),
-      React.createElement(CockpitNav, { model: nav, colorEnabled })
-    ),
-    React.createElement(Box, { flexDirection: "row", width: "100%" },
-      showNav && React.createElement(CockpitPanel, {
-        title: nav?.title ?? "NAVIGATION",
-        focused: navFocused,
-        width: 22
-      }, React.createElement(CockpitNav, { model: nav, colorEnabled })),
-      React.createElement(CockpitPanel, {
-        title: undefined,
-        focused: contentFocused,
-        width: showSystem ? 48 : showNav ? 56 : "100%"
-      }, children),
-      showSystem && React.createElement(CockpitPanel, {
-        title: system?.title ?? "SYSTEM",
-        focused: systemFocused,
-        width: 20
-      }, React.createElement(CockpitSystemStrip, { model: system, colorEnabled }))
-    ),
-    React.createElement(CockpitFooter, { model: footer })
+    nav && React.createElement(CockpitNavStrip, {
+      model: nav,
+      colorEnabled,
+      layoutMode,
+      focused: navFocused
+    }),
+    React.createElement(CockpitPanel, {
+      title: undefined,
+      focused: contentFocused,
+      width: "100%",
+      colorEnabled
+    }, children),
+    React.createElement(CockpitFooter, { model: footer, columns, colorEnabled })
   );
 }

package/src/global/ink/cockpit-alerts.js

@@ -0,0 +1,36 @@
+import { ALERT_STATES } from "../runtime/alerts/alert-types.js";
+
+export function formatAlertsHeadline(alerts = null) {
+  if (alerts == null) return { count: null, headline: "Alert data unavailable" };
+  const count = alerts.filter((alert) => alert.state === ALERT_STATES.OPEN).length;
+  return { count, headline: count === 0 ? "None pending" : `${count} pending` };
+}
+
+export function formatAlertListLines(alerts = null) {
+  if (alerts == null) return ["Alert data unavailable"];
+  const open = alerts.filter((alert) => alert.state === ALERT_STATES.OPEN);
+  if (open.length === 0) return ["No pending alerts."];
+  return open.map((alert) => {
+    const when = String(alert.createdAt ?? "").slice(0, 16).replace("T", " ");
+    return `${alert.severity} · ${alert.title} · ${when || "unknown time"}`;
+  });
+}
+
+export function formatAlertDetailLines(alert) {
+  if (!alert) return ["Alert not found."];
+  return [
+    "SUMMARY",
+    `${alert.severity} · ${alert.state} · ${alert.kind}`,
+    alert.title,
+    alert.summary || "No summary.",
+    "",
+    "DETAILS",
+    `Id · ${alert.alertId}`,
+    `Source · ${alert.source ?? "n/a"} · Created · ${alert.createdAt ?? "n/a"}`
+  ];
+}
+
+export function selectAlertFromList(alerts = null, index = 0) {
+  if (!Array.isArray(alerts)) return null;
+  return alerts.filter((alert) => alert.state === ALERT_STATES.OPEN)[index] ?? null;
+}