@agentic-qe/v3 3.0.0-alpha.3

package/dist/compatibility/cli-adapter.js

@@ -0,0 +1,247 @@
+/**
+ * CLI Adapter - Adapts V2 CLI commands to V3 format
+ */
+/**
+ * V2 to V3 CLI command mappings
+ */
+const CLI_MAPPINGS = [
+    // Test commands
+    {
+        v2Command: 'aqe generate tests',
+        v3Command: 'aqe-v3 test generate',
+        argMapping: {
+            '--file': '--file',
+            '--coverage': '--coverage',
+            '--framework': '--framework',
+        },
+        deprecated: true,
+    },
+    {
+        v2Command: 'aqe run tests',
+        v3Command: 'aqe-v3 test run',
+        argMapping: {
+            '--parallel': '--parallel',
+            '--workers': '--workers',
+            '--retry': '--retry',
+        },
+        deprecated: true,
+    },
+    // Coverage commands
+    {
+        v2Command: 'aqe analyze coverage',
+        v3Command: 'aqe-v3 coverage analyze',
+        argMapping: {
+            '--source': '--source',
+            '--threshold': '--threshold',
+        },
+        deprecated: true,
+    },
+    {
+        v2Command: 'aqe coverage gaps',
+        v3Command: 'aqe-v3 coverage gaps',
+        deprecated: true,
+    },
+    {
+        v2Command: 'aqe coverage report',
+        v3Command: 'aqe-v3 coverage report',
+        deprecated: true,
+    },
+    // Quality commands
+    {
+        v2Command: 'aqe check quality',
+        v3Command: 'aqe-v3 quality assess',
+        argMapping: {
+            '--gates': '--gates',
+        },
+        deprecated: true,
+    },
+    {
+        v2Command: 'aqe quality gate',
+        v3Command: 'aqe-v3 quality assess --gates all',
+        deprecated: true,
+    },
+    // Security commands
+    {
+        v2Command: 'aqe security scan',
+        v3Command: 'aqe-v3 security scan',
+        deprecated: true,
+    },
+    {
+        v2Command: 'aqe security audit',
+        v3Command: 'aqe-v3 security compliance',
+        deprecated: true,
+    },
+    // Code intelligence commands
+    {
+        v2Command: 'aqe kg index',
+        v3Command: 'aqe-v3 kg index',
+        deprecated: true,
+    },
+    {
+        v2Command: 'aqe kg search',
+        v3Command: 'aqe-v3 kg search',
+        deprecated: true,
+    },
+    // Learning commands
+    {
+        v2Command: 'aqe learn status',
+        v3Command: 'aqe-v3 learn status',
+        deprecated: true,
+    },
+    {
+        v2Command: 'aqe patterns list',
+        v3Command: 'aqe-v3 learn patterns',
+        deprecated: true,
+    },
+    // Init command
+    {
+        v2Command: 'aqe init',
+        v3Command: 'aqe-v3 init',
+        deprecated: true,
+    },
+];
+/**
+ * CLI Adapter class for V2 to V3 command translation
+ */
+export class CLIAdapter {
+    mappings;
+    _agentMapper;
+    constructor(agentMapper) {
+        this._agentMapper = agentMapper;
+        this.mappings = new Map();
+        for (const mapping of CLI_MAPPINGS) {
+            // Normalize command for matching
+            const normalized = this.normalizeCommand(mapping.v2Command);
+            this.mappings.set(normalized, mapping);
+        }
+    }
+    /**
+     * Get the agent mapper for agent-related resolution
+     */
+    get agentMapper() {
+        return this._agentMapper;
+    }
+    /**
+     * Resolve a CLI command from v2 to v3 format
+     */
+    resolve(command, args = []) {
+        const normalized = this.normalizeCommand(command);
+        // Already v3 format
+        if (command.startsWith('aqe-v3')) {
+            return {
+                resolved: true,
+                v3Command: command,
+                v3Args: args,
+                wasV2: false,
+            };
+        }
+        // Try to find mapping
+        for (const [key, mapping] of this.mappings) {
+            if (normalized.startsWith(key)) {
+                const v3Args = this.translateArgs(args, mapping.argMapping);
+                return {
+                    resolved: true,
+                    v3Command: mapping.v3Command,
+                    v3Args,
+                    wasV2: true,
+                    deprecationWarning: `Command "${command}" is deprecated. Use "${mapping.v3Command}" instead.`,
+                };
+            }
+        }
+        // Try partial match
+        const partialMatch = this.findPartialMatch(normalized);
+        if (partialMatch) {
+            const v3Args = this.translateArgs(args, partialMatch.argMapping);
+            return {
+                resolved: true,
+                v3Command: partialMatch.v3Command,
+                v3Args,
+                wasV2: true,
+                deprecationWarning: `Command "${command}" is deprecated. Use "${partialMatch.v3Command}" instead.`,
+            };
+        }
+        return {
+            resolved: false,
+            v3Command: null,
+            v3Args: args,
+            wasV2: false,
+        };
+    }
+    /**
+     * Translate v2 command arguments to v3 format
+     */
+    translateArgs(args, mapping) {
+        if (!mapping)
+            return args;
+        const translated = [];
+        for (let i = 0; i < args.length; i++) {
+            const arg = args[i];
+            if (mapping[arg]) {
+                translated.push(mapping[arg]);
+            }
+            else {
+                translated.push(arg);
+            }
+        }
+        return translated;
+    }
+    /**
+     * Normalize command for comparison
+     */
+    normalizeCommand(command) {
+        return command.toLowerCase().trim().replace(/\s+/g, ' ');
+    }
+    /**
+     * Find partial match for command
+     */
+    findPartialMatch(command) {
+        for (const [key, mapping] of this.mappings) {
+            if (command.includes(key.split(' ').slice(1).join(' '))) {
+                return mapping;
+            }
+        }
+        return null;
+    }
+    /**
+     * Get all CLI mappings
+     */
+    getAllMappings() {
+        return CLI_MAPPINGS;
+    }
+    /**
+     * Build full v3 command from parts
+     */
+    buildV3Command(v3Command, args) {
+        if (args.length === 0)
+            return v3Command;
+        return `${v3Command} ${args.join(' ')}`;
+    }
+    /**
+     * Parse a command string into command and args
+     */
+    parseCommand(fullCommand) {
+        const parts = fullCommand.split(/\s+/);
+        // Find where args start (first part starting with -)
+        const argsStartIndex = parts.findIndex((p) => p.startsWith('-'));
+        if (argsStartIndex === -1) {
+            return { command: fullCommand, args: [] };
+        }
+        return {
+            command: parts.slice(0, argsStartIndex).join(' '),
+            args: parts.slice(argsStartIndex),
+        };
+    }
+    /**
+     * Generate CLI migration guide
+     */
+    generateMigrationGuide() {
+        let guide = '# CLI Command Migration Guide\n\n';
+        guide += '| V2 Command | V3 Command |\n';
+        guide += '|------------|------------|\n';
+        for (const mapping of CLI_MAPPINGS) {
+            guide += `| \`${mapping.v2Command}\` | \`${mapping.v3Command}\` |\n`;
+        }
+        return guide;
+    }
+}
+//# sourceMappingURL=cli-adapter.js.map

