@braingrid/cli 0.1.0 → 0.1.1

package/dist/utils/local-store.js

@@ -5,31 +5,43 @@
 import fs from 'node:fs';
 import path from 'node:path';
 import { LocalProjectConfigSchema } from '../types/local-project.js';
+import { getGitRoot } from './git.js';
 const BRAINGRID_DIR = '.braingrid';
 const PROJECT_CONFIG_FILE = 'project.json';
+/**
+ * Get the default directory for .braingrid folder
+ * Prefers git repository root, falls back to current working directory
+ */
+async function getDefaultCwd() {
+    const gitRoot = await getGitRoot();
+    return gitRoot || process.cwd();
+}
 /**
  * Get the path to the .braingrid directory
  */
-export function getBraingridDir(cwd = process.cwd()) {
-    return path.join(cwd, BRAINGRID_DIR);
+export async function getBraingridDir(cwd) {
+    const dir = cwd ?? (await getDefaultCwd());
+    return path.join(dir, BRAINGRID_DIR);
 }
 /**
  * Get the path to the project.json file
  */
-export function getProjectConfigPath(cwd = process.cwd()) {
-    return path.join(getBraingridDir(cwd), PROJECT_CONFIG_FILE);
+export async function getProjectConfigPath(cwd) {
+    const braingridDir = await getBraingridDir(cwd);
+    return path.join(braingridDir, PROJECT_CONFIG_FILE);
 }
 /**
  * Check if .braingrid/project.json exists
  */
-export function projectConfigExists(cwd = process.cwd()) {
-    return fs.existsSync(getProjectConfigPath(cwd));
+export async function projectConfigExists(cwd) {
+    const configPath = await getProjectConfigPath(cwd);
+    return fs.existsSync(configPath);
 }
 /**
  * Ensure .braingrid directory exists
  */
-function ensureBraingridDir(cwd = process.cwd()) {
-    const dir = getBraingridDir(cwd);
+async function ensureBraingridDir(cwd) {
+    const dir = await getBraingridDir(cwd);
     if (!fs.existsSync(dir)) {
         fs.mkdirSync(dir, { recursive: true });
     }
@@ -38,8 +50,8 @@ function ensureBraingridDir(cwd = process.cwd()) {
  * Load project configuration from .braingrid/project.json
  * @throws Error if file doesn't exist or is invalid
  */
-export function loadProjectConfig(cwd = process.cwd()) {
-    const configPath = getProjectConfigPath(cwd);
+export async function loadProjectConfig(cwd) {
+    const configPath = await getProjectConfigPath(cwd);
     if (!fs.existsSync(configPath)) {
         throw new Error(`Project not initialized. Run 'braingrid init' to initialize this repository.`);
     }
@@ -51,17 +63,17 @@ export function loadProjectConfig(cwd = process.cwd()) {
 /**
  * Save project configuration to .braingrid/project.json
  */
-export function saveProjectConfig(config, cwd = process.cwd()) {
-    ensureBraingridDir(cwd);
-    const configPath = getProjectConfigPath(cwd);
+export async function saveProjectConfig(config, cwd) {
+    await ensureBraingridDir(cwd);
+    const configPath = await getProjectConfigPath(cwd);
     const content = JSON.stringify(config, null, 2);
     fs.writeFileSync(configPath, content, 'utf8');
 }
 /**
  * Delete .braingrid/project.json
  */
-export function deleteProjectConfig(cwd = process.cwd()) {
-    const configPath = getProjectConfigPath(cwd);
+export async function deleteProjectConfig(cwd) {
+    const configPath = await getProjectConfigPath(cwd);
     if (fs.existsSync(configPath)) {
         fs.unlinkSync(configPath);
     }
@@ -70,9 +82,9 @@ export function deleteProjectConfig(cwd = process.cwd()) {
  * Get the local project ID from .braingrid/project.json
  * Returns the short_id (e.g., PROJ-123) if project.json exists, null otherwise
  */
-export function getLocalProjectId(cwd = process.cwd()) {
+export async function getLocalProjectId(cwd) {
     try {
-        const config = loadProjectConfig(cwd);
+        const config = await loadProjectConfig(cwd);
         return config.project_short_id;
     }
     catch {

package/dist/utils/local-store.js.map

@@ -1 +1 @@
-{"version":3,"file":"local-store.js","sourceRoot":"","sources":["../../src/utils/local-store.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"local-store.js","sourceRoot":"","sources":["../../src/utils/local-store.ts"],"names":[],"mappings":"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"}

package/dist/utils/projects.d.ts

@@ -0,0 +1,23 @@
+import { Project } from '../types/project.js';
+/**
+ * Format a project with friendly PROJ-<number> format
+ * Note: short_id already contains "PROJ-123" format
+ */
+export declare function formatProjectId(project: Project): string;
+/**
+ * Normalize project ID from various formats to API-compatible format:
+ * - "PROJ-123" -> "PROJ-123" (already normalized)
+ * - "proj-123" -> "PROJ-123" (uppercase)
+ * - "PROJ 123" -> "PROJ-123" (add dash, uppercase)
+ * - "proj 123" -> "PROJ-123" (add dash, uppercase)
+ * - "123" -> "PROJ-123" (add prefix)
+ * - "uuid-string" -> "uuid-string" (UUID, return as-is)
+ *
+ * This function takes user input and returns the ID that should be used in API calls
+ */
+export declare function parseProjectId(input: string): string;
+/**
+ * Find a project by either short_id or UUID
+ */
+export declare function findProjectById(projects: Project[], identifier: string): Project | undefined;
+//# sourceMappingURL=projects.d.ts.map

package/dist/utils/projects.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"projects.d.ts","sourceRoot":"","sources":["../../src/utils/projects.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAG9C;;;GAGG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,CAExD;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEpD;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,OAAO,EAAE,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,CAW5F"}

package/dist/utils/projects.js

@@ -0,0 +1,36 @@
+import { normalizeId } from './id-normalization.js';
+/**
+ * Format a project with friendly PROJ-<number> format
+ * Note: short_id already contains "PROJ-123" format
+ */
+export function formatProjectId(project) {
+    return project.short_id;
+}
+/**
+ * Normalize project ID from various formats to API-compatible format:
+ * - "PROJ-123" -> "PROJ-123" (already normalized)
+ * - "proj-123" -> "PROJ-123" (uppercase)
+ * - "PROJ 123" -> "PROJ-123" (add dash, uppercase)
+ * - "proj 123" -> "PROJ-123" (add dash, uppercase)
+ * - "123" -> "PROJ-123" (add prefix)
+ * - "uuid-string" -> "uuid-string" (UUID, return as-is)
+ *
+ * This function takes user input and returns the ID that should be used in API calls
+ */
+export function parseProjectId(input) {
+    return normalizeId('PROJ', input);
+}
+/**
+ * Find a project by either short_id or UUID
+ */
+export function findProjectById(projects, identifier) {
+    const normalized = parseProjectId(identifier);
+    // Try to find by short_id first (handles PROJ-X format)
+    const byShortId = projects.find(proj => proj.short_id === normalized);
+    if (byShortId) {
+        return byShortId;
+    }
+    // Try to find by UUID
+    return projects.find(proj => proj.id === normalized);
+}
+//# sourceMappingURL=projects.js.map

package/dist/utils/projects.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"projects.js","sourceRoot":"","sources":["../../src/utils/projects.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAEpD;;;GAGG;AACH,MAAM,UAAU,eAAe,CAAC,OAAgB;IAC/C,OAAO,OAAO,CAAC,QAAQ,CAAC;AACzB,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,cAAc,CAAC,KAAa;IAC3C,OAAO,WAAW,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;AACnC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,QAAmB,EAAE,UAAkB;IACtE,MAAM,UAAU,GAAG,cAAc,CAAC,UAAU,CAAC,CAAC;IAE9C,wDAAwD;IACxD,MAAM,SAAS,GAAG,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,QAAQ,KAAK,UAAU,CAAC,CAAC;IACtE,IAAI,SAAS,EAAE,CAAC;QACf,OAAO,SAAS,CAAC;IAClB,CAAC;IAED,sBAAsB;IACtB,OAAO,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,KAAK,UAAU,CAAC,CAAC;AACtD,CAAC"}

package/dist/utils/requirements.d.ts

@@ -4,9 +4,24 @@ import { Requirement } from '../types/requirement.js';
  * Note: short_id already contains "REQ-123" format
  */
 export declare function formatRequirementId(requirement: Requirement): string;
+/**
+ * Normalize requirement ID from various formats to API-compatible format:
+ * - "REQ-123" -> "REQ-123" (already normalized)
+ * - "req-123" -> "REQ-123" (uppercase)
+ * - "REQ 123" -> "REQ-123" (add dash, uppercase)
+ * - "req 123" -> "REQ-123" (add dash, uppercase)
+ * - "123" -> "REQ-123" (add prefix)
+ * - "uuid-string" -> "uuid-string" (UUID, return as-is)
+ *
+ * This function takes user input and returns the ID that should be used in API calls
+ */
+export declare function normalizeRequirementId(input: string): string;
 /**
  * Parse a requirement ID from various formats:
  * - "REQ-123" -> { type: 'req_id', value: 123 }
+ * - "req-123" -> { type: 'req_id', value: 123 }
+ * - "REQ 123" -> { type: 'req_id', value: 123 }
+ * - "req 123" -> { type: 'req_id', value: 123 }
  * - "123" -> { type: 'req_id', value: 123 }
  * - "uuid-string" -> { type: 'uuid', value: 'uuid-string' }
  */

package/dist/utils/requirements.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"requirements.d.ts","sourceRoot":"","sources":["../../src/utils/requirements.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAEtD;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,WAAW,EAAE,WAAW,GAAG,MAAM,CAEpE;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG;IAClD,IAAI,EAAE,QAAQ,GAAG,MAAM,CAAC;IACxB,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC;CACvB,CAeA;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAClC,YAAY,EAAE,WAAW,EAAE,EAC3B,UAAU,EAAE,MAAM,GAChB,WAAW,GAAG,SAAS,CAQzB;AAED;;;GAGG;AACH,wBAAgB,yBAAyB,CAAC,UAAU,EAAE,MAAM,GAAG;IAAE,EAAE,CAAC,EAAE,MAAM,CAAA;CAAE,CAS7E"}
+{"version":3,"file":"requirements.d.ts","sourceRoot":"","sources":["../../src/utils/requirements.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAGtD;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,WAAW,EAAE,WAAW,GAAG,MAAM,CAEpE;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAE5D;AAED;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG;IAClD,IAAI,EAAE,QAAQ,GAAG,MAAM,CAAC;IACxB,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC;CACvB,CAwBA;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAClC,YAAY,EAAE,WAAW,EAAE,EAC3B,UAAU,EAAE,MAAM,GAChB,WAAW,GAAG,SAAS,CAQzB;AAED;;;GAGG;AACH,wBAAgB,yBAAyB,CAAC,UAAU,EAAE,MAAM,GAAG;IAAE,EAAE,CAAC,EAAE,MAAM,CAAA;CAAE,CAS7E"}

package/dist/utils/requirements.js

@@ -1,3 +1,4 @@
+import { normalizeId } from './id-normalization.js';
 /**
  * Format a requirement with friendly REQ-<number> format
  * Note: short_id already contains "REQ-123" format
@@ -5,25 +6,49 @@
 export function formatRequirementId(requirement) {
     return requirement.short_id || `REQ-${requirement.req_id || 0}`;
 }
+/**
+ * Normalize requirement ID from various formats to API-compatible format:
+ * - "REQ-123" -> "REQ-123" (already normalized)
+ * - "req-123" -> "REQ-123" (uppercase)
+ * - "REQ 123" -> "REQ-123" (add dash, uppercase)
+ * - "req 123" -> "REQ-123" (add dash, uppercase)
+ * - "123" -> "REQ-123" (add prefix)
+ * - "uuid-string" -> "uuid-string" (UUID, return as-is)
+ *
+ * This function takes user input and returns the ID that should be used in API calls
+ */
+export function normalizeRequirementId(input) {
+    return normalizeId('REQ', input);
+}
 /**
  * Parse a requirement ID from various formats:
  * - "REQ-123" -> { type: 'req_id', value: 123 }
+ * - "req-123" -> { type: 'req_id', value: 123 }
+ * - "REQ 123" -> { type: 'req_id', value: 123 }
+ * - "req 123" -> { type: 'req_id', value: 123 }
  * - "123" -> { type: 'req_id', value: 123 }
  * - "uuid-string" -> { type: 'uuid', value: 'uuid-string' }
  */
 export function parseRequirementId(input) {
-    // Handle REQ-123 format
-    const reqMatch = input.match(/^REQ-(\d+)$/i);
-    if (reqMatch) {
-        return { type: 'req_id', value: parseInt(reqMatch[1], 10) };
+    // Trim whitespace
+    const trimmed = input.trim();
+    // Handle "REQ-123" or "req-123" format (with dash)
+    const reqDashMatch = trimmed.match(/^REQ-(\d+)$/i);
+    if (reqDashMatch) {
+        return { type: 'req_id', value: parseInt(reqDashMatch[1], 10) };
+    }
+    // Handle "REQ 123" or "req 123" format (with space)
+    const reqSpaceMatch = trimmed.match(/^REQ\s+(\d+)$/i);
+    if (reqSpaceMatch) {
+        return { type: 'req_id', value: parseInt(reqSpaceMatch[1], 10) };
     }
     // Handle plain number format
-    const numberMatch = input.match(/^\d+$/);
+    const numberMatch = trimmed.match(/^\d+$/);
     if (numberMatch) {
-        return { type: 'req_id', value: parseInt(input, 10) };
+        return { type: 'req_id', value: parseInt(trimmed, 10) };
     }
     // Assume it's a UUID
-    return { type: 'uuid', value: input };
+    return { type: 'uuid', value: trimmed };
 }
 /**
  * Find a requirement by either req_id or UUID

package/dist/utils/requirements.js.map

@@ -1 +1 @@
-{"version":3,"file":"requirements.js","sourceRoot":"","sources":["../../src/utils/requirements.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,MAAM,UAAU,mBAAmB,CAAC,WAAwB;IAC3D,OAAO,WAAW,CAAC,QAAQ,IAAI,OAAO,WAAW,CAAC,MAAM,IAAI,CAAC,EAAE,CAAC;AACjE,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,kBAAkB,CAAC,KAAa;IAI/C,wBAAwB;IACxB,MAAM,QAAQ,GAAG,KAAK,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC;IAC7C,IAAI,QAAQ,EAAE,CAAC;QACd,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC;IAC7D,CAAC;IAED,6BAA6B;IAC7B,MAAM,WAAW,GAAG,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IACzC,IAAI,WAAW,EAAE,CAAC;QACjB,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,QAAQ,CAAC,KAAK,EAAE,EAAE,CAAC,EAAE,CAAC;IACvD,CAAC;IAED,qBAAqB;IACrB,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;AACvC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,mBAAmB,CAClC,YAA2B,EAC3B,UAAkB;IAElB,MAAM,MAAM,GAAG,kBAAkB,CAAC,UAAU,CAAC,CAAC;IAE9C,IAAI,MAAM,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;QAC9B,OAAO,YAAY,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,QAAQ,KAAK,OAAO,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC;IACzE,CAAC;SAAM,CAAC;QACP,OAAO,YAAY,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,KAAK,MAAM,CAAC,KAAK,CAAC,CAAC;IAC1D,CAAC;AACF,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,yBAAyB,CAAC,UAAkB;IAC3D,MAAM,MAAM,GAAG,kBAAkB,CAAC,UAAU,CAAC,CAAC;IAE9C,IAAI,MAAM,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;QAC5B,OAAO,EAAE,EAAE,EAAE,MAAM,CAAC,KAAe,EAAE,CAAC;IACvC,CAAC;SAAM,CAAC;QACP,+CAA+C;QAC/C,OAAO,EAAE,CAAC;IACX,CAAC;AACF,CAAC"}
+{"version":3,"file":"requirements.js","sourceRoot":"","sources":["../../src/utils/requirements.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAEpD;;;GAGG;AACH,MAAM,UAAU,mBAAmB,CAAC,WAAwB;IAC3D,OAAO,WAAW,CAAC,QAAQ,IAAI,OAAO,WAAW,CAAC,MAAM,IAAI,CAAC,EAAE,CAAC;AACjE,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,sBAAsB,CAAC,KAAa;IACnD,OAAO,WAAW,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;AAClC,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,kBAAkB,CAAC,KAAa;IAI/C,kBAAkB;IAClB,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;IAE7B,mDAAmD;IACnD,MAAM,YAAY,GAAG,OAAO,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC;IACnD,IAAI,YAAY,EAAE,CAAC;QAClB,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,QAAQ,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC;IACjE,CAAC;IAED,oDAAoD;IACpD,MAAM,aAAa,GAAG,OAAO,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAC;IACtD,IAAI,aAAa,EAAE,CAAC;QACnB,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,QAAQ,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC;IAClE,CAAC;IAED,6BAA6B;IAC7B,MAAM,WAAW,GAAG,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAC3C,IAAI,WAAW,EAAE,CAAC;QACjB,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,QAAQ,CAAC,OAAO,EAAE,EAAE,CAAC,EAAE,CAAC;IACzD,CAAC;IAED,qBAAqB;IACrB,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC;AACzC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,mBAAmB,CAClC,YAA2B,EAC3B,UAAkB;IAElB,MAAM,MAAM,GAAG,kBAAkB,CAAC,UAAU,CAAC,CAAC;IAE9C,IAAI,MAAM,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;QAC9B,OAAO,YAAY,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,QAAQ,KAAK,OAAO,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC;IACzE,CAAC;SAAM,CAAC;QACP,OAAO,YAAY,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,KAAK,MAAM,CAAC,KAAK,CAAC,CAAC;IAC1D,CAAC;AACF,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,yBAAyB,CAAC,UAAkB;IAC3D,MAAM,MAAM,GAAG,kBAAkB,CAAC,UAAU,CAAC,CAAC;IAE9C,IAAI,MAAM,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;QAC5B,OAAO,EAAE,EAAE,EAAE,MAAM,CAAC,KAAe,EAAE,CAAC;IACvC,CAAC;SAAM,CAAC;QACP,+CAA+C;QAC/C,OAAO,EAAE,CAAC;IACX,CAAC;AACF,CAAC"}

package/dist/utils/tasks.d.ts

@@ -1,5 +1,17 @@
 import { RequirementTask as Task } from '../types/requirement.js';
 export declare function formatTaskId(task: Task): string;
+/**
+ * Normalize task ID from various formats to API-compatible format:
+ * - "TASK-123" -> "TASK-123" (already normalized)
+ * - "task-123" -> "TASK-123" (uppercase)
+ * - "TASK 123" -> "TASK-123" (add dash, uppercase)
+ * - "task 123" -> "TASK-123" (add dash, uppercase)
+ * - "123" -> "TASK-123" (add prefix)
+ * - "uuid-string" -> "uuid-string" (UUID, return as-is)
+ *
+ * This function takes user input and returns the ID that should be used in API calls
+ */
+export declare function normalizeTaskId(input: string): string;
 export declare function parseTaskId(input: string): {
     type: 'number' | 'uuid';
     value: string | number;

package/dist/utils/tasks.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tasks.d.ts","sourceRoot":"","sources":["../../src/utils/tasks.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,IAAI,IAAI,EAAE,MAAM,yBAAyB,CAAC;AAElE,wBAAgB,YAAY,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,CAE/C;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG;IAAE,IAAI,EAAE,QAAQ,GAAG,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAAA;CAAE,CAY9F;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAQ3E;AAED,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAaxD"}
+{"version":3,"file":"tasks.d.ts","sourceRoot":"","sources":["../../src/utils/tasks.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,IAAI,IAAI,EAAE,MAAM,yBAAyB,CAAC;AAGlE,wBAAgB,YAAY,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,CAE/C;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAErD;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG;IAAE,IAAI,EAAE,QAAQ,GAAG,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAAA;CAAE,CAwB9F;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAQ3E;AAED,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAaxD"}

package/dist/utils/tasks.js

@@ -1,16 +1,41 @@
+import { normalizeId } from './id-normalization.js';
 export function formatTaskId(task) {
     return `TASK-${task.number}`;
 }
+/**
+ * Normalize task ID from various formats to API-compatible format:
+ * - "TASK-123" -> "TASK-123" (already normalized)
+ * - "task-123" -> "TASK-123" (uppercase)
+ * - "TASK 123" -> "TASK-123" (add dash, uppercase)
+ * - "task 123" -> "TASK-123" (add dash, uppercase)
+ * - "123" -> "TASK-123" (add prefix)
+ * - "uuid-string" -> "uuid-string" (UUID, return as-is)
+ *
+ * This function takes user input and returns the ID that should be used in API calls
+ */
+export function normalizeTaskId(input) {
+    return normalizeId('TASK', input);
+}
 export function parseTaskId(input) {
-    const taskMatch = input.match(/^TASK-(\d+)$/i);
-    if (taskMatch) {
-        return { type: 'number', value: parseInt(taskMatch[1], 10) };
+    // Trim whitespace
+    const trimmed = input.trim();
+    // Handle "TASK-123" or "task-123" format (with dash)
+    const taskDashMatch = trimmed.match(/^TASK-(\d+)$/i);
+    if (taskDashMatch) {
+        return { type: 'number', value: parseInt(taskDashMatch[1], 10) };
+    }
+    // Handle "TASK 123" or "task 123" format (with space)
+    const taskSpaceMatch = trimmed.match(/^TASK\s+(\d+)$/i);
+    if (taskSpaceMatch) {
+        return { type: 'number', value: parseInt(taskSpaceMatch[1], 10) };
     }
-    const numberMatch = input.match(/^\d+$/);
+    // Handle plain number format
+    const numberMatch = trimmed.match(/^\d+$/);
     if (numberMatch) {
-        return { type: 'number', value: parseInt(input, 10) };
+        return { type: 'number', value: parseInt(trimmed, 10) };
     }
-    return { type: 'uuid', value: input };
+    // Assume it's a UUID
+    return { type: 'uuid', value: trimmed };
 }
 export function findTaskById(tasks, identifier) {
     const parsed = parseTaskId(identifier);

package/dist/utils/tasks.js.map

@@ -1 +1 @@
-{"version":3,"file":"tasks.js","sourceRoot":"","sources":["../../src/utils/tasks.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,YAAY,CAAC,IAAU;IACtC,OAAO,QAAQ,IAAI,CAAC,MAAM,EAAE,CAAC;AAC9B,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,KAAa;IACxC,MAAM,SAAS,GAAG,KAAK,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC;IAC/C,IAAI,SAAS,EAAE,CAAC;QACf,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC;IAC9D,CAAC;IAED,MAAM,WAAW,GAAG,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IACzC,IAAI,WAAW,EAAE,CAAC;QACjB,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,QAAQ,CAAC,KAAK,EAAE,EAAE,CAAC,EAAE,CAAC;IACvD,CAAC;IAED,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;AACvC,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,KAAa,EAAE,UAAkB;IAC7D,MAAM,MAAM,GAAG,WAAW,CAAC,UAAU,CAAC,CAAC;IAEvC,IAAI,MAAM,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;QAC9B,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,MAAM,KAAK,MAAM,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC;IACjE,CAAC;SAAM,CAAC;QACP,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,KAAK,MAAM,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC;IAC7D,CAAC;AACF,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,MAAc;IAC/C,QAAQ,MAAM,EAAE,CAAC;QAChB,KAAK,SAAS;YACb,OAAO,IAAI,CAAC;QACb,KAAK,aAAa;YACjB,OAAO,IAAI,CAAC;QACb,KAAK,WAAW;YACf,OAAO,GAAG,CAAC;QACZ,KAAK,WAAW;YACf,OAAO,GAAG,CAAC;QACZ;YACC,OAAO,IAAI,CAAC;IACd,CAAC;AACF,CAAC"}
+{"version":3,"file":"tasks.js","sourceRoot":"","sources":["../../src/utils/tasks.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAEpD,MAAM,UAAU,YAAY,CAAC,IAAU;IACtC,OAAO,QAAQ,IAAI,CAAC,MAAM,EAAE,CAAC;AAC9B,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,eAAe,CAAC,KAAa;IAC5C,OAAO,WAAW,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;AACnC,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,KAAa;IACxC,kBAAkB;IAClB,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;IAE7B,qDAAqD;IACrD,MAAM,aAAa,GAAG,OAAO,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC;IACrD,IAAI,aAAa,EAAE,CAAC;QACnB,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,QAAQ,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC;IAClE,CAAC;IAED,sDAAsD;IACtD,MAAM,cAAc,GAAG,OAAO,CAAC,KAAK,CAAC,iBAAiB,CAAC,CAAC;IACxD,IAAI,cAAc,EAAE,CAAC;QACpB,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,QAAQ,CAAC,cAAc,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC;IACnE,CAAC;IAED,6BAA6B;IAC7B,MAAM,WAAW,GAAG,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAC3C,IAAI,WAAW,EAAE,CAAC;QACjB,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,QAAQ,CAAC,OAAO,EAAE,EAAE,CAAC,EAAE,CAAC;IACzD,CAAC;IAED,qBAAqB;IACrB,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC;AACzC,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,KAAa,EAAE,UAAkB;IAC7D,MAAM,MAAM,GAAG,WAAW,CAAC,UAAU,CAAC,CAAC;IAEvC,IAAI,MAAM,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;QAC9B,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,MAAM,KAAK,MAAM,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC;IACjE,CAAC;SAAM,CAAC;QACP,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,KAAK,MAAM,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC;IAC7D,CAAC;AACF,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,MAAc;IAC/C,QAAQ,MAAM,EAAE,CAAC;QAChB,KAAK,SAAS;YACb,OAAO,IAAI,CAAC;QACb,KAAK,aAAa;YACjB,OAAO,IAAI,CAAC;QACb,KAAK,WAAW;YACf,OAAO,GAAG,CAAC;QACZ,KAAK,WAAW;YACf,OAAO,GAAG,CAAC;QACZ;YACC,OAAO,IAAI,CAAC;IACd,CAAC;AACF,CAAC"}

package/dist/utils/workspace-manager.d.ts

@@ -0,0 +1,65 @@
+/**
+ * Workspace Manager
+ *
+ * Manages workspace-level state including:
+ * - Current project resolution (from .braingrid/project.json)
+ * - Active requirement context (session-scoped)
+ *
+ * This provides a centralized way to access workspace context across handlers.
+ */
+/**
+ * Result type for project resolution
+ */
+export type WorkspaceProjectResult = {
+    success: true;
+    projectId: string;
+} | {
+    success: false;
+    error: string;
+};
+/**
+ * Manages workspace-level state
+ *
+ * Singleton pattern - one instance per CLI session
+ */
+export declare class WorkspaceManager {
+    private activeRequirementId;
+    /**
+     * Get the project ID for the current workspace
+     *
+     * Resolution order:
+     * 1. If explicitProjectId provided → normalize and return it
+     * 2. Check .braingrid/project.json for configured project (at git root)
+     * 3. If not initialized → return error with initialization instructions
+     *
+     * @param explicitProjectId - Optional project ID from -p or --project flag
+     * @returns Result with either projectId (normalized) or error message
+     */
+    getProject(explicitProjectId?: string): Promise<WorkspaceProjectResult>;
+    /**
+     * Set the active requirement for this workspace session
+     *
+     * This is used to automatically include requirement context in agent conversations
+     *
+     * @param requirementId - The requirement ID to set as active
+     */
+    setActiveRequirement(requirementId: string): void;
+    /**
+     * Get the currently active requirement ID
+     *
+     * @returns The active requirement ID or null if none set
+     */
+    getActiveRequirement(): string | null;
+    /**
+     * Clear the active requirement
+     */
+    clearActiveRequirement(): void;
+    /**
+     * Check if there is an active requirement set
+     *
+     * @returns true if a requirement is active, false otherwise
+     */
+    hasActiveRequirement(): boolean;
+}
+export declare const workspaceManager: WorkspaceManager;
+//# sourceMappingURL=workspace-manager.d.ts.map

package/dist/utils/workspace-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace-manager.d.ts","sourceRoot":"","sources":["../../src/utils/workspace-manager.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAMH;;GAEG;AACH,MAAM,MAAM,sBAAsB,GAC/B;IACA,OAAO,EAAE,IAAI,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;CACjB,GACD;IACA,OAAO,EAAE,KAAK,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;CACb,CAAC;AAEL;;;;GAIG;AACH,qBAAa,gBAAgB;IAC5B,OAAO,CAAC,mBAAmB,CAAuB;IAElD;;;;;;;;;;OAUG;IACG,UAAU,CAAC,iBAAiB,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,sBAAsB,CAAC;IAkC7E;;;;;;OAMG;IACH,oBAAoB,CAAC,aAAa,EAAE,MAAM,GAAG,IAAI;IAIjD;;;;OAIG;IACH,oBAAoB,IAAI,MAAM,GAAG,IAAI;IAIrC;;OAEG;IACH,sBAAsB,IAAI,IAAI;IAI9B;;;;OAIG;IACH,oBAAoB,IAAI,OAAO;CAG/B;AAGD,eAAO,MAAM,gBAAgB,kBAAyB,CAAC"}

package/dist/utils/workspace-manager.js

@@ -0,0 +1,98 @@
+/**
+ * Workspace Manager
+ *
+ * Manages workspace-level state including:
+ * - Current project resolution (from .braingrid/project.json)
+ * - Active requirement context (session-scoped)
+ *
+ * This provides a centralized way to access workspace context across handlers.
+ */
+import chalk from 'chalk';
+import { getLocalProjectId } from './local-store.js';
+import { parseProjectId } from './projects.js';
+/**
+ * Manages workspace-level state
+ *
+ * Singleton pattern - one instance per CLI session
+ */
+export class WorkspaceManager {
+    constructor() {
+        this.activeRequirementId = null;
+    }
+    /**
+     * Get the project ID for the current workspace
+     *
+     * Resolution order:
+     * 1. If explicitProjectId provided → normalize and return it
+     * 2. Check .braingrid/project.json for configured project (at git root)
+     * 3. If not initialized → return error with initialization instructions
+     *
+     * @param explicitProjectId - Optional project ID from -p or --project flag
+     * @returns Result with either projectId (normalized) or error message
+     */
+    async getProject(explicitProjectId) {
+        // If explicit project provided via flag
+        if (explicitProjectId) {
+            const normalized = parseProjectId(explicitProjectId);
+            return {
+                success: true,
+                projectId: normalized,
+            };
+        }
+        // Try to get from .braingrid/project.json (searches git root first)
+        const localProjectId = await getLocalProjectId();
+        if (localProjectId) {
+            const normalized = parseProjectId(localProjectId);
+            return {
+                success: true,
+                projectId: normalized,
+            };
+        }
+        // Not initialized
+        return {
+            success: false,
+            error: chalk.red('❌ No project specified and no local project found.') +
+                '\n\n' +
+                chalk.dim('To initialize this workspace, run:\n') +
+                chalk.cyan('  braingrid init --wizard') +
+                '\n\n' +
+                chalk.dim('Or specify a project explicitly:\n') +
+                chalk.cyan('  braingrid <command> -p PROJ-123'),
+        };
+    }
+    /**
+     * Set the active requirement for this workspace session
+     *
+     * This is used to automatically include requirement context in agent conversations
+     *
+     * @param requirementId - The requirement ID to set as active
+     */
+    setActiveRequirement(requirementId) {
+        this.activeRequirementId = requirementId;
+    }
+    /**
+     * Get the currently active requirement ID
+     *
+     * @returns The active requirement ID or null if none set
+     */
+    getActiveRequirement() {
+        return this.activeRequirementId;
+    }
+    /**
+     * Clear the active requirement
+     */
+    clearActiveRequirement() {
+        this.activeRequirementId = null;
+    }
+    /**
+     * Check if there is an active requirement set
+     *
+     * @returns true if a requirement is active, false otherwise
+     */
+    hasActiveRequirement() {
+        return this.activeRequirementId !== null;
+    }
+}
+// Export singleton instance
+export const workspaceManager = new WorkspaceManager();
+//# sourceMappingURL=workspace-manager.js.map

package/dist/utils/workspace-manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace-manager.js","sourceRoot":"","sources":["../../src/utils/workspace-manager.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAe/C;;;;GAIG;AACH,MAAM,OAAO,gBAAgB;IAA7B;QACS,wBAAmB,GAAkB,IAAI,CAAC;IAkFnD,CAAC;IAhFA;;;;;;;;;;OAUG;IACH,KAAK,CAAC,UAAU,CAAC,iBAA0B;QAC1C,wCAAwC;QACxC,IAAI,iBAAiB,EAAE,CAAC;YACvB,MAAM,UAAU,GAAG,cAAc,CAAC,iBAAiB,CAAC,CAAC;YACrD,OAAO;gBACN,OAAO,EAAE,IAAI;gBACb,SAAS,EAAE,UAAU;aACrB,CAAC;QACH,CAAC;QAED,oEAAoE;QACpE,MAAM,cAAc,GAAG,MAAM,iBAAiB,EAAE,CAAC;QACjD,IAAI,cAAc,EAAE,CAAC;YACpB,MAAM,UAAU,GAAG,cAAc,CAAC,cAAc,CAAC,CAAC;YAClD,OAAO;gBACN,OAAO,EAAE,IAAI;gBACb,SAAS,EAAE,UAAU;aACrB,CAAC;QACH,CAAC;QAED,kBAAkB;QAClB,OAAO;YACN,OAAO,EAAE,KAAK;YACd,KAAK,EACJ,KAAK,CAAC,GAAG,CAAC,oDAAoD,CAAC;gBAC/D,MAAM;gBACN,KAAK,CAAC,GAAG,CAAC,sCAAsC,CAAC;gBACjD,KAAK,CAAC,IAAI,CAAC,2BAA2B,CAAC;gBACvC,MAAM;gBACN,KAAK,CAAC,GAAG,CAAC,oCAAoC,CAAC;gBAC/C,KAAK,CAAC,IAAI,CAAC,mCAAmC,CAAC;SAChD,CAAC;IACH,CAAC;IAED;;;;;;OAMG;IACH,oBAAoB,CAAC,aAAqB;QACzC,IAAI,CAAC,mBAAmB,GAAG,aAAa,CAAC;IAC1C,CAAC;IAED;;;;OAIG;IACH,oBAAoB;QACnB,OAAO,IAAI,CAAC,mBAAmB,CAAC;IACjC,CAAC;IAED;;OAEG;IACH,sBAAsB;QACrB,IAAI,CAAC,mBAAmB,GAAG,IAAI,CAAC;IACjC,CAAC;IAED;;;;OAIG;IACH,oBAAoB;QACnB,OAAO,IAAI,CAAC,mBAAmB,KAAK,IAAI,CAAC;IAC1C,CAAC;CACD;AAED,4BAA4B;AAC5B,MAAM,CAAC,MAAM,gBAAgB,GAAG,IAAI,gBAAgB,EAAE,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@braingrid/cli",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "BrainGrid - Turn thoughts into AI-ready specs. Command-line interface for spec-driven development.",
   "type": "module",
   "main": "dist/cli.js",
@@ -38,6 +38,7 @@
     "chalk": "^5.3.0",
     "commander": "^12.0.0",
     "conf": "13.0.1",
+    "ink": "^6.3.1",
     "node-machine-id": "1.1.12",
     "open": "^10.1.0",
     "zod": "^4.1.11",
@@ -62,6 +63,8 @@
     "build:prod": "NODE_ENV=production tsc -p .",
     "dev": "tsx src/cli.ts",
     "dev:local": "NODE_ENV=local tsx src/cli.ts",
+    "docs:fetch-openapi": "mkdir -p docs && gh api repos/BrainGridAI/braingrid-app/contents/src/app/api/v1/openapi.yaml | jq -r '.content' | base64 -D > docs/openapi.yaml",
+    "docs:sync": "bash scripts/sync-docs-to-braingrid.sh",
     "start": "NODE_ENV=production node dist/cli.js",
     "start:local": "NODE_ENV=local node dist/cli.js",
     "start:dev": "NODE_ENV=development node dist/cli.js",