codeguardian-mcp 1.0.0

package/dist/agent/mcpNotifications.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcpNotifications.d.ts","sourceRoot":"","sources":["../../src/agent/mcpNotifications.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AAKnE;;GAEG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAGjD;AAED;;;GAGG;AACH,wBAAsB,gBAAgB,CACpC,IAAI,EAAE,qBAAqB,GAAG,aAAa,GAAG,cAAc,GAAG,gBAAgB,GAAG,mBAAmB,EACrG,IAAI,EAAE,GAAG,GACR,OAAO,CAAC,OAAO,CAAC,CA8BlB;AAED;;;;;GAKG;AACH,wBAAsB,mBAAmB,CAAC,KAAK,EAAE;IAC/C,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,GAAG,EAAE,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB,GAAG,OAAO,CAAC,OAAO,CAAC,CAQnB;AAED;;GAEG;AACH,wBAAsB,2BAA2B,CAC/C,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,GAAG,GACX,OAAO,CAAC,OAAO,CAAC,CAQlB"}

package/dist/agent/mcpNotifications.js

@@ -0,0 +1,81 @@
+/**
+ * MCP Notification System
+ *
+ * Provides UI notifications to the MCP client (Claude Desktop, Cline, VS Code, etc.)
+ *
+ * IMPORTANT: MCP servers CANNOT directly push data to LLMs. These notifications
+ * only appear in the client's UI as hints. The LLM must still call tools like
+ * get_guardian_alerts to retrieve the actual alert data.
+ *
+ * @format
+ */
+import { logger } from "../utils/logger.js";
+let mcpServer = null;
+/**
+ * Register the MCP server instance for notifications
+ */
+export function setMCPServer(server) {
+    mcpServer = server;
+    logger.info("MCP notification system initialized");
+}
+/**
+ * Send a notification to the MCP client (system UI)
+ * This uses MCP's standard logging notification API
+ */
+export async function sendNotification(type, data) {
+    if (!mcpServer) {
+        logger.warn("MCP server not registered, cannot send notification");
+        return false;
+    }
+    try {
+        // Use MCP's standard logging/message notification
+        // This routes to the client UI (Claude Desktop, Cline, VS Code, etc.)
+        const level = type === "agent_alert" ? "warning" : "info";
+        await mcpServer.notification({
+            method: "notifications/message",
+            params: {
+                level,
+                logger: "CodeGuardian",
+                data: {
+                    type,
+                    message: data.message || `CodeGuardian ${type}`,
+                    ...data,
+                },
+            },
+        });
+        logger.info(`Sent notification to system: ${type}`);
+        return true;
+    }
+    catch (error) {
+        logger.error("Failed to send notification:", error);
+        return false;
+    }
+}
+/**
+ * Send a validation alert notification to the UI
+ *
+ * NOTE: This only shows a notification in the client UI. The LLM must
+ * call get_guardian_alerts to retrieve the actual alert data.
+ */
+export async function pushValidationAlert(alert) {
+    const type = alert.isInitialScan ? "initial_scan" : "agent_alert";
+    return sendNotification(type, {
+        file: alert.file,
+        issueCount: alert.issues.length,
+        message: alert.llmMessage,
+        timestamp: Date.now(),
+    });
+}
+/**
+ * Send async validation results when complete
+ */
+export async function pushAsyncValidationComplete(jobId, results) {
+    return sendNotification("validation_complete", {
+        jobId,
+        success: results.success,
+        issueCount: results.issues?.length || 0,
+        message: results.recommendation?.message || "Validation complete",
+        timestamp: Date.now(),
+    });
+}
+//# sourceMappingURL=mcpNotifications.js.map

