@nano-step/nano-brain 2026.6.202 → 2026.6.204

package/README.md

@@ -122,8 +122,8 @@ watcher:
   debounce_ms: 2000
   reindex_interval: 300
   # Per-collection exclude_patterns and allowed_extensions are also supported
-  # via the workspaces map. See "Global ignore patterns" section below for
-  # the cross-collection .nano-brainignore file.
+  # via the workspaces map. See "Ignore patterns" section below for the
+  # global and workspace-local .nano-brainignore files.
 
 storage:
   max_file_size: 314572800      # 300MB
@@ -188,15 +188,17 @@ curl -H "Authorization: Bearer nbt_..." http://host:3100/api/v1/query -d '{"quer
 # url: http://admin:mypassword@host:3100/mcp
 ```
 
-### Global ignore patterns (`~/.nano-brain/.nano-brainignore`)
+### Ignore patterns
 
-The watcher loads a global gitignore-style file at `~/.nano-brain/.nano-brainignore`
-on startup. Patterns in this file apply to **all** registered collections, removing
-the need to repeat the same exclusions in each `watcher.workspaces` block.
+Two layers of `.nano-brainignore` files control what the watcher indexes,
+both using standard `.gitignore` syntax (one pattern per line, supports `**`,
+`!negation`, blank lines, `#` comments).
 
-**Format**: standard `.gitignore` syntax (one pattern per line, supports `**`, `!negation`, blank lines, `#` comments).
+#### Global — `~/.nano-brain/.nano-brainignore`
 
-**Example** `~/.nano-brain/.nano-brainignore`:
+Loaded once at server startup. Patterns apply to **every** registered
+collection across **every** workspace. Use this for rules that are personal
+to your machine and span all your projects (e.g. always skip `*.png`).
 
 ```
 # Skip generated files everywhere
@@ -211,15 +213,52 @@ node_modules/
 !icons/important.png
 ```
 
-**Order of evaluation** (most aggressive first):
+#### Workspace-local — `<workspace_root>/.nano-brainignore`
+
+Loaded once per collection when the watcher starts watching it (server
+startup, `POST /api/v1/init`, or `POST /api/v1/collections`). Patterns
+apply **only** to that one workspace. Use this for project-specific rules
+you want to **share with your team via version control** — e.g. skip
+generated code that you commit to git but don't want indexed.
+
+```
+# nano-brain-specific rules for this repo (commit me)
+*.generated.go
+fixtures/large/
+*.snap
+```
+
+Workspace-local rules layer **additively** on top of global rules and
+per-collection `.gitignore`. There is no cross-file negation: a `!pattern`
+in workspace-local cannot un-exclude a path matched by global.
+
+The file at the workspace root is loaded for the `code` collection. The
+sibling `memory` and `sessions` collections are rooted under `~/.nano-brain/`
+and do not normally need their own ignore files.
+
+#### Order of evaluation (most aggressive first)
 
 1. Hardcoded default exclude dirs (`node_modules`, `.git`, `dist`, `build`, `target`, etc.)
-2. **Global `.nano-brainignore`** (this feature)
-3. Per-collection `.gitignore` (in collection root)
-4. Per-collection `exclude_patterns` (config-level)
-5. Per-collection `allowed_extensions` (whitelist)
+2. Global `~/.nano-brain/.nano-brainignore`
+3. Workspace-local `<workspace_root>/.nano-brainignore`
+4. Per-collection `.gitignore` (in collection root)
+5. Per-collection `exclude_patterns` (config-level)
+6. Per-collection `allowed_extensions` (whitelist)
+
+#### Reloading
+
+Both global and workspace-local files are loaded at collection registration
+time. To pick up edits:
+
+- **Global**: restart the server.
+- **Workspace-local**: restart the server, OR re-register the workspace
+  with `POST /api/v1/init` (this rebuilds the collection's filter and
+  re-reads the file).
+
+`POST /api/reload-config` does **not** re-read ignore files — only search
+config and log level are reloaded by that endpoint.
 
-**Restart required**: changes to `.nano-brainignore` take effect on next server start (hot-reload deferred to a follow-up). Issue #263.
+Issues: #263 (global), #317 (workspace-local).
 
 ### Session Summarization
 
@@ -311,6 +350,7 @@ docker run -d \
 | GET | `/api/status` | Server status with version, uptime, workspace stats |
 | POST | `/api/v1/init` | Register workspace |
 | GET | `/api/v1/workspaces` | List all workspaces (with doc counts) |
+| POST | `/api/v1/workspaces/resolve` | Resolve path → workspace hash + `registered` status (read-only) |
 | DELETE | `/api/v1/workspaces/:hash` | Permanently delete a workspace + cascade docs/chunks/embeddings |
 | GET | `/api/v1/wake-up` | Workspace briefing |
 | POST | `/api/harvest` | Trigger session harvesting |
@@ -353,6 +393,7 @@ Workspace is passed in the JSON body for POST, query param for GET.
 | `nano-brain` (no args) | Start HTTP server (default: port 3100) |
 | `nano-brain init --root=<path>` | Register workspace |
 | `nano-brain workspaces list` | List registered workspaces with doc counts |
+| `nano-brain workspaces current [--path=<p>] [--export\|--json\|--check]` | Resolve current/path workspace hash. `--export` prints `export NANO_BRAIN_WORKSPACE=<hash>` for `eval`; `--check` exits 2 if not registered |
 | `nano-brain workspaces remove --workspace=<hash> [--dry-run\|--force]` | Permanently delete a workspace + all its documents/chunks/embeddings |
 | `nano-brain write` | Write document via CLI |
 | `nano-brain query [--scope=all] [--tags=t1,t2]` | Hybrid search (BM25 + vector + RRF + recency) |
@@ -379,7 +420,7 @@ Workspace is passed in the JSON body for POST, query param for GET.
 
 ## MCP Tools
 
-nano-brain exposes 13 tools via MCP (Model Context Protocol):
+nano-brain exposes 14 tools via MCP (Model Context Protocol):
 
 | Tool | Description |
 |------|-------------|
@@ -396,6 +437,7 @@ nano-brain exposes 13 tools via MCP (Model Context Protocol):
 | `memory_trace` | Call chain trace from entry point |
 | `memory_impact` | Cross-file change impact analysis |
 | `memory_symbols` | Symbol search (functions, types, constants) |
+| `memory_workspaces_resolve` | Resolve filesystem path → workspace hash + registered status (read-only) |
 
 ### MCP Configuration
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nano-step/nano-brain",
-  "version": "2026.6.202",
+  "version": "2026.6.204",
   "description": "Persistent memory and code intelligence for AI coding agents",
   "bin": {
     "nano-brain": "npm/run.js"