@bitbonsai/mcpvault 0.12.1 → 0.12.4

package/dist/src/createServer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"createServer.d.ts","sourceRoot":"","sources":["../../src/createServer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AAMnE,OAAO,EAAE,kBAAkB,EAAoB,MAAM,kBAAkB,CAAC;AACxE,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAI7C,MAAM,WAAW,mBAAmB;IAClC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,kBAAkB,CAAC,EAAE,kBAAkB,CAAC;CACzC;AAED,wBAAgB,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,GAAE,mBAAwB,GAAG,MAAM,CAoZzF"}
+{"version":3,"file":"createServer.d.ts","sourceRoot":"","sources":["../../src/createServer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AAMnE,OAAO,EAAE,kBAAkB,EAAoB,MAAM,kBAAkB,CAAC;AACxE,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAK7C,MAAM,WAAW,mBAAmB;IAClC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,kBAAkB,CAAC,EAAE,kBAAkB,CAAC;CACzC;AAED,wBAAgB,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,GAAE,mBAAwB,GAAG,MAAM,CA0azF"}

package/dist/src/createServer.js

@@ -4,6 +4,7 @@ import { FileSystemService } from "./filesystem.js";
 import { FrontmatterHandler, parseFrontmatter } from "./frontmatter.js";
 import { PathFilter } from "./pathfilter.js";
 import { SearchService } from "./search.js";
+import { handleWikiLinkTool } from "./wikilink/index.js";
 import { resolve } from "path";
 export function createServer(vaultPath, options = {}) {
     const { name = "mcpvault", version = "0.0.0", pathFilter = new PathFilter(), frontmatterHandler = new FrontmatterHandler(), } = options;
@@ -210,6 +211,25 @@ export function createServer(vaultPath, options = {}) {
                             prettyPrint: { type: "boolean", description: "Format JSON response with indentation (default: false)", default: false }
                         }
                     }
+                },
+                {
+                    name: "wiki_link",
+                    description: "Read an Obsidian wiki link. Accepts the same syntax as Obsidian: [[Document Name]] or [[Document Name|Display Text]], including table-authored escapes like [[Document Name\\|Display]] and path-qualified links like [[folder/Document Name]]. A #fragment suffix in the input is ignored. Searches the vault for an exact basename match (or exact vault-relative path match when the name contains '/') and returns the file's content. When multiple files share the basename, picks the first (vault root first, then alphabetical by path) and lists the other paths in structuredContent.alternatives. Content is returned bare — ready for direct use in context.",
+                    inputSchema: {
+                        type: "object",
+                        properties: {
+                            document: {
+                                type: "string",
+                                description: "The document name — what goes inside [[ ]]. e.g. 'My-Document'. Brackets and display text (|...) are stripped if present. The .md extension is always appended (never include it)."
+                            },
+                            prettyPrint: {
+                                type: "boolean",
+                                description: "Format JSON response with indentation (default: false)",
+                                default: false
+                            }
+                        },
+                        required: ["document"]
+                    }
                 }
             ]
         };
@@ -372,6 +392,8 @@ export function createServer(vaultPath, options = {}) {
                         content: [{ type: "text", text: JSON.stringify(tags, null, indent) }]
                     };
                 }
+                case "wiki_link":
+                    return await handleWikiLinkTool(fileSystem, trimmedArgs);
                 default:
                     throw new Error(`Unknown tool: ${toolName}`);
             }

package/dist/src/filesystem.d.ts

