code wiki / clock

topic: clock

26 modules sharing the clock name family (derived from the tree's prefix discipline).

The 'clock' topic family in the Nishi sovereign ecosystem provides the foundational timekeeping mechanisms necessary for coordinated execution across the system. The nx_clock module serves as the monotonic clock primitive, while nx_clock_dispatch_gate ensures the clock's functionality by verifying the execution of registered jobs. The nx_clock_full module integrates both the wall-clock and monotonic time, enabling precise scheduling and timing across the runtime.

auto-narrated by the local model from this topic's module headers; links verified against the wiki index.

narrated overview -- maintained by the narration lane, module links verified against this wiki.

moduledescriptionlinesfuncs
nx_clock.nxMONOTONIC CLOCK PRIMITIVE for the runtime layer.381
nx_clock_caps.nxTHE ONE COMMAND-SLOT CAP for the clock plane, shared by BOTH ends: 260
nx_clock_dispatch_gate.nxproves the clock is FUNCTIONAL: its ONE dispatcher actually RUNS a registered job's586
nx_clock_driver_boundary_ar.nxTEST ONLY: strict fixture persistence boundary, not a segment-store implementation.11112
nx_clock_driver_gate_ar.nxLocal-only V2 real-process scheduler harness. Positive closure uses production seams;37221
nx_clock_driver_sched_ar.nxRENAMED FROM nx_clock.nx 2026-07-31 (lib-reconcile). PERMANENT FIX for a151252
nx_clock_driver_subject_ar.nxthe TICKLESS driver (the sched_tickless.raw lesson: don't burn a constant tick when24812
nx_clock_driver_toolrun_ar.nxR0 of the EXECUTABLE-API rung: the sovereign exec+capture primitive the ecosystem62612
nx_clock_edf_gate.nxGATE for the wall-clock/EDF scheduler (debt 1785872141, operator 2026-08-041814
nx_clock_full.nxsovereign wall-clock + monotonic time primitive.745
nx_clock_gate.nxproves the ONE Nishi clock (operator: "s class exceed like how pulses work on clocks ...1124
nx_clock_marker.nxa trivial organ for nx_clock_dispatch_gate. Each RUN reads the counter in /tmp/clk_mark.txt,171
nx_clock_reregister_gate.nxBITE PROOF for the clk_register update fix.5468
nx_clock_reserved_fault_native_v2_ar.nxLocal-only V2 real-process scheduler harness. Positive closure uses production seams;43921
nx_clock_reserved_native_v2_ar.nxLocal-only V2 real-process scheduler harness. Positive closure uses production seams;43921
nx_clock_reserved_pure_v2_ar.nxPure activation/service tests for the local scheduler candidate. Not a native scheduling/liveness proof.693
nx_clock_run.nxTHE SINGLE SPARK. One invocation = ONE beat of the one Nishi clock: load the ONE durable345
nx_clock_sched.nxRENAMED FROM nx_clock.nx 2026-07-31 (lib-reconcile). PERMANENT FIX for a 120738
nx_clock_sched_reserved_fault_v2_ar.nxRENAMED FROM nx_clock.nx 2026-07-31 (lib-reconcile). PERMANENT FIX for a151352
nx_clock_sched_reserved_v2_ar.nxRENAMED FROM nx_clock.nx 2026-07-31 (lib-reconcile). PERMANENT FIX for a145448
nx_clock_sitecheck.nxa NAS-APPROPRIATE clock job: probe the live site and record UP/DOWN. Unlike the local304
nx_clock_status.nxONE view of the whole consolidated clock (the de-sprawl payoff: every periodic job in one344
nx_clock_status_gate.nxproves the clock STATUS logic (the consolidation payoff: one view of every periodic403
nx_clock_test.nxverify clock primitive returns valid + monotonic times. 431
nx_clock_tickless.nxthe TICKLESS driver (the sched_tickless.raw lesson: don't burn a constant tick when 23012
nx_clock_tickless_gate.nxproves the TICKLESS driver (sched_tickless.raw lesson) entirely IN the nishi525