nexus-agents 2.150.2 → 2.150.4

package/dist/{chunk-MDD3HOMI.js → chunk-GTG2XFAS.js}

@@ -18,7 +18,7 @@ import {
   DEFAULT_TASK_TTL_MS,
   DEFAULT_TOOL_RATE_LIMITS,
   clampTaskTtl
-} from "./chunk-BNQZKW3S.js";
+} from "./chunk-UIUTDHRX.js";
 import {
   executeExpert
 } from "./chunk-JYHSZDKL.js";
@@ -41,7 +41,7 @@ import {
   toJobSummary,
   warnIfSimulatedOutsideTests,
   writeJobCancelled
-} from "./chunk-SF3AM3SY.js";
+} from "./chunk-CB234Y3O.js";
 import {
   normalizeTopicToCanonical,
   synthesizeResearch
@@ -43446,7 +43446,7 @@ ${contextBlock}`;
       const strategy = config.votingStrategy ?? "higher_order";
       await postProgress(config, "Vote", `Running consensus with ${strategy} strategy...`);
       try {
-        const { executeVoting } = await import("./consensus-vote-3R7MNO26.js");
+        const { executeVoting } = await import("./consensus-vote-7R6RNZXS.js");
         const votingResult = await executeVoting(
           {
             proposal: buildVoteProposal(plan, research),
@@ -51228,4 +51228,4 @@ export {
   shutdownFeedbackSubscriber,
   createEventBusBridge
 };
-//# sourceMappingURL=chunk-MDD3HOMI.js.map
+//# sourceMappingURL=chunk-GTG2XFAS.js.map

package/dist/{chunk-BNQZKW3S.js → chunk-UIUTDHRX.js}

@@ -42,7 +42,7 @@ import {
 } from "./chunk-DHVMSIT5.js";
 
 // src/version.ts
-var VERSION = true ? "2.150.2" : "dev";
+var VERSION = true ? "2.150.4" : "dev";
 
 // src/config/schemas-core.ts
 import { z } from "zod";
@@ -2132,7 +2132,7 @@ async function runDoctorFix(result) {
   writeLine2("\u2500".repeat(40));
   let fixCount = 0;
   if (!result.dataDirectory.rootExists || result.dataDirectory.subdirectories.some((d) => !d.exists || !d.writable)) {
-    const { runSetup } = await import("./setup-command-YJ7PCU54.js");
+    const { runSetup } = await import("./setup-command-OL2A2GCI.js");
     const setupResult = runSetup({
       skipMcp: true,
       skipRules: true,
@@ -2245,4 +2245,4 @@ export {
   startStdioServer,
   closeServer
 };
-//# sourceMappingURL=chunk-BNQZKW3S.js.map
+//# sourceMappingURL=chunk-UIUTDHRX.js.map

package/dist/cli.js

@@ -22,7 +22,7 @@ import "./chunk-M4YN3U3P.js";
 import {
   setupCommandAsync,
   verifyCommand
-} from "./chunk-2ZUXJTIA.js";
+} from "./chunk-4ELTYI33.js";
 import "./chunk-CD7FU55Z.js";
 import {
   AuthHandler,
@@ -142,7 +142,7 @@ import {
   validateCommand,
   validateWorkflow,
   wrapInMarkdownFence
-} from "./chunk-MDD3HOMI.js";
+} from "./chunk-GTG2XFAS.js";
 import "./chunk-CMAQI2SJ.js";
 import "./chunk-T2SGTVB4.js";
 import "./chunk-HFOQKCD2.js";
@@ -170,7 +170,7 @@ import {
   loadConfig,
   runDoctor,
   validateNexusEnv
-} from "./chunk-BNQZKW3S.js";
+} from "./chunk-UIUTDHRX.js";
 import "./chunk-GMQH2I4P.js";
 import {
   shutdownExpertBridge
@@ -183,7 +183,7 @@ import {
   VoteThresholdSchema,
   executeVoting,
   registerConsensusVoteTool
-} from "./chunk-SF3AM3SY.js";
+} from "./chunk-CB234Y3O.js";
 import {
   loadUsageEvents,
   rollupByModel
@@ -20411,7 +20411,258 @@ function parsePositiveInt(arg, defaultVal) {
   return Number.isNaN(parsed) || parsed <= 0 ? defaultVal : parsed;
 }
 
+// src/cli-command-help.ts
+var ORCHESTRATE_HELP = {
+  command: "orchestrate",
+  examples: [
+    'nexus-agents orchestrate "Explain this function"',
+    'nexus-agents orchestrate "Generate unit tests" --model=claude',
+    'nexus-agents orchestrate "Refactor code" --format=json --dry-run',
+    'nexus-agents orchestrate "Build feature" --engine=puppeteer --max-tokens=50000'
+  ],
+  flags: [
+    {
+      flag: "--engine=<name>",
+      description: "Execution engine: router, puppeteer",
+      defaultValue: "router"
+    },
+    { flag: "--model=<cli>", description: "Target CLI: claude, gemini, codex, opencode" },
+    { flag: "--max-tokens=<n>", description: "Maximum token budget", defaultValue: "100000" },
+    { flag: "--max-cost-usd=<n>", description: "Maximum cost budget in USD", defaultValue: "10" },
+    { flag: "--format=<fmt>", description: "Output format: text, json", defaultValue: "text" },
+    { flag: "--dry-run", description: "Show routing decision without executing" }
+  ],
+  requiresApiKey: ["ANTHROPIC_API_KEY", "OPENAI_API_KEY", "GOOGLE_AI_API_KEY"]
+};
+var VOTE_HELP = {
+  command: "vote",
+  examples: [
+    'nexus-agents vote --proposal "Add caching layer"',
+    'nexus-agents vote -p "Migrate to PostgreSQL" -t supermajority',
+    'nexus-agents vote -p "Quick decision" --quick',
+    'nexus-agents vote -p "Test idea" --dry-run'
+  ],
+  flags: [
+    { flag: "-p, --proposal <text>", description: "Proposal text to vote on (required)" },
+    { flag: "-t, --threshold <t>", description: "Threshold: majority, supermajority, unanimous" },
+    { flag: "--quick", description: "Use 3 agents instead of the full 7 for faster votes" },
+    { flag: "--dry-run", description: "Simulate votes without agent execution" },
+    { flag: "--timeout=<seconds>", description: "Timeout per vote in seconds", defaultValue: "90" },
+    {
+      flag: "--error-policy <p>",
+      description: "How to count errored/timed-out voters: reduce_denominator | count_as_abstain | fail_closed (default: fail_closed for unanimous, reduce_denominator otherwise)"
+    },
+    { flag: "--verbose", description: "Show vote verification hashes" }
+  ],
+  requiresApiKey: ["ANTHROPIC_API_KEY", "OPENAI_API_KEY", "GOOGLE_AI_API_KEY"]
+};
+var EXPERT_HELP = {
+  command: "expert",
+  examples: ["nexus-agents expert list", "nexus-agents expert list --format=json"],
+  flags: [
+    {
+      flag: "--format=<fmt>",
+      description: "Output format: table, json, yaml",
+      defaultValue: "table"
+    }
+  ]
+};
+var WORKFLOW_HELP = {
+  command: "workflow",
+  examples: [
+    "nexus-agents workflow list",
+    `nexus-agents workflow run code-review --input='{"url":"https://github.com/o/r/pull/1"}'`,
+    "nexus-agents workflow run code-review --dry-run"
+  ],
+  flags: [
+    { flag: "-i, --input <json>", description: "Workflow inputs as JSON string or file path" },
+    { flag: "--dry-run", description: "Validate workflow without executing" }
+  ]
+};
+var DOCTOR_HELP = {
+  command: "doctor",
+  examples: ["nexus-agents doctor", "nexus-agents doctor --deep", "nexus-agents doctor --fix"],
+  flags: [
+    { flag: "--deep", description: "Run deep health checks (adapter connectivity)" },
+    { flag: "--fix", description: "Auto-fix correctable issues (data dirs, config)" },
+    { flag: "--verbose", description: "Show detailed check output" }
+  ]
+};
+var MODE_HELP = {
+  command: "mode",
+  examples: [
+    "nexus-agents mode",
+    "nexus-agents mode --format=json",
+    "nexus-agents mode --mode=mesh"
+  ],
+  flags: [
+    { flag: "--format=<fmt>", description: "Output format: text, json", defaultValue: "text" },
+    {
+      flag: "--mode=<m>",
+      description: "Report what an explicit override would resolve to: server, orchestrator, mesh"
+    }
+  ]
+};
+var SETUP_HELP = {
+  command: "setup",
+  examples: [
+    "nexus-agents setup",
+    "nexus-agents setup --interactive",
+    "nexus-agents setup --skip-mcp --skip-hooks",
+    "nexus-agents setup --scope=project --dry-run"
+  ],
+  flags: [
+    { flag: "--interactive", description: "Run guided setup wizard with prompts" },
+    { flag: "--non-interactive", description: "Skip prompts (for CI/automation)" },
+    { flag: "--force", description: "Overwrite existing configuration files" },
+    { flag: "--skip-mcp", description: "Skip MCP configuration" },
+    { flag: "--skip-config", description: "Skip config file generation" },
+    { flag: "--skip-rules", description: "Skip .rules generation" },
+    { flag: "--skip-hooks", description: "Skip hook configuration" },
+    { flag: "--skip-opencode", description: "Skip OpenCode MCP setup" },
+    { flag: "--skip-gemini", description: "Skip Gemini MCP setup" },
+    { flag: "--skip-codex", description: "Skip Codex MCP setup" },
+    {
+      flag: "--scope=<scope>",
+      description: "MCP config scope: user, project",
+      defaultValue: "user"
+    },
+    { flag: "--dry-run", description: "Show changes without applying them" },
+    {
+      flag: "--custom-api <url>",
+      description: "Configure OpenAI-compatible gateway (short-circuits normal setup; validates URL + probes /models) [#2124]"
+    },
+    { flag: "--custom-api-key <key>", description: "API key for --custom-api (else prompt/env)" },
+    {
+      flag: "--custom-model <id>",
+      description: "Default model for --custom-api (default: gpt-4o)"
+    }
+  ]
+};
+var CONFIG_HELP = {
+  command: "config",
+  examples: [
+    "nexus-agents config init",
+    "nexus-agents config get TIMEOUT_DEFAULTS.cliMs",
+    "nexus-agents config set TIMEOUT_DEFAULTS.cliMs 90000",
+    "nexus-agents config list",
+    "nexus-agents config export ./config.json",
+    "nexus-agents config import ./config.yaml"
+  ],
+  flags: [
+    {
+      flag: "-o, --output <path>",
+      description: "Output path for config init",
+      defaultValue: "./nexus-agents.yaml"
+    },
+    { flag: "-f, --force", description: "Overwrite existing configuration file" }
+  ]
+};
+var RESEARCH_HELP = {
+  command: "research",
+  examples: [
+    "nexus-agents research status",
+    "nexus-agents research stats --format=json",
+    "nexus-agents research add 2401.12345",
+    "nexus-agents research refresh",
+    "nexus-agents research check"
+  ],
+  flags: [
+    { flag: "--format=<fmt>", description: "Output format: table, json", defaultValue: "table" },
+    { flag: "-o, --output=<path>", description: "Custom output path for refresh" }
+  ]
+};
+var FITNESS_AUDIT_HELP = {
+  command: "fitness-audit",
+  examples: [
+    "nexus-agents fitness-audit",
+    "nexus-agents fitness-audit --format=json",
+    "nexus-agents fitness-audit --min-severity=warning"
+  ],
+  flags: [
+    { flag: "--format=<fmt>", description: "Output format: json, text", defaultValue: "text" },
+    {
+      flag: "--min-severity=<sev>",
+      description: "Filter: info, warning, critical",
+      defaultValue: "all"
+    }
+  ]
+};
+var REVIEW_HELP = {
+  command: "review",
+  examples: [
+    "nexus-agents review https://github.com/owner/repo/pull/123",
+    "nexus-agents review owner/repo#123 --dry-run",
+    "nexus-agents review --setup"
+  ],
+  flags: [
+    { flag: "--setup", description: "Run review setup wizard" },
+    { flag: "--dry-run", description: "Review without posting to GitHub" },
+    { flag: "--skip-checks", description: "Skip pre-flight validation" }
+  ]
+};
+var COMMAND_HELP = [
+  ORCHESTRATE_HELP,
+  VOTE_HELP,
+  EXPERT_HELP,
+  WORKFLOW_HELP,
+  DOCTOR_HELP,
+  MODE_HELP,
+  SETUP_HELP,
+  CONFIG_HELP,
+  RESEARCH_HELP,
+  FITNESS_AUDIT_HELP,
+  REVIEW_HELP
+];
+function formatFlag(entry) {
+  const defaultSuffix = entry.defaultValue !== void 0 ? ` (default: ${entry.defaultValue})` : "";
+  return `  ${entry.flag.padEnd(28)} ${entry.description}${defaultSuffix}`;
+}
+function describe(command) {
+  return getCommandDescription(command) ?? "";
+}
+function getCommandHelp(command) {
+  return COMMAND_HELP.find((e) => e.command === command);
+}
+function formatCommandHelp(command) {
+  const entry = getCommandHelp(command);
+  if (entry === void 0) return void 0;
+  const lines = [];
+  lines.push(`nexus-agents ${entry.command} -- ${describe(entry.command)}`);
+  lines.push("");
+  if (entry.flags !== void 0 && entry.flags.length > 0) {
+    lines.push("FLAGS:");
+    for (const flag of entry.flags) {
+      lines.push(formatFlag(flag));
+    }
+    lines.push("");
+  }
+  if (entry.requiresApiKey !== void 0 && entry.requiresApiKey.length > 0) {
+    lines.push(`REQUIRES: ${entry.requiresApiKey.join(", ")} (at least one)`);
+    lines.push("");
+  }
+  lines.push("EXAMPLES:");
+  for (const example of entry.examples) {
+    lines.push(`  ${example}`);
+  }
+  return lines.join("\n");
+}
+
 // src/cli-commands-usage.ts
+function printUsageWithExamples(opts) {
+  process.stdout.write(`Error: ${opts.error}
+`);
+  process.stdout.write(`Usage: ${opts.usage}
+`);
+  const examples = getCommandHelp(opts.command)?.examples ?? [];
+  if (examples.length > 0) {
+    process.stdout.write("Examples:\n");
+    for (const example of examples) {
+      process.stdout.write(`  ${example}
+`);
+    }
+  }
+}
 function printWorkflowRunUsage() {
   process.stdout.write("Error: Workflow name is required.\n");
   process.stdout.write("Usage: nexus-agents workflow run <name> [options]\n");
@@ -20425,20 +20676,18 @@ function printRoutingAuditUsage() {
   process.stdout.write('  nexus-agents routing-audit "Generate tests" --format=json\n');
 }
 function printOrchestrateUsage() {
-  process.stdout.write("Error: Task description is required.\n");
-  process.stdout.write("Usage: nexus-agents orchestrate <task> [options]\n");
-  process.stdout.write("Examples:\n");
-  process.stdout.write('  nexus-agents orchestrate "Explain this function"\n');
-  process.stdout.write('  nexus-agents orchestrate "Generate tests" --model=claude\n');
-  process.stdout.write('  nexus-agents orchestrate "Refactor code" --dry-run\n');
+  printUsageWithExamples({
+    error: "Task description is required.",
+    usage: "nexus-agents orchestrate <task> [options]",
+    command: "orchestrate"
+  });
 }
 function printVoteUsage() {
-  process.stdout.write("Error: Proposal is required.\n");
-  process.stdout.write('Usage: nexus-agents vote --proposal "..." [options]\n');
-  process.stdout.write("Examples:\n");
-  process.stdout.write('  nexus-agents vote --proposal "Add feature X"\n');
-  process.stdout.write('  nexus-agents vote -p "Proposal" -t supermajority\n');
-  process.stdout.write('  nexus-agents vote -p "Quick decision" --quick\n');
+  printUsageWithExamples({
+    error: "Proposal is required.",
+    usage: 'nexus-agents vote --proposal "..." [options]',
+    command: "vote"
+  });
 }
 function printIndexUsage() {
   process.stdout.write("Error: Index subcommand is required.\n");
@@ -25327,240 +25576,6 @@ async function dispatchCommand(args) {
   }
 }
 
-// src/cli-command-help.ts
-var ORCHESTRATE_HELP = {
-  command: "orchestrate",
-  examples: [
-    'nexus-agents orchestrate "Explain this function"',
-    'nexus-agents orchestrate "Generate unit tests" --model=claude',
-    'nexus-agents orchestrate "Refactor code" --format=json --dry-run',
-    'nexus-agents orchestrate "Build feature" --engine=puppeteer --max-tokens=50000'
-  ],
-  flags: [
-    {
-      flag: "--engine=<name>",
-      description: "Execution engine: router, puppeteer",
-      defaultValue: "router"
-    },
-    { flag: "--model=<cli>", description: "Target CLI: claude, gemini, codex, opencode" },
-    { flag: "--max-tokens=<n>", description: "Maximum token budget", defaultValue: "100000" },
-    { flag: "--max-cost-usd=<n>", description: "Maximum cost budget in USD", defaultValue: "10" },
-    { flag: "--format=<fmt>", description: "Output format: text, json", defaultValue: "text" },
-    { flag: "--dry-run", description: "Show routing decision without executing" }
-  ],
-  requiresApiKey: ["ANTHROPIC_API_KEY", "OPENAI_API_KEY", "GOOGLE_AI_API_KEY"]
-};
-var VOTE_HELP = {
-  command: "vote",
-  examples: [
-    'nexus-agents vote --proposal "Add caching layer"',
-    'nexus-agents vote -p "Migrate to PostgreSQL" -t supermajority',
-    'nexus-agents vote -p "Quick decision" --quick',
-    'nexus-agents vote -p "Test idea" --dry-run'
-  ],
-  flags: [
-    { flag: "-p, --proposal <text>", description: "Proposal text to vote on (required)" },
-    { flag: "-t, --threshold <t>", description: "Threshold: majority, supermajority, unanimous" },
-    { flag: "--quick", description: "Use 3 agents instead of the full 7 for faster votes" },
-    { flag: "--dry-run", description: "Simulate votes without agent execution" },
-    { flag: "--timeout=<seconds>", description: "Timeout per vote in seconds", defaultValue: "90" },
-    {
-      flag: "--error-policy <p>",
-      description: "How to count errored/timed-out voters: reduce_denominator | count_as_abstain | fail_closed (default: fail_closed for unanimous, reduce_denominator otherwise)"
-    },
-    { flag: "--verbose", description: "Show vote verification hashes" }
-  ],
-  requiresApiKey: ["ANTHROPIC_API_KEY", "OPENAI_API_KEY", "GOOGLE_AI_API_KEY"]
-};
-var EXPERT_HELP = {
-  command: "expert",
-  examples: ["nexus-agents expert list", "nexus-agents expert list --format=json"],
-  flags: [
-    {
-      flag: "--format=<fmt>",
-      description: "Output format: table, json, yaml",
-      defaultValue: "table"
-    }
-  ]
-};
-var WORKFLOW_HELP = {
-  command: "workflow",
-  examples: [
-    "nexus-agents workflow list",
-    `nexus-agents workflow run code-review --input='{"url":"https://github.com/o/r/pull/1"}'`,
-    "nexus-agents workflow run code-review --dry-run"
-  ],
-  flags: [
-    { flag: "-i, --input <json>", description: "Workflow inputs as JSON string or file path" },
-    { flag: "--dry-run", description: "Validate workflow without executing" }
-  ]
-};
-var DOCTOR_HELP = {
-  command: "doctor",
-  examples: ["nexus-agents doctor", "nexus-agents doctor --deep", "nexus-agents doctor --fix"],
-  flags: [
-    { flag: "--deep", description: "Run deep health checks (adapter connectivity)" },
-    { flag: "--fix", description: "Auto-fix correctable issues (data dirs, config)" },
-    { flag: "--verbose", description: "Show detailed check output" }
-  ]
-};
-var MODE_HELP = {
-  command: "mode",
-  examples: [
-    "nexus-agents mode",
-    "nexus-agents mode --format=json",
-    "nexus-agents mode --mode=mesh"
-  ],
-  flags: [
-    { flag: "--format=<fmt>", description: "Output format: text, json", defaultValue: "text" },
-    {
-      flag: "--mode=<m>",
-      description: "Report what an explicit override would resolve to: server, orchestrator, mesh"
-    }
-  ]
-};
-var SETUP_HELP = {
-  command: "setup",
-  examples: [
-    "nexus-agents setup",
-    "nexus-agents setup --interactive",
-    "nexus-agents setup --skip-mcp --skip-hooks",
-    "nexus-agents setup --scope=project --dry-run"
-  ],
-  flags: [
-    { flag: "--interactive", description: "Run guided setup wizard with prompts" },
-    { flag: "--non-interactive", description: "Skip prompts (for CI/automation)" },
-    { flag: "--force", description: "Overwrite existing configuration files" },
-    { flag: "--skip-mcp", description: "Skip MCP configuration" },
-    { flag: "--skip-config", description: "Skip config file generation" },
-    { flag: "--skip-rules", description: "Skip .rules generation" },
-    { flag: "--skip-hooks", description: "Skip hook configuration" },
-    { flag: "--skip-opencode", description: "Skip OpenCode MCP setup" },
-    { flag: "--skip-gemini", description: "Skip Gemini MCP setup" },
-    { flag: "--skip-codex", description: "Skip Codex MCP setup" },
-    {
-      flag: "--scope=<scope>",
-      description: "MCP config scope: user, project",
-      defaultValue: "user"
-    },
-    { flag: "--dry-run", description: "Show changes without applying them" },
-    {
-      flag: "--custom-api <url>",
-      description: "Configure OpenAI-compatible gateway (short-circuits normal setup; validates URL + probes /models) [#2124]"
-    },
-    { flag: "--custom-api-key <key>", description: "API key for --custom-api (else prompt/env)" },
-    {
-      flag: "--custom-model <id>",
-      description: "Default model for --custom-api (default: gpt-4o)"
-    }
-  ]
-};
-var CONFIG_HELP = {
-  command: "config",
-  examples: [
-    "nexus-agents config init",
-    "nexus-agents config get TIMEOUT_DEFAULTS.cliMs",
-    "nexus-agents config set TIMEOUT_DEFAULTS.cliMs 90000",
-    "nexus-agents config list",
-    "nexus-agents config export ./config.json",
-    "nexus-agents config import ./config.yaml"
-  ],
-  flags: [
-    {
-      flag: "-o, --output <path>",
-      description: "Output path for config init",
-      defaultValue: "./nexus-agents.yaml"
-    },
-    { flag: "-f, --force", description: "Overwrite existing configuration file" }
-  ]
-};
-var RESEARCH_HELP = {
-  command: "research",
-  examples: [
-    "nexus-agents research status",
-    "nexus-agents research stats --format=json",
-    "nexus-agents research add 2401.12345",
-    "nexus-agents research refresh",
-    "nexus-agents research check"
-  ],
-  flags: [
-    { flag: "--format=<fmt>", description: "Output format: table, json", defaultValue: "table" },
-    { flag: "-o, --output=<path>", description: "Custom output path for refresh" }
-  ]
-};
-var FITNESS_AUDIT_HELP = {
-  command: "fitness-audit",
-  examples: [
-    "nexus-agents fitness-audit",
-    "nexus-agents fitness-audit --format=json",
-    "nexus-agents fitness-audit --min-severity=warning"
-  ],
-  flags: [
-    { flag: "--format=<fmt>", description: "Output format: json, text", defaultValue: "text" },
-    {
-      flag: "--min-severity=<sev>",
-      description: "Filter: info, warning, critical",
-      defaultValue: "all"
-    }
-  ]
-};
-var REVIEW_HELP = {
-  command: "review",
-  examples: [
-    "nexus-agents review https://github.com/owner/repo/pull/123",
-    "nexus-agents review owner/repo#123 --dry-run",
-    "nexus-agents review --setup"
-  ],
-  flags: [
-    { flag: "--setup", description: "Run review setup wizard" },
-    { flag: "--dry-run", description: "Review without posting to GitHub" },
-    { flag: "--skip-checks", description: "Skip pre-flight validation" }
-  ]
-};
-var COMMAND_HELP = [
-  ORCHESTRATE_HELP,
-  VOTE_HELP,
-  EXPERT_HELP,
-  WORKFLOW_HELP,
-  DOCTOR_HELP,
-  MODE_HELP,
-  SETUP_HELP,
-  CONFIG_HELP,
-  RESEARCH_HELP,
-  FITNESS_AUDIT_HELP,
-  REVIEW_HELP
-];
-function formatFlag(entry) {
-  const defaultSuffix = entry.defaultValue !== void 0 ? ` (default: ${entry.defaultValue})` : "";
-  return `  ${entry.flag.padEnd(28)} ${entry.description}${defaultSuffix}`;
-}
-function describe(command) {
-  return getCommandDescription(command) ?? "";
-}
-function formatCommandHelp(command) {
-  const entry = COMMAND_HELP.find((e) => e.command === command);
-  if (entry === void 0) return void 0;
-  const lines = [];
-  lines.push(`nexus-agents ${entry.command} -- ${describe(entry.command)}`);
-  lines.push("");
-  if (entry.flags !== void 0 && entry.flags.length > 0) {
-    lines.push("FLAGS:");
-    for (const flag of entry.flags) {
-      lines.push(formatFlag(flag));
-    }
-    lines.push("");
-  }
-  if (entry.requiresApiKey !== void 0 && entry.requiresApiKey.length > 0) {
-    lines.push(`REQUIRES: ${entry.requiresApiKey.join(", ")} (at least one)`);
-    lines.push("");
-  }
-  lines.push("EXAMPLES:");
-  for (const example of entry.examples) {
-    lines.push(`  ${example}`);
-  }
-  return lines.join("\n");
-}
-
 // src/cli-command-suggester.ts
 var MAX_SUGGESTIONS = 3;
 var MAX_ABSOLUTE_DISTANCE = 2;