@cleocode/cleo 2026.10.3 → 2026.10.4

package/dist/cli/update-NVCYV2FT.js

@@ -0,0 +1,476 @@
+(() => {
+  const _installed = Symbol.for('cleocode.cli.sqliteWarningFilter');
+  if (globalThis[_installed]) return;
+  globalThis[_installed] = true;
+  const _origEmitWarning = process.emitWarning;
+  process.emitWarning = function(warning, type, code, ctor) {
+    if (typeof warning === 'object' && warning.name === 'ExperimentalWarning' && typeof warning.message === 'string' && /SQLite is an experimental feature/i.test(warning.message)) {
+      return;
+    }
+    if (typeof warning === 'string' && /SQLite is an experimental feature/i.test(warning)) {
+      return;
+    }
+    return _origEmitWarning.call(process, warning, type, code, ctor);
+  };
+})();
+import {
+  collectMutateInput
+} from "./chunk-QA6T2LQ5.js";
+import {
+  defineCommand,
+  showUsage
+} from "./chunk-PKKZPOOP.js";
+import {
+  dispatchFromCli,
+  dispatchRaw,
+  handleRawError,
+  maybeEmitDescribe
+} from "./chunk-3IOQVUO7.js";
+import "./chunk-AWCQH2W5.js";
+import "./chunk-OGV57L4J.js";
+import "./chunk-ZBISIPCK.js";
+import {
+  cliError,
+  cliOutput
+} from "./chunk-3ZO3M37V.js";
+import "./chunk-6JSJNYH2.js";
+import "./chunk-QFFQSKRC.js";
+
+// packages/cleo/src/cli/commands/update.ts
+import { ExitCode, TASK_SEVERITIES } from "@cleocode/contracts";
+import {
+  INPUT_CONTRACTS,
+  isPipelineTransitionForward,
+  isValidPipelineStage,
+  parseAcceptanceCriteria,
+  TASK_PIPELINE_STAGES,
+  validateOperationInput
+} from "@cleocode/core";
+var updateCommand = defineCommand({
+  meta: {
+    name: "update",
+    description: "Update a task. Safe under concurrent invocation \u2014 retries on SQLITE_BUSY up to 4 attempts (gh#391)."
+  },
+  args: {
+    /**
+     * Schema-first input — supersedes all flag-based args when present.
+     *
+     * Accepts a JSON object matching `INPUT_CONTRACTS['tasks.update']`.
+     * The `taskId` MUST be present in the JSON payload (positional
+     * `taskId` arg is ignored in this path).
+     *
+     * @task T9917
+     */
+    params: {
+      type: "string",
+      description: 'Inline JSON object matching INPUT_CONTRACTS["tasks.update"] (T9917). Overrides positional + flags.'
+    },
+    /**
+     * Schema-first input from a JSON file. Same semantics as --params.
+     *
+     * @task T9917
+     */
+    "params-file": {
+      type: "string",
+      description: 'Path to JSON file matching INPUT_CONTRACTS["tasks.update"] (T9917).'
+    },
+    taskId: {
+      type: "positional",
+      description: "Task ID to update",
+      required: false
+    },
+    title: {
+      type: "string",
+      description: "New title"
+    },
+    status: {
+      type: "string",
+      description: "New status (pending|active|blocked|done|cancelled)",
+      alias: "s"
+    },
+    priority: {
+      type: "string",
+      description: "New priority (critical|high|medium|low). Orthogonal to --severity \u2014 see `cleo find --urgent` for the unified surface (T9905).",
+      alias: "p"
+    },
+    type: {
+      type: "string",
+      description: "New type (task|epic|subtask)",
+      alias: "t"
+    },
+    size: {
+      type: "string",
+      description: "New size"
+    },
+    phase: {
+      type: "string",
+      description: "New phase",
+      alias: "P"
+    },
+    description: {
+      type: "string",
+      description: "New description",
+      alias: "d"
+    },
+    labels: {
+      type: "string",
+      description: 'Set labels (comma-separated; lowercase alphanumeric + hyphens + periods only, e.g. "track-b,wave.1") (gh-392)',
+      alias: "l"
+    },
+    "add-labels": {
+      type: "string",
+      description: 'Add labels (comma-separated; lowercase alphanumeric + hyphens + periods only, e.g. "track-b,wave.1") (gh-392)'
+    },
+    "remove-labels": {
+      type: "string",
+      description: "Remove labels (comma-separated)"
+    },
+    depends: {
+      type: "string",
+      description: "Set dependencies (comma-separated)",
+      alias: "D"
+    },
+    "add-depends": {
+      type: "string",
+      description: "Add dependencies (comma-separated)"
+    },
+    "remove-depends": {
+      type: "string",
+      description: "Remove dependencies (comma-separated)"
+    },
+    notes: {
+      type: "string",
+      description: "Add a note"
+    },
+    note: {
+      type: "string",
+      description: "Alias for --notes"
+    },
+    acceptance: {
+      type: "string",
+      description: 'Set acceptance criteria (pipe-separated, e.g. "AC1|AC2|AC3")'
+    },
+    files: {
+      type: "string",
+      description: "Set files (comma-separated)"
+    },
+    "add-files": {
+      type: "string",
+      description: "Add files incrementally (comma-separated)"
+    },
+    "remove-files": {
+      type: "string",
+      description: "Remove files incrementally (comma-separated)"
+    },
+    "blocked-by": {
+      type: "string",
+      description: "Set blocked-by reason"
+    },
+    "clear-blocked-by": {
+      type: "boolean",
+      description: "Clear the blocked-by reason string"
+    },
+    parent: {
+      type: "string",
+      description: "Set parent ID"
+    },
+    "parent-id": {
+      type: "string",
+      description: "Alias for --parent (legacy parentId compatibility)"
+    },
+    "auto-complete": {
+      type: "boolean",
+      description: "Enable auto-complete for epic",
+      negativeDescription: "Disable auto-complete for epic"
+    },
+    "pipeline-stage": {
+      type: "string",
+      description: "Set pipeline stage (forward-only: research|consensus|architecture_decision|specification|decomposition|implementation|validation|testing|release|contribution)"
+    },
+    /**
+     * Task kind axis — intent of work.
+     * Values: work | research | experiment | bug | spike | release
+     * @task T944
+     * @task T9072
+     */
+    kind: {
+      type: "string",
+      description: "Task kind / intent axis (work|research|experiment|bug|spike|release) \u2014 orthogonal to --type (T944)"
+    },
+    /**
+     * Task scope axis — granularity of work.
+     * Values: project | feature | unit
+     * @task T944
+     */
+    scope: {
+      type: "string",
+      description: "Task scope / granularity axis (project|feature|unit) \u2014 orthogonal to --type (T944)"
+    },
+    /**
+     * Severity level — valid for any role (not just bug).
+     * Values: P0 | P1 | P2 | P3
+     * Orthogonal to --priority — does NOT auto-map priority.
+     * Appends a signed attestation to .cleo/audit/severity-attestation.jsonl (T9071/T9073).
+     * @task T9073
+     */
+    severity: {
+      type: "string",
+      description: "Severity level (P0|P1|P2|P3) \u2014 valid for any --kind (T9073). Orthogonal to --priority \u2014 does NOT auto-map (a P0 with priority=medium stays medium). Use `cleo find --urgent` for the unified surface (T9905). Appends signed attestation."
+    },
+    /**
+     * Operator-supplied justification required to override the
+     * acceptance-criteria immutability guard once a task has entered the
+     * implementation pipeline stage. Audit log: `.cleo/audit/ac-changes.jsonl`.
+     *
+     * @epic T1586 Foundation Lockdown
+     * @task T1590
+     */
+    reason: {
+      type: "string",
+      description: "Why this change is made. Recorded on the audit row of any priority/severity/kind/depends change (D11161; see `cleo history ranking <id>`), and required to mutate --acceptance once stage >= implementation (T1590)"
+    },
+    /**
+     * Waiver for the critical-priority dependency declaration requirement.
+     *
+     * Critical-priority tasks without declared dependencies silently break
+     * wave-order spawning when downstream work assumes they are load-bearing.
+     * Provide a justification string to waive the `--depends` requirement.
+     * The waiver is stored in the task update audit log in the mutation transaction.
+     *
+     * @task T1856
+     * @epic T1855
+     */
+    /**
+     * Optimistic-concurrency guard: the task `updatedAt` the caller read
+     * (e.g. from `cleo show <id> --field /data/task/updatedAt`). When the
+     * stored version differs, the update fails with E_CONFLICT carrying the
+     * current version instead of overwriting a newer write.
+     *
+     * @task T12503
+     */
+    "expected-updated-at": {
+      type: "string",
+      description: "Fail with E_CONFLICT unless the task updatedAt still equals this value (optimistic concurrency; T12503)"
+    },
+    "if-match": {
+      type: "string",
+      description: "Fail with E_CONFLICT unless the task updatedAt still equals this version (from cleo show). Same as --expected-updated-at."
+    },
+    "depends-waiver": {
+      type: "string",
+      description: "Non-empty justification to waive the dependency requirement for --priority critical. Stored verbatim in the transactional task update audit log. Rejected for non-critical updates. (gh-405 / T1856)"
+    },
+    /**
+     * Related tasks — semantic relationships (non-dependency).
+     *
+     * Direction convention (gh-403):
+     *   `cleo update <fromId> --add-relates <toId>:<type>`
+     * creates a directed edge FROM `<fromId>` TO `<toId>` with the given type.
+     * Example: `cleo update T127 --add-relates T123:blocks` means
+     * "T127 blocks T123" (the task being updated is the source).
+     *
+     * For dependency edges (T127 must complete before T128 can start), prefer
+     * `--add-depends T128` on T127 — `depends` is the canonical dep primitive
+     * and is what `cleo orchestrate ready`/`waves` walks. `--add-relates` is for
+     * semantic relationships (blocks/supersedes/groups/related) that don't
+     * affect wave-order scheduling.
+     */
+    relates: {
+      type: "string",
+      description: 'Set related tasks (comma-separated, optional type suffix: "T001:blocks,T002"). Direction: <current task> \u2192 <relate>. For dep edges, prefer --add-depends. (gh-403)'
+    },
+    "add-relates": {
+      type: "string",
+      description: 'Add related tasks without overwriting (comma-separated, optional type suffix: "T001:blocks"). Direction: <current task> \u2192 <relate>. For dep edges, prefer --add-depends. (gh-403)'
+    },
+    "remove-relates": {
+      type: "string",
+      description: "Remove related tasks by taskId (comma-separated)"
+    }
+  },
+  async run({ args, cmd }) {
+    if (maybeEmitDescribe("mutate", "tasks", "update", { command: "update" })) return;
+    const paramsArg = args.params;
+    const paramsFileArg = args["params-file"];
+    if (paramsArg !== void 0 || paramsFileArg !== void 0) {
+      const collectArgs = {};
+      if (paramsArg !== void 0) collectArgs.params = paramsArg;
+      if (paramsFileArg !== void 0) collectArgs.file = paramsFileArg;
+      let raw;
+      try {
+        raw = await collectMutateInput(
+          collectArgs,
+          process.stdin
+        );
+      } catch (err) {
+        cliError(
+          err.message,
+          ExitCode.VALIDATION_ERROR,
+          {
+            name: "E_VALIDATION_FAILED",
+            fix: "Verify the JSON syntax of your --params / --params-file input"
+          },
+          { operation: "tasks.update" }
+        );
+        process.exit(ExitCode.VALIDATION_ERROR);
+        return;
+      }
+      if (raw !== null && typeof raw === "object" && !Array.isArray(raw) && raw["taskId"] === void 0 && args.taskId !== void 0) {
+        raw["taskId"] = args.taskId;
+      }
+      const contract = INPUT_CONTRACTS["tasks.update"];
+      if (!contract) {
+        cliError(
+          "tasks.update contract missing from INPUT_CONTRACTS registry",
+          ExitCode.GENERAL_ERROR,
+          { name: "E_INTERNAL", fix: "This is a CLI bug \u2014 file an issue" },
+          { operation: "tasks.update" }
+        );
+        process.exit(ExitCode.GENERAL_ERROR);
+        return;
+      }
+      const validation = validateOperationInput(contract, raw);
+      if (!validation.ok) {
+        cliError(
+          "tasks.update failed: validation",
+          ExitCode.VALIDATION_ERROR,
+          {
+            name: "E_VALIDATION_FAILED",
+            fix: validation.errors[0]?.fix ?? "Inspect errors[] and correct the input",
+            details: { errors: validation.errors }
+          },
+          { operation: "tasks.update" }
+        );
+        process.exit(ExitCode.VALIDATION_ERROR);
+        return;
+      }
+      const validatedPayload = raw;
+      const response = await dispatchRaw("mutate", "tasks", "update", validatedPayload);
+      if (!response.success) {
+        handleRawError(response, { command: "update", operation: "tasks.update" });
+        return;
+      }
+      cliOutput(response.data, { command: "update", operation: "tasks.update" });
+      return;
+    }
+    if (!args.taskId) {
+      await showUsage(cmd);
+      return;
+    }
+    if (args.severity !== void 0 && !TASK_SEVERITIES.includes(args.severity)) {
+      const valid = TASK_SEVERITIES.join(", ");
+      cliError(
+        `severity must be one of: ${valid} \u2014 got '${args.severity}'`,
+        6,
+        {
+          name: "E_INVALID_SEVERITY_VALUE",
+          fix: `Pass --severity with one of: ${valid}`
+        },
+        { operation: "tasks.update" }
+      );
+      process.exit(6);
+      return;
+    }
+    if (args["pipeline-stage"] !== void 0) {
+      const requestedStage = String(args["pipeline-stage"]);
+      if (!isValidPipelineStage(requestedStage)) {
+        const valid = TASK_PIPELINE_STAGES.join(", ");
+        cliError(
+          `pipeline-stage must be one of: ${valid} \u2014 got '${requestedStage}'`,
+          6,
+          {
+            name: "E_INVALID_PIPELINE_STAGE",
+            fix: `Pass --pipeline-stage with one of: ${valid}`
+          },
+          { operation: "tasks.update" }
+        );
+        process.exit(6);
+        return;
+      }
+      const showResponse = await dispatchRaw("query", "tasks", "show", {
+        taskId: args.taskId
+      });
+      if (!showResponse.success) {
+        handleRawError(showResponse, { command: "update", operation: "tasks.show" });
+        return;
+      }
+      const existingTask = showResponse.data;
+      const currentStage = typeof existingTask?.["pipelineStage"] === "string" ? existingTask["pipelineStage"] : null;
+      if (currentStage && !isPipelineTransitionForward(currentStage, requestedStage)) {
+        const validForward = TASK_PIPELINE_STAGES.filter((s) => {
+          return isPipelineTransitionForward(currentStage, s);
+        }).join(", ");
+        cliError(
+          `pipeline-stage transition rejected: cannot move backward from '${currentStage}' to '${requestedStage}'. Pipeline stages are forward-only.`,
+          6,
+          {
+            name: "E_INVALID_PIPELINE_STAGE",
+            fix: `Pass --pipeline-stage with a stage at or after '${currentStage}'. Valid forward stages: ${validForward}`
+          },
+          { operation: "tasks.update" }
+        );
+        process.exit(6);
+        return;
+      }
+    }
+    const params = { taskId: args.taskId };
+    if (args.title !== void 0) params["title"] = args.title;
+    if (args.status !== void 0) params["status"] = args.status;
+    if (args.priority !== void 0) params["priority"] = args.priority;
+    if (args.type !== void 0) params["type"] = args.type;
+    if (args.size !== void 0) params["size"] = args.size;
+    if (args.phase !== void 0) params["phase"] = args.phase;
+    if (args.description !== void 0) params["description"] = args.description;
+    if (args.labels) params["labels"] = args.labels.split(",").map((s) => s.trim());
+    if (args["add-labels"])
+      params["addLabels"] = args["add-labels"].split(",").map((s) => s.trim());
+    if (args["remove-labels"])
+      params["removeLabels"] = args["remove-labels"].split(",").map((s) => s.trim());
+    if (args.depends) params["depends"] = args.depends.split(",").map((s) => s.trim());
+    if (args["add-depends"])
+      params["addDepends"] = args["add-depends"].split(",").map((s) => s.trim());
+    if (args["remove-depends"])
+      params["removeDepends"] = args["remove-depends"].split(",").map((s) => s.trim());
+    if (args.relates) {
+      params["relates"] = args.relates.split(",").map((s) => {
+        const [taskId, relType = "related"] = s.trim().split(":");
+        return { taskId: taskId.trim(), type: relType.trim() };
+      });
+    }
+    if (args["add-relates"]) {
+      params["addRelates"] = args["add-relates"].split(",").map((s) => {
+        const [taskId, relType = "related"] = s.trim().split(":");
+        return { taskId: taskId.trim(), type: relType.trim() };
+      });
+    }
+    if (args["remove-relates"]) {
+      params["removeRelates"] = args["remove-relates"].split(",").map((s) => s.trim());
+    }
+    if (args.notes !== void 0) params["notes"] = args.notes;
+    if (args.note !== void 0) params["notes"] = params["notes"] ?? args.note;
+    if (args.acceptance) params["acceptance"] = parseAcceptanceCriteria(args.acceptance);
+    if (args.files) params["files"] = args.files.split(",").map((s) => s.trim());
+    if (args["add-files"])
+      params["addFiles"] = args["add-files"].split(",").map((s) => s.trim());
+    if (args["remove-files"])
+      params["removeFiles"] = args["remove-files"].split(",").map((s) => s.trim());
+    if (args["blocked-by"] !== void 0) params["blockedBy"] = args["blocked-by"];
+    if (args["clear-blocked-by"] === true) params["clearBlockedBy"] = true;
+    if (args.parent !== void 0) params["parent"] = args.parent;
+    if (args["parent-id"] !== void 0) params["parent"] = params["parent"] ?? args["parent-id"];
+    if (args["auto-complete"] !== void 0) params["noAutoComplete"] = !args["auto-complete"];
+    if (args["pipeline-stage"] !== void 0) params["pipelineStage"] = args["pipeline-stage"];
+    if (args.kind !== void 0) params["kind"] = args.kind;
+    if (args.scope !== void 0) params["scope"] = args.scope;
+    if (args.severity !== void 0) params["severity"] = args.severity;
+    if (args.reason !== void 0) params["reason"] = args.reason;
+    if (args["depends-waiver"] !== void 0) params["dependsWaiver"] = args["depends-waiver"];
+    const ifMatch = args["if-match"] ?? args["expected-updated-at"];
+    if (ifMatch !== void 0) params["expectedUpdatedAt"] = ifMatch;
+    await dispatchFromCli("mutate", "tasks", "update", params, { command: "update" });
+  }
+});
+export {
+  updateCommand
+};
+//# sourceMappingURL=update-NVCYV2FT.js.map