@bitbonsai/mcpvault 0.10.0 → 0.11.3

package/README.md

@@ -122,7 +122,7 @@ MCP is an open protocol. You're not tied to any specific vendor or platform. You
 
 ## Features
 
-- ✅ Safe frontmatter parsing and validation using gray-matter
+- ✅ Safe frontmatter parsing and validation using gray-matter with AST-aware updates that preserve raw formatting for unmodified fields
 - ✅ Path filtering to exclude `.obsidian` directory and other system files
 - ✅ **Complete MCP toolkit**: 14 methods covering all vault operations
   - File operations: `read_note`, `write_note`, `patch_note`, `delete_note`, `move_note`, `move_file`
@@ -595,7 +595,8 @@ Delete a note from the vault (requires confirmation for safety).
   "name": "delete_note",
   "arguments": {
     "path": "old-draft.md",
-    "confirmPath": "old-draft.md"
+    "confirmPath": "old-draft.md",
+    "trashMode": "local"
   }
 }
 ```
@@ -606,10 +607,15 @@ Delete a note from the vault (requires confirmation for safety).
 {
   "success": true,
   "path": "old-draft.md",
-  "message": "Successfully deleted note: old-draft.md. This action cannot be undone."
+  "message": "Successfully moved note to vault trash: old-draft.md"
 }
 ```
 
