@braingrid/cli 0.2.55 → 0.2.56

package/CHANGELOG.md

@@ -7,6 +7,14 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.2.56] - 2026-03-03
+
+### Changed
+
+- **`/build` converted from command to skill** — moved `.claude/commands/build.md` to `.claude/skills/build/skill.md` with skill-style frontmatter; setup handler now auto-detects and removes the deprecated command file on install, init, and update paths
+- **Removed `braingrid requirement build` and `braingrid requirement breakdown` CLI commands** — build workflow now handled entirely by the `/build` skill; `/specify` and `/save-requirement` updated to reference the skill
+- **Updated E2E and unit tests** — setup tests now expect 5 skill directories and validate deprecated file cleanup
+
 ## [0.2.55] - 2026-02-26
 
 ### Fixed

package/README.md

@@ -46,7 +46,7 @@ npm install -g @braingrid/cli
 braingrid setup claude-code
 ```
 
-Installs slash commands (`/specify`, `/breakdown`, `/build`), BrainGrid skill, and status line showing your project/requirement/task context in real-time.
+Installs slash commands (`/specify`, `/build`), BrainGrid skill, and status line showing your project/requirement/task context in real-time.
 
 [→ Full Claude Code setup guide](./.braingrid/README.md)
 
@@ -71,11 +71,8 @@ braingrid init
 # 2. Create a requirement with AI refinement
 braingrid specify --prompt "Add user authentication"
 
-# 3. Break down requirement into tasks with AI
-braingrid requirement breakdown REQ-1
-
-# 4. Build requirement with all tasks (markdown with full content)
-braingrid requirement build REQ-1
+# 3. Show requirement with all tasks (markdown with full content)
+braingrid requirement show REQ-1 --format markdown
 ```
 
 ---
@@ -145,15 +142,15 @@ braingrid setup cursor --dry-run
 **What gets installed:**
 
 - **Claude Code integration:**
