agentic-qe 3.2.3 → 3.3.0

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

@@ -0,0 +1,44 @@
+/**
+ * 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/v3/dist/init/migration/detector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"detector.d.ts","sourceRoot":"","sources":["../../../src/init/migration/detector.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAQH;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,OAAO,CAAC;IAClB,OAAO,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,KAAK,EAAE;QACL,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAC;QAC7B,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC;QAC9B,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC;KAC/B,CAAC;IACF,MAAM,EAAE;QACN,WAAW,EAAE,OAAO,CAAC;QACrB,SAAS,EAAE,OAAO,CAAC;QACnB,SAAS,EAAE,OAAO,CAAC;QACnB,gBAAgB,EAAE,OAAO,CAAC;QAC1B,eAAe,EAAE,OAAO,CAAC;KAC1B,CAAC;IACF,gBAAgB,EAAE,OAAO,CAAC;CAC3B;AAED;;GAEG;AACH,qBAAa,UAAU;IACT,OAAO,CAAC,WAAW;gBAAX,WAAW,EAAE,MAAM;IAEvC;;OAEG;IACG,MAAM,IAAI,OAAO,CAAC,eAAe,CAAC;IAmDxC;;OAEG;IACH,OAAO,CAAC,iBAAiB;CAmC1B;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,WAAW,EAAE,MAAM,GAAG,UAAU,CAEhE"}

package/v3/dist/init/migration/detector.js

@@ -0,0 +1,106 @@
+/**
+ * V2 Detector
+ * Detects existing v2 AQE installations
+ */
+import { existsSync } from 'fs';
+import { join } from 'path';
+import { createRequire } from 'module';
+const require = createRequire(import.meta.url);
+/**
+ * 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 Database = require('better-sqlite3');
+            const db = new Database(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 JSON.parse(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/v3/dist/init/migration/detector.js.map

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

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

@@ -0,0 +1,8 @@
+/**
+ * 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/v3/dist/init/migration/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/init/migration/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAAE,KAAK,eAAe,EAAE,MAAM,eAAe,CAAC;AACnF,OAAO,EAAE,cAAc,EAAE,oBAAoB,EAAE,KAAK,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAChG,OAAO,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC"}

package/v3/dist/init/migration/index.js

@@ -0,0 +1,8 @@
+/**
+ * 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/v3/dist/init/migration/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/init/migration/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAAwB,MAAM,eAAe,CAAC;AACnF,OAAO,EAAE,cAAc,EAAE,oBAAoB,EAAwB,MAAM,oBAAoB,CAAC;AAChG,OAAO,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC"}

package/v3/dist/init/orchestrator.d.ts

@@ -0,0 +1,68 @@
+/**
+ * Init Orchestrator - Thin Phase Runner
+ * ADR-025: Enhanced Init with Self-Configuration
+ *
+ * A lightweight orchestrator that runs init phases in sequence.
+ * This replaces the monolithic InitOrchestrator in init-wizard.ts.
+ */
+import type { InitResult } from './types.js';
+import { type InitPhase, type InitContext, type InitOptions } from './phases/index.js';
+/**
+ * Orchestrator options
+ */
+export interface OrchestratorOptions extends InitOptions {
+    /** Project root directory */
+    projectRoot: string;
+    /** Custom phases (overrides defaults) */
+    customPhases?: InitPhase[];
+}
+/**
+ * Thin Init Orchestrator
+ * Runs phases in sequence, collecting results
+ */
+export declare class ModularInitOrchestrator {
+    private phases;
+    private context;
+    constructor(options: OrchestratorOptions);
+    /**
+     * Create init context
+     */
+    private createContext;
+    /**
+     * Run all phases and return result
+     */
+    initialize(): Promise<InitResult>;
+    /**
+     * Create success result
+     */
+    private createSuccessResult;
+    /**
+     * Create failure result
+     */
+    private createFailureResult;
+    /**
+     * Get phase by name
+     */
+    getPhase(name: string): InitPhase | undefined;
+    /**
+     * Get all phases
+     */
+    getPhases(): InitPhase[];
+    /**
+     * Get context (for testing)
+     */
+    getContext(): InitContext;
+}
+/**
+ * Factory function
+ */
+export declare function createModularInitOrchestrator(options: OrchestratorOptions): ModularInitOrchestrator;
+/**
+ * Quick initialization with auto-configuration
+ */
+export declare function quickInitModular(projectRoot: string): Promise<InitResult>;
+/**
+ * Format init result for display
+ */
+export declare function formatInitResultModular(result: InitResult): string;
+//# sourceMappingURL=orchestrator.d.ts.map

