claudekit-cli 4.4.0-dev.1 → 4.4.0-dev.2

package/README.md

@@ -50,7 +50,7 @@ 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.
+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. Most commands do not require native build tools; `ck content` uses an optional SQLite driver and shows remediation steps if that driver is unavailable.
 
 ### Using npm (Recommended)
 
@@ -407,6 +407,8 @@ ck content start --verbose
 
 **Features:** 11-phase pipeline (scan → filter → classify → context → create → validate → review → photo → publish → engage → analyze), noise filtering, context caching (24h TTL), content validation, photo generation, 3 review modes (auto/manual/hybrid), quiet hours scheduling, engagement tracking, SQLite database, platform-specific adapters.
 
+**Runtime dependency:** `ck content` uses the optional native SQLite driver `better-sqlite3`. If the driver is unavailable, other CLI commands still work and `ck content` prints reinstall/build-tool guidance.
+
 **Config:** `.ck.json` under `content` key. See [docs/ck-content.md](./docs/ck-content.md) for full configuration reference.
 
 ### Other Commands

package/cli-manifest.json

@@ -1,6 +1,6 @@
 {
-	"version": "4.4.0-dev.1",
-	"generatedAt": "2026-05-27T19:13:35.783Z",
+	"version": "4.4.0-dev.2",
+	"generatedAt": "2026-05-30T14:38:02.947Z",
 	"commands": {
 		"agents": {
 			"name": "agents",

package/dist/index.js

@@ -63852,7 +63852,7 @@ var package_default;
 var init_package = __esm(() => {
   package_default = {
     name: "claudekit-cli",
-    version: "4.4.0-dev.1",
+    version: "4.4.0-dev.2",
     description: "CLI tool for bootstrapping and updating ClaudeKit projects",
     type: "module",
     repository: {
@@ -63922,7 +63922,6 @@ var init_package = __esm(() => {
     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",
@@ -63947,6 +63946,9 @@ var init_package = __esm(() => {
       ws: "^8.19.0",
       zod: "^3.23.8"
     },
+    optionalDependencies: {
+      "better-sqlite3": "^12.6.2"
+    },
     devDependencies: {
       "@biomejs/biome": "^1.9.4",
       "@playwright/test": "^1.59.1",
@@ -64260,6 +64262,10 @@ function extractCommandStdout(result) {
     return result.stdout;
   return "";
 }
+function isNativeDependencyBuildError(errorMessage) {
+  const normalized = errorMessage.toLowerCase();
+  return (normalized.includes("better-sqlite3") || normalized.includes("prebuild-install") || normalized.includes("node-gyp")) && (normalized.includes("no prebuilt binaries found") || normalized.includes("could not find any visual studio installation") || normalized.includes("visual studio build tools") || normalized.includes("desktop development with c++") || normalized.includes("node-gyp rebuild"));
+}
 async function runPackageManagerUpdate(updateCmd, pm, deps) {
   const { execAsyncFn, spinnerStart, spinnerStop } = deps;
   spinnerStart("Updating CLI...");
@@ -64277,6 +64283,17 @@ Or fix npm permissions: https://docs.npmjs.com/resolving-eacces-permissions-erro
       const elevationHint = isWindows3 ? `Run your terminal as Administrator and retry: ${updateCmd}` : `sudo ${updateCmd}`;
       throw new CliUpdateError(`Permission denied. Try: ${elevationHint}${permHint}`);
     }
+    if (isNativeDependencyBuildError(errorMessage)) {
+      throw new CliUpdateError([
+        "Update failed while installing a native optional dependency.",
+        "ClaudeKit CLI should not require native SQLite for normal install/update commands.",
+        "",
+        `Manual update: ${redactCommandForLog(updateCmd)}`,
+        "",
+        "If this persists, retry after updating ClaudeKit CLI to a version where `better-sqlite3` is optional, or install Visual Studio Build Tools with the Desktop development with C++ workload for `ck content` support."
+      ].join(`
+`));
+    }
     logger.error(`Update failed: ${errorMessage}`);
     logger.info(`Try running: ${updateCmd}`);
     throw new CliUpdateError(`Update failed: ${errorMessage}
@@ -77843,11 +77860,56 @@ var init_content_logger = __esm(() => {
 });
 
 // src/commands/content/phases/sqlite-client.ts
-import BetterSqlite3 from "better-sqlite3";
+import { createRequire as createRequire2 } from "node:module";
+function createMissingSqliteDriverError(cause) {
+  const detail = cause instanceof Error && cause.message ? `
+
+Original error: ${cause.message}` : "";
+  return new OptionalSqliteDriverError([
+    "`ck content` requires the optional native package `better-sqlite3`, but it is not available in this CLI install.",
+    "Most ClaudeKit CLI commands do not need it and should continue to work.",
+    "",
+    "To use `ck content`, reinstall the CLI with optional dependencies for your active Node.js runtime:",
+    "  npm install -g claudekit-cli --include=optional",
+    "",
+    "If npm attempts a source build on Windows, install Visual Studio Build Tools with the Desktop development with C++ workload."
+  ].join(`
+`) + detail, { cause });
+}
+function resolveBetterSqlite3Constructor(sqliteModule) {
+  if (typeof sqliteModule === "function") {
+    return sqliteModule;
+  }
+  if (sqliteModule.default && typeof sqliteModule.default === "function") {
+    return sqliteModule.default;
+  }
+  throw new OptionalSqliteDriverError("`better-sqlite3` loaded, but did not expose a database constructor.");
+}
+function loadBetterSqlite3Driver(loadModule = () => require2("better-sqlite3")) {
+  try {
+    return resolveBetterSqlite3Constructor(loadModule());
+  } catch (error) {
+    if (error instanceof OptionalSqliteDriverError) {
+      throw error;
+    }
+    throw createMissingSqliteDriverError(error);
+  }
+}
 function openDatabase(dbPath) {
+  const BetterSqlite3 = cachedBetterSqlite3 ?? loadBetterSqlite3Driver();
+  cachedBetterSqlite3 = BetterSqlite3;
   return new BetterSqlite3(dbPath);
 }
-var init_sqlite_client = () => {};
+var require2, cachedBetterSqlite3 = null, OptionalSqliteDriverError;
+var init_sqlite_client = __esm(() => {
+  require2 = createRequire2(import.meta.url);
+  OptionalSqliteDriverError = class OptionalSqliteDriverError extends Error {
+    constructor(message, options2) {
+      super(message, options2);
+      this.name = "OptionalSqliteDriverError";
+    }
+  };
+});
 
 // src/commands/content/phases/db-manager.ts
 import { existsSync as existsSync83, mkdirSync as mkdirSync8 } from "node:fs";

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "claudekit-cli",
-	"version": "4.4.0-dev.1",
+	"version": "4.4.0-dev.2",
 	"description": "CLI tool for bootstrapping and updating ClaudeKit projects",
 	"type": "module",
 	"repository": {
@@ -70,7 +70,6 @@
 	"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",
@@ -95,6 +94,9 @@
 		"ws": "^8.19.0",
 		"zod": "^3.23.8"
 	},
+	"optionalDependencies": {
+		"better-sqlite3": "^12.6.2"
+	},
 	"devDependencies": {
 		"@biomejs/biome": "^1.9.4",
 		"@playwright/test": "^1.59.1",