code wiki / _hdl_build / nx_known_issue_store.nx
nx_known_issue_store.nx
buildroot/runtime/_hdl_build/nx_known_issue_store.nx
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
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
| 26 | const KI_MAGIC_1024: i64 = 1024 |
| 28 | const KI_PREFIX: *u8 = "knowledge/store/ki-" |
| 31 | const KI_HIT: i64 = 1 // a seen issue's signature matched the diagnostic -> remedy routed |
| 32 | const KI_UNKNOWN: i64 = 0 // no seen signature matched -> genuinely novel (UNFIXABLE stays legal) |
functions
| 34 | func ki_len(s: *u8) -> i64 { var n: i64 = 0; while s[n] != (0 as u8) { n = n + 1 } return n } |
| 37 | func ki_get_p(prefix: *u8, key: *u8, ptrout: *i64, lenout: *i64) -> i64 calls 1: ss_get |
| 40 | func ki_get(key: *u8, ptrout: *i64, lenout: *i64) -> i64 |
| 45 | func ki_seg_next_p(prefix: *u8) -> i64 |
| 54 | func ki_field(rec: *u8, rlen: i64, f: i64, out: *u8) -> i64 called by 1: ki_recall |
| 75 | func ki_substr(hay: *u8, hlen: i64, needle: *u8, nlen: i64) -> i64 |
| 94 | func ki_recall(prefix: *u8, diag: *u8, dlen: i64, outid: *u8, outrem: *u8, outstat: *u8) -> i64 called by 7: maincw_routecond_recall_verdictdah_resolvemainmain+1 calls 4: sys_mmapss_getki_fieldki_substr |