@braingrid/cli 0.2.13 → 0.2.16

package/CHANGELOG.md

@@ -7,6 +7,35 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.2.16] - 2025-12-17
+
+### Added
+
+- **--format option for show commands**
+  - Added `--format` option to `requirement show` command
+  - Added `--format` option to `task show` command
+  - Supports all standard formats: table (default), json, xml, markdown
+  - Consistent with other commands that already support `--format`
+
+## [0.2.15] - 2025-12-15
+
+### Changed
+
+- **CI/CD: Switch to OIDC-based npm publishing**
+  - GitHub Actions workflow now uses OpenID Connect (Trusted Publishing) for npm authentication
+  - No longer requires NPM_TOKEN secret - authentication is handled via OIDC
+  - More secure and eliminates token expiration issues
+
+## [0.2.14] - 2025-12-15
+
+### Added
+
+- **Requirement auto-detection for task commands**
+  - Task commands now auto-detect the requirement ID from git branch names (e.g., `feature/REQ-123-something` → `REQ-123`)
+  - Matches the existing behavior of requirement commands
+  - Applies to all task commands: `list`, `summary`, `show`, `create`, `update`, `delete`
+  - Explicit `-r/--requirement` flag still works and takes precedence over auto-detection
+
 ## [0.2.13] - 2025-12-08
 
 ### 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.13" : "0.0.0-test";
+var CLI_VERSION = true ? "0.2.16" : "0.0.0-test";
 var PRODUCTION_CONFIG = {
   apiUrl: "https://app.braingrid.ai",
   workosAuthUrl: "https://auth.braingrid.ai",
@@ -3940,6 +3940,15 @@ async function handleRequirementShow(opts) {
         message: chalk7.red("\u274C Not authenticated. Please run `braingrid login` first.")
       };
     }
