wicked-brain 0.4.9 → 0.4.11

package/package.json

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

package/server/package.json

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

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

@@ -9,8 +9,15 @@ Factory skill for wicked-brain agents. Lists available agents and dispatches the
 
 ## Config
 
-Read `_meta/config.json` for brain path and server port.
-If it doesn't exist, trigger wicked-brain:init.
+Resolve the brain config via the shared resolution in
+wicked-brain:init § "Resolving the brain config". In short: try
+`~/.wicked-brain/projects/{cwd_basename}/_meta/config.json` first, fall back
+to `~/.wicked-brain/_meta/config.json` (legacy flat), else trigger
+wicked-brain:init. Read the resolved file for brain path and server port.
+
+Do NOT read a bare relative `_meta/config.json` — the model will resolve it
+against the current working directory and brain files will end up in the
+project root.
 
 ## Parameters
 

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

@@ -25,8 +25,15 @@ For the brain path default:
 
 ## Config
 
-Read `_meta/config.json` for brain path and server port.
-If it doesn't exist, trigger wicked-brain:init.
+Resolve the brain config via the shared resolution in
+wicked-brain:init § "Resolving the brain config". In short: try
+`~/.wicked-brain/projects/{cwd_basename}/_meta/config.json` first, fall back
+to `~/.wicked-brain/_meta/config.json` (legacy flat), else trigger
+wicked-brain:init. Read the resolved file for brain path and server port.
+
+Do NOT read a bare relative `_meta/config.json` — the model will resolve it
+against the current working directory and brain files will end up in the
+project root.
 
 ## Process
 

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

@@ -9,8 +9,15 @@ Writes a contextual `## wicked-brain` section into the active CLI/IDE's agent co
 
 ## Config
 
-Read `_meta/config.json` for brain path and server port.
-If it doesn't exist, trigger wicked-brain:init.
+Resolve the brain config via the shared resolution in
+wicked-brain:init § "Resolving the brain config". In short: try
+`~/.wicked-brain/projects/{cwd_basename}/_meta/config.json` first, fall back
+to `~/.wicked-brain/_meta/config.json` (legacy flat), else trigger
+wicked-brain:init. Read the resolved file for brain path and server port.
+
+Do NOT read a bare relative `_meta/config.json` — the model will resolve it
+against the current working directory and brain files will end up in the
+project root.
 
 ## Process
 

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

@@ -24,8 +24,15 @@ For the brain path default:
 
 ## Config
 
-Read `_meta/config.json` for brain path and server port.
-If it doesn't exist, trigger wicked-brain:init.
+Resolve the brain config via the shared resolution in
+wicked-brain:init § "Resolving the brain config". In short: try
+`~/.wicked-brain/projects/{cwd_basename}/_meta/config.json` first, fall back
+to `~/.wicked-brain/_meta/config.json` (legacy flat), else trigger
+wicked-brain:init. Read the resolved file for brain path and server port.
+
+Do NOT read a bare relative `_meta/config.json` — the model will resolve it
+against the current working directory and brain files will end up in the
+project root.
 
 ## Parameters
 

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

@@ -24,8 +24,15 @@ For the brain path default:
 
 ## Config
 
-Read `_meta/config.json` for brain path and server port.
-If it doesn't exist, trigger wicked-brain:init.
+Resolve the brain config via the shared resolution in
+wicked-brain:init § "Resolving the brain config". In short: try
+`~/.wicked-brain/projects/{cwd_basename}/_meta/config.json` first, fall back
+to `~/.wicked-brain/_meta/config.json` (legacy flat), else trigger
+wicked-brain:init. Read the resolved file for brain path and server port.
+
+Do NOT read a bare relative `_meta/config.json` — the model will resolve it
+against the current working directory and brain files will end up in the
+project root.
 
 ## Process
 

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

@@ -22,8 +22,15 @@ and the archive-rename convention used by wicked-brain:agent dispatch consolidat
 
 ## Config
 
