driftdetect-cortex 0.9.41

package/dist/generation/provenance/explanation-builder.js

@@ -0,0 +1,237 @@
+/**
+ * Explanation Builder
+ *
+ * Builds human-readable explanations of generated code
+ * based on provenance information. Helps developers
+ * understand why code was generated a certain way.
+ *
+ * @module generation/provenance/explanation-builder
+ */
+/**
+ * Default configuration
+ */
+const DEFAULT_CONFIG = {
+    detailLevel: 'normal',
+    includeExamples: true,
+    includeAlternatives: false,
+};
+/**
+ * Explanation Builder
+ *
+ * Builds human-readable explanations of generated code.
+ */
+export class ExplanationBuilder {
+    config;
+    constructor(config) {
+        this.config = { ...DEFAULT_CONFIG, ...config };
+    }
+    /**
+     * Build explanation from provenance
+     */
+    build(provenance) {
+        const sections = [];
+        // Opening summary
+        sections.push(this.buildSummary(provenance));
+        // Influences section
+        if (provenance.influences.length > 0) {
+            sections.push(this.summarizeInfluences(provenance.influences));
+        }
+        // Warnings section
+        if (provenance.warnings.length > 0) {
+            sections.push(this.summarizeWarnings(provenance.warnings));
+        }
+        // Constraints section
+        if (provenance.appliedConstraints.length > 0) {
+            sections.push(this.summarizeConstraints(provenance.appliedConstraints));
+        }
+        // Anti-patterns section
+        if (provenance.avoidedAntiPatterns.length > 0) {
+            sections.push(this.summarizeAntiPatterns(provenance.avoidedAntiPatterns));
+        }
+        // Confidence note
+        sections.push(this.buildConfidenceNote(provenance.confidence));
+        return sections.join('\n\n');
+    }
+    /**
+     * Build explanation from generation context
+     */
+    buildFromContext(context) {
+        const sections = [];
+        // Opening
+        sections.push(`This code was generated for ${context.target.filePath} based on the following context:`);
+        // Patterns
+        if (context.patterns.length > 0) {
+            const patternNames = context.patterns.map(p => p.patternName).slice(0, 3);
+            sections.push(`**Patterns followed:** ${patternNames.join(', ')}${context.patterns.length > 3 ? ` and ${context.patterns.length - 3} more` : ''}`);
+        }
+        // Tribal knowledge
+        if (context.tribal.length > 0) {
+            const topics = context.tribal.map(t => t.topic).slice(0, 3);
+            sections.push(`**Tribal knowledge applied:** ${topics.join(', ')}${context.tribal.length > 3 ? ` and ${context.tribal.length - 3} more` : ''}`);
+        }
+        // Constraints
+        if (context.constraints.length > 0) {
+            const constraintNames = context.constraints.map(c => c.constraintName).slice(0, 3);
+            sections.push(`**Constraints enforced:** ${constraintNames.join(', ')}${context.constraints.length > 3 ? ` and ${context.constraints.length - 3} more` : ''}`);
+        }
+        // Anti-patterns
+        if (context.antiPatterns.length > 0) {
+            const antiPatternNames = context.antiPatterns.map(a => a.name).slice(0, 3);
+            sections.push(`**Anti-patterns avoided:** ${antiPatternNames.join(', ')}${context.antiPatterns.length > 3 ? ` and ${context.antiPatterns.length - 3} more` : ''}`);
+        }
+        return sections.join('\n\n');
+    }
+    /**
+     * Build brief explanation (one sentence)
+     */
+    buildBrief(provenance) {
+        const influenceCount = provenance.influences.length;
+        const warningCount = provenance.warnings.length;
+        const constraintCount = provenance.appliedConstraints.length;
+        const parts = [];
+        if (influenceCount > 0) {
+            parts.push(`${influenceCount} pattern${influenceCount > 1 ? 's' : ''}`);
+        }
+        if (constraintCount > 0) {
+            parts.push(`${constraintCount} constraint${constraintCount > 1 ? 's' : ''}`);
+        }
+        if (warningCount > 0) {
+            parts.push(`${warningCount} warning${warningCount > 1 ? 's' : ''}`);
+        }
+        const confidence = Math.round(provenance.confidence * 100);
+        if (parts.length === 0) {
+            return `Generated with ${confidence}% confidence.`;
+        }
+        return `Generated following ${parts.join(', ')} with ${confidence}% confidence.`;
+    }
+    /**
+     * Build summary section
+     */
+    buildSummary(provenance) {
+        const confidence = Math.round(provenance.confidence * 100);
+        const influenceCount = provenance.influences.length;
+        if (this.config.detailLevel === 'brief') {
+            return this.buildBrief(provenance);
+        }
+        return `This code was generated with ${confidence}% confidence based on ${influenceCount} influence${influenceCount !== 1 ? 's' : ''} from the codebase memory.`;
+    }
+    /**
+     * Summarize influences
+     */
+    summarizeInfluences(influences) {
+        const grouped = this.groupInfluencesByType(influences);
+        const parts = ['**What influenced this code:**'];
+        for (const [type, items] of Object.entries(grouped)) {
+            const typeName = this.formatInfluenceTypeName(type);
+            const descriptions = items.map(i => i.description);
+            if (this.config.detailLevel === 'detailed') {
+                parts.push(`\n*${typeName}:*`);
+                for (const desc of descriptions) {
+                    parts.push(`- ${desc}`);
+                }
+            }
+            else {
+                parts.push(`- ${typeName}: ${descriptions.slice(0, 2).join('; ')}${descriptions.length > 2 ? ` (+${descriptions.length - 2} more)` : ''}`);
+            }
+        }
+        return parts.join('\n');
+    }
+    /**
+     * Summarize warnings
+     */
+    summarizeWarnings(warnings) {
+        const parts = ['**Warnings to be aware of:**'];
+        for (const warning of warnings.slice(0, 5)) {
+            parts.push(`⚠️ ${warning}`);
+        }
+        if (warnings.length > 5) {
+            parts.push(`... and ${warnings.length - 5} more warnings`);
+        }
+        return parts.join('\n');
+    }
+    /**
+     * Summarize constraints
+     */
+    summarizeConstraints(constraints) {
+        const parts = ['**Constraints that were enforced:**'];
+        for (const constraint of constraints) {
+            parts.push(`✓ ${this.formatConstraintName(constraint)}`);
+        }
+        return parts.join('\n');
+    }
+    /**
+     * Summarize anti-patterns
+     */
+    summarizeAntiPatterns(antiPatterns) {
+        const parts = ['**Anti-patterns that were avoided:**'];
+        for (const antiPattern of antiPatterns) {
+            parts.push(`✗ ${antiPattern}`);
+        }
+        return parts.join('\n');
+    }
+    /**
+     * Build confidence note
+     */
+    buildConfidenceNote(confidence) {
+        const percent = Math.round(confidence * 100);
+        if (percent >= 80) {
+            return `**Confidence:** High (${percent}%) - This code closely follows established patterns.`;
+        }
+        else if (percent >= 60) {
+            return `**Confidence:** Medium (${percent}%) - This code follows most patterns but may need review.`;
+        }
+        else {
+            return `**Confidence:** Low (${percent}%) - This code may deviate from patterns. Please review carefully.`;
+        }
+    }
+    /**
+     * Group influences by type
+     */
+    groupInfluencesByType(influences) {
+        const grouped = {};
+        for (const influence of influences) {
+            const type = influence.influenceType;
+            if (!grouped[type]) {
+                grouped[type] = [];
+            }
+            grouped[type].push(influence);
+        }
+        return grouped;
+    }
+    /**
+     * Format influence type name
+     */
+    formatInfluenceTypeName(type) {
+        switch (type) {
+            case 'pattern_followed':
+                return 'Patterns Followed';
+            case 'tribal_applied':
+                return 'Tribal Knowledge Applied';
+            case 'constraint_enforced':
+                return 'Constraints Enforced';
+            case 'antipattern_avoided':
+                return 'Anti-Patterns Avoided';
+            case 'example_used':
+                return 'Examples Used';
+            case 'style_matched':
+                return 'Styles Matched';
+            default:
+                return type;
+        }
+    }
+    /**
+     * Format constraint name
+     */
+    formatConstraintName(constraintId) {
+        return constraintId
+            .replace(/[-_]/g, ' ')
+            .replace(/\b\w/g, c => c.toUpperCase());
+    }
+    /**
+     * Update configuration
+     */
+    updateConfig(config) {
+        this.config = { ...this.config, ...config };
+    }
+}
+//# sourceMappingURL=explanation-builder.js.map

