@kal-elsam/kairo-runtime 0.7.0 → 0.9.0

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

@@ -0,0 +1,98 @@
+import { COCKPIT_NAV } from "./cockpit-models.js";
+import { ORCHESTRATOR_VIEWS } from "./orchestrator-state.js";
+
+export const PALETTE_KINDS = Object.freeze({
+  NAVIGATE: "navigate",
+  REFRESH: "refresh",
+  HELP: "help"
+});
+
+const DESTINATION_VIEWS = Object.freeze({
+  changes: ORCHESTRATOR_VIEWS.CHANGES,
+  governance: ORCHESTRATOR_VIEWS.CHANGES,
+  "control-center": ORCHESTRATOR_VIEWS.HOME,
+  ides: ORCHESTRATOR_VIEWS.IDES,
+  modules: ORCHESTRATOR_VIEWS.MODULES,
+  activity: ORCHESTRATOR_VIEWS.ACTIVITY,
+  profile: ORCHESTRATOR_VIEWS.PROFILE,
+  runs: ORCHESTRATOR_VIEWS.RUNS,
+  orchestration: ORCHESTRATOR_VIEWS.RUNS,
+  usage: ORCHESTRATOR_VIEWS.USAGE,
+  alerts: ORCHESTRATOR_VIEWS.ALERTS
+});
+
+export function resolvePaletteDestination(key) {
+  return DESTINATION_VIEWS[key] ?? null;
+}
+
+export function canOpenPalette({ loading = false, busy = false, confirming = false } = {}) {
+  return !loading && !busy && !confirming;
+}
+
+/** Optional CTA + six destinations + Refresh + Help. No write shortcuts. */
+export function buildPaletteActions({
+  ctaDestination = null,
+  ctaTitle = null,
+  ctaDetail = null,
+  navItems = COCKPIT_NAV
+} = {}) {
+  const actions = [];
+  const recommendedView = resolvePaletteDestination(ctaDestination);
+  if (recommendedView) {
+    actions.push({
+      id: "recommended",
+      kind: PALETTE_KINDS.NAVIGATE,
+      label: ctaTitle?.trim() || "Recommended next action",
+      view: recommendedView,
+      description: ctaDetail?.trim() || "Overview recommended destination."
+    });
+  }
+  for (const item of navItems) {
+    actions.push({
+      id: item.id,
+      kind: PALETTE_KINDS.NAVIGATE,
+      label: item.label,
+      view: item.view,
+      description: item.description
+    });
+  }
+  actions.push({
+    id: "alerts",
+    kind: PALETTE_KINDS.NAVIGATE,
+    label: "Alerts",
+    view: ORCHESTRATOR_VIEWS.ALERTS,
+    description: "Pending alert inbox."
+  });
+  actions.push({
+    id: "refresh",
+    kind: PALETTE_KINDS.REFRESH,
+    label: "Refresh",
+    view: null,
+    description: "Reload the read-only cockpit scan."
+  });
+  actions.push({
+    id: "help",
+    kind: PALETTE_KINDS.HELP,
+    label: "Help",
+    view: ORCHESTRATOR_VIEWS.HELP,
+    description: "Keyboard reference and primary flow."
+  });
+  return actions;
+}
+
+export function buildPaletteModel({ actions = buildPaletteActions(), index = 0, unicode = true } = {}) {
+  const max = Math.max(0, actions.length - 1);
+  const safeIndex = Math.min(Math.max(0, index), max);
+  const focus = unicode ? "›" : ">";
+  return {
+    title: "ACTIONS",
+    hint: "Navigate · Refresh · Help — no writes",
+    items: actions.map((action, i) => ({
+      ...action,
+      marker: i === safeIndex ? focus : " ",
+      selected: i === safeIndex
+    })),
+    selected: actions[safeIndex] ?? null,
+    index: safeIndex
+  };
+}

package/src/global/ink/cockpit-path-label.js

@@ -0,0 +1,19 @@
+/**
+ * Distinguishable path for confirmation / detail disclosure.
+ * Prefer home-relative `~/...`; otherwise keep parent/basename.
+ */
+export function formatConfirmPath(target, homeDir = null) {
+  const raw = String(target ?? "").trim();
+  if (!raw) return "target";
+  const normalized = raw.replaceAll("\\", "/");
+  if (normalized === "~" || normalized.startsWith("~/")) return normalized;
+
+  const home = homeDir ? String(homeDir).replaceAll("\\", "/").replace(/\/$/, "") : "";
+  if (home && (normalized === home || normalized.startsWith(`${home}/`))) {
+    return `~${normalized.slice(home.length)}`;
+  }
+
+  const parts = normalized.split("/").filter(Boolean);
+  if (parts.length >= 2) return parts.slice(-2).join("/");
+  return parts[0] || normalized;
+}

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

