@khangal.j/fireside-cli 0.0.3 → 0.0.5

package/README.md

@@ -22,6 +22,7 @@ fireside tasks list
 fireside tasks list --project personal
 fireside tasks get <task-id>
 fireside tasks get <task-id> --context
+fireside tasks get <task-id> --handoff
 fireside tasks create --project personal --board main --column maybe --title "Ship CLI"
 fireside tasks update <task-id> --title "Ship task CLI"
 fireside tasks delete <task-id>
@@ -31,13 +32,14 @@ fireside tasks handoff create <task-id> --to @alice --summary "Ready for review"
 ## Task Commands
 
 - `fireside tasks list [--project <project>] [--board <board>] [--column <column>] [--json]`
-- `fireside tasks get <task-id> [--project <project>] [--context] [--json]`
+- `fireside tasks get <task-id> [--project <project>] [--context] [--handoff] [--json]`
 - `fireside tasks create --project <project> --column <column> --title <title> [--board <board>] [--description <text> | --description-file <path>] [--due-date YYYY-MM-DD] [--assignee <member>]... [--json]`
 - `fireside tasks update <task-id> [--project <project>] [--title <title>] [--description <text> | --description-file <path> | --clear-description] [--due-date YYYY-MM-DD | --clear-due-date] [--assignee <member>]... [--clear-assignees] [--json]`
 - `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)}`,
@@ -197,6 +223,14 @@ async function createTaskHandoff(baseUrl, accessToken, projectId, boardId, taskI
     }
   );
 }
+async function listTaskHandoffs(baseUrl, accessToken, projectId, boardId, taskId) {
+  return requestJson(
+    `${baseUrl}/api/projects/${encodeURIComponent(projectId)}/boards/${encodeURIComponent(boardId)}/tasks/${encodeURIComponent(taskId)}/handoffs`,
+    {
+      headers: getAuthHeaders(accessToken)
+    }
+  );
+}
 async function listAssignedTasks(baseUrl, accessToken) {
   return requestJson(`${baseUrl}/api/my-stuff`, {
     headers: getAuthHeaders(accessToken)
@@ -475,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);
@@ -511,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;
 }
@@ -608,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) {
@@ -634,7 +665,7 @@ function flattenTaskEntries(projectBoardsResults) {
     )
   ).sort(compareTaskEntries);
 }