package/dist/compatibility/cli-adapter.js.map

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

package/dist/compatibility/config-migrator.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Config Migrator - Migrates V2 configuration to V3 format
+ */
+import { V2Config, V3Config, ConfigMigrationResult } from './types';
+/**
+ * Config Migrator class for V2 to V3 configuration migration
+ */
+export declare class ConfigMigrator {
+    /**
+     * Migrate a V2 configuration to V3 format
+     */
+    migrate(v2Config: V2Config): ConfigMigrationResult;
+    /**
+     * Infer domains from v2 agent list
+     */
+    private inferDomainsFromAgents;
+    /**
+     * Validate a V3 configuration
+     */
+    validate(config: V3Config): {
+        valid: boolean;
+        errors: string[];
+    };
+    /**
+     * Generate a default V3 configuration
+     */
+    generateDefault(): V3Config;
+    /**
+     * Merge a partial config with defaults
+     */
+    mergeWithDefaults(partial: Partial<V3Config>): V3Config;
+    /**
+     * Deep merge two objects
+     */
+    private deepMerge;
+    /**
+     * Generate YAML representation of V3 config
+     */
+    toYAML(config: V3Config): string;
+    private objectToYAML;
+}
+//# sourceMappingURL=config-migrator.d.ts.map

package/dist/compatibility/config-migrator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-migrator.d.ts","sourceRoot":"","sources":["../../src/compatibility/config-migrator.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,qBAAqB,EAAE,MAAM,SAAS,CAAC;AA+DpE;;GAEG;AACH,qBAAa,cAAc;IACzB;;OAEG;IACH,OAAO,CAAC,QAAQ,EAAE,QAAQ,GAAG,qBAAqB;IAkGlD;;OAEG;IACH,OAAO,CAAC,sBAAsB;IAoC9B;;OAEG;IACH,QAAQ,CAAC,MAAM,EAAE,QAAQ,GAAG;QAAE,KAAK,EAAE,OAAO,CAAC;QAAC,MAAM,EAAE,MAAM,EAAE,CAAA;KAAE;IA0ChE;;OAEG;IACH,eAAe,IAAI,QAAQ;IAI3B;;OAEG;IACH,iBAAiB,CAAC,OAAO,EAAE,OAAO,CAAC,QAAQ,CAAC,GAAG,QAAQ;IAQvD;;OAEG;IACH,OAAO,CAAC,SAAS;IAwBjB;;OAEG;IACH,MAAM,CAAC,MAAM,EAAE,QAAQ,GAAG,MAAM;IAKhC,OAAO,CAAC,YAAY;CAwBrB"}

