agentic-qe 3.3.0 → 3.3.1

package/v3/dist/cli/handlers/init-handler.js

@@ -0,0 +1,288 @@
+/**
+ * Agentic QE v3 - Init Command Handler
+ *
+ * Handles the 'aqe init' command for system initialization.
+ */
+import chalk from 'chalk';
+import { QEKernelImpl } from '../../kernel/kernel.js';
+import { ALL_DOMAINS } from '../../shared/types/index.js';
+import { CrossDomainEventRouter } from '../../coordination/cross-domain-router.js';
+import { DefaultProtocolExecutor } from '../../coordination/protocol-executor.js';
+import { WorkflowOrchestrator } from '../../coordination/workflow-orchestrator.js';
+import { createQueenCoordinator } from '../../coordination/queen-coordinator.js';
+import { InitOrchestrator } from '../../init/init-wizard.js';
+import { createModularInitOrchestrator, } from '../../init/orchestrator.js';
+import { setupClaudeFlowIntegration } from '../commands/claude-flow-setup.js';
+// ============================================================================
+// Init Handler
+// ============================================================================
+export class InitHandler {
+    name = 'init';
+    description = 'Initialize the AQE v3 system';
+    cleanupAndExit;
+    constructor(cleanupAndExit) {
+        this.cleanupAndExit = cleanupAndExit;
+    }
+    register(program, context) {
+        program
+            .command('init')
+            .description(this.description)
+            .option('-d, --domains <domains>', 'Comma-separated list of domains to enable', 'all')
+            .option('-m, --max-agents <number>', 'Maximum concurrent agents', '15')
+            .option('--memory <backend>', 'Memory backend (sqlite|agentdb|hybrid)', 'hybrid')
+            .option('--lazy', 'Enable lazy loading of domains')
+            .option('--wizard', 'Run interactive setup wizard')
+            .option('--auto', 'Auto-configure based on project analysis')
+            .option('--minimal', 'Minimal configuration (skip optional features)')
+            .option('--skip-patterns', 'Skip loading pre-trained patterns')
+            .option('--with-n8n', 'Install n8n workflow testing agents and skills')
+            .option('--auto-migrate', 'Automatically migrate from v2 if detected')
+            .option('--with-claude-flow', 'Force Claude Flow integration setup')
+            .option('--skip-claude-flow', 'Skip Claude Flow integration')
+            .option('--modular', 'Use new modular init system (default for --auto)')
+            .action(async (options) => {
+            await this.execute(options, context);
+        });
+    }
+    async execute(options, context) {
+        try {
+            // --auto-migrate implies --auto (must use orchestrator for migration)
+            if (options.autoMigrate && !options.auto && !options.wizard) {
+                options.auto = true;
+            }
+            // Check if wizard mode requested
+            if (options.wizard || options.auto) {
+                console.log(chalk.blue('\n  Agentic QE v3 Initialization\n'));
+                // Use modular orchestrator for --auto or --modular
+                if (options.auto || options.modular) {
+                    await this.runModularInit(options, context);
+                    return;
+                }
+                // Legacy wizard mode using InitOrchestrator
+                await this.runLegacyWizard(options, context);
+                return;
+            }
+            // Standard init without wizard
+            await this.runStandardInit(options, context);
+        }
+        catch (error) {
+            console.error(chalk.red('\n  Failed to initialize:'), error);
+            await this.cleanupAndExit(1);
+        }
+    }
+    async runModularInit(options, context) {
+        const orchestrator = createModularInitOrchestrator({
+            projectRoot: process.cwd(),
+            autoMode: options.auto,
+            minimal: options.minimal,
+            skipPatterns: options.skipPatterns,
+            withN8n: options.withN8n,
+            autoMigrate: options.autoMigrate,
+        });
+        console.log(chalk.white('  Analyzing project...\n'));
+        const result = await orchestrator.initialize();
+        // Display step results
+        for (const step of result.steps) {
+            const statusIcon = step.status === 'success' ? '*' : step.status === 'error' ? 'x' : '!';
+            const statusColor = step.status === 'success' ? chalk.green : step.status === 'error' ? chalk.red : chalk.yellow;
+            console.log(statusColor(`  ${statusIcon} ${step.step} (${step.durationMs}ms)`));
+        }
+        console.log('');
+        // Claude Flow integration (after base init)
+        let cfResult;
+        if (!options.skipClaudeFlow && (options.withClaudeFlow || result.success)) {
+            try {
+                cfResult = await setupClaudeFlowIntegration({
+                    projectRoot: process.cwd(),
+                    force: options.withClaudeFlow,
+                });
+                if (cfResult.available) {
+                    console.log(chalk.green('  * Claude Flow integration enabled'));
+                    if (cfResult.features.trajectories) {
+                        console.log(chalk.gray('    - SONA trajectory tracking'));
+                    }
+                    if (cfResult.features.modelRouting) {
+                        console.log(chalk.gray('    - 3-tier model routing (haiku/sonnet/opus)'));
+                    }
+                    if (cfResult.features.pretrain) {
+                        console.log(chalk.gray('    - Codebase pretrain analysis'));
+                    }
+                    console.log('');
+                }
+            }
+            catch {
+                // Claude Flow not available - continue without it
+            }
+        }
+        if (result.success) {
+            console.log(chalk.green('  AQE v3 initialized successfully!\n'));
+            // Show summary
+            console.log(chalk.blue('  Summary:'));
+            console.log(chalk.gray(`    - Patterns loaded: ${result.summary.patternsLoaded}`));
+            console.log(chalk.gray(`    - Skills installed: ${result.summary.skillsInstalled}`));
+            console.log(chalk.gray(`    - Agents installed: ${result.summary.agentsInstalled}`));
+            console.log(chalk.gray(`    - Hooks configured: ${result.summary.hooksConfigured ? 'Yes' : 'No'}`));
+            console.log(chalk.gray(`    - Workers started: ${result.summary.workersStarted}`));
+            console.log(chalk.gray(`    - Claude Flow: ${cfResult?.available ? 'Enabled' : 'Standalone mode'}`));
+            console.log(chalk.gray(`    - Total time: ${result.totalDurationMs}ms\n`));
+            console.log(chalk.white('Next steps:'));
+            console.log(chalk.gray('  1. Add MCP: claude mcp add aqe -- aqe-mcp'));
+            console.log(chalk.gray('  2. Run tests: aqe test <path>'));
+            console.log(chalk.gray('  3. Check status: aqe status\n'));
+        }
+        else {
+            console.log(chalk.red('  Initialization failed. Check errors above.\n'));
+            await this.cleanupAndExit(1);
+        }
+        await this.cleanupAndExit(0);
+    }
+    async runLegacyWizard(options, context) {
+        const orchestratorOptions = {
+            projectRoot: process.cwd(),
+            autoMode: options.auto,
+            minimal: options.minimal,
+            skipPatterns: options.skipPatterns,
+            withN8n: options.withN8n,
+            autoMigrate: options.autoMigrate,
+        };
+        const orchestrator = new InitOrchestrator(orchestratorOptions);
+        if (options.wizard) {
+            // Show wizard steps
+            console.log(chalk.white('  Setup Wizard Steps:\n'));
+            const steps = orchestrator.getWizardSteps();
+            for (let i = 0; i < steps.length; i++) {
+                console.log(chalk.gray(`  ${i + 1}. ${steps[i].title}`));
+                console.log(chalk.gray(`     ${steps[i].description}\n`));
+            }
+        }
+        console.log(chalk.white('  Analyzing project...\n'));
+        const result = await orchestrator.initialize();
+        // Display step results
+        for (const step of result.steps) {
+            const statusIcon = step.status === 'success' ? '*' : step.status === 'error' ? 'x' : '!';
+            const statusColor = step.status === 'success' ? chalk.green : step.status === 'error' ? chalk.red : chalk.yellow;
+            console.log(statusColor(`  ${statusIcon} ${step.step} (${step.durationMs}ms)`));
+        }
+        console.log('');
+        if (result.success) {
+            console.log(chalk.green('  AQE v3 initialized successfully!\n'));
+            // Show summary
+            console.log(chalk.blue('  Summary:'));
+            console.log(chalk.gray(`    - Patterns loaded: ${result.summary.patternsLoaded}`));
+            console.log(chalk.gray(`    - Hooks configured: ${result.summary.hooksConfigured ? 'Yes' : 'No'}`));
+            console.log(chalk.gray(`    - Workers started: ${result.summary.workersStarted}`));
+            if (result.summary.n8nInstalled) {
+                console.log(chalk.gray(`    - N8n agents: ${result.summary.n8nInstalled.agents}`));
+                console.log(chalk.gray(`    - N8n skills: ${result.summary.n8nInstalled.skills}`));
+            }
+            console.log(chalk.gray(`    - Total time: ${result.totalDurationMs}ms\n`));
+            console.log(chalk.white('Next steps:'));
+            console.log(chalk.gray('  1. Add MCP: claude mcp add aqe -- aqe-mcp'));
+            console.log(chalk.gray('  2. Run tests: aqe test <path>'));
+            console.log(chalk.gray('  3. Check status: aqe status\n'));
+        }
+        else {
+            console.log(chalk.red('  Initialization failed. Check errors above.\n'));
+            await this.cleanupAndExit(1);
+        }
+        await this.cleanupAndExit(0);
+    }
+    async runStandardInit(options, context) {
+        console.log(chalk.blue('\n  Initializing Agentic QE v3...\n'));
+        // Determine enabled domains
+        const enabledDomains = options.domains === 'all'
+            ? [...ALL_DOMAINS]
+            : options.domains.split(',').filter((d) => ALL_DOMAINS.includes(d));
+        console.log(chalk.gray(`  Domains: ${enabledDomains.length}`));
+        console.log(chalk.gray(`  Max Agents: ${options.maxAgents}`));
+        console.log(chalk.gray(`  Memory: ${options.memory}`));
+        console.log(chalk.gray(`  Lazy Loading: ${options.lazy ? 'enabled' : 'disabled'}\n`));
+        // Create kernel
+        context.kernel = new QEKernelImpl({
+            maxConcurrentAgents: parseInt(options.maxAgents, 10),
+            memoryBackend: options.memory,
+            hnswEnabled: true,
+            lazyLoading: options.lazy || false,
+            enabledDomains,
+        });
+        await context.kernel.initialize();
+        console.log(chalk.green('  * Kernel initialized'));
+        // Create cross-domain router
+        context.router = new CrossDomainEventRouter(context.kernel.eventBus);
+        await context.router.initialize();
+        console.log(chalk.green('  * Cross-domain router initialized'));
+        // Create protocol executor
+        const getDomainAPI = (domain) => {
+            return context.kernel.getDomainAPI(domain);
+        };
+        const protocolExecutor = new DefaultProtocolExecutor(context.kernel.eventBus, context.kernel.memory, getDomainAPI);
+        console.log(chalk.green('  * Protocol executor initialized'));
+        // Create workflow orchestrator
+        context.workflowOrchestrator = new WorkflowOrchestrator(context.kernel.eventBus, context.kernel.memory, context.kernel.coordinator);
+        await context.workflowOrchestrator.initialize();
+        // Register domain workflow actions (Issue #206)
+        this.registerDomainWorkflowActions(context.kernel, context.workflowOrchestrator);
+        console.log(chalk.green('  * Workflow orchestrator initialized'));
+        // Create Queen Coordinator
+        context.queen = createQueenCoordinator(context.kernel, context.router, protocolExecutor, undefined);
+        await context.queen.initialize();
+        console.log(chalk.green('  * Queen Coordinator initialized'));
+        context.initialized = true;
+        console.log(chalk.green('\n  AQE v3 initialized successfully!\n'));
+        // Show enabled domains
+        console.log(chalk.blue('  Enabled Domains:'));
+        for (const domain of enabledDomains) {
+            console.log(chalk.gray(`    - ${domain}`));
+        }
+        console.log('');
+        await this.cleanupAndExit(0);
+    }
+    registerDomainWorkflowActions(kernel, orchestrator) {
+        // Register visual-accessibility domain actions
+        const visualAccessibilityAPI = kernel.getDomainAPI('visual-accessibility');
+        if (visualAccessibilityAPI?.registerWorkflowActions) {
+            try {
+                visualAccessibilityAPI.registerWorkflowActions(orchestrator);
+            }
+            catch (error) {
+                // Log but don't fail - domain may not be enabled
+                console.error(chalk.yellow(`  ! Could not register visual-accessibility workflow actions: ${error instanceof Error ? error.message : String(error)}`));
+            }
+        }
+    }
+    getHelp() {
+        return `
+Initialize the AQE v3 system with various configuration options.
+
+Usage:
+  aqe init [options]
+
+Options:
+  -d, --domains <domains>    Comma-separated list of domains to enable (default: all)
+  -m, --max-agents <number>  Maximum concurrent agents (default: 15)
+  --memory <backend>         Memory backend: sqlite, agentdb, or hybrid (default: hybrid)
+  --lazy                     Enable lazy loading of domains
+  --wizard                   Run interactive setup wizard
+  --auto                     Auto-configure based on project analysis
+  --minimal                  Minimal configuration (skip optional features)
+  --skip-patterns            Skip loading pre-trained patterns
+  --with-n8n                 Install n8n workflow testing agents and skills
+  --auto-migrate             Automatically migrate from v2 if detected
+  --with-claude-flow         Force Claude Flow integration setup
+  --skip-claude-flow         Skip Claude Flow integration
+  --modular                  Use new modular init system
+
+Examples:
+  aqe init --auto            # Auto-configure based on project
+  aqe init --wizard          # Run interactive wizard
+  aqe init --domains test-generation,coverage-analysis
+`;
+    }
+}
+// ============================================================================
+// Factory
+// ============================================================================
+export function createInitHandler(cleanupAndExit) {
+    return new InitHandler(cleanupAndExit);
+}
+//# sourceMappingURL=init-handler.js.map