package/v3/dist/init/orchestrator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"orchestrator.d.ts","sourceRoot":"","sources":["../../src/init/orchestrator.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAiB,UAAU,EAAkB,MAAM,YAAY,CAAC;AAE5E,OAAO,EAEL,KAAK,SAAS,EACd,KAAK,WAAW,EAChB,KAAK,WAAW,EAEjB,MAAM,mBAAmB,CAAC;AAE3B;;GAEG;AACH,MAAM,WAAW,mBAAoB,SAAQ,WAAW;IACtD,6BAA6B;IAC7B,WAAW,EAAE,MAAM,CAAC;IACpB,yCAAyC;IACzC,YAAY,CAAC,EAAE,SAAS,EAAE,CAAC;CAC5B;AAED;;;GAGG;AACH,qBAAa,uBAAuB;IAClC,OAAO,CAAC,MAAM,CAAc;IAC5B,OAAO,CAAC,OAAO,CAAc;gBAEjB,OAAO,EAAE,mBAAmB;IAKxC;;OAEG;IACH,OAAO,CAAC,aAAa;IA0BrB;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,UAAU,CAAC;IAqEvC;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAiC3B;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAsB3B;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS;IAI7C;;OAEG;IACH,SAAS,IAAI,SAAS,EAAE;IAIxB;;OAEG;IACH,UAAU,IAAI,WAAW;CAG1B;AAED;;GAEG;AACH,wBAAgB,6BAA6B,CAAC,OAAO,EAAE,mBAAmB,GAAG,uBAAuB,CAEnG;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAM/E;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,UAAU,GAAG,MAAM,CAyClE"}

package/v3/dist/init/orchestrator.js

