codeguardian-mcp 1.0.0

package/dist/analyzers/parsers/incrementalParser.js.map

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

package/dist/analyzers/parsers/scopeResolver.d.ts

@@ -0,0 +1,92 @@
+/**
+ * Context-Aware Scope Resolution
+ *
+ * Accurately resolves symbols considering scope hierarchy, imports, and context.
+ * Critical for detecting hallucinations in AI-generated code.
+ *
+ * @format
+ */
+import { CodeGraph, SymbolNode, Reference, Scope, SemanticIndex } from "../../types/codeGraph.js";
+export declare class ScopeResolver {
+    private graph;
+    private index?;
+    constructor(graph: CodeGraph, index?: SemanticIndex | undefined);
+    /**
+     * Resolve symbol in given scope with full context awareness
+     */
+    resolveSymbol(name: string, currentScope: Scope): SymbolNode | null;
+    /**
+     * Resolve method call on an object
+     */
+    resolveMethodCall(objectName: string, methodName: string, scope: Scope): SymbolNode | null;
+    /**
+     * Resolve property access
+     */
+    resolvePropertyAccess(objectName: string, propertyName: string, scope: Scope): SymbolNode | null;
+    /**
+     * Resolve import
+     */
+    private resolveImport;
+    /**
+     * Get symbol type information
+     */
+    private getSymbolType;
+    /**
+     * Find scope by name
+     */
+    private findScopeByName;
+    /**
+     * Resolve all references in a scope
+     */
+    resolveAllReferences(scope: Scope): Map<Reference, SymbolNode | null>;
+    /**
+     * Check if a reference is valid in given scope
+     */
+    isValidReference(ref: Reference, scope: Scope): boolean;
+    /**
+     * Find unresolved references in scope
+     */
+    findUnresolvedReferences(scope: Scope): Reference[];
+    /**
+     * Get scope chain (for debugging)
+     */
+    getScopeChain(scope: Scope): string[];
+    /**
+     * Find symbol with full qualification
+     */
+    resolveQualifiedName(qualifiedName: string, scope: Scope): SymbolNode | null;
+}
+/**
+ * Scope analysis utilities
+ */
+export declare class ScopeAnalyzer {
+    /**
+     * Analyze scope complexity
+     */
+    static analyzeScopeComplexity(scope: Scope): {
+        depth: number;
+        symbolCount: number;
+        childCount: number;
+        totalDescendants: number;
+    };
+    /**
+     * Get scope depth in hierarchy
+     */
+    private static getScopeDepth;
+    /**
+     * Count all descendant scopes
+     */
+    private static countDescendants;
+    /**
+     * Find all symbols in scope and descendants
+     */
+    static getAllSymbols(scope: Scope): SymbolNode[];
+    /**
+     * Check for shadowed variables
+     */
+    static findShadowedSymbols(scope: Scope): Array<{
+        symbol: SymbolNode;
+        shadowedBy: SymbolNode;
+    }>;
+}
+//# sourceMappingURL=scopeResolver.d.ts.map

