@agentic-qe/v3 3.0.0-alpha.3

package/dist/integrations/ruvector/interfaces.d.ts

@@ -0,0 +1,488 @@
+/**
+ * Agentic QE v3 - RuVector Integration Interfaces
+ *
+ * RuVector provides ML-based code intelligence for QE.
+ * This is an OPTIONAL dependency - all features work without it.
+ *
+ * Integration Points per ADR-017:
+ * | RuVector Feature      | QE Application                    |
+ * |----------------------|-----------------------------------|
+ * | Q-Learning Router    | Route test tasks to optimal agents|
+ * | AST Complexity       | Prioritize tests by code complexity|
+ * | Diff Risk Classification | Target tests at high-risk changes |
+ * | Coverage Routing     | Test coverage-aware agent selection|
+ * | Graph Boundaries     | Focus integration tests at module boundaries |
+ */
+import type { AgentType, DomainName, Severity, Priority } from '../../shared/types';
+/**
+ * Configuration for RuVector client connection
+ */
+export interface RuVectorConfig {
+    /** Whether RuVector integration is enabled */
+    enabled: boolean;
+    /** RuVector service endpoint (e.g., 'http://localhost:8080') */
+    endpoint?: string;
+    /** Path to local RuVector database file */
+    databasePath?: string;
+    /** Connection timeout in milliseconds */
+    timeout?: number;
+    /** Enable caching of RuVector results */
+    cacheEnabled?: boolean;
+    /** Cache TTL in milliseconds */
+    cacheTtl?: number;
+    /** Fallback to rule-based logic when RuVector unavailable */
+    fallbackEnabled?: boolean;
+    /** Retry attempts for failed connections */
+    retryAttempts?: number;
+    /** Retry delay in milliseconds */
+    retryDelayMs?: number;
+}
+/**
+ * Default RuVector configuration
+ */
+export declare const DEFAULT_RUVECTOR_CONFIG: Required<RuVectorConfig>;
+/**
+ * Connection status for RuVector service
+ */
+export type RuVectorConnectionStatus = 'connected' | 'disconnected' | 'connecting' | 'error' | 'unavailable';
+/**
+ * RuVector health check result
+ */
+export interface RuVectorHealthResult {
+    status: RuVectorConnectionStatus;
+    version?: string;
+    features: string[];
+    latencyMs?: number;
+    lastChecked: Date;
+    error?: string;
+}
+/**
+ * Main RuVector client interface for QE integration
+ */
+export interface RuVectorClient {
+    /** Check if RuVector is available */
+    isAvailable(): Promise<boolean>;
+    /** Get health status */
+    getHealth(): Promise<RuVectorHealthResult>;
+    /** Q-Learning router for agent selection */
+    getQLearningRouter(): QLearningRouter;
+    /** AST complexity analyzer */
+    getASTComplexityAnalyzer(): ASTComplexityAnalyzer;
+    /** Diff risk classifier */
+    getDiffRiskClassifier(): DiffRiskClassifier;
+    /** Coverage-aware router */
+    getCoverageRouter(): CoverageRouter;
+    /** Graph boundaries analyzer */
+    getGraphBoundaries(): GraphBoundariesAnalyzer;
+    /** Initialize client */
+    initialize(): Promise<void>;
+    /** Dispose client resources */
+    dispose(): Promise<void>;
+}
+/**
+ * Test task for routing
+ */
+export interface TestTask {
+    id: string;
+    name: string;
+    type: 'unit' | 'integration' | 'e2e' | 'performance' | 'security' | 'accessibility';
+    domain?: DomainName;
+    filePath?: string;
+    complexity?: number;
+    priority?: Priority;
+    dependencies?: string[];
+    estimatedDurationMs?: number;
+    tags?: string[];
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Agent routing result
+ */
+export interface AgentRoutingResult {
+    /** Recommended agent type */
+    agentType: AgentType;
+    /** Domain to route to */
+    domain: DomainName;
+    /** Confidence score 0-1 */
+    confidence: number;
+    /** Reasoning for the routing decision */
+    reasoning: string;
+    /** Alternative agents ranked by suitability */
+    alternatives: Array<{
+        agentType: AgentType;
+        domain: DomainName;
+        confidence: number;
+    }>;
+    /** Q-values for debugging */
+    qValues?: Record<string, number>;
+    /** Whether this used fallback logic */
+    usedFallback: boolean;
+}
+/**
+ * Q-Learning state for reinforcement learning
+ */
+export interface QLearningState {
+    taskType: string;
+    complexity: number;
+    priority: Priority;
+    domain?: DomainName;
+    contextHash: string;
+}
+/**
+ * Q-Learning action (agent assignment)
+ */
+export interface QLearningAction {
+    agentType: AgentType;
+    domain: DomainName;
+}
+/**
+ * Q-Learning router for optimal agent selection
+ */
+export interface QLearningRouter {
+    /** Route a test task to optimal agent */
+    routeTask(task: TestTask): Promise<AgentRoutingResult>;
+    /** Batch route multiple tasks */
+    routeTasks(tasks: TestTask[]): Promise<AgentRoutingResult[]>;
+    /** Provide feedback for learning */
+    provideFeedback(taskId: string, result: {
+        success: boolean;
+        durationMs: number;
+        quality: number;
+    }): Promise<void>;
+    /** Get Q-value for state-action pair */
+    getQValue(state: QLearningState, action: QLearningAction): number;
+    /** Reset learning state */
+    reset(): Promise<void>;
+    /** Export learned model */
+    exportModel(): Promise<Record<string, unknown>>;
+    /** Import learned model */
+    importModel(model: Record<string, unknown>): Promise<void>;
+}
+/**
+ * Code complexity metrics
+ */
+export interface ComplexityMetrics {
+    /** Cyclomatic complexity */
+    cyclomatic: number;
+    /** Cognitive complexity */
+    cognitive: number;
+    /** Lines of code */
+    linesOfCode: number;
+    /** Number of dependencies */
+    dependencies: number;
+    /** Depth of inheritance */
+    inheritanceDepth: number;
+    /** Coupling score */
+    coupling: number;
+    /** Cohesion score */
+    cohesion: number;
+    /** Halstead difficulty */
+    halsteadDifficulty?: number;
+    /** Maintainability index */
+    maintainabilityIndex: number;
+}
+/**
+ * File complexity analysis result
+ */
+export interface FileComplexityResult {
+    filePath: string;
+    metrics: ComplexityMetrics;
+    /** Overall complexity score 0-1 (higher = more complex) */
+    overallScore: number;
+    /** Risk level based on complexity */
+    riskLevel: Severity;
+    /** Functions/methods with highest complexity */
+    hotspots: Array<{
+        name: string;
+        line: number;
+        complexity: number;
+        recommendation?: string;
+    }>;
+    /** Recommendations for reducing complexity */
+    recommendations: string[];
+    /** Analysis timestamp */
+    analyzedAt: Date;
+    /** Whether this used fallback logic */
+    usedFallback: boolean;
+}
+/**
+ * AST-based code complexity analyzer
+ */
+export interface ASTComplexityAnalyzer {
+    /** Analyze complexity of a single file */
+    analyzeFile(filePath: string): Promise<FileComplexityResult>;
+    /** Analyze complexity of multiple files */
+    analyzeFiles(filePaths: string[]): Promise<FileComplexityResult[]>;
+    /** Get complexity ranking for test prioritization */
+    getComplexityRanking(filePaths: string[]): Promise<Array<{
+        filePath: string;
+        score: number;
+        priority: Priority;
+    }>>;
+    /** Suggest test focus areas based on complexity */
+    suggestTestFocus(filePaths: string[]): Promise<Array<{
+        filePath: string;
+        functions: string[];
+        reason: string;
+    }>>;
+}
+/**
+ * File change information
+ */
+export interface FileChange {
+    filePath: string;
+    status: 'added' | 'modified' | 'deleted' | 'renamed';
+    additions: number;
+    deletions: number;
+    oldPath?: string;
+    hunks?: Array<{
+        startLine: number;
+        endLine: number;
+        content: string;
+    }>;
+}
+/**
+ * Diff context for risk analysis
+ */
+export interface DiffContext {
+    files: FileChange[];
+    commitHash?: string;
+    baseBranch?: string;
+    targetBranch?: string;
+    author?: string;
+    message?: string;
+}
+/**
+ * Risk classification for a change
+ */
+export interface RiskClassification {
+    /** Overall risk level */
+    level: Severity;
+    /** Risk score 0-1 */
+    score: number;
+    /** Risk factors identified */
+    factors: Array<{
+        name: string;
+        weight: number;
+        description: string;
+    }>;
+    /** Files requiring focused testing */
+    highRiskFiles: string[];
+    /** Recommended test types */
+    recommendedTests: Array<{
+        type: 'unit' | 'integration' | 'e2e' | 'security' | 'performance';
+        priority: Priority;
+        reason: string;
+    }>;
+    /** Whether this used fallback logic */
+    usedFallback: boolean;
+}
+/**
+ * Diff risk classifier for targeting tests at high-risk changes
+ */
+export interface DiffRiskClassifier {
+    /** Classify risk of a diff/changeset */
+    classifyDiff(context: DiffContext): Promise<RiskClassification>;
+    /** Get files sorted by risk */
+    rankFilesByRisk(files: FileChange[]): Promise<Array<{
+        filePath: string;
+        riskScore: number;
+        riskLevel: Severity;
+    }>>;
+    /** Check if change requires security review */
+    requiresSecurityReview(context: DiffContext): Promise<boolean>;
+    /** Get recommended reviewers based on risk */
+    getRecommendedReviewers(context: DiffContext): Promise<string[]>;
+    /** Predict potential defects in change */
+    predictDefects(context: DiffContext): Promise<Array<{
+        filePath: string;
+        probability: number;
+        type: string;
+        location?: {
+            line: number;
+            column: number;
+        };
+    }>>;
+}
+/**
+ * Coverage information for a file
+ */
+export interface FileCoverage {
+    filePath: string;
+    lineCoverage: number;
+    branchCoverage: number;
+    functionCoverage: number;
+    statementCoverage: number;
+    uncoveredLines: number[];
+    uncoveredBranches: Array<{
+        line: number;
+        branch: number;
+    }>;
+    uncoveredFunctions: string[];
+}
+/**
+ * Coverage gap analysis result
+ */
+export interface CoverageGap {
+    filePath: string;
+    gapType: 'line' | 'branch' | 'function' | 'integration';
+    severity: Severity;
+    lines?: number[];
+    functions?: string[];
+    recommendation: string;
+}
+/**
+ * Coverage-based routing result
+ */
+export interface CoverageRoutingResult {
+    /** Files needing more test coverage */
+    prioritizedFiles: Array<{
+        filePath: string;
+        currentCoverage: number;
+        targetCoverage: number;
+        gaps: CoverageGap[];
+        priority: Priority;
+    }>;
+    /** Suggested test generation targets */
+    testGenerationTargets: Array<{
+        filePath: string;
+        functions: string[];
+        reason: string;
+    }>;
+    /** Agent assignments for coverage improvement */
+    agentAssignments: Array<{
+        agentType: AgentType;
+        domain: DomainName;
+        files: string[];
+    }>;
+    /** Whether this used fallback logic */
+    usedFallback: boolean;
+}
+/**
+ * Coverage-aware router for test prioritization
+ */
+export interface CoverageRouter {
+    /** Analyze coverage and route agents */
+    analyzeCoverage(coverageData: FileCoverage[], targetCoverage?: number): Promise<CoverageRoutingResult>;
+    /** Get coverage gaps */
+    getCoverageGaps(coverageData: FileCoverage[]): Promise<CoverageGap[]>;
+    /** Prioritize files for coverage improvement */
+    prioritizeForCoverage(files: string[], coverageData: FileCoverage[]): Promise<string[]>;
+    /** Suggest tests to improve coverage */
+    suggestTestsForCoverage(filePath: string, coverage: FileCoverage): Promise<Array<{
+        testType: string;
+        target: string;
+        expectedCoverageGain: number;
+    }>>;
+}
+/**
+ * Module dependency information
+ */
+export interface ModuleDependency {
+    source: string;
+    target: string;
+    type: 'import' | 'export' | 'call' | 'reference';
+    weight: number;
+}
+/**
+ * Module boundary analysis
+ */
+export interface ModuleBoundary {
+    module: string;
+    files: string[];
+    publicAPIs: string[];
+    dependencies: ModuleDependency[];
+    /** Coupling score with other modules */
+    couplingScore: number;
+    /** Cohesion score within module */
+    cohesionScore: number;
+}
+/**
+ * Boundary crossing analysis
+ */
+export interface BoundaryCrossing {
+    fromModule: string;
+    toModule: string;
+    crossings: Array<{
+        sourceFile: string;
+        targetFile: string;
+        type: string;
+        line: number;
+    }>;
+    /** Risk score for this boundary */
+    riskScore: number;
+    /** Whether integration tests should cover this boundary */
+    requiresIntegrationTest: boolean;
+}
+/**
+ * Graph boundaries analysis result
+ */
+export interface GraphBoundariesResult {
+    modules: ModuleBoundary[];
+    boundaries: BoundaryCrossing[];
+    /** Critical boundaries needing tests */
+    criticalBoundaries: string[];
+    /** Suggested integration test locations */
+    integrationTestSuggestions: Array<{
+        fromModule: string;
+        toModule: string;
+        reason: string;
+        priority: Priority;
+    }>;
+    /** Architecture violations detected */
+    violations: Array<{
+        type: 'circular-dependency' | 'layer-violation' | 'coupling-too-high';
+        modules: string[];
+        severity: Severity;
+        suggestion: string;
+    }>;
+    /** Whether this used fallback logic */
+    usedFallback: boolean;
+}
+/**
+ * Graph boundaries analyzer for focusing integration tests
+ */
+export interface GraphBoundariesAnalyzer {
+    /** Analyze module boundaries in codebase */
+    analyzeBoundaries(entryPoints: string[]): Promise<GraphBoundariesResult>;
+    /** Get boundary crossings for specific modules */
+    getBoundaryCrossings(modules: string[]): Promise<BoundaryCrossing[]>;
+    /** Identify critical paths across modules */
+    getCriticalPaths(): Promise<Array<{
+        path: string[];
+        importance: number;
+        reason: string;
+    }>>;
+    /** Suggest integration test locations */
+    suggestIntegrationTests(): Promise<Array<{
+        location: string;
+        modules: string[];
+        priority: Priority;
+        reason: string;
+    }>>;
+    /** Detect architecture violations */
+    detectViolations(): Promise<Array<{
+        type: string;
+        location: string;
+        severity: Severity;
+        suggestion: string;
+    }>>;
+}
+/**
+ * RuVector error types
+ */
+export declare class RuVectorError extends Error {
+    readonly code: string;
+    readonly cause?: Error | undefined;
+    constructor(message: string, code: string, cause?: Error | undefined);
+}
+export declare class RuVectorUnavailableError extends RuVectorError {
+    constructor(message?: string, cause?: Error);
+}
+export declare class RuVectorTimeoutError extends RuVectorError {
+    constructor(message?: string, cause?: Error);
+}
+export declare class RuVectorConfigError extends RuVectorError {
+    constructor(message: string, cause?: Error);
+}
+//# sourceMappingURL=interfaces.d.ts.map

package/dist/integrations/ruvector/interfaces.d.ts.map

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

package/dist/integrations/ruvector/interfaces.js

@@ -0,0 +1,64 @@
+/**
+ * Agentic QE v3 - RuVector Integration Interfaces
+ *
+ * RuVector provides ML-based code intelligence for QE.
+ * This is an OPTIONAL dependency - all features work without it.
+ *
+ * Integration Points per ADR-017:
+ * | RuVector Feature      | QE Application                    |
+ * |----------------------|-----------------------------------|
+ * | Q-Learning Router    | Route test tasks to optimal agents|
+ * | AST Complexity       | Prioritize tests by code complexity|
+ * | Diff Risk Classification | Target tests at high-risk changes |
+ * | Coverage Routing     | Test coverage-aware agent selection|
+ * | Graph Boundaries     | Focus integration tests at module boundaries |
+ */
+/**
+ * Default RuVector configuration
+ */
+export const DEFAULT_RUVECTOR_CONFIG = {
+    enabled: false, // Disabled by default - OPTIONAL dependency
+    endpoint: 'http://localhost:8080',
+    databasePath: '.agentic-qe/ruvector-cache.db',
+    timeout: 5000,
+    cacheEnabled: true,
+    cacheTtl: 5 * 60 * 1000, // 5 minutes
+    fallbackEnabled: true,
+    retryAttempts: 3,
+    retryDelayMs: 1000,
+};
+// ============================================================================
+// Error Types
+// ============================================================================
+/**
+ * RuVector error types
+ */
+export class RuVectorError extends Error {
+    code;
+    cause;
+    constructor(message, code, cause) {
+        super(message);
+        this.code = code;
+        this.cause = cause;
+        this.name = 'RuVectorError';
+    }
+}
+export class RuVectorUnavailableError extends RuVectorError {
+    constructor(message = 'RuVector service is unavailable', cause) {
+        super(message, 'RUVECTOR_UNAVAILABLE', cause);
+        this.name = 'RuVectorUnavailableError';
+    }
+}
+export class RuVectorTimeoutError extends RuVectorError {
+    constructor(message = 'RuVector operation timed out', cause) {
+        super(message, 'RUVECTOR_TIMEOUT', cause);
+        this.name = 'RuVectorTimeoutError';
+    }
+}
+export class RuVectorConfigError extends RuVectorError {
+    constructor(message, cause) {
+        super(message, 'RUVECTOR_CONFIG_ERROR', cause);
+        this.name = 'RuVectorConfigError';
+    }
+}
+//# sourceMappingURL=interfaces.js.map

package/dist/integrations/ruvector/interfaces.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"interfaces.js","sourceRoot":"","sources":["../../../src/integrations/ruvector/interfaces.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAgCH;;GAEG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAA6B;IAC/D,OAAO,EAAE,KAAK,EAAE,4CAA4C;IAC5D,QAAQ,EAAE,uBAAuB;IACjC,YAAY,EAAE,+BAA+B;IAC7C,OAAO,EAAE,IAAI;IACb,YAAY,EAAE,IAAI;IAClB,QAAQ,EAAE,CAAC,GAAG,EAAE,GAAG,IAAI,EAAE,YAAY;IACrC,eAAe,EAAE,IAAI;IACrB,aAAa,EAAE,CAAC;IAChB,YAAY,EAAE,IAAI;CACnB,CAAC;AAggBF,+EAA+E;AAC/E,cAAc;AACd,+EAA+E;AAE/E;;GAEG;AACH,MAAM,OAAO,aAAc,SAAQ,KAAK;IAGpB;IACA;IAHlB,YACE,OAAe,EACC,IAAY,EACZ,KAAa;QAE7B,KAAK,CAAC,OAAO,CAAC,CAAC;QAHC,SAAI,GAAJ,IAAI,CAAQ;QACZ,UAAK,GAAL,KAAK,CAAQ;QAG7B,IAAI,CAAC,IAAI,GAAG,eAAe,CAAC;IAC9B,CAAC;CACF;AAED,MAAM,OAAO,wBAAyB,SAAQ,aAAa;IACzD,YAAY,UAAkB,iCAAiC,EAAE,KAAa;QAC5E,KAAK,CAAC,OAAO,EAAE,sBAAsB,EAAE,KAAK,CAAC,CAAC;QAC9C,IAAI,CAAC,IAAI,GAAG,0BAA0B,CAAC;IACzC,CAAC;CACF;AAED,MAAM,OAAO,oBAAqB,SAAQ,aAAa;IACrD,YAAY,UAAkB,8BAA8B,EAAE,KAAa;QACzE,KAAK,CAAC,OAAO,EAAE,kBAAkB,EAAE,KAAK,CAAC,CAAC;QAC1C,IAAI,CAAC,IAAI,GAAG,sBAAsB,CAAC;IACrC,CAAC;CACF;AAED,MAAM,OAAO,mBAAoB,SAAQ,aAAa;IACpD,YAAY,OAAe,EAAE,KAAa;QACxC,KAAK,CAAC,OAAO,EAAE,uBAAuB,EAAE,KAAK,CAAC,CAAC;QAC/C,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC;IACpC,CAAC;CACF"}