@agentic-qe/v3 3.0.0-alpha.6 → 3.0.0-alpha.8

package/src/feedback/types.ts

@@ -1,497 +0,0 @@
-/**
- * Quality Feedback Loop Types
- * ADR-023: Quality Feedback Loop System
- *
- * Types for tracking test outcomes, coverage improvements, and pattern quality.
- */
-
-import type { QEDomain } from '../learning/qe-patterns.js';
-import type { TestFramework, ProgrammingLanguage } from '../routing/types.js';
-
-// ============================================================================
-// Test Outcome Types
-// ============================================================================
-
-/**
- * Coverage metrics from a test run
- */
-export interface CoverageMetrics {
-  /** Line coverage percentage (0-100) */
-  lines: number;
-  /** Branch coverage percentage (0-100) */
-  branches: number;
-  /** Function coverage percentage (0-100) */
-  functions: number;
-  /** Statement coverage percentage (0-100) */
-  statements?: number;
-}
-
-/**
- * Test outcome from a generated test
- */
-export interface TestOutcome {
-  /** Unique test outcome ID */
-  readonly id: string;
-
-  /** Test identifier */
-  readonly testId: string;
-
-  /** Test name/description */
-  readonly testName: string;
-
-  /** Agent that generated the test */
-  readonly generatedBy: string;
-
-  /** Pattern ID used for generation (if any) */
-  readonly patternId?: string;
-
-  /** Test framework used */
-  readonly framework: TestFramework;
-
-  /** Programming language */
-  readonly language: ProgrammingLanguage;
-
-  /** QE domain */
-  readonly domain: QEDomain;
-
-  /** Test result */
-  readonly passed: boolean;
-
-  /** Error message if failed */
-  readonly errorMessage?: string;
-
-  /** Coverage metrics achieved */
-  readonly coverage: CoverageMetrics;
-
-  /** Mutation score (0-1) if mutation testing was run */
-  readonly mutationScore?: number;
-
-  /** Execution time in ms */
-  readonly executionTimeMs: number;
-
-  /** Whether test exhibited flaky behavior */
-  readonly flaky: boolean;
-
-  /** Flakiness score (0-1, higher = more flaky) */
-  readonly flakinessScore?: number;
-
-  /** Maintainability score (0-1) */
-  readonly maintainabilityScore: number;
-
-  /** Code complexity of generated test */
-  readonly complexity?: number;
-
-  /** Lines of test code */
-  readonly linesOfCode?: number;
-
-  /** Number of assertions */
-  readonly assertionCount?: number;
-
-  /** File path of the test */
-  readonly filePath?: string;
-
-  /** Source file being tested */
-  readonly sourceFilePath?: string;
-
-  /** Timestamp */
-  readonly timestamp: Date;
-
-  /** Additional metadata */
-  readonly metadata?: Record<string, unknown>;
-}
-
-/**
- * Aggregated test outcome statistics
- */
-export interface TestOutcomeStats {
-  /** Total tests tracked */
-  totalTests: number;
-
-  /** Tests that passed */
-  passedTests: number;
-
-  /** Pass rate (0-1) */
-  passRate: number;
-
-  /** Average coverage */
-  avgCoverage: CoverageMetrics;
-
-  /** Average mutation score */
-  avgMutationScore: number;
-
-  /** Average execution time */
-  avgExecutionTimeMs: number;
-
-  /** Flaky test count */
-  flakyTests: number;
-
-  /** Average maintainability */
-  avgMaintainability: number;
-
-  /** Stats by agent */
-  byAgent: Map<string, {
-    total: number;
-    passed: number;
-    avgCoverage: number;
-    avgMaintainability: number;
-  }>;
-
-  /** Stats by domain */
-  byDomain: Map<QEDomain, {
-    total: number;
-    passed: number;
-    avgCoverage: number;
-  }>;
-}
-
-// ============================================================================
-// Coverage Session Types
-// ============================================================================
-
-/**
- * Coverage improvement session
- */
-export interface CoverageSession {
-  /** Session ID */
-  readonly id: string;
-
-  /** Target file/module being improved */
-  readonly targetPath: string;
-
-  /** Agent that performed the analysis */
-  readonly agentId: string;
-
-  /** Technique used for coverage improvement */
-  readonly technique: CoverageTechnique;
-
-  /** Coverage before the session */
-  readonly beforeCoverage: CoverageMetrics;
-
-  /** Coverage after the session */
-  readonly afterCoverage: CoverageMetrics;
-
-  /** Tests generated during session */
-  readonly testsGenerated: number;
-
-  /** Tests that passed */
-  readonly testsPassed: number;
-
-  /** Gap areas targeted */
-  readonly gapsTargeted: CoverageGap[];
-
-  /** Duration of session in ms */
-  readonly durationMs: number;
-
-  /** Session start time */
-  readonly startedAt: Date;
-
-  /** Session end time */
-  readonly completedAt: Date;
-
-  /** Additional context */
-  readonly context?: Record<string, unknown>;
-}
-
-/**
- * Coverage improvement technique
- */
-export type CoverageTechnique =
-  | 'gap-analysis'
-  | 'branch-coverage'
-  | 'edge-case-generation'
-  | 'mutation-guided'
-  | 'risk-based'
-  | 'semantic-analysis'
-  | 'boundary-testing'
-  | 'state-machine'
-  | 'data-flow';
-
-/**
- * Coverage gap information
- */
-export interface CoverageGap {
-  /** Gap identifier */
-  id: string;
-
-  /** Type of gap */
-  type: 'uncovered-line' | 'uncovered-branch' | 'uncovered-function' | 'partial-branch';
-
-  /** File path */
-  filePath: string;
-
-  /** Start line number */
-  startLine: number;
-
-  /** End line number */
-  endLine?: number;
-
-  /** Risk score (0-1) */
-  riskScore: number;
-
-  /** Was the gap addressed? */
-  addressed: boolean;
-
-  /** Test IDs that addressed this gap */
-  addressedBy?: string[];
-}
-
-/**
- * Coverage strategy learned from successful sessions
- */
-export interface CoverageStrategy {
-  /** Strategy ID */
-  readonly id: string;
-
-  /** Strategy description */
-  readonly description: string;
-
-  /** Technique used */
-  readonly technique: CoverageTechnique;
-
-  /** File patterns this works well for */
-  readonly filePatterns: string[];
-
-  /** Average improvement achieved */
-  readonly avgImprovement: number;
-
-  /** Number of times used successfully */
-  readonly successCount: number;
-
-  /** Confidence in strategy (0-1) */
-  readonly confidence: number;
-
-  /** Created timestamp */
-  readonly createdAt: Date;
-
-  /** Last used timestamp */
-  readonly lastUsedAt: Date;
-}
-
-// ============================================================================
-// Quality Score Types
-// ============================================================================
-
-/**
- * Quality dimensions for scoring
- */
-export interface QualityDimensions {
-  /** Test effectiveness (0-1) */
-  effectiveness: number;
-
-  /** Code coverage achieved (0-1) */
-  coverage: number;
-
-  /** Mutation score (0-1) */
-  mutationKill: number;
-
-  /** Test stability (0-1, inverse of flakiness) */
-  stability: number;
-
-  /** Maintainability (0-1) */
-  maintainability: number;
-
-  /** Performance (0-1, based on execution time) */
-  performance: number;
-}
-
-/**
- * Quality score with breakdown
- */
-export interface QualityScore {
-  /** Overall quality score (0-1) */
-  overall: number;
-
-  /** Dimension scores */
-  dimensions: QualityDimensions;
-
-  /** Weights used for calculation */
-  weights: QualityWeights;
-
-  /** Trend compared to previous */
-  trend: 'improving' | 'stable' | 'declining';
-
-  /** Calculated timestamp */
-  calculatedAt: Date;
-}
-
-/**
- * Weights for quality dimensions
- */
-export interface QualityWeights {
-  effectiveness: number;
-  coverage: number;
-  mutationKill: number;
-  stability: number;
-  maintainability: number;
-  performance: number;
-}
-
-/**
- * Default quality weights
- */
-export const DEFAULT_QUALITY_WEIGHTS: QualityWeights = {
-  effectiveness: 0.25,   // Test pass/fail
-  coverage: 0.20,        // Code coverage
-  mutationKill: 0.15,    // Mutation testing
-  stability: 0.15,       // Non-flaky
-  maintainability: 0.15, // Clean code
-  performance: 0.10,     // Fast execution
-};
-
-// ============================================================================
-// Pattern Promotion Types
-// ============================================================================
-
-/**
- * Pattern promotion tier
- */
-export type PatternTier = 'short-term' | 'working' | 'long-term' | 'permanent';
-
-/**
- * Pattern promotion criteria
- */
-export interface PromotionCriteria {
-  /** Minimum successful uses for promotion */
-  minSuccessCount: number;
-
-  /** Minimum success rate (0-1) */
-  minSuccessRate: number;
-
-  /** Minimum quality score (0-1) */
-  minQualityScore: number;
-
-  /** Minimum age in days */
-  minAgeDays: number;
-}
-
-/**
- * Default promotion criteria by tier
- */
-export const DEFAULT_PROMOTION_CRITERIA: Record<PatternTier, PromotionCriteria> = {
-  'short-term': {
-    minSuccessCount: 0,
-    minSuccessRate: 0,
-    minQualityScore: 0,
-    minAgeDays: 0,
-  },
-  'working': {
-    minSuccessCount: 3,
-    minSuccessRate: 0.6,
-    minQualityScore: 0.5,
-    minAgeDays: 1,
-  },
-  'long-term': {
-    minSuccessCount: 10,
-    minSuccessRate: 0.75,
-    minQualityScore: 0.7,
-    minAgeDays: 7,
-  },
-  'permanent': {
-    minSuccessCount: 50,
-    minSuccessRate: 0.9,
-    minQualityScore: 0.85,
-    minAgeDays: 30,
-  },
-};
-
-/**
- * Pattern promotion event
- */
-export interface PatternPromotionEvent {
-  /** Pattern ID */
-  patternId: string;
-
-  /** Previous tier */
-  fromTier: PatternTier;
-
-  /** New tier */
-  toTier: PatternTier;
-
-  /** Reason for promotion */
-  reason: string;
-
-  /** Metrics at time of promotion */
-  metrics: {
-    successCount: number;
-    successRate: number;
-    qualityScore: number;
-    ageDays: number;
-  };
-
-  /** Timestamp */
-  timestamp: Date;
-}
-
-/**
- * Pattern demotion event (for patterns that decline)
- */
-export interface PatternDemotionEvent {
-  /** Pattern ID */
-  patternId: string;
-
-  /** Previous tier */
-  fromTier: PatternTier;
-
-  /** New tier */
-  toTier: PatternTier;
-
-  /** Reason for demotion */
-  reason: string;
-
-  /** Metrics at time of demotion */
-  metrics: {
-    recentSuccessRate: number;
-    recentQualityScore: number;
-    failureCount: number;
-  };
-
-  /** Timestamp */
-  timestamp: Date;
-}
-
-// ============================================================================
-// Feedback Configuration
-// ============================================================================
-
-/**
- * Feedback loop configuration
- */
-export interface FeedbackConfig {
-  /** Quality score weights */
-  qualityWeights: QualityWeights;
-
-  /** Promotion criteria by tier */
-  promotionCriteria: Record<PatternTier, PromotionCriteria>;
-
-  /** Enable automatic pattern promotion */
-  autoPromote: boolean;
-
-  /** Enable automatic pattern demotion */
-  autoDemote: boolean;
-
-  /** Minimum coverage improvement to learn strategy (percentage points) */
-  minCoverageImprovementToLearn: number;
-
-  /** Maximum outcomes to store in memory */
-  maxOutcomesInMemory: number;
-
-  /** Persist outcomes to database */
-  persistOutcomes: boolean;
-
-  /** Batch size for processing */
-  batchSize: number;
-}
-
-/**
- * Default feedback configuration
- */
-export const DEFAULT_FEEDBACK_CONFIG: FeedbackConfig = {
-  qualityWeights: DEFAULT_QUALITY_WEIGHTS,
-  promotionCriteria: DEFAULT_PROMOTION_CRITERIA,
-  autoPromote: true,
-  autoDemote: true,
-  minCoverageImprovementToLearn: 5,
-  maxOutcomesInMemory: 10000,
-  persistOutcomes: true,
-  batchSize: 100,
-};

