@khangal.j/fireside-cli 0.0.3 → 0.0.4

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,7 +32,7 @@ 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]`

package/dist/index.js

@@ -197,6 +197,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)
@@ -634,7 +642,7 @@ function flattenTaskEntries(projectBoardsResults) {
     )
   ).sort(compareTaskEntries);
 }
-function serializeTaskEntry(taskEntry, contextRevision) {
+function serializeTaskEntry(taskEntry, contextRevision, taskHandoff) {
   return {
     board: {
       id: taskEntry.board.id,
@@ -646,6 +654,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 +699,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 +709,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 +720,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 +750,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) {
@@ -1029,7 +1052,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,17 +1068,24 @@ 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);
     }
   )
 );
@@ -1073,7 +1103,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,
@@ -1152,7 +1185,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 +1208,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.");
@@ -1247,7 +1286,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 +1314,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.4",
   "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"
   }
 }