@torrent-tv/proxy 2.89.17 → 2.89.19

package/test/decode-cost.test.js

@@ -1,475 +0,0 @@
-/**
- * @file What a re-encode costs on this host, decoding included.
- *
- * The budget used to price the encoder alone. Measured on the addon host
- * 2026-08-14, that made it offer a 240p rung it then ran at 0.388-0.947x while
- * claiming the host cleared the bar 2.5 times over — the error on that rung was
- * 209 %. The decode term brings a controlled measurement to within 5 %.
- *
- * WHAT IS ASSERTED HERE IS ARITHMETIC, over constants that were measured once
- * on the addon host and written down. The live benchmark used to run here too —
- * on the reasoning that a fit which only ever meets invented numbers can be
- * wrong in every way that matters — and it could not be asserted about: a clip
- * that "said nothing" under load makes the whole benchmark answer with nothing,
- * so the very first line of that test failed by luck. The orderings it was for
- * are held over the fit itself, deterministically, in `decode-cost-fit.test.js`.
- *
- * What no test covers as a result is the live path — lifting a clip out of its
- * container, feeding it through the pipe, reading the slope. That is integration
- * over real ffmpeg, and it belongs to a stand run before a release rather than
- * to a check that measures whatever else the machine was doing (roadmap item
- * 52).
- */
-
-import test from "node:test";
-import assert from "node:assert/strict";
-import { Timeline } from "../services/encode/output/Timeline.js";
-import { createRequire } from "node:module";
-import { spawn } from "node:child_process";
-import { mkdtemp, rm } from "node:fs/promises";
-import { decodeCostOf, decodeFamilyOf } from "../services/encode/decode-cost-fit.js";
-import { Output } from "../services/encode/output/Output.js";
-import { outputSpec } from "./helpers/output-spec.js";
-import os from "node:os";
-import path from "node:path";
-import {
-  canSustainOutput,
-  decodeSpeedFor,
-  predictedRealtimeSpeed,
-  speedBar
-} from "../services/encode/hwaccel.js";
-import { wireOutputs } from "../services/server/wire-outputs.js";
-import { SourceFile, sourceDecodeCharacteristics } from "../services/media/SourceFile.js";
-import { parseFfmpegBitrateKbps, parseFfmpegVideoDimensions, parseFfmpegVideoFps } from "../services/media/ffmpeg-banner.js";
-import { fmp4Format } from "../services/encode/segment-formats/fmp4.js";
-
-const require = createRequire(import.meta.url);
-const ffmpegBin = require("ffmpeg-static");
-const CALIBRATION_DIR = path.join(import.meta.dirname, "..", "assets", "calibration");
-
-// The constants measured on the addon host (CM4) on 2026-08-14. Used here as
-// a fixed host, so the arithmetic can be checked against figures that were
-// measured rather than against figures this test invented.
-const ADDON_HOST_MODEL = { pixelTerm: 0.005555, bitrateTerm: 0.00990, constantTerm: 0.0572 };
-// The film measured that day: 1920x1080 at 24 fps, about 8 Mbit/s.
-const MEASURED_FILM = { megapixelsPerSecond: (1920 * 1080 * 24) / 1e6, megabitsPerSecond: 8 };
-
-test("decode cost prices the film it was checked against", () => {
-  const speed = decodeSpeedFor(ADDON_HOST_MODEL, MEASURED_FILM);
-
-  // 0.005555 x 49.77 + 0.00990 x 8 + 0.0572 = 0.4129 s per second of video.
-  assert.ok(Math.abs(1 / speed - 0.4129) < 0.001, `cost was ${(1 / speed).toFixed(4)} s/s`);
-  // Measured that day: 0.434 s/s. The claim is 5 %, not exactness.
-  assert.ok(Math.abs(1 / speed - 0.434) / 0.434 < 0.05);
-});
-
-test("decoding and encoding share the machine, so their speeds combine", () => {
-  // The rung that broke playback: 240p at 24 fps, encoded at 5.99x by the
-  // measurement, decoded at 2.31x. Measured combined speed was 1.48x.
-  const outputPixelsPerSec = 426 * 240 * 24;
-  const speed = predictedRealtimeSpeed({
-    decodeModel: { pixelTerm: 0, bitrateTerm: 0, constantTerm: 1 / 2.31 },
-    encodePixelsPerSec: outputPixelsPerSec * 5.99,
-    outputPixelsPerSec,
-    source: MEASURED_FILM
-  });
-
-  assert.ok(Math.abs(speed - 1.67) < 0.01, `predicted ${speed.toFixed(2)}x`);
-  // 1.67 against the 1.48x that rung measured under a controlled encode: 12.8 %
-  // out. The figure is pinned so a change to the combination has to state what
-  // it does to it.
-  assert.ok(Math.abs(speed - 1.48) / 1.48 < 0.13);
-});
-
-test("with no decode fit the prediction is the encoder alone — what it was before", () => {
-  const outputPixelsPerSec = 426 * 240 * 24;
-  const speed = predictedRealtimeSpeed({
-    decodeModel: null,
-    encodePixelsPerSec: outputPixelsPerSec * 5.99,
-    outputPixelsPerSec,
-    source: MEASURED_FILM
-  });
-
-  assert.equal(speed, 5.99, "the old figure, four times the truth on that rung");
-});
-
-test("a rung is refused when the combined speed is under the bar", () => {
-  // The addon host's fastest preset, read from its own log: 11.2 Mpx/s.
-  const benchmark = [{ preset: "ultrafast", pixelsPerSec: 11.2e6 }];
-  const source = MEASURED_FILM;
-
-  const heavy = canSustainOutput({
-    benchmark,
-    decodeModel: ADDON_HOST_MODEL,
-    source,
-    outputPixelsPerSec: 1280 * 720 * 24
-  });
-  assert.equal(heavy.sustainable, false, "720p needs 22 Mpx/s from an 11.2 Mpx/s host");
-  assert.ok(heavy.speed < 1, `predicted ${heavy.speed.toFixed(2)}x`);
-
-  // The 240p rung of that film predicts 1.58x on an idle machine, and with
-  // nothing known about the swarm the bar is realtime, so it is offered.
-  const light = canSustainOutput({
-    benchmark,
-    decodeModel: ADDON_HOST_MODEL,
-    source,
-    outputPixelsPerSec: 426 * 240 * 24
-  });
-  assert.ok(Math.abs(light.speed - 1.58) < 0.01, `predicted ${light.speed.toFixed(2)}x`);
-  assert.equal(light.sustainable, true);
-});
-
-test("the bar is what this file's own supply demands, when it has been measured", () => {
-  // The field torrent of 2026-08-17: waits of 1.49 s median arriving every
-  // 2.22 s demand 1.67x of any step that is to survive them. The same 240p rung
-  // predicted at 1.58x clears realtime and does not clear that.
-  const benchmark = [{ preset: "ultrafast", pixelsPerSec: 11.2e6 }];
-  const rung = {
-    benchmark,
-    decodeModel: ADDON_HOST_MODEL,
-    source: MEASURED_FILM,
-    outputPixelsPerSec: 426 * 240 * 24
-  };
-  assert.equal(canSustainOutput({ ...rung, requiredSpeed: 1.67 }).sustainable, false);
-  assert.equal(canSustainOutput({ ...rung, requiredSpeed: 1.2 }).sustainable, true);
-  // A swarm that has not been measured cannot raise the bar, and cannot lower
-  // it below realtime either.
-  assert.equal(speedBar(null), 1);
-  assert.equal(speedBar(0.4), 1);
-  assert.equal(speedBar(1.67), 1.67);
-});
-
-test("a reading from the running encoder outranks the model of the clips", () => {
-  // The field case, 2026-08-14: the 240p rung of that film ran at 0.95x at its
-  // best on a host whose fastest preset benchmarked at 11.2 Mpx/s. Subtracting
-  // the encode half of that reading leaves what the SOURCE costs to decode
-  // there — 0.83 s per second of video, i.e. 1.20x — which is four times what
-  // the H.264 clips predicted for it, and is the truth about this file.
-  const benchmark = [{ preset: "ultrafast", pixelsPerSec: 11.2e6 }];
-  const observedDecodeCostSec = 1 / 0.95 - (426 * 240 * 24) / 11.2e6;
-  assert.ok(Math.abs(observedDecodeCostSec - 0.8335) < 0.001);
-
-  const withObservation = canSustainOutput({
-    benchmark,
-    decodeModel: ADDON_HOST_MODEL,
-    source: MEASURED_FILM,
-    outputPixelsPerSec: 426 * 240 * 24,
-    observedDecodeCostSec
-  });
-
-  // The same rung the clip model called 1.58x and admitted is now priced at
-  // 0.95x — the speed it was actually seen to run at — and refused.
-  assert.ok(Math.abs(withObservation.speed - 0.95) < 0.01, `priced ${withObservation.speed.toFixed(2)}x`);
-  assert.equal(withObservation.sustainable, false);
-});
-
-test("an observation prices a host whose clips were never fitted", () => {
-  // No model at all — clips missing, or a fit rejected. Before an observation
-  // nothing can be refused; after one, the same rung is priced and refused.
-  const benchmark = [{ preset: "ultrafast", pixelsPerSec: 11.2e6 }];
-  const outputPixelsPerSec = 426 * 240 * 24;
-
-  const unpriced = canSustainOutput({
-    benchmark,
-    decodeModel: null,
-    source: MEASURED_FILM,
-    outputPixelsPerSec
-  });
-  assert.deepEqual(unpriced, { speed: null, sustainable: true });
-
-  const priced = canSustainOutput({
-    benchmark,
-    decodeModel: null,
-    source: MEASURED_FILM,
-    outputPixelsPerSec,
-    observedDecodeCostSec: 0.8335
-  });
-  assert.equal(priced.sustainable, false);
-  assert.ok(priced.speed < 1, `priced ${priced.speed?.toFixed(2)}x`);
-});
-
-test("not calibrated means nothing judged; calibrated with nothing qualified means refused", () => {
-  const uncalibrated = canSustainOutput({
-    benchmark: null,
-    decodeModel: null,
-    source: null,
-    outputPixelsPerSec: 1920 * 1080 * 24
-  });
-  assert.deepEqual(uncalibrated, { speed: null, sustainable: true });
-
-  const nothingQualified = canSustainOutput({
-    benchmark: [],
-    decodeModel: null,
-    source: null,
-    outputPixelsPerSec: 1920 * 1080 * 24
-  });
-  assert.deepEqual(nothingQualified, { speed: null, sustainable: false });
-});
-
-test("a real ffmpeg banner reads into the figures the budget prices", async () => {
-  // The chain a session actually runs: ffmpeg prints its banner, the four
-  // readers take the four facts out of it, and `sourceDecodeCharacteristics`
-  // turns them into the two the fit uses. Run against a real file, because the
-  // bitrate reader is new and a banner is the one input nobody can invent
-  // faithfully.
-  const stderr = await new Promise((resolve) => {
-    let text = "";
-    const child = spawn(
-      ffmpegBin,
-      ["-hide_banner", "-loglevel", "info", "-i", path.join(CALIBRATION_DIR, "cal-h264-720-hi.mp4"), "-t", "0.1", "-f", "null", "-"],
-      { stdio: ["ignore", "ignore", "pipe"], windowsHide: true }
-    );
-    child.stderr.on("data", (chunk) => {
-      text += String(chunk);
-    });
-    child.on("close", () => resolve(text));
-  });
-
-  // The VIDEO stream's rate (9940), not the container's (9946). On a clip that
-  // carries nothing else the two differ only by container overhead; on a film
-  // with two AC-3 tracks they differ by the whole of the audio, and the fit
-  // these figures feed was made from clips decoded with `-an`.
-  assert.equal(parseFfmpegBitrateKbps(stderr), 9940, "the video stream's own bitrate, in kb/s");
-  const dimensions = parseFfmpegVideoDimensions(stderr);
-  const figures = sourceDecodeCharacteristics({
-    width: dimensions.width,
-    height: dimensions.height,
-    fps: parseFfmpegVideoFps(stderr),
-    bitrateKbps: parseFfmpegBitrateKbps(stderr)
-  });
-  assert.ok(Math.abs(figures.megapixelsPerSecond - (1280 * 720 * 24) / 1e6) < 0.01);
-  assert.ok(Math.abs(figures.megabitsPerSecond - 9.94) < 0.001);
-});
-
-test("the video stream's bitrate is preferred, and the output's is never read", () => {
-  // A real banner states three rates: the container's, the input video
-  // stream's, and — below "Stream mapping:" — the one ffmpeg is about to
-  // produce. Only the middle one describes the source.
-  const banner = [
-    "  Duration: 01:31:19.00, start: 0.000000, bitrate: 9500 kb/s",
-    "  Stream #0:0: Video: h264 (High), yuv420p, 1920x1080, 7800 kb/s, 23.98 fps",
-    "  Stream #0:1: Audio: ac3, 48000 Hz, 5.1, fltp, 640 kb/s",
-    "Stream mapping:",
-    "  Stream #0:0(und): Video: wrapped_avframe, yuv420p, 1920x1080, q=2-31, 200 kb/s, 24 fps"
-  ].join("\n");
-  assert.equal(parseFfmpegBitrateKbps(banner), 7800);
-
-  // No per-stream rate: the container's stands in, as it always did.
-  const noStreamRate = [
-    "  Duration: 00:10:00.00, bitrate: 4200 kb/s",
-    "  Stream #0:0: Video: hevc (Main 10), yuv420p10le, 1920x1080, 23.98 fps"
-  ].join("\n");
-  assert.equal(parseFfmpegBitrateKbps(noStreamRate), 4200);
-});
-
-test("a banner with no bitrate reads as no bitrate, not as zero", () => {
-  assert.equal(parseFfmpegBitrateKbps("Duration: 00:01:00.00, start: 0.000000\n"), null);
-  assert.equal(parseFfmpegBitrateKbps(""), null);
-  assert.equal(parseFfmpegBitrateKbps("Duration: 00:01:00.00, start: 0.000, bitrate: 8000 kb/s"), 8000);
-});
-
-test("the source's decode figures come off the probe, or not at all", () => {
-  assert.deepEqual(sourceDecodeCharacteristics({ width: 1920, height: 1080, fps: 24, bitrateKbps: 8000 }), {
-    megapixelsPerSecond: (1920 * 1080 * 24) / 1e6,
-    megabitsPerSecond: 8,
-    // Which measurement of this host applies. Absent on the probe means absent
-    // here — the caller then prices the source as H.264 8-bit, which is what
-    // every source was priced as before the model was fitted per family.
-    codec: "",
-    bitDepth: null
-  });
-  assert.deepEqual(
-    sourceDecodeCharacteristics({ width: 1920, height: 1080, fps: 24, bitrateKbps: 8000, codec: "hevc", bitDepth: 10 }),
-    {
-      megapixelsPerSecond: (1920 * 1080 * 24) / 1e6,
-      megabitsPerSecond: 8,
-      codec: "hevc",
-      bitDepth: 10
-    }
-  );
-  assert.equal(sourceDecodeCharacteristics({ width: 1920, height: 1080, fps: 24, bitrateKbps: null }), null);
-  assert.equal(sourceDecodeCharacteristics(null), null);
-});
-
-test("the OFFER drops the rungs the host cannot hold, and the master keeps addressing them", async (t) => {
-  const dirPath = await mkdtemp(path.join(os.tmpdir(), "decode-cost-"));
-  const manager = wireOutputs({
-    enabled: true,
-    ffmpegBin: "ffmpeg",
-    localBindHost: "127.0.0.1",
-    localPort: 9090,
-    // A host that can encode a little: 3 Mpx/s, so only the smallest rungs of a
-    // 1080p source can be produced faster than they are watched.
-    softwarePresetBenchmark: [{ preset: "ultrafast", pixelsPerSec: 3e6 }],
-    decodeCostModel: ADDON_HOST_MODEL
-  });
-  t.after(async () => {
-    await manager.lifecycle.disposeAll();
-    await rm(dirPath, { recursive: true, force: true });
-  });
-
-  const session = {
-    id: "ccccccccddddeeee",
-    spec: outputSpec({ transcodeVideo: false, cutGrid: "keyframe" }),
-    dirPath,
-    // Where this file is cut, held by the file. A fixture that stated it
-    // on the session was describing what production no longer does.
-    timeline: new Timeline({
-      boundaries: Array.from({ length: 101 }, (_, index) => index * 4),
-      cutGrid: "keyframe"
-    }),
-    state: "ready",
-    // The file's own facts: the picture's size, and what decoding it costs,
-    // which is derived from them rather than stated beside them. These are the
-    // measured film of MEASURED_FILM above — 1080p24 at 8 Mbit/s.
-    file: new SourceFile({ sourceKey: "source-1", fileIndex: 0, name: "video.mkv" }).learn({
-      width: 1920,
-      height: 1080,
-      fps: 24,
-      bitrateKbps: 8000
-    }),
-    // An ordinary session reads its own file, and its sound is inside it. The
-    // three differ only for a soundtrack shipped as a file of its own.
-    get inputFile() { return this.file; },
-    get audioFile() { return this.file; },
-    startedAt: Date.now(),
-    lastAccessedAt: Date.now(),
-    ffmpeg: null,
-    lastError: "",
-    consumers: new Set(),
-    segmentFormat: fmp4Format,
-    transcodeVideo: false,
-    transcodeAudio: true,
-    audioTrackIndex: 0,
-    // A copy can only be cut where the source already has a keyframe, and a
-    // master is offered only when that grid is real.
-    // The shape this output is encoded AS, decided once for the output.
-    output: new Output({
-      encodeWidth: 0,
-      encodeHeight: 0,
-      outputFps: 24,
-      softwarePreset: null,
-      applyTonemap: false
-    }),
-    usesExplicitCuts: true,
-    useSyntheticPlaylist: true,
-    playlistText: "#EXTM3U\n",
-    segmentCount: 100,
-    progress: { state: "running", processedSeconds: 0, startPositionSeconds: 0 }
-  };
-  manager.outputs.set(session.id, session);
-
-  assert.deepEqual(
-    manager.quality.offeredHeights(session),
-    [1080],
-    "every rung under the copy runs below realtime here, so there is nothing to switch to"
-  );
-  // The master is NOT that answer. It says which rungs can be spliced onto this
-  // cut grid, which is a fact about the file, and it has to hold still for the
-  // session's life: the browser is handed its address at creation, and a live
-  // figure that withdrew it left a session answering 404 to itself (field
-  // 2026-08-18, "Moana (2016).mkv" — nothing played at all).
-  const weakMaster = manager.renditions.buildMasterPlaylist(session.id);
-  assert.ok(weakMaster, "published once, whatever the host is managing this second");
-  assert.deepEqual(
-    [...weakMaster.matchAll(/^v\/(\d+)\/index\.m3u8$/gm)].map((match) => Number(match[1])),
-    [1080, 720, 540, 480, 360, 240],
-    "the ladder of the source, addressable — the menu the viewer sees is offeredHeights"
-  );
-
-  // A host with a little more encoder keeps the rungs it can actually hold. A
-  // second host, because the encoder's measured modes are a fact the host is
-  // started with — read through the encoder in use, never assigned later — and
-  // a second session on it, because the answer is settled once per session.
-  const strongerHost = wireOutputs({
-    enabled: true,
-    ffmpegBin: "ffmpeg",
-    localBindHost: "127.0.0.1",
-    localPort: 9090,
-    softwarePresetBenchmark: [{ preset: "ultrafast", pixelsPerSec: 12e6 }],
-    decodeCostModel: ADDON_HOST_MODEL
-  });
-  t.after(() => strongerHost.lifecycle.disposeAll());
-  const stronger = { ...session, id: "ddddddddeeeeffff", offeredHeightsCache: undefined };
-  strongerHost.outputs.set(stronger.id, stronger);
-  assert.deepEqual(
-    strongerHost.quality.offeredHeights(stronger),
-    [1080, 360, 240],
-    "nothing is known about this swarm, so the bar is realtime"
-  );
-  const master = strongerHost.renditions.buildMasterPlaylist(stronger.id);
-  assert.ok(master, "1080p copied plus every rung that can be spliced beside it");
-  assert.deepEqual(
-    [...master.matchAll(/^v\/(\d+)\/index\.m3u8$/gm)].map((match) => Number(match[1])),
-    [1080, 720, 540, 480, 360, 240],
-    "the same published set as before: what the host manages is the offer's business, not the document's"
-  );
-
-  // The same host, once the reader has measured what this file's supply
-  // demands: waits arriving as they did on the field torrent of 2026-08-17 ask
-  // 1.67x of any step, and the rungs that only just cleared realtime go.
-  // What the supply demands is a fact of the FILE, measured by its reader
-  // (1 + worst wait 1.49 s / median interval 2.22 s, twelve waits), and it is
-  // asked of the host's load by the file — not read off a session.
-  strongerHost.hostLoad.requiredSpeedFor = () => 1.67;
-  const onAThinSwarm = {
-    ...stronger,
-    id: "eeeeeeeeffff0000",
-    offeredHeightsCache: undefined
-  };
-  strongerHost.outputs.set(onAThinSwarm.id, onAThinSwarm);
-  assert.deepEqual(
-    strongerHost.quality.offeredHeights(onAThinSwarm),
-    [1080],
-    "the copied height costs no encoder and stays; nothing re-encoded survives that supply"
-  );
-});
-
-test("a source is priced by its own codec family when that family was measured", () => {
-  // A model as the startup benchmark now returns it: H.264 terms at the top
-  // level, for a caller that knows nothing about codecs, and the measured
-  // families beside them.
-  const model = {
-    pixelTerm: 0.006, bitrateTerm: 0.012, constantTerm: 0,
-    families: {
-      h264: { pixelTerm: 0.006, bitrateTerm: 0.012, constantTerm: 0 },
-      hevc: { pixelTerm: 0.011, bitrateTerm: 0.020, constantTerm: 0 },
-      hevc10: { pixelTerm: 0.017, bitrateTerm: 0.026, constantTerm: 0 }
-    }
-  };
-  const rates = { megapixelsPerSecond: 50, megabitsPerSecond: 9 };
-  const asH264 = decodeCostOf(model, { ...rates, codec: "h264", bitDepth: 8 });
-  const asHevc = decodeCostOf(model, { ...rates, codec: "hevc", bitDepth: 8 });
-  const asHevc10 = decodeCostOf(model, { ...rates, codec: "hevc", bitDepth: 10 });
-  assert.equal(Number(asH264.toFixed(4)), 0.408);
-  assert.equal(Number(asHevc.toFixed(4)), 0.73);
-  assert.equal(Number(asHevc10.toFixed(4)), 1.084);
-  // The whole point: the same file costs more as HEVC than as H.264, and more
-  // again at ten bits. A single fit could not say that.
-  assert.ok(asHevc > asH264 && asHevc10 > asHevc);
-});
-
-test("a family with no clips is priced as H.264, and a model with no families still works", () => {
-  const withFamilies = {
-    pixelTerm: 0.006, bitrateTerm: 0.012, constantTerm: 0,
-    families: { h264: { pixelTerm: 0.006, bitrateTerm: 0.012, constantTerm: 0 } }
-  };
-  const rates = { megapixelsPerSecond: 50, megabitsPerSecond: 9 };
-  // AV1 has no set of its own yet.
-  assert.equal(
-    decodeCostOf(withFamilies, { ...rates, codec: "av1", bitDepth: 8 }),
-    decodeCostOf(withFamilies, { ...rates, codec: "h264", bitDepth: 8 })
-  );
-  // And a flat model — every model before this release — is unchanged.
-  const flat = { pixelTerm: 0.006, bitrateTerm: 0.012, constantTerm: 0 };
-  assert.equal(decodeCostOf(flat, { ...rates, codec: "hevc", bitDepth: 10 }), 0.408);
-});
-
-test("the family is chosen by codec and depth, and unknown names fall to H.264", () => {
-  assert.equal(decodeFamilyOf({ codec: "hevc", bitDepth: 8 }), "hevc");
-  assert.equal(decodeFamilyOf({ codec: "HEVC", bitDepth: 10 }), "hevc10");
-  assert.equal(decodeFamilyOf({ codec: "h265", bitDepth: 12 }), "hevc10");
-  assert.equal(decodeFamilyOf({ codec: "h264", bitDepth: 10 }), "h264");
-  assert.equal(decodeFamilyOf({ codec: "vc1", bitDepth: null }), "h264");
-  assert.equal(decodeFamilyOf({}), "h264");
-});

