[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
+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: