API 与通信协议标准

对外 API、Runtime 协议和事件合同必须分别说明身份、版本、输入、输出、错误、幂等、权限、超时和兼容策略。

• HTTP 或 typed API 使用 API；非 HTTP 会话或应用协议使用 PROT；消息使用 EVT；载荷使用 SCH。
• 不允许以示例代替封闭枚举或失败语义。
• 重放、重试和幂等键必须明确到操作，不使用“最近一次”等歧义别名。
• 破坏性变更必须提升合同版本并提供明确迁移或 clean-break 说明。
• 每个活动 API、PROT 和 SCH 资产必须通过 verified_by 连接正式契约或集成测试。