claudekit-cli 3.24.1 → 3.25.0

package/dist/index.js

@@ -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,
@@ -37841,12 +37841,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 +37856,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);
     }
   }
@@ -40379,7 +40377,7 @@ 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) {
     accessibleKits = await detectAccessibleKits();
     if (accessibleKits.length === 0) {
       logger.error("No ClaudeKit access found.");
@@ -41672,7 +41670,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 +41809,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");
@@ -42388,7 +42402,7 @@ ${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 { join as join75 } from "node:path";
 import { promisify as promisify7 } from "node:util";
 
 // src/domains/github/npm-registry.ts
@@ -42526,500 +42540,219 @@ class NpmRegistryClient {
   }
 }
 
-// src/domains/versioning/checking/version-utils.ts
+// src/commands/update-cli.ts
+init_logger();
+init_types2();
+init_types2();
 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;
+var import_fs_extra36 = __toESM(require_lib(), 1);
+// package.json
+var package_default = {
+  name: "claudekit-cli",
+  version: "3.25.0",
+  description: "CLI tool for bootstrapping and updating ClaudeKit projects",
+  type: "module",
+  repository: {
+    type: "git",
+    url: "git+https://github.com/mrgoonie/claudekit-cli.git"
+  },
+  publishConfig: {
+    access: "public",
+    registry: "https://registry.npmjs.org"
+  },
+  bin: {
+    ck: "bin/ck.js"
+  },
+  files: [
+    "bin/ck.js",
+    "dist/index.js"
+  ],
+  scripts: {
+    dev: "bun run src/index.ts",
+    build: "bun build src/index.ts --outdir dist --target node --external @octokit/rest",
+    compile: "bun build src/index.ts --compile --outfile ck",
+    "compile:binary": "bun build src/index.ts --compile --outfile bin/ck",
+    "compile:binaries": "node scripts/build-all-binaries.js",
+    "check-version-sync": "node scripts/check-binary-version-sync.js",
+    "build:platform-binaries": "bun run scripts/build-platform-binaries.js",
+    test: "bun test",
+    "test:watch": "bun test --watch",
+    "test:quick": "./scripts/dev-quick-start.sh test",
+    lint: "biome check .",
+    "lint:fix": "biome check --fix .",
+    "lint:fix-unsafe": "biome check --fix --unsafe .",
+    format: "biome format --write .",
+    typecheck: "tsc --noEmit",
+    "dev:quick": "./scripts/dev-quick-start.sh",
+    "dev:all": "./scripts/dev-quick-start.sh all",
+    metrics: "bun run scripts/workflow-metrics.ts",
+    "install:hooks": "./.githooks/install.sh"
+  },
+  keywords: [
+    "cli",
+    "claudekit",
+    "boilerplate",
+    "bootstrap",
+    "template"
+  ],
+  author: "ClaudeKit",
+  license: "MIT",
+  engines: {
+    bun: ">=1.3.2",
+    node: ">=18.0.0"
+  },
+  dependencies: {
+    "@clack/prompts": "^0.7.0",
+    "@octokit/rest": "^22.0.0",
+    cac: "^6.7.14",
+    "cli-progress": "^3.12.0",
+    "compare-versions": "^6.1.1",
+    diff: "^8.0.2",
+    "extract-zip": "^2.0.1",
+    "fs-extra": "^11.2.0",
+    ignore: "^5.3.2",
+    minimatch: "^10.1.1",
+    ora: "^8.0.0",
+    "p-limit": "^7.2.0",
+    picocolors: "^1.1.1",
+    "proper-lockfile": "^4.1.2",
+    semver: "^7.7.3",
+    tar: "^7.4.3",
+    tmp: "^0.2.3",
+    zod: "^3.23.8"
+  },
+  devDependencies: {
+    "@biomejs/biome": "^1.9.4",
+    "@semantic-release/changelog": "^6.0.3",
+    "@semantic-release/git": "^10.0.1",
+    "@types/bun": "latest",
+    "@types/cli-progress": "^3.11.6",
+    "@types/diff": "^8.0.0",
+    "@types/fs-extra": "^11.0.4",
+    "@types/node": "^22.10.1",
+    "@types/proper-lockfile": "^4.1.4",
+    "@types/semver": "^7.7.1",
+    "@types/tar": "^6.1.13",
+    "@types/tmp": "^0.2.6",
+    "semantic-release": "^24.2.0",
+    typescript: "^5.7.2"
+  }
+};
+
+// src/commands/update-cli.ts
+var execAsync7 = promisify7(exec7);
+
+class CliUpdateError extends ClaudeKitError {
+  constructor(message) {
+    super(message, "CLI_UPDATE_ERROR");
+    this.name = "CliUpdateError";
+  }
 }
-function normalizeVersion(version) {
-  return version.replace(/^v/, "");
+var PACKAGE_NAME = "claudekit-cli";
+function buildInitCommand(isGlobal, kit, beta) {
+  const parts = ["ck init"];
+  if (isGlobal)
+    parts.push("-g");
+  if (kit)
+    parts.push(`--kit ${kit}`);
+  parts.push("--yes --install-skills");
+  if (beta)
+    parts.push("--beta");
+  return parts.join(" ");
 }
-function isNewerVersion(currentVersion, latestVersion) {
-  try {
-    const current = normalizeVersion(currentVersion);
-    const latest = normalizeVersion(latestVersion);
-    return import_compare_versions3.compareVersions(latest, current) > 0;
-  } catch {
-    return false;
+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;
   }
-}
-// 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);
+  if (hasGlobalKit && !hasLocalKit) {
+    const kit2 = globalKits[0] || localKits[0];
+    return {
+      isGlobal: true,
+      kit: kit2,
+      promptMessage: `Update global ClaudeKit content${kit2 ? ` (${kit2})` : ""}?`
+    };
   }
-  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}`);
+  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 = join75(claudeDir, "metadata.json");
+  try {
+    if (!await import_fs_extra36.pathExists(metadataPath)) {
       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}`);
+    const content = await import_fs_extra36.readFile(metadataPath, "utf-8");
+    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;
   }
