nx_yield.nx

nx_yield.nx -- cooperative yield contract between cells. Per cardinal: cooperative-resource-arbitration. Yield is COOPERATIVE, not preemptive. A cell declares a yield-within-N-microseconds contract on instantiation; if a higher-priority class requests the contested resource, the cell receives a yield signal and must release within its declared quantum. Cells that miss their quantum are first demoted (priority dropped one rung) and then throttled (forced sleeps inserted until they catch up). This is the structural EXCEED-axis vs preemptive OS scheduling: preemption causes cache-line invalidation and TLB shootdowns that tank foreground game frame budget. Cooperative yield lets the preempted cell hit a clean checkpoint before releasing, preserving L1/L2 state for the in-coming foreground. Composes: nx_attention_class -- determines who yields to whom nx_budget -- yield can free budget headroom for waiter nx_evict_journal -- DEMOTED / THROTTLED outcomes logged nx_homeostasis -- repeat-misser cells become migration targets V1 ships a single shared resource model. Per-resource arbitration queues (RAM vs VRAM vs CPU) are queued; today all five resources arbitrate via one contention check. Gap list (V1 honest perf verdict): - no priority-inheritance to avoid inversion - no per-resource arbitration queues (single contention model) - no monotonic clock integration (caller supplies tick_us) - no automatic re-promotion after throttle (caller must reset) genealogy_id: nishi_cardinal_2026-05-17_cooperative_resource_arbitration lineage_id: substrate_yield_v1 nx_safety_envelope: intended_use: "Cooperative yield contract enforcement; contested resources released within quantum" sil_target: SIL2 evidence: [contract_declared_at_instantiation,