@contractspec/lib.observability 3.7.16 → 3.7.18

package/dist/node/pipeline/lifecycle-pipeline.js

@@ -1,85 +1 @@
-// 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/lifecycle-pipeline.ts
-import { EventEmitter } from "node:events";
-import { getStageLabel } from "@contractspec/lib.lifecycle";
-class LifecycleKpiPipeline {
-  assessmentCounter;
-  confidenceHistogram;
-  stageUpDownCounter;
-  emitter;
-  lowConfidenceThreshold;
-  currentStageByTenant = new Map;
-  constructor(options = {}) {
-    const meterName = options.meterName ?? "@contractspec/lib.lifecycle-kpi";
-    this.assessmentCounter = createCounter("lifecycle_assessments_total", "Total lifecycle assessments", meterName);
-    this.confidenceHistogram = createHistogram("lifecycle_assessment_confidence", "Lifecycle assessment confidence distribution", meterName);
-    this.stageUpDownCounter = createUpDownCounter("lifecycle_stage_tenants", "Current tenants per lifecycle stage", meterName);
-    this.emitter = options.emitter ?? new EventEmitter;
-    this.lowConfidenceThreshold = options.lowConfidenceThreshold ?? 0.4;
-  }
-  recordAssessment(assessment, tenantId) {
-    const stageLabel = getStageLabel(assessment.stage);
-    const attributes = { stage: stageLabel, tenantId };
-    this.assessmentCounter.add(1, attributes);
-    this.confidenceHistogram.record(assessment.confidence, attributes);
-    this.ensureStageCounters(assessment.stage, tenantId);
-    this.emitter.emit("event", {
-      type: "assessment.recorded",
-      payload: { tenantId, stage: assessment.stage }
-    });
-    if (assessment.confidence < this.lowConfidenceThreshold) {
-      this.emitter.emit("event", {
-        type: "confidence.low",
-        payload: { tenantId, confidence: assessment.confidence }
-      });
-    }
-  }
-  on(listener) {
-    this.emitter.on("event", listener);
-  }
-  ensureStageCounters(stage, tenantId) {
-    if (!tenantId)
-      return;
-    const previous = this.currentStageByTenant.get(tenantId);
-    if (previous === stage)
-      return;
-    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 }
-    });
-  }
-}
-export {
-  LifecycleKpiPipeline
-};
+import{metrics as l}from"@opentelemetry/api";var p="@contractspec/lib.observability";function o(e=p){return l.getMeter(e)}function n(e,t,r){return o(r).createCounter(e,{description:t})}function a(e,t,r){return o(r).createUpDownCounter(e,{description:t})}function i(e,t,r){return o(r).createHistogram(e,{description:t})}var d={httpRequests:n("http_requests_total","Total HTTP requests"),httpDuration:i("http_request_duration_seconds","HTTP request duration"),operationErrors:n("operation_errors_total","Total operation errors"),workflowDuration:i("workflow_duration_seconds","Workflow execution duration")};import{EventEmitter as f}from"node:events";import{getStageLabel as s}from"@contractspec/lib.lifecycle";class g{assessmentCounter;confidenceHistogram;stageUpDownCounter;emitter;lowConfidenceThreshold;currentStageByTenant=new Map;constructor(e={}){let t=e.meterName??"@contractspec/lib.lifecycle-kpi";this.assessmentCounter=n("lifecycle_assessments_total","Total lifecycle assessments",t),this.confidenceHistogram=i("lifecycle_assessment_confidence","Lifecycle assessment confidence distribution",t),this.stageUpDownCounter=a("lifecycle_stage_tenants","Current tenants per lifecycle stage",t),this.emitter=e.emitter??new f,this.lowConfidenceThreshold=e.lowConfidenceThreshold??0.4}recordAssessment(e,t){let c={stage:s(e.stage),tenantId:t};if(this.assessmentCounter.add(1,c),this.confidenceHistogram.record(e.confidence,c),this.ensureStageCounters(e.stage,t),this.emitter.emit("event",{type:"assessment.recorded",payload:{tenantId:t,stage:e.stage}}),e.confidence<this.lowConfidenceThreshold)this.emitter.emit("event",{type:"confidence.low",payload:{tenantId:t,confidence:e.confidence}})}on(e){this.emitter.on("event",e)}ensureStageCounters(e,t){if(!t)return;let r=this.currentStageByTenant.get(t);if(r===e)return;if(r!==void 0)this.stageUpDownCounter.add(-1,{stage:s(r),tenantId:t});this.stageUpDownCounter.add(1,{stage:s(e),tenantId:t}),this.currentStageByTenant.set(t,e),this.emitter.emit("event",{type:"stage.changed",payload:{tenantId:t,previousStage:r,nextStage:e}})}}export{g as LifecycleKpiPipeline};

