Core 契约与设计

Go 是参考实现，spec/ 是规范契约。各 Core 提供符合语言习惯的 API，但不能改变 wire 名称或声明的行为。 规范与参考实现不一致属于缺陷，不应静默分叉。

层次	要求
Wire	保留字段名称、大小写、事件类型、错误码和消息封装
行为	通过声明范围内的共享向量
API	将接口和选项映射为符合语言习惯的形式
一致性	执行向量、parity、API 检查和语言专项测试

保留 image_url、runId、plugin_id 等混合命名，不能为了本地风格统一改名。 相关定义见事件参考、wire 工件和各语言 parity 清单。

变更流程

1. 检查参考行为与规范工件。
2. 契约变更同步更新 wire 定义和向量。
3. 更新对应 parity 清单。
4. 使用 Go 参考实现验证向量。
5. 完成 Core 实现，执行一致性和 API 检查。
6. 记录支持范围、版本兼容性和限制。

不能仅为 Core 扩大 Go pkg/... API。具体适配器是可选能力，不代表所有语言都有。

兼容与安全

spec/SPEC_VERSION 与 Core 独立版本化。wire 字段、事件、流类型、插件消息或错误码 变更必须更新规范，并按对各 Core 的破坏性影响评估。参见 兼容政策、API 稳定性。

共享契约不保证所有 Core 都有 Go 的全部功能，请查看支持政策 与语言 API。Core 保持 MIT，依赖需要兼容许可，凭据与租户数据由调用方配置。 安全敏感行为必须逐语言验证。实现类型与门禁见语言支持规范。