driftdetect-cortex 0.9.41

package/dist/embeddings/hybrid/embedder.d.ts

@@ -0,0 +1,141 @@
+/**
+ * Hybrid Embedder
+ *
+ * Combines structural, semantic, and lexical embeddings
+ * into a unified hybrid embedding for code understanding.
+ *
+ * @module embeddings/hybrid/embedder
+ */
+import type { IEmbeddingProvider } from '../interface.js';
+import { StructuralEmbedder, type StructuralEmbedderConfig } from '../structural/index.js';
+import { SemanticEmbedder, type SemanticEmbedderConfig } from '../semantic/index.js';
+import { LexicalEmbedder, type LexicalEmbedderConfig } from '../lexical/index.js';
+import { type FusionLayerConfig, type FusionStrategy } from './fusion.js';
+import { WeightManager, type FusionWeights, type WeightPreset } from './weights.js';
+/**
+ * Hybrid embedder configuration
+ */
+export interface HybridEmbedderConfig {
+    /** Output dimensions */
+    dimensions: number;
+    /** Structural embedder config */
+    structural?: Partial<StructuralEmbedderConfig>;
+    /** Semantic embedder config */
+    semantic?: Partial<SemanticEmbedderConfig>;
+    /** Lexical embedder config */
+    lexical?: Partial<LexicalEmbedderConfig>;
+    /** Fusion layer config */
+    fusion?: Partial<FusionLayerConfig>;
+    /** Default weight preset */
+    defaultWeightPreset: WeightPreset;
+    /** Maximum tokens per input */
+    maxTokens: number;
+}
+/**
+ * Embedding context for customization
+ */
+export interface EmbeddingContext {
+    /** Language of the code */
+    language?: string;
+    /** Weight preset to use */
+    weightPreset?: WeightPreset;
+    /** Custom weights */
+    weights?: FusionWeights;
+    /** Fusion strategy */
+    fusionStrategy?: FusionStrategy;
+}
+/**
+ * Detailed embedding result
+ */
+export interface HybridEmbeddingResult {
+    /** Combined embedding */
+    embedding: number[];
+    /** Individual embeddings */
+    components: {
+        structural: number[];
+        semantic: number[];
+        lexical: number[];
+    };
+    /** Contribution from each component */
+    contributions: {
+        structural: number;
+        semantic: number;
+        lexical: number;
+    };
+    /** Weights used */
+    weights: FusionWeights;
+}
+/**
+ * Hybrid embedder combining three embedding types
+ *
+ * Combines:
+ * - Structural (128 dims): AST patterns, complexity, architecture
+ * - Semantic (512 dims): CodeBERT-based meaning understanding
+ * - Lexical (128 dims): TF-IDF term frequencies
+ *
+ * Total: 768 dimensions (configurable)
+ */
+export declare class HybridEmbedder implements IEmbeddingProvider {
+    readonly name = "hybrid";
+    readonly dimensions: number;
+    readonly maxTokens: number;
+    private config;
+    private structural;
+    private semantic;
+    private lexical;
+    private fusion;
+    private weightManager;
+    private initialized;
+    constructor(config?: Partial<HybridEmbedderConfig>);
+    /**
+     * Initialize all component embedders
+     */
+    initialize(): Promise<void>;
+    /**
+     * Generate hybrid embedding for text/code
+     */
+    embed(text: string, context?: EmbeddingContext): Promise<number[]>;
+    /**
+     * Generate hybrid embedding with full details
+     */
+    embedWithDetails(text: string, context?: EmbeddingContext): Promise<HybridEmbeddingResult>;
+    /**
+     * Generate embeddings for multiple texts
+     */
+    embedBatch(texts: string[], context?: EmbeddingContext): Promise<number[][]>;
+    /**
+     * Hybrid search with customizable weights
+     */
+    hybridSearch(query: string, candidates: Array<{
+        id: string;
+        code: string;
+    }>, options?: {
+        weights?: FusionWeights;
+        topK?: number;
+        language?: string;
+    }): Promise<Array<{
+        id: string;
+        code: string;
+        score: number;
+        breakdown: FusionWeights;
+    }>>;
+    /**
+     * Check if embedder is available
+     */
+    isAvailable(): Promise<boolean>;
+    /**
+     * Get weight manager for customization
+     */
+    getWeightManager(): WeightManager;
+    /**
+     * Get component embedders for direct access
+     */
+    getComponents(): {
+        structural: StructuralEmbedder;
+        semantic: SemanticEmbedder;
+        lexical: LexicalEmbedder;
+    };
+    private getWeights;
+    private cosineSimilarity;
+}
+//# sourceMappingURL=embedder.d.ts.map

