neuro-vault-mcp 2.0.0 → 3.1.0

package/README.md

@@ -13,8 +13,9 @@
 ## ✨ Why Neuro Vault?
 
 - 🧠 **Semantic search over your existing vault** — reuses [Smart Connections](https://github.com/brianpetro/obsidian-smart-connections) embeddings already in your vault. No re-indexing, no API keys, no extra infrastructure.
-- 🎯 **Mode-aware retrieval** — `quick` for direct lookups, `deep` for exploratory questions with block-level results and semantic expansion of related notes.
+- 🎯 **Mode-aware retrieval** — `quick` for direct lookups, `deep` for exploratory questions with block-level results and semantic expansion of related notes. Pass `query: string[]` (up to 8) for synonyms, reformulations, or cross-language pairs — one merged result list with `matched_queries` per entry.
 - ✍️ **Direct vault operations** — read, create, append, and prepend notes; manage frontmatter properties and inspect tags (including daily notes) straight from your AI assistant via the [Obsidian CLI](https://github.com/AlexMost/obsidian-cli).
+- 🔎 **Structured queries** — one MongoDB-style call (`query_notes`) replaces N+1 chains like "list tags → read each note's property". Ask "active projects with #ai" or "todo tasks created this week" and get a single ranked response.
 - ⚡ **Zero infrastructure** — local stdio MCP server, in-memory index, no database, no background processes, no watchers.
 - 🔌 **Drop-in for any MCP client** — Claude Code, Cursor, Windsurf — configuration is a single JSON block.
 
@@ -70,7 +71,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
+- [Vault Operations](./docs/guide/vault-operations.md) — note CRUD, daily notes, properties, tags, structured queries (`query_notes`)
 - [Routing Between Tools](./docs/guide/routing.md)
 - [Configuration](./docs/guide/configuration.md) — CLI args, troubleshooting, limitations, **migration to 2.0**, development
 

package/dist/cli.d.ts

@@ -2,16 +2,6 @@
 import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
 
-interface RetrievalOutput {
-    results: SearchResult[];
-    blockResults?: BlockSearchResult[];
-}
-interface MultiRetrievalOutput {
-    results: MultiSearchResult[];
-    blockResults?: MultiBlockSearchResult[];
-    truncated: boolean;
-}
-
 interface SmartBlock {
     key: string;
     heading: string;
@@ -32,6 +22,7 @@ interface BlockSearchResult {
 interface SearchResult {
     path: string;
     similarity: number;
+    via_expansion?: true;
 }
 interface DuplicatePair {
     note_a: string;
@@ -61,49 +52,7 @@ interface SearchEngine {
         threshold: number;
     }): DuplicatePair[];
 }
-type SearchMode = 'quick' | 'deep';
-interface SearchNotesInput {
-    query: string | string[];
-    mode?: SearchMode;
-    limit?: number;
-    threshold?: number;
-}
-interface GetSimilarNotesInput {
-    path: string;
-    limit?: number;
-    threshold?: number;
-}
-interface FindDuplicatesInput {
-    threshold?: number;
-}
-interface ToolStats {
-    totalNotes: number;
-    totalBlocks: number;
-    embeddingDimension: number;
-    modelKey: string;
-}
 type PathExistsCheck = (vaultRelativePath: string) => Promise<boolean>;
-interface ToolHandlerDependencies {
-    loader: {
-        sources: Map<string, SmartSource>;
-    };
-    embeddingProvider: EmbeddingProvider;
-    searchEngine: SearchEngine;
-    modelKey: string;
-    pathExists?: PathExistsCheck;
-}
-interface ToolHandlers {
-    searchNotes(input: SearchNotesInput): Promise<RetrievalOutput | MultiRetrievalOutput>;
-    getSimilarNotes(input: GetSimilarNotesInput): Promise<SearchResult[]>;
-    findDuplicates(input?: FindDuplicatesInput): Promise<DuplicatePair[]>;
-    getStats(): Promise<ToolStats>;
-}
-interface MultiSearchResult extends SearchResult {
-    matched_queries: string[];
-}
-interface MultiBlockSearchResult extends BlockSearchResult {
-    matched_queries: string[];
-}
 
 interface SmartConnectionsCorpus {
     sources: Map<string, SmartSource>;
@@ -113,7 +62,6 @@ interface SemanticModuleDeps {
     loadCorpus?: (smartEnvPath: string, modelKey: string) => Promise<SmartConnectionsCorpus>;
     embeddingServiceFactory?: (modelId: string) => EmbeddingProvider;
     searchEngine?: SearchEngine;
-    toolHandlersFactory?: (deps: ToolHandlerDependencies) => ToolHandlers;
     pathExists?: PathExistsCheck;
 }
 
@@ -175,15 +123,6 @@ interface TagListEntry {
     name: string;
     count: number;
 }
-interface GetTagInput {
-    name: string;
-    includeFiles?: boolean;
-}
-interface GetTagResult {
-    name: string;
-    count: number;
-    files?: string[];
-}
 interface VaultProvider {
     createNote(input: CreateNoteInput): Promise<CreateNoteResult>;
     editNote(input: EditNoteInput): Promise<void>;
@@ -194,7 +133,6 @@ interface VaultProvider {
     removeProperty(input: RemovePropertyInput): Promise<void>;
     listProperties(): Promise<PropertyListEntry[]>;
     listTags(): Promise<TagListEntry[]>;
-    getTag(input: GetTagInput): Promise<GetTagResult>;
 }
 
 type ExecFn = (binary: string, args: string[], options: {
@@ -228,8 +166,12 @@ interface ReadNotesInput {
     paths: string[];
     fields: ReadNotesField[];
 }
+interface ScanOptions {
+    pathPrefix?: string;
+}
 interface VaultReader {
     readNotes(input: ReadNotesInput): Promise<ReadNotesItem[]>;
+    scan(opts?: ScanOptions): Promise<string[]>;
 }
 
 interface OperationsModuleDeps {