nx_race_timing.nx

nx_race_timing.nx -- sealed-enum race timing mode + helpers. User directive 2026-05-16: "i want visualization with a manual and scheduled and automatic capbility flag so we can race when we want and do all three aka manual event driven scheduled and whatever other is s class timing" Four-pillar discipline for the racing crew's HOW-IT-FIRES question: HAVE -- every race today fires manually via bench/*.sh FIX -- this file: sealed-enum 8 timing modes PREVENTION -- .race_telemetry.tsv gains timing_mode column; nx_race_visualizer.nx surfaces unused modes ADDITIVE -- MANUAL stays the default; 7 other modes ADD options without removing manual The eight S-class racing-timing modes: MANUAL -- user invokes via CLI; ad-hoc, on-demand EVENT -- filesystem watch, git commit hook, IPC signal (reactive to external state change) SCHEDULED -- cron-style time trigger; runs at named clock positions (e.g., daily at 02:00) CONTINUOUS -- every tick of a fixed period (e.g., every 60s) -- the "always-on" streaming mode IDLE -- fires when system is otherwise idle; lowest priority; never preempts user work THRESHOLD -- fires when a metric crosses a configured bound (latency p99 > X, error rate > Y, ...) PROBABILISTIC -- samples a fraction of race-opportunities; used when full-rate races would be too expensive QUORUM -- fires only when N out of M graders agree a race is currently warranted; used to dampen thrash from any single grader Each mode is a distinct discipline. This file enumerates them as a SEALED ENUM (NX_RACE_TIMING_N is the count). Callers (bench scripts, daemons, the ICL) pick a mode + record it in .race_telemetry.tsv so the visualizer can show which modes are