agentic-qe 1.8.3 → 1.9.0

package/dist/telemetry/metrics/quality-metrics.js

@@ -0,0 +1,259 @@
+"use strict";
+/**
+ * Quality Engineering Metrics for Agentic QE Fleet
+ *
+ * Metrics for tracking test quality, coverage, defects, and quality gates.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createQualityMetrics = createQualityMetrics;
+exports.getQualityMetrics = getQualityMetrics;
+exports.recordTestExecution = recordTestExecution;
+exports.recordCoverage = recordCoverage;
+exports.recordQualityGate = recordQualityGate;
+exports.recordSecurityScan = recordSecurityScan;
+exports.recordFlakyTest = recordFlakyTest;
+exports.recordDefectDensity = recordDefectDensity;
+exports.createApiContractMetrics = createApiContractMetrics;
+const bootstrap_1 = require("../bootstrap");
+const types_1 = require("../types");
+// Singleton metrics instance
+let qualityMetrics = null;
+/**
+ * Initialize quality metrics
+ *
+ * @param meter - OpenTelemetry Meter instance
+ * @returns Quality metrics registry
+ */
+function createQualityMetrics(meter) {
+    if (qualityMetrics) {
+        return qualityMetrics;
+    }
+    const m = meter || (0, bootstrap_1.getMeter)();
+    qualityMetrics = {
+        testCount: m.createCounter(types_1.METRIC_NAMES.TEST_COUNT, {
+            description: 'Total number of tests executed',
+            unit: 'tests',
+        }),
+        testPassCount: m.createCounter(`${types_1.METRIC_NAMES.TEST_COUNT}.pass`, {
+            description: 'Number of passed tests',
+            unit: 'tests',
+        }),
+        testFailCount: m.createCounter(`${types_1.METRIC_NAMES.TEST_COUNT}.fail`, {
+            description: 'Number of failed tests',
+            unit: 'tests',
+        }),
+        testSkipCount: m.createCounter(`${types_1.METRIC_NAMES.TEST_COUNT}.skip`, {
+            description: 'Number of skipped tests',
+            unit: 'tests',
+        }),
+        testDuration: m.createHistogram(types_1.METRIC_NAMES.TEST_DURATION, {
+            description: 'Test execution duration',
+            unit: 'ms',
+            advice: {
+                explicitBucketBoundaries: types_1.HISTOGRAM_BOUNDARIES.taskDuration,
+            },
+        }),
+        coverageLine: m.createHistogram(types_1.METRIC_NAMES.COVERAGE_LINE, {
+            description: 'Line coverage percentage',
+            unit: 'percent',
+            advice: {
+                explicitBucketBoundaries: types_1.HISTOGRAM_BOUNDARIES.coveragePercent,
+            },
+        }),
+        coverageBranch: m.createHistogram(types_1.METRIC_NAMES.COVERAGE_BRANCH, {
+            description: 'Branch coverage percentage',
+            unit: 'percent',
+            advice: {
+                explicitBucketBoundaries: types_1.HISTOGRAM_BOUNDARIES.coveragePercent,
+            },
+        }),
+        coverageFunction: m.createHistogram(types_1.METRIC_NAMES.COVERAGE_FUNCTION, {
+            description: 'Function coverage percentage',
+            unit: 'percent',
+            advice: {
+                explicitBucketBoundaries: types_1.HISTOGRAM_BOUNDARIES.coveragePercent,
+            },
+        }),
+        coverageStatement: m.createHistogram(`${types_1.METRIC_NAMES.COVERAGE_LINE}.statement`, {
+            description: 'Statement coverage percentage',
+            unit: 'percent',
+            advice: {
+                explicitBucketBoundaries: types_1.HISTOGRAM_BOUNDARIES.coveragePercent,
+            },
+        }),
+        flakyTestCount: m.createUpDownCounter(types_1.METRIC_NAMES.FLAKY_TEST_COUNT, {
+            description: 'Number of flaky tests currently tracked',
+            unit: 'tests',
+        }),
+        defectDensity: m.createHistogram(types_1.METRIC_NAMES.DEFECT_DENSITY, {
+            description: 'Defect density per 1000 lines of code',
+            unit: 'defects/KLOC',
+            advice: {
+                explicitBucketBoundaries: [0.1, 0.5, 1, 2, 5, 10, 20, 50],
+            },
+        }),
+        qualityGateCount: m.createCounter(types_1.METRIC_NAMES.QUALITY_GATE_PASS_RATE, {
+            description: 'Number of quality gate evaluations',
+            unit: 'evaluations',
+        }),
+        securityVulnerabilityCount: m.createCounter(types_1.METRIC_NAMES.SECURITY_VULNERABILITY_COUNT, {
+            description: 'Number of security vulnerabilities found',
+            unit: 'vulnerabilities',
+        }),
+    };
+    return qualityMetrics;
+}
+/**
+ * Get initialized quality metrics
+ *
+ * @returns Quality metrics registry
+ */
+function getQualityMetrics() {
+    if (!qualityMetrics) {
+        return createQualityMetrics();
+    }
+    return qualityMetrics;
+}
+/**
+ * Record test execution results
+ *
+ * @param result - Test execution result
+ */
+function recordTestExecution(result) {
+    const metrics = getQualityMetrics();
+    const attributes = {
+        'qe.test_framework': result.framework,
+        'test.suite': result.suite,
+    };
+    if (result.testType) {
+        attributes['test.type'] = result.testType;
+    }
+    // Record counts
+    metrics.testCount.add(result.total, attributes);
+    metrics.testPassCount.add(result.passed, { ...attributes, 'test.result': 'pass' });
+    metrics.testFailCount.add(result.failed, { ...attributes, 'test.result': 'fail' });
+    metrics.testSkipCount.add(result.skipped, { ...attributes, 'test.result': 'skip' });
+    // Record duration
+    metrics.testDuration.record(result.durationMs, attributes);
+}
+/**
+ * Record coverage metrics
+ *
+ * @param report - Coverage report
+ */
+function recordCoverage(report) {
+    const metrics = getQualityMetrics();
+    const attributes = {
+        'coverage.target': report.target,
+    };
+    if (report.tool) {
+        attributes['coverage.tool'] = report.tool;
+    }
+    metrics.coverageLine.record(report.line, { ...attributes, 'qe.coverage_type': 'line' });
+    metrics.coverageBranch.record(report.branch, { ...attributes, 'qe.coverage_type': 'branch' });
+    metrics.coverageFunction.record(report.function, { ...attributes, 'qe.coverage_type': 'function' });
+    if (report.statement !== undefined) {
+        metrics.coverageStatement.record(report.statement, { ...attributes, 'qe.coverage_type': 'statement' });
+    }
+}
+/**
+ * Record quality gate evaluation
+ *
+ * @param result - Quality gate result
+ */
+function recordQualityGate(result) {
+    const metrics = getQualityMetrics();
+    const attributes = {
+        'qe.gate_name': result.gateName,
+        'gate.result': result.passed ? 'pass' : 'fail',
+        'gate.metric_type': result.metricType,
+    };
+    if (result.severity) {
+        attributes['gate.severity'] = result.severity;
+    }
+    metrics.qualityGateCount.add(1, attributes);
+}
+/**
+ * Record security scan results
+ *
+ * @param result - Security scan result
+ */
+function recordSecurityScan(result) {
+    const metrics = getQualityMetrics();
+    const baseAttributes = {
+        'security.target': result.target,
+        'security.scanner': result.scanner,
+    };
+    // Record vulnerabilities by severity
+    const severities = [
+        ['critical', 'critical'],
+        ['high', 'high'],
+        ['medium', 'medium'],
+        ['low', 'low'],
+        ['info', 'info'],
+    ];
+    for (const [key, severity] of severities) {
+        if (result.vulnerabilities[key] > 0) {
+            metrics.securityVulnerabilityCount.add(result.vulnerabilities[key], {
+                ...baseAttributes,
+                'qe.security_severity': severity,
+            });
+        }
+    }
+}
+/**
+ * Record flaky test detection
+ *
+ * @param testName - Name of the flaky test
+ * @param flakinessScore - Flakiness score (0-1)
+ * @param isResolved - Whether the flaky test was resolved
+ */
+function recordFlakyTest(testName, flakinessScore, isResolved = false) {
+    const metrics = getQualityMetrics();
+    const attributes = {
+        'test.name': testName,
+        'flaky.score': flakinessScore,
+    };
+    // Update flaky test count
+    metrics.flakyTestCount.add(isResolved ? -1 : 1, attributes);
+}
+/**
+ * Record defect density
+ *
+ * @param module - Module or file name
+ * @param defectCount - Number of defects
+ * @param linesOfCode - Total lines of code
+ */
+function recordDefectDensity(module, defectCount, linesOfCode) {
+    const metrics = getQualityMetrics();
+    const density = (defectCount / linesOfCode) * 1000; // per KLOC
+    metrics.defectDensity.record(density, {
+        'code.module': module,
+        'defect.count': defectCount,
+        'code.lines': linesOfCode,
+    });
+}
+/**
+ * API contract validation metrics
+ */
+function createApiContractMetrics(meter) {
+    const m = meter || (0, bootstrap_1.getMeter)();
+    return {
+        contractValidationCount: m.createCounter('aqe.quality.api.contract.validation.count', {
+            description: 'Number of API contract validations',
+            unit: 'validations',
+        }),
+        contractViolationCount: m.createCounter('aqe.quality.api.contract.violation.count', {
+            description: 'Number of API contract violations',
+            unit: 'violations',
+        }),
+        schemaValidationDuration: m.createHistogram('aqe.quality.api.schema.validation.duration', {
+            description: 'API schema validation duration',
+            unit: 'ms',
+            advice: {
+                explicitBucketBoundaries: [1, 5, 10, 25, 50, 100, 250, 500],
+            },
+        }),
+    };
+}
+//# sourceMappingURL=quality-metrics.js.map