package/v3/dist/cli/handlers/init-handler.js.map

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

package/v3/dist/cli/handlers/interfaces.d.ts

@@ -0,0 +1,104 @@
+/**
+ * Agentic QE v3 - Command Handler Interfaces
+ *
+ * Defines the common interfaces for all CLI command handlers.
+ * Part of the CLI modularization refactoring.
+ */
+import { Command } from 'commander';
+import { QEKernel } from '../../kernel/interfaces.js';
+import { QueenCoordinator } from '../../coordination/queen-coordinator.js';
+import { CrossDomainEventRouter } from '../../coordination/cross-domain-router.js';
+import { WorkflowOrchestrator } from '../../coordination/workflow-orchestrator.js';
+import type { PersistentScheduler } from '../scheduler/index.js';
+export interface ScheduledWorkflow {
+    id: string;
+    workflowId: string;
+    pipelinePath: string;
+    schedule: string;
+    scheduleDescription: string;
+    nextRun: Date;
+    enabled: boolean;
+    createdAt: Date;
+    lastRun?: Date;
+}
+/**
+ * Shared CLI context that command handlers can access
+ */
+export interface CLIContext {
+    kernel: QEKernel | null;
+    queen: QueenCoordinator | null;
+    router: CrossDomainEventRouter | null;
+    workflowOrchestrator: WorkflowOrchestrator | null;
+    scheduledWorkflows: Map<string, ScheduledWorkflow>;
+    persistentScheduler: PersistentScheduler | null;
+    initialized: boolean;
+}
+/**
+ * Command options common to many handlers
+ */
+export interface CommonOptions {
+    verbose?: boolean;
+    json?: boolean;
+    progress?: boolean;
+}
+/**
+ * Interface for all command handlers
+ */
+export interface ICommandHandler {
+    /** Unique command name */
+    readonly name: string;
+    /** Command description shown in help */
+    readonly description: string;
+    /** Aliases for the command (e.g., 't' for 'task') */
+    readonly aliases?: string[];
+    /**
+     * Register the command with the Commander program
+     * @param program The Commander program or parent command
+     * @param context Shared CLI context
+     */
+    register(program: Command, context: CLIContext): void;
+    /**
+     * Get help text for this command
+     */
+    getHelp(): string;
+}
+/**
+ * Interface for command handlers that require initialization
+ */
+export interface IInitializableHandler extends ICommandHandler {
+    /**
+     * Initialize handler-specific state
+     */
+    initialize(context: CLIContext): Promise<void>;
+    /**
+     * Cleanup handler-specific state
+     */
+    dispose(): Promise<void>;
+}
+/**
+ * Get status color based on status string
+ */
+export declare function getStatusColor(status: string): string;
+/**
+ * Format duration in human-readable format
+ */
+export declare function formatDuration(ms: number): string;
+/**
+ * Format uptime in human-readable format
+ */
+export declare function formatUptime(ms: number): string;
+/**
+ * Get color function based on percentage value
+ */
+export declare function getColorForPercent(percent: number): (str: string) => string;
+/**
+ * Walk directory recursively to find files
+ */
+export declare function walkDirectory(dir: string, options?: {
+    extensions?: string[];
+    exclude?: string[];
+    maxDepth?: number;
+    includeTests?: boolean;
+}): Promise<string[]>;
+export type { Command };
+//# sourceMappingURL=interfaces.d.ts.map

