@blacksmithers/vaultforge 1.0.0

package/dist/tools/links/update-links.d.ts

@@ -0,0 +1,16 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { VaultIndex } from "../../vault-index.js";
+/**
+ * Core link-update logic, exported so batch_rename can call it directly.
+ */
+export declare function updateWikilinks(vaultPath: string, vault: VaultIndex, oldPath: string, newPath: string, dryRun: boolean): Promise<{
+    filesScanned: number;
+    filesUpdated: number;
+    totalLinks: number;
+    results: Array<{
+        path: string;
+        links_updated: number;
+    }>;
+}>;
+export declare function registerUpdateLinks(server: McpServer, vaultPath: string, vault: VaultIndex): void;
+//# sourceMappingURL=update-links.d.ts.map

package/dist/tools/links/update-links.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"update-links.d.ts","sourceRoot":"","sources":["../../../src/tools/links/update-links.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAIpE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAGvD;;GAEG;AACH,wBAAsB,eAAe,CACnC,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,UAAU,EACjB,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,OAAO,GACd,OAAO,CAAC;IAAE,YAAY,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,aAAa,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAAE,CAAC,CA6DtI;AAED,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,SAAS,EACjB,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,UAAU,GAChB,IAAI,CAoCN"}

package/dist/tools/links/update-links.js

@@ -0,0 +1,88 @@
+import { z } from "zod";
+import { readFile, writeFile } from "node:fs/promises";
+import path from "node:path";
+import { escapeRegex, extractStem, getAllMdFiles } from "./link-utils.js";
+/**
+ * Core link-update logic, exported so batch_rename can call it directly.
+ */
+export async function updateWikilinks(vaultPath, vault, oldPath, newPath, dryRun) {
+    const oldRef = oldPath.replace(/\.md$/, "");
+    const newRef = newPath.replace(/\.md$/, "");
+    const oldStem = extractStem(oldPath);
+    const newStem = extractStem(newPath);
+    const escapedRef = escapeRegex(oldRef);
+    const escapedStem = escapeRegex(oldStem);
+    // Build replacement patterns (full path first, then stem)
+    const patterns = [
+        {
+            regex: new RegExp(`(!?\\[\\[)${escapedRef}(#[^\\]|]*)?(?:\\|([^\\]]*))?\\]\\]`, "g"),
+            newBase: newRef,
+        },
+    ];
+    if (oldStem !== newStem) {
+        patterns.push({
+            regex: new RegExp(`(!?\\[\\[)${escapedStem}(#[^\\]|]*)?(?:\\|([^\\]]*))?\\]\\]`, "g"),
+            newBase: newStem,
+        });
+    }
+    const allFiles = getAllMdFiles(vault);
+    const results = [];
+    let totalLinks = 0;
+    for (const filePath of allFiles) {
+        if (filePath === newPath)
+            continue;
+        const fullPath = path.join(vaultPath, filePath);
+        let content;
+        try {
+            content = await readFile(fullPath, "utf-8");
+        }
+        catch {
+            continue;
+        }
+        let newContent = content;
+        let matchCount = 0;
+        for (const { regex, newBase } of patterns) {
+            newContent = newContent.replace(regex, (_match, prefix, heading, alias) => {
+                matchCount++;
+                const h = heading || "";
+                const a = alias !== undefined ? `|${alias}` : "";
+                return `${prefix}${newBase}${h}${a}]]`;
+            });
+        }
+        if (matchCount > 0) {
+            totalLinks += matchCount;
+            results.push({ path: filePath, links_updated: matchCount });
+            if (!dryRun) {
+                await writeFile(fullPath, newContent, "utf-8");
+            }
+        }
+    }
+    return { filesScanned: allFiles.length, filesUpdated: results.length, totalLinks, results };
+}
+export function registerUpdateLinks(server, vaultPath, vault) {
+    server.tool("update_links", "Update all wikilinks across vault after moving/renaming a file. Handles all link forms: stem, path, alias, heading, embed. Dry run by default.", {
+        old_path: z.string().describe("File path before the move/rename"),
+        new_path: z.string().describe("File path after the move/rename"),
+        dry_run: z.boolean().default(true).describe("Preview changes without writing (default: true)"),
+    }, async ({ old_path, new_path, dry_run }) => {
+        await vault.waitReady();
+        const result = await updateWikilinks(vaultPath, vault, old_path, new_path, dry_run);
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: JSON.stringify({
+                        old_path,
+                        new_path,
+                        files_scanned: result.filesScanned,
+                        files_updated: result.filesUpdated,
+                        total_links_updated: result.totalLinks,
+                        dry_run,
+                        results: result.results,
+                    }, null, 2),
+                },
+            ],
+        };
+    });
+}
+//# sourceMappingURL=update-links.js.map

package/dist/tools/links/update-links.js.map

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

package/dist/tools/metadata/frontmatter.d.ts

@@ -0,0 +1,12 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { VaultIndex } from "../../vault-index.js";
+interface ParsedFrontmatter {
+    frontmatter: Record<string, any>;
+    body: string;
+    hasFrontmatter: boolean;
+}
+export declare function parseFrontmatter(content: string): ParsedFrontmatter;
+export declare function serializeFrontmatter(fm: Record<string, any>): string;
+export declare function registerFrontmatter(server: McpServer, vaultPath: string, vault: VaultIndex): void;
+export {};
+//# sourceMappingURL=frontmatter.d.ts.map

package/dist/tools/metadata/frontmatter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"frontmatter.d.ts","sourceRoot":"","sources":["../../../src/tools/metadata/frontmatter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAIpE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAEvD,UAAU,iBAAiB;IACzB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,cAAc,EAAE,OAAO,CAAC;CACzB;AAED,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,iBAAiB,CA6DnE;AAUD,wBAAgB,oBAAoB,CAAC,EAAE,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,MAAM,CAUpE;AAED,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,SAAS,EACjB,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,UAAU,GAChB,IAAI,CA+HN"}

package/dist/tools/metadata/frontmatter.js

@@ -0,0 +1,190 @@
+import { z } from "zod";
+import { readFile, writeFile } from "node:fs/promises";
+import path from "node:path";
+export function parseFrontmatter(content) {
+    // Normalize CRLF → LF for cross-platform compatibility
+    const normalized = content.replace(/\r\n/g, "\n");
+    const match = normalized.match(/^---\n([\s\S]*?)\n---\n?([\s\S]*)$/);
+    if (!match)
+        return { frontmatter: {}, body: content, hasFrontmatter: false };
+    const fm = {};
+    let currentKey = null;
+    let listItems = [];
+    let inList = false;
+    for (const line of match[1].split("\n")) {
+        // YAML list item (- value)
+        if (inList && /^\s+-\s+(.*)$/.test(line)) {
+            const itemMatch = line.match(/^\s+-\s+(.*)$/);
+            if (itemMatch) {
+                listItems.push(parseYamlValue(itemMatch[1].trim()));
+            }
+            continue;
+        }
+        // If we were collecting list items, save them
+        if (inList && currentKey) {
+            fm[currentKey] = listItems;
+            inList = false;
+            listItems = [];
+            currentKey = null;
+        }
+        const kv = line.match(/^([\w][\w-]*):\s*(.*)$/);
+        if (!kv)
+            continue;
+        const key = kv[1];
+        const rawValue = kv[2].trim();
+        // Check if this is the start of a YAML list
+        if (rawValue === "") {
+            currentKey = key;
+            inList = true;
+            listItems = [];
+            continue;
+        }
+        // Inline array: [val1, val2]
+        if (rawValue.startsWith("[") && rawValue.endsWith("]")) {
+            fm[key] = rawValue
+                .slice(1, -1)
+                .split(",")
+                .map((v) => parseYamlValue(v.trim()))
+                .filter((v) => v !== "");
+        }
+        else {
+            fm[key] = parseYamlValue(rawValue);
+        }
+    }
+    // Final list collection
+    if (inList && currentKey) {
+        fm[currentKey] = listItems;
+    }
+    return { frontmatter: fm, body: match[2], hasFrontmatter: true };
+}
+function parseYamlValue(value) {
+    if (/^\d+(\.\d+)?$/.test(value))
+        return Number(value);
+    if (value === "true")
+        return true;
+    if (value === "false")
+        return false;
+    // Strip surrounding quotes
+    return value.replace(/^["']|["']$/g, "");
+}
+export function serializeFrontmatter(fm) {
+    const lines = [];
+    for (const [key, value] of Object.entries(fm)) {
+        if (Array.isArray(value)) {
+            lines.push(`${key}: [${value.join(", ")}]`);
+        }
+        else {
+            lines.push(`${key}: ${value}`);
+        }
+    }
+    return `---\n${lines.join("\n")}\n---`;
+}
+export function registerFrontmatter(server, vaultPath, vault) {
+    server.tool("frontmatter", "Read/write/merge YAML frontmatter as structured data. No string parsing needed. Actions: read, set, merge, delete_keys.", {
+        path: z.string().describe("File path or stem"),
+        action: z.enum(["read", "set", "merge", "delete_keys"]).describe("Operation to perform"),
+        data: z.record(z.string(), z.any()).optional().describe("Data for set/merge actions"),
+        keys: z.array(z.string()).optional().describe("Keys to remove for delete_keys action"),
+    }, async ({ path: filePath, action, data, keys }) => {
+        await vault.waitReady();
+        const resolved = vault.resolve(filePath);
+        const rel = resolved?.rel ?? filePath;
+        const fullPath = path.join(vaultPath, rel);
+        let content;
+        try {
+            content = await readFile(fullPath, "utf-8");
+        }
+        catch {
+            if (action === "read") {
+                return {
+                    content: [{ type: "text", text: `ERROR: File not found: ${rel}` }],
+                    isError: true,
+                };
+            }
+            // For write actions, start with empty content
+            content = "";
+        }
+        const parsed = parseFrontmatter(content);
+        switch (action) {
+            case "read": {
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: JSON.stringify({
+                                path: rel,
+                                frontmatter: parsed.frontmatter,
+                                has_frontmatter: parsed.hasFrontmatter,
+                            }, null, 2),
+                        },
+                    ],
+                };
+            }
+            case "set": {
+                if (!data) {
+                    return {
+                        content: [{ type: "text", text: "ERROR: 'data' is required for 'set' action" }],
+                        isError: true,
+                    };
+                }
+                const before = { ...parsed.frontmatter };
+                const newContent = serializeFrontmatter(data) + "\n" + parsed.body;
+                await writeFile(fullPath, newContent, "utf-8");
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: JSON.stringify({ path: rel, action: "set", before, after: data }, null, 2),
+                        },
+                    ],
+                };
+            }
+            case "merge": {
+                if (!data) {
+                    return {
+                        content: [{ type: "text", text: "ERROR: 'data' is required for 'merge' action" }],
+                        isError: true,
+                    };
+                }
+                const before = { ...parsed.frontmatter };
+                const merged = { ...parsed.frontmatter, ...data };
+                const newContent = serializeFrontmatter(merged) + "\n" + parsed.body;
+                await writeFile(fullPath, newContent, "utf-8");
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: JSON.stringify({ path: rel, action: "merge", before, after: merged }, null, 2),
+                        },
+                    ],
+                };
+            }
+            case "delete_keys": {
+                if (!keys || keys.length === 0) {
+                    return {
+                        content: [{ type: "text", text: "ERROR: 'keys' is required for 'delete_keys' action" }],
+                        isError: true,
+                    };
+                }
+                const before = { ...parsed.frontmatter };
+                const updated = { ...parsed.frontmatter };
+                for (const key of keys) {
+                    delete updated[key];
+                }
+                const newContent = Object.keys(updated).length > 0
+                    ? serializeFrontmatter(updated) + "\n" + parsed.body
+                    : parsed.body;
+                await writeFile(fullPath, newContent, "utf-8");
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: JSON.stringify({ path: rel, action: "delete_keys", keys_deleted: keys, before, after: updated }, null, 2),
+                        },
+                    ],
+                };
+            }
+        }
+    });
+}
+//# sourceMappingURL=frontmatter.js.map

