code wiki / _hdl_build / nx_known_issue_store.nx

nx_known_issue_store.nx

buildroot/runtime/_hdl_build/nx_known_issue_store.nx

6639 B144 linesdepth 3pulls 3 transitivereach 13 importersview sourcekind library
docsdependenciesstructsconstsfunctions

about

nx_known_issue_store.nx -- LIB: the team's window onto the KNOWN-ISSUE catalogue in the SOVEREIGN INFORMATION STORE (knowledge/store/ki-*, via nx_seg_store). The pure-Nishi home for "have we seen this before?" -- NO TSV, NO SQL. The machine-matchable twin of the human-narrative landmines / workaround_audit registries: those are prose for a reader; THIS is bytes an organ matches a live failure against, so the Engineer/Doctor can RECALL a remedy instead of giving up. This is the structural twin of the "no-hang" error-emit guarantee (nx_netscope_dns recv-timed keystone): there, every error PATH must EMIT a verdict within a deadline (never hang). Here, every SEEN issue must be RECALLED + ROUTED to its remedy (never a silent "can't identify/fix this"). The _recall_or_red_gate locks it the way T2 locks no-hang. Record schema (all keys under prefix knowledge/store/ki-), TAB-separated value fields: ki:ids -> index: TAB-separated list of catalogue ids (the recall walk order) ki:<id> -> id <tab> class <tab> status <tab> signature <tab> remedy class = DIALECT|ENV|TOOLCHAIN|MATH (mirrors landmines scope) status = AUTO|ADAPT|DISCIPLINE|OPEN (the RESPONSE class) signature = exact substring to match in an Engineer diagnostic / crash artifact, or "-" when the issue has no crisp text signature (recall-by-id: a documented adaptation/discipline, not auto) remedy = organ:func for AUTO (e.g. nx_doctor_fix:doc_heal_token), else a response token (durable-runner-rearm, mask-after-shift, ...) ki:provenance -> authorship breadcrumb (staging-vs-verified is machine-visible in the store) license_tier: ORIGINAL

dependencies 2 imports · 8 importers

nx_seg_store.nx nx_syscalls.nx nx_known_issue_store.nx _offc_install_gate.nx nx_collision_watchdog.nx nx_conductor_recall.nx nx_doc_autoheal.nx nx_known_issue_seed.nx nx_landmine_harvest.nx nx_meet_bug_train.nx nx_recall_or_red_gate.nx

imports: nx_seg_store.nxnx_syscalls.nx

imported by: _offc_install_gate.nxnx_collision_watchdog.nxnx_conductor_recall.nxnx_doc_autoheal.nxnx_known_issue_seed.nxnx_landmine_harvest.nxnx_meet_bug_train.nxnx_recall_or_red_gate.nx

structs

none

consts

26const KI_MAGIC_1024: i64 = 1024
28const KI_PREFIX: *u8 = "knowledge/store/ki-"
31const KI_HIT: i64 = 1 // a seen issue's signature matched the diagnostic -> remedy routed
32const KI_UNKNOWN: i64 = 0 // no seen signature matched -> genuinely novel (UNFIXABLE stays legal)

functions

34func ki_len(s: *u8) -> i64 { var n: i64 = 0; while s[n] != (0 as u8) { n = n + 1 } return n }
37func ki_get_p(prefix: *u8, key: *u8, ptrout: *i64, lenout: *i64) -> i64
calls 1: ss_get
40func ki_get(key: *u8, ptrout: *i64, lenout: *i64) -> i64
called by 3: ks_streq_storemainmain calls 1: ss_get
45func ki_seg_next_p(prefix: *u8) -> i64
54func ki_field(rec: *u8, rlen: i64, f: i64, out: *u8) -> i64
called by 1: ki_recall
75func ki_substr(hay: *u8, hlen: i64, needle: *u8, nlen: i64) -> i64
94func ki_recall(prefix: *u8, diag: *u8, dlen: i64, outid: *u8, outrem: *u8, outstat: *u8) -> i64