package/dist/telemetry/metrics/quality-metrics.js.map

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

package/dist/telemetry/metrics/system-metrics.d.ts

@@ -0,0 +1,129 @@
+/**
+ * System Metrics for Agentic QE Fleet
+ *
+ * Metrics for tracking system resources, queues, databases, and infrastructure.
+ */
+import { Meter, Counter, Histogram, UpDownCounter, Attributes, ObservableGauge } from '@opentelemetry/api';
+/**
+ * System metrics registry
+ */
+export interface SystemMetrics {
+    /** Current heap memory usage */
+    memoryHeapUsed: ObservableGauge;
+    /** Total heap memory */
+    memoryHeapTotal: ObservableGauge;
+    /** RSS memory usage */
+    memoryRss: ObservableGauge;
+    /** External memory usage */
+    memoryExternal: ObservableGauge;
+    /** CPU usage percentage */
+    cpuUsage: ObservableGauge;
+    /** Event loop lag */
+    eventLoopLag: Histogram;
+    /** Task queue depth */
+    queueDepth: UpDownCounter;
+    /** Queue wait time */
+    queueWaitTime: Histogram;
+    /** Database query count */
+    dbQueryCount: Counter;
+    /** Database query duration */
+    dbQueryDuration: Histogram;
+    /** Database connection count */
+    dbConnectionCount: UpDownCounter;
+    /** Event bus publish count */
+    eventBusPublishCount: Counter;
+    /** Event bus latency */
+    eventBusLatency: Histogram;
+    /** File system operations */
+    fsOperationCount: Counter;
+    /** Network request count */
+    networkRequestCount: Counter;
+    /** Network request duration */
+    networkRequestDuration: Histogram;
+}
+/**
+ * Initialize system metrics
+ *
+ * @param meter - OpenTelemetry Meter instance
+ * @returns System metrics registry
+ */
+export declare function createSystemMetrics(meter?: Meter): SystemMetrics;
+/**
+ * Get initialized system metrics
+ *
+ * @returns System metrics registry
+ */
+export declare function getSystemMetrics(): SystemMetrics;
+/**
+ * Record database query
+ *
+ * @param operation - Query operation (select, insert, update, delete)
+ * @param table - Table or collection name
+ * @param durationMs - Query duration in milliseconds
+ * @param success - Whether the query succeeded
+ */
+export declare function recordDatabaseQuery(operation: string, table: string, durationMs: number, success?: boolean): void;
+/**
+ * Record database connection change
+ *
+ * @param delta - Change in connection count (+1 for open, -1 for close)
+ * @param poolName - Connection pool name
+ */
+export declare function recordDatabaseConnection(delta: number, poolName?: string): void;
+/**
+ * Record queue operation
+ *
+ * @param queueName - Name of the queue
+ * @param operation - Operation type (enqueue, dequeue)
+ * @param waitTimeMs - Time item waited in queue (for dequeue)
+ */
+export declare function recordQueueOperation(queueName: string, operation: 'enqueue' | 'dequeue', waitTimeMs?: number): void;
+/**
+ * Record event bus operation
+ *
+ * @param eventType - Type of event
+ * @param latencyMs - Publish-to-receive latency
+ */
+export declare function recordEventBusOperation(eventType: string, latencyMs?: number): void;
+/**
+ * Record network request
+ *
+ * @param method - HTTP method
+ * @param url - Request URL
+ * @param statusCode - Response status code
+ * @param durationMs - Request duration
+ */
+export declare function recordNetworkRequest(method: string, url: string, statusCode: number, durationMs: number): void;
+/**
+ * Record file system operation
+ *
+ * @param operation - FS operation (read, write, delete, etc.)
+ * @param path - File path
+ * @param success - Whether operation succeeded
+ */
+export declare function recordFileSystemOperation(operation: string, path: string, success?: boolean): void;
+/**
+ * Record event loop lag
+ *
+ * @param lagMs - Event loop lag in milliseconds
+ */
+export declare function recordEventLoopLag(lagMs: number): void;
+/**
+ * Create memory-specific detailed metrics
+ */
+export declare function createMemoryDetailMetrics(meter?: Meter): {
+    heapSpaceUsed: ObservableGauge<Attributes>;
+    heapSpaceAvailable: ObservableGauge<Attributes>;
+    gcDuration: Histogram<Attributes>;
+    gcCount: Counter<Attributes>;
+};
+/**
+ * Create fleet coordination metrics
+ */
+export declare function createFleetCoordinationMetrics(meter?: Meter): {
+    coordinationRoundtrip: Histogram<Attributes>;
+    taskDistributionTime: Histogram<Attributes>;
+    agentSyncCount: Counter<Attributes>;
+    memoryShareSize: Histogram<Attributes>;
+};
+//# sourceMappingURL=system-metrics.d.ts.map

