@phantomind/core 0.1.0

package/dist/cli/validate.js

@@ -0,0 +1,125 @@
+/**
+ * PhantomMindAI — CLI Validate Command
+ * Validate code output for quality issues.
+ */
+import { readFile } from 'node:fs/promises';
+import { existsSync } from 'node:fs';
+import { SecretScanner } from '../quality/secret-scanner.js';
+import { HallucinationGuard } from '../quality/hallucination-guard.js';
+import { ConsistencyEnforcer } from '../quality/consistency.js';
+export async function validateCommand(projectRoot, options) {
+    const chalk = (await import('chalk')).default;
+    const ora = (await import('ora')).default;
+    const fastGlob = (await import('fast-glob')).default;
+    console.log(chalk.bold.cyan('\n🔍 PhantomMindAI — Code Validation\n'));
+    const spinner = ora('Scanning files...').start();
+    let totalIssues = 0;
+    try {
+        // Determine files to scan
+        let files;
+        if (options.files && options.files.length > 0) {
+            files = options.files.filter(f => existsSync(f));
+        }
+        else {
+            files = await fastGlob(['**/*.{ts,tsx,js,jsx,py,go,rs,java,kt,swift}'], {
+                cwd: projectRoot,
+                ignore: ['**/node_modules/**', '**/dist/**', '**/.git/**', '**/build/**'],
+                absolute: true,
+            });
+        }
+        spinner.text = `Found ${files.length} files to validate`;
+        // Secret scanning
+        if (options.secrets !== false) {
+            spinner.text = 'Scanning for secrets...';
+            const scanner = new SecretScanner();
+            let secretCount = 0;
+            for (const file of files) {
+                const content = await readFile(file, 'utf-8');
+                const secrets = scanner.scan(content, file);
+                if (secrets.length > 0) {
+                    secretCount += secrets.length;
+                    for (const secret of secrets) {
+                        const relPath = file.replace(projectRoot + '/', '');
+                        console.log(`  ${chalk.red('SECRET')} ${chalk.dim(relPath)}:${secret.line} ${chalk.yellow(secret.pattern)} ${chalk.dim(`[${secret.severity}]`)}`);
+                        if (options.fix) {
+                            const { cleaned } = scanner.scanAndReplace(content, file);
+                            await import('node:fs/promises').then(fs => fs.writeFile(file, cleaned));
+                        }
+                    }
+                }
+            }
+            totalIssues += secretCount;
+            if (secretCount > 0) {
+                console.log(chalk.red(`\n  Found ${secretCount} secret(s)${options.fix ? ' (auto-fixed)' : ''}`));
+            }
+            else {
+                console.log(chalk.green('  ✓ No secrets detected'));
+            }
+            console.log('');
+        }
+        // Hallucination checking
+        if (options.hallucinations !== false) {
+            spinner.text = 'Checking for hallucinations...';
+            const guard = new HallucinationGuard(projectRoot);
+            let hallucinationCount = 0;
+            for (const file of files.filter(f => f.endsWith('.ts') || f.endsWith('.tsx') || f.endsWith('.js') || f.endsWith('.jsx'))) {
+                const content = await readFile(file, 'utf-8');
+                const issues = await guard.check(content, file);
+                if (issues.length > 0) {
+                    hallucinationCount += issues.length;
+                    for (const issue of issues) {
+                        const relPath = file.replace(projectRoot + '/', '');
+                        console.log(`  ${chalk.yellow('HALLUCINATION')} ${chalk.dim(relPath)}:${issue.line} [${issue.type}] ${issue.reference} ${issue.exists ? chalk.green('exists') : chalk.red('not found')}`);
+                        if (issue.suggestions && issue.suggestions.length > 0) {
+                            console.log(chalk.dim(`    Suggestions: ${issue.suggestions.join(', ')}`));
+                        }
+                    }
+                }
+            }
+            totalIssues += hallucinationCount;
+            if (hallucinationCount > 0) {
+                console.log(chalk.yellow(`\n  Found ${hallucinationCount} potential hallucination(s)`));
+            }
+            else {
+                console.log(chalk.green('  ✓ No hallucinations detected'));
+            }
+            console.log('');
+        }
+        // Consistency checking
+        if (options.consistency !== false) {
+            spinner.text = 'Checking consistency...';
+            const enforcer = new ConsistencyEnforcer(projectRoot);
+            const report = await enforcer.scan();
+            if (report.issues.length > 0) {
+                totalIssues += report.issues.length;
+                for (const issue of report.issues) {
+                    console.log(`  ${chalk.magenta('CONSISTENCY')} ${chalk.dim(issue.files.join(', '))} ${issue.description} ${chalk.dim(`[${issue.severity}]`)}`);
+                }
+                console.log(chalk.magenta(`\n  Found ${report.issues.length} consistency issue(s)`));
+            }
+            else {
+                console.log(chalk.green('  ✓ No consistency issues'));
+            }
+            console.log('');
+        }
+        spinner.stop();
+        // Summary
+        console.log(chalk.dim('─'.repeat(50)));
+        if (totalIssues > 0) {
+            console.log(chalk.yellow(`\n⚠️  Total: ${totalIssues} issue(s) found`));
+        }
+        else {
+            console.log(chalk.green('\n✅ All checks passed!'));
+        }
+        console.log('');
+        if (totalIssues > 0) {
+            process.exitCode = 1;
+        }
+    }
+    catch (error) {
+        spinner.fail('Validation failed');
+        console.error(chalk.red(error.message));
+        process.exit(1);
+    }
+}
+//# sourceMappingURL=validate.js.map

