compound-agent 1.2.9 → 1.2.10

package/CHANGELOG.md

@@ -9,6 +9,13 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [1.2.10] - 2026-02-19
+
+### Fixed
+
+- **pnpm native build auto-configuration**: `ca setup` and `ca init` now detect pnpm projects (via `pnpm-lock.yaml`) and automatically add `better-sqlite3` and `node-llama-cpp` to `pnpm.onlyBuiltDependencies` in the consumer's `package.json`. Prevents the "better-sqlite3 failed to load" error that pnpm v9+ users encountered when native addon builds were silently blocked.
+- **Improved error message**: `better-sqlite3` load failure now suggests running `npx ca setup` as the primary fix.
+
 ## [1.2.9] - 2026-02-19
 
 ### Added
@@ -527,7 +534,8 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
   - Vitest test suite
   - tsup build configuration
 
-[Unreleased]: https://github.com/Nathandela/learning_agent/compare/v1.2.9...HEAD
+[Unreleased]: https://github.com/Nathandela/learning_agent/compare/v1.2.10...HEAD
+[1.2.10]: https://github.com/Nathandela/learning_agent/compare/v1.2.9...v1.2.10
 [1.2.9]: https://github.com/Nathandela/learning_agent/compare/v1.2.7...v1.2.9
 [1.2.7]: https://github.com/Nathandela/learning_agent/compare/v1.2.6...v1.2.7
 [1.2.6]: https://github.com/Nathandela/learning_agent/compare/v1.2.5...v1.2.6

package/README.md

@@ -81,7 +81,9 @@ npx ca setup --skip-model
 
 ### pnpm Users
 
