@hasna/todos 0.11.92 → 0.11.94

package/dist/cli/index.js

@@ -2104,7 +2104,7 @@ var package_default;
 var init_package = __esm(() => {
   package_default = {
     name: "@hasna/todos",
-    version: "0.11.92",
+    version: "0.11.94",
     description: "Universal task management for AI coding agents - CLI + MCP server + interactive TUI",
     type: "module",
     main: "dist/index.js",
@@ -2786,205 +2786,25 @@ async function cloudListTasks(client, filter = {}) {
   const envelope = res.raw;
   return Array.isArray(envelope?.tasks) ? envelope.tasks : res.items;
 }
-async function cloudListTaskPage(client, filter) {
-  const res = await requiredRemoteRoute(client, "/v1/tasks", () => client.list("tasks", { query: toListQuery(filter) }));
-  const envelope = res.raw;
-  if (envelope && Object.prototype.hasOwnProperty.call(envelope, "tasks") && !Array.isArray(envelope.tasks)) {
-    throw new Error("REMOTE_API_INCOMPATIBLE: /v1/tasks returned a malformed tasks page; local SQLite fallback is disabled");
-  }
-  const tasks = Array.isArray(envelope?.tasks) ? envelope.tasks : res.items;
-  if (!Array.isArray(tasks) || tasks.some((task) => !task || typeof task !== "object" || typeof task.id !== "string" || !task.id)) {
-    throw new Error("REMOTE_API_INCOMPATIBLE: /v1/tasks returned a malformed tasks page; local SQLite fallback is disabled");
-  }
-  const count = typeof envelope?.count === "number" ? envelope.count : tasks.length;
-  if (!Number.isSafeInteger(count) || count < 0 || count !== tasks.length) {
-    throw new Error("REMOTE_API_INCOMPATIBLE: /v1/tasks returned an invalid count; local SQLite fallback is disabled");
-  }
-  if (envelope?.total !== undefined && (!Number.isSafeInteger(envelope.total) || envelope.total < 0 || envelope.total < count)) {
-    throw new Error("REMOTE_API_INCOMPATIBLE: /v1/tasks returned an invalid total; local SQLite fallback is disabled");
-  }
-  return { tasks, count, total: envelope?.total };
-}
-async function cloudTasksAllCount(client) {
-  const stats = await cloudGetStats(client);
-  if (!Number.isSafeInteger(stats.tasks_all) || stats.tasks_all < 0) {
-    throw new RemoteTaskReferenceSnapshotError("REMOTE_API_INCOMPATIBLE: /v1/stats must return a non-negative integer tasks_all for short task references");
-  }
-  return stats.tasks_all;
-}
-async function cloudPaginateTaskScope(client, filter, maximumTotal) {
-  const pageSize = 500;
-  const tasks = [];
-  const ids = new Set;
-  let reportedTotal;
-  let totalPresence;
-  for (let offset = 0;; ) {
-    let page;
-    try {
-      page = await cloudListTaskPage(client, { ...filter, limit: pageSize, offset });
-    } catch (error) {
-      const message = error instanceof Error ? error.message : String(error);
-      if (!message.startsWith("REMOTE_API_INCOMPATIBLE") && !message.startsWith("REMOTE_API_CHANGED_DURING_PAGINATION")) {
-        throw error;
-      }
-      throw new RemoteTaskReferenceSnapshotError(message, { cause: error });
-    }
-    const pageHasTotal = page.total !== undefined;
-    if (totalPresence !== undefined && totalPresence !== pageHasTotal) {
-      throw new RemoteTaskReferenceSnapshotError("REMOTE_API_INCOMPATIBLE: /v1/tasks changed total support during pagination");
-    }
-    totalPresence = pageHasTotal;
-    if (page.total !== undefined && reportedTotal !== undefined && page.total !== reportedTotal) {
-      throw new RemoteTaskReferenceSnapshotError("REMOTE_API_CHANGED_DURING_PAGINATION: /v1/tasks total changed during pagination");
-    }
-    if (page.total !== undefined)
-      reportedTotal = page.total;
-    if (tasks.length + page.tasks.length > maximumTotal || reportedTotal !== undefined && tasks.length + page.tasks.length > reportedTotal) {
-      throw new RemoteTaskReferenceSnapshotError("REMOTE_API_INCOMPATIBLE: /v1/tasks pagination exceeded total; local SQLite fallback is disabled");
-    }
-    for (const task of page.tasks) {
-      if (ids.has(task.id)) {
-        throw new RemoteTaskReferenceSnapshotError("REMOTE_API_INCOMPATIBLE: /v1/tasks pagination returned a duplicate task id");
-      }
-      ids.add(task.id);
-      tasks.push(task);
-    }
-    if (reportedTotal !== undefined && tasks.length === reportedTotal)
-      break;
-    if (reportedTotal !== undefined && page.tasks.length === 0) {
-      throw new RemoteTaskReferenceSnapshotError("REMOTE_API_INCOMPATIBLE: /v1/tasks pagination ended before total; local SQLite fallback is disabled");
-    }
-    if (reportedTotal === undefined && page.tasks.length < pageSize)
-      break;
-    offset += page.tasks.length;
-  }
-  return { tasks, total: reportedTotal };
-}
-function taskParentId(task) {
-  return typeof task.parent_id === "string" && task.parent_id ? task.parent_id : null;
-}
-function assertCompleteTaskHierarchy(tasks) {
-  const byId = new Map(tasks.map((task) => [task.id, task]));
-  for (const task of tasks) {
-    const visited = new Set([task.id]);
-    let parentId = taskParentId(task);
-    while (parentId) {
-      if (visited.has(parentId)) {
-        throw new RemoteTaskReferenceSnapshotError("REMOTE_API_INCOMPATIBLE: /v1/tasks returned a cyclic task hierarchy");
-      }
-      visited.add(parentId);
-      const parent = byId.get(parentId);
-      if (!parent) {
-        throw new RemoteTaskReferenceSnapshotError("REMOTE_API_INCOMPATIBLE: /v1/tasks returned an orphaned task hierarchy");
-      }
-      parentId = taskParentId(parent);
-    }
-  }
-}
-async function cloudListTaskHierarchyForResolution(client, expectedTotal) {
-  const roots = await cloudPaginateTaskScope(client, {}, expectedTotal);
-  for (const root of roots.tasks) {
-    if (taskParentId(root) !== null) {
-      throw new RemoteTaskReferenceSnapshotError("REMOTE_API_INCOMPATIBLE: default /v1/tasks returned a non-root task");
-    }
-  }
-  const tasks = [...roots.tasks];
-  const seen = new Set(tasks.map((task) => task.id));
-  const queue = roots.tasks.map((task) => ({ task, ancestors: new Set([task.id]) }));
-  for (let index = 0;index < queue.length; index += 1) {
-    const current = queue[index];
-    const children = await cloudPaginateTaskScope(client, { parent_id: current.task.id }, expectedTotal);
-    for (const child of children.tasks) {
-      if (taskParentId(child) !== current.task.id) {
-        throw new RemoteTaskReferenceSnapshotError("REMOTE_API_INCOMPATIBLE: /v1/tasks parent filter returned an orphaned task");
-      }
-      if (current.ancestors.has(child.id)) {
-        throw new RemoteTaskReferenceSnapshotError("REMOTE_API_INCOMPATIBLE: /v1/tasks returned a cyclic task hierarchy");
-      }
-      if (seen.has(child.id)) {
-        throw new RemoteTaskReferenceSnapshotError("REMOTE_API_INCOMPATIBLE: /v1/tasks hierarchy returned a duplicate task id");
-      }
-      seen.add(child.id);
-      tasks.push(child);
-      if (tasks.length > expectedTotal) {
-        throw new RemoteTaskReferenceSnapshotError("REMOTE_API_INCOMPATIBLE: /v1/tasks hierarchy exceeded /v1/stats tasks_all");
-      }
-      queue.push({ task: child, ancestors: new Set([...current.ancestors, child.id]) });
-    }
-  }
-  if (tasks.length !== expectedTotal) {
-    throw new RemoteTaskReferenceSnapshotError("REMOTE_API_INCOMPATIBLE: /v1/tasks hierarchy did not account for every /v1/stats tasks_all row");
-  }
-  assertCompleteTaskHierarchy(tasks);
-  return tasks;
-}
-async function cloudListAllTasksForResolution(client, expectedTotal) {
-  const inclusive = await cloudPaginateTaskScope(client, { include_subtasks: true }, expectedTotal);
-  if (inclusive.tasks.length === expectedTotal && (inclusive.total === undefined || inclusive.total === expectedTotal)) {
-    assertCompleteTaskHierarchy(inclusive.tasks);
-    return inclusive.tasks;
-  }
-  return cloudListTaskHierarchyForResolution(client, expectedTotal);
-}
-async function resolveTaskRefSnapshot(client, ref, input) {
-  const beforeTotal = await cloudTasksAllCount(client);
-  let tasks;
-  try {
-    tasks = await cloudListAllTasksForResolution(client, beforeTotal);
-  } catch (error) {
-    const afterFailureTotal = await cloudTasksAllCount(client);
-    if (afterFailureTotal !== beforeTotal) {
-      throw new RemoteTaskReferenceSnapshotError("REMOTE_API_CHANGED_DURING_PAGINATION: tasks_all changed during task resolution", { cause: error });
-    }
-    throw error;
-  }
-  const exactShort = tasks.filter((task) => task.short_id?.toLowerCase() === input);
-  const prefixes = exactShort.length === 0 ? tasks.filter((task) => task.id.toLowerCase().startsWith(input)) : [];
-  const matches = exactShort.length > 0 ? exactShort : prefixes;
-  if (matches.length > 1) {
-    const afterTotal2 = await cloudTasksAllCount(client);
-    if (afterTotal2 !== beforeTotal) {
-      throw new RemoteTaskReferenceSnapshotError("REMOTE_API_CHANGED_DURING_PAGINATION: tasks_all changed during task resolution");
-    }
-    throw new Error(`Task reference is ambiguous: "${ref}"`);
-  }
-  if (matches.length === 0) {
-    const afterTotal2 = await cloudTasksAllCount(client);
-    if (afterTotal2 !== beforeTotal) {
-      throw new RemoteTaskReferenceSnapshotError("REMOTE_API_CHANGED_DURING_PAGINATION: tasks_all changed during task resolution");
-    }
-    throw new Error(`Task not found: ${ref}`);
-  }
-  const candidate = matches[0];
-  const finalTask = await cloudGetTask(client, candidate.id);
-  const finalMatches = finalTask?.id === candidate.id && (exactShort.length === 1 ? finalTask.short_id?.toLowerCase() === input : finalTask.id.toLowerCase().startsWith(input));
-  if (!finalMatches) {
-    throw new RemoteTaskReferenceSnapshotError("REMOTE_API_CHANGED_DURING_PAGINATION: resolved task no longer matches the short reference");
-  }
-  const afterTotal = await cloudTasksAllCount(client);
-  if (afterTotal !== beforeTotal) {
-    throw new RemoteTaskReferenceSnapshotError("REMOTE_API_CHANGED_DURING_PAGINATION: tasks_all changed during task resolution");
-  }
-  return candidate.id;
-}
 async function cloudResolveTaskRef(client, ref) {
   const input = ref.trim().toLowerCase();
   if (!input)
     throw new Error("Task reference must not be empty");
   if (UUID_RE.test(input))
     return input;
-  for (let attempt = 0;attempt < 2; attempt += 1) {
-    try {
-      return await resolveTaskRefSnapshot(client, ref, input);
-    } catch (error) {
-      if (!(error instanceof RemoteTaskReferenceSnapshotError))
-        throw error;
-      if (attempt === 1) {
-        throw new Error(`REMOTE_TASK_REFERENCE_UNSAFE: could not prove a stable complete task set for "${ref}"; ` + "retry with the full task UUID; no local fallback was attempted", { cause: error });
-      }
-    }
+  let task;
+  try {
+    task = await cloudGetTask(client, input);
+  } catch (error) {
+    const status = error && typeof error === "object" ? error.status : undefined;
+    if (status === 409)
+      throw new Error(`Task reference is ambiguous: "${ref}"`);
+    throw error;
+  }
+  if (task && typeof task.id === "string" && (task.short_id?.toLowerCase() === input || task.id.toLowerCase().startsWith(input))) {
+    return task.id;
   }
-  throw new Error(`REMOTE_TASK_REFERENCE_UNSAFE: use the full task UUID for "${ref}"`);
+  throw new Error(`Task not found: ${ref}`);
 }
 async function cloudGetTask(client, id) {
   const raw = await client.get("tasks", id);
@@ -3660,7 +3480,7 @@ async function cloudTimeline(client, options = {}) {
   const limit = options.limit ?? 50;
   return { entries: entries.slice(offset, offset + limit), total, limit, offset };
 }
-var UUID_RE, CLOUD_MODES, VALID_STORAGE_MODES, COMPLETION_EVIDENCE_FIELDS, completionCapabilityCache, RemoteTaskReferenceSnapshotError, PRIORITY_RANK;
+var UUID_RE, CLOUD_MODES, VALID_STORAGE_MODES, COMPLETION_EVIDENCE_FIELDS, completionCapabilityCache, PRIORITY_RANK;
 var init_cloud_router = __esm(() => {
   init_redaction();
   UUID_RE = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
@@ -3675,8 +3495,6 @@ var init_cloud_router = __esm(() => {
     "confidence"
   ];
   completionCapabilityCache = new Map;
-  RemoteTaskReferenceSnapshotError = class RemoteTaskReferenceSnapshotError extends Error {
-  };
   PRIORITY_RANK = { critical: 0, high: 1, medium: 2, low: 3 };
 });
 
@@ -15209,6 +15027,46 @@ function resolveTaskListRef(ref, projectId) {
     return { id: bySlug.id };
   return { error: `Could not resolve task list "${ref}" to a UUID${projectId ? " within the task's project" : ""}. Pass an exact task-list UUID.` };
 }
+async function computeCloudReparent(cloud, current, opts) {
+  const targetProjectId = opts.projectRef ? await cloudResolveProjectRef(cloud, opts.projectRef) : undefined;
+  const scope = targetProjectId ?? current.project_id ?? undefined;
+  let taskListId;
+  if (opts.listRef)
+    taskListId = await cloudResolveTaskListRef(cloud, opts.listRef, scope);
+  else if (opts.clearList)
+    taskListId = null;
+  else if (targetProjectId && targetProjectId !== current.project_id)
+    taskListId = null;
+  const patch = {};
+  if (targetProjectId !== undefined)
+    patch.project_id = targetProjectId;
+  if (taskListId !== undefined)
+    patch.task_list_id = taskListId;
+  return patch;
+}
+function computeLocalReparent(current, opts) {
+  const targetProjectId = opts.projectRef ? resolveProjectIdOrSlug(opts.projectRef) : undefined;
+  const scope = targetProjectId ?? current.project_id ?? null;
+  let taskListId;
+  if (opts.listRef) {
+    const resolved = resolveTaskListRef(opts.listRef, scope);
+    if ("error" in resolved) {
+      console.error(chalk2.red(resolved.error));
+      process.exit(1);
+    }
+    taskListId = resolved.id;
+  } else if (opts.clearList) {
+    taskListId = null;
+  } else if (targetProjectId && targetProjectId !== current.project_id) {
+    taskListId = null;
+  }
+  const patch = {};
+  if (targetProjectId !== undefined)
+    patch.project_id = targetProjectId;
+  if (taskListId !== undefined)
+    patch.task_list_id = taskListId;
+  return patch;
+}
 function registerTaskCommands(program2) {
   program2.command("add <title>").description("Create a new task").option("-d, --description <text>", "Task description").option("-p, --priority <level>", "Priority: low, medium, high, critical").option("--parent <id>", "Parent task ID").option("-t, --tags <tags>", "Comma-separated tags").option("--tag <tags>", "Comma-separated tags (alias for --tags)").option("--plan <id>", "Assign to a plan").option("--assign <agent>", "Assign to agent").option("--status <status>", "Initial status").option("--list <id>", "Task list ID").option("--task-list <id>", "Task list ID (alias for --list)").option("--estimated <minutes>", "Estimated time in minutes").option("--sla-minutes <minutes>", "SLA minutes before unfinished work is escalated").option("--sla <minutes>", "Alias for --sla-minutes").option("--approval", "Require approval before completion").option("--recurrence <rule>", "Recurrence rule, e.g. 'every day', 'every weekday', 'every 2 weeks'").option("--due <date>", "Due date (ISO string or YYYY-MM-DD)").option("--reason <text>", "Why this task exists").option("--project <id>", "Assign to project by ID or slug (overrides auto-detect)").action(async (title, opts) => {
     const globalOpts = program2.opts();
@@ -15913,7 +15771,7 @@ ${chalk2.cyan(sid)} ${statusColor(task2.status)} ${prioColor(task2.priority)} ${
       console.log(`  ${chalk2.dim(h.created_at)} ${chalk2.bold(h.action)}${field}${change}${agent}`);
     }
   });
-  program2.command("update <id>").description("Update a task").option("--title <text>", "New title").option("-d, --description <text>", "New description").option("-s, --status <status>", "New status").option("-p, --priority <priority>", "New priority").option("--assign <agent>", "Assign to agent").option("--tags <tags>", "New tags (comma-separated)").option("--tag <tags>", "New tags (alias for --tags)").option("--list <id>", "Move to a task list (UUID authoritative; project-scoped slug accepted)").option("--task-list <id>", "Move to a task list (alias for --list)").option("--clear-list", "Detach from its task list (reset task_list_id to null)").option("--working-dir <path>", "Repair the task's working_dir to a specific path (routing metadata)").option("--clear-working-dir", "Reset the task's working_dir to null (undo path for routing repairs)").option("--plan <id>", "Move to a plan").option("--clear-plan", "Remove from its current plan").option("--estimated <minutes>", "Estimated time in minutes").option("--sla-minutes <minutes>", "SLA minutes before unfinished work is escalated").option("--sla <minutes>", "Alias for --sla-minutes").option("--due <date>", "Due date (ISO string or YYYY-MM-DD), empty to clear").option("--recurrence <rule>", "Recurrence rule, empty to clear").option("--approval", "Require approval before completion").option("--clear-approval", "Remove the approval requirement").action(async (id, opts) => {
+  program2.command("update <id>").description("Update a task").option("--title <text>", "New title").option("-d, --description <text>", "New description").option("-s, --status <status>", "New status").option("-p, --priority <priority>", "New priority").option("--assign <agent>", "Assign to agent").option("--tags <tags>", "New tags (comma-separated)").option("--tag <tags>", "New tags (alias for --tags)").option("--list <id>", "Move to a task list (UUID authoritative; project-scoped slug accepted)").option("--task-list <id>", "Move to a task list (alias for --list)").option("--clear-list", "Detach from its task list (reset task_list_id to null)").option("--project <id>", "Re-parent the task to another project (by ID, slug, or path); see also `todos move`").option("--working-dir <path>", "Repair the task's working_dir to a specific path (routing metadata)").option("--clear-working-dir", "Reset the task's working_dir to null (undo path for routing repairs)").option("--plan <id>", "Move to a plan").option("--clear-plan", "Remove from its current plan").option("--estimated <minutes>", "Estimated time in minutes").option("--sla-minutes <minutes>", "SLA minutes before unfinished work is escalated").option("--sla <minutes>", "Alias for --sla-minutes").option("--due <date>", "Due date (ISO string or YYYY-MM-DD), empty to clear").option("--recurrence <rule>", "Recurrence rule, empty to clear").option("--approval", "Require approval before completion").option("--clear-approval", "Remove the approval requirement").action(async (id, opts) => {
     const globalOpts = program2.opts();
     opts.tags = opts.tags || opts.tag;
     opts.list = opts.list || opts.taskList;
@@ -15940,7 +15798,11 @@ ${chalk2.cyan(sid)} ${statusColor(task2.status)} ${prioColor(task2.priority)} ${
         const plan = opts.plan ? await cloudResolvePlan(cloud, opts.plan, current2.project_id ?? undefined) : null;
         if (opts.plan && !plan)
           throw new Error(`Plan not found: ${opts.plan}`);
-        const taskListId2 = opts.list ? await cloudResolveTaskListRef(cloud, opts.list, current2.project_id ?? undefined) : opts.clearList ? null : undefined;
+        const reparent2 = await computeCloudReparent(cloud, current2, {
+          projectRef: opts.project || globalOpts.project,
+          listRef: opts.list,
+          clearList: opts.clearList
+        });
         task3 = await cloudUpdateTask(cloud, currentId, {
           title: opts.title,
           description: opts.description,
@@ -15949,7 +15811,7 @@ ${chalk2.cyan(sid)} ${statusColor(task2.status)} ${prioColor(task2.priority)} ${
           assigned_to: opts.assign,
           tags: opts.tags ? opts.tags.split(",").map((t) => t.trim()) : undefined,
           plan_id: plan?.id ?? (opts.clearPlan ? null : undefined),
-          task_list_id: taskListId2,
+          ...reparent2,
           working_dir: opts.workingDir ? resolve9(opts.workingDir) : opts.clearWorkingDir ? null : undefined,
           estimated_minutes: opts.estimated !== undefined ? parseIntOption(opts.estimated, "--estimated") : undefined,
           sla_minutes: opts.slaMinutes !== undefined || opts.sla !== undefined ? parseIntOption(opts.slaMinutes ?? opts.sla, "--sla-minutes") : undefined,
@@ -15974,14 +15836,11 @@ ${chalk2.cyan(sid)} ${statusColor(task2.status)} ${prioColor(task2.priority)} ${
       console.error(chalk2.red(`Task not found: ${id}`));
       process.exit(1);
     }
-    const taskListId = opts.list ? (() => {
-      const resolved = resolveTaskListRef(opts.list, current.project_id);
-      if ("error" in resolved) {
-        console.error(chalk2.red(resolved.error));
-        process.exit(1);
-      }
-      return resolved.id;
-    })() : opts.clearList ? null : undefined;
+    const reparent = computeLocalReparent(current, {
+      projectRef: opts.project || globalOpts.project,
+      listRef: opts.list,
+      clearList: opts.clearList
+    });
     const planId = opts.plan ? resolvePlanId(opts.plan) : opts.clearPlan ? null : undefined;
     let task2;
     try {
@@ -15994,7 +15853,7 @@ ${chalk2.cyan(sid)} ${statusColor(task2.status)} ${prioColor(task2.priority)} ${
         assigned_to: opts.assign,
         tags: opts.tags ? opts.tags.split(",").map((t) => t.trim()) : undefined,
         plan_id: planId,
-        task_list_id: taskListId,
+        ...reparent,
         working_dir: opts.workingDir ? resolve9(opts.workingDir) : opts.clearWorkingDir ? null : undefined,
         estimated_minutes: opts.estimated !== undefined ? parseIntOption(opts.estimated, "--estimated") : undefined,
         sla_minutes: opts.slaMinutes !== undefined || opts.sla !== undefined ? parseIntOption(opts.slaMinutes ?? opts.sla, "--sla-minutes") : undefined,
@@ -16012,6 +15871,68 @@ ${chalk2.cyan(sid)} ${statusColor(task2.status)} ${prioColor(task2.priority)} ${
       console.log(formatTaskLine(task2));
     }
   });
+  program2.command("move <id>").description("Move a task to another project and/or task list (keeps its id and history)").option("--to-project <id>", "Destination project (by ID, slug, or path)").option("--to-list <id>", "Destination task list (UUID authoritative; slug resolved in the destination project)").option("--clear-list", "Detach from its task list (reset task_list_id to null)").action(async (id, opts) => {
+    const globalOpts = program2.opts();
+    const projectRef = opts.toProject ?? globalOpts.project;
+    const listRef = opts.toList;
+    if (!projectRef && !listRef && !opts.clearList) {
+      handleError(new Error("Nothing to move: pass --to-project, --to-list, or --clear-list."));
+    }
+    if (listRef && opts.clearList) {
+      handleError(new Error("Use either --to-list or --clear-list, not both."));
+    }
+    const cloud = getTodosCloudClient();
+    if (cloud) {
+      let task3;
+      try {
+        const currentId = await resolveTaskIdForCommand(id, cloud);
+        const current2 = await cloudGetTask(cloud, currentId);
+        if (!current2)
+          throw new Error(`Task not found: ${id}`);
+        const reparent2 = await computeCloudReparent(cloud, current2, {
+          projectRef,
+          listRef,
+          clearList: opts.clearList
+        });
+        if (reparent2.project_id === undefined && reparent2.task_list_id === undefined) {
+          throw new Error("Nothing to move: the task is already in the requested project/list.");
+        }
+        task3 = await cloudUpdateTask(cloud, currentId, reparent2);
+      } catch (e) {
+        handleError(e);
+      }
+      if (globalOpts.json) {
+        output(task3, true);
+      } else {
+        console.log(chalk2.green("Task moved:"));
+        console.log(formatTaskLine(task3));
+      }
+      return;
+    }
+    const resolvedId = resolveTaskId(id);
+    const current = getTask(resolvedId);
+    if (!current) {
+      console.error(chalk2.red(`Task not found: ${id}`));
+      process.exit(1);
+    }
+    const reparent = computeLocalReparent(current, { projectRef, listRef, clearList: opts.clearList });
+    if (reparent.project_id === undefined && reparent.task_list_id === undefined) {
+      console.error(chalk2.red("Nothing to move: the task is already in the requested project/list."));
+      process.exit(1);
+    }
+    let task2;
+    try {
+      task2 = updateTask(resolvedId, { version: current.version, ...reparent });
+    } catch (e) {
+      handleError(e);
+    }
+    if (globalOpts.json) {
+      output(task2, true);
+    } else {
+      console.log(chalk2.green("Task moved:"));
+      console.log(formatTaskLine(task2));
+    }
+  });
   program2.command("done <id>").description("Mark a task as completed").option("--attach-ids <ids>", "Comma-separated @hasna/attachments IDs to link as evidence").option("--files-changed <files>", "Comma-separated list of files changed").option("--test-results <results>", "Test results summary").option("--commit-hash <hash>", "Git commit hash").option("--notes <notes>", "Completion notes").option("--confidence <0-1>", "Agent's confidence 0.0-1.0 that the task is fully complete (default: 1.0, <0.7 flagged for review)").action(async (id, opts) => {
     const globalOpts = program2.opts();
     const attachmentIds = opts.attachIds ? opts.attachIds.split(",").map((s) => s.trim()).filter(Boolean) : undefined;
@@ -26746,6 +26667,26 @@ var init_sqlite_snapshot = __esm(() => {
 });
 
 // src/storage/local-sqlite.ts
+function resolveTaskRefLocal(db, ref) {
+  const raw = ref.trim().toLowerCase();
+  if (!raw)
+    return null;
+  if (TASK_UUID_RE2.test(raw))
+    return getTask(raw, db);
+  const prefixRows = db.query("SELECT id FROM tasks WHERE LOWER(id) LIKE ? ESCAPE '\\' LIMIT 2").all(`${raw.replace(/[\\%_]/g, (c) => `\\${c}`)}%`);
+  if (prefixRows.length > 1) {
+    throw new Error(`Task reference is ambiguous: "${ref}"`);
+  }
+  if (prefixRows.length === 1)
+    return getTask(prefixRows[0].id, db);
+  const shortIdRows = db.query("SELECT id FROM tasks WHERE LOWER(short_id) = ? LIMIT 2").all(raw);
+  if (shortIdRows.length > 1) {
+    throw new Error(`Task reference is ambiguous: "${ref}"`);
+  }
+  if (shortIdRows.length === 1)
+    return getTask(shortIdRows[0].id, db);
+  return null;
+}
 function createLocalSqliteTodosStorageAdapter(options = {}) {
   const database = () => options.db ?? getDatabase();
   let adapter;
@@ -26761,6 +26702,7 @@ function createLocalSqliteTodosStorageAdapter(options = {}) {
     tasks: {
       create: (input) => createTask(input, database()),
       get: (id) => getTask(id, database()),
+      resolveRef: (ref) => resolveTaskRefLocal(database(), ref),
       list: (filter = {}) => listTasks(filter, database()),
       count: (filter = {}) => countTasks(filter, database()),
       update: (id, input) => updateTask(id, input, database()),
@@ -26849,6 +26791,7 @@ function createLocalSqliteTodosStorageAdapter(options = {}) {
   };
   return adapter;
 }
+var TASK_UUID_RE2;
 var init_local_sqlite = __esm(() => {
   init_tasks();
   init_projects();
@@ -26860,6 +26803,7 @@ var init_local_sqlite = __esm(() => {
   init_comments();
   init_database();
   init_sqlite_snapshot();
+  TASK_UUID_RE2 = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
 });
 
 // src/storage/postgres-sync.ts
@@ -26982,6 +26926,18 @@ function postgresTodosCommentCursorIndexSql(tableName = DEFAULT_TODOS_POSTGRES_S
     ON ${tableName} (service, (payload->>'task_id'), (payload->>'created_at'), object_id)
     WHERE object_type = 'comments' AND deleted_at IS NULL`;
 }
+function postgresTodosTaskShortIdIndexSql(tableName = DEFAULT_TODOS_POSTGRES_SYNC_TABLE) {
+  assertSafeIdentifier(tableName);
+  return `CREATE INDEX CONCURRENTLY IF NOT EXISTS ${tableName}_task_short_id_idx
+    ON ${tableName} ((LOWER(payload->>'short_id')))
+    WHERE object_type = 'tasks' AND deleted_at IS NULL`;
+}
+function postgresTodosTaskObjectIdIndexSql(tableName = DEFAULT_TODOS_POSTGRES_SYNC_TABLE) {
+  assertSafeIdentifier(tableName);
+  return `CREATE INDEX CONCURRENTLY IF NOT EXISTS ${tableName}_task_object_id_c_idx
+    ON ${tableName} (service, (object_id COLLATE "C"))
+    WHERE object_type = 'tasks' AND deleted_at IS NULL`;
+}
 
 class PostgresTodosSyncStore {
   client;
@@ -27586,6 +27542,7 @@ function createPostgresTodosStorageAdapter(options) {
     tasks: {
       create: (input, context) => createTask2(input, store, context),
       get: (id) => store.get("tasks", id),
+      resolveRef: (ref) => store.resolveTaskRef(ref),
       list: (filter = {}) => store.listTasks(filter),
       count: (filter = {}) => store.countTasks(filter),
       update: (id, input) => updateTask2(id, input, store),
@@ -27838,6 +27795,37 @@ class PostgresJsonRecordStore {
     const row = result.rows[0];
     return row ? payloadRecord2(row.payload) : null;
   }
+  async resolveTaskRef(ref) {
+    await this.ensureSchema();
+    const raw = ref.trim().toLowerCase();
+    if (!raw)
+      return null;
+    const lastCode = raw.charCodeAt(raw.length - 1);
+    if (lastCode < 65535) {
+      const upper = raw.slice(0, -1) + String.fromCharCode(lastCode + 1);
+      const prefixResult = await this.options.client.query(`/* todos:resolve-task-ref-prefix */ SELECT payload FROM ${this.tableName}
+          WHERE service = $1 AND object_type = 'tasks' AND deleted_at IS NULL
+            AND object_id COLLATE "C" >= $2 AND object_id COLLATE "C" < $3
+          LIMIT 2`, [this.service, raw, upper]);
+      if (prefixResult.rows.length > 1) {
+        throw new Error(`Task reference is ambiguous: "${ref}"`);
+      }
+      if (prefixResult.rows.length === 1) {
+        return payloadRecord2(prefixResult.rows[0].payload);
+      }
+    }
+    const shortIdResult = await this.options.client.query(`/* todos:resolve-task-ref-short-id */ SELECT payload FROM ${this.tableName}
+        WHERE service = $1 AND object_type = 'tasks' AND deleted_at IS NULL
+          AND LOWER(payload->>'short_id') = $2
+        LIMIT 2`, [this.service, raw]);
+    if (shortIdResult.rows.length > 1) {
+      throw new Error(`Task reference is ambiguous: "${ref}"`);
+    }
+    if (shortIdResult.rows.length === 1) {
+      return payloadRecord2(shortIdResult.rows[0].payload);
+    }
+    return null;
+  }
   async countTasks(filter) {
     await this.ensureSchema();
     const { where, params } = this.buildTaskFilterSql(filter);
@@ -28259,7 +28247,7 @@ async function updateTask2(id, input, store) {
     tags: input.tags ?? existing.tags,
     metadata: input.metadata ?? existing.metadata,
     requires_approval: input.requires_approval ?? existing.requires_approval,
-    task_list_id: input.task_list_id ?? existing.task_list_id
+    task_list_id: input.task_list_id !== undefined ? input.task_list_id : existing.task_list_id
   };
   await store.upsert("tasks", task);
   return task;
@@ -29030,6 +29018,8 @@ __export(exports_cloud, {
   getCloudVerifier: () => getCloudVerifier,
   getCloudStorageAdapter: () => getCloudStorageAdapter,
   getApiKeyStore: () => getApiKeyStore,
+  ensureCloudTaskShortIdIndex: () => ensureCloudTaskShortIdIndex,
+  ensureCloudTaskObjectIdIndex: () => ensureCloudTaskObjectIdIndex,
   ensureCloudScopedSlugUniqueIndexes: () => ensureCloudScopedSlugUniqueIndexes,
   ensureCloudSchema: () => ensureCloudSchema,
   ensureCloudCommentCursorIndex: () => ensureCloudCommentCursorIndex,
@@ -29117,6 +29107,12 @@ async function ensureCloudSchema() {
 async function ensureCloudCommentCursorIndex() {
   await getClient().query(postgresTodosCommentCursorIndexSql());
 }
+async function ensureCloudTaskShortIdIndex() {
+  await getClient().query(postgresTodosTaskShortIdIndexSql());
+}
+async function ensureCloudTaskObjectIdIndex() {
+  await getClient().query(postgresTodosTaskObjectIdIndexSql());
+}
 async function ensureCloudScopedSlugUniqueIndexes() {
   await ensurePostgresScopedSlugUniqueIndexes(getClient());
 }
@@ -29199,6 +29195,8 @@ function buildV1OpenApiDocument(version = getPackageVersion()) {
             status: { type: "string" },
             priority: { type: "string" },
             assigned_to: { type: "string" },
+            project_id: { type: "string", nullable: true },
+            task_list_id: { type: "string", nullable: true },
             version: { type: "number" }
           }
         },
@@ -30411,7 +30409,17 @@ async function handleV1Request(req, url, dependencies = {}) {
         return error(404, `unknown task action: ${action}`);
       }
       if (method === "GET") {
-        const task = await store.tasks.get(id);
+        let task = await store.tasks.get(id);
+        if (!task && typeof store.tasks.resolveRef === "function") {
+          try {
+            task = await store.tasks.resolveRef(id);
+          } catch (e) {
+            const msg = e.message || "";
+            if (/ambiguous/i.test(msg))
+              return error(409, msg);
+            throw e;
+          }
+        }
         return task ? json2({ task }) : error(404, "task not found");
       }
       if (method === "PATCH" || method === "PUT") {
@@ -35547,6 +35555,17 @@ ${task.description}` : null
             patch.estimated_minutes = estimate;
           if (deadline !== undefined)
             patch.due_at = deadline;
+          if (typeof patch.project_id === "string" && patch.project_id) {
+            patch.project_id = await cloudResolveProjectRef(cloud, patch.project_id);
+          }
+          if (typeof patch.task_list_id === "string" && patch.task_list_id) {
+            let scope = typeof patch.project_id === "string" ? patch.project_id : undefined;
+            if (!scope) {
+              const current = await cloudGetTask(cloud, task_id2);
+              scope = current?.project_id ?? undefined;
+            }
+            patch.task_list_id = await cloudResolveTaskListRef(cloud, patch.task_list_id, scope);
+          }
           if (version2 !== undefined)
             patch.version = version2;
           const updated = await cloudUpdateTask(cloud, task_id2, patch);
@@ -39764,6 +39783,63 @@ function registerTaskProjectTools(server, ctx) {
       }
     });
   }
+  if (shouldRegisterTool("move_task")) {
+    server.tool("move_task", "Re-parent a task to another project and/or task list, preserving its id and history. " + "A task list is project-scoped, so moving to a new project detaches the old list unless to_list is given.", {
+      task_id: exports_external.string().describe("Task ID"),
+      to_project: exports_external.string().optional().describe("Destination project ID, slug, or path"),
+      to_list: exports_external.string().optional().describe("Destination task list (UUID, or slug resolved in the destination project)"),
+      clear_list: exports_external.boolean().optional().describe("Detach from its task list (set task_list_id to null)"),
+      version: exports_external.number().optional().describe("Expected version for optimistic locking")
+    }, async ({ task_id, to_project, to_list, clear_list, version }) => {
+      try {
+        if (!to_project && !to_list && !clear_list) {
+          throw new Error("Nothing to move: pass to_project, to_list, or clear_list.");
+        }
+        if (to_list && clear_list) {
+          throw new Error("Use either to_list or clear_list, not both.");
+        }
+        const cloud = getTodosCloudClient();
+        if (cloud) {
+          const current2 = await cloudGetTask(cloud, task_id);
+          if (!current2)
+            throw new Error(`Task not found: ${task_id}`);
+          const targetProjectId2 = to_project ? await cloudResolveProjectRef(cloud, to_project) : undefined;
+          const scope = targetProjectId2 ?? current2.project_id ?? undefined;
+          const patch = {};
+          if (targetProjectId2 !== undefined)
+            patch.project_id = targetProjectId2;
+          if (to_list)
+            patch.task_list_id = await cloudResolveTaskListRef(cloud, to_list, scope);
+          else if (clear_list)
+            patch.task_list_id = null;
+          else if (targetProjectId2 && targetProjectId2 !== current2.project_id)
+            patch.task_list_id = null;
+          if (version !== undefined)
+            patch.version = version;
+          const task2 = await cloudUpdateTask(cloud, task_id, patch);
+          return { content: [{ type: "text", text: formatTask(task2) }] };
+        }
+        const resolvedId = resolveId(task_id);
+        const current = getTask(resolvedId);
+        if (!current)
+          throw new Error(`Task not found: ${task_id}`);
+        const targetProjectId = to_project ? resolveId(to_project, "projects") : undefined;
+        const updates = {};
+        if (targetProjectId !== undefined)
+          updates.project_id = targetProjectId;
+        if (to_list)
+          updates.task_list_id = resolveId(to_list, "task_lists");
+        else if (clear_list)
+          updates.task_list_id = null;
+        else if (targetProjectId && targetProjectId !== current.project_id)
+          updates.task_list_id = null;
+        const task = updateWithOptionalVersion(resolvedId, updates, version);
+        return { content: [{ type: "text", text: formatTask(task) }] };
+      } catch (e) {
+        return { content: [{ type: "text", text: formatError(e) }], isError: true };
+      }
+    });
+  }
   if (shouldRegisterTool("reschedule_task")) {
     server.tool("reschedule_task", "Update a task's deadline.", {
       task_id: exports_external.string().describe("Task ID"),
@@ -43692,6 +43768,7 @@ function registerTaskMetaTools(server, ctx) {
           complete_task: "complete_task \u2014 Mark task completed. Params: task_id, confidence, completed_at, version",
           cancel_task: "cancel_task \u2014 Cancel a task. Params: task_id, version",
           reassign_task: "reassign_task \u2014 Change task assignee. Params: task_id, new_assignee, version",
+          move_task: "move_task \u2014 Re-parent a task to another project and/or task list (keeps its id and history). Params: task_id (required), to_project, to_list, clear_list, version",
           reschedule_task: "reschedule_task \u2014 Update deadline. Params: task_id, deadline, version",
           prioritize_task: "prioritize_task \u2014 Set priority. Params: task_id, priority, version",
           search_tasks: "search_tasks \u2014 Full-text search. Params: query, project_id, status, limit",
@@ -71247,6 +71324,7 @@ var REGISTERED_CANONICAL_COMMANDS = [
   "manual",
   "mcp",
   "mine",
+  "move",
   "next",
   "notifications",
   "onboarding",
@@ -71382,6 +71460,7 @@ var REMOTE_COMMANDS = new Set([
   "lists",
   "lock",
   "log-progress",
+  "move",
   "next",
   "plans",
   "project-rename",