package/dist/agent/mcpNotifications.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcpNotifications.js","sourceRoot":"","sources":["../../src/agent/mcpNotifications.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAE5C,IAAI,SAAS,GAAkB,IAAI,CAAC;AAEpC;;GAEG;AACH,MAAM,UAAU,YAAY,CAAC,MAAc;IACzC,SAAS,GAAG,MAAM,CAAC;IACnB,MAAM,CAAC,IAAI,CAAC,qCAAqC,CAAC,CAAC;AACrD,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,IAAqG,EACrG,IAAS;IAET,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,MAAM,CAAC,IAAI,CAAC,qDAAqD,CAAC,CAAC;QACnE,OAAO,KAAK,CAAC;IACf,CAAC;IAED,IAAI,CAAC;QACH,kDAAkD;QAClD,sEAAsE;QACtE,MAAM,KAAK,GAAG,IAAI,KAAK,aAAa,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC;QAE1D,MAAM,SAAS,CAAC,YAAY,CAAC;YAC3B,MAAM,EAAE,uBAAuB;YAC/B,MAAM,EAAE;gBACN,KAAK;gBACL,MAAM,EAAE,cAAc;gBACtB,IAAI,EAAE;oBACJ,IAAI;oBACJ,OAAO,EAAE,IAAI,CAAC,OAAO,IAAI,gBAAgB,IAAI,EAAE;oBAC/C,GAAG,IAAI;iBACR;aACF;SACF,CAAC,CAAC;QAEH,MAAM,CAAC,IAAI,CAAC,gCAAgC,IAAI,EAAE,CAAC,CAAC;QACpD,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,CAAC,KAAK,CAAC,8BAA8B,EAAE,KAAK,CAAC,CAAC;QACpD,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAC,KAKzC;IACC,MAAM,IAAI,GAAG,KAAK,CAAC,aAAa,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,aAAa,CAAC;IAClE,OAAO,gBAAgB,CAAC,IAAI,EAAE;QAC5B,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,UAAU,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM;QAC/B,OAAO,EAAE,KAAK,CAAC,UAAU;QACzB,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;KACtB,CAAC,CAAC;AACL,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,2BAA2B,CAC/C,KAAa,EACb,OAAY;IAEZ,OAAO,gBAAgB,CAAC,qBAAqB,EAAE;QAC7C,KAAK;QACL,OAAO,EAAE,OAAO,CAAC,OAAO;QACxB,UAAU,EAAE,OAAO,CAAC,MAAM,EAAE,MAAM,IAAI,CAAC;QACvC,OAAO,EAAE,OAAO,CAAC,cAAc,EAAE,OAAO,IAAI,qBAAqB;QACjE,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;KACtB,CAAC,CAAC;AACL,CAAC"}

package/dist/analyzers/aiPatterns.d.ts

@@ -0,0 +1,16 @@
+/**
+ * AI Anti-Pattern Detector
+ *
+ * Lightweight heuristic detector used by unit tests and optional enrichment.
+ *
+ * NOTE: This intentionally avoids heavy parsing to keep runtime low.
+ */
+export type AIAntiPatternSeverity = "low" | "medium" | "high" | "critical";
+export interface AIAntiPatternIssue {
+    type: "genericErrorHandling" | "unnecessaryAbstraction" | "missingValidation";
+    severity: AIAntiPatternSeverity;
+    message: string;
+    line?: number;
+}
+export declare function detectAIAntiPatterns(code: string, language: string): Promise<AIAntiPatternIssue[]>;
+//# sourceMappingURL=aiPatterns.d.ts.map

package/dist/analyzers/aiPatterns.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"aiPatterns.d.ts","sourceRoot":"","sources":["../../src/analyzers/aiPatterns.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,MAAM,qBAAqB,GAAG,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,UAAU,CAAC;AAE3E,MAAM,WAAW,kBAAkB;IACjC,IAAI,EACA,sBAAsB,GACtB,wBAAwB,GACxB,mBAAmB,CAAC;IACxB,QAAQ,EAAE,qBAAqB,CAAC;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AA+FD,wBAAsB,oBAAoB,CACxC,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,kBAAkB,EAAE,CAAC,CAY/B"}

package/dist/analyzers/aiPatterns.js