@@ -0,0 +1,239 @@
+/**
+ * Init Orchestrator - Thin Phase Runner
+ * ADR-025: Enhanced Init with Self-Configuration
+ *
+ * A lightweight orchestrator that runs init phases in sequence.
+ * This replaces the monolithic InitOrchestrator in init-wizard.ts.
+ */
+import { createDefaultConfig } from './types.js';
+import { getDefaultPhases, } from './phases/index.js';
+/**
+ * Thin Init Orchestrator
+ * Runs phases in sequence, collecting results
+ */
+export class ModularInitOrchestrator {
+    phases;
+    context;
+    constructor(options) {
+        this.context = this.createContext(options);
+        this.phases = options.customPhases ?? getDefaultPhases();
+    }
+    /**
+     * Create init context
+     */
+    createContext(options) {
+        return {
+            projectRoot: options.projectRoot,
+            options: {
+                autoMode: options.autoMode,
+                skipPatterns: options.skipPatterns,
+                minimal: options.minimal,
+                autoMigrate: options.autoMigrate,
+                withN8n: options.withN8n,
+                n8nApiConfig: options.n8nApiConfig,
+                wizardAnswers: options.wizardAnswers,
+            },
+            config: {},
+            enhancements: {
+                claudeFlow: false,
+                ruvector: false,
+            },
+            results: new Map(),
+            services: {
+                log: (msg) => console.log(msg),
+                warn: (msg) => console.warn(msg),
+                error: (msg) => console.error(msg),
+            },
+        };
+    }
+    /**
+     * Run all phases and return result
+     */
+    async initialize() {
+        const startTime = Date.now();
+        const steps = [];
+        try {
+            // Sort phases by order
+            const sortedPhases = [...this.phases].sort((a, b) => a.order - b.order);
+            // Run each phase
+            for (const phase of sortedPhases) {
+                // Check if phase should run
+                const shouldRun = await phase.shouldRun(this.context);
+                if (!shouldRun) {
+                    continue;
+                }
+                // Log phase start
+                console.log(`\n📋 ${phase.description}...`);
+                // Execute phase
+                const result = await phase.execute(this.context);
+                // Store result
+                this.context.results.set(phase.name, result);
+                // Record step
+                steps.push({
+                    step: phase.description,
+                    status: result.success ? 'success' : 'error',
+                    message: result.message || '',
+                    durationMs: result.durationMs,
+                });
+                // Handle critical failure
+                if (!result.success && phase.critical) {
+                    console.error(`\n❌ Critical phase failed: ${phase.name}`);
+                    // Try rollback if available
+                    if (phase.rollback) {
+                        try {
+                            await phase.rollback(this.context);
+                        }
+                        catch (rollbackError) {
+                            console.error(`Rollback failed: ${rollbackError}`);
+                        }
+                    }
+                    return this.createFailureResult(steps, startTime);
+                }
+                // Check for skip remaining
+                if (result.skipRemaining) {
+                    break;
+                }
+            }
+            return this.createSuccessResult(steps, startTime);
+        }
+        catch (error) {
+            // Unexpected error
+            steps.push({
+                step: 'Initialization Failed',
+                status: 'error',
+                message: error instanceof Error ? error.message : String(error),
+                durationMs: 0,
+            });
+            return this.createFailureResult(steps, startTime);
+        }
+    }
+    /**
+     * Create success result
+     */
+    createSuccessResult(steps, startTime) {
+        const config = this.context.config;
+        // Extract summary from phase results
+        const learningResult = this.context.results.get('learning');
+        const codeIntelResult = this.context.results.get('code-intelligence');
+        const assetsResult = this.context.results.get('assets');
+        const hooksResult = this.context.results.get('hooks');
+        const mcpResult = this.context.results.get('mcp');
+        const claudeMdResult = this.context.results.get('claude-md');
+        const workersResult = this.context.results.get('workers');
+        return {
+            success: true,
+            config: config || createDefaultConfig('unknown', this.context.projectRoot),
+            steps,
+            summary: {
+                projectAnalyzed: this.context.results.has('analysis'),
+                configGenerated: this.context.results.has('configuration'),
+                codeIntelligenceIndexed: codeIntelResult?.data?.entries ?? 0,
+                patternsLoaded: learningResult?.data?.patternsLoaded ?? 0,
+                skillsInstalled: assetsResult?.data?.skillsInstalled ?? 0,
+                agentsInstalled: assetsResult?.data?.agentsInstalled ?? 0,
+                hooksConfigured: hooksResult?.data?.configured ?? false,
+                mcpConfigured: mcpResult?.data?.configured ?? false,
+                claudeMdGenerated: claudeMdResult?.data?.generated ?? false,
+                workersStarted: workersResult?.data?.workersConfigured ?? 0,
+            },
+            totalDurationMs: Date.now() - startTime,
+            timestamp: new Date(),
+        };
+    }
+    /**
+     * Create failure result
+     */
+    createFailureResult(steps, startTime) {
+        return {
+            success: false,
+            config: createDefaultConfig('unknown', this.context.projectRoot),
+            steps,
+            summary: {
+                projectAnalyzed: false,
+                configGenerated: false,
+                codeIntelligenceIndexed: 0,
+                patternsLoaded: 0,
+                skillsInstalled: 0,
+                agentsInstalled: 0,
+                hooksConfigured: false,
+                mcpConfigured: false,
+                claudeMdGenerated: false,
+                workersStarted: 0,
+            },
+            totalDurationMs: Date.now() - startTime,
+            timestamp: new Date(),
+        };
+    }
+    /**
+     * Get phase by name
+     */
+    getPhase(name) {
+        return this.phases.find(p => p.name === name);
+    }
+    /**
+     * Get all phases
+     */
+    getPhases() {
+        return [...this.phases];
+    }
+    /**
+     * Get context (for testing)
+     */
+    getContext() {
+        return this.context;
+    }
+}
+/**
+ * Factory function
+ */
+export function createModularInitOrchestrator(options) {
+    return new ModularInitOrchestrator(options);
+}
+/**
+ * Quick initialization with auto-configuration
+ */
+export async function quickInitModular(projectRoot) {
+    const orchestrator = createModularInitOrchestrator({
+        projectRoot,
+        autoMode: true,
+    });
+    return await orchestrator.initialize();
+}
+/**
+ * Format init result for display
+ */
+export function formatInitResultModular(result) {
+    const lines = [];
+    lines.push('');
+    lines.push('┌─────────────────────────────────────────────────────────────┐');
+    lines.push('│                    AQE v3 Initialization                     │');
+    lines.push('├─────────────────────────────────────────────────────────────┤');
+    // Steps
+    for (const step of result.steps) {
+        const icon = step.status === 'success' ? '✓' : step.status === 'error' ? '✗' : '○';
+        const stepName = step.step.substring(0, 48).padEnd(48);
+        lines.push(`│  ${icon} ${stepName} ${String(step.durationMs).padStart(4)}ms │`);
+    }
+    lines.push('├─────────────────────────────────────────────────────────────┤');
+    // Summary
+    lines.push(`│  Project: ${result.config.project.name.substring(0, 45).padEnd(45)} │`);
+    lines.push(`│  Type: ${result.config.project.type.padEnd(48)} │`);
+    lines.push(`│  Code Intel: ${String(result.summary.codeIntelligenceIndexed).padEnd(43)} │`);
+    lines.push(`│  Patterns: ${String(result.summary.patternsLoaded).padEnd(45)} │`);
+    lines.push(`│  Skills: ${String(result.summary.skillsInstalled).padEnd(47)} │`);
+    lines.push(`│  Agents: ${String(result.summary.agentsInstalled).padEnd(47)} │`);
+    lines.push(`│  Workers: ${String(result.summary.workersStarted).padEnd(46)} │`);
+    lines.push(`│  Hooks: ${result.summary.hooksConfigured ? 'Yes' : 'No'.padEnd(48)} │`);
+    lines.push(`│  MCP: ${result.summary.mcpConfigured ? 'Yes' : 'No'.padEnd(50)} │`);
+    lines.push(`│  CLAUDE.md: ${result.summary.claudeMdGenerated ? 'Yes' : 'No'.padEnd(44)} │`);
+    lines.push('├─────────────────────────────────────────────────────────────┤');
+    // Final status
+    const status = result.success
+        ? '✓ AQE v3 initialized successfully'
+        : '✗ Initialization failed';
+    lines.push(`│  ${status.padEnd(57)} │`);
+    lines.push('└─────────────────────────────────────────────────────────────┘');
+    lines.push('');
+    return lines.join('\n');
+}
+//# sourceMappingURL=orchestrator.js.map

