@kal-elsam/kairo-runtime 0.10.0 → 0.12.0

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

@@ -12,7 +12,7 @@ export function CockpitEmptyState({ title, message, hint, colorEnabled = true })
   return React.createElement(Box, { flexDirection: "column", marginY: 1 },
     title && React.createElement(Text, {
       bold: true,
-      color: resolveInkColor(colorEnabled, COCKPIT_COLORS.secondary)
+      color: resolveInkColor(colorEnabled, COCKPIT_COLORS.brand)
     }, title),
     message && React.createElement(Text, null, message),
     hint && React.createElement(Text, {
@@ -21,23 +21,20 @@ export function CockpitEmptyState({ title, message, hint, colorEnabled = true })
   );
 }
 
+/** Content region — no border; focus is conveyed by interactive children. */
 export function CockpitPanel({ title, focused = false, width, children, colorEnabled = true }) {
   return React.createElement(Box, {
     flexDirection: "column",
     width,
-    borderStyle: "single",
-    borderColor: resolveInkColor(
-      colorEnabled,
-      focused ? COCKPIT_COLORS.primary : COCKPIT_COLORS.muted
-    ),
-    paddingX: 1,
+    paddingX: 0,
+    marginY: 1,
     flexGrow: 1
   },
     title && React.createElement(Text, {
       bold: true,
       color: resolveInkColor(
         colorEnabled,
-        focused ? COCKPIT_COLORS.primary : COCKPIT_COLORS.secondary
+        focused ? COCKPIT_COLORS.interactive : COCKPIT_COLORS.brand
       )
     }, title),
     children
@@ -48,7 +45,7 @@ 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)
+      color: resolveInkColor(colorEnabled, COCKPIT_COLORS.brand)
     }, title),
     children
   );
@@ -60,15 +57,29 @@ export function CockpitKeyHint({ keys, label, colorEnabled = true }) {
   }, `${keys} ${label}`);
 }
 
+/** Compact header: brand · status · project — no box-drawing. */
 export function CockpitTopBar({ model, colorEnabled = true }) {
+  const statusKind = String(model.status ?? "").toUpperCase() === "ONLINE"
+    ? "online"
+    : "muted";
   return React.createElement(Box, { justifyContent: "space-between", width: "100%" },
-    React.createElement(Text, {
-      bold: true,
-      color: resolveInkColor(colorEnabled, COCKPIT_COLORS.primary)
-    }, `╭─ ${model.brand} ─ ${model.status}`),
+    React.createElement(Box, null,
+      React.createElement(Text, {
+        bold: true,
+        color: resolveInkColor(colorEnabled, COCKPIT_COLORS.brand)
+      }, model.brand),
+      React.createElement(Text, {
+        color: resolveInkColor(colorEnabled, COCKPIT_COLORS.muted)
+      }, " · "),
+      React.createElement(CockpitBadge, {
+        label: model.status,
+        kind: statusKind,
+        colorEnabled
+      })
+    ),
     React.createElement(Text, {
       color: resolveInkColor(colorEnabled, COCKPIT_COLORS.muted)
-    }, `${model.projectLabel} ─╮`)
+    }, model.projectLabel)
   );
 }
 