package/dist/node/telemetry/model-selection-telemetry.js

@@ -1,30 +1 @@
-// 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
-      }
-    });
-  }
-}
-export {
-  ModelSelectionTelemetry
-};
+class x{provider;eventName;constructor(q,j){this.provider=q,this.eventName=j?.eventName??"$model_selection"}async trackSelection(q,j){await this.provider.capture({distinctId:q,event:this.eventName,timestamp:new Date,properties:{$model_id:j.modelId,$model_provider:j.providerKey,$model_score:j.score,$model_dimension:j.dimension??null,$model_reason:j.reason,$model_alternatives_count:j.alternativesCount,$model_cost_estimate_input:j.costEstimateInput??null,$model_cost_estimate_output:j.costEstimateOutput??null,$model_selection_duration_ms:j.selectionDurationMs??null}})}}export{x as ModelSelectionTelemetry};

package/dist/node/telemetry/posthog-baseline-reader.js

@@ -1,308 +1,5 @@
-// src/telemetry/posthog-baseline-reader.ts
-class PosthogBaselineReader {
-  reader;
-  eventPrefix;
-  constructor(reader, options = {}) {
-    this.reader = reader;
-    this.eventPrefix = options.eventPrefix ?? "observability";
-  }
-  async readSamples(input) {
-    const result = await this.queryHogQL({
-      query: [
-        "select",
-        "  properties.operation as operationName,",
-        "  properties.version as version,",
-        "  properties.durationMs as durationMs,",
-        "  properties.success as success,",
-        "  properties.errorCode as errorCode,",
-        "  properties.tenantId as tenantId,",
-        "  properties.traceId as traceId,",
-        "  properties.metadata as metadata,",
-        "  distinct_id as actorId,",
-        "  timestamp as timestamp",
-        "from events",
-        `where ${buildOperationWhereClause(this.eventPrefix, input)}`,
-        "order by timestamp desc",
-        `limit ${input.limit ?? 1000}`
-      ].join(`
-`),
-      values: buildOperationValues(input)
-    });
-    return mapTelemetrySamples(result);
-  }
-  async readAggregatedMetrics(operation, windowDays = 7) {
-    const dateRange = buildWindowRange(windowDays);
-    const result = await this.queryHogQL({
-      query: [
-        "select",
-        "  count() as totalCalls,",
-        "  avg(properties.durationMs) as averageLatencyMs,",
-        "  quantile(0.95)(properties.durationMs) as p95LatencyMs,",
-        "  quantile(0.99)(properties.durationMs) as p99LatencyMs,",
-        "  max(properties.durationMs) as maxLatencyMs,",
-        "  sum(if(properties.success = 1, 1, 0)) as successCount,",
-        "  sum(if(properties.success = 0, 1, 0)) as errorCount",
-        "from events",
-        `where ${buildOperationWhereClause(this.eventPrefix, {
-          operations: [operation],
-          dateRange
-        })}`
-      ].join(`
-`),
-      values: buildOperationValues({
-        operations: [operation],
-        dateRange
-      })
-    });
-    const stats = mapAggregatedMetrics(result, operation, dateRange);
-    if (!stats)
-      return null;
-    const topErrors = await this.readTopErrors(operation, dateRange);
-    return {
-      ...stats,
-      topErrors
-    };
-  }
-  async readOperationSequences(dateRange) {
-    const result = await this.queryHogQL({
-      query: [
-        "select",
-        "  properties.sequences as sequences",
-        "from events",
-        `where event = {eventName}`,
-        dateRange?.from ? "and timestamp >= {dateFrom}" : "",
-        dateRange?.to ? "and timestamp < {dateTo}" : "",
-        "order by timestamp desc",
-        "limit 50"
-      ].filter(Boolean).join(`
-`),
-      values: {
-        eventName: `${this.eventPrefix}.window`,
-        dateFrom: toIsoString(dateRange?.from),
-        dateTo: toIsoString(dateRange?.to)
-      }
-    });
-    return mergeSequences(result);
-  }
-  async readTopErrors(operation, dateRange) {
-    const result = await this.queryHogQL({
-      query: [
-        "select",
-        "  properties.errorCode as errorCode,",
-        "  count() as errorCount",
-        "from events",
-        `where ${buildOperationWhereClause(this.eventPrefix, {
-          operations: [operation],
-          dateRange
-        })} and properties.success = 0`,
-        "group by errorCode",
-        "order by errorCount desc",
-        "limit 5"
-      ].join(`
-`),
-      values: buildOperationValues({
-        operations: [operation],
-        dateRange
-      })
-    });
-    const rows = mapRows(result);
-    return rows.reduce((acc, row) => {
-      const code = asString(row.errorCode);
-      if (!code)
-        return acc;
-      acc[code] = asNumber(row.errorCount);
-      return acc;
-    }, {});
-  }
-  async queryHogQL(input) {
-    if (!this.reader.queryHogQL) {
-      throw new Error("Analytics reader does not support HogQL queries.");
-    }
-    return this.reader.queryHogQL(input);
-  }
-}
-function buildOperationWhereClause(eventPrefix, input) {
-  const clauses = [`event = '${eventPrefix}.operation'`];
-  if (input.operations?.length) {
-    clauses.push(`(${buildOperationFilters(input.operations)})`);
-  }
-  if (input.dateRange?.from) {
-    clauses.push("timestamp >= {dateFrom}");
-  }
-  if (input.dateRange?.to) {
-    clauses.push("timestamp < {dateTo}");
-  }
-  return clauses.join(" and ");
-}
-function buildOperationValues(input) {
-  const values = {
-    dateFrom: toIsoString(input.dateRange?.from),
-    dateTo: toIsoString(input.dateRange?.to)
-  };
-  input.operations?.forEach((op, index) => {
-    values[`operationName${index}`] = op.name;
-    values[`operationVersion${index}`] = op.version;
-  });
-  return values;
-}
-function buildOperationFilters(operations) {
-  return operations.map((_op, index) => `(properties.operation = {operationName${index}} and properties.version = {operationVersion${index}})`).join(" or ");
-}
-function mapTelemetrySamples(result) {
-  const rows = mapRows(result);
-  return rows.flatMap((row) => {
-    const operationName = asString(row.operationName);
-    const version = asString(row.version);
-    const timestamp = asDate(row.timestamp);
-    if (!operationName || !version || !timestamp) {
-      return [];
-    }
-    return [
-      {
-        operation: { name: operationName, version },
-        durationMs: asNumber(row.durationMs),
-        success: asBoolean(row.success),
-        timestamp,
-        errorCode: asOptionalString(row.errorCode) ?? undefined,
-        tenantId: asOptionalString(row.tenantId) ?? undefined,
-        traceId: asOptionalString(row.traceId) ?? undefined,
-        actorId: asOptionalString(row.actorId) ?? undefined,
-        metadata: isRecord(row.metadata) ? row.metadata : undefined
-      }
-    ];
-  });
-}
-function mapAggregatedMetrics(result, operation, dateRange) {
-  const rows = mapRows(result);
-  const row = rows[0];
-  if (!row)
-    return null;
-  const totalCalls = asNumber(row.totalCalls);
-  if (!totalCalls)
-    return null;
-  const successCount = asNumber(row.successCount);
-  const errorCount = asNumber(row.errorCount);
-  const windowStart = toDate(dateRange.from) ?? new Date;
-  const windowEnd = toDate(dateRange.to) ?? new Date;
-  return {
-    operation,
-    totalCalls,
-    successRate: totalCalls ? successCount / totalCalls : 0,
-    errorRate: totalCalls ? errorCount / totalCalls : 0,
-    averageLatencyMs: asNumber(row.averageLatencyMs),
-    p95LatencyMs: asNumber(row.p95LatencyMs),
-    p99LatencyMs: asNumber(row.p99LatencyMs),
-    maxLatencyMs: asNumber(row.maxLatencyMs),
-    windowStart,
-    windowEnd,
-    topErrors: {}
-  };
-}
-function mergeSequences(result) {
-  const rows = mapRows(result);
-  const merged = new Map;
-  rows.forEach((row) => {
-    const sequences = row.sequences;
-    if (!Array.isArray(sequences))
-      return;
-    sequences.forEach((sequence) => {
-      if (!isRecord(sequence))
-        return;
-      const steps = Array.isArray(sequence.steps) ? sequence.steps.filter((step) => typeof step === "string") : [];
-      if (steps.length === 0)
-        return;
-      const tenantId = typeof sequence.tenantId === "string" ? sequence.tenantId : undefined;
-      const count = typeof sequence.count === "number" && Number.isFinite(sequence.count) ? sequence.count : 0;
-      const key = `${tenantId ?? "global"}:${steps.join(">")}`;
-      const existing = merged.get(key);
-      if (existing) {
-        existing.count += count;
-      } else {
-        merged.set(key, { steps, tenantId, count });
-      }
-    });
-  });
-  return [...merged.values()];
-}
-function mapRows(result) {
-  if (!Array.isArray(result.results) || !Array.isArray(result.columns)) {
-    return [];
-  }
-  const columns = result.columns;
-  return result.results.flatMap((row) => {
-    if (!Array.isArray(row))
-      return [];
-    const record = {};
-    columns.forEach((column, index) => {
-      record[column] = row[index];
-    });
-    return [record];
-  });
-}
-function buildWindowRange(windowDays) {
-  const windowEnd = new Date;
-  const windowStart = new Date(windowEnd.getTime() - windowDays * 24 * 60 * 60 * 1000);
-  return {
-    from: windowStart,
-    to: windowEnd
-  };
-}
-function asString(value) {
-  if (typeof value === "string" && value.trim())
-    return value;
-  if (typeof value === "number")
-    return String(value);
-  return null;
-}
-function asOptionalString(value) {
-  if (typeof value === "string")
-    return value;
-  if (typeof value === "number")
-    return String(value);
-  return null;
-}
-function asNumber(value) {
-  if (typeof value === "number" && Number.isFinite(value))
-    return value;
-  if (typeof value === "string" && value.trim()) {
-    const parsed = Number(value);
-    if (Number.isFinite(parsed))
-      return parsed;
-  }
-  return 0;
-}
-function asBoolean(value) {
-  if (typeof value === "boolean")
-    return value;
-  if (typeof value === "number")
-    return value !== 0;
-  if (typeof value === "string")
-    return value.toLowerCase() === "true";
-  return false;
-}
-function asDate(value) {
-  if (value instanceof Date)
-    return value;
-  if (typeof value === "string" || typeof value === "number") {
-    const date = new Date(value);
-    if (!Number.isNaN(date.getTime()))
-      return date;
-  }
-  return null;
-}
-function toIsoString(value) {
-  if (!value)
-    return;
-  return typeof value === "string" ? value : value.toISOString();
-}
-function toDate(value) {
-  if (!value)
-    return null;
-  return value instanceof Date ? value : new Date(value);
-}
-function isRecord(value) {
-  return typeof value === "object" && value !== null;
-}
-export {
-  PosthogBaselineReader
-};
+class M{reader;eventPrefix;constructor(e,r={}){this.reader=e,this.eventPrefix=r.eventPrefix??"observability"}async readSamples(e){let r=await this.queryHogQL({query:["select","  properties.operation as operationName,","  properties.version as version,","  properties.durationMs as durationMs,","  properties.success as success,","  properties.errorCode as errorCode,","  properties.tenantId as tenantId,","  properties.traceId as traceId,","  properties.metadata as metadata,","  distinct_id as actorId,","  timestamp as timestamp","from events",`where ${g(this.eventPrefix,e)}`,"order by timestamp desc",`limit ${e.limit??1000}`].join(`
+`),values:l(e)});return A(r)}async readAggregatedMetrics(e,r=7){let t=D(r),o=await this.queryHogQL({query:["select","  count() as totalCalls,","  avg(properties.durationMs) as averageLatencyMs,","  quantile(0.95)(properties.durationMs) as p95LatencyMs,","  quantile(0.99)(properties.durationMs) as p99LatencyMs,","  max(properties.durationMs) as maxLatencyMs,","  sum(if(properties.success = 1, 1, 0)) as successCount,","  sum(if(properties.success = 0, 1, 0)) as errorCount","from events",`where ${g(this.eventPrefix,{operations:[e],dateRange:t})}`].join(`
+`),values:l({operations:[e],dateRange:t})}),s=S(o,e,t);if(!s)return null;let n=await this.readTopErrors(e,t);return{...s,topErrors:n}}async readOperationSequences(e){let r=await this.queryHogQL({query:["select","  properties.sequences as sequences","from events","where event = {eventName}",e?.from?"and timestamp >= {dateFrom}":"",e?.to?"and timestamp < {dateTo}":"","order by timestamp desc","limit 50"].filter(Boolean).join(`
+`),values:{eventName:`${this.eventPrefix}.window`,dateFrom:m(e?.from),dateTo:m(e?.to)}});return C(r)}async readTopErrors(e,r){let t=await this.queryHogQL({query:["select","  properties.errorCode as errorCode,","  count() as errorCount","from events",`where ${g(this.eventPrefix,{operations:[e],dateRange:r})} and properties.success = 0`,"group by errorCode","order by errorCount desc","limit 5"].join(`
+`),values:l({operations:[e],dateRange:r})});return f(t).reduce((s,n)=>{let a=y(n.errorCode);if(!a)return s;return s[a]=i(n.errorCount),s},{})}async queryHogQL(e){if(!this.reader.queryHogQL)throw Error("Analytics reader does not support HogQL queries.");return this.reader.queryHogQL(e)}}function g(e,r){let t=[`event = '${e}.operation'`];if(r.operations?.length)t.push(`(${I(r.operations)})`);if(r.dateRange?.from)t.push("timestamp >= {dateFrom}");if(r.dateRange?.to)t.push("timestamp < {dateTo}");return t.join(" and ")}function l(e){let r={dateFrom:m(e.dateRange?.from),dateTo:m(e.dateRange?.to)};return e.operations?.forEach((t,o)=>{r[`operationName${o}`]=t.name,r[`operationVersion${o}`]=t.version}),r}function I(e){return e.map((r,t)=>`(properties.operation = {operationName${t}} and properties.version = {operationVersion${t}})`).join(" or ")}function A(e){return f(e).flatMap((t)=>{let o=y(t.operationName),s=y(t.version),n=q(t.timestamp);if(!o||!s||!n)return[];return[{operation:{name:o,version:s},durationMs:i(t.durationMs),success:L(t.success),timestamp:n,errorCode:d(t.errorCode)??void 0,tenantId:d(t.tenantId)??void 0,traceId:d(t.traceId)??void 0,actorId:d(t.actorId)??void 0,metadata:b(t.metadata)?t.metadata:void 0}]})}function S(e,r,t){let s=f(e)[0];if(!s)return null;let n=i(s.totalCalls);if(!n)return null;let a=i(s.successCount),u=i(s.errorCount),c=R(t.from)??new Date,p=R(t.to)??new Date;return{operation:r,totalCalls:n,successRate:n?a/n:0,errorRate:n?u/n:0,averageLatencyMs:i(s.averageLatencyMs),p95LatencyMs:i(s.p95LatencyMs),p99LatencyMs:i(s.p99LatencyMs),maxLatencyMs:i(s.maxLatencyMs),windowStart:c,windowEnd:p,topErrors:{}}}function C(e){let r=f(e),t=new Map;return r.forEach((o)=>{let s=o.sequences;if(!Array.isArray(s))return;s.forEach((n)=>{if(!b(n))return;let a=Array.isArray(n.steps)?n.steps.filter((h)=>typeof h==="string"):[];if(a.length===0)return;let u=typeof n.tenantId==="string"?n.tenantId:void 0,c=typeof n.count==="number"&&Number.isFinite(n.count)?n.count:0,p=`${u??"global"}:${a.join(">")}`,w=t.get(p);if(w)w.count+=c;else t.set(p,{steps:a,tenantId:u,count:c})})}),[...t.values()]}function f(e){if(!Array.isArray(e.results)||!Array.isArray(e.columns))return[];let r=e.columns;return e.results.flatMap((t)=>{if(!Array.isArray(t))return[];let o={};return r.forEach((s,n)=>{o[s]=t[n]}),[o]})}function D(e){let r=new Date;return{from:new Date(r.getTime()-e*24*60*60*1000),to:r}}function y(e){if(typeof e==="string"&&e.trim())return e;if(typeof e==="number")return String(e);return null}function d(e){if(typeof e==="string")return e;if(typeof e==="number")return String(e);return null}function i(e){if(typeof e==="number"&&Number.isFinite(e))return e;if(typeof e==="string"&&e.trim()){let r=Number(e);if(Number.isFinite(r))return r}return 0}function L(e){if(typeof e==="boolean")return e;if(typeof e==="number")return e!==0;if(typeof e==="string")return e.toLowerCase()==="true";return!1}function q(e){if(e instanceof Date)return e;if(typeof e==="string"||typeof e==="number"){let r=new Date(e);if(!Number.isNaN(r.getTime()))return r}return null}function m(e){if(!e)return;return typeof e==="string"?e:e.toISOString()}function R(e){if(!e)return null;return e instanceof Date?e:new Date(e)}function b(e){return typeof e==="object"&&e!==null}export{M as PosthogBaselineReader};