-Read `_meta/config.json` for brain path and server port.
-If it doesn't exist, trigger wicked-brain:init.
+Resolve the brain config via the shared resolution in
+wicked-brain:init § "Resolving the brain config". In short: try
+`~/.wicked-brain/projects/{cwd_basename}/_meta/config.json` first, fall back
+to `~/.wicked-brain/_meta/config.json` (legacy flat), else trigger
+wicked-brain:init. Read the resolved file for brain path and server port.
+
+Do NOT read a bare relative `_meta/config.json` — the model will resolve it
+against the current working directory and brain files will end up in the
+project root.
 
 ## Parameters
 

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

@@ -25,8 +25,15 @@ For the brain path default:
 
 ## Config
 
-Read `{brain_path}/_meta/config.json` for brain path and server port.
-If it doesn't exist, trigger wicked-brain:init.
+Resolve the brain config via the shared resolution in
+wicked-brain:init § "Resolving the brain config". In short: try
+`~/.wicked-brain/projects/{cwd_basename}/_meta/config.json` first, fall back
+to `~/.wicked-brain/_meta/config.json` (legacy flat), else trigger
+wicked-brain:init. Read the resolved file for brain path and server port.
+
+Do NOT read a bare relative `_meta/config.json` — the model will resolve it
+against the current working directory and brain files will end up in the
+project root.
 
 ## Parameters
 
@@ -45,7 +52,8 @@ curl -s -f -X POST http://localhost:{port}/api \
 ```
 
 If this fails (connection refused or non-2xx), invoke `wicked-brain:server` to start it
-before continuing. Re-read `_meta/config.json` after the server starts to get the
+before continuing. Re-read `{brain_path}/_meta/config.json` (the resolved
+config from the Config section above) after the server starts to get the
 actual port it bound to.
 
 ### Step 1: Assess scope
@@ -400,7 +408,7 @@ Archived files are invisible to the file watcher, so the server won't clean them
 
 ### Step 5: Record source path
 
-After ingesting a directory, write the absolute source path to `_meta/config.json`
+After ingesting a directory, write the absolute source path to the resolved `{brain_path}/_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):
 

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

@@ -47,6 +47,30 @@ For the brain path default:
 - macOS/Linux: `~/.wicked-brain/projects/{project_name}`
 - Windows: `%USERPROFILE%\.wicked-brain\projects\{project_name}`
 
+## Resolving the brain config
+
+**This section is the canonical resolution logic. Other skills point here —
+keep it authoritative.** Never read a bare relative `_meta/config.json`: the
+model will resolve it against the current working directory and brain files
+will land in the project root.
+
+To locate the brain config for the current session:
+
+1. Compute `{cwd_basename}` — the basename of the current working directory,
+   lowercased, with non-alphanumerics replaced by hyphens.
+2. Try `~/.wicked-brain/projects/{cwd_basename}/_meta/config.json` first
+   (Windows: `%USERPROFILE%\.wicked-brain\projects\{cwd_basename}\_meta\config.json`).
+3. If that file doesn't exist, fall back to the legacy flat path
+   `~/.wicked-brain/_meta/config.json` (Windows:
+   `%USERPROFILE%\.wicked-brain\_meta\config.json`).
+4. If neither exists, trigger `wicked-brain:init`.
+5. Read the resolved file. It contains `brain_path` and `server_port` (and
+   optionally `source_path`). All subsequent operations use these values —
+   never hardcode the port or path.
+
+Any skill that needs to read, write, or reference `_meta/config.json` MUST use
+this resolution. Never compute `_meta/config.json` against the project's `cwd`.
+
 ## When to use
 
 - User explicitly asks to create/initialize a brain
@@ -56,13 +80,23 @@ For the brain path default:
 
 ### Step 1: Ask the user
 
