code wiki / _hdl_build / nx_pipeline_run.nx

nx_pipeline_run.nx

buildroot/runtime/_hdl_build/nx_pipeline_run.nx

9778 B206 linesdepth 5pulls 6 transitivereach 0 importersview sourcekind tooltopic pipeline
docsdependenciesstructsconstsfunctions

about

nx_pipeline_run.nx -- R2: THE CHAIN. The orchestrator that auto-walks a pipeline work-item through discover->research->spec->build via the spine, closing the census gap (nx_pipeline_run ABSENT). Per the operator's chosen path: a DETERMINISTIC orchestrator + self-gate first (proves the walk logic + the halt-on-failure invariant), with the LIVE organ exec as a marked seam (R3). INVARIANT (orchestrator level, on top of the spine's no-skip): if a stage executor FAILS, the chain HALTS at that stage -- the item never advances, so failure can never be laundered into completion. The self-gate's neg-control forces a stage failure and proves the item is stuck. CLI: nx_pipeline_run SEED <id> <gap> -- create a live work-item (under PR_PREFIX) nx_pipeline_run RUN <id> -- auto-walk a live work-item to EXCEEDED (stub exec) nx_pipeline_run -- no-arg: run the deterministic SELF-GATE + verdict Sovereign; imports the spine. license_tier: ORIGINAL

dependencies 5 imports · 0 importers

nx_pipeline_spine.nx nx_workstream_store.nx nx_seg_store.nx nx_framed_append.nx nx_syscalls.nx nx_pipeline_run.nx

imports: nx_pipeline_spine.nxnx_workstream_store.nxnx_seg_store.nxnx_framed_append.nxnx_syscalls.nx

imported by: nobody (leaf or entry point)

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

main pr_eq pl_seed_p pl_stage_p sys_mmap pl_build_key ws_get_p ss_get sys_mmap ↻ ss_scan sys_mmap ↻ ss_manifest_dyn ss_scan_seglist ws_field pl_atoi sys_mmap ↻ pl_build_key ↻ pl_build_rec fa_cat fa_catn sys_mmap ↻ sys_now_realtime_sec sys_mmap ↻ sys_clock_gettime_real ws_put_p sys_mmap ↻ ws_len ss_get ↻ ss_begin ss_begin_cap sys_mmap ↻ ss_add ss_add2 ss_w32 ss_len ws_seg_next ss_next_segid sys_mmap ↻ ss_cat ss_readall

structs

none

consts

20const PR_PREFIX: *u8 = "knowledge/store/pl-" // production live work-items
21const PR_GATE_PREFIX: *u8 = "knowledge/store/plrun-" // self-gate scratch (cleaned before run)
22const PR_LOG: *u8 = "knowledge/status/pipeline_run.log"
23const PR_RUNNER: *u8 = "_offc/nx_sov_build_run.elf"

functions

25func pr_(s: *u8) -> i64 { var n: i64 = 0; while s[n] != (0 as u8) { n = n + 1 } sys_write(1, s, n); return 0 }
called by 1: main calls 1: sys_write
26func prn(v: i64) -> i64
called by 1: main calls 2: sys_mmapsys_write
35func pr_eq(a: *u8, b: *u8) -> i64
called by 1: main
43func pr_organ_for(cur: i64) -> *u8
called by 2: pr_exec_stubpr_exec_live
54func pr_exec_stub(cur: i64, id: *u8, fail_at: i64, art_out: *u8) -> i64
called by 1: pr_run calls 2: fa_catpr_organ_for
67func pr_run(prefix: *u8, id: *u8, fail_at: i64) -> i64
called by 1: main calls 4: pl_stage_psys_mmappr_exec_stubpl_advance_p
86func pr_run_organ(organ: *u8) -> i64
called by 2: pr_exec_livemain calls 7: sys_forksys_openat_wrsys_dup3sys_mmapsys_execvesys_exit+1
104func pr_exec_live(cur: i64, id: *u8, art_out: *u8) -> i64
called by 1: pr_run_live calls 4: pr_organ_forpr_run_organfa_catfa_catn
117func pr_run_live(prefix: *u8, id: *u8) -> i64
called by 1: main calls 4: pl_stage_psys_mmappr_exec_livepl_advance_p
134func main(argc: i64, argv: *i64) -> i64
calls 15: pr_eqpl_seed_ppr_prnsys_exitpr_run+9