package/dist/cli/validate.js.map

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

package/dist/config/index.d.ts

@@ -0,0 +1,2 @@
+export { loadConfig, loadEnvFile, getDefaultConfig, findProjectRoot, deepMerge } from './loader.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/config/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/config/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,gBAAgB,EAAE,eAAe,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC"}

package/dist/config/index.js

@@ -0,0 +1,2 @@
+export { loadConfig, loadEnvFile, getDefaultConfig, findProjectRoot, deepMerge } from './loader.js';
+//# sourceMappingURL=index.js.map

package/dist/config/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/config/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,gBAAgB,EAAE,eAAe,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC"}

package/dist/config/loader.d.ts

@@ -0,0 +1,25 @@
+/**
+ * PhantomMindAI — Configuration Loader
+ */
+import { PhantomConfig } from '../types.js';
+/**
+ * Find project root by looking for .phantomind/ directory
+ */
+export declare function findProjectRoot(startDir?: string): Promise<string>;
+/**
+ * Load PhantomMindAI configuration from .phantomind/config.yaml
+ */
+export declare function loadConfig(projectRoot?: string): Promise<PhantomConfig>;
+/**
+ * Load .phantomind/.env file into process.env
+ */
+export declare function loadEnvFile(projectRoot?: string): Promise<void>;
+/**
+ * Get the default configuration
+ */
+export declare function getDefaultConfig(): PhantomConfig;
+/**
+ * Deep merge two objects
+ */
+export declare function deepMerge(target: unknown, source: unknown): unknown;
+//# sourceMappingURL=loader.d.ts.map

package/dist/config/loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../src/config/loader.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH,OAAO,EAAE,aAAa,EAAuB,MAAM,aAAa,CAAC;AAgEjE;;GAEG;AACH,wBAAsB,eAAe,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAexE;AAwBD;;GAEG;AACH,wBAAsB,UAAU,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CA0B7E;AAED;;GAEG;AACH,wBAAsB,WAAW,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAwBrE;AAED;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,aAAa,CAEhD;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,GAAG,OAAO,CAenE"}

package/dist/config/loader.js