package/dist/telemetry/metrics/system-metrics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"system-metrics.d.ts","sourceRoot":"","sources":["../../../src/telemetry/metrics/system-metrics.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAM3G;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,gCAAgC;IAChC,cAAc,EAAE,eAAe,CAAC;IAChC,wBAAwB;IACxB,eAAe,EAAE,eAAe,CAAC;IACjC,uBAAuB;IACvB,SAAS,EAAE,eAAe,CAAC;IAC3B,4BAA4B;IAC5B,cAAc,EAAE,eAAe,CAAC;IAChC,2BAA2B;IAC3B,QAAQ,EAAE,eAAe,CAAC;IAC1B,qBAAqB;IACrB,YAAY,EAAE,SAAS,CAAC;IACxB,uBAAuB;IACvB,UAAU,EAAE,aAAa,CAAC;IAC1B,sBAAsB;IACtB,aAAa,EAAE,SAAS,CAAC;IACzB,2BAA2B;IAC3B,YAAY,EAAE,OAAO,CAAC;IACtB,8BAA8B;IAC9B,eAAe,EAAE,SAAS,CAAC;IAC3B,gCAAgC;IAChC,iBAAiB,EAAE,aAAa,CAAC;IACjC,8BAA8B;IAC9B,oBAAoB,EAAE,OAAO,CAAC;IAC9B,wBAAwB;IACxB,eAAe,EAAE,SAAS,CAAC;IAC3B,6BAA6B;IAC7B,gBAAgB,EAAE,OAAO,CAAC;IAC1B,4BAA4B;IAC5B,mBAAmB,EAAE,OAAO,CAAC;IAC7B,+BAA+B;IAC/B,sBAAsB,EAAE,SAAS,CAAC;CACnC;AA+BD;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,CAAC,EAAE,KAAK,GAAG,aAAa,CA+HhE;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,IAAI,aAAa,CAKhD;AAED;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CACjC,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,MAAM,EACb,UAAU,EAAE,MAAM,EAClB,OAAO,GAAE,OAAc,GACtB,IAAI,CAWN;AAED;;;;;GAKG;AACH,wBAAgB,wBAAwB,CACtC,KAAK,EAAE,MAAM,EACb,QAAQ,GAAE,MAAkB,GAC3B,IAAI,CAMN;AAED;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAClC,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,SAAS,GAAG,SAAS,EAChC,UAAU,CAAC,EAAE,MAAM,GAClB,IAAI,CAeN;AAED;;;;;GAKG;AACH,wBAAgB,uBAAuB,CACrC,SAAS,EAAE,MAAM,EACjB,SAAS,CAAC,EAAE,MAAM,GACjB,IAAI,CAYN;AAED;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,MAAM,EACd,GAAG,EAAE,MAAM,EACX,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,MAAM,GACjB,IAAI,CAoBN;AAED;;;;;;GAMG;AACH,wBAAgB,yBAAyB,CACvC,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE,OAAc,GACtB,IAAI,CAWN;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAGtD;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CAAC,KAAK,CAAC,EAAE,KAAK;;;;;EA2BtD;AAED;;GAEG;AACH,wBAAgB,8BAA8B,CAAC,KAAK,CAAC,EAAE,KAAK;;;;;EAiC3D"}