@phantomind/core 0.1.0

package/dist/quality/consistency.d.ts

@@ -0,0 +1,26 @@
+/**
+ * PhantomMindAI — Cross-File Consistency Enforcer
+ * Detect naming, pattern, and architecture inconsistencies.
+ */
+import type { ConsistencyReport } from '../types.js';
+export declare class ConsistencyEnforcer {
+    private projectRoot;
+    constructor(projectRoot: string);
+    /**
+     * Run full consistency scan
+     */
+    scan(scope?: 'naming' | 'pattern' | 'architecture' | 'all'): Promise<ConsistencyReport>;
+    /**
+     * Check naming convention consistency
+     */
+    private checkNamingConsistency;
+    /**
+     * Check async pattern consistency
+     */
+    private checkPatternConsistency;
+    /**
+     * Check architecture layer consistency
+     */
+    private checkArchitectureConsistency;
+}
+//# sourceMappingURL=consistency.d.ts.map

package/dist/quality/consistency.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"consistency.d.ts","sourceRoot":"","sources":["../../src/quality/consistency.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,OAAO,KAAK,EAAE,iBAAiB,EAAoB,MAAM,aAAa,CAAC;AAEvE,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,WAAW,CAAS;gBAEhB,WAAW,EAAE,MAAM;IAI/B;;OAEG;IACG,IAAI,CAAC,KAAK,GAAE,QAAQ,GAAG,SAAS,GAAG,cAAc,GAAG,KAAa,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAsCpG;;OAEG;IACH,OAAO,CAAC,sBAAsB;IA6C9B;;OAEG;IACH,OAAO,CAAC,uBAAuB;IAgC/B;;OAEG;IACH,OAAO,CAAC,4BAA4B;CAoCrC"}

package/dist/quality/consistency.js