@@ -0,0 +1,190 @@
+/**
+ * PhantomMindAI — Configuration Loader
+ */
+import { readFile, access } from 'node:fs/promises';
+import { join, resolve } from 'node:path';
+import yaml from 'js-yaml';
+import { PhantomConfigSchema } from '../types.js';
+const DEFAULT_CONFIG = {
+    version: '1',
+    providers: {
+        primary: {
+            name: 'anthropic',
+            model: 'claude-sonnet-4-20250514',
+            maxTokens: 8096,
+            temperature: 0.2,
+        },
+    },
+    context: {
+        skills: '.phantomind/SKILLS.md',
+        rules: '.phantomind/RULES.md',
+        schema: '.phantomind/schema.json',
+        prds: '.phantomind/prds/',
+        decisions: '.phantomind/decisions/',
+    },
+    adapters: ['copilot', 'cursor', 'cline', 'continue', 'windsurf'],
+    mcp: {
+        enabled: true,
+        port: 3741,
+        autoStart: true,
+    },
+    quality: {
+        secretScanner: true,
+        hallucinationGuard: true,
+        dualVerification: false,
+    },
+    agent: {
+        maxSteps: 30,
+        humanCheckpoint: {
+            before: ['write_file', 'delete_file', 'run_command'],
+            after: ['run_tests'],
+            onError: true,
+            onAnomalyDetected: true,
+        },
+        sandbox: {
+            allowedCommands: ['npm test', 'npm run build', 'npx tsc --noEmit'],
+            networkAccess: false,
+        },
+        memory: {
+            type: 'persistent',
+            path: '.phantomind/memory/',
+        },
+    },
+    budget: {
+        maxTokensPerTask: 100000,
+        maxCostPerDay: 10.0,
+        warningAt: 80,
+        fallbackOnBudget: 'budget',
+    },
+    git: {
+        autoCommit: false,
+        commitMessageFormat: 'conventional',
+        requireApproval: true,
+    },
+    team: {
+        contextSync: false,
+        remoteContext: '',
+    },
+};
+/**
+ * Find project root by looking for .phantomind/ directory
+ */
+export async function findProjectRoot(startDir) {
+    let dir = startDir ? resolve(startDir) : process.cwd();
+    const root = resolve('/');
+    while (dir !== root) {
+        try {
+            await access(join(dir, '.phantomind'));
+            return dir;
+        }
+        catch {
+            dir = resolve(dir, '..');
+        }
+    }
+    // If no .phantomind/ found, use cwd
+    return startDir ? resolve(startDir) : process.cwd();
+}
+/**
+ * Resolve environment variable references in config values
+ */
+function resolveEnvVars(value) {
+    if (typeof value === 'string') {
+        return value.replace(/\$\{([^}]+)\}/g, (_, envVar) => {
+            return process.env[envVar] ?? '';
+        });
+    }
+    if (Array.isArray(value)) {
+        return value.map(resolveEnvVars);
+    }
+    if (value !== null && typeof value === 'object') {
+        const resolved = {};
+        for (const [key, val] of Object.entries(value)) {
+            resolved[key] = resolveEnvVars(val);
+        }
+        return resolved;
+    }
+    return value;
+}
+/**
+ * Load PhantomMindAI configuration from .phantomind/config.yaml
+ */
+export async function loadConfig(projectRoot) {
+    const root = projectRoot ?? await findProjectRoot();
+    const configPath = join(root, '.phantomind', 'config.yaml');
+    try {
+        const raw = await readFile(configPath, 'utf-8');
+        const parsed = yaml.load(raw);
+        const resolved = resolveEnvVars(parsed);
+        // Deep merge with defaults
+        const merged = deepMerge(DEFAULT_CONFIG, resolved);
+        // Validate
+        const result = PhantomConfigSchema.safeParse(merged);
+        if (!result.success) {
+            const errors = result.error.issues.map(i => `  - ${i.path.join('.')}: ${i.message}`).join('\n');
+            throw new Error(`Invalid PhantomMindAI config:\n${errors}`);
+        }
+        return result.data;
+    }
+    catch (err) {
+        if (err.code === 'ENOENT') {
+            return DEFAULT_CONFIG;
+        }
+        throw err;
+    }
+}
+/**
+ * Load .phantomind/.env file into process.env
+ */
+export async function loadEnvFile(projectRoot) {
+    const root = projectRoot ?? await findProjectRoot();
+    const envPath = join(root, '.phantomind', '.env');
+    try {
+        const content = await readFile(envPath, 'utf-8');
+        for (const line of content.split('\n')) {
+            const trimmed = line.trim();
+            if (!trimmed || trimmed.startsWith('#'))
+                continue;
+            const eqIdx = trimmed.indexOf('=');
+            if (eqIdx === -1)
+                continue;
+            const key = trimmed.slice(0, eqIdx).trim();
+            let value = trimmed.slice(eqIdx + 1).trim();
+            // Remove surrounding quotes
+            if ((value.startsWith('"') && value.endsWith('"')) || (value.startsWith("'") && value.endsWith("'"))) {
+                value = value.slice(1, -1);
+            }
+            if (!process.env[key]) {
+                process.env[key] = value;
+            }
+        }
+    }
+    catch {
+        // .env file not required
+    }
+}
+/**
+ * Get the default configuration
+ */
+export function getDefaultConfig() {
+    return structuredClone(DEFAULT_CONFIG);
+}
+/**
+ * Deep merge two objects
+ */
+export function deepMerge(target, source) {
+    if (source === undefined || source === null)
+        return target;
+    if (target === undefined || target === null)
+        return source;
+    if (typeof target !== 'object' || typeof source !== 'object') {
+        return source;
+    }
+    if (Array.isArray(source))
+        return source;
+    const result = { ...target };
+    for (const [key, value] of Object.entries(source)) {
+        result[key] = deepMerge(result[key], value);
+    }
+    return result;
+}
+//# sourceMappingURL=loader.js.map

package/dist/config/loader.js.map

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

package/dist/context/embedder.d.ts

@@ -0,0 +1,53 @@
+/**
+ * PhantomMindAI — Live Codebase Embedder
+ * Creates and maintains embeddings of project source files for semantic search.
+ */
+export declare class CodebaseEmbedder {
+    private projectRoot;
+    private embeddings;
+    private documentFrequency;
+    private totalDocuments;
+    private cachePath;
+    private initialized;
+    constructor(projectRoot: string);
+    /**
+     * Build or update embeddings for the codebase
+     */
+    build(): Promise<{
+        indexed: number;
+        skipped: number;
+    }>;
+    /**
+     * Semantic search across the codebase
+     */
+    search(query: string, limit?: number): Promise<Array<{
+        path: string;
+        score: number;
+        snippet: string;
+    }>>;
+    /**
+     * Get relevant code snippet from a file
+     */
+    private getSnippet;
+    /**
+     * Tokenize text into meaningful words
+     */
+    private tokenize;
+    /**
+     * Compute term frequency
+     */
+    private computeTF;
+    /**
+     * Cosine similarity between two TF-IDF vectors
+     */
+    private cosineSimilarity;
+    /**
+     * Save embeddings to cache
+     */
+    private saveCache;
+    /**
+     * Load embeddings from cache
+     */
+    private loadCache;
+}
+//# sourceMappingURL=embedder.d.ts.map

package/dist/context/embedder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"embedder.d.ts","sourceRoot":"","sources":["../../src/context/embedder.ts"],"names":[],"mappings":"AAAA;;;GAGG;AA0BH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,UAAU,CAAyC;IAC3D,OAAO,CAAC,iBAAiB,CAAkC;IAC3D,OAAO,CAAC,cAAc,CAAK;IAC3B,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,WAAW,CAAS;gBAEhB,WAAW,EAAE,MAAM;IAK/B;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IAmE5D;;OAEG;IACG,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,SAAI,GAAG,OAAO,CAAC,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAkCxG;;OAEG;YACW,UAAU;IA4BxB;;OAEG;IACH,OAAO,CAAC,QAAQ;IAShB;;OAEG;IACH,OAAO,CAAC,SAAS;IAYjB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAkBxB;;OAEG;YACW,SAAS;IAmBvB;;OAEG;YACW,SAAS;CAqBxB"}

package/dist/context/embedder.js

