wicked-brain 0.4.1 → 0.4.3

package/README.md

@@ -126,7 +126,7 @@ Every operation uses **progressive loading** — the agent never pulls more than
 
 | Skill | What it does |
 |---|---|
-| `wicked-brain:init` | Set up a new brain — creates directory structure, then onboards your project in parallel |
+| `wicked-brain:init` | Set up a new brain — creates structure, starts the server, and ingests your project in one shot |
 | `wicked-brain:ingest` | Add source files — text extracted deterministically, binary docs read via LLM vision |
 | `wicked-brain:search` | Parallel search across your brain and linked brains |
 | `wicked-brain:read` | Progressive loading: depth 0 (stats), depth 1 (summary), depth 2 (full content) |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "wicked-brain",
-  "version": "0.4.1",
+  "version": "0.4.3",
   "type": "module",
   "description": "Digital brain as skills for AI coding CLIs — no vector DB, no embeddings, no infrastructure",
   "keywords": [

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

@@ -17,6 +17,9 @@ function getArg(name) {
 const brainPath = resolve(getArg("brain") || ".");
 const preferredPort = parseInt(getArg("port") || "4242", 10);
 const configPath = join(brainPath, "brain.json");
+// Source path for LSP workspace root — prefer --source flag, fall back to config, then brainPath
+const sourceArgRaw = getArg("source");
+const sourceArg = sourceArgRaw ? resolve(sourceArgRaw) : null;
 
 /** Find a free TCP port starting from `start`. */
 function findFreePort(start) {
@@ -57,8 +60,18 @@ const db = new SqliteSearch(dbPath, brainId);
 const pidPath = join(brainPath, "_meta", "server.pid");
 writeFileSync(pidPath, String(pid));
 
-// LSP client
-const lsp = new LspClient(brainPath, db);
+// Read project directories and source path from config (must happen before LspClient)
+const metaConfigPath = join(brainPath, "_meta", "config.json");
+let projects = [];
+let sourcePath = sourceArg;
+try {
+  const metaConfig = JSON.parse(readFileSync(metaConfigPath, "utf-8"));
+  projects = metaConfig.projects || [];
+  if (!sourcePath && metaConfig.source_path) sourcePath = resolve(metaConfig.source_path);
+} catch {}
+
+// LSP client — pass source path so language servers are rooted at the project, not the brain dir
+const lsp = new LspClient(brainPath, db, sourcePath);
 
 // Graceful shutdown
 async function shutdown() {
@@ -86,18 +99,22 @@ const actions = {
   candidates: (p) => ({ candidates: db.candidates(p) }),
   symbols: async (p) => {
     // Prefer LSP workspace symbols (structured, language-aware)
-    const lspResult = await lsp.workspaceSymbols({ query: p.name || p.query || "" });
-    if (lspResult.symbols && lspResult.symbols.length > 0) {
-      return {
-        results: lspResult.symbols.map(s => ({
-          id: `${s.file}::${s.name}`,
-          name: s.name,
-          type: s.kind,
-          file_path: s.file,
-          line_start: s.line,
-        })),
-        source: "lsp",
-      };
+    try {
+      const lspResult = await lsp.workspaceSymbols({ query: p.name || p.query || "" });
+      if (lspResult.symbols && lspResult.symbols.length > 0) {
+        return {
+          results: lspResult.symbols.map(s => ({
+            id: `${s.file}::${s.name}`,
+            name: s.name,
+            type: s.kind,
+            file_path: s.file,
+            line_start: s.line,
+          })),
+          source: "lsp",
+        };
+      }
+    } catch {
+      // LSP unavailable or errored (e.g. no tsconfig.json) — fall through to FTS
     }
     // Fall back to FTS-based symbol search
     return { ...db.symbols(p), source: "fts" };
@@ -164,14 +181,6 @@ const server = createServer((req, res) => {
   });
 });
 
-// Read project directories from config
-const metaConfigPath = join(brainPath, "_meta", "config.json");
-let projects = [];
-try {
-  const metaConfig = JSON.parse(readFileSync(metaConfigPath, "utf-8"));
-  projects = metaConfig.projects || [];
-} catch {}
-
 const watcher = new FileWatcher(brainPath, db, brainId, projects);
 
 // Wire file changes to LSP client for didOpen/didChange/didClose

package/server/lib/lsp-client.mjs

@@ -21,10 +21,10 @@ export class LspClient {
   #diagnostics = new Map(); // filePath → Diagnostic[]
   #diagnosticsSetup = new Set(); // server keys with diagnostics wired
 
-  constructor(brainPath, db) {
+  constructor(brainPath, db, sourcePath) {
     this.#brainPath = brainPath;
     this.#db = db;
-    this.#manager = new LspManager(brainPath);
+    this.#manager = new LspManager(brainPath, sourcePath);
     this.#userConfig = loadUserConfig(brainPath);
   }
 

package/server/lib/lsp-manager.mjs

@@ -13,10 +13,18 @@ const RETRY_RESET_MS = 300000; // 5 minutes
 
 export class LspManager {
   #brainPath;
+  #sourcePath;
   #servers = new Map(); // key → { process, client, state, retries, startedAt, openFiles }
 
-  constructor(brainPath) {
+  /**
+   * @param {string} brainPath - Brain storage directory (used as fallback workspace root)
+   * @param {string} [sourcePath] - Actual source project root with tsconfig.json, go.mod, etc.
+   *   When provided, LSP servers are initialized with this as rootUri so they can find
+   *   project configuration files. Falls back to brainPath if not provided.
+   */
+  constructor(brainPath, sourcePath) {
     this.#brainPath = brainPath;
+    this.#sourcePath = sourcePath || brainPath;
   }
 
   /**
@@ -71,7 +79,7 @@ export class LspManager {
 
     const proc = spawn(config.command, config.args || [], {
       stdio: ["pipe", "pipe", "pipe"],
-      cwd: this.#brainPath,
+      cwd: this.#sourcePath,
     });
 
     const client = new RpcClient(proc.stdin, proc.stdout);
@@ -100,13 +108,12 @@ export class LspManager {
 
     // Initialize
     try {
-      const result = await client.request("initialize", {
+      const rootUri = pathToFileURL(resolve(this.#sourcePath)).href;
+      await client.request("initialize", {
         processId: process.pid,
         capabilities: {},
-        rootUri: pathToFileURL(resolve(this.#brainPath)).href,
-        workspaceFolders: [
-          { uri: pathToFileURL(resolve(this.#brainPath)).href, name: "brain" },
-        ],
+        rootUri,
+        workspaceFolders: [{ uri: rootUri, name: "project" }],
       });
       client.notify("initialized", {});
       entry.state = "ready";

package/server/package.json

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

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

@@ -398,7 +398,34 @@ Archived files are invisible to the file watcher, so the server won't clean them
    - macOS/Linux: `mv "{brain_path}/chunks/extracted/{safe_name}" "{brain_path}/chunks/extracted/{safe_name}.archived-$(date +%s)"`
    - Windows: `Rename-Item "{brain_path}\chunks\extracted\{safe_name}" "{safe_name}.archived-{timestamp}"`
 
-### Step 5: Report to user
+### Step 5: Record source path
+
+After ingesting a directory, write the absolute source path to `_meta/config.json`
+so the brain server can use it as the LSP workspace root (enabling symbol lookup,
+go-to-definition, and diagnostics for the ingested project):
+
+```bash
+# Read current config, add source_path, write back
+python3 -c "
+import json, sys
+path = '{brain_path}/_meta/config.json'
+with open(path) as f: cfg = json.load(f)
+cfg['source_path'] = '{absolute_source_path}'
+with open(path, 'w') as f: json.dump(cfg, f, indent=2)
+print('source_path recorded')
+" 2>/dev/null || python -c "
+import json, sys
+path = '{brain_path}/_meta/config.json'
+with open(path) as f: cfg = json.load(f)
+cfg['source_path'] = '{absolute_source_path}'
+with open(path, 'w') as f: json.dump(cfg, f, indent=2)
+print('source_path recorded')
+"
+```
+
+Skip this step if the source is a single file rather than a project directory.
+
+### Step 6: Report to user
 
 After the subagent or batch script completes, summarize:
 - "{N} text files ingested, {M} chunks created"

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

@@ -47,9 +47,12 @@ For the brain path default:
       - Windows: `tasklist /FI "PID eq {pid}" 2>nul | findstr {pid}`
       - Or use Python: `python3 -c "import os; os.kill({pid}, 0)" 2>/dev/null || python -c "import os; os.kill({pid}, 0)"`
 
-   c. If the process is dead or no PID file, start the server:
+   c. If the process is dead or no PID file, start the server.
+      Also pass `--source` if `source_path` is set in `_meta/config.json`
+      (this roots LSP language servers at the ingested project so symbol
+      lookup and go-to-definition work correctly):
       ```bash
-      npx wicked-brain-server --brain {brain_path} --port {port} &
+      npx wicked-brain-server --brain {brain_path} --port {port} [--source {source_path}] &
       ```
       On Windows (PowerShell):
       ```powershell