moflo 4.8.31 → 4.8.32

package/src/@claude-flow/memory/dist/rvf-learning-store.d.ts

@@ -1,139 +0,0 @@
-/**
- * RvfLearningStore - Persistent storage for SONA learning artifacts
- *
- * Stores patterns, LoRA adapters, EWC state, and trajectories in a
- * binary-header JSON-lines file format for fast append and rebuild.
- *
- * File format:
- *   4-byte magic "RVLS" + newline
- *   One JSON record per line: {"type":"pattern"|"lora"|"ewc"|"trajectory","data":{...}}
- *
- * @module @claude-flow/memory/rvf-learning-store
- */
-export interface RvfLearningStoreConfig {
-    /** Path to the persistence file */
-    storePath: string;
-    /** SONA embedding dimension (default: 64) */
-    dimensions?: number;
-    /** Auto-persist interval in ms (default: 30000) */
-    autoPersistInterval?: number;
-    /** Enable verbose logging (default: false) */
-    verbose?: boolean;
-}
-export interface PatternRecord {
-    id: string;
-    type: string;
-    embedding: number[];
-    successRate: number;
-    useCount: number;
-    lastUsed: string;
-}
-export interface LoraRecord {
-    id: string;
-    config: Record<string, unknown>;
-    weights: string;
-    frozen: boolean;
-    numParameters: number;
-}
-export interface EwcRecord {
-    tasksLearned: number;
-    protectionStrength: number;
-    forgettingRate: number;
-    taskWeights: Record<string, number[]>;
-}
-export interface TrajectoryRecord {
-    id: string;
-    steps: Array<{
-        type: string;
-        input: string;
-        output: string;
-        durationMs: number;
-        confidence: number;
-    }>;
-    outcome: string;
-    durationMs: number;
-    timestamp: string;
-}
-/**
- * Persistent store for SONA learning artifacts.
- *
- * Maintains in-memory maps for fast reads and flushes to a JSON-lines
- * file with a binary header on persist(). On initialize(), the file is
- * read line-by-line to rebuild state.
- *
- * @example
- * ```typescript
- * const store = new RvfLearningStore({ storePath: './data/learning.rvls' });
- * await store.initialize();
- *
- * await store.savePatterns([{ id: 'p1', type: 'query_response', ... }]);
- * await store.persist();
- * await store.close();
- * ```
- */
-export declare class RvfLearningStore {
-    private config;
-    private patterns;
-    private loraAdapters;
-    private ewcState;
-    private trajectories;
-    private dirty;
-    private initialized;
-    private autoPersistTimer;
-    constructor(config: RvfLearningStoreConfig);
-    /**
-     * Initialize the store by loading any existing data from disk.
-     * Creates the parent directory if it does not exist.
-     */
-    initialize(): Promise<void>;
-    /**
-     * Save or update patterns. Existing patterns with matching IDs are
-     * overwritten; new patterns are added.
-     *
-     * @returns The number of patterns stored
-     */
-    savePatterns(patterns: PatternRecord[]): Promise<number>;
-    /** Load all patterns currently held in memory */
-    loadPatterns(): Promise<PatternRecord[]>;
-    /** Return the number of stored patterns */
-    getPatternCount(): Promise<number>;
-    /** Save or update a LoRA adapter record */
-    saveLoraAdapter(record: LoraRecord): Promise<void>;
-    /** Load all LoRA adapter records */
-    loadLoraAdapters(): Promise<LoraRecord[]>;
-    /** Delete a LoRA adapter by ID */
-    deleteLoraAdapter(id: string): Promise<boolean>;
-    /** Save EWC state (replaces any existing state) */
-    saveEwcState(record: EwcRecord): Promise<void>;
-    /** Load the EWC state, or null if none has been stored */
-    loadEwcState(): Promise<EwcRecord | null>;
-    /** Append a trajectory record (append-only, never overwritten) */
-    appendTrajectory(record: TrajectoryRecord): Promise<void>;
-    /**
-     * Return stored trajectories, newest first.
-     * @param limit Maximum number to return (default: all)
-     */
-    getTrajectories(limit?: number): Promise<TrajectoryRecord[]>;
-    /** Return the number of stored trajectories */
-    getTrajectoryCount(): Promise<number>;
-    /**
-     * Flush all in-memory state to disk. The entire file is rewritten
-     * to ensure consistency (patterns may have been updated in-place).
-     */
-    persist(): Promise<void>;
-    /** Persist and release resources */
-    close(): Promise<void>;
-    /** Return summary statistics about the store */
-    getStats(): Promise<{
-        patterns: number;
-        loraAdapters: number;
-        trajectories: number;
-        hasEwcState: boolean;
-        fileSizeBytes: number;
-    }>;
-    private loadFromDisk;
-    private applyRecord;
-    private ensureInitialized;
-    private log;
-}
-//# sourceMappingURL=rvf-learning-store.d.ts.map

