agentic-qe 3.8.10 → 3.8.12

package/dist/cli/command-registry.js

@@ -4,7 +4,7 @@
  * Central registry for all CLI command handlers.
  * Provides command routing and management.
  */
-import { createInitHandler, createStatusHandler, createHealthHandler, createTaskHandler, createAgentHandler, createDomainHandler, createProtocolHandler, createBrainHandler, createHypergraphHandler, } from './handlers/index.js';
+import { createInitHandler, createStatusHandler, createHealthHandler, createTaskHandler, createAgentHandler, createDomainHandler, createProtocolHandler, createBrainHandler, createHypergraphHandler, createHeartbeatHandler, createRoutingHandler, } from './handlers/index.js';
 // ============================================================================
 // Command Registry
 // ============================================================================
@@ -82,6 +82,10 @@ export class CommandRegistry {
         this.register(createBrainHandler(this.cleanupAndExit, this.ensureInitialized));
         // Hypergraph queries
         this.register(createHypergraphHandler(this.cleanupAndExit, this.ensureInitialized));
+        // Heartbeat scheduler (Imp-10)
+        this.register(createHeartbeatHandler(this.cleanupAndExit));
+        // Routing economics & accuracy (Imp-18)
+        this.register(createRoutingHandler(this.cleanupAndExit));
     }
     /**
      * Get help for all commands

package/dist/cli/commands/pipeline.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Agentic QE v3 - Pipeline Command (Imp-9)
+ *
+ * CLI commands for YAML deterministic pipeline management:
+ *   aqe pipeline load <file.yaml> [--vars key=value]
+ *   aqe pipeline validate <file.yaml>
+ *   aqe pipeline run <pipeline-id> [--input key=value] [--wait]
+ *   aqe pipeline list
+ *   aqe pipeline status <execution-id>
+ *   aqe pipeline approve <execution-id> <step-id>
+ *   aqe pipeline reject <execution-id> <step-id> [--reason "..."]
+ */
+import { Command } from 'commander';
+import type { CLIContext } from '../handlers/interfaces.js';
+export declare function createPipelineCommand(context: CLIContext, cleanupAndExit: (code: number) => Promise<never>, ensureInitialized: () => Promise<boolean>): Command;
+//# sourceMappingURL=pipeline.d.ts.map

package/dist/cli/commands/pipeline.js

