nx_frame_pacing_lib.nx

nx_frame_pacing_lib.nx -- THE NATIVE HALF OF THE FRAME-BUDGET RULER: one conf reader, one plane reader, one frames reader and ONE judgement call shared by every native consumer (the pacing gate, the world telemetry sink, any future beat). nx_perf_lib holds the arithmetic and is wasm-compatible by construction (no syscalls); this lib is the layer that touches the conf and the SOVEREIGN STORE PLANE, so the wasm engine, the served HUD, the gate and the sink all compute the same numbers from the same window and read the same bands. THE PLANE, NOT A FILE (operator 2026-09-02: "you just built with tsv yet again instead of sota data file systems"; the 2026-08-13 standing order already forbade third-party formats in the plane). Frame windows are rows of the seg-store plane knowledge/store/frametrace- written through nx_store_seed_lib (the same locked append every board uses), never a .tsv beside it. One row per beacon: id=<world>_<ts> | world | ts | budget(ms:src) | n | total | page p50/p95/p99 | sink p50/p95/p99 | worst | worst_ever | spikes | over | verdict:why | twins | frames_csv (15 columns, under the 16-col plane cap) The plane is append-only, so it IS the time spine: the latest row for a world is the current window and every earlier row is history -- readable by any seat through `nx_store_put knowledge/store/frametrace- load`. THE CONF (knowledge/frame_pacing.conf): `key=value` rows, `#` comments: budget_ms min_samples p50_permil p95_permil p99_permil jank_permil Bands are permil OF THE BUDGET so one conf serves every display refresh rate. license_tier: ORIGINAL No hw writes (Rule 26).