@blacksmithers/vaultforge 1.0.0

package/dist/tools/files/batch-rename.js

@@ -0,0 +1,140 @@
+import { z } from "zod";
+import { rename, mkdir } from "node:fs/promises";
+import path from "node:path";
+import { updateWikilinks } from "../links/update-links.js";
+export function registerBatchRename(server, vaultPath, vault) {
+    server.tool("batch_rename", "Rename/move files. Explicit pairs or regex pattern on filenames. Auto-updates wikilinks. Dry run by default. Atomic fs.rename preserves metadata.", {
+        renames: z
+            .array(z.object({ from: z.string(), to: z.string() }))
+            .optional()
+            .describe("Mode 1: explicit rename pairs"),
+        pattern: z
+            .object({
+            directory: z.string().describe("Directory to search"),
+            match: z.string().describe("Regex applied to filename only"),
+            replace: z.string().describe("Replacement string ($1, $2 for capture groups)"),
+            filter_ext: z.string().default(".md").describe("Extension filter (default: .md)"),
+            recursive: z.boolean().default(false).describe("Search subdirectories"),
+        })
+            .optional()
+            .describe("Mode 2: regex pattern on filenames"),
+        dry_run: z.boolean().default(true).describe("Preview without executing (default: true)"),
+        update_links: z.boolean().default(true).describe("Auto-update wikilinks after rename (default: true)"),
+    }, async ({ renames, pattern, dry_run, update_links: doUpdateLinks }) => {
+        await vault.waitReady();
+        // Build rename pairs
+        let pairs = [];
+        if (renames && renames.length > 0) {
+            // Mode 1: explicit pairs
+            for (const r of renames) {
+                const fromResolved = vault.resolve(r.from);
+                const from = fromResolved?.rel ?? r.from;
+                pairs.push({ from, to: r.to });
+            }
+        }
+        else if (pattern) {
+            // Mode 2: regex on filenames
+            let regex;
+            try {
+                regex = new RegExp(pattern.match);
+            }
+            catch (err) {
+                return {
+                    content: [{ type: "text", text: `ERROR: Invalid regex: ${err.message}` }],
+                    isError: true,
+                };
+            }
+            const searchDir = pattern.directory;
+            const files = pattern.recursive
+                ? vault.searchPaths(searchDir === "." ? "" : searchDir)
+                : vault.listDir(searchDir);
+            for (const f of files) {
+                if (f.ext !== pattern.filter_ext)
+                    continue;
+                const filename = path.basename(f.rel);
+                if (!regex.test(filename))
+                    continue;
+                const newFilename = filename.replace(regex, pattern.replace);
+                if (newFilename === filename)
+                    continue;
+                pairs.push({
+                    from: f.rel,
+                    to: path.join(path.dirname(f.rel), newFilename).replace(/\\/g, "/"),
+                });
+            }
+        }
+        else {
+            return {
+                content: [{ type: "text", text: "ERROR: Provide either 'renames' or 'pattern'" }],
+                isError: true,
+            };
+        }
+        if (pairs.length === 0) {
+            return {
+                content: [{ type: "text", text: JSON.stringify({ renamed: 0, results: [], dry_run, message: "No files matched" }, null, 2) }],
+            };
+        }
+        // Pre-flight: detect conflicts
+        const targets = new Set();
+        const sources = new Set();
+        for (const p of pairs) {
+            if (targets.has(p.to)) {
+                return {
+                    content: [{ type: "text", text: `ERROR: Duplicate target: ${p.to}` }],
+                    isError: true,
+                };
+            }
+            targets.add(p.to);
+            sources.add(p.from);
+        }
+        // Detect circular renames
+        for (const p of pairs) {
+            if (sources.has(p.to) && targets.has(p.from)) {
+                return {
+                    content: [{ type: "text", text: `ERROR: Circular rename detected: ${p.from} ↔ ${p.to}` }],
+                    isError: true,
+                };
+            }
+        }
+        // Check target conflicts with existing files
+        for (const p of pairs) {
+            if (!sources.has(p.to) && vault.has(p.to)) {
+                return {
+                    content: [{ type: "text", text: `ERROR: Target already exists: ${p.to}` }],
+                    isError: true,
+                };
+            }
+        }
+        const results = [];
+        let totalLinksUpdated = 0;
+        for (const p of pairs) {
+            let linksAffected = 0;
+            if (!dry_run) {
+                const fromAbs = path.join(vaultPath, p.from);
+                const toAbs = path.join(vaultPath, p.to);
+                await mkdir(path.dirname(toAbs), { recursive: true });
+                await rename(fromAbs, toAbs);
+            }
+            if (doUpdateLinks) {
+                const linkResult = await updateWikilinks(vaultPath, vault, p.from, p.to, dry_run);
+                linksAffected = linkResult.totalLinks;
+                totalLinksUpdated += linksAffected;
+            }
+            results.push({ from: p.from, to: p.to, links_affected: linksAffected });
+        }
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: JSON.stringify({
+                        renamed: pairs.length,
+                        links_updated: totalLinksUpdated,
+                        dry_run,
+                        results,
+                    }, null, 2),
+                },
+            ],
+        };
+    });
+}
+//# sourceMappingURL=batch-rename.js.map