@@ -0,0 +1,314 @@
+/**
+ * Agentic QE v3 - Pipeline Command (Imp-9)
+ *
+ * CLI commands for YAML deterministic pipeline management:
+ *   aqe pipeline load <file.yaml> [--vars key=value]
+ *   aqe pipeline validate <file.yaml>
+ *   aqe pipeline run <pipeline-id> [--input key=value] [--wait]
+ *   aqe pipeline list
+ *   aqe pipeline status <execution-id>
+ *   aqe pipeline approve <execution-id> <step-id>
+ *   aqe pipeline reject <execution-id> <step-id> [--reason "..."]
+ */
+import { Command } from 'commander';
+import { resolve } from 'path';
+import chalk from 'chalk';
+import { YamlPipelineLoader } from '../../coordination/yaml-pipeline-loader.js';
+// ============================================================================
+// Helpers
+// ============================================================================
+/**
+ * Parse `--vars key1=value1 key2=value2` into a Record.
+ */
+function parseVars(rawVars) {
+    const vars = {};
+    for (const entry of rawVars) {
+        const eqIndex = entry.indexOf('=');
+        if (eqIndex === -1) {
+            vars[entry] = true;
+        }
+        else {
+            const key = entry.slice(0, eqIndex);
+            const value = entry.slice(eqIndex + 1);
+            // Try to parse as number or boolean
+            if (value === 'true')
+                vars[key] = true;
+            else if (value === 'false')
+                vars[key] = false;
+            else if (!isNaN(Number(value)) && value !== '')
+                vars[key] = Number(value);
+            else
+                vars[key] = value;
+        }
+    }
+    return vars;
+}
+/**
+ * Parse `--input key1=value1 key2=value2` into a Record.
+ */
+function parseInput(rawInput) {
+    return parseVars(rawInput);
+}
+function getOrchestrator(context) {
+    return context.workflowOrchestrator;
+}
+// ============================================================================
+// Command Factory
+// ============================================================================
+export function createPipelineCommand(context, cleanupAndExit, ensureInitialized) {
+    const loader = new YamlPipelineLoader();
+    const pipelineCmd = new Command('pipeline')
+        .description('Manage YAML deterministic pipelines (Imp-9)');
+    // ---------------------------------------------------------------
+    // pipeline load <file.yaml>
+    // ---------------------------------------------------------------
+    pipelineCmd
+        .command('load <file>')
+        .description('Load and register a pipeline from a YAML file')
+        .option('--vars <entries...>', 'Variable substitutions (key=value)')
+        .action(async (file, options) => {
+        if (!await ensureInitialized())
+            return;
+        const orchestrator = getOrchestrator(context);
+        if (!orchestrator) {
+            console.error(chalk.red('  Workflow orchestrator not available. Run "aqe fleet init" first.'));
+            await cleanupAndExit(1);
+            return;
+        }
+        const filePath = resolve(file);
+        const vars = options.vars ? parseVars(options.vars) : undefined;
+        console.log(chalk.blue(`\n  Loading pipeline from: ${file}\n`));
+        const result = await loader.loadFromFile(filePath, vars);
+        if (!result.success) {
+            console.error(chalk.red(`  Parse error: ${result.error.message}`));
+            await cleanupAndExit(1);
+            return;
+        }
+        const definition = result.value;
+        const registerResult = orchestrator.registerWorkflow(definition);
+        if (!registerResult.success) {
+            console.error(chalk.red(`  Registration error: ${registerResult.error.message}`));
+            await cleanupAndExit(1);
+            return;
+        }
+        console.log(chalk.green('  Pipeline loaded successfully.'));
+        console.log(`  ID:      ${chalk.cyan(definition.id)}`);
+        console.log(`  Name:    ${chalk.cyan(definition.name)}`);
+        console.log(`  Steps:   ${chalk.cyan(definition.steps.length)}`);
+        console.log(`  Version: ${chalk.cyan(definition.version)}`);
+        if (definition.tags?.length) {
+            console.log(`  Tags:    ${chalk.cyan(definition.tags.join(', '))}`);
+        }
+        console.log('');
+        await cleanupAndExit(0);
+    });
+    // ---------------------------------------------------------------
+    // pipeline validate <file.yaml>
+    // ---------------------------------------------------------------
+    pipelineCmd
+        .command('validate <file>')
+        .description('Validate a YAML pipeline without registering it')
+        .option('--vars <entries...>', 'Variable substitutions (key=value)')
+        .action(async (file, options) => {
+        const filePath = resolve(file);
+        const vars = options.vars ? parseVars(options.vars) : undefined;
+        console.log(chalk.blue(`\n  Validating pipeline: ${file}\n`));
+        const result = await loader.loadFromFile(filePath, vars);
+        if (!result.success) {
+            console.log(chalk.red(`  Invalid: ${result.error.message}`));
+            await cleanupAndExit(1);
+            return;
+        }
+        const def = result.value;
+        console.log(chalk.green('  Valid pipeline.'));
+        console.log(`  ID:      ${chalk.cyan(def.id)}`);
+        console.log(`  Name:    ${chalk.cyan(def.name)}`);
+        console.log(`  Steps:   ${chalk.cyan(def.steps.length)}`);
+        console.log('');
+        await cleanupAndExit(0);
+    });
+    // ---------------------------------------------------------------
+    // pipeline run <pipeline-id>
+    // ---------------------------------------------------------------
+    pipelineCmd
+        .command('run <pipelineId>')
+        .description('Execute a registered pipeline')
+        .option('--input <entries...>', 'Input parameters (key=value)')
+        .option('--wait', 'Wait for execution to complete')
+        .action(async (pipelineId, options) => {
+        if (!await ensureInitialized())
+            return;
+        const orchestrator = getOrchestrator(context);
+        if (!orchestrator) {
+            console.error(chalk.red('  Workflow orchestrator not available. Run "aqe fleet init" first.'));
+            await cleanupAndExit(1);
+            return;
+        }
+        const input = options.input ? parseInput(options.input) : {};
+        console.log(chalk.blue(`\n  Running pipeline: ${pipelineId}\n`));
+        const result = await orchestrator.executeWorkflow(pipelineId, input);
+        if (!result.success) {
+            console.error(chalk.red(`  Failed: ${result.error.message}`));
+            await cleanupAndExit(1);
+            return;
+        }
+        const executionId = result.value;
+        console.log(chalk.green('  Pipeline started.'));
+        console.log(`  Execution ID: ${chalk.cyan(executionId)}`);
+        if (options.wait) {
+            console.log(chalk.gray('  Waiting for completion...'));
+            let status = orchestrator.getWorkflowStatus(executionId);
+            while (status && (status.status === 'running' || status.status === 'paused')) {
+                await new Promise((r) => setTimeout(r, 500));
+                status = orchestrator.getWorkflowStatus(executionId);
+            }
+            if (status) {
+                const statusColor = status.status === 'completed' ? chalk.green : chalk.red;
+                console.log(`  Status:  ${statusColor(status.status)}`);
+                if (status.duration)
+                    console.log(`  Duration: ${chalk.cyan(`${status.duration}ms`)}`);
+                if (status.error)
+                    console.log(`  Error:   ${chalk.red(status.error)}`);
+            }
+        }
+        console.log('');
+        await cleanupAndExit(0);
+    });
+    // ---------------------------------------------------------------
+    // pipeline list
+    // ---------------------------------------------------------------
+    pipelineCmd
+        .command('list')
+        .description('List all registered pipelines')
+        .action(async () => {
+        if (!await ensureInitialized())
+            return;
+        const orchestrator = getOrchestrator(context);
+        if (!orchestrator) {
+            console.error(chalk.red('  Workflow orchestrator not available. Run "aqe fleet init" first.'));
+            await cleanupAndExit(1);
+            return;
+        }
+        const workflows = orchestrator.listWorkflows();
+        console.log(chalk.blue(`\n  Registered Pipelines (${workflows.length})\n`));
+        if (workflows.length === 0) {
+            console.log(chalk.gray('  No pipelines registered.'));
+        }
+        else {
+            for (const wf of workflows) {
+                console.log(`  ${chalk.cyan(wf.id)} — ${wf.name} (${wf.stepCount} steps, v${wf.version})`);
+                if (wf.tags?.length) {
+                    console.log(`    Tags: ${chalk.gray(wf.tags.join(', '))}`);
+                }
+            }
+        }
+        console.log('');
+        await cleanupAndExit(0);
+    });
+    // ---------------------------------------------------------------
+    // pipeline status <execution-id>
+    // ---------------------------------------------------------------
+    pipelineCmd
+        .command('status <executionId>')
+        .description('Show the status of a pipeline execution')
+        .action(async (executionId) => {
+        if (!await ensureInitialized())
+            return;
+        const orchestrator = getOrchestrator(context);
+        if (!orchestrator) {
+            console.error(chalk.red('  Workflow orchestrator not available. Run "aqe fleet init" first.'));
+            await cleanupAndExit(1);
+            return;
+        }
+        const status = orchestrator.getWorkflowStatus(executionId);
+        if (!status) {
+            console.error(chalk.red(`  Execution not found: ${executionId}`));
+            await cleanupAndExit(1);
+            return;
+        }
+        const statusColor = status.status === 'completed' ? chalk.green :
+            status.status === 'failed' ? chalk.red :
+                status.status === 'running' ? chalk.yellow : chalk.gray;
+        console.log(chalk.blue(`\n  Pipeline Execution Status\n`));
+        console.log(`  Execution:  ${chalk.cyan(executionId)}`);
+        console.log(`  Pipeline:   ${chalk.cyan(status.workflowName)} (${status.workflowId})`);
+        console.log(`  Status:     ${statusColor(status.status)}`);
+        console.log(`  Progress:   ${chalk.cyan(`${status.progress}%`)}`);
+        console.log(`  Completed:  ${chalk.cyan(status.completedSteps.join(', ') || 'none')}`);
+        if (status.failedSteps.length > 0) {
+            console.log(`  Failed:     ${chalk.red(status.failedSteps.join(', '))}`);
+        }
+        if (status.skippedSteps.length > 0) {
+            console.log(`  Skipped:    ${chalk.gray(status.skippedSteps.join(', '))}`);
+        }
+        if (status.currentSteps.length > 0) {
+            console.log(`  Running:    ${chalk.yellow(status.currentSteps.join(', '))}`);
+        }
+        if (status.duration) {
+            console.log(`  Duration:   ${chalk.cyan(`${status.duration}ms`)}`);
+        }
+        if (status.error) {
+            console.log(`  Error:      ${chalk.red(status.error)}`);
+        }
+        console.log('');
+        await cleanupAndExit(0);
+    });
+    // ---------------------------------------------------------------
+    // pipeline approve <execution-id> <step-id>
+    // ---------------------------------------------------------------
+    pipelineCmd
+        .command('approve <executionId> <stepId>')
+        .description('Approve a step that is awaiting approval')
+        .action(async (executionId, stepId) => {
+        if (!await ensureInitialized())
+            return;
+        const orchestrator = getOrchestrator(context);
+        if (!orchestrator) {
+            console.error(chalk.red('  Workflow orchestrator not available.'));
+            await cleanupAndExit(1);
+            return;
+        }
+        const success = orchestrator.approveStep(executionId, stepId);
+        if (success) {
+            console.log(chalk.green(`\n  Step '${stepId}' approved.\n`));
+        }
+        else {
+            console.error(chalk.red(`\n  No pending approval found for step '${stepId}' in execution '${executionId}'.\n`));
+            await cleanupAndExit(1);
+            return;
+        }
+        await cleanupAndExit(0);
+    });
+    // ---------------------------------------------------------------
+    // pipeline reject <execution-id> <step-id>
+    // ---------------------------------------------------------------
+    pipelineCmd
+        .command('reject <executionId> <stepId>')
+        .description('Reject a step that is awaiting approval')
+        .option('--reason <reason>', 'Rejection reason')
+        .action(async (executionId, stepId, options) => {
+        if (!await ensureInitialized())
+            return;
+        const orchestrator = getOrchestrator(context);
+        if (!orchestrator) {
+            console.error(chalk.red('  Workflow orchestrator not available.'));
+            await cleanupAndExit(1);
+            return;
+        }
+        const success = orchestrator.rejectStep(executionId, stepId, options.reason);
+        if (success) {
+            console.log(chalk.green(`\n  Step '${stepId}' rejected.`));
+            if (options.reason)
+                console.log(`  Reason: ${chalk.gray(options.reason)}`);
+            console.log('');
+        }
+        else {
+            console.error(chalk.red(`\n  No pending approval found for step '${stepId}' in execution '${executionId}'.\n`));
+            await cleanupAndExit(1);
+            return;
+        }
+        await cleanupAndExit(0);
+    });
+    return pipelineCmd;
+}
+//# sourceMappingURL=pipeline.js.map