package/dist/generation/provenance/explanation-builder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"explanation-builder.js","sourceRoot":"","sources":["../../../src/generation/provenance/explanation-builder.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAgBH;;GAEG;AACH,MAAM,cAAc,GAA6B;IAC/C,WAAW,EAAE,QAAQ;IACrB,eAAe,EAAE,IAAI;IACrB,mBAAmB,EAAE,KAAK;CAC3B,CAAC;AAEF;;;;GAIG;AACH,MAAM,OAAO,kBAAkB;IACrB,MAAM,CAA2B;IAEzC,YAAY,MAA0C;QACpD,IAAI,CAAC,MAAM,GAAG,EAAE,GAAG,cAAc,EAAE,GAAG,MAAM,EAAE,CAAC;IACjD,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,UAA0B;QAC9B,MAAM,QAAQ,GAAa,EAAE,CAAC;QAE9B,kBAAkB;QAClB,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,UAAU,CAAC,CAAC,CAAC;QAE7C,qBAAqB;QACrB,IAAI,UAAU,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACrC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,mBAAmB,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC,CAAC;QACjE,CAAC;QAED,mBAAmB;QACnB,IAAI,UAAU,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACnC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,iBAAiB,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,CAAC;QAC7D,CAAC;QAED,sBAAsB;QACtB,IAAI,UAAU,CAAC,kBAAkB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC7C,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,oBAAoB,CAAC,UAAU,CAAC,kBAAkB,CAAC,CAAC,CAAC;QAC1E,CAAC;QAED,wBAAwB;QACxB,IAAI,UAAU,CAAC,mBAAmB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC9C,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,qBAAqB,CAAC,UAAU,CAAC,mBAAmB,CAAC,CAAC,CAAC;QAC5E,CAAC;QAED,kBAAkB;QAClB,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,mBAAmB,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC,CAAC;QAE/D,OAAO,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAC/B,CAAC;IAED;;OAEG;IACH,gBAAgB,CAAC,OAA0B;QACzC,MAAM,QAAQ,GAAa,EAAE,CAAC;QAE9B,UAAU;QACV,QAAQ,CAAC,IAAI,CAAC,+BAA+B,OAAO,CAAC,MAAM,CAAC,QAAQ,kCAAkC,CAAC,CAAC;QAExG,WAAW;QACX,IAAI,OAAO,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAChC,MAAM,YAAY,GAAG,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;YAC1E,QAAQ,CAAC,IAAI,CAAC,0BAA0B,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,OAAO,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QACrJ,CAAC;QAED,mBAAmB;QACnB,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC9B,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;YAC5D,QAAQ,CAAC,IAAI,CAAC,iCAAiC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,OAAO,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QAClJ,CAAC;QAED,cAAc;QACd,IAAI,OAAO,CAAC,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACnC,MAAM,eAAe,GAAG,OAAO,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;YACnF,QAAQ,CAAC,IAAI,CAAC,6BAA6B,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,WAAW,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,OAAO,CAAC,WAAW,CAAC,MAAM,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QACjK,CAAC;QAED,gBAAgB;QAChB,IAAI,OAAO,CAAC,YAAY,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACpC,MAAM,gBAAgB,GAAG,OAAO,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;YAC3E,QAAQ,CAAC,IAAI,CAAC,8BAA8B,gBAAgB,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,YAAY,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,OAAO,CAAC,YAAY,CAAC,MAAM,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QACrK,CAAC;QAED,OAAO,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAC/B,CAAC;IAED;;OAEG;IACH,UAAU,CAAC,UAA0B;QACnC,MAAM,cAAc,GAAG,UAAU,CAAC,UAAU,CAAC,MAAM,CAAC;QACpD,MAAM,YAAY,GAAG,UAAU,CAAC,QAAQ,CAAC,MAAM,CAAC;QAChD,MAAM,eAAe,GAAG,UAAU,CAAC,kBAAkB,CAAC,MAAM,CAAC;QAE7D,MAAM,KAAK,GAAa,EAAE,CAAC;QAE3B,IAAI,cAAc,GAAG,CAAC,EAAE,CAAC;YACvB,KAAK,CAAC,IAAI,CAAC,GAAG,cAAc,WAAW,cAAc,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QAC1E,CAAC;QAED,IAAI,eAAe,GAAG,CAAC,EAAE,CAAC;YACxB,KAAK,CAAC,IAAI,CAAC,GAAG,eAAe,cAAc,eAAe,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QAC/E,CAAC;QAED,IAAI,YAAY,GAAG,CAAC,EAAE,CAAC;YACrB,KAAK,CAAC,IAAI,CAAC,GAAG,YAAY,WAAW,YAAY,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QACtE,CAAC;QAED,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,UAAU,GAAG,GAAG,CAAC,CAAC;QAE3D,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACvB,OAAO,kBAAkB,UAAU,eAAe,CAAC;QACrD,CAAC;QAED,OAAO,uBAAuB,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,UAAU,eAAe,CAAC;IACnF,CAAC;IAED;;OAEG;IACK,YAAY,CAAC,UAA0B;QAC7C,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,UAAU,GAAG,GAAG,CAAC,CAAC;QAC3D,MAAM,cAAc,GAAG,UAAU,CAAC,UAAU,CAAC,MAAM,CAAC;QAEpD,IAAI,IAAI,CAAC,MAAM,CAAC,WAAW,KAAK,OAAO,EAAE,CAAC;YACxC,OAAO,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC;QACrC,CAAC;QAED,OAAO,gCAAgC,UAAU,yBAAyB,cAAc,aAAa,cAAc,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,4BAA4B,CAAC;IACnK,CAAC;IAED;;OAEG;IACK,mBAAmB,CAAC,UAAuB;QACjD,MAAM,OAAO,GAAG,IAAI,CAAC,qBAAqB,CAAC,UAAU,CAAC,CAAC;QACvD,MAAM,KAAK,GAAa,CAAC,gCAAgC,CAAC,CAAC;QAE3D,KAAK,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;YACpD,MAAM,QAAQ,GAAG,IAAI,CAAC,uBAAuB,CAAC,IAAI,CAAC,CAAC;YACpD,MAAM,YAAY,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC;YAEnD,IAAI,IAAI,CAAC,MAAM,CAAC,WAAW,KAAK,UAAU,EAAE,CAAC;gBAC3C,KAAK,CAAC,IAAI,CAAC,MAAM,QAAQ,IAAI,CAAC,CAAC;gBAC/B,KAAK,MAAM,IAAI,IAAI,YAAY,EAAE,CAAC;oBAChC,KAAK,CAAC,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC;gBAC1B,CAAC;YACH,CAAC;iBAAM,CAAC;gBACN,KAAK,CAAC,IAAI,CAAC,KAAK,QAAQ,KAAK,YAAY,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,YAAY,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,YAAY,CAAC,MAAM,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YAC7I,CAAC;QACH,CAAC;QAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;IAED;;OAEG;IACK,iBAAiB,CAAC,QAAkB;QAC1C,MAAM,KAAK,GAAa,CAAC,8BAA8B,CAAC,CAAC;QAEzD,KAAK,MAAM,OAAO,IAAI,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;YAC3C,KAAK,CAAC,IAAI,CAAC,MAAM,OAAO,EAAE,CAAC,CAAC;QAC9B,CAAC;QAED,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACxB,KAAK,CAAC,IAAI,CAAC,WAAW,QAAQ,CAAC,MAAM,GAAG,CAAC,gBAAgB,CAAC,CAAC;QAC7D,CAAC;QAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;IAED;;OAEG;IACK,oBAAoB,CAAC,WAAqB;QAChD,MAAM,KAAK,GAAa,CAAC,qCAAqC,CAAC,CAAC;QAEhE,KAAK,MAAM,UAAU,IAAI,WAAW,EAAE,CAAC;YACrC,KAAK,CAAC,IAAI,CAAC,KAAK,IAAI,CAAC,oBAAoB,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC;QAC3D,CAAC;QAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;IAED;;OAEG;IACK,qBAAqB,CAAC,YAAsB;QAClD,MAAM,KAAK,GAAa,CAAC,sCAAsC,CAAC,CAAC;QAEjE,KAAK,MAAM,WAAW,IAAI,YAAY,EAAE,CAAC;YACvC,KAAK,CAAC,IAAI,CAAC,KAAK,WAAW,EAAE,CAAC,CAAC;QACjC,CAAC;QAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;IAED;;OAEG;IACK,mBAAmB,CAAC,UAAkB;QAC5C,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,UAAU,GAAG,GAAG,CAAC,CAAC;QAE7C,IAAI,OAAO,IAAI,EAAE,EAAE,CAAC;YAClB,OAAO,yBAAyB,OAAO,sDAAsD,CAAC;QAChG,CAAC;aAAM,IAAI,OAAO,IAAI,EAAE,EAAE,CAAC;YACzB,OAAO,2BAA2B,OAAO,2DAA2D,CAAC;QACvG,CAAC;aAAM,CAAC;YACN,OAAO,wBAAwB,OAAO,oEAAoE,CAAC;QAC7G,CAAC;IACH,CAAC;IAED;;OAEG;IACK,qBAAqB,CAAC,UAAuB;QACnD,MAAM,OAAO,GAAgC,EAAE,CAAC;QAEhD,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;YACnC,MAAM,IAAI,GAAG,SAAS,CAAC,aAAa,CAAC;YACrC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;gBACnB,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC;YACrB,CAAC;YACD,OAAO,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QAChC,CAAC;QAED,OAAO,OAAO,CAAC;IACjB,CAAC;IAED;;OAEG;IACK,uBAAuB,CAAC,IAAY;QAC1C,QAAQ,IAAI,EAAE,CAAC;YACb,KAAK,kBAAkB;gBACrB,OAAO,mBAAmB,CAAC;YAC7B,KAAK,gBAAgB;gBACnB,OAAO,0BAA0B,CAAC;YACpC,KAAK,qBAAqB;gBACxB,OAAO,sBAAsB,CAAC;YAChC,KAAK,qBAAqB;gBACxB,OAAO,uBAAuB,CAAC;YACjC,KAAK,cAAc;gBACjB,OAAO,eAAe,CAAC;YACzB,KAAK,eAAe;gBAClB,OAAO,gBAAgB,CAAC;YAC1B;gBACE,OAAO,IAAI,CAAC;QAChB,CAAC;IACH,CAAC;IAED;;OAEG;IACK,oBAAoB,CAAC,YAAoB;QAC/C,OAAO,YAAY;aAChB,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC;aACrB,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC;IAC5C,CAAC;IAED;;OAEG;IACH,YAAY,CAAC,MAAyC;QACpD,IAAI,CAAC,MAAM,GAAG,EAAE,GAAG,IAAI,CAAC,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC;IAC9C,CAAC;CACF"}