package/dist/tools/files/batch-rename.js.map

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

package/dist/tools/files/delete-folder.d.ts

@@ -0,0 +1,17 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { VaultIndex } from "../../vault-index.js";
+interface ToolResult {
+    content: Array<{
+        type: "text";
+        text: string;
+    }>;
+    isError?: boolean;
+}
+export declare function handleDeleteFolder(vault: VaultIndex, vaultPath: string, args: {
+    path: string;
+    recursive: boolean;
+    permanent: boolean;
+}): Promise<ToolResult>;
+export declare function registerDeleteFolder(server: McpServer, vaultPath: string, vault: VaultIndex): void;
+export {};
+//# sourceMappingURL=delete-folder.d.ts.map

package/dist/tools/files/delete-folder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"delete-folder.d.ts","sourceRoot":"","sources":["../../../src/tools/files/delete-folder.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAIpE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AACvD,UAAU,UAAU;IAClB,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC/C,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAcD,wBAAsB,kBAAkB,CACtC,KAAK,EAAE,UAAU,EACjB,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,OAAO,CAAC;IAAC,SAAS,EAAE,OAAO,CAAA;CAAE,GAC7D,OAAO,CAAC,UAAU,CAAC,CAuErB;AAWD,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,SAAS,EACjB,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,UAAU,GAChB,IAAI,CAeN"}

package/dist/tools/files/delete-folder.js