@@ -0,0 +1,235 @@
+/**
+ * PhantomMindAI — Live Codebase Embedder
+ * Creates and maintains embeddings of project source files for semantic search.
+ */
+import { readFile, stat, writeFile, mkdir } from 'node:fs/promises';
+import { join, extname } from 'node:path';
+import fastGlob from 'fast-glob';
+const CODE_EXTENSIONS = new Set([
+    '.ts', '.tsx', '.js', '.jsx', '.swift', '.go', '.py', '.rs', '.java',
+    '.kt', '.rb', '.php', '.c', '.cpp', '.h', '.cs', '.vue', '.svelte',
+    '.md', '.json', '.yaml', '.yml', '.toml',
+]);
+const IGNORE_DIRS = new Set([
+    'node_modules', '.git', 'dist', 'build', '.next', '.nuxt',
+    'coverage', '.phantomind/cache', '.phantomind/memory', '.phantomind/audit',
+    'vendor', '__pycache__', '.tox', 'venv', '.venv',
+]);
+export class CodebaseEmbedder {
+    projectRoot;
+    embeddings = new Map();
+    documentFrequency = new Map();
+    totalDocuments = 0;
+    cachePath;
+    initialized = false;
+    constructor(projectRoot) {
+        this.projectRoot = projectRoot;
+        this.cachePath = join(projectRoot, '.phantomind', 'cache', 'embeddings.json');
+    }
+    /**
+     * Build or update embeddings for the codebase
+     */
+    async build() {
+        let indexed = 0;
+        let skipped = 0;
+        const files = await fastGlob('**/*', {
+            cwd: this.projectRoot,
+            ignore: [...IGNORE_DIRS].map(d => `${d}/**`),
+            onlyFiles: true,
+            absolute: false,
+        });
+        const sourceFiles = files.filter(f => CODE_EXTENSIONS.has(extname(f)));
+        // Build TF for each document
+        for (const file of sourceFiles) {
+            const fullPath = join(this.projectRoot, file);
+            try {
+                const stats = await stat(fullPath);
+                const existing = this.embeddings.get(file);
+                // Skip if not modified
+                if (existing && existing.lastModified >= stats.mtimeMs) {
+                    skipped++;
+                    continue;
+                }
+                const content = await readFile(fullPath, 'utf-8');
+                const tokens = this.tokenize(content);
+                const tf = this.computeTF(tokens);
+                this.embeddings.set(file, {
+                    path: file,
+                    tokens,
+                    tfidf: tf,
+                    lastModified: stats.mtimeMs,
+                });
+                indexed++;
+            }
+            catch {
+                skipped++;
+            }
+        }
+        // Compute IDF
+        this.totalDocuments = this.embeddings.size;
+        this.documentFrequency.clear();
+        for (const embedding of this.embeddings.values()) {
+            const uniqueTokens = new Set(embedding.tokens);
+            for (const token of uniqueTokens) {
+                this.documentFrequency.set(token, (this.documentFrequency.get(token) ?? 0) + 1);
+            }
+        }
+        // Update TF-IDF scores
+        for (const embedding of this.embeddings.values()) {
+            for (const [token, tf] of embedding.tfidf.entries()) {
+                const df = this.documentFrequency.get(token) ?? 1;
+                const idf = Math.log(this.totalDocuments / df) + 1;
+                embedding.tfidf.set(token, tf * idf);
+            }
+        }
+        this.initialized = true;
+        await this.saveCache();
+        return { indexed, skipped };
+    }
+    /**
+     * Semantic search across the codebase
+     */
+    async search(query, limit = 5) {
+        if (!this.initialized) {
+            await this.loadCache();
+            if (!this.initialized) {
+                await this.build();
+            }
+        }
+        const queryTokens = this.tokenize(query);
+        const queryTF = this.computeTF(queryTokens);
+        const results = [];
+        for (const [path, embedding] of this.embeddings) {
+            const score = this.cosineSimilarity(queryTF, embedding.tfidf);
+            if (score > 0) {
+                results.push({ path, score });
+            }
+        }
+        results.sort((a, b) => b.score - a.score);
+        const topResults = results.slice(0, limit);
+        // Load snippets for top results
+        const withSnippets = await Promise.all(topResults.map(async (r) => {
+            const content = await this.getSnippet(r.path, queryTokens);
+            return { ...r, snippet: content };
+        }));
+        return withSnippets;
+    }
+    /**
+     * Get relevant code snippet from a file
+     */
+    async getSnippet(filePath, queryTokens) {
+        try {
+            const content = await readFile(join(this.projectRoot, filePath), 'utf-8');
+            const lines = content.split('\n');
+            // Find the most relevant line range
+            let bestStart = 0;
+            let bestScore = 0;
+            const windowSize = 15;
+            for (let i = 0; i < lines.length - windowSize; i++) {
+                const window = lines.slice(i, i + windowSize).join('\n').toLowerCase();
+                let score = 0;
+                for (const token of queryTokens) {
+                    if (window.includes(token))
+                        score++;
+                }
+                if (score > bestScore) {
+                    bestScore = score;
+                    bestStart = i;
+                }
+            }
+            return lines.slice(bestStart, bestStart + windowSize).join('\n');
+        }
+        catch {
+            return '';
+        }
+    }
+    /**
+     * Tokenize text into meaningful words
+     */
+    tokenize(text) {
+        return (text
+            .replace(/([a-z])([A-Z])/g, '$1 $2') // camelCase split
+            .replace(/[_\-./\\]/g, ' ') // separator split
+            .match(/[a-zA-Z][a-zA-Z0-9]{1,}/g) ?? [])
+            .map(w => w.toLowerCase())
+            .filter(w => w.length > 2);
+    }
+    /**
+     * Compute term frequency
+     */
+    computeTF(tokens) {
+        const tf = new Map();
+        const total = tokens.length || 1;
+        for (const token of tokens) {
+            tf.set(token, (tf.get(token) ?? 0) + 1);
+        }
+        for (const [token, count] of tf.entries()) {
+            tf.set(token, count / total);
+        }
+        return tf;
+    }
+    /**
+     * Cosine similarity between two TF-IDF vectors
+     */
+    cosineSimilarity(a, b) {
+        let dotProduct = 0;
+        let normA = 0;
+        let normB = 0;
+        for (const [token, va] of a) {
+            const vb = b.get(token) ?? 0;
+            dotProduct += va * vb;
+            normA += va * va;
+        }
+        for (const vb of b.values()) {
+            normB += vb * vb;
+        }
+        const denominator = Math.sqrt(normA) * Math.sqrt(normB);
+        return denominator === 0 ? 0 : dotProduct / denominator;
+    }
+    /**
+     * Save embeddings to cache
+     */
+    async saveCache() {
+        try {
+            await mkdir(join(this.projectRoot, '.phantomind', 'cache'), { recursive: true });
+            const data = {
+                totalDocuments: this.totalDocuments,
+                embeddings: Array.from(this.embeddings.entries()).map(([path, emb]) => ({
+                    path,
+                    tokens: emb.tokens.slice(0, 200), // limit for cache size
+                    tfidf: Object.fromEntries(emb.tfidf),
+                    lastModified: emb.lastModified,
+                })),
+                documentFrequency: Object.fromEntries(this.documentFrequency),
+            };
+            await writeFile(this.cachePath, JSON.stringify(data), 'utf-8');
+        }
+        catch {
+            // Cache save failure is non-critical
+        }
+    }
+    /**
+     * Load embeddings from cache
+     */
+    async loadCache() {
+        try {
+            const raw = await readFile(this.cachePath, 'utf-8');
+            const data = JSON.parse(raw);
+            this.totalDocuments = data.totalDocuments;
+            this.documentFrequency = new Map(Object.entries(data.documentFrequency));
+            for (const emb of data.embeddings) {
+                this.embeddings.set(emb.path, {
+                    path: emb.path,
+                    tokens: emb.tokens,
+                    tfidf: new Map(Object.entries(emb.tfidf)),
+                    lastModified: emb.lastModified,
+                });
+            }
+            this.initialized = true;
+        }
+        catch {
+            // No cache or invalid cache
+        }
+    }
+}
+//# sourceMappingURL=embedder.js.map