package/dist/tools/metadata/frontmatter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"frontmatter.js","sourceRoot":"","sources":["../../../src/tools/metadata/frontmatter.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,IAAI,MAAM,WAAW,CAAC;AAS7B,MAAM,UAAU,gBAAgB,CAAC,OAAe;IAC9C,uDAAuD;IACvD,MAAM,UAAU,GAAG,OAAO,CAAC,OAAO,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;IAClD,MAAM,KAAK,GAAG,UAAU,CAAC,KAAK,CAAC,oCAAoC,CAAC,CAAC;IACrE,IAAI,CAAC,KAAK;QAAE,OAAO,EAAE,WAAW,EAAE,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,cAAc,EAAE,KAAK,EAAE,CAAC;IAE7E,MAAM,EAAE,GAAwB,EAAE,CAAC;IACnC,IAAI,UAAU,GAAkB,IAAI,CAAC;IACrC,IAAI,SAAS,GAAa,EAAE,CAAC;IAC7B,IAAI,MAAM,GAAG,KAAK,CAAC;IAEnB,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;QACxC,2BAA2B;QAC3B,IAAI,MAAM,IAAI,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YACzC,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC;YAC9C,IAAI,SAAS,EAAE,CAAC;gBACd,SAAS,CAAC,IAAI,CAAC,cAAc,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;YACtD,CAAC;YACD,SAAS;QACX,CAAC;QAED,8CAA8C;QAC9C,IAAI,MAAM,IAAI,UAAU,EAAE,CAAC;YACzB,EAAE,CAAC,UAAU,CAAC,GAAG,SAAS,CAAC;YAC3B,MAAM,GAAG,KAAK,CAAC;YACf,SAAS,GAAG,EAAE,CAAC;YACf,UAAU,GAAG,IAAI,CAAC;QACpB,CAAC;QAED,MAAM,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,wBAAwB,CAAC,CAAC;QAChD,IAAI,CAAC,EAAE;YAAE,SAAS;QAElB,MAAM,GAAG,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC;QAClB,MAAM,QAAQ,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QAE9B,4CAA4C;QAC5C,IAAI,QAAQ,KAAK,EAAE,EAAE,CAAC;YACpB,UAAU,GAAG,GAAG,CAAC;YACjB,MAAM,GAAG,IAAI,CAAC;YACd,SAAS,GAAG,EAAE,CAAC;YACf,SAAS;QACX,CAAC;QAED,6BAA6B;QAC7B,IAAI,QAAQ,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,QAAQ,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;YACvD,EAAE,CAAC,GAAG,CAAC,GAAG,QAAQ;iBACf,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;iBACZ,KAAK,CAAC,GAAG,CAAC;iBACV,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,cAAc,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;iBACpC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC;QAC7B,CAAC;aAAM,CAAC;YACN,EAAE,CAAC,GAAG,CAAC,GAAG,cAAc,CAAC,QAAQ,CAAC,CAAC;QACrC,CAAC;IACH,CAAC;IAED,wBAAwB;IACxB,IAAI,MAAM,IAAI,UAAU,EAAE,CAAC;QACzB,EAAE,CAAC,UAAU,CAAC,GAAG,SAAS,CAAC;IAC7B,CAAC;IAED,OAAO,EAAE,WAAW,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,cAAc,EAAE,IAAI,EAAE,CAAC;AACnE,CAAC;AAED,SAAS,cAAc,CAAC,KAAa;IACnC,IAAI,eAAe,CAAC,IAAI,CAAC,KAAK,CAAC;QAAE,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;IACtD,IAAI,KAAK,KAAK,MAAM;QAAE,OAAO,IAAI,CAAC;IAClC,IAAI,KAAK,KAAK,OAAO;QAAE,OAAO,KAAK,CAAC;IACpC,2BAA2B;IAC3B,OAAO,KAAK,CAAC,OAAO,CAAC,cAAc,EAAE,EAAE,CAAC,CAAC;AAC3C,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,EAAuB;IAC1D,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC,EAAE,CAAC;QAC9C,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YACzB,KAAK,CAAC,IAAI,CAAC,GAAG,GAAG,MAAM,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAC9C,CAAC;aAAM,CAAC;YACN,KAAK,CAAC,IAAI,CAAC,GAAG,GAAG,KAAK,KAAK,EAAE,CAAC,CAAC;QACjC,CAAC;IACH,CAAC;IACD,OAAO,QAAQ,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC;AACzC,CAAC;AAED,MAAM,UAAU,mBAAmB,CACjC,MAAiB,EACjB,SAAiB,EACjB,KAAiB;IAEjB,MAAM,CAAC,IAAI,CACT,aAAa,EACb,yHAAyH,EACzH;QACE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,mBAAmB,CAAC;QAC9C,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,aAAa,CAAC,CAAC,CAAC,QAAQ,CAAC,sBAAsB,CAAC;QACxF,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,4BAA4B,CAAC;QACrF,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,uCAAuC,CAAC;KACvF,EACD,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,EAAE;QAC/C,MAAM,KAAK,CAAC,SAAS,EAAE,CAAC;QAExB,MAAM,QAAQ,GAAG,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;QACzC,MAAM,GAAG,GAAG,QAAQ,EAAE,GAAG,IAAI,QAAQ,CAAC;QACtC,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC;QAE3C,IAAI,OAAe,CAAC;QACpB,IAAI,CAAC;YACH,OAAO,GAAG,MAAM,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QAC9C,CAAC;QAAC,MAAM,CAAC;YACP,IAAI,MAAM,KAAK,MAAM,EAAE,CAAC;gBACtB,OAAO;oBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,0BAA0B,GAAG,EAAE,EAAE,CAAC;oBAClE,OAAO,EAAE,IAAI;iBACd,CAAC;YACJ,CAAC;YACD,8CAA8C;YAC9C,OAAO,GAAG,EAAE,CAAC;QACf,CAAC;QAED,MAAM,MAAM,GAAG,gBAAgB,CAAC,OAAO,CAAC,CAAC;QAEzC,QAAQ,MAAM,EAAE,CAAC;YACf,KAAK,MAAM,CAAC,CAAC,CAAC;gBACZ,OAAO;oBACL,OAAO,EAAE;wBACP;4BACE,IAAI,EAAE,MAAM;4BACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAClB;gCACE,IAAI,EAAE,GAAG;gCACT,WAAW,EAAE,MAAM,CAAC,WAAW;gCAC/B,eAAe,EAAE,MAAM,CAAC,cAAc;6BACvC,EACD,IAAI,EACJ,CAAC,CACF;yBACF;qBACF;iBACF,CAAC;YACJ,CAAC;YAED,KAAK,KAAK,CAAC,CAAC,CAAC;gBACX,IAAI,CAAC,IAAI,EAAE,CAAC;oBACV,OAAO;wBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,4CAA4C,EAAE,CAAC;wBAC/E,OAAO,EAAE,IAAI;qBACd,CAAC;gBACJ,CAAC;gBACD,MAAM,MAAM,GAAG,EAAE,GAAG,MAAM,CAAC,WAAW,EAAE,CAAC;gBACzC,MAAM,UAAU,GAAG,oBAAoB,CAAC,IAAI,CAAC,GAAG,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC;gBACnE,MAAM,SAAS,CAAC,QAAQ,EAAE,UAAU,EAAE,OAAO,CAAC,CAAC;gBAC/C,OAAO;oBACL,OAAO,EAAE;wBACP;4BACE,IAAI,EAAE,MAAM;4BACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;yBACjF;qBACF;iBACF,CAAC;YACJ,CAAC;YAED,KAAK,OAAO,CAAC,CAAC,CAAC;gBACb,IAAI,CAAC,IAAI,EAAE,CAAC;oBACV,OAAO;wBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,8CAA8C,EAAE,CAAC;wBACjF,OAAO,EAAE,IAAI;qBACd,CAAC;gBACJ,CAAC;gBACD,MAAM,MAAM,GAAG,EAAE,GAAG,MAAM,CAAC,WAAW,EAAE,CAAC;gBACzC,MAAM,MAAM,GAAG,EAAE,GAAG,MAAM,CAAC,WAAW,EAAE,GAAG,IAAI,EAAE,CAAC;gBAClD,MAAM,UAAU,GAAG,oBAAoB,CAAC,MAAM,CAAC,GAAG,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC;gBACrE,MAAM,SAAS,CAAC,QAAQ,EAAE,UAAU,EAAE,OAAO,CAAC,CAAC;gBAC/C,OAAO;oBACL,OAAO,EAAE;wBACP;4BACE,IAAI,EAAE,MAAM;4BACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;yBACrF;qBACF;iBACF,CAAC;YACJ,CAAC;YAED,KAAK,aAAa,CAAC,CAAC,CAAC;gBACnB,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;oBAC/B,OAAO;wBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,oDAAoD,EAAE,CAAC;wBACvF,OAAO,EAAE,IAAI;qBACd,CAAC;gBACJ,CAAC;gBACD,MAAM,MAAM,GAAG,EAAE,GAAG,MAAM,CAAC,WAAW,EAAE,CAAC;gBACzC,MAAM,OAAO,GAAG,EAAE,GAAG,MAAM,CAAC,WAAW,EAAE,CAAC;gBAC1C,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;oBACvB,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC;gBACtB,CAAC;gBACD,MAAM,UAAU,GACd,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,MAAM,GAAG,CAAC;oBAC7B,CAAC,CAAC,oBAAoB,CAAC,OAAO,CAAC,GAAG,IAAI,GAAG,MAAM,CAAC,IAAI;oBACpD,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC;gBAClB,MAAM,SAAS,CAAC,QAAQ,EAAE,UAAU,EAAE,OAAO,CAAC,CAAC;gBAC/C,OAAO;oBACL,OAAO,EAAE;wBACP;4BACE,IAAI,EAAE,MAAM;4BACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAClB,EAAE,IAAI,EAAE,GAAG,EAAE,MAAM,EAAE,aAAa,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,EAChF,IAAI,EACJ,CAAC,CACF;yBACF;qBACF;iBACF,CAAC;YACJ,CAAC;QACH,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/notes/edit-regex.d.ts

@@ -0,0 +1,4 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { VaultIndex } from "../../vault-index.js";
+export declare function registerEditRegex(server: McpServer, vaultPath: string, vault: VaultIndex): void;
+//# sourceMappingURL=edit-regex.d.ts.map

package/dist/tools/notes/edit-regex.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"edit-regex.d.ts","sourceRoot":"","sources":["../../../src/tools/notes/edit-regex.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAIpE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAEvD,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,SAAS,EACjB,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,UAAU,GAChB,IAAI,CA+JN"}

package/dist/tools/notes/edit-regex.js

@@ -0,0 +1,142 @@
+import { z } from "zod";
+import { readFile, writeFile } from "node:fs/promises";
+import path from "node:path";
+export function registerEditRegex(server, vaultPath, vault) {
+    server.tool("edit_regex", "Regex find-and-replace. Single file or grep-sub across a directory. Supports capture groups ($1, $2). Dry run by default.", {
+        path: z.string().optional().describe("Single file path (mutually exclusive with search_paths)"),
+        search_paths: z
+            .object({
+            directory: z.string().describe("Directory to search"),
+            recursive: z.boolean().default(false).describe("Include subdirectories"),
+            pattern_filter: z.string().default("*.md").describe("Glob pattern to filter files (default: *.md)"),
+        })
+            .optional()
+            .describe("Multi-file mode: search across directory"),
+        match: z.string().describe("Regex pattern to find"),
+        replace: z.string().describe("Replacement string ($1, $2 for capture groups)"),
+        flags: z.string().default("g").describe("Regex flags (default: 'g')"),
+        max_replacements: z.number().optional().describe("Safety cap: max replacements per file"),
+        dry_run: z.boolean().default(true).describe("Preview changes without writing (default: true)"),
+    }, async ({ path: filePath, search_paths, match, replace, flags, max_replacements, dry_run }) => {
+        await vault.waitReady();
+        // Validate regex
+        let regex;
+        try {
+            regex = new RegExp(match, flags);
+        }
+        catch (err) {
+            return {
+                content: [{ type: "text", text: `ERROR: Invalid regex: ${err.message}` }],
+                isError: true,
+            };
+        }
+        // Build file list
+        let filePaths = [];
+        if (filePath) {
+            const resolved = vault.resolve(filePath);
+            filePaths = [resolved?.rel ?? filePath];
+        }
+        else if (search_paths) {
+            const dir = search_paths.directory;
+            let files = search_paths.recursive
+                ? vault.searchPaths(dir === "." ? "" : dir)
+                : vault.listDir(dir);
+            // Apply glob filter
+            if (search_paths.pattern_filter && search_paths.pattern_filter !== "*") {
+                const extMatch = search_paths.pattern_filter.match(/^\*(\.\w+)$/);
+                if (extMatch) {
+                    files = files.filter((f) => f.ext === extMatch[1]);
+                }
+            }
+            filePaths = files.map((f) => f.rel);
+        }
+        else {
+            return {
+                content: [{ type: "text", text: "ERROR: Provide either 'path' or 'search_paths'" }],
+                isError: true,
+            };
+        }
+        const results = [];
+        let totalMatches = 0;
+        let totalReplacements = 0;
+        // Ensure 'g' flag for matchAll
+        const matchAllFlags = flags.includes("g") ? flags : flags + "g";
+        const matchAllRegex = new RegExp(match, matchAllFlags);
+        for (const fp of filePaths) {
+            const fullPath = path.join(vaultPath, fp);
+            let content;
+            try {
+                content = await readFile(fullPath, "utf-8");
+            }
+            catch {
+                continue;
+            }
+            // Skip binary-looking files
+            if (content.includes("\0"))
+                continue;
+            const matches = [...content.matchAll(matchAllRegex)];
+            if (matches.length === 0)
+                continue;
+            let effectiveMatches = matches;
+            if (max_replacements && matches.length > max_replacements) {
+                effectiveMatches = matches.slice(0, max_replacements);
+            }
+            const replacementsCount = effectiveMatches.length;
+            totalMatches += matches.length;
+            totalReplacements += replacementsCount;
+            // Generate preview (first 3 matches)
+            const singleRegex = new RegExp(match, flags.replace("g", ""));
+            const preview = effectiveMatches.slice(0, 3).map((m) => {
+                const start = Math.max(0, m.index - 30);
+                const end = Math.min(content.length, m.index + m[0].length + 30);
+                return {
+                    original: m[0],
+                    replaced: m[0].replace(singleRegex, replace),
+                    context: content.slice(start, end),
+                };
+            });
+            results.push({
+                path: fp,
+                matches_found: matches.length,
+                replacements_made: replacementsCount,
+                preview,
+            });
+            if (!dry_run) {
+                let newContent;
+                if (max_replacements) {
+                    // Limited replacements: replace only up to max
+                    let count = 0;
+                    newContent = content.replace(regex, (match, ...args) => {
+                        if (count >= max_replacements)
+                            return match;
+                        count++;
+                        // Reconstruct replacement with capture groups
+                        return match.replace(singleRegex, replace);
+                    });
+                }
+                else {
+                    newContent = content.replace(regex, replace);
+                }
+                if (newContent !== content) {
+                    await writeFile(fullPath, newContent, "utf-8");
+                }
+            }
+        }
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: JSON.stringify({
+                        files_searched: filePaths.length,
+                        files_matched: results.length,
+                        total_matches: totalMatches,
+                        total_replacements: totalReplacements,
+                        dry_run,
+                        results,
+                    }, null, 2),
+                },
+            ],
+        };
+    });
+}
+//# sourceMappingURL=edit-regex.js.map