@@ -0,0 +1,100 @@
+import { z } from "zod";
+import { mkdir, readdir, rm, rename as fsRename, stat } from "node:fs/promises";
+import path from "node:path";
+const PROTECTED_DIRS = [".obsidian", ".vaultforge", ".trash", ".git"];
+function isProtected(relPath) {
+    const first = relPath.split("/")[0];
+    return PROTECTED_DIRS.includes(first);
+}
+function isVaultRoot(relPath) {
+    const norm = relPath.replace(/\\/g, "/").replace(/^\/+/, "").replace(/\/+$/, "");
+    return norm === "" || norm === ".";
+}
+export async function handleDeleteFolder(vault, vaultPath, args) {
+    const relPath = args.path.replace(/\\/g, "/").replace(/^\/+/, "").replace(/\/+$/, "");
+    if (isVaultRoot(relPath)) {
+        return { content: [{ type: "text", text: "ERROR: Refusing to delete vault root." }], isError: true };
+    }
+    if (isProtected(relPath)) {
+        return { content: [{ type: "text", text: `ERROR: Refusing to delete protected directory: ${relPath}` }], isError: true };
+    }
+    const absPath = path.join(vaultPath, relPath);
+    // Verify it exists and is a directory
+    try {
+        const st = await stat(absPath);
+        if (!st.isDirectory()) {
+            return { content: [{ type: "text", text: `ERROR: Not a directory: ${relPath}` }], isError: true };
+        }
+    }
+    catch {
+        return { content: [{ type: "text", text: `ERROR: Directory not found: ${relPath}` }], isError: true };
+    }
+    // Count children on disk
+    const childCount = await countDiskChildren(absPath);
+    if (!args.recursive && childCount > 0) {
+        return {
+            content: [{
+                    type: "text",
+                    text: `ERROR: Directory '${relPath}' is not empty (${childCount} children). Use recursive: true to delete with contents, or delete contents first.`,
+                }],
+            isError: true,
+        };
+    }
+    // Count index entries BEFORE deletion (fs.watch may clean up after rm)
+    const preRemoved = vault.removeDir(relPath);
+    let filesRemoved = preRemoved.filesRemoved;
+    let dirsRemoved = preRemoved.dirsRemoved;
+    if (dirsRemoved === 0)
+        dirsRemoved = 1; // at least the dir itself
+    if (!args.permanent) {
+        // Move to .trash preserving relative path
+        const trashDir = path.join(vaultPath, ".trash");
+        const trashDest = path.join(trashDir, relPath);
+        await mkdir(path.dirname(trashDest), { recursive: true });
+        try {
+            await fsRename(absPath, trashDest);
+        }
+        catch {
+            // Cross-device or other issue — copy then delete
+            const { cpSync } = await import("node:fs");
+            cpSync(absPath, trashDest, { recursive: true });
+            await rm(absPath, { recursive: true, force: true });
+        }
+    }
+    else {
+        await rm(absPath, { recursive: true, force: true });
+    }
+    return {
+        content: [{
+                type: "text",
+                text: JSON.stringify({
+                    path: relPath,
+                    deleted: true,
+                    files_removed: filesRemoved,
+                    dirs_removed: dirsRemoved,
+                    permanent: args.permanent,
+                }, null, 2),
+            }],
+    };
+}
+async function countDiskChildren(absDir) {
+    try {
+        const entries = await readdir(absDir);
+        return entries.length;
+    }
+    catch {
+        return 0;
+    }
+}
+export function registerDeleteFolder(server, vaultPath, vault) {
+    server.tool("delete_folder", "Delete a directory from the vault. Refuses non-empty dirs by default — use recursive: true for non-empty. Moves to .trash by default for safety.", {
+        path: z.string().describe("Relative path to the directory"),
+        recursive: z.boolean().default(false).describe("If true, delete the folder AND all contents. If false (default), refuse non-empty directories."),
+        permanent: z.boolean().default(false).describe("If true, skip .trash and delete permanently. If false (default), move to .trash."),
+    }, async ({ path: dirPath, recursive, permanent }) => {
+        await vault.waitReady();
+        const result = await handleDeleteFolder(vault, vaultPath, { path: dirPath, recursive, permanent });
+        return { ...result };
+    });
+}
+//# sourceMappingURL=delete-folder.js.map

package/dist/tools/files/delete-folder.js.map

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

package/dist/tools/files/prune-empty-dirs.d.ts

@@ -0,0 +1,17 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { VaultIndex } from "../../vault-index.js";
+interface ToolResult {
+    content: Array<{
+        type: "text";
+        text: string;
+    }>;
+    isError?: boolean;
+}
+export declare function handlePruneEmptyDirs(vault: VaultIndex, vaultPath: string, args: {
+    path: string;
+    dry_run: boolean;
+    exclude: string[];
+}): Promise<ToolResult>;
+export declare function registerPruneEmptyDirs(server: McpServer, vaultPath: string, vault: VaultIndex): void;
+export {};
+//# sourceMappingURL=prune-empty-dirs.d.ts.map

package/dist/tools/files/prune-empty-dirs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prune-empty-dirs.d.ts","sourceRoot":"","sources":["../../../src/tools/files/prune-empty-dirs.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAIpE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AACvD,UAAU,UAAU;IAClB,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC/C,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAID,wBAAsB,oBAAoB,CACxC,KAAK,EAAE,UAAU,EACjB,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,MAAM,EAAE,CAAA;CAAE,GAC1D,OAAO,CAAC,UAAU,CAAC,CAiGrB;AAED,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,SAAS,EACjB,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,UAAU,GAChB,IAAI,CAeN"}

package/dist/tools/files/prune-empty-dirs.js

