@braingrid/cli 0.2.7 → 0.2.9

package/CHANGELOG.md

@@ -5,6 +5,40 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.2.9] - 2025-11-12
+
+### Fixed
+
+- **Documentation URLs updated to docs subdomain**
+  - Updated Claude Code documentation URL from `https://braingrid.ai/docs/claude-code` to `https://docs.braingrid.ai/claude-code`
+  - Updated Cursor documentation URL from `https://braingrid.ai/docs/cursor` to `https://docs.braingrid.ai/cursor`
+  - URLs displayed in setup command success messages now point to correct documentation location
+  - Affects `braingrid setup claude-code` and `braingrid setup cursor` output
+
+## [0.2.8] - 2025-11-12
+
+### Fixed
+
+- **Recursive directory processing for setup commands**
+  - Fixed critical bug where nested directories weren't installed during `braingrid setup claude-code`
+  - Skills directory (`.claude/skills/braingrid-cli/`) now properly installed with all files
+  - Added recursive `processDirectory()` helper to traverse subdirectory structures
+  - Setup commands now correctly handle both files and nested directories from GitHub
+
+### Changed
+
+- **Enhanced skill reference in CLAUDE.md**
+  - Expanded skill reference from 7 words to comprehensive 8-line section
+  - Added engaging question format: "Need help with planning or requirements?"
+  - Listed 5 specific benefits: guided workflows, best practices, proactive suggestions, examples, installation help
+  - Added CLAUDE.md to sync script for distribution to users
+  - Improves skill discoverability in Claude Code
+
+- **Documentation improvements**
+  - Removed deprecated `--verbose` flag references from all documentation
+  - Added full CLI command reference to skill documentation
+  - Updated project configuration with organization UUID
+
 ## [0.2.7] - 2025-11-11
 
 ### Fixed

package/README.md

@@ -37,77 +37,27 @@ npm install -g @braingrid/cli
 
 ---
 
-## AI Coding Tool Integration
+## IDE Integration
 
