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
@@ -38,7 +38,12 @@ fn registry(code: &[u8], functions: Vec<FunctionDecl>) -> Registry {
.unwrap()
}
fn function(code: &[u8]) -> FunctionDecl {
FunctionDecl { code_len: code.len() as u32, max_stack_slots: 4, ..Default::default() }
FunctionDecl {
lifecycle_role: Default::default(),
code_len: code.len() as u32,
max_stack_slots: 4,
..Default::default()
}
}
fn check(code: &[u8], registry: &Registry) -> Result<(), E> {
validate_registry_instructions(code, registry, 1, &mut LoadBudget::new(Default::default()))
@@ -53,7 +58,14 @@ fn stack_analysis_honors_literal_zero_and_wide_pop_operands() {
let mut code = vec![];
arg(&mut code, Op::PushI32, 0);
op(&mut code, Op::Halt);
let r = registry(&code, vec![FunctionDecl { max_stack_slots: 0, ..function(&code) }]);
let r = registry(
&code,
vec![FunctionDecl {
lifecycle_role: Default::default(),
max_stack_slots: 0,
..function(&code)
}],
);
let e = stacks(&code, &r).unwrap_err();
assert_eq!(
(e.reason, e.requested, e.limit, e.pc),
@@ -78,6 +90,7 @@ fn stack_analysis_cannot_consume_parameters_or_extra_locals_as_temporaries() {
let r = registry(
&code,
vec![FunctionDecl {
lifecycle_role: Default::default(),
local_slots: 100,
signature: Signature {
parameters: vec![NamedType { type_id: TypeId(1), name: None }],
@@ -112,8 +125,14 @@ fn stack_analysis_resolves_multislot_calls_and_registry_operations() {
let r = registry(
&code,
vec![
FunctionDecl { code_len: callee as u32, max_stack_slots: 2, ..function(&code) },
FunctionDecl {
lifecycle_role: Default::default(),
code_len: callee as u32,
max_stack_slots: 2,
..function(&code)
},
FunctionDecl {
lifecycle_role: Default::default(),
code_offset: callee as u32,
code_len: (code.len() - callee) as u32,
signature,
@@ -136,6 +155,7 @@ fn stack_analysis_checks_returns_empty_bodies_and_implicit_end_branches() {
op(&mut code, operation);
}
let f = FunctionDecl {
lifecycle_role: Default::default(),
signature: Signature { parameters: vec![], results: vec![TypeId(0)] },
..function(&code)
};
@@ -172,7 +192,14 @@ fn stack_analysis_rejects_different_join_heights_and_accepts_a_bounded_loop() {
assert_eq!(stacks(&code, &r).unwrap_err().reason, R::StackJoin);
let mut code = vec![];
arg(&mut code, Op::Jmp, 0);
let r = registry(&code, vec![FunctionDecl { max_stack_slots: 0, ..function(&code) }]);
let r = registry(
&code,
vec![FunctionDecl {
lifecycle_role: Default::default(),
max_stack_slots: 0,
..function(&code)
}],
);
assert!(stacks(&code, &r).is_ok());
}
@@ -181,7 +208,14 @@ fn stack_analysis_accounts_only_reachable_transfers_but_preflights_dead_operands
let mut code = vec![];
op(&mut code, Op::Halt);
arg(&mut code, Op::PopN, u32::MAX);
let r = registry(&code, vec![FunctionDecl { max_stack_slots: 0, ..function(&code) }]);
let r = registry(
&code,
vec![FunctionDecl {
lifecycle_role: Default::default(),
max_stack_slots: 0,
..function(&code)
}],
);
assert!(stacks(&code, &r).is_ok());
let mut code = vec![];
op(&mut code, Op::Halt);
@@ -220,7 +254,12 @@ fn stack_analysis_straight_line_storage_is_bounded_by_blocks_not_instruction_fra
op(&mut code, Op::Halt);
let r = registry(
&code,
vec![FunctionDecl { local_slots: 300, max_stack_slots: 0, ..function(&code) }],
vec![FunctionDecl {
lifecycle_role: Default::default(),
local_slots: 300,
max_stack_slots: 0,
..function(&code)
}],
);
let limits = LoadLimits { temporary_bytes: 41_000, ..Default::default() };
let mut b = LoadBudget::new(limits);
@@ -232,6 +271,7 @@ fn stack_analysis_straight_line_storage_is_bounded_by_blocks_not_instruction_fra
fn stack_analysis_accepts_unknown_fn_targets_and_rejects_removed_opcodes() {
let code = prometeu_bytecode::assemble("GET_LOCAL 0\nCALL_CLOSURE 4\nHALT").unwrap();
let f = FunctionDecl {
lifecycle_role: Default::default(),
signature: Signature {
parameters: vec![NamedType { type_id: TypeId(4), name: None }],
results: vec![],
@@ -263,12 +303,19 @@ fn expected_fn_signature_checks_argument_height_after_permutations() {
&code,
vec![
FunctionDecl {
lifecycle_role: Default::default(),
code_len: end as u32,
local_slots: 1,
max_stack_slots: 2,
..function(&code)
},
FunctionDecl { signature, code_offset: end as u32, code_len: 2, ..Default::default() },
FunctionDecl {
lifecycle_role: Default::default(),
signature,
code_offset: end as u32,
code_len: 2,
..Default::default()
},
],
);
assert_eq!(stacks(&code, &r).unwrap_err().reason, R::StackUnderflow);
@@ -309,12 +356,14 @@ fn stack_analysis_charges_work_for_loop_reprocessing_and_refunds_on_exhaustion()
&code,
vec![
FunctionDecl {
lifecycle_role: Default::default(),
code_len: end as u32,
local_slots: 1,
max_stack_slots: 1,
..function(&code)
},
FunctionDecl {
lifecycle_role: Default::default(),
code_offset: end as u32,
code_len: (code.len() - end) as u32,
max_stack_slots: 1,
@@ -353,8 +402,13 @@ fn typed_opcodes_and_relative_jumps_are_resolved_in_declared_ranges() {
let r = registry(
&code,
vec![
FunctionDecl { code_len: start as u32, ..function(&code) },
FunctionDecl {
lifecycle_role: Default::default(),
code_len: start as u32,
..function(&code)
},
FunctionDecl {
lifecycle_role: Default::default(),
code_offset: start as u32,
code_len: 6,
max_stack_slots: 0,
@@ -394,8 +448,13 @@ fn jumps_reject_cross_range_and_mid_instruction_even_when_unreachable() {
let r = registry(
&code,
vec![
FunctionDecl { code_len: 6, ..function(&code) },
FunctionDecl { code_offset: 6, code_len: 2, ..function(&code) },
FunctionDecl { lifecycle_role: Default::default(), code_len: 6, ..function(&code) },
FunctionDecl {
lifecycle_role: Default::default(),
code_offset: 6,
code_len: 2,
..function(&code)
},
],
);
let e = check(&code, &r).unwrap_err();
@@ -479,7 +538,10 @@ fn spawn_arity_does_not_truncate_and_closure_function_ids_are_checked() {
#[test]
fn declared_range_is_not_extended_into_gaps_or_neighbor_functions() {
let code = vec![Op::Halt as u8, 0, 0xff, 0xff];
let r = registry(&code, vec![FunctionDecl { code_len: 2, ..function(&code) }]);
let r = registry(
&code,
vec![FunctionDecl { lifecycle_role: Default::default(), code_len: 2, ..function(&code) }],
);
assert!(check(&code, &r).is_ok()); // Unowned gap is outside this phase's ranges.
let r = registry(&code, vec![function(&code)]);
assert_eq!(check(&code, &r).unwrap_err().reason, R::UnknownOpcode);
@@ -493,8 +555,13 @@ fn scratch_is_refunded_per_function_and_preserves_prior_load_ownership() {
let r = registry(
&code,
vec![
FunctionDecl { code_len: 2, ..function(&code) },
FunctionDecl { code_offset: 2, code_len: 2, ..function(&code) },
FunctionDecl { lifecycle_role: Default::default(), code_len: 2, ..function(&code) },
FunctionDecl {
lifecycle_role: Default::default(),
code_offset: 2,
code_len: 2,
..function(&code)
},
],
);
let limits = LoadLimits { temporary_bytes: 8, ..Default::default() };
@@ -531,8 +598,13 @@ fn truncated_immediates_cannot_borrow_bytes_from_the_next_function() {
let r = registry(
&code,
vec![
FunctionDecl { code_len: 2, ..function(&code) },
FunctionDecl { code_offset: 2, code_len: 2, ..function(&code) },
FunctionDecl { lifecycle_role: Default::default(), code_len: 2, ..function(&code) },
FunctionDecl {
lifecycle_role: Default::default(),
code_offset: 2,
code_len: 2,
..function(&code)
},
],
);
let e = check(&code, &r).unwrap_err();
@@ -32,6 +32,7 @@ fn function(
max: u32,
) -> FunctionDecl {
FunctionDecl {
lifecycle_role: Default::default(),
captures: vec![],
code_offset: offset as u32,
code_len: len as u32,