@braingrid/cli 0.2.40 → 0.2.42

package/CHANGELOG.md

@@ -7,6 +7,25 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.2.42] - 2026-02-17
+
+### Added
+
+- **SessionStart and TaskCompleted hook installation** — `braingrid setup claude-code` now installs two additional hook scripts: `check-stale-build-sentinel.sh` (SessionStart) for cleaning up stale build sentinels, and `task-completed-validate.sh` (TaskCompleted) for commit validation before marking tasks complete
+- **Sync script updated** — `sync-claude-code-to-braingrid.sh` now syncs 16 files (up from 14), including the two new hook scripts
+
+## [0.2.41] - 2026-02-17
+
+### Fixed
+
+- **Tasks invisible to teammates in parallel build mode** — reordered `/build` command to discover tasks and select mode before calling `TaskCreate`; in parallel mode, `TeamCreate` now runs first so tasks land in the team's task list instead of the default session list
+- **Acceptance criteria format** — checklist files now use `## Acceptance Criteria` heading with `- []` list items; updated `verify-acceptance-criteria.sh` grep patterns to match new format
+- **Renamed teammate agents** — parallel build teammates renamed from `builder-{n}` to `braingrid-builder-{n}` for clarity
+
+### Changed
+
+- **Update handler uses subprocess for IDE setup** — `braingrid update` now runs IDE setup via a spawned subprocess so the newly installed binary is used instead of the old code still loaded in memory
+
 ## [0.2.40] - 2026-02-17
 
 ### Fixed

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.40" : "0.0.0-test";
+var CLI_VERSION = true ? "0.2.42" : "0.0.0-test";
 var PRODUCTION_CONFIG = {
   apiUrl: "https://app.braingrid.ai",
   workosAuthUrl: "https://auth.braingrid.ai",
@@ -2679,7 +2679,7 @@ 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", verifyHookScriptPath = ".claude/hooks/verify-acceptance-criteria.sh", postTaskUpdatePromptPath = ".claude/hooks/post-task-update-prompt.sh", preTaskCreatePath = ".claude/hooks/pre-task-create-naming.sh", preTaskUpdatePath = ".claude/hooks/pre-task-update-instructions.sh") {
+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", postTaskUpdatePromptPath = ".claude/hooks/post-task-update-prompt.sh", preTaskCreatePath = ".claude/hooks/pre-task-create-naming.sh", preTaskUpdatePath = ".claude/hooks/pre-task-update-instructions.sh", sessionStartPath = ".claude/hooks/check-stale-build-sentinel.sh", taskCompletedPath = ".claude/hooks/task-completed-validate.sh") {
   try {
     let settings = {};
     try {
@@ -2782,11 +2782,39 @@ async function updateClaudeSettings(settingsPath = ".claude/settings.json", scri
       (entry) => entry.hooks?.some((h) => h.command?.includes("verify-acceptance-criteria"))
     );
     const mergedStop = hasVerifyHook ? existingStop : [...existingStop, ourStopHookEntry];
+    const ourSessionStartEntry = {
+      hooks: [
+        {
+          type: "command",
+          command: sessionStartPath
+        }
+      ]
+    };
+    const existingSessionStart = Array.isArray(existingHooks.SessionStart) ? existingHooks.SessionStart : [];
+    const hasSessionStartHook = existingSessionStart.some(
+      (entry) => entry.hooks?.some((h) => h.command?.includes("check-stale-build-sentinel"))
+    );
+    const mergedSessionStart = hasSessionStartHook ? existingSessionStart : [...existingSessionStart, ourSessionStartEntry];
+    const ourTaskCompletedEntry = {
+      hooks: [
+        {
+          type: "command",
+          command: taskCompletedPath
+        }
+      ]
+    };
+    const existingTaskCompleted = Array.isArray(existingHooks.TaskCompleted) ? existingHooks.TaskCompleted : [];
+    const hasTaskCompletedHook = existingTaskCompleted.some(
+      (entry) => entry.hooks?.some((h) => h.command?.includes("task-completed-validate"))
+    );
+    const mergedTaskCompleted = hasTaskCompletedHook ? existingTaskCompleted : [...existingTaskCompleted, ourTaskCompletedEntry];
     settings.hooks = {
       ...existingHooks,
       PreToolUse: mergedPreToolUse,
       PostToolUse: mergedPostToolUse,
-      Stop: mergedStop
+      Stop: mergedStop,
+      SessionStart: mergedSessionStart,
+      TaskCompleted: mergedTaskCompleted
     };
     const parentDir = path2.dirname(settingsPath);
     await fs2.mkdir(parentDir, { recursive: true });
@@ -3645,8 +3673,34 @@ async function handleSetupClaudeCode(opts) {
         error instanceof Error ? error.message : String(error)
       );
     }
+    let sessionStartInstalled = false;
+    try {
+      const sessionStartContent = await fetchFileFromGitHub(
+        "claude-code/hooks/check-stale-build-sentinel.sh"
+      );
+      await installHookScript(sessionStartContent, ".claude/hooks/check-stale-build-sentinel.sh");
+      sessionStartInstalled = true;
+    } catch (error) {
+      console.error(
+        chalk8.yellow("\u26A0\uFE0F  Failed to install session-start hook:"),
+        error instanceof Error ? error.message : String(error)
+      );
+    }
+    let taskCompletedInstalled = false;
+    try {
+      const taskCompletedContent = await fetchFileFromGitHub(
+        "claude-code/hooks/task-completed-validate.sh"
+      );
+      await installHookScript(taskCompletedContent, ".claude/hooks/task-completed-validate.sh");
+      taskCompletedInstalled = true;
+    } catch (error) {
+      console.error(
+        chalk8.yellow("\u26A0\uFE0F  Failed to install task-completed 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") : "") + (verifyHookInstalled ? chalk8.dim("  Hook script: .claude/hooks/verify-acceptance-criteria.sh\n") : "") + (preTaskCreateInstalled ? chalk8.dim("  Hook script: .claude/hooks/pre-task-create-naming.sh\n") : "") + (preTaskUpdateInstalled ? chalk8.dim("  Hook script: .claude/hooks/pre-task-update-instructions.sh\n") : "") + (postTaskUpdateInstalled ? chalk8.dim("  Hook script: .claude/hooks/post-task-update-prompt.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") : "") + (preTaskCreateInstalled ? chalk8.dim("  Hook script: .claude/hooks/pre-task-create-naming.sh\n") : "") + (preTaskUpdateInstalled ? chalk8.dim("  Hook script: .claude/hooks/pre-task-update-instructions.sh\n") : "") + (postTaskUpdateInstalled ? chalk8.dim("  Hook script: .claude/hooks/post-task-update-prompt.sh\n") : "") + (sessionStartInstalled ? chalk8.dim("  Hook script: .claude/hooks/check-stale-build-sentinel.sh\n") : "") + (taskCompletedInstalled ? chalk8.dim("  Hook script: .claude/hooks/task-completed-validate.sh\n") : "");
     return {
       success: true,
       message: buildSuccessMessage(config2, displayPerDir, statusLineMessage + hooksMessage)
@@ -3694,6 +3748,7 @@ async function handleSetupCursor(opts) {
 }
 
 // src/handlers/update.handlers.ts
+import { execSync as execSync2 } from "child_process";
 import { confirm } from "@inquirer/prompts";
 import chalk9 from "chalk";
 
@@ -3802,6 +3857,18 @@ function executeUpdate(pm, packageName) {
 }
 
 // src/handlers/update.handlers.ts
+function runSetupSubprocess(subcommand) {
+  try {
+    const output = execSync2(`braingrid setup ${subcommand} --force`, {
+      stdio: "pipe",
+      timeout: 6e4
+    });
+    return output.toString();
+  } catch (error) {
+    const msg = error instanceof Error ? error.message : String(error);
+    return chalk9.yellow(`\u26A0\uFE0F  Setup ${subcommand} failed: ${msg}`);
+  }
+}
 async function promptForIdeUpdates() {
   const cliTools = await checkInstalledCliTools();
   const claudeInstalled = cliTools.find((t) => t.command === "claude")?.installed;
@@ -3813,9 +3880,8 @@ async function promptForIdeUpdates() {
       default: true
     });
     if (shouldUpdate) {
-      const result = await handleSetupClaudeCode({ force: true });
       setupOutput += `
-${result.message}`;
+${runSetupSubprocess("claude-code")}`;
     }
   }
   if (cursorInstalled) {
@@ -3824,9 +3890,8 @@ ${result.message}`;
       default: true
     });
     if (shouldUpdate) {
-      const result = await handleSetupCursor({ force: true });
       setupOutput += `
-${result.message}`;
+${runSetupSubprocess("cursor")}`;
     }
   }
   return setupOutput;