package/dist/compatibility/config-migrator.js

@@ -0,0 +1,280 @@
+/**
+ * Config Migrator - Migrates V2 configuration to V3 format
+ */
+/**
+ * Default V3 configuration values
+ */
+const DEFAULT_V3_CONFIG = {
+    v3: {
+        version: '3.0.0',
+        domains: [
+            'test-generation',
+            'test-execution',
+            'coverage-analysis',
+            'quality-assessment',
+            'defect-intelligence',
+            'code-intelligence',
+            'requirements-validation',
+            'security-compliance',
+            'contract-testing',
+            'visual-accessibility',
+            'chaos-resilience',
+            'learning-optimization',
+        ],
+        agents: {
+            maxConcurrent: 15,
+            timeout: 300000,
+            retryOnFailure: true,
+            maxRetries: 3,
+        },
+        memory: {
+            backend: 'hybrid',
+            sqlite: { path: '.agentic-qe/memory.db' },
+            agentdb: { enabled: true },
+            hnsw: {
+                enabled: true,
+                M: 16,
+                efConstruction: 200,
+                efSearch: 100,
+            },
+        },
+        learning: {
+            enabled: true,
+            neuralLearning: true,
+            patternRetention: 180,
+            transferEnabled: true,
+        },
+        coverage: {
+            algorithm: 'sublinear',
+            thresholds: {
+                statements: 80,
+                branches: 75,
+                functions: 85,
+                lines: 80,
+            },
+            riskWeighted: true,
+        },
+        qualityGates: {
+            coverage: { min: 80, blocking: true },
+            complexity: { max: 15, blocking: false },
+            vulnerabilities: { critical: 0, high: 0, blocking: true },
+        },
+    },
+};
+/**
+ * Config Migrator class for V2 to V3 configuration migration
+ */
+export class ConfigMigrator {
+    /**
+     * Migrate a V2 configuration to V3 format
+     */
+    migrate(v2Config) {
+        const warnings = [];
+        const unmappedKeys = [];
+        // Start with defaults
+        const v3Config = JSON.parse(JSON.stringify(DEFAULT_V3_CONFIG));
+        // Migrate version
+        if (v2Config.version) {
+            warnings.push(`V2 version "${v2Config.version}" detected. Migrating to v3.0.0`);
+        }
+        // Migrate memory backend
+        if (v2Config.memory?.backend) {
+            const backend = v2Config.memory.backend.toLowerCase();
+            if (backend === 'sqlite') {
+                v3Config.v3.memory.backend = 'sqlite';
+                v3Config.v3.memory.agentdb = { enabled: false };
+                warnings.push('Memory backend "sqlite" preserved. Consider upgrading to "hybrid" for better performance.');
+            }
+            else if (backend === 'agentdb') {
+                v3Config.v3.memory.backend = 'agentdb';
+            }
+            // 'hybrid' is default
+        }
+        // Migrate memory path
+        if (v2Config.memory?.path) {
+            v3Config.v3.memory.sqlite = { path: v2Config.memory.path };
+        }
+        // Migrate learning settings
+        if (v2Config.learning !== undefined) {
+            if (typeof v2Config.learning === 'object') {
+                if (v2Config.learning.enabled !== undefined) {
+                    v3Config.v3.learning.enabled = v2Config.learning.enabled;
+                }
+                if (v2Config.learning.patternRetention !== undefined) {
+                    v3Config.v3.learning.patternRetention =
+                        v2Config.learning.patternRetention;
+                }
+            }
+        }
+        // Migrate coverage threshold
+        if (v2Config.coverage?.threshold) {
+            const threshold = v2Config.coverage.threshold;
+            v3Config.v3.coverage.thresholds = {
+                statements: threshold,
+                branches: Math.max(threshold - 5, 50),
+                functions: threshold,
+                lines: threshold,
+            };
+            v3Config.v3.qualityGates.coverage.min = threshold;
+        }
+        // Migrate agents list (convert to domains)
+        if (v2Config.agents && Array.isArray(v2Config.agents)) {
+            const domains = this.inferDomainsFromAgents(v2Config.agents);
+            if (domains.length > 0) {
+                v3Config.v3.domains = domains;
+                warnings.push(`Inferred ${domains.length} domains from v2 agent list.`);
+            }
+        }
+        // Check for unmapped keys
+        const knownKeys = [
+            'version',
+            'agents',
+            'memory',
+            'learning',
+            'coverage',
+        ];
+        for (const key of Object.keys(v2Config)) {
+            if (!knownKeys.includes(key)) {
+                unmappedKeys.push(key);
+            }
+        }
+        if (unmappedKeys.length > 0) {
+            warnings.push(`The following v2 config keys were not migrated: ${unmappedKeys.join(', ')}`);
+        }
+        return {
+            success: true,
+            v3Config,
+            warnings,
+            unmappedKeys,
+        };
+    }
+    /**
+     * Infer domains from v2 agent list
+     */
+    inferDomainsFromAgents(agents) {
+        const domainSet = new Set();
+        const agentToDomain = {
+            'qe-test-generator': 'test-generation',
+            'qe-test-executor': 'test-execution',
+            'qe-coverage-analyzer': 'coverage-analysis',
+            'qe-quality-gate': 'quality-assessment',
+            'qe-quality-analyzer': 'quality-assessment',
+            'qe-regression-risk-analyzer': 'defect-intelligence',
+            'qe-code-intelligence': 'code-intelligence',
+            'qe-requirements-validator': 'requirements-validation',
+            'qe-security-scanner': 'security-compliance',
+            'qe-api-contract-validator': 'contract-testing',
+            'qe-visual-tester': 'visual-accessibility',
+            'qe-a11y-ally': 'visual-accessibility',
+            'qe-chaos-engineer': 'chaos-resilience',
+            'qe-performance-tester': 'chaos-resilience',
+            'qe-production-intelligence': 'learning-optimization',
+        };
+        for (const agent of agents) {
+            const domain = agentToDomain[agent.toLowerCase()];
+            if (domain) {
+                domainSet.add(domain);
+            }
+        }
+        // If domains were detected, ensure we have the full set
+        if (domainSet.size > 0) {
+            return DEFAULT_V3_CONFIG.v3.domains;
+        }
+        return [];
+    }
+    /**
+     * Validate a V3 configuration
+     */
+    validate(config) {
+        const errors = [];
+        if (!config.v3) {
+            errors.push('Missing "v3" root key');
+            return { valid: false, errors };
+        }
+        if (!config.v3.version) {
+            errors.push('Missing version');
+        }
+        if (!config.v3.domains ||
+            !Array.isArray(config.v3.domains) ||
+            config.v3.domains.length === 0) {
+            errors.push('Missing or empty domains array');
+        }
+        if (!config.v3.agents?.maxConcurrent) {
+            errors.push('Missing agents.maxConcurrent');
+        }
+        else if (config.v3.agents.maxConcurrent < 1 ||
+            config.v3.agents.maxConcurrent > 50) {
+            errors.push('agents.maxConcurrent must be between 1 and 50');
+        }
+        if (!config.v3.memory?.backend) {
+            errors.push('Missing memory.backend');
+        }
+        else if (!['sqlite', 'agentdb', 'hybrid'].includes(config.v3.memory.backend)) {
+            errors.push('memory.backend must be one of: sqlite, agentdb, hybrid');
+        }
+        return { valid: errors.length === 0, errors };
+    }
+    /**
+     * Generate a default V3 configuration
+     */
+    generateDefault() {
+        return JSON.parse(JSON.stringify(DEFAULT_V3_CONFIG));
+    }
+    /**
+     * Merge a partial config with defaults
+     */
+    mergeWithDefaults(partial) {
+        const defaults = this.generateDefault();
+        return this.deepMerge(defaults, partial);
+    }
+    /**
+     * Deep merge two objects
+     */
+    deepMerge(target, source) {
+        const result = { ...target };
+        for (const key of Object.keys(source)) {
+            if (source[key] &&
+                typeof source[key] === 'object' &&
+                !Array.isArray(source[key])) {
+                result[key] = this.deepMerge(target[key] || {}, source[key]);
+            }
+            else {
+                result[key] = source[key];
+            }
+        }
+        return result;
+    }
+    /**
+     * Generate YAML representation of V3 config
+     */
+    toYAML(config) {
+        // Simple YAML generation (in production, use a proper YAML library)
+        return this.objectToYAML(config, 0);
+    }
+    objectToYAML(obj, indent) {
+        const spaces = '  '.repeat(indent);
+        let yaml = '';
+        if (Array.isArray(obj)) {
+            for (const item of obj) {
+                if (typeof item === 'object') {
+                    yaml += `${spaces}-\n${this.objectToYAML(item, indent + 1)}`;
+                }
+                else {
+                    yaml += `${spaces}- ${item}\n`;
+                }
+            }
+        }
+        else if (typeof obj === 'object' && obj !== null) {
+            for (const [key, value] of Object.entries(obj)) {
+                if (typeof value === 'object' && value !== null) {
+                    yaml += `${spaces}${key}:\n${this.objectToYAML(value, indent + 1)}`;
+                }
+                else {
+                    yaml += `${spaces}${key}: ${value}\n`;
+                }
+            }
+        }
+        return yaml;
+    }
+}
+//# sourceMappingURL=config-migrator.js.map

