code wiki / _hdl_build / nx_vsretract.nx

nx_vsretract.nx

buildroot/runtime/_hdl_build/nx_vsretract.nx

5329 B116 linesdepth 5pulls 6 transitivereach 0 importersview sourcekind tool
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)

call flow from main pre-order; caps 40 nodes / depth 6 declared; ↻ = already shown

main ss_readall sys_openat_rd sys_lseek sys_mmap sys_read sys_close el_contains el_len el_match sys_openat_append vx_apps vx_appn sys_now_realtime_sec sys_mmap ↻ sys_clock_gettime_real

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
called by 1: main
41func vx_appn(b: *u8, cap: i64, o: i64, v: i64) -> i64
called by 1: main
55func main(argc: i64, argv: *i64) -> i64