feat(vm)!: implement typed callables and single-context execution
Intrepid/Prometeu/Runtime/pipeline/pr-master This commit looks good

Add structural Fn signatures, typed capture environments, indirect calls and Trait dispatch while preserving logical parameter and result groups, ownership and budgets.

Remove guest coroutine execution and legacy loading. Activate bounded sealed PBX v1 with mandatory capture metadata, preserve frame continuations and root return results, and migrate producers and shipped cartridges.

Publish coordinated specs, handoffs and the completed runtime lesson. Validation: 880 workspace tests passed, 9 existing tests ignored; both cartridges completed six production-host frames.
This commit is contained in:
2026-10-09 05:47:24 +01:00
parent 86bade3e1f
commit ec84a6bba5
96 changed files with 3656 additions and 6075 deletions
+30 -21
View File
@@ -1,6 +1,9 @@
use anyhow::Result;
use prometeu_bytecode::assembler::assemble;
use prometeu_bytecode::model::{BytecodeModule, DebugInfo, Export, FunctionMeta, SyscallDecl};
use prometeu_bytecode::load_limits::LoadBudget;
use prometeu_bytecode::model::{DebugInfo, Export, SyscallDecl};
use prometeu_bytecode::registry::{FunctionDecl, Registry, RegistryDeclarations};
use prometeu_bytecode::registry_codec::PbxModule;
use prometeu_hal::color::Color;
use std::fs;
use std::path::PathBuf;
@@ -54,7 +57,6 @@ pub fn build_program() -> Vec<u8> {
PUSH_I64 {}\n\
GET_LOCAL 0\n\
HOSTCALL 1\n\
FRAME_SYNC\n\
RET",
Color::WHITE.raw()
)));
@@ -64,24 +66,30 @@ pub fn build_program() -> Vec<u8> {
patch_jump(&mut rom, jump_to_blue_case_offset, blue_case);
patch_jump(&mut rom, jump_to_draw_after_green_offset, draw);
BytecodeModule {
version: 0,
const_pool: vec![],
functions: vec![FunctionMeta {
code_offset: 0,
code_len: rom.len() as u32,
param_slots: 0,
local_slots: 1,
return_slots: 0,
max_stack_slots: 8,
}],
code: rom,
debug_info: Some(DebugInfo {
pc_to_span: vec![],
function_names: vec![(0, "main".into())],
}),
exports: vec![Export { symbol: "main".into(), func_idx: 0 }],
syscalls: vec![
let code = rom;
let debug = DebugInfo { pc_to_span: vec![], function_names: vec![(0, "main".into())] };
let exports = [Export { symbol: "main".into(), func_idx: 0 }];
let registry = Registry::resolve(
RegistryDeclarations {
functions: vec![FunctionDecl {
code_len: code.len() as u32,
local_slots: 1,
max_stack_slots: 8,
..Default::default()
}],
..Default::default()
},
code.len(),
&mut LoadBudget::new(Default::default()),
)
.expect("resolved program declarations");
PbxModule {
registry: &registry,
constants: &[],
code: &code,
debug: Some(&debug),
exports: &exports,
syscalls: &[
SyscallDecl {
module: "gfx2d".into(),
name: "clear".into(),
@@ -98,7 +106,8 @@ pub fn build_program() -> Vec<u8> {
},
],
}
.serialize()
.serialize(&mut LoadBudget::new(Default::default()))
.expect("bounded v1 program")
}
pub fn manifest_json() -> Vec<u8> {
+37 -32
View File
@@ -1,8 +1,9 @@
use anyhow::Result;
use prometeu_bytecode::assembler::assemble;
use prometeu_bytecode::model::{
BytecodeModule, ConstantPoolEntry, DebugInfo, Export, FunctionMeta, SyscallDecl,
};
use prometeu_bytecode::load_limits::LoadBudget;
use prometeu_bytecode::model::{ConstantPoolEntry, DebugInfo, Export, SyscallDecl};
use prometeu_bytecode::registry::{FunctionDecl, Registry, RegistryDeclarations};
use prometeu_bytecode::registry_codec::PbxModule;
use prometeu_hal::asset::{
AssetCodec, AssetEntry, AssetId, BankType, PreloadEntry, SCENE_DECODED_LAYER_OVERHEAD_BYTES_V1,
SCENE_LAYER_COUNT_V1, SCENE_PAYLOAD_MAGIC_V1, SCENE_PAYLOAD_VERSION_V1,
@@ -81,34 +82,38 @@ pub fn generate() -> Result<()> {
heavy_load(&mut rom);
// light_load(&mut rom);
let functions = vec![FunctionMeta {
code_offset: 0,
code_len: rom.len() as u32,
param_slots: 0,
local_slots: 2,
return_slots: 0,
max_stack_slots: 32,
}];
let module = BytecodeModule {
version: 0,
const_pool: vec![
ConstantPoolEntry::String("stress".into()),
ConstantPoolEntry::String("frame".into()),
ConstantPoolEntry::String("overlay".into()),
ConstantPoolEntry::String("composer".into()),
],
functions,
code: rom,
debug_info: Some(DebugInfo {
pc_to_span: vec![],
function_names: vec![(0, "main".into())],
}),
exports: vec![Export { symbol: "main".into(), func_idx: 0 }],
syscalls,
};
let bytes = module.serialize();
let registry = Registry::resolve(
RegistryDeclarations {
functions: vec![FunctionDecl {
code_len: rom.len() as u32,
local_slots: 2,
max_stack_slots: 32,
..Default::default()
}],
..Default::default()
},
rom.len(),
&mut LoadBudget::new(Default::default()),
)
.expect("resolved program declarations");
let constants = vec![
ConstantPoolEntry::String("stress".into()),
ConstantPoolEntry::String("frame".into()),
ConstantPoolEntry::String("overlay".into()),
ConstantPoolEntry::String("composer".into()),
];
let debug = DebugInfo { pc_to_span: vec![], function_names: vec![(0, "main".into())] };
let exports = [Export { symbol: "main".into(), func_idx: 0 }];
let bytes = PbxModule {
registry: &registry,
constants: &constants,
code: &rom,
debug: Some(&debug),
exports: &exports,
syscalls: &syscalls,
}
.serialize(&mut LoadBudget::new(Default::default()))
.expect("bounded v1 program");
let mut out_dir = PathBuf::from(env!("CARGO_MANIFEST_DIR"));
out_dir.pop(); // pbxgen-stress
@@ -209,7 +214,7 @@ fn heavy_load(rom: &mut Vec<u8>) {
rom.extend(asm("PUSH_I32 2\nPUSH_CONST 0\nHOSTCALL 1"));
let after_log = rom.len() as u32;
rom.extend(asm("FRAME_SYNC\nRET"));
rom.extend(asm("RET"));
let patch = |buf: &mut Vec<u8>, imm_offset: usize, target: u32| {
buf[imm_offset..imm_offset + 4].copy_from_slice(&target.to_le_bytes());
+1
View File
@@ -36,3 +36,4 @@ prometeu-bytecode = { path = "../../console/prometeu-bytecode" }
prometeu-hal = { path = "../../console/prometeu-hal" }
base64 = "0.22"
png = "0.17"
prometeu-test-support = { path = "../../dev/prometeu-test-support" }
@@ -1,8 +1,10 @@
use base64::{Engine as _, engine::general_purpose::STANDARD};
use prometeu_bytecode::SourceSpan;
use prometeu_bytecode::assembler::assemble;
use prometeu_bytecode::model::{BytecodeModule, DebugInfo, Export, FunctionMeta, SyscallDecl};
use prometeu_bytecode::model::{DebugInfo, Export, SyscallDecl};
use prometeu_bytecode::registry::FunctionDecl;
use prometeu_host_headless::{AdvanceFramesStop, HeadlessHost};
use prometeu_test_support::program::{TestProgram, int64_signature};
use serde_json::{Value, json};
use std::collections::HashMap;
use std::fs;
@@ -175,16 +177,16 @@ fn cartridge(code: &str, gfx: bool) -> TempDir {
fn cartridge_bytes(code: Vec<u8>, gfx: bool) -> TempDir {
let dir = TempDir::new();
let module = BytecodeModule {
version: 0,
let module = TestProgram {
const_pool: vec![],
functions: vec![FunctionMeta {
functions: vec![FunctionDecl {
code_offset: 0,
code_len: code.len() as u32,
param_slots: 0,
local_slots: 0,
return_slots: 0,
max_stack_slots: 8,
signature: int64_signature(0, 0),
captures: vec![],
name: None,
}],
code,
debug_info: Some(DebugInfo {
@@ -216,7 +218,7 @@ fn cartridge_bytes(code: Vec<u8>, gfx: bool) -> TempDir {
}
fn colored_cart() -> TempDir {
cartridge("PUSH_I64 4278190335\nHOSTCALL 0\nFRAME_SYNC\nRET\n", true)
cartridge("PUSH_I64 4278190335\nHOSTCALL 0\nRET\n", true)
}
fn boot(client: &mut Client, dir: &TempDir) {
client.ok("boot", json!({"path":dir.0}));
@@ -342,12 +344,10 @@ fn independent_processes_match_pixels_ids_state_and_fault() {
// Color is selected by the real normalized RIGHT-down intrinsic.
let mut code = assemble("INTRINSIC 0x210E\n").unwrap();
let jump = code.len() + 2;
code.extend(
assemble("JMP_IF_FALSE 0\nPUSH_I64 4278190335\nHOSTCALL 0\nFRAME_SYNC\nRET\n").unwrap(),
);
code.extend(assemble("JMP_IF_FALSE 0\nPUSH_I64 4278190335\nHOSTCALL 0\nRET\n").unwrap());
let blue = code.len() as u32;
code[jump..jump + 4].copy_from_slice(&blue.to_le_bytes());
code.extend(assemble("PUSH_I64 65535\nHOSTCALL 0\nFRAME_SYNC\nRET\n").unwrap());
code.extend(assemble("PUSH_I64 65535\nHOSTCALL 0\nRET\n").unwrap());
let dir = cartridge_bytes(code, true);
let run = |c: &mut Client| {
boot(c, &dir);
@@ -382,7 +382,7 @@ fn partial_guest_fault_and_host_watchdog_are_distinct_outcomes() {
code.extend(assemble("JMP_IF_FALSE 0\nTRAP\n").unwrap());
let next = code.len() as u32;
code[jump..jump + 4].copy_from_slice(&next.to_le_bytes());
code.extend(assemble("PUSH_I64 255\nHOSTCALL 0\nFRAME_SYNC\nRET\n").unwrap());
code.extend(assemble("PUSH_I64 255\nHOSTCALL 0\nRET\n").unwrap());
let dir = cartridge_bytes(code, true);
let mut c = Client::new(&["--stdio"]);
c.initialize();
@@ -405,7 +405,7 @@ fn partial_guest_fault_and_host_watchdog_are_distinct_outcomes() {
#[test]
fn faults_and_boot_failures_are_structured_not_log_parsing() {
let dir = cartridge("TRAP\nFRAME_SYNC\nRET\n", false);
let dir = cartridge("TRAP\nRET\n", false);
let mut c = Client::new(&["--stdio"]);
c.initialize();
boot(&mut c, &dir);