@khangal.j/fireside-cli 0.0.4 → 0.0.6

package/README.md

@@ -38,7 +38,8 @@ fireside tasks handoff create <task-id> --to @alice --summary "Ready for review"
 - `fireside tasks delete <task-id> [--project <project>] [--json]`
 - `fireside tasks handoff create <task-id> --to <member> --summary <summary> [--project <project>] [--next <member>] [--context <markdown> | --context-file <path>] [--json]`
 
-Member selectors accept a user id, email, `@username`, or `me`.
+Member selectors accept `@username`, email, user id, or `me`.
+CLI text output prefers usernames so the assignable handle stays visible.
 For handoffs, `--to` must be another project member.
 
 By default, the CLI talks to:

package/dist/index.js

@@ -154,6 +154,19 @@ async function createTask(baseUrl, accessToken, projectId, boardId, input) {
     }
   );
 }
+async function createTasks(baseUrl, accessToken, projectId, boardId, inputs) {
+  return requestJson(
+    `${baseUrl}/api/projects/${encodeURIComponent(projectId)}/boards/${encodeURIComponent(boardId)}/tasks/bulk`,
+    {
+      method: "POST",
+      headers: {
+        ...getAuthHeaders(accessToken),
+        "content-type": "application/json"
+      },
+      body: JSON.stringify({ tasks: inputs })
+    }
+  );
+}
 async function updateTask(baseUrl, accessToken, projectId, boardId, taskId, input) {
   return requestJson(
     `${baseUrl}/api/projects/${encodeURIComponent(projectId)}/boards/${encodeURIComponent(boardId)}/tasks/${encodeURIComponent(taskId)}`,
@@ -167,6 +180,19 @@ async function updateTask(baseUrl, accessToken, projectId, boardId, taskId, inpu
     }
   );
 }