package/dist/embeddings/hybrid/embedder.d.ts.map

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

package/dist/embeddings/hybrid/embedder.js

@@ -0,0 +1,231 @@
+/**
+ * Hybrid Embedder
+ *
+ * Combines structural, semantic, and lexical embeddings
+ * into a unified hybrid embedding for code understanding.
+ *
+ * @module embeddings/hybrid/embedder
+ */
+import { StructuralEmbedder } from '../structural/index.js';
+import { SemanticEmbedder } from '../semantic/index.js';
+import { LexicalEmbedder } from '../lexical/index.js';
+import { FusionLayer } from './fusion.js';
+import { WeightManager } from './weights.js';
+/**
+ * Default configuration
+ */
+const DEFAULT_CONFIG = {
+    dimensions: 768,
+    defaultWeightPreset: 'balanced',
+    maxTokens: 8192,
+};
+/**
+ * Hybrid embedder combining three embedding types
+ *
+ * Combines:
+ * - Structural (128 dims): AST patterns, complexity, architecture
+ * - Semantic (512 dims): CodeBERT-based meaning understanding
+ * - Lexical (128 dims): TF-IDF term frequencies
+ *
+ * Total: 768 dimensions (configurable)
+ */
+export class HybridEmbedder {
+    name = 'hybrid';
+    dimensions;
+    maxTokens;
+    config;
+    structural;
+    semantic;
+    lexical;
+    fusion;
+    weightManager;
+    initialized = false;
+    constructor(config) {
+        this.config = { ...DEFAULT_CONFIG, ...config };
+        this.dimensions = this.config.dimensions;
+        this.maxTokens = this.config.maxTokens;
+        // Initialize component embedders
+        this.structural = new StructuralEmbedder({
+            dimensions: 128,
+            ...this.config.structural,
+        });
+        this.semantic = new SemanticEmbedder({
+            dimensions: 512,
+            ...this.config.semantic,
+        });
+        this.lexical = new LexicalEmbedder({
+            dimensions: 128,
+            ...this.config.lexical,
+        });
+        // Initialize fusion layer
+        this.fusion = new FusionLayer({
+            outputDimensions: this.dimensions,
+            ...this.config.fusion,
+        });
+        // Initialize weight manager
+        this.weightManager = new WeightManager();
+    }
+    /**
+     * Initialize all component embedders
+     */
+    async initialize() {
+        if (this.initialized)
+            return;
+        await Promise.all([
+            this.structural.initialize(),
+            this.semantic.initialize(),
+            this.lexical.initialize(),
+        ]);
+        this.initialized = true;
+    }
+    /**
+     * Generate hybrid embedding for text/code
+     */
+    async embed(text, context) {
+        const result = await this.embedWithDetails(text, context);
+        return result.embedding;
+    }
+    /**
+     * Generate hybrid embedding with full details
+     */
+    async embedWithDetails(text, context) {
+        if (!this.initialized) {
+            await this.initialize();
+        }
+        const language = context?.language ?? 'typescript';
+        // Generate component embeddings in parallel
+        const [structuralEmb, semanticEmb, lexicalEmb] = await Promise.all([
+            Promise.resolve(this.structural.embed(text, language)),
+            this.semantic.embed(text),
+            Promise.resolve(this.lexical.embed(text)),
+        ]);
+        // Sanitize embeddings (replace NaN with 0)
+        const sanitize = (arr) => arr.map(v => isFinite(v) ? v : 0);
+        const sanitizedStructural = sanitize(structuralEmb);
+        const sanitizedSemantic = sanitize(semanticEmb);
+        const sanitizedLexical = sanitize(lexicalEmb);
+        // Get weights
+        const weights = this.getWeights(context);
+        // Fuse embeddings
+        const fusionResult = this.fusion.fuseWithDetails(sanitizedStructural, sanitizedSemantic, sanitizedLexical, weights);
+        // Sanitize final embedding
+        const sanitizedEmbedding = sanitize(fusionResult.embedding);
+        return {
+            embedding: sanitizedEmbedding,
+            components: {
+                structural: sanitizedStructural,
+                semantic: sanitizedSemantic,
+                lexical: sanitizedLexical,
+            },
+            contributions: fusionResult.contributions,
+            weights,
+        };
+    }
+    /**
+     * Generate embeddings for multiple texts
+     */
+    async embedBatch(texts, context) {
+        if (!this.initialized) {
+            await this.initialize();
+        }
+        return Promise.all(texts.map(text => this.embed(text, context)));
+    }
+    /**
+     * Hybrid search with customizable weights
+     */
+    async hybridSearch(query, candidates, options) {
+        const { weights, topK = 10, language = 'typescript' } = options ?? {};
+        // Build context, only including weights if defined
+        const context = { language };
+        if (weights) {
+            context.weights = weights;
+        }
+        // Get query embedding
+        const queryResult = await this.embedWithDetails(query, context);
+        // Score candidates
+        const scored = await Promise.all(candidates.map(async (candidate) => {
+            const candidateResult = await this.embedWithDetails(candidate.code, context);
+            // Calculate overall similarity
+            const score = this.cosineSimilarity(queryResult.embedding, candidateResult.embedding);
+            // Calculate per-component similarity for breakdown
+            const breakdown = {
+                structural: this.cosineSimilarity(queryResult.components.structural, candidateResult.components.structural),
+                semantic: this.cosineSimilarity(queryResult.components.semantic, candidateResult.components.semantic),
+                lexical: this.cosineSimilarity(queryResult.components.lexical, candidateResult.components.lexical),
+            };
+            return {
+                id: candidate.id,
+                code: candidate.code,
+                score,
+                breakdown,
+            };
+        }));
+        // Sort by score and return top K
+        scored.sort((a, b) => b.score - a.score);
+        return scored.slice(0, topK);
+    }
+    /**
+     * Check if embedder is available
+     */
+    async isAvailable() {
+        try {
+            if (!this.initialized) {
+                await this.initialize();
+            }
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * Get weight manager for customization
+     */
+    getWeightManager() {
+        return this.weightManager;
+    }
+    /**
+     * Get component embedders for direct access
+     */
+    getComponents() {
+        return {
+            structural: this.structural,
+            semantic: this.semantic,
+            lexical: this.lexical,
+        };
+    }
+    // Private helpers
+    getWeights(context) {
+        if (context?.weights) {
+            return this.weightManager.normalizeWeights(context.weights);
+        }
+        if (context?.weightPreset) {
+            return this.weightManager.getPreset(context.weightPreset);
+        }
+        return this.weightManager.getPreset(this.config.defaultWeightPreset);
+    }
+    cosineSimilarity(a, b) {
+        if (a.length !== b.length) {
+            // Adjust dimensions if needed
+            const minLen = Math.min(a.length, b.length);
+            a = a.slice(0, minLen);
+            b = b.slice(0, minLen);
+        }
+        let dotProduct = 0;
+        let normA = 0;
+        let normB = 0;
+        for (let i = 0; i < a.length; i++) {
+            const aVal = a[i] ?? 0;
+            const bVal = b[i] ?? 0;
+            dotProduct += aVal * bVal;
+            normA += aVal * aVal;
+            normB += bVal * bVal;
+        }
+        const magnitude = Math.sqrt(normA) * Math.sqrt(normB);
+        if (magnitude === 0 || !isFinite(magnitude))
+            return 0;
+        const result = dotProduct / magnitude;
+        return isFinite(result) ? result : 0;
+    }
+}
+//# sourceMappingURL=embedder.js.map

package/dist/embeddings/hybrid/embedder.js.map

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

package/dist/embeddings/hybrid/fusion.d.ts

@@ -0,0 +1,75 @@
+/**
+ * Fusion Layer
+ *
+ * Fuses multiple embedding types into a single hybrid embedding.
+ * Supports weighted combination and various fusion strategies.
+ *
+ * @module embeddings/hybrid/fusion
+ */
+import type { FusionWeights } from './weights.js';
+/**
+ * Fusion strategy
+ */
+export type FusionStrategy = 'concatenate' | 'weighted-sum' | 'attention' | 'gated';
+/**
+ * Fusion layer configuration
+ */
+export interface FusionLayerConfig {
+    /** Fusion strategy */
+    strategy: FusionStrategy;
+    /** Output dimensions */
+    outputDimensions: number;
+    /** Whether to normalize output */
+    normalize: boolean;
+}
+/**
+ * Fusion result with metadata
+ */
+export interface FusionResult {
+    /** Fused embedding */
+    embedding: number[];
+    /** Contribution from each component */
+    contributions: {
+        structural: number;
+        semantic: number;
+        lexical: number;
+    };
+    /** Strategy used */
+    strategy: FusionStrategy;
+}
+/**
+ * Fusion layer for combining embeddings
+ */
+export declare class FusionLayer {
+    private config;
+    constructor(config?: Partial<FusionLayerConfig>);
+    /**
+     * Fuse multiple embeddings into one
+     */
+    fuse(structural: number[], semantic: number[], lexical: number[], weights: FusionWeights): number[];
+    /**
+     * Fuse with detailed results
+     */
+    fuseWithDetails(structural: number[], semantic: number[], lexical: number[], weights: FusionWeights): FusionResult;
+    /**
+     * Concatenate embeddings with weighted scaling
+     */
+    private concatenate;
+    /**
+     * Weighted sum of embeddings (requires same dimensions)
+     */
+    private weightedSum;
+    /**
+     * Attention-based fusion
+     */
+    private attentionFusion;
+    /**
+     * Gated fusion with learned-like gates
+     */
+    private gatedFusion;
+    private adjustDimensions;
+    private normalizeVector;
+    private magnitude;
+    private sigmoid;
+}
+//# sourceMappingURL=fusion.d.ts.map

package/dist/embeddings/hybrid/fusion.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fusion.d.ts","sourceRoot":"","sources":["../../../src/embeddings/hybrid/fusion.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAElD;;GAEG;AACH,MAAM,MAAM,cAAc,GACtB,aAAa,GACb,cAAc,GACd,WAAW,GACX,OAAO,CAAC;AAEZ;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,sBAAsB;IACtB,QAAQ,EAAE,cAAc,CAAC;IACzB,wBAAwB;IACxB,gBAAgB,EAAE,MAAM,CAAC;IACzB,kCAAkC;IAClC,SAAS,EAAE,OAAO,CAAC;CACpB;AAWD;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,sBAAsB;IACtB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,uCAAuC;IACvC,aAAa,EAAE;QACb,UAAU,EAAE,MAAM,CAAC;QACnB,QAAQ,EAAE,MAAM,CAAC;QACjB,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC;IACF,oBAAoB;IACpB,QAAQ,EAAE,cAAc,CAAC;CAC1B;AAED;;GAEG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,MAAM,CAAoB;gBAEtB,MAAM,CAAC,EAAE,OAAO,CAAC,iBAAiB,CAAC;IAI/C;;OAEG;IACH,IAAI,CACF,UAAU,EAAE,MAAM,EAAE,EACpB,QAAQ,EAAE,MAAM,EAAE,EAClB,OAAO,EAAE,MAAM,EAAE,EACjB,OAAO,EAAE,aAAa,GACrB,MAAM,EAAE;IAKX;;OAEG;IACH,eAAe,CACb,UAAU,EAAE,MAAM,EAAE,EACpB,QAAQ,EAAE,MAAM,EAAE,EAClB,OAAO,EAAE,MAAM,EAAE,EACjB,OAAO,EAAE,aAAa,GACrB,YAAY;IA8Cf;;OAEG;IACH,OAAO,CAAC,WAAW;IA8BnB;;OAEG;IACH,OAAO,CAAC,WAAW;IA+BnB;;OAEG;IACH,OAAO,CAAC,eAAe;IA6CvB;;OAEG;IACH,OAAO,CAAC,WAAW;IAkDnB,OAAO,CAAC,gBAAgB;IAkCxB,OAAO,CAAC,eAAe;IAMvB,OAAO,CAAC,SAAS;IAIjB,OAAO,CAAC,OAAO;CAGhB"}