-  - Commands in `.claude/commands/` (specify, breakdown, build, save-requirement)
-  - Skills in `.claude/skills/braingrid-cli/`
+  - Commands in `.claude/commands/` (specify, save-requirement)
+  - Skills in `.claude/skills/` (braingrid-cli, build, frontend-design, ux)
   - Status line script at `.claude/statusline.sh`
   - Hook script at `.claude/hooks/sync-braingrid-task.sh` for task status sync
   - Settings in `.claude/settings.json` (configures status line and hooks)
   - Content injected into `CLAUDE.md` (or creates it if it doesn't exist)
 
 - **Cursor integration:**
-  - Commands in `.cursor/commands/` (specify, breakdown, build, save-requirement)
+  - Commands in `.cursor/commands/` (specify, build, save-requirement)
   - Rules in `.cursor/rules/`
   - Content injected into `AGENTS.md` (or creates it if it doesn't exist)
 
@@ -216,8 +213,6 @@ 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"] [--content "markdown"]
 braingrid requirement delete [id] [--force]
-braingrid requirement breakdown [id] [--format markdown|json|xml]
-braingrid requirement build [id] [--format markdown|json|xml]
 braingrid requirement create-branch [id] [--name <branch-name>] [--base <branch>]
 braingrid requirement review [id] [--pr <number>]
 
@@ -335,7 +330,7 @@ eval "$(braingrid completion zsh)"
 ### What Gets Completed
 
 - **Commands**: `login`, `logout`, `project`, `requirement`, `task`, etc.
-- **Subcommands**: `list`, `show`, `create`, `update`, `delete`, `breakdown`, `build`, `create-branch`, `review`, `summary`, `specify`, `tag`
+- **Subcommands**: `list`, `show`, `create`, `update`, `delete`, `create-branch`, `review`, `summary`, `specify`, `tag`
 - **Options**: `--help`, `--format`, `--status`, `--project`, `--requirement`
 - **Values**: Status values (`IDEA`, `PLANNED`, `IN_PROGRESS`, etc.), format options (`table`, `json`, `xml`, `markdown`)
 

package/dist/cli.js

@@ -15,7 +15,7 @@ import {
 
 // src/cli.ts
 import { existsSync } from "fs";
-import { resolve } from "path";
+import { resolve as resolve2 } from "path";
 import { fileURLToPath } from "url";
 import { config } from "dotenv";
 import { createRequire } from "module";
@@ -63,8 +63,6 @@ function createCompletion() {
   });
   completion.on("requirement", ({ reply }) => {
     reply([
-      "breakdown",
-      "build",
       "create",
       "create-branch",
       "delete",
@@ -155,7 +153,7 @@ var DEFAULT_OPTIONS = {
   // No-op by default
 };
 async function sleep(ms) {
-  return new Promise((resolve2) => setTimeout(resolve2, ms));
+  return new Promise((resolve3) => setTimeout(resolve3, ms));
 }
 function calculateDelay(attempt, initialDelay, maxDelay, backoffMultiplier) {
   const exponentialDelay = initialDelay * backoffMultiplier ** (attempt - 1);
@@ -228,7 +226,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.55" : "0.0.0-test";
+var CLI_VERSION = true ? "0.2.56" : "0.0.0-test";
 var PRODUCTION_CONFIG = {
   apiUrl: "https://app.braingrid.ai",
   workosAuthUrl: "https://auth.braingrid.ai",
@@ -619,7 +617,7 @@ var OAuth2Handler = class {
    * Start local HTTP server to handle OAuth callback
    */
   async startCallbackServer(port) {
-    return new Promise((resolve2) => {
+    return new Promise((resolve3) => {
       this.server = createServer((req, res) => {
         const url = new URL(req.url || "", `http://127.0.0.1:${port}`);
         if (url.pathname === "/callback") {
@@ -722,7 +720,7 @@ var OAuth2Handler = class {
       });
       this.server.listen(port, "0.0.0.0", () => {
         logger.debug(`Callback server listening on http://127.0.0.1:${port}`);
-        resolve2();
+        resolve3();
       });
     });
   }
@@ -787,7 +785,7 @@ var OAuth2Handler = class {
    * Wait for the authorization code from the callback
    */
   async waitForAuthorizationCode(timeoutMs = 3e5) {
-    return new Promise((resolve2, reject) => {
+    return new Promise((resolve3, reject) => {
       const startTime = Date.now();
       const checkInterval = setInterval(() => {
         if (this.abortController?.signal.aborted) {
@@ -802,7 +800,7 @@ var OAuth2Handler = class {
         }
         if (this.authorizationCode) {
           clearInterval(checkInterval);
-          resolve2(this.authorizationCode);
+          resolve3(this.authorizationCode);
           return;
         }
         if (Date.now() - startTime > timeoutMs) {
@@ -2706,19 +2704,19 @@ function closeLogger() {
   logFile = null;
 }
 function flushLogger() {
-  return new Promise((resolve2) => {
+  return new Promise((resolve3) => {
     if (!logStream) {
-      resolve2();
+      resolve3();
       return;
     }
     if (logStream.writableLength === 0) {
-      resolve2();
+      resolve3();
       return;
     }
-    const timeout = setTimeout(resolve2, 1e3);
+    const timeout = setTimeout(resolve3, 1e3);
     logStream.once("drain", () => {
       clearTimeout(timeout);
-      resolve2();
+      resolve3();
     });
   });
 }
@@ -2782,7 +2780,7 @@ async function withRetry(fn, retries = MAX_RETRIES, delay = INITIAL_RETRY_DELAY)
       throw error;
     }
     log("WARN", "github-api", "retry", `attempt=${MAX_RETRIES - retries + 1} delay=${delay}ms`);
-    await new Promise((resolve2) => setTimeout(resolve2, delay));
+    await new Promise((resolve3) => setTimeout(resolve3, delay));
     return withRetry(fn, retries - 1, delay * 2);
   }
 }
@@ -3670,7 +3668,7 @@ async function waitWithSpinner(message, checkFn, intervalMs = 3e3, maxAttempts =
         return true;
       }
       if (attempt < maxAttempts - 1) {
-        await new Promise((resolve2) => setTimeout(resolve2, intervalMs));
+        await new Promise((resolve3) => setTimeout(resolve3, intervalMs));
       }
     }
     if (spinnerInterval) clearInterval(spinnerInterval);
@@ -3976,6 +3974,18 @@ async function _handleSetup(config2, opts) {
   if (readmeCopied) {
     log("INFO", "setup", "readme", "path=.braingrid/README.md");
   }
+  if (config2.deprecatedFiles?.length) {
+    for (const file of config2.deprecatedFiles) {
+      try {
+        if (await fileExists(file)) {
+          await fs5.unlink(path7.resolve(file));
+          log("INFO", "setup", "cleanup", `removed=${file}`);
+          console.log(chalk10.dim(`  Removed deprecated: ${file}`));
+        }
+      } catch (_error) {
+      }
+    }
+  }
   return {
     success: true,
     data: {
@@ -4008,12 +4018,14 @@ async function handleSetupClaudeCode(opts) {
     sourceDirs: [
       "claude-code/commands",
       "claude-code/skills/braingrid-cli",
+      "claude-code/skills/build",
       "claude-code/skills/frontend-design",
       "claude-code/skills/ux"
     ],
     targetDirs: [
       ".claude/commands",
       ".claude/skills/braingrid-cli",
+      ".claude/skills/build",
       ".claude/skills/frontend-design",
       ".claude/skills/ux"
     ],
@@ -4021,13 +4033,15 @@ async function handleSetupClaudeCode(opts) {
       { label: "Commands", countMode: "files" },
       { label: "Skills", countMode: "single" },
       { label: "Skills", countMode: "single" },
+      { label: "Skills", countMode: "single" },
       { label: "Skills", countMode: "single" }
     ],
     injection: {
       sourceFile: "claude-code/CLAUDE.md",
       targetFile: "CLAUDE.md"
     },
-    docsUrl: "https://docs.braingrid.ai/claude-code"
+    docsUrl: "https://docs.braingrid.ai/claude-code",
+    deprecatedFiles: [".claude/commands/build.md"]
   };
   try {
     const setupResult = await _handleSetup(config2, opts);
@@ -5749,84 +5763,6 @@ function formatRequirementListXml(requirements, pagination) {
   xml += "</requirements>\n";
   return xml;
 }
-function formatRequirementBreakdownMarkdown(requirementShortId, tasks) {
-  let md = `# Breakdown: ${requirementShortId}
-
-`;
-  md += `Generated ${tasks.length} task${tasks.length !== 1 ? "s" : ""}
-
-`;
-  if (tasks.length === 0) {
-    md += "_No tasks generated._\n";
-    return md;
-  }
-  for (const task2 of tasks) {
-    md += `## Task ${task2.number}: ${task2.title}
-
-`;
-    md += `- **Status:** ${task2.status}
-`;
-    md += `- **ID:** ${task2.id}
-`;
-    if (task2.blocked_by.length > 0) {
-      md += `- **Blocked by:** ${task2.blocked_by.join(", ")}
-`;
-    }
-    if (task2.content) {
-      md += `
-### Content
-
-${task2.content}
-`;
-    }
-    md += "\n";
-  }
-  return md;
-}
-function formatRequirementBreakdownXml(requirementShortId, tasks) {
-  let xml = '<?xml version="1.0" encoding="UTF-8"?>\n';
-  xml += "<breakdown>\n";
-  xml += `  <requirement_short_id>${escapeXml(requirementShortId)}</requirement_short_id>
-`;
-  xml += `  <task_count>${tasks.length}</task_count>
-`;
-  xml += "  <tasks>\n";
-  for (const task2 of tasks) {
-    xml += "    <task>\n";
-    xml += `      <number>${escapeXml(task2.number)}</number>
-`;
-    xml += `      <title>${escapeXml(task2.title)}</title>
-`;
-    xml += `      <status>${escapeXml(task2.status)}</status>
-`;
-    xml += `      <id>${escapeXml(task2.id)}</id>
-`;
-    if (task2.content) {
-      xml += `      <content>${escapeXml(task2.content)}</content>
-`;
-    }
-    if (task2.blocked_by.length > 0) {
-      xml += "      <blocked_by>\n";
-      for (const blocker of task2.blocked_by) {
-        xml += `        <task>${escapeXml(blocker)}</task>
-`;
-      }
-      xml += "      </blocked_by>\n";
-    }
-    if (task2.assigned_to) {
-      xml += `      <assigned_to>${escapeXml(task2.assigned_to)}</assigned_to>
-`;
-    }
-    xml += `      <created_at>${escapeXml(task2.created_at)}</created_at>
-`;
-    xml += `      <updated_at>${escapeXml(task2.updated_at)}</updated_at>
-`;
-    xml += "    </task>\n";
-  }
-  xml += "  </tasks>\n";
-  xml += "</breakdown>\n";
-  return xml;
-}
 function formatRequirementBuildMarkdown(requirement2, options) {
   const statusEmoji = getRequirementStatusEmoji(requirement2.status);
   let md = `# ${statusEmoji} ${requirement2.name}
@@ -5897,7 +5833,7 @@ ${requirement2.content}
 `;
   if (tasks.length === 0) {
     md += "_No tasks available_\n\n";
-    md += "\u{1F4A1} _Run `braingrid requirement breakdown [id]` to generate tasks using AI_\n";
+    md += "\u{1F4A1} _No tasks have been created yet for this requirement._\n";
   } else {
     for (let i = 0; i < tasks.length; i++) {
       const task2 = tasks[i];
@@ -5968,20 +5904,6 @@ ${task2.content}
   }
   return md;
 }
-function formatRequirementBuildJson(requirement2) {
-  const tasks = requirement2.tasks || [];
-  if (tasks.length === 0) {
-    return JSON.stringify(
-      {
-        ...requirement2,
-        _hint: "Run 'braingrid requirement breakdown [id]' to generate tasks using AI"
-      },
-      null,
-      2
-    );
-  }
-  return JSON.stringify(requirement2, null, 2);
-}
 function formatRequirementBuildXml(requirement2) {
   let xml = '<?xml version="1.0" encoding="UTF-8"?>\n';
   xml += "<requirement>\n";
@@ -6036,7 +5958,7 @@ function formatRequirementBuildXml(requirement2) {
   xml += `  <tasks count="${tasks.length}">
 `;
   if (tasks.length === 0) {
-    xml += `    <hint>Run 'braingrid requirement breakdown [id]' to generate tasks using AI</hint>
+    xml += `    <hint>No tasks have been created yet for this requirement.</hint>
 `;
   } else {
     for (const task2 of tasks) {
@@ -6887,12 +6809,6 @@ var RequirementService = class {
     const headers = this.getHeaders();
     await this.axios.delete(url, { headers });
   }
-  async breakdownRequirement(projectId, requirementId, data) {
-    const url = `${this.baseUrl}/api/v1/projects/${projectId}/requirements/${requirementId}/breakdown`;
-    const headers = this.getHeaders();
-    const response = await this.axios.post(url, data, { headers });
-    return response.data;
-  }
   async createGitBranch(projectId, requirementId, data) {
     const url = `${this.baseUrl}/api/v1/projects/${projectId}/requirements/${requirementId}/create-git-branch`;
     const headers = this.getHeaders();
@@ -6906,12 +6822,12 @@ var RequirementService = class {
       headers,
       responseType: "stream"
     });
-    return new Promise((resolve2, reject) => {
+    return new Promise((resolve3, reject) => {
       response.data.on("data", (chunk) => {
         onChunk(chunk.toString());
       });
       response.data.on("end", () => {
-        resolve2();
+        resolve3();
       });
       response.data.on("error", (error) => {
         reject(error);
@@ -7497,192 +7413,6 @@ async function handleRequirementDelete(opts) {
     };
   }
 }
-async function handleRequirementBreakdown(opts) {
-  let stop;
-  try {
-    const { requirementService, auth } = getServices3();
-    const isAuthenticated = await auth.isAuthenticated();
-    if (!isAuthenticated) {
-      return {
-        success: false,
-        message: chalk16.red("\u274C Not authenticated. Please run `braingrid login` first.")
-      };
-    }
-    const format = opts.format || "table";
-    if (!["table", "json", "xml", "markdown"].includes(format)) {
-      return {
-        success: false,
-        message: chalk16.red(
-          `\u274C Invalid format: ${format}. Supported formats: table, json, xml, markdown`
-        )
-      };
-    }
-    const requirementResult = await workspaceManager.getRequirement(opts.id);
-    if (!requirementResult.success) {
-      return {
-        success: false,
-        message: requirementResult.error
-      };
-    }
-    const requirementId = requirementResult.requirementId;
-    const workspace = await workspaceManager.getProject(opts.project);
-    if (!workspace.success) {
-      return {
-        success: false,
-        message: workspace.error
-      };
-    }
-    const projectId = workspace.projectId;
-    const normalizedId = normalizeRequirementId(requirementId);
-    stop = showSpinner("Checking requirement...", chalk16.gray);
-    const requirement2 = await requirementService.getProjectRequirement(projectId, normalizedId);
-    stop();
-    const taskCount = requirement2.tasks?.length ?? requirement2.task_progress?.total ?? 0;
-    if (taskCount > 0) {
-      const shortId = requirement2.short_id || normalizedId;
-      return {
-        success: false,
-        message: chalk16.red(
-          `\u274C Cannot breakdown requirement ${shortId} - it already has ${taskCount} task(s)
-
-`
-        ) + "The breakdown command is only for initial task generation from requirements.\nOnce tasks exist, you should manage them individually.\n\n" + chalk16.bold("To add more tasks to this requirement:\n") + chalk16.cyan(`  braingrid task create -r ${shortId} --title "Task title"
-
-`) + chalk16.bold("To view existing tasks:\n") + chalk16.cyan(`  braingrid task list -r ${shortId}`)
-      };
-    }
-    stop = showSpinner("Breaking down requirement into tasks...");
-    const response = await requirementService.breakdownRequirement(projectId, normalizedId, {});
-    stop();
-    let output;
-    switch (format) {
-      case "json": {
-        output = JSON.stringify(response, null, 2);
-        break;
-      }
-      case "xml": {
-        output = formatRequirementBreakdownXml(response.requirement_short_id, response.tasks);
-        break;
-      }
-      case "markdown": {
-        output = formatRequirementBreakdownMarkdown(response.requirement_short_id, response.tasks);
-        break;
-      }
-      default: {
-        output = chalk16.green(
-          `\u2705 Generated ${response.tasks.length} tasks for ${response.requirement_short_id}
-
-`
-        );
-        output += "Number  Status        Title\n";
-        output += `${"\u2500".repeat(80)}
-`;
-        for (const task2 of response.tasks) {
-          const statusEmoji = getRequirementStatusEmoji(task2.status);
-          const number = task2.number.padEnd(6);
-          const statusText = task2.status.padEnd(12);
-          const title = task2.title.substring(0, 55);
-          output += `${number}  ${statusEmoji} ${statusText}  ${title}
-`;
-        }
-        break;
-      }
-    }
-    return {
-      success: true,
-      message: output,
-      data: response
-    };
-  } catch (error) {
-    stop?.();
-    if (error && typeof error === "object" && "response" in error) {
-      return {
-        success: false,
-        message: handleError(
-          error,
-          `breaking down requirement ${opts.id || "unknown"}`
-        )
-      };
-    }
-    const errorMessage = error instanceof Error ? error.message : String(error);
-    return {
-      success: false,
-      message: chalk16.red(`\u274C Error breaking down requirement: ${errorMessage}`)
-    };
-  }
-}
-async function handleRequirementBuild(opts) {
-  let stopSpinner = null;
-  try {
-    const { requirementService, auth, config: config2 } = getServices3();
-    const isAuthenticated = await auth.isAuthenticated();
-    if (!isAuthenticated) {
-      return {
-        success: false,
-        message: chalk16.red("\u274C Not authenticated. Please run `braingrid login` first.")
-      };
-    }
-    const format = opts.format || "markdown";
-    if (!["markdown", "json", "xml"].includes(format)) {
-      return {
-        success: false,
-        message: chalk16.red("\u274C Invalid format. Must be one of: markdown, json, xml")
-      };
-    }
-    const requirementResult = await workspaceManager.getRequirement(opts.id);
-    if (!requirementResult.success) {
-      return {
-        success: false,
-        message: requirementResult.error
-      };
-    }
-    const requirementId = requirementResult.requirementId;
-    const workspace = await workspaceManager.getProject(opts.project);
-    if (!workspace.success) {
-      return {
-        success: false,
-        message: workspace.error
-      };
-    }
-    const projectId = workspace.projectId;
-    const normalizedId = normalizeRequirementId(requirementId);
-    stopSpinner = showSpinner("Building requirement with tasks", chalk16.gray);
-    const requirement2 = await requirementService.getProjectRequirement(projectId, normalizedId);
-    stopSpinner();
-    stopSpinner = null;
-    let output;
-    switch (format) {
-      case "json": {
-        output = formatRequirementBuildJson(requirement2);
-        break;
-      }
-      case "xml": {
-        output = formatRequirementBuildXml(requirement2);
-        break;
-      }
-      default: {
-        output = formatRequirementBuildMarkdown(requirement2, {
-          apiUrl: config2.apiUrl,
-          projectShortId: projectId
-        });
-        break;
-      }
-    }
-    return {
-      success: true,
-      message: output,
-      data: requirement2
-    };
-  } catch (error) {
-    if (stopSpinner) {
-      stopSpinner();
-    }
-    return {
-      success: false,
-      message: formatError(error, getResourceContext("requirement", opts.id || "unknown"))
-    };
-  }
-}
 function slugify(text) {
   return text.toLowerCase().replace(/[^a-z0-9\s-]/g, "").replace(/\s+/g, "-").replace(/-+/g, "-").replace(/^-|-$/g, "").substring(0, 40);
 }
@@ -9042,9 +8772,9 @@ function formatTaskSpecifyMarkdown(response, _apiUrl) {
 
 // src/cli.ts
 var __dirname = fileURLToPath(new URL(".", import.meta.url));
-var packageRoot = resolve(__dirname, "..");
+var packageRoot = resolve2(__dirname, "..");
 var envFile = process.env.NODE_ENV ? `.env.${process.env.NODE_ENV}` : ".env";
-var envPath = resolve(packageRoot, envFile);
+var envPath = resolve2(packageRoot, envFile);
 if (existsSync(envPath)) {
   config({ path: envPath, quiet: true });
 }
@@ -9210,30 +8940,6 @@ requirement.command("delete [id]").description("Delete a requirement (auto-detec
     process.exit(1);
   }
 });
-requirement.command("breakdown [id]").description(
-  "Break down a requirement into actionable tasks using AI (auto-detects ID from git branch if not provided)"
-).option(
-  "-p, --project <id>",
-  "project ID (auto-detects from .braingrid/project.json if not provided)"
-).option("--format <format>", "output format (table, json, xml, markdown)", "markdown").action(async (id, opts) => {
-  const result = await handleRequirementBreakdown({ ...opts, id });
-  console.log(result.message);
-  if (!result.success) {
-    process.exit(1);
-  }
-});
-requirement.command("build [id]").description(
-  "Build requirement with all tasks in specified format (auto-detects ID from git branch if not provided)"
-).option(
-  "-p, --project <id>",
-  "project ID (auto-detects from .braingrid/project.json if not provided)"
-).option("--format <format>", "output format (markdown, json, xml)", "markdown").action(async (id, opts) => {
-  const result = await handleRequirementBuild({ ...opts, id });
-  console.log(result.message);
-  if (!result.success) {
-    process.exit(1);
-  }
-});
 requirement.command("create-branch [id]").description(
   "Create a GitHub branch for a requirement (auto-detects ID from git branch if not provided)"
 ).option(