@kal-elsam/kairo-runtime 0.13.0 → 0.14.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kal-elsam/kairo-runtime",
-  "version": "0.13.0",
+  "version": "0.14.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",
@@ -26,7 +26,9 @@
     "repo-template",
     "global-template",
     "prompts",
-    "README.md"
+    "README.md",
+    "LICENSE",
+    "CHANGELOG.md"
   ],
   "scripts": {
     "test": "node --test",
@@ -53,13 +55,17 @@
     "sdd",
     "tdd"
   ],
-  "license": "UNLICENSED",
+  "license": "MIT",
   "publishConfig": {
     "access": "public"
   },
   "engines": {
     "node": ">=20.12.0"
   },
+  "packageManager": "pnpm@10.34.5",
+  "pnpm": {
+    "onlyBuiltDependencies": []
+  },
   "dependencies": {
     "@clack/prompts": "^1.7.0",
     "@modelcontextprotocol/server": "2.0.0",

package/scripts/cockpit-smoke.mjs

@@ -86,7 +86,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, /Repair|Govern|Activity|Usage|Settings|Overview/i);
+assert.match(asciiNav.explanation, /agents|Obsidian|integrations/i);
 
 function applyKey(state, keyAction) {
   const routed = routeCockpitKey(state, keyAction);
@@ -99,25 +99,29 @@ function smokeNavigation(layoutMode) {
     layoutMode,
     region: layoutMode === LAYOUT_MODES.MINIMAL ? COCKPIT_REGIONS.CONTENT : COCKPIT_REGIONS.NAV
   });
