code wiki / _hdl_build / nx_vsretract.nx

nx_vsretract.nx

buildroot/runtime/_hdl_build/nx_vsretract.nx

5329 B116 linesdepth 10pulls 18 transitivereach 0 importersview sourcekind orphan library
docsdependenciesstructsconstsfunctions

about

nx_vsretract.nx -- withdraw a comparative claim that turned out to be wrong. argv: <domain> <scope> <reason> Appends a VSRETRACT line to the same ledger nx_vsbest writes. nx_vsroll_lib walks that ledger in order, so a retraction clears the (domain, scope) back to UNMEASURED, and a later nx_vsbest claim after a clean re-run legitimately re-establishes it. WHY THIS EXISTS: I admitted search|latency=behind on a benchmark that had starved our own engine (the harness held a 892MB FTS5 index it had just spent 483s building, and I timed our search under that contention). Re-timed clean, our search answers in 1-6ms. The claim was wrong and there was NO WAY TO WITHDRAW IT -- nx_vsbest only appends. Five routes to a fabricated WIN were closed by construction; there was no route to correct an honest MISTAKE. ★★★★★AN AXIS THAT CANNOT BE UN-CLAIMED CAN BE POISONED BY EXACTLY ONE BAD MEASUREMENT. RULE 13: this DELETES NOTHING. The original claim stays in the log as history -- the retraction is a later row that supersedes it. A reader can still see what was claimed, when, and why it was withdrawn, which is the whole point of an append-only ledger. A REASON IS MANDATORY. A retraction with no stated cause is indistinguishable from someone quietly deleting an inconvenient loss, and this axis exists to make that impossible. license_tier: ORIGINAL No hw writes (Rule 26).

dependencies 1 imports · 0 importers

nx_vsbest_lib.nx nx_vsretract.nx

imports: nx_vsbest_lib.nx

imported by: nobody (leaf or entry point)

structs

none

consts

25const VX_LOG: *u8 = "knowledge/status/vsbest_claims.log"
26const VX_MODE: i64 = 0x1a4
27const VX_LINE_CAP: i64 = 2048
28const VX_MIN_REASON: i64 = 24

functions

30func vx_apps(b: *u8, cap: i64, o: i64, s: *u8) -> i64
41func vx_appn(b: *u8, cap: i64, o: i64, v: i64) -> i64
55func main(argc: i64, argv: *i64) -> i64