@cleocode/cleo 2026.3.61 → 2026.3.62

package/dist/mcp/index.js

@@ -13259,7 +13259,7 @@ async function showSequence(cwd) {
     counter: seq.counter,
     lastId: seq.lastId,
     checksum: seq.checksum,
-    nextId: `T${seq.counter + 1}`
+    nextId: `T${String(seq.counter + 1).padStart(3, "0")}`
   };
 }
 async function loadAllTasks(cwd, accessor) {
@@ -41812,6 +41812,58 @@ async function addTask(options, cwd, accessor) {
   if (duplicate) {
     return { task: duplicate, duplicate: true };
   }
+  if (options.dryRun) {
+    const previewNow = (/* @__PURE__ */ new Date()).toISOString();
+    let previewParentForStage = null;
+    if (parentId) {
+      const previewParentTask = await dataAccessor.loadSingleTask(parentId);
+      previewParentForStage = previewParentTask ? { pipelineStage: previewParentTask.pipelineStage, type: previewParentTask.type } : null;
+    }
+    const previewPipelineStage = resolveDefaultPipelineStage({
+      explicitStage: options.pipelineStage,
+      taskType: taskType ?? null,
+      parentTask: previewParentForStage
+    });
+    const previewPosition = options.position !== void 0 ? options.position : await dataAccessor.getNextPosition(parentId);
+    const previewTask = {
+      id: "T???",
+      title: options.title,
+      description: options.description,
+      status,
+      priority,
+      type: taskType,
+      parentId: parentId || null,
+      position: previewPosition,
+      positionVersion: 0,
+      size,
+      pipelineStage: previewPipelineStage,
+      createdAt: previewNow,
+      updatedAt: previewNow
+    };
+    if (phase) previewTask.phase = phase;
+    if (options.labels?.length) previewTask.labels = options.labels.map((l) => l.trim());
+    if (options.files?.length) previewTask.files = options.files.map((f) => f.trim());
+    if (options.acceptance?.length)
+      previewTask.acceptance = options.acceptance.map((a) => a.trim());
+    if (options.depends?.length) previewTask.depends = options.depends.map((d) => d.trim());
+    if (options.notes) {
+      const previewNote = `${(/* @__PURE__ */ new Date()).toISOString().replace("T", " ").replace(/\.\d+Z$/, " UTC")}: ${options.notes}`;
+      previewTask.notes = [previewNote];
+    }
+    if (status === "blocked" && options.description) {
+      previewTask.blockedBy = options.description;
+    }
+    if (status === "done") {
+      previewTask.completedAt = previewNow;
+    }
+    if (taskType !== "epic") {
+      const verificationEnabledRaw = await getRawConfigValue("verification.enabled", cwd);
+      if (verificationEnabledRaw === true) {
+        previewTask.verification = buildDefaultVerification(previewNow);
+      }
+    }
+    return { task: previewTask, dryRun: true };
+  }
   const taskId = await allocateNextTaskId(cwd);
   const now2 = (/* @__PURE__ */ new Date()).toISOString();
   let resolvedParentForStage = null;
@@ -41881,9 +41933,6 @@ async function addTask(options, cwd, accessor) {
       task.verification = buildDefaultVerification(now2);
     }
   }
-  if (options.dryRun) {
-    return { task, dryRun: true };
-  }
   await dataAccessor.transaction(async (tx) => {
     if (options.position !== void 0) {
       await dataAccessor.shiftPositions(parentId, options.position, 1);
@@ -47795,8 +47844,9 @@ var init_observability = __esm({
 });
 
 // packages/core/src/phases/deps.ts
-async function loadAllTasks3(_cwd, accessor) {
-  const { tasks: tasks2 } = await accessor.queryTasks({});
+async function loadAllTasks3(cwd, accessor) {
+  const acc = accessor ?? await getAccessor(cwd);
+  const { tasks: tasks2 } = await acc.queryTasks({});
   return tasks2;
 }
 function buildGraph(tasks2) {
@@ -47872,11 +47922,45 @@ async function getExecutionWaves(epicId, cwd, accessor) {
   }
   return waves;
 }
+async function getCriticalPath2(taskId, cwd, accessor) {
+  const allTasks = await loadAllTasks3(cwd, accessor);
+  const task = allTasks.find((t) => t.id === taskId);
+  if (!task) {
+    throw new CleoError(4 /* NOT_FOUND */, `Task not found: ${taskId}`);
+  }
+  const graph = buildGraph(allTasks);
+  const taskMap = new Map(allTasks.map((t) => [t.id, t]));
+  function findLongestPath(id, visited) {
+    if (visited.has(id)) return [];
+    visited.add(id);
+    const node = graph.get(id);
+    if (!node || node.dependents.length === 0) {
+      return [id];
+    }
+    let longest = [];
+    for (const depId of node.dependents) {
+      const path3 = findLongestPath(depId, new Set(visited));
+      if (path3.length > longest.length) {
+        longest = path3;
+      }
+    }
+    return [id, ...longest];
+  }
+  const path2 = findLongestPath(taskId, /* @__PURE__ */ new Set());
+  return {
+    path: path2.map((id) => {
+      const t = taskMap.get(id);
+      return t ? { id: t.id, title: t.title, status: t.status } : { id, title: "Unknown", status: "unknown" };
+    }),
+    length: path2.length
+  };
+}
 var init_deps2 = __esm({
   "packages/core/src/phases/deps.ts"() {
     "use strict";
     init_src();
     init_errors3();
+    init_data_accessor();
   }
 });
 
@@ -52678,6 +52762,13 @@ var init_capability_matrix = __esm({
         mode: "native",
         preferredChannel: "either"
       },
+      {
+        domain: "admin",
+        operation: "backup",
+        gateway: "query",
+        mode: "native",
+        preferredChannel: "either"
+      },
       {
         domain: "admin",
         operation: "backup",
@@ -57927,7 +58018,7 @@ async function getProjectStats(opts, accessor) {
       dbAnd(dbEq(tasksTable.status, "archived"), dbEq(tasksTable.archiveReason, "completed"))
     ).get();
     archivedCompleted = archivedDoneRow?.c ?? 0;
-    totalCompleted = (statusMap["done"] ?? 0) + archivedCompleted;
+    totalCompleted = entries.filter(isComplete).length;
   } catch {
     totalCreated = entries.filter(isCreate).length;
     totalCompleted = entries.filter(isComplete).length;
@@ -58933,7 +59024,7 @@ var init_audit2 = __esm({
 });
 
 // packages/core/src/system/backup.ts
-import { existsSync as existsSync82, mkdirSync as mkdirSync18, readFileSync as readFileSync59, writeFileSync as writeFileSync11 } from "node:fs";
+import { existsSync as existsSync82, mkdirSync as mkdirSync18, readdirSync as readdirSync27, readFileSync as readFileSync59, writeFileSync as writeFileSync11 } from "node:fs";
 import { join as join84 } from "node:path";
 function createBackup2(projectRoot, opts) {
   const cleoDir = join84(projectRoot, ".cleo");
@@ -58979,6 +59070,36 @@ function createBackup2(projectRoot, opts) {
   }
   return { backupId, path: backupDir, timestamp: timestamp2, type: btype, files: backedUp };
 }
+function listSystemBackups(projectRoot) {
+  const cleoDir = join84(projectRoot, ".cleo");
+  const backupTypes = ["snapshot", "safety", "migration"];
+  const entries = [];
+  for (const btype of backupTypes) {
+    const backupDir = join84(cleoDir, "backups", btype);
+    if (!existsSync82(backupDir)) continue;
+    try {
+      const files = readdirSync27(backupDir).filter((f) => f.endsWith(".meta.json"));
+      for (const metaFile of files) {
+        try {
+          const raw = readFileSync59(join84(backupDir, metaFile), "utf-8");
+          const meta = JSON.parse(raw);
+          if (meta.backupId && meta.timestamp) {
+            entries.push({
+              backupId: meta.backupId,
+              type: meta.type ?? btype,
+              timestamp: meta.timestamp,
+              note: meta.note,
+              files: meta.files ?? []
+            });
+          }
+        } catch {
+        }
+      }
+    } catch {
+    }
+  }
+  return entries.sort((a, b) => b.timestamp.localeCompare(a.timestamp));
+}
 function restoreBackup(projectRoot, params) {
   if (!params.backupId) {
     throw new CleoError(2 /* INVALID_INPUT */, "backupId is required");
@@ -59103,7 +59224,7 @@ var init_audit_prune = __esm({
 });
 
 // packages/core/src/system/cleanup.ts
-import { existsSync as existsSync83, readdirSync as readdirSync27, readFileSync as readFileSync60, unlinkSync as unlinkSync5, writeFileSync as writeFileSync12 } from "node:fs";
+import { existsSync as existsSync83, readdirSync as readdirSync28, readFileSync as readFileSync60, unlinkSync as unlinkSync5, writeFileSync as writeFileSync12 } from "node:fs";
 import { join as join86 } from "node:path";
 async function cleanupSystem(projectRoot, params) {
   if (!params.target) {
@@ -59151,10 +59272,10 @@ async function cleanupSystem(projectRoot, params) {
     case "backups": {
       const backupBaseDir = join86(cleoDir, "backups");
       if (existsSync83(backupBaseDir)) {
-        for (const typeDir of readdirSync27(backupBaseDir)) {
+        for (const typeDir of readdirSync28(backupBaseDir)) {
           const fullDir = join86(backupBaseDir, typeDir);
           try {
-            for (const file2 of readdirSync27(fullDir)) {
+            for (const file2 of readdirSync28(fullDir)) {
               if (file2.endsWith(".meta.json")) {
                 const metaFilePath = join86(fullDir, file2);
                 try {
@@ -59163,7 +59284,7 @@ async function cleanupSystem(projectRoot, params) {
                     items.push(file2.replace(".meta.json", ""));
                     if (!dryRun) {
                       unlinkSync5(metaFilePath);
-                      for (const bf of readdirSync27(fullDir)) {
+                      for (const bf of readdirSync28(fullDir)) {
                         if (bf.includes(meta.backupId)) {
                           try {
                             unlinkSync5(join86(fullDir, bf));
@@ -59193,7 +59314,7 @@ async function cleanupSystem(projectRoot, params) {
       }
       const auditPattern = /^audit-log-.*\.json$/;
       if (existsSync83(cleoDir)) {
-        for (const file2 of readdirSync27(cleoDir)) {
+        for (const file2 of readdirSync28(cleoDir)) {
           if (auditPattern.test(file2)) {
             items.push(file2);
             if (!dryRun) {
@@ -59353,7 +59474,7 @@ import { randomBytes as randomBytes12 } from "node:crypto";
 import {
   existsSync as existsSync85,
   mkdirSync as mkdirSync20,
-  readdirSync as readdirSync28,
+  readdirSync as readdirSync29,
   readFileSync as readFileSync61,
   renameSync as renameSync6,
   unlinkSync as unlinkSync6,
@@ -62392,7 +62513,7 @@ var init_tasks2 = __esm({
 });
 
 // packages/core/src/templates/parser.ts
-import { existsSync as existsSync93, readdirSync as readdirSync29, readFileSync as readFileSync67 } from "fs";
+import { existsSync as existsSync93, readdirSync as readdirSync30, readFileSync as readFileSync67 } from "fs";
 import { join as join96 } from "path";
 import { parse as parseYaml } from "yaml";
 function deriveSubcommand(filename) {
@@ -62466,7 +62587,7 @@ function parseIssueTemplates2(projectRoot) {
   }
   let files;
   try {
-    files = readdirSync29(templateDir).filter((f) => /\.ya?ml$/i.test(f) && f !== "config.yml");
+    files = readdirSync30(templateDir).filter((f) => /\.ya?ml$/i.test(f) && f !== "config.yml");
   } catch (error40) {
     return {
       success: false,
@@ -62879,7 +63000,7 @@ var init_changelog = __esm({
 });
 
 // packages/core/src/ui/command-registry.ts
-import { existsSync as existsSync96, readdirSync as readdirSync30, readFileSync as readFileSync70 } from "node:fs";
+import { existsSync as existsSync96, readdirSync as readdirSync31, readFileSync as readFileSync70 } from "node:fs";
 import { basename as basename16, join as join98 } from "node:path";
 function parseCommandHeader(scriptPath) {
   if (!existsSync96(scriptPath)) return null;
@@ -62962,7 +63083,7 @@ function parseCommandHeader(scriptPath) {
 function scanAllCommands(scriptsDir) {
   const registry2 = /* @__PURE__ */ new Map();
   if (!existsSync96(scriptsDir)) return registry2;
-  for (const file2 of readdirSync30(scriptsDir)) {
+  for (const file2 of readdirSync31(scriptsDir)) {
     if (!file2.endsWith(".sh") && !file2.endsWith(".ts")) continue;
     const meta = parseCommandHeader(join98(scriptsDir, file2));
     if (meta) {
@@ -63890,12 +64011,12 @@ var init_compliance2 = __esm({
 });
 
 // packages/core/src/validation/docs-sync.ts
-import { existsSync as existsSync97, readdirSync as readdirSync31, readFileSync as readFileSync71 } from "node:fs";
+import { existsSync as existsSync97, readdirSync as readdirSync32, readFileSync as readFileSync71 } from "node:fs";
 import { join as join99 } from "node:path";
 function getScriptCommands(scriptsDir) {
   if (!existsSync97(scriptsDir)) return [];
   try {
-    return readdirSync31(scriptsDir).filter((f) => f.endsWith(".sh")).map((f) => f.replace(/\.sh$/, "")).sort();
+    return readdirSync32(scriptsDir).filter((f) => f.endsWith(".sh")).map((f) => f.replace(/\.sh$/, "")).sort();
   } catch {
     return [];
   }
@@ -65317,12 +65438,12 @@ var init_manifest = __esm({
 });
 
 // packages/core/src/validation/protocol-common.ts
-import { existsSync as existsSync100, readdirSync as readdirSync32, readFileSync as readFileSync73 } from "node:fs";
+import { existsSync as existsSync100, readdirSync as readdirSync33, readFileSync as readFileSync73 } from "node:fs";
 function checkOutputFileExists(taskId, expectedDir, pattern) {
   if (!existsSync100(expectedDir)) return false;
   const filePattern = pattern ?? `${taskId}`;
   try {
-    const files = readdirSync32(expectedDir);
+    const files = readdirSync33(expectedDir);
     return files.some((f) => f.includes(filePattern) && f.endsWith(".md"));
   } catch {
     return false;
@@ -66301,7 +66422,7 @@ __export(init_exports, {
   isAutoInitEnabled: () => isAutoInitEnabled,
   updateDocs: () => updateDocs
 });
-import { existsSync as existsSync101, readdirSync as readdirSync33, readFileSync as readFileSync74 } from "node:fs";
+import { existsSync as existsSync101, readdirSync as readdirSync34, readFileSync as readFileSync74 } from "node:fs";
 import { copyFile as copyFile3, lstat, mkdir as mkdir16, readFile as readFile17, symlink, unlink as unlink4, writeFile as writeFile11 } from "node:fs/promises";
 import { platform as platform4 } from "node:os";
 import { basename as basename17, dirname as dirname19, join as join101 } from "node:path";
@@ -66351,7 +66472,7 @@ async function initAgentDefinition(created, warnings) {
   } catch (_err) {
     try {
       await mkdir16(globalAgentsDir, { recursive: true });
-      const files = readdirSync33(agentSourceDir);
+      const files = readdirSync34(agentSourceDir);
       for (const file2 of files) {
         await copyFile3(join101(agentSourceDir, file2), join101(globalAgentsDir, file2));
       }
@@ -66500,7 +66621,7 @@ async function installGitHubTemplates(projectRoot, created, skipped) {
   await mkdir16(issueTemplateDir, { recursive: true });
   const issueSrcDir = join101(templateSrcDir, "ISSUE_TEMPLATE");
   if (existsSync101(issueSrcDir)) {
-    const issueFiles = readdirSync33(issueSrcDir);
+    const issueFiles = readdirSync34(issueSrcDir);
     for (const file2 of issueFiles) {
       const dest = join101(issueTemplateDir, file2);
       if (existsSync101(dest)) {
@@ -71306,7 +71427,7 @@ var init_model_provider_registry = __esm({
 
 // packages/core/src/metrics/token-service.ts
 import { createHash as createHash13, randomUUID as randomUUID8 } from "node:crypto";
-import { existsSync as existsSync107, readdirSync as readdirSync34, readFileSync as readFileSync79 } from "node:fs";
+import { existsSync as existsSync107, readdirSync as readdirSync35, readFileSync as readFileSync79 } from "node:fs";
 import { join as join106 } from "node:path";
 function normalizeProvider(provider, model, runtimeProvider) {
   const value = (provider ?? "").trim().toLowerCase();
@@ -71391,7 +71512,7 @@ function getOtelDir2() {
 function readOtelJsonl(dir) {
   if (!existsSync107(dir)) return [];
   const entries = [];
-  for (const file2 of readdirSync34(dir)) {
+  for (const file2 of readdirSync35(dir)) {
     if (!file2.endsWith(".json") && !file2.endsWith(".jsonl")) continue;
     const filePath = join106(dir, file2);
     const raw = readFileSync79(filePath, "utf-8").trim();
@@ -71783,7 +71904,7 @@ var init_parallel = __esm({
 });
 
 // packages/core/src/orchestration/skill-ops.ts
-import { existsSync as existsSync108, readdirSync as readdirSync35, readFileSync as readFileSync80 } from "node:fs";
+import { existsSync as existsSync108, readdirSync as readdirSync36, readFileSync as readFileSync80 } from "node:fs";
 import { join as join107 } from "node:path";
 import { getCanonicalSkillsDir as getCanonicalSkillsDir3 } from "@cleocode/caamp";
 function getSkillContent(skillName, projectRoot) {
@@ -71808,7 +71929,7 @@ function getSkillContent(skillName, projectRoot) {
   let references = [];
   if (existsSync108(refsDir)) {
     try {
-      references = readdirSync35(refsDir).filter((f) => f.endsWith(".md") || f.endsWith(".txt")).map((f) => ({
+      references = readdirSync36(refsDir).filter((f) => f.endsWith(".md") || f.endsWith(".txt")).map((f) => ({
         name: f,
         path: join107(skillDir, "references", f)
       }));
@@ -74522,7 +74643,7 @@ import {
   copyFileSync as copyFileSync7,
   existsSync as existsSync111,
   mkdirSync as mkdirSync23,
-  readdirSync as readdirSync36,
+  readdirSync as readdirSync37,
   readFileSync as readFileSync83,
   writeFileSync as writeFileSync20
 } from "node:fs";
@@ -74735,7 +74856,7 @@ async function runUpgrade(options = {}) {
           const dbPath2 = join109(cleoDir2, "tasks.db");
           const safetyDir = join109(cleoDir2, "backups", "safety");
           if (existsSync111(safetyDir)) {
-            const backups = readdirSync36(safetyDir).filter((f) => f.startsWith("tasks.db.pre-migration.")).sort().reverse();
+            const backups = readdirSync37(safetyDir).filter((f) => f.startsWith("tasks.db.pre-migration.")).sort().reverse();
             if (backups.length > 0 && !existsSync111(dbPath2)) {
               copyFileSync7(join109(safetyDir, backups[0]), dbPath2);
             }
@@ -77662,7 +77783,7 @@ var init_bootstrap2 = __esm({
 });
 
 // packages/core/src/orchestration/critical-path.ts
-async function getCriticalPath2(cwd, accessor) {
+async function getCriticalPath3(cwd, accessor) {
   const acc = accessor ?? await getAccessor(cwd);
   const { tasks: tasks2 } = await acc.queryTasks({});
   if (tasks2.length === 0) {
@@ -78283,6 +78404,7 @@ __export(internal_exports, {
   deletePhase: () => deletePhase,
   deleteTask: () => deleteTask,
   deleteTokenUsage: () => deleteTokenUsage,
+  depsCriticalPath: () => getCriticalPath2,
   deregisterAgent: () => deregisterAgent,
   describeChannel: () => describeChannel,
   detectCrashedAgents: () => detectCrashedAgents,
@@ -78424,6 +78546,7 @@ __export(internal_exports, {
   getSystemInfo: () => getSystemInfo2,
   getSystemMetrics: () => getSystemMetrics,
   getSystemMigrationStatus: () => getMigrationStatus2,
+  getTask: () => getTask,
   getTaskHistory: () => getTaskHistory,
   getTaskPath: () => getTaskPath,
   getTemplateForSubcommand: () => getTemplateForSubcommand2,
@@ -78499,6 +78622,7 @@ __export(internal_exports, {
   listSessions: () => listSessions,
   listStickies: () => listStickies,
   listStrictnessPresets: () => listStrictnessPresets,
+  listSystemBackups: () => listSystemBackups,
   listTasks: () => listTasks,
   listTesseraTemplates: () => listTesseraTemplates,
   listTokenUsage: () => listTokenUsage,
@@ -78559,7 +78683,7 @@ __export(internal_exports, {
   ops: () => operations_exports,
   orchestration: () => orchestration_exports,
   orchestrationAnalyzeDependencies: () => analyzeDependencies,
-  orchestrationGetCriticalPath: () => getCriticalPath2,
+  orchestrationGetCriticalPath: () => getCriticalPath3,
   orchestrationGetNextTask: () => getNextTask,
   orchestrationGetReadyTasks: () => getReadyTasks2,
   orphanDetection: () => orphanDetection,
@@ -78793,6 +78917,7 @@ var init_internal = __esm({
     init_waves();
     init_otel();
     init_paths();
+    init_deps2();
     init_phases();
     init_pipeline2();
     init_platform();
@@ -84515,6 +84640,16 @@ var OPERATIONS = [
       }
     ]
   },
+  {
+    gateway: "query",
+    domain: "admin",
+    operation: "backup",
+    description: "admin.backup (query) \u2014 list available backups (read-only)",
+    tier: 1,
+    idempotent: true,
+    sessionRequired: false,
+    requiredParams: []
+  },
   {
     gateway: "mutate",
     domain: "admin",
@@ -86568,7 +86703,7 @@ async function orchestrateCriticalPath(projectRoot) {
   try {
     const root = projectRoot || resolveProjectRoot();
     const accessor = await getAccessor(root);
-    const result = await getCriticalPath2(root, accessor);
+    const result = await getCriticalPath3(root, accessor);
     return { success: true, data: result };
   } catch (err) {
     return engineError("E_GENERAL", err.message);
@@ -87324,7 +87459,7 @@ async function releaseShip(params, projectRoot) {
 // packages/cleo/src/dispatch/engines/system-engine.ts
 init_internal();
 init_error();
-import { existsSync as existsSync119, readdirSync as readdirSync37, readFileSync as readFileSync93 } from "node:fs";
+import { existsSync as existsSync119, readdirSync as readdirSync38, readFileSync as readFileSync93 } from "node:fs";
 import { basename as basename18, join as join112 } from "node:path";
 var HELP_TOPICS = {
   session: {
@@ -87631,7 +87766,7 @@ function systemContext(projectRoot, params) {
     const sessions2 = [];
     const statesDir = join112(cleoDir, "context-states");
     if (existsSync119(statesDir)) {
-      for (const file2 of readdirSync37(statesDir)) {
+      for (const file2 of readdirSync38(statesDir)) {
         if (file2.startsWith("context-state-") && file2.endsWith(".json")) {
           try {
             const state = JSON.parse(readFileSync93(join112(statesDir, file2), "utf-8"));
@@ -87768,6 +87903,14 @@ function systemBackup(projectRoot, params) {
     return engineError("E_GENERAL", err.message);
   }
 }
+function systemListBackups(projectRoot) {
+  try {
+    const result = listSystemBackups(projectRoot);
+    return { success: true, data: result };
+  } catch (err) {
+    return engineError("E_GENERAL", err.message);
+  }
+}
 function systemRestore(projectRoot, params) {
   try {
     const result = restoreBackup(projectRoot, params);
@@ -89334,6 +89477,16 @@ var AdminHandler = class {
             data: result
           };
         }
+        case "backup": {
+          const result = systemListBackups(projectRoot);
+          return wrapResult(
+            { success: true, data: { backups: result, count: result.length } },
+            "query",
+            "admin",
+            operation,
+            startTime
+          );
+        }
         case "map": {
           const { mapCodebase: mapCodebase3 } = await Promise.resolve().then(() => (init_codebase_map_engine(), codebase_map_engine_exports));
           const result = await mapCodebase3(projectRoot, {
@@ -89823,6 +89976,7 @@ var AdminHandler = class {
         "token",
         "adr.show",
         "adr.find",
+        "backup",
         "export",
         "map"
       ],