agentic-qe 1.9.3 → 2.0.0

package/dist/core/memory/IPatternStore.js

@@ -0,0 +1,15 @@
+"use strict";
+/**
+ * IPatternStore - Unified Interface for Pattern Storage
+ *
+ * Provides a common abstraction for high-performance vector pattern storage,
+ * supporting multiple backends:
+ * - RuVector (@ruvector/core): 170x faster search, 192K QPS
+ * - AgentDB: Full-featured with learning capabilities
+ * - In-memory fallback: For platforms without native support
+ *
+ * @module core/memory/IPatternStore
+ * @version 1.0.0
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=IPatternStore.js.map

package/dist/core/memory/IPatternStore.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IPatternStore.js","sourceRoot":"","sources":["../../../src/core/memory/IPatternStore.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;GAWG"}

package/dist/core/memory/MigrationTools.d.ts

@@ -0,0 +1,192 @@
+/**
+ * MigrationTools - AgentDB to RuVector Migration Utilities
+ *
+ * Provides comprehensive migration capabilities for transitioning test patterns
+ * from AgentDB/SQLite storage to high-performance RuVector backend.
+ *
+ * Key Features:
+ * - Export patterns from AgentDB SQLite database
+ * - Transform legacy pattern format to RuVector TestPattern interface
+ * - Batch import with progress tracking and error handling
+ * - Dry-run mode for safe migration validation
+ * - Rollback support with backup creation
+ * - Dual-write proxy for zero-downtime migration
+ * - Comprehensive validation and integrity checks
+ *
+ * Migration Performance:
+ * - Batch processing: 1000 patterns per batch (configurable)
+ * - RuVector import: 2.7M+ ops/sec (native backend)
+ * - Parallel export/import for maximum throughput
+ *
+ * @module core/memory/MigrationTools
+ * @version 1.0.0
+ *
+ * @example
+ * ```typescript
+ * // Simple migration
+ * const migrator = new PatternMigrator();
+ * const result = await migrator.migrate({
+ *   sourcePath: './data/agentic-qe.db',
+ *   targetPath: './data/patterns.ruvector',
+ *   batchSize: 1000,
+ *   verbose: true
+ * });
+ *
+ * // Dry-run validation
+ * const dryRun = await migrator.migrate({
+ *   sourcePath: './data/agentic-qe.db',
+ *   dryRun: true
+ * });
+ *
+ * // Dual-write for safe transition
+ * const proxy = new DualWriteProxy(agentDbStore, ruVectorStore);
+ * await proxy.initialize();
+ * await proxy.storePattern(pattern); // Writes to both
+ * ```
+ */
+import type { IPatternStore, TestPattern, PatternSearchOptions, PatternSearchResult, PatternStoreStats } from './IPatternStore';
+/**
+ * Migration configuration options
+ */
+export interface MigrationOptions {
+    /** Source AgentDB database path (SQLite .db file) */
+    sourcePath?: string;
+    /** Target RuVector storage path */
+    targetPath?: string;
+    /** Validate migration without writing to target (default: false) */
+    dryRun?: boolean;
+    /** Number of patterns to process per batch (default: 1000) */
+    batchSize?: number;
+    /** Enable verbose logging (default: false) */
+    verbose?: boolean;
+    /** Create backup before migration (default: true) */
+    createBackup?: boolean;
+    /** Embedding dimension (default: 384) */
+    dimension?: number;
+    /** Embedding generator function (if patterns lack embeddings) */
+    generateEmbedding?: (pattern: any) => Promise<number[]>;
+}
+/**
+ * Migration result summary
+ */
+export interface MigrationResult {
+    /** Total patterns found in source */
+    totalPatterns: number;
+    /** Successfully migrated patterns */
+    migratedCount: number;
+    /** Skipped patterns (errors, missing data, etc.) */
+    skippedCount: number;
+    /** Error messages encountered */
+    errors: string[];
+    /** Migration duration in milliseconds */
+    duration: number;
+    /** Validation results */
+    validation?: {
+        sourceValid: boolean;
+        targetValid: boolean;
+        integrityChecks: string[];
+    };
+    /** Backup file path (if created) */
+    backupPath?: string;
+}
+/**
+ * PatternMigrator - Main migration orchestrator
+ *
+ * Handles the complete migration workflow from AgentDB to RuVector
+ * with comprehensive error handling and validation.
+ */
+export declare class PatternMigrator {
+    private backupPaths;
+    /**
+     * Execute pattern migration with full orchestration
+     */
+    migrate(options: MigrationOptions): Promise<MigrationResult>;
+    /**
+     * Validate source database exists and is readable
+     */
+    validateSource(sourcePath: string): Promise<boolean>;
+    /**
+     * Create backup of source database
+     */
+    createBackup(sourcePath: string): Promise<string>;
+    /**
+     * Export patterns from AgentDB SQLite database
+     */
+    exportFromAgentDB(sourcePath: string, generateEmbedding?: (pattern: any) => Promise<number[]>, dimension?: number): Promise<TestPattern[]>;
+    /**
+     * Transform legacy AgentDB pattern to RuVector TestPattern format
+     */
+    private transformLegacyPattern;
+    /**
+     * Import patterns to RuVector in batches
+     */
+    private importToRuVector;
+    /**
+     * Validate migration integrity
+     */
+    private validateMigration;
+    /**
+     * Rollback migration by restoring from backup
+     */
+    rollback(): Promise<void>;
+}
+/**
+ * DualWriteProxy - Write to both AgentDB and RuVector during transition
+ *
+ * Enables zero-downtime migration by:
+ * - Writing to both old and new backends
+ * - Reading from new backend (RuVector) for performance
+ * - Falling back to old backend on RuVector errors
+ *
+ * Use this during the transition period to ensure data consistency
+ * and enable safe rollback if issues occur.
+ */
+export declare class DualWriteProxy implements IPatternStore {
+    private primaryStore;
+    private secondaryStore;
+    private initialized;
+    /**
+     * Create dual-write proxy
+     * @param primaryStore - Primary store (usually RuVector for reads)
+     * @param secondaryStore - Secondary store (usually AgentDB for backup)
+     */
+    constructor(primaryStore: IPatternStore, secondaryStore: IPatternStore);
+    initialize(): Promise<void>;
+    storePattern(pattern: TestPattern): Promise<void>;
+    storeBatch(patterns: TestPattern[]): Promise<void>;
+    searchSimilar(queryEmbedding: number[], options?: PatternSearchOptions): Promise<PatternSearchResult[]>;
+    getPattern(id: string): Promise<TestPattern | null>;
+    deletePattern(id: string): Promise<boolean>;
+    recordUsage(id: string): Promise<void>;
+    buildIndex(): Promise<void>;
+    optimize(): Promise<void>;
+    getStats(): Promise<PatternStoreStats>;
+    clear(): Promise<void>;
+    shutdown(): Promise<void>;
+    getImplementationInfo(): {
+        type: 'ruvector' | 'agentdb' | 'fallback';
+        version: string;
+        features: string[];
+    };
+}
+/**
+ * Convenience function to create a dual-write proxy
+ */
+export declare function createDualWriteProxy(primaryConfig: {
+    storagePath?: string;
+    dimension?: number;
+}, secondaryConfig: {
+    storagePath?: string;
+    dimension?: number;
+}): Promise<DualWriteProxy>;
+/**
+ * Migration status checker - verify migration progress
+ */
+export declare function checkMigrationStatus(sourcePath: string, targetPath: string): Promise<{
+    sourceCount: number;
+    targetCount: number;
+    migrationComplete: boolean;
+    coverage: number;
+}>;
+export default PatternMigrator;
+//# sourceMappingURL=MigrationTools.d.ts.map

package/dist/core/memory/MigrationTools.d.ts.map

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