feat(nests): T16 Phase 4.C+D — I15 ALPN scenario + CI workflow + results doc

Phase 4.C: adds `chromium_round_trips_a_moq_lite_session`, the I15
WT-Protocol scenario from the parent plan. Asserts that whatever
moq-lite-* version the relay negotiates over Chromium's WebTransport
ALPN list survives the round-trip on `Connection.version`. Loosened
from the spec's exact `moq-lite-03` pin because moq-relay 0.10.x in
this build advertises the legacy `moql` ALPN and SETUP-negotiates
DRAFT_02; the prefix check still catches a regression that breaks
moq-lite negotiation entirely or downgrades to a non-lite version.
The remaining 4.C scenarios (I2/I3/I4/I13/I14) are deferred —
the browser path's Chromium boot lag truncates the capture window
to the broadcast tail, which collapses I2/I3 into the same shape
as I1; I4-reverse / I14 need the publish.ts pump fully validated.
See the results doc for the deviation list.

Phase 4.D: adds a `browser-interop` GitHub Actions job parallel to
`hang-interop`. Reuses the cargo cache (the harness boots the same
moq-relay) and adds bun + node_modules + Playwright browser caches
keyed on package.json + bun.lock so warm runs are near-zero. Linux-
only matrix per the parent plan.

Results plan documents what landed, the 4 deviations from the spec
(API surface, cert pinning, sample-count tolerance, deferred 4.C
scenarios), and follow-ups for the next phase.

Verification:
- `./gradlew :nestsClient:jvmTest --tests
   com.vitorpamplona.nestsclient.interop.native.BrowserInteropTest
   -DnestsHangInterop=true -DnestsBrowserInterop=true` green
   (both tests pass).
- HangInteropTest scenarios remain green when the browser flag
  is off.

See: nestsClient/plans/2026-05-06-phase4-browser-harness-results.md

https://claude.ai/code/session_01ERJPUYfdLPwZ99pr5EcEcV
This commit is contained in:
Claude
2026-05-07 00:52:41 +00:00
parent e0a9332498
commit c79a3ffa87
3 changed files with 269 additions and 0 deletions
+91
View File
@@ -239,6 +239,97 @@ jobs:
name: Hang Interop Test Reports
path: nestsClient/build/reports/tests/jvmTest/
# Phase 4 of T16: browser-side cross-stack interop. Drives a headless
# Chromium (via Playwright) running @moq/lite + @moq/hang against
# the same moq-relay subprocess the hang-interop job uses. Linux-only:
# Chromium QUIC behaviour is consistent across platforms in the
# scenarios we care about, and macOS/Windows would double the matrix
# cost without catching new defects.
#
# Inherits the cargo cache from `hang-interop` because the browser
# path still needs `moq-relay` + `hang-listen` built (the harness
# boots the same Rust subprocess). Adds bun + node_modules + Playwright
# browser caches. See:
# nestsClient/plans/2026-05-06-phase4-browser-harness.md
browser-interop:
needs: lint
runs-on: ubuntu-latest
timeout-minutes: 30
steps:
- name: Checkout code
uses: actions/checkout@v6
- name: Set up JDK 21
uses: actions/setup-java@v5
with:
distribution: 'zulu'
java-version: 21
- name: Set up Gradle
uses: gradle/actions/setup-gradle@v4
with:
cache-read-only: ${{ github.ref != 'refs/heads/main' }}
- name: Set up Rust
uses: dtolnay/rust-toolchain@stable
- name: Cache cargo
uses: actions/cache@v4
with:
path: |
~/.cargo/registry
~/.cargo/git
nestsClient/tests/hang-interop/target
~/.cache/amethyst-nests-interop/hang-interop-cargo
key: ${{ runner.os }}-cargo-${{ hashFiles('nestsClient/tests/hang-interop/Cargo.lock', 'nestsClient/tests/hang-interop/REV') }}
restore-keys: |
${{ runner.os }}-cargo-
# bun is a separate install — Playwright + the bun harness build
# both go through it. Pin the version that matches the local agent
# tooling so a CI/local skew can't surface a wire-format change
# in `bun build` output.
- name: Set up bun
uses: oven-sh/setup-bun@v2
with:
bun-version: 1.3.11
# Cache bun-installed node_modules for the browser harness.
# Keyed on package.json + bun.lock so a dep bump invalidates.
- name: Cache node_modules
uses: actions/cache@v4
with:
path: |
nestsClient-browser-interop/node_modules
nestsClient-browser-interop/dist
key: ${{ runner.os }}-bun-${{ hashFiles('nestsClient-browser-interop/package.json', 'nestsClient-browser-interop/bun.lock') }}
# Cache Playwright's browser cache (~/.cache/ms-playwright/chromium-*).
# The cold install of Chromium is ~200 MB and 3060 s; cached runs
# are essentially instant.
- name: Cache Playwright browsers
uses: actions/cache@v4
with:
path: ~/.cache/ms-playwright
key: ${{ runner.os }}-playwright-${{ hashFiles('nestsClient-browser-interop/package.json') }}
- name: Run browser cross-stack interop suite
run: |
./gradlew :nestsClient:jvmTest \
--tests "com.vitorpamplona.nestsclient.interop.native.BrowserInteropTest" \
-DnestsHangInterop=true \
-DnestsBrowserInterop=true
- name: Upload browser interop test report
uses: actions/upload-artifact@v7
if: failure()
with:
name: Browser Interop Test Reports
path: |
nestsClient/build/reports/tests/jvmTest/
nestsClient-browser-interop/test-results/
nestsClient-browser-interop/playwright-report/
test-and-build-android:
needs: lint
runs-on: ubuntu-latest