feat: expose workflow state events and persist signal transitions

docs/api/workflows.md

@@ -153,6 +153,8 @@ name/payload_version/target_step_key必填，分别最多128/32/64个ASCII名称
 
 ## 6. 操作审计与错误处理
 
+[状态事件时间线](workflow-events.md)另提供流程、步骤和信号的不可变状态变化，以及原事件元数据；同样要求显式审计权限。此处操作审计保留管理决定的操作人、原因、证据及前后摘要，两类记录通过已保存的身份关联，不将当前资源状态反填为历史。
+
 ListWorkflowOperations接受HistoryPageRequest：limit默认20、范围1–100；cursor最大1024字节，绑定命名空间、流程ID和查询种类，不可跨资源复用。data为 `{items, next_cursor?}`；每项含 id、workflow_id、operation_id、actor_id、action、created_at，按时间及ID倒序。GetWorkflowOperation除这些字段外还返回reason、evidence_ref（可空省略）、before、after JSON摘要。单独读取正文，避免列表聚合大结果。
 
 该接口当前查询resource_kind=workflow的启动、推进、控制和恢复审计；独立任务核查审计通过恢复回执的task_audit_id关联。信号自身的受理状态通过GetWorkflowSignal读取；[信号资源审计及历史激活查询](workflow-history.md)使用独立路由，统一状态事件时间线仍待核对交付。