@cleocode/cleo 2026.4.20 → 2026.4.22

package/dist/cli/index.js

@@ -10836,8 +10836,9 @@ function getProjectRoot(cwd) {
   if (scope !== void 0) {
     return scope.worktreeRoot;
   }
-  if (process.env["CLEO_ROOT"]) {
-    return process.env["CLEO_ROOT"];
+  const envRoot = process.env["CLEO_ROOT"] ?? process.env["CLEO_PROJECT_ROOT"];
+  if (envRoot) {
+    return envRoot;
   }
   const cleoDirEnv = process.env["CLEO_DIR"];
   if (cleoDirEnv && isAbsolutePath(cleoDirEnv)) {
@@ -34311,6 +34312,31 @@ function validatePhaseFormat(phase) {
     );
   }
 }
+function throwCombinedValidationError(issues, options) {
+  const summary = issues.length === 1 ? issues[0].message : `${issues.length} validation issues found:
+${issues.map((i, n) => `  ${n + 1}. ${i.message}`).join("\n")}`;
+  const fixes = issues.map((i) => i.fix).filter(Boolean);
+  const fixSummary = fixes.length === 0 ? void 0 : fixes.length === 1 ? fixes[0] : fixes.map((f2, n) => `${n + 1}. ${f2}`).join("\n");
+  const submittedParams = { title: options.title };
+  if (options.parentId) submittedParams.parent = options.parentId;
+  if (options.type) submittedParams.type = options.type;
+  if (options.priority) submittedParams.priority = options.priority;
+  if (options.size) submittedParams.size = options.size;
+  if (options.description) submittedParams.description = "(provided)";
+  if (options.acceptance?.length)
+    submittedParams.acceptance = `${options.acceptance.length} criteria`;
+  if (options.depends?.length) submittedParams.depends = options.depends;
+  if (options.phase) submittedParams.phase = options.phase;
+  if (options.labels?.length) submittedParams.labels = options.labels;
+  throw new CleoError(6 /* VALIDATION_ERROR */, summary, {
+    fix: fixSummary,
+    details: {
+      field: issues.length === 1 ? issues[0].field : "multiple",
+      issues,
+      submittedParams
+    }
+  });
+}
 function validateDepends(depends, tasks2) {
   const existingIds = new Set(tasks2.map((t) => t.id));
   for (const depId of depends) {
@@ -34438,46 +34464,69 @@ function findRecentDuplicate(title, phase, tasks2, windowSeconds = 60) {
 }
 async function addTask(options, cwd, accessor) {
   validateTitle(options.title);
-  if (options.description && options.title.trim().toLowerCase() === options.description.trim().toLowerCase()) {
-    throw new CleoError(
-      6 /* VALIDATION_ERROR */,
-      "Title and description must be different (anti-hallucination rule)",
-      {
-        fix: "Provide --desc with a description different from the title",
-        details: { field: "description" }
-      }
-    );
-  }
   if (!options.dryRun) {
     await requireActiveSession("tasks.add", cwd);
   }
+  const issues = [];
+  const warnings = [];
+  if (options.description && options.title.trim().toLowerCase() === options.description.trim().toLowerCase()) {
+    issues.push({
+      field: "description",
+      message: "Title and description must be different (anti-hallucination rule)",
+      fix: "Provide --desc with a description different from the title"
+    });
+  }
   const parentId = options.parentId ?? null;
   if (!options.dryRun && !parentId && options.type !== "epic") {
     const lifecycleMode = await getLifecycleMode(cwd);
     if (lifecycleMode === "strict") {
-      throw new CleoError(
-        6 /* VALIDATION_ERROR */,
-        'Tasks must have a parent (epic or task) in strict mode. Use --parent <epicId>, --type epic for a root-level epic, or set lifecycle.mode to "advisory".',
-        {
-          fix: 'cleo add "Task title" --parent T### --acceptance "AC1|AC2|AC3"',
-          alternatives: [
-            {
-              action: "Create as epic",
-              command: 'cleo add "Epic title" --type epic --priority high'
-            }
-          ]
-        }
+      issues.push({
+        field: "parentId",
+        message: 'Tasks must have a parent (epic or task) in strict mode. Use --parent <epicId>, --type epic for a root-level epic, or set lifecycle.mode to "advisory".',
+        fix: 'cleo add "Task title" --parent T### --acceptance "AC1|AC2|AC3"'
+      });
+    } else {
+      warnings.push(
+        "Task created without a parent. Use --parent <epicId> to assign to an epic hierarchy."
       );
     }
   }
   const dataAccessor = accessor ?? await (await Promise.resolve().then(() => (init_data_accessor(), data_accessor_exports))).getAccessor(cwd);
   const status = options.status ?? "pending";
-  const priority = normalizePriority(options.priority ?? "medium");
+  let priority;
+  try {
+    priority = normalizePriority(options.priority ?? "medium");
+  } catch (err) {
+    if (err instanceof CleoError) {
+      issues.push({ field: "priority", message: err.message, fix: err.fix });
+    }
+    priority = "medium";
+  }
   const size = options.size ?? "medium";
   let taskType = options.type;
-  validateStatus(status);
-  validateSize(size);
-  if (options.labels?.length) validateLabels(options.labels);
+  try {
+    validateStatus(status);
+  } catch (err) {
+    if (err instanceof CleoError) {
+      issues.push({ field: "status", message: err.message, fix: err.fix });
+    }
+  }
+  try {
+    validateSize(size);
+  } catch (err) {
+    if (err instanceof CleoError) {
+      issues.push({ field: "size", message: err.message, fix: err.fix });
+    }
+  }
+  if (options.labels?.length) {
+    try {
+      validateLabels(options.labels);
+    } catch (err) {
+      if (err instanceof CleoError) {
+        issues.push({ field: "labels", message: err.message, fix: err.fix });
+      }
+    }
+  }
   if (!options.dryRun) {
     const enforcement = await createAcceptanceEnforcement(cwd);
     const acValidation = enforcement.validateCreation({
@@ -34485,17 +34534,28 @@ async function addTask(options, cwd, accessor) {
       priority
     });
     if (!acValidation.valid) {
-      throw new CleoError(acValidation.exitCode ?? 6 /* VALIDATION_ERROR */, acValidation.error, {
+      issues.push({
+        field: "acceptance",
+        message: acValidation.error,
         fix: acValidation.fix
       });
     }
     if (options.type === "epic") {
-      await validateEpicCreation(
-        { acceptance: options.acceptance, description: options.description },
-        cwd
-      );
+      try {
+        await validateEpicCreation(
+          { acceptance: options.acceptance, description: options.description },
+          cwd
+        );
+      } catch (err) {
+        if (err instanceof CleoError) {
+          issues.push({ field: "epic", message: err.message, fix: err.fix });
+        }
+      }
     }
   }
+  if (issues.length > 0) {
+    throwCombinedValidationError(issues, options);
+  }
   if (options.depends?.length) {
     for (const depId of options.depends) {
       const trimmed = depId.trim();
@@ -34794,7 +34854,7 @@ async function addTask(options, cwd, accessor) {
       after: { title: options.title, status, priority }
     });
   });
-  return { task };
+  return { task, ...warnings.length > 0 && { warnings } };
 }
 var NUMERIC_PRIORITY_MAP, VALID_PRIORITIES;
 var init_add = __esm({
@@ -38729,10 +38789,10 @@ async function readProjectMeta(projectPath) {
 }
 async function readProjectId(projectPath) {
   try {
-    const { readFileSync: readFileSync101, 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(readFileSync101(infoPath, "utf-8"));
+    const data = JSON.parse(readFileSync102(infoPath, "utf-8"));
     return typeof data.projectId === "string" ? data.projectId : "";
   } catch {
     return "";
@@ -54949,7 +55009,7 @@ function fuzzyScore(query, text3) {
   return 0;
 }
 async function findTasks(options, cwd, accessor) {
-  if (!options.query && !options.id) {
+  if (options.query == null && !options.id) {
     throw new CleoError(2 /* INVALID_INPUT */, "Search query or --id is required", {
       fix: 'cleo find "<query>"',
       details: { field: "query" }
@@ -54986,6 +55046,8 @@ async function findTasks(options, cwd, accessor) {
       priority: t.priority,
       type: t.type,
       parentId: t.parentId,
+      depends: t.depends ?? [],
+      size: t.size ?? void 0,
       score: t.id.toUpperCase() === idQuery ? 100 : t.id.toUpperCase().startsWith(idQuery) ? 80 : 50
     }));
   } else if (options.exact) {
@@ -54998,6 +55060,8 @@ async function findTasks(options, cwd, accessor) {
       priority: t.priority,
       type: t.type,
       parentId: t.parentId,
+      depends: t.depends ?? [],
+      size: t.size ?? void 0,
       score: 100
     }));
   } else {
@@ -55016,6 +55080,8 @@ async function findTasks(options, cwd, accessor) {
           priority: t.priority,
           type: t.type,
           parentId: t.parentId,
+          depends: t.depends ?? [],
+          size: t.size ?? void 0,
           score: Math.round(score)
         });
       }
@@ -107789,14 +107855,55 @@ async function taskFind(projectRoot, query, limit, options) {
       projectRoot,
       accessor
     );
+    if (options?.verbose) {
+      const fullResults = [];
+      for (const r of findResult.results) {
+        const task = await accessor.loadSingleTask(r.id);
+        if (task) fullResults.push(taskToRecord(task));
+      }
+      return { success: true, data: { results: fullResults, total: findResult.total } };
+    }
+    if (options?.fields) {
+      const extraFields = options.fields.split(",").map((f2) => f2.trim());
+      const extendedResults = [];
+      for (const r of findResult.results) {
+        const base = {
+          id: r.id,
+          title: r.title,
+          status: r.status,
+          priority: r.priority,
+          parentId: r.parentId,
+          depends: r.depends,
+          type: r.type,
+          size: r.size
+        };
+        const task = await accessor.loadSingleTask(r.id);
+        if (task) {
+          const record2 = taskToRecord(task);
+          for (const field of extraFields) {
+            if (field in record2) {
+              base[field] = record2[field];
+            }
+          }
+        }
+        extendedResults.push(base);
+      }
+      return {
+        success: true,
+        data: { results: extendedResults, total: findResult.total }
+      };
+    }
     const results = findResult.results.map((r) => ({
       id: r.id,
       title: r.title,
       status: r.status,
       priority: r.priority,
-      parentId: r.parentId
+      parentId: r.parentId,
+      depends: r.depends,
+      type: r.type,
+      size: r.size
     }));
-    return { success: true, data: { results, total: results.length } };
+    return { success: true, data: { results, total: findResult.total } };
   } catch (err) {
     return cleoErrorToEngineError(err, "E_NOT_INITIALIZED", "Task database not initialized");
   }
@@ -107804,11 +107911,37 @@ async function taskFind(projectRoot, query, limit, options) {
 async function taskCreate(projectRoot, params) {
   try {
     const accessor = await getAccessor(projectRoot);
+    let resolvedParent = params.parent || null;
+    if (!resolvedParent && params.parentSearch) {
+      const searchResult = await findTasks(
+        { query: params.parentSearch, limit: 1 },
+        projectRoot,
+        accessor
+      );
+      if (searchResult.results.length > 0) {
+        resolvedParent = searchResult.results[0].id;
+      } else {
+        return cleoErrorToEngineError(
+          new Error(`No task found matching --parent-search "${params.parentSearch}"`),
+          "E_NOT_FOUND",
+          `No task found matching "${params.parentSearch}"`
+        );
+      }
+    }
+    if (!resolvedParent && params.type !== "epic") {
+      try {
+        const session = await getActiveSession(projectRoot);
+        if (session?.scope?.type === "epic" && session.scope.epicId) {
+          resolvedParent = session.scope.epicId;
+        }
+      } catch {
+      }
+    }
     const result = await addTask(
       {
         title: params.title,
         description: params.description,
-        parentId: params.parent || null,
+        parentId: resolvedParent,
         depends: params.depends,
         priority: params.priority || "medium",
         labels: params.labels,
@@ -107828,7 +107961,8 @@ async function taskCreate(projectRoot, params) {
       data: {
         task: taskToRecord(result.task),
         duplicate: result.duplicate ?? false,
-        dryRun: params.dryRun
+        dryRun: params.dryRun,
+        ...result.warnings?.length && { warnings: result.warnings }
       }
     };
   } catch (err) {
@@ -111605,7 +111739,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: readFileSync101, 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();
@@ -111614,7 +111748,7 @@ async function orchestrateClassify(request, context, projectRoot) {
       const files = readdirSync42(workflowsDir).filter((f2) => f2.endsWith(".cant"));
       for (const file2 of files) {
         try {
-          const src = readFileSync101(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];
@@ -111634,7 +111768,7 @@ async function orchestrateClassify(request, context, projectRoot) {
       const files = readdirSync42(localCantDir).filter((f2) => f2.endsWith(".cant"));
       for (const file2 of files) {
         try {
-          const src = readFileSync101(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];
@@ -113916,7 +114050,9 @@ var init_tasks4 = __esm({
                   exact: params?.exact,
                   status: params?.status,
                   includeArchive: params?.includeArchive,
-                  offset: params?.offset
+                  offset: params?.offset,
+                  fields: params?.fields,
+                  verbose: params?.verbose
                 }
               );
               return wrapResult(result, "query", "tasks", operation, startTime);
@@ -114067,7 +114203,8 @@ var init_tasks4 = __esm({
                 size: params?.size,
                 notes: params?.notes,
                 files: params?.files,
-                dryRun: params?.dryRun
+                dryRun: params?.dryRun,
+                parentSearch: params?.parentSearch
               });
               return wrapResult(result, "mutate", "tasks", operation, startTime);
             }
@@ -116151,7 +116288,7 @@ var init_cli = __esm({
 
 // packages/cleo/src/cli/index.ts
 init_internal();
-import { readFileSync as readFileSync100 } 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";
 
@@ -117156,6 +117293,13 @@ var ADD_PARAMS = [
     required: false,
     description: "Position within sibling group",
     cli: { flag: "position", parse: parseInt }
+  },
+  {
+    name: "parentSearch",
+    type: "string",
+    required: false,
+    description: "Resolve parent by title substring instead of exact ID (T090)",
+    cli: { flag: "parent-search" }
   }
 ];
 function registerAddCommand(program) {
@@ -117179,18 +117323,37 @@ function registerAddCommand(program) {
       params["labels"] = opts["labels"].split(",").map((s3) => s3.trim());
     if (opts["files"])
       params["files"] = opts["files"].split(",").map((s3) => s3.trim());
-    if (opts["acceptance"])
-      params["acceptance"] = opts["acceptance"].split("|").map((s3) => s3.trim()).filter(Boolean);
+    if (opts["acceptance"]) {
+      const raw = opts["acceptance"];
+      if (raw.trimStart().startsWith("[")) {
+        try {
+          const parsed = JSON.parse(raw);
+          params["acceptance"] = Array.isArray(parsed) ? parsed.map((s3) => String(s3).trim()).filter(Boolean) : [raw];
+        } catch {
+          params["acceptance"] = raw.split("|").map((s3) => s3.trim()).filter(Boolean);
+        }
+      } else {
+        params["acceptance"] = raw.split("|").map((s3) => s3.trim()).filter(Boolean);
+      }
+    }
     if (opts["depends"])
       params["depends"] = opts["depends"].split(",").map((s3) => s3.trim());
     if (opts["notes"] !== void 0) params["notes"] = opts["notes"];
     if (opts["position"] !== void 0) params["position"] = opts["position"];
     if (opts["dryRun"] !== void 0) params["dryRun"] = opts["dryRun"];
+    if (opts["parentSearch"] !== void 0) params["parentSearch"] = opts["parentSearch"];
     const response = await dispatchRaw("mutate", "tasks", "add", params);
     if (!response.success) {
       handleRawError(response, { command: "add", operation: "tasks.add" });
     }
     const data = response.data;
+    const dataWarnings = data?.warnings;
+    if (dataWarnings?.length) {
+      for (const w2 of dataWarnings) {
+        process.stderr.write(`\u26A0 ${w2}
+`);
+      }
+    }
     if (data?.duplicate) {
       cliOutput(data, {
         command: "add",
@@ -117209,6 +117372,93 @@ function registerAddCommand(program) {
   });
 }
 
+// packages/cleo/src/cli/commands/add-batch.ts
+init_cli();
+init_renderers();
+import { readFileSync as readFileSync96 } 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"];
+    const defaultParent = opts["parent"];
+    const dryRun = opts["dryRun"];
+    let raw;
+    if (!filePath || filePath === "-") {
+      const chunks = [];
+      for await (const chunk of process.stdin) {
+        chunks.push(chunk);
+      }
+      raw = Buffer.concat(chunks).toString("utf-8");
+    } else {
+      raw = readFileSync96(filePath, "utf-8");
+    }
+    let tasks2;
+    try {
+      const parsed = JSON.parse(raw);
+      tasks2 = Array.isArray(parsed) ? parsed : [parsed];
+    } catch {
+      process.stderr.write("Error: Invalid JSON input. Expected an array of task objects.\n");
+      process.exit(2);
+      return;
+    }
+    if (tasks2.length === 0) {
+      process.stderr.write("Error: No tasks in input.\n");
+      process.exit(2);
+      return;
+    }
+    const results = [];
+    let failed = 0;
+    for (const task of tasks2) {
+      const params = {
+        title: task.title,
+        ...task.description && { description: task.description },
+        parent: task.parent ?? defaultParent,
+        ...task.type && { type: task.type },
+        ...task.priority && { priority: task.priority },
+        ...task.size && { size: task.size },
+        ...task.acceptance?.length && { acceptance: task.acceptance },
+        ...task.depends?.length && { depends: task.depends },
+        ...task.labels?.length && { labels: task.labels },
+        ...task.phase && { phase: task.phase },
+        ...task.notes && { notes: task.notes },
+        ...task.files?.length && { files: task.files },
+        ...dryRun && { dryRun: true }
+      };
+      const response = await dispatchRaw("mutate", "tasks", "add", params);
+      if (response.success) {
+        const data = response.data;
+        const taskData = data?.task;
+        results.push({ title: task.title, id: taskData?.id });
+      } else {
+        failed++;
+        results.push({
+          title: task.title,
+          error: response.error?.message ?? "Unknown error"
+        });
+      }
+    }
+    const output = {
+      total: tasks2.length,
+      created: tasks2.length - failed,
+      failed,
+      dryRun: dryRun ?? false,
+      results
+    };
+    if (failed > 0) {
+      cliOutput(output, {
+        command: "add-batch",
+        message: `${failed} of ${tasks2.length} tasks failed`,
+        operation: "tasks.add-batch"
+      });
+      process.exit(1);
+    } else {
+      cliOutput(output, {
+        command: "add-batch",
+        operation: "tasks.add-batch"
+      });
+    }
+  });
+}
+
 // packages/cleo/src/cli/commands/admin.ts
 init_cli();
 function registerAdminCommand(program) {
@@ -117496,7 +117746,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: readFileSync101 } = 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());
@@ -117519,7 +117769,7 @@ agent ${agentId}:
       let cantValidation = null;
       const cantPath = opts["cant"] ?? join131(".cleo", "agents", `${agentId}.cant`);
       if (existsSync131(cantPath)) {
-        profile = readFileSync101(cantPath, "utf-8");
+        profile = readFileSync102(cantPath, "utf-8");
         try {
           const cantModule = await import("@cleocode/cant");
           const validate = "validate" in cantModule ? cantModule.validate : null;
@@ -118559,7 +118809,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: readFileSync101, 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");
@@ -118678,7 +118928,7 @@ Task ${taskId} reassigned to you by ${active.agentId}. Run: cleo show ${taskId}
       }
       let registered = false;
       try {
-        const persona = readFileSync101(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));
@@ -120277,7 +120527,7 @@ function registerBugCommand(program) {
 
 // packages/cleo/src/cli/commands/cant.ts
 init_renderers();
-import { existsSync as existsSync128, mkdirSync as mkdirSync29, readFileSync as readFileSync96, writeFileSync as writeFileSync23 } from "node:fs";
+import { existsSync as existsSync128, mkdirSync as mkdirSync29, readFileSync as readFileSync97, writeFileSync as writeFileSync23 } 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");
@@ -120355,7 +120605,7 @@ function registerCantCommand(program) {
       }
       try {
         const mod = await loadMigrateEngine();
-        const content = readFileSync96(filePath, "utf-8");
+        const content = readFileSync97(filePath, "utf-8");
         const result = mod.migrateMarkdown(content, filePath, {
           write: isWrite,
           verbose: isVerbose,
@@ -121150,7 +121400,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 readFileSync97 } 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();
@@ -121170,7 +121420,7 @@ function registerDetectDriftCommand(program) {
     const isCleoRepo = existsSync129(join125(projectRoot, "src", "cli", "commands")) || existsSync129(join125(projectRoot, "packages", "cleo", "src"));
     const safeRead = (filePath) => {
       try {
-        return readFileSync97(filePath, "utf-8");
+        return readFileSync98(filePath, "utf-8");
       } catch {
         return "";
       }
@@ -122088,6 +122338,20 @@ var FIND_PARAMS = [
     required: false,
     description: "Skip first N results",
     cli: { flag: "offset", parse: parseInt }
+  },
+  {
+    name: "fields",
+    type: "string",
+    required: false,
+    description: "Comma-separated additional fields to include (e.g. labels,acceptance,notes,description)",
+    cli: { flag: "fields" }
+  },
+  {
+    name: "verbose",
+    type: "boolean",
+    required: false,
+    description: "Include all task fields (same as cleo list output)",
+    cli: { flag: "verbose", short: "-v" }
   }
 ];
 function registerFindCommand(program) {
@@ -122107,6 +122371,8 @@ function registerFindCommand(program) {
     if (opts["includeArchive"] !== void 0) params["includeArchive"] = opts["includeArchive"];
     if (limit !== void 0) params["limit"] = limit;
     if (offset !== void 0) params["offset"] = offset;
+    if (opts["fields"] !== void 0) params["fields"] = opts["fields"];
+    if (opts["verbose"] !== void 0) params["verbose"] = opts["verbose"];
     const response = await dispatchRaw("query", "tasks", "find", params);
     if (!response.success) {
       handleRawError(response, { command: "find", operation: "tasks.find" });
@@ -122134,12 +122400,12 @@ init_src();
 init_src2();
 init_renderers();
 import { execFileSync as execFileSync16 } from "node:child_process";
-import { existsSync as existsSync130, mkdirSync as mkdirSync30, readFileSync as readFileSync98, writeFileSync as writeFileSync24 } from "node:fs";
+import { existsSync as existsSync130, mkdirSync as mkdirSync30, readFileSync as readFileSync99, writeFileSync as writeFileSync24 } 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(readFileSync98(configPath, "utf-8"));
+    const config2 = JSON.parse(readFileSync99(configPath, "utf-8"));
     return config2?.release?.changelog?.source ?? "CHANGELOG.md";
   } catch {
     return "CHANGELOG.md";
@@ -122148,7 +122414,7 @@ function getChangelogSource(cwd) {
 function getEnabledPlatforms(cwd) {
   const configPath = getConfigPath(cwd);
   try {
-    const config2 = JSON.parse(readFileSync98(configPath, "utf-8"));
+    const config2 = JSON.parse(readFileSync99(configPath, "utf-8"));
     const outputs = config2?.release?.changelog?.outputs ?? [];
     return outputs.filter((o) => o.enabled);
   } catch {
@@ -122277,7 +122543,7 @@ function registerGenerateChangelogCommand(program) {
       if (!existsSync130(sourcePath)) {
         throw new CleoError(4 /* NOT_FOUND */, `Changelog source not found: ${sourcePath}`);
       }
-      const sourceContent = readFileSync98(sourcePath, "utf-8");
+      const sourceContent = readFileSync99(sourcePath, "utf-8");
       const repoSlug = getGitHubRepoSlug();
       const results = [];
       if (targetPlatform) {
@@ -125333,7 +125599,7 @@ init_src2();
 init_cli();
 init_renderers();
 function registerStickyCommand(program) {
-  const sticky = program.command("sticky").alias("note").description("Manage sticky notes - quick project-wide ephemeral captures");
+  const sticky = program.command("sticky").description("Manage sticky notes - quick project-wide ephemeral captures");
   sticky.command("add <content>").alias("jot").description("Create a new sticky note").option("--tag <tag>", "Add a tag (can be used multiple times)", collect, []).option("--color <color>", "Sticky color: yellow|blue|green|red|purple", "yellow").option("--priority <priority>", "Priority: low|medium|high", "medium").action(async (content, opts) => {
     try {
       await dispatchFromCli(
@@ -125369,7 +125635,7 @@ function registerStickyCommand(program) {
         return;
       }
       const data = response.data;
-      if (!data || !data.stickies || data.stickies.length === 0) {
+      if (!data?.stickies || data.stickies.length === 0) {
         cliOutput(
           { stickies: [], total: 0 },
           { command: "sticky list", message: "No sticky notes found", operation: "sticky.list" }
@@ -125581,11 +125847,11 @@ function registerTestingCommand(program) {
 init_internal();
 init_cli();
 init_renderers();
-import { readFileSync as readFileSync99 } 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 readFileSync99(file2, "utf-8");
+  if (file2) return readFileSync100(file2, "utf-8");
   return text3;
 }
 function registerTokenCommand(program) {
@@ -126171,7 +126437,7 @@ 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(readFileSync100(pkgPath, "utf-8"));
+  const pkg = JSON.parse(readFileSync101(pkgPath, "utf-8"));
   return pkg.version;
 }
 var CLI_VERSION = getPackageVersion();
@@ -126179,6 +126445,7 @@ var rootShim = new ShimCommand();
 registerAgentCommand(rootShim);
 registerAgentsCommand(rootShim);
 registerAddCommand(rootShim);
+registerAddBatchCommand(rootShim);
 registerListCommand(rootShim);
 registerShowCommand(rootShim);
 registerFindCommand(rootShim);