-function serializeTaskEntry(taskEntry, contextRevision) {
+function serializeTaskEntry(taskEntry, contextRevision, taskHandoff) {
   return {
     board: {
       id: taskEntry.board.id,
@@ -646,6 +677,7 @@ function serializeTaskEntry(taskEntry, contextRevision) {
       title: taskEntry.column.title
     },
     ...contextRevision !== void 0 ? { contextRevision } : {},
+    ...taskHandoff !== void 0 ? { handoff: taskHandoff } : {},
     project: {
       color: taskEntry.project.color,
       id: taskEntry.project.id,
@@ -690,7 +722,7 @@ function printTaskSummary(taskEntry) {
   }
   console.log("");
 }
-function printTaskDetails(taskEntry, contextRevision) {
+function printTaskDetails(taskEntry, contextRevision, taskHandoff) {
   console.log(formatHeading(taskEntry.task.title, taskEntry.task.id));
   printKeyValue("  Project", import_picocolors.default.cyan(taskEntry.project.title));
   printKeyValue("  Board", taskEntry.board.title);
@@ -700,10 +732,7 @@ function printTaskDetails(taskEntry, contextRevision) {
     taskEntry.task.dueDate ? import_picocolors.default.yellow(formatDueDate(taskEntry.task.dueDate)) : import_picocolors.default.dim("None")
   );
   printKeyValue("  Assignees", formatMemberList(taskEntry.task.assignees));
-  printKeyValue(
-    "  Description",
-    taskEntry.task.description || import_picocolors.default.dim("None")
-  );
+  printKeyValue("  Description", taskEntry.task.description || import_picocolors.default.dim("None"));
   if (contextRevision !== void 0) {
     printKeyValue(
       "  Task context",
@@ -714,6 +743,26 @@ function printTaskDetails(taskEntry, contextRevision) {
       console.log(contextRevision.contentMarkdown);
     }
   }
+  if (taskHandoff !== void 0) {
+    printKeyValue(
+      "  Active handoff",
+      taskHandoff ? import_picocolors.default.cyan(taskHandoff.id) : import_picocolors.default.dim("None")
+    );
+    if (taskHandoff) {
+      printKeyValue("  Handoff status", import_picocolors.default.cyan(taskHandoff.status));
+      printKeyValue("  Handoff from", formatMember(taskHandoff.fromUser));
+      printKeyValue("  Handoff to", formatMember(taskHandoff.toUser));
+      printKeyValue(
+        "  Handoff next assignee",
+        formatMember(taskHandoff.nextAssigneeUser)
+      );
+      printKeyValue("  Handoff summary", taskHandoff.summary);
+      if (taskHandoff.contextMarkdown) {
+        console.log("");
+        console.log(taskHandoff.contextMarkdown);
+      }
+    }
+  }
 }
 function printTaskHandoff(taskEntry, taskHandoff) {
   console.log(formatHeading(taskEntry.task.title, taskEntry.task.id));
@@ -724,10 +773,7 @@ function printTaskHandoff(taskEntry, taskHandoff) {
   printKeyValue("  Status", import_picocolors.default.cyan(taskHandoff.status));
   printKeyValue("  From", formatMember(taskHandoff.fromUser));
   printKeyValue("  To", formatMember(taskHandoff.toUser));
-  printKeyValue(
-    "  Next assignee",
-    formatMember(taskHandoff.nextAssigneeUser)
-  );
+  printKeyValue("  Next assignee", formatMember(taskHandoff.nextAssigneeUser));
   console.log(`  ${taskHandoff.summary}`);
 }
 async function readTextFile(filePath, label) {
@@ -749,6 +795,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();
@@ -783,6 +881,37 @@ async function resolveTaskEntry(baseUrl, accessToken, taskId, projectSelector) {
   }
   return taskEntries[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();
   if (!trimmedSelector.length) {
@@ -878,10 +1007,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}`);
     }
@@ -922,10 +1048,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 () => {
@@ -944,9 +1069,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));
   })
 );
@@ -1029,7 +1153,7 @@ 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").action(
+  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(
     async (taskId, options) => {
       const { accessToken, baseUrl } = await loadCliContext(options.baseUrl);
       const taskEntry = await resolveTaskEntry(
@@ -1045,24 +1169,31 @@ addBaseUrlOption(
         taskEntry.board.id,
         taskId
       ) : void 0;
+      const taskHandoff = options.handoff ? (await listTaskHandoffs(
+        baseUrl,
+        accessToken,
+        taskEntry.project.id,
+        taskEntry.board.id,
+        taskId
+      )).find((handoff) => handoff.status === "active") || null : void 0;
       if (options.json) {
         console.log(
           JSON.stringify(
-            serializeTaskEntry(taskEntry, contextRevision),
+            serializeTaskEntry(taskEntry, contextRevision, taskHandoff),
             null,
             2
           )
         );
         return;
       }
-      printTaskDetails(taskEntry, contextRevision);
+      printTaskDetails(taskEntry, contextRevision, taskHandoff);
     }
   )
 );
 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(
@@ -1073,7 +1204,10 @@ addBaseUrlOption(
         accessToken,
         options.project
       );
-      const board = resolveBoard(projectBoardsResult.boardsData.boards, options.board);
+      const board = resolveBoard(
+        projectBoardsResult.boardsData.boards,
+        options.board
+      );
       const column = resolveColumn(board.columns, options.column);
       const description = await resolveTextInput(
         options.description,
@@ -1114,10 +1248,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(
@@ -1152,7 +1478,11 @@ addBaseUrlOption(
         options.descriptionFile,
         "description"
       );
-      const assigneeIds = options.clearAssignees ? [] : options.assignee.length ? resolveProjectMemberIds(taskEntry.members, options.assignee, user.id) : taskEntry.task.assignees.map((assignee) => assignee.id);
+      const assigneeIds = options.clearAssignees ? [] : options.assignee.length ? resolveProjectMemberIds(
+        taskEntry.members,
+        options.assignee,
+        user.id
+      ) : taskEntry.task.assignees.map((assignee) => assignee.id);
       const updatedTask = await updateTask(
         baseUrl,
         accessToken,
@@ -1171,7 +1501,9 @@ addBaseUrlOption(
         task: updatedTask
       };
       if (options.json) {
-        console.log(JSON.stringify(serializeTaskEntry(updatedTaskEntry), null, 2));
+        console.log(
+          JSON.stringify(serializeTaskEntry(updatedTaskEntry), null, 2)
+        );
         return;
       }
       printSuccess("Updated task.");
@@ -1179,6 +1511,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) => {
@@ -1228,7 +1612,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(
@@ -1247,7 +1631,11 @@ addBaseUrlOption(
           "Handoff context is required. Pass `--context` or `--context-file`."
         );
       }
-      const toUser = resolveProjectMember(taskEntry.members, options.to, user.id);
+      const toUser = resolveProjectMember(
+        taskEntry.members,
+        options.to,
+        user.id
+      );
       if (toUser.id === user.id) {
         throw new Error("Choose another project member for `--to`.");
       }
@@ -1271,7 +1659,11 @@ addBaseUrlOption(
       );
       if (options.json) {
         console.log(
-          JSON.stringify(serializeTaskHandoff(taskEntry, taskHandoff), null, 2)
+          JSON.stringify(
+            serializeTaskHandoff(taskEntry, taskHandoff),
+            null,
+            2
+          )
         );
         return;
       }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@khangal.j/fireside-cli",
-  "version": "0.0.3",
+  "version": "0.0.5",
   "description": "Fireside CLI",
   "license": "MIT",
   "private": false,
@@ -30,6 +30,7 @@
     "picocolors": "^1.1.1"
   },
   "devDependencies": {
+    "@types/node": "^25.6.0",
     "tsup": "^8.5.0"
   }
 }