@agentic-qe/v3 3.0.0-alpha.3

package/src/shared/embeddings/types.ts

@@ -0,0 +1,147 @@
+/**
+ * Agentic QE v3 - Embedding Types
+ * Types for the embedding system using Nomic via Ollama
+ */
+
+/**
+ * Code chunk for embedding
+ */
+export interface CodeChunk {
+  id: string;
+  fileId: string;
+  content: string;
+  startLine: number;
+  endLine: number;
+  type: string;
+  name?: string;
+  language: string;
+  metadata?: Record<string, unknown>;
+}
+
+/**
+ * Result of embedding a single chunk
+ */
+export interface EmbeddingResult {
+  chunkId: string;
+  embedding: number[];
+  model: string;
+  cached: boolean;
+  computeTimeMs: number;
+}
+
+/**
+ * Result of batch embedding
+ */
+export interface EmbeddingBatchResult {
+  results: EmbeddingResult[];
+  stats: {
+    totalChunks: number;
+    cachedHits: number;
+    computedNew: number;
+    totalTimeMs: number;
+    avgTimePerChunk: number;
+  };
+}
+
+/**
+ * Ollama API embedding request
+ */
+export interface OllamaEmbeddingRequest {
+  model: string;
+  prompt: string;
+}
+
+/**
+ * Ollama API embedding response
+ */
+export interface OllamaEmbeddingResponse {
+  embedding: number[];
+}
+
+/**
+ * Ollama health/tags response
+ */
+export interface OllamaHealthResponse {
+  models?: Array<{
+    name: string;
+    model: string;
+    size: number;
+    digest: string;
+    details: {
+      format: string;
+      family: string;
+      families: string[] | null;
+      parameter_size: string;
+      quantization_level: string;
+    };
+  }>;
+}
+
+/**
+ * Cache statistics
+ */
+export interface CacheStats {
+  size: number;
+  hitRate: number;
+  hits: number;
+  misses: number;
+}
+
+/**
+ * Cache entry structure
+ */
+export interface EmbeddingCacheEntry {
+  embedding: number[];
+  timestamp: number;
+  model: string;
+}
+
+/**
+ * Batch progress tracking
+ */
+export interface BatchProgress {
+  current: number;
+  total: number;
+  percentage: number;
+  estimatedTimeRemainingMs?: number;
+}
+
+/**
+ * Progress callback type
+ */
+export type ProgressCallback = (progress: BatchProgress) => void;
+
+/**
+ * Embedding configuration constants
+ */
+export const EMBEDDING_CONFIG = {
+  /** Default model for embeddings */
+  MODEL: 'nomic-embed-text',
+  /** Embedding vector dimensions */
+  DIMENSIONS: 768,
+  /** Maximum context window in tokens */
+  CONTEXT_WINDOW: 8192,
+  /** Default batch size for processing */
+  BATCH_SIZE: 100,
+  /** Maximum retry attempts */
+  MAX_RETRIES: 3,
+  /** Delay between retries in ms */
+  RETRY_DELAY_MS: 1000,
+  /** Request timeout in ms */
+  TIMEOUT_MS: 30000,
+  /** Default Ollama URL */
+  DEFAULT_OLLAMA_URL: 'http://localhost:11434',
+} as const;
+
+/**
+ * Interface for embedding providers
+ * Provides a simple API for generating embeddings
+ */
+export interface IEmbeddingProvider {
+  /** Generate embedding for text */
+  embed(text: string): Promise<number[]>;
+  /** Check if provider is available */
+  healthCheck(): Promise<boolean>;
+  /** Get embedding dimensions */
+  getDimensions(): number;
+}

package/src/shared/entities/agent.ts