-Compute the default project name from the current working directory basename
-(lowercase, replace non-alphanumerics with hyphens). Then ask:
+**Ask in this exact order — do not reverse the questions:**
+
+First, compute `{cwd_basename}`: take the basename of the current working directory,
+lowercase it, and replace any non-alphanumeric characters with hyphens.
+
+Then ask **two questions, in order**:
+
+1. **"What should this project's brain be called?"**
+   - Default: `{cwd_basename}` (the current directory name, not the string "wicked-brain")
+   - Wait for the user's answer (or acceptance of default) before asking question 2.
 
-1. "What should this project's brain be called?" — Default: `{cwd_basename}`
-2. "Where should it live?" — Default:
-   - macOS/Linux: `~/.wicked-brain/projects/{project_name}`
-   - Windows: `%USERPROFILE%\.wicked-brain\projects\{project_name}`
+2. **"Where should it live?"**
+   - Default:
+     - macOS/Linux: `~/.wicked-brain/projects/{project_name}` (where `{project_name}` is the name from question 1)
+     - Windows: `%USERPROFILE%\.wicked-brain\projects\{project_name}`
+   - The default path MUST include the `projects/` subdirectory and the project name.
+     **Never default to just `~/.wicked-brain/`** — that is the parent container, not a brain.
 
 If the user supplies a path that is exactly `~/.wicked-brain` (the parent
 directory, not a project subdirectory), push back: explain the per-project

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

@@ -25,8 +25,15 @@ For the brain path default:
 
 ## Config
 
-Read `_meta/config.json` for brain path and server port.
-If it doesn't exist, trigger wicked-brain:init.
+Resolve the brain config via the shared resolution in
+wicked-brain:init § "Resolving the brain config". In short: try
+`~/.wicked-brain/projects/{cwd_basename}/_meta/config.json` first, fall back
+to `~/.wicked-brain/_meta/config.json` (legacy flat), else trigger
+wicked-brain:init. Read the resolved file for brain path and server port.
+
+Do NOT read a bare relative `_meta/config.json` — the model will resolve it
+against the current working directory and brain files will end up in the
+project root.
 
 ## Process
 

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

@@ -40,8 +40,15 @@ whether the language server process is running and review its stderr logs.
 
 ## Config
 
-Read `_meta/config.json` for brain path and server port.
-If it doesn't exist, trigger wicked-brain:init.
+Resolve the brain config via the shared resolution in
+wicked-brain:init § "Resolving the brain config". In short: try
+`~/.wicked-brain/projects/{cwd_basename}/_meta/config.json` first, fall back
+to `~/.wicked-brain/_meta/config.json` (legacy flat), else trigger
+wicked-brain:init. Read the resolved file for brain path and server port.
+
+Do NOT read a bare relative `_meta/config.json` — the model will resolve it
+against the current working directory and brain files will end up in the
+project root.
 
 ## Prerequisites — Source Path
 
@@ -72,7 +79,7 @@ If `source_path` is **missing** — LSP will fail. Fix it before continuing.
 wicked-brain:ingest source=/path/to/project
 ```
 
-**Option B** — Write it manually to `_meta/config.json`, then restart the server:
+**Option B** — Write it manually to the resolved `{brain_path}/_meta/config.json` (from the Config section), then restart the server:
 ```bash
 # Read current config, add source_path, write back
 python3 -c "
@@ -269,7 +276,7 @@ If installation fails, report to the user:
 | `language_server_crashed` | The server crashed 3 times. Report to user, suggest checking the language server logs. |
 | `unsupported_language` | No known language server for this file extension. |
 | `lsp_timeout` | The language server took too long. May be initializing a large project. Retry once. |
-| `file_outside_workspace` | The file isn't under `source_path`. Check `_meta/config.json` — `source_path` must be the project root that contains the file. Set it and restart the server with `--source`. |
+| `file_outside_workspace` | The file isn't under `source_path`. Check the resolved `{brain_path}/_meta/config.json` — `source_path` must be the project root that contains the file. Set it and restart the server with `--source`. |
 
 ### Step 5: Use results
 

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

@@ -21,8 +21,15 @@ Store and recall experiential learnings in the brain's memory system.
 
 ## Config
 
-Read `_meta/config.json` for brain path and server port.
-If it doesn't exist, trigger wicked-brain:init.
+Resolve the brain config via the shared resolution in
+wicked-brain:init § "Resolving the brain config". In short: try
+`~/.wicked-brain/projects/{cwd_basename}/_meta/config.json` first, fall back
+to `~/.wicked-brain/_meta/config.json` (legacy flat), else trigger
+wicked-brain:init. Read the resolved file for brain path and server port.
+
+Do NOT read a bare relative `_meta/config.json` — the model will resolve it
+against the current working directory and brain files will end up in the
+project root.
 
 ## Parameters
 

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

@@ -171,7 +171,7 @@ and ask them to resolve manually before retrying.
 `server_port: 4242` is the *preferred starting port*, not the guaranteed port.
 When the server starts in Step 7 it probes from this value upward and writes
 the actual bound port back to this same file. After Step 7, always re-read
-`_meta/config.json` to get the real port — never hardcode `4242` in downstream
+`{target_path}/_meta/config.json` to get the real port — never hardcode `4242` in downstream
 calls. This matters especially when migrating while another brain is already
 running on 4242.
 

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

@@ -14,8 +14,15 @@ You answer questions from the brain's content by dispatching a query subagent.
 
 ## Config
 
-Read `_meta/config.json` for brain path and server port.
-If it doesn't exist, trigger wicked-brain:init.
+Resolve the brain config via the shared resolution in
+wicked-brain:init § "Resolving the brain config". In short: try
+`~/.wicked-brain/projects/{cwd_basename}/_meta/config.json` first, fall back
+to `~/.wicked-brain/_meta/config.json` (legacy flat), else trigger
+wicked-brain:init. Read the resolved file for brain path and server port.
+
+Do NOT read a bare relative `_meta/config.json` — the model will resolve it
+against the current working directory and brain files will end up in the
+project root.
 
 ## Parameters
 

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

@@ -15,7 +15,15 @@ more than the user or calling skill needs.
 
 ## Config
 
-Read the brain path from `_meta/config.json`. If it doesn't exist, trigger wicked-brain:init.
+Resolve the brain config via the shared resolution in
+wicked-brain:init § "Resolving the brain config". In short: try
+`~/.wicked-brain/projects/{cwd_basename}/_meta/config.json` first, fall back
+to `~/.wicked-brain/_meta/config.json` (legacy flat), else trigger
+wicked-brain:init. Read the resolved file for brain path and server port.
+
+Do NOT read a bare relative `_meta/config.json` — the model will resolve it
+against the current working directory and brain files will end up in the
+project root.
 
 ## Parameters
 

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

@@ -21,8 +21,15 @@ Scan chunks and memories with thin tagging and expand their `contains:` with syn
 
 ## Config
 
-Read `_meta/config.json` for brain path and server port.
-If it doesn't exist, trigger wicked-brain:init.
+Resolve the brain config via the shared resolution in
+wicked-brain:init § "Resolving the brain config". In short: try
+`~/.wicked-brain/projects/{cwd_basename}/_meta/config.json` first, fall back
+to `~/.wicked-brain/_meta/config.json` (legacy flat), else trigger
+wicked-brain:init. Read the resolved file for brain path and server port.
+
+Do NOT read a bare relative `_meta/config.json` — the model will resolve it
+against the current working directory and brain files will end up in the
+project root.
 
 ## Parameters
 

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

@@ -23,8 +23,15 @@ compact, navigable list.
 
 ## Config
 
-Read `_meta/config.json` for brain path and server port.
-If it doesn't exist, trigger wicked-brain:init.
+Resolve the brain config via the shared resolution in
+wicked-brain:init § "Resolving the brain config". In short: try
+`~/.wicked-brain/projects/{cwd_basename}/_meta/config.json` first, fall back
+to `~/.wicked-brain/_meta/config.json` (legacy flat), else trigger
+wicked-brain:init. Read the resolved file for brain path and server port.
+
+Do NOT read a bare relative `_meta/config.json` — the model will resolve it
+against the current working directory and brain files will end up in the
+project root.
 
 ## Parameters
 

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