package/v3/dist/cli/handlers/interfaces.d.ts.map

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

package/v3/dist/cli/handlers/interfaces.js

@@ -0,0 +1,109 @@
+/**
+ * Agentic QE v3 - Command Handler Interfaces
+ *
+ * Defines the common interfaces for all CLI command handlers.
+ * Part of the CLI modularization refactoring.
+ */
+import chalk from 'chalk';
+// ============================================================================
+// Helper Functions for Handlers
+// ============================================================================
+/**
+ * Get status color based on status string
+ */
+export function getStatusColor(status) {
+    switch (status) {
+        case 'healthy':
+        case 'completed':
+            return chalk.green(status);
+        case 'idle':
+            // Issue #205 fix: 'idle' is normal - show in cyan (neutral/ready)
+            return chalk.cyan(status);
+        case 'degraded':
+        case 'running':
+            return chalk.yellow(status);
+        case 'unhealthy':
+        case 'failed':
+            return chalk.red(status);
+        default:
+            return chalk.gray(status);
+    }
+}
+/**
+ * Format duration in human-readable format
+ */
+export function formatDuration(ms) {
+    if (ms < 1000)
+        return `${ms}ms`;
+    if (ms < 60000)
+        return `${(ms / 1000).toFixed(1)}s`;
+    if (ms < 3600000)
+        return `${(ms / 60000).toFixed(1)}m`;
+    return `${(ms / 3600000).toFixed(1)}h`;
+}
+/**
+ * Format uptime in human-readable format
+ */
+export function formatUptime(ms) {
+    const hours = Math.floor(ms / 3600000);
+    const minutes = Math.floor((ms % 3600000) / 60000);
+    const seconds = Math.floor((ms % 60000) / 1000);
+    return `${hours}h ${minutes}m ${seconds}s`;
+}
+/**
+ * Get color function based on percentage value
+ */
+export function getColorForPercent(percent) {
+    if (percent >= 80)
+        return chalk.green;
+    if (percent >= 50)
+        return chalk.yellow;
+    return chalk.red;
+}
+/**
+ * Walk directory recursively to find files
+ */
+export async function walkDirectory(dir, options = {}) {
+    const fs = await import('fs');
+    const path = await import('path');
+    const { extensions = ['.ts'], exclude = ['node_modules', 'dist'], maxDepth = 4, includeTests = false, } = options;
+    const walkDir = (currentDir, depth) => {
+        if (depth > maxDepth)
+            return [];
+        const result = [];
+        let items;
+        try {
+            items = fs.readdirSync(currentDir);
+        }
+        catch {
+            return [];
+        }
+        for (const item of items) {
+            if (exclude.includes(item))
+                continue;
+            if (!includeTests && (item === 'tests' || item.includes('.test.') || item.includes('.spec.')))
+                continue;
+            const fullPath = path.join(currentDir, item);
+            let stat;
+            try {
+                stat = fs.statSync(fullPath);
+            }
+            catch {
+                continue;
+            }
+            if (stat.isDirectory()) {
+                result.push(...walkDir(fullPath, depth + 1));
+            }
+            else {
+                const hasValidExtension = extensions.some(ext => item.endsWith(ext));
+                const isDeclarationFile = item.endsWith('.d.ts');
+                if (hasValidExtension && !isDeclarationFile) {
+                    result.push(fullPath);
+                }
+            }
+        }
+        return result;
+    };
+    return walkDir(dir, 0);
+}
+//# sourceMappingURL=interfaces.js.map