package/dist/analyzers/parsers/scopeResolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scopeResolver.d.ts","sourceRoot":"","sources":["../../../src/analyzers/parsers/scopeResolver.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EACL,SAAS,EACT,UAAU,EACV,SAAS,EACT,KAAK,EACL,aAAa,EACd,MAAM,0BAA0B,CAAC;AAGlC,qBAAa,aAAa;IAEtB,OAAO,CAAC,KAAK;IACb,OAAO,CAAC,KAAK,CAAC;gBADN,KAAK,EAAE,SAAS,EAChB,KAAK,CAAC,EAAE,aAAa,YAAA;IAG/B;;OAEG;IACH,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,YAAY,EAAE,KAAK,GAAG,UAAU,GAAG,IAAI;IAgCnE;;OAEG;IACH,iBAAiB,CACf,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,KAAK,GACX,UAAU,GAAG,IAAI;IAyCpB;;OAEG;IACH,qBAAqB,CACnB,UAAU,EAAE,MAAM,EAClB,YAAY,EAAE,MAAM,EACpB,KAAK,EAAE,KAAK,GACX,UAAU,GAAG,IAAI;IAuBpB;;OAEG;IACH,OAAO,CAAC,aAAa;IAsBrB;;OAEG;IACH,OAAO,CAAC,aAAa;IAUrB;;OAEG;IACH,OAAO,CAAC,eAAe;IASvB;;OAEG;IACH,oBAAoB,CAAC,KAAK,EAAE,KAAK,GAAG,GAAG,CAAC,SAAS,EAAE,UAAU,GAAG,IAAI,CAAC;IAerE;;OAEG;IACH,gBAAgB,CAAC,GAAG,EAAE,SAAS,EAAE,KAAK,EAAE,KAAK,GAAG,OAAO;IAKvD;;OAEG;IACH,wBAAwB,CAAC,KAAK,EAAE,KAAK,GAAG,SAAS,EAAE;IAiBnD;;OAEG;IACH,aAAa,CAAC,KAAK,EAAE,KAAK,GAAG,MAAM,EAAE;IAYrC;;OAEG;IACH,oBAAoB,CAAC,aAAa,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,GAAG,UAAU,GAAG,IAAI;CAyC7E;AAED;;GAEG;AACH,qBAAa,aAAa;IACxB;;OAEG;IACH,MAAM,CAAC,sBAAsB,CAAC,KAAK,EAAE,KAAK,GAAG;QAC3C,KAAK,EAAE,MAAM,CAAC;QACd,WAAW,EAAE,MAAM,CAAC;QACpB,UAAU,EAAE,MAAM,CAAC;QACnB,gBAAgB,EAAE,MAAM,CAAC;KAC1B;IASD;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,aAAa;IAY5B;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,gBAAgB;IAU/B;;OAEG;IACH,MAAM,CAAC,aAAa,CAAC,KAAK,EAAE,KAAK,GAAG,UAAU,EAAE;IAUhD;;OAEG;IACH,MAAM,CAAC,mBAAmB,CAAC,KAAK,EAAE,KAAK,GAAG,KAAK,CAAC;QAC9C,MAAM,EAAE,UAAU,CAAC;QACnB,UAAU,EAAE,UAAU,CAAC;KACxB,CAAC;CA2BH"}

package/dist/analyzers/parsers/scopeResolver.js

