@a4anthony/proctorkit-sdk 0.1.1 → 0.2.0

package/dist/preflight/system-check.d.ts

@@ -93,14 +93,13 @@ export interface RequiredCapabilitiesConfig {
  */
 export interface ThresholdsConfig {
     /**
-     * Minimum download bandwidth (Mbps) for the connection check to
-     * pass. A measurement below this trips `slow-connection`.
-     * Default: 2.
+     * Download-bandwidth reference used for internal quality telemetry. Browser
+     * Mbps estimates do not decide candidate eligibility. Default: 2.
      */
     minBandwidthMbps?: number;
     /**
-     * Minimum application-path upload bandwidth (Mbps). Upload is the primary
-     * gate for continuous webcam and screen recordings. Default: 2.
+     * Upload-bandwidth reference used for internal quality telemetry. Recording
+     * readiness is derived from the enabled media workload instead. Default: 2.
      */
     minUploadBandwidthMbps?: number;
     /**
@@ -133,6 +132,13 @@ export interface ThresholdsConfig {
      */
     allowMobile?: boolean;
 }
+export interface ConnectionReadinessCheckResult {
+    mode: "direct" | "segments" | "post";
+    payloadBytes: number;
+    completionWindowMs: number;
+    sampleDurationsMs: number[];
+    medianCompletionMs: number;
+}
 export interface SystemCheckOptions {
     /**
      * Mode controls the row list and the short-circuit behaviour:
@@ -191,6 +197,11 @@ export interface SystemCheckOptions {
      * SDK consumers.
      */
     connectionTest?: HttpConnectionProbeOptions & ConnectionQualityOptions;
+    /**
+     * Optional workload-aware recording-path check. When supplied, this is the
+     * candidate eligibility signal; numeric speed tests remain telemetry only.
+     */
+    connectionReadiness?: () => Promise<ConnectionReadinessCheckResult>;
 }
 /** JSON-serialisable final report. No class instances, safe to log + persist. */
 export interface PreflightReport {

package/dist/preflight/system-check.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"system-check.d.ts","sourceRoot":"","sources":["../../src/preflight/system-check.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAEH,OAAO,EASL,KAAK,SAAS,EACd,KAAK,cAAc,EACnB,KAAK,QAAQ,EACb,KAAK,UAAU,EACf,KAAK,QAAQ,EACd,MAAM,aAAa,CAAC;AACrB,OAAO,EAGL,KAAK,wBAAwB,EAC7B,KAAK,0BAA0B,EAChC,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAEL,KAAK,sBAAsB,EAC5B,MAAM,wBAAwB,CAAC;AAEhC,YAAY,EAAE,SAAS,EAAE,cAAc,EAAE,QAAQ,EAAE,UAAU,EAAE,QAAQ,EAAE,CAAC;AAE1E,MAAM,MAAM,eAAe,GAAG,MAAM,GAAG,QAAQ,GAAG,SAAS,CAAC;AAE5D,mFAAmF;AACnF,MAAM,WAAW,iBAAiB;IAChC,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB;;;;;;;OAOG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,WAAW,kBAAkB;IACjC,qBAAqB;IACrB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,qBAAqB;IACrB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,qBAAqB;IACrB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,qBAAqB;IACrB,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,qBAAqB;IACrB,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED,4EAA4E;AAC5E,MAAM,WAAW,0BAA0B;IACzC;;;OAGG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED;;;;;GAKG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B;;;OAGG;IACH,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC;;;;;;OAMG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB;;;;;;OAMG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB;;;;OAIG;IACH,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B;;;;;OAKG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED,MAAM,WAAW,kBAAkB;IACjC;;;;;;;;;;OAUG;IACH,IAAI,CAAC,EAAE,eAAe,CAAC;IACvB,4CAA4C;IAC5C,KAAK,CAAC,EAAE,iBAAiB,CAAC;IAC1B,oEAAoE;IACpE,MAAM,CAAC,EAAE,kBAAkB,CAAC;IAC5B,8DAA8D;IAC9D,oBAAoB,CAAC,EAAE,0BAA0B,CAAC;IAClD,qFAAqF;IACrF,UAAU,CAAC,EAAE,gBAAgB,CAAC;IAC9B;;;;OAIG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,4EAA4E;IAC5E,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB;;;OAGG;IACH,SAAS,CAAC,EAAE,cAAc,CAAC;IAC3B;;;;OAIG;IACH,UAAU,CAAC,EAAE,IAAI,CAAC,sBAAsB,EAAE,eAAe,CAAC,CAAC;IAC3D;;;;OAIG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;;OAIG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB;;;;OAIG;IACH,cAAc,CAAC,EAAE,0BAA0B,GAAG,wBAAwB,CAAC;CACxE;AAED,iFAAiF;AACjF,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,eAAe,CAAC;IACtB,MAAM,EAAE,OAAO,CAAC;IAChB,IAAI,EAAE,QAAQ,EAAE,CAAC;IACjB,QAAQ,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,SAAS,CAAC;QAAC,IAAI,EAAE,QAAQ,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACrE,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,6CAA6C;AAC7C,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,SAAS,CAAC;IAChB,KAAK,EAAE,UAAU,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;;;GAIG;AACH,MAAM,MAAM,mBAAmB,GAAG,CAAC,IAAI,EAAE,aAAa,CAAC,QAAQ,CAAC,KAAK,IAAI,CAAC;AA8B1E;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,EAAE,QAAQ,CAAC,gBAAgB,CAOzD,CAAC;AAyBF,qBAAa,WAAW;IACtB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAkB;IAC1C,OAAO,CAAC,IAAI,CAAa;IACzB,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAkC;IAC5D,OAAO,CAAC,OAAO,CAAS;gBAEZ,OAAO,GAAE,kBAAuB;IAsB5C;;;OAGG;IACH,KAAK,IAAI,IAAI;IAKb;;;;;;OAMG;IACH,OAAO,IAAI,aAAa,CAAC,QAAQ,CAAC;IAMlC;;;;OAIG;IACH,SAAS,CAAC,QAAQ,EAAE,mBAAmB,GAAG,MAAM,IAAI;IAQpD;;;;;OAKG;IACI,GAAG,IAAI,cAAc,CAAC,aAAa,CAAC,QAAQ,CAAC,EAAE,eAAe,EAAE,IAAI,CAAC;IA8D5E,0EAA0E;IACpE,OAAO,IAAI,OAAO,CAAC,eAAe,CAAC;IAYzC;;;;OAIG;IACG,YAAY,CAAC,OAAO,EAAE,oBAAoB,EAAE,GAAG,OAAO,CAAC,eAAe,CAAC;YAmD/D,OAAO;YAoCP,MAAM;YAUN,aAAa;IAyD3B;;;;;OAKG;IACG,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC;IAQrC;;;;;;OAMG;YACW,sBAAsB;IAiCpC,wEAAwE;IACxE,OAAO,CAAC,WAAW;IAMnB,kEAAkE;IAClE,OAAO,CAAC,WAAW;IASnB;;;;;;OAMG;IACG,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAUhD;;;;;OAKG;IACG,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC;IASnC;;;;OAIG;IACG,WAAW,CACf,QAAQ,CAAC,EAAE,MAAM,EACjB,cAAc,CAAC,EAAE;QAAE,YAAY,EAAE,gBAAgB,CAAA;KAAE,GAClD,OAAO,CAAC;QACT;;;;;;WAMG;QACH,QAAQ,EAAE,OAAO,wBAAwB,EAAE,iBAAiB,EAAE,CAAC;KAChE,CAAC;IAiBF;;;;;;;;;;;;;;;;;;;;;;;;;OAyBG;IACG,gBAAgB,CAAC,QAAQ,GAAE,OAAc,GAAG,OAAO,CAAC,IAAI,CAAC;YAiCjD,QAAQ;IAoDtB;;;;OAIG;YACW,kBAAkB;IAuFhC,OAAO,CAAC,gBAAgB;IAwCxB,OAAO,CAAC,MAAM;IAId,OAAO,CAAC,QAAQ;IAOhB,OAAO,CAAC,WAAW;IAWnB,OAAO,CAAC,MAAM;IAWd,OAAO,CAAC,WAAW;IAqBnB,OAAO,CAAC,KAAK;CAId;AAED;;;GAGG;AACH,eAAO,MAAM,cAAc,GACzB,UAAS,kBAAuB,KAC/B,OAAO,CAAC,eAAe,CAAuC,CAAC"}
+{"version":3,"file":"system-check.d.ts","sourceRoot":"","sources":["../../src/preflight/system-check.ts"],"names":[],"mappings":"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"}

package/dist/recording-delivery-readiness.d.ts

@@ -1,9 +1,31 @@
-interface RecordingReadinessConfig {
+export interface RecordingReadinessConfig {
     sessionId: string;
     ingestUrl: string;
     appId?: string;
 }
+export interface RecordingDeliveryMeasurementConfig extends RecordingReadinessConfig {
+    /** Representative bytes produced by the enabled recorders in one workload window. */
+    payloadBytes: number;
+    /** Maximum acceptable upload completion time for the representative payload. */
+    completionWindowMs: number;
+    /** Number of scored uploads. Default: 3; bounded to 1..5. */
+    samples?: number;
+    /** Injectable monotonic clock for deterministic tests. */
+    now?: () => number;
+}
+export interface RecordingDeliveryMeasurement {
+    mode: "direct" | "segments" | "post";
+    payloadBytes: number;
+    completionWindowMs: number;
+    sampleDurationsMs: number[];
+    medianCompletionMs: number;
+}
 /** Verify the server-selected recording path. No host-facing controls exist. */
 export declare function verifyRecordingDelivery(config: RecordingReadinessConfig): Promise<"direct" | "segments" | "post">;
-export {};
+/**
+ * Measure whether the real recording destination can absorb the configured
+ * media workload. A disposable warm-up is excluded, then the median of the
+ * scored uploads is compared with the workload completion window.
+ */
+export declare function measureRecordingDeliveryReadiness(config: RecordingDeliveryMeasurementConfig): Promise<RecordingDeliveryMeasurement>;
 //# sourceMappingURL=recording-delivery-readiness.d.ts.map

package/dist/recording-delivery-readiness.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"recording-delivery-readiness.d.ts","sourceRoot":"","sources":["../src/recording-delivery-readiness.ts"],"names":[],"mappings":"AAKA,UAAU,wBAAwB;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAQD,gFAAgF;AAChF,wBAAsB,uBAAuB,CAC3C,MAAM,EAAE,wBAAwB,GAC/B,OAAO,CAAC,QAAQ,GAAG,UAAU,GAAG,MAAM,CAAC,CAgDzC"}
+{"version":3,"file":"recording-delivery-readiness.d.ts","sourceRoot":"","sources":["../src/recording-delivery-readiness.ts"],"names":[],"mappings":"AAOA,MAAM,WAAW,wBAAwB;IACvC,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,kCAAmC,SAAQ,wBAAwB;IAClF,qFAAqF;IACrF,YAAY,EAAE,MAAM,CAAC;IACrB,gFAAgF;IAChF,kBAAkB,EAAE,MAAM,CAAC;IAC3B,6DAA6D;IAC7D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,0DAA0D;IAC1D,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,4BAA4B;IAC3C,IAAI,EAAE,QAAQ,GAAG,UAAU,GAAG,MAAM,CAAC;IACrC,YAAY,EAAE,MAAM,CAAC;IACrB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,iBAAiB,EAAE,MAAM,EAAE,CAAC;IAC5B,kBAAkB,EAAE,MAAM,CAAC;CAC5B;AASD,gFAAgF;AAChF,wBAAsB,uBAAuB,CAC3C,MAAM,EAAE,wBAAwB,GAC/B,OAAO,CAAC,QAAQ,GAAG,UAAU,GAAG,MAAM,CAAC,CAgDzC;AAED;;;;GAIG;AACH,wBAAsB,iCAAiC,CACrD,MAAM,EAAE,kCAAkC,GACzC,OAAO,CAAC,4BAA4B,CAAC,CA4EvC"}

package/dist/worker.js

@@ -504,11 +504,14 @@ function indexedDbOpenFailureReason(err) {
 class DeliveryReadinessError extends Error {
   code;
   status;
+  /** Structured operator diagnostics. Never render this object in candidate UI. */
+  details;
   constructor(code, message, options) {
     super(message, options?.cause !== void 0 ? { cause: options.cause } : void 0);
     this.name = "DeliveryReadinessError";
     this.code = code;
     this.status = options?.status;
+    this.details = options?.details;
   }
 }
 function newId(prefix) {
@@ -873,8 +876,8 @@ function sleep(ms, signal) {
     );
   });
 }
-const SDK_VERSION = "0.1.1";
-const SDK_BUILD_SHA = "de98da0125619b3b2d4486f45c10d4a8f7a85113";
+const SDK_VERSION = "0.2.0";
+const SDK_BUILD_SHA = "0e08674057f5d4f2e5c5fac34cd5feeaa40d97f4";
 const SDK_BUILD_INFO = Object.freeze({
   sdkVersion: SDK_VERSION,
   buildSha: SDK_BUILD_SHA

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@a4anthony/proctorkit-sdk",
-  "version": "0.1.1",
+  "version": "0.2.0",
   "description": "Framework-agnostic browser SDK for the proctoring platform",
   "license": "MIT",
   "type": "module",
@@ -27,7 +27,7 @@
   "dependencies": {
     "idb": "^8.0.3",
     "rrweb": "2.1.1",
-    "@a4anthony/proctorkit-types": "0.2.0"
+    "@a4anthony/proctorkit-types": "0.3.0"
   },
   "devDependencies": {
     "@tailwindcss/vite": "^4.3.0",

package/src/delivery-readiness.ts

@@ -10,15 +10,22 @@ export type { DeliveryReadinessErrorCode } from "@a4anthony/proctorkit-types";
 export class DeliveryReadinessError extends Error {
   readonly code: DeliveryReadinessErrorCode;
   readonly status: number | undefined;
+  /** Structured operator diagnostics. Never render this object in candidate UI. */
+  readonly details: Readonly<Record<string, string | number>> | undefined;
 
   constructor(
     code: DeliveryReadinessErrorCode,
     message: string,
-    options?: { cause?: unknown; status?: number },
+    options?: {
+      cause?: unknown;
+      status?: number;
+      details?: Readonly<Record<string, string | number>>;
+    },
   ) {
     super(message, options?.cause !== undefined ? { cause: options.cause } : undefined);
     this.name = "DeliveryReadinessError";
     this.code = code;
     this.status = options?.status;
+    this.details = options?.details;
   }
 }

package/src/index.ts

@@ -101,6 +101,12 @@ export type {
   WorkerToMainMessage,
 } from "@a4anthony/proctorkit-types";
 export { DeliveryReadinessError } from "./delivery-readiness.js";
+export { measureRecordingDeliveryReadiness } from "./recording-delivery-readiness.js";
+export type {
+  RecordingDeliveryMeasurement,
+  RecordingDeliveryMeasurementConfig,
+  RecordingReadinessConfig,
+} from "./recording-delivery-readiness.js";
 export type { DomObserversConfig } from "./observers/dom-observers.js";
 export type {
   RequestScreenShareOptions,
@@ -3759,6 +3765,7 @@ export type {
   CheckOverrides,
   CheckRow,
   CheckState,
+  ConnectionReadinessCheckResult,
   FailCode,
   MediaChecksConfig,
   PreflightReport,

package/src/preflight/checks.ts

@@ -66,8 +66,7 @@ export const RETRYABLE_FAIL_CODES: ReadonlySet<FailCode> = new Set([
 ]);
 
 /** True when a "Retry" could plausibly clear this failure without a reload. */
-export const isRetryableFailCode = (code: FailCode): boolean =>
-  RETRYABLE_FAIL_CODES.has(code);
+export const isRetryableFailCode = (code: FailCode): boolean => RETRYABLE_FAIL_CODES.has(code);
 
 /** Per-check state. Each row stores its own state plus any kind-specific payload. */
 export type CheckState =
@@ -107,6 +106,16 @@ export interface CheckRow {
   latencyMs?: number;
   /** Median variation between latency samples in milliseconds. Connection row only. */
   jitterMs?: number;
+  /** Server-selected recording upload mode verified by the readiness canary. */
+  recordingUploadMode?: "direct" | "segments" | "post";
+  /** Representative readiness payload size. Internal telemetry only. */
+  readinessPayloadBytes?: number;
+  /** Median representative upload completion time. Internal telemetry only. */
+  readinessMedianMs?: number;
+  /** Workload-derived completion window. Internal telemetry only. */
+  readinessWindowMs?: number;
+  /** Number of successful representative readiness samples. Internal telemetry only. */
+  readinessSampleCount?: number;
   /**
    * Plain-language quality bucket for a PASSING connection row (Fair / Good /
    * Excellent), relative to the configured floor. Absent on fail rows and on
@@ -133,13 +142,13 @@ export interface CheckOverrides {
   screenShareSupported?: boolean;
 }
 
-/** Minimum acceptable downlink speed in megabits/sec. */
+/** Default reference floor for downlink quality telemetry in megabits/sec. */
 export const MIN_SPEED_MBPS = 2;
 
 /**
- * Plain-language quality bucket shown to the candidate INSTEAD of a raw Mbps
- * figure. Below the floor is not a band — that's the `slow-connection` fail —
- * so a passing connection is always one of these three.
+ * Plain-language quality bucket for measured connection telemetry. A value
+ * below the reference floor has no band; measured Mbps never decides candidate
+ * eligibility.
  */
 export type ConnectionBand = "fair" | "good" | "excellent";
 
@@ -154,21 +163,11 @@ const BAND_GOOD_MULTIPLE = 1.5;
 const BAND_EXCELLENT_MULTIPLE = 3;
 
 /**
- * Bucket a measured speed into a {@link ConnectionBand} relative to the floor.
- * Returns null below the floor (the fail path owns that) or for a non-finite /
- * non-positive input or floor. Pure — the single source of truth for both the
- * application-path and legacy download-only rows.
+ * Bucket a measured speed into a {@link ConnectionBand} relative to the
+ * reference floor. Returns null below the floor or for invalid inputs.
  */
-export const connectionQualityBand = (
-  mbps: number,
-  floorMbps: number,
-): ConnectionBand | null => {
-  if (
-    !Number.isFinite(mbps) ||
-    !Number.isFinite(floorMbps) ||
-    floorMbps <= 0 ||
-    mbps < floorMbps
-  ) {
+export const connectionQualityBand = (mbps: number, floorMbps: number): ConnectionBand | null => {
+  if (!Number.isFinite(mbps) || !Number.isFinite(floorMbps) || floorMbps <= 0 || mbps < floorMbps) {
     return null;
   }
   if (mbps >= floorMbps * BAND_EXCELLENT_MULTIPLE) return "excellent";
@@ -228,9 +227,7 @@ export const checkBrowser = (overrides?: CheckOverrides): CheckRow => {
   // Safari is a separate beast (no getDisplayMedia, OS interruptions
   // mid-session) and stays as `unsupported-browser`.
   const code: FailCode =
-    browser.name === "Chrome" ||
-    browser.name === "Edge" ||
-    browser.name === "Safari"
+    browser.name === "Chrome" || browser.name === "Edge" || browser.name === "Safari"
       ? "outdated-browser"
       : "unsupported-browser";
 
@@ -271,14 +268,12 @@ export const checkDevice = (
   const lowMem = overrides?.isLowMemory ?? isLowMemoryDevice();
   // Non-iOS mobile gate. iOS is already covered by `iosBlocked`
   // above, so we only check the remaining mobile case here.
-  const mobileBlocked =
-    !allowMobile && !iosBlocked && isMobileOrTablet() && !isIOS();
+  const mobileBlocked = !allowMobile && !iosBlocked && isMobileOrTablet() && !isIOS();
   const screenShareSupported =
     overrides?.screenShareSupported ??
     (typeof navigator !== "undefined" &&
       typeof navigator.mediaDevices?.getDisplayMedia === "function");
-  const requiredScreenShareUnavailable =
-    requireScreenShareSupport && !screenShareSupported;
+  const requiredScreenShareUnavailable = requireScreenShareSupport && !screenShareSupported;
 
   if (iosBlocked) {
     return {
@@ -464,10 +459,7 @@ const measureLatency = (): Promise<number | null> =>
     ping();
   });
 
-const downloadTest = (
-  bytes: number,
-  timeoutMs: number,
-): Promise<number | null> =>
+const downloadTest = (bytes: number, timeoutMs: number): Promise<number | null> =>
   new Promise((resolve) => {
     const xhr = new XMLHttpRequest();
     const url = `${CLOUDFLARE_SPEED_URL}?bytes=${bytes}&_=${Date.now()}${Math.random()}`;
@@ -551,11 +543,9 @@ export const checkConnection = (overrides?: CheckOverrides): CheckRow | null =>
 };
 
 /**
- * Build the connection row from a measured speed (or null on
- * measurement failure). The `minMbps` threshold defaults to the
- * module-level `MIN_SPEED_MBPS` so existing call sites work
- * unchanged; the engine threads the policy override through when
- * present.
+ * Build the connection row from a measured speed (or null on measurement
+ * failure). Numeric speed is retained as telemetry, but never gates the
+ * candidate because short browser probes are dominated by request latency.
  */
 export const applySpeedToResult = (
   speed: number | null,
@@ -571,17 +561,6 @@ export const applySpeedToResult = (
       },
     };
   }
-  if (speed < minMbps) {
-    return {
-      kind: "connection",
-      state: {
-        kind: "fail",
-        code: "slow-connection",
-        detail: `${speed} Mbps`,
-      },
-      mbps: speed,
-    };
-  }
   const band = connectionQualityBand(speed, minMbps);
   return {
     kind: "connection",
@@ -592,10 +571,9 @@ export const applySpeedToResult = (
 };
 
 /**
- * Apply policy to the richer application-path result. Upload is evaluated
- * first because recordings must leave the browser faster than MediaRecorder
- * produces them. The existing `slow-connection` code remains the stable
- * public contract; direction-specific values are carried on the row.
+ * Preserve application-path measurements as internal diagnostics. A completed
+ * measurement passes regardless of the estimated Mbps; candidate eligibility
+ * is decided separately by the workload-aware recording-storage canary.
  */
 export const applyConnectionQualityToResult = (
   result: ConnectionQualityResult,
@@ -622,42 +600,16 @@ export const applyConnectionQualityToResult = (
       ...fields,
     };
   }
-  if (upload < minUploadMbps) {
-    return {
-      kind: "connection",
-      state: {
-        kind: "fail",
-        code: "slow-connection",
-        detail: `Upload ${result.uploadMbps ?? upload} Mbps`,
-      },
-      ...fields,
-    };
-  }
-  if (download < minDownloadMbps) {
-    return {
-      kind: "connection",
-      state: {
-        kind: "fail",
-        code: "slow-connection",
-        detail: `Download ${result.downloadMbps ?? download} Mbps`,
-      },
-      ...fields,
-    };
-  }
-  // Band the WORST of the two directions off the conservative p25 (the same
-  // value the gate above used), so the label reflects the binding constraint
-  // and can never sit above the pass/fail line.
-  const band = worseBand(
-    connectionQualityBand(upload, minUploadMbps),
-    connectionQualityBand(download, minDownloadMbps),
-  );
+  // Band the worst direction only when both values meet the configured
+  // reference floors. The band is display telemetry, never a gate.
+  const uploadBand = connectionQualityBand(upload, minUploadMbps);
+  const downloadBand = connectionQualityBand(download, minDownloadMbps);
+  const band = uploadBand && downloadBand ? worseBand(uploadBand, downloadBand) : null;
   return {
     kind: "connection",
     state: {
       kind: "pass",
-      detail: band
-        ? BAND_LABELS[band]
-        : `Up ${result.uploadMbps} · Down ${result.downloadMbps} Mbps`,
+      detail: band ? BAND_LABELS[band] : "Connection available",
     },
     ...fields,
     ...(band ? { band } : {}),
@@ -676,10 +628,7 @@ const BAND_RANK: Record<ConnectionBand, number> = {
  * this branch — the gate already failed the row — so treat null as "no
  * opinion" and fall back to the other direction.
  */
-function worseBand(
-  a: ConnectionBand | null,
-  b: ConnectionBand | null,
-): ConnectionBand | null {
+function worseBand(a: ConnectionBand | null, b: ConnectionBand | null): ConnectionBand | null {
   if (a === null) return b;
   if (b === null) return a;
   return BAND_RANK[a] <= BAND_RANK[b] ? a : b;