package/v3/dist/cli/handlers/interfaces.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"interfaces.js","sourceRoot":"","sources":["../../../src/cli/handlers/interfaces.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,MAAM,OAAO,CAAC;AA2F1B,+EAA+E;AAC/E,gCAAgC;AAChC,+EAA+E;AAE/E;;GAEG;AACH,MAAM,UAAU,cAAc,CAAC,MAAc;IAC3C,QAAQ,MAAM,EAAE,CAAC;QACf,KAAK,SAAS,CAAC;QACf,KAAK,WAAW;YACd,OAAO,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QAC7B,KAAK,MAAM;YACT,kEAAkE;YAClE,OAAO,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAC5B,KAAK,UAAU,CAAC;QAChB,KAAK,SAAS;YACZ,OAAO,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QAC9B,KAAK,WAAW,CAAC;QACjB,KAAK,QAAQ;YACX,OAAO,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QAC3B;YACE,OAAO,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAC9B,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,cAAc,CAAC,EAAU;IACvC,IAAI,EAAE,GAAG,IAAI;QAAE,OAAO,GAAG,EAAE,IAAI,CAAC;IAChC,IAAI,EAAE,GAAG,KAAK;QAAE,OAAO,GAAG,CAAC,EAAE,GAAG,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC;IACpD,IAAI,EAAE,GAAG,OAAO;QAAE,OAAO,GAAG,CAAC,EAAE,GAAG,KAAK,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC;IACvD,OAAO,GAAG,CAAC,EAAE,GAAG,OAAO,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC;AACzC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,YAAY,CAAC,EAAU;IACrC,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,GAAG,OAAO,CAAC,CAAC;IACvC,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,OAAO,CAAC,GAAG,KAAK,CAAC,CAAC;IACnD,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,KAAK,CAAC,GAAG,IAAI,CAAC,CAAC;IAChD,OAAO,GAAG,KAAK,KAAK,OAAO,KAAK,OAAO,GAAG,CAAC;AAC7C,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAAC,OAAe;IAChD,IAAI,OAAO,IAAI,EAAE;QAAE,OAAO,KAAK,CAAC,KAAK,CAAC;IACtC,IAAI,OAAO,IAAI,EAAE;QAAE,OAAO,KAAK,CAAC,MAAM,CAAC;IACvC,OAAO,KAAK,CAAC,GAAG,CAAC;AACnB,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,GAAW,EACX,UAKI,EAAE;IAEN,MAAM,EAAE,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,CAAC;IAC9B,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC,CAAC;IAElC,MAAM,EACJ,UAAU,GAAG,CAAC,KAAK,CAAC,EACpB,OAAO,GAAG,CAAC,cAAc,EAAE,MAAM,CAAC,EAClC,QAAQ,GAAG,CAAC,EACZ,YAAY,GAAG,KAAK,GACrB,GAAG,OAAO,CAAC;IAEZ,MAAM,OAAO,GAAG,CAAC,UAAkB,EAAE,KAAa,EAAY,EAAE;QAC9D,IAAI,KAAK,GAAG,QAAQ;YAAE,OAAO,EAAE,CAAC;QAEhC,MAAM,MAAM,GAAa,EAAE,CAAC;QAC5B,IAAI,KAAe,CAAC;QAEpB,IAAI,CAAC;YACH,KAAK,GAAG,EAAE,CAAC,WAAW,CAAC,UAAU,CAAC,CAAC;QACrC,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,EAAE,CAAC;QACZ,CAAC;QAED,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,IAAI,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC;gBAAE,SAAS;YACrC,IAAI,CAAC,YAAY,IAAI,CAAC,IAAI,KAAK,OAAO,IAAI,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;gBAAE,SAAS;YAExG,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC;YAC7C,IAAI,IAAI,CAAC;YAET,IAAI,CAAC;gBACH,IAAI,GAAG,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;YAC/B,CAAC;YAAC,MAAM,CAAC;gBACP,SAAS;YACX,CAAC;YAED,IAAI,IAAI,CAAC,WAAW,EAAE,EAAE,CAAC;gBACvB,MAAM,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,QAAQ,EAAE,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC;YAC/C,CAAC;iBAAM,CAAC;gBACN,MAAM,iBAAiB,GAAG,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC;gBACrE,MAAM,iBAAiB,GAAG,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;gBAEjD,IAAI,iBAAiB,IAAI,CAAC,iBAAiB,EAAE,CAAC;oBAC5C,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;gBACxB,CAAC;YACH,CAAC;QACH,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC,CAAC;IAEF,OAAO,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;AACzB,CAAC"}

