agentic-qe 3.2.3 → 3.3.1

package/v3/dist/cli/command-registry.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Agentic QE v3 - Command Registry
+ *
+ * Central registry for all CLI command handlers.
+ * Provides command routing and management.
+ */
+import { Command } from 'commander';
+import { ICommandHandler, CLIContext } from './handlers/index.js';
+/**
+ * Central registry for CLI commands
+ */
+export declare class CommandRegistry {
+    private handlers;
+    private context;
+    private cleanupAndExit;
+    private ensureInitialized;
+    constructor(context: CLIContext, cleanupAndExit: (code: number) => Promise<never>, ensureInitialized: () => Promise<boolean>);
+    /**
+     * Register a command handler
+     */
+    register(handler: ICommandHandler): void;
+    /**
+     * Get a command handler by name
+     */
+    get(name: string): ICommandHandler | undefined;
+    /**
+     * Check if a handler exists
+     */
+    has(name: string): boolean;
+    /**
+     * Get all registered handler names
+     */
+    getNames(): string[];
+    /**
+     * Get all registered handlers
+     */
+    getAll(): ICommandHandler[];
+    /**
+     * Register all handlers with the Commander program
+     */
+    registerAll(program: Command): void;
+    /**
+     * Register all built-in command handlers
+     */
+    registerBuiltinHandlers(): void;
+    /**
+     * Get help for all commands
+     */
+    getAllHelp(): string;
+}
+/**
+ * Create a new command registry with built-in handlers
+ */
+export declare function createCommandRegistry(context: CLIContext, cleanupAndExit: (code: number) => Promise<never>, ensureInitialized: () => Promise<boolean>): CommandRegistry;
+//# sourceMappingURL=command-registry.d.ts.map

package/v3/dist/cli/command-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-registry.d.ts","sourceRoot":"","sources":["../../src/cli/command-registry.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EACL,eAAe,EACf,UAAU,EAQX,MAAM,qBAAqB,CAAC;AAM7B;;GAEG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAA2C;IAC3D,OAAO,CAAC,OAAO,CAAa;IAC5B,OAAO,CAAC,cAAc,CAAmC;IACzD,OAAO,CAAC,iBAAiB,CAAyB;gBAGhD,OAAO,EAAE,UAAU,EACnB,cAAc,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,KAAK,CAAC,EAChD,iBAAiB,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC;IAO3C;;OAEG;IACH,QAAQ,CAAC,OAAO,EAAE,eAAe,GAAG,IAAI;IAIxC;;OAEG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS;IAI9C;;OAEG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAI1B;;OAEG;IACH,QAAQ,IAAI,MAAM,EAAE;IAIpB;;OAEG;IACH,MAAM,IAAI,eAAe,EAAE;IAI3B;;OAEG;IACH,WAAW,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;IAOnC;;OAEG;IACH,uBAAuB,IAAI,IAAI;IAmB/B;;OAEG;IACH,UAAU,IAAI,MAAM;CAUrB;AAMD;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,UAAU,EACnB,cAAc,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,KAAK,CAAC,EAChD,iBAAiB,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,GACxC,eAAe,CAIjB"}

package/v3/dist/cli/command-registry.js

@@ -0,0 +1,103 @@
+/**
+ * Agentic QE v3 - Command Registry
+ *
+ * Central registry for all CLI command handlers.
+ * Provides command routing and management.
+ */
+import { createInitHandler, createStatusHandler, createHealthHandler, createTaskHandler, createAgentHandler, createDomainHandler, createProtocolHandler, } from './handlers/index.js';
+// ============================================================================
+// Command Registry
+// ============================================================================
+/**
+ * Central registry for CLI commands
+ */
+export class CommandRegistry {
+    handlers = new Map();
+    context;
+    cleanupAndExit;
+    ensureInitialized;
+    constructor(context, cleanupAndExit, ensureInitialized) {
+        this.context = context;
+        this.cleanupAndExit = cleanupAndExit;
+        this.ensureInitialized = ensureInitialized;
+    }
+    /**
+     * Register a command handler
+     */
+    register(handler) {
+        this.handlers.set(handler.name, handler);
+    }
+    /**
+     * Get a command handler by name
+     */
+    get(name) {
+        return this.handlers.get(name);
+    }
+    /**
+     * Check if a handler exists
+     */
+    has(name) {
+        return this.handlers.has(name);
+    }
+    /**
+     * Get all registered handler names
+     */
+    getNames() {
+        return Array.from(this.handlers.keys());
+    }
+    /**
+     * Get all registered handlers
+     */
+    getAll() {
+        return Array.from(this.handlers.values());
+    }
+    /**
+     * Register all handlers with the Commander program
+     */
+    registerAll(program) {
+        const handlers = this.getAll();
+        for (const handler of handlers) {
+            handler.register(program, this.context);
+        }
+    }
+    /**
+     * Register all built-in command handlers
+     */
+    registerBuiltinHandlers() {
+        // Core commands
+        this.register(createInitHandler(this.cleanupAndExit));
+        this.register(createStatusHandler(this.cleanupAndExit, this.ensureInitialized));
+        this.register(createHealthHandler(this.cleanupAndExit, this.ensureInitialized));
+        // Task management
+        this.register(createTaskHandler(this.cleanupAndExit, this.ensureInitialized));
+        // Agent management
+        this.register(createAgentHandler(this.cleanupAndExit, this.ensureInitialized));
+        // Domain management
+        this.register(createDomainHandler(this.cleanupAndExit, this.ensureInitialized));
+        // Protocol execution
+        this.register(createProtocolHandler(this.cleanupAndExit, this.ensureInitialized));
+    }
+    /**
+     * Get help for all commands
+     */
+    getAllHelp() {
+        const sections = [];
+        const handlers = this.getAll();
+        for (const handler of handlers) {
+            sections.push(`## ${handler.name}\n${handler.getHelp()}`);
+        }
+        return sections.join('\n\n');
+    }
+}
+// ============================================================================
+// Factory
+// ============================================================================
+/**
+ * Create a new command registry with built-in handlers
+ */
+export function createCommandRegistry(context, cleanupAndExit, ensureInitialized) {
+    const registry = new CommandRegistry(context, cleanupAndExit, ensureInitialized);
+    registry.registerBuiltinHandlers();
+    return registry;
+}
+//# sourceMappingURL=command-registry.js.map

package/v3/dist/cli/command-registry.js.map

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

package/v3/dist/cli/commands/claude-flow-setup.d.ts

@@ -0,0 +1,82 @@
+/**
+ * Claude Flow Integration Setup
+ * ADR-026: 3-Tier Model Routing
+ *
+ * Sets up Claude Flow integration when available during init.
+ * Gracefully handles when Claude Flow is not installed.
+ *
+ * Features when Claude Flow available:
+ * - SONA trajectory tracking for reinforcement learning
+ * - 3-tier model routing (haiku/sonnet/opus)
+ * - Codebase pretrain analysis for optimal agent configs
+ * - Background worker integration
+ *
+ * When not available:
+ * - Uses AQE's standalone learning engine
+ * - Rule-based model routing
+ * - Local pattern learning
+ */
+/**
+ * Claude Flow setup options
+ */
+export interface ClaudeFlowSetupOptions {
+    /** Project root directory */
+    projectRoot: string;
+    /** Force setup even if not auto-detected */
+    force?: boolean;
+    /** Only check availability, don't configure */
+    checkOnly?: boolean;
+    /** Enable debug output */
+    debug?: boolean;
+}
+/**
+ * Claude Flow setup result
+ */
+export interface ClaudeFlowSetupResult {
+    /** Whether Claude Flow is available */
+    available: boolean;
+    /** Claude Flow version (if available) */
+    version?: string;
+    /** Available features */
+    features: {
+        trajectories: boolean;
+        modelRouting: boolean;
+        pretrain: boolean;
+        workers: boolean;
+        patternSearch: boolean;
+    };
+    /** Configuration path (if written) */
+    configPath?: string;
+    /** Error message (if setup failed) */
+    error?: string;
+}
+/**
+ * Setup Claude Flow integration
+ *
+ * @example
+ * ```typescript
+ * const result = await setupClaudeFlowIntegration({
+ *   projectRoot: process.cwd(),
+ * });
+ *
+ * if (result.available) {
+ *   console.log('Claude Flow enabled:', result.features);
+ * } else {
+ *   console.log('Running in standalone mode');
+ * }
+ * ```
+ */
+export declare function setupClaudeFlowIntegration(options: ClaudeFlowSetupOptions): Promise<ClaudeFlowSetupResult>;
+/**
+ * Check if Claude Flow integration is configured
+ */
+export declare function isClaudeFlowConfigured(projectRoot: string): boolean;
+/**
+ * Get Claude Flow integration config
+ */
+export declare function getClaudeFlowConfig(projectRoot: string): object | null;
+/**
+ * Remove Claude Flow integration
+ */
+export declare function removeClaudeFlowIntegration(projectRoot: string): boolean;
+//# sourceMappingURL=claude-flow-setup.d.ts.map

