driftdetect-cortex 0.9.41

package/dist/generation/feedback/outcome-processor.js.map

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

package/dist/generation/index.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Generation Module
+ *
+ * Code generation context and validation system.
+ * Provides context gathering, provenance tracking,
+ * validation, and feedback processing.
+ *
+ * @module generation
+ */
+export type { GenerationContext, GenerationTarget, GenerationType, GenerationIntent, PatternContext, TribalContext, ConstraintContext, ConstraintOverrideContext, AntiPatternContext, RelatedMemoryContext, CodeExample, TokenBudgetInfo, GenerationMetadata, CodeProvenance, Influence, InfluenceType, GeneratedCode, GenerationOutcome, GenerationFeedback, } from './types.js';
+export { GenerationContextBuilder, PatternContextGatherer, TribalContextGatherer, ConstraintContextGatherer, AntiPatternGatherer, } from './context/index.js';
+export type { ContextBuilderConfig, PatternGathererConfig, TribalGathererConfig, ConstraintGathererConfig, AntiPatternGathererConfig, } from './context/index.js';
+export { ProvenanceTracker, ProvenanceCommentGenerator, ExplanationBuilder, } from './provenance/index.js';
+export type { CommentGeneratorConfig, ExplanationBuilderConfig, } from './provenance/index.js';
+export { GeneratedCodeValidator, PatternComplianceChecker, TribalComplianceChecker, AntiPatternChecker, } from './validation/index.js';
+export type { ValidationResult, ValidatorConfig, PatternViolation, TribalViolation, AntiPatternMatch, } from './validation/index.js';
+export { GenerationFeedbackLoop, OutcomeProcessor, } from './feedback/index.js';
+export type { FeedbackStats, } from './feedback/index.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/generation/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,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,YAAY,CAAC;AAGpB,OAAO,EACL,wBAAwB,EACxB,sBAAsB,EACtB,qBAAqB,EACrB,yBAAyB,EACzB,mBAAmB,GACpB,MAAM,oBAAoB,CAAC;AAC5B,YAAY,EACV,oBAAoB,EACpB,qBAAqB,EACrB,oBAAoB,EACpB,wBAAwB,EACxB,yBAAyB,GAC1B,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EACL,iBAAiB,EACjB,0BAA0B,EAC1B,kBAAkB,GACnB,MAAM,uBAAuB,CAAC;AAC/B,YAAY,EACV,sBAAsB,EACtB,wBAAwB,GACzB,MAAM,uBAAuB,CAAC;AAG/B,OAAO,EACL,sBAAsB,EACtB,wBAAwB,EACxB,uBAAuB,EACvB,kBAAkB,GACnB,MAAM,uBAAuB,CAAC;AAC/B,YAAY,EACV,gBAAgB,EAChB,eAAe,EACf,gBAAgB,EAChB,eAAe,EACf,gBAAgB,GACjB,MAAM,uBAAuB,CAAC;AAG/B,OAAO,EACL,sBAAsB,EACtB,gBAAgB,GACjB,MAAM,qBAAqB,CAAC;AAC7B,YAAY,EACV,aAAa,GACd,MAAM,qBAAqB,CAAC"}

package/dist/generation/index.js

@@ -0,0 +1,18 @@
+/**
+ * Generation Module
+ *
+ * Code generation context and validation system.
+ * Provides context gathering, provenance tracking,
+ * validation, and feedback processing.
+ *
+ * @module generation
+ */
+// Context
+export { GenerationContextBuilder, PatternContextGatherer, TribalContextGatherer, ConstraintContextGatherer, AntiPatternGatherer, } from './context/index.js';
+// Provenance
+export { ProvenanceTracker, ProvenanceCommentGenerator, ExplanationBuilder, } from './provenance/index.js';
+// Validation
+export { GeneratedCodeValidator, PatternComplianceChecker, TribalComplianceChecker, AntiPatternChecker, } from './validation/index.js';
+// Feedback
+export { GenerationFeedbackLoop, OutcomeProcessor, } from './feedback/index.js';
+//# sourceMappingURL=index.js.map

