@braingrid/cli 0.2.37 → 0.2.38

package/CHANGELOG.md

@@ -7,6 +7,24 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.2.38] - 2026-02-17
+
+### Added
+
+- **`--content` option for `requirement update` command**
+  - Allows updating a requirement's content directly from the CLI with `--content`
+- **Parallel mode with agent teams for `/build` command**
+  - `/build` now supports a parallel execution mode that spawns agent teams for concurrent task implementation
+- **Verify acceptance criteria hook in Claude Code setup**
+  - `braingrid setup claude-code` now installs a hook that verifies acceptance criteria during builds
+- **PostToolUse TaskUpdate prompt hook in Claude Code setup**
+  - Setup installs a prompt hook that updates task status on PostToolUse events
+
+### Changed
+
+- **Synced README and Claude Code guide with CLI implementation**
+  - Documentation updated to reflect latest CLI features and usage
+
 ## [0.2.37] - 2026-02-14
 
 ### Added

package/README.md

@@ -1,9 +1,10 @@
 <div align="center">
-<img src="https://www.braingrid.ai/logos/braingrid-symbol-800.png" width="100"/>
+<img src="https://www.braingrid.ai/brand/symbol-lime-on-jungle.svg" width="80" height="80"/>
   <h1>BrainGrid</h1>
 
