@adjudicate/observability 0.1.0

package/dist/ecosystem-telemetry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ecosystem-telemetry.js","sourceRoot":"","sources":["../src/ecosystem-telemetry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AAgKH,MAAM,QAAQ,GAAwC;IACpD,WAAW,EAAE,GAAG;IAChB,kBAAkB,EAAE,EAAE;IACtB,eAAe,EAAE,GAAG;IACpB,gBAAgB,EAAE,GAAG;IACrB,kBAAkB,EAAE,GAAG;IACvB,cAAc,EAAE,EAAE;CACnB,CAAC;AAEF,MAAM,QAAQ,GAAG,cAAuB,CAAC;AAEzC;;;;GAIG;AACH,MAAM,cAAc;IAEW;IADZ,GAAG,GAAG,IAAI,GAAG,EAAkB,CAAC;IACjD,YAA6B,GAAW;QAAX,QAAG,GAAH,GAAG,CAAQ;IAAG,CAAC;IAE5C,GAAG,CAAC,GAAW,EAAE,KAAK,GAAG,CAAC;QACxB,IAAI,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;YACtB,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC;YACpD,OAAO;QACT,CAAC;QACD,IAAI,IAAI,CAAC,GAAG,CAAC,IAAI,IAAI,IAAI,CAAC,GAAG,EAAE,CAAC;YAC9B,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC;YAC9D,OAAO;QACT,CAAC;QACD,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;IAC3B,CAAC;IAED,QAAQ;QACN,MAAM,GAAG,GAA2B,EAAE,CAAC;QACvC,MAAM,IAAI,GAAG,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;QACzC,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;YACvB,GAAG,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACpC,CAAC;QACD,OAAO,GAAG,CAAC;IACb,CAAC;CACF;AAED,MAAM,aAAa;IAGY;IAFZ,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IACzB,UAAU,GAAG,IAAI,cAAc,CAAC,EAAE,CAAC,CAAC;IACrD,YAA6B,GAAW;QAAX,QAAG,GAAH,GAAG,CAAQ;IAAG,CAAC;IAE5C,OAAO,CAAC,MAAc,EAAE,QAAgB;QACtC,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC;YAAE,OAAO;QAClC,IAAI,IAAI,CAAC,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,GAAG;YAAE,OAAO;QACvC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QACtB,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IAChC,CAAC;IAED,QAAQ;QACN,OAAO,IAAI,CAAC,UAAU,CAAC,QAAQ,EAAE,CAAC;IACpC,CAAC;CACF;AA4BD,MAAM,gBAAgB,GAAwC;IAC5D,mBAAmB;IACnB,yBAAyB;IACzB,mBAAmB;IACnB,yBAAyB;IACzB,mBAAmB;IACnB,qBAAqB;IACrB,mBAAmB;IACnB,uBAAuB;IACvB,yBAAyB;IACzB,wBAAwB;IACxB,wBAAwB;IACxB,6BAA6B;IAC7B,mBAAmB;IACnB,yBAAyB;CAC1B,CAAC;AAEF,MAAM,eAAe,GAAqC;IACxD,eAAe;IACf,gBAAgB;IAChB,WAAW;IACX,UAAU;IACV,UAAU;CACX,CAAC;AAEF,SAAS,gBAAgB;IACvB,MAAM,GAAG,GAAG,EAA8C,CAAC;IAC3D,KAAK,MAAM,KAAK,IAAI,gBAAgB;QAAE,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACrD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,SAAS,cAAc;IACrB,MAAM,GAAG,GAAG,EAA2C,CAAC;IACxD,KAAK,MAAM,OAAO,IAAI,eAAe;QAAE,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IACxD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,MAAM,UAAU,wBAAwB,CACtC,UAAqC,EAAE;IAEvC,MAAM,IAAI,GAAG,EAAE,GAAG,QAAQ,EAAE,GAAG,OAAO,EAAE,CAAC;IAEzC,IAAI,IAAI,GAAG,SAAS,EAAE,CAAC;IAEvB,SAAS,SAAS;QAChB,OAAO;YACL,KAAK,EAAE,IAAI,aAAa,CAAC,IAAI,CAAC,WAAW,CAAC;YAC1C,YAAY,EAAE,IAAI,cAAc,CAAC,EAAE,CAAC;YACpC,mBAAmB,EAAE,IAAI,cAAc,CAAC,CAAC,CAAC;YAC1C,aAAa,EAAE,IAAI,cAAc,CAAC,CAAC,CAAC;YACpC,aAAa,EAAE,IAAI,cAAc,CAAC,CAAC,CAAC;YACpC,YAAY,EAAE,IAAI,cAAc,CAAC,IAAI,CAAC,eAAe,CAAC;YACtD,eAAe,EAAE,IAAI,cAAc,CAAC,IAAI,CAAC,kBAAkB,CAAC;YAC5D,aAAa,EAAE,cAAc,EAAE;YAC/B,WAAW,EAAE,CAAC;YACd,cAAc,EAAE,IAAI,GAAG,EAAiD;YACxE,cAAc,EAAE,cAAc,EAAE;YAChC,gBAAgB,EAAE,IAAI,cAAc,CAAC,IAAI,CAAC,gBAAgB,CAAC;YAC3D,cAAc,EAAE,CAAC;YACjB,aAAa,EAAE,IAAI,cAAc,CAAC,IAAI,CAAC,cAAc,CAAC;YACtD,oBAAoB,EAAE,IAAI,cAAc,CAAC,IAAI,CAAC,cAAc,CAAC;YAC7D,YAAY,EAAE,IAAI,cAAc,CAAC,IAAI,CAAC,cAAc,CAAC;YACrD,SAAS,EAAE,gBAAgB,EAAE;YAC7B,aAAa,EAAE,CAAC;SACjB,CAAC;IACJ,CAAC;IAED,SAAS,cAAc;QACrB,OAAO;YACL,qBAAqB,EAAE,CAAC;YACxB,WAAW,EAAE,CAAC;YACd,aAAa,EAAE,CAAC;YAChB,aAAa,EAAE,CAAC;YAChB,oBAAoB,EAAE,CAAC;YACvB,YAAY,EAAE,CAAC;SAChB,CAAC;IACJ,CAAC;IAED,OAAO;QACL,uBAAuB,CAAC,MAAM,EAAE,QAAQ;YACtC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;QACvC,CAAC;QACD,mBAAmB,CAAC,WAAW;YAC7B,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,WAAW,IAAI,OAAO,CAAC,CAAC;QAChD,CAAC;QACD,gBAAgB,CAAC,OAAO;YACtB,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QAClC,CAAC;QACD,oBAAoB,CAAC,SAAS;YAC5B,IAAI,CAAC,mBAAmB,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QAC1C,CAAC;QACD,eAAe,CAAC,QAAQ;YACtB,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;YACtC,KAAK,MAAM,CAAC,IAAI,QAAQ,CAAC,KAAK,EAAE,CAAC;gBAC/B,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;YACvC,CAAC;YACD,IAAI,QAAQ,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;gBAC/B,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;YAC/C,CAAC;QACH,CAAC;QACD,cAAc,CAAC,OAAO;YACpB,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QACtC,CAAC;QACD,kBAAkB,CAAC,MAAM;YACvB,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;YAC7C,KAAK,MAAM,CAAC,IAAI,MAAM,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC;gBACtC,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;YACvC,CAAC;YACD,IAAI,MAAM,CAAC,QAAQ,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;gBACtC,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;YACtD,CAAC;QACH,CAAC;QACD,qBAAqB,CAAC,QAAQ;YAC5B,IAAI,CAAC,WAAW,EAAE,CAAC;YACnB,IAAI,CAAC,aAAa,CAAC,qBAAqB,CAAC,QAAQ,CAAC,CAAC,EAAE,CAAC;QACxD,CAAC;QACD,qBAAqB,CAAC,cAAc,EAAE,OAAO;YAC3C,IAAI,CAAC,cAAc,CAAC,OAAO,CAAC,EAAE,CAAC;YAC/B,IAAI,MAAM,GAAG,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;YACrD,IAAI,CAAC,MAAM,EAAE,CAAC;gBACZ,IAAI,IAAI,CAAC,cAAc,CAAC,IAAI,IAAI,IAAI,CAAC,kBAAkB,EAAE,CAAC;oBACxD,MAAM,GAAG,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;oBAC3C,IAAI,CAAC,MAAM,EAAE,CAAC;wBACZ,MAAM,GAAG,cAAc,EAAE,CAAC;wBAC1B,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;oBAC5C,CAAC;gBACH,CAAC;qBAAM,CAAC;oBACN,MAAM,GAAG,cAAc,EAAE,CAAC;oBAC1B,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,cAAc,EAAE,MAAM,CAAC,CAAC;gBAClD,CAAC;YACH,CAAC;YACD,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC;QACpB,CAAC;QACD,sBAAsB,CAAC,SAAS,EAAE,eAAe;YAC/C,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;YACrC,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC;gBACpC,IAAI,CAAC,cAAc,EAAE,CAAC;YACxB,CAAC;QACH,CAAC;QACD,cAAc,CAAC,IAAI,EAAE,OAAO;YAC1B,IAAI,OAAO,KAAK,SAAS;gBAAE,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YACxD,IAAI,OAAO,KAAK,UAAU;gBAAE,IAAI,CAAC,oBAAoB,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YAChE,IAAI,OAAO,KAAK,MAAM;gBAAE,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACtD,CAAC;QACD,eAAe,CAAC,KAAK;YACnB,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC;YACxB,IAAI,CAAC,aAAa,EAAE,CAAC;QACvB,CAAC;QACD,QAAQ;YACN,MAAM,wBAAwB,GAA0D,EAAE,CAAC;YAC3F,MAAM,QAAQ,GAAG,CAAC,GAAG,IAAI,CAAC,cAAc,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;YACxD,KAAK,MAAM,GAAG,IAAI,QAAQ,EAAE,CAAC;gBAC3B,MAAM,KAAK,GAAG,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;gBAC3C,IAAI,KAAK,KAAK,SAAS;oBAAE,wBAAwB,CAAC,GAAG,CAAC,GAAG,EAAE,GAAG,KAAK,EAAE,CAAC;YACxE,CAAC;YACD,OAAO;gBACL,aAAa,EAAE,CAAC;gBAChB,IAAI,EAAE;oBACJ,eAAe,EAAE,IAAI,CAAC,KAAK,CAAC,QAAQ,EAAE;oBACtC,YAAY,EAAE,IAAI,CAAC,YAAY,CAAC,QAAQ,EAAE;oBAC1C,mBAAmB,EAAE,IAAI,CAAC,mBAAmB,CAAC,QAAQ,EAAE;oBACxD,aAAa,EAAE,IAAI,CAAC,aAAa,CAAC,QAAQ,EAAE;iBAC7C;gBACD,SAAS,EAAE;oBACT,MAAM,EAAE,IAAI,CAAC,aAAa,CAAC,QAAQ,EAAE;oBACrC,aAAa,EAAE,IAAI,CAAC,YAAY,CAAC,QAAQ,EAAE;oBAC3C,eAAe,EAAE,IAAI,CAAC,eAAe,CAAC,QAAQ,EAAE;iBACjD;gBACD,cAAc,EAAE;oBACd,OAAO,EAAE,EAAE,GAAG,IAAI,CAAC,aAAa,EAAE;oBAClC,KAAK,EAAE,IAAI,CAAC,WAAW;iBACxB;gBACD,cAAc,EAAE;oBACd,gBAAgB,EAAE,wBAAwB;oBAC1C,MAAM,EAAE,EAAE,GAAG,IAAI,CAAC,cAAc,EAAE;iBACnC;gBACD,eAAe,EAAE;oBACf,oBAAoB,EAAE,IAAI,CAAC,gBAAgB,CAAC,QAAQ,EAAE;oBACtD,qBAAqB,EAAE,IAAI,CAAC,cAAc;iBAC3C;gBACD,aAAa,EAAE;oBACb,aAAa,EAAE,IAAI,CAAC,aAAa,CAAC,QAAQ,EAAE;oBAC5C,oBAAoB,EAAE,IAAI,CAAC,oBAAoB,CAAC,QAAQ,EAAE;oBAC1D,YAAY,EAAE,IAAI,CAAC,YAAY,CAAC,QAAQ,EAAE;iBAC3C;gBACD,SAAS,EAAE;oBACT,OAAO,EAAE,EAAE,GAAG,IAAI,CAAC,SAAS,EAAE;oBAC9B,KAAK,EAAE,IAAI,CAAC,aAAa;iBAC1B;aACF,CAAC;QACJ,CAAC;QACD,KAAK;YACH,IAAI,GAAG,SAAS,EAAE,CAAC;QACrB,CAAC;KACF,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,qBAAqB,CAAC,QAAwB;IAC5D,IAAI,QAAQ,CAAC,IAAI,KAAK,eAAe;QAAE,OAAO,uBAAuB,CAAC;IACtE,IAAI,QAAQ,CAAC,IAAI,KAAK,oBAAoB;QAAE,OAAO,sBAAsB,CAAC;IAC1E,IAAI,QAAQ,CAAC,IAAI,KAAK,aAAa,EAAE,CAAC;QACpC,MAAM,OAAO,GAAG,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC,MAAM,IAAI,CAAC,CAAC;QACzD,MAAM,KAAK,GAAG,QAAQ,CAAC,UAAU,EAAE,KAAK,CAAC,MAAM,IAAI,CAAC,CAAC;QACrD,IAAI,OAAO,GAAG,CAAC,IAAI,KAAK,KAAK,CAAC;YAAE,OAAO,eAAe,CAAC;QACvD,IAAI,OAAO,KAAK,CAAC,IAAI,KAAK,GAAG,CAAC;YAAE,OAAO,aAAa,CAAC;QACrD,IAAI,OAAO,GAAG,CAAC,IAAI,KAAK,GAAG,CAAC;YAAE,OAAO,eAAe,CAAC;IACvD,CAAC;IACD,OAAO,cAAc,CAAC;AACxB,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,0BAA0B,CACxC,QAAoC;IAEpC,OAAO,aAAa,CAAC,QAAQ,CAAC,CAAC;AACjC,CAAC;AAED,SAAS,aAAa,CAAC,KAAc;IACnC,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAChD,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IAC/B,CAAC;IACD,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,IAAI,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC;IAC7D,CAAC;IACD,MAAM,GAAG,GAAG,KAAgC,CAAC;IAC7C,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;IACrC,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IAC/E,OAAO,IAAI,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC;AAChC,CAAC"}

