Function updateCommand

src/cli/commands/update.ts:27–100

(
  logger: Logger,
  currentVersion: string,
  options: UpdateCommandOptions,
)

 * Update command handler
 */
export async function updateCommand(
  logger: Logger,
  currentVersion: string,
  options: UpdateCommandOptions,
): Promise<void> {
  const { check = false, force = false, token } = options;

  try {
    const environment = detectExecutionEnvironment();
    logger.debug(`Detected environment: ${environment}`);

    if (environment === "npm") {
      logger.info(getNpmUpgradeInstructions());
      return;
    }

    if (environment === "homebrew") {
      logger.info(getHomebrewUpgradeInstructions());
      return;
    }

    // Single-binary mode
    if (check) {
      // Check-only mode
      logger.info("Checking for updates...");
      const updateCheck = await checkForUpdate(currentVersion, token);

      // Capture JSON data if in JSON mode
      if (logger.jsonMode) {
        logger.captureData("currentVersion", updateCheck.currentVersion);
        logger.captureData("latestVersion", updateCheck.latestVersion);
        logger.captureData("updateAvailable", updateCheck.hasUpdate);
        logger.captureData(
          "message",
          updateCheck.hasUpdate
            ? `Update available: ${updateCheck.currentVersion} -> ${updateCheck.latestVersion}`
            : `Already at the latest version (${updateCheck.currentVersion})`,
        );
      }

      if (updateCheck.hasUpdate) {
        logger.success(
          `Update available: ${updateCheck.currentVersion} -> ${updateCheck.latestVersion}`,
        );
      } else {
        logger.info(`Already at the latest version (${updateCheck.currentVersion})`);
      }
      return;
    }

    // Perform update
    logger.info("Checking for updates...");
    const message = await performBinaryUpdate(currentVersion, { force, token });
    logger.success(message);
  } catch (error) {
    if (error instanceof GitHubClientError) {
      // Include auth hints in error message for JSON mode
      const authHint =