claudekit-cli 3.41.1-dev.3 → 3.41.1-dev.5

package/dist/index.js

@@ -56493,6 +56493,11 @@ var init_skill_routes = __esm(() => {
 });
 
 // src/domains/github/npm-registry.ts
+var exports_npm_registry = {};
+__export(exports_npm_registry, {
+  redactRegistryUrlForLog: () => redactRegistryUrlForLog,
+  NpmRegistryClient: () => NpmRegistryClient
+});
 function redactRegistryUrlForLog(url) {
   if (!url)
     return url;
@@ -57189,232 +57194,182 @@ var init_package_manager_detector = __esm(() => {
   };
 });
 
-// src/domains/migration/metadata-migration.ts
-import { join as join45 } from "node:path";
-async function detectMetadataFormat(claudeDir2) {
-  const metadataPath = join45(claudeDir2, "metadata.json");
-  if (!await import_fs_extra3.pathExists(metadataPath)) {
-    return { format: "none", metadata: null, detectedKit: null };
-  }
-  try {
-    const content = await import_fs_extra3.readFile(metadataPath, "utf-8");
-    const parsed = JSON.parse(content);
-    if (parsed.kits && Object.keys(parsed.kits).length > 0) {
-      const installedKits = Object.keys(parsed.kits);
-      return {
-        format: "multi-kit",
-        metadata: parsed,
-        detectedKit: installedKits[0] || null
-      };
+// package.json
+var package_default;
+var init_package = __esm(() => {
+  package_default = {
+    name: "claudekit-cli",
+    version: "3.41.1-dev.5",
+    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",
+      "dist/ui/"
+    ],
+    scripts: {
+      tauri: "tauri",
+      "tauri:dev": "tauri dev",
+      "tauri:build": "tauri build",
+      dev: "bun run src/index.ts",
+      "dashboard:dev": "cd src/ui && bun install --silent && cd ../.. && bun run src/index.ts config ui --dev",
+      "dashboard:tauri": "cd src/ui && bun install --silent && cd ../.. && bun run src/index.ts config ui --dev --no-open --port 3456",
+      "ui:build": "cd src/ui && bun install --silent && bun run build",
+      "ui:dev": "cd src/ui && bun run dev",
+      build: `bun build src/index.ts --outdir dist --target node --external @octokit/rest --external better-sqlite3 && node -e "const fs=require('fs'),f='dist/index.js',c=fs.readFileSync(f,'utf-8');fs.writeFileSync(f,c.replace(/^#!.*\\n\\/\\/ @bun\\n/,''))"`,
+      "verify:package": "node scripts/prepublish-check.js",
+      test: "bun test",
+      "test:integration": "CK_RUN_CLI_INTEGRATION=1 bun test tests/integration/cli.test.ts",
+      "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",
+      validate: "bun run typecheck && bun run lint && bun test && bun run build",
+      "install:hooks": "./.githooks/install.sh",
+      prepare: `node -e "try{require('child_process').execSync('git rev-parse --git-dir',{stdio:'ignore'});require('child_process').execSync('bash .githooks/install.sh',{stdio:'inherit'})}catch(e){console.warn('[i] Hook install skipped:',e.message)}"`
+    },
+    keywords: [
+      "cli",
+      "claudekit",
+      "boilerplate",
+      "bootstrap",
+      "template"
+    ],
+    author: "ClaudeKit",
+    license: "MIT",
+    engines: {
+      node: ">=18.0.0"
+    },
+    dependencies: {
+      "@clack/prompts": "^0.7.0",
+      "@octokit/rest": "^22.0.0",
+      "better-sqlite3": "^12.6.2",
+      cac: "^6.7.14",
+      chokidar: "^5.0.0",
+      "cli-progress": "^3.12.0",
+      "compare-versions": "^6.1.1",
+      diff: "^8.0.3",
+      express: "^5.2.1",
+      "extract-zip": "^2.0.1",
+      "fs-extra": "^11.2.0",
+      "get-port": "^7.1.0",
+      "gray-matter": "^4.0.3",
+      ignore: "^5.3.2",
+      minimatch: "^10.1.1",
+      open: "^11.0.0",
+      ora: "^8.0.0",
+      "p-limit": "^7.2.0",
+      picocolors: "^1.1.1",
+      picomatch: "^4.0.3",
+      "proper-lockfile": "^4.1.2",
+      semver: "^7.7.3",
+      tar: "^7.4.3",
+      tmp: "^0.2.3",
+      ws: "^8.19.0",
+      zod: "^3.23.8"
+    },
+    devDependencies: {
+      "@biomejs/biome": "^1.9.4",
+      "@semantic-release/changelog": "^6.0.3",
+      "@semantic-release/git": "^10.0.1",
+      "@tauri-apps/cli": "^2",
+      "@types/better-sqlite3": "^7.6.13",
+      "@types/bun": "latest",
+      "@types/cli-progress": "^3.11.6",
+      "@types/diff": "^8.0.0",
+      "@types/express": "^5.0.6",
+      "@types/fs-extra": "^11.0.4",
+      "@types/node": "^22.19.7",
+      "@types/picomatch": "^4.0.2",
+      "@types/proper-lockfile": "^4.1.4",
+      "@types/semver": "^7.7.1",
+      "@types/tar": "^6.1.13",
+      "@types/tmp": "^0.2.6",
+      "@types/ws": "^8.18.1",
+      "conventional-changelog-conventionalcommits": "^9.1.0",
+      "semantic-release": "^24.2.0",
+      typescript: "^5.7.2"
     }
-    if (parsed.name || parsed.version || parsed.files) {
-      let detectedKit = null;
-      const nameToCheck = parsed.name || "";
-      if (/\bengineer\b/i.test(nameToCheck)) {
-        detectedKit = "engineer";
-      } else if (/\bmarketing\b/i.test(nameToCheck)) {
-        detectedKit = "marketing";
-      } else {
-        detectedKit = "engineer";
+  };
+});
+
+// node_modules/compare-versions/lib/umd/index.js
+var require_umd = __commonJS((exports, module) => {
+  (function(global3, factory) {
+    typeof exports === "object" && typeof module !== "undefined" ? factory(exports) : typeof define === "function" && define.amd ? define(["exports"], factory) : (global3 = typeof globalThis !== "undefined" ? globalThis : global3 || self, factory(global3.compareVersions = {}));
+  })(exports, function(exports2) {
+    const semver2 = /^[v^~<>=]*?(\d+)(?:\.([x*]|\d+)(?:\.([x*]|\d+)(?:\.([x*]|\d+))?(?:-([\da-z\-]+(?:\.[\da-z\-]+)*))?(?:\+[\da-z\-]+(?:\.[\da-z\-]+)*)?)?)?$/i;
+    const validateAndParse = (version) => {
+      if (typeof version !== "string") {
+        throw new TypeError("Invalid argument expected string");
       }
-      return { format: "legacy", metadata: parsed, detectedKit };
-    }
-    logger.warning("Metadata file exists but has unrecognized format (missing kits, name, version, or files)");
-    return { format: "none", metadata: null, detectedKit: null };
-  } catch (error) {
-    logger.warning(`Failed to read metadata file (may be corrupted): ${error}`);
-    return { format: "none", metadata: null, detectedKit: null };
-  }
-}
-async function migrateToMultiKit(claudeDir2) {
-  const detection = await detectMetadataFormat(claudeDir2);
-  if (detection.format === "multi-kit") {
-    return {
-      success: true,
-      migrated: false,
-      fromFormat: "multi-kit",
-      toFormat: "multi-kit"
+      const match = version.match(semver2);
+      if (!match) {
+        throw new Error(`Invalid argument not valid semver ('${version}' received)`);
+      }
+      match.shift();
+      return match;
     };
-  }
-  if (detection.format === "none") {
-    return {
-      success: true,
-      migrated: false,
-      fromFormat: "none",
-      toFormat: "multi-kit"
+    const isWildcard = (s) => s === "*" || s === "x" || s === "X";
+    const tryParse = (v2) => {
+      const n = parseInt(v2, 10);
+      return isNaN(n) ? v2 : n;
     };
-  }
-  const metadataPath = join45(claudeDir2, "metadata.json");
-  const legacy = detection.metadata;
-  if (!legacy) {
-    return {
-      success: false,
-      migrated: false,
-      fromFormat: "legacy",
-      toFormat: "multi-kit",
-      error: "Metadata exists but could not be read"
+    const forceType = (a3, b3) => typeof a3 !== typeof b3 ? [String(a3), String(b3)] : [a3, b3];
+    const compareStrings = (a3, b3) => {
+      if (isWildcard(a3) || isWildcard(b3))
+        return 0;
+      const [ap, bp] = forceType(tryParse(a3), tryParse(b3));
+      if (ap > bp)
+        return 1;
+      if (ap < bp)
+        return -1;
+      return 0;
     };
-  }
-  const legacyKit = detection.detectedKit || "engineer";
-  try {
-    const kitMetadata = {
-      version: legacy.version || "unknown",
-      installedAt: legacy.installedAt || new Date().toISOString(),
-      files: legacy.files || []
+    const compareSegments = (a3, b3) => {
+      for (let i = 0;i < Math.max(a3.length, b3.length); i++) {
+        const r2 = compareStrings(a3[i] || "0", b3[i] || "0");
+        if (r2 !== 0)
+          return r2;
+      }
+      return 0;
     };
-    const multiKit = {
-      kits: {
-        [legacyKit]: kitMetadata
-      },
-      scope: legacy.scope,
-      name: legacy.name,
-      version: legacy.version,
-      installedAt: legacy.installedAt,
-      installedFiles: legacy.installedFiles,
-      userConfigFiles: legacy.userConfigFiles,
-      files: legacy.files
+    const compareVersions = (v1, v2) => {
+      const n1 = validateAndParse(v1);
+      const n2 = validateAndParse(v2);
+      const p1 = n1.pop();
+      const p2 = n2.pop();
+      const r2 = compareSegments(n1, n2);
+      if (r2 !== 0)
+        return r2;
+      if (p1 && p2) {
+        return compareSegments(p1.split("."), p2.split("."));
+      } else if (p1 || p2) {
+        return p1 ? -1 : 1;
+      }
+      return 0;
     };
-    await import_fs_extra3.writeFile(metadataPath, JSON.stringify(multiKit, null, 2), "utf-8");
-    logger.info(`Migrated metadata from legacy format to multi-kit (detected: ${legacyKit})`);
-    return {
-      success: true,
-      migrated: true,
-      fromFormat: "legacy",
-      toFormat: "multi-kit"
-    };
-  } catch (error) {
-    const errorMsg = error instanceof Error ? error.message : "Unknown error";
-    logger.error(`Metadata migration failed: ${errorMsg}`);
-    return {
-      success: false,
-      migrated: false,
-      fromFormat: "legacy",
-      toFormat: "multi-kit",
-      error: errorMsg
-    };
-  }
-}
-function getKitMetadata(metadata, kit) {
-  if (metadata.kits?.[kit]) {
-    return metadata.kits[kit];
-  }
-  if (!metadata.kits && metadata.version) {
-    return {
-      version: metadata.version,
-      installedAt: metadata.installedAt || "",
-      files: metadata.files
-    };
-  }
-  return null;
-}
-function getAllTrackedFiles(metadata) {
-  if (metadata.kits) {
-    const allFiles = [];
-    for (const kit of Object.values(metadata.kits)) {
-      if (kit.files) {
-        allFiles.push(...kit.files);
-      }
-    }
-    return allFiles;
-  }
-  return metadata.files || [];
-}
-function getTrackedFilesForKit(metadata, kitType) {
-  if (metadata.kits?.[kitType]) {
-    return metadata.kits[kitType].files || [];
-  }
-  const detectedKits = getInstalledKits(metadata);
-  if (detectedKits.includes(kitType)) {
-    return metadata.files || [];
-  }
-  return [];
-}
-function getInstalledKits(metadata) {
-  if (metadata.kits) {
-    return Object.keys(metadata.kits);
-  }
-  const nameToCheck = metadata.name || "";
-  const kits = [];
-  if (/\bengineer\b/i.test(nameToCheck)) {
-    kits.push("engineer");
-  }
-  if (/\bmarketing\b/i.test(nameToCheck)) {
-    kits.push("marketing");
-  }
-  if (kits.length > 0) {
-    return kits;
-  }
-  if (metadata.version) {
-    return ["engineer"];
-  }
-  return [];
-}
-var import_fs_extra3;
-var init_metadata_migration = __esm(() => {
-  init_logger();
-  import_fs_extra3 = __toESM(require_lib3(), 1);
-});
-
-// node_modules/compare-versions/lib/umd/index.js
-var require_umd = __commonJS((exports, module) => {
-  (function(global3, factory) {
-    typeof exports === "object" && typeof module !== "undefined" ? factory(exports) : typeof define === "function" && define.amd ? define(["exports"], factory) : (global3 = typeof globalThis !== "undefined" ? globalThis : global3 || self, factory(global3.compareVersions = {}));
-  })(exports, function(exports2) {
-    const semver2 = /^[v^~<>=]*?(\d+)(?:\.([x*]|\d+)(?:\.([x*]|\d+)(?:\.([x*]|\d+))?(?:-([\da-z\-]+(?:\.[\da-z\-]+)*))?(?:\+[\da-z\-]+(?:\.[\da-z\-]+)*)?)?)?$/i;
-    const validateAndParse = (version) => {
-      if (typeof version !== "string") {
-        throw new TypeError("Invalid argument expected string");
-      }
-      const match = version.match(semver2);
-      if (!match) {
-        throw new Error(`Invalid argument not valid semver ('${version}' received)`);
-      }
-      match.shift();
-      return match;
-    };
-    const isWildcard = (s) => s === "*" || s === "x" || s === "X";
-    const tryParse = (v2) => {
-      const n = parseInt(v2, 10);
-      return isNaN(n) ? v2 : n;
-    };
-    const forceType = (a3, b3) => typeof a3 !== typeof b3 ? [String(a3), String(b3)] : [a3, b3];
-    const compareStrings = (a3, b3) => {
-      if (isWildcard(a3) || isWildcard(b3))
-        return 0;
-      const [ap, bp] = forceType(tryParse(a3), tryParse(b3));
-      if (ap > bp)
-        return 1;
-      if (ap < bp)
-        return -1;
-      return 0;
-    };
-    const compareSegments = (a3, b3) => {
-      for (let i = 0;i < Math.max(a3.length, b3.length); i++) {
-        const r2 = compareStrings(a3[i] || "0", b3[i] || "0");
-        if (r2 !== 0)
-          return r2;
-      }
-      return 0;
-    };
-    const compareVersions = (v1, v2) => {
-      const n1 = validateAndParse(v1);
-      const n2 = validateAndParse(v2);
-      const p1 = n1.pop();
-      const p2 = n2.pop();
-      const r2 = compareSegments(n1, n2);
-      if (r2 !== 0)
-        return r2;
-      if (p1 && p2) {
-        return compareSegments(p1.split("."), p2.split("."));
-      } else if (p1 || p2) {
-        return p1 ? -1 : 1;
-      }
-      return 0;
-    };
-    const compare = (v1, v2, operator) => {
-      assertValidOperator(operator);
-      const res = compareVersions(v1, v2);
-      return operatorResMap[operator].includes(res);
+    const compare = (v1, v2, operator) => {
+      assertValidOperator(operator);
+      const res = compareVersions(v1, v2);
+      return operatorResMap[operator].includes(res);
     };
     const operatorResMap = {
       ">": [1],
@@ -57526,222 +57481,462 @@ var init_version_utils = __esm(() => {
   import_compare_versions = __toESM(require_umd(), 1);
 });
 
-// src/services/file-operations/claudekit-scanner.ts
-import { join as join46 } from "node:path";
-async function scanClaudeKitDirectory(directoryPath) {
-  const counts = {
-    agents: 0,
-    commands: 0,
-    rules: 0,
-    skills: 0
-  };
-  try {
-    if (!await import_fs_extra4.pathExists(directoryPath)) {
-      return counts;
-    }
-    const items = await import_fs_extra4.readdir(directoryPath);
-    if (items.includes("agents")) {
-      const agentsPath = join46(directoryPath, "agents");
-      const agentFiles = await import_fs_extra4.readdir(agentsPath);
-      counts.agents = agentFiles.filter((file) => file.endsWith(".md")).length;
-    }
-    if (items.includes("commands")) {
-      const commandsPath = join46(directoryPath, "commands");
-      const commandFiles = await import_fs_extra4.readdir(commandsPath);
-      counts.commands = commandFiles.filter((file) => file.endsWith(".md")).length;
-    }
-    if (items.includes("rules")) {
-      const rulesPath = join46(directoryPath, "rules");
-      const ruleFiles = await import_fs_extra4.readdir(rulesPath);
-      counts.rules = ruleFiles.filter((file) => file.endsWith(".md")).length;
-    } else if (items.includes("workflows")) {
-      const workflowsPath = join46(directoryPath, "workflows");
-      const workflowFiles = await import_fs_extra4.readdir(workflowsPath);
-      counts.rules = workflowFiles.filter((file) => file.endsWith(".md")).length;
+// src/commands/update/error.ts
+var CliUpdateError;
+var init_error = __esm(() => {
+  init_types3();
+  CliUpdateError = class CliUpdateError extends ClaudeKitError {
+    constructor(message) {
+      super(message, "CLI_UPDATE_ERROR");
+      this.name = "CliUpdateError";
     }
-    if (items.includes("skills")) {
-      const skillsPath = join46(directoryPath, "skills");
-      const skillItems = await import_fs_extra4.readdir(skillsPath);
-      let skillCount = 0;
-      for (const item of skillItems) {
-        if (SKIP_DIRS_CLAUDE_INTERNAL.includes(item)) {
-          continue;
-        }
-        const itemPath = join46(skillsPath, item);
-        const stat8 = await import_fs_extra4.readdir(itemPath).catch(() => null);
-        if (stat8?.includes("SKILL.md")) {
-          skillCount++;
-        }
-      }
-      counts.skills = skillCount;
+  };
+});
+
+// src/commands/update/channel-resolver.ts
+async function resolveTargetVersion(opts, deps) {
+  const client = deps.npmRegistryClient ?? NpmRegistryClient;
+  const registryUrl = deps.registryUrl ?? undefined;
+  const { spinnerStop } = deps;
+  if (opts.release && opts.release !== "latest") {
+    let exists;
+    try {
+      exists = await client.versionExists(CLAUDEKIT_CLI_NPM_PACKAGE_NAME, opts.release, registryUrl);
+    } catch (error) {
+      spinnerStop("Version check failed");
+      const message = error instanceof Error ? error.message : "Unknown error";
+      logger.verbose(`Release check failed for ${opts.release}: ${message}`);
+      const registryHint = registryUrl ? ` (${redactRegistryUrlForLog(registryUrl)})` : " (default registry)";
+      throw new CliUpdateError(`Failed to verify version ${opts.release} on npm registry${registryHint}. Check registry settings/network connectivity and try again.`);
+    }
+    if (!exists) {
+      spinnerStop("Version not found");
+      throw new CliUpdateError(`Version ${opts.release} does not exist on npm registry. Run 'ck versions' to see available versions.`);
+    }
+    const targetVersion2 = opts.release;
+    spinnerStop(`Target version: ${targetVersion2}`);
+    return { targetVersion: targetVersion2, targetIsPrerelease: isPrereleaseVersion(targetVersion2) };
+  }
+  const usePrereleaseChannel = opts.dev || opts.beta;
+  if (usePrereleaseChannel) {
+    let targetVersion2 = await client.getDevVersion(CLAUDEKIT_CLI_NPM_PACKAGE_NAME, registryUrl);
+    if (!targetVersion2) {
+      spinnerStop("No dev version available");
+      logger.warning("No dev version found. Using latest stable version instead.");
+      targetVersion2 = await client.getLatestVersion(CLAUDEKIT_CLI_NPM_PACKAGE_NAME, registryUrl);
+    } else {
+      spinnerStop(`Latest dev version: ${targetVersion2}`);
+      return { targetVersion: targetVersion2, targetIsPrerelease: isPrereleaseVersion(targetVersion2) };
     }
-  } catch (error) {}
-  return counts;
-}
-async function readClaudeKitMetadata(metadataPath) {
-  try {
-    if (!await import_fs_extra4.pathExists(metadataPath)) {
-      return null;
+    if (!targetVersion2) {
+      throw new CliUpdateError("Failed to fetch version information from npm registry. Check your internet connection and try again.");
     }
-    const content = await import_fs_extra4.readFile(metadataPath, "utf8");
-    const metadata = JSON.parse(content);
-    return metadata;
-  } catch {
-    return null;
+    spinnerStop(`Latest version: ${targetVersion2}`);
+    return { targetVersion: targetVersion2, targetIsPrerelease: isPrereleaseVersion(targetVersion2) };
+  }
+  const targetVersion = await client.getLatestVersion(CLAUDEKIT_CLI_NPM_PACKAGE_NAME, registryUrl);
+  spinnerStop(`Latest version: ${targetVersion || "unknown"}`);
+  if (!targetVersion) {
+    throw new CliUpdateError("Failed to fetch version information from npm registry. Check your internet connection and try again.");
   }
+  return { targetVersion, targetIsPrerelease: isPrereleaseVersion(targetVersion) };
 }
-function getGlobalInstallDir() {
-  return PathResolver.getGlobalKitDir();
+var init_channel_resolver = __esm(() => {
+  init_npm_registry();
+  init_version_utils();
+  init_claudekit_constants();
+  init_logger();
+  init_error();
+});
+
+// src/commands/update/registry-client.ts
+function redactCommandForLog(command) {
+  if (!command)
+    return command;
+  const redactedRegistryFlags = command.replace(/(--registry(?:=|\s+))(['"]?)(\S+?)(\2)(?=\s|$)/g, (_match, prefix, quote, url) => `${prefix}${quote}${redactRegistryUrlForLog(url)}${quote}`);
+  return redactedRegistryFlags.replace(/https?:\/\/[^\s"']+/g, (url) => redactRegistryUrlForLog(url));
 }
-async function getClaudeKitSetup(projectDir = process.cwd()) {
-  const setup = {
-    global: {
-      path: "",
-      metadata: null,
-      components: { agents: 0, commands: 0, rules: 0, skills: 0 }
-    },
-    project: {
-      path: "",
-      metadata: null,
-      components: { agents: 0, commands: 0, rules: 0, skills: 0 }
-    }
-  };
-  const globalDir = getGlobalInstallDir();
-  if (await import_fs_extra4.pathExists(globalDir)) {
-    setup.global.path = globalDir;
-    setup.global.metadata = await readClaudeKitMetadata(join46(globalDir, "metadata.json"));
-    setup.global.components = await scanClaudeKitDirectory(globalDir);
+var init_registry_client = __esm(() => {
+  init_npm_registry();
+});
+
+// src/commands/update/version-comparator.ts
+function compareCliVersions(currentVersion, targetVersion, opts) {
+  const comparison = import_compare_versions2.compareVersions(currentVersion, targetVersion);
+  if (comparison === 0) {
+    return { status: "up-to-date" };
   }
-  const projectClaudeDir = join46(projectDir, ".claude");
-  const isLocalSameAsGlobal = projectClaudeDir === globalDir;
-  if (!isLocalSameAsGlobal && await import_fs_extra4.pathExists(projectClaudeDir)) {
-    setup.project.path = projectClaudeDir;
-    setup.project.metadata = await readClaudeKitMetadata(join46(projectClaudeDir, "metadata.json"));
-    setup.project.components = await scanClaudeKitDirectory(projectClaudeDir);
+  const isDevChannelSwitch = (opts.dev || opts.beta) && isPrereleaseVersion(targetVersion) && !isPrereleaseVersion(currentVersion);
+  if (isDevChannelSwitch) {
+    return { status: "dev-channel-switch", changeType: "upgrade" };
   }
-  return setup;
+  if (comparison > 0 && !opts.release) {
+    return { status: "newer", changeType: "downgrade" };
+  }
+  return { status: "older", changeType: comparison < 0 ? "upgrade" : "downgrade" };
 }
-var import_fs_extra4;
-var init_claudekit_scanner = __esm(() => {
-  init_path_resolver();
-  init_skip_directories();
-  import_fs_extra4 = __toESM(require_lib3(), 1);
-});
-
-// package.json
-var package_default;
-var init_package = __esm(() => {
-  package_default = {
-    name: "claudekit-cli",
-    version: "3.41.1-dev.3",
-    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",
-      "dist/ui/"
-    ],
-    scripts: {
-      tauri: "tauri",
-      "tauri:dev": "tauri dev",
-      "tauri:build": "tauri build",
-      dev: "bun run src/index.ts",
-      "dashboard:dev": "cd src/ui && bun install --silent && cd ../.. && bun run src/index.ts config ui --dev",
-      "dashboard:tauri": "cd src/ui && bun install --silent && cd ../.. && bun run src/index.ts config ui --dev --no-open --port 3456",
-      "ui:build": "cd src/ui && bun install --silent && bun run build",
-      "ui:dev": "cd src/ui && bun run dev",
-      build: `bun build src/index.ts --outdir dist --target node --external @octokit/rest --external better-sqlite3 && node -e "const fs=require('fs'),f='dist/index.js',c=fs.readFileSync(f,'utf-8');fs.writeFileSync(f,c.replace(/^#!.*\\n\\/\\/ @bun\\n/,''))"`,
-      "verify:package": "node scripts/prepublish-check.js",
-      test: "bun test",
-      "test:integration": "CK_RUN_CLI_INTEGRATION=1 bun test tests/integration/cli.test.ts",
-      "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",
-      validate: "bun run typecheck && bun run lint && bun test && bun run build",
-      "install:hooks": "./.githooks/install.sh",
-      prepare: `node -e "try{require('child_process').execSync('git rev-parse --git-dir',{stdio:'ignore'});require('child_process').execSync('bash .githooks/install.sh',{stdio:'inherit'})}catch(e){console.warn('[i] Hook install skipped:',e.message)}"`
-    },
-    keywords: [
-      "cli",
-      "claudekit",
-      "boilerplate",
-      "bootstrap",
-      "template"
-    ],
-    author: "ClaudeKit",
-    license: "MIT",
-    engines: {
-      node: ">=18.0.0"
-    },
-    dependencies: {
-      "@clack/prompts": "^0.7.0",
-      "@octokit/rest": "^22.0.0",
-      "better-sqlite3": "^12.6.2",
-      cac: "^6.7.14",
-      chokidar: "^5.0.0",
-      "cli-progress": "^3.12.0",
-      "compare-versions": "^6.1.1",
-      diff: "^8.0.3",
-      express: "^5.2.1",
-      "extract-zip": "^2.0.1",
-      "fs-extra": "^11.2.0",
-      "get-port": "^7.1.0",
-      "gray-matter": "^4.0.3",
-      ignore: "^5.3.2",
-      minimatch: "^10.1.1",
-      open: "^11.0.0",
-      ora: "^8.0.0",
-      "p-limit": "^7.2.0",
-      picocolors: "^1.1.1",
-      picomatch: "^4.0.3",
-      "proper-lockfile": "^4.1.2",
-      semver: "^7.7.3",
-      tar: "^7.4.3",
-      tmp: "^0.2.3",
-      ws: "^8.19.0",
-      zod: "^3.23.8"
+function isBetaVersion(version) {
+  return isPrereleaseVersion(version);
+}
+function parseCliVersionFromOutput(output2) {
+  if (!output2)
+    return null;
+  const match = output2.match(/CLI Version:\s*(\S+)/);
+  return match ? match[1] : null;
+}
+var import_compare_versions2;
+var init_version_comparator = __esm(() => {
+  init_version_utils();
+  import_compare_versions2 = __toESM(require_umd(), 1);
+});
+
+// src/commands/update/package-manager-runner.ts
+function extractCommandStdout(result) {
+  if (typeof result === "string")
+    return result;
+  if (result && typeof result.stdout === "string")
+    return result.stdout;
+  return "";
+}
+async function runPackageManagerUpdate(updateCmd, pm, deps) {
+  const { execAsyncFn, spinnerStart, spinnerStop } = deps;
+  spinnerStart("Updating CLI...");
+  try {
+    await execAsyncFn(updateCmd, { timeout: 120000 });
+    spinnerStop("Update completed");
+  } catch (error) {
+    spinnerStop("Update failed");
+    const errorMessage = error instanceof Error ? error.message : "Unknown error";
+    if (errorMessage.includes("EACCES") || errorMessage.includes("EPERM") || errorMessage.includes("permission") || errorMessage.includes("Access is denied")) {
+      const permHint = pm === "npm" ? `
+
+Or fix npm permissions: https://docs.npmjs.com/resolving-eacces-permissions-errors-when-installing-packages-globally` : "";
+      const isWindows3 = process.platform === "win32";
+      const elevationHint = isWindows3 ? `Run your terminal as Administrator and retry: ${updateCmd}` : `sudo ${updateCmd}`;
+      throw new CliUpdateError(`Permission denied. Try: ${elevationHint}${permHint}`);
+    }
+    logger.error(`Update failed: ${errorMessage}`);
+    logger.info(`Try running: ${updateCmd}`);
+    throw new CliUpdateError(`Update failed: ${errorMessage}
+
+Manual update: ${updateCmd}`);
+  }
+}
+async function verifyInstalledVersion(targetVersion, updateCmd, deps) {
+  const { execAsyncFn, spinnerStart, spinnerStop } = deps;
+  spinnerStart("Verifying installation...");
+  try {
+    const versionResult = await execAsyncFn("ck --version", { timeout: 5000 });
+    const stdout = extractCommandStdout(versionResult);
+    const activeVersion = parseCliVersionFromOutput(stdout);
+    if (!activeVersion) {
+      spinnerStop("Verification failed");
+      const message = `Update completed but could not parse 'ck --version' output.
+Please restart your terminal and run 'ck --version'. Expected: ${targetVersion}
+
+Manual update: ${redactCommandForLog(updateCmd)}`;
+      logger.error(message);
+      throw new CliUpdateError(message);
+    }
+    spinnerStop(`Installed version: ${activeVersion}`);
+    if (activeVersion !== targetVersion) {
+      const mismatchMessage = `Update did not activate the requested version.
+Expected: ${targetVersion}
+Active ck: ${activeVersion}
+
+Likely causes: multiple global installations (npm/bun/pnpm/yarn) or stale shell shim/cache (common on Windows).
+Run '${redactCommandForLog(updateCmd)}' manually, restart terminal, then check command resolution:
+- Windows: where ck
+- macOS/Linux: which -a ck`;
+      logger.error(mismatchMessage);
+      throw new CliUpdateError(mismatchMessage);
+    }
+    return activeVersion;
+  } catch (error) {
+    if (error instanceof CliUpdateError)
+      throw error;
+    spinnerStop("Verification failed");
+    const message = `Update completed but automatic verification failed.
+Please restart your terminal and run 'ck --version'. Expected: ${targetVersion}
+
+Manual update: ${redactCommandForLog(updateCmd)}`;
+    logger.error(message);
+    throw new CliUpdateError(message);
+  }
+}
+var init_package_manager_runner = __esm(() => {
+  init_logger();
+  init_error();
+  init_registry_client();
+  init_version_comparator();
+});
+
+// src/domains/migration/metadata-migration.ts
+import { join as join45 } from "node:path";
+async function detectMetadataFormat(claudeDir2) {
+  const metadataPath = join45(claudeDir2, "metadata.json");
+  if (!await import_fs_extra3.pathExists(metadataPath)) {
+    return { format: "none", metadata: null, detectedKit: null };
+  }
+  try {
+    const content = await import_fs_extra3.readFile(metadataPath, "utf-8");
+    const parsed = JSON.parse(content);
+    if (parsed.kits && Object.keys(parsed.kits).length > 0) {
+      const installedKits = Object.keys(parsed.kits);
+      return {
+        format: "multi-kit",
+        metadata: parsed,
+        detectedKit: installedKits[0] || null
+      };
+    }
+    if (parsed.name || parsed.version || parsed.files) {
+      let detectedKit = null;
+      const nameToCheck = parsed.name || "";
+      if (/\bengineer\b/i.test(nameToCheck)) {
+        detectedKit = "engineer";
+      } else if (/\bmarketing\b/i.test(nameToCheck)) {
+        detectedKit = "marketing";
+      } else {
+        detectedKit = "engineer";
+      }
+      return { format: "legacy", metadata: parsed, detectedKit };
+    }
+    logger.warning("Metadata file exists but has unrecognized format (missing kits, name, version, or files)");
+    return { format: "none", metadata: null, detectedKit: null };
+  } catch (error) {
+    logger.warning(`Failed to read metadata file (may be corrupted): ${error}`);
+    return { format: "none", metadata: null, detectedKit: null };
+  }
+}
+async function migrateToMultiKit(claudeDir2) {
+  const detection = await detectMetadataFormat(claudeDir2);
+  if (detection.format === "multi-kit") {
+    return {
+      success: true,
+      migrated: false,
+      fromFormat: "multi-kit",
+      toFormat: "multi-kit"
+    };
+  }
+  if (detection.format === "none") {
+    return {
+      success: true,
+      migrated: false,
+      fromFormat: "none",
+      toFormat: "multi-kit"
+    };
+  }
+  const metadataPath = join45(claudeDir2, "metadata.json");
+  const legacy = detection.metadata;
+  if (!legacy) {
+    return {
+      success: false,
+      migrated: false,
+      fromFormat: "legacy",
+      toFormat: "multi-kit",
+      error: "Metadata exists but could not be read"
+    };
+  }
+  const legacyKit = detection.detectedKit || "engineer";
+  try {
+    const kitMetadata = {
+      version: legacy.version || "unknown",
+      installedAt: legacy.installedAt || new Date().toISOString(),
+      files: legacy.files || []
+    };
+    const multiKit = {
+      kits: {
+        [legacyKit]: kitMetadata
+      },
+      scope: legacy.scope,
+      name: legacy.name,
+      version: legacy.version,
+      installedAt: legacy.installedAt,
+      installedFiles: legacy.installedFiles,
+      userConfigFiles: legacy.userConfigFiles,
+      files: legacy.files
+    };
+    await import_fs_extra3.writeFile(metadataPath, JSON.stringify(multiKit, null, 2), "utf-8");
+    logger.info(`Migrated metadata from legacy format to multi-kit (detected: ${legacyKit})`);
+    return {
+      success: true,
+      migrated: true,
+      fromFormat: "legacy",
+      toFormat: "multi-kit"
+    };
+  } catch (error) {
+    const errorMsg = error instanceof Error ? error.message : "Unknown error";
+    logger.error(`Metadata migration failed: ${errorMsg}`);
+    return {
+      success: false,
+      migrated: false,
+      fromFormat: "legacy",
+      toFormat: "multi-kit",
+      error: errorMsg
+    };
+  }
+}
+function getKitMetadata(metadata, kit) {
+  if (metadata.kits?.[kit]) {
+    return metadata.kits[kit];
+  }
+  if (!metadata.kits && metadata.version) {
+    return {
+      version: metadata.version,
+      installedAt: metadata.installedAt || "",
+      files: metadata.files
+    };
+  }
+  return null;
+}
+function getAllTrackedFiles(metadata) {
+  if (metadata.kits) {
+    const allFiles = [];
+    for (const kit of Object.values(metadata.kits)) {
+      if (kit.files) {
+        allFiles.push(...kit.files);
+      }
+    }
+    return allFiles;
+  }
+  return metadata.files || [];
+}
+function getTrackedFilesForKit(metadata, kitType) {
+  if (metadata.kits?.[kitType]) {
+    return metadata.kits[kitType].files || [];
+  }
+  const detectedKits = getInstalledKits(metadata);
+  if (detectedKits.includes(kitType)) {
+    return metadata.files || [];
+  }
+  return [];
+}
+function getInstalledKits(metadata) {
+  if (metadata.kits) {
+    return Object.keys(metadata.kits);
+  }
+  const nameToCheck = metadata.name || "";
+  const kits = [];
+  if (/\bengineer\b/i.test(nameToCheck)) {
+    kits.push("engineer");
+  }
+  if (/\bmarketing\b/i.test(nameToCheck)) {
+    kits.push("marketing");
+  }
+  if (kits.length > 0) {
+    return kits;
+  }
+  if (metadata.version) {
+    return ["engineer"];
+  }
+  return [];
+}
+var import_fs_extra3;
+var init_metadata_migration = __esm(() => {
+  init_logger();
+  import_fs_extra3 = __toESM(require_lib3(), 1);
+});
+
+// src/services/file-operations/claudekit-scanner.ts
+import { join as join46 } from "node:path";
+async function scanClaudeKitDirectory(directoryPath) {
+  const counts = {
+    agents: 0,
+    commands: 0,
+    rules: 0,
+    skills: 0
+  };
+  try {
+    if (!await import_fs_extra4.pathExists(directoryPath)) {
+      return counts;
+    }
+    const items = await import_fs_extra4.readdir(directoryPath);
+    if (items.includes("agents")) {
+      const agentsPath = join46(directoryPath, "agents");
+      const agentFiles = await import_fs_extra4.readdir(agentsPath);
+      counts.agents = agentFiles.filter((file) => file.endsWith(".md")).length;
+    }
+    if (items.includes("commands")) {
+      const commandsPath = join46(directoryPath, "commands");
+      const commandFiles = await import_fs_extra4.readdir(commandsPath);
+      counts.commands = commandFiles.filter((file) => file.endsWith(".md")).length;
+    }
+    if (items.includes("rules")) {
+      const rulesPath = join46(directoryPath, "rules");
+      const ruleFiles = await import_fs_extra4.readdir(rulesPath);
+      counts.rules = ruleFiles.filter((file) => file.endsWith(".md")).length;
+    } else if (items.includes("workflows")) {
+      const workflowsPath = join46(directoryPath, "workflows");
+      const workflowFiles = await import_fs_extra4.readdir(workflowsPath);
+      counts.rules = workflowFiles.filter((file) => file.endsWith(".md")).length;
+    }
+    if (items.includes("skills")) {
+      const skillsPath = join46(directoryPath, "skills");
+      const skillItems = await import_fs_extra4.readdir(skillsPath);
+      let skillCount = 0;
+      for (const item of skillItems) {
+        if (SKIP_DIRS_CLAUDE_INTERNAL.includes(item)) {
+          continue;
+        }
+        const itemPath = join46(skillsPath, item);
+        const stat8 = await import_fs_extra4.readdir(itemPath).catch(() => null);
+        if (stat8?.includes("SKILL.md")) {
+          skillCount++;
+        }
+      }
+      counts.skills = skillCount;
+    }
+  } catch (error) {}
+  return counts;
+}
+async function readClaudeKitMetadata(metadataPath) {
+  try {
+    if (!await import_fs_extra4.pathExists(metadataPath)) {
+      return null;
+    }
+    const content = await import_fs_extra4.readFile(metadataPath, "utf8");
+    const metadata = JSON.parse(content);
+    return metadata;
+  } catch {
+    return null;
+  }
+}
+function getGlobalInstallDir() {
+  return PathResolver.getGlobalKitDir();
+}
+async function getClaudeKitSetup(projectDir = process.cwd()) {
+  const setup = {
+    global: {
+      path: "",
+      metadata: null,
+      components: { agents: 0, commands: 0, rules: 0, skills: 0 }
     },
-    devDependencies: {
-      "@biomejs/biome": "^1.9.4",
-      "@semantic-release/changelog": "^6.0.3",
-      "@semantic-release/git": "^10.0.1",
-      "@tauri-apps/cli": "^2",
-      "@types/better-sqlite3": "^7.6.13",
-      "@types/bun": "latest",
-      "@types/cli-progress": "^3.11.6",
-      "@types/diff": "^8.0.0",
-      "@types/express": "^5.0.6",
-      "@types/fs-extra": "^11.0.4",
-      "@types/node": "^22.19.7",
-      "@types/picomatch": "^4.0.2",
-      "@types/proper-lockfile": "^4.1.4",
-      "@types/semver": "^7.7.1",
-      "@types/tar": "^6.1.13",
-      "@types/tmp": "^0.2.6",
-      "@types/ws": "^8.18.1",
-      "conventional-changelog-conventionalcommits": "^9.1.0",
-      "semantic-release": "^24.2.0",
-      typescript: "^5.7.2"
+    project: {
+      path: "",
+      metadata: null,
+      components: { agents: 0, commands: 0, rules: 0, skills: 0 }
     }
   };
+  const globalDir = getGlobalInstallDir();
+  if (await import_fs_extra4.pathExists(globalDir)) {
+    setup.global.path = globalDir;
+    setup.global.metadata = await readClaudeKitMetadata(join46(globalDir, "metadata.json"));
+    setup.global.components = await scanClaudeKitDirectory(globalDir);
+  }
+  const projectClaudeDir = join46(projectDir, ".claude");
+  const isLocalSameAsGlobal = projectClaudeDir === globalDir;
+  if (!isLocalSameAsGlobal && await import_fs_extra4.pathExists(projectClaudeDir)) {
+    setup.project.path = projectClaudeDir;
+    setup.project.metadata = await readClaudeKitMetadata(join46(projectClaudeDir, "metadata.json"));
+    setup.project.components = await scanClaudeKitDirectory(projectClaudeDir);
+  }
+  return setup;
+}
+var import_fs_extra4;
+var init_claudekit_scanner = __esm(() => {
+  init_path_resolver();
+  init_skip_directories();
+  import_fs_extra4 = __toESM(require_lib3(), 1);
 });
 
 // src/domains/github/github-auth.ts
@@ -58151,7 +58346,7 @@ ${action.title}:`);
 }
 
 // src/domains/error/index.ts
-var init_error = () => {};
+var init_error2 = () => {};
 
 // src/domains/github/client/error-handler.ts
 async function handleHttpError(error, context) {
@@ -58182,7 +58377,7 @@ Need help? Run with: ${verboseFlag}`);
 `), classified.httpStatus);
 }
 var init_error_handler2 = __esm(() => {
-  init_error();
+  init_error2();
   init_types3();
   init_auth_api();
 });
@@ -58303,7 +58498,7 @@ class VersionFormatter {
   static compare(v1, v2) {
     const normV1 = VersionFormatter.normalize(v1);
     const normV2 = VersionFormatter.normalize(v2);
-    return import_compare_versions2.compareVersions(normV1, normV2);
+    return import_compare_versions3.compareVersions(normV1, normV2);
   }
   static formatRelativeTime(dateString) {
     if (!dateString)
@@ -58391,20 +58586,20 @@ class VersionFormatter {
       const majorA = Number.parseInt(normA.split(".")[0], 10);
       const majorB = Number.parseInt(normB.split(".")[0], 10);
       if (majorA === 0 && majorB === 0) {
-        return import_compare_versions2.compareVersions(normB, normA);
+        return import_compare_versions3.compareVersions(normB, normA);
       }
       if (majorA === 0)
         return 1;
       if (majorB === 0)
         return -1;
-      return import_compare_versions2.compareVersions(normB, normA);
+      return import_compare_versions3.compareVersions(normB, normA);
     });
   }
 }
-var import_compare_versions2;
+var import_compare_versions3;
 var init_version_formatter = __esm(() => {
   init_logger();
-  import_compare_versions2 = __toESM(require_umd(), 1);
+  import_compare_versions3 = __toESM(require_umd(), 1);
 });
 
 // src/domains/versioning/release-filter.ts
@@ -58913,64 +59108,16 @@ var init_github_client = __esm(() => {
   init_client();
 });
 
-// src/commands/update-cli.ts
+// src/commands/update/post-update-handler.ts
 import { exec as exec2, spawn as spawn2 } from "node:child_process";
 import { join as join48 } from "node:path";
 import { promisify as promisify8 } from "node:util";
-function getDefaultUpdateCliCommandDeps() {
-  return {
-    currentVersion: package_default.version,
-    execAsyncFn: execAsync2,
-    packageManagerDetector: PackageManagerDetector,
-    npmRegistryClient: NpmRegistryClient,
-    promptKitUpdateFn: promptKitUpdate,
-    promptMigrateUpdateFn: promptMigrateUpdate
-  };
-}
-function extractCommandStdout(result) {
-  if (typeof result === "string") {
-    return result;
-  }
-  if (result && typeof result.stdout === "string") {
-    return result.stdout;
-  }
-  return "";
-}
-function redactCommandForLog(command) {
-  if (!command)
-    return command;
-  const redactedRegistryFlags = command.replace(/(--registry(?:=|\s+))(['"]?)(\S+?)(\2)(?=\s|$)/g, (_match, prefix, quote, url) => `${prefix}${quote}${redactRegistryUrlForLog(url)}${quote}`);
-  return redactedRegistryFlags.replace(/https?:\/\/[^\s"']+/g, (url) => redactRegistryUrlForLog(url));
-}
-function buildInitCommand(isGlobal, kit, beta, yes) {
-  const parts = ["ck init"];
-  if (isGlobal)
-    parts.push("-g");
-  if (kit)
-    parts.push(`--kit ${kit}`);
-  if (yes)
-    parts.push("--yes");
-  parts.push("--install-skills");
-  if (beta)
-    parts.push("--beta");
-  return parts.join(" ");
-}
-function isBetaVersion(version) {
-  return isPrereleaseVersion(version);
-}
-function parseCliVersionFromOutput(output2) {
-  if (!output2)
-    return null;
-  const match = output2.match(/CLI Version:\s*(\S+)/);
-  return match ? match[1] : null;
-}
 function selectKitForUpdate(params) {
   const { hasLocal, hasGlobal, localKits, globalKits } = params;
   const hasLocalKit = localKits.length > 0 || hasLocal;
   const hasGlobalKit = globalKits.length > 0 || hasGlobal;
-  if (!hasLocalKit && !hasGlobalKit) {
+  if (!hasLocalKit && !hasGlobalKit)
     return null;
-  }
   if (hasGlobalKit && !hasLocalKit) {
     const kit2 = globalKits[0] || localKits[0];
     return {
@@ -58997,9 +59144,8 @@ function selectKitForUpdate(params) {
 async function readMetadataFile(claudeDir2) {
   const metadataPath = join48(claudeDir2, "metadata.json");
   try {
-    if (!await import_fs_extra5.pathExists(metadataPath)) {
+    if (!await import_fs_extra5.pathExists(metadataPath))
       return null;
-    }
     const content = await import_fs_extra5.readFile(metadataPath, "utf-8");
     const parsed = JSON.parse(content);
     const validated = MetadataSchema.safeParse(parsed);
@@ -59013,6 +59159,19 @@ async function readMetadataFile(claudeDir2) {
     return null;
   }
 }
+function buildInitCommand(isGlobal, kit, beta, yes) {
+  const parts = ["ck init"];
+  if (isGlobal)
+    parts.push("-g");
+  if (kit)
+    parts.push(`--kit ${kit}`);
+  if (yes)
+    parts.push("--yes");
+  parts.push("--install-skills");
+  if (beta)
+    parts.push("--beta");
+  return parts.join(" ");
+}
 async function fetchLatestReleaseTag(kit, beta) {
   try {
     const { GitHubClient: GitHubClient2 } = await Promise.resolve().then(() => (init_github_client(), exports_github_client));
@@ -59066,14 +59225,11 @@ async function promptKitUpdate(beta, yes, deps) {
       const ckConfig = await loadFullConfigFn(null);
       autoInit = ckConfig.config.updatePipeline?.autoInitAfterUpdate ?? false;
     } catch {}
-    if (alreadyAtLatest && !autoInit) {
+    if (alreadyAtLatest && !autoInit)
       return;
-    }
     if (!yes && !autoInit) {
       logger.info("");
-      const shouldUpdate = await confirmFn({
-        message: promptMessage
-      });
+      const shouldUpdate = await confirmFn({ message: promptMessage });
       if (isCancelFn(shouldUpdate) || !shouldUpdate) {
         log.info("Skipped kit content update");
         return;
@@ -59211,6 +59367,37 @@ async function promptMigrateUpdate(deps) {
     logger.verbose(`Migrate step skipped: ${error instanceof Error ? error.message : "unknown"}`);
   }
 }
+var import_fs_extra5, execAsync2, SAFE_PROVIDER_NAME;
+var init_post_update_handler = __esm(() => {
+  init_ck_config_manager();
+  init_metadata_migration();
+  init_version_utils();
+  init_claudekit_scanner();
+  init_logger();
+  init_safe_prompts();
+  init_types3();
+  init_version_comparator();
+  import_fs_extra5 = __toESM(require_lib3(), 1);
+  execAsync2 = promisify8(exec2);
+  SAFE_PROVIDER_NAME = /^[a-z0-9-]+$/;
+});
+
+// src/commands/update-cli.ts
+function getDefaultUpdateCliCommandDeps() {
+  return {
+    currentVersion: package_default.version,
+    execAsyncFn: async (cmd, opts) => {
+      const { exec: exec3 } = await import("node:child_process");
+      const { promisify: promisify9 } = await import("node:util");
+      const result = await promisify9(exec3)(cmd, opts);
+      return { stdout: String(result.stdout ?? ""), stderr: String(result.stderr ?? "") };
+    },
+    packageManagerDetector: PackageManagerDetector,
+    npmRegistryClient: NpmRegistryClient,
+    promptKitUpdateFn: promptKitUpdate,
+    promptMigrateUpdateFn: promptMigrateUpdate
+  };
+}
 async function updateCliCommand(options2, deps = getDefaultUpdateCliCommandDeps()) {
   const s = de();
   intro("[>] ClaudeKit CLI - Update");
@@ -59235,64 +59422,31 @@ async function updateCliCommand(options2, deps = getDefaultUpdateCliCommandDeps(
       const userRegistry = await packageManagerDetector.getNpmRegistryUrl();
       if (userRegistry) {
         registryUrl = userRegistry;
-        logger.verbose(`Using npm configured registry: ${redactRegistryUrlForLog(registryUrl)}`);
+        const { redactRegistryUrlForLog: redactRegistryUrlForLog2 } = await Promise.resolve().then(() => (init_npm_registry(), exports_npm_registry));
+        logger.verbose(`Using npm configured registry: ${redactRegistryUrlForLog2(registryUrl)}`);
       }
     }
     s.start("Checking for updates...");
-    let targetVersion = null;
-    const usePrereleaseChannel = opts.dev || opts.beta;
-    if (opts.release && opts.release !== "latest") {
-      try {
-        const exists = await npmRegistryClient.versionExists(CLAUDEKIT_CLI_NPM_PACKAGE_NAME, opts.release, registryUrl);
-        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.`);
-        }
-      } catch (error) {
-        if (error instanceof CliUpdateError) {
-          throw error;
-        }
-        s.stop("Version check failed");
-        const message = error instanceof Error ? error.message : "Unknown error";
-        logger.verbose(`Release check failed for ${opts.release}: ${message}`);
-        const registryHint = registryUrl ? ` (${redactRegistryUrlForLog(registryUrl)})` : " (default registry)";
-        throw new CliUpdateError(`Failed to verify version ${opts.release} on npm registry${registryHint}. Check registry settings/network connectivity and try again.`);
-      }
-      targetVersion = opts.release;
-      s.stop(`Target version: ${targetVersion}`);
-    } else if (usePrereleaseChannel) {
-      targetVersion = await npmRegistryClient.getDevVersion(CLAUDEKIT_CLI_NPM_PACKAGE_NAME, registryUrl);
-      if (!targetVersion) {
-        s.stop("No dev version available");
-        logger.warning("No dev version found. Using latest stable version instead.");
-        targetVersion = await npmRegistryClient.getLatestVersion(CLAUDEKIT_CLI_NPM_PACKAGE_NAME, registryUrl);
-      } else {
-        s.stop(`Latest dev version: ${targetVersion}`);
-      }
-    } else {
-      targetVersion = await npmRegistryClient.getLatestVersion(CLAUDEKIT_CLI_NPM_PACKAGE_NAME, registryUrl);
-      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, CLAUDEKIT_CLI_NPM_PACKAGE_NAME, undefined, registryUrl)}`);
-    }
-    const comparison = import_compare_versions3.compareVersions(currentVersion, targetVersion);
-    const targetIsPrerelease = isPrereleaseVersion(targetVersion);
-    if (comparison === 0) {
+    const { targetVersion, targetIsPrerelease } = await resolveTargetVersion(opts, {
+      npmRegistryClient,
+      registryUrl,
+      spinnerStop: (msg) => s.stop(msg)
+    });
+    const outcome = compareCliVersions(currentVersion, targetVersion, opts);
+    if (outcome.status === "up-to-date") {
       outro(`[+] Already on the latest CLI version (${currentVersion})`);
       await promptKitUpdateFn(targetIsPrerelease, opts.yes);
       await promptMigrateUpdateFn();
       return;
     }
-    const isDevChannelSwitch = (opts.dev || opts.beta) && isBetaVersion(targetVersion) && !isBetaVersion(currentVersion);
-    if (comparison > 0 && !opts.release && !isDevChannelSwitch) {
+    if (outcome.status === "newer") {
       outro(`[+] Current version (${currentVersion}) is newer than latest (${targetVersion})`);
       await promptKitUpdateFn(targetIsPrerelease, opts.yes);
       await promptMigrateUpdateFn();
       return;
     }
-    const isUpgrade = comparison < 0 || isDevChannelSwitch;
-    const changeType = isUpgrade ? "upgrade" : "downgrade";
+    const isUpgrade = outcome.changeType === "upgrade";
+    const changeType = outcome.changeType;
     logger.info(`${isUpgrade ? "[^]" : "[v]"}  ${changeType}: ${currentVersion} -> ${targetVersion}`);
     if (opts.check) {
       note(`CLI update available: ${currentVersion} -> ${targetVersion}
@@ -59314,71 +59468,19 @@ Run 'ck update' to install`, "Update Check");
     }
     const updateCmd = packageManagerDetector.getUpdateCommand(pm, CLAUDEKIT_CLI_NPM_PACKAGE_NAME, targetVersion, registryUrl);
     logger.info(`Running: ${redactCommandForLog(updateCmd)}`);
-    s.start("Updating CLI...");
-    try {
-      await execAsyncFn(updateCmd, {
-        timeout: 120000
-      });
-      s.stop("Update completed");
-    } catch (error) {
-      s.stop("Update failed");
-      const errorMessage = error instanceof Error ? error.message : "Unknown error";
-      if (errorMessage.includes("EACCES") || errorMessage.includes("EPERM") || errorMessage.includes("permission") || errorMessage.includes("Access is denied")) {
-        const permHint = pm === "npm" ? `
-
-Or fix npm permissions: https://docs.npmjs.com/resolving-eacces-permissions-errors-when-installing-packages-globally` : "";
-        const isWindows3 = process.platform === "win32";
-        const elevationHint = isWindows3 ? `Run your terminal as Administrator and retry: ${updateCmd}` : `sudo ${updateCmd}`;
-        throw new CliUpdateError(`Permission denied. Try: ${elevationHint}${permHint}`);
-      }
-      logger.error(`Update failed: ${errorMessage}`);
-      logger.info(`Try running: ${redactCommandForLog(updateCmd)}`);
-      throw new CliUpdateError(`Update failed: ${errorMessage}
-
-Manual update: ${updateCmd}`);
-    }
-    s.start("Verifying installation...");
-    try {
-      const versionResult = await execAsyncFn("ck --version", { timeout: 5000 });
-      const stdout = extractCommandStdout(versionResult);
-      const activeVersion = parseCliVersionFromOutput(stdout);
-      if (!activeVersion) {
-        s.stop("Verification failed");
-        const message = `Update completed but could not parse 'ck --version' output.
-Please restart your terminal and run 'ck --version'. Expected: ${targetVersion}
-
-Manual update: ${redactCommandForLog(updateCmd)}`;
-        logger.error(message);
-        throw new CliUpdateError(message);
-      }
-      s.stop(`Installed version: ${activeVersion}`);
-      if (activeVersion !== targetVersion) {
-        const mismatchMessage = `Update did not activate the requested version.
-Expected: ${targetVersion}
-Active ck: ${activeVersion}
-
-Likely causes: multiple global installations (npm/bun/pnpm/yarn) or stale shell shim/cache (common on Windows).
-Run '${redactCommandForLog(updateCmd)}' manually, restart terminal, then check command resolution:
-- Windows: where ck
-- macOS/Linux: which -a ck`;
-        logger.error(mismatchMessage);
-        throw new CliUpdateError(mismatchMessage);
-      }
-      outro(`[+] Successfully updated ClaudeKit CLI to ${activeVersion}`);
-      await promptKitUpdateFn(targetIsPrerelease, opts.yes);
-      await promptMigrateUpdateFn();
-    } catch (error) {
-      if (error instanceof CliUpdateError) {
-        throw error;
-      }
-      s.stop("Verification failed");
-      const message = `Update completed but automatic verification failed.
-Please restart your terminal and run 'ck --version'. Expected: ${targetVersion}
-
-Manual update: ${redactCommandForLog(updateCmd)}`;
-      logger.error(message);
-      throw new CliUpdateError(message);
-    }
+    await runPackageManagerUpdate(updateCmd, pm, {
+      execAsyncFn,
+      spinnerStart: (msg) => s.start(msg),
+      spinnerStop: (msg) => s.stop(msg)
+    });
+    const activeVersion = await verifyInstalledVersion(targetVersion, updateCmd, {
+      execAsyncFn,
+      spinnerStart: (msg) => s.start(msg),
+      spinnerStop: (msg) => s.stop(msg)
+    });
+    outro(`[+] Successfully updated ClaudeKit CLI to ${activeVersion}`);
+    await promptKitUpdateFn(targetIsPrerelease, opts.yes);
+    await promptMigrateUpdateFn();
   } catch (error) {
     if (error instanceof CliUpdateError) {
       throw error;
@@ -59388,30 +59490,24 @@ Manual update: ${redactCommandForLog(updateCmd)}`;
     throw new CliUpdateError(errorMessage);
   }
 }
-var import_compare_versions3, import_fs_extra5, execAsync2, CliUpdateError, SAFE_PROVIDER_NAME;
 var init_update_cli = __esm(() => {
-  init_ck_config_manager();
   init_npm_registry();
   init_package_manager_detector();
-  init_metadata_migration();
-  init_version_utils();
-  init_claudekit_scanner();
   init_claudekit_constants();
   init_logger();
   init_safe_prompts();
   init_types3();
-  init_types3();
   init_package();
-  import_compare_versions3 = __toESM(require_umd(), 1);
-  import_fs_extra5 = __toESM(require_lib3(), 1);
-  execAsync2 = promisify8(exec2);
-  CliUpdateError = class CliUpdateError extends ClaudeKitError {
-    constructor(message) {
-      super(message, "CLI_UPDATE_ERROR");
-      this.name = "CliUpdateError";
-    }
-  };
-  SAFE_PROVIDER_NAME = /^[a-z0-9-]+$/;
+  init_channel_resolver();
+  init_error();
+  init_package_manager_runner();
+  init_post_update_handler();
+  init_registry_client();
+  init_version_comparator();
+  init_error();
+  init_version_comparator();
+  init_post_update_handler();
+  init_registry_client();
 });
 
 // src/domains/versioning/version-cache.ts