package/test/delivery-probe-field.test.js

@@ -1,173 +0,0 @@
-import test from "node:test";
-import assert from "node:assert/strict";
-
-import { createDeliveryProbe, PROBE_INTERVAL_MS } from "../services/transport/delivery-probe.js";
-
-// The probe service run end to end, against channels that only record what is
-// sent and a peer whose echoes this file writes. The shapes are the field's of
-// 2026-09-28 (research/stalled-channel-recovery-2026-10-04.md in meta): two
-// connections on one proxy, one healthy and idle, one wedged.
-
-const LABELS = ["proxy", "proxy-control", "proxy-fast"];
-
-/**
- * A connection with three channels and a peer that echoes on its own cadence.
- *
- * `peer.delivering` decides whether the probes reach the far end; while it is
- * false the far end goes on echoing — the reverse direction keeps working in a
- * wedge — but the newest number it has seen stays where it stopped.
- *
- * @param {import("node:test").TestContext} t
- * @param {{ rttMs?: number }} [options]
- */
-function connection(t, { rttMs = 6 } = {}) {
-  t.mock.timers.enable({ apis: ["setInterval", "Date"], now: 0 });
-  const lines = [];
-  const captures = [];
-  const probe = createDeliveryProbe({
-    log: (line) => lines.push(line),
-    readDelivery: () => ({ bytesPerSecond: 3_000_000, rttMs }),
-    getTransportSnapshot: () => ({ remote: "peer" }),
-    witness: {
-      maybeCapture: (trigger) => {
-        captures.push({ at: Date.now(), trigger });
-        return true;
-      }
-    }
-  });
-  // The far end's own clock and how long a probe takes to become a fact there:
-  // half the crossing, and the page handling the message. The page reports
-  // when it saw each probe and when it sent the report, on its own clock — the
-  // timestamps the verdict used to turn into a one-way delay.
-  const PEER_CLOCK_OFFSET_MS = 37;
-  const HANDLING_MS = 4;
-  const peer = { delivering: true, seen: 0, seenAt: 0, channelBytes: 0, loopLagMs: 0, visibility: "visible" };
-  const channels = LABELS.map((label) => ({
-    label,
-    sendMessage(message) {
-      const { seq, sentAt } = JSON.parse(message);
-      if (peer.delivering && seq > peer.seen) {
-        peer.seen = seq;
-        peer.seenAt = sentAt + rttMs / 2 + HANDLING_MS + PEER_CLOCK_OFFSET_MS;
-      }
-    },
-    bufferedAmount: () => 0
-  }));
-  for (const channel of channels) {
-    probe.attach("s1", "s1", channel.label, channel);
-  }
-  const echo = () =>
-    probe.noteEcho("s1", {
-      type: "probe-echo",
-      seen: Object.fromEntries(LABELS.map((label) => [label, peer.seen])),
-      seenAt: Object.fromEntries(LABELS.map((label) => [label, peer.seenAt])),
-      sentAt: Date.now() + PEER_CLOCK_OFFSET_MS,
-      report: {
-        visibility: peer.visibility,
-        loopLagMs: peer.loopLagMs,
-        transportBytesReceived: peer.channelBytes,
-        channels: Object.fromEntries(LABELS.map((label) => [label, { messages: 0, bytes: peer.channelBytes }])),
-        pending: 0
-      }
-    });
-  t.after(() => probe.dispose());
-  return {
-    peer,
-    lines,
-    captures,
-    /**
-     * Run the clock, echoing every `echoEveryMs` — composed just before the
-     * probe of that instant arrives, which is the latest a healthy report can
-     * be.
-     */
-    run(ms, echoEveryMs = PROBE_INTERVAL_MS) {
-      for (let elapsed = 0; elapsed < ms; elapsed += echoEveryMs) {
-        t.mock.timers.tick(echoEveryMs - 1);
-        echo();
-        t.mock.timers.tick(1);
-      }
-    },
-    verdicts(fromMs = 0) {
-      return lines
-        .filter((line) => line.startsWith("[dc-probe]"))
-        .map((line) => ({ verdict: line.split(" ")[2], at: Date.parse(line.match(/at=(\S+)/)[1]) }))
-        .filter((entry) => entry.at >= fromMs);
-    }
-  };
-}
-
-test("an idle healthy connection is not called stopped (2026-09-28, 35cff221)", (t) => {
-  // rtt 6 ms, every queue empty, nothing but probes crossing. The verdict that
-  // compared a one-way delay of 6-54 ms with an allowance of 3 ms printed
-  // `association-stopped` on this connection every five seconds.
-  const link = connection(t);
-  link.run(60_000);
-  // From the first echo on: before it there is nothing to judge.
-  const named = new Set(link.verdicts(PROBE_INTERVAL_MS).map((entry) => entry.verdict));
-  assert.deepEqual([...named], ["flowing"], `every probe was delivered: ${link.lines.at(-1)}`);
-  assert.equal(link.captures.length, 0);
-});
-
-test("a wedge is called stopped within seconds and reaches the witness (2026-09-28, 10b53a7e)", (t) => {
-  // Probe 1464 was the last the peer saw; echoes went on arriving for the
-  // whole minute. The old verdict read `flowing` on every line.
-  const link = connection(t, { rttMs: 26 });
-  link.run(30_000);
-  const wedgedAt = Date.now();
-  link.peer.delivering = false;
-  link.run(30_000);
-  const after = link.verdicts(wedgedAt);
-  const firstStop = after.find((entry) => entry.verdict === "association-stopped");
-  assert.ok(firstStop, `the wedge must be named: ${link.lines.at(-1)}`);
-  assert.ok(firstStop.at - wedgedAt <= 2_000, `named ${firstStop.at - wedgedAt} ms after the last delivery`);
-  assert.equal(after.at(-1).verdict, "association-stopped", "and it stays named while nothing arrives");
-  assert.equal(link.captures.length, 1, "one capture per wedge");
-  assert.ok(link.captures[0].at - wedgedAt <= 3_000, `captured ${link.captures[0].at - wedgedAt} ms in`);
-});
-
-test("delivery resuming clears the verdict and arms the next capture", (t) => {
-  const link = connection(t);
-  link.run(10_000);
-  link.peer.delivering = false;
-  link.run(10_000);
-  assert.equal(link.captures.length, 1);
-  const resumedAt = Date.now();
-  link.peer.delivering = true;
-  link.run(10_000);
-  assert.equal(link.verdicts(resumedAt).at(-1).verdict, "flowing");
-  link.peer.delivering = false;
-  link.run(10_000);
-  assert.equal(link.captures.length, 2, "a second wedge is a second capture");
-});
-
-test("a hidden tab answering late is read as flowing (field 2026-09-03 loop delays)", (t) => {
-  // A hidden tab echoes about once a second and reports its own event loop as
-  // late — 681 → 1881 ms in the field. Every probe still reaches it.
-  const link = connection(t);
-  link.run(10_000);
-  link.peer.visibility = "hidden";
-  link.peer.loopLagMs = 681;
-  link.run(5_000, 1_000);
-  link.peer.loopLagMs = 1881;
-  const hiddenAt = Date.now();
-  link.run(30_000, 2_000);
-  const named = new Set(link.verdicts(hiddenAt).map((entry) => entry.verdict));
-  assert.deepEqual([...named], ["flowing"], `every probe is delivered: ${link.lines.at(-1)}`);
-});
-
-test("late reports while film is still arriving are read as flowing", (t) => {
-  // A hidden tab reports every three seconds and says beforehand that its loop
-  // is that late; the far end's channel byte counter says film is crossing.
-  const link = connection(t);
-  link.run(10_000);
-  link.peer.visibility = "hidden";
-  link.peer.loopLagMs = 3_000;
-  link.run(1_000);
-  const lateAt = Date.now();
-  for (let index = 0; index < 20; index += 1) {
-    link.peer.channelBytes += 4_000_000;
-    link.run(3_000, 3_000);
-  }
-  const named = new Set(link.verdicts(lateAt).map((entry) => entry.verdict));
-  assert.deepEqual([...named], ["flowing"], `film is arriving: ${link.lines.at(-1)}`);
-});