[PERF] Host Debug Overlay Isolation

This commit is contained in:
2026-04-10 14:10:20 +01:00
parent b8d33c9e02
commit 58a5f9a3a6
18 changed files with 1315 additions and 123 deletions
@@ -125,6 +125,7 @@ The platform layer:
- only displays the framebuffer
- does not reinterpret graphics commands
- **may overlay technical HUDs without modifying the logical framebuffer**
- may transport the logical framebuffer into a host presentation surface where a host-only overlay layer is composed
## 9 Debug and Inspection Isolation
@@ -133,6 +134,7 @@ To preserve portability and certification purity, technical inspection tools (li
- **Host-exclusive:** These tools are only implemented where they are relevant (e.g., Desktop) and do not exist in the logical machine.
- **Non-intrusive:** They must not consume machine cycles or alter memory state.
- **Consistent Results:** A cartridge will produce the same logical results and certification metrics regardless of the Host's inspection capabilities.
- **Contract Boundary:** Emulated graphics primitives such as `fill_rect` and `draw_text` remain part of the machine contract, but Host overlays must not depend on them.
### 9.1 Atomic Telemetry Interface