package/dist/exporter.d.ts

@@ -0,0 +1,69 @@
+/**
+ * Exporter — the single seam through which `@adjudicate/observability` emits
+ * events. Consumers wire this to an OpenTelemetry-backed exporter (OTLP/proto,
+ * OTLP/http, the gRPC SDK) at boot. Tests inject `createInMemoryExporter()`.
+ *
+ * Why a custom interface rather than `@opentelemetry/sdk-trace-base`'s
+ * `SpanExporter` directly:
+ *
+ *   - Metrics, learning events, and audit spans share a single funnel. A
+ *     single `export(event)` keeps the three sinks behind a uniform contract
+ *     and lets adopters install one transport for the whole subsystem.
+ *
+ *   - The OpenTelemetry packages are not pinned by this package — we declare
+ *     `@opentelemetry/api ^1.9.0` as a runtime dep so consumers control the
+ *     trace/metric SDK choice. Pinning the full SDK here would force every
+ *     adopter onto our version.
+ *
+ *   - Kernel determinism is sacred. By funneling through this interface,
+ *     observability never reaches into the kernel — it only receives copies
+ *     of events the kernel already emitted via its existing sinks.
+ */
+import type { SEMCONV } from "./semconv.js";
+/**
+ * Event categories emitted by the three sinks. Carried as a discriminant so a
+ * single exporter can route per-kind (e.g. metrics → meter, spans → tracer).
+ */
+export type ExportedEventKind = "metrics.decision" | "metrics.refusal" | "metrics.ledger" | "metrics.sink_failure" | "metrics.shadow_divergence" | "metrics.resource_limit" | "learning.outcome" | "audit.span";
+/**
+ * One observability emission. Attributes carry the wire-shape an OTLP
+ * exporter would use; the `name` field is the metric name or span name.
+ * `body` is reserved for events with structured payloads (e.g., the full
+ * AuditRecord — exporters may strip or sample it).
+ */
+export interface ExportedEvent {
+    readonly kind: ExportedEventKind;
+    readonly name: string;
+    readonly at: string;
+    readonly attributes: Readonly<Record<(typeof SEMCONV)[keyof typeof SEMCONV] | string, string | number | boolean | undefined>>;
+    /** Optional structured body — present only on `audit.span` and `learning.outcome`. */
+    readonly body?: unknown;
+}
+/**
+ * The single seam. Implementations MUST NOT throw — observability is best-
+ * effort, never a customer outage. Synchronous so the kernel-adjacent sinks
+ * stay non-async; real OTLP transports buffer internally and flush off the
+ * hot path.
+ */
+export interface Exporter {
+    export(event: ExportedEvent): void;
+}
+/**
+ * In-memory test exporter. Captures every event into a mutable array so
+ * tests can assert "the right events were emitted with the right semconv
+ * attributes." Returned alongside its event buffer so the test doesn't
+ * have to read out of an opaque handle.
+ */
+export interface InMemoryExporter {
+    readonly exporter: Exporter;
+    readonly events: ExportedEvent[];
+}
+export declare function createInMemoryExporter(): InMemoryExporter;
+/**
+ * No-op exporter. Useful when an adopter wants to wire up the sinks early
+ * (e.g., during boot, before the OTLP transport is configured) without
+ * paying for any allocation. Production deployments should NOT install
+ * this — emission would be silent.
+ */
+export declare function noopExporter(): Exporter;
+//# sourceMappingURL=exporter.d.ts.map

