Skip to content

Commit a5bce9d

Browse files
committed
docs(ai): append Epoch 6 (The Dead Core Sacrifice) to Immortal Rationale
Added the Hardware Ownership lore regarding isolcpus and mm_pause spinlocks to permanently document the 59ns determinism requirement.
1 parent 2878cba commit a5bce9d

1 file changed

Lines changed: 8 additions & 0 deletions

File tree

docs/IMMORTAL_RATIONALE.md

Lines changed: 8 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -34,4 +34,12 @@ Observability is a poison pill for latency. Standard `std::cout` or spdlog block
3434
* **The Trap:** Logging tick arrivals or latency metrics destroyed the pipeline.
3535
* **The Pivot:** We hijacked the existing `update_seq` "Dirty Bit" in the `PriceMatrix`. We replaced 4 bytes of explicit padding with a `uint32_t arrival_tsc` timestamp. Now, telemetry is purely passive. We `mmap` the `PriceMatrix` array into POSIX shared memory. External `quanux-spreader` man pages instruct humans to read the SHM segment to track engine health without the Executive Loop ever executing a single `write()` system call.
3636

37+
## Epoch 6: The Dead Core Sacrifice (Hardware Ownership)
38+
39+
"Why build one when you can have two for twice the price?" In the QuanuX Forge, this quote from *Contact* defines our Core Isolation Policy. We realized that even with the 64-byte covenant and the Cython Forge, the OS scheduler remained our final enemy. A "fair" scheduler is a slow scheduler.
40+
41+
To achieve true 59ns determinism, we moved to a Pinned-Isolation Model. We treat the CPU like private real estate, using `isolcpus` at the kernel level to forcibly eject the Operating System from specific physical cores. We sacrifice Core 3 for Ingress and Core 4 for Execution, keeping them "hot" in a constant `_mm_pause()` spin-loop.
42+
43+
We pay "twice the price" in power consumption and hardware availability to buy the ultimate HFT luxury: Absolute Determinism. By preventing the CPU from ever entering a power-saving C-state or being interrupted by system tasks, we ensure the engine is always "awake" and waiting for the next tick.
44+
3745
**End of Rationale.**

0 commit comments

Comments
 (0)