agentic-qe 3.7.21 → 3.8.0

package/dist/init/migration/data-migrator.js

@@ -1,232 +0,0 @@
-/**
- * V2 Data Migrator
- * Migrates patterns and experiences from v2 to v3 format
- */
-import { existsSync, copyFileSync, mkdirSync } from 'fs';
-import { join, dirname } from 'path';
-import { toErrorMessage } from '../../shared/error-utils.js';
-import { safeJsonParse } from '../../shared/safe-json.js';
-import { openDatabase } from '../../shared/safe-db.js';
-/**
- * V2 Data Migrator
- */
-export class V2DataMigrator {
-    v2DbPath;
-    v3PatternsDbPath;
-    onProgress;
-    constructor(options) {
-        this.v2DbPath = options.v2DbPath;
-        this.v3PatternsDbPath = options.v3PatternsDbPath;
-        this.onProgress = options.onProgress;
-    }
-    /**
-     * Run migration
-     */
-    async migrate() {
-        const result = {
-            success: false,
-            tablesMigrated: [],
-            counts: {},
-            errors: [],
-        };
-        // Check source exists
-        if (!existsSync(this.v2DbPath)) {
-            result.errors.push('V2 database not found');
-            return result;
-        }
-        try {
-            // Create backup
-            this.report('backup', 'Creating backup of v2 database...');
-            const backupPath = await this.createBackup();
-            result.backupPath = backupPath;
-            // Initialize v3 database
-            this.report('init', 'Initializing v3 patterns database...');
-            await this.initializeV3Database();
-            // Migrate patterns
-            this.report('patterns', 'Migrating patterns...');
-            const patternsCount = await this.migratePatterns();
-            if (patternsCount > 0) {
-                result.tablesMigrated.push('patterns');
-                result.counts.patterns = patternsCount;
-            }
-            // Migrate experiences
-            this.report('experiences', 'Migrating experiences...');
-            const experiencesCount = await this.migrateExperiences();
-            if (experiencesCount > 0) {
-                result.tablesMigrated.push('experiences');
-                result.counts.experiences = experiencesCount;
-            }
-            // Migrate concept graph
-            this.report('concepts', 'Migrating concept graph...');
-            const conceptsCount = await this.migrateConceptGraph();
-            if (conceptsCount > 0) {
-                result.tablesMigrated.push('concept_graph');
-                result.counts.concepts = conceptsCount;
-            }
-            result.success = true;
-            this.report('complete', 'Migration completed successfully');
-        }
-        catch (error) {
-            result.errors.push(toErrorMessage(error));
-        }
-        return result;
-    }
-    /**
-     * Report progress
-     */
-    report(stage, message, progress) {
-        this.onProgress?.({ stage, message, progress });
-    }
-    /**
-     * Create backup of v2 database
-     */
-    async createBackup() {
-        const backupDir = join(dirname(this.v2DbPath), 'backup');
-        if (!existsSync(backupDir)) {
-            mkdirSync(backupDir, { recursive: true });
-        }
-        const timestamp = new Date().toISOString().replace(/[:.]/g, '-');
-        const backupPath = join(backupDir, `memory-v2-${timestamp}.db`);
-        copyFileSync(this.v2DbPath, backupPath);
-        return backupPath;
-    }
-    /**
-     * Initialize v3 patterns database
-     */
-    async initializeV3Database() {
-        const dir = dirname(this.v3PatternsDbPath);
-        if (!existsSync(dir)) {
-            mkdirSync(dir, { recursive: true });
-        }
-        const db = openDatabase(this.v3PatternsDbPath);
-        db.exec(`
-      CREATE TABLE IF NOT EXISTS patterns (
-        id TEXT PRIMARY KEY,
-        type TEXT NOT NULL,
-        content TEXT NOT NULL,
-        embedding BLOB,
-        confidence REAL DEFAULT 0.5,
-        usage_count INTEGER DEFAULT 0,
-        quality_score REAL DEFAULT 0.5,
-        domain TEXT,
-        metadata TEXT,
-        created_at INTEGER DEFAULT (strftime('%s', 'now') * 1000),
-        updated_at INTEGER DEFAULT (strftime('%s', 'now') * 1000),
-        migrated_from TEXT
-      );
-
-      CREATE TABLE IF NOT EXISTS experiences (
-        id TEXT PRIMARY KEY,
-        task_type TEXT NOT NULL,
-        task_description TEXT,
-        agent TEXT,
-        outcome TEXT,
-        success INTEGER,
-        quality_score REAL,
-        patterns_used TEXT,
-        created_at INTEGER DEFAULT (strftime('%s', 'now') * 1000),
-        migrated_from TEXT
-      );
-
-      CREATE INDEX IF NOT EXISTS idx_patterns_domain ON patterns(domain);
-      CREATE INDEX IF NOT EXISTS idx_patterns_type ON patterns(type);
-      CREATE INDEX IF NOT EXISTS idx_experiences_task_type ON experiences(task_type);
-    `);
-        db.close();
-    }
-    /**
-     * Migrate patterns from v2 kv_store
-     */
-    async migratePatterns() {
-        const v2Db = openDatabase(this.v2DbPath, { readonly: true });
-        const v3Db = openDatabase(this.v3PatternsDbPath);
-        try {
-            // Find patterns in v2 database
-            const v2Patterns = v2Db.prepare(`
-        SELECT key, namespace, value FROM kv_store
-        WHERE namespace LIKE '%pattern%' OR key LIKE '%pattern%'
-      `).all();
-            let count = 0;
-            const insertStmt = v3Db.prepare(`
-        INSERT OR IGNORE INTO patterns (id, type, content, domain, metadata, migrated_from)
-        VALUES (?, ?, ?, ?, ?, ?)
-      `);
-            for (const row of v2Patterns) {
-                try {
-                    const data = safeJsonParse(row.value);
-                    const id = `migrated-${row.namespace}-${row.key}`;
-                    const type = data.type || 'unknown';
-                    const content = JSON.stringify(data);
-                    const domain = row.namespace.replace(':patterns', '') || 'general';
-                    insertStmt.run(id, type, content, domain, null, `v2:${row.namespace}:${row.key}`);
-                    count++;
-                }
-                catch (error) {
-                    // Non-critical: skip invalid entries during migration
-                    console.debug('[DataMigrator] Skipped invalid pattern entry:', error instanceof Error ? error.message : error);
-                }
-            }
-            return count;
-        }
-        finally {
-            v2Db.close();
-            v3Db.close();
-        }
-    }
-    /**
-     * Migrate experiences from v2
-     */
-    async migrateExperiences() {
-        const v2Db = openDatabase(this.v2DbPath, { readonly: true });
-        const v3Db = openDatabase(this.v3PatternsDbPath);
-        try {
-            // Find experiences in v2 database
-            const v2Experiences = v2Db.prepare(`
-        SELECT key, namespace, value FROM kv_store
-        WHERE namespace LIKE '%experience%' OR key LIKE '%experience%'
-      `).all();
-            let count = 0;
-            const insertStmt = v3Db.prepare(`
-        INSERT OR IGNORE INTO captured_experiences (id, task, agent, domain, success, quality, source)
-        VALUES (?, ?, ?, ?, ?, ?, ?)
-      `);
-            for (const row of v2Experiences) {
-                try {
-                    const data = safeJsonParse(row.value);
-                    const id = `migrated-${row.namespace}-${row.key}`;
-                    const taskDescription = data.description || data.task || '';
-                    const agent = data.agent || 'unknown';
-                    const domain = data.domain || data.taskType || data.task_type || '';
-                    const success = data.success ? 1 : 0;
-                    const qualityScore = data.quality || data.qualityScore || 0.5;
-                    insertStmt.run(id, taskDescription, agent, domain, success, qualityScore, `v2-migration:${row.namespace}:${row.key}`);
-                    count++;
-                }
-                catch (error) {
-                    // Non-critical: skip invalid entries during migration
-                    console.debug('[DataMigrator] Skipped invalid experience entry:', error instanceof Error ? error.message : error);
-                }
-            }
-            return count;
-        }
-        finally {
-            v2Db.close();
-            v3Db.close();
-        }
-    }
-    /**
-     * Migrate concept graph from v2
-     */
-    async migrateConceptGraph() {
-        // Concept graph migration would be more complex
-        // For now, return 0 to indicate no concepts migrated
-        return 0;
-    }
-}
-/**
- * Create V2 data migrator
- */
-export function createV2DataMigrator(options) {
-    return new V2DataMigrator(options);
-}
-//# sourceMappingURL=data-migrator.js.map