package/v3/dist/cli/handlers/protocol-handler.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Agentic QE v3 - Protocol Command Handler
+ *
+ * Handles the 'aqe protocol' command group for protocol execution.
+ */
+import { Command } from 'commander';
+import { ICommandHandler, CLIContext } from './interfaces.js';
+export declare class ProtocolHandler implements ICommandHandler {
+    readonly name = "protocol";
+    readonly description = "Execute coordination protocols";
+    private cleanupAndExit;
+    private ensureInitialized;
+    constructor(cleanupAndExit: (code: number) => Promise<never>, ensureInitialized: () => Promise<boolean>);
+    register(program: Command, context: CLIContext): void;
+    private executeRun;
+    getHelp(): string;
+}
+export declare function createProtocolHandler(cleanupAndExit: (code: number) => Promise<never>, ensureInitialized: () => Promise<boolean>): ProtocolHandler;
+//# sourceMappingURL=protocol-handler.d.ts.map

package/v3/dist/cli/handlers/protocol-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocol-handler.d.ts","sourceRoot":"","sources":["../../../src/cli/handlers/protocol-handler.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,OAAO,EACL,eAAe,EACf,UAAU,EACX,MAAM,iBAAiB,CAAC;AAOzB,qBAAa,eAAgB,YAAW,eAAe;IACrD,QAAQ,CAAC,IAAI,cAAc;IAC3B,QAAQ,CAAC,WAAW,oCAAoC;IAExD,OAAO,CAAC,cAAc,CAAmC;IACzD,OAAO,CAAC,iBAAiB,CAAyB;gBAGhD,cAAc,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,KAAK,CAAC,EAChD,iBAAiB,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC;IAM3C,QAAQ,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,UAAU,GAAG,IAAI;YAevC,UAAU;IAyBxB,OAAO,IAAI,MAAM;CAkBlB;AAcD,wBAAgB,qBAAqB,CACnC,cAAc,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,KAAK,CAAC,EAChD,iBAAiB,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,GACxC,eAAe,CAEjB"}