package/v3/dist/cli/commands/claude-flow-setup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude-flow-setup.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/claude-flow-setup.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAUH;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,6BAA6B;IAC7B,WAAW,EAAE,MAAM,CAAC;IACpB,4CAA4C;IAC5C,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,+CAA+C;IAC/C,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,0BAA0B;IAC1B,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,uCAAuC;IACvC,SAAS,EAAE,OAAO,CAAC;IACnB,yCAAyC;IACzC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,yBAAyB;IACzB,QAAQ,EAAE;QACR,YAAY,EAAE,OAAO,CAAC;QACtB,YAAY,EAAE,OAAO,CAAC;QACtB,QAAQ,EAAE,OAAO,CAAC;QAClB,OAAO,EAAE,OAAO,CAAC;QACjB,aAAa,EAAE,OAAO,CAAC;KACxB,CAAC;IACF,sCAAsC;IACtC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,sCAAsC;IACtC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAgND;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,0BAA0B,CAC9C,OAAO,EAAE,sBAAsB,GAC9B,OAAO,CAAC,qBAAqB,CAAC,CAoEhC;AAMD;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAGnE;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAWtE;AAED;;GAEG;AACH,wBAAgB,2BAA2B,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAYxE"}

package/v3/dist/cli/commands/claude-flow-setup.js