package/dist/generation/provenance/index.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Provenance Module
+ *
+ * Exports all provenance tracking components for code generation.
+ *
+ * @module generation/provenance
+ */
+export { ProvenanceTracker } from './tracker.js';
+export { ProvenanceCommentGenerator } from './comment-generator.js';
+export type { CommentGeneratorConfig } from './comment-generator.js';
+export { ExplanationBuilder } from './explanation-builder.js';
+export type { ExplanationBuilderConfig } from './explanation-builder.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/generation/provenance/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/generation/provenance/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAEjD,OAAO,EAAE,0BAA0B,EAAE,MAAM,wBAAwB,CAAC;AACpE,YAAY,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AAErE,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAC9D,YAAY,EAAE,wBAAwB,EAAE,MAAM,0BAA0B,CAAC"}

package/dist/generation/provenance/index.js

@@ -0,0 +1,11 @@
+/**
+ * Provenance Module
+ *
+ * Exports all provenance tracking components for code generation.
+ *
+ * @module generation/provenance
+ */
+export { ProvenanceTracker } from './tracker.js';
+export { ProvenanceCommentGenerator } from './comment-generator.js';
+export { ExplanationBuilder } from './explanation-builder.js';
+//# sourceMappingURL=index.js.map

package/dist/generation/provenance/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/generation/provenance/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAEjD,OAAO,EAAE,0BAA0B,EAAE,MAAM,wBAAwB,CAAC;AAGpE,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC"}