package/v3/dist/cli/handlers/protocol-handler.js

@@ -0,0 +1,79 @@
+/**
+ * Agentic QE v3 - Protocol Command Handler
+ *
+ * Handles the 'aqe protocol' command group for protocol execution.
+ */
+import chalk from 'chalk';
+import { parseJsonOption } from '../helpers/safe-json.js';
+// ============================================================================
+// Protocol Handler
+// ============================================================================
+export class ProtocolHandler {
+    name = 'protocol';
+    description = 'Execute coordination protocols';
+    cleanupAndExit;
+    ensureInitialized;
+    constructor(cleanupAndExit, ensureInitialized) {
+        this.cleanupAndExit = cleanupAndExit;
+        this.ensureInitialized = ensureInitialized;
+    }
+    register(program, context) {
+        const protocolCmd = program
+            .command('protocol')
+            .description(this.description);
+        // protocol run
+        protocolCmd
+            .command('run <protocolId>')
+            .description('Execute a protocol')
+            .option('--params <json>', 'Protocol parameters as JSON', '{}')
+            .action(async (protocolId, options) => {
+            await this.executeRun(protocolId, options, context);
+        });
+    }
+    async executeRun(protocolId, options, context) {
+        if (!await this.ensureInitialized())
+            return;
+        try {
+            const params = parseJsonOption(options.params, 'params');
+            console.log(chalk.blue(`\n  Executing protocol: ${protocolId}\n`));
+            const result = await context.queen.executeProtocol(protocolId, params);
+            if (result.success) {
+                console.log(chalk.green(`  Protocol execution started`));
+                console.log(chalk.cyan(`   Execution ID: ${result.value}`));
+            }
+            else {
+                console.log(chalk.red(`  Failed to execute protocol: ${result.error.message}`));
+            }
+            console.log('');
+        }
+        catch (error) {
+            console.error(chalk.red('\n  Failed to execute protocol:'), error);
+            await this.cleanupAndExit(1);
+        }
+    }
+    getHelp() {
+        return `
+Execute coordination protocols.
+
+Usage:
+  aqe protocol <command> [options]
+
+Commands:
+  run <protocolId>    Execute a protocol
+
+Options:
+  --params <json>     Protocol parameters as JSON (default: {})
+
+Examples:
+  aqe protocol run cross-domain-sync
+  aqe protocol run data-validation --params '{"strict": true}'
+`;
+    }
+}
+// ============================================================================
+// Factory
+// ============================================================================
+export function createProtocolHandler(cleanupAndExit, ensureInitialized) {
+    return new ProtocolHandler(cleanupAndExit, ensureInitialized);
+}
+//# sourceMappingURL=protocol-handler.js.map