@@ -78,9 +89,9 @@ export function CockpitNav({ model, colorEnabled = true }) {
     model.items.map((item) => {
       const suffix = item.current && !item.selected ? " (open)" : "";
       const color = item.focused
-        ? resolveInkColor(colorEnabled, COCKPIT_COLORS.primary)
+        ? resolveInkColor(colorEnabled, COCKPIT_COLORS.interactive)
         : item.selected
-          ? resolveInkColor(colorEnabled, COCKPIT_COLORS.secondary)
+          ? resolveInkColor(colorEnabled, COCKPIT_COLORS.brand)
           : item.current
             ? resolveInkColor(colorEnabled, COCKPIT_COLORS.muted)
             : undefined;
@@ -101,7 +112,7 @@ function stripLabel(item, { compact }) {
   return item.label.split(/[&·]/)[0].trim().split(/\s+/)[0];
 }
 
-/** Horizontal navigation strip under the top bar. */
+/** Segmented horizontal nav — no border; active segment uses interactive. */
 export function CockpitNavStrip({
   model,
   colorEnabled = true,
@@ -112,16 +123,20 @@ export function CockpitNavStrip({
   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)
+    const active = item.focused || item.selected;
+    const color = item.focused || (focused && item.selected)
+      ? resolveInkColor(colorEnabled, COCKPIT_COLORS.interactive)
       : item.selected
-        ? resolveInkColor(colorEnabled, COCKPIT_COLORS.secondary)
+        ? resolveInkColor(colorEnabled, COCKPIT_COLORS.interactive)
         : resolveInkColor(colorEnabled, COCKPIT_COLORS.muted);
+    const text = focused && item.selected
+      ? `[${label}]${suffix}`
+      : `${item.marker}${label}${suffix}`;
     return React.createElement(Text, {
       key: item.id,
-      bold: item.focused || item.selected,
+      bold: active,
       color
-    }, `${item.marker}${label}${suffix}`);
+    }, text);
   });
 
   const joined = [];
@@ -138,12 +153,8 @@ export function CockpitNavStrip({
   return React.createElement(Box, {
     flexDirection: "column",
     width: "100%",
-    borderStyle: "single",
-    borderColor: resolveInkColor(
-      colorEnabled,
-      focused ? COCKPIT_COLORS.primary : COCKPIT_COLORS.muted
-    ),
-    paddingX: 1
+    marginTop: 0,
+    marginBottom: 0
   },
     React.createElement(Box, { flexDirection: "row", flexWrap: "wrap" }, ...joined),
     model.explanation && React.createElement(Text, {
@@ -170,20 +181,19 @@ export function CockpitSystemStrip({ model, colorEnabled = true }) {
   );
 }
 
+/** Single-line shortcut bar — no framed box. */
 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)}╯`)
+  return React.createElement(Box, { width: "100%", marginTop: 1 },
+    React.createElement(Text, {
+      color: resolveInkColor(colorEnabled, COCKPIT_COLORS.muted)
+    }, String(model.text ?? "").slice(0, width))
   );
 }
 
 /**
  * Responsive single-panel shell: TopBar → NavStrip → Main → Footer.
- * SYSTEM side column removed (diagnostics via Enter/detail in later slices).
+ * No nested borders — hierarchy via type and spacing.
  */
 export function CockpitShell({
   topBar,

package/src/global/ink/cockpit-control-center.js

@@ -5,13 +5,30 @@ import {
   formatMeasuredBudgets,
   formatUsageLinesFromModel
 } from "./cockpit-usage.js";
+import { LAYOUT_MODES } from "./layout.js";
+import {
+  formatSystemResourcesLines,
+  formatResourceAdviceLines
+} from "./system-resources-display.js";
+import { formatEcosystemUpdateLines } from "./ecosystem-updates-display.js";
+
+const HERMES_WIDE_SESSION_LIMIT = 3;
+const HERMES_TITLE_MAX = 48;
+
+export {
+  diskFreeTone,
+  formatSystemResourcesLines,
+  formatResourceAdviceLines
+} from "./system-resources-display.js";
+export { formatEcosystemUpdateLines } from "./ecosystem-updates-display.js";
 
 export function buildControlCenterModel({
   projectName = "project",
   snapshot = null,
   dashboard = null,
-  layoutMode = "compact",
-  alerts = null
+  layoutMode = LAYOUT_MODES.COMPACT,
+  alerts = null,
+  companion = null
 } = {}) {
   if (!snapshot) {
     return {
@@ -49,7 +66,9 @@ export function buildControlCenterModel({
       activity: { headline: "No activity yet" },
       alerts: formatAlertsHeadline(alerts),
       tokens: { headline: "Data unavailable" },
-      includeEmbeddedStatus: layoutMode !== "wide",
+      companion: null,
+      companionNextAction: null,
+      includeEmbeddedStatus: layoutMode !== LAYOUT_MODES.WIDE,
       runsSecondaryHint: "Detail via Enter · / actions"
     };
   }
@@ -94,11 +113,92 @@ export function buildControlCenterModel({
     },
     alerts: formatAlertsHeadline(alerts),
     tokens: { headline: formatTokenHeadline(snapshot.budgets) },
-    includeEmbeddedStatus: layoutMode !== "wide",
+    companion: formatCompanionOverlay(companion, layoutMode),
+    companionNextAction: companion?.nextSafeAction ?? null,
+    includeEmbeddedStatus: layoutMode !== LAYOUT_MODES.WIDE,
     runsSecondaryHint: "Detail via Enter · / actions"
   };
 }
 
+/**
+ * Observe-only Hermes activity lines for Cockpit overlay.
+ * Never includes session ids, baseUrl, diagnostics dumps, or control affordances.
+ */
+export function formatHermesActivityLines(activity, layoutMode = LAYOUT_MODES.COMPACT) {
+  if (activity == null || typeof activity !== "object") {
+    return ["Hermes · unavailable"];
+  }
+  const state = typeof activity.state === "string" && activity.state.length > 0
+    ? activity.state
+    : "error";
+  if (state !== "available" && state !== "partial") {
+    return [`Hermes · ${state}`];
+  }
+
+  const agg = activity.aggregates && typeof activity.aggregates === "object"
+    ? activity.aggregates
+    : {};
+  const active = Number.isInteger(agg.activeCount) ? agg.activeCount : null;
+  const ended = Number.isInteger(agg.endedCount) ? agg.endedCount : null;
+  const bits = [`Hermes · ${state}`];
+  if (active != null) bits.push(`${active} active`);
+  if (layoutMode !== LAYOUT_MODES.MINIMAL && ended != null) {
+    bits.push(`${ended} ended`);
+  }
+  const lines = [bits.join(" · ")];
+
+  if (layoutMode !== LAYOUT_MODES.WIDE) return lines;
+
+  const sessions = Array.isArray(activity.sessions) ? activity.sessions : [];
+  for (const session of sessions.slice(0, HERMES_WIDE_SESSION_LIMIT)) {
+    const label = hermesSessionLabel(session);
+    if (label) lines.push(`  · ${label}`);
+  }
+  if (agg.hasMore === true || sessions.length > HERMES_WIDE_SESSION_LIMIT) {
+    lines.push("  · … more sessions");
+  }
+  return lines;
+}
+
+function hermesSessionLabel(session) {
+  if (session == null || typeof session !== "object" || Array.isArray(session)) return null;
+  const title = typeof session.title === "string" && session.title.trim()
+    ? session.title.trim()
+    : null;
+  const source = typeof session.source === "string" && session.source.trim()
+    ? session.source.trim()
+    : null;
+  const head = (title ?? source ?? "untitled")
+    .replace(/[\r\n\t]+/g, " ")
+    .slice(0, HERMES_TITLE_MAX);
+  const flag = session.active === true ? "active" : "ended";
+  return `${head} · ${flag}`;
+}
+
+function formatCompanionOverlay(companion, layoutMode = LAYOUT_MODES.COMPACT) {
+  if (!companion) return null;
+  const g = companion.signals?.gentle?.state ?? "unknown";
+  const gy = companion.signals?.graphify;
+  const graphBit = gy?.graphStatus ? `/${gy.graphStatus}` : "";
+  const en = companion.engram?.status ?? "unknown";
+  const links = companion.links?.length ?? 0;
+  return {
+    ok: companion.ok !== false,
+    lines: [
+      `Gentle · ${g}`,
+      `Graphify · ${gy?.state ?? "unknown"}${graphBit}`,
+      `Engram · ${en}`,
+      `Soft links · ${links}`,
+      ...formatHermesActivityLines(companion.signals?.hermes?.activity, layoutMode),
+      ...formatSystemResourcesLines(companion.signals?.system?.resources, layoutMode),
+      ...formatResourceAdviceLines(companion.signals?.system?.advice, layoutMode),
+      ...formatEcosystemUpdateLines(companion.signals?.ecosystem?.updates, layoutMode)
+    ],
+    links: companion.links ?? [],
+    error: companion.error ?? null
+  };
+}
+
 function formatHealthLabel(kind) {
   switch (kind) {
     case CONTROL_PLANE_HEALTH.NOT_CONFIGURED:

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

@@ -12,7 +12,8 @@ export async function loadCockpitScanBundle({
   cliVersion,
   buildDashboard,
   buildDiagnostics,
-  buildSnapshot
+  buildSnapshot,
+  buildCompanion = null
 }) {
   const [dashboard, diagnostics, snapshot] = await Promise.all([
     buildDashboard({ homeDir, workspaceRoot, cliVersion }),
@@ -26,7 +27,24 @@ export async function loadCockpitScanBundle({
       ...CONTROL_PLANE_AUTO_SCAN
     })
   ]);
-  return { dashboard, diagnostics, snapshot };
+  let companion = null;
+  if (typeof buildCompanion === "function") {
+    try {
+      companion = await buildCompanion({
+        homeDir, workspaceRoot, packageName, packageRoot, cliVersion, dashboard, snapshot
+      });
+    } catch (error) {
+      const detail = error instanceof Error ? error.message : String(error);
+      companion = {
+        ok: false, error: detail, signals: null, engram: null, links: [], alertsCount: null,
+        nextSafeAction: {
+          kind: "investigate", title: "Investigate companion diagnostics",
+          detail, secondary: true, displayOnly: true
+        }
+      };
+    }
+  }
+  return { dashboard, diagnostics, snapshot, companion };
 }
 
 /**

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

@@ -111,7 +111,8 @@ export function renderCockpitView({
         model: controlCenter,
         detailsOpen: overviewDetailsOpen,
         colorEnabled,
-        unicode
+        unicode,
+        layoutMode
       });
     case ORCHESTRATOR_VIEWS.USAGE:
       return React.createElement(SemanticUsagePanel, {

package/src/global/ink/ecosystem-updates-display.js

@@ -0,0 +1,37 @@
+import { LAYOUT_MODES } from "./layout.js";
+
+/** Display-only ecosystem update lines for Cockpit companion overlay. */
+export function formatEcosystemUpdateLines(updates, layoutMode = LAYOUT_MODES.COMPACT) {
+  if (updates == null || typeof updates !== "object") return ["Updates · unavailable"];
+  const state = typeof updates.state === "string" && updates.state ? updates.state : "error";
+  const tools = updates.tools && typeof updates.tools === "object" ? updates.tools : {};
+  const pending = ["kairo", "hermes", "gentle", "skills"]
+    .map((id) => tools[id])
+    .filter((t) => t && t.updateAvailable === true);
+  const cache = updates.cacheHit === true ? " · cache" : "";
+
+  if (state !== "available" && state !== "partial" && pending.length === 0) {
+    return [`Updates · ${state}${cache}`];
+  }
+
+  const lines = [
+    pending.length > 0
+      ? `Updates · ${pending.length} available${cache}`
+      : `Updates · current${cache}`
+  ];
+  if (layoutMode === LAYOUT_MODES.MINIMAL) return lines;
+
+  for (const tool of pending.slice(0, layoutMode === LAYOUT_MODES.WIDE ? 4 : 2)) {
+    const inst = tool.installed ?? "—";
+    const latest = tool.latest ?? "—";
+    lines.push(`  · ${tool.id} ${inst} → ${latest}`);
+  }
+  if (pending.length === 0 && layoutMode === LAYOUT_MODES.WIDE) {
+    for (const id of ["kairo", "hermes", "gentle", "skills"]) {
+      const tool = tools[id];
+      if (!tool) continue;
+      lines.push(`  · ${id} · ${tool.state ?? "unknown"}`);
+    }
+  }
+  return lines;
+}

package/src/global/ink/launch-input.js

@@ -1,6 +1,7 @@
 import {
   LAUNCH_PERMISSION_OPTIONS,
   LAUNCH_WIZARD_STEPS,
+  advanceLaunchWizardStep,
   retreatLaunchWizardStep
 } from "./orchestrator-state.js";
 
@@ -92,7 +93,19 @@ export function handleLaunchInput(ctx) {
 
   if (launchStep === LAUNCH_WIZARD_STEPS.CONFIRM) {
     if (key.return) {
-      handleLaunch({ ...launchDraft, permissionIndex: launchPermissionIndex });
+      const next = advanceLaunchWizardStep(LAUNCH_WIZARD_STEPS.CONFIRM, {
+        permissionIndex: launchPermissionIndex
+      });
+      if (next === LAUNCH_WIZARD_STEPS.UNSAFE_CONFIRM) {
+        setLaunchStep(LAUNCH_WIZARD_STEPS.UNSAFE_CONFIRM);
+        return true;
+      }
+      handleLaunch({
+        ...launchDraft,
+        permissionIndex: launchPermissionIndex,
+        allowUnsafePermissions: false,
+        permissionSource: "cockpit"
+      });
       return true;
     }
     if (key.escape) {
@@ -101,6 +114,24 @@ export function handleLaunchInput(ctx) {
     }
   }
 
+  if (launchStep === LAUNCH_WIZARD_STEPS.UNSAFE_CONFIRM) {
+    const answer = String(inputKey ?? "").toLowerCase();
+    if (answer === "y") {
+      handleLaunch({
+        ...launchDraft,
+        permissionIndex: launchPermissionIndex,
+        allowUnsafePermissions: true,
+        permissionSource: "cockpit"
+      });
+      return true;
+    }
+    if (answer === "n" || key.escape) {
+      setLaunchStep(LAUNCH_WIZARD_STEPS.CONFIRM);
+      return allowEscapeRetreat && key.escape ? "retreated" : true;
+    }
+    return true;
+  }
+
   if (inputKey.toLowerCase() === "r") {
     reload().catch(() => {});
     return true;

package/src/global/ink/orchestrator-app.js

@@ -41,7 +41,7 @@ import { handleLaunchInput } from "./launch-input.js";
 import { useTerminalSize } from "./use-terminal-size.js";
 import { useOrchestratorData } from "./use-orchestrator-data.js";
 import { resolveTerminalCapabilities } from "./terminal-capabilities.js";
-import { COCKPIT_COLORS } from "./theme.js";
+import { COCKPIT_COLORS, resolveInkColor } from "./theme.js";
 import { LAYOUT_MODES } from "./layout.js";
 import { CHANGES_PHASE } from "./cockpit-changes.js";
 import { RECOVERY_PHASE, listRecoverySnapshots } from "./cockpit-recovery.js";
@@ -466,14 +466,22 @@ export function OrchestratorApp({
 
   if (data.loading) {
     return React.createElement(Box, { flexDirection: "column" },
-      React.createElement(Text, { bold: true, color: COCKPIT_COLORS.primary }, "KAIRO"),
-      React.createElement(Text, { color: COCKPIT_COLORS.muted }, "Loading cockpit…")
+      React.createElement(Text, {
+        bold: true,
+        color: resolveInkColor(caps.color, COCKPIT_COLORS.brand)
+      }, "KAIRO"),
+      React.createElement(Text, {
+        color: resolveInkColor(caps.color, COCKPIT_COLORS.muted)
+      }, "Loading cockpit…")
     );
   }
 
   if (data.error) {
     return React.createElement(Box, { flexDirection: "column" },
-      React.createElement(Text, { bold: true, color: COCKPIT_COLORS.danger }, "Runtime error"),
+      React.createElement(Text, {
+        bold: true,
+        color: resolveInkColor(caps.color, COCKPIT_COLORS.danger)
+      }, "Runtime error"),
       React.createElement(Text, null, data.error),
       React.createElement(Text, { dimColor: true },
         data.retrying ? "Retrying read-only scan…" : "R Retry · Esc to exit")
@@ -494,7 +502,8 @@ export function OrchestratorApp({
     snapshot: data.snapshot,
     dashboard: data.dashboard,
     layoutMode: mode,
-    alerts: data.alerts
+    alerts: data.alerts,
+    companion: data.companion
   });
   const systemOnline = data.snapshot
     ? data.snapshot.health !== CONTROL_PLANE_HEALTH.NOT_CONFIGURED

package/src/global/ink/orchestrator-state.js

@@ -47,7 +47,8 @@ export const LAUNCH_WIZARD_STEPS = {
   TASK: "task",
   MODEL: "model",
   PERMISSIONS: "permissions",
-  CONFIRM: "confirm"
+  CONFIRM: "confirm",
+  UNSAFE_CONFIRM: "unsafe-confirm"
 };
 
 export const LAUNCH_PERMISSION_OPTIONS = [
@@ -75,7 +76,7 @@ export function resolveLaunchPermissions(draft) {
   return LAUNCH_PERMISSION_OPTIONS[draft.permissionIndex]?.permissions ?? [];
 }
 
-export function advanceLaunchWizardStep(currentStep) {
+export function advanceLaunchWizardStep(currentStep, { permissionIndex = 0 } = {}) {
   switch (currentStep) {
     case LAUNCH_WIZARD_STEPS.AGENT:
       return LAUNCH_WIZARD_STEPS.TASK;
@@ -85,6 +86,10 @@ export function advanceLaunchWizardStep(currentStep) {
       return LAUNCH_WIZARD_STEPS.PERMISSIONS;
     case LAUNCH_WIZARD_STEPS.PERMISSIONS:
       return LAUNCH_WIZARD_STEPS.CONFIRM;
+    case LAUNCH_WIZARD_STEPS.CONFIRM: {
+      const perms = resolveLaunchPermissions({ permissionIndex });
+      return perms.length > 0 ? LAUNCH_WIZARD_STEPS.UNSAFE_CONFIRM : LAUNCH_WIZARD_STEPS.CONFIRM;
+    }
     default:
       return LAUNCH_WIZARD_STEPS.CONFIRM;
   }
@@ -92,6 +97,8 @@ export function advanceLaunchWizardStep(currentStep) {
 
 export function retreatLaunchWizardStep(currentStep) {
   switch (currentStep) {
+    case LAUNCH_WIZARD_STEPS.UNSAFE_CONFIRM:
+      return LAUNCH_WIZARD_STEPS.CONFIRM;
     case LAUNCH_WIZARD_STEPS.CONFIRM:
       return LAUNCH_WIZARD_STEPS.PERMISSIONS;
     case LAUNCH_WIZARD_STEPS.PERMISSIONS:
@@ -147,6 +154,14 @@ export function formatLaunchWizardLines({
     return lines;
   }
 
+  if (step === LAUNCH_WIZARD_STEPS.UNSAFE_CONFIRM) {
+    const label = LAUNCH_PERMISSION_OPTIONS[permissionIndex]?.label ?? "unsafe";
+    lines.push(`Unsafe mode selected: ${label}`);
+    lines.push("This skips agent permission prompts for this run only.");
+    lines.push("Press Y to confirm unsafe launch · N/Esc to go back");
+    return lines;
+  }
+
   lines.push(`Agent: ${draft.agentId ?? "—"}`);
   lines.push(`Task length: ${draft.task.length} chars (content not stored)`);
   lines.push(`Model: ${draft.model || "default"}`);

package/src/global/ink/system-resources-display.js

@@ -0,0 +1,109 @@
+import { LAYOUT_MODES } from "./layout.js";
+
+/** Disk free% tone — never invents a percent. */
+export function diskFreeTone(freePercent) {
+  if (typeof freePercent !== "number" || !Number.isFinite(freePercent)) return null;
+  if (freePercent < 10) return "critical";
+  if (freePercent < 20) return "warning";
+  return "healthy";
+}
+
+function formatBytesShort(bytes) {
+  if (typeof bytes !== "number" || !Number.isFinite(bytes) || bytes < 0) return null;
+  const gib = bytes / (1024 ** 3);
+  if (gib >= 1) return `${Math.round(gib * 10) / 10}G`;
+  const mib = bytes / (1024 ** 2);
+  return `${Math.round(mib)}M`;
+}
+
+function pctLabel(value, suffix = "% free") {
+  if (typeof value !== "number" || !Number.isFinite(value)) return null;
+  return `${value}${suffix}`;
+}
+
+/**
+ * Display-only System resource lines for Cockpit companion overlay.
+ * Never invents metrics; never includes paths, args, or control affordances.
+ */
+export function formatSystemResourcesLines(resources, layoutMode = LAYOUT_MODES.COMPACT) {
+  if (resources == null || typeof resources !== "object") {
+    return ["System · unavailable"];
+  }
+  const state = typeof resources.state === "string" && resources.state.length > 0
+    ? resources.state
+    : "error";
+  if (state !== "available" && state !== "partial") {
+    return [`System · ${state}`];
+  }
+
+  const ram = pctLabel(resources.memory?.freePercent);
+  const swapUsed = formatBytesShort(resources.swap?.usedBytes);
+  const diskPct = resources.disk?.freePercent;
+  const disk = pctLabel(diskPct);
+  const tone = diskFreeTone(diskPct);
+
+  const bits = ["System"];
+  bits.push(ram ? `RAM ${ram}` : "RAM n/a");
+  bits.push(swapUsed ? `Swap ${swapUsed} used` : "Swap n/a");
+  bits.push(disk ? `Disk ${disk}` : "Disk n/a");
+  if (tone && tone !== "healthy") bits.push(tone);
+
+  const lines = [bits.join(" · ")];
+  if (layoutMode === LAYOUT_MODES.MINIMAL) return lines;
+
+  const ramFree = resources.memory?.freePercent;
+  const memoryPressure = typeof ramFree === "number" && Number.isFinite(ramFree) && ramFree < 15;
+  if (memoryPressure) {
+    lines.push("  · Memory pressure · swap elevated relevance");
+  } else {
+    lines.push("  · Swap informational");
+  }
+
+  const proc = resources.processes && typeof resources.processes === "object"
+    ? resources.processes
+    : null;
+  if (proc) {
+    const total = Number.isInteger(proc.totalCount) ? proc.totalCount : null;
+    const zombies = Number.isInteger(proc.zombieCount) ? proc.zombieCount : null;
+    if (total != null && zombies != null) {
+      lines.push(`  · Processes ${total} · zombies ${zombies}`);
+    }
+  }
+
+  if (layoutMode !== LAYOUT_MODES.WIDE) return lines;
+
+  const tracked = Array.isArray(proc?.tracked) ? proc.tracked : [];
+  for (const entry of tracked.slice(0, 4)) {
+    if (entry == null || typeof entry !== "object") continue;
+    if (typeof entry.name !== "string" || !Number.isInteger(entry.count)) continue;
+    lines.push(`  · ${entry.name} ×${entry.count}`);
+  }
+  const thermal = resources.thermal?.state ?? "unavailable";
+  const ssd = resources.ssdWear?.state ?? "unavailable";
+  lines.push(`  · Thermal · ${thermal}`);
+  lines.push(`  · SSD wear · ${ssd}`);
+  return lines;
+}
+
+/** Display-only advisor lines from deterministic recommendations. */
+export function formatResourceAdviceLines(advice, layoutMode = LAYOUT_MODES.COMPACT) {
+  const list = Array.isArray(advice?.recommendations) ? advice.recommendations : [];
+  if (list.length === 0) return ["Advisor · quiet"];
+  const top = list[0];
+  const severity = typeof top.severity === "string" ? top.severity : "info";
+  const title = typeof top.title === "string" ? top.title : "recommendation";
+  const lines = [`Advisor · ${severity} · ${title}`];
+  if (layoutMode === LAYOUT_MODES.MINIMAL) return lines;
+  if (typeof top.detail === "string" && top.detail.length > 0) {
+    lines.push(`  · ${top.detail.slice(0, 96)}`);
+  }
+  if (layoutMode === LAYOUT_MODES.WIDE) {
+    for (const item of list.slice(1, 3)) {
+      if (item == null || typeof item !== "object") continue;
+      const sev = typeof item.severity === "string" ? item.severity : "info";
+      const t = typeof item.title === "string" ? item.title : "recommendation";
+      lines.push(`  · ${sev} · ${t}`);
+    }
+  }
+  return lines;
+}