@@ -0,0 +1,324 @@
+/**
+ * Context-Aware Scope Resolution
+ *
+ * Accurately resolves symbols considering scope hierarchy, imports, and context.
+ * Critical for detecting hallucinations in AI-generated code.
+ *
+ * @format
+ */
+import { logger } from "../../utils/logger.js";
+export class ScopeResolver {
+    graph;
+    index;
+    constructor(graph, index) {
+        this.graph = graph;
+        this.index = index;
+    }
+    /**
+     * Resolve symbol in given scope with full context awareness
+     */
+    resolveSymbol(name, currentScope) {
+        // 1. Check local scope first
+        let scope = currentScope;
+        while (scope) {
+            const symbol = scope.symbols.get(name);
+            if (symbol) {
+                logger.debug(`Resolved '${name}' in scope '${scope.name}'`);
+                return symbol;
+            }
+            scope = scope.parent;
+        }
+        // 2. Check imports in current file
+        if (currentScope.location) {
+            const imported = this.resolveImport(name, currentScope.location.file);
+            if (imported) {
+                logger.debug(`Resolved '${name}' from imports`);
+                return imported;
+            }
+        }
+        // 3. Check global scope
+        const globalSymbol = this.graph.globalScope.symbols.get(name);
+        if (globalSymbol) {
+            logger.debug(`Resolved '${name}' in global scope`);
+            return globalSymbol;
+        }
+        logger.debug(`Could not resolve '${name}'`);
+        return null; // Symbol doesn't exist - HALLUCINATION!
+    }
+    /**
+     * Resolve method call on an object
+     */
+    resolveMethodCall(objectName, methodName, scope) {
+        // 1. Resolve the object
+        const objectSymbol = this.resolveSymbol(objectName, scope);
+        if (!objectSymbol) {
+            logger.debug(`Object '${objectName}' not found`);
+            return null;
+        }
+        // 2. Get object's type
+        const type = this.getSymbolType(objectSymbol);
+        if (!type) {
+            logger.debug(`Could not determine type of '${objectName}'`);
+            return null;
+        }
+        // 3. Check if type has this method
+        if (objectSymbol.methods && objectSymbol.methods.has(methodName)) {
+            const method = objectSymbol.methods.get(methodName);
+            logger.debug(`Resolved method '${methodName}' on '${objectName}'`);
+            return method || null;
+        }
+        // 4. Check class definition for methods
+        if (objectSymbol.type === "class") {
+            // Look for method in class scope
+            const classScope = this.findScopeByName(objectSymbol.name);
+            if (classScope) {
+                const method = classScope.symbols.get(methodName);
+                if (method && method.type === "method") {
+                    logger.debug(`Resolved method '${methodName}' in class '${objectName}'`);
+                    return method;
+                }
+            }
+        }
+        logger.debug(`Method '${methodName}' not found on '${objectName}'`);
+        return null; // Method doesn't exist - HALLUCINATION!
+    }
+    /**
+     * Resolve property access
+     */
+    resolvePropertyAccess(objectName, propertyName, scope) {
+        const objectSymbol = this.resolveSymbol(objectName, scope);
+        if (!objectSymbol)
+            return null;
+        // Check properties
+        if (objectSymbol.properties && objectSymbol.properties.has(propertyName)) {
+            return objectSymbol.properties.get(propertyName) || null;
+        }
+        // Check class fields
+        if (objectSymbol.type === "class") {
+            const classScope = this.findScopeByName(objectSymbol.name);
+            if (classScope) {
+                const property = classScope.symbols.get(propertyName);
+                if (property && property.type === "property") {
+                    return property;
+                }
+            }
+        }
+        return null;
+    }
+    /**
+     * Resolve import
+     */
+    resolveImport(name, filePath) {
+        const importNode = this.graph.imports.get(filePath);
+        if (!importNode)
+            return null;
+        // Check if name is imported
+        for (const imported of importNode.names) {
+            if (imported.local === name) {
+                // Create symbol for imported name
+                return {
+                    name: imported.local,
+                    type: "variable", // Could be function, class, etc.
+                    location: importNode.location,
+                    usages: [],
+                    definedIn: "external",
+                    documentation: `Imported from ${importNode.module}`,
+                };
+            }
+        }
+        return null;
+    }
+    /**
+     * Get symbol type information
+     */
+    getSymbolType(symbol) {
+        // If symbol has explicit type
+        if (symbol.returnType) {
+            return symbol.returnType;
+        }
+        // Use symbol's declared type
+        return symbol.type;
+    }
+    /**
+     * Find scope by name
+     */
+    findScopeByName(name) {
+        for (const scope of this.graph.scopes.values()) {
+            if (scope.name === name) {
+                return scope;
+            }
+        }
+        return null;
+    }
+    /**
+     * Resolve all references in a scope
+     */
+    resolveAllReferences(scope) {
+        const resolutions = new Map();
+        for (const refs of this.graph.references.values()) {
+            for (const ref of refs) {
+                if (ref.scope === scope.name) {
+                    const resolved = this.resolveSymbol(ref.name, scope);
+                    resolutions.set(ref, resolved);
+                }
+            }
+        }
+        return resolutions;
+    }
+    /**
+     * Check if a reference is valid in given scope
+     */
+    isValidReference(ref, scope) {
+        const resolved = this.resolveSymbol(ref.name, scope);
+        return resolved !== null;
+    }
+    /**
+     * Find unresolved references in scope
+     */
+    findUnresolvedReferences(scope) {
+        const unresolved = [];
+        for (const refs of this.graph.references.values()) {
+            for (const ref of refs) {
+                if (ref.scope === scope.name) {
+                    const resolved = this.resolveSymbol(ref.name, scope);
+                    if (!resolved) {
+                        unresolved.push(ref);
+                    }
+                }
+            }
+        }
+        return unresolved;
+    }
+    /**
+     * Get scope chain (for debugging)
+     */
+    getScopeChain(scope) {
+        const chain = [];
+        let current = scope;
+        while (current) {
+            chain.unshift(current.name);
+            current = current.parent;
+        }
+        return chain;
+    }
+    /**
+     * Find symbol with full qualification
+     */
+    resolveQualifiedName(qualifiedName, scope) {
+        const parts = qualifiedName.split(".");
+        if (parts.length === 1) {
+            return this.resolveSymbol(qualifiedName, scope);
+        }
+        // Resolve first part
+        let current = this.resolveSymbol(parts[0], scope);
+        if (!current)
+            return null;
+        // Resolve remaining parts
+        for (let i = 1; i < parts.length; i++) {
+            const part = parts[i];
+            // Check if it's a method
+            if (current.methods && current.methods.has(part)) {
+                current = current.methods.get(part) || null;
+                if (!current)
+                    return null;
+            }
+            // Check if it's a property
+            else if (current.properties && current.properties.has(part)) {
+                current = current.properties.get(part) || null;
+                if (!current)
+                    return null;
+            }
+            // Try to find in class scope
+            else if (current.type === "class") {
+                const classScope = this.findScopeByName(current.name);
+                if (classScope) {
+                    current = classScope.symbols.get(part) || null;
+                    if (!current)
+                        return null;
+                }
+                else {
+                    return null;
+                }
+            }
+            else {
+                return null;
+            }
+        }
+        return current;
+    }
+}
+/**
+ * Scope analysis utilities
+ */
+export class ScopeAnalyzer {
+    /**
+     * Analyze scope complexity
+     */
+    static analyzeScopeComplexity(scope) {
+        const depth = this.getScopeDepth(scope);
+        const symbolCount = scope.symbols.size;
+        const childCount = scope.children.length;
+        const totalDescendants = this.countDescendants(scope);
+        return { depth, symbolCount, childCount, totalDescendants };
+    }
+    /**
+     * Get scope depth in hierarchy
+     */
+    static getScopeDepth(scope) {
+        let depth = 0;
+        let current = scope;
+        while (current.parent) {
+            depth++;
+            current = current.parent;
+        }
+        return depth;
+    }
+    /**
+     * Count all descendant scopes
+     */
+    static countDescendants(scope) {
+        let count = scope.children.length;
+        for (const child of scope.children) {
+            count += this.countDescendants(child);
+        }
+        return count;
+    }
+    /**
+     * Find all symbols in scope and descendants
+     */
+    static getAllSymbols(scope) {
+        const symbols = Array.from(scope.symbols.values());
+        for (const child of scope.children) {
+            symbols.push(...this.getAllSymbols(child));
+        }
+        return symbols;
+    }
+    /**
+     * Check for shadowed variables
+     */
+    static findShadowedSymbols(scope) {
+        const shadowed = [];
+        // Check each symbol in this scope
+        for (const [name, symbol] of scope.symbols) {
+            // Check if parent scopes have same name
+            let parent = scope.parent;
+            while (parent) {
+                const parentSymbol = parent.symbols.get(name);
+                if (parentSymbol) {
+                    shadowed.push({
+                        symbol: parentSymbol,
+                        shadowedBy: symbol,
+                    });
+                    break;
+                }
+                parent = parent.parent;
+            }
+        }
+        // Recursively check children
+        for (const child of scope.children) {
+            shadowed.push(...this.findShadowedSymbols(child));
+        }
+        return shadowed;
+    }
+}
+//# sourceMappingURL=scopeResolver.js.map