@@ -0,0 +1,334 @@
+/**
+ * Claude Flow Integration Setup
+ * ADR-026: 3-Tier Model Routing
+ *
+ * Sets up Claude Flow integration when available during init.
+ * Gracefully handles when Claude Flow is not installed.
+ *
+ * Features when Claude Flow available:
+ * - SONA trajectory tracking for reinforcement learning
+ * - 3-tier model routing (haiku/sonnet/opus)
+ * - Codebase pretrain analysis for optimal agent configs
+ * - Background worker integration
+ *
+ * When not available:
+ * - Uses AQE's standalone learning engine
+ * - Rule-based model routing
+ * - Local pattern learning
+ */
+import { existsSync, writeFileSync, readFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { execSync } from 'node:child_process';
+// ============================================================================
+// Detection
+// ============================================================================
+/**
+ * Check if Claude Flow is available
+ */
+async function detectClaudeFlow(projectRoot, debug) {
+    // Method 1: Check for MCP server in Claude settings
+    const claudeSettingsPath = join(projectRoot, '.claude', 'settings.json');
+    if (existsSync(claudeSettingsPath)) {
+        try {
+            const settings = JSON.parse(readFileSync(claudeSettingsPath, 'utf-8'));
+            const mcpServers = settings.mcpServers || settings.mcp?.servers || {};
+            if (mcpServers['claude-flow'] || mcpServers['@anthropic/claude-flow']) {
+                if (debug)
+                    console.log('[ClaudeFlow] Detected via MCP settings');
+                return { available: true, method: 'mcp' };
+            }
+        }
+        catch {
+            // Continue to other methods
+        }
+    }
+    // Method 2: Check for CLI availability
+    try {
+        const result = execSync('npx @claude-flow/cli@latest --version 2>/dev/null', {
+            encoding: 'utf-8',
+            timeout: 10000,
+            cwd: projectRoot,
+        });
+        const version = result.trim().match(/\d+\.\d+\.\d+/)?.[0];
+        if (debug)
+            console.log(`[ClaudeFlow] Detected via CLI: v${version}`);
+        return { available: true, version, method: 'cli' };
+    }
+    catch {
+        // Continue to other methods
+    }
+    // Method 3: Check for npm package
+    try {
+        const packageJsonPath = join(projectRoot, 'package.json');
+        if (existsSync(packageJsonPath)) {
+            const pkg = JSON.parse(readFileSync(packageJsonPath, 'utf-8'));
+            const deps = { ...pkg.dependencies, ...pkg.devDependencies };
+            if (deps['@claude-flow/cli'] || deps['claude-flow']) {
+                if (debug)
+                    console.log('[ClaudeFlow] Detected via package.json');
+                return { available: true, method: 'npm' };
+            }
+        }
+    }
+    catch {
+        // Continue
+    }
+    return { available: false };
+}
+/**
+ * Check available Claude Flow features
+ */
+async function detectFeatures(projectRoot) {
+    const features = {
+        trajectories: false,
+        modelRouting: false,
+        pretrain: false,
+        workers: false,
+        patternSearch: false,
+    };
+    // Check each feature by running quick commands
+    const featureChecks = [
+        { feature: 'trajectories', command: 'hooks metrics --period 1h' },
+        { feature: 'modelRouting', command: 'hooks model-stats' },
+        { feature: 'pretrain', command: 'hooks pretrain --help' },
+        { feature: 'workers', command: 'hooks worker-list' },
+        { feature: 'patternSearch', command: 'hooks intelligence --show-status true' },
+    ];
+    for (const check of featureChecks) {
+        try {
+            execSync(`npx @claude-flow/cli@latest ${check.command} 2>/dev/null`, {
+                encoding: 'utf-8',
+                timeout: 5000,
+                cwd: projectRoot,
+            });
+            features[check.feature] = true;
+        }
+        catch {
+            // Feature not available
+        }
+    }
+    return features;
+}
+// ============================================================================
+// Configuration
+// ============================================================================
+/**
+ * Generate Claude Flow integration configuration
+ */
+function generateClaudeFlowConfig(projectRoot, features) {
+    return {
+        version: '1.0',
+        projectRoot,
+        integration: {
+            enabled: true,
+            features: {
+                trajectories: features.trajectories,
+                modelRouting: features.modelRouting,
+                pretrain: features.pretrain,
+                workers: features.workers,
+            },
+        },
+        learning: {
+            // Use SONA trajectories when available, fall back to local SQLite
+            trajectoryStorage: features.trajectories ? 'claude-flow' : 'local',
+            // Enable pattern search via Claude Flow when available
+            patternSearch: features.patternSearch ? 'claude-flow' : 'local',
+        },
+        routing: {
+            // Use 3-tier model routing when available
+            modelRouting: features.modelRouting ? 'claude-flow' : 'rule-based',
+            // Default model preferences
+            preferences: {
+                simple: 'haiku',
+                standard: 'sonnet',
+                complex: 'opus',
+            },
+        },
+        pretrain: {
+            enabled: features.pretrain,
+            depth: 'medium',
+            autoRun: true,
+        },
+        workers: {
+            enabled: features.workers,
+            autoDispatch: ['optimize', 'consolidate'],
+        },
+    };
+}
+/**
+ * Update MCP server configuration for Claude
+ */
+function updateMCPConfig(projectRoot) {
+    const claudeSettingsPath = join(projectRoot, '.claude', 'settings.json');
+    let settings = {};
+    if (existsSync(claudeSettingsPath)) {
+        try {
+            settings = JSON.parse(readFileSync(claudeSettingsPath, 'utf-8'));
+        }
+        catch {
+            // Start fresh
+        }
+    }
+    // Ensure mcpServers section exists
+    if (!settings.mcpServers) {
+        settings.mcpServers = {};
+    }
+    // Add claude-flow server if not present
+    const servers = settings.mcpServers;
+    if (!servers['claude-flow']) {
+        servers['claude-flow'] = {
+            command: 'npx',
+            args: ['@anthropic/claude-flow', 'mcp'],
+            env: {},
+        };
+    }
+    // Write updated settings
+    writeFileSync(claudeSettingsPath, JSON.stringify(settings, null, 2));
+}
+/**
+ * Run initial pretrain analysis
+ */
+async function runPretrainAnalysis(projectRoot, debug) {
+    try {
+        if (debug)
+            console.log('[ClaudeFlow] Running pretrain analysis...');
+        execSync('npx @claude-flow/cli@latest hooks pretrain --depth medium 2>/dev/null', {
+            encoding: 'utf-8',
+            timeout: 120000, // 2 minutes
+            cwd: projectRoot,
+        });
+        if (debug)
+            console.log('[ClaudeFlow] Pretrain analysis complete');
+    }
+    catch (error) {
+        if (debug) {
+            console.log('[ClaudeFlow] Pretrain analysis failed:', error instanceof Error ? error.message : String(error));
+        }
+        // Non-critical, continue
+    }
+}
+// ============================================================================
+// Main Setup Function
+// ============================================================================
+/**
+ * Setup Claude Flow integration
+ *
+ * @example
+ * ```typescript
+ * const result = await setupClaudeFlowIntegration({
+ *   projectRoot: process.cwd(),
+ * });
+ *
+ * if (result.available) {
+ *   console.log('Claude Flow enabled:', result.features);
+ * } else {
+ *   console.log('Running in standalone mode');
+ * }
+ * ```
+ */
+export async function setupClaudeFlowIntegration(options) {
+    const { projectRoot, force, checkOnly, debug } = options;
+    // Step 1: Detect Claude Flow
+    const detection = await detectClaudeFlow(projectRoot, debug);
+    if (!detection.available && !force) {
+        return {
+            available: false,
+            features: {
+                trajectories: false,
+                modelRouting: false,
+                pretrain: false,
+                workers: false,
+                patternSearch: false,
+            },
+        };
+    }
+    // Step 2: Detect available features
+    const features = await detectFeatures(projectRoot);
+    if (checkOnly) {
+        return {
+            available: detection.available,
+            version: detection.version,
+            features,
+        };
+    }
+    // Step 3: Generate and write configuration
+    const aqeDir = join(projectRoot, '.agentic-qe');
+    const configPath = join(aqeDir, 'claude-flow-integration.json');
+    try {
+        const config = generateClaudeFlowConfig(projectRoot, features);
+        writeFileSync(configPath, JSON.stringify(config, null, 2));
+        if (debug)
+            console.log(`[ClaudeFlow] Config written to: ${configPath}`);
+    }
+    catch (error) {
+        return {
+            available: detection.available,
+            version: detection.version,
+            features,
+            error: `Failed to write config: ${error instanceof Error ? error.message : String(error)}`,
+        };
+    }
+    // Step 4: Update MCP configuration
+    try {
+        updateMCPConfig(projectRoot);
+    }
+    catch (error) {
+        if (debug) {
+            console.log('[ClaudeFlow] MCP config update failed:', error instanceof Error ? error.message : String(error));
+        }
+        // Non-critical, continue
+    }
+    // Step 5: Run initial pretrain (if available)
+    if (features.pretrain) {
+        await runPretrainAnalysis(projectRoot, debug);
+    }
+    return {
+        available: true,
+        version: detection.version,
+        features,
+        configPath,
+    };
+}
+// ============================================================================
+// Utility Functions
+// ============================================================================
+/**
+ * Check if Claude Flow integration is configured
+ */
+export function isClaudeFlowConfigured(projectRoot) {
+    const configPath = join(projectRoot, '.agentic-qe', 'claude-flow-integration.json');
+    return existsSync(configPath);
+}
+/**
+ * Get Claude Flow integration config
+ */
+export function getClaudeFlowConfig(projectRoot) {
+    const configPath = join(projectRoot, '.agentic-qe', 'claude-flow-integration.json');
+    if (!existsSync(configPath)) {
+        return null;
+    }
+    try {
+        return JSON.parse(readFileSync(configPath, 'utf-8'));
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Remove Claude Flow integration
+ */
+export function removeClaudeFlowIntegration(projectRoot) {
+    const configPath = join(projectRoot, '.agentic-qe', 'claude-flow-integration.json');
+    if (existsSync(configPath)) {
+        try {
+            const fs = require('node:fs');
+            fs.rmSync(configPath);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    return true;
+}
+//# sourceMappingURL=claude-flow-setup.js.map

package/v3/dist/cli/commands/claude-flow-setup.js.map

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

package/v3/dist/cli/commands/code.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Agentic QE v3 - Code Command
+ *
+ * Provides code intelligence analysis.
+ */
+import { Command } from 'commander';
+import type { CLIContext } from '../handlers/interfaces.js';
+export declare function createCodeCommand(context: CLIContext, cleanupAndExit: (code: number) => Promise<never>, ensureInitialized: () => Promise<boolean>): Command;
+//# sourceMappingURL=code.d.ts.map

package/v3/dist/cli/commands/code.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"code.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/code.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAE5D,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,UAAU,EACnB,cAAc,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,KAAK,CAAC,EAChD,iBAAiB,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,GACxC,OAAO,CAmRT"}