package/src/index.ts

@@ -1,224 +0,0 @@
-/**
- * Agentic QE v3 - Main Entry Point
- * Domain-Driven Design Architecture with 12 Bounded Contexts
- */
-
-// Shared Kernel - export types and utilities
-export * from './shared/types';
-export * from './shared/value-objects';
-export * from './shared/events';
-
-// Entities - export as namespace to avoid collisions
-export * as Entities from './shared/entities';
-
-// Kernel - export core kernel components
-// Note: HNSWConfig is also in init, but kernel's is the primary
-export * from './kernel';
-
-// Coordination Layer - export coordination components
-export * from './coordination';
-
-// Domain Interfaces - export as namespaces
-export * from './domains';
-
-// MCP Server - Model Context Protocol integration
-// Export only what's available from mcp module
-export {
-  MCPServer,
-  createMCPServer,
-  ToolRegistry,
-  createToolRegistry,
-} from './mcp';
-
-// Learning Module - QE ReasoningBank for pattern learning (ADR-021)
-// Exclude types that conflict with routing (ComplexityLevel, ProgrammingLanguage, TestFramework)
-export {
-  createQEReasoningBank,
-  QEReasoningBank,
-  RealQEReasoningBank,
-  createRealQEReasoningBank,
-  detectQEDomain,
-  detectQEDomains,
-  mapQEDomainToAQE,
-  QE_DOMAIN_LIST,
-  QE_DOMAINS,
-} from './learning';
-export type {
-  QEPattern,
-  QEPatternType,
-  QEPatternTemplate,
-  QEPatternContext,
-  QEDomain,
-  CreateQEPatternOptions,
-  LearningOutcome,
-  PatternSearchOptions,
-  PatternSearchResult,
-  QERoutingRequest,
-  QERoutingResult,
-} from './learning';
-
-// Feedback Module - Quality Feedback Loop (ADR-023)
-// Exclude types that conflict with shared/types (CoverageMetrics, QualityScore)
-export {
-  createTestOutcomeTracker,
-  createCoverageLearner,
-  createQualityScoreCalculator,
-  createPatternPromotionManager,
-  createQualityFeedbackLoop,
-  QualityFeedbackLoop,
-  TestOutcomeTracker,
-  CoverageLearner,
-  QualityScoreCalculator,
-  PatternPromotionManager,
-  DEFAULT_FEEDBACK_CONFIG,
-  DEFAULT_QUALITY_WEIGHTS,
-  DEFAULT_PROMOTION_CRITERIA,
-} from './feedback';
-export type {
-  TestOutcome,
-  CoverageSession,
-  CoverageStrategy,
-  CoverageTechnique,
-  FeedbackConfig,
-  PatternTier,
-  CoverageGap as FeedbackCoverageGap,
-  QualityDimensions,
-  QualityWeights,
-  PromotionCriteria,
-  PatternPromotionEvent,
-  PatternDemotionEvent,
-} from './feedback';
-
-// Routing Module - QE Router for agent selection (ADR-022)
-export * from './routing';
-
-// Optimization Module - Self-Optimization Engine (ADR-024)
-export * from './optimization';
-
-// Init Module - Enhanced Init with Self-Configuration (ADR-025)
-// Exclude HNSWConfig (use kernel's), ALL_DOMAINS (use shared/types'), CoverageMetrics (use shared/types')
-export {
-  createDefaultConfig,
-  createProjectAnalyzer,
-  createSelfConfigurator,
-  createInitOrchestrator,
-  quickInit,
-  formatInitResult,
-  ProjectAnalyzer,
-  SelfConfigurator,
-  InitOrchestrator,
-  DEFAULT_LEARNING_CONFIG,
-  DEFAULT_ROUTING_CONFIG,
-  DEFAULT_WORKERS_CONFIG,
-  DEFAULT_HOOKS_CONFIG,
-  DEFAULT_AUTO_TUNING_CONFIG,
-} from './init';
-export type {
-  ProjectAnalysis,
-  DetectedFramework,
-  DetectedLanguage,
-  ExistingTests,
-  CodeComplexity,
-  AQEInitConfig,
-  LearningConfig,
-  RoutingConfig as InitRoutingConfig,
-  WorkersConfig,
-  HooksConfig,
-  AutoTuningConfig,
-  InitResult,
-  InitStepResult,
-  WizardStep,
-  WizardOption,
-  WizardState,
-  PretrainedPattern,
-  PretrainedLibrary,
-  InitOrchestratorOptions,
-} from './init';
-
-// Strange Loop Self-Awareness Module (ADR-031)
-export {
-  // Observer
-  SwarmObserver,
-  createSwarmObserver,
-  createInMemorySwarmObserver,
-  InMemoryAgentProvider,
-  // Topology Analyzer
-  TopologyAnalyzer,
-  createTopologyAnalyzer,
-  // Self-Model
-  SwarmSelfModel,
-  createSwarmSelfModel,
-  // Self-Healing Controller
-  SelfHealingController,
-  createSelfHealingController,
-  NoOpActionExecutor,
-  // Strange Loop Orchestrator
-  StrangeLoopOrchestrator,
-  createStrangeLoopOrchestrator,
-  createInMemoryStrangeLoop,
-  // Config
-  DEFAULT_STRANGE_LOOP_CONFIG,
-} from './strange-loop';
-export type {
-  // Topology types
-  TopologyType,
-  AgentNode,
-  CommunicationEdge,
-  SwarmTopology,
-  // Health metrics
-  AgentHealthMetrics as StrangeLoopAgentHealthMetrics,
-  ConnectivityMetrics,
-  SwarmVulnerability,
-  // Observation
-  SwarmHealthObservation,
-  // Self-modeling
-  TrendDirection,
-  TrendAnalysis,
-  BottleneckInfo,
-  BottleneckAnalysis,
-  PredictedVulnerability,
-  SwarmModelDelta,
-  // Self-healing
-  SelfHealingActionType,
-  ActionPriority,
-  SelfHealingAction,
-  ActionResult,
-  ExecutedAction,
-  // Self-diagnosis
-  SelfDiagnosis,
-  // Config and stats
-  StrangeLoopConfig,
-  StrangeLoopStats,
-  // Events
-  StrangeLoopEventType,
-  StrangeLoopEvent,
-  StrangeLoopEventListener,
-  // Interfaces
-  AgentProvider,
-  ActionExecutor,
-} from './strange-loop';
-
-// Version info
-export const VERSION = '3.0.0-alpha';
-export const ARCHITECTURE = 'DDD with 12 Bounded Contexts';
-export const MAX_CONCURRENT_AGENTS = 15;
-
-/**
- * Quick start example:
- *
- * ```typescript
- * import { createKernel } from '@agentic-qe/v3';
- *
- * const kernel = createKernel({
- *   maxConcurrentAgents: 15,
- *   memoryBackend: 'hybrid',
- *   hnswEnabled: true,
- * });
- *
- * await kernel.initialize();
- *
- * // Use domain APIs
- * const testGen = kernel.getDomainAPI<TestGenerationAPI>('test-generation');
- * const result = await testGen.generateTests({ ... });
- * ```
- */