-  <p>Prompt AI Coding Tools Like a Rockstar Developer</p>
-  <h3>A CLI to turn messy thoughts into detailed specs and perfectly-prompted tasks to build well-structured, maintainable software with AI.</h3>
+  <p>The AI Product Planner</p>
+  <h3>BrainGrid is the AI Product Planner that helps you shape ideas, plan features,
+and scope tasks that your AI coding tools can build right the first time.</h3>
 
 [![npm version](https://img.shields.io/npm/v/@braingrid/cli.svg?color=blue&logo=npm)](https://www.npmjs.com/package/@braingrid/cli)
 [![Downloads](https://img.shields.io/npm/dm/@braingrid/cli.svg?color=green)](https://www.npmjs.com/package/@braingrid/cli)
@@ -207,18 +208,24 @@ braingrid specify -p PROJ-123 --prompt "Implement real-time notifications"
 # Output in different formats:
 braingrid specify --prompt "Add dark mode support" --format json
 braingrid specify --prompt "Add export feature" --format markdown
+braingrid specify --prompt "Add search" --tags "search,backend"
 
 # Working with the initialized project
-braingrid requirement list [--status IDEA|PLANNED|IN_PROGRESS|REVIEW|COMPLETED|CANCELLED] [--format json]
-braingrid requirement create --name "Name" [--content "Description"] [--assigned-to <uuid>]
+braingrid requirement list [--status IDEA|PLANNED|IN_PROGRESS|REVIEW|COMPLETED|CANCELLED] [--tree] [--format json]
+braingrid requirement create --name "Name" [--content "Description"] [--assigned-to <uuid>] [--tags "tag1,tag2"]
 braingrid requirement show [id]
-braingrid requirement update [id] [--status IDEA|PLANNED|IN_PROGRESS|REVIEW|COMPLETED|CANCELLED] [--name "New Name"]
+braingrid requirement update [id] [--status IDEA|PLANNED|IN_PROGRESS|REVIEW|COMPLETED|CANCELLED] [--name "New Name"] [--content "markdown"]
 braingrid requirement delete [id] [--force]
-braingrid requirement breakdown [id]
+braingrid requirement breakdown [id] [--format markdown|json|xml]
 braingrid requirement build [id] [--format markdown|json|xml]
 braingrid requirement create-branch [id] [--name <branch-name>] [--base <branch>]
 braingrid requirement review [id] [--pr <number>]
 
+# Tag management
+braingrid requirement tag list [id]
+braingrid requirement tag add [id] --name "Tag" --color "#FF0000"
+braingrid requirement tag remove [id] --name "Tag"
+
 # Working with a different project:
 braingrid requirement list -p PROJ-456 [--status PLANNED]
 braingrid requirement create -p PROJ-456 --name "Description"
@@ -241,9 +248,11 @@ braingrid requirement create -p PROJ-456 --name "Description"
 ```bash
 # Working with the initialized project
 braingrid task list -r REQ-456 [--format table|json|xml|markdown]
-braingrid task create -r REQ-456 --title "Task Title" [--content "Description"]
-braingrid task show <id>
-braingrid task update <id> [--status PLANNED|IN_PROGRESS|COMPLETED|CANCELLED] [--title "New Title"]
+braingrid task create -r REQ-456 --title "Task Title" [--content "Description"] [--external-id <id>]
+braingrid task show [id]
+braingrid task update [id] [--status PLANNED|IN_PROGRESS|COMPLETED|CANCELLED] [--title "New Title"] [--external-id <id>]
+braingrid task summary -r REQ-456
+braingrid task specify -r REQ-456 --prompt "Task description"
 braingrid task delete <id> [--force]
 
 # Working with a different project:
@@ -256,6 +265,14 @@ braingrid task create -p PROJ-123 -r REQ-456 --title "Task Title"
 > **Note:** The `-r`/`--requirement` parameter is optional and accepts formats like `REQ-456`, `req-456`, or `456`. The CLI will automatically detect the requirement ID from your git branch name (e.g., `feature/REQ-123-description` or `REQ-123-fix-bug`) if it is not provided.
 >
 > **Note:** Task status values are: `PLANNED`, `IN_PROGRESS`, `COMPLETED`, `CANCELLED` (tasks do not have `IDEA` or `REVIEW` status).
+>
+> **Note:** `task summary` shows a compact overview table (number, status, title) without full content — useful for quick progress checks.
+>
+> **Note:** `task specify` creates a single AI-generated task from a prompt (10-5000 characters), similar to how `specify` creates requirements.
+>
+> **Note:** The `requirement tag` commands manage tags on requirements. Each requirement can have up to 5 tags. Tags require a name and hex color code (e.g., `#FF0000`).
+>
+> **Note:** `--external-id` links tasks to external systems (e.g., Claude Code task IDs) for status synchronization.
 
 ### Informational Commands
 
@@ -318,7 +335,7 @@ eval "$(braingrid completion zsh)"
 ### What Gets Completed
 
 - **Commands**: `login`, `logout`, `project`, `requirement`, `task`, etc.
-- **Subcommands**: `list`, `show`, `create`, `update`, `delete`, `breakdown`, `build`, `create-branch`, `review`
+- **Subcommands**: `list`, `show`, `create`, `update`, `delete`, `breakdown`, `build`, `create-branch`, `review`, `summary`, `specify`, `tag`
 - **Options**: `--help`, `--format`, `--status`, `--project`, `--requirement`
 - **Values**: Status values (`IDEA`, `PLANNED`, `IN_PROGRESS`, etc.), format options (`table`, `json`, `xml`, `markdown`)
 

package/dist/cli.js

@@ -222,7 +222,7 @@ async function axiosWithRetry(config2, options) {
 
 // src/build-config.ts
 var BUILD_ENV = true ? "production" : process.env.NODE_ENV === "test" ? "development" : "production";
-var CLI_VERSION = true ? "0.2.37" : "0.0.0-test";
+var CLI_VERSION = true ? "0.2.38" : "0.0.0-test";
 var PRODUCTION_CONFIG = {
   apiUrl: "https://app.braingrid.ai",
   workosAuthUrl: "https://auth.braingrid.ai",
@@ -2679,7 +2679,18 @@ async function copyBraingridReadme(targetPath = ".braingrid/README.md") {
     return false;
   }
 }
-async function updateClaudeSettings(settingsPath = ".claude/settings.json", scriptPath2 = ".claude/statusline.sh", hookScriptPath = ".claude/hooks/sync-braingrid-task.sh", createHookScriptPath = ".claude/hooks/create-braingrid-task.sh") {
+var TASK_UPDATE_CONTINUATION_PROMPT = `After every task status change, follow these rules:
+
+1. **On completion**: Verify you committed your changes and updated the task subject with the commit hash (e.g. 'TASK 2 (abc1234): feat: add login'). If you forgot to commit, do it now before moving on.
+
+2. **Continue immediately**: After completing a task, check TaskList for the next pending task. Mark it as in_progress and start implementing it right away. Do NOT stop to ask the user for permission.
+
+3. **Do not stop until done**: Keep iterating through tasks until ALL tasks are completed. The only valid reason to pause is a genuine blocking question that cannot be answered from the requirement, task descriptions, or codebase.
+
+4. **Never ask to continue**: Do NOT say 'Would you like me to continue?', 'Ready for the next task?', 'Shall I proceed?', or any variation. Just continue.
+
+$ARGUMENTS`;
+async function updateClaudeSettings(settingsPath = ".claude/settings.json", scriptPath2 = ".claude/statusline.sh", hookScriptPath = ".claude/hooks/sync-braingrid-task.sh", createHookScriptPath = ".claude/hooks/create-braingrid-task.sh", verifyHookScriptPath = ".claude/hooks/verify-acceptance-criteria.sh") {
   try {
     let settings = {};
     try {
@@ -2703,6 +2714,10 @@ async function updateClaudeSettings(settingsPath = ".claude/settings.json", scri
           type: "command",
           command: hookScriptPath,
           timeout: 1e4
+        },
+        {
+          type: "prompt",
+          prompt: TASK_UPDATE_CONTINUATION_PROMPT
         }
       ]
     };
@@ -2765,10 +2780,24 @@ async function updateClaudeSettings(settingsPath = ".claude/settings.json", scri
     } else {
       mergedPreToolUse = [...mergedPreToolUse, ourPreToolUseTaskUpdateEntry];
     }
+    const ourStopHookEntry = {
+      hooks: [
+        {
+          type: "command",
+          command: verifyHookScriptPath
+        }
+      ]
+    };
+    const existingStop = Array.isArray(existingHooks.Stop) ? existingHooks.Stop : [];
+    const hasVerifyHook = existingStop.some(
+      (entry) => entry.hooks?.some((h) => h.command?.includes("verify-acceptance-criteria"))
+    );
+    const mergedStop = hasVerifyHook ? existingStop : [...existingStop, ourStopHookEntry];
     settings.hooks = {
       ...existingHooks,
       PreToolUse: mergedPreToolUse,
-      PostToolUse: mergedPostToolUse
+      PostToolUse: mergedPostToolUse,
+      Stop: mergedStop
     };
     const parentDir = path2.dirname(settingsPath);
     await fs2.mkdir(parentDir, { recursive: true });
@@ -3572,8 +3601,21 @@ async function handleSetupClaudeCode(opts) {
         error instanceof Error ? error.message : String(error)
       );
     }
+    let verifyHookInstalled = false;
+    try {
+      const verifyContent = await fetchFileFromGitHub(
+        "claude-code/hooks/verify-acceptance-criteria.sh"
+      );
+      await installHookScript(verifyContent, ".claude/hooks/verify-acceptance-criteria.sh");
+      verifyHookInstalled = true;
+    } catch (error) {
+      console.error(
+        chalk8.yellow("\u26A0\uFE0F  Failed to install verify hook:"),
+        error instanceof Error ? error.message : String(error)
+      );
+    }
     const statusLineMessage = statusLineInstalled ? chalk8.dim("  Status line: .claude/statusline.sh\n") : "";
-    const hooksMessage = (syncHookInstalled ? chalk8.dim("  Hook script: .claude/hooks/sync-braingrid-task.sh\n") : "") + (createHookInstalled ? chalk8.dim("  Hook script: .claude/hooks/create-braingrid-task.sh\n") : "");
+    const hooksMessage = (syncHookInstalled ? chalk8.dim("  Hook script: .claude/hooks/sync-braingrid-task.sh\n") : "") + (createHookInstalled ? chalk8.dim("  Hook script: .claude/hooks/create-braingrid-task.sh\n") : "") + (verifyHookInstalled ? chalk8.dim("  Hook script: .claude/hooks/verify-acceptance-criteria.sh\n") : "");
     return {
       success: true,
       message: buildSuccessMessage(config2, displayPerDir, statusLineMessage + hooksMessage)
@@ -6739,10 +6781,12 @@ async function handleRequirementUpdate(opts) {
         message: chalk14.red("\u274C Not authenticated. Please run `braingrid login` first.")
       };
     }
-    if (!opts.status && !opts.name) {
+    if (!opts.status && !opts.name && !opts.content) {
       return {
         success: false,
-        message: chalk14.red("\u274C Please provide at least one field to update (--status or --name)")
+        message: chalk14.red(
+          "\u274C Please provide at least one field to update (--status, --name, or --content)"
+        )
       };
     }
     const requirementResult = await workspaceManager.getRequirement(opts.id);
@@ -6765,7 +6809,8 @@ async function handleRequirementUpdate(opts) {
     stopSpinner = showSpinner("Updating requirement", chalk14.gray);
     const requirement2 = await requirementService.updateProjectRequirement(projectId, normalizedId, {
       status: opts.status,
-      name: opts.name
+      name: opts.name,
+      content: opts.content
     });
     stopSpinner();
     stopSpinner = null;
@@ -8488,7 +8533,7 @@ requirement.command("create").description("Create a new requirement").option(
 requirement.command("update [id]").description("Update requirement information (auto-detects ID from git branch if not provided)").option("-p, --project <id>", "project ID (auto-detects from workspace if not specified)").option(
   "--status <status>",
   "new status (IDEA, PLANNED, IN_PROGRESS, REVIEW, COMPLETED, CANCELLED)"
-).option("--name <name>", "new requirement name").action(async (id, opts) => {
+).option("--name <name>", "new requirement name").option("-c, --content <content>", "new requirement content (markdown)").action(async (id, opts) => {
   const result = await handleRequirementUpdate({ ...opts, id });
   console.log(result.message);
   if (!result.success) {