@braingrid/cli 0.2.21 → 0.2.23

package/CHANGELOG.md

@@ -7,6 +7,43 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.2.23] - 2025-12-18
+
+### Added
+
+- **Automatic README.md installation**
+  - Copies `.braingrid/README.md` documentation during `init`, `update`, and `setup` commands
+  - Ensures users always have the latest BrainGrid integration documentation
+  - Fails silently if GitHub is unreachable (non-blocking operation)
+
+## [0.2.22] - 2025-12-18
+
+### Added
+
+- **Task commands documentation**
+  - Added `braingrid task` command examples to CLAUDE.md and AGENTS.md
+  - Documents `task list`, `task show`, and `task update` usage
+
+### Changed
+
+- **IDE integration update prompts**
+  - Now prompts for IDE integration updates even when CLI is already up to date
+  - Ensures users can update BrainGrid integration files independently of CLI version
+
+- **Token efficiency optimizations**
+  - Optimized AGENTS.md and CLAUDE.md for reduced token usage
+  - Moved README.md from `.claude/` to `.braingrid/` for better organization
+
+### Fixed
+
+- **Duplicate BRAINGRID INTEGRATION markers**
+  - Fixed issue where setup could add duplicate integration markers to CLAUDE.md
+  - Content injection now properly checks for existing markers before adding
+
+- **Flaky test in cli-tools**
+  - Fixed parallel timing assertion test that was too strict (50ms → 100ms threshold)
+  - Prevents intermittent test failures in CI environments
+
 ## [0.2.21] - 2025-12-18
 
 ### Fixed

package/README.md

@@ -47,7 +47,7 @@ braingrid setup claude-code
 
 Installs slash commands (`/specify`, `/breakdown`, `/build`), BrainGrid skill, and status line showing your project/requirement/task context in real-time.
 
-[→ Full Claude Code setup guide](./.claude/README.md)
+[→ Full Claude Code setup guide](./.braingrid/README.md)
 
 ### Cursor
 
