driftdetect-cortex 0.9.41

package/dist/embeddings/structural/feature-extractor.d.ts

@@ -0,0 +1,77 @@
+/**
+ * Feature Extractor
+ *
+ * Extracts structural features from AST analysis
+ * for use in structural embeddings.
+ *
+ * @module embeddings/structural/feature-extractor
+ */
+import type { ASTAnalysis, ReturnType, SideEffect } from './ast-analyzer.js';
+/**
+ * Structural features for embedding
+ */
+export interface StructuralFeatures {
+    /** Has async/await patterns */
+    hasAsync: boolean;
+    /** Has error handling (try/catch) */
+    hasErrorHandling: boolean;
+    /** Has loop constructs */
+    hasLoops: boolean;
+    /** Has conditional logic */
+    hasConditionals: boolean;
+    /** Has recursive patterns */
+    hasRecursion: boolean;
+    /** Maximum call depth */
+    callDepth: number;
+    /** Parameter count */
+    paramCount: number;
+    /** Inferred return type */
+    returnType: ReturnType;
+    /** Detected side effects */
+    sideEffects: SideEffect[];
+    /** Cyclomatic complexity estimate */
+    complexity: number;
+    /** AST node count */
+    nodeCount: number;
+    /** Maximum nesting depth */
+    maxNesting: number;
+    /** Detected patterns */
+    patterns: string[];
+}
+/**
+ * Feature extractor configuration
+ */
+export interface FeatureExtractorConfig {
+    /** Maximum patterns to detect */
+    maxPatterns: number;
+    /** Complexity threshold for "complex" classification */
+    complexityThreshold: number;
+    /** Nesting threshold for "deeply nested" classification */
+    nestingThreshold: number;
+}
+/**
+ * Feature extractor for structural embeddings
+ */
+export declare class FeatureExtractor {
+    private config;
+    constructor(config?: Partial<FeatureExtractorConfig>);
+    /**
+     * Extract structural features from AST analysis
+     */
+    extract(analysis: ASTAnalysis, code: string): StructuralFeatures;
+    /**
+     * Detect patterns in code
+     */
+    detectPatterns(analysis: ASTAnalysis, code: string): string[];
+    /**
+     * Convert features to a numeric vector
+     */
+    toVector(features: StructuralFeatures, dimensions: number): number[];
+    /**
+     * Get feature summary as text
+     */
+    summarize(features: StructuralFeatures): string;
+    private hashString;
+    private normalizeVector;
+}
+//# sourceMappingURL=feature-extractor.d.ts.map

package/dist/embeddings/structural/feature-extractor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"feature-extractor.d.ts","sourceRoot":"","sources":["../../../src/embeddings/structural/feature-extractor.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAE7E;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,+BAA+B;IAC/B,QAAQ,EAAE,OAAO,CAAC;IAClB,qCAAqC;IACrC,gBAAgB,EAAE,OAAO,CAAC;IAC1B,0BAA0B;IAC1B,QAAQ,EAAE,OAAO,CAAC;IAClB,4BAA4B;IAC5B,eAAe,EAAE,OAAO,CAAC;IACzB,6BAA6B;IAC7B,YAAY,EAAE,OAAO,CAAC;IACtB,yBAAyB;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,sBAAsB;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,2BAA2B;IAC3B,UAAU,EAAE,UAAU,CAAC;IACvB,4BAA4B;IAC5B,WAAW,EAAE,UAAU,EAAE,CAAC;IAC1B,qCAAqC;IACrC,UAAU,EAAE,MAAM,CAAC;IACnB,qBAAqB;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,4BAA4B;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,wBAAwB;IACxB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,iCAAiC;IACjC,WAAW,EAAE,MAAM,CAAC;IACpB,wDAAwD;IACxD,mBAAmB,EAAE,MAAM,CAAC;IAC5B,2DAA2D;IAC3D,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAoGD;;GAEG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,MAAM,CAAyB;gBAE3B,MAAM,CAAC,EAAE,OAAO,CAAC,sBAAsB,CAAC;IAIpD;;OAEG;IACH,OAAO,CAAC,QAAQ,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,GAAG,kBAAkB;IAoBhE;;OAEG;IACH,cAAc,CAAC,QAAQ,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE;IAc7D;;OAEG;IACH,QAAQ,CAAC,QAAQ,EAAE,kBAAkB,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,EAAE;IAiDpE;;OAEG;IACH,SAAS,CAAC,QAAQ,EAAE,kBAAkB,GAAG,MAAM;IAqB/C,OAAO,CAAC,UAAU;IASlB,OAAO,CAAC,eAAe;CAKxB"}

