claudekit-cli 3.40.0 → 3.40.1-dev.1

package/README.md

@@ -6,7 +6,7 @@ Command-line tool and web dashboard for managing ClaudeKit projects.
 
 ## Overview
 
-ClaudeKit Config UI (`ck`) provides both CLI and web dashboard for managing ClaudeKit projects. Built with Bun, TypeScript, and React, enables fast, secure project setup and comprehensive configuration management.
+ClaudeKit Config UI (`ck`) provides both CLI and web dashboard for managing ClaudeKit projects. It is built with Bun, TypeScript, and React for development, while the published CLI runs on plain Node.js so end users do not need Bun installed.
 
 **Key Features:**
 - **CLI Commands (16)**: new, init, config, projects, setup, skills, agents, commands, migrate, doctor, versions, update, uninstall, watch, content, easter-egg
@@ -50,6 +50,8 @@ Without a purchased kit and repository access, the CLI will not be able to downl
 
 The ClaudeKit CLI is published on npm at [npmjs.com/package/claudekit-cli](https://www.npmjs.com/package/claudekit-cli).
 
+End-user runtime note: global installs from `npm`, `pnpm`, `yarn`, or `bun` all execute the packaged Node.js CLI. Bun is optional for users and only needed for local ClaudeKit CLI development workflows.
+
 ### Using npm (Recommended)
 
 ```bash

package/bin/ck.js

@@ -1,22 +1,21 @@
 #!/usr/bin/env node
 
 /**
- * CLI entry point — runs dist/index.js via Bun (preferred) or Node.js (fallback).
- * This is the file NPM symlinks to when installing globally.
+ * CLI entry point for npm-installed ClaudeKit CLI.
+ * Runs the packaged Node-targeted bundle without requiring Bun on user machines.
  */
 
-import { execSync, spawnSync } from "node:child_process";
-import { existsSync, readFileSync } from "node:fs";
+import { existsSync } from "node:fs";
 import { dirname, join } from "node:path";
 import { fileURLToPath, pathToFileURL } from "node:url";
 
-// Minimum required Node.js version (major.minor)
 const MIN_NODE_VERSION = [18, 0];
+const __dirname = dirname(fileURLToPath(import.meta.url));
+
+const getErrorMessage = (err) => {
+	return err instanceof Error ? err.message : String(err);
+};
 
-/**
- * Check if the current Node.js version meets minimum requirements.
- * Required because dependencies like ora@8 use ES2022+ features.
- */
 const checkNodeVersion = () => {
 	const [major, minor] = process.versions.node.split(".").map(Number);
 	const [minMajor, minMinor] = MIN_NODE_VERSION;
@@ -30,136 +29,26 @@ const checkNodeVersion = () => {
 	}
 };
 
-// Check Node.js version before proceeding
-checkNodeVersion();
-
-const __dirname = dirname(fileURLToPath(import.meta.url));
-
-/**
- * Extract error message safely with type guard
- */
-const getErrorMessage = (err) => {
-	return err instanceof Error ? err.message : String(err);
-};
-
-/**
- * Check if bun runtime is available on the system.
- * dist/index.js may contain bun-specific imports (bun:sqlite) that Node.js can't handle.
- * Result is cached to avoid repeated execSync calls.
- */
-let _bunAvailable = undefined;
-const hasBun = () => {
-	if (_bunAvailable !== undefined) return _bunAvailable;
-	try {
-		execSync("bun --version", { stdio: "ignore", timeout: 3000 });
-		_bunAvailable = true;
-	} catch {
-		_bunAvailable = false;
-	}
-	return _bunAvailable;
-};
-
-let _installedVersion = undefined;
-const readInstalledPackageVersion = () => {
-	if (_installedVersion !== undefined) return _installedVersion;
-	try {
-		const packageJsonPath = join(__dirname, "..", "package.json");
-		const packageJson = JSON.parse(readFileSync(packageJsonPath, "utf8"));
-		_installedVersion = typeof packageJson.version === "string" ? packageJson.version : null;
-	} catch {
-		_installedVersion = null;
-	}
-	return _installedVersion;
-};
-
-const isDevPrerelease = () => {
-	const version = readInstalledPackageVersion();
-	return typeof version === "string" && /-dev\.\d+$/i.test(version);
-};
-
-const shouldWarnForBunFallback = () => !isDevPrerelease();
-
-/**
- * Run CLI via bun runtime. Preferred over Node.js when dist/index.js contains
- * bun-specific imports (e.g., bun:sqlite) that the Node.js ESM loader rejects.
- * Uses spawnSync to hand full terminal control to bun — this prevents Unicode
- * rendering issues (garbled @clack/prompts box-drawing chars) that occur when
- * bun runs as an async child of a Node.js parent process.
- * @param {boolean} showWarning - Whether to show runtime info message
- * @returns {boolean} true if bun ran successfully, false if spawn failed
- */
-const runWithBun = (showWarning = false) => {
+const runWithNode = async () => {
 	const distPath = join(__dirname, "..", "dist", "index.js");
 	if (!existsSync(distPath)) {
-		throw new Error("Compiled distribution not found. This may indicate a packaging issue.");
-	}
-	if (showWarning) {
-		console.error("[i] Using bun runtime");
-	}
-	const result = spawnSync("bun", [distPath, ...process.argv.slice(2)], {
-		stdio: "inherit",
-		windowsHide: true,
-	});
-	if (result.error) {
-		// bun spawn failed (e.g., ENOENT) — caller handles fallback
-		return false;
-	}
-	if (result.signal) {
-		process.kill(process.pid, result.signal);
+		throw new Error(
+			"Compiled distribution not found. Reinstall ClaudeKit CLI or report a packaging issue.",
+		);
 	}
-	process.exit(result.status || 0);
-};
 
-/**
- * Run CLI via Node.js as last-resort fallback (slower, no bun: protocol support).
- * @param {boolean} showWarning - Whether to show fallback warning message
- */
-const runWithNode = async (showWarning = false) => {
-	const distPath = join(__dirname, "..", "dist", "index.js");
-	if (!existsSync(distPath)) {
-		throw new Error("Compiled distribution not found. This may indicate a packaging issue.");
-	}
-	if (showWarning) {
-		console.error("[i] Using Node.js runtime (slower startup)");
-	}
 	const distUrl = pathToFileURL(distPath).href;
-	try {
-		await import(distUrl);
-	} catch (importErr) {
-		throw new Error(`Failed to load CLI module: ${getErrorMessage(importErr)}`);
-	}
+	await import(distUrl);
 };
 
-/**
- * Main execution — try Bun first, fall back to Node.js
- */
 const main = async () => {
-	const showBunWarning = shouldWarnForBunFallback();
-
-	// Prefer bun — dist/index.js may contain bun-specific imports (bun:sqlite)
-	if (hasBun()) {
-		const bunOk = runWithBun(false);
-		if (!bunOk && showBunWarning) {
-			console.error("[i] Bun spawn failed, falling back to Node.js");
-		}
-	}
+	checkNodeVersion();
 
-	// Last resort: Node.js (works for stable builds without bun: imports)
 	try {
-		await runWithNode(showBunWarning);
+		await runWithNode();
 	} catch (err) {
-		const errMsg = getErrorMessage(err);
-		console.error(`[X] Failed to run CLI: ${errMsg}`);
-		if (errMsg.includes("bun:") || errMsg.includes("Received protocol")) {
-			console.error("");
-			console.error("This version of ClaudeKit CLI requires the bun runtime.");
-			console.error("Install bun:  curl -fsSL https://bun.sh/install | bash");
-			console.error("Or switch to stable:  npm install -g claudekit-cli@latest");
-		} else {
-			console.error(
-				"Please report this issue at: https://github.com/mrgoonie/claudekit-cli/issues",
-			);
-		}
+		console.error(`[X] Failed to run CLI: ${getErrorMessage(err)}`);
+		console.error("Please report this issue at: https://github.com/mrgoonie/claudekit-cli/issues");
 		process.exit(1);
 	}
 };

package/dist/index.js

@@ -49974,13 +49974,14 @@ var init_config_discovery = __esm(() => {
 
 // src/commands/portable/hooks-settings-merger.ts
 import { existsSync as existsSync22, mkdirSync, renameSync, rmSync, writeFileSync as writeFileSync2 } from "node:fs";
+import { readFile as readFile17 } from "node:fs/promises";
 import { basename as basename8, dirname as dirname9, join as join32 } from "node:path";
 async function inspectHooksSettings(settingsPath) {
   try {
     if (!existsSync22(settingsPath)) {
       return { status: "missing-file" };
     }
-    const raw = await Bun.file(settingsPath).text();
+    const raw = await readFile17(settingsPath, "utf8");
     const parsed = JSON.parse(raw);
     if (!parsed.hooks || typeof parsed.hooks !== "object") {
       return { status: "missing-hooks" };
@@ -50052,7 +50053,7 @@ async function mergeHooksIntoSettings(targetSettingsPath, newHooks) {
   if (existsSync22(targetSettingsPath)) {
     let raw;
     try {
-      raw = await Bun.file(targetSettingsPath).text();
+      raw = await readFile17(targetSettingsPath, "utf8");
       existingSettings = JSON.parse(raw);
     } catch {
       existingSettings = {};
@@ -52035,7 +52036,7 @@ var require_semver2 = __commonJS((exports, module) => {
 
 // src/commands/portable/portable-manifest.ts
 import { existsSync as existsSync23 } from "node:fs";
-import { readFile as readFile17 } from "node:fs/promises";
+import { readFile as readFile18 } from "node:fs/promises";
 import path2 from "node:path";
 async function loadPortableManifest(kitPath) {
   const manifestPath = path2.join(kitPath, "portable-manifest.json");
@@ -52044,7 +52045,7 @@ async function loadPortableManifest(kitPath) {
       logger.verbose("No portable-manifest.json found — no evolution tracking");
       return null;
     }
-    const raw = await readFile17(manifestPath, "utf-8");
+    const raw = await readFile18(manifestPath, "utf-8");
     let parsed;
     try {
       parsed = JSON.parse(raw);
@@ -52155,7 +52156,7 @@ var init_reconcile_registry_backfill = __esm(() => {
 
 // src/commands/portable/reconcile-state-builders.ts
 import { existsSync as existsSync24 } from "node:fs";
-import { readFile as readFile18 } from "node:fs/promises";
+import { readFile as readFile19 } from "node:fs/promises";
 function getProviderPathKeyForPortableType2(type) {
   switch (type) {
     case "agent":
@@ -52265,7 +52266,7 @@ async function buildTargetStates(entries, options2) {
     const state = { path: entryPath, exists };
     if (exists) {
       try {
-        const content = await readFile18(entryPath, "utf-8");
+        const content = await readFile19(entryPath, "utf-8");
         state.currentChecksum = computeContentChecksum(content);
         if (groupedEntries.some((entry) => usesMergeSingleChecksums(entry))) {
           state.sectionChecksums = computeManagedSectionChecksums(content);
@@ -52752,7 +52753,7 @@ var init_reconciler = __esm(() => {
 
 // src/commands/skills/skills-discovery.ts
 import { existsSync as existsSync25 } from "node:fs";
-import { readFile as readFile19, readdir as readdir8, stat as stat6 } from "node:fs/promises";
+import { readFile as readFile20, readdir as readdir8, stat as stat6 } from "node:fs/promises";
 import { homedir as homedir20 } from "node:os";
 import { dirname as dirname10, join as join33 } from "node:path";
 function getSkillSourcePath() {
@@ -52782,7 +52783,7 @@ async function hasSkillMd(dir) {
 }
 async function parseSkillMd(skillMdPath) {
   try {
-    const content = await readFile19(skillMdPath, "utf-8");
+    const content = await readFile20(skillMdPath, "utf-8");
     const { data } = import_gray_matter5.default(content);
     const skillDir = dirname10(skillMdPath);
     const dirName = skillDir.split(/[/\\]/).pop() || "";
@@ -52943,7 +52944,7 @@ var init_migration_result_utils = __esm(() => {
 
 // src/domains/web-server/routes/migration-routes.ts
 import { existsSync as existsSync26 } from "node:fs";
-import { readFile as readFile20, rm as rm6 } from "node:fs/promises";
+import { readFile as readFile21, rm as rm6 } from "node:fs/promises";
 import { homedir as homedir21 } from "node:os";
 import { basename as basename9, join as join34, resolve as resolve8 } from "node:path";
 function isDisallowedControlCode(codePoint) {
@@ -53608,9 +53609,9 @@ function registerMigrationRoutes(app) {
           const readmePath = `${skill.path}/README.md`;
           let content;
           if (existsSync26(skillMdPath)) {
-            content = await readFile20(skillMdPath, "utf-8");
+            content = await readFile21(skillMdPath, "utf-8");
           } else if (existsSync26(readmePath)) {
-            content = await readFile20(readmePath, "utf-8");
+            content = await readFile21(readmePath, "utf-8");
           } else {
             console.warn(`[migrate] Skill "${sanitizeUntrusted(skill.name, 80)}" has neither SKILL.md nor README.md, skipping`);
             continue;
@@ -55063,7 +55064,7 @@ var init_plan_routes = __esm(() => {
 
 // src/domains/web-server/routes/project-routes.ts
 import { existsSync as existsSync31 } from "node:fs";
-import { readFile as readFile21 } from "node:fs/promises";
+import { readFile as readFile22 } from "node:fs/promises";
 import { homedir as homedir22 } from "node:os";
 import { basename as basename13, join as join37, resolve as resolve11 } from "node:path";
 function registerProjectRoutes(app) {
@@ -55305,7 +55306,7 @@ async function buildProjectInfoFromRegistry(registered) {
   let metadata = {};
   try {
     if (hasClaudeDir && existsSync31(metadataPath)) {
-      const content = await readFile21(metadataPath, "utf-8");
+      const content = await readFile22(metadataPath, "utf-8");
       try {
         metadata = JSON.parse(content);
       } catch {}
@@ -55347,7 +55348,7 @@ async function detectAndBuildProjectInfo(path4, id) {
   let metadata = {};
   try {
     if (existsSync31(metadataPath)) {
-      const content = await readFile21(metadataPath, "utf-8");
+      const content = await readFile22(metadataPath, "utf-8");
       try {
         metadata = JSON.parse(content);
       } catch {}
@@ -55681,7 +55682,7 @@ var init_agents = __esm(() => {
 
 // src/commands/skills/skills-registry.ts
 import { existsSync as existsSync33 } from "node:fs";
-import { mkdir as mkdir9, readFile as readFile22, writeFile as writeFile11 } from "node:fs/promises";
+import { mkdir as mkdir9, readFile as readFile23, writeFile as writeFile11 } from "node:fs/promises";
 import { homedir as homedir26 } from "node:os";
 import { dirname as dirname16, join as join40, sep as sep5 } from "node:path";
 function getCliVersion3() {
@@ -55718,7 +55719,7 @@ async function readRegistry() {
     if (!existsSync33(REGISTRY_PATH2)) {
       return { version: "1.0", installations: [] };
     }
-    const content = await readFile22(REGISTRY_PATH2, "utf-8");
+    const content = await readFile23(REGISTRY_PATH2, "utf-8");
     const data = JSON.parse(content);
     const registry = SkillRegistrySchema.parse(data);
     if (migrateRegistryPaths(registry)) {
@@ -56555,7 +56556,7 @@ var init_pnpm_detector = __esm(() => {
 
 // src/domains/installation/package-managers/detection-core.ts
 import { existsSync as existsSync36, realpathSync as realpathSync2 } from "node:fs";
-import { chmod as chmod2, mkdir as mkdir11, readFile as readFile23, writeFile as writeFile12 } from "node:fs/promises";
+import { chmod as chmod2, mkdir as mkdir11, readFile as readFile24, writeFile as writeFile12 } from "node:fs/promises";
 import { platform as platform4 } from "node:os";
 import { join as join43 } from "node:path";
 function detectFromBinaryPath() {
@@ -56638,7 +56639,7 @@ async function readCachedPm() {
     if (!existsSync36(cacheFile)) {
       return null;
     }
-    const content = await readFile23(cacheFile, "utf-8");
+    const content = await readFile24(cacheFile, "utf-8");
     const data = JSON.parse(content);
     if (!data.packageManager || !data.detectedAt) {
       logger.debug("Invalid cache structure, ignoring");
@@ -57328,7 +57329,7 @@ var package_default;
 var init_package = __esm(() => {
   package_default = {
     name: "claudekit-cli",
-    version: "3.39.3-dev.8",
+    version: "3.40.1-dev.1",
     description: "CLI tool for bootstrapping and updating ClaudeKit projects",
     type: "module",
     repository: {
@@ -57352,7 +57353,7 @@ var init_package = __esm(() => {
       "dashboard:dev": "cd src/ui && bun install --silent && cd ../.. && bun run src/index.ts config ui --dev",
       "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 && node -e "const fs=require('fs'),f='dist/index.js',c=fs.readFileSync(f,'utf-8');fs.writeFileSync(f,c.replace(/^#!.*\\n\\/\\/ @bun\\n/,''))"`,
+      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",
@@ -57380,7 +57381,6 @@ var init_package = __esm(() => {
     author: "ClaudeKit",
     license: "MIT",
     engines: {
-      bun: ">=1.3.2",
       node: ">=18.0.0"
     },
     dependencies: {
@@ -57880,7 +57880,7 @@ var init_error_handler2 = __esm(() => {
 
 // src/domains/versioning/release-cache.ts
 import { existsSync as existsSync37 } from "node:fs";
-import { mkdir as mkdir12, readFile as readFile26, unlink as unlink6, writeFile as writeFile14 } from "node:fs/promises";
+import { mkdir as mkdir12, readFile as readFile27, unlink as unlink6, writeFile as writeFile14 } from "node:fs/promises";
 import { join as join46 } from "node:path";
 var ReleaseCacheEntrySchema, ReleaseCache;
 var init_release_cache = __esm(() => {
@@ -57905,7 +57905,7 @@ var init_release_cache = __esm(() => {
           logger.debug(`Release cache not found for key: ${key}`);
           return null;
         }
-        const content = await readFile26(cacheFile, "utf-8");
+        const content = await readFile27(cacheFile, "utf-8");
         const parsed = JSON.parse(content);
         const cacheEntry = ReleaseCacheEntrySchema.parse(parsed);
         if (this.isExpired(cacheEntry.timestamp)) {
@@ -58931,8 +58931,7 @@ async function updateCliCommand(options2, deps = getDefaultUpdateCliCommandDeps(
     }
     s.start("Checking for updates...");
     let targetVersion = null;
-    const preferInstalledPrereleaseChannel = !opts.release && !(opts.dev || opts.beta) && isPrereleaseVersion(currentVersion);
-    const usePrereleaseChannel = opts.dev || opts.beta || preferInstalledPrereleaseChannel;
+    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);
@@ -59108,7 +59107,7 @@ var init_update_cli = __esm(() => {
 
 // src/domains/versioning/version-cache.ts
 import { existsSync as existsSync38 } from "node:fs";
-import { mkdir as mkdir13, readFile as readFile28, writeFile as writeFile15 } from "node:fs/promises";
+import { mkdir as mkdir13, readFile as readFile29, writeFile as writeFile15 } from "node:fs/promises";
 import { join as join48 } from "node:path";
 var VersionCacheManager;
 var init_version_cache = __esm(() => {
@@ -59128,7 +59127,7 @@ var init_version_cache = __esm(() => {
           logger.debug("Version check cache not found");
           return null;
         }
-        const content = await readFile28(cacheFile, "utf-8");
+        const content = await readFile29(cacheFile, "utf-8");
         const cache3 = JSON.parse(content);
         if (!cache3.lastCheck || !cache3.currentVersion || !cache3.latestVersion) {
           logger.debug("Invalid cache structure, ignoring");
@@ -59249,7 +59248,7 @@ class CliVersionChecker {
       return null;
     }
     try {
-      const latestVersion = isPrereleaseVersion(currentVersion) ? await NpmRegistryClient.getDevVersion(CLAUDEKIT_CLI_NPM_PACKAGE_NAME) ?? await NpmRegistryClient.getLatestVersion(CLAUDEKIT_CLI_NPM_PACKAGE_NAME) : await NpmRegistryClient.getLatestVersion(CLAUDEKIT_CLI_NPM_PACKAGE_NAME);
+      const latestVersion = await NpmRegistryClient.getLatestVersion(CLAUDEKIT_CLI_NPM_PACKAGE_NAME);
       if (!latestVersion) {
         logger.debug("Failed to fetch latest CLI version from npm");
         return null;
@@ -59387,7 +59386,7 @@ var init_version_checker = __esm(() => {
 // src/domains/web-server/routes/system-routes.ts
 import { spawn as spawn3 } from "node:child_process";
 import { existsSync as existsSync39 } from "node:fs";
-import { readFile as readFile29 } from "node:fs/promises";
+import { readFile as readFile30 } from "node:fs/promises";
 import { join as join49 } from "node:path";
 function hasCliUpdate(currentVersion, latestVersion) {
   if (!latestVersion) {
@@ -59634,7 +59633,7 @@ async function getKitMetadata2(kitName) {
     const metadataPath = join49(PathResolver.getGlobalKitDir(), "metadata.json");
     if (!existsSync39(metadataPath))
       return null;
-    const content = await readFile29(metadataPath, "utf-8");
+    const content = await readFile30(metadataPath, "utf-8");
     const metadata = JSON.parse(content);
     if (metadata.kits?.[kitName]) {
       return { version: metadata.kits[kitName].version };
@@ -65088,8 +65087,8 @@ async function installSkillsDependencies(skillsDir2, options2 = {}) {
     logger.info(`  Platform: ${platform7 === "win32" ? "Windows (PowerShell)" : "Unix (bash)"}`);
     if (logger.isVerbose()) {
       try {
-        const { readFile: readFile36 } = await import("node:fs/promises");
-        const scriptContent = await readFile36(scriptPath, "utf-8");
+        const { readFile: readFile37 } = await import("node:fs/promises");
+        const scriptContent = await readFile37(scriptPath, "utf-8");
         const previewLines = scriptContent.split(`
 `).slice(0, 20);
         logger.verbose("Script preview (first 20 lines):");
@@ -65285,11 +65284,11 @@ var init_skills_installer2 = __esm(() => {
 
 // src/services/package-installer/gemini-mcp/config-manager.ts
 import { existsSync as existsSync52 } from "node:fs";
-import { mkdir as mkdir17, readFile as readFile36, writeFile as writeFile20 } from "node:fs/promises";
+import { mkdir as mkdir17, readFile as readFile37, writeFile as writeFile20 } from "node:fs/promises";
 import { dirname as dirname21, join as join71 } from "node:path";
 async function readJsonFile(filePath) {
   try {
-    const content = await readFile36(filePath, "utf-8");
+    const content = await readFile37(filePath, "utf-8");
     return JSON.parse(content);
   } catch (error) {
     const errorMessage = error instanceof Error ? error.message : "Unknown error";
@@ -65303,7 +65302,7 @@ async function addGeminiToGitignore(projectDir) {
   try {
     let content = "";
     if (existsSync52(gitignorePath)) {
-      content = await readFile36(gitignorePath, "utf-8");
+      content = await readFile37(gitignorePath, "utf-8");
       const lines = content.split(`
 `).map((line) => line.trim()).filter((line) => !line.startsWith("#"));
       const geminiPatterns = [".gemini/", ".gemini", "/.gemini/", "/.gemini"];
@@ -67872,7 +67871,7 @@ __export(exports_worktree_manager, {
   cleanupAllWorktrees: () => cleanupAllWorktrees
 });
 import { existsSync as existsSync62 } from "node:fs";
-import { readFile as readFile53, writeFile as writeFile33 } from "node:fs/promises";
+import { readFile as readFile54, writeFile as writeFile33 } from "node:fs/promises";
 import { join as join124 } from "node:path";
 async function createWorktree(projectDir, issueNumber, baseBranch) {
   const worktreePath = join124(projectDir, WORKTREE_DIR, `issue-${issueNumber}`);
@@ -67937,7 +67936,7 @@ async function cleanupAllWorktrees(projectDir) {
 async function ensureGitignore(projectDir) {
   const gitignorePath = join124(projectDir, ".gitignore");
   try {
-    const content = existsSync62(gitignorePath) ? await readFile53(gitignorePath, "utf-8") : "";
+    const content = existsSync62(gitignorePath) ? await readFile54(gitignorePath, "utf-8") : "";
     if (!content.includes(".worktrees")) {
       const newContent = content.endsWith(`
 `) ? `${content}.worktrees/
@@ -68785,13 +68784,19 @@ var init_content_logger = __esm(() => {
   ];
 });
 
+// src/commands/content/phases/sqlite-client.ts
+import BetterSqlite3 from "better-sqlite3";
+function openDatabase(dbPath) {
+  return new BetterSqlite3(dbPath);
+}
+var init_sqlite_client = () => {};
+
 // src/commands/content/phases/db-manager.ts
-import { Database } from "bun:sqlite";
 import { existsSync as existsSync72, mkdirSync as mkdirSync7 } from "node:fs";
 import { dirname as dirname33 } from "node:path";
 function initDatabase(dbPath) {
   ensureParentDir(dbPath);
-  const db = new Database(dbPath, { create: true });
+  const db = openDatabase(dbPath);
   db.exec("PRAGMA journal_mode = WAL");
   db.exec("PRAGMA busy_timeout = 5000");
   runMigrations(db);
@@ -68919,7 +68924,9 @@ var SCHEMA_V1 = `
 `, SCHEMA_V2_RETRY_COUNT = `
 	ALTER TABLE git_events ADD COLUMN retry_count INTEGER NOT NULL DEFAULT 0;
 `;
-var init_db_manager = () => {};
+var init_db_manager = __esm(() => {
+  init_sqlite_client();
+});
 
 // src/commands/content/phases/engagement-tracker.ts
 async function trackEngagement(db, adapters, config, contentLogger) {
@@ -69839,12 +69846,12 @@ var init_types6 = __esm(() => {
 });
 
 // src/commands/content/phases/state-manager.ts
-import { readFile as readFile55, rename as rename10, writeFile as writeFile36 } from "node:fs/promises";
+import { readFile as readFile56, rename as rename10, writeFile as writeFile36 } from "node:fs/promises";
 import { join as join137 } from "node:path";
 async function loadContentConfig(projectDir) {
   const configPath = join137(projectDir, CK_CONFIG_FILE2);
   try {
-    const raw2 = await readFile55(configPath, "utf-8");
+    const raw2 = await readFile56(configPath, "utf-8");
     const json = JSON.parse(raw2);
     return ContentConfigSchema.parse(json.content ?? {});
   } catch {
@@ -69860,7 +69867,7 @@ async function saveContentConfig(projectDir, config) {
 async function loadContentState(projectDir) {
   const configPath = join137(projectDir, CK_CONFIG_FILE2);
   try {
-    const raw2 = await readFile55(configPath, "utf-8");
+    const raw2 = await readFile56(configPath, "utf-8");
     const json = JSON.parse(raw2);
     const contentBlock = json.content ?? {};
     return ContentStateSchema.parse(contentBlock.state ?? {});
@@ -69887,7 +69894,7 @@ async function saveContentState(projectDir, state) {
 }
 async function readJsonSafe(filePath) {
   try {
-    const raw2 = await readFile55(filePath, "utf-8");
+    const raw2 = await readFile56(filePath, "utf-8");
     return JSON.parse(raw2);
   } catch {
     return {};
@@ -71107,7 +71114,7 @@ var init_update_command_help = __esm(() => {
     sections: [
       {
         title: "Note",
-        content: "'ck update' updates the CLI tool only. To update kit content (skills, commands, rules), use 'ck init' for local or 'ck init -g' for global. Use --yes to skip all prompts (both CLI and kit content update) for non-interactive/CI usage."
+        content: "'ck update' updates the CLI tool only and defaults to the latest stable release. Use '--beta' to opt into prerelease CLI builds. To update kit content (skills, commands, rules), use 'ck init' for local or 'ck init -g' for global. Use --yes to skip all prompts (both CLI and kit content update) for non-interactive/CI usage."
       }
     ]
   };
@@ -76959,7 +76966,7 @@ async function checkHooksExist(projectDir) {
 init_logger();
 init_path_resolver();
 import { existsSync as existsSync46 } from "node:fs";
-import { readFile as readFile30 } from "node:fs/promises";
+import { readFile as readFile31 } from "node:fs/promises";
 import { join as join56 } from "node:path";
 async function checkSettingsValid(projectDir) {
   const globalSettings = join56(PathResolver.getGlobalKitDir(), "settings.json");
@@ -76977,7 +76984,7 @@ async function checkSettingsValid(projectDir) {
     };
   }
   try {
-    const content = await readFile30(settingsPath, "utf-8");
+    const content = await readFile31(settingsPath, "utf-8");
     JSON.parse(content);
     return {
       id: "ck-settings-valid",
@@ -77034,7 +77041,7 @@ async function checkSettingsValid(projectDir) {
 init_logger();
 init_path_resolver();
 import { existsSync as existsSync47 } from "node:fs";
-import { readFile as readFile31 } from "node:fs/promises";
+import { readFile as readFile32 } from "node:fs/promises";
 import { homedir as homedir28 } from "node:os";
 import { dirname as dirname19, join as join57, normalize as normalize5, resolve as resolve14 } from "node:path";
 async function checkPathRefsValid(projectDir) {
@@ -77053,7 +77060,7 @@ async function checkPathRefsValid(projectDir) {
     };
   }
   try {
-    const content = await readFile31(claudeMdPath, "utf-8");
+    const content = await readFile32(claudeMdPath, "utf-8");
     const refPattern = /@([^\s\)]+)/g;
     const refs = [...content.matchAll(refPattern)].map((m2) => m2[1]);
     if (refs.length === 0) {
@@ -78696,7 +78703,7 @@ import { platform as platform6 } from "node:os";
 // src/domains/health-checks/platform/environment-checker.ts
 init_environment();
 init_path_resolver();
-import { constants as constants3, access as access3, mkdir as mkdir14, readFile as readFile33, unlink as unlink8, writeFile as writeFile17 } from "node:fs/promises";
+import { constants as constants3, access as access3, mkdir as mkdir14, readFile as readFile34, unlink as unlink8, writeFile as writeFile17 } from "node:fs/promises";
 import { arch as arch2, homedir as homedir29, platform as platform5 } from "node:os";
 import { join as join63, normalize as normalize6 } from "node:path";
 function shouldSkipExpensiveOperations4() {
@@ -78793,7 +78800,7 @@ async function checkGlobalDirAccess() {
   try {
     await mkdir14(globalDir, { recursive: true });
     await writeFile17(testFile, "test", "utf-8");
-    const content = await readFile33(testFile, "utf-8");
+    const content = await readFile34(testFile, "utf-8");
     await unlink8(testFile);
     if (content !== "test")
       throw new Error("Read mismatch");
@@ -79686,7 +79693,7 @@ init_version_utils();
 init_claudekit_constants();
 init_logger();
 init_path_resolver();
-import { mkdir as mkdir16, readFile as readFile34, unlink as unlink10, writeFile as writeFile19 } from "node:fs/promises";
+import { mkdir as mkdir16, readFile as readFile35, unlink as unlink10, writeFile as writeFile19 } from "node:fs/promises";
 import { join as join66 } from "node:path";
 var CACHE_TTL_HOURS = 24;
 var DEFAULT_CACHE_TTL_MS = CACHE_TTL_HOURS * 60 * 60 * 1000;
@@ -79729,7 +79736,7 @@ class ConfigVersionChecker {
   static async loadCache(kitType, global3) {
     try {
       const cachePath = ConfigVersionChecker.getCacheFilePath(kitType, global3);
-      const data = await readFile34(cachePath, "utf8");
+      const data = await readFile35(cachePath, "utf8");
       const parsed = JSON.parse(data);
       if (typeof parsed !== "object" || parsed === null || typeof parsed.lastCheck !== "number" || typeof parsed.latestVersion !== "string" || !parsed.latestVersion || parsed.lastCheck < 0 || parsed.lastCheck > Date.now() + 7 * 24 * 60 * 60 * 1000) {
         logger.debug("Invalid cache structure, ignoring");
@@ -79886,7 +79893,7 @@ class ConfigVersionChecker {
   }
 }
 // src/domains/sync/sync-engine.ts
-import { lstat as lstat3, readFile as readFile35, readlink, realpath as realpath3, stat as stat9 } from "node:fs/promises";
+import { lstat as lstat3, readFile as readFile36, readlink, realpath as realpath3, stat as stat9 } from "node:fs/promises";
 import { isAbsolute as isAbsolute3, join as join67, normalize as normalize7, relative as relative8 } from "node:path";
 
 // src/services/file-operations/ownership-checker.ts
@@ -81470,7 +81477,7 @@ class SyncEngine {
       if (lstats.size > MAX_SYNC_FILE_SIZE) {
         throw new Error(`File too large for sync (${Math.round(lstats.size / 1024 / 1024)}MB > ${MAX_SYNC_FILE_SIZE / 1024 / 1024}MB limit)`);
       }
-      const buffer = await readFile35(filePath);
+      const buffer = await readFile36(filePath);
       if (buffer.includes(0)) {
         return { content: "", isBinary: true };
       }
@@ -92668,7 +92675,7 @@ import { execSync as execSync4 } from "node:child_process";
 // src/domains/config/installed-settings-tracker.ts
 init_shared();
 import { existsSync as existsSync56 } from "node:fs";
-import { mkdir as mkdir26, readFile as readFile39, writeFile as writeFile22 } from "node:fs/promises";
+import { mkdir as mkdir26, readFile as readFile40, writeFile as writeFile22 } from "node:fs/promises";
 import { dirname as dirname25, join as join87 } from "node:path";
 var CK_JSON_FILE = ".ck.json";
 
@@ -92693,7 +92700,7 @@ class InstalledSettingsTracker {
       return { hooks: [], mcpServers: [] };
     }
     try {
-      const content = await readFile39(ckJsonPath, "utf-8");
+      const content = await readFile40(ckJsonPath, "utf-8");
       const data = JSON.parse(content);
       const installed = data.kits?.[this.kitName]?.installedSettings;
       if (installed) {
@@ -92710,7 +92717,7 @@ class InstalledSettingsTracker {
     try {
       let data = {};
       if (existsSync56(ckJsonPath)) {
-        const content = await readFile39(ckJsonPath, "utf-8");
+        const content = await readFile40(ckJsonPath, "utf-8");
         data = JSON.parse(content);
       }
       if (!data.kits) {
@@ -94172,7 +94179,7 @@ import { join as join95 } from "node:path";
 
 // src/services/transformers/commands-prefix/content-transformer.ts
 init_logger();
-import { readFile as readFile43, readdir as readdir20, writeFile as writeFile26 } from "node:fs/promises";
+import { readFile as readFile44, readdir as readdir20, writeFile as writeFile26 } from "node:fs/promises";
 import { join as join94 } from "node:path";
 var TRANSFORMABLE_EXTENSIONS = new Set([
   ".md",
@@ -94242,7 +94249,7 @@ async function transformCommandReferences(directory, options2 = {}) {
         await processDirectory(fullPath);
       } else if (entry.isFile() && shouldTransformFile(entry.name)) {
         try {
-          const content = await readFile43(fullPath, "utf-8");
+          const content = await readFile44(fullPath, "utf-8");
           const { transformed, changes } = transformCommandContent(content);
           if (changes > 0) {
             if (options2.dryRun) {
@@ -94779,7 +94786,7 @@ init_skip_directories();
 init_types3();
 var import_fs_extra21 = __toESM(require_lib3(), 1);
 import { createHash as createHash4 } from "node:crypto";
-import { readFile as readFile45, readdir as readdir24, writeFile as writeFile27 } from "node:fs/promises";
+import { readFile as readFile46, readdir as readdir24, writeFile as writeFile27 } from "node:fs/promises";
 import { join as join99, relative as relative16 } from "node:path";
 
 class SkillsManifestManager {
@@ -94813,7 +94820,7 @@ class SkillsManifestManager {
       return null;
     }
     try {
-      const content = await readFile45(manifestPath, "utf-8");
+      const content = await readFile46(manifestPath, "utf-8");
       const data = JSON.parse(content);
       const manifest = SkillsManifestSchema.parse(data);
       logger.debug(`Read manifest from: ${manifestPath}`);
@@ -94885,7 +94892,7 @@ class SkillsManifestManager {
     files.sort();
     for (const file of files) {
       const relativePath = relative16(dirPath, file);
-      const content = await readFile45(file);
+      const content = await readFile46(file);
       hash.update(relativePath);
       hash.update(content);
     }
@@ -95625,7 +95632,7 @@ import { relative as relative18 } from "node:path";
 init_skip_directories();
 import { createHash as createHash5 } from "node:crypto";
 import { createReadStream as createReadStream3 } from "node:fs";
-import { readFile as readFile46, readdir as readdir28 } from "node:fs/promises";
+import { readFile as readFile47, readdir as readdir28 } from "node:fs/promises";
 import { join as join103, relative as relative17 } from "node:path";
 async function getAllFiles(dirPath) {
   const files = [];
@@ -95664,7 +95671,7 @@ async function hashDirectory(dirPath) {
   files.sort();
   for (const file of files) {
     const relativePath = relative17(dirPath, file);
-    const content = await readFile46(file);
+    const content = await readFile47(file);
     hash.update(relativePath);
     hash.update(content);
   }
@@ -95998,7 +96005,7 @@ import { join as join108 } from "node:path";
 
 // src/services/transformers/opencode-path-transformer.ts
 init_logger();
-import { readFile as readFile47, readdir as readdir30, writeFile as writeFile28 } from "node:fs/promises";
+import { readFile as readFile48, readdir as readdir30, writeFile as writeFile28 } from "node:fs/promises";
 import { platform as platform12 } from "node:os";
 import { extname as extname5, join as join107 } from "node:path";
 var IS_WINDOWS2 = platform12() === "win32";
@@ -96069,7 +96076,7 @@ async function transformPathsForGlobalOpenCode(directory, options2 = {}) {
         await processDirectory2(fullPath);
       } else if (entry.isFile() && shouldTransformFile2(entry.name)) {
         try {
-          const content = await readFile47(fullPath, "utf-8");
+          const content = await readFile48(fullPath, "utf-8");
           const { transformed, changes } = transformOpenCodeContent(content);
           if (changes > 0) {
             await writeFile28(fullPath, transformed, "utf-8");
@@ -96975,7 +96982,7 @@ async function handleSelection(ctx) {
   };
 }
 // src/commands/init/phases/sync-handler.ts
-import { copyFile as copyFile8, mkdir as mkdir31, open as open5, readFile as readFile49, rename as rename6, stat as stat17, unlink as unlink11, writeFile as writeFile30 } from "node:fs/promises";
+import { copyFile as copyFile8, mkdir as mkdir31, open as open5, readFile as readFile50, rename as rename6, stat as stat17, unlink as unlink11, writeFile as writeFile30 } from "node:fs/promises";
 import { dirname as dirname28, join as join112, resolve as resolve24 } from "node:path";
 init_logger();
 init_path_resolver();
@@ -97143,7 +97150,7 @@ async function executeSyncMerge(ctx) {
     try {
       const sourceMetadataPath = join112(upstreamDir, "metadata.json");
       if (await import_fs_extra33.pathExists(sourceMetadataPath)) {
-        const content = await readFile49(sourceMetadataPath, "utf-8");
+        const content = await readFile50(sourceMetadataPath, "utf-8");
         const sourceMetadata = JSON.parse(content);
         deletions = sourceMetadata.deletions || [];
       }
@@ -97441,7 +97448,7 @@ async function renameFolders(dirsToRename, extractDir, options2) {
 // src/services/transformers/folder-transform/path-replacer.ts
 init_logger();
 init_types3();
-import { readFile as readFile50, readdir as readdir32, writeFile as writeFile31 } from "node:fs/promises";
+import { readFile as readFile51, readdir as readdir32, writeFile as writeFile31 } from "node:fs/promises";
 import { join as join114, relative as relative20 } from "node:path";
 var TRANSFORMABLE_FILE_PATTERNS = [
   ".md",
@@ -97508,7 +97515,7 @@ async function transformFileContents(dir, compiledReplacements, options2) {
       if (!shouldTransform)
         continue;
       try {
-        const content = await readFile50(fullPath, "utf-8");
+        const content = await readFile51(fullPath, "utf-8");
         let newContent = content;
         let changeCount = 0;
         for (const { regex: regex2, replacement } of compiledReplacements) {
@@ -97630,7 +97637,7 @@ async function transformFolderPaths(extractDir, folders, options2 = {}) {
 
 // src/services/transformers/global-path-transformer.ts
 init_logger();
-import { readFile as readFile51, readdir as readdir33, writeFile as writeFile32 } from "node:fs/promises";
+import { readFile as readFile52, readdir as readdir33, writeFile as writeFile32 } from "node:fs/promises";
 import { platform as platform13 } from "node:os";
 import { extname as extname6, join as join115 } from "node:path";
 var IS_WINDOWS3 = platform13() === "win32";
@@ -97752,7 +97759,7 @@ async function transformPathsForGlobalInstall(directory, options2 = {}) {
         await processDirectory2(fullPath);
       } else if (entry.isFile() && shouldTransformFile3(entry.name)) {
         try {
-          const content = await readFile51(fullPath, "utf-8");
+          const content = await readFile52(fullPath, "utf-8");
           const { transformed, changes } = transformContent(content);
           if (changes > 0) {
             await writeFile32(fullPath, transformed, "utf-8");
@@ -98010,7 +98017,7 @@ async function initCommand(options2) {
 init_dist2();
 var import_picocolors28 = __toESM(require_picocolors(), 1);
 import { existsSync as existsSync58 } from "node:fs";
-import { readFile as readFile52, rm as rm15, unlink as unlink12 } from "node:fs/promises";
+import { readFile as readFile53, rm as rm15, unlink as unlink12 } from "node:fs/promises";
 import { homedir as homedir31 } from "node:os";
 import { basename as basename16, join as join117, resolve as resolve25 } from "node:path";
 init_logger();
@@ -98442,7 +98449,7 @@ async function processMetadataDeletions(skillSourcePath, installGlobally) {
     return;
   let sourceMetadata;
   try {
-    const content = await readFile52(sourceMetadataPath, "utf-8");
+    const content = await readFile53(sourceMetadataPath, "utf-8");
     sourceMetadata = JSON.parse(content);
   } catch (error) {
     logger.debug(`[migrate] Failed to parse source metadata.json: ${error}`);
@@ -98702,7 +98709,7 @@ async function migrateCommand(options2) {
       for (const action of conflictActions) {
         if (!action.diff && action.targetPath && existsSync58(action.targetPath)) {
           try {
-            const targetContent = await readFile52(action.targetPath, "utf-8");
+            const targetContent = await readFile53(action.targetPath, "utf-8");
             const sourceItem = agents2.find((a3) => a3.name === action.item) || commands.find((c2) => c2.name === action.item) || (configItem?.name === action.item ? configItem : null) || ruleItems.find((r2) => r2.name === action.item) || hookItems.find((h2) => h2.name === action.item);
             if (sourceItem) {
               const providerConfig = providers[action.provider];
@@ -102599,7 +102606,7 @@ init_ck_config_manager();
 init_file_io();
 init_logger();
 import { existsSync as existsSync63 } from "node:fs";
-import { mkdir as mkdir33, readFile as readFile54 } from "node:fs/promises";
+import { mkdir as mkdir33, readFile as readFile55 } from "node:fs/promises";
 import { dirname as dirname32 } from "node:path";
 var PROCESSED_ISSUES_CAP = 500;
 async function readCkJson(projectDir) {
@@ -102607,7 +102614,7 @@ async function readCkJson(projectDir) {
   try {
     if (!existsSync63(configPath))
       return {};
-    const content = await readFile54(configPath, "utf-8");
+    const content = await readFile55(configPath, "utf-8");
     return JSON.parse(content);
   } catch (error) {
     logger.warning(`Failed to parse .ck.json: ${error instanceof Error ? error.message : "Unknown"}`);

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "claudekit-cli",
-	"version": "3.40.0",
+	"version": "3.40.1-dev.1",
 	"description": "CLI tool for bootstrapping and updating ClaudeKit projects",
 	"type": "module",
 	"repository": {
@@ -24,7 +24,7 @@
 		"dashboard:dev": "cd src/ui && bun install --silent && cd ../.. && bun run src/index.ts config ui --dev",
 		"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 && node -e \"const fs=require('fs'),f='dist/index.js',c=fs.readFileSync(f,'utf-8');fs.writeFileSync(f,c.replace(/^#!.*\\n\\/\\/ @bun\\n/,''))\"",
+		"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",
@@ -52,7 +52,6 @@
 	"author": "ClaudeKit",
 	"license": "MIT",
 	"engines": {
-		"bun": ">=1.3.2",
 		"node": ">=18.0.0"
 	},
 	"dependencies": {