5. Preflight 与 inflight

Endorphin 将定义准备与检查阶段称为 Preflight，将实际运行阶段称为 inflight。这两个名称同时用于区分定义的生命周期和运行时活动、实例的生命周期，不是源码关键字。

代码由平台解释执行，不要求开发者先执行独立构建步骤，也不要求将源码转换成字节码或另一种语言。Preflight 的检查与索引准备不等同于生成编译产物。

5.1 Preflight

Preflight 读取代码视图及其归属上下文，理解声明和引用，并建立关联索引，为程序执行做好准备。索引用于查找相关声明与依赖，减少实际调用时重复的解析和查找工作。

其语言职责包括：

声明函数不表示在 Preflight 中执行函数体，声明类也不表示读取业务数据；声明 agent 不启动模型循环或调用工具。导入 namespace 用于理解依赖，而不是执行其所有逻辑。

inflight 使用实际输入执行程序，产生程序可以观察到的结果。

其语言职责包括：

通信、缓存和执行组织方式可以由系统安排，但必须保持语言定义的值、类型、依赖和效果。

实际业务调用属于 inflight。Preflight 的准备与检查不执行业务调用，也不改变调用发生时应有的语义。代码加载和检查的时机可以由平台安排；对无法提前确定的依赖和结果，执行时仍须遵守相应规则。

语法错误、未定义名称和可静态判断的类型错误由 Preflight 报告。数据不存在、调用无法完成等执行情况由 inflight 表达。

静态检查通过不保证业务调用一定成功。诊断应能定位相关声明或表达式；错误处理、取消和持续结果的具体写法见规范状态。

阶段、应用角色和代码归属是不同维度：

它们不要求一一对应，也不要求位于不同进程或机器。atelier:shop.ui 的名称不会自动将其中所有代码限定在某个阶段或某类设备。

Preflight 生命周期描述一个定义从创建、检查、建立引用关系，到持续可引用、更新或退出可用范围的存续。一次检查是其中的动作；检查完成不表示定义的生命周期结束。已保存的定义可以长期存在，并供多次 inflight 执行使用。

inflight 生命周期描述实际输入参与计算后，调用、对象、agent 实例和任务从产生、使用，到完成、释放或删除的存续。暂停或被保存的运行时状态仍属于这个层次，不因暂时没有代码执行而变成定义。

函数调用结束不要求返回值同时消失。返回值可以继续被引用或保存；对象也不因创建它的调用结束而必然被回收。需要长期保留的实例、agent 记忆和任务检查点仍是 inflight 数据，其保留与删除规则需单独定义。

定义的退出、运行时实例的删除和底层内存回收是不同事件。删除定义是否影响已有调用或实例，以及不可达值何时回收，见规范状态。

传统 build time 常指构建发生的时段。这里的 Preflight 生命周期还覆盖准备后的定义存续，且不要求构建产物；不能把“定义长期存在”理解为平台一直在执行检查。

两个生命周期可以交错。agent 可以在 inflight 中编写代码，将新定义提交到获准修改的 namespace；新定义经过 Preflight 的检查和引用准备后，才能用于后续执行。

agent 的 inflight 任务
    → 编写并提交代码
    → 新定义的 Preflight 检查与准备
    → 定义成为可引用资源
    → 后续 inflight 调用

提交修改的行为属于正在运行的任务，新定义的检查属于 Preflight，新函数的执行属于下一次 inflight 调用。检查未通过的修改不能作为已就绪定义使用；版本选择、提交接口和协作冲突处理仍需独立规则。