@kal-elsam/kairo-runtime 0.12.0 → 0.13.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kal-elsam/kairo-runtime",
-  "version": "0.12.0",
+  "version": "0.13.1",
   "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,7 +55,7 @@
     "sdd",
     "tdd"
   ],
-  "license": "UNLICENSED",
+  "license": "MIT",
   "publishConfig": {
     "access": "public"
   },

package/scripts/cockpit-smoke.mjs

@@ -26,7 +26,8 @@ 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.11.0");
+assert.match(pkg.version, /^\d+\.\d+\.\d+$/);
+assert.equal(pkg.name, "@kal-elsam/kairo-runtime");
 assert.ok(pkg.dependencies["ansi-escapes"]);
 
 assert.equal(resolveLayoutMode({ columns: 120, rows: 40 }), LAYOUT_MODES.WIDE);

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,
@@ -43,22 +40,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 +64,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 +126,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 +137,7 @@ export async function runCli(argv) {
         version: packageManifest.version
       });
       return;
+    }
     case "intelligence":
       await runIntelligenceCli(optionsWithPolicy, packageManifest);
       return;
@@ -397,6 +393,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 +467,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 +592,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 +936,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,180 @@
+/**
+ * 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} 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 [--dry-run]             Technical repair alias (prefer sync)
+  ${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     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 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-control-center.js

@@ -11,6 +11,7 @@ import {
   formatResourceAdviceLines
 } from "./system-resources-display.js";
 import { formatEcosystemUpdateLines } from "./ecosystem-updates-display.js";
+import { formatObsidianVaultLines } from "./obsidian-vault-display.js";
 
 const HERMES_WIDE_SESSION_LIMIT = 3;
 const HERMES_TITLE_MAX = 48;
@@ -21,6 +22,7 @@ export {
   formatResourceAdviceLines
 } from "./system-resources-display.js";
 export { formatEcosystemUpdateLines } from "./ecosystem-updates-display.js";
+export { formatObsidianVaultLines } from "./obsidian-vault-display.js";
 
 export function buildControlCenterModel({
   projectName = "project",
@@ -192,7 +194,8 @@ function formatCompanionOverlay(companion, layoutMode = LAYOUT_MODES.COMPACT) {
       ...formatHermesActivityLines(companion.signals?.hermes?.activity, layoutMode),
       ...formatSystemResourcesLines(companion.signals?.system?.resources, layoutMode),
       ...formatResourceAdviceLines(companion.signals?.system?.advice, layoutMode),
-      ...formatEcosystemUpdateLines(companion.signals?.ecosystem?.updates, layoutMode)
+      ...formatEcosystemUpdateLines(companion.signals?.ecosystem?.updates, layoutMode),
+      ...formatObsidianVaultLines(companion.signals?.obsidian?.vault, layoutMode)
     ],
     links: companion.links ?? [],
     error: companion.error ?? null

package/src/global/ink/obsidian-vault-display.js

@@ -0,0 +1,37 @@
+import { LAYOUT_MODES } from "./layout.js";
+
+/** Display-only Obsidian vault lines — never shows paths, write CTAs, or sync controls. */
+export function formatObsidianVaultLines(status, layoutMode = LAYOUT_MODES.COMPACT) {
+  if (status == null || typeof status !== "object") return ["Obsidian · unavailable"];
+  const state = typeof status.state === "string" && status.state ? status.state : "error";
+  const notes = typeof status.noteCount === "number" && Number.isFinite(status.noteCount)
+    ? status.noteCount
+    : 0;
+  const pending = typeof status.pendingProposals === "number" && status.pendingProposals > 0
+    ? status.pendingProposals
+    : 0;
+
+  if (state === "unconfigured") return ["Obsidian · unconfigured"];
+  if (state === "missing") return ["Obsidian · missing"];
+  if (state !== "available" && state !== "partial") {
+    return [`Obsidian · ${state}`];
+  }
+
+  const head = state === "partial"
+    ? `Obsidian · partial · ${notes} notes`
+    : `Obsidian · ${notes} notes`;
+  const lines = [head];
+  if (layoutMode === LAYOUT_MODES.MINIMAL) return lines;
+
+  if (pending > 0) lines.push(`  · pending · ${pending}`);
+  else if (layoutMode === LAYOUT_MODES.COMPACT) lines.push("  · no auto-sync");
+
+  if (layoutMode === LAYOUT_MODES.WIDE) {
+    const pub = typeof status.lastPublishAt === "string" && status.lastPublishAt
+      ? status.lastPublishAt.slice(0, 19)
+      : "never";
+    lines.push(`  · last publish · ${pub}`);
+    if (pending === 0) lines.push("  · no auto-sync");
+  }
+  return lines;
+}