cc-codeconductor 1.4.0 → 1.4.1

package/dist/index.js

@@ -72,7 +72,7 @@ var package_default;
 var init_package = __esm(() => {
   package_default = {
     name: "cc-codeconductor",
-    version: "1.4.0",
+    version: "1.4.1",
     description: "A multi-agent orchestration framework for AI-assisted software engineering workflows.",
     keywords: [
       "ai",
@@ -4145,6 +4145,38 @@ var init_runner_target = __esm(() => {
   INDIVIDUAL_TARGETS = ["opencode", "claude", "codex", "gemini", "cursor", "agy", "pi"];
 });
 
+// src/utils/cli-bin.ts
+import { basename } from "node:path";
+function resolveCliBin(env = process.env, argv = process.argv) {
+  if (env.CC_CLI_BIN) {
+    return env.CC_CLI_BIN;
+  }
+  if (env.npm_lifecycle_event === "npx" || env.npm_command === "exec" || env._?.endsWith("/npx") || env._ === "npx") {
+    return "npx cc-codeconductor";
+  }
+  if (env._?.endsWith("/bunx") || env._ === "bunx") {
+    return "bunx cc-codeconductor";
+  }
+  if (env.npm_lifecycle_event === "dev") {
+    return env.npm_lifecycle_script?.startsWith("bun") ? "bun run dev" : "npm run dev";
+  }
+  if (argv && argv.length > 1 && argv[1]) {
+    const script = argv[1];
+    const binName = basename(script);
+    if (binName === "main.ts") {
+      return "bun run dev";
+    }
+    if (binName === "cc-codeconductor" || binName === "codeconductor") {
+      return binName;
+    }
+  }
+  return "cc-codeconductor";
+}
+function formatUsage(usage, bin = resolveCliBin()) {
+  return usage.replace(/^(?:cc-codeconductor|codeconductor|cc)\b/, bin);
+}
+var init_cli_bin = () => {};
+
 // node_modules/yaml/dist/nodes/identity.js
 var require_identity = __commonJS(function(exports) {
   var ALIAS = Symbol.for("yaml.alias");
@@ -12670,7 +12702,7 @@ var init_safety = __esm(() => {
 // src/core/filesystem/path-containment.ts
 import { constants as constants2 } from "node:fs";
 import { lstat, mkdir, open, realpath } from "node:fs/promises";
-import { basename, dirname as dirname2, isAbsolute, join as join2, relative, resolve as resolve3, sep as sep2 } from "node:path";
+import { basename as basename2, dirname as dirname2, isAbsolute, join as join2, relative, resolve as resolve3, sep as sep2 } from "node:path";
 function isInside(root, target) {
   const rel = relative(root, target);
   return rel !== "" && rel !== ".." && !rel.startsWith(`..${sep2}`) && !isAbsolute(rel);
@@ -12745,7 +12777,7 @@ async function canonicalizeExistingPrefix(target) {
       if (parent === current) {
         throw error;
       }
-      pending.unshift(basename(current));
+      pending.unshift(basename2(current));
       current = parent;
     }
   }
@@ -13031,8 +13063,8 @@ function mergeDeep(target, source) {
 }
 function extractAgentRole(filePath) {
   const parts = filePath.replace(/\\/g, "/").split("/");
-  const basename2 = parts[parts.length - 1];
-  const name = basename2.replace(/\.md$/, "");
+  const basename3 = parts[parts.length - 1];
+  const name = basename3.replace(/\.md$/, "");
   const knownRoles = [
     "architect",
     "implementer",
@@ -14282,7 +14314,7 @@ var init_agy_installer = __esm(() => {
 
 // src/core/presets/update-checker.ts
 import { stat as stat2, readFile as readFile7 } from "node:fs/promises";
-import { resolve as resolve7, join as join5, basename as basename2, dirname as dirname4 } from "node:path";
+import { resolve as resolve7, join as join5, basename as basename3, dirname as dirname4 } from "node:path";
 import { homedir as homedir3 } from "node:os";
 function getTargetInstallationPath(target, basePath, isGlobal) {
   if (target === "agy") {
@@ -14399,7 +14431,7 @@ async function validateSkillFrontmatterFiles(basePath, isGlobal) {
       }
       const files = await resolveEntryFiles(resolvedEntry, PRESETS_DIR, targetBaseDir);
       for (const { dest } of files) {
-        if (basename2(dest) !== "SKILL.md")
+        if (basename3(dest) !== "SKILL.md")
           continue;
         let content;
         try {
@@ -14412,7 +14444,7 @@ async function validateSkillFrontmatterFiles(basePath, isGlobal) {
           results.push({ path: dest, error: `${parsed.error.kind}: ${parsed.error.message}` });
           continue;
         }
-        const dir = basename2(dirname4(dest));
+        const dir = basename3(dirname4(dest));
         const ident = skillIdentifier(parsed.frontmatter);
         if (ident !== dir) {
           results.push({
@@ -16149,7 +16181,7 @@ __export(exports_init_command, {
 });
 import { access as access4, mkdir as mkdir5, readFile as readFile10, writeFile as writeFile4 } from "node:fs/promises";
 import { homedir as homedir6 } from "node:os";
-import { basename as basename3, resolve as resolve11 } from "node:path";
+import { basename as basename4, resolve as resolve11 } from "node:path";
 async function initCommand(options) {
   const { projectRoot, dryRun, force, global: isGlobal, output, locale } = options;
   const baseDir = isGlobal ? homedir6() : projectRoot;
@@ -16170,7 +16202,7 @@ async function initCommand(options) {
     }
     const config = profile ? {
       project: {
-        name: basename3(projectRoot) || "unnamed-project",
+        name: basename4(projectRoot) || "unnamed-project",
         profile: profile.runtimes[0] || "unknown"
       },
       defaults: {
@@ -16887,7 +16919,7 @@ __export(exports_install_command, {
 });
 import { readFile as readFile11 } from "node:fs/promises";
 import { homedir as homedir7 } from "node:os";
-import { basename as basename4, dirname as dirname6, resolve as resolve12, sep as sep3 } from "node:path";
+import { basename as basename5, dirname as dirname6, resolve as resolve12, sep as sep3 } from "node:path";
 async function installCommand(options) {
   const { target, dryRun, force, global: isGlobal, output, projectRoot } = options;
   const baseDir = isGlobal ? homedir7() : projectRoot;
@@ -17026,12 +17058,12 @@ async function verifyRenderedFiles(manifest, baseDir, results) {
     if (leaked.length > 0) {
       warnings.push(`${r.dest}: unresolved placeholder(s) ${leaked.join(", ")}`);
     }
-    if (basename4(r.dest) === "SKILL.md") {
+    if (basename5(r.dest) === "SKILL.md") {
       const parsed = parseSkillFrontmatter(content);
       if (!parsed.ok) {
         warnings.push(`${r.dest}: ${parsed.error.kind} — ${parsed.error.message}`);
       } else {
-        const dir = basename4(dirname6(r.dest));
+        const dir = basename5(dirname6(r.dest));
         const ident = skillIdentifier(parsed.frontmatter);
         if (ident !== dir) {
           warnings.push(`${r.dest}: identifier "${ident}" does not match its directory "${dir}"`);
@@ -17274,6 +17306,7 @@ __export(exports_status_command, {
 });
 import { resolve as resolve13 } from "node:path";
 async function statusCommand(options) {
+  const bin = resolveCliBin();
   const [configResult, state] = await Promise.all([
     loadConfig(options.projectRoot),
     readInstallationState(options.projectRoot)
@@ -17316,7 +17349,7 @@ async function statusCommand(options) {
     ...modifiedFiles.length ? [`  locally modified managed files: ${modifiedFiles.length}`] : [],
     ...data.updates?.conflicts.length ? [`  conflicts: ${data.updates.conflicts.join(", ")}`] : [],
     "",
-    "Run `cc doctor` for diagnostics."
+    `Run \`${bin} doctor\` for diagnostics.`
   ].join(`
 `);
   return { code: 0, data: { ...data, output } };
@@ -17326,6 +17359,7 @@ var init_status_command = __esm(() => {
   init_installation_state();
   init_update_checker();
   init_runner_target();
+  init_cli_bin();
 });
 
 // src/commands/detect.command.ts
@@ -20118,7 +20152,7 @@ async function loadGraph(projectRoot) {
     return ok(ProductGraphSchema.parse(JSON.parse(raw)));
   } catch (e) {
     if (e.code === "ENOENT") {
-      return err(new Error("Product graph not found. Run `cc ingest` first."));
+      return err(new Error(`Product graph not found. Run \`${resolveCliBin()} ingest\` first.`));
     }
     return err(e instanceof Error ? e : new Error(String(e)));
   }
@@ -20212,6 +20246,7 @@ function getNeighbors(graph, nodeId, relation) {
 }
 var init_graph_store = __esm(() => {
   init_schemas();
+  init_cli_bin();
   init_paths();
 });
 
@@ -20740,9 +20775,9 @@ import { join as join15 } from "node:path";
 async function parseAdrFile(filePath) {
   try {
     const content = await readFile19(filePath, "utf-8");
-    const basename5 = filePath.split("/").pop() ?? "";
-    const idMatch = basename5.match(/adr-(\d+)/i);
-    const id = idMatch ? `adr-${idMatch[1]}` : slugify(basename5);
+    const basename6 = filePath.split("/").pop() ?? "";
+    const idMatch = basename6.match(/adr-(\d+)/i);
+    const id = idMatch ? `adr-${idMatch[1]}` : slugify(basename6);
     const titleMatch = content.match(/^#\s+ADR-\d+:\s*(.+)$/m);
     const statusMatch = content.match(/\*\*Status:\*\*\s*(\w+)/i);
     const contextSection = extractSection(content, "Context");
@@ -20752,7 +20787,7 @@ async function parseAdrFile(filePath) {
 `).filter((l) => l.trim().startsWith("-") || l.trim().startsWith("*")).map((l) => l.replace(/^[\s*-]+/, "").trim()).filter(Boolean);
     return {
       id,
-      title: titleMatch?.[1]?.trim() ?? basename5,
+      title: titleMatch?.[1]?.trim() ?? basename6,
       status: statusMatch?.[1]?.toLowerCase() ?? "unknown",
       context: contextSection.trim(),
       decision: decisionSection.trim(),
@@ -23230,7 +23265,7 @@ async function handleRun(projectRoot, output, taskId, complete, allowCompileChec
       data: {
         success: false,
         command: "orchestrate",
-        errors: ["Verification failed. Run `cc verify --task " + taskId + "`"]
+        errors: ["Verification failed. Run `" + resolveCliBin() + " verify --task " + taskId + "`"]
       }
     };
   }
@@ -23294,6 +23329,7 @@ var init_orchestrate_command = __esm(() => {
   init_product_planner();
   init_graph_store();
   init_loop_engine();
+  init_cli_bin();
 });
 
 // src/core/impact/impact-engine.ts
@@ -25722,7 +25758,7 @@ var init_backlog_planner = __esm(() => {
 
 // src/core/openspec/openspec-generator.ts
 import { mkdir as mkdir21, rename as rename4, writeFile as writeFile21 } from "node:fs/promises";
-import { basename as basename5, resolve as resolve30 } from "node:path";
+import { basename as basename6, resolve as resolve30 } from "node:path";
 function pad3(n) {
   return String(n).padStart(3, "0");
 }
@@ -25869,7 +25905,7 @@ capabilities:
 }
 async function archiveChangeFolder(projectRoot, changePath) {
   const src = resolve30(projectRoot, changePath);
-  const slug = basename5(changePath);
+  const slug = basename6(changePath);
   const destDir = resolve30(projectRoot, "openspec", "changes", "archive");
   await mkdir21(destDir, { recursive: true });
   const dest = resolve30(destDir, slug);
@@ -30680,6 +30716,7 @@ __export(exports_onboarding_command, {
   onboardingCommand: () => onboardingCommand
 });
 async function onboardingCommand(projectRoot) {
+  const bin = resolveCliBin();
   const [config, profile, state] = await Promise.all([
     loadConfig(projectRoot),
     detectProject(projectRoot),
@@ -30703,18 +30740,18 @@ async function onboardingCommand(projectRoot) {
           "",
           "Get started:",
           "  1. Inspect what will be installed",
-          "     cc setup --dry-run",
+          `     ${bin} setup --dry-run`,
           "  2. Configure the harness",
-          "     cc setup",
+          `     ${bin} setup`,
           "  3. Verify the installation",
-          "     cc doctor",
+          `     ${bin} doctor`,
           "",
           `Detected project: ${[...profile.runtimes, ...profile.frameworks].join(", ") || "unknown"}`,
           `Recommended preset: ${recommendation.stack}`,
           "",
           "Documentation:",
-          "  cc help setup",
-          "  cc docs getting-started"
+          `  ${bin} help setup`,
+          `  ${bin} docs getting-started`
         ].join(`
 `)
       }
@@ -30737,12 +30774,12 @@ async function onboardingCommand(projectRoot) {
         `  locale          ${config.data.defaults.locale}`,
         "",
         "Run:",
-        "  cc status",
-        "  cc doctor",
-        "  cc update --check",
+        `  ${bin} status`,
+        `  ${bin} doctor`,
+        `  ${bin} update --check`,
         "",
         "Other commands:",
-        "  cc help"
+        `  ${bin} help`
       ].join(`
 `)
     }
@@ -30753,6 +30790,7 @@ var init_onboarding_command = __esm(() => {
   init_config_loader();
   init_project_detector();
   init_installation_state();
+  init_cli_bin();
 });
 
 // src/cli/execute.ts
@@ -30765,36 +30803,37 @@ init_runner_target();
 
 // src/cli/command-registry.ts
 init_package();
+init_cli_bin();
 var COMMANDS = [
-  { name: "setup", group: "getting-started", summary: "Configure and install CodeConductor.", usage: ["cc setup [--target <target>] [--locale en|es] [--yes] [--dry-run]"] },
-  { name: "detect", group: "getting-started", summary: "Inspect the project stack and recommended presets.", usage: ["cc detect"] },
-  { name: "init", group: "getting-started", summary: "Initialize low-level CodeConductor configuration.", usage: ["cc init [--locale en|es]"] },
-  { name: "install", group: "getting-started", summary: "Install harness components.", usage: ["cc install preset --target <target>"], options: ["--target opencode|claude|codex|gemini|cursor|agy|pi|all"], subcommands: [
-    { name: "preset", group: "getting-started", summary: "Install agents, prompts, skills, and commands.", usage: ["cc install preset --target <target> [--locale en|es]"] },
-    { name: "council", group: "getting-started", summary: "Install generated council files.", usage: ["cc install council --target <target>"] },
-    { name: "lsp", group: "getting-started", summary: "Install supported language servers.", usage: ["cc install lsp --target <target> [--lang typescript,python]"] }
+  { name: "setup", group: "getting-started", summary: "Configure and install CodeConductor.", usage: ["cc-codeconductor setup [--target <target>] [--locale en|es] [--yes] [--dry-run]"] },
+  { name: "detect", group: "getting-started", summary: "Inspect the project stack and recommended presets.", usage: ["cc-codeconductor detect"] },
+  { name: "init", group: "getting-started", summary: "Initialize low-level CodeConductor configuration.", usage: ["cc-codeconductor init [--locale en|es]"] },
+  { name: "install", group: "getting-started", summary: "Install harness components.", usage: ["cc-codeconductor install preset --target <target>"], options: ["--target opencode|claude|codex|gemini|cursor|agy|pi|all"], subcommands: [
+    { name: "preset", group: "getting-started", summary: "Install agents, prompts, skills, and commands.", usage: ["cc-codeconductor install preset --target <target> [--locale en|es]"] },
+    { name: "council", group: "getting-started", summary: "Install generated council files.", usage: ["cc-codeconductor install council --target <target>"] },
+    { name: "lsp", group: "getting-started", summary: "Install supported language servers.", usage: ["cc-codeconductor install lsp --target <target> [--lang typescript,python]"] }
   ] },
-  { name: "version", group: "maintenance", summary: "Show CLI and project harness versions.", usage: ["cc version [--json]"] },
-  { name: "status", group: "maintenance", summary: "Show installed harness state.", usage: ["cc status [--json]"] },
-  { name: "doctor", group: "maintenance", summary: "Diagnose the installation.", usage: ["cc doctor"] },
-  { name: "update", group: "maintenance", summary: "Safely reconcile managed harness files.", usage: ["cc update [--dry-run] [--force]"] },
-  { name: "migrate", group: "maintenance", summary: "Apply compatibility migrations.", usage: ["cc migrate [--dry-run]"] },
-  { name: "docs", group: "maintenance", summary: "Read bundled command documentation.", usage: ["cc docs [command]"] },
-  { name: "completion", group: "maintenance", summary: "Generate shell completion.", usage: ["cc completion <bash|zsh|fish|powershell>"] },
-  { name: "hook", group: "maintenance", summary: "Run installed agent hooks.", usage: ["cc hook <pre-tool|post-tool|session-start>"] },
-  { name: "cc-help", group: "maintenance", summary: "Show a target preset inventory.", usage: ["cc cc-help --target <target>"] },
-  { name: "ask", group: "workflow", summary: "Recommend a slash-command workflow.", usage: ['cc ask "problem"'] },
-  { name: "goal", aliases: ["cc-goal"], group: "workflow", summary: "Plan a goal into dependent tasks.", usage: ['cc goal "objective"'] },
-  { name: "ingest", group: "workflow", summary: "Ingest repository knowledge into the product graph.", usage: ["cc ingest"] },
-  { name: "product", group: "workflow", summary: "Explore the product graph and memory.", usage: ["cc product <subcommand>"] },
-  { name: "ccep", group: "workflow", summary: "Run CCEP contract workflows.", usage: ["cc ccep <subcommand>"] },
-  { name: "openspec", group: "workflow", summary: "Run the OpenSpec delivery loop.", usage: ["cc openspec <subcommand>"] },
-  { name: "scorecard", group: "workflow", summary: "Record and aggregate outcomes.", usage: ["cc scorecard <subcommand>"] },
-  { name: "orchestrate", group: "workflow", summary: "Run goal execution orchestration.", usage: ["cc orchestrate <subcommand>"] },
-  { name: "impact", group: "workflow", summary: "Analyze change impact.", usage: ["cc impact [--files <paths>]"] },
-  { name: "verify", group: "workflow", summary: "Verify task completion with evidence.", usage: ["cc verify --task <id>"] },
-  { name: "seo", group: "tool", summary: "Audit SEO and generate llms.txt.", usage: ["cc seo audit --url <url>"] },
-  { name: "debt-harvest", aliases: ["harvest"], group: "tool", summary: "Scan source files for deferred debt.", usage: ["cc debt-harvest"] }
+  { name: "version", group: "maintenance", summary: "Show CLI and project harness versions.", usage: ["cc-codeconductor version [--json]"] },
+  { name: "status", group: "maintenance", summary: "Show installed harness state.", usage: ["cc-codeconductor status [--json]"] },
+  { name: "doctor", group: "maintenance", summary: "Diagnose the installation.", usage: ["cc-codeconductor doctor"] },
+  { name: "update", group: "maintenance", summary: "Safely reconcile managed harness files.", usage: ["cc-codeconductor update [--dry-run] [--force]"] },
+  { name: "migrate", group: "maintenance", summary: "Apply compatibility migrations.", usage: ["cc-codeconductor migrate [--dry-run]"] },
+  { name: "docs", group: "maintenance", summary: "Read bundled command documentation.", usage: ["cc-codeconductor docs [command]"] },
+  { name: "completion", group: "maintenance", summary: "Generate shell completion.", usage: ["cc-codeconductor completion <bash|zsh|fish|powershell>"] },
+  { name: "hook", group: "maintenance", summary: "Run installed agent hooks.", usage: ["cc-codeconductor hook <pre-tool|post-tool|session-start>"] },
+  { name: "cc-help", group: "maintenance", summary: "Show a target preset inventory.", usage: ["cc-codeconductor cc-help --target <target>"] },
+  { name: "ask", group: "workflow", summary: "Recommend a slash-command workflow.", usage: ['cc-codeconductor ask "problem"'] },
+  { name: "goal", aliases: ["cc-goal"], group: "workflow", summary: "Plan a goal into dependent tasks.", usage: ['cc-codeconductor goal "objective"'] },
+  { name: "ingest", group: "workflow", summary: "Ingest repository knowledge into the product graph.", usage: ["cc-codeconductor ingest"] },
+  { name: "product", group: "workflow", summary: "Explore the product graph and memory.", usage: ["cc-codeconductor product <subcommand>"] },
+  { name: "ccep", group: "workflow", summary: "Run CCEP contract workflows.", usage: ["cc-codeconductor ccep <subcommand>"] },
+  { name: "openspec", group: "workflow", summary: "Run the OpenSpec delivery loop.", usage: ["cc-codeconductor openspec <subcommand>"] },
+  { name: "scorecard", group: "workflow", summary: "Record and aggregate outcomes.", usage: ["cc-codeconductor scorecard <subcommand>"] },
+  { name: "orchestrate", group: "workflow", summary: "Run goal execution orchestration.", usage: ["cc-codeconductor orchestrate <subcommand>"] },
+  { name: "impact", group: "workflow", summary: "Analyze change impact.", usage: ["cc-codeconductor impact [--files <paths>]"] },
+  { name: "verify", group: "workflow", summary: "Verify task completion with evidence.", usage: ["cc-codeconductor verify --task <id>"] },
+  { name: "seo", group: "tool", summary: "Audit SEO and generate llms.txt.", usage: ["cc-codeconductor seo audit --url <url>"] },
+  { name: "debt-harvest", aliases: ["harvest"], group: "tool", summary: "Scan source files for deferred debt.", usage: ["cc-codeconductor debt-harvest"] }
 ];
 var GROUP_LABELS = {
   "getting-started": "GETTING STARTED",
@@ -30806,7 +30845,7 @@ function findCommand(name, subcommand) {
   const command = COMMANDS.find((candidate) => candidate.name === name || candidate.aliases?.includes(name ?? ""));
   return subcommand ? command?.subcommands?.find((candidate) => candidate.name === subcommand) : command;
 }
-function renderHelp(command, subcommand, all = false) {
+function renderHelp(command, subcommand, all = false, bin = resolveCliBin()) {
   const definition = findCommand(command, subcommand);
   if (definition) {
     return [
@@ -30815,11 +30854,11 @@ function renderHelp(command, subcommand, all = false) {
       definition.summary,
       "",
       "Usage:",
-      ...definition.usage.map((usage) => `  ${usage}`),
+      ...definition.usage.map((usage) => `  ${formatUsage(usage, bin)}`),
       ...definition.options?.length ? ["", "Options:", ...definition.options.map((option) => `  ${option}`)] : [],
       ...definition.subcommands?.length ? ["", "Subcommands:", ...definition.subcommands.map((item) => `  ${item.name.padEnd(12)} ${item.summary}`)] : [],
       "",
-      "Run `cc help --all` for every command."
+      `Run \`${bin} help --all\` for every command.`
     ].join(`
 `);
   }
@@ -30830,14 +30869,14 @@ function renderHelp(command, subcommand, all = false) {
   ]);
   const details = all ? COMMANDS.flatMap((item) => [
     `## ${item.name}`,
-    ...item.usage.map((usage) => `  ${usage}`),
+    ...item.usage.map((usage) => `  ${formatUsage(usage, bin)}`),
     ...item.subcommands?.map((sub) => `  ${item.name} ${sub.name} — ${sub.summary}`) ?? [],
     ""
   ]) : [];
-  return [`CodeConductor CLI v${package_default.version}`, "", "Usage: cc <command> [options]", "", ...grouped, ...details, "Run `cc help <command>` for details."].join(`
+  return [`CodeConductor CLI v${package_default.version}`, "", `Usage: ${bin} <command> [options]`, "", ...grouped, ...details, `Run \`${bin} help <command>\` for details.`].join(`
 `);
 }
-function renderDocs(command) {
+function renderDocs(command, bin = "cc-codeconductor") {
   const groupAliases = {
     "getting-started": "getting-started",
     maintenance: "maintenance",
@@ -30853,7 +30892,7 @@ function renderDocs(command) {
     item.summary,
     "",
     "```text",
-    ...item.usage,
+    ...item.usage.map((usage) => formatUsage(usage, bin)),
     "```",
     ""
   ])].join(`
@@ -30864,15 +30903,20 @@ function renderCompletion(shell) {
   const targets = "opencode claude codex gemini cursor agy pi all";
   if (shell === "bash")
     return `_cc(){ local cur="${"${COMP_WORDS[COMP_CWORD]}"}"; local prev="${"${COMP_WORDS[COMP_CWORD-1]}"}"; if [[ "$prev" == "--target" ]]; then COMPREPLY=( $(compgen -W "${targets}" -- "$cur") ); else COMPREPLY=( $(compgen -W "${names}" -- "$cur") ); fi; }
-complete -F _cc cc codeconductor`;
+complete -F _cc cc-codeconductor codeconductor cc`;
   if (shell === "zsh")
-    return `#compdef cc codeconductor
+    return `#compdef cc-codeconductor codeconductor cc
 _arguments '1:command:(${names})' '--target[target]:target:(${targets})'`;
   if (shell === "fish")
-    return [...COMMANDS.map((item) => `complete -c cc -a ${item.name} -d '${item.summary}'`), `complete -c cc -l target -a '${targets}'`].join(`
+    return [
+      ...["cc-codeconductor", "codeconductor", "cc"].flatMap((bin) => [
+        ...COMMANDS.map((item) => `complete -c ${bin} -a ${item.name} -d '${item.summary}'`),
+        `complete -c ${bin} -l target -a '${targets}'`
+      ])
+    ].join(`
 `);
   if (shell === "powershell")
-    return `Register-ArgumentCompleter -CommandName cc,codeconductor -ScriptBlock { param($wordToComplete,$commandAst,$cursorPosition) $values = if ($commandAst.ToString() -match '--target\\s+$') { '${targets}' } else { '${names}' }; $values.Split(' ') | Where-Object { $_ -like "$wordToComplete*" } }`;
+    return `Register-ArgumentCompleter -CommandName cc-codeconductor,codeconductor,cc -ScriptBlock { param($wordToComplete,$commandAst,$cursorPosition) $values = if ($commandAst.ToString() -match '--target\\s+$') { '${targets}' } else { '${names}' }; $values.Split(' ') | Where-Object { $_ -like "$wordToComplete*" } }`;
   return null;
 }
 

package/dist/library.js

@@ -1134,6 +1134,34 @@ var init_goal_state = __esm(() => {
 import { mkdir, readFile, writeFile } from "node:fs/promises";
 init_schemas();
 
+// src/utils/cli-bin.ts
+import { basename } from "node:path";
+function resolveCliBin(env = process.env, argv = process.argv) {
+  if (env.CC_CLI_BIN) {
+    return env.CC_CLI_BIN;
+  }
+  if (env.npm_lifecycle_event === "npx" || env.npm_command === "exec" || env._?.endsWith("/npx") || env._ === "npx") {
+    return "npx cc-codeconductor";
+  }
+  if (env._?.endsWith("/bunx") || env._ === "bunx") {
+    return "bunx cc-codeconductor";
+  }
+  if (env.npm_lifecycle_event === "dev") {
+    return env.npm_lifecycle_script?.startsWith("bun") ? "bun run dev" : "npm run dev";
+  }
+  if (argv && argv.length > 1 && argv[1]) {
+    const script = argv[1];
+    const binName = basename(script);
+    if (binName === "main.ts") {
+      return "bun run dev";
+    }
+    if (binName === "cc-codeconductor" || binName === "codeconductor") {
+      return binName;
+    }
+  }
+  return "cc-codeconductor";
+}
+
 // src/core/product-graph/paths.ts
 import { join } from "node:path";
 var PRODUCT_DIR = ".codeconductor";
@@ -1161,7 +1189,7 @@ async function loadGraph(projectRoot) {
     return ok(ProductGraphSchema.parse(JSON.parse(raw)));
   } catch (e) {
     if (e.code === "ENOENT") {
-      return err(new Error("Product graph not found. Run `cc ingest` first."));
+      return err(new Error(`Product graph not found. Run \`${resolveCliBin()} ingest\` first.`));
     }
     return err(e instanceof Error ? e : new Error(String(e)));
   }

package/dist/utils/cli-bin.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Resolve the CLI command prefix based on execution context.
+ *
+ * - When invoked via npx (e.g. `npx cc-codeconductor ...`), returns `npx cc-codeconductor`.
+ * - When invoked via bunx, returns `bunx cc-codeconductor`.
+ * - When invoked during local development (`bun run dev` or executing `src/cli/main.ts`), returns `bun run dev`.
+ * - When invoked via an installed binary (`cc-codeconductor` or `codeconductor`), returns that binary name.
+ * - Respects the `CC_CLI_BIN` environment variable for testing or explicit overrides.
+ * - Defaults to `cc-codeconductor`.
+ */
+export declare function resolveCliBin(env?: NodeJS.ProcessEnv, argv?: readonly string[]): string;
+/**
+ * Formats a command usage string replacing any legacy or alternative command prefix
+ * (`cc `, `cc-codeconductor `, or `codeconductor `) with the resolved bin prefix.
+ */
+export declare function formatUsage(usage: string, bin?: string): string;

package/docs/generated/cli.md

@@ -5,7 +5,7 @@
 Configure and install CodeConductor.
 
 ```text
-cc setup [--target <target>] [--locale en|es] [--yes] [--dry-run]
+cc-codeconductor setup [--target <target>] [--locale en|es] [--yes] [--dry-run]
 ```
 
 ## detect
@@ -13,7 +13,7 @@ cc setup [--target <target>] [--locale en|es] [--yes] [--dry-run]
 Inspect the project stack and recommended presets.
 
 ```text
-cc detect
+cc-codeconductor detect
 ```
 
 ## init
@@ -21,7 +21,7 @@ cc detect
 Initialize low-level CodeConductor configuration.
 
 ```text
-cc init [--locale en|es]
+cc-codeconductor init [--locale en|es]
 ```
 
 ## install
@@ -29,7 +29,7 @@ cc init [--locale en|es]
 Install harness components.
 
 ```text
-cc install preset --target <target>
+cc-codeconductor install preset --target <target>
 ```
 
 ## version
@@ -37,7 +37,7 @@ cc install preset --target <target>
 Show CLI and project harness versions.
 
 ```text
-cc version [--json]
+cc-codeconductor version [--json]
 ```
 
 ## status
@@ -45,7 +45,7 @@ cc version [--json]
 Show installed harness state.
 
 ```text
-cc status [--json]
+cc-codeconductor status [--json]
 ```
 
 ## doctor
@@ -53,7 +53,7 @@ cc status [--json]
 Diagnose the installation.
 
 ```text
-cc doctor
+cc-codeconductor doctor
 ```
 
 ## update
@@ -61,7 +61,7 @@ cc doctor
 Safely reconcile managed harness files.
 
 ```text
-cc update [--dry-run] [--force]
+cc-codeconductor update [--dry-run] [--force]
 ```
 
 ## migrate
@@ -69,7 +69,7 @@ cc update [--dry-run] [--force]
 Apply compatibility migrations.
 
 ```text
-cc migrate [--dry-run]
+cc-codeconductor migrate [--dry-run]
 ```
 
 ## docs
@@ -77,7 +77,7 @@ cc migrate [--dry-run]
 Read bundled command documentation.
 
 ```text
-cc docs [command]
+cc-codeconductor docs [command]
 ```
 
 ## completion
@@ -85,7 +85,7 @@ cc docs [command]
 Generate shell completion.
 
 ```text
-cc completion <bash|zsh|fish|powershell>
+cc-codeconductor completion <bash|zsh|fish|powershell>
 ```
 
 ## hook
@@ -93,7 +93,7 @@ cc completion <bash|zsh|fish|powershell>
 Run installed agent hooks.
 
 ```text
-cc hook <pre-tool|post-tool|session-start>
+cc-codeconductor hook <pre-tool|post-tool|session-start>
 ```
 
 ## cc-help
@@ -101,7 +101,7 @@ cc hook <pre-tool|post-tool|session-start>
 Show a target preset inventory.
 
 ```text
-cc cc-help --target <target>
+cc-codeconductor cc-help --target <target>
 ```
 
 ## ask
@@ -109,7 +109,7 @@ cc cc-help --target <target>
 Recommend a slash-command workflow.
 
 ```text
-cc ask "problem"
+cc-codeconductor ask "problem"
 ```
 
 ## goal
@@ -117,7 +117,7 @@ cc ask "problem"
 Plan a goal into dependent tasks.
 
 ```text
-cc goal "objective"
+cc-codeconductor goal "objective"
 ```
 
 ## ingest
@@ -125,7 +125,7 @@ cc goal "objective"
 Ingest repository knowledge into the product graph.
 
 ```text
-cc ingest
+cc-codeconductor ingest
 ```
 
 ## product
@@ -133,7 +133,7 @@ cc ingest
 Explore the product graph and memory.
 
 ```text
-cc product <subcommand>
+cc-codeconductor product <subcommand>
 ```
 
 ## ccep
@@ -141,7 +141,7 @@ cc product <subcommand>
 Run CCEP contract workflows.
 
 ```text
-cc ccep <subcommand>
+cc-codeconductor ccep <subcommand>
 ```
 
 ## openspec
@@ -149,7 +149,7 @@ cc ccep <subcommand>
 Run the OpenSpec delivery loop.
 
 ```text
-cc openspec <subcommand>
+cc-codeconductor openspec <subcommand>
 ```
 
 ## scorecard
@@ -157,7 +157,7 @@ cc openspec <subcommand>
 Record and aggregate outcomes.
 
 ```text
-cc scorecard <subcommand>
+cc-codeconductor scorecard <subcommand>
 ```
 
 ## orchestrate
@@ -165,7 +165,7 @@ cc scorecard <subcommand>
 Run goal execution orchestration.
 
 ```text
-cc orchestrate <subcommand>
+cc-codeconductor orchestrate <subcommand>
 ```
 
 ## impact
@@ -173,7 +173,7 @@ cc orchestrate <subcommand>
 Analyze change impact.
 
 ```text
-cc impact [--files <paths>]
+cc-codeconductor impact [--files <paths>]
 ```
 
 ## verify
@@ -181,7 +181,7 @@ cc impact [--files <paths>]
 Verify task completion with evidence.
 
 ```text
-cc verify --task <id>
+cc-codeconductor verify --task <id>
 ```
 
 ## seo
@@ -189,7 +189,7 @@ cc verify --task <id>
 Audit SEO and generate llms.txt.
 
 ```text
-cc seo audit --url <url>
+cc-codeconductor seo audit --url <url>
 ```
 
 ## debt-harvest
@@ -197,6 +197,6 @@ cc seo audit --url <url>
 Scan source files for deferred debt.
 
 ```text
-cc debt-harvest
+cc-codeconductor debt-harvest
 ```
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cc-codeconductor",
-  "version": "1.4.0",
+  "version": "1.4.1",
   "description": "A multi-agent orchestration framework for AI-assisted software engineering workflows.",
   "keywords": [
     "ai",