package/dist/node/telemetry/posthog-telemetry.js

@@ -1,60 +1 @@
-// 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
-        } : {}
-      }
-    });
-  }
-}
-export {
-  PosthogTelemetryProvider
-};
+class r{provider;eventPrefix;includeMetadata;constructor(e,t={}){this.provider=e,this.eventPrefix=t.eventPrefix??"observability",this.includeMetadata=t.includeMetadata??!1}async captureSample(e){await this.provider.capture({distinctId:e.actorId??e.tenantId??"unknown",event:`${this.eventPrefix}.operation`,timestamp:e.timestamp,properties:{operation:e.operation.name,version:e.operation.version,durationMs:e.durationMs,success:e.success,errorCode:e.errorCode??null,tenantId:e.tenantId??null,traceId:e.traceId??null,...this.includeMetadata&&e.metadata?{metadata:e.metadata}:{}}})}async captureSnapshot(e){await this.provider.capture({distinctId:"system",event:`${this.eventPrefix}.window`,timestamp:e.windowEnd??new Date,properties:{sampleCount:e.sampleCount,metricsCount:e.metrics.length,sequencesCount:e.sequences.length,windowStart:e.windowStart?.toISOString()??null,windowEnd:e.windowEnd?.toISOString()??null,...this.includeMetadata?{metrics:e.metrics.map((t)=>({operation:t.operation.name,version:t.operation.version,totalCalls:t.totalCalls,successRate:t.successRate,errorRate:t.errorRate,averageLatencyMs:t.averageLatencyMs,p95LatencyMs:t.p95LatencyMs,p99LatencyMs:t.p99LatencyMs,maxLatencyMs:t.maxLatencyMs,topErrors:t.topErrors})),sequences:e.sequences}:{}}})}}export{r as PosthogTelemetryProvider};

