@braingrid/cli 0.2.23 → 0.2.25

package/dist/cli.js

@@ -1,4 +1,7 @@
 #!/usr/bin/env node
+import {
+  execAsync
+} from "./chunk-6GC3UJCM.js";
 import {
   checkInstalledCliTools,
   detectLinuxPackageManager,
@@ -422,7 +425,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.23" : "0.0.0-test";
+var CLI_VERSION = true ? "0.2.25" : "0.0.0-test";
 var PRODUCTION_CONFIG = {
   apiUrl: "https://app.braingrid.ai",
   workosAuthUrl: "https://auth.braingrid.ai",
@@ -632,7 +635,7 @@ var OAuth2Handler = class {
 					`);
         }
       });
-      this.server.listen(port, "127.0.0.1", () => {
+      this.server.listen(port, "0.0.0.0", () => {
         logger2.debug(`Callback server listening on http://127.0.0.1:${port}`);
         resolve();
       });
@@ -1837,10 +1840,10 @@ var LocalProjectConfigSchema = z.object({
 // src/utils/git.ts
 import { exec } from "child_process";
 import { promisify } from "util";
-var execAsync = promisify(exec);
+var execAsync2 = promisify(exec);
 async function isGitRepository() {
   try {
-    const { stdout } = await execAsync("git rev-parse --is-inside-work-tree");
+    const { stdout } = await execAsync2("git rev-parse --is-inside-work-tree");
     return stdout.trim() === "true";
   } catch {
     return false;
@@ -1848,7 +1851,7 @@ async function isGitRepository() {
 }
 async function getRemoteUrl() {
   try {
-    const { stdout } = await execAsync("git config --get remote.origin.url");
+    const { stdout } = await execAsync2("git config --get remote.origin.url");
     return stdout.trim() || null;
   } catch {
     return null;
@@ -1874,7 +1877,7 @@ function parseGitHubRepo(url) {
 }
 async function getCurrentBranch() {
   try {
-    const { stdout } = await execAsync("git rev-parse --abbrev-ref HEAD");
+    const { stdout } = await execAsync2("git rev-parse --abbrev-ref HEAD");
     return stdout.trim() || null;
   } catch {
     return null;
@@ -1890,7 +1893,7 @@ function parseRequirementFromBranch(branchName) {
 }
 async function getGitRoot() {
   try {
-    const { stdout } = await execAsync("git rev-parse --show-toplevel");
+    const { stdout } = await execAsync2("git rev-parse --show-toplevel");
     return stdout.trim() || null;
   } catch {
     return null;
@@ -1900,12 +1903,12 @@ async function getGitUser() {
   let name = null;
   let email = null;
   try {
-    const { stdout: nameStdout } = await execAsync("git config --get user.name");
+    const { stdout: nameStdout } = await execAsync2("git config --get user.name");
     name = nameStdout.trim() || null;
   } catch {
   }
   try {
-    const { stdout: emailStdout } = await execAsync("git config --get user.email");
+    const { stdout: emailStdout } = await execAsync2("git config --get user.email");
     email = emailStdout.trim() || null;
   } catch {
   }
@@ -3828,6 +3831,31 @@ var RequirementService = class {
     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();
+    const response = await this.axios.post(url, data, { headers });
+    return response.data;
+  }
+  async reviewAcceptance(projectId, requirementId, data, onChunk) {
+    const url = `${this.baseUrl}/api/v1/projects/${projectId}/requirements/${requirementId}/review/acceptance`;
+    const headers = this.getHeaders();
+    const response = await this.axios.post(url, data, {
+      headers,
+      responseType: "stream"
+    });
+    return new Promise((resolve, reject) => {
+      response.data.on("data", (chunk) => {
+        onChunk(chunk.toString());
+      });
+      response.data.on("end", () => {
+        resolve();
+      });
+      response.data.on("error", (error) => {
+        reject(error);
+      });
+    });
+  }
 };
 
 // src/handlers/requirement.handlers.ts
@@ -4464,6 +4492,190 @@ async function handleRequirementBuild(opts) {
     };
   }
 }
+function slugify(text) {
+  return text.toLowerCase().replace(/[^a-z0-9\s-]/g, "").replace(/\s+/g, "-").replace(/-+/g, "-").replace(/^-|-$/g, "").substring(0, 40);
+}
+async function handleCreateGitBranch(opts) {
+  let stopSpinner = null;
+  try {
+    const { requirementService, auth } = getServices2();
+    const isAuthenticated = await auth.isAuthenticated();
+    if (!isAuthenticated) {
+      return {
+        success: false,
+        message: chalk7.red("\u274C Not authenticated. Please run `braingrid login` first.")
+      };
+    }
+    const format = opts.format || "table";
+    if (!["table", "json", "markdown"].includes(format)) {
+      return {
+        success: false,
+        message: chalk7.red(
+          `\u274C Invalid format: ${format}. Supported formats: table, json, 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);
+    let branchName = opts.name;
+    if (!branchName) {
+      const user = await auth.getCurrentUser();
+      if (!user) {
+        return {
+          success: false,
+          message: chalk7.red("\u274C Could not get current user for branch name generation")
+        };
+      }
+      const requirement2 = await requirementService.getProjectRequirement(projectId, normalizedId);
+      const username = slugify(user.email.split("@")[0]);
+      const reqShortId = requirement2.short_id || normalizedId;
+      const sluggedName = slugify(requirement2.name);
+      branchName = `${username}/${reqShortId}-${sluggedName}`;
+    }
+    stopSpinner = showSpinner("Creating GitHub branch...", chalk7.gray);
+    const response = await requirementService.createGitBranch(projectId, normalizedId, {
+      branchName,
+      baseBranch: opts.base
+    });
+    stopSpinner();
+    stopSpinner = null;
+    let output;
+    switch (format) {
+      case "json": {
+        output = JSON.stringify(response, null, 2);
+        break;
+      }
+      case "markdown": {
+        output = `# Branch Created
+
+`;
+        output += `**Branch:** \`${response.branch.name}\`
+`;
+        output += `**SHA:** \`${response.branch.sha.substring(0, 7)}\`
+
+`;
+        output += `## Checkout Command
+
+`;
+        output += `\`\`\`bash
+git fetch origin && git checkout ${response.branch.name}
+\`\`\`
+`;
+        break;
+      }
+      case "table":
+      default: {
+        output = chalk7.green(`\u2705 Created branch: ${response.branch.name}
+
+`);
+        output += `${chalk7.bold("SHA:")} ${response.branch.sha.substring(0, 7)}
+`;
+        output += `
+${chalk7.dim("To checkout:")} git fetch origin && git checkout ${response.branch.name}`;
+        break;
+      }
+    }
+    return {
+      success: true,
+      message: output,
+      data: response
+    };
+  } catch (error) {
+    if (stopSpinner) {
+      stopSpinner();
+    }
+    return {
+      success: false,
+      message: formatError(error, getResourceContext("requirement", opts.id || "unknown"))
+    };
+  }
+}
+async function handleReviewAcceptance(opts) {
+  try {
+    const { requirementService, auth } = getServices2();
+    const isAuthenticated = await auth.isAuthenticated();
+    if (!isAuthenticated) {
+      return {
+        success: false,
+        message: chalk7.red("\u274C Not authenticated. Please run `braingrid login` first.")
+      };
+    }
+    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);
+    let prNumber = opts.pr;
+    if (!prNumber) {
+      const { execAsync: execAsync5 } = await import("./command-execution-7JMH2DK4.js");
+      try {
+        const { stdout } = await execAsync5("gh pr view --json number -q .number");
+        const detectedPrNumber = stdout.trim();
+        if (!detectedPrNumber) {
+          throw new Error("No PR number returned from gh CLI");
+        }
+        prNumber = detectedPrNumber;
+      } catch {
+        return {
+          success: false,
+          message: chalk7.red(
+            "\u274C No PR specified and could not detect PR for current branch.\n   Use --pr <number> or ensure you have an open PR for this branch."
+          )
+        };
+      }
+    }
+    console.log(chalk7.bold("\n\u{1F50D} AI Code Review\n"));
+    let fullOutput = "";
+    await requirementService.reviewAcceptance(
+      projectId,
+      normalizedId,
+      { pullRequest: prNumber },
+      (chunk) => {
+        process.stdout.write(chunk);
+        fullOutput += chunk;
+      }
+    );
+    console.log("\n");
+    return {
+      success: true,
+      message: "",
+      // Already printed via streaming
+      data: { review: fullOutput }
+    };
+  } catch (error) {
+    return {
+      success: false,
+      message: formatError(error, getResourceContext("requirement", opts.id || "unknown"))
+    };
+  }
+}
 
 // src/handlers/task.handlers.ts
 import chalk8 from "chalk";
@@ -4512,6 +4724,12 @@ var TaskService = class {
     const headers = this.getHeaders();
     await this.axios.delete(url, { headers });
   }
+  async specifyTask(projectId, requirementId, data) {
+    const url = `${this.baseUrl}/api/v1/projects/${projectId}/requirements/${requirementId}/tasks/specify`;
+    const headers = this.getHeaders();
+    const response = await this.axios.post(url, data, { headers });
+    return response.data;
+  }
 };
 
 // src/handlers/task.handlers.ts
@@ -4977,6 +5195,117 @@ async function handleTaskDelete(id, opts) {
     };
   }
 }
+async function handleTaskSpecify(opts) {
+  let stopSpinner = null;
+  try {
+    const { taskService, auth } = getServices3();
+    const isAuthenticated = await auth.isAuthenticated();
+    if (!isAuthenticated) {
+      return {
+        success: false,
+        message: chalk8.red("\u274C Not authenticated. Please run `braingrid login` first.")
+      };
+    }
+    const format = opts.format || "table";
+    if (!["table", "json", "markdown"].includes(format)) {
+      return {
+        success: false,
+        message: chalk8.red(
+          `\u274C Invalid format: ${format}. Supported formats: table, json, markdown`
+        )
+      };
+    }
+    const workspace = await workspaceManager.getProject(opts.project);
+    if (!workspace.success) {
+      return {
+        success: false,
+        message: workspace.error
+      };
+    }
+    const projectId = workspace.projectId;
+    const requirementResult = await workspaceManager.getRequirement(opts.requirement);
+    if (!requirementResult.success) {
+      return {
+        success: false,
+        message: requirementResult.error
+      };
+    }
+    const requirementId = requirementResult.requirementId;
+    if (opts.prompt.length < 10) {
+      return {
+        success: false,
+        message: chalk8.red("\u274C Prompt must be at least 10 characters long")
+      };
+    }
+    if (opts.prompt.length > 5e3) {
+      return {
+        success: false,
+        message: chalk8.red("\u274C Prompt must be no more than 5000 characters long")
+      };
+    }
+    stopSpinner = showSpinner("Creating task from prompt...", chalk8.gray);
+    const response = await taskService.specifyTask(projectId, requirementId, {
+      prompt: opts.prompt
+    });
+    stopSpinner();
+    stopSpinner = null;
+    const config = getConfig();
+    let output;
+    switch (format) {
+      case "json": {
+        output = JSON.stringify(response, null, 2);
+        break;
+      }
+      case "markdown": {
+        output = formatTaskSpecifyMarkdown(response, config.apiUrl);
+        break;
+      }
+      case "table":
+      default: {
+        output = formatTaskSpecifyTable(response);
+        break;
+      }
+    }
+    return {
+      success: true,
+      message: output,
+      data: response
+    };
+  } catch (error) {
+    if (stopSpinner) {
+      stopSpinner();
+    }
+    return {
+      success: false,
+      message: formatError(error, "specifying task")
+    };
+  }
+}
+function formatTaskSpecifyTable(response) {
+  const task2 = response.task;
+  const lines = [];
+  lines.push(chalk8.green(`\u2705 Created task ${response.requirement_short_id}/TASK-${task2.number}`));
+  lines.push("");
+  lines.push(`${chalk8.bold("Title:")}   ${task2.title}`);
+  lines.push(`${chalk8.bold("Status:")}  ${task2.status}`);
+  return lines.join("\n");
+}
+function formatTaskSpecifyMarkdown(response, _apiUrl) {
+  const task2 = response.task;
+  const lines = [];
+  lines.push(`# Task ${response.requirement_short_id}/TASK-${task2.number}: ${task2.title}`);
+  lines.push("");
+  lines.push(`**Status:** ${task2.status}`);
+  lines.push(`**Requirement:** ${response.requirement_short_id}`);
+  lines.push(`**Project:** ${response.project_short_id}`);
+  lines.push("");
+  if (task2.content) {
+    lines.push("## Content");
+    lines.push("");
+    lines.push(task2.content);
+  }
+  return lines.join("\n");
+}
 
 // src/handlers/auth.handlers.ts
 import chalk9 from "chalk";
@@ -5332,7 +5661,7 @@ var GitHubService = class {
 import { exec as exec2 } from "child_process";
 import { promisify as promisify2 } from "util";
 import chalk11 from "chalk";
-var execAsync2 = promisify2(exec2);
+var execAsync3 = promisify2(exec2);
 async function isGitInstalled() {
   return isCliInstalled("git");
 }
@@ -5345,7 +5674,7 @@ async function getGitVersion() {
 async function installViaHomebrew() {
   console.log(chalk11.blue("\u{1F4E6} Installing Git via Homebrew..."));
   try {
-    await execAsync2("brew install git", {
+    await execAsync3("brew install git", {
       timeout: 3e5
       // 5 minutes
     });
@@ -5373,7 +5702,7 @@ async function installViaXcodeSelect() {
   console.log(chalk11.blue("\u{1F4E6} Installing Git via Xcode Command Line Tools..."));
   console.log(chalk11.dim('A system dialog will appear - click "Install" to continue.\n'));
   try {
-    await execAsync2("xcode-select --install", {
+    await execAsync3("xcode-select --install", {
       timeout: 6e5
       // 10 minutes (user interaction required)
     });
@@ -5414,7 +5743,7 @@ async function installGitWindows() {
   }
   console.log(chalk11.blue("\u{1F4E6} Installing Git via winget..."));
   try {
-    await execAsync2("winget install --id Git.Git -e --source winget --silent", {
+    await execAsync3("winget install --id Git.Git -e --source winget --silent", {
       timeout: 3e5
       // 5 minutes
     });
@@ -5469,7 +5798,7 @@ async function installGitLinux() {
           message: chalk11.red(`\u274C Unsupported package manager: ${packageManager.name}`)
         };
     }
-    await execAsync2(installCommand, {
+    await execAsync3(installCommand, {
       timeout: 3e5
       // 5 minutes
     });
@@ -5671,28 +6000,6 @@ import { select as select2 } from "@inquirer/prompts";
 import * as path4 from "path";
 import * as fs4 from "fs/promises";
 
-// src/utils/command-execution.ts
-import { exec as exec3, spawn } from "child_process";
-import { promisify as promisify3 } from "util";
-var execAsyncReal = promisify3(exec3);
-async function execAsync3(command, options, isTestMode = false, mockExecHandler) {
-  if (isTestMode && mockExecHandler) {
-    return mockExecHandler(command);
-  }
-  const defaultOptions = {
-    maxBuffer: 1024 * 1024 * 10,
-    // 10MB default
-    timeout: 3e5,
-    // 5 minutes
-    ...options
-  };
-  if (command.includes("claude")) {
-    defaultOptions.maxBuffer = 1024 * 1024 * 50;
-    defaultOptions.timeout = 6e5;
-  }
-  return execAsyncReal(command, defaultOptions);
-}
-
 // src/services/setup-service.ts
 import * as fs3 from "fs/promises";
 import * as path3 from "path";
@@ -5743,7 +6050,7 @@ async function fetchFileFromGitHub(path6) {
   return withRetry(async () => {
     try {
       const command = `gh api repos/${GITHUB_OWNER}/${GITHUB_REPO}/contents/${path6}`;
-      const { stdout } = await execAsync3(command);
+      const { stdout } = await execAsync(command);
       const response = JSON.parse(stdout);
       if (response.type !== "file") {
         throw new Error(`Path ${path6} is not a file`);
@@ -5766,7 +6073,7 @@ async function listGitHubDirectory(path6) {
   return withRetry(async () => {
     try {
       const command = `gh api repos/${GITHUB_OWNER}/${GITHUB_REPO}/contents/${path6}`;
-      const { stdout } = await execAsync3(command);
+      const { stdout } = await execAsync(command);
       const response = JSON.parse(stdout);
       if (!Array.isArray(response)) {
         throw new Error(`Path ${path6} is not a directory`);
@@ -5899,7 +6206,7 @@ async function fileExists(filePath) {
 }
 async function checkPrerequisites() {
   try {
-    await execAsync3("gh --version");
+    await execAsync("gh --version");
   } catch {
     return {
       success: false,
@@ -5907,7 +6214,7 @@ async function checkPrerequisites() {
     };
   }
   try {
-    await execAsync3("gh auth status");
+    await execAsync("gh auth status");
   } catch {
     return {
       success: false,
@@ -6281,10 +6588,10 @@ async function checkAndShowUpdateWarning() {
 import { access as access3 } from "fs/promises";
 
 // src/utils/github-repo.ts
-import { exec as exec4 } from "child_process";
-import { promisify as promisify4 } from "util";
+import { exec as exec3 } from "child_process";
+import { promisify as promisify3 } from "util";
 import path5 from "path";
-var execAsync4 = promisify4(exec4);
+var execAsync4 = promisify3(exec3);
 async function initGitRepo() {
   try {
     await execAsync4("git init");
@@ -7293,6 +7600,30 @@ requirement.command("build [id]").description(
     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(
+  "-p, --project <id>",
+  "project ID (auto-detects from .braingrid/project.json if not provided)"
+).option("--name <name>", "branch name (auto-generates {username}/REQ-123-slug if not provided)").option("--base <branch>", "base branch to create from (defaults to repository default branch)").option("--format <format>", "output format (table, json, markdown)", "table").action(async (id, opts) => {
+  const result = await handleCreateGitBranch({ ...opts, id });
+  console.log(result.message);
+  if (!result.success) {
+    process.exit(1);
+  }
+});
+requirement.command("review [id]").description("Run AI code review for a requirement PR (auto-detects ID and PR from git branch)").option(
+  "-p, --project <id>",
+  "project ID (auto-detects from .braingrid/project.json if not provided)"
+).option("--pr <number>", "PR number or URL (auto-detects from current branch if not provided)").action(async (id, opts) => {
+  const result = await handleReviewAcceptance({ ...opts, id });
+  if (result.message) {
+    console.log(result.message);
+  }
+  if (!result.success) {
+    process.exit(1);
+  }
+});
 var task = program.command("task").description("Manage tasks");
 task.command("list").description("List tasks for a requirement").option("-r, --requirement <id>", "requirement ID (REQ-456, auto-detects project if initialized)").option("-p, --project <id>", "project ID (PROJ-123, optional if project is initialized)").option("--format <format>", "output format (table, json, xml, markdown)", "markdown").option("--page <page>", "page number for pagination", "1").option("--limit <limit>", "number of tasks per page", "20").action(async (opts) => {
   const result = await handleTaskList(opts);
@@ -7336,6 +7667,16 @@ task.command("delete <id>").description("Delete a task").option("-r, --requireme
     process.exit(1);
   }
 });
+task.command("specify").description("Create a single task from a prompt using AI").option(
+  "-r, --requirement <id>",
+  "requirement ID (REQ-456, auto-detects from git branch if not provided)"
+).option("-p, --project <id>", "project ID (PROJ-123, optional if project is initialized)").requiredOption("--prompt <prompt>", "task description (10-5000 characters)").option("--format <format>", "output format (table, json, markdown)", "table").action(async (opts) => {
+  const result = await handleTaskSpecify(opts);
+  console.log(result.message);
+  if (!result.success) {
+    process.exit(1);
+  }
+});
 program.command("completion [shell]").description("Generate shell completion script (bash, zsh)").option("--setup", "automatically install completion for current shell").option("-s, --shell <shell>", "shell type (bash, zsh)").action(async (shell, opts) => {
   const result = await handleCompletion(shell, opts);
   console.log(result.message);