cc-hub-cli 1.1.17 → 1.1.18

package/dist/index.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 
 // src/index.ts
-import { Command as Command8 } from "commander";
+import { Command as Command9 } from "commander";
 import { createRequire } from "module";
 
 // src/profiles/commands.ts
@@ -141,7 +141,7 @@ var MacOSDesktopApp = class {
     if (fs2.existsSync(configLib)) return configLib;
     return configLib;
   }
-  findBinary() {
+  findBinary(pinnedVersion) {
     debug(`desktop-app: searching for binary in ${this.supportDir}`);
     const claudeCodeDir = path2.join(this.supportDir, "claude-code");
     if (!fs2.existsSync(claudeCodeDir)) return void 0;
@@ -155,7 +155,17 @@ var MacOSDesktopApp = class {
     }
     if (versions.length === 0) return void 0;
     versions.sort(sortSemverDesc);
-    const binary = path2.join(claudeCodeDir, versions[0], "claude.app", "Contents", "MacOS", "claude");
+    let targetVersion = versions[0];
+    if (pinnedVersion) {
+      const match = versions.find((v) => v === pinnedVersion);
+      if (match) {
+        targetVersion = match;
+        debug(`desktop-app: using pinned version ${targetVersion}`);
+      } else {
+        warn(`desktop-app: pinned version ${pinnedVersion} not found locally; falling back to latest ${targetVersion}`);
+      }
+    }
+    const binary = path2.join(claudeCodeDir, targetVersion, "claude.app", "Contents", "MacOS", "claude");
     debug(`desktop-app: found macOS binary ${binary}`);
     return binary;
   }
@@ -226,7 +236,7 @@ var WindowsDesktopApp = class {
     const dir = this._findSupportDir();
     return dir ? path2.join(dir, "local-agent-mode-sessions") : void 0;
   }
-  findBinary() {
+  findBinary(_pinnedVersion) {
     const win32Binary = path2.join(process.env.LOCALAPPDATA || "", "Programs", "Claude", "Claude.exe");
     if (fs2.existsSync(win32Binary)) return win32Binary;
     return void 0;
@@ -245,7 +255,7 @@ var NoOpDesktopApp = class {
   getConfigLibrary() {
     return void 0;
   }
-  findBinary() {
+  findBinary(_pinnedVersion) {
     return void 0;
   }
 };
@@ -700,7 +710,7 @@ function getKimiHeaders(claudeVersion) {
   const stainlessOS = platform === "darwin" ? "MacOS" : platform === "win32" ? "Windows" : "Linux";
   return {
     "X-Stainless-OS": stainlessOS,
-    "X-Stainless-Package-Version": "1.1.17",
+    "X-Stainless-Package-Version": "1.1.18",
     "X-Stainless-Runtime": "node",
     "User-Agent": `claude-code/${claudeVersion}`
   };
@@ -1016,12 +1026,25 @@ function getClaudeVersion() {
   debug("binary-resolver: could not detect Claude version, using default");
   return cachedVersion;
 }
+function getPinnedVersion() {
+  try {
+    ensureSettingsFile();
+    const settings2 = readJson(SETTINGS_FILE);
+    if (settings2.minimumVersion && settings2.requiredMaximumVersion && settings2.minimumVersion === settings2.requiredMaximumVersion) {
+      return settings2.minimumVersion;
+    }
+    return void 0;
+  } catch {
+    return void 0;
+  }
+}
 var SystemBinaryResolver = class {
   constructor(app) {
     this.app = app;
   }
   app;
-  resolve() {
+  resolve(pinnedVersion) {
+    const pin = pinnedVersion ?? getPinnedVersion();
     debug("binary-resolver: trying global 'claude' command");
     try {
       const result = spawnSync("claude", ["--version"], {
@@ -1030,12 +1053,22 @@ var SystemBinaryResolver = class {
       });
       if (result.status === 0) {
         debug("binary-resolver: found global 'claude'");
+        if (pin) {
+          const currentVersion = getClaudeVersion();
+          if (currentVersion !== pin) {
+            warn(`binary-resolver: global claude version ${currentVersion} does not match pinned version ${pin}`);
+            console.warn(`Warning: installed Claude version (${currentVersion}) does not match pinned version (${pin}).`);
+            console.warn(`To install the pinned version, run: npm install -g @anthropic-ai/claude-code@${pin}`);
+          } else {
+            debug(`binary-resolver: global claude version matches pinned ${pin}`);
+          }
+        }
         return "claude";
       }
     } catch {
     }
     debug("binary-resolver: trying desktop app binary");
-    const desktopBinary = this.app.findBinary();
+    const desktopBinary = this.app.findBinary(pin);
     if (desktopBinary) {
       debug(`binary-resolver: found desktop binary at ${desktopBinary}`);
       return desktopBinary;
@@ -2411,6 +2444,7 @@ _cc-hub() {
     'session:Manage Claude Code sessions'
     'provider:Manage provider types'
     'cache:Manage Claude Code cache and backup files'
+    'claude-version:Manage Claude Code CLI versions'
     'completion:Print shell completion functions'
     'help:Display help for a command'
   )
@@ -2459,6 +2493,12 @@ _cc-hub() {
     'troubleshoot:Launch Claude Code to troubleshoot a session file'
   )
 
+  local -a claude_version_subcmds
+  claude_version_subcmds=(
+    'list:List available Claude Code versions'
+    'pin:Pin Claude Code to a specific version'
+  )
+
   _cc_hub_profiles() {
     local profiles_file="\${CLAUDE_PROFILES_FILE:-$HOME/.claude/profiles.json}"
     if [[ -f "$profiles_file" ]]; then
@@ -2545,6 +2585,13 @@ _cc-hub() {
             _arguments -C -S               '(-i --interactive)'{-i,--interactive}'[Open an interactive Claude Code window instead of a one-shot prompt]'
           fi
           ;;
+        claude-version)
+          if (( CURRENT == 2 )); then
+            _describe -t claude-version-subcmds 'claude-version subcommand' claude_version_subcmds
+          elif [[ $words[2] == "pin" ]]; then
+            _arguments -C -S               '--clear[Remove the version pin]'               '*:version:'
+          fi
+          ;;
       esac
       ;;
   esac
@@ -2598,7 +2645,7 @@ _cc-hub() {
   COMPREPLY=()
   cur="\${COMP_WORDS[COMP_CWORD]}"
   prev="\${COMP_WORDS[COMP_CWORD-1]}"
-  commands="profile use run hook session provider cache completion help"
+  commands="profile use run hook session provider cache claude-version completion help"
 
   local profile_subcmds="add update list view remove rename default sync export"
   local provider_subcmds="list"
@@ -2606,6 +2653,7 @@ _cc-hub() {
   local hooks_subcmds="list add remove enable disable"
   local session_subcmds="list show search ps stats clean troubleshoot"
   local cache_subcmds="restore"
+  local claude_version_subcmds="list pin"
 
   # Top-level command
   if [[ \${COMP_CWORD} -eq 1 ]]; then
@@ -2676,6 +2724,18 @@ _cc-hub() {
         fi
       fi
       ;;
+    claude-version)
+      if [[ \${COMP_CWORD} -eq 2 ]]; then
+        COMPREPLY=($(compgen -W "$claude_version_subcmds" -- "$cur"))
+      elif [[ "\${COMP_WORDS[2]}" == "pin" ]]; then
+        if [[ "$prev" == "--clear" ]]; then
+          :
+        else
+          local pin_opts="--clear"
+          COMPREPLY=($(compgen -W "$pin_opts" -- "$cur"))
+        fi
+      fi
+      ;;
   esac
 
   return 0
@@ -2696,6 +2756,7 @@ var POWERSHELL_COMPLETION = `Register-ArgumentCompleter -Native -CommandName cc-
     'session:Manage Claude Code sessions'
     'provider:Manage provider types'
     'cache:Manage Claude Code cache and backup files'
+    'claude-version:Manage Claude Code CLI versions'
     'completion:Print shell completion functions'
     'help:Display help for a command'
   )
@@ -2705,6 +2766,7 @@ var POWERSHELL_COMPLETION = `Register-ArgumentCompleter -Native -CommandName cc-
   $sessionSubcmds = @('list', 'show', 'search', 'ps', 'stats', 'clean', 'troubleshoot')
   $cacheSubcmds = @('restore')
   $providerSubcmds = @('list')
+  $claudeVersionSubcmds = @('list', 'pin')
 
   $tokens = $commandAst.CommandElements | ForEach-Object { $_.ToString() }
 
@@ -2750,6 +2812,16 @@ var POWERSHELL_COMPLETION = `Register-ArgumentCompleter -Native -CommandName cc-
         return
       }
     }
+    'claude-version' {
+      if ($tokens.Count -eq 2 -or ($tokens.Count -eq 3 -and $wordToComplete -ne '')) {
+        $claudeVersionSubcmds | ForEach-Object { if ($_ -like "$wordToComplete*") { $_ } }
+        return
+      }
+      if ($tokens[2] -eq 'pin' -and $tokens.Count -ge 3) {
+        $opts = @('--clear')
+        $opts | ForEach-Object { if ($_ -like "$wordToComplete*") { $_ } }
+      }
+    }
     'use' {
       $opts = @('--built-in')
       $opts | ForEach-Object { if ($_ -like "$wordToComplete*") { $_ } }
@@ -2915,8 +2987,8 @@ function killProcesses(pids) {
   }
 }
 function cacheCommand() {
-  const cache = new Command7("cache").description("Manage Claude Code cache and backup files");
-  cache.command("restore").description("Restore ~/.claude/.claude.json.backup to ~/.claude.json").action(safeAction(async () => {
+  const cache2 = new Command7("cache").description("Manage Claude Code cache and backup files");
+  cache2.command("restore").description("Restore ~/.claude/.claude.json.backup to ~/.claude.json").action(safeAction(async () => {
     const backupPath = path9.join(CLAUDE_DIR, ".claude.json.backup");
     const targetPath = CLAUDE_JSON;
     if (!fs8.existsSync(backupPath)) {
@@ -2938,7 +3010,169 @@ function cacheCommand() {
     debug(`cache restore: restored ${backupPath} -> ${targetPath}`);
     console.log(`Restored ${backupPath} -> ${targetPath}`);
   }));
-  return cache;
+  return cache2;
+}
+
+// src/claude-version/commands.ts
+import { Command as Command8 } from "commander";
+import fs9 from "fs";
+import path10 from "path";
+
+// src/claude-version/fetcher.ts
+var cache = null;
+var cacheTime = 0;
+var CACHE_TTL_MS = 5 * 60 * 1e3;
+async function fetchChangelogVersions() {
+  if (cache && Date.now() - cacheTime < CACHE_TTL_MS) {
+    return cache;
+  }
+  const url = "https://code.claude.com/docs/en/changelog";
+  const response = await fetch(url, {
+    headers: {
+      "User-Agent": `cc-hub/${"1.1.18"}`
+    }
+  });
+  if (!response.ok) {
+    throw new Error(`Failed to fetch changelog: ${response.status} ${response.statusText}`);
+  }
+  const html = await response.text();
+  const versions = parseChangelogHtml(html);
+  cache = versions;
+  cacheTime = Date.now();
+  return versions;
+}
+function parseChangelogHtml(html) {
+  const results = [];
+  const seen = /* @__PURE__ */ new Set();
+  const componentRegex = /label:\s*"(\d+\.\d+\.\d+)"[\s\S]*?description:\s*"([^"]{5,60})"/g;
+  let match;
+  while ((match = componentRegex.exec(html)) !== null) {
+    const version2 = match[1];
+    const date = match[2].trim();
+    if (seen.has(version2)) continue;
+    seen.add(version2);
+    results.push({ version: version2, date });
+  }
+  const versionRegex = /<div[^>]*contenteditable=["']?false["']?[^>]*>(\d+\.\d+\.\d+)<\/div>/gi;
+  while ((match = versionRegex.exec(html)) !== null) {
+    const version2 = match[1];
+    if (seen.has(version2)) continue;
+    seen.add(version2);
+    const startIdx = match.index + match[0].length;
+    const snippet2 = html.slice(startIdx, startIdx + 500);
+    const dateMatch = snippet2.match(/<p>([^<]{5,60})<\/p>/) || snippet2.match(/data-component-part=["']?update-description["']?[^>]*>([^<]{5,60})<\/div>/);
+    const date = dateMatch ? dateMatch[1].trim() : "";
+    results.push({ version: version2, date });
+  }
+  const headingRegex = /<h[23][^>]*>(\d+\.\d+\.\d+)[^<]*<\/h[23]>/gi;
+  while ((match = headingRegex.exec(html)) !== null) {
+    const version2 = match[1];
+    if (seen.has(version2)) continue;
+    seen.add(version2);
+    const startIdx = match.index + match[0].length;
+    const snippet2 = html.slice(startIdx, startIdx + 500);
+    const dateMatch = snippet2.match(/<p>([^<]{5,60})<\/p>/);
+    const date = dateMatch ? dateMatch[1].trim() : "";
+    results.push({ version: version2, date });
+  }
+  return results;
+}
+
+// src/claude-version/utils.ts
+function getPinnedVersion2() {
+  ensureSettingsFile();
+  const settings2 = readJson(SETTINGS_FILE);
+  return settings2.minimumVersion && settings2.requiredMaximumVersion && settings2.minimumVersion === settings2.requiredMaximumVersion ? settings2.minimumVersion : void 0;
+}
+function setPinnedVersion(version2) {
+  ensureSettingsFile();
+  const settings2 = readJson(SETTINGS_FILE);
+  if (version2) {
+    settings2.minimumVersion = version2;
+    settings2.requiredMaximumVersion = version2;
+  } else {
+    delete settings2.minimumVersion;
+    delete settings2.requiredMaximumVersion;
+  }
+  writeJson(SETTINGS_FILE, settings2);
+}
+
+// src/claude-version/commands.ts
+function claudeVersionCommand() {
+  const cmd = new Command8("claude-version").description("Manage Claude Code CLI versions");
+  cmd.command("list").description("List available Claude Code versions").action(safeAction(async () => {
+    const [remoteVersions, installedVersion, pinnedVersion] = await Promise.all([
+      fetchChangelogVersions().catch(() => []),
+      Promise.resolve(getClaudeVersion()).catch(() => "unknown"),
+      Promise.resolve(getPinnedVersion2())
+    ]);
+    if (remoteVersions.length === 0) {
+      console.log("Could not fetch remote versions. Showing installed version only.");
+      console.log(`Installed: ${installedVersion}`);
+      if (pinnedVersion) {
+        console.log(`Pinned:    ${pinnedVersion}`);
+      }
+      return;
+    }
+    console.log("Available Claude Code versions:");
+    console.log("");
+    const maxVersionLen = Math.max(...remoteVersions.map((v) => v.version.length), 10);
+    const maxDateLen = Math.max(...remoteVersions.map((v) => v.date.length), 4);
+    console.log(`${"Version".padEnd(maxVersionLen)}  ${"Date".padEnd(maxDateLen)}  Status`);
+    console.log("-".repeat(maxVersionLen + maxDateLen + 10));
+    for (const { version: version2, date } of remoteVersions.slice(0, 20)) {
+      const markers = [];
+      if (version2 === installedVersion) markers.push("installed");
+      if (version2 === pinnedVersion) markers.push("pinned");
+      const status = markers.length > 0 ? `(${markers.join(", ")})` : "";
+      console.log(`${version2.padEnd(maxVersionLen)}  ${(date || "\u2014").padEnd(maxDateLen)}  ${status}`);
+    }
+    if (remoteVersions.length > 20) {
+      console.log(`... and ${remoteVersions.length - 20} more versions`);
+    }
+    console.log("");
+    console.log(`Installed: ${installedVersion}`);
+    if (pinnedVersion) {
+      console.log(`Pinned:    ${pinnedVersion}`);
+    } else {
+      console.log("No version pinned (using latest)");
+    }
+  }));
+  cmd.command("pin [version]").description("Pin Claude Code to a specific version (omit or --clear to unpin)").option("--clear", "Remove the version pin").action(safeAction(async (version2, opts) => {
+    if (opts.clear || !version2) {
+      setPinnedVersion(void 0);
+      console.log("Version pin cleared. cc-hub will use the latest available Claude Code version.");
+      return;
+    }
+    if (!/^\d+\.\d+\.\d+$/.test(version2)) {
+      console.error(`Invalid version format: ${version2}. Expected format: x.y.z`);
+      process.exit(1);
+    }
+    let localAvailable = false;
+    if (process.platform === "darwin") {
+      const desktopApp2 = new MacOSDesktopApp();
+      const supportDir = desktopApp2.getSupportDir();
+      if (supportDir) {
+        const claudeCodeDir = path10.join(supportDir, "claude-code");
+        if (fs9.existsSync(claudeCodeDir)) {
+          const versions = fs9.readdirSync(claudeCodeDir).filter(
+            (d) => fs9.existsSync(path10.join(claudeCodeDir, d, "claude.app", "Contents", "MacOS", "claude"))
+          );
+          localAvailable = versions.includes(version2);
+        }
+      }
+    }
+    setPinnedVersion(version2);
+    console.log(`Pinned Claude Code version: ${version2}`);
+    if (process.platform === "darwin" && !localAvailable) {
+      console.warn(`Warning: version ${version2} is not installed in the desktop app. The pin will take effect once that version is available, or you can install it via:`);
+      console.warn(`  npm install -g @anthropic-ai/claude-code@${version2}`);
+    } else if (process.platform !== "darwin") {
+      console.log(`Note: on ${process.platform}, ensure the global install matches the pinned version:`);
+      console.log(`  npm install -g @anthropic-ai/claude-code@${version2}`);
+    }
+  }));
+  return cmd;
 }
 
 // src/index.ts
@@ -2948,7 +3182,7 @@ ensureSettingsFile();
 var settings = readJson(SETTINGS_FILE);
 setLogLevel(settings._cc_hub_logLevel || "INFO");
 installGlobalExceptionHandlers();
-var program = new Command8();
+var program = new Command9();
 program.name("cc-hub").description("Manage Claude CLI profiles, hooks, and sessions").version(version);
 program.addCommand(profileCommand());
 program.addCommand(useCommand());
@@ -2959,6 +3193,7 @@ program.addCommand(completionCommand());
 program.addCommand(providerCommand());
 program.addCommand(proxyCommand());
 program.addCommand(cacheCommand());
+program.addCommand(claudeVersionCommand());
 try {
   program.parse();
 } catch (err) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cc-hub-cli",
-  "version": "1.1.17",
+  "version": "1.1.18",
   "description": "Manage Claude CLI profiles, hooks, and sessions",
   "type": "module",
   "bin": {