package/dist/exporter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"exporter.d.ts","sourceRoot":"","sources":["../src/exporter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAE5C;;;GAGG;AACH,MAAM,MAAM,iBAAiB,GACzB,kBAAkB,GAClB,iBAAiB,GACjB,gBAAgB,GAChB,sBAAsB,GACtB,2BAA2B,GAC3B,wBAAwB,GACxB,kBAAkB,GAClB,YAAY,CAAC;AAEjB;;;;;GAKG;AACH,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,IAAI,EAAE,iBAAiB,CAAC;IACjC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,UAAU,EAAE,QAAQ,CAC3B,MAAM,CAAC,CAAC,OAAO,OAAO,CAAC,CAAC,MAAM,OAAO,OAAO,CAAC,GAAG,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,CAAC,CAC/F,CAAC;IACF,sFAAsF;IACtF,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC;CACzB;AAED;;;;;GAKG;AACH,MAAM,WAAW,QAAQ;IACvB,MAAM,CAAC,KAAK,EAAE,aAAa,GAAG,IAAI,CAAC;CACpC;AAED;;;;;GAKG;AACH,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;IAC5B,QAAQ,CAAC,MAAM,EAAE,aAAa,EAAE,CAAC;CAClC;AAED,wBAAgB,sBAAsB,IAAI,gBAAgB,CAQzD;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,IAAI,QAAQ,CAMvC"}