package/dist/generation/provenance/tracker.d.ts

@@ -0,0 +1,74 @@
+/**
+ * Provenance Tracker
+ *
+ * Tracks what influenced generated code for transparency
+ * and debugging. Records patterns followed, tribal knowledge
+ * applied, constraints enforced, and anti-patterns avoided.
+ *
+ * @module generation/provenance/tracker
+ */
+import type { CodeProvenance, InfluenceType, GenerationContext } from '../types.js';
+/**
+ * Provenance Tracker
+ *
+ * Tracks provenance during code generation.
+ */
+export declare class ProvenanceTracker {
+    private requestId;
+    private influences;
+    private warnings;
+    private appliedConstraints;
+    private avoidedAntiPatterns;
+    private confidenceSum;
+    private confidenceCount;
+    constructor(requestId?: string);
+    /**
+     * Initialize tracker from generation context
+     */
+    initFromContext(context: GenerationContext): void;
+    /**
+     * Record an influence on the generated code
+     */
+    recordInfluence(memoryId: string, memoryType: string, influenceType: InfluenceType, description: string, strength?: number): void;
+    /**
+     * Record a warning that was considered
+     */
+    recordWarning(warning: string): void;
+    /**
+     * Record a constraint that was applied
+     */
+    recordConstraint(constraintId: string): void;
+    /**
+     * Record an anti-pattern that was avoided
+     */
+    recordAntiPattern(patternId: string): void;
+    /**
+     * Record that an example was used
+     */
+    recordExampleUsed(memoryId: string, description: string): void;
+    /**
+     * Record that a style was matched
+     */
+    recordStyleMatched(memoryId: string, description: string): void;
+    /**
+     * Build the final provenance record
+     */
+    build(): CodeProvenance;
+    /**
+     * Get the request ID
+     */
+    getRequestId(): string;
+    /**
+     * Get current influence count
+     */
+    getInfluenceCount(): number;
+    /**
+     * Get current warning count
+     */
+    getWarningCount(): number;
+    /**
+     * Reset the tracker for reuse
+     */
+    reset(requestId?: string): void;
+}
+//# sourceMappingURL=tracker.d.ts.map