package/dist/tools/notes/edit-regex.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"edit-regex.js","sourceRoot":"","sources":["../../../src/tools/notes/edit-regex.ts"],"names":[],"mappings":"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"}

package/dist/tools/search/markdown-parser.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Markdown parsing utilities for search indexing.
+ * Strips syntax for BM25 scoring, extracts frontmatter and headings.
+ */
+export declare function stripMarkdown(content: string): string;
+export declare function extractFrontmatter(content: string): {
+    tags: string;
+    aliases: string;
+};
+export declare function extractHeadings(content: string): string;
+export declare function extractSnippet(content: string, query: string, maxLength?: number): string;
+//# sourceMappingURL=markdown-parser.d.ts.map

package/dist/tools/search/markdown-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"markdown-parser.d.ts","sourceRoot":"","sources":["../../../src/tools/search/markdown-parser.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAerD;AAED,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAYrF;AAED,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAGvD;AAED,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,GAAE,MAAY,GAAG,MAAM,CA6B9F"}

package/dist/tools/search/markdown-parser.js

@@ -0,0 +1,64 @@
+/**
+ * Markdown parsing utilities for search indexing.
+ * Strips syntax for BM25 scoring, extracts frontmatter and headings.
+ */
+export function stripMarkdown(content) {
+    return content
+        .replace(/^---[\s\S]*?---/m, "") // frontmatter
+        .replace(/```[\s\S]*?```/g, "") // code blocks
+        .replace(/`[^`]+`/g, "") // inline code
+        .replace(/!\[.*?\]\(.*?\)/g, "") // images
+        .replace(/\[([^\]]+)\]\(.*?\)/g, "$1") // links → text only
+        .replace(/#{1,6}\s/g, "") // heading markers
+        .replace(/[*_~]{1,3}/g, "") // bold/italic/strikethrough
+        .replace(/>\s/g, "") // blockquotes
+        .replace(/[-*+]\s/g, "") // list markers
+        .replace(/\d+\.\s/g, "") // numbered lists
+        .replace(/\|.*\|/g, "") // tables
+        .replace(/\n{3,}/g, "\n\n") // collapse newlines
+        .trim();
+}
+export function extractFrontmatter(content) {
+    const match = content.match(/^---\n([\s\S]*?)\n---/);
+    if (!match)
+        return { tags: "", aliases: "" };
+    const yaml = match[1];
+    const tagsMatch = yaml.match(/tags:\s*\[?(.*?)\]?\s*\n/);
+    const tags = tagsMatch ? tagsMatch[1].replace(/[,\[\]"']/g, " ").trim() : "";
+    const aliasMatch = yaml.match(/aliases:\s*\[?(.*?)\]?\s*\n/);
+    const aliases = aliasMatch ? aliasMatch[1].replace(/[,\[\]"']/g, " ").trim() : "";
+    return { tags, aliases };
+}
+export function extractHeadings(content) {
+    const headings = content.match(/^#{1,6}\s+(.+)$/gm);
+    return headings ? headings.map((h) => h.replace(/^#{1,6}\s+/, "")).join(" ") : "";
+}
+export function extractSnippet(content, query, maxLength = 200) {
+    const terms = query.toLowerCase().split(/\s+/);
+    const lower = content.toLowerCase();
+    let bestPos = 0;
+    let bestScore = 0;
+    // Sample positions rather than scanning every character
+    const step = Math.max(1, Math.floor(lower.length / 500));
+    for (let i = 0; i < lower.length; i += step) {
+        let score = 0;
+        for (const term of terms) {
+            const idx = lower.indexOf(term, i);
+            if (idx !== -1 && idx < i + maxLength)
+                score++;
+        }
+        if (score > bestScore) {
+            bestScore = score;
+            bestPos = i;
+        }
+    }
+    const start = Math.max(0, bestPos - 40);
+    const end = Math.min(content.length, start + maxLength);
+    let snippet = content.slice(start, end).replace(/\n/g, " ").trim();
+    if (start > 0)
+        snippet = "..." + snippet;
+    if (end < content.length)
+        snippet = snippet + "...";
+    return snippet;
+}
+//# sourceMappingURL=markdown-parser.js.map

package/dist/tools/search/markdown-parser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"markdown-parser.js","sourceRoot":"","sources":["../../../src/tools/search/markdown-parser.ts"],"names":[],"mappings":"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"}