agentic-qe 3.2.3 → 3.3.1

package/v3/assets/agents/v3/qe-accessibility-auditor.md

@@ -30,6 +30,11 @@ Working:
 - Extended aria-describedby descriptions for screen readers
 - Copy-paste ready code fixes for all violations
 - Comprehensive HTML/Markdown report generation
+- **EN 301 549 V3.2.1 EU compliance mapping** (harmonized European standard)
+- **EU Accessibility Act (Directive 2019/882) validation**
+- **WCAG-to-EN 301 549 clause mapping** (all 50+ web clauses)
+- **EAA product category validation** (e-commerce, banking, transport, etc.)
+- **Certification-ready EU compliance reports**
 
 Partial:
 - Screen reader testing (NVDA, VoiceOver, JAWS)
@@ -92,6 +97,21 @@ Use up to 6 concurrent auditors for large sites.
   - Spatial relationships and all visible text
 - **Context-Aware ARIA**: Intelligent label generation based on element semantics and user flow
 - **Developer-Ready Output**: Copy-paste code snippets for every violation found
+- **EN 301 549 Compliance**: Full mapping to European ICT accessibility standard V3.2.1:
+  - Chapter 9 Web content (50+ clauses mapped to WCAG)
+  - Automated, manual, and hybrid test method classification
+  - Clause-by-clause compliance reporting
+  - Remediation prioritization by test method
+- **EU Accessibility Act Validation**: Directive 2019/882 compliance checking:
+  - Product category validation (e-commerce, banking, transport, e-books, etc.)
+  - Requirements mapping to EN 301 549 clauses
+  - Exemption tracking (micro-enterprise, disproportionate burden)
+  - Annex I functional requirements validation
+- **EU Certification Reports**: Generate certification-ready compliance documentation:
+  - Overall compliance status (compliant/partially-compliant/non-compliant)
+  - Failed/passed/partial clause breakdown
+  - Prioritized remediation recommendations with deadlines
+  - Next review date scheduling
 </capabilities>
 
 <memory_namespace>
