规范与引用
以下链接列出 Sumi 文档使用的外部契约权威。它们是引用，不代表认证或背书。Sumi 只采用本地 schema、测试和架构记录明确覆盖的部分。
协议与数据契约
| 领域 | 权威来源 | 在 Sumi 文档中的用途 |
|---|---|---|
| MCP 消息、生命周期、工具和传输 | Model Context Protocol 规范 | 定义 JSON-RPC 交互，以及 Agent 宿主、MCP client 和 server 的边界。 |
| HTTP 传输行为 | MCP transport 规范 | 定义 stdio 与 Streamable HTTP 语义；Sumi 仍以 stdio 为默认。 |
| Schema 词汇 | JSON Schema Draft 2020-12 | 定义 corpus manifest 和一致性 schema 的词汇。 |
| HTTP API 描述 | OpenAPI Specification | 描述 get_openapi_spec 可选返回的 OpenAPI 文档。 |
| 规范性措辞 | RFC 2119 与 RFC 8174 | 解释项目契约中的大写 MUST、SHOULD 和 MAY。 |
Web、语言与运维
| 领域 | 权威来源 | 在 Sumi 文档中的用途 |
|---|---|---|
| 浏览器无障碍 | WCAG 2.2 | 规定面向人的文档站点的无障碍目标。 |
| TypeScript 语言 | TypeScript 文档 | 说明 Node workspace 和生成的 TypeDoc 参考使用的语言。 |
| Rust parity 线路 | Rust Reference | 只适用于未来受支持的原生实现，不改变当前 Node 契约。 |
| 运行时遥测 | OpenTelemetry 规范 与 语义约定 | 为可选的宿主或服务遥测提供词汇，不向只读 MCP 核心加入 exporter。 |
| 工作流安全 | GitHub Actions security hardening | 指导最小权限 workflow 和发布证据处理。 |
| 依赖更新 | Dependabot configuration | 定义生态发现、计划、分组与 PR 行为。 |
| 依赖审查 | GitHub dependency review | 定义用于拒绝新引入漏洞依赖的 PR 差异审查。 |
如何应用引用
外部链接不会覆盖仓库契约。提案必须指出受影响的本地 schema、实现、测试和回滚路径。 如果外部规范与项目锁定行为不一致，应先在架构决策中记录差异，再开始实现。