package/dist/exporter.js

@@ -0,0 +1,44 @@
+/**
+ * Exporter — the single seam through which `@adjudicate/observability` emits
+ * events. Consumers wire this to an OpenTelemetry-backed exporter (OTLP/proto,
+ * OTLP/http, the gRPC SDK) at boot. Tests inject `createInMemoryExporter()`.
+ *
+ * Why a custom interface rather than `@opentelemetry/sdk-trace-base`'s
+ * `SpanExporter` directly:
+ *
+ *   - Metrics, learning events, and audit spans share a single funnel. A
+ *     single `export(event)` keeps the three sinks behind a uniform contract
+ *     and lets adopters install one transport for the whole subsystem.
+ *
+ *   - The OpenTelemetry packages are not pinned by this package — we declare
+ *     `@opentelemetry/api ^1.9.0` as a runtime dep so consumers control the
+ *     trace/metric SDK choice. Pinning the full SDK here would force every
+ *     adopter onto our version.
+ *
+ *   - Kernel determinism is sacred. By funneling through this interface,
+ *     observability never reaches into the kernel — it only receives copies
+ *     of events the kernel already emitted via its existing sinks.
+ */
+export function createInMemoryExporter() {
+    const events = [];
+    const exporter = {
+        export(event) {
+            events.push(event);
+        },
+    };
+    return { exporter, events };
+}
+/**
+ * No-op exporter. Useful when an adopter wants to wire up the sinks early
+ * (e.g., during boot, before the OTLP transport is configured) without
+ * paying for any allocation. Production deployments should NOT install
+ * this — emission would be silent.
+ */
+export function noopExporter() {
+    return {
+        export() {
+            /* intentional no-op */
+        },
+    };
+}
+//# sourceMappingURL=exporter.js.map

package/dist/exporter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"exporter.js","sourceRoot":"","sources":["../src/exporter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAwDH,MAAM,UAAU,sBAAsB;IACpC,MAAM,MAAM,GAAoB,EAAE,CAAC;IACnC,MAAM,QAAQ,GAAa;QACzB,MAAM,CAAC,KAAK;YACV,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACrB,CAAC;KACF,CAAC;IACF,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC;AAC9B,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,YAAY;IAC1B,OAAO;QACL,MAAM;YACJ,uBAAuB;QACzB,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,40 @@
+/**
+ * @adjudicate/observability — OTLP-native sinks for the kernel's three
+ * telemetry surfaces (metrics, learning, audit).
+ *
+ * The package adapts the kernel's existing sink contracts (`MetricsSink`,
+ * `LearningSink`, `AuditSink`) onto a single `Exporter` interface that the
+ * adopter wires to an OpenTelemetry transport. The kernel itself is
+ * untouched — observability is OPTIONAL plumbing and MUST NEVER affect a
+ * Decision outcome. If the exporter throws, the sink swallows the error;
+ * if the exporter is misconfigured, telemetry is silent but adjudication
+ * still runs.
+ *
+ * # Why a custom Exporter and not OTLP SDKs directly
+ *
+ * The OTLP exporters in `@opentelemetry/exporter-trace-otlp-proto` are
+ * span-oriented and pull in a transport stack. By funneling all three
+ * adjudicate sinks through one in-process `Exporter`, adopters can:
+ *
+ *   - Wire one OTLP/proto transport for the whole subsystem
+ *   - Or stay on a no-op transport in environments without an OTel collector
+ *   - Or capture events into an in-memory buffer for tests
+ *
+ * The `@opentelemetry/api` package is the only OTel dependency we pull in;
+ * it is metadata-only (interfaces) and adds no runtime weight.
+ *
+ * # Layout
+ *
+ *   - `exporter.ts`     Exporter interface + InMemoryExporter for tests
+ *   - `semconv.ts`      Stable attribute names (`adjudicate.*`)
+ *   - `metrics.ts`      createOtlpMetricsSink → MetricsSink
+ *   - `learning.ts`     createOtlpLearningSink → LearningSink
+ *   - `audit-spans.ts`  createOtlpAuditSpanExporter → AuditSink wrapper
+ */
+export { type Exporter, type ExportedEvent, type ExportedEventKind, type InMemoryExporter, createInMemoryExporter, noopExporter, } from "./exporter.js";
+export { SEMCONV, type SemconvAttribute, type SemconvKey } from "./semconv.js";
+export { createOtlpMetricsSink, type OtlpMetricsSinkOptions, } from "./metrics.js";
+export { createOtlpLearningSink, type OtlpLearningSinkOptions, } from "./learning.js";
+export { createOtlpAuditSpanExporter, type OtlpAuditSpanExporterOptions, } from "./audit-spans.js";
+export { createEcosystemTelemetry, classifyReplayFailure, serializeEcosystemSnapshot, type EcosystemTelemetry, type EcosystemTelemetryOptions, type EcosystemTelemetrySnapshot, type PackEcosystemSnapshot, type DecisionDistributionSnapshot, type ReplayFailureSnapshot, type ReplayFailureClass, type AnalyzerTriageSnapshot, type AnalyzerTriageOutcome, type SemconvAdoptionSnapshot, type MigrationPainSnapshot, type IncidentSnapshot, type OperationalIncidentClass, } from "./ecosystem-telemetry.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AAEH,OAAO,EACL,KAAK,QAAQ,EACb,KAAK,aAAa,EAClB,KAAK,iBAAiB,EACtB,KAAK,gBAAgB,EACrB,sBAAsB,EACtB,YAAY,GACb,MAAM,eAAe,CAAC;AAEvB,OAAO,EAAE,OAAO,EAAE,KAAK,gBAAgB,EAAE,KAAK,UAAU,EAAE,MAAM,cAAc,CAAC;AAE/E,OAAO,EACL,qBAAqB,EACrB,KAAK,sBAAsB,GAC5B,MAAM,cAAc,CAAC;AAEtB,OAAO,EACL,sBAAsB,EACtB,KAAK,uBAAuB,GAC7B,MAAM,eAAe,CAAC;AAEvB,OAAO,EACL,2BAA2B,EAC3B,KAAK,4BAA4B,GAClC,MAAM,kBAAkB,CAAC;AAK1B,OAAO,EACL,wBAAwB,EACxB,qBAAqB,EACrB,0BAA0B,EAC1B,KAAK,kBAAkB,EACvB,KAAK,yBAAyB,EAC9B,KAAK,0BAA0B,EAC/B,KAAK,qBAAqB,EAC1B,KAAK,4BAA4B,EACjC,KAAK,qBAAqB,EAC1B,KAAK,kBAAkB,EACvB,KAAK,sBAAsB,EAC3B,KAAK,qBAAqB,EAC1B,KAAK,uBAAuB,EAC5B,KAAK,qBAAqB,EAC1B,KAAK,gBAAgB,EACrB,KAAK,wBAAwB,GAC9B,MAAM,0BAA0B,CAAC"}

