智能体检查点信封整理

适用场景

把长流程检查点整理成可核验的快照信封，保留状态、父子关系、待处理消息和请求引用。

输入与输出

输入：脱敏 checkpoints 数组，含 checkpointid、runid、superstep、parentid、stateref、待处理消息/请求、state_hash。 输出：agent-checkpoint-envelope.json，含规范化检查点、发现项和 envelope_hash。

安装与执行

1. 1. 使用 Python 3.10 或更高版本，无第三方依赖。
2. 运行 scripts/normalize_checkpoint_envelope.py，按 docs/usage.md 传入参数。
3. 检查 status、findings、哈希和 externalactionexecuted。

执行规则

缺少 ID、运行标识、步骤号、状态引用或状态哈希时进入 REVIEW，不修补原始状态。

错误恢复

JSON 无法解析、字段缺失、步骤跳跃或父链断裂时保留发现项并进入 REVIEW；不要默默修复原始检查点。

权限与隐私边界

只读脱敏 JSON，不连接运行时、数据库、队列或网络，不保存密码、Cookie、Token 或真实客户记录。

验收方式

使用 examples 中的脱敏样例运行，确认输出字段、阻断原因和 externalactionexecuted=false。