claudekit-cli 3.36.0-dev.29 → 3.36.0-dev.30

package/bin/ck.js

@@ -6,7 +6,7 @@
  * This is the entry point that NPM symlinks to when installing globally.
  */
 
-import { spawn } from "node:child_process";
+import { execSync, spawn } from "node:child_process";
 import { existsSync } from "node:fs";
 import { dirname, join } from "node:path";
 import { fileURLToPath, pathToFileURL } from "node:url";
@@ -48,7 +48,59 @@ const getErrorMessage = (err) => {
 };
 
 /**
- * Run CLI via Node.js as fallback (slower but works on all platforms).
+ * Check if bun runtime is available on the system.
+ * Used to run dist/index.js with bun when no platform binary exists (e.g., dev releases).
+ * dist/index.js may contain bun-specific imports (bun:sqlite) that Node.js can't handle.
+ * Result is cached to avoid repeated execSync calls across fallback paths.
+ */
+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;
+};
+
+/**
+ * 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.
+ * @param {boolean} showWarning - Whether to show runtime info message
+ * @returns {Promise<void>} Resolves when bun process exits
+ */
+const runWithBun = (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("⚠️  Native binary not found, using bun runtime");
+	}
+	return new Promise((resolve) => {
+		const child = spawn("bun", [distPath, ...process.argv.slice(2)], {
+			stdio: "inherit",
+			windowsHide: true,
+		});
+		child.on("error", () => {
+			// bun spawn failed unexpectedly — caller handles fallback
+			resolve(false);
+		});
+		child.on("exit", (code, signal) => {
+			if (signal) {
+				process.kill(process.pid, signal);
+				return;
+			}
+			process.exitCode = code || 0;
+			resolve(true);
+		});
+	});
+};
+
+/**
+ * Run CLI via Node.js as last-resort fallback (slower, no bun: protocol support).
  * The imported dist/index.js handles its own process lifecycle via the cac CLI framework.
  * @param {boolean} showWarning - Whether to show fallback warning message
  * @throws {Error} If dist/index.js is missing or fails to load
@@ -115,17 +167,32 @@ const runBinary = (binaryPath) => {
 
 		child.on("error", async (err) => {
 			// Binary execution failed (e.g., ENOENT on Alpine/musl due to missing glibc)
-			// Fall back to Node.js execution
+			// Fall back to bun, then Node.js
 			errorOccurred = true;
+			if (hasBun()) {
+				const success = await runWithBun(true);
+				if (success) {
+					resolve();
+					return;
+				}
+			}
 			try {
 				await runWithNode(true);
 				resolve();
 			} catch (fallbackErr) {
+				const fallbackMsg = getErrorMessage(fallbackErr);
 				console.error(`❌ Binary failed: ${getErrorMessage(err)}`);
-				console.error(`❌ Fallback also failed: ${getErrorMessage(fallbackErr)}`);
-				console.error(
-					"Please report this issue at: https://github.com/mrgoonie/claudekit-cli/issues",
-				);
+				console.error(`❌ Fallback also failed: ${fallbackMsg}`);
+				if (fallbackMsg.includes("bun:") || fallbackMsg.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",
+					);
+				}
 				process.exit(1);
 			}
 		});
@@ -148,16 +215,29 @@ const runBinary = (binaryPath) => {
 };
 
 /**
- * Handle fallback execution with error reporting
- * @param {string} errorPrefix - Prefix for error message if fallback fails
+ * Handle fallback execution: try bun first (handles bun: imports), then Node.js.
+ * @param {string} errorPrefix - Prefix for error message if all fallbacks fail
  * @param {boolean} showIssueLink - Whether to show issue reporting link
  */
 const handleFallback = async (errorPrefix, showIssueLink = false) => {
+	// Prefer bun — dist/index.js may contain bun-specific imports (bun:sqlite)
+	if (hasBun()) {
+		const success = await runWithBun(true);
+		if (success) return;
+	}
+	// Last resort: Node.js (works for stable builds without bun: imports)
 	try {
 		await runWithNode();
 	} catch (err) {
-		console.error(`❌ ${errorPrefix}: ${getErrorMessage(err)}`);
-		if (showIssueLink) {
+		const errMsg = getErrorMessage(err);
+		console.error(`❌ ${errorPrefix}: ${errMsg}`);
+		// Detect bun-specific import failures and guide user to install bun
+		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 if (showIssueLink) {
 			console.error(
 				"Please report this issue at: https://github.com/mrgoonie/claudekit-cli/issues",
 			);

package/dist/index.js

@@ -56626,7 +56626,7 @@ var package_default;
 var init_package = __esm(() => {
   package_default = {
     name: "claudekit-cli",
-    version: "3.36.0-dev.29",
+    version: "3.36.0-dev.30",
     description: "CLI tool for bootstrapping and updating ClaudeKit projects",
     type: "module",
     repository: {

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "claudekit-cli",
-	"version": "3.36.0-dev.29",
+	"version": "3.36.0-dev.30",
 	"description": "CLI tool for bootstrapping and updating ClaudeKit projects",
 	"type": "module",
 	"repository": {