package/dist/embeddings/structural/feature-extractor.js

@@ -0,0 +1,231 @@
+/**
+ * Feature Extractor
+ *
+ * Extracts structural features from AST analysis
+ * for use in structural embeddings.
+ *
+ * @module embeddings/structural/feature-extractor
+ */
+/**
+ * Default configuration
+ */
+const DEFAULT_CONFIG = {
+    maxPatterns: 10,
+    complexityThreshold: 10,
+    nestingThreshold: 4,
+};
+/**
+ * Pattern definitions for detection
+ */
+const PATTERN_DEFINITIONS = [
+    {
+        name: 'async-await',
+        detect: (analysis) => analysis.hasAsync,
+    },
+    {
+        name: 'error-handling',
+        detect: (analysis) => analysis.hasErrorHandling,
+    },
+    {
+        name: 'iteration',
+        detect: (analysis) => analysis.hasLoops,
+    },
+    {
+        name: 'conditional-logic',
+        detect: (analysis) => analysis.hasConditionals,
+    },
+    {
+        name: 'recursive',
+        detect: (analysis) => analysis.hasRecursion,
+    },
+    {
+        name: 'high-complexity',
+        detect: (analysis) => analysis.complexity > 10,
+    },
+    {
+        name: 'deeply-nested',
+        detect: (analysis) => analysis.maxNesting > 4,
+    },
+    {
+        name: 'side-effects',
+        detect: (analysis) => analysis.sideEffects.length > 0,
+    },
+    {
+        name: 'io-operations',
+        detect: (analysis) => analysis.sideEffects.some(e => e.type === 'io'),
+    },
+    {
+        name: 'network-operations',
+        detect: (analysis) => analysis.sideEffects.some(e => e.type === 'network'),
+    },
+    {
+        name: 'state-mutation',
+        detect: (analysis) => analysis.sideEffects.some(e => e.type === 'mutation'),
+    },
+    {
+        name: 'promise-based',
+        detect: (analysis) => analysis.returnType === 'promise',
+    },
+    {
+        name: 'observable-based',
+        detect: (analysis) => analysis.returnType === 'observable',
+    },
+    {
+        name: 'factory-pattern',
+        detect: (_, code) => /return\s+new\s+\w+/.test(code),
+    },
+    {
+        name: 'builder-pattern',
+        detect: (_, code) => /return\s+this\b/.test(code),
+    },
+    {
+        name: 'singleton-pattern',
+        detect: (_, code) => /static\s+instance|getInstance\s*\(/.test(code),
+    },
+    {
+        name: 'decorator-pattern',
+        detect: (_, code) => /@\w+\s*\(/.test(code),
+    },
+    {
+        name: 'middleware-pattern',
+        detect: (_, code) => /\b(req|request)\s*,\s*(res|response)\s*,\s*(next|done)\b/.test(code),
+    },
+    {
+        name: 'event-handler',
+        detect: (_, code) => /on[A-Z]\w+|handle[A-Z]\w+|\.on\s*\(/.test(code),
+    },
+    {
+        name: 'validation',
+        detect: (_, code) => /validate|isValid|check[A-Z]|assert/.test(code),
+    },
+];
+/**
+ * Feature extractor for structural embeddings
+ */
+export class FeatureExtractor {
+    config;
+    constructor(config) {
+        this.config = { ...DEFAULT_CONFIG, ...config };
+    }
+    /**
+     * Extract structural features from AST analysis
+     */
+    extract(analysis, code) {
+        const patterns = this.detectPatterns(analysis, code);
+        return {
+            hasAsync: analysis.hasAsync,
+            hasErrorHandling: analysis.hasErrorHandling,
+            hasLoops: analysis.hasLoops,
+            hasConditionals: analysis.hasConditionals,
+            hasRecursion: analysis.hasRecursion,
+            callDepth: analysis.callDepth,
+            paramCount: analysis.paramCount,
+            returnType: analysis.returnType,
+            sideEffects: analysis.sideEffects,
+            complexity: analysis.complexity,
+            nodeCount: analysis.nodeCount,
+            maxNesting: analysis.maxNesting,
+            patterns,
+        };
+    }
+    /**
+     * Detect patterns in code
+     */
+    detectPatterns(analysis, code) {
+        const detected = [];
+        for (const pattern of PATTERN_DEFINITIONS) {
+            if (detected.length >= this.config.maxPatterns)
+                break;
+            if (pattern.detect(analysis, code)) {
+                detected.push(pattern.name);
+            }
+        }
+        return detected;
+    }
+    /**
+     * Convert features to a numeric vector
+     */
+    toVector(features, dimensions) {
+        const vector = new Array(dimensions).fill(0);
+        let idx = 0;
+        // Boolean features (normalized to 0/1)
+        vector[idx++] = features.hasAsync ? 1 : 0;
+        vector[idx++] = features.hasErrorHandling ? 1 : 0;
+        vector[idx++] = features.hasLoops ? 1 : 0;
+        vector[idx++] = features.hasConditionals ? 1 : 0;
+        vector[idx++] = features.hasRecursion ? 1 : 0;
+        // Numeric features (normalized)
+        vector[idx++] = Math.min(features.callDepth / 10, 1);
+        vector[idx++] = Math.min(features.paramCount / 10, 1);
+        vector[idx++] = Math.min(features.complexity / 20, 1);
+        vector[idx++] = Math.min(features.nodeCount / 100, 1);
+        vector[idx++] = Math.min(features.maxNesting / 10, 1);
+        // Return type encoding (one-hot style)
+        const returnTypes = ['void', 'primitive', 'object', 'array', 'promise', 'observable', 'unknown'];
+        const returnTypeIdx = returnTypes.indexOf(features.returnType);
+        if (returnTypeIdx >= 0 && idx + returnTypeIdx < dimensions) {
+            vector[idx + returnTypeIdx] = 1;
+        }
+        idx += returnTypes.length;
+        // Side effect encoding
+        const sideEffectTypes = ['io', 'mutation', 'network', 'storage', 'logging', 'unknown'];
+        for (const effect of features.sideEffects) {
+            const effectIdx = sideEffectTypes.indexOf(effect.type);
+            if (effectIdx >= 0 && idx + effectIdx < dimensions) {
+                vector[idx + effectIdx] = Math.max(vector[idx + effectIdx], effect.confidence);
+            }
+        }
+        idx += sideEffectTypes.length;
+        // Pattern encoding (hash-based for remaining dimensions)
+        for (const pattern of features.patterns) {
+            const hash = this.hashString(pattern);
+            const patternIdx = idx + (Math.abs(hash) % (dimensions - idx));
+            if (patternIdx < dimensions) {
+                vector[patternIdx] = 1;
+            }
+        }
+        // Normalize the vector
+        return this.normalizeVector(vector);
+    }
+    /**
+     * Get feature summary as text
+     */
+    summarize(features) {
+        const parts = [];
+        if (features.hasAsync)
+            parts.push('async');
+        if (features.hasErrorHandling)
+            parts.push('error-handling');
+        if (features.hasLoops)
+            parts.push('iterative');
+        if (features.hasRecursion)
+            parts.push('recursive');
+        if (features.complexity > this.config.complexityThreshold)
+            parts.push('complex');
+        if (features.maxNesting > this.config.nestingThreshold)
+            parts.push('deeply-nested');
+        if (features.sideEffects.length > 0) {
+            parts.push(`side-effects(${features.sideEffects.map(e => e.type).join(',')})`);
+        }
+        if (features.patterns.length > 0) {
+            parts.push(`patterns(${features.patterns.slice(0, 3).join(',')})`);
+        }
+        return parts.join(', ') || 'simple';
+    }
+    // Private helpers
+    hashString(str) {
+        let hash = 5381;
+        for (let i = 0; i < str.length; i++) {
+            hash = ((hash << 5) + hash) + str.charCodeAt(i);
+            hash = hash | 0;
+        }
+        return hash;
+    }
+    normalizeVector(vector) {
+        const magnitude = Math.sqrt(vector.reduce((sum, v) => sum + v * v, 0));
+        if (magnitude === 0)
+            return vector;
+        return vector.map(v => v / magnitude);
+    }
+}
+//# sourceMappingURL=feature-extractor.js.map

package/dist/embeddings/structural/feature-extractor.js.map

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

package/dist/embeddings/structural/index.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Structural Embeddings Module
+ *
+ * AST-based structural embeddings for code.
+ * Captures code structure, patterns, and architectural features.
+ *
+ * @module embeddings/structural
+ */
+export { StructuralEmbedder, type StructuralEmbedderConfig, type StructuralEmbeddingResult, } from './embedder.js';
+export { ASTAnalyzer, type ASTNode, type ASTAnalysis, type ReturnType, type SideEffect, } from './ast-analyzer.js';
+export { FeatureExtractor, type FeatureExtractorConfig, type StructuralFeatures, } from './feature-extractor.js';
+export { PatternClassifier, type PatternClassifierConfig, type PatternCategory, type ClassificationResult, } from './pattern-classifier.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/embeddings/structural/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/embeddings/structural/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EACL,kBAAkB,EAClB,KAAK,wBAAwB,EAC7B,KAAK,yBAAyB,GAC/B,MAAM,eAAe,CAAC;AAEvB,OAAO,EACL,WAAW,EACX,KAAK,OAAO,EACZ,KAAK,WAAW,EAChB,KAAK,UAAU,EACf,KAAK,UAAU,GAChB,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EACL,gBAAgB,EAChB,KAAK,sBAAsB,EAC3B,KAAK,kBAAkB,GACxB,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EACL,iBAAiB,EACjB,KAAK,uBAAuB,EAC5B,KAAK,eAAe,EACpB,KAAK,oBAAoB,GAC1B,MAAM,yBAAyB,CAAC"}

package/dist/embeddings/structural/index.js

@@ -0,0 +1,13 @@
+/**
+ * Structural Embeddings Module
+ *
+ * AST-based structural embeddings for code.
+ * Captures code structure, patterns, and architectural features.
+ *
+ * @module embeddings/structural
+ */
+export { StructuralEmbedder, } from './embedder.js';
+export { ASTAnalyzer, } from './ast-analyzer.js';
+export { FeatureExtractor, } from './feature-extractor.js';
+export { PatternClassifier, } from './pattern-classifier.js';
+//# sourceMappingURL=index.js.map

package/dist/embeddings/structural/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/embeddings/structural/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EACL,kBAAkB,GAGnB,MAAM,eAAe,CAAC;AAEvB,OAAO,EACL,WAAW,GAKZ,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EACL,gBAAgB,GAGjB,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EACL,iBAAiB,GAIlB,MAAM,yBAAyB,CAAC"}

package/dist/embeddings/structural/pattern-classifier.d.ts

@@ -0,0 +1,64 @@
+/**
+ * Pattern Classifier
+ *
+ * Classifies code into architectural patterns and
+ * code structure categories for structural embeddings.
+ *
+ * @module embeddings/structural/pattern-classifier
+ */
+import type { StructuralFeatures } from './feature-extractor.js';
+/**
+ * Code pattern category
+ */
+export type PatternCategory = 'controller' | 'service' | 'repository' | 'middleware' | 'validator' | 'transformer' | 'factory' | 'builder' | 'singleton' | 'observer' | 'decorator' | 'utility' | 'handler' | 'hook' | 'component' | 'test' | 'config' | 'unknown';
+/**
+ * Classification result
+ */
+export interface ClassificationResult {
+    /** Primary category */
+    category: PatternCategory;
+    /** Confidence score (0-1) */
+    confidence: number;
+    /** Secondary categories with scores */
+    secondary: Array<{
+        category: PatternCategory;
+        confidence: number;
+    }>;
+    /** Detected architectural patterns */
+    architecturalPatterns: string[];
+    /** Code style indicators */
+    styleIndicators: string[];
+}
+/**
+ * Pattern classifier configuration
+ */
+export interface PatternClassifierConfig {
+    /** Minimum confidence for classification */
+    minConfidence: number;
+    /** Maximum secondary categories to return */
+    maxSecondary: number;
+}
+/**
+ * Pattern classifier for structural embeddings
+ */
+export declare class PatternClassifier {
+    private config;
+    constructor(config?: Partial<PatternClassifierConfig>);
+    /**
+     * Classify code into pattern categories
+     */
+    classify(code: string, features: StructuralFeatures): ClassificationResult;
+    /**
+     * Detect architectural patterns
+     */
+    private detectArchitecturalPatterns;
+    /**
+     * Detect code style indicators
+     */
+    private detectStyleIndicators;
+    /**
+     * Get category embedding vector
+     */
+    getCategoryVector(category: PatternCategory, dimensions: number): number[];
+}
+//# sourceMappingURL=pattern-classifier.d.ts.map

package/dist/embeddings/structural/pattern-classifier.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pattern-classifier.d.ts","sourceRoot":"","sources":["../../../src/embeddings/structural/pattern-classifier.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAEjE;;GAEG;AACH,MAAM,MAAM,eAAe,GACvB,YAAY,GACZ,SAAS,GACT,YAAY,GACZ,YAAY,GACZ,WAAW,GACX,aAAa,GACb,SAAS,GACT,SAAS,GACT,WAAW,GACX,UAAU,GACV,WAAW,GACX,SAAS,GACT,SAAS,GACT,MAAM,GACN,WAAW,GACX,MAAM,GACN,QAAQ,GACR,SAAS,CAAC;AAEd;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,uBAAuB;IACvB,QAAQ,EAAE,eAAe,CAAC;IAC1B,6BAA6B;IAC7B,UAAU,EAAE,MAAM,CAAC;IACnB,uCAAuC;IACvC,SAAS,EAAE,KAAK,CAAC;QAAE,QAAQ,EAAE,eAAe,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACpE,sCAAsC;IACtC,qBAAqB,EAAE,MAAM,EAAE,CAAC;IAChC,4BAA4B;IAC5B,eAAe,EAAE,MAAM,EAAE,CAAC;CAC3B;AAED;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,4CAA4C;IAC5C,aAAa,EAAE,MAAM,CAAC;IACtB,6CAA6C;IAC7C,YAAY,EAAE,MAAM,CAAC;CACtB;AAyMD;;GAEG;AACH,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,MAAM,CAA0B;gBAE5B,MAAM,CAAC,EAAE,OAAO,CAAC,uBAAuB,CAAC;IAIrD;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,kBAAkB,GAAG,oBAAoB;IA2D1E;;OAEG;IACH,OAAO,CAAC,2BAA2B;IAyCnC;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAsC7B;;OAEG;IACH,iBAAiB,CAAC,QAAQ,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,EAAE;CAgB3E"}