package/dist/cli/commands/ruvector-commands.js

@@ -50,6 +50,23 @@ const FLAG_DESCRIPTIONS = {
     useDAGAttention: 'DAG attention for test scheduling (Task 4.2)',
     useCoherenceActionGate: 'Coherence-gated agent actions (ADR-083, Task 3.2)',
     useReasoningQEC: 'Reasoning QEC error correction (Task 4.5)',
+    // Phase 5 (ADR-087)
+    useHDCFingerprinting: 'HDC pattern fingerprinting (R1, ADR-087)',
+    useCusumDriftDetection: 'CUSUM drift detection (R2, ADR-087)',
+    useDeltaEventSourcing: 'Delta event sourcing (R3, ADR-087)',
+    useEwcPlusPlusRegularization: 'EWC++ regularization (ADR-087)',
+    // Phase 5 Milestone 2 (ADR-087)
+    useGraphMAEEmbeddings: 'GraphMAE self-supervised embeddings (R4, ADR-087)',
+    useHopfieldMemory: 'Modern Hopfield memory (R5, ADR-087)',
+    useColdTierGNN: 'Cold-tier GNN training (R6, ADR-087)',
+    // Phase 5 Milestone 3 (ADR-087)
+    useMetaLearningEnhancements: 'Meta-learning enhancements (R7, ADR-087)',
+    useSublinearSolver: 'Sublinear PageRank solver (R8, ADR-087)',
+    useSpectralSparsification: 'Spectral graph sparsification (R9, ADR-087)',
+    useReservoirReplay: 'Reservoir replay with coherence gating (R10, ADR-087)',
+    // Phase 5 Milestone 4 (ADR-087)
+    useEpropOnlineLearning: 'E-prop online learning, RL algorithm #10 (R11, ADR-087)',
+    useGrangerCausality: 'Granger causality for test failure prediction (R12, ADR-087)',
 };
 const PROFILES = {
     performance: {

package/dist/cli/commands/token-usage.js

@@ -15,6 +15,7 @@ import { Command } from 'commander';
 import chalk from 'chalk';
 import { TokenMetricsCollector, formatDashboardSummary, } from '../../learning/token-tracker.js';
 import { TokenOptimizerService } from '../../optimization/token-optimizer-service.js';
+import { getSessionCache } from '../../optimization/session-cache.js';
 import * as fs from 'fs';
 import { toErrorMessage } from '../../shared/error-utils.js';
 // ============================================================================
@@ -32,6 +33,7 @@ export function createTokenUsageCommand() {
         .option('-r, --recommendations', 'Show optimization recommendations')
         .option('-e, --export <file>', 'Export to CSV file')
         .option('--dashboard', 'Show compact token budget dashboard summary')
+        .option('--cache-stats', 'Show session operation cache statistics (Imp-15)')
         .option('--json', 'Output as JSON')
         .option('-v, --verbose', 'Show detailed output')
         .action(async (options) => {
@@ -45,7 +47,10 @@ export function createTokenUsageCommand() {
 async function executeTokenUsage(options) {
     const timeframe = parseTimeframe(options.period);
     try {
-        if (options.dashboard) {
+        if (options.cacheStats) {
+            await showCacheStats(options);
+        }
+        else if (options.dashboard) {
             console.log(formatDashboardSummary());
         }
         else if (options.byAgent) {
@@ -122,6 +127,24 @@ async function showSessionSummary(timeframe, options) {
     }
     console.log('');
 }
+/**
+ * Show session operation cache statistics (Imp-15)
+ */
+async function showCacheStats(options) {
+    const stats = getSessionCache().getStats();
+    if (options.json) {
+        console.log(JSON.stringify(stats, null, 2));
+        return;
+    }
+    console.log(chalk.bold.cyan('\nSession Operation Cache (Imp-15)\n'));
+    console.log(`  Cache size:          ${stats.size} entries`);
+    console.log(`  Cache hits:          ${stats.hits}`);
+    console.log(`  Cache misses:        ${stats.misses}`);
+    console.log(`  Hit rate:            ${chalk.green(`${(stats.hitRate * 100).toFixed(1)}%`)}`);
+    console.log(`  Tokens saved:        ${chalk.green(formatNumber(stats.estimatedTokensSaved))}`);
+    console.log(chalk.gray('\n  O(1) fingerprint lookups run before O(log n) HNSW search'));
+    console.log('');
+}
 /**
  * Show usage grouped by agent
  */

package/dist/cli/handlers/heartbeat-handler.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Agentic QE v3 - Heartbeat Command Handler
+ * Imp-10: Token-Free Heartbeat Scheduler CLI Integration
+ *
+ * Handles the 'aqe heartbeat' command with subcommands:
+ *   status, run-now, history, log, pause, resume
+ */
+import { Command } from 'commander';
+import { ICommandHandler, CLIContext } from './interfaces.js';
+export declare class HeartbeatHandler implements ICommandHandler {
+    readonly name = "heartbeat";
+    readonly description = "Manage the token-free heartbeat scheduler";
+    private cleanupAndExit;
+    private worker;
+    constructor(cleanupAndExit: (code: number) => Promise<never>);
+    register(program: Command, _context: CLIContext): void;
+    private executeStatus;
+    private executeRunNow;
+    private executeHistory;
+    private executeLog;
+    private executePause;
+    private executeResume;
+    getHelp(): string;
+}
+export declare function createHeartbeatHandler(cleanupAndExit: (code: number) => Promise<never>): HeartbeatHandler;
+//# sourceMappingURL=heartbeat-handler.d.ts.map