@contractspec/lib.observability 3.7.5 → 3.7.7

package/dist/node/index.js

@@ -147,241 +147,6 @@ class RootCauseAnalyzer {
   }
 }
 
-// src/tracing/core.ts
-import {
-  SpanStatusCode,
-  trace
-} from "@opentelemetry/api";
-var DEFAULT_TRACER_NAME = "@contractspec/lib.observability";
-function getTracer(name = DEFAULT_TRACER_NAME) {
-  return trace.getTracer(name);
-}
-async function traceAsync(name, fn, tracerName) {
-  const tracer = getTracer(tracerName);
-  return tracer.startActiveSpan(name, async (span) => {
-    try {
-      const result = await fn(span);
-      span.setStatus({ code: SpanStatusCode.OK });
-      return result;
-    } catch (error) {
-      span.recordException(error);
-      span.setStatus({
-        code: SpanStatusCode.ERROR,
-        message: error instanceof Error ? error.message : String(error)
-      });
-      throw error;
-    } finally {
-      span.end();
-    }
-  });
-}
-function traceSync(name, fn, tracerName) {
-  const tracer = getTracer(tracerName);
-  return tracer.startActiveSpan(name, (span) => {
-    try {
-      const result = fn(span);
-      span.setStatus({ code: SpanStatusCode.OK });
-      return result;
-    } catch (error) {
-      span.recordException(error);
-      span.setStatus({
-        code: SpanStatusCode.ERROR,
-        message: error instanceof Error ? error.message : String(error)
-      });
-      throw error;
-    } finally {
-      span.end();
-    }
-  });
-}
-
-// src/tracing/model-selection.span.ts
-async function traceModelSelection(fn, input) {
-  const startMs = performance.now();
-  return traceAsync("model.selection", async (span) => {
-    const result = await fn();
-    const durationMs = performance.now() - startMs;
-    span.setAttribute("model.selected", input.modelId);
-    span.setAttribute("model.provider", input.providerKey);
-    span.setAttribute("model.score", input.score);
-    span.setAttribute("model.alternatives_count", input.alternativesCount);
-    span.setAttribute("model.selection_duration_ms", durationMs);
-    span.setAttribute("model.reason", input.reason);
-    if (input.dimension) {
-      span.setAttribute("model.dimension", input.dimension);
-    }
-    if (input.constraints) {
-      span.setAttribute("model.constraints", JSON.stringify(input.constraints));
-    }
-    return result;
-  });
-}
-// src/telemetry/model-selection-telemetry.ts
-class ModelSelectionTelemetry {
-  provider;
-  eventName;
-  constructor(provider, options) {
-    this.provider = provider;
-    this.eventName = options?.eventName ?? "$model_selection";
-  }
-  async trackSelection(distinctId, properties) {
-    await this.provider.capture({
-      distinctId,
-      event: this.eventName,
-      timestamp: new Date,
-      properties: {
-        $model_id: properties.modelId,
-        $model_provider: properties.providerKey,
-        $model_score: properties.score,
-        $model_dimension: properties.dimension ?? null,
-        $model_reason: properties.reason,
-        $model_alternatives_count: properties.alternativesCount,
-        $model_cost_estimate_input: properties.costEstimateInput ?? null,
-        $model_cost_estimate_output: properties.costEstimateOutput ?? null,
-        $model_selection_duration_ms: properties.selectionDurationMs ?? null
-      }
-    });
-  }
-}
-
-// src/metrics/index.ts
-import {
-  metrics
-} from "@opentelemetry/api";
-var DEFAULT_METER_NAME = "@contractspec/lib.observability";
-function getMeter(name = DEFAULT_METER_NAME) {
-  return metrics.getMeter(name);
-}
-function createCounter(name, description, meterName) {
-  return getMeter(meterName).createCounter(name, { description });
-}
-function createUpDownCounter(name, description, meterName) {
-  return getMeter(meterName).createUpDownCounter(name, { description });
-}
-function createHistogram(name, description, meterName) {
-  return getMeter(meterName).createHistogram(name, { description });
-}
-var standardMetrics = {
-  httpRequests: createCounter("http_requests_total", "Total HTTP requests"),
-  httpDuration: createHistogram("http_request_duration_seconds", "HTTP request duration"),
-  operationErrors: createCounter("operation_errors_total", "Total operation errors"),
-  workflowDuration: createHistogram("workflow_duration_seconds", "Workflow execution duration")
-};
-
-// src/logging/index.ts
-import { trace as trace2, context } from "@opentelemetry/api";
-
-class Logger {
-  serviceName;
-  constructor(serviceName) {
-    this.serviceName = serviceName;
-  }
-  log(level, message, meta = {}) {
-    const span = trace2.getSpan(context.active());
-    const traceId = span?.spanContext().traceId;
-    const spanId = span?.spanContext().spanId;
-    const entry = {
-      timestamp: new Date().toISOString(),
-      service: this.serviceName,
-      level,
-      message,
-      traceId,
-      spanId,
-      ...meta
-    };
-    console.log(JSON.stringify(entry));
-  }
-  debug(message, meta) {
-    this.log("debug", message, meta);
-  }
-  info(message, meta) {
-    this.log("info", message, meta);
-  }
-  warn(message, meta) {
-    this.log("warn", message, meta);
-  }
-  error(message, meta) {
-    this.log("error", message, meta);
-  }
-}
-var logger = new Logger(process.env.OTEL_SERVICE_NAME || "unknown-service");
-
-// src/tracing/middleware.ts
-function createTracingMiddleware(options = {}) {
-  return async (req, next) => {
-    const method = req.method;
-    const url = new URL(req.url);
-    const path = url.pathname;
-    standardMetrics.httpRequests.add(1, { method, path });
-    const startTime = performance.now();
-    return traceAsync(`HTTP ${method} ${path}`, async (span) => {
-      span.setAttribute("http.method", method);
-      span.setAttribute("http.url", req.url);
-      try {
-        const response = await next();
-        span.setAttribute("http.status_code", response.status);
-        const duration = (performance.now() - startTime) / 1000;
-        standardMetrics.httpDuration.record(duration, {
-          method,
-          path,
-          status: response.status.toString()
-        });
-        emitTelemetrySample({
-          req,
-          res: response,
-          span,
-          success: true,
-          durationMs: duration * 1000,
-          options
-        });
-        return response;
-      } catch (error) {
-        standardMetrics.operationErrors.add(1, { method, path });
-        emitTelemetrySample({
-          req,
-          span,
-          success: false,
-          durationMs: performance.now() - startTime,
-          error,
-          options
-        });
-        throw error;
-      }
-    });
-  };
-}
-function emitTelemetrySample({
-  req,
-  res,
-  span,
-  success,
-  durationMs,
-  error,
-  options
-}) {
-  if (!options.onSample || !options.resolveOperation)
-    return;
-  const operation = options.resolveOperation({ req, res });
-  if (!operation)
-    return;
-  const sample = {
-    operation,
-    durationMs,
-    success,
-    timestamp: new Date,
-    errorCode: !success && error instanceof Error ? error.name : success ? undefined : "unknown",
-    tenantId: options.tenantResolver?.(req),
-    actorId: options.actorResolver?.(req),
-    traceId: span.spanContext().traceId,
-    metadata: {
-      method: req.method,
-      path: new URL(req.url).pathname,
-      status: res?.status
-    }
-  };
-  options.onSample(sample);
-}
-
 // src/intent/aggregator.ts
 var DEFAULT_WINDOW_MS = 15 * 60 * 1000;
 