package/dist/index.js

@@ -0,0 +1,43 @@
+/**
+ * @adjudicate/observability — OTLP-native sinks for the kernel's three
+ * telemetry surfaces (metrics, learning, audit).
+ *
+ * The package adapts the kernel's existing sink contracts (`MetricsSink`,
+ * `LearningSink`, `AuditSink`) onto a single `Exporter` interface that the
+ * adopter wires to an OpenTelemetry transport. The kernel itself is
+ * untouched — observability is OPTIONAL plumbing and MUST NEVER affect a
+ * Decision outcome. If the exporter throws, the sink swallows the error;
+ * if the exporter is misconfigured, telemetry is silent but adjudication
+ * still runs.
+ *
+ * # Why a custom Exporter and not OTLP SDKs directly
+ *
+ * The OTLP exporters in `@opentelemetry/exporter-trace-otlp-proto` are
+ * span-oriented and pull in a transport stack. By funneling all three
+ * adjudicate sinks through one in-process `Exporter`, adopters can:
+ *
+ *   - Wire one OTLP/proto transport for the whole subsystem
+ *   - Or stay on a no-op transport in environments without an OTel collector
+ *   - Or capture events into an in-memory buffer for tests
+ *
+ * The `@opentelemetry/api` package is the only OTel dependency we pull in;
+ * it is metadata-only (interfaces) and adds no runtime weight.
+ *
+ * # Layout
+ *
+ *   - `exporter.ts`     Exporter interface + InMemoryExporter for tests
+ *   - `semconv.ts`      Stable attribute names (`adjudicate.*`)
+ *   - `metrics.ts`      createOtlpMetricsSink → MetricsSink
+ *   - `learning.ts`     createOtlpLearningSink → LearningSink
+ *   - `audit-spans.ts`  createOtlpAuditSpanExporter → AuditSink wrapper
+ */
+export { createInMemoryExporter, noopExporter, } from "./exporter.js";
+export { SEMCONV } from "./semconv.js";
+export { createOtlpMetricsSink, } from "./metrics.js";
+export { createOtlpLearningSink, } from "./learning.js";
+export { createOtlpAuditSpanExporter, } from "./audit-spans.js";
+// Post-v1 ecosystem-telemetry primitive — opt-in, local-first, deterministic.
+// Adopters compose this aggregator alongside their sinks to produce
+// JSON-stable evidence snapshots. The framework never instantiates it.
+export { createEcosystemTelemetry, classifyReplayFailure, serializeEcosystemSnapshot, } from "./ecosystem-telemetry.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AAEH,OAAO,EAKL,sBAAsB,EACtB,YAAY,GACb,MAAM,eAAe,CAAC;AAEvB,OAAO,EAAE,OAAO,EAA0C,MAAM,cAAc,CAAC;AAE/E,OAAO,EACL,qBAAqB,GAEtB,MAAM,cAAc,CAAC;AAEtB,OAAO,EACL,sBAAsB,GAEvB,MAAM,eAAe,CAAC;AAEvB,OAAO,EACL,2BAA2B,GAE5B,MAAM,kBAAkB,CAAC;AAE1B,8EAA8E;AAC9E,oEAAoE;AACpE,uEAAuE;AACvE,OAAO,EACL,wBAAwB,EACxB,qBAAqB,EACrB,0BAA0B,GAc3B,MAAM,0BAA0B,CAAC"}

package/dist/learning.d.ts

@@ -0,0 +1,32 @@
+/**
+ * OTLP-shaped LearningSink.
+ *
+ * Adopters install this when they want adjudication outcomes routed to a
+ * downstream analytics warehouse via the OTLP pipeline (e.g., a collector
+ * that fans out to BigQuery / Snowflake / Honeycomb). The sink emits a
+ * structured `learning.outcome` event per Decision; the exporter is
+ * responsible for shaping it onto the destination's wire format.
+ *
+ * Learning events are richer than metrics — they carry `basisCodes`,
+ * `planFingerprint`, and guard identity — so the `body` field carries the
+ * full LearningEvent. Attributes mirror the headline fields for partition
+ * keys.
+ *
+ * Wiring:
+ *
+ *     import { setLearningSink } from "@adjudicate/core/kernel";
+ *     import { createOtlpLearningSink } from "@adjudicate/observability";
+ *
+ *     setLearningSink(createOtlpLearningSink({ exporter }));
+ */
+import type { LearningSink } from "@adjudicate/core/kernel";
+import type { Exporter } from "./exporter.js";
+export interface OtlpLearningSinkOptions {
+    readonly exporter: Exporter;
+    /** Optional Pack identifier stamped on every event. */
+    readonly packId?: string;
+    /** Optional Pack policy version stamped on every event. */
+    readonly policyVersion?: string;
+}
+export declare function createOtlpLearningSink(opts: OtlpLearningSinkOptions): LearningSink;
+//# sourceMappingURL=learning.d.ts.map

