@braingrid/cli 0.2.15 → 0.2.17

package/dist/cli.js

@@ -422,7 +422,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.15" : "0.0.0-test";
+var CLI_VERSION = true ? "0.2.17" : "0.0.0-test";
 var PRODUCTION_CONFIG = {
   apiUrl: "https://app.braingrid.ai",
   workosAuthUrl: "https://auth.braingrid.ai",
@@ -3940,6 +3940,15 @@ async function handleRequirementShow(opts) {
         message: chalk7.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: chalk7.red(
+          `\u274C Invalid format: ${format}. Supported formats: table, json, xml, markdown`
+        )
+      };
+    }
     const requirementResult = await workspaceManager.getRequirement(opts?.id);
     if (!requirementResult.success) {
       return {
@@ -3961,17 +3970,39 @@ async function handleRequirementShow(opts) {
     const requirement2 = await requirementService.getProjectRequirement(projectId, normalizedId);
     stopSpinner();
     stopSpinner = null;
-    const output = formatRequirementOutput(requirement2, {
-      showDescription: true,
-      showContent: true,
-      showTasks: true,
-      showUpdated: true,
-      apiUrl: config.apiUrl,
-      projectShortId: projectId
-    });
+    let output;
+    switch (format) {
+      case "json": {
+        output = JSON.stringify(requirement2, null, 2);
+        break;
+      }
+      case "xml": {
+        output = formatRequirementBuildXml(requirement2);
+        break;
+      }
+      case "markdown": {
+        output = formatRequirementBuildMarkdown(requirement2, {
+          apiUrl: config.apiUrl,
+          projectShortId: projectId
+        });
+        break;
+      }
+      case "table":
+      default: {
+        output = "\n" + formatRequirementOutput(requirement2, {
+          showDescription: true,
+          showContent: true,
+          showTasks: true,
+          showUpdated: true,
+          apiUrl: config.apiUrl,
+          projectShortId: projectId
+        });
+        break;
+      }
+    }
     return {
       success: true,
-      message: "\n" + output,
+      message: output,
       data: requirement2
     };
   } catch (error) {
@@ -4623,6 +4654,15 @@ async function handleTaskShow(id, opts) {
         message: chalk8.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: chalk8.red(
+          `\u274C Invalid format: ${format}. Supported formats: table, json, xml, markdown`
+        )
+      };
+    }
     const workspace = await workspaceManager.getProject(opts?.project);
     if (!workspace.success) {
       return {
@@ -4645,13 +4685,34 @@ async function handleTaskShow(id, opts) {
     const task2 = await taskService.getTask(projectId, requirementId, taskId);
     stopSpinner();
     stopSpinner = null;
-    const output = formatTaskOutput(task2, {
-      showContent: true,
-      apiUrl: config.apiUrl,
-      projectShortId: projectId,
-      requirementShortId: opts?.requirement || requirementId,
-      requirementId
-    });
+    let output;
+    switch (format) {
+      case "json": {
+        output = JSON.stringify(task2, null, 2);
+        break;
+      }
+      case "xml":
+      case "markdown": {
+        output = formatTasksListOutput([task2], format, true, {
+          requirementId,
+          projectShortId: projectId,
+          requirementShortId: opts?.requirement || requirementId,
+          apiUrl: config.apiUrl
+        });
+        break;
+      }
+      case "table":
+      default: {
+        output = formatTaskOutput(task2, {
+          showContent: true,
+          apiUrl: config.apiUrl,
+          projectShortId: projectId,
+          requirementShortId: opts?.requirement || requirementId,
+          requirementId
+        });
+        break;
+      }
+    }
     return {
       success: true,
       message: output,
@@ -5126,8 +5187,8 @@ async function handleStatus() {
 }
 
 // src/handlers/init.handlers.ts
-import chalk13 from "chalk";
-import { confirm, select as select2, input } from "@inquirer/prompts";
+import chalk15 from "chalk";
+import { confirm, select as select3, input } from "@inquirer/prompts";
 
 // src/services/internal/github-service.ts
 var GitHubService = class {
@@ -5394,9 +5455,277 @@ function getManualInstallInstructions() {
   }
 }
 
-// src/handlers/setup.handlers.ts
+// src/handlers/update.handlers.ts
 import chalk12 from "chalk";
+
+// src/utils/package-manager.ts
+import { execSync } from "child_process";
 import { select } from "@inquirer/prompts";
+function isPackageManagerInstalled(pm) {
+  try {
+    execSync(`which ${pm}`, { stdio: "ignore", timeout: 2e3 });
+    return true;
+  } catch {
+    return false;
+  }
+}
+function checkGlobalInstallation(pm, packageName) {
+  try {
+    let command;
+    switch (pm) {
+      case "npm": {
+        command = `npm list -g ${packageName} 2>&1`;
+        break;
+      }
+      case "pnpm": {
+        command = `pnpm list -g ${packageName} 2>&1`;
+        break;
+      }
+      case "yarn": {
+        command = `yarn global list 2>&1`;
+        break;
+      }
+    }
+    const output = execSync(command, {
+      encoding: "utf-8",
+      timeout: 5e3
+    });
+    if (pm === "npm" || pm === "pnpm") {
+      return output.includes(packageName) && !output.includes("(empty)");
+    }
+    if (pm === "yarn") {
+      return output.includes(packageName);
+    }
+    return false;
+  } catch {
+    return false;
+  }
+}
+async function getPackageManagerInfo(packageName) {
+  const packageManagers = ["npm", "pnpm", "yarn"];
+  return packageManagers.map((pm) => {
+    const installed = isPackageManagerInstalled(pm);
+    return {
+      name: pm,
+      installed,
+      hasPackage: installed ? checkGlobalInstallation(pm, packageName) : false
+    };
+  });
+}
+async function detectPackageManager(packageName) {
+  const pmInfo = await getPackageManagerInfo(packageName);
+  const installedWith = pmInfo.find((pm) => pm.hasPackage);
+  if (installedWith) {
+    return installedWith.name;
+  }
+  const availablePMs = pmInfo.filter((pm) => pm.installed);
+  if (availablePMs.length === 0) {
+    throw new Error("No package manager found. Please install npm, pnpm, or yarn.");
+  }
+  if (availablePMs.length === 1) {
+    return availablePMs[0].name;
+  }
+  const selected = await select({
+    message: "Unable to detect which package manager was used. Please select one:",
+    choices: availablePMs.map((pm) => ({
+      name: pm.name,
+      value: pm.name
+    }))
+  });
+  return selected;
+}
+function getUpdateCommand(pm, packageName) {
+  switch (pm) {
+    case "npm": {
+      return `npm install -g ${packageName}@latest`;
+    }
+    case "pnpm": {
+      return `pnpm add -g ${packageName}@latest`;
+    }
+    case "yarn": {
+      return `yarn global add ${packageName}@latest`;
+    }
+  }
+}
+function executeUpdate(pm, packageName) {
+  const command = getUpdateCommand(pm, packageName);
+  try {
+    execSync(command, {
+      stdio: "inherit",
+      timeout: 12e4
+      // 2 minutes timeout
+    });
+  } catch (error) {
+    throw new Error(
+      `Failed to update package: ${error instanceof Error ? error.message : String(error)}`
+    );
+  }
+}
+
+// src/utils/version.ts
+import axios5 from "axios";
+var PACKAGE_NAME = "@braingrid/cli";
+var NPM_REGISTRY_URL = `https://registry.npmjs.org/${PACKAGE_NAME}`;
+function getCurrentVersion() {
+  return CLI_VERSION;
+}
+async function getLatestVersion(timeout = 1e4) {
+  try {
+    const response = await axios5.get(NPM_REGISTRY_URL, {
+      timeout
+    });
+    return response.data["dist-tags"].latest;
+  } catch (error) {
+    const message = error instanceof Error ? error.message : String(error);
+    throw new Error(`Failed to fetch latest version: ${message}`);
+  }
+}
+function compareVersions(v1, v2) {
+  const v1Parts = v1.split(".").map(Number);
+  const v2Parts = v2.split(".").map(Number);
+  for (let i = 0; i < Math.max(v1Parts.length, v2Parts.length); i++) {
+    const v1Part = v1Parts[i] || 0;
+    const v2Part = v2Parts[i] || 0;
+    if (v1Part < v2Part) return -1;
+    if (v1Part > v2Part) return 1;
+  }
+  return 0;
+}
+
+// src/handlers/update.handlers.ts
+async function handleUpdate(opts) {
+  try {
+    const currentVersion = getCurrentVersion();
+    let output = chalk12.bold.cyan("\n\u{1F504} BrainGrid CLI Update\n\n");
+    output += `${chalk12.bold("Current version:")} ${currentVersion}
+`;
+    output += chalk12.dim("Checking for updates...\n");
+    const latestVersion = await getLatestVersion();
+    output += `${chalk12.bold("Latest version:")}  ${latestVersion}
+
+`;
+    const comparison = compareVersions(currentVersion, latestVersion);
+    if (comparison === 0) {
+      output += chalk12.green("\u2705 You are already on the latest version!\n");
+      return {
+        success: true,
+        message: output,
+        data: { currentVersion, latestVersion, upToDate: true }
+      };
+    }
+    if (comparison > 0) {
+      output += chalk12.yellow("\u26A0\uFE0F  You are on a newer version than what is published.\n");
+      output += chalk12.dim("   This is expected if you are developing locally.\n");
+      return {
+        success: true,
+        message: output,
+        data: { currentVersion, latestVersion, upToDate: false }
+      };
+    }
+    output += chalk12.yellow(`\u2B06\uFE0F  Update available: ${currentVersion} \u2192 ${latestVersion}
+
+`);
+    if (opts.check) {
+      output += chalk12.dim("Run ") + chalk12.cyan("braingrid update") + chalk12.dim(" to update\n");
+      return {
+        success: true,
+        message: output,
+        data: { currentVersion, latestVersion, upToDate: false }
+      };
+    }
+    output += chalk12.dim("Detecting package manager...\n");
+    const packageManager = await detectPackageManager(PACKAGE_NAME);
+    output += `${chalk12.bold("Package manager:")} ${packageManager}
+
+`;
+    const updateCommand = getUpdateCommand(packageManager, PACKAGE_NAME);
+    output += chalk12.dim("Running: ") + chalk12.cyan(updateCommand) + "\n\n";
+    console.log(output);
+    executeUpdate(packageManager, PACKAGE_NAME);
+    return {
+      success: true,
+      message: chalk12.green("\n\u2705 Successfully updated BrainGrid CLI!\n"),
+      data: { currentVersion, latestVersion, packageManager }
+    };
+  } catch (error) {
+    return {
+      success: false,
+      message: formatError(error)
+    };
+  }
+}
+
+// src/utils/update-checker.ts
+import chalk13 from "chalk";
+var CACHE_TTL_MS = 12 * 60 * 60 * 1e3;
+var CACHE_SERVICE = "braingrid-cli";
+var CACHE_ACCOUNT = "update-cache";
+async function getCache() {
+  try {
+    const cached = await credentialStore.getPassword(CACHE_SERVICE, CACHE_ACCOUNT);
+    if (!cached) return null;
+    return JSON.parse(cached);
+  } catch {
+    return null;
+  }
+}
+async function setCache(cache) {
+  try {
+    await credentialStore.setPassword(CACHE_SERVICE, CACHE_ACCOUNT, JSON.stringify(cache));
+  } catch {
+  }
+}
+function isCacheValid(cache) {
+  const now = Date.now();
+  return now - cache.checkedAt < CACHE_TTL_MS;
+}
+async function getLatestVersionCached() {
+  const cache = await getCache();
+  if (cache && isCacheValid(cache)) {
+    return cache.latestVersion;
+  }
+  try {
+    const latestVersion = await getLatestVersion(5e3);
+    await setCache({
+      latestVersion,
+      checkedAt: Date.now()
+    });
+    return latestVersion;
+  } catch {
+    return cache?.latestVersion ?? null;
+  }
+}
+async function isUpdateAvailable() {
+  const currentVersion = getCurrentVersion();
+  const latestVersion = await getLatestVersionCached();
+  if (!latestVersion) {
+    return { available: false, currentVersion, latestVersion: null };
+  }
+  const comparison = compareVersions(currentVersion, latestVersion);
+  return {
+    available: comparison < 0,
+    // Update available if current < latest
+    currentVersion,
+    latestVersion
+  };
+}
+function getUpdateCommand2() {
+  return `npm install -g ${PACKAGE_NAME}`;
+}
+async function checkAndShowUpdateWarning() {
+  try {
+    const { available, currentVersion, latestVersion } = await isUpdateAvailable();
+    if (available && latestVersion) {
+      const warning = "\n" + chalk13.yellow(`\u26A0\uFE0F  Update available: ${currentVersion} \u2192 ${latestVersion}`) + "\n" + chalk13.dim(`    Run \`${getUpdateCommand2()}\` to update`) + "\n";
+      console.log(warning);
+    }
+  } catch {
+  }
+}
+
+// src/handlers/setup.handlers.ts
+import chalk14 from "chalk";
+import { select as select2 } from "@inquirer/prompts";
 import * as path4 from "path";
 import * as fs4 from "fs/promises";
 
@@ -5613,7 +5942,7 @@ async function checkPrerequisites() {
   } catch {
     return {
       success: false,
-      message: chalk12.red("\u274C GitHub CLI is not installed.\n\n") + chalk12.dim("Install instructions:\n") + chalk12.dim("  macOS: ") + chalk12.cyan("brew install gh") + chalk12.dim("\n") + chalk12.dim("  Windows: ") + chalk12.cyan("winget install GitHub.CLI") + chalk12.dim("\n") + chalk12.dim("  Linux: See ") + chalk12.cyan("https://cli.github.com/manual/installation") + chalk12.dim("\n\n") + chalk12.dim("After installing, run: ") + chalk12.cyan("gh auth login")
+      message: chalk14.red("\u274C GitHub CLI is not installed.\n\n") + chalk14.dim("Install instructions:\n") + chalk14.dim("  macOS: ") + chalk14.cyan("brew install gh") + chalk14.dim("\n") + chalk14.dim("  Windows: ") + chalk14.cyan("winget install GitHub.CLI") + chalk14.dim("\n") + chalk14.dim("  Linux: See ") + chalk14.cyan("https://cli.github.com/manual/installation") + chalk14.dim("\n\n") + chalk14.dim("After installing, run: ") + chalk14.cyan("gh auth login")
     };
   }
   try {
@@ -5621,7 +5950,7 @@ async function checkPrerequisites() {
   } catch {
     return {
       success: false,
-      message: chalk12.red("\u274C Not authenticated with GitHub CLI.\n\n") + chalk12.dim("Please run: ") + chalk12.cyan("gh auth login")
+      message: chalk14.red("\u274C Not authenticated with GitHub CLI.\n\n") + chalk14.dim("Please run: ") + chalk14.cyan("gh auth login")
     };
   }
   return null;
@@ -5648,7 +5977,7 @@ async function getFileList(sourcePaths, targetPaths) {
       }
     } catch (error) {
       console.warn(
-        chalk12.yellow(`\u26A0\uFE0F  Could not list directory: ${sourceDir}`),
+        chalk14.yellow(`\u26A0\uFE0F  Could not list directory: ${sourceDir}`),
         error instanceof Error ? error.message : String(error)
       );
     }
@@ -5659,28 +5988,28 @@ async function getFileList(sourcePaths, targetPaths) {
   return operations;
 }
 function displayInstallationPlan(operations, injectionFile) {
-  console.log(chalk12.bold("\n\u{1F4CB} Installation Plan:\n"));
-  console.log(chalk12.cyan("  Content Injection:"));
-  console.log(chalk12.dim(`    ${injectionFile}`));
+  console.log(chalk14.bold("\n\u{1F4CB} Installation Plan:\n"));
+  console.log(chalk14.cyan("  Content Injection:"));
+  console.log(chalk14.dim(`    ${injectionFile}`));
   const newFiles = operations.filter((op) => !op.exists);
   const existingFiles = operations.filter((op) => op.exists);
   if (newFiles.length > 0) {
-    console.log(chalk12.cyan("\n  New Files:"));
+    console.log(chalk14.cyan("\n  New Files:"));
     for (const op of newFiles) {
-      console.log(chalk12.dim(`    ${op.targetPath}`));
+      console.log(chalk14.dim(`    ${op.targetPath}`));
     }
   }
   if (existingFiles.length > 0) {
-    console.log(chalk12.yellow("\n  Existing Files (will prompt):"));
+    console.log(chalk14.yellow("\n  Existing Files (will prompt):"));
     for (const op of existingFiles) {
-      console.log(chalk12.dim(`    ${op.targetPath}`));
+      console.log(chalk14.dim(`    ${op.targetPath}`));
     }
   }
   console.log("");
 }
 async function promptForConflict(filePath) {
-  const answer = await select({
-    message: chalk12.yellow(`File exists: ${filePath}`),
+  const answer = await select2({
+    message: chalk14.yellow(`File exists: ${filePath}`),
     choices: [
       { name: "[O]verwrite - Replace this file", value: "overwrite" },
       { name: "[S]kip - Keep existing file", value: "skip" },
@@ -5711,7 +6040,7 @@ async function installFiles(operations, force) {
       installed++;
     } catch (error) {
       console.error(
-        chalk12.red(`Failed to copy ${operation.targetPath}:`),
+        chalk14.red(`Failed to copy ${operation.targetPath}:`),
         error instanceof Error ? error.message : String(error)
       );
       skipped++;
@@ -5725,7 +6054,7 @@ async function _handleSetup(config, opts) {
     if (prerequisiteError) {
       return prerequisiteError;
     }
-    console.log(chalk12.bold(`\u{1F680} Setting up ${config.name} integration...
+    console.log(chalk14.bold(`\u{1F680} Setting up ${config.name} integration...
 `));
     const operations = await getFileList(config.sourceDirs, config.targetDirs);
     const injectionFileExists = await fileExists(config.injection.targetFile);
@@ -5742,7 +6071,7 @@ async function _handleSetup(config, opts) {
     if (opts.dryRun) {
       return {
         success: true,
-        message: chalk12.green("\u2705 Dry-run complete. No files were modified.\n\n") + chalk12.dim(`Would install ${operations.length} files.`)
+        message: chalk14.green("\u2705 Dry-run complete. No files were modified.\n\n") + chalk14.dim(`Would install ${operations.length} files.`)
       };
     }
     const copyOps = operations.filter((op) => op.type === "copy");
@@ -5750,7 +6079,7 @@ async function _handleSetup(config, opts) {
     if (result.cancelled) {
       return {
         success: false,
-        message: chalk12.yellow("\u26A0\uFE0F  Installation cancelled.\n\n") + chalk12.dim(`Installed: ${result.installed}, Skipped: ${result.skipped}`),
+        message: chalk14.yellow("\u26A0\uFE0F  Installation cancelled.\n\n") + chalk14.dim(`Installed: ${result.installed}, Skipped: ${result.skipped}`),
         code: "CANCELLED"
       };
     }
@@ -5759,7 +6088,7 @@ async function _handleSetup(config, opts) {
       await injectContentIntoFile(config.injection.targetFile, content);
     } catch (error) {
       console.error(
-        chalk12.red(`Failed to inject content into ${config.injection.targetFile}:`),
+        chalk14.red(`Failed to inject content into ${config.injection.targetFile}:`),
         error instanceof Error ? error.message : String(error)
       );
     }
@@ -5772,27 +6101,27 @@ async function _handleSetup(config, opts) {
         statusLineInstalled = true;
       } catch (error) {
         console.error(
-          chalk12.yellow("\u26A0\uFE0F  Failed to install status line script:"),
+          chalk14.yellow("\u26A0\uFE0F  Failed to install status line script:"),
           error instanceof Error ? error.message : String(error)
         );
       }
     }
-    const statusLineMessage = statusLineInstalled ? chalk12.dim("  Status line: .claude/statusline.sh\n") : "";
+    const statusLineMessage = statusLineInstalled ? chalk14.dim("  Status line: .claude/statusline.sh\n") : "";
     return {
       success: true,
-      message: chalk12.green(`\u2705 ${config.name} integration installed successfully!
+      message: chalk14.green(`\u2705 ${config.name} integration installed successfully!
 
-`) + chalk12.dim("Files installed:\n") + chalk12.dim(`  Commands: ${result.installed} files
-`) + statusLineMessage + chalk12.dim(`  Content injected into: ${config.injection.targetFile}
+`) + chalk14.dim("Files installed:\n") + chalk14.dim(`  Commands: ${result.installed} files
+`) + statusLineMessage + chalk14.dim(`  Content injected into: ${config.injection.targetFile}
 
-`) + chalk12.dim("Next steps:\n") + chalk12.dim("  1. Review the integration files\n") + chalk12.dim(`  2. Open ${config.name}
-`) + chalk12.dim("  3. Try the /specify or /breakdown commands\n") + chalk12.dim("  4. Learn more: ") + chalk12.cyan(config.docsUrl)
+`) + chalk14.dim("Next steps:\n") + chalk14.dim("  1. Review the integration files\n") + chalk14.dim(`  2. Open ${config.name}
+`) + chalk14.dim("  3. Try the /specify or /breakdown commands\n") + chalk14.dim("  4. Learn more: ") + chalk14.cyan(config.docsUrl)
     };
   } catch (error) {
     const errorMessage = error instanceof Error ? error.message : String(error);
     return {
       success: false,
-      message: chalk12.red(`\u274C Setup failed: ${errorMessage}`)
+      message: chalk14.red(`\u274C Setup failed: ${errorMessage}`)
     };
   }
 }
@@ -5906,12 +6235,12 @@ function getServices4() {
 function promptToAddOrganization(owner, webUrl) {
   return {
     success: false,
-    message: chalk13.yellow("\u26A0\uFE0F  No projects found for this repository.\n\n") + chalk13.dim(`Repository: ${owner}/*
+    message: chalk15.yellow("\u26A0\uFE0F  No projects found for this repository.\n\n") + chalk15.dim(`Repository: ${owner}/*
 
-`) + chalk13.dim(`You have GitHub connected, but not for the "${owner}" organization.
+`) + chalk15.dim(`You have GitHub connected, but not for the "${owner}" organization.
 
-`) + chalk13.dim("To connect ") + chalk13.cyan(owner) + chalk13.dim(":\n") + chalk13.dim("  1. Visit: ") + chalk13.cyan(`${webUrl}/integrations`) + chalk13.dim("\n") + chalk13.dim('  2. Click "Add GitHub Organization"\n') + chalk13.dim(`  3. Select "${owner}"
-`) + chalk13.dim("  4. Run ") + chalk13.cyan("braingrid init") + chalk13.dim(" again")
+`) + chalk15.dim("To connect ") + chalk15.cyan(owner) + chalk15.dim(":\n") + chalk15.dim("  1. Visit: ") + chalk15.cyan(`${webUrl}/integrations`) + chalk15.dim("\n") + chalk15.dim('  2. Click "Add GitHub Organization"\n') + chalk15.dim(`  3. Select "${owner}"
+`) + chalk15.dim("  4. Run ") + chalk15.cyan("braingrid init") + chalk15.dim(" again")
   };
 }
 async function promptToCreateProject(gitInfo, projectService, repositoryService) {
@@ -5919,20 +6248,20 @@ async function promptToCreateProject(gitInfo, projectService, repositoryService)
   if (!gitInfo.owner || !gitInfo.name) {
     return {
       success: false,
-      message: chalk13.red("\u274C Repository information is incomplete")
+      message: chalk15.red("\u274C Repository information is incomplete")
     };
   }
   const repositoryId = await getRepositoryId(repositoryService, gitInfo.owner, gitInfo.name);
   if (!repositoryId) {
     return {
       success: false,
-      message: chalk13.yellow("\u26A0\uFE0F  Repository accessible but could not retrieve details.\n\n") + chalk13.dim(`Repository: ${gitInfo.owner}/${gitInfo.name}
+      message: chalk15.yellow("\u26A0\uFE0F  Repository accessible but could not retrieve details.\n\n") + chalk15.dim(`Repository: ${gitInfo.owner}/${gitInfo.name}
 
-`) + chalk13.dim("Please try again or create a project manually at: ") + chalk13.cyan(webUrl)
+`) + chalk15.dim("Please try again or create a project manually at: ") + chalk15.cyan(webUrl)
     };
   }
   console.log(
-    chalk13.yellow("\u26A0\uFE0F  Repository accessible but no project exists.\n\n") + chalk13.dim(`Repository: ${gitInfo.owner}/${gitInfo.name}
+    chalk15.yellow("\u26A0\uFE0F  Repository accessible but no project exists.\n\n") + chalk15.dim(`Repository: ${gitInfo.owner}/${gitInfo.name}
 `)
   );
   const shouldCreate = await confirm({
@@ -5942,7 +6271,7 @@ async function promptToCreateProject(gitInfo, projectService, repositoryService)
   if (!shouldCreate) {
     return {
       success: false,
-      message: chalk13.dim("\nProject creation cancelled.\n\n") + chalk13.dim("Create a project at ") + chalk13.cyan(webUrl) + chalk13.dim(" and link it to this repository, or use:\n") + chalk13.cyan(
+      message: chalk15.dim("\nProject creation cancelled.\n\n") + chalk15.dim("Create a project at ") + chalk15.cyan(webUrl) + chalk15.dim(" and link it to this repository, or use:\n") + chalk15.cyan(
         `braingrid project create --name "${gitInfo.name}" --repositories "${gitInfo.owner}/${gitInfo.name}"`
       )
     };
@@ -5953,9 +6282,9 @@ async function promptToCreateProject(gitInfo, projectService, repositoryService)
       description: `Project for ${gitInfo.owner}/${gitInfo.name}`,
       repository_id: repositoryId
     });
-    console.log(chalk13.green(`
+    console.log(chalk15.green(`
 \u2705 Created project ${project2.short_id}: ${project2.name}`));
-    console.log(chalk13.green(`\u2705 Linked repository ${gitInfo.owner}/${gitInfo.name}
+    console.log(chalk15.green(`\u2705 Linked repository ${gitInfo.owner}/${gitInfo.name}
 `));
     return { success: true, message: "", data: project2 };
   } catch (error) {
@@ -5969,18 +6298,18 @@ async function promptToGrantRepositoryAccess(gitInfo, webUrl, repositoryService,
   if (!gitInfo.owner || !gitInfo.name) {
     return {
       success: false,
-      message: chalk13.red("\u274C Repository information is incomplete")
+      message: chalk15.red("\u274C Repository information is incomplete")
     };
   }
   const owner = gitInfo.owner;
   const name = gitInfo.name;
   console.log(
-    chalk13.yellow("\u26A0\uFE0F  Repository found but BrainGrid needs access.\n\n") + chalk13.dim(`Repository: ${owner}/${name}
+    chalk15.yellow("\u26A0\uFE0F  Repository found but BrainGrid needs access.\n\n") + chalk15.dim(`Repository: ${owner}/${name}
 
-`) + chalk13.dim("Please grant BrainGrid access to this repository:\n") + chalk13.dim("  1. Visit: ") + chalk13.cyan(`${webUrl}/integrations`) + chalk13.dim("\n") + chalk13.dim(
+`) + chalk15.dim("Please grant BrainGrid access to this repository:\n") + chalk15.dim("  1. Visit: ") + chalk15.cyan(`${webUrl}/integrations`) + chalk15.dim("\n") + chalk15.dim(
       `  2. Click on your "${owner}" installation "Add/Remove" to grant BrainGrid access to your repository
 `
-    ) + chalk13.dim(`  3. Select "${name}" and save
+    ) + chalk15.dim(`  3. Select "${name}" and save
 
 `)
   );
@@ -5993,10 +6322,10 @@ async function promptToGrantRepositoryAccess(gitInfo, webUrl, repositoryService,
   if (!accessGranted) {
     return {
       success: false,
-      message: chalk13.yellow("\n\u26A0\uFE0F  Repository access not detected within 3 minutes.\n\n") + chalk13.dim("Please grant access at: ") + chalk13.cyan(`${webUrl}/integrations`) + chalk13.dim(" and run ") + chalk13.cyan("braingrid init") + chalk13.dim(" again.")
+      message: chalk15.yellow("\n\u26A0\uFE0F  Repository access not detected within 3 minutes.\n\n") + chalk15.dim("Please grant access at: ") + chalk15.cyan(`${webUrl}/integrations`) + chalk15.dim(" and run ") + chalk15.cyan("braingrid init") + chalk15.dim(" again.")
     };
   }
-  console.log(chalk13.green("\u2705 Repository access granted!\n"));
+  console.log(chalk15.green("\u2705 Repository access granted!\n"));
   return promptToCreateProject(gitInfo, projectService, repositoryService);
 }
 async function handleNoProjectForRepository(owner, name, gitInfo, githubService, repositoryService, projectService, config) {
@@ -6011,9 +6340,9 @@ async function handleNoProjectForRepository(owner, name, gitInfo, githubService,
   if (allInstallations.length === 0) {
     return {
       success: false,
-      message: chalk13.yellow("\u26A0\uFE0F  No projects found for this repository.\n\n") + chalk13.dim(`Repository: ${owner}/${name}
+      message: chalk15.yellow("\u26A0\uFE0F  No projects found for this repository.\n\n") + chalk15.dim(`Repository: ${owner}/${name}
 
-`) + chalk13.dim("It looks like you haven't connected your GitHub account yet.\n") + chalk13.dim("Please connect GitHub at: ") + chalk13.cyan(`${webUrl}/integrations`) + chalk13.dim("\n\nOnce connected, create a project and link it to this repository.")
+`) + chalk15.dim("It looks like you haven't connected your GitHub account yet.\n") + chalk15.dim("Please connect GitHub at: ") + chalk15.cyan(`${webUrl}/integrations`) + chalk15.dim("\n\nOnce connected, create a project and link it to this repository.")
     };
   }
   const ownerInstallation = findInstallationForOwner(owner, allInstallations);
@@ -6029,28 +6358,28 @@ async function handleNoProjectForRepository(owner, name, gitInfo, githubService,
 function showSetupInstructions(scenario) {
   let message = "";
   if (scenario === "no-git") {
-    message += chalk13.dim("To initialize BrainGrid locally:\n\n");
-    message += chalk13.dim("  1. Initialize git:\n");
-    message += chalk13.cyan("     git init\n\n");
+    message += chalk15.dim("To initialize BrainGrid locally:\n\n");
+    message += chalk15.dim("  1. Initialize git:\n");
+    message += chalk15.cyan("     git init\n\n");
   } else {
-    message += chalk13.dim("To connect to GitHub:\n\n");
+    message += chalk15.dim("To connect to GitHub:\n\n");
   }
-  message += chalk13.dim("  2. Create GitHub repository:\n");
-  message += chalk13.dim("     \u2022 Install GitHub CLI: ") + chalk13.cyan("https://cli.github.com\n");
-  message += chalk13.dim("       Then: ") + chalk13.cyan("gh repo create --private --source=.\n");
-  message += chalk13.dim("     \u2022 Or manually: ") + chalk13.cyan("https://github.com/new\n\n");
+  message += chalk15.dim("  2. Create GitHub repository:\n");
+  message += chalk15.dim("     \u2022 Install GitHub CLI: ") + chalk15.cyan("https://cli.github.com\n");
+  message += chalk15.dim("       Then: ") + chalk15.cyan("gh repo create --private --source=.\n");
+  message += chalk15.dim("     \u2022 Or manually: ") + chalk15.cyan("https://github.com/new\n\n");
   if (scenario === "no-git") {
-    message += chalk13.dim("  3. Run: ") + chalk13.cyan("braingrid init\n\n");
+    message += chalk15.dim("  3. Run: ") + chalk15.cyan("braingrid init\n\n");
   } else {
-    message += chalk13.dim("  3. Add remote and run init:\n");
-    message += chalk13.cyan("     git remote add origin <url>\n");
-    message += chalk13.cyan("     braingrid init\n\n");
-  }
-  message += chalk13.bold("Or use BrainGrid without local initialization:\n\n");
-  message += chalk13.dim("  All commands support the --project flag:\n");
-  message += chalk13.cyan("    braingrid requirement list --project PROJ-123\n");
-  message += chalk13.cyan('    braingrid task create --project PROJ-123 --title "Task"\n\n');
-  message += chalk13.dim("  Note: Without local init, you must specify --project for each command.") + "\n";
+    message += chalk15.dim("  3. Add remote and run init:\n");
+    message += chalk15.cyan("     git remote add origin <url>\n");
+    message += chalk15.cyan("     braingrid init\n\n");
+  }
+  message += chalk15.bold("Or use BrainGrid without local initialization:\n\n");
+  message += chalk15.dim("  All commands support the --project flag:\n");
+  message += chalk15.cyan("    braingrid requirement list --project PROJ-123\n");
+  message += chalk15.cyan('    braingrid task create --project PROJ-123 --title "Task"\n\n');
+  message += chalk15.dim("  Note: Without local init, you must specify --project for each command.") + "\n";
   return message;
 }
 async function handleNoGitRepository() {
@@ -6066,12 +6395,12 @@ async function handleNoGitRepository() {
       if (!gitInitSuccess) {
         return {
           success: false,
-          message: chalk13.red("\u274C Failed to initialize git repository")
+          message: chalk15.red("\u274C Failed to initialize git repository")
         };
       }
-      console.log(chalk13.green("\u2705 Initialized git repository"));
+      console.log(chalk15.green("\u2705 Initialized git repository"));
       const dirName = getCurrentDirectoryName();
-      const isPrivate = await select2({
+      const isPrivate = await select3({
         message: "Repository visibility:",
         choices: [
           { value: true, name: "Private" },
@@ -6083,16 +6412,16 @@ async function handleNoGitRepository() {
         message: "Repository name:",
         default: dirName
       });
-      console.log(chalk13.dim("\nCreating repository...\n"));
+      console.log(chalk15.dim("\nCreating repository...\n"));
       const repo = await createGitHubRepoWithGh(repoName, isPrivate);
       if (!repo) {
         return {
           success: false,
-          message: chalk13.red("\u274C Failed to create GitHub repository\n\n") + showSetupInstructions("no-git")
+          message: chalk15.red("\u274C Failed to create GitHub repository\n\n") + showSetupInstructions("no-git")
         };
       }
-      console.log(chalk13.green(`\u2705 Created repository: ${repo.url}`));
-      console.log(chalk13.green("\u2705 Added remote origin\n"));
+      console.log(chalk15.green(`\u2705 Created repository: ${repo.url}`));
+      console.log(chalk15.green("\u2705 Added remote origin\n"));
       return {
         success: true,
         message: "continue-init",
@@ -6103,7 +6432,7 @@ async function handleNoGitRepository() {
   }
   return {
     success: false,
-    message: chalk13.yellow("\u26A0\uFE0F  This directory is not a git repository.\n\n") + showSetupInstructions("no-git")
+    message: chalk15.yellow("\u26A0\uFE0F  This directory is not a git repository.\n\n") + showSetupInstructions("no-git")
   };
 }
 async function handleNoGitRemote() {
@@ -6115,7 +6444,7 @@ async function handleNoGitRemote() {
     });
     if (shouldCreate) {
       const dirName = getCurrentDirectoryName();
-      const isPrivate = await select2({
+      const isPrivate = await select3({
         message: "Repository visibility:",
         choices: [
           { value: true, name: "Private" },
@@ -6127,16 +6456,16 @@ async function handleNoGitRemote() {
         message: "Repository name:",
         default: dirName
       });
-      console.log(chalk13.dim("\nCreating repository...\n"));
+      console.log(chalk15.dim("\nCreating repository...\n"));
       const repo = await createGitHubRepoWithGh(repoName, isPrivate);
       if (!repo) {
         return {
           success: false,
-          message: chalk13.red("\u274C Failed to create GitHub repository\n\n") + showSetupInstructions("no-remote")
+          message: chalk15.red("\u274C Failed to create GitHub repository\n\n") + showSetupInstructions("no-remote")
         };
       }
-      console.log(chalk13.green(`\u2705 Created repository: ${repo.url}`));
-      console.log(chalk13.green("\u2705 Added remote origin\n"));
+      console.log(chalk15.green(`\u2705 Created repository: ${repo.url}`));
+      console.log(chalk15.green("\u2705 Added remote origin\n"));
       return {
         success: true,
         message: "continue-init",
@@ -6147,11 +6476,31 @@ async function handleNoGitRemote() {
   }
   return {
     success: false,
-    message: chalk13.yellow("\u26A0\uFE0F  Git repository detected but no GitHub remote configured.\n\n") + showSetupInstructions("no-remote")
+    message: chalk15.yellow("\u26A0\uFE0F  Git repository detected but no GitHub remote configured.\n\n") + showSetupInstructions("no-remote")
   };
 }
 async function handleInit(opts) {
   try {
+    const updateInfo = await isUpdateAvailable();
+    if (updateInfo.available && updateInfo.latestVersion) {
+      console.log(
+        chalk15.yellow(`
+\u26A0\uFE0F  A new version of BrainGrid CLI is available: `) + chalk15.dim(`${updateInfo.currentVersion} \u2192 `) + chalk15.green(updateInfo.latestVersion) + "\n"
+      );
+      const shouldUpdate = await confirm({
+        message: "Would you like to update now?",
+        default: true
+      });
+      if (shouldUpdate) {
+        const result = await handleUpdate({});
+        console.log(result.message);
+        return {
+          success: true,
+          message: chalk15.dim("\nRun `braingrid init` again after the update completes.")
+        };
+      }
+      console.log();
+    }
     const config = getConfig();
     const { projectService, githubService, repositoryService, auth } = getServices4();
     if (!await isGitInstalled()) {
@@ -6162,7 +6511,7 @@ async function handleInit(opts) {
       if (!shouldInstall) {
         return {
           success: false,
-          message: chalk13.yellow("\u26A0\uFE0F  Git installation cancelled.\n\n") + getManualInstallInstructions()
+          message: chalk15.yellow("\u26A0\uFE0F  Git installation cancelled.\n\n") + getManualInstallInstructions()
         };
       }
       console.log();
@@ -6178,14 +6527,14 @@ async function handleInit(opts) {
       if (!await isGitInstalled()) {
         return {
           success: false,
-          message: chalk13.red("\u274C Git installation completed but git command not found\n\n") + chalk13.dim("You may need to restart your terminal or add Git to your PATH.\n") + getManualInstallInstructions()
+          message: chalk15.red("\u274C Git installation completed but git command not found\n\n") + chalk15.dim("You may need to restart your terminal or add Git to your PATH.\n") + getManualInstallInstructions()
         };
       }
     }
     if (!await isGhInstalled()) {
-      console.log(chalk13.blue("\n\u{1F4A1} GitHub CLI is highly recommended for working with BrainGrid."));
+      console.log(chalk15.blue("\n\u{1F4A1} GitHub CLI is highly recommended for working with BrainGrid."));
       console.log(
-        chalk13.dim("   It enables seamless GitHub integration and repository management.\n")
+        chalk15.dim("   It enables seamless GitHub integration and repository management.\n")
       );
       const shouldInstallGh = await confirm({
         message: "Would you like to install GitHub CLI now?",
@@ -6199,10 +6548,10 @@ async function handleInit(opts) {
           console.log();
         } else {
           console.log(ghInstallResult.message);
-          console.log(chalk13.dim("You can install it manually later.\n"));
+          console.log(chalk15.dim("You can install it manually later.\n"));
         }
       } else {
-        console.log(chalk13.dim("Skipping GitHub CLI installation.\n"));
+        console.log(chalk15.dim("Skipping GitHub CLI installation.\n"));
       }
     }
     if (await projectConfigExists() && !opts.force) {
@@ -6210,15 +6559,15 @@ async function handleInit(opts) {
         const existing = await loadProjectConfig();
         return {
           success: false,
-          message: chalk13.yellow("\u26A0\uFE0F  Already initialized.\n\n") + chalk13.dim(`Project: ${existing.project_name} (${existing.project_short_id})
-`) + chalk13.dim(`Repository: ${existing.repository?.full_name || "N/A"}
+          message: chalk15.yellow("\u26A0\uFE0F  Already initialized.\n\n") + chalk15.dim(`Project: ${existing.project_name} (${existing.project_short_id})
+`) + chalk15.dim(`Repository: ${existing.repository?.full_name || "N/A"}
 
-`) + chalk13.dim("Use --force to reinitialize")
+`) + chalk15.dim("Use --force to reinitialize")
         };
       } catch {
         return {
           success: false,
-          message: chalk13.yellow("\u26A0\uFE0F  Invalid project configuration found.\n") + chalk13.dim("Use --force to reinitialize")
+          message: chalk15.yellow("\u26A0\uFE0F  Invalid project configuration found.\n") + chalk15.dim("Use --force to reinitialize")
         };
       }
     }
@@ -6231,7 +6580,7 @@ async function handleInit(opts) {
       if (!shouldLogin) {
         return {
           success: false,
-          message: chalk13.yellow("\u26A0\uFE0F  Authentication required.\n") + chalk13.dim("Run ") + chalk13.cyan("braingrid login") + chalk13.dim(" when you're ready to authenticate.")
+          message: chalk15.yellow("\u26A0\uFE0F  Authentication required.\n") + chalk15.dim("Run ") + chalk15.cyan("braingrid login") + chalk15.dim(" when you're ready to authenticate.")
         };
       }
       console.log();
@@ -6239,13 +6588,13 @@ async function handleInit(opts) {
       if (!loginResult.success) {
         return {
           success: false,
-          message: chalk13.red("\u274C Login failed.\n") + chalk13.dim("Please try running ") + chalk13.cyan("braingrid login") + chalk13.dim(" again.")
+          message: chalk15.red("\u274C Login failed.\n") + chalk15.dim("Please try running ") + chalk15.cyan("braingrid login") + chalk15.dim(" again.")
         };
       }
       if (!await auth.isAuthenticated()) {
         return {
           success: false,
-          message: chalk13.red("\u274C Login was not completed.\n") + chalk13.dim("Please try running ") + chalk13.cyan("braingrid login") + chalk13.dim(" again.")
+          message: chalk15.red("\u274C Login was not completed.\n") + chalk15.dim("Please try running ") + chalk15.cyan("braingrid login") + chalk15.dim(" again.")
         };
       }
       console.log();
@@ -6254,27 +6603,27 @@ async function handleInit(opts) {
     if (!session) {
       return {
         success: false,
-        message: chalk13.red("\u274C No session found. Please run `braingrid login` first.")
+        message: chalk15.red("\u274C No session found. Please run `braingrid login` first.")
       };
     }
     if (session.organization_id === "default") {
-      console.log(chalk13.yellow("\u26A0\uFE0F  Organization ID not set, validating session...\n"));
+      console.log(chalk15.yellow("\u26A0\uFE0F  Organization ID not set, validating session...\n"));
       const isValid = await auth.isAuthenticated();
       if (!isValid) {
         return {
           success: false,
-          message: chalk13.red("\u274C Session validation failed. Please run `braingrid login` again.")
+          message: chalk15.red("\u274C Session validation failed. Please run `braingrid login` again.")
         };
       }
       const updatedSession = await auth.getStoredSession();
       if (!updatedSession || updatedSession.organization_id === "default") {
         return {
           success: false,
-          message: chalk13.red("\u274C Unable to retrieve organization information.\n\n") + chalk13.dim("This may indicate an issue with your account setup.\n") + chalk13.dim("Please contact support or try logging in again with ") + chalk13.cyan("braingrid logout") + chalk13.dim(" and ") + chalk13.cyan("braingrid login")
+          message: chalk15.red("\u274C Unable to retrieve organization information.\n\n") + chalk15.dim("This may indicate an issue with your account setup.\n") + chalk15.dim("Please contact support or try logging in again with ") + chalk15.cyan("braingrid logout") + chalk15.dim(" and ") + chalk15.cyan("braingrid login")
         };
       }
       Object.assign(session, updatedSession);
-      console.log(chalk13.green("\u2705 Organization ID updated successfully\n"));
+      console.log(chalk15.green("\u2705 Organization ID updated successfully\n"));
     }
     let gitInfo = await getGitRepositoryInfo();
     let project2;
@@ -6284,9 +6633,9 @@ async function handleInit(opts) {
       } catch {
         return {
           success: false,
-          message: chalk13.red(`\u274C Project not found: ${opts.project}
+          message: chalk15.red(`\u274C Project not found: ${opts.project}
 
-`) + chalk13.dim("Make sure the project ID is correct and you have access to it.")
+`) + chalk15.dim("Make sure the project ID is correct and you have access to it.")
         };
       }
     } else {
@@ -6297,7 +6646,7 @@ async function handleInit(opts) {
           if (!gitInfo || !gitInfo.owner || !gitInfo.name) {
             return {
               success: false,
-              message: chalk13.red("\u274C Failed to get repository information after setup")
+              message: chalk15.red("\u274C Failed to get repository information after setup")
             };
           }
         } else {
@@ -6311,7 +6660,7 @@ async function handleInit(opts) {
           if (!gitInfo || !gitInfo.owner || !gitInfo.name) {
             return {
               success: false,
-              message: chalk13.red("\u274C Failed to get repository information after setup")
+              message: chalk15.red("\u274C Failed to get repository information after setup")
             };
           }
         } else {
@@ -6321,7 +6670,7 @@ async function handleInit(opts) {
       if (!gitInfo) {
         return {
           success: false,
-          message: chalk13.red("\u274C Repository information is missing")
+          message: chalk15.red("\u274C Repository information is missing")
         };
       }
       const owner = gitInfo.owner;
@@ -6329,7 +6678,7 @@ async function handleInit(opts) {
       if (!owner || !name) {
         return {
           success: false,
-          message: chalk13.red("\u274C Repository information is incomplete")
+          message: chalk15.red("\u274C Repository information is incomplete")
         };
       }
       let response;
@@ -6368,7 +6717,7 @@ async function handleInit(opts) {
       }
       project2 = response.projects[0];
     }
-    const projectInfo = chalk13.bold("\n\u{1F4E6} BrainGrid Project Found\n\n") + chalk13.dim("Project:     ") + chalk13.cyan(project2.name) + "\n" + chalk13.dim("ID:          ") + chalk13.gray(project2.short_id) + "\n" + (project2.description ? chalk13.dim("Description: ") + chalk13.gray(project2.description) + "\n" : "") + chalk13.dim("Repository:  ") + chalk13.gray(project2.repository?.full_name || "N/A") + "\n\n";
+    const projectInfo = chalk15.bold("\n\u{1F4E6} BrainGrid Project Found\n\n") + chalk15.dim("Project:     ") + chalk15.cyan(project2.name) + "\n" + chalk15.dim("ID:          ") + chalk15.gray(project2.short_id) + "\n" + (project2.description ? chalk15.dim("Description: ") + chalk15.gray(project2.description) + "\n" : "") + chalk15.dim("Repository:  ") + chalk15.gray(project2.repository?.full_name || "N/A") + "\n\n";
     console.log(projectInfo);
     if (!opts.force) {
       const shouldInit = await confirm({
@@ -6378,7 +6727,7 @@ async function handleInit(opts) {
       if (!shouldInit) {
         return {
           success: false,
-          message: chalk13.yellow("Initialization cancelled.")
+          message: chalk15.yellow("Initialization cancelled.")
         };
       }
     }
@@ -6401,7 +6750,7 @@ async function handleInit(opts) {
     };
     await saveProjectConfig(localConfig);
     console.log(
-      chalk13.green("\u2705 Repository initialized successfully!\n\n") + chalk13.dim("Project:    ") + chalk13.cyan(project2.name) + chalk13.dim(` (${project2.short_id})`) + "\n" + chalk13.dim("Config:     ") + chalk13.gray(".braingrid/project.json") + "\n"
+      chalk15.green("\u2705 Repository initialized successfully!\n\n") + chalk15.dim("Project:    ") + chalk15.cyan(project2.name) + chalk15.dim(` (${project2.short_id})`) + "\n" + chalk15.dim("Config:     ") + chalk15.gray(".braingrid/project.json") + "\n"
     );
     const installedIDEs = await detectInstalledIDEs();
     if (installedIDEs.claudeCode) {
@@ -6419,15 +6768,15 @@ async function handleInit(opts) {
             if (result.success) {
               console.log(result.message);
             } else {
-              console.log(chalk13.yellow("\u26A0\uFE0F  Claude Code setup was not completed."));
+              console.log(chalk15.yellow("\u26A0\uFE0F  Claude Code setup was not completed."));
               console.log(
-                chalk13.dim("You can run ") + chalk13.cyan("braingrid setup claude-code") + chalk13.dim(" later.")
+                chalk15.dim("You can run ") + chalk15.cyan("braingrid setup claude-code") + chalk15.dim(" later.")
               );
             }
           } catch {
-            console.log(chalk13.yellow("\u26A0\uFE0F  Claude Code setup encountered an error."));
+            console.log(chalk15.yellow("\u26A0\uFE0F  Claude Code setup encountered an error."));
             console.log(
-              chalk13.dim("You can run ") + chalk13.cyan("braingrid setup claude-code") + chalk13.dim(" later.")
+              chalk15.dim("You can run ") + chalk15.cyan("braingrid setup claude-code") + chalk15.dim(" later.")
             );
           }
           console.log("");
@@ -6449,15 +6798,15 @@ async function handleInit(opts) {
             if (result.success) {
               console.log(result.message);
             } else {
-              console.log(chalk13.yellow("\u26A0\uFE0F  Cursor setup was not completed."));
+              console.log(chalk15.yellow("\u26A0\uFE0F  Cursor setup was not completed."));
               console.log(
-                chalk13.dim("You can run ") + chalk13.cyan("braingrid setup cursor") + chalk13.dim(" later.")
+                chalk15.dim("You can run ") + chalk15.cyan("braingrid setup cursor") + chalk15.dim(" later.")
               );
             }
           } catch {
-            console.log(chalk13.yellow("\u26A0\uFE0F  Cursor setup encountered an error."));
+            console.log(chalk15.yellow("\u26A0\uFE0F  Cursor setup encountered an error."));
             console.log(
-              chalk13.dim("You can run ") + chalk13.cyan("braingrid setup cursor") + chalk13.dim(" later.")
+              chalk15.dim("You can run ") + chalk15.cyan("braingrid setup cursor") + chalk15.dim(" later.")
             );
           }
           console.log("");
@@ -6466,7 +6815,7 @@ async function handleInit(opts) {
     }
     return {
       success: true,
-      message: chalk13.dim(
+      message: chalk15.dim(
         "You can now use project-scoped commands without specifying a project ID."
       ),
       data: localConfig
@@ -6479,205 +6828,8 @@ async function handleInit(opts) {
   }
 }
 
-// src/handlers/update.handlers.ts
-import chalk14 from "chalk";
-import axios5 from "axios";
-
-// src/utils/package-manager.ts
-import { execSync } from "child_process";
-import { select as select3 } from "@inquirer/prompts";
-function isPackageManagerInstalled(pm) {
-  try {
-    execSync(`which ${pm}`, { stdio: "ignore", timeout: 2e3 });
-    return true;
-  } catch {
-    return false;
-  }
-}
-function checkGlobalInstallation(pm, packageName) {
-  try {
-    let command;
-    switch (pm) {
-      case "npm": {
-        command = `npm list -g ${packageName} 2>&1`;
-        break;
-      }
-      case "pnpm": {
-        command = `pnpm list -g ${packageName} 2>&1`;
-        break;
-      }
-      case "yarn": {
-        command = `yarn global list 2>&1`;
-        break;
-      }
-    }
-    const output = execSync(command, {
-      encoding: "utf-8",
-      timeout: 5e3
-    });
-    if (pm === "npm" || pm === "pnpm") {
-      return output.includes(packageName) && !output.includes("(empty)");
-    }
-    if (pm === "yarn") {
-      return output.includes(packageName);
-    }
-    return false;
-  } catch {
-    return false;
-  }
-}
-async function getPackageManagerInfo(packageName) {
-  const packageManagers = ["npm", "pnpm", "yarn"];
-  return packageManagers.map((pm) => {
-    const installed = isPackageManagerInstalled(pm);
-    return {
-      name: pm,
-      installed,
-      hasPackage: installed ? checkGlobalInstallation(pm, packageName) : false
-    };
-  });
-}
-async function detectPackageManager(packageName) {
-  const pmInfo = await getPackageManagerInfo(packageName);
-  const installedWith = pmInfo.find((pm) => pm.hasPackage);
-  if (installedWith) {
-    return installedWith.name;
-  }
-  const availablePMs = pmInfo.filter((pm) => pm.installed);
-  if (availablePMs.length === 0) {
-    throw new Error("No package manager found. Please install npm, pnpm, or yarn.");
-  }
-  if (availablePMs.length === 1) {
-    return availablePMs[0].name;
-  }
-  const selected = await select3({
-    message: "Unable to detect which package manager was used. Please select one:",
-    choices: availablePMs.map((pm) => ({
-      name: pm.name,
-      value: pm.name
-    }))
-  });
-  return selected;
-}
-function getUpdateCommand(pm, packageName) {
-  switch (pm) {
-    case "npm": {
-      return `npm install -g ${packageName}@latest`;
-    }
-    case "pnpm": {
-      return `pnpm add -g ${packageName}@latest`;
-    }
-    case "yarn": {
-      return `yarn global add ${packageName}@latest`;
-    }
-  }
-}
-function executeUpdate(pm, packageName) {
-  const command = getUpdateCommand(pm, packageName);
-  try {
-    execSync(command, {
-      stdio: "inherit",
-      timeout: 12e4
-      // 2 minutes timeout
-    });
-  } catch (error) {
-    throw new Error(
-      `Failed to update package: ${error instanceof Error ? error.message : String(error)}`
-    );
-  }
-}
-
-// src/handlers/update.handlers.ts
-var PACKAGE_NAME = "@braingrid/cli";
-var NPM_REGISTRY_URL = `https://registry.npmjs.org/${PACKAGE_NAME}`;
-function getCurrentVersion() {
-  return CLI_VERSION;
-}
-async function getLatestVersion() {
-  try {
-    const response = await axios5.get(NPM_REGISTRY_URL, {
-      timeout: 1e4
-    });
-    return response.data["dist-tags"].latest;
-  } catch (error) {
-    throw new Error(`Failed to fetch latest version: ${formatError(error)}`);
-  }
-}
-function compareVersions(v1, v2) {
-  const v1Parts = v1.split(".").map(Number);
-  const v2Parts = v2.split(".").map(Number);
-  for (let i = 0; i < Math.max(v1Parts.length, v2Parts.length); i++) {
-    const v1Part = v1Parts[i] || 0;
-    const v2Part = v2Parts[i] || 0;
-    if (v1Part < v2Part) return -1;
-    if (v1Part > v2Part) return 1;
-  }
-  return 0;
-}
-async function handleUpdate(opts) {
-  try {
-    const currentVersion = getCurrentVersion();
-    let output = chalk14.bold.cyan("\n\u{1F504} BrainGrid CLI Update\n\n");
-    output += `${chalk14.bold("Current version:")} ${currentVersion}
-`;
-    output += chalk14.dim("Checking for updates...\n");
-    const latestVersion = await getLatestVersion();
-    output += `${chalk14.bold("Latest version:")}  ${latestVersion}
-
-`;
-    const comparison = compareVersions(currentVersion, latestVersion);
-    if (comparison === 0) {
-      output += chalk14.green("\u2705 You are already on the latest version!\n");
-      return {
-        success: true,
-        message: output,
-        data: { currentVersion, latestVersion, upToDate: true }
-      };
-    }
-    if (comparison > 0) {
-      output += chalk14.yellow("\u26A0\uFE0F  You are on a newer version than what is published.\n");
-      output += chalk14.dim("   This is expected if you are developing locally.\n");
-      return {
-        success: true,
-        message: output,
-        data: { currentVersion, latestVersion, upToDate: false }
-      };
-    }
-    output += chalk14.yellow(`\u2B06\uFE0F  Update available: ${currentVersion} \u2192 ${latestVersion}
-
-`);
-    if (opts.check) {
-      output += chalk14.dim("Run ") + chalk14.cyan("braingrid update") + chalk14.dim(" to update\n");
-      return {
-        success: true,
-        message: output,
-        data: { currentVersion, latestVersion, upToDate: false }
-      };
-    }
-    output += chalk14.dim("Detecting package manager...\n");
-    const packageManager = await detectPackageManager(PACKAGE_NAME);
-    output += `${chalk14.bold("Package manager:")} ${packageManager}
-
-`;
-    const updateCommand = getUpdateCommand(packageManager, PACKAGE_NAME);
-    output += chalk14.dim("Running: ") + chalk14.cyan(updateCommand) + "\n\n";
-    console.log(output);
-    executeUpdate(packageManager, PACKAGE_NAME);
-    return {
-      success: true,
-      message: chalk14.green("\n\u2705 Successfully updated BrainGrid CLI!\n"),
-      data: { currentVersion, latestVersion, packageManager }
-    };
-  } catch (error) {
-    return {
-      success: false,
-      message: formatError(error)
-    };
-  }
-}
-
 // src/handlers/completion.handlers.ts
-import chalk15 from "chalk";
+import chalk16 from "chalk";
 
 // src/completion/index.ts
 import omelette from "omelette";
@@ -6753,7 +6905,7 @@ function setupCompletion(shell) {
 function getUnsupportedShellError() {
   return {
     success: false,
-    message: chalk15.red("\u274C Could not detect shell type.\n\n") + chalk15.dim("Please specify a shell:\n") + chalk15.cyan("  braingrid completion bash\n") + chalk15.cyan("  braingrid completion zsh\n\n") + chalk15.dim("Supported shells: bash, zsh")
+    message: chalk16.red("\u274C Could not detect shell type.\n\n") + chalk16.dim("Please specify a shell:\n") + chalk16.cyan("  braingrid completion bash\n") + chalk16.cyan("  braingrid completion zsh\n\n") + chalk16.dim("Supported shells: bash, zsh")
   };
 }
 async function handleCompletion(shellArg, opts) {
@@ -6783,33 +6935,33 @@ async function handleCompletion(shellArg, opts) {
         const configPath = getShellConfigPath(shell);
         return {
           success: true,
-          message: chalk15.green(`\u2705 Completion installed for ${shell}
+          message: chalk16.green(`\u2705 Completion installed for ${shell}
 
-`) + chalk15.dim("To activate in your current shell, run:\n") + chalk15.cyan(`  source ${configPath}
+`) + chalk16.dim("To activate in your current shell, run:\n") + chalk16.cyan(`  source ${configPath}
 
-`) + chalk15.dim("Or restart your terminal.")
+`) + chalk16.dim("Or restart your terminal.")
         };
       } catch (error) {
         return {
           success: false,
-          message: chalk15.red("\u274C Failed to install completion\n\n") + chalk15.dim("Error: ") + formatError(error)
+          message: chalk16.red("\u274C Failed to install completion\n\n") + chalk16.dim("Error: ") + formatError(error)
         };
       }
     }
     try {
       const script = generateCompletionScript(shell);
       const configPath = getShellConfigPath(shell);
-      const instructions = chalk15.blue(`# BrainGrid CLI completion for ${shell}
-`) + chalk15.dim("# To install, run one of the following:\n\n") + chalk15.cyan(`# 1. Automatic installation (recommended):
-`) + chalk15.cyan(`   braingrid completion --setup
+      const instructions = chalk16.blue(`# BrainGrid CLI completion for ${shell}
+`) + chalk16.dim("# To install, run one of the following:\n\n") + chalk16.cyan(`# 1. Automatic installation (recommended):
+`) + chalk16.cyan(`   braingrid completion --setup
 
-`) + chalk15.cyan(`# 2. Add to your shell config:
-`) + chalk15.cyan(`   braingrid completion ${shell} >> ${configPath}
+`) + chalk16.cyan(`# 2. Add to your shell config:
+`) + chalk16.cyan(`   braingrid completion ${shell} >> ${configPath}
 
-`) + chalk15.cyan(`# 3. Source directly (temporary, current session only):
-`) + chalk15.cyan(`   eval "$(braingrid completion ${shell})"
+`) + chalk16.cyan(`# 3. Source directly (temporary, current session only):
+`) + chalk16.cyan(`   eval "$(braingrid completion ${shell})"
 
-`) + chalk15.dim("# Completion script:\n\n");
+`) + chalk16.dim("# Completion script:\n\n");
       return {
         success: true,
         message: instructions + script
@@ -6817,7 +6969,7 @@ async function handleCompletion(shellArg, opts) {
     } catch (error) {
       return {
         success: false,
-        message: chalk15.red("\u274C Failed to generate completion script\n\n") + chalk15.dim("Error: ") + formatError(error)
+        message: chalk16.red("\u274C Failed to generate completion script\n\n") + chalk16.dim("Error: ") + formatError(error)
       };
     }
   } catch (error) {
@@ -6834,6 +6986,9 @@ var packageJson = require2("../package.json");
 initCompletion();
 var program = new Command();
 program.name("braingrid").description("BrainGrid CLI - Manage projects, requirements, and tasks").version(packageJson.version, "-v, --version", "output the current version").showHelpAfterError("(use --help for usage)");
+program.hook("postAction", async () => {
+  await checkAndShowUpdateWarning();
+});
 program.command("login").description("Authenticate with BrainGrid").action(async () => {
   const result = await handleLogin();
   console.log(result.message);
@@ -6954,7 +7109,7 @@ requirement.command("list").description("List requirements for a project").optio
 requirement.command("show [id]").description("Show requirement details (auto-detects ID from git branch if not provided)").option(
   "-p, --project <id>",
   "project ID (auto-detects from .braingrid/project.json if not provided)"
-).action(async (id, opts) => {
+).option("--format <format>", "output format (table, json, xml, markdown)", "table").action(async (id, opts) => {
   const result = await handleRequirementShow({ ...opts, id });
   console.log(result.message);
   if (!result.success) {
@@ -7027,7 +7182,7 @@ task.command("summary").description("Show task summary table (quick overview wit
     process.exit(1);
   }
 });
-task.command("show <id>").description("Show task details").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)").action(async (id, opts) => {
+task.command("show <id>").description("Show task details").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)", "table").action(async (id, opts) => {
   const result = await handleTaskShow(id, opts);
   console.log(result.message);
   if (!result.success) {