codeguardian-mcp 1.0.0

package/dist/tools/validation/scoring.js

@@ -0,0 +1,242 @@
+/**
+ * Scoring and Fuzzy Matching Module
+ *
+ * This module provides scoring algorithms and fuzzy matching for generating
+ * suggestions and recommendations in the validation system.
+ *
+ * Responsibilities:
+ * - Calculate overall code quality scores (0-100) based on issue severity
+ * - Generate actionable recommendations (REJECT, REVIEW, CAUTION, ACCEPT, CLEAN_UP)
+ * - Implement Jaro-Winkler similarity for fuzzy string matching
+ * - Suggest similar symbols using multiple matching strategies
+ * - Detect structural similarity (camelCase, snake_case patterns)
+ * - Extract symbol names from suggestion strings
+ *
+ * @format
+ */
+// ============================================================================
+// Improved Fuzzy Matching for Suggestions
+// ============================================================================
+/**
+ * Calculate Jaro-Winkler similarity between two strings.
+ * Returns a value between 0 and 1, where 1 is an exact match.
+ * Better than Levenshtein for typo detection.
+ */
+export function jaroWinklerSimilarity(s1, s2) {
+    if (s1 === s2)
+        return 1;
+    if (s1.length === 0 || s2.length === 0)
+        return 0;
+    const matchWindow = Math.floor(Math.max(s1.length, s2.length) / 2) - 1;
+    const s1Matches = new Array(s1.length).fill(false);
+    const s2Matches = new Array(s2.length).fill(false);
+    let matches = 0;
+    let transpositions = 0;
+    // Find matches
+    for (let i = 0; i < s1.length; i++) {
+        const start = Math.max(0, i - matchWindow);
+        const end = Math.min(i + matchWindow + 1, s2.length);
+        for (let j = start; j < end; j++) {
+            if (s2Matches[j] || s1[i] !== s2[j])
+                continue;
+            s1Matches[i] = true;
+            s2Matches[j] = true;
+            matches++;
+            break;
+        }
+    }
+    if (matches === 0)
+        return 0;
+    // Count transpositions
+    let k = 0;
+    for (let i = 0; i < s1.length; i++) {
+        if (!s1Matches[i])
+            continue;
+        while (!s2Matches[k])
+            k++;
+        if (s1[i] !== s2[k])
+            transpositions++;
+        k++;
+    }
+    const jaro = (matches / s1.length +
+        matches / s2.length +
+        (matches - transpositions / 2) / matches) /
+        3;
+    // Calculate common prefix (up to 4 chars)
+    let prefix = 0;
+    for (let i = 0; i < Math.min(4, s1.length, s2.length); i++) {
+        if (s1[i] === s2[i])
+            prefix++;
+        else
+            break;
+    }
+    // Jaro-Winkler adjustment
+    return jaro + prefix * 0.1 * (1 - jaro);
+}
+/**
+ * Check if two strings have similar structure (camelCase, snake_case patterns).
+ */
+export function hasSimilarStructure(s1, s2) {
+    // Extract word parts from camelCase or snake_case
+    const extractParts = (s) => {
+        return s
+            .replace(/([a-z])([A-Z])/g, "$1_$2")
+            .toLowerCase()
+            .split(/[_-]/)
+            .filter((p) => p.length > 0);
+    };
+    const parts1 = extractParts(s1);
+    const parts2 = extractParts(s2);
+    // Check if they share significant word parts
+    const shared = parts1.filter((p) => parts2.some((p2) => p === p2 || p.includes(p2) || p2.includes(p)));
+    return shared.length > 0;
+}
+/**
+ * Calculate common prefix length between two strings.
+ */
+function commonPrefixLength(s1, s2) {
+    let i = 0;
+    while (i < s1.length && i < s2.length && s1[i] === s2[i]) {
+        i++;
+    }
+    return i;
+}
+/**
+ * Suggest similar symbols using multiple matching strategies.
+ * Combines Jaro-Winkler similarity, substring matching, and structural similarity.
+ */
+export function suggestSimilar(target, available) {
+    if (available.length === 0) {
+        return "No similar symbols found. This may be a hallucination.";
+    }
+    const targetLower = target.toLowerCase();
+    // Score each available symbol
+    const scored = available.map((name) => {
+        const nameLower = name.toLowerCase();
+        let score = 0;
+        // Jaro-Winkler similarity (0-1, weighted heavily)
+        const jwScore = jaroWinklerSimilarity(targetLower, nameLower);
+        score += jwScore * 50;
+        // Substring matching
+        if (nameLower.includes(targetLower) || targetLower.includes(nameLower)) {
+            score += 30;
+        }
+        // Structural similarity (shared word parts)
+        if (hasSimilarStructure(target, name)) {
+            score += 20;
+        }
+        // Prefix matching bonus
+        const prefixLen = commonPrefixLength(targetLower, nameLower);
+        score += prefixLen * 5;
+        // Same length bonus (typos often preserve length)
+        if (target.length === name.length) {
+            score += 10;
+        }
+        return { name, score };
+    });
+    // Sort by score descending and take top 3
+    const topMatches = scored
+        .filter((s) => s.score > 25) // Minimum threshold
+        .sort((a, b) => b.score - a.score)
+        .slice(0, 3)
+        .map((s) => s.name);
+    if (topMatches.length > 0) {
+        return `Did you mean: ${topMatches.join(", ")}?`;
+    }
+    return "No similar symbols found. This may be a hallucination.";
+}
+/**
+ * Extract similar symbol names from a suggestion string
+ */
+export function extractSimilarSymbols(suggestion) {
+    // Extract symbols from "Did you mean: symbol1, symbol2?" format
+    const match = suggestion.match(/Did you mean: ([^?]+)\?/);
+    if (match) {
+        return match[1].split(",").map((s) => s.trim());
+    }
+    return [];
+}
+// ============================================================================
+// Scoring and Recommendations
+// ============================================================================
+/**
+ * Calculate overall code quality score (0-100) based on issue severity
+ */
+export function calculateScore(issues, deadCode = []) {
+    if (issues.length === 0 && deadCode.length === 0)
+        return 100;
+    const weights = { critical: 25, high: 15, medium: 8, low: 3, warning: 3 };
+    let deductions = 0;
+    for (const issue of issues) {
+        deductions += weights[issue.severity] || 5;
+    }
+    for (const dc of deadCode) {
+        deductions += dc.severity === "medium" ? 5 : 2;
+    }
+    return Math.max(0, 100 - deductions);
+}
+/**
+ * Generate actionable recommendation based on score and issues
+ */
+export function generateRecommendation(score, issues, deadCode = []) {
+    const critical = issues.filter((i) => i.severity === "critical");
+    const high = issues.filter((i) => i.severity === "high");
+    const depHallucinations = issues.filter((i) => i.type === "dependencyHallucination");
+    if (depHallucinations.length > 0) {
+        return {
+            verdict: "REJECT",
+            riskLevel: "critical",
+            message: `❌ MISSING DEPENDENCIES - ${depHallucinations.length} package(s) not in manifest`,
+            action: "Install missing packages before using this code",
+        };
+    }
+    const architectureIssues = issues.filter(i => i.type === "architecturalDeviation");
+    const semanticBridgeIssues = architectureIssues.filter(i => i.message.includes("impact"));
+    if (semanticBridgeIssues.length > 0) {
+        return {
+            verdict: "CAUTION",
+            riskLevel: "high",
+            message: `🌉 SEMANTIC BRIDGE ALERT - High cross-language impact detected`,
+            action: "Review downstream consumers in the other language before proceeding",
+        };
+    }
+    if (critical.length > 0) {
+        return {
+            verdict: "REJECT",
+            riskLevel: "critical",
+            message: `❌ DO NOT USE - ${critical.length} hallucination(s): references to non-existent code`,
+            action: "Fix all critical issues before using this code",
+        };
+    }
+    if (high.length > 2) {
+        return {
+            verdict: "REVIEW",
+            riskLevel: "high",
+            message: `⚠️ HIGH RISK - ${issues.length} hallucination(s) found`,
+            action: "Manually verify each flagged symbol exists in your codebase",
+        };
+    }
+    if (issues.length > 0) {
+        return {
+            verdict: "CAUTION",
+            riskLevel: "medium",
+            message: `⚡ ${issues.length} potential hallucination(s) detected`,
+            action: "Verify flagged symbols exist in your codebase",
+        };
+    }
+    if (deadCode.length > 0) {
+        return {
+            verdict: "CLEAN_UP",
+            riskLevel: "low",
+            message: `🧹 ${deadCode.length} dead code issue(s) - unused exports/files`,
+            action: "Consider removing unused code to reduce maintenance burden",
+        };
+    }
+    return {
+        verdict: "ACCEPT",
+        riskLevel: "low",
+        message: "✅ LOOKS GOOD - No hallucinations or dead code detected",
+        action: "Code appears consistent with your project",
+    };
+}
+//# sourceMappingURL=scoring.js.map

