@cleocode/cleo 2026.3.67 → 2026.3.69

package/dist/cli/commands/upgrade.js

@@ -2,16 +2,18 @@
  * CLI upgrade command - unified project maintenance.
  *
  * Delegates to core upgrade logic. Handles:
- *   - Storage migration (JSON → SQLite, automatic)
+ *   - Storage migration (JSON -> SQLite, automatic)
  *   - Schema version upgrades
  *   - Structural repairs (checksums, missing fields)
  *   - Global ~/.cleo data checks
+ *   - Deep diagnostics via --diagnose
  *
  * @task T4699
  * @task T5243
+ * @task T131
  * @epic T4454
  */
-import { CleoError, formatError, runUpgrade } from '@cleocode/core/internal';
+import { CleoError, diagnoseUpgrade, formatError, runUpgrade } from '@cleocode/core/internal';
 import { createUpgradeProgress } from '../progress.js';
 import { cliOutput } from '../renderers/index.js';
 export function registerUpgradeCommand(program) {
@@ -20,22 +22,39 @@ export function registerUpgradeCommand(program) {
         .description('Unified project maintenance (storage migration, schema repair, structural fixes, doc refresh)')
         .option('--status', 'Show what needs updating without making changes')
         .option('--dry-run', 'Preview changes without applying')
+        .option('--diagnose', 'Deep inspection of schema, columns, and migration journals')
         .option('--include-global', 'Also check global ~/.cleo data')
-        .option('--no-auto-migrate', 'Skip automatic JSON→SQLite migration')
+        .option('--no-auto-migrate', 'Skip automatic JSON->SQLite migration')
         .option('--detect', 'Force re-detection of project type (ignores staleness)')
         .option('--map-codebase', 'Run full codebase analysis and store findings to brain.db')
         .option('--name <name>', 'Update project name in project-info and nexus registry')
-        .action(async (_opts, command) => {
-        const opts = command.optsWithGlobals ? command.optsWithGlobals() : command.opts();
-        const isHuman = opts['human'] === true || (!!process.stdout.isTTY && opts['json'] !== true);
+        .action(async (opts, command) => {
+        // Merge citty-parsed opts with global flags (--json, --human, etc.)
+        const globalOpts = command.optsWithGlobals ? command.optsWithGlobals() : command.opts();
+        const mergedOpts = { ...globalOpts, ...opts };
+        const isHuman = mergedOpts['human'] === true || (!!process.stdout.isTTY && mergedOpts['json'] !== true);
         const progress = createUpgradeProgress(isHuman);
         try {
-            const isDryRun = !!opts['dryRun'] || !!opts['status'];
-            const includeGlobal = !!opts['includeGlobal'];
-            const autoMigrate = opts['autoMigrate'] !== false;
-            const forceDetect = !!opts['detect'];
-            const mapCodebase = !!opts['mapCodebase'];
-            const projectName = opts['name'];
+            // --diagnose: deep read-only inspection
+            if (mergedOpts['diagnose']) {
+                progress.start();
+                progress.step(0, 'Running deep schema/migration diagnostics');
+                const result = await diagnoseUpgrade();
+                progress.step(4, 'Diagnostics complete');
+                cliOutput(result, { command: 'upgrade', operation: 'upgrade.diagnose' });
+                if (!result.success) {
+                    progress.error(`${result.summary.errors} error(s) found`);
+                    process.exit(1);
+                }
+                progress.complete(`Diagnostics complete: ${result.summary.ok} ok, ${result.summary.warnings} warning(s), ${result.summary.errors} error(s)`);
+                return;
+            }
+            const isDryRun = !!mergedOpts['dryRun'] || !!mergedOpts['status'];
+            const includeGlobal = !!mergedOpts['includeGlobal'];
+            const autoMigrate = mergedOpts['autoMigrate'] !== false;
+            const forceDetect = !!mergedOpts['detect'];
+            const mapCodebase = !!mergedOpts['mapCodebase'];
+            const projectName = mergedOpts['name'];
             progress.start();
             progress.step(0, 'Analyzing current state');
             if (includeGlobal) {
@@ -61,6 +80,7 @@ export function registerUpgradeCommand(program) {
                 actions: result.actions,
                 applied: result.applied,
                 errors: result.errors.length > 0 ? result.errors : undefined,
+                summary: result.summary,
                 storageMigration: result.storageMigration,
             }, { command: 'upgrade' });
             if (!result.success) {

package/dist/cli/commands/upgrade.js.map

@@ -1 +1 @@
-{"version":3,"file":"upgrade.js","sourceRoot":"","sources":["../../../src/cli/commands/upgrade.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"upgrade.js","sourceRoot":"","sources":["../../../src/cli/commands/upgrade.ts"],"names":[],"mappings":"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"}

package/dist/cli/index.js

@@ -41646,9 +41646,11 @@ async function addTask(options, cwd, accessor) {
       "Title and description must be different (anti-hallucination rule)"
     );
   }
-  await requireActiveSession("tasks.add", cwd);
+  if (!options.dryRun) {
+    await requireActiveSession("tasks.add", cwd);
+  }
   const parentId = options.parentId ?? null;
-  if (!parentId && options.type !== "epic") {
+  if (!options.dryRun && !parentId && options.type !== "epic") {
     const lifecycleMode = await getLifecycleMode(cwd);
     if (lifecycleMode === "strict") {
       throw new CleoError(
@@ -41668,21 +41670,23 @@ async function addTask(options, cwd, accessor) {
   validateStatus(status);
   validateSize(size);
   if (options.labels?.length) validateLabels(options.labels);
-  const enforcement = await createAcceptanceEnforcement(cwd);
-  const acValidation = enforcement.validateCreation({
-    acceptance: options.acceptance,
-    priority
-  });
-  if (!acValidation.valid) {
-    throw new CleoError(acValidation.exitCode ?? 6 /* VALIDATION_ERROR */, acValidation.error, {
-      fix: acValidation.fix
+  if (!options.dryRun) {
+    const enforcement = await createAcceptanceEnforcement(cwd);
+    const acValidation = enforcement.validateCreation({
+      acceptance: options.acceptance,
+      priority
     });
-  }
-  if (options.type === "epic") {
-    await validateEpicCreation(
-      { acceptance: options.acceptance, description: options.description },
-      cwd
-    );
+    if (!acValidation.valid) {
+      throw new CleoError(acValidation.exitCode ?? 6 /* VALIDATION_ERROR */, acValidation.error, {
+        fix: acValidation.fix
+      });
+    }
+    if (options.type === "epic") {
+      await validateEpicCreation(
+        { acceptance: options.acceptance, description: options.description },
+        cwd
+      );
+    }
   }
   if (options.depends?.length) {
     for (const depId of options.depends) {
@@ -86112,13 +86116,15 @@ async function systemSmoke() {
       const migrationStatus = await getMigrationStatus2(
         (await Promise.resolve().then(() => (init_internal(), internal_exports))).getProjectRoot()
       );
-      const hasPending = migrationStatus.status === "pending" || migrationStatus.status === "stale";
+      const hasPending = migrationStatus.migrations.some((m) => !m.applied);
       dbChecks.push({
         domain: "db",
         operation: "migrations",
         status: hasPending ? "fail" : "pass",
         timeMs: Date.now() - start,
-        ...hasPending ? { error: `Migration status: ${migrationStatus.status}. Run: cleo upgrade` } : {}
+        ...hasPending ? {
+          error: `Unapplied migrations detected (${migrationStatus.from} \u2192 ${migrationStatus.to}). Run: cleo upgrade`
+        } : {}
       });
     } catch (err) {
       dbChecks.push({
@@ -94328,6 +94334,45 @@ function registerAddCommand(program) {
   });
 }
 
+// packages/cleo/src/cli/commands/admin.ts
+init_cli();
+function registerAdminCommand(program) {
+  const admin = program.command("admin").description("System administration and diagnostics");
+  admin.command("version").description("Show CLEO version").action(async () => {
+    await dispatchFromCli("query", "admin", "version", {}, { command: "admin" });
+  });
+  admin.command("health").description("Run system health check").option("--detailed", "Show detailed results").action(async (opts) => {
+    await dispatchFromCli(
+      "query",
+      "admin",
+      "health",
+      { detailed: opts["detailed"] },
+      { command: "admin" }
+    );
+  });
+  admin.command("stats").description("Show project statistics").option("--period <days>", "Time period in days").action(async (opts) => {
+    await dispatchFromCli(
+      "query",
+      "admin",
+      "stats",
+      { period: opts["period"] ? Number(opts["period"]) : void 0 },
+      { command: "admin" }
+    );
+  });
+  admin.command("runtime").description("Show runtime diagnostics").option("--detailed", "Show detailed runtime info").action(async (opts) => {
+    await dispatchFromCli(
+      "query",
+      "admin",
+      "runtime",
+      { detailed: opts["detailed"] },
+      { command: "admin" }
+    );
+  });
+  admin.command("smoke").description("Run operational smoke tests across all domains").action(async () => {
+    await dispatchFromCli("query", "admin", "smoke", {}, { command: "admin" });
+  });
+}
+
 // packages/cleo/src/cli/commands/adr.ts
 init_cli();
 function registerAdrCommand(program) {
@@ -94702,6 +94747,21 @@ function registerBugCommand(program) {
   });
 }
 
+// packages/cleo/src/cli/commands/check.ts
+init_cli();
+function registerCheckCommand(program) {
+  const check2 = program.command("check").description("Validation and compliance checks");
+  check2.command("schema <type>").description("Validate schema (type: todo, config, archive, log, sessions)").action(async (type) => {
+    await dispatchFromCli("query", "check", "schema", { type }, { command: "check" });
+  });
+  check2.command("coherence").description("Run coherence check across task data").action(async () => {
+    await dispatchFromCli("query", "check", "coherence", {}, { command: "check" });
+  });
+  check2.command("task <taskId>").description("Validate a specific task").action(async (taskId) => {
+    await dispatchFromCli("query", "check", "task", { taskId }, { command: "check" });
+  });
+}
+
 // packages/cleo/src/cli/commands/checkpoint.ts
 init_src();
 init_internal();
@@ -97373,7 +97433,7 @@ function registerOtelCommand(program) {
 // packages/cleo/src/cli/commands/phase.ts
 init_cli();
 function registerPhaseCommand(program) {
-  const phase = program.command("phase").description("Project-level phase lifecycle management");
+  const phase = program.command("phase").alias("pipeline").description("Project-level phase lifecycle management");
   phase.command("show [slug]").description("Show phase details (current phase if no slug given)").action(async (slug) => {
     const params = slug ? { phaseId: slug } : {};
     await dispatchFromCli("query", "pipeline", "phase.show", params, { command: "phase" });
@@ -99834,6 +99894,7 @@ registerAnalyzeCommand(rootShim);
 registerMapCommand(rootShim);
 registerBackupCommand(rootShim);
 registerBlockersCommand(rootShim);
+registerCheckCommand(rootShim);
 registerComplianceCommand(rootShim);
 registerConfigCommand(rootShim);
 registerConsensusCommand(rootShim);
@@ -99874,6 +99935,7 @@ registerOpsCommand(rootShim);
 registerSnapshotCommand(rootShim);
 registerRemoteCommand(rootShim);
 registerGradeCommand(rootShim);
+registerAdminCommand(rootShim);
 registerAdrCommand(rootShim);
 registerBackfillCommand(rootShim);
 registerMemoryBrainCommand(rootShim);