@@ -0,0 +1,103 @@
+/**
+ * AI Anti-Pattern Detector
+ *
+ * Lightweight heuristic detector used by unit tests and optional enrichment.
+ *
+ * NOTE: This intentionally avoids heavy parsing to keep runtime low.
+ */
+function getLineNumberFromIndex(source, index) {
+    if (index <= 0)
+        return 1;
+    // Count '\n' up to index (1-based lines)
+    let lines = 1;
+    for (let i = 0; i < index && i < source.length; i++) {
+        if (source.charCodeAt(i) === 10)
+            lines++;
+    }
+    return lines;
+}
+function detectGenericErrorHandling(code) {
+    // Heuristic:
+    // - find catch blocks
+    // - flag those that only log the error (console.log/error/warn) without rethrow/handling
+    // - do NOT flag if we see a throw inside the catch, or explicit logging via a structured logger
+    const issues = [];
+    // Match `catch (e) { ... }` including multiline body (non-greedy)
+    const catchRe = /catch\s*\(([^)]*)\)\s*\{([\s\S]*?)\}/g;
+    for (const match of code.matchAll(catchRe)) {
+        const full = match[0];
+        const catchParam = (match[1] ?? "").trim();
+        const body = match[2] ?? "";
+        const matchIndex = match.index ?? 0;
+        // If they rethrow or wrap, assume good.
+        if (/\bthrow\b/.test(body))
+            continue;
+        if (/\breturn\b\s+new\s+/.test(body))
+            continue;
+        // If a structured logger is used, assume intentional handling.
+        if (/\blogger\.(error|warn|info)\s*\(/.test(body))
+            continue;
+        // Flag console logging of the caught error.
+        const consoleLogRe = /\bconsole\.(log|error|warn)\s*\(([^)]*)\)\s*;?/;
+        const consoleLog = body.match(consoleLogRe);
+        if (!consoleLog)
+            continue;
+        const argText = consoleLog[2] ?? "";
+        // Prefer to only flag when they log the caught error directly.
+        // If param is empty, still flag (generic catch-all) when console logging is present.
+        const logsCaughtError = !catchParam || new RegExp(`\\b${catchParam}\\b`).test(argText);
+        if (!logsCaughtError)
+            continue;
+        issues.push({
+            type: "genericErrorHandling",
+            severity: "medium",
+            message: "Catch block appears to only log the error (generic error handling); consider handling or rethrowing.",
+            line: getLineNumberFromIndex(code, matchIndex + full.indexOf("catch")),
+        });
+    }
+    return issues;
+}
+function detectUnnecessaryAbstractionsTS(code) {
+    // Heuristic:
+    // - find `interface X { ... }`
+    // - count occurrences of word X in the whole file
+    // - if it only occurs in its declaration + one usage, flag as unnecessary
+    const issues = [];
+    const interfaceRe = /\binterface\s+([A-Za-z_$][\w$]*)\b/g;
+    for (const match of code.matchAll(interfaceRe)) {
+        const name = match[1];
+        if (!name)
+            continue;
+        const nameRe = new RegExp(`\\b${name}\\b`, "g");
+        const occurrences = [...code.matchAll(nameRe)].length;
+        // Occurrence counting includes the declaration itself.
+        // Typical "used once" pattern: `interface X` + `implements X` => 2.
+        // Consider up to 2 as unnecessary; 3+ indicates multi-use.
+        if (occurrences <= 2) {
+            issues.push({
+                type: "unnecessaryAbstraction",
+                severity: "low",
+                message: `Interface '${name}' appears to be used only once; consider simplifying unless needed for extensibility.`,
+                line: getLineNumberFromIndex(code, match.index ?? 0),
+            });
+        }
+    }
+    return issues;
+}
+// eslint-disable-next-line @typescript-eslint/no-unused-vars
+function detectMissingValidation(_code) {
+    // Intentionally conservative; current unit tests accept 0 findings.
+    return [];
+}
+export async function detectAIAntiPatterns(code, language) {
+    if (!code || !code.trim())
+        return [];
+    const issues = [];
+    issues.push(...detectGenericErrorHandling(code));
+    if (language === "typescript" || language === "ts") {
+        issues.push(...detectUnnecessaryAbstractionsTS(code));
+    }
+    issues.push(...detectMissingValidation(code));
+    return issues;
+}
+//# sourceMappingURL=aiPatterns.js.map