@@ -326,6 +346,76 @@ Remediation Code:
 Remediation Effort: 15 minutes (copy/paste generated files)
 Learning: Stored pattern "automotive-video-captions" with 0.91 confidence
 ```
+
+Example 4: EU compliance audit (EN 301 549 + EU Accessibility Act)
+```
+Input: Validate EU compliance for e-commerce platform
+- URL: https://shop.example.eu
+- Standard: EN 301 549 V3.2.1
+- Include: EU Accessibility Act (Directive 2019/882)
+- Product Category: e-commerce
+
+Output: EU Compliance Report
+- URL: https://shop.example.eu
+- Standard: EN 301 549 V3.2.1 + EAA
+
+Overall Status: PARTIALLY COMPLIANT
+Compliance Score: 78%
+Certification Ready: NO
+
+EN 301 549 Results:
+- Total Clauses Evaluated: 47
+- Passed: 35 (74%)
+- Partial: 8 (17%)
+- Failed: 4 (9%)
+
+Failed Clauses:
+1. 9.1.1.1 Non-text content (WCAG 1.1.1)
+   - 12 images missing alt text
+   - Test method: automated
+   - Priority: HIGH
+
+2. 9.1.4.3 Contrast (minimum) (WCAG 1.4.3)
+   - 8 elements below 4.5:1 ratio
+   - Test method: automated
+   - Priority: HIGH
+
+3. 9.2.4.7 Focus visible (WCAG 2.4.7)
+   - Custom buttons hide focus indicator
+   - Test method: hybrid
+   - Priority: MEDIUM
+
+4. 9.3.3.2 Labels or instructions (WCAG 3.3.2)
+   - Checkout form missing field labels
+   - Test method: hybrid
+   - Priority: HIGH
+
+EU Accessibility Act (EAA) Results:
+- Product Category: e-commerce
+- Applicable Requirements: 6
+- Failed Requirements: 2
+
+Failed EAA Requirements:
+1. EAA-I.1 Perceivable information
+   - Linked to EN 301 549: 9.1.1.1, 9.1.2.2
+   - Status: NOT MET
+
+2. EAA-I.2 Operable user interface
+   - Linked to EN 301 549: 9.2.4.7
+   - Status: PARTIALLY MET
+
+Top Recommendations:
+| Priority | Clause | Remediation | Effort | Deadline |
+|----------|--------|-------------|--------|----------|
+| HIGH | 9.1.1.1 | Add alt text to all images | Minor | 30 days |
+| HIGH | 9.1.4.3 | Fix contrast ratios | Minor | 30 days |
+| HIGH | 9.3.3.2 | Add form labels | Trivial | 30 days |
+| MEDIUM | 9.2.4.7 | Restore :focus-visible | Trivial | - |
+
+Next Review Date: 2027-01-24 (annual)
+
+Learning: Stored pattern "eu-e-commerce-compliance" with 0.89 confidence
+```
 </examples>
 
 <skills_available>

package/v3/dist/adapters/claude-flow/index.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Claude Flow Adapters
+ * Bridges for optional Claude Flow MCP integration
+ *
+ * These adapters provide enhanced capabilities when Claude Flow is installed:
+ * - SONA trajectory tracking for reinforcement learning
+ * - 3-tier model routing (haiku/sonnet/opus)
+ * - Codebase pretrain analysis
+ *
+ * When Claude Flow is not available, they gracefully fall back to:
+ * - Local SQLite trajectory storage
+ * - Rule-based model routing
+ * - AQE's built-in project analyzer
+ */
+export type { Trajectory, TrajectoryStep, ModelRoutingResult, ModelRoutingOutcome, PretrainResult, ClaudeFlowPattern, PatternSearchResult, BridgeStatus, } from './types.js';
+export { TrajectoryBridge, createTrajectoryBridge, } from './trajectory-bridge.js';
+export { ModelRouterBridge, createModelRouterBridge, } from './model-router-bridge.js';
+export { PretrainBridge, createPretrainBridge, } from './pretrain-bridge.js';
+/**
+ * Unified Claude Flow bridge that manages all sub-bridges
+ */
+export declare class ClaudeFlowBridge {
+    private options;
+    readonly trajectory: TrajectoryBridge;
+    readonly modelRouter: ModelRouterBridge;
+    readonly pretrain: PretrainBridge;
+    private initialized;
+    constructor(options: {
+        projectRoot: string;
+    });
+    /**
+     * Initialize all bridges
+     */
+    initialize(): Promise<void>;
+    /**
+     * Get bridge status
+     */
+    getStatus(): BridgeStatus;
+    /**
+     * Check if any Claude Flow features are available
+     */
+    isAvailable(): boolean;
+}
+/**
+ * Create unified Claude Flow bridge
+ */
+export declare function createClaudeFlowBridge(options: {
+    projectRoot: string;
+}): ClaudeFlowBridge;
+import { TrajectoryBridge } from './trajectory-bridge.js';
+import { ModelRouterBridge } from './model-router-bridge.js';
+import { PretrainBridge } from './pretrain-bridge.js';
+import type { BridgeStatus } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/v3/dist/adapters/claude-flow/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/adapters/claude-flow/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,YAAY,EACV,UAAU,EACV,cAAc,EACd,kBAAkB,EAClB,mBAAmB,EACnB,cAAc,EACd,iBAAiB,EACjB,mBAAmB,EACnB,YAAY,GACb,MAAM,YAAY,CAAC;AAEpB,OAAO,EACL,gBAAgB,EAChB,sBAAsB,GACvB,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EACL,iBAAiB,EACjB,uBAAuB,GACxB,MAAM,0BAA0B,CAAC;AAElC,OAAO,EACL,cAAc,EACd,oBAAoB,GACrB,MAAM,sBAAsB,CAAC;AAE9B;;GAEG;AACH,qBAAa,gBAAgB;IAOf,OAAO,CAAC,OAAO;IAN3B,QAAQ,CAAC,UAAU,EAAE,gBAAgB,CAAC;IACtC,QAAQ,CAAC,WAAW,EAAE,iBAAiB,CAAC;IACxC,QAAQ,CAAC,QAAQ,EAAE,cAAc,CAAC;IAElC,OAAO,CAAC,WAAW,CAAS;gBAER,OAAO,EAAE;QAAE,WAAW,EAAE,MAAM,CAAA;KAAE;IAMpD;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAYjC;;OAEG;IACH,SAAS,IAAI,YAAY;IAYzB;;OAEG;IACH,WAAW,IAAI,OAAO;CAOvB;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE;IAAE,WAAW,EAAE,MAAM,CAAA;CAAE,GAAG,gBAAgB,CAEzF;AAGD,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC"}

package/v3/dist/adapters/claude-flow/index.js

@@ -0,0 +1,79 @@
+/**
+ * Claude Flow Adapters
+ * Bridges for optional Claude Flow MCP integration
+ *
+ * These adapters provide enhanced capabilities when Claude Flow is installed:
+ * - SONA trajectory tracking for reinforcement learning
+ * - 3-tier model routing (haiku/sonnet/opus)
+ * - Codebase pretrain analysis
+ *
+ * When Claude Flow is not available, they gracefully fall back to:
+ * - Local SQLite trajectory storage
+ * - Rule-based model routing
+ * - AQE's built-in project analyzer
+ */
+export { TrajectoryBridge, createTrajectoryBridge, } from './trajectory-bridge.js';
+export { ModelRouterBridge, createModelRouterBridge, } from './model-router-bridge.js';
+export { PretrainBridge, createPretrainBridge, } from './pretrain-bridge.js';
+/**
+ * Unified Claude Flow bridge that manages all sub-bridges
+ */
+export class ClaudeFlowBridge {
+    options;
+    trajectory;
+    modelRouter;
+    pretrain;
+    initialized = false;
+    constructor(options) {
+        this.options = options;
+        this.trajectory = new TrajectoryBridge(options);
+        this.modelRouter = new ModelRouterBridge(options);
+        this.pretrain = new PretrainBridge(options);
+    }
+    /**
+     * Initialize all bridges
+     */
+    async initialize() {
+        if (this.initialized)
+            return;
+        await Promise.all([
+            this.trajectory.initialize(),
+            this.modelRouter.initialize(),
+            this.pretrain.initialize(),
+        ]);
+        this.initialized = true;
+    }
+    /**
+     * Get bridge status
+     */
+    getStatus() {
+        return {
+            available: this.isAvailable(),
+            features: {
+                trajectories: this.trajectory.isClaudeFlowAvailable(),
+                modelRouting: this.modelRouter.isClaudeFlowAvailable(),
+                pretrain: this.pretrain.isClaudeFlowAvailable(),
+                patternSearch: this.trajectory.isClaudeFlowAvailable(), // Uses same check
+            },
+        };
+    }
+    /**
+     * Check if any Claude Flow features are available
+     */
+    isAvailable() {
+        return (this.trajectory.isClaudeFlowAvailable() ||
+            this.modelRouter.isClaudeFlowAvailable() ||
+            this.pretrain.isClaudeFlowAvailable());
+    }
+}
+/**
+ * Create unified Claude Flow bridge
+ */
+export function createClaudeFlowBridge(options) {
+    return new ClaudeFlowBridge(options);
+}
+// Re-export bridge classes for direct use
+import { TrajectoryBridge } from './trajectory-bridge.js';
+import { ModelRouterBridge } from './model-router-bridge.js';
+import { PretrainBridge } from './pretrain-bridge.js';
+//# sourceMappingURL=index.js.map

package/v3/dist/adapters/claude-flow/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/adapters/claude-flow/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAaH,OAAO,EACL,gBAAgB,EAChB,sBAAsB,GACvB,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EACL,iBAAiB,EACjB,uBAAuB,GACxB,MAAM,0BAA0B,CAAC;AAElC,OAAO,EACL,cAAc,EACd,oBAAoB,GACrB,MAAM,sBAAsB,CAAC;AAE9B;;GAEG;AACH,MAAM,OAAO,gBAAgB;IAOP;IANX,UAAU,CAAmB;IAC7B,WAAW,CAAoB;IAC/B,QAAQ,CAAiB;IAE1B,WAAW,GAAG,KAAK,CAAC;IAE5B,YAAoB,OAAgC;QAAhC,YAAO,GAAP,OAAO,CAAyB;QAClD,IAAI,CAAC,UAAU,GAAG,IAAI,gBAAgB,CAAC,OAAO,CAAC,CAAC;QAChD,IAAI,CAAC,WAAW,GAAG,IAAI,iBAAiB,CAAC,OAAO,CAAC,CAAC;QAClD,IAAI,CAAC,QAAQ,GAAG,IAAI,cAAc,CAAC,OAAO,CAAC,CAAC;IAC9C,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,UAAU;QACd,IAAI,IAAI,CAAC,WAAW;YAAE,OAAO;QAE7B,MAAM,OAAO,CAAC,GAAG,CAAC;YAChB,IAAI,CAAC,UAAU,CAAC,UAAU,EAAE;YAC5B,IAAI,CAAC,WAAW,CAAC,UAAU,EAAE;YAC7B,IAAI,CAAC,QAAQ,CAAC,UAAU,EAAE;SAC3B,CAAC,CAAC;QAEH,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC;IAC1B,CAAC;IAED;;OAEG;IACH,SAAS;QACP,OAAO;YACL,SAAS,EAAE,IAAI,CAAC,WAAW,EAAE;YAC7B,QAAQ,EAAE;gBACR,YAAY,EAAE,IAAI,CAAC,UAAU,CAAC,qBAAqB,EAAE;gBACrD,YAAY,EAAE,IAAI,CAAC,WAAW,CAAC,qBAAqB,EAAE;gBACtD,QAAQ,EAAE,IAAI,CAAC,QAAQ,CAAC,qBAAqB,EAAE;gBAC/C,aAAa,EAAE,IAAI,CAAC,UAAU,CAAC,qBAAqB,EAAE,EAAE,kBAAkB;aAC3E;SACF,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,WAAW;QACT,OAAO,CACL,IAAI,CAAC,UAAU,CAAC,qBAAqB,EAAE;YACvC,IAAI,CAAC,WAAW,CAAC,qBAAqB,EAAE;YACxC,IAAI,CAAC,QAAQ,CAAC,qBAAqB,EAAE,CACtC,CAAC;IACJ,CAAC;CACF;AAED;;GAEG;AACH,MAAM,UAAU,sBAAsB,CAAC,OAAgC;IACrE,OAAO,IAAI,gBAAgB,CAAC,OAAO,CAAC,CAAC;AACvC,CAAC;AAED,0CAA0C;AAC1C,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC"}

package/v3/dist/adapters/claude-flow/model-router-bridge.d.ts

@@ -0,0 +1,70 @@
+/**
+ * Model Router Bridge
+ * Connects AQE to Claude Flow's 3-tier model routing (ADR-026)
+ *
+ * When Claude Flow is available:
+ * - Routes tasks to optimal model (haiku/sonnet/opus)
+ * - Records outcomes for learning
+ * - Uses Claude Flow's learned patterns
+ *
+ * When not available:
+ * - Uses simple rule-based routing
+ * - Falls back to sonnet as default
+ */
+import type { ModelRoutingResult, ModelRoutingOutcome } from './types.js';
+/**
+ * Model Router Bridge for 3-tier routing
+ */
+export declare class ModelRouterBridge {
+    private options;
+    private claudeFlowAvailable;
+    private routingHistory;
+    constructor(options: {
+        projectRoot: string;
+    });
+    /**
+     * Initialize the bridge
+     */
+    initialize(): Promise<void>;
+    /**
+     * Check if Claude Flow is available
+     */
+    private checkClaudeFlow;
+    /**
+     * Route task to optimal model
+     */
+    routeTask(task: string): Promise<ModelRoutingResult>;
+    /**
+     * Record model routing outcome
+     */
+    recordOutcome(outcome: ModelRoutingOutcome): Promise<void>;
+    /**
+     * Get routing statistics
+     */
+    getStats(): {
+        totalRoutings: number;
+        modelDistribution: Record<string, number>;
+        successRate: Record<string, number>;
+    };
+    /**
+     * Check if Claude Flow is available
+     */
+    isClaudeFlowAvailable(): boolean;
+    /**
+     * Local rule-based routing
+     */
+    private localRoute;
+    /**
+     * Escape shell argument using $'...' syntax for complete safety
+     * This ANSI-C quoting handles ALL special characters including backslashes
+     * CodeQL: js/incomplete-sanitization - Fixed by escaping backslashes AND quotes
+     */
+    private escapeArg;
+}
+/**
+ * Create model router bridge
+ */
+export declare function createModelRouterBridge(options: {
+    projectRoot: string;
+}): ModelRouterBridge;
+//# sourceMappingURL=model-router-bridge.d.ts.map

package/v3/dist/adapters/claude-flow/model-router-bridge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-router-bridge.d.ts","sourceRoot":"","sources":["../../../src/adapters/claude-flow/model-router-bridge.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAiB1E;;GAEG;AACH,qBAAa,iBAAiB;IAIhB,OAAO,CAAC,OAAO;IAH3B,OAAO,CAAC,mBAAmB,CAAS;IACpC,OAAO,CAAC,cAAc,CAA6B;gBAE/B,OAAO,EAAE;QAAE,WAAW,EAAE,MAAM,CAAA;KAAE;IAEpD;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAIjC;;OAEG;YACW,eAAe;IAc7B;;OAEG;IACG,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC;IA8B1D;;OAEG;IACG,aAAa,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC;IAsBhE;;OAEG;IACH,QAAQ,IAAI;QACV,aAAa,EAAE,MAAM,CAAC;QACtB,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAC1C,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;KACrC;IAwBD;;OAEG;IACH,qBAAqB,IAAI,OAAO;IAIhC;;OAEG;IACH,OAAO,CAAC,UAAU;IAkDlB;;;;OAIG;IACH,OAAO,CAAC,SAAS;CAQlB;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE;IAAE,WAAW,EAAE,MAAM,CAAA;CAAE,GAAG,iBAAiB,CAE3F"}

package/v3/dist/adapters/claude-flow/model-router-bridge.js

@@ -0,0 +1,203 @@
+/**
+ * Model Router Bridge
+ * Connects AQE to Claude Flow's 3-tier model routing (ADR-026)
+ *
+ * When Claude Flow is available:
+ * - Routes tasks to optimal model (haiku/sonnet/opus)
+ * - Records outcomes for learning
+ * - Uses Claude Flow's learned patterns
+ *
+ * When not available:
+ * - Uses simple rule-based routing
+ * - Falls back to sonnet as default
+ */
+/**
+ * Task complexity indicators
+ */
+const COMPLEXITY_INDICATORS = {
+    low: [
+        /simple/i, /basic/i, /fix typo/i, /rename/i, /format/i,
+        /add comment/i, /lint/i, /minor/i, /quick/i,
+    ],
+    high: [
+        /architect/i, /design/i, /complex/i, /security/i, /performance/i,
+        /refactor.*large/i, /critical/i, /analysis/i, /multi.*file/i,
+        /database.*migration/i, /distributed/i, /concurrent/i,
+    ],
+};
+/**
+ * Model Router Bridge for 3-tier routing
+ */
+export class ModelRouterBridge {
+    options;
+    claudeFlowAvailable = false;
+    routingHistory = [];
+    constructor(options) {
+        this.options = options;
+    }
+    /**
+     * Initialize the bridge
+     */
+    async initialize() {
+        this.claudeFlowAvailable = await this.checkClaudeFlow();
+    }
+    /**
+     * Check if Claude Flow is available
+     */
+    async checkClaudeFlow() {
+        try {
+            const { execSync } = await import('child_process');
+            execSync('npx @claude-flow/cli@latest hooks model-stats 2>/dev/null', {
+                encoding: 'utf-8',
+                timeout: 5000,
+                cwd: this.options.projectRoot,
+            });
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * Route task to optimal model
+     */
+    async routeTask(task) {
+        if (this.claudeFlowAvailable) {
+            try {
+                const { execSync } = await import('child_process');
+                const result = execSync(`npx @claude-flow/cli@latest hooks model-route --task ${this.escapeArg(task)} 2>/dev/null`, { encoding: 'utf-8', timeout: 10000, cwd: this.options.projectRoot });
+                // Parse result
+                const modelMatch = result.match(/model[:\s]+["']?(haiku|sonnet|opus)/i);
+                const confMatch = result.match(/confidence[:\s]+([0-9.]+)/i);
+                const reasonMatch = result.match(/reason(?:ing)?[:\s]+["']?([^"'\n]+)/i);
+                if (modelMatch) {
+                    return {
+                        model: modelMatch[1].toLowerCase(),
+                        confidence: confMatch ? parseFloat(confMatch[1]) : 0.7,
+                        reasoning: reasonMatch?.[1]?.trim(),
+                    };
+                }
+            }
+            catch {
+                // Fall through to local routing
+            }
+        }
+        // Local rule-based routing
+        return this.localRoute(task);
+    }
+    /**
+     * Record model routing outcome
+     */
+    async recordOutcome(outcome) {
+        // Store locally
+        this.routingHistory.push(outcome);
+        // Trim history
+        if (this.routingHistory.length > 1000) {
+            this.routingHistory = this.routingHistory.slice(-500);
+        }
+        if (this.claudeFlowAvailable) {
+            try {
+                const { execSync } = await import('child_process');
+                execSync(`npx @claude-flow/cli@latest hooks model-outcome --task ${this.escapeArg(outcome.task)} --model ${outcome.model} --outcome ${outcome.outcome} 2>/dev/null`, { encoding: 'utf-8', timeout: 10000, cwd: this.options.projectRoot });
+            }
+            catch {
+                // Silently fail - outcome recording is optional
+            }
+        }
+    }
+    /**
+     * Get routing statistics
+     */
+    getStats() {
+        const stats = {
+            totalRoutings: this.routingHistory.length,
+            modelDistribution: { haiku: 0, sonnet: 0, opus: 0 },
+            successRate: { haiku: 0, sonnet: 0, opus: 0 },
+        };
+        const successCounts = { haiku: 0, sonnet: 0, opus: 0 };
+        for (const outcome of this.routingHistory) {
+            stats.modelDistribution[outcome.model]++;
+            if (outcome.outcome === 'success') {
+                successCounts[outcome.model]++;
+            }
+        }
+        for (const model of ['haiku', 'sonnet', 'opus']) {
+            const total = stats.modelDistribution[model];
+            stats.successRate[model] = total > 0 ? successCounts[model] / total : 0;
+        }
+        return stats;
+    }
+    /**
+     * Check if Claude Flow is available
+     */
+    isClaudeFlowAvailable() {
+        return this.claudeFlowAvailable;
+    }
+    /**
+     * Local rule-based routing
+     */
+    localRoute(task) {
+        const taskLower = task.toLowerCase();
+        // Check for low complexity indicators → haiku
+        for (const pattern of COMPLEXITY_INDICATORS.low) {
+            if (pattern.test(taskLower)) {
+                return {
+                    model: 'haiku',
+                    confidence: 0.75,
+                    reasoning: 'Low complexity task detected - using haiku for speed',
+                };
+            }
+        }
+        // Check for high complexity indicators → opus
+        for (const pattern of COMPLEXITY_INDICATORS.high) {
+            if (pattern.test(taskLower)) {
+                return {
+                    model: 'opus',
+                    confidence: 0.8,
+                    reasoning: 'High complexity task detected - using opus for capability',
+                };
+            }
+        }
+        // Check task length as proxy for complexity
+        if (task.length > 500) {
+            return {
+                model: 'opus',
+                confidence: 0.65,
+                reasoning: 'Long task description - using opus for complex reasoning',
+            };
+        }
+        if (task.length < 50) {
+            return {
+                model: 'haiku',
+                confidence: 0.6,
+                reasoning: 'Short task description - using haiku for efficiency',
+            };
+        }
+        // Default to sonnet (balanced)
+        return {
+            model: 'sonnet',
+            confidence: 0.7,
+            reasoning: 'Medium complexity task - using sonnet for balance',
+        };
+    }
+    /**
+     * Escape shell argument using $'...' syntax for complete safety
+     * This ANSI-C quoting handles ALL special characters including backslashes
+     * CodeQL: js/incomplete-sanitization - Fixed by escaping backslashes AND quotes
+     */
+    escapeArg(arg) {
+        // Escape backslashes first, then single quotes, using ANSI-C quoting
+        // $'...' syntax interprets escape sequences like \\ and \'
+        const escaped = arg
+            .replace(/\\/g, '\\\\') // Escape backslashes first
+            .replace(/'/g, "\\'"); // Then escape single quotes
+        return "$'" + escaped + "'";
+    }
+}
+/**
+ * Create model router bridge
+ */
+export function createModelRouterBridge(options) {
+    return new ModelRouterBridge(options);
+}
+//# sourceMappingURL=model-router-bridge.js.map

package/v3/dist/adapters/claude-flow/model-router-bridge.js.map

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

package/v3/dist/adapters/claude-flow/pretrain-bridge.d.ts

@@ -0,0 +1,73 @@
+/**
+ * Pretrain Bridge
+ * Connects AQE to Claude Flow's codebase analysis pipeline
+ *
+ * When Claude Flow is available:
+ * - Uses 4-step pretrain pipeline for codebase understanding
+ * - Generates optimized agent configurations
+ * - Transfers learned patterns
+ *
+ * When not available:
+ * - Uses AQE's built-in project analyzer
+ * - Generates basic agent configurations
+ */
+import type { PretrainResult } from './types.js';
+/**
+ * Pretrain Bridge for codebase analysis
+ */
+export declare class PretrainBridge {
+    private options;
+    private claudeFlowAvailable;
+    private analysisCache;
+    constructor(options: {
+        projectRoot: string;
+    });
+    /**
+     * Initialize the bridge
+     */
+    initialize(): Promise<void>;
+    /**
+     * Check if Claude Flow is available
+     */
+    private checkClaudeFlow;
+    /**
+     * Run pretrain analysis
+     */
+    analyze(path?: string, depth?: 'shallow' | 'medium' | 'deep'): Promise<PretrainResult>;
+    /**
+     * Generate agent configurations from analysis
+     */
+    generateAgentConfigs(format?: 'yaml' | 'json'): Promise<Record<string, unknown>[]>;
+    /**
+     * Transfer patterns from another project
+     */
+    transferPatterns(sourcePath: string, minConfidence?: number): Promise<{
+        transferred: number;
+        skipped: number;
+    }>;
+    /**
+     * Check if Claude Flow is available
+     */
+    isClaudeFlowAvailable(): boolean;
+    /**
+     * Escape shell argument using $'...' syntax for complete safety
+     * This ANSI-C quoting handles ALL special characters including backslashes
+     * CodeQL: js/incomplete-sanitization - Fixed by escaping backslashes AND quotes
+     */
+    private escapeArg;
+    /**
+     * Local analysis using file system scanning
+     */
+    private localAnalyze;
+    /**
+     * Generate basic QE agent configurations
+     */
+    private generateLocalAgentConfigs;
+}
+/**
+ * Create pretrain bridge
+ */
+export declare function createPretrainBridge(options: {
+    projectRoot: string;
+}): PretrainBridge;
+//# sourceMappingURL=pretrain-bridge.d.ts.map

package/v3/dist/adapters/claude-flow/pretrain-bridge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pretrain-bridge.d.ts","sourceRoot":"","sources":["../../../src/adapters/claude-flow/pretrain-bridge.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjD;;GAEG;AACH,qBAAa,cAAc;IAIb,OAAO,CAAC,OAAO;IAH3B,OAAO,CAAC,mBAAmB,CAAS;IACpC,OAAO,CAAC,aAAa,CAA0C;gBAE3C,OAAO,EAAE;QAAE,WAAW,EAAE,MAAM,CAAA;KAAE;IAEpD;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAIjC;;OAEG;YACW,eAAe;IAc7B;;OAEG;IACG,OAAO,CACX,IAAI,CAAC,EAAE,MAAM,EACb,KAAK,GAAE,SAAS,GAAG,QAAQ,GAAG,MAAiB,GAC9C,OAAO,CAAC,cAAc,CAAC;IAgD1B;;OAEG;IACG,oBAAoB,CACxB,MAAM,GAAE,MAAM,GAAG,MAAe,GAC/B,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC;IAuBrC;;OAEG;IACG,gBAAgB,CACpB,UAAU,EAAE,MAAM,EAClB,aAAa,GAAE,MAAY,GAC1B,OAAO,CAAC;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IAwBpD;;OAEG;IACH,qBAAqB,IAAI,OAAO;IAIhC;;;;OAIG;IACH,OAAO,CAAC,SAAS;IASjB;;OAEG;YACW,YAAY;IAgF1B;;OAEG;IACH,OAAO,CAAC,yBAAyB;CA4BlC;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE;IAAE,WAAW,EAAE,MAAM,CAAA;CAAE,GAAG,cAAc,CAErF"}