package/dist/generation/provenance/tracker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tracker.d.ts","sourceRoot":"","sources":["../../../src/generation/provenance/tracker.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,KAAK,EACV,cAAc,EAEd,aAAa,EACb,iBAAiB,EAClB,MAAM,aAAa,CAAC;AAErB;;;;GAIG;AACH,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,UAAU,CAAmB;IACrC,OAAO,CAAC,QAAQ,CAAgB;IAChC,OAAO,CAAC,kBAAkB,CAAgB;IAC1C,OAAO,CAAC,mBAAmB,CAAgB;IAC3C,OAAO,CAAC,aAAa,CAAK;IAC1B,OAAO,CAAC,eAAe,CAAK;gBAEhB,SAAS,CAAC,EAAE,MAAM;IAI9B;;OAEG;IACH,eAAe,CAAC,OAAO,EAAE,iBAAiB,GAAG,IAAI;IAuDjD;;OAEG;IACH,eAAe,CACb,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,EAClB,aAAa,EAAE,aAAa,EAC5B,WAAW,EAAE,MAAM,EACnB,QAAQ,GAAE,MAAY,GACrB,IAAI;IAaP;;OAEG;IACH,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAMpC;;OAEG;IACH,gBAAgB,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI;IAM5C;;OAEG;IACH,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAM1C;;OAEG;IACH,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,IAAI;IAU9D;;OAEG;IACH,kBAAkB,CAAC,QAAQ,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,IAAI;IAU/D;;OAEG;IACH,KAAK,IAAI,cAAc;IAgBvB;;OAEG;IACH,YAAY,IAAI,MAAM;IAItB;;OAEG;IACH,iBAAiB,IAAI,MAAM;IAI3B;;OAEG;IACH,eAAe,IAAI,MAAM;IAIzB;;OAEG;IACH,KAAK,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI;CAShC"}

package/dist/generation/provenance/tracker.js