package/dist/compatibility/config-migrator.js.map

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

package/dist/compatibility/index.d.ts

@@ -0,0 +1,58 @@
+/**
+ * V2 Compatibility Layer
+ *
+ * Provides backward compatibility for v2 APIs, allowing gradual migration to v3.
+ * - Agent name mapping (v2 → v3)
+ * - CLI command forwarding
+ * - MCP tool adaptation
+ * - Configuration migration
+ *
+ * @module compatibility
+ */
+export * from './types';
+export * from './agent-mapper';
+export * from './cli-adapter';
+export * from './mcp-adapter';
+export * from './config-migrator';
+import { AgentMapper } from './agent-mapper';
+import { CLIAdapter } from './cli-adapter';
+import { MCPAdapter } from './mcp-adapter';
+import { ConfigMigrator } from './config-migrator';
+/**
+ * V2 Compatibility Layer singleton
+ */
+export declare class V2CompatibilityLayer {
+    private static instance;
+    readonly agents: AgentMapper;
+    readonly cli: CLIAdapter;
+    readonly mcp: MCPAdapter;
+    readonly config: ConfigMigrator;
+    private deprecationWarnings;
+    private warningsEnabled;
+    private constructor();
+    static getInstance(): V2CompatibilityLayer;
+    /**
+     * Enable or disable deprecation warnings
+     */
+    setWarningsEnabled(enabled: boolean): void;
+    /**
+     * Emit a deprecation warning (once per unique message)
+     */
+    warnDeprecation(v2Feature: string, v3Alternative: string): void;
+    /**
+     * Check if running in compatibility mode
+     */
+    isCompatibilityMode(): boolean;
+    /**
+     * Get migration status report
+     */
+    getMigrationStatus(): MigrationStatus;
+    private getRecommendedActions;
+}
+interface MigrationStatus {
+    v2FeaturesUsed: number;
+    warnings: string[];
+    recommendedActions: string[];
+}
+export declare const compatibility: V2CompatibilityLayer;
+//# sourceMappingURL=index.d.ts.map

