neuro-vault-mcp 5.2.0 → 5.4.0

package/README.md

@@ -55,6 +55,7 @@ A few more questions Neuro Vault makes one-shot:
 > _"Show meeting notes from `Work/` from the last two weeks, newest first."_
 > _"Find notes similar to this one I'm reading."_
 > _"Append today's decision to the daily note."_
+> _"What's on my agenda today — and what did I capture in other notes since this morning?"_
 > _"What did past-me write about retrieval policy before I started building it?"_
 
 One question, one answer. Your assistant stops being a file browser and starts being an actual second brain.
@@ -125,7 +126,7 @@ User guide lives in [`docs/guide/`](./docs/guide/README.md):
 
 - [Installation](./docs/guide/installation.md)
 - [Semantic Search](./docs/guide/semantic-search.md) — `search_notes`, `get_similar_notes`, `find_duplicates`, `get_stats`
-- [Vault Operations](./docs/guide/vault-operations.md) — note CRUD, daily notes, properties, tags, structured queries (`query_notes`)
+- [Vault Operations](./docs/guide/vault-operations.md) — note CRUD, daily notes, properties, tags, structured queries (`query_notes`), vault snapshot (`get_vault_overview`)
 - [Routing Between Tools](./docs/guide/routing.md)
 - [Configuration](./docs/guide/configuration.md) — CLI args, troubleshooting, limitations, **migration to 2.0**, development
 
@@ -133,6 +134,12 @@ Architecture / internals: [`docs/architecture/`](./docs/architecture/).
 
 ---
 
+### Vault-specific conventions for external agents
+
+When the server starts, it looks for `<vault>/.neuro-vault/for-external-agents.md`. If the file exists, its content is appended to the MCP `instructions` that clients receive at `initialize`, under a `## Vault-specific conventions` section. Use this file to teach external agents vault-specific rules that cannot be derived from the snapshot — for example, closed sets of frontmatter `type` values, or folders that are off-limits for writes. The file is optional; without it the server still ships sane defaults plus a pointer to `get_vault_overview`.
+
+---
+
 ## 📄 License
 
 ISC — see [LICENSE](LICENSE).

package/dist/cli.d.ts

@@ -242,11 +242,11 @@ interface OperationsModuleDeps {
     graph?: WikilinkGraphIndex;
 }
 
-type ToolServer = Pick<McpServer, 'registerTool' | 'connect'>;
+type ToolServer = Pick<McpServer, 'registerTool' | 'registerResource' | 'connect'>;
 interface NeuroVaultStartupDependencies {
     semantic?: SemanticModuleDeps;
     operations?: OperationsModuleDeps;
-    serverFactory?: () => ToolServer;
+    serverFactory?: (instructions: string) => ToolServer;
     transportFactory?: () => StdioServerTransport;
 }