@@ -0,0 +1,156 @@
+/**
+ * PhantomMindAI — Cross-File Consistency Enforcer
+ * Detect naming, pattern, and architecture inconsistencies.
+ */
+import { readFile } from 'node:fs/promises';
+import { join, extname } from 'node:path';
+import fastGlob from 'fast-glob';
+export class ConsistencyEnforcer {
+    projectRoot;
+    constructor(projectRoot) {
+        this.projectRoot = projectRoot;
+    }
+    /**
+     * Run full consistency scan
+     */
+    async scan(scope = 'all') {
+        const start = Date.now();
+        const issues = [];
+        const files = await fastGlob('**/*.{ts,tsx,js,jsx,swift,go,py}', {
+            cwd: this.projectRoot,
+            ignore: ['node_modules/**', 'dist/**', '.git/**'],
+        });
+        const fileContents = new Map();
+        for (const file of files) {
+            try {
+                const content = await readFile(join(this.projectRoot, file), 'utf-8');
+                fileContents.set(file, content);
+            }
+            catch {
+                continue;
+            }
+        }
+        if (scope === 'all' || scope === 'naming') {
+            issues.push(...this.checkNamingConsistency(fileContents));
+        }
+        if (scope === 'all' || scope === 'pattern') {
+            issues.push(...this.checkPatternConsistency(fileContents));
+        }
+        if (scope === 'all' || scope === 'architecture') {
+            issues.push(...this.checkArchitectureConsistency(fileContents));
+        }
+        return {
+            issues,
+            scannedFiles: files.length,
+            duration: Date.now() - start,
+        };
+    }
+    /**
+     * Check naming convention consistency
+     */
+    checkNamingConsistency(files) {
+        const issues = [];
+        const errorTypes = new Map();
+        const serviceTypes = new Map();
+        for (const [file, content] of files) {
+            // Check error type naming
+            const errorMatches = content.match(/(?:class|type|interface)\s+(\w*(?:Error|Exception|Failure)\w*)/g) ?? [];
+            for (const match of errorMatches) {
+                const name = match.split(/\s+/).pop();
+                const suffix = name.endsWith('Error') ? 'Error' : name.endsWith('Exception') ? 'Exception' : 'Failure';
+                const list = errorTypes.get(suffix) ?? [];
+                list.push(file);
+                errorTypes.set(suffix, list);
+            }
+            // Check service naming
+            const serviceMatches = content.match(/(?:class|type|interface)\s+(\w*(?:Service|Manager|Controller|Handler)\w*)/g) ?? [];
+            for (const match of serviceMatches) {
+                const name = match.split(/\s+/).pop();
+                for (const suffix of ['Service', 'Manager', 'Controller', 'Handler']) {
+                    if (name.endsWith(suffix)) {
+                        const list = serviceTypes.get(suffix) ?? [];
+                        list.push(file);
+                        serviceTypes.set(suffix, list);
+                    }
+                }
+            }
+        }
+        // Flag if multiple error naming conventions
+        if (errorTypes.size > 1) {
+            const allFiles = [...errorTypes.values()].flat();
+            issues.push({
+                type: 'naming',
+                description: `Mixed error type naming: ${[...errorTypes.keys()].join(', ')}. Use one convention.`,
+                files: [...new Set(allFiles)],
+                suggestion: 'Standardize error types to use a single suffix (e.g., always "Error").',
+                autoFixable: false,
+            });
+        }
+        return issues;
+    }
+    /**
+     * Check async pattern consistency
+     */
+    checkPatternConsistency(files) {
+        const issues = [];
+        const asyncPatterns = new Map();
+        for (const [file, content] of files) {
+            const ext = extname(file);
+            if (ext !== '.ts' && ext !== '.tsx' && ext !== '.js' && ext !== '.jsx')
+                continue;
+            // Check for mixed callback and async/await
+            const hasCallbacks = /\.then\s*\(/.test(content);
+            const hasAsyncAwait = /async\s+/.test(content);
+            if (hasCallbacks && hasAsyncAwait) {
+                const list = asyncPatterns.get('mixed') ?? [];
+                list.push(file);
+                asyncPatterns.set('mixed', list);
+            }
+        }
+        if (asyncPatterns.has('mixed') && (asyncPatterns.get('mixed')?.length ?? 0) > 2) {
+            issues.push({
+                type: 'pattern',
+                description: 'Mixed async patterns: both .then() callbacks and async/await used.',
+                files: asyncPatterns.get('mixed'),
+                suggestion: 'Prefer async/await consistently over .then() callbacks.',
+                autoFixable: false,
+            });
+        }
+        return issues;
+    }
+    /**
+     * Check architecture layer consistency
+     */
+    checkArchitectureConsistency(files) {
+        const issues = [];
+        for (const [file, content] of files) {
+            // Check if ViewModels import from data layer directly
+            if (file.includes('ViewModel') || file.includes('viewmodel') || file.includes('view-model')) {
+                if (content.includes('import') && (content.match(/from\s+['"].*(?:database|db|sql|prisma|mongoose|typeorm)/i) ||
+                    content.match(/from\s+['"].*(?:repository|repo)/i))) {
+                    issues.push({
+                        type: 'architecture',
+                        description: `ViewModel directly imports data layer in ${file}.`,
+                        files: [file],
+                        suggestion: 'ViewModels should access data through a service/use-case layer, not directly.',
+                        autoFixable: false,
+                    });
+                }
+            }
+            // Check if Views import from data layer
+            if (file.includes('View') || file.includes('Component') || file.includes('.vue') || file.includes('.svelte')) {
+                if (content.match(/from\s+['"].*(?:database|db|sql|prisma|mongoose|typeorm)/i)) {
+                    issues.push({
+                        type: 'architecture',
+                        description: `View/Component directly imports data layer in ${file}.`,
+                        files: [file],
+                        suggestion: 'Views should never access the data layer directly.',
+                        autoFixable: false,
+                    });
+                }
+            }
+        }
+        return issues;
+    }
+}
+//# sourceMappingURL=consistency.js.map

package/dist/quality/consistency.js.map

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

package/dist/quality/dual-verifier.d.ts

@@ -0,0 +1,22 @@
+/**
+ * PhantomMindAI — Dual-Model Verifier
+ * Verify critical outputs with a second model from a different provider.
+ */
+import type { ProviderRouter } from '../providers/router.js';
+import type { ContextEngine } from '../context/engine.js';
+import type { VerificationResult, PhantomConfig } from '../types.js';
+export declare class DualVerifier {
+    private router;
+    private contextEngine;
+    private config;
+    constructor(router: ProviderRouter, contextEngine: ContextEngine, config: PhantomConfig);
+    /**
+     * Verify generated content using a second model
+     */
+    verify(generatedContent: string, taskDescription: string, sourceFile?: string): Promise<VerificationResult>;
+    /**
+     * Parse the verification model's response
+     */
+    private parseVerificationResponse;
+}
+//# sourceMappingURL=dual-verifier.d.ts.map

package/dist/quality/dual-verifier.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dual-verifier.d.ts","sourceRoot":"","sources":["../../src/quality/dual-verifier.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAC7D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,KAAK,EAAE,kBAAkB,EAAyC,aAAa,EAAE,MAAM,aAAa,CAAC;AAE5G,qBAAa,YAAY;IACvB,OAAO,CAAC,MAAM,CAAiB;IAC/B,OAAO,CAAC,aAAa,CAAgB;IACrC,OAAO,CAAC,MAAM,CAAgB;gBAElB,MAAM,EAAE,cAAc,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,EAAE,aAAa;IAMvF;;OAEG;IACG,MAAM,CACV,gBAAgB,EAAE,MAAM,EACxB,eAAe,EAAE,MAAM,EACvB,UAAU,CAAC,EAAE,MAAM,GAClB,OAAO,CAAC,kBAAkB,CAAC;IAqG9B;;OAEG;IACH,OAAO,CAAC,yBAAyB;CAuBlC"}

package/dist/quality/dual-verifier.js

@@ -0,0 +1,137 @@
+/**
+ * PhantomMindAI — Dual-Model Verifier
+ * Verify critical outputs with a second model from a different provider.
+ */
+export class DualVerifier {
+    router;
+    contextEngine;
+    config;
+    constructor(router, contextEngine, config) {
+        this.router = router;
+        this.contextEngine = contextEngine;
+        this.config = config;
+    }
+    /**
+     * Verify generated content using a second model
+     */
+    async verify(generatedContent, taskDescription, sourceFile) {
+        const start = Date.now();
+        // Get project context for verification
+        const context = await this.contextEngine.getProjectContext({
+            file: sourceFile,
+            maxTokens: 2000,
+            includeSkills: true,
+            includeRules: true,
+        });
+        const contextText = context.layers.map(l => l.content).join('\n\n');
+        const verificationPrompt = `You are a code reviewer verifying AI-generated output against project conventions.
+
+## Project Context
+${contextText}
+
+## Task Description
+${taskDescription}
+
+## Generated Content
+\`\`\`
+${generatedContent}
+\`\`\`
+
+## Review Checklist
+1. Does this conform to the project conventions described above?
+2. Are there unhandled edge cases?
+3. Any security concerns (injection, auth bypass, data exposure)?
+4. Any performance concerns?
+5. Are there correctness issues?
+
+Respond in this exact JSON format:
+{
+  "approved": true/false,
+  "issues": [
+    {
+      "severity": "error|warning|info",
+      "category": "convention|security|edge-case|performance|correctness",
+      "description": "description of the issue",
+      "suggestion": "how to fix it",
+      "line": null
+    }
+  ]
+}
+
+Only respond with the JSON, no other text.`;
+        // Use the verification provider
+        const verificationProvider = this.config.quality.dualVerificationProvider ?? 'openai';
+        const provider = this.router.getProvider(verificationProvider) ?? this.router.getSlotProvider('fallback');
+        if (!provider) {
+            return {
+                approved: true,
+                provider: verificationProvider,
+                model: 'unavailable',
+                issues: [{
+                        severity: 'info',
+                        category: 'correctness',
+                        description: 'Verification provider not available. Skipped.',
+                    }],
+                duration: Date.now() - start,
+                cost: { inputTokens: 0, outputTokens: 0, totalTokens: 0, estimatedCost: 0 },
+            };
+        }
+        try {
+            const response = await provider.complete({
+                prompt: verificationPrompt,
+                temperature: 0.1,
+                maxTokens: 2000,
+            });
+            const parsed = this.parseVerificationResponse(response.content);
+            return {
+                approved: parsed.approved,
+                provider: verificationProvider,
+                model: response.model,
+                issues: parsed.issues,
+                duration: Date.now() - start,
+                cost: response.usage,
+            };
+        }
+        catch (error) {
+            return {
+                approved: true,
+                provider: verificationProvider,
+                model: 'error',
+                issues: [{
+                        severity: 'info',
+                        category: 'correctness',
+                        description: `Verification failed: ${error.message}`,
+                    }],
+                duration: Date.now() - start,
+                cost: { inputTokens: 0, outputTokens: 0, totalTokens: 0, estimatedCost: 0 },
+            };
+        }
+    }
+    /**
+     * Parse the verification model's response
+     */
+    parseVerificationResponse(content) {
+        try {
+            // Extract JSON from response
+            const jsonMatch = content.match(/\{[\s\S]*\}/);
+            if (!jsonMatch) {
+                return { approved: true, issues: [] };
+            }
+            const parsed = JSON.parse(jsonMatch[0]);
+            return {
+                approved: parsed.approved ?? true,
+                issues: (parsed.issues ?? []).map((issue) => ({
+                    severity: issue.severity ?? 'info',
+                    category: issue.category ?? 'correctness',
+                    description: issue.description ?? '',
+                    suggestion: issue.suggestion,
+                    line: issue.line,
+                })),
+            };
+        }
+        catch {
+            return { approved: true, issues: [] };
+        }
+    }
+}
+//# sourceMappingURL=dual-verifier.js.map

package/dist/quality/dual-verifier.js.map

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

package/dist/quality/hallucination-guard.d.ts

@@ -0,0 +1,57 @@
+/**
+ * PhantomMindAI — Hallucination Guard
+ * Pre-write check that detects when AI references non-existent entities.
+ */
+import type { HallucinationCheck } from '../types.js';
+export declare class HallucinationGuard {
+    private projectRoot;
+    private packageNames;
+    private projectFiles;
+    private projectTypes;
+    constructor(projectRoot: string);
+    /**
+     * Check content for hallucinations
+     */
+    check(content: string, fileName?: string): Promise<HallucinationCheck[]>;
+    /**
+     * Check import statements against actual dependencies
+     */
+    private checkImports;
+    /**
+     * Check file path references
+     */
+    private checkFilePaths;
+    /**
+     * Check type/class references in TypeScript
+     */
+    private checkTypeReferences;
+    /**
+     * Get all package names from package.json
+     */
+    private getPackageNames;
+    /**
+     * Get list of all project files
+     */
+    private getProjectFiles;
+    /**
+     * Check if a file path exists
+     */
+    private fileExists;
+    /**
+     * Check if a module is a Node.js built-in
+     */
+    private isNodeBuiltin;
+    /**
+     * Find similar strings using edit distance
+     */
+    private findSimilar;
+    /**
+     * Simple string similarity (Dice coefficient)
+     */
+    private similarity;
+    /**
+     * Clear cached data
+     */
+    clearCache(): void;
+}
+//# sourceMappingURL=hallucination-guard.d.ts.map

package/dist/quality/hallucination-guard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hallucination-guard.d.ts","sourceRoot":"","sources":["../../src/quality/hallucination-guard.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAEtD,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,YAAY,CAA4B;IAChD,OAAO,CAAC,YAAY,CAA4B;IAChD,OAAO,CAAC,YAAY,CAA4B;gBAEpC,WAAW,EAAE,MAAM;IAI/B;;OAEG;IACG,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,SAAY,GAAG,OAAO,CAAC,kBAAkB,EAAE,CAAC;IAuBjF;;OAEG;YACW,YAAY;IA4D1B;;OAEG;YACW,cAAc;IA8B5B;;OAEG;YACW,mBAAmB;IAKjC;;OAEG;YACW,eAAe;IAuB7B;;OAEG;YACW,eAAe;IAiB7B;;OAEG;YACW,UAAU;IASxB;;OAEG;IACH,OAAO,CAAC,aAAa;IAoBrB;;OAEG;IACH,OAAO,CAAC,WAAW;IASnB;;OAEG;IACH,OAAO,CAAC,UAAU;IAuBlB;;OAEG;IACH,UAAU,IAAI,IAAI;CAKnB"}

package/dist/quality/hallucination-guard.js

@@ -0,0 +1,245 @@
+/**
+ * PhantomMindAI — Hallucination Guard
+ * Pre-write check that detects when AI references non-existent entities.
+ */
+import { readFile, access } from 'node:fs/promises';
+import { join, extname } from 'node:path';
+import fastGlob from 'fast-glob';
+export class HallucinationGuard {
+    projectRoot;
+    packageNames = null;
+    projectFiles = null;
+    projectTypes = null;
+    constructor(projectRoot) {
+        this.projectRoot = projectRoot;
+    }
+    /**
+     * Check content for hallucinations
+     */
+    async check(content, fileName = 'unknown') {
+        const checks = [];
+        const lines = content.split('\n');
+        for (let i = 0; i < lines.length; i++) {
+            const line = lines[i];
+            // Check import statements
+            const importChecks = await this.checkImports(line, fileName, i + 1);
+            checks.push(...importChecks);
+            // Check file path references
+            const fileChecks = await this.checkFilePaths(line, fileName, i + 1);
+            checks.push(...fileChecks);
+            // Check type/class references
+            const typeChecks = await this.checkTypeReferences(line, fileName, i + 1);
+            checks.push(...typeChecks);
+        }
+        return checks.filter(c => !c.exists);
+    }
+    /**
+     * Check import statements against actual dependencies
+     */
+    async checkImports(line, file, lineNum) {
+        const checks = [];
+        // TypeScript/JavaScript imports
+        const tsImportMatch = line.match(/(?:import|from)\s+['"]([^'"./][^'"]*)['"]/);
+        if (tsImportMatch) {
+            const pkgName = tsImportMatch[1].startsWith('@')
+                ? tsImportMatch[1].split('/').slice(0, 2).join('/')
+                : tsImportMatch[1].split('/')[0];
+            const packages = await this.getPackageNames();
+            const exists = packages.has(pkgName) || this.isNodeBuiltin(pkgName);
+            checks.push({
+                type: 'import',
+                reference: pkgName,
+                exists,
+                suggestions: exists ? undefined : this.findSimilar(pkgName, [...packages]),
+                file,
+                line: lineNum,
+            });
+        }
+        // Swift imports
+        const swiftImportMatch = line.match(/^import\s+(\w+)/);
+        if (swiftImportMatch && !tsImportMatch) {
+            const module = swiftImportMatch[1];
+            const swiftBuiltins = new Set([
+                'Foundation', 'UIKit', 'SwiftUI', 'Combine', 'CoreData', 'MapKit',
+                'WebKit', 'AVFoundation', 'CoreLocation', 'StoreKit', 'WidgetKit',
+                'ActivityKit', 'SwiftData', 'Observation', 'XCTest', 'Testing',
+            ]);
+            checks.push({
+                type: 'import',
+                reference: module,
+                exists: swiftBuiltins.has(module),
+                suggestions: this.findSimilar(module, [...swiftBuiltins]),
+                file,
+                line: lineNum,
+            });
+        }
+        // Python imports
+        const pyImportMatch = line.match(/^(?:from|import)\s+([\w.]+)/);
+        if (pyImportMatch && !tsImportMatch && !swiftImportMatch) {
+            const module = pyImportMatch[1].split('.')[0];
+            // We can't fully validate Python imports without pip list, so mark as exists
+            checks.push({
+                type: 'import',
+                reference: module,
+                exists: true,
+                file,
+                line: lineNum,
+            });
+        }
+        return checks;
+    }
+    /**
+     * Check file path references
+     */
+    async checkFilePaths(line, file, lineNum) {
+        const checks = [];
+        // Match quoted file paths that look like relative paths
+        const pathMatches = line.matchAll(/['"](\.\/?[^'"]+\.(ts|js|tsx|jsx|swift|go|py|json|yaml|yml|md))['"]/g);
+        for (const match of pathMatches) {
+            const refPath = match[1];
+            const exists = await this.fileExists(refPath);
+            if (!exists) {
+                const projectFiles = await this.getProjectFiles();
+                const baseName = refPath.split('/').pop() ?? '';
+                const suggestions = [...projectFiles]
+                    .filter(f => f.includes(baseName.replace(extname(baseName), '')))
+                    .slice(0, 3);
+                checks.push({
+                    type: 'file',
+                    reference: refPath,
+                    exists: false,
+                    suggestions,
+                    file,
+                    line: lineNum,
+                });
+            }
+        }
+        return checks;
+    }
+    /**
+     * Check type/class references in TypeScript
+     */
+    async checkTypeReferences(line, file, lineNum) {
+        // Skip checking type references for performance — rely on TypeScript compiler
+        return [];
+    }
+    /**
+     * Get all package names from package.json
+     */
+    async getPackageNames() {
+        if (this.packageNames)
+            return this.packageNames;
+        this.packageNames = new Set();
+        try {
+            const pkgJson = await readFile(join(this.projectRoot, 'package.json'), 'utf-8');
+            const pkg = JSON.parse(pkgJson);
+            const deps = {
+                ...pkg.dependencies,
+                ...pkg.devDependencies,
+                ...pkg.peerDependencies,
+            };
+            for (const name of Object.keys(deps)) {
+                this.packageNames.add(name);
+            }
+        }
+        catch {
+            // No package.json
+        }
+        return this.packageNames;
+    }
+    /**
+     * Get list of all project files
+     */
+    async getProjectFiles() {
+        if (this.projectFiles)
+            return this.projectFiles;
+        try {
+            const files = await fastGlob('**/*', {
+                cwd: this.projectRoot,
+                ignore: ['node_modules/**', 'dist/**', '.git/**'],
+                onlyFiles: true,
+            });
+            this.projectFiles = new Set(files);
+        }
+        catch {
+            this.projectFiles = new Set();
+        }
+        return this.projectFiles;
+    }
+    /**
+     * Check if a file path exists
+     */
+    async fileExists(refPath) {
+        try {
+            await access(join(this.projectRoot, refPath));
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * Check if a module is a Node.js built-in
+     */
+    isNodeBuiltin(name) {
+        const builtins = new Set([
+            'assert', 'buffer', 'child_process', 'cluster', 'console', 'constants',
+            'crypto', 'dgram', 'dns', 'domain', 'events', 'fs', 'http', 'https',
+            'module', 'net', 'os', 'path', 'perf_hooks', 'process', 'punycode',
+            'querystring', 'readline', 'repl', 'stream', 'string_decoder', 'sys',
+            'timers', 'tls', 'tty', 'url', 'util', 'v8', 'vm', 'wasi',
+            'worker_threads', 'zlib',
+            'node:assert', 'node:buffer', 'node:child_process', 'node:cluster',
+            'node:crypto', 'node:dgram', 'node:dns', 'node:events', 'node:fs',
+            'node:http', 'node:https', 'node:module', 'node:net', 'node:os',
+            'node:path', 'node:perf_hooks', 'node:process', 'node:readline',
+            'node:stream', 'node:string_decoder', 'node:timers', 'node:tls',
+            'node:tty', 'node:url', 'node:util', 'node:v8', 'node:vm',
+            'node:worker_threads', 'node:zlib', 'node:test',
+        ]);
+        return builtins.has(name) || name.startsWith('node:');
+    }
+    /**
+     * Find similar strings using edit distance
+     */
+    findSimilar(target, candidates, maxResults = 3) {
+        const scored = candidates
+            .map(c => ({ name: c, score: this.similarity(target, c) }))
+            .filter(c => c.score > 0.3)
+            .sort((a, b) => b.score - a.score);
+        return scored.slice(0, maxResults).map(s => s.name);
+    }
+    /**
+     * Simple string similarity (Dice coefficient)
+     */
+    similarity(a, b) {
+        if (a === b)
+            return 1;
+        if (a.length < 2 || b.length < 2)
+            return 0;
+        const aBigrams = new Map();
+        for (let i = 0; i < a.length - 1; i++) {
+            const bigram = a.slice(i, i + 2).toLowerCase();
+            aBigrams.set(bigram, (aBigrams.get(bigram) ?? 0) + 1);
+        }
+        let matches = 0;
+        for (let i = 0; i < b.length - 1; i++) {
+            const bigram = b.slice(i, i + 2).toLowerCase();
+            const count = aBigrams.get(bigram) ?? 0;
+            if (count > 0) {
+                aBigrams.set(bigram, count - 1);
+                matches++;
+            }
+        }
+        return (2 * matches) / (a.length + b.length - 2);
+    }
+    /**
+     * Clear cached data
+     */
+    clearCache() {
+        this.packageNames = null;
+        this.projectFiles = null;
+        this.projectTypes = null;
+    }
+}
+//# sourceMappingURL=hallucination-guard.js.map