Skip to content

Commit 7d7c289

Browse files
committed
docs(ai): append Epoch 7 (The TSC Proof) to Immortal Rationale
Documented the zero-overhead telemetry mechanism using the internal CPU Time Stamp Counter (__builtin_ia32_rdtsc) to mathematically prove the 59ns latency provided by the Dead Core Sacrifice.
1 parent a5bce9d commit 7d7c289

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
@@ -42,4 +42,12 @@ To achieve true 59ns determinism, we moved to a Pinned-Isolation Model. We treat
4242

4343
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.
4444

45+
## Epoch 7: The TSC Proof (Verifying the Sacrifice)
46+
47+
If you kill a core, you must prove it was worth the blood. To verify that our `isolcpus` pinning eliminated all OS jitter, we rely on the hardware itself.
48+
49+
We inject the CPU's internal Time Stamp Counter (`__builtin_ia32_rdtsc()`) directly into the `PriceMatrix` struct at the exact nanosecond the ingress thread touches the network packet. By passing this hardware TSC value through the DMA buffer to the Execution core, and having the Cockpit UI read it out-of-band via Shared Memory, we achieve perfectly synchronous, zero-overhead telemetry.
50+
51+
The TSC proves our determinism: it allows us to visualize the 59ns heartbeat on our frontend, confirming unequivocally that the OS has not stolen a single cycle.
52+
4553
**End of Rationale.**

0 commit comments

Comments
 (0)