package/v3/dist/init/orchestrator.js.map

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

package/v3/dist/init/phases/01-detection.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Phase 01: Detection
+ * Detects existing AQE v2 installation and v3 markers
+ */
+import { BasePhase, type InitContext, type V2DetectionResult } from './phase-interface.js';
+export interface DetectionResult {
+    v2Detected: boolean;
+    v3Detected: boolean;
+    freshInstall: boolean;
+    v2Detection?: V2DetectionResult;
+}
+/**
+ * Detection phase - checks for existing AQE installations
+ */
+export declare class DetectionPhase extends BasePhase<DetectionResult> {
+    readonly name = "detection";
+    readonly description = "Detect existing installations";
+    readonly order = 10;
+    readonly critical = true;
+    protected run(context: InitContext): Promise<DetectionResult>;
+    /**
+     * Detect existing v2 AQE installation
+     */
+    private detectV2Installation;
+    /**
+     * Read AQE version from memory.db
+     */
+    private readVersionFromDb;
+}
+//# sourceMappingURL=01-detection.d.ts.map

package/v3/dist/init/phases/01-detection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"01-detection.d.ts","sourceRoot":"","sources":["../../../src/init/phases/01-detection.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH,OAAO,EACL,SAAS,EACT,KAAK,WAAW,EAChB,KAAK,iBAAiB,EACvB,MAAM,sBAAsB,CAAC;AAI9B,MAAM,WAAW,eAAe;IAC9B,UAAU,EAAE,OAAO,CAAC;IACpB,UAAU,EAAE,OAAO,CAAC;IACpB,YAAY,EAAE,OAAO,CAAC;IACtB,WAAW,CAAC,EAAE,iBAAiB,CAAC;CACjC;AAED;;GAEG;AACH,qBAAa,cAAe,SAAQ,SAAS,CAAC,eAAe,CAAC;IAC5D,QAAQ,CAAC,IAAI,eAAe;IAC5B,QAAQ,CAAC,WAAW,mCAAmC;IACvD,QAAQ,CAAC,KAAK,MAAM;IACpB,QAAQ,CAAC,QAAQ,QAAQ;cAET,GAAG,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,eAAe,CAAC;IAsDnE;;OAEG;YACW,oBAAoB;IAgDlC;;OAEG;IACH,OAAO,CAAC,iBAAiB;CAmC1B"}