claudekit-cli 3.24.1 → 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)}`);
@@ -16529,22 +16529,22 @@ function padEnd(text, width) {
   const padding = Math.max(0, width - visibleLength);
   return text + " ".repeat(padding);
 }
-var import_picocolors28, NO_COLOR, isColorSupported, identity = (text) => text, colors, defaultTheme;
+var import_picocolors27, NO_COLOR, isColorSupported, identity = (text) => text, colors, defaultTheme;
 var init_help_colors = __esm(() => {
-  import_picocolors28 = __toESM(require_picocolors(), 1);
+  import_picocolors27 = __toESM(require_picocolors(), 1);
   NO_COLOR = process.env.NO_COLOR !== undefined;
   isColorSupported = !NO_COLOR && Boolean(process.stdout.isTTY);
   colors = {
-    banner: isColorSupported ? import_picocolors28.default.cyan : identity,
-    command: isColorSupported ? import_picocolors28.default.bold : identity,
-    heading: isColorSupported ? import_picocolors28.default.yellow : identity,
-    flag: isColorSupported ? import_picocolors28.default.green : identity,
-    description: isColorSupported ? import_picocolors28.default.gray : identity,
-    example: isColorSupported ? import_picocolors28.default.blue : identity,
-    warning: isColorSupported ? import_picocolors28.default.yellow : identity,
-    error: isColorSupported ? import_picocolors28.default.red : identity,
-    muted: isColorSupported ? import_picocolors28.default.dim : identity,
-    success: isColorSupported ? import_picocolors28.default.green : identity
+    banner: isColorSupported ? import_picocolors27.default.cyan : identity,
+    command: isColorSupported ? import_picocolors27.default.bold : identity,
+    heading: isColorSupported ? import_picocolors27.default.yellow : identity,
+    flag: isColorSupported ? import_picocolors27.default.green : identity,
+    description: isColorSupported ? import_picocolors27.default.gray : identity,
+    example: isColorSupported ? import_picocolors27.default.blue : identity,
+    warning: isColorSupported ? import_picocolors27.default.yellow : identity,
+    error: isColorSupported ? import_picocolors27.default.red : identity,
+    muted: isColorSupported ? import_picocolors27.default.dim : identity,
+    success: isColorSupported ? import_picocolors27.default.green : identity
   };
   defaultTheme = {
     banner: colors.banner,
@@ -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}`);
@@ -37841,12 +37884,12 @@ function buildCommandPatterns() {
   const patterns = [];
   for (const cmd of COMMAND_ROOTS) {
     patterns.push({
-      regex: new RegExp(`(?<![\\w:])(\\/)${cmd}(:)`, "g"),
-      replacement: "$1ck:$2".replace("$2", `${cmd}:`)
+      regex: new RegExp(`(?:^|(?<=[\\s\`]))(/)(${cmd})(:)(?!/)`, "gm"),
+      replacement: "$1ck:$2$3"
     });
     patterns.push({
-      regex: new RegExp(`(?<![\\w:])(\\/)${cmd}(?=[\\s\`"'\\)\\]}>.,;:!?]|$)`, "g"),
-      replacement: `$1ck:${cmd}`
+      regex: new RegExp(`(?:^|(?<=[\\s\`]))(/)(${cmd})(?![?/=&:\\w])(?=[\\s\`\\]\\)]|$)`, "gm"),
+      replacement: "$1ck:$2"
     });
   }
   return patterns;
@@ -37856,11 +37899,9 @@ function transformCommandContent(content) {
   let transformed = content;
   const patterns = buildCommandPatterns();
   for (const { regex: regex2, replacement } of patterns) {
-    regex2.lastIndex = 0;
     const matches = transformed.match(regex2);
     if (matches) {
       changes += matches.length;
-      regex2.lastIndex = 0;
       transformed = transformed.replace(regex2, replacement);
     }
   }
@@ -40316,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";
@@ -40379,11 +40519,26 @@ async function handleSelection(ctx) {
   }
   const config = await ConfigManager.get();
   let accessibleKits;
-  if (!ctx.options.useGit) {
+  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 };
     }
   }
