nx_hal.nx

nx_hal.nx -- substrate Hardware Abstraction Layer. Cardinal 2026-05-21 ("bits up eliminate and for the rest we want to be hardware agnostic as in the future nishi silicon will run all of this"): every substrate primitive above this layer expresses hardware-level operations in HAL terms, NOT Linux-syscall terms. The HAL is the substrate-defined contract that ANY backing implementation (Linux today, bare-metal Nishi kernel tomorrow, future Nishi silicon eventually) must provide. Substrate's bottom-up sovereignty story: - Top of stack: Elder AI services + UI -- can run on whatever OS the substrate currently runs on (Win-native + bash-launched today; future substrate-hosted on a NishiLang container) - Middle: substrate primitives (HAL clients) -- hardware-agnostic; compile + run unchanged on any HAL implementation - Bottom: HAL implementation (per-target shim) -- the thin adapter that turns hardware-level HAL ops into actual machine behavior. Today: Linux syscall ABI. Tomorrow: bare-metal MMIO + page-table walks. Eventually: future Nishi silicon. The win: as we eliminate third parties layer by layer (Docker, Linux, Win32, NVIDIA), the substrate primitives DO NOT CHANGE. Only the HAL shim changes. The investment in shipped substrate is preserved. V1 operations (the hardware-level concepts any silicon must provide; bare-metal Nishi kernel + future Nishi silicon both implement these): nx_hal_clock_now_ns monotonic nanosecond timestamp nx_hal_alloc_pages contiguous page allocation nx_hal_release_pages return pages to substrate nx_hal_console_write debug-channel byte output nx_hal_random_bytes hardware-quality entropy nx_hal_yield cooperative scheduling hint nx_hal_exit process termination nx_hal_spawn fork + exec; substrate becomes parent nx_hal_wait reap child + read exit code nx_hal_kill send signal to child