@kal-elsam/kairo-runtime 0.8.0 → 0.9.0

package/README.md

@@ -35,23 +35,43 @@ kairo
 **First run** (no `~/.harness/state.json`): interactive onboarding → safe diagnosis →
 setup with confirmation → full-screen operations cockpit.
 
-**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): full-screen Control Center oriented around user
+tasks — overall health, one next action, activity, pending alerts, and guided
+governance (scan → evidence → preview → confirm → apply → re-scan → recovery).
+Runs stay secondary. 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.
 
 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.9.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.9.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({

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/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

@@ -33,6 +33,22 @@ export function CockpitPanel({ title, focused = false, width, children }) {
   );
 }
 
+export function CockpitSection({ title, children }) {
+  return React.createElement(Box, { flexDirection: "column", marginBottom: 1 },
+    title && React.createElement(Text, {
+      bold: true,
+      color: COCKPIT_COLORS.secondary
+    }, title),
+    children
+  );
+}
+
+export function CockpitKeyHint({ keys, label, colorEnabled = true }) {
+  return React.createElement(Text, {
+    color: colorEnabled ? COCKPIT_COLORS.muted : undefined
+  }, `${keys} ${label}`);
+}
+
 export function CockpitTopBar({ model, colorEnabled = true }) {
   return React.createElement(Box, { justifyContent: "space-between", width: "100%" },
     React.createElement(Text, {
@@ -45,6 +61,7 @@ export function CockpitTopBar({ model, colorEnabled = true }) {
   );
 }
 
+/** 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) => {
@@ -68,6 +85,62 @@ export function CockpitNav({ model, colorEnabled = true }) {
   );
 }
 
+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
+      ? (colorEnabled ? COCKPIT_COLORS.primary : undefined)
+      : item.selected
+        ? (colorEnabled ? COCKPIT_COLORS.secondary : undefined)
+        : item.current
+          ? (colorEnabled ? COCKPIT_COLORS.muted : undefined)
+          : (colorEnabled ? COCKPIT_COLORS.muted : undefined);
+    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: colorEnabled ? COCKPIT_COLORS.muted : undefined
+      }, " · "));
+    }
+    joined.push(node);
+  });
+
+  return React.createElement(Box, {
+    flexDirection: "column",
+    width: "100%",
+    borderStyle: "single",
+    borderColor: focused ? COCKPIT_COLORS.primary : COCKPIT_COLORS.muted,
+    paddingX: 1
+  },
+    React.createElement(Box, { flexDirection: "row", flexWrap: "wrap" }, ...joined),
+    model.explanation && React.createElement(Text, {
+      color: 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) =>
@@ -83,56 +156,48 @@ export function CockpitSystemStrip({ model, colorEnabled = true }) {
   );
 }
 
-export function CockpitFooter({ model }) {
-  return React.createElement(Box, { flexDirection: "column" },
+export function CockpitFooter({ model, columns = 80 }) {
+  const width = Math.max(24, Math.min(Number(columns) || 80, 120));
+  const bar = Math.max(20, width - 2);
+  return React.createElement(Box, { flexDirection: "column", width: "100%" },
     React.createElement(Text, { color: COCKPIT_COLORS.muted },
-      `├${"─".repeat(62)}┤`
+      `├${"─".repeat(bar)}┤`
     ),
     React.createElement(Text, { color: COCKPIT_COLORS.muted }, `│ ${model.text}`),
     React.createElement(Text, { color: COCKPIT_COLORS.muted },
-      `╰${"─".repeat(62)}╯`
+      `╰${"─".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%"
+    }, children),
+    React.createElement(CockpitFooter, { model: footer, columns })
   );
 }

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;
+}

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

@@ -1,4 +1,4 @@
-import { formatProposalLines, proposalLimitForLayout } from "./cockpit-proposals.js";
+import { formatConfirmPath } from "./cockpit-path-label.js";
 
 export const CHANGES_PHASE = Object.freeze({
   IDLE: "idle",
@@ -62,53 +62,77 @@ export function reduceChangesAction(state, action) {
   }
 }
 
-export function formatChangesActionLines({ snapshot, changesAction, layoutMode = "compact" }) {
-  const diff = snapshot?.diff;
+function healthLabel(kind) {
+  return String(kind ?? "unknown").replaceAll("_", " ");
+}
+
+/**
+ * Governance surface: status, coverage, recommended action first.
+ * Paths only when detail=true or during confirm (home-relative / distinct).
+ */
+export function formatChangesActionLines({
+  snapshot,
+  changesAction,
+  detail = false,
+  homeDir = null
+} = {}) {
   const phase = changesAction?.phase ?? CHANGES_PHASE.IDLE;
-  const lines = [`Changes · ${phase}`];
+  const coverage = snapshot?.coverage ?? {};
+  const diff = snapshot?.diff;
+  const cta = snapshot?.cta;
+  const pending = diff?.hasChanges
+    ? (diff.changeCount ?? diff.changes?.length ?? 0)
+    : 0;
+  const lines = [
+    "STATUS",
+    `${healthLabel(snapshot?.health)}${pending > 0 ? ` · ${pending} pending` : " · drift clean"}`,
+    "",
+    "COVERAGE",
+    `${coverage.governedAgents ?? 0}/${coverage.detectedAgents ?? 0} agents governed · ${coverage.components ?? 0} components`,
+    "",
+    "NEXT",
+    cta?.title ?? "Review governance when ready"
+  ];
+  if (cta?.detail) lines.push(cta.detail);
 
-  const proposalLines = formatProposalLines(snapshot?.proposals ?? [], {
-    limit: proposalLimitForLayout(layoutMode),
-    destinationFilter: "changes",
-    budgets: snapshot?.budgets ?? null
-  });
-  if (proposalLines[0] !== "No proposals targeting this view.") {
-    lines.push(...proposalLines, "");
+  if (changesAction?.message) lines.push("", changesAction.message);
+  if (changesAction?.error && changesAction.error !== "setup-required") {
+    lines.push(`Error: ${changesAction.error}`);
   }
 
-  if (changesAction?.message) lines.push(changesAction.message);
-  if (changesAction?.error && changesAction.error !== "setup-required") lines.push(`Error: ${changesAction.error}`);
-
   const preview = changesAction?.preview;
-  if (preview?.hasChanges) {
-    lines.push(`${preview.changes?.length ?? 0} planned change(s)`);
-    for (const change of preview.changes ?? []) {
-      lines.push(`${change.action ?? change.kind} · ${change.target} · ${change.status ?? "planned"}`);
-    }
-    if (preview.integrations?.status && preview.integrations.status !== "skipped") {
-      lines.push(`SDD lifecycle · ${preview.integrations.status}${preview.integrations.partial ? " (partial)" : ""}`);
-    }
-    if (preview.fingerprint) lines.push(`Fingerprint · ${preview.fingerprint.slice(0, 12)}…`);
-  } else if (diff && !preview) {
-    if (!diff.installed) lines.push(diff.summary ?? "Setup required before changes can be previewed.");
-    else if (!diff.hasChanges) lines.push(diff.summary ?? "No pending governance changes.");
-    else {
-      lines.push(diff.summary ?? "Pending changes");
-      for (const change of diff.changes ?? []) lines.push(`${change.action ?? change.kind} · ${change.target} · ${change.status}`);
+  const planned = preview?.hasChanges
+    ? (preview.changes ?? [])
+    : (diff?.hasChanges && !preview ? (diff.changes ?? []) : []);
+  if (planned.length > 0) {
+    lines.push("", `${planned.length} planned change(s)`);
+    const showDetail = detail || phase === CHANGES_PHASE.CONFIRMING;
+    if (showDetail) {
+      lines.push("DETAILS");
+      const limit = detail ? 12 : 3;
+      for (const change of planned.slice(0, limit)) {
+        lines.push(
+          `${change.action ?? change.kind} · ${formatConfirmPath(change.target, homeDir)}`
+        );
+      }
+      if (planned.length > limit) lines.push(`… ${planned.length - limit} more`);
     }
   } else if (!diff) {
-    lines.push("Scan did not include diff yet. Press R to re-scan.");
+    lines.push("", "Scan did not include diff yet. Press R to re-scan.");
+  } else if (!diff.installed) {
+    lines.push("", diff.summary ?? "Setup required before changes can be previewed.");
+  } else if (!diff.hasChanges && !changesAction?.message) {
+    lines.push("", diff.summary ?? "No pending governance changes.");
   }
 
   const receipt = changesAction?.receipt;
   if (receipt) {
-    lines.push("", `Receipt · ${receipt.action}`);
-    if (receipt.backups?.length) lines.push(`Backups · ${receipt.backups.length}`);
-    if (receipt.checksBefore && receipt.checksAfter) {
+    lines.push("", `Result · ${receipt.action}${receipt.partial ? " (partial)" : ""}`);
+    if (receipt.backups?.length) lines.push(`${receipt.backups.length} backup(s) retained`);
+    if (detail && receipt.checksBefore && receipt.checksAfter) {
+      lines.push("DETAILS");
       lines.push(`Checks · before ok=${receipt.checksBefore.ok} → after ok=${receipt.checksAfter.ok}`);
     }
-    if (receipt.integrations) lines.push(`Integrations · ${receipt.integrations.status ?? "n/a"}`);
-    if (receipt.partial) lines.push("Partial evidence retained — success not claimed.");
   }
 
   if (phase === CHANGES_PHASE.IDLE || phase === CHANGES_PHASE.COMPLETED || phase === CHANGES_PHASE.FAILED) {