@braingrid/cli 0.2.18 → 0.2.20

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.18" : "0.0.0-test";
+var CLI_VERSION = true ? "0.2.20" : "0.0.0-test";
 var PRODUCTION_CONFIG = {
   apiUrl: "https://app.braingrid.ai",
   workosAuthUrl: "https://auth.braingrid.ai",
@@ -3914,6 +3914,9 @@ async function handleRequirementList(opts) {
         break;
       }
     }
+    if (response.pagination?.has_more) {
+      output += "\n" + chalk7.yellow("\u26A0\uFE0F More requirements exist. Use --limit to see more.");
+    }
     return {
       success: true,
       message: output,
@@ -4522,11 +4525,19 @@ async function getCurrentTask(taskService, projectId, requirementId) {
   const response = await taskService.listTasks(projectId, requirementId);
   const inProgress = response.tasks.find((t) => t.status === "IN_PROGRESS");
   if (inProgress) {
-    return { success: true, taskId: inProgress.number };
+    const warning = response.pagination?.has_more ? "Note: More tasks exist beyond current page." : void 0;
+    return { success: true, taskId: inProgress.number, warning };
   }
   const planned = response.tasks.find((t) => t.status === "PLANNED");
   if (planned) {
-    return { success: true, taskId: planned.number };
+    const warning = response.pagination?.has_more ? "Note: More tasks exist beyond current page." : void 0;
+    return { success: true, taskId: planned.number, warning };
+  }
+  if (response.pagination?.has_more) {
+    return {
+      success: false,
+      error: "No active task found in current page. More tasks exist - use --limit to fetch more."
+    };
   }
   return {
     success: false,
@@ -4561,7 +4572,10 @@ async function handleTaskList(opts) {
     }
     const requirementId = requirementResult.requirementId;
     stopSpinner = showSpinner("Loading tasks", chalk8.gray);
-    const response = await taskService.listTasks(projectId, requirementId);
+    const response = await taskService.listTasks(projectId, requirementId, {
+      page: opts.page ? parseInt(opts.page, 10) : 1,
+      limit: opts.limit ? parseInt(opts.limit, 10) : 20
+    });
     stopSpinner();
     stopSpinner = null;
     if (response.tasks.length === 0) {
@@ -4575,12 +4589,15 @@ async function handleTaskList(opts) {
     const requirementShortId = opts.requirement || requirementId;
     const format = opts.format || "markdown";
     const config = getConfig();
-    const output = formatTasksListOutput(response.tasks, format, true, {
+    let output = formatTasksListOutput(response.tasks, format, true, {
       requirementId,
       projectShortId,
       requirementShortId,
       apiUrl: config.apiUrl
     });
+    if (response.pagination?.has_more) {
+      output += "\n" + chalk8.yellow("\u26A0\uFE0F More tasks exist. Use --limit to see more.");
+    }
     return {
       success: true,
       message: output,
@@ -4624,7 +4641,10 @@ async function handleTaskSummary(opts) {
     }
     const requirementId = requirementResult.requirementId;
     stopSpinner = showSpinner("Loading tasks", chalk8.gray);
-    const response = await taskService.listTasks(projectId, requirementId);
+    const response = await taskService.listTasks(projectId, requirementId, {
+      page: opts.page ? parseInt(opts.page, 10) : 1,
+      limit: opts.limit ? parseInt(opts.limit, 10) : 20
+    });
     stopSpinner();
     stopSpinner = null;
     if (response.tasks.length === 0) {
@@ -4637,12 +4657,15 @@ async function handleTaskSummary(opts) {
     const projectShortId = projectId;
     const requirementShortId = opts.requirement || requirementId;
     const config = getConfig();
-    const output = formatTasksListOutput(response.tasks, "table", false, {
+    let output = formatTasksListOutput(response.tasks, "table", false, {
       requirementId,
       projectShortId,
       requirementShortId,
       apiUrl: config.apiUrl
     });
+    if (response.pagination?.has_more) {
+      output += "\n" + chalk8.yellow("\u26A0\uFE0F More tasks exist. Use --limit to see more.");
+    }
     return {
       success: true,
       message: output,
@@ -4695,6 +4718,7 @@ async function handleTaskShow(id, opts) {
     }
     const requirementId = requirementResult.requirementId;
     let taskId;
+    let taskWarning;
     if (id) {
       taskId = normalizeTaskId(id);
     } else {
@@ -4706,6 +4730,7 @@ async function handleTaskShow(id, opts) {
         };
       }
       taskId = currentTask.taskId;
+      taskWarning = currentTask.warning;
     }
     const config = getConfig();
     stopSpinner = showSpinner("Loading task", chalk8.gray);
@@ -4740,6 +4765,9 @@ async function handleTaskShow(id, opts) {
         break;
       }
     }
+    if (taskWarning) {
+      output += "\n" + chalk8.yellow(`\u26A0\uFE0F ${taskWarning}`);
+    }
     return {
       success: true,
       message: output,
@@ -4849,6 +4877,7 @@ async function handleTaskUpdate(id, opts) {
     }
     const requirementId = requirementResult.requirementId;
     let taskId;
+    let taskWarning;
     if (id) {
       taskId = normalizeTaskId(id);
     } else {
@@ -4860,6 +4889,7 @@ async function handleTaskUpdate(id, opts) {
         };
       }
       taskId = currentTask.taskId;
+      taskWarning = currentTask.warning;
     }
     const config = getConfig();
     stopSpinner = showSpinner("Updating task", chalk8.gray);
@@ -4869,7 +4899,7 @@ async function handleTaskUpdate(id, opts) {
     });
     stopSpinner();
     stopSpinner = null;
-    const output = formatTaskOutput(task2, {
+    let output = formatTaskOutput(task2, {
       showContent: true,
       successMessage: `Updated task ${task2.number}`,
       apiUrl: config.apiUrl,
@@ -4877,6 +4907,9 @@ async function handleTaskUpdate(id, opts) {
       requirementShortId: opts?.requirement || requirementId,
       requirementId
     });
+    if (taskWarning) {
+      output += "\n" + chalk8.yellow(`\u26A0\uFE0F ${taskWarning}`);
+    }
     return {
       success: true,
       message: output,
@@ -5227,7 +5260,7 @@ async function handleStatus() {
 
 // src/handlers/init.handlers.ts
 import chalk15 from "chalk";
-import { confirm, select as select3, input } from "@inquirer/prompts";
+import { confirm as confirm2, select as select3, input } from "@inquirer/prompts";
 
 // src/services/internal/github-service.ts
 var GitHubService = class {
@@ -5495,7 +5528,8 @@ function getManualInstallInstructions() {
 }
 
 // src/handlers/update.handlers.ts
-import chalk12 from "chalk";
+import chalk13 from "chalk";
+import { confirm } from "@inquirer/prompts";
 
 // src/utils/package-manager.ts
 import { execSync } from "child_process";
@@ -5631,139 +5665,8 @@ function compareVersions(v1, v2) {
   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 chalk12 from "chalk";
 import { select as select2 } from "@inquirer/prompts";
 import * as path4 from "path";
 import * as fs4 from "fs/promises";
@@ -5981,7 +5884,7 @@ async function checkPrerequisites() {
   } catch {
     return {
       success: false,
-      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")
+      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")
     };
   }
   try {
@@ -5989,7 +5892,7 @@ async function checkPrerequisites() {
   } catch {
     return {
       success: false,
-      message: chalk14.red("\u274C Not authenticated with GitHub CLI.\n\n") + chalk14.dim("Please run: ") + chalk14.cyan("gh auth login")
+      message: chalk12.red("\u274C Not authenticated with GitHub CLI.\n\n") + chalk12.dim("Please run: ") + chalk12.cyan("gh auth login")
     };
   }
   return null;
@@ -6016,7 +5919,7 @@ async function getFileList(sourcePaths, targetPaths) {
       }
     } catch (error) {
       console.warn(
-        chalk14.yellow(`\u26A0\uFE0F  Could not list directory: ${sourceDir}`),
+        chalk12.yellow(`\u26A0\uFE0F  Could not list directory: ${sourceDir}`),
         error instanceof Error ? error.message : String(error)
       );
     }
@@ -6027,28 +5930,28 @@ async function getFileList(sourcePaths, targetPaths) {
   return operations;
 }
 function displayInstallationPlan(operations, injectionFile) {
-  console.log(chalk14.bold("\n\u{1F4CB} Installation Plan:\n"));
-  console.log(chalk14.cyan("  Content Injection:"));
-  console.log(chalk14.dim(`    ${injectionFile}`));
+  console.log(chalk12.bold("\n\u{1F4CB} Installation Plan:\n"));
+  console.log(chalk12.cyan("  Content Injection:"));
+  console.log(chalk12.dim(`    ${injectionFile}`));
   const newFiles = operations.filter((op) => !op.exists);
   const existingFiles = operations.filter((op) => op.exists);
   if (newFiles.length > 0) {
-    console.log(chalk14.cyan("\n  New Files:"));
+    console.log(chalk12.cyan("\n  New Files:"));
     for (const op of newFiles) {
-      console.log(chalk14.dim(`    ${op.targetPath}`));
+      console.log(chalk12.dim(`    ${op.targetPath}`));
     }
   }
   if (existingFiles.length > 0) {
-    console.log(chalk14.yellow("\n  Existing Files (will prompt):"));
+    console.log(chalk12.yellow("\n  Existing Files (will prompt):"));
     for (const op of existingFiles) {
-      console.log(chalk14.dim(`    ${op.targetPath}`));
+      console.log(chalk12.dim(`    ${op.targetPath}`));
     }
   }
   console.log("");
 }
 async function promptForConflict(filePath) {
   const answer = await select2({
-    message: chalk14.yellow(`File exists: ${filePath}`),
+    message: chalk12.yellow(`File exists: ${filePath}`),
     choices: [
       { name: "[O]verwrite - Replace this file", value: "overwrite" },
       { name: "[S]kip - Keep existing file", value: "skip" },
@@ -6079,7 +5982,7 @@ async function installFiles(operations, force) {
       installed++;
     } catch (error) {
       console.error(
-        chalk14.red(`Failed to copy ${operation.targetPath}:`),
+        chalk12.red(`Failed to copy ${operation.targetPath}:`),
         error instanceof Error ? error.message : String(error)
       );
       skipped++;
@@ -6093,7 +5996,7 @@ async function _handleSetup(config, opts) {
     if (prerequisiteError) {
       return prerequisiteError;
     }
-    console.log(chalk14.bold(`\u{1F680} Setting up ${config.name} integration...
+    console.log(chalk12.bold(`\u{1F680} Setting up ${config.name} integration...
 `));
     const operations = await getFileList(config.sourceDirs, config.targetDirs);
     const injectionFileExists = await fileExists(config.injection.targetFile);
@@ -6110,7 +6013,7 @@ async function _handleSetup(config, opts) {
     if (opts.dryRun) {
       return {
         success: true,
-        message: chalk14.green("\u2705 Dry-run complete. No files were modified.\n\n") + chalk14.dim(`Would install ${operations.length} files.`)
+        message: chalk12.green("\u2705 Dry-run complete. No files were modified.\n\n") + chalk12.dim(`Would install ${operations.length} files.`)
       };
     }
     const copyOps = operations.filter((op) => op.type === "copy");
@@ -6118,7 +6021,7 @@ async function _handleSetup(config, opts) {
     if (result.cancelled) {
       return {
         success: false,
-        message: chalk14.yellow("\u26A0\uFE0F  Installation cancelled.\n\n") + chalk14.dim(`Installed: ${result.installed}, Skipped: ${result.skipped}`),
+        message: chalk12.yellow("\u26A0\uFE0F  Installation cancelled.\n\n") + chalk12.dim(`Installed: ${result.installed}, Skipped: ${result.skipped}`),
         code: "CANCELLED"
       };
     }
@@ -6127,7 +6030,7 @@ async function _handleSetup(config, opts) {
       await injectContentIntoFile(config.injection.targetFile, content);
     } catch (error) {
       console.error(
-        chalk14.red(`Failed to inject content into ${config.injection.targetFile}:`),
+        chalk12.red(`Failed to inject content into ${config.injection.targetFile}:`),
         error instanceof Error ? error.message : String(error)
       );
     }
@@ -6140,27 +6043,27 @@ async function _handleSetup(config, opts) {
         statusLineInstalled = true;
       } catch (error) {
         console.error(
-          chalk14.yellow("\u26A0\uFE0F  Failed to install status line script:"),
+          chalk12.yellow("\u26A0\uFE0F  Failed to install status line script:"),
           error instanceof Error ? error.message : String(error)
         );
       }
     }
-    const statusLineMessage = statusLineInstalled ? chalk14.dim("  Status line: .claude/statusline.sh\n") : "";
+    const statusLineMessage = statusLineInstalled ? chalk12.dim("  Status line: .claude/statusline.sh\n") : "";
     return {
       success: true,
-      message: chalk14.green(`\u2705 ${config.name} integration installed successfully!
+      message: chalk12.green(`\u2705 ${config.name} integration installed successfully!
 
-`) + chalk14.dim("Files installed:\n") + chalk14.dim(`  Commands: ${result.installed} files
-`) + statusLineMessage + chalk14.dim(`  Content injected into: ${config.injection.targetFile}
+`) + chalk12.dim("Files installed:\n") + chalk12.dim(`  Commands: ${result.installed} files
+`) + statusLineMessage + chalk12.dim(`  Content injected into: ${config.injection.targetFile}
 
-`) + 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)
+`) + 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)
     };
   } catch (error) {
     const errorMessage = error instanceof Error ? error.message : String(error);
     return {
       success: false,
-      message: chalk14.red(`\u274C Setup failed: ${errorMessage}`)
+      message: chalk12.red(`\u274C Setup failed: ${errorMessage}`)
     };
   }
 }
@@ -6191,6 +6094,161 @@ async function handleSetupCursor(opts) {
   return _handleSetup(config, opts);
 }
 
+// src/handlers/update.handlers.ts
+async function handleUpdate(opts) {
+  try {
+    const currentVersion = getCurrentVersion();
+    let output = chalk13.bold.cyan("\n\u{1F504} BrainGrid CLI Update\n\n");
+    output += `${chalk13.bold("Current version:")} ${currentVersion}
+`;
+    output += chalk13.dim("Checking for updates...\n");
+    const latestVersion = await getLatestVersion();
+    output += `${chalk13.bold("Latest version:")}  ${latestVersion}
+
+`;
+    const comparison = compareVersions(currentVersion, latestVersion);
+    if (comparison === 0) {
+      output += chalk13.green("\u2705 You are already on the latest version!\n");
+      return {
+        success: true,
+        message: output,
+        data: { currentVersion, latestVersion, upToDate: true }
+      };
+    }
+    if (comparison > 0) {
+      output += chalk13.yellow("\u26A0\uFE0F  You are on a newer version than what is published.\n");
+      output += chalk13.dim("   This is expected if you are developing locally.\n");
+      return {
+        success: true,
+        message: output,
+        data: { currentVersion, latestVersion, upToDate: false }
+      };
+    }
+    output += chalk13.yellow(`\u2B06\uFE0F  Update available: ${currentVersion} \u2192 ${latestVersion}
+
+`);
+    if (opts.check) {
+      output += chalk13.dim("Run ") + chalk13.cyan("braingrid update") + chalk13.dim(" to update\n");
+      return {
+        success: true,
+        message: output,
+        data: { currentVersion, latestVersion, upToDate: false }
+      };
+    }
+    output += chalk13.dim("Detecting package manager...\n");
+    const packageManager = await detectPackageManager(PACKAGE_NAME);
+    output += `${chalk13.bold("Package manager:")} ${packageManager}
+
+`;
+    const updateCommand = getUpdateCommand(packageManager, PACKAGE_NAME);
+    output += chalk13.dim("Running: ") + chalk13.cyan(updateCommand) + "\n\n";
+    console.log(output);
+    executeUpdate(packageManager, PACKAGE_NAME);
+    const cliTools = await checkInstalledCliTools();
+    const claudeInstalled = cliTools.find((t) => t.command === "claude")?.installed;
+    const cursorInstalled = cliTools.find((t) => t.command === "cursor")?.installed;
+    let setupOutput = "";
+    if (claudeInstalled) {
+      const shouldUpdate = await confirm({
+        message: "Claude Code detected. Update BrainGrid integration?",
+        default: true
+      });
+      if (shouldUpdate) {
+        const result = await handleSetupClaudeCode({ force: true });
+        setupOutput += "\n" + result.message;
+      }
+    }
+    if (cursorInstalled) {
+      const shouldUpdate = await confirm({
+        message: "Cursor detected. Update BrainGrid integration?",
+        default: true
+      });
+      if (shouldUpdate) {
+        const result = await handleSetupCursor({ force: true });
+        setupOutput += "\n" + result.message;
+      }
+    }
+    return {
+      success: true,
+      message: chalk13.green("\n\u2705 Successfully updated BrainGrid CLI!\n") + setupOutput,
+      data: { currentVersion, latestVersion, packageManager }
+    };
+  } catch (error) {
+    return {
+      success: false,
+      message: formatError(error)
+    };
+  }
+}
+
+// src/utils/update-checker.ts
+import chalk14 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" + chalk14.yellow(`\u26A0\uFE0F  Update available: ${currentVersion} \u2192 ${latestVersion}`) + "\n" + chalk14.dim(`    Run \`${getUpdateCommand2()}\` to update`) + "\n";
+      console.log(warning);
+    }
+  } catch {
+  }
+}
+
 // src/handlers/init.handlers.ts
 import { access as access3 } from "fs/promises";
 
@@ -6303,7 +6361,7 @@ async function promptToCreateProject(gitInfo, projectService, repositoryService)
     chalk15.yellow("\u26A0\uFE0F  Repository accessible but no project exists.\n\n") + chalk15.dim(`Repository: ${gitInfo.owner}/${gitInfo.name}
 `)
   );
-  const shouldCreate = await confirm({
+  const shouldCreate = await confirm2({
     message: `Would you like to create a project for ${gitInfo.name} now?`,
     default: true
   });
@@ -6424,7 +6482,7 @@ function showSetupInstructions(scenario) {
 async function handleNoGitRepository() {
   const canAutomate = await canUseGhAutomation();
   if (canAutomate) {
-    const shouldSetup = await confirm({
+    const shouldSetup = await confirm2({
       message: "Would you like to initialize git and create a GitHub repository?",
       default: true
     });
@@ -6477,7 +6535,7 @@ async function handleNoGitRepository() {
 async function handleNoGitRemote() {
   const canAutomate = await canUseGhAutomation();
   if (canAutomate) {
-    const shouldCreate = await confirm({
+    const shouldCreate = await confirm2({
       message: "Would you like to create a GitHub repository now?",
       default: true
     });
@@ -6526,7 +6584,7 @@ async function handleInit(opts) {
         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({
+      const shouldUpdate = await confirm2({
         message: "Would you like to update now?",
         default: true
       });
@@ -6543,7 +6601,7 @@ async function handleInit(opts) {
     const config = getConfig();
     const { projectService, githubService, repositoryService, auth } = getServices4();
     if (!await isGitInstalled()) {
-      const shouldInstall = await confirm({
+      const shouldInstall = await confirm2({
         message: "Git is required but not installed. Would you like to install it now?",
         default: true
       });
@@ -6575,7 +6633,7 @@ async function handleInit(opts) {
       console.log(
         chalk15.dim("   It enables seamless GitHub integration and repository management.\n")
       );
-      const shouldInstallGh = await confirm({
+      const shouldInstallGh = await confirm2({
         message: "Would you like to install GitHub CLI now?",
         default: true
       });
@@ -6612,7 +6670,7 @@ async function handleInit(opts) {
     }
     const isAuthenticated = await auth.isAuthenticated();
     if (!isAuthenticated) {
-      const shouldLogin = await confirm({
+      const shouldLogin = await confirm2({
         message: "You need to be authenticated. Would you like to log in / sign up now?",
         default: true
       });
@@ -6759,7 +6817,7 @@ async function handleInit(opts) {
     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({
+      const shouldInit = await confirm2({
         message: "Initialize this repository with the above project?",
         default: true
       });
@@ -6796,7 +6854,7 @@ async function handleInit(opts) {
       const claudeSetupExists = await fileExists2(".claude/commands/specify.md");
       if (!claudeSetupExists) {
         console.log("");
-        const setupClaude = await confirm({
+        const setupClaude = await confirm2({
           message: "Claude Code detected. Install BrainGrid integration? (slash commands, skills, status line)",
           default: true
         });
@@ -6826,7 +6884,7 @@ async function handleInit(opts) {
       const cursorSetupExists = await fileExists2(".cursor/commands/specify.md");
       if (!cursorSetupExists) {
         console.log("");
-        const setupCursor = await confirm({
+        const setupCursor = await confirm2({
           message: "Cursor detected. Install BrainGrid integration? (slash commands, rules, context)",
           default: true
         });
@@ -7207,14 +7265,14 @@ requirement.command("build [id]").description(
   }
 });
 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").action(async (opts) => {
+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);
   console.log(result.message);
   if (!result.success) {
     process.exit(1);
   }
 });
-task.command("summary").description("Show task summary table (quick overview without content)").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 (opts) => {
+task.command("summary").description("Show task summary table (quick overview without content)").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("--page <page>", "page number for pagination", "1").option("--limit <limit>", "number of tasks per page", "20").action(async (opts) => {
   const result = await handleTaskSummary(opts);
   console.log(result.message);
   if (!result.success) {