package/dist/node/tracing/core.js

@@ -1,52 +1 @@
-// 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();
-    }
-  });
-}
-export {
-  traceSync,
-  traceAsync,
-  getTracer
-};
+import{SpanStatusCode as c,trace as i}from"@opentelemetry/api";var u="@contractspec/lib.observability";function o(e=u){return i.getTracer(e)}async function g(e,n,a){return o(a).startActiveSpan(e,async(t)=>{try{let r=await n(t);return t.setStatus({code:c.OK}),r}catch(r){throw t.recordException(r),t.setStatus({code:c.ERROR,message:r instanceof Error?r.message:String(r)}),r}finally{t.end()}})}function T(e,n,a){return o(a).startActiveSpan(e,(t)=>{try{let r=n(t);return t.setStatus({code:c.OK}),r}catch(r){throw t.recordException(r),t.setStatus({code:c.ERROR,message:r instanceof Error?r.message:String(r)}),r}finally{t.end()}})}export{T as traceSync,g as traceAsync,o as getTracer};

package/dist/node/tracing/index.js

@@ -1,75 +1 @@
-// 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;
-  });
-}
-export {
-  traceSync,
-  traceModelSelection,
-  traceAsync,
-  getTracer
-};
+import{SpanStatusCode as g,trace as m}from"@opentelemetry/api";var y="@contractspec/lib.observability";function E(o=y){return m.getTracer(o)}async function T(o,e,S){return E(S).startActiveSpan(o,async(t)=>{try{let r=await e(t);return t.setStatus({code:g.OK}),r}catch(r){throw t.recordException(r),t.setStatus({code:g.ERROR,message:r instanceof Error?r.message:String(r)}),r}finally{t.end()}})}function R(o,e,S){return E(S).startActiveSpan(o,(t)=>{try{let r=e(t);return t.setStatus({code:g.OK}),r}catch(r){throw t.recordException(r),t.setStatus({code:g.ERROR,message:r instanceof Error?r.message:String(r)}),r}finally{t.end()}})}async function a(o,e){let S=performance.now();return T("model.selection",async(c)=>{let t=await o(),r=performance.now()-S;if(c.setAttribute("model.selected",e.modelId),c.setAttribute("model.provider",e.providerKey),c.setAttribute("model.score",e.score),c.setAttribute("model.alternatives_count",e.alternativesCount),c.setAttribute("model.selection_duration_ms",r),c.setAttribute("model.reason",e.reason),e.dimension)c.setAttribute("model.dimension",e.dimension);if(e.constraints)c.setAttribute("model.constraints",JSON.stringify(e.constraints));return t})}export{R as traceSync,a as traceModelSelection,T as traceAsync,E as getTracer};