code wiki / _hdl_build / nx_vqoe_gate.nx
nx_vqoe_gate.nx
buildroot/runtime/_hdl_build/nx_vqoe_gate.nx
about
nx_vqoe_gate.nx -- the STANDING VIDEO SHIP-GATE (F601; eats debt seq35).
WHY: prior /video seeds measured the ENCODER VM (36-81fps) while the received room ran 1fps --
the 100x engine-truth-vs-field-truth gap that made /video suck. This organ grades the thing the
family actually experiences: the RECEIVER-side /api/vqoe beacons (vqoe.jsonl, appended by
nx_mgmt_api ma_vqoe from real rooms + the headless probe). It publishes a machine verdict the
reliability plane (nx_deploy_ready via knowledge/registry/deploy_checks.tsv) and any agent can
gate on BEFORE shipping video changes.
VERDICTS (honest three-state):
GREEN = fresh beacons within thresholds -> ship.
AMBER = insufficient fresh evidence -> ship is UNPROVEN (not blocked; the remediation is to
generate evidence: headless probe or a real call). No GREEN marker = deploy_ready warns.
RED = received-room truth failed a threshold -> DO NOT ship video changes.
DATA-DRIVEN (rule 11/17): thresholds live in knowledge/registry/vqoe_gate.conf key=value rows,
compiled defaults only as bootstrap fallback. ENVELOPE DECLARED (scale law): reads the TAIL
tail_bytes of vqoe.jsonl (default 4MiB), keeps <=8192 rtt samples; over-cap is COUNTED + printed,
never silent. Imports ONLY nx_syscalls = drift-immune (the reliability-guard pattern).
usage: nx_vqoe_gate [jsonl] [conf] [outlog] (defaults: vqoe.jsonl,
knowledge/registry/vqoe_gate.conf, knowledge/status/video_vqoe_gate.log)
license_tier: ORIGINAL
dependencies 1 imports · 0 importers
imports: nx_syscalls.nx
imported by: nobody (leaf or entry point)
call flow from main pre-order; caps 40 nodes / depth 6 declared; ↻ = already shown
structs
| none |
consts
| 22 | const VG_RTT_CAP: i64 = 8192 |
functions
| 24 | func vg_puts(s: *u8) -> i64 { var n: i64 = 0; while s[n] != (0 as u8) { n = n + 1 } sys_write(1, s, n); return 0 } |
| 26 | func vg_s(dst: *u8, off: i64, s: *u8) -> i64 called by 1: main |
| 32 | func vg_n(dst: *u8, off: i64, v: i64) -> i64 |
| 45 | func vg_starts(b: *u8, off: i64, le: i64, lit: *u8) -> i64 called by 1: vg_findint |
| 57 | func vg_findint(b: *u8, le: i64, needle: *u8, start: i64, oval: *i64) -> i64 |
| 86 | func vg_lineval(cb: *u8, ls: i64, le: i64, key: *u8) -> i64 called by 1: vg_confget |
| 107 | func vg_confget(cb: *u8, cn: i64, key: *u8, dflt: i64) -> i64 |
| 125 | func main(argc: i64, argv: *i64) -> i64 |