package/dist/analyzers/aiPatterns.js.map

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

package/dist/analyzers/antiPatterns.d.ts

@@ -0,0 +1,60 @@
+/**
+ * Anti-Patterns Analyzer
+ *
+ * Loads and provides AI anti-patterns for enriching validation results.
+ * Used for LLM context and educational purposes - NOT for regex validation.
+ *
+ * @format
+ */
+export interface AntiPattern {
+    id: string;
+    name: string;
+    category: string;
+    severity: "low" | "medium" | "high";
+    description: string;
+    pattern: string;
+    languages: string[];
+    fix: string;
+    example: string;
+    aiGenerated: boolean;
+}
+/**
+ * Load anti-patterns from JSON file
+ * Caches result for performance
+ */
+export declare function loadAntiPatterns(): Promise<AntiPattern[]>;
+/**
+ * Get anti-patterns synchronously (from cache)
+ * Returns empty array if not yet loaded
+ */
+export declare function getAntiPatternsSync(): AntiPattern[];
+/**
+ * Find anti-patterns relevant to a specific issue type
+ */
+export declare function getRelevantAntiPatterns(issueType: string, language?: string): Promise<AntiPattern[]>;
+/**
+ * Get anti-patterns by category
+ */
+export declare function getAntiPatternsByCategory(category: string): Promise<AntiPattern[]>;
+/**
+ * Get AI-specific anti-patterns (common AI mistakes)
+ */
+export declare function getAIAntiPatterns(): Promise<AntiPattern[]>;
+/**
+ * Enrich a validation issue with relevant anti-pattern context
+ * Returns the enriched issue (non-destructive)
+ */
+export declare function enrichIssueWithAntiPattern(issue: any, language?: string): Promise<any>;
+/**
+ * Batch enrich multiple issues
+ */
+export declare function enrichIssuesWithAntiPatterns(issues: any[], language?: string): Promise<any[]>;
+/**
+ * Generate LLM context from anti-patterns relevant to the issues
+ */
+export declare function generateAntiPatternContext(issues: any[], language?: string): Promise<string>;
+/**
+ * Get educational summary for a specific anti-pattern ID
+ */
+export declare function getAntiPatternById(id: string): Promise<AntiPattern | null>;
+//# sourceMappingURL=antiPatterns.d.ts.map

package/dist/analyzers/antiPatterns.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"antiPatterns.d.ts","sourceRoot":"","sources":["../../src/analyzers/antiPatterns.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAWH,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;IACpC,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,OAAO,CAAC;CACtB;AAgBD;;;GAGG;AACH,wBAAsB,gBAAgB,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC,CAwB/D;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,IAAI,WAAW,EAAE,CAEnD;AAMD;;GAEG;AACH,wBAAsB,uBAAuB,CAC3C,SAAS,EAAE,MAAM,EACjB,QAAQ,CAAC,EAAE,MAAM,GAChB,OAAO,CAAC,WAAW,EAAE,CAAC,CAgCxB;AAED;;GAEG;AACH,wBAAsB,yBAAyB,CAC7C,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,WAAW,EAAE,CAAC,CAGxB;AAED;;GAEG;AACH,wBAAsB,iBAAiB,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC,CAGhE;AAMD;;;GAGG;AACH,wBAAsB,0BAA0B,CAC9C,KAAK,EAAE,GAAG,EACV,QAAQ,CAAC,EAAE,MAAM,GAChB,OAAO,CAAC,GAAG,CAAC,CA0Bd;AAED;;GAEG;AACH,wBAAsB,4BAA4B,CAChD,MAAM,EAAE,GAAG,EAAE,EACb,QAAQ,CAAC,EAAE,MAAM,GAChB,OAAO,CAAC,GAAG,EAAE,CAAC,CAEhB;AAMD;;GAEG;AACH,wBAAsB,0BAA0B,CAC9C,MAAM,EAAE,GAAG,EAAE,EACb,QAAQ,CAAC,EAAE,MAAM,GAChB,OAAO,CAAC,MAAM,CAAC,CAqDjB;AAED;;GAEG;AACH,wBAAsB,kBAAkB,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,CAGhF"}