+    const format = opts?.format || "table";
+    if (!["table", "json", "xml", "markdown"].includes(format)) {
+      return {
+        success: false,
+        message: chalk7.red(
+          `\u274C Invalid format: ${format}. Supported formats: table, json, xml, markdown`
+        )
+      };
+    }
     const requirementResult = await workspaceManager.getRequirement(opts?.id);
     if (!requirementResult.success) {
       return {
@@ -3961,17 +3970,39 @@ async function handleRequirementShow(opts) {
     const requirement2 = await requirementService.getProjectRequirement(projectId, normalizedId);
     stopSpinner();
     stopSpinner = null;
-    const output = formatRequirementOutput(requirement2, {
-      showDescription: true,
-      showContent: true,
-      showTasks: true,
-      showUpdated: true,
-      apiUrl: config.apiUrl,
-      projectShortId: projectId
-    });
+    let output;
+    switch (format) {
+      case "json": {
+        output = JSON.stringify(requirement2, null, 2);
+        break;
+      }
+      case "xml": {
+        output = formatRequirementBuildXml(requirement2);
+        break;
+      }
+      case "markdown": {
+        output = formatRequirementBuildMarkdown(requirement2, {
+          apiUrl: config.apiUrl,
+          projectShortId: projectId
+        });
+        break;
+      }
+      case "table":
+      default: {
+        output = "\n" + formatRequirementOutput(requirement2, {
+          showDescription: true,
+          showContent: true,
+          showTasks: true,
+          showUpdated: true,
+          apiUrl: config.apiUrl,
+          projectShortId: projectId
+        });
+        break;
+      }
+    }
     return {
       success: true,
-      message: "\n" + output,
+      message: output,
       data: requirement2
     };
   } catch (error) {
@@ -4498,12 +4529,6 @@ async function handleTaskList(opts) {
         message: chalk8.red("\u274C Not authenticated. Please run `braingrid login` first.")
       };
     }
-    if (!opts.requirement) {
-      return {
-        success: false,
-        message: chalk8.red("\u274C No requirement specified.\n\n") + chalk8.dim("Please provide a requirement ID:\n") + chalk8.cyan("braingrid task list -r REQ-456") + chalk8.dim(" (if initialized) or\n") + chalk8.cyan("braingrid task list -r REQ-456 -p PROJ-123")
-      };
-    }
     const workspace = await workspaceManager.getProject(opts.project);
     if (!workspace.success) {
       return {
@@ -4512,7 +4537,14 @@ async function handleTaskList(opts) {
       };
     }
     const projectId = workspace.projectId;
-    const requirementId = normalizeRequirementId(opts.requirement);
+    const requirementResult = await workspaceManager.getRequirement(opts.requirement);
+    if (!requirementResult.success) {
+      return {
+        success: false,
+        message: requirementResult.error
+      };
+    }
+    const requirementId = requirementResult.requirementId;
     stopSpinner = showSpinner("Loading tasks", chalk8.gray);
     const response = await taskService.listTasks(projectId, requirementId);
     stopSpinner();
@@ -4525,7 +4557,7 @@ async function handleTaskList(opts) {
       };
     }
     const projectShortId = projectId;
-    const requirementShortId = opts.requirement;
+    const requirementShortId = opts.requirement || requirementId;
     const format = opts.format || "markdown";
     const config = getConfig();
     const output = formatTasksListOutput(response.tasks, format, true, {
@@ -4560,12 +4592,6 @@ async function handleTaskSummary(opts) {
         message: chalk8.red("\u274C Not authenticated. Please run `braingrid login` first.")
       };
     }
-    if (!opts.requirement) {
-      return {
-        success: false,
-        message: chalk8.red("\u274C No requirement specified.\n\n") + chalk8.dim("Please provide a requirement ID:\n") + chalk8.cyan("braingrid task summary -r REQ-456") + chalk8.dim(" (if initialized) or\n") + chalk8.cyan("braingrid task summary -r REQ-456 -p PROJ-123")
-      };
-    }
     const workspace = await workspaceManager.getProject(opts.project);
     if (!workspace.success) {
       return {
@@ -4574,7 +4600,14 @@ async function handleTaskSummary(opts) {
       };
     }
     const projectId = workspace.projectId;
-    const requirementId = normalizeRequirementId(opts.requirement);
+    const requirementResult = await workspaceManager.getRequirement(opts.requirement);
+    if (!requirementResult.success) {
+      return {
+        success: false,
+        message: requirementResult.error
+      };
+    }
+    const requirementId = requirementResult.requirementId;
     stopSpinner = showSpinner("Loading tasks", chalk8.gray);
     const response = await taskService.listTasks(projectId, requirementId);
     stopSpinner();
@@ -4587,7 +4620,7 @@ async function handleTaskSummary(opts) {
       };
     }
     const projectShortId = projectId;
-    const requirementShortId = opts.requirement;
+    const requirementShortId = opts.requirement || requirementId;
     const config = getConfig();
     const output = formatTasksListOutput(response.tasks, "table", false, {
       requirementId,
@@ -4621,13 +4654,16 @@ async function handleTaskShow(id, opts) {
         message: chalk8.red("\u274C Not authenticated. Please run `braingrid login` first.")
       };
     }
-    if (!opts?.requirement) {
+    const format = opts?.format || "table";
+    if (!["table", "json", "xml", "markdown"].includes(format)) {
       return {
         success: false,
-        message: chalk8.red("\u274C No requirement specified.\n\n") + chalk8.dim("Please provide a requirement ID:\n") + chalk8.cyan("braingrid task show TASK-789 -r REQ-456") + chalk8.dim(" (if initialized) or\n") + chalk8.cyan("braingrid task show TASK-789 -r REQ-456 -p PROJ-123")
+        message: chalk8.red(
+          `\u274C Invalid format: ${format}. Supported formats: table, json, xml, markdown`
+        )
       };
     }
-    const workspace = await workspaceManager.getProject(opts.project);
+    const workspace = await workspaceManager.getProject(opts?.project);
     if (!workspace.success) {
       return {
         success: false,
@@ -4635,20 +4671,48 @@ async function handleTaskShow(id, opts) {
       };
     }
     const projectId = workspace.projectId;
-    const requirementId = normalizeRequirementId(opts.requirement);
+    const requirementResult = await workspaceManager.getRequirement(opts?.requirement);
+    if (!requirementResult.success) {
+      return {
+        success: false,
+        message: requirementResult.error
+      };
+    }
+    const requirementId = requirementResult.requirementId;
     const taskId = normalizeTaskId(id);
     const config = getConfig();
     stopSpinner = showSpinner("Loading task", chalk8.gray);
     const task2 = await taskService.getTask(projectId, requirementId, taskId);
     stopSpinner();
     stopSpinner = null;
-    const output = formatTaskOutput(task2, {
-      showContent: true,
-      apiUrl: config.apiUrl,
-      projectShortId: projectId,
-      requirementShortId: opts.requirement,
-      requirementId
-    });
+    let output;
+    switch (format) {
+      case "json": {
+        output = JSON.stringify(task2, null, 2);
+        break;
+      }
+      case "xml":
+      case "markdown": {
+        output = formatTasksListOutput([task2], format, true, {
+          requirementId,
+          projectShortId: projectId,
+          requirementShortId: opts?.requirement || requirementId,
+          apiUrl: config.apiUrl
+        });
+        break;
+      }
+      case "table":
+      default: {
+        output = formatTaskOutput(task2, {
+          showContent: true,
+          apiUrl: config.apiUrl,
+          projectShortId: projectId,
+          requirementShortId: opts?.requirement || requirementId,
+          requirementId
+        });
+        break;
+      }
+    }
     return {
       success: true,
       message: output,
@@ -4675,12 +4739,6 @@ async function handleTaskCreate(opts) {
         message: chalk8.red("\u274C Not authenticated. Please run `braingrid login` first.")
       };
     }
-    if (!opts.requirement) {
-      return {
-        success: false,
-        message: chalk8.red("\u274C No requirement specified.\n\n") + chalk8.dim("Please provide a requirement ID:\n") + chalk8.cyan('braingrid task create -r REQ-456 --title "..."') + chalk8.dim(" (if initialized) or\n") + chalk8.cyan('braingrid task create -r REQ-456 -p PROJ-123 --title "..."')
-      };
-    }
     const workspace = await workspaceManager.getProject(opts.project);
     if (!workspace.success) {
       return {
@@ -4689,9 +4747,16 @@ async function handleTaskCreate(opts) {
       };
     }
     const projectId = workspace.projectId;
-    const requirementId = normalizeRequirementId(opts.requirement);
+    const requirementResult = await workspaceManager.getRequirement(opts.requirement);
+    if (!requirementResult.success) {
+      return {
+        success: false,
+        message: requirementResult.error
+      };
+    }
+    const requirementId = requirementResult.requirementId;
     const projectShortId = projectId;
-    const requirementShortId = opts.requirement;
+    const requirementShortId = opts.requirement || requirementId;
     const config = getConfig();
     stopSpinner = showSpinner("Creating task", chalk8.gray);
     const task2 = await taskService.createTask(projectId, requirementId, {
@@ -4740,12 +4805,6 @@ async function handleTaskUpdate(id, opts) {
         message: chalk8.red("\u274C Please provide at least one field to update (--status or --title)")
       };
     }
-    if (!opts.requirement) {
-      return {
-        success: false,
-        message: chalk8.red("\u274C No requirement specified.\n\n") + chalk8.dim("Please provide a requirement ID:\n") + chalk8.cyan("braingrid task update TASK-789 -r REQ-456 --status COMPLETED") + chalk8.dim(" (if initialized) or\n") + chalk8.cyan("braingrid task update TASK-789 -r REQ-456 -p PROJ-123 --status COMPLETED")
-      };
-    }
     const workspace = await workspaceManager.getProject(opts.project);
     if (!workspace.success) {
       return {
@@ -4754,7 +4813,14 @@ async function handleTaskUpdate(id, opts) {
       };
     }
     const projectId = workspace.projectId;
-    const requirementId = normalizeRequirementId(opts.requirement);
+    const requirementResult = await workspaceManager.getRequirement(opts.requirement);
+    if (!requirementResult.success) {
+      return {
+        success: false,
+        message: requirementResult.error
+      };
+    }
+    const requirementId = requirementResult.requirementId;
     const taskId = normalizeTaskId(id);
     const config = getConfig();
     stopSpinner = showSpinner("Updating task", chalk8.gray);
@@ -4769,7 +4835,7 @@ async function handleTaskUpdate(id, opts) {
       successMessage: `Updated task ${task2.number}`,
       apiUrl: config.apiUrl,
       projectShortId: projectId,
-      requirementShortId: opts.requirement,
+      requirementShortId: opts.requirement || requirementId,
       requirementId
     });
     return {
@@ -4804,12 +4870,6 @@ async function handleTaskDelete(id, opts) {
         message: chalk8.yellow("\u26A0\uFE0F  Deleting a task is permanent. Use --force to confirm deletion.")
       };
     }
-    if (!opts.requirement) {
-      return {
-        success: false,
-        message: chalk8.red("\u274C No requirement specified.\n\n") + chalk8.dim("Please provide a requirement ID:\n") + chalk8.cyan("braingrid task delete TASK-789 -r REQ-456 --force") + chalk8.dim(" (if initialized) or\n") + chalk8.cyan("braingrid task delete TASK-789 -r REQ-456 -p PROJ-123 --force")
-      };
-    }
     const workspace = await workspaceManager.getProject(opts.project);
     if (!workspace.success) {
       return {
@@ -4818,7 +4878,14 @@ async function handleTaskDelete(id, opts) {
       };
     }
     const projectId = workspace.projectId;
-    const requirementId = normalizeRequirementId(opts.requirement);
+    const requirementResult = await workspaceManager.getRequirement(opts.requirement);
+    if (!requirementResult.success) {
+      return {
+        success: false,
+        message: requirementResult.error
+      };
+    }
+    const requirementId = requirementResult.requirementId;
     const taskId = normalizeTaskId(id);
     stopSpinner = showSpinner("Deleting task", chalk8.gray);
     await taskService.deleteTask(projectId, requirementId, taskId);
@@ -6948,7 +7015,7 @@ requirement.command("list").description("List requirements for a project").optio
 requirement.command("show [id]").description("Show requirement details (auto-detects ID from git branch if not provided)").option(
   "-p, --project <id>",
   "project ID (auto-detects from .braingrid/project.json if not provided)"
-).action(async (id, opts) => {
+).option("--format <format>", "output format (table, json, xml, markdown)", "table").action(async (id, opts) => {
   const result = await handleRequirementShow({ ...opts, id });
   console.log(result.message);
   if (!result.success) {
@@ -7021,7 +7088,7 @@ task.command("summary").description("Show task summary table (quick overview wit
     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)").action(async (id, opts) => {
+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) => {
   const result = await handleTaskShow(id, opts);
   console.log(result.message);
   if (!result.success) {