feat(runtime): add optional pause and resume lifecycle hooks
Intrepid/Prometeu/Runtime/pipeline/pr-master Build started...

This commit is contained in:
2026-10-13 12:18:18 +01:00
parent 23dc6fc66d
commit 0af8b2b1fe
39 changed files with 1381 additions and 70 deletions
@@ -129,6 +129,7 @@ fn captures_section_has_independent_bytes_and_strict_shape() {
let r = resolve(RegistryDeclarations {
types: vec![builtin(BuiltinId::INT32), builtin(BuiltinId::VEC2)],
functions: vec![FunctionDecl {
lifecycle_role: Default::default(),
code_len: 2,
captures: vec![TypeId(1), TypeId(0)],
..Default::default()
@@ -167,22 +168,22 @@ fn hex(s: &str) -> Vec<u8> {
// Independently specified PBX, not generated by any production serializer.
// Header 32 bytes, eight directory entries (96 bytes), payload starts at 128.
// constants=128/4, functions=132/29, code=161/2, exports=163/4,
// syscalls=167/4, types=171/10, implementations=181/4. Total=193.
// constants=128/4, functions=132/30, code=162/2, exports=164/4,
// syscalls=168/4, types=172/10, implementations=182/4, captures=186/8. Total=194.
fn minimal_bytes() -> Vec<u8> {
hex("
50 42 58 00 01 00 00 00 08 00 00 00
00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00
00 00 00 00 80 00 00 00 04 00 00 00
01 00 00 00 84 00 00 00 1d 00 00 00
02 00 00 00 a1 00 00 00 02 00 00 00
04 00 00 00 a3 00 00 00 04 00 00 00
05 00 00 00 a7 00 00 00 04 00 00 00
06 00 00 00 ab 00 00 00 0a 00 00 00
07 00 00 00 b5 00 00 00 04 00 00 00
08 00 00 00 b9 00 00 00 08 00 00 00
01 00 00 00 84 00 00 00 1e 00 00 00
02 00 00 00 a2 00 00 00 02 00 00 00
04 00 00 00 a4 00 00 00 04 00 00 00
05 00 00 00 a8 00 00 00 04 00 00 00
06 00 00 00 ac 00 00 00 0a 00 00 00
07 00 00 00 b6 00 00 00 04 00 00 00
08 00 00 00 ba 00 00 00 08 00 00 00
00 00 00 00
01 00 00 00 00 00 00 00 00 00 00 00 00
01 00 00 00 00 00 00 00 00 00 00 00 00 00
00 00 00 00 02 00 00 00 00 00 00 00 00 00 00 00
01 00
00 00 00 00
@@ -194,7 +195,11 @@ fn minimal_bytes() -> Vec<u8> {
fn minimal_registry() -> Registry {
resolve(RegistryDeclarations {
types: vec![builtin(BuiltinId::BOOL)],
functions: vec![FunctionDecl { code_len: 2, ..Default::default() }],
functions: vec![FunctionDecl {
lifecycle_role: Default::default(),
code_len: 2,
..Default::default()
}],
..Default::default()
})
.unwrap()
@@ -225,10 +230,10 @@ fn writer_matches_independent_minimal_envelope() {
let sections = encode_registry(&minimal_registry(), &mut budget()).unwrap();
let bytes = envelope(&sections.types, &sections.functions, &sections.implementations);
assert_eq!(bytes, minimal_bytes());
assert_eq!(bytes.len(), 193);
assert_eq!(bytes.len(), 194);
let mut b = budget();
let env = PbxEnvelope::parse(&bytes, &mut b).unwrap();
assert_eq!(env.section(2).unwrap().offset, 161);
assert_eq!(env.section(2).unwrap().offset, 162);
let registry = env.resolve_registry(&mut b).unwrap();
assert_eq!(registry.declarations(), minimal_registry().declarations());
assert_eq!(b.used(LoadResource::TemporaryBytes), 0);
@@ -499,7 +504,7 @@ fn representative_records_match_fixed_bytes_and_preserve_names_without_debug() {
01 00 00 00 00 00 00 00 01 01 00 00 00 70
01 00 00 00 00 00 00 00");
let functions = hex("
01 00 00 00 01 01 00 00 00 66
01 00 00 00 00 01 01 00 00 00 66
02 00 00 00 01 00 00 00 00 00 00 00 00 01 01 00 00 00 70
01 00 00 00 00 00 00 00
00 00 00 00 02 00 00 00 00 00 00 00 01 00 00 00");
@@ -721,6 +726,7 @@ fn implemented() -> RegistryDeclarations {
},
],
functions: vec![FunctionDecl {
lifecycle_role: Default::default(),
signature: Signature { parameters: vec![named(1), named(0)], results: vec![TypeId(0)] },
code_len: 2,
max_stack_slots: 2,
@@ -1024,7 +1030,7 @@ fn reference_map_probe() {
fn independent_multi_slot_signature_fixture_has_no_serialized_widths() {
// vec2 import; fn(vec2)->vec2; GET_LOCAL 0; GET_LOCAL 1; RET.
let types = hex("01 00 00 00 00 00 02 00 00 00");
let functions=hex("01 00 00 00 00 01 00 00 00 00 00 00 00 00 01 00 00 00 00 00 00 00 00 00 00 00 0e 00 00 00 00 00 00 00 02 00 00 00");
let functions=hex("01 00 00 00 00 00 01 00 00 00 00 00 00 00 00 01 00 00 00 00 00 00 00 00 00 00 00 0e 00 00 00 00 00 00 00 02 00 00 00");
let code = hex("42 00 00 00 00 00 42 00 01 00 00 00 51 00");
let empty = [0; 4];
let bytes = encode_envelope(
@@ -1055,3 +1061,70 @@ fn independent_multi_slot_signature_fixture_has_no_serialized_widths() {
assert_eq!(sections.functions, functions);
assert_eq!(sections.types, types);
}
#[test]
fn lifecycle_roles_resolve_and_roundtrip_with_strict_validation() {
let functions = vec![
FunctionDecl { code_len: 2, ..Default::default() },
FunctionDecl {
lifecycle_role: LifecycleRole::BeforePause,
code_offset: 2,
code_len: 2,
..Default::default()
},
FunctionDecl {
lifecycle_role: LifecycleRole::BeforeResume,
code_offset: 4,
code_len: 2,
..Default::default()
},
];
let declarations = RegistryDeclarations {
types: vec![builtin(BuiltinId::BOOL)],
functions,
..Default::default()
};
let registry = resolve(declarations.clone()).unwrap();
assert_eq!(registry.lifecycle_hook(LifecycleRole::None), None);
assert_eq!(registry.lifecycle_hook(LifecycleRole::BeforePause), Some(FunctionId(1)));
assert_eq!(registry.lifecycle_hook(LifecycleRole::BeforeResume), Some(FunctionId(2)));
let bytes = PbxModule {
registry: &registry,
code: &[1, 0, 1, 0, 1, 0],
constants: &[],
debug: None,
exports: &[],
syscalls: &[],
}
.serialize(&mut budget())
.unwrap();
let parsed = OwnedPbx::parse(&bytes, &mut budget()).unwrap();
assert_eq!(parsed.registry.declarations(), &declarations);
let env = PbxEnvelope::parse(&bytes, &mut budget()).unwrap();
let role_offset = env.section(1).unwrap().offset + 4;
let mut invalid = bytes.clone();
invalid[role_offset] = 255;
let error = OwnedPbx::parse(&invalid, &mut budget()).unwrap_err();
assert_eq!(error.reason, LoadReason::LifecycleRole);
assert_eq!(error.function, Some(0));
assert_eq!(error.offset, Some(role_offset));
for case in 0..5 {
let mut d = declarations.clone();
match case {
0 => d.functions[0].lifecycle_role = LifecycleRole::BeforePause,
1 => d.functions[2].lifecycle_role = LifecycleRole::BeforePause,
2 => d.functions[1].signature.parameters.push(named(0)),
3 => d.functions[1].signature.results.push(TypeId(0)),
_ => d.functions[1].captures.push(TypeId(0)),
}
let error = resolve(d).unwrap_err();
assert_eq!(
error.reason,
if case == 1 {
LoadReason::DuplicateLifecycleRole
} else {
LoadReason::LifecycleSignature
}
);
}
}