@kal-elsam/kairo-runtime 0.8.0 → 0.10.0

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) {
@@ -119,6 +143,6 @@ export function formatChangesActionLines({ snapshot, changesAction, layoutMode =
 
 export function buildChangesFooterParts(phase) {
   if (phase === CHANGES_PHASE.PREVIEWING || phase === CHANGES_PHASE.APPLYING) return ["Working…", "Esc Back"];
-  if (phase === CHANGES_PHASE.CONFIRMING) return ["Y Apply", "N/Esc Cancel"];
-  return ["A Preview", "R Re-scan", "Esc Back"];
+  if (phase === CHANGES_PHASE.CONFIRMING) return ["Y Apply", "N/Esc Cancel", "Space"];
+  return ["A Preview", "R Re-scan", "Space", "Esc Back"];
 }

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

@@ -1,20 +1,32 @@
 import { CONTROL_PLANE_HEALTH } from "../control-plane-snapshot.js";
-import { formatProposalLines, proposalLimitForLayout } from "./cockpit-proposals.js";
+import { formatAlertsHeadline } from "./cockpit-alerts.js";
+import {
+  adaptUsageModel,
+  formatMeasuredBudgets,
+  formatUsageLinesFromModel
+} from "./cockpit-usage.js";
 
 export function buildControlCenterModel({
   projectName = "project",
   snapshot = null,
-  layoutMode = "compact"
+  dashboard = null,
+  layoutMode = "compact",
+  alerts = null
 } = {}) {
   if (!snapshot) {
     return {
-      title: `CONTROL CENTER — ${projectName}`,
-      purpose: "Kairo aligns installed IDEs and agents with this project's architecture, rules, tools, and workflows.",
+      title: `OVERVIEW — ${projectName}`,
+      purpose: "",
       health: {
         kind: CONTROL_PLANE_HEALTH.CHECK_FAILED,
         label: "CHECK FAILED",
         summaryLine: "Control-plane scan not available yet."
       },
+      status: {
+        kind: CONTROL_PLANE_HEALTH.CHECK_FAILED,
+        label: "CHECK FAILED",
+        summaryLine: "Control-plane scan not available yet."
+      },
       coverageLines: [],
       cta: {
         title: "NEXT",
@@ -24,54 +36,66 @@ export function buildControlCenterModel({
         kind: "verify",
         destination: null
       },
+      nextAction: {
+        title: "NEXT",
+        actionTitle: "Retry scan",
+        actionDetail: "Press R to reload the read-only governance scan.",
+        enterHint: "R Retry",
+        kind: "verify",
+        destination: null
+      },
       notes: [],
-      proposalLines: ["No evidence-backed proposals."],
-      includeEmbeddedStatus: layoutMode !== "wide"
+      proposalLines: [],
+      activity: { headline: "No activity yet" },
+      alerts: formatAlertsHeadline(alerts),
+      tokens: { headline: "Data unavailable" },
+      includeEmbeddedStatus: layoutMode !== "wide",
+      runsSecondaryHint: "Detail via Enter · / actions"
     };
   }
 
   const healthLabel = formatHealthLabel(snapshot.health);
   const coverage = snapshot.coverage ?? {};
-  const policy = snapshot.policy;
-  const warnings = snapshot.status?.counts?.warning ?? 0;
+  const active = dashboard?.activeRuns?.length ?? snapshot.runtime?.activeRuns ?? 0;
+  const recent = dashboard?.recentRuns?.[0] ?? null;
+  const health = {
+    kind: snapshot.health,
+    label: healthLabel,
+    summaryLine: [
+      `${coverage.governedAgents ?? 0}/${coverage.detectedAgents ?? 0} agents governed`,
+      snapshot.diff?.hasChanges ? "drift pending" : "drift clean"
+    ].join(" · ")
+  };
+  const cta = {
+    title: "NEXT",
+    actionTitle: snapshot.cta?.title ?? "Review control plane",
+    actionDetail: snapshot.cta?.detail ?? "",
+    enterHint: "Enter again →",
+    kind: snapshot.cta?.kind ?? null,
+    destination: snapshot.cta?.destination ?? null
+  };
 
   return {
-    title: `CONTROL CENTER — ${projectName}`,
-    purpose: "Kairo aligns installed IDEs and agents with this project's architecture, rules, tools, and workflows.",
-    health: {
-      kind: snapshot.health,
-      label: healthLabel,
-      summaryLine: [
-        `${coverage.governedAgents ?? 0}/${coverage.detectedAgents ?? 0} agents governed`,
-        `${coverage.components ?? 0} modules`,
-        `${snapshot.backups?.count ?? 0} backups`
-      ].join(" · ")
-    },
-    coverageLines: [
-      `Active modules: ${(coverage.activeModules ?? []).join(", ") || "none"}`,
-      `Policy: ${policy?.profile ?? "none"} · applyMode ${policy?.applyMode ?? "n/a"}`,
-      warnings > 0
-        ? `Notes: ${warnings} non-blocking check warning(s)`
-        : "Notes: none",
-      snapshot.diff?.hasChanges
-        ? `Drift: ${snapshot.diff.changeCount ?? snapshot.diff.changes?.length ?? 0} change(s) pending review`
-        : "Drift: clean"
-    ],
-    cta: {
-      title: "NEXT",
-      actionTitle: snapshot.cta?.title ?? "Review control plane",
-      actionDetail: snapshot.cta?.detail ?? "",
-      enterHint: "Enter again →",
-      kind: snapshot.cta?.kind ?? null,
-      destination: snapshot.cta?.destination ?? null
+    title: `OVERVIEW — ${projectName}`,
+    purpose: "",
+    health,
+    status: health,
+    coverageLines: [],
+    cta,
+    nextAction: cta,
+    notes: [],
+    proposalLines: [],
+    activity: {
+      headline: active > 0
+        ? `${active} active run${active === 1 ? "" : "s"}`
+        : recent?.agentId
+          ? `Last · ${recent.agentId} · ${recent.state ?? "done"}`
+          : "Idle"
     },
-    notes: buildNotes(snapshot),
-    proposalLines: formatProposalLines(snapshot.proposals ?? [], {
-      limit: proposalLimitForLayout(layoutMode),
-      budgets: snapshot.budgets ?? null
-    }),
+    alerts: formatAlertsHeadline(alerts),
+    tokens: { headline: formatTokenHeadline(snapshot.budgets) },
     includeEmbeddedStatus: layoutMode !== "wide",
-    runsSecondaryHint: "Runs remain available as a secondary capability after setup and repairs."
+    runsSecondaryHint: "Detail via Enter · / actions"
   };
 }
 
@@ -92,15 +116,17 @@ function formatHealthLabel(kind) {
   }
 }
 
-function buildNotes(snapshot) {
-  const notes = [];
-  for (const check of snapshot.status?.checks ?? []) {
-    if (check.status === "warning") {
-      notes.push(`${check.name}: ${check.detail ?? check.status}`);
-    }
-  }
-  if (notes.length === 0 && snapshot.health === CONTROL_PLANE_HEALTH.HEALTHY_WITH_NOTES) {
-    notes.push("Non-blocking notes are present. Open IDEs & models or Harness modules for detail.");
-  }
-  return notes.slice(0, 6);
+function formatTokenHeadline(budgets) {
+  return formatMeasuredBudgets(budgets) ?? "Data unavailable";
+}
+
+/** Usage surface via shared auditable model — never invent totals. */
+export function formatUsageLines({
+  snapshot = null, dashboard = null, layoutMode = undefined
+} = {}) {
+  return formatUsageLinesFromModel(adaptUsageModel({ snapshot, dashboard, layoutMode }));
+}
+
+export function hasAuditableUsage({ snapshot = null, dashboard = null } = {}) {
+  return adaptUsageModel({ snapshot, dashboard }).hasEvidence;
 }

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

@@ -33,7 +33,12 @@ export function createCockpitUiState({
   navIndex = 0,
   listIndex = 0,
   helpOpen = false,
-  returnView = null
+  returnView = null,
+  paletteOpen = false,
+  paletteIndex = 0,
+  overviewDetailsOpen = false,
+  governanceDetailsOpen = false,
+  activityDetailsOpen = false
 } = {}) {
   const regions = regionsForLayout(layoutMode);
   const preferred = region ?? defaultRegionForView(view, layoutMode);
@@ -48,12 +53,57 @@ export function createCockpitUiState({
     listIndex: Math.max(0, listIndex),
     helpOpen,
     returnView,
+    paletteOpen,
+    paletteIndex: Math.max(0, paletteIndex),
+    overviewDetailsOpen: Boolean(overviewDetailsOpen),
+    governanceDetailsOpen: Boolean(governanceDetailsOpen),
+    activityDetailsOpen: Boolean(activityDetailsOpen),
     shouldExit: false
   };
 }
 
+function closePalette(state) {
+  return { ...state, paletteOpen: false, paletteIndex: 0 };
+}
+
 export function reduceCockpitUi(state, action) {
   switch (action.type) {
+    case "toggle-palette":
+      if (state.paletteOpen) return closePalette(state);
+      return { ...state, paletteOpen: true, paletteIndex: 0, helpOpen: false };
+    case "close-palette":
+      return closePalette(state);
+    case "palette-arrow": {
+      const max = Math.max(0, (action.listLength ?? 1) - 1);
+      const delta = action.direction === "up" ? -1 : 1;
+      return {
+        ...state,
+        paletteIndex: clamp(state.paletteIndex + delta, 0, max)
+      };
+    }
+    case "run-palette": {
+      const next = closePalette(state);
+      if (action.kind === "help") {
+        return {
+          ...next,
+          helpOpen: true,
+          view: ORCHESTRATOR_VIEWS.HELP,
+          region: defaultRegionForView(ORCHESTRATOR_VIEWS.HELP, state.layoutMode)
+        };
+      }
+      if (action.kind === "navigate" && action.view) {
+        return {
+          ...next,
+          view: action.view,
+          navIndex: navIndexForView(action.view),
+          listIndex: 0,
+          region: defaultRegionForView(action.view, state.layoutMode),
+          helpOpen: false,
+          returnView: null
+        };
+      }
+      return next;
+    }
     case "resize": {
       const regions = regionsForLayout(action.layoutMode);
       const preferred = regions.includes(state.region)
@@ -95,18 +145,21 @@ export function reduceCockpitUi(state, action) {
     case "enter-nav": {
       const item = COCKPIT_NAV[state.navIndex];
       if (!item) return state;
-      return {
+      return closePalette({
         ...state,
         view: item.view,
         listIndex: 0,
         region: defaultRegionForView(item.view, state.layoutMode),
         helpOpen: false,
-        returnView: null
-      };
+        returnView: null,
+        overviewDetailsOpen: false,
+        governanceDetailsOpen: false,
+        activityDetailsOpen: false
+      });
     }
     case "set-view": {
       const nextView = action.view;
-      return {
+      return closePalette({
         ...state,
         view: nextView,
         listIndex: 0,
@@ -115,20 +168,47 @@ export function reduceCockpitUi(state, action) {
           : clamp(action.navIndex, 0, COCKPIT_NAV.length - 1),
         region: action.region ?? defaultRegionForView(nextView, state.layoutMode),
         returnView: action.returnView ?? state.returnView,
-        helpOpen: nextView === ORCHESTRATOR_VIEWS.HELP
-      };
+        helpOpen: nextView === ORCHESTRATOR_VIEWS.HELP,
+        overviewDetailsOpen: false,
+        governanceDetailsOpen: false,
+        activityDetailsOpen: false
+      });
     }
+    case "toggle-overview-details":
+      if (state.view !== ORCHESTRATOR_VIEWS.HOME) return state;
+      return { ...state, overviewDetailsOpen: !state.overviewDetailsOpen };
+    case "toggle-governance-details":
+      if (state.view !== ORCHESTRATOR_VIEWS.CHANGES) return state;
+      return { ...state, governanceDetailsOpen: !state.governanceDetailsOpen };
+    case "toggle-activity-details":
+      if (state.view !== ORCHESTRATOR_VIEWS.ACTIVITY) return state;
+      return { ...state, activityDetailsOpen: !state.activityDetailsOpen };
     case "toggle-help":
       if (state.helpOpen || state.view === ORCHESTRATOR_VIEWS.HELP) {
         return goOverview(state);
       }
-      return {
+      return closePalette({
         ...state,
         helpOpen: true,
         view: ORCHESTRATOR_VIEWS.HELP,
-        region: defaultRegionForView(ORCHESTRATOR_VIEWS.HELP, state.layoutMode)
-      };
+        region: defaultRegionForView(ORCHESTRATOR_VIEWS.HELP, state.layoutMode),
+        overviewDetailsOpen: false,
+        governanceDetailsOpen: false,
+        activityDetailsOpen: false
+      });
     case "escape": {
+      if (state.paletteOpen) {
+        return closePalette(state);
+      }
+      if (state.view === ORCHESTRATOR_VIEWS.HOME && state.overviewDetailsOpen) {
+        return { ...state, overviewDetailsOpen: false };
+      }
+      if (state.view === ORCHESTRATOR_VIEWS.CHANGES && state.governanceDetailsOpen) {
+        return { ...state, governanceDetailsOpen: false };
+      }
+      if (state.view === ORCHESTRATOR_VIEWS.ACTIVITY && state.activityDetailsOpen) {
+        return { ...state, activityDetailsOpen: false };
+      }
       if (state.helpOpen || state.view === ORCHESTRATOR_VIEWS.HELP) {
         return goOverview(state);
       }
@@ -174,19 +254,22 @@ export function resolveNavAction(navIndex) {
 }
 
 function goOverview(state) {
-  return {
+  return closePalette({
     ...state,
     helpOpen: false,
     view: ORCHESTRATOR_VIEWS.HOME,
     navIndex: 0,
     listIndex: 0,
     region: defaultRegionForView(ORCHESTRATOR_VIEWS.HOME, state.layoutMode),
-    returnView: null
-  };
+    returnView: null,
+    overviewDetailsOpen: false,
+    governanceDetailsOpen: false,
+    activityDetailsOpen: false
+  });
 }
 
 function goRunsHub(state) {
-  return {
+  return closePalette({
     ...state,
     helpOpen: false,
     view: ORCHESTRATOR_VIEWS.RUNS,
@@ -194,5 +277,5 @@ function goRunsHub(state) {
     listIndex: 0,
     region: defaultRegionForView(ORCHESTRATOR_VIEWS.RUNS, state.layoutMode),
     returnView: null
-  };
+  });
 }

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

@@ -14,6 +14,7 @@ export function resolveEnterNavIntent({
   const isOverview = navItem.id === "overview" || navItem.view === ORCHESTRATOR_VIEWS.HOME;
   if (isOverview) {
     if (currentView === ORCHESTRATOR_VIEWS.HOME && ctaDestination) {
+      if (ctaDestination === "setup") return { kind: "activate-setup" };
       return { kind: "activate-cta", destination: ctaDestination };
     }
     return { kind: "open-nav", view: ORCHESTRATOR_VIEWS.HOME };

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

@@ -7,9 +7,9 @@ const NAV_FOCUSED_VIEWS = new Set([
   ORCHESTRATOR_VIEWS.IDES,
   ORCHESTRATOR_VIEWS.MODULES,
   ORCHESTRATOR_VIEWS.CHANGES,
-  ORCHESTRATOR_VIEWS.PROFILE,
   ORCHESTRATOR_VIEWS.PROVIDERS,
   ORCHESTRATOR_VIEWS.DIAGNOSTICS,
+  ORCHESTRATOR_VIEWS.USAGE,
   ORCHESTRATOR_VIEWS.HELP
 ]);
 
@@ -20,8 +20,10 @@ const CONTENT_INTERACTIVE_VIEWS = new Set([
   ORCHESTRATOR_VIEWS.RUN_DETAIL,
   ORCHESTRATOR_VIEWS.REVIEWS,
   ORCHESTRATOR_VIEWS.REVIEW_DETAIL,
+  ORCHESTRATOR_VIEWS.ALERTS,
   ORCHESTRATOR_VIEWS.LAUNCH,
-  ORCHESTRATOR_VIEWS.ACTIVITY
+  ORCHESTRATOR_VIEWS.ACTIVITY,
+  ORCHESTRATOR_VIEWS.PROFILE
 ]);
 
 export function isNavFocusedView(view) {