[PERF] Host Debug Overlay Isolation
This commit is contained in:
@@ -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
|
||||
|
||||
@@ -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:
|
||||
|
||||
Reference in New Issue
Block a user