@khangal.j/fireside-cli 0.0.5 → 0.0.6

package/dist/index.js

@@ -708,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(
@@ -873,13 +938,25 @@ 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) {
@@ -1015,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(
@@ -1084,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();
@@ -1095,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);
@@ -1116,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(
@@ -1133,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) {
@@ -1153,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(
@@ -1179,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
           )

package/package.json

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