package/dist/generation/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/generation/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAyBH,UAAU;AACV,OAAO,EACL,wBAAwB,EACxB,sBAAsB,EACtB,qBAAqB,EACrB,yBAAyB,EACzB,mBAAmB,GACpB,MAAM,oBAAoB,CAAC;AAS5B,aAAa;AACb,OAAO,EACL,iBAAiB,EACjB,0BAA0B,EAC1B,kBAAkB,GACnB,MAAM,uBAAuB,CAAC;AAM/B,aAAa;AACb,OAAO,EACL,sBAAsB,EACtB,wBAAwB,EACxB,uBAAuB,EACvB,kBAAkB,GACnB,MAAM,uBAAuB,CAAC;AAS/B,WAAW;AACX,OAAO,EACL,sBAAsB,EACtB,gBAAgB,GACjB,MAAM,qBAAqB,CAAC"}

package/dist/generation/provenance/comment-generator.d.ts

@@ -0,0 +1,89 @@
+/**
+ * Provenance Comment Generator
+ *
+ * Generates code comments that document the provenance
+ * of generated code. Helps developers understand what
+ * influenced the generation.
+ *
+ * @module generation/provenance/comment-generator
+ */
+import type { CodeProvenance } from '../types.js';
+/**
+ * Configuration for comment generation
+ */
+export interface CommentGeneratorConfig {
+    /** Comment style */
+    style: 'block' | 'line' | 'jsdoc';
+    /** Include request ID */
+    includeRequestId: boolean;
+    /** Include timestamp */
+    includeTimestamp: boolean;
+    /** Include confidence */
+    includeConfidence: boolean;
+    /** Maximum influences to show */
+    maxInfluences: number;
+    /** Maximum warnings to show */
+    maxWarnings: number;
+}
+/**
+ * Provenance Comment Generator
+ *
+ * Generates code comments documenting provenance.
+ */
+export declare class ProvenanceCommentGenerator {
+    private config;
+    constructor(config?: Partial<CommentGeneratorConfig>);
+    /**
+     * Generate provenance comment
+     */
+    generate(provenance: CodeProvenance): string;
+    /**
+     * Generate a compact single-line comment
+     */
+    generateCompact(provenance: CodeProvenance): string;
+    /**
+     * Format header lines
+     */
+    private formatHeader;
+    /**
+     * Format influences
+     */
+    private formatInfluences;
+    /**
+     * Format warnings
+     */
+    private formatWarnings;
+    /**
+     * Format constraints
+     */
+    private formatConstraints;
+    /**
+     * Format anti-patterns
+     */
+    private formatAntiPatterns;
+    /**
+     * Format influence type for display
+     */
+    private formatInfluenceType;
+    /**
+     * Wrap lines in comment style
+     */
+    private wrapInCommentStyle;
+    /**
+     * Wrap in block comment style
+     */
+    private wrapBlockComment;
+    /**
+     * Wrap in line comment style
+     */
+    private wrapLineComment;
+    /**
+     * Wrap in JSDoc comment style
+     */
+    private wrapJSDocComment;
+    /**
+     * Update configuration
+     */
+    updateConfig(config: Partial<CommentGeneratorConfig>): void;
+}
+//# sourceMappingURL=comment-generator.d.ts.map