@@ -1,3 +1,5 @@
+import { formatConfirmPath } from "./cockpit-path-label.js";
+
 export const RECOVERY_PHASE = Object.freeze({
   IDLE: "idle",
   PREVIEWING: "previewing",
@@ -73,40 +75,101 @@ export function listRecoverySnapshots(snapshot) {
   return snapshot?.backups?.snapshots ?? [];
 }
 
-export function formatRecoveryLines({ snapshot, recoveryAction, listIndex = 0 }) {
+function formatWhen(timestamp) {
+  if (!timestamp) return "unknown time";
+  const raw = String(timestamp);
+  if (/^\d{4}-\d{2}-\d{2}/.test(raw)) return raw.slice(0, 16).replace("T", " ");
+  const date = new Date(raw);
+  if (Number.isNaN(date.getTime())) return raw.slice(0, 16);
+  return date.toISOString().slice(0, 16).replace("T", " ");
+}
+
+function formatResult(action) {
+  const value = String(action ?? "").toLowerCase();
+  if (!value) return "done";
+  if (value === "applied" || value === "ok" || value === "success") return "ok";
+  if (value === "cancelled" || value === "canceled") return "cancelled";
+  if (value.includes("fail")) return "failed";
+  return value;
+}
+
+function shortName(name) {
+  const raw = String(name ?? "").trim();
+  if (!raw) return "snapshot";
+  const parts = raw.split(/[/\\]/).filter(Boolean);
+  return parts[parts.length - 1] || raw;
+}
+
+/**
+ * Activity surface: what agents did, when, and result.
+ * Snapshot restore stays secondary; paths only under DETAILS.
+ */
+export function formatRecoveryLines({
+  snapshot,
+  recoveryAction,
+  listIndex = 0,
+  dashboard = null,
+  detail = false,
+  homeDir = null
+} = {}) {
   const backups = listRecoverySnapshots(snapshot);
   const events = snapshot?.history?.events ?? [];
   const phase = recoveryAction?.phase ?? RECOVERY_PHASE.IDLE;
-  const lines = [
-    `Activity & recovery · ${phase}`,
-    `History: ${events.length} recent event(s)`,
-    ...events.slice(0, 3).map((event) => `${event.command ?? event.type ?? "event"} · ${event.action ?? ""} · ${event.timestamp ?? ""}`),
-    "",
-    `Snapshots: ${snapshot?.backups?.count ?? backups.length}`
-  ];
+  const lines = ["RECENT"];
 
+  const recent = [];
+  for (const event of events.slice(0, 3)) {
+    recent.push(
+      `${formatWhen(event.timestamp)} · ${event.command ?? event.type ?? "event"} · ${formatResult(event.action)}`
+    );
+  }
+  for (const run of (dashboard?.recentRuns ?? []).slice(0, 2)) {
+    recent.push(
+      `${formatWhen(run.updatedAt ?? run.endedAt ?? run.startedAt)} · ${run.agentId ?? "agent"} · ${formatResult(run.state)}`
+    );
+  }
+  if (recent.length === 0) lines.push("No recent agent activity.");
+  else lines.push(...recent.slice(0, 4));
+
+  lines.push("", "SNAPSHOTS");
   if (backups.length === 0) {
     lines.push("No global snapshots yet.");
   } else {
     backups.forEach((entry, index) => {
       const mark = index === listIndex ? "›" : " ";
-      lines.push(`${mark} ${entry.name} · ${entry.fileCount ?? "?"} files`);
+      lines.push(`${mark} ${shortName(entry.name)} · ${entry.fileCount ?? "?"} files`);
     });
   }
 
   if (recoveryAction?.message) lines.push("", recoveryAction.message);
+
   const preview = recoveryAction?.preview;
   if (preview) {
-    lines.push(`Snapshot · ${preview.snapshot}`);
-    for (const file of preview.files ?? []) lines.push(`  restore · ${file.displayPath}`);
-    if (preview.fingerprint) lines.push(`Fingerprint · ${preview.fingerprint.slice(0, 12)}…`);
+    const fileCount = preview.files?.length ?? 0;
+    lines.push(`Restore preview · ${fileCount} file(s)`);
+    if (detail || phase === RECOVERY_PHASE.CONFIRMING) {
+      lines.push("DETAILS");
+      const limit = detail ? 12 : 3;
+      for (const file of (preview.files ?? []).slice(0, limit)) {
+        lines.push(formatConfirmPath(file.displayPath ?? file.path, homeDir));
+      }
+      if ((preview.files?.length ?? 0) > limit) {
+        lines.push(`… ${preview.files.length - limit} more`);
+      }
+    }
   }
+
   const receipt = recoveryAction?.receipt;
   if (receipt) {
-    lines.push("", `Receipt · ${receipt.action}`);
-    if (receipt.safetyBackup) lines.push(`Safety backup · ${receipt.safetyBackup}`);
-    for (const path of receipt.restored ?? []) lines.push(`  restored · ${path}`);
+    const restored = receipt.restored?.length ?? 0;
+    lines.push("", `Result · ${receipt.action ?? "rollback"} · ${restored} restored`);
+    if (detail && receipt.safetyBackup) {
+      lines.push("DETAILS", `Safety backup retained`);
+    } else if (receipt.safetyBackup) {
+      lines.push("Safety backup retained");
+    }
   }
+
   if (phase === RECOVERY_PHASE.IDLE || phase === RECOVERY_PHASE.COMPLETED || phase === RECOVERY_PHASE.FAILED) {
     lines.push("", "Enter preview · Y restore · N/Esc cancel · R re-scan");
   }

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

@@ -22,8 +22,10 @@ export function formatReviewListLines(receipts = []) {
   return receipts.map((receipt) => {
     const counts = countFindingsBySeverity(receipt.findings);
     const findingTotal = (receipt.findings ?? []).length;
-    const created = String(receipt.createdAt ?? "").slice(0, 19).replace("T", " ");
-    return `${receipt.reviewId}  ${String(receipt.state).padEnd(10)}  ${String(receipt.agentId).padEnd(6)}  ${findingTotal}f (h${counts.high}/m${counts.medium}/l${counts.low})  ${created}`;
+    const created = String(receipt.createdAt ?? "").slice(0, 16).replace("T", " ");
+    const agent = String(receipt.agentId ?? "agent");
+    const state = String(receipt.state ?? "unknown");
+    return `${agent} · ${state} · ${findingTotal} findings (h${counts.high}/m${counts.medium}/l${counts.low}) · ${created || "unknown time"}`;
   });
 }
 
@@ -33,15 +35,17 @@ export function formatReviewDetailLines(receipt) {
   const snapshot = receipt.snapshot ?? {};
   const totals = snapshot.totals ?? {};
   const lines = [
-    `Id: ${receipt.reviewId}`,
-    `Agent: ${receipt.agentId}${receipt.model ? ` · model ${receipt.model}` : ""}`,
-    `State: ${receipt.state}`,
-    `Created: ${receipt.createdAt ?? "n/a"}`,
-    `Findings: ${(receipt.findings ?? []).length} (high ${counts.high}, medium ${counts.medium}, low ${counts.low})`,
-    `Snapshot: ${snapshot.mode ?? "n/a"} · files ${totals.fileCount ?? 0} · fingerprint ${String(snapshot.fingerprint ?? "").slice(0, 12) || "n/a"}`
+    "SUMMARY",
+    `${receipt.agentId}${receipt.model ? ` · ${receipt.model}` : ""} · ${receipt.state}`,
+    `Findings · ${(receipt.findings ?? []).length} (high ${counts.high}, medium ${counts.medium}, low ${counts.low})`,
+    `Created · ${receipt.createdAt ?? "n/a"}`,
+    "",
+    "DETAILS",
+    `Id · ${receipt.reviewId}`,
+    `Snapshot · ${snapshot.mode ?? "n/a"} · ${totals.fileCount ?? 0} files`
   ];
   if ((receipt.warnings ?? []).length > 0) {
-    lines.push(`Warnings: ${receipt.warnings.length}`);
+    lines.push(`Warnings · ${receipt.warnings.length}`);
   }
   const findings = receipt.findings ?? [];
   if (findings.length === 0) {
@@ -56,7 +60,7 @@ export function formatReviewDetailLines(receipt) {
     );
   }
   if (findings.length > 20) {
-    lines.push(`  … ${findings.length - 20} more (use kairo reviews show ${receipt.reviewId})`);
+    lines.push(`  … ${findings.length - 20} more`);
   }
   return lines;
 }

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

@@ -5,19 +5,19 @@ export const RUNS_HUB_ITEMS = [
     id: "active",
     label: "Active runs",
     view: ORCHESTRATOR_VIEWS.ACTIVE_RUNS,
-    description: "Inspect and cancel supervised runs that are currently executing."
+    description: "Inspect and cancel supervised runs in flight."
   },
   {
     id: "history",
     label: "History",
     view: ORCHESTRATOR_VIEWS.RECENT_RUNS,
-    description: "Review completed and failed run outcomes."
+    description: "Completed and failed outcomes."
   },
   {
     id: "reviews",
     label: "Reviews",
     view: ORCHESTRATOR_VIEWS.REVIEWS,
-    description: "Browse secret-free bounded-review receipts (read-only)."
+    description: "Secret-free review receipts (read-only)."
   },
   {
     id: "launch",
@@ -51,6 +51,15 @@ export function resolveRunsHubItem(listIndex = 0, items = RUNS_HUB_ITEMS) {
   return items[index] ?? null;
 }
 
+/** Selectable hub labels only — counts belong in the panel title/hint. */
 export function formatRunsHubLines(items = RUNS_HUB_ITEMS) {
-  return items.map((item) => `${item.label} — ${item.description}`);
+  return items.map((item) => item.label);
+}
+
+export function formatOrchestrationStatus({
+  active = 0,
+  recent = 0,
+  reviews = 0
+} = {}) {
+  return `${active} active · ${recent} recent · ${reviews} reviews`;
 }

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

@@ -0,0 +1,194 @@
+/**
+ * Curated Settings catalog — browse → preview → confirm (no filesystem install).
+ */
+
+export const SETTINGS_PHASE = Object.freeze({
+  BROWSE: "browse",
+  PREVIEW: "preview",
+  CONFIRMING: "confirming",
+  COMPLETED: "completed"
+});
+
+export const CURATED_INTEGRATIONS = Object.freeze([
+  Object.freeze({
+    id: "pi-usage-widget",
+    name: "Pi usage widget",
+    version: "0.2.1",
+    license: "MIT",
+    status: "available",
+    capabilities: Object.freeze(["usage-display", "local-only"]),
+    permissions: Object.freeze(["full-local-access-on-install"]),
+    audit: "pending-security-review",
+    summary: "Local Pi package for usage visibility in the agent UI.",
+    notes: "Explicit install only. Never auto-applied by Kairo."
+  })
+]);
+
+export function createSettingsActionState() {
+  return {
+    phase: SETTINGS_PHASE.BROWSE,
+    selectedId: null,
+    message: null,
+    receipt: null
+  };
+}
+
+export function listCuratedIntegrations() {
+  return [...CURATED_INTEGRATIONS];
+}
+
+export function getCuratedIntegration(id) {
+  return CURATED_INTEGRATIONS.find((entry) => entry.id === id) ?? null;
+}
+
+export function reduceSettingsAction(state, action) {
+  switch (action.type) {
+    case "reset":
+      return createSettingsActionState();
+    case "preview": {
+      const entry = getCuratedIntegration(action.id);
+      if (!entry) {
+        return { ...state, phase: SETTINGS_PHASE.BROWSE, message: "Integration not found." };
+      }
+      return {
+        phase: SETTINGS_PHASE.PREVIEW,
+        selectedId: entry.id,
+        message: "Enter Confirm · Esc back — no files written yet.",
+        receipt: null
+      };
+    }
+    case "confirm-prompt":
+      if (state.phase !== SETTINGS_PHASE.PREVIEW || !state.selectedId) return state;
+      return {
+        ...state,
+        phase: SETTINGS_PHASE.CONFIRMING,
+        message: "Confirm explicit install intent? Y confirm · N/Esc cancel"
+      };
+    case "confirm": {
+      if (state.phase !== SETTINGS_PHASE.CONFIRMING || !state.selectedId) return state;
+      const entry = getCuratedIntegration(state.selectedId);
+      return {
+        phase: SETTINGS_PHASE.COMPLETED,
+        selectedId: state.selectedId,
+        message: "Confirmed — no auto-install. Apply via documented Pi/CLI path only.",
+        receipt: {
+          id: state.selectedId,
+          version: entry?.version ?? null,
+          confirmedAt: new Date().toISOString(),
+          wroteFiles: false
+        }
+      };
+    }
+    case "cancel":
+      return {
+        ...createSettingsActionState(),
+        message: "Cancelled — no files written."
+      };
+    default:
+      return state;
+  }
+}
+
+export function formatSettingsBrowseLines(
+  integrations = listCuratedIntegrations(),
+  listIndex = 0
+) {
+  if (integrations.length === 0) return ["No curated integrations available."];
+  return [
+    "CURATED INTEGRATIONS",
+    ...integrations.map((entry, index) => {
+      const mark = index === listIndex ? "›" : " ";
+      return `${mark} ${entry.status} · ${entry.name} · ${entry.version} · ${entry.license}`;
+    }),
+    "",
+    "POLICY",
+    "Browse → preview → confirm. Install stays explicit; never automatic.",
+    "Enter preview · Esc back"
+  ];
+}
+
+export function formatSettingsDetailLines(entry, settingsAction = null) {
+  if (!entry) return ["Integration not found."];
+  const phase = settingsAction?.phase ?? SETTINGS_PHASE.BROWSE;
+
+  // Completed: receipt first so compact TTY (80×24) shows wroteFiles above the fold.
+  if (phase === SETTINGS_PHASE.COMPLETED && settingsAction?.receipt) {
+    const receipt = settingsAction.receipt;
+    return [
+      "RESULT",
+      settingsAction.message ?? "Confirmed — no auto-install.",
+      "RECEIPT",
+      `Id · ${receipt.id} · wroteFiles · ${receipt.wroteFiles}`,
+      `Confirmed · ${receipt.confirmedAt}`,
+      `${entry.name} · ${entry.version} · ${entry.license}`,
+      "Esc back · install stays explicit"
+    ];
+  }
+
+  const lines = [
+    "INTEGRATION",
+    `${entry.name} · ${entry.version}`,
+    `Status · ${entry.status} · License · ${entry.license}`,
+    `Audit · ${entry.audit}`,
+    "",
+    "CAPABILITIES",
+    entry.capabilities.join(" · ") || "none",
+    "",
+    "PERMISSIONS",
+    entry.permissions.join(" · ") || "none",
+    "",
+    "SUMMARY",
+    entry.summary,
+    entry.notes
+  ];
+  if (phase === SETTINGS_PHASE.PREVIEW || phase === SETTINGS_PHASE.CONFIRMING) {
+    lines.push("", "PREVIEW", "No filesystem changes. Confirm only records explicit intent.");
+  }
+  if (settingsAction?.message) lines.push("", settingsAction.message);
+  return lines;
+}
+
+export function formatSettingsLines({
+  listIndex = 0,
+  settingsAction = null,
+  snapshot = null,
+  diagnostics = null
+} = {}) {
+  const integrations = listCuratedIntegrations();
+  const phase = settingsAction?.phase ?? SETTINGS_PHASE.BROWSE;
+  if (phase !== SETTINGS_PHASE.BROWSE && settingsAction?.selectedId) {
+    return formatSettingsDetailLines(
+      getCuratedIntegration(settingsAction.selectedId),
+      settingsAction
+    );
+  }
+
+  const policy = snapshot?.policy;
+  const sources = diagnostics?.profile?.sources;
+  const sourceLabel = sources?.global || sources?.project
+    ? [sources.global ? "global" : null, sources.project ? "project" : null].filter(Boolean).join(", ")
+    : "none";
+  return [
+    ...formatSettingsBrowseLines(integrations, listIndex),
+    "",
+    "PROFILE & POLICY",
+    `Policy · ${policy?.profile ?? "none"} · apply ${policy?.applyMode ?? "n/a"}`,
+    `Preflight · ${policy?.preflight ?? "n/a"} · sources · ${sourceLabel}`,
+    "",
+    `Selected · ${integrations[listIndex]?.id ?? "none"}`
+  ];
+}
+
+export function buildSettingsFooterParts(phase = SETTINGS_PHASE.BROWSE) {
+  switch (phase) {
+    case SETTINGS_PHASE.PREVIEW:
+      return ["Enter Confirm", "Esc Back"];
+    case SETTINGS_PHASE.CONFIRMING:
+      return ["Y Confirm", "N/Esc Cancel"];
+    case SETTINGS_PHASE.COMPLETED:
+      return ["Esc Back", "/ Actions"];
+    case SETTINGS_PHASE.BROWSE:
+    default:
+      return ["↑↓ Select", "Enter Preview", "Esc Nav", "/ Actions"];
+  }
+}