package/dist/init/migration/detector.d.ts

@@ -1,44 +0,0 @@
-/**
- * V2 Detector
- * Detects existing v2 AQE installations
- */
-/**
- * V2 detection information
- */
-export interface V2DetectionInfo {
-    detected: boolean;
-    version: string | undefined;
-    paths: {
-        memoryDb: string | undefined;
-        configDir: string | undefined;
-        agentsDir: string | undefined;
-    };
-    assets: {
-        hasMemoryDb: boolean;
-        hasConfig: boolean;
-        hasAgents: boolean;
-        hasV2ConfigFiles: boolean;
-        hasV3ConfigYaml: boolean;
-    };
-    isV3Installation: boolean;
-}
-/**
- * V2 Detector class
- */
-export declare class V2Detector {
-    private projectRoot;
-    constructor(projectRoot: string);
-    /**
-     * Detect v2 installation
-     */
-    detect(): Promise<V2DetectionInfo>;
-    /**
-     * Read version from memory.db
-     */
-    private readVersionFromDb;
-}
-/**
- * Create V2 detector
- */
-export declare function createV2Detector(projectRoot: string): V2Detector;
-//# sourceMappingURL=detector.d.ts.map

package/dist/init/migration/detector.js

@@ -1,105 +0,0 @@
-/**
- * V2 Detector
- * Detects existing v2 AQE installations
- */
-import { existsSync } from 'fs';
-import { join } from 'path';
-import { safeJsonParse } from '../../shared/safe-json.js';
-import { openDatabase } from '../../shared/safe-db.js';
-/**
- * V2 Detector class
- */
-export class V2Detector {
-    projectRoot;
-    constructor(projectRoot) {
-        this.projectRoot = projectRoot;
-    }
-    /**
-     * Detect v2 installation
-     */
-    async detect() {
-        const memoryDbPath = join(this.projectRoot, '.agentic-qe', 'memory.db');
-        const configDir = join(this.projectRoot, '.agentic-qe', 'config');
-        const agentsDir = join(this.projectRoot, '.claude', 'agents');
-        const v2ConfigFile = join(this.projectRoot, '.agentic-qe', 'config', 'learning.json');
-        const v3ConfigYaml = join(this.projectRoot, '.agentic-qe', 'config.yaml');
-        const hasMemoryDb = existsSync(memoryDbPath);
-        const hasConfig = existsSync(configDir);
-        const hasAgents = existsSync(agentsDir);
-        const hasV2ConfigFiles = existsSync(v2ConfigFile);
-        const hasV3ConfigYaml = existsSync(v3ConfigYaml);
-        // Read version from database
-        let version;
-        let isV3Installation = false;
-        if (hasMemoryDb) {
-            version = this.readVersionFromDb(memoryDbPath);
-            if (version) {
-                isV3Installation = version.startsWith('3.');
-            }
-            else {
-                version = '2.x.x';
-            }
-        }
-        // Determine if v2 detected
-        const detected = !isV3Installation && hasMemoryDb && (!version?.startsWith('3.') ||
-            (hasV2ConfigFiles && !hasV3ConfigYaml));
-        return {
-            detected,
-            version,
-            paths: {
-                memoryDb: hasMemoryDb ? memoryDbPath : undefined,
-                configDir: hasConfig ? configDir : undefined,
-                agentsDir: hasAgents ? agentsDir : undefined,
-            },
-            assets: {
-                hasMemoryDb,
-                hasConfig,
-                hasAgents,
-                hasV2ConfigFiles,
-                hasV3ConfigYaml,
-            },
-            isV3Installation,
-        };
-    }
-    /**
-     * Read version from memory.db
-     */
-    readVersionFromDb(dbPath) {
-        try {
-            const db = openDatabase(dbPath, { readonly: true, fileMustExist: true });
-            try {
-                const tableExists = db.prepare(`
-          SELECT name FROM sqlite_master
-          WHERE type='table' AND name='kv_store'
-        `).get();
-                if (!tableExists) {
-                    db.close();
-                    return undefined;
-                }
-                const row = db.prepare(`
-          SELECT value FROM kv_store
-          WHERE key = 'aqe_version' AND namespace = '_system'
-        `).get();
-                db.close();
-                if (row) {
-                    return safeJsonParse(row.value);
-                }
-                return undefined;
-            }
-            catch {
-                db.close();
-                return undefined;
-            }
-        }
-        catch {
-            return undefined;
-        }
-    }
-}
-/**
- * Create V2 detector
- */
-export function createV2Detector(projectRoot) {
-    return new V2Detector(projectRoot);
-}
-//# sourceMappingURL=detector.js.map

