code wiki / _hdl_build / nx_gate_loop.nx

nx_gate_loop.nx

buildroot/runtime/_hdl_build/nx_gate_loop.nx

10050 B278 linesdepth 2pulls 2 transitivereach 0 importersview sourcekind tooltopic gate

docs dependencies structs consts functions

about

nx_gate_loop.nx -- TEAM-OWNED loop daemon that runs nx_gate_sentinel on a cadence (GAME arc step G5: "wire the sentinel into the loop cadence so grades refresh with no human/LLM trigger"). Closes the loop-monitor lesson from [[project-self-running-loop-governed-ingest-2026-06-05]]: a loop must have a MONITORED OUTPUT CHANNEL -- every beat appends one line to /tmp/nishi_game_gate_loop.log, and the sentinel itself escalates regressions to the PM review log, so a DRY or STALLED loop is visible in the logs, not silent. Usage (from nxc2 repo root): nx_gate_loop.elf # production: 30-min beat, forever, daemonized nx_gate_loop.elf <beat_ms> # custom beat, forever, daemonized nx_gate_loop.elf <beat_ms> <n_beats> # TEST MODE: n beats, FOREGROUND (no daemonize) Daemonized = fork + setsid; the launcher returns immediately and the loop survives the launching terminal (pattern from the sites-daemon arc). license_tier: ORIGINAL

dependencies 1 imports · 0 importers

imports: nx_syscalls.nx

imported by: nobody (leaf or entry point)

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

structs

none

consts

20	const GL_DEFAULT_BEAT_MS: i64 = 1800000 // 30 min
21	const GL_LOG: i64 = 0

functions

23	func gl_cat(dst: u8, off: i64, s: u8) -> i64 { var i: i64 = 0; while s[i] != (0 as u8) { dst[off+i] = s[i]; i = i + 1 } return off + i } called by 4: gl_pid_alive gl_beat_line gl_loop main
24	func gl_cat_n(dst: *u8, off: i64, v: i64) -> i64 called by 5: gl_pid_alive gl_acquire_lock gl_beat_line gl_loop main calls 1: sys_mmap
38	func gl_atoi(s: *u8) -> i64 called by 1: main
67	func gl_getpid() -> i64 called by 1: gl_acquire_lock calls 2: sys_mmap sys_read_file
88	func gl_pid_alive(pid: i64) -> i64 called by 2: gl_acquire_lock main calls 5: sys_mmap gl_cat gl_cat_n sys_openat_rd sys_close
102	func gl_read_pidfile(path: *u8) -> i64 called by 2: gl_acquire_lock main calls 2: sys_mmap sys_read_file
121	func gl_acquire_lock() -> i64 called by 1: main calls 8: gl_read_pidfile gl_pid_alive sys_openat_wr sys_mmap gl_cat_n gl_getpid+2
138	func gl_run_sentinel() -> i64 called by 1: gl_loop calls 7: sys_fork sys_openat_wr sys_dup3 sys_mmap sys_execve sys_exit+1
157	func gl_beat_line(beat: i64, rc: i64) -> i64 called by 1: gl_loop calls 7: sys_openat_append sys_mmap gl_cat gl_cat_n sys_now_realtime_sec sys_write+1
178	func gl_run_journey() -> i64 called by 1: gl_loop calls 9: sys_openat_rd sys_close sys_fork sys_openat_wr sys_dup3 sys_mmap+3
200	func gl_loop(beat_ms: i64, n_beats: i64) -> i64 called by 1: main calls 10: gl_run_sentinel gl_beat_line gl_run_journey sys_openat_append sys_mmap gl_cat+4
227	func main(argc: i64, argv: *i64) -> i64 calls 13: gl_atoi gl_acquire_lock sys_write gl_loop gl_read_pidfile gl_pid_alive+7