pr 34
This commit is contained in:
@@ -1,53 +1,3 @@
|
||||
## PR-09 — HIP ISA Freeze v0: Opcode Table + Encoding Contract (Bytecode)
|
||||
|
||||
### Goal
|
||||
|
||||
Freeze the HIP-related opcode set and encoding so bytecode becomes stable.
|
||||
|
||||
### Required Changes
|
||||
|
||||
1. Update `prometeu-bytecode`:
|
||||
|
||||
* Define the canonical HIP opcode subset:
|
||||
|
||||
* `PUSH_CONST`
|
||||
* `ALLOC(type_id, slots)`
|
||||
* `GATE_BEGIN_PEEK`, `GATE_END_PEEK`
|
||||
* `GATE_BEGIN_BORROW`, `GATE_END_BORROW`
|
||||
* `GATE_BEGIN_MUTATE`, `GATE_END_MUTATE`
|
||||
* `GATE_LOAD(offset)`
|
||||
* `GATE_STORE(offset)`
|
||||
* `GATE_RETAIN`, `GATE_RELEASE`
|
||||
* `FRAME_SYNC` (if included)
|
||||
|
||||
2. Define canonical encodings (normative in comments/doc):
|
||||
|
||||
* `GateId` encoding: `u32` little-endian
|
||||
* `TypeId` encoding: `u32` little-endian
|
||||
* `ConstId` encoding: `u32` little-endian
|
||||
* `slots`: `u32` little-endian
|
||||
* `offset`: `u32` little-endian
|
||||
|
||||
3. Update bytecode emitter so it emits these exact opcodes with these exact payloads.
|
||||
|
||||
### Non-goals
|
||||
|
||||
* No runtime execution changes
|
||||
|
||||
### Tests (Mandatory)
|
||||
|
||||
1. **Golden bytecode tests**:
|
||||
|
||||
* Given a minimal VM IR program using each HIP opcode, assert the exact emitted bytes.
|
||||
|
||||
2. **Opcode stability test**:
|
||||
|
||||
* Snapshot test of the opcode enum ordering and numeric values.
|
||||
|
||||
> If opcode numeric values already exist, DO NOT renumber. If new opcodes are added, append them.
|
||||
|
||||
---
|
||||
|
||||
## PR-10 — HIP ABI Freeze v0: Trap Conditions + Debug Surface
|
||||
|
||||
### Goal
|
||||
|
||||
Reference in New Issue
Block a user