@cleocode/cleo 2026.3.10 → 2026.3.12

package/dist/cli/index.js

@@ -14959,8 +14959,8 @@ async function getSystemDiagnostics(projectRoot, opts) {
 }
 async function commandExists2(cmd) {
   try {
-    const { stdout } = await execAsync("which", [cmd]);
-    return stdout.trim();
+    const { stdout: stdout2 } = await execAsync("which", [cmd]);
+    return stdout2.trim();
   } catch {
     return null;
   }
@@ -15612,8 +15612,8 @@ async function resolveBinaryPath(name) {
   const execFileAsync5 = promisify5(execFile5);
   const resolver = process.platform === "win32" ? "where" : "which";
   try {
-    const { stdout } = await execFileAsync5(resolver, [name]);
-    const first = stdout.trim().split(/\r?\n/)[0] ?? "";
+    const { stdout: stdout2 } = await execFileAsync5(resolver, [name]);
+    const first = stdout2.trim().split(/\r?\n/)[0] ?? "";
     return first || null;
   } catch {
     return null;
@@ -16265,6 +16265,20 @@ function getMcpServerName(env) {
   return "cleo";
 }
 function detectEnvMode() {
+  const scriptPath = (process.argv[1] ?? "").replace(/\\/g, "/");
+  const marker = "/node_modules/@cleocode/cleo/";
+  const markerIdx = scriptPath.indexOf(marker);
+  if (markerIdx >= 0) {
+    const pkgRoot = scriptPath.slice(0, markerIdx + marker.length);
+    let channel2 = "stable";
+    try {
+      const pkg = JSON.parse(readFileSync19(join29(pkgRoot, "package.json"), "utf-8"));
+      channel2 = (pkg.version ?? "").includes("-beta") ? "beta" : "stable";
+    } catch {
+      channel2 = "stable";
+    }
+    return { mode: "prod-npm", source: "npm", channel: channel2 };
+  }
   const versionPath = join29(
     process.env["CLEO_HOME"] ?? join29(homedir6(), ".cleo"),
     "VERSION"
@@ -16644,7 +16658,7 @@ async function initMcpServer(projectRoot, created, warnings) {
       providers,
       serverName,
       serverEntry,
-      "project",
+      "global",
       projectRoot
     );
     const successes = results.filter((r) => r.success);
@@ -16871,7 +16885,6 @@ async function initProject(opts = {}) {
     warnings.push(`CAAMP injection: ${err instanceof Error ? err.message : String(err)}`);
   }
   await initAgentDefinition(created, warnings);
-  await initMcpServer(projRoot, created, warnings);
   await initCoreSkills(created, warnings);
   await initNexusRegistration(projRoot, projectName, created, warnings);
   const rootGitignoreResult = await removeCleoFromRootGitignore(projRoot);
@@ -31284,7 +31297,7 @@ import {
   getProvider
 } from "@cleocode/caamp";
 function registerMcpInstallCommand(program2) {
-  program2.command("mcp-install").description("Configure CLEO MCP server integration (env-aware, via CAAMP)").option("--tool <name>", "Configure a single tool/provider (claude-code, cursor, windsurf, etc.)").option("--global", "Use global/user config scope").option("--project", "Use project-level config scope").option("--all", "Configure all detected providers").option("--dry-run", "Preview changes without writing files").option("--force", "Overwrite existing cleo config entries").option("--list-tools", "List detected AI tools/providers").action(async (opts) => {
+  program2.command("mcp-install").description("Configure CLEO MCP server integration (env-aware, global by default, via CAAMP)").option("--tool <name>", "Configure a single tool/provider (claude-code, cursor, windsurf, etc.)").option("--global", "Use global/user config scope (default)").option("--project", "Use project-level config scope (opt-in)").option("--all", "Configure all detected providers").option("--dry-run", "Preview changes without writing files").option("--force", "Overwrite existing cleo config entries").option("--list-tools", "List detected AI tools/providers").action(async (opts) => {
     try {
       if (opts["listTools"]) {
         const providers2 = getInstalledProviders2();
@@ -31305,7 +31318,7 @@ function registerMcpInstallCommand(program2) {
       const env = detectEnvMode();
       const serverEntry = generateMcpServerEntry(env);
       const serverName = getMcpServerName(env);
-      const scope = opts["global"] ? "global" : "project";
+      const scope = opts["project"] ? "project" : "global";
       const projectDir = process.cwd();
       if (opts["tool"]) {
         const provider = getProvider(opts["tool"]);
@@ -34665,16 +34678,143 @@ function registerDecompositionCommand(program2) {
 
 // src/cli/commands/doctor.ts
 init_cli();
-function registerDoctorCommand(program2) {
-  program2.command("doctor").description("Run system diagnostics and health checks").option("--detailed", "Show detailed health check results").option("--comprehensive", "Run comprehensive doctor report").option("--fix", "Auto-fix failed checks").action(async (opts) => {
-    if (opts["fix"]) {
-      await dispatchFromCli("mutate", "admin", "fix", {}, { command: "doctor", operation: "admin.fix" });
-    } else if (opts["comprehensive"]) {
-      await dispatchFromCli("query", "admin", "doctor", {}, { command: "doctor", operation: "admin.doctor" });
+
+// src/cli/progress.ts
+import { stderr, stdout } from "node:process";
+var ProgressTracker = class {
+  enabled;
+  prefix;
+  currentStep = 0;
+  totalSteps;
+  steps;
+  constructor(options) {
+    this.enabled = options.enabled;
+    this.prefix = options.prefix ?? "CLEO";
+    this.steps = options.steps;
+    this.totalSteps = options.steps.length;
+  }
+  /**
+   * Start the progress tracker.
+   */
+  start() {
+    if (!this.enabled) return;
+    this.currentStep = 0;
+    stderr.write(`
+${this.prefix}: Starting...
+`);
+  }
+  /**
+   * Update to a specific step.
+   */
+  step(index3, message) {
+    if (!this.enabled) return;
+    this.currentStep = index3;
+    const stepName = this.steps[index3] ?? message ?? "Working...";
+    const progress = `[${index3 + 1}/${this.totalSteps}]`;
+    stderr.write(`  ${progress} ${stepName}...
+`);
+  }
+  /**
+   * Move to next step.
+   */
+  next(message) {
+    this.step(this.currentStep + 1, message);
+  }
+  /**
+   * Mark as complete with optional summary.
+   */
+  complete(summary) {
+    if (!this.enabled) return;
+    if (summary) {
+      stdout.write(`
+${this.prefix}: \u2713 ${summary}
+
+`);
     } else {
-      await dispatchFromCli("query", "admin", "health", {
-        detailed: opts["detailed"]
-      }, { command: "doctor", operation: "admin.health" });
+      stdout.write(`
+${this.prefix}: \u2713 Complete
+
+`);
+    }
+  }
+  /**
+   * Report an error.
+   */
+  error(message) {
+    if (!this.enabled) return;
+    stderr.write(`
+${this.prefix}: \u2717 ${message}
+
+`);
+  }
+};
+function createSelfUpdateProgress(enabled) {
+  return new ProgressTracker({
+    enabled,
+    prefix: "CLEO",
+    steps: [
+      "Detecting installation type",
+      "Checking current version",
+      "Querying npm registry",
+      "Comparing versions",
+      "Running post-update checks",
+      "Finalizing"
+    ]
+  });
+}
+function createDoctorProgress(enabled) {
+  return new ProgressTracker({
+    enabled,
+    prefix: "CLEO Doctor",
+    steps: [
+      "Checking CLEO directory",
+      "Verifying tasks database",
+      "Checking configuration",
+      "Validating schemas",
+      "Running health checks"
+    ]
+  });
+}
+function createUpgradeProgress(enabled) {
+  return new ProgressTracker({
+    enabled,
+    prefix: "CLEO Upgrade",
+    steps: [
+      "Analyzing current state",
+      "Checking storage migration needs",
+      "Validating schemas",
+      "Applying fixes",
+      "Verifying results"
+    ]
+  });
+}
+
+// src/cli/commands/doctor.ts
+function registerDoctorCommand(program2) {
+  program2.command("doctor").description("Run system diagnostics and health checks").option("--detailed", "Show detailed health check results").option("--comprehensive", "Run comprehensive doctor report").option("--fix", "Auto-fix failed checks").action(async (_opts, command) => {
+    const opts = command.optsWithGlobals ? command.optsWithGlobals() : command.opts();
+    const isHuman = opts["human"] === true || !!process.stdout.isTTY && opts["json"] !== true;
+    const progress = createDoctorProgress(isHuman);
+    progress.start();
+    try {
+      if (opts["fix"]) {
+        progress.step(4, "Applying fixes");
+        await dispatchFromCli("mutate", "admin", "fix", {}, { command: "doctor", operation: "admin.fix" });
+        progress.complete("Fixes applied");
+      } else if (opts["comprehensive"]) {
+        progress.step(0, "Checking CLEO directory");
+        await dispatchFromCli("query", "admin", "doctor", {}, { command: "doctor", operation: "admin.doctor" });
+        progress.complete("Comprehensive diagnostics complete");
+      } else {
+        progress.step(0, "Checking CLEO directory");
+        await dispatchFromCli("query", "admin", "health", {
+          detailed: opts["detailed"]
+        }, { command: "doctor", operation: "admin.health" });
+        progress.complete("Health check complete");
+      }
+    } catch (err) {
+      progress.error("Health check failed");
+      throw err;
     }
   });
 }
@@ -36717,8 +36857,8 @@ async function getCurrentVersion() {
 }
 async function getNpmInstalledVersion() {
   try {
-    const { stdout } = await execAsync2("npm", ["ls", "-g", "@cleocode/cleo", "--depth=0", "--json"]);
-    const data = JSON.parse(stdout);
+    const { stdout: stdout2 } = await execAsync2("npm", ["ls", "-g", "@cleocode/cleo", "--depth=0", "--json"]);
+    const data = JSON.parse(stdout2);
     return data.dependencies?.["@cleocode/cleo"]?.version ?? null;
   } catch {
     return null;
@@ -36726,19 +36866,19 @@ async function getNpmInstalledVersion() {
 }
 async function getDistTagVersion(tag) {
   try {
-    const { stdout } = await execAsync2("npm", ["view", `@cleocode/cleo@${tag}`, "version"]);
-    const v = stdout.trim();
+    const { stdout: stdout2 } = await execAsync2("npm", ["view", `@cleocode/cleo@${tag}`, "version"]);
+    const v = stdout2.trim();
     return v || null;
   } catch {
     if (tag === "latest") {
       try {
-        const { stdout } = await execAsync2("curl", [
+        const { stdout: stdout2 } = await execAsync2("curl", [
           "-sL",
           "--max-time",
           "10",
           `https://api.github.com/repos/${GITHUB_REPO}/releases/latest`
         ]);
-        const data = JSON.parse(stdout);
+        const data = JSON.parse(stdout2);
         return data.tag_name?.replace(/^v/, "") ?? null;
       } catch {
         return null;
@@ -36761,17 +36901,26 @@ async function writeRuntimeVersionMetadata(mode, source, version) {
   );
 }
 function registerSelfUpdateCommand(program2) {
-  program2.command("self-update").description("Check for and install CLEO updates, then run post-update diagnostics").option("--check", "Only check if update is available").option("--status", "Show current vs latest version").option("--version <ver>", "Update to specific version").option("--channel <channel>", "Update channel: stable|beta").option("--beta", "Shortcut for --channel beta").option("--force", "Force update even if same version").option("--post-update", "Run post-update diagnostics and migration only").option("--no-auto-upgrade", "Skip automatic upgrade after update").option("--auto-migrate", "Automatically migrate storage without prompting").action(async (opts) => {
+  program2.command("self-update").description("Check for and install CLEO updates, then run post-update diagnostics").option("--check", "Only check if update is available").option("--status", "Show current vs latest version").option("--version <ver>", "Update to specific version").option("--channel <channel>", "Update channel: stable|beta").option("--beta", "Shortcut for --channel beta").option("--force", "Force update even if same version").option("--post-update", "Run post-update diagnostics and migration only").option("--no-auto-upgrade", "Skip automatic upgrade after update").option("--auto-migrate", "Automatically migrate storage without prompting").action(async (_opts, command) => {
+    const opts = command.optsWithGlobals ? command.optsWithGlobals() : command.opts();
+    const isHuman = opts["human"] === true || !!process.stdout.isTTY && opts["json"] !== true;
+    const progress = createSelfUpdateProgress(isHuman);
     try {
       const noAutoUpgrade = opts["autoUpgrade"] === false;
       if (opts["postUpdate"]) {
+        progress.start();
+        progress.step(4, "Running post-update diagnostics");
         await runPostUpdateDiagnostics({ skipUpgrade: noAutoUpgrade, autoMigrate: !!opts["autoMigrate"] || !!opts["force"] });
+        progress.complete("Post-update diagnostics complete");
         return;
       }
+      progress.start();
+      progress.step(0, "Detecting installation type");
       const runtime = await getRuntimeDiagnostics();
       const script = runtime.invocation.script;
       const fromNodeModules = script.includes("/node_modules/@cleocode/cleo/") || script.includes("\\node_modules\\@cleocode\\cleo\\");
       const isDev = runtime.channel === "dev" && !fromNodeModules;
+      progress.step(1, "Checking current version");
       const currentVersion = isDev ? await getCurrentVersion() : await getNpmInstalledVersion() ?? await getCurrentVersion();
       const rawChannel = opts["channel"]?.toLowerCase();
       if (rawChannel && rawChannel !== "stable" && rawChannel !== "beta") {
@@ -36779,6 +36928,7 @@ function registerSelfUpdateCommand(program2) {
       }
       const requestedChannel = opts["beta"] ? "beta" : rawChannel ?? (runtime.channel === "beta" ? "beta" : "stable");
       if (isDev && !opts["force"]) {
+        progress.step(4, "Running post-update checks");
         const preflight = checkStorageMigration();
         cliOutput({
           devMode: true,
@@ -36792,6 +36942,7 @@ function registerSelfUpdateCommand(program2) {
           }
         }, { command: "self-update" });
         if (preflight.migrationNeeded) {
+          progress.error(`Storage migration needed: ${preflight.summary}`);
           process.stderr.write(
             `
 \u26A0 Storage migration needed: ${preflight.summary}
@@ -36800,15 +36951,19 @@ function registerSelfUpdateCommand(program2) {
 
 `
           );
+        } else {
+          progress.complete("Dev environment check complete");
         }
         process.exit(100 /* NO_DATA */);
         return;
       }
       if (opts["status"] || opts["check"]) {
+        progress.step(2, "Querying npm registry");
         const latest2 = await getDistTagVersion(requestedChannel === "beta" ? "beta" : "latest");
         if (!latest2) {
           throw new CleoError(5 /* DEPENDENCY_ERROR */, "Failed to check latest version from GitHub");
         }
+        progress.step(3, "Comparing versions");
         const updateAvailable = latest2 !== currentVersion;
         const preflight = checkStorageMigration();
         cliOutput({
@@ -36827,12 +36982,16 @@ function registerSelfUpdateCommand(program2) {
         }
         return;
       }
+      progress.step(2, "Querying npm registry");
       const latest = opts["version"] ?? await getDistTagVersion(requestedChannel === "beta" ? "beta" : "latest");
       if (!latest) {
         throw new CleoError(5 /* DEPENDENCY_ERROR */, "Failed to check latest version from GitHub");
       }
+      progress.step(3, "Comparing versions");
       if (latest === currentVersion && !opts["force"]) {
+        progress.step(4, "Running post-update checks");
         await runPostUpdateDiagnostics({ skipUpgrade: noAutoUpgrade, autoMigrate: !!opts["autoMigrate"] || !!opts["force"] });
+        progress.complete("Already up to date");
         cliOutput({
           currentVersion,
           upToDate: true
@@ -36840,8 +36999,10 @@ function registerSelfUpdateCommand(program2) {
         return;
       }
       const spec = opts["version"] ? `@cleocode/cleo@${latest}` : requestedChannel === "beta" ? "@cleocode/cleo@beta" : "@cleocode/cleo@latest";
+      progress.step(4, `Installing ${spec}`);
       await execAsync2("npm", ["install", "-g", spec], { maxBuffer: 10 * 1024 * 1024 });
       await writeRuntimeVersionMetadata("prod-npm", "npm", latest);
+      progress.step(5, "Finalizing");
       cliOutput({
         currentVersion,
         targetVersion: latest,
@@ -36850,11 +37011,14 @@ function registerSelfUpdateCommand(program2) {
         command: `npm install -g ${spec}`
       }, { command: "self-update", message: `Updated to ${latest}` });
       await runPostUpdateDiagnostics({ skipUpgrade: noAutoUpgrade, autoMigrate: !!opts["autoMigrate"] || !!opts["force"] });
+      progress.complete(`Updated to ${latest}`);
     } catch (err) {
       if (err instanceof CleoError) {
+        progress.error(err.message);
         console.error(formatError(err));
         process.exit(err.code);
       }
+      progress.error("Unexpected error during update");
       throw err;
     }
   });
@@ -37104,16 +37268,29 @@ init_output();
 init_renderers();
 init_errors();
 function registerUpgradeCommand(program2) {
-  program2.command("upgrade").description("Unified project maintenance (storage migration, schema repair, structural fixes)").option("--status", "Show what needs updating without making changes").option("--dry-run", "Preview changes without applying").option("--include-global", "Also check global ~/.cleo data").option("--no-auto-migrate", "Skip automatic JSON\u2192SQLite migration").action(async (opts) => {
+  program2.command("upgrade").description("Unified project maintenance (storage migration, schema repair, structural fixes)").option("--status", "Show what needs updating without making changes").option("--dry-run", "Preview changes without applying").option("--include-global", "Also check global ~/.cleo data").option("--no-auto-migrate", "Skip automatic JSON\u2192SQLite migration").action(async (_opts, command) => {
+    const opts = command.optsWithGlobals ? command.optsWithGlobals() : command.opts();
+    const isHuman = opts["human"] === true || !!process.stdout.isTTY && opts["json"] !== true;
+    const progress = createUpgradeProgress(isHuman);
     try {
       const isDryRun = !!opts["dryRun"] || !!opts["status"];
       const includeGlobal = !!opts["includeGlobal"];
       const autoMigrate = opts["autoMigrate"] !== false;
+      progress.start();
+      progress.step(0, "Analyzing current state");
+      if (includeGlobal) {
+        progress.step(1, "Checking global ~/.cleo data");
+      } else {
+        progress.step(1, "Checking storage migration needs");
+      }
+      progress.step(2, "Validating schemas");
+      progress.step(3, isDryRun ? "Previewing changes" : "Applying fixes");
       const result = await runUpgrade({
         dryRun: isDryRun,
         includeGlobal,
         autoMigrate
       });
+      progress.step(4, "Verifying results");
       cliOutput({
         upToDate: result.upToDate,
         dryRun: result.dryRun,
@@ -37123,13 +37300,17 @@ function registerUpgradeCommand(program2) {
         storageMigration: result.storageMigration
       }, { command: "upgrade" });
       if (!result.success) {
+        progress.error("Upgrade failed with errors");
         process.exit(1);
       }
+      progress.complete(isDryRun ? "Preview complete" : "Upgrade complete");
     } catch (err) {
       if (err instanceof CleoError) {
+        progress.error(err.message);
         console.error(formatError(err));
         process.exit(err.code);
       }
+      progress.error("Unexpected error during upgrade");
       throw err;
     }
   });