funman300
a9eb54ae9c
Third migration step, and the one that turns fixture parity into transport parity. A TCP host that frames a Fire2 stream, keeps one Session per connection, calls openfut-adapter-fifa17::dispatch(), and writes the returned frames in order. It owns a socket, a buffer, a session and diagnostics -- that is the complete list. No coins, club, packs, profiles or UTAS logic: those belong to Core, reached through the adapter later. NO TLS, and that is evidence-based rather than an omission. The Blaze main port is plaintext: sending a raw Fire2 Util::ping to the running backend returns a plaintext PingResponse, blaze_handle uses the raw socket, and only redir_handle wraps ssl. TLS belongs to the redirector phase. LIVE A/B AGAINST THE RUNNING PYTHON BACKEND: 101 frames across three conversations, identical normalized traces. This is the first result in the migration that is not purely offline. check-live-parity.sh replays the recorded conversations against both endpoints over real sockets and diffs volatile-masked traces; session keys and clocks are masked, so anything that differs is behavioural. Transport tests cover what fixtures cannot: byte-for-byte replay over a socket, requests dribbled one byte at a time, several requests in one write, the four-frame login burst ordered on the wire, session state persisting across frames and NOT leaking between connections, an absurd payload length closing the connection instead of allocating, and an undecodable body still getting a reply. 18 tests here, 116 across the three migration crates. MUTATION TESTED, including the comparison itself. Dropping a post-login notification is caught by the probe (frame count) AND the diff; a same-length content change deep inside a notification body (CTY "US"->"GB", payload 116 both sides) is caught ONLY by the trace digest. So the probe's exit code is not the test -- the diff is, and the README says so. check-live-parity.sh was itself verified to exit 1 under mutation. The listen port is required configuration with no default, so the sidecar cannot silently collide with the working container. OPENFUT_BIND stays the advertised-config bind (the adapter derives nucleusConnect from it, reproducing the oracle) and the listener gets its own setting, so the two are not conflated. Gates 1-4 pass and are re-runnable. Gates 5-10 need a FIFA client and are listed in the README, including the Python -> Rust -> Python -> Rust back-and-forth that proves the rollback path rather than asserting it. Python backend untouched and still the live runtime; contract suite 446/446 after this work. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
68 lines
2.3 KiB
Bash
Executable File
68 lines
2.3 KiB
Bash
Executable File
#!/usr/bin/env bash
|
|
# Live A/B: the Python Blaze responder vs the Rust sidecar, over real sockets.
|
|
#
|
|
# ./check-live-parity.sh <python-host:port> <rust-host:port> [outdir]
|
|
#
|
|
# Replays the recorded conversations against BOTH endpoints and diffs the
|
|
# normalized traces. Session keys and server timestamps are masked, so anything
|
|
# that differs is a real behavioural difference.
|
|
#
|
|
# IMPORTANT: the diff is the test, not the probe's exit code. The probe only
|
|
# detects structural anomalies it can see live (missing frames, early close); a
|
|
# same-length content change deep inside a notification body shows up ONLY as a
|
|
# digest difference in the trace. Verified by mutation.
|
|
#
|
|
# Read-only against both backends: it opens client connections and sends
|
|
# recorded requests. Safe to run while the Python backend is serving.
|
|
#
|
|
# For the comparison to mean anything, BOTH servers must run the same config —
|
|
# same OPENFUT_ADVERTISE, OPENFUT_BIND, POW_CONTENT_HOST and active persona.
|
|
# Otherwise legitimate config differences read as parity failures.
|
|
set -uo pipefail
|
|
|
|
PY="${1:-}"
|
|
RS="${2:-}"
|
|
OUT="${3:-$(mktemp -d)}"
|
|
|
|
if [[ -z "$PY" || -z "$RS" ]]; then
|
|
echo "usage: $0 <python-host:port> <rust-host:port> [outdir]" >&2
|
|
echo "example: $0 127.0.0.1:42130 127.0.0.1:42230" >&2
|
|
exit 2
|
|
fi
|
|
|
|
cd "$(dirname "$(readlink -f "$0")")/.."
|
|
PROBE="./target/debug/blaze-probe"
|
|
[[ -x "$PROBE" ]] || PROBE="./target/release/blaze-probe"
|
|
if [[ ! -x "$PROBE" ]]; then
|
|
echo "blaze-probe not built; run: cargo build -p openfut-blaze-host" >&2
|
|
exit 2
|
|
fi
|
|
|
|
mkdir -p "$OUT"
|
|
fail=0
|
|
frames=0
|
|
|
|
for sess in main fallbacks locale; do
|
|
"$PROBE" "$PY" --session "$sess" > "$OUT/python-$sess.trace" 2>"$OUT/python-$sess.err" || true
|
|
"$PROBE" "$RS" --session "$sess" > "$OUT/rust-$sess.trace" 2>"$OUT/rust-$sess.err" || true
|
|
|
|
n=$(grep -c '^conn-' "$OUT/python-$sess.trace" || true)
|
|
if diff -u "$OUT/python-$sess.trace" "$OUT/rust-$sess.trace" > "$OUT/diff-$sess.txt"; then
|
|
echo " $sess: IDENTICAL ($n frames)"
|
|
frames=$((frames + n))
|
|
else
|
|
echo " $sess: DIFFERS -> $OUT/diff-$sess.txt"
|
|
head -30 "$OUT/diff-$sess.txt"
|
|
fail=1
|
|
fi
|
|
done
|
|
|
|
echo
|
|
if [[ $fail -eq 0 ]]; then
|
|
echo "LIVE PARITY OK — $frames frames, identical normalized traces."
|
|
echo "traces: $OUT"
|
|
else
|
|
echo "LIVE PARITY FAILED — see $OUT"
|
|
fi
|
|
exit $fail
|