package/dist/init/migration/index.d.ts

@@ -1,8 +0,0 @@
-/**
- * Migration Module Index
- * Handles v2 to v3 migration
- */
-export { V2Detector, createV2Detector, type V2DetectionInfo } from './detector.js';
-export { V2DataMigrator, createV2DataMigrator, type MigrationResult } from './data-migrator.js';
-export { V2ConfigMigrator, createV2ConfigMigrator } from './config-migrator.js';
-//# sourceMappingURL=index.d.ts.map

package/dist/init/migration/index.js

@@ -1,8 +0,0 @@
-/**
- * Migration Module Index
- * Handles v2 to v3 migration
- */
-export { V2Detector, createV2Detector } from './detector.js';
-export { V2DataMigrator, createV2DataMigrator } from './data-migrator.js';
-export { V2ConfigMigrator, createV2ConfigMigrator } from './config-migrator.js';
-//# sourceMappingURL=index.js.map

package/dist/learning/v2-to-v3-migration.d.ts

@@ -1,86 +0,0 @@
-/**
- * V2 to V3 Data Migration Module
- * ADR-038: V3 QE Memory Unification
- *
- * Migrates data from V2 AQE fleet (.agentic-qe/memory.db) to V3 systems:
- * - patterns → RealQEReasoningBank (.agentic-qe/memory.db)
- * - captured_experiences → QEUnifiedMemory learning domain
- * - learning_experiences → RL training data
- * - concept_nodes/edges → Code intelligence knowledge graph
- *
- * @module migration
- */
-export interface V2MigrationConfig {
-    /** Path to V2 memory.db file */
-    v2DbPath: string;
-    /** Path to V3 memory.db file */
-    v3PatternsDbPath: string;
-    /** Progress callback */
-    onProgress?: (progress: V2MigrationProgress) => void;
-}
-export interface V2MigrationProgress {
-    stage: 'connecting' | 'reading' | 'migrating' | 'validating' | 'complete';
-    table?: string;
-    current: number;
-    total: number;
-    message: string;
-}
-export interface V2MigrationResult {
-    success: boolean;
-    tablesMigrated: string[];
-    counts: Record<string, number>;
-    errors: string[];
-    duration: number;
-}
-export declare class V2ToV3Migrator {
-    private readonly config;
-    private v2Db;
-    private v3Db;
-    private startTime;
-    constructor(config: V2MigrationConfig);
-    /**
-     * Execute the full migration
-     */
-    migrate(): Promise<V2MigrationResult>;
-    /**
-     * Safely parse JSON, returning a wrapper object for non-JSON strings
-     * Handles V2 data where state/action columns may contain plain strings like "task-started"
-     */
-    private safeJsonParse;
-    private reportProgress;
-    private connect;
-    private disconnect;
-    private createV3Schema;
-    private readV2Data;
-    /**
-     * Migrate V2 patterns to V3 qe_patterns table
-     */
-    private migratePatterns;
-    /**
-     * Migrate captured experiences to learning domain
-     * These are stored in memory_entries for now, could be moved to QEUnifiedMemory
-     */
-    private migrateCapturedExperiences;
-    /**
-     * Migrate learning experiences (RL data)
-     * Store as learning patterns for SONA integration
-     */
-    private migrateLearningExperiences;
-    /**
-     * Migrate concept graph (nodes and edges) for code intelligence
-     */
-    private migrateConceptGraph;
-    /**
-     * Validate migration results
-     */
-    private validateMigration;
-    private mapV2DomainToV3;
-    private mapTaskTypeToDomain;
-    private inferPatternType;
-    private calculateTier;
-}
-/**
- * Create and execute a V2 to V3 migration
- */
-export declare function migrateV2ToV3(v2DbPath?: string, v3PatternsDbPath?: string, onProgress?: (progress: V2MigrationProgress) => void): Promise<V2MigrationResult>;
-//# sourceMappingURL=v2-to-v3-migration.d.ts.map