feat: expose workflow state events and persist signal transitions

docs/07-data-model.md

@@ -237,3 +237,11 @@ PollState新增FirstRound和FirstRoundAttemptsUsed，记录当前激活的首个
 VersionScope新增6个中文注释字段：命名空间、定义版本、定义、原摘要、去重队列JSON、索引创建时间；当前36个实体、311个直接持久化字段声明，全部有中文注释。版本范围不可更新，发布与范围同事务，读取摘要还要核验原定义和关联，不以派生索引授予权限。回填仅遍历DSL步骤，忽略常量中相同字段；旧版本及实例原文不修改。
 
 7个新实例复合索引加现有业务键索引覆盖定义/业务键/状态8种组合，按创建时间与ID分页；全部保留无外键和无级联。范围校验、迁移性能边界和接口见[查询手册](api/workflow-queries.md)。
+
+## 流程事件派生索引（000025）
+
+Event.WorkflowID为只读STORED生成列，从原不可变事件派生流程归属，非流程或非法标识为空；应用不得独立写入，也不能将它作为授权依据。索引为(namespace_id,workflow_id,occurred_at,id)。历史原文不变，不补造过去缺失的信号转换；当前36个模型、312个直接持久化字段均有中文注释，无外键及级联。
+
+新运行器将PENDING信号的消费、拒绝或过期与原状态事件同事务保存，批量拒绝分32条追加但整笔事务原子提交。公开查询核对固定版本全部队列、步骤/信号归属及历史激活。原始事件按数据库记录时间分页，版本与时间均不构成可靠消费水位。详见[状态时间线接口](api/workflow-events.md)与[验证报告](reports/phase-5-events.md)。
+
+升级先停止旧写入节点，应用000025再启新版本，防止混合节点继续遗漏信号转换；生成列和索引涉及历史行扫描与可能的表重建，需预演维护窗口、磁盘和锁等待。严格SQL模式下先校验十六进制字符再转换，异常历史范围保留NULL，不清理原记录。