claudekit-cli 3.25.0 → 3.26.0

package/dist/index.js

@@ -6297,7 +6297,7 @@ var require_jsonfile = __commonJS((exports, module) => {
     return obj;
   }
   var readFile = universalify.fromPromise(_readFile);
-  function readFileSync3(file, options = {}) {
+  function readFileSync4(file, options = {}) {
     if (typeof options === "string") {
       options = { encoding: options };
     }
@@ -6329,7 +6329,7 @@ var require_jsonfile = __commonJS((exports, module) => {
   }
   module.exports = {
     readFile,
-    readFileSync: readFileSync3,
+    readFileSync: readFileSync4,
     writeFile,
     writeFileSync
   };
@@ -8208,7 +8208,7 @@ var init_opencode_installer = __esm(() => {
 var PARTIAL_INSTALL_VERSION = "partial", EXIT_CODE_CRITICAL_FAILURE = 1, EXIT_CODE_PARTIAL_SUCCESS = 2;
 
 // src/services/package-installer/install-error-handler.ts
-import { existsSync as existsSync13, readFileSync as readFileSync5, unlinkSync as unlinkSync2 } from "node:fs";
+import { existsSync as existsSync13, readFileSync as readFileSync6, unlinkSync as unlinkSync2 } from "node:fs";
 import { join as join21 } from "node:path";
 function parseNameReason(str) {
   const colonIndex = str.indexOf(":");
@@ -8225,7 +8225,7 @@ function displayInstallErrors(skillsDir) {
   }
   let summary;
   try {
-    summary = JSON.parse(readFileSync5(summaryPath, "utf-8"));
+    summary = JSON.parse(readFileSync6(summaryPath, "utf-8"));
   } catch (parseError) {
     logger.error("Failed to parse error summary. File may be corrupted.");
     logger.debug(`Parse error: ${parseError instanceof Error ? parseError.message : String(parseError)}`);
@@ -17682,6 +17682,70 @@ class CheckRunner {
 import { exec as exec4 } from "node:child_process";
 import { promisify as promisify4 } from "node:util";
 
+// src/domains/github/gh-cli-utils.ts
+init_logger();
+import { readFileSync } from "node:fs";
+var MIN_GH_CLI_VERSION = "2.20.0";
+var GH_COMMAND_TIMEOUT_MS = 1e4;
+function compareVersions(a, b) {
+  const partsA = a.split(".").map(Number);
+  const partsB = b.split(".").map(Number);
+  const maxLen = Math.max(partsA.length, partsB.length);
+  for (let i = 0;i < maxLen; i++) {
+    const numA = partsA[i] ?? 0;
+    const numB = partsB[i] ?? 0;
+    if (numA < numB)
+      return -1;
+    if (numA > numB)
+      return 1;
+  }
+  return 0;
+}
+function isWSL() {
+  if (process.platform !== "linux")
+    return false;
+  try {
+    const release = readFileSync("/proc/version", "utf-8").toLowerCase();
+    return release.includes("microsoft") || release.includes("wsl");
+  } catch (error) {
+    logger.debug(`WSL detection skipped: ${error instanceof Error ? error.message : "unknown error"}`);
+    return false;
+  }
+}
+function shouldSkipExpensiveOperations() {
+  if (process.env.CK_TEST_HOME) {
+    return false;
+  }
+  return process.env.CI === "true" || process.env.CI_SAFE_MODE === "true";
+}
+function getGhUpgradeInstructions(currentVersion) {
+  const platform = process.platform;
+  const wsl = isWSL();
+  const lines = [];
+  lines.push(`✗ GitHub CLI v${currentVersion} is outdated`);
+  lines.push(`  Minimum required: v${MIN_GH_CLI_VERSION}`);
+  lines.push("");
+  if (wsl) {
+    lines.push("Upgrade GitHub CLI (WSL/Ubuntu):");
+    lines.push("  curl -fsSL https://cli.github.com/packages/githubcli-archive-keyring.gpg | sudo dd of=/usr/share/keyrings/githubcli-archive-keyring.gpg");
+    lines.push('  echo "deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/githubcli-archive-keyring.gpg] https://cli.github.com/packages stable main" | sudo tee /etc/apt/sources.list.d/github-cli.list > /dev/null');
+    lines.push("  sudo apt update && sudo apt install gh");
+  } else if (platform === "darwin") {
+    lines.push("Upgrade GitHub CLI:");
+    lines.push("  brew upgrade gh");
+  } else if (platform === "win32") {
+    lines.push("Upgrade GitHub CLI:");
+    lines.push("  winget upgrade GitHub.cli");
+  } else {
+    lines.push("Upgrade GitHub CLI:");
+    lines.push("  sudo apt update && sudo apt upgrade gh");
+    lines.push("  Or visit: https://cli.github.com");
+  }
+  lines.push("");
+  lines.push("After upgrade: gh auth login -h github.com");
+  return lines;
+}
+
 // src/services/package-installer/dependency-checker.ts
 import { exec } from "node:child_process";
 import { promisify } from "node:util";
@@ -17697,7 +17761,7 @@ function notFoundError(type, name, hint) {
 // src/services/package-installer/dependency-checker.ts
 init_logger();
 var execAsync = promisify(exec);
-function shouldSkipExpensiveOperations() {
+function shouldSkipExpensiveOperations2() {
   if (process.env.CK_TEST_HOME) {
     return false;
   }
@@ -17709,9 +17773,9 @@ function getOSInfo() {
   const isWindows = platform === "win32";
   const isMacOS = platform === "darwin";
   const isLinux = platform === "linux";
-  const isWSL = isLinux && process.env.WSL_DISTRO_NAME !== undefined;
+  const isWSL2 = isLinux && process.env.WSL_DISTRO_NAME !== undefined;
   let details = `${platform}-${arch}`;
-  if (isWSL) {
+  if (isWSL2) {
     details += ` (WSL: ${process.env.WSL_DISTRO_NAME})`;
   }
   return {
@@ -17720,7 +17784,7 @@ function getOSInfo() {
     isWindows,
     isMacOS,
     isLinux,
-    isWSL,
+    isWSL: isWSL2,
     details
   };
 }
@@ -17791,7 +17855,7 @@ var DEPENDENCIES = {
   }
 };
 async function commandExists(command) {
-  if (shouldSkipExpensiveOperations()) {
+  if (shouldSkipExpensiveOperations2()) {
     const supportedCommands = ["node", "python", "python3", "pip", "pip3", "claude"];
     return supportedCommands.includes(command);
   }
@@ -17807,7 +17871,7 @@ async function commandExists(command) {
   }
 }
 async function getCommandPath(command) {
-  if (shouldSkipExpensiveOperations()) {
+  if (shouldSkipExpensiveOperations2()) {
     const ciPath = getCICommandPath(command);
     if (ciPath)
       return ciPath;
@@ -17826,7 +17890,7 @@ async function getCommandPath(command) {
   }
 }
 async function getCommandVersion(command, versionFlag, versionRegex) {
-  if (shouldSkipExpensiveOperations()) {
+  if (shouldSkipExpensiveOperations2()) {
     const mockVersions = {
       npm: "10.0.0",
       node: "20.0.0",
@@ -17852,7 +17916,7 @@ async function getCommandVersion(command, versionFlag, versionRegex) {
     return null;
   }
 }
-function compareVersions(current, required) {
+function compareVersions2(current, required) {
   const parseCurrent = current.split(".").map((n) => Number.parseInt(n, 10));
   const parseRequired = required.split(".").map((n) => Number.parseInt(n, 10));
   for (let i = 0;i < 3; i++) {
@@ -17876,7 +17940,7 @@ async function checkDependency(config) {
       let meetsRequirements = true;
       let message;
       if (config.minVersion && version) {
-        meetsRequirements = compareVersions(version, config.minVersion);
+        meetsRequirements = compareVersions2(version, config.minVersion);
         if (!meetsRequirements) {
           message = `Version ${version} is below minimum ${config.minVersion}`;
         }
@@ -18135,27 +18199,6 @@ async function installDependency(dependency, method) {
 // src/domains/health-checks/system-checker.ts
 init_logger();
 var execAsync4 = promisify4(exec4);
-var MIN_GH_CLI_VERSION = "2.20.0";
-function compareVersions2(a, b) {
-  const partsA = a.split(".").map(Number);
-  const partsB = b.split(".").map(Number);
-  const maxLen = Math.max(partsA.length, partsB.length);
-  for (let i = 0;i < maxLen; i++) {
-    const numA = partsA[i] ?? 0;
-    const numB = partsB[i] ?? 0;
-    if (numA < numB)
-      return -1;
-    if (numA > numB)
-      return 1;
-  }
-  return 0;
-}
-function shouldSkipExpensiveOperations2() {
-  if (process.env.CK_TEST_HOME) {
-    return false;
-  }
-  return process.env.CI === "true" || process.env.CI_SAFE_MODE === "true";
-}
 
 class SystemChecker {
   group = "system";
@@ -18170,7 +18213,7 @@ class SystemChecker {
       logger.verbose(`SystemChecker: Processing ${dep.name}`);
       results.push(await this.mapDependencyToCheck(dep));
     }
-    if (!shouldSkipExpensiveOperations2()) {
+    if (!shouldSkipExpensiveOperations()) {
       logger.verbose("SystemChecker: Checking git");
       results.push(await this.checkGit());
       logger.verbose("SystemChecker: Checking GitHub CLI");
@@ -18292,7 +18335,7 @@ class SystemChecker {
       const { stdout } = await execAsync4("gh --version");
       const match = stdout.match(/(\d+\.\d+\.\d+)/);
       const version = match?.[1];
-      if (version && compareVersions2(version, MIN_GH_CLI_VERSION) < 0) {
+      if (version && compareVersions(version, MIN_GH_CLI_VERSION) < 0) {
         return {
           id: "gh-cli-version",
           name: "GitHub CLI",
@@ -18370,18 +18413,18 @@ class SystemChecker {
 import { join as join2 } from "node:path";
 
 // src/shared/path-resolver.ts
-import { existsSync as existsSync2, readFileSync as readFileSync2 } from "node:fs";
+import { existsSync as existsSync2, readFileSync as readFileSync3 } from "node:fs";
 import { homedir, platform } from "node:os";
 import { join, normalize } from "node:path";
-function isWSL() {
+function isWSL2() {
   try {
-    return process.platform === "linux" && existsSync2("/proc/version") && readFileSync2("/proc/version", "utf8").toLowerCase().includes("microsoft");
+    return process.platform === "linux" && existsSync2("/proc/version") && readFileSync3("/proc/version", "utf8").toLowerCase().includes("microsoft");
   } catch {
     return false;
   }
 }
 function normalizeWSLPath(p) {
-  if (!isWSL())
+  if (!isWSL2())
     return p;
   const windowsMatch = p.match(/^([A-Za-z]):(.*)/);
   if (windowsMatch) {
@@ -18524,7 +18567,7 @@ class PathResolver {
     return normalizeWSLPath(p);
   }
   static isWSL() {
-    return isWSL();
+    return isWSL2();
   }
   static isAtHomeDirectory(cwd) {
     const currentDir = normalize(cwd || process.cwd());
@@ -19170,7 +19213,7 @@ function checkClaudeMdFile(path, name, id) {
   }
 }
 // src/domains/health-checks/checkers/active-plan-checker.ts
-import { existsSync as existsSync5, readFileSync as readFileSync3 } from "node:fs";
+import { existsSync as existsSync5, readFileSync as readFileSync4 } from "node:fs";
 import { join as join5 } from "node:path";
 function checkActivePlan(projectDir) {
   const activePlanPath = join5(projectDir, ".claude", "active-plan");
@@ -19186,7 +19229,7 @@ function checkActivePlan(projectDir) {
     };
   }
   try {
-    const targetPath = readFileSync3(activePlanPath, "utf-8").trim();
+    const targetPath = readFileSync4(activePlanPath, "utf-8").trim();
     const fullPath = join5(projectDir, targetPath);
     if (!existsSync5(fullPath)) {
       return {
@@ -21547,7 +21590,7 @@ class AutoHealer {
 }
 // src/domains/health-checks/report-generator.ts
 import { execSync as execSync4, spawnSync } from "node:child_process";
-import { readFileSync as readFileSync4, unlinkSync, writeFileSync } from "node:fs";
+import { readFileSync as readFileSync5, unlinkSync, writeFileSync } from "node:fs";
 import { tmpdir as tmpdir2 } from "node:os";
 import { dirname as dirname2, join as join16 } from "node:path";
 import { fileURLToPath } from "node:url";
@@ -21558,7 +21601,7 @@ function getCliVersion() {
   try {
     const __dirname2 = dirname2(fileURLToPath(import.meta.url));
     const pkgPath = join16(__dirname2, "../../../package.json");
-    const pkg = JSON.parse(readFileSync4(pkgPath, "utf-8"));
+    const pkg = JSON.parse(readFileSync5(pkgPath, "utf-8"));
     return pkg.version || "unknown";
   } catch (err) {
     logger.debug(`Failed to read CLI version: ${err}`);
@@ -40314,6 +40357,105 @@ async function detectAccessibleKits() {
   return accessible;
 }
 
+// src/domains/github/preflight-checker.ts
+init_logger();
+import { exec as exec7 } from "node:child_process";
+import { promisify as promisify7 } from "node:util";
+var execAsync7 = promisify7(exec7);
+function createSuccessfulPreflightResult() {
+  return {
+    success: true,
+    ghInstalled: true,
+    ghVersion: MIN_GH_CLI_VERSION,
+    ghVersionOk: true,
+    ghAuthenticated: true,
+    errorLines: []
+  };
+}
+function isTimeoutError(error) {
+  if (error instanceof Error) {
+    const msg = error.message.toLowerCase();
+    return msg.includes("timeout") || msg.includes("timed out") || msg.includes("etimedout");
+  }
+  return false;
+}
+async function runPreflightChecks() {
+  logger.debug("Running GitHub CLI pre-flight checks");
+  if (shouldSkipExpensiveOperations()) {
+    logger.debug("Skipping preflight checks in test/CI environment");
+    return createSuccessfulPreflightResult();
+  }
+  const result = {
+    success: false,
+    ghInstalled: false,
+    ghVersion: null,
+    ghVersionOk: false,
+    ghAuthenticated: false,
+    errorLines: []
+  };
+  try {
+    const { stdout: stdout2 } = await execAsync7("gh --version", { timeout: GH_COMMAND_TIMEOUT_MS });
+    const match2 = stdout2.match(/(\d+\.\d+\.\d+)/);
+    if (!match2) {
+      logger.debug(`GitHub CLI version not detected from output: ${stdout2.trim()}`);
+      result.ghInstalled = true;
+      result.errorLines.push("✗ GitHub CLI installed but version could not be detected");
+      result.errorLines.push(`  Output: ${stdout2.trim().slice(0, 100)}`);
+      result.errorLines.push("  Try running: gh --version");
+      return result;
+    }
+    result.ghVersion = match2[1];
+    result.ghInstalled = true;
+    logger.debug(`GitHub CLI detected: v${result.ghVersion}`);
+  } catch (error) {
+    if (isTimeoutError(error)) {
+      logger.debug("GitHub CLI check timed out");
+      result.errorLines.push("✗ GitHub CLI check timed out");
+      result.errorLines.push("  This may indicate a slow system or network issue");
+      result.errorLines.push("  Try running: gh --version");
+    } else {
+      logger.debug(`GitHub CLI not found: ${error instanceof Error ? error.message : "unknown error"}`);
+      result.errorLines.push("✗ GitHub CLI not installed");
+      result.errorLines.push("  Install from: https://cli.github.com");
+      result.errorLines.push("");
+      result.errorLines.push("After install: gh auth login -h github.com");
+    }
+    return result;
+  }
+  if (result.ghVersion) {
+    const comparison = compareVersions(result.ghVersion, MIN_GH_CLI_VERSION);
+    result.ghVersionOk = comparison >= 0;
+    if (!result.ghVersionOk) {
+      logger.debug(`GitHub CLI version ${result.ghVersion} is below minimum ${MIN_GH_CLI_VERSION}`);
+      result.errorLines.push(...getGhUpgradeInstructions(result.ghVersion));
+      return result;
+    }
+  }
+  try {
+    await execAsync7("gh auth status -h github.com", {
+      timeout: GH_COMMAND_TIMEOUT_MS,
+      env: { ...process.env, GH_NO_UPDATE_NOTIFIER: "1" }
+    });
+    result.ghAuthenticated = true;
+    logger.debug("GitHub CLI authenticated for github.com");
+  } catch (error) {
+    if (isTimeoutError(error)) {
+      logger.debug("GitHub CLI auth check timed out");
+      result.errorLines.push("✗ GitHub CLI auth check timed out");
+      result.errorLines.push("  This may indicate a network issue");
+      result.errorLines.push("  Try running: gh auth status -h github.com");
+    } else {
+      logger.debug(`GitHub CLI not authenticated: ${error instanceof Error ? error.message : "unknown error"}`);
+      result.errorLines.push("✗ GitHub CLI not authenticated");
+      result.errorLines.push("  Run: gh auth login -h github.com");
+    }
+    return result;
+  }
+  result.success = true;
+  logger.debug("All GitHub CLI pre-flight checks passed");
+  return result;
+}
+
 // src/domains/installation/fresh-installer.ts
 init_logger();
 import { join as join65 } from "node:path";
@@ -40378,10 +40520,25 @@ async function handleSelection(ctx) {
   const config = await ConfigManager.get();
   let accessibleKits;
   if (!ctx.options.useGit && !ctx.options.kitPath && !ctx.options.archive) {
+    const preflight = await runPreflightChecks();
+    if (!preflight.success) {
+      for (const line of preflight.errorLines) {
+        if (line.startsWith("✗")) {
+          logger.error(line);
+        } else {
+          logger.info(line);
+        }
+      }
+      logger.info("");
+      logger.info("Full diagnostics: ck doctor");
+      return { ...ctx, cancelled: true };
+    }
     accessibleKits = await detectAccessibleKits();
     if (accessibleKits.length === 0) {
-      logger.error("No ClaudeKit access found.");
-      logger.info("Purchase at https://claudekit.cc");
+      logger.error("No ClaudeKit repository access found.");
+      logger.info("Check email for GitHub invitation, or purchase at https://claudekit.cc");
+      logger.info("");
+      logger.info("Full diagnostics: ck doctor");
       return { ...ctx, cancelled: true };
     }
   }
@@ -42401,9 +42558,9 @@ ${import_picocolors22.default.yellow("User modifications will be permanently del
   }
 }
 // src/commands/update-cli.ts
-import { exec as exec7 } from "node:child_process";
+import { exec as exec8 } from "node:child_process";
 import { join as join75 } from "node:path";
-import { promisify as promisify7 } from "node:util";
+import { promisify as promisify8 } from "node:util";
 
 // src/domains/github/npm-registry.ts
 init_logger();
@@ -42549,7 +42706,7 @@ var import_fs_extra36 = __toESM(require_lib(), 1);
 // package.json
 var package_default = {
   name: "claudekit-cli",
-  version: "3.25.0",
+  version: "3.26.0",
   description: "CLI tool for bootstrapping and updating ClaudeKit projects",
   type: "module",
   repository: {
@@ -42640,7 +42797,7 @@ var package_default = {
 };
 
 // src/commands/update-cli.ts
-var execAsync7 = promisify7(exec7);
+var execAsync8 = promisify8(exec8);
 
 class CliUpdateError extends ClaudeKitError {
   constructor(message) {
@@ -42660,6 +42817,11 @@ function buildInitCommand(isGlobal, kit, beta) {
     parts.push("--beta");
   return parts.join(" ");
 }
+function isBetaVersion(version) {
+  if (!version)
+    return false;
+  return /-(beta|alpha|rc)[.\d]/i.test(version);
+}
 function selectKitForUpdate(params) {
   const { hasLocal, hasGlobal, localKits, globalKits } = params;
   const hasLocalKit = localKits.length > 0 || hasLocal;
@@ -42723,7 +42885,9 @@ async function promptKitUpdate(beta) {
       logger.verbose("No ClaudeKit installations detected, skipping kit update prompt");
       return;
     }
-    const initCmd = buildInitCommand(selection.isGlobal, selection.kit, beta);
+    const kitVersion = selection.kit ? selection.isGlobal ? globalMetadata?.kits?.[selection.kit]?.version : localMetadata?.kits?.[selection.kit]?.version : undefined;
+    const isBetaInstalled = isBetaVersion(kitVersion);
+    const initCmd = buildInitCommand(selection.isGlobal, selection.kit, beta || isBetaInstalled);
     const promptMessage = selection.promptMessage;
     logger.info("");
     const shouldUpdate = await se({
@@ -42737,7 +42901,7 @@ async function promptKitUpdate(beta) {
     const s = de();
     s.start("Updating ClaudeKit content...");
     try {
-      await execAsync7(initCmd, {
+      await execAsync8(initCmd, {
         timeout: 300000
       });
       s.stop("Kit content updated");
@@ -42827,7 +42991,7 @@ Run 'ck update' to install`, "Update Check");
     logger.info(`Running: ${updateCmd}`);
     s.start("Updating CLI...");
     try {
-      await execAsync7(updateCmd, {
+      await execAsync8(updateCmd, {
         timeout: 120000
       });
       s.stop("Update completed");
@@ -42845,7 +43009,7 @@ Manual update: ${updateCmd}`);
     }
     s.start("Verifying installation...");
     try {
-      const { stdout: stdout2 } = await execAsync7("ck --version", { timeout: 5000 });
+      const { stdout: stdout2 } = await execAsync8("ck --version", { timeout: 5000 });
       const newVersionMatch = stdout2.match(/CLI Version:\s*(\S+)/);
       const newVersion = newVersionMatch ? newVersionMatch[1] : targetVersion;
       s.stop(`Installed version: ${newVersion}`);
@@ -43020,7 +43184,7 @@ function registerCommands(cli) {
 }
 
 // src/cli/version-display.ts
-import { existsSync as existsSync20, readFileSync as readFileSync6 } from "node:fs";
+import { existsSync as existsSync20, readFileSync as readFileSync7 } from "node:fs";
 import { join as join77 } from "node:path";
 
 // src/domains/versioning/checking/version-utils.ts
@@ -43327,7 +43491,7 @@ async function displayVersion() {
   const isLocalSameAsGlobal = localMetadataPath === globalMetadataPath;
   if (!isLocalSameAsGlobal && existsSync20(localMetadataPath)) {
     try {
-      const rawMetadata = JSON.parse(readFileSync6(localMetadataPath, "utf-8"));
+      const rawMetadata = JSON.parse(readFileSync7(localMetadataPath, "utf-8"));
       const metadata = MetadataSchema.parse(rawMetadata);
       const kitsDisplay = formatInstalledKits(metadata);
       if (kitsDisplay) {
@@ -43341,7 +43505,7 @@ async function displayVersion() {
   }
   if (existsSync20(globalMetadataPath)) {
     try {
-      const rawMetadata = JSON.parse(readFileSync6(globalMetadataPath, "utf-8"));
+      const rawMetadata = JSON.parse(readFileSync7(globalMetadataPath, "utf-8"));
       const metadata = MetadataSchema.parse(rawMetadata);
       const kitsDisplay = formatInstalledKits(metadata);
       if (kitsDisplay) {

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "claudekit-cli",
-	"version": "3.25.0",
+	"version": "3.26.0",
 	"description": "CLI tool for bootstrapping and updating ClaudeKit projects",
 	"type": "module",
 	"repository": {