@cleocode/cleo 2026.3.11 → 2026.3.12

package/README.md

@@ -1,4 +1,4 @@
-<p alis|version-[0-9]\+\.[0-9]\+\.[0-9]\+-|version-2026.3.11-|g|version-[0-9]\+\.[0-9]\+\.[0-9]\+-|version-2026.3.10-|g|version-[0-9]\+\.[0-9]\+\.[0-9]\+-|version-2025.3.10-|gn="center">
+<p alis|version-[0-9]\+\.[0-9]\+\.[0-9]\+-|version-2026.3.12-|g|version-[0-9]\+\.[0-9]\+\.[0-9]\+-|version-2026.3.11-|g|version-[0-9]\+\.[0-9]\+\.[0-9]\+-|version-2026.3.10-|g|version-[0-9]\+\.[0-9]\+\.[0-9]\+-|version-2025.3.10-|gn="center">
   <img src="docs/images/banner.png" alt="CLEO banner" width="900">
 </p>
 

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;
@@ -34678,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;
     }
   });
 }
@@ -36730,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;
@@ -36739,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;
@@ -36774,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") {
@@ -36792,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,
@@ -36805,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}
@@ -36813,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({
@@ -36840,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
@@ -36853,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,
@@ -36863,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;
     }
   });
@@ -37117,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,
@@ -37136,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;
     }
   });