@arkhera30/cli 0.3.16 → 0.5.0

package/dist/index.js

@@ -1,8 +1,8 @@
 #!/usr/bin/env node
 
 // src/index.ts
-import { Command as Command11 } from "commander";
-import chalk11 from "chalk";
+import { Command as Command14 } from "commander";
+import chalk14 from "chalk";
 
 // src/commands/setup.ts
 import { Command as Command2 } from "commander";
@@ -139,6 +139,7 @@ function buildConfigFromParsed(parsed) {
       vault_rest: parsedPorts?.vault_rest ?? defaults.ports.vault_rest,
       vault_mcp: parsedPorts?.vault_mcp ?? defaults.ports.vault_mcp,
       vault_router: parsedPorts?.vault_router ?? defaults.ports.vault_router,
+      ui: parsedPorts?.ui ?? defaults.ports.ui,
       forge: parsedPorts?.forge ?? defaults.ports.forge,
       typesense: parsedPorts?.typesense ?? defaults.ports.typesense,
       neo4j_http: parsedPorts?.neo4j_http ?? defaults.ports.neo4j_http,
@@ -1088,6 +1089,25 @@ function mergeAndWriteConfig(configPath, mcpServers) {
   mkdirSync2(dir, { recursive: true });
   writeFileSync3(configPath, JSON.stringify(existing, null, 2) + "\n", "utf-8");
 }
+function detectNpxPath() {
+  const candidates = ["/opt/homebrew/bin/npx", "/usr/local/bin/npx"];
+  for (const candidate of candidates) {
+    if (existsSync4(candidate)) {
+      return candidate;
+    }
+  }
+  return "npx";
+}
+function buildClaudeDesktopServers(config, host) {
+  const npxPath = detectNpxPath();
+  const npxDir = npxPath === "npx" ? "/usr/local/bin" : npxPath.substring(0, npxPath.lastIndexOf("/"));
+  const envPath = `${npxDir}:/usr/local/bin:/usr/bin:/bin`;
+  return {
+    anvil: { command: npxPath, args: ["mcp-remote", `http://${host}:${config.ports.anvil}/mcp`], env: { PATH: envPath } },
+    vault: { command: npxPath, args: ["mcp-remote", `http://${host}:${config.ports.vault_mcp}/mcp`], env: { PATH: envPath } },
+    forge: { command: npxPath, args: ["mcp-remote", `http://${host}:${config.ports.forge}/mcp`], env: { PATH: envPath } }
+  };
+}
 async function isClaudeCliAvailable() {
   try {
     const result = await execa2("claude", ["--version"], { reject: false });
@@ -1118,12 +1138,14 @@ async function registerWithClaudeCode(mcpServers) {
 async function syncSkills(runtime) {
   const home = homedir3();
   const skillsBase = join2(home, ".claude", "skills");
-  const skills = ["horus-anvil", "horus-vault", "horus-forge"];
+  const skills = ["horus-anvil", "horus-vault", "horus-forge", "horus-context", "capture", "triage"];
   const forgeContainer = "horus-forge-1";
+  const homeResult = await runtime.exec(forgeContainer, "sh", "-c", "echo $HOME");
+  const containerHome = homeResult.stdout.trim();
   for (const skill of skills) {
     const destDir = join2(skillsBase, skill);
     mkdirSync2(destDir, { recursive: true });
-    const src = `/home/forge/.claude/skills/${skill}/SKILL.md`;
+    const src = `${containerHome}/.claude/skills/${skill}/SKILL.md`;
     const dest = join2(destDir, "SKILL.md");
     const result = await runtime.exec(forgeContainer, "cat", src);
     if (result.exitCode === 0 && result.stdout.trim()) {
@@ -1135,11 +1157,13 @@ async function syncSkillsForCursor(runtime) {
   const home = homedir3();
   const rulesDir = join2(home, ".cursor", "rules");
   const skillsBase = join2(home, ".cursor", "skills-cursor");
-  const skills = ["horus-anvil", "horus-vault", "horus-forge"];
+  const skills = ["horus-anvil", "horus-vault", "horus-forge", "horus-context", "capture", "triage"];
   const forgeContainer = "horus-forge-1";
   mkdirSync2(rulesDir, { recursive: true });
+  const homeResult = await runtime.exec(forgeContainer, "sh", "-c", "echo $HOME");
+  const containerHome = homeResult.stdout.trim();
   for (const skill of skills) {
-    const src = `/home/forge/.claude/skills/${skill}/SKILL.md`;
+    const src = `${containerHome}/.claude/skills/${skill}/SKILL.md`;
     const result = await runtime.exec(forgeContainer, "cat", src);
     if (result.exitCode === 0 && result.stdout.trim()) {
       const ruleDest = join2(rulesDir, `${skill}.mdc`);
@@ -1186,7 +1210,8 @@ async function runConnect(config, runtime, targets, host = "localhost") {
       const desktopSpinner = ora(`Configuring ${chalk.cyan("claude-desktop")}...`).start();
       try {
         const configPath = getConfigPath(target);
-        mergeAndWriteConfig(configPath, httpServers);
+        const desktopServers = buildClaudeDesktopServers(config, host);
+        mergeAndWriteConfig(configPath, desktopServers);
         desktopSpinner.succeed(`Configured ${chalk.cyan("claude-desktop")} \u2014 ${chalk.dim(configPath)}`);
         configured.push(target);
       } catch (error) {
@@ -1338,7 +1363,7 @@ function extractHostname(url) {
     return "github.com";
   }
 }
-var setupCommand = new Command2("setup").description("Interactive first-run setup for Horus").option("-y, --yes", "Non-interactive mode (use defaults + env vars)").option("--runtime <runtime>", "Container runtime to use: docker or podman (non-interactive only)").option("--data-dir <path>", "Data directory path").option("--repos-path <path>", "Host repos path for Forge scanning").option("--anvil-repo <url>", "Anvil notes repository URL").option("--vault-name <name>", "Vault name (can be specified multiple times)").option("--vault-repo <url>", "Vault knowledge-base repository URL (matches positionally with --vault-name)").option("--forge-repo <url>", "Forge registry repository URL").option("--github-token <token>", "GitHub personal access token for private repos (primary host)").action(async (opts) => {
+var setupCommand = new Command2("setup").description("Interactive first-run setup for Horus").option("-y, --yes", "Non-interactive mode (use defaults + env vars)").option("--runtime <runtime>", "Container runtime to use: docker or podman (non-interactive only)").option("--data-dir <path>", "Data directory path").option("--repos-path <path>", "Host repos path for Forge scanning").option("--anvil-repo <url>", "Anvil notes repository URL").option("--vault-name <name>", "Vault name (can be specified multiple times)").option("--vault-repo <url>", "Vault knowledge-base repository URL (matches positionally with --vault-name)").option("--forge-repo <url>", "Forge registry repository URL").option("--github-token <token>", "GitHub personal access token for private repos (primary host)").option("--claude-desktop", "Configure Claude Desktop MCP servers during setup (non-interactive opt-in)").action(async (opts) => {
   console.log("");
   console.log(chalk2.bold("Horus Setup"));
   console.log(chalk2.dim("\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500"));
@@ -1483,6 +1508,7 @@ var setupCommand = new Command2("setup").description("Interactive first-run setu
         vault_rest: vault_rest ?? DEFAULT_PORTS.vault_rest,
         vault_mcp: vault_mcp ?? DEFAULT_PORTS.vault_mcp,
         vault_router: vault_router ?? DEFAULT_PORTS.vault_router,
+        ui: DEFAULT_PORTS.ui,
         forge: forge ?? DEFAULT_PORTS.forge,
         typesense: DEFAULT_PORTS.typesense,
         neo4j_http: DEFAULT_PORTS.neo4j_http,
@@ -1736,11 +1762,28 @@ ${example(`${vaultName.trim()}-knowledge`)}
   const detectedClients = detectInstalledClients();
   if (detectedClients.length > 0) {
     console.log(chalk2.bold("Configuring AI clients..."));
-    try {
-      await runConnect(config, runtime, detectedClients, "localhost");
-    } catch (error) {
-      console.log(chalk2.yellow("Could not configure AI clients automatically."));
-      console.log(chalk2.dim(`Run ${chalk2.cyan("horus connect")} to configure them manually.`));
+    let clientsToConnect = [...detectedClients];
+    if (clientsToConnect.includes("claude-desktop")) {
+      let configureDesktop;
+      if (opts.yes) {
+        configureDesktop = opts.claudeDesktop === true;
+        if (!configureDesktop) {
+          console.log(chalk2.dim("Skipping Claude Desktop (pass --claude-desktop to configure it)."));
+        }
+      } else {
+        configureDesktop = opts.claudeDesktop === false ? false : await confirm({ message: "Setup for Claude Desktop?", default: true });
+      }
+      if (!configureDesktop) {
+        clientsToConnect = clientsToConnect.filter((c) => c !== "claude-desktop");
+      }
+    }
+    if (clientsToConnect.length > 0) {
+      try {
+        await runConnect(config, runtime, clientsToConnect, "localhost");
+      } catch (error) {
+        console.log(chalk2.yellow("Could not configure AI clients automatically."));
+        console.log(chalk2.dim(`Run ${chalk2.cyan("horus connect")} to configure them manually.`));
+      }
     }
   } else {
     console.log(chalk2.dim(`No AI clients detected. Run ${chalk2.cyan("horus connect")} after installing Claude Desktop, Claude Code, or Cursor.`));
@@ -3376,8 +3419,428 @@ testEnvCommand.command("seed").description("Populate a slot with test fixtures (
   console.log(chalk10.dim("Services will re-index automatically. Allow ~10s before running tests."));
 });
 
+// src/commands/help.ts
+import { Command as Command11 } from "commander";
+import chalk11 from "chalk";
+import { readFileSync as readFileSync7, existsSync as existsSync10 } from "fs";
+import { join as join9, dirname as dirname3 } from "path";
+import { fileURLToPath as fileURLToPath3 } from "url";
+
+// src/lib/guide-retrieval.ts
+var STOP_WORDS = /* @__PURE__ */ new Set([
+  "the",
+  "a",
+  "an",
+  "and",
+  "or",
+  "but",
+  "if",
+  "then",
+  "else",
+  "when",
+  "while",
+  "of",
+  "in",
+  "on",
+  "at",
+  "to",
+  "from",
+  "for",
+  "with",
+  "by",
+  "as",
+  "about",
+  "this",
+  "that",
+  "these",
+  "those",
+  "it",
+  "its",
+  "they",
+  "them",
+  "their",
+  "he",
+  "she",
+  "we",
+  "you",
+  "your",
+  "our",
+  "my",
+  "me",
+  "us",
+  "his",
+  "her",
+  "him",
+  "is",
+  "are",
+  "was",
+  "were",
+  "be",
+  "been",
+  "being",
+  "am",
+  "have",
+  "has",
+  "had",
+  "having",
+  "do",
+  "does",
+  "did",
+  "doing",
+  "will",
+  "would",
+  "could",
+  "should",
+  "can",
+  "may",
+  "might",
+  "must",
+  "shall",
+  "not",
+  "no",
+  "yes",
+  "so",
+  "too",
+  "very",
+  "just",
+  "only",
+  "also",
+  "all",
+  "any",
+  "some",
+  "each",
+  "every",
+  "more",
+  "most",
+  "much",
+  "many",
+  "one",
+  "two",
+  "three",
+  "here",
+  "there",
+  "where",
+  "how",
+  "why",
+  "what",
+  "who",
+  "which"
+]);
+function tokenizeQuery(text) {
+  return text.toLowerCase().replace(/```[\s\S]*?```/g, " ").replace(/`[^`]*`/g, " ").replace(/\[([^\]]*)\]\([^)]*\)/g, "$1").replace(/[^a-z0-9\s-]/g, " ").split(/\s+/).filter((t) => t.length >= 2 && !STOP_WORDS.has(t));
+}
+var K1 = 1.5;
+var B = 0.75;
+function termFreq(token, tokens) {
+  let n = 0;
+  for (const t of tokens) if (t === token) n++;
+  return n;
+}
+function docFreq(token, guides) {
+  let n = 0;
+  for (const g of guides) {
+    if (g.tokens.includes(token)) n++;
+  }
+  return n;
+}
+function bm25Score(queryTokens, doc, avgDocLen, n, guides) {
+  let score = 0;
+  const docLen = doc.tokens.length;
+  for (const q of queryTokens) {
+    const f = termFreq(q, doc.tokens);
+    if (f === 0) continue;
+    const df = docFreq(q, guides);
+    const idf = Math.log((n - df + 0.5) / (df + 0.5) + 1);
+    const norm = f * (K1 + 1) / (f + K1 * (1 - B + B * docLen / avgDocLen));
+    score += idf * norm;
+  }
+  return score;
+}
+function retrieve(query, index, maxAlternates = 3) {
+  const queryTokens = tokenizeQuery(query);
+  if (queryTokens.length === 0 || index.guides.length === 0) {
+    return { primary: null, alternates: [] };
+  }
+  const n = index.guides.length;
+  const totalLen = index.guides.reduce((s, g) => s + g.tokens.length, 0);
+  const avgDocLen = totalLen / n;
+  const scored = index.guides.map((g) => ({ guide: g, score: bm25Score(queryTokens, g, avgDocLen, n, index.guides) })).filter((s) => s.score > 0).sort((a, b) => b.score - a.score);
+  if (scored.length === 0) {
+    return { primary: null, alternates: [] };
+  }
+  const primary = scored[0].guide;
+  const alternates = scored.slice(1, 1 + maxAlternates).map((s) => s.guide);
+  return { primary, alternates };
+}
+
+// src/commands/help.ts
+function findGuidesDir() {
+  let dir = dirname3(fileURLToPath3(import.meta.url));
+  const seen = /* @__PURE__ */ new Set();
+  while (dir !== dirname3(dir) && !seen.has(dir)) {
+    seen.add(dir);
+    const candidate = join9(dir, "guides");
+    if (existsSync10(candidate) && existsSync10(join9(candidate, "index.json"))) {
+      return candidate;
+    }
+    dir = dirname3(dir);
+  }
+  throw new Error(
+    "Could not find the bundled Horus guides directory. Try reinstalling: npm install -g @arkhera30/cli"
+  );
+}
+function loadIndex(guidesDir) {
+  const indexPath = join9(guidesDir, "index.json");
+  return JSON.parse(readFileSync7(indexPath, "utf8"));
+}
+function stripFrontMatter(content) {
+  return content.replace(/^---\n[\s\S]*?\n---\n?/, "");
+}
+function printTopicIndex(index) {
+  console.log("");
+  console.log(chalk11.bold("Horus Help \u2014 Available Guides"));
+  console.log(chalk11.dim("\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500"));
+  console.log("");
+  for (const g of index.guides) {
+    console.log(`  ${chalk11.cyan(g.slug.padEnd(20))} ${g.title}`);
+    console.log(`  ${" ".repeat(20)} ${chalk11.dim(g.description)}`);
+    console.log("");
+  }
+  console.log(chalk11.dim("Example queries:"));
+  console.log(chalk11.dim("  horus help how do I start"));
+  console.log(chalk11.dim("  horus help what is a forge workspace"));
+  console.log(chalk11.dim("  horus help create my first anvil note"));
+  console.log("");
+  console.log(chalk11.dim("To print a specific guide directly:"));
+  console.log(chalk11.dim("  horus guide <slug>"));
+  console.log("");
+}
+function printGuideBody(guidesDir, file) {
+  const path = join9(guidesDir, file);
+  const content = readFileSync7(path, "utf8");
+  console.log(stripFrontMatter(content));
+}
+function printSeeAlso(alternates, guidesDir) {
+  if (alternates.length === 0) return;
+  console.log(chalk11.dim("\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500"));
+  console.log(chalk11.bold("See also:"));
+  for (const a of alternates) {
+    console.log(`  ${chalk11.cyan(a.slug.padEnd(20))} ${a.title}`);
+    console.log(`  ${" ".repeat(20)} ${chalk11.dim(join9(guidesDir, a.file))}`);
+  }
+  console.log("");
+}
+function printFooter() {
+  console.log(
+    chalk11.dim(
+      "Run `horus guide <slug>` to print a specific guide without retrieval, or `horus guide` to list all."
+    )
+  );
+  console.log("");
+}
+var helpCommand = new Command11("help").description("Search and print bundled Horus getting-started guides").argument("[query...]", "Natural-language query. Omit to see the topic index.").action((query) => {
+  const guidesDir = findGuidesDir();
+  const index = loadIndex(guidesDir);
+  if (!query || query.length === 0) {
+    printTopicIndex(index);
+    return;
+  }
+  const queryStr = query.join(" ");
+  const result = retrieve(queryStr, index, 3);
+  if (!result.primary) {
+    console.log("");
+    console.log(chalk11.yellow(`No guide matched "${queryStr}".`));
+    console.log("");
+    console.log(chalk11.dim("Try `horus help` with no arguments to see the full topic index,"));
+    console.log(chalk11.dim("or pick a slug directly with `horus guide <slug>`."));
+    console.log("");
+    return;
+  }
+  console.log("");
+  console.log(chalk11.dim(`# ${result.primary.title}  (${result.primary.slug})`));
+  console.log("");
+  printGuideBody(guidesDir, result.primary.file);
+  console.log("");
+  printSeeAlso(result.alternates, guidesDir);
+  printFooter();
+});
+
+// src/commands/guide.ts
+import { Command as Command12 } from "commander";
+import chalk12 from "chalk";
+import { readFileSync as readFileSync8, existsSync as existsSync11 } from "fs";
+import { join as join10, dirname as dirname4 } from "path";
+import { fileURLToPath as fileURLToPath4 } from "url";
+function findGuidesDir2() {
+  let dir = dirname4(fileURLToPath4(import.meta.url));
+  const seen = /* @__PURE__ */ new Set();
+  while (dir !== dirname4(dir) && !seen.has(dir)) {
+    seen.add(dir);
+    const candidate = join10(dir, "guides");
+    if (existsSync11(candidate) && existsSync11(join10(candidate, "index.json"))) {
+      return candidate;
+    }
+    dir = dirname4(dir);
+  }
+  throw new Error(
+    "Could not find the bundled Horus guides directory. Try reinstalling: npm install -g @arkhera30/cli"
+  );
+}
+function loadIndex2(guidesDir) {
+  return JSON.parse(readFileSync8(join10(guidesDir, "index.json"), "utf8"));
+}
+function lookupTopic(topic, index) {
+  const t = topic.trim().toLowerCase();
+  if (!t) return { tier: "none", matches: [] };
+  const exact = index.guides.filter((g) => g.slug === t);
+  if (exact.length > 0) return { tier: "exact-slug", matches: exact };
+  const prefix = index.guides.filter((g) => g.slug.startsWith(t));
+  if (prefix.length > 0) return { tier: "slug-prefix", matches: prefix };
+  const titleHits = index.guides.filter((g) => g.title.toLowerCase().includes(t));
+  if (titleHits.length > 0) return { tier: "title-fuzzy", matches: titleHits };
+  const kwHits = index.guides.filter(
+    (g) => g.keywords.some((k) => k.toLowerCase() === t)
+  );
+  if (kwHits.length > 0) return { tier: "keyword", matches: kwHits };
+  return { tier: "none", matches: [] };
+}
+function printGuideList(index) {
+  console.log("");
+  console.log(chalk12.bold("Bundled Horus Guides"));
+  console.log(chalk12.dim("\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500"));
+  console.log("");
+  for (const g of index.guides) {
+    console.log(`  ${chalk12.cyan(g.slug.padEnd(20))} ${g.title}`);
+    console.log(`  ${" ".repeat(20)} ${chalk12.dim(g.description)}`);
+    console.log("");
+  }
+  console.log(chalk12.dim("Print a guide:            horus guide <slug>"));
+  console.log(chalk12.dim("Print a guide file path:  horus guide <slug> --path"));
+  console.log(chalk12.dim("Print the guides root:    horus guide --path"));
+  console.log("");
+}
+function printGuideBody2(guidesDir, file) {
+  const content = readFileSync8(join10(guidesDir, file), "utf8");
+  console.log(content.replace(/^---\n[\s\S]*?\n---\n?/, ""));
+}
+function printDisambiguation(tier, matches) {
+  console.log("");
+  console.log(chalk12.yellow(`Multiple guides matched (tier: ${tier}):`));
+  console.log("");
+  for (const m of matches) {
+    console.log(`  ${chalk12.cyan(m.slug.padEnd(20))} ${m.title}`);
+  }
+  console.log("");
+  console.log(chalk12.dim("Pick one: horus guide <slug>"));
+  console.log("");
+}
+var guideCommand = new Command12("guide").description("Print a bundled Horus guide, or list all guides").argument("[topic]", "Slug, slug prefix, or search term. Omit to list all guides.").option("--path", "Print the file path instead of the body (or the guides dir root if no topic)").action((topic, opts) => {
+  const guidesDir = findGuidesDir2();
+  const index = loadIndex2(guidesDir);
+  if (!topic) {
+    if (opts.path) {
+      console.log(guidesDir);
+      return;
+    }
+    printGuideList(index);
+    return;
+  }
+  const result = lookupTopic(topic, index);
+  if (result.matches.length === 0) {
+    console.log("");
+    console.log(chalk12.yellow(`No guide matched "${topic}".`));
+    console.log("");
+    console.log(chalk12.dim("Run `horus guide` to see all available guides."));
+    console.log("");
+    process.exitCode = 1;
+    return;
+  }
+  if (result.matches.length > 1) {
+    printDisambiguation(result.tier, result.matches);
+    process.exitCode = 1;
+    return;
+  }
+  const match = result.matches[0];
+  if (opts.path) {
+    console.log(join10(guidesDir, match.file));
+    return;
+  }
+  printGuideBody2(guidesDir, match.file);
+});
+
+// src/commands/repo.ts
+import { Command as Command13 } from "commander";
+import chalk13 from "chalk";
+import ora9 from "ora";
+var repoCommand = new Command13("repo").description("Manage the Forge repository index");
+repoCommand.command("rindex").alias("scan").description("Trigger a full repository index rescan via Forge").action(async () => {
+  if (!configExists()) {
+    console.log(chalk13.red("Horus is not set up yet."));
+    console.log(chalk13.dim("Run `horus setup` first."));
+    process.exit(1);
+  }
+  const config = loadConfig();
+  const forgePort = config.ports.forge ?? 8200;
+  const forgeUrl = `http://localhost:${forgePort}/mcp`;
+  const spinner = ora9("Scanning repositories...").start();
+  let body;
+  try {
+    const res = await fetch(forgeUrl, {
+      method: "POST",
+      headers: { "Content-Type": "application/json" },
+      body: JSON.stringify({
+        jsonrpc: "2.0",
+        id: 1,
+        method: "tools/call",
+        params: { name: "forge_repo_scan", arguments: {} }
+      })
+    });
+    body = await res.text();
+    if (!res.ok) {
+      spinner.fail(`Forge returned HTTP ${res.status}`);
+      console.error(chalk13.red(body));
+      process.exit(1);
+    }
+  } catch (err) {
+    spinner.fail("Could not reach Forge");
+    console.error(chalk13.red(`Is Horus running? (horus up)`));
+    console.error(chalk13.dim(err.message));
+    process.exit(1);
+  }
+  let parsed;
+  try {
+    parsed = JSON.parse(body);
+  } catch {
+    spinner.fail("Unexpected response from Forge");
+    console.error(body);
+    process.exit(1);
+  }
+  if (parsed.error) {
+    spinner.fail("Scan failed");
+    console.error(chalk13.red(parsed.error.message ?? JSON.stringify(parsed.error)));
+    process.exit(1);
+  }
+  let result = {};
+  try {
+    const text = parsed.result?.content?.[0]?.text ?? "{}";
+    result = JSON.parse(text);
+  } catch {
+  }
+  spinner.succeed("Repository scan complete");
+  console.log("");
+  console.log(`  ${chalk13.bold("Scan paths:")}  ${(result.scanPaths ?? []).length}`);
+  console.log(`  ${chalk13.bold("Repos found:")} ${result.reposFound ?? 0}`);
+  if (result.repos && result.repos.length > 0) {
+    console.log("");
+    for (const repo of result.repos) {
+      console.log(`  ${chalk13.green("\u2713")} ${chalk13.bold(repo.name)}  ${chalk13.dim(repo.localPath)}`);
+    }
+  }
+  console.log("");
+});
+
 // src/index.ts
-var program = new Command11();
+var program = new Command14();
 program.name("horus").description("CLI for managing the Horus Docker Compose stack").version(CLI_VERSION);
 program.addCommand(setupCommand);
 program.addCommand(upCommand);
@@ -3389,6 +3852,9 @@ program.addCommand(updateCommand);
 program.addCommand(doctorCommand);
 program.addCommand(backupCommand);
 program.addCommand(testEnvCommand);
+program.addCommand(helpCommand);
+program.addCommand(guideCommand);
+program.addCommand(repoCommand);
 program.exitOverride();
 try {
   await program.parseAsync(process.argv);
@@ -3397,9 +3863,9 @@ try {
     process.exit(0);
   }
   if (error instanceof Error) {
-    console.error(chalk11.red(`Error: ${error.message}`));
+    console.error(chalk14.red(`Error: ${error.message}`));
   } else {
-    console.error(chalk11.red("An unexpected error occurred."));
+    console.error(chalk14.red("An unexpected error occurred."));
   }
   process.exit(1);
 }