@@ -0,0 +1,106 @@
+import { z } from "zod";
+import { readdir, rm, rmdir } from "node:fs/promises";
+import path from "node:path";
+const DEFAULT_EXCLUDES = [".obsidian", ".vaultforge", ".trash", ".git", "Templates"];
+export async function handlePruneEmptyDirs(vault, vaultPath, args) {
+    const relStart = args.path.replace(/\\/g, "/").replace(/^\/+/, "").replace(/\/+$/, "") || ".";
+    const absStart = relStart === "." ? vaultPath : path.join(vaultPath, relStart);
+    const excludeSet = new Set(args.exclude);
+    const emptyDirs = [];
+    let scanned = 0;
+    // Post-order traversal: returns true if the directory is empty after pruning
+    async function walk(absDir, relDir) {
+        scanned++;
+        let entries;
+        try {
+            entries = await readdir(absDir, { withFileTypes: true });
+        }
+        catch {
+            return false;
+        }
+        let hasFiles = false;
+        let hasNonEmptySubdirs = false;
+        let excludedChildCount = 0;
+        for (const entry of entries) {
+            // Skip hidden files (but let hidden directories through to the excludeSet check)
+            if (entry.name.startsWith(".") && !entry.isDirectory())
+                continue;
+            if (entry.name.startsWith(".") && entry.isDirectory() && !excludeSet.has(entry.name))
+                continue;
+            const childRel = relDir === "." ? entry.name : `${relDir}/${entry.name}`;
+            const childAbs = path.join(absDir, entry.name);
+            if (entry.isDirectory()) {
+                // Skip excluded directories — track them separately
+                if (excludeSet.has(entry.name)) {
+                    excludedChildCount++;
+                    continue;
+                }
+                const childEmpty = await walk(childAbs, childRel);
+                if (!childEmpty) {
+                    hasNonEmptySubdirs = true;
+                }
+            }
+            else {
+                hasFiles = true;
+            }
+        }
+        if (!hasFiles && !hasNonEmptySubdirs && relDir !== ".") {
+            if (excludedChildCount > 0) {
+                emptyDirs.push({ path: relDir, reason: "Only contains excluded directories" });
+                return true;
+            }
+            const reason = entries.length === 0
+                ? "No files or subdirectories"
+                : "Only contained empty subdirectories (pruned)";
+            emptyDirs.push({ path: relDir, reason });
+            return true;
+        }
+        return false;
+    }
+    await walk(absStart, relStart);
+    // Sort bottom-up (deepest paths first) for deletion order
+    emptyDirs.sort((a, b) => b.path.split("/").length - a.path.split("/").length);
+    let deleted = 0;
+    if (!args.dry_run) {
+        for (const dir of emptyDirs) {
+            const absDir = path.join(vaultPath, dir.path);
+            try {
+                if (dir.reason.includes("excluded directories")) {
+                    await rm(absDir, { recursive: true, force: true });
+                }
+                else {
+                    await rmdir(absDir);
+                }
+                vault.removeDir(dir.path);
+                deleted++;
+            }
+            catch {
+                // Directory may have been already removed or not actually empty
+            }
+        }
+    }
+    return {
+        content: [{
+                type: "text",
+                text: JSON.stringify({
+                    scanned,
+                    empty_found: emptyDirs.length,
+                    deleted: args.dry_run ? 0 : deleted,
+                    dry_run: args.dry_run,
+                    directories: emptyDirs,
+                }, null, 2),
+            }],
+    };
+}
+export function registerPruneEmptyDirs(server, vaultPath, vault) {
+    server.tool("prune_empty_dirs", "Find and remove empty directories in the vault. Dry run by default — preview before deleting. Bottom-up pruning handles cascading empty dirs.", {
+        path: z.string().default(".").describe("Starting directory to scan (default: vault root)"),
+        dry_run: z.boolean().default(true).describe("Preview without deleting (default: true). Set false to execute."),
+        exclude: z.array(z.string()).default(DEFAULT_EXCLUDES).describe("Directories to skip (default: .obsidian, .vaultforge, .trash, .git, Templates)"),
+    }, async ({ path: dirPath, dry_run, exclude }) => {
+        await vault.waitReady();
+        const result = await handlePruneEmptyDirs(vault, vaultPath, { path: dirPath, dry_run, exclude });
+        return { ...result };
+    });
+}
+//# sourceMappingURL=prune-empty-dirs.js.map

package/dist/tools/files/prune-empty-dirs.js.map

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