package/dist/analyzers/parsers/scopeResolver.js.map

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

package/dist/analyzers/parsers/semanticIndex.d.ts

@@ -0,0 +1,127 @@
+/**
+ * Semantic Index for O(1) Symbol Lookups
+ *
+ * Pre-computed indexes for fast symbol resolution and queries.
+ * Enables instant lookups without traversing the entire graph.
+ *
+ * @format
+ */
+import { CodeGraph, SemanticIndex, SymbolNode, SymbolType, Reference, Scope } from "../../types/codeGraph.js";
+export declare class SemanticIndexBuilder {
+    /**
+     * Build complete semantic index from CodeGraph
+     */
+    static buildIndex(graph: CodeGraph): SemanticIndex;
+    /**
+     * Update index incrementally (for changed files)
+     */
+    static updateIndex(index: SemanticIndex, graph: CodeGraph, changedFiles: string[]): SemanticIndex;
+    /**
+     * Find symbol by name with scope resolution
+     */
+    static findSymbol(name: string, index: SemanticIndex, scope?: string, file?: string): SymbolNode | null;
+    /**
+     * Find all references to a symbol
+     */
+    static findReferences(name: string, index: SemanticIndex): Reference[];
+    /**
+     * Find unused symbols
+     */
+    static findUnusedSymbols(index: SemanticIndex): SymbolNode[];
+    /**
+     * Find symbols by type
+     */
+    static findSymbolsByType(type: SymbolType, index: SemanticIndex): SymbolNode[];
+    /**
+     * Find symbols in file
+     */
+    static findSymbolsInFile(file: string, index: SemanticIndex): SymbolNode[];
+    /**
+     * Check if symbol exists
+     */
+    static symbolExists(name: string, index: SemanticIndex): boolean;
+    /**
+     * Get symbol statistics
+     */
+    static getStatistics(index: SemanticIndex): {
+        totalSymbols: number;
+        symbolsByType: Record<SymbolType, number>;
+        unusedCount: number;
+        unresolvedCount: number;
+    };
+    /**
+     * Resolve reference to its symbol definition
+     */
+    private static resolveReference;
+    /**
+     * Resolve symbol in scope hierarchy
+     */
+    private static resolveInScope;
+}
+/**
+ * Query helper for semantic index
+ */
+export declare class SemanticQuery {
+    private index;
+    private graph;
+    constructor(index: SemanticIndex, graph: CodeGraph);
+    /**
+     * Find symbol with context
+     */
+    findSymbol(name: string, context?: {
+        file?: string;
+        scope?: string;
+    }): SymbolNode | null;
+    /**
+     * Find all usages of a symbol
+     */
+    findUsages(symbolName: string): Reference[];
+    /**
+     * Check if reference is valid
+     */
+    isValidReference(ref: Reference): boolean;
+    /**
+     * Find dead code (unused and not exported)
+     */
+    findDeadCode(): SymbolNode[];
+    /**
+     * Find all functions that call a given function
+     */
+    findCallers(functionName: string): string[];
+    /**
+     * Find all functions called by a given function
+     */
+    findCallees(functionName: string): string[];
+    /**
+     * Find symbols matching pattern
+     */
+    findByPattern(pattern: RegExp, type?: SymbolType): SymbolNode[];
+    /**
+     * Get symbol with all its relationships
+     */
+    getSymbolWithRelationships(name: string): {
+        symbol: SymbolNode | null;
+        usages: Reference[];
+        callers: string[];
+        callees: string[];
+        scope: Scope | null;
+    };
+    /**
+     * Find similar symbol names (for suggestions)
+     */
+    findSimilar(name: string, maxDistance?: number): SymbolNode[];
+    /**
+     * Calculate Levenshtein distance for fuzzy matching
+     */
+    private levenshteinDistance;
+    /**
+     * Get index statistics
+     */
+    getStatistics(): {
+        totalSymbols: number;
+        symbolsByType: Record<SymbolType, number>;
+        unusedCount: number;
+        unresolvedCount: number;
+    };
+}
+//# sourceMappingURL=semanticIndex.d.ts.map

package/dist/analyzers/parsers/semanticIndex.d.ts.map

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