@cleocode/core 2026.4.20 → 2026.4.22

package/dist/index.js

@@ -10811,8 +10811,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)) {
@@ -24715,6 +24716,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((f, n) => `${n + 1}. ${f}`).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) {
@@ -24842,46 +24868,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({
@@ -24889,17 +24938,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();
@@ -25198,7 +25258,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({
@@ -53219,7 +53279,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" }
@@ -53256,6 +53316,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) {
@@ -53268,6 +53330,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 {
@@ -53286,6 +53350,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)
         });
       }