@@ -26,8 +26,15 @@ For the brain path default:
 
 ## Config
 
-Read `_meta/config.json` for brain path and server port.
-If it doesn't exist, trigger wicked-brain:init.
+Resolve the brain config via the shared resolution in
+wicked-brain:init § "Resolving the brain config". In short: try
+`~/.wicked-brain/projects/{cwd_basename}/_meta/config.json` first, fall back
+to `~/.wicked-brain/_meta/config.json` (legacy flat), else trigger
+wicked-brain:init. Read the resolved file for brain path and server port.
+
+Do NOT read a bare relative `_meta/config.json` — the model will resolve it
+against the current working directory and brain files will end up in the
+project root.
 
 ## Parameters
 

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

@@ -18,8 +18,23 @@ platform differences, alternatives are shown. Your native tools (Read, Write,
 Grep, Glob) work everywhere — prefer them over shell commands when possible.
 
 For the brain path default:
-- macOS/Linux: ~/.wicked-brain
-- Windows: %USERPROFILE%\.wicked-brain
+- macOS/Linux: `~/.wicked-brain/projects/{cwd_basename}`
+- Windows: `%USERPROFILE%\.wicked-brain\projects\{cwd_basename}`
+
+## Config
+
+Resolve the brain config via the shared resolution in
+wicked-brain:init § "Resolving the brain config". In short: try
+`~/.wicked-brain/projects/{cwd_basename}/_meta/config.json` first, fall back
+to `~/.wicked-brain/_meta/config.json` (legacy flat), else trigger
+wicked-brain:init. Read the resolved file to get `brain_path` and `server_port`.
+
+If the calling skill already passed `brain_path`, use that directly instead of
+re-resolving.
+
+Do NOT read a bare relative `_meta/config.json` — the model will resolve it
+against the current working directory and brain files will end up in the
+project root.
 
 ## When to use
 
@@ -48,7 +63,7 @@ For the brain path default:
       - 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.
-      Also pass `--source` if `source_path` is set in `_meta/config.json`
+      Also pass `--source` if `source_path` is set in `{brain_path}/_meta/config.json`
       (this roots LSP language servers at the ingested project so symbol
       lookup and go-to-definition work correctly):
       ```bash

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

@@ -24,8 +24,15 @@ For the brain path default:
 
 ## Config
 
-Read `_meta/config.json` for brain path and server port.
-If it doesn't exist, trigger wicked-brain:init.
+Resolve the brain config via the shared resolution in
+wicked-brain:init § "Resolving the brain config". In short: try
+`~/.wicked-brain/projects/{cwd_basename}/_meta/config.json` first, fall back
+to `~/.wicked-brain/_meta/config.json` (legacy flat), else trigger
+wicked-brain:init. Read the resolved file for brain path and server port.
+
+Do NOT read a bare relative `_meta/config.json` — the model will resolve it
+against the current working directory and brain files will end up in the
+project root.
 
 ## Parameters
 

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

@@ -25,8 +25,15 @@ For the brain path default:
 
 ## Config
 
-Read `_meta/config.json` for brain path and server port.
-If it doesn't exist, trigger wicked-brain:init.
+Resolve the brain config via the shared resolution in
+wicked-brain:init § "Resolving the brain config". In short: try
+`~/.wicked-brain/projects/{cwd_basename}/_meta/config.json` first, fall back
+to `~/.wicked-brain/_meta/config.json` (legacy flat), else trigger
+wicked-brain:init. Read the resolved file for brain path and server port.
+
+Do NOT read a bare relative `_meta/config.json` — the model will resolve it
+against the current working directory and brain files will end up in the
+project root.
 
 ## Synonym File