Struct ExecutionShell 

pub struct ExecutionShell { /* private fields */ }

sans-IO 确定性执行壳。

使用方式（三端通用）

let mut shell = ExecutionShell::new();
shell.register(ImModule::new(config));
shell.start()?;

// 事件泵（由 driver 的 engine_loop.rs 驱动）
let effects = shell.step(Tick::Inbound(bytes), now_ms)?;
// driver 兑现 effects，把结果包成下一个 Tick 喂回

Implementations

impl ExecutionShell

pub fn new() -> Self

pub fn register(&mut self, m: impl Module + 'static)

注册业务模块（加模块不改此函数，开闭原则）

pub fn start(&mut self) -> Result<&[Effect], CoreError>

启动所有已注册模块（调用 on_start），返回初始 Effect 列表。

driver 在创建完 ExecutionShell 并注册所有模块后调用一次。

BLK-1a 修复

逐模块调用 on_start 并立即 register_effects_to_maps(idx)， 确保每个模块的 Correlation/TimerId 注册到正确的 module_index。

pub fn stop(&mut self) -> Result<&[Effect], CoreError>

停止所有已注册模块（调用 on_stop），返回清理 Effect 列表。

pub fn step(&mut self, tick: Tick, now_ms: u64) -> Result<&[Effect], CoreError>

核心方法：处理一个 Tick，返回本次 step 产出的 Effect 切片。

返回值生命周期

返回 &[Effect] 借用 self.scratch，在下一次 step() 调用前有效。 driver 必须在下一次 step() 之前消费完（或 clone）这些 Effect。

路由策略

• Inbound / Command：线性扫描 accepts()
• PortReply：corr_map O(1) 定向投递并消费
• PortProgress：corr_map O(1) 定向投递但不消费
• Timer：timer_map O(1) 定向投递

BLK-1a 修复

dispatch_inbound 返回的 Some(idx) 现在被正确传入 register_effects_to_maps， 替换了原来的 let module_index = 0usize; // placeholder 占位符。 这确保多模块场景中，Correlation/TimerId 被注册到正确的 module_index， 而不是错误地路由到 module[0]。

Trait Implementations

impl Default for ExecutionShell

fn default() -> Self

Returns the “default value” for a type.