@@ -0,0 +1,141 @@
+/**
+ * Agentic QE v3 - Agent Entity
+ * Core agent entity used across all domains
+ */
+
+import { AggregateRoot, EntityProps } from './base-entity';
+import { AgentStatus, AgentType, DomainName } from '../types';
+
+export interface AgentProps extends EntityProps {
+  name: string;
+  domain: DomainName;
+  type: AgentType;
+  status: AgentStatus;
+  capabilities: string[];
+  config?: Record<string, unknown>;
+  metrics?: AgentMetrics;
+}
+
+export interface AgentMetrics {
+  tasksCompleted: number;
+  tasksSucceeded: number;
+  tasksFailed: number;
+  averageExecutionTime: number;
+  lastActiveAt?: Date;
+}
+
+export class Agent extends AggregateRoot<AgentProps> {
+  get name(): string {
+    return this.props.name;
+  }
+
+  get domain(): DomainName {
+    return this.props.domain;
+  }
+
+  get type(): AgentType {
+    return this.props.type;
+  }
+
+  get status(): AgentStatus {
+    return this.props.status;
+  }
+
+  get capabilities(): string[] {
+    return [...this.props.capabilities];
+  }
+
+  get config(): Record<string, unknown> {
+    return { ...this.props.config };
+  }
+
+  get metrics(): AgentMetrics {
+    return this.props.metrics ?? {
+      tasksCompleted: 0,
+      tasksSucceeded: 0,
+      tasksFailed: 0,
+      averageExecutionTime: 0,
+    };
+  }
+
+  get isAvailable(): boolean {
+    return this.props.status === 'idle';
+  }
+
+  get isRunning(): boolean {
+    return this.props.status === 'running';
+  }
+
+  start(): void {
+    if (this.props.status !== 'idle' && this.props.status !== 'queued') {
+      throw new Error(`Cannot start agent in status: ${this.props.status}`);
+    }
+    this.props.status = 'running';
+    this.touch();
+    this.addDomainEvent({
+      type: 'AgentStarted',
+      payload: { agentId: this.id, domain: this.domain },
+      timestamp: new Date(),
+    });
+  }
+
+  complete(): void {
+    if (this.props.status !== 'running') {
+      throw new Error(`Cannot complete agent not in running status`);
+    }
+    this.props.status = 'completed';
+    this.props.metrics = {
+      ...this.metrics,
+      tasksCompleted: this.metrics.tasksCompleted + 1,
+      tasksSucceeded: this.metrics.tasksSucceeded + 1,
+      lastActiveAt: new Date(),
+    };
+    this.touch();
+    this.addDomainEvent({
+      type: 'AgentCompleted',
+      payload: { agentId: this.id, domain: this.domain },
+      timestamp: new Date(),
+    });
+  }
+
+  fail(error: Error): void {
+    if (this.props.status !== 'running') {
+      throw new Error(`Cannot fail agent not in running status`);
+    }
+    this.props.status = 'failed';
+    this.props.metrics = {
+      ...this.metrics,
+      tasksCompleted: this.metrics.tasksCompleted + 1,
+      tasksFailed: this.metrics.tasksFailed + 1,
+      lastActiveAt: new Date(),
+    };
+    this.touch();
+    this.addDomainEvent({
+      type: 'AgentFailed',
+      payload: { agentId: this.id, domain: this.domain, error: error.message },
+      timestamp: new Date(),
+    });
+  }
+
+  reset(): void {
+    this.props.status = 'idle';
+    this.touch();
+  }
+
+  hasCapability(capability: string): boolean {
+    return this.props.capabilities.includes(capability);
+  }
+
+  static create(props: Omit<AgentProps, 'id' | 'createdAt' | 'updatedAt'>): Agent {
+    return new Agent({
+      ...props,
+      status: props.status ?? 'idle',
+      metrics: props.metrics ?? {
+        tasksCompleted: 0,
+        tasksSucceeded: 0,
+        tasksFailed: 0,
+        averageExecutionTime: 0,
+      },
+    });
+  }
+}

package/src/shared/entities/base-entity.ts

@@ -0,0 +1,79 @@
+/**
+ * Agentic QE v3 - Base Entity
+ * Foundation for all domain entities
+ */
+
+import { v4 as uuidv4 } from 'uuid';
+
+export interface EntityProps {
+  id?: string;
+  createdAt?: Date;
+  updatedAt?: Date;
+}
+
+export abstract class BaseEntity<T extends EntityProps> {
+  protected readonly _id: string;
+  protected readonly _createdAt: Date;
+  protected _updatedAt: Date;
+  protected props: T;
+
+  constructor(props: T) {
+    this._id = props.id ?? uuidv4();
+    this._createdAt = props.createdAt ?? new Date();
+    this._updatedAt = props.updatedAt ?? new Date();
+    this.props = props;
+  }
+
+  get id(): string {
+    return this._id;
+  }
+
+  get createdAt(): Date {
+    return this._createdAt;
+  }
+
+  get updatedAt(): Date {
+    return this._updatedAt;
+  }
+
+  protected touch(): void {
+    this._updatedAt = new Date();
+  }
+
+  equals(other: BaseEntity<T>): boolean {
+    if (other === null || other === undefined) {
+      return false;
+    }
+    if (this === other) {
+      return true;
+    }
+    return this._id === other._id;
+  }
+}
+
+/**
+ * Aggregate Root - Entry point to an aggregate
+ */
+export abstract class AggregateRoot<T extends EntityProps> extends BaseEntity<T> {
+  private _domainEvents: DomainEventRecord[] = [];
+
+  protected addDomainEvent(event: DomainEventRecord): void {
+    this._domainEvents.push(event);
+  }
+
+  public pullDomainEvents(): DomainEventRecord[] {
+    const events = [...this._domainEvents];
+    this._domainEvents = [];
+    return events;
+  }
+
+  public hasDomainEvents(): boolean {
+    return this._domainEvents.length > 0;
+  }
+}
+
+interface DomainEventRecord {
+  type: string;
+  payload: unknown;
+  timestamp: Date;
+}