+**Trash modes:**
+- `none` (default): permanent delete
+- `local`: move to `.trash` inside the vault, preserving folder structure
+- `system`: move to the OS trash/recycle bin
+
 **Response (Confirmation Failed):**
 
 ```json

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,CA4XzF"}
+{"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,CAgZzF"}

package/dist/src/createServer.js

@@ -69,12 +69,13 @@ export function createServer(vaultPath, options = {}) {
                 },
                 {
                     name: "delete_note",
-                    description: "Delete a note from the Obsidian vault (requires confirmation)",
+                    description: "Delete a note from the Obsidian vault (requires confirmation). Supports permanent delete, vault trash, or system trash.",
                     inputSchema: {
                         type: "object",
                         properties: {
                             path: { type: "string", description: "Path to the note relative to vault root" },
-                            confirmPath: { type: "string", description: "Confirmation: must exactly match the path parameter to proceed with deletion" }
+                            confirmPath: { type: "string", description: "Confirmation: must exactly match the path parameter to proceed with deletion" },
+                            trashMode: { type: "string", enum: ["none", "local", "system"], description: "Deletion mode: 'none' = permanent delete (default), 'local' = move to .trash inside vault, 'system' = move to OS trash", default: "none" }
                         },
                         required: ["path", "confirmPath"]
                     }
@@ -197,6 +198,16 @@ export function createServer(vaultPath, options = {}) {
                             prettyPrint: { type: "boolean", description: "Format JSON response with indentation (default: false)", default: false }
                         }
                     }
+                },
+                {
+                    name: "list_all_tags",
+                    description: "List all tags across the vault with occurrence counts. Returns both frontmatter tags and inline #hashtags, deduplicated and sorted by frequency. Useful for discovering existing tags before creating or organizing notes.",
+                    inputSchema: {
+                        type: "object",
+                        properties: {
+                            prettyPrint: { type: "boolean", description: "Format JSON response with indentation (default: false)", default: false }
+                        }
+                    }
                 }
             ]
         };
@@ -247,7 +258,8 @@ export function createServer(vaultPath, options = {}) {
                 case "delete_note": {
                     const result = await fileSystem.deleteNote({
                         path: trimmedArgs.path,
-                        confirmPath: trimmedArgs.confirmPath
+                        confirmPath: trimmedArgs.confirmPath,
+                        trashMode: trimmedArgs.trashMode
                     });
                     return {
                         content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
@@ -349,6 +361,13 @@ export function createServer(vaultPath, options = {}) {
                         content: [{ type: "text", text: JSON.stringify({ notes: stats.totalNotes, folders: stats.totalFolders, size: stats.totalSize, recent: stats.recentlyModified }, null, indent) }]
                     };
                 }
+                case "list_all_tags": {
+                    const tags = await fileSystem.listAllTags();
+                    const indent = trimmedArgs.prettyPrint ? 2 : undefined;
+                    return {
+                        content: [{ type: "text", text: JSON.stringify(tags, null, indent) }]
+                    };
+                }
                 default:
                     throw new Error(`Unknown tool: ${toolName}`);
             }

package/dist/src/filesystem.d.ts

@@ -22,5 +22,9 @@ export declare class FileSystemService {
     manageTags(params: TagManagementParams): Promise<TagManagementResult>;
     getVaultPath(): string;
     getVaultStats(recentCount?: number): Promise<VaultStats>;
+    listAllTags(): Promise<Array<{
+        tag: string;
+        count: number;
+    }>>;
 }
 //# sourceMappingURL=filesystem.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"filesystem.d.ts","sourceRoot":"","sources":["../../src/filesystem.ts"],"names":[],"mappings":"AAGA,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,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;IA6EjD,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;IAmE3D,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;IA6BjE,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC;IA2ClD,UAAU,CAAC,MAAM,EAAE,mBAAmB,GAAG,OAAO,CAAC,mBAAmB,CAAC;IA0F3E,YAAY,IAAI,MAAM;IAIhB,aAAa,CAAC,WAAW,GAAE,MAAU,GAAG,OAAO,CAAC,UAAU,CAAC;CAwDlE"}
+{"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,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;IAmFjD,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"}

package/dist/src/filesystem.js

@@ -1,6 +1,7 @@
 import { join, resolve, relative, dirname } from 'path';
 import { readdir, stat, readFile, writeFile, unlink, mkdir, access, rename, copyFile } from 'node:fs/promises';
 import { constants, realpathSync } from 'node:fs';
+import trash from 'trash';
 import { FrontmatterHandler } from './frontmatter.js';
 import { PathFilter } from './pathfilter.js';
 import { generateObsidianUri } from './uri.js';
@@ -152,11 +153,15 @@ export class FileSystemService {
                     const mergedFrontmatter = frontmatter
                         ? { ...existingNote.frontmatter, ...frontmatter }
                         : existingNote.frontmatter;
-                    if (mode === 'append') {
-                        finalContent = this.frontmatterHandler.stringify(mergedFrontmatter, existingNote.content + content);
+                    const mergedContent = mode === 'append'
+                        ? existingNote.content + content
+                        : content + existingNote.content;
+                    if (existingNote.matter && existingNote.matter.trim() !== '') {
+                        // Preserve raw formatting for unmodified fields by only applying explicit updates
+                        finalContent = this.frontmatterHandler.preserveStringify(existingNote.matter, frontmatter || {}, mergedContent);
                     }
-                    else if (mode === 'prepend') {
-                        finalContent = this.frontmatterHandler.stringify(mergedFrontmatter, content + existingNote.content);
+                    else {
+                        finalContent = this.frontmatterHandler.stringify(mergedFrontmatter, mergedContent);
                     }
                 }
             }
@@ -193,11 +198,11 @@ export class FileSystemService {
                 message: 'oldString cannot be empty'
             };
         }
-        if (!newString) {
+        if (newString === undefined || newString === null) {
             return {
                 success: false,
                 path,
-                message: 'newString cannot be empty'
+                message: 'newString is required'
             };
         }
         // Validate that oldString and newString are different
@@ -342,7 +347,7 @@ export class FileSystemService {
         }
     }
     async deleteNote(params) {
-        const { path, confirmPath } = params;
+        const { path, confirmPath, trashMode = 'none' } = params;
         // Confirmation check - paths must match exactly
         if (path !== confirmPath) {
             return {
@@ -369,6 +374,39 @@ export class FileSystemService {
                     message: `Cannot delete: ${path} is not a file`
                 };
             }
+            if (trashMode === 'local') {
+                const trashDir = join(this.vaultPath, '.trash');
+                const trashPath = join(trashDir, path);
+                // Ensure trash directory exists
+                await mkdir(dirname(trashPath), { recursive: true });
+                // Handle collisions by appending a timestamp
+                let finalTrashPath = trashPath;
+                try {
+                    await access(finalTrashPath, constants.F_OK);
+                    const timestamp = new Date().toISOString().replace(/[:.]/g, '-');
+                    const ext = path.endsWith('.md') ? '.md' : '';
+                    const base = ext ? path.slice(0, -ext.length) : path;
+                    const collidedPath = `${base}-${timestamp}${ext}`;
+                    finalTrashPath = join(trashDir, collidedPath);
+                }
+                catch {
+                    // File does not exist in trash, no collision
+                }
+                await rename(fullPath, finalTrashPath);
+                return {
+                    success: true,
+                    path: path,
+                    message: `Successfully moved note to vault trash: ${path}`
+                };
+            }
+            if (trashMode === 'system') {
+                await trash(fullPath);
+                return {
+                    success: true,
+                    path: path,
+                    message: `Successfully moved note to system trash: ${path}`
+                };
+            }
             // Perform the deletion using Node.js native API
             await unlink(fullPath);
             return {
@@ -652,12 +690,20 @@ export class FileSystemService {
         if (!validation.isValid) {
             throw new Error(`Invalid frontmatter: ${validation.errors.join(', ')}`);
         }
-        // Update the note with new frontmatter, preserving content
-        await this.writeNote({
-            path,
-            content: note.content,
-            frontmatter: newFrontmatter
-        });
+        const fullPath = this.resolvePath(path);
+        if (merge && note.matter && note.matter.trim() !== '') {
+            // Preserve raw formatting for unmodified fields
+            const updatedContent = this.frontmatterHandler.preserveStringify(note.matter, frontmatter, note.content);
+            await writeFile(fullPath, updatedContent, 'utf-8');
+        }
+        else {
+            // Replace frontmatter entirely (or no existing matter to preserve)
+            await this.writeNote({
+                path,
+                content: note.content,
+                frontmatter: newFrontmatter
+            });
+        }
     }
     async getNotesInfo(paths) {
         const results = await Promise.allSettled(paths.map(async (path) => {
@@ -740,23 +786,31 @@ export class FileSystemService {
             else if (operation === 'remove') {
                 newTags = newTags.filter(tag => !tags.includes(tag));
             }
-            // Update frontmatter with new tags
-            const updatedFrontmatter = {
-                ...note.frontmatter
-            };
+            // Build tag updates for preserveStringify
+            const tagUpdates = {};
             if (newTags.length > 0) {
-                updatedFrontmatter.tags = newTags;
+                tagUpdates.tags = newTags;
             }
-            else if ('tags' in updatedFrontmatter) {
-                delete updatedFrontmatter.tags;
+            else {
+                tagUpdates.tags = undefined;
             }
-            // Write back the note with updated frontmatter
-            await this.writeNote({
-                path,
-                content: note.content,
-                frontmatter: updatedFrontmatter,
-                mode: 'overwrite'
-            });
+            // Write back the note with updated frontmatter, preserving raw formatting for unmodified fields
+            let updatedContent;
+            if (note.matter && note.matter.trim() !== '') {
+                updatedContent = this.frontmatterHandler.preserveStringify(note.matter, tagUpdates, note.content);
+            }
+            else {
+                const updatedFrontmatter = { ...note.frontmatter };
+                if (newTags.length > 0) {
+                    updatedFrontmatter.tags = newTags;
+                }
+                else {
+                    delete updatedFrontmatter.tags;
+                }
+                updatedContent = this.frontmatterHandler.stringify(updatedFrontmatter, note.content);
+            }
+            const fullPath = this.resolvePath(path);
+            await writeFile(fullPath, updatedContent, 'utf-8');
             return {
                 path,
                 operation,
@@ -828,4 +882,49 @@ export class FileSystemService {
             recentlyModified: recentFiles
         };
     }
+    async listAllTags() {
+        const tagCounts = new Map();
+        const inlineTagRegex = /(?:^|\s)#([a-zA-Z][a-zA-Z0-9_/\-]*)/g;
+        const scanDirectory = async (dirPath, relativePath = '') => {
+            const entries = await readdir(dirPath, { withFileTypes: true });
+            for (const entry of entries) {
+                const entryRelativePath = relativePath ? `${relativePath}/${entry.name}` : entry.name;
+                const fullEntryPath = join(dirPath, entry.name);
+                if (entry.isDirectory()) {
+                    if (!this.pathFilter.isAllowedForListing(entryRelativePath))
+                        continue;
+                    await scanDirectory(fullEntryPath, entryRelativePath);
+                }
+                else if (entry.isFile() && this.pathFilter.isAllowed(entryRelativePath)) {
+                    try {
+                        const content = await readFile(fullEntryPath, 'utf-8');
+                        const parsed = this.frontmatterHandler.parse(content);
+                        // Frontmatter tags
+                        const fmTags = parsed.frontmatter?.tags;
+                        if (Array.isArray(fmTags)) {
+                            for (const tag of fmTags) {
+                                if (typeof tag === 'string' && tag.trim()) {
+                                    const normalized = tag.trim().toLowerCase();
+                                    tagCounts.set(normalized, (tagCounts.get(normalized) || 0) + 1);
+                                }
+                            }
+                        }
+                        // Inline #tags from body content
+                        let match;
+                        while ((match = inlineTagRegex.exec(parsed.content)) !== null) {
+                            const normalized = match[1].toLowerCase();
+                            tagCounts.set(normalized, (tagCounts.get(normalized) || 0) + 1);
+                        }
+                    }
+                    catch {
+                        // Skip files that can't be read
+                    }
+                }
+            }
+        };
+        await scanDirectory(this.vaultPath);
+        return Array.from(tagCounts.entries())
+            .map(([tag, count]) => ({ tag, count }))
+            .sort((a, b) => b.count - a.count || a.tag.localeCompare(b.tag));
+    }
 }

package/dist/src/frontmatter.d.ts

@@ -10,6 +10,7 @@ export declare class FrontmatterHandler {
     stringify(frontmatterData: Record<string, any>, content: string): string;
     validate(frontmatterData: Record<string, any>): FrontmatterValidationResult;
     private checkForProblematicValues;
+    preserveStringify(rawMatter: string, updates: Record<string, any>, content: string): string;
     extractFrontmatter(content: string): Record<string, any>;
     updateFrontmatter(content: string, updates: Record<string, any>): string;
 }

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

@@ -1 +1 @@
-{"version":3,"file":"frontmatter.d.ts","sourceRoot":"","sources":["../../src/frontmatter.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,2BAA2B,EAAE,MAAM,YAAY,CAAC;AAE1E;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,GAAG,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,SAAS,CAmB5E;AAED,qBAAa,kBAAkB;IAC7B,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,UAAU;IAkBlC,SAAS,CAAC,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM;IAaxE,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,2BAA2B;IAqB3E,OAAO,CAAC,yBAAyB;IAmDjC,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;IAKxD,iBAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,MAAM;CAWzE"}
+{"version":3,"file":"frontmatter.d.ts","sourceRoot":"","sources":["../../src/frontmatter.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,2BAA2B,EAAE,MAAM,YAAY,CAAC;AAE1E;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,GAAG,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,SAAS,CAmB5E;AAED,qBAAa,kBAAkB;IAC7B,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,UAAU;IAoBlC,SAAS,CAAC,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM;IAaxE,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,2BAA2B;IAqB3E,OAAO,CAAC,yBAAyB;IAmDjC,iBAAiB,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM;IAyB3F,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;IAKxD,iBAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,MAAM;CAWzE"}

package/dist/src/frontmatter.js

@@ -1,4 +1,5 @@
 import matter from 'gray-matter';
+import { parseDocument } from 'yaml';
 /**
  * Parse a frontmatter value that may be a JSON string (LLM clients sometimes
  * pass frontmatter as a serialized JSON string instead of an object).
@@ -32,7 +33,8 @@ export class FrontmatterHandler {
             return {
                 frontmatter: parsed.data,
                 content: parsed.content,
-                originalContent: content
+                originalContent: content,
+                matter: parsed.matter
             };
         }
         catch (error) {
@@ -40,7 +42,8 @@ export class FrontmatterHandler {
             return {
                 frontmatter: {},
                 content: content,
-                originalContent: content
+                originalContent: content,
+                matter: ''
             };
         }
     }
@@ -113,6 +116,31 @@ export class FrontmatterHandler {
             }
         }
     }
+    preserveStringify(rawMatter, updates, content) {
+        try {
+            if (!rawMatter || rawMatter.trim() === '') {
+                // No existing frontmatter to preserve - fall back to regular stringify
+                if (!updates || Object.keys(updates).length === 0) {
+                    return content;
+                }
+                return matter.stringify(content, updates);
+            }
+            const doc = parseDocument(rawMatter.trimStart());
+            for (const [key, value] of Object.entries(updates)) {
+                if (value === undefined) {
+                    doc.delete(key);
+                }
+                else {
+                    doc.set(key, value);
+                }
+            }
+            const yamlContent = doc.toString();
+            return `---\n${yamlContent}---\n${content}`;
+        }
+        catch (error) {
+            throw new Error(`Failed to stringify frontmatter: ${error instanceof Error ? error.message : 'Unknown error'}`);
+        }
+    }
     extractFrontmatter(content) {
         const parsed = this.parse(content);
         return parsed.frontmatter;
@@ -124,6 +152,6 @@ export class FrontmatterHandler {
         if (!validation.isValid) {
             throw new Error(`Invalid frontmatter: ${validation.errors.join(', ')}`);
         }
-        return this.stringify(updatedFrontmatter, parsed.content);
+        return this.preserveStringify(parsed.matter || '', updates, parsed.content);
     }
 }

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;IACrB,OAAO,CAAC,eAAe,CAAW;IAClC,OAAO,CAAC,iBAAiB,CAAW;gBAExB,MAAM,CAAC,EAAE,OAAO,CAAC,gBAAgB,CAAC;IAuB9C,OAAO,CAAC,eAAe;IAkBvB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAqBhC,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAQ1C,OAAO,CAAC,aAAa;IAYrB,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;IACrB,OAAO,CAAC,eAAe,CAAW;IAClC,OAAO,CAAC,iBAAiB,CAAW;gBAExB,MAAM,CAAC,EAAE,OAAO,CAAC,gBAAgB,CAAC;IAuB9C,OAAO,CAAC,eAAe;IAkBvB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAyBhC,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAY1C,OAAO,CAAC,aAAa;IAYrB,OAAO,CAAC,MAAM;IA0Bd,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE;CAGvC"}

package/dist/src/pathfilter.js

@@ -37,6 +37,9 @@ export class PathFilter {
         return regex.test(path);
     }
     isAllowed(path) {
+        if (typeof path !== "string") {
+            throw new Error("path is required and must be a string");
+        }
         // Normalize path separators
         const normalizedPath = path.replace(/\\/g, '/');
         if (this.isIgnoredPath(normalizedPath)) {
@@ -52,6 +55,9 @@ export class PathFilter {
         return true;
     }
     isAllowedForListing(path) {
+        if (typeof path !== "string") {
+            throw new Error("path is required and must be a string");
+        }
         // Normalize path separators
         const normalizedPath = path.replace(/\\/g, '/');
         // Listing includes non-note files, but still blocks restricted system paths

package/dist/src/types.d.ts

@@ -2,6 +2,7 @@ export interface ParsedNote {
     frontmatter: Record<string, any>;
     content: string;
     originalContent: string;
+    matter?: string;
 }
 export interface NoteWriteParams {
     path: string;
@@ -24,6 +25,7 @@ export interface PatchNoteResult {
 export interface DeleteNoteParams {
     path: string;
     confirmPath: string;
+    trashMode?: 'none' | 'local' | 'system';
 }
 export interface DeleteResult {
     success: boolean;

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

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bitbonsai/mcpvault",
-  "version": "0.10.0",
+  "version": "0.11.3",
   "description": "Universal AI bridge for Obsidian vaults - connect any MCP-compatible assistant",
   "homepage": "https://mcpvault.org",
   "author": "bitbonsai",
@@ -37,12 +37,14 @@
   },
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.20.0",
-    "gray-matter": "^4.0.3"
+    "gray-matter": "^4.0.3",
+    "trash": "^10.1.1",
+    "yaml": "^2.8.3"
   },
   "devDependencies": {
     "@types/node": "^25.3.3",
     "tsx": "^4.20.6",
-    "typescript": "^5.9.3",
+    "typescript": "^6.0.2",
     "vitest": "^4.0.15"
   },
   "engines": {