package/dist/compatibility/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/compatibility/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,cAAc,SAAS,CAAC;AACxB,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAC9B,cAAc,mBAAmB,CAAC;AAElC,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7C,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAC3C,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAC3C,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAEnD;;GAEG;AACH,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAuB;IAE9C,SAAgB,MAAM,EAAE,WAAW,CAAC;IACpC,SAAgB,GAAG,EAAE,UAAU,CAAC;IAChC,SAAgB,GAAG,EAAE,UAAU,CAAC;IAChC,SAAgB,MAAM,EAAE,cAAc,CAAC;IAEvC,OAAO,CAAC,mBAAmB,CAA0B;IACrD,OAAO,CAAC,eAAe,CAAiB;IAExC,OAAO;IAOP,MAAM,CAAC,WAAW,IAAI,oBAAoB;IAO1C;;OAEG;IACH,kBAAkB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;IAI1C;;OAEG;IACH,eAAe,CAAC,SAAS,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,GAAG,IAAI;IAY/D;;OAEG;IACH,mBAAmB,IAAI,OAAO;IAI9B;;OAEG;IACH,kBAAkB,IAAI,eAAe;IAQrC,OAAO,CAAC,qBAAqB;CAW9B;AAED,UAAU,eAAe;IACvB,cAAc,EAAE,MAAM,CAAC;IACvB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,kBAAkB,EAAE,MAAM,EAAE,CAAC;CAC9B;AAGD,eAAO,MAAM,aAAa,sBAAqC,CAAC"}