package/dist/generation/provenance/comment-generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"comment-generator.d.ts","sourceRoot":"","sources":["../../../src/generation/provenance/comment-generator.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAa,MAAM,aAAa,CAAC;AAE7D;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,oBAAoB;IACpB,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,OAAO,CAAC;IAClC,yBAAyB;IACzB,gBAAgB,EAAE,OAAO,CAAC;IAC1B,wBAAwB;IACxB,gBAAgB,EAAE,OAAO,CAAC;IAC1B,yBAAyB;IACzB,iBAAiB,EAAE,OAAO,CAAC;IAC3B,iCAAiC;IACjC,aAAa,EAAE,MAAM,CAAC;IACtB,+BAA+B;IAC/B,WAAW,EAAE,MAAM,CAAC;CACrB;AAcD;;;;GAIG;AACH,qBAAa,0BAA0B;IACrC,OAAO,CAAC,MAAM,CAAyB;gBAE3B,MAAM,CAAC,EAAE,OAAO,CAAC,sBAAsB,CAAC;IAIpD;;OAEG;IACH,QAAQ,CAAC,UAAU,EAAE,cAAc,GAAG,MAAM;IAiC5C;;OAEG;IACH,eAAe,CAAC,UAAU,EAAE,cAAc,GAAG,MAAM;IAiBnD;;OAEG;IACH,OAAO,CAAC,YAAY;IAkBpB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAiBxB;;OAEG;IACH,OAAO,CAAC,cAAc;IAetB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAUzB;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAU1B;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAmB3B;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAa1B;;OAEG;IACH,OAAO,CAAC,gBAAgB;IASxB;;OAEG;IACH,OAAO,CAAC,eAAe;IAIvB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IASxB;;OAEG;IACH,YAAY,CAAC,MAAM,EAAE,OAAO,CAAC,sBAAsB,CAAC,GAAG,IAAI;CAG5D"}

package/dist/generation/provenance/comment-generator.js

