neuro-vault-mcp 4.0.1 → 4.2.0

package/README.md

@@ -18,7 +18,7 @@ Your second brain stops being a folder you open between contexts and becomes a f
 
 - 🧠 **Semantic search that already knows your vault** — reuses [Smart Connections](https://github.com/brianpetro/obsidian-smart-connections) embeddings. No re-indexing, no API keys, no extra infrastructure.
 - 🎯 **Quick or deep, your call** — fast direct lookups for "find that note", or exploratory mode with related-note expansion when the question is fuzzy.
-- 🧭 **A real navigation toolkit for your agent** — instead of grepping files and opening notes one by one, your assistant walks the vault like a database: filter by tags and properties, batch-read metadata, discover the structure, jump to semantic neighbours.
+- 🧭 **A real navigation toolkit for your agent** — instead of grepping files and opening notes one by one, your assistant walks the vault like a database: filter by tags and properties, batch-read metadata, traverse the wikilink graph, discover the structure, jump to semantic neighbours.
 - 🔎 **Ask structured questions in plain language** — _"active projects tagged #ai"_, _"todo tasks with a deadline this week"_, _"meeting notes from `Work/` newest first"_ — one call, ranked answer, no chains of reads.
 - ✍️ **Read and write through Obsidian itself** — create, append, edit notes, manage frontmatter and daily notes via the [Obsidian CLI](https://github.com/AlexMost/obsidian-cli), so Smart Connections, sync, and other plugins stay in the loop.
 - ⚡ **Zero infrastructure** — local stdio MCP server, in-memory index, no database, no background processes, no watchers.

package/dist/cli.d.ts

@@ -18,6 +18,63 @@ interface SmartConnectionsCorpus {
     sources: Map<string, SmartSource>;
 }
 
+type ReadNotesField = 'frontmatter' | 'content';
+interface ReadNotesItemSuccess {
+    path: string;
+    frontmatter: Record<string, unknown> | null;
+    content: string;
+}
+interface ReadNotesItemError {
+    path: string;
+    error: {
+        code: 'NOT_FOUND' | 'INVALID_ARGUMENT' | 'READ_FAILED';
+        message: string;
+    };
+}
+type ReadNotesItem = ReadNotesItemSuccess | ReadNotesItemError;
+interface ReadNotesInput {
+    paths: string[];
+    fields: ReadNotesField[];
+}
+interface ScanOptions {
+    pathPrefix?: string;
+}
+interface VaultReader {
+    readNotes(input: ReadNotesInput): Promise<ReadNotesItem[]>;
+    scan(opts?: ScanOptions): Promise<string[]>;
+}
+
+interface OutgoingLink {
+    target: string;
+    resolved: boolean;
+    path?: string;
+}
+interface IncomingLink {
+    source: string;
+}
+interface NoteLinks {
+    incoming: IncomingLink[];
+    outgoing: OutgoingLink[];
+}
+interface WikilinkGraphIndexOptions {
+    reader: VaultReader;
+    ttlMs?: number;
+    now?: () => number;
+}
+declare class WikilinkGraphIndex {
+    private readonly reader;
+    private readonly ttlMs;
+    private readonly now;
+    private byPath;
+    private lastBuildAt;
+    private buildPromise;
+    constructor(opts: WikilinkGraphIndexOptions);
+    ensureFresh(): Promise<void>;
+    getNoteLinks(notePath: string): NoteLinks;
+    getBacklinkCount(notePath: string): number;
+    private rebuild;
+}
+
 interface BlockSearchResult {
     path: string;
     heading: string;
@@ -65,6 +122,10 @@ interface SemanticModuleDeps {
     searchEngine?: SearchEngine;
     pathExists?: PathExistsCheck;
     readNoteContent?: (vaultRelativePath: string) => Promise<string>;
+    graph?: WikilinkGraphIndex;
+    vaultReaderFactory?: (opts: {
+        vaultRoot: string;
+    }) => VaultReader;
 }
 
 type NoteIdentifier = {
@@ -150,37 +211,12 @@ interface ObsidianCLIProviderOptions {
     exec?: ExecFn;
 }
 
-type ReadNotesField = 'frontmatter' | 'content';
-interface ReadNotesItemSuccess {
-    path: string;
-    frontmatter: Record<string, unknown> | null;
-    content: string;
-}
-interface ReadNotesItemError {
-    path: string;
-    error: {
-        code: 'NOT_FOUND' | 'INVALID_ARGUMENT' | 'READ_FAILED';
-        message: string;
-    };
-}
-type ReadNotesItem = ReadNotesItemSuccess | ReadNotesItemError;
-interface ReadNotesInput {
-    paths: string[];
-    fields: ReadNotesField[];
-}
-interface ScanOptions {
-    pathPrefix?: string;
-}
-interface VaultReader {
-    readNotes(input: ReadNotesInput): Promise<ReadNotesItem[]>;
-    scan(opts?: ScanOptions): Promise<string[]>;
-}
-
 interface OperationsModuleDeps {
     vaultProviderFactory?: (opts: ObsidianCLIProviderOptions) => VaultProvider;
     vaultReaderFactory?: (opts: {
         vaultRoot: string;
     }) => VaultReader;
+    graph?: WikilinkGraphIndex;
 }
 
 type ToolServer = Pick<McpServer, 'registerTool' | 'connect'>;