-pnpm v9+ blocks native addon builds by default. Add to your `package.json`:
+pnpm v9+ blocks native addon builds by default. Running `npx ca setup` automatically detects pnpm and adds the required config to your `package.json`.
+
+If you prefer to configure manually, add to your `package.json`:
 
 ```json
 {

package/dist/cli.js

@@ -333,11 +333,7 @@ function ensureSqliteAvailable() {
     checked = true;
   } catch (cause) {
     throw new Error(
-      `better-sqlite3 failed to load.
-If using pnpm, add to your project's package.json:
-  "pnpm": { "onlyBuiltDependencies": ["better-sqlite3"] }
-Then run: pnpm install && pnpm rebuild better-sqlite3
-For npm/yarn, run: npm rebuild better-sqlite3`,
+      'better-sqlite3 failed to load.\nRun: npx ca setup (auto-configures pnpm native builds)\nOr manually add to your package.json:\n  "pnpm": { "onlyBuiltDependencies": ["better-sqlite3", "node-llama-cpp"] }\nThen run: pnpm install && pnpm rebuild better-sqlite3\nFor npm/yarn, run: npm rebuild better-sqlite3',
       { cause }
     );
   }
@@ -4193,6 +4189,62 @@ async function installAgentRoleSkills(repoRoot) {
   }
   return created;
 }
+var REQUIRED_BUILD_DEPS = ["better-sqlite3", "node-llama-cpp"];
+async function ensurePnpmBuildConfig(repoRoot) {
+  const lockPath = join(repoRoot, "pnpm-lock.yaml");
+  const hasLockfile = existsSync(lockPath);
+  const pkgPath = join(repoRoot, "package.json");
+  const hasPkgJson = existsSync(pkgPath);
+  if (!hasLockfile) {
+    if (!hasPkgJson) {
+      return { isPnpm: false, alreadyConfigured: false, added: [] };
+    }
+    const pkg2 = readPkgJsonSafe(pkgPath, await readFile(pkgPath, "utf-8"));
+    if (pkg2 === null) return { isPnpm: false, alreadyConfigured: false, added: [] };
+    const pm = typeof pkg2.packageManager === "string" ? pkg2.packageManager : "";
+    if (!pm.startsWith("pnpm")) {
+      return { isPnpm: false, alreadyConfigured: false, added: [] };
+    }
+    return mergePnpmConfig(pkgPath, pkg2);
+  }
+  if (!hasPkgJson) {
+    return { isPnpm: true, alreadyConfigured: false, added: [] };
+  }
+  const pkg = readPkgJsonSafe(pkgPath, await readFile(pkgPath, "utf-8"));
+  if (pkg === null) return { isPnpm: true, alreadyConfigured: false, added: [] };
+  return mergePnpmConfig(pkgPath, pkg);
+}
+function readPkgJsonSafe(pkgPath, raw) {
+  try {
+    return JSON.parse(raw);
+  } catch {
+    console.error(`Warning: Could not parse ${pkgPath} \u2014 skipping pnpm build config.
+Fix the JSON syntax and re-run setup.`);
+    return null;
+  }
+}
+async function mergePnpmConfig(pkgPath, pkg) {
+  if (!pkg.pnpm || typeof pkg.pnpm !== "object") {
+    pkg.pnpm = {};
+  }
+  const pnpmConfig = pkg.pnpm;
+  if (!Array.isArray(pnpmConfig.onlyBuiltDependencies)) {
+    pnpmConfig.onlyBuiltDependencies = [];
+  }
+  const existing = pnpmConfig.onlyBuiltDependencies;
+  const added = [];
+  for (const dep of REQUIRED_BUILD_DEPS) {
+    if (!existing.includes(dep)) {
+      existing.push(dep);
+      added.push(dep);
+    }
+  }
+  if (added.length === 0) {
+    return { isPnpm: true, alreadyConfigured: true, added: [] };
+  }
+  await writeFile(pkgPath, JSON.stringify(pkg, null, 2) + "\n", "utf-8");
+  return { isPnpm: true, alreadyConfigured: false, added };
+}
 
 // src/setup/all.ts
 async function ensureLessonsDirectory(repoRoot) {
@@ -4221,6 +4273,7 @@ async function configureClaudeSettings() {
 }
 async function runSetup(options) {
   const repoRoot = getRepoRoot();
+  const pnpmConfig = await ensurePnpmBuildConfig(repoRoot);
   const lessonsDir = await ensureLessonsDirectory(repoRoot);
   const agentsMdUpdated = await updateAgentsMd(repoRoot);
   await ensureClaudeMdReference(repoRoot);
@@ -4253,7 +4306,8 @@ async function runSetup(options) {
     agentsMd: agentsMdUpdated,
     hooks,
     gitHooks,
-    model: modelStatus
+    model: modelStatus,
+    pnpmConfig
   };
 }
 async function runUninstall(repoRoot, dryRun) {
@@ -4412,6 +4466,14 @@ function printSetupGitHooksStatus(gitHooks) {
   }
   console.log("  Git hooks: Already configured");
 }
+function printPnpmConfigStatus(result) {
+  if (!result.isPnpm) return;
+  if (result.alreadyConfigured) {
+    console.log("  pnpm config: onlyBuiltDependencies already configured");
+  } else if (result.added.length > 0) {
+    console.log(`  pnpm config: Added onlyBuiltDependencies [${result.added.join(", ")}]`);
+  }
+}
 function registerSetupAllCommand(setupCommand) {
   setupCommand.description("One-shot setup: init + hooks + model");
   setupCommand.command("all", { isDefault: true }).description("Run full setup (default)").option("--skip-model", "Skip embedding model download").option("--skip-hooks", "Skip git hooks installation").option("--uninstall", "Remove all generated files and configuration").option("--update", "Regenerate files (preserves user customizations)").option("--status", "Show installation status").option("--dry-run", "Show what would change without changing").action(async (options) => {
@@ -4453,6 +4515,7 @@ function registerSetupAllCommand(setupCommand) {
     console.log(`  AGENTS.md: ${result.agentsMd ? "Updated" : "Already configured"}`);
     console.log(`  Claude hooks: ${result.hooks ? "Installed" : "Already configured"}`);
     printSetupGitHooksStatus(result.gitHooks);
+    printPnpmConfigStatus(result.pnpmConfig);
     switch (result.model) {
       case "skipped":
         console.log("  Model: Skipped (--skip-model)");
@@ -4689,6 +4752,7 @@ async function createIndexFile(repoRoot) {
 async function initAction(cmd, options) {
   const repoRoot = getRepoRoot();
   const { quiet } = getGlobalOpts(cmd);
+  const pnpmConfig = await ensurePnpmBuildConfig(repoRoot);
   await createLessonsDirectory(repoRoot);
   await createIndexFile(repoRoot);
   const lessonsDir = dirname(join(repoRoot, LESSONS_PATH));
@@ -4723,7 +4787,8 @@ async function initAction(cmd, options) {
       agentsMd: agentsMdUpdated,
       hooks: hooksChanged,
       hookStatus: hookResult?.status ?? "skipped",
-      claudeHooks: claudeHooksInstalled
+      claudeHooks: claudeHooksInstalled,
+      pnpmConfig: pnpmConfig.isPnpm ? { added: pnpmConfig.added, alreadyConfigured: pnpmConfig.alreadyConfigured } : null
     }));
     return;
   }
@@ -4733,6 +4798,7 @@ async function initAction(cmd, options) {
   printAgentsMdStatus(agentsMdUpdated, options.skipAgents);
   printHookStatus(hookResult, options.skipHooks);
   printClaudeHooksStatus(claudeHooksResult, options.skipClaude);
+  printPnpmConfigStatus2(pnpmConfig);
 }
 function printAgentsMdStatus(updated, skipped) {
   if (updated) {
@@ -4767,6 +4833,14 @@ function printClaudeHooksStatus(result, skipped) {
     console.log(`  Claude hooks: Error - ${result.error}`);
   }
 }
+function printPnpmConfigStatus2(result) {
+  if (!result.isPnpm) return;
+  if (result.alreadyConfigured) {
+    console.log("  pnpm config: onlyBuiltDependencies already configured");
+  } else if (result.added.length > 0) {
+    console.log(`  pnpm config: Added onlyBuiltDependencies [${result.added.join(", ")}]`);
+  }
+}
 function registerInitCommand(program2) {
   program2.command("init").description("Initialize compound-agent in this repository").option("--skip-agents", "Skip AGENTS.md modification").option("--skip-hooks", "Skip git hooks installation").option("--skip-claude", "Skip Claude Code hooks installation").option("--json", "Output result as JSON").action(async function(options) {
     await initAction(this, options);