agentic-qe 1.8.3 → 1.9.0

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

@@ -0,0 +1,380 @@
+"use strict";
+/**
+ * System Metrics for Agentic QE Fleet
+ *
+ * Metrics for tracking system resources, queues, databases, and infrastructure.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createSystemMetrics = createSystemMetrics;
+exports.getSystemMetrics = getSystemMetrics;
+exports.recordDatabaseQuery = recordDatabaseQuery;
+exports.recordDatabaseConnection = recordDatabaseConnection;
+exports.recordQueueOperation = recordQueueOperation;
+exports.recordEventBusOperation = recordEventBusOperation;
+exports.recordNetworkRequest = recordNetworkRequest;
+exports.recordFileSystemOperation = recordFileSystemOperation;
+exports.recordEventLoopLag = recordEventLoopLag;
+exports.createMemoryDetailMetrics = createMemoryDetailMetrics;
+exports.createFleetCoordinationMetrics = createFleetCoordinationMetrics;
+const bootstrap_1 = require("../bootstrap");
+const types_1 = require("../types");
+const v8 = __importStar(require("v8"));
+// Singleton metrics instance
+let systemMetrics = null;
+// CPU tracking state
+let lastCpuUsage = process.cpuUsage();
+let lastCpuTime = Date.now();
+/**
+ * Calculate CPU usage percentage
+ */
+function calculateCpuUsage() {
+    const currentCpuUsage = process.cpuUsage(lastCpuUsage);
+    const currentTime = Date.now();
+    const elapsedMs = currentTime - lastCpuTime;
+    if (elapsedMs === 0)
+        return 0;
+    // Total CPU time used in microseconds
+    const totalCpuTime = currentCpuUsage.user + currentCpuUsage.system;
+    // Convert to percentage (microseconds to milliseconds, then to percentage)
+    const cpuPercent = (totalCpuTime / 1000 / elapsedMs) * 100;
+    // Update tracking state
+    lastCpuUsage = process.cpuUsage();
+    lastCpuTime = currentTime;
+    return Math.min(cpuPercent, 100);
+}
+/**
+ * Initialize system metrics
+ *
+ * @param meter - OpenTelemetry Meter instance
+ * @returns System metrics registry
+ */
+function createSystemMetrics(meter) {
+    if (systemMetrics) {
+        return systemMetrics;
+    }
+    const m = meter || (0, bootstrap_1.getMeter)();
+    // Create observable gauges for memory metrics
+    const memoryHeapUsed = m.createObservableGauge(types_1.METRIC_NAMES.MEMORY_USAGE + '.heap.used', {
+        description: 'Current heap memory used',
+        unit: 'bytes',
+    });
+    const memoryHeapTotal = m.createObservableGauge(types_1.METRIC_NAMES.MEMORY_USAGE + '.heap.total', {
+        description: 'Total heap memory',
+        unit: 'bytes',
+    });
+    const memoryRss = m.createObservableGauge(types_1.METRIC_NAMES.MEMORY_USAGE + '.rss', {
+        description: 'Resident set size memory',
+        unit: 'bytes',
+    });
+    const memoryExternal = m.createObservableGauge(types_1.METRIC_NAMES.MEMORY_USAGE + '.external', {
+        description: 'External memory usage',
+        unit: 'bytes',
+    });
+    const cpuUsage = m.createObservableGauge(types_1.METRIC_NAMES.CPU_USAGE, {
+        description: 'CPU usage percentage',
+        unit: 'percent',
+    });
+    // Register callbacks for observable gauges
+    m.addBatchObservableCallback((observableResult) => {
+        const memUsage = process.memoryUsage();
+        const heapStats = v8.getHeapStatistics();
+        observableResult.observe(memoryHeapUsed, memUsage.heapUsed);
+        observableResult.observe(memoryHeapTotal, memUsage.heapTotal);
+        observableResult.observe(memoryRss, memUsage.rss);
+        observableResult.observe(memoryExternal, memUsage.external);
+        observableResult.observe(cpuUsage, calculateCpuUsage());
+    }, [memoryHeapUsed, memoryHeapTotal, memoryRss, memoryExternal, cpuUsage]);
+    systemMetrics = {
+        memoryHeapUsed,
+        memoryHeapTotal,
+        memoryRss,
+        memoryExternal,
+        cpuUsage,
+        eventLoopLag: m.createHistogram('aqe.system.eventloop.lag', {
+            description: 'Event loop lag in milliseconds',
+            unit: 'ms',
+            advice: {
+                explicitBucketBoundaries: [1, 5, 10, 25, 50, 100, 250, 500, 1000],
+            },
+        }),
+        queueDepth: m.createUpDownCounter(types_1.METRIC_NAMES.QUEUE_DEPTH, {
+            description: 'Current depth of task queues',
+            unit: 'tasks',
+        }),
+        queueWaitTime: m.createHistogram(types_1.METRIC_NAMES.QUEUE_WAIT_TIME, {
+            description: 'Time tasks wait in queue before processing',
+            unit: 'ms',
+            advice: {
+                explicitBucketBoundaries: [10, 50, 100, 250, 500, 1000, 2500, 5000, 10000],
+            },
+        }),
+        dbQueryCount: m.createCounter(types_1.METRIC_NAMES.DATABASE_QUERY_DURATION + '.count', {
+            description: 'Total number of database queries',
+            unit: 'queries',
+        }),
+        dbQueryDuration: m.createHistogram(types_1.METRIC_NAMES.DATABASE_QUERY_DURATION, {
+            description: 'Database query execution duration',
+            unit: 'ms',
+            advice: {
+                explicitBucketBoundaries: [1, 5, 10, 25, 50, 100, 250, 500, 1000, 2500],
+            },
+        }),
+        dbConnectionCount: m.createUpDownCounter(types_1.METRIC_NAMES.DATABASE_CONNECTION_COUNT, {
+            description: 'Current number of database connections',
+            unit: 'connections',
+        }),
+        eventBusPublishCount: m.createCounter(types_1.METRIC_NAMES.EVENT_BUS_PUBLISH_COUNT, {
+            description: 'Number of events published to event bus',
+            unit: 'events',
+        }),
+        eventBusLatency: m.createHistogram(types_1.METRIC_NAMES.EVENT_BUS_LATENCY, {
+            description: 'Event bus publish-to-receive latency',
+            unit: 'ms',
+            advice: {
+                explicitBucketBoundaries: [0.1, 0.5, 1, 5, 10, 25, 50, 100],
+            },
+        }),
+        fsOperationCount: m.createCounter('aqe.system.fs.operation.count', {
+            description: 'Number of file system operations',
+            unit: 'operations',
+        }),
+        networkRequestCount: m.createCounter('aqe.system.network.request.count', {
+            description: 'Number of network requests',
+            unit: 'requests',
+        }),
+        networkRequestDuration: m.createHistogram('aqe.system.network.request.duration', {
+            description: 'Network request duration',
+            unit: 'ms',
+            advice: {
+                explicitBucketBoundaries: [10, 50, 100, 250, 500, 1000, 2500, 5000, 10000],
+            },
+        }),
+    };
+    return systemMetrics;
+}
+/**
+ * Get initialized system metrics
+ *
+ * @returns System metrics registry
+ */
+function getSystemMetrics() {
+    if (!systemMetrics) {
+        return createSystemMetrics();
+    }
+    return 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
+ */
+function recordDatabaseQuery(operation, table, durationMs, success = true) {
+    const metrics = getSystemMetrics();
+    const attributes = {
+        'db.operation': operation,
+        'db.table': table,
+        'db.status': success ? 'success' : 'error',
+    };
+    metrics.dbQueryCount.add(1, attributes);
+    metrics.dbQueryDuration.record(durationMs, attributes);
+}
+/**
+ * Record database connection change
+ *
+ * @param delta - Change in connection count (+1 for open, -1 for close)
+ * @param poolName - Connection pool name
+ */
+function recordDatabaseConnection(delta, poolName = 'default') {
+    const metrics = getSystemMetrics();
+    metrics.dbConnectionCount.add(delta, {
+        'db.pool': poolName,
+    });
+}
+/**
+ * Record queue operation
+ *
+ * @param queueName - Name of the queue
+ * @param operation - Operation type (enqueue, dequeue)
+ * @param waitTimeMs - Time item waited in queue (for dequeue)
+ */
+function recordQueueOperation(queueName, operation, waitTimeMs) {
+    const metrics = getSystemMetrics();
+    const attributes = {
+        'queue.name': queueName,
+    };
+    if (operation === 'enqueue') {
+        metrics.queueDepth.add(1, attributes);
+    }
+    else {
+        metrics.queueDepth.add(-1, attributes);
+        if (waitTimeMs !== undefined) {
+            metrics.queueWaitTime.record(waitTimeMs, attributes);
+        }
+    }
+}
+/**
+ * Record event bus operation
+ *
+ * @param eventType - Type of event
+ * @param latencyMs - Publish-to-receive latency
+ */
+function recordEventBusOperation(eventType, latencyMs) {
+    const metrics = getSystemMetrics();
+    const attributes = {
+        'event.type': eventType,
+    };
+    metrics.eventBusPublishCount.add(1, attributes);
+    if (latencyMs !== undefined) {
+        metrics.eventBusLatency.record(latencyMs, attributes);
+    }
+}
+/**
+ * Record network request
+ *
+ * @param method - HTTP method
+ * @param url - Request URL
+ * @param statusCode - Response status code
+ * @param durationMs - Request duration
+ */
+function recordNetworkRequest(method, url, statusCode, durationMs) {
+    const metrics = getSystemMetrics();
+    // Extract host from URL
+    let host = 'unknown';
+    try {
+        host = new URL(url).host;
+    }
+    catch {
+        // Keep default
+    }
+    const attributes = {
+        'http.method': method,
+        'http.host': host,
+        'http.status_code': statusCode,
+        'http.status_class': `${Math.floor(statusCode / 100)}xx`,
+    };
+    metrics.networkRequestCount.add(1, attributes);
+    metrics.networkRequestDuration.record(durationMs, attributes);
+}
+/**
+ * Record file system operation
+ *
+ * @param operation - FS operation (read, write, delete, etc.)
+ * @param path - File path
+ * @param success - Whether operation succeeded
+ */
+function recordFileSystemOperation(operation, path, success = true) {
+    const metrics = getSystemMetrics();
+    // Extract directory from path for grouping
+    const directory = path.substring(0, path.lastIndexOf('/')) || '/';
+    metrics.fsOperationCount.add(1, {
+        'fs.operation': operation,
+        'fs.directory': directory,
+        'fs.status': success ? 'success' : 'error',
+    });
+}
+/**
+ * Record event loop lag
+ *
+ * @param lagMs - Event loop lag in milliseconds
+ */
+function recordEventLoopLag(lagMs) {
+    const metrics = getSystemMetrics();
+    metrics.eventLoopLag.record(lagMs);
+}
+/**
+ * Create memory-specific detailed metrics
+ */
+function createMemoryDetailMetrics(meter) {
+    const m = meter || (0, bootstrap_1.getMeter)();
+    return {
+        heapSpaceUsed: m.createObservableGauge('aqe.system.memory.heap.space.used', {
+            description: 'Heap space used by type',
+            unit: 'bytes',
+        }),
+        heapSpaceAvailable: m.createObservableGauge('aqe.system.memory.heap.space.available', {
+            description: 'Heap space available by type',
+            unit: 'bytes',
+        }),
+        gcDuration: m.createHistogram('aqe.system.gc.duration', {
+            description: 'Garbage collection duration',
+            unit: 'ms',
+            advice: {
+                explicitBucketBoundaries: [1, 5, 10, 25, 50, 100, 250, 500],
+            },
+        }),
+        gcCount: m.createCounter('aqe.system.gc.count', {
+            description: 'Number of garbage collections',
+            unit: 'collections',
+        }),
+    };
+}
+/**
+ * Create fleet coordination metrics
+ */
+function createFleetCoordinationMetrics(meter) {
+    const m = meter || (0, bootstrap_1.getMeter)();
+    return {
+        coordinationRoundtrip: m.createHistogram('aqe.fleet.coordination.roundtrip', {
+            description: 'Fleet coordination message roundtrip time',
+            unit: 'ms',
+            advice: {
+                explicitBucketBoundaries: [1, 5, 10, 25, 50, 100, 250, 500, 1000],
+            },
+        }),
+        taskDistributionTime: m.createHistogram('aqe.fleet.task.distribution.time', {
+            description: 'Time to distribute tasks across fleet',
+            unit: 'ms',
+            advice: {
+                explicitBucketBoundaries: [10, 50, 100, 250, 500, 1000, 2500],
+            },
+        }),
+        agentSyncCount: m.createCounter('aqe.fleet.agent.sync.count', {
+            description: 'Number of agent synchronization events',
+            unit: 'syncs',
+        }),
+        memoryShareSize: m.createHistogram('aqe.fleet.memory.share.size', {
+            description: 'Size of shared memory operations',
+            unit: 'bytes',
+            advice: {
+                explicitBucketBoundaries: types_1.HISTOGRAM_BOUNDARIES.memoryBytes,
+            },
+        }),
+    };
+}
+//# sourceMappingURL=system-metrics.js.map

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

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

package/dist/telemetry/types.d.ts

@@ -0,0 +1,195 @@
+/**
+ * OpenTelemetry Types for Agentic QE Fleet
+ *
+ * Type definitions for telemetry configuration, metrics, and observability.
+ */
+import { Attributes } from '@opentelemetry/api';
+/**
+ * Telemetry configuration options
+ */
+export interface TelemetryConfig {
+    /** Service name for resource identification */
+    serviceName: string;
+    /** Service version */
+    serviceVersion: string;
+    /** Deployment environment (development, staging, production) */
+    environment: string;
+    /** OTLP endpoint for trace export */
+    otlpEndpoint?: string;
+    /** OTLP endpoint for metrics export */
+    metricsEndpoint?: string;
+    /** OTLP endpoint for logs export */
+    logsEndpoint?: string;
+    /** Whether to use gRPC (true) or HTTP (false) for OTLP */
+    useGrpc?: boolean;
+    /** Enable console exporter for debugging */
+    enableConsoleExport?: boolean;
+    /** Enable auto-instrumentation */
+    enableAutoInstrumentation?: boolean;
+    /** Sample rate for traces (0.0 to 1.0) */
+    traceSampleRate?: number;
+    /** Metric export interval in milliseconds */
+    metricExportInterval?: number;
+    /** Additional resource attributes */
+    resourceAttributes?: Attributes;
+}
+/**
+ * Agent telemetry attributes
+ */
+export interface AgentAttributes {
+    /** Unique agent identifier */
+    'agent.id': string;
+    /** Agent type (e.g., test-generator, coverage-analyzer) */
+    'agent.type': string;
+    /** Agent name */
+    'agent.name': string;
+    /** Fleet identifier */
+    'fleet.id'?: string;
+    /** Fleet topology (hierarchical, mesh, star, ring) */
+    'fleet.topology'?: string;
+}
+/**
+ * Task telemetry attributes
+ */
+export interface TaskAttributes {
+    /** Unique task identifier */
+    'task.id': string;
+    /** Task type (unit-test, integration-test, coverage-analysis, etc.) */
+    'task.type': string;
+    /** Task priority (low, medium, high, critical) */
+    'task.priority'?: string | number;
+    /** Task status (pending, running, completed, failed) */
+    'task.status': string;
+    /** Parent task ID for hierarchical tasks */
+    'task.parent_id'?: string;
+}
+/**
+ * Quality Engineering specific attributes
+ */
+export interface QEAttributes {
+    /** Test framework (jest, mocha, pytest, etc.) */
+    'qe.test_framework'?: string;
+    /** Coverage type (line, branch, function, statement) */
+    'qe.coverage_type'?: string;
+    /** Quality gate name */
+    'qe.gate_name'?: string;
+    /** Risk level (low, medium, high, critical) */
+    'qe.risk_level'?: string;
+    /** Security severity (info, low, medium, high, critical) */
+    'qe.security_severity'?: string;
+}
+/**
+ * Model routing attributes
+ */
+export interface ModelAttributes {
+    /** Model provider (anthropic, openai, etc.) */
+    'model.provider': string;
+    /** Model name/ID */
+    'model.name': string;
+    /** Model tier (fast, balanced, quality) */
+    'model.tier'?: string;
+    /** Routing reason */
+    'model.routing_reason'?: string;
+}
+/**
+ * Metric recording options
+ */
+export interface MetricRecordOptions {
+    /** Attributes to attach to the metric */
+    attributes?: Attributes;
+    /** Timestamp for the metric (defaults to now) */
+    timestamp?: number;
+}
+/**
+ * Histogram bucket boundaries for common metrics
+ */
+export declare const HISTOGRAM_BOUNDARIES: {
+    /** Task duration in milliseconds */
+    taskDuration: number[];
+    /** Token counts */
+    tokenCount: number[];
+    /** Coverage percentage */
+    coveragePercent: number[];
+    /** Queue depth */
+    queueDepth: number[];
+    /** Memory in bytes */
+    memoryBytes: number[];
+};
+/**
+ * Semantic naming conventions for QE metrics
+ */
+export declare const METRIC_NAMES: {
+    readonly AGENT_TASK_DURATION: "aqe.agent.task.duration";
+    readonly AGENT_TASK_COUNT: "aqe.agent.task.count";
+    readonly AGENT_SUCCESS_RATE: "aqe.agent.success.rate";
+    readonly AGENT_TOKEN_USAGE: "aqe.agent.token.usage";
+    readonly AGENT_COST: "aqe.agent.cost";
+    readonly AGENT_ACTIVE_COUNT: "aqe.agent.active.count";
+    readonly AGENT_ERROR_COUNT: "aqe.agent.error.count";
+    readonly TEST_PASS_RATE: "aqe.quality.test.pass_rate";
+    readonly TEST_COUNT: "aqe.quality.test.count";
+    readonly TEST_DURATION: "aqe.quality.test.duration";
+    readonly COVERAGE_LINE: "aqe.quality.coverage.line";
+    readonly COVERAGE_BRANCH: "aqe.quality.coverage.branch";
+    readonly COVERAGE_FUNCTION: "aqe.quality.coverage.function";
+    readonly DEFECT_DENSITY: "aqe.quality.defect.density";
+    readonly FLAKY_TEST_COUNT: "aqe.quality.flaky.count";
+    readonly QUALITY_GATE_PASS_RATE: "aqe.quality.gate.pass_rate";
+    readonly SECURITY_VULNERABILITY_COUNT: "aqe.quality.security.vulnerability.count";
+    readonly MEMORY_USAGE: "aqe.system.memory.usage";
+    readonly CPU_USAGE: "aqe.system.cpu.usage";
+    readonly QUEUE_DEPTH: "aqe.system.queue.depth";
+    readonly QUEUE_WAIT_TIME: "aqe.system.queue.wait_time";
+    readonly DATABASE_QUERY_DURATION: "aqe.system.db.query.duration";
+    readonly DATABASE_CONNECTION_COUNT: "aqe.system.db.connection.count";
+    readonly EVENT_BUS_PUBLISH_COUNT: "aqe.system.eventbus.publish.count";
+    readonly EVENT_BUS_LATENCY: "aqe.system.eventbus.latency";
+};
+/**
+ * Span names for tracing
+ */
+export declare const SPAN_NAMES: {
+    readonly AGENT_EXECUTE_TASK: "aqe.agent.execute_task";
+    readonly AGENT_GENERATE_TESTS: "aqe.agent.generate_tests";
+    readonly AGENT_ANALYZE_COVERAGE: "aqe.agent.analyze_coverage";
+    readonly AGENT_VALIDATE_QUALITY: "aqe.agent.validate_quality";
+    readonly AGENT_SCAN_SECURITY: "aqe.agent.scan_security";
+    readonly FLEET_SPAWN_AGENT: "aqe.fleet.spawn_agent";
+    readonly FLEET_COORDINATE: "aqe.fleet.coordinate";
+    readonly FLEET_DISTRIBUTE_TASK: "aqe.fleet.distribute_task";
+    readonly MODEL_ROUTE: "aqe.model.route";
+    readonly MODEL_INVOKE: "aqe.model.invoke";
+    readonly DB_QUERY: "aqe.db.query";
+    readonly DB_INSERT: "aqe.db.insert";
+    readonly DB_UPDATE: "aqe.db.update";
+    readonly MEMORY_STORE: "aqe.memory.store";
+    readonly MEMORY_RETRIEVE: "aqe.memory.retrieve";
+    readonly MEMORY_SEARCH: "aqe.memory.search";
+};
+/**
+ * Telemetry initialization result
+ */
+export interface TelemetryInitResult {
+    /** Whether initialization was successful */
+    success: boolean;
+    /** Error message if initialization failed */
+    error?: string;
+    /** Configured service name */
+    serviceName: string;
+    /** Configured environment */
+    environment: string;
+    /** Active exporters */
+    exporters: string[];
+}
+/**
+ * Shutdown result
+ */
+export interface TelemetryShutdownResult {
+    /** Whether shutdown was successful */
+    success: boolean;
+    /** Error message if shutdown failed */
+    error?: string;
+    /** Time taken to shutdown in milliseconds */
+    shutdownDuration: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/telemetry/types.d.ts.map

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

package/dist/telemetry/types.js

@@ -0,0 +1,90 @@
+"use strict";
+/**
+ * OpenTelemetry Types for Agentic QE Fleet
+ *
+ * Type definitions for telemetry configuration, metrics, and observability.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SPAN_NAMES = exports.METRIC_NAMES = exports.HISTOGRAM_BOUNDARIES = void 0;
+/**
+ * Histogram bucket boundaries for common metrics
+ */
+exports.HISTOGRAM_BOUNDARIES = {
+    /** Task duration in milliseconds */
+    taskDuration: [10, 50, 100, 250, 500, 1000, 2500, 5000, 10000, 30000, 60000],
+    /** Token counts */
+    tokenCount: [10, 50, 100, 500, 1000, 5000, 10000, 50000, 100000],
+    /** Coverage percentage */
+    coveragePercent: [10, 20, 30, 40, 50, 60, 70, 80, 90, 95, 100],
+    /** Queue depth */
+    queueDepth: [1, 5, 10, 25, 50, 100, 250, 500, 1000],
+    /** Memory in bytes */
+    memoryBytes: [
+        1024 * 1024, // 1 MB
+        10 * 1024 * 1024, // 10 MB
+        50 * 1024 * 1024, // 50 MB
+        100 * 1024 * 1024, // 100 MB
+        500 * 1024 * 1024, // 500 MB
+        1024 * 1024 * 1024, // 1 GB
+    ],
+};
+/**
+ * Semantic naming conventions for QE metrics
+ */
+exports.METRIC_NAMES = {
+    // Agent metrics
+    AGENT_TASK_DURATION: 'aqe.agent.task.duration',
+    AGENT_TASK_COUNT: 'aqe.agent.task.count',
+    AGENT_SUCCESS_RATE: 'aqe.agent.success.rate',
+    AGENT_TOKEN_USAGE: 'aqe.agent.token.usage',
+    AGENT_COST: 'aqe.agent.cost',
+    AGENT_ACTIVE_COUNT: 'aqe.agent.active.count',
+    AGENT_ERROR_COUNT: 'aqe.agent.error.count',
+    // Quality metrics
+    TEST_PASS_RATE: 'aqe.quality.test.pass_rate',
+    TEST_COUNT: 'aqe.quality.test.count',
+    TEST_DURATION: 'aqe.quality.test.duration',
+    COVERAGE_LINE: 'aqe.quality.coverage.line',
+    COVERAGE_BRANCH: 'aqe.quality.coverage.branch',
+    COVERAGE_FUNCTION: 'aqe.quality.coverage.function',
+    DEFECT_DENSITY: 'aqe.quality.defect.density',
+    FLAKY_TEST_COUNT: 'aqe.quality.flaky.count',
+    QUALITY_GATE_PASS_RATE: 'aqe.quality.gate.pass_rate',
+    SECURITY_VULNERABILITY_COUNT: 'aqe.quality.security.vulnerability.count',
+    // System metrics
+    MEMORY_USAGE: 'aqe.system.memory.usage',
+    CPU_USAGE: 'aqe.system.cpu.usage',
+    QUEUE_DEPTH: 'aqe.system.queue.depth',
+    QUEUE_WAIT_TIME: 'aqe.system.queue.wait_time',
+    DATABASE_QUERY_DURATION: 'aqe.system.db.query.duration',
+    DATABASE_CONNECTION_COUNT: 'aqe.system.db.connection.count',
+    EVENT_BUS_PUBLISH_COUNT: 'aqe.system.eventbus.publish.count',
+    EVENT_BUS_LATENCY: 'aqe.system.eventbus.latency',
+};
+/**
+ * Span names for tracing
+ */
+exports.SPAN_NAMES = {
+    // Agent operations
+    AGENT_EXECUTE_TASK: 'aqe.agent.execute_task',
+    AGENT_GENERATE_TESTS: 'aqe.agent.generate_tests',
+    AGENT_ANALYZE_COVERAGE: 'aqe.agent.analyze_coverage',
+    AGENT_VALIDATE_QUALITY: 'aqe.agent.validate_quality',
+    AGENT_SCAN_SECURITY: 'aqe.agent.scan_security',
+    // Fleet operations
+    FLEET_SPAWN_AGENT: 'aqe.fleet.spawn_agent',
+    FLEET_COORDINATE: 'aqe.fleet.coordinate',
+    FLEET_DISTRIBUTE_TASK: 'aqe.fleet.distribute_task',
+    // Model routing
+    MODEL_ROUTE: 'aqe.model.route',
+    MODEL_INVOKE: 'aqe.model.invoke',
+    // Database operations
+    DB_QUERY: 'aqe.db.query',
+    DB_INSERT: 'aqe.db.insert',
+    DB_UPDATE: 'aqe.db.update',
+    // Memory operations
+    MEMORY_STORE: 'aqe.memory.store',
+    MEMORY_RETRIEVE: 'aqe.memory.retrieve',
+    MEMORY_SEARCH: 'aqe.memory.search',
+};
+//# sourceMappingURL=types.js.map