@norskvideo/ctl-test-harness 0.1.80 → 0.1.81

package/demo/harness.d.ts

@@ -115,6 +115,8 @@ export declare class ProductHarness {
      *  daemon, the dev backend and the store. Throws if the store outlives the
      *  root-container nuke: a leak a runner would otherwise accumulate. */
     teardown(): Promise<void>;
+    private instancePortsIssued;
+    private nextInstancePort;
     private nextStudioHostPort;
 }
 /** The demo: a ProductHarness set up, run, held (`up`) or not (`check`), torn down. */

package/demo/harness.js

@@ -23,6 +23,12 @@ const STUDIO_HOST_PORT_PARAM = "STUDIO_HOST_PORT";
 /** Launches after the first take studio host ports above the proxy's, inside
  *  the band and below `instancePortBase`: six of them. */
 const EXTRA_STUDIO_PORTS = 6;
+/** Allocated-port params come from `instancePortBase` to the band's end: ten. */
+const INSTANCE_PORTS = 10;
+/** A template's allocated host port: a `*_PORT` param defaulting to `auto`,
+ *  which ctl resolves to the first free port from the template's PREFERRED
+ *  one (probe's MOQ_PORT: 4443). */
+const isAllocatedPortParam = (name, dflt) => dflt === "auto" && /_PORT$/.test(name);
 export class ProductHarness {
     spec;
     slug;
@@ -135,6 +141,24 @@ export class ProductHarness {
         else if (!internalOnly) {
             launchArgv.push("--host-ports", `${studioHostPort}:${STUDIO_INTERNAL_PORT}@studio`);
         }
+        // Allocated ports get a port from this run's band, not ctl's `auto`. Auto
+        // is "the first free port from the template's preferred one", and on a
+        // shared docker host every daemon prefers the same one: on 2026-10-08
+        // probe's guide gate lost MOQ_PORT's 4443 between ctl's free-port check
+        // and container start ("host port 4443 was taken between validation and
+        // container start") -- to another instance falling back to its own MoQ
+        // listener, or to the node MoQ relay, which publishes 4443 itself. The
+        // band is per product and below the ephemeral range (port-bands.test.ts),
+        // so nothing else on the host reaches for these. An internal-only launch
+        // publishes no host port at all, so `auto` is harmless there and stays.
+        if (!internalOnly) {
+            for (const [name, dflt] of declared) {
+                if (name === STUDIO_HOST_PORT_PARAM || specParams[name] !== undefined)
+                    continue;
+                if (isAllocatedPortParam(name, dflt))
+                    params.push(`${name}=${this.nextInstancePort(name)}`);
+            }
+        }
         for (const p of params)
             launchArgv.push("--param", p);
         const hardware = overrides.hardware ?? spec.launch?.hardware;
@@ -260,6 +284,14 @@ export class ProductHarness {
             throw new Error(`store ${s.storeDir} still present after the root-container nuke`);
         }
     }
+    instancePortsIssued = 0;
+    nextInstancePort(param) {
+        const n = this.instancePortsIssued++;
+        if (n >= INSTANCE_PORTS) {
+            throw new Error(`${param}: the band holds ${INSTANCE_PORTS} allocated instance ports and this run has used them all -- pass params.${param}`);
+        }
+        return this.ports.instancePortBase + n;
+    }
     nextStudioHostPort() {
         const n = this.launchedIds.length;
         if (n === 0)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@norskvideo/ctl-test-harness",
-  "version": "0.1.80",
+  "version": "0.1.81",
   "type": "module",
   "exports": {
     ".": {