agentic-qe 3.2.3 → 3.3.1

package/v3/dist/integrations/agentic-flow/model-router/signal-collector.js

@@ -0,0 +1,372 @@
+/**
+ * Agentic QE v3 - Signal Collector
+ * ADR-051: Multi-Model Router - Signal Collection
+ *
+ * Extracts complexity signals from task inputs for model routing decisions.
+ * Collects signals including:
+ * - Code metrics (lines, files, cyclomatic complexity)
+ * - Keyword pattern matching
+ * - Scope detection (architecture, security)
+ * - Agent Booster eligibility
+ *
+ * @module integrations/agentic-flow/model-router/signal-collector
+ */
+import { ALL_TRANSFORM_TYPES } from '../agent-booster/types';
+// ============================================================================
+// Keyword Patterns for Complexity Detection
+// ============================================================================
+/**
+ * Keyword patterns for different complexity levels
+ */
+export const COMPLEXITY_KEYWORDS = {
+    // Tier 0 - Mechanical transforms
+    mechanical: [
+        'convert var to const',
+        'add types',
+        'remove console',
+        'convert to async',
+        'convert to esm',
+        'arrow function',
+        'rename variable',
+        'format code',
+    ],
+    // Tier 1 - Simple tasks
+    simple: [
+        'fix typo',
+        'update comment',
+        'fix simple bug',
+        'add documentation',
+        'format',
+        'rename',
+        'simple refactor',
+        'basic test',
+    ],
+    // Tier 2 - Moderate complexity
+    moderate: [
+        'implement feature',
+        'complex refactor',
+        'performance optimization',
+        'test generation',
+        'error handling',
+        'validation logic',
+        'api integration',
+    ],
+    // Tier 3 - High complexity
+    complex: [
+        'multi-file refactor',
+        'orchestrate',
+        'coordinate',
+        'large codebase',
+        'migration',
+        'cross-domain',
+        'workflow',
+        'system design',
+    ],
+    // Tier 4 - Critical/expert
+    critical: [
+        'architecture',
+        'security audit',
+        'critical bug',
+        'algorithm design',
+        'system-wide',
+        'vulnerability',
+        'cryptography',
+        'performance critical',
+    ],
+};
+/**
+ * Patterns that indicate specific scopes
+ */
+export const SCOPE_PATTERNS = {
+    architecture: /\b(architect|design|system design|overall structure|component design)\b/i,
+    security: /\b(security|vulnerability|audit|xss|sql injection|csrf|encryption)\b/i,
+    multiStep: /\b(orchestrate|coordinate|workflow|pipeline|multi[- ]step)\b/i,
+    crossDomain: /\b(cross[- ]domain|across (domains|modules)|integrate|coordination)\b/i,
+};
+// ============================================================================
+// Signal Collector Implementation
+// ============================================================================
+/**
+ * Collects complexity signals from task inputs
+ */
+export class SignalCollector {
+    config;
+    agentBoosterAdapter;
+    constructor(config, agentBoosterAdapter) {
+        this.config = config;
+        this.agentBoosterAdapter = agentBoosterAdapter;
+    }
+    /**
+     * Collect all complexity signals from input
+     */
+    async collectSignals(input) {
+        const taskLower = input.task.toLowerCase();
+        // Check for Agent Booster eligibility
+        const agentBoosterCheck = await this.checkAgentBoosterEligibility(input);
+        // Detect keyword matches
+        const keywordMatches = {
+            simple: this.findKeywordMatches(taskLower, COMPLEXITY_KEYWORDS.simple),
+            moderate: this.findKeywordMatches(taskLower, COMPLEXITY_KEYWORDS.moderate),
+            complex: this.findKeywordMatches(taskLower, COMPLEXITY_KEYWORDS.complex),
+            critical: this.findKeywordMatches(taskLower, COMPLEXITY_KEYWORDS.critical),
+        };
+        // Analyze code context if provided
+        const linesOfCode = input.codeContext
+            ? input.codeContext.split('\n').length
+            : undefined;
+        const fileCount = input.filePaths ? input.filePaths.length : undefined;
+        // Detect scope patterns
+        const hasArchitectureScope = SCOPE_PATTERNS.architecture.test(taskLower);
+        const hasSecurityScope = SCOPE_PATTERNS.security.test(taskLower);
+        const requiresMultiStepReasoning = SCOPE_PATTERNS.multiStep.test(taskLower);
+        const requiresCrossDomainCoordination = SCOPE_PATTERNS.crossDomain.test(taskLower);
+        // Detect creativity requirements
+        const requiresCreativity = this.detectCreativityRequirement(taskLower);
+        // Estimate language complexity
+        const languageComplexity = this.estimateLanguageComplexity(input.codeContext, input.filePaths);
+        // Estimate cyclomatic complexity
+        const cyclomaticComplexity = input.codeContext
+            ? this.estimateCyclomaticComplexity(input.codeContext)
+            : undefined;
+        return {
+            linesOfCode,
+            fileCount,
+            hasArchitectureScope,
+            hasSecurityScope,
+            requiresMultiStepReasoning,
+            requiresCrossDomainCoordination,
+            isMechanicalTransform: agentBoosterCheck.eligible,
+            languageComplexity,
+            cyclomaticComplexity,
+            dependencyCount: this.countDependencies(input.codeContext),
+            requiresCreativity,
+            detectedTransformType: agentBoosterCheck.transformType,
+            keywordMatches,
+        };
+    }
+    /**
+     * Check if task is eligible for Agent Booster (Tier 0)
+     */
+    async checkAgentBoosterEligibility(input) {
+        if (!this.config.enableAgentBooster || !this.agentBoosterAdapter) {
+            return {
+                eligible: false,
+                confidence: 0,
+                reason: 'Agent Booster is disabled or not available',
+            };
+        }
+        // Check for mechanical transform keywords in task description
+        const taskLower = input.task.toLowerCase();
+        let detectedTransformType;
+        let maxConfidence = 0;
+        for (const transformType of ALL_TRANSFORM_TYPES) {
+            const keywords = this.getTransformKeywords(transformType);
+            let confidence = 0;
+            for (const keyword of keywords) {
+                if (taskLower.includes(keyword.toLowerCase())) {
+                    // ADR-051 Fix: Increase confidence per match to exceed threshold
+                    // Primary keyword match gets 0.5, secondary matches add 0.25
+                    confidence = confidence === 0 ? 0.5 : confidence + 0.25;
+                }
+            }
+            // ADR-051 Fix: Boost confidence for mechanical transform keyword matches
+            // Check if task matches any mechanical keywords from COMPLEXITY_KEYWORDS
+            for (const mechanicalKeyword of COMPLEXITY_KEYWORDS.mechanical) {
+                if (taskLower.includes(mechanicalKeyword.toLowerCase())) {
+                    confidence = Math.max(confidence, 0.6);
+                }
+            }
+            if (confidence > maxConfidence) {
+                maxConfidence = confidence;
+                detectedTransformType = transformType;
+            }
+        }
+        // If code context provided, try Agent Booster detection
+        if (input.codeContext && detectedTransformType) {
+            try {
+                const opportunities = await this.agentBoosterAdapter.detectTransformOpportunities(input.codeContext);
+                const matchingOpp = opportunities.opportunities.find((opp) => opp.type === detectedTransformType);
+                if (matchingOpp) {
+                    return {
+                        eligible: matchingOpp.confidence >= this.config.agentBoosterThreshold,
+                        transformType: detectedTransformType,
+                        confidence: matchingOpp.confidence,
+                        reason: matchingOpp.reason,
+                    };
+                }
+            }
+            catch {
+                // Fall through to keyword-based detection
+            }
+        }
+        // Keyword-based detection
+        const eligible = maxConfidence >= this.config.agentBoosterThreshold &&
+            detectedTransformType !== undefined;
+        return {
+            eligible,
+            transformType: detectedTransformType,
+            confidence: Math.min(maxConfidence, 1),
+            reason: eligible
+                ? `Detected ${detectedTransformType} transform pattern`
+                : 'No mechanical transform pattern detected',
+        };
+    }
+    // ============================================================================
+    // Private Helper Methods
+    // ============================================================================
+    /**
+     * Find matching keywords in text
+     */
+    findKeywordMatches(text, keywords) {
+        const matches = [];
+        for (const keyword of keywords) {
+            if (text.includes(keyword.toLowerCase())) {
+                matches.push(keyword);
+            }
+        }
+        return matches;
+    }
+    /**
+     * Detect creativity requirements from task text
+     */
+    detectCreativityRequirement(taskLower) {
+        return (taskLower.includes('design') ||
+            taskLower.includes('creative') ||
+            taskLower.includes('innovative') ||
+            taskLower.includes('novel'));
+    }
+    /**
+     * Estimate language complexity from code context
+     */
+    estimateLanguageComplexity(codeContext, filePaths) {
+        if (!codeContext && (!filePaths || filePaths.length === 0)) {
+            return undefined;
+        }
+        // Simple heuristic based on file extensions
+        const complexExtensions = ['.ts', '.tsx', '.rs', '.cpp', '.c', '.go'];
+        const mediumExtensions = ['.js', '.jsx', '.py', '.java'];
+        const simpleExtensions = ['.json', '.yaml', '.md', '.txt', '.css', '.html'];
+        if (filePaths) {
+            for (const path of filePaths) {
+                if (complexExtensions.some((ext) => path.endsWith(ext)))
+                    return 'high';
+            }
+            for (const path of filePaths) {
+                if (mediumExtensions.some((ext) => path.endsWith(ext)))
+                    return 'medium';
+            }
+            for (const path of filePaths) {
+                if (simpleExtensions.some((ext) => path.endsWith(ext)))
+                    return 'low';
+            }
+        }
+        // Code-based heuristic
+        if (codeContext) {
+            const hasGenerics = /<[A-Z][^>]*>/.test(codeContext);
+            const hasAsyncAwait = /\b(async|await)\b/.test(codeContext);
+            const hasComplexTypes = /\b(interface|type|class)\b/.test(codeContext);
+            if (hasGenerics && hasComplexTypes)
+                return 'high';
+            if (hasAsyncAwait || hasComplexTypes)
+                return 'medium';
+            return 'low';
+        }
+        return 'medium';
+    }
+    /**
+     * Estimate cyclomatic complexity (simple heuristic)
+     */
+    estimateCyclomaticComplexity(code) {
+        // Count decision points: if, for, while, case, catch, &&, ||, ?
+        const patterns = [
+            /\bif\b/g,
+            /\bfor\b/g,
+            /\bwhile\b/g,
+            /\bcase\b/g,
+            /\bcatch\b/g,
+            /&&/g,
+            /\|\|/g,
+            /\?/g,
+        ];
+        let complexity = 1; // Base complexity
+        for (const pattern of patterns) {
+            const matches = code.match(pattern);
+            if (matches) {
+                complexity += matches.length;
+            }
+        }
+        return complexity;
+    }
+    /**
+     * Count dependencies in code context
+     */
+    countDependencies(codeContext) {
+        if (!codeContext)
+            return undefined;
+        // Count import/require statements
+        const importMatches = codeContext.match(/\b(import|require|from)\b.*['"].*['"]/g);
+        return importMatches ? importMatches.length : 0;
+    }
+    /**
+     * Get transform keywords for Agent Booster detection
+     */
+    getTransformKeywords(transformType) {
+        // ADR-051 Fix: Expanded keyword patterns for better booster eligibility detection
+        const keywordMap = {
+            'var-to-const': [
+                'var to const',
+                'convert var',
+                'var declaration',
+                'var to let',
+                'convert var to const', // Added explicit full phrase
+                'change var to const',
+            ],
+            'add-types': [
+                'add types',
+                'add type',
+                'typescript types',
+                'type annotations',
+                'type annotation',
+                'add type annotations',
+            ],
+            'remove-console': [
+                'remove console',
+                'delete console',
+                'console.log',
+                'remove console.log',
+                'strip console',
+            ],
+            'promise-to-async': [
+                'promise to async',
+                'async await',
+                '.then to async',
+                'convert to async',
+                'convert function to async',
+            ],
+            'cjs-to-esm': [
+                'commonjs to esm',
+                'require to import',
+                'convert to esm',
+                'cjs to esm',
+                'module conversion',
+            ],
+            'func-to-arrow': [
+                'arrow function',
+                'function to arrow',
+                'convert to arrow',
+                'convert function to arrow',
+            ],
+        };
+        return keywordMap[transformType] || [];
+    }
+}
+// ============================================================================
+// Factory Function
+// ============================================================================
+/**
+ * Create a signal collector instance
+ */
+export function createSignalCollector(config, agentBoosterAdapter) {
+    return new SignalCollector(config, agentBoosterAdapter);
+}
+//# sourceMappingURL=signal-collector.js.map

package/v3/dist/integrations/agentic-flow/model-router/signal-collector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"signal-collector.js","sourceRoot":"","sources":["../../../../src/integrations/agentic-flow/model-router/signal-collector.ts"],"names":[],"mappings":"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"}

package/v3/dist/integrations/agentic-flow/model-router/tier-recommender.d.ts

@@ -0,0 +1,64 @@
+/**
+ * Agentic QE v3 - Tier Recommender
+ * ADR-051: Multi-Model Router - Tier Recommendation
+ *
+ * Recommends optimal model tier based on complexity scores.
+ * Provides:
+ * - Primary tier recommendation
+ * - Alternative tier suggestions
+ * - Human-readable explanations
+ *
+ * @module integrations/agentic-flow/model-router/tier-recommender
+ */
+import type { ModelTier, ComplexitySignals } from './types';
+/**
+ * Interface for tier recommendation
+ */
+export interface ITierRecommender {
+    /**
+     * Get recommended tier based on complexity score
+     */
+    getRecommendedTier(complexity: number): ModelTier;
+    /**
+     * Find alternative tiers that could handle this task
+     */
+    findAlternateTiers(complexity: number, recommendedTier: ModelTier): ModelTier[];
+    /**
+     * Generate human-readable explanation
+     */
+    generateExplanation(overall: number, tier: ModelTier, signals: ComplexitySignals): string;
+}
+/**
+ * Recommends optimal model tier based on complexity
+ */
+export declare class TierRecommender implements ITierRecommender {
+    /**
+     * Get recommended tier based on complexity score
+     */
+    getRecommendedTier(complexity: number): ModelTier;
+    /**
+     * Find alternative tiers that could handle this task
+     */
+    findAlternateTiers(complexity: number, recommendedTier: ModelTier): ModelTier[];
+    /**
+     * Generate human-readable explanation
+     */
+    generateExplanation(overall: number, tier: ModelTier, signals: ComplexitySignals): string;
+    /**
+     * Format mechanical transform information
+     */
+    private formatMechanicalTransformInfo;
+    /**
+     * Format scope-related explanations
+     */
+    private formatScopeExplanations;
+    /**
+     * Format code metrics explanations
+     */
+    private formatCodeMetricsExplanations;
+}
+/**
+ * Create a tier recommender instance
+ */
+export declare function createTierRecommender(): TierRecommender;
+//# sourceMappingURL=tier-recommender.d.ts.map

package/v3/dist/integrations/agentic-flow/model-router/tier-recommender.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tier-recommender.d.ts","sourceRoot":"","sources":["../../../../src/integrations/agentic-flow/model-router/tier-recommender.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAO5D;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;OAEG;IACH,kBAAkB,CAAC,UAAU,EAAE,MAAM,GAAG,SAAS,CAAC;IAElD;;OAEG;IACH,kBAAkB,CAAC,UAAU,EAAE,MAAM,EAAE,eAAe,EAAE,SAAS,GAAG,SAAS,EAAE,CAAC;IAEhF;;OAEG;IACH,mBAAmB,CACjB,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,SAAS,EACf,OAAO,EAAE,iBAAiB,GACzB,MAAM,CAAC;CACX;AAMD;;GAEG;AACH,qBAAa,eAAgB,YAAW,gBAAgB;IACtD;;OAEG;IACH,kBAAkB,CAAC,UAAU,EAAE,MAAM,GAAG,SAAS;IAajD;;OAEG;IACH,kBAAkB,CAAC,UAAU,EAAE,MAAM,EAAE,eAAe,EAAE,SAAS,GAAG,SAAS,EAAE;IAmB/E;;OAEG;IACH,mBAAmB,CACjB,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,SAAS,EACf,OAAO,EAAE,iBAAiB,GACzB,MAAM;IAuBT;;OAEG;IACH,OAAO,CAAC,6BAA6B;IAIrC;;OAEG;IACH,OAAO,CAAC,uBAAuB;IAsB/B;;OAEG;IACH,OAAO,CAAC,6BAA6B;CAatC;AAMD;;GAEG;AACH,wBAAgB,qBAAqB,IAAI,eAAe,CAEvD"}

package/v3/dist/integrations/agentic-flow/model-router/tier-recommender.js

@@ -0,0 +1,120 @@
+/**
+ * Agentic QE v3 - Tier Recommender
+ * ADR-051: Multi-Model Router - Tier Recommendation
+ *
+ * Recommends optimal model tier based on complexity scores.
+ * Provides:
+ * - Primary tier recommendation
+ * - Alternative tier suggestions
+ * - Human-readable explanations
+ *
+ * @module integrations/agentic-flow/model-router/tier-recommender
+ */
+import { TIER_METADATA } from './types';
+// ============================================================================
+// Tier Recommender Implementation
+// ============================================================================
+/**
+ * Recommends optimal model tier based on complexity
+ */
+export class TierRecommender {
+    /**
+     * Get recommended tier based on complexity score
+     */
+    getRecommendedTier(complexity) {
+        // Check each tier's complexity range
+        for (const tier of [0, 1, 2, 3, 4]) {
+            const [min, max] = TIER_METADATA[tier].complexityRange;
+            if (complexity >= min && complexity <= max) {
+                return tier;
+            }
+        }
+        // Default to Tier 2 (Sonnet) if no match
+        return 2;
+    }
+    /**
+     * Find alternative tiers that could handle this task
+     */
+    findAlternateTiers(complexity, recommendedTier) {
+        const alternatives = [];
+        // Add adjacent tiers
+        if (recommendedTier > 0) {
+            alternatives.push((recommendedTier - 1));
+        }
+        if (recommendedTier < 4) {
+            alternatives.push((recommendedTier + 1));
+        }
+        // Add tier that can definitely handle it (higher tier)
+        if (recommendedTier < 3 && !alternatives.includes(4)) {
+            alternatives.push(4);
+        }
+        return alternatives;
+    }
+    /**
+     * Generate human-readable explanation
+     */
+    generateExplanation(overall, tier, signals) {
+        const parts = [];
+        parts.push(`Complexity score: ${overall}/100 (Tier ${tier})`);
+        // Add mechanical transform info
+        if (signals.isMechanicalTransform) {
+            parts.push(this.formatMechanicalTransformInfo(signals.detectedTransformType));
+        }
+        // Add scope-related explanations
+        parts.push(...this.formatScopeExplanations(signals));
+        // Add code metrics if significant
+        parts.push(...this.formatCodeMetricsExplanations(signals));
+        return parts.join('. ');
+    }
+    // ============================================================================
+    // Private Helper Methods
+    // ============================================================================
+    /**
+     * Format mechanical transform information
+     */
+    formatMechanicalTransformInfo(transformType) {
+        return `Detected mechanical transform: ${transformType}`;
+    }
+    /**
+     * Format scope-related explanations
+     */
+    formatScopeExplanations(signals) {
+        const explanations = [];
+        if (signals.hasArchitectureScope) {
+            explanations.push('Architecture scope detected');
+        }
+        if (signals.hasSecurityScope) {
+            explanations.push('Security scope detected');
+        }
+        if (signals.requiresMultiStepReasoning) {
+            explanations.push('Multi-step reasoning required');
+        }
+        if (signals.requiresCrossDomainCoordination) {
+            explanations.push('Cross-domain coordination required');
+        }
+        return explanations;
+    }
+    /**
+     * Format code metrics explanations
+     */
+    formatCodeMetricsExplanations(signals) {
+        const explanations = [];
+        if (signals.linesOfCode !== undefined && signals.linesOfCode > 100) {
+            explanations.push(`Large code change: ${signals.linesOfCode} lines`);
+        }
+        if (signals.fileCount !== undefined && signals.fileCount > 3) {
+            explanations.push(`Multi-file change: ${signals.fileCount} files`);
+        }
+        return explanations;
+    }
+}
+// ============================================================================
+// Factory Function
+// ============================================================================
+/**
+ * Create a tier recommender instance
+ */
+export function createTierRecommender() {
+    return new TierRecommender();
+}
+//# sourceMappingURL=tier-recommender.js.map

package/v3/dist/integrations/agentic-flow/model-router/tier-recommender.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tier-recommender.js","sourceRoot":"","sources":["../../../../src/integrations/agentic-flow/model-router/tier-recommender.ts"],"names":[],"mappings":"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"}