[PERF] Host Debug Overlay Isolation

This commit is contained in:
2026-04-10 19:16:44 +01:00
parent 58a5f9a3a6
commit 4cdfaefda7
17 changed files with 490 additions and 402 deletions
@@ -187,6 +187,23 @@ Limit:32KB
These data directly feed the certification.
### 7.1 Bank Occupancy Profiling
Bank occupancy diagnostics are slot-first.
The visible per-bank telemetry used by host inspection surfaces and certification is:
- `bank_type`
- `used_slots`
- `total_slots`
For the current runtime banks, the canonical bank names are:
- `GLYPH`
- `SOUNDS`
Byte-oriented bank occupancy is not the canonical visible profiling contract.
## 8 Breakpoints and Watchpoints
### 8.1 Breakpoints
@@ -218,6 +235,17 @@ Execution can pause when:
## 9 Event and Fault Debugging
## 10 Certification Diagnostics
Certification diagnostics may enforce bank occupancy ceilings.
For bank residency, certification uses slot-based limits, such as:
- `max_glyph_slots_used`
- `max_sound_slots_used`
Bank certification MUST NOT depend on `max_gfx_bytes` or `max_audio_bytes`.
PROMETEU allows observing:
- event queue
+22 -1
View File
@@ -169,7 +169,7 @@ For `TILES` v1:
The current runtime exposes bank types:
- `TILES`
- `GLYPH`
- `SOUNDS`
Assets are loaded into explicit slots identified by slot index at the public ABI boundary.
@@ -184,6 +184,27 @@ SlotRef { bank_type, index }
That internal representation is derived from the resolved `AssetEntry`, not supplied by the caller.
### 5.1 Canonical Bank Telemetry
The canonical visible bank telemetry contract is exposed by `AssetManager`.
The per-bank summary is slot-first and uses this shape:
```text
BankTelemetry {
bank_type
used_slots
total_slots
}
```
Rules:
- the visible contract MUST NOT expose byte-oriented bank occupancy as the canonical summary;
- canonical bank names are `GLYPH` and `SOUNDS`;
- detailed occupancy inspection remains slot-based through slot references, not bank byte totals;
- any residual byte accounting MAY exist internally, but it is not part of the visible bank telemetry contract.
## 6 Load Lifecycle
The runtime asset manager exposes a staged lifecycle: