@cleocode/cleo 2026.4.26 → 2026.4.28

package/dist/cli/index.js

@@ -38789,10 +38789,10 @@ async function readProjectMeta(projectPath) {
 }
 async function readProjectId(projectPath) {
   try {
-    const { readFileSync: readFileSync103, existsSync: existsSync131 } = await import("node:fs");
+    const { readFileSync: readFileSync102, existsSync: existsSync131 } = await import("node:fs");
     const infoPath = join64(projectPath, ".cleo", "project-info.json");
     if (!existsSync131(infoPath)) return "";
-    const data = JSON.parse(readFileSync103(infoPath, "utf-8"));
+    const data = JSON.parse(readFileSync102(infoPath, "utf-8"));
     return typeof data.projectId === "string" ? data.projectId : "";
   } catch {
     return "";
@@ -54643,33 +54643,23 @@ var init_runtime = __esm({
 });
 
 // packages/core/src/system/safestop.ts
-import { existsSync as existsSync96, readFileSync as readFileSync67, writeFileSync as writeFileSync15 } from "node:fs";
+import { existsSync as existsSync96 } from "node:fs";
 import { join as join98 } from "node:path";
-function safestop(projectRoot, opts) {
+async function safestop(projectRoot, opts) {
   const dryRun = opts?.dryRun ?? false;
   const reason = opts?.reason ?? "Manual safestop";
   let sessionEnded = false;
   if (!dryRun && !opts?.noSessionEnd) {
-    const sessPath = join98(projectRoot, ".cleo", "sessions.json");
-    if (existsSync96(sessPath)) {
-      try {
-        const data = JSON.parse(readFileSync67(sessPath, "utf-8"));
-        const sessions2 = data.sessions ?? [];
-        let changed = false;
-        for (const s3 of sessions2) {
-          if (s3.status === "active") {
-            s3.status = "ended";
-            s3.endedAt = (/* @__PURE__ */ new Date()).toISOString();
-            s3.endNote = `Safestop: ${reason}`;
-            changed = true;
-            sessionEnded = true;
-          }
-        }
-        if (changed) {
-          writeFileSync15(sessPath, JSON.stringify(data, null, 2), "utf-8");
-        }
-      } catch {
+    try {
+      const accessor = await getAccessor(projectRoot);
+      const activeSession = await accessor.getActiveSession();
+      if (activeSession && activeSession.id !== "default") {
+        activeSession.status = "ended";
+        activeSession.endedAt = (/* @__PURE__ */ new Date()).toISOString();
+        await accessor.upsertSingleSession(activeSession);
+        sessionEnded = true;
       }
+    } catch {
     }
   }
   return { stopped: !dryRun, reason, sessionEnded, handoff: opts?.handoff, dryRun };
@@ -55260,7 +55250,7 @@ var init_tasks2 = __esm({
 });
 
 // packages/core/src/templates/parser.ts
-import { existsSync as existsSync97, readdirSync as readdirSync31, readFileSync as readFileSync68 } from "fs";
+import { existsSync as existsSync97, readdirSync as readdirSync31, readFileSync as readFileSync67 } from "fs";
 import { join as join99 } from "path";
 import { parse as parseYaml } from "yaml";
 function deriveSubcommand(filename) {
@@ -55276,7 +55266,7 @@ function deriveSubcommand(filename) {
 }
 function parseTemplateFile2(templateDir, filename) {
   const filePath = join99(templateDir, filename);
-  const raw = readFileSync68(filePath, "utf-8");
+  const raw = readFileSync67(filePath, "utf-8");
   const parsed = parseYaml(raw);
   const name2 = typeof parsed.name === "string" ? parsed.name : filename;
   const titlePrefix = typeof parsed.title === "string" ? parsed.title : "";
@@ -55463,7 +55453,7 @@ var init_templates = __esm({
 });
 
 // packages/core/src/ui/aliases.ts
-import { existsSync as existsSync98, readFileSync as readFileSync69, writeFileSync as writeFileSync16 } from "node:fs";
+import { existsSync as existsSync98, readFileSync as readFileSync68, writeFileSync as writeFileSync15 } from "node:fs";
 import { homedir as homedir5, platform as platform3 } from "node:os";
 import { join as join100 } from "node:path";
 function getCurrentShell() {
@@ -55526,40 +55516,40 @@ function generatePowershellAliases(cleoPath) {
 }
 function hasAliasBlock(filePath) {
   if (!existsSync98(filePath)) return false;
-  const content = readFileSync69(filePath, "utf-8");
+  const content = readFileSync68(filePath, "utf-8");
   return content.includes(MARKER_START) && content.includes(MARKER_END);
 }
 function getInstalledVersion(filePath) {
   if (!existsSync98(filePath)) return null;
-  const content = readFileSync69(filePath, "utf-8");
+  const content = readFileSync68(filePath, "utf-8");
   const match = content.match(/CLEO CLI aliases \(v([^)]+)\)/);
   return match?.[1] ?? null;
 }
 function injectAliases(filePath, shell = "bash", cleoPath) {
   const content = shell === "powershell" ? generatePowershellAliases(cleoPath) : generateBashAliases(cleoPath);
   if (!existsSync98(filePath)) {
-    writeFileSync16(filePath, content + "\n", "utf-8");
+    writeFileSync15(filePath, content + "\n", "utf-8");
     return { action: "created", version: ALIASES_VERSION };
   }
-  const existing = readFileSync69(filePath, "utf-8");
+  const existing = readFileSync68(filePath, "utf-8");
   if (hasAliasBlock(filePath)) {
     const startIdx = existing.indexOf(MARKER_START);
     const endIdx = existing.indexOf(MARKER_END) + MARKER_END.length;
     const updated = existing.slice(0, startIdx) + content + existing.slice(endIdx);
-    writeFileSync16(filePath, updated, "utf-8");
+    writeFileSync15(filePath, updated, "utf-8");
     return { action: "updated", version: ALIASES_VERSION };
   }
-  writeFileSync16(filePath, existing + "\n" + content + "\n", "utf-8");
+  writeFileSync15(filePath, existing + "\n" + content + "\n", "utf-8");
   return { action: "added", version: ALIASES_VERSION };
 }
 function removeAliases(filePath) {
   if (!existsSync98(filePath) || !hasAliasBlock(filePath)) return false;
-  const existing = readFileSync69(filePath, "utf-8");
+  const existing = readFileSync68(filePath, "utf-8");
   const startIdx = existing.indexOf(MARKER_START);
   const endIdx = existing.indexOf(MARKER_END) + MARKER_END.length;
   const before = existing.slice(0, startIdx).replace(/\n+$/, "\n");
   const after = existing.slice(endIdx).replace(/^\n+/, "\n");
-  writeFileSync16(filePath, before + after, "utf-8");
+  writeFileSync15(filePath, before + after, "utf-8");
   return true;
 }
 function checkAliasesStatus(shell) {
@@ -55590,7 +55580,7 @@ var init_aliases = __esm({
 });
 
 // packages/core/src/ui/changelog.ts
-import { appendFileSync as appendFileSync9, existsSync as existsSync99, readFileSync as readFileSync70, writeFileSync as writeFileSync17 } from "node:fs";
+import { appendFileSync as appendFileSync9, existsSync as existsSync99, readFileSync as readFileSync69, writeFileSync as writeFileSync16 } from "node:fs";
 async function discoverReleaseTasks(options = {}, cwd, accessor) {
   const tasks2 = [];
   const dataSources = [];
@@ -55673,21 +55663,21 @@ function formatChangelogJson(version2, date6, sections) {
   };
 }
 function writeChangelogFile(filePath, content) {
-  writeFileSync17(filePath, content, "utf-8");
+  writeFileSync16(filePath, content, "utf-8");
 }
 function appendToChangelog(filePath, newContent) {
   if (!existsSync99(filePath)) {
-    writeFileSync17(filePath, `# Changelog
+    writeFileSync16(filePath, `# Changelog
 
 ${newContent}`, "utf-8");
     return;
   }
-  const existing = readFileSync70(filePath, "utf-8");
+  const existing = readFileSync69(filePath, "utf-8");
   const headerMatch = existing.match(/^# .+\n/m);
   if (headerMatch) {
     const insertPos = (headerMatch.index ?? 0) + headerMatch[0].length;
     const updated = existing.slice(0, insertPos) + "\n" + newContent + existing.slice(insertPos);
-    writeFileSync17(filePath, updated, "utf-8");
+    writeFileSync16(filePath, updated, "utf-8");
   } else {
     appendFileSync9(filePath, "\n" + newContent);
   }
@@ -55747,11 +55737,11 @@ var init_changelog = __esm({
 });
 
 // packages/core/src/ui/command-registry.ts
-import { existsSync as existsSync100, readdirSync as readdirSync32, readFileSync as readFileSync71 } from "node:fs";
+import { existsSync as existsSync100, readdirSync as readdirSync32, readFileSync as readFileSync70 } from "node:fs";
 import { basename as basename16, join as join101 } from "node:path";
 function parseCommandHeader(scriptPath) {
   if (!existsSync100(scriptPath)) return null;
-  const content = readFileSync71(scriptPath, "utf-8");
+  const content = readFileSync70(scriptPath, "utf-8");
   const lines = content.split("\n");
   let inHeader = false;
   const headerLines = [];
@@ -71081,7 +71071,7 @@ var init_compliance2 = __esm({
 });
 
 // packages/core/src/validation/docs-sync.ts
-import { existsSync as existsSync101, readdirSync as readdirSync33, readFileSync as readFileSync72 } from "node:fs";
+import { existsSync as existsSync101, readdirSync as readdirSync33, readFileSync as readFileSync71 } from "node:fs";
 import { join as join102 } from "node:path";
 function getScriptCommands(scriptsDir) {
   if (!existsSync101(scriptsDir)) return [];
@@ -71094,7 +71084,7 @@ function getScriptCommands(scriptsDir) {
 function getIndexScripts(indexPath) {
   if (!existsSync101(indexPath)) return [];
   try {
-    const content = readFileSync72(indexPath, "utf-8");
+    const content = readFileSync71(indexPath, "utf-8");
     const index2 = JSON.parse(content);
     return index2.commands.map((cmd) => cmd.script ?? "").filter((s3) => s3).map((s3) => s3.replace(/\.sh$/, "")).sort();
   } catch {
@@ -71104,7 +71094,7 @@ function getIndexScripts(indexPath) {
 function getIndexCommands(indexPath) {
   if (!existsSync101(indexPath)) return [];
   try {
-    const content = readFileSync72(indexPath, "utf-8");
+    const content = readFileSync71(indexPath, "utf-8");
     const index2 = JSON.parse(content);
     return index2.commands.map((cmd) => cmd.name).sort();
   } catch {
@@ -71141,8 +71131,8 @@ function checkWrapperSync(wrapperPath, indexPath) {
   if (!existsSync101(wrapperPath) || !existsSync101(indexPath)) return [];
   const issues = [];
   try {
-    const wrapperContent = readFileSync72(wrapperPath, "utf-8");
-    const indexContent = readFileSync72(indexPath, "utf-8");
+    const wrapperContent = readFileSync71(wrapperPath, "utf-8");
+    const indexContent = readFileSync71(indexPath, "utf-8");
     const index2 = JSON.parse(indexContent);
     const match = wrapperContent.match(/_get_all_commands\(\)\s*\{[^}]*echo\s+"([^"]+)"/);
     const wrapperCmds = new Set(match ? match[1].split(/\s+/).filter(Boolean) : []);
@@ -71173,7 +71163,7 @@ function detectDrift(mode = "full", projectRoot = ".") {
     const readmePath = join102(projectRoot, "README.md");
     if (existsSync101(readmePath)) {
       try {
-        const readme = readFileSync72(readmePath, "utf-8");
+        const readme = readFileSync71(readmePath, "utf-8");
         const readmeCmds = new Set(
           (readme.match(/cleo [a-z-]+/g) ?? []).map((m2) => m2.replace("cleo ", ""))
         );
@@ -71223,7 +71213,7 @@ var init_docs_sync = __esm({
 
 // packages/core/src/validation/doctor/project-cache.ts
 import { createHash as createHash11 } from "node:crypto";
-import { existsSync as existsSync102, mkdirSync as mkdirSync23, readFileSync as readFileSync73, unlinkSync as unlinkSync8, writeFileSync as writeFileSync18 } from "node:fs";
+import { existsSync as existsSync102, mkdirSync as mkdirSync23, readFileSync as readFileSync72, unlinkSync as unlinkSync8, writeFileSync as writeFileSync17 } from "node:fs";
 import { dirname as dirname19, join as join103 } from "node:path";
 function getCacheFilePath(cleoHome) {
   const home = cleoHome ?? getCleoHome();
@@ -71239,13 +71229,13 @@ function initCacheFile(cacheFile) {
   if (!existsSync102(dir)) {
     mkdirSync23(dir, { recursive: true });
   }
-  writeFileSync18(cacheFile, JSON.stringify(cache, null, 2));
+  writeFileSync17(cacheFile, JSON.stringify(cache, null, 2));
   return cache;
 }
 function loadCache(cacheFile) {
   if (!existsSync102(cacheFile)) return null;
   try {
-    const content = readFileSync73(cacheFile, "utf-8");
+    const content = readFileSync72(cacheFile, "utf-8");
     return JSON.parse(content);
   } catch {
     return null;
@@ -71254,7 +71244,7 @@ function loadCache(cacheFile) {
 function getFileHash(filePath) {
   if (!existsSync102(filePath)) return "";
   try {
-    const content = readFileSync73(filePath);
+    const content = readFileSync72(filePath);
     return createHash11("sha256").update(content).digest("hex");
   } catch {
     return "";
@@ -71299,14 +71289,14 @@ function cacheValidationResult(projectHash, projectPath, validationStatus, issue
     ttl: CACHE_TTL_SECONDS
   };
   cache.lastUpdated = timestamp2;
-  writeFileSync18(cachePath, JSON.stringify(cache, null, 2));
+  writeFileSync17(cachePath, JSON.stringify(cache, null, 2));
 }
 function clearProjectCache(projectHash, cacheFile) {
   const cachePath = cacheFile ?? getCacheFilePath();
   const cache = loadCache(cachePath);
   if (!cache) return;
   delete cache.projects[projectHash];
-  writeFileSync18(cachePath, JSON.stringify(cache, null, 2));
+  writeFileSync17(cachePath, JSON.stringify(cache, null, 2));
 }
 function clearEntireCache(cacheFile) {
   const cachePath = cacheFile ?? getCacheFilePath();
@@ -72523,7 +72513,7 @@ var init_manifest = __esm({
 });
 
 // packages/core/src/validation/protocol-common.ts
-import { existsSync as existsSync104, readdirSync as readdirSync34, readFileSync as readFileSync74 } from "node:fs";
+import { existsSync as existsSync104, readdirSync as readdirSync34, readFileSync as readFileSync73 } from "node:fs";
 function checkOutputFileExists(taskId, expectedDir, pattern) {
   if (!existsSync104(expectedDir)) return false;
   const filePattern = pattern ?? `${taskId}`;
@@ -72537,7 +72527,7 @@ function checkOutputFileExists(taskId, expectedDir, pattern) {
 function checkDocumentationSections(filePath, sections) {
   if (!existsSync104(filePath)) return false;
   try {
-    const content = readFileSync74(filePath, "utf-8");
+    const content = readFileSync73(filePath, "utf-8");
     return sections.every((section) => {
       const regex = new RegExp(`^#+ .*${escapeRegex3(section)}`, "m");
       return regex.test(content);
@@ -72608,7 +72598,7 @@ function checkLinkedTasksPresent(entry, requiredIds) {
 function checkProvenanceTags(filePath, taskId) {
   if (!existsSync104(filePath)) return false;
   try {
-    const content = readFileSync74(filePath, "utf-8");
+    const content = readFileSync73(filePath, "utf-8");
     if (taskId) {
       return content.includes(`@task ${taskId}`);
     }
@@ -73619,7 +73609,7 @@ __export(init_exports, {
   resolveSeedAgentsDir: () => resolveSeedAgentsDir,
   updateDocs: () => updateDocs
 });
-import { existsSync as existsSync106, readdirSync as readdirSync36, readFileSync as readFileSync75 } from "node:fs";
+import { existsSync as existsSync106, readdirSync as readdirSync36, readFileSync as readFileSync74 } from "node:fs";
 import { copyFile as copyFile4, 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 dirname21, join as join105 } from "node:path";
@@ -73753,7 +73743,7 @@ async function initCoreSkills(created, warnings) {
       warnings.push("Failed to register skill library with CAAMP");
     }
     const catalogPath = join105(ctSkillsRoot, "skills.json");
-    const catalog4 = JSON.parse(readFileSync75(catalogPath, "utf-8"));
+    const catalog4 = JSON.parse(readFileSync74(catalogPath, "utf-8"));
     const skills = catalog4.skills ?? [];
     const coreSkills = skills.filter((s3) => s3.tier <= 2);
     const installed = [];
@@ -73822,7 +73812,7 @@ async function installGitHubTemplates(projectRoot, created, skipped) {
         skipped.push(`.github/ISSUE_TEMPLATE/${file2}`);
         continue;
       }
-      const content = readFileSync75(join105(issueSrcDir, file2), "utf-8");
+      const content = readFileSync74(join105(issueSrcDir, file2), "utf-8");
       await writeFile11(dest, content, "utf-8");
       created.push(`.github/ISSUE_TEMPLATE/${file2}`);
     }
@@ -73833,7 +73823,7 @@ async function installGitHubTemplates(projectRoot, created, skipped) {
     if (existsSync106(prTemplateDest)) {
       skipped.push(".github/pull_request_template.md");
     } else {
-      const content = readFileSync75(prTemplateSrc, "utf-8");
+      const content = readFileSync74(prTemplateSrc, "utf-8");
       await writeFile11(prTemplateDest, content, "utf-8");
       created.push(".github/pull_request_template.md");
     }
@@ -74286,13 +74276,13 @@ var init_init = __esm({
 });
 
 // packages/core/src/sessions/context-alert.ts
-import { existsSync as existsSync107, readFileSync as readFileSync76, writeFileSync as writeFileSync19 } from "node:fs";
+import { existsSync as existsSync107, readFileSync as readFileSync75, writeFileSync as writeFileSync18 } from "node:fs";
 import { join as join106 } from "node:path";
 function getCurrentSessionId(cwd) {
   if (process.env.CLEO_SESSION) return process.env.CLEO_SESSION;
   const sessionFile = join106(getCleoDir(cwd), ".current-session");
   if (existsSync107(sessionFile)) {
-    return readFileSync76(sessionFile, "utf-8").trim() || null;
+    return readFileSync75(sessionFile, "utf-8").trim() || null;
   }
   return null;
 }
@@ -74388,7 +74378,7 @@ __export(project_info_exports, {
   getProjectInfoSync: () => getProjectInfoSync,
   updateProjectName: () => updateProjectName
 });
-import { existsSync as existsSync108, readFileSync as readFileSync77, writeFileSync as writeFileSync20 } from "node:fs";
+import { existsSync as existsSync108, readFileSync as readFileSync76, writeFileSync as writeFileSync19 } from "node:fs";
 import { readFile as readFile18 } from "node:fs/promises";
 import { join as join107 } from "node:path";
 async function getProjectInfo(cwd) {
@@ -74415,7 +74405,7 @@ function getProjectInfoSync(cwd) {
   const infoPath = join107(cleoDir, "project-info.json");
   if (!existsSync108(infoPath)) return null;
   try {
-    const raw = readFileSync77(infoPath, "utf-8");
+    const raw = readFileSync76(infoPath, "utf-8");
     const data = JSON.parse(raw);
     if (typeof data.projectHash !== "string" || data.projectHash.length === 0) {
       return null;
@@ -74436,10 +74426,10 @@ function updateProjectName(cwd, name2) {
   const cleoDir = getCleoDirAbsolute(cwd);
   const infoPath = join107(cleoDir, "project-info.json");
   if (!existsSync108(infoPath)) return;
-  const data = JSON.parse(readFileSync77(infoPath, "utf-8"));
+  const data = JSON.parse(readFileSync76(infoPath, "utf-8"));
   data.projectName = name2;
   data.lastUpdated = (/* @__PURE__ */ new Date()).toISOString();
-  writeFileSync20(infoPath, `${JSON.stringify(data, null, 2)}
+  writeFileSync19(infoPath, `${JSON.stringify(data, null, 2)}
 `);
 }
 var init_project_info = __esm({
@@ -74450,7 +74440,7 @@ var init_project_info = __esm({
 });
 
 // packages/core/src/bootstrap.ts
-import { existsSync as existsSync109, readFileSync as readFileSync78 } from "node:fs";
+import { existsSync as existsSync109, readFileSync as readFileSync77 } from "node:fs";
 import { mkdir as mkdir17, readFile as readFile19, writeFile as writeFile12 } from "node:fs/promises";
 import { homedir as homedir6 } from "node:os";
 import { join as join108 } from "node:path";
@@ -74489,7 +74479,7 @@ async function ensureGlobalTemplatesBootstrap(ctx, packageRootOverride) {
     const pkgRoot = packageRootOverride ?? getPackageRoot();
     const templatePath = join108(pkgRoot, "templates", "CLEO-INJECTION.md");
     if (existsSync109(templatePath)) {
-      templateContent = readFileSync78(templatePath, "utf-8");
+      templateContent = readFileSync77(templatePath, "utf-8");
     }
   } catch {
   }
@@ -79175,7 +79165,7 @@ var init_engine_compat = __esm({
 
 // packages/core/src/memory/pipeline-manifest-sqlite.ts
 import { createHash as createHash12 } from "node:crypto";
-import { existsSync as existsSync111, readFileSync as readFileSync79, renameSync as renameSync8 } from "node:fs";
+import { existsSync as existsSync111, readFileSync as readFileSync78, renameSync as renameSync8 } from "node:fs";
 import { join as join109 } from "node:path";
 import { and as and10, count as count2, desc as desc5, eq as eq13, gte as gte3, isNull as isNull3, like as like3, lte as lte2, or as or5 } from "drizzle-orm";
 async function getDb3(cwd) {
@@ -79308,7 +79298,7 @@ async function pipelineManifestShow(researchId, projectRoot) {
     try {
       const filePath = join109(root, entry.file);
       if (existsSync111(filePath)) {
-        fileContent = readFileSync79(filePath, "utf-8");
+        fileContent = readFileSync78(filePath, "utf-8");
       }
     } catch {
     }
@@ -79697,7 +79687,7 @@ var init_model_provider_registry = __esm({
 
 // packages/core/src/metrics/token-service.ts
 import { createHash as createHash13, randomUUID as randomUUID9 } from "node:crypto";
-import { existsSync as existsSync112, readdirSync as readdirSync37, readFileSync as readFileSync80 } from "node:fs";
+import { existsSync as existsSync112, readdirSync as readdirSync37, readFileSync as readFileSync79 } from "node:fs";
 import { join as join110 } from "node:path";
 function normalizeProvider(provider, model, runtimeProvider) {
   const value = (provider ?? "").trim().toLowerCase();
@@ -79785,7 +79775,7 @@ function readOtelJsonl(dir) {
   for (const file2 of readdirSync37(dir)) {
     if (!file2.endsWith(".json") && !file2.endsWith(".jsonl")) continue;
     const filePath = join110(dir, file2);
-    const raw = readFileSync80(filePath, "utf-8").trim();
+    const raw = readFileSync79(filePath, "utf-8").trim();
     if (!raw) continue;
     for (const line2 of raw.split("\n")) {
       try {
@@ -80174,7 +80164,7 @@ var init_parallel = __esm({
 });
 
 // packages/core/src/orchestration/skill-ops.ts
-import { existsSync as existsSync113, readdirSync as readdirSync38, readFileSync as readFileSync81 } from "node:fs";
+import { existsSync as existsSync113, readdirSync as readdirSync38, readFileSync as readFileSync80 } from "node:fs";
 import { join as join111 } from "node:path";
 import { getCanonicalSkillsDir as getCanonicalSkillsDir3 } from "@cleocode/caamp";
 function getSkillContent(skillName, projectRoot) {
@@ -80194,7 +80184,7 @@ function getSkillContent(skillName, projectRoot) {
   if (!existsSync113(skillFilePath)) {
     throw new CleoError(4 /* NOT_FOUND */, `Skill file not found: ${skillFilePath}`);
   }
-  const content = readFileSync81(skillFilePath, "utf-8");
+  const content = readFileSync80(skillFilePath, "utf-8");
   const refsDir = join111(skillDir, "references");
   let references = [];
   if (existsSync113(refsDir)) {
@@ -80389,7 +80379,7 @@ var init_validate_spawn = __esm({
 });
 
 // packages/core/src/sessions/context-inject.ts
-import { existsSync as existsSync114, readFileSync as readFileSync82 } from "node:fs";
+import { existsSync as existsSync114, readFileSync as readFileSync81 } from "node:fs";
 import { resolve as resolve11 } from "node:path";
 function resolveRoot2(projectRoot) {
   return projectRoot || getProjectRoot();
@@ -80409,7 +80399,7 @@ function injectContext(protocolType, params, projectRoot) {
   for (const loc of protocolLocations) {
     if (existsSync114(loc)) {
       try {
-        protocolContent = readFileSync82(loc, "utf-8");
+        protocolContent = readFileSync81(loc, "utf-8");
         protocolPath = loc.replace(root + "/", "");
         break;
       } catch {
@@ -86109,7 +86099,7 @@ __export(migration_sqlite_exports, {
   migrateJsonToSqlite: () => migrateJsonToSqlite2,
   migrateJsonToSqliteAtomic: () => migrateJsonToSqliteAtomic
 });
-import { existsSync as existsSync117, mkdirSync as mkdirSync25, readFileSync as readFileSync83 } from "node:fs";
+import { existsSync as existsSync117, mkdirSync as mkdirSync25, readFileSync as readFileSync82 } from "node:fs";
 import { dirname as dirname22, join as join114 } from "node:path";
 function topoSortTasks(tasks2) {
   const taskMap = new Map(tasks2.map((t) => [t.id, t]));
@@ -86148,7 +86138,7 @@ function countJsonRecords(cleoDir) {
   const todoPath = join114(cleoDir, "todo.json");
   if (existsSync117(todoPath)) {
     try {
-      const data = JSON.parse(readFileSync83(todoPath, "utf-8"));
+      const data = JSON.parse(readFileSync82(todoPath, "utf-8"));
       tasks2 = (data.tasks ?? []).length;
     } catch {
     }
@@ -86156,7 +86146,7 @@ function countJsonRecords(cleoDir) {
   const archivePath = join114(cleoDir, "todo-archive.json");
   if (existsSync117(archivePath)) {
     try {
-      const data = JSON.parse(readFileSync83(archivePath, "utf-8"));
+      const data = JSON.parse(readFileSync82(archivePath, "utf-8"));
       archived = (data.tasks ?? data.archivedTasks ?? []).length;
     } catch {
     }
@@ -86164,7 +86154,7 @@ function countJsonRecords(cleoDir) {
   const sessionsPath = join114(cleoDir, "sessions.json");
   if (existsSync117(sessionsPath)) {
     try {
-      const data = JSON.parse(readFileSync83(sessionsPath, "utf-8"));
+      const data = JSON.parse(readFileSync82(sessionsPath, "utf-8"));
       sessions2 = (data.sessions ?? []).length;
     } catch {
     }
@@ -86237,7 +86227,7 @@ async function runMigrationDataImport(db, cleoDir, result, logger) {
       logger?.info("import", "read-todo", "Reading todo.json", {
         path: todoPath.replace(cleoDir, ".")
       });
-      const todoData = JSON.parse(readFileSync83(todoPath, "utf-8"));
+      const todoData = JSON.parse(readFileSync82(todoPath, "utf-8"));
       const tasks2 = topoSortTasks(todoData.tasks ?? []);
       const totalTasks = tasks2.length;
       logger?.info("import", "tasks-start", `Starting import of ${totalTasks} tasks`, {
@@ -86317,7 +86307,7 @@ async function runMigrationDataImport(db, cleoDir, result, logger) {
       logger?.info("import", "read-archive", "Reading todo-archive.json", {
         path: archivePath.replace(cleoDir, ".")
       });
-      const archiveData = JSON.parse(readFileSync83(archivePath, "utf-8"));
+      const archiveData = JSON.parse(readFileSync82(archivePath, "utf-8"));
       const archivedTasks = topoSortTasks(archiveData.tasks ?? archiveData.archivedTasks ?? []);
       const totalArchived = archivedTasks.length;
       logger?.info(
@@ -86386,7 +86376,7 @@ async function runMigrationDataImport(db, cleoDir, result, logger) {
       logger?.info("import", "read-sessions", "Reading sessions.json", {
         path: sessionsPath.replace(cleoDir, ".")
       });
-      const sessionsData = JSON.parse(readFileSync83(sessionsPath, "utf-8"));
+      const sessionsData = JSON.parse(readFileSync82(sessionsPath, "utf-8"));
       const sessions2 = sessionsData.sessions ?? [];
       const totalSessions = sessions2.length;
       logger?.info("import", "sessions-start", `Starting import of ${totalSessions} sessions`, {
@@ -86516,7 +86506,7 @@ async function migrateJsonToSqlite2(cwd, options) {
   const todoPath = join114(cleoDir, "todo.json");
   if (existsSync117(todoPath)) {
     try {
-      const todoData = JSON.parse(readFileSync83(todoPath, "utf-8"));
+      const todoData = JSON.parse(readFileSync82(todoPath, "utf-8"));
       const tasks2 = topoSortTasks(todoData.tasks ?? []);
       for (const task of tasks2) {
         try {
@@ -86568,7 +86558,7 @@ async function migrateJsonToSqlite2(cwd, options) {
   const archivePath = join114(cleoDir, "todo-archive.json");
   if (existsSync117(archivePath)) {
     try {
-      const archiveData = JSON.parse(readFileSync83(archivePath, "utf-8"));
+      const archiveData = JSON.parse(readFileSync82(archivePath, "utf-8"));
       const archivedTasks = topoSortTasks(archiveData.tasks ?? archiveData.archivedTasks ?? []);
       for (const task of archivedTasks) {
         try {
@@ -86606,7 +86596,7 @@ async function migrateJsonToSqlite2(cwd, options) {
   const sessionsPath = join114(cleoDir, "sessions.json");
   if (existsSync117(sessionsPath)) {
     try {
-      const sessionsData = JSON.parse(readFileSync83(sessionsPath, "utf-8"));
+      const sessionsData = JSON.parse(readFileSync82(sessionsPath, "utf-8"));
       const sessions2 = sessionsData.sessions ?? [];
       for (const session of sessions2) {
         try {
@@ -86787,8 +86777,8 @@ import {
   existsSync as existsSync118,
   mkdirSync as mkdirSync26,
   readdirSync as readdirSync39,
-  readFileSync as readFileSync84,
-  writeFileSync as writeFileSync21
+  readFileSync as readFileSync83,
+  writeFileSync as writeFileSync20
 } from "node:fs";
 import { join as join115 } from "node:path";
 async function runUpgrade(options = {}) {
@@ -86878,8 +86868,8 @@ async function runUpgrade(options = {}) {
           }
           copyFileSync9(dbPath2, dbBackupPath);
           const { createHash: createHash14 } = await import("node:crypto");
-          const origChecksum = createHash14("sha256").update(readFileSync84(dbPath2)).digest("hex");
-          const backupChecksum = createHash14("sha256").update(readFileSync84(dbBackupPath)).digest("hex");
+          const origChecksum = createHash14("sha256").update(readFileSync83(dbPath2)).digest("hex");
+          const backupChecksum = createHash14("sha256").update(readFileSync83(dbBackupPath)).digest("hex");
           if (origChecksum !== backupChecksum) {
             throw new Error(
               `Backup verification failed: checksum mismatch. Aborting migration to prevent data loss.`
@@ -86903,7 +86893,7 @@ async function runUpgrade(options = {}) {
         const configPath = join115(cleoDir2, "config.json");
         let configBackup = null;
         if (existsSync118(configPath)) {
-          configBackup = readFileSync84(configPath, "utf-8");
+          configBackup = readFileSync83(configPath, "utf-8");
         }
         const { resetDbState: resetDbState2 } = await Promise.resolve().then(() => (init_sqlite2(), sqlite_exports));
         resetDbState2();
@@ -86934,7 +86924,7 @@ async function runUpgrade(options = {}) {
           if (totalImported === 0 && existsSync118(dbBackupPath)) {
             copyFileSync9(dbBackupPath, dbPath2);
             if (configBackup) {
-              writeFileSync21(configPath, configBackup);
+              writeFileSync20(configPath, configBackup);
             }
             actions.push({
               action: "storage_migration",
@@ -86947,7 +86937,7 @@ async function runUpgrade(options = {}) {
             let config2 = {};
             if (existsSync118(configPath)) {
               try {
-                config2 = JSON.parse(readFileSync84(configPath, "utf-8"));
+                config2 = JSON.parse(readFileSync83(configPath, "utf-8"));
               } catch {
               }
             }
@@ -86955,7 +86945,7 @@ async function runUpgrade(options = {}) {
               config2.storage = {};
             }
             config2.storage.engine = "sqlite";
-            writeFileSync21(configPath, JSON.stringify(config2, null, 2));
+            writeFileSync20(configPath, JSON.stringify(config2, null, 2));
             actions.push({
               action: "storage_migration",
               status: "applied",
@@ -86977,7 +86967,7 @@ async function runUpgrade(options = {}) {
             copyFileSync9(dbBackupPath, dbPath2);
           }
           if (configBackup) {
-            writeFileSync21(configPath, configBackup);
+            writeFileSync20(configPath, configBackup);
           }
           await updateMigrationPhase2(cleoDir2, "failed");
           for (const error48 of result.errors) {
@@ -87205,7 +87195,7 @@ async function runUpgrade(options = {}) {
         });
       } else {
         try {
-          const context = JSON.parse(readFileSync84(contextPath, "utf-8"));
+          const context = JSON.parse(readFileSync83(contextPath, "utf-8"));
           if (context.detectedAt) {
             const daysSince = (Date.now() - new Date(context.detectedAt).getTime()) / (1e3 * 60 * 60 * 24);
             if (daysSince > 30) {
@@ -88888,10 +88878,10 @@ var init_param_utils = __esm({
 });
 
 // packages/core/src/validation/protocols/_shared.ts
-import { existsSync as existsSync119, readFileSync as readFileSync85 } from "node:fs";
+import { existsSync as existsSync119, readFileSync as readFileSync84 } from "node:fs";
 function findManifestEntry2(taskId, manifestPath) {
   if (!existsSync119(manifestPath)) return null;
-  const content = readFileSync85(manifestPath, "utf-8").trim();
+  const content = readFileSync84(manifestPath, "utf-8").trim();
   if (content.length === 0) return null;
   const lines = content.split("\n");
   for (let i = lines.length - 1; i >= 0; i--) {
@@ -88918,7 +88908,7 @@ function loadManifestEntryFromFile(manifestFile) {
       details: { field: "manifestFile", actual: manifestFile }
     });
   }
-  return JSON.parse(readFileSync85(manifestFile, "utf-8"));
+  return JSON.parse(readFileSync84(manifestFile, "utf-8"));
 }
 function throwIfStrictFailed(result, opts, protocol, taskId) {
   if (!opts.strict || result.valid) return;
@@ -88988,10 +88978,10 @@ var init_artifact_publish = __esm({
 });
 
 // packages/core/src/validation/protocols/consensus.ts
-import { existsSync as existsSync120, readFileSync as readFileSync86 } from "node:fs";
+import { existsSync as existsSync120, readFileSync as readFileSync85 } from "node:fs";
 function loadVotingMatrix(votingMatrixFile) {
   if (!votingMatrixFile || !existsSync120(votingMatrixFile)) return { options: [] };
-  const raw = JSON.parse(readFileSync86(votingMatrixFile, "utf-8"));
+  const raw = JSON.parse(readFileSync85(votingMatrixFile, "utf-8"));
   const options = Array.isArray(raw.options) ? raw.options : Object.values(raw.options ?? {});
   return {
     options: options.filter(
@@ -89156,10 +89146,10 @@ var init_research4 = __esm({
 });
 
 // packages/core/src/validation/protocols/specification.ts
-import { existsSync as existsSync121, readFileSync as readFileSync87 } from "node:fs";
+import { existsSync as existsSync121, readFileSync as readFileSync86 } from "node:fs";
 async function validateSpecificationTask(taskId, opts) {
   const entry = loadManifestEntryByTaskId(taskId);
-  const specContent = opts.specFile && existsSync121(opts.specFile) ? readFileSync87(opts.specFile, "utf-8") : void 0;
+  const specContent = opts.specFile && existsSync121(opts.specFile) ? readFileSync86(opts.specFile, "utf-8") : void 0;
   const result = validateSpecificationProtocol(entry, specContent);
   throwIfStrictFailed(result, opts, "specification", taskId);
   return result;
@@ -89167,7 +89157,7 @@ async function validateSpecificationTask(taskId, opts) {
 async function checkSpecificationManifest(manifestFile, opts) {
   const entry = loadManifestEntryFromFile(manifestFile);
   const taskId = entry.linked_tasks?.[0] ?? "UNKNOWN";
-  const specContent = opts.specFile && existsSync121(opts.specFile) ? readFileSync87(opts.specFile, "utf-8") : void 0;
+  const specContent = opts.specFile && existsSync121(opts.specFile) ? readFileSync86(opts.specFile, "utf-8") : void 0;
   const result = validateSpecificationProtocol(entry, specContent);
   throwIfStrictFailed(result, opts, "specification", taskId);
   return result;
@@ -89227,7 +89217,7 @@ var init_validation3 = __esm({
 // packages/core/src/validation/schema-validator.ts
 import AjvModule from "ajv";
 import addFormatsModule from "ajv-formats";
-import { readFileSync as readFileSync88 } from "fs";
+import { readFileSync as readFileSync87 } from "fs";
 function createAjv() {
   const ajv = new Ajv3({
     allErrors: true,
@@ -89256,7 +89246,7 @@ function getValidator(schemaType) {
     return null;
   }
   try {
-    const schemaContent = readFileSync88(schemaPath, "utf-8");
+    const schemaContent = readFileSync87(schemaPath, "utf-8");
     const schema = JSON.parse(schemaContent);
     const ajv = getAjv2();
     const validate = ajv.compile(schema);
@@ -89310,11 +89300,11 @@ var init_schema_validator = __esm({
 
 // packages/core/src/validation/validate-ops.ts
 import { execFileSync as execFileSync12 } from "node:child_process";
-import { appendFileSync as appendFileSync10, existsSync as existsSync122, mkdirSync as mkdirSync27, readFileSync as readFileSync89 } from "node:fs";
+import { appendFileSync as appendFileSync10, existsSync as existsSync122, mkdirSync as mkdirSync27, readFileSync as readFileSync88 } from "node:fs";
 import { dirname as dirname23, join as join116, resolve as resolve12 } from "node:path";
 function readJsonFile2(filePath) {
   try {
-    const raw = readFileSync89(filePath, "utf-8");
+    const raw = readFileSync88(filePath, "utf-8");
     return JSON.parse(raw);
   } catch {
     return null;
@@ -89479,7 +89469,7 @@ function coreValidateManifest(projectRoot) {
       message: "No manifest file found"
     };
   }
-  const content = readFileSync89(manifestPath, "utf-8");
+  const content = readFileSync88(manifestPath, "utf-8");
   const lines = content.split("\n").filter((l) => l.trim());
   let validCount = 0;
   let invalidCount = 0;
@@ -89523,7 +89513,7 @@ function coreValidateOutput(filePath, taskId, projectRoot) {
   if (!existsSync122(fullPath)) {
     throw new Error(`Output file not found: ${filePath}`);
   }
-  const content = readFileSync89(fullPath, "utf-8");
+  const content = readFileSync88(fullPath, "utf-8");
   const issues = [];
   if (!content.includes("# ")) {
     issues.push({
@@ -89559,7 +89549,7 @@ function parseComplianceEntries(projectRoot) {
   if (!existsSync122(compliancePath)) {
     return [];
   }
-  const content = readFileSync89(compliancePath, "utf-8");
+  const content = readFileSync88(compliancePath, "utf-8");
   const entries = [];
   for (const line2 of content.split("\n")) {
     const trimmed = line2.trim();
@@ -89906,7 +89896,7 @@ var init_validate_ops = __esm({
 });
 
 // packages/core/src/orchestration/bootstrap.ts
-import { existsSync as existsSync123, readFileSync as readFileSync90 } from "node:fs";
+import { existsSync as existsSync123, readFileSync as readFileSync89 } from "node:fs";
 import { join as join117 } from "node:path";
 async function buildBrainState(projectRoot, opts, accessor) {
   const speed = opts?.speed || "fast";
@@ -89975,7 +89965,7 @@ async function buildBrainState(projectRoot, opts, accessor) {
     try {
       const decisionLogPath = join117(projectRoot, ".cleo", "decision-log.jsonl");
       if (existsSync123(decisionLogPath)) {
-        const content = readFileSync90(decisionLogPath, "utf-8").trim();
+        const content = readFileSync89(decisionLogPath, "utf-8").trim();
         if (content) {
           const entries = content.split("\n").filter((l) => l.trim()).map((l) => {
             try {
@@ -89997,7 +89987,7 @@ async function buildBrainState(projectRoot, opts, accessor) {
     try {
       const contextStatePath = join117(projectRoot, ".cleo", ".context-state.json");
       if (existsSync123(contextStatePath)) {
-        const state = JSON.parse(readFileSync90(contextStatePath, "utf-8"));
+        const state = JSON.parse(readFileSync89(contextStatePath, "utf-8"));
         const percentage = state.contextWindow?.percentage ?? 0;
         const factors = [];
         if (percentage > 80) factors.push("high_context_usage");
@@ -97343,13 +97333,13 @@ var init_backup_unpack = __esm({
 
 // packages/core/src/store/regenerators.ts
 import { randomUUID as randomUUID10 } from "node:crypto";
-import { existsSync as existsSync124, readFileSync as readFileSync91 } from "node:fs";
+import { existsSync as existsSync124, readFileSync as readFileSync90 } from "node:fs";
 import { join as join118, resolve as resolve13 } from "node:path";
 function isContributorProject(projectRoot) {
   const at2 = (p2) => existsSync124(join118(projectRoot, p2));
   if (!at2("src/dispatch") || !at2("src/core")) return false;
   try {
-    const pkg = JSON.parse(readFileSync91(join118(projectRoot, "package.json"), "utf-8"));
+    const pkg = JSON.parse(readFileSync90(join118(projectRoot, "package.json"), "utf-8"));
     return pkg.name === "@cleocode/cleo";
   } catch {
     return false;
@@ -98355,7 +98345,7 @@ var init_api_key_kdf = __esm({
 
 // packages/core/src/store/agent-registry-accessor.ts
 import { randomBytes as randomBytes16 } from "node:crypto";
-import { existsSync as existsSync125, mkdirSync as mkdirSync28, readFileSync as readFileSync92, statSync as statSync21, writeFileSync as writeFileSync22 } from "node:fs";
+import { existsSync as existsSync125, mkdirSync as mkdirSync28, readFileSync as readFileSync91, statSync as statSync21, writeFileSync as writeFileSync21 } from "node:fs";
 import { createRequire as createRequire12 } from "node:module";
 import { join as join120 } from "node:path";
 function readMachineKey() {
@@ -98366,7 +98356,7 @@ function readMachineKey() {
       mkdirSync28(cleoHome, { recursive: true });
     }
     const key2 = randomBytes16(MACHINE_KEY_LENGTH);
-    writeFileSync22(keyPath, key2, { mode: 384 });
+    writeFileSync21(keyPath, key2, { mode: 384 });
     return key2;
   }
   if (process.platform !== "win32") {
@@ -98378,7 +98368,7 @@ function readMachineKey() {
       );
     }
   }
-  const key = readFileSync92(keyPath);
+  const key = readFileSync91(keyPath);
   if (key.length !== MACHINE_KEY_LENGTH) {
     throw new Error(
       `Machine key at ${keyPath} has wrong length: expected ${MACHINE_KEY_LENGTH} bytes, got ${key.length}.`
@@ -102620,13 +102610,19 @@ var init_registry5 = __esm({
         tier: 0,
         idempotent: false,
         sessionRequired: true,
-        requiredParams: ["id"],
+        requiredParams: ["taskId", "agentId"],
         params: [
           {
-            name: "id",
+            name: "taskId",
             type: "string",
             required: true,
             description: "Task ID to claim"
+          },
+          {
+            name: "agentId",
+            type: "string",
+            required: true,
+            description: "Agent ID to assign the task to"
           }
         ]
       },
@@ -102638,10 +102634,10 @@ var init_registry5 = __esm({
         tier: 0,
         idempotent: false,
         sessionRequired: true,
-        requiredParams: ["id"],
+        requiredParams: ["taskId"],
         params: [
           {
-            name: "id",
+            name: "taskId",
             type: "string",
             required: true,
             description: "Task ID to unclaim"
@@ -106261,7 +106257,7 @@ var init_pipeline_engine = __esm({
 
 // packages/cleo/src/dispatch/engines/release-engine.ts
 import { execFileSync as execFileSync14 } from "node:child_process";
-import { readFileSync as readFileSync93 } from "node:fs";
+import { readFileSync as readFileSync92 } from "node:fs";
 async function loadTasks2(projectRoot) {
   const root = projectRoot ?? resolveProjectRoot();
   try {
@@ -106512,7 +106508,7 @@ async function releaseShip(params, projectRoot) {
     const changelogPath = `${cwd}/CHANGELOG.md`;
     const cleanVersion = version2.replace(/^v/, "");
     try {
-      const changelogContent = readFileSync93(changelogPath, "utf8");
+      const changelogContent = readFileSync92(changelogPath, "utf8");
       if (!changelogContent.includes(`## [${cleanVersion}]`)) {
         logStep(
           4,
@@ -106766,7 +106762,7 @@ __export(system_engine_exports, {
   systemSync: () => systemSync,
   systemUncancel: () => systemUncancel
 });
-import { existsSync as existsSync126, readdirSync as readdirSync40, readFileSync as readFileSync94 } from "node:fs";
+import { existsSync as existsSync126, readdirSync as readdirSync40, readFileSync as readFileSync93 } from "node:fs";
 import { basename as basename18, join as join121 } from "node:path";
 async function systemDash(projectRoot, params) {
   try {
@@ -107005,7 +107001,7 @@ function systemContext(projectRoot, params) {
     } else {
       const currentSessionPath = join121(cleoDir, ".current-session");
       if (existsSync126(currentSessionPath)) {
-        const currentSession2 = readFileSync94(currentSessionPath, "utf-8").trim();
+        const currentSession2 = readFileSync93(currentSessionPath, "utf-8").trim();
         if (currentSession2) {
           const sessionFile = join121(
             cleoDir,
@@ -107026,7 +107022,7 @@ function systemContext(projectRoot, params) {
       for (const file2 of readdirSync40(statesDir)) {
         if (file2.startsWith("context-state-") && file2.endsWith(".json")) {
           try {
-            const state = JSON.parse(readFileSync94(join121(statesDir, file2), "utf-8"));
+            const state = JSON.parse(readFileSync93(join121(statesDir, file2), "utf-8"));
             sessions2.push({
               file: basename18(file2),
               sessionId: state.sessionId ?? null,
@@ -107042,7 +107038,7 @@ function systemContext(projectRoot, params) {
     const singletonFile = join121(cleoDir, ".context-state.json");
     if (existsSync126(singletonFile)) {
       try {
-        const state = JSON.parse(readFileSync94(singletonFile, "utf-8"));
+        const state = JSON.parse(readFileSync93(singletonFile, "utf-8"));
         sessions2.push({
           file: ".context-state.json",
           sessionId: state.sessionId ?? "global",
@@ -107069,7 +107065,7 @@ function systemContext(projectRoot, params) {
       };
     }
     try {
-      const state = JSON.parse(readFileSync94(stateFile, "utf-8"));
+      const state = JSON.parse(readFileSync93(stateFile, "utf-8"));
       const timestamp2 = state.timestamp;
       const staleMs = state.staleAfterMs ?? 5e3;
       const percentage = state.contextWindow?.percentage ?? 0;
@@ -107224,7 +107220,7 @@ function systemCompliance(projectRoot, params) {
       const compliancePath2 = join121(projectRoot, ".cleo", "metrics", "COMPLIANCE.jsonl");
       let entries2 = [];
       if (existsSync126(compliancePath2)) {
-        const content = readFileSync94(compliancePath2, "utf-8").trim();
+        const content = readFileSync93(compliancePath2, "utf-8").trim();
         if (content) {
           entries2 = content.split("\n").filter((l) => l.trim()).map((l) => JSON.parse(l));
         }
@@ -107291,7 +107287,7 @@ function systemCompliance(projectRoot, params) {
     const compliancePath = join121(projectRoot, ".cleo", "metrics", "COMPLIANCE.jsonl");
     let entries = [];
     if (existsSync126(compliancePath)) {
-      const content = readFileSync94(compliancePath, "utf-8").trim();
+      const content = readFileSync93(compliancePath, "utf-8").trim();
       if (content) {
         entries = content.split("\n").filter((l) => l.trim()).map((l) => JSON.parse(l));
       }
@@ -107437,9 +107433,9 @@ function systemSync(_projectRoot, params) {
     }
   };
 }
-function systemSafestop(projectRoot, params) {
+async function systemSafestop(projectRoot, params) {
   try {
-    const result = safestop(projectRoot, params);
+    const result = await safestop(projectRoot, params);
     return { success: true, data: result };
   } catch (err) {
     return cleoErrorToEngineError(err, "E_GENERAL", "Sync failed");
@@ -108032,13 +108028,16 @@ async function taskDelete(projectRoot, taskId, force) {
     return cleoErrorToEngineError(err, "E_NOT_INITIALIZED", "Task database not initialized");
   }
 }
-async function taskArchive(projectRoot, taskId, before) {
+async function taskArchive(projectRoot, taskId, before, opts) {
   try {
     const accessor = await getAccessor(projectRoot);
+    const taskIds = opts?.taskIds ?? (taskId ? [taskId] : void 0);
     const result = await archiveTasks(
       {
-        taskIds: taskId ? [taskId] : void 0,
-        before
+        taskIds,
+        before,
+        includeCancelled: opts?.includeCancelled,
+        dryRun: opts?.dryRun
       },
       projectRoot,
       accessor
@@ -109624,7 +109623,7 @@ var init_admin2 = __esm({
               );
             }
             case "safestop": {
-              const result = systemSafestop(
+              const result = await systemSafestop(
                 projectRoot,
                 params
               );
@@ -110222,7 +110221,9 @@ var init_check = __esm({
               return wrapResult(result, "query", "check", operation, startTime);
             }
             case "archive.stats": {
-              const result = await systemArchiveStats(projectRoot);
+              const result = await systemArchiveStats(projectRoot, {
+                period: params?.period
+              });
               return wrapResult(result, "query", "check", operation, startTime);
             }
             // T5405: WarpChain validation
@@ -111740,7 +111741,7 @@ var init_nexus2 = __esm({
 async function orchestrateClassify(request, context, projectRoot) {
   try {
     const { getCleoCantWorkflowsDir: getCleoCantWorkflowsDir2 } = await Promise.resolve().then(() => (init_internal(), internal_exports));
-    const { readFileSync: readFileSync103, readdirSync: readdirSync42, existsSync: existsSync131 } = await import("node:fs");
+    const { readFileSync: readFileSync102, readdirSync: readdirSync42, existsSync: existsSync131 } = await import("node:fs");
     const { join: join131 } = await import("node:path");
     const workflowsDir = getCleoCantWorkflowsDir2();
     const combined = `${request} ${context ?? ""}`.toLowerCase();
@@ -111749,7 +111750,7 @@ async function orchestrateClassify(request, context, projectRoot) {
       const files = readdirSync42(workflowsDir).filter((f2) => f2.endsWith(".cant"));
       for (const file2 of files) {
         try {
-          const src = readFileSync103(join131(workflowsDir, file2), "utf-8");
+          const src = readFileSync102(join131(workflowsDir, file2), "utf-8");
           const teamMatch = /^team\s+(\S+):/m.exec(src);
           if (!teamMatch) continue;
           const teamName = teamMatch[1];
@@ -111769,7 +111770,7 @@ async function orchestrateClassify(request, context, projectRoot) {
       const files = readdirSync42(localCantDir).filter((f2) => f2.endsWith(".cant"));
       for (const file2 of files) {
         try {
-          const src = readFileSync103(join131(localCantDir, file2), "utf-8");
+          const src = readFileSync102(join131(localCantDir, file2), "utf-8");
           const teamMatch = /^team\s+(\S+):/m.exec(src);
           if (!teamMatch) continue;
           const teamName = teamMatch[1];
@@ -114270,7 +114271,12 @@ var init_tasks4 = __esm({
               const result = await taskArchive(
                 projectRoot,
                 params?.taskId,
-                params?.before
+                params?.before,
+                {
+                  taskIds: params?.taskIds,
+                  includeCancelled: params?.includeCancelled,
+                  dryRun: params?.dryRun
+                }
               );
               return wrapResult(result, "mutate", "tasks", operation, startTime);
             }
@@ -115657,7 +115663,7 @@ var init_defaults = __esm({
 });
 
 // packages/cleo/src/dispatch/lib/config-loader.ts
-import { existsSync as existsSync127, readFileSync as readFileSync95 } from "fs";
+import { existsSync as existsSync127, readFileSync as readFileSync94 } from "fs";
 import { join as join123 } from "path";
 function loadFromEnv(key) {
   const envKey = `${ENV_PREFIX}${key.toUpperCase()}`;
@@ -115684,7 +115690,7 @@ function loadFromFile(projectRoot) {
     return {};
   }
   try {
-    const content = readFileSync95(configPath, "utf-8");
+    const content = readFileSync94(configPath, "utf-8");
     const config2 = JSON.parse(content);
     const result = {};
     if (config2.lifecycleEnforcement) {
@@ -116309,7 +116315,7 @@ var init_cli = __esm({
 
 // packages/cleo/src/cli/index.ts
 init_internal();
-import { readFileSync as readFileSync102 } from "node:fs";
+import { readFileSync as readFileSync101 } from "node:fs";
 import { dirname as dirname28, join as join130 } from "node:path";
 import { fileURLToPath as fileURLToPath5 } from "node:url";
 
@@ -117393,7 +117399,9 @@ var ADD_PARAMS = [
   }
 ];
 function registerAddCommand(program) {
-  const cmd = program.command("add").description(buildOperationHelp("tasks.add", "Create a new task", ADD_PARAMS));
+  const cmd = program.command("add").description(
+    buildOperationHelp("tasks.add", "Create a new task (requires active session)", ADD_PARAMS)
+  );
   applyParamDefsToCommand(cmd, ADD_PARAMS, "tasks.add");
   cmd.option("--add-phase", "Create new phase if it does not exist").option("--desc <desc>", "Task description (alias for --description)").option("--dry-run", "Show what would be created without making changes").action(async (title, opts) => {
     const params = { title };
@@ -117465,7 +117473,7 @@ function registerAddCommand(program) {
 // packages/cleo/src/cli/commands/add-batch.ts
 init_cli();
 init_renderers();
-import { readFileSync as readFileSync96 } from "node:fs";
+import { readFileSync as readFileSync95 } from "node:fs";
 function registerAddBatchCommand(program) {
   program.command("add-batch").description("Create multiple tasks atomically from a JSON file").option("--file <path>", "Path to JSON file (array of task objects). Use - for stdin.").option("--parent <parentId>", "Default parent for all tasks (overridden by per-task parent)").option("--dry-run", "Preview what would be created without making changes").action(async (opts) => {
     const filePath = opts["file"];
@@ -117479,7 +117487,7 @@ function registerAddBatchCommand(program) {
       }
       raw = Buffer.concat(chunks).toString("utf-8");
     } else {
-      raw = readFileSync96(filePath, "utf-8");
+      raw = readFileSync95(filePath, "utf-8");
     }
     let tasks2;
     try {
@@ -117768,7 +117776,7 @@ function registerAgentCommand(program) {
         transportConfig: {},
         isActive: true
       });
-      const { existsSync: existsSync131, mkdirSync: mkdirSync31, writeFileSync: writeFileSync25 } = await import("node:fs");
+      const { existsSync: existsSync131, mkdirSync: mkdirSync31, writeFileSync: writeFileSync24 } = await import("node:fs");
       const { join: join131 } = await import("node:path");
       const cantDir = join131(".cleo", "agents");
       const cantPath = join131(cantDir, `${agentId}.cant`);
@@ -117824,7 +117832,7 @@ agent ${agentId}:
   enforcement:
     1: TODO \u2014 what does this agent push back on?
 `;
-        writeFileSync25(cantPath, cantContent, "utf-8");
+        writeFileSync24(cantPath, cantContent, "utf-8");
         cantScaffolded = true;
       }
       cliOutput(
@@ -117913,7 +117921,7 @@ agent ${agentId}:
     try {
       const { AgentRegistryAccessor: AgentRegistryAccessor2, getDb: getDb4 } = await Promise.resolve().then(() => (init_internal(), internal_exports));
       const { createRuntime } = await import("@cleocode/runtime");
-      const { existsSync: existsSync131, readFileSync: readFileSync103 } = await import("node:fs");
+      const { existsSync: existsSync131, readFileSync: readFileSync102 } = await import("node:fs");
       const { join: join131 } = await import("node:path");
       await getDb4();
       const registry2 = new AgentRegistryAccessor2(process.cwd());
@@ -117936,7 +117944,7 @@ agent ${agentId}:
       let cantValidation = null;
       const cantPath = opts["cant"] ?? join131(".cleo", "agents", `${agentId}.cant`);
       if (existsSync131(cantPath)) {
-        profile = readFileSync103(cantPath, "utf-8");
+        profile = readFileSync102(cantPath, "utf-8");
         try {
           const cantModule = await import("@cleocode/cant");
           const validate = "validate" in cantModule ? cantModule.validate : null;
@@ -118976,7 +118984,7 @@ Task ${taskId} reassigned to you by ${active.agentId}. Run: cleo show ${taskId}
   });
   agent.command("install <path>").description("Install an agent from a .cantz archive or agent directory").option("--global", "Install to global tier (~/.local/share/cleo/cant/agents/)").action(async (sourcePath, opts) => {
     try {
-      const { existsSync: existsSync131, mkdirSync: mkdirSync31, cpSync, readFileSync: readFileSync103, rmSync: rmSync3, statSync: statSync22 } = await import("node:fs");
+      const { existsSync: existsSync131, mkdirSync: mkdirSync31, cpSync, readFileSync: readFileSync102, rmSync: rmSync3, statSync: statSync22 } = await import("node:fs");
       const { join: join131, basename: basename19, resolve: resolve16 } = await import("node:path");
       const { homedir: homedir7 } = await import("node:os");
       const { tmpdir: tmpdir3 } = await import("node:os");
@@ -119095,7 +119103,7 @@ Task ${taskId} reassigned to you by ${active.agentId}. Run: cleo show ${taskId}
       }
       let registered = false;
       try {
-        const persona = readFileSync103(join131(targetDir, "persona.cant"), "utf-8");
+        const persona = readFileSync102(join131(targetDir, "persona.cant"), "utf-8");
         const descMatch = persona.match(/description:\s*"([^"]+)"/);
         const displayName = descMatch?.[1] ?? agentName;
         const { AgentRegistryAccessor: AgentRegistryAccessor2, getDb: getDb4 } = await Promise.resolve().then(() => (init_internal(), internal_exports));
@@ -119236,7 +119244,7 @@ Task ${taskId} reassigned to you by ${active.agentId}. Run: cleo show ${taskId}
   });
   agent.command("create").description("Scaffold a new agent package with persona.cant and manifest.json").requiredOption("--name <name>", "Agent name (kebab-case)").requiredOption("--role <role>", "Agent role: orchestrator, lead, worker, or docs-worker").option("--tier <tier>", "Agent tier: low, mid, or high (defaults based on role)").option("--team <teamName>", "Team this agent belongs to").option("--domain <description>", "Domain description for file permissions and context").option("--global", "Create in global tier (~/.local/share/cleo/cant/agents/)").option("--seed-brain", "Create expertise/mental-model-seed.md and seed a BRAIN observation").option("--parent <parentAgent>", "Parent agent name in the hierarchy").action(async (opts) => {
     try {
-      const { existsSync: existsSync131, mkdirSync: mkdirSync31, writeFileSync: writeFileSync25 } = await import("node:fs");
+      const { existsSync: existsSync131, mkdirSync: mkdirSync31, writeFileSync: writeFileSync24 } = await import("node:fs");
       const { join: join131 } = await import("node:path");
       const { homedir: homedir7 } = await import("node:os");
       const name2 = opts["name"];
@@ -119327,9 +119335,9 @@ Task ${taskId} reassigned to you by ${active.agentId}. Run: cleo show ${taskId}
         domain: domain2,
         parent
       });
-      writeFileSync25(join131(agentDir, "persona.cant"), personaContent, "utf-8");
+      writeFileSync24(join131(agentDir, "persona.cant"), personaContent, "utf-8");
       const manifest = generateManifest2({ name: name2, role, tier, domain: domain2 });
-      writeFileSync25(
+      writeFileSync24(
         join131(agentDir, "manifest.json"),
         `${JSON.stringify(manifest, null, 2)}
 `,
@@ -119341,14 +119349,14 @@ Task ${taskId} reassigned to you by ${active.agentId}. Run: cleo show ${taskId}
       ];
       if (team) {
         const teamConfigContent = generateTeamConfig(name2, role, team);
-        writeFileSync25(join131(agentDir, "team-config.cant"), teamConfigContent, "utf-8");
+        writeFileSync24(join131(agentDir, "team-config.cant"), teamConfigContent, "utf-8");
         createdFiles.push(join131(agentDir, "team-config.cant"));
       }
       if (seedBrain) {
         const expertiseDir = join131(agentDir, "expertise");
         mkdirSync31(expertiseDir, { recursive: true });
         const seedContent = generateMentalModelSeed(name2, role, domain2);
-        writeFileSync25(join131(expertiseDir, "mental-model-seed.md"), seedContent, "utf-8");
+        writeFileSync24(join131(expertiseDir, "mental-model-seed.md"), seedContent, "utf-8");
         createdFiles.push(join131(expertiseDir, "mental-model-seed.md"));
         try {
           const { execFile: execFile9 } = await import("node:child_process");
@@ -119756,10 +119764,6 @@ function capitalizeFirst(str) {
   return str.charAt(0).toUpperCase() + str.slice(1);
 }
 
-// packages/cleo/src/cli/commands/agents.ts
-function registerAgentsCommand(_program) {
-}
-
 // packages/cleo/src/cli/commands/analyze.ts
 init_cli();
 function registerAnalyzeCommand(program) {
@@ -119861,6 +119865,12 @@ function registerBackfillCommand(program) {
       const dryRun = !!opts.dryRun;
       const rollback = !!opts.rollback;
       const taskIds = opts.tasks?.trim() ? opts.tasks.split(",").map((s3) => s3.trim()).filter(Boolean) : void 0;
+      if (!dryRun && !rollback && !process.env["CLEO_NONINTERACTIVE"]) {
+        console.log(
+          "\u26A0 Backfill will modify tasks in-place. Run with --dry-run first to preview changes."
+        );
+        console.log("  Set CLEO_NONINTERACTIVE=1 or pass --dry-run to suppress this warning.\n");
+      }
       if (dryRun) {
         console.log("[dry run] No changes will be made.\n");
       }
@@ -120209,7 +120219,9 @@ async function promptPassphrase() {
 }
 function registerBackupCommand(program) {
   const backup = program.command("backup").description("Add backup of todo files or list available backups");
-  backup.command("add").alias("create").description("Add a new backup of all CLEO data files").option("--destination <dir>", "Backup destination directory").option("--global", "Also snapshot global-tier databases (nexus.db)").action(async (opts) => {
+  backup.command("add").alias("create").description(
+    "Add a new backup of all CLEO data files (backup create is an alias for backup add)"
+  ).option("--destination <dir>", "Backup destination directory").option("--global", "Also snapshot global-tier databases (nexus.db)").action(async (opts) => {
     await dispatchFromCli(
       "mutate",
       "admin",
@@ -120612,7 +120624,7 @@ function registerBrainCommand(program) {
 init_cli();
 function registerBriefingCommand(program) {
   program.command("briefing").description(
-    "Show composite session-start context (handoff, focus, next tasks, bugs, blockers, epics)"
+    "Session resume context: last handoff, current task, next tasks, bugs, blockers, epics, and memory. Use at session start to restore context."
   ).option("-s, --scope <scope>", "Scope filter (global or epic:T###)").option("--max-next <n>", "Maximum next tasks to show", "5").option("--max-bugs <n>", "Maximum bugs to show", "10").option("--max-blocked <n>", "Maximum blocked tasks to show", "10").option("--max-epics <n>", "Maximum active epics to show", "5").action(async (opts) => {
     const scope = opts["scope"];
     const maxNextTasks = parseInt(opts["maxNext"], 10);
@@ -120646,7 +120658,7 @@ var SEVERITY_MAP = {
 };
 var VALID_SEVERITIES = Object.keys(SEVERITY_MAP);
 function registerBugCommand(program) {
-  program.command("bug <title>").description("Create a bug report task with severity mapping").option("-s, --severity <level>", "Severity level (P0, P1, P2, P3) - required", "P2").option("-e, --epic <id>", "Epic ID to link as parent (optional)").option("-d, --description <desc>", "Bug description").option("--dry-run", "Show what would be created without making changes").action(async (title, opts) => {
+  program.command("bug <title>").description("Create a bug report task with severity mapping (requires active session)").option("-s, --severity <level>", "Severity level (P0, P1, P2, P3) - required", "P2").option("-e, --epic <id>", "Epic ID to link as parent (optional)").option("-d, --description <desc>", "Bug description").option("--dry-run", "Show what would be created without making changes").action(async (title, opts) => {
     const severity = opts["severity"] || "P2";
     if (!VALID_SEVERITIES.includes(severity)) {
       console.error(
@@ -120711,7 +120723,7 @@ function registerCancelCommand(program) {
 
 // packages/cleo/src/cli/commands/cant.ts
 init_renderers();
-import { existsSync as existsSync128, mkdirSync as mkdirSync29, readFileSync as readFileSync97, writeFileSync as writeFileSync23 } from "node:fs";
+import { existsSync as existsSync128, mkdirSync as mkdirSync29, readFileSync as readFileSync96, writeFileSync as writeFileSync22 } from "node:fs";
 import { dirname as dirname25, isAbsolute as isAbsolute3, join as join124, resolve as resolve15 } from "node:path";
 function registerCantCommand(program) {
   const cant = program.command("cant").description("CANT DSL tooling");
@@ -120789,7 +120801,7 @@ function registerCantCommand(program) {
       }
       try {
         const mod = await loadMigrateEngine();
-        const content = readFileSync97(filePath, "utf-8");
+        const content = readFileSync96(filePath, "utf-8");
         const result = mod.migrateMarkdown(content, filePath, {
           write: isWrite,
           verbose: isVerbose,
@@ -120805,7 +120817,7 @@ function registerCantCommand(program) {
           for (const outputFile of result.outputFiles) {
             const outputPath = isAbsolute3(outputFile.path) ? outputFile.path : join124(projectRoot, outputFile.path);
             mkdirSync29(dirname25(outputPath), { recursive: true });
-            writeFileSync23(outputPath, outputFile.content, "utf-8");
+            writeFileSync22(outputPath, outputFile.content, "utf-8");
             written++;
             if (isVerbose) {
               console.log(`  Created: ${outputFile.path} (${outputFile.kind})`);
@@ -120882,7 +120894,7 @@ async function loadMigrateEngine() {
 
 // packages/cleo/src/cli/commands/chain.ts
 init_cli();
-import { readFileSync as readFileSync98 } from "node:fs";
+import { readFileSync as readFileSync97 } from "node:fs";
 function registerChainCommand(program) {
   const chain = program.command("chain").description("WarpChain pipeline management (tier-2 orchestrator)");
   chain.command("show <chainId>").description("Show details for a WarpChain definition").action(async (chainId) => {
@@ -120892,7 +120904,7 @@ function registerChainCommand(program) {
     await dispatchFromCli("query", "pipeline", "chain.list", {}, { command: "chain" });
   });
   chain.command("add <file>").description("Add a new WarpChain definition from a JSON file").action(async (file2) => {
-    const chainJson = JSON.parse(readFileSync98(file2, "utf-8"));
+    const chainJson = JSON.parse(readFileSync97(file2, "utf-8"));
     await dispatchFromCli(
       "mutate",
       "pipeline",
@@ -120961,10 +120973,10 @@ function registerCheckCommand(program) {
     );
   });
   check2.command("chain-validate <file>").description("Validate a WarpChain definition from a JSON file").action(async (file2) => {
-    const { readFileSync: readFileSync103 } = await import("node:fs");
+    const { readFileSync: readFileSync102 } = await import("node:fs");
     let chain;
     try {
-      chain = JSON.parse(readFileSync103(file2, "utf8"));
+      chain = JSON.parse(readFileSync102(file2, "utf8"));
     } catch (err) {
       const message = err instanceof Error ? err.message : String(err);
       console.error(`Failed to read or parse chain file: ${message}`);
@@ -121132,13 +121144,13 @@ function registerCheckpointCommand(program) {
 // packages/cleo/src/cli/commands/claim.ts
 init_cli();
 function registerClaimCommand(program) {
-  program.command("claim <taskId>").description("Claim a task by assigning it to an agent").option("--agent <agentId>", "Agent ID to assign the task to (required)").action(async (taskId, opts) => {
+  program.command("claim <taskId>").description("Claim a task by assigning it to an agent").requiredOption("--agent <agentId>", "Agent ID to assign the task to").action(async (taskId, opts) => {
     await dispatchFromCli(
       "mutate",
       "tasks",
       "claim",
       {
-        id: taskId,
+        taskId,
         agentId: opts["agent"]
       },
       { command: "claim", operation: "tasks.claim" }
@@ -121151,7 +121163,7 @@ function registerUnclaimCommand(program) {
       "mutate",
       "tasks",
       "unclaim",
-      { id: taskId },
+      { taskId },
       { command: "unclaim", operation: "tasks.unclaim" }
     );
   });
@@ -121160,7 +121172,9 @@ function registerUnclaimCommand(program) {
 // packages/cleo/src/cli/commands/commands.ts
 init_cli();
 function registerCommandsCommand(program) {
-  program.command("commands [command]").description("List and query available CLEO commands (delegates to admin help)").option("-c, --category <category>", "Filter by category").option("-r, --relevance <level>", "Filter by agent relevance").option("--tier <n>", "Help tier level (0=basic, 1=extended, 2=full)", parseInt).action(async (commandName, opts) => {
+  program.command("commands [command]").description(
+    "DEPRECATED: Use `cleo ops` instead. List and query available CLEO commands (delegates to admin help)"
+  ).option("-c, --category <category>", "Filter by category").option("-r, --relevance <level>", "Filter by agent relevance").option("--tier <n>", "Help tier level (0=basic, 1=extended, 2=full)", parseInt).action(async (commandName, opts) => {
     console.error(
       "[DEPRECATED] cleo commands now delegates to admin.help.\nUse: cleo help (CLI)\n"
     );
@@ -121220,7 +121234,13 @@ var COMPLETE_PARAMS = [
   }
 ];
 function registerCompleteCommand(program) {
-  const cmd = program.command("complete").alias("done").description(buildOperationHelp("tasks.complete", "Mark a task as completed", COMPLETE_PARAMS));
+  const cmd = program.command("complete").alias("done").description(
+    buildOperationHelp(
+      "tasks.complete",
+      "Mark a task as completed (requires active session)",
+      COMPLETE_PARAMS
+    )
+  );
   applyParamDefsToCommand(cmd, COMPLETE_PARAMS, "tasks.complete");
   cmd.action(async (taskId, opts) => {
     const response = await dispatchRaw("mutate", "tasks", "complete", {
@@ -121431,7 +121451,9 @@ function registerConfigCommand(program) {
 // packages/cleo/src/cli/commands/consensus.ts
 init_cli();
 function registerConsensusCommand(program) {
-  const consensus = program.command("consensus").description("Validate consensus protocol compliance for multi-agent decision tasks");
+  const consensus = program.command("consensus").description(
+    "Validate consensus protocol compliance (alias for `cleo check protocol consensus`)"
+  );
   consensus.command("validate <taskId>").description("Validate consensus protocol compliance for task").option("--strict", "Exit with error code on violations").option("--voting-matrix <file>", "Path to voting matrix JSON file").action(async (taskId, opts) => {
     await dispatchFromCli(
       "query",
@@ -121480,7 +121502,7 @@ function registerContextCommand(program) {
       { command: "context" }
     );
   });
-  context.command("check").description("Check threshold, return exit code for scripting").option("--session <id>", "Check specific CLEO session").action(async (opts) => {
+  context.command("check").description("Show context window state (same as status)").option("--session <id>", "Check specific CLEO session").action(async (opts) => {
     await dispatchFromCli(
       "query",
       "admin",
@@ -121492,7 +121514,7 @@ function registerContextCommand(program) {
       { command: "context" }
     );
   });
-  context.command("list").description("List all context state files (multi-session)").action(async () => {
+  context.command("list").description("Show context window state including all sessions").action(async () => {
     await dispatchFromCli(
       "query",
       "admin",
@@ -121508,7 +121530,9 @@ function registerContextCommand(program) {
 // packages/cleo/src/cli/commands/contribution.ts
 init_cli();
 function registerContributionCommand(program) {
-  const contribution = program.command("contribution").description("Validate contribution protocol compliance for shared codebase work");
+  const contribution = program.command("contribution").description(
+    "Validate contribution protocol compliance (alias for `cleo check protocol contribution`)"
+  );
   contribution.command("validate <taskId>").description("Validate contribution protocol compliance for task").option("--strict", "Exit with error code on violations").action(async (taskId, opts) => {
     await dispatchFromCli(
       "query",
@@ -121542,7 +121566,9 @@ function registerContributionCommand(program) {
 // packages/cleo/src/cli/commands/current.ts
 init_cli();
 function registerCurrentCommand(program) {
-  program.command("current").description("Show the current task being worked on").action(async () => {
+  program.command("current").description(
+    "Show the current task being worked on. Returns: {currentTask: string|null, currentPhase: string|null}"
+  ).action(async () => {
     await dispatchFromCli("query", "tasks", "current", {}, { command: "current" });
   });
 }
@@ -121550,15 +121576,25 @@ function registerCurrentCommand(program) {
 // packages/cleo/src/cli/commands/dash.ts
 init_cli();
 function registerDashCommand(program) {
-  program.command("dash").description("Project dashboard with status summary, phase progress, recent activity").option("-c, --compact", "Condensed single-line view").option("--period <days>", "Stats period in days", "7").option("--no-chart", "Disable ASCII charts/progress bars").option("--sections <list>", "Comma-separated list of sections to show").option("-v, --verbose", "Show full task details").action(async () => {
-    await dispatchFromCli("query", "admin", "dash", {}, { command: "dash" });
+  program.command("dash").description(
+    "Project health dashboard: status summary, phase progress, recent activity, high priority tasks. Use for overall project status."
+  ).option("--blocked-limit <n>", "Max blocked tasks to show", parseInt).action(async (opts) => {
+    await dispatchFromCli(
+      "query",
+      "admin",
+      "dash",
+      { blockedTasksLimit: opts["blockedLimit"] },
+      { command: "dash" }
+    );
   });
 }
 
 // packages/cleo/src/cli/commands/decomposition.ts
 init_cli();
 function registerDecompositionCommand(program) {
-  const decomposition = program.command("decomposition").description("Validate decomposition protocol compliance for epic breakdown tasks");
+  const decomposition = program.command("decomposition").description(
+    "Validate decomposition protocol compliance (alias for `cleo check protocol decomposition`)"
+  );
   decomposition.command("validate <taskId>").description("Validate decomposition protocol compliance for task").option("--strict", "Exit with error code on violations").option("--epic <id>", "Specify parent epic ID").action(async (taskId, opts) => {
     await dispatchFromCli(
       "query",
@@ -121722,7 +121758,7 @@ function registerDetectCommand(program) {
 // packages/cleo/src/cli/commands/detect-drift.ts
 init_src();
 init_renderers();
-import { existsSync as existsSync129, readdirSync as readdirSync41, readFileSync as readFileSync99 } from "node:fs";
+import { existsSync as existsSync129, readdirSync as readdirSync41, readFileSync as readFileSync98 } from "node:fs";
 import { dirname as dirname26, join as join125 } from "node:path";
 function findProjectRoot() {
   let currentDir = process.cwd();
@@ -121739,10 +121775,11 @@ function findProjectRoot() {
 function registerDetectDriftCommand(program) {
   program.command("detect-drift").description("Detect documentation drift against TypeScript source of truth").action(async () => {
     const projectRoot = findProjectRoot();
-    const isCleoRepo = existsSync129(join125(projectRoot, "src", "cli", "commands")) || existsSync129(join125(projectRoot, "packages", "cleo", "src"));
+    const isCleoRepo = existsSync129(join125(projectRoot, "packages", "cleo", "src"));
+    const cleoSrcRoot = isCleoRepo ? join125(projectRoot, "packages", "cleo", "src") : join125(projectRoot, "src");
     const safeRead = (filePath) => {
       try {
-        return readFileSync99(filePath, "utf-8");
+        return readFileSync98(filePath, "utf-8");
       } catch {
         return "";
       }
@@ -121805,17 +121842,17 @@ function registerDetectDriftCommand(program) {
       }
     };
     try {
-      const specPath = join125(projectRoot, "docs", "specs", "CLEO-OPERATIONS-REFERENCE.md");
-      const registryPath = join125(projectRoot, "src", "dispatch", "registry.ts");
-      const dispatchDomainsDir = join125(projectRoot, "src", "dispatch", "domains");
+      const specPath = join125(projectRoot, "docs", "specs", "CLEO-OPERATION-CONSTITUTION.md");
+      const registryPath = join125(cleoSrcRoot, "dispatch", "registry.ts");
+      const dispatchDomainsDir = join125(cleoSrcRoot, "dispatch", "domains");
       if (!existsSync129(specPath)) {
-        addCheck("Gateway-to-spec sync", "fail", "CLEO-OPERATIONS-REFERENCE.md missing", [
+        addCheck("Gateway-to-spec sync", "fail", "CLEO-OPERATION-CONSTITUTION.md missing", [
           {
             severity: "error",
             category: "spec",
             message: "Operations reference specification not found",
             file: specPath,
-            recommendation: "Create docs/specs/CLEO-OPERATIONS-REFERENCE.md with canonical operation definitions"
+            recommendation: "Create docs/specs/CLEO-OPERATION-CONSTITUTION.md with canonical operation definitions"
           }
         ]);
       } else if (!existsSync129(registryPath) || !existsSync129(dispatchDomainsDir)) {
@@ -121825,7 +121862,7 @@ function registerDetectDriftCommand(program) {
             category: "implementation",
             message: "Dispatch registry or domains directory not found",
             file: registryPath,
-            recommendation: "Verify src/dispatch/registry.ts and src/dispatch/domains/ exist"
+            recommendation: "Verify packages/cleo/src/dispatch/registry.ts and packages/cleo/src/dispatch/domains/ exist"
           }
         ]);
       } else {
@@ -121882,14 +121919,14 @@ function registerDetectDriftCommand(program) {
       ]);
     }
     try {
-      const cliDir = join125(projectRoot, "src", "cli", "commands");
-      const coreDir = join125(projectRoot, "src", "core");
+      const cliDir = join125(cleoSrcRoot, "cli", "commands");
+      const coreDir = isCleoRepo ? join125(projectRoot, "packages", "core", "src") : join125(projectRoot, "src", "core");
       if (!existsSync129(cliDir)) {
         addCheck("CLI-to-core sync", "fail", "CLI commands directory missing", [
           {
             severity: "error",
             category: "structure",
-            message: "src/cli/commands/ directory not found",
+            message: `${cliDir} directory not found`,
             recommendation: "Verify TypeScript source structure is intact"
           }
         ]);
@@ -121898,7 +121935,7 @@ function registerDetectDriftCommand(program) {
           {
             severity: "error",
             category: "structure",
-            message: "src/core/ directory not found",
+            message: `${coreDir} directory not found`,
             recommendation: "Verify TypeScript source structure is intact"
           }
         ]);
@@ -121912,13 +121949,13 @@ function registerDetectDriftCommand(program) {
       addCheck("CLI-to-core sync", "fail", `Error: ${getErrorMessage(e)}`);
     }
     try {
-      const domainsDir = join125(projectRoot, "src", "dispatch", "domains");
+      const domainsDir = join125(cleoSrcRoot, "dispatch", "domains");
       if (!existsSync129(domainsDir)) {
         addCheck("Domain handler coverage", "fail", "Dispatch domains directory missing", [
           {
             severity: "error",
             category: "structure",
-            message: "src/dispatch/domains/ not found",
+            message: `${domainsDir} not found`,
             recommendation: "Verify dispatch domain handlers are in place"
           }
         ]);
@@ -121930,13 +121967,13 @@ function registerDetectDriftCommand(program) {
       addCheck("Domain handler coverage", "fail", `Error: ${getErrorMessage(e)}`);
     }
     try {
-      const matrixPath = join125(projectRoot, "src", "dispatch", "lib", "capability-matrix.ts");
+      const matrixPath = join125(cleoSrcRoot, "dispatch", "lib", "capability-matrix.ts");
       if (!existsSync129(matrixPath)) {
         addCheck("Capability matrix", "fail", "Capability matrix missing", [
           {
             severity: "error",
             category: "configuration",
-            message: "src/dispatch/lib/capability-matrix.ts not found",
+            message: `${matrixPath} not found`,
             recommendation: "Create capability matrix to document supported operations"
           }
         ]);
@@ -122068,14 +122105,14 @@ function registerDetectDriftCommand(program) {
       addCheck("Agent injection", "fail", `Error: ${getErrorMessage(e)}`);
     }
     try {
-      const exitCodesPath = join125(projectRoot, "src", "types", "exit-codes.ts");
+      const exitCodesPath = join125(cleoSrcRoot, "dispatch", "lib", "exit-codes.ts");
       if (!existsSync129(exitCodesPath)) {
         addCheck("Exit codes", "fail", "Exit codes definition missing", [
           {
             severity: "error",
             category: "protocol",
-            message: "src/types/exit-codes.ts not found",
-            recommendation: "Create exit codes enum for CLI protocol compliance"
+            message: `${exitCodesPath} not found`,
+            recommendation: "Create exit codes definition for CLI protocol compliance"
           }
         ]);
       } else {
@@ -122088,7 +122125,6 @@ function registerDetectDriftCommand(program) {
     }
     if (result.summary.errors > 0) {
       result.recommendations.push("Address all ERROR-level issues before proceeding");
-      result.recommendations.push("Run cleo detect-drift --json for structured output");
     }
     if (result.summary.warnings > 0) {
       result.recommendations.push("Review WARNING-level issues for documentation improvements");
@@ -122547,7 +122583,7 @@ function registerExportTasksCommand(program) {
   program.command("export-tasks [taskIds...]").description("Export tasks to portable .cleo-export.json package for cross-project transfer").option("-o, --output <file>", "Output file path (stdout if omitted)").option("--subtree", "Include all descendants of specified task(s)").option("--filter <filters...>", "Filter tasks by criteria (key=value, repeatable)").option("--include-deps", "Auto-include task dependencies").option("--dry-run", "Preview selection without creating export file").action(async (taskIds, opts) => {
     const hasOutput = !!opts["output"];
     const params = {
-      taskIds: taskIds.length > 0 ? taskIds : void 0,
+      taskIds: taskIds && taskIds.length > 0 ? taskIds : void 0,
       output: opts["output"],
       subtree: opts["subtree"],
       filter: opts["filter"],
@@ -122587,7 +122623,7 @@ var FIND_PARAMS = [
     name: "query",
     type: "string",
     required: false,
-    description: "Fuzzy search query (title/description)",
+    description: "Search text (required unless --id is provided)",
     cli: { positional: true }
   },
   {
@@ -122616,7 +122652,7 @@ var FIND_PARAMS = [
     name: "field",
     type: "string",
     required: false,
-    description: "Field to search in (title, description, etc.)",
+    description: "Field to search in (title|description|notes|id)",
     cli: { flag: "in" }
   },
   {
@@ -122701,12 +122737,12 @@ init_src();
 init_src2();
 init_renderers();
 import { execFileSync as execFileSync16 } from "node:child_process";
-import { existsSync as existsSync130, mkdirSync as mkdirSync30, readFileSync as readFileSync100, writeFileSync as writeFileSync24 } from "node:fs";
+import { existsSync as existsSync130, mkdirSync as mkdirSync30, readFileSync as readFileSync99, writeFileSync as writeFileSync23 } from "node:fs";
 import { dirname as dirname27, join as join127 } from "node:path";
 function getChangelogSource(cwd) {
   const configPath = getConfigPath(cwd);
   try {
-    const config2 = JSON.parse(readFileSync100(configPath, "utf-8"));
+    const config2 = JSON.parse(readFileSync99(configPath, "utf-8"));
     return config2?.release?.changelog?.source ?? "CHANGELOG.md";
   } catch {
     return "CHANGELOG.md";
@@ -122715,7 +122751,7 @@ function getChangelogSource(cwd) {
 function getEnabledPlatforms(cwd) {
   const configPath = getConfigPath(cwd);
   try {
-    const config2 = JSON.parse(readFileSync100(configPath, "utf-8"));
+    const config2 = JSON.parse(readFileSync99(configPath, "utf-8"));
     const outputs = config2?.release?.changelog?.outputs ?? [];
     return outputs.filter((o) => o.enabled);
   } catch {
@@ -122844,7 +122880,7 @@ function registerGenerateChangelogCommand(program) {
       if (!existsSync130(sourcePath)) {
         throw new CleoError(4 /* NOT_FOUND */, `Changelog source not found: ${sourcePath}`);
       }
-      const sourceContent = readFileSync100(sourcePath, "utf-8");
+      const sourceContent = readFileSync99(sourcePath, "utf-8");
       const repoSlug = getGitHubRepoSlug();
       const results = [];
       if (targetPlatform) {
@@ -122855,7 +122891,7 @@ function registerGenerateChangelogCommand(program) {
         if (!dryRun) {
           const fullPath = join127(getProjectRoot(), outputPath);
           mkdirSync30(dirname27(fullPath), { recursive: true });
-          writeFileSync24(fullPath, content, "utf-8");
+          writeFileSync23(fullPath, content, "utf-8");
         }
         results.push({ platform: targetPlatform, path: outputPath, written: !dryRun });
       } else {
@@ -122876,7 +122912,7 @@ function registerGenerateChangelogCommand(program) {
           if (!dryRun) {
             const fullPath = join127(getProjectRoot(), platformConfig.path);
             mkdirSync30(dirname27(fullPath), { recursive: true });
-            writeFileSync24(fullPath, content, "utf-8");
+            writeFileSync23(fullPath, content, "utf-8");
           }
           results.push({
             platform: platformConfig.platform,
@@ -122940,7 +122976,9 @@ function registerHistoryCommand(program) {
 // packages/cleo/src/cli/commands/implementation.ts
 init_cli();
 function registerImplementationCommand(program) {
-  const implementation = program.command("implementation").description("Validate implementation protocol compliance for code tasks");
+  const implementation = program.command("implementation").description(
+    "Validate implementation protocol compliance (alias for `cleo check protocol implementation`)"
+  );
   implementation.command("validate <taskId>").description("Validate implementation protocol compliance for task").option("--strict", "Exit with error code on violations").action(async (taskId, opts) => {
     await dispatchFromCli(
       "query",
@@ -123143,7 +123181,7 @@ function registerLabelsCommand(program) {
     await dispatchFromCli("query", "tasks", "label.list", {}, { command: "labels" });
   });
   labels.command("show <label>").description("Show tasks with specific label").action(async (label) => {
-    await dispatchFromCli("query", "tasks", "label.list", { label }, { command: "labels" });
+    await dispatchFromCli("query", "tasks", "list", { label }, { command: "labels" });
   });
   labels.command("stats").description("Show detailed label statistics").action(async () => {
     await dispatchFromCli("query", "tasks", "label.list", {}, { command: "labels" });
@@ -123166,7 +123204,9 @@ function registerLifecycleCommand(program) {
       { command: "lifecycle" }
     );
   });
-  lifecycle.command("start <epicId> <stage>").description("Start a lifecycle stage").action(async (epicId, stage) => {
+  lifecycle.command("start <epicId> <stage>").description(
+    "Start a lifecycle stage. Valid stages: research|consensus|architecture_decision|specification|decomposition|implementation|validation|testing|release|contribution"
+  ).action(async (epicId, stage) => {
     await dispatchFromCli(
       "mutate",
       "pipeline",
@@ -123179,7 +123219,9 @@ function registerLifecycleCommand(program) {
       { command: "lifecycle" }
     );
   });
-  lifecycle.command("complete <epicId> <stage>").description("Complete a lifecycle stage").option("--artifacts <artifacts>", "Comma-separated artifact paths").option("--notes <notes>", "Completion notes").action(async (epicId, stage, opts) => {
+  lifecycle.command("complete <epicId> <stage>").description(
+    "Complete a lifecycle stage. Valid stages: research|consensus|architecture_decision|specification|decomposition|implementation|validation|testing|release|contribution"
+  ).option("--artifacts <artifacts>", "Comma-separated artifact paths").option("--notes <notes>", "Completion notes").action(async (epicId, stage, opts) => {
     await dispatchFromCli(
       "mutate",
       "pipeline",
@@ -123193,7 +123235,9 @@ function registerLifecycleCommand(program) {
       { command: "lifecycle" }
     );
   });
-  lifecycle.command("skip <epicId> <stage>").description("Skip a lifecycle stage").requiredOption("--reason <reason>", "Reason for skipping").action(async (epicId, stage, opts) => {
+  lifecycle.command("skip <epicId> <stage>").description(
+    "Skip a lifecycle stage. Valid stages: research|consensus|architecture_decision|specification|decomposition|implementation|validation|testing|release|contribution"
+  ).requiredOption("--reason <reason>", "Reason for skipping").action(async (epicId, stage, opts) => {
     await dispatchFromCli(
       "mutate",
       "pipeline",
@@ -123246,7 +123290,9 @@ function registerLifecycleCommand(program) {
       { command: "lifecycle" }
     );
   });
-  lifecycle.command("reset <epicId> <stage>").description("Reset a lifecycle stage back to pending").requiredOption("--reason <reason>", "Reason for resetting the stage").action(async (epicId, stage, opts) => {
+  lifecycle.command("reset <epicId> <stage>").description(
+    "Reset a lifecycle stage back to pending. Valid stages: research|consensus|architecture_decision|specification|decomposition|implementation|validation|testing|release|contribution"
+  ).requiredOption("--reason <reason>", "Reason for resetting the stage").action(async (epicId, stage, opts) => {
     await dispatchFromCli(
       "mutate",
       "pipeline",
@@ -124276,7 +124322,9 @@ function registerOrchestrateCommand(program) {
 init_internal();
 init_renderers();
 function registerOtelCommand(program) {
-  const otel = program.command("otel").description("Token metrics tracking - view status, summary, and manage tracking data");
+  const otel = program.command("otel").description(
+    "Lightweight token metrics from .cleo/metrics/TOKEN_USAGE.jsonl (session-level, spawn-level events)"
+  );
   otel.command("status").description("Show token tracking status and recent activity").action(async () => {
     try {
       const result = await getOtelStatus();
@@ -124441,11 +124489,15 @@ function registerPhaseCommand(program) {
 // packages/cleo/src/cli/commands/phases.ts
 init_cli();
 function registerPhasesCommand(program) {
-  const phases = program.command("phases").description("List phases with progress bars and statistics");
+  const phases = program.command("phases").description(
+    "DEPRECATED: Use `cleo phase` instead. List phases with progress bars and statistics"
+  );
   phases.command("list", { isDefault: true }).description("List all phases with progress (default)").action(async () => {
+    console.error("[DEPRECATED] cleo phases is deprecated. Use: cleo phase list");
     await dispatchFromCli("query", "pipeline", "phase.list", {}, { command: "phases" });
   });
   phases.command("show <phase>").description("Show phase details and task counts").action(async (phase) => {
+    console.error("[DEPRECATED] cleo phases is deprecated. Use: cleo phase show");
     await dispatchFromCli(
       "query",
       "pipeline",
@@ -124455,6 +124507,7 @@ function registerPhasesCommand(program) {
     );
   });
   phases.command("stats").description("Show detailed phase statistics").action(async () => {
+    console.error("[DEPRECATED] cleo phases is deprecated. Use: cleo phase list");
     await dispatchFromCli("query", "pipeline", "phase.list", {}, { command: "phases" });
   });
 }
@@ -124463,7 +124516,7 @@ function registerPhasesCommand(program) {
 init_cli();
 function registerPlanCommand(program) {
   program.command("plan").description(
-    "Composite planning view: in-progress epics, ready tasks, blocked tasks, open bugs"
+    "Task prioritization view: in-progress epics, ready tasks, blocked tasks, open bugs with scoring. Use when deciding what to work on next."
   ).action(async () => {
     await dispatchFromCli(
       "query",
@@ -124672,7 +124725,9 @@ function registerRelatesCommand(program) {
     handleRawError(response, { command: "relates", operation: "relates" });
     cliOutput(response.data ?? {}, { command: "relates" });
   });
-  relates.command("add <from> <to> <type> <reason>").description("Add a relates entry to a task").action(async (from, to2, type, reason) => {
+  relates.command("add <from> <to> <type> <reason>").description(
+    "Add a relates entry to a task. Valid types: blocks|related|duplicates|absorbs|fixes|extends|supersedes"
+  ).action(async (from, to2, type, reason) => {
     await dispatchFromCli(
       "mutate",
       "tasks",
@@ -124726,15 +124781,6 @@ function registerReleaseCommand(program) {
       { command: "release" }
     );
   });
-  release2.command("changelog <version>").description("Generate changelog for a release").action(async (version2) => {
-    await dispatchFromCli(
-      "mutate",
-      "pipeline",
-      "release.ship",
-      { version: version2, step: "changelog" },
-      { command: "release" }
-    );
-  });
   release2.command("cancel <version>").description("Cancel and remove a release in draft or prepared state").action(async (version2) => {
     await dispatchFromCli(
       "mutate",
@@ -124880,15 +124926,15 @@ function registerRemoteCommand(program) {
       const remoteName = opts["remote"];
       const result = await pull(remoteName);
       if (!result.success) {
-        const output = {
+        const details = {
           pulled: false,
           branch: result.branch,
           remote: result.remote
         };
         if (result.hasConflicts) {
-          output["conflicts"] = result.conflictFiles;
+          details["conflicts"] = result.conflictFiles;
         }
-        cliOutput(output, { command: "pull", message: result.message });
+        cliError(result.message, 1 /* GENERAL_ERROR */, { details });
         process.exit(1 /* GENERAL_ERROR */);
       }
       cliOutput(
@@ -124947,7 +124993,7 @@ function registerRemoteCommand(program) {
 // packages/cleo/src/cli/commands/reorder.ts
 init_cli();
 function registerReorderCommand(program) {
-  program.command("reorder <task-id>").description("Change task position within sibling group").option("--position <n>", "Move to specific position", parseInt).option("--before <id>", "Move before specified task").option("--after <id>", "Move after specified task").option("--top", "Move to first position").option("--bottom", "Move to last position").action(async (taskId, opts) => {
+  program.command("reorder <task-id>").description("Change task position within sibling group").option("--position <n>", "Move to specific zero-based position among siblings", parseInt).action(async (taskId, opts) => {
     const position = opts["position"];
     await dispatchFromCli(
       "mutate",
@@ -126239,7 +126285,13 @@ var SHOW_PARAMS = [
   }
 ];
 function registerShowCommand(program) {
-  const cmd = program.command("show").description(buildOperationHelp("tasks.show", "Show full task details by ID", SHOW_PARAMS));
+  const cmd = program.command("show").description(
+    buildOperationHelp(
+      "tasks.show",
+      "Show full task details by ID (returns complete task record with metadata, verification, lifecycle)",
+      SHOW_PARAMS
+    )
+  );
   applyParamDefsToCommand(cmd, SHOW_PARAMS, "tasks.show");
   cmd.action(async (taskId) => {
     await dispatchFromCli("query", "tasks", "show", { taskId }, { command: "show" });
@@ -126471,7 +126523,9 @@ function registerSnapshotCommand(program) {
 // packages/cleo/src/cli/commands/specification.ts
 init_cli();
 function registerSpecificationCommand(program) {
-  const specification = program.command("specification").description("Validate specification protocol compliance");
+  const specification = program.command("specification").description(
+    "Validate specification protocol compliance (alias for `cleo check protocol specification`)"
+  );
   specification.command("validate <taskId>").description("Validate specification protocol compliance for task").option("--strict", "Exit with error code on violations").option("--spec-file <file>", "Path to specification file").action(async (taskId, opts) => {
     await dispatchFromCli(
       "query",
@@ -126507,7 +126561,7 @@ function registerSpecificationCommand(program) {
 // packages/cleo/src/cli/commands/start.ts
 init_cli();
 function registerStartCommand(program) {
-  program.command("start <taskId>").description("Start working on a task").action(async (taskId) => {
+  program.command("start <taskId>").description("Start working on a task (sets it as the current task in the active session)").action(async (taskId) => {
     await dispatchFromCli("mutate", "tasks", "start", { taskId }, { command: "start" });
   });
 }
@@ -126521,7 +126575,7 @@ function registerStatsCommand(program) {
       "admin",
       "stats",
       {
-        period: opts["period"] ? Number(opts["period"]) : 30
+        period: opts["period"] ?? 30
       },
       { command: "stats", operation: "admin.stats" }
     );
@@ -126718,7 +126772,9 @@ function collect(value, previous) {
 // packages/cleo/src/cli/commands/stop.ts
 init_cli();
 function registerStopCommand(program) {
-  program.command("stop").description("Stop working on the current task").action(async () => {
+  program.command("stop").description(
+    "Stop working on the current task (clears the active task, returns {cleared: boolean, previousTask: string|null})"
+  ).action(async () => {
     await dispatchFromCli("mutate", "tasks", "stop", {}, { command: "stop" });
   });
 }
@@ -126763,10 +126819,10 @@ function registerSyncCommand(program) {
     "How to resolve conflicts: keep-cleo, keep-external, or newest (default: keep-cleo)",
     "keep-cleo"
   ).action(async (file2, opts) => {
-    const { readFileSync: readFileSync103 } = await import("node:fs");
+    const { readFileSync: readFileSync102 } = await import("node:fs");
     let externalTasks;
     try {
-      externalTasks = JSON.parse(readFileSync103(file2, "utf8"));
+      externalTasks = JSON.parse(readFileSync102(file2, "utf8"));
     } catch (err) {
       const message = err instanceof Error ? err.message : String(err);
       console.error(`Failed to read or parse external tasks file: ${message}`);
@@ -126862,15 +126918,17 @@ function registerTestingCommand(program) {
 init_internal();
 init_cli();
 init_renderers();
-import { readFileSync as readFileSync101 } from "node:fs";
+import { readFileSync as readFileSync100 } from "node:fs";
 function readPayload(opts, textKey, fileKey) {
   const text3 = opts[textKey];
   const file2 = opts[fileKey];
-  if (file2) return readFileSync101(file2, "utf-8");
+  if (file2) return readFileSync100(file2, "utf-8");
   return text3;
 }
 function registerTokenCommand(program) {
-  const token = program.command("token").description("Provider-aware token telemetry and estimation");
+  const token = program.command("token").description(
+    "Provider-aware token telemetry from tasks.db (historical, per-operation tracking)"
+  );
   token.command("summary").description("Summarize recorded token telemetry").option("--provider <provider>", "Filter by provider").option("--transport <transport>", "Filter by transport").option("--domain <domain>", "Filter by domain").option("--operation <name>", "Filter by operation name").option("--session <id>", "Filter by session ID").option("--task <id>", "Filter by task ID").action(async (opts) => {
     await dispatchFromCli(
       "query",
@@ -126966,7 +127024,7 @@ function registerTokenCommand(program) {
 // packages/cleo/src/cli/commands/update.ts
 init_cli();
 function registerUpdateCommand(program) {
-  program.command("update <taskId>").description("Update a task").option("--title <title>", "New title").option("-s, --status <status>", "New status").option("-p, --priority <priority>", "New priority").option("-t, --type <type>", "New type").option("--size <size>", "New size").option("-P, --phase <phase>", "New phase").option("-d, --description <desc>", "New description").option("-l, --labels <labels>", "Set labels (comma-separated)").option("--add-labels <labels>", "Add labels (comma-separated)").option("--remove-labels <labels>", "Remove labels (comma-separated)").option("-D, --depends <ids>", "Set dependencies (comma-separated)").option("--add-depends <ids>", "Add dependencies (comma-separated)").option("--remove-depends <ids>", "Remove dependencies (comma-separated)").option("--notes <note>", "Add a note").option(
+  program.command("update <taskId>").description("Update a task").option("--title <title>", "New title").option("-s, --status <status>", "New status (pending|active|blocked|done|cancelled)").option("-p, --priority <priority>", "New priority (critical|high|medium|low)").option("-t, --type <type>", "New type (task|epic|subtask|bug)").option("--size <size>", "New size").option("-P, --phase <phase>", "New phase").option("-d, --description <desc>", "New description").option("-l, --labels <labels>", "Set labels (comma-separated)").option("--add-labels <labels>", "Add labels (comma-separated)").option("--remove-labels <labels>", "Remove labels (comma-separated)").option("-D, --depends <ids>", "Set dependencies (comma-separated)").option("--add-depends <ids>", "Add dependencies (comma-separated)").option("--remove-depends <ids>", "Remove dependencies (comma-separated)").option("--notes <note>", "Add a note").option(
     "--acceptance <criteria>",
     'Set acceptance criteria (pipe-separated, e.g. "AC1|AC2|AC3")'
   ).option("--files <files>", "Set files (comma-separated)").option("--blocked-by <reason>", "Set blocked-by reason").option("--parent <id>", "Set parent ID").option("--no-auto-complete", "Disable auto-complete for epic").option(
@@ -127089,7 +127147,10 @@ function registerUpgradeCommand(program) {
 // packages/cleo/src/cli/commands/validate.ts
 init_cli();
 function registerValidateCommand(program) {
-  program.command("validate").description("Validate task data against schema and business rules").option("--strict", "Treat warnings as errors").action(async (opts) => {
+  program.command("validate").description(
+    "DEPRECATED: Use `cleo check schema todo` instead. Validate task data against schema and business rules"
+  ).option("--strict", "Treat warnings as errors").action(async (opts) => {
+    console.error("[DEPRECATED] cleo validate is deprecated. Use: cleo check schema todo");
     await dispatchFromCli(
       "query",
       "check",
@@ -127452,13 +127513,12 @@ var codeCommand = defineCommand({
 // packages/cleo/src/cli/index.ts
 function getPackageVersion() {
   const pkgPath = join130(dirname28(fileURLToPath5(import.meta.url)), "../../package.json");
-  const pkg = JSON.parse(readFileSync102(pkgPath, "utf-8"));
+  const pkg = JSON.parse(readFileSync101(pkgPath, "utf-8"));
   return pkg.version;
 }
 var CLI_VERSION = getPackageVersion();
 var rootShim = new ShimCommand();
 registerAgentCommand(rootShim);
-registerAgentsCommand(rootShim);
 registerAddCommand(rootShim);
 registerAddBatchCommand(rootShim);
 registerListCommand(rootShim);