wicked-brain 0.15.0 → 0.15.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "wicked-brain",
-  "version": "0.15.0",
+  "version": "0.15.2",
   "type": "module",
   "description": "Digital brain as skills for AI coding CLIs — no vector DB, no embeddings, no infrastructure",
   "keywords": [
@@ -50,6 +50,6 @@
     "release": "npm version patch && git push && git push --tags"
   },
   "engines": {
-    "node": ">=18.0.0"
+    "node": ">=20.0.0"
   }
 }

package/server/bin/wicked-brain-call.mjs

@@ -244,7 +244,15 @@ async function ensureServer(brainPath, opts) {
     }
 
     log(`starting wicked-brain-server (brain=${brainPath} port=${port})`);
-    const sourcePath = sourceOverride || meta.source_path;
+    let sourcePath = sourceOverride || meta.source_path;
+    // Per-project brains are keyed on basename(cwd). Configs written before
+    // source_path persistence lack the field — derive it from cwd (only when
+    // the basename convention confirms cwd is the project root) so the server
+    // roots LSP at the project and persists source_path for port-resolution
+    // consumers (wicked-garden hooks match configs by source_path).
+    if (!sourcePath && basename(brainPath) === basename(process.cwd())) {
+      sourcePath = process.cwd();
+    }
     const argv = [SERVER_BIN, "--brain", brainPath, "--port", String(port)];
     if (sourcePath) argv.push("--source", sourcePath);
 
@@ -465,18 +473,19 @@ Examples:
   if (args.flags.version) {
     const pkg = JSON.parse(readFileSync(new URL("../../package.json", import.meta.url), "utf-8"));
     process.stdout.write(pkg.version + "\n");
-    process.exit(0);
+    return;
   }
 
   if (args.flags.help) {
     process.stdout.write(HELP);
-    process.exit(0);
+    return;
   }
 
   const noModeFlag = !args.flags.start && !args.flags.stop && !args.flags.status;
   if (noModeFlag && args.positional.length === 0) {
     process.stderr.write(HELP);
-    process.exit(1);
+    process.exitCode = 1;
+    return;
   }
 
   const log = (msg) => process.stderr.write(`[wicked-brain-call] ${msg}\n`);

package/server/bin/wicked-brain-server.mjs

@@ -32,7 +32,7 @@ function getArg(name) {
 if (args.includes("--version") || args.includes("-v")) {
   const pkgUrl = new URL("../../package.json", import.meta.url);
   const pkg = JSON.parse(readFileSync(pkgUrl, "utf-8"));
-  console.log(pkg.version);
+  process.stdout.write(pkg.version + "\n");
   exit(0);
 }
 
@@ -120,7 +120,7 @@ let memorySubscriber = null;
 
 // Graceful shutdown
 async function shutdown() {
-  console.log("Shutting down...");
+  process.stdout.write("Shutting down...\n");
   try { unlinkSync(pidPath); } catch {}
   watcher.stop();
   if (memorySubscriber) {
@@ -398,12 +398,16 @@ try {
   let metaConfig = {};
   try { metaConfig = JSON.parse(readFileSync(metaConfigPath, "utf-8")); } catch {}
   metaConfig.server_port = port;
+  // Persist the source root alongside the port: external port resolution
+  // (wicked-garden hooks) matches per-project configs by source_path, and
+  // configs created before this field existed would otherwise never gain it.
+  if (sourcePath) metaConfig.source_path = sourcePath;
   writeFileSync(metaConfigPath, JSON.stringify(metaConfig, null, 2) + "\n");
 } catch (err) {
   console.error(`Warning: could not write port to config: ${err.message}`);
 }
 
-console.log(`wicked-brain-server running on port ${port} (brain: ${brainId}, pid: ${pid})`);
+process.stdout.write(`wicked-brain-server running on port ${port} (brain: ${brainId}, pid: ${pid})\n`);
 watcher.start();
 const busReady = await waitForBus();
 emitEvent("wicked.server.started", "brain.system", {

package/server/package.json

@@ -1,6 +1,6 @@
 {
   "name": "wicked-brain-server",
-  "version": "0.15.0",
+  "version": "0.15.2",
   "type": "module",
   "description": "SQLite FTS5 search server for wicked-brain digital knowledge bases",
   "keywords": [

package/skills/wicked-brain-configure/SKILL.md

@@ -101,6 +101,7 @@ Brain search/query results include `source_type` and `path` fields:
 ### Rules (follow strictly)
 
 - **ALWAYS check the brain BEFORE using Grep, Glob, Read, or Agent(Explore)** — for any find, search, explore, explain, or "what is/how does" request
+- The server auto-starts on any `wicked-brain-call` / skill invocation — a "server not running" notice is NEVER a reason to skip the brain; just call the skill
 - Use `wicked-brain:search` for finding content ("find X", "where is Y", "look for Z", "show me W")
 - Use `wicked-brain:query` for questions ("what does X do", "how does Y work", "explain Z")
 - Use `wicked-brain:agent` (context) when starting a new topic or unfamiliar area