@zlink-systems/framework 0.21.0 → 0.22.0

package/src/runtime/diagnostics/internal-event-contracts.ts

@@ -17,7 +17,9 @@ import type {
   ZLinkSpotLocationKey
 } from '../../contracts/Locations/Keys';
 
-export interface ZLinkLocationMonitoringRegistration { readonly sourceName: string; }
+export interface ZLinkLocationMonitoringRegistration {
+  readonly sourceName: string;
+}
 
 export interface ZLinkSocketMonitoringRegistration {
   readonly sourceName: string;
@@ -64,22 +66,21 @@ export enum ZLinkLocationRuntimeEventKind {
 
 export type ZLinkLocationRuntimeEvent =
   | (ZLinkRuntimeEvent & {
-    readonly event: ZLinkLocationRuntimeEventKind.StatusChanged;
-    readonly status: ZLinkLocationRuntimeStatus;
-  })
+      readonly event: ZLinkLocationRuntimeEventKind.StatusChanged;
+      readonly status: ZLinkLocationRuntimeStatus;
+    })
   | (ZLinkRuntimeEvent & {
-    readonly event: ZLinkLocationRuntimeEventKind.TopologyChanged;
-    readonly topology: readonly ZLinkLocationTopologyEntry[];
-  })
+      readonly event: ZLinkLocationRuntimeEventKind.TopologyChanged;
+      readonly topology: readonly ZLinkLocationTopologyEntry[];
+    })
   | (ZLinkRuntimeEvent & {
-    readonly event: ZLinkLocationRuntimeEventKind.ServiceSummaryChanged;
-    readonly serviceSummary: readonly ZLinkLocationServiceSummary[];
-  })
+      readonly event: ZLinkLocationRuntimeEventKind.ServiceSummaryChanged;
+      readonly serviceSummary: readonly ZLinkLocationServiceSummary[];
+    })
   | (ZLinkRuntimeEvent & {
-    readonly event:
-      | ZLinkLocationRuntimeEventKind.StoreFailure
-      | ZLinkLocationRuntimeEventKind.StoreRecovered;
-  });
+      readonly event:
+        ZLinkLocationRuntimeEventKind.StoreFailure | ZLinkLocationRuntimeEventKind.StoreRecovered;
+    });
 
 export enum ZLinkSpotEventKind {
   TimerHandlerFailed = 'timerHandlerFailed',
@@ -105,10 +106,26 @@ export enum ZLinkSocketNativeEventType {
   PeerAdmissionChanged = 0x8000
 }
 
-export enum ZLinkLocationPeerEventKind { RowUpdated = 0, RowRemoved = 1, DesiredSetChanged = 2 }
-export enum ZLinkLocationSpotEventKind { RowUpdated = 0, RowRemoved = 1, ResolveMiss = 2 }
-export enum ZLinkLocationActorEventKind { RowUpdated = 0, RowRemoved = 1, ResolveMiss = 2 }
-export enum ZLinkLocationRouteEventKind { RowUpdated = 0, RowRemoved = 1, ResolveMiss = 2 }
+export enum ZLinkLocationPeerEventKind {
+  RowUpdated = 0,
+  RowRemoved = 1,
+  DesiredSetChanged = 2
+}
+export enum ZLinkLocationSpotEventKind {
+  RowUpdated = 0,
+  RowRemoved = 1,
+  ResolveMiss = 2
+}
+export enum ZLinkLocationActorEventKind {
+  RowUpdated = 0,
+  RowRemoved = 1,
+  ResolveMiss = 2
+}
+export enum ZLinkLocationRouteEventKind {
+  RowUpdated = 0,
+  RowRemoved = 1,
+  ResolveMiss = 2
+}
 
 export interface ZLinkAutoConnectDesiredSetChange {
   readonly autoConnectType: ZLinkLocationAutoConnectType;
@@ -118,18 +135,55 @@ export interface ZLinkAutoConnectDesiredSetChange {
 }
 
 export type ZLinkLocationPeerEvent =
-  | (ZLinkRuntimeEvent & { readonly event: ZLinkLocationPeerEventKind.RowUpdated; readonly key: string; readonly peer: ZLinkPeerLocation })
-  | (ZLinkRuntimeEvent & { readonly event: ZLinkLocationPeerEventKind.RowRemoved; readonly key: string })
-  | (ZLinkRuntimeEvent & { readonly event: ZLinkLocationPeerEventKind.DesiredSetChanged; readonly desiredSetChange: ZLinkAutoConnectDesiredSetChange });
-export type ZLinkLocationSpotEvent = ZLinkRuntimeEvent & (
-  | { readonly event: ZLinkLocationSpotEventKind.RowUpdated; readonly key: ZLinkSpotLocationKey; readonly spot: ZLinkSpotLocation }
-  | { readonly event: ZLinkLocationSpotEventKind.RowRemoved | ZLinkLocationSpotEventKind.ResolveMiss; readonly key: ZLinkSpotLocationKey }
-);
-export type ZLinkLocationActorEvent = ZLinkRuntimeEvent & (
-  | { readonly event: ZLinkLocationActorEventKind.RowUpdated; readonly key: ZLinkActorLocationKey; readonly actor: ZLinkActorLocation }
-  | { readonly event: ZLinkLocationActorEventKind.RowRemoved | ZLinkLocationActorEventKind.ResolveMiss; readonly key: ZLinkActorLocationKey }
-);
-export type ZLinkLocationRouteEvent = ZLinkRuntimeEvent & (
-  | { readonly event: ZLinkLocationRouteEventKind.RowUpdated; readonly key: ZLinkRouteLocationKey; readonly route: ZLinkRouteLocation }
-  | { readonly event: ZLinkLocationRouteEventKind.RowRemoved | ZLinkLocationRouteEventKind.ResolveMiss; readonly key: ZLinkRouteLocationKey }
-);
+  | (ZLinkRuntimeEvent & {
+      readonly event: ZLinkLocationPeerEventKind.RowUpdated;
+      readonly key: string;
+      readonly peer: ZLinkPeerLocation;
+    })
+  | (ZLinkRuntimeEvent & {
+      readonly event: ZLinkLocationPeerEventKind.RowRemoved;
+      readonly key: string;
+    })
+  | (ZLinkRuntimeEvent & {
+      readonly event: ZLinkLocationPeerEventKind.DesiredSetChanged;
+      readonly desiredSetChange: ZLinkAutoConnectDesiredSetChange;
+    });
+export type ZLinkLocationSpotEvent = ZLinkRuntimeEvent &
+  (
+    | {
+        readonly event: ZLinkLocationSpotEventKind.RowUpdated;
+        readonly key: ZLinkSpotLocationKey;
+        readonly spot: ZLinkSpotLocation;
+      }
+    | {
+        readonly event:
+          ZLinkLocationSpotEventKind.RowRemoved | ZLinkLocationSpotEventKind.ResolveMiss;
+        readonly key: ZLinkSpotLocationKey;
+      }
+  );
+export type ZLinkLocationActorEvent = ZLinkRuntimeEvent &
+  (
+    | {
+        readonly event: ZLinkLocationActorEventKind.RowUpdated;
+        readonly key: ZLinkActorLocationKey;
+        readonly actor: ZLinkActorLocation;
+      }
+    | {
+        readonly event:
+          ZLinkLocationActorEventKind.RowRemoved | ZLinkLocationActorEventKind.ResolveMiss;
+        readonly key: ZLinkActorLocationKey;
+      }
+  );
+export type ZLinkLocationRouteEvent = ZLinkRuntimeEvent &
+  (
+    | {
+        readonly event: ZLinkLocationRouteEventKind.RowUpdated;
+        readonly key: ZLinkRouteLocationKey;
+        readonly route: ZLinkRouteLocation;
+      }
+    | {
+        readonly event:
+          ZLinkLocationRouteEventKind.RowRemoved | ZLinkLocationRouteEventKind.ResolveMiss;
+        readonly key: ZLinkRouteLocationKey;
+      }
+  );

package/src/runtime/diagnostics/message-flow.ts

@@ -1,8 +1,4 @@
-import {
-  SpanStatusCode,
-  trace as openTelemetryTrace,
-  type Attributes
-} from '@opentelemetry/api';
+import { SpanStatusCode, trace as openTelemetryTrace, type Attributes } from '@opentelemetry/api';
 import { logs as openTelemetryLogs, SeverityNumber } from '@opentelemetry/api-logs';
 import {
   MESSAGE_FLOW_MODE_RANK,
@@ -45,8 +41,15 @@ interface ZLinkTelemetryRecord {
   readonly timestamp: Date;
   readonly phase?: string;
   readonly outcome: ZLinkRuntimeMessageFlowResult;
-  readonly surface: 'node' | 'channel' | 'spot' | 'instance_spot' | 'actor' | 'stream'
-    | 'actor_relocation' | 'classic_fanout';
+  readonly surface:
+    | 'node'
+    | 'channel'
+    | 'spot'
+    | 'instance_spot'
+    | 'actor'
+    | 'stream'
+    | 'actor_relocation'
+    | 'classic_fanout';
   readonly messageKind: 'request' | 'send' | 'response' | 'error' | 'control';
   readonly reason?: string;
   readonly action?: string;
@@ -102,10 +105,10 @@ function requiredMode(
 ): ZLinkMessageFlowLogMode {
   //  succeeded가 아닌 terminal은 Errors level에서도 보여야 한다 — 기록 범위 설정
   //  절의 level 규칙.
-  return outcome === ZLinkMessageFlowOutcome.Dropped
-    || outcome === ZLinkMessageFlowOutcome.Backpressured
-    || outcome === ZLinkMessageFlowOutcome.Error
-    || (result !== undefined && result !== 'succeeded')
+  return outcome === ZLinkMessageFlowOutcome.Dropped ||
+    outcome === ZLinkMessageFlowOutcome.Backpressured ||
+    outcome === ZLinkMessageFlowOutcome.Error ||
+    (result !== undefined && result !== 'succeeded')
     ? 'errors'
     : 'normal';
 }
@@ -120,7 +123,9 @@ export function flowIfEnabled(
   if (flow === undefined) return undefined;
   return typeof flow.begin === 'function'
     ? flow.begin(outcome, result, flowId, sourceMeshGeneration)
-    : flow.accepts(outcome) ? flow : undefined;
+    : flow.accepts(outcome)
+      ? flow
+      : undefined;
 }
 
 export interface ZLinkMessageFlowTracePoint {
@@ -174,17 +179,17 @@ export class ZLinkMessageFlowTracer {
     }
     switch (mode) {
       case 'errors':
-        return this.errorsTracePoint ??= {
-          trace: flowInput => this.traceAcceptedAtMode(flowInput, 'errors')
-        };
+        return (this.errorsTracePoint ??= {
+          trace: (flowInput) => this.traceAcceptedAtMode(flowInput, 'errors')
+        });
       case 'normal':
-        return this.normalTracePoint ??= {
-          trace: flowInput => this.traceAcceptedAtMode(flowInput, 'normal')
-        };
+        return (this.normalTracePoint ??= {
+          trace: (flowInput) => this.traceAcceptedAtMode(flowInput, 'normal')
+        });
       case 'detailed':
-        return this.detailedTracePoint ??= {
-          trace: flowInput => this.traceAcceptedAtMode(flowInput, 'detailed')
-        };
+        return (this.detailedTracePoint ??= {
+          trace: (flowInput) => this.traceAcceptedAtMode(flowInput, 'detailed')
+        });
       case 'off':
         return undefined;
     }
@@ -197,17 +202,21 @@ export class ZLinkMessageFlowTracer {
   trace(flowInput: MessageFlowInput): void {
     const effectiveMode = effectiveMessageFlow(this.ctx);
     if (
-      MESSAGE_FLOW_MODE_RANK[effectiveMode]
-      < MESSAGE_FLOW_MODE_RANK[requiredMode(flowInput.outcome, flowInput.result)]
-    ) return;
+      MESSAGE_FLOW_MODE_RANK[effectiveMode] <
+      MESSAGE_FLOW_MODE_RANK[requiredMode(flowInput.outcome, flowInput.result)]
+    )
+      return;
     const ambient = currentFlowContext();
     const flowId = flowInput.flowId ?? ambient?.flowId;
-    if (!this.acceptsSample(
-      flowInput.outcome,
-      flowInput.result,
-      flowId,
-      flowInput.sourceMeshGeneration
-    )) return;
+    if (
+      !this.acceptsSample(
+        flowInput.outcome,
+        flowInput.result,
+        flowId,
+        flowInput.sourceMeshGeneration
+      )
+    )
+      return;
     this.traceAcceptedAtMode(flowInput, effectiveMode, flowId, ambient?.flowOrigin);
   }
 
@@ -226,15 +235,17 @@ export class ZLinkMessageFlowTracer {
       effectiveMode
     };
     this.tracedEvents += 1;
-    this.publish(toTelemetryRecord(
-      flow,
-      effectiveMode === 'detailed' && this.ctx.diagnostics.includeMessageSizes
-        ? flow.messageSize
-        : undefined,
-      // Spec 26 §4: terminal elapsed time is a Detailed-level addition; the
-      // other languages strip it below that level.
-      effectiveMode === 'detailed' ? flow.durationSeconds : undefined
-    ));
+    this.publish(
+      toTelemetryRecord(
+        flow,
+        effectiveMode === 'detailed' && this.ctx.diagnostics.includeMessageSizes
+          ? flow.messageSize
+          : undefined,
+        // Spec 26 §4: terminal elapsed time is a Detailed-level addition; the
+        // other languages strip it below that level.
+        effectiveMode === 'detailed' ? flow.durationSeconds : undefined
+      )
+    );
   }
 
   private acceptsSample(
@@ -243,11 +254,13 @@ export class ZLinkMessageFlowTracer {
     flowId: string | undefined,
     sourceMeshGeneration: bigint | string | undefined
   ): boolean {
-    return outcome === ZLinkMessageFlowOutcome.Dropped
-      || outcome === ZLinkMessageFlowOutcome.Backpressured
-      || outcome === ZLinkMessageFlowOutcome.Error
-      || (result !== undefined && result !== 'succeeded')
-      || this.sample(flowId, sourceMeshGeneration);
+    return (
+      outcome === ZLinkMessageFlowOutcome.Dropped ||
+      outcome === ZLinkMessageFlowOutcome.Backpressured ||
+      outcome === ZLinkMessageFlowOutcome.Error ||
+      (result !== undefined && result !== 'succeeded') ||
+      this.sample(flowId, sourceMeshGeneration)
+    );
   }
 
   get tracedCount(): number {
@@ -258,12 +271,16 @@ export class ZLinkMessageFlowTracer {
     return this.providerFailures;
   }
 
-  private sample(flowId: string | undefined, sourceMeshGeneration: bigint | string | undefined): boolean {
+  private sample(
+    flowId: string | undefined,
+    sourceMeshGeneration: bigint | string | undefined
+  ): boolean {
     const rate = this.ctx.diagnostics.sampleRate;
     if (rate >= 1.0) return true;
     if (rate <= 0.0) return false;
-    const samplingKey = flowId
-      ?? `${sourceMeshGeneration ?? this.ctx.sourceMeshGeneration}:${this.nextSamplingSequence()}`;
+    const samplingKey =
+      flowId ??
+      `${sourceMeshGeneration ?? this.ctx.sourceMeshGeneration}:${this.nextSamplingSequence()}`;
     return hashFlowId(samplingKey) / 0x1_0000_0000 < rate;
   }
 
@@ -279,9 +296,8 @@ export class ZLinkMessageFlowTracer {
 
   private publishToLogger(record: ZLinkTelemetryRecord): void {
     try {
-      const severityNumber = record.eventId === 'zlink.dispatch_error'
-        ? SeverityNumber.ERROR
-        : SeverityNumber.INFO;
+      const severityNumber =
+        record.eventId === 'zlink.dispatch_error' ? SeverityNumber.ERROR : SeverityNumber.INFO;
       telemetryLogger.emit({
         eventName: record.eventId,
         timestamp: record.timestamp,
@@ -337,9 +353,10 @@ function toTelemetryRecord(
   durationSeconds: number | undefined
 ): ZLinkTelemetryRecord {
   return {
-    eventId: flow.outcome === ZLinkMessageFlowOutcome.Error
-      ? 'zlink.dispatch_error'
-      : 'zlink.message_flow',
+    eventId:
+      flow.outcome === ZLinkMessageFlowOutcome.Error
+        ? 'zlink.dispatch_error'
+        : 'zlink.message_flow',
     timestamp: new Date(),
     phase: messageFlowPhase(flow.outcome),
     outcome: flow.result ?? messageFlowOutcome(flow.outcome),
@@ -357,9 +374,8 @@ function toTelemetryRecord(
     targetRid: flow.targetRid,
     serverRid: flow.serverRid,
     flowId: flow.flowId,
-    flowOrigin: flow.flowOrigin === undefined
-      ? undefined
-      : FLOW_ORIGIN_TELEMETRY_VALUES[flow.flowOrigin],
+    flowOrigin:
+      flow.flowOrigin === undefined ? undefined : FLOW_ORIGIN_TELEMETRY_VALUES[flow.flowOrigin],
     spotId: flow.spotId,
     instanceSpotType: flow.instanceSpotType,
     activationState: flow.activationState,
@@ -455,7 +471,6 @@ function structuredLogBody(record: ZLinkTelemetryRecord): string {
     .join(' ')}`;
 }
 
-
 function compactAttributes(values: Record<string, string | number | undefined>): Attributes {
   const attributes: Attributes = {};
   for (const [key, value] of Object.entries(values)) {
@@ -466,31 +481,37 @@ function compactAttributes(values: Record<string, string | number | undefined>):
 
 function messageFlowPhase(outcome: ZLinkMessageFlowOutcome): string | undefined {
   switch (outcome) {
-    case ZLinkMessageFlowOutcome.Received: return 'received';
-    case ZLinkMessageFlowOutcome.Admitted: return 'admitted';
-    case ZLinkMessageFlowOutcome.Dispatched: return 'dispatched';
-    case ZLinkMessageFlowOutcome.Completed: return 'completed';
-    case ZLinkMessageFlowOutcome.Replied: return 'replied';
-    case ZLinkMessageFlowOutcome.Dropped: return 'dropped';
-    case ZLinkMessageFlowOutcome.Sent: return 'sent';
-    case ZLinkMessageFlowOutcome.ReplyReceived: return 'reply_received';
-    case ZLinkMessageFlowOutcome.Backpressured: return 'backpressured';
-    case ZLinkMessageFlowOutcome.Error: return undefined;
+    case ZLinkMessageFlowOutcome.Received:
+      return 'received';
+    case ZLinkMessageFlowOutcome.Admitted:
+      return 'admitted';
+    case ZLinkMessageFlowOutcome.Dispatched:
+      return 'dispatched';
+    case ZLinkMessageFlowOutcome.Completed:
+      return 'completed';
+    case ZLinkMessageFlowOutcome.Replied:
+      return 'replied';
+    case ZLinkMessageFlowOutcome.Dropped:
+      return 'dropped';
+    case ZLinkMessageFlowOutcome.Sent:
+      return 'sent';
+    case ZLinkMessageFlowOutcome.ReplyReceived:
+      return 'reply_received';
+    case ZLinkMessageFlowOutcome.Backpressured:
+      return 'backpressured';
+    case ZLinkMessageFlowOutcome.Error:
+      return undefined;
   }
 }
 
-function messageFlowOutcome(
-  outcome: ZLinkMessageFlowOutcome
-): ZLinkTelemetryRecord['outcome'] {
+function messageFlowOutcome(outcome: ZLinkMessageFlowOutcome): ZLinkTelemetryRecord['outcome'] {
   if (outcome === ZLinkMessageFlowOutcome.Error) return 'failed';
   if (outcome === ZLinkMessageFlowOutcome.Backpressured) return 'backpressured';
   if (outcome === ZLinkMessageFlowOutcome.Dropped) return 'dropped';
   return 'succeeded';
 }
 
-function messageFlowSurface(
-  surface: ZLinkDispatchErrorSurface
-): ZLinkTelemetryRecord['surface'] {
+function messageFlowSurface(surface: ZLinkDispatchErrorSurface): ZLinkTelemetryRecord['surface'] {
   switch (surface) {
     case ZLinkDispatchErrorSurface.Node:
       return 'node';
@@ -513,9 +534,7 @@ function messageFlowSurface(
   }
 }
 
-function messageFlowKind(
-  kind: ZLinkDispatchMessageKind
-): ZLinkTelemetryRecord['messageKind'] {
+function messageFlowKind(kind: ZLinkDispatchMessageKind): ZLinkTelemetryRecord['messageKind'] {
   switch (kind) {
     case ZLinkDispatchMessageKind.Request:
     case ZLinkDispatchMessageKind.ActorRequest:

package/src/runtime/diagnostics/runtime-metrics.ts

@@ -24,10 +24,7 @@ interface ZLinkObservableMeter extends ZLinkMeter {
     name: string,
     options?: { readonly unit?: string }
   ): ZLinkObservableGauge;
-  createObservableGauge?(
-    name: string,
-    options?: { readonly unit?: string }
-  ): ZLinkObservableGauge;
+  createObservableGauge?(name: string, options?: { readonly unit?: string }): ZLinkObservableGauge;
 }
 
 export interface ZLinkRuntimeMetricCapacity {
@@ -193,10 +190,12 @@ class MetricRegistry {
   }
 
   private observe(name: string, result: ZLinkObservableResult): void {
-    if (name === 'zlink.host.application_job_queue.pressure_state'
-        || name === 'zlink.host.application_job_queue.pressure_transitions'
-        || name === 'zlink.host.application_job_queue.pause_duration'
-        || name === 'zlink.host.application_job_queue.flow_state_config_failures') {
+    if (
+      name === 'zlink.host.application_job_queue.pressure_state' ||
+      name === 'zlink.host.application_job_queue.pressure_transitions' ||
+      name === 'zlink.host.application_job_queue.pause_duration' ||
+      name === 'zlink.host.application_job_queue.flow_state_config_failures'
+    ) {
       for (const provider of this.applicationJobQueuePressures) {
         try {
           this.observeApplicationJobQueuePressure(name, provider(), result);
@@ -206,8 +205,10 @@ class MetricRegistry {
       }
       return;
     }
-    if (name.startsWith('zlink.host.core_hwm.')
-        || name.startsWith('zlink.host.application_job_queue.')) {
+    if (
+      name.startsWith('zlink.host.core_hwm.') ||
+      name.startsWith('zlink.host.application_job_queue.')
+    ) {
       for (const provider of this.hostCapacities) {
         try {
           this.observeHostCapacity(name, provider(), result);
@@ -299,17 +300,29 @@ class MetricRegistry {
   ): void {
     const mesh = { mesh_name: snapshot.meshName };
     const peer = { ...mesh, source: snapshot.source };
-    if (name === 'zlink.mesh_node.peers.configured') result.observe(nonNegative(snapshot.configuredPeers), peer);
-    else if (name === 'zlink.mesh_node.peers.connected') result.observe(nonNegative(snapshot.connectedPeers), peer);
-    else if (name === 'zlink.mesh_node.peers.ready') result.observe(nonNegative(snapshot.readyPeers), peer);
+    if (name === 'zlink.mesh_node.peers.configured')
+      result.observe(nonNegative(snapshot.configuredPeers), peer);
+    else if (name === 'zlink.mesh_node.peers.connected')
+      result.observe(nonNegative(snapshot.connectedPeers), peer);
+    else if (name === 'zlink.mesh_node.peers.ready')
+      result.observe(nonNegative(snapshot.readyPeers), peer);
     else if (name === 'zlink.mesh_node.channels.ready_members') {
       for (const channel of snapshot.channels) {
-        result.observe(nonNegative(channel.readyMembers), { ...mesh, channel_name: channel.channelName });
+        result.observe(nonNegative(channel.readyMembers), {
+          ...mesh,
+          channel_name: channel.channelName
+        });
       }
     } else if (name.startsWith('zlink.object.capacity.')) {
       const field = metricSuffix(name);
-      result.observe(capacityValue(snapshot.actorCapacity, field), { ...mesh, capacity_scope: 'actor' });
-      result.observe(capacityValue(snapshot.spotCapacity, field), { ...mesh, capacity_scope: 'spot' });
+      result.observe(capacityValue(snapshot.actorCapacity, field), {
+        ...mesh,
+        capacity_scope: 'actor'
+      });
+      result.observe(capacityValue(snapshot.spotCapacity, field), {
+        ...mesh,
+        capacity_scope: 'spot'
+      });
     } else if (name.startsWith('zlink.spot.type.capacity.')) {
       const field = metricSuffix(name);
       for (const capacity of snapshot.spotTypeCapacities) {
@@ -350,7 +363,9 @@ export class ZLinkRuntimeMetrics {
     const owner = (provider ?? openTelemetryMetrics) as object;
     let registry = registries.get(owner);
     if (registry === undefined) {
-      const meter = (provider ?? openTelemetryMetrics).getMeter(ZLinkMeters.Framework) as ZLinkObservableMeter;
+      const meter = (provider ?? openTelemetryMetrics).getMeter(
+        ZLinkMeters.Framework
+      ) as ZLinkObservableMeter;
       registry = new MetricRegistry(meter);
       registries.set(owner, registry);
     }
@@ -365,7 +380,11 @@ export class ZLinkRuntimeMetrics {
     safe(() => this.registry.upDown.get(name)?.add(value, attributes));
   }
 
-  duration(name: HistogramName | string, seconds: number, attributes?: ZLinkMetricAttributes): void {
+  duration(
+    name: HistogramName | string,
+    seconds: number,
+    attributes?: ZLinkMetricAttributes
+  ): void {
     this.histogram(name, Math.max(0, seconds), 's', attributes);
   }
 
@@ -390,9 +409,7 @@ export class ZLinkRuntimeMetrics {
     return registration(() => this.registry.hostStates.delete(provider));
   }
 
-  registerHostCapacity(
-    provider: () => ZLinkHostCapacityStatus
-  ): ZLinkRuntimeMetricRegistration {
+  registerHostCapacity(provider: () => ZLinkHostCapacityStatus): ZLinkRuntimeMetricRegistration {
     this.registry.hostCapacities.add(provider);
     return registration(() => this.registry.hostCapacities.delete(provider));
   }
@@ -404,8 +421,10 @@ export class ZLinkRuntimeMetrics {
     return registration(() => this.registry.applicationJobQueuePressures.delete(provider));
   }
 
-  startRequest(meshName: string, surface: 'node' | 'channel' | 'spot' | 'instance_spot' | 'actor'):
-    ZLinkRequestMetricOperation {
+  startRequest(
+    meshName: string,
+    surface: 'node' | 'channel' | 'spot' | 'instance_spot' | 'actor'
+  ): ZLinkRequestMetricOperation {
     return new ZLinkRequestMetricOperation(this, meshName, surface);
   }
 
@@ -453,7 +472,10 @@ export class ZLinkRuntimeMetrics {
     });
   }
 
-  startInstanceSpotActivation(meshName: string, instanceSpotType: string): ZLinkRuntimeMetricOperation {
+  startInstanceSpotActivation(
+    meshName: string,
+    instanceSpotType: string
+  ): ZLinkRuntimeMetricOperation {
     const started = process.hrtime.bigint();
     let completed = false;
     return {

package/src/runtime/diagnostics/runtime-observation-queue.ts

@@ -1,7 +1,4 @@
-import type {
-  ZLinkObservationLoss,
-  ZLinkObservedStatus
-} from '../../contracts';
+import type { ZLinkObservationLoss, ZLinkObservedStatus } from '../../contracts';
 
 export const ZLINK_DEFAULT_TERMINAL_OBSERVATION_CAPACITY = 64;
 export const ZLINK_SIGNED_OBSERVATION_LOSS_MAXIMUM = 9_223_372_036_854_775_807n;
@@ -55,9 +52,7 @@ class RuntimeObservationLossState {
   }
 
   recordDiscardedTerminal(): void {
-    this.discardedTerminal = saturatingObservationLossIncrement(
-      this.discardedTerminal
-    );
+    this.discardedTerminal = saturatingObservationLossIncrement(this.discardedTerminal);
   }
 
   snapshot(): ZLinkObservationLoss {
@@ -74,8 +69,11 @@ class RuntimeObservationLossState {
  * dispatcher; they never invoke an iterator continuation directly.
  */
 export class RuntimeEventQueue<T>
-  implements AsyncIterable<ZLinkObservedStatus<T>>, AsyncIterator<ZLinkObservedStatus<T>>,
-    RuntimeObservationDispatchTarget {
+  implements
+    AsyncIterable<ZLinkObservedStatus<T>>,
+    AsyncIterator<ZLinkObservedStatus<T>>,
+    RuntimeObservationDispatchTarget
+{
   private readonly intermediateBySource = new Map<unknown, RetainedObservation<T>>();
   private readonly terminalFifo: Array<RetainedObservation<T> | undefined> = [];
   private readonly terminalCountBySource = new Map<unknown, number>();
@@ -108,7 +106,9 @@ export class RuntimeEventQueue<T>
     }
   }
 
-  [Symbol.asyncIterator](): AsyncIterator<ZLinkObservedStatus<T>> { return this; }
+  [Symbol.asyncIterator](): AsyncIterator<ZLinkObservedStatus<T>> {
+    return this;
+  }
 
   next(): Promise<IteratorResult<ZLinkObservedStatus<T>>> {
     if (this.waitersCount === 0) {
@@ -126,7 +126,7 @@ export class RuntimeEventQueue<T>
         return Promise.resolve({ done: true, value: undefined });
       }
     }
-    return new Promise(resolve => {
+    return new Promise((resolve) => {
       this.waiters.push(resolve);
       this.waitersCount += 1;
       if (this.hasRetained() || this.closed || this.completeWhenDrained) {
@@ -217,10 +217,7 @@ export class RuntimeEventQueue<T>
     }
     this.terminalFifo.push(this.retain(value, source));
     this.terminalCount += 1;
-    this.terminalCountBySource.set(
-      source,
-      (this.terminalCountBySource.get(source) ?? 0) + 1
-    );
+    this.terminalCountBySource.set(source, (this.terminalCountBySource.get(source) ?? 0) + 1);
     this.signalDispatcher();
   }
 
@@ -236,9 +233,8 @@ export class RuntimeEventQueue<T>
     const terminal = this.peekTerminal();
     const intermediate = this.oldestIntermediate();
     if (
-      terminal !== undefined
-      && (intermediate === undefined
-        || terminal.publishOrdinal <= intermediate.publishOrdinal)
+      terminal !== undefined &&
+      (intermediate === undefined || terminal.publishOrdinal <= intermediate.publishOrdinal)
     ) {
       return this.takeTerminal();
     }
@@ -248,9 +244,7 @@ export class RuntimeEventQueue<T>
   }
 
   private peekTerminal(): RetainedObservation<T> | undefined {
-    return this.terminalCount === 0
-      ? undefined
-      : this.terminalFifo[this.terminalHead];
+    return this.terminalCount === 0 ? undefined : this.terminalFifo[this.terminalHead];
   }
 
   private oldestIntermediate(): RetainedObservation<T> | undefined {
@@ -297,10 +291,7 @@ export class RuntimeEventQueue<T>
     if (this.terminalCount === 0) {
       this.terminalFifo.length = 0;
       this.terminalHead = 0;
-    } else if (
-      this.terminalHead >= 1024
-      && this.terminalHead * 2 >= this.terminalFifo.length
-    ) {
+    } else if (this.terminalHead >= 1024 && this.terminalHead * 2 >= this.terminalFifo.length) {
       this.terminalFifo.splice(0, this.terminalHead);
       this.terminalHead = 0;
     }
@@ -333,9 +324,7 @@ export class RuntimeEventQueue<T>
     return { status, loss: this.loss.snapshot() };
   }
 
-  private takeWaiter():
-    | ((result: IteratorResult<ZLinkObservedStatus<T>>) => void)
-    | undefined {
+  private takeWaiter(): ((result: IteratorResult<ZLinkObservedStatus<T>>) => void) | undefined {
     if (this.waitersCount === 0) return undefined;
     const waiter = this.waiters[this.waitersHead];
     this.waiters[this.waitersHead] = undefined;