package/dist/tools/intelligence/clustering.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Agglomerative clustering using Jaccard similarity on TF-IDF fingerprints.
+ */
+import type { FileFingerprint } from "./tfidf.js";
+export interface ThemeCluster {
+    id: string;
+    label: string;
+    keyTerms: string[];
+    files: string[];
+    folders: string[];
+    coherenceScore: number;
+    crossFolder: boolean;
+}
+export declare function clusterFiles(fingerprints: FileFingerprint[], minClusterSize?: number, similarityThreshold?: number): ThemeCluster[];
+//# sourceMappingURL=clustering.d.ts.map

package/dist/tools/intelligence/clustering.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"clustering.d.ts","sourceRoot":"","sources":["../../../src/tools/intelligence/clustering.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAElD,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,EAAE,OAAO,CAAC;CACtB;AAgCD,wBAAgB,YAAY,CAC1B,YAAY,EAAE,eAAe,EAAE,EAC/B,cAAc,GAAE,MAAU,EAC1B,mBAAmB,GAAE,MAAa,GACjC,YAAY,EAAE,CAuEhB"}

package/dist/tools/intelligence/clustering.js

@@ -0,0 +1,93 @@
+/**
+ * Agglomerative clustering using Jaccard similarity on TF-IDF fingerprints.
+ */
+function capitalize(s) {
+    return s.charAt(0).toUpperCase() + s.slice(1);
+}
+function jaccardSimilarity(a, b) {
+    let intersection = 0;
+    for (const t of a) {
+        if (b.has(t))
+            intersection++;
+    }
+    const union = a.size + b.size - intersection;
+    return union === 0 ? 0 : intersection / union;
+}
+function computeAverageJaccard(files) {
+    if (files.length < 2)
+        return 1.0;
+    const termSets = files.map((f) => new Set(f.topTerms.map((t) => t.term)));
+    let totalSim = 0;
+    let pairs = 0;
+    for (let i = 0; i < termSets.length; i++) {
+        for (let j = i + 1; j < termSets.length; j++) {
+            totalSim += jaccardSimilarity(termSets[i], termSets[j]);
+            pairs++;
+        }
+    }
+    return pairs > 0 ? totalSim / pairs : 0;
+}
+export function clusterFiles(fingerprints, minClusterSize = 3, similarityThreshold = 0.15) {
+    let clusters = fingerprints.map((fp) => ({
+        files: [fp],
+        terms: new Set(fp.topTerms.map((t) => t.term)),
+    }));
+    // Agglomerative merging
+    while (true) {
+        let bestSim = 0;
+        let bestI = -1;
+        let bestJ = -1;
+        for (let i = 0; i < clusters.length; i++) {
+            for (let j = i + 1; j < clusters.length; j++) {
+                const sim = jaccardSimilarity(clusters[i].terms, clusters[j].terms);
+                if (sim > bestSim) {
+                    bestSim = sim;
+                    bestI = i;
+                    bestJ = j;
+                }
+            }
+        }
+        if (bestSim < similarityThreshold || bestI === -1)
+            break;
+        // Merge bestJ into bestI
+        clusters[bestI].files.push(...clusters[bestJ].files);
+        for (const t of clusters[bestJ].terms) {
+            clusters[bestI].terms.add(t);
+        }
+        clusters.splice(bestJ, 1);
+    }
+    // Convert to ThemeCluster
+    return clusters
+        .filter((c) => c.files.length >= minClusterSize)
+        .map((c) => {
+        const folders = [...new Set(c.files.map((f) => f.folder))];
+        // Label = top terms by combined TF-IDF
+        const termScores = new Map();
+        for (const file of c.files) {
+            for (const { term, tfidf } of file.topTerms) {
+                termScores.set(term, (termScores.get(term) || 0) + tfidf);
+            }
+        }
+        const sortedTerms = [...termScores.entries()]
+            .sort(([, a], [, b]) => b - a)
+            .slice(0, 6);
+        const coherence = computeAverageJaccard(c.files);
+        return {
+            id: sortedTerms
+                .slice(0, 2)
+                .map(([t]) => t)
+                .join("-"),
+            label: sortedTerms
+                .slice(0, 3)
+                .map(([t]) => capitalize(t))
+                .join(" + "),
+            keyTerms: sortedTerms.map(([t]) => t),
+            files: c.files.map((f) => f.path),
+            folders,
+            coherenceScore: Math.round(coherence * 100) / 100,
+            crossFolder: folders.length > 1,
+        };
+    })
+        .sort((a, b) => b.files.length - a.files.length);
+}
+//# sourceMappingURL=clustering.js.map

