@zlink-systems/framework 0.21.0 → 0.23.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,
@@ -38,6 +34,7 @@ export const DEFAULT_ZLINK_DIAGNOSTICS: ZLinkDiagnosticsOptions = {
 
 const telemetryLogger = openTelemetryLogs.getLogger('@zlink-systems/framework');
 const telemetryTracer = openTelemetryTrace.getTracer('@zlink-systems/framework');
+const ERROR_MESSAGE_MAX_LENGTH = 512;
 let diagnosticsGeneration = 0n;
 
 interface ZLinkTelemetryRecord {
@@ -45,8 +42,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;
@@ -65,6 +69,7 @@ interface ZLinkTelemetryRecord {
   readonly instanceSpotType?: string;
   readonly activationState?: string;
   readonly actorId?: string;
+  readonly streamSessionId?: string;
   readonly commandId?: number;
   readonly messageSizeBytes?: number;
   readonly durationSeconds?: number;
@@ -102,10 +107,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 +125,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 +181,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 +204,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);
   }
 
@@ -217,24 +228,27 @@ export class ZLinkMessageFlowTracer {
     acceptedFlowId?: string,
     acceptedFlowOrigin?: ZLinkFlowOrigin
   ): void {
-    const ambient = acceptedFlowId === undefined ? currentFlowContext() : undefined;
+    const ambient = currentFlowContext();
     const flowId = flowInput.flowId ?? acceptedFlowId ?? ambient?.flowId;
     const flowOrigin = flowInput.flowOrigin ?? acceptedFlowOrigin ?? ambient?.flowOrigin;
     const flow: ZLinkRuntimeMessageFlowEvent = {
       ...flowInput,
       ...(flowId === undefined ? {} : { flowId, flowOrigin }),
+      streamSessionId: flowInput.streamSessionId ?? ambient?.streamSessionId,
       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 +257,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 +274,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 +299,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 +356,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,18 +377,18 @@ 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,
     actorId: flow.actorId,
+    streamSessionId: flow.streamSessionId,
     commandId: flow.commandId,
     messageSizeBytes,
     durationSeconds,
     errorType: flow.errorType,
-    errorMessage: boundedText(flow.errorMessage),
+    errorMessage: flow.errorMessage,
     errorCauseType: flow.errorCauseType,
     errorCauseMessage: boundedText(flow.errorCauseMessage)
   };
@@ -405,6 +425,7 @@ function structuredLogAttributes(record: ZLinkTelemetryRecord): Attributes {
     instance_spot_type: record.instanceSpotType,
     activation_state: record.activationState,
     actor_id: record.actorId,
+    stream_session_id: record.streamSessionId,
     correlation_id: record.correlationId,
     flow_id: record.flowId,
     flow_origin: record.flowOrigin,
@@ -440,11 +461,15 @@ function structuredLogBodyAttributes(record: ZLinkTelemetryRecord): Attributes {
     instance_type: record.instanceSpotType,
     activation_state: record.activationState,
     actor: record.actorId,
+    session: record.streamSessionId,
     corr: record.correlationId,
     flow: record.flowId,
     origin: record.flowOrigin,
     outcome: record.outcome,
     reason: record.reason,
+    action: record.action,
+    error_type: record.errorType,
+    error_message: record.errorMessage,
     size: record.messageSizeBytes
   });
 }
@@ -455,7 +480,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 +490,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 +543,7 @@ function messageFlowSurface(
   }
 }
 
-function messageFlowKind(
-  kind: ZLinkDispatchMessageKind
-): ZLinkTelemetryRecord['messageKind'] {
+function messageFlowKind(kind: ZLinkDispatchMessageKind): ZLinkTelemetryRecord['messageKind'] {
   switch (kind) {
     case ZLinkDispatchMessageKind.Request:
     case ZLinkDispatchMessageKind.ActorRequest:
@@ -552,7 +580,7 @@ function hashFlowId(flowId: string): number {
 }
 
 function boundedText(value: string | undefined): string | undefined {
-  return value === undefined ? undefined : value.slice(0, 512);
+  return value === undefined ? undefined : value.slice(0, ERROR_MESSAGE_MAX_LENGTH);
 }
 
 function toSnakeCase(value: string): string {

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 {