@braingrid/cli 0.2.17 → 0.2.19

package/CHANGELOG.md

@@ -7,6 +7,40 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.2.19] - 2025-12-17
+
+### Added
+
+- **Pagination options for task commands**
+  - Added `--page` and `--limit` options to `task list` and `task summary` commands
+  - Consistent with existing pagination options on `requirement list`
+
+### Changed
+
+- **has_more pagination warnings**
+  - Task and requirement list commands now show a warning when more items exist beyond current page
+  - Warning message: "⚠️ More tasks/requirements exist. Use --limit to see more."
+  - `getCurrentTask` auto-detection warns if results may be incomplete due to pagination
+
+- **Status line uses higher limit**
+  - Claude Code status line script now fetches up to 100 tasks for accurate counts
+  - Ensures task progress display `[completed/total]` is accurate for larger requirements
+
+## [0.2.18] - 2025-12-17
+
+### Added
+
+- **Current task auto-detection**
+  - `task show` now works without a task ID - automatically detects the current task
+  - `task update` now works without a task ID - updates the current task
+  - Current task is determined by: first IN_PROGRESS task, or first PLANNED task if none in progress
+  - `task delete` still requires explicit task ID for safety
+
+- **Status line shows current task**
+  - Claude Code status line now displays: `BrainGrid: PROJ-X > REQ-Y > TASK-Z [completed/total]`
+  - Shows the current task being worked on alongside progress count
+  - Automatically updates as tasks are completed
+
 ## [0.2.17] - 2025-12-17
 
 ### Added

package/dist/cli.js

@@ -422,7 +422,7 @@ import axios3, { AxiosError as AxiosError2 } from "axios";
 
 // src/build-config.ts
 var BUILD_ENV = true ? "production" : process.env.NODE_ENV === "test" ? "development" : "production";
-var CLI_VERSION = true ? "0.2.17" : "0.0.0-test";
+var CLI_VERSION = true ? "0.2.19" : "0.0.0-test";
 var PRODUCTION_CONFIG = {
   apiUrl: "https://app.braingrid.ai",
   workosAuthUrl: "https://auth.braingrid.ai",
@@ -3914,6 +3914,9 @@ async function handleRequirementList(opts) {
         break;
       }
     }