package/v3/dist/cli/handlers/protocol-handler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocol-handler.js","sourceRoot":"","sources":["../../../src/cli/handlers/protocol-handler.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,MAAM,OAAO,CAAC;AAK1B,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAE1D,+EAA+E;AAC/E,mBAAmB;AACnB,+EAA+E;AAE/E,MAAM,OAAO,eAAe;IACjB,IAAI,GAAG,UAAU,CAAC;IAClB,WAAW,GAAG,gCAAgC,CAAC;IAEhD,cAAc,CAAmC;IACjD,iBAAiB,CAAyB;IAElD,YACE,cAAgD,EAChD,iBAAyC;QAEzC,IAAI,CAAC,cAAc,GAAG,cAAc,CAAC;QACrC,IAAI,CAAC,iBAAiB,GAAG,iBAAiB,CAAC;IAC7C,CAAC;IAED,QAAQ,CAAC,OAAgB,EAAE,OAAmB;QAC5C,MAAM,WAAW,GAAG,OAAO;aACxB,OAAO,CAAC,UAAU,CAAC;aACnB,WAAW,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QAEjC,eAAe;QACf,WAAW;aACR,OAAO,CAAC,kBAAkB,CAAC;aAC3B,WAAW,CAAC,oBAAoB,CAAC;aACjC,MAAM,CAAC,iBAAiB,EAAE,6BAA6B,EAAE,IAAI,CAAC;aAC9D,MAAM,CAAC,KAAK,EAAE,UAAkB,EAAE,OAAO,EAAE,EAAE;YAC5C,MAAM,IAAI,CAAC,UAAU,CAAC,UAAU,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;QACtD,CAAC,CAAC,CAAC;IACP,CAAC;IAEO,KAAK,CAAC,UAAU,CAAC,UAAkB,EAAE,OAAmB,EAAE,OAAmB;QACnF,IAAI,CAAC,MAAM,IAAI,CAAC,iBAAiB,EAAE;YAAE,OAAO;QAE5C,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,eAAe,CAAC,OAAO,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;YAEzD,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,2BAA2B,UAAU,IAAI,CAAC,CAAC,CAAC;YAEnE,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,KAAM,CAAC,eAAe,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;YAExE,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;gBACnB,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,8BAA8B,CAAC,CAAC,CAAC;gBACzD,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,oBAAoB,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;YAC9D,CAAC;iBAAM,CAAC;gBACN,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,iCAAkC,MAA2C,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;YACxH,CAAC;YAED,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAElB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,iCAAiC,CAAC,EAAE,KAAK,CAAC,CAAC;YACnE,MAAM,IAAI,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC;QAC/B,CAAC;IACH,CAAC;IAED,OAAO;QACL,OAAO;;;;;;;;;;;;;;;CAeV,CAAC;IACA,CAAC;CACF;AAUD,+EAA+E;AAC/E,UAAU;AACV,+EAA+E;AAE/E,MAAM,UAAU,qBAAqB,CACnC,cAAgD,EAChD,iBAAyC;IAEzC,OAAO,IAAI,eAAe,CAAC,cAAc,EAAE,iBAAiB,CAAC,CAAC;AAChE,CAAC"}