@@ -16,6 +16,12 @@ export declare class FileSystemService {
     private frontmatterHandler;
     private pathFilter;
     constructor(vaultPath: string, pathFilter?: PathFilter, frontmatterHandler?: FrontmatterHandler);
+    /**
+     * Normalize an incoming path to be vault-relative. Strips leading slashes
+     * and the vault path prefix when a caller accidentally passes an absolute path
+     * (e.g. "/Users/me/vault/wiki/note.md" instead of "wiki/note.md").
+     */
+    private normalizePath;
     private resolvePath;
     readNote(path: string): Promise<ParsedNote>;
     writeNote(params: NoteWriteParams): Promise<void>;
@@ -31,6 +37,22 @@ export declare class FileSystemService {
     getNotesInfo(paths: string[]): Promise<NoteInfo[]>;
     manageTags(params: TagManagementParams): Promise<TagManagementResult>;
     getVaultPath(): string;
+    /**
+     * Resolve an Obsidian wiki link name to its vault-relative paths.
+     * Scans the vault for exact filename matches (name + .md).
+     *
+     * A name containing `/` is path-qualified (Obsidian emits these when a
+     * basename is ambiguous, e.g. [[folder/Note]]): it must match the full
+     * vault-relative path instead of just the basename.
+     *
+     * Returns all matches sorted root-first (by path depth ascending), with
+     * alphabetical tiebreak at equal depth. Empty array on zero matches.
+     * The caller decides how to handle zero/single/multi — this function does
+     * not throw on lookup outcomes.
+     *
+     * Throws only on caller misuse (empty name).
+     */
+    findPathForWikiLink(wikiLinkName: string): Promise<string[]>;
     getVaultStats(recentCount?: number): Promise<VaultStats>;
     listAllTags(): Promise<Array<{
         tag: string;

package/dist/src/filesystem.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"filesystem.d.ts","sourceRoot":"","sources":["../../src/filesystem.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAE7C,OAAO,KAAK,EAAE,UAAU,EAAE,gBAAgB,EAAE,eAAe,EAAE,gBAAgB,EAAE,YAAY,EAAE,cAAc,EAAE,cAAc,EAAE,UAAU,EAAE,eAAe,EAAE,eAAe,EAAE,uBAAuB,EAAE,QAAQ,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,eAAe,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAEzT;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,KAAK,CAiBtE;AAED,qBAAa,iBAAiB;IAK1B,OAAO,CAAC,SAAS;IAJnB,OAAO,CAAC,kBAAkB,CAAqB;IAC/C,OAAO,CAAC,UAAU,CAAa;gBAGrB,SAAS,EAAE,MAAM,EACzB,UAAU,CAAC,EAAE,UAAU,EACvB,kBAAkB,CAAC,EAAE,kBAAkB;IAazC,OAAO,CAAC,WAAW;IA6Db,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;IAgC3C,SAAS,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;IA2EjD,SAAS,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,eAAe,CAAC;IA2F5D,aAAa,CAAC,IAAI,GAAE,MAAW,GAAG,OAAO,CAAC,gBAAgB,CAAC;IA8D3D,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAetC,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAe3C,UAAU,CAAC,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAAC,YAAY,CAAC;IAyG3D,QAAQ,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO,CAAC,UAAU,CAAC;IAoFrD,QAAQ,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO,CAAC,UAAU,CAAC;IA6HrD,iBAAiB,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,eAAe,CAAC;IAgDpE,iBAAiB,CAAC,MAAM,EAAE,uBAAuB,GAAG,OAAO,CAAC,IAAI,CAAC;IAqCjE,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC;IA2ClD,UAAU,CAAC,MAAM,EAAE,mBAAmB,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAsG3E,YAAY,IAAI,MAAM;IAIhB,aAAa,CAAC,WAAW,GAAE,MAAU,GAAG,OAAO,CAAC,UAAU,CAAC;IAyD3D,WAAW,IAAI,OAAO,CAAC,KAAK,CAAC;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAkDpE"}
+{"version":3,"file":"filesystem.d.ts","sourceRoot":"","sources":["../../src/filesystem.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAE7C,OAAO,KAAK,EAAE,UAAU,EAAE,gBAAgB,EAAE,eAAe,EAAE,gBAAgB,EAAE,YAAY,EAAE,cAAc,EAAE,cAAc,EAAE,UAAU,EAAE,eAAe,EAAE,eAAe,EAAE,uBAAuB,EAAE,QAAQ,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,eAAe,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAEzT;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,KAAK,CAiBtE;AAED,qBAAa,iBAAiB;IAK1B,OAAO,CAAC,SAAS;IAJnB,OAAO,CAAC,kBAAkB,CAAqB;IAC/C,OAAO,CAAC,UAAU,CAAa;gBAGrB,SAAS,EAAE,MAAM,EACzB,UAAU,CAAC,EAAE,UAAU,EACvB,kBAAkB,CAAC,EAAE,kBAAkB;IAazC;;;;OAIG;IACH,OAAO,CAAC,aAAa;IAsBrB,OAAO,CAAC,WAAW;IAkDb,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;IAiC3C,SAAS,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;IA4EjD,SAAS,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,eAAe,CAAC;IA8F5D,aAAa,CAAC,IAAI,GAAE,MAAW,GAAG,OAAO,CAAC,gBAAgB,CAAC;IA8D3D,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAgBtC,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAgB3C,UAAU,CAAC,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAAC,YAAY,CAAC;IA2G3D,QAAQ,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO,CAAC,UAAU,CAAC;IAsFrD,QAAQ,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO,CAAC,UAAU,CAAC;IAiIrD,iBAAiB,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,eAAe,CAAC;IAiDpE,iBAAiB,CAAC,MAAM,EAAE,uBAAuB,GAAG,OAAO,CAAC,IAAI,CAAC;IAsCjE,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC;IA4ClD,UAAU,CAAC,MAAM,EAAE,mBAAmB,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAuG3E,YAAY,IAAI,MAAM;IAItB;;;;;;;;;;;;;;OAcG;IACG,mBAAmB,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAiD5D,aAAa,CAAC,WAAW,GAAE,MAAU,GAAG,OAAO,CAAC,UAAU,CAAC;IAyD3D,WAAW,IAAI,OAAO,CAAC,KAAK,CAAC;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAkDpE"}

package/dist/src/filesystem.js

@@ -1,4 +1,5 @@
 import { join, resolve, relative, dirname } from 'path';
+import { homedir } from 'os';
 import { readdir, stat, readFile, writeFile, unlink, mkdir, access, rename, copyFile } from 'node:fs/promises';
 import { constants, realpathSync } from 'node:fs';
 import trash from 'trash';
@@ -49,17 +50,37 @@ export class FileSystemService {
         this.pathFilter = pathFilter || new PathFilter();
         this.frontmatterHandler = frontmatterHandler || new FrontmatterHandler();
     }
+    /**
+     * Normalize an incoming path to be vault-relative. Strips leading slashes
+     * and the vault path prefix when a caller accidentally passes an absolute path
+     * (e.g. "/Users/me/vault/wiki/note.md" instead of "wiki/note.md").
+     */
+    normalizePath(inputPath) {
+        if (!inputPath)
+            return '';
+        let p = inputPath.trim();
+        // Expand ~ to home directory so "~/vault/note.md" can be matched
+        if (p.startsWith('~/') || p === '~') {
+            p = p.replace('~', homedir());
+        }
+        // Normalize path separators for cross-platform comparison (Windows backslashes)
+        const normalized = p.replace(/\\/g, '/');
+        const vaultPrefix = this.vaultPath.replace(/\\/g, '/');
+        // Strip vault path prefix before stripping leading slash, so absolute paths
+        // like "/Users/me/vault/wiki/note.md" are handled correctly.
+        if (normalized.startsWith(vaultPrefix + '/')) {
+            p = normalized.slice(vaultPrefix.length + 1);
+        }
+        else if (normalized === vaultPrefix) {
+            p = '';
+        }
+        else if (p.startsWith('/')) {
+            p = p.slice(1);
+        }
+        return p;
+    }
     resolvePath(relativePath) {
-        // Handle undefined or null path
-        if (!relativePath) {
-            relativePath = '';
-        }
-        // Trim whitespace from path
-        relativePath = relativePath.trim();
-        // Normalize and resolve the path within the vault
-        const normalizedPath = relativePath.startsWith('/')
-            ? relativePath.slice(1)
-            : relativePath;
+        const normalizedPath = this.normalizePath(relativePath);
         const fullPath = resolve(join(this.vaultPath, normalizedPath));
         // Security check: ensure path is within vault (lexical)
         const relativeToVault = relative(this.vaultPath, fullPath);
@@ -110,6 +131,7 @@ export class FileSystemService {
         return fullPath;
     }
     async readNote(path) {
+        path = this.normalizePath(path);
         const fullPath = this.resolvePath(path);
         if (!this.pathFilter.isAllowed(path)) {
             throw new Error(`Access denied: ${path}. This path is restricted (system files like .obsidian, .git, and dotfiles are not accessible).`);
@@ -139,7 +161,8 @@ export class FileSystemService {
         }
     }
     async writeNote(params) {
-        const { path, content, frontmatter, mode = 'overwrite' } = params;
+        const { content, frontmatter, mode = 'overwrite' } = params;
+        const path = this.normalizePath(params.path);
         const fullPath = this.resolvePath(path);
         if (!this.pathFilter.isAllowed(path)) {
             throw new Error(`Access denied: ${path}. This path is restricted (system files like .obsidian, .git, and dotfiles are not accessible).`);
@@ -201,7 +224,8 @@ export class FileSystemService {
         }
     }
     async patchNote(params) {
-        const { path, oldString, newString, replaceAll = false } = params;
+        const { oldString, newString, replaceAll = false } = params;
+        const path = this.normalizePath(params.path);
         if (!this.pathFilter.isAllowed(path)) {
             return {
                 success: false,
@@ -257,9 +281,11 @@ export class FileSystemService {
                 };
             }
             // Perform the replacement
+            // Use a replacer function so newString is inserted literally,
+            // without $ replacement pattern expansion ($$, $&, $`, $')
             const updatedContent = replaceAll
                 ? fullContent.split(oldString).join(newString)
-                : fullContent.replace(oldString, newString);
+                : fullContent.replace(oldString, () => newString);
             // Write the updated content
             const fullPath = this.resolvePath(path);
             await writeFile(fullPath, updatedContent, 'utf-8');
@@ -279,8 +305,8 @@ export class FileSystemService {
         }
     }
     async listDirectory(path = '') {
-        // Normalize path: treat '.' as root directory
-        const normalizedPath = path === '.' ? '' : path;
+        // Normalize path: treat '.' as root directory, strip vault prefix
+        const normalizedPath = path === '.' ? '' : this.normalizePath(path);
         const fullPath = this.resolvePath(normalizedPath);
         try {
             const entries = await readdir(fullPath, { withFileTypes: true });
@@ -340,6 +366,7 @@ export class FileSystemService {
         }
     }
     async exists(path) {
+        path = this.normalizePath(path);
         const fullPath = this.resolvePath(path);
         if (!this.pathFilter.isAllowed(path)) {
             return false;
@@ -353,6 +380,7 @@ export class FileSystemService {
         }
     }
     async isDirectory(path) {
+        path = this.normalizePath(path);
         const fullPath = this.resolvePath(path);
         if (!this.pathFilter.isAllowed(path)) {
             return false;
@@ -366,7 +394,9 @@ export class FileSystemService {
         }
     }
     async deleteNote(params) {
-        const { path, confirmPath, trashMode = 'none' } = params;
+        const { trashMode = 'none' } = params;
+        const path = this.normalizePath(params.path);
+        const confirmPath = this.normalizePath(params.confirmPath);
         // Confirmation check - paths must match exactly
         if (path !== confirmPath) {
             return {
@@ -459,7 +489,9 @@ export class FileSystemService {
         }
     }
     async moveNote(params) {
-        const { oldPath, newPath, overwrite = false } = params;
+        const { overwrite = false } = params;
+        const oldPath = this.normalizePath(params.oldPath);
+        const newPath = this.normalizePath(params.newPath);
         if (!this.pathFilter.isAllowed(oldPath)) {
             return {
                 success: false,
@@ -537,7 +569,11 @@ export class FileSystemService {
         }
     }
     async moveFile(params) {
-        const { oldPath, newPath, confirmOldPath, confirmNewPath, overwrite = false } = params;
+        const { overwrite = false } = params;
+        const oldPath = this.normalizePath(params.oldPath);
+        const newPath = this.normalizePath(params.newPath);
+        const confirmOldPath = this.normalizePath(params.confirmOldPath);
+        const confirmNewPath = this.normalizePath(params.confirmNewPath);
         if (oldPath !== confirmOldPath || newPath !== confirmNewPath) {
             return {
                 success: false,
@@ -661,7 +697,8 @@ export class FileSystemService {
         if (paths.length > 10) {
             throw new Error('Maximum 10 files per batch read request');
         }
-        const results = await Promise.allSettled(paths.map(async (path) => {
+        const results = await Promise.allSettled(paths.map(async (rawPath) => {
+            const path = this.normalizePath(rawPath);
             if (!this.pathFilter.isAllowed(path)) {
                 throw new Error(`Access denied: ${path}. This path is restricted (system files like .obsidian, .git, and dotfiles are not accessible).`);
             }
@@ -694,7 +731,8 @@ export class FileSystemService {
         return { successful, failed };
     }
     async updateFrontmatter(params) {
-        const { path, frontmatter, merge = true } = params;
+        const { frontmatter, merge = true } = params;
+        const path = this.normalizePath(params.path);
         if (!this.pathFilter.isAllowed(path)) {
             throw new Error(`Access denied: ${path}. This path is restricted (system files like .obsidian, .git, and dotfiles are not accessible).`);
         }
@@ -725,7 +763,8 @@ export class FileSystemService {
         }
     }
     async getNotesInfo(paths) {
-        const results = await Promise.allSettled(paths.map(async (path) => {
+        const results = await Promise.allSettled(paths.map(async (rawPath) => {
+            const path = this.normalizePath(rawPath);
             if (!this.pathFilter.isAllowed(path)) {
                 throw new Error(`Access denied: ${path}. This path is restricted (system files like .obsidian, .git, and dotfiles are not accessible).`);
             }
@@ -760,7 +799,8 @@ export class FileSystemService {
             .map(result => result.value);
     }
     async manageTags(params) {
-        const { path, operation, tags = [] } = params;
+        const { operation, tags = [] } = params;
+        const path = this.normalizePath(params.path);
         if (!this.pathFilter.isAllowed(path)) {
             return {
                 path,
@@ -851,6 +891,61 @@ export class FileSystemService {
     getVaultPath() {
         return this.vaultPath;
     }
+    /**
+     * Resolve an Obsidian wiki link name to its vault-relative paths.
+     * Scans the vault for exact filename matches (name + .md).
+     *
+     * A name containing `/` is path-qualified (Obsidian emits these when a
+     * basename is ambiguous, e.g. [[folder/Note]]): it must match the full
+     * vault-relative path instead of just the basename.
+     *
+     * Returns all matches sorted root-first (by path depth ascending), with
+     * alphabetical tiebreak at equal depth. Empty array on zero matches.
+     * The caller decides how to handle zero/single/multi — this function does
+     * not throw on lookup outcomes.
+     *
+     * Throws only on caller misuse (empty name).
+     */
+    async findPathForWikiLink(wikiLinkName) {
+        if (!wikiLinkName.trim()) {
+            throw new Error('Empty wiki link — provide a document name inside [[ ]].');
+        }
+        const normalizedName = `${wikiLinkName}.md`;
+        const isPathQualified = wikiLinkName.includes('/');
+        const matches = [];
+        const scan = async (dirPath, relativePath = '') => {
+            const entries = await readdir(dirPath, { withFileTypes: true });
+            for (const entry of entries) {
+                const entryRelativePath = relativePath
+                    ? `${relativePath}/${entry.name}`
+                    : entry.name;
+                if (!this.pathFilter.isAllowed(entryRelativePath)) {
+                    continue;
+                }
+                if (entry.isDirectory()) {
+                    if (!this.pathFilter.isAllowed(`${entryRelativePath}/test.md`)) {
+                        continue;
+                    }
+                    await scan(join(dirPath, entry.name), entryRelativePath);
+                }
+                else if (entry.isFile() &&
+                    (isPathQualified
+                        ? entryRelativePath === normalizedName
+                        : entry.name === normalizedName)) {
+                    matches.push(entryRelativePath);
+                }
+            }
+        };
+        await scan(this.vaultPath);
+        // Depth-ascending (root-first), alphabetical tiebreak at equal depth.
+        // No current-folder context exists for a standalone MCP tool.
+        matches.sort((a, b) => {
+            const da = a.split('/').length;
+            const db = b.split('/').length;
+            return da !== db ? da - db : a.localeCompare(b);
+        });
+        return matches;
+    }
     async getVaultStats(recentCount = 5) {
         let totalNotes = 0;
         let totalFolders = 0;

package/dist/src/pathfilter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pathfilter.d.ts","sourceRoot":"","sources":["../../src/pathfilter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAEnD,qBAAa,UAAU;IAOrB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,mBAAmB,CAMxC;IAEH,OAAO,CAAC,eAAe,CAAW;IAClC,OAAO,CAAC,iBAAiB,CAAW;gBAExB,MAAM,CAAC,EAAE,OAAO,CAAC,gBAAgB,CAAC;IAuB9C,OAAO,CAAC,eAAe;IAoBvB;;;;;;OAMG;IACH,OAAO,CAAC,oBAAoB;IAQ5B,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAyBhC,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAY1C,OAAO,CAAC,aAAa;IA2BrB,OAAO,CAAC,MAAM;IA0Bd,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE;CAGvC"}
+{"version":3,"file":"pathfilter.d.ts","sourceRoot":"","sources":["../../src/pathfilter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAEnD,qBAAa,UAAU;IAOrB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,mBAAmB,CAMxC;IAEH,OAAO,CAAC,eAAe,CAAW;IAClC,OAAO,CAAC,iBAAiB,CAAW;gBAExB,MAAM,CAAC,EAAE,OAAO,CAAC,gBAAgB,CAAC;IAyB9C,OAAO,CAAC,eAAe;IAoBvB;;;;;;OAMG;IACH,OAAO,CAAC,oBAAoB;IAQ5B,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAyBhC,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAY1C,OAAO,CAAC,aAAa;IA2BrB,OAAO,CAAC,MAAM;IA0Bd,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE;CAGvC"}

package/dist/src/pathfilter.js

@@ -20,6 +20,8 @@ export class PathFilter {
             '.obsidian/**',
             '.git',
             '.git/**',
+            '.trash',
+            '.trash/**',
             'node_modules',
             'node_modules/**',
             '.DS_Store',

package/dist/src/wikilink/index.d.ts

@@ -0,0 +1,5 @@
+export { parseWikiLink } from './resolveWikiLink.js';
+export { handleWikiLinkTool } from './wikiLinkTool.js';
+export type { ParsedWikiLink } from './resolveWikiLink.js';
+export type { WikiLinkToolArgs } from './wikiLinkTool.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/src/wikilink/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/wikilink/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAEvD,YAAY,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAE3D,YAAY,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/src/wikilink/index.js

@@ -0,0 +1,2 @@
+export { parseWikiLink } from './resolveWikiLink.js';
+export { handleWikiLinkTool } from './wikiLinkTool.js';

package/dist/src/wikilink/resolveWikiLink.d.ts

@@ -0,0 +1,39 @@
+/**
+ * The parsed components of an Obsidian wiki link.
+ *
+ * @example
+ * parseWikiLink('[[Doc Name#Heading|Display]]')
+ * // { document: 'Doc Name' }
+ */
+export interface ParsedWikiLink {
+    /**
+     * The document name as it appears inside [[ ]] — without brackets,
+     * without display text, without any `#fragment` suffix.
+     * Append `.md` to get the filesystem filename.
+     */
+    document: string;
+}
+/**
+ * Parse an Obsidian wiki link string into its components.
+ *
+ * Handles all wiki link forms:
+ * - `[[Document Name]]`
+ * - `[[Document Name|Display Text]]`
+ * - `[[Document Name\|Display]]` — table-authored escape; `\|` unescapes to `|`
+ * - Bare names without brackets (backslashes preserved as-is)
+ *
+ * A `#Heading` or `#^block-id` suffix is accepted but ignored: the fragment
+ * is stripped and only the document name is returned.
+ *
+ * Throws on malformed input: if the parsed `document` still contains a
+ * literal `\` after processing, the input is rejected rather than
+ * heuristically interpreted.
+ *
+ * @param wikiLinkText - The raw wiki link string, with or without brackets
+ * @returns The parsed basename
+ * @throws Error when parsed components contain an unexpected backslash
+ *
+ * @see {@link ParsedWikiLink}
+ */
+export declare const parseWikiLink: (wikiLinkText: string) => ParsedWikiLink;
+//# sourceMappingURL=resolveWikiLink.d.ts.map

package/dist/src/wikilink/resolveWikiLink.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolveWikiLink.d.ts","sourceRoot":"","sources":["../../../src/wikilink/resolveWikiLink.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,MAAM,WAAW,cAAc;IAC7B;;;;OAIG;IACH,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,eAAO,MAAM,aAAa,GACxB,cAAc,MAAM,KACnB,cAmCF,CAAC"}

package/dist/src/wikilink/resolveWikiLink.js

@@ -0,0 +1,50 @@
+/**
+ * Parse an Obsidian wiki link string into its components.
+ *
+ * Handles all wiki link forms:
+ * - `[[Document Name]]`
+ * - `[[Document Name|Display Text]]`
+ * - `[[Document Name\|Display]]` — table-authored escape; `\|` unescapes to `|`
+ * - Bare names without brackets (backslashes preserved as-is)
+ *
+ * A `#Heading` or `#^block-id` suffix is accepted but ignored: the fragment
+ * is stripped and only the document name is returned.
+ *
+ * Throws on malformed input: if the parsed `document` still contains a
+ * literal `\` after processing, the input is rejected rather than
+ * heuristically interpreted.
+ *
+ * @param wikiLinkText - The raw wiki link string, with or without brackets
+ * @returns The parsed basename
+ * @throws Error when parsed components contain an unexpected backslash
+ *
+ * @see {@link ParsedWikiLink}
+ */
+export const parseWikiLink = (wikiLinkText) => {
+    let text = wikiLinkText.trim();
+    const wasBracketed = text.startsWith('[[');
+    if (wasBracketed) {
+        text = text.slice(2);
+    }
+    if (text.endsWith(']]')) {
+        text = text.slice(0, -2);
+    }
+    // Inside [[ ]] only: unescape Obsidian's table-authoring artifact `\|` → `|`.
+    // Pipe is a reserved grammar character, so `\|` is unambiguous there.
+    if (wasBracketed) {
+        text = text.replace(/\\\|/g, '|');
+    }
+    // Strip |display text if present
+    const pipeIndex = text.indexOf('|');
+    if (pipeIndex !== -1) {
+        text = text.slice(0, pipeIndex);
+    }
+    // Strip and ignore any #fragment suffix
+    const hashIndex = text.indexOf('#');
+    const rest = hashIndex !== -1 ? text.slice(hashIndex + 1) : '';
+    const document = (hashIndex !== -1 ? text.slice(0, hashIndex) : text).trim();
+    if (document.includes('\\') || rest.includes('\\')) {
+        throw new Error(`Invalid wiki-link syntax: unexpected backslash in [[${wikiLinkText}]]. Only \\| inside [[ ]] is a recognized escape.`);
+    }
+    return { document };
+};

package/dist/src/wikilink/wikiLinkTool.d.ts

@@ -0,0 +1,21 @@
+import type { CallToolResult } from '@modelcontextprotocol/sdk/types.js';
+import type { FileSystemService } from '../filesystem.js';
+export interface WikiLinkToolArgs {
+    document: string;
+    prettyPrint?: boolean;
+}
+/**
+ * Handle the `wiki_link` MCP tool call.
+ *
+ * Resolves an Obsidian wiki-link reference against the vault and returns the
+ * matching note. Designed to keep the MCP server request handler slim — all
+ * wiki-link specific concerns live here.
+ *
+ * Response channels per MCP spec 2025-11-25:
+ * - Invalid syntax or no match → `isError: true` with an actionable message.
+ * - One or more matches → success; `structuredContent` carries `document`,
+ *   `path` (the resolved pick), and `alternatives` (the other matched paths,
+ *   present only when more than one file shares the basename).
+ */
+export declare function handleWikiLinkTool(fileSystem: FileSystemService, args: WikiLinkToolArgs): Promise<CallToolResult>;
+//# sourceMappingURL=wikiLinkTool.d.ts.map

package/dist/src/wikilink/wikiLinkTool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wikiLinkTool.d.ts","sourceRoot":"","sources":["../../../src/wikilink/wikiLinkTool.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AACzE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAG1D,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED;;;;;;;;;;;;GAYG;AACH,wBAAsB,kBAAkB,CACtC,UAAU,EAAE,iBAAiB,EAC7B,IAAI,EAAE,gBAAgB,GACrB,OAAO,CAAC,cAAc,CAAC,CAiDzB"}

package/dist/src/wikilink/wikiLinkTool.js

@@ -0,0 +1,60 @@
+import { parseWikiLink } from './resolveWikiLink.js';
+/**
+ * Handle the `wiki_link` MCP tool call.
+ *
+ * Resolves an Obsidian wiki-link reference against the vault and returns the
+ * matching note. Designed to keep the MCP server request handler slim — all
+ * wiki-link specific concerns live here.
+ *
+ * Response channels per MCP spec 2025-11-25:
+ * - Invalid syntax or no match → `isError: true` with an actionable message.
+ * - One or more matches → success; `structuredContent` carries `document`,
+ *   `path` (the resolved pick), and `alternatives` (the other matched paths,
+ *   present only when more than one file shares the basename).
+ */
+export async function handleWikiLinkTool(fileSystem, args) {
+    const indent = args.prettyPrint ? 2 : undefined;
+    let parsed;
+    try {
+        parsed = parseWikiLink(args.document);
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : 'Invalid wiki-link syntax';
+        return {
+            content: [{ type: 'text', text: message }],
+            structuredContent: { rawInput: args.document },
+            isError: true,
+        };
+    }
+    const paths = await fileSystem.findPathForWikiLink(parsed.document);
+    if (paths.length === 0) {
+        return {
+            content: [{
+                    type: 'text',
+                    text: `No file found for [[${parsed.document}]]. Use search_notes or list_directory to find the correct name.`,
+                }],
+            structuredContent: {
+                document: parsed.document,
+            },
+            isError: true,
+        };
+    }
+    const resolvedPath = paths[0];
+    const alternatives = paths.slice(1);
+    const note = await fileSystem.readNote(resolvedPath);
+    return {
+        content: [{
+                type: 'text',
+                text: JSON.stringify({
+                    path: resolvedPath,
+                    fm: note.frontmatter,
+                    content: note.content,
+                }, null, indent),
+            }],
+        structuredContent: {
+            document: parsed.document,
+            path: resolvedPath,
+            ...(alternatives.length > 0 && { alternatives }),
+        },
+    };
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bitbonsai/mcpvault",
-  "version": "0.12.1",
+  "version": "0.12.4",
   "description": "Universal AI bridge for Obsidian vaults - connect any MCP-compatible assistant",
   "homepage": "https://mcpvault.org",
   "author": "bitbonsai",