@braingrid/cli 0.0.9 → 0.1.1

package/CHANGELOG.md

@@ -5,12 +5,50 @@ 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.1.1] - 2025-10-07
+
+### Added
+
+- Consistent resource ID normalization across projects, requirements, and tasks
+  - Supports multiple input formats: `PROJ-123`, `proj-123`, `PROJ 123`, `123`, or UUID
+  - Generic `normalizeId()` utility eliminates code duplication
+- Git repository root detection for `.braingrid` folder placement
+  - `.braingrid/project.json` now created at git repository root instead of current directory
+  - Ensures consistent project configuration across entire repository
+- Workspace manager for centralized project resolution
+  - Simplifies project auto-detection from local configuration
+  - Reduces redundant workspace lookups in task commands
+- Configuration path display in `braingrid status` command
+  - Shows where user-level credentials are stored (`~/.config/BrainGrid/config.json`)
+- Internal API services pattern for GitHub and repository operations
+  - Prepares foundation for future repository integration features
+
+### Changed
+
+- Command structure improvements with consistent ID handling
+  - Project, requirement, and task commands now accept flexible ID formats
+  - `braingrid task list -r REQ-456` and `braingrid task list -r 456` both work
+- Improved error messages with better workspace context
+  - Task commands provide clearer guidance when project isn't initialized
+- Fixed credential storage directory from `BrainGrid-nodejs` to `BrainGrid`
+  - **Breaking change**: Users need to re-authenticate after upgrade
+
+### Fixed
+
+- Test script now properly tracks and reports API 500 errors
+  - Enhanced error tracking during integration tests
+  - No longer exits on first error, displays summary table
+- Authentication integration tests handle both logged-in and logged-out states
+  - More robust RPC integration test suite
+
 ## [0.0.9] - 2025-10-04
 
 ### Added
+
 - `-v` shorthand flag for `--version` command
 
 ### Fixed
+
 - API response handling for `project show --repo` and `project show --repo --limit` commands
   - Now correctly handles `ListProjectsWithRepositoryResponse` (with `total_count`) vs `ListProjectsResponse` (with `pagination`)
   - Fixed bug where optional `total_count` check could cause pagination info to not display
@@ -20,6 +58,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 ## [0.0.8] - 2025-10-03
 
 ### Fixed
+
 - Claude Code detection in `braingrid status` command with 3-tier detection strategy
   - Priority 1: Check `~/.claude/local/claude` (after `claude migrate-installer`)
   - Priority 2: Try executing `claude --version` (shell alias detection)
@@ -28,11 +67,13 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
   - Added comprehensive test coverage for all detection methods
 
 ### Changed
+
 - README comment alignment in usage sections for better readability
 
 ## [0.0.7] - 2025-10-03
 
 ### Added
+
 - `braingrid init` command to initialize repositories with BrainGrid projects
   - Auto-detects project from git remote (owner/name)
   - Manual mode with `--project <id>` to specify project by ID
@@ -54,30 +95,35 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - 36 new tests for init, update, and auto-detection features
 
 ### Changed
+
 - Updated `--repository` as primary alias for `--repo` in project show command (both still work)
 - Project configuration now stores API repository data instead of git-derived data
 - Simplified QuickStart workflow with auto-detection examples
 - Enhanced error messages to guide users to run `braingrid init` when needed
 
 ### Fixed
+
 - Terminal crash issue in status command by removing interactive shell flag
 - Data consistency by using API repository values instead of mixing git-derived data
 
 ## [0.0.6] - 2025-10-02
 
 ### Added
+
 - `/cut-release` slash command for streamlined release workflow
 - `pnpm docs:sync` command to sync CLI documentation to main BrainGrid repository
 - Repository-aware project commands with automatic git context detection
 - Collapsible installation and update command tabs in documentation
 
 ### Changed
+
 - Enhanced project commands to automatically detect and include git repository context
 - Improved README with spec-driven development explanation
 
 ## [0.0.5] - 2025-10-02
 
 ### Added
+
 - IDEA and REVIEW requirement statuses for enhanced workflow management
 - Emoji mappings: 💡 for IDEA, 👀 for REVIEW
 - Natural language keyword parsing for new statuses
