@braingrid/cli 0.2.35 → 0.2.36

package/CHANGELOG.md

@@ -7,6 +7,21 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.2.36] - 2026-02-14
+
+### Added
+
+- **Add `.braingrid/temp/` to `.gitignore` during init**
+  - `braingrid init` now automatically appends `.braingrid/temp/` to the project's `.gitignore`
+  - Prevents session-specific temp files (e.g., acceptance criteria checklists) from being committed
+  - Skips if the entry already exists; creates `.gitignore` if none exists
+
+### Fixed
+
+- **Always offer Claude Code setup updates during init**
+  - `braingrid init` now prompts to update Claude Code integration even when it's already installed
+  - Ensures users get the latest slash commands, skills, and status line configuration
+
 ## [0.2.35] - 2026-02-14
 
 ### Added

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.35" : "0.0.0-test";
+var CLI_VERSION = true ? "0.2.36" : "0.0.0-test";
 var PRODUCTION_CONFIG = {
   apiUrl: "https://app.braingrid.ai",
   workosAuthUrl: "https://auth.braingrid.ai",
@@ -2198,7 +2198,8 @@ async function handleCompletion(shellArg, opts) {
 }
 
 // src/handlers/init.handlers.ts
-import { access as access3 } from "fs/promises";
+import { access as access3, readFile as readFile2, writeFile as writeFile2 } from "fs/promises";
+import path6 from "path";
 import { confirm as confirm2, input, select as select3 } from "@inquirer/prompts";
 import chalk10 from "chalk";
 
@@ -2543,17 +2544,17 @@ function parseGitHubError(error) {
   }
   return errorMessage;
 }