-  const diagnosticsIndex = COCKPIT_NAV.findIndex((item) => item.id === "governance");
-  while (state.navIndex < diagnosticsIndex) {
+  const settingsIndex = COCKPIT_NAV.findIndex((item) => item.id === "settings");
+  while (state.navIndex < settingsIndex) {
     state = applyKey(state, { type: "arrow", direction: "down" });
   }
   state = applyKey(state, { type: "enter" });
-  assert.equal(state.view, ORCHESTRATOR_VIEWS.CHANGES);
-  assert.equal(state.region, COCKPIT_REGIONS.NAV);
+  assert.equal(state.view, ORCHESTRATOR_VIEWS.PROFILE);
+  assert.equal(state.region, COCKPIT_REGIONS.CONTENT);
 
-  state = applyKey(state, { type: "arrow", direction: "up" });
+  state = applyKey(state, { type: "tab" });
+  assert.equal(state.region, COCKPIT_REGIONS.NAV);
+  while (state.navIndex > 0) {
+    state = applyKey(state, { type: "arrow", direction: "up" });
+  }
   state = applyKey(state, { type: "enter" });
   assert.equal(state.view, ORCHESTRATOR_VIEWS.HOME);
-  assert.equal(state.region, COCKPIT_REGIONS.NAV);
+  assert.equal(state.region, COCKPIT_REGIONS.CONTENT);
 
   const footer = buildFooterModel({
-    view: ORCHESTRATOR_VIEWS.CHANGES,
-    region: COCKPIT_REGIONS.NAV,
+    view: ORCHESTRATOR_VIEWS.HOME,
+    region: COCKPIT_REGIONS.CONTENT,
     unicode: false
   });
-  assert.doesNotMatch(footer.text, /Tab/);
+  assert.match(footer.text, /Tab/);
 
   state = applyKey(state, { type: "escape" });
   assert.equal(state.view, ORCHESTRATOR_VIEWS.HOME);

package/src/cli.js

@@ -1,9 +1,6 @@
 import { fileURLToPath } from "node:url";
 import { readFile } from "node:fs/promises";
 import { basename, dirname, resolve } from "node:path";
-import { ADAPTERS } from "./harness-files.js";
-import { GLOBAL_AGENT_IDS } from "./global/registry.js";
-import { COMPONENT_IDS, DEFAULT_COMPONENT_IDS } from "./global/component-registry.js";
 import {
   runComponentsConfigure,
   runComponentsRollback,
@@ -33,6 +30,7 @@ import {
   runGlobalReport
 } from "./global/global-cli.js";
 import { runEcosystemUpdatesCheck } from "./global/updates-cli.js";
+import { runSelfUpdate } from "./global/self-update.js";
 import { applyPolicyToOptions, loadPolicyFile } from "./global/policy.js";
 import { resolveHomeDir } from "./global/paths.js";
 import { runWorkspaceDetect, runWorkspaceDoctor, runWorkspaceInit, runWorkspaceUpdate } from "./workspace-cli.js";
@@ -43,22 +41,18 @@ import { runGlobalReview, runGlobalReviews } from "./global/runtime/review/revie
 import { runGlobalMonitor } from "./global/runtime/monitor/monitor-cli.js";
 import { runGlobalAlerts } from "./global/runtime/alerts/alert-cli.js";
 import { runGraphifyCli } from "./global/observability/graphify-ops.js";
-import { runKairoMcp } from "./global/mcp/kairo-mcp.js";
 import { normalizeRunStrategy } from "./global/runtime/run-strategy.js";
 import {
-  LEGACY_PACKAGE_NAME,
-  PACKAGE_NAME,
-  PREFERRED_CLI,
   formatCliCommand,
   maybeWarnLegacyCli,
   resolveSuggestedInvocation
 } from "./global/brand/cli.js";
-import { BRAND } from "./global/brand/index.js";
 import {
   INITIAL_EXPERIENCE,
   hasConfiguredGlobalState,
   resolveInitialExperience
 } from "./global/initial-experience.js";
+import { printHelp } from "./global/cli-help.js";
 
 export { resolveSuggestedInvocation };
 
@@ -71,7 +65,7 @@ export async function runCli(argv) {
   maybeWarnLegacyCli(process.argv, { json: options.json });
 
   if (options.help || command === "help") {
-    printHelp();
+    printHelp({ all: options.helpAll === true });
     return;
   }
 
@@ -133,7 +127,9 @@ export async function runCli(argv) {
     case "graphify":
       await runGraphifyCli(optionsWithPolicy, packageManifest);
       return;
-    case "mcp":
+    case "mcp": {
+      // Lazy-load: MCP SDK is heavy and optional for day-to-day CLI (help/status/sync).
+      const { runKairoMcp } = await import("./global/mcp/kairo-mcp.js");
       // stdout reserved for MCP protocol — no banners/logs here
       await runKairoMcp({
         cwd: optionsWithPolicy.cwd,
@@ -142,6 +138,7 @@ export async function runCli(argv) {
         version: packageManifest.version
       });
       return;
+    }
     case "intelligence":
       await runIntelligenceCli(optionsWithPolicy, packageManifest);
       return;
@@ -177,9 +174,15 @@ export async function runCli(argv) {
       });
       return;
     case "update":
-      await dispatchByScope(options, "agent-global", {
-        "agent-global": () => runGlobalInstall(options, packageManifest, packageRoot, { update: true }),
-        workspace: () => runWorkspaceUpdate(options, packageManifest, packageRoot)
+      if (options.scope === "workspace") {
+        await runWorkspaceUpdate(options, packageManifest, packageRoot);
+        return;
+      }
+      await runSelfUpdate({
+        packageName: packageManifest.name,
+        cliVersion: packageManifest.version,
+        yes: optionsWithPolicy.yes === true,
+        json: optionsWithPolicy.json === true
       });
       return;
     case "doctor":
@@ -397,6 +400,7 @@ export function parseArgs(argv) {
     limit: null,
     simple: false,
     help: false,
+    helpAll: false,
     version: false,
     interactive: Boolean(process.stdin.isTTY && process.stdout.isTTY),
     intelligenceAction: null,
@@ -470,6 +474,13 @@ export function parseArgs(argv) {
   if (command === "graphify") parseGraphifyAction(args, options);
   if (command === "updates") parseUpdatesAction(args, options);
 
+  if (command === "help") {
+    while (args[0] === "all" || args[0] === "--all") {
+      options.helpAll = true;
+      args.shift();
+    }
+  }
+
   for (let index = 0; index < args.length; index += 1) {
     const arg = args[index];
 
@@ -588,6 +599,7 @@ export function parseArgs(argv) {
       options.failOn = requireFlagValue("--fail-on", arg.slice("--fail-on=".length));
     }
     else if (arg === "--help" || arg === "-h") options.help = true;
+    else if (arg === "--all") options.helpAll = true;
     else if (arg === "--version" || arg === "-v") options.version = true;
     else throw new Error(`Unknown option "${arg}".`);
   }
@@ -931,132 +943,3 @@ function parsePersona(value) {
   }
   return persona;
 }
-
-function printHelp() {
-  const cli = PREFERRED_CLI;
-  console.log(`${BRAND.displayName} (${PACKAGE_NAME})
-
-${BRAND.tagline}. ${BRAND.displayName} does not install AI apps — it powers and
-coordinates agents you already have (Cursor, Codex, OpenCode, Claude, Pi) with managed
-sections, components, backups, and drift repair under ~/.harness.
-
-Bootstrap: see README.md (curl install.sh or npx ${PACKAGE_NAME}).
-
-Usage:
-  ${cli}                              First run: onboarding → setup → cockpit (TTY).
-                                      Later: full-screen cockpit (wide/compact/minimal).
-  ${cli} --dry-run                      Setup dry-run (scriptable)
-  ${cli} --version
-  ${cli} shell                          Operations cockpit (TTY)
-  ${cli} run --agent <id> --task "..." [--strategy direct|orchestrated] [--model <name>] [--cwd <dir>] [--permissions force|yolo|read-only] [--allow-unsafe-permissions] [--capture-transcript] [--follow] [--no-wait] [--json]
-  ${cli} runs list [--json] [--limit <n>] [--active-only]
-  ${cli} runs show <runId> [--json] [--limit <n>] [--follow]
-  ${cli} runs stop <runId> [--json]
-  ${cli} alerts resolve|dismiss <alertId> --confirm-resolve|--confirm-dismiss [--json]
-  ${cli} review --agent codex|pi [--base <ref>|--commit <sha>|--staged] [--model <name>] [--include-private] [--yes|--confirm] [--fail-on high|medium|low] [--json]
-  ${cli} reviews list [--limit <n>] [--json]
-  ${cli} reviews show <reviewId> [--json]
-  ${cli} reviews verify <reviewId> --staged [--json]
-  ${cli} reviews export <lineage> --out <path> [--json]
-  ${cli} reviews import --bundle <path> --confirm-import [--cwd <dir>] [--json]
-  ${cli} graphify query|path|explain ... --graph <path> [--budget N] [--json]
-  ${cli} orchestrator [--json]          Read-only agent capability diagnostics
-  ${cli} intelligence [status|models|context|route|ask] [--json]
-  ${cli} intelligence models --backend opencode-go|opencode-zen|opencode
-  ${cli} intelligence route --backend opencode-go --model <id> [--cloud-consent]
-  ${cli} intelligence ask --prompt "..." [--backend <id>] [--model <id>] [--cloud-consent] [--yes] [--paths a,b]
-  ${cli} setup [--dry-run] [--yes] [--confirm] [--simple] [--no-preflight] [--agents <list|all>] [--components <list>]
-  ${cli} status [--json]
-  ${cli} sync [--dry-run] [--yes] [--confirm] [--json] [--no-preflight]
-  ${cli} upgrade [--dry-run] [--yes] [--confirm] [--no-preflight]
-  ${cli} updates check [--json] [--force]
-  ${cli} install [--agents <list|all>] [--components <list>] [--dry-run]
-  ${cli} install --no-default-components
-  ${cli} doctor [--json]
-  ${cli} adapters [--json]
-  ${cli} explain [--json]
-  ${cli} diff [--json]
-  ${cli} update [--dry-run]
-  ${cli} install --scope=workspace [--mode minimal|standard|enterprise] (opt-in/legacy)
-  ${cli} init [--mode minimal|standard|enterprise] (workspace alias)
-  ${cli} detect
-  ${cli} backups
-  ${cli} history [--json] [--limit <n>] [--command <name>] [--action <name>]
-  ${cli} history last [--json] [--command <name>] [--action <name>]
-  ${cli} rollback --to <snapshot> [--apply]
-  ${cli} policy [--json]
-  ${cli} policy set <key> <value>
-  ${cli} policy reset
-  ${cli} report [--json] [--out <file>] [--limit <n>]
-  ${cli} components
-  ${cli} components validate|init|pack|import ...
-  ${cli} components configure engram-memory [--agents <list>] [--dry-run|--yes] [--json]
-  ${cli} components configure sdd-core [--agents <list>] [--persona off|teaching] [--dry-run|--yes] [--json]
-  ${cli} components verify sdd-core [--agents <list>] [--json]
-  ${cli} components rollback engram-memory|sdd-core --receipt <id> [--dry-run|--yes] [--json]
-  ${cli} uninstall [--dry-run]
-
-Scopes:
-  agent-global (default)  Configure local agent roots and managed sections.
-                          Primary product path. Writes ~/.harness state.
-  workspace (opt-in)      Legacy repo scaffolding into the current project.
-                          Explicit --scope=workspace only.
-
-Commands:
-  shell      Operations cockpit (TTY). Bare ${cli} opens onboarding when ~/.harness/state.json
-             is missing, otherwise the cockpit. Explicit ${cli} shell always opens the cockpit.
-             Keys: ↑↓ · Enter · Esc back/exit · R refresh · C cancel · ? help.
-             Tab switches region only when content is interactive (runs/launch).
-  run        Launch a managed agent run with local audit trail.
-  runs       List, inspect, or cancel agent runs under ~/.harness/runs/.
-  alerts     Consent-gated alert resolve/dismiss (Permission Authority).
-  review     Bounded read-only review via Codex or Pi; receipts under ~/.harness/reviews/.
-  reviews    List/show/verify receipts, or Gentle portable export/import.
-  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.
-             Ephemeral --backend/--model override preferredBackend/preferredModel.
-             Credentials via env only (OPENROUTER_API_KEY, OPENCODE_API_KEY, OLLAMA_HOST). Never stored.
-  setup      Managed ecosystem setup. Interactive Ink UI (TTY). Use --simple for Clack prompts.
-  status     Control panel: agents, components, drift, backups, next action.
-  sync       Converge managed content (repair drift), then show status.
-  upgrade    Preview or apply ecosystem updates (apply requires --yes).
-  updates    Read-only ecosystem update check (kairo/hermes/gentle/skills). Never applies.
-  install    Non-interactive configure (agent-global) or legacy workspace scaffold.
-  doctor     Detailed health checks for managed state and configs.
-  update     Technical repair alias (prefer sync for day-to-day use).
-  detect     Inspect global agents and the current project. Read-only.
-  adapters   Official adapter matrix: roots, config files, detected/managed.
-  explain    Read-only audit of managed adapters, configs, markers, and backups.
-  diff       Read-only preview of managed content changes (sync/setup plan).
-  backups    List config snapshots under ~/.harness/backups.
-  history    Local audit log of managed operations under ~/.harness/history.jsonl.
-             Use "history last" for the most recent event. Read-only.
-  rollback   Preview or restore a prior config snapshot (--apply to write).
-  policy     View or edit local operation preferences under ~/.harness/policy.json.
-  report     Read-only diagnostics bundle: status, policy, adapters, diff, history.
-  components List, validate, scaffold, pack, import, or configure integrations (Engram, SDD).
-  uninstall  Remove managed sections and global state. Backups are preserved.
-  init       Alias for install --scope=workspace (legacy).
-
-JSON output (--json on supported commands):
-  status, sync, doctor, adapters, explain, diff, history, history last,
-  policy (show/set/reset), report, monitor
-  Human text remains the default. See README.md for examples and field notes.
-
-Version:
-  ${cli} --version              Installed CLI version
-  npm view ${PACKAGE_NAME} version   Latest published version
-  npx ${PACKAGE_NAME}@latest sync    Converge with latest package
-
-More examples: README.md
-
-Preferred CLI: kairo, kairo-runtime
-Legacy aliases: harness, agentic-harness, sgs-harness, harness-sgs (prefer kairo)
-Legacy package: ${LEGACY_PACKAGE_NAME}
-Global agents: ${GLOBAL_AGENT_IDS.join(", ")}
-Global components: ${COMPONENT_IDS.join(", ")} (default: ${DEFAULT_COMPONENT_IDS.join(", ")})
-Workspace adapters: ${[...ADAPTERS].join(", ")}
-`);
-}

package/src/global/cli-help.js

@@ -0,0 +1,182 @@
+/**
+ * Tiered CLI help — short by default, full with --all.
+ */
+import { BRAND } from "./brand/index.js";
+import {
+  LEGACY_PACKAGE_NAME,
+  PACKAGE_NAME,
+  PREFERRED_CLI
+} from "./brand/cli.js";
+import { GLOBAL_AGENT_IDS } from "./registry.js";
+import { COMPONENT_IDS, DEFAULT_COMPONENT_IDS } from "./component-registry.js";
+import { ADAPTERS } from "../harness-files.js";
+
+export function printHelp({ all = false } = {}) {
+  if (all) {
+    console.log(formatHelpAll());
+    return;
+  }
+  console.log(formatHelpShort());
+}
+
+export function formatHelpShort() {
+  const cli = PREFERRED_CLI;
+  return `${BRAND.displayName} (${PACKAGE_NAME})
+
+${BRAND.tagline}. Coordinates agents you already have — never installs AI apps.
+
+Usage:
+  ${cli}                 Open the cockpit (setup on first run)
+  ${cli} status          See how your setup is doing
+  ${cli} sync            Repair what drifted
+  ${cli} update          Update Kairo itself (npm)
+  ${cli} doctor          Deeper health checks
+
+  ${cli} help --all      Every command and flag
+  ${cli} --version
+
+Docs: README.md · docs/cli-reference.md
+Preferred CLI: kairo, kairo-runtime
+Legacy aliases: harness, agentic-harness, sgs-harness, harness-sgs (prefer kairo)
+`;
+}
+
+export function formatHelpAll() {
+  const cli = PREFERRED_CLI;
+  return `${BRAND.displayName} (${PACKAGE_NAME}) — full command list
+
+${BRAND.tagline}. ${BRAND.displayName} does not install AI apps — it powers and
+coordinates agents you already have (Cursor, Codex, OpenCode, Claude, Pi) with managed
+sections, components, backups, and drift repair under ~/.harness.
+
+Bootstrap: see README.md and docs/install.md (curl install.sh or npx ${PACKAGE_NAME}).
+
+## Configuration & health
+  ${cli}                              First run: onboarding → setup → cockpit (TTY).
+                                      Later: full-screen cockpit (wide/compact/minimal).
+  ${cli} --dry-run                      Setup dry-run (scriptable)
+  ${cli} --version
+  ${cli} setup [--dry-run] [--yes] [--confirm] [--simple] [--no-preflight] [--agents <list|all>] [--components <list>]
+  ${cli} status [--json]
+  ${cli} sync [--dry-run] [--yes] [--confirm] [--json] [--no-preflight]
+  ${cli} doctor [--json]
+  ${cli} upgrade [--dry-run] [--yes] [--confirm] [--no-preflight]
+  ${cli} updates check [--json] [--force]
+  ${cli} install [--agents <list|all>] [--components <list>] [--dry-run]
+  ${cli} install --no-default-components
+  ${cli} update [--yes] [--json]        Update the Kairo CLI from npm
+  ${cli} update --scope=workspace [--dry-run]  Refresh workspace template files
+  ${cli} uninstall [--dry-run]
+
+## Agents & runs
+  ${cli} shell                          Operations cockpit (TTY)
+  ${cli} run --agent <id> --task "..." [--strategy direct|orchestrated] [--model <name>] [--cwd <dir>] [--permissions force|yolo|read-only] [--allow-unsafe-permissions] [--capture-transcript] [--follow] [--no-wait] [--json]
+  ${cli} runs list [--json] [--limit <n>] [--active-only]
+  ${cli} runs show <runId> [--json] [--limit <n>] [--follow]
+  ${cli} runs stop <runId> [--json]
+  ${cli} review --agent codex|pi [--base <ref>|--commit <sha>|--staged] [--model <name>] [--include-private] [--yes|--confirm] [--fail-on high|medium|low] [--json]
+  ${cli} reviews list [--limit <n>] [--json]
+  ${cli} reviews show <reviewId> [--json]
+  ${cli} reviews verify <reviewId> --staged [--json]
+  ${cli} reviews export <lineage> --out <path> [--json]
+  ${cli} reviews import --bundle <path> --confirm-import [--cwd <dir>] [--json]
+  ${cli} alerts resolve|dismiss <alertId> --confirm-resolve|--confirm-dismiss [--json]
+  ${cli} monitor enable|disable|status|tick
+  ${cli} orchestrator [--json]          Read-only agent capability diagnostics
+  ${cli} adapters [--json]
+  ${cli} detect
+
+## Governance & audit
+  ${cli} explain [--json]
+  ${cli} diff [--json]
+  ${cli} backups
+  ${cli} history [--json] [--limit <n>] [--command <name>] [--action <name>]
+  ${cli} history last [--json] [--command <name>] [--action <name>]
+  ${cli} rollback --to <snapshot> [--apply]
+  ${cli} policy [--json]
+  ${cli} policy set <key> <value>
+  ${cli} policy reset
+  ${cli} report [--json] [--out <file>] [--limit <n>]
+
+## Advanced
+  ${cli} intelligence [status|models|context|route|ask] [--json]
+  ${cli} intelligence models --backend opencode-go|opencode-zen|opencode
+  ${cli} intelligence route --backend opencode-go --model <id> [--cloud-consent]
+  ${cli} intelligence ask --prompt "..." [--backend <id>] [--model <id>] [--cloud-consent] [--yes] [--paths a,b]
+             Credentials via env only (OPENROUTER_API_KEY, OPENCODE_API_KEY, OLLAMA_HOST). Never stored.
+             Local-first (Ollama). Cloud only with --cloud-consent.
+  ${cli} graphify query|path|explain ... --graph <path> [--budget N] [--json]
+  ${cli} components
+  ${cli} components validate|init|pack|import ...
+  ${cli} components configure engram-memory [--agents <list>] [--dry-run|--yes] [--json]
+  ${cli} components configure sdd-core [--agents <list>] [--persona off|teaching] [--dry-run|--yes] [--json]
+  ${cli} components verify sdd-core [--agents <list>] [--json]
+  ${cli} components rollback engram-memory|sdd-core --receipt <id> [--dry-run|--yes] [--json]
+  ${cli} mcp
+  ${cli} install --scope=workspace [--mode minimal|standard|enterprise] (opt-in/legacy)
+  ${cli} init [--mode minimal|standard|enterprise] (workspace alias)
+
+Scopes:
+  agent-global (default)  Configure local agent roots and managed sections.
+                          Primary product path. Writes ~/.harness state.
+  workspace (opt-in)      Legacy repo scaffolding into the current project.
+                          Explicit --scope=workspace only.
+
+Commands:
+  shell      Operations cockpit (TTY). Bare ${cli} opens onboarding when ~/.harness/state.json
+             is missing, otherwise the cockpit. Explicit ${cli} shell always opens the cockpit.
+             Keys: ↑↓ · Enter · Esc back/exit · R refresh · C cancel · ? help.
+             Tab switches region only when content is interactive (runs/launch).
+  run        Launch a managed agent run with local audit trail.
+  runs       List, inspect, or cancel agent runs under ~/.harness/runs/.
+  alerts     Consent-gated alert resolve/dismiss (Permission Authority).
+  review     Bounded read-only review via Codex or Pi; receipts under ~/.harness/reviews/.
+  reviews    List/show/verify receipts, or Gentle portable export/import.
+  monitor    Opt-in anomaly monitor (enable|disable|status|tick). macOS LaunchAgent; notify shell:false.
+  orchestrator  Read-only agent capability diagnostics (--json supported).
+  intelligence  Harness Engineering layer: backends, context packs, routing, budgets.
+             Local-first (Ollama). Cloud only with --cloud-consent.
+             Ephemeral --backend/--model override preferredBackend/preferredModel.
+             Credentials via env only (OPENROUTER_API_KEY, OPENCODE_API_KEY, OLLAMA_HOST). Never stored.
+  setup      Managed ecosystem setup. Interactive Ink UI (TTY). Use --simple for Clack prompts.
+  status     Control panel: agents, components, drift, backups, next action.
+  sync       Converge managed content (repair drift), then show status.
+  upgrade    Preview or apply ecosystem updates (apply requires --yes).
+  updates    Read-only ecosystem update check (kairo/hermes/gentle/skills). Never applies.
+  install    Non-interactive configure (agent-global) or legacy workspace scaffold.
+  doctor     Detailed health checks for managed state and configs.
+  update     Update the Kairo CLI from npm (--yes applies). Workspace templates: --scope=workspace.
+  detect     Inspect global agents and the current project. Read-only.
+  adapters   Official adapter matrix: roots, config files, detected/managed.
+  explain    Read-only audit of managed adapters, configs, markers, and backups.
+  diff       Read-only preview of managed content changes (sync/setup plan).
+  backups    List config snapshots under ~/.harness/backups.
+  history    Local audit log of managed operations under ~/.harness/history.jsonl.
+             Use "history last" for the most recent event. Read-only.
+  rollback   Preview or restore a prior config snapshot (--apply to write).
+  policy     View or edit local operation preferences under ~/.harness/policy.json.
+  report     Read-only diagnostics bundle: status, policy, adapters, diff, history.
+  components List, validate, scaffold, pack, import, or configure integrations (Engram, SDD).
+  uninstall  Remove managed sections and global state. Backups are preserved.
+  init       Alias for install --scope=workspace (legacy).
+
+JSON output (--json on supported commands):
+  status, sync, doctor, adapters, explain, diff, history, history last,
+  policy (show/set/reset), report, monitor
+  Human text remains the default. See docs/cli-reference.md for examples and field notes.
+
+Version:
+  ${cli} --version              Installed CLI version
+  npm view ${PACKAGE_NAME} version   Latest published version
+  npx ${PACKAGE_NAME}@latest sync    Converge with latest package
+
+More examples: README.md · docs/cli-reference.md
+
+Preferred CLI: kairo, kairo-runtime
+Legacy aliases: harness, agentic-harness, sgs-harness, harness-sgs (prefer kairo)
+Legacy package: ${LEGACY_PACKAGE_NAME}
+Global agents: ${GLOBAL_AGENT_IDS.join(", ")}
+Global components: ${COMPONENT_IDS.join(", ")} (default: ${DEFAULT_COMPONENT_IDS.join(", ")})
+Workspace adapters: ${[...ADAPTERS].join(", ")}
+`;
+}

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

@@ -122,9 +122,7 @@ export function reduceCockpitUi(state, action) {
       if (state.region === COCKPIT_REGIONS.SYSTEM) return state;
 
       const navigatesNav = state.region === COCKPIT_REGIONS.NAV
-        || isNavFocusedView(state.view)
-        || (state.view === ORCHESTRATOR_VIEWS.HOME
-          && state.layoutMode === LAYOUT_MODES.MINIMAL);
+        || isNavFocusedView(state.view);
 
       if (navigatesNav) {
         const delta = action.direction === "up" ? -1 : 1;

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

@@ -11,7 +11,9 @@ export function resolveEnterNavIntent({
 } = {}) {
   if (!navItem) return { kind: "noop" };
 
-  const isOverview = navItem.id === "overview" || navItem.view === ORCHESTRATOR_VIEWS.HOME;
+  const isOverview = navItem.id === "home"
+    || navItem.id === "overview"
+    || navItem.view === ORCHESTRATOR_VIEWS.HOME;
   if (isOverview) {
     if (currentView === ORCHESTRATOR_VIEWS.HOME && ctaDestination) {
       if (ctaDestination === "setup") return { kind: "activate-setup" };

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

@@ -3,7 +3,6 @@ import { ORCHESTRATOR_VIEWS } from "./orchestrator-state.js";
 import { LAYOUT_MODES } from "./layout.js";
 
 const NAV_FOCUSED_VIEWS = new Set([
-  ORCHESTRATOR_VIEWS.HOME,
   ORCHESTRATOR_VIEWS.IDES,
   ORCHESTRATOR_VIEWS.MODULES,
   ORCHESTRATOR_VIEWS.CHANGES,
@@ -14,6 +13,7 @@ const NAV_FOCUSED_VIEWS = new Set([
 ]);
 
 const CONTENT_INTERACTIVE_VIEWS = new Set([
+  ORCHESTRATOR_VIEWS.HOME,
   ORCHESTRATOR_VIEWS.RUNS,
   ORCHESTRATOR_VIEWS.ACTIVE_RUNS,
   ORCHESTRATOR_VIEWS.RECENT_RUNS,
@@ -102,6 +102,12 @@ export function routeCockpitKey(state, keyAction) {
       if (state.region === COCKPIT_REGIONS.NAV || isNavFocusedView(state.view)) {
         return { type: "enter-nav" };
       }
+      if (
+        state.region === COCKPIT_REGIONS.CONTENT
+        && state.view === ORCHESTRATOR_VIEWS.HOME
+      ) {
+        return { type: "enter-home-button" };
+      }
       return null;
     default:
       return null;