code wiki / _hdl_build / nx_ws_index_lib.nx

nx_ws_index_lib.nx

buildroot/runtime/_hdl_build/nx_ws_index_lib.nx

11878 B282 linesdepth 2pulls 2 transitivereach 12 importersview sourcekind librarytopic ws

docs dependencies structs consts functions

about

nx_ws_index_lib.nx -- WMS durability LIB: derive the LIVE workstream auto-index from the memory dir (the actual live source of workstream state) so the resume manifest + a publish gate can NEVER silently go stale. This is the missing "regenerate-from-source" half the operator named: every project-*.md becomes a manifest entry by construction, so nothing can be dropped -- and the count-on-disk vs count-in-manifest comparison turns "we lost a workstream" into a mechanical RED (the loss-detector), never a silent gap. REUSE / lineage: the getdents64 + newfstatat directory walk is the proven nx_sov_tree_audit idiom (ta_getdents/ta_isdir); atomic publish = sys_openat_wr(tmp) + sys_renameat(tmp,live) (the ss_commit / cst_write_atomic hot-swap discipline). Sovereign: imports only nx_syscalls. license_tier: ORIGINAL

dependencies 1 imports · 7 importers

imports: nx_syscalls.nx

imported by: nx_discover_loop.nxnx_work_retro_lib.nxnx_worklog_stop.nxnx_ws_discover_gate.nxnx_ws_ingest.nxnx_ws_manifest_emit.nxnx_ws_manifest_emit_gate.nx

structs

none

consts

13	const WME_MAGIC_65536: i64 = 65536
17	const WME_BEGIN: *u8 = "<!-- WS-AUTO-INDEX:BEGIN (nx_ws_manifest_emit -- generated, do not hand-edit below) -->"
18	const WME_END: *u8 = "<!-- WS-AUTO-INDEX:END -->"
19	const WME_MAXF: i64 = 8192 // max workstream records (382 today; headroom)
20	const WME_SLOT: i64 = 320 // per-name / per-path byte slot
21	const WME_FBUF: i64 = 1048576 // 1MB: read the existing manifest (curated prefix; ~25KB today)
22	const WME_OUTBUF: i64 = 1048576 // 1MB: assembled output (bump-mmap is a finite arena -- stay lean)

functions

24	func wme_len(s: *u8) -> i64 { var n: i64 = 0; while s[n] != (0 as u8) { n = n + 1 } return n } called by 11: wr_is_md wr_is_nx wr_strip_nx wr_ends_with wme_is_project wme_find+5
27	func wme_getdents(fd: i64, buf: *u8, count: i64) -> i64 { return __syscall(217, fd, buf, count, 0, 0, 0) } called by 3: wr_load_corpus wr_sweep wme_scan
30	func wme_is_project(name: *u8) -> i64 called by 1: wme_scan calls 1: wme_len
43	func wme_join(dst: u8, dir: u8, name: *u8) -> i64 called by 3: wr_load_corpus wr_sweep wme_scan
55	func wme_read(path: u8, buf: u8, cap: i64) -> i64 called by 4: wr_load_corpus wme_count_manifest wme_emit gman_has calls 3: sys_openat_rd sys_read sys_close
69	func wme_find(buf: u8, n: i64, pat: u8) -> i64 called by 5: wr_classify wme_count_manifest wme_emit wsi_contains gman_has calls 1: wme_len
83	func wme_cat(buf: u8, off: i64, s: u8) -> i64 called by 2: wme_emit wsi_build_record
90	func wme_catn(buf: *u8, off: i64, v: i64) -> i64 called by 2: wme_emit wsi_build_record calls 1: sys_mmap
105	func wme_scan(memdir: u8, names: i64, mtimes: *i64, cap: i64) -> i64 called by 5: dl_live_coverage g_coverage wme_count_disk wme_emit wsi_ingest_omit_p calls 7: sys_openat_rd sys_mmap wme_getdents wme_is_project wme_join sys_fstatat+1
146	func wme_count_disk(memdir: *u8) -> i64 called by 1: wme_is_stale calls 2: sys_mmap wme_scan
153	func wme_count_manifest(manifest: *u8) -> i64 called by 1: wme_is_stale calls 4: sys_mmap wme_read wme_find wme_len
177	func wme_is_stale(memdir: u8, manifest: u8) -> i64 called by 1: main calls 2: wme_count_disk wme_count_manifest
186	func wme_write_all(fd: i64, buf: *u8, n: i64) -> i64 called by 1: wme_emit calls 1: sys_write
200	func wme_emit(memdir: u8, manifest: u8) -> i64 called by 3: main main main calls 12: sys_mmap wme_scan wme_read sys_fstatat wme_find wme_cat+6