package/dist/learning.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"learning.d.ts","sourceRoot":"","sources":["../src/learning.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,KAAK,EAAE,QAAQ,EAAiB,MAAM,eAAe,CAAC;AAG7D,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;IAC5B,uDAAuD;IACvD,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,2DAA2D;IAC3D,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;CACjC;AAED,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,uBAAuB,GAC5B,YAAY,CAqCd"}

package/dist/learning.js

@@ -0,0 +1,62 @@
+/**
+ * OTLP-shaped LearningSink.
+ *
+ * Adopters install this when they want adjudication outcomes routed to a
+ * downstream analytics warehouse via the OTLP pipeline (e.g., a collector
+ * that fans out to BigQuery / Snowflake / Honeycomb). The sink emits a
+ * structured `learning.outcome` event per Decision; the exporter is
+ * responsible for shaping it onto the destination's wire format.
+ *
+ * Learning events are richer than metrics — they carry `basisCodes`,
+ * `planFingerprint`, and guard identity — so the `body` field carries the
+ * full LearningEvent. Attributes mirror the headline fields for partition
+ * keys.
+ *
+ * Wiring:
+ *
+ *     import { setLearningSink } from "@adjudicate/core/kernel";
+ *     import { createOtlpLearningSink } from "@adjudicate/observability";
+ *
+ *     setLearningSink(createOtlpLearningSink({ exporter }));
+ */
+import { SEMCONV } from "./semconv.js";
+export function createOtlpLearningSink(opts) {
+    return {
+        recordOutcome(event) {
+            const exported = {
+                kind: "learning.outcome",
+                name: "adjudicate.learning.outcome",
+                at: event.at,
+                attributes: {
+                    [SEMCONV.INTENT_KIND]: event.intentKind,
+                    [SEMCONV.DECISION_KIND]: event.decisionKind,
+                    [SEMCONV.TAINT]: event.taint,
+                    [SEMCONV.LATENCY_MS]: event.durationMs,
+                    [SEMCONV.INTENT_HASH]: event.intentHash,
+                    ...(event.guardId !== undefined
+                        ? { [SEMCONV.GUARD_ID]: event.guardId }
+                        : {}),
+                    ...(event.guardPhase !== undefined
+                        ? { "adjudicate.guard.phase": event.guardPhase }
+                        : {}),
+                    ...(event.planFingerprint !== undefined
+                        ? { "adjudicate.plan.fingerprint": event.planFingerprint }
+                        : {}),
+                    ...(opts.packId !== undefined ? { [SEMCONV.PACK_ID]: opts.packId } : {}),
+                    ...(opts.policyVersion !== undefined
+                        ? { [SEMCONV.POLICY_VERSION]: opts.policyVersion }
+                        : {}),
+                },
+                // Full LearningEvent for warehouses that ingest event bodies.
+                body: event,
+            };
+            try {
+                opts.exporter.export(exported);
+            }
+            catch {
+                /* swallow — sink failures must not affect Decisions. */
+            }
+        },
+    };
+}
+//# sourceMappingURL=learning.js.map