@@ -0,0 +1,154 @@
+/**
+ * Provenance Tracker
+ *
+ * Tracks what influenced generated code for transparency
+ * and debugging. Records patterns followed, tribal knowledge
+ * applied, constraints enforced, and anti-patterns avoided.
+ *
+ * @module generation/provenance/tracker
+ */
+import { randomUUID } from 'crypto';
+/**
+ * Provenance Tracker
+ *
+ * Tracks provenance during code generation.
+ */
+export class ProvenanceTracker {
+    requestId;
+    influences = [];
+    warnings = [];
+    appliedConstraints = [];
+    avoidedAntiPatterns = [];
+    confidenceSum = 0;
+    confidenceCount = 0;
+    constructor(requestId) {
+        this.requestId = requestId ?? randomUUID();
+    }
+    /**
+     * Initialize tracker from generation context
+     */
+    initFromContext(context) {
+        // Record pattern influences
+        for (const pattern of context.patterns) {
+            this.recordInfluence(pattern.patternId, 'pattern_rationale', 'pattern_followed', `Following pattern: ${pattern.patternName}`, pattern.relevanceScore);
+        }
+        // Record tribal influences
+        for (const tribal of context.tribal) {
+            this.recordInfluence(tribal.memoryId, 'tribal', 'tribal_applied', `Applied tribal knowledge: ${tribal.topic}`, tribal.relevanceScore);
+            // Add warnings from tribal knowledge
+            if (tribal.warnings) {
+                for (const warning of tribal.warnings) {
+                    this.recordWarning(warning);
+                }
+            }
+        }
+        // Record constraint influences
+        for (const constraint of context.constraints) {
+            this.recordConstraint(constraint.constraintId);
+            this.recordInfluence(constraint.constraintId, 'constraint_override', 'constraint_enforced', `Enforced constraint: ${constraint.constraintName}`, constraint.relevanceScore);
+        }
+        // Record anti-pattern avoidances
+        for (const antiPattern of context.antiPatterns) {
+            this.recordAntiPattern(antiPattern.memoryId);
+            this.recordInfluence(antiPattern.memoryId, 'code_smell', 'antipattern_avoided', `Avoided anti-pattern: ${antiPattern.name}`, antiPattern.relevanceScore);
+        }
+    }
+    /**
+     * Record an influence on the generated code
+     */
+    recordInfluence(memoryId, memoryType, influenceType, description, strength = 0.5) {
+        this.influences.push({
+            memoryId,
+            memoryType,
+            influenceType,
+            description,
+            strength,
+        });
+        this.confidenceSum += strength;
+        this.confidenceCount++;
+    }
+    /**
+     * Record a warning that was considered
+     */
+    recordWarning(warning) {
+        if (!this.warnings.includes(warning)) {
+            this.warnings.push(warning);
+        }
+    }
+    /**
+     * Record a constraint that was applied
+     */
+    recordConstraint(constraintId) {
+        if (!this.appliedConstraints.includes(constraintId)) {
+            this.appliedConstraints.push(constraintId);
+        }
+    }
+    /**
+     * Record an anti-pattern that was avoided
+     */
+    recordAntiPattern(patternId) {
+        if (!this.avoidedAntiPatterns.includes(patternId)) {
+            this.avoidedAntiPatterns.push(patternId);
+        }
+    }
+    /**
+     * Record that an example was used
+     */
+    recordExampleUsed(memoryId, description) {
+        this.recordInfluence(memoryId, 'pattern_rationale', 'example_used', description, 0.7);
+    }
+    /**
+     * Record that a style was matched
+     */
+    recordStyleMatched(memoryId, description) {
+        this.recordInfluence(memoryId, 'pattern_rationale', 'style_matched', description, 0.5);
+    }
+    /**
+     * Build the final provenance record
+     */
+    build() {
+        const confidence = this.confidenceCount > 0
+            ? this.confidenceSum / this.confidenceCount
+            : 0.5;
+        return {
+            requestId: this.requestId,
+            influences: this.influences,
+            warnings: this.warnings,
+            appliedConstraints: this.appliedConstraints,
+            avoidedAntiPatterns: this.avoidedAntiPatterns,
+            confidence: Math.min(confidence, 1.0),
+            generatedAt: new Date().toISOString(),
+        };
+    }
+    /**
+     * Get the request ID
+     */
+    getRequestId() {
+        return this.requestId;
+    }
+    /**
+     * Get current influence count
+     */
+    getInfluenceCount() {
+        return this.influences.length;
+    }
+    /**
+     * Get current warning count
+     */
+    getWarningCount() {
+        return this.warnings.length;
+    }
+    /**
+     * Reset the tracker for reuse
+     */
+    reset(requestId) {
+        this.requestId = requestId ?? randomUUID();
+        this.influences = [];
+        this.warnings = [];
+        this.appliedConstraints = [];
+        this.avoidedAntiPatterns = [];
+        this.confidenceSum = 0;
+        this.confidenceCount = 0;
+    }
+}
+//# sourceMappingURL=tracker.js.map