@@ -115,7 +115,7 @@ The `init` command creates a `.braingrid/project.json` file in the `.braingrid/`
 
 Install BrainGrid integration files for AI coding tools. These commands fetch integration files from the [BrainGrid repository](https://github.com/BrainGridAI/braingrid) and install them in your project.
 
-For detailed usage guides, see [Claude Code setup](./.claude/README.md) or [Cursor setup](./.cursor/README.md).
+For detailed usage guides, see [Claude Code setup](./.braingrid/README.md) or [Cursor setup](./.cursor/README.md).
 
 **Prerequisites:**
 

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.21" : "0.0.0-test";
+var CLI_VERSION = true ? "0.2.23" : "0.0.0-test";
 var PRODUCTION_CONFIG = {
   apiUrl: "https://app.braingrid.ai",
   workosAuthUrl: "https://auth.braingrid.ai",
@@ -5803,6 +5803,14 @@ async function injectContentIntoFile(targetPath, content) {
     } catch {
       fileContent = "";
     }
+    let cleanContent = content;
+    if (content.includes(BEGIN_MARKER)) {
+      const beginIdx = content.indexOf(BEGIN_MARKER);
+      const endIdx = content.indexOf(END_MARKER);
+      if (beginIdx !== -1 && endIdx !== -1 && endIdx > beginIdx) {
+        cleanContent = content.substring(beginIdx + BEGIN_MARKER.length, endIdx).trim();
+      }
+    }
     if (fileExists3) {
       const beginIndex = fileContent.indexOf(BEGIN_MARKER);
       const endIndex = fileContent.indexOf(END_MARKER);
@@ -5810,14 +5818,14 @@ async function injectContentIntoFile(targetPath, content) {
         const before = fileContent.substring(0, beginIndex);
         const after = fileContent.substring(endIndex + END_MARKER.length);
         const newContent = `${before}${BEGIN_MARKER}
-${content}
+${cleanContent}
 ${END_MARKER}${after}`;
         await fs3.writeFile(targetPath, newContent, { encoding: "utf8" });
       } else {
         const newContent = `${fileContent}
 
 ${BEGIN_MARKER}
-${content}
+${cleanContent}
 ${END_MARKER}
 `;
         await fs3.writeFile(targetPath, newContent, { encoding: "utf8" });
@@ -5826,7 +5834,7 @@ ${END_MARKER}
       const parentDir = path3.dirname(targetPath);
       await fs3.mkdir(parentDir, { recursive: true });
       const newContent = `${BEGIN_MARKER}
-${content}
+${cleanContent}
 ${END_MARKER}
 `;
       await fs3.writeFile(targetPath, newContent, { encoding: "utf8", mode: 420 });
@@ -5846,6 +5854,17 @@ async function installStatusLineScript(scriptContent, targetPath = ".claude/stat
     throw new Error(`Failed to install status line script to ${targetPath}: ${errorMessage}`);
   }
 }
+async function copyBraingridReadme(targetPath = ".braingrid/README.md") {
+  try {
+    const content = await fetchFileFromGitHub("claude-code/README.md");
+    const parentDir = path3.dirname(targetPath);
+    await fs3.mkdir(parentDir, { recursive: true });
+    await fs3.writeFile(targetPath, content, { encoding: "utf8", mode: 420 });
+    return true;
+  } catch {
+    return false;
+  }
+}
 async function updateClaudeSettings(settingsPath = ".claude/settings.json", scriptPath = ".claude/statusline.sh") {
   try {
     let settings = {};
@@ -6048,6 +6067,7 @@ async function _handleSetup(config, opts) {
         );
       }
     }
+    await copyBraingridReadme();
     const statusLineMessage = statusLineInstalled ? chalk12.dim("  Status line: .claude/statusline.sh\n") : "";
     return {
       success: true,
@@ -6095,6 +6115,33 @@ async function handleSetupCursor(opts) {
 }
 
 // src/handlers/update.handlers.ts
+async function promptForIdeUpdates() {
+  const cliTools = await checkInstalledCliTools();
+  const claudeInstalled = cliTools.find((t) => t.command === "claude")?.installed;
+  const cursorInstalled = cliTools.find((t) => t.command === "cursor")?.installed;
+  let setupOutput = "";
+  if (claudeInstalled) {
+    const shouldUpdate = await confirm({
+      message: "Claude Code detected. Update BrainGrid integration?",
+      default: true
+    });
+    if (shouldUpdate) {
+      const result = await handleSetupClaudeCode({ force: true });
+      setupOutput += "\n" + result.message;
+    }
+  }
+  if (cursorInstalled) {
+    const shouldUpdate = await confirm({
+      message: "Cursor detected. Update BrainGrid integration?",
+      default: true
+    });
+    if (shouldUpdate) {
+      const result = await handleSetupCursor({ force: true });
+      setupOutput += "\n" + result.message;
+    }
+  }
+  return setupOutput;
+}
 async function handleUpdate(opts) {
   try {
     const currentVersion = getCurrentVersion();
@@ -6109,9 +6156,12 @@ async function handleUpdate(opts) {
     const comparison = compareVersions(currentVersion, latestVersion);
     if (comparison === 0) {
       output += chalk13.green("\u2705 You are already on the latest version!\n");
+      console.log(output);
+      await copyBraingridReadme();
+      const setupOutput2 = await promptForIdeUpdates();
       return {
         success: true,
-        message: output,
+        message: output + setupOutput2,
         data: { currentVersion, latestVersion, upToDate: true }
       };
     }
@@ -6144,30 +6194,8 @@ async function handleUpdate(opts) {
     output += chalk13.dim("Running: ") + chalk13.cyan(updateCommand) + "\n\n";
     console.log(output);
     executeUpdate(packageManager, PACKAGE_NAME);
-    const cliTools = await checkInstalledCliTools();
-    const claudeInstalled = cliTools.find((t) => t.command === "claude")?.installed;
-    const cursorInstalled = cliTools.find((t) => t.command === "cursor")?.installed;
-    let setupOutput = "";
-    if (claudeInstalled) {
-      const shouldUpdate = await confirm({
-        message: "Claude Code detected. Update BrainGrid integration?",
-        default: true
-      });
-      if (shouldUpdate) {
-        const result = await handleSetupClaudeCode({ force: true });
-        setupOutput += "\n" + result.message;
-      }
-    }
-    if (cursorInstalled) {
-      const shouldUpdate = await confirm({
-        message: "Cursor detected. Update BrainGrid integration?",
-        default: true
-      });
-      if (shouldUpdate) {
-        const result = await handleSetupCursor({ force: true });
-        setupOutput += "\n" + result.message;
-      }
-    }
+    await copyBraingridReadme();
+    const setupOutput = await promptForIdeUpdates();
     return {
       success: true,
       message: chalk13.green("\n\u2705 Successfully updated BrainGrid CLI!\n") + setupOutput,
@@ -6846,6 +6874,7 @@ async function handleInit(opts) {
       created_at: project2.created_at
     };
     await saveProjectConfig(localConfig);
+    await copyBraingridReadme();
     console.log(
       chalk15.green("\u2705 Repository initialized successfully!\n\n") + chalk15.dim("Project:    ") + chalk15.cyan(project2.name) + chalk15.dim(` (${project2.short_id})`) + "\n" + chalk15.dim("Config:     ") + chalk15.gray(".braingrid/project.json") + "\n"
     );