package/src/@claude-flow/memory/dist/rvf-migration.d.ts

@@ -1,45 +0,0 @@
-/** Options for controlling the migration process. */
-export interface RvfMigrationOptions {
-    verbose?: boolean;
-    /** Entries per batch (default 500). */
-    batchSize?: number;
-    /** Embedding dimensions for target RVF file (default 1536). */
-    dimensions?: number;
-    onProgress?: (progress: {
-        current: number;
-        total: number;
-        phase: string;
-    }) => void;
-}
-/** Result returned after a migration completes. */
-export interface RvfMigrationResult {
-    success: boolean;
-    entriesMigrated: number;
-    sourceFormat: string;
-    targetFormat: string;
-    durationMs: number;
-    errors: string[];
-}
-/**
- * Bidirectional migration utility between RVF and legacy memory formats.
- *
- * All methods are static — no instantiation required.
- */
-export declare class RvfMigrator {
-    /** Migrate a JSON memory file to RVF format. */
-    static fromJsonFile(jsonPath: string, rvfPath: string, options?: RvfMigrationOptions): Promise<RvfMigrationResult>;
-    /** Migrate a SQLite (better-sqlite3 / sql.js) database to RVF. */
-    static fromSqlite(dbPath: string, rvfPath: string, options?: RvfMigrationOptions): Promise<RvfMigrationResult>;
-    /** Export an RVF file back to a JSON array (backward compatibility). */
-    static toJsonFile(rvfPath: string, jsonPath: string): Promise<RvfMigrationResult>;
-    /**
-     * Detect file format by magic bytes.
-     * - RVF\0 (0x52 0x56 0x46 0x00) -> 'rvf'
-     * - SQLi  (0x53 0x51 0x4C 0x69) -> 'sqlite'
-     * - Leading [ or {              -> 'json'
-     */
-    static detectFormat(filePath: string): Promise<'rvf' | 'json' | 'sqlite' | 'unknown'>;
-    /** Auto-detect source format and migrate to RVF. */
-    static autoMigrate(sourcePath: string, targetRvfPath: string, options?: RvfMigrationOptions): Promise<RvfMigrationResult>;
-}
-//# sourceMappingURL=rvf-migration.d.ts.map

package/src/@claude-flow/memory/dist/sqlite-backend.d.ts