package/dist/generation/provenance/tracker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tracker.js","sourceRoot":"","sources":["../../../src/generation/provenance/tracker.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AAQpC;;;;GAIG;AACH,MAAM,OAAO,iBAAiB;IACpB,SAAS,CAAS;IAClB,UAAU,GAAgB,EAAE,CAAC;IAC7B,QAAQ,GAAa,EAAE,CAAC;IACxB,kBAAkB,GAAa,EAAE,CAAC;IAClC,mBAAmB,GAAa,EAAE,CAAC;IACnC,aAAa,GAAG,CAAC,CAAC;IAClB,eAAe,GAAG,CAAC,CAAC;IAE5B,YAAY,SAAkB;QAC5B,IAAI,CAAC,SAAS,GAAG,SAAS,IAAI,UAAU,EAAE,CAAC;IAC7C,CAAC;IAED;;OAEG;IACH,eAAe,CAAC,OAA0B;QACxC,4BAA4B;QAC5B,KAAK,MAAM,OAAO,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;YACvC,IAAI,CAAC,eAAe,CAClB,OAAO,CAAC,SAAS,EACjB,mBAAmB,EACnB,kBAAkB,EAClB,sBAAsB,OAAO,CAAC,WAAW,EAAE,EAC3C,OAAO,CAAC,cAAc,CACvB,CAAC;QACJ,CAAC;QAED,2BAA2B;QAC3B,KAAK,MAAM,MAAM,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;YACpC,IAAI,CAAC,eAAe,CAClB,MAAM,CAAC,QAAQ,EACf,QAAQ,EACR,gBAAgB,EAChB,6BAA6B,MAAM,CAAC,KAAK,EAAE,EAC3C,MAAM,CAAC,cAAc,CACtB,CAAC;YAEF,qCAAqC;YACrC,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;gBACpB,KAAK,MAAM,OAAO,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;oBACtC,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC;gBAC9B,CAAC;YACH,CAAC;QACH,CAAC;QAED,+BAA+B;QAC/B,KAAK,MAAM,UAAU,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;YAC7C,IAAI,CAAC,gBAAgB,CAAC,UAAU,CAAC,YAAY,CAAC,CAAC;YAC/C,IAAI,CAAC,eAAe,CAClB,UAAU,CAAC,YAAY,EACvB,qBAAqB,EACrB,qBAAqB,EACrB,wBAAwB,UAAU,CAAC,cAAc,EAAE,EACnD,UAAU,CAAC,cAAc,CAC1B,CAAC;QACJ,CAAC;QAED,iCAAiC;QACjC,KAAK,MAAM,WAAW,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC;YAC/C,IAAI,CAAC,iBAAiB,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC;YAC7C,IAAI,CAAC,eAAe,CAClB,WAAW,CAAC,QAAQ,EACpB,YAAY,EACZ,qBAAqB,EACrB,yBAAyB,WAAW,CAAC,IAAI,EAAE,EAC3C,WAAW,CAAC,cAAc,CAC3B,CAAC;QACJ,CAAC;IACH,CAAC;IAED;;OAEG;IACH,eAAe,CACb,QAAgB,EAChB,UAAkB,EAClB,aAA4B,EAC5B,WAAmB,EACnB,WAAmB,GAAG;QAEtB,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;YACnB,QAAQ;YACR,UAAU;YACV,aAAa;YACb,WAAW;YACX,QAAQ;SACT,CAAC,CAAC;QAEH,IAAI,CAAC,aAAa,IAAI,QAAQ,CAAC;QAC/B,IAAI,CAAC,eAAe,EAAE,CAAC;IACzB,CAAC;IAED;;OAEG;IACH,aAAa,CAAC,OAAe;QAC3B,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;YACrC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAC9B,CAAC;IACH,CAAC;IAED;;OAEG;IACH,gBAAgB,CAAC,YAAoB;QACnC,IAAI,CAAC,IAAI,CAAC,kBAAkB,CAAC,QAAQ,CAAC,YAAY,CAAC,EAAE,CAAC;YACpD,IAAI,CAAC,kBAAkB,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;QAC7C,CAAC;IACH,CAAC;IAED;;OAEG;IACH,iBAAiB,CAAC,SAAiB;QACjC,IAAI,CAAC,IAAI,CAAC,mBAAmB,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC;YAClD,IAAI,CAAC,mBAAmB,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QAC3C,CAAC;IACH,CAAC;IAED;;OAEG;IACH,iBAAiB,CAAC,QAAgB,EAAE,WAAmB;QACrD,IAAI,CAAC,eAAe,CAClB,QAAQ,EACR,mBAAmB,EACnB,cAAc,EACd,WAAW,EACX,GAAG,CACJ,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,kBAAkB,CAAC,QAAgB,EAAE,WAAmB;QACtD,IAAI,CAAC,eAAe,CAClB,QAAQ,EACR,mBAAmB,EACnB,eAAe,EACf,WAAW,EACX,GAAG,CACJ,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,KAAK;QACH,MAAM,UAAU,GAAG,IAAI,CAAC,eAAe,GAAG,CAAC;YACzC,CAAC,CAAC,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC,eAAe;YAC3C,CAAC,CAAC,GAAG,CAAC;QAER,OAAO;YACL,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,UAAU,EAAE,IAAI,CAAC,UAAU;YAC3B,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,kBAAkB,EAAE,IAAI,CAAC,kBAAkB;YAC3C,mBAAmB,EAAE,IAAI,CAAC,mBAAmB;YAC7C,UAAU,EAAE,IAAI,CAAC,GAAG,CAAC,UAAU,EAAE,GAAG,CAAC;YACrC,WAAW,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;SACtC,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,YAAY;QACV,OAAO,IAAI,CAAC,SAAS,CAAC;IACxB,CAAC;IAED;;OAEG;IACH,iBAAiB;QACf,OAAO,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC;IAChC,CAAC;IAED;;OAEG;IACH,eAAe;QACb,OAAO,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC;IAC9B,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,SAAkB;QACtB,IAAI,CAAC,SAAS,GAAG,SAAS,IAAI,UAAU,EAAE,CAAC;QAC3C,IAAI,CAAC,UAAU,GAAG,EAAE,CAAC;QACrB,IAAI,CAAC,QAAQ,GAAG,EAAE,CAAC;QACnB,IAAI,CAAC,kBAAkB,GAAG,EAAE,CAAC;QAC7B,IAAI,CAAC,mBAAmB,GAAG,EAAE,CAAC;QAC9B,IAAI,CAAC,aAAa,GAAG,CAAC,CAAC;QACvB,IAAI,CAAC,eAAe,GAAG,CAAC,CAAC;IAC3B,CAAC;CACF"}

