@braingrid/cli 0.2.60 → 0.2.62

package/CHANGELOG.md

@@ -7,6 +7,22 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.2.62] - 2026-03-20
+
+### Changed
+
+- **Deprecate breakdown command from setup** — removed the breakdown command from the setup flow as it is no longer needed
+
+## [0.2.61] - 2026-03-17
+
+### Added
+
+- **`braingrid setup openclaw` command** — new setup command to configure OpenClaw integration
+
+### Changed
+
+- **Simplify init by removing GitHubService dependency** — streamlined the init flow by eliminating unnecessary GitHub service coupling
+
 ## [0.2.60] - 2026-03-12
 
 ### Changed

package/dist/cli.js

@@ -49,7 +49,8 @@ function createCompletion() {
   completion.on("setup", ({ reply }) => {
     reply([
       "claude-code",
-      "cursor"
+      "cursor",
+      "openclaw"
     ]);
   });
   completion.on("project", ({ reply }) => {
@@ -226,7 +227,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.60" : "0.0.0-test";
+var CLI_VERSION = true ? "0.2.62" : "0.0.0-test";
 var PRODUCTION_CONFIG = {
   apiUrl: "https://app.braingrid.ai",
   workosAuthUrl: "https://auth.braingrid.ai",
@@ -2496,71 +2497,6 @@ function createAuthenticatedAxios(auth) {
   return instance;
 }
 
-// src/services/internal/github-service.ts
-var GitHubService = class {
-  constructor(baseUrl, auth) {
-    this.baseUrl = baseUrl;
-    this.axios = createAuthenticatedAxios(auth);
-  }
-  getHeaders() {
-    return {
-      "Content-Type": "application/json"
-    };
-  }
-  /**
-   * List GitHub installations for the authenticated organization
-   *
-   * @param params - Optional pagination parameters
-   * @param params.page - Page number (default: 1, min: 1)
-   * @param params.limit - Number of installations per page (default: 20, min: 1, max: 100)
-   * @returns List of GitHub installations with pagination
-   * @throws {Error} On API errors (401, 404, 422, 500)
-   *
-   * @example
-   * ```typescript
-   * const result = await githubService.listInstallations({ page: 1, limit: 20 });
-   * console.log(result.installations);
-   * console.log(result.pagination);
-   * ```
-   */
-  async listInstallations(params) {
-    const url = `${this.baseUrl}/api/v1/github/installations`;
-    const headers = this.getHeaders();
-    const response = await this.axios.get(url, {
-      headers,
-      params
-    });
-    return response.data;
-  }
-  /**
-   * Get detailed information about a specific GitHub installation
-   *
-   * Supports both UUID and short ID formats (e.g., "GITHUB-1").
-   * Returns installation details including all associated repositories.
-   *
-   * @param installationId - Installation UUID or short ID (e.g., "GITHUB-1")
-   * @returns Detailed installation information with repositories
-   * @throws {Error} On API errors (401, 404, 422, 500)
-   *
-   * @example
-   * ```typescript
-   * // Using short ID
-   * const installation = await githubService.getInstallation('GITHUB-1');
-   *
-   * // Using UUID
-   * const installation = await githubService.getInstallation('550e8400-e29b-41d4-a716-446655440000');
-   *
-   * console.log(installation.repositories);
-   * ```
-   */
-  async getInstallation(installationId) {
-    const url = `${this.baseUrl}/api/v1/github/installations/${installationId}`;
-    const headers = this.getHeaders();
-    const response = await this.axios.get(url, { headers });
-    return response.data;
-  }
-};
-
 // src/services/internal/repository-service.ts
 var RepositoryService = class {
   constructor(baseUrl, auth) {
@@ -3624,10 +3560,6 @@ async function getLocalProjectId(cwd) {
 }
 
 // src/utils/repository-access.ts
-function findInstallationForOwner(owner, installations) {
-  const normalizedOwner = owner.toLowerCase();
-  return installations.find((inst) => inst.account_name.toLowerCase() === normalizedOwner) || null;
-}
 async function checkRepositoryAccess(repositoryService, owner, name) {
   try {
     const response = await repositoryService.listRepositories({
@@ -3791,7 +3723,12 @@ async function isUpdateAvailable() {
 function getUpdateCommand() {
   return `npm install -g ${PACKAGE_NAME}`;
 }
+var _suppressWarning = false;
+function suppressUpdateWarning() {
+  _suppressWarning = true;
+}
 async function checkAndShowUpdateWarning() {
+  if (_suppressWarning) return;
   try {
     const { available, currentVersion, latestVersion } = await isUpdateAvailable();
     if (available && latestVersion) {
@@ -4029,17 +3966,17 @@ async function handleSetupClaudeCode(opts) {
     name: "Claude Code",
     sourceDirs: [
       "claude-code/commands",
-      "claude-code/skills/braingrid-cli",
-      "claude-code/skills/build",
-      "claude-code/skills/frontend-design",
-      "claude-code/skills/ux"
+      "claude-code/skills/bg-cli",
+      "claude-code/skills/bg-build",
+      "claude-code/skills/bg-frontend-design",
+      "claude-code/skills/bg-ux-design"
     ],
     targetDirs: [
       ".claude/commands",
-      ".claude/skills/braingrid-cli",
-      ".claude/skills/build",
-      ".claude/skills/frontend-design",
-      ".claude/skills/ux"
+      ".claude/skills/bg-cli",
+      ".claude/skills/bg-build",
+      ".claude/skills/bg-frontend-design",
+      ".claude/skills/bg-ux-design"
     ],
     dirLabels: [
       { label: "Commands", countMode: "files" },
@@ -4053,7 +3990,14 @@ async function handleSetupClaudeCode(opts) {
       targetFile: "CLAUDE.md"
     },
     docsUrl: "https://docs.braingrid.ai/claude-code",
-    deprecatedFiles: [".claude/commands/build.md"]
+    deprecatedFiles: [
+      ".claude/commands/build.md",
+      ".claude/commands/breakdown.md",
+      ".claude/skills/braingrid-cli/skill.md",
+      ".claude/skills/braingrid-cli/SKILL.md",
+      ".claude/skills/build/skill.md",
+      ".claude/skills/build/SKILL.md"
+    ]
   };
   try {
     const setupResult = await _handleSetup(config2, opts);
@@ -4163,7 +4107,8 @@ async function handleSetupCursor(opts) {
       sourceFile: "cursor/AGENTS.md",
       targetFile: "AGENTS.md"
     },
-    docsUrl: "https://docs.braingrid.ai/cursor"
+    docsUrl: "https://docs.braingrid.ai/cursor",
+    deprecatedFiles: [".cursor/commands/breakdown.md", ".cursor/commands/build.md"]
   };
   try {
     const setupResult = await _handleSetup(config2, opts);
@@ -4190,6 +4135,61 @@ async function handleSetupCursor(opts) {
     };
   }
 }
+async function handleSetupOpenClaw(opts) {
+  const config2 = {
+    name: "OpenClaw",
+    sourceDirs: [
+      "claude-code/skills/braingrid-cli",
+      "claude-code/skills/build",
+      "claude-code/skills/frontend-design",
+      "claude-code/skills/ux"
+    ],
+    targetDirs: [
+      "skills/bg-cli",
+      "skills/bg-build",
+      "skills/bg-frontend-design",
+      "skills/bg-ux-design"
+    ],
+    dirLabels: [
+      { label: "Skills", countMode: "single" },
+      { label: "Skills", countMode: "single" },
+      { label: "Skills", countMode: "single" },
+      { label: "Skills", countMode: "single" }
+    ],
+    injection: {
+      sourceFile: "claude-code/CLAUDE.md",
+      targetFile: "AGENTS.md"
+    },
+    docsUrl: "https://docs.braingrid.ai/openclaw"
+  };
+  try {
+    const setupResult = await _handleSetup(config2, opts);
+    if (!isSetupResult(setupResult)) {
+      return setupResult;
+    }
+    const { installedPerDir, skipped } = setupResult.data;
+    const displayPerDir = installedPerDir.map(
+      (count, i) => config2.dirLabels[i].countMode === "single" ? Math.min(count, 1) : count
+    );
+    const totalInstalled = displayPerDir.reduce((a, b) => a + b, 0);
+    log("INFO", "setup", "complete", `installed=${totalInstalled} skipped=${skipped}`);
+    await flushLogger();
+    closeLogger();
+    return {
+      success: true,
+      message: buildSuccessMessage(config2, displayPerDir, "")
+    };
+  } catch (error) {
+    const errorMessage = error instanceof Error ? error.message : String(error);
+    log("ERROR", "setup", "fatal", `error=${errorMessage}`);
+    await flushLogger();
+    closeLogger();
+    return {
+      success: false,
+      message: chalk10.red(`\u274C Setup failed: ${errorMessage}`)
+    };
+  }
+}
 
 // src/handlers/update.handlers.ts
 import { execSync as execSync3 } from "child_process";
@@ -4431,22 +4431,10 @@ function getServices() {
   const config2 = getConfig();
   const auth = new BraingridAuth(config2.apiUrl);
   const projectService = new ProjectService(config2.apiUrl, auth);
-  const githubService = new GitHubService(config2.apiUrl, auth);
   const repositoryService = new RepositoryService(config2.apiUrl, auth);
-  return { projectService, githubService, repositoryService, auth };
+  return { projectService, repositoryService, auth };
 }
-function promptToAddOrganization(owner, webUrl) {
-  return {
-    success: false,
-    message: chalk12.yellow("\u26A0\uFE0F  No projects found for this repository.\n\n") + chalk12.dim(`Repository: ${owner}/*
-
-`) + chalk12.dim(`You have GitHub connected, but not for the "${owner}" organization.
-
-`) + chalk12.dim("To connect ") + chalk12.cyan(owner) + chalk12.dim(":\n") + chalk12.dim("  1. Visit: ") + chalk12.cyan(`${webUrl}/integrations`) + chalk12.dim("\n") + chalk12.dim('  2. Click "Add GitHub Organization"\n') + chalk12.dim(`  3. Select "${owner}"
-`) + chalk12.dim("  4. Run ") + chalk12.cyan("braingrid init") + chalk12.dim(" again")
-  };
-}
-async function promptToCreateProject(gitInfo, projectService, repositoryService) {
+async function promptToCreateProject(gitInfo, projectService, repositoryService, knownRepositoryId) {
   const webUrl = getConfig().getWebAppUrl();
   if (!gitInfo.owner || !gitInfo.name) {
     return {
@@ -4454,7 +4442,7 @@ async function promptToCreateProject(gitInfo, projectService, repositoryService)
       message: chalk12.red("\u274C Repository information is incomplete")
     };
   }
-  const repositoryId = await getRepositoryId(repositoryService, gitInfo.owner, gitInfo.name);
+  const repositoryId = knownRepositoryId ?? await getRepositoryId(repositoryService, gitInfo.owner, gitInfo.name);
   if (!repositoryId) {
     return {
       success: false,
@@ -4509,7 +4497,7 @@ async function promptToGrantRepositoryAccess(gitInfo, webUrl, repositoryService,
   console.log(
     chalk12.yellow("\u26A0\uFE0F  Repository found but BrainGrid needs access.\n\n") + chalk12.dim(`Repository: ${owner}/${name}
 
-`) + chalk12.dim("Please grant BrainGrid access to this repository:\n") + chalk12.dim("  1. Visit: ") + chalk12.cyan(`${webUrl}/integrations`) + chalk12.dim("\n") + chalk12.dim(
+`) + chalk12.dim("Please grant BrainGrid access to this repository:\n") + chalk12.dim("  1. Visit: ") + chalk12.cyan(`${webUrl}/settings/integrations`) + chalk12.dim("\n") + chalk12.dim(
       `  2. Click on your "${owner}" installation "Add/Remove" to grant BrainGrid access to your repository
 `
     ) + chalk12.dim(`  3. Select "${name}" and save
@@ -4525,44 +4513,45 @@ async function promptToGrantRepositoryAccess(gitInfo, webUrl, repositoryService,
   if (!accessGranted) {
     return {
       success: false,
-      message: chalk12.yellow("\n\u26A0\uFE0F  Repository access not detected within 3 minutes.\n\n") + chalk12.dim("Please grant access at: ") + chalk12.cyan(`${webUrl}/integrations`) + chalk12.dim(" and run ") + chalk12.cyan("braingrid init") + chalk12.dim(" again.")
+      message: chalk12.yellow("\n\u26A0\uFE0F  Repository access not detected within 3 minutes.\n\n") + chalk12.dim("Please grant access at: ") + chalk12.cyan(`${webUrl}/settings/integrations`) + chalk12.dim(" and run ") + chalk12.cyan("braingrid init") + chalk12.dim(" again.")
     };
   }
   console.log(chalk12.green("\u2705 Repository access granted!\n"));
   return promptToCreateProject(gitInfo, projectService, repositoryService);
 }
-async function handleNoProjectForRepository(owner, name, gitInfo, githubService, repositoryService, projectService, config2) {
-  let allInstallations;
+async function handleNoProjectForRepository(owner, name, gitInfo, repositoryService, projectService, config2) {
+  const webUrl = config2.getWebAppUrl();
   try {
-    const installationsResponse = await githubService.listInstallations({ limit: 100 });
-    allInstallations = installationsResponse.installations;
+    const response = await repositoryService.listRepositories({ owner, name, limit: 1 });
+    if (response.repositories.length > 0) {
+      return promptToCreateProject(
+        gitInfo,
+        projectService,
+        repositoryService,
+        response.repositories[0].id
+      );
+    }
+    if (!response.has_github_installation && !response.has_oauth_connection) {
+      return {
+        success: false,
+        message: chalk12.yellow("\u26A0\uFE0F  No projects found for this repository.\n\n") + chalk12.dim(`Repository: ${owner}/${name}
+
+`) + chalk12.dim("It looks like you haven't connected your GitHub account yet.\n") + chalk12.dim("Please connect GitHub at: ") + chalk12.cyan(`${webUrl}/settings/integrations`) + chalk12.dim("\n\nOnce connected, create a project and link it to this repository.")
+      };
+    }
+    return promptToGrantRepositoryAccess(gitInfo, webUrl, repositoryService, projectService);
   } catch (error) {
     log(
       "WARN",
       "init",
-      "list_installations_failed",
+      "list_repositories_failed",
       `error=${error instanceof Error ? error.message : String(error)}`
     );
-    allInstallations = [];
-  }
-  const webUrl = config2.getWebAppUrl();
-  if (allInstallations.length === 0) {
     return {
       success: false,
-      message: chalk12.yellow("\u26A0\uFE0F  No projects found for this repository.\n\n") + chalk12.dim(`Repository: ${owner}/${name}
-
-`) + chalk12.dim("It looks like you haven't connected your GitHub account yet.\n") + chalk12.dim("Please connect GitHub at: ") + chalk12.cyan(`${webUrl}/integrations`) + chalk12.dim("\n\nOnce connected, create a project and link it to this repository.")
+      message: chalk12.red("\u274C Failed to check repository access.\n\n") + chalk12.dim("Please try again or visit: ") + chalk12.cyan(`${webUrl}/settings/integrations`)
     };
   }
-  const ownerInstallation = findInstallationForOwner(owner, allInstallations);
-  if (!ownerInstallation) {
-    return promptToAddOrganization(owner, webUrl);
-  }
-  const hasRepoAccess = await checkRepositoryAccess(repositoryService, owner, name);
-  if (!hasRepoAccess) {
-    return promptToGrantRepositoryAccess(gitInfo, webUrl, repositoryService, projectService);
-  }
-  return promptToCreateProject(gitInfo, projectService, repositoryService);
 }
 function showSetupInstructions(scenario) {
   let message = "";
@@ -4707,6 +4696,7 @@ async function handleInit(opts) {
       if (shouldUpdate) {
         const result = await handleUpdate({});
         console.log(result.message);
+        suppressUpdateWarning();
         try {
           const args = ["init"];
           if (opts.force) args.push("--force");
@@ -4732,7 +4722,7 @@ async function handleInit(opts) {
       `available=${updateInfo.available} current=${updateInfo.currentVersion}${updateInfo.latestVersion ? ` latest=${updateInfo.latestVersion}` : ""}`
     );
     const config2 = getConfig();
-    const { projectService, githubService, repositoryService, auth } = getServices();
+    const { projectService, repositoryService, auth } = getServices();
     if (!await isGitInstalled()) {
       const shouldInstall = await confirm2({
         message: "Git is required but not installed. Would you like to install it now?",
@@ -4968,7 +4958,6 @@ async function handleInit(opts) {
               owner,
               name,
               gitInfo,
-              githubService,
               repositoryService,
               projectService,
               config2
@@ -4990,7 +4979,6 @@ async function handleInit(opts) {
             owner,
             name,
             gitInfo,
-            githubService,
             repositoryService,
             projectService,
             config2
@@ -8895,6 +8883,7 @@ var createSetupAction = (handler) => {
 var setup = program.command("setup").description("Setup BrainGrid integrations for AI coding tools");
 setup.command("claude-code").description("Install Claude Code integration").option("--force", "overwrite existing files without prompting").option("--dry-run", "show what would be done without making changes").action(createSetupAction(handleSetupClaudeCode));
 setup.command("cursor").description("Install Cursor integration").option("--force", "overwrite existing files without prompting").option("--dry-run", "show what would be done without making changes").action(createSetupAction(handleSetupCursor));
+setup.command("openclaw").description("Install OpenClaw integration").option("--force", "overwrite existing files without prompting").option("--dry-run", "show what would be done without making changes").action(createSetupAction(handleSetupOpenClaw));
 var project = program.command("project").description("Manage projects");
 project.command("list").description("List all projects").option("--format <format>", "output format (table, json, xml, markdown)", "table").option("--page <page>", "page number for pagination", "1").option("--limit <limit>", "number of projects per page", "20").action(async (opts) => {
   const result = await handleProjectList(opts);