@braingrid/cli 0.2.41 → 0.2.42

package/CHANGELOG.md

@@ -7,6 +7,13 @@ 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

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.41" : "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)