@@ -1,121 +0,0 @@
-/**
- * SQLite Memory Backend
- *
- * Provides structured storage for memory entries using SQLite.
- * Optimized for ACID transactions, exact matches, and complex queries.
- * Part of ADR-009: Hybrid Memory Backend (SQLite + AgentDB)
- *
- * @module v3/memory/sqlite-backend
- */
-import { EventEmitter } from 'node:events';
-import { IMemoryBackend, MemoryEntry, MemoryEntryUpdate, MemoryQuery, SearchOptions, SearchResult, BackendStats, HealthCheckResult, EmbeddingGenerator } from './types.js';
-/**
- * Configuration for SQLite Backend
- */
-export interface SQLiteBackendConfig {
-    /** Path to SQLite database file (:memory: for in-memory) */
-    databasePath: string;
-    /** Enable WAL mode for better concurrency */
-    walMode: boolean;
-    /** Enable query optimization */
-    optimize: boolean;
-    /** Default namespace */
-    defaultNamespace: string;
-    /** Embedding generator (for compatibility with hybrid mode) */
-    embeddingGenerator?: EmbeddingGenerator;
-    /** Maximum entries before auto-cleanup */
-    maxEntries: number;
-    /** Enable verbose logging */
-    verbose: boolean;
-}
-/**
- * SQLite Backend for Structured Memory Storage
- *
- * Provides:
- * - ACID transactions for data consistency
- * - Efficient indexing for exact matches and prefix queries
- * - Full-text search capabilities
- * - Complex SQL queries with joins and aggregations
- * - Persistent storage with WAL mode
- */
-export declare class SQLiteBackend extends EventEmitter implements IMemoryBackend {
-    private config;
-    private db;
-    private initialized;
-    private stats;
-    constructor(config?: Partial<SQLiteBackendConfig>);
-    /**
-     * Initialize the SQLite backend
-     */
-    initialize(): Promise<void>;
-    /**
-     * Shutdown the backend
-     */
-    shutdown(): Promise<void>;
-    /**
-     * Store a memory entry
-     */
-    store(entry: MemoryEntry): Promise<void>;
-    /**
-     * Get a memory entry by ID
-     */
-    get(id: string): Promise<MemoryEntry | null>;
-    /**
-     * Get a memory entry by key within a namespace
-     */
-    getByKey(namespace: string, key: string): Promise<MemoryEntry | null>;
-    /**
-     * Update a memory entry
-     */
-    update(id: string, update: MemoryEntryUpdate): Promise<MemoryEntry | null>;
-    /**
-     * Delete a memory entry
-     */
-    delete(id: string): Promise<boolean>;
-    /**
-     * Query memory entries with filters
-     */
-    query(query: MemoryQuery): Promise<MemoryEntry[]>;
-    /**
-     * Semantic vector search (not optimized for SQLite, returns empty)
-     * Use HybridBackend for semantic search with AgentDB
-     */
-    search(embedding: Float32Array, options: SearchOptions): Promise<SearchResult[]>;
-    /**
-     * Bulk insert entries
-     */
-    bulkInsert(entries: MemoryEntry[]): Promise<void>;
-    /**
-     * Bulk delete entries
-     */
-    bulkDelete(ids: string[]): Promise<number>;
-    /**
-     * Get entry count
-     */
-    count(namespace?: string): Promise<number>;
-    /**
-     * List all namespaces
-     */
-    listNamespaces(): Promise<string[]>;
-    /**
-     * Clear all entries in a namespace
-     */
-    clearNamespace(namespace: string): Promise<number>;
-    /**
-     * Get backend statistics
-     */
-    getStats(): Promise<BackendStats>;
-    /**
-     * Perform health check
-     */
-    healthCheck(): Promise<HealthCheckResult>;
-    private ensureInitialized;
-    private createSchema;
-    private rowToEntry;
-    /**
-     * Synchronous store for use in transactions
-     */
-    private storeSync;
-}
-export default SQLiteBackend;
-//# sourceMappingURL=sqlite-backend.d.ts.map

package/src/@claude-flow/memory/dist/sqljs-backend.d.ts