package/dist/tools/validation/scoring.js.map

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

package/dist/tools/validation/types.d.ts

@@ -0,0 +1,120 @@
+/**
+ * Shared Type Definitions for Validation System
+ *
+ * This module contains all shared interfaces used across the validation system.
+ * These types define the data structures for AST extraction, validation results,
+ * and project analysis.
+ *
+ * @format
+ */
+/**
+ * Represents a symbol definition found in code (function, class, method, etc.)
+ */
+export interface ASTSymbol {
+    name: string;
+    type: "function" | "class" | "method" | "variable" | "import" | "decorator" | "interface" | "type" | "route";
+    file: string;
+    line: number;
+    column: number;
+    params?: string[];
+    paramCount?: number;
+    returnType?: string;
+    scope?: string;
+    isAsync?: boolean;
+    isExported?: boolean;
+    decorators?: string[];
+}
+/**
+ * Represents a symbol usage in code (function call, method call, etc.)
+ */
+export interface ASTUsage {
+    name: string;
+    type: "call" | "methodCall" | "instantiation" | "attribute" | "reference" | "apiCall";
+    object?: string;
+    line: number;
+    column: number;
+    code: string;
+    argCount?: number;
+    isExternal?: boolean;
+}
+/**
+ * Represents an import statement in code
+ */
+export interface ASTImport {
+    module: string;
+    names: Array<{
+        imported: string;
+        local: string;
+    }>;
+    isExternal: boolean;
+    line: number;
+    isTypeOnly?: boolean;
+}
+/**
+ * Represents a type reference found in code
+ * Used for detecting same-file type usage (not just imports)
+ */
+export interface ASTTypeReference {
+    name: string;
+    context: "typeAnnotation" | "genericParam" | "extends" | "implements" | "returnType" | "propertyType";
+    line: number;
+}
+export type IssueSeverity = "critical" | "high" | "medium" | "low" | "warning";
+/**
+ * Represents a validation issue found in code (hallucination, wrong param count, etc.)
+ */
+export interface ValidationIssue {
+    type: "nonExistentFunction" | "nonExistentClass" | "nonExistentMethod" | "wrongParamCount" | "nonExistentImport" | "dependencyHallucination" | "undefinedVariable" | "unusedImport" | "typeOnlyImportMisuse" | "architecturalDeviation" | "missingDependency";
+    severity: IssueSeverity;
+    message: string;
+    line: number;
+    file: string;
+    code: string;
+    suggestion: string;
+    confidence?: number;
+    reasoning?: string;
+}
+/**
+ * Represents a dead code issue (unused export, orphaned file, etc.)
+ */
+export interface DeadCodeIssue {
+    type: "unusedExport" | "orphanedFile" | "unusedFunction";
+    severity: "medium" | "low" | "warning";
+    name: string;
+    file: string;
+    message: string;
+    line?: number;
+    suggestion?: string;
+}
+/**
+ * Represents a symbol in the project symbol table
+ * Used for validation and dead code detection
+ */
+export interface ProjectSymbol {
+    name: string;
+    type: "function" | "class" | "method" | "variable" | "import" | "decorator";
+    file: string;
+    line?: number;
+    params?: string[];
+    paramCount?: number;
+    scope?: string;
+    isAsync?: boolean;
+    decorators?: string[];
+}
+/**
+ * Represents dependencies loaded from manifest files
+ * (package.json, requirements.txt, pyproject.toml)
+ */
+export interface ManifestDependencies {
+    dependencies: Set<string>;
+    devDependencies: Set<string>;
+    all: Set<string>;
+}
+/**
+ * Represents the current user session context (Augment Secret #3)
+ */
+export interface SessionContext {
+    recentlyEditedFiles: string[];
+    activeBranch?: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/tools/validation/types.d.ts.map

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

package/dist/tools/validation/types.js

@@ -0,0 +1,11 @@
+/**
+ * Shared Type Definitions for Validation System
+ *
+ * This module contains all shared interfaces used across the validation system.
+ * These types define the data structures for AST extraction, validation results,
+ * and project analysis.
+ *
+ * @format
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/tools/validation/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/tools/validation/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG"}

package/dist/tools/validation/unusedLocals.d.ts

@@ -0,0 +1,36 @@
+/**
+ * AST-Based Unused Local Detection
+ *
+ * This module provides superior dead code detection using AST parsing instead of regex.
+ * It properly handles:
+ * - All naming conventions (camelCase, PascalCase, UPPER_SNAKE_CASE)
+ * - Both JavaScript/TypeScript AND Python
+ * - Exported vs non-exported symbols
+ * - Local function declarations, const/let/var, and Python def
+ * - React hooks and framework patterns
+ *
+ * @format
+ */
+import type { DeadCodeIssue } from "./types.js";
+/**
+ * Detect unused local functions and variables within a single file using AST parsing.
+ * This is the AST-based replacement for the regex-based detectUnusedLocals.
+ *
+ * Advantages over regex approach:
+ * - Handles all naming conventions (camelCase, PascalCase, UPPER_SNAKE_CASE)
+ * - Properly distinguishes exported vs non-exported symbols
+ * - Accurate line numbers from AST
+ * - Works for both JS/TS and Python with proper language support
+ * - Understands scope (won't flag parameters as unused when they're used in function body)
+ *
+ * @param code - The source code string to analyze
+ * @param filePath - Path to the file (used to determine language from extension)
+ * @returns Array of dead code issues found
+ */
+export declare function detectUnusedLocalsAST(code: string, filePath: string): DeadCodeIssue[];
+/**
+ * Backwards-compatible wrapper that uses AST-based detection
+ * This replaces the old regex-based detectUnusedLocals
+ */
+export declare function detectUnusedLocals(code: string, filePath: string): DeadCodeIssue[];
+//# sourceMappingURL=unusedLocals.d.ts.map

package/dist/tools/validation/unusedLocals.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"unusedLocals.d.ts","sourceRoot":"","sources":["../../../src/tools/validation/unusedLocals.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAUhD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,aAAa,EAAE,CAsIrF;AAiMD;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,aAAa,EAAE,CAGlF"}