@@ -41672,7 +41827,7 @@ async function directorySetup(validOptions, prompts) {
   const isNonInteractive2 = !process.stdin.isTTY || process.env.CI === "true" || process.env.NON_INTERACTIVE === "true";
   const config = await ConfigManager.get();
   let accessibleKits;
-  if (!validOptions.useGit) {
+  if (!validOptions.useGit && !validOptions.kitPath && !validOptions.archive) {
     accessibleKits = await detectAccessibleKits();
     if (accessibleKits.length === 0) {
       logger.error("No ClaudeKit access found.");
@@ -41811,6 +41966,22 @@ init_types2();
 // src/commands/new/phases/version-selection.ts
 init_logger();
 async function selectVersion2(kit, options, isNonInteractive2, prompts, github) {
+  if (options.kitPath || options.archive) {
+    const localVersion = options.release || "local";
+    return {
+      release: {
+        id: 0,
+        tag_name: localVersion,
+        name: localVersion,
+        draft: false,
+        prerelease: false,
+        tarball_url: "",
+        zipball_url: "",
+        assets: []
+      },
+      selectedVersion: localVersion
+    };
+  }
   let selectedVersion = options.release;
   if (!selectedVersion && isNonInteractive2) {
     throw new Error("Interactive version selection unavailable in non-interactive mode. " + "Either: (1) use --release <tag> flag, or (2) set CI=false to enable interactive mode");
@@ -42387,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 { join as join76 } from "node:path";
-import { promisify as promisify7 } from "node:util";
+import { exec as exec8 } from "node:child_process";
+import { join as join75 } from "node:path";
+import { promisify as promisify8 } from "node:util";
 
 // src/domains/github/npm-registry.ts
 init_logger();
@@ -42526,281 +42697,16 @@ class NpmRegistryClient {
   }
 }
 
-// src/domains/versioning/checking/version-utils.ts
-var import_compare_versions3 = __toESM(require_umd(), 1);
-function isUpdateCheckDisabled() {
-  return process.env.NO_UPDATE_NOTIFIER === "1" || process.env.NO_UPDATE_NOTIFIER === "true" || !process.stdout.isTTY;
-}
-function normalizeVersion(version) {
-  return version.replace(/^v/, "");
-}
-function isNewerVersion(currentVersion, latestVersion) {
-  try {
-    const current = normalizeVersion(currentVersion);
-    const latest = normalizeVersion(latestVersion);
-    return import_compare_versions3.compareVersions(latest, current) > 0;
-  } catch {
-    return false;
-  }
-}
-// src/domains/versioning/checking/kit-version-checker.ts
-init_logger();
-init_types2();
-
-// src/domains/versioning/version-cache.ts
-init_logger();
-import { existsSync as existsSync19 } from "node:fs";
-import { mkdir as mkdir22, readFile as readFile25, writeFile as writeFile22 } from "node:fs/promises";
-import { join as join75 } from "node:path";
-class VersionCacheManager {
-  static CACHE_FILENAME = "version-check.json";
-  static CACHE_TTL_MS = 7 * 24 * 60 * 60 * 1000;
-  static getCacheFile() {
-    const cacheDir = PathResolver.getCacheDir(false);
-    return join75(cacheDir, VersionCacheManager.CACHE_FILENAME);
-  }
-  static async load() {
-    const cacheFile = VersionCacheManager.getCacheFile();
-    try {
-      if (!existsSync19(cacheFile)) {
-        logger.debug("Version check cache not found");
-        return null;
-      }
-      const content = await readFile25(cacheFile, "utf-8");
-      const cache2 = JSON.parse(content);
-      if (!cache2.lastCheck || !cache2.currentVersion || !cache2.latestVersion) {
-        logger.debug("Invalid cache structure, ignoring");
-        return null;
-      }
-      logger.debug(`Version check cache loaded: ${JSON.stringify(cache2)}`);
-      return cache2;
-    } catch (error) {
-      logger.debug(`Failed to load version check cache: ${error}`);
-      return null;
-    }
-  }
-  static async save(cache2) {
-    const cacheFile = VersionCacheManager.getCacheFile();
-    const cacheDir = PathResolver.getCacheDir(false);
-    try {
-      if (!existsSync19(cacheDir)) {
-        await mkdir22(cacheDir, { recursive: true, mode: 448 });
-      }
-      await writeFile22(cacheFile, JSON.stringify(cache2, null, 2), "utf-8");
-      logger.debug(`Version check cache saved to ${cacheFile}`);
-    } catch (error) {
-      logger.debug(`Failed to save version check cache: ${error}`);
-    }
-  }
-  static isCacheValid(cache2) {
-    if (!cache2)
-      return false;
-    const now = Date.now();
-    const age = now - cache2.lastCheck;
-    const isValid2 = age < VersionCacheManager.CACHE_TTL_MS;
-    const ageDays = (age / 1000 / 60 / 60 / 24).toFixed(1);
-    logger.debug(`Cache validity check: age=${ageDays} days, valid=${isValid2}`);
-    return isValid2;
-  }
-  static async clear() {
-    const cacheFile = VersionCacheManager.getCacheFile();
-    try {
-      if (existsSync19(cacheFile)) {
-        const fs14 = await import("node:fs/promises");
-        await fs14.unlink(cacheFile);
-        logger.debug("Version check cache cleared");
-      }
-    } catch (error) {
-      logger.debug(`Failed to clear version check cache: ${error}`);
-    }
-  }
-}
-
-// src/domains/versioning/checking/kit-version-checker.ts
-async function fetchLatestRelease(currentVersion) {
-  try {
-    const githubClient = new GitHubClient;
-    const kit = AVAILABLE_KITS.engineer;
-    const timeoutPromise = new Promise((_3, reject) => setTimeout(() => reject(new Error("Timeout")), 5000));
-    const releasePromise = githubClient.getLatestRelease(kit);
-    const release = await Promise.race([releasePromise, timeoutPromise]);
-    const latestVersion = release.tag_name;
-    const updateAvailable = isNewerVersion(currentVersion, latestVersion);
-    const releaseUrl = `https://github.com/${kit.owner}/${kit.repo}/releases/tag/${latestVersion}`;
-    logger.debug(`Fetched latest release: current=${currentVersion}, latest=${latestVersion}, updateAvailable=${updateAvailable}`);
-    return {
-      currentVersion,
-      latestVersion,
-      updateAvailable,
-      releaseUrl
-    };
-  } catch (error) {
-    logger.debug(`Failed to fetch latest release: ${error}`);
-    return null;
-  }
-}
-
-class VersionChecker {
-  static async check(currentVersion) {
-    if (isUpdateCheckDisabled()) {
-      logger.debug("Update check disabled by environment");
-      return null;
-    }
-    const cache2 = await VersionCacheManager.load();
-    if (cache2 && VersionCacheManager.isCacheValid(cache2) && cache2.currentVersion === currentVersion) {
-      logger.debug("Using cached version check result");
-      return {
-        currentVersion: cache2.currentVersion,
-        latestVersion: cache2.latestVersion,
-        updateAvailable: cache2.updateAvailable,
-        releaseUrl: cache2.latestUrl
-      };
-    }
-    logger.debug("Cache expired or invalid, fetching latest release");
-    const result = await fetchLatestRelease(currentVersion);
-    if (result) {
-      await VersionCacheManager.save({
-        lastCheck: Date.now(),
-        currentVersion: result.currentVersion,
-        latestVersion: result.latestVersion,
-        latestUrl: result.releaseUrl,
-        updateAvailable: result.updateAvailable
-      });
-    }
-    return result;
-  }
-}
-// src/domains/versioning/checking/cli-version-checker.ts
-init_logger();
-var import_compare_versions4 = __toESM(require_umd(), 1);
-var PACKAGE_NAME = "claudekit-cli";
-
-class CliVersionChecker {
-  static async check(currentVersion) {
-    if (isUpdateCheckDisabled()) {
-      logger.debug("CLI update check disabled by environment");
-      return null;
-    }
-    try {
-      const latestVersion = await NpmRegistryClient.getLatestVersion(PACKAGE_NAME);
-      if (!latestVersion) {
-        logger.debug("Failed to fetch latest CLI version from npm");
-        return null;
-      }
-      const current = normalizeVersion(currentVersion);
-      const latest = normalizeVersion(latestVersion);
-      const updateAvailable = import_compare_versions4.compareVersions(latest, current) > 0;
-      logger.debug(`CLI version check: current=${current}, latest=${latest}, updateAvailable=${updateAvailable}`);
-      return {
-        currentVersion: current,
-        latestVersion: latest,
-        updateAvailable,
-        releaseUrl: `https://www.npmjs.com/package/${PACKAGE_NAME}`
-      };
-    } catch (error) {
-      logger.debug(`CLI version check failed: ${error}`);
-      return null;
-    }
-  }
-}
-// src/domains/versioning/checking/notification-display.ts
-var import_picocolors23 = __toESM(require_picocolors(), 1);
-function createNotificationBox2(borderColor, boxWidth) {
-  const contentWidth = boxWidth - 2;
-  const topBorder = borderColor(`╭${"─".repeat(contentWidth)}╮`);
-  const bottomBorder = borderColor(`╰${"─".repeat(contentWidth)}╯`);
-  const emptyLine = borderColor("│") + " ".repeat(contentWidth) + borderColor("│");
-  const padLine = (text, visibleLen) => {
-    const len = visibleLen ?? text.length;
-    const displayText = len > contentWidth ? `${text.slice(0, contentWidth - 3)}...` : text;
-    const actualLen = visibleLen ?? displayText.length;
-    const totalPadding = contentWidth - actualLen;
-    const leftPadding = Math.max(0, Math.floor(totalPadding / 2));
-    const rightPadding = Math.max(0, totalPadding - leftPadding);
-    return borderColor("│") + " ".repeat(leftPadding) + displayText + " ".repeat(rightPadding) + borderColor("│");
-  };
-  return { topBorder, bottomBorder, emptyLine, padLine };
-}
-function displayKitNotification(result, options = {}) {
-  if (!result.updateAvailable)
-    return;
-  const { currentVersion, latestVersion } = result;
-  const { isGlobal = false } = options;
-  const displayCurrent = normalizeVersion(currentVersion);
-  const displayLatest = normalizeVersion(latestVersion);
-  const boxWidth = 52;
-  const { topBorder, bottomBorder, emptyLine, padLine } = createNotificationBox2(import_picocolors23.default.cyan, boxWidth);
-  const headerText = import_picocolors23.default.bold(import_picocolors23.default.yellow("⬆ Kit Update Available"));
-  const headerLen = "⬆ Kit Update Available".length;
-  const versionText = `${import_picocolors23.default.dim(displayCurrent)} ${import_picocolors23.default.white("→")} ${import_picocolors23.default.green(import_picocolors23.default.bold(displayLatest))}`;
-  const versionLen = displayCurrent.length + 3 + displayLatest.length;
-  const updateCmd = isGlobal ? "ck init -g" : "ck init";
-  const commandText = `Run: ${import_picocolors23.default.cyan(import_picocolors23.default.bold(updateCmd))}`;
-  const commandLen = `Run: ${updateCmd}`.length;
-  console.log("");
-  console.log(topBorder);
-  console.log(emptyLine);
-  console.log(padLine(headerText, headerLen));
-  console.log(padLine(versionText, versionLen));
-  console.log(emptyLine);
-  console.log(padLine(commandText, commandLen));
-  console.log(emptyLine);
-  console.log(bottomBorder);
-  console.log("");
-}
-function displayCliNotification(result) {
-  if (!result.updateAvailable)
-    return;
-  const { currentVersion, latestVersion } = result;
-  const boxWidth = 52;
-  const { topBorder, bottomBorder, emptyLine, padLine } = createNotificationBox2(import_picocolors23.default.magenta, boxWidth);
-  const headerText = import_picocolors23.default.bold(import_picocolors23.default.yellow("⬆ CLI Update Available"));
-  const headerLen = "⬆ CLI Update Available".length;
-  const versionText = `${import_picocolors23.default.dim(currentVersion)} ${import_picocolors23.default.white("→")} ${import_picocolors23.default.green(import_picocolors23.default.bold(latestVersion))}`;
-  const versionLen = currentVersion.length + 3 + latestVersion.length;
-  const commandText = `Run: ${import_picocolors23.default.magenta(import_picocolors23.default.bold("ck update"))}`;
-  const commandLen = "Run: ck update".length;
-  console.log("");
-  console.log(topBorder);
-  console.log(emptyLine);
-  console.log(padLine(headerText, headerLen));
-  console.log(padLine(versionText, versionLen));
-  console.log(emptyLine);
-  console.log(padLine(commandText, commandLen));
-  console.log(emptyLine);
-  console.log(bottomBorder);
-  console.log("");
-}
-// src/domains/versioning/version-checker.ts
-class VersionChecker2 {
-  static async check(currentVersion) {
-    return VersionChecker.check(currentVersion);
-  }
-  static displayNotification(result, options = {}) {
-    displayKitNotification(result, options);
-  }
-}
-
-class CliVersionChecker2 {
-  static async check(currentVersion) {
-    return CliVersionChecker.check(currentVersion);
-  }
-  static displayNotification(result) {
-    displayCliNotification(result);
-  }
-}
-
 // src/commands/update-cli.ts
 init_logger();
 init_types2();
 init_types2();
-var import_compare_versions5 = __toESM(require_umd(), 1);
+var import_compare_versions3 = __toESM(require_umd(), 1);
 var import_fs_extra36 = __toESM(require_lib(), 1);
-var import_picocolors24 = __toESM(require_picocolors(), 1);
 // package.json
 var package_default = {
   name: "claudekit-cli",
-  version: "3.24.1",
+  version: "3.26.0",
   description: "CLI tool for bootstrapping and updating ClaudeKit projects",
   type: "module",
   repository: {
@@ -42891,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) {
@@ -42899,8 +42805,7 @@ class CliUpdateError extends ClaudeKitError {
     this.name = "CliUpdateError";
   }
 }
-var PACKAGE_NAME2 = "claudekit-cli";
-var KIT_UPDATE_REMINDER_HEADER = "Note: 'ck update' only updates the CLI tool itself.";
+var PACKAGE_NAME = "claudekit-cli";
 function buildInitCommand(isGlobal, kit, beta) {
   const parts = ["ck init"];
   if (isGlobal)
@@ -42912,19 +42817,61 @@ 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;
+  const hasGlobalKit = globalKits.length > 0 || hasGlobal;
+  if (!hasLocalKit && !hasGlobalKit) {
+    return null;
+  }
+  if (hasGlobalKit && !hasLocalKit) {
+    const kit2 = globalKits[0] || localKits[0];
+    return {
+      isGlobal: true,
+      kit: kit2,
+      promptMessage: `Update global ClaudeKit content${kit2 ? ` (${kit2})` : ""}?`
+    };
+  }
+  if (hasLocalKit && !hasGlobalKit) {
+    const kit2 = localKits[0] || globalKits[0];
+    return {
+      isGlobal: false,
+      kit: kit2,
+      promptMessage: `Update local project ClaudeKit content${kit2 ? ` (${kit2})` : ""}?`
+    };
+  }
+  const kit = globalKits[0] || localKits[0];
+  return {
+    isGlobal: true,
+    kit,
+    promptMessage: `Update global ClaudeKit content${kit ? ` (${kit})` : ""}?`
+  };
+}
 async function readMetadataFile(claudeDir) {
-  const metadataPath = join76(claudeDir, "metadata.json");
+  const metadataPath = join75(claudeDir, "metadata.json");
   try {
     if (!await import_fs_extra36.pathExists(metadataPath)) {
       return null;
     }
     const content = await import_fs_extra36.readFile(metadataPath, "utf-8");
-    return JSON.parse(content);
-  } catch {
+    const parsed = JSON.parse(content);
+    const validated = MetadataSchema.safeParse(parsed);
+    if (!validated.success) {
+      logger.verbose(`Invalid metadata format: ${validated.error.message}`);
+      return null;
+    }
+    return validated.data;
+  } catch (error) {
+    logger.verbose(`Failed to read metadata: ${error instanceof Error ? error.message : "unknown"}`);
     return null;
   }
 }
-async function displayKitUpdateReminder(beta) {
+async function promptKitUpdate(beta) {
   try {
     const setup = await getClaudeKitSetup();
     const hasLocal = !!setup.project.metadata;
@@ -42933,93 +42880,43 @@ async function displayKitUpdateReminder(beta) {
     const globalMetadata = hasGlobal ? await readMetadataFile(setup.global.path) : null;
     const localKits = localMetadata ? getInstalledKits(localMetadata) : [];
     const globalKits = globalMetadata ? getInstalledKits(globalMetadata) : [];
-    const versionsToCheck = new Set;
-    if (localMetadata) {
-      for (const kit of localKits) {
-        const version = localMetadata.kits?.[kit]?.version || localMetadata.version;
-        if (version)
-          versionsToCheck.add(version);
-      }
-    }
-    if (globalMetadata) {
-      for (const kit of globalKits) {
-        const version = globalMetadata.kits?.[kit]?.version || globalMetadata.version;
-        if (version)
-          versionsToCheck.add(version);
-      }
-    }
-    const versionCheckResults = new Map;
-    if (versionsToCheck.size > 0) {
-      const checkPromises = [...versionsToCheck].map(async (version) => {
-        const result = await VersionChecker2.check(version).catch(() => null);
-        return { version, result };
-      });
-      const results = await Promise.all(checkPromises);
-      for (const { version, result } of results) {
-        versionCheckResults.set(version, result);
-      }
-    }
-    const commands = [];
-    if (localKits.length > 0) {
-      for (const kit of localKits) {
-        const cmd = buildInitCommand(false, kit, beta);
-        const version = localMetadata?.kits?.[kit]?.version || localMetadata?.version;
-        commands.push({
-          cmd,
-          desc: `Update local project (${kit}${version ? `@${version}` : ""})`,
-          version
-        });
-      }
-    } else if (hasLocal) {
-      commands.push({ cmd: beta ? "ck init --beta" : "ck init", desc: "Update local project" });
-    } else {
-      commands.push({
-        cmd: beta ? "ck init --beta" : "ck init",
-        desc: "Initialize in current project"
-      });
+    const selection = selectKitForUpdate({ hasLocal, hasGlobal, localKits, globalKits });
+    if (!selection) {
+      logger.verbose("No ClaudeKit installations detected, skipping kit update prompt");
+      return;
     }
-    if (globalKits.length > 0) {
-      for (const kit of globalKits) {
-        const cmd = buildInitCommand(true, kit, beta);
-        const version = globalMetadata?.kits?.[kit]?.version || globalMetadata?.version;
-        commands.push({
-          cmd,
-          desc: `Update global ~/.claude (${kit}${version ? `@${version}` : ""})`,
-          version
-        });
-      }
-    } else if (hasGlobal) {
-      commands.push({
-        cmd: beta ? "ck init -g --beta" : "ck init -g",
-        desc: "Update global ~/.claude"
-      });
-    } else {
-      commands.push({
-        cmd: beta ? "ck init -g --beta" : "ck init -g",
-        desc: "Initialize global ~/.claude"
-      });
+    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({
+      message: promptMessage
+    });
+    if (lD(shouldUpdate) || !shouldUpdate) {
+      log.info("Skipped kit content update");
+      return;
     }
-    const maxCmdLen = Math.max(...commands.map((c2) => c2.cmd.length));
-    const pad = (cmd) => cmd.padEnd(maxCmdLen);
-    const lines = [];
-    lines.push(import_picocolors24.default.yellow(KIT_UPDATE_REMINDER_HEADER));
-    lines.push("");
-    lines.push("To update your ClaudeKit content (skills, commands, workflows):");
-    for (const { cmd, desc: desc2, version } of commands) {
-      lines.push(`  ${import_picocolors24.default.cyan(pad(cmd))}  ${desc2}`);
-      if (version) {
-        const versionCheck = versionCheckResults.get(version);
-        if (versionCheck?.updateAvailable) {
-          const indent = " ".repeat(maxCmdLen + 4);
-          lines.push(`${indent}${import_picocolors24.default.green(`→ ${versionCheck.latestVersion} available!`)}`);
-        }
+    logger.info(`Running: ${initCmd}`);
+    const s = de();
+    s.start("Updating ClaudeKit content...");
+    try {
+      await execAsync8(initCmd, {
+        timeout: 300000
+      });
+      s.stop("Kit content updated");
+    } catch (error) {
+      s.stop("Kit update finished");
+      const errorMsg = error instanceof Error ? error.message : "unknown";
+      if (errorMsg.includes("exit code") && !errorMsg.includes("exit code 0")) {
+        logger.warning("Kit content update may have encountered issues");
+        logger.verbose(`Error: ${errorMsg}`);
+      } else {
+        logger.verbose(`Init command completed: ${errorMsg}`);
       }
     }
-    logger.info("");
-    log.info(lines.join(`
-`));
   } catch (error) {
-    logger.verbose(`Failed to display kit update reminder: ${error instanceof Error ? error.message : "unknown error"}`);
+    logger.verbose(`Failed to prompt for kit update: ${error instanceof Error ? error.message : "unknown error"}`);
   }
 }
 async function updateCliCommand(options) {
@@ -43037,7 +42934,7 @@ async function updateCliCommand(options) {
     s.start("Checking for updates...");
     let targetVersion = null;
     if (opts.release && opts.release !== "latest") {
-      const exists = await NpmRegistryClient.versionExists(PACKAGE_NAME2, opts.release, opts.registry);
+      const exists = await NpmRegistryClient.versionExists(PACKAGE_NAME, opts.release, opts.registry);
       if (!exists) {
         s.stop("Version not found");
         throw new CliUpdateError(`Version ${opts.release} does not exist on npm registry. Run 'ck versions' to see available versions.`);
@@ -43045,25 +42942,25 @@ async function updateCliCommand(options) {
       targetVersion = opts.release;
       s.stop(`Target version: ${targetVersion}`);
     } else if (opts.beta) {
-      targetVersion = await NpmRegistryClient.getBetaVersion(PACKAGE_NAME2, opts.registry);
+      targetVersion = await NpmRegistryClient.getBetaVersion(PACKAGE_NAME, opts.registry);
       if (!targetVersion) {
         s.stop("No beta version available");
         logger.warning("No beta version found. Using latest stable version instead.");
-        targetVersion = await NpmRegistryClient.getLatestVersion(PACKAGE_NAME2, opts.registry);
+        targetVersion = await NpmRegistryClient.getLatestVersion(PACKAGE_NAME, opts.registry);
       } else {
         s.stop(`Latest beta version: ${targetVersion}`);
       }
     } else {
-      targetVersion = await NpmRegistryClient.getLatestVersion(PACKAGE_NAME2, opts.registry);
+      targetVersion = await NpmRegistryClient.getLatestVersion(PACKAGE_NAME, opts.registry);
       s.stop(`Latest version: ${targetVersion || "unknown"}`);
     }
     if (!targetVersion) {
-      throw new CliUpdateError(`Failed to fetch version information from npm registry. Check your internet connection and try again. Manual update: ${PackageManagerDetector.getUpdateCommand(pm, PACKAGE_NAME2)}`);
+      throw new CliUpdateError(`Failed to fetch version information from npm registry. Check your internet connection and try again. Manual update: ${PackageManagerDetector.getUpdateCommand(pm, PACKAGE_NAME)}`);
     }
-    const comparison = import_compare_versions5.compareVersions(currentVersion, targetVersion);
+    const comparison = import_compare_versions3.compareVersions(currentVersion, targetVersion);
     if (comparison === 0) {
       outro(`[+] Already on the latest CLI version (${currentVersion})`);
-      await displayKitUpdateReminder(opts.beta);
+      await promptKitUpdate(opts.beta);
       return;
     }
     if (comparison > 0 && !opts.release) {
@@ -43077,7 +42974,7 @@ async function updateCliCommand(options) {
       note(`CLI update available: ${currentVersion} -> ${targetVersion}
 
 Run 'ck update' to install`, "Update Check");
-      await displayKitUpdateReminder(opts.beta);
+      await promptKitUpdate(opts.beta);
       outro("Check complete");
       return;
     }
@@ -43090,11 +42987,11 @@ Run 'ck update' to install`, "Update Check");
         return;
       }
     }
-    const updateCmd = PackageManagerDetector.getUpdateCommand(pm, PACKAGE_NAME2, targetVersion);
+    const updateCmd = PackageManagerDetector.getUpdateCommand(pm, PACKAGE_NAME, targetVersion);
     logger.info(`Running: ${updateCmd}`);
     s.start("Updating CLI...");
     try {
-      await execAsync7(updateCmd, {
+      await execAsync8(updateCmd, {
         timeout: 120000
       });
       s.stop("Update completed");
@@ -43112,16 +43009,16 @@ 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}`);
       outro(`[+] Successfully updated ClaudeKit CLI to ${newVersion}`);
-      await displayKitUpdateReminder(opts.beta);
+      await promptKitUpdate(opts.beta);
     } catch {
       s.stop("Verification completed");
       outro(`[+] Update completed. Please restart your terminal to use CLI ${targetVersion}`);
-      await displayKitUpdateReminder(opts.beta);
+      await promptKitUpdate(opts.beta);
     }
   } catch (error) {
     if (error instanceof CliUpdateError) {
@@ -43137,7 +43034,7 @@ Manual update: ${updateCmd}`);
 // src/commands/version.ts
 init_logger();
 init_types2();
-var import_picocolors25 = __toESM(require_picocolors(), 1);
+var import_picocolors23 = __toESM(require_picocolors(), 1);
 function formatRelativeTime(dateString) {
   if (!dateString)
     return "Unknown";
@@ -43159,30 +43056,30 @@ function formatRelativeTime(dateString) {
 }
 function displayKitReleases(kitName, releases) {
   console.log(`
-${import_picocolors25.default.bold(import_picocolors25.default.cyan(kitName))} - Available Versions:
+${import_picocolors23.default.bold(import_picocolors23.default.cyan(kitName))} - Available Versions:
 `);
   if (releases.length === 0) {
-    console.log(import_picocolors25.default.dim("  No releases found"));
+    console.log(import_picocolors23.default.dim("  No releases found"));
     return;
   }
   for (const release of releases) {
-    const version = import_picocolors25.default.green(release.tag_name);
+    const version = import_picocolors23.default.green(release.tag_name);
     const name2 = release.name || "No title";
     const publishedAt = formatRelativeTime(release.published_at);
     const assetCount = release.assets.length;
     const badges = [];
     if (release.prerelease)
-      badges.push(import_picocolors25.default.yellow("[prerelease]"));
+      badges.push(import_picocolors23.default.yellow("[prerelease]"));
     if (release.draft)
-      badges.push(import_picocolors25.default.gray("[draft]"));
+      badges.push(import_picocolors23.default.gray("[draft]"));
     const badgeStr = badges.length > 0 ? ` ${badges.join(" ")}` : "";
     const versionPart = version.padEnd(20);
     const namePart = name2.length > 40 ? `${name2.slice(0, 37)}...` : name2.padEnd(40);
-    const timePart = import_picocolors25.default.dim(publishedAt.padEnd(20));
-    const assetPart = import_picocolors25.default.dim(`(${assetCount} ${assetCount === 1 ? "asset" : "assets"})`);
+    const timePart = import_picocolors23.default.dim(publishedAt.padEnd(20));
+    const assetPart = import_picocolors23.default.dim(`(${assetCount} ${assetCount === 1 ? "asset" : "assets"})`);
     console.log(`  ${versionPart}  ${namePart}  ${timePart}  ${assetPart}${badgeStr}`);
   }
-  console.log(import_picocolors25.default.dim(`
+  console.log(import_picocolors23.default.dim(`
 Showing ${releases.length} ${releases.length === 1 ? "release" : "releases"}`));
 }
 async function versionCommand(options) {
@@ -43217,8 +43114,8 @@ async function versionCommand(options) {
     for (const result of results) {
       if (result.error) {
         console.log(`
-${import_picocolors25.default.bold(import_picocolors25.default.cyan(result.kitConfig.name))} - ${import_picocolors25.default.red("Error")}`);
-        console.log(import_picocolors25.default.dim(`  ${result.error}`));
+${import_picocolors23.default.bold(import_picocolors23.default.cyan(result.kitConfig.name))} - ${import_picocolors23.default.red("Error")}`);
+        console.log(import_picocolors23.default.dim(`  ${result.error}`));
       } else {
         displayKitReleases(result.kitConfig.name, result.releases);
       }
@@ -43287,8 +43184,274 @@ 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
+var import_compare_versions4 = __toESM(require_umd(), 1);
+function isUpdateCheckDisabled() {
+  return process.env.NO_UPDATE_NOTIFIER === "1" || process.env.NO_UPDATE_NOTIFIER === "true" || !process.stdout.isTTY;
+}
+function normalizeVersion(version) {
+  return version.replace(/^v/, "");
+}
+function isNewerVersion(currentVersion, latestVersion) {
+  try {
+    const current = normalizeVersion(currentVersion);
+    const latest = normalizeVersion(latestVersion);
+    return import_compare_versions4.compareVersions(latest, current) > 0;
+  } catch {
+    return false;
+  }
+}
+// src/domains/versioning/checking/kit-version-checker.ts
+init_logger();
+init_types2();
+
+// src/domains/versioning/version-cache.ts
+init_logger();
+import { existsSync as existsSync19 } from "node:fs";
+import { mkdir as mkdir22, readFile as readFile26, writeFile as writeFile22 } from "node:fs/promises";
+import { join as join76 } from "node:path";
+class VersionCacheManager {
+  static CACHE_FILENAME = "version-check.json";
+  static CACHE_TTL_MS = 7 * 24 * 60 * 60 * 1000;
+  static getCacheFile() {
+    const cacheDir = PathResolver.getCacheDir(false);
+    return join76(cacheDir, VersionCacheManager.CACHE_FILENAME);
+  }
+  static async load() {
+    const cacheFile = VersionCacheManager.getCacheFile();
+    try {
+      if (!existsSync19(cacheFile)) {
+        logger.debug("Version check cache not found");
+        return null;
+      }
+      const content = await readFile26(cacheFile, "utf-8");
+      const cache2 = JSON.parse(content);
+      if (!cache2.lastCheck || !cache2.currentVersion || !cache2.latestVersion) {
+        logger.debug("Invalid cache structure, ignoring");
+        return null;
+      }
+      logger.debug(`Version check cache loaded: ${JSON.stringify(cache2)}`);
+      return cache2;
+    } catch (error) {
+      logger.debug(`Failed to load version check cache: ${error}`);
+      return null;
+    }
+  }
+  static async save(cache2) {
+    const cacheFile = VersionCacheManager.getCacheFile();
+    const cacheDir = PathResolver.getCacheDir(false);
+    try {
+      if (!existsSync19(cacheDir)) {
+        await mkdir22(cacheDir, { recursive: true, mode: 448 });
+      }
+      await writeFile22(cacheFile, JSON.stringify(cache2, null, 2), "utf-8");
+      logger.debug(`Version check cache saved to ${cacheFile}`);
+    } catch (error) {
+      logger.debug(`Failed to save version check cache: ${error}`);
+    }
+  }
+  static isCacheValid(cache2) {
+    if (!cache2)
+      return false;
+    const now = Date.now();
+    const age = now - cache2.lastCheck;
+    const isValid2 = age < VersionCacheManager.CACHE_TTL_MS;
+    const ageDays = (age / 1000 / 60 / 60 / 24).toFixed(1);
+    logger.debug(`Cache validity check: age=${ageDays} days, valid=${isValid2}`);
+    return isValid2;
+  }
+  static async clear() {
+    const cacheFile = VersionCacheManager.getCacheFile();
+    try {
+      if (existsSync19(cacheFile)) {
+        const fs14 = await import("node:fs/promises");
+        await fs14.unlink(cacheFile);
+        logger.debug("Version check cache cleared");
+      }
+    } catch (error) {
+      logger.debug(`Failed to clear version check cache: ${error}`);
+    }
+  }
+}
+
+// src/domains/versioning/checking/kit-version-checker.ts
+async function fetchLatestRelease(currentVersion) {
+  try {
+    const githubClient = new GitHubClient;
+    const kit = AVAILABLE_KITS.engineer;
+    const timeoutPromise = new Promise((_3, reject) => setTimeout(() => reject(new Error("Timeout")), 5000));
+    const releasePromise = githubClient.getLatestRelease(kit);
+    const release = await Promise.race([releasePromise, timeoutPromise]);
+    const latestVersion = release.tag_name;
+    const updateAvailable = isNewerVersion(currentVersion, latestVersion);
+    const releaseUrl = `https://github.com/${kit.owner}/${kit.repo}/releases/tag/${latestVersion}`;
+    logger.debug(`Fetched latest release: current=${currentVersion}, latest=${latestVersion}, updateAvailable=${updateAvailable}`);
+    return {
+      currentVersion,
+      latestVersion,
+      updateAvailable,
+      releaseUrl
+    };
+  } catch (error) {
+    logger.debug(`Failed to fetch latest release: ${error}`);
+    return null;
+  }
+}
+
+class VersionChecker {
+  static async check(currentVersion) {
+    if (isUpdateCheckDisabled()) {
+      logger.debug("Update check disabled by environment");
+      return null;
+    }
+    const cache2 = await VersionCacheManager.load();
+    if (cache2 && VersionCacheManager.isCacheValid(cache2) && cache2.currentVersion === currentVersion) {
+      logger.debug("Using cached version check result");
+      return {
+        currentVersion: cache2.currentVersion,
+        latestVersion: cache2.latestVersion,
+        updateAvailable: cache2.updateAvailable,
+        releaseUrl: cache2.latestUrl
+      };
+    }
+    logger.debug("Cache expired or invalid, fetching latest release");
+    const result = await fetchLatestRelease(currentVersion);
+    if (result) {
+      await VersionCacheManager.save({
+        lastCheck: Date.now(),
+        currentVersion: result.currentVersion,
+        latestVersion: result.latestVersion,
+        latestUrl: result.releaseUrl,
+        updateAvailable: result.updateAvailable
+      });
+    }
+    return result;
+  }
+}
+// src/domains/versioning/checking/cli-version-checker.ts
+init_logger();
+var import_compare_versions5 = __toESM(require_umd(), 1);
+var PACKAGE_NAME2 = "claudekit-cli";
+
+class CliVersionChecker {
+  static async check(currentVersion) {
+    if (isUpdateCheckDisabled()) {
+      logger.debug("CLI update check disabled by environment");
+      return null;
+    }
+    try {
+      const latestVersion = await NpmRegistryClient.getLatestVersion(PACKAGE_NAME2);
+      if (!latestVersion) {
+        logger.debug("Failed to fetch latest CLI version from npm");
+        return null;
+      }
+      const current = normalizeVersion(currentVersion);
+      const latest = normalizeVersion(latestVersion);
+      const updateAvailable = import_compare_versions5.compareVersions(latest, current) > 0;
+      logger.debug(`CLI version check: current=${current}, latest=${latest}, updateAvailable=${updateAvailable}`);
+      return {
+        currentVersion: current,
+        latestVersion: latest,
+        updateAvailable,
+        releaseUrl: `https://www.npmjs.com/package/${PACKAGE_NAME2}`
+      };
+    } catch (error) {
+      logger.debug(`CLI version check failed: ${error}`);
+      return null;
+    }
+  }
+}
+// src/domains/versioning/checking/notification-display.ts
+var import_picocolors24 = __toESM(require_picocolors(), 1);
+function createNotificationBox2(borderColor, boxWidth) {
+  const contentWidth = boxWidth - 2;
+  const topBorder = borderColor(`╭${"─".repeat(contentWidth)}╮`);
+  const bottomBorder = borderColor(`╰${"─".repeat(contentWidth)}╯`);
+  const emptyLine = borderColor("│") + " ".repeat(contentWidth) + borderColor("│");
+  const padLine = (text, visibleLen) => {
+    const len = visibleLen ?? text.length;
+    const displayText = len > contentWidth ? `${text.slice(0, contentWidth - 3)}...` : text;
+    const actualLen = visibleLen ?? displayText.length;
+    const totalPadding = contentWidth - actualLen;
+    const leftPadding = Math.max(0, Math.floor(totalPadding / 2));
+    const rightPadding = Math.max(0, totalPadding - leftPadding);
+    return borderColor("│") + " ".repeat(leftPadding) + displayText + " ".repeat(rightPadding) + borderColor("│");
+  };
+  return { topBorder, bottomBorder, emptyLine, padLine };
+}
+function displayKitNotification(result, options = {}) {
+  if (!result.updateAvailable)
+    return;
+  const { currentVersion, latestVersion } = result;
+  const { isGlobal = false } = options;
+  const displayCurrent = normalizeVersion(currentVersion);
+  const displayLatest = normalizeVersion(latestVersion);
+  const boxWidth = 52;
+  const { topBorder, bottomBorder, emptyLine, padLine } = createNotificationBox2(import_picocolors24.default.cyan, boxWidth);
+  const headerText = import_picocolors24.default.bold(import_picocolors24.default.yellow("⬆ Kit Update Available"));
+  const headerLen = "⬆ Kit Update Available".length;
+  const versionText = `${import_picocolors24.default.dim(displayCurrent)} ${import_picocolors24.default.white("→")} ${import_picocolors24.default.green(import_picocolors24.default.bold(displayLatest))}`;
+  const versionLen = displayCurrent.length + 3 + displayLatest.length;
+  const updateCmd = isGlobal ? "ck init -g" : "ck init";
+  const commandText = `Run: ${import_picocolors24.default.cyan(import_picocolors24.default.bold(updateCmd))}`;
+  const commandLen = `Run: ${updateCmd}`.length;
+  console.log("");
+  console.log(topBorder);
+  console.log(emptyLine);
+  console.log(padLine(headerText, headerLen));
+  console.log(padLine(versionText, versionLen));
+  console.log(emptyLine);
+  console.log(padLine(commandText, commandLen));
+  console.log(emptyLine);
+  console.log(bottomBorder);
+  console.log("");
+}
+function displayCliNotification(result) {
+  if (!result.updateAvailable)
+    return;
+  const { currentVersion, latestVersion } = result;
+  const boxWidth = 52;
+  const { topBorder, bottomBorder, emptyLine, padLine } = createNotificationBox2(import_picocolors24.default.magenta, boxWidth);
+  const headerText = import_picocolors24.default.bold(import_picocolors24.default.yellow("⬆ CLI Update Available"));
+  const headerLen = "⬆ CLI Update Available".length;
+  const versionText = `${import_picocolors24.default.dim(currentVersion)} ${import_picocolors24.default.white("→")} ${import_picocolors24.default.green(import_picocolors24.default.bold(latestVersion))}`;
+  const versionLen = currentVersion.length + 3 + latestVersion.length;
+  const commandText = `Run: ${import_picocolors24.default.magenta(import_picocolors24.default.bold("ck update"))}`;
+  const commandLen = "Run: ck update".length;
+  console.log("");
+  console.log(topBorder);
+  console.log(emptyLine);
+  console.log(padLine(headerText, headerLen));
+  console.log(padLine(versionText, versionLen));
+  console.log(emptyLine);
+  console.log(padLine(commandText, commandLen));
+  console.log(emptyLine);
+  console.log(bottomBorder);
+  console.log("");
+}
+// src/domains/versioning/version-checker.ts
+class VersionChecker2 {
+  static async check(currentVersion) {
+    return VersionChecker.check(currentVersion);
+  }
+  static displayNotification(result, options = {}) {
+    displayKitNotification(result, options);
+  }
+}
+
+class CliVersionChecker2 {
+  static async check(currentVersion) {
+    return CliVersionChecker.check(currentVersion);
+  }
+  static displayNotification(result) {
+    displayCliNotification(result);
+  }
+}
+
+// src/cli/version-display.ts
 init_logger();
 init_types2();
 var packageVersion = package_default.version;
@@ -43328,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) {
@@ -43342,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) {
@@ -43387,7 +43550,7 @@ function getPackageVersion2() {
 
 // src/shared/logger.ts
 init_output_manager();
-var import_picocolors26 = __toESM(require_picocolors(), 1);
+var import_picocolors25 = __toESM(require_picocolors(), 1);
 import { createWriteStream as createWriteStream3 } from "node:fs";
 
 class Logger2 {
@@ -43396,23 +43559,23 @@ class Logger2 {
   exitHandlerRegistered = false;
   info(message) {
     const symbols = output.getSymbols();
-    console.log(import_picocolors26.default.blue(symbols.info), message);
+    console.log(import_picocolors25.default.blue(symbols.info), message);
   }
   success(message) {
     const symbols = output.getSymbols();
-    console.log(import_picocolors26.default.green(symbols.success), message);
+    console.log(import_picocolors25.default.green(symbols.success), message);
   }
   warning(message) {
     const symbols = output.getSymbols();
-    console.log(import_picocolors26.default.yellow(symbols.warning), message);
+    console.log(import_picocolors25.default.yellow(symbols.warning), message);
   }
   error(message) {
     const symbols = output.getSymbols();
-    console.error(import_picocolors26.default.red(symbols.error), message);
+    console.error(import_picocolors25.default.red(symbols.error), message);
   }
   debug(message) {
     if (process.env.DEBUG) {
-      console.log(import_picocolors26.default.gray("[DEBUG]"), message);
+      console.log(import_picocolors25.default.gray("[DEBUG]"), message);
     }
   }
   verbose(message, context) {
@@ -43421,7 +43584,7 @@ class Logger2 {
     const timestamp = this.getTimestamp();
     const sanitizedMessage = this.sanitize(message);
     const formattedContext = context ? this.formatContext(context) : "";
-    const logLine = `${timestamp} ${import_picocolors26.default.gray("[VERBOSE]")} ${sanitizedMessage}${formattedContext}`;
+    const logLine = `${timestamp} ${import_picocolors25.default.gray("[VERBOSE]")} ${sanitizedMessage}${formattedContext}`;
     console.error(logLine);
     if (this.logFileStream) {
       const plainLogLine = `${timestamp} [VERBOSE] ${sanitizedMessage}${formattedContext}`;
@@ -43524,7 +43687,7 @@ var logger3 = new Logger2;
 
 // src/shared/output-manager.ts
 init_terminal_utils();
-var import_picocolors27 = __toESM(require_picocolors(), 1);
+var import_picocolors26 = __toESM(require_picocolors(), 1);
 var SYMBOLS2 = {
   unicode: {
     prompt: "◇",
@@ -43603,7 +43766,7 @@ class OutputManager2 {
     if (this.config.quiet)
       return;
     const symbol = this.getSymbols().success;
-    console.log(import_picocolors27.default.green(`${symbol} ${message}`));
+    console.log(import_picocolors26.default.green(`${symbol} ${message}`));
   }
   error(message, data) {
     if (this.config.json) {
@@ -43611,7 +43774,7 @@ class OutputManager2 {
       return;
     }
     const symbol = this.getSymbols().error;
-    console.error(import_picocolors27.default.red(`${symbol} ${message}`));
+    console.error(import_picocolors26.default.red(`${symbol} ${message}`));
   }
   warning(message, data) {
     if (this.config.json) {
@@ -43621,7 +43784,7 @@ class OutputManager2 {
     if (this.config.quiet)
       return;
     const symbol = this.getSymbols().warning;
-    console.log(import_picocolors27.default.yellow(`${symbol} ${message}`));
+    console.log(import_picocolors26.default.yellow(`${symbol} ${message}`));
   }
   info(message, data) {
     if (this.config.json) {
@@ -43631,7 +43794,7 @@ class OutputManager2 {
     if (this.config.quiet)
       return;
     const symbol = this.getSymbols().info;
-    console.log(import_picocolors27.default.blue(`${symbol} ${message}`));
+    console.log(import_picocolors26.default.blue(`${symbol} ${message}`));
   }
   verbose(message, data) {
     if (!this.config.verbose)
@@ -43640,7 +43803,7 @@ class OutputManager2 {
       this.addJsonEntry({ type: "info", message, data });
       return;
     }
-    console.log(import_picocolors27.default.dim(`  ${message}`));
+    console.log(import_picocolors26.default.dim(`  ${message}`));
   }
   indent(message) {
     if (this.config.json)
@@ -43665,7 +43828,7 @@ class OutputManager2 {
       return;
     const symbols = this.getSymbols();
     console.log();
-    console.log(import_picocolors27.default.bold(import_picocolors27.default.cyan(`${symbols.line} ${title}`)));
+    console.log(import_picocolors26.default.bold(import_picocolors26.default.cyan(`${symbols.line} ${title}`)));
   }
   addJsonEntry(entry) {
     this.jsonBuffer.push({