@@ -1,127 +0,0 @@
-/**
- * SqlJsBackend - Pure JavaScript SQLite for Windows compatibility
- *
- * Pure JavaScript/WASM SQLite backend that works everywhere
- * without native compilation.
- *
- * @module v3/memory/sqljs-backend
- */
-import { EventEmitter } from 'node:events';
-import { IMemoryBackend, MemoryEntry, MemoryEntryUpdate, MemoryQuery, SearchOptions, SearchResult, BackendStats, HealthCheckResult, EmbeddingGenerator } from './types.js';
-/**
- * Configuration for SqlJs Backend
- */
-export interface SqlJsBackendConfig {
-    /** Path to SQLite database file (:memory: for in-memory) */
-    databasePath: string;
-    /** Enable query optimization */
-    optimize: boolean;
-    /** Default namespace */
-    defaultNamespace: string;
-    /** Embedding generator (for compatibility with hybrid mode) */
-    embeddingGenerator?: EmbeddingGenerator;
-    /** Maximum entries before auto-cleanup */
-    maxEntries: number;
-    /** Enable verbose logging */
-    verbose: boolean;
-    /** Auto-persist interval in milliseconds (0 = manual only) */
-    autoPersistInterval: number;
-    /** Path to sql.js WASM file (optional, will use CDN default) */
-    wasmPath?: string;
-}
-/**
- * SqlJs Backend for Cross-Platform Memory Storage
- *
- * Provides:
- * - Pure JavaScript/WASM implementation (no native compilation)
- * - Windows, macOS, Linux compatibility
- * - Same SQL interface as native SQLite
- * - In-memory with periodic disk persistence
- */
-export declare class SqlJsBackend extends EventEmitter implements IMemoryBackend {
-    private config;
-    private db;
-    private initialized;
-    private persistTimer;
-    private SQL;
-    private stats;
-    constructor(config?: Partial<SqlJsBackendConfig>);
-    /**
-     * Initialize the SqlJs backend
-     */
-    initialize(): Promise<void>;
-    /**
-     * Shutdown the backend
-     */
-    shutdown(): Promise<void>;
-    /**
-     * Create database schema
-     */
-    private createSchema;
-    /**
-     * Store a memory entry
-     */
-    store(entry: MemoryEntry): Promise<void>;
-    /**
-     * Retrieve a memory entry by ID
-     */
-    get(id: string): Promise<MemoryEntry | null>;
-    /**
-     * Retrieve a memory entry by key within a namespace
-     */
-    getByKey(namespace: string, key: string): Promise<MemoryEntry | null>;
-    /**
-     * Update a memory entry
-     */
-    update(id: string, updateData: MemoryEntryUpdate): Promise<MemoryEntry | null>;
-    /**
-     * Delete a memory entry
-     */
-    delete(id: string): Promise<boolean>;
-    /**
-     * Query memory entries
-     */
-    query(query: MemoryQuery): Promise<MemoryEntry[]>;
-    /**
-     * Semantic vector search (limited without vector index)
-     */
-    search(embedding: Float32Array, options: SearchOptions): Promise<SearchResult[]>;
-    /**
-     * Bulk insert entries
-     */
-    bulkInsert(entries: MemoryEntry[]): Promise<void>;
-    /**
-     * Bulk delete entries
-     */
-    bulkDelete(ids: string[]): Promise<number>;
-    /**
-     * Get entry count
-     */
-    count(namespace?: string): Promise<number>;
-    /**
-     * List all namespaces
-     */
-    listNamespaces(): Promise<string[]>;
-    /**
-     * Clear all entries in a namespace
-     */
-    clearNamespace(namespace: string): Promise<number>;
-    /**
-     * Get backend statistics
-     */
-    getStats(): Promise<BackendStats>;
-    /**
-     * Perform health check
-     */
-    healthCheck(): Promise<HealthCheckResult>;
-    /**
-     * Persist changes to disk (sql.js is in-memory, needs explicit save)
-     */
-    persist(): Promise<void>;
-    private ensureInitialized;
-    private rowToEntry;
-    private updateAccessTracking;
-    private cosineSimilarity;
-    private estimateMemoryUsage;
-}
-//# sourceMappingURL=sqljs-backend.d.ts.map