-  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();
+}
+async function promptKitUpdate(beta) {
+  try {
+    const setup = await getClaudeKitSetup();
+    const hasLocal = !!setup.project.metadata;
+    const hasGlobal = !!setup.global.metadata;
+    const localMetadata = hasLocal ? await readMetadataFile(setup.project.path) : null;
+    const globalMetadata = hasGlobal ? await readMetadataFile(setup.global.path) : null;
+    const localKits = localMetadata ? getInstalledKits(localMetadata) : [];
+    const globalKits = globalMetadata ? getInstalledKits(globalMetadata) : [];
+    const selection = selectKitForUpdate({ hasLocal, hasGlobal, localKits, globalKits });
+    if (!selection) {
+      logger.verbose("No ClaudeKit installations detected, skipping kit update prompt");
+      return;
+    }
+    const initCmd = buildInitCommand(selection.isGlobal, selection.kit, beta);
+    const promptMessage = selection.promptMessage;
+    logger.info("");
+    const shouldUpdate = await se({
+      message: promptMessage
+    });
+    if (lD(shouldUpdate) || !shouldUpdate) {
+      log.info("Skipped kit content update");
+      return;
+    }
+    logger.info(`Running: ${initCmd}`);
+    const s = de();
+    s.start("Updating ClaudeKit content...");
     try {
-      if (existsSync19(cacheFile)) {
-        const fs14 = await import("node:fs/promises");
-        await fs14.unlink(cacheFile);
-        logger.debug("Version check cache cleared");
-      }
+      await execAsync7(initCmd, {
+        timeout: 300000
+      });
+      s.stop("Kit content updated");
     } catch (error) {
-      logger.debug(`Failed to clear version check cache: ${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}`);
+      }
     }
-  }
-}
-
-// 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_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",
-  description: "CLI tool for bootstrapping and updating ClaudeKit projects",
-  type: "module",
-  repository: {
-    type: "git",
-    url: "git+https://github.com/mrgoonie/claudekit-cli.git"
-  },
-  publishConfig: {
-    access: "public",
-    registry: "https://registry.npmjs.org"
-  },
-  bin: {
-    ck: "bin/ck.js"
-  },
-  files: [
-    "bin/ck.js",
-    "dist/index.js"
-  ],
-  scripts: {
-    dev: "bun run src/index.ts",
-    build: "bun build src/index.ts --outdir dist --target node --external @octokit/rest",
-    compile: "bun build src/index.ts --compile --outfile ck",
-    "compile:binary": "bun build src/index.ts --compile --outfile bin/ck",
-    "compile:binaries": "node scripts/build-all-binaries.js",
-    "check-version-sync": "node scripts/check-binary-version-sync.js",
-    "build:platform-binaries": "bun run scripts/build-platform-binaries.js",
-    test: "bun test",
-    "test:watch": "bun test --watch",
-    "test:quick": "./scripts/dev-quick-start.sh test",
-    lint: "biome check .",
-    "lint:fix": "biome check --fix .",
-    "lint:fix-unsafe": "biome check --fix --unsafe .",
-    format: "biome format --write .",
-    typecheck: "tsc --noEmit",
-    "dev:quick": "./scripts/dev-quick-start.sh",
-    "dev:all": "./scripts/dev-quick-start.sh all",
-    metrics: "bun run scripts/workflow-metrics.ts",
-    "install:hooks": "./.githooks/install.sh"
-  },
-  keywords: [
-    "cli",
-    "claudekit",
-    "boilerplate",
-    "bootstrap",
-    "template"
-  ],
-  author: "ClaudeKit",
-  license: "MIT",
-  engines: {
-    bun: ">=1.3.2",
-    node: ">=18.0.0"
-  },
-  dependencies: {
-    "@clack/prompts": "^0.7.0",
-    "@octokit/rest": "^22.0.0",
-    cac: "^6.7.14",
-    "cli-progress": "^3.12.0",
-    "compare-versions": "^6.1.1",
-    diff: "^8.0.2",
-    "extract-zip": "^2.0.1",
-    "fs-extra": "^11.2.0",
-    ignore: "^5.3.2",
-    minimatch: "^10.1.1",
-    ora: "^8.0.0",
-    "p-limit": "^7.2.0",
-    picocolors: "^1.1.1",
-    "proper-lockfile": "^4.1.2",
-    semver: "^7.7.3",
-    tar: "^7.4.3",
-    tmp: "^0.2.3",
-    zod: "^3.23.8"
-  },
-  devDependencies: {
-    "@biomejs/biome": "^1.9.4",
-    "@semantic-release/changelog": "^6.0.3",
-    "@semantic-release/git": "^10.0.1",
-    "@types/bun": "latest",
-    "@types/cli-progress": "^3.11.6",
-    "@types/diff": "^8.0.0",
-    "@types/fs-extra": "^11.0.4",
-    "@types/node": "^22.10.1",
-    "@types/proper-lockfile": "^4.1.4",
-    "@types/semver": "^7.7.1",
-    "@types/tar": "^6.1.13",
-    "@types/tmp": "^0.2.6",
-    "semantic-release": "^24.2.0",
-    typescript: "^5.7.2"
-  }
-};
-
-// src/commands/update-cli.ts
-var execAsync7 = promisify7(exec7);
-
-class CliUpdateError extends ClaudeKitError {
-  constructor(message) {
-    super(message, "CLI_UPDATE_ERROR");
-    this.name = "CliUpdateError";
-  }
-}
-var PACKAGE_NAME2 = "claudekit-cli";
-var KIT_UPDATE_REMINDER_HEADER = "Note: 'ck update' only updates the CLI tool itself.";
-function buildInitCommand(isGlobal, kit, beta) {
-  const parts = ["ck init"];
-  if (isGlobal)
-    parts.push("-g");
-  if (kit)
-    parts.push(`--kit ${kit}`);
-  parts.push("--yes --install-skills");
-  if (beta)
-    parts.push("--beta");
-  return parts.join(" ");
-}
-async function readMetadataFile(claudeDir) {
-  const metadataPath = join76(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 {
-    return null;
-  }
-}
-async function displayKitUpdateReminder(beta) {
-  try {
-    const setup = await getClaudeKitSetup();
-    const hasLocal = !!setup.project.metadata;
-    const hasGlobal = !!setup.global.metadata;
-    const localMetadata = hasLocal ? await readMetadataFile(setup.project.path) : null;
-    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"
-      });
-    }
-    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 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("");
-    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 +42770,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 +42778,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 +42810,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,7 +42823,7 @@ 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 {
@@ -43117,11 +42850,11 @@ Manual update: ${updateCmd}`);
       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 +42870,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 +42892,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 +42950,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);
       }
@@ -43289,6 +43022,272 @@ function registerCommands(cli) {
 // src/cli/version-display.ts
 import { existsSync as existsSync20, readFileSync as readFileSync6 } 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;
@@ -43387,7 +43386,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 +43395,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 +43420,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 +43523,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 +43602,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 +43610,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 +43620,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 +43630,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 +43639,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 +43664,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({

package/package.json

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