@@ -0,0 +1,213 @@
+/**
+ * Provenance Comment Generator
+ *
+ * Generates code comments that document the provenance
+ * of generated code. Helps developers understand what
+ * influenced the generation.
+ *
+ * @module generation/provenance/comment-generator
+ */
+/**
+ * Default configuration
+ */
+const DEFAULT_CONFIG = {
+    style: 'block',
+    includeRequestId: false,
+    includeTimestamp: false,
+    includeConfidence: true,
+    maxInfluences: 5,
+    maxWarnings: 3,
+};
+/**
+ * Provenance Comment Generator
+ *
+ * Generates code comments documenting provenance.
+ */
+export class ProvenanceCommentGenerator {
+    config;
+    constructor(config) {
+        this.config = { ...DEFAULT_CONFIG, ...config };
+    }
+    /**
+     * Generate provenance comment
+     */
+    generate(provenance) {
+        const lines = [];
+        // Header
+        lines.push(...this.formatHeader(provenance));
+        // Influences
+        if (provenance.influences.length > 0) {
+            lines.push('');
+            lines.push(...this.formatInfluences(provenance.influences));
+        }
+        // Warnings
+        if (provenance.warnings.length > 0) {
+            lines.push('');
+            lines.push(...this.formatWarnings(provenance.warnings));
+        }
+        // Constraints
+        if (provenance.appliedConstraints.length > 0) {
+            lines.push('');
+            lines.push(...this.formatConstraints(provenance.appliedConstraints));
+        }
+        // Anti-patterns
+        if (provenance.avoidedAntiPatterns.length > 0) {
+            lines.push('');
+            lines.push(...this.formatAntiPatterns(provenance.avoidedAntiPatterns));
+        }
+        return this.wrapInCommentStyle(lines);
+    }
+    /**
+     * Generate a compact single-line comment
+     */
+    generateCompact(provenance) {
+        const parts = ['Generated'];
+        if (provenance.influences.length > 0) {
+            const topInfluence = provenance.influences[0];
+            if (topInfluence) {
+                parts.push(`following ${this.formatInfluenceType(topInfluence.influenceType)}`);
+            }
+        }
+        if (this.config.includeConfidence) {
+            parts.push(`(confidence: ${Math.round(provenance.confidence * 100)}%)`);
+        }
+        return `// ${parts.join(' ')}`;
+    }
+    /**
+     * Format header lines
+     */
+    formatHeader(provenance) {
+        const lines = ['Generated Code Provenance'];
+        if (this.config.includeRequestId) {
+            lines.push(`Request ID: ${provenance.requestId}`);
+        }
+        if (this.config.includeTimestamp) {
+            lines.push(`Generated: ${provenance.generatedAt}`);
+        }
+        if (this.config.includeConfidence) {
+            lines.push(`Confidence: ${Math.round(provenance.confidence * 100)}%`);
+        }
+        return lines;
+    }
+    /**
+     * Format influences
+     */
+    formatInfluences(influences) {
+        const lines = ['Influences:'];
+        const toShow = influences.slice(0, this.config.maxInfluences);
+        for (const influence of toShow) {
+            const type = this.formatInfluenceType(influence.influenceType);
+            const strength = Math.round(influence.strength * 100);
+            lines.push(`  - [${type}] ${influence.description} (${strength}%)`);
+        }
+        if (influences.length > this.config.maxInfluences) {
+            lines.push(`  ... and ${influences.length - this.config.maxInfluences} more`);
+        }
+        return lines;
+    }
+    /**
+     * Format warnings
+     */
+    formatWarnings(warnings) {
+        const lines = ['Warnings:'];
+        const toShow = warnings.slice(0, this.config.maxWarnings);
+        for (const warning of toShow) {
+            lines.push(`  ⚠️ ${warning}`);
+        }
+        if (warnings.length > this.config.maxWarnings) {
+            lines.push(`  ... and ${warnings.length - this.config.maxWarnings} more`);
+        }
+        return lines;
+    }
+    /**
+     * Format constraints
+     */
+    formatConstraints(constraints) {
+        const lines = ['Applied Constraints:'];
+        for (const constraint of constraints) {
+            lines.push(`  ✓ ${constraint}`);
+        }
+        return lines;
+    }
+    /**
+     * Format anti-patterns
+     */
+    formatAntiPatterns(antiPatterns) {
+        const lines = ['Avoided Anti-Patterns:'];
+        for (const antiPattern of antiPatterns) {
+            lines.push(`  ✗ ${antiPattern}`);
+        }
+        return lines;
+    }
+    /**
+     * Format influence type for display
+     */
+    formatInfluenceType(type) {
+        switch (type) {
+            case 'pattern_followed':
+                return 'Pattern';
+            case 'tribal_applied':
+                return 'Tribal';
+            case 'constraint_enforced':
+                return 'Constraint';
+            case 'antipattern_avoided':
+                return 'Anti-Pattern';
+            case 'example_used':
+                return 'Example';
+            case 'style_matched':
+                return 'Style';
+            default:
+                return type;
+        }
+    }
+    /**
+     * Wrap lines in comment style
+     */
+    wrapInCommentStyle(lines) {
+        switch (this.config.style) {
+            case 'block':
+                return this.wrapBlockComment(lines);
+            case 'line':
+                return this.wrapLineComment(lines);
+            case 'jsdoc':
+                return this.wrapJSDocComment(lines);
+            default:
+                return this.wrapBlockComment(lines);
+        }
+    }
+    /**
+     * Wrap in block comment style
+     */
+    wrapBlockComment(lines) {
+        const result = ['/*'];
+        for (const line of lines) {
+            result.push(` * ${line}`);
+        }
+        result.push(' */');
+        return result.join('\n');
+    }
+    /**
+     * Wrap in line comment style
+     */
+    wrapLineComment(lines) {
+        return lines.map(line => `// ${line}`).join('\n');
+    }
+    /**
+     * Wrap in JSDoc comment style
+     */
+    wrapJSDocComment(lines) {
+        const result = ['/**'];
+        for (const line of lines) {
+            result.push(` * ${line}`);
+        }
+        result.push(' */');
+        return result.join('\n');
+    }
+    /**
+     * Update configuration
+     */
+    updateConfig(config) {
+        this.config = { ...this.config, ...config };
+    }
+}
+//# sourceMappingURL=comment-generator.js.map