package/src/shared/entities/index.ts

@@ -0,0 +1,6 @@
+/**
+ * Agentic QE v3 - Shared Entities
+ */
+
+export * from './base-entity';
+export * from './agent';

package/src/shared/events/domain-events.ts

@@ -0,0 +1,259 @@
+/**
+ * Agentic QE v3 - Domain Events
+ * Event definitions for cross-domain communication
+ */
+
+import { v4 as uuidv4 } from 'uuid';
+import { DomainEvent, DomainName, Severity } from '../types';
+
+// ============================================================================
+// Base Event Factory
+// ============================================================================
+
+export function createEvent<T>(
+  type: string,
+  source: DomainName,
+  payload: T,
+  correlationId?: string
+): DomainEvent<T> {
+  return {
+    id: uuidv4(),
+    type,
+    timestamp: new Date(),
+    source,
+    correlationId,
+    payload,
+  };
+}
+
+// ============================================================================
+// Test Generation Events
+// ============================================================================
+
+export interface TestGeneratedPayload {
+  testId: string;
+  testFile: string;
+  framework: string;
+  sourceFile: string;
+  testType: 'unit' | 'integration' | 'e2e' | 'property';
+}
+
+export interface TestSuiteCreatedPayload {
+  suiteId: string;
+  testCount: number;
+  sourceFiles: string[];
+  coverageEstimate: number;
+}
+
+export const TestGenerationEvents = {
+  TestGenerated: 'test-generation.TestGenerated',
+  TestSuiteCreated: 'test-generation.TestSuiteCreated',
+  PatternLearned: 'test-generation.PatternLearned',
+  GenerationFailed: 'test-generation.GenerationFailed',
+} as const;
+
+// ============================================================================
+// Test Execution Events
+// ============================================================================
+
+export interface TestRunStartedPayload {
+  runId: string;
+  testCount: number;
+  parallel: boolean;
+  workers: number;
+}
+
+export interface TestRunCompletedPayload {
+  runId: string;
+  passed: number;
+  failed: number;
+  skipped: number;
+  duration: number;
+}
+
+export interface FlakyTestDetectedPayload {
+  testId: string;
+  testFile: string;
+  failureRate: number;
+  pattern: string;
+}
+
+export const TestExecutionEvents = {
+  TestRunStarted: 'test-execution.TestRunStarted',
+  TestRunCompleted: 'test-execution.TestRunCompleted',
+  FlakyTestDetected: 'test-execution.FlakyTestDetected',
+  RetryTriggered: 'test-execution.RetryTriggered',
+} as const;
+
+// ============================================================================
+// Coverage Analysis Events
+// ============================================================================
+
+export interface CoverageReportPayload {
+  reportId: string;
+  line: number;
+  branch: number;
+  function: number;
+  statement: number;
+  files: number;
+}
+
+export interface CoverageGapPayload {
+  gapId: string;
+  file: string;
+  uncoveredLines: number[];
+  uncoveredBranches: number[];
+  riskScore: number;
+}
+
+export const CoverageAnalysisEvents = {
+  CoverageReportCreated: 'coverage-analysis.CoverageReportCreated',
+  CoverageGapDetected: 'coverage-analysis.CoverageGapDetected',
+  RiskZoneIdentified: 'coverage-analysis.RiskZoneIdentified',
+} as const;
+
+// ============================================================================
+// Quality Assessment Events
+// ============================================================================
+
+export interface QualityGatePayload {
+  gateId: string;
+  passed: boolean;
+  checks: Array<{
+    name: string;
+    passed: boolean;
+    value: number;
+    threshold: number;
+  }>;
+}
+
+export interface DeploymentDecisionPayload {
+  decision: 'approved' | 'blocked' | 'warning';
+  reason: string;
+  riskScore: number;
+  recommendations: string[];
+}
+
+export const QualityAssessmentEvents = {
+  QualityGateEvaluated: 'quality-assessment.QualityGateEvaluated',
+  DeploymentApproved: 'quality-assessment.DeploymentApproved',
+  DeploymentBlocked: 'quality-assessment.DeploymentBlocked',
+} as const;
+
+// ============================================================================
+// Defect Intelligence Events
+// ============================================================================
+
+export interface DefectPredictedPayload {
+  predictionId: string;
+  file: string;
+  probability: number;
+  factors: string[];
+  recommendations: string[];
+}
+
+export interface RootCausePayload {
+  analysisId: string;
+  defectId: string;
+  rootCause: string;
+  confidence: number;
+  relatedFiles: string[];
+}
+
+export const DefectIntelligenceEvents = {
+  DefectPredicted: 'defect-intelligence.DefectPredicted',
+  RootCauseIdentified: 'defect-intelligence.RootCauseIdentified',
+  RegressionRiskAnalyzed: 'defect-intelligence.RegressionRiskAnalyzed',
+} as const;
+
+// ============================================================================
+// Code Intelligence Events
+// ============================================================================
+
+export interface KnowledgeGraphUpdatedPayload {
+  nodes: number;
+  edges: number;
+  filesIndexed: number;
+  duration: number;
+}
+
+export interface ImpactAnalysisPayload {
+  analysisId: string;
+  changedFiles: string[];
+  impactedFiles: string[];
+  impactedTests: string[];
+  riskLevel: Severity;
+}
+
+export const CodeIntelligenceEvents = {
+  KnowledgeGraphUpdated: 'code-intelligence.KnowledgeGraphUpdated',
+  ImpactAnalysisCompleted: 'code-intelligence.ImpactAnalysisCompleted',
+  SemanticSearchCompleted: 'code-intelligence.SemanticSearchCompleted',
+} as const;
+
+// ============================================================================
+// Security Compliance Events
+// ============================================================================
+
+export interface VulnerabilityPayload {
+  vulnId: string;
+  cve?: string;
+  severity: Severity;
+  file: string;
+  line?: number;
+  description: string;
+  remediation: string;
+}
+
+export interface CompliancePayload {
+  standard: string;
+  passed: boolean;
+  violations: number;
+  findings: string[];
+}
+
+export const SecurityComplianceEvents = {
+  VulnerabilityDetected: 'security-compliance.VulnerabilityDetected',
+  ComplianceValidated: 'security-compliance.ComplianceValidated',
+  SecurityAuditCompleted: 'security-compliance.SecurityAuditCompleted',
+} as const;
+
+// ============================================================================
+// Learning Optimization Events
+// ============================================================================
+
+export interface PatternConsolidatedPayload {
+  patternCount: number;
+  domains: DomainName[];
+  improvements: number;
+}
+
+export interface TransferCompletedPayload {
+  sourceProject: string;
+  targetProject: string;
+  patternsTransferred: number;
+  successRate: number;
+}
+
+export const LearningOptimizationEvents = {
+  PatternConsolidated: 'learning-optimization.PatternConsolidated',
+  TransferCompleted: 'learning-optimization.TransferCompleted',
+  OptimizationApplied: 'learning-optimization.OptimizationApplied',
+} as const;
+
+// ============================================================================
+// All Events Map
+// ============================================================================
+
+export const AllDomainEvents = {
+  ...TestGenerationEvents,
+  ...TestExecutionEvents,
+  ...CoverageAnalysisEvents,
+  ...QualityAssessmentEvents,
+  ...DefectIntelligenceEvents,
+  ...CodeIntelligenceEvents,
+  ...SecurityComplianceEvents,
+  ...LearningOptimizationEvents,
+} as const;
+
+export type DomainEventType = (typeof AllDomainEvents)[keyof typeof AllDomainEvents];

package/src/shared/events/index.ts

@@ -0,0 +1,5 @@
+/**
+ * Agentic QE v3 - Events Export
+ */
+
+export * from './domain-events';