@sparkleideas/cli 3.1.0-alpha.19 → 3.1.0-alpha.21

package/dist/src/ruvector/lora-adapter.js

@@ -0,0 +1,455 @@
+/**
+ * LoRA (Low-Rank Adaptation) Implementation
+ *
+ * Enables efficient fine-tuning by decomposing weight updates into low-rank matrices.
+ * Dramatically reduces memory requirements while maintaining adaptation quality.
+ *
+ * Features:
+ * - Rank decomposition (r << d) for memory efficiency
+ * - Additive weight updates: W' = W + BA (where B ∈ R^{d×r}, A ∈ R^{r×k})
+ * - Support for multiple adaptation heads
+ * - Persistence to .swarm/lora-weights.json
+ *
+ * Memory savings:
+ * - Original: d × k parameters
+ * - LoRA: r × (d + k) parameters
+ * - For d=384, k=384, r=8: 786,432 → 6,144 (128x reduction)
+ *
+ * @module lora-adapter
+ */
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'fs';
+import { dirname, join } from 'path';
+// ============================================================================
+// Types & Constants
+// ============================================================================
+/**
+ * Default LoRA rank (determines memory/quality tradeoff)
+ */
+export const DEFAULT_RANK = 8;
+/**
+ * Input dimension (384 from ONNX MiniLM-L6-v2)
+ */
+export const INPUT_DIM = 384;
+/**
+ * Default output dimension (same as input for adapter)
+ */
+export const OUTPUT_DIM = 384;
+/**
+ * Default alpha scaling factor
+ */
+export const DEFAULT_ALPHA = 16;
+// ============================================================================
+// Default Configuration
+// ============================================================================
+const DEFAULT_CONFIG = {
+    rank: DEFAULT_RANK,
+    alpha: DEFAULT_ALPHA,
+    inputDim: INPUT_DIM,
+    outputDim: OUTPUT_DIM,
+    learningRate: 0.001,
+    weightsPath: join(process.cwd(), '.swarm', 'lora-weights.json'),
+    enableDropout: true,
+    dropoutProb: 0.1,
+    autoSaveInterval: 50,
+};
+// ============================================================================
+// LoRA Adapter Class
+// ============================================================================
+/**
+ * Low-Rank Adaptation module for efficient embedding fine-tuning
+ */
+export class LoRAAdapter {
+    config;
+    weights;
+    totalAdaptations = 0;
+    totalUpdates = 0;
+    adaptationNormSum = 0;
+    lastUpdate = null;
+    updatesSinceLastSave = 0;
+    constructor(config) {
+        this.config = { ...DEFAULT_CONFIG, ...config };
+        this.weights = this.initializeWeights();
+    }
+    /**
+     * Initialize weights with Kaiming/He initialization
+     */
+    initializeWeights() {
+        const { rank, inputDim, outputDim, alpha } = this.config;
+        // A: rank × inputDim, initialized with Kaiming normal
+        const A = new Float32Array(rank * inputDim);
+        const stdA = Math.sqrt(2.0 / inputDim);
+        for (let i = 0; i < A.length; i++) {
+            A[i] = this.gaussianRandom() * stdA;
+        }
+        // B: outputDim × rank, initialized to zero (standard LoRA init)
+        const B = new Float32Array(outputDim * rank);
+        // B starts at zero so initial adaptation is zero
+        return {
+            A,
+            B,
+            scaling: alpha / rank,
+        };
+    }
+    /**
+     * Box-Muller transform for Gaussian random numbers
+     */
+    gaussianRandom() {
+        let u = 0, v = 0;
+        while (u === 0)
+            u = Math.random();
+        while (v === 0)
+            v = Math.random();
+        return Math.sqrt(-2.0 * Math.log(u)) * Math.cos(2.0 * Math.PI * v);
+    }
+    /**
+     * Initialize adapter and load persisted weights
+     */
+    async initialize() {
+        const loaded = this.loadWeights();
+        return { success: true, weightsLoaded: loaded };
+    }
+    /**
+     * Apply LoRA adaptation to an embedding
+     * output = input + scaling * (B @ A @ input)
+     */
+    adapt(input) {
+        const startTime = performance.now();
+        const { rank, inputDim, outputDim } = this.config;
+        const { A, B, scaling } = this.weights;
+        // Step 1: Compute A @ input (rank-dimensional)
+        const hidden = new Float32Array(rank);
+        for (let r = 0; r < rank; r++) {
+            let sum = 0;
+            const rowOffset = r * inputDim;
+            // Unroll by 4 for SIMD-friendly access
+            let i = 0;
+            for (; i + 3 < inputDim; i += 4) {
+                sum += A[rowOffset + i] * input[i];
+                sum += A[rowOffset + i + 1] * input[i + 1];
+                sum += A[rowOffset + i + 2] * input[i + 2];
+                sum += A[rowOffset + i + 3] * input[i + 3];
+            }
+            for (; i < inputDim; i++) {
+                sum += A[rowOffset + i] * input[i];
+            }
+            hidden[r] = sum;
+        }
+        // Optional dropout (during training inference, skip)
+        // In LoRA inference, we don't apply dropout
+        // Step 2: Compute B @ hidden (outputDim-dimensional)
+        const delta = new Float32Array(outputDim);
+        for (let o = 0; o < outputDim; o++) {
+            let sum = 0;
+            const rowOffset = o * rank;
+            for (let r = 0; r < rank; r++) {
+                sum += B[rowOffset + r] * hidden[r];
+            }
+            delta[o] = sum * scaling;
+        }
+        // Step 3: Add adaptation to input
+        const adapted = new Float32Array(outputDim);
+        let adaptationNorm = 0;
+        for (let i = 0; i < outputDim; i++) {
+            adapted[i] = input[i] + delta[i];
+            adaptationNorm += delta[i] * delta[i];
+        }
+        adaptationNorm = Math.sqrt(adaptationNorm);
+        // Update stats
+        this.totalAdaptations++;
+        this.adaptationNormSum += adaptationNorm;
+        const timeMs = performance.now() - startTime;
+        return { adapted, adaptationNorm, timeMs };
+    }
+    /**
+     * Train the adapter with a gradient signal
+     * Uses simplified update: A += lr * hidden^T @ grad, B += lr * grad @ hidden^T
+     */
+    train(input, gradOutput, reward = 1.0) {
+        const { rank, inputDim, outputDim, learningRate } = this.config;
+        const { A, B, scaling } = this.weights;
+        // Forward pass to get hidden states
+        const hidden = new Float32Array(rank);
+        for (let r = 0; r < rank; r++) {
+            let sum = 0;
+            const rowOffset = r * inputDim;
+            for (let i = 0; i < inputDim; i++) {
+                sum += A[rowOffset + i] * input[i];
+            }
+            hidden[r] = sum;
+        }
+        // Compute gradient for B: grad_B = gradOutput @ hidden^T
+        const scaledLr = learningRate * reward * scaling;
+        for (let o = 0; o < outputDim; o++) {
+            const rowOffset = o * rank;
+            for (let r = 0; r < rank; r++) {
+                B[rowOffset + r] += scaledLr * gradOutput[o] * hidden[r];
+            }
+        }
+        // Compute gradient for hidden: grad_hidden = B^T @ gradOutput
+        const gradHidden = new Float32Array(rank);
+        for (let r = 0; r < rank; r++) {
+            let sum = 0;
+            for (let o = 0; o < outputDim; o++) {
+                sum += B[o * rank + r] * gradOutput[o];
+            }
+            gradHidden[r] = sum;
+        }
+        // Compute gradient for A: grad_A = gradHidden @ input^T
+        for (let r = 0; r < rank; r++) {
+            const rowOffset = r * inputDim;
+            for (let i = 0; i < inputDim; i++) {
+                A[rowOffset + i] += scaledLr * gradHidden[r] * input[i];
+            }
+        }
+        // Compute loss (L2 norm of gradient)
+        let loss = 0;
+        for (let i = 0; i < gradOutput.length; i++) {
+            loss += gradOutput[i] * gradOutput[i];
+        }
+        loss = Math.sqrt(loss);
+        // Update counters
+        this.totalUpdates++;
+        this.lastUpdate = Date.now();
+        this.updatesSinceLastSave++;
+        // Auto-save if needed
+        if (this.updatesSinceLastSave >= this.config.autoSaveInterval) {
+            this.saveWeights();
+            this.updatesSinceLastSave = 0;
+        }
+        return { updated: true, loss };
+    }
+    /**
+     * Merge LoRA weights into base weights (for deployment)
+     * Returns: W' = W + scaling * B @ A
+     */
+    merge(baseWeights) {
+        const { rank, inputDim, outputDim } = this.config;
+        const { A, B, scaling } = this.weights;
+        // Compute BA product
+        const merged = new Float32Array(baseWeights);
+        for (let o = 0; o < outputDim; o++) {
+            for (let i = 0; i < inputDim; i++) {
+                let sum = 0;
+                for (let r = 0; r < rank; r++) {
+                    sum += B[o * rank + r] * A[r * inputDim + i];
+                }
+                merged[o * inputDim + i] += scaling * sum;
+            }
+        }
+        return merged;
+    }
+    /**
+     * Get current statistics
+     */
+    getStats() {
+        const { rank, inputDim, outputDim } = this.config;
+        const originalParams = inputDim * outputDim;
+        const loraParams = rank * (inputDim + outputDim);
+        return {
+            totalAdaptations: this.totalAdaptations,
+            totalUpdates: this.totalUpdates,
+            rank: this.config.rank,
+            compressionRatio: originalParams / loraParams,
+            avgAdaptationNorm: this.totalAdaptations > 0
+                ? this.adaptationNormSum / this.totalAdaptations
+                : 0,
+            lastUpdate: this.lastUpdate,
+        };
+    }
+    /**
+     * Reset adapter to initial state
+     */
+    reset() {
+        this.weights = this.initializeWeights();
+        this.totalAdaptations = 0;
+        this.totalUpdates = 0;
+        this.adaptationNormSum = 0;
+        this.lastUpdate = null;
+        this.updatesSinceLastSave = 0;
+    }
+    /**
+     * Save weights to disk
+     */
+    saveWeights() {
+        try {
+            const dir = dirname(this.config.weightsPath);
+            if (!existsSync(dir)) {
+                mkdirSync(dir, { recursive: true });
+            }
+            const data = {
+                version: 1,
+                config: {
+                    rank: this.config.rank,
+                    alpha: this.config.alpha,
+                    inputDim: this.config.inputDim,
+                    outputDim: this.config.outputDim,
+                },
+                weights: {
+                    A: Array.from(this.weights.A),
+                    B: Array.from(this.weights.B),
+                    scaling: this.weights.scaling,
+                },
+                stats: {
+                    totalAdaptations: this.totalAdaptations,
+                    totalUpdates: this.totalUpdates,
+                    adaptationNormSum: this.adaptationNormSum,
+                    lastUpdate: this.lastUpdate,
+                },
+                savedAt: new Date().toISOString(),
+            };
+            writeFileSync(this.config.weightsPath, JSON.stringify(data, null, 2));
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * Load weights from disk
+     */
+    loadWeights() {
+        try {
+            if (!existsSync(this.config.weightsPath)) {
+                return false;
+            }
+            const content = readFileSync(this.config.weightsPath, 'utf-8');
+            const data = JSON.parse(content);
+            if (data.version !== 1) {
+                return false;
+            }
+            // Verify dimensions match
+            const { rank, inputDim, outputDim } = data.config;
+            if (rank !== this.config.rank ||
+                inputDim !== this.config.inputDim ||
+                outputDim !== this.config.outputDim) {
+                return false;
+            }
+            // Load weights
+            this.weights = {
+                A: new Float32Array(data.weights.A),
+                B: new Float32Array(data.weights.B),
+                scaling: data.weights.scaling,
+            };
+            // Load stats
+            this.totalAdaptations = data.stats.totalAdaptations || 0;
+            this.totalUpdates = data.stats.totalUpdates || 0;
+            this.adaptationNormSum = data.stats.adaptationNormSum || 0;
+            this.lastUpdate = data.stats.lastUpdate || null;
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * Export weights as JSON
+     */
+    exportWeights() {
+        return {
+            A: Array.from(this.weights.A),
+            B: Array.from(this.weights.B),
+            scaling: this.weights.scaling,
+            config: {
+                rank: this.config.rank,
+                alpha: this.config.alpha,
+                inputDim: this.config.inputDim,
+                outputDim: this.config.outputDim,
+            },
+        };
+    }
+    /**
+     * Import weights from JSON
+     */
+    importWeights(data) {
+        try {
+            const { rank, inputDim, outputDim } = this.config;
+            if (data.A.length !== rank * inputDim ||
+                data.B.length !== outputDim * rank) {
+                return false;
+            }
+            this.weights = {
+                A: new Float32Array(data.A),
+                B: new Float32Array(data.B),
+                scaling: data.scaling,
+            };
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+}
+// ============================================================================
+// Singleton & Factory Functions
+// ============================================================================
+let loraInstance = null;
+let initPromise = null;
+/**
+ * Get or create singleton LoRA adapter instance
+ */
+export async function getLoRAAdapter() {
+    if (loraInstance) {
+        return loraInstance;
+    }
+    if (initPromise) {
+        return initPromise;
+    }
+    initPromise = (async () => {
+        const adapter = new LoRAAdapter();
+        await adapter.initialize();
+        loraInstance = adapter;
+        return adapter;
+    })();
+    return initPromise;
+}
+/**
+ * Reset singleton instance (for testing)
+ */
+export function resetLoRAAdapter() {
+    if (loraInstance) {
+        loraInstance.reset();
+    }
+    loraInstance = null;
+    initPromise = null;
+}
+/**
+ * Create new LoRA adapter instance (factory)
+ */
+export function createLoRAAdapter(config) {
+    return new LoRAAdapter(config);
+}
+/**
+ * Quick adaptation (convenience function)
+ */
+export async function adaptEmbedding(input) {
+    const adapter = await getLoRAAdapter();
+    return adapter.adapt(input);
+}
+/**
+ * Quick training (convenience function)
+ */
+export async function trainLoRA(input, gradOutput, reward) {
+    const adapter = await getLoRAAdapter();
+    return adapter.train(input, gradOutput, reward);
+}
+/**
+ * Get LoRA statistics (convenience function)
+ */
+export async function getLoRAStats() {
+    const adapter = await getLoRAAdapter();
+    return adapter.getStats();
+}
+export default {
+    LoRAAdapter,
+    getLoRAAdapter,
+    resetLoRAAdapter,
+    createLoRAAdapter,
+    adaptEmbedding,
+    trainLoRA,
+    getLoRAStats,
+    DEFAULT_RANK,
+    DEFAULT_ALPHA,
+    INPUT_DIM,
+    OUTPUT_DIM,
+};
+//# sourceMappingURL=lora-adapter.js.map

package/dist/src/ruvector/lora-adapter.js.map

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

package/dist/src/ruvector/model-router.d.ts

@@ -0,0 +1,220 @@
+/**
+ * Intelligent Model Router using Tiny Dancer
+ *
+ * Dynamically routes requests to optimal Claude model (haiku/sonnet/opus)
+ * based on task complexity, confidence scores, and historical performance.
+ *
+ * Features:
+ * - FastGRNN-based routing decisions (<100μs)
+ * - Uncertainty quantification for model escalation
+ * - Circuit breaker for failover
+ * - Online learning from routing outcomes
+ * - Complexity scoring via embeddings
+ *
+ * Routing Strategy:
+ * - Haiku: High confidence, low complexity (fast, cheap)
+ * - Sonnet: Medium confidence, moderate complexity (balanced)
+ * - Opus: Low confidence, high complexity (most capable)
+ *
+ * @module model-router
+ */
+/**
+ * Available Claude models for routing
+ */
+export type ClaudeModel = 'haiku' | 'sonnet' | 'opus' | 'inherit';
+/**
+ * Model capabilities and characteristics
+ */
+export declare const MODEL_CAPABILITIES: Record<ClaudeModel, {
+    maxComplexity: number;
+    costMultiplier: number;
+    speedMultiplier: number;
+    description: string;
+}>;
+/**
+ * Complexity indicators for task classification
+ */
+export declare const COMPLEXITY_INDICATORS: {
+    high: string[];
+    medium: string[];
+    low: string[];
+};
+/**
+ * Model router configuration
+ */
+export interface ModelRouterConfig {
+    /** Confidence threshold for model selection (default: 0.85) */
+    confidenceThreshold: number;
+    /** Maximum uncertainty before escalating (default: 0.15) */
+    maxUncertainty: number;
+    /** Enable circuit breaker (default: true) */
+    enableCircuitBreaker: boolean;
+    /** Failures before circuit opens (default: 5) */
+    circuitBreakerThreshold: number;
+    /** Path for router state persistence */
+    statePath: string;
+    /** Auto-save interval in decisions (default: 20) */
+    autoSaveInterval: number;
+    /** Enable cost optimization (default: true) */
+    enableCostOptimization: boolean;
+    /** Prefer faster models when confidence is high (default: true) */
+    preferSpeed: boolean;
+}
+/**
+ * Routing decision result
+ */
+export interface ModelRoutingResult {
+    /** Selected model */
+    model: ClaudeModel;
+    /** Confidence in the decision (0-1) */
+    confidence: number;
+    /** Uncertainty estimate (0-1) */
+    uncertainty: number;
+    /** Computed complexity score (0-1) */
+    complexity: number;
+    /** Reasoning for the selection */
+    reasoning: string;
+    /** Alternative models considered */
+    alternatives: Array<{
+        model: ClaudeModel;
+        score: number;
+    }>;
+    /** Inference time in microseconds */
+    inferenceTimeUs: number;
+    /** Estimated cost multiplier */
+    costMultiplier: number;
+}
+/**
+ * Complexity analysis result
+ */
+export interface ComplexityAnalysis {
+    /** Overall complexity score (0-1) */
+    score: number;
+    /** Indicators found */
+    indicators: {
+        high: string[];
+        medium: string[];
+        low: string[];
+    };
+    /** Feature breakdown */
+    features: {
+        lexicalComplexity: number;
+        semanticDepth: number;
+        taskScope: number;
+        uncertaintyLevel: number;
+    };
+}
+/**
+ * Intelligent Model Router using complexity-based routing
+ */
+export declare class ModelRouter {
+    private config;
+    private state;
+    private decisionCount;
+    private consecutiveFailures;
+    constructor(config?: Partial<ModelRouterConfig>);
+    /**
+     * Route a task to the optimal model
+     */
+    route(task: string, embedding?: number[]): Promise<ModelRoutingResult>;
+    /**
+     * Analyze task complexity
+     */
+    analyzeComplexity(task: string, embedding?: number[]): ComplexityAnalysis;
+    /**
+     * Compute lexical complexity from text features
+     */
+    private computeLexicalComplexity;
+    /**
+     * Compute semantic depth from indicators and embedding
+     */
+    private computeSemanticDepth;
+    /**
+     * Compute task scope from content analysis
+     */
+    private computeTaskScope;
+    /**
+     * Compute uncertainty level from task phrasing
+     */
+    private computeUncertaintyLevel;
+    /**
+     * Compute scores for each model
+     */
+    private computeModelScores;
+    /**
+     * Apply circuit breaker adjustments
+     */
+    private applyCircuitBreaker;
+    /**
+     * Select the best model from scores
+     */
+    private selectModel;
+    /**
+     * Build human-readable reasoning
+     */
+    private buildReasoning;
+    /**
+     * Track routing decision for learning
+     */
+    private trackDecision;
+    /**
+     * Record outcome for learning
+     */
+    recordOutcome(task: string, model: ClaudeModel, outcome: 'success' | 'failure' | 'escalated'): void;
+    /**
+     * Get router statistics
+     */
+    getStats(): {
+        totalDecisions: number;
+        modelDistribution: Record<ClaudeModel, number>;
+        avgComplexity: number;
+        avgConfidence: number;
+        circuitBreakerTrips: number;
+        consecutiveFailures: Record<ClaudeModel, number>;
+    };
+    /**
+     * Load state from disk
+     */
+    private loadState;
+    /**
+     * Save state to disk
+     */
+    private saveState;
+    /**
+     * Reset router state
+     */
+    reset(): void;
+}
+/**
+ * Get or create the singleton ModelRouter instance
+ */
+export declare function getModelRouter(config?: Partial<ModelRouterConfig>): ModelRouter;
+/**
+ * Reset the singleton instance
+ */
+export declare function resetModelRouter(): void;
+/**
+ * Create a new ModelRouter instance (non-singleton)
+ */
+export declare function createModelRouter(config?: Partial<ModelRouterConfig>): ModelRouter;
+/**
+ * Quick route function for common use case
+ */
+export declare function routeToModel(task: string): Promise<ClaudeModel>;
+/**
+ * Route with full result
+ */
+export declare function routeToModelFull(task: string, embedding?: number[]): Promise<ModelRoutingResult>;
+/**
+ * Analyze task complexity without routing
+ */
+export declare function analyzeTaskComplexity(task: string): ComplexityAnalysis;
+/**
+ * Get model router statistics
+ */
+export declare function getModelRouterStats(): ReturnType<ModelRouter['getStats']>;
+/**
+ * Record routing outcome for learning
+ */
+export declare function recordModelOutcome(task: string, model: ClaudeModel, outcome: 'success' | 'failure' | 'escalated'): void;
+//# sourceMappingURL=model-router.d.ts.map