package/dist/generation/provenance/comment-generator.js.map

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

package/dist/generation/provenance/explanation-builder.d.ts

@@ -0,0 +1,83 @@
+/**
+ * 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
+ */
+import type { CodeProvenance, GenerationContext } from '../types.js';
+/**
+ * Configuration for explanation builder
+ */
+export interface ExplanationBuilderConfig {
+    /** Detail level */
+    detailLevel: 'brief' | 'normal' | 'detailed';
+    /** Include examples */
+    includeExamples: boolean;
+    /** Include alternatives */
+    includeAlternatives: boolean;
+}
+/**
+ * Explanation Builder
+ *
+ * Builds human-readable explanations of generated code.
+ */
+export declare class ExplanationBuilder {
+    private config;
+    constructor(config?: Partial<ExplanationBuilderConfig>);
+    /**
+     * Build explanation from provenance
+     */
+    build(provenance: CodeProvenance): string;
+    /**
+     * Build explanation from generation context
+     */
+    buildFromContext(context: GenerationContext): string;
+    /**
+     * Build brief explanation (one sentence)
+     */
+    buildBrief(provenance: CodeProvenance): string;
+    /**
+     * Build summary section
+     */
+    private buildSummary;
+    /**
+     * Summarize influences
+     */
+    private summarizeInfluences;
+    /**
+     * Summarize warnings
+     */
+    private summarizeWarnings;
+    /**
+     * Summarize constraints
+     */
+    private summarizeConstraints;
+    /**
+     * Summarize anti-patterns
+     */
+    private summarizeAntiPatterns;
+    /**
+     * Build confidence note
+     */
+    private buildConfidenceNote;
+    /**
+     * Group influences by type
+     */
+    private groupInfluencesByType;
+    /**
+     * Format influence type name
+     */
+    private formatInfluenceTypeName;
+    /**
+     * Format constraint name
+     */
+    private formatConstraintName;
+    /**
+     * Update configuration
+     */
+    updateConfig(config: Partial<ExplanationBuilderConfig>): void;
+}
+//# sourceMappingURL=explanation-builder.d.ts.map

package/dist/generation/provenance/explanation-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"explanation-builder.d.ts","sourceRoot":"","sources":["../../../src/generation/provenance/explanation-builder.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAa,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAEhF;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,mBAAmB;IACnB,WAAW,EAAE,OAAO,GAAG,QAAQ,GAAG,UAAU,CAAC;IAC7C,uBAAuB;IACvB,eAAe,EAAE,OAAO,CAAC;IACzB,2BAA2B;IAC3B,mBAAmB,EAAE,OAAO,CAAC;CAC9B;AAWD;;;;GAIG;AACH,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,MAAM,CAA2B;gBAE7B,MAAM,CAAC,EAAE,OAAO,CAAC,wBAAwB,CAAC;IAItD;;OAEG;IACH,KAAK,CAAC,UAAU,EAAE,cAAc,GAAG,MAAM;IAgCzC;;OAEG;IACH,gBAAgB,CAAC,OAAO,EAAE,iBAAiB,GAAG,MAAM;IAiCpD;;OAEG;IACH,UAAU,CAAC,UAAU,EAAE,cAAc,GAAG,MAAM;IA4B9C;;OAEG;IACH,OAAO,CAAC,YAAY;IAWpB;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAqB3B;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAczB;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAU5B;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAU7B;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAY3B;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAc7B;;OAEG;IACH,OAAO,CAAC,uBAAuB;IAmB/B;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAM5B;;OAEG;IACH,YAAY,CAAC,MAAM,EAAE,OAAO,CAAC,wBAAwB,CAAC,GAAG,IAAI;CAG9D"}