agentic-qe 2.5.10 → 2.6.1

package/dist/agents/pool/types.d.ts

@@ -0,0 +1,227 @@
+/**
+ * Agent Pool Types
+ * Phase 3 D1: Memory Pooling for 16x Agent Spawn Speedup
+ *
+ * Target: Reduce spawn time from ~50-100ms to ~3-6ms
+ */
+import { QEAgentType } from '../../types';
+/**
+ * Pool configuration for a specific agent type
+ */
+export interface AgentTypePoolConfig {
+    /** Agent type identifier */
+    type: QEAgentType;
+    /** Minimum number of agents to keep warm in pool */
+    minSize: number;
+    /** Maximum pool size (prevents memory bloat) */
+    maxSize: number;
+    /** Number of agents to pre-warm during startup */
+    warmupCount: number;
+    /** Whether to pre-initialize agents (run initialize() during warmup) */
+    preInitialize: boolean;
+    /** Time-to-live for idle agents in ms (0 = no expiration) */
+    idleTtlMs: number;
+    /** Growth increment when pool is exhausted */
+    growthIncrement: number;
+}
+/**
+ * Overall pool configuration
+ */
+export interface AgentPoolConfig {
+    /** Per-type pool configurations */
+    typeConfigs: Map<QEAgentType, AgentTypePoolConfig>;
+    /** Default config for types without specific configuration */
+    defaultConfig: Omit<AgentTypePoolConfig, 'type'>;
+    /** Enable debug logging */
+    debug: boolean;
+    /** Maximum total agents across all pools */
+    globalMaxAgents: number;
+    /** Warmup strategy: 'eager' (all at once) or 'lazy' (on first request) */
+    warmupStrategy: 'eager' | 'lazy';
+    /** Health check interval in ms (0 = disabled) */
+    healthCheckIntervalMs: number;
+}
+/**
+ * State of a pooled agent
+ */
+export declare enum PooledAgentState {
+    /** Agent is available for acquisition */
+    AVAILABLE = "available",
+    /** Agent is currently in use */
+    IN_USE = "in_use",
+    /** Agent is being initialized */
+    INITIALIZING = "initializing",
+    /** Agent is being reset for reuse */
+    RESETTING = "resetting",
+    /** Agent has an error and needs recovery */
+    ERROR = "error",
+    /** Agent is marked for removal */
+    DISPOSING = "disposing"
+}
+/**
+ * Metadata for a pooled agent
+ */
+export interface PooledAgentMeta {
+    /** Unique pool-assigned ID */
+    poolId: string;
+    /** Agent type */
+    type: QEAgentType;
+    /** Current state in pool */
+    state: PooledAgentState;
+    /** When the agent was created */
+    createdAt: number;
+    /** When the agent was last acquired */
+    lastAcquiredAt: number | null;
+    /** When the agent was last released */
+    lastReleasedAt: number | null;
+    /** Number of times this agent has been reused */
+    reuseCount: number;
+    /** Total time spent in use (ms) */
+    totalUseTimeMs: number;
+    /** Whether agent has been initialized */
+    isInitialized: boolean;
+    /** Last error if any */
+    lastError: Error | null;
+}
+/**
+ * Pool statistics for monitoring
+ */
+export interface PoolStats {
+    /** Total agents across all types */
+    totalAgents: number;
+    /** Available agents ready for use */
+    availableAgents: number;
+    /** Agents currently in use */
+    inUseAgents: number;
+    /** Agents being initialized */
+    initializingAgents: number;
+    /** Per-type breakdown */
+    byType: Map<QEAgentType, TypePoolStats>;
+    /** Average acquisition time (ms) */
+    avgAcquisitionTimeMs: number;
+    /** Cache hit rate (acquisitions from pool vs new creates) */
+    hitRate: number;
+    /** Total acquisitions since startup */
+    totalAcquisitions: number;
+    /** Total pool misses (had to create new) */
+    totalMisses: number;
+}
+/**
+ * Per-type pool statistics
+ */
+export interface TypePoolStats {
+    type: QEAgentType;
+    total: number;
+    available: number;
+    inUse: number;
+    minSize: number;
+    maxSize: number;
+    avgReuseCount: number;
+}
+/**
+ * Options for acquiring an agent from the pool
+ */
+export interface AcquireOptions {
+    /** Timeout for acquisition in ms (default: 5000) */
+    timeoutMs?: number;
+    /** Whether to wait for an agent if none available (default: true) */
+    waitIfUnavailable?: boolean;
+    /** Priority level for acquisition (higher = first in queue) */
+    priority?: number;
+    /** Custom capabilities required (filters available agents) */
+    requiredCapabilities?: string[];
+}
+/**
+ * Options for releasing an agent back to the pool
+ */
+export interface ReleaseOptions {
+    /** Whether to reset agent state (default: true) */
+    reset?: boolean;
+    /** Mark agent as having an error (will be recovered or disposed) */
+    hasError?: boolean;
+    /** Force disposal instead of returning to pool */
+    dispose?: boolean;
+}
+/**
+ * Pool expansion policy
+ */
+export type ExpansionPolicy = 'none' | 'linear' | 'exponential' | 'adaptive';
+/**
+ * Result of an acquire operation
+ */
+export interface AcquireResult<T> {
+    /** The acquired agent */
+    agent: T;
+    /** Pool metadata for this agent */
+    meta: PooledAgentMeta;
+    /** Whether this was a cache hit (from pool) or miss (newly created) */
+    fromPool: boolean;
+    /** Time taken to acquire in ms */
+    acquisitionTimeMs: number;
+}
+/**
+ * Events emitted by the pool
+ */
+export interface PoolEvents {
+    'agent:acquired': {
+        poolId: string;
+        type: QEAgentType;
+        fromPool: boolean;
+    };
+    'agent:released': {
+        poolId: string;
+        type: QEAgentType;
+    };
+    'agent:created': {
+        poolId: string;
+        type: QEAgentType;
+    };
+    'agent:disposed': {
+        poolId: string;
+        type: QEAgentType;
+        reason: string;
+    };
+    'agent:error': {
+        poolId: string;
+        type: QEAgentType;
+        error: Error;
+    };
+    'pool:exhausted': {
+        type: QEAgentType;
+        waitingCount: number;
+    };
+    'pool:expanded': {
+        type: QEAgentType;
+        newSize: number;
+    };
+    'pool:warmed': {
+        type: QEAgentType;
+        count: number;
+    };
+    'pool:healthCheck': {
+        stats: PoolStats;
+    };
+}
+/**
+ * Interface for resettable agents (agents that can be reused)
+ */
+export interface IResettableAgent {
+    /**
+     * Reset agent state for reuse
+     * Called when agent is returned to pool
+     */
+    reset(): Promise<void>;
+    /**
+     * Check if agent is healthy and can be reused
+     */
+    isHealthy(): boolean;
+    /**
+     * Get agent's unique identifier
+     */
+    getId(): string;
+    /**
+     * Get agent type
+     */
+    getType(): QEAgentType;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/agents/pool/types.d.ts.map

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

package/dist/agents/pool/types.js

@@ -0,0 +1,28 @@
+"use strict";
+/**
+ * Agent Pool Types
+ * Phase 3 D1: Memory Pooling for 16x Agent Spawn Speedup
+ *
+ * Target: Reduce spawn time from ~50-100ms to ~3-6ms
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PooledAgentState = void 0;
+/**
+ * State of a pooled agent
+ */
+var PooledAgentState;
+(function (PooledAgentState) {
+    /** Agent is available for acquisition */
+    PooledAgentState["AVAILABLE"] = "available";
+    /** Agent is currently in use */
+    PooledAgentState["IN_USE"] = "in_use";
+    /** Agent is being initialized */
+    PooledAgentState["INITIALIZING"] = "initializing";
+    /** Agent is being reset for reuse */
+    PooledAgentState["RESETTING"] = "resetting";
+    /** Agent has an error and needs recovery */
+    PooledAgentState["ERROR"] = "error";
+    /** Agent is marked for removal */
+    PooledAgentState["DISPOSING"] = "disposing";
+})(PooledAgentState || (exports.PooledAgentState = PooledAgentState = {}));
+//# sourceMappingURL=types.js.map

package/dist/agents/pool/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/agents/pool/types.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AAqDH;;GAEG;AACH,IAAY,gBAkBX;AAlBD,WAAY,gBAAgB;IAC1B,yCAAyC;IACzC,2CAAuB,CAAA;IAEvB,gCAAgC;IAChC,qCAAiB,CAAA;IAEjB,iCAAiC;IACjC,iDAA6B,CAAA;IAE7B,qCAAqC;IACrC,2CAAuB,CAAA;IAEvB,4CAA4C;IAC5C,mCAAe,CAAA;IAEf,kCAAkC;IAClC,2CAAuB,CAAA;AACzB,CAAC,EAlBW,gBAAgB,gCAAhB,gBAAgB,QAkB3B"}

package/dist/cli/commands/knowledge-graph.d.ts

@@ -0,0 +1,112 @@
+/**
+ * Knowledge Graph CLI Commands
+ *
+ * Provides CLI interface for Code Intelligence Knowledge Graph operations:
+ * - index: Index codebase with incremental and watch modes
+ * - query: Natural language code search with hybrid search
+ * - graph: Generate Mermaid diagrams for code relationships
+ * - stats: Display knowledge graph statistics
+ */
+export interface KGIndexOptions {
+    watch: boolean;
+    incremental: boolean;
+    gitSince?: string;
+    verbose: boolean;
+    json: boolean;
+}
+export interface KGQueryOptions {
+    hybrid: boolean;
+    k: number;
+    lang?: string;
+    graphDepth: number;
+    json: boolean;
+    verbose: boolean;
+}
+export interface KGGraphOptions {
+    type: 'class' | 'dependency';
+    output?: string;
+    format: 'mermaid' | 'dot';
+    json: boolean;
+}
+export interface KGStatsOptions {
+    json: boolean;
+    verbose: boolean;
+}
+export declare class KnowledgeGraphCommand {
+    private orchestrator;
+    private formatter;
+    constructor();
+    /**
+     * Index command: Full indexing, incremental, or watch mode
+     */
+    static index(options: KGIndexOptions): Promise<void>;
+    /**
+     * Query command: Hybrid search with formatted results
+     */
+    static query(naturalLanguageQuery: string, options: KGQueryOptions): Promise<void>;
+    /**
+     * Graph command: Generate Mermaid diagram for file/module
+     */
+    static graph(filePath: string, options: KGGraphOptions): Promise<void>;
+    /**
+     * Stats command: Display graph statistics
+     */
+    static stats(options: KGStatsOptions): Promise<void>;
+    /**
+     * Execute index operation
+     */
+    private executeIndex;
+    /**
+     * Execute query operation
+     */
+    private executeQuery;
+    /**
+     * Execute graph generation
+     */
+    private executeGraph;
+    /**
+     * Execute stats display
+     */
+    private executeStats;
+    /**
+     * Initialize Code Intelligence Orchestrator
+     */
+    private initializeOrchestrator;
+    /**
+     * Load configuration from .agentic-qe/config/code-intelligence.json
+     */
+    private loadConfig;
+    /**
+     * Run full index
+     */
+    private runFullIndex;
+    /**
+     * Run incremental indexing based on git changes
+     */
+    private runIncrementalMode;
+    /**
+     * Run watch mode
+     */
+    private runWatchMode;
+    /**
+     * Generate diagram for file
+     */
+    private generateDiagram;
+    /**
+     * Get all edges connecting the given nodes
+     */
+    private getEdgesForNodes;
+    /**
+     * Generate DOT class diagram from real graph data
+     */
+    private generateDotClassDiagram;
+    /**
+     * Generate DOT dependency diagram from real graph data
+     */
+    private generateDotDependencyDiagram;
+    /**
+     * Cleanup resources
+     */
+    private cleanup;
+}
+//# sourceMappingURL=knowledge-graph.d.ts.map

package/dist/cli/commands/knowledge-graph.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"knowledge-graph.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/knowledge-graph.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAcH,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,OAAO,CAAC;IACf,WAAW,EAAE,OAAO,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,EAAE,OAAO,CAAC;CACf;AAED,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,OAAO,CAAC;IAChB,CAAC,EAAE,MAAM,CAAC;IACV,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,OAAO,CAAC;IACd,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,OAAO,GAAG,YAAY,CAAC;IAC7B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,SAAS,GAAG,KAAK,CAAC;IAC1B,IAAI,EAAE,OAAO,CAAC;CACf;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,OAAO,CAAC;IACd,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,qBAAa,qBAAqB;IAChC,OAAO,CAAC,YAAY,CAA6C;IACjE,OAAO,CAAC,SAAS,CAAoB;;IAMrC;;OAEG;WACU,KAAK,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAK1D;;OAEG;WACU,KAAK,CAAC,oBAAoB,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAKxF;;OAEG;WACU,KAAK,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAK5E;;OAEG;WACU,KAAK,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAK1D;;OAEG;YACW,YAAY;IA6B1B;;OAEG;YACW,YAAY;IAgD1B;;OAEG;YACW,YAAY;IAuC1B;;OAEG;YACW,YAAY;IA8B1B;;OAEG;YACW,sBAAsB;IAOpC;;OAEG;YACW,UAAU;IAsBxB;;OAEG;YACW,YAAY;IAiC1B;;OAEG;YACW,kBAAkB;IAgChC;;OAEG;YACW,YAAY;IAsB1B;;OAEG;YACW,eAAe;IAsC7B;;OAEG;IACH,OAAO,CAAC,gBAAgB;IA4BxB;;OAEG;IACH,OAAO,CAAC,uBAAuB;IAqB/B;;OAEG;IACH,OAAO,CAAC,4BAA4B;IAuBpC;;OAEG;YACW,OAAO;CAMtB"}