@claude-flow/cli 3.32.1 → 3.32.3

package/dist/src/memory/intelligence.d.ts

@@ -1,405 +0,0 @@
-/**
- * V3 Intelligence Module
- * Optimized SONA (Self-Optimizing Neural Architecture) and ReasoningBank
- * for adaptive learning and pattern recognition
- *
- * Performance targets:
- * - Signal recording: <0.05ms (achieved: ~0.01ms)
- * - Pattern search: O(log n) with HNSW
- * - Memory efficient circular buffers
- *
- * @module v3/cli/intelligence
- */
-export interface SonaConfig {
-    instantLoopEnabled: boolean;
-    backgroundLoopEnabled: boolean;
-    loraLearningRate: number;
-    loraRank: number;
-    ewcLambda: number;
-    maxTrajectorySize: number;
-    patternThreshold: number;
-    maxSignals: number;
-    maxPatterns: number;
-}
-export interface TrajectoryStep {
-    type: 'observation' | 'thought' | 'action' | 'result';
-    content: string;
-    embedding?: number[];
-    metadata?: Record<string, unknown>;
-    timestamp?: number;
-}
-export interface Pattern {
-    id: string;
-    type: string;
-    embedding: number[];
-    content: string;
-    confidence: number;
-    usageCount: number;
-    createdAt: number;
-    lastUsedAt: number;
-}
-export interface IntelligenceStats {
-    sonaEnabled: boolean;
-    reasoningBankSize: number;
-    patternsLearned: number;
-    signalsProcessed: number;
-    trajectoriesRecorded: number;
-    lastAdaptation: number | null;
-    avgAdaptationTime: number;
-}
-interface Signal {
-    type: string;
-    content: string;
-    embedding: number[];
-    metadata?: Record<string, unknown>;
-    timestamp: number;
-}
-interface StoredPattern {
-    id: string;
-    type: string;
-    embedding: number[];
-    content: string;
-    confidence: number;
-    usageCount: number;
-    createdAt: number;
-    lastUsedAt: number;
-    metadata?: Record<string, unknown>;
-}
-/**
- * Lightweight SONA Coordinator
- * Uses circular buffer for O(1) signal recording
- * Achieves <0.05ms per operation
- */
-declare class LocalSonaCoordinator {
-    private config;
-    private signals;
-    private signalHead;
-    private signalCount;
-    private trajectories;
-    private adaptationTimes;
-    private currentTrajectorySteps;
-    constructor(config: SonaConfig);
-    /**
-     * Record a signal - O(1) operation
-     * Target: <0.05ms
-     */
-    recordSignal(signal: Signal): void;
-    /**
-     * Record complete trajectory
-     */
-    recordTrajectory(trajectory: {
-        steps: TrajectoryStep[];
-        verdict: string;
-        timestamp: number;
-    }): void;
-    /**
-     * Get recent signals
-     */
-    getRecentSignals(count?: number): Signal[];
-    /**
-     * Get average adaptation time
-     */
-    getAvgAdaptationTime(): number;
-    /**
-     * Add a step to the current in-progress trajectory
-     */
-    addTrajectoryStep(step: TrajectoryStep): void;
-    /**
-     * End the current trajectory with a verdict and apply RL updates.
-     * Reward mapping: success=1.0, partial=0.5, failure=-0.5
-     *
-     * For successful/partial trajectories, boosts confidence of similar patterns
-     * in the ReasoningBank. For failures, reduces confidence scores.
-     */
-    endTrajectory(verdict: 'success' | 'failure' | 'partial', bank: LocalReasoningBank): Promise<{
-        reward: number;
-        patternsUpdated: number;
-    }>;
-    /**
-     * Distill learning from recent successful trajectories.
-     * Applies LoRA-style confidence updates and integrates EWC++ consolidation.
-     *
-     * For each successful trajectory step with high confidence,
-     * increases the pattern's stored confidence by loraLearningRate * reward.
-     * Before applying updates, checks EWC penalty to prevent catastrophic forgetting.
-     */
-    distillLearning(bank: LocalReasoningBank): Promise<{
-        patternsDistilled: number;
-        ewcPenalty: number;
-    }>;
-    /**
-     * Get current trajectory steps (for inspection)
-     */
-    getCurrentTrajectorySteps(): TrajectoryStep[];
-    /**
-     * Get statistics
-     */
-    stats(): {
-        signalCount: number;
-        trajectoryCount: number;
-        avgAdaptationMs: number;
-    };
-}
-/**
- * Lightweight ReasoningBank
- * Uses Map for O(1) storage and array for similarity search
- * Supports persistence to disk
- */
-declare class LocalReasoningBank {
-    private patterns;
-    private patternList;
-    private maxSize;
-    private persistenceEnabled;
-    private dirty;
-    private saveTimeout;
-    constructor(options: {
-        maxSize: number;
-        persistence?: boolean;
-    });
-    /**
-     * Load patterns from disk, deduplicating by content.
-     * When multiple patterns share identical content, keeps the one with
-     * highest confidence (ties broken by most recent lastUsedAt).
-     */
-    private loadFromDisk;
-    /**
-     * Save patterns to disk (debounced)
-     */
-    private saveToDisk;
-    /**
-     * Immediately flush patterns to disk
-     */
-    flushToDisk(): void;
-    /**
-     * Store a pattern - O(1)
-     * Deduplicates by content: if a pattern with the same content already
-     * exists, the existing entry is updated (bumped usageCount, higher
-     * confidence wins, refreshed lastUsedAt) instead of adding a duplicate.
-     */
-    store(pattern: Omit<StoredPattern, 'usageCount' | 'createdAt' | 'lastUsedAt'> & Partial<StoredPattern>): void;
-    /**
-     * Find similar patterns by embedding
-     */
-    findSimilar(queryEmbedding: number[], options: {
-        k?: number;
-        threshold?: number;
-        type?: string;
-    }): StoredPattern[];
-    /**
-     * Optimized cosine similarity
-     */
-    private cosineSim;
-    /**
-     * Get statistics
-     */
-    stats(): {
-        size: number;
-        patternCount: number;
-    };
-    /**
-     * Get pattern by ID
-     */
-    get(id: string): StoredPattern | undefined;
-    /**
-     * Get all patterns
-     */
-    getAll(): StoredPattern[];
-    /**
-     * Get patterns by type
-     */
-    getByType(type: string): StoredPattern[];
-    /**
-     * Delete a pattern by ID
-     */
-    delete(id: string): boolean;
-    /**
-     * Clear all patterns
-     */
-    clear(): void;
-}
-export declare function recordSignalProcessed(): number;
-/** Force-persist current stats (e.g. before shutdown / for tests). */
-export declare function flushIntelligenceStats(): void;
-/**
- * The four historical stat sources (globalStats / memory_bridge_status /
- * hooks metrics / neural_patterns count) genuinely measure different things,
- * so we don't merge them — we expose ONE call that returns all four sub-views
- * with the *source path* of each, plus a `consistency` block that spot-checks
- * the relationships the system maintains.
- *
- * No new store; no migration; just one honest view across the four.
- */
-export interface UnifiedLearningStats {
-    global: {
-        patternsLearned: number;
-        trajectoriesRecorded: number;
-        signalsProcessed: number;
-        lastAdaptation: number | null;
-        source: string;
-    };
-    sona: {
-        trajectoriesTotal: number;
-        patternsLearned: number;
-        reasoningBankSize: number;
-        avgAdaptationTimeMs: number;
-        source: string;
-        available: boolean;
-    };
-    memoryBridge: {
-        totalEntries: number;
-        perNamespace: Record<string, number>;
-        source: string;
-        reachable: boolean;
-    };
-    neuralPatterns: {
-        patternCount: number;
-        byType: Record<string, number>;
-        modelCount: number;
-        source: string;
-    };
-    consistency: {
-        sonaTracksGlobal: boolean;
-        sonaTracksGlobalDelta: number;
-        notes: string[];
-    };
-    generatedAt: string;
-}
-export declare function getUnifiedLearningStats(): Promise<UnifiedLearningStats>;
-/**
- * Initialize the intelligence system (SONA + ReasoningBank)
- * Uses optimized local implementations
- */
-export declare function initializeIntelligence(config?: Partial<SonaConfig>): Promise<{
-    success: boolean;
-    sonaEnabled: boolean;
-    reasoningBankEnabled: boolean;
-    error?: string;
-}>;
-/**
- * Record a trajectory step for learning
- * Performance: <0.05ms without embedding generation
- */
-export declare function recordStep(step: TrajectoryStep): Promise<boolean>;
-/**
- * Record a complete trajectory with verdict
- */
-export declare function recordTrajectory(steps: TrajectoryStep[], verdict: 'success' | 'failure' | 'partial'): Promise<boolean>;
-/**
- * Find similar patterns from ReasoningBank
- */
-export interface PatternMatch extends Pattern {
-    similarity: number;
-}
-export declare function findSimilarPatterns(query: string, options?: {
-    k?: number;
-    threshold?: number;
-    type?: string;
-}): Promise<PatternMatch[]>;
-/**
- * Get intelligence system statistics
- */
-export declare function getIntelligenceStats(): IntelligenceStats & {
-    _ruvllmBackend: string;
-    _ruvllmTrajectories: number;
-    _contrastiveTrainer?: {
-        triplets: number;
-        agents: number;
-    } | string;
-    _trainingBackend?: string;
-};
-/**
- * Get SONA coordinator for advanced operations
- */
-export declare function getSonaCoordinator(): LocalSonaCoordinator | null;
-/**
- * Get ReasoningBank for advanced operations
- */
-export declare function getReasoningBank(): LocalReasoningBank | null;
-/**
- * End the current trajectory with a verdict and apply RL updates.
- * This is the public API for the SONA RL loop.
- *
- * @param verdict - 'success' (reward=1.0), 'partial' (0.5), or 'failure' (-0.5)
- * @returns Update statistics or null if not initialized
- */
-export declare function endTrajectoryWithVerdict(verdict: 'success' | 'failure' | 'partial'): Promise<{
-    reward: number;
-    patternsUpdated: number;
-} | null>;
-/**
- * Distill learning from recent successful trajectories.
- * Applies LoRA-style confidence updates with EWC++ consolidation protection.
- *
- * @returns Distillation statistics or null if not initialized
- */
-export declare function distillLearning(): Promise<{
-    patternsDistilled: number;
-    ewcPenalty: number;
-} | null>;
-/**
- * Clear intelligence state
- */
-export declare function clearIntelligence(): void;
-/**
- * Benchmark SONA adaptation time
- */
-export declare function benchmarkAdaptation(iterations?: number): {
-    totalMs: number;
-    avgMs: number;
-    minMs: number;
-    maxMs: number;
-    targetMet: boolean;
-};
-/**
- * Get all patterns from ReasoningBank
- * Returns persisted patterns even after process restart
- */
-export declare function getAllPatterns(): Promise<Pattern[]>;
-/**
- * Get patterns by type from ReasoningBank
- */
-export declare function getPatternsByType(type: string): Promise<Pattern[]>;
-/**
- * Flush patterns to disk immediately
- * Call this at the end of training to ensure all patterns are saved
- */
-export declare function flushPatterns(): void;
-/**
- * Compact patterns by removing duplicates/similar patterns
- * @param threshold Similarity threshold (0-1), patterns above this are considered duplicates
- */
-export declare function compactPatterns(threshold?: number): Promise<{
-    before: number;
-    after: number;
-    removed: number;
-}>;
-/**
- * Delete a pattern by ID
- */
-export declare function deletePattern(id: string): Promise<boolean>;
-/**
- * Clear all patterns (both in memory and on disk)
- */
-export declare function clearAllPatterns(): Promise<void>;
-/**
- * Get the neural data directory path
- */
-export declare function getNeuralDataDir(): string;
-/**
- * Trigger background learning on the @ruvector/ruvllm SonaCoordinator.
- * No-op if ruvllm is not installed.
- */
-export declare function runBackgroundLearning(): Promise<void>;
-/**
- * Get persistence status
- */
-export declare function getPersistenceStatus(): {
-    enabled: boolean;
-    dataDir: string;
-    patternsFile: string;
-    statsFile: string;
-    patternsExist: boolean;
-    statsExist: boolean;
-};
-export {};
-//# sourceMappingURL=intelligence.d.ts.map