agentic-qe 1.0.0

package/config/fleet.yaml

@@ -0,0 +1,50 @@
+# Agentic QE Fleet Configuration
+
+fleet:
+  id: "agentic-qe-fleet"
+  name: "Autonomous Quality Engineering Fleet"
+  maxAgents: 20
+  heartbeatInterval: 30000  # 30 seconds
+  taskTimeout: 600000       # 10 minutes
+
+agents:
+  - type: "test-executor"
+    count: 3
+    config:
+      frameworks: ["jest", "cypress", "playwright"]
+      maxParallelTests: 4
+      timeout: 300000
+      reportFormat: "json"
+
+  - type: "quality-analyzer"
+    count: 2
+    config:
+      tools: ["eslint", "sonarqube", "codecov"]
+      thresholds:
+        coverage: 80
+        complexity: 10
+        maintainability: 70
+        security: 90
+      reportFormat: "json"
+
+database:
+  type: "sqlite"
+  filename: "./data/fleet.db"
+
+logging:
+  level: "info"
+  format: "json"
+  outputs: ["console", "file"]
+
+api:
+  port: 3000
+  host: "0.0.0.0"
+  cors: true
+  rateLimit:
+    windowMs: 900000  # 15 minutes
+    max: 100
+
+security:
+  encryption:
+    algorithm: "aes-256-gcm"
+    keyLength: 32

package/dist/agents/ApiContractValidatorAgent.d.ts

@@ -0,0 +1,222 @@
+/**
+ * ApiContractValidatorAgent - P1 agent for API contract validation
+ * Prevents breaking changes and ensures backward compatibility
+ *
+ * Key Capabilities:
+ * - OpenAPI 3.0 / Swagger validation
+ * - GraphQL schema validation
+ * - Breaking change detection
+ * - Consumer impact analysis
+ * - Semantic versioning compliance
+ * - Contract diffing and migration guides
+ *
+ * Memory Keys: aqe/api-contract/*
+ * Events: api.contract.validated, api.breaking.change.detected
+ * ROI: 350% (prevents 15-20% of production incidents)
+ */
+import { BaseAgent, BaseAgentConfig } from './BaseAgent';
+import { QETask, ApiContractValidatorConfig } from '../types';
+interface ValidationResult {
+    valid: boolean;
+    errors: ValidationError[];
+    warnings?: ValidationWarning[];
+}
+interface ValidationError {
+    type: string;
+    message: string;
+    path?: string;
+    param?: string;
+    field?: string;
+    status?: number;
+    severity?: 'CRITICAL' | 'HIGH' | 'MEDIUM' | 'LOW';
+    params?: any;
+}
+interface ValidationWarning {
+    type: string;
+    message: string;
+}
+interface BreakingChange {
+    type: string;
+    severity: 'CRITICAL' | 'HIGH' | 'MEDIUM' | 'LOW';
+    message: string;
+    endpoint?: string;
+    method?: string;
+    param?: string;
+    field?: string;
+    status?: number;
+    oldType?: string;
+    newType?: string;
+    location?: string;
+}
+interface NonBreakingChange {
+    type: string;
+    message: string;
+    endpoint?: string;
+    param?: string;
+    field?: string;
+    status?: number;
+    location?: string;
+}
+interface ChangeDetectionResult {
+    breaking: BreakingChange[];
+    nonBreaking: NonBreakingChange[];
+    hasBreakingChanges: boolean;
+    summary: ChangeSummary;
+}
+interface ChangeSummary {
+    totalBreaking: number;
+    totalNonBreaking: number;
+    recommendation: string;
+    suggestedVersion?: string;
+    estimatedMigrationTime?: string;
+    affectedConsumers?: number;
+}
+interface VersionValidationResult {
+    valid: boolean;
+    currentVersion: string;
+    proposedVersion: string;
+    requiredBump: 'MAJOR' | 'MINOR' | 'PATCH';
+    actualBump: 'MAJOR' | 'MINOR' | 'PATCH';
+    recommendation: string;
+    violations: VersionViolation[];
+}
+interface VersionViolation {
+    severity: 'CRITICAL' | 'HIGH' | 'MEDIUM';
+    message: string;
+    expected: string;
+    actual: string;
+}
+interface ConsumerImpactAnalysis {
+    totalAffectedConsumers: number;
+    impacts: ConsumerImpact[];
+    coordinationRequired: boolean;
+    estimatedTotalMigrationTime: string;
+}
+interface ConsumerImpact {
+    consumer: string;
+    team: string;
+    contact: string;
+    affectedEndpoints: AffectedEndpoint[];
+    totalRequests: number;
+    estimatedMigrationTime: string;
+    priority: 'CRITICAL' | 'HIGH' | 'MEDIUM' | 'LOW';
+}
+interface AffectedEndpoint {
+    endpoint: string;
+    method: string;
+    requestsPerDay: number;
+    changes: BreakingChange[];
+    migrationEffort: 'HIGH' | 'MEDIUM' | 'LOW';
+}
+interface Consumer {
+    name: string;
+    team: string;
+    contact: string;
+    apiUsage: ApiUsage[];
+}
+interface ApiUsage {
+    endpoint: string;
+    method: string;
+    requestsPerDay: number;
+}
+export interface ApiContractValidatorAgentConfig extends BaseAgentConfig {
+    validatorConfig: ApiContractValidatorConfig;
+}
+export declare class ApiContractValidatorAgent extends BaseAgent {
+    private readonly config;
+    private ajv;
+    constructor(config: ApiContractValidatorAgentConfig);
+    protected initializeComponents(): Promise<void>;
+    protected loadKnowledge(): Promise<void>;
+    protected cleanup(): Promise<void>;
+    protected performTask(task: QETask): Promise<any>;
+    /**
+     * Validate an API contract (OpenAPI, GraphQL, etc.)
+     */
+    validateContract(params: {
+        schema: any;
+        format: 'openapi' | 'swagger' | 'graphql';
+    }): Promise<ValidationResult>;
+    /**
+     * Detect breaking changes between two schema versions
+     */
+    detectBreakingChanges(params: {
+        baseline: any;
+        candidate: any;
+        format?: 'openapi' | 'graphql';
+    }): Promise<ChangeDetectionResult>;
+    /**
+     * Validate request/response against schema
+     */
+    validateRequestResponse(params: {
+        request: any;
+        response: any;
+        schema: any;
+        endpoint: string;
+        method: string;
+    }): Promise<ValidationResult>;
+    /**
+     * Validate semantic version bump
+     */
+    validateVersionBump(params: {
+        currentVersion: string;
+        proposedVersion: string;
+        changes: ChangeDetectionResult | {
+            breaking: any[];
+            nonBreaking: any[];
+        };
+    }): Promise<VersionValidationResult>;
+    /**
+     * Analyze consumer impact of API changes
+     */
+    analyzeConsumerImpact(params: {
+        changes: {
+            breaking: BreakingChange[];
+            nonBreaking: NonBreakingChange[];
+        };
+        consumers: Consumer[];
+    }): Promise<ConsumerImpactAnalysis>;
+    /**
+     * Generate contract diff report
+     */
+    generateDiff(params: {
+        baseline: any;
+        candidate: any;
+        format?: 'markdown' | 'json' | 'html';
+    }): Promise<string>;
+    /**
+     * Generate migration guide
+     */
+    generateMigrationGuide(params: {
+        fromVersion: string;
+        toVersion: string;
+        changes: {
+            breaking: BreakingChange[];
+            nonBreaking: NonBreakingChange[];
+        };
+    }): Promise<string>;
+    private validateOpenAPISchema;
+    private validateGraphQLSchema;
+    private validateRequest;
+    private validateResponse;
+    private validateAgainstJSONSchema;
+    private detectOpenAPIBreakingChanges;
+    private detectGraphQLBreakingChanges;
+    private compareParameters;
+    private compareResponses;
+    private compareResponseSchemas;
+    private parseVersion;
+    private getActualBump;
+    private calculateRequiredVersionBump;
+    private generateSummary;
+    private generateMarkdownDiff;
+    private normalizeEndpoint;
+    private estimateMigrationEffort;
+    private calculateMigrationTime;
+    private calculatePriority;
+    private priorityScore;
+    private sumMigrationTimes;
+    private calculateMaxSeverity;
+}
+export {};
+//# sourceMappingURL=ApiContractValidatorAgent.d.ts.map

package/dist/agents/ApiContractValidatorAgent.d.ts.map

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