@@ -400,11 +165,11 @@ class IntentAggregator {
     const minTimestamp = now.getTime() - this.windowMs;
     const windowSamples = this.samples.filter((sample) => sample.timestamp.getTime() >= minTimestamp);
     this.samples.length = 0;
-    const metrics2 = this.aggregateMetrics(windowSamples);
+    const metrics = this.aggregateMetrics(windowSamples);
     const sequences = this.buildSequences(windowSamples);
     const timestamps = windowSamples.map((sample) => sample.timestamp.getTime());
     return {
-      metrics: metrics2,
+      metrics,
       sequences,
       sampleCount: windowSamples.length,
       windowStart: timestamps.length ? new Date(Math.min(...timestamps)) : undefined,
@@ -619,6 +384,68 @@ class IntentDetector {
   }
 }
 
+// src/logging/index.ts
+import { context, trace } from "@opentelemetry/api";
+
+class Logger {
+  serviceName;
+  constructor(serviceName) {
+    this.serviceName = serviceName;
+  }
+  log(level, message, meta = {}) {
+    const span = trace.getSpan(context.active());
+    const traceId = span?.spanContext().traceId;
+    const spanId = span?.spanContext().spanId;
+    const entry = {
+      timestamp: new Date().toISOString(),
+      service: this.serviceName,
+      level,
+      message,
+      traceId,
+      spanId,
+      ...meta
+    };
+    console.log(JSON.stringify(entry));
+  }
+  debug(message, meta) {
+    this.log("debug", message, meta);
+  }
+  info(message, meta) {
+    this.log("info", message, meta);
+  }
+  warn(message, meta) {
+    this.log("warn", message, meta);
+  }
+  error(message, meta) {
+    this.log("error", message, meta);
+  }
+}
+var logger = new Logger(process.env.OTEL_SERVICE_NAME || "unknown-service");
+
+// src/metrics/index.ts
+import {
+  metrics
+} from "@opentelemetry/api";
+var DEFAULT_METER_NAME = "@contractspec/lib.observability";
+function getMeter(name = DEFAULT_METER_NAME) {
+  return metrics.getMeter(name);
+}
+function createCounter(name, description, meterName) {
+  return getMeter(meterName).createCounter(name, { description });
+}
+function createUpDownCounter(name, description, meterName) {
+  return getMeter(meterName).createUpDownCounter(name, { description });
+}
+function createHistogram(name, description, meterName) {
+  return getMeter(meterName).createHistogram(name, { description });
+}
+var standardMetrics = {
+  httpRequests: createCounter("http_requests_total", "Total HTTP requests"),
+  httpDuration: createHistogram("http_request_duration_seconds", "HTTP request duration"),
+  operationErrors: createCounter("operation_errors_total", "Total operation errors"),
+  workflowDuration: createHistogram("workflow_duration_seconds", "Workflow execution duration")
+};
+
 // src/pipeline/evolution-pipeline.ts
 import { EventEmitter } from "node:events";
 class EvolutionPipeline {
@@ -726,71 +553,41 @@ class LifecycleKpiPipeline {
     if (previous !== undefined) {
       this.stageUpDownCounter.add(-1, {
         stage: getStageLabel(previous),
-        tenantId
-      });
-    }
-    this.stageUpDownCounter.add(1, { stage: getStageLabel(stage), tenantId });
-    this.currentStageByTenant.set(tenantId, stage);
-    this.emitter.emit("event", {
-      type: "stage.changed",
-      payload: { tenantId, previousStage: previous, nextStage: stage }
-    });
-  }
-}
-
-// src/telemetry/posthog-telemetry.ts
-class PosthogTelemetryProvider {
-  provider;
-  eventPrefix;
-  includeMetadata;
-  constructor(provider, options = {}) {
-    this.provider = provider;
-    this.eventPrefix = options.eventPrefix ?? "observability";
-    this.includeMetadata = options.includeMetadata ?? false;
-  }
-  async captureSample(sample) {
-    await this.provider.capture({
-      distinctId: sample.actorId ?? sample.tenantId ?? "unknown",
-      event: `${this.eventPrefix}.operation`,
-      timestamp: sample.timestamp,
-      properties: {
-        operation: sample.operation.name,
-        version: sample.operation.version,
-        durationMs: sample.durationMs,
-        success: sample.success,
-        errorCode: sample.errorCode ?? null,
-        tenantId: sample.tenantId ?? null,
-        traceId: sample.traceId ?? null,
-        ...this.includeMetadata && sample.metadata ? { metadata: sample.metadata } : {}
-      }
+        tenantId
+      });
+    }
+    this.stageUpDownCounter.add(1, { stage: getStageLabel(stage), tenantId });
+    this.currentStageByTenant.set(tenantId, stage);
+    this.emitter.emit("event", {
+      type: "stage.changed",
+      payload: { tenantId, previousStage: previous, nextStage: stage }
     });
   }
-  async captureSnapshot(snapshot) {
+}
+
+// src/telemetry/model-selection-telemetry.ts
+class ModelSelectionTelemetry {
+  provider;
+  eventName;
+  constructor(provider, options) {
+    this.provider = provider;
+    this.eventName = options?.eventName ?? "$model_selection";
+  }
+  async trackSelection(distinctId, properties) {
     await this.provider.capture({
-      distinctId: "system",
-      event: `${this.eventPrefix}.window`,
-      timestamp: snapshot.windowEnd ?? new Date,
+      distinctId,
+      event: this.eventName,
+      timestamp: new Date,
       properties: {
-        sampleCount: snapshot.sampleCount,
-        metricsCount: snapshot.metrics.length,
-        sequencesCount: snapshot.sequences.length,
-        windowStart: snapshot.windowStart?.toISOString() ?? null,
-        windowEnd: snapshot.windowEnd?.toISOString() ?? null,
-        ...this.includeMetadata ? {
-          metrics: snapshot.metrics.map((metric) => ({
-            operation: metric.operation.name,
-            version: metric.operation.version,
-            totalCalls: metric.totalCalls,
-            successRate: metric.successRate,
-            errorRate: metric.errorRate,
-            averageLatencyMs: metric.averageLatencyMs,
-            p95LatencyMs: metric.p95LatencyMs,
-            p99LatencyMs: metric.p99LatencyMs,
-            maxLatencyMs: metric.maxLatencyMs,
-            topErrors: metric.topErrors
-          })),
-          sequences: snapshot.sequences
-        } : {}
+        $model_id: properties.modelId,
+        $model_provider: properties.providerKey,
+        $model_score: properties.score,
+        $model_dimension: properties.dimension ?? null,
+        $model_reason: properties.reason,
+        $model_alternatives_count: properties.alternativesCount,
+        $model_cost_estimate_input: properties.costEstimateInput ?? null,
+        $model_cost_estimate_output: properties.costEstimateOutput ?? null,
+        $model_selection_duration_ms: properties.selectionDurationMs ?? null
       }
     });
   }
@@ -1101,6 +898,209 @@ function toDate(value) {
 function isRecord(value) {
   return typeof value === "object" && value !== null;
 }
+
+// src/telemetry/posthog-telemetry.ts
+class PosthogTelemetryProvider {
+  provider;
+  eventPrefix;
+  includeMetadata;
+  constructor(provider, options = {}) {
+    this.provider = provider;
+    this.eventPrefix = options.eventPrefix ?? "observability";
+    this.includeMetadata = options.includeMetadata ?? false;
+  }
+  async captureSample(sample) {
+    await this.provider.capture({
+      distinctId: sample.actorId ?? sample.tenantId ?? "unknown",
+      event: `${this.eventPrefix}.operation`,
+      timestamp: sample.timestamp,
+      properties: {
+        operation: sample.operation.name,
+        version: sample.operation.version,
+        durationMs: sample.durationMs,
+        success: sample.success,
+        errorCode: sample.errorCode ?? null,
+        tenantId: sample.tenantId ?? null,
+        traceId: sample.traceId ?? null,
+        ...this.includeMetadata && sample.metadata ? { metadata: sample.metadata } : {}
+      }
+    });
+  }
+  async captureSnapshot(snapshot) {
+    await this.provider.capture({
+      distinctId: "system",
+      event: `${this.eventPrefix}.window`,
+      timestamp: snapshot.windowEnd ?? new Date,
+      properties: {
+        sampleCount: snapshot.sampleCount,
+        metricsCount: snapshot.metrics.length,
+        sequencesCount: snapshot.sequences.length,
+        windowStart: snapshot.windowStart?.toISOString() ?? null,
+        windowEnd: snapshot.windowEnd?.toISOString() ?? null,
+        ...this.includeMetadata ? {
+          metrics: snapshot.metrics.map((metric) => ({
+            operation: metric.operation.name,
+            version: metric.operation.version,
+            totalCalls: metric.totalCalls,
+            successRate: metric.successRate,
+            errorRate: metric.errorRate,
+            averageLatencyMs: metric.averageLatencyMs,
+            p95LatencyMs: metric.p95LatencyMs,
+            p99LatencyMs: metric.p99LatencyMs,
+            maxLatencyMs: metric.maxLatencyMs,
+            topErrors: metric.topErrors
+          })),
+          sequences: snapshot.sequences
+        } : {}
+      }
+    });
+  }
+}
+
+// src/tracing/core.ts
+import {
+  SpanStatusCode,
+  trace as trace2
+} from "@opentelemetry/api";
+var DEFAULT_TRACER_NAME = "@contractspec/lib.observability";
+function getTracer(name = DEFAULT_TRACER_NAME) {
+  return trace2.getTracer(name);
+}
+async function traceAsync(name, fn, tracerName) {
+  const tracer = getTracer(tracerName);
+  return tracer.startActiveSpan(name, async (span) => {
+    try {
+      const result = await fn(span);
+      span.setStatus({ code: SpanStatusCode.OK });
+      return result;
+    } catch (error) {
+      span.recordException(error);
+      span.setStatus({
+        code: SpanStatusCode.ERROR,
+        message: error instanceof Error ? error.message : String(error)
+      });
+      throw error;
+    } finally {
+      span.end();
+    }
+  });
+}
+function traceSync(name, fn, tracerName) {
+  const tracer = getTracer(tracerName);
+  return tracer.startActiveSpan(name, (span) => {
+    try {
+      const result = fn(span);
+      span.setStatus({ code: SpanStatusCode.OK });
+      return result;
+    } catch (error) {
+      span.recordException(error);
+      span.setStatus({
+        code: SpanStatusCode.ERROR,
+        message: error instanceof Error ? error.message : String(error)
+      });
+      throw error;
+    } finally {
+      span.end();
+    }
+  });
+}
+
+// src/tracing/model-selection.span.ts
+async function traceModelSelection(fn, input) {
+  const startMs = performance.now();
+  return traceAsync("model.selection", async (span) => {
+    const result = await fn();
+    const durationMs = performance.now() - startMs;
+    span.setAttribute("model.selected", input.modelId);
+    span.setAttribute("model.provider", input.providerKey);
+    span.setAttribute("model.score", input.score);
+    span.setAttribute("model.alternatives_count", input.alternativesCount);
+    span.setAttribute("model.selection_duration_ms", durationMs);
+    span.setAttribute("model.reason", input.reason);
+    if (input.dimension) {
+      span.setAttribute("model.dimension", input.dimension);
+    }
+    if (input.constraints) {
+      span.setAttribute("model.constraints", JSON.stringify(input.constraints));
+    }
+    return result;
+  });
+}
+// src/tracing/middleware.ts
+function createTracingMiddleware(options = {}) {
+  return async (req, next) => {
+    const method = req.method;
+    const url = new URL(req.url);
+    const path = url.pathname;
+    standardMetrics.httpRequests.add(1, { method, path });
+    const startTime = performance.now();
+    return traceAsync(`HTTP ${method} ${path}`, async (span) => {
+      span.setAttribute("http.method", method);
+      span.setAttribute("http.url", req.url);
+      try {
+        const response = await next();
+        span.setAttribute("http.status_code", response.status);
+        const duration = (performance.now() - startTime) / 1000;
+        standardMetrics.httpDuration.record(duration, {
+          method,
+          path,
+          status: response.status.toString()
+        });
+        emitTelemetrySample({
+          req,
+          res: response,
+          span,
+          success: true,
+          durationMs: duration * 1000,
+          options
+        });
+        return response;
+      } catch (error) {
+        standardMetrics.operationErrors.add(1, { method, path });
+        emitTelemetrySample({
+          req,
+          span,
+          success: false,
+          durationMs: performance.now() - startTime,
+          error,
+          options
+        });
+        throw error;
+      }
+    });
+  };
+}
+function emitTelemetrySample({
+  req,
+  res,
+  span,
+  success,
+  durationMs,
+  error,
+  options
+}) {
+  if (!options.onSample || !options.resolveOperation)
+    return;
+  const operation = options.resolveOperation({ req, res });
+  if (!operation)
+    return;
+  const sample = {
+    operation,
+    durationMs,
+    success,
+    timestamp: new Date,
+    errorCode: !success && error instanceof Error ? error.name : success ? undefined : "unknown",
+    tenantId: options.tenantResolver?.(req),
+    actorId: options.actorResolver?.(req),
+    traceId: span.spanContext().traceId,
+    metadata: {
+      method: req.method,
+      path: new URL(req.url).pathname,
+      status: res?.status
+    }
+  };
+  options.onSample(sample);
+}
 export {
   traceSync,
   traceModelSelection,

package/dist/node/logging/index.js

@@ -1,5 +1,5 @@
 // src/logging/index.ts
-import { trace, context } from "@opentelemetry/api";
+import { context, trace } from "@opentelemetry/api";
 
 class Logger {
   serviceName;

package/dist/node/tracing/middleware.js

@@ -1,3 +1,27 @@
+// src/metrics/index.ts
+import {
+  metrics
+} from "@opentelemetry/api";
+var DEFAULT_METER_NAME = "@contractspec/lib.observability";
+function getMeter(name = DEFAULT_METER_NAME) {
+  return metrics.getMeter(name);
+}
+function createCounter(name, description, meterName) {
+  return getMeter(meterName).createCounter(name, { description });
+}
+function createUpDownCounter(name, description, meterName) {
+  return getMeter(meterName).createUpDownCounter(name, { description });
+}
+function createHistogram(name, description, meterName) {
+  return getMeter(meterName).createHistogram(name, { description });
+}
+var standardMetrics = {
+  httpRequests: createCounter("http_requests_total", "Total HTTP requests"),
+  httpDuration: createHistogram("http_request_duration_seconds", "HTTP request duration"),
+  operationErrors: createCounter("operation_errors_total", "Total operation errors"),
+  workflowDuration: createHistogram("workflow_duration_seconds", "Workflow execution duration")
+};
+
 // src/tracing/core.ts
 import {
   SpanStatusCode,
@@ -67,30 +91,6 @@ async function traceModelSelection(fn, input) {
     return result;
   });
 }
-// src/metrics/index.ts
-import {
-  metrics
-} from "@opentelemetry/api";
-var DEFAULT_METER_NAME = "@contractspec/lib.observability";
-function getMeter(name = DEFAULT_METER_NAME) {
-  return metrics.getMeter(name);
-}
-function createCounter(name, description, meterName) {
-  return getMeter(meterName).createCounter(name, { description });
-}
-function createUpDownCounter(name, description, meterName) {
-  return getMeter(meterName).createUpDownCounter(name, { description });
-}
-function createHistogram(name, description, meterName) {
-  return getMeter(meterName).createHistogram(name, { description });
-}
-var standardMetrics = {
-  httpRequests: createCounter("http_requests_total", "Total HTTP requests"),
-  httpDuration: createHistogram("http_request_duration_seconds", "HTTP request duration"),
-  operationErrors: createCounter("operation_errors_total", "Total operation errors"),
-  workflowDuration: createHistogram("workflow_duration_seconds", "Workflow execution duration")
-};
-
 // src/tracing/middleware.ts
 function createTracingMiddleware(options = {}) {
   return async (req, next) => {