+    if (response.pagination?.has_more) {
+      output += "\n" + chalk7.yellow("\u26A0\uFE0F More requirements exist. Use --limit to see more.");
+    }
     return {
       success: true,
       message: output,
@@ -4518,6 +4521,29 @@ function getServices3() {
   const taskService = new TaskService(config.apiUrl, auth);
   return { taskService, auth };
 }
+async function getCurrentTask(taskService, projectId, requirementId) {
+  const response = await taskService.listTasks(projectId, requirementId);
+  const inProgress = response.tasks.find((t) => t.status === "IN_PROGRESS");
+  if (inProgress) {
+    const warning = response.pagination?.has_more ? "Note: More tasks exist beyond current page." : void 0;
+    return { success: true, taskId: inProgress.number, warning };
+  }
+  const planned = response.tasks.find((t) => t.status === "PLANNED");
+  if (planned) {
+    const warning = response.pagination?.has_more ? "Note: More tasks exist beyond current page." : void 0;
+    return { success: true, taskId: planned.number, warning };
+  }
+  if (response.pagination?.has_more) {
+    return {
+      success: false,
+      error: "No active task found in current page. More tasks exist - use --limit to fetch more."
+    };
+  }
+  return {
+    success: false,
+    error: "No active task found. All tasks are completed or cancelled."
+  };
+}
 async function handleTaskList(opts) {
   let stopSpinner = null;
   try {
@@ -4546,7 +4572,10 @@ async function handleTaskList(opts) {
     }
     const requirementId = requirementResult.requirementId;
     stopSpinner = showSpinner("Loading tasks", chalk8.gray);
-    const response = await taskService.listTasks(projectId, requirementId);
+    const response = await taskService.listTasks(projectId, requirementId, {
+      page: opts.page ? parseInt(opts.page, 10) : 1,
+      limit: opts.limit ? parseInt(opts.limit, 10) : 20
+    });
     stopSpinner();
     stopSpinner = null;
     if (response.tasks.length === 0) {
@@ -4560,12 +4589,15 @@ async function handleTaskList(opts) {
     const requirementShortId = opts.requirement || requirementId;
     const format = opts.format || "markdown";
     const config = getConfig();
-    const output = formatTasksListOutput(response.tasks, format, true, {
+    let output = formatTasksListOutput(response.tasks, format, true, {
       requirementId,
       projectShortId,
       requirementShortId,
       apiUrl: config.apiUrl
     });
+    if (response.pagination?.has_more) {
+      output += "\n" + chalk8.yellow("\u26A0\uFE0F More tasks exist. Use --limit to see more.");
+    }
     return {
       success: true,
       message: output,
@@ -4609,7 +4641,10 @@ async function handleTaskSummary(opts) {
     }
     const requirementId = requirementResult.requirementId;
     stopSpinner = showSpinner("Loading tasks", chalk8.gray);
-    const response = await taskService.listTasks(projectId, requirementId);
+    const response = await taskService.listTasks(projectId, requirementId, {
+      page: opts.page ? parseInt(opts.page, 10) : 1,
+      limit: opts.limit ? parseInt(opts.limit, 10) : 20
+    });
     stopSpinner();
     stopSpinner = null;
     if (response.tasks.length === 0) {
@@ -4622,12 +4657,15 @@ async function handleTaskSummary(opts) {
     const projectShortId = projectId;
     const requirementShortId = opts.requirement || requirementId;
     const config = getConfig();
-    const output = formatTasksListOutput(response.tasks, "table", false, {
+    let output = formatTasksListOutput(response.tasks, "table", false, {
       requirementId,
       projectShortId,
       requirementShortId,
       apiUrl: config.apiUrl
     });
+    if (response.pagination?.has_more) {
+      output += "\n" + chalk8.yellow("\u26A0\uFE0F More tasks exist. Use --limit to see more.");
+    }
     return {
       success: true,
       message: output,
@@ -4679,7 +4717,21 @@ async function handleTaskShow(id, opts) {
       };
     }
     const requirementId = requirementResult.requirementId;
-    const taskId = normalizeTaskId(id);
+    let taskId;
+    let taskWarning;
+    if (id) {
+      taskId = normalizeTaskId(id);
+    } else {
+      const currentTask = await getCurrentTask(taskService, projectId, requirementId);
+      if (!currentTask.success) {
+        return {
+          success: false,
+          message: chalk8.red(`\u274C ${currentTask.error}`)
+        };
+      }
+      taskId = currentTask.taskId;
+      taskWarning = currentTask.warning;
+    }
     const config = getConfig();
     stopSpinner = showSpinner("Loading task", chalk8.gray);
     const task2 = await taskService.getTask(projectId, requirementId, taskId);
@@ -4713,6 +4765,9 @@ async function handleTaskShow(id, opts) {
         break;
       }
     }
+    if (taskWarning) {
+      output += "\n" + chalk8.yellow(`\u26A0\uFE0F ${taskWarning}`);
+    }
     return {
       success: true,
       message: output,
@@ -4799,13 +4854,13 @@ async function handleTaskUpdate(id, opts) {
         message: chalk8.red("\u274C Not authenticated. Please run `braingrid login` first.")
       };
     }
-    if (!opts.status && !opts.title) {
+    if (!opts?.status && !opts?.title) {
       return {
         success: false,
         message: chalk8.red("\u274C Please provide at least one field to update (--status or --title)")
       };
     }
-    const workspace = await workspaceManager.getProject(opts.project);
+    const workspace = await workspaceManager.getProject(opts?.project);
     if (!workspace.success) {
       return {
         success: false,
@@ -4813,7 +4868,7 @@ async function handleTaskUpdate(id, opts) {
       };
     }
     const projectId = workspace.projectId;
-    const requirementResult = await workspaceManager.getRequirement(opts.requirement);
+    const requirementResult = await workspaceManager.getRequirement(opts?.requirement);
     if (!requirementResult.success) {
       return {
         success: false,
@@ -4821,23 +4876,40 @@ async function handleTaskUpdate(id, opts) {
       };
     }
     const requirementId = requirementResult.requirementId;
-    const taskId = normalizeTaskId(id);
+    let taskId;
+    let taskWarning;
+    if (id) {
+      taskId = normalizeTaskId(id);
+    } else {
+      const currentTask = await getCurrentTask(taskService, projectId, requirementId);
+      if (!currentTask.success) {
+        return {
+          success: false,
+          message: chalk8.red(`\u274C ${currentTask.error}`)
+        };
+      }
+      taskId = currentTask.taskId;
+      taskWarning = currentTask.warning;
+    }
     const config = getConfig();
     stopSpinner = showSpinner("Updating task", chalk8.gray);
     const task2 = await taskService.updateTask(projectId, requirementId, taskId, {
-      status: opts.status,
-      title: opts.title
+      status: opts?.status,
+      title: opts?.title
     });
     stopSpinner();
     stopSpinner = null;
-    const output = formatTaskOutput(task2, {
+    let output = formatTaskOutput(task2, {
       showContent: true,
       successMessage: `Updated task ${task2.number}`,
       apiUrl: config.apiUrl,
       projectShortId: projectId,
-      requirementShortId: opts.requirement || requirementId,
+      requirementShortId: opts?.requirement || requirementId,
       requirementId
     });
+    if (taskWarning) {
+      output += "\n" + chalk8.yellow(`\u26A0\uFE0F ${taskWarning}`);
+    }
     return {
       success: true,
       message: output,
@@ -7168,21 +7240,21 @@ requirement.command("build [id]").description(
   }
 });
 var task = program.command("task").description("Manage tasks");
-task.command("list").description("List tasks for a requirement").option("-r, --requirement <id>", "requirement ID (REQ-456, auto-detects project if initialized)").option("-p, --project <id>", "project ID (PROJ-123, optional if project is initialized)").option("--format <format>", "output format (table, json, xml, markdown)", "markdown").action(async (opts) => {
+task.command("list").description("List tasks for a requirement").option("-r, --requirement <id>", "requirement ID (REQ-456, auto-detects project if initialized)").option("-p, --project <id>", "project ID (PROJ-123, optional if project is initialized)").option("--format <format>", "output format (table, json, xml, markdown)", "markdown").option("--page <page>", "page number for pagination", "1").option("--limit <limit>", "number of tasks per page", "20").action(async (opts) => {
   const result = await handleTaskList(opts);
   console.log(result.message);
   if (!result.success) {
     process.exit(1);
   }
 });
-task.command("summary").description("Show task summary table (quick overview without content)").option("-r, --requirement <id>", "requirement ID (REQ-456, auto-detects project if initialized)").option("-p, --project <id>", "project ID (PROJ-123, optional if project is initialized)").action(async (opts) => {
+task.command("summary").description("Show task summary table (quick overview without content)").option("-r, --requirement <id>", "requirement ID (REQ-456, auto-detects project if initialized)").option("-p, --project <id>", "project ID (PROJ-123, optional if project is initialized)").option("--page <page>", "page number for pagination", "1").option("--limit <limit>", "number of tasks per page", "20").action(async (opts) => {
   const result = await handleTaskSummary(opts);
   console.log(result.message);
   if (!result.success) {
     process.exit(1);
   }
 });
-task.command("show <id>").description("Show task details").option("-r, --requirement <id>", "requirement ID (REQ-456, auto-detects project if initialized)").option("-p, --project <id>", "project ID (PROJ-123, optional if project is initialized)").option("--format <format>", "output format (table, json, xml, markdown)", "table").action(async (id, opts) => {
+task.command("show [id]").description("Show task details (auto-detects current task if not provided)").option("-r, --requirement <id>", "requirement ID (REQ-456, auto-detects project if initialized)").option("-p, --project <id>", "project ID (PROJ-123, optional if project is initialized)").option("--format <format>", "output format (table, json, xml, markdown)", "table").action(async (id, opts) => {
   const result = await handleTaskShow(id, opts);
   console.log(result.message);
   if (!result.success) {
@@ -7196,7 +7268,7 @@ task.command("create").description("Create a new task").option("-r, --requiremen
     process.exit(1);
   }
 });
-task.command("update <id>").description("Update task information").option("-r, --requirement <id>", "requirement ID (REQ-456, auto-detects project if initialized)").option("-p, --project <id>", "project ID (PROJ-123, optional if project is initialized)").option("--status <status>", "new status (PLANNED, IN_PROGRESS, COMPLETED, CANCELLED)").option("--title <title>", "new task title").action(async (id, opts) => {
+task.command("update [id]").description("Update task (auto-detects current task if not provided)").option("-r, --requirement <id>", "requirement ID (REQ-456, auto-detects project if initialized)").option("-p, --project <id>", "project ID (PROJ-123, optional if project is initialized)").option("--status <status>", "new status (PLANNED, IN_PROGRESS, COMPLETED, CANCELLED)").option("--title <title>", "new task title").action(async (id, opts) => {
   const result = await handleTaskUpdate(id, opts);
   console.log(result.message);
   if (!result.success) {