@khangal.j/fireside-cli 0.0.5 → 0.0.7

package/dist/index.js

@@ -24,7 +24,7 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
 ));
 
 // src/index.ts
-var import_promises2 = require("fs/promises");
+var import_promises3 = require("fs/promises");
 var import_commander = require("commander");
 var import_picocolors = __toESM(require("picocolors"));
 
@@ -487,6 +487,51 @@ function openBrowser(url) {
   }
 }
 
+// src/lib/project-config.ts
+var import_promises2 = require("fs/promises");
+var import_node_path2 = require("path");
+var PROJECT_CONFIG_FILENAME = ".fireside.json";
+async function loadProjectConfig(startDir = process.cwd()) {
+  const { root } = (0, import_node_path2.parse)(startDir);
+  let dir = startDir;
+  for (; ; ) {
+    const candidate = (0, import_node_path2.join)(dir, PROJECT_CONFIG_FILENAME);
+    try {
+      const raw = await (0, import_promises2.readFile)(candidate, "utf8");
+      return { config: JSON.parse(raw), path: candidate };
+    } catch (error) {
+      const code = error.code;
+      if (error instanceof SyntaxError) {
+        throw new Error(
+          `Invalid ${PROJECT_CONFIG_FILENAME} at ${candidate}: ${error.message}`
+        );
+      }
+      if (code !== "ENOENT") {
+        return null;
+      }
+    }
+    if (dir === root) {
+      return null;
+    }
+    const parent = (0, import_node_path2.dirname)(dir);
+    if (parent === dir) {
+      return null;
+    }
+    dir = parent;
+  }
+}
+async function loadDefaultProject(startDir) {
+  const loaded = await loadProjectConfig(startDir);
+  const project = loaded?.config.project;
+  return typeof project === "string" && project.trim() ? project.trim() : void 0;
+}
+async function writeProjectConfig(dir, config) {
+  const path = (0, import_node_path2.join)(dir, PROJECT_CONFIG_FILENAME);
+  await (0, import_promises2.writeFile)(path, `${JSON.stringify(config, null, 2)}
+`);
+  return path;
+}
+
 // src/index.ts
 function printInfo(message) {
   console.log(`${import_picocolors.default.cyan("[i]")} ${message}`);
@@ -708,6 +753,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(
@@ -778,7 +888,7 @@ function printTaskHandoff(taskEntry, taskHandoff) {
 }
 async function readTextFile(filePath, label) {
   try {
-    return await (0, import_promises2.readFile)(filePath, "utf8");
+    return await (0, import_promises3.readFile)(filePath, "utf8");
   } catch (error) {
     const message = error instanceof Error ? error.message : `Unable to read ${label} file.`;
     throw new Error(`Failed to read ${label} file: ${message}`);
@@ -862,6 +972,23 @@ async function loadCliContextWithCurrentUser(baseUrl) {
     user: await getCurrentUser(cliContext.baseUrl, cliContext.accessToken)
   };
 }
+async function resolveProjectSelector(explicit, allProjects) {
+  if (allProjects) {
+    return void 0;
+  }
+  if (explicit) {
+    return explicit;
+  }
+  return loadDefaultProject();
+}
+function findTaskMatches(entries, taskId) {
+  const trimmed = taskId.trim();
+  const exact = entries.filter((entry) => entry.task.id === trimmed);
+  if (exact.length || trimmed.length < 4) {
+    return exact;
+  }
+  return entries.filter((entry) => entry.task.id.startsWith(trimmed));
+}
 async function loadProjectBoardsResults(baseUrl, accessToken, projectSelector) {
   const projects = await listProjects(baseUrl, accessToken);
   const selectedProjects = projectSelector ? [resolveByIdOrTitle(projects, projectSelector, "project")] : projects;
@@ -873,13 +1000,30 @@ async function loadProjectBoardsResults(baseUrl, accessToken, projectSelector) {
   );
 }
 async function resolveTaskEntry(baseUrl, accessToken, taskId, projectSelector) {
-  const taskEntries = flattenTaskEntries(
-    await loadProjectBoardsResults(baseUrl, accessToken, projectSelector)
-  ).filter((taskEntry) => taskEntry.task.id === taskId);
-  if (!taskEntries.length) {
+  const scoped = await resolveProjectSelector(projectSelector, false);
+  let matches = findTaskMatches(
+    flattenTaskEntries(
+      await loadProjectBoardsResults(baseUrl, accessToken, scoped)
+    ),
+    taskId
+  );
+  if (!matches.length && scoped && !projectSelector) {
+    matches = findTaskMatches(
+      flattenTaskEntries(
+        await loadProjectBoardsResults(baseUrl, accessToken, void 0)
+      ),
+      taskId
+    );
+  }
+  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 +1159,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.7").configureOutput({
   outputError: (message, write) => write(import_picocolors.default.red(message))
 }).showHelpAfterError();
 addBaseUrlOption(
@@ -1084,18 +1228,23 @@ 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").option("--all-projects", "Ignore the default project; span all projects").action(
     async (options) => {
       const state = await requireAuthState();
       const configState = await loadConfigState();
       const baseUrl = await resolveBaseUrl(options.baseUrl, configState);
-      const tasks = await listAssignedTasks(baseUrl, state.accessToken);
-      const filteredTasks = filterAssignedTasksByProject(
-        tasks,
-        options.project
+      const projectFilter = await resolveProjectSelector(
+        options.project,
+        options.allProjects
       );
+      const tasks = await listAssignedTasks(baseUrl, state.accessToken);
+      const filteredTasks = filterAssignedTasksByProject(tasks, projectFilter);
       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);
@@ -1114,13 +1263,50 @@ addBaseUrlOption(
     printProjects(projects);
   })
 );
+var configCommand = program.command("config").description("Manage CLI configuration");
+addBaseUrlOption(
+  configCommand.command("show").description("Show resolved defaults (base URL, default project)").action(async (options) => {
+    const configState = await loadConfigState();
+    const baseUrl = await resolveBaseUrl(options.baseUrl, configState);
+    const loaded = await loadProjectConfig();
+    printKeyValue("Base URL", baseUrl);
+    if (loaded?.config.project) {
+      printKeyValue("Default project", loaded.config.project);
+      printKeyValue("  from", loaded.path);
+    } else {
+      printKeyValue("Default project", import_picocolors.default.dim("Not set"));
+    }
+  })
+);
+addBaseUrlOption(
+  configCommand.command("use-project <project>").description(
+    `Set the default project for this directory (writes ${PROJECT_CONFIG_FILENAME})`
+  ).action(async (project, options) => {
+    const { accessToken, baseUrl } = await loadCliContext(options.baseUrl);
+    const projects = await listProjects(baseUrl, accessToken);
+    const resolved = resolveByIdOrTitle(projects, project, "project");
+    const path = await writeProjectConfig(process.cwd(), {
+      project: resolved.title
+    });
+    printSuccess(`Default project set to ${import_picocolors.default.cyan(resolved.title)}.`);
+    printKeyValue("Wrote", path);
+  })
+);
 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 tasks assigned to you in the default project (.fireside.json)"
+  ).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").option("--all", "Show everyone's tasks across all projects").option("--everyone", "Include tasks not assigned to you").option("--all-projects", "Ignore the default project; span all projects").action(
     async (options) => {
       const { accessToken, baseUrl } = await loadCliContext(options.baseUrl);
+      const includeEveryone = Boolean(options.all || options.everyone);
+      const spanAllProjects = Boolean(options.all || options.allProjects);
+      const projectSelector = await resolveProjectSelector(
+        options.project,
+        spanAllProjects
+      );
       let taskEntries = flattenTaskEntries(
-        await loadProjectBoardsResults(baseUrl, accessToken, options.project)
+        await loadProjectBoardsResults(baseUrl, accessToken, projectSelector)
       );
       if (options.board) {
         taskEntries = taskEntries.filter(
@@ -1132,14 +1318,30 @@ addBaseUrlOption(
           (taskEntry) => matchIdOrTitle(taskEntry.column, options.column)
         );
       }
-      if (options.json) {
-        console.log(
-          JSON.stringify(
-            taskEntries.map((taskEntry) => serializeTaskEntry(taskEntry)),
-            null,
-            2
+      if (!includeEveryone) {
+        const currentUser = await getCurrentUser(baseUrl, accessToken);
+        taskEntries = taskEntries.filter(
+          (taskEntry) => taskEntry.task.assignees.some(
+            (assignee) => assignee.id === currentUser.id
           )
         );
+      }
+      if (options.json) {
+        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 +1355,52 @@ 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 projectSelector = await resolveProjectSelector(
+        options.project,
+        options.allProjects
+      );
+      const [projectBoardsResult] = await loadProjectBoardsResults(
+        baseUrl,
+        accessToken,
+        projectSelector
+      );
+      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 +1426,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
           )
@@ -1191,7 +1438,10 @@ 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(
+  tasksCommand.command("create").description("Create a task").option(
+    "-p, --project <project>",
+    "Project id or title (defaults to .fireside.json)"
+  ).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 @username, email, id, or me",
     collectOptionValue,
@@ -1199,10 +1449,16 @@ addBaseUrlOption(
   ).option("--json", "Print the created task as JSON").action(
     async (options) => {
       const { accessToken, baseUrl, user } = await loadCliContextWithCurrentUser(options.baseUrl);
+      const projectSelector = options.project ?? await loadDefaultProject();
+      if (!projectSelector) {
+        throw new Error(
+          `No project. Pass -p <project> or add ${PROJECT_CONFIG_FILENAME} (\`fireside config use-project <project>\`).`
+        );
+      }
       const [projectBoardsResult] = await loadProjectBoardsResults(
         baseUrl,
         accessToken,
-        options.project
+        projectSelector
       );
       const board = resolveBoard(
         projectBoardsResult.boardsData.boards,
@@ -1249,7 +1505,10 @@ addBaseUrlOption(
   )
 );
 addBaseUrlOption(
-  tasksCommand.command("bulk-create").description("Create many tasks at once from a file").requiredOption("-p, --project <project>", "Project id or title").requiredOption(
+  tasksCommand.command("bulk-create").description("Create many tasks at once from a file").option(
+    "-p, --project <project>",
+    "Project id or title (defaults to .fireside.json)"
+  ).requiredOption(
     "--file <path>",
     "Tasks file: JSON array, `{ tasks: [...] }`, or one title per line"
   ).option("--board <board>", "Board id or title").option(
@@ -1269,6 +1528,12 @@ addBaseUrlOption(
   ).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 projectSelector = options.project ?? await loadDefaultProject();
+      if (!projectSelector) {
+        throw new Error(
+          `No project. Pass -p <project> or add ${PROJECT_CONFIG_FILENAME} (\`fireside config use-project <project>\`).`
+        );
+      }
       const rows = parseBulkTaskRows(
         await readTextFile(options.file, "tasks")
       );
@@ -1278,7 +1543,7 @@ addBaseUrlOption(
       const [projectBoardsResult] = await loadProjectBoardsResults(
         baseUrl,
         accessToken,
-        options.project
+        projectSelector
       );
       const board = resolveBoard(
         projectBoardsResult.boardsData.boards,

package/package.json

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