@@ -86,6 +132,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - Updated CLI help text to include new statuses
 
 ### Changed
+
 - RequirementStatus type now supports 6 statuses: IDEA, PLANNED, IN_PROGRESS, REVIEW, COMPLETED, CANCELLED
 - Status workflow: IDEA → PLANNED → IN_PROGRESS → REVIEW → COMPLETED/CANCELLED
 - Updated README badges to use @braingrid organization
@@ -94,6 +141,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 ## [0.0.4] - 2025-10-02
 
 ### Added
+
 - Comprehensive test coverage improvement from 26.15% to 64.9%
 - 529 passing tests covering utils, services, and handlers
 - Handler layer tests achieving 96.28% coverage (all core handlers 92-100%)
@@ -103,6 +151,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - CLI tools detection (Claude Code, Cursor, git)
 
 ### Changed
+
 - Renamed package from `@braingridai/cli` to `@braingrid/cli`
 - Updated repository URL to main braingrid repo
 - Refactored from React-based CLI to Commander.js pattern
@@ -110,6 +159,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - Enhanced status command with authentication, git, and tool information
 
 ### Fixed
+
 - Task handler number type (string for proper padding)
 - Repository URL format in package.json
 - Test coverage for all critical paths
@@ -117,14 +167,17 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 ## [0.0.3] - 2024-01-XX
 
 ### Changed
+
 - Initial npm publication as `@braingrid/cli`
 
 ## [0.0.2] - 2024-01-XX
 
 ### Changed
+
 - Initial version as `@braingridai/cli`
 
 ## [0.0.1] - 2024-01-XX
 
 ### Added
+
 - Initial CLI implementation

package/README.md

@@ -5,9 +5,10 @@
   <p>Turn thoughts into AI-ready specs and ship 100 faster.</p>
   <h3>A CLI for spec-driven development.</h3>
 