package/dist/learning.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"learning.js","sourceRoot":"","sources":["../src/learning.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAIH,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAUvC,MAAM,UAAU,sBAAsB,CACpC,IAA6B;IAE7B,OAAO;QACL,aAAa,CAAC,KAAK;YACjB,MAAM,QAAQ,GAAkB;gBAC9B,IAAI,EAAE,kBAAkB;gBACxB,IAAI,EAAE,6BAA6B;gBACnC,EAAE,EAAE,KAAK,CAAC,EAAE;gBACZ,UAAU,EAAE;oBACV,CAAC,OAAO,CAAC,WAAW,CAAC,EAAE,KAAK,CAAC,UAAU;oBACvC,CAAC,OAAO,CAAC,aAAa,CAAC,EAAE,KAAK,CAAC,YAAY;oBAC3C,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,KAAK,CAAC,KAAK;oBAC5B,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,KAAK,CAAC,UAAU;oBACtC,CAAC,OAAO,CAAC,WAAW,CAAC,EAAE,KAAK,CAAC,UAAU;oBACvC,GAAG,CAAC,KAAK,CAAC,OAAO,KAAK,SAAS;wBAC7B,CAAC,CAAC,EAAE,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,KAAK,CAAC,OAAO,EAAE;wBACvC,CAAC,CAAC,EAAE,CAAC;oBACP,GAAG,CAAC,KAAK,CAAC,UAAU,KAAK,SAAS;wBAChC,CAAC,CAAC,EAAE,wBAAwB,EAAE,KAAK,CAAC,UAAU,EAAE;wBAChD,CAAC,CAAC,EAAE,CAAC;oBACP,GAAG,CAAC,KAAK,CAAC,eAAe,KAAK,SAAS;wBACrC,CAAC,CAAC,EAAE,6BAA6B,EAAE,KAAK,CAAC,eAAe,EAAE;wBAC1D,CAAC,CAAC,EAAE,CAAC;oBACP,GAAG,CAAC,IAAI,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;oBACxE,GAAG,CAAC,IAAI,CAAC,aAAa,KAAK,SAAS;wBAClC,CAAC,CAAC,EAAE,CAAC,OAAO,CAAC,cAAc,CAAC,EAAE,IAAI,CAAC,aAAa,EAAE;wBAClD,CAAC,CAAC,EAAE,CAAC;iBACR;gBACD,8DAA8D;gBAC9D,IAAI,EAAE,KAAK;aACZ,CAAC;YACF,IAAI,CAAC;gBACH,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;YACjC,CAAC;YAAC,MAAM,CAAC;gBACP,wDAAwD;YAC1D,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/metrics.d.ts

@@ -0,0 +1,31 @@
+/**
+ * OTLP-shaped MetricsSink.
+ *
+ * Wraps `@adjudicate/core/kernel`'s `MetricsSink` contract and emits one
+ * `ExportedEvent` per call. The events carry the semantic conventions defined
+ * in `semconv.ts`, so an OTLP exporter can map them onto OpenTelemetry meters
+ * without losing the kernel's shape.
+ *
+ * Adopter wiring:
+ *
+ *     import { setMetricsSink } from "@adjudicate/core/kernel";
+ *     import { createOtlpMetricsSink } from "@adjudicate/observability";
+ *
+ *     setMetricsSink(createOtlpMetricsSink({ exporter: yourOtlpExporter }));
+ *
+ * The sink itself does no transport — it pushes events into the injected
+ * `Exporter`. Real OTLP traffic happens in the adopter-owned exporter.
+ */
+import type { MetricsSink } from "@adjudicate/core/kernel";
+import type { Exporter } from "./exporter.js";
+export interface OtlpMetricsSinkOptions {
+    readonly exporter: Exporter;
+    /** Optional clock — tests inject a fake. */
+    readonly clockIso?: () => string;
+    /** Optional Pack identifier stamped on every event. */
+    readonly packId?: string;
+    /** Optional Pack policy version stamped on every event. */
+    readonly policyVersion?: string;
+}
+export declare function createOtlpMetricsSink(opts: OtlpMetricsSinkOptions): MetricsSink;
+//# sourceMappingURL=metrics.d.ts.map

package/dist/metrics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"metrics.d.ts","sourceRoot":"","sources":["../src/metrics.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,KAAK,EAAE,QAAQ,EAAiB,MAAM,eAAe,CAAC;AAG7D,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;IAC5B,4CAA4C;IAC5C,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,MAAM,CAAC;IACjC,uDAAuD;IACvD,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,2DAA2D;IAC3D,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;CACjC;AAED,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,sBAAsB,GAAG,WAAW,CA2F/E"}

package/dist/metrics.js

@@ -0,0 +1,132 @@
+/**
+ * OTLP-shaped MetricsSink.
+ *
+ * Wraps `@adjudicate/core/kernel`'s `MetricsSink` contract and emits one
+ * `ExportedEvent` per call. The events carry the semantic conventions defined
+ * in `semconv.ts`, so an OTLP exporter can map them onto OpenTelemetry meters
+ * without losing the kernel's shape.
+ *
+ * Adopter wiring:
+ *
+ *     import { setMetricsSink } from "@adjudicate/core/kernel";
+ *     import { createOtlpMetricsSink } from "@adjudicate/observability";
+ *
+ *     setMetricsSink(createOtlpMetricsSink({ exporter: yourOtlpExporter }));
+ *
+ * The sink itself does no transport — it pushes events into the injected
+ * `Exporter`. Real OTLP traffic happens in the adopter-owned exporter.
+ */
+import { SEMCONV } from "./semconv.js";
+export function createOtlpMetricsSink(opts) {
+    const clockIso = opts.clockIso ?? (() => new Date().toISOString());
+    const stamp = stampFactory(opts);
+    return {
+        recordLedgerOp(event) {
+            const exported = {
+                kind: "metrics.ledger",
+                name: `adjudicate.ledger.${event.op}`,
+                at: clockIso(),
+                attributes: stamp({
+                    "adjudicate.ledger.op": event.op,
+                    "adjudicate.ledger.outcome": event.outcome,
+                    [SEMCONV.INTENT_KIND]: event.intentKind,
+                    [SEMCONV.LATENCY_MS]: event.latencyMs,
+                }),
+            };
+            safeExport(opts.exporter, exported);
+        },
+        recordDecision(event) {
+            const exported = {
+                kind: "metrics.decision",
+                name: "adjudicate.decision",
+                at: clockIso(),
+                attributes: stamp({
+                    [SEMCONV.INTENT_KIND]: event.intentKind,
+                    [SEMCONV.DECISION_KIND]: event.decision,
+                    [SEMCONV.LATENCY_MS]: event.latencyMs,
+                    "adjudicate.basis.count": event.basisCount,
+                    [SEMCONV.INTENT_HASH]: event.intentHash,
+                }),
+            };
+            safeExport(opts.exporter, exported);
+        },
+        recordRefusal(event) {
+            const exported = {
+                kind: "metrics.refusal",
+                name: "adjudicate.refusal",
+                at: clockIso(),
+                attributes: stamp({
+                    [SEMCONV.INTENT_KIND]: event.intentKind,
+                    "adjudicate.refusal.kind": event.refusal.kind,
+                    "adjudicate.refusal.code": event.refusal.code,
+                    [SEMCONV.INTENT_HASH]: event.intentHash,
+                }),
+            };
+            safeExport(opts.exporter, exported);
+        },
+        recordSinkFailure(event) {
+            const exported = {
+                kind: "metrics.sink_failure",
+                name: "adjudicate.sink_failure",
+                at: clockIso(),
+                attributes: stamp({
+                    "adjudicate.sink": event.sink,
+                    "adjudicate.sink.subject": event.subject,
+                    "adjudicate.sink.error_class": event.errorClass,
+                    "adjudicate.sink.consecutive_failures": event.consecutiveFailures,
+                }),
+            };
+            safeExport(opts.exporter, exported);
+        },
+        recordShadowDivergence(event) {
+            const exported = {
+                kind: "metrics.shadow_divergence",
+                name: "adjudicate.shadow_divergence",
+                at: clockIso(),
+                attributes: stamp({
+                    [SEMCONV.INTENT_KIND]: event.intentKind,
+                    "adjudicate.shadow.divergence": event.divergence,
+                    "adjudicate.shadow.legacy": event.legacy.kind,
+                    [SEMCONV.DECISION_KIND]: event.adjudicate.kind,
+                }),
+            };
+            safeExport(opts.exporter, exported);
+        },
+        recordResourceLimit(event) {
+            const exported = {
+                kind: "metrics.resource_limit",
+                name: "adjudicate.resource_limit",
+                at: clockIso(),
+                attributes: stamp({
+                    "adjudicate.resource": event.resource,
+                    "adjudicate.resource.subject": event.subject,
+                    "adjudicate.resource.limit": event.limit,
+                    "adjudicate.resource.observed": event.observed,
+                }),
+            };
+            safeExport(opts.exporter, exported);
+        },
+    };
+}
+function stampFactory(opts) {
+    return (attrs) => ({
+        ...attrs,
+        ...(opts.packId !== undefined ? { [SEMCONV.PACK_ID]: opts.packId } : {}),
+        ...(opts.policyVersion !== undefined
+            ? { [SEMCONV.POLICY_VERSION]: opts.policyVersion }
+            : {}),
+    });
+}
+/**
+ * Observability is best-effort. An exporter that throws (misconfigured
+ * transport, network blip) must never propagate into the kernel hot path.
+ */
+function safeExport(exporter, event) {
+    try {
+        exporter.export(event);
+    }
+    catch {
+        /* swallow — exporter failures must not affect Decision outcomes. */
+    }
+}
+//# sourceMappingURL=metrics.js.map

package/dist/metrics.js.map

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

package/dist/semconv.d.ts

@@ -0,0 +1,76 @@
+/**
+ * Semantic conventions for adjudicate's OTLP attribute names.
+ *
+ * The names are namespaced under `adjudicate.*` so they don't collide with
+ * upstream OpenTelemetry semconv (`http.*`, `db.*`, …) or with adopter-defined
+ * attributes. We commit to keeping these names stable across minor versions —
+ * dashboards, alerts, and SIEM rules built on top of them MUST NOT break when
+ * `@adjudicate/observability` bumps its minor.
+ *
+ * If a new attribute is needed, ADD a new key here; do NOT rename existing
+ * ones. Removal is a breaking change and goes through the deprecation
+ * calendar (see `docs/release/deprecations.md`).
+ */
+export declare const SEMCONV: {
+    /** Envelope kind — e.g. "vacation.request", "pix.charge.refund". */
+    readonly INTENT_KIND: "adjudicate.intent.kind";
+    /** Decision.kind — one of EXECUTE/REFUSE/ESCALATE/REQUEST_CONFIRMATION/REWRITE/DEFER. */
+    readonly DECISION_KIND: "adjudicate.decision.kind";
+    /** Taint level on the originating envelope — UNTRUSTED | TRUSTED | SYSTEM. */
+    readonly TAINT: "adjudicate.taint";
+    /** Adopter-supplied policy bundle version (e.g. semver of the Pack). */
+    readonly POLICY_VERSION: "adjudicate.policy.version";
+    /** Adopter-supplied Pack identifier, when known. */
+    readonly PACK_ID: "adjudicate.pack.id";
+    /** Wall-clock duration of the adjudication itself, in milliseconds. */
+    readonly LATENCY_MS: "adjudicate.latency.ms";
+    /** Audit-stable intent hash — useful for cross-correlating spans with audit rows. */
+    readonly INTENT_HASH: "adjudicate.intent.hash";
+    /** Matched-guard identifier (see ADR-105). Omitted for non-guard phases. */
+    readonly GUARD_ID: "adjudicate.guard.id";
+    /**
+     * Source of a propagated transition (kill-switch, deferred resume, …).
+     * Low cardinality: `pubsub | poll | boot | external`. Lets dashboards
+     * separate "operator initiated trip" from "boot-time resync".
+     */
+    readonly TRANSITION_SOURCE: "adjudicate.transition.source";
+    /**
+     * Lifecycle phase for the adapter loop. Low cardinality:
+     * `started | iteration | tool_use | decision | completed | paused`.
+     */
+    readonly ADAPTER_PHASE: "adjudicate.adapter.phase";
+    /**
+     * Adapter iteration counter within a single `.send()` call. Bounded
+     * by `maxIterations` (default 8) — safe for low-cardinality histograms.
+     */
+    readonly ADAPTER_ITERATION: "adjudicate.adapter.iteration";
+    /**
+     * Adapter outcome kind. Low cardinality: matches `AgentOutcome.kind`
+     * (`completed | deferred | awaiting_confirmation | escalated | max_iterations_exceeded`).
+     */
+    readonly ADAPTER_OUTCOME: "adjudicate.adapter.outcome";
+    /**
+     * Provider identifier supplied by the bridge. Adopter-controlled
+     * vocabulary (e.g., `anthropic | openai | vercel-ai | bedrock`). Kept
+     * low-cardinality by adopter discipline; the framework does not enforce
+     * a fixed enum here because adopters add their own providers.
+     */
+    readonly PROVIDER_ID: "adjudicate.provider.id";
+    /**
+     * Defer/confirm lifecycle phase: `parked | resumed | confirmed | declined | expired`.
+     */
+    readonly PAUSE_PHASE: "adjudicate.pause.phase";
+    /**
+     * Defer signal vocabulary entry. Controlled by the Pack's declared
+     * `signals` list — Packs are expected to keep this list small.
+     */
+    readonly DEFER_SIGNAL: "adjudicate.defer.signal";
+    /**
+     * Kill-switch state. Low cardinality: `active | normal`.
+     * Use {@link TRANSITION_SOURCE} alongside for the trigger.
+     */
+    readonly KILL_SWITCH_STATE: "adjudicate.kill_switch.state";
+};
+export type SemconvKey = keyof typeof SEMCONV;
+export type SemconvAttribute = (typeof SEMCONV)[SemconvKey];
+//# sourceMappingURL=semconv.d.ts.map

package/dist/semconv.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"semconv.d.ts","sourceRoot":"","sources":["../src/semconv.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,OAAO;IAClB,oEAAoE;;IAEpE,yFAAyF;;IAEzF,8EAA8E;;IAE9E,wEAAwE;;IAExE,oDAAoD;;IAEpD,uEAAuE;;IAEvE,qFAAqF;;IAErF,4EAA4E;;IAE5E;;;;OAIG;;IAEH;;;OAGG;;IAEH;;;OAGG;;IAEH;;;OAGG;;IAEH;;;;;OAKG;;IAEH;;OAEG;;IAEH;;;OAGG;;IAEH;;;OAGG;;CAEK,CAAC;AAEX,MAAM,MAAM,UAAU,GAAG,MAAM,OAAO,OAAO,CAAC;AAC9C,MAAM,MAAM,gBAAgB,GAAG,CAAC,OAAO,OAAO,CAAC,CAAC,UAAU,CAAC,CAAC"}