package/dist/analyzers/antiPatterns.js

@@ -0,0 +1,198 @@
+/**
+ * Anti-Patterns Analyzer
+ *
+ * Loads and provides AI anti-patterns for enriching validation results.
+ * Used for LLM context and educational purposes - NOT for regex validation.
+ *
+ * @format
+ */
+import * as fs from "fs/promises";
+import * as path from "path";
+import { fileURLToPath } from "url";
+import { logger } from "../utils/logger.js";
+// ============================================================================
+// Cache
+// ============================================================================
+let antiPatternsCache = null;
+// ============================================================================
+// Loader
+// ============================================================================
+/**
+ * Load anti-patterns from JSON file
+ * Caches result for performance
+ */
+export async function loadAntiPatterns() {
+    if (antiPatternsCache) {
+        return antiPatternsCache;
+    }
+    try {
+        // Get the directory of the current module
+        const __filename = fileURLToPath(import.meta.url);
+        const __dirname = path.dirname(__filename);
+        // Path to anti-patterns JSON (relative to src/)
+        const patternsPath = path.resolve(__dirname, "../../rules/anti-patterns/ai-anti-patterns.json");
+        const data = await fs.readFile(patternsPath, "utf-8");
+        const db = JSON.parse(data);
+        antiPatternsCache = db.patterns;
+        logger.info(`Loaded ${antiPatternsCache.length} anti-patterns`);
+        return antiPatternsCache;
+    }
+    catch (error) {
+        logger.error("Failed to load anti-patterns:", error);
+        return [];
+    }
+}
+/**
+ * Get anti-patterns synchronously (from cache)
+ * Returns empty array if not yet loaded
+ */
+export function getAntiPatternsSync() {
+    return antiPatternsCache || [];
+}
+// ============================================================================
+// Lookup Functions
+// ============================================================================
+/**
+ * Find anti-patterns relevant to a specific issue type
+ */
+export async function getRelevantAntiPatterns(issueType, language) {
+    const patterns = await loadAntiPatterns();
+    // Map validation issue types to anti-pattern categories
+    const categoryMap = {
+        undefinedVariable: ["maintainability", "bugs"],
+        nonExistentMethod: ["maintainability"],
+        nonExistentFunction: ["maintainability"],
+        nonExistentImport: ["maintainability"],
+        nonExistentClass: ["maintainability"],
+        unusedImport: ["dead-code"],
+        // dependencyHallucination intentionally excluded - no relevant anti-pattern exists
+        deadCode: ["dead-code"],
+        highComplexity: ["complexity"],
+        longFunction: ["complexity"],
+        deepNesting: ["complexity"],
+        architecturalDeviation: ["maintainability"],
+    };
+    const relevantCategories = categoryMap[issueType] || [];
+    return patterns.filter((pattern) => {
+        // Match by category
+        const categoryMatch = relevantCategories.includes(pattern.category);
+        // Filter by language if specified
+        const languageMatch = language
+            ? pattern.languages.includes(language) || pattern.languages.includes("javascript")
+            : true;
+        return categoryMatch && languageMatch;
+    });
+}
+/**
+ * Get anti-patterns by category
+ */
+export async function getAntiPatternsByCategory(category) {
+    const patterns = await loadAntiPatterns();
+    return patterns.filter((p) => p.category === category);
+}
+/**
+ * Get AI-specific anti-patterns (common AI mistakes)
+ */
+export async function getAIAntiPatterns() {
+    const patterns = await loadAntiPatterns();
+    return patterns.filter((p) => p.aiGenerated);
+}
+// ============================================================================
+// Enrichment Functions
+// ============================================================================
+/**
+ * Enrich a validation issue with relevant anti-pattern context
+ * Returns the enriched issue (non-destructive)
+ */
+export async function enrichIssueWithAntiPattern(issue, language) {
+    try {
+        const relevantPatterns = await getRelevantAntiPatterns(issue.type, language);
+        if (relevantPatterns.length === 0) {
+            return issue;
+        }
+        // Find the most relevant pattern (first match for now)
+        const primaryPattern = relevantPatterns[0];
+        return {
+            ...issue,
+            antiPattern: {
+                id: primaryPattern.id,
+                name: primaryPattern.name,
+                category: primaryPattern.category,
+                description: primaryPattern.description,
+                fix: primaryPattern.fix,
+                example: primaryPattern.example,
+            },
+        };
+    }
+    catch (error) {
+        logger.warn("Failed to enrich issue with anti-pattern:", error);
+        return issue;
+    }
+}
+/**
+ * Batch enrich multiple issues
+ */
+export async function enrichIssuesWithAntiPatterns(issues, language) {
+    return Promise.all(issues.map((issue) => enrichIssueWithAntiPattern(issue, language)));
+}
+// ============================================================================
+// LLM Context Generation
+// ============================================================================
+/**
+ * Generate LLM context from anti-patterns relevant to the issues
+ */
+export async function generateAntiPatternContext(issues, language) {
+    try {
+        // Get unique categories from issues
+        const categories = new Set();
+        const categoryMap = {
+            undefinedVariable: ["maintainability"],
+            nonExistentMethod: ["maintainability"],
+            nonExistentFunction: ["maintainability"],
+            unusedImport: ["dead-code"],
+            deadCode: ["dead-code"],
+            highComplexity: ["complexity"],
+            longFunction: ["complexity"],
+            deepNesting: ["complexity"],
+        };
+        issues.forEach((issue) => {
+            const cats = categoryMap[issue.type] || [];
+            cats.forEach((c) => categories.add(c));
+        });
+        if (categories.size === 0) {
+            return "";
+        }
+        // Load relevant anti-patterns
+        const patterns = await loadAntiPatterns();
+        const relevantPatterns = patterns.filter((p) => categories.has(p.category) && (!language || p.languages.includes(language)));
+        if (relevantPatterns.length === 0) {
+            return "";
+        }
+        // Format for LLM
+        const sections = relevantPatterns.map((p) => {
+            return `### ${p.id}: ${p.name}
+- **Category:** ${p.category}
+- **Severity:** ${p.severity}
+- **Problem:** ${p.description}
+- **Fix:** ${p.fix}
+${p.aiGenerated ? "- **Note:** Common in AI-generated code" : ""}`;
+        });
+        return `## Relevant Anti-Patterns to Avoid
+
+${sections.join("\n\n")}
+
+When suggesting fixes, ensure you don't introduce these anti-patterns.`;
+    }
+    catch (error) {
+        logger.warn("Failed to generate anti-pattern context:", error);
+        return "";
+    }
+}
+/**
+ * Get educational summary for a specific anti-pattern ID
+ */
+export async function getAntiPatternById(id) {
+    const patterns = await loadAntiPatterns();
+    return patterns.find((p) => p.id === id) || null;
+}
+//# sourceMappingURL=antiPatterns.js.map

package/dist/analyzers/antiPatterns.js.map

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

package/dist/analyzers/builtinTypes.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Built-in Types and Methods
+ *
+ * Comprehensive registry of built-in types, methods, and globals
+ * for each supported language. Used for type-aware validation.
+ *
+ * @format
+ */
+export interface LanguageBuiltins {
+    globals: string[];
+    functions: string[];
+    classes: string[];
+    keywords: string[];
+    methods: Record<string, string[]>;
+    properties: Record<string, string[]>;
+}
+export declare const BUILTIN_TYPES: Record<string, LanguageBuiltins>;
+//# sourceMappingURL=builtinTypes.d.ts.map

package/dist/analyzers/builtinTypes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"builtinTypes.d.ts","sourceRoot":"","sources":["../../src/analyzers/builtinTypes.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;IAClC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;CACtC;AAED,eAAO,MAAM,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAovC1D,CAAC"}