-  [![npm version](https://img.shields.io/npm/v/@braingrid/cli.svg?color=blue&logo=npm)](https://www.npmjs.com/package/@braingrid/cli)
-  [![Downloads](https://img.shields.io/npm/dm/@braingrid/cli.svg?color=green)](https://www.npmjs.com/package/@braingrid/cli)
-  [![GitHub stars](https://img.shields.io/github/stars/BrainGridAI/braingrid?style=social)](https://github.com/BrainGridAI/braingrid)
+[![npm version](https://img.shields.io/npm/v/@braingrid/cli.svg?color=blue&logo=npm)](https://www.npmjs.com/package/@braingrid/cli)
+[![Downloads](https://img.shields.io/npm/dm/@braingrid/cli.svg?color=green)](https://www.npmjs.com/package/@braingrid/cli)
+[![GitHub stars](https://img.shields.io/github/stars/BrainGridAI/braingrid?style=social)](https://github.com/BrainGridAI/braingrid)
+
 </div>
 
 ---
@@ -29,6 +30,7 @@
 - 📊 **Track Progress** - Manage and update task statuses
 - 💾 **Multiple Output Formats** - View data as formatted tables or JSON for scripting
 - 🔍 **Environment Detection** - Automatically detect git repository info and installed AI coding tools
+- 🔌 **JSON-RPC Mode** - Programmatic access via JSON-RPC 2.0 protocol for IDE integration
 
 ---
 
@@ -63,6 +65,7 @@ braingrid task create -r REQ-1 --title "Implement login endpoint"
 # 6. View tasks for a requirement
 braingrid task list -r REQ-1
 ```
+
 ---
 
 ## Usage
@@ -72,9 +75,9 @@ BrainGrid CLI uses a resource-oriented command structure: `braingrid <resource>
 ### Authentication Commands
 
 ```bash
-braingrid login       # Authenticate with BrainGrid (OAuth2 PKCE flow)
-braingrid logout      # Sign out and clear credentials
-braingrid whoami      # Show current user information
+braingrid login
+braingrid whoami
+braingrid logout
 ```
 
 ### Initialization
@@ -82,31 +85,36 @@ braingrid whoami      # Show current user information
 Initialize your repository with a BrainGrid project:
 
 ```bash
-braingrid init                              # Auto-detects project from git remote (owner/name)
-braingrid init --project PROJ-123           # Manually specify project by ID (short ID or UUID)
-braingrid init --wizard                     # Run interactive wizard with confirmation prompt
-braingrid init --force                      # Force reinitialization if already initialized
-braingrid init --project PROJ-123 --force  # Manually specify and force reinitialization
+# Run interactive wizard with confirmation prompt
+braingrid init --wizard
+
+# Auto-detects project from git remote (owner/name)
+braingrid init
+
+# Manually specify project by ID (short ID or UUID)
+braingrid init --project PROJ-123
+
+# Force reinitialization if already initialized
+braingrid init --force
+
+# Manually specify and force reinitialization
+braingrid init --project PROJ-123 --force
 ```
 
-The `init` command:
-- **Auto-detect mode** (default): Fetches the project linked to your current git repository
-- **Manual mode** (`--project`): Fetches a specific project by ID, bypassing git detection
-- Creates a `.braingrid/project.json` file in the `.braingrid/` directory
-- Fails if already initialized unless `--force` is provided
+The `init` command creates a `.braingrid/project.json` file in the `.braingrid/` directory. This tells the CLI what project it is working on so you don't have to pass it as a parameter.
 
 ### Project Commands
 
 ```bash
 braingrid project list [--format json] [--page 1] [--limit 20]
-braingrid project show                                       # Auto-detects project from current repo
-braingrid project show [<id>] [--repository "owner/repo"]   # Show specific repo's project (--repo also works)
+braingrid project show
+braingrid project show [<id>] [--repository "owner/repo"]
 braingrid project create --name "Project Name" [--description "Description"] [--repositories "owner/repo,owner/repo2"]
 braingrid project update <id> [--name "New Name"] [--description "New Description"]
 braingrid project delete <id> [--force]
 ```
 
-> **Note:** `project show` automatically detects the current git repository and shows its associated project when called without arguments. You can also specify `--repository "owner/repo"` (or the shorter `--repo`) to show a specific repository's project, or provide a project ID directly.
+> **Note:** `project show` displays the initialized project from your workspace when called without arguments. Use `--repository "owner/repo"` to list all projects for a specific repository, or provide a project ID directly to view a specific project.
 
 ### Requirement Commands
 

package/dist/build-config.d.ts

@@ -1,14 +1,10 @@
 /**
- * BUILD_ENV is set at build time and determines which configuration to use.
- * - 'production': Uses production URLs, ignores NODE_ENV (for npm published package)
- * - 'development': Allows NODE_ENV to override URLs (for local development)
+ * BUILD_ENV determines which configuration to use.
+ * - 'production': Uses production URLs (when NODE_ENV=production)
+ * - 'development': Uses development/local URLs (default)
  */
 export declare const BUILD_ENV: 'production' | 'development';
-/**
- * CLI_VERSION is set at build time from package.json
- * Used for update checks and version display
- */
-export declare const CLI_VERSION = "development";
+export declare const CLI_VERSION: string;
 /**
  * Production configuration
  * Used when BUILD_ENV === 'production' (npm published package)

package/dist/build-config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"build-config.d.ts","sourceRoot":"","sources":["../src/build-config.ts"],"names":[],"mappings":"AAGA;;;;GAIG;AACH,eAAO,MAAM,SAAS,EAAE,YAAY,GAAG,aAA6B,CAAC;AAErE;;;GAGG;AACH,eAAO,MAAM,WAAW,gBAAgB,CAAC;AAEzC;;;GAGG;AACH,eAAO,MAAM,iBAAiB;;;;CAIpB,CAAC;AAEX;;;GAGG;AACH,eAAO,MAAM,kBAAkB;;;;CAIrB,CAAC"}
+{"version":3,"file":"build-config.d.ts","sourceRoot":"","sources":["../src/build-config.ts"],"names":[],"mappings":"AAOA;;;;GAIG;AACH,eAAO,MAAM,SAAS,EAAE,YAAY,GAAG,aAC8B,CAAC;AAgBtE,eAAO,MAAM,WAAW,QAAe,CAAC;AAExC;;;GAGG;AACH,eAAO,MAAM,iBAAiB;;;;CAIpB,CAAC;AAEX;;;GAGG;AACH,eAAO,MAAM,kBAAkB;;;;CAIrB,CAAC"}

package/dist/build-config.js

@@ -1,16 +1,29 @@
-// Build-time configuration constants
-// These values are replaced during production builds
+import { readFileSync } from 'node:fs';
+import { join, dirname } from 'node:path';
+import { fileURLToPath } from 'node:url';
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
 /**
- * BUILD_ENV is set at build time and determines which configuration to use.
- * - 'production': Uses production URLs, ignores NODE_ENV (for npm published package)
- * - 'development': Allows NODE_ENV to override URLs (for local development)
+ * BUILD_ENV determines which configuration to use.
+ * - 'production': Uses production URLs (when NODE_ENV=production)
+ * - 'development': Uses development/local URLs (default)
  */
-export const BUILD_ENV = 'production';
+export const BUILD_ENV = process.env.NODE_ENV === 'production' ? 'production' : 'development';
 /**
- * CLI_VERSION is set at build time from package.json
+ * CLI_VERSION read from package.json at runtime
  * Used for update checks and version display
  */
-export const CLI_VERSION = '0.0.9';
+function getVersion() {
+    try {
+        const packagePath = join(__dirname, '..', 'package.json');
+        const pkg = JSON.parse(readFileSync(packagePath, 'utf-8'));
+        return pkg.version;
+    }
+    catch {
+        return 'unknown';
+    }
+}
+export const CLI_VERSION = getVersion();
 /**
  * Production configuration
  * Used when BUILD_ENV === 'production' (npm published package)

package/dist/build-config.js.map

@@ -1 +1 @@
-{"version":3,"file":"build-config.js","sourceRoot":"","sources":["../src/build-config.ts"],"names":[],"mappings":"AAAA,qCAAqC;AACrC,qDAAqD;AAErD;;;;GAIG;AACH,MAAM,CAAC,MAAM,SAAS,GAAiC,aAAa,CAAC;AAErE;;;GAGG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,aAAa,CAAC;AAEzC;;;GAGG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAChC,MAAM,EAAE,0BAA0B;IAClC,aAAa,EAAE,0CAA0C;IACzD,cAAc,EAAE,mCAAmC;CAC1C,CAAC;AAEX;;;GAGG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG;IACjC,MAAM,EAAE,8BAA8B;IACtC,aAAa,EAAE,qDAAqD;IACpE,cAAc,EAAE,mCAAmC;CAC1C,CAAC"}
+{"version":3,"file":"build-config.js","sourceRoot":"","sources":["../src/build-config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,MAAM,UAAU,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAClD,MAAM,SAAS,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;AAEtC;;;;GAIG;AACH,MAAM,CAAC,MAAM,SAAS,GACrB,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,YAAY,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,aAAa,CAAC;AAEtE;;;GAGG;AACH,SAAS,UAAU;IAClB,IAAI,CAAC;QACJ,MAAM,WAAW,GAAG,IAAI,CAAC,SAAS,EAAE,IAAI,EAAE,cAAc,CAAC,CAAC;QAC1D,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC,CAAC;QAC3D,OAAO,GAAG,CAAC,OAAO,CAAC;IACpB,CAAC;IAAC,MAAM,CAAC;QACR,OAAO,SAAS,CAAC;IAClB,CAAC;AACF,CAAC;AAED,MAAM,CAAC,MAAM,WAAW,GAAG,UAAU,EAAE,CAAC;AAExC;;;GAGG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAChC,MAAM,EAAE,0BAA0B;IAClC,aAAa,EAAE,0CAA0C;IACzD,cAAc,EAAE,mCAAmC;CAC1C,CAAC;AAEX;;;GAGG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG;IACjC,MAAM,EAAE,8BAA8B;IACtC,aAAa,EAAE,qDAAqD;IACpE,cAAc,EAAE,mCAAmC;CAC1C,CAAC"}