package/dist/tools/intelligence/clustering.js.map

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

package/dist/tools/intelligence/tfidf.d.ts

@@ -0,0 +1,19 @@
+/**
+ * TF-IDF computation and tokenizer for vault theme extraction.
+ */
+export declare function tokenize(text: string): string[];
+export interface FileFingerprint {
+    path: string;
+    title: string;
+    topTerms: Array<{
+        term: string;
+        tfidf: number;
+    }>;
+    folder: string;
+}
+export declare function computeTfIdf(files: Array<{
+    path: string;
+    title: string;
+    content: string;
+}>): FileFingerprint[];
+//# sourceMappingURL=tfidf.d.ts.map

package/dist/tools/intelligence/tfidf.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tfidf.d.ts","sourceRoot":"","sources":["../../../src/tools/intelligence/tfidf.ts"],"names":[],"mappings":"AAAA;;GAEG;AAqBH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAM/C;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACjD,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,wBAAgB,YAAY,CAC1B,KAAK,EAAE,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC,GAC7D,eAAe,EAAE,CA4CnB"}

package/dist/tools/intelligence/tfidf.js

@@ -0,0 +1,68 @@
+/**
+ * TF-IDF computation and tokenizer for vault theme extraction.
+ */
+const STOP_WORDS = new Set([
+    // English
+    "the", "a", "an", "is", "are", "was", "were", "be", "been", "being",
+    "have", "has", "had", "do", "does", "did", "will", "would", "could",
+    "should", "may", "might", "can", "shall", "to", "of", "in", "for",
+    "on", "with", "at", "by", "from", "this", "that", "these", "those",
+    "it", "its", "not", "but", "and", "or", "if", "then", "so", "as",
+    "than", "too", "very", "just", "about", "up", "out", "no", "all",
+    "also", "each", "which", "their", "there", "them", "they", "we",
+    "you", "your", "our", "my", "me", "he", "she", "his", "her",
+    // Portuguese
+    "de", "da", "do", "das", "dos", "em", "no", "na", "nos", "nas",
+    "um", "uma", "uns", "umas", "para", "por", "com", "sem", "sob",
+    "que", "se", "como", "mas", "ou", "e", "não", "mais", "muito",
+    "também", "já", "ainda", "só", "ao", "aos", "à", "às", "é", "são",
+    "foi", "ser", "ter", "está", "este", "esta", "esse", "essa", "isso",
+    "ele", "ela", "eles", "elas", "seu", "sua", "seus", "suas",
+]);
+export function tokenize(text) {
+    return text
+        .toLowerCase()
+        .replace(/[^a-záàâãéèêíïóôõöúçñ0-9\s-]/gi, " ")
+        .split(/\s+/)
+        .filter((t) => t.length > 2 && !STOP_WORDS.has(t));
+}
+export function computeTfIdf(files) {
+    // Step 1: tokenize all files
+    const tokenized = files.map((f) => ({
+        ...f,
+        tokens: tokenize(f.content),
+    }));
+    const totalFiles = tokenized.length;
+    if (totalFiles === 0)
+        return [];
+    // Step 2: document frequency
+    const df = new Map();
+    for (const file of tokenized) {
+        const uniqueTerms = new Set(file.tokens);
+        for (const term of uniqueTerms) {
+            df.set(term, (df.get(term) || 0) + 1);
+        }
+    }
+    // Step 3: TF-IDF per file
+    return tokenized.map((file) => {
+        const termCounts = new Map();
+        for (const token of file.tokens) {
+            termCounts.set(token, (termCounts.get(token) || 0) + 1);
+        }
+        const totalTerms = file.tokens.length || 1;
+        const tfidfScores = [];
+        for (const [term, count] of termCounts) {
+            const tf = count / totalTerms;
+            const idf = Math.log(totalFiles / (df.get(term) || 1));
+            tfidfScores.push({ term, tfidf: tf * idf });
+        }
+        tfidfScores.sort((a, b) => b.tfidf - a.tfidf);
+        return {
+            path: file.path,
+            title: file.title,
+            topTerms: tfidfScores.slice(0, 15),
+            folder: file.path.split("/").slice(0, -1).join("/"),
+        };
+    });
+}
+//# sourceMappingURL=tfidf.js.map