-async function fetchFileFromGitHub(path6) {
+async function fetchFileFromGitHub(path7) {
   return withRetry(async () => {
     try {
-      const command = `gh api repos/${GITHUB_OWNER}/${GITHUB_REPO}/contents/${path6}`;
+      const command = `gh api repos/${GITHUB_OWNER}/${GITHUB_REPO}/contents/${path7}`;
       const { stdout } = await execAsync(command);
       const response = JSON.parse(stdout);
       if (response.type !== "file") {
-        throw new Error(`Path ${path6} is not a file`);
+        throw new Error(`Path ${path7} is not a file`);
       }
       if (!response.content || !response.encoding) {
-        throw new Error(`No content found for file ${path6}`);
+        throw new Error(`No content found for file ${path7}`);
       }
       if (response.encoding !== "base64") {
         throw new Error(`Unexpected encoding: ${response.encoding}`);
@@ -2562,18 +2563,18 @@ async function fetchFileFromGitHub(path6) {
       return content;
     } catch (error) {
       const parsedError = parseGitHubError(error);
-      throw new Error(`Failed to fetch file ${path6}: ${parsedError}`);
+      throw new Error(`Failed to fetch file ${path7}: ${parsedError}`);
     }
   });
 }
-async function listGitHubDirectory(path6) {
+async function listGitHubDirectory(path7) {
   return withRetry(async () => {
     try {
-      const command = `gh api repos/${GITHUB_OWNER}/${GITHUB_REPO}/contents/${path6}`;
+      const command = `gh api repos/${GITHUB_OWNER}/${GITHUB_REPO}/contents/${path7}`;
       const { stdout } = await execAsync(command);
       const response = JSON.parse(stdout);
       if (!Array.isArray(response)) {
-        throw new Error(`Path ${path6} is not a directory`);
+        throw new Error(`Path ${path7} is not a directory`);
       }
       return response.map((item) => ({
         name: item.name,
@@ -2582,7 +2583,7 @@ async function listGitHubDirectory(path6) {
       }));
     } catch (error) {
       const parsedError = parseGitHubError(error);
-      throw new Error(`Failed to list directory ${path6}: ${parsedError}`);
+      throw new Error(`Failed to list directory ${path7}: ${parsedError}`);
     }
   });
 }
@@ -3409,101 +3410,132 @@ async function installFiles(operations, force) {
   return { installed, skipped, cancelled: false };
 }
 async function _handleSetup(config2, opts) {
-  try {
-    const prerequisiteError = await checkPrerequisites();
-    if (prerequisiteError) {
-      return prerequisiteError;
-    }
-    console.log(chalk8.bold(`\u{1F680} Setting up ${config2.name} integration...
+  const prerequisiteError = await checkPrerequisites();
+  if (prerequisiteError) {
+    return prerequisiteError;
+  }
+  console.log(chalk8.bold(`\u{1F680} Setting up ${config2.name} integration...
 `));
-    const operations = await getFileList(config2.sourceDirs, config2.targetDirs);
-    const injectionFileExists = await fileExists(config2.injection.targetFile);
-    operations.push({
-      type: "inject",
-      sourcePath: config2.injection.sourceFile,
-      targetPath: config2.injection.targetFile,
-      exists: injectionFileExists
-    });
-    displayInstallationPlan(
-      operations.filter((op) => op.type === "copy"),
-      config2.injection.targetFile
+  const operations = await getFileList(config2.sourceDirs, config2.targetDirs);
+  const injectionFileExists = await fileExists(config2.injection.targetFile);
+  operations.push({
+    type: "inject",
+    sourcePath: config2.injection.sourceFile,
+    targetPath: config2.injection.targetFile,
+    exists: injectionFileExists
+  });
+  displayInstallationPlan(
+    operations.filter((op) => op.type === "copy"),
+    config2.injection.targetFile
+  );
+  if (opts.dryRun) {
+    return {
+      success: true,
+      message: chalk8.green("\u2705 Dry-run complete. No files were modified.\n\n") + chalk8.dim(`Would install ${operations.length} files.`)
+    };
+  }
+  const copyOps = operations.filter((op) => op.type === "copy");
+  const result = await installFiles(copyOps, opts.force || false);
+  if (result.cancelled) {
+    return {
+      success: false,
+      message: chalk8.yellow("\u26A0\uFE0F  Installation cancelled.\n\n") + chalk8.dim(`Installed: ${result.installed}, Skipped: ${result.skipped}`),
+      code: "CANCELLED"
+    };
+  }
+  try {
+    const content = await fetchFileFromGitHub(config2.injection.sourceFile);
+    await injectContentIntoFile(config2.injection.targetFile, content);
+  } catch (error) {
+    console.error(
+      chalk8.red(`Failed to inject content into ${config2.injection.targetFile}:`),
+      error instanceof Error ? error.message : String(error)
     );
-    if (opts.dryRun) {
-      return {
-        success: true,
-        message: chalk8.green("\u2705 Dry-run complete. No files were modified.\n\n") + chalk8.dim(`Would install ${operations.length} files.`)
-      };
+  }
+  await copyBraingridReadme();
+  return {
+    success: true,
+    data: {
+      installed: result.installed,
+      skipped: result.skipped
     }
-    const copyOps = operations.filter((op) => op.type === "copy");
-    const result = await installFiles(copyOps, opts.force || false);
-    if (result.cancelled) {
-      return {
-        success: false,
-        message: chalk8.yellow("\u26A0\uFE0F  Installation cancelled.\n\n") + chalk8.dim(`Installed: ${result.installed}, Skipped: ${result.skipped}`),
-        code: "CANCELLED"
-      };
+  };
+}
+function buildSuccessMessage(config2, installed, extras) {
+  return chalk8.green(`\u2705 ${config2.name} integration installed successfully!
+
+`) + chalk8.dim("Files installed:\n") + chalk8.dim(`  Commands: ${installed} files
+`) + extras + chalk8.dim(`  Content injected into: ${config2.injection.targetFile}
+
+`) + chalk8.dim("Next steps:\n") + chalk8.dim("  1. Review the integration files\n") + chalk8.dim(`  2. Open ${config2.name}
+`) + chalk8.dim("  3. Try the /specify or /breakdown commands\n") + chalk8.dim("  4. Learn more: ") + chalk8.cyan(config2.docsUrl);
+}
+function isSetupResult(result) {
+  return "data" in result && result.success === true && !("message" in result);
+}
+async function handleSetupClaudeCode(opts) {
+  const config2 = {
+    name: "Claude Code",
+    sourceDirs: ["claude-code/commands", "claude-code/skills/braingrid-cli"],
+    targetDirs: [".claude/commands", ".claude/skills/braingrid-cli"],
+    injection: {
+      sourceFile: "claude-code/CLAUDE.md",
+      targetFile: "CLAUDE.md"
+    },
+    docsUrl: "https://docs.braingrid.ai/claude-code"
+  };
+  try {
+    const setupResult = await _handleSetup(config2, opts);
+    if (!isSetupResult(setupResult)) {
+      return setupResult;
     }
+    const { installed } = setupResult.data;
+    let statusLineInstalled = false;
     try {
-      const content = await fetchFileFromGitHub(config2.injection.sourceFile);
-      await injectContentIntoFile(config2.injection.targetFile, content);
+      const scriptContent = await fetchFileFromGitHub("claude-code/statusline.sh");
+      await installStatusLineScript(scriptContent);
+      statusLineInstalled = true;
     } catch (error) {
       console.error(
-        chalk8.red(`Failed to inject content into ${config2.injection.targetFile}:`),
+        chalk8.yellow("\u26A0\uFE0F  Failed to install status line script:"),
         error instanceof Error ? error.message : String(error)
       );
     }
-    let statusLineInstalled = false;
-    if (config2.name === "Claude Code") {
-      try {
-        const scriptContent = await fetchFileFromGitHub("claude-code/statusline.sh");
-        await installStatusLineScript(scriptContent);
-        await updateClaudeSettings();
-        statusLineInstalled = true;
-      } catch (error) {
-        console.error(
-          chalk8.yellow("\u26A0\uFE0F  Failed to install status line script:"),
-          error instanceof Error ? error.message : String(error)
-        );
-      }
+    try {
+      await updateClaudeSettings();
+    } catch (error) {
+      console.error(
+        chalk8.yellow("\u26A0\uFE0F  Failed to update Claude settings:"),
+        error instanceof Error ? error.message : String(error)
+      );
     }
     let syncHookInstalled = false;
+    try {
+      const syncContent = await fetchFileFromGitHub("claude-code/hooks/sync-braingrid-task.sh");
+      await installHookScript(syncContent);
+      syncHookInstalled = true;
+    } catch (error) {
+      console.error(
+        chalk8.yellow("\u26A0\uFE0F  Failed to install sync hook:"),
+        error instanceof Error ? error.message : String(error)
+      );
+    }
     let createHookInstalled = false;
-    if (config2.name === "Claude Code") {
-      try {
-        const syncContent = await fetchFileFromGitHub("claude-code/hooks/sync-braingrid-task.sh");
-        await installHookScript(syncContent);
-        syncHookInstalled = true;
-      } catch (error) {
-        console.error(
-          chalk8.yellow("\u26A0\uFE0F  Failed to install sync hook:"),
-          error instanceof Error ? error.message : String(error)
-        );
-      }
-      try {
-        const createContent = await fetchFileFromGitHub(
-          "claude-code/hooks/create-braingrid-task.sh"
-        );
-        await installHookScript(createContent, ".claude/hooks/create-braingrid-task.sh");
-        createHookInstalled = true;
-      } catch (error) {
-        console.error(
-          chalk8.yellow("\u26A0\uFE0F  Failed to install create hook:"),
-          error instanceof Error ? error.message : String(error)
-        );
-      }
+    try {
+      const createContent = await fetchFileFromGitHub("claude-code/hooks/create-braingrid-task.sh");
+      await installHookScript(createContent, ".claude/hooks/create-braingrid-task.sh");
+      createHookInstalled = true;
+    } catch (error) {
+      console.error(
+        chalk8.yellow("\u26A0\uFE0F  Failed to install create hook:"),
+        error instanceof Error ? error.message : String(error)
+      );
     }
-    await copyBraingridReadme();
     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") : "");
     return {
       success: true,
-      message: chalk8.green(`\u2705 ${config2.name} integration installed successfully!
-
-`) + chalk8.dim("Files installed:\n") + chalk8.dim(`  Commands: ${result.installed} files
-`) + statusLineMessage + hooksMessage + chalk8.dim(`  Content injected into: ${config2.injection.targetFile}
-
-`) + chalk8.dim("Next steps:\n") + chalk8.dim("  1. Review the integration files\n") + chalk8.dim(`  2. Open ${config2.name}
-`) + chalk8.dim("  3. Try the /specify or /breakdown commands\n") + chalk8.dim("  4. Learn more: ") + chalk8.cyan(config2.docsUrl)
+      message: buildSuccessMessage(config2, installed, statusLineMessage + hooksMessage)
     };
   } catch (error) {
     const errorMessage = error instanceof Error ? error.message : String(error);
@@ -3513,19 +3545,6 @@ async function _handleSetup(config2, opts) {
     };
   }
 }
-async function handleSetupClaudeCode(opts) {
-  const config2 = {
-    name: "Claude Code",
-    sourceDirs: ["claude-code/commands", "claude-code/skills/braingrid-cli"],
-    targetDirs: [".claude/commands", ".claude/skills/braingrid-cli"],
-    injection: {
-      sourceFile: "claude-code/CLAUDE.md",
-      targetFile: "CLAUDE.md"
-    },
-    docsUrl: "https://docs.braingrid.ai/claude-code"
-  };
-  return _handleSetup(config2, opts);
-}
 async function handleSetupCursor(opts) {
   const config2 = {
     name: "Cursor",
@@ -3537,7 +3556,23 @@ async function handleSetupCursor(opts) {
     },
     docsUrl: "https://docs.braingrid.ai/cursor"
   };
-  return _handleSetup(config2, opts);
+  try {
+    const setupResult = await _handleSetup(config2, opts);
+    if (!isSetupResult(setupResult)) {
+      return setupResult;
+    }
+    const { installed } = setupResult.data;
+    return {
+      success: true,
+      message: buildSuccessMessage(config2, installed, "")
+    };
+  } catch (error) {
+    const errorMessage = error instanceof Error ? error.message : String(error);
+    return {
+      success: false,
+      message: chalk8.red(`\u274C Setup failed: ${errorMessage}`)
+    };
+  }
 }
 
 // src/handlers/update.handlers.ts
@@ -3763,6 +3798,26 @@ async function fileExists2(filePath) {
     return false;
   }
 }
+async function addBraingridTempToGitignore() {
+  const gitRoot = await getGitRoot();
+  if (!gitRoot) return;
+  const gitignorePath = path6.join(gitRoot, ".gitignore");
+  const entry = ".braingrid/temp/";
+  let content = "";
+  try {
+    content = await readFile2(gitignorePath, "utf8");
+  } catch {
+  }
+  const lines = content.split("\n");
+  if (lines.some((line) => line.trim() === entry || line.trim() === ".braingrid/temp")) {
+    return;
+  }
+  const addition = content.endsWith("\n") || content === "" ? "" : "\n";
+  const newContent = `${content}${addition}# BrainGrid temp files
+${entry}
+`;
+  await writeFile2(gitignorePath, newContent, "utf8");
+}
 function getServices() {
   const config2 = getConfig();
   const auth = new BraingridAuth(config2.apiUrl);
@@ -4290,6 +4345,7 @@ async function handleInit(opts) {
       created_at: project2.created_at
     };
     await saveProjectConfig(localConfig);
+    await addBraingridTempToGitignore();
     await copyBraingridReadme();
     console.log(
       chalk10.green("\u2705 Repository initialized successfully!\n\n") + chalk10.dim("Project:    ") + chalk10.cyan(project2.name) + chalk10.dim(` (${project2.short_id})`) + "\n" + chalk10.dim("Config:     ") + chalk10.gray(".braingrid/project.json") + "\n"
@@ -4297,62 +4353,62 @@ async function handleInit(opts) {
     const installedIDEs = await detectInstalledIDEs();
     if (installedIDEs.claudeCode) {
       const claudeSetupExists = await fileExists2(".claude/commands/specify.md");
-      if (!claudeSetupExists) {
+      console.log("");
+      const setupClaude = await confirm2({
+        message: claudeSetupExists ? "Claude Code detected. Update BrainGrid integration?" : "Claude Code detected. Install BrainGrid integration? (slash commands, skills, status line)",
+        default: true
+      });
+      if (setupClaude) {
         console.log("");
-        const setupClaude = await confirm2({
-          message: "Claude Code detected. Install BrainGrid integration? (slash commands, skills, status line)",
-          default: true
-        });
-        if (setupClaude) {
-          console.log("");
-          try {
-            const result = await handleSetupClaudeCode({ force: false });
-            if (result.success) {
-              console.log(result.message);
-            } else {
-              console.log(chalk10.yellow("\u26A0\uFE0F  Claude Code setup was not completed."));
-              console.log(
-                chalk10.dim("You can run ") + chalk10.cyan("braingrid setup claude-code") + chalk10.dim(" later.")
-              );
-            }
-          } catch {
-            console.log(chalk10.yellow("\u26A0\uFE0F  Claude Code setup encountered an error."));
+        try {
+          const result = await handleSetupClaudeCode({
+            force: claudeSetupExists
+          });
+          if (result.success) {
+            console.log(result.message);
+          } else {
+            console.log(chalk10.yellow("\u26A0\uFE0F  Claude Code setup was not completed."));
             console.log(
               chalk10.dim("You can run ") + chalk10.cyan("braingrid setup claude-code") + chalk10.dim(" later.")
             );
           }
-          console.log("");
+        } catch {
+          console.log(chalk10.yellow("\u26A0\uFE0F  Claude Code setup encountered an error."));
+          console.log(
+            chalk10.dim("You can run ") + chalk10.cyan("braingrid setup claude-code") + chalk10.dim(" later.")
+          );
         }
+        console.log("");
       }
     }
     if (installedIDEs.cursor) {
       const cursorSetupExists = await fileExists2(".cursor/commands/specify.md");
-      if (!cursorSetupExists) {
+      console.log("");
+      const setupCursor = await confirm2({
+        message: cursorSetupExists ? "Cursor detected. Update BrainGrid integration?" : "Cursor detected. Install BrainGrid integration? (slash commands, rules, context)",
+        default: true
+      });
+      if (setupCursor) {
         console.log("");
-        const setupCursor = await confirm2({
-          message: "Cursor detected. Install BrainGrid integration? (slash commands, rules, context)",
-          default: true
-        });
-        if (setupCursor) {
-          console.log("");
-          try {
-            const result = await handleSetupCursor({ force: false });
-            if (result.success) {
-              console.log(result.message);
-            } else {
-              console.log(chalk10.yellow("\u26A0\uFE0F  Cursor setup was not completed."));
-              console.log(
-                chalk10.dim("You can run ") + chalk10.cyan("braingrid setup cursor") + chalk10.dim(" later.")
-              );
-            }
-          } catch {
-            console.log(chalk10.yellow("\u26A0\uFE0F  Cursor setup encountered an error."));
+        try {
+          const result = await handleSetupCursor({
+            force: cursorSetupExists
+          });
+          if (result.success) {
+            console.log(result.message);
+          } else {
+            console.log(chalk10.yellow("\u26A0\uFE0F  Cursor setup was not completed."));
             console.log(
               chalk10.dim("You can run ") + chalk10.cyan("braingrid setup cursor") + chalk10.dim(" later.")
             );
           }
-          console.log("");
+        } catch {
+          console.log(chalk10.yellow("\u26A0\uFE0F  Cursor setup encountered an error."));
+          console.log(
+            chalk10.dim("You can run ") + chalk10.cyan("braingrid setup cursor") + chalk10.dim(" later.")
+          );
         }
+        console.log("");
       }
     }
     return {