package/dist/generation/types.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Generation Types
+ *
+ * Re-exports generation types from the types module.
+ *
+ * @module generation/types
+ */
+export type { GenerationContext, GenerationTarget, GenerationType, GenerationIntent, PatternContext, TribalContext, ConstraintContext, ConstraintOverrideContext, AntiPatternContext, RelatedMemoryContext, CodeExample, TokenBudgetInfo, GenerationMetadata, CodeProvenance, Influence, InfluenceType, GeneratedCode, GenerationOutcome, GenerationFeedback, } from '../types/generation-context.js';
+//# sourceMappingURL=types.d.ts.map

package/dist/generation/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/generation/types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,YAAY,EACV,iBAAiB,EACjB,gBAAgB,EAChB,cAAc,EACd,gBAAgB,EAChB,cAAc,EACd,aAAa,EACb,iBAAiB,EACjB,yBAAyB,EACzB,kBAAkB,EAClB,oBAAoB,EACpB,WAAW,EACX,eAAe,EACf,kBAAkB,EAClB,cAAc,EACd,SAAS,EACT,aAAa,EACb,aAAa,EACb,iBAAiB,EACjB,kBAAkB,GACnB,MAAM,gCAAgC,CAAC"}

package/dist/generation/types.js

@@ -0,0 +1,9 @@
+/**
+ * Generation Types
+ *
+ * Re-exports generation types from the types module.
+ *
+ * @module generation/types
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/generation/types.js.map

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

package/dist/generation/validation/antipattern-checker.d.ts

@@ -0,0 +1,64 @@
+/**
+ * Anti-Pattern Checker
+ *
+ * Checks if generated code contains any of the
+ * anti-patterns from the generation context.
+ *
+ * @module generation/validation/antipattern-checker
+ */
+import type { AntiPatternContext } from '../types.js';
+/**
+ * Anti-pattern match
+ */
+export interface AntiPatternMatch {
+    /** Memory ID of the anti-pattern */
+    memoryId: string;
+    /** Name of the anti-pattern */
+    name: string;
+    /** Description of the match */
+    description: string;
+    /** Severity */
+    severity: 'error' | 'warning' | 'info';
+    /** The pattern that was matched */
+    pattern: string;
+    /** Suggested alternative */
+    alternative: string;
+    /** Line number (if applicable) */
+    line?: number;
+}
+/**
+ * Anti-Pattern Checker
+ *
+ * Checks if generated code contains anti-patterns.
+ */
+export declare class AntiPatternChecker {
+    /**
+     * Check code against anti-patterns
+     */
+    check(code: string, antiPatterns: AntiPatternContext[]): AntiPatternMatch[];
+    /**
+     * Check if code matches an anti-pattern
+     */
+    private matchesAntiPattern;
+    /**
+     * Check if pattern looks like a regex
+     */
+    private isRegexPattern;
+    /**
+     * Match using regex pattern
+     */
+    private matchRegexPattern;
+    /**
+     * Match using keywords from pattern
+     */
+    private matchKeywords;
+    /**
+     * Match using structural patterns
+     */
+    private matchStructural;
+    /**
+     * Create a match result
+     */
+    private createMatch;
+}
+//# sourceMappingURL=antipattern-checker.d.ts.map

package/dist/generation/validation/antipattern-checker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"antipattern-checker.d.ts","sourceRoot":"","sources":["../../../src/generation/validation/antipattern-checker.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAEtD;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,oCAAoC;IACpC,QAAQ,EAAE,MAAM,CAAC;IACjB,+BAA+B;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,+BAA+B;IAC/B,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe;IACf,QAAQ,EAAE,OAAO,GAAG,SAAS,GAAG,MAAM,CAAC;IACvC,mCAAmC;IACnC,OAAO,EAAE,MAAM,CAAC;IAChB,4BAA4B;IAC5B,WAAW,EAAE,MAAM,CAAC;IACpB,kCAAkC;IAClC,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;;;GAIG;AACH,qBAAa,kBAAkB;IAC7B;;OAEG;IACH,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,YAAY,EAAE,kBAAkB,EAAE,GAAG,gBAAgB,EAAE;IAa3E;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAwB1B;;OAEG;IACH,OAAO,CAAC,cAAc;IAKtB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IA2BzB;;OAEG;IACH,OAAO,CAAC,aAAa;IA4BrB;;OAEG;IACH,OAAO,CAAC,eAAe;IAmFvB;;OAEG;IACH,OAAO,CAAC,WAAW;CAUpB"}