@kal-elsam/kairo-runtime 0.4.3 → 0.5.0

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

@@ -4,6 +4,9 @@ import { resolveProjectReadiness } from "../dashboard-guidance.js";
 import { STATUS_LABELS, resolveGlyphs } from "./theme.js";
 import { windowList } from "./list-window.js";
 import { buildHomeMissionModel, formatHomeRecentRun } from "./cockpit-home.js";
+import { isRunsBranchView } from "./cockpit-runs.js";
+import { buildChangesFooterParts } from "./cockpit-changes.js";
+import { buildRecoveryFooterParts } from "./cockpit-recovery.js";
 
 export const COCKPIT_REGIONS = {
   NAV: "nav",
@@ -14,40 +17,45 @@ export const COCKPIT_REGIONS = {
 export const COCKPIT_NAV = [
   {
     id: "overview",
-    label: "Home",
+    label: "Control center",
     view: ORCHESTRATOR_VIEWS.HOME,
-    description: "What Kairo does here, readiness, and the next useful action."
+    description: "Coverage, integrity, and the next governance action."
   },
   {
-    id: "active",
-    label: "Running now",
-    view: ORCHESTRATOR_VIEWS.ACTIVE_RUNS,
-    description: "Supervised runs executing right now."
+    id: "ides",
+    label: "IDEs & models",
+    view: ORCHESTRATOR_VIEWS.IDES,
+    description: "Detected agents, auth signals, capabilities, and recommended policy."
   },
   {
-    id: "recent",
-    label: "History",
-    view: ORCHESTRATOR_VIEWS.RECENT_RUNS,
-    description: "Past runs with agent, state, and readable result."
+    id: "modules",
+    label: "Harness modules",
+    view: ORCHESTRATOR_VIEWS.MODULES,
+    description: "Orchestrator, SDD/TDD, and external Engram/Graphify integrations."
   },
   {
-    id: "providers",
-    label: "Agents",
-    view: ORCHESTRATOR_VIEWS.PROVIDERS,
-    description: "Installed tools Kairo can launch and audit."
+    id: "changes",
+    label: "Changes",
+    view: ORCHESTRATOR_VIEWS.CHANGES,
+    description: "Findings, drift, and exact preview before any write."
   },
   {
-    id: "launch",
-    label: "New run",
-    view: ORCHESTRATOR_VIEWS.LAUNCH,
-    action: "launch",
-    description: "Delegate a task to an executable agent."
+    id: "activity",
+    label: "Activity & recovery",
+    view: ORCHESTRATOR_VIEWS.ACTIVITY,
+    description: "Kairo operations, backups, and rollback readiness."
   },
   {
-    id: "diagnostics",
-    label: "System health",
-    view: ORCHESTRATOR_VIEWS.DIAGNOSTICS,
-    description: "Agents, intelligence, authentication, and configuration."
+    id: "profile",
+    label: "Profile & policy",
+    view: ORCHESTRATOR_VIEWS.PROFILE,
+    description: "Defaults, scopes, consent, and precedence."
+  },
+  {
+    id: "runs",
+    label: "Runs",
+    view: ORCHESTRATOR_VIEWS.RUNS,
+    description: "Optional supervised execution — Active, History, and New run."
   }
 ];
 
@@ -62,6 +70,10 @@ export function regionsForLayout(layoutMode) {
 }
 
 export function navIndexForView(view, items = COCKPIT_NAV) {
+  if (isRunsBranchView(view)) {
+    const runsIndex = items.findIndex((item) => item.id === "runs");
+    return runsIndex >= 0 ? runsIndex : 0;
+  }
   const index = items.findIndex((item) => item.view === view);
   return index >= 0 ? index : 0;
 }
@@ -82,31 +94,51 @@ export function buildTopBarModel({
   };
 }
 
-export function resolveNavStatusSummary(item, { dashboard = null, diagnostics = null } = {}) {
-  const active = dashboard?.activeRuns?.length ?? 0;
-  const recent = dashboard?.recentRuns?.length ?? 0;
-  const providers = dashboard?.providers ?? [];
+export function resolveNavStatusSummary(item, {
+  dashboard = null,
+  diagnostics = null,
+  snapshot = null
+} = {}) {
+  const active = dashboard?.activeRuns?.length ?? snapshot?.runtime?.activeRuns ?? 0;
+  const providers = dashboard?.providers ?? snapshot?.runtime?.providers ?? [];
   const launchable = providers.filter((entry) => entry.launchable).length;
-  const detected = diagnostics?.diagnostics?.detected ?? providers.filter((p) => p.available).length;
-  const errors = diagnostics?.diagnostics?.errors ?? 0;
+  const detected = snapshot?.coverage?.detectedAgents
+    ?? diagnostics?.diagnostics?.detected
+    ?? providers.filter((p) => p.available).length;
+  const governed = snapshot?.coverage?.governedAgents ?? 0;
+  const changes = snapshot?.diff?.hasChanges
+    ? (snapshot.diff.changeCount ?? snapshot.diff.changes?.length ?? 0)
+    : 0;
+  const backups = snapshot?.backups?.count ?? 0;
 
   switch (item.id) {
     case "overview":
-      return resolveProjectReadiness({
-        hasGlobalState: true,
-        diagnostics,
-        dashboard
-      }).label;
+      return snapshot?.health?.replaceAll("_", " ")
+        ?? resolveProjectReadiness({
+          hasGlobalState: true,
+          diagnostics,
+          dashboard
+        }).label;
+    case "ides":
+      return `${governed}/${detected} governed`;
+    case "modules":
+      return `${snapshot?.coverage?.components ?? 0} modules`;
+    case "changes":
+      return changes > 0 ? `${changes} pending` : "Clean";
+    case "activity":
+      return backups > 0 ? `${backups} backups` : "No backups";
+    case "profile":
+      return snapshot?.policy?.profile ?? "defaults";
+    case "runs":
+      return active === 0 ? "Idle" : `${active} active`;
     case "active":
       return active === 0 ? "Idle" : `${active} active`;
-    case "recent":
-      return recent === 0 ? "No history" : `${recent} recent`;
     case "providers":
       return `${launchable}/${providers.length || detected} ready`;
     case "launch":
       return launchable > 0 ? "Ready" : "Unavailable";
     case "diagnostics":
-      return errors > 0 ? `${errors} issues` : "Checked";
+      return changes > 0 ? `${changes} pending` : "Checked";
     default:
       return "";
   }
@@ -119,27 +151,29 @@ export function buildNavModel({
   unicode = true,
   items = COCKPIT_NAV,
   dashboard = null,
-  diagnostics = null
+  diagnostics = null,
+  snapshot = null
 } = {}) {
   const glyphs = resolveGlyphs(unicode);
   const selected = items[navIndex] ?? items[0];
   const mapped = items.map((item, index) => {
     const isSelected = index === navIndex;
-    const isCurrent = item.view === currentView;
+    const isCurrent = item.view === currentView
+      || (item.id === "runs" && isRunsBranchView(currentView));
     return {
       ...item,
       marker: isSelected ? glyphs.focus : (isCurrent ? glyphs.bullet : " "),
       selected: isSelected,
       current: isCurrent,
       focused: focused && isSelected,
-      statusSummary: resolveNavStatusSummary(item, { dashboard, diagnostics })
+      statusSummary: resolveNavStatusSummary(item, { dashboard, diagnostics, snapshot })
     };
   });
 
   return {
     title: "NAVIGATION",
     explanation: selected
-      ? `${selected.description} (${resolveNavStatusSummary(selected, { dashboard, diagnostics })})`
+      ? `${selected.description} (${resolveNavStatusSummary(selected, { dashboard, diagnostics, snapshot })})`
       : "",
     items: mapped
   };
@@ -186,10 +220,13 @@ export function buildSystemStripModel({
 export function buildFooterModel({
   view = ORCHESTRATOR_VIEWS.HOME,
   region = COCKPIT_REGIONS.NAV,
+  navIndex = 0,
   helpOpen = false,
   canCancel = false,
   unicode = true,
-  hasError = false
+  hasError = false,
+  changesPhase = null,
+  recoveryPhase = null
 } = {}) {
   const glyphs = resolveGlyphs(unicode);
   const parts = [];
@@ -213,24 +250,39 @@ export function buildFooterModel({
     return { text: parts.join(` ${glyphs.bullet} `) };
   }
 
+  if (view === ORCHESTRATOR_VIEWS.CHANGES) {
+    return { text: buildChangesFooterParts(changesPhase).join(` ${glyphs.bullet} `) };
+  }
+
+  if (view === ORCHESTRATOR_VIEWS.ACTIVITY) {
+    return { text: buildRecoveryFooterParts(recoveryPhase).join(` ${glyphs.bullet} `) };
+  }
+
   parts.push("↑↓ Navigate");
 
-  const showTab = view === ORCHESTRATOR_VIEWS.ACTIVE_RUNS
+  const showTab = view === ORCHESTRATOR_VIEWS.RUNS
+    || view === ORCHESTRATOR_VIEWS.ACTIVE_RUNS
     || view === ORCHESTRATOR_VIEWS.RECENT_RUNS
-    || view === ORCHESTRATOR_VIEWS.LAUNCH;
+    || view === ORCHESTRATOR_VIEWS.LAUNCH
+    || view === ORCHESTRATOR_VIEWS.ACTIVITY;
   if (showTab) {
     parts.push("Tab Region");
   }
 
-  if (view === ORCHESTRATOR_VIEWS.HOME
+  const activatesControlCenterCta = view === ORCHESTRATOR_VIEWS.HOME && navIndex === 0;
+  if (activatesControlCenterCta) {
+    parts.push("Enter Activate");
+  } else if (view === ORCHESTRATOR_VIEWS.IDES
+    || view === ORCHESTRATOR_VIEWS.MODULES
+    || view === ORCHESTRATOR_VIEWS.PROFILE
     || view === ORCHESTRATOR_VIEWS.PROVIDERS
     || view === ORCHESTRATOR_VIEWS.DIAGNOSTICS
     || region === COCKPIT_REGIONS.NAV
+    || view === ORCHESTRATOR_VIEWS.RUNS
     || view === ORCHESTRATOR_VIEWS.ACTIVE_RUNS
     || view === ORCHESTRATOR_VIEWS.RECENT_RUNS) {
     parts.push("Enter Open");
   }
-
   if (view !== ORCHESTRATOR_VIEWS.LAUNCH) {
     parts.push("R refresh");
   }

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

@@ -0,0 +1,82 @@
+/**
+ * Read-only proposal presentation for Control Center / Changes.
+ * Links to existing views only — never executes actions.
+ */
+
+export function formatProposalLines(proposals = [], {
+  limit = 6,
+  destinationFilter = null,
+  budgets = null
+} = {}) {
+  const filtered = (proposals ?? []).filter((entry) => {
+    if (!entry?.id || !entry?.title) return false;
+    if (!destinationFilter) return true;
+    return entry.destination === destinationFilter;
+  });
+
+  if (filtered.length === 0) {
+    return destinationFilter
+      ? ["No proposals targeting this view."]
+      : ["No evidence-backed proposals."];
+  }
+
+  const shown = filtered.slice(0, Math.max(1, limit));
+  const lines = [
+    `Proposals · ${shown.length}/${filtered.length} evidence-backed`
+  ];
+
+  const budgetLine = formatProposalBudgetLine(budgets);
+  if (budgetLine) lines.push(budgetLine);
+
+  for (const proposal of shown) {
+    const severity = String(proposal.severity ?? "info").toUpperCase();
+    const destination = proposal.destination ?? "control-center";
+    lines.push(`[${severity}] ${proposal.title} → ${destination}`);
+    const evidence = formatProposalEvidenceSource(proposal.evidence);
+    if (evidence) lines.push(`  evidence: ${evidence}`);
+  }
+
+  if (filtered.length > shown.length) {
+    lines.push(`… ${filtered.length - shown.length} more (open destination views)`);
+  }
+
+  return lines;
+}
+
+export function formatProposalEvidenceSource(evidence = []) {
+  const sources = [];
+  const seen = new Set();
+  for (const item of evidence ?? []) {
+    const source = String(item?.source ?? "").trim();
+    if (!source || seen.has(source)) continue;
+    seen.add(source);
+    sources.push(source);
+    if (sources.length >= 3) break;
+  }
+  return sources.join(" · ") || null;
+}
+
+export function formatProposalBudgetLine(budgets) {
+  if (!budgets || typeof budgets !== "object") return null;
+  const parts = [];
+  if (Number.isFinite(budgets.stableUsedTokens) && Number.isFinite(budgets.stableBudgetTokens)) {
+    parts.push(`stable ${budgets.stableUsedTokens}/${budgets.stableBudgetTokens}`);
+  }
+  if (Number.isFinite(budgets.requestUsedTokens) && Number.isFinite(budgets.requestBudgetTokens)) {
+    parts.push(`request ${budgets.requestUsedTokens}/${budgets.requestBudgetTokens}`);
+  }
+  if (parts.length === 0) return null;
+  return `Budget · ${parts.join(" · ")}`;
+}
+
+export function proposalLimitForLayout(layoutMode = "compact") {
+  switch (layoutMode) {
+    case "wide":
+      return 6;
+    case "minimal":
+      return 3;
+    case "compact":
+    default:
+      return 4;
+  }
+}

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

@@ -0,0 +1,120 @@
+export const RECOVERY_PHASE = Object.freeze({
+  IDLE: "idle",
+  PREVIEWING: "previewing",
+  CONFIRMING: "confirming",
+  APPLYING: "applying",
+  COMPLETED: "completed",
+  FAILED: "failed"
+});
+
+export function createRecoveryActionState() {
+  return {
+    phase: RECOVERY_PHASE.IDLE,
+    preview: null,
+    receipt: null,
+    error: null,
+    message: null,
+    selectedSnapshot: null
+  };
+}
+
+export function reduceRecoveryAction(state, action) {
+  switch (action.type) {
+    case "reset":
+      return createRecoveryActionState();
+    case "preview-start":
+      return {
+        ...createRecoveryActionState(),
+        phase: RECOVERY_PHASE.PREVIEWING,
+        selectedSnapshot: action.snapshot ?? null,
+        message: `Previewing rollback · ${action.snapshot ?? "?"}`
+      };
+    case "preview-ready":
+      return {
+        phase: RECOVERY_PHASE.CONFIRMING,
+        preview: action.preview,
+        receipt: null,
+        error: null,
+        selectedSnapshot: action.preview?.snapshot ?? state.selectedSnapshot,
+        message: action.preview?.noop
+          ? "Snapshot has nothing to restore."
+          : "Confirm restore? Y restore · N/Esc cancel"
+      };
+    case "preview-failed":
+      return {
+        ...state,
+        phase: RECOVERY_PHASE.FAILED,
+        error: action.error ?? "preview-failed",
+        message: action.message ?? "Rollback preview failed.",
+        preview: state.preview
+      };
+    case "apply-start":
+      return { ...state, phase: RECOVERY_PHASE.APPLYING, message: "Restoring snapshot…" };
+    case "apply-done":
+      return {
+        phase: action.ok ? RECOVERY_PHASE.COMPLETED : RECOVERY_PHASE.FAILED,
+        preview: action.preview ?? state.preview,
+        receipt: action.receipt ?? null,
+        error: action.ok ? null : (action.reason ?? "apply-failed"),
+        selectedSnapshot: state.selectedSnapshot,
+        message: action.message ?? (action.ok ? "Rollback complete." : "Rollback failed.")
+      };
+    case "cancel":
+      return {
+        ...createRecoveryActionState(),
+        message: "Cancelled — previous snapshot kept, no restore written."
+      };
+    default:
+      return state;
+  }
+}
+
+export function listRecoverySnapshots(snapshot) {
+  return snapshot?.backups?.snapshots ?? [];
+}
+
+export function formatRecoveryLines({ snapshot, recoveryAction, listIndex = 0 }) {
+  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}`
+  ];
+
+  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`);
+    });
+  }
+
+  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 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}`);
+  }
+  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");
+  }
+  return lines;
+}
+
+export function buildRecoveryFooterParts(phase) {
+  if (phase === RECOVERY_PHASE.PREVIEWING || phase === RECOVERY_PHASE.APPLYING) return ["Working…", "Esc Back"];
+  if (phase === RECOVERY_PHASE.CONFIRMING) return ["Y Restore", "N/Esc Cancel"];
+  return ["↑↓ Select", "Enter Preview", "R Re-scan", "Esc Back"];
+}

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

@@ -0,0 +1,47 @@
+import { ORCHESTRATOR_VIEWS } from "./orchestrator-state.js";
+
+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."
+  },
+  {
+    id: "history",
+    label: "History",
+    view: ORCHESTRATOR_VIEWS.RECENT_RUNS,
+    description: "Review completed and failed run outcomes."
+  },
+  {
+    id: "launch",
+    label: "New run",
+    view: ORCHESTRATOR_VIEWS.LAUNCH,
+    action: "launch",
+    description: "Start a supervised run after governance is healthy."
+  }
+];
+
+export function isRunsBranchView(view) {
+  return view === ORCHESTRATOR_VIEWS.RUNS
+    || view === ORCHESTRATOR_VIEWS.ACTIVE_RUNS
+    || view === ORCHESTRATOR_VIEWS.RECENT_RUNS
+    || view === ORCHESTRATOR_VIEWS.LAUNCH
+    || view === ORCHESTRATOR_VIEWS.RUN_DETAIL;
+}
+
+export function isRunsChildView(view) {
+  return view === ORCHESTRATOR_VIEWS.ACTIVE_RUNS
+    || view === ORCHESTRATOR_VIEWS.RECENT_RUNS
+    || view === ORCHESTRATOR_VIEWS.LAUNCH;
+}
+
+export function resolveRunsHubItem(listIndex = 0, items = RUNS_HUB_ITEMS) {
+  if (items.length === 0) return null;
+  const index = Math.min(Math.max(0, listIndex), items.length - 1);
+  return items[index] ?? null;
+}
+
+export function formatRunsHubLines(items = RUNS_HUB_ITEMS) {
+  return items.map((item) => `${item.label} — ${item.description}`);
+}

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

@@ -0,0 +1,60 @@
+export const CONTROL_PLANE_AUTO_SCAN = Object.freeze({
+  includeDiff: true,
+  includeExplain: false,
+  includeRuntime: false
+});
+
+export async function loadCockpitScanBundle({
+  homeDir,
+  workspaceRoot,
+  packageName,
+  packageRoot,
+  cliVersion,
+  buildDashboard,
+  buildDiagnostics,
+  buildSnapshot
+}) {
+  const [dashboard, diagnostics, snapshot] = await Promise.all([
+    buildDashboard({ homeDir, workspaceRoot, cliVersion }),
+    buildDiagnostics({ homeDir, workspaceRoot, packageName, packageRoot, cliVersion }),
+    buildSnapshot({
+      homeDir,
+      workspaceRoot,
+      packageName,
+      packageRoot,
+      cliVersion,
+      ...CONTROL_PLANE_AUTO_SCAN
+    })
+  ]);
+  return { dashboard, diagnostics, snapshot };
+}
+
+/**
+ * Serialize overlapping reloads and drop stale completions.
+ * Callers keep prior error/loading until a non-stale success updates state.
+ */
+export function createSerializedReloader(runLoad) {
+  let generation = 0;
+  let tail = Promise.resolve();
+
+  return function reload() {
+    const gen = ++generation;
+    const job = async () => {
+      try {
+        const result = await runLoad();
+        if (gen !== generation) {
+          return { stale: true, result: null, error: null };
+        }
+        return { stale: false, result, error: null };
+      } catch (error) {
+        if (gen !== generation) {
+          return { stale: true, result: null, error: null };
+        }
+        return { stale: false, result: null, error };
+      }
+    };
+    const next = tail.then(job, job);
+    tail = next.then(() => undefined, () => undefined);
+    return next;
+  };
+}