-BrainGrid integrates natively with AI coding tools like **Cursor IDE** and **Claude Code** through the [AGENTS.md standard](https://agents.md/), providing seamless access to spec-driven development workflows directly in your editor.
-
-### What is AGENTS.md?
-
-[AGENTS.md](https://agents.md/) is an open standard that allows AI coding assistants to automatically load project-specific guidance and commands. BrainGrid uses this standard to provide consistent CLI guidance across multiple tools:
-
-- ✅ **Cursor IDE** - Automatic loading via AGENTS.md + slash commands
-- ✅ **Claude Code** - Automatic loading via AGENTS.md or .claude/CLAUDE.md
-- ✅ **GitHub Copilot** - Context from AGENTS.md
-- ✅ **Growing ecosystem** of AGENTS.md-compatible tools
-
-### Setup for Cursor IDE
-
-**Prerequisites:**
-
-- Cursor IDE installed ([download here](https://cursor.sh/))
-- BrainGrid CLI installed and authenticated
-
-**How it works:**
-
-1. **AGENTS.md** at your repository root is automatically loaded by Cursor
-2. **.cursor/rules/braingrid.mdc** provides Cursor-specific enhancements (always-on rules)
-3. **Slash commands** available via `/` in Cursor's Agent input
-
-**Available Commands:**
-
-Type `/` in Cursor's Agent input to access:
-
-- `/specify` - Create AI-refined requirements from natural language
-- `/breakdown` - Break requirements into implementation tasks
-- `/save-requirement` - Save requirement content to BrainGrid
-- `/build` - Generate complete implementation plan
-
-**Quick Start Example:**
+### Claude Code
 
 ```bash
-# In Cursor IDE Agent input
-/specify "Add user authentication with OAuth2"
-# → Creates REQ-123
-
-/breakdown REQ-123
-# → Generates 5-10 implementation tasks
-
-/build REQ-123
-# → Shows complete requirement with all task prompts
+braingrid setup claude-code
 ```
 
-### Setup for Claude Code
-
-BrainGrid's AGENTS.md file also works with Claude Code. You can either:
-
-1. **Use AGENTS.md directly** (Claude Code automatically reads it)
-2. **Symlink for compatibility**: `ln -s AGENTS.md .claude/CLAUDE.md`
-
-Claude Code also provides its own slash commands in `.claude/commands/`.
+Installs slash commands (`/specify`, `/breakdown`, `/build`), BrainGrid skill, and status line showing your project/requirement/task context in real-time.
 
-### Cross-IDE Compatibility
+[→ Full Claude Code setup guide](./.claude/README.md)
 
-The AGENTS.md standard ensures your BrainGrid setup works across tools:
+### Cursor
 
-- **AGENTS.md** provides CLI guidance for all compatible tools
-- **Tool-specific directories** (.cursor/, .claude/) add enhanced features
-- **Single source of truth** for BrainGrid workflows
+```bash
+braingrid setup cursor
+```
 
-**Learn more:**
+Installs slash commands, always-on rules, and AGENTS.md integration for seamless BrainGrid workflows in Agent mode.
 
-- [AGENTS.md standard](https://agents.md/)
-- [BrainGrid documentation](https://www.braingrid.ai)
-- Full CLI command reference in [AGENTS.md](./AGENTS.md)
+[→ Full Cursor setup guide](./.cursor/README.md)
 
 ---
 
@@ -165,6 +115,8 @@ 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).
+
 **Prerequisites:**
 
 - **GitHub CLI** must be installed and authenticated
@@ -259,7 +211,7 @@ braingrid requirement create --name "Name" [--content "Description"] [--assigned
 braingrid requirement show [id]
 braingrid requirement update [id] [--status IDEA|PLANNED|IN_PROGRESS|REVIEW|COMPLETED|CANCELLED] [--name "New Name"]
 braingrid requirement delete [id] [--force]
-braingrid requirement breakdown [id] [--verbose]
+braingrid requirement breakdown [id]
 braingrid requirement build [id] [--format markdown|json|xml]
 
 # Working with a different project:
@@ -279,7 +231,7 @@ 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] [--verbose]
+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"]
@@ -294,8 +246,6 @@ 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:** Use `--verbose` with `task list` to show full task content in addition to task metadata.
->
 > **Note:** Task status values are: `PLANNED`, `IN_PROGRESS`, `COMPLETED`, `CANCELLED` (tasks do not have `IDEA` or `REVIEW` status).
 
 ### Informational Commands

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.7" : "0.0.0-test";
+var CLI_VERSION = true ? "0.2.9" : "0.0.0-test";
 var PRODUCTION_CONFIG = {
   apiUrl: "https://app.braingrid.ai",
   workosAuthUrl: "https://sensitive-harvest-60.authkit.app",
@@ -5589,14 +5589,12 @@ async function checkPrerequisites() {
 }
 async function getFileList(sourcePaths, targetPaths) {
   const operations = [];
-  for (let i = 0; i < sourcePaths.length; i++) {
-    const sourcePath = sourcePaths[i];
-    const targetPath = targetPaths[i];
+  async function processDirectory(sourceDir, targetDir) {
     try {
-      const items = await listGitHubDirectory(sourcePath);
+      const items = await listGitHubDirectory(sourceDir);
       for (const item of items) {
         if (item.type === "file") {
-          const itemTargetPath = path4.join(targetPath, item.name);
+          const itemTargetPath = path4.join(targetDir, item.name);
           const exists = await fileExists(itemTargetPath);
           operations.push({
             type: "copy",
@@ -5604,15 +5602,21 @@ async function getFileList(sourcePaths, targetPaths) {
             targetPath: itemTargetPath,
             exists
           });
+        } else if (item.type === "dir") {
+          const itemTargetPath = path4.join(targetDir, item.name);
+          await processDirectory(item.path, itemTargetPath);
         }
       }
     } catch (error) {
       console.warn(
-        chalk12.yellow(`\u26A0\uFE0F  Could not list directory: ${sourcePath}`),
+        chalk12.yellow(`\u26A0\uFE0F  Could not list directory: ${sourceDir}`),
         error instanceof Error ? error.message : String(error)
       );
     }
   }
+  for (let i = 0; i < sourcePaths.length; i++) {
+    await processDirectory(sourcePaths[i], targetPaths[i]);
+  }
   return operations;
 }
 function displayInstallationPlan(operations, injectionFile) {
@@ -5762,7 +5766,7 @@ async function handleSetupClaudeCode(opts) {
       sourceFile: "claude-code/CLAUDE.md",
       targetFile: "CLAUDE.md"
     },
-    docsUrl: "https://braingrid.ai/docs/claude-code"
+    docsUrl: "https://docs.braingrid.ai/claude-code"
   };
   return _handleSetup(config, opts);
 }
@@ -5775,7 +5779,7 @@ async function handleSetupCursor(opts) {
       sourceFile: "cursor/AGENTS.md",
       targetFile: "AGENTS.md"
     },
-    docsUrl: "https://braingrid.ai/docs/cursor"
+    docsUrl: "https://docs.braingrid.ai/cursor"
   };
   return _handleSetup(config, opts);
 }