+async function moveTask(baseUrl, accessToken, projectId, boardId, taskId, input) {
+  return requestJson(
+    `${baseUrl}/api/projects/${encodeURIComponent(projectId)}/boards/${encodeURIComponent(boardId)}/tasks/${encodeURIComponent(taskId)}`,
+    {
+      method: "PATCH",
+      headers: {
+        ...getAuthHeaders(accessToken),
+        "content-type": "application/json"
+      },
+      body: JSON.stringify(input)
+    }
+  );
+}
 async function deleteTask(baseUrl, accessToken, projectId, boardId, taskId) {
   return requestJson(
     `${baseUrl}/api/projects/${encodeURIComponent(projectId)}/boards/${encodeURIComponent(boardId)}/tasks/${encodeURIComponent(taskId)}`,
@@ -483,6 +509,9 @@ function formatCode(code) {
 function formatUsername(username) {
   return username ? import_picocolors.default.cyan(`@${username}`) : import_picocolors.default.dim("Not set");
 }
+function formatUserHandle(user) {
+  return user.username ? import_picocolors.default.cyan(`@${user.username}`) : import_picocolors.default.cyan(user.email);
+}
 function formatHeading(title, id) {
   if (!id) {
     return import_picocolors.default.bold(title);
@@ -519,12 +548,6 @@ function formatProjectMarker(color) {
   const formatter = colorFormatters[color] || ((value) => value);
   return formatter("o");
 }
-function formatNames(names) {
-  if (!names.length) {
-    return import_picocolors.default.dim("None");
-  }
-  return names.map((name) => import_picocolors.default.cyan(name)).join(import_picocolors.default.dim(", "));
-}
 function formatUserCodeForDisplay(userCode) {
   return userCode.match(/.{1,4}/g)?.join("-") || userCode;
 }
@@ -616,7 +639,7 @@ function uniqueStrings(values) {
   return [...new Set(values)];
 }
 function formatMember(member) {
-  return member.username ? `${member.name} ${import_picocolors.default.cyan(`@${member.username}`)}` : member.name;
+  return formatUserHandle(member);
 }
 function formatMemberList(members) {
   if (!members.length) {
@@ -685,6 +708,71 @@ function serializeTaskHandoff(taskEntry, taskHandoff) {
     }
   };
 }
+function shortId(id) {
+  return id.slice(0, 8);
+}
+function leanAssignees(assignees) {
+  return assignees.map(
+    (member) => member.username ? `@${member.username}` : member.email
+  );
+}
+function serializeTaskRow(taskEntry) {
+  const assignees = leanAssignees(taskEntry.task.assignees);
+  return {
+    id: shortId(taskEntry.task.id),
+    title: taskEntry.task.title,
+    project: taskEntry.project.title,
+    board: taskEntry.board.title,
+    column: taskEntry.column.title,
+    role: taskEntry.column.role,
+    position: taskEntry.task.position,
+    ...taskEntry.task.dueDate ? { dueDate: taskEntry.task.dueDate } : {},
+    ...assignees.length ? { assignees } : {},
+    ...taskEntry.task.description ? { hasDescription: true } : {}
+  };
+}
+function serializeAssignedRow(task) {
+  const assignees = leanAssignees(task.assignees);
+  return {
+    id: shortId(task.id),
+    title: task.title,
+    project: task.projectTitle,
+    board: task.boardTitle,
+    column: task.columnTitle,
+    ...task.dueDate ? { dueDate: task.dueDate } : {},
+    ...assignees.length ? { assignees } : {},
+    ...task.description ? { hasDescription: true } : {}
+  };
+}
+function leanHandoff(handoff) {
+  const handle = (user) => user.username ? `@${user.username}` : user.email;
+  return {
+    id: handoff.id,
+    status: handoff.status,
+    summary: handoff.summary,
+    from: handle(handoff.fromUser),
+    to: handle(handoff.toUser),
+    next: handle(handoff.nextAssigneeUser),
+    contextMarkdown: handoff.contextMarkdown,
+    createdAt: handoff.createdAt
+  };
+}
+function serializeTaskFull(taskEntry, contextRevision, taskHandoff) {
+  return {
+    id: taskEntry.task.id,
+    title: taskEntry.task.title,
+    project: taskEntry.project.title,
+    board: taskEntry.board.title,
+    column: taskEntry.column.title,
+    role: taskEntry.column.role,
+    position: taskEntry.task.position,
+    dueDate: taskEntry.task.dueDate,
+    assignees: leanAssignees(taskEntry.task.assignees),
+    description: taskEntry.task.description,
+    ...contextRevision !== void 0 ? { contextRevision } : {},
+    ...taskHandoff !== void 0 ? { handoff: taskHandoff ? leanHandoff(taskHandoff) : null } : {}
+  };
+}
 function printTaskSummary(taskEntry) {
   console.log(formatHeading(taskEntry.task.title, taskEntry.task.id));
   console.log(
@@ -772,6 +860,58 @@ async function resolveTextInput(value, filePath, label) {
   }
   return value;
 }
+function coerceAssignees(value, label) {
+  if (value === void 0 || value === null) {
+    return void 0;
+  }
+  if (typeof value === "string") {
+    return value.trim() ? [value.trim()] : [];
+  }
+  if (Array.isArray(value) && value.every((entry) => typeof entry === "string")) {
+    return value;
+  }
+  throw new Error(
+    `${label}: \`assignees\` must be a string or array of strings.`
+  );
+}
+function normalizeBulkTaskRow(value, label) {
+  if (typeof value === "string") {
+    return { title: value.trim() };
+  }
+  if (!value || typeof value !== "object" || Array.isArray(value)) {
+    return { title: "" };
+  }
+  const row = value;
+  const optionalString = (key) => typeof row[key] === "string" ? row[key] : void 0;
+  return {
+    title: typeof row.title === "string" ? row.title.trim() : "",
+    description: optionalString("description"),
+    column: optionalString("column"),
+    dueDate: optionalString("dueDate") ?? optionalString("due-date"),
+    assignees: coerceAssignees(row.assignees, label)
+  };
+}
+function parseBulkTaskRows(content) {
+  const trimmed = content.trim();
+  if (!trimmed) {
+    return [];
+  }
+  let parsedJson;
+  try {
+    parsedJson = JSON.parse(trimmed);
+  } catch {
+    return trimmed.split(/\r?\n/).map((line) => line.trim()).filter((line) => line.length > 0 && !line.startsWith("#")).map((line) => ({ title: line }));
+  }
+  const rows = Array.isArray(parsedJson) ? parsedJson : parsedJson && typeof parsedJson === "object" && "tasks" in parsedJson ? parsedJson.tasks : void 0;
+  if (!Array.isArray(rows)) {
+    throw new Error(
+      'Tasks file must be a JSON array, a `{ "tasks": [...] }` object, or one title per line.'
+    );
+  }
+  return rows.map(
+    (row, index) => normalizeBulkTaskRow(row, `Task ${index + 1}`)
+  );
+}
 async function loadCliContext(baseUrl) {
   const state = await requireAuthState();
   const configState = await loadConfigState();
@@ -798,13 +938,56 @@ async function loadProjectBoardsResults(baseUrl, accessToken, projectSelector) {
   );
 }
 async function resolveTaskEntry(baseUrl, accessToken, taskId, projectSelector) {
-  const taskEntries = flattenTaskEntries(
+  const allEntries = flattenTaskEntries(
     await loadProjectBoardsResults(baseUrl, accessToken, projectSelector)
-  ).filter((taskEntry) => taskEntry.task.id === taskId);
-  if (!taskEntries.length) {
+  );
+  const trimmed = taskId.trim();
+  let matches = allEntries.filter((taskEntry) => taskEntry.task.id === trimmed);
+  if (!matches.length && trimmed.length >= 4) {
+    matches = allEntries.filter(
+      (taskEntry) => taskEntry.task.id.startsWith(trimmed)
+    );
+  }
+  if (!matches.length) {
     throw new Error(`Task ${taskId} was not found.`);
   }
-  return taskEntries[0];
+  if (matches.length > 1) {
+    throw new Error(
+      `Task id "${taskId}" is ambiguous (${matches.length} matches). Use more characters or the full id.`
+    );
+  }
+  return matches[0];
+}
+function parseTargetPosition(value) {
+  if (value === void 0) {
+    return 0;
+  }
+  const position = Number(value);
+  if (!Number.isInteger(position) || position < 0) {
+    throw new Error("`--position` must be a non-negative integer.");
+  }
+  return position;
+}
+async function runTaskMove(baseUrl, accessToken, taskEntry, targetColumn, targetPosition, json) {
+  const movedTask = await moveTask(
+    baseUrl,
+    accessToken,
+    taskEntry.project.id,
+    taskEntry.board.id,
+    taskEntry.task.id,
+    { targetColumnId: targetColumn.id, targetPosition }
+  );
+  const movedTaskEntry = {
+    ...taskEntry,
+    column: targetColumn,
+    task: movedTask
+  };
+  if (json) {
+    console.log(JSON.stringify(serializeTaskEntry(movedTaskEntry), null, 2));
+    return;
+  }
+  printSuccess(`Moved task to ${targetColumn.title}.`);
+  printTaskSummary(movedTaskEntry);
 }
 function resolveProjectMember(members, selector, currentUserId) {
   const trimmedSelector = selector.trim();
@@ -901,10 +1084,7 @@ function printAssignedTasks(tasks, projectFilter) {
     if (task.dueDate) {
       printKeyValue("  Due", import_picocolors.default.yellow(formatDueDate(task.dueDate)));
     }
-    printKeyValue(
-      "  Assignees",
-      formatNames(task.assignees.map((assignee) => assignee.name))
-    );
+    printKeyValue("  Assignees", formatMemberList(task.assignees));
     if (task.description) {
       console.log(`  ${task.description}`);
     }
@@ -912,7 +1092,7 @@ function printAssignedTasks(tasks, projectFilter) {
   }
 }
 var program = new import_commander.Command();
-program.name("fireside").description("Fireside CLI").version("0.0.2").configureOutput({
+program.name("fireside").description("Fireside CLI").version("0.0.6").configureOutput({
   outputError: (message, write) => write(import_picocolors.default.red(message))
 }).showHelpAfterError();
 addBaseUrlOption(
@@ -945,10 +1125,9 @@ addBaseUrlOption(
       createdAt: (/* @__PURE__ */ new Date()).toISOString()
     });
     const user = await getCurrentUser(baseUrl, accessToken);
-    printSuccess(`Signed in as ${import_picocolors.default.bold(user.email)}.`);
-    if (user.username) {
-      printKeyValue("Username", formatUsername(user.username));
-    }
+    printSuccess(`Signed in as ${import_picocolors.default.bold(formatUserHandle(user))}.`);
+    printKeyValue("Email", import_picocolors.default.cyan(user.email));
+    printKeyValue("Username", formatUsername(user.username));
   })
 );
 program.command("logout").description("Remove the local CLI session").action(async () => {
@@ -967,9 +1146,8 @@ addBaseUrlOption(
     const baseUrl = await resolveBaseUrl(options.baseUrl, configState);
     const user = await getCurrentUser(baseUrl, state.accessToken);
     printKeyValue("Base URL", formatUrl(baseUrl));
-    printSuccess(
-      `Signed in as ${import_picocolors.default.bold(user.name)} <${import_picocolors.default.cyan(user.email)}>`
-    );
+    printSuccess(`Signed in as ${import_picocolors.default.bold(formatUserHandle(user))}.`);
+    printKeyValue("Email", import_picocolors.default.cyan(user.email));
     printKeyValue("Username", formatUsername(user.username));
   })
 );
@@ -983,7 +1161,7 @@ addBaseUrlOption(
   })
 );
 addBaseUrlOption(
-  program.command("my-stuff").description("List tasks currently assigned to you").option("--json", "Print assigned tasks as JSON").option("-p, --project <project>", "Filter by project id or title").action(
+  program.command("my-stuff").description("List tasks currently assigned to you").option("--json", "Print assigned tasks as compact JSON").option("--raw", "With --json, print the full unabridged shape (larger)").option("-p, --project <project>", "Filter by project id or title").action(
     async (options) => {
       const state = await requireAuthState();
       const configState = await loadConfigState();
@@ -994,7 +1172,11 @@ addBaseUrlOption(
         options.project
       );
       if (options.json) {
-        console.log(JSON.stringify(filteredTasks, null, 2));
+        if (options.raw) {
+          console.log(JSON.stringify(filteredTasks, null, 2));
+        } else {
+          console.log(JSON.stringify(filteredTasks.map(serializeAssignedRow)));
+        }
         return;
       }
       printAssignedTasks(filteredTasks, options.project);
@@ -1015,7 +1197,7 @@ addBaseUrlOption(
 );
 var tasksCommand = program.command("tasks").description("Interact with tasks");
 addBaseUrlOption(
-  tasksCommand.command("list").description("List accessible tasks").option("--json", "Print tasks as JSON").option("-p, --project <project>", "Filter by project id or title").option("--board <board>", "Filter by board id or title").option("--column <column>", "Filter by column id or title").action(
+  tasksCommand.command("list").description("List accessible tasks").option("--json", "Print tasks as compact JSON").option("--raw", "With --json, print the full unabridged shape (larger)").option("-p, --project <project>", "Filter by project id or title").option("--board <board>", "Filter by board id or title").option("--column <column>", "Filter by column id or title").action(
     async (options) => {
       const { accessToken, baseUrl } = await loadCliContext(options.baseUrl);
       let taskEntries = flattenTaskEntries(
@@ -1032,13 +1214,21 @@ addBaseUrlOption(
         );
       }
       if (options.json) {
-        console.log(
-          JSON.stringify(
-            taskEntries.map((taskEntry) => serializeTaskEntry(taskEntry)),
-            null,
-            2
-          )
-        );
+        if (options.raw) {
+          console.log(
+            JSON.stringify(
+              taskEntries.map((taskEntry) => serializeTaskEntry(taskEntry)),
+              null,
+              2
+            )
+          );
+        } else {
+          console.log(
+            JSON.stringify(
+              taskEntries.map((taskEntry) => serializeTaskRow(taskEntry))
+            )
+          );
+        }
         return;
       }
       if (!taskEntries.length) {
@@ -1052,7 +1242,48 @@ addBaseUrlOption(
   )
 );
 addBaseUrlOption(
-  tasksCommand.command("get <taskId>").description("Show a task by id").option("--json", "Print the task as JSON").option("-p, --project <project>", "Limit lookup to a project id or title").option("--context", "Load the latest saved task context").option("--handoff", "Load the active handoff context").action(
+  tasksCommand.command("columns").description("List a board's columns (id, role, title) without tasks").option("--json", "Print columns as JSON").option("-p, --project <project>", "Filter by project id or title").option("--board <board>", "Board id or title").action(
+    async (options) => {
+      const { accessToken, baseUrl } = await loadCliContext(options.baseUrl);
+      const [projectBoardsResult] = await loadProjectBoardsResults(
+        baseUrl,
+        accessToken,
+        options.project
+      );
+      if (!projectBoardsResult) {
+        printWarning("No project found.");
+        return;
+      }
+      const board = resolveBoard(
+        projectBoardsResult.boardsData.boards,
+        options.board
+      );
+      const columns = [...board.columns].sort(
+        (left, right) => left.position - right.position
+      );
+      if (options.json) {
+        console.log(
+          JSON.stringify(
+            columns.map((column) => ({
+              id: column.id,
+              role: column.role,
+              title: column.title
+            }))
+          )
+        );
+        return;
+      }
+      console.log(
+        formatHeading(`${projectBoardsResult.project.title} / ${board.title}`)
+      );
+      for (const column of columns) {
+        console.log(`  ${import_picocolors.default.dim(column.role.padEnd(8))} ${column.title}`);
+      }
+    }
+  )
+);
+addBaseUrlOption(
+  tasksCommand.command("get <taskId>").description("Show a task by id (accepts a short id prefix)").option("--json", "Print the task as JSON").option("--raw", "With --json, print the full unabridged shape (larger)").option("-p, --project <project>", "Limit lookup to a project id or title").option("--context", "Load the latest saved task context").option("--handoff", "Load the active handoff context").action(
     async (taskId, options) => {
       const { accessToken, baseUrl } = await loadCliContext(options.baseUrl);
       const taskEntry = await resolveTaskEntry(
@@ -1078,7 +1309,7 @@ addBaseUrlOption(
       if (options.json) {
         console.log(
           JSON.stringify(
-            serializeTaskEntry(taskEntry, contextRevision, taskHandoff),
+            options.raw ? serializeTaskEntry(taskEntry, contextRevision, taskHandoff) : serializeTaskFull(taskEntry, contextRevision, taskHandoff),
             null,
             2
           )
@@ -1092,7 +1323,7 @@ addBaseUrlOption(
 addBaseUrlOption(
   tasksCommand.command("create").description("Create a task").requiredOption("-p, --project <project>", "Project id or title").requiredOption("-t, --title <title>", "Task title").requiredOption("-c, --column <column>", "Column id or title").option("--board <board>", "Board id or title").option("--description <description>", "Task description").option("--description-file <path>", "Read task description from a file").option("--due-date <date>", "Due date in YYYY-MM-DD format").option(
     "-a, --assignee <member>",
-    "Assign a member by id, email, @username, or me",
+    "Assign a member by @username, email, id, or me",
     collectOptionValue,
     []
   ).option("--json", "Print the created task as JSON").action(
@@ -1147,10 +1378,202 @@ addBaseUrlOption(
     }
   )
 );
+addBaseUrlOption(
+  tasksCommand.command("bulk-create").description("Create many tasks at once from a file").requiredOption("-p, --project <project>", "Project id or title").requiredOption(
+    "--file <path>",
+    "Tasks file: JSON array, `{ tasks: [...] }`, or one title per line"
+  ).option("--board <board>", "Board id or title").option(
+    "-c, --column <column>",
+    "Default column id or title for rows without their own"
+  ).option(
+    "--due-date <date>",
+    "Default due date (YYYY-MM-DD) for rows without their own"
+  ).option(
+    "-a, --assignee <member>",
+    "Default assignee (@username, email, id, or me) for rows without their own",
+    collectOptionValue,
+    []
+  ).option(
+    "--continue-on-error",
+    "Best-effort: create row by row and keep going on failures (non-atomic)"
+  ).option("--dry-run", "Resolve and preview tasks without creating them").option("--json", "Print results as JSON").action(
+    async (options) => {
+      const { accessToken, baseUrl, user } = await loadCliContextWithCurrentUser(options.baseUrl);
+      const rows = parseBulkTaskRows(
+        await readTextFile(options.file, "tasks")
+      );
+      if (!rows.length) {
+        throw new Error("No tasks found in the file.");
+      }
+      const [projectBoardsResult] = await loadProjectBoardsResults(
+        baseUrl,
+        accessToken,
+        options.project
+      );
+      const board = resolveBoard(
+        projectBoardsResult.boardsData.boards,
+        options.board
+      );
+      const members = projectBoardsResult.boardsData.members;
+      const resolved = [];
+      const failed = [];
+      rows.forEach((row, index) => {
+        const label = row.title || `Task ${index + 1}`;
+        try {
+          if (!row.title) {
+            throw new Error("Task title is required.");
+          }
+          const column = resolveColumn(
+            board.columns,
+            row.column ?? options.column
+          );
+          const assigneeIds = resolveProjectMemberIds(
+            members,
+            row.assignees ?? options.assignee,
+            user.id
+          );
+          resolved.push({
+            column,
+            input: {
+              assigneeIds,
+              boardColumnId: column.id,
+              description: row.description ?? "",
+              dueDate: row.dueDate ?? options.dueDate ?? "",
+              title: row.title
+            }
+          });
+        } catch (error) {
+          failed.push({
+            error: error instanceof Error ? error.message : String(error),
+            title: label
+          });
+        }
+      });
+      const toTaskEntry = (createdTask) => ({
+        board,
+        column: board.columns.find(
+          (column) => column.id === createdTask.boardColumnId
+        ) ?? board.columns[0],
+        members,
+        project: projectBoardsResult.project,
+        task: createdTask
+      });
+      if (options.dryRun) {
+        if (options.json) {
+          console.log(
+            JSON.stringify(
+              {
+                failed,
+                plan: resolved.map(({ column, input }) => ({
+                  boardColumnId: input.boardColumnId,
+                  column: column.title,
+                  dueDate: input.dueDate || null,
+                  title: input.title
+                }))
+              },
+              null,
+              2
+            )
+          );
+        } else {
+          printInfo(
+            `Dry run: ${resolved.length} task(s) ready for ${projectBoardsResult.project.title} / ${board.title}.`
+          );
+          for (const { column, input } of resolved) {
+            console.log(
+              `  ${import_picocolors.default.green("+")} ${input.title} ${import_picocolors.default.dim(`(${column.title})`)}`
+            );
+          }
+          for (const failure of failed) {
+            console.log(
+              `  ${import_picocolors.default.red("x")} ${failure.title} ${import_picocolors.default.dim(`\u2014 ${failure.error}`)}`
+            );
+          }
+        }
+        if (failed.length) {
+          process.exitCode = 1;
+        }
+        return;
+      }
+      const created = [];
+      if (options.continueOnError) {
+        for (const { input } of resolved) {
+          try {
+            created.push(
+              await createTask(
+                baseUrl,
+                accessToken,
+                projectBoardsResult.project.id,
+                board.id,
+                input
+              )
+            );
+          } catch (error) {
+            failed.push({
+              error: error instanceof Error ? error.message : String(error),
+              title: input.title
+            });
+          }
+        }
+      } else {
+        if (failed.length) {
+          throw new Error(
+            `${failed.length} task(s) could not be resolved. Fix them or pass --continue-on-error.
+` + failed.map((failure) => `  - ${failure.title}: ${failure.error}`).join("\n")
+          );
+        }
+        created.push(
+          ...await createTasks(
+            baseUrl,
+            accessToken,
+            projectBoardsResult.project.id,
+            board.id,
+            resolved.map(({ input }) => input)
+          )
+        );
+      }
+      const createdEntries = created.map(toTaskEntry);
+      if (options.json) {
+        console.log(
+          JSON.stringify(
+            {
+              created: createdEntries.map(
+                (entry) => serializeTaskEntry(entry)
+              ),
+              failed
+            },
+            null,
+            2
+          )
+        );
+      } else {
+        printSuccess(
+          `Created ${created.length} task(s) in ${projectBoardsResult.project.title} / ${board.title}.`
+        );
+        for (const entry of createdEntries) {
+          console.log(
+            `  ${import_picocolors.default.green("+")} ${entry.task.title} ${import_picocolors.default.dim(`(${entry.column.title})`)}`
+          );
+        }
+        if (failed.length) {
+          printWarning(`${failed.length} task(s) failed:`);
+          for (const failure of failed) {
+            console.log(
+              `  ${import_picocolors.default.red("x")} ${failure.title} ${import_picocolors.default.dim(`\u2014 ${failure.error}`)}`
+            );
+          }
+        }
+      }
+      if (failed.length) {
+        process.exitCode = 1;
+      }
+    }
+  )
+);
 addBaseUrlOption(
   tasksCommand.command("update <taskId>").description("Update a task").option("-p, --project <project>", "Limit lookup to a project id or title").option("-t, --title <title>", "New task title").option("--description <description>", "New task description").option("--description-file <path>", "Read task description from a file").option("--clear-description", "Clear the task description").option("--due-date <date>", "Set the due date in YYYY-MM-DD format").option("--clear-due-date", "Clear the due date").option(
     "-a, --assignee <member>",
-    "Replace assignees using id, email, @username, or me",
+    "Replace assignees using @username, email, id, or me",
     collectOptionValue,
     []
   ).option("--clear-assignees", "Remove all assignees").option("--json", "Print the updated task as JSON").action(
@@ -1218,6 +1641,58 @@ addBaseUrlOption(
     }
   )
 );
+addBaseUrlOption(
+  tasksCommand.command("move <taskId>").description("Move a task to a different column").requiredOption("-c, --column <column>", "Target column id or title").option("-p, --project <project>", "Limit lookup to a project id or title").option("--position <position>", "Target position in the column (0 = top)").option("--json", "Print the moved task as JSON").action(
+    async (taskId, options) => {
+      const { accessToken, baseUrl } = await loadCliContext(options.baseUrl);
+      const taskEntry = await resolveTaskEntry(
+        baseUrl,
+        accessToken,
+        taskId,
+        options.project
+      );
+      const targetColumn = resolveColumn(
+        taskEntry.board.columns,
+        options.column
+      );
+      await runTaskMove(
+        baseUrl,
+        accessToken,
+        taskEntry,
+        targetColumn,
+        parseTargetPosition(options.position),
+        options.json
+      );
+    }
+  )
+);
+addBaseUrlOption(
+  tasksCommand.command("done <taskId>").description("Mark a task done (move it to the board's done column)").option("-p, --project <project>", "Limit lookup to a project id or title").option("--json", "Print the moved task as JSON").action(
+    async (taskId, options) => {
+      const { accessToken, baseUrl } = await loadCliContext(options.baseUrl);
+      const taskEntry = await resolveTaskEntry(
+        baseUrl,
+        accessToken,
+        taskId,
+        options.project
+      );
+      const doneColumn = taskEntry.board.columns.find(
+        (column) => column.role === "done"
+      );
+      if (!doneColumn) {
+        throw new Error("This board has no done column.");
+      }
+      await runTaskMove(
+        baseUrl,
+        accessToken,
+        taskEntry,
+        doneColumn,
+        0,
+        options.json
+      );
+    }
+  )
+);
 addBaseUrlOption(
   tasksCommand.command("delete <taskId>").description("Delete a task").option("-p, --project <project>", "Limit lookup to a project id or title").option("--json", "Print the deleted task metadata as JSON").action(
     async (taskId, options) => {
@@ -1267,7 +1742,7 @@ addBaseUrlOption(
 );
 var taskHandoffCommand = tasksCommand.command("handoff").description("Create and manage task handoffs");
 addBaseUrlOption(
-  taskHandoffCommand.command("create <taskId>").description("Create a handoff for a task").requiredOption("--to <member>", "Target user id, email, or @username").requiredOption("--summary <summary>", "Short handoff summary").option("-p, --project <project>", "Limit lookup to a project id or title").option("--next <member>", "Who should own the task after completion").option("--context <markdown>", "Handoff AI context markdown").option("--context-file <path>", "Read handoff AI context from a file").option("--json", "Print the created handoff as JSON").action(
+  taskHandoffCommand.command("create <taskId>").description("Create a handoff for a task").requiredOption("--to <member>", "Target @username, email, or user id").requiredOption("--summary <summary>", "Short handoff summary").option("-p, --project <project>", "Limit lookup to a project id or title").option("--next <member>", "Next assignee by @username, email, id, or me").option("--context <markdown>", "Handoff AI context markdown").option("--context-file <path>", "Read handoff AI context from a file").option("--json", "Print the created handoff as JSON").action(
     async (taskId, options) => {
       const { accessToken, baseUrl, user } = await loadCliContextWithCurrentUser(options.baseUrl);
       const taskEntry = await resolveTaskEntry(

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@khangal.j/fireside-cli",
-  "version": "0.0.4",
+  "version": "0.0.6",
   "description": "Fireside CLI",
   "license": "MIT",
   "private": false,