From 05c155006db208a9678068b7371db399fdd401e2 Mon Sep 17 00:00:00 2001 From: Loong Wan Date: Sun, 20 Sep 2026 22:22:25 +0800 Subject: [PATCH 01/22] docs(openspec): add OpenClaw integration specifications and roadmap Add six draft changes, 21 capability specifications, 64 requirements, 128 scenarios, and 97 unchecked implementation tasks. Include source baselines, roadmap, acceptance plan, traceability and losslessly packaged document-validation evidence. Preserve existing SDK sources, tests, build files, and root READMEs. Documentation only: no implementation approval, official OpenSpec CLI validation, SDK builds, or live Gateway tests are claimed. --- docs/openclaw-integration/README.md | 32 +++++ docs/openclaw-integration/acceptance-plan.md | 70 +++++++++ docs/openclaw-integration/baseline.json | 122 ++++++++++++++++ .../openclaw-integration/coverage-baseline.md | 39 +++++ .../package-manifest.json | 1 + docs/openclaw-integration/roadmap.md | 53 +++++++ docs/openclaw-integration/source-register.md | 60 ++++++++ .../openclaw-integration/traceability.json.gz | Bin 0 -> 3246 bytes docs/openclaw-integration/traceability.md | 134 ++++++++++++++++++ .../validation-report/README.md | 22 +++ .../validation-report/part-001.b64 | 1 + .../validation-report/part-002.b64 | 1 + .../validation-report/part-003.b64 | 1 + .../validation-summary.md | 32 +++++ openspec/README.md | 7 + .../.openspec.yaml | 2 + .../design.md | 55 +++++++ .../proposal.md | 39 +++++ .../specs/agent-lifecycle/spec.md | 52 +++++++ .../specs/approval-control/spec.md | 52 +++++++ .../specs/session-control/spec.md | 52 +++++++ .../tasks.md | 32 +++++ .../add-gateway-operations/.openspec.yaml | 2 + .../changes/add-gateway-operations/design.md | 61 ++++++++ .../add-gateway-operations/proposal.md | 45 ++++++ .../specs/channel-node-control/spec.md | 52 +++++++ .../specs/configuration-control/spec.md | 52 +++++++ .../specs/cron-control/spec.md | 52 +++++++ .../specs/skill-plugin-lifecycle/spec.md | 52 +++++++ .../specs/task-audit-artifacts/spec.md | 52 +++++++ .../specs/tool-model-catalogs/spec.md | 52 +++++++ .../changes/add-gateway-operations/tasks.md | 50 +++++++ .../add-managed-gateway-client/.openspec.yaml | 2 + .../add-managed-gateway-client/design.md | 59 ++++++++ .../add-managed-gateway-client/proposal.md | 39 +++++ .../specs/gateway-recovery/spec.md | 52 +++++++ .../specs/managed-rpc/spec.md | 52 +++++++ .../specs/typed-event-delivery/spec.md | 52 +++++++ .../add-managed-gateway-client/tasks.md | 32 +++++ .../.openspec.yaml | 2 + .../add-optional-runtime-adapters/design.md | 57 ++++++++ .../add-optional-runtime-adapters/proposal.md | 39 +++++ .../specs/cli-typed-results/spec.md | 52 +++++++ .../specs/persistent-stdio-adapters/spec.md | 52 +++++++ .../specs/terminal-voice-adapters/spec.md | 52 +++++++ .../add-optional-runtime-adapters/tasks.md | 32 +++++ .../.openspec.yaml | 2 + .../design.md | 54 +++++++ .../proposal.md | 35 +++++ .../sdk-compatibility-governance/spec.md | 65 +++++++++ .../tasks.md | 24 ++++ .../.openspec.yaml | 2 + .../fix-openclaw-protocol-contracts/design.md | 65 +++++++++ .../proposal.md | 45 ++++++ .../specs/gateway-chat-events/spec.md | 52 +++++++ .../specs/gateway-device-auth/spec.md | 52 +++++++ .../specs/responses-streaming/spec.md | 52 +++++++ .../specs/session-history-contract/spec.md | 52 +++++++ .../specs/tools-invoke-contract/spec.md | 52 +++++++ .../fix-openclaw-protocol-contracts/tasks.md | 44 ++++++ openspec/config.yaml | 24 ++++ openspec/specs/.gitkeep | 1 + 62 files changed, 2524 insertions(+) create mode 100644 docs/openclaw-integration/README.md create mode 100644 docs/openclaw-integration/acceptance-plan.md create mode 100644 docs/openclaw-integration/baseline.json create mode 100644 docs/openclaw-integration/coverage-baseline.md create mode 100644 docs/openclaw-integration/package-manifest.json create mode 100644 docs/openclaw-integration/roadmap.md create mode 100644 docs/openclaw-integration/source-register.md create mode 100644 docs/openclaw-integration/traceability.json.gz create mode 100644 docs/openclaw-integration/traceability.md create mode 100644 docs/openclaw-integration/validation-report/README.md create mode 100644 docs/openclaw-integration/validation-report/part-001.b64 create mode 100644 docs/openclaw-integration/validation-report/part-002.b64 create mode 100644 docs/openclaw-integration/validation-report/part-003.b64 create mode 100644 docs/openclaw-integration/validation-summary.md create mode 100644 openspec/README.md create mode 100644 openspec/changes/add-agent-session-approval-control/.openspec.yaml create mode 100644 openspec/changes/add-agent-session-approval-control/design.md create mode 100644 openspec/changes/add-agent-session-approval-control/proposal.md create mode 100644 openspec/changes/add-agent-session-approval-control/specs/agent-lifecycle/spec.md create mode 100644 openspec/changes/add-agent-session-approval-control/specs/approval-control/spec.md create mode 100644 openspec/changes/add-agent-session-approval-control/specs/session-control/spec.md create mode 100644 openspec/changes/add-agent-session-approval-control/tasks.md create mode 100644 openspec/changes/add-gateway-operations/.openspec.yaml create mode 100644 openspec/changes/add-gateway-operations/design.md create mode 100644 openspec/changes/add-gateway-operations/proposal.md create mode 100644 openspec/changes/add-gateway-operations/specs/channel-node-control/spec.md create mode 100644 openspec/changes/add-gateway-operations/specs/configuration-control/spec.md create mode 100644 openspec/changes/add-gateway-operations/specs/cron-control/spec.md create mode 100644 openspec/changes/add-gateway-operations/specs/skill-plugin-lifecycle/spec.md create mode 100644 openspec/changes/add-gateway-operations/specs/task-audit-artifacts/spec.md create mode 100644 openspec/changes/add-gateway-operations/specs/tool-model-catalogs/spec.md create mode 100644 openspec/changes/add-gateway-operations/tasks.md create mode 100644 openspec/changes/add-managed-gateway-client/.openspec.yaml create mode 100644 openspec/changes/add-managed-gateway-client/design.md create mode 100644 openspec/changes/add-managed-gateway-client/proposal.md create mode 100644 openspec/changes/add-managed-gateway-client/specs/gateway-recovery/spec.md create mode 100644 openspec/changes/add-managed-gateway-client/specs/managed-rpc/spec.md create mode 100644 openspec/changes/add-managed-gateway-client/specs/typed-event-delivery/spec.md create mode 100644 openspec/changes/add-managed-gateway-client/tasks.md create mode 100644 openspec/changes/add-optional-runtime-adapters/.openspec.yaml create mode 100644 openspec/changes/add-optional-runtime-adapters/design.md create mode 100644 openspec/changes/add-optional-runtime-adapters/proposal.md create mode 100644 openspec/changes/add-optional-runtime-adapters/specs/cli-typed-results/spec.md create mode 100644 openspec/changes/add-optional-runtime-adapters/specs/persistent-stdio-adapters/spec.md create mode 100644 openspec/changes/add-optional-runtime-adapters/specs/terminal-voice-adapters/spec.md create mode 100644 openspec/changes/add-optional-runtime-adapters/tasks.md create mode 100644 openspec/changes/establish-sdk-compatibility-governance/.openspec.yaml create mode 100644 openspec/changes/establish-sdk-compatibility-governance/design.md create mode 100644 openspec/changes/establish-sdk-compatibility-governance/proposal.md create mode 100644 openspec/changes/establish-sdk-compatibility-governance/specs/sdk-compatibility-governance/spec.md create mode 100644 openspec/changes/establish-sdk-compatibility-governance/tasks.md create mode 100644 openspec/changes/fix-openclaw-protocol-contracts/.openspec.yaml create mode 100644 openspec/changes/fix-openclaw-protocol-contracts/design.md create mode 100644 openspec/changes/fix-openclaw-protocol-contracts/proposal.md create mode 100644 openspec/changes/fix-openclaw-protocol-contracts/specs/gateway-chat-events/spec.md create mode 100644 openspec/changes/fix-openclaw-protocol-contracts/specs/gateway-device-auth/spec.md create mode 100644 openspec/changes/fix-openclaw-protocol-contracts/specs/responses-streaming/spec.md create mode 100644 openspec/changes/fix-openclaw-protocol-contracts/specs/session-history-contract/spec.md create mode 100644 openspec/changes/fix-openclaw-protocol-contracts/specs/tools-invoke-contract/spec.md create mode 100644 openspec/changes/fix-openclaw-protocol-contracts/tasks.md create mode 100644 openspec/config.yaml create mode 100644 openspec/specs/.gitkeep diff --git a/docs/openclaw-integration/README.md b/docs/openclaw-integration/README.md new file mode 100644 index 0000000..4f2e7e2 --- /dev/null +++ b/docs/openclaw-integration/README.md @@ -0,0 +1,32 @@ +# openclaw-java-sdk · OpenSpec 文档包 + +版本 0.1.0-draft · 2026-09-20 · **待评审,未实施,未归档** + +这是一套仓库内的 OpenSpec 变更草案,不是仅供讨论的差距清单。包含六组 proposal/design/tasks、21 个 capability spec、64 条 Requirement 和 128 个 Scenario;实施任务共 97 项,全部未执行;检查结果见 [文档检查结果](validation-summary.md)。 + +## 阅读顺序 + +1. [总体路线与依赖](roadmap.md)。 +2. [当前覆盖与风险基线](coverage-baseline.md)及[来源登记](source-register.md)。 +3. `openspec/changes//proposal.md` → `specs/*/spec.md` → `design.md` → `tasks.md`。 +4. [验收计划](acceptance-plan.md)及[逐场景追踪表](traceability.md)。 + +## 交付边界 + +本目录及 openspec/ 以独立文档提交交付;没有修改任何 SDK Java 源码、pom、依赖或现有测试,也没有写入维护者的本机工作区。所有实施任务保持未勾选,人审批准和具体目标 Gateway 版本锁定仍是下一阶段前提。 + +官方 OpenSpec CLI 在当前环境不可用,尝试获取时因 DNS/网络解析失败而未能安装。因此只报告实际完成的自定义文档结构检查,不声称执行过官方 validate。也没有执行 codegraph、Maven 或真实 Gateway 测试。 + +## 合入方式 + +`openspec/` 和 `docs/openclaw-integration/` 按仓库相对路径组织。先在文档专用分支审查再合入;如果目标分支后来已有同名规范或目录,需合并而不是覆盖。本文是迁入文档目录后的交付索引,不覆盖原仓库 README。 + +本轮没有创建任何生效 capability spec;`openspec/specs/` 只有占位文件。待变更实现、验收和人审完成后,再按项目流程归档。根目录 `openspec/config.yaml` 定义 spec-driven 模式和项目规则。 + +## 快速核对 + +查看 `docs/openclaw-integration/baseline.json` 确认 SDK 提交及明确未验证的上游版本。参照 acceptance-plan 中的命令使用官方 OpenSpec CLI 校验;切勿把 artifact 已齐全或状态命令的 isComplete 字段解释为产品实现完成。 + +## 发布打包说明 + +原始文档包的 traceability.json 使用 gzip 保存为 .json.gz;validation-report.json 使用 gzip + Base64 分段保存在 [validation-report/](validation-report/README.md),该目录说明如何恢复原始 JSON。解压后的内容与原包逐字节一致;Markdown 追踪表与检查摘要保留直接可读版本。仓库路径与文件校验值见 [package-manifest.json](package-manifest.json)。此打包调整不改变任何 Requirement、Scenario 或实施任务。 diff --git a/docs/openclaw-integration/acceptance-plan.md b/docs/openclaw-integration/acceptance-plan.md new file mode 100644 index 0000000..97ef840 --- /dev/null +++ b/docs/openclaw-integration/acceptance-plan.md @@ -0,0 +1,70 @@ +# 验收计划与证据模板 + +本文件定义未来验收要求,不记录已通过的产品测试。本轮仅执行文档内部检查。 + +## 1. 验证层级 + +| 层级 | 内容 | 可支持的结论 | +|---|---|---| +| L0 文档结构 | 四类产物、格式、ID、来源、依赖、任务引用 | 文档内部一致;不证明产品行为 | +| L1 契约样本 | 固定版本的请求/响应/事件黄金样本 | 序列化、解析与本地状态规则 | +| L2 模拟故障 | MockWebServer、受控 WS 端点、虚拟时钟、测试子进程 | 并发、顺序、关闭和错误路径 | +| L3 分支构建 | JDK 8、17、21 对应分支和真实依赖源 | 各自构建及实际执行的测试结果 | +| L4 真实集成 | 固定版本 Gateway、受控账户/工作目录、明确授权 | 指定版本、场景、权限配置的真实兼容 | +| L5 发布审查 | API、依赖、扫描、许可证、资源与文档 | 有边界的发布准入,不是绝对无漏洞保证 | + +L1/L2 的模拟成功不能替代 L4。静态找不到关闭路径可以作为风险线索,但不自动断言已经证明堆泄漏。 + +## 2. 最低核心场景 + +Responses:JSON 入口误用流式、多个输出项、工具参数增量、空工具输出续接、completed/incomplete/failed、EOF、取消、格式错误。WS:追加、替换、快照对账、未知 runId、双流交错、终态重复、会话 reset 后旧事件。认证:challenge/计时器竞争、有/无 deviceToken、可信与不可信引导、轮换、scope 拒绝。恢复:断线前后写入结果未知、订阅/快照交错、错误回调、资源释放、用户关闭后零重连。 + +控制面:agent 受理与 pending 等待、远端取消未确认、并发审批已决、配置 hash 冲突、保存/应用分离、Cron 按准确 runId 查询。运营面:目录不等于权限、工具业务 ok=false、扩展发布部分成功、目标账户隔离、Node 执行状态未知、用量缺省、产物下载过期与跨域。可选适配:终端附着不重跑、语音输出取消、MCP/ACP 初始化、双向管道、stderr 分离、进程退出、CLI JSON 模式和 Windows/POSIX 参数。 + +## 3. 资源检查的可测口径 + +在受控环境执行 1000 次请求/订阅生命周期(成功、失败、取消、超时各不少于 200 次,其余用于断线和回调错误)。每轮结束后等待有界清理预算(测试基线建议 5 秒,若需调整必须记录理由),确认 pending 请求、活动订阅和定时任务注册归零;关闭后自有 executor 终止、HTTP ResponseBody 关闭,共享连接仍可供第二客户端使用。 + +这不是对堆大小强行断言恒定。若出现持续增长,应采集堆转储、线程转储、对象引用与文件描述符证据,并在稳定负载和 GC 条件下定位。不得通过关掉断言或增大无限队列来“修复”检查。 + +## 4. 安全与错误语义 + +必须确认:不以 dryRun 当作无副作用;不以共享 Gateway Token 的 scope 头当作租户隔离;不自动批准;不自动读取宿主凭据或降级权限;不记录 Token、签名、短期下载地址或原始敏感业务内容。取消/等待超时/结果不确定/远端失败分开;工具、配置、插件等分阶段结果不被压成一个布尔成功。 + +真实写操作测试只能在获准的隔离环境运行,使用临时命名空间和明确清理步骤。文档任务不会授权访问真实客户、发送业务消息或修改生产配置。 + +## 5. 证据记录字段 + +```yaml +change_id: fix-openclaw-protocol-contracts +requirement_id: CHAT-01 +scenario_id: CHAT-01-S1 +branch: feature/2.0.x +sdk_commit: null +openclaw_version: null +openclaw_commit: null +protocol_version: null +jdk_version: null +maven_version: null +auth_mode: null +test_command: null +executed_tests: 0 +result: NOT_RUN +evidence_path: null +known_limitations: [] +``` + +null 明确表示尚未运行,不得提交为 PASS。PASS 记录须填精确值;缺环境填 BLOCKED,未跑填 NOT_RUN,失败填 FAIL。测试基线版本改变需要重新执行。 + +## 6. 官方 OpenSpec 校验命令(待实际运行) + +先在可联网、受信任环境安装并记录官方 OpenSpec 的确定版本,再从仓库根目录运行: + +```bash +openspec --version +openspec list --json +openspec validate --all --strict --no-interactive --json +openspec status --change fix-openclaw-protocol-contracts --json +``` + +不使用 latest 作为可复现 CI 的版本锁。不在本轮执行 apply、archive 或产品代码生成。官方 CLI 结构通过也不等于 128 个产品验收场景已经执行。 diff --git a/docs/openclaw-integration/baseline.json b/docs/openclaw-integration/baseline.json new file mode 100644 index 0000000..2bdaea1 --- /dev/null +++ b/docs/openclaw-integration/baseline.json @@ -0,0 +1,122 @@ +{ + "documentVersion": "0.1.0-draft", + "date": "2026-09-20", + "repository": "easy-4-java/openclaw-java-sdk", + "sdkBaseline": { + "feature/1.0.x": "8cfbeb880a6c6ae5390fab0f9fe65e06938907be", + "feature/2.0.x": "48309d7bc34c4298cdfa1c52db06114b2e7e9f17", + "feature/3.0.x": "3687fcb09e75ec4c2ecb522877e9a27c1f1955aa", + "main": "c4ddcd3fa86d8fb5352b722813268760c35636b2" + }, + "upstream": { + "documentationBasis": "live-official-documentation", + "documentationObservedDate": "2026-09-20", + "documentedProtocol": "v4", + "testedGatewayVersion": null, + "testedGatewayCommit": null, + "pinStatus": "BLOCKED_VERSION_PIN", + "rawPageSnapshotArchived": false + }, + "verification": { + "sourceReview": "static-review-only", + "codegraphExecuted": false, + "sdkBuildExecuted": false, + "liveGatewayTestsExecuted": false, + "officialOpenSpecValidationExecuted": false, + "structuralValidation": "see validation-report.json" + }, + "approval": { + "state": "DRAFT", + "implementationAuthorized": false, + "archiveAuthorized": false + }, + "delivery": { + "createdIn": "conversation-sandbox", + "githubCommitted": false, + "userMachineModified": false + }, + "changes": [ + { + "id": "establish-sdk-compatibility-governance", + "priority": "P0", + "dependsOn": [], + "state": "DRAFT", + "capabilities": [ + "sdk-compatibility-governance" + ] + }, + { + "id": "fix-openclaw-protocol-contracts", + "priority": "P0", + "dependsOn": [ + "establish-sdk-compatibility-governance" + ], + "state": "DRAFT", + "capabilities": [ + "responses-streaming", + "gateway-chat-events", + "gateway-device-auth", + "session-history-contract", + "tools-invoke-contract" + ] + }, + { + "id": "add-managed-gateway-client", + "priority": "P0", + "dependsOn": [ + "establish-sdk-compatibility-governance", + "fix-openclaw-protocol-contracts" + ], + "state": "DRAFT", + "capabilities": [ + "managed-rpc", + "gateway-recovery", + "typed-event-delivery" + ] + }, + { + "id": "add-agent-session-approval-control", + "priority": "P1", + "dependsOn": [ + "add-managed-gateway-client" + ], + "state": "DRAFT", + "capabilities": [ + "agent-lifecycle", + "session-control", + "approval-control" + ] + }, + { + "id": "add-gateway-operations", + "priority": "P1/P2", + "dependsOn": [ + "add-managed-gateway-client", + "add-agent-session-approval-control" + ], + "state": "DRAFT", + "capabilities": [ + "configuration-control", + "cron-control", + "tool-model-catalogs", + "skill-plugin-lifecycle", + "channel-node-control", + "task-audit-artifacts" + ] + }, + { + "id": "add-optional-runtime-adapters", + "priority": "P2", + "dependsOn": [ + "add-managed-gateway-client", + "add-agent-session-approval-control" + ], + "state": "DRAFT", + "capabilities": [ + "terminal-voice-adapters", + "persistent-stdio-adapters", + "cli-typed-results" + ] + } + ] +} diff --git a/docs/openclaw-integration/coverage-baseline.md b/docs/openclaw-integration/coverage-baseline.md new file mode 100644 index 0000000..1a17eac --- /dev/null +++ b/docs/openclaw-integration/coverage-baseline.md @@ -0,0 +1,39 @@ +# 官方能力与 SDK 静态覆盖基线 + +状态:静态观察,不是验收报告。完整来源见 [source-register](source-register.md)。 + +## 证据等级 + +`PARTIAL_STATIC` 表示已读代码存在相关实现但契约不完整;`CLI_ONLY_IN_REVIEWED_SURFACE` 表示已有 CLI 而本次检查的公共 WS 面未见对应类型化实现;`NOT_WRAPPED_IN_REVIEWED_SURFACE` 不等于全仓库永远无法间接调用;`VERIFY_SCOPE` 需要进一步逐版本核实。所有条目的真实集成状态均为 NOT_RUN。 + +| 能力 | 静态状态 | 观察边界 | 源码 | 对应规范 | +|---|---|---|---|---| +| Responses JSON / SSE | PARTIAL_STATIC | 普通 Responses 路径传递 stream 字段后仍按 JSON 解析;Chat SSE 入口不能证明 Responses SSE 已实现。 | C01,C08 | `responses-streaming` | +| Chat replace 与运行关联 | PARTIAL_STATIC | 所读 handler 追加文本,未知 runId 有活动流回退;属于静态风险,未运行复现。 | C02 | `gateway-chat-events` | +| 设备握手结果 | PARTIAL_STATIC | 此前所读 HelloOk 未完整接收设备 Token 和快照,输入配置不等于认证闭环。 | C03 | `gateway-device-auth` | +| 历史与分页恢复 | PARTIAL_STATIC | 已有历史查询,恢复和分页元数据需要补齐;不宣称当前完全不能查历史。 | C04 | `session-history-contract` | +| Tools Invoke | PARTIAL_STATIC | 已有请求和执行面;字段、dryRun 说明及安全语义需要修正。 | C05 | `tools-invoke-contract` | +| 公共受管理 RPC | NOT_WRAPPED_IN_REVIEWED_SURFACE | 现有通用请求管理为 private;底层可发原始帧不是公共受管理 API。 | C02 | `managed-rpc` | +| 自动连接恢复 | PARTIAL_STATIC | 已有连接与断线清理;尚未形成本文定义的恢复、对账和重放策略。 | C02 | `gateway-recovery` | +| 类型化事件 | PARTIAL_STATIC | 原始事件 listener 已有;不能把没有类型化 DTO 写成所有事件收不到。 | C02 | `typed-event-delivery` | +| Agent 生命周期 | CLI_OR_PARTIAL_STATIC | 有 Agent CLI、聊天和身份查询;缺本文定义的原生运行闭环。 | C02,C06 | `agent-lifecycle` | +| Session 控制 | CLI_OR_PARTIAL_STATIC | 有 list/send 与聊天 history/abort,其他控制与订阅需补齐。 | C02,C06 | `session-control` | +| Approval 闭环 | CLI_ONLY_IN_REVIEWED_SURFACE | 有审批 CLI;所读 WS 公共业务方法没有专用审批客户端。 | C02,C06 | `approval-control` | +| Config / Secrets | CLI_OR_PARTIAL_STATIC | 有 config.get 与 CLI;写入冲突和运行时生效契约需补齐。 | C02,C06 | `configuration-control` | +| Cron | CLI_OR_PARTIAL_STATIC | 有 cron.list 与 CLI;手动排队与准确 runId 跟踪需补齐。 | C02,C06 | `cron-control` | +| Tools / Models 目录 | CLI_OR_PARTIAL_STATIC | 已有部分 HTTP/CLI;WS 目录、有效权限和业务结果需专门封装。 | C02,C06 | `tool-model-catalogs` | +| Skills / Plugins | CLI_ONLY_IN_REVIEWED_SURFACE | 有 CLI;远程原生领域客户端和运行时阶段反馈未见于所读公共 WS 面。 | C02,C06 | `skill-plugin-lifecycle` | +| Channels / Devices / Nodes | CLI_ONLY_IN_REVIEWED_SURFACE | 有相关 CLI 和握手字段;不是完整远程控制和 node 执行闭环。 | C02,C06 | `channel-node-control` | +| Tasks / Audit / Usage / Artifacts | VERIFY_SCOPE | 部分有 CLI,本文定义的台账查询、用量与产物下载需逐版本核实。 | C02,C06 | `task-audit-artifacts` | +| Terminal / Talk / TTS | VERIFY_SCOPE | Terminal CLI 不等于交互终端客户端;语音协议要独立验证。 | C06,C07 | `terminal-voice-adapters` | +| MCP / ACP | CLI_ONLY_IN_REVIEWED_SURFACE | 已有启动命令,但一次性 executor 不等于持久双向协议适配。 | C06,C07 | `persistent-stdio-adapters` | +| Browser / Infer / CLI DTO | PARTIAL_STATIC | 已有自由参数入口;缺机器输出版本契约和精确支持等级。 | C06,C07 | `cli-typed-results` | +| 三分支发布证据 | VERIFY_SCOPE | 先前类数量和 blob 对比不等于行为或运行兼容证明。 | SDK HEAD | `sdk-compatibility-governance` | + +## 不能沿用的推断 + +有 stream 字段不等于完成 SSE;存在 idempotencyKey 不等于恰好一次;HTTP 的共享 Token 加窄 scope 头不等于租户隔离;协议常量为 4 不等于完整支持所有 v4 事件;CLI 命令存在不等于原生协议或稳定机器输出。依据分别见 O03、O07、O02、O04 与 C06/C07。 + +## 现有行为与新规范的关系 + +本包未建立“已实现全功能”的根规范。全部拟实现契约放在 changes 下,修正既有代码的规范也是首次建档的 ADDED Requirements。后续如已存在同名生效规范,合并本包时必须改用匹配原规范的 MODIFIED 完整条目,不能直接覆盖或重复新增。 diff --git a/docs/openclaw-integration/package-manifest.json b/docs/openclaw-integration/package-manifest.json new file mode 100644 index 0000000..b6070a1 --- /dev/null +++ b/docs/openclaw-integration/package-manifest.json @@ -0,0 +1 @@ +{"scope":"repository documentation; paths relative to repository root; manifest excludes itself","source_package":"openclaw-java-sdk-openspec-draft-2026-09-20.zip","source_package_sha256":"f8eedbb0356b34ecde22584b57fdc9d375fa7409c36d6931b7faca36f4919468","files":{"docs/openclaw-integration/README.md":{"bytes":2635,"sha256":"2f795ec91ed8a83bd22907a2e334bd3ac3ad8a079b25c43b57ceff8251fb245b"},"docs/openclaw-integration/acceptance-plan.md":{"bytes":4591,"sha256":"4875a07fd14cd9771d610d221ab8e666bf2801341b3ccc21302627f06fa2089f"},"docs/openclaw-integration/baseline.json":{"bytes":3221,"sha256":"b5b13dd410d068a5b07b4c27be01658aa94bb626dce9beffc44ebce9565789ab"},"docs/openclaw-integration/coverage-baseline.md":{"bytes":4792,"sha256":"ae4b7783b718a268c697fdd85f1f24800f838cb1063ae90e4324c224efc7f820"},"docs/openclaw-integration/roadmap.md":{"bytes":3477,"sha256":"0348da728fc714498cab3f5796eabd38c45efd7d0df158db3fea34a508b2dd32"},"docs/openclaw-integration/source-register.md":{"bytes":5424,"sha256":"992bf67dd8da00cccaeaf4a93ed594b2877d832ed3015b402c3a4eabb0b523f0"},"docs/openclaw-integration/traceability.json.gz":{"bytes":3246,"sha256":"75386731e6f4b685d61a8c582e18edbdc86577e717039716c1c908f8422befcd","decompressed_sha256":"da585354d01fb0f687d764840f7512259de832896db051fe450ac667fd6bf6bb"},"docs/openclaw-integration/traceability.md":{"bytes":13478,"sha256":"cd1b647ab538953e299a1964e009fbb65b4212654dab678bfb05e4fd1bcd2a59"},"docs/openclaw-integration/validation-report/README.md":{"bytes":1113,"sha256":"b67e0eb4a969e742b6e30e35883dcac0c3cc15aca0005e6d66377b99995e2932"},"docs/openclaw-integration/validation-report/part-001.b64":{"bytes":2601,"sha256":"9570f3b3818b997c948cb9ee4a5c4885d664cacdfec18e0b3d1e9858ae695a32"},"docs/openclaw-integration/validation-report/part-002.b64":{"bytes":2601,"sha256":"d57ebdd3717bab8648f4f98a70430515d0750ebb38cd72a970e246ddeb049952"},"docs/openclaw-integration/validation-report/part-003.b64":{"bytes":2537,"sha256":"61a7c754d543e645ad6b705add8f183ac0e6605340f0993b9bc5cb4647fef85b"},"docs/openclaw-integration/validation-summary.md":{"bytes":1794,"sha256":"c91cc48304a3318a337ff7881d05caa1b699b252105984e6fbfb05c8fdf2f6b4"},"openspec/README.md":{"bytes":611,"sha256":"58a1b2615971f2c7fb56f069006b8559cf5cf1548c01b29c83758c894ec79f20"},"openspec/changes/add-agent-session-approval-control/.openspec.yaml":{"bytes":40,"sha256":"dc10040214104474c4e34e5b38359540c882aa7cfb6e7221e5d0614f1dba8fd7"},"openspec/changes/add-agent-session-approval-control/design.md":{"bytes":4797,"sha256":"95794f1f71841a3d6a5ca61d10bbffaf5be029f8284cf75ac4b6020e4564d3d1"},"openspec/changes/add-agent-session-approval-control/proposal.md":{"bytes":1936,"sha256":"da5665faa52a3e14e756e021e2b9dec56c5f6bb5d73af277e756050a4399c741"},"openspec/changes/add-agent-session-approval-control/specs/agent-lifecycle/spec.md":{"bytes":2664,"sha256":"0b12b0240d1a5d37bcaa8c69604ca53ca67c4a372440262d14ed01b0ffd1a174"},"openspec/changes/add-agent-session-approval-control/specs/approval-control/spec.md":{"bytes":2549,"sha256":"3b979ba5b34b8aa1e1fef3a216e663b5b194b7bce713092d73cc4eed83f0c09b"},"openspec/changes/add-agent-session-approval-control/specs/session-control/spec.md":{"bytes":2543,"sha256":"ecf939250f43f526c1d78a5a2bc2902e5889cf13474a7c80e440e7232d5c24fb"},"openspec/changes/add-agent-session-approval-control/tasks.md":{"bytes":3242,"sha256":"782b9f42a8b58fab966c04920d27a98ea77d588102594219572eae5b17cbad11"},"openspec/changes/add-gateway-operations/.openspec.yaml":{"bytes":40,"sha256":"dc10040214104474c4e34e5b38359540c882aa7cfb6e7221e5d0614f1dba8fd7"},"openspec/changes/add-gateway-operations/design.md":{"bytes":5441,"sha256":"d07d9f9c3c5da092be96a18f0e6c35be53fe06f2eda9f540ef993961be8f247d"},"openspec/changes/add-gateway-operations/proposal.md":{"bytes":2342,"sha256":"c6081bd3692307909e736b7d84ccc34828b4fa5152a118f86dc577fa6ac3d47f"},"openspec/changes/add-gateway-operations/specs/channel-node-control/spec.md":{"bytes":2663,"sha256":"4350182f113da6caff9cd0eb81f2cb5173be374bd2f6665e16a9f93111fb4649"},"openspec/changes/add-gateway-operations/specs/configuration-control/spec.md":{"bytes":2432,"sha256":"cf8839be9d8c9015cfb855422fcdfdfaee02275965f2b3a12b42ce4987b8b3c1"},"openspec/changes/add-gateway-operations/specs/cron-control/spec.md":{"bytes":2453,"sha256":"8f86038254595e09c705b4b680d41aed60b2332f019139e35b5a65c329774274"},"openspec/changes/add-gateway-operations/specs/skill-plugin-lifecycle/spec.md":{"bytes":2551,"sha256":"01ef9d030ab116a21bcca1ff7f8d9ced27968015939cd1bf4c2ed99955f445bd"},"openspec/changes/add-gateway-operations/specs/task-audit-artifacts/spec.md":{"bytes":2597,"sha256":"8d2cb83159ed06b09358d3f950ae20489ea964a864c289168ab2c5a8e57ffadb"},"openspec/changes/add-gateway-operations/specs/tool-model-catalogs/spec.md":{"bytes":2463,"sha256":"a424d99c94d69cb61fa9e3f0efeb9dc8c1702d37c397f789c3363a79066df547"},"openspec/changes/add-gateway-operations/tasks.md":{"bytes":5352,"sha256":"12b19adb7b2a84e0fc263e8a8378719d2f5978f2dc5f619f3c856eb70a66b4f5"},"openspec/changes/add-managed-gateway-client/.openspec.yaml":{"bytes":40,"sha256":"dc10040214104474c4e34e5b38359540c882aa7cfb6e7221e5d0614f1dba8fd7"},"openspec/changes/add-managed-gateway-client/design.md":{"bytes":5113,"sha256":"162801004ae85138dc1d03ecb0654506986c26053bfe6fa9e72704edb01de6a2"},"openspec/changes/add-managed-gateway-client/proposal.md":{"bytes":2019,"sha256":"a91469801a7becd8ab01272697394c1d44c367ac2ae0666814b6f6b5706a01cf"},"openspec/changes/add-managed-gateway-client/specs/gateway-recovery/spec.md":{"bytes":2762,"sha256":"af082acc14c97793b8f9231b500e86e8e5c77455ae04a88b0b24fdfa4ed3335e"},"openspec/changes/add-managed-gateway-client/specs/managed-rpc/spec.md":{"bytes":2624,"sha256":"6aa6031b61a113443b8d560e58baae1c041ddc465630b736fa9a23b1fdb4408d"},"openspec/changes/add-managed-gateway-client/specs/typed-event-delivery/spec.md":{"bytes":2613,"sha256":"c5def41f0c9510153b5eb773521778d6121cad2ca4b2bdc733e9cfaa40275552"},"openspec/changes/add-managed-gateway-client/tasks.md":{"bytes":3249,"sha256":"978d020d94027db3801c090dd7e86bbd65b2568c64880950320e57087ee96970"},"openspec/changes/add-optional-runtime-adapters/.openspec.yaml":{"bytes":40,"sha256":"dc10040214104474c4e34e5b38359540c882aa7cfb6e7221e5d0614f1dba8fd7"},"openspec/changes/add-optional-runtime-adapters/design.md":{"bytes":4940,"sha256":"65332fcd6d91ff4ca9e77d53f606caccec2795fae74160bb95d357da482546c9"},"openspec/changes/add-optional-runtime-adapters/proposal.md":{"bytes":2065,"sha256":"a32b0507234b8e78719cb7716dc484212797b3c0259daa76931bf2c7820b4b3e"},"openspec/changes/add-optional-runtime-adapters/specs/cli-typed-results/spec.md":{"bytes":2609,"sha256":"2f9836a84b4b5ae66abae680ef1ec52c35531029b4682a75cc5a3c2e8cc6c67f"},"openspec/changes/add-optional-runtime-adapters/specs/persistent-stdio-adapters/spec.md":{"bytes":2509,"sha256":"ea7d2f8599d97c4ccd8f23ada658f636be62d2bdb715ed82f026a22286a7a3db"},"openspec/changes/add-optional-runtime-adapters/specs/terminal-voice-adapters/spec.md":{"bytes":2620,"sha256":"77fbb21d872b83da1cda418e6a7e1d94b0ea496ac566e6808225f2031a1c39a0"},"openspec/changes/add-optional-runtime-adapters/tasks.md":{"bytes":3318,"sha256":"a86f42485573c87ffa97e3296c3c20cfc128b63db40166a28ee7daf48e1b9f0c"},"openspec/changes/establish-sdk-compatibility-governance/.openspec.yaml":{"bytes":40,"sha256":"dc10040214104474c4e34e5b38359540c882aa7cfb6e7221e5d0614f1dba8fd7"},"openspec/changes/establish-sdk-compatibility-governance/design.md":{"bytes":4395,"sha256":"5eef818703376fa417abdff26f2b3ce0bc5761f643f4378cf985abc49dc35e92"},"openspec/changes/establish-sdk-compatibility-governance/proposal.md":{"bytes":1789,"sha256":"88e18f4f66ebccace6da321cb7d0a6b4d788e8e84cc933ab3678a5389b459ed6"},"openspec/changes/establish-sdk-compatibility-governance/specs/sdk-compatibility-governance/spec.md":{"bytes":3830,"sha256":"3d14086cef101a78b83ef953e16cea13b4b341ca9c9552c62596ee9ab85131a1"},"openspec/changes/establish-sdk-compatibility-governance/tasks.md":{"bytes":2716,"sha256":"edd09e1dfd45f8f9b956ea4745b4cedad5686ce9cda5813c1cd463df3bf18e6a"},"openspec/changes/fix-openclaw-protocol-contracts/.openspec.yaml":{"bytes":40,"sha256":"dc10040214104474c4e34e5b38359540c882aa7cfb6e7221e5d0614f1dba8fd7"},"openspec/changes/fix-openclaw-protocol-contracts/design.md":{"bytes":5675,"sha256":"10966f9bc03d3b34138539aeeb4b7ad884b28763cc2290c1f95926b69335dbbb"},"openspec/changes/fix-openclaw-protocol-contracts/proposal.md":{"bytes":2418,"sha256":"11a51837e386f1068004c526673547610a5b84dca8b42fc6d9484da02cc9b270"},"openspec/changes/fix-openclaw-protocol-contracts/specs/gateway-chat-events/spec.md":{"bytes":2622,"sha256":"3564b6061b568c1d30577fc8b228243f21df756321de9e50dd4a763529afb5b9"},"openspec/changes/fix-openclaw-protocol-contracts/specs/gateway-device-auth/spec.md":{"bytes":2806,"sha256":"2a6d8d7d5202495cdace92ffd12a500ee9f0266a172aa4147852e4cf43ee2a4a"},"openspec/changes/fix-openclaw-protocol-contracts/specs/responses-streaming/spec.md":{"bytes":2695,"sha256":"1ca9b80db706c236ca32ae0acd8a02a190fc3644959aa58af4379035923c3b82"},"openspec/changes/fix-openclaw-protocol-contracts/specs/session-history-contract/spec.md":{"bytes":2651,"sha256":"7fcc7baab4e3d9f10dd86adb03e00f78b07a7f011747a744224ca3dadf89168c"},"openspec/changes/fix-openclaw-protocol-contracts/specs/tools-invoke-contract/spec.md":{"bytes":2681,"sha256":"f255110ecff5a9479b780ec81dce1c451d638fe69259196e0ef063c5343a62f1"},"openspec/changes/fix-openclaw-protocol-contracts/tasks.md":{"bytes":4698,"sha256":"fd7a21979c085430e70479494b8f87c88e9746cf277463628a93a92a7932130a"},"openspec/config.yaml":{"bytes":1862,"sha256":"151f5ce61678f2d47d19a1c21168936f7ad5c6f05adec25db6a0e8a70f1f8ba9"},"openspec/specs/.gitkeep":{"bytes":1,"sha256":"01ba4719c80b6fe911b091a7c05124b64eeece964e09c058ef8f9805daca546b"}},"split_report":{"path":"docs/openclaw-integration/validation-report","encoding":"concatenated-base64-of-gzip","original_bytes":127699,"original_sha256":"a689415d7e7c1a28cc50a97179c797adc29080b30f5ec929aa8ed23227a1a598","parts":3}} diff --git a/docs/openclaw-integration/roadmap.md b/docs/openclaw-integration/roadmap.md new file mode 100644 index 0000000..7d97a2a --- /dev/null +++ b/docs/openclaw-integration/roadmap.md @@ -0,0 +1,53 @@ +# OpenClaw Java SDK:官方能力整合路线与 OpenSpec 变更图 + +版本:0.1.0-draft · 日期:2026-09-20 · 状态:待评审。 + +## 目标与边界 + +把官方能力差距分析转成可审查、可验证和可分批实现的行为规范。首先修正已有协议行为,再建立受管理客户端,然后扩展领域操作。现有 HTTP、SSE、WS 与 CLI 的分工继续保留;Java 8/17/21 三条发行线保持同一已批准语义。 + +不在本轮执行范围:修改 SDK、添加依赖、运行真实 Agent、批准工具执行、创建发布、写入用户电脑或推送仓库。本包只交付文档。 + +## 变更依赖 + +```text +G0 版本与兼容治理 + └─ G1 协议契约修正 + └─ G2 RPC / 连接恢复 / 事件交付 + └─ G3 Agent / Session / Approval + ├─ G4 Gateway 运营管理 + └─ G5 可选运行时适配 +``` + +六组按独立变更保存。G4 和 G5 是较大领域集合,应按各自 capability 分批实现并逐项审查;仅有当前提案不授权并行大改。 + +| 编号 | Change ID | 优先级 | 规范数 | +|---|---|---|---| +| G0 | `establish-sdk-compatibility-governance` | P0 | 1 | +| G1 | `fix-openclaw-protocol-contracts` | P0 | 5 | +| G2 | `add-managed-gateway-client` | P0 | 3 | +| G3 | `add-agent-session-approval-control` | P1 | 3 | +| G4 | `add-gateway-operations` | P1/P2 | 6 | +| G5 | `add-optional-runtime-adapters` | P2 | 3 | + +## 设计职责 + +proposal 解释为什么、范围与破坏性变化;specs 只写外部行为和验收场景;design 解释组件划分、候选方案、风险与迁移;tasks 把场景映射到可验收的工作项。类名和文件路径属于 design/tasks,而不是需求本身。 + +## 三分支协作 + +以 2.x 作为本次公共源码阅读参照,不因此指定它为未来唯一开发主干。每次实现必须明确起始分支,并把相同业务修改同步到其他适用分支;不能直接整分支合并来覆盖 JDK、Jackson 或 Maven 的发行线差异。已批准功能的测试场景和语义相同,二进制 ABI 不要求跨 Jackson 主版本一致。 + +建议根文档由文档专用提交维护,版本线只同步明确的文档和实现提交,不把本包当成已合并到 main 的事实。各条线独立记录测试 SHA、依赖来源与发布限制。 + +## 准入状态 + +人审:尚未发生。目标 Gateway 精确版本/提交:尚未锁定,阻断编码而不阻断文档评审。官方 OpenSpec CLI:当前环境未安装,尝试获取时发生网络/DNS 解析失败;其校验是待补项。自定义文档结构检查只说明文档内部结构与引用,不代替官方 CLI、编译或协议测试。 + +## 尚未纳入强承诺的扩展 + +实时官方索引还可能包含新渠道、A2A、云会话/Worker、ClawHub 独立服务等。上一轮差距清单并非官方目录的穷尽审计;这些能力必须单独完成需求与版本评估,不因本文已有 21 个 capability 就宣称全覆盖。Gateway 内部 worker 私有协议、模型/沙箱内核与原生插件运行时不属于本 Java 外部 SDK 的默认实现职责。 + +## 完成定义 + +文档完成:四类产物齐全、结构与引用可检查,保持待评审。能力完成:目标版本锁定、场景真正执行、每个适用分支有证据、兼容差异获准、人审接受。规范生效:满足本项目归档条件后才更新根 specs;不得把“任务已生成”写成“功能已实现”。 diff --git a/docs/openclaw-integration/source-register.md b/docs/openclaw-integration/source-register.md new file mode 100644 index 0000000..51a742d --- /dev/null +++ b/docs/openclaw-integration/source-register.md @@ -0,0 +1,60 @@ +# 来源登记与证据边界 + +文档日期:2026-09-20。SDK 提交可以精确定位;上游页面为本轮读取的在线文档,不是已归档的版本化原文,也不是已运行验证的 Gateway 版本。O16 为文档索引指向的 CLI 参考入口,本轮未按全部子命令逐项复核。 + +## 官方规范来源 + +| ID | 内容 | 原始来源 | +|---|---|---| +| S01 | OpenSpec 概念与变更目录 | https://github.com/Fission-AI/OpenSpec/blob/main/docs/concepts.md | +| S02 | OpenSpec spec-driven schema | https://github.com/Fission-AI/OpenSpec/blob/main/schemas/spec-driven/schema.yaml | +| S03 | OpenSpec CLI validate 与状态命令 | https://github.com/Fission-AI/OpenSpec/blob/main/docs/cli.md | +| O00 | OpenClaw 文档索引 | https://docs.openclaw.ai/llms.txt | +| O01 | 外部应用接入边界 | https://docs.openclaw.ai/gateway/external-apps | +| O02 | 协议版本与客户端恢复边界 | https://docs.openclaw.ai/gateway/protocol/versioning | +| O03 | Responses HTTP 与 SSE | https://docs.openclaw.ai/gateway/openresponses-http-api | +| O04 | 会话启动、快照及事件语义 | https://docs.openclaw.ai/gateway/protocol/rpc-bootstrap-and-events | +| O05 | Gateway 握手与设备凭据 | https://docs.openclaw.ai/gateway/protocol/handshake | +| O06 | 会话控制与历史 | https://docs.openclaw.ai/gateway/protocol/rpc-session-control | +| O07 | HTTP Tools Invoke 与认证语义 | https://docs.openclaw.ai/gateway/tools-invoke-http-api | +| O08 | 设备、Node、审批与 Cron RPC | https://docs.openclaw.ai/gateway/protocol/rpc-devices-nodes-and-approvals | +| O09 | Config RPC 更新与生效 | https://docs.openclaw.ai/gateway/configuration/config-rpc | +| O10 | 工具、模型与 Skills 管理 | https://docs.openclaw.ai/gateway/protocol/operator-methods | +| O11 | Talk、Agent 与产物 RPC | https://docs.openclaw.ai/gateway/protocol/rpc-talk-config-and-agents | +| O12 | 系统、渠道、插件与终端 RPC | https://docs.openclaw.ai/gateway/protocol/rpc-system-and-channels | +| O13 | 任务、审计及用量台账 | https://docs.openclaw.ai/gateway/protocol/ledgers | +| O14 | MCP serve | https://docs.openclaw.ai/cli/mcp/serve | +| O15 | ACP bridge | https://docs.openclaw.ai/cli/acp | +| O16 | CLI 参考入口 | https://docs.openclaw.ai/cli | + +OpenSpec schema 本轮读取的 Git blob:`688c38a20bd0350bf27003ccdb78215562b1a334`。这标识所读文件,不代表本环境安装了对应 CLI 发布版。 + +## SDK 提交与源码入口 + +| 分支 | 精确提交 | +|---|---| +| feature/1.0.x | 8cfbeb880a6c6ae5390fab0f9fe65e06938907be | +| feature/2.0.x | 48309d7bc34c4298cdfa1c52db06114b2e7e9f17 | +| feature/3.0.x | 3687fcb09e75ec4c2ecb522877e9a27c1f1955aa | +| main | c4ddcd3fa86d8fb5352b722813268760c35636b2 | + +以 2.x 的固定提交列出共用静态分析入口。三分支差异必须在实施前复核,不能把单个入口的观察扩张为全仓库、全版本安全审计。 + +- C01:[Responses 普通 JSON 路径](https://github.com/easy-4-java/openclaw-java-sdk/blob/48309d7bc34c4298cdfa1c52db06114b2e7e9f17/src/main/java/io/github/easy4j/openclaw/api/OpenClawResponsesClient.java)。 +- C02:[WS RPC 与聊天事件路由](https://github.com/easy-4-java/openclaw-java-sdk/blob/48309d7bc34c4298cdfa1c52db06114b2e7e9f17/src/main/java/io/github/easy4j/openclaw/ws/OpenClawGatewayWsClient.java)。 +- C03:[HelloOk 响应模型](https://github.com/easy-4-java/openclaw-java-sdk/blob/48309d7bc34c4298cdfa1c52db06114b2e7e9f17/src/main/java/io/github/easy4j/openclaw/ws/protocol/HelloOk.java)。 +- C04:[历史请求与结果](https://github.com/easy-4-java/openclaw-java-sdk/blob/48309d7bc34c4298cdfa1c52db06114b2e7e9f17/src/main/java/io/github/easy4j/openclaw/ws/protocol/result/ChatHistoryResult.java)。 +- C05:[HTTP 工具请求模型](https://github.com/easy-4-java/openclaw-java-sdk/blob/48309d7bc34c4298cdfa1c52db06114b2e7e9f17/src/main/java/io/github/easy4j/openclaw/api/model/ToolInvokeRequest.java)。 +- C06:[CLI 命令门面](https://github.com/easy-4-java/openclaw-java-sdk/blob/48309d7bc34c4298cdfa1c52db06114b2e7e9f17/src/main/java/io/github/easy4j/openclaw/cli/OpenClawCli.java)。 +- C07:[CLI 一次性执行器](https://github.com/easy-4-java/openclaw-java-sdk/blob/48309d7bc34c4298cdfa1c52db06114b2e7e9f17/src/main/java/io/github/easy4j/openclaw/cli/OpenClawCliExecutor.java)。 +- C08:[现有 Chat SSE 订阅](https://github.com/easy-4-java/openclaw-java-sdk/blob/48309d7bc34c4298cdfa1c52db06114b2e7e9f17/src/main/java/io/github/easy4j/openclaw/api/OpenClawSseClient.java)。 + +C01 和 C02 的相关实现本轮再次读取;其余入口沿用同一会话前轮静态核查,HEAD 本轮再次核对无变化。它们不是运行证据。 + +## 本轮未执行的事项 + +未运行 codegraph、Maven 构建、真实 Gateway 集成、漏洞扫描、堆/线程分析或生产就绪检查。尝试在沙箱获取仓库及 OpenSpec CLI 时遇到 DNS/网络解析失败;没有把此前本机 Tunnel 的状态推断为本轮状态。首次文档编制阶段没有修改用户本机,也没有提交 GitHub;本次文档提交保留该阶段的证据边界。 + +## 实施前必须补全 + +固定目标 Gateway 的精确版本/提交、可复现构建来源和协议文件;保存脱敏 wire 样本与命令结果;记录测试环境和认证模式。无法核实的上游字段、方法和权限保持待验证,不猜测其在某发行版中的可用性。 diff --git a/docs/openclaw-integration/traceability.json.gz b/docs/openclaw-integration/traceability.json.gz new file mode 100644 index 0000000000000000000000000000000000000000..85d0d48ed5a37e000c0e52847f530926ade63e82 GIT binary patch literal 3246 zcmV;f3{mqRiwFP!00002|LvV?QyN(sfWObLpz?W`3f(4|-EY}!b~0PDF%>h`R8387 z^+3mT1%U<3Zfa|*@Pb?vK?8Wh3kH?w+K`I|xyYaCbGrLqY+um9c-}@g85O!eBo*>D zpwGFy*YlpAzp~l>t^BdsZaAMYo+0+eA8j|-K#=*>%>|y>1Fq+Gr+3)L1i4>1Hy3sJ`X9{z3aq$FVTrWIc?Z^Zq8W z51a^tT+prkh+=LH@vCxZNoqz=vLrPdxLP`SiU~XqC{O*Yy;T0g@eS3IDKDsR9KXGw z+h0)M^xe?@{mb#s5@doS>L=ZJ*#G43kAHl4@TLW>SfjGM&P$Gk(lQ>;cmImIRvPR*{i~;DI2*zF z*HUQ$@p*$C>D0bMw-3QBYX~kh1ZNilPNq;Sff{qlKv+ZYWrm;+9D+Wgr4)1$8!?0l8ei&CkC!kZ}h+N8uNkQmYOMujEm=oN}o<@_Pyr*Sl8aXZV6 zU?1dmbX+)^73%8>L!q*VvwJ3`M}zc;2Cn#~iau_l@JD^_iM2gEvuU9_i;kd@lVdnj zmNs@#vms`B2HFr4WdF&$v@0JIw6iZ1Kmh>Sy$5%n0E(d{BDz$|O`O=k%O7yI3^JoZ z%Z2_tW_?}2jIhTo@^WYiZLG?Xq*<9!Ff+0~Jv>0kS$QcfZq+PiBxZy#Y1!v~*G{hQ^T^#g?eJfJjAy5wP)S%M zi6kkQBw5WSOF}a*HFzUsVF5e_NSul~LsZY8Qr%+s0MH~Y5z(iZp2g7xad%ay#w>sx z0TLXHm2pK0>k)owYZSj7>q(3OHW1*v9{V#c5cK+Ao;(h)eDM7M%B_djs3rDD) zMB(?+Xc|O#yB*=}c7(S-58<7zpmuidN!4AU)-h38^@~DO75@Njn zd4A7g*dj%N49RM?xhsaZ^}roUE}-eGMe;l(3EN?&j1#=FsHO3S97*8xkwvn_iv~%O zGr_TKDL;);GdQ~^R+|>a^I#;^HkXunD3vlOxg(Wocx_WEZS*wE;7gzKq*mo-cd>5H z0O%q5vt#%+}E9hl|V(kOBdcwe|9< zR369iWmF$Sm5N2rfF40ZA4H`OhvIe#%}kjc9Sx!*JII=mEk$;4E+*|y;A+YOXaJC~ z^@ZOG)!ptvr*Kn194EUOpU>}o!L&m4UN;$`{vJ2?ly$yzx}lTPcfY&;5KOf}dR%SC=}b+MG9XEjD_*ojQ8KG& z6^meJf+YV$Wv5nQ<#~xOSP&ttax5cF!@KII+i*6bnA9Drt}Kox90|7J)SOsbkq+Ww zX1Z4i9zXrbL!S^FxIZueXqJ`;I6Egcc+}WX5AkQqdiC1n2OBO{w|4a)3A^IVlvsb$ zc~>+MLJCGmR?Yl|ybwmwc`0AiP7r7HD7VG36H7=*qsXK-9aXLtML@l@M8wEpJR^tZ ztQCDeex!Qnbv-GdpKjK`x&rA(wP*36&6jl@J;^G`paNataehp&Se4V?Zsd=M&Y|*Xmlf@In5b zCL!*I=>rrk>meKqUk7}o!kZ0Lc&o18$@f>42)#JO<1B#J$NHI|0urb&x!iUv^`9PPCQoX^-{#$wgRiZHE8lk(hV%fju6$>s0N>2d!JdUbcm+#Jhdkq;8`Y*4n;`bSe&!gy^Sr}0;BZCf+I5vgiMQM9W`L{(1 zsD7H6lNZ*cgD{>yFbg9ZW<)M?(%LPkWr|l6s=bbwC}8u}8R@=Ymy=SD7~6-vE>`iD znIPl#4uM@V;nu%kw`6gdM~w_h?V{wo+M!E3seS1lv*YG1>z!K_@$lt*Gm{IP$!@W8`tEbzWVgNOYZ<>E@CuDj5gT2Ot=OOK@rTWVjitd z36%s+m+1`ACq2()l&7PmMOr| zAUGOmXM!r@9rUOLjt~SJFQVwAyl{Z|{ob2*>bpFOLE=%&l1{EV7(sjp*8I#UcCKQ< z;q{1Kfp+OltsJLL|9*Q-(Gjwai#5gU)lbWGXr$Bo=qLysQMcl`f}9TNcQV+Xc%QQ# z3mp+1!H3WiM{+JCZH>wsE2xmgGf})UZeoBm1dyy{Q&BZzqP1B=%d1A#ow?CbK+_Gq z4|a#RNEf10e+N4=;^KmK#vkOKws)KS1YQ51pi>*VgnV~JOsLgRJg+CqL2`H6$=zuu zcjxoS(HA~IbS31#^989Hp{CxvCDzoNKh4aK0{M|WS;aQa?;}1h8C-5}c5I|e@``dK zDb}lEZq&@!Xb>B@ZZ;RgnW#|R7GrOO%9K&m&g}4@nr$4-N*{}8ZB4yxkY7Tn*=|7S z^{Lz#x7|PD339`%opCX~AnS)nvi@OCef))2yXxqZhd*uFJP38EAA~Zhil*2tsn;Ec zH}y-8FTKv{l(EtU5D6Ba)?H0)RhKQxixc8X$bvWs^{pQSBgv}$V$H#G;Uiw0r{~M? zdL7l17QsQNd;K7!lJ!eYQdiQqxZCg%!ppSDkLnF=R|pSUj9u%DUCN!e7S?yY&w**0ZQORO Date: Sun, 20 Sep 2026 23:59:41 +0800 Subject: [PATCH 02/22] =?UTF-8?q?docs(g0):=20=E5=87=86=E5=85=A5=E8=AF=81?= =?UTF-8?q?=E6=8D=AE=E9=87=87=E9=9B=86=E2=80=94=E2=80=94=E7=89=88=E6=9C=AC?= =?UTF-8?q?=E9=94=81=E5=AE=9A=E3=80=81=E4=B8=89=E5=88=86=E6=94=AF=20codegr?= =?UTF-8?q?aph=E3=80=81=E6=9E=84=E5=BB=BA/=E6=B5=8B=E8=AF=95=E7=9F=A9?= =?UTF-8?q?=E9=98=B5=E3=80=81=E8=83=BD=E5=8A=9B=E6=B8=85=E5=8D=95=E3=80=81?= =?UTF-8?q?=E5=AE=98=E6=96=B9=20OpenSpec=20strict=20=E6=A0=A1=E9=AA=8C=206?= =?UTF-8?q?/6?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - 任务 1.2/1.3/2.1/3.3/3.4 完成并附证据工件(evidence/) - 1.1/2.2/2.3/2.4/3.1/3.2/3.5 标注人审或环境阻塞原因,G1 编码保持阻断 --- ...-1074-40c8-8d54-eb7e99fcf5d6.continue.json | 1 + .../evidence/2026-09-20-precursor-evidence.md | 39 +++++++++++++++++++ .../evidence/capability-inventory.json | 24 ++++++++++++ .../evidence/version-lock.md | 22 +++++++++++ .../tasks.md | 16 +++++--- 5 files changed, 97 insertions(+), 5 deletions(-) create mode 100644 .mimosa/hook-state/sess_aba26ad0-1074-40c8-8d54-eb7e99fcf5d6.continue.json create mode 100644 openspec/changes/establish-sdk-compatibility-governance/evidence/2026-09-20-precursor-evidence.md create mode 100644 openspec/changes/establish-sdk-compatibility-governance/evidence/capability-inventory.json create mode 100644 openspec/changes/establish-sdk-compatibility-governance/evidence/version-lock.md diff --git a/.mimosa/hook-state/sess_aba26ad0-1074-40c8-8d54-eb7e99fcf5d6.continue.json b/.mimosa/hook-state/sess_aba26ad0-1074-40c8-8d54-eb7e99fcf5d6.continue.json new file mode 100644 index 0000000..0880c80 --- /dev/null +++ b/.mimosa/hook-state/sess_aba26ad0-1074-40c8-8d54-eb7e99fcf5d6.continue.json @@ -0,0 +1 @@ +{"schemaVersion":"mimosa-stop-continuation/v1","generation":"mu5amxzk-35945-ec5bb1c135","used":false,"reportPersisted":false,"claim":null,"updatedAt":"2026-09-17T08:54:37.777Z"} \ No newline at end of file diff --git a/openspec/changes/establish-sdk-compatibility-governance/evidence/2026-09-20-precursor-evidence.md b/openspec/changes/establish-sdk-compatibility-governance/evidence/2026-09-20-precursor-evidence.md new file mode 100644 index 0000000..f3cd9af --- /dev/null +++ b/openspec/changes/establish-sdk-compatibility-governance/evidence/2026-09-20-precursor-evidence.md @@ -0,0 +1,39 @@ +# G0 准入证据(2026-09-20 采集) + +## 任务 1.2 版本锁定 +见 `version-lock.md`。OpenClaw `2026.7.1-2 (0790d9f)`,npm 全局安装,Node v24.18.0。 + +## 任务 1.3 codegraph 证据(三分支独立检出) +| 分支 | SHA | 执行方式 | 结果 | +|---|---|---|---| +| feature/3.0.x | 3687fcb | codegraph MCP build(主 worktree) | head_matches_build=true,增量 23 文件 / 420 节点 | +| feature/2.0.x | 48309d7 | 同上(切分支后增量) | head_matches_build=true,16 文件 / 275 节点 | +| feature/1.0.x | 8cfbeb8 | 独立 worktree /tmp/wt-oc-1.0.x 全量 | 200 文件 / 2324 节点 / 13840 边 | + +Java 支持正常,无执行失败项。命令:`build_or_update_graph_tool`(MCP)/ `codegraph` CLI 等价。 + +## 任务 3.3 构建与测试证据(每条分支独立) +| 分支 | JDK | Maven | 构建 | 测试 | +|---|---|---|---|---| +| feature/3.0.x | 21 (ms-21.0.12.1) | wrapper Maven 4 (./mvnw) | clean deploy BUILD SUCCESS | 155/155 绿 | +| feature/2.0.x | 17 (corretto-17.0.20.1) | 3.9.16 (mvn) | clean deploy BUILD SUCCESS | 155/155 绿 | +| feature/1.0.x | 8 (corretto-1.8.0_504) | 3.9.16 (mvn) | clean deploy BUILD SUCCESS | 155/155 绿 | + +非零执行测试数:0。CI(GitHub Actions):三分支最新 run 均 success。 + +## 任务 3.4 官方 OpenSpec CLI 校验 +`openspec validate --all --strict --no-interactive --json`(CLI 1.8.0): +6/6 changes valid(establish-sdk-compatibility-governance、fix-openclaw-protocol-contracts、 +add-managed-gateway-client、add-agent-session-approval-control、add-gateway-operations、 +add-optional-runtime-adapters),issues 均为空。 + +## 任务 2.1 能力证据清单 +见 `capability-inventory.json`。静态存在 8 项(HTTP 五客户端、CLI、WS core、Spring 装配)、 +未封装 4 项(G2-G5 目标能力);全部 liveVerified=false,无任何 live-pass 标记。 + +## 阻塞项(人审/环境门禁,未勾选原因) +- 1.1 / 2.3 / 3.5:需人审记录(范围、批准、归档资格),AI 会话不能冒充。 +- 2.2:三分支协议 fixture 与获准差异清单,待 1.1 批准后建立。 +- 2.4:traceability 逐项映射,依赖 2.1-2.3 产物。 +- 3.1:真实 Gateway 健康/认证/授权检查,需启动真实 Gateway(本机 openclaw 2026.7.1-2 可执行,未在本轮启动)。 +- 3.2:文档漂移修正,随 G1 实施时逐分支核对。 diff --git a/openspec/changes/establish-sdk-compatibility-governance/evidence/capability-inventory.json b/openspec/changes/establish-sdk-compatibility-governance/evidence/capability-inventory.json new file mode 100644 index 0000000..da3b662 --- /dev/null +++ b/openspec/changes/establish-sdk-compatibility-governance/evidence/capability-inventory.json @@ -0,0 +1,24 @@ +{ + "generatedAt": "2026-09-20", + "openclawVersion": "2026.7.1-2 (0790d9f)", + "branches": { + "feature/1.0.x": {"sha": "8cfbeb8", "jdk": 8, "tests": "155 green", "graph": "2324 nodes / 13840 edges"}, + "feature/2.0.x": {"sha": "48309d7", "jdk": 17, "tests": "155 green", "graph": "indexed, head_matches_build=true"}, + "feature/3.0.x": {"sha": "3687fcb", "jdk": 21, "tests": "155 green", "graph": "indexed, head_matches_build=true"} + }, + "capabilities": [ + {"id": "http-chat", "status": "static-present", "evidence": "OpenClawChatClient + 单测", "liveVerified": false}, + {"id": "http-responses", "status": "static-present", "evidence": "OpenClawResponsesClient + SSE reader + 单测", "liveVerified": false}, + {"id": "http-embeddings", "status": "static-present", "evidence": "OpenClawEmbeddingsClient + 单测", "liveVerified": false}, + {"id": "http-tool-invoke", "status": "static-present", "evidence": "OpenClawToolInvokeClient + 单测", "liveVerified": false}, + {"id": "http-webhook", "status": "static-present", "evidence": "OpenClawWebhookClient + 单测", "liveVerified": false}, + {"id": "cli-commands", "status": "static-present", "evidence": "OpenClawCli 81+ 方法 + 参数装配测试 + UTF-8 回归", "liveVerified": false}, + {"id": "ws-gateway-core", "status": "static-present", "evidence": "OpenClawGatewayWsClient chat/sessions/cron/config + 本地 fixture 集成测试", "liveVerified": false}, + {"id": "spring-boot-autoconfig", "status": "static-present", "evidence": "spring/boot 包", "liveVerified": false}, + {"id": "gateway-reconnect-reconciliation", "status": "not-wrapped", "evidence": null, "liveVerified": false}, + {"id": "approval-execution-loop", "status": "not-wrapped", "evidence": null, "liveVerified": false}, + {"id": "gateway-ops-rpcs", "status": "not-wrapped", "evidence": null, "liveVerified": false}, + {"id": "terminal-voice-adapters", "status": "not-wrapped", "evidence": null, "liveVerified": false} + ], + "rule": "liveVerified=false 或 evidence=null 的条目不得标记为 live-pass;CLI 透传不计为已封装能力。" +} diff --git a/openspec/changes/establish-sdk-compatibility-governance/evidence/version-lock.md b/openspec/changes/establish-sdk-compatibility-governance/evidence/version-lock.md new file mode 100644 index 0000000..99ffe78 --- /dev/null +++ b/openspec/changes/establish-sdk-compatibility-governance/evidence/version-lock.md @@ -0,0 +1,22 @@ +# 版本锁定记录(G0 任务 1.2) + +锁定日期:2026-09-20。锁定人:hiwepy(经 AI 会话采集,待人审确认)。 + +## 目标 OpenClaw 版本 + +| 项 | 值 | 来源 | +|---|---|---| +| 版本 | `2026.7.1-2` | `openclaw --version` 实测输出 | +| 提交 | `0790d9f` | 同上(版本串内嵌短提交) | +| 构建来源 | npm 全局安装 | `~/.local/bin/openclaw` → `../lib/node_modules/openclaw/openclaw.mjs`(node 启动器) | +| Node 运行时 | v24.18.0(nvm) | `node --version` | + +## 协议来源 + +- Gateway 协议:docs.openclaw.ai `/gateway/protocol/*`(protocol、auth、handshake、rpc-methods、rpc-session-control、transport、versioning)。 +- CLI 命令树:docs.openclaw.ai `/cli`(含 infer=capability 别名、policy/voicecall/file-transfer 为可选插件等备注)。 + +## 声明 + +锁定仅覆盖本机可获得的最新发布版;未取得官方对应版本的协议 schema 机器可读制品, +协议字段以文档 + 真实 Gateway 观察(任务 3.1,未执行)为准。人审通过前 G1 编码保持阻断。 diff --git a/openspec/changes/establish-sdk-compatibility-governance/tasks.md b/openspec/changes/establish-sdk-compatibility-governance/tasks.md index 3d42a13..1e69e18 100644 --- a/openspec/changes/establish-sdk-compatibility-governance/tasks.md +++ b/openspec/changes/establish-sdk-compatibility-governance/tasks.md @@ -5,12 +5,12 @@ ## 1. 评审与版本准入 - [ ] 1.1 评审 GOV-01 至 GOV-04 的八个场景和六组变更边界;验收:有范围、依赖、优先级、人审记录,不把文档生成记录当作批准。 -- [ ] 1.2 选择可获得的 OpenClaw 精确版本/提交与构建来源;验收:形成版本锁定记录及对应协议来源,未锁定时后续实施保持阻断。 -- [ ] 1.3 在独立检出目录核对三条 SDK HEAD、现有指令和代码图;验收:记录 codegraph 版本、实际执行命令与索引/查询结果;不支持 Java 或执行失败时明确标注,并保留源码核对证据,禁止冒充代码图结果。 +- [x] 1.2 选择可获得的 OpenClaw 精确版本/提交与构建来源;(证据:evidence/2026-09-20-precursor-evidence.md、version-lock.md)验收:形成版本锁定记录及对应协议来源,未锁定时后续实施保持阻断。 +- [x] 1.3 在独立检出目录核对三条 SDK HEAD、现有指令和代码图;(证据:evidence/2026-09-20-precursor-evidence.md §1.3)验收:记录 codegraph 版本、实际执行命令与索引/查询结果;不支持 Java 或执行失败时明确标注,并保留源码核对证据,禁止冒充代码图结果。 ## 2. 能力证据和兼容治理 -- [ ] 2.1 为 GOV-01、GOV-04 建立机器可读的能力、版本和证据清单;验收:能区分静态存在、部分实现、CLI 透传、未封装、未验证与不适用,并演示缺失证据不能被标记为 live-pass。 +- [x] 2.1 为 GOV-01、GOV-04 建立机器可读的能力、版本和证据清单;(证据:evidence/2026-09-20-precursor-evidence.md、capability-inventory.json——8 项静态存在均 liveVerified=false,4 项未封装,无 live-pass 标记)验收:能区分静态存在、部分实现、CLI 透传、未封装、未验证与不适用,并演示缺失证据不能被标记为 live-pass。 - [ ] 2.2 为 GOV-02 建立三分支协议 fixture 和获准差异清单;验收:同一行为具有共同场景标识,JSON 包名和 JDK 差异不被误判为功能分叉,行为差异不能被全局忽略。 - [ ] 2.3 为 GOV-03 建立规范评审与归档检查步骤;验收:DRAFT、REVIEWED、IMPLEMENTED、VERIFIED 与 ARCHIVED 分开,未执行任务和缺证据场景可阻止本项目归档流程。 - [ ] 2.4 逐项映射 traceability 中 GOV-01-S1 至 GOV-04-S2;验收:八个场景均有对应检查或人工审核记录,重写 README 不得替代证据校验。 @@ -19,6 +19,12 @@ - [ ] 3.1 对锁定 Gateway 执行基础健康、认证成功及授权拒绝检查;验收:记录真实目标版本、认证模式及脱敏结果,现有缺陷如实登记,不以消除尚未实施功能的失败为本阶段前提。 - [ ] 3.2 修正文档中的版本、JDK、依赖和支持等级漂移;验收:逐分支核对 pom、README、发布说明,快照版本和未验证状态一致,无声称全量支持的空泛结论。 -- [ ] 3.3 记录实际 JDK/Maven/依赖来源与构建结果;验收:每条分支都有独立结果,环境不足标为 BLOCKED,治理变更无运行资源触点时明确记录资源测试不适用原因。 -- [ ] 3.4 使用已固定版本的官方 OpenSpec CLI 校验全部变更并保存输出;验收:validate --all --strict --no-interactive --json 成功,不用自定义结构检查冒充官方校验。 +- [x] 3.3 记录实际 JDK/Maven/依赖来源与构建结果;(证据:evidence/2026-09-20-precursor-evidence.md §3.3)验收:每条分支都有独立结果,环境不足标为 BLOCKED,治理变更无运行资源触点时明确记录资源测试不适用原因。 +- [x] 3.4 使用已固定版本的官方 OpenSpec CLI 校验全部变更并保存输出;openspec CLI 1.8.0,`validate --all --strict --no-interactive --json`:6/6 changes valid,issues 为空(证据:evidence/2026-09-20-precursor-evidence.md §3.4)验收:validate --all --strict --no-interactive --json 成功,不用自定义结构检查冒充官方校验。 - [ ] 3.5 评审治理变更的归档资格;验收:全部必需任务有证据、获准三分支规则已记录,只有治理规范本身可归档,后续功能提案不随之归档。 + +## 执行记录(2026-09-20) + +已由 AI 会话完成并附证据:1.2、1.3、2.1、3.3、3.4(见 evidence/ 目录)。 +保持未勾选(人审/环境门禁):1.1、2.2、2.3、2.4、3.1、3.2、3.5——原因逐条见 +evidence/2026-09-20-precursor-evidence.md「阻塞项」。G1 编码保持阻断,待人审批准。 From 60d35183ef49e761880e5237bd11e7c23a81c718 Mon Sep 17 00:00:00 2001 From: loong10k <20489781+loong10k@users.noreply.github.com> Date: Wed, 18 Nov 2026 06:25:41 +0800 Subject: [PATCH 03/22] docs: reconcile OpenClaw draft with G0 evidence --- ...6ad0-1074-40c8-8d54-eb7e99fcf5d6.continue.json | 1 - docs/openclaw-integration/README.md | 10 +++++----- docs/openclaw-integration/package-manifest.json | 2 +- docs/openclaw-integration/validation-summary.md | 15 ++++++++------- 4 files changed, 14 insertions(+), 14 deletions(-) delete mode 100644 .mimosa/hook-state/sess_aba26ad0-1074-40c8-8d54-eb7e99fcf5d6.continue.json diff --git a/.mimosa/hook-state/sess_aba26ad0-1074-40c8-8d54-eb7e99fcf5d6.continue.json b/.mimosa/hook-state/sess_aba26ad0-1074-40c8-8d54-eb7e99fcf5d6.continue.json deleted file mode 100644 index 0880c80..0000000 --- a/.mimosa/hook-state/sess_aba26ad0-1074-40c8-8d54-eb7e99fcf5d6.continue.json +++ /dev/null @@ -1 +0,0 @@ -{"schemaVersion":"mimosa-stop-continuation/v1","generation":"mu5amxzk-35945-ec5bb1c135","used":false,"reportPersisted":false,"claim":null,"updatedAt":"2026-09-17T08:54:37.777Z"} \ No newline at end of file diff --git a/docs/openclaw-integration/README.md b/docs/openclaw-integration/README.md index 4f2e7e2..53b357d 100644 --- a/docs/openclaw-integration/README.md +++ b/docs/openclaw-integration/README.md @@ -2,7 +2,7 @@ 版本 0.1.0-draft · 2026-09-20 · **待评审,未实施,未归档** -这是一套仓库内的 OpenSpec 变更草案,不是仅供讨论的差距清单。包含六组 proposal/design/tasks、21 个 capability spec、64 条 Requirement 和 128 个 Scenario;实施任务共 97 项,全部未执行;检查结果见 [文档检查结果](validation-summary.md)。 +这是一套仓库内的 OpenSpec 变更草案,不是仅供讨论的差距清单。包含六组 proposal/design/tasks、21 个 capability spec、64 条 Requirement 和 128 个 Scenario;任务共 97 项,其中 5 项 G0 准入证据任务已勾选,92 项待完成。SDK 功能尚未按这些草案实施;检查结果见 [文档检查结果](validation-summary.md)。 ## 阅读顺序 @@ -13,9 +13,9 @@ ## 交付边界 -本目录及 openspec/ 以独立文档提交交付;没有修改任何 SDK Java 源码、pom、依赖或现有测试,也没有写入维护者的本机工作区。所有实施任务保持未勾选,人审批准和具体目标 Gateway 版本锁定仍是下一阶段前提。 +本目录及 openspec/ 以独立文档提交交付;没有修改任何 SDK Java 源码、pom、依赖或现有测试。G0 已记录目标版本和来源,但该锁定仍待人审确认;G1 编码继续受评审门禁约束。 -官方 OpenSpec CLI 在当前环境不可用,尝试获取时因 DNS/网络解析失败而未能安装。因此只报告实际完成的自定义文档结构检查,不声称执行过官方 validate。也没有执行 codegraph、Maven 或真实 Gateway 测试。 +首次文档编制时仅执行自定义结构检查;后续 G0 证据提交记录了三分支 CodeGraph、Maven 构建与测试,以及 OpenSpec 1.8.0 strict 校验。2026-11-18 使用 OpenSpec 1.14.1 对本分支再次执行 `openspec validate --all --strict --no-interactive --json`,6/6 changes 有效。上述构建证据对应 2026-09-20 的 SDK 提交,不证明当前源码或真实 Gateway 集成;真实 Gateway 测试仍未执行。 ## 合入方式 @@ -25,8 +25,8 @@ ## 快速核对 -查看 `docs/openclaw-integration/baseline.json` 确认 SDK 提交及明确未验证的上游版本。参照 acceptance-plan 中的命令使用官方 OpenSpec CLI 校验;切勿把 artifact 已齐全或状态命令的 isComplete 字段解释为产品实现完成。 +查看 `docs/openclaw-integration/baseline.json` 确认首次文档编制时的 SDK 提交,再阅读 G0 的 `evidence/` 目录了解后续验证。OpenSpec 格式校验通过不代表产品实现完成。 ## 发布打包说明 -原始文档包的 traceability.json 使用 gzip 保存为 .json.gz;validation-report.json 使用 gzip + Base64 分段保存在 [validation-report/](validation-report/README.md),该目录说明如何恢复原始 JSON。解压后的内容与原包逐字节一致;Markdown 追踪表与检查摘要保留直接可读版本。仓库路径与文件校验值见 [package-manifest.json](package-manifest.json)。此打包调整不改变任何 Requirement、Scenario 或实施任务。 +原始文档包的 traceability.json 使用 gzip 保存为 .json.gz;validation-report.json 使用 gzip + Base64 分段保存在 [validation-report/](validation-report/README.md),该目录说明如何恢复原始 JSON。两份解压后的 JSON 与原包逐字节一致;README 和检查摘要已按后续证据修订,当前文件校验值见 [package-manifest.json](package-manifest.json)。修订不改变任何 Requirement 或 Scenario。 diff --git a/docs/openclaw-integration/package-manifest.json b/docs/openclaw-integration/package-manifest.json index b6070a1..8483aa3 100644 --- a/docs/openclaw-integration/package-manifest.json +++ b/docs/openclaw-integration/package-manifest.json @@ -1 +1 @@ -{"scope":"repository documentation; paths relative to repository root; manifest excludes itself","source_package":"openclaw-java-sdk-openspec-draft-2026-09-20.zip","source_package_sha256":"f8eedbb0356b34ecde22584b57fdc9d375fa7409c36d6931b7faca36f4919468","files":{"docs/openclaw-integration/README.md":{"bytes":2635,"sha256":"2f795ec91ed8a83bd22907a2e334bd3ac3ad8a079b25c43b57ceff8251fb245b"},"docs/openclaw-integration/acceptance-plan.md":{"bytes":4591,"sha256":"4875a07fd14cd9771d610d221ab8e666bf2801341b3ccc21302627f06fa2089f"},"docs/openclaw-integration/baseline.json":{"bytes":3221,"sha256":"b5b13dd410d068a5b07b4c27be01658aa94bb626dce9beffc44ebce9565789ab"},"docs/openclaw-integration/coverage-baseline.md":{"bytes":4792,"sha256":"ae4b7783b718a268c697fdd85f1f24800f838cb1063ae90e4324c224efc7f820"},"docs/openclaw-integration/roadmap.md":{"bytes":3477,"sha256":"0348da728fc714498cab3f5796eabd38c45efd7d0df158db3fea34a508b2dd32"},"docs/openclaw-integration/source-register.md":{"bytes":5424,"sha256":"992bf67dd8da00cccaeaf4a93ed594b2877d832ed3015b402c3a4eabb0b523f0"},"docs/openclaw-integration/traceability.json.gz":{"bytes":3246,"sha256":"75386731e6f4b685d61a8c582e18edbdc86577e717039716c1c908f8422befcd","decompressed_sha256":"da585354d01fb0f687d764840f7512259de832896db051fe450ac667fd6bf6bb"},"docs/openclaw-integration/traceability.md":{"bytes":13478,"sha256":"cd1b647ab538953e299a1964e009fbb65b4212654dab678bfb05e4fd1bcd2a59"},"docs/openclaw-integration/validation-report/README.md":{"bytes":1113,"sha256":"b67e0eb4a969e742b6e30e35883dcac0c3cc15aca0005e6d66377b99995e2932"},"docs/openclaw-integration/validation-report/part-001.b64":{"bytes":2601,"sha256":"9570f3b3818b997c948cb9ee4a5c4885d664cacdfec18e0b3d1e9858ae695a32"},"docs/openclaw-integration/validation-report/part-002.b64":{"bytes":2601,"sha256":"d57ebdd3717bab8648f4f98a70430515d0750ebb38cd72a970e246ddeb049952"},"docs/openclaw-integration/validation-report/part-003.b64":{"bytes":2537,"sha256":"61a7c754d543e645ad6b705add8f183ac0e6605340f0993b9bc5cb4647fef85b"},"docs/openclaw-integration/validation-summary.md":{"bytes":1794,"sha256":"c91cc48304a3318a337ff7881d05caa1b699b252105984e6fbfb05c8fdf2f6b4"},"openspec/README.md":{"bytes":611,"sha256":"58a1b2615971f2c7fb56f069006b8559cf5cf1548c01b29c83758c894ec79f20"},"openspec/changes/add-agent-session-approval-control/.openspec.yaml":{"bytes":40,"sha256":"dc10040214104474c4e34e5b38359540c882aa7cfb6e7221e5d0614f1dba8fd7"},"openspec/changes/add-agent-session-approval-control/design.md":{"bytes":4797,"sha256":"95794f1f71841a3d6a5ca61d10bbffaf5be029f8284cf75ac4b6020e4564d3d1"},"openspec/changes/add-agent-session-approval-control/proposal.md":{"bytes":1936,"sha256":"da5665faa52a3e14e756e021e2b9dec56c5f6bb5d73af277e756050a4399c741"},"openspec/changes/add-agent-session-approval-control/specs/agent-lifecycle/spec.md":{"bytes":2664,"sha256":"0b12b0240d1a5d37bcaa8c69604ca53ca67c4a372440262d14ed01b0ffd1a174"},"openspec/changes/add-agent-session-approval-control/specs/approval-control/spec.md":{"bytes":2549,"sha256":"3b979ba5b34b8aa1e1fef3a216e663b5b194b7bce713092d73cc4eed83f0c09b"},"openspec/changes/add-agent-session-approval-control/specs/session-control/spec.md":{"bytes":2543,"sha256":"ecf939250f43f526c1d78a5a2bc2902e5889cf13474a7c80e440e7232d5c24fb"},"openspec/changes/add-agent-session-approval-control/tasks.md":{"bytes":3242,"sha256":"782b9f42a8b58fab966c04920d27a98ea77d588102594219572eae5b17cbad11"},"openspec/changes/add-gateway-operations/.openspec.yaml":{"bytes":40,"sha256":"dc10040214104474c4e34e5b38359540c882aa7cfb6e7221e5d0614f1dba8fd7"},"openspec/changes/add-gateway-operations/design.md":{"bytes":5441,"sha256":"d07d9f9c3c5da092be96a18f0e6c35be53fe06f2eda9f540ef993961be8f247d"},"openspec/changes/add-gateway-operations/proposal.md":{"bytes":2342,"sha256":"c6081bd3692307909e736b7d84ccc34828b4fa5152a118f86dc577fa6ac3d47f"},"openspec/changes/add-gateway-operations/specs/channel-node-control/spec.md":{"bytes":2663,"sha256":"4350182f113da6caff9cd0eb81f2cb5173be374bd2f6665e16a9f93111fb4649"},"openspec/changes/add-gateway-operations/specs/configuration-control/spec.md":{"bytes":2432,"sha256":"cf8839be9d8c9015cfb855422fcdfdfaee02275965f2b3a12b42ce4987b8b3c1"},"openspec/changes/add-gateway-operations/specs/cron-control/spec.md":{"bytes":2453,"sha256":"8f86038254595e09c705b4b680d41aed60b2332f019139e35b5a65c329774274"},"openspec/changes/add-gateway-operations/specs/skill-plugin-lifecycle/spec.md":{"bytes":2551,"sha256":"01ef9d030ab116a21bcca1ff7f8d9ced27968015939cd1bf4c2ed99955f445bd"},"openspec/changes/add-gateway-operations/specs/task-audit-artifacts/spec.md":{"bytes":2597,"sha256":"8d2cb83159ed06b09358d3f950ae20489ea964a864c289168ab2c5a8e57ffadb"},"openspec/changes/add-gateway-operations/specs/tool-model-catalogs/spec.md":{"bytes":2463,"sha256":"a424d99c94d69cb61fa9e3f0efeb9dc8c1702d37c397f789c3363a79066df547"},"openspec/changes/add-gateway-operations/tasks.md":{"bytes":5352,"sha256":"12b19adb7b2a84e0fc263e8a8378719d2f5978f2dc5f619f3c856eb70a66b4f5"},"openspec/changes/add-managed-gateway-client/.openspec.yaml":{"bytes":40,"sha256":"dc10040214104474c4e34e5b38359540c882aa7cfb6e7221e5d0614f1dba8fd7"},"openspec/changes/add-managed-gateway-client/design.md":{"bytes":5113,"sha256":"162801004ae85138dc1d03ecb0654506986c26053bfe6fa9e72704edb01de6a2"},"openspec/changes/add-managed-gateway-client/proposal.md":{"bytes":2019,"sha256":"a91469801a7becd8ab01272697394c1d44c367ac2ae0666814b6f6b5706a01cf"},"openspec/changes/add-managed-gateway-client/specs/gateway-recovery/spec.md":{"bytes":2762,"sha256":"af082acc14c97793b8f9231b500e86e8e5c77455ae04a88b0b24fdfa4ed3335e"},"openspec/changes/add-managed-gateway-client/specs/managed-rpc/spec.md":{"bytes":2624,"sha256":"6aa6031b61a113443b8d560e58baae1c041ddc465630b736fa9a23b1fdb4408d"},"openspec/changes/add-managed-gateway-client/specs/typed-event-delivery/spec.md":{"bytes":2613,"sha256":"c5def41f0c9510153b5eb773521778d6121cad2ca4b2bdc733e9cfaa40275552"},"openspec/changes/add-managed-gateway-client/tasks.md":{"bytes":3249,"sha256":"978d020d94027db3801c090dd7e86bbd65b2568c64880950320e57087ee96970"},"openspec/changes/add-optional-runtime-adapters/.openspec.yaml":{"bytes":40,"sha256":"dc10040214104474c4e34e5b38359540c882aa7cfb6e7221e5d0614f1dba8fd7"},"openspec/changes/add-optional-runtime-adapters/design.md":{"bytes":4940,"sha256":"65332fcd6d91ff4ca9e77d53f606caccec2795fae74160bb95d357da482546c9"},"openspec/changes/add-optional-runtime-adapters/proposal.md":{"bytes":2065,"sha256":"a32b0507234b8e78719cb7716dc484212797b3c0259daa76931bf2c7820b4b3e"},"openspec/changes/add-optional-runtime-adapters/specs/cli-typed-results/spec.md":{"bytes":2609,"sha256":"2f9836a84b4b5ae66abae680ef1ec52c35531029b4682a75cc5a3c2e8cc6c67f"},"openspec/changes/add-optional-runtime-adapters/specs/persistent-stdio-adapters/spec.md":{"bytes":2509,"sha256":"ea7d2f8599d97c4ccd8f23ada658f636be62d2bdb715ed82f026a22286a7a3db"},"openspec/changes/add-optional-runtime-adapters/specs/terminal-voice-adapters/spec.md":{"bytes":2620,"sha256":"77fbb21d872b83da1cda418e6a7e1d94b0ea496ac566e6808225f2031a1c39a0"},"openspec/changes/add-optional-runtime-adapters/tasks.md":{"bytes":3318,"sha256":"a86f42485573c87ffa97e3296c3c20cfc128b63db40166a28ee7daf48e1b9f0c"},"openspec/changes/establish-sdk-compatibility-governance/.openspec.yaml":{"bytes":40,"sha256":"dc10040214104474c4e34e5b38359540c882aa7cfb6e7221e5d0614f1dba8fd7"},"openspec/changes/establish-sdk-compatibility-governance/design.md":{"bytes":4395,"sha256":"5eef818703376fa417abdff26f2b3ce0bc5761f643f4378cf985abc49dc35e92"},"openspec/changes/establish-sdk-compatibility-governance/proposal.md":{"bytes":1789,"sha256":"88e18f4f66ebccace6da321cb7d0a6b4d788e8e84cc933ab3678a5389b459ed6"},"openspec/changes/establish-sdk-compatibility-governance/specs/sdk-compatibility-governance/spec.md":{"bytes":3830,"sha256":"3d14086cef101a78b83ef953e16cea13b4b341ca9c9552c62596ee9ab85131a1"},"openspec/changes/establish-sdk-compatibility-governance/tasks.md":{"bytes":2716,"sha256":"edd09e1dfd45f8f9b956ea4745b4cedad5686ce9cda5813c1cd463df3bf18e6a"},"openspec/changes/fix-openclaw-protocol-contracts/.openspec.yaml":{"bytes":40,"sha256":"dc10040214104474c4e34e5b38359540c882aa7cfb6e7221e5d0614f1dba8fd7"},"openspec/changes/fix-openclaw-protocol-contracts/design.md":{"bytes":5675,"sha256":"10966f9bc03d3b34138539aeeb4b7ad884b28763cc2290c1f95926b69335dbbb"},"openspec/changes/fix-openclaw-protocol-contracts/proposal.md":{"bytes":2418,"sha256":"11a51837e386f1068004c526673547610a5b84dca8b42fc6d9484da02cc9b270"},"openspec/changes/fix-openclaw-protocol-contracts/specs/gateway-chat-events/spec.md":{"bytes":2622,"sha256":"3564b6061b568c1d30577fc8b228243f21df756321de9e50dd4a763529afb5b9"},"openspec/changes/fix-openclaw-protocol-contracts/specs/gateway-device-auth/spec.md":{"bytes":2806,"sha256":"2a6d8d7d5202495cdace92ffd12a500ee9f0266a172aa4147852e4cf43ee2a4a"},"openspec/changes/fix-openclaw-protocol-contracts/specs/responses-streaming/spec.md":{"bytes":2695,"sha256":"1ca9b80db706c236ca32ae0acd8a02a190fc3644959aa58af4379035923c3b82"},"openspec/changes/fix-openclaw-protocol-contracts/specs/session-history-contract/spec.md":{"bytes":2651,"sha256":"7fcc7baab4e3d9f10dd86adb03e00f78b07a7f011747a744224ca3dadf89168c"},"openspec/changes/fix-openclaw-protocol-contracts/specs/tools-invoke-contract/spec.md":{"bytes":2681,"sha256":"f255110ecff5a9479b780ec81dce1c451d638fe69259196e0ef063c5343a62f1"},"openspec/changes/fix-openclaw-protocol-contracts/tasks.md":{"bytes":4698,"sha256":"fd7a21979c085430e70479494b8f87c88e9746cf277463628a93a92a7932130a"},"openspec/config.yaml":{"bytes":1862,"sha256":"151f5ce61678f2d47d19a1c21168936f7ad5c6f05adec25db6a0e8a70f1f8ba9"},"openspec/specs/.gitkeep":{"bytes":1,"sha256":"01ba4719c80b6fe911b091a7c05124b64eeece964e09c058ef8f9805daca546b"}},"split_report":{"path":"docs/openclaw-integration/validation-report","encoding":"concatenated-base64-of-gzip","original_bytes":127699,"original_sha256":"a689415d7e7c1a28cc50a97179c797adc29080b30f5ec929aa8ed23227a1a598","parts":3}} +{"scope":"repository documentation; paths relative to repository root; manifest excludes itself","source_package":"openclaw-java-sdk-openspec-draft-2026-09-20.zip","source_package_sha256":"f8eedbb0356b34ecde22584b57fdc9d375fa7409c36d6931b7faca36f4919468","files":{"docs/openclaw-integration/README.md":{"bytes":2754,"sha256":"e09c8dfbf1057f8fe176533e8d01f07bc52bcdce13c6941d835a5889ce03f55d"},"docs/openclaw-integration/acceptance-plan.md":{"bytes":4591,"sha256":"4875a07fd14cd9771d610d221ab8e666bf2801341b3ccc21302627f06fa2089f"},"docs/openclaw-integration/baseline.json":{"bytes":3221,"sha256":"b5b13dd410d068a5b07b4c27be01658aa94bb626dce9beffc44ebce9565789ab"},"docs/openclaw-integration/coverage-baseline.md":{"bytes":4792,"sha256":"ae4b7783b718a268c697fdd85f1f24800f838cb1063ae90e4324c224efc7f820"},"docs/openclaw-integration/roadmap.md":{"bytes":3477,"sha256":"0348da728fc714498cab3f5796eabd38c45efd7d0df158db3fea34a508b2dd32"},"docs/openclaw-integration/source-register.md":{"bytes":5424,"sha256":"992bf67dd8da00cccaeaf4a93ed594b2877d832ed3015b402c3a4eabb0b523f0"},"docs/openclaw-integration/traceability.json.gz":{"bytes":3246,"sha256":"75386731e6f4b685d61a8c582e18edbdc86577e717039716c1c908f8422befcd","decompressed_sha256":"da585354d01fb0f687d764840f7512259de832896db051fe450ac667fd6bf6bb"},"docs/openclaw-integration/traceability.md":{"bytes":13478,"sha256":"cd1b647ab538953e299a1964e009fbb65b4212654dab678bfb05e4fd1bcd2a59"},"docs/openclaw-integration/validation-report/README.md":{"bytes":1113,"sha256":"b67e0eb4a969e742b6e30e35883dcac0c3cc15aca0005e6d66377b99995e2932"},"docs/openclaw-integration/validation-report/part-001.b64":{"bytes":2601,"sha256":"9570f3b3818b997c948cb9ee4a5c4885d664cacdfec18e0b3d1e9858ae695a32"},"docs/openclaw-integration/validation-report/part-002.b64":{"bytes":2601,"sha256":"d57ebdd3717bab8648f4f98a70430515d0750ebb38cd72a970e246ddeb049952"},"docs/openclaw-integration/validation-report/part-003.b64":{"bytes":2537,"sha256":"61a7c754d543e645ad6b705add8f183ac0e6605340f0993b9bc5cb4647fef85b"},"docs/openclaw-integration/validation-summary.md":{"bytes":2043,"sha256":"af5f938cb551b5627e480f174a661c0aaead56a82958b84df5451cdfaaa6f44d"},"openspec/README.md":{"bytes":611,"sha256":"58a1b2615971f2c7fb56f069006b8559cf5cf1548c01b29c83758c894ec79f20"},"openspec/changes/add-agent-session-approval-control/.openspec.yaml":{"bytes":40,"sha256":"dc10040214104474c4e34e5b38359540c882aa7cfb6e7221e5d0614f1dba8fd7"},"openspec/changes/add-agent-session-approval-control/design.md":{"bytes":4797,"sha256":"95794f1f71841a3d6a5ca61d10bbffaf5be029f8284cf75ac4b6020e4564d3d1"},"openspec/changes/add-agent-session-approval-control/proposal.md":{"bytes":1936,"sha256":"da5665faa52a3e14e756e021e2b9dec56c5f6bb5d73af277e756050a4399c741"},"openspec/changes/add-agent-session-approval-control/specs/agent-lifecycle/spec.md":{"bytes":2664,"sha256":"0b12b0240d1a5d37bcaa8c69604ca53ca67c4a372440262d14ed01b0ffd1a174"},"openspec/changes/add-agent-session-approval-control/specs/approval-control/spec.md":{"bytes":2549,"sha256":"3b979ba5b34b8aa1e1fef3a216e663b5b194b7bce713092d73cc4eed83f0c09b"},"openspec/changes/add-agent-session-approval-control/specs/session-control/spec.md":{"bytes":2543,"sha256":"ecf939250f43f526c1d78a5a2bc2902e5889cf13474a7c80e440e7232d5c24fb"},"openspec/changes/add-agent-session-approval-control/tasks.md":{"bytes":3242,"sha256":"782b9f42a8b58fab966c04920d27a98ea77d588102594219572eae5b17cbad11"},"openspec/changes/add-gateway-operations/.openspec.yaml":{"bytes":40,"sha256":"dc10040214104474c4e34e5b38359540c882aa7cfb6e7221e5d0614f1dba8fd7"},"openspec/changes/add-gateway-operations/design.md":{"bytes":5441,"sha256":"d07d9f9c3c5da092be96a18f0e6c35be53fe06f2eda9f540ef993961be8f247d"},"openspec/changes/add-gateway-operations/proposal.md":{"bytes":2342,"sha256":"c6081bd3692307909e736b7d84ccc34828b4fa5152a118f86dc577fa6ac3d47f"},"openspec/changes/add-gateway-operations/specs/channel-node-control/spec.md":{"bytes":2663,"sha256":"4350182f113da6caff9cd0eb81f2cb5173be374bd2f6665e16a9f93111fb4649"},"openspec/changes/add-gateway-operations/specs/configuration-control/spec.md":{"bytes":2432,"sha256":"cf8839be9d8c9015cfb855422fcdfdfaee02275965f2b3a12b42ce4987b8b3c1"},"openspec/changes/add-gateway-operations/specs/cron-control/spec.md":{"bytes":2453,"sha256":"8f86038254595e09c705b4b680d41aed60b2332f019139e35b5a65c329774274"},"openspec/changes/add-gateway-operations/specs/skill-plugin-lifecycle/spec.md":{"bytes":2551,"sha256":"01ef9d030ab116a21bcca1ff7f8d9ced27968015939cd1bf4c2ed99955f445bd"},"openspec/changes/add-gateway-operations/specs/task-audit-artifacts/spec.md":{"bytes":2597,"sha256":"8d2cb83159ed06b09358d3f950ae20489ea964a864c289168ab2c5a8e57ffadb"},"openspec/changes/add-gateway-operations/specs/tool-model-catalogs/spec.md":{"bytes":2463,"sha256":"a424d99c94d69cb61fa9e3f0efeb9dc8c1702d37c397f789c3363a79066df547"},"openspec/changes/add-gateway-operations/tasks.md":{"bytes":5352,"sha256":"12b19adb7b2a84e0fc263e8a8378719d2f5978f2dc5f619f3c856eb70a66b4f5"},"openspec/changes/add-managed-gateway-client/.openspec.yaml":{"bytes":40,"sha256":"dc10040214104474c4e34e5b38359540c882aa7cfb6e7221e5d0614f1dba8fd7"},"openspec/changes/add-managed-gateway-client/design.md":{"bytes":5113,"sha256":"162801004ae85138dc1d03ecb0654506986c26053bfe6fa9e72704edb01de6a2"},"openspec/changes/add-managed-gateway-client/proposal.md":{"bytes":2019,"sha256":"a91469801a7becd8ab01272697394c1d44c367ac2ae0666814b6f6b5706a01cf"},"openspec/changes/add-managed-gateway-client/specs/gateway-recovery/spec.md":{"bytes":2762,"sha256":"af082acc14c97793b8f9231b500e86e8e5c77455ae04a88b0b24fdfa4ed3335e"},"openspec/changes/add-managed-gateway-client/specs/managed-rpc/spec.md":{"bytes":2624,"sha256":"6aa6031b61a113443b8d560e58baae1c041ddc465630b736fa9a23b1fdb4408d"},"openspec/changes/add-managed-gateway-client/specs/typed-event-delivery/spec.md":{"bytes":2613,"sha256":"c5def41f0c9510153b5eb773521778d6121cad2ca4b2bdc733e9cfaa40275552"},"openspec/changes/add-managed-gateway-client/tasks.md":{"bytes":3249,"sha256":"978d020d94027db3801c090dd7e86bbd65b2568c64880950320e57087ee96970"},"openspec/changes/add-optional-runtime-adapters/.openspec.yaml":{"bytes":40,"sha256":"dc10040214104474c4e34e5b38359540c882aa7cfb6e7221e5d0614f1dba8fd7"},"openspec/changes/add-optional-runtime-adapters/design.md":{"bytes":4940,"sha256":"65332fcd6d91ff4ca9e77d53f606caccec2795fae74160bb95d357da482546c9"},"openspec/changes/add-optional-runtime-adapters/proposal.md":{"bytes":2065,"sha256":"a32b0507234b8e78719cb7716dc484212797b3c0259daa76931bf2c7820b4b3e"},"openspec/changes/add-optional-runtime-adapters/specs/cli-typed-results/spec.md":{"bytes":2609,"sha256":"2f9836a84b4b5ae66abae680ef1ec52c35531029b4682a75cc5a3c2e8cc6c67f"},"openspec/changes/add-optional-runtime-adapters/specs/persistent-stdio-adapters/spec.md":{"bytes":2509,"sha256":"ea7d2f8599d97c4ccd8f23ada658f636be62d2bdb715ed82f026a22286a7a3db"},"openspec/changes/add-optional-runtime-adapters/specs/terminal-voice-adapters/spec.md":{"bytes":2620,"sha256":"77fbb21d872b83da1cda418e6a7e1d94b0ea496ac566e6808225f2031a1c39a0"},"openspec/changes/add-optional-runtime-adapters/tasks.md":{"bytes":3318,"sha256":"a86f42485573c87ffa97e3296c3c20cfc128b63db40166a28ee7daf48e1b9f0c"},"openspec/changes/establish-sdk-compatibility-governance/.openspec.yaml":{"bytes":40,"sha256":"dc10040214104474c4e34e5b38359540c882aa7cfb6e7221e5d0614f1dba8fd7"},"openspec/changes/establish-sdk-compatibility-governance/design.md":{"bytes":4395,"sha256":"5eef818703376fa417abdff26f2b3ce0bc5761f643f4378cf985abc49dc35e92"},"openspec/changes/establish-sdk-compatibility-governance/proposal.md":{"bytes":1789,"sha256":"88e18f4f66ebccace6da321cb7d0a6b4d788e8e84cc933ab3678a5389b459ed6"},"openspec/changes/establish-sdk-compatibility-governance/specs/sdk-compatibility-governance/spec.md":{"bytes":3830,"sha256":"3d14086cef101a78b83ef953e16cea13b4b341ca9c9552c62596ee9ab85131a1"},"openspec/changes/establish-sdk-compatibility-governance/tasks.md":{"bytes":3585,"sha256":"044621f43891cdff8ea6d23bd1626db3fba340439ca95b80b1ee3b7fde4d4d2c"},"openspec/changes/fix-openclaw-protocol-contracts/.openspec.yaml":{"bytes":40,"sha256":"dc10040214104474c4e34e5b38359540c882aa7cfb6e7221e5d0614f1dba8fd7"},"openspec/changes/fix-openclaw-protocol-contracts/design.md":{"bytes":5675,"sha256":"10966f9bc03d3b34138539aeeb4b7ad884b28763cc2290c1f95926b69335dbbb"},"openspec/changes/fix-openclaw-protocol-contracts/proposal.md":{"bytes":2418,"sha256":"11a51837e386f1068004c526673547610a5b84dca8b42fc6d9484da02cc9b270"},"openspec/changes/fix-openclaw-protocol-contracts/specs/gateway-chat-events/spec.md":{"bytes":2622,"sha256":"3564b6061b568c1d30577fc8b228243f21df756321de9e50dd4a763529afb5b9"},"openspec/changes/fix-openclaw-protocol-contracts/specs/gateway-device-auth/spec.md":{"bytes":2806,"sha256":"2a6d8d7d5202495cdace92ffd12a500ee9f0266a172aa4147852e4cf43ee2a4a"},"openspec/changes/fix-openclaw-protocol-contracts/specs/responses-streaming/spec.md":{"bytes":2695,"sha256":"1ca9b80db706c236ca32ae0acd8a02a190fc3644959aa58af4379035923c3b82"},"openspec/changes/fix-openclaw-protocol-contracts/specs/session-history-contract/spec.md":{"bytes":2651,"sha256":"7fcc7baab4e3d9f10dd86adb03e00f78b07a7f011747a744224ca3dadf89168c"},"openspec/changes/fix-openclaw-protocol-contracts/specs/tools-invoke-contract/spec.md":{"bytes":2681,"sha256":"f255110ecff5a9479b780ec81dce1c451d638fe69259196e0ef063c5343a62f1"},"openspec/changes/fix-openclaw-protocol-contracts/tasks.md":{"bytes":4698,"sha256":"fd7a21979c085430e70479494b8f87c88e9746cf277463628a93a92a7932130a"},"openspec/config.yaml":{"bytes":1862,"sha256":"151f5ce61678f2d47d19a1c21168936f7ad5c6f05adec25db6a0e8a70f1f8ba9"},"openspec/specs/.gitkeep":{"bytes":1,"sha256":"01ba4719c80b6fe911b091a7c05124b64eeece964e09c058ef8f9805daca546b"}},"split_report":{"path":"docs/openclaw-integration/validation-report","encoding":"concatenated-base64-of-gzip","original_bytes":127699,"original_sha256":"a689415d7e7c1a28cc50a97179c797adc29080b30f5ec929aa8ed23227a1a598","parts":3},"source_package_note":"The source package hash identifies the original 2026-09-20 bundle; README and validation-summary have since been updated in this repository."} diff --git a/docs/openclaw-integration/validation-summary.md b/docs/openclaw-integration/validation-summary.md index 55895c9..3059360 100644 --- a/docs/openclaw-integration/validation-summary.md +++ b/docs/openclaw-integration/validation-summary.md @@ -1,10 +1,10 @@ # 文档检查结果 -检查对象:OpenSpec 文档包 0.1.0-draft;下述结果记录首次文档编制阶段,仓库打包仅调整索引路径并无损压缩详细 JSON 报告。 +检查对象:OpenSpec 文档包 0.1.0-draft。本页先保留首次文档编制的检查记录,再列出后续 G0 证据和当前校验;压缩报告只对应首次检查。 ## 实际执行 -使用本次编写的文档结构检查器,对全部生成文件检查必需产物、schema/metadata、proposal 与 capability 的一一对应、Purpose 长度、Requirement/Scenario 格式、规范关键词、任务验收条件、未勾选状态、全局 ID 唯一性、场景到任务的引用、依赖无环、相对链接和代码围栏。 +首次编制时使用文档结构检查器,检查必需产物、schema/metadata、proposal 与 capability 的一一对应、Purpose 长度、Requirement/Scenario 格式、规范关键词、任务验收条件、初始任务状态、全局 ID 唯一性、场景到任务的引用、依赖无环、相对链接和代码围栏。 结果:内部结构检查通过,0 项失败;精确检查数量以 validation-report/ 中保存的完整报告为准。 @@ -17,16 +17,17 @@ | Requirements | 64 | | Scenarios | 128 | | 实施任务 | 97 | -| 已完成实施任务 | 0 | +| 已勾选 G0 准入证据任务 | 5 | +| 待完成任务 | 92 | -## 尚未执行 +## 后续验证与剩余门禁 -官方 OpenSpec CLI validate:NOT_RUN。当前环境未安装 openspec,可联网安装尝试的 npm registry 查询因 EAI_AGAIN/DNS 解析失败而停止。CLI 版本未固定,不能声称官方 strict 校验通过。 +首次编制时官方 OpenSpec CLI 校验为 NOT_RUN;后续 G0 证据提交使用 OpenSpec 1.8.0 strict 校验 6/6 通过。2026-11-18 使用 OpenSpec 1.14.1 对本分支执行 `openspec validate --all --strict --no-interactive --json`,6/6 changes 有效,0 个 issues。 -Maven 构建、codegraph 索引、真实 Gateway 集成、漏洞扫描、资源/堆分析:均为 NOT_RUN。首次文档编制阶段没有修改用户电脑、GitHub 仓库或 SDK 代码;本次文档提交不包含 SDK 实现。 +后续 G0 证据还记录了三分支 CodeGraph、Maven 构建和测试,详情及当时的 SDK SHA 见 `openspec/changes/establish-sdk-compatibility-governance/evidence/2026-09-20-precursor-evidence.md`。这些历史结果未覆盖本次之后的源码;真实 Gateway 集成、漏洞扫描、资源/堆分析仍为 NOT_RUN。本次文档 PR 不包含 SDK 实现。 ## 阶段结论 -文档结构及引用检查通过,内容保持 DRAFT / REVIEW_REQUIRED。目标 Gateway 版本锁定、官方 CLI 校验、人审及所有实施验收仍未完成。评审应先从 G0 兼容治理和 G1 现有协议修正开始,而不是直接执行 G4/G5 的全部功能扩展。 +文档结构检查和当前 OpenSpec strict 校验通过,内容保持 DRAFT / REVIEW_REQUIRED。目标 Gateway 版本已有记录但待人审确认;G0 剩余任务、真实 Gateway 验证及全部 SDK 功能验收仍未完成。评审先从 G0 兼容治理和 G1 现有协议修正开始。 详细逐项输出见 [完整报告与恢复说明](validation-report/README.md)。 From e2c76c768417b12b221567d72bbec0f0cb11243c Mon Sep 17 00:00:00 2001 From: loong10k <20489781+loong10k@users.noreply.github.com> Date: Wed, 18 Nov 2026 06:28:52 +0800 Subject: [PATCH 04/22] docs: align OpenClaw roadmap with G0 evidence --- docs/openclaw-integration/package-manifest.json | 2 +- docs/openclaw-integration/roadmap.md | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/openclaw-integration/package-manifest.json b/docs/openclaw-integration/package-manifest.json index 8483aa3..cd32fe2 100644 --- a/docs/openclaw-integration/package-manifest.json +++ b/docs/openclaw-integration/package-manifest.json @@ -1 +1 @@ -{"scope":"repository documentation; paths relative to repository root; manifest excludes itself","source_package":"openclaw-java-sdk-openspec-draft-2026-09-20.zip","source_package_sha256":"f8eedbb0356b34ecde22584b57fdc9d375fa7409c36d6931b7faca36f4919468","files":{"docs/openclaw-integration/README.md":{"bytes":2754,"sha256":"e09c8dfbf1057f8fe176533e8d01f07bc52bcdce13c6941d835a5889ce03f55d"},"docs/openclaw-integration/acceptance-plan.md":{"bytes":4591,"sha256":"4875a07fd14cd9771d610d221ab8e666bf2801341b3ccc21302627f06fa2089f"},"docs/openclaw-integration/baseline.json":{"bytes":3221,"sha256":"b5b13dd410d068a5b07b4c27be01658aa94bb626dce9beffc44ebce9565789ab"},"docs/openclaw-integration/coverage-baseline.md":{"bytes":4792,"sha256":"ae4b7783b718a268c697fdd85f1f24800f838cb1063ae90e4324c224efc7f820"},"docs/openclaw-integration/roadmap.md":{"bytes":3477,"sha256":"0348da728fc714498cab3f5796eabd38c45efd7d0df158db3fea34a508b2dd32"},"docs/openclaw-integration/source-register.md":{"bytes":5424,"sha256":"992bf67dd8da00cccaeaf4a93ed594b2877d832ed3015b402c3a4eabb0b523f0"},"docs/openclaw-integration/traceability.json.gz":{"bytes":3246,"sha256":"75386731e6f4b685d61a8c582e18edbdc86577e717039716c1c908f8422befcd","decompressed_sha256":"da585354d01fb0f687d764840f7512259de832896db051fe450ac667fd6bf6bb"},"docs/openclaw-integration/traceability.md":{"bytes":13478,"sha256":"cd1b647ab538953e299a1964e009fbb65b4212654dab678bfb05e4fd1bcd2a59"},"docs/openclaw-integration/validation-report/README.md":{"bytes":1113,"sha256":"b67e0eb4a969e742b6e30e35883dcac0c3cc15aca0005e6d66377b99995e2932"},"docs/openclaw-integration/validation-report/part-001.b64":{"bytes":2601,"sha256":"9570f3b3818b997c948cb9ee4a5c4885d664cacdfec18e0b3d1e9858ae695a32"},"docs/openclaw-integration/validation-report/part-002.b64":{"bytes":2601,"sha256":"d57ebdd3717bab8648f4f98a70430515d0750ebb38cd72a970e246ddeb049952"},"docs/openclaw-integration/validation-report/part-003.b64":{"bytes":2537,"sha256":"61a7c754d543e645ad6b705add8f183ac0e6605340f0993b9bc5cb4647fef85b"},"docs/openclaw-integration/validation-summary.md":{"bytes":2043,"sha256":"af5f938cb551b5627e480f174a661c0aaead56a82958b84df5451cdfaaa6f44d"},"openspec/README.md":{"bytes":611,"sha256":"58a1b2615971f2c7fb56f069006b8559cf5cf1548c01b29c83758c894ec79f20"},"openspec/changes/add-agent-session-approval-control/.openspec.yaml":{"bytes":40,"sha256":"dc10040214104474c4e34e5b38359540c882aa7cfb6e7221e5d0614f1dba8fd7"},"openspec/changes/add-agent-session-approval-control/design.md":{"bytes":4797,"sha256":"95794f1f71841a3d6a5ca61d10bbffaf5be029f8284cf75ac4b6020e4564d3d1"},"openspec/changes/add-agent-session-approval-control/proposal.md":{"bytes":1936,"sha256":"da5665faa52a3e14e756e021e2b9dec56c5f6bb5d73af277e756050a4399c741"},"openspec/changes/add-agent-session-approval-control/specs/agent-lifecycle/spec.md":{"bytes":2664,"sha256":"0b12b0240d1a5d37bcaa8c69604ca53ca67c4a372440262d14ed01b0ffd1a174"},"openspec/changes/add-agent-session-approval-control/specs/approval-control/spec.md":{"bytes":2549,"sha256":"3b979ba5b34b8aa1e1fef3a216e663b5b194b7bce713092d73cc4eed83f0c09b"},"openspec/changes/add-agent-session-approval-control/specs/session-control/spec.md":{"bytes":2543,"sha256":"ecf939250f43f526c1d78a5a2bc2902e5889cf13474a7c80e440e7232d5c24fb"},"openspec/changes/add-agent-session-approval-control/tasks.md":{"bytes":3242,"sha256":"782b9f42a8b58fab966c04920d27a98ea77d588102594219572eae5b17cbad11"},"openspec/changes/add-gateway-operations/.openspec.yaml":{"bytes":40,"sha256":"dc10040214104474c4e34e5b38359540c882aa7cfb6e7221e5d0614f1dba8fd7"},"openspec/changes/add-gateway-operations/design.md":{"bytes":5441,"sha256":"d07d9f9c3c5da092be96a18f0e6c35be53fe06f2eda9f540ef993961be8f247d"},"openspec/changes/add-gateway-operations/proposal.md":{"bytes":2342,"sha256":"c6081bd3692307909e736b7d84ccc34828b4fa5152a118f86dc577fa6ac3d47f"},"openspec/changes/add-gateway-operations/specs/channel-node-control/spec.md":{"bytes":2663,"sha256":"4350182f113da6caff9cd0eb81f2cb5173be374bd2f6665e16a9f93111fb4649"},"openspec/changes/add-gateway-operations/specs/configuration-control/spec.md":{"bytes":2432,"sha256":"cf8839be9d8c9015cfb855422fcdfdfaee02275965f2b3a12b42ce4987b8b3c1"},"openspec/changes/add-gateway-operations/specs/cron-control/spec.md":{"bytes":2453,"sha256":"8f86038254595e09c705b4b680d41aed60b2332f019139e35b5a65c329774274"},"openspec/changes/add-gateway-operations/specs/skill-plugin-lifecycle/spec.md":{"bytes":2551,"sha256":"01ef9d030ab116a21bcca1ff7f8d9ced27968015939cd1bf4c2ed99955f445bd"},"openspec/changes/add-gateway-operations/specs/task-audit-artifacts/spec.md":{"bytes":2597,"sha256":"8d2cb83159ed06b09358d3f950ae20489ea964a864c289168ab2c5a8e57ffadb"},"openspec/changes/add-gateway-operations/specs/tool-model-catalogs/spec.md":{"bytes":2463,"sha256":"a424d99c94d69cb61fa9e3f0efeb9dc8c1702d37c397f789c3363a79066df547"},"openspec/changes/add-gateway-operations/tasks.md":{"bytes":5352,"sha256":"12b19adb7b2a84e0fc263e8a8378719d2f5978f2dc5f619f3c856eb70a66b4f5"},"openspec/changes/add-managed-gateway-client/.openspec.yaml":{"bytes":40,"sha256":"dc10040214104474c4e34e5b38359540c882aa7cfb6e7221e5d0614f1dba8fd7"},"openspec/changes/add-managed-gateway-client/design.md":{"bytes":5113,"sha256":"162801004ae85138dc1d03ecb0654506986c26053bfe6fa9e72704edb01de6a2"},"openspec/changes/add-managed-gateway-client/proposal.md":{"bytes":2019,"sha256":"a91469801a7becd8ab01272697394c1d44c367ac2ae0666814b6f6b5706a01cf"},"openspec/changes/add-managed-gateway-client/specs/gateway-recovery/spec.md":{"bytes":2762,"sha256":"af082acc14c97793b8f9231b500e86e8e5c77455ae04a88b0b24fdfa4ed3335e"},"openspec/changes/add-managed-gateway-client/specs/managed-rpc/spec.md":{"bytes":2624,"sha256":"6aa6031b61a113443b8d560e58baae1c041ddc465630b736fa9a23b1fdb4408d"},"openspec/changes/add-managed-gateway-client/specs/typed-event-delivery/spec.md":{"bytes":2613,"sha256":"c5def41f0c9510153b5eb773521778d6121cad2ca4b2bdc733e9cfaa40275552"},"openspec/changes/add-managed-gateway-client/tasks.md":{"bytes":3249,"sha256":"978d020d94027db3801c090dd7e86bbd65b2568c64880950320e57087ee96970"},"openspec/changes/add-optional-runtime-adapters/.openspec.yaml":{"bytes":40,"sha256":"dc10040214104474c4e34e5b38359540c882aa7cfb6e7221e5d0614f1dba8fd7"},"openspec/changes/add-optional-runtime-adapters/design.md":{"bytes":4940,"sha256":"65332fcd6d91ff4ca9e77d53f606caccec2795fae74160bb95d357da482546c9"},"openspec/changes/add-optional-runtime-adapters/proposal.md":{"bytes":2065,"sha256":"a32b0507234b8e78719cb7716dc484212797b3c0259daa76931bf2c7820b4b3e"},"openspec/changes/add-optional-runtime-adapters/specs/cli-typed-results/spec.md":{"bytes":2609,"sha256":"2f9836a84b4b5ae66abae680ef1ec52c35531029b4682a75cc5a3c2e8cc6c67f"},"openspec/changes/add-optional-runtime-adapters/specs/persistent-stdio-adapters/spec.md":{"bytes":2509,"sha256":"ea7d2f8599d97c4ccd8f23ada658f636be62d2bdb715ed82f026a22286a7a3db"},"openspec/changes/add-optional-runtime-adapters/specs/terminal-voice-adapters/spec.md":{"bytes":2620,"sha256":"77fbb21d872b83da1cda418e6a7e1d94b0ea496ac566e6808225f2031a1c39a0"},"openspec/changes/add-optional-runtime-adapters/tasks.md":{"bytes":3318,"sha256":"a86f42485573c87ffa97e3296c3c20cfc128b63db40166a28ee7daf48e1b9f0c"},"openspec/changes/establish-sdk-compatibility-governance/.openspec.yaml":{"bytes":40,"sha256":"dc10040214104474c4e34e5b38359540c882aa7cfb6e7221e5d0614f1dba8fd7"},"openspec/changes/establish-sdk-compatibility-governance/design.md":{"bytes":4395,"sha256":"5eef818703376fa417abdff26f2b3ce0bc5761f643f4378cf985abc49dc35e92"},"openspec/changes/establish-sdk-compatibility-governance/proposal.md":{"bytes":1789,"sha256":"88e18f4f66ebccace6da321cb7d0a6b4d788e8e84cc933ab3678a5389b459ed6"},"openspec/changes/establish-sdk-compatibility-governance/specs/sdk-compatibility-governance/spec.md":{"bytes":3830,"sha256":"3d14086cef101a78b83ef953e16cea13b4b341ca9c9552c62596ee9ab85131a1"},"openspec/changes/establish-sdk-compatibility-governance/tasks.md":{"bytes":3585,"sha256":"044621f43891cdff8ea6d23bd1626db3fba340439ca95b80b1ee3b7fde4d4d2c"},"openspec/changes/fix-openclaw-protocol-contracts/.openspec.yaml":{"bytes":40,"sha256":"dc10040214104474c4e34e5b38359540c882aa7cfb6e7221e5d0614f1dba8fd7"},"openspec/changes/fix-openclaw-protocol-contracts/design.md":{"bytes":5675,"sha256":"10966f9bc03d3b34138539aeeb4b7ad884b28763cc2290c1f95926b69335dbbb"},"openspec/changes/fix-openclaw-protocol-contracts/proposal.md":{"bytes":2418,"sha256":"11a51837e386f1068004c526673547610a5b84dca8b42fc6d9484da02cc9b270"},"openspec/changes/fix-openclaw-protocol-contracts/specs/gateway-chat-events/spec.md":{"bytes":2622,"sha256":"3564b6061b568c1d30577fc8b228243f21df756321de9e50dd4a763529afb5b9"},"openspec/changes/fix-openclaw-protocol-contracts/specs/gateway-device-auth/spec.md":{"bytes":2806,"sha256":"2a6d8d7d5202495cdace92ffd12a500ee9f0266a172aa4147852e4cf43ee2a4a"},"openspec/changes/fix-openclaw-protocol-contracts/specs/responses-streaming/spec.md":{"bytes":2695,"sha256":"1ca9b80db706c236ca32ae0acd8a02a190fc3644959aa58af4379035923c3b82"},"openspec/changes/fix-openclaw-protocol-contracts/specs/session-history-contract/spec.md":{"bytes":2651,"sha256":"7fcc7baab4e3d9f10dd86adb03e00f78b07a7f011747a744224ca3dadf89168c"},"openspec/changes/fix-openclaw-protocol-contracts/specs/tools-invoke-contract/spec.md":{"bytes":2681,"sha256":"f255110ecff5a9479b780ec81dce1c451d638fe69259196e0ef063c5343a62f1"},"openspec/changes/fix-openclaw-protocol-contracts/tasks.md":{"bytes":4698,"sha256":"fd7a21979c085430e70479494b8f87c88e9746cf277463628a93a92a7932130a"},"openspec/config.yaml":{"bytes":1862,"sha256":"151f5ce61678f2d47d19a1c21168936f7ad5c6f05adec25db6a0e8a70f1f8ba9"},"openspec/specs/.gitkeep":{"bytes":1,"sha256":"01ba4719c80b6fe911b091a7c05124b64eeece964e09c058ef8f9805daca546b"}},"split_report":{"path":"docs/openclaw-integration/validation-report","encoding":"concatenated-base64-of-gzip","original_bytes":127699,"original_sha256":"a689415d7e7c1a28cc50a97179c797adc29080b30f5ec929aa8ed23227a1a598","parts":3},"source_package_note":"The source package hash identifies the original 2026-09-20 bundle; README and validation-summary have since been updated in this repository."} +{"scope":"repository documentation; paths relative to repository root; manifest excludes itself","source_package":"openclaw-java-sdk-openspec-draft-2026-09-20.zip","source_package_sha256":"f8eedbb0356b34ecde22584b57fdc9d375fa7409c36d6931b7faca36f4919468","files":{"docs/openclaw-integration/README.md":{"bytes":2754,"sha256":"e09c8dfbf1057f8fe176533e8d01f07bc52bcdce13c6941d835a5889ce03f55d"},"docs/openclaw-integration/acceptance-plan.md":{"bytes":4591,"sha256":"4875a07fd14cd9771d610d221ab8e666bf2801341b3ccc21302627f06fa2089f"},"docs/openclaw-integration/baseline.json":{"bytes":3221,"sha256":"b5b13dd410d068a5b07b4c27be01658aa94bb626dce9beffc44ebce9565789ab"},"docs/openclaw-integration/coverage-baseline.md":{"bytes":4792,"sha256":"ae4b7783b718a268c697fdd85f1f24800f838cb1063ae90e4324c224efc7f820"},"docs/openclaw-integration/roadmap.md":{"bytes":3616,"sha256":"a4567d5ded5f24921d0d194c0dd4ba6f9039ac00f3273a25b94dcea5ae78aa91"},"docs/openclaw-integration/source-register.md":{"bytes":5424,"sha256":"992bf67dd8da00cccaeaf4a93ed594b2877d832ed3015b402c3a4eabb0b523f0"},"docs/openclaw-integration/traceability.json.gz":{"bytes":3246,"sha256":"75386731e6f4b685d61a8c582e18edbdc86577e717039716c1c908f8422befcd","decompressed_sha256":"da585354d01fb0f687d764840f7512259de832896db051fe450ac667fd6bf6bb"},"docs/openclaw-integration/traceability.md":{"bytes":13478,"sha256":"cd1b647ab538953e299a1964e009fbb65b4212654dab678bfb05e4fd1bcd2a59"},"docs/openclaw-integration/validation-report/README.md":{"bytes":1113,"sha256":"b67e0eb4a969e742b6e30e35883dcac0c3cc15aca0005e6d66377b99995e2932"},"docs/openclaw-integration/validation-report/part-001.b64":{"bytes":2601,"sha256":"9570f3b3818b997c948cb9ee4a5c4885d664cacdfec18e0b3d1e9858ae695a32"},"docs/openclaw-integration/validation-report/part-002.b64":{"bytes":2601,"sha256":"d57ebdd3717bab8648f4f98a70430515d0750ebb38cd72a970e246ddeb049952"},"docs/openclaw-integration/validation-report/part-003.b64":{"bytes":2537,"sha256":"61a7c754d543e645ad6b705add8f183ac0e6605340f0993b9bc5cb4647fef85b"},"docs/openclaw-integration/validation-summary.md":{"bytes":2043,"sha256":"af5f938cb551b5627e480f174a661c0aaead56a82958b84df5451cdfaaa6f44d"},"openspec/README.md":{"bytes":611,"sha256":"58a1b2615971f2c7fb56f069006b8559cf5cf1548c01b29c83758c894ec79f20"},"openspec/changes/add-agent-session-approval-control/.openspec.yaml":{"bytes":40,"sha256":"dc10040214104474c4e34e5b38359540c882aa7cfb6e7221e5d0614f1dba8fd7"},"openspec/changes/add-agent-session-approval-control/design.md":{"bytes":4797,"sha256":"95794f1f71841a3d6a5ca61d10bbffaf5be029f8284cf75ac4b6020e4564d3d1"},"openspec/changes/add-agent-session-approval-control/proposal.md":{"bytes":1936,"sha256":"da5665faa52a3e14e756e021e2b9dec56c5f6bb5d73af277e756050a4399c741"},"openspec/changes/add-agent-session-approval-control/specs/agent-lifecycle/spec.md":{"bytes":2664,"sha256":"0b12b0240d1a5d37bcaa8c69604ca53ca67c4a372440262d14ed01b0ffd1a174"},"openspec/changes/add-agent-session-approval-control/specs/approval-control/spec.md":{"bytes":2549,"sha256":"3b979ba5b34b8aa1e1fef3a216e663b5b194b7bce713092d73cc4eed83f0c09b"},"openspec/changes/add-agent-session-approval-control/specs/session-control/spec.md":{"bytes":2543,"sha256":"ecf939250f43f526c1d78a5a2bc2902e5889cf13474a7c80e440e7232d5c24fb"},"openspec/changes/add-agent-session-approval-control/tasks.md":{"bytes":3242,"sha256":"782b9f42a8b58fab966c04920d27a98ea77d588102594219572eae5b17cbad11"},"openspec/changes/add-gateway-operations/.openspec.yaml":{"bytes":40,"sha256":"dc10040214104474c4e34e5b38359540c882aa7cfb6e7221e5d0614f1dba8fd7"},"openspec/changes/add-gateway-operations/design.md":{"bytes":5441,"sha256":"d07d9f9c3c5da092be96a18f0e6c35be53fe06f2eda9f540ef993961be8f247d"},"openspec/changes/add-gateway-operations/proposal.md":{"bytes":2342,"sha256":"c6081bd3692307909e736b7d84ccc34828b4fa5152a118f86dc577fa6ac3d47f"},"openspec/changes/add-gateway-operations/specs/channel-node-control/spec.md":{"bytes":2663,"sha256":"4350182f113da6caff9cd0eb81f2cb5173be374bd2f6665e16a9f93111fb4649"},"openspec/changes/add-gateway-operations/specs/configuration-control/spec.md":{"bytes":2432,"sha256":"cf8839be9d8c9015cfb855422fcdfdfaee02275965f2b3a12b42ce4987b8b3c1"},"openspec/changes/add-gateway-operations/specs/cron-control/spec.md":{"bytes":2453,"sha256":"8f86038254595e09c705b4b680d41aed60b2332f019139e35b5a65c329774274"},"openspec/changes/add-gateway-operations/specs/skill-plugin-lifecycle/spec.md":{"bytes":2551,"sha256":"01ef9d030ab116a21bcca1ff7f8d9ced27968015939cd1bf4c2ed99955f445bd"},"openspec/changes/add-gateway-operations/specs/task-audit-artifacts/spec.md":{"bytes":2597,"sha256":"8d2cb83159ed06b09358d3f950ae20489ea964a864c289168ab2c5a8e57ffadb"},"openspec/changes/add-gateway-operations/specs/tool-model-catalogs/spec.md":{"bytes":2463,"sha256":"a424d99c94d69cb61fa9e3f0efeb9dc8c1702d37c397f789c3363a79066df547"},"openspec/changes/add-gateway-operations/tasks.md":{"bytes":5352,"sha256":"12b19adb7b2a84e0fc263e8a8378719d2f5978f2dc5f619f3c856eb70a66b4f5"},"openspec/changes/add-managed-gateway-client/.openspec.yaml":{"bytes":40,"sha256":"dc10040214104474c4e34e5b38359540c882aa7cfb6e7221e5d0614f1dba8fd7"},"openspec/changes/add-managed-gateway-client/design.md":{"bytes":5113,"sha256":"162801004ae85138dc1d03ecb0654506986c26053bfe6fa9e72704edb01de6a2"},"openspec/changes/add-managed-gateway-client/proposal.md":{"bytes":2019,"sha256":"a91469801a7becd8ab01272697394c1d44c367ac2ae0666814b6f6b5706a01cf"},"openspec/changes/add-managed-gateway-client/specs/gateway-recovery/spec.md":{"bytes":2762,"sha256":"af082acc14c97793b8f9231b500e86e8e5c77455ae04a88b0b24fdfa4ed3335e"},"openspec/changes/add-managed-gateway-client/specs/managed-rpc/spec.md":{"bytes":2624,"sha256":"6aa6031b61a113443b8d560e58baae1c041ddc465630b736fa9a23b1fdb4408d"},"openspec/changes/add-managed-gateway-client/specs/typed-event-delivery/spec.md":{"bytes":2613,"sha256":"c5def41f0c9510153b5eb773521778d6121cad2ca4b2bdc733e9cfaa40275552"},"openspec/changes/add-managed-gateway-client/tasks.md":{"bytes":3249,"sha256":"978d020d94027db3801c090dd7e86bbd65b2568c64880950320e57087ee96970"},"openspec/changes/add-optional-runtime-adapters/.openspec.yaml":{"bytes":40,"sha256":"dc10040214104474c4e34e5b38359540c882aa7cfb6e7221e5d0614f1dba8fd7"},"openspec/changes/add-optional-runtime-adapters/design.md":{"bytes":4940,"sha256":"65332fcd6d91ff4ca9e77d53f606caccec2795fae74160bb95d357da482546c9"},"openspec/changes/add-optional-runtime-adapters/proposal.md":{"bytes":2065,"sha256":"a32b0507234b8e78719cb7716dc484212797b3c0259daa76931bf2c7820b4b3e"},"openspec/changes/add-optional-runtime-adapters/specs/cli-typed-results/spec.md":{"bytes":2609,"sha256":"2f9836a84b4b5ae66abae680ef1ec52c35531029b4682a75cc5a3c2e8cc6c67f"},"openspec/changes/add-optional-runtime-adapters/specs/persistent-stdio-adapters/spec.md":{"bytes":2509,"sha256":"ea7d2f8599d97c4ccd8f23ada658f636be62d2bdb715ed82f026a22286a7a3db"},"openspec/changes/add-optional-runtime-adapters/specs/terminal-voice-adapters/spec.md":{"bytes":2620,"sha256":"77fbb21d872b83da1cda418e6a7e1d94b0ea496ac566e6808225f2031a1c39a0"},"openspec/changes/add-optional-runtime-adapters/tasks.md":{"bytes":3318,"sha256":"a86f42485573c87ffa97e3296c3c20cfc128b63db40166a28ee7daf48e1b9f0c"},"openspec/changes/establish-sdk-compatibility-governance/.openspec.yaml":{"bytes":40,"sha256":"dc10040214104474c4e34e5b38359540c882aa7cfb6e7221e5d0614f1dba8fd7"},"openspec/changes/establish-sdk-compatibility-governance/design.md":{"bytes":4395,"sha256":"5eef818703376fa417abdff26f2b3ce0bc5761f643f4378cf985abc49dc35e92"},"openspec/changes/establish-sdk-compatibility-governance/proposal.md":{"bytes":1789,"sha256":"88e18f4f66ebccace6da321cb7d0a6b4d788e8e84cc933ab3678a5389b459ed6"},"openspec/changes/establish-sdk-compatibility-governance/specs/sdk-compatibility-governance/spec.md":{"bytes":3830,"sha256":"3d14086cef101a78b83ef953e16cea13b4b341ca9c9552c62596ee9ab85131a1"},"openspec/changes/establish-sdk-compatibility-governance/tasks.md":{"bytes":3585,"sha256":"044621f43891cdff8ea6d23bd1626db3fba340439ca95b80b1ee3b7fde4d4d2c"},"openspec/changes/fix-openclaw-protocol-contracts/.openspec.yaml":{"bytes":40,"sha256":"dc10040214104474c4e34e5b38359540c882aa7cfb6e7221e5d0614f1dba8fd7"},"openspec/changes/fix-openclaw-protocol-contracts/design.md":{"bytes":5675,"sha256":"10966f9bc03d3b34138539aeeb4b7ad884b28763cc2290c1f95926b69335dbbb"},"openspec/changes/fix-openclaw-protocol-contracts/proposal.md":{"bytes":2418,"sha256":"11a51837e386f1068004c526673547610a5b84dca8b42fc6d9484da02cc9b270"},"openspec/changes/fix-openclaw-protocol-contracts/specs/gateway-chat-events/spec.md":{"bytes":2622,"sha256":"3564b6061b568c1d30577fc8b228243f21df756321de9e50dd4a763529afb5b9"},"openspec/changes/fix-openclaw-protocol-contracts/specs/gateway-device-auth/spec.md":{"bytes":2806,"sha256":"2a6d8d7d5202495cdace92ffd12a500ee9f0266a172aa4147852e4cf43ee2a4a"},"openspec/changes/fix-openclaw-protocol-contracts/specs/responses-streaming/spec.md":{"bytes":2695,"sha256":"1ca9b80db706c236ca32ae0acd8a02a190fc3644959aa58af4379035923c3b82"},"openspec/changes/fix-openclaw-protocol-contracts/specs/session-history-contract/spec.md":{"bytes":2651,"sha256":"7fcc7baab4e3d9f10dd86adb03e00f78b07a7f011747a744224ca3dadf89168c"},"openspec/changes/fix-openclaw-protocol-contracts/specs/tools-invoke-contract/spec.md":{"bytes":2681,"sha256":"f255110ecff5a9479b780ec81dce1c451d638fe69259196e0ef063c5343a62f1"},"openspec/changes/fix-openclaw-protocol-contracts/tasks.md":{"bytes":4698,"sha256":"fd7a21979c085430e70479494b8f87c88e9746cf277463628a93a92a7932130a"},"openspec/config.yaml":{"bytes":1862,"sha256":"151f5ce61678f2d47d19a1c21168936f7ad5c6f05adec25db6a0e8a70f1f8ba9"},"openspec/specs/.gitkeep":{"bytes":1,"sha256":"01ba4719c80b6fe911b091a7c05124b64eeece964e09c058ef8f9805daca546b"}},"split_report":{"path":"docs/openclaw-integration/validation-report","encoding":"concatenated-base64-of-gzip","original_bytes":127699,"original_sha256":"a689415d7e7c1a28cc50a97179c797adc29080b30f5ec929aa8ed23227a1a598","parts":3},"source_package_note":"The source package hash identifies the original 2026-09-20 bundle; README and validation-summary have since been updated in this repository."} diff --git a/docs/openclaw-integration/roadmap.md b/docs/openclaw-integration/roadmap.md index 7d97a2a..59ef327 100644 --- a/docs/openclaw-integration/roadmap.md +++ b/docs/openclaw-integration/roadmap.md @@ -42,7 +42,7 @@ proposal 解释为什么、范围与破坏性变化;specs 只写外部行为 ## 准入状态 -人审:尚未发生。目标 Gateway 精确版本/提交:尚未锁定,阻断编码而不阻断文档评审。官方 OpenSpec CLI:当前环境未安装,尝试获取时发生网络/DNS 解析失败;其校验是待补项。自定义文档结构检查只说明文档内部结构与引用,不代替官方 CLI、编译或协议测试。 +人审:尚未发生。G0 证据已记录本机可获得的 OpenClaw `2026.7.1-2 (0790d9f)` 及来源,但协议 schema 和真实 Gateway 观察仍缺失,版本锁定待人审确认,G1 编码保持阻断。首次文档编制时 OpenSpec CLI 不可用;后续 G0 证据记录了 OpenSpec 1.8.0 strict 校验和三分支构建结果,2026-11-18 又以 OpenSpec 1.14.1 strict 校验 6/6 通过。CLI 格式校验和历史构建不代替当前 SDK 行为或真实 Gateway 验收。 ## 尚未纳入强承诺的扩展 From c9760eae36ab78047807cb880605a8c47f7e7871 Mon Sep 17 00:00:00 2001 From: loong10k <20489781+loong10k@users.noreply.github.com> Date: Wed, 18 Nov 2026 22:19:28 +0800 Subject: [PATCH 05/22] docs: record OpenClaw Gateway baseline across SDK lines --- docs/openclaw-integration/README.md | 4 +-- .../package-manifest.json | 2 +- docs/openclaw-integration/roadmap.md | 2 +- .../validation-summary.md | 8 ++--- .../evidence/2026-11-18-live-gateway.md | 30 +++++++++++++++++++ .../evidence/version-lock.md | 2 +- .../tasks.md | 10 +++++-- 7 files changed, 46 insertions(+), 12 deletions(-) create mode 100644 openspec/changes/establish-sdk-compatibility-governance/evidence/2026-11-18-live-gateway.md diff --git a/docs/openclaw-integration/README.md b/docs/openclaw-integration/README.md index 53b357d..dc3c451 100644 --- a/docs/openclaw-integration/README.md +++ b/docs/openclaw-integration/README.md @@ -2,7 +2,7 @@ 版本 0.1.0-draft · 2026-09-20 · **待评审,未实施,未归档** -这是一套仓库内的 OpenSpec 变更草案,不是仅供讨论的差距清单。包含六组 proposal/design/tasks、21 个 capability spec、64 条 Requirement 和 128 个 Scenario;任务共 97 项,其中 5 项 G0 准入证据任务已勾选,92 项待完成。SDK 功能尚未按这些草案实施;检查结果见 [文档检查结果](validation-summary.md)。 +这是一套仓库内的 OpenSpec 变更草案,不是仅供讨论的差距清单。包含六组 proposal/design/tasks、21 个 capability spec、64 条 Requirement 和 128 个 Scenario;任务共 97 项,其中 6 项 G0 准入证据任务已勾选,91 项待完成。SDK 功能尚未按这些草案实施;检查结果见 [文档检查结果](validation-summary.md)。 ## 阅读顺序 @@ -15,7 +15,7 @@ 本目录及 openspec/ 以独立文档提交交付;没有修改任何 SDK Java 源码、pom、依赖或现有测试。G0 已记录目标版本和来源,但该锁定仍待人审确认;G1 编码继续受评审门禁约束。 -首次文档编制时仅执行自定义结构检查;后续 G0 证据提交记录了三分支 CodeGraph、Maven 构建与测试,以及 OpenSpec 1.8.0 strict 校验。2026-11-18 使用 OpenSpec 1.14.1 对本分支再次执行 `openspec validate --all --strict --no-interactive --json`,6/6 changes 有效。上述构建证据对应 2026-09-20 的 SDK 提交,不证明当前源码或真实 Gateway 集成;真实 Gateway 测试仍未执行。 +首次文档编制时仅执行自定义结构检查;后续 G0 证据提交记录了三分支 CodeGraph、Maven 构建与测试,以及 OpenSpec 1.8.0 strict 校验。2026-11-18 使用 OpenSpec 1.14.1 对本分支再次执行 `openspec validate --all --strict --no-interactive --json`,6/6 changes 有效。历史构建证据对应 2026-09-20 的 SDK 提交。2026-11-18 补充了 [真实 Gateway 基线验证](../../openspec/changes/establish-sdk-compatibility-governance/evidence/2026-11-18-live-gateway.md),覆盖三条维护线并记录默认分支的兼容缺口。 ## 合入方式 diff --git a/docs/openclaw-integration/package-manifest.json b/docs/openclaw-integration/package-manifest.json index cd32fe2..acfa41f 100644 --- a/docs/openclaw-integration/package-manifest.json +++ b/docs/openclaw-integration/package-manifest.json @@ -1 +1 @@ -{"scope":"repository documentation; paths relative to repository root; manifest excludes itself","source_package":"openclaw-java-sdk-openspec-draft-2026-09-20.zip","source_package_sha256":"f8eedbb0356b34ecde22584b57fdc9d375fa7409c36d6931b7faca36f4919468","files":{"docs/openclaw-integration/README.md":{"bytes":2754,"sha256":"e09c8dfbf1057f8fe176533e8d01f07bc52bcdce13c6941d835a5889ce03f55d"},"docs/openclaw-integration/acceptance-plan.md":{"bytes":4591,"sha256":"4875a07fd14cd9771d610d221ab8e666bf2801341b3ccc21302627f06fa2089f"},"docs/openclaw-integration/baseline.json":{"bytes":3221,"sha256":"b5b13dd410d068a5b07b4c27be01658aa94bb626dce9beffc44ebce9565789ab"},"docs/openclaw-integration/coverage-baseline.md":{"bytes":4792,"sha256":"ae4b7783b718a268c697fdd85f1f24800f838cb1063ae90e4324c224efc7f820"},"docs/openclaw-integration/roadmap.md":{"bytes":3616,"sha256":"a4567d5ded5f24921d0d194c0dd4ba6f9039ac00f3273a25b94dcea5ae78aa91"},"docs/openclaw-integration/source-register.md":{"bytes":5424,"sha256":"992bf67dd8da00cccaeaf4a93ed594b2877d832ed3015b402c3a4eabb0b523f0"},"docs/openclaw-integration/traceability.json.gz":{"bytes":3246,"sha256":"75386731e6f4b685d61a8c582e18edbdc86577e717039716c1c908f8422befcd","decompressed_sha256":"da585354d01fb0f687d764840f7512259de832896db051fe450ac667fd6bf6bb"},"docs/openclaw-integration/traceability.md":{"bytes":13478,"sha256":"cd1b647ab538953e299a1964e009fbb65b4212654dab678bfb05e4fd1bcd2a59"},"docs/openclaw-integration/validation-report/README.md":{"bytes":1113,"sha256":"b67e0eb4a969e742b6e30e35883dcac0c3cc15aca0005e6d66377b99995e2932"},"docs/openclaw-integration/validation-report/part-001.b64":{"bytes":2601,"sha256":"9570f3b3818b997c948cb9ee4a5c4885d664cacdfec18e0b3d1e9858ae695a32"},"docs/openclaw-integration/validation-report/part-002.b64":{"bytes":2601,"sha256":"d57ebdd3717bab8648f4f98a70430515d0750ebb38cd72a970e246ddeb049952"},"docs/openclaw-integration/validation-report/part-003.b64":{"bytes":2537,"sha256":"61a7c754d543e645ad6b705add8f183ac0e6605340f0993b9bc5cb4647fef85b"},"docs/openclaw-integration/validation-summary.md":{"bytes":2043,"sha256":"af5f938cb551b5627e480f174a661c0aaead56a82958b84df5451cdfaaa6f44d"},"openspec/README.md":{"bytes":611,"sha256":"58a1b2615971f2c7fb56f069006b8559cf5cf1548c01b29c83758c894ec79f20"},"openspec/changes/add-agent-session-approval-control/.openspec.yaml":{"bytes":40,"sha256":"dc10040214104474c4e34e5b38359540c882aa7cfb6e7221e5d0614f1dba8fd7"},"openspec/changes/add-agent-session-approval-control/design.md":{"bytes":4797,"sha256":"95794f1f71841a3d6a5ca61d10bbffaf5be029f8284cf75ac4b6020e4564d3d1"},"openspec/changes/add-agent-session-approval-control/proposal.md":{"bytes":1936,"sha256":"da5665faa52a3e14e756e021e2b9dec56c5f6bb5d73af277e756050a4399c741"},"openspec/changes/add-agent-session-approval-control/specs/agent-lifecycle/spec.md":{"bytes":2664,"sha256":"0b12b0240d1a5d37bcaa8c69604ca53ca67c4a372440262d14ed01b0ffd1a174"},"openspec/changes/add-agent-session-approval-control/specs/approval-control/spec.md":{"bytes":2549,"sha256":"3b979ba5b34b8aa1e1fef3a216e663b5b194b7bce713092d73cc4eed83f0c09b"},"openspec/changes/add-agent-session-approval-control/specs/session-control/spec.md":{"bytes":2543,"sha256":"ecf939250f43f526c1d78a5a2bc2902e5889cf13474a7c80e440e7232d5c24fb"},"openspec/changes/add-agent-session-approval-control/tasks.md":{"bytes":3242,"sha256":"782b9f42a8b58fab966c04920d27a98ea77d588102594219572eae5b17cbad11"},"openspec/changes/add-gateway-operations/.openspec.yaml":{"bytes":40,"sha256":"dc10040214104474c4e34e5b38359540c882aa7cfb6e7221e5d0614f1dba8fd7"},"openspec/changes/add-gateway-operations/design.md":{"bytes":5441,"sha256":"d07d9f9c3c5da092be96a18f0e6c35be53fe06f2eda9f540ef993961be8f247d"},"openspec/changes/add-gateway-operations/proposal.md":{"bytes":2342,"sha256":"c6081bd3692307909e736b7d84ccc34828b4fa5152a118f86dc577fa6ac3d47f"},"openspec/changes/add-gateway-operations/specs/channel-node-control/spec.md":{"bytes":2663,"sha256":"4350182f113da6caff9cd0eb81f2cb5173be374bd2f6665e16a9f93111fb4649"},"openspec/changes/add-gateway-operations/specs/configuration-control/spec.md":{"bytes":2432,"sha256":"cf8839be9d8c9015cfb855422fcdfdfaee02275965f2b3a12b42ce4987b8b3c1"},"openspec/changes/add-gateway-operations/specs/cron-control/spec.md":{"bytes":2453,"sha256":"8f86038254595e09c705b4b680d41aed60b2332f019139e35b5a65c329774274"},"openspec/changes/add-gateway-operations/specs/skill-plugin-lifecycle/spec.md":{"bytes":2551,"sha256":"01ef9d030ab116a21bcca1ff7f8d9ced27968015939cd1bf4c2ed99955f445bd"},"openspec/changes/add-gateway-operations/specs/task-audit-artifacts/spec.md":{"bytes":2597,"sha256":"8d2cb83159ed06b09358d3f950ae20489ea964a864c289168ab2c5a8e57ffadb"},"openspec/changes/add-gateway-operations/specs/tool-model-catalogs/spec.md":{"bytes":2463,"sha256":"a424d99c94d69cb61fa9e3f0efeb9dc8c1702d37c397f789c3363a79066df547"},"openspec/changes/add-gateway-operations/tasks.md":{"bytes":5352,"sha256":"12b19adb7b2a84e0fc263e8a8378719d2f5978f2dc5f619f3c856eb70a66b4f5"},"openspec/changes/add-managed-gateway-client/.openspec.yaml":{"bytes":40,"sha256":"dc10040214104474c4e34e5b38359540c882aa7cfb6e7221e5d0614f1dba8fd7"},"openspec/changes/add-managed-gateway-client/design.md":{"bytes":5113,"sha256":"162801004ae85138dc1d03ecb0654506986c26053bfe6fa9e72704edb01de6a2"},"openspec/changes/add-managed-gateway-client/proposal.md":{"bytes":2019,"sha256":"a91469801a7becd8ab01272697394c1d44c367ac2ae0666814b6f6b5706a01cf"},"openspec/changes/add-managed-gateway-client/specs/gateway-recovery/spec.md":{"bytes":2762,"sha256":"af082acc14c97793b8f9231b500e86e8e5c77455ae04a88b0b24fdfa4ed3335e"},"openspec/changes/add-managed-gateway-client/specs/managed-rpc/spec.md":{"bytes":2624,"sha256":"6aa6031b61a113443b8d560e58baae1c041ddc465630b736fa9a23b1fdb4408d"},"openspec/changes/add-managed-gateway-client/specs/typed-event-delivery/spec.md":{"bytes":2613,"sha256":"c5def41f0c9510153b5eb773521778d6121cad2ca4b2bdc733e9cfaa40275552"},"openspec/changes/add-managed-gateway-client/tasks.md":{"bytes":3249,"sha256":"978d020d94027db3801c090dd7e86bbd65b2568c64880950320e57087ee96970"},"openspec/changes/add-optional-runtime-adapters/.openspec.yaml":{"bytes":40,"sha256":"dc10040214104474c4e34e5b38359540c882aa7cfb6e7221e5d0614f1dba8fd7"},"openspec/changes/add-optional-runtime-adapters/design.md":{"bytes":4940,"sha256":"65332fcd6d91ff4ca9e77d53f606caccec2795fae74160bb95d357da482546c9"},"openspec/changes/add-optional-runtime-adapters/proposal.md":{"bytes":2065,"sha256":"a32b0507234b8e78719cb7716dc484212797b3c0259daa76931bf2c7820b4b3e"},"openspec/changes/add-optional-runtime-adapters/specs/cli-typed-results/spec.md":{"bytes":2609,"sha256":"2f9836a84b4b5ae66abae680ef1ec52c35531029b4682a75cc5a3c2e8cc6c67f"},"openspec/changes/add-optional-runtime-adapters/specs/persistent-stdio-adapters/spec.md":{"bytes":2509,"sha256":"ea7d2f8599d97c4ccd8f23ada658f636be62d2bdb715ed82f026a22286a7a3db"},"openspec/changes/add-optional-runtime-adapters/specs/terminal-voice-adapters/spec.md":{"bytes":2620,"sha256":"77fbb21d872b83da1cda418e6a7e1d94b0ea496ac566e6808225f2031a1c39a0"},"openspec/changes/add-optional-runtime-adapters/tasks.md":{"bytes":3318,"sha256":"a86f42485573c87ffa97e3296c3c20cfc128b63db40166a28ee7daf48e1b9f0c"},"openspec/changes/establish-sdk-compatibility-governance/.openspec.yaml":{"bytes":40,"sha256":"dc10040214104474c4e34e5b38359540c882aa7cfb6e7221e5d0614f1dba8fd7"},"openspec/changes/establish-sdk-compatibility-governance/design.md":{"bytes":4395,"sha256":"5eef818703376fa417abdff26f2b3ce0bc5761f643f4378cf985abc49dc35e92"},"openspec/changes/establish-sdk-compatibility-governance/proposal.md":{"bytes":1789,"sha256":"88e18f4f66ebccace6da321cb7d0a6b4d788e8e84cc933ab3678a5389b459ed6"},"openspec/changes/establish-sdk-compatibility-governance/specs/sdk-compatibility-governance/spec.md":{"bytes":3830,"sha256":"3d14086cef101a78b83ef953e16cea13b4b341ca9c9552c62596ee9ab85131a1"},"openspec/changes/establish-sdk-compatibility-governance/tasks.md":{"bytes":3585,"sha256":"044621f43891cdff8ea6d23bd1626db3fba340439ca95b80b1ee3b7fde4d4d2c"},"openspec/changes/fix-openclaw-protocol-contracts/.openspec.yaml":{"bytes":40,"sha256":"dc10040214104474c4e34e5b38359540c882aa7cfb6e7221e5d0614f1dba8fd7"},"openspec/changes/fix-openclaw-protocol-contracts/design.md":{"bytes":5675,"sha256":"10966f9bc03d3b34138539aeeb4b7ad884b28763cc2290c1f95926b69335dbbb"},"openspec/changes/fix-openclaw-protocol-contracts/proposal.md":{"bytes":2418,"sha256":"11a51837e386f1068004c526673547610a5b84dca8b42fc6d9484da02cc9b270"},"openspec/changes/fix-openclaw-protocol-contracts/specs/gateway-chat-events/spec.md":{"bytes":2622,"sha256":"3564b6061b568c1d30577fc8b228243f21df756321de9e50dd4a763529afb5b9"},"openspec/changes/fix-openclaw-protocol-contracts/specs/gateway-device-auth/spec.md":{"bytes":2806,"sha256":"2a6d8d7d5202495cdace92ffd12a500ee9f0266a172aa4147852e4cf43ee2a4a"},"openspec/changes/fix-openclaw-protocol-contracts/specs/responses-streaming/spec.md":{"bytes":2695,"sha256":"1ca9b80db706c236ca32ae0acd8a02a190fc3644959aa58af4379035923c3b82"},"openspec/changes/fix-openclaw-protocol-contracts/specs/session-history-contract/spec.md":{"bytes":2651,"sha256":"7fcc7baab4e3d9f10dd86adb03e00f78b07a7f011747a744224ca3dadf89168c"},"openspec/changes/fix-openclaw-protocol-contracts/specs/tools-invoke-contract/spec.md":{"bytes":2681,"sha256":"f255110ecff5a9479b780ec81dce1c451d638fe69259196e0ef063c5343a62f1"},"openspec/changes/fix-openclaw-protocol-contracts/tasks.md":{"bytes":4698,"sha256":"fd7a21979c085430e70479494b8f87c88e9746cf277463628a93a92a7932130a"},"openspec/config.yaml":{"bytes":1862,"sha256":"151f5ce61678f2d47d19a1c21168936f7ad5c6f05adec25db6a0e8a70f1f8ba9"},"openspec/specs/.gitkeep":{"bytes":1,"sha256":"01ba4719c80b6fe911b091a7c05124b64eeece964e09c058ef8f9805daca546b"}},"split_report":{"path":"docs/openclaw-integration/validation-report","encoding":"concatenated-base64-of-gzip","original_bytes":127699,"original_sha256":"a689415d7e7c1a28cc50a97179c797adc29080b30f5ec929aa8ed23227a1a598","parts":3},"source_package_note":"The source package hash identifies the original 2026-09-20 bundle; README and validation-summary have since been updated in this repository."} +{"scope":"repository documentation; paths relative to repository root; manifest excludes itself","source_package":"openclaw-java-sdk-openspec-draft-2026-09-20.zip","source_package_sha256":"f8eedbb0356b34ecde22584b57fdc9d375fa7409c36d6931b7faca36f4919468","files":{"docs/openclaw-integration/README.md":{"bytes":2882,"sha256":"43b72643d133501a9da6fd56e855e64e1f440991204c05ea35bb8d199bdaa01b"},"docs/openclaw-integration/acceptance-plan.md":{"bytes":4591,"sha256":"4875a07fd14cd9771d610d221ab8e666bf2801341b3ccc21302627f06fa2089f"},"docs/openclaw-integration/baseline.json":{"bytes":3221,"sha256":"b5b13dd410d068a5b07b4c27be01658aa94bb626dce9beffc44ebce9565789ab"},"docs/openclaw-integration/coverage-baseline.md":{"bytes":4792,"sha256":"ae4b7783b718a268c697fdd85f1f24800f838cb1063ae90e4324c224efc7f820"},"docs/openclaw-integration/roadmap.md":{"bytes":3751,"sha256":"e78ff12efceab3020ceadbcc500dc2ae926ea102084fbf2005e306058da073d0"},"docs/openclaw-integration/source-register.md":{"bytes":5424,"sha256":"992bf67dd8da00cccaeaf4a93ed594b2877d832ed3015b402c3a4eabb0b523f0"},"docs/openclaw-integration/traceability.json.gz":{"bytes":3246,"sha256":"75386731e6f4b685d61a8c582e18edbdc86577e717039716c1c908f8422befcd","decompressed_sha256":"da585354d01fb0f687d764840f7512259de832896db051fe450ac667fd6bf6bb"},"docs/openclaw-integration/traceability.md":{"bytes":13478,"sha256":"cd1b647ab538953e299a1964e009fbb65b4212654dab678bfb05e4fd1bcd2a59"},"docs/openclaw-integration/validation-report/README.md":{"bytes":1113,"sha256":"b67e0eb4a969e742b6e30e35883dcac0c3cc15aca0005e6d66377b99995e2932"},"docs/openclaw-integration/validation-report/part-001.b64":{"bytes":2601,"sha256":"9570f3b3818b997c948cb9ee4a5c4885d664cacdfec18e0b3d1e9858ae695a32"},"docs/openclaw-integration/validation-report/part-002.b64":{"bytes":2601,"sha256":"d57ebdd3717bab8648f4f98a70430515d0750ebb38cd72a970e246ddeb049952"},"docs/openclaw-integration/validation-report/part-003.b64":{"bytes":2537,"sha256":"61a7c754d543e645ad6b705add8f183ac0e6605340f0993b9bc5cb4647fef85b"},"docs/openclaw-integration/validation-summary.md":{"bytes":2141,"sha256":"40e31c0cd1ebb639cf1e852b0b0180bda27e28c16dcba9b90e3cb8aabd0f6d10"},"openspec/README.md":{"bytes":611,"sha256":"58a1b2615971f2c7fb56f069006b8559cf5cf1548c01b29c83758c894ec79f20"},"openspec/changes/add-agent-session-approval-control/.openspec.yaml":{"bytes":40,"sha256":"dc10040214104474c4e34e5b38359540c882aa7cfb6e7221e5d0614f1dba8fd7"},"openspec/changes/add-agent-session-approval-control/design.md":{"bytes":4797,"sha256":"95794f1f71841a3d6a5ca61d10bbffaf5be029f8284cf75ac4b6020e4564d3d1"},"openspec/changes/add-agent-session-approval-control/proposal.md":{"bytes":1936,"sha256":"da5665faa52a3e14e756e021e2b9dec56c5f6bb5d73af277e756050a4399c741"},"openspec/changes/add-agent-session-approval-control/specs/agent-lifecycle/spec.md":{"bytes":2664,"sha256":"0b12b0240d1a5d37bcaa8c69604ca53ca67c4a372440262d14ed01b0ffd1a174"},"openspec/changes/add-agent-session-approval-control/specs/approval-control/spec.md":{"bytes":2549,"sha256":"3b979ba5b34b8aa1e1fef3a216e663b5b194b7bce713092d73cc4eed83f0c09b"},"openspec/changes/add-agent-session-approval-control/specs/session-control/spec.md":{"bytes":2543,"sha256":"ecf939250f43f526c1d78a5a2bc2902e5889cf13474a7c80e440e7232d5c24fb"},"openspec/changes/add-agent-session-approval-control/tasks.md":{"bytes":3242,"sha256":"782b9f42a8b58fab966c04920d27a98ea77d588102594219572eae5b17cbad11"},"openspec/changes/add-gateway-operations/.openspec.yaml":{"bytes":40,"sha256":"dc10040214104474c4e34e5b38359540c882aa7cfb6e7221e5d0614f1dba8fd7"},"openspec/changes/add-gateway-operations/design.md":{"bytes":5441,"sha256":"d07d9f9c3c5da092be96a18f0e6c35be53fe06f2eda9f540ef993961be8f247d"},"openspec/changes/add-gateway-operations/proposal.md":{"bytes":2342,"sha256":"c6081bd3692307909e736b7d84ccc34828b4fa5152a118f86dc577fa6ac3d47f"},"openspec/changes/add-gateway-operations/specs/channel-node-control/spec.md":{"bytes":2663,"sha256":"4350182f113da6caff9cd0eb81f2cb5173be374bd2f6665e16a9f93111fb4649"},"openspec/changes/add-gateway-operations/specs/configuration-control/spec.md":{"bytes":2432,"sha256":"cf8839be9d8c9015cfb855422fcdfdfaee02275965f2b3a12b42ce4987b8b3c1"},"openspec/changes/add-gateway-operations/specs/cron-control/spec.md":{"bytes":2453,"sha256":"8f86038254595e09c705b4b680d41aed60b2332f019139e35b5a65c329774274"},"openspec/changes/add-gateway-operations/specs/skill-plugin-lifecycle/spec.md":{"bytes":2551,"sha256":"01ef9d030ab116a21bcca1ff7f8d9ced27968015939cd1bf4c2ed99955f445bd"},"openspec/changes/add-gateway-operations/specs/task-audit-artifacts/spec.md":{"bytes":2597,"sha256":"8d2cb83159ed06b09358d3f950ae20489ea964a864c289168ab2c5a8e57ffadb"},"openspec/changes/add-gateway-operations/specs/tool-model-catalogs/spec.md":{"bytes":2463,"sha256":"a424d99c94d69cb61fa9e3f0efeb9dc8c1702d37c397f789c3363a79066df547"},"openspec/changes/add-gateway-operations/tasks.md":{"bytes":5352,"sha256":"12b19adb7b2a84e0fc263e8a8378719d2f5978f2dc5f619f3c856eb70a66b4f5"},"openspec/changes/add-managed-gateway-client/.openspec.yaml":{"bytes":40,"sha256":"dc10040214104474c4e34e5b38359540c882aa7cfb6e7221e5d0614f1dba8fd7"},"openspec/changes/add-managed-gateway-client/design.md":{"bytes":5113,"sha256":"162801004ae85138dc1d03ecb0654506986c26053bfe6fa9e72704edb01de6a2"},"openspec/changes/add-managed-gateway-client/proposal.md":{"bytes":2019,"sha256":"a91469801a7becd8ab01272697394c1d44c367ac2ae0666814b6f6b5706a01cf"},"openspec/changes/add-managed-gateway-client/specs/gateway-recovery/spec.md":{"bytes":2762,"sha256":"af082acc14c97793b8f9231b500e86e8e5c77455ae04a88b0b24fdfa4ed3335e"},"openspec/changes/add-managed-gateway-client/specs/managed-rpc/spec.md":{"bytes":2624,"sha256":"6aa6031b61a113443b8d560e58baae1c041ddc465630b736fa9a23b1fdb4408d"},"openspec/changes/add-managed-gateway-client/specs/typed-event-delivery/spec.md":{"bytes":2613,"sha256":"c5def41f0c9510153b5eb773521778d6121cad2ca4b2bdc733e9cfaa40275552"},"openspec/changes/add-managed-gateway-client/tasks.md":{"bytes":3249,"sha256":"978d020d94027db3801c090dd7e86bbd65b2568c64880950320e57087ee96970"},"openspec/changes/add-optional-runtime-adapters/.openspec.yaml":{"bytes":40,"sha256":"dc10040214104474c4e34e5b38359540c882aa7cfb6e7221e5d0614f1dba8fd7"},"openspec/changes/add-optional-runtime-adapters/design.md":{"bytes":4940,"sha256":"65332fcd6d91ff4ca9e77d53f606caccec2795fae74160bb95d357da482546c9"},"openspec/changes/add-optional-runtime-adapters/proposal.md":{"bytes":2065,"sha256":"a32b0507234b8e78719cb7716dc484212797b3c0259daa76931bf2c7820b4b3e"},"openspec/changes/add-optional-runtime-adapters/specs/cli-typed-results/spec.md":{"bytes":2609,"sha256":"2f9836a84b4b5ae66abae680ef1ec52c35531029b4682a75cc5a3c2e8cc6c67f"},"openspec/changes/add-optional-runtime-adapters/specs/persistent-stdio-adapters/spec.md":{"bytes":2509,"sha256":"ea7d2f8599d97c4ccd8f23ada658f636be62d2bdb715ed82f026a22286a7a3db"},"openspec/changes/add-optional-runtime-adapters/specs/terminal-voice-adapters/spec.md":{"bytes":2620,"sha256":"77fbb21d872b83da1cda418e6a7e1d94b0ea496ac566e6808225f2031a1c39a0"},"openspec/changes/add-optional-runtime-adapters/tasks.md":{"bytes":3318,"sha256":"a86f42485573c87ffa97e3296c3c20cfc128b63db40166a28ee7daf48e1b9f0c"},"openspec/changes/establish-sdk-compatibility-governance/.openspec.yaml":{"bytes":40,"sha256":"dc10040214104474c4e34e5b38359540c882aa7cfb6e7221e5d0614f1dba8fd7"},"openspec/changes/establish-sdk-compatibility-governance/design.md":{"bytes":4395,"sha256":"5eef818703376fa417abdff26f2b3ce0bc5761f643f4378cf985abc49dc35e92"},"openspec/changes/establish-sdk-compatibility-governance/evidence/2026-09-20-precursor-evidence.md":{"bytes":2383,"sha256":"e55309e91a1f190e62b3c29de385509def154a9d534f2963d8f4b69c4fd27db4"},"openspec/changes/establish-sdk-compatibility-governance/evidence/2026-11-18-live-gateway.md":{"bytes":2844,"sha256":"358d5e6387706c457d8e791d9177e967dbc9eb91e52f7201fed5e417ef424bde"},"openspec/changes/establish-sdk-compatibility-governance/evidence/capability-inventory.json":{"bytes":2118,"sha256":"c8148e22712176d1991cec37e8f80861996053c693f76a2998a3f7a37fd00822"},"openspec/changes/establish-sdk-compatibility-governance/evidence/version-lock.md":{"bytes":1117,"sha256":"b89ce152854b1fe05e521499a4cf70fe8261a08c4521dd25f83439304f8465e7"},"openspec/changes/establish-sdk-compatibility-governance/proposal.md":{"bytes":1789,"sha256":"88e18f4f66ebccace6da321cb7d0a6b4d788e8e84cc933ab3678a5389b459ed6"},"openspec/changes/establish-sdk-compatibility-governance/specs/sdk-compatibility-governance/spec.md":{"bytes":3830,"sha256":"3d14086cef101a78b83ef953e16cea13b4b341ca9c9552c62596ee9ab85131a1"},"openspec/changes/establish-sdk-compatibility-governance/tasks.md":{"bytes":3826,"sha256":"fe863141995709c662d3cb1f12c4e2b7506ce5d22c84f30b00053d2b3d85f95d"},"openspec/changes/fix-openclaw-protocol-contracts/.openspec.yaml":{"bytes":40,"sha256":"dc10040214104474c4e34e5b38359540c882aa7cfb6e7221e5d0614f1dba8fd7"},"openspec/changes/fix-openclaw-protocol-contracts/design.md":{"bytes":5675,"sha256":"10966f9bc03d3b34138539aeeb4b7ad884b28763cc2290c1f95926b69335dbbb"},"openspec/changes/fix-openclaw-protocol-contracts/proposal.md":{"bytes":2418,"sha256":"11a51837e386f1068004c526673547610a5b84dca8b42fc6d9484da02cc9b270"},"openspec/changes/fix-openclaw-protocol-contracts/specs/gateway-chat-events/spec.md":{"bytes":2622,"sha256":"3564b6061b568c1d30577fc8b228243f21df756321de9e50dd4a763529afb5b9"},"openspec/changes/fix-openclaw-protocol-contracts/specs/gateway-device-auth/spec.md":{"bytes":2806,"sha256":"2a6d8d7d5202495cdace92ffd12a500ee9f0266a172aa4147852e4cf43ee2a4a"},"openspec/changes/fix-openclaw-protocol-contracts/specs/responses-streaming/spec.md":{"bytes":2695,"sha256":"1ca9b80db706c236ca32ae0acd8a02a190fc3644959aa58af4379035923c3b82"},"openspec/changes/fix-openclaw-protocol-contracts/specs/session-history-contract/spec.md":{"bytes":2651,"sha256":"7fcc7baab4e3d9f10dd86adb03e00f78b07a7f011747a744224ca3dadf89168c"},"openspec/changes/fix-openclaw-protocol-contracts/specs/tools-invoke-contract/spec.md":{"bytes":2681,"sha256":"f255110ecff5a9479b780ec81dce1c451d638fe69259196e0ef063c5343a62f1"},"openspec/changes/fix-openclaw-protocol-contracts/tasks.md":{"bytes":4698,"sha256":"fd7a21979c085430e70479494b8f87c88e9746cf277463628a93a92a7932130a"},"openspec/config.yaml":{"bytes":1862,"sha256":"151f5ce61678f2d47d19a1c21168936f7ad5c6f05adec25db6a0e8a70f1f8ba9"},"openspec/specs/.gitkeep":{"bytes":1,"sha256":"01ba4719c80b6fe911b091a7c05124b64eeece964e09c058ef8f9805daca546b"}},"split_report":{"path":"docs/openclaw-integration/validation-report","encoding":"concatenated-base64-of-gzip","original_bytes":127699,"original_sha256":"a689415d7e7c1a28cc50a97179c797adc29080b30f5ec929aa8ed23227a1a598","parts":3},"source_package_note":"The source package hash identifies the original 2026-09-20 bundle. The file inventory also includes subsequent G0 evidence and documentation edits."} diff --git a/docs/openclaw-integration/roadmap.md b/docs/openclaw-integration/roadmap.md index 59ef327..786ac80 100644 --- a/docs/openclaw-integration/roadmap.md +++ b/docs/openclaw-integration/roadmap.md @@ -42,7 +42,7 @@ proposal 解释为什么、范围与破坏性变化;specs 只写外部行为 ## 准入状态 -人审:尚未发生。G0 证据已记录本机可获得的 OpenClaw `2026.7.1-2 (0790d9f)` 及来源,但协议 schema 和真实 Gateway 观察仍缺失,版本锁定待人审确认,G1 编码保持阻断。首次文档编制时 OpenSpec CLI 不可用;后续 G0 证据记录了 OpenSpec 1.8.0 strict 校验和三分支构建结果,2026-11-18 又以 OpenSpec 1.14.1 strict 校验 6/6 通过。CLI 格式校验和历史构建不代替当前 SDK 行为或真实 Gateway 验收。 +人审:尚未发生。G0 证据已记录本机可获得的 OpenClaw `2026.7.1-2 (0790d9f)` 及来源,并完成 [真实 Gateway 基线验证](../../openspec/changes/establish-sdk-compatibility-governance/evidence/2026-11-18-live-gateway.md)。锁定版机器可读协议 schema 仍缺失,版本锁定待人审确认,G1 编码保持阻断。首次文档编制时 OpenSpec CLI 不可用;后续 G0 证据记录了 OpenSpec 1.8.0 strict 校验和三分支构建结果,2026-11-18 又以 OpenSpec 1.14.1 strict 校验 6/6 通过。CLI 格式校验和历史构建不代替当前 SDK 行为或真实 Gateway 验收。 ## 尚未纳入强承诺的扩展 diff --git a/docs/openclaw-integration/validation-summary.md b/docs/openclaw-integration/validation-summary.md index 3059360..3222db2 100644 --- a/docs/openclaw-integration/validation-summary.md +++ b/docs/openclaw-integration/validation-summary.md @@ -17,17 +17,17 @@ | Requirements | 64 | | Scenarios | 128 | | 实施任务 | 97 | -| 已勾选 G0 准入证据任务 | 5 | -| 待完成任务 | 92 | +| 已勾选 G0 准入证据任务 | 6 | +| 待完成任务 | 91 | ## 后续验证与剩余门禁 首次编制时官方 OpenSpec CLI 校验为 NOT_RUN;后续 G0 证据提交使用 OpenSpec 1.8.0 strict 校验 6/6 通过。2026-11-18 使用 OpenSpec 1.14.1 对本分支执行 `openspec validate --all --strict --no-interactive --json`,6/6 changes 有效,0 个 issues。 -后续 G0 证据还记录了三分支 CodeGraph、Maven 构建和测试,详情及当时的 SDK SHA 见 `openspec/changes/establish-sdk-compatibility-governance/evidence/2026-09-20-precursor-evidence.md`。这些历史结果未覆盖本次之后的源码;真实 Gateway 集成、漏洞扫描、资源/堆分析仍为 NOT_RUN。本次文档 PR 不包含 SDK 实现。 +后续 G0 证据还记录了三分支 CodeGraph、Maven 构建和测试,详情及当时的 SDK SHA 见 `openspec/changes/establish-sdk-compatibility-governance/evidence/2026-09-20-precursor-evidence.md`。2026-11-18 完成 [真实 Gateway 基线验证](../../openspec/changes/establish-sdk-compatibility-governance/evidence/2026-11-18-live-gateway.md)。三条维护线通过健康、认证和读取权限检查,默认分支握手失败。漏洞扫描、资源和堆分析尚待执行。 ## 阶段结论 -文档结构检查和当前 OpenSpec strict 校验通过,内容保持 DRAFT / REVIEW_REQUIRED。目标 Gateway 版本已有记录但待人审确认;G0 剩余任务、真实 Gateway 验证及全部 SDK 功能验收仍未完成。评审先从 G0 兼容治理和 G1 现有协议修正开始。 +文档结构检查和当前 OpenSpec strict 校验通过,内容保持 DRAFT / REVIEW_REQUIRED。目标 Gateway 版本已有记录但待人审确认;G0 剩余任务和完整 SDK 功能验收仍待完成。评审先从 G0 兼容治理和 G1 现有协议修正开始。 详细逐项输出见 [完整报告与恢复说明](validation-report/README.md)。 diff --git a/openspec/changes/establish-sdk-compatibility-governance/evidence/2026-11-18-live-gateway.md b/openspec/changes/establish-sdk-compatibility-governance/evidence/2026-11-18-live-gateway.md new file mode 100644 index 0000000..5e9ed14 --- /dev/null +++ b/openspec/changes/establish-sdk-compatibility-governance/evidence/2026-11-18-live-gateway.md @@ -0,0 +1,30 @@ +# G0 真实 Gateway 基线验证(2026-11-18) + +两次 Gateway 启动都只监听回环地址,使用独立状态目录、临时 Token,并关闭插件。SDK 测试仅执行握手和会话列表查询。 + +| Gateway | SDK 维护线 | 源码 SHA | JDK | 验证 | +|---|---|---|---|---| +| 2026.7.1-2 | feature/1.0.x | `8cfbeb880a6c6ae5390fab0f9fe65e06938907be` | 1.8.0_504 | 3 项通过 | +| 2026.7.1-2 | feature/2.0.x | `48309d7bc34c4298cdfa1c52db06114b2e7e9f17` | 17.0.21 | 3 项通过 | +| 2026.7.1-2 | feature/3.0.x | `87c21133aba6364f64ed0edbefab2d821564ede0` | 21.0.13.0.2 | 3 项通过 | +| 2026.11.5 | feature/1.0.x | `8cfbeb880a6c6ae5390fab0f9fe65e06938907be` | 1.8.0_504 | 3 项通过 | +| 2026.11.5 | feature/2.0.x | `48309d7bc34c4298cdfa1c52db06114b2e7e9f17` | 17.0.21 | 3 项通过 | +| 2026.11.5 | feature/3.0.x | `87c21133aba6364f64ed0edbefab2d821564ede0` | 21.0.13.0.2 | 3 项通过 | + +每组验证包括正确 Token 握手并协商协议 4、错误 Token 被 Gateway 拒绝、使用 operator.read 读取会话列表。JDK 8 和 17 通过系统 Maven 执行,JDK 21 使用仓库 Wrapper。 + +## 追加权限与默认分支验证 + +同一有效 Token,在三条维护线均可建立 WebSocket 握手。客户端请求空权限集合时,两版 Gateway 均拒绝 `sessions.list`,SDK 收到结构化错误 `missing scope: operator.read`。此前用读取权限执行的正向查询均成功。 + +默认分支 `ee0474ea597551a613291134858dbc83b815b20e` 使用有效 Token 发起握手,两版 Gateway 均返回 `invalid connect params`。服务端记录显示 `client.id` 校验失败,锁定版本的首次探测还报告了 `client.mode`。旧分支源码声明协议 1。实际握手在元数据校验阶段被拒绝,本次运行未到达协议协商阶段。 + +追加验证共 8 项,零失败、零跳过。两次默认分支测试以验证拒绝为预期结果。真实模型调用和 G0/G1 范围审批仍待验收。 + +## 复核方法 + +使用官方 npm 发布包 `openclaw@2026.7.1-2` 和 `openclaw@2026.11.5`,以 Node 24.18.0 分别启动 `openclaw gateway run`。确认两次 `GET /readyz` 均返回 `ready: true` 后,将 SDK WebSocket URI 指向对应的本地端口。表中的 SHA 对应独立检出目录的源码。 + +每条维护线使用 `OpenClawGatewayWsClient.connectHandshake()` 检查服务端返回的协议号,并调用 `sessionsList()`。认证失败由 Gateway 的 Token 不匹配记录确认。权限不足由 SDK 的 `OpenClawWsRpcException` 确认,异常保留方法名 `sessions.list` 和服务端的结构化错误。报告省略临时 Token 和连接标识。 + +锁定版本的基础运行检查满足 G0 任务 3.1。候选版本的结果用于后续版本选择评审。默认分支的兼容缺口计入后续 G1 握手工作。此检查未调用模型,版本与范围审批仍待人审。 diff --git a/openspec/changes/establish-sdk-compatibility-governance/evidence/version-lock.md b/openspec/changes/establish-sdk-compatibility-governance/evidence/version-lock.md index 99ffe78..38b60a6 100644 --- a/openspec/changes/establish-sdk-compatibility-governance/evidence/version-lock.md +++ b/openspec/changes/establish-sdk-compatibility-governance/evidence/version-lock.md @@ -19,4 +19,4 @@ ## 声明 锁定仅覆盖本机可获得的最新发布版;未取得官方对应版本的协议 schema 机器可读制品, -协议字段以文档 + 真实 Gateway 观察(任务 3.1,未执行)为准。人审通过前 G1 编码保持阻断。 +协议字段以官方文档和 [真实 Gateway 基线验证](2026-11-18-live-gateway.md) 为参照。G0 任务 3.1 已执行,版本锁定和 G1 编码仍待人审。 diff --git a/openspec/changes/establish-sdk-compatibility-governance/tasks.md b/openspec/changes/establish-sdk-compatibility-governance/tasks.md index 1e69e18..27424eb 100644 --- a/openspec/changes/establish-sdk-compatibility-governance/tasks.md +++ b/openspec/changes/establish-sdk-compatibility-governance/tasks.md @@ -1,6 +1,6 @@ # Implementation Tasks -状态:未执行。已有草案不代表治理流程已获批准或自动检查已落地。 +状态:已收集部分准入证据,治理流程待评审。 ## 1. 评审与版本准入 @@ -17,7 +17,7 @@ ## 3. 基线验证与文档同步 -- [ ] 3.1 对锁定 Gateway 执行基础健康、认证成功及授权拒绝检查;验收:记录真实目标版本、认证模式及脱敏结果,现有缺陷如实登记,不以消除尚未实施功能的失败为本阶段前提。 +- [x] 3.1 对锁定 Gateway 执行基础健康、认证成功及授权拒绝检查;验收:记录真实目标版本、认证模式及脱敏结果,现有缺陷如实登记,不以消除尚未实施功能的失败为本阶段前提。证据见 [真实 Gateway 基线验证](evidence/2026-11-18-live-gateway.md)。 - [ ] 3.2 修正文档中的版本、JDK、依赖和支持等级漂移;验收:逐分支核对 pom、README、发布说明,快照版本和未验证状态一致,无声称全量支持的空泛结论。 - [x] 3.3 记录实际 JDK/Maven/依赖来源与构建结果;(证据:evidence/2026-09-20-precursor-evidence.md §3.3)验收:每条分支都有独立结果,环境不足标为 BLOCKED,治理变更无运行资源触点时明确记录资源测试不适用原因。 - [x] 3.4 使用已固定版本的官方 OpenSpec CLI 校验全部变更并保存输出;openspec CLI 1.8.0,`validate --all --strict --no-interactive --json`:6/6 changes valid,issues 为空(证据:evidence/2026-09-20-precursor-evidence.md §3.4)验收:validate --all --strict --no-interactive --json 成功,不用自定义结构检查冒充官方校验。 @@ -26,5 +26,9 @@ ## 执行记录(2026-09-20) 已由 AI 会话完成并附证据:1.2、1.3、2.1、3.3、3.4(见 evidence/ 目录)。 -保持未勾选(人审/环境门禁):1.1、2.2、2.3、2.4、3.1、3.2、3.5——原因逐条见 +保持未勾选(人审/环境门禁):1.1、2.2、2.3、2.4、3.2、3.5——原因逐条见 evidence/2026-09-20-precursor-evidence.md「阻塞项」。G1 编码保持阻断,待人审批准。 + +## 执行记录(2026-11-18) + +锁定 Gateway 的运行验证已完成,补验了候选版本和默认分支。证据见 [G0 真实 Gateway 基线验证](evidence/2026-11-18-live-gateway.md)。 From 883db701d47ee73cfef03a3960c6913ba0dbf175 Mon Sep 17 00:00:00 2001 From: loong10k <20489781+loong10k@users.noreply.github.com> Date: Wed, 18 Nov 2026 23:21:32 +0800 Subject: [PATCH 06/22] docs: record generated schema for locked OpenClaw Gateway --- .../package-manifest.json | 2 +- docs/openclaw-integration/roadmap.md | 2 +- .../2026-11-18-locked-gateway-schema.md | 27 +++++++++++++++++++ .../evidence/version-lock.md | 3 +-- 4 files changed, 30 insertions(+), 4 deletions(-) create mode 100644 openspec/changes/establish-sdk-compatibility-governance/evidence/2026-11-18-locked-gateway-schema.md diff --git a/docs/openclaw-integration/package-manifest.json b/docs/openclaw-integration/package-manifest.json index acfa41f..07eb6a9 100644 --- a/docs/openclaw-integration/package-manifest.json +++ b/docs/openclaw-integration/package-manifest.json @@ -1 +1 @@ -{"scope":"repository documentation; paths relative to repository root; manifest excludes itself","source_package":"openclaw-java-sdk-openspec-draft-2026-09-20.zip","source_package_sha256":"f8eedbb0356b34ecde22584b57fdc9d375fa7409c36d6931b7faca36f4919468","files":{"docs/openclaw-integration/README.md":{"bytes":2882,"sha256":"43b72643d133501a9da6fd56e855e64e1f440991204c05ea35bb8d199bdaa01b"},"docs/openclaw-integration/acceptance-plan.md":{"bytes":4591,"sha256":"4875a07fd14cd9771d610d221ab8e666bf2801341b3ccc21302627f06fa2089f"},"docs/openclaw-integration/baseline.json":{"bytes":3221,"sha256":"b5b13dd410d068a5b07b4c27be01658aa94bb626dce9beffc44ebce9565789ab"},"docs/openclaw-integration/coverage-baseline.md":{"bytes":4792,"sha256":"ae4b7783b718a268c697fdd85f1f24800f838cb1063ae90e4324c224efc7f820"},"docs/openclaw-integration/roadmap.md":{"bytes":3751,"sha256":"e78ff12efceab3020ceadbcc500dc2ae926ea102084fbf2005e306058da073d0"},"docs/openclaw-integration/source-register.md":{"bytes":5424,"sha256":"992bf67dd8da00cccaeaf4a93ed594b2877d832ed3015b402c3a4eabb0b523f0"},"docs/openclaw-integration/traceability.json.gz":{"bytes":3246,"sha256":"75386731e6f4b685d61a8c582e18edbdc86577e717039716c1c908f8422befcd","decompressed_sha256":"da585354d01fb0f687d764840f7512259de832896db051fe450ac667fd6bf6bb"},"docs/openclaw-integration/traceability.md":{"bytes":13478,"sha256":"cd1b647ab538953e299a1964e009fbb65b4212654dab678bfb05e4fd1bcd2a59"},"docs/openclaw-integration/validation-report/README.md":{"bytes":1113,"sha256":"b67e0eb4a969e742b6e30e35883dcac0c3cc15aca0005e6d66377b99995e2932"},"docs/openclaw-integration/validation-report/part-001.b64":{"bytes":2601,"sha256":"9570f3b3818b997c948cb9ee4a5c4885d664cacdfec18e0b3d1e9858ae695a32"},"docs/openclaw-integration/validation-report/part-002.b64":{"bytes":2601,"sha256":"d57ebdd3717bab8648f4f98a70430515d0750ebb38cd72a970e246ddeb049952"},"docs/openclaw-integration/validation-report/part-003.b64":{"bytes":2537,"sha256":"61a7c754d543e645ad6b705add8f183ac0e6605340f0993b9bc5cb4647fef85b"},"docs/openclaw-integration/validation-summary.md":{"bytes":2141,"sha256":"40e31c0cd1ebb639cf1e852b0b0180bda27e28c16dcba9b90e3cb8aabd0f6d10"},"openspec/README.md":{"bytes":611,"sha256":"58a1b2615971f2c7fb56f069006b8559cf5cf1548c01b29c83758c894ec79f20"},"openspec/changes/add-agent-session-approval-control/.openspec.yaml":{"bytes":40,"sha256":"dc10040214104474c4e34e5b38359540c882aa7cfb6e7221e5d0614f1dba8fd7"},"openspec/changes/add-agent-session-approval-control/design.md":{"bytes":4797,"sha256":"95794f1f71841a3d6a5ca61d10bbffaf5be029f8284cf75ac4b6020e4564d3d1"},"openspec/changes/add-agent-session-approval-control/proposal.md":{"bytes":1936,"sha256":"da5665faa52a3e14e756e021e2b9dec56c5f6bb5d73af277e756050a4399c741"},"openspec/changes/add-agent-session-approval-control/specs/agent-lifecycle/spec.md":{"bytes":2664,"sha256":"0b12b0240d1a5d37bcaa8c69604ca53ca67c4a372440262d14ed01b0ffd1a174"},"openspec/changes/add-agent-session-approval-control/specs/approval-control/spec.md":{"bytes":2549,"sha256":"3b979ba5b34b8aa1e1fef3a216e663b5b194b7bce713092d73cc4eed83f0c09b"},"openspec/changes/add-agent-session-approval-control/specs/session-control/spec.md":{"bytes":2543,"sha256":"ecf939250f43f526c1d78a5a2bc2902e5889cf13474a7c80e440e7232d5c24fb"},"openspec/changes/add-agent-session-approval-control/tasks.md":{"bytes":3242,"sha256":"782b9f42a8b58fab966c04920d27a98ea77d588102594219572eae5b17cbad11"},"openspec/changes/add-gateway-operations/.openspec.yaml":{"bytes":40,"sha256":"dc10040214104474c4e34e5b38359540c882aa7cfb6e7221e5d0614f1dba8fd7"},"openspec/changes/add-gateway-operations/design.md":{"bytes":5441,"sha256":"d07d9f9c3c5da092be96a18f0e6c35be53fe06f2eda9f540ef993961be8f247d"},"openspec/changes/add-gateway-operations/proposal.md":{"bytes":2342,"sha256":"c6081bd3692307909e736b7d84ccc34828b4fa5152a118f86dc577fa6ac3d47f"},"openspec/changes/add-gateway-operations/specs/channel-node-control/spec.md":{"bytes":2663,"sha256":"4350182f113da6caff9cd0eb81f2cb5173be374bd2f6665e16a9f93111fb4649"},"openspec/changes/add-gateway-operations/specs/configuration-control/spec.md":{"bytes":2432,"sha256":"cf8839be9d8c9015cfb855422fcdfdfaee02275965f2b3a12b42ce4987b8b3c1"},"openspec/changes/add-gateway-operations/specs/cron-control/spec.md":{"bytes":2453,"sha256":"8f86038254595e09c705b4b680d41aed60b2332f019139e35b5a65c329774274"},"openspec/changes/add-gateway-operations/specs/skill-plugin-lifecycle/spec.md":{"bytes":2551,"sha256":"01ef9d030ab116a21bcca1ff7f8d9ced27968015939cd1bf4c2ed99955f445bd"},"openspec/changes/add-gateway-operations/specs/task-audit-artifacts/spec.md":{"bytes":2597,"sha256":"8d2cb83159ed06b09358d3f950ae20489ea964a864c289168ab2c5a8e57ffadb"},"openspec/changes/add-gateway-operations/specs/tool-model-catalogs/spec.md":{"bytes":2463,"sha256":"a424d99c94d69cb61fa9e3f0efeb9dc8c1702d37c397f789c3363a79066df547"},"openspec/changes/add-gateway-operations/tasks.md":{"bytes":5352,"sha256":"12b19adb7b2a84e0fc263e8a8378719d2f5978f2dc5f619f3c856eb70a66b4f5"},"openspec/changes/add-managed-gateway-client/.openspec.yaml":{"bytes":40,"sha256":"dc10040214104474c4e34e5b38359540c882aa7cfb6e7221e5d0614f1dba8fd7"},"openspec/changes/add-managed-gateway-client/design.md":{"bytes":5113,"sha256":"162801004ae85138dc1d03ecb0654506986c26053bfe6fa9e72704edb01de6a2"},"openspec/changes/add-managed-gateway-client/proposal.md":{"bytes":2019,"sha256":"a91469801a7becd8ab01272697394c1d44c367ac2ae0666814b6f6b5706a01cf"},"openspec/changes/add-managed-gateway-client/specs/gateway-recovery/spec.md":{"bytes":2762,"sha256":"af082acc14c97793b8f9231b500e86e8e5c77455ae04a88b0b24fdfa4ed3335e"},"openspec/changes/add-managed-gateway-client/specs/managed-rpc/spec.md":{"bytes":2624,"sha256":"6aa6031b61a113443b8d560e58baae1c041ddc465630b736fa9a23b1fdb4408d"},"openspec/changes/add-managed-gateway-client/specs/typed-event-delivery/spec.md":{"bytes":2613,"sha256":"c5def41f0c9510153b5eb773521778d6121cad2ca4b2bdc733e9cfaa40275552"},"openspec/changes/add-managed-gateway-client/tasks.md":{"bytes":3249,"sha256":"978d020d94027db3801c090dd7e86bbd65b2568c64880950320e57087ee96970"},"openspec/changes/add-optional-runtime-adapters/.openspec.yaml":{"bytes":40,"sha256":"dc10040214104474c4e34e5b38359540c882aa7cfb6e7221e5d0614f1dba8fd7"},"openspec/changes/add-optional-runtime-adapters/design.md":{"bytes":4940,"sha256":"65332fcd6d91ff4ca9e77d53f606caccec2795fae74160bb95d357da482546c9"},"openspec/changes/add-optional-runtime-adapters/proposal.md":{"bytes":2065,"sha256":"a32b0507234b8e78719cb7716dc484212797b3c0259daa76931bf2c7820b4b3e"},"openspec/changes/add-optional-runtime-adapters/specs/cli-typed-results/spec.md":{"bytes":2609,"sha256":"2f9836a84b4b5ae66abae680ef1ec52c35531029b4682a75cc5a3c2e8cc6c67f"},"openspec/changes/add-optional-runtime-adapters/specs/persistent-stdio-adapters/spec.md":{"bytes":2509,"sha256":"ea7d2f8599d97c4ccd8f23ada658f636be62d2bdb715ed82f026a22286a7a3db"},"openspec/changes/add-optional-runtime-adapters/specs/terminal-voice-adapters/spec.md":{"bytes":2620,"sha256":"77fbb21d872b83da1cda418e6a7e1d94b0ea496ac566e6808225f2031a1c39a0"},"openspec/changes/add-optional-runtime-adapters/tasks.md":{"bytes":3318,"sha256":"a86f42485573c87ffa97e3296c3c20cfc128b63db40166a28ee7daf48e1b9f0c"},"openspec/changes/establish-sdk-compatibility-governance/.openspec.yaml":{"bytes":40,"sha256":"dc10040214104474c4e34e5b38359540c882aa7cfb6e7221e5d0614f1dba8fd7"},"openspec/changes/establish-sdk-compatibility-governance/design.md":{"bytes":4395,"sha256":"5eef818703376fa417abdff26f2b3ce0bc5761f643f4378cf985abc49dc35e92"},"openspec/changes/establish-sdk-compatibility-governance/evidence/2026-09-20-precursor-evidence.md":{"bytes":2383,"sha256":"e55309e91a1f190e62b3c29de385509def154a9d534f2963d8f4b69c4fd27db4"},"openspec/changes/establish-sdk-compatibility-governance/evidence/2026-11-18-live-gateway.md":{"bytes":2844,"sha256":"358d5e6387706c457d8e791d9177e967dbc9eb91e52f7201fed5e417ef424bde"},"openspec/changes/establish-sdk-compatibility-governance/evidence/capability-inventory.json":{"bytes":2118,"sha256":"c8148e22712176d1991cec37e8f80861996053c693f76a2998a3f7a37fd00822"},"openspec/changes/establish-sdk-compatibility-governance/evidence/version-lock.md":{"bytes":1117,"sha256":"b89ce152854b1fe05e521499a4cf70fe8261a08c4521dd25f83439304f8465e7"},"openspec/changes/establish-sdk-compatibility-governance/proposal.md":{"bytes":1789,"sha256":"88e18f4f66ebccace6da321cb7d0a6b4d788e8e84cc933ab3678a5389b459ed6"},"openspec/changes/establish-sdk-compatibility-governance/specs/sdk-compatibility-governance/spec.md":{"bytes":3830,"sha256":"3d14086cef101a78b83ef953e16cea13b4b341ca9c9552c62596ee9ab85131a1"},"openspec/changes/establish-sdk-compatibility-governance/tasks.md":{"bytes":3826,"sha256":"fe863141995709c662d3cb1f12c4e2b7506ce5d22c84f30b00053d2b3d85f95d"},"openspec/changes/fix-openclaw-protocol-contracts/.openspec.yaml":{"bytes":40,"sha256":"dc10040214104474c4e34e5b38359540c882aa7cfb6e7221e5d0614f1dba8fd7"},"openspec/changes/fix-openclaw-protocol-contracts/design.md":{"bytes":5675,"sha256":"10966f9bc03d3b34138539aeeb4b7ad884b28763cc2290c1f95926b69335dbbb"},"openspec/changes/fix-openclaw-protocol-contracts/proposal.md":{"bytes":2418,"sha256":"11a51837e386f1068004c526673547610a5b84dca8b42fc6d9484da02cc9b270"},"openspec/changes/fix-openclaw-protocol-contracts/specs/gateway-chat-events/spec.md":{"bytes":2622,"sha256":"3564b6061b568c1d30577fc8b228243f21df756321de9e50dd4a763529afb5b9"},"openspec/changes/fix-openclaw-protocol-contracts/specs/gateway-device-auth/spec.md":{"bytes":2806,"sha256":"2a6d8d7d5202495cdace92ffd12a500ee9f0266a172aa4147852e4cf43ee2a4a"},"openspec/changes/fix-openclaw-protocol-contracts/specs/responses-streaming/spec.md":{"bytes":2695,"sha256":"1ca9b80db706c236ca32ae0acd8a02a190fc3644959aa58af4379035923c3b82"},"openspec/changes/fix-openclaw-protocol-contracts/specs/session-history-contract/spec.md":{"bytes":2651,"sha256":"7fcc7baab4e3d9f10dd86adb03e00f78b07a7f011747a744224ca3dadf89168c"},"openspec/changes/fix-openclaw-protocol-contracts/specs/tools-invoke-contract/spec.md":{"bytes":2681,"sha256":"f255110ecff5a9479b780ec81dce1c451d638fe69259196e0ef063c5343a62f1"},"openspec/changes/fix-openclaw-protocol-contracts/tasks.md":{"bytes":4698,"sha256":"fd7a21979c085430e70479494b8f87c88e9746cf277463628a93a92a7932130a"},"openspec/config.yaml":{"bytes":1862,"sha256":"151f5ce61678f2d47d19a1c21168936f7ad5c6f05adec25db6a0e8a70f1f8ba9"},"openspec/specs/.gitkeep":{"bytes":1,"sha256":"01ba4719c80b6fe911b091a7c05124b64eeece964e09c058ef8f9805daca546b"}},"split_report":{"path":"docs/openclaw-integration/validation-report","encoding":"concatenated-base64-of-gzip","original_bytes":127699,"original_sha256":"a689415d7e7c1a28cc50a97179c797adc29080b30f5ec929aa8ed23227a1a598","parts":3},"source_package_note":"The source package hash identifies the original 2026-09-20 bundle. The file inventory also includes subsequent G0 evidence and documentation edits."} +{"scope":"repository documentation; paths relative to repository root; manifest excludes itself","source_package":"openclaw-java-sdk-openspec-draft-2026-09-20.zip","source_package_sha256":"f8eedbb0356b34ecde22584b57fdc9d375fa7409c36d6931b7faca36f4919468","files":{"docs/openclaw-integration/README.md":{"bytes":2882,"sha256":"43b72643d133501a9da6fd56e855e64e1f440991204c05ea35bb8d199bdaa01b"},"docs/openclaw-integration/acceptance-plan.md":{"bytes":4591,"sha256":"4875a07fd14cd9771d610d221ab8e666bf2801341b3ccc21302627f06fa2089f"},"docs/openclaw-integration/baseline.json":{"bytes":3221,"sha256":"b5b13dd410d068a5b07b4c27be01658aa94bb626dce9beffc44ebce9565789ab"},"docs/openclaw-integration/coverage-baseline.md":{"bytes":4792,"sha256":"ae4b7783b718a268c697fdd85f1f24800f838cb1063ae90e4324c224efc7f820"},"docs/openclaw-integration/roadmap.md":{"bytes":3880,"sha256":"edb7e1a9717f05e1128eda44fb41fbddcd595cfd2e165ab1ea6d920ca38d5aa6"},"docs/openclaw-integration/source-register.md":{"bytes":5424,"sha256":"992bf67dd8da00cccaeaf4a93ed594b2877d832ed3015b402c3a4eabb0b523f0"},"docs/openclaw-integration/traceability.json.gz":{"bytes":3246,"sha256":"75386731e6f4b685d61a8c582e18edbdc86577e717039716c1c908f8422befcd","decompressed_sha256":"da585354d01fb0f687d764840f7512259de832896db051fe450ac667fd6bf6bb"},"docs/openclaw-integration/traceability.md":{"bytes":13478,"sha256":"cd1b647ab538953e299a1964e009fbb65b4212654dab678bfb05e4fd1bcd2a59"},"docs/openclaw-integration/validation-report/README.md":{"bytes":1113,"sha256":"b67e0eb4a969e742b6e30e35883dcac0c3cc15aca0005e6d66377b99995e2932"},"docs/openclaw-integration/validation-report/part-001.b64":{"bytes":2601,"sha256":"9570f3b3818b997c948cb9ee4a5c4885d664cacdfec18e0b3d1e9858ae695a32"},"docs/openclaw-integration/validation-report/part-002.b64":{"bytes":2601,"sha256":"d57ebdd3717bab8648f4f98a70430515d0750ebb38cd72a970e246ddeb049952"},"docs/openclaw-integration/validation-report/part-003.b64":{"bytes":2537,"sha256":"61a7c754d543e645ad6b705add8f183ac0e6605340f0993b9bc5cb4647fef85b"},"docs/openclaw-integration/validation-summary.md":{"bytes":2141,"sha256":"40e31c0cd1ebb639cf1e852b0b0180bda27e28c16dcba9b90e3cb8aabd0f6d10"},"openspec/README.md":{"bytes":611,"sha256":"58a1b2615971f2c7fb56f069006b8559cf5cf1548c01b29c83758c894ec79f20"},"openspec/changes/add-agent-session-approval-control/.openspec.yaml":{"bytes":40,"sha256":"dc10040214104474c4e34e5b38359540c882aa7cfb6e7221e5d0614f1dba8fd7"},"openspec/changes/add-agent-session-approval-control/design.md":{"bytes":4797,"sha256":"95794f1f71841a3d6a5ca61d10bbffaf5be029f8284cf75ac4b6020e4564d3d1"},"openspec/changes/add-agent-session-approval-control/proposal.md":{"bytes":1936,"sha256":"da5665faa52a3e14e756e021e2b9dec56c5f6bb5d73af277e756050a4399c741"},"openspec/changes/add-agent-session-approval-control/specs/agent-lifecycle/spec.md":{"bytes":2664,"sha256":"0b12b0240d1a5d37bcaa8c69604ca53ca67c4a372440262d14ed01b0ffd1a174"},"openspec/changes/add-agent-session-approval-control/specs/approval-control/spec.md":{"bytes":2549,"sha256":"3b979ba5b34b8aa1e1fef3a216e663b5b194b7bce713092d73cc4eed83f0c09b"},"openspec/changes/add-agent-session-approval-control/specs/session-control/spec.md":{"bytes":2543,"sha256":"ecf939250f43f526c1d78a5a2bc2902e5889cf13474a7c80e440e7232d5c24fb"},"openspec/changes/add-agent-session-approval-control/tasks.md":{"bytes":3242,"sha256":"782b9f42a8b58fab966c04920d27a98ea77d588102594219572eae5b17cbad11"},"openspec/changes/add-gateway-operations/.openspec.yaml":{"bytes":40,"sha256":"dc10040214104474c4e34e5b38359540c882aa7cfb6e7221e5d0614f1dba8fd7"},"openspec/changes/add-gateway-operations/design.md":{"bytes":5441,"sha256":"d07d9f9c3c5da092be96a18f0e6c35be53fe06f2eda9f540ef993961be8f247d"},"openspec/changes/add-gateway-operations/proposal.md":{"bytes":2342,"sha256":"c6081bd3692307909e736b7d84ccc34828b4fa5152a118f86dc577fa6ac3d47f"},"openspec/changes/add-gateway-operations/specs/channel-node-control/spec.md":{"bytes":2663,"sha256":"4350182f113da6caff9cd0eb81f2cb5173be374bd2f6665e16a9f93111fb4649"},"openspec/changes/add-gateway-operations/specs/configuration-control/spec.md":{"bytes":2432,"sha256":"cf8839be9d8c9015cfb855422fcdfdfaee02275965f2b3a12b42ce4987b8b3c1"},"openspec/changes/add-gateway-operations/specs/cron-control/spec.md":{"bytes":2453,"sha256":"8f86038254595e09c705b4b680d41aed60b2332f019139e35b5a65c329774274"},"openspec/changes/add-gateway-operations/specs/skill-plugin-lifecycle/spec.md":{"bytes":2551,"sha256":"01ef9d030ab116a21bcca1ff7f8d9ced27968015939cd1bf4c2ed99955f445bd"},"openspec/changes/add-gateway-operations/specs/task-audit-artifacts/spec.md":{"bytes":2597,"sha256":"8d2cb83159ed06b09358d3f950ae20489ea964a864c289168ab2c5a8e57ffadb"},"openspec/changes/add-gateway-operations/specs/tool-model-catalogs/spec.md":{"bytes":2463,"sha256":"a424d99c94d69cb61fa9e3f0efeb9dc8c1702d37c397f789c3363a79066df547"},"openspec/changes/add-gateway-operations/tasks.md":{"bytes":5352,"sha256":"12b19adb7b2a84e0fc263e8a8378719d2f5978f2dc5f619f3c856eb70a66b4f5"},"openspec/changes/add-managed-gateway-client/.openspec.yaml":{"bytes":40,"sha256":"dc10040214104474c4e34e5b38359540c882aa7cfb6e7221e5d0614f1dba8fd7"},"openspec/changes/add-managed-gateway-client/design.md":{"bytes":5113,"sha256":"162801004ae85138dc1d03ecb0654506986c26053bfe6fa9e72704edb01de6a2"},"openspec/changes/add-managed-gateway-client/proposal.md":{"bytes":2019,"sha256":"a91469801a7becd8ab01272697394c1d44c367ac2ae0666814b6f6b5706a01cf"},"openspec/changes/add-managed-gateway-client/specs/gateway-recovery/spec.md":{"bytes":2762,"sha256":"af082acc14c97793b8f9231b500e86e8e5c77455ae04a88b0b24fdfa4ed3335e"},"openspec/changes/add-managed-gateway-client/specs/managed-rpc/spec.md":{"bytes":2624,"sha256":"6aa6031b61a113443b8d560e58baae1c041ddc465630b736fa9a23b1fdb4408d"},"openspec/changes/add-managed-gateway-client/specs/typed-event-delivery/spec.md":{"bytes":2613,"sha256":"c5def41f0c9510153b5eb773521778d6121cad2ca4b2bdc733e9cfaa40275552"},"openspec/changes/add-managed-gateway-client/tasks.md":{"bytes":3249,"sha256":"978d020d94027db3801c090dd7e86bbd65b2568c64880950320e57087ee96970"},"openspec/changes/add-optional-runtime-adapters/.openspec.yaml":{"bytes":40,"sha256":"dc10040214104474c4e34e5b38359540c882aa7cfb6e7221e5d0614f1dba8fd7"},"openspec/changes/add-optional-runtime-adapters/design.md":{"bytes":4940,"sha256":"65332fcd6d91ff4ca9e77d53f606caccec2795fae74160bb95d357da482546c9"},"openspec/changes/add-optional-runtime-adapters/proposal.md":{"bytes":2065,"sha256":"a32b0507234b8e78719cb7716dc484212797b3c0259daa76931bf2c7820b4b3e"},"openspec/changes/add-optional-runtime-adapters/specs/cli-typed-results/spec.md":{"bytes":2609,"sha256":"2f9836a84b4b5ae66abae680ef1ec52c35531029b4682a75cc5a3c2e8cc6c67f"},"openspec/changes/add-optional-runtime-adapters/specs/persistent-stdio-adapters/spec.md":{"bytes":2509,"sha256":"ea7d2f8599d97c4ccd8f23ada658f636be62d2bdb715ed82f026a22286a7a3db"},"openspec/changes/add-optional-runtime-adapters/specs/terminal-voice-adapters/spec.md":{"bytes":2620,"sha256":"77fbb21d872b83da1cda418e6a7e1d94b0ea496ac566e6808225f2031a1c39a0"},"openspec/changes/add-optional-runtime-adapters/tasks.md":{"bytes":3318,"sha256":"a86f42485573c87ffa97e3296c3c20cfc128b63db40166a28ee7daf48e1b9f0c"},"openspec/changes/establish-sdk-compatibility-governance/.openspec.yaml":{"bytes":40,"sha256":"dc10040214104474c4e34e5b38359540c882aa7cfb6e7221e5d0614f1dba8fd7"},"openspec/changes/establish-sdk-compatibility-governance/design.md":{"bytes":4395,"sha256":"5eef818703376fa417abdff26f2b3ce0bc5761f643f4378cf985abc49dc35e92"},"openspec/changes/establish-sdk-compatibility-governance/evidence/2026-09-20-precursor-evidence.md":{"bytes":2383,"sha256":"e55309e91a1f190e62b3c29de385509def154a9d534f2963d8f4b69c4fd27db4"},"openspec/changes/establish-sdk-compatibility-governance/evidence/2026-11-18-live-gateway.md":{"bytes":2844,"sha256":"358d5e6387706c457d8e791d9177e967dbc9eb91e52f7201fed5e417ef424bde"},"openspec/changes/establish-sdk-compatibility-governance/evidence/2026-11-18-locked-gateway-schema.md":{"bytes":2169,"sha256":"6728253fe492a99ebc24eb8c3bc261331317a6324db7c3a168610883ab41048f"},"openspec/changes/establish-sdk-compatibility-governance/evidence/capability-inventory.json":{"bytes":2118,"sha256":"c8148e22712176d1991cec37e8f80861996053c693f76a2998a3f7a37fd00822"},"openspec/changes/establish-sdk-compatibility-governance/evidence/version-lock.md":{"bytes":1139,"sha256":"7d53174fb9aad9244934bafec50f364ce869f8bcb92445b96aba2c2af64e67f3"},"openspec/changes/establish-sdk-compatibility-governance/proposal.md":{"bytes":1789,"sha256":"88e18f4f66ebccace6da321cb7d0a6b4d788e8e84cc933ab3678a5389b459ed6"},"openspec/changes/establish-sdk-compatibility-governance/specs/sdk-compatibility-governance/spec.md":{"bytes":3830,"sha256":"3d14086cef101a78b83ef953e16cea13b4b341ca9c9552c62596ee9ab85131a1"},"openspec/changes/establish-sdk-compatibility-governance/tasks.md":{"bytes":3826,"sha256":"fe863141995709c662d3cb1f12c4e2b7506ce5d22c84f30b00053d2b3d85f95d"},"openspec/changes/fix-openclaw-protocol-contracts/.openspec.yaml":{"bytes":40,"sha256":"dc10040214104474c4e34e5b38359540c882aa7cfb6e7221e5d0614f1dba8fd7"},"openspec/changes/fix-openclaw-protocol-contracts/design.md":{"bytes":5675,"sha256":"10966f9bc03d3b34138539aeeb4b7ad884b28763cc2290c1f95926b69335dbbb"},"openspec/changes/fix-openclaw-protocol-contracts/proposal.md":{"bytes":2418,"sha256":"11a51837e386f1068004c526673547610a5b84dca8b42fc6d9484da02cc9b270"},"openspec/changes/fix-openclaw-protocol-contracts/specs/gateway-chat-events/spec.md":{"bytes":2622,"sha256":"3564b6061b568c1d30577fc8b228243f21df756321de9e50dd4a763529afb5b9"},"openspec/changes/fix-openclaw-protocol-contracts/specs/gateway-device-auth/spec.md":{"bytes":2806,"sha256":"2a6d8d7d5202495cdace92ffd12a500ee9f0266a172aa4147852e4cf43ee2a4a"},"openspec/changes/fix-openclaw-protocol-contracts/specs/responses-streaming/spec.md":{"bytes":2695,"sha256":"1ca9b80db706c236ca32ae0acd8a02a190fc3644959aa58af4379035923c3b82"},"openspec/changes/fix-openclaw-protocol-contracts/specs/session-history-contract/spec.md":{"bytes":2651,"sha256":"7fcc7baab4e3d9f10dd86adb03e00f78b07a7f011747a744224ca3dadf89168c"},"openspec/changes/fix-openclaw-protocol-contracts/specs/tools-invoke-contract/spec.md":{"bytes":2681,"sha256":"f255110ecff5a9479b780ec81dce1c451d638fe69259196e0ef063c5343a62f1"},"openspec/changes/fix-openclaw-protocol-contracts/tasks.md":{"bytes":4698,"sha256":"fd7a21979c085430e70479494b8f87c88e9746cf277463628a93a92a7932130a"},"openspec/config.yaml":{"bytes":1862,"sha256":"151f5ce61678f2d47d19a1c21168936f7ad5c6f05adec25db6a0e8a70f1f8ba9"},"openspec/specs/.gitkeep":{"bytes":1,"sha256":"01ba4719c80b6fe911b091a7c05124b64eeece964e09c058ef8f9805daca546b"}},"split_report":{"path":"docs/openclaw-integration/validation-report","encoding":"concatenated-base64-of-gzip","original_bytes":127699,"original_sha256":"a689415d7e7c1a28cc50a97179c797adc29080b30f5ec929aa8ed23227a1a598","parts":3},"source_package_note":"The source package hash identifies the original 2026-09-20 bundle. The file inventory also includes subsequent G0 evidence and documentation edits."} diff --git a/docs/openclaw-integration/roadmap.md b/docs/openclaw-integration/roadmap.md index 786ac80..01d4490 100644 --- a/docs/openclaw-integration/roadmap.md +++ b/docs/openclaw-integration/roadmap.md @@ -42,7 +42,7 @@ proposal 解释为什么、范围与破坏性变化;specs 只写外部行为 ## 准入状态 -人审:尚未发生。G0 证据已记录本机可获得的 OpenClaw `2026.7.1-2 (0790d9f)` 及来源,并完成 [真实 Gateway 基线验证](../../openspec/changes/establish-sdk-compatibility-governance/evidence/2026-11-18-live-gateway.md)。锁定版机器可读协议 schema 仍缺失,版本锁定待人审确认,G1 编码保持阻断。首次文档编制时 OpenSpec CLI 不可用;后续 G0 证据记录了 OpenSpec 1.8.0 strict 校验和三分支构建结果,2026-11-18 又以 OpenSpec 1.14.1 strict 校验 6/6 通过。CLI 格式校验和历史构建不代替当前 SDK 行为或真实 Gateway 验收。 +人审:尚未发生。G0 证据已记录本机可获得的 OpenClaw `2026.7.1-2 (0790d9f)` 及来源,并完成 [真实 Gateway 基线验证](../../openspec/changes/establish-sdk-compatibility-governance/evidence/2026-11-18-live-gateway.md)。锁定版的 [机器可读协议 schema](../../openspec/changes/establish-sdk-compatibility-governance/evidence/2026-11-18-locked-gateway-schema.md) 已按上游源码生成。版本锁定待人审确认,G1 编码保持阻断。首次文档编制时 OpenSpec CLI 不可用;后续 G0 证据记录了 OpenSpec 1.8.0 strict 校验和三分支构建结果,2026-11-18 又以 OpenSpec 1.14.1 strict 校验 6/6 通过。CLI 格式校验和历史构建不代替当前 SDK 行为或真实 Gateway 验收。 ## 尚未纳入强承诺的扩展 diff --git a/openspec/changes/establish-sdk-compatibility-governance/evidence/2026-11-18-locked-gateway-schema.md b/openspec/changes/establish-sdk-compatibility-governance/evidence/2026-11-18-locked-gateway-schema.md new file mode 100644 index 0000000..bf616fb --- /dev/null +++ b/openspec/changes/establish-sdk-compatibility-governance/evidence/2026-11-18-locked-gateway-schema.md @@ -0,0 +1,27 @@ +# 锁定版 Gateway 协议 schema(2026-11-18) + +`v2026.7.1-2` 对应提交 `0790d9f593ad30c940ed93b5872a8cf6d6f3cf8c`。该版本将 `@openclaw/gateway-protocol` 定义为私有工作区包,npm 注册表没有同版本制品。使用该提交的官方生成器和原始协议定义生成了 Draft-07 JSON Schema。[上游包定义](https://github.com/openclaw/openclaw/blob/0790d9f593ad30c940ed93b5872a8cf6d6f3cf8c/packages/gateway-protocol/package.json) · [上游生成器](https://github.com/openclaw/openclaw/blob/0790d9f593ad30c940ed93b5872a8cf6d6f3cf8c/scripts/protocol-gen.ts) + +| 检查 | 结果 | +|---|---| +| 生成环境 | Node 24.18.0、tsx 4.22.4、typebox 1.3.3 | +| 产物 | `dist/protocol.schema.json`,714085 字节,322 项定义 | +| SHA-256 | `0c5758a9750691b6fb070c6344297bce6ddeba89afd715e45531a9508a168699` | +| 可复现性 | 连续执行两次生成器,结果逐字节一致。所有本地 definition 引用均可解析。 | +| ConnectParams | `gateway-client/backend` 通过校验。默认分支的 `openclaw-java-sdk/operator` 在两个枚举字段上均被拒绝。 | + +## 复现 + +将以下命令放在独立临时目录中执行。安装只用于运行锁定版生成器的依赖,源码与 SDK 工作区保持原状。 + +```bash +git clone --depth 1 --filter=blob:none --sparse --branch v2026.7.1-2 https://github.com/openclaw/openclaw.git source +git -C source sparse-checkout set --no-cone /packages/gateway-protocol/ /scripts/protocol-gen.ts /package.json +test "$(git -C source rev-parse HEAD)" = 0790d9f593ad30c940ed93b5872a8cf6d6f3cf8c +npm install --prefix tooling --ignore-scripts --no-audit --no-fund tsx@4.22.4 typebox@1.3.3 +ln -s "$(pwd)/tooling/node_modules" source/node_modules +(cd source && node --import tsx scripts/protocol-gen.ts) +shasum -a 256 source/dist/protocol.schema.json +``` + +使用锁定版 Gateway 安装包中的 Ajv 校验 `ConnectParams`。失败路径与此前运行中的 Gateway 拒绝结果一致。离线校验只覆盖字段结构和枚举,认证、服务器协商协议版本以及授权结果见 [真实 Gateway 基线验证](2026-11-18-live-gateway.md)。本记录不改变待评审的目标版本。 diff --git a/openspec/changes/establish-sdk-compatibility-governance/evidence/version-lock.md b/openspec/changes/establish-sdk-compatibility-governance/evidence/version-lock.md index 38b60a6..9b5e7b0 100644 --- a/openspec/changes/establish-sdk-compatibility-governance/evidence/version-lock.md +++ b/openspec/changes/establish-sdk-compatibility-governance/evidence/version-lock.md @@ -18,5 +18,4 @@ ## 声明 -锁定仅覆盖本机可获得的最新发布版;未取得官方对应版本的协议 schema 机器可读制品, -协议字段以官方文档和 [真实 Gateway 基线验证](2026-11-18-live-gateway.md) 为参照。G0 任务 3.1 已执行,版本锁定和 G1 编码仍待人审。 +已用锁定提交的官方生成器产出 [机器可读协议 schema](2026-11-18-locked-gateway-schema.md)。该版本的协议包属于上游私有工作区。运行时行为见 [真实 Gateway 基线验证](2026-11-18-live-gateway.md)。G0 任务 3.1 已执行,版本锁定和 G1 编码仍待人审。 From 12d593840646b55b5aa5f8944dee1d716f7ec2bb Mon Sep 17 00:00:00 2001 From: loong10k <20489781+loong10k@users.noreply.github.com> Date: Wed, 18 Nov 2026 23:30:02 +0800 Subject: [PATCH 07/22] docs: record OpenClaw SDK maintenance-line compatibility audit --- .../evidence/2026-11-18-live-gateway.md | 12 ++++++++++++ .../establish-sdk-compatibility-governance/tasks.md | 4 ++-- 2 files changed, 14 insertions(+), 2 deletions(-) diff --git a/openspec/changes/establish-sdk-compatibility-governance/evidence/2026-11-18-live-gateway.md b/openspec/changes/establish-sdk-compatibility-governance/evidence/2026-11-18-live-gateway.md index 5e9ed14..d6f6a45 100644 --- a/openspec/changes/establish-sdk-compatibility-governance/evidence/2026-11-18-live-gateway.md +++ b/openspec/changes/establish-sdk-compatibility-governance/evidence/2026-11-18-live-gateway.md @@ -28,3 +28,15 @@ 每条维护线使用 `OpenClawGatewayWsClient.connectHandshake()` 检查服务端返回的协议号,并调用 `sessionsList()`。认证失败由 Gateway 的 Token 不匹配记录确认。权限不足由 SDK 的 `OpenClawWsRpcException` 确认,异常保留方法名 `sessions.list` 和服务端的结构化错误。报告省略临时 Token 和连接标识。 锁定版本的基础运行检查满足 G0 任务 3.1。候选版本的结果用于后续版本选择评审。默认分支的兼容缺口计入后续 G1 握手工作。此检查未调用模型,版本与范围审批仍待人审。 + +## 维护线文档一致性 + +三条维护线分别比较 POM、Wrapper 配置、中英文 README 与 GitHub Release 说明。两份 README 的 Maven 和 Gradle 示例都使用该维护线 POM 中的快照版本。GitHub Release 说明使用同一版本号的非快照标签,说明原有版本的维护线,未附带 Maven 制品或 Gateway 兼容性测试结果。 + +| 维护线 | POM 快照版本 | JDK / Wrapper | Jackson databind | 文档提交 | 测试分支 CI | +|---|---|---|---|---|---| +| feature/1.0.x | 1.0.x.20260630-SNAPSHOT | 8 / 3.9.16 | com.fasterxml.jackson.core 2.18.9 | 3dc46a0e58200b086efc59029a43aa5c136bf61b | [成功](https://github.com/easy-4-java/openclaw-java-sdk/actions/runs/44335946637) | +| feature/2.0.x | 2.0.x.20260630-SNAPSHOT | 17 / 3.9.16 | com.fasterxml.jackson.core 2.22.1 | 9293a8cd2580435ec076b076d98c7965b77f0049 | [成功](https://github.com/easy-4-java/openclaw-java-sdk/actions/runs/44335947125) | +| feature/3.0.x | 3.0.x.20260630-SNAPSHOT | 21 / 4.0.0-rc-5 | tools.jackson.core 3.2.1 | 34b003b5c2c2158e536d3290ef67de7932ab78ef | [成功](https://github.com/easy-4-java/openclaw-java-sdk/actions/runs/44335951638) | + +三个提交仅修改各自的两份 README,已推送到对应的维护线。六份 README 均通过快照坐标、依赖版本、JDK、Wrapper、Release 标签和验证范围核对。文档明确记录实测的协议 4 握手、Token 认证和会话列表的读取权限检查,并标明 HTTP、SSE、CLI、模型调用及其余 RPC 的真实兼容性待验证。 diff --git a/openspec/changes/establish-sdk-compatibility-governance/tasks.md b/openspec/changes/establish-sdk-compatibility-governance/tasks.md index 27424eb..f5d992e 100644 --- a/openspec/changes/establish-sdk-compatibility-governance/tasks.md +++ b/openspec/changes/establish-sdk-compatibility-governance/tasks.md @@ -18,7 +18,7 @@ ## 3. 基线验证与文档同步 - [x] 3.1 对锁定 Gateway 执行基础健康、认证成功及授权拒绝检查;验收:记录真实目标版本、认证模式及脱敏结果,现有缺陷如实登记,不以消除尚未实施功能的失败为本阶段前提。证据见 [真实 Gateway 基线验证](evidence/2026-11-18-live-gateway.md)。 -- [ ] 3.2 修正文档中的版本、JDK、依赖和支持等级漂移;验收:逐分支核对 pom、README、发布说明,快照版本和未验证状态一致,无声称全量支持的空泛结论。 +- [x] 3.2 修正文档中的版本、JDK、依赖和支持等级漂移;证据见 [维护线文档一致性](evidence/2026-11-18-live-gateway.md#维护线文档一致性)。验收:逐分支核对 pom、README、发布说明,快照版本和未验证状态一致,无声称全量支持的空泛结论。 - [x] 3.3 记录实际 JDK/Maven/依赖来源与构建结果;(证据:evidence/2026-09-20-precursor-evidence.md §3.3)验收:每条分支都有独立结果,环境不足标为 BLOCKED,治理变更无运行资源触点时明确记录资源测试不适用原因。 - [x] 3.4 使用已固定版本的官方 OpenSpec CLI 校验全部变更并保存输出;openspec CLI 1.8.0,`validate --all --strict --no-interactive --json`:6/6 changes valid,issues 为空(证据:evidence/2026-09-20-precursor-evidence.md §3.4)验收:validate --all --strict --no-interactive --json 成功,不用自定义结构检查冒充官方校验。 - [ ] 3.5 评审治理变更的归档资格;验收:全部必需任务有证据、获准三分支规则已记录,只有治理规范本身可归档,后续功能提案不随之归档。 @@ -26,7 +26,7 @@ ## 执行记录(2026-09-20) 已由 AI 会话完成并附证据:1.2、1.3、2.1、3.3、3.4(见 evidence/ 目录)。 -保持未勾选(人审/环境门禁):1.1、2.2、2.3、2.4、3.2、3.5——原因逐条见 +当时未勾选(人审/环境门禁):1.1、2.2、2.3、2.4、3.2、3.5——原因逐条见 evidence/2026-09-20-precursor-evidence.md「阻塞项」。G1 编码保持阻断,待人审批准。 ## 执行记录(2026-11-18) From a0c1d084a876e1aef01c40f93e391e2a9474cb31 Mon Sep 17 00:00:00 2001 From: loong10k <20489781+loong10k@users.noreply.github.com> Date: Wed, 18 Nov 2026 23:33:15 +0800 Subject: [PATCH 08/22] docs: reconcile Gateway evidence and review gates --- docs/openclaw-integration/README.md | 2 +- docs/openclaw-integration/package-manifest.json | 2 +- .../design.md | 16 ++++++++++++++-- 3 files changed, 16 insertions(+), 4 deletions(-) diff --git a/docs/openclaw-integration/README.md b/docs/openclaw-integration/README.md index dc3c451..5d5c673 100644 --- a/docs/openclaw-integration/README.md +++ b/docs/openclaw-integration/README.md @@ -2,7 +2,7 @@ 版本 0.1.0-draft · 2026-09-20 · **待评审,未实施,未归档** -这是一套仓库内的 OpenSpec 变更草案,不是仅供讨论的差距清单。包含六组 proposal/design/tasks、21 个 capability spec、64 条 Requirement 和 128 个 Scenario;任务共 97 项,其中 6 项 G0 准入证据任务已勾选,91 项待完成。SDK 功能尚未按这些草案实施;检查结果见 [文档检查结果](validation-summary.md)。 +这是一套仓库内的 OpenSpec 变更草案,不是仅供讨论的差距清单。包含六组 proposal/design/tasks、21 个 capability spec、64 条 Requirement 和 128 个 Scenario;任务共 97 项,其中 7 项 G0 准入证据任务已勾选,90 项待完成。SDK 功能尚未按这些草案实施;检查结果见 [文档检查结果](validation-summary.md)。 ## 阅读顺序 diff --git a/docs/openclaw-integration/package-manifest.json b/docs/openclaw-integration/package-manifest.json index 07eb6a9..b67ae07 100644 --- a/docs/openclaw-integration/package-manifest.json +++ b/docs/openclaw-integration/package-manifest.json @@ -1 +1 @@ -{"scope":"repository documentation; paths relative to repository root; manifest excludes itself","source_package":"openclaw-java-sdk-openspec-draft-2026-09-20.zip","source_package_sha256":"f8eedbb0356b34ecde22584b57fdc9d375fa7409c36d6931b7faca36f4919468","files":{"docs/openclaw-integration/README.md":{"bytes":2882,"sha256":"43b72643d133501a9da6fd56e855e64e1f440991204c05ea35bb8d199bdaa01b"},"docs/openclaw-integration/acceptance-plan.md":{"bytes":4591,"sha256":"4875a07fd14cd9771d610d221ab8e666bf2801341b3ccc21302627f06fa2089f"},"docs/openclaw-integration/baseline.json":{"bytes":3221,"sha256":"b5b13dd410d068a5b07b4c27be01658aa94bb626dce9beffc44ebce9565789ab"},"docs/openclaw-integration/coverage-baseline.md":{"bytes":4792,"sha256":"ae4b7783b718a268c697fdd85f1f24800f838cb1063ae90e4324c224efc7f820"},"docs/openclaw-integration/roadmap.md":{"bytes":3880,"sha256":"edb7e1a9717f05e1128eda44fb41fbddcd595cfd2e165ab1ea6d920ca38d5aa6"},"docs/openclaw-integration/source-register.md":{"bytes":5424,"sha256":"992bf67dd8da00cccaeaf4a93ed594b2877d832ed3015b402c3a4eabb0b523f0"},"docs/openclaw-integration/traceability.json.gz":{"bytes":3246,"sha256":"75386731e6f4b685d61a8c582e18edbdc86577e717039716c1c908f8422befcd","decompressed_sha256":"da585354d01fb0f687d764840f7512259de832896db051fe450ac667fd6bf6bb"},"docs/openclaw-integration/traceability.md":{"bytes":13478,"sha256":"cd1b647ab538953e299a1964e009fbb65b4212654dab678bfb05e4fd1bcd2a59"},"docs/openclaw-integration/validation-report/README.md":{"bytes":1113,"sha256":"b67e0eb4a969e742b6e30e35883dcac0c3cc15aca0005e6d66377b99995e2932"},"docs/openclaw-integration/validation-report/part-001.b64":{"bytes":2601,"sha256":"9570f3b3818b997c948cb9ee4a5c4885d664cacdfec18e0b3d1e9858ae695a32"},"docs/openclaw-integration/validation-report/part-002.b64":{"bytes":2601,"sha256":"d57ebdd3717bab8648f4f98a70430515d0750ebb38cd72a970e246ddeb049952"},"docs/openclaw-integration/validation-report/part-003.b64":{"bytes":2537,"sha256":"61a7c754d543e645ad6b705add8f183ac0e6605340f0993b9bc5cb4647fef85b"},"docs/openclaw-integration/validation-summary.md":{"bytes":2141,"sha256":"40e31c0cd1ebb639cf1e852b0b0180bda27e28c16dcba9b90e3cb8aabd0f6d10"},"openspec/README.md":{"bytes":611,"sha256":"58a1b2615971f2c7fb56f069006b8559cf5cf1548c01b29c83758c894ec79f20"},"openspec/changes/add-agent-session-approval-control/.openspec.yaml":{"bytes":40,"sha256":"dc10040214104474c4e34e5b38359540c882aa7cfb6e7221e5d0614f1dba8fd7"},"openspec/changes/add-agent-session-approval-control/design.md":{"bytes":4797,"sha256":"95794f1f71841a3d6a5ca61d10bbffaf5be029f8284cf75ac4b6020e4564d3d1"},"openspec/changes/add-agent-session-approval-control/proposal.md":{"bytes":1936,"sha256":"da5665faa52a3e14e756e021e2b9dec56c5f6bb5d73af277e756050a4399c741"},"openspec/changes/add-agent-session-approval-control/specs/agent-lifecycle/spec.md":{"bytes":2664,"sha256":"0b12b0240d1a5d37bcaa8c69604ca53ca67c4a372440262d14ed01b0ffd1a174"},"openspec/changes/add-agent-session-approval-control/specs/approval-control/spec.md":{"bytes":2549,"sha256":"3b979ba5b34b8aa1e1fef3a216e663b5b194b7bce713092d73cc4eed83f0c09b"},"openspec/changes/add-agent-session-approval-control/specs/session-control/spec.md":{"bytes":2543,"sha256":"ecf939250f43f526c1d78a5a2bc2902e5889cf13474a7c80e440e7232d5c24fb"},"openspec/changes/add-agent-session-approval-control/tasks.md":{"bytes":3242,"sha256":"782b9f42a8b58fab966c04920d27a98ea77d588102594219572eae5b17cbad11"},"openspec/changes/add-gateway-operations/.openspec.yaml":{"bytes":40,"sha256":"dc10040214104474c4e34e5b38359540c882aa7cfb6e7221e5d0614f1dba8fd7"},"openspec/changes/add-gateway-operations/design.md":{"bytes":5441,"sha256":"d07d9f9c3c5da092be96a18f0e6c35be53fe06f2eda9f540ef993961be8f247d"},"openspec/changes/add-gateway-operations/proposal.md":{"bytes":2342,"sha256":"c6081bd3692307909e736b7d84ccc34828b4fa5152a118f86dc577fa6ac3d47f"},"openspec/changes/add-gateway-operations/specs/channel-node-control/spec.md":{"bytes":2663,"sha256":"4350182f113da6caff9cd0eb81f2cb5173be374bd2f6665e16a9f93111fb4649"},"openspec/changes/add-gateway-operations/specs/configuration-control/spec.md":{"bytes":2432,"sha256":"cf8839be9d8c9015cfb855422fcdfdfaee02275965f2b3a12b42ce4987b8b3c1"},"openspec/changes/add-gateway-operations/specs/cron-control/spec.md":{"bytes":2453,"sha256":"8f86038254595e09c705b4b680d41aed60b2332f019139e35b5a65c329774274"},"openspec/changes/add-gateway-operations/specs/skill-plugin-lifecycle/spec.md":{"bytes":2551,"sha256":"01ef9d030ab116a21bcca1ff7f8d9ced27968015939cd1bf4c2ed99955f445bd"},"openspec/changes/add-gateway-operations/specs/task-audit-artifacts/spec.md":{"bytes":2597,"sha256":"8d2cb83159ed06b09358d3f950ae20489ea964a864c289168ab2c5a8e57ffadb"},"openspec/changes/add-gateway-operations/specs/tool-model-catalogs/spec.md":{"bytes":2463,"sha256":"a424d99c94d69cb61fa9e3f0efeb9dc8c1702d37c397f789c3363a79066df547"},"openspec/changes/add-gateway-operations/tasks.md":{"bytes":5352,"sha256":"12b19adb7b2a84e0fc263e8a8378719d2f5978f2dc5f619f3c856eb70a66b4f5"},"openspec/changes/add-managed-gateway-client/.openspec.yaml":{"bytes":40,"sha256":"dc10040214104474c4e34e5b38359540c882aa7cfb6e7221e5d0614f1dba8fd7"},"openspec/changes/add-managed-gateway-client/design.md":{"bytes":5113,"sha256":"162801004ae85138dc1d03ecb0654506986c26053bfe6fa9e72704edb01de6a2"},"openspec/changes/add-managed-gateway-client/proposal.md":{"bytes":2019,"sha256":"a91469801a7becd8ab01272697394c1d44c367ac2ae0666814b6f6b5706a01cf"},"openspec/changes/add-managed-gateway-client/specs/gateway-recovery/spec.md":{"bytes":2762,"sha256":"af082acc14c97793b8f9231b500e86e8e5c77455ae04a88b0b24fdfa4ed3335e"},"openspec/changes/add-managed-gateway-client/specs/managed-rpc/spec.md":{"bytes":2624,"sha256":"6aa6031b61a113443b8d560e58baae1c041ddc465630b736fa9a23b1fdb4408d"},"openspec/changes/add-managed-gateway-client/specs/typed-event-delivery/spec.md":{"bytes":2613,"sha256":"c5def41f0c9510153b5eb773521778d6121cad2ca4b2bdc733e9cfaa40275552"},"openspec/changes/add-managed-gateway-client/tasks.md":{"bytes":3249,"sha256":"978d020d94027db3801c090dd7e86bbd65b2568c64880950320e57087ee96970"},"openspec/changes/add-optional-runtime-adapters/.openspec.yaml":{"bytes":40,"sha256":"dc10040214104474c4e34e5b38359540c882aa7cfb6e7221e5d0614f1dba8fd7"},"openspec/changes/add-optional-runtime-adapters/design.md":{"bytes":4940,"sha256":"65332fcd6d91ff4ca9e77d53f606caccec2795fae74160bb95d357da482546c9"},"openspec/changes/add-optional-runtime-adapters/proposal.md":{"bytes":2065,"sha256":"a32b0507234b8e78719cb7716dc484212797b3c0259daa76931bf2c7820b4b3e"},"openspec/changes/add-optional-runtime-adapters/specs/cli-typed-results/spec.md":{"bytes":2609,"sha256":"2f9836a84b4b5ae66abae680ef1ec52c35531029b4682a75cc5a3c2e8cc6c67f"},"openspec/changes/add-optional-runtime-adapters/specs/persistent-stdio-adapters/spec.md":{"bytes":2509,"sha256":"ea7d2f8599d97c4ccd8f23ada658f636be62d2bdb715ed82f026a22286a7a3db"},"openspec/changes/add-optional-runtime-adapters/specs/terminal-voice-adapters/spec.md":{"bytes":2620,"sha256":"77fbb21d872b83da1cda418e6a7e1d94b0ea496ac566e6808225f2031a1c39a0"},"openspec/changes/add-optional-runtime-adapters/tasks.md":{"bytes":3318,"sha256":"a86f42485573c87ffa97e3296c3c20cfc128b63db40166a28ee7daf48e1b9f0c"},"openspec/changes/establish-sdk-compatibility-governance/.openspec.yaml":{"bytes":40,"sha256":"dc10040214104474c4e34e5b38359540c882aa7cfb6e7221e5d0614f1dba8fd7"},"openspec/changes/establish-sdk-compatibility-governance/design.md":{"bytes":4395,"sha256":"5eef818703376fa417abdff26f2b3ce0bc5761f643f4378cf985abc49dc35e92"},"openspec/changes/establish-sdk-compatibility-governance/evidence/2026-09-20-precursor-evidence.md":{"bytes":2383,"sha256":"e55309e91a1f190e62b3c29de385509def154a9d534f2963d8f4b69c4fd27db4"},"openspec/changes/establish-sdk-compatibility-governance/evidence/2026-11-18-live-gateway.md":{"bytes":2844,"sha256":"358d5e6387706c457d8e791d9177e967dbc9eb91e52f7201fed5e417ef424bde"},"openspec/changes/establish-sdk-compatibility-governance/evidence/2026-11-18-locked-gateway-schema.md":{"bytes":2169,"sha256":"6728253fe492a99ebc24eb8c3bc261331317a6324db7c3a168610883ab41048f"},"openspec/changes/establish-sdk-compatibility-governance/evidence/capability-inventory.json":{"bytes":2118,"sha256":"c8148e22712176d1991cec37e8f80861996053c693f76a2998a3f7a37fd00822"},"openspec/changes/establish-sdk-compatibility-governance/evidence/version-lock.md":{"bytes":1139,"sha256":"7d53174fb9aad9244934bafec50f364ce869f8bcb92445b96aba2c2af64e67f3"},"openspec/changes/establish-sdk-compatibility-governance/proposal.md":{"bytes":1789,"sha256":"88e18f4f66ebccace6da321cb7d0a6b4d788e8e84cc933ab3678a5389b459ed6"},"openspec/changes/establish-sdk-compatibility-governance/specs/sdk-compatibility-governance/spec.md":{"bytes":3830,"sha256":"3d14086cef101a78b83ef953e16cea13b4b341ca9c9552c62596ee9ab85131a1"},"openspec/changes/establish-sdk-compatibility-governance/tasks.md":{"bytes":3826,"sha256":"fe863141995709c662d3cb1f12c4e2b7506ce5d22c84f30b00053d2b3d85f95d"},"openspec/changes/fix-openclaw-protocol-contracts/.openspec.yaml":{"bytes":40,"sha256":"dc10040214104474c4e34e5b38359540c882aa7cfb6e7221e5d0614f1dba8fd7"},"openspec/changes/fix-openclaw-protocol-contracts/design.md":{"bytes":5675,"sha256":"10966f9bc03d3b34138539aeeb4b7ad884b28763cc2290c1f95926b69335dbbb"},"openspec/changes/fix-openclaw-protocol-contracts/proposal.md":{"bytes":2418,"sha256":"11a51837e386f1068004c526673547610a5b84dca8b42fc6d9484da02cc9b270"},"openspec/changes/fix-openclaw-protocol-contracts/specs/gateway-chat-events/spec.md":{"bytes":2622,"sha256":"3564b6061b568c1d30577fc8b228243f21df756321de9e50dd4a763529afb5b9"},"openspec/changes/fix-openclaw-protocol-contracts/specs/gateway-device-auth/spec.md":{"bytes":2806,"sha256":"2a6d8d7d5202495cdace92ffd12a500ee9f0266a172aa4147852e4cf43ee2a4a"},"openspec/changes/fix-openclaw-protocol-contracts/specs/responses-streaming/spec.md":{"bytes":2695,"sha256":"1ca9b80db706c236ca32ae0acd8a02a190fc3644959aa58af4379035923c3b82"},"openspec/changes/fix-openclaw-protocol-contracts/specs/session-history-contract/spec.md":{"bytes":2651,"sha256":"7fcc7baab4e3d9f10dd86adb03e00f78b07a7f011747a744224ca3dadf89168c"},"openspec/changes/fix-openclaw-protocol-contracts/specs/tools-invoke-contract/spec.md":{"bytes":2681,"sha256":"f255110ecff5a9479b780ec81dce1c451d638fe69259196e0ef063c5343a62f1"},"openspec/changes/fix-openclaw-protocol-contracts/tasks.md":{"bytes":4698,"sha256":"fd7a21979c085430e70479494b8f87c88e9746cf277463628a93a92a7932130a"},"openspec/config.yaml":{"bytes":1862,"sha256":"151f5ce61678f2d47d19a1c21168936f7ad5c6f05adec25db6a0e8a70f1f8ba9"},"openspec/specs/.gitkeep":{"bytes":1,"sha256":"01ba4719c80b6fe911b091a7c05124b64eeece964e09c058ef8f9805daca546b"}},"split_report":{"path":"docs/openclaw-integration/validation-report","encoding":"concatenated-base64-of-gzip","original_bytes":127699,"original_sha256":"a689415d7e7c1a28cc50a97179c797adc29080b30f5ec929aa8ed23227a1a598","parts":3},"source_package_note":"The source package hash identifies the original 2026-09-20 bundle. The file inventory also includes subsequent G0 evidence and documentation edits."} +{"scope":"repository documentation; paths relative to repository root; manifest excludes itself","source_package":"openclaw-java-sdk-openspec-draft-2026-09-20.zip","source_package_sha256":"f8eedbb0356b34ecde22584b57fdc9d375fa7409c36d6931b7faca36f4919468","files":{"docs/openclaw-integration/README.md":{"bytes":2882,"sha256":"7af61aea4d0c57c7e1f2c2b83a52126c4ab5b00f6a98962ead41687128789225"},"docs/openclaw-integration/acceptance-plan.md":{"bytes":4591,"sha256":"4875a07fd14cd9771d610d221ab8e666bf2801341b3ccc21302627f06fa2089f"},"docs/openclaw-integration/baseline.json":{"bytes":3221,"sha256":"b5b13dd410d068a5b07b4c27be01658aa94bb626dce9beffc44ebce9565789ab"},"docs/openclaw-integration/coverage-baseline.md":{"bytes":4792,"sha256":"ae4b7783b718a268c697fdd85f1f24800f838cb1063ae90e4324c224efc7f820"},"docs/openclaw-integration/roadmap.md":{"bytes":3880,"sha256":"edb7e1a9717f05e1128eda44fb41fbddcd595cfd2e165ab1ea6d920ca38d5aa6"},"docs/openclaw-integration/source-register.md":{"bytes":5424,"sha256":"992bf67dd8da00cccaeaf4a93ed594b2877d832ed3015b402c3a4eabb0b523f0"},"docs/openclaw-integration/traceability.json.gz":{"bytes":3246,"sha256":"75386731e6f4b685d61a8c582e18edbdc86577e717039716c1c908f8422befcd","decompressed_sha256":"da585354d01fb0f687d764840f7512259de832896db051fe450ac667fd6bf6bb"},"docs/openclaw-integration/traceability.md":{"bytes":13478,"sha256":"cd1b647ab538953e299a1964e009fbb65b4212654dab678bfb05e4fd1bcd2a59"},"docs/openclaw-integration/validation-report/README.md":{"bytes":1113,"sha256":"b67e0eb4a969e742b6e30e35883dcac0c3cc15aca0005e6d66377b99995e2932"},"docs/openclaw-integration/validation-report/part-001.b64":{"bytes":2601,"sha256":"9570f3b3818b997c948cb9ee4a5c4885d664cacdfec18e0b3d1e9858ae695a32"},"docs/openclaw-integration/validation-report/part-002.b64":{"bytes":2601,"sha256":"d57ebdd3717bab8648f4f98a70430515d0750ebb38cd72a970e246ddeb049952"},"docs/openclaw-integration/validation-report/part-003.b64":{"bytes":2537,"sha256":"61a7c754d543e645ad6b705add8f183ac0e6605340f0993b9bc5cb4647fef85b"},"docs/openclaw-integration/validation-summary.md":{"bytes":2141,"sha256":"40e31c0cd1ebb639cf1e852b0b0180bda27e28c16dcba9b90e3cb8aabd0f6d10"},"openspec/README.md":{"bytes":611,"sha256":"58a1b2615971f2c7fb56f069006b8559cf5cf1548c01b29c83758c894ec79f20"},"openspec/changes/add-agent-session-approval-control/.openspec.yaml":{"bytes":40,"sha256":"dc10040214104474c4e34e5b38359540c882aa7cfb6e7221e5d0614f1dba8fd7"},"openspec/changes/add-agent-session-approval-control/design.md":{"bytes":4797,"sha256":"95794f1f71841a3d6a5ca61d10bbffaf5be029f8284cf75ac4b6020e4564d3d1"},"openspec/changes/add-agent-session-approval-control/proposal.md":{"bytes":1936,"sha256":"da5665faa52a3e14e756e021e2b9dec56c5f6bb5d73af277e756050a4399c741"},"openspec/changes/add-agent-session-approval-control/specs/agent-lifecycle/spec.md":{"bytes":2664,"sha256":"0b12b0240d1a5d37bcaa8c69604ca53ca67c4a372440262d14ed01b0ffd1a174"},"openspec/changes/add-agent-session-approval-control/specs/approval-control/spec.md":{"bytes":2549,"sha256":"3b979ba5b34b8aa1e1fef3a216e663b5b194b7bce713092d73cc4eed83f0c09b"},"openspec/changes/add-agent-session-approval-control/specs/session-control/spec.md":{"bytes":2543,"sha256":"ecf939250f43f526c1d78a5a2bc2902e5889cf13474a7c80e440e7232d5c24fb"},"openspec/changes/add-agent-session-approval-control/tasks.md":{"bytes":3242,"sha256":"782b9f42a8b58fab966c04920d27a98ea77d588102594219572eae5b17cbad11"},"openspec/changes/add-gateway-operations/.openspec.yaml":{"bytes":40,"sha256":"dc10040214104474c4e34e5b38359540c882aa7cfb6e7221e5d0614f1dba8fd7"},"openspec/changes/add-gateway-operations/design.md":{"bytes":5441,"sha256":"d07d9f9c3c5da092be96a18f0e6c35be53fe06f2eda9f540ef993961be8f247d"},"openspec/changes/add-gateway-operations/proposal.md":{"bytes":2342,"sha256":"c6081bd3692307909e736b7d84ccc34828b4fa5152a118f86dc577fa6ac3d47f"},"openspec/changes/add-gateway-operations/specs/channel-node-control/spec.md":{"bytes":2663,"sha256":"4350182f113da6caff9cd0eb81f2cb5173be374bd2f6665e16a9f93111fb4649"},"openspec/changes/add-gateway-operations/specs/configuration-control/spec.md":{"bytes":2432,"sha256":"cf8839be9d8c9015cfb855422fcdfdfaee02275965f2b3a12b42ce4987b8b3c1"},"openspec/changes/add-gateway-operations/specs/cron-control/spec.md":{"bytes":2453,"sha256":"8f86038254595e09c705b4b680d41aed60b2332f019139e35b5a65c329774274"},"openspec/changes/add-gateway-operations/specs/skill-plugin-lifecycle/spec.md":{"bytes":2551,"sha256":"01ef9d030ab116a21bcca1ff7f8d9ced27968015939cd1bf4c2ed99955f445bd"},"openspec/changes/add-gateway-operations/specs/task-audit-artifacts/spec.md":{"bytes":2597,"sha256":"8d2cb83159ed06b09358d3f950ae20489ea964a864c289168ab2c5a8e57ffadb"},"openspec/changes/add-gateway-operations/specs/tool-model-catalogs/spec.md":{"bytes":2463,"sha256":"a424d99c94d69cb61fa9e3f0efeb9dc8c1702d37c397f789c3363a79066df547"},"openspec/changes/add-gateway-operations/tasks.md":{"bytes":5352,"sha256":"12b19adb7b2a84e0fc263e8a8378719d2f5978f2dc5f619f3c856eb70a66b4f5"},"openspec/changes/add-managed-gateway-client/.openspec.yaml":{"bytes":40,"sha256":"dc10040214104474c4e34e5b38359540c882aa7cfb6e7221e5d0614f1dba8fd7"},"openspec/changes/add-managed-gateway-client/design.md":{"bytes":5113,"sha256":"162801004ae85138dc1d03ecb0654506986c26053bfe6fa9e72704edb01de6a2"},"openspec/changes/add-managed-gateway-client/proposal.md":{"bytes":2019,"sha256":"a91469801a7becd8ab01272697394c1d44c367ac2ae0666814b6f6b5706a01cf"},"openspec/changes/add-managed-gateway-client/specs/gateway-recovery/spec.md":{"bytes":2762,"sha256":"af082acc14c97793b8f9231b500e86e8e5c77455ae04a88b0b24fdfa4ed3335e"},"openspec/changes/add-managed-gateway-client/specs/managed-rpc/spec.md":{"bytes":2624,"sha256":"6aa6031b61a113443b8d560e58baae1c041ddc465630b736fa9a23b1fdb4408d"},"openspec/changes/add-managed-gateway-client/specs/typed-event-delivery/spec.md":{"bytes":2613,"sha256":"c5def41f0c9510153b5eb773521778d6121cad2ca4b2bdc733e9cfaa40275552"},"openspec/changes/add-managed-gateway-client/tasks.md":{"bytes":3249,"sha256":"978d020d94027db3801c090dd7e86bbd65b2568c64880950320e57087ee96970"},"openspec/changes/add-optional-runtime-adapters/.openspec.yaml":{"bytes":40,"sha256":"dc10040214104474c4e34e5b38359540c882aa7cfb6e7221e5d0614f1dba8fd7"},"openspec/changes/add-optional-runtime-adapters/design.md":{"bytes":4940,"sha256":"65332fcd6d91ff4ca9e77d53f606caccec2795fae74160bb95d357da482546c9"},"openspec/changes/add-optional-runtime-adapters/proposal.md":{"bytes":2065,"sha256":"a32b0507234b8e78719cb7716dc484212797b3c0259daa76931bf2c7820b4b3e"},"openspec/changes/add-optional-runtime-adapters/specs/cli-typed-results/spec.md":{"bytes":2609,"sha256":"2f9836a84b4b5ae66abae680ef1ec52c35531029b4682a75cc5a3c2e8cc6c67f"},"openspec/changes/add-optional-runtime-adapters/specs/persistent-stdio-adapters/spec.md":{"bytes":2509,"sha256":"ea7d2f8599d97c4ccd8f23ada658f636be62d2bdb715ed82f026a22286a7a3db"},"openspec/changes/add-optional-runtime-adapters/specs/terminal-voice-adapters/spec.md":{"bytes":2620,"sha256":"77fbb21d872b83da1cda418e6a7e1d94b0ea496ac566e6808225f2031a1c39a0"},"openspec/changes/add-optional-runtime-adapters/tasks.md":{"bytes":3318,"sha256":"a86f42485573c87ffa97e3296c3c20cfc128b63db40166a28ee7daf48e1b9f0c"},"openspec/changes/establish-sdk-compatibility-governance/.openspec.yaml":{"bytes":40,"sha256":"dc10040214104474c4e34e5b38359540c882aa7cfb6e7221e5d0614f1dba8fd7"},"openspec/changes/establish-sdk-compatibility-governance/design.md":{"bytes":5448,"sha256":"d3150d2e298788a186c934920cb111bdef4b6801e6c34052741b61895c4dd372"},"openspec/changes/establish-sdk-compatibility-governance/evidence/2026-09-20-precursor-evidence.md":{"bytes":2383,"sha256":"e55309e91a1f190e62b3c29de385509def154a9d534f2963d8f4b69c4fd27db4"},"openspec/changes/establish-sdk-compatibility-governance/evidence/2026-11-18-live-gateway.md":{"bytes":4373,"sha256":"1222733692bee7da3f2d045fc7ff2b0da96a440c065162d900ab4b6b3731be4e"},"openspec/changes/establish-sdk-compatibility-governance/evidence/2026-11-18-locked-gateway-schema.md":{"bytes":2169,"sha256":"6728253fe492a99ebc24eb8c3bc261331317a6324db7c3a168610883ab41048f"},"openspec/changes/establish-sdk-compatibility-governance/evidence/capability-inventory.json":{"bytes":2118,"sha256":"c8148e22712176d1991cec37e8f80861996053c693f76a2998a3f7a37fd00822"},"openspec/changes/establish-sdk-compatibility-governance/evidence/version-lock.md":{"bytes":1139,"sha256":"7d53174fb9aad9244934bafec50f364ce869f8bcb92445b96aba2c2af64e67f3"},"openspec/changes/establish-sdk-compatibility-governance/proposal.md":{"bytes":1789,"sha256":"88e18f4f66ebccace6da321cb7d0a6b4d788e8e84cc933ab3678a5389b459ed6"},"openspec/changes/establish-sdk-compatibility-governance/specs/sdk-compatibility-governance/spec.md":{"bytes":3830,"sha256":"3d14086cef101a78b83ef953e16cea13b4b341ca9c9552c62596ee9ab85131a1"},"openspec/changes/establish-sdk-compatibility-governance/tasks.md":{"bytes":3927,"sha256":"64186486d2bc39ad7e9ca7190c1704ad0b6188b8e4957513b9554c5c574582b6"},"openspec/changes/fix-openclaw-protocol-contracts/.openspec.yaml":{"bytes":40,"sha256":"dc10040214104474c4e34e5b38359540c882aa7cfb6e7221e5d0614f1dba8fd7"},"openspec/changes/fix-openclaw-protocol-contracts/design.md":{"bytes":5675,"sha256":"10966f9bc03d3b34138539aeeb4b7ad884b28763cc2290c1f95926b69335dbbb"},"openspec/changes/fix-openclaw-protocol-contracts/proposal.md":{"bytes":2418,"sha256":"11a51837e386f1068004c526673547610a5b84dca8b42fc6d9484da02cc9b270"},"openspec/changes/fix-openclaw-protocol-contracts/specs/gateway-chat-events/spec.md":{"bytes":2622,"sha256":"3564b6061b568c1d30577fc8b228243f21df756321de9e50dd4a763529afb5b9"},"openspec/changes/fix-openclaw-protocol-contracts/specs/gateway-device-auth/spec.md":{"bytes":2806,"sha256":"2a6d8d7d5202495cdace92ffd12a500ee9f0266a172aa4147852e4cf43ee2a4a"},"openspec/changes/fix-openclaw-protocol-contracts/specs/responses-streaming/spec.md":{"bytes":2695,"sha256":"1ca9b80db706c236ca32ae0acd8a02a190fc3644959aa58af4379035923c3b82"},"openspec/changes/fix-openclaw-protocol-contracts/specs/session-history-contract/spec.md":{"bytes":2651,"sha256":"7fcc7baab4e3d9f10dd86adb03e00f78b07a7f011747a744224ca3dadf89168c"},"openspec/changes/fix-openclaw-protocol-contracts/specs/tools-invoke-contract/spec.md":{"bytes":2681,"sha256":"f255110ecff5a9479b780ec81dce1c451d638fe69259196e0ef063c5343a62f1"},"openspec/changes/fix-openclaw-protocol-contracts/tasks.md":{"bytes":4698,"sha256":"fd7a21979c085430e70479494b8f87c88e9746cf277463628a93a92a7932130a"},"openspec/config.yaml":{"bytes":1862,"sha256":"151f5ce61678f2d47d19a1c21168936f7ad5c6f05adec25db6a0e8a70f1f8ba9"},"openspec/specs/.gitkeep":{"bytes":1,"sha256":"01ba4719c80b6fe911b091a7c05124b64eeece964e09c058ef8f9805daca546b"}},"split_report":{"path":"docs/openclaw-integration/validation-report","encoding":"concatenated-base64-of-gzip","original_bytes":127699,"original_sha256":"a689415d7e7c1a28cc50a97179c797adc29080b30f5ec929aa8ed23227a1a598","parts":3},"source_package_note":"The source package hash identifies the original 2026-09-20 bundle. The file inventory also includes subsequent G0 evidence and documentation edits."} diff --git a/openspec/changes/establish-sdk-compatibility-governance/design.md b/openspec/changes/establish-sdk-compatibility-governance/design.md index 2de84c7..a44944e 100644 --- a/openspec/changes/establish-sdk-compatibility-governance/design.md +++ b/openspec/changes/establish-sdk-compatibility-governance/design.md @@ -4,7 +4,7 @@ ## Context -动机与范围见 proposal.md;固定的 SDK HEAD、静态观察和证据等级见 [coverage-baseline](../../../docs/openclaw-integration/coverage-baseline.md)。当前文档基于公开协议说明和此前源码静态核查,不包含真实 Gateway 验证。在线文档随时间变化;目标版本锁定仍是实施前的阻断条件。 +动机与范围见 [proposal](proposal.md)。首次静态核查的 SDK 提交与证据等级见 [coverage-baseline](../../../docs/openclaw-integration/coverage-baseline.md)。G0 后续验证覆盖三条维护线和默认分支,具体运行结果见 [真实 Gateway 基线验证](evidence/2026-11-18-live-gateway.md)。 ## Goals / Non-Goals @@ -14,7 +14,7 @@ 采用共同契约、分支独立证据的方式,不把三个分支合并成一条开发线,也不新增统一发行版本。共享 fixture 的期望语义保持一致;Java 8 语法、Jackson 2/3 包名和宿主扩展点的差异记录到兼容清单。 -已读取的 SDK HEAD 可精确固定;在线 OpenClaw 文档不等于已测试发布版本。因此先允许文档评审,实施前必须选定可获得的 Gateway 精确版本/提交与构建来源,并核实其协议文件、方法、事件和权限。当前没有选择或测试该版本,状态为 BLOCKED_VERSION_PIN。 +G0 记录的目标是 OpenClaw 2026.7.1-2(`0790d9f`)。[版本锁定记录](evidence/version-lock.md) 和 [官方生成的协议 schema](evidence/2026-11-18-locked-gateway-schema.md) 提供版本与契约依据。2026.11.5 的运行结果用于候选比较。目标版本和实施范围仍需人审确认,后续能力还需按锁定版本逐项核对方法、事件和权限。 不把根 specs 填成未来蓝图。由于仓库尚无本轮能力的生效规范,这些能力首次以 ADDED Requirements 建档;ADDED 指新增规范条目,不断言全部代码此前不存在。归档是未来行为,需经过本项目人审和实施证据核验。 @@ -47,6 +47,18 @@ 需求与场景的逐项映射见 [traceability](../../../docs/openclaw-integration/traceability.md)。每项能力须完成固定样本验证、受控模拟、适用分支构建及真实 Gateway 验收。资源测试至少覆盖成功、失败、取消、deadline、断线和用户回调异常。缺失环境的测试记录 BLOCKED,不记录 PASS。 +## 评审与归档判定 + +| 状态 | 进入条件 | +|---|---| +| DRAFT | 提案可审阅,任务和场景按现有证据标明进度。当前属于此状态。 | +| REVIEWED | 维护者在 PR 记录通过的范围、依赖、目标版本和对应提交。 | +| IMPLEMENTED | 已批准的变更落到目标分支。记录实现提交和执行结果。 | +| VERIFIED | 按场景核对每条适用维护线的提交、命令、运行结果与证据。适用范围例外须有评审记录。 | +| ARCHIVED | 维护者复核归档资格,同步该变更的增量规范并确认归档结果。 | + +评审时以 [场景追踪表](../../../docs/openclaw-integration/traceability.md) 和 [任务清单](tasks.md) 对照每项证据。任何必需任务未完成、场景失败或证据缺失,都应在 PR 上列出对应编号并暂停归档。OpenSpec strict 校验用于校验规格结构,归档资格由维护者按本表复核。当前缺少范围批准、三线共享协议样本和逐场景证据,归档条件尚未满足。 + ## Sources [O00 OpenClaw 文档索引](https://docs.openclaw.ai/llms.txt);[O01 外部应用接入边界](https://docs.openclaw.ai/gateway/external-apps);[O02 协议版本与客户端恢复边界](https://docs.openclaw.ai/gateway/protocol/versioning);[S01 OpenSpec 概念与变更目录](https://github.com/Fission-AI/OpenSpec/blob/main/docs/concepts.md);[S02 OpenSpec spec-driven schema](https://github.com/Fission-AI/OpenSpec/blob/main/schemas/spec-driven/schema.yaml) From b3e4bf4e7625671c9bec05e1c63bfb09bfdbf45d Mon Sep 17 00:00:00 2001 From: loong10k <20489781+loong10k@users.noreply.github.com> Date: Wed, 18 Nov 2026 23:48:36 +0800 Subject: [PATCH 09/22] test: add shared OpenClaw Gateway compatibility fixture --- .../package-manifest.json | 2 +- .../evidence/2026-11-18-live-gateway.md | 24 ++++++ .../GatewayCompatibilityFixtureTest.java | 77 +++++++++++++++++++ .../tasks.md | 2 +- 4 files changed, 103 insertions(+), 2 deletions(-) create mode 100644 openspec/changes/establish-sdk-compatibility-governance/evidence/fixtures/GatewayCompatibilityFixtureTest.java diff --git a/docs/openclaw-integration/package-manifest.json b/docs/openclaw-integration/package-manifest.json index b67ae07..8570fe3 100644 --- a/docs/openclaw-integration/package-manifest.json +++ b/docs/openclaw-integration/package-manifest.json @@ -1 +1 @@ -{"scope":"repository documentation; paths relative to repository root; manifest excludes itself","source_package":"openclaw-java-sdk-openspec-draft-2026-09-20.zip","source_package_sha256":"f8eedbb0356b34ecde22584b57fdc9d375fa7409c36d6931b7faca36f4919468","files":{"docs/openclaw-integration/README.md":{"bytes":2882,"sha256":"7af61aea4d0c57c7e1f2c2b83a52126c4ab5b00f6a98962ead41687128789225"},"docs/openclaw-integration/acceptance-plan.md":{"bytes":4591,"sha256":"4875a07fd14cd9771d610d221ab8e666bf2801341b3ccc21302627f06fa2089f"},"docs/openclaw-integration/baseline.json":{"bytes":3221,"sha256":"b5b13dd410d068a5b07b4c27be01658aa94bb626dce9beffc44ebce9565789ab"},"docs/openclaw-integration/coverage-baseline.md":{"bytes":4792,"sha256":"ae4b7783b718a268c697fdd85f1f24800f838cb1063ae90e4324c224efc7f820"},"docs/openclaw-integration/roadmap.md":{"bytes":3880,"sha256":"edb7e1a9717f05e1128eda44fb41fbddcd595cfd2e165ab1ea6d920ca38d5aa6"},"docs/openclaw-integration/source-register.md":{"bytes":5424,"sha256":"992bf67dd8da00cccaeaf4a93ed594b2877d832ed3015b402c3a4eabb0b523f0"},"docs/openclaw-integration/traceability.json.gz":{"bytes":3246,"sha256":"75386731e6f4b685d61a8c582e18edbdc86577e717039716c1c908f8422befcd","decompressed_sha256":"da585354d01fb0f687d764840f7512259de832896db051fe450ac667fd6bf6bb"},"docs/openclaw-integration/traceability.md":{"bytes":13478,"sha256":"cd1b647ab538953e299a1964e009fbb65b4212654dab678bfb05e4fd1bcd2a59"},"docs/openclaw-integration/validation-report/README.md":{"bytes":1113,"sha256":"b67e0eb4a969e742b6e30e35883dcac0c3cc15aca0005e6d66377b99995e2932"},"docs/openclaw-integration/validation-report/part-001.b64":{"bytes":2601,"sha256":"9570f3b3818b997c948cb9ee4a5c4885d664cacdfec18e0b3d1e9858ae695a32"},"docs/openclaw-integration/validation-report/part-002.b64":{"bytes":2601,"sha256":"d57ebdd3717bab8648f4f98a70430515d0750ebb38cd72a970e246ddeb049952"},"docs/openclaw-integration/validation-report/part-003.b64":{"bytes":2537,"sha256":"61a7c754d543e645ad6b705add8f183ac0e6605340f0993b9bc5cb4647fef85b"},"docs/openclaw-integration/validation-summary.md":{"bytes":2141,"sha256":"40e31c0cd1ebb639cf1e852b0b0180bda27e28c16dcba9b90e3cb8aabd0f6d10"},"openspec/README.md":{"bytes":611,"sha256":"58a1b2615971f2c7fb56f069006b8559cf5cf1548c01b29c83758c894ec79f20"},"openspec/changes/add-agent-session-approval-control/.openspec.yaml":{"bytes":40,"sha256":"dc10040214104474c4e34e5b38359540c882aa7cfb6e7221e5d0614f1dba8fd7"},"openspec/changes/add-agent-session-approval-control/design.md":{"bytes":4797,"sha256":"95794f1f71841a3d6a5ca61d10bbffaf5be029f8284cf75ac4b6020e4564d3d1"},"openspec/changes/add-agent-session-approval-control/proposal.md":{"bytes":1936,"sha256":"da5665faa52a3e14e756e021e2b9dec56c5f6bb5d73af277e756050a4399c741"},"openspec/changes/add-agent-session-approval-control/specs/agent-lifecycle/spec.md":{"bytes":2664,"sha256":"0b12b0240d1a5d37bcaa8c69604ca53ca67c4a372440262d14ed01b0ffd1a174"},"openspec/changes/add-agent-session-approval-control/specs/approval-control/spec.md":{"bytes":2549,"sha256":"3b979ba5b34b8aa1e1fef3a216e663b5b194b7bce713092d73cc4eed83f0c09b"},"openspec/changes/add-agent-session-approval-control/specs/session-control/spec.md":{"bytes":2543,"sha256":"ecf939250f43f526c1d78a5a2bc2902e5889cf13474a7c80e440e7232d5c24fb"},"openspec/changes/add-agent-session-approval-control/tasks.md":{"bytes":3242,"sha256":"782b9f42a8b58fab966c04920d27a98ea77d588102594219572eae5b17cbad11"},"openspec/changes/add-gateway-operations/.openspec.yaml":{"bytes":40,"sha256":"dc10040214104474c4e34e5b38359540c882aa7cfb6e7221e5d0614f1dba8fd7"},"openspec/changes/add-gateway-operations/design.md":{"bytes":5441,"sha256":"d07d9f9c3c5da092be96a18f0e6c35be53fe06f2eda9f540ef993961be8f247d"},"openspec/changes/add-gateway-operations/proposal.md":{"bytes":2342,"sha256":"c6081bd3692307909e736b7d84ccc34828b4fa5152a118f86dc577fa6ac3d47f"},"openspec/changes/add-gateway-operations/specs/channel-node-control/spec.md":{"bytes":2663,"sha256":"4350182f113da6caff9cd0eb81f2cb5173be374bd2f6665e16a9f93111fb4649"},"openspec/changes/add-gateway-operations/specs/configuration-control/spec.md":{"bytes":2432,"sha256":"cf8839be9d8c9015cfb855422fcdfdfaee02275965f2b3a12b42ce4987b8b3c1"},"openspec/changes/add-gateway-operations/specs/cron-control/spec.md":{"bytes":2453,"sha256":"8f86038254595e09c705b4b680d41aed60b2332f019139e35b5a65c329774274"},"openspec/changes/add-gateway-operations/specs/skill-plugin-lifecycle/spec.md":{"bytes":2551,"sha256":"01ef9d030ab116a21bcca1ff7f8d9ced27968015939cd1bf4c2ed99955f445bd"},"openspec/changes/add-gateway-operations/specs/task-audit-artifacts/spec.md":{"bytes":2597,"sha256":"8d2cb83159ed06b09358d3f950ae20489ea964a864c289168ab2c5a8e57ffadb"},"openspec/changes/add-gateway-operations/specs/tool-model-catalogs/spec.md":{"bytes":2463,"sha256":"a424d99c94d69cb61fa9e3f0efeb9dc8c1702d37c397f789c3363a79066df547"},"openspec/changes/add-gateway-operations/tasks.md":{"bytes":5352,"sha256":"12b19adb7b2a84e0fc263e8a8378719d2f5978f2dc5f619f3c856eb70a66b4f5"},"openspec/changes/add-managed-gateway-client/.openspec.yaml":{"bytes":40,"sha256":"dc10040214104474c4e34e5b38359540c882aa7cfb6e7221e5d0614f1dba8fd7"},"openspec/changes/add-managed-gateway-client/design.md":{"bytes":5113,"sha256":"162801004ae85138dc1d03ecb0654506986c26053bfe6fa9e72704edb01de6a2"},"openspec/changes/add-managed-gateway-client/proposal.md":{"bytes":2019,"sha256":"a91469801a7becd8ab01272697394c1d44c367ac2ae0666814b6f6b5706a01cf"},"openspec/changes/add-managed-gateway-client/specs/gateway-recovery/spec.md":{"bytes":2762,"sha256":"af082acc14c97793b8f9231b500e86e8e5c77455ae04a88b0b24fdfa4ed3335e"},"openspec/changes/add-managed-gateway-client/specs/managed-rpc/spec.md":{"bytes":2624,"sha256":"6aa6031b61a113443b8d560e58baae1c041ddc465630b736fa9a23b1fdb4408d"},"openspec/changes/add-managed-gateway-client/specs/typed-event-delivery/spec.md":{"bytes":2613,"sha256":"c5def41f0c9510153b5eb773521778d6121cad2ca4b2bdc733e9cfaa40275552"},"openspec/changes/add-managed-gateway-client/tasks.md":{"bytes":3249,"sha256":"978d020d94027db3801c090dd7e86bbd65b2568c64880950320e57087ee96970"},"openspec/changes/add-optional-runtime-adapters/.openspec.yaml":{"bytes":40,"sha256":"dc10040214104474c4e34e5b38359540c882aa7cfb6e7221e5d0614f1dba8fd7"},"openspec/changes/add-optional-runtime-adapters/design.md":{"bytes":4940,"sha256":"65332fcd6d91ff4ca9e77d53f606caccec2795fae74160bb95d357da482546c9"},"openspec/changes/add-optional-runtime-adapters/proposal.md":{"bytes":2065,"sha256":"a32b0507234b8e78719cb7716dc484212797b3c0259daa76931bf2c7820b4b3e"},"openspec/changes/add-optional-runtime-adapters/specs/cli-typed-results/spec.md":{"bytes":2609,"sha256":"2f9836a84b4b5ae66abae680ef1ec52c35531029b4682a75cc5a3c2e8cc6c67f"},"openspec/changes/add-optional-runtime-adapters/specs/persistent-stdio-adapters/spec.md":{"bytes":2509,"sha256":"ea7d2f8599d97c4ccd8f23ada658f636be62d2bdb715ed82f026a22286a7a3db"},"openspec/changes/add-optional-runtime-adapters/specs/terminal-voice-adapters/spec.md":{"bytes":2620,"sha256":"77fbb21d872b83da1cda418e6a7e1d94b0ea496ac566e6808225f2031a1c39a0"},"openspec/changes/add-optional-runtime-adapters/tasks.md":{"bytes":3318,"sha256":"a86f42485573c87ffa97e3296c3c20cfc128b63db40166a28ee7daf48e1b9f0c"},"openspec/changes/establish-sdk-compatibility-governance/.openspec.yaml":{"bytes":40,"sha256":"dc10040214104474c4e34e5b38359540c882aa7cfb6e7221e5d0614f1dba8fd7"},"openspec/changes/establish-sdk-compatibility-governance/design.md":{"bytes":5448,"sha256":"d3150d2e298788a186c934920cb111bdef4b6801e6c34052741b61895c4dd372"},"openspec/changes/establish-sdk-compatibility-governance/evidence/2026-09-20-precursor-evidence.md":{"bytes":2383,"sha256":"e55309e91a1f190e62b3c29de385509def154a9d534f2963d8f4b69c4fd27db4"},"openspec/changes/establish-sdk-compatibility-governance/evidence/2026-11-18-live-gateway.md":{"bytes":4373,"sha256":"1222733692bee7da3f2d045fc7ff2b0da96a440c065162d900ab4b6b3731be4e"},"openspec/changes/establish-sdk-compatibility-governance/evidence/2026-11-18-locked-gateway-schema.md":{"bytes":2169,"sha256":"6728253fe492a99ebc24eb8c3bc261331317a6324db7c3a168610883ab41048f"},"openspec/changes/establish-sdk-compatibility-governance/evidence/capability-inventory.json":{"bytes":2118,"sha256":"c8148e22712176d1991cec37e8f80861996053c693f76a2998a3f7a37fd00822"},"openspec/changes/establish-sdk-compatibility-governance/evidence/version-lock.md":{"bytes":1139,"sha256":"7d53174fb9aad9244934bafec50f364ce869f8bcb92445b96aba2c2af64e67f3"},"openspec/changes/establish-sdk-compatibility-governance/proposal.md":{"bytes":1789,"sha256":"88e18f4f66ebccace6da321cb7d0a6b4d788e8e84cc933ab3678a5389b459ed6"},"openspec/changes/establish-sdk-compatibility-governance/specs/sdk-compatibility-governance/spec.md":{"bytes":3830,"sha256":"3d14086cef101a78b83ef953e16cea13b4b341ca9c9552c62596ee9ab85131a1"},"openspec/changes/establish-sdk-compatibility-governance/tasks.md":{"bytes":3927,"sha256":"64186486d2bc39ad7e9ca7190c1704ad0b6188b8e4957513b9554c5c574582b6"},"openspec/changes/fix-openclaw-protocol-contracts/.openspec.yaml":{"bytes":40,"sha256":"dc10040214104474c4e34e5b38359540c882aa7cfb6e7221e5d0614f1dba8fd7"},"openspec/changes/fix-openclaw-protocol-contracts/design.md":{"bytes":5675,"sha256":"10966f9bc03d3b34138539aeeb4b7ad884b28763cc2290c1f95926b69335dbbb"},"openspec/changes/fix-openclaw-protocol-contracts/proposal.md":{"bytes":2418,"sha256":"11a51837e386f1068004c526673547610a5b84dca8b42fc6d9484da02cc9b270"},"openspec/changes/fix-openclaw-protocol-contracts/specs/gateway-chat-events/spec.md":{"bytes":2622,"sha256":"3564b6061b568c1d30577fc8b228243f21df756321de9e50dd4a763529afb5b9"},"openspec/changes/fix-openclaw-protocol-contracts/specs/gateway-device-auth/spec.md":{"bytes":2806,"sha256":"2a6d8d7d5202495cdace92ffd12a500ee9f0266a172aa4147852e4cf43ee2a4a"},"openspec/changes/fix-openclaw-protocol-contracts/specs/responses-streaming/spec.md":{"bytes":2695,"sha256":"1ca9b80db706c236ca32ae0acd8a02a190fc3644959aa58af4379035923c3b82"},"openspec/changes/fix-openclaw-protocol-contracts/specs/session-history-contract/spec.md":{"bytes":2651,"sha256":"7fcc7baab4e3d9f10dd86adb03e00f78b07a7f011747a744224ca3dadf89168c"},"openspec/changes/fix-openclaw-protocol-contracts/specs/tools-invoke-contract/spec.md":{"bytes":2681,"sha256":"f255110ecff5a9479b780ec81dce1c451d638fe69259196e0ef063c5343a62f1"},"openspec/changes/fix-openclaw-protocol-contracts/tasks.md":{"bytes":4698,"sha256":"fd7a21979c085430e70479494b8f87c88e9746cf277463628a93a92a7932130a"},"openspec/config.yaml":{"bytes":1862,"sha256":"151f5ce61678f2d47d19a1c21168936f7ad5c6f05adec25db6a0e8a70f1f8ba9"},"openspec/specs/.gitkeep":{"bytes":1,"sha256":"01ba4719c80b6fe911b091a7c05124b64eeece964e09c058ef8f9805daca546b"}},"split_report":{"path":"docs/openclaw-integration/validation-report","encoding":"concatenated-base64-of-gzip","original_bytes":127699,"original_sha256":"a689415d7e7c1a28cc50a97179c797adc29080b30f5ec929aa8ed23227a1a598","parts":3},"source_package_note":"The source package hash identifies the original 2026-09-20 bundle. The file inventory also includes subsequent G0 evidence and documentation edits."} +{"scope":"repository documentation; paths relative to repository root; manifest excludes itself","source_package":"openclaw-java-sdk-openspec-draft-2026-09-20.zip","source_package_sha256":"f8eedbb0356b34ecde22584b57fdc9d375fa7409c36d6931b7faca36f4919468","files":{"docs/openclaw-integration/README.md":{"bytes":2882,"sha256":"7af61aea4d0c57c7e1f2c2b83a52126c4ab5b00f6a98962ead41687128789225"},"docs/openclaw-integration/acceptance-plan.md":{"bytes":4591,"sha256":"4875a07fd14cd9771d610d221ab8e666bf2801341b3ccc21302627f06fa2089f"},"docs/openclaw-integration/baseline.json":{"bytes":3221,"sha256":"b5b13dd410d068a5b07b4c27be01658aa94bb626dce9beffc44ebce9565789ab"},"docs/openclaw-integration/coverage-baseline.md":{"bytes":4792,"sha256":"ae4b7783b718a268c697fdd85f1f24800f838cb1063ae90e4324c224efc7f820"},"docs/openclaw-integration/roadmap.md":{"bytes":3880,"sha256":"edb7e1a9717f05e1128eda44fb41fbddcd595cfd2e165ab1ea6d920ca38d5aa6"},"docs/openclaw-integration/source-register.md":{"bytes":5424,"sha256":"992bf67dd8da00cccaeaf4a93ed594b2877d832ed3015b402c3a4eabb0b523f0"},"docs/openclaw-integration/traceability.json.gz":{"bytes":3246,"sha256":"75386731e6f4b685d61a8c582e18edbdc86577e717039716c1c908f8422befcd","decompressed_sha256":"da585354d01fb0f687d764840f7512259de832896db051fe450ac667fd6bf6bb"},"docs/openclaw-integration/traceability.md":{"bytes":13478,"sha256":"cd1b647ab538953e299a1964e009fbb65b4212654dab678bfb05e4fd1bcd2a59"},"docs/openclaw-integration/validation-report/README.md":{"bytes":1113,"sha256":"b67e0eb4a969e742b6e30e35883dcac0c3cc15aca0005e6d66377b99995e2932"},"docs/openclaw-integration/validation-report/part-001.b64":{"bytes":2601,"sha256":"9570f3b3818b997c948cb9ee4a5c4885d664cacdfec18e0b3d1e9858ae695a32"},"docs/openclaw-integration/validation-report/part-002.b64":{"bytes":2601,"sha256":"d57ebdd3717bab8648f4f98a70430515d0750ebb38cd72a970e246ddeb049952"},"docs/openclaw-integration/validation-report/part-003.b64":{"bytes":2537,"sha256":"61a7c754d543e645ad6b705add8f183ac0e6605340f0993b9bc5cb4647fef85b"},"docs/openclaw-integration/validation-summary.md":{"bytes":2141,"sha256":"40e31c0cd1ebb639cf1e852b0b0180bda27e28c16dcba9b90e3cb8aabd0f6d10"},"openspec/README.md":{"bytes":611,"sha256":"58a1b2615971f2c7fb56f069006b8559cf5cf1548c01b29c83758c894ec79f20"},"openspec/changes/add-agent-session-approval-control/.openspec.yaml":{"bytes":40,"sha256":"dc10040214104474c4e34e5b38359540c882aa7cfb6e7221e5d0614f1dba8fd7"},"openspec/changes/add-agent-session-approval-control/design.md":{"bytes":4797,"sha256":"95794f1f71841a3d6a5ca61d10bbffaf5be029f8284cf75ac4b6020e4564d3d1"},"openspec/changes/add-agent-session-approval-control/proposal.md":{"bytes":1936,"sha256":"da5665faa52a3e14e756e021e2b9dec56c5f6bb5d73af277e756050a4399c741"},"openspec/changes/add-agent-session-approval-control/specs/agent-lifecycle/spec.md":{"bytes":2664,"sha256":"0b12b0240d1a5d37bcaa8c69604ca53ca67c4a372440262d14ed01b0ffd1a174"},"openspec/changes/add-agent-session-approval-control/specs/approval-control/spec.md":{"bytes":2549,"sha256":"3b979ba5b34b8aa1e1fef3a216e663b5b194b7bce713092d73cc4eed83f0c09b"},"openspec/changes/add-agent-session-approval-control/specs/session-control/spec.md":{"bytes":2543,"sha256":"ecf939250f43f526c1d78a5a2bc2902e5889cf13474a7c80e440e7232d5c24fb"},"openspec/changes/add-agent-session-approval-control/tasks.md":{"bytes":3242,"sha256":"782b9f42a8b58fab966c04920d27a98ea77d588102594219572eae5b17cbad11"},"openspec/changes/add-gateway-operations/.openspec.yaml":{"bytes":40,"sha256":"dc10040214104474c4e34e5b38359540c882aa7cfb6e7221e5d0614f1dba8fd7"},"openspec/changes/add-gateway-operations/design.md":{"bytes":5441,"sha256":"d07d9f9c3c5da092be96a18f0e6c35be53fe06f2eda9f540ef993961be8f247d"},"openspec/changes/add-gateway-operations/proposal.md":{"bytes":2342,"sha256":"c6081bd3692307909e736b7d84ccc34828b4fa5152a118f86dc577fa6ac3d47f"},"openspec/changes/add-gateway-operations/specs/channel-node-control/spec.md":{"bytes":2663,"sha256":"4350182f113da6caff9cd0eb81f2cb5173be374bd2f6665e16a9f93111fb4649"},"openspec/changes/add-gateway-operations/specs/configuration-control/spec.md":{"bytes":2432,"sha256":"cf8839be9d8c9015cfb855422fcdfdfaee02275965f2b3a12b42ce4987b8b3c1"},"openspec/changes/add-gateway-operations/specs/cron-control/spec.md":{"bytes":2453,"sha256":"8f86038254595e09c705b4b680d41aed60b2332f019139e35b5a65c329774274"},"openspec/changes/add-gateway-operations/specs/skill-plugin-lifecycle/spec.md":{"bytes":2551,"sha256":"01ef9d030ab116a21bcca1ff7f8d9ced27968015939cd1bf4c2ed99955f445bd"},"openspec/changes/add-gateway-operations/specs/task-audit-artifacts/spec.md":{"bytes":2597,"sha256":"8d2cb83159ed06b09358d3f950ae20489ea964a864c289168ab2c5a8e57ffadb"},"openspec/changes/add-gateway-operations/specs/tool-model-catalogs/spec.md":{"bytes":2463,"sha256":"a424d99c94d69cb61fa9e3f0efeb9dc8c1702d37c397f789c3363a79066df547"},"openspec/changes/add-gateway-operations/tasks.md":{"bytes":5352,"sha256":"12b19adb7b2a84e0fc263e8a8378719d2f5978f2dc5f619f3c856eb70a66b4f5"},"openspec/changes/add-managed-gateway-client/.openspec.yaml":{"bytes":40,"sha256":"dc10040214104474c4e34e5b38359540c882aa7cfb6e7221e5d0614f1dba8fd7"},"openspec/changes/add-managed-gateway-client/design.md":{"bytes":5113,"sha256":"162801004ae85138dc1d03ecb0654506986c26053bfe6fa9e72704edb01de6a2"},"openspec/changes/add-managed-gateway-client/proposal.md":{"bytes":2019,"sha256":"a91469801a7becd8ab01272697394c1d44c367ac2ae0666814b6f6b5706a01cf"},"openspec/changes/add-managed-gateway-client/specs/gateway-recovery/spec.md":{"bytes":2762,"sha256":"af082acc14c97793b8f9231b500e86e8e5c77455ae04a88b0b24fdfa4ed3335e"},"openspec/changes/add-managed-gateway-client/specs/managed-rpc/spec.md":{"bytes":2624,"sha256":"6aa6031b61a113443b8d560e58baae1c041ddc465630b736fa9a23b1fdb4408d"},"openspec/changes/add-managed-gateway-client/specs/typed-event-delivery/spec.md":{"bytes":2613,"sha256":"c5def41f0c9510153b5eb773521778d6121cad2ca4b2bdc733e9cfaa40275552"},"openspec/changes/add-managed-gateway-client/tasks.md":{"bytes":3249,"sha256":"978d020d94027db3801c090dd7e86bbd65b2568c64880950320e57087ee96970"},"openspec/changes/add-optional-runtime-adapters/.openspec.yaml":{"bytes":40,"sha256":"dc10040214104474c4e34e5b38359540c882aa7cfb6e7221e5d0614f1dba8fd7"},"openspec/changes/add-optional-runtime-adapters/design.md":{"bytes":4940,"sha256":"65332fcd6d91ff4ca9e77d53f606caccec2795fae74160bb95d357da482546c9"},"openspec/changes/add-optional-runtime-adapters/proposal.md":{"bytes":2065,"sha256":"a32b0507234b8e78719cb7716dc484212797b3c0259daa76931bf2c7820b4b3e"},"openspec/changes/add-optional-runtime-adapters/specs/cli-typed-results/spec.md":{"bytes":2609,"sha256":"2f9836a84b4b5ae66abae680ef1ec52c35531029b4682a75cc5a3c2e8cc6c67f"},"openspec/changes/add-optional-runtime-adapters/specs/persistent-stdio-adapters/spec.md":{"bytes":2509,"sha256":"ea7d2f8599d97c4ccd8f23ada658f636be62d2bdb715ed82f026a22286a7a3db"},"openspec/changes/add-optional-runtime-adapters/specs/terminal-voice-adapters/spec.md":{"bytes":2620,"sha256":"77fbb21d872b83da1cda418e6a7e1d94b0ea496ac566e6808225f2031a1c39a0"},"openspec/changes/add-optional-runtime-adapters/tasks.md":{"bytes":3318,"sha256":"a86f42485573c87ffa97e3296c3c20cfc128b63db40166a28ee7daf48e1b9f0c"},"openspec/changes/establish-sdk-compatibility-governance/.openspec.yaml":{"bytes":40,"sha256":"dc10040214104474c4e34e5b38359540c882aa7cfb6e7221e5d0614f1dba8fd7"},"openspec/changes/establish-sdk-compatibility-governance/design.md":{"bytes":5448,"sha256":"d3150d2e298788a186c934920cb111bdef4b6801e6c34052741b61895c4dd372"},"openspec/changes/establish-sdk-compatibility-governance/evidence/2026-09-20-precursor-evidence.md":{"bytes":2383,"sha256":"e55309e91a1f190e62b3c29de385509def154a9d534f2963d8f4b69c4fd27db4"},"openspec/changes/establish-sdk-compatibility-governance/evidence/2026-11-18-live-gateway.md":{"bytes":6012,"sha256":"8a39e6c4943c4d5fadfd5ed8000d54510b5ba53dc7ab4ca8a594f0ed142b5b8c"},"openspec/changes/establish-sdk-compatibility-governance/evidence/2026-11-18-locked-gateway-schema.md":{"bytes":2169,"sha256":"6728253fe492a99ebc24eb8c3bc261331317a6324db7c3a168610883ab41048f"},"openspec/changes/establish-sdk-compatibility-governance/evidence/capability-inventory.json":{"bytes":2118,"sha256":"c8148e22712176d1991cec37e8f80861996053c693f76a2998a3f7a37fd00822"},"openspec/changes/establish-sdk-compatibility-governance/evidence/fixtures/GatewayCompatibilityFixtureTest.java":{"bytes":3177,"sha256":"7e13d512dccef6b533f5bf04caa1556b97cc7c9a97f8776204196d71c87d38f8"},"openspec/changes/establish-sdk-compatibility-governance/evidence/version-lock.md":{"bytes":1139,"sha256":"7d53174fb9aad9244934bafec50f364ce869f8bcb92445b96aba2c2af64e67f3"},"openspec/changes/establish-sdk-compatibility-governance/proposal.md":{"bytes":1789,"sha256":"88e18f4f66ebccace6da321cb7d0a6b4d788e8e84cc933ab3678a5389b459ed6"},"openspec/changes/establish-sdk-compatibility-governance/specs/sdk-compatibility-governance/spec.md":{"bytes":3830,"sha256":"3d14086cef101a78b83ef953e16cea13b4b341ca9c9552c62596ee9ab85131a1"},"openspec/changes/establish-sdk-compatibility-governance/tasks.md":{"bytes":4126,"sha256":"3f5591d6a6f5ad72d3e66d3be4ecfae8b02f10e524aa8987d9e52a947276e611"},"openspec/changes/fix-openclaw-protocol-contracts/.openspec.yaml":{"bytes":40,"sha256":"dc10040214104474c4e34e5b38359540c882aa7cfb6e7221e5d0614f1dba8fd7"},"openspec/changes/fix-openclaw-protocol-contracts/design.md":{"bytes":5675,"sha256":"10966f9bc03d3b34138539aeeb4b7ad884b28763cc2290c1f95926b69335dbbb"},"openspec/changes/fix-openclaw-protocol-contracts/proposal.md":{"bytes":2418,"sha256":"11a51837e386f1068004c526673547610a5b84dca8b42fc6d9484da02cc9b270"},"openspec/changes/fix-openclaw-protocol-contracts/specs/gateway-chat-events/spec.md":{"bytes":2622,"sha256":"3564b6061b568c1d30577fc8b228243f21df756321de9e50dd4a763529afb5b9"},"openspec/changes/fix-openclaw-protocol-contracts/specs/gateway-device-auth/spec.md":{"bytes":2806,"sha256":"2a6d8d7d5202495cdace92ffd12a500ee9f0266a172aa4147852e4cf43ee2a4a"},"openspec/changes/fix-openclaw-protocol-contracts/specs/responses-streaming/spec.md":{"bytes":2695,"sha256":"1ca9b80db706c236ca32ae0acd8a02a190fc3644959aa58af4379035923c3b82"},"openspec/changes/fix-openclaw-protocol-contracts/specs/session-history-contract/spec.md":{"bytes":2651,"sha256":"7fcc7baab4e3d9f10dd86adb03e00f78b07a7f011747a744224ca3dadf89168c"},"openspec/changes/fix-openclaw-protocol-contracts/specs/tools-invoke-contract/spec.md":{"bytes":2681,"sha256":"f255110ecff5a9479b780ec81dce1c451d638fe69259196e0ef063c5343a62f1"},"openspec/changes/fix-openclaw-protocol-contracts/tasks.md":{"bytes":4698,"sha256":"fd7a21979c085430e70479494b8f87c88e9746cf277463628a93a92a7932130a"},"openspec/config.yaml":{"bytes":1862,"sha256":"151f5ce61678f2d47d19a1c21168936f7ad5c6f05adec25db6a0e8a70f1f8ba9"},"openspec/specs/.gitkeep":{"bytes":1,"sha256":"01ba4719c80b6fe911b091a7c05124b64eeece964e09c058ef8f9805daca546b"}},"split_report":{"path":"docs/openclaw-integration/validation-report","encoding":"concatenated-base64-of-gzip","original_bytes":127699,"original_sha256":"a689415d7e7c1a28cc50a97179c797adc29080b30f5ec929aa8ed23227a1a598","parts":3},"source_package_note":"The source package hash identifies the original 2026-09-20 bundle. The file inventory also includes subsequent G0 evidence and documentation edits."} diff --git a/openspec/changes/establish-sdk-compatibility-governance/evidence/2026-11-18-live-gateway.md b/openspec/changes/establish-sdk-compatibility-governance/evidence/2026-11-18-live-gateway.md index d6f6a45..7261074 100644 --- a/openspec/changes/establish-sdk-compatibility-governance/evidence/2026-11-18-live-gateway.md +++ b/openspec/changes/establish-sdk-compatibility-governance/evidence/2026-11-18-live-gateway.md @@ -40,3 +40,27 @@ | feature/3.0.x | 3.0.x.20260630-SNAPSHOT | 21 / 4.0.0-rc-5 | tools.jackson.core 3.2.1 | 34b003b5c2c2158e536d3290ef67de7932ab78ef | [成功](https://github.com/easy-4-java/openclaw-java-sdk/actions/runs/44335951638) | 三个提交仅修改各自的两份 README,已推送到对应的维护线。六份 README 均通过快照坐标、依赖版本、JDK、Wrapper、Release 标签和验证范围核对。文档明确记录实测的协议 4 握手、Token 认证和会话列表的读取权限检查,并标明 HTTP、SSE、CLI、模型调用及其余 RPC 的真实兼容性待验证。 + +## 三条维护线共用的 Gateway 测试样本 + +[GatewayCompatibilityFixtureTest.java](fixtures/GatewayCompatibilityFixtureTest.java) 在三条维护线上使用同一份源码。它通过公开 SDK API 验证协议 4 握手、无效 Token、`operator.read` 下的 `sessions.list` 以及缺少权限时的结构化拒绝。无效 Token 场景的客户端断言检查握手异常,服务端日志同时确认了 `token_mismatch`,因此可以区分认证拒绝和网络故障。 + +| SDK 源码 | JDK | Maven | Gateway 2026.7.1-2 | Gateway 2026.11.5 | +|---|---|---|---|---| +| `8cfbeb8` | 1.8.0_504 | 3.9.16 | 4 项通过 | 4 项通过 | +| `48309d7` | 17.0.21 | 3.9.16 | 4 项通过 | 4 项通过 | +| `87c2113` | 21.0.13.0.2 | 4.0.0-rc-5 | 4 项通过 | 4 项通过 | + +六次执行均无失败、错误或跳过,两个 Gateway 均通过 `/readyz`。不同 JDK 和 Jackson 包名无需分叉这四个场景。默认分支握手差异保留在上文的独立记录中。GOV-02 的其它协议行为及差异清单批准仍待验收。 + +复核时在三条维护线的独立检出目录中,将样本放到 `src/test/java/io/github/easy4j/openclaw/ws/`。按上文使用独立状态目录和临时 Token 启动本地 Gateway,只绑定回环地址并关闭插件。将 `SDK_PROBE_URL` 和 `OPENCLAW_GATEWAY_TOKEN` 传给测试进程。请勿使用线上 Token 或生产 Gateway。 + +```bash +# JDK 8 and JDK 17 +mvn -B -ntp -Dtest=GatewayCompatibilityFixtureTest test + +# JDK 21 +./mvnw -B -ntp -Dtest=GatewayCompatibilityFixtureTest test +``` + +每个版本均复核服务端认证拒绝原因、四条 JUnit 测试记录及 Maven 退出码。 diff --git a/openspec/changes/establish-sdk-compatibility-governance/evidence/fixtures/GatewayCompatibilityFixtureTest.java b/openspec/changes/establish-sdk-compatibility-governance/evidence/fixtures/GatewayCompatibilityFixtureTest.java new file mode 100644 index 0000000..3709334 --- /dev/null +++ b/openspec/changes/establish-sdk-compatibility-governance/evidence/fixtures/GatewayCompatibilityFixtureTest.java @@ -0,0 +1,77 @@ +package io.github.easy4j.openclaw.ws; + +import io.github.easy4j.openclaw.OpenClawHttpClientConfig; +import io.github.easy4j.openclaw.exception.OpenClawWsRpcException; +import io.github.easy4j.openclaw.ws.protocol.HelloOk; +import org.junit.jupiter.api.Test; + +import java.net.URI; +import java.util.Collections; +import java.util.List; +import java.util.Objects; + +import static org.junit.jupiter.api.Assertions.assertEquals; +import static org.junit.jupiter.api.Assertions.assertNotNull; +import static org.junit.jupiter.api.Assertions.assertThrows; +import static org.junit.jupiter.api.Assertions.assertTrue; + +final class GatewayCompatibilityFixtureTest { + + @Test + void handshakeNegotiatesProtocolFour() throws Exception { + try (OpenClawGatewayWsClient client = client(requireEnv("OPENCLAW_GATEWAY_TOKEN"), + Collections.singletonList("operator.read"))) { + HelloOk hello = client.connectHandshake(); + assertEquals(4, hello.getProtocol()); + assertNotNull(hello.getServer()); + } + } + + @Test + void handshakeRejectsInvalidToken() { + try (OpenClawGatewayWsClient client = client("invalid-" + requireEnv("OPENCLAW_GATEWAY_TOKEN"), + Collections.singletonList("operator.read"))) { + assertThrows(RuntimeException.class, client::connectHandshake); + } + } + + @Test + void sessionsListAllowsOperatorRead() throws Exception { + try (OpenClawGatewayWsClient client = client(requireEnv("OPENCLAW_GATEWAY_TOKEN"), + Collections.singletonList("operator.read"))) { + assertEquals(4, client.connectHandshake().getProtocol()); + assertNotNull(client.sessionsList()); + } + } + + @Test + void sessionsListRejectsMissingReadScope() throws Exception { + try (OpenClawGatewayWsClient client = client(requireEnv("OPENCLAW_GATEWAY_TOKEN"), + Collections.emptyList())) { + assertEquals(4, client.connectHandshake().getProtocol()); + OpenClawWsRpcException failure = assertThrows(OpenClawWsRpcException.class, client::sessionsList); + assertEquals("sessions.list", failure.getMethod()); + assertTrue(failure.getError().getMessage().contains("missing scope: operator.read")); + } + } + + private OpenClawGatewayWsClient client(String token, List scopes) { + URI gateway = URI.create(requireEnv("SDK_PROBE_URL")); + assertEquals("ws", gateway.getScheme()); + assertEquals("127.0.0.1", gateway.getHost()); + + OpenClawHttpClientConfig config = new OpenClawHttpClientConfig(); + config.setBaseUrl(gateway.toString().replaceFirst("^ws:", "http:")); + config.setGatewayClientId("gateway-client"); + config.setGatewayClientMode("backend"); + config.setGatewayAuthToken(token); + config.setGatewayScopes(scopes); + return new OpenClawGatewayWsClient(config, gateway); + } + + private static String requireEnv(String name) { + String value = Objects.requireNonNull(System.getenv(name), name + " is required"); + assertTrue(!value.isEmpty(), name + " must not be empty"); + return value; + } +} diff --git a/openspec/changes/establish-sdk-compatibility-governance/tasks.md b/openspec/changes/establish-sdk-compatibility-governance/tasks.md index f5d992e..95fd18f 100644 --- a/openspec/changes/establish-sdk-compatibility-governance/tasks.md +++ b/openspec/changes/establish-sdk-compatibility-governance/tasks.md @@ -11,7 +11,7 @@ ## 2. 能力证据和兼容治理 - [x] 2.1 为 GOV-01、GOV-04 建立机器可读的能力、版本和证据清单;(证据:evidence/2026-09-20-precursor-evidence.md、capability-inventory.json——8 项静态存在均 liveVerified=false,4 项未封装,无 live-pass 标记)验收:能区分静态存在、部分实现、CLI 透传、未封装、未验证与不适用,并演示缺失证据不能被标记为 live-pass。 -- [ ] 2.2 为 GOV-02 建立三分支协议 fixture 和获准差异清单;验收:同一行为具有共同场景标识,JSON 包名和 JDK 差异不被误判为功能分叉,行为差异不能被全局忽略。 +- [ ] 2.2 为 GOV-02 建立三分支协议 fixture 和获准差异清单;[共用 Gateway 测试样本](evidence/2026-11-18-live-gateway.md#三条维护线共用的-gateway-测试样本)已实测握手、认证和读取权限,完整协议范围与差异清单待评审。验收:同一行为具有共同场景标识,JSON 包名和 JDK 差异不被误判为功能分叉,行为差异不能被全局忽略。 - [ ] 2.3 为 GOV-03 建立规范评审与归档检查步骤;验收:DRAFT、REVIEWED、IMPLEMENTED、VERIFIED 与 ARCHIVED 分开,未执行任务和缺证据场景可阻止本项目归档流程。 - [ ] 2.4 逐项映射 traceability 中 GOV-01-S1 至 GOV-04-S2;验收:八个场景均有对应检查或人工审核记录,重写 README 不得替代证据校验。 From 97b4cdbeb0196afeb8bdc4944fb13bff7d9f4ff4 Mon Sep 17 00:00:00 2001 From: loong10k <20489781+loong10k@users.noreply.github.com> Date: Thu, 19 Nov 2026 00:09:11 +0800 Subject: [PATCH 10/22] docs: audit OpenClaw governance scenarios against versioned evidence --- .../package-manifest.json | 2 +- docs/openclaw-integration/traceability.md | 2 +- .../2026-11-19-governance-scenario-audit.md | 31 +++++++++++++++++++ .../tasks.md | 2 +- 4 files changed, 34 insertions(+), 3 deletions(-) create mode 100644 openspec/changes/establish-sdk-compatibility-governance/evidence/2026-11-19-governance-scenario-audit.md diff --git a/docs/openclaw-integration/package-manifest.json b/docs/openclaw-integration/package-manifest.json index 8570fe3..22760a7 100644 --- a/docs/openclaw-integration/package-manifest.json +++ b/docs/openclaw-integration/package-manifest.json @@ -1 +1 @@ -{"scope":"repository documentation; paths relative to repository root; manifest excludes itself","source_package":"openclaw-java-sdk-openspec-draft-2026-09-20.zip","source_package_sha256":"f8eedbb0356b34ecde22584b57fdc9d375fa7409c36d6931b7faca36f4919468","files":{"docs/openclaw-integration/README.md":{"bytes":2882,"sha256":"7af61aea4d0c57c7e1f2c2b83a52126c4ab5b00f6a98962ead41687128789225"},"docs/openclaw-integration/acceptance-plan.md":{"bytes":4591,"sha256":"4875a07fd14cd9771d610d221ab8e666bf2801341b3ccc21302627f06fa2089f"},"docs/openclaw-integration/baseline.json":{"bytes":3221,"sha256":"b5b13dd410d068a5b07b4c27be01658aa94bb626dce9beffc44ebce9565789ab"},"docs/openclaw-integration/coverage-baseline.md":{"bytes":4792,"sha256":"ae4b7783b718a268c697fdd85f1f24800f838cb1063ae90e4324c224efc7f820"},"docs/openclaw-integration/roadmap.md":{"bytes":3880,"sha256":"edb7e1a9717f05e1128eda44fb41fbddcd595cfd2e165ab1ea6d920ca38d5aa6"},"docs/openclaw-integration/source-register.md":{"bytes":5424,"sha256":"992bf67dd8da00cccaeaf4a93ed594b2877d832ed3015b402c3a4eabb0b523f0"},"docs/openclaw-integration/traceability.json.gz":{"bytes":3246,"sha256":"75386731e6f4b685d61a8c582e18edbdc86577e717039716c1c908f8422befcd","decompressed_sha256":"da585354d01fb0f687d764840f7512259de832896db051fe450ac667fd6bf6bb"},"docs/openclaw-integration/traceability.md":{"bytes":13478,"sha256":"cd1b647ab538953e299a1964e009fbb65b4212654dab678bfb05e4fd1bcd2a59"},"docs/openclaw-integration/validation-report/README.md":{"bytes":1113,"sha256":"b67e0eb4a969e742b6e30e35883dcac0c3cc15aca0005e6d66377b99995e2932"},"docs/openclaw-integration/validation-report/part-001.b64":{"bytes":2601,"sha256":"9570f3b3818b997c948cb9ee4a5c4885d664cacdfec18e0b3d1e9858ae695a32"},"docs/openclaw-integration/validation-report/part-002.b64":{"bytes":2601,"sha256":"d57ebdd3717bab8648f4f98a70430515d0750ebb38cd72a970e246ddeb049952"},"docs/openclaw-integration/validation-report/part-003.b64":{"bytes":2537,"sha256":"61a7c754d543e645ad6b705add8f183ac0e6605340f0993b9bc5cb4647fef85b"},"docs/openclaw-integration/validation-summary.md":{"bytes":2141,"sha256":"40e31c0cd1ebb639cf1e852b0b0180bda27e28c16dcba9b90e3cb8aabd0f6d10"},"openspec/README.md":{"bytes":611,"sha256":"58a1b2615971f2c7fb56f069006b8559cf5cf1548c01b29c83758c894ec79f20"},"openspec/changes/add-agent-session-approval-control/.openspec.yaml":{"bytes":40,"sha256":"dc10040214104474c4e34e5b38359540c882aa7cfb6e7221e5d0614f1dba8fd7"},"openspec/changes/add-agent-session-approval-control/design.md":{"bytes":4797,"sha256":"95794f1f71841a3d6a5ca61d10bbffaf5be029f8284cf75ac4b6020e4564d3d1"},"openspec/changes/add-agent-session-approval-control/proposal.md":{"bytes":1936,"sha256":"da5665faa52a3e14e756e021e2b9dec56c5f6bb5d73af277e756050a4399c741"},"openspec/changes/add-agent-session-approval-control/specs/agent-lifecycle/spec.md":{"bytes":2664,"sha256":"0b12b0240d1a5d37bcaa8c69604ca53ca67c4a372440262d14ed01b0ffd1a174"},"openspec/changes/add-agent-session-approval-control/specs/approval-control/spec.md":{"bytes":2549,"sha256":"3b979ba5b34b8aa1e1fef3a216e663b5b194b7bce713092d73cc4eed83f0c09b"},"openspec/changes/add-agent-session-approval-control/specs/session-control/spec.md":{"bytes":2543,"sha256":"ecf939250f43f526c1d78a5a2bc2902e5889cf13474a7c80e440e7232d5c24fb"},"openspec/changes/add-agent-session-approval-control/tasks.md":{"bytes":3242,"sha256":"782b9f42a8b58fab966c04920d27a98ea77d588102594219572eae5b17cbad11"},"openspec/changes/add-gateway-operations/.openspec.yaml":{"bytes":40,"sha256":"dc10040214104474c4e34e5b38359540c882aa7cfb6e7221e5d0614f1dba8fd7"},"openspec/changes/add-gateway-operations/design.md":{"bytes":5441,"sha256":"d07d9f9c3c5da092be96a18f0e6c35be53fe06f2eda9f540ef993961be8f247d"},"openspec/changes/add-gateway-operations/proposal.md":{"bytes":2342,"sha256":"c6081bd3692307909e736b7d84ccc34828b4fa5152a118f86dc577fa6ac3d47f"},"openspec/changes/add-gateway-operations/specs/channel-node-control/spec.md":{"bytes":2663,"sha256":"4350182f113da6caff9cd0eb81f2cb5173be374bd2f6665e16a9f93111fb4649"},"openspec/changes/add-gateway-operations/specs/configuration-control/spec.md":{"bytes":2432,"sha256":"cf8839be9d8c9015cfb855422fcdfdfaee02275965f2b3a12b42ce4987b8b3c1"},"openspec/changes/add-gateway-operations/specs/cron-control/spec.md":{"bytes":2453,"sha256":"8f86038254595e09c705b4b680d41aed60b2332f019139e35b5a65c329774274"},"openspec/changes/add-gateway-operations/specs/skill-plugin-lifecycle/spec.md":{"bytes":2551,"sha256":"01ef9d030ab116a21bcca1ff7f8d9ced27968015939cd1bf4c2ed99955f445bd"},"openspec/changes/add-gateway-operations/specs/task-audit-artifacts/spec.md":{"bytes":2597,"sha256":"8d2cb83159ed06b09358d3f950ae20489ea964a864c289168ab2c5a8e57ffadb"},"openspec/changes/add-gateway-operations/specs/tool-model-catalogs/spec.md":{"bytes":2463,"sha256":"a424d99c94d69cb61fa9e3f0efeb9dc8c1702d37c397f789c3363a79066df547"},"openspec/changes/add-gateway-operations/tasks.md":{"bytes":5352,"sha256":"12b19adb7b2a84e0fc263e8a8378719d2f5978f2dc5f619f3c856eb70a66b4f5"},"openspec/changes/add-managed-gateway-client/.openspec.yaml":{"bytes":40,"sha256":"dc10040214104474c4e34e5b38359540c882aa7cfb6e7221e5d0614f1dba8fd7"},"openspec/changes/add-managed-gateway-client/design.md":{"bytes":5113,"sha256":"162801004ae85138dc1d03ecb0654506986c26053bfe6fa9e72704edb01de6a2"},"openspec/changes/add-managed-gateway-client/proposal.md":{"bytes":2019,"sha256":"a91469801a7becd8ab01272697394c1d44c367ac2ae0666814b6f6b5706a01cf"},"openspec/changes/add-managed-gateway-client/specs/gateway-recovery/spec.md":{"bytes":2762,"sha256":"af082acc14c97793b8f9231b500e86e8e5c77455ae04a88b0b24fdfa4ed3335e"},"openspec/changes/add-managed-gateway-client/specs/managed-rpc/spec.md":{"bytes":2624,"sha256":"6aa6031b61a113443b8d560e58baae1c041ddc465630b736fa9a23b1fdb4408d"},"openspec/changes/add-managed-gateway-client/specs/typed-event-delivery/spec.md":{"bytes":2613,"sha256":"c5def41f0c9510153b5eb773521778d6121cad2ca4b2bdc733e9cfaa40275552"},"openspec/changes/add-managed-gateway-client/tasks.md":{"bytes":3249,"sha256":"978d020d94027db3801c090dd7e86bbd65b2568c64880950320e57087ee96970"},"openspec/changes/add-optional-runtime-adapters/.openspec.yaml":{"bytes":40,"sha256":"dc10040214104474c4e34e5b38359540c882aa7cfb6e7221e5d0614f1dba8fd7"},"openspec/changes/add-optional-runtime-adapters/design.md":{"bytes":4940,"sha256":"65332fcd6d91ff4ca9e77d53f606caccec2795fae74160bb95d357da482546c9"},"openspec/changes/add-optional-runtime-adapters/proposal.md":{"bytes":2065,"sha256":"a32b0507234b8e78719cb7716dc484212797b3c0259daa76931bf2c7820b4b3e"},"openspec/changes/add-optional-runtime-adapters/specs/cli-typed-results/spec.md":{"bytes":2609,"sha256":"2f9836a84b4b5ae66abae680ef1ec52c35531029b4682a75cc5a3c2e8cc6c67f"},"openspec/changes/add-optional-runtime-adapters/specs/persistent-stdio-adapters/spec.md":{"bytes":2509,"sha256":"ea7d2f8599d97c4ccd8f23ada658f636be62d2bdb715ed82f026a22286a7a3db"},"openspec/changes/add-optional-runtime-adapters/specs/terminal-voice-adapters/spec.md":{"bytes":2620,"sha256":"77fbb21d872b83da1cda418e6a7e1d94b0ea496ac566e6808225f2031a1c39a0"},"openspec/changes/add-optional-runtime-adapters/tasks.md":{"bytes":3318,"sha256":"a86f42485573c87ffa97e3296c3c20cfc128b63db40166a28ee7daf48e1b9f0c"},"openspec/changes/establish-sdk-compatibility-governance/.openspec.yaml":{"bytes":40,"sha256":"dc10040214104474c4e34e5b38359540c882aa7cfb6e7221e5d0614f1dba8fd7"},"openspec/changes/establish-sdk-compatibility-governance/design.md":{"bytes":5448,"sha256":"d3150d2e298788a186c934920cb111bdef4b6801e6c34052741b61895c4dd372"},"openspec/changes/establish-sdk-compatibility-governance/evidence/2026-09-20-precursor-evidence.md":{"bytes":2383,"sha256":"e55309e91a1f190e62b3c29de385509def154a9d534f2963d8f4b69c4fd27db4"},"openspec/changes/establish-sdk-compatibility-governance/evidence/2026-11-18-live-gateway.md":{"bytes":6012,"sha256":"8a39e6c4943c4d5fadfd5ed8000d54510b5ba53dc7ab4ca8a594f0ed142b5b8c"},"openspec/changes/establish-sdk-compatibility-governance/evidence/2026-11-18-locked-gateway-schema.md":{"bytes":2169,"sha256":"6728253fe492a99ebc24eb8c3bc261331317a6324db7c3a168610883ab41048f"},"openspec/changes/establish-sdk-compatibility-governance/evidence/capability-inventory.json":{"bytes":2118,"sha256":"c8148e22712176d1991cec37e8f80861996053c693f76a2998a3f7a37fd00822"},"openspec/changes/establish-sdk-compatibility-governance/evidence/fixtures/GatewayCompatibilityFixtureTest.java":{"bytes":3177,"sha256":"7e13d512dccef6b533f5bf04caa1556b97cc7c9a97f8776204196d71c87d38f8"},"openspec/changes/establish-sdk-compatibility-governance/evidence/version-lock.md":{"bytes":1139,"sha256":"7d53174fb9aad9244934bafec50f364ce869f8bcb92445b96aba2c2af64e67f3"},"openspec/changes/establish-sdk-compatibility-governance/proposal.md":{"bytes":1789,"sha256":"88e18f4f66ebccace6da321cb7d0a6b4d788e8e84cc933ab3678a5389b459ed6"},"openspec/changes/establish-sdk-compatibility-governance/specs/sdk-compatibility-governance/spec.md":{"bytes":3830,"sha256":"3d14086cef101a78b83ef953e16cea13b4b341ca9c9552c62596ee9ab85131a1"},"openspec/changes/establish-sdk-compatibility-governance/tasks.md":{"bytes":4126,"sha256":"3f5591d6a6f5ad72d3e66d3be4ecfae8b02f10e524aa8987d9e52a947276e611"},"openspec/changes/fix-openclaw-protocol-contracts/.openspec.yaml":{"bytes":40,"sha256":"dc10040214104474c4e34e5b38359540c882aa7cfb6e7221e5d0614f1dba8fd7"},"openspec/changes/fix-openclaw-protocol-contracts/design.md":{"bytes":5675,"sha256":"10966f9bc03d3b34138539aeeb4b7ad884b28763cc2290c1f95926b69335dbbb"},"openspec/changes/fix-openclaw-protocol-contracts/proposal.md":{"bytes":2418,"sha256":"11a51837e386f1068004c526673547610a5b84dca8b42fc6d9484da02cc9b270"},"openspec/changes/fix-openclaw-protocol-contracts/specs/gateway-chat-events/spec.md":{"bytes":2622,"sha256":"3564b6061b568c1d30577fc8b228243f21df756321de9e50dd4a763529afb5b9"},"openspec/changes/fix-openclaw-protocol-contracts/specs/gateway-device-auth/spec.md":{"bytes":2806,"sha256":"2a6d8d7d5202495cdace92ffd12a500ee9f0266a172aa4147852e4cf43ee2a4a"},"openspec/changes/fix-openclaw-protocol-contracts/specs/responses-streaming/spec.md":{"bytes":2695,"sha256":"1ca9b80db706c236ca32ae0acd8a02a190fc3644959aa58af4379035923c3b82"},"openspec/changes/fix-openclaw-protocol-contracts/specs/session-history-contract/spec.md":{"bytes":2651,"sha256":"7fcc7baab4e3d9f10dd86adb03e00f78b07a7f011747a744224ca3dadf89168c"},"openspec/changes/fix-openclaw-protocol-contracts/specs/tools-invoke-contract/spec.md":{"bytes":2681,"sha256":"f255110ecff5a9479b780ec81dce1c451d638fe69259196e0ef063c5343a62f1"},"openspec/changes/fix-openclaw-protocol-contracts/tasks.md":{"bytes":4698,"sha256":"fd7a21979c085430e70479494b8f87c88e9746cf277463628a93a92a7932130a"},"openspec/config.yaml":{"bytes":1862,"sha256":"151f5ce61678f2d47d19a1c21168936f7ad5c6f05adec25db6a0e8a70f1f8ba9"},"openspec/specs/.gitkeep":{"bytes":1,"sha256":"01ba4719c80b6fe911b091a7c05124b64eeece964e09c058ef8f9805daca546b"}},"split_report":{"path":"docs/openclaw-integration/validation-report","encoding":"concatenated-base64-of-gzip","original_bytes":127699,"original_sha256":"a689415d7e7c1a28cc50a97179c797adc29080b30f5ec929aa8ed23227a1a598","parts":3},"source_package_note":"The source package hash identifies the original 2026-09-20 bundle. The file inventory also includes subsequent G0 evidence and documentation edits."} +{"scope":"repository documentation; paths relative to repository root; manifest excludes itself","source_package":"openclaw-java-sdk-openspec-draft-2026-09-20.zip","source_package_sha256":"f8eedbb0356b34ecde22584b57fdc9d375fa7409c36d6931b7faca36f4919468","files":{"docs/openclaw-integration/README.md":{"bytes":2882,"sha256":"7af61aea4d0c57c7e1f2c2b83a52126c4ab5b00f6a98962ead41687128789225"},"docs/openclaw-integration/acceptance-plan.md":{"bytes":4591,"sha256":"4875a07fd14cd9771d610d221ab8e666bf2801341b3ccc21302627f06fa2089f"},"docs/openclaw-integration/baseline.json":{"bytes":3221,"sha256":"b5b13dd410d068a5b07b4c27be01658aa94bb626dce9beffc44ebce9565789ab"},"docs/openclaw-integration/coverage-baseline.md":{"bytes":4792,"sha256":"ae4b7783b718a268c697fdd85f1f24800f838cb1063ae90e4324c224efc7f820"},"docs/openclaw-integration/roadmap.md":{"bytes":3880,"sha256":"edb7e1a9717f05e1128eda44fb41fbddcd595cfd2e165ab1ea6d920ca38d5aa6"},"docs/openclaw-integration/source-register.md":{"bytes":5424,"sha256":"992bf67dd8da00cccaeaf4a93ed594b2877d832ed3015b402c3a4eabb0b523f0"},"docs/openclaw-integration/traceability.json.gz":{"bytes":3246,"sha256":"75386731e6f4b685d61a8c582e18edbdc86577e717039716c1c908f8422befcd","decompressed_sha256":"da585354d01fb0f687d764840f7512259de832896db051fe450ac667fd6bf6bb"},"docs/openclaw-integration/traceability.md":{"bytes":13633,"sha256":"2eee7ecf7b4e7db906226082a130d4b80b9bd44be7d4d699aeeb8ada749f3384"},"docs/openclaw-integration/validation-report/README.md":{"bytes":1113,"sha256":"b67e0eb4a969e742b6e30e35883dcac0c3cc15aca0005e6d66377b99995e2932"},"docs/openclaw-integration/validation-report/part-001.b64":{"bytes":2601,"sha256":"9570f3b3818b997c948cb9ee4a5c4885d664cacdfec18e0b3d1e9858ae695a32"},"docs/openclaw-integration/validation-report/part-002.b64":{"bytes":2601,"sha256":"d57ebdd3717bab8648f4f98a70430515d0750ebb38cd72a970e246ddeb049952"},"docs/openclaw-integration/validation-report/part-003.b64":{"bytes":2537,"sha256":"61a7c754d543e645ad6b705add8f183ac0e6605340f0993b9bc5cb4647fef85b"},"docs/openclaw-integration/validation-summary.md":{"bytes":2141,"sha256":"40e31c0cd1ebb639cf1e852b0b0180bda27e28c16dcba9b90e3cb8aabd0f6d10"},"openspec/README.md":{"bytes":611,"sha256":"58a1b2615971f2c7fb56f069006b8559cf5cf1548c01b29c83758c894ec79f20"},"openspec/changes/add-agent-session-approval-control/.openspec.yaml":{"bytes":40,"sha256":"dc10040214104474c4e34e5b38359540c882aa7cfb6e7221e5d0614f1dba8fd7"},"openspec/changes/add-agent-session-approval-control/design.md":{"bytes":4797,"sha256":"95794f1f71841a3d6a5ca61d10bbffaf5be029f8284cf75ac4b6020e4564d3d1"},"openspec/changes/add-agent-session-approval-control/proposal.md":{"bytes":1936,"sha256":"da5665faa52a3e14e756e021e2b9dec56c5f6bb5d73af277e756050a4399c741"},"openspec/changes/add-agent-session-approval-control/specs/agent-lifecycle/spec.md":{"bytes":2664,"sha256":"0b12b0240d1a5d37bcaa8c69604ca53ca67c4a372440262d14ed01b0ffd1a174"},"openspec/changes/add-agent-session-approval-control/specs/approval-control/spec.md":{"bytes":2549,"sha256":"3b979ba5b34b8aa1e1fef3a216e663b5b194b7bce713092d73cc4eed83f0c09b"},"openspec/changes/add-agent-session-approval-control/specs/session-control/spec.md":{"bytes":2543,"sha256":"ecf939250f43f526c1d78a5a2bc2902e5889cf13474a7c80e440e7232d5c24fb"},"openspec/changes/add-agent-session-approval-control/tasks.md":{"bytes":3242,"sha256":"782b9f42a8b58fab966c04920d27a98ea77d588102594219572eae5b17cbad11"},"openspec/changes/add-gateway-operations/.openspec.yaml":{"bytes":40,"sha256":"dc10040214104474c4e34e5b38359540c882aa7cfb6e7221e5d0614f1dba8fd7"},"openspec/changes/add-gateway-operations/design.md":{"bytes":5441,"sha256":"d07d9f9c3c5da092be96a18f0e6c35be53fe06f2eda9f540ef993961be8f247d"},"openspec/changes/add-gateway-operations/proposal.md":{"bytes":2342,"sha256":"c6081bd3692307909e736b7d84ccc34828b4fa5152a118f86dc577fa6ac3d47f"},"openspec/changes/add-gateway-operations/specs/channel-node-control/spec.md":{"bytes":2663,"sha256":"4350182f113da6caff9cd0eb81f2cb5173be374bd2f6665e16a9f93111fb4649"},"openspec/changes/add-gateway-operations/specs/configuration-control/spec.md":{"bytes":2432,"sha256":"cf8839be9d8c9015cfb855422fcdfdfaee02275965f2b3a12b42ce4987b8b3c1"},"openspec/changes/add-gateway-operations/specs/cron-control/spec.md":{"bytes":2453,"sha256":"8f86038254595e09c705b4b680d41aed60b2332f019139e35b5a65c329774274"},"openspec/changes/add-gateway-operations/specs/skill-plugin-lifecycle/spec.md":{"bytes":2551,"sha256":"01ef9d030ab116a21bcca1ff7f8d9ced27968015939cd1bf4c2ed99955f445bd"},"openspec/changes/add-gateway-operations/specs/task-audit-artifacts/spec.md":{"bytes":2597,"sha256":"8d2cb83159ed06b09358d3f950ae20489ea964a864c289168ab2c5a8e57ffadb"},"openspec/changes/add-gateway-operations/specs/tool-model-catalogs/spec.md":{"bytes":2463,"sha256":"a424d99c94d69cb61fa9e3f0efeb9dc8c1702d37c397f789c3363a79066df547"},"openspec/changes/add-gateway-operations/tasks.md":{"bytes":5352,"sha256":"12b19adb7b2a84e0fc263e8a8378719d2f5978f2dc5f619f3c856eb70a66b4f5"},"openspec/changes/add-managed-gateway-client/.openspec.yaml":{"bytes":40,"sha256":"dc10040214104474c4e34e5b38359540c882aa7cfb6e7221e5d0614f1dba8fd7"},"openspec/changes/add-managed-gateway-client/design.md":{"bytes":5113,"sha256":"162801004ae85138dc1d03ecb0654506986c26053bfe6fa9e72704edb01de6a2"},"openspec/changes/add-managed-gateway-client/proposal.md":{"bytes":2019,"sha256":"a91469801a7becd8ab01272697394c1d44c367ac2ae0666814b6f6b5706a01cf"},"openspec/changes/add-managed-gateway-client/specs/gateway-recovery/spec.md":{"bytes":2762,"sha256":"af082acc14c97793b8f9231b500e86e8e5c77455ae04a88b0b24fdfa4ed3335e"},"openspec/changes/add-managed-gateway-client/specs/managed-rpc/spec.md":{"bytes":2624,"sha256":"6aa6031b61a113443b8d560e58baae1c041ddc465630b736fa9a23b1fdb4408d"},"openspec/changes/add-managed-gateway-client/specs/typed-event-delivery/spec.md":{"bytes":2613,"sha256":"c5def41f0c9510153b5eb773521778d6121cad2ca4b2bdc733e9cfaa40275552"},"openspec/changes/add-managed-gateway-client/tasks.md":{"bytes":3249,"sha256":"978d020d94027db3801c090dd7e86bbd65b2568c64880950320e57087ee96970"},"openspec/changes/add-optional-runtime-adapters/.openspec.yaml":{"bytes":40,"sha256":"dc10040214104474c4e34e5b38359540c882aa7cfb6e7221e5d0614f1dba8fd7"},"openspec/changes/add-optional-runtime-adapters/design.md":{"bytes":4940,"sha256":"65332fcd6d91ff4ca9e77d53f606caccec2795fae74160bb95d357da482546c9"},"openspec/changes/add-optional-runtime-adapters/proposal.md":{"bytes":2065,"sha256":"a32b0507234b8e78719cb7716dc484212797b3c0259daa76931bf2c7820b4b3e"},"openspec/changes/add-optional-runtime-adapters/specs/cli-typed-results/spec.md":{"bytes":2609,"sha256":"2f9836a84b4b5ae66abae680ef1ec52c35531029b4682a75cc5a3c2e8cc6c67f"},"openspec/changes/add-optional-runtime-adapters/specs/persistent-stdio-adapters/spec.md":{"bytes":2509,"sha256":"ea7d2f8599d97c4ccd8f23ada658f636be62d2bdb715ed82f026a22286a7a3db"},"openspec/changes/add-optional-runtime-adapters/specs/terminal-voice-adapters/spec.md":{"bytes":2620,"sha256":"77fbb21d872b83da1cda418e6a7e1d94b0ea496ac566e6808225f2031a1c39a0"},"openspec/changes/add-optional-runtime-adapters/tasks.md":{"bytes":3318,"sha256":"a86f42485573c87ffa97e3296c3c20cfc128b63db40166a28ee7daf48e1b9f0c"},"openspec/changes/establish-sdk-compatibility-governance/.openspec.yaml":{"bytes":40,"sha256":"dc10040214104474c4e34e5b38359540c882aa7cfb6e7221e5d0614f1dba8fd7"},"openspec/changes/establish-sdk-compatibility-governance/design.md":{"bytes":5448,"sha256":"d3150d2e298788a186c934920cb111bdef4b6801e6c34052741b61895c4dd372"},"openspec/changes/establish-sdk-compatibility-governance/evidence/2026-09-20-precursor-evidence.md":{"bytes":2383,"sha256":"e55309e91a1f190e62b3c29de385509def154a9d534f2963d8f4b69c4fd27db4"},"openspec/changes/establish-sdk-compatibility-governance/evidence/2026-11-18-live-gateway.md":{"bytes":6012,"sha256":"8a39e6c4943c4d5fadfd5ed8000d54510b5ba53dc7ab4ca8a594f0ed142b5b8c"},"openspec/changes/establish-sdk-compatibility-governance/evidence/2026-11-18-locked-gateway-schema.md":{"bytes":2169,"sha256":"6728253fe492a99ebc24eb8c3bc261331317a6324db7c3a168610883ab41048f"},"openspec/changes/establish-sdk-compatibility-governance/evidence/2026-11-19-governance-scenario-audit.md":{"bytes":4171,"sha256":"b3e6fc942311e1918fdef8a1ee032e1cbf2cda3a5e65c974bd9b3da3a96a259c"},"openspec/changes/establish-sdk-compatibility-governance/evidence/capability-inventory.json":{"bytes":2118,"sha256":"c8148e22712176d1991cec37e8f80861996053c693f76a2998a3f7a37fd00822"},"openspec/changes/establish-sdk-compatibility-governance/evidence/fixtures/GatewayCompatibilityFixtureTest.java":{"bytes":3177,"sha256":"7e13d512dccef6b533f5bf04caa1556b97cc7c9a97f8776204196d71c87d38f8"},"openspec/changes/establish-sdk-compatibility-governance/evidence/version-lock.md":{"bytes":1139,"sha256":"7d53174fb9aad9244934bafec50f364ce869f8bcb92445b96aba2c2af64e67f3"},"openspec/changes/establish-sdk-compatibility-governance/proposal.md":{"bytes":1789,"sha256":"88e18f4f66ebccace6da321cb7d0a6b4d788e8e84cc933ab3678a5389b459ed6"},"openspec/changes/establish-sdk-compatibility-governance/specs/sdk-compatibility-governance/spec.md":{"bytes":3830,"sha256":"3d14086cef101a78b83ef953e16cea13b4b341ca9c9552c62596ee9ab85131a1"},"openspec/changes/establish-sdk-compatibility-governance/tasks.md":{"bytes":4229,"sha256":"6e1bf576141cbf53a07cc6648b60a2624ee9fd2ad1f695127ef6f3f8f1c65931"},"openspec/changes/fix-openclaw-protocol-contracts/.openspec.yaml":{"bytes":40,"sha256":"dc10040214104474c4e34e5b38359540c882aa7cfb6e7221e5d0614f1dba8fd7"},"openspec/changes/fix-openclaw-protocol-contracts/design.md":{"bytes":5675,"sha256":"10966f9bc03d3b34138539aeeb4b7ad884b28763cc2290c1f95926b69335dbbb"},"openspec/changes/fix-openclaw-protocol-contracts/proposal.md":{"bytes":2418,"sha256":"11a51837e386f1068004c526673547610a5b84dca8b42fc6d9484da02cc9b270"},"openspec/changes/fix-openclaw-protocol-contracts/specs/gateway-chat-events/spec.md":{"bytes":2622,"sha256":"3564b6061b568c1d30577fc8b228243f21df756321de9e50dd4a763529afb5b9"},"openspec/changes/fix-openclaw-protocol-contracts/specs/gateway-device-auth/spec.md":{"bytes":2806,"sha256":"2a6d8d7d5202495cdace92ffd12a500ee9f0266a172aa4147852e4cf43ee2a4a"},"openspec/changes/fix-openclaw-protocol-contracts/specs/responses-streaming/spec.md":{"bytes":2695,"sha256":"1ca9b80db706c236ca32ae0acd8a02a190fc3644959aa58af4379035923c3b82"},"openspec/changes/fix-openclaw-protocol-contracts/specs/session-history-contract/spec.md":{"bytes":2651,"sha256":"7fcc7baab4e3d9f10dd86adb03e00f78b07a7f011747a744224ca3dadf89168c"},"openspec/changes/fix-openclaw-protocol-contracts/specs/tools-invoke-contract/spec.md":{"bytes":2681,"sha256":"f255110ecff5a9479b780ec81dce1c451d638fe69259196e0ef063c5343a62f1"},"openspec/changes/fix-openclaw-protocol-contracts/tasks.md":{"bytes":4698,"sha256":"fd7a21979c085430e70479494b8f87c88e9746cf277463628a93a92a7932130a"},"openspec/config.yaml":{"bytes":1862,"sha256":"151f5ce61678f2d47d19a1c21168936f7ad5c6f05adec25db6a0e8a70f1f8ba9"},"openspec/specs/.gitkeep":{"bytes":1,"sha256":"01ba4719c80b6fe911b091a7c05124b64eeece964e09c058ef8f9805daca546b"}},"split_report":{"path":"docs/openclaw-integration/validation-report","encoding":"concatenated-base64-of-gzip","original_bytes":127699,"original_sha256":"a689415d7e7c1a28cc50a97179c797adc29080b30f5ec929aa8ed23227a1a598","parts":3},"source_package_note":"The source package hash identifies the original 2026-09-20 bundle. The file inventory also includes subsequent G0 evidence and documentation edits."} diff --git a/docs/openclaw-integration/traceability.md b/docs/openclaw-integration/traceability.md index 4172c1b..405f871 100644 --- a/docs/openclaw-integration/traceability.md +++ b/docs/openclaw-integration/traceability.md @@ -1,6 +1,6 @@ # Requirement → Scenario → Task 追踪表 -所有状态为 NOT_RUN;文档场景不是测试执行结果。 +表中状态记录首次编制时的基线。八个治理场景的后续验证见 [G0 场景证据核对](../../openspec/changes/establish-sdk-compatibility-governance/evidence/2026-11-19-governance-scenario-audit.md)。 | Change | Capability | Requirement | Scenario | Tasks | 状态 | |---|---|---|---|---|---| diff --git a/openspec/changes/establish-sdk-compatibility-governance/evidence/2026-11-19-governance-scenario-audit.md b/openspec/changes/establish-sdk-compatibility-governance/evidence/2026-11-19-governance-scenario-audit.md new file mode 100644 index 0000000..ae78576 --- /dev/null +++ b/openspec/changes/establish-sdk-compatibility-governance/evidence/2026-11-19-governance-scenario-audit.md @@ -0,0 +1,31 @@ +# G0 场景证据核对(2026-11-19) + +[规格场景](../specs/sdk-compatibility-governance/spec.md)的当前检查记录如下。原始追踪表保留首次编制时的历史状态。真实 Gateway 验证结果以对应 SDK 提交、目标版本和具体调用为准。 + +| 场景 | 已核对的证据 | 剩余验收 | +|---|---|---| +| GOV-01-S1 真实通过可追溯 | [实测记录](2026-11-18-live-gateway.md)绑定三条维护线、两版 Gateway、JDK、Maven、命令和四项测试。 | 核对发布兼容矩阵的实际内容及评审记录。 | +| GOV-01-S2 缺少运行证据 | [能力清单](capability-inventory.json)保留静态存在、未封装以及 `liveVerified=false`。维护线 README 仅声明已实测的 WebSocket 范围。 | 发布时逐项核对能力声明。 | +| GOV-02-S1 依赖适配差异 | [共用样本](fixtures/GatewayCompatibilityFixtureTest.java)在 Java 8、17、21 上执行,两版 Gateway 共通过 24 项检查。 | 流重建、终态语义及允许差异清单仍待验收。 | +| GOV-02-S2 单分支缺测 | [实测记录](2026-11-18-live-gateway.md)为各维护线分别列出结果,并独立记录默认分支拒绝;其它协议能力仍未标记为通过。 | 用只验证一条线的样本演示发布流程如何阻止全线声明。 | +| GOV-03-S1 文档评审 | [设计稿](../design.md)标明草案,[任务清单](../tasks.md)保留未完成项。 | 维护者记录范围、版本和依赖审批。 | +| GOV-03-S2 提前归档 | [归档判定](../design.md#评审与归档判定)列明阻断项,生效规范尚未更新。 | 维护者确认归档拒绝条件和验收记录。 | +| GOV-04-S1 版本升级 | 本页对两个精确提交的官方 schema 进行离线比较。候选版握手与会话读取有独立实测。 | 确认候选字段的样本、语义和采用范围。 | +| GOV-04-S2 已移除调用 | schema 中缺少同名定义可作为检查线索。 | 需从运行时方法注册表确认实际移除的调用,并验证 SDK 的明确拒绝及权限边界。 | + +## 锁定版与候选版 schema 差异 + +| Gateway | 上游提交 | 定义数 | 生成产物 SHA-256 | +|---|---|---:|---| +| 2026.7.1-2 | `0790d9f593ad30c940ed93b5872a8cf6d6f3cf8c` | 322 | `0c5758a9750691b6fb070c6344297bce6ddeba89afd715e45531a9508a168699` | +| 2026.11.5 | `e13cf15ece9bbd969b7362927c315362c90c97ff` | 1149 | `fd29d1da7e6ebd0c1014617611ff442164495b3130bbdaea79ca87925324b8b6` | + +两份产物均为 Draft-07,全部本地 JSON Pointer 引用均可解析。按定义名称比较原始 JSON 对象,共有 275 项同名定义,其中 126 项相同、149 项不同;874 个名称仅在候选版出现,47 个名称仅在锁定版出现。候选版还生成 559 条核心方法元数据。定义数受展开方式和生成器变化影响,方法是否存在应通过注册表及运行验证确认。 + +- `ConnectParams` 新增 `computerUse`、`includeSessionMessageBodies`、`modelCatalog` 和 `workerRuns` 字段,顶层必填字段列表相同。 +- `SessionsListParams` 新增 `rowMode`、`ownerId`、`ifRowsRevision` 等字段。候选版元数据将 `sessions.list` 归到 `operator.read`。两版运行验证均覆盖读取成功及缺少权限的拒绝。 +- `RequestFrame` 新增 `expectedProfileId`、`traceparent`,`EventFrame` 新增 `recipientProfileId`。此次未对新增字段执行运行验证。 + +候选版使用原始 [上游生成器](https://github.com/openclaw/openclaw/blob/e13cf15ece9bbd969b7362927c315362c90c97ff/scripts/protocol-gen.ts),环境为 Node 24.18.0、tsx 4.23.15 和 typebox 1.4.2。临时检出按同一 tag 补齐 `packages/gateway-protocol`、`packages/normalization-core`、`scripts`、`src/gateway` 和 `src/shared`。其中 `@openclaw/normalization-core` 的构建导出使用同版本 npm 发布包的 `dist/normalization-core`,由临时符号链接提供给检出目录的包导出入口。生成器调用 `node --import ./scripts/tsx.mjs scripts/protocol-gen.ts --out <临时路径>`,执行两次,两个文件逐字节相同。上游检出中的跟踪文件未修改。 + +本次对照保留原目标版本及评审状态。候选版新增行为应按规格另行验收。 diff --git a/openspec/changes/establish-sdk-compatibility-governance/tasks.md b/openspec/changes/establish-sdk-compatibility-governance/tasks.md index 95fd18f..96a43de 100644 --- a/openspec/changes/establish-sdk-compatibility-governance/tasks.md +++ b/openspec/changes/establish-sdk-compatibility-governance/tasks.md @@ -13,7 +13,7 @@ - [x] 2.1 为 GOV-01、GOV-04 建立机器可读的能力、版本和证据清单;(证据:evidence/2026-09-20-precursor-evidence.md、capability-inventory.json——8 项静态存在均 liveVerified=false,4 项未封装,无 live-pass 标记)验收:能区分静态存在、部分实现、CLI 透传、未封装、未验证与不适用,并演示缺失证据不能被标记为 live-pass。 - [ ] 2.2 为 GOV-02 建立三分支协议 fixture 和获准差异清单;[共用 Gateway 测试样本](evidence/2026-11-18-live-gateway.md#三条维护线共用的-gateway-测试样本)已实测握手、认证和读取权限,完整协议范围与差异清单待评审。验收:同一行为具有共同场景标识,JSON 包名和 JDK 差异不被误判为功能分叉,行为差异不能被全局忽略。 - [ ] 2.3 为 GOV-03 建立规范评审与归档检查步骤;验收:DRAFT、REVIEWED、IMPLEMENTED、VERIFIED 与 ARCHIVED 分开,未执行任务和缺证据场景可阻止本项目归档流程。 -- [ ] 2.4 逐项映射 traceability 中 GOV-01-S1 至 GOV-04-S2;验收:八个场景均有对应检查或人工审核记录,重写 README 不得替代证据校验。 +- [ ] 2.4 逐项映射 traceability 中 GOV-01-S1 至 GOV-04-S2;[场景证据核对](evidence/2026-11-19-governance-scenario-audit.md)已标注各项核查与缺口。验收:八个场景均有对应检查或人工审核记录,重写 README 不得替代证据校验。 ## 3. 基线验证与文档同步 From bedd330905e306bd5ca399f9b263fc737713bf97 Mon Sep 17 00:00:00 2001 From: loong10k <20489781+loong10k@users.noreply.github.com> Date: Thu, 19 Nov 2026 00:13:56 +0800 Subject: [PATCH 11/22] test: verify unavailable Gateway methods across SDK lines --- .../package-manifest.json | 2 +- .../2026-11-19-governance-scenario-audit.md | 19 +++- .../RemovedGatewayMethodFixtureTest.java | 88 +++++++++++++++++++ 3 files changed, 107 insertions(+), 2 deletions(-) create mode 100644 openspec/changes/establish-sdk-compatibility-governance/evidence/fixtures/RemovedGatewayMethodFixtureTest.java diff --git a/docs/openclaw-integration/package-manifest.json b/docs/openclaw-integration/package-manifest.json index 22760a7..b41aa49 100644 --- a/docs/openclaw-integration/package-manifest.json +++ b/docs/openclaw-integration/package-manifest.json @@ -1 +1 @@ -{"scope":"repository documentation; paths relative to repository root; manifest excludes itself","source_package":"openclaw-java-sdk-openspec-draft-2026-09-20.zip","source_package_sha256":"f8eedbb0356b34ecde22584b57fdc9d375fa7409c36d6931b7faca36f4919468","files":{"docs/openclaw-integration/README.md":{"bytes":2882,"sha256":"7af61aea4d0c57c7e1f2c2b83a52126c4ab5b00f6a98962ead41687128789225"},"docs/openclaw-integration/acceptance-plan.md":{"bytes":4591,"sha256":"4875a07fd14cd9771d610d221ab8e666bf2801341b3ccc21302627f06fa2089f"},"docs/openclaw-integration/baseline.json":{"bytes":3221,"sha256":"b5b13dd410d068a5b07b4c27be01658aa94bb626dce9beffc44ebce9565789ab"},"docs/openclaw-integration/coverage-baseline.md":{"bytes":4792,"sha256":"ae4b7783b718a268c697fdd85f1f24800f838cb1063ae90e4324c224efc7f820"},"docs/openclaw-integration/roadmap.md":{"bytes":3880,"sha256":"edb7e1a9717f05e1128eda44fb41fbddcd595cfd2e165ab1ea6d920ca38d5aa6"},"docs/openclaw-integration/source-register.md":{"bytes":5424,"sha256":"992bf67dd8da00cccaeaf4a93ed594b2877d832ed3015b402c3a4eabb0b523f0"},"docs/openclaw-integration/traceability.json.gz":{"bytes":3246,"sha256":"75386731e6f4b685d61a8c582e18edbdc86577e717039716c1c908f8422befcd","decompressed_sha256":"da585354d01fb0f687d764840f7512259de832896db051fe450ac667fd6bf6bb"},"docs/openclaw-integration/traceability.md":{"bytes":13633,"sha256":"2eee7ecf7b4e7db906226082a130d4b80b9bd44be7d4d699aeeb8ada749f3384"},"docs/openclaw-integration/validation-report/README.md":{"bytes":1113,"sha256":"b67e0eb4a969e742b6e30e35883dcac0c3cc15aca0005e6d66377b99995e2932"},"docs/openclaw-integration/validation-report/part-001.b64":{"bytes":2601,"sha256":"9570f3b3818b997c948cb9ee4a5c4885d664cacdfec18e0b3d1e9858ae695a32"},"docs/openclaw-integration/validation-report/part-002.b64":{"bytes":2601,"sha256":"d57ebdd3717bab8648f4f98a70430515d0750ebb38cd72a970e246ddeb049952"},"docs/openclaw-integration/validation-report/part-003.b64":{"bytes":2537,"sha256":"61a7c754d543e645ad6b705add8f183ac0e6605340f0993b9bc5cb4647fef85b"},"docs/openclaw-integration/validation-summary.md":{"bytes":2141,"sha256":"40e31c0cd1ebb639cf1e852b0b0180bda27e28c16dcba9b90e3cb8aabd0f6d10"},"openspec/README.md":{"bytes":611,"sha256":"58a1b2615971f2c7fb56f069006b8559cf5cf1548c01b29c83758c894ec79f20"},"openspec/changes/add-agent-session-approval-control/.openspec.yaml":{"bytes":40,"sha256":"dc10040214104474c4e34e5b38359540c882aa7cfb6e7221e5d0614f1dba8fd7"},"openspec/changes/add-agent-session-approval-control/design.md":{"bytes":4797,"sha256":"95794f1f71841a3d6a5ca61d10bbffaf5be029f8284cf75ac4b6020e4564d3d1"},"openspec/changes/add-agent-session-approval-control/proposal.md":{"bytes":1936,"sha256":"da5665faa52a3e14e756e021e2b9dec56c5f6bb5d73af277e756050a4399c741"},"openspec/changes/add-agent-session-approval-control/specs/agent-lifecycle/spec.md":{"bytes":2664,"sha256":"0b12b0240d1a5d37bcaa8c69604ca53ca67c4a372440262d14ed01b0ffd1a174"},"openspec/changes/add-agent-session-approval-control/specs/approval-control/spec.md":{"bytes":2549,"sha256":"3b979ba5b34b8aa1e1fef3a216e663b5b194b7bce713092d73cc4eed83f0c09b"},"openspec/changes/add-agent-session-approval-control/specs/session-control/spec.md":{"bytes":2543,"sha256":"ecf939250f43f526c1d78a5a2bc2902e5889cf13474a7c80e440e7232d5c24fb"},"openspec/changes/add-agent-session-approval-control/tasks.md":{"bytes":3242,"sha256":"782b9f42a8b58fab966c04920d27a98ea77d588102594219572eae5b17cbad11"},"openspec/changes/add-gateway-operations/.openspec.yaml":{"bytes":40,"sha256":"dc10040214104474c4e34e5b38359540c882aa7cfb6e7221e5d0614f1dba8fd7"},"openspec/changes/add-gateway-operations/design.md":{"bytes":5441,"sha256":"d07d9f9c3c5da092be96a18f0e6c35be53fe06f2eda9f540ef993961be8f247d"},"openspec/changes/add-gateway-operations/proposal.md":{"bytes":2342,"sha256":"c6081bd3692307909e736b7d84ccc34828b4fa5152a118f86dc577fa6ac3d47f"},"openspec/changes/add-gateway-operations/specs/channel-node-control/spec.md":{"bytes":2663,"sha256":"4350182f113da6caff9cd0eb81f2cb5173be374bd2f6665e16a9f93111fb4649"},"openspec/changes/add-gateway-operations/specs/configuration-control/spec.md":{"bytes":2432,"sha256":"cf8839be9d8c9015cfb855422fcdfdfaee02275965f2b3a12b42ce4987b8b3c1"},"openspec/changes/add-gateway-operations/specs/cron-control/spec.md":{"bytes":2453,"sha256":"8f86038254595e09c705b4b680d41aed60b2332f019139e35b5a65c329774274"},"openspec/changes/add-gateway-operations/specs/skill-plugin-lifecycle/spec.md":{"bytes":2551,"sha256":"01ef9d030ab116a21bcca1ff7f8d9ced27968015939cd1bf4c2ed99955f445bd"},"openspec/changes/add-gateway-operations/specs/task-audit-artifacts/spec.md":{"bytes":2597,"sha256":"8d2cb83159ed06b09358d3f950ae20489ea964a864c289168ab2c5a8e57ffadb"},"openspec/changes/add-gateway-operations/specs/tool-model-catalogs/spec.md":{"bytes":2463,"sha256":"a424d99c94d69cb61fa9e3f0efeb9dc8c1702d37c397f789c3363a79066df547"},"openspec/changes/add-gateway-operations/tasks.md":{"bytes":5352,"sha256":"12b19adb7b2a84e0fc263e8a8378719d2f5978f2dc5f619f3c856eb70a66b4f5"},"openspec/changes/add-managed-gateway-client/.openspec.yaml":{"bytes":40,"sha256":"dc10040214104474c4e34e5b38359540c882aa7cfb6e7221e5d0614f1dba8fd7"},"openspec/changes/add-managed-gateway-client/design.md":{"bytes":5113,"sha256":"162801004ae85138dc1d03ecb0654506986c26053bfe6fa9e72704edb01de6a2"},"openspec/changes/add-managed-gateway-client/proposal.md":{"bytes":2019,"sha256":"a91469801a7becd8ab01272697394c1d44c367ac2ae0666814b6f6b5706a01cf"},"openspec/changes/add-managed-gateway-client/specs/gateway-recovery/spec.md":{"bytes":2762,"sha256":"af082acc14c97793b8f9231b500e86e8e5c77455ae04a88b0b24fdfa4ed3335e"},"openspec/changes/add-managed-gateway-client/specs/managed-rpc/spec.md":{"bytes":2624,"sha256":"6aa6031b61a113443b8d560e58baae1c041ddc465630b736fa9a23b1fdb4408d"},"openspec/changes/add-managed-gateway-client/specs/typed-event-delivery/spec.md":{"bytes":2613,"sha256":"c5def41f0c9510153b5eb773521778d6121cad2ca4b2bdc733e9cfaa40275552"},"openspec/changes/add-managed-gateway-client/tasks.md":{"bytes":3249,"sha256":"978d020d94027db3801c090dd7e86bbd65b2568c64880950320e57087ee96970"},"openspec/changes/add-optional-runtime-adapters/.openspec.yaml":{"bytes":40,"sha256":"dc10040214104474c4e34e5b38359540c882aa7cfb6e7221e5d0614f1dba8fd7"},"openspec/changes/add-optional-runtime-adapters/design.md":{"bytes":4940,"sha256":"65332fcd6d91ff4ca9e77d53f606caccec2795fae74160bb95d357da482546c9"},"openspec/changes/add-optional-runtime-adapters/proposal.md":{"bytes":2065,"sha256":"a32b0507234b8e78719cb7716dc484212797b3c0259daa76931bf2c7820b4b3e"},"openspec/changes/add-optional-runtime-adapters/specs/cli-typed-results/spec.md":{"bytes":2609,"sha256":"2f9836a84b4b5ae66abae680ef1ec52c35531029b4682a75cc5a3c2e8cc6c67f"},"openspec/changes/add-optional-runtime-adapters/specs/persistent-stdio-adapters/spec.md":{"bytes":2509,"sha256":"ea7d2f8599d97c4ccd8f23ada658f636be62d2bdb715ed82f026a22286a7a3db"},"openspec/changes/add-optional-runtime-adapters/specs/terminal-voice-adapters/spec.md":{"bytes":2620,"sha256":"77fbb21d872b83da1cda418e6a7e1d94b0ea496ac566e6808225f2031a1c39a0"},"openspec/changes/add-optional-runtime-adapters/tasks.md":{"bytes":3318,"sha256":"a86f42485573c87ffa97e3296c3c20cfc128b63db40166a28ee7daf48e1b9f0c"},"openspec/changes/establish-sdk-compatibility-governance/.openspec.yaml":{"bytes":40,"sha256":"dc10040214104474c4e34e5b38359540c882aa7cfb6e7221e5d0614f1dba8fd7"},"openspec/changes/establish-sdk-compatibility-governance/design.md":{"bytes":5448,"sha256":"d3150d2e298788a186c934920cb111bdef4b6801e6c34052741b61895c4dd372"},"openspec/changes/establish-sdk-compatibility-governance/evidence/2026-09-20-precursor-evidence.md":{"bytes":2383,"sha256":"e55309e91a1f190e62b3c29de385509def154a9d534f2963d8f4b69c4fd27db4"},"openspec/changes/establish-sdk-compatibility-governance/evidence/2026-11-18-live-gateway.md":{"bytes":6012,"sha256":"8a39e6c4943c4d5fadfd5ed8000d54510b5ba53dc7ab4ca8a594f0ed142b5b8c"},"openspec/changes/establish-sdk-compatibility-governance/evidence/2026-11-18-locked-gateway-schema.md":{"bytes":2169,"sha256":"6728253fe492a99ebc24eb8c3bc261331317a6324db7c3a168610883ab41048f"},"openspec/changes/establish-sdk-compatibility-governance/evidence/2026-11-19-governance-scenario-audit.md":{"bytes":4171,"sha256":"b3e6fc942311e1918fdef8a1ee032e1cbf2cda3a5e65c974bd9b3da3a96a259c"},"openspec/changes/establish-sdk-compatibility-governance/evidence/capability-inventory.json":{"bytes":2118,"sha256":"c8148e22712176d1991cec37e8f80861996053c693f76a2998a3f7a37fd00822"},"openspec/changes/establish-sdk-compatibility-governance/evidence/fixtures/GatewayCompatibilityFixtureTest.java":{"bytes":3177,"sha256":"7e13d512dccef6b533f5bf04caa1556b97cc7c9a97f8776204196d71c87d38f8"},"openspec/changes/establish-sdk-compatibility-governance/evidence/version-lock.md":{"bytes":1139,"sha256":"7d53174fb9aad9244934bafec50f364ce869f8bcb92445b96aba2c2af64e67f3"},"openspec/changes/establish-sdk-compatibility-governance/proposal.md":{"bytes":1789,"sha256":"88e18f4f66ebccace6da321cb7d0a6b4d788e8e84cc933ab3678a5389b459ed6"},"openspec/changes/establish-sdk-compatibility-governance/specs/sdk-compatibility-governance/spec.md":{"bytes":3830,"sha256":"3d14086cef101a78b83ef953e16cea13b4b341ca9c9552c62596ee9ab85131a1"},"openspec/changes/establish-sdk-compatibility-governance/tasks.md":{"bytes":4229,"sha256":"6e1bf576141cbf53a07cc6648b60a2624ee9fd2ad1f695127ef6f3f8f1c65931"},"openspec/changes/fix-openclaw-protocol-contracts/.openspec.yaml":{"bytes":40,"sha256":"dc10040214104474c4e34e5b38359540c882aa7cfb6e7221e5d0614f1dba8fd7"},"openspec/changes/fix-openclaw-protocol-contracts/design.md":{"bytes":5675,"sha256":"10966f9bc03d3b34138539aeeb4b7ad884b28763cc2290c1f95926b69335dbbb"},"openspec/changes/fix-openclaw-protocol-contracts/proposal.md":{"bytes":2418,"sha256":"11a51837e386f1068004c526673547610a5b84dca8b42fc6d9484da02cc9b270"},"openspec/changes/fix-openclaw-protocol-contracts/specs/gateway-chat-events/spec.md":{"bytes":2622,"sha256":"3564b6061b568c1d30577fc8b228243f21df756321de9e50dd4a763529afb5b9"},"openspec/changes/fix-openclaw-protocol-contracts/specs/gateway-device-auth/spec.md":{"bytes":2806,"sha256":"2a6d8d7d5202495cdace92ffd12a500ee9f0266a172aa4147852e4cf43ee2a4a"},"openspec/changes/fix-openclaw-protocol-contracts/specs/responses-streaming/spec.md":{"bytes":2695,"sha256":"1ca9b80db706c236ca32ae0acd8a02a190fc3644959aa58af4379035923c3b82"},"openspec/changes/fix-openclaw-protocol-contracts/specs/session-history-contract/spec.md":{"bytes":2651,"sha256":"7fcc7baab4e3d9f10dd86adb03e00f78b07a7f011747a744224ca3dadf89168c"},"openspec/changes/fix-openclaw-protocol-contracts/specs/tools-invoke-contract/spec.md":{"bytes":2681,"sha256":"f255110ecff5a9479b780ec81dce1c451d638fe69259196e0ef063c5343a62f1"},"openspec/changes/fix-openclaw-protocol-contracts/tasks.md":{"bytes":4698,"sha256":"fd7a21979c085430e70479494b8f87c88e9746cf277463628a93a92a7932130a"},"openspec/config.yaml":{"bytes":1862,"sha256":"151f5ce61678f2d47d19a1c21168936f7ad5c6f05adec25db6a0e8a70f1f8ba9"},"openspec/specs/.gitkeep":{"bytes":1,"sha256":"01ba4719c80b6fe911b091a7c05124b64eeece964e09c058ef8f9805daca546b"}},"split_report":{"path":"docs/openclaw-integration/validation-report","encoding":"concatenated-base64-of-gzip","original_bytes":127699,"original_sha256":"a689415d7e7c1a28cc50a97179c797adc29080b30f5ec929aa8ed23227a1a598","parts":3},"source_package_note":"The source package hash identifies the original 2026-09-20 bundle. The file inventory also includes subsequent G0 evidence and documentation edits."} +{"scope":"repository documentation; paths relative to repository root; manifest excludes itself","source_package":"openclaw-java-sdk-openspec-draft-2026-09-20.zip","source_package_sha256":"f8eedbb0356b34ecde22584b57fdc9d375fa7409c36d6931b7faca36f4919468","files":{"docs/openclaw-integration/README.md":{"bytes":2882,"sha256":"7af61aea4d0c57c7e1f2c2b83a52126c4ab5b00f6a98962ead41687128789225"},"docs/openclaw-integration/acceptance-plan.md":{"bytes":4591,"sha256":"4875a07fd14cd9771d610d221ab8e666bf2801341b3ccc21302627f06fa2089f"},"docs/openclaw-integration/baseline.json":{"bytes":3221,"sha256":"b5b13dd410d068a5b07b4c27be01658aa94bb626dce9beffc44ebce9565789ab"},"docs/openclaw-integration/coverage-baseline.md":{"bytes":4792,"sha256":"ae4b7783b718a268c697fdd85f1f24800f838cb1063ae90e4324c224efc7f820"},"docs/openclaw-integration/roadmap.md":{"bytes":3880,"sha256":"edb7e1a9717f05e1128eda44fb41fbddcd595cfd2e165ab1ea6d920ca38d5aa6"},"docs/openclaw-integration/source-register.md":{"bytes":5424,"sha256":"992bf67dd8da00cccaeaf4a93ed594b2877d832ed3015b402c3a4eabb0b523f0"},"docs/openclaw-integration/traceability.json.gz":{"bytes":3246,"sha256":"75386731e6f4b685d61a8c582e18edbdc86577e717039716c1c908f8422befcd","decompressed_sha256":"da585354d01fb0f687d764840f7512259de832896db051fe450ac667fd6bf6bb"},"docs/openclaw-integration/traceability.md":{"bytes":13633,"sha256":"2eee7ecf7b4e7db906226082a130d4b80b9bd44be7d4d699aeeb8ada749f3384"},"docs/openclaw-integration/validation-report/README.md":{"bytes":1113,"sha256":"b67e0eb4a969e742b6e30e35883dcac0c3cc15aca0005e6d66377b99995e2932"},"docs/openclaw-integration/validation-report/part-001.b64":{"bytes":2601,"sha256":"9570f3b3818b997c948cb9ee4a5c4885d664cacdfec18e0b3d1e9858ae695a32"},"docs/openclaw-integration/validation-report/part-002.b64":{"bytes":2601,"sha256":"d57ebdd3717bab8648f4f98a70430515d0750ebb38cd72a970e246ddeb049952"},"docs/openclaw-integration/validation-report/part-003.b64":{"bytes":2537,"sha256":"61a7c754d543e645ad6b705add8f183ac0e6605340f0993b9bc5cb4647fef85b"},"docs/openclaw-integration/validation-summary.md":{"bytes":2141,"sha256":"40e31c0cd1ebb639cf1e852b0b0180bda27e28c16dcba9b90e3cb8aabd0f6d10"},"openspec/README.md":{"bytes":611,"sha256":"58a1b2615971f2c7fb56f069006b8559cf5cf1548c01b29c83758c894ec79f20"},"openspec/changes/add-agent-session-approval-control/.openspec.yaml":{"bytes":40,"sha256":"dc10040214104474c4e34e5b38359540c882aa7cfb6e7221e5d0614f1dba8fd7"},"openspec/changes/add-agent-session-approval-control/design.md":{"bytes":4797,"sha256":"95794f1f71841a3d6a5ca61d10bbffaf5be029f8284cf75ac4b6020e4564d3d1"},"openspec/changes/add-agent-session-approval-control/proposal.md":{"bytes":1936,"sha256":"da5665faa52a3e14e756e021e2b9dec56c5f6bb5d73af277e756050a4399c741"},"openspec/changes/add-agent-session-approval-control/specs/agent-lifecycle/spec.md":{"bytes":2664,"sha256":"0b12b0240d1a5d37bcaa8c69604ca53ca67c4a372440262d14ed01b0ffd1a174"},"openspec/changes/add-agent-session-approval-control/specs/approval-control/spec.md":{"bytes":2549,"sha256":"3b979ba5b34b8aa1e1fef3a216e663b5b194b7bce713092d73cc4eed83f0c09b"},"openspec/changes/add-agent-session-approval-control/specs/session-control/spec.md":{"bytes":2543,"sha256":"ecf939250f43f526c1d78a5a2bc2902e5889cf13474a7c80e440e7232d5c24fb"},"openspec/changes/add-agent-session-approval-control/tasks.md":{"bytes":3242,"sha256":"782b9f42a8b58fab966c04920d27a98ea77d588102594219572eae5b17cbad11"},"openspec/changes/add-gateway-operations/.openspec.yaml":{"bytes":40,"sha256":"dc10040214104474c4e34e5b38359540c882aa7cfb6e7221e5d0614f1dba8fd7"},"openspec/changes/add-gateway-operations/design.md":{"bytes":5441,"sha256":"d07d9f9c3c5da092be96a18f0e6c35be53fe06f2eda9f540ef993961be8f247d"},"openspec/changes/add-gateway-operations/proposal.md":{"bytes":2342,"sha256":"c6081bd3692307909e736b7d84ccc34828b4fa5152a118f86dc577fa6ac3d47f"},"openspec/changes/add-gateway-operations/specs/channel-node-control/spec.md":{"bytes":2663,"sha256":"4350182f113da6caff9cd0eb81f2cb5173be374bd2f6665e16a9f93111fb4649"},"openspec/changes/add-gateway-operations/specs/configuration-control/spec.md":{"bytes":2432,"sha256":"cf8839be9d8c9015cfb855422fcdfdfaee02275965f2b3a12b42ce4987b8b3c1"},"openspec/changes/add-gateway-operations/specs/cron-control/spec.md":{"bytes":2453,"sha256":"8f86038254595e09c705b4b680d41aed60b2332f019139e35b5a65c329774274"},"openspec/changes/add-gateway-operations/specs/skill-plugin-lifecycle/spec.md":{"bytes":2551,"sha256":"01ef9d030ab116a21bcca1ff7f8d9ced27968015939cd1bf4c2ed99955f445bd"},"openspec/changes/add-gateway-operations/specs/task-audit-artifacts/spec.md":{"bytes":2597,"sha256":"8d2cb83159ed06b09358d3f950ae20489ea964a864c289168ab2c5a8e57ffadb"},"openspec/changes/add-gateway-operations/specs/tool-model-catalogs/spec.md":{"bytes":2463,"sha256":"a424d99c94d69cb61fa9e3f0efeb9dc8c1702d37c397f789c3363a79066df547"},"openspec/changes/add-gateway-operations/tasks.md":{"bytes":5352,"sha256":"12b19adb7b2a84e0fc263e8a8378719d2f5978f2dc5f619f3c856eb70a66b4f5"},"openspec/changes/add-managed-gateway-client/.openspec.yaml":{"bytes":40,"sha256":"dc10040214104474c4e34e5b38359540c882aa7cfb6e7221e5d0614f1dba8fd7"},"openspec/changes/add-managed-gateway-client/design.md":{"bytes":5113,"sha256":"162801004ae85138dc1d03ecb0654506986c26053bfe6fa9e72704edb01de6a2"},"openspec/changes/add-managed-gateway-client/proposal.md":{"bytes":2019,"sha256":"a91469801a7becd8ab01272697394c1d44c367ac2ae0666814b6f6b5706a01cf"},"openspec/changes/add-managed-gateway-client/specs/gateway-recovery/spec.md":{"bytes":2762,"sha256":"af082acc14c97793b8f9231b500e86e8e5c77455ae04a88b0b24fdfa4ed3335e"},"openspec/changes/add-managed-gateway-client/specs/managed-rpc/spec.md":{"bytes":2624,"sha256":"6aa6031b61a113443b8d560e58baae1c041ddc465630b736fa9a23b1fdb4408d"},"openspec/changes/add-managed-gateway-client/specs/typed-event-delivery/spec.md":{"bytes":2613,"sha256":"c5def41f0c9510153b5eb773521778d6121cad2ca4b2bdc733e9cfaa40275552"},"openspec/changes/add-managed-gateway-client/tasks.md":{"bytes":3249,"sha256":"978d020d94027db3801c090dd7e86bbd65b2568c64880950320e57087ee96970"},"openspec/changes/add-optional-runtime-adapters/.openspec.yaml":{"bytes":40,"sha256":"dc10040214104474c4e34e5b38359540c882aa7cfb6e7221e5d0614f1dba8fd7"},"openspec/changes/add-optional-runtime-adapters/design.md":{"bytes":4940,"sha256":"65332fcd6d91ff4ca9e77d53f606caccec2795fae74160bb95d357da482546c9"},"openspec/changes/add-optional-runtime-adapters/proposal.md":{"bytes":2065,"sha256":"a32b0507234b8e78719cb7716dc484212797b3c0259daa76931bf2c7820b4b3e"},"openspec/changes/add-optional-runtime-adapters/specs/cli-typed-results/spec.md":{"bytes":2609,"sha256":"2f9836a84b4b5ae66abae680ef1ec52c35531029b4682a75cc5a3c2e8cc6c67f"},"openspec/changes/add-optional-runtime-adapters/specs/persistent-stdio-adapters/spec.md":{"bytes":2509,"sha256":"ea7d2f8599d97c4ccd8f23ada658f636be62d2bdb715ed82f026a22286a7a3db"},"openspec/changes/add-optional-runtime-adapters/specs/terminal-voice-adapters/spec.md":{"bytes":2620,"sha256":"77fbb21d872b83da1cda418e6a7e1d94b0ea496ac566e6808225f2031a1c39a0"},"openspec/changes/add-optional-runtime-adapters/tasks.md":{"bytes":3318,"sha256":"a86f42485573c87ffa97e3296c3c20cfc128b63db40166a28ee7daf48e1b9f0c"},"openspec/changes/establish-sdk-compatibility-governance/.openspec.yaml":{"bytes":40,"sha256":"dc10040214104474c4e34e5b38359540c882aa7cfb6e7221e5d0614f1dba8fd7"},"openspec/changes/establish-sdk-compatibility-governance/design.md":{"bytes":5448,"sha256":"d3150d2e298788a186c934920cb111bdef4b6801e6c34052741b61895c4dd372"},"openspec/changes/establish-sdk-compatibility-governance/evidence/2026-09-20-precursor-evidence.md":{"bytes":2383,"sha256":"e55309e91a1f190e62b3c29de385509def154a9d534f2963d8f4b69c4fd27db4"},"openspec/changes/establish-sdk-compatibility-governance/evidence/2026-11-18-live-gateway.md":{"bytes":6012,"sha256":"8a39e6c4943c4d5fadfd5ed8000d54510b5ba53dc7ab4ca8a594f0ed142b5b8c"},"openspec/changes/establish-sdk-compatibility-governance/evidence/2026-11-18-locked-gateway-schema.md":{"bytes":2169,"sha256":"6728253fe492a99ebc24eb8c3bc261331317a6324db7c3a168610883ab41048f"},"openspec/changes/establish-sdk-compatibility-governance/evidence/2026-11-19-governance-scenario-audit.md":{"bytes":6194,"sha256":"cc61c01499981e2980d002acfa778bb9d64c76ce4f7d6bca91817126414761a4"},"openspec/changes/establish-sdk-compatibility-governance/evidence/capability-inventory.json":{"bytes":2118,"sha256":"c8148e22712176d1991cec37e8f80861996053c693f76a2998a3f7a37fd00822"},"openspec/changes/establish-sdk-compatibility-governance/evidence/fixtures/GatewayCompatibilityFixtureTest.java":{"bytes":3177,"sha256":"7e13d512dccef6b533f5bf04caa1556b97cc7c9a97f8776204196d71c87d38f8"},"openspec/changes/establish-sdk-compatibility-governance/evidence/fixtures/RemovedGatewayMethodFixtureTest.java":{"bytes":3990,"sha256":"1009dec97bed823f1aefa6dac4c822ca3d71c909e27f45df1e101024ce5d0024"},"openspec/changes/establish-sdk-compatibility-governance/evidence/version-lock.md":{"bytes":1139,"sha256":"7d53174fb9aad9244934bafec50f364ce869f8bcb92445b96aba2c2af64e67f3"},"openspec/changes/establish-sdk-compatibility-governance/proposal.md":{"bytes":1789,"sha256":"88e18f4f66ebccace6da321cb7d0a6b4d788e8e84cc933ab3678a5389b459ed6"},"openspec/changes/establish-sdk-compatibility-governance/specs/sdk-compatibility-governance/spec.md":{"bytes":3830,"sha256":"3d14086cef101a78b83ef953e16cea13b4b341ca9c9552c62596ee9ab85131a1"},"openspec/changes/establish-sdk-compatibility-governance/tasks.md":{"bytes":4229,"sha256":"6e1bf576141cbf53a07cc6648b60a2624ee9fd2ad1f695127ef6f3f8f1c65931"},"openspec/changes/fix-openclaw-protocol-contracts/.openspec.yaml":{"bytes":40,"sha256":"dc10040214104474c4e34e5b38359540c882aa7cfb6e7221e5d0614f1dba8fd7"},"openspec/changes/fix-openclaw-protocol-contracts/design.md":{"bytes":5675,"sha256":"10966f9bc03d3b34138539aeeb4b7ad884b28763cc2290c1f95926b69335dbbb"},"openspec/changes/fix-openclaw-protocol-contracts/proposal.md":{"bytes":2418,"sha256":"11a51837e386f1068004c526673547610a5b84dca8b42fc6d9484da02cc9b270"},"openspec/changes/fix-openclaw-protocol-contracts/specs/gateway-chat-events/spec.md":{"bytes":2622,"sha256":"3564b6061b568c1d30577fc8b228243f21df756321de9e50dd4a763529afb5b9"},"openspec/changes/fix-openclaw-protocol-contracts/specs/gateway-device-auth/spec.md":{"bytes":2806,"sha256":"2a6d8d7d5202495cdace92ffd12a500ee9f0266a172aa4147852e4cf43ee2a4a"},"openspec/changes/fix-openclaw-protocol-contracts/specs/responses-streaming/spec.md":{"bytes":2695,"sha256":"1ca9b80db706c236ca32ae0acd8a02a190fc3644959aa58af4379035923c3b82"},"openspec/changes/fix-openclaw-protocol-contracts/specs/session-history-contract/spec.md":{"bytes":2651,"sha256":"7fcc7baab4e3d9f10dd86adb03e00f78b07a7f011747a744224ca3dadf89168c"},"openspec/changes/fix-openclaw-protocol-contracts/specs/tools-invoke-contract/spec.md":{"bytes":2681,"sha256":"f255110ecff5a9479b780ec81dce1c451d638fe69259196e0ef063c5343a62f1"},"openspec/changes/fix-openclaw-protocol-contracts/tasks.md":{"bytes":4698,"sha256":"fd7a21979c085430e70479494b8f87c88e9746cf277463628a93a92a7932130a"},"openspec/config.yaml":{"bytes":1862,"sha256":"151f5ce61678f2d47d19a1c21168936f7ad5c6f05adec25db6a0e8a70f1f8ba9"},"openspec/specs/.gitkeep":{"bytes":1,"sha256":"01ba4719c80b6fe911b091a7c05124b64eeece964e09c058ef8f9805daca546b"}},"split_report":{"path":"docs/openclaw-integration/validation-report","encoding":"concatenated-base64-of-gzip","original_bytes":127699,"original_sha256":"a689415d7e7c1a28cc50a97179c797adc29080b30f5ec929aa8ed23227a1a598","parts":3},"source_package_note":"The source package hash identifies the original 2026-09-20 bundle. The file inventory also includes subsequent G0 evidence and documentation edits."} diff --git a/openspec/changes/establish-sdk-compatibility-governance/evidence/2026-11-19-governance-scenario-audit.md b/openspec/changes/establish-sdk-compatibility-governance/evidence/2026-11-19-governance-scenario-audit.md index ae78576..a58a388 100644 --- a/openspec/changes/establish-sdk-compatibility-governance/evidence/2026-11-19-governance-scenario-audit.md +++ b/openspec/changes/establish-sdk-compatibility-governance/evidence/2026-11-19-governance-scenario-audit.md @@ -11,7 +11,7 @@ | GOV-03-S1 文档评审 | [设计稿](../design.md)标明草案,[任务清单](../tasks.md)保留未完成项。 | 维护者记录范围、版本和依赖审批。 | | GOV-03-S2 提前归档 | [归档判定](../design.md#评审与归档判定)列明阻断项,生效规范尚未更新。 | 维护者确认归档拒绝条件和验收记录。 | | GOV-04-S1 版本升级 | 本页对两个精确提交的官方 schema 进行离线比较。候选版握手与会话读取有独立实测。 | 确认候选字段的样本、语义和采用范围。 | -| GOV-04-S2 已移除调用 | schema 中缺少同名定义可作为检查线索。 | 需从运行时方法注册表确认实际移除的调用,并验证 SDK 的明确拒绝及权限边界。 | +| GOV-04-S2 已移除调用 | 锁定版核心注册表声明 `tasks.list`,候选版核心方法清单与连接公告均缺少该项。三条维护线实测候选版返回 `FORBIDDEN`,SDK 保留错误并全程使用原权限。 | 当前 SDK 未封装该调用。显式的能力级不可用结果仍待验收。 | ## 锁定版与候选版 schema 差异 @@ -29,3 +29,20 @@ 候选版使用原始 [上游生成器](https://github.com/openclaw/openclaw/blob/e13cf15ece9bbd969b7362927c315362c90c97ff/scripts/protocol-gen.ts),环境为 Node 24.18.0、tsx 4.23.15 和 typebox 1.4.2。临时检出按同一 tag 补齐 `packages/gateway-protocol`、`packages/normalization-core`、`scripts`、`src/gateway` 和 `src/shared`。其中 `@openclaw/normalization-core` 的构建导出使用同版本 npm 发布包的 `dist/normalization-core`,由临时符号链接提供给检出目录的包导出入口。生成器调用 `node --import ./scripts/tsx.mjs scripts/protocol-gen.ts --out <临时路径>`,执行两次,两个文件逐字节相同。上游检出中的跟踪文件未修改。 本次对照保留原目标版本及评审状态。候选版新增行为应按规格另行验收。 + +## 核心方法移除后的运行验证 + +锁定版 [核心方法表](https://github.com/openclaw/openclaw/blob/0790d9f593ad30c940ed93b5872a8cf6d6f3cf8c/src/gateway/methods/core-descriptors.ts)将只读方法 `tasks.list` 归入 `operator.read`。候选版官方生成器输出的核心方法表无此项。两版真实 Gateway 均关闭插件,分别用 `hello.features.methods` 确认方法公告存在与缺失。 + +[RemovedGatewayMethodFixtureTest.java](fixtures/RemovedGatewayMethodFixtureTest.java)复用相同的临时 Token 类型、协议 4 握手和仅 `operator.read` 的连接权限。通过反射调用 SDK 的内部 RPC 路径,测试分别观察: + +| Gateway | 三条维护线结果 | +|---|---| +| 2026.7.1-2 | 公告中含 `tasks.list`,只读调用返回结果。 | +| 2026.11.5 | 公告中缺少 `tasks.list`,同一调用被拒绝。SDK 保留原方法名、`FORBIDDEN` 和服务端权限错误。 | + +候选版首次探测按假设期待 `INVALID_REQUEST`,三条线均观测到 `FORBIDDEN`。Gateway 日志确认拒绝发生在权限检查。最终断言使用观测到的错误码,在原权限下复验。两版各 3 项通过,零失败、零跳过。每次只发送一次目标调用。测试随后独立发起 `sessions.list`,验证原会话仍可用。测试记录所有发送的方法名,确认序列只含握手、目标调用和后续显式检查。 + +该调用没有公开的 typed SDK 封装。证据覆盖核心公告、当前权限下的拒绝和 SDK 内部错误保留。候选版未新增权限或替代方法调用,能力级不可用语义仍待验收。 + +复核使用 [共用样本的本地启动方法](2026-11-18-live-gateway.md#三条维护线共用的-gateway-测试样本),将测试文件换为本样本,并将 `SDK_PROBE_TARGET` 分别设为 `locked` 或 `candidate`。运行对应 JDK 的 Maven `-Dtest=RemovedGatewayMethodFixtureTest test`。 diff --git a/openspec/changes/establish-sdk-compatibility-governance/evidence/fixtures/RemovedGatewayMethodFixtureTest.java b/openspec/changes/establish-sdk-compatibility-governance/evidence/fixtures/RemovedGatewayMethodFixtureTest.java new file mode 100644 index 0000000..13e35bd --- /dev/null +++ b/openspec/changes/establish-sdk-compatibility-governance/evidence/fixtures/RemovedGatewayMethodFixtureTest.java @@ -0,0 +1,88 @@ +package io.github.easy4j.openclaw.ws; + +import io.github.easy4j.openclaw.OpenClawHttpClientConfig; +import io.github.easy4j.openclaw.exception.OpenClawWsRpcException; +import io.github.easy4j.openclaw.ws.protocol.HelloOk; +import org.junit.jupiter.api.Test; + +import java.lang.reflect.InvocationTargetException; +import java.lang.reflect.Method; +import java.net.URI; +import java.util.ArrayList; +import java.util.Arrays; +import java.util.Collections; +import java.util.List; +import java.util.Map; +import java.util.Objects; +import java.util.concurrent.CopyOnWriteArrayList; +import java.util.regex.Matcher; +import java.util.regex.Pattern; + +import static org.junit.jupiter.api.Assertions.assertEquals; +import static org.junit.jupiter.api.Assertions.assertNotNull; +import static org.junit.jupiter.api.Assertions.assertThrows; +import static org.junit.jupiter.api.Assertions.assertTrue; + +final class RemovedGatewayMethodFixtureTest { + private static final String METHOD = "tasks.list"; + private static final Pattern RPC_METHOD = Pattern.compile("\"method\"\\s*:\\s*\"([^\"]+)\""); + + @Test + void reportsRemovedReadMethodWithoutRetryOrFallback() throws Exception { + String target = Objects.requireNonNull(System.getenv("SDK_PROBE_TARGET")); + assertTrue("locked".equals(target) || "candidate".equals(target)); + boolean advertised = "locked".equals(target); + URI endpoint = URI.create(Objects.requireNonNull(System.getenv("SDK_PROBE_URL"))); + assertEquals("ws", endpoint.getScheme()); + assertEquals("127.0.0.1", endpoint.getHost()); + + OpenClawHttpClientConfig config = new OpenClawHttpClientConfig(); + config.setBaseUrl(endpoint.toString().replaceFirst("^ws:", "http:")); + config.setGatewayClientId("gateway-client"); + config.setGatewayClientMode("backend"); + config.setGatewayAuthToken(Objects.requireNonNull(System.getenv("OPENCLAW_GATEWAY_TOKEN"))); + config.setGatewayScopes(Collections.singletonList("operator.read")); + + try (RecordingClient client = new RecordingClient(config, endpoint)) { + HelloOk hello = client.connectHandshake(); + assertEquals(4, hello.getProtocol()); + assertEquals(advertised, hello.getFeatures().getMethods().contains(METHOD)); + + Method invoke = OpenClawGatewayWsClient.class.getDeclaredMethod("invokeRpc", + String.class, Object.class, Class.class, long.class); + invoke.setAccessible(true); + if (advertised) { + Object result = invoke.invoke(client, METHOD, Collections.emptyMap(), Map.class, 5000L); + assertNotNull(result); + } else { + InvocationTargetException thrown = assertThrows(InvocationTargetException.class, + () -> invoke.invoke(client, METHOD, Collections.emptyMap(), Map.class, 5000L)); + assertTrue(thrown.getCause() instanceof OpenClawWsRpcException); + OpenClawWsRpcException error = (OpenClawWsRpcException) thrown.getCause(); + assertEquals(METHOD, error.getMethod()); + assertEquals("FORBIDDEN", error.getError().getCode()); + assertEquals("missing scope: operator.admin", error.getError().getMessage()); + } + + assertNotNull(client.sessionsList()); + assertEquals(Arrays.asList("connect", METHOD, "sessions.list"), new ArrayList<>(client.methods)); + } + } + + private static final class RecordingClient extends OpenClawGatewayWsClient { + private final List methods = new CopyOnWriteArrayList<>(); + + RecordingClient(OpenClawHttpClientConfig config, URI endpoint) { + super(config, endpoint); + } + + @Override + public void send(String text) { + Matcher match = RPC_METHOD.matcher(text); + if (match.find()) { + methods.add(match.group(1)); + } + super.send(text); + } + } +} From 665cef6085bdbf0795dabfca99153307dbbc9b5c Mon Sep 17 00:00:00 2001 From: loong10k <20489781+loong10k@users.noreply.github.com> Date: Thu, 19 Nov 2026 00:25:59 +0800 Subject: [PATCH 12/22] docs: record Gateway streaming isolation verification --- docs/openclaw-integration/package-manifest.json | 2 +- .../2026-11-19-governance-scenario-audit.md | 2 +- .../evidence/2026-11-19-gateway-chat-isolation.md | 15 +++++++++++++++ .../fix-openclaw-protocol-contracts/tasks.md | 2 +- 4 files changed, 18 insertions(+), 3 deletions(-) create mode 100644 openspec/changes/fix-openclaw-protocol-contracts/evidence/2026-11-19-gateway-chat-isolation.md diff --git a/docs/openclaw-integration/package-manifest.json b/docs/openclaw-integration/package-manifest.json index b41aa49..d26867a 100644 --- a/docs/openclaw-integration/package-manifest.json +++ b/docs/openclaw-integration/package-manifest.json @@ -1 +1 @@ -{"scope":"repository documentation; paths relative to repository root; manifest excludes itself","source_package":"openclaw-java-sdk-openspec-draft-2026-09-20.zip","source_package_sha256":"f8eedbb0356b34ecde22584b57fdc9d375fa7409c36d6931b7faca36f4919468","files":{"docs/openclaw-integration/README.md":{"bytes":2882,"sha256":"7af61aea4d0c57c7e1f2c2b83a52126c4ab5b00f6a98962ead41687128789225"},"docs/openclaw-integration/acceptance-plan.md":{"bytes":4591,"sha256":"4875a07fd14cd9771d610d221ab8e666bf2801341b3ccc21302627f06fa2089f"},"docs/openclaw-integration/baseline.json":{"bytes":3221,"sha256":"b5b13dd410d068a5b07b4c27be01658aa94bb626dce9beffc44ebce9565789ab"},"docs/openclaw-integration/coverage-baseline.md":{"bytes":4792,"sha256":"ae4b7783b718a268c697fdd85f1f24800f838cb1063ae90e4324c224efc7f820"},"docs/openclaw-integration/roadmap.md":{"bytes":3880,"sha256":"edb7e1a9717f05e1128eda44fb41fbddcd595cfd2e165ab1ea6d920ca38d5aa6"},"docs/openclaw-integration/source-register.md":{"bytes":5424,"sha256":"992bf67dd8da00cccaeaf4a93ed594b2877d832ed3015b402c3a4eabb0b523f0"},"docs/openclaw-integration/traceability.json.gz":{"bytes":3246,"sha256":"75386731e6f4b685d61a8c582e18edbdc86577e717039716c1c908f8422befcd","decompressed_sha256":"da585354d01fb0f687d764840f7512259de832896db051fe450ac667fd6bf6bb"},"docs/openclaw-integration/traceability.md":{"bytes":13633,"sha256":"2eee7ecf7b4e7db906226082a130d4b80b9bd44be7d4d699aeeb8ada749f3384"},"docs/openclaw-integration/validation-report/README.md":{"bytes":1113,"sha256":"b67e0eb4a969e742b6e30e35883dcac0c3cc15aca0005e6d66377b99995e2932"},"docs/openclaw-integration/validation-report/part-001.b64":{"bytes":2601,"sha256":"9570f3b3818b997c948cb9ee4a5c4885d664cacdfec18e0b3d1e9858ae695a32"},"docs/openclaw-integration/validation-report/part-002.b64":{"bytes":2601,"sha256":"d57ebdd3717bab8648f4f98a70430515d0750ebb38cd72a970e246ddeb049952"},"docs/openclaw-integration/validation-report/part-003.b64":{"bytes":2537,"sha256":"61a7c754d543e645ad6b705add8f183ac0e6605340f0993b9bc5cb4647fef85b"},"docs/openclaw-integration/validation-summary.md":{"bytes":2141,"sha256":"40e31c0cd1ebb639cf1e852b0b0180bda27e28c16dcba9b90e3cb8aabd0f6d10"},"openspec/README.md":{"bytes":611,"sha256":"58a1b2615971f2c7fb56f069006b8559cf5cf1548c01b29c83758c894ec79f20"},"openspec/changes/add-agent-session-approval-control/.openspec.yaml":{"bytes":40,"sha256":"dc10040214104474c4e34e5b38359540c882aa7cfb6e7221e5d0614f1dba8fd7"},"openspec/changes/add-agent-session-approval-control/design.md":{"bytes":4797,"sha256":"95794f1f71841a3d6a5ca61d10bbffaf5be029f8284cf75ac4b6020e4564d3d1"},"openspec/changes/add-agent-session-approval-control/proposal.md":{"bytes":1936,"sha256":"da5665faa52a3e14e756e021e2b9dec56c5f6bb5d73af277e756050a4399c741"},"openspec/changes/add-agent-session-approval-control/specs/agent-lifecycle/spec.md":{"bytes":2664,"sha256":"0b12b0240d1a5d37bcaa8c69604ca53ca67c4a372440262d14ed01b0ffd1a174"},"openspec/changes/add-agent-session-approval-control/specs/approval-control/spec.md":{"bytes":2549,"sha256":"3b979ba5b34b8aa1e1fef3a216e663b5b194b7bce713092d73cc4eed83f0c09b"},"openspec/changes/add-agent-session-approval-control/specs/session-control/spec.md":{"bytes":2543,"sha256":"ecf939250f43f526c1d78a5a2bc2902e5889cf13474a7c80e440e7232d5c24fb"},"openspec/changes/add-agent-session-approval-control/tasks.md":{"bytes":3242,"sha256":"782b9f42a8b58fab966c04920d27a98ea77d588102594219572eae5b17cbad11"},"openspec/changes/add-gateway-operations/.openspec.yaml":{"bytes":40,"sha256":"dc10040214104474c4e34e5b38359540c882aa7cfb6e7221e5d0614f1dba8fd7"},"openspec/changes/add-gateway-operations/design.md":{"bytes":5441,"sha256":"d07d9f9c3c5da092be96a18f0e6c35be53fe06f2eda9f540ef993961be8f247d"},"openspec/changes/add-gateway-operations/proposal.md":{"bytes":2342,"sha256":"c6081bd3692307909e736b7d84ccc34828b4fa5152a118f86dc577fa6ac3d47f"},"openspec/changes/add-gateway-operations/specs/channel-node-control/spec.md":{"bytes":2663,"sha256":"4350182f113da6caff9cd0eb81f2cb5173be374bd2f6665e16a9f93111fb4649"},"openspec/changes/add-gateway-operations/specs/configuration-control/spec.md":{"bytes":2432,"sha256":"cf8839be9d8c9015cfb855422fcdfdfaee02275965f2b3a12b42ce4987b8b3c1"},"openspec/changes/add-gateway-operations/specs/cron-control/spec.md":{"bytes":2453,"sha256":"8f86038254595e09c705b4b680d41aed60b2332f019139e35b5a65c329774274"},"openspec/changes/add-gateway-operations/specs/skill-plugin-lifecycle/spec.md":{"bytes":2551,"sha256":"01ef9d030ab116a21bcca1ff7f8d9ced27968015939cd1bf4c2ed99955f445bd"},"openspec/changes/add-gateway-operations/specs/task-audit-artifacts/spec.md":{"bytes":2597,"sha256":"8d2cb83159ed06b09358d3f950ae20489ea964a864c289168ab2c5a8e57ffadb"},"openspec/changes/add-gateway-operations/specs/tool-model-catalogs/spec.md":{"bytes":2463,"sha256":"a424d99c94d69cb61fa9e3f0efeb9dc8c1702d37c397f789c3363a79066df547"},"openspec/changes/add-gateway-operations/tasks.md":{"bytes":5352,"sha256":"12b19adb7b2a84e0fc263e8a8378719d2f5978f2dc5f619f3c856eb70a66b4f5"},"openspec/changes/add-managed-gateway-client/.openspec.yaml":{"bytes":40,"sha256":"dc10040214104474c4e34e5b38359540c882aa7cfb6e7221e5d0614f1dba8fd7"},"openspec/changes/add-managed-gateway-client/design.md":{"bytes":5113,"sha256":"162801004ae85138dc1d03ecb0654506986c26053bfe6fa9e72704edb01de6a2"},"openspec/changes/add-managed-gateway-client/proposal.md":{"bytes":2019,"sha256":"a91469801a7becd8ab01272697394c1d44c367ac2ae0666814b6f6b5706a01cf"},"openspec/changes/add-managed-gateway-client/specs/gateway-recovery/spec.md":{"bytes":2762,"sha256":"af082acc14c97793b8f9231b500e86e8e5c77455ae04a88b0b24fdfa4ed3335e"},"openspec/changes/add-managed-gateway-client/specs/managed-rpc/spec.md":{"bytes":2624,"sha256":"6aa6031b61a113443b8d560e58baae1c041ddc465630b736fa9a23b1fdb4408d"},"openspec/changes/add-managed-gateway-client/specs/typed-event-delivery/spec.md":{"bytes":2613,"sha256":"c5def41f0c9510153b5eb773521778d6121cad2ca4b2bdc733e9cfaa40275552"},"openspec/changes/add-managed-gateway-client/tasks.md":{"bytes":3249,"sha256":"978d020d94027db3801c090dd7e86bbd65b2568c64880950320e57087ee96970"},"openspec/changes/add-optional-runtime-adapters/.openspec.yaml":{"bytes":40,"sha256":"dc10040214104474c4e34e5b38359540c882aa7cfb6e7221e5d0614f1dba8fd7"},"openspec/changes/add-optional-runtime-adapters/design.md":{"bytes":4940,"sha256":"65332fcd6d91ff4ca9e77d53f606caccec2795fae74160bb95d357da482546c9"},"openspec/changes/add-optional-runtime-adapters/proposal.md":{"bytes":2065,"sha256":"a32b0507234b8e78719cb7716dc484212797b3c0259daa76931bf2c7820b4b3e"},"openspec/changes/add-optional-runtime-adapters/specs/cli-typed-results/spec.md":{"bytes":2609,"sha256":"2f9836a84b4b5ae66abae680ef1ec52c35531029b4682a75cc5a3c2e8cc6c67f"},"openspec/changes/add-optional-runtime-adapters/specs/persistent-stdio-adapters/spec.md":{"bytes":2509,"sha256":"ea7d2f8599d97c4ccd8f23ada658f636be62d2bdb715ed82f026a22286a7a3db"},"openspec/changes/add-optional-runtime-adapters/specs/terminal-voice-adapters/spec.md":{"bytes":2620,"sha256":"77fbb21d872b83da1cda418e6a7e1d94b0ea496ac566e6808225f2031a1c39a0"},"openspec/changes/add-optional-runtime-adapters/tasks.md":{"bytes":3318,"sha256":"a86f42485573c87ffa97e3296c3c20cfc128b63db40166a28ee7daf48e1b9f0c"},"openspec/changes/establish-sdk-compatibility-governance/.openspec.yaml":{"bytes":40,"sha256":"dc10040214104474c4e34e5b38359540c882aa7cfb6e7221e5d0614f1dba8fd7"},"openspec/changes/establish-sdk-compatibility-governance/design.md":{"bytes":5448,"sha256":"d3150d2e298788a186c934920cb111bdef4b6801e6c34052741b61895c4dd372"},"openspec/changes/establish-sdk-compatibility-governance/evidence/2026-09-20-precursor-evidence.md":{"bytes":2383,"sha256":"e55309e91a1f190e62b3c29de385509def154a9d534f2963d8f4b69c4fd27db4"},"openspec/changes/establish-sdk-compatibility-governance/evidence/2026-11-18-live-gateway.md":{"bytes":6012,"sha256":"8a39e6c4943c4d5fadfd5ed8000d54510b5ba53dc7ab4ca8a594f0ed142b5b8c"},"openspec/changes/establish-sdk-compatibility-governance/evidence/2026-11-18-locked-gateway-schema.md":{"bytes":2169,"sha256":"6728253fe492a99ebc24eb8c3bc261331317a6324db7c3a168610883ab41048f"},"openspec/changes/establish-sdk-compatibility-governance/evidence/2026-11-19-governance-scenario-audit.md":{"bytes":6194,"sha256":"cc61c01499981e2980d002acfa778bb9d64c76ce4f7d6bca91817126414761a4"},"openspec/changes/establish-sdk-compatibility-governance/evidence/capability-inventory.json":{"bytes":2118,"sha256":"c8148e22712176d1991cec37e8f80861996053c693f76a2998a3f7a37fd00822"},"openspec/changes/establish-sdk-compatibility-governance/evidence/fixtures/GatewayCompatibilityFixtureTest.java":{"bytes":3177,"sha256":"7e13d512dccef6b533f5bf04caa1556b97cc7c9a97f8776204196d71c87d38f8"},"openspec/changes/establish-sdk-compatibility-governance/evidence/fixtures/RemovedGatewayMethodFixtureTest.java":{"bytes":3990,"sha256":"1009dec97bed823f1aefa6dac4c822ca3d71c909e27f45df1e101024ce5d0024"},"openspec/changes/establish-sdk-compatibility-governance/evidence/version-lock.md":{"bytes":1139,"sha256":"7d53174fb9aad9244934bafec50f364ce869f8bcb92445b96aba2c2af64e67f3"},"openspec/changes/establish-sdk-compatibility-governance/proposal.md":{"bytes":1789,"sha256":"88e18f4f66ebccace6da321cb7d0a6b4d788e8e84cc933ab3678a5389b459ed6"},"openspec/changes/establish-sdk-compatibility-governance/specs/sdk-compatibility-governance/spec.md":{"bytes":3830,"sha256":"3d14086cef101a78b83ef953e16cea13b4b341ca9c9552c62596ee9ab85131a1"},"openspec/changes/establish-sdk-compatibility-governance/tasks.md":{"bytes":4229,"sha256":"6e1bf576141cbf53a07cc6648b60a2624ee9fd2ad1f695127ef6f3f8f1c65931"},"openspec/changes/fix-openclaw-protocol-contracts/.openspec.yaml":{"bytes":40,"sha256":"dc10040214104474c4e34e5b38359540c882aa7cfb6e7221e5d0614f1dba8fd7"},"openspec/changes/fix-openclaw-protocol-contracts/design.md":{"bytes":5675,"sha256":"10966f9bc03d3b34138539aeeb4b7ad884b28763cc2290c1f95926b69335dbbb"},"openspec/changes/fix-openclaw-protocol-contracts/proposal.md":{"bytes":2418,"sha256":"11a51837e386f1068004c526673547610a5b84dca8b42fc6d9484da02cc9b270"},"openspec/changes/fix-openclaw-protocol-contracts/specs/gateway-chat-events/spec.md":{"bytes":2622,"sha256":"3564b6061b568c1d30577fc8b228243f21df756321de9e50dd4a763529afb5b9"},"openspec/changes/fix-openclaw-protocol-contracts/specs/gateway-device-auth/spec.md":{"bytes":2806,"sha256":"2a6d8d7d5202495cdace92ffd12a500ee9f0266a172aa4147852e4cf43ee2a4a"},"openspec/changes/fix-openclaw-protocol-contracts/specs/responses-streaming/spec.md":{"bytes":2695,"sha256":"1ca9b80db706c236ca32ae0acd8a02a190fc3644959aa58af4379035923c3b82"},"openspec/changes/fix-openclaw-protocol-contracts/specs/session-history-contract/spec.md":{"bytes":2651,"sha256":"7fcc7baab4e3d9f10dd86adb03e00f78b07a7f011747a744224ca3dadf89168c"},"openspec/changes/fix-openclaw-protocol-contracts/specs/tools-invoke-contract/spec.md":{"bytes":2681,"sha256":"f255110ecff5a9479b780ec81dce1c451d638fe69259196e0ef063c5343a62f1"},"openspec/changes/fix-openclaw-protocol-contracts/tasks.md":{"bytes":4698,"sha256":"fd7a21979c085430e70479494b8f87c88e9746cf277463628a93a92a7932130a"},"openspec/config.yaml":{"bytes":1862,"sha256":"151f5ce61678f2d47d19a1c21168936f7ad5c6f05adec25db6a0e8a70f1f8ba9"},"openspec/specs/.gitkeep":{"bytes":1,"sha256":"01ba4719c80b6fe911b091a7c05124b64eeece964e09c058ef8f9805daca546b"}},"split_report":{"path":"docs/openclaw-integration/validation-report","encoding":"concatenated-base64-of-gzip","original_bytes":127699,"original_sha256":"a689415d7e7c1a28cc50a97179c797adc29080b30f5ec929aa8ed23227a1a598","parts":3},"source_package_note":"The source package hash identifies the original 2026-09-20 bundle. The file inventory also includes subsequent G0 evidence and documentation edits."} +{"scope":"repository documentation; paths relative to repository root; manifest excludes itself","source_package":"openclaw-java-sdk-openspec-draft-2026-09-20.zip","source_package_sha256":"f8eedbb0356b34ecde22584b57fdc9d375fa7409c36d6931b7faca36f4919468","files":{"docs/openclaw-integration/README.md":{"bytes":2882,"sha256":"7af61aea4d0c57c7e1f2c2b83a52126c4ab5b00f6a98962ead41687128789225"},"docs/openclaw-integration/acceptance-plan.md":{"bytes":4591,"sha256":"4875a07fd14cd9771d610d221ab8e666bf2801341b3ccc21302627f06fa2089f"},"docs/openclaw-integration/baseline.json":{"bytes":3221,"sha256":"b5b13dd410d068a5b07b4c27be01658aa94bb626dce9beffc44ebce9565789ab"},"docs/openclaw-integration/coverage-baseline.md":{"bytes":4792,"sha256":"ae4b7783b718a268c697fdd85f1f24800f838cb1063ae90e4324c224efc7f820"},"docs/openclaw-integration/roadmap.md":{"bytes":3880,"sha256":"edb7e1a9717f05e1128eda44fb41fbddcd595cfd2e165ab1ea6d920ca38d5aa6"},"docs/openclaw-integration/source-register.md":{"bytes":5424,"sha256":"992bf67dd8da00cccaeaf4a93ed594b2877d832ed3015b402c3a4eabb0b523f0"},"docs/openclaw-integration/traceability.json.gz":{"bytes":3246,"sha256":"75386731e6f4b685d61a8c582e18edbdc86577e717039716c1c908f8422befcd","decompressed_sha256":"da585354d01fb0f687d764840f7512259de832896db051fe450ac667fd6bf6bb"},"docs/openclaw-integration/traceability.md":{"bytes":13633,"sha256":"2eee7ecf7b4e7db906226082a130d4b80b9bd44be7d4d699aeeb8ada749f3384"},"docs/openclaw-integration/validation-report/README.md":{"bytes":1113,"sha256":"b67e0eb4a969e742b6e30e35883dcac0c3cc15aca0005e6d66377b99995e2932"},"docs/openclaw-integration/validation-report/part-001.b64":{"bytes":2601,"sha256":"9570f3b3818b997c948cb9ee4a5c4885d664cacdfec18e0b3d1e9858ae695a32"},"docs/openclaw-integration/validation-report/part-002.b64":{"bytes":2601,"sha256":"d57ebdd3717bab8648f4f98a70430515d0750ebb38cd72a970e246ddeb049952"},"docs/openclaw-integration/validation-report/part-003.b64":{"bytes":2537,"sha256":"61a7c754d543e645ad6b705add8f183ac0e6605340f0993b9bc5cb4647fef85b"},"docs/openclaw-integration/validation-summary.md":{"bytes":2141,"sha256":"40e31c0cd1ebb639cf1e852b0b0180bda27e28c16dcba9b90e3cb8aabd0f6d10"},"openspec/README.md":{"bytes":611,"sha256":"58a1b2615971f2c7fb56f069006b8559cf5cf1548c01b29c83758c894ec79f20"},"openspec/changes/add-agent-session-approval-control/.openspec.yaml":{"bytes":40,"sha256":"dc10040214104474c4e34e5b38359540c882aa7cfb6e7221e5d0614f1dba8fd7"},"openspec/changes/add-agent-session-approval-control/design.md":{"bytes":4797,"sha256":"95794f1f71841a3d6a5ca61d10bbffaf5be029f8284cf75ac4b6020e4564d3d1"},"openspec/changes/add-agent-session-approval-control/proposal.md":{"bytes":1936,"sha256":"da5665faa52a3e14e756e021e2b9dec56c5f6bb5d73af277e756050a4399c741"},"openspec/changes/add-agent-session-approval-control/specs/agent-lifecycle/spec.md":{"bytes":2664,"sha256":"0b12b0240d1a5d37bcaa8c69604ca53ca67c4a372440262d14ed01b0ffd1a174"},"openspec/changes/add-agent-session-approval-control/specs/approval-control/spec.md":{"bytes":2549,"sha256":"3b979ba5b34b8aa1e1fef3a216e663b5b194b7bce713092d73cc4eed83f0c09b"},"openspec/changes/add-agent-session-approval-control/specs/session-control/spec.md":{"bytes":2543,"sha256":"ecf939250f43f526c1d78a5a2bc2902e5889cf13474a7c80e440e7232d5c24fb"},"openspec/changes/add-agent-session-approval-control/tasks.md":{"bytes":3242,"sha256":"782b9f42a8b58fab966c04920d27a98ea77d588102594219572eae5b17cbad11"},"openspec/changes/add-gateway-operations/.openspec.yaml":{"bytes":40,"sha256":"dc10040214104474c4e34e5b38359540c882aa7cfb6e7221e5d0614f1dba8fd7"},"openspec/changes/add-gateway-operations/design.md":{"bytes":5441,"sha256":"d07d9f9c3c5da092be96a18f0e6c35be53fe06f2eda9f540ef993961be8f247d"},"openspec/changes/add-gateway-operations/proposal.md":{"bytes":2342,"sha256":"c6081bd3692307909e736b7d84ccc34828b4fa5152a118f86dc577fa6ac3d47f"},"openspec/changes/add-gateway-operations/specs/channel-node-control/spec.md":{"bytes":2663,"sha256":"4350182f113da6caff9cd0eb81f2cb5173be374bd2f6665e16a9f93111fb4649"},"openspec/changes/add-gateway-operations/specs/configuration-control/spec.md":{"bytes":2432,"sha256":"cf8839be9d8c9015cfb855422fcdfdfaee02275965f2b3a12b42ce4987b8b3c1"},"openspec/changes/add-gateway-operations/specs/cron-control/spec.md":{"bytes":2453,"sha256":"8f86038254595e09c705b4b680d41aed60b2332f019139e35b5a65c329774274"},"openspec/changes/add-gateway-operations/specs/skill-plugin-lifecycle/spec.md":{"bytes":2551,"sha256":"01ef9d030ab116a21bcca1ff7f8d9ced27968015939cd1bf4c2ed99955f445bd"},"openspec/changes/add-gateway-operations/specs/task-audit-artifacts/spec.md":{"bytes":2597,"sha256":"8d2cb83159ed06b09358d3f950ae20489ea964a864c289168ab2c5a8e57ffadb"},"openspec/changes/add-gateway-operations/specs/tool-model-catalogs/spec.md":{"bytes":2463,"sha256":"a424d99c94d69cb61fa9e3f0efeb9dc8c1702d37c397f789c3363a79066df547"},"openspec/changes/add-gateway-operations/tasks.md":{"bytes":5352,"sha256":"12b19adb7b2a84e0fc263e8a8378719d2f5978f2dc5f619f3c856eb70a66b4f5"},"openspec/changes/add-managed-gateway-client/.openspec.yaml":{"bytes":40,"sha256":"dc10040214104474c4e34e5b38359540c882aa7cfb6e7221e5d0614f1dba8fd7"},"openspec/changes/add-managed-gateway-client/design.md":{"bytes":5113,"sha256":"162801004ae85138dc1d03ecb0654506986c26053bfe6fa9e72704edb01de6a2"},"openspec/changes/add-managed-gateway-client/proposal.md":{"bytes":2019,"sha256":"a91469801a7becd8ab01272697394c1d44c367ac2ae0666814b6f6b5706a01cf"},"openspec/changes/add-managed-gateway-client/specs/gateway-recovery/spec.md":{"bytes":2762,"sha256":"af082acc14c97793b8f9231b500e86e8e5c77455ae04a88b0b24fdfa4ed3335e"},"openspec/changes/add-managed-gateway-client/specs/managed-rpc/spec.md":{"bytes":2624,"sha256":"6aa6031b61a113443b8d560e58baae1c041ddc465630b736fa9a23b1fdb4408d"},"openspec/changes/add-managed-gateway-client/specs/typed-event-delivery/spec.md":{"bytes":2613,"sha256":"c5def41f0c9510153b5eb773521778d6121cad2ca4b2bdc733e9cfaa40275552"},"openspec/changes/add-managed-gateway-client/tasks.md":{"bytes":3249,"sha256":"978d020d94027db3801c090dd7e86bbd65b2568c64880950320e57087ee96970"},"openspec/changes/add-optional-runtime-adapters/.openspec.yaml":{"bytes":40,"sha256":"dc10040214104474c4e34e5b38359540c882aa7cfb6e7221e5d0614f1dba8fd7"},"openspec/changes/add-optional-runtime-adapters/design.md":{"bytes":4940,"sha256":"65332fcd6d91ff4ca9e77d53f606caccec2795fae74160bb95d357da482546c9"},"openspec/changes/add-optional-runtime-adapters/proposal.md":{"bytes":2065,"sha256":"a32b0507234b8e78719cb7716dc484212797b3c0259daa76931bf2c7820b4b3e"},"openspec/changes/add-optional-runtime-adapters/specs/cli-typed-results/spec.md":{"bytes":2609,"sha256":"2f9836a84b4b5ae66abae680ef1ec52c35531029b4682a75cc5a3c2e8cc6c67f"},"openspec/changes/add-optional-runtime-adapters/specs/persistent-stdio-adapters/spec.md":{"bytes":2509,"sha256":"ea7d2f8599d97c4ccd8f23ada658f636be62d2bdb715ed82f026a22286a7a3db"},"openspec/changes/add-optional-runtime-adapters/specs/terminal-voice-adapters/spec.md":{"bytes":2620,"sha256":"77fbb21d872b83da1cda418e6a7e1d94b0ea496ac566e6808225f2031a1c39a0"},"openspec/changes/add-optional-runtime-adapters/tasks.md":{"bytes":3318,"sha256":"a86f42485573c87ffa97e3296c3c20cfc128b63db40166a28ee7daf48e1b9f0c"},"openspec/changes/establish-sdk-compatibility-governance/.openspec.yaml":{"bytes":40,"sha256":"dc10040214104474c4e34e5b38359540c882aa7cfb6e7221e5d0614f1dba8fd7"},"openspec/changes/establish-sdk-compatibility-governance/design.md":{"bytes":5448,"sha256":"d3150d2e298788a186c934920cb111bdef4b6801e6c34052741b61895c4dd372"},"openspec/changes/establish-sdk-compatibility-governance/evidence/2026-09-20-precursor-evidence.md":{"bytes":2383,"sha256":"e55309e91a1f190e62b3c29de385509def154a9d534f2963d8f4b69c4fd27db4"},"openspec/changes/establish-sdk-compatibility-governance/evidence/2026-11-18-live-gateway.md":{"bytes":6012,"sha256":"8a39e6c4943c4d5fadfd5ed8000d54510b5ba53dc7ab4ca8a594f0ed142b5b8c"},"openspec/changes/establish-sdk-compatibility-governance/evidence/2026-11-18-locked-gateway-schema.md":{"bytes":2169,"sha256":"6728253fe492a99ebc24eb8c3bc261331317a6324db7c3a168610883ab41048f"},"openspec/changes/establish-sdk-compatibility-governance/evidence/2026-11-19-governance-scenario-audit.md":{"bytes":6323,"sha256":"b9398fe3e22fd27de725abdf4134017087dc761cfa27e5e42a18d795ff527ae3"},"openspec/changes/establish-sdk-compatibility-governance/evidence/capability-inventory.json":{"bytes":2118,"sha256":"c8148e22712176d1991cec37e8f80861996053c693f76a2998a3f7a37fd00822"},"openspec/changes/establish-sdk-compatibility-governance/evidence/fixtures/GatewayCompatibilityFixtureTest.java":{"bytes":3177,"sha256":"7e13d512dccef6b533f5bf04caa1556b97cc7c9a97f8776204196d71c87d38f8"},"openspec/changes/establish-sdk-compatibility-governance/evidence/fixtures/RemovedGatewayMethodFixtureTest.java":{"bytes":3990,"sha256":"1009dec97bed823f1aefa6dac4c822ca3d71c909e27f45df1e101024ce5d0024"},"openspec/changes/establish-sdk-compatibility-governance/evidence/version-lock.md":{"bytes":1139,"sha256":"7d53174fb9aad9244934bafec50f364ce869f8bcb92445b96aba2c2af64e67f3"},"openspec/changes/establish-sdk-compatibility-governance/proposal.md":{"bytes":1789,"sha256":"88e18f4f66ebccace6da321cb7d0a6b4d788e8e84cc933ab3678a5389b459ed6"},"openspec/changes/establish-sdk-compatibility-governance/specs/sdk-compatibility-governance/spec.md":{"bytes":3830,"sha256":"3d14086cef101a78b83ef953e16cea13b4b341ca9c9552c62596ee9ab85131a1"},"openspec/changes/establish-sdk-compatibility-governance/tasks.md":{"bytes":4229,"sha256":"6e1bf576141cbf53a07cc6648b60a2624ee9fd2ad1f695127ef6f3f8f1c65931"},"openspec/changes/fix-openclaw-protocol-contracts/.openspec.yaml":{"bytes":40,"sha256":"dc10040214104474c4e34e5b38359540c882aa7cfb6e7221e5d0614f1dba8fd7"},"openspec/changes/fix-openclaw-protocol-contracts/design.md":{"bytes":5675,"sha256":"10966f9bc03d3b34138539aeeb4b7ad884b28763cc2290c1f95926b69335dbbb"},"openspec/changes/fix-openclaw-protocol-contracts/evidence/2026-11-19-gateway-chat-isolation.md":{"bytes":1601,"sha256":"f0f8ab6a5ff7f66ca48db3cb2fac42691f11a99b04612a9d96842e2d37e71821"},"openspec/changes/fix-openclaw-protocol-contracts/proposal.md":{"bytes":2418,"sha256":"11a51837e386f1068004c526673547610a5b84dca8b42fc6d9484da02cc9b270"},"openspec/changes/fix-openclaw-protocol-contracts/specs/gateway-chat-events/spec.md":{"bytes":2622,"sha256":"3564b6061b568c1d30577fc8b228243f21df756321de9e50dd4a763529afb5b9"},"openspec/changes/fix-openclaw-protocol-contracts/specs/gateway-device-auth/spec.md":{"bytes":2806,"sha256":"2a6d8d7d5202495cdace92ffd12a500ee9f0266a172aa4147852e4cf43ee2a4a"},"openspec/changes/fix-openclaw-protocol-contracts/specs/responses-streaming/spec.md":{"bytes":2695,"sha256":"1ca9b80db706c236ca32ae0acd8a02a190fc3644959aa58af4379035923c3b82"},"openspec/changes/fix-openclaw-protocol-contracts/specs/session-history-contract/spec.md":{"bytes":2651,"sha256":"7fcc7baab4e3d9f10dd86adb03e00f78b07a7f011747a744224ca3dadf89168c"},"openspec/changes/fix-openclaw-protocol-contracts/specs/tools-invoke-contract/spec.md":{"bytes":2681,"sha256":"f255110ecff5a9479b780ec81dce1c451d638fe69259196e0ef063c5343a62f1"},"openspec/changes/fix-openclaw-protocol-contracts/tasks.md":{"bytes":4800,"sha256":"ed10a362a65f6bb47de5469bf2c861b4dc436af152b8910e6909a0a7b30c0698"},"openspec/config.yaml":{"bytes":1862,"sha256":"151f5ce61678f2d47d19a1c21168936f7ad5c6f05adec25db6a0e8a70f1f8ba9"},"openspec/specs/.gitkeep":{"bytes":1,"sha256":"01ba4719c80b6fe911b091a7c05124b64eeece964e09c058ef8f9805daca546b"}},"split_report":{"path":"docs/openclaw-integration/validation-report","encoding":"concatenated-base64-of-gzip","original_bytes":127699,"original_sha256":"a689415d7e7c1a28cc50a97179c797adc29080b30f5ec929aa8ed23227a1a598","parts":3},"source_package_note":"The source package hash identifies the original 2026-09-20 bundle. The file inventory also includes subsequent G0 evidence and documentation edits."} diff --git a/openspec/changes/establish-sdk-compatibility-governance/evidence/2026-11-19-governance-scenario-audit.md b/openspec/changes/establish-sdk-compatibility-governance/evidence/2026-11-19-governance-scenario-audit.md index a58a388..edd9d37 100644 --- a/openspec/changes/establish-sdk-compatibility-governance/evidence/2026-11-19-governance-scenario-audit.md +++ b/openspec/changes/establish-sdk-compatibility-governance/evidence/2026-11-19-governance-scenario-audit.md @@ -6,7 +6,7 @@ |---|---|---| | GOV-01-S1 真实通过可追溯 | [实测记录](2026-11-18-live-gateway.md)绑定三条维护线、两版 Gateway、JDK、Maven、命令和四项测试。 | 核对发布兼容矩阵的实际内容及评审记录。 | | GOV-01-S2 缺少运行证据 | [能力清单](capability-inventory.json)保留静态存在、未封装以及 `liveVerified=false`。维护线 README 仅声明已实测的 WebSocket 范围。 | 发布时逐项核对能力声明。 | -| GOV-02-S1 依赖适配差异 | [共用样本](fixtures/GatewayCompatibilityFixtureTest.java)在 Java 8、17、21 上执行,两版 Gateway 共通过 24 项检查。 | 流重建、终态语义及允许差异清单仍待验收。 | +| GOV-02-S1 依赖适配差异 | [共用样本](fixtures/GatewayCompatibilityFixtureTest.java)在 Java 8、17、21 上执行,两版 Gateway 共通过 24 项检查。 | [真实 Gateway 并发串流](../../fix-openclaw-protocol-contracts/evidence/2026-11-19-gateway-chat-isolation.md)三线均失败。流重建、终态语义及允许差异清单待验收。 | | GOV-02-S2 单分支缺测 | [实测记录](2026-11-18-live-gateway.md)为各维护线分别列出结果,并独立记录默认分支拒绝;其它协议能力仍未标记为通过。 | 用只验证一条线的样本演示发布流程如何阻止全线声明。 | | GOV-03-S1 文档评审 | [设计稿](../design.md)标明草案,[任务清单](../tasks.md)保留未完成项。 | 维护者记录范围、版本和依赖审批。 | | GOV-03-S2 提前归档 | [归档判定](../design.md#评审与归档判定)列明阻断项,生效规范尚未更新。 | 维护者确认归档拒绝条件和验收记录。 | diff --git a/openspec/changes/fix-openclaw-protocol-contracts/evidence/2026-11-19-gateway-chat-isolation.md b/openspec/changes/fix-openclaw-protocol-contracts/evidence/2026-11-19-gateway-chat-isolation.md new file mode 100644 index 0000000..ac4158e --- /dev/null +++ b/openspec/changes/fix-openclaw-protocol-contracts/evidence/2026-11-19-gateway-chat-isolation.md @@ -0,0 +1,15 @@ +# Gateway 聊天串流隔离测试(2026-11-19) + +对应 [CHAT-02-S1 并发隔离](../specs/gateway-chat-events/spec.md#scenario-chat-02-s1-并发隔离),以及 [GOV-02-S1 三条维护线的终态一致性](../../establish-sdk-compatibility-governance/specs/sdk-compatibility-governance/spec.md#scenario-gov-02-s1-依赖适配差异)。 + +实测使用官方 Gateway `2026.7.1-2` 与 `2026.11.5`。每次单独起一个 Gateway,绑定回环地址,使用独立配置、状态目录和临时凭据,关闭插件。模型后端为本机 OpenAI 兼容的确定性 SSE 样本,返回三个固定文本片段和正常终止标记。每次执行记录了 3 次本地模型请求,均为 `/v1/chat/completions`,`stream=true`。 + +| SDK 源码提交 | JDK | 锁定版串行 / 并行 | 候选版串行 / 并行 | +|---|---|---|---| +| `8cfbeb880a6c6ae5390fab0f9fe65e06938907be` | 1.8.0_504 | 通过 / 失败 | 通过 / 失败 | +| `48309d7bc34c4298cdfa1c52db06114b2e7e9f17` | 17.0.21 | 通过 / 失败 | 通过 / 失败 | +| `87c21133aba6364f64ed0edbefab2d821564ede0` | 21.0.13.0.2 | 通过 / 失败 | 通过 / 失败 | + +串行对照的 6 项全部通过。并行对照的 6 项均在最终文本断言处失败,所有执行均无跳过。每组都收到终态事件。结果限制为临时测试环境的合成输入,G1 的运行身份隔离和完整终态验收仍待实施。 + +验证命令为 `mvn -B -ntp -Dtest=GatewayStreamingLiveFixtureTest test`。Java 21 使用 4.0.0-rc-5 Wrapper,Java 8 和 17 使用系统 Maven 3.9.16。每次执行保存了独立的构建结果及模型请求计数。 diff --git a/openspec/changes/fix-openclaw-protocol-contracts/tasks.md b/openspec/changes/fix-openclaw-protocol-contracts/tasks.md index 7bf7a67..bb7fd5d 100644 --- a/openspec/changes/fix-openclaw-protocol-contracts/tasks.md +++ b/openspec/changes/fix-openclaw-protocol-contracts/tasks.md @@ -15,7 +15,7 @@ ## 3. Gateway 聊天事件语义 -- [ ] 3.1 为 `gateway-chat-events` 建立契约样本及回归基线(CHAT-01, CHAT-02, CHAT-03);验收:spec.md 的 6 个场景全部映射到 fixture 或人工验收步骤,已存在问题有最小复现且测试确实执行。 +- [ ] 3.1 为 `gateway-chat-events` 建立契约样本及回归基线(CHAT-01, CHAT-02, CHAT-03);[CHAT-02-S1 并发隔离](evidence/2026-11-19-gateway-chat-isolation.md)已在两版 Gateway 复现。验收:spec.md 的 6 个场景全部映射到 fixture 或人工验收步骤,已存在问题有最小复现且测试确实执行。 - [ ] 3.2 按 design.md 实施 `gateway-chat-events` 并保持旧入口的已声明兼容范围;验收:对应成功、拒绝、边界和生命周期场景通过,错误与权限语义不被吞并。 - [ ] 3.3 在三条适用分支验证 `gateway-chat-events` 并同步示例;验收:记录每条分支 SHA、JDK、构建命令、非零执行测试数和结果,获准差异逐项列出,缺测不得勾选。 From c447d6d1c530411dc4bc06c9b5a9f026aa8a5ea0 Mon Sep 17 00:00:00 2001 From: loong10k <20489781+loong10k@users.noreply.github.com> Date: Thu, 19 Nov 2026 04:02:45 +0800 Subject: [PATCH 13/22] docs: verify isolated Gateway chat run routing on all Java lines --- .../package-manifest.json | 2 +- .../2026-11-19-gateway-chat-isolation.md | 20 +++ .../GatewayStreamingLiveFixtureTest.java | 90 +++++++++++++ .../fixtures/run-gateway-streaming.py | 126 ++++++++++++++++++ .../fixtures/strict-run-id-review.patch | 56 ++++++++ 5 files changed, 293 insertions(+), 1 deletion(-) create mode 100644 openspec/changes/fix-openclaw-protocol-contracts/evidence/fixtures/GatewayStreamingLiveFixtureTest.java create mode 100644 openspec/changes/fix-openclaw-protocol-contracts/evidence/fixtures/run-gateway-streaming.py create mode 100644 openspec/changes/fix-openclaw-protocol-contracts/evidence/fixtures/strict-run-id-review.patch diff --git a/docs/openclaw-integration/package-manifest.json b/docs/openclaw-integration/package-manifest.json index d26867a..378fc7e 100644 --- a/docs/openclaw-integration/package-manifest.json +++ b/docs/openclaw-integration/package-manifest.json @@ -1 +1 @@ -{"scope":"repository documentation; paths relative to repository root; manifest excludes itself","source_package":"openclaw-java-sdk-openspec-draft-2026-09-20.zip","source_package_sha256":"f8eedbb0356b34ecde22584b57fdc9d375fa7409c36d6931b7faca36f4919468","files":{"docs/openclaw-integration/README.md":{"bytes":2882,"sha256":"7af61aea4d0c57c7e1f2c2b83a52126c4ab5b00f6a98962ead41687128789225"},"docs/openclaw-integration/acceptance-plan.md":{"bytes":4591,"sha256":"4875a07fd14cd9771d610d221ab8e666bf2801341b3ccc21302627f06fa2089f"},"docs/openclaw-integration/baseline.json":{"bytes":3221,"sha256":"b5b13dd410d068a5b07b4c27be01658aa94bb626dce9beffc44ebce9565789ab"},"docs/openclaw-integration/coverage-baseline.md":{"bytes":4792,"sha256":"ae4b7783b718a268c697fdd85f1f24800f838cb1063ae90e4324c224efc7f820"},"docs/openclaw-integration/roadmap.md":{"bytes":3880,"sha256":"edb7e1a9717f05e1128eda44fb41fbddcd595cfd2e165ab1ea6d920ca38d5aa6"},"docs/openclaw-integration/source-register.md":{"bytes":5424,"sha256":"992bf67dd8da00cccaeaf4a93ed594b2877d832ed3015b402c3a4eabb0b523f0"},"docs/openclaw-integration/traceability.json.gz":{"bytes":3246,"sha256":"75386731e6f4b685d61a8c582e18edbdc86577e717039716c1c908f8422befcd","decompressed_sha256":"da585354d01fb0f687d764840f7512259de832896db051fe450ac667fd6bf6bb"},"docs/openclaw-integration/traceability.md":{"bytes":13633,"sha256":"2eee7ecf7b4e7db906226082a130d4b80b9bd44be7d4d699aeeb8ada749f3384"},"docs/openclaw-integration/validation-report/README.md":{"bytes":1113,"sha256":"b67e0eb4a969e742b6e30e35883dcac0c3cc15aca0005e6d66377b99995e2932"},"docs/openclaw-integration/validation-report/part-001.b64":{"bytes":2601,"sha256":"9570f3b3818b997c948cb9ee4a5c4885d664cacdfec18e0b3d1e9858ae695a32"},"docs/openclaw-integration/validation-report/part-002.b64":{"bytes":2601,"sha256":"d57ebdd3717bab8648f4f98a70430515d0750ebb38cd72a970e246ddeb049952"},"docs/openclaw-integration/validation-report/part-003.b64":{"bytes":2537,"sha256":"61a7c754d543e645ad6b705add8f183ac0e6605340f0993b9bc5cb4647fef85b"},"docs/openclaw-integration/validation-summary.md":{"bytes":2141,"sha256":"40e31c0cd1ebb639cf1e852b0b0180bda27e28c16dcba9b90e3cb8aabd0f6d10"},"openspec/README.md":{"bytes":611,"sha256":"58a1b2615971f2c7fb56f069006b8559cf5cf1548c01b29c83758c894ec79f20"},"openspec/changes/add-agent-session-approval-control/.openspec.yaml":{"bytes":40,"sha256":"dc10040214104474c4e34e5b38359540c882aa7cfb6e7221e5d0614f1dba8fd7"},"openspec/changes/add-agent-session-approval-control/design.md":{"bytes":4797,"sha256":"95794f1f71841a3d6a5ca61d10bbffaf5be029f8284cf75ac4b6020e4564d3d1"},"openspec/changes/add-agent-session-approval-control/proposal.md":{"bytes":1936,"sha256":"da5665faa52a3e14e756e021e2b9dec56c5f6bb5d73af277e756050a4399c741"},"openspec/changes/add-agent-session-approval-control/specs/agent-lifecycle/spec.md":{"bytes":2664,"sha256":"0b12b0240d1a5d37bcaa8c69604ca53ca67c4a372440262d14ed01b0ffd1a174"},"openspec/changes/add-agent-session-approval-control/specs/approval-control/spec.md":{"bytes":2549,"sha256":"3b979ba5b34b8aa1e1fef3a216e663b5b194b7bce713092d73cc4eed83f0c09b"},"openspec/changes/add-agent-session-approval-control/specs/session-control/spec.md":{"bytes":2543,"sha256":"ecf939250f43f526c1d78a5a2bc2902e5889cf13474a7c80e440e7232d5c24fb"},"openspec/changes/add-agent-session-approval-control/tasks.md":{"bytes":3242,"sha256":"782b9f42a8b58fab966c04920d27a98ea77d588102594219572eae5b17cbad11"},"openspec/changes/add-gateway-operations/.openspec.yaml":{"bytes":40,"sha256":"dc10040214104474c4e34e5b38359540c882aa7cfb6e7221e5d0614f1dba8fd7"},"openspec/changes/add-gateway-operations/design.md":{"bytes":5441,"sha256":"d07d9f9c3c5da092be96a18f0e6c35be53fe06f2eda9f540ef993961be8f247d"},"openspec/changes/add-gateway-operations/proposal.md":{"bytes":2342,"sha256":"c6081bd3692307909e736b7d84ccc34828b4fa5152a118f86dc577fa6ac3d47f"},"openspec/changes/add-gateway-operations/specs/channel-node-control/spec.md":{"bytes":2663,"sha256":"4350182f113da6caff9cd0eb81f2cb5173be374bd2f6665e16a9f93111fb4649"},"openspec/changes/add-gateway-operations/specs/configuration-control/spec.md":{"bytes":2432,"sha256":"cf8839be9d8c9015cfb855422fcdfdfaee02275965f2b3a12b42ce4987b8b3c1"},"openspec/changes/add-gateway-operations/specs/cron-control/spec.md":{"bytes":2453,"sha256":"8f86038254595e09c705b4b680d41aed60b2332f019139e35b5a65c329774274"},"openspec/changes/add-gateway-operations/specs/skill-plugin-lifecycle/spec.md":{"bytes":2551,"sha256":"01ef9d030ab116a21bcca1ff7f8d9ced27968015939cd1bf4c2ed99955f445bd"},"openspec/changes/add-gateway-operations/specs/task-audit-artifacts/spec.md":{"bytes":2597,"sha256":"8d2cb83159ed06b09358d3f950ae20489ea964a864c289168ab2c5a8e57ffadb"},"openspec/changes/add-gateway-operations/specs/tool-model-catalogs/spec.md":{"bytes":2463,"sha256":"a424d99c94d69cb61fa9e3f0efeb9dc8c1702d37c397f789c3363a79066df547"},"openspec/changes/add-gateway-operations/tasks.md":{"bytes":5352,"sha256":"12b19adb7b2a84e0fc263e8a8378719d2f5978f2dc5f619f3c856eb70a66b4f5"},"openspec/changes/add-managed-gateway-client/.openspec.yaml":{"bytes":40,"sha256":"dc10040214104474c4e34e5b38359540c882aa7cfb6e7221e5d0614f1dba8fd7"},"openspec/changes/add-managed-gateway-client/design.md":{"bytes":5113,"sha256":"162801004ae85138dc1d03ecb0654506986c26053bfe6fa9e72704edb01de6a2"},"openspec/changes/add-managed-gateway-client/proposal.md":{"bytes":2019,"sha256":"a91469801a7becd8ab01272697394c1d44c367ac2ae0666814b6f6b5706a01cf"},"openspec/changes/add-managed-gateway-client/specs/gateway-recovery/spec.md":{"bytes":2762,"sha256":"af082acc14c97793b8f9231b500e86e8e5c77455ae04a88b0b24fdfa4ed3335e"},"openspec/changes/add-managed-gateway-client/specs/managed-rpc/spec.md":{"bytes":2624,"sha256":"6aa6031b61a113443b8d560e58baae1c041ddc465630b736fa9a23b1fdb4408d"},"openspec/changes/add-managed-gateway-client/specs/typed-event-delivery/spec.md":{"bytes":2613,"sha256":"c5def41f0c9510153b5eb773521778d6121cad2ca4b2bdc733e9cfaa40275552"},"openspec/changes/add-managed-gateway-client/tasks.md":{"bytes":3249,"sha256":"978d020d94027db3801c090dd7e86bbd65b2568c64880950320e57087ee96970"},"openspec/changes/add-optional-runtime-adapters/.openspec.yaml":{"bytes":40,"sha256":"dc10040214104474c4e34e5b38359540c882aa7cfb6e7221e5d0614f1dba8fd7"},"openspec/changes/add-optional-runtime-adapters/design.md":{"bytes":4940,"sha256":"65332fcd6d91ff4ca9e77d53f606caccec2795fae74160bb95d357da482546c9"},"openspec/changes/add-optional-runtime-adapters/proposal.md":{"bytes":2065,"sha256":"a32b0507234b8e78719cb7716dc484212797b3c0259daa76931bf2c7820b4b3e"},"openspec/changes/add-optional-runtime-adapters/specs/cli-typed-results/spec.md":{"bytes":2609,"sha256":"2f9836a84b4b5ae66abae680ef1ec52c35531029b4682a75cc5a3c2e8cc6c67f"},"openspec/changes/add-optional-runtime-adapters/specs/persistent-stdio-adapters/spec.md":{"bytes":2509,"sha256":"ea7d2f8599d97c4ccd8f23ada658f636be62d2bdb715ed82f026a22286a7a3db"},"openspec/changes/add-optional-runtime-adapters/specs/terminal-voice-adapters/spec.md":{"bytes":2620,"sha256":"77fbb21d872b83da1cda418e6a7e1d94b0ea496ac566e6808225f2031a1c39a0"},"openspec/changes/add-optional-runtime-adapters/tasks.md":{"bytes":3318,"sha256":"a86f42485573c87ffa97e3296c3c20cfc128b63db40166a28ee7daf48e1b9f0c"},"openspec/changes/establish-sdk-compatibility-governance/.openspec.yaml":{"bytes":40,"sha256":"dc10040214104474c4e34e5b38359540c882aa7cfb6e7221e5d0614f1dba8fd7"},"openspec/changes/establish-sdk-compatibility-governance/design.md":{"bytes":5448,"sha256":"d3150d2e298788a186c934920cb111bdef4b6801e6c34052741b61895c4dd372"},"openspec/changes/establish-sdk-compatibility-governance/evidence/2026-09-20-precursor-evidence.md":{"bytes":2383,"sha256":"e55309e91a1f190e62b3c29de385509def154a9d534f2963d8f4b69c4fd27db4"},"openspec/changes/establish-sdk-compatibility-governance/evidence/2026-11-18-live-gateway.md":{"bytes":6012,"sha256":"8a39e6c4943c4d5fadfd5ed8000d54510b5ba53dc7ab4ca8a594f0ed142b5b8c"},"openspec/changes/establish-sdk-compatibility-governance/evidence/2026-11-18-locked-gateway-schema.md":{"bytes":2169,"sha256":"6728253fe492a99ebc24eb8c3bc261331317a6324db7c3a168610883ab41048f"},"openspec/changes/establish-sdk-compatibility-governance/evidence/2026-11-19-governance-scenario-audit.md":{"bytes":6323,"sha256":"b9398fe3e22fd27de725abdf4134017087dc761cfa27e5e42a18d795ff527ae3"},"openspec/changes/establish-sdk-compatibility-governance/evidence/capability-inventory.json":{"bytes":2118,"sha256":"c8148e22712176d1991cec37e8f80861996053c693f76a2998a3f7a37fd00822"},"openspec/changes/establish-sdk-compatibility-governance/evidence/fixtures/GatewayCompatibilityFixtureTest.java":{"bytes":3177,"sha256":"7e13d512dccef6b533f5bf04caa1556b97cc7c9a97f8776204196d71c87d38f8"},"openspec/changes/establish-sdk-compatibility-governance/evidence/fixtures/RemovedGatewayMethodFixtureTest.java":{"bytes":3990,"sha256":"1009dec97bed823f1aefa6dac4c822ca3d71c909e27f45df1e101024ce5d0024"},"openspec/changes/establish-sdk-compatibility-governance/evidence/version-lock.md":{"bytes":1139,"sha256":"7d53174fb9aad9244934bafec50f364ce869f8bcb92445b96aba2c2af64e67f3"},"openspec/changes/establish-sdk-compatibility-governance/proposal.md":{"bytes":1789,"sha256":"88e18f4f66ebccace6da321cb7d0a6b4d788e8e84cc933ab3678a5389b459ed6"},"openspec/changes/establish-sdk-compatibility-governance/specs/sdk-compatibility-governance/spec.md":{"bytes":3830,"sha256":"3d14086cef101a78b83ef953e16cea13b4b341ca9c9552c62596ee9ab85131a1"},"openspec/changes/establish-sdk-compatibility-governance/tasks.md":{"bytes":4229,"sha256":"6e1bf576141cbf53a07cc6648b60a2624ee9fd2ad1f695127ef6f3f8f1c65931"},"openspec/changes/fix-openclaw-protocol-contracts/.openspec.yaml":{"bytes":40,"sha256":"dc10040214104474c4e34e5b38359540c882aa7cfb6e7221e5d0614f1dba8fd7"},"openspec/changes/fix-openclaw-protocol-contracts/design.md":{"bytes":5675,"sha256":"10966f9bc03d3b34138539aeeb4b7ad884b28763cc2290c1f95926b69335dbbb"},"openspec/changes/fix-openclaw-protocol-contracts/evidence/2026-11-19-gateway-chat-isolation.md":{"bytes":1601,"sha256":"f0f8ab6a5ff7f66ca48db3cb2fac42691f11a99b04612a9d96842e2d37e71821"},"openspec/changes/fix-openclaw-protocol-contracts/proposal.md":{"bytes":2418,"sha256":"11a51837e386f1068004c526673547610a5b84dca8b42fc6d9484da02cc9b270"},"openspec/changes/fix-openclaw-protocol-contracts/specs/gateway-chat-events/spec.md":{"bytes":2622,"sha256":"3564b6061b568c1d30577fc8b228243f21df756321de9e50dd4a763529afb5b9"},"openspec/changes/fix-openclaw-protocol-contracts/specs/gateway-device-auth/spec.md":{"bytes":2806,"sha256":"2a6d8d7d5202495cdace92ffd12a500ee9f0266a172aa4147852e4cf43ee2a4a"},"openspec/changes/fix-openclaw-protocol-contracts/specs/responses-streaming/spec.md":{"bytes":2695,"sha256":"1ca9b80db706c236ca32ae0acd8a02a190fc3644959aa58af4379035923c3b82"},"openspec/changes/fix-openclaw-protocol-contracts/specs/session-history-contract/spec.md":{"bytes":2651,"sha256":"7fcc7baab4e3d9f10dd86adb03e00f78b07a7f011747a744224ca3dadf89168c"},"openspec/changes/fix-openclaw-protocol-contracts/specs/tools-invoke-contract/spec.md":{"bytes":2681,"sha256":"f255110ecff5a9479b780ec81dce1c451d638fe69259196e0ef063c5343a62f1"},"openspec/changes/fix-openclaw-protocol-contracts/tasks.md":{"bytes":4800,"sha256":"ed10a362a65f6bb47de5469bf2c861b4dc436af152b8910e6909a0a7b30c0698"},"openspec/config.yaml":{"bytes":1862,"sha256":"151f5ce61678f2d47d19a1c21168936f7ad5c6f05adec25db6a0e8a70f1f8ba9"},"openspec/specs/.gitkeep":{"bytes":1,"sha256":"01ba4719c80b6fe911b091a7c05124b64eeece964e09c058ef8f9805daca546b"}},"split_report":{"path":"docs/openclaw-integration/validation-report","encoding":"concatenated-base64-of-gzip","original_bytes":127699,"original_sha256":"a689415d7e7c1a28cc50a97179c797adc29080b30f5ec929aa8ed23227a1a598","parts":3},"source_package_note":"The source package hash identifies the original 2026-09-20 bundle. The file inventory also includes subsequent G0 evidence and documentation edits."} +{"scope":"repository documentation; paths relative to repository root; manifest excludes itself","source_package":"openclaw-java-sdk-openspec-draft-2026-09-20.zip","source_package_sha256":"f8eedbb0356b34ecde22584b57fdc9d375fa7409c36d6931b7faca36f4919468","files":{"docs/openclaw-integration/README.md":{"bytes":2882,"sha256":"7af61aea4d0c57c7e1f2c2b83a52126c4ab5b00f6a98962ead41687128789225"},"docs/openclaw-integration/acceptance-plan.md":{"bytes":4591,"sha256":"4875a07fd14cd9771d610d221ab8e666bf2801341b3ccc21302627f06fa2089f"},"docs/openclaw-integration/baseline.json":{"bytes":3221,"sha256":"b5b13dd410d068a5b07b4c27be01658aa94bb626dce9beffc44ebce9565789ab"},"docs/openclaw-integration/coverage-baseline.md":{"bytes":4792,"sha256":"ae4b7783b718a268c697fdd85f1f24800f838cb1063ae90e4324c224efc7f820"},"docs/openclaw-integration/roadmap.md":{"bytes":3880,"sha256":"edb7e1a9717f05e1128eda44fb41fbddcd595cfd2e165ab1ea6d920ca38d5aa6"},"docs/openclaw-integration/source-register.md":{"bytes":5424,"sha256":"992bf67dd8da00cccaeaf4a93ed594b2877d832ed3015b402c3a4eabb0b523f0"},"docs/openclaw-integration/traceability.json.gz":{"bytes":3246,"sha256":"75386731e6f4b685d61a8c582e18edbdc86577e717039716c1c908f8422befcd","decompressed_sha256":"da585354d01fb0f687d764840f7512259de832896db051fe450ac667fd6bf6bb"},"docs/openclaw-integration/traceability.md":{"bytes":13633,"sha256":"2eee7ecf7b4e7db906226082a130d4b80b9bd44be7d4d699aeeb8ada749f3384"},"docs/openclaw-integration/validation-report/README.md":{"bytes":1113,"sha256":"b67e0eb4a969e742b6e30e35883dcac0c3cc15aca0005e6d66377b99995e2932"},"docs/openclaw-integration/validation-report/part-001.b64":{"bytes":2601,"sha256":"9570f3b3818b997c948cb9ee4a5c4885d664cacdfec18e0b3d1e9858ae695a32"},"docs/openclaw-integration/validation-report/part-002.b64":{"bytes":2601,"sha256":"d57ebdd3717bab8648f4f98a70430515d0750ebb38cd72a970e246ddeb049952"},"docs/openclaw-integration/validation-report/part-003.b64":{"bytes":2537,"sha256":"61a7c754d543e645ad6b705add8f183ac0e6605340f0993b9bc5cb4647fef85b"},"docs/openclaw-integration/validation-summary.md":{"bytes":2141,"sha256":"40e31c0cd1ebb639cf1e852b0b0180bda27e28c16dcba9b90e3cb8aabd0f6d10"},"openspec/README.md":{"bytes":611,"sha256":"58a1b2615971f2c7fb56f069006b8559cf5cf1548c01b29c83758c894ec79f20"},"openspec/changes/add-agent-session-approval-control/.openspec.yaml":{"bytes":40,"sha256":"dc10040214104474c4e34e5b38359540c882aa7cfb6e7221e5d0614f1dba8fd7"},"openspec/changes/add-agent-session-approval-control/design.md":{"bytes":4797,"sha256":"95794f1f71841a3d6a5ca61d10bbffaf5be029f8284cf75ac4b6020e4564d3d1"},"openspec/changes/add-agent-session-approval-control/proposal.md":{"bytes":1936,"sha256":"da5665faa52a3e14e756e021e2b9dec56c5f6bb5d73af277e756050a4399c741"},"openspec/changes/add-agent-session-approval-control/specs/agent-lifecycle/spec.md":{"bytes":2664,"sha256":"0b12b0240d1a5d37bcaa8c69604ca53ca67c4a372440262d14ed01b0ffd1a174"},"openspec/changes/add-agent-session-approval-control/specs/approval-control/spec.md":{"bytes":2549,"sha256":"3b979ba5b34b8aa1e1fef3a216e663b5b194b7bce713092d73cc4eed83f0c09b"},"openspec/changes/add-agent-session-approval-control/specs/session-control/spec.md":{"bytes":2543,"sha256":"ecf939250f43f526c1d78a5a2bc2902e5889cf13474a7c80e440e7232d5c24fb"},"openspec/changes/add-agent-session-approval-control/tasks.md":{"bytes":3242,"sha256":"782b9f42a8b58fab966c04920d27a98ea77d588102594219572eae5b17cbad11"},"openspec/changes/add-gateway-operations/.openspec.yaml":{"bytes":40,"sha256":"dc10040214104474c4e34e5b38359540c882aa7cfb6e7221e5d0614f1dba8fd7"},"openspec/changes/add-gateway-operations/design.md":{"bytes":5441,"sha256":"d07d9f9c3c5da092be96a18f0e6c35be53fe06f2eda9f540ef993961be8f247d"},"openspec/changes/add-gateway-operations/proposal.md":{"bytes":2342,"sha256":"c6081bd3692307909e736b7d84ccc34828b4fa5152a118f86dc577fa6ac3d47f"},"openspec/changes/add-gateway-operations/specs/channel-node-control/spec.md":{"bytes":2663,"sha256":"4350182f113da6caff9cd0eb81f2cb5173be374bd2f6665e16a9f93111fb4649"},"openspec/changes/add-gateway-operations/specs/configuration-control/spec.md":{"bytes":2432,"sha256":"cf8839be9d8c9015cfb855422fcdfdfaee02275965f2b3a12b42ce4987b8b3c1"},"openspec/changes/add-gateway-operations/specs/cron-control/spec.md":{"bytes":2453,"sha256":"8f86038254595e09c705b4b680d41aed60b2332f019139e35b5a65c329774274"},"openspec/changes/add-gateway-operations/specs/skill-plugin-lifecycle/spec.md":{"bytes":2551,"sha256":"01ef9d030ab116a21bcca1ff7f8d9ced27968015939cd1bf4c2ed99955f445bd"},"openspec/changes/add-gateway-operations/specs/task-audit-artifacts/spec.md":{"bytes":2597,"sha256":"8d2cb83159ed06b09358d3f950ae20489ea964a864c289168ab2c5a8e57ffadb"},"openspec/changes/add-gateway-operations/specs/tool-model-catalogs/spec.md":{"bytes":2463,"sha256":"a424d99c94d69cb61fa9e3f0efeb9dc8c1702d37c397f789c3363a79066df547"},"openspec/changes/add-gateway-operations/tasks.md":{"bytes":5352,"sha256":"12b19adb7b2a84e0fc263e8a8378719d2f5978f2dc5f619f3c856eb70a66b4f5"},"openspec/changes/add-managed-gateway-client/.openspec.yaml":{"bytes":40,"sha256":"dc10040214104474c4e34e5b38359540c882aa7cfb6e7221e5d0614f1dba8fd7"},"openspec/changes/add-managed-gateway-client/design.md":{"bytes":5113,"sha256":"162801004ae85138dc1d03ecb0654506986c26053bfe6fa9e72704edb01de6a2"},"openspec/changes/add-managed-gateway-client/proposal.md":{"bytes":2019,"sha256":"a91469801a7becd8ab01272697394c1d44c367ac2ae0666814b6f6b5706a01cf"},"openspec/changes/add-managed-gateway-client/specs/gateway-recovery/spec.md":{"bytes":2762,"sha256":"af082acc14c97793b8f9231b500e86e8e5c77455ae04a88b0b24fdfa4ed3335e"},"openspec/changes/add-managed-gateway-client/specs/managed-rpc/spec.md":{"bytes":2624,"sha256":"6aa6031b61a113443b8d560e58baae1c041ddc465630b736fa9a23b1fdb4408d"},"openspec/changes/add-managed-gateway-client/specs/typed-event-delivery/spec.md":{"bytes":2613,"sha256":"c5def41f0c9510153b5eb773521778d6121cad2ca4b2bdc733e9cfaa40275552"},"openspec/changes/add-managed-gateway-client/tasks.md":{"bytes":3249,"sha256":"978d020d94027db3801c090dd7e86bbd65b2568c64880950320e57087ee96970"},"openspec/changes/add-optional-runtime-adapters/.openspec.yaml":{"bytes":40,"sha256":"dc10040214104474c4e34e5b38359540c882aa7cfb6e7221e5d0614f1dba8fd7"},"openspec/changes/add-optional-runtime-adapters/design.md":{"bytes":4940,"sha256":"65332fcd6d91ff4ca9e77d53f606caccec2795fae74160bb95d357da482546c9"},"openspec/changes/add-optional-runtime-adapters/proposal.md":{"bytes":2065,"sha256":"a32b0507234b8e78719cb7716dc484212797b3c0259daa76931bf2c7820b4b3e"},"openspec/changes/add-optional-runtime-adapters/specs/cli-typed-results/spec.md":{"bytes":2609,"sha256":"2f9836a84b4b5ae66abae680ef1ec52c35531029b4682a75cc5a3c2e8cc6c67f"},"openspec/changes/add-optional-runtime-adapters/specs/persistent-stdio-adapters/spec.md":{"bytes":2509,"sha256":"ea7d2f8599d97c4ccd8f23ada658f636be62d2bdb715ed82f026a22286a7a3db"},"openspec/changes/add-optional-runtime-adapters/specs/terminal-voice-adapters/spec.md":{"bytes":2620,"sha256":"77fbb21d872b83da1cda418e6a7e1d94b0ea496ac566e6808225f2031a1c39a0"},"openspec/changes/add-optional-runtime-adapters/tasks.md":{"bytes":3318,"sha256":"a86f42485573c87ffa97e3296c3c20cfc128b63db40166a28ee7daf48e1b9f0c"},"openspec/changes/establish-sdk-compatibility-governance/.openspec.yaml":{"bytes":40,"sha256":"dc10040214104474c4e34e5b38359540c882aa7cfb6e7221e5d0614f1dba8fd7"},"openspec/changes/establish-sdk-compatibility-governance/design.md":{"bytes":5448,"sha256":"d3150d2e298788a186c934920cb111bdef4b6801e6c34052741b61895c4dd372"},"openspec/changes/establish-sdk-compatibility-governance/evidence/2026-09-20-precursor-evidence.md":{"bytes":2383,"sha256":"e55309e91a1f190e62b3c29de385509def154a9d534f2963d8f4b69c4fd27db4"},"openspec/changes/establish-sdk-compatibility-governance/evidence/2026-11-18-live-gateway.md":{"bytes":6012,"sha256":"8a39e6c4943c4d5fadfd5ed8000d54510b5ba53dc7ab4ca8a594f0ed142b5b8c"},"openspec/changes/establish-sdk-compatibility-governance/evidence/2026-11-18-locked-gateway-schema.md":{"bytes":2169,"sha256":"6728253fe492a99ebc24eb8c3bc261331317a6324db7c3a168610883ab41048f"},"openspec/changes/establish-sdk-compatibility-governance/evidence/2026-11-19-governance-scenario-audit.md":{"bytes":6323,"sha256":"b9398fe3e22fd27de725abdf4134017087dc761cfa27e5e42a18d795ff527ae3"},"openspec/changes/establish-sdk-compatibility-governance/evidence/capability-inventory.json":{"bytes":2118,"sha256":"c8148e22712176d1991cec37e8f80861996053c693f76a2998a3f7a37fd00822"},"openspec/changes/establish-sdk-compatibility-governance/evidence/fixtures/GatewayCompatibilityFixtureTest.java":{"bytes":3177,"sha256":"7e13d512dccef6b533f5bf04caa1556b97cc7c9a97f8776204196d71c87d38f8"},"openspec/changes/establish-sdk-compatibility-governance/evidence/fixtures/RemovedGatewayMethodFixtureTest.java":{"bytes":3990,"sha256":"1009dec97bed823f1aefa6dac4c822ca3d71c909e27f45df1e101024ce5d0024"},"openspec/changes/establish-sdk-compatibility-governance/evidence/version-lock.md":{"bytes":1139,"sha256":"7d53174fb9aad9244934bafec50f364ce869f8bcb92445b96aba2c2af64e67f3"},"openspec/changes/establish-sdk-compatibility-governance/proposal.md":{"bytes":1789,"sha256":"88e18f4f66ebccace6da321cb7d0a6b4d788e8e84cc933ab3678a5389b459ed6"},"openspec/changes/establish-sdk-compatibility-governance/specs/sdk-compatibility-governance/spec.md":{"bytes":3830,"sha256":"3d14086cef101a78b83ef953e16cea13b4b341ca9c9552c62596ee9ab85131a1"},"openspec/changes/establish-sdk-compatibility-governance/tasks.md":{"bytes":4229,"sha256":"6e1bf576141cbf53a07cc6648b60a2624ee9fd2ad1f695127ef6f3f8f1c65931"},"openspec/changes/fix-openclaw-protocol-contracts/.openspec.yaml":{"bytes":40,"sha256":"dc10040214104474c4e34e5b38359540c882aa7cfb6e7221e5d0614f1dba8fd7"},"openspec/changes/fix-openclaw-protocol-contracts/design.md":{"bytes":5675,"sha256":"10966f9bc03d3b34138539aeeb4b7ad884b28763cc2290c1f95926b69335dbbb"},"openspec/changes/fix-openclaw-protocol-contracts/evidence/2026-11-19-gateway-chat-isolation.md":{"bytes":4335,"sha256":"5ba24fe93389c94273c60efb5aed1da80d91f414b5cd8307d76febe544a8176d"},"openspec/changes/fix-openclaw-protocol-contracts/evidence/fixtures/GatewayStreamingLiveFixtureTest.java":{"bytes":4205,"sha256":"fd66cbff962ac8f87b699fb05c4e3f643411dc799d1a1b9cd65d815a1fb35912"},"openspec/changes/fix-openclaw-protocol-contracts/evidence/fixtures/run-gateway-streaming.py":{"bytes":6109,"sha256":"56f353850bfb3c3bc11ce49f025c1aae960882251d2d24f9714f5eec7b957298"},"openspec/changes/fix-openclaw-protocol-contracts/evidence/fixtures/strict-run-id-review.patch":{"bytes":3239,"sha256":"b86234e6d5b2354ca037d183dfb9f34ee15fe00300fb23da21eac1b20ab60191"},"openspec/changes/fix-openclaw-protocol-contracts/proposal.md":{"bytes":2418,"sha256":"11a51837e386f1068004c526673547610a5b84dca8b42fc6d9484da02cc9b270"},"openspec/changes/fix-openclaw-protocol-contracts/specs/gateway-chat-events/spec.md":{"bytes":2622,"sha256":"3564b6061b568c1d30577fc8b228243f21df756321de9e50dd4a763529afb5b9"},"openspec/changes/fix-openclaw-protocol-contracts/specs/gateway-device-auth/spec.md":{"bytes":2806,"sha256":"2a6d8d7d5202495cdace92ffd12a500ee9f0266a172aa4147852e4cf43ee2a4a"},"openspec/changes/fix-openclaw-protocol-contracts/specs/responses-streaming/spec.md":{"bytes":2695,"sha256":"1ca9b80db706c236ca32ae0acd8a02a190fc3644959aa58af4379035923c3b82"},"openspec/changes/fix-openclaw-protocol-contracts/specs/session-history-contract/spec.md":{"bytes":2651,"sha256":"7fcc7baab4e3d9f10dd86adb03e00f78b07a7f011747a744224ca3dadf89168c"},"openspec/changes/fix-openclaw-protocol-contracts/specs/tools-invoke-contract/spec.md":{"bytes":2681,"sha256":"f255110ecff5a9479b780ec81dce1c451d638fe69259196e0ef063c5343a62f1"},"openspec/changes/fix-openclaw-protocol-contracts/tasks.md":{"bytes":4800,"sha256":"ed10a362a65f6bb47de5469bf2c861b4dc436af152b8910e6909a0a7b30c0698"},"openspec/config.yaml":{"bytes":1862,"sha256":"151f5ce61678f2d47d19a1c21168936f7ad5c6f05adec25db6a0e8a70f1f8ba9"},"openspec/specs/.gitkeep":{"bytes":1,"sha256":"01ba4719c80b6fe911b091a7c05124b64eeece964e09c058ef8f9805daca546b"}},"split_report":{"path":"docs/openclaw-integration/validation-report","encoding":"concatenated-base64-of-gzip","original_bytes":127699,"original_sha256":"a689415d7e7c1a28cc50a97179c797adc29080b30f5ec929aa8ed23227a1a598","parts":3},"source_package_note":"The source package hash identifies the original 2026-09-20 bundle. The file inventory also includes subsequent G0 evidence and documentation edits."} diff --git a/openspec/changes/fix-openclaw-protocol-contracts/evidence/2026-11-19-gateway-chat-isolation.md b/openspec/changes/fix-openclaw-protocol-contracts/evidence/2026-11-19-gateway-chat-isolation.md index ac4158e..7d0e3fc 100644 --- a/openspec/changes/fix-openclaw-protocol-contracts/evidence/2026-11-19-gateway-chat-isolation.md +++ b/openspec/changes/fix-openclaw-protocol-contracts/evidence/2026-11-19-gateway-chat-isolation.md @@ -13,3 +13,23 @@ 串行对照的 6 项全部通过。并行对照的 6 项均在最终文本断言处失败,所有执行均无跳过。每组都收到终态事件。结果限制为临时测试环境的合成输入,G1 的运行身份隔离和完整终态验收仍待实施。 验证命令为 `mvn -B -ntp -Dtest=GatewayStreamingLiveFixtureTest test`。Java 21 使用 4.0.0-rc-5 Wrapper,Java 8 和 17 使用系统 Maven 3.9.16。每次执行保存了独立的构建结果及模型请求计数。 + +## 候选补丁复核 + +旧实现会把未登记的运行事件送给任意活动流。候选补丁只将字符串 `runId` 精确匹配到本客户端登记的流。Gateway 在 RPC 应答里返回替代运行 ID 时仍可正常接收增量和终态。未知和缺失 ID 的帧仍能由通用事件监听器观察。 + +| 测试基线 | JDK | WebSocket 回归 | Gateway 2026.7.1-2 并发 | Gateway 2026.11.5 并发 | Maven `clean verify` | +| --- | --- | --- | --- | --- | --- | +| `3dc46a0e58200b086efc59029a43aa5c136bf61b` | 8 | 6 通过 | 旧代码失败,补丁通过 | 补丁通过 | 152 通过,3 跳过 | +| `9293a8cd2580435ec076b076d98c7965b77f0049` | 17 | 6 通过 | 旧代码失败,补丁通过 | 补丁通过 | 152 通过,3 跳过 | +| `34b003b5c2c2158e536d3290ef67de7932ab78ef` | 21 | 6 通过 | 旧代码失败,补丁通过 | 补丁通过 | 152 通过,3 跳过 | + +三条线的 WebSocket 夹具在修改生产源码前均复现 `foreignunidentifiedmodern-event`,应用补丁后均返回 `modern-event`。真实 Gateway 夹具用本地模型端点将三个请求同步到同一起点。每个 SDK 都通过通用事件监听器确认在当前流结束前有其他运行的增量,再断言自己的增量、终态文本和完成次数。两轮补丁验证均记录 3 个本地模型请求。六项真实测试全部通过,无跳过。旧代码在锁定版 Gateway 的同一夹具上把三条流的文本拼到一起。常规构建的 3 个跳过项来自需要主动启用的 `openclaw.realIntegration` 夹具。 + +### 复现 + +1. 在临时目录分别准备上表三个源码提交,命名为 `sdk-1`、`sdk-2`、`sdk-3`。应用[候选补丁](fixtures/strict-run-id-review.patch)后运行 `mvn -Dtest=OpenClawGatewayWsClientIntegrationTest test`。Java 21 使用 `./mvnw`。 +2. 运行真实联调前,将 [GatewayStreamingLiveFixtureTest.java](fixtures/GatewayStreamingLiveFixtureTest.java) 复制到三个源码树各自的 `src/test/java/io/github/easy4j/openclaw/ws/`。在临时目录按版本准备官方 npm 构建,分别放在 `locked-runtime/node_modules/openclaw` 和 `runtime/node_modules/openclaw`。macOS 启动器使用 `java_home` 选取 JDK,从同级 `m2-1`、`m2-2`、`m2-3` 的已预热 Maven 缓存离线构建。 +3. 将[启动器](fixtures/run-gateway-streaming.py)复制到同一临时目录,分别运行 `python3 run-gateway-streaming.py locked` 和 `python3 run-gateway-streaming.py candidate`。它会启动独立的回环 Gateway 和本地模型夹具,并写出三条版本线的测试日志。 + +候选补丁和测试证据供评审,SDK 分支仍指向表中的基线。该结果覆盖 CHAT-02-S1。版本确认、人审、会话代际和其他 G1 场景沿用现有验收项。 diff --git a/openspec/changes/fix-openclaw-protocol-contracts/evidence/fixtures/GatewayStreamingLiveFixtureTest.java b/openspec/changes/fix-openclaw-protocol-contracts/evidence/fixtures/GatewayStreamingLiveFixtureTest.java new file mode 100644 index 0000000..4b08db6 --- /dev/null +++ b/openspec/changes/fix-openclaw-protocol-contracts/evidence/fixtures/GatewayStreamingLiveFixtureTest.java @@ -0,0 +1,90 @@ +package io.github.easy4j.openclaw.ws; + +import io.github.easy4j.openclaw.OpenClawHttpClientConfig; +import io.github.easy4j.openclaw.ws.protocol.ChatSendParams; +import io.github.easy4j.openclaw.ws.protocol.EventFrame; +import org.junit.jupiter.api.Test; + +import java.net.URI; +import java.util.Arrays; +import java.util.Map; +import java.util.Objects; +import java.util.UUID; +import java.util.concurrent.CountDownLatch; +import java.util.concurrent.TimeUnit; +import java.util.concurrent.atomic.AtomicInteger; +import java.util.concurrent.atomic.AtomicReference; + +import static org.junit.jupiter.api.Assertions.assertEquals; +import static org.junit.jupiter.api.Assertions.assertNull; +import static org.junit.jupiter.api.Assertions.assertTrue; + +final class GatewayStreamingLiveFixtureTest { + @Test + void reconstructsStreamingTextAndCompletesOnce() throws Exception { + URI endpoint = URI.create(Objects.requireNonNull(System.getenv("SDK_PROBE_URL"))); + assertEquals("ws", endpoint.getScheme()); + assertEquals("127.0.0.1", endpoint.getHost()); + OpenClawHttpClientConfig config = new OpenClawHttpClientConfig(); + config.setBaseUrl(endpoint.toString().replaceFirst("^ws:", "http:")); + config.setGatewayAuthToken(Objects.requireNonNull(System.getenv("OPENCLAW_GATEWAY_TOKEN"))); + config.setGatewayClientId("gateway-client"); + config.setGatewayClientMode("backend"); + config.setGatewayScopes(Arrays.asList("operator.read", "operator.write")); + + CountDownLatch terminal = new CountDownLatch(1); + StringBuffer deltas = new StringBuffer(); + AtomicInteger fragments = new AtomicInteger(); + AtomicInteger foreignDeltasBeforeTerminal = new AtomicInteger(); + AtomicInteger completions = new AtomicInteger(); + AtomicReference finalText = new AtomicReference<>(); + AtomicReference error = new AtomicReference<>(); + String turn = "sdk-stream-fixture-" + UUID.randomUUID(); + try (OpenClawGatewayWsClient client = new OpenClawGatewayWsClient(config, endpoint)) { + client.addListener(new OpenClawWsListener() { + @Override + public void onEvent(EventFrame frame) { + if ("chat".equals(frame.getEvent()) && frame.getPayload() instanceof Map) { + Map payload = (Map) frame.getPayload(); + if ("delta".equals(payload.get("state"))) { + if (!turn.equals(payload.get("runId")) && terminal.getCount() > 0) { + foreignDeltasBeforeTerminal.incrementAndGet(); + } + } + } + } + }); + assertEquals(4, client.connectHandshake().getProtocol()); + client.chatSend(ChatSendParams.builder() + .sessionKey("agent:main:" + turn) + .message("Return the local fixture response.") + .idempotencyKey(turn) + .timeoutMs(30000) + .build(), new ChatStreamHandler() { + @Override public void onDelta(String text) { + deltas.append(text); + fragments.incrementAndGet(); + } + + @Override public void onComplete(String text) { + finalText.set(text); + completions.incrementAndGet(); + terminal.countDown(); + } + + @Override public void onError(String message) { + error.set(message); + terminal.countDown(); + } + }); + + assertTrue(terminal.await(45, TimeUnit.SECONDS), "Gateway chat did not reach a terminal state"); + assertNull(error.get(), error.get()); + assertEquals("Gateway fixture ✓", finalText.get()); + assertEquals("Gateway fixture ✓", deltas.toString()); + assertTrue(fragments.get() >= 1); + assertTrue(foreignDeltasBeforeTerminal.get() > 0, "Expected an overlapping foreign run"); + assertEquals(1, completions.get()); + } + } +} diff --git a/openspec/changes/fix-openclaw-protocol-contracts/evidence/fixtures/run-gateway-streaming.py b/openspec/changes/fix-openclaw-protocol-contracts/evidence/fixtures/run-gateway-streaming.py new file mode 100644 index 0000000..8ac5989 --- /dev/null +++ b/openspec/changes/fix-openclaw-protocol-contracts/evidence/fixtures/run-gateway-streaming.py @@ -0,0 +1,126 @@ +import concurrent.futures +import re +import json +from http.server import BaseHTTPRequestHandler, ThreadingHTTPServer +import threading +import os +from pathlib import Path +import secrets +import signal +import socket +import subprocess +import time +from urllib.request import urlopen + +root = Path(__file__).resolve().parent + +class LocalModel(BaseHTTPRequestHandler): + def log_message(self, format, *args): + pass + + def do_POST(self): + payload = json.loads(self.rfile.read(int(self.headers["Content-Length"]))) + with (root / (prefix + "provider.log")).open("a") as report: + report.write(json.dumps({"path": self.path, "model": payload.get("model"), + "stream": payload.get("stream")}) + "\n") + if self.path != "/v1/chat/completions" or payload.get("model") != "local-fixture" or not payload.get("stream"): + self.send_error(400) + return + streams_started.wait(timeout=25) + self.send_response(200) + self.send_header("Content-Type", "text/event-stream; charset=utf-8") + self.end_headers() + def chunk(delta, finish=None): + message = {"id": "local-run", "object": "chat.completion.chunk", "created": 1, + "model": "local-fixture", "choices": [{"index": 0, "delta": delta, "finish_reason": finish}]} + self.wfile.write(("data: " + json.dumps(message, ensure_ascii=False) + "\n\n").encode()) + self.wfile.flush() + chunk({"role": "assistant"}) + for content in ("Gateway ", "fixture ", "✓"): + chunk({"content": content}) + time.sleep(0.25) + chunk({}, "stop") + self.wfile.write(b"data: [DONE]\n\n") + self.wfile.flush() + +provider = ThreadingHTTPServer(("127.0.0.1", 0), LocalModel) +threading.Thread(target=provider.serve_forever, daemon=True).start() +version = os.sys.argv[1] +workers = int(os.environ.get("FIXTURE_WORKERS", "3")) +streams_started = threading.Barrier(workers) +prefix = f"chat-provenance-{workers}-{version}-" +runtime = root / (("locked-" if version == "locked" else "") + "runtime/node_modules/openclaw") +token = secrets.token_hex(24) +with socket.socket() as reservation: + reservation.bind(("127.0.0.1", 0)) + port = reservation.getsockname()[1] +http = f"http://127.0.0.1:{port}" +config = root / (prefix + "gateway.json") +config.write_text(json.dumps({ + "gateway": {"mode": "local", "bind": "loopback", "port": port, + "auth": {"mode": "token", "allowTailscale": False}, "controlUi": {"enabled": False}}, + "agents": {"defaults": {"workspace": str(root / (prefix + "workspace")), "skipBootstrap": True, + "model": {"primary": "localprobe/local-fixture", "fallbacks": []}}}, + "models": {"mode": "replace", "providers": { + "localprobe": {"baseUrl": f"http://127.0.0.1:{provider.server_port}/v1", + "apiKey": "local-fixture-key", "api": "openai-completions", + "models": [{"id": "local-fixture", "name": "Local fixture", "reasoning": False, + "input": ["text"], "contextWindow": 32768, "maxTokens": 1024}]} + }}, + "discovery": {"mdns": {"mode": "off"}}, + "cron": {"enabled": False}, + "plugins": {"enabled": False} +})) +isolated_home = root / (prefix + "gateway-home") +isolated_home.mkdir(exist_ok=True) +gateway_env = {"PATH": os.environ["PATH"], "HOME": str(isolated_home), + "OPENCLAW_CONFIG_PATH": str(config), "OPENCLAW_STATE_DIR": str(root / (prefix + "gateway-state")), + "OPENCLAW_GATEWAY_TOKEN": token, "OPENCLAW_DISABLE_BONJOUR": "1"} +def verify(args): + line, jdk, test = args + java = subprocess.check_output(["/usr/libexec/java_home", "-v", jdk], text=True).strip() + env = dict(os.environ, JAVA_HOME=java, + PATH=java + "/bin:" + os.environ["PATH"], SDK_PROBE_URL=f"ws://127.0.0.1:{port}", + OPENCLAW_GATEWAY_TOKEN=token) + with (root / f"{prefix}tests-{line}.log").open("w") as log: + mvn = ["bash", "./mvnw"] if line == 3 else ["mvn"] + subprocess.run(mvn + ["-version"], env=env, cwd=root / f"sdk-{line}", stdout=log, stderr=log) + build = subprocess.run(mvn + ["-B", "-ntp", "-o", + "-Dmaven.repo.local=" + str(root / f"m2-{line}"), + "-Dmaven.repo.local.tail=" + str(Path.home() / ".m2/repository"), + "-Dtest=" + test, "test"], + env=env, cwd=root / f"sdk-{line}", stdout=log, stderr=log, timeout=120) + return line, build.returncode + +with (root / (prefix + "gateway-live.log")).open("w") as log: + proc = subprocess.Popen(["node", str(runtime / "openclaw.mjs"), "gateway", "run"], env=gateway_env, + stdout=log, stderr=log, start_new_session=True) + try: + for attempt in range(100): + if proc.poll() is not None: + raise RuntimeError(f"Gateway exited with {proc.returncode}") + try: + with urlopen(http + "/readyz", timeout=1) as response: + reply = json.load(response) + (root / (prefix + "ready.json")).write_text(json.dumps(reply)) + print("Gateway ready", flush=True) + break + except OSError: + time.sleep(0.25) + else: + raise RuntimeError("Gateway did not become ready") + runs = [] + with concurrent.futures.ThreadPoolExecutor(max_workers=workers) as executor: + for line, result in executor.map(verify, tuple((line, jdk, "GatewayStreamingLiveFixtureTest") for line, jdk in ((1, "1.8"), (2, "17"), (3, "21")))): + print(f"SDK line {line}: Maven exit {result}", flush=True) + runs.append(result) + if any(runs): + raise SystemExit(1) + finally: + if proc.poll() is None: + os.killpg(proc.pid, signal.SIGTERM) + try: + proc.wait(timeout=15) + except subprocess.TimeoutExpired: + os.killpg(proc.pid, signal.SIGKILL) + proc.wait() diff --git a/openspec/changes/fix-openclaw-protocol-contracts/evidence/fixtures/strict-run-id-review.patch b/openspec/changes/fix-openclaw-protocol-contracts/evidence/fixtures/strict-run-id-review.patch new file mode 100644 index 0000000..cd9b535 --- /dev/null +++ b/openspec/changes/fix-openclaw-protocol-contracts/evidence/fixtures/strict-run-id-review.patch @@ -0,0 +1,56 @@ +diff --git a/src/main/java/io/github/easy4j/openclaw/ws/OpenClawGatewayWsClient.java b/src/main/java/io/github/easy4j/openclaw/ws/OpenClawGatewayWsClient.java +index 4bb2ccb..589c433 100644 +--- a/src/main/java/io/github/easy4j/openclaw/ws/OpenClawGatewayWsClient.java ++++ b/src/main/java/io/github/easy4j/openclaw/ws/OpenClawGatewayWsClient.java +@@ -987,29 +987,21 @@ public class OpenClawGatewayWsClient extends WebSocketClient implements AutoClos + } + } + +- String runId = (String) p.get("runId"); ++ Object runId = p.get("runId"); ++ if (!(runId instanceof String)) { ++ return; ++ } ++ ChatStreamCollector collector = activeChatStreams.get(runId); ++ if (Objects.isNull(collector)) { ++ return; ++ } ++ + String state = p.get("state") instanceof String ? (String) p.get("state") : null; + boolean done = Boolean.TRUE.equals(p.get("done")) || "final".equals(state); + String delta = p.get("deltaText") instanceof String + ? (String) p.get("deltaText") + : (String) p.get("delta"); + +- // 匹配到活跃的 chat stream +- ChatStreamCollector collector = null; +- if (runId != null) { +- collector = activeChatStreams.get(runId); +- } +- // 旧版 Gateway 可能省略 runId;仅作兼容性回退,优先最近登记的活动流。 +- if (collector == null && !activeChatStreams.isEmpty()) { +- collector = activeChatStreams.values().stream() +- .reduce((first, second) -> second) +- .orElse(null); +- } +- +- if (collector == null) { +- return; +- } +- + if (delta != null) { + collector.textBuilder.append(delta); + collector.handler.onDelta(delta); +diff --git a/src/test/java/io/github/easy4j/openclaw/ws/OpenClawGatewayWsClientIntegrationTest.java b/src/test/java/io/github/easy4j/openclaw/ws/OpenClawGatewayWsClientIntegrationTest.java +index 6030e14..03ab45b 100644 +--- a/src/test/java/io/github/easy4j/openclaw/ws/OpenClawGatewayWsClientIntegrationTest.java ++++ b/src/test/java/io/github/easy4j/openclaw/ws/OpenClawGatewayWsClientIntegrationTest.java +@@ -308,6 +308,8 @@ class OpenClawGatewayWsClientIntegrationTest { + chatSendRequest.set(request); + if ("modern-event".equals(request.path("params").path("message").asText())) { + conn.send(response(id, true, Collections.singletonMap("runId", "gateway-run-1"))); ++ conn.send("{\"type\":\"event\",\"event\":\"chat\",\"payload\":{\"runId\":\"another-run\",\"state\":\"delta\",\"deltaText\":\"foreign\"}}"); ++ conn.send("{\"type\":\"event\",\"event\":\"chat\",\"payload\":{\"state\":\"delta\",\"deltaText\":\"unidentified\"}}"); + conn.send("{\"type\":\"event\",\"event\":\"chat\",\"payload\":{\"runId\":\"gateway-run-1\",\"state\":\"delta\",\"deltaText\":\"modern-event\",\"seq\":1}}"); + conn.send("{\"type\":\"event\",\"event\":\"chat\",\"payload\":{\"runId\":\"gateway-run-1\",\"state\":\"final\",\"seq\":2}}"); + return; From 2f71b5cbfcf8442daf6205b86a19093251ddf747 Mon Sep 17 00:00:00 2001 From: loong10k <20489781+loong10k@users.noreply.github.com> Date: Thu, 19 Nov 2026 05:30:03 +0800 Subject: [PATCH 14/22] Review OpenClaw Tools Invoke on two live Gateway versions --- .../2026-11-19-tools-invoke-version-review.md | 19 +++ .../evidence/fixtures/review-tools-invoke.py | 118 ++++++++++++++++++ .../fix-openclaw-protocol-contracts/tasks.md | 2 + 3 files changed, 139 insertions(+) create mode 100644 openspec/changes/fix-openclaw-protocol-contracts/evidence/2026-11-19-tools-invoke-version-review.md create mode 100644 openspec/changes/fix-openclaw-protocol-contracts/evidence/fixtures/review-tools-invoke.py diff --git a/openspec/changes/fix-openclaw-protocol-contracts/evidence/2026-11-19-tools-invoke-version-review.md b/openspec/changes/fix-openclaw-protocol-contracts/evidence/2026-11-19-tools-invoke-version-review.md new file mode 100644 index 0000000..319bbb0 --- /dev/null +++ b/openspec/changes/fix-openclaw-protocol-contracts/evidence/2026-11-19-tools-invoke-version-review.md @@ -0,0 +1,19 @@ +# Tools Invoke 的 2026.11.5 范围评审 + +用已锁定的 OpenClaw 2026.7.1-2 和候选 2026.11.5 各启动一个临时回环 Gateway。Node 版本为 24.18.0。Gateway 使用临时共享令牌、隔离配置和状态目录,禁用插件、计划任务及 mDNS。唯一执行的工具是只读 `sessions_list`,使用空测试工作区。 + +| 场景 | 2026.7.1-2 | 2026.11.5 | +| --- | --- | --- | +| 缺少令牌 | HTTP 401,`unauthorized` | 相同 | +| 错误令牌 | HTTP 401,`unauthorized` | 相同 | +| 有效共享令牌,读取会话列表 | HTTP 200,`ok=true`,有 `result` | 相同 | +| 有效令牌并声明 `operator.read`,读取会话列表 | HTTP 200,`ok=true`,有 `result` | 相同 | +| `dryRun=true` 并带固定的 `idempotencyKey`,读取会话列表 | HTTP 200,`ok=true`,有 `result` | 相同 | +| 不存在的工具名 | HTTP 404,`ok=false`,`not_found` | 相同 | +| `agentId` 与显式 `sessionKey` 不一致 | HTTP 400,`ok=false`,`invalid_request` | 相同 | + +上述两轮共 14 个实际 HTTP 交换。共享令牌的授权范围和 `dryRun` 的保留字段语义以锁定版上游契约为准。只读工具在窄请求头下成功,无法单独证明实际授予了哪些 scopes。带 `dryRun` 的请求仍返回工具结果,候选版官方文档明确该字段当前被忽略。一次带键请求仅证明请求可接受,幂等执行语义仍待独立验证。 [候选版 Tools Invoke 文档](https://github.com/openclaw/openclaw/blob/v2026.11.5/docs/gateway/tools-invoke-http-api.md) + +当前 SDK 的 Java 8 `3dc46a0`、Java 17 `9293a8c`、Java 21 `34b003b` 的 `ToolInvokeRequest` 均缺少 `agentId` 和 `idempotencyKey` 字段,`dryRun` 的 Javadoc 仍描述为仅校验。建议候选范围保留 TOOL-01 的显式关联、身份冲突及 TOOL-02 的文档修正和宿主策略。真实代理身份认证、SDK 对工具业务失败的结构化处理、生产网关及实施审批仍待后续验收。 + +复跑入口为 [review-tools-invoke.py](fixtures/review-tools-invoke.py)。给定两个已安装的 OpenClaw 包目录,依次传入 2026.7.1-2 和 2026.11.5;脚本检查包版本、启动和退出两个隔离 Gateway,并断言各场景的 HTTP 状态及响应字段。 diff --git a/openspec/changes/fix-openclaw-protocol-contracts/evidence/fixtures/review-tools-invoke.py b/openspec/changes/fix-openclaw-protocol-contracts/evidence/fixtures/review-tools-invoke.py new file mode 100644 index 0000000..7c950a8 --- /dev/null +++ b/openspec/changes/fix-openclaw-protocol-contracts/evidence/fixtures/review-tools-invoke.py @@ -0,0 +1,118 @@ +"""Compare the two locked OpenClaw releases on disposable loopback Gateways.""" +import json +import os +import secrets +import socket +import subprocess +import sys +import tempfile +import time +from pathlib import Path +from urllib.error import HTTPError +from urllib.request import ProxyHandler, Request, build_opener + +SAFE_REQUEST = {"tool": "sessions_list", "args": {"limit": 1}, "sessionKey": "main"} +URL_OPENER = build_opener(ProxyHandler({})) + + +def request(base, body, token=None, scopes=None): + headers = {"Content-Type": "application/json"} + if token is not None: + headers["Authorization"] = "Bearer " + token + if scopes is not None: + headers["x-openclaw-scopes"] = scopes + call = Request(base + "/tools/invoke", json.dumps(body).encode(), headers) + try: + with URL_OPENER.open(call, timeout=8) as response: + return response.status, json.load(response) + except HTTPError as failure: + with failure: + return failure.code, json.load(failure) + + +def release(runtime, version): + assert json.loads((runtime / "package.json").read_bytes())["version"] == version + with tempfile.TemporaryDirectory(prefix="openclaw-tools-review-") as tmp: + state = Path(tmp) + token = secrets.token_hex(24) + with socket.socket() as selected: + selected.bind(("127.0.0.1", 0)) + port = selected.getsockname()[1] + base = f"http://127.0.0.1:{port}" + config = state / "config.json" + config.write_text(json.dumps({ + "gateway": {"mode": "local", "bind": "loopback", "port": port, + "auth": {"mode": "token", "allowTailscale": False}, + "controlUi": {"enabled": False}}, + "agents": {"defaults": {"workspace": str(state / "workspace"), "skipBootstrap": True}}, + "discovery": {"mdns": {"mode": "off"}}, + "cron": {"enabled": False}, "plugins": {"enabled": False}, + })) + env = { + "PATH": os.environ["PATH"], "OPENCLAW_HOME": tmp, + "OPENCLAW_CONFIG_PATH": str(config), "OPENCLAW_STATE_DIR": str(state / "state"), + "OPENCLAW_GATEWAY_TOKEN": token, "OPENCLAW_DISABLE_BONJOUR": "1", + } + log_path = state / "gateway.log" + with log_path.open("w") as log: + process = subprocess.Popen(["node", str(runtime / "openclaw.mjs"), "gateway", "run"], + cwd=state, env=env, stdout=log, stderr=log) + try: + for _ in range(100): + if process.poll() is not None: + raise RuntimeError("Gateway exited: " + log_path.read_text()[-2000:]) + try: + with URL_OPENER.open(base + "/readyz", timeout=1): + break + except OSError: + time.sleep(0.25) + else: + raise RuntimeError("Gateway did not start") + results = {} + for label, payload, bearer, scopes in ( + ("absent-token", SAFE_REQUEST, None, None), + ("incorrect-token", SAFE_REQUEST, "fixture-invalid", None), + ("shared-token", SAFE_REQUEST, token, None), + ("read-header", SAFE_REQUEST, token, "operator.read"), + ("dry-run", {**SAFE_REQUEST, "dryRun": True, "idempotencyKey": "fixture-v1"}, token, None), + ("missing-tool", {**SAFE_REQUEST, "tool": "scope_review_missing_tool"}, token, None), + ("mismatched-agent", {**SAFE_REQUEST, "sessionKey": "agent:main:main", + "agentId": "fixture-other"}, token, None)): + code, body = request(base, payload, bearer, scopes) + error = body.get("error") + results[label] = {"status": code, "ok": body.get("ok"), + "errorType": error.get("type") if isinstance(error, dict) else None, + "hasResult": "result" in body} + return results + finally: + process.terminate() + try: + process.wait(timeout=10) + except subprocess.TimeoutExpired: + process.kill() + process.wait() + + +def main(): + if len(sys.argv) != 3: + raise SystemExit("usage: review-tools-invoke.py LOCKED_PACKAGE_DIR CANDIDATE_PACKAGE_DIR") + expected = { + "absent-token": (401, None, "unauthorized", False), + "incorrect-token": (401, None, "unauthorized", False), + "shared-token": (200, True, None, True), + "read-header": (200, True, None, True), + "dry-run": (200, True, None, True), + "missing-tool": (404, False, "not_found", False), + "mismatched-agent": (400, False, "invalid_request", False), + } + for path, version in zip(sys.argv[1:], ("2026.7.1-2", "2026.11.5"), strict=True): + actual = release(Path(path).resolve(), version) + for label, result in actual.items(): + observed = tuple(result[key] for key in ("status", "ok", "errorType", "hasResult")) + if observed != expected[label]: + raise AssertionError(f"{version} {label}: expected {expected[label]}, observed {observed}") + print(version, json.dumps(actual, sort_keys=True), flush=True) + + +if __name__ == "__main__": + main() diff --git a/openspec/changes/fix-openclaw-protocol-contracts/tasks.md b/openspec/changes/fix-openclaw-protocol-contracts/tasks.md index bb7fd5d..d195028 100644 --- a/openspec/changes/fix-openclaw-protocol-contracts/tasks.md +++ b/openspec/changes/fix-openclaw-protocol-contracts/tasks.md @@ -42,3 +42,5 @@ - [ ] 7.1 对本变更执行真实 Gateway 场景;验收:固定服务端版本、认证方式、运行命令与脱敏证据,成功和拒绝均有真实观察,SDK 本地 fixture 通过不能替代。 - [ ] 7.2 完成适用的资源、故障与兼容检查;验收:1000 次受控请求/订阅周期后活动注册归零,自有线程在测试预算内终止,共享资源仍可使用;治理类变更检查无运行资源触点并记录不适用理由。 - [ ] 7.3 更新覆盖矩阵并执行规范校验;验收:官方 OpenSpec validate 输出通过、无未解释的三分支差异、所有必需任务有证据且人审允许归档,随后才更新生效 specs。 + +Tools Invoke 的锁定版与 2026.11.5 两轮真实回环验证及 Java DTO 差距见 [版本评审](evidence/2026-11-19-tools-invoke-version-review.md)。 From 48c95fc7bda3ac8d9ae447659a5586d9bba7fe34 Mon Sep 17 00:00:00 2001 From: loong10k <20489781+loong10k@users.noreply.github.com> Date: Thu, 19 Nov 2026 05:34:22 +0800 Subject: [PATCH 15/22] Review session history cursors on both OpenClaw Gateway versions --- .../2026-11-19-chat-history-version-review.md | 14 ++ .../evidence/fixtures/review-chat-history.mjs | 174 ++++++++++++++++++ .../fix-openclaw-protocol-contracts/tasks.md | 2 + 3 files changed, 190 insertions(+) create mode 100644 openspec/changes/fix-openclaw-protocol-contracts/evidence/2026-11-19-chat-history-version-review.md create mode 100644 openspec/changes/fix-openclaw-protocol-contracts/evidence/fixtures/review-chat-history.mjs diff --git a/openspec/changes/fix-openclaw-protocol-contracts/evidence/2026-11-19-chat-history-version-review.md b/openspec/changes/fix-openclaw-protocol-contracts/evidence/2026-11-19-chat-history-version-review.md new file mode 100644 index 0000000..6828ec5 --- /dev/null +++ b/openspec/changes/fix-openclaw-protocol-contracts/evidence/2026-11-19-chat-history-version-review.md @@ -0,0 +1,14 @@ +# 会话历史的 2026.11.5 范围评审 + +使用 OpenClaw 2026.7.1-2、2026.11.5 和 Node 24.18.0。两个 Gateway 分别使用临时工作区、状态与令牌,只监听回环地址。用 Gateway RPC 创建测试会话并写入四条合成消息,再以两条消息为一页读取。测试只使用临时会话,未启动模型推理。 [候选版本会话控制契约](https://github.com/openclaw/openclaw/blob/v2026.11.5/docs/gateway/protocol/rpc-session-control.md) + +| 场景 | 2026.7.1-2 | 2026.11.5 | +| --- | --- | --- | +| 读取最新两条 | 返回物理会话 ID、两个消息 ID 及已知空闲状态。响应无游标和 `nextOffset`。 | 同样返回两条和空闲状态,另有 `hasMore=true`、`nextOffset`、`olderCursor` 和 `deltaCursor`。 | +| 继续分页 | 提交 `cursor` 返回 `INVALID_REQUEST`。 | 使用 `olderCursor` 得到前两条且没有更旧游标。使用该页的 `newerCursor` 回到原消息 ID,末页没有更新游标。 | +| 使用 `deltaCursor` | 请求字段不受支持。 | 无变化时得到 `kind=delta` 和空消息列表。增加一条后,续读只返回新增消息。 | +| 重置临时会话,续读旧游标 | 本轮覆盖旧版对游标字段的拒绝。 | 旧游标得到 `kind=reset`。重新读取普通尾页得到一条 `system` 重置记录,原消息 ID 不再出现在尾页。 | + +三条 Java 发行线 `3dc46a0`、`9293a8c`、`34b003b` 的 `ChatHistoryParams` 已有 `offset`,缺少 `cursor`。三线的 `ChatHistoryResult` 均缺少 `kind`、续页游标及 `sessionInfo`。本轮建议保留 HIST-01 的服务端续页信息、HIST-02 的状态缺省语义和 HIST-03 的重置后重读。受过滤消息和空页影响的续页、并发刷新与迟到事件仍需独立验证。SDK 实施以及目标版本审批保持待完成。 + +用 Node 24.18.0 运行 [review-chat-history.mjs](fixtures/review-chat-history.mjs),位置参数依次为已安装的 2026.7.1-2 和 2026.11.5 包目录。脚本验证版本、启动各自 Gateway,经 WebSocket 实际执行请求并断言响应,最后清理临时状态。 diff --git a/openspec/changes/fix-openclaw-protocol-contracts/evidence/fixtures/review-chat-history.mjs b/openspec/changes/fix-openclaw-protocol-contracts/evidence/fixtures/review-chat-history.mjs new file mode 100644 index 0000000..2e9dc8d --- /dev/null +++ b/openspec/changes/fix-openclaw-protocol-contracts/evidence/fixtures/review-chat-history.mjs @@ -0,0 +1,174 @@ +import assert from 'node:assert/strict'; +import { spawn } from 'node:child_process'; +import { randomBytes } from 'node:crypto'; +import { once } from 'node:events'; +import { mkdtemp, readFile, rm, writeFile } from 'node:fs/promises'; +import net from 'node:net'; +import { tmpdir } from 'node:os'; +import path from 'node:path'; +import { setTimeout as delay } from 'node:timers/promises'; + +const sessionKey = 'agent:main:history-review'; +const scopes = ['operator.read', 'operator.write', 'operator.admin']; + +async function probe(base, token, version) { + const socket = new WebSocket(base.replace('http:', 'ws:')); + let challenge; + const challengeReady = new Promise(resolve => { challenge = resolve; }); + const pending = new Map(); + let id = 0; + socket.addEventListener('message', event => { + const frame = JSON.parse(event.data); + if (frame.event === 'connect.challenge') challenge(); + if (frame.type === 'res') pending.get(frame.id)?.(frame); + }); + function rpc(method, params) { + return new Promise((resolve, reject) => { + const key = String(++id); + const timeout = setTimeout(() => { + pending.delete(key); + reject(new Error('RPC timeout: ' + method)); + }, 8000); + pending.set(key, frame => { + clearTimeout(timeout); + pending.delete(key); + resolve(frame); + }); + socket.send(JSON.stringify({ type: 'req', id: key, method, params })); + }); + } + async function ok(method, params) { + const response = await rpc(method, params); + assert.equal(response.ok, true, method + ': ' + JSON.stringify(response.error)); + return response.payload; + } + try { + await Promise.race([challengeReady, delay(8000, null, { ref: false }).then(() => { throw new Error('challenge timeout'); })]); + await ok('connect', { + minProtocol: 4, maxProtocol: 4, + client: { id: 'gateway-client', mode: 'backend', version: 'history-review', platform: 'node' }, + role: 'operator', scopes, auth: { token }, + }); + const created = await ok('sessions.create', { key: sessionKey }); + assert.equal(created.runStarted, false); + for (let n = 1; n <= 4; ++n) { + await ok('chat.inject', { sessionKey, message: 'history-review-' + n }); + } + const tail = await ok('chat.history', { sessionKey, limit: 2 }); + const ids = result => result.messages.map(message => { + const id = message.__openclaw?.id ?? message.messageId ?? message.id; + assert.equal(typeof id, 'string', 'message identity is missing'); + return id; + }); + const tailIds = ids(tail); + assert.equal(tail.sessionId, created.sessionId); + assert.equal(tailIds.length, 2); + assert.equal(tail.sessionInfo.hasActiveRun, false); + assert.deepEqual(tail.sessionInfo.activeRunIds, []); + if (version === '2026.7.1-2') { + for (const key of ['olderCursor', 'newerCursor', 'deltaCursor', 'nextOffset']) { + assert.equal(Object.hasOwn(tail, key), false, key + ' must be absent on the locked release'); + } + const cursor = await rpc('chat.history', { sessionKey, cursor: 'history-fixture-cursor' }); + assert.equal(cursor.ok, false); + assert.equal(cursor.error.code, 'INVALID_REQUEST'); + console.log(version, 'tail and idle state available; cursor absent and cursor input rejected'); + return; + } + assert.equal(tail.hasMore, true); + assert.equal(typeof tail.olderCursor, 'string'); + assert.equal(typeof tail.deltaCursor, 'string'); + assert.equal(typeof tail.nextOffset, 'number'); + const older = await ok('chat.history', { sessionKey, cursor: tail.olderCursor, limit: 2 }); + const olderIds = ids(older); + assert.equal(olderIds.length, 2); + assert.equal(older.sessionId, tail.sessionId); + assert.equal(new Set([...tailIds, ...olderIds]).size, 4); + assert.equal(Object.hasOwn(older, 'olderCursor'), false); + assert.equal(typeof older.newerCursor, 'string'); + const newer = await ok('chat.history', { sessionKey, cursor: older.newerCursor, limit: 2 }); + assert.deepEqual(ids(newer), tailIds); + assert.equal(Object.hasOwn(newer, 'newerCursor'), false); + + const unchanged = await ok('chat.history', { sessionKey, cursor: tail.deltaCursor }); + assert.equal(unchanged.kind, 'delta'); + assert.deepEqual(unchanged.messages, []); + assert.equal(unchanged.sessionInfo.sessionId, tail.sessionId); + assert.equal(typeof unchanged.deltaCursor, 'string'); + + await ok('chat.inject', { sessionKey, message: 'history-review-5' }); + const delta = await ok('chat.history', { sessionKey, cursor: unchanged.deltaCursor }); + assert.equal(delta.kind, 'delta'); + const deltaIds = ids(delta); + assert.equal(deltaIds.length, 1); + assert.equal(new Set([...tailIds, ...olderIds, ...deltaIds]).size, 5); + assert.equal(typeof delta.deltaCursor, 'string'); + + await ok('sessions.reset', { key: sessionKey }); + const stale = await ok('chat.history', { sessionKey, cursor: delta.deltaCursor }); + assert.equal(stale.kind, 'reset'); + assert.equal(Object.hasOwn(stale, 'messages'), false); + const fresh = await ok('chat.history', { sessionKey, limit: 2 }); + assert.equal(fresh.messages.length, 1); + assert.equal(fresh.messages[0].role, 'system'); + assert.equal(fresh.messages[0].__openclaw.kind, 'reset'); + assert.equal(new Set([...tailIds, ...olderIds, ...deltaIds, ...ids(fresh)]).size, 6); + console.log(version, 'directional pages, empty and one-message deltas, and reset verified'); + } finally { + socket.close(); + } +} + +async function release(runtime, version) { + const { version: actual } = JSON.parse(await readFile(path.join(runtime, 'package.json'))); + assert.equal(actual, version); + const work = await mkdtemp(path.join(tmpdir(), 'openclaw-history-review-')); + const reserved = net.createServer(); + reserved.listen(0, '127.0.0.1'); + await once(reserved, 'listening'); + const port = reserved.address().port; + reserved.close(); + await once(reserved, 'close'); + const base = 'http://127.0.0.1:' + port; + const config = path.join(work, 'gateway.json'); + const token = randomBytes(24).toString('hex'); + await writeFile(config, JSON.stringify({ + gateway: { mode: 'local', bind: 'loopback', port, auth: { mode: 'token', allowTailscale: false }, + controlUi: { enabled: false } }, + agents: { defaults: { workspace: path.join(work, 'workspace'), skipBootstrap: true } }, + discovery: { mdns: { mode: 'off' } }, cron: { enabled: false }, plugins: { enabled: false }, + })); + const child = spawn(process.execPath, [path.join(runtime, 'openclaw.mjs'), 'gateway', 'run'], { + cwd: work, + env: { PATH: process.env.PATH, OPENCLAW_HOME: work, OPENCLAW_CONFIG_PATH: config, + OPENCLAW_STATE_DIR: path.join(work, 'state'), OPENCLAW_GATEWAY_TOKEN: token, OPENCLAW_DISABLE_BONJOUR: '1' }, + stdio: ['ignore', 'ignore', 'ignore'], + }); + try { + for (let attempt = 0; attempt < 100; ++attempt) { + assert.equal(child.exitCode, null, 'Gateway exited before readiness'); + const ready = await fetch(base + '/readyz', { signal: AbortSignal.timeout(1000) }).catch(() => null); + if (ready?.ok) { + await ready.body.cancel(); + await probe(base, token, version); + return; + } + await delay(250); + } + throw new Error('Gateway did not become ready'); + } finally { + if (child.exitCode === null && child.signalCode === null) { + const stopped = once(child, 'exit'); + child.kill(); + await stopped; + } + await rm(work, { recursive: true }); + } +} + +if (process.argv.length !== 4) { + throw new Error('usage: node review-history.mjs LOCKED_PACKAGE_DIR CANDIDATE_PACKAGE_DIR'); +} +for (let index = 0; index < 2; ++index) { + await release(path.resolve(process.argv[index + 2]), ['2026.7.1-2', '2026.11.5'][index]); +} diff --git a/openspec/changes/fix-openclaw-protocol-contracts/tasks.md b/openspec/changes/fix-openclaw-protocol-contracts/tasks.md index d195028..10e4132 100644 --- a/openspec/changes/fix-openclaw-protocol-contracts/tasks.md +++ b/openspec/changes/fix-openclaw-protocol-contracts/tasks.md @@ -44,3 +44,5 @@ - [ ] 7.3 更新覆盖矩阵并执行规范校验;验收:官方 OpenSpec validate 输出通过、无未解释的三分支差异、所有必需任务有证据且人审允许归档,随后才更新生效 specs。 Tools Invoke 的锁定版与 2026.11.5 两轮真实回环验证及 Java DTO 差距见 [版本评审](evidence/2026-11-19-tools-invoke-version-review.md)。 + +会话历史的两版真实 Gateway 游标、增量及重置差异见 [版本评审](evidence/2026-11-19-chat-history-version-review.md)。 From 3c4197e24010617ca3cfaebe3d34355dea0b9ffc Mon Sep 17 00:00:00 2001 From: loong10k <20489781+loong10k@users.noreply.github.com> Date: Thu, 19 Nov 2026 05:40:08 +0800 Subject: [PATCH 16/22] Review Responses SSE terminals and continuation across Gateway versions --- .../2026-11-19-responses-version-review.md | 20 ++ .../evidence/fixtures/review-responses.py | 209 ++++++++++++++++++ .../fix-openclaw-protocol-contracts/tasks.md | 2 + 3 files changed, 231 insertions(+) create mode 100644 openspec/changes/fix-openclaw-protocol-contracts/evidence/2026-11-19-responses-version-review.md create mode 100644 openspec/changes/fix-openclaw-protocol-contracts/evidence/fixtures/review-responses.py diff --git a/openspec/changes/fix-openclaw-protocol-contracts/evidence/2026-11-19-responses-version-review.md b/openspec/changes/fix-openclaw-protocol-contracts/evidence/2026-11-19-responses-version-review.md new file mode 100644 index 0000000..c878258 --- /dev/null +++ b/openspec/changes/fix-openclaw-protocol-contracts/evidence/2026-11-19-responses-version-review.md @@ -0,0 +1,20 @@ +# Responses 的 2026.11.5 范围评审 + +在回环地址分别启动 OpenClaw 2026.7.1-2 和 2026.11.5,启用 `/v1/responses`。Gateway 请求由本地确定性的 OpenAI Chat Completions 模型桩响应。工作区、状态与令牌均为临时测试值。使用 Node 24.18.0,禁用插件、计划任务及候选版远端模型目录刷新。 [候选版 Responses 契约](https://github.com/openclaw/openclaw/blob/v2026.11.5/docs/gateway/openresponses-http-api.md) + +| 真实 Gateway 请求 | 2026.7.1-2 | 2026.11.5 | +| --- | --- | --- | +| 正常文本 SSE | 两条文本增量,唯一终态 `response.completed`,随后 `[DONE]` | 相同 | +| 模型桩报告输出长度耗尽 | 事件名为 `response.completed`,终态资源却标记 `failed` | `response.incomplete` 与资源 `incomplete` 一致 | +| 要求客户端工具而模型只生成文本 | `response.failed`,随后 `[DONE]` | 相同 | +| JSON 请求首次设置 `store=false`,再以有效 ID 续接 | 两次均完成 | 两次均完成 | +| 同令牌、同 agent,改动 JSON 的 `user` 后继续使用有效 ID | 请求成功 | 请求成功 | +| 使用有效 ID 但切换显式会话请求头 | 本轮未测 | HTTP 400,模型桩收不到此请求 | +| JSON 与 SSE 分别使用不存在的旧 ID | 两次都返回 HTTP 200,模型桩实际收到调用 | 两次都返回 HTTP 400 `invalid_request_error`,模型桩均未被调用 | +| 模型桩只给出合成客户端工具调用 | 取得 `function_call`,仅提交空的工具输出续接会返回 HTTP 400 | 本模型桩组合得到 HTTP 500 `api_error`,空工具输出的候选版验收未完成 | + +候选版应让 SDK 同时保留 SSE 事件名和资源状态。旧版长度耗尽响应说明,仅看事件名会误判成功。续接拒绝时应保留 400,宿主需要显式选择是否携带完整历史重开。JSON `user` 在本次共享令牌模式中不是独立身份约束。候选实现以认证主体、agent 和显式会话请求头查找对应关系。 [候选版续接实现](https://github.com/openclaw/openclaw/blob/v2026.11.5/src/gateway/openresponses-http.ts) + +现有三条 Java 发行线的 `OpenClawResponsesClient` JSON 路径将 `stream` 透传后再按 `ResponseResult` 解析。评审范围保留发送前拒绝错误入口和独立 SSE 解码。混合输出、空工具输出、客户端主动取消、终态前断流,以及实际 SDK 流式入口,仍需实施和验收。 + +运行 [review-responses.py](fixtures/review-responses.py),位置参数依次为两个已安装的 OpenClaw 包目录。脚本检查版本并在进程退出前清理模型桩和 Gateway。工具桩只返回合成协议帧,未执行实际工具。 diff --git a/openspec/changes/fix-openclaw-protocol-contracts/evidence/fixtures/review-responses.py b/openspec/changes/fix-openclaw-protocol-contracts/evidence/fixtures/review-responses.py new file mode 100644 index 0000000..d487b63 --- /dev/null +++ b/openspec/changes/fix-openclaw-protocol-contracts/evidence/fixtures/review-responses.py @@ -0,0 +1,209 @@ +"""Observe Responses HTTP and SSE behavior through a disposable real Gateway.""" +import json +import os +import secrets +import socket +import subprocess +import sys +import tempfile +import threading +import time +from http.server import BaseHTTPRequestHandler, ThreadingHTTPServer +from pathlib import Path +from urllib.error import HTTPError +from urllib.request import ProxyHandler, Request, build_opener + +OPENER = build_opener(ProxyHandler({})) +TOOLS = [{"type": "function", "name": "fixture_result", "parameters": {"type": "object", "properties": {}}}] + + +class Provider(BaseHTTPRequestHandler): + def log_message(self, *_args): + pass + + def do_POST(self): + body = json.loads(self.rfile.read(int(self.headers["Content-Length"]))) + if self.path != "/v1/chat/completions" or body.get("model") != "local-fixture" or not body.get("stream"): + self.send_error(400) + return + mode = self.server.mode + self.server.requests += 1 + self.send_response(200) + self.send_header("Content-Type", "text/event-stream") + self.end_headers() + + def emit(delta, reason=None): + out = {"id": "fixture", "object": "chat.completion.chunk", "created": 1, + "model": "local-fixture", "choices": [{"index": 0, "delta": delta, "finish_reason": reason}]} + self.wfile.write(("data: " + json.dumps(out) + "\n\n").encode()) + self.wfile.flush() + + emit({"role": "assistant"}) + if mode == "tool": + emit({"tool_calls": [{"index": 0, "id": "call_fixture", "type": "function", + "function": {"name": "fixture_result", "arguments": "{}"}}]}) + emit({}, "tool_calls") + else: + emit({"content": "Gateway "}) + time.sleep(0.1) + emit({"content": "fixture"}) + emit({}, "length" if mode == "length" else "stop") + usage = {"id": "fixture", "object": "chat.completion.chunk", "created": 1, "model": "local-fixture", + "choices": [], "usage": {"prompt_tokens": 8, "completion_tokens": 2, "total_tokens": 10}} + self.wfile.write(("data: " + json.dumps(usage) + "\n\ndata: [DONE]\n\n").encode()) + self.wfile.flush() + + +def request(base, token, user, mode, provider, session_header=None, **parameters): + provider.mode = mode + body = {"model": "openclaw", "user": user, **parameters} + headers = {"Authorization": "Bearer " + token, "Content-Type": "application/json"} + if session_header is not None: + headers["x-openclaw-session-key"] = session_header + req = Request(base + "/v1/responses", json.dumps(body).encode(), headers) + try: + response = OPENER.open(req, timeout=25) + except HTTPError as error: + response = error + with response: + if response.headers.get_content_type() != "text/event-stream": + return response.status, json.load(response) + frames = [] + event = None + for raw in response: + line = raw.decode().rstrip("\r\n") + if line.startswith("event: "): + event = line[7:] + if line.startswith("data: "): + data = line[6:] + frames.append(("done", None) if data == "[DONE]" else (event, json.loads(data))) + return response.status, frames + + +def probe(base, token, provider, candidate): + modes = ( + ("normal", {}, "response.completed", "completed", ["Gateway", " fixture"]), + ("length", {}, "response.incomplete" if candidate else "response.completed", + "incomplete" if candidate else "failed", ["Gateway", " fixture"]), + ("no-required-tool", {"tools": TOOLS, "tool_choice": "required"}, "response.failed", "failed", []), + ) + for mode, parameters, event, state, text in modes: + code, frames = request(base, token, mode, mode, provider, input="fixture", stream=True, **parameters) + assert code == 200 and isinstance(frames, list), (mode, code, frames) + terminal = [(name, (data or {}).get("response", {}).get("status")) + for name, data in frames if name in ("response.completed", "response.failed", + "response.incomplete", "done")] + assert terminal == [(event, state), ("done", None)], (mode, terminal) + assert [data.get("delta") for name, data in frames if name == "response.output_text.delta"] == text + print(mode, event, state, flush=True) + + code, first = request(base, token, "continuation", "normal", provider, input="first", store=False) + assert code == 200 and first["status"] == "completed" + response_id = first["id"] + code, second = request(base, token, "continuation", "normal", provider, + input="continue", previous_response_id=response_id) + assert code == 200 and second["status"] == "completed" + + code, changed_user = request(base, token, "other-user", "normal", provider, + input="continue", previous_response_id=response_id) + assert code == 200 and changed_user["status"] == "completed" + if candidate: + before = provider.requests + code, scoped = request(base, token, "continuation", "normal", provider, + session_header="agent:main:fixture-other", input="continue", + previous_response_id=response_id) + assert code == 400 and scoped["error"]["type"] == "invalid_request_error" + assert provider.requests == before + print("explicit session mismatch rejected before model", flush=True) + print("valid continuation and changed JSON user both accepted", flush=True) + + for stream in (False, True): + before = provider.requests + code, unknown = request(base, token, "unknown-" + str(stream), "normal", provider, + previous_response_id="resp_fixture_missing", input="fixture", stream=stream) + if candidate: + assert code == 400 and unknown["error"]["type"] == "invalid_request_error" + assert provider.requests == before + else: + assert code == 200 and provider.requests > before + print("unknown continuation", "SSE" if stream else "JSON", code, flush=True) + + code, tool = request(base, token, "tool", "tool", provider, input="fixture", tools=TOOLS) + if candidate: + assert code == 500 and tool["status"] == "failed" and tool["error"]["code"] == "api_error" + print("candidate client tool fixture failed; empty tool continuation remains unverified", flush=True) + else: + assert code == 200 and tool["status"] == "incomplete" + call, = [item for item in tool["output"] if item.get("type") == "function_call"] + code, continuation = request(base, token, "tool", "normal", provider, previous_response_id=tool["id"], + input=[{"type": "function_call_output", "call_id": call["call_id"], "output": ""}]) + assert code == 400 and continuation["error"]["type"] == "invalid_request_error" + print("locked release returned a tool call and rejected empty tool output", flush=True) + + +def release(runtime, version): + assert json.loads((runtime / "package.json").read_bytes())["version"] == version + with tempfile.TemporaryDirectory(prefix="openclaw-responses-review-") as tmp, \ + ThreadingHTTPServer(("127.0.0.1", 0), Provider) as provider: + state = Path(tmp) + provider.mode = "normal" + provider.requests = 0 + server_thread = threading.Thread(target=provider.serve_forever, daemon=True) + server_thread.start() + token = secrets.token_hex(24) + with socket.socket() as reserved: + reserved.bind(("127.0.0.1", 0)) + port = reserved.getsockname()[1] + base = f"http://127.0.0.1:{port}" + candidate = version == "2026.11.5" + catalog = {"catalogRefresh": {"enabled": False}} if candidate else {} + config = state / "gateway.json" + config.write_text(json.dumps({ + "gateway": {"mode": "local", "bind": "loopback", "port": port, + "auth": {"mode": "token", "allowTailscale": False}, + "http": {"endpoints": {"responses": {"enabled": True}}}, + "controlUi": {"enabled": False}}, + "agents": {"defaults": {"workspace": str(state / "workspace"), "skipBootstrap": True, + "model": {"primary": "localprobe/local-fixture", "fallbacks": []}}}, + "models": {"mode": "replace", **catalog, "providers": { + "localprobe": {"baseUrl": f"http://127.0.0.1:{provider.server_port}/v1", + "apiKey": "local-fixture-key", "api": "openai-completions", + "models": [{"id": "local-fixture", "name": "Local fixture", "reasoning": False, + "input": ["text"], "contextWindow": 32768, "maxTokens": 1024}]}}}, + "discovery": {"mdns": {"mode": "off"}}, "cron": {"enabled": False}, "plugins": {"enabled": False}, + })) + env = {"PATH": os.environ["PATH"], "OPENCLAW_HOME": tmp, "OPENCLAW_CONFIG_PATH": str(config), + "OPENCLAW_STATE_DIR": str(state / "state"), "OPENCLAW_GATEWAY_TOKEN": token, + "OPENCLAW_DISABLE_BONJOUR": "1", "OPENCLAW_NO_AUTO_UPDATE": "1"} + log_path = state / "gateway.log" + with log_path.open("w") as log: + child = subprocess.Popen(["node", str(runtime / "openclaw.mjs"), "gateway", "run"], + cwd=state, env=env, stdout=log, stderr=log) + try: + for _ in range(100): + if child.poll() is not None: + raise RuntimeError("Gateway exited: " + log_path.read_text()[-1500:]) + try: + with OPENER.open(base + "/readyz", timeout=1): + break + except OSError: + time.sleep(0.25) + else: + raise RuntimeError("Gateway did not start") + print(version, flush=True) + probe(base, token, provider, candidate) + finally: + child.terminate() + try: + child.wait(timeout=10) + except subprocess.TimeoutExpired: + child.kill() + child.wait() + provider.shutdown() + + +if __name__ == "__main__": + if len(sys.argv) != 3: + raise SystemExit("usage: review-responses.py LOCKED_PACKAGE_DIR CANDIDATE_PACKAGE_DIR") + for directory, version in zip(sys.argv[1:], ("2026.7.1-2", "2026.11.5"), strict=True): + release(Path(directory).resolve(), version) diff --git a/openspec/changes/fix-openclaw-protocol-contracts/tasks.md b/openspec/changes/fix-openclaw-protocol-contracts/tasks.md index 10e4132..ec12dca 100644 --- a/openspec/changes/fix-openclaw-protocol-contracts/tasks.md +++ b/openspec/changes/fix-openclaw-protocol-contracts/tasks.md @@ -46,3 +46,5 @@ Tools Invoke 的锁定版与 2026.11.5 两轮真实回环验证及 Java DTO 差距见 [版本评审](evidence/2026-11-19-tools-invoke-version-review.md)。 会话历史的两版真实 Gateway 游标、增量及重置差异见 [版本评审](evidence/2026-11-19-chat-history-version-review.md)。 + +Responses 的两版真实 Gateway 终态及续接差异见 [版本评审](evidence/2026-11-19-responses-version-review.md)。 From 140ae194403cdd26586bf03ef82678b2ccc2df55 Mon Sep 17 00:00:00 2001 From: loong10k <20489781+loong10k@users.noreply.github.com> Date: Thu, 19 Nov 2026 05:42:53 +0800 Subject: [PATCH 17/22] Verify Responses disconnect releases the upstream provider socket --- .../2026-11-19-responses-version-review.md | 7 ++- .../evidence/fixtures/review-responses.py | 45 +++++++++++++++++-- 2 files changed, 47 insertions(+), 5 deletions(-) diff --git a/openspec/changes/fix-openclaw-protocol-contracts/evidence/2026-11-19-responses-version-review.md b/openspec/changes/fix-openclaw-protocol-contracts/evidence/2026-11-19-responses-version-review.md index c878258..e190800 100644 --- a/openspec/changes/fix-openclaw-protocol-contracts/evidence/2026-11-19-responses-version-review.md +++ b/openspec/changes/fix-openclaw-protocol-contracts/evidence/2026-11-19-responses-version-review.md @@ -15,6 +15,11 @@ 候选版应让 SDK 同时保留 SSE 事件名和资源状态。旧版长度耗尽响应说明,仅看事件名会误判成功。续接拒绝时应保留 400,宿主需要显式选择是否携带完整历史重开。JSON `user` 在本次共享令牌模式中不是独立身份约束。候选实现以认证主体、agent 和显式会话请求头查找对应关系。 [候选版续接实现](https://github.com/openclaw/openclaw/blob/v2026.11.5/src/gateway/openresponses-http.ts) -现有三条 Java 发行线的 `OpenClawResponsesClient` JSON 路径将 `stream` 透传后再按 `ResponseResult` 解析。评审范围保留发送前拒绝错误入口和独立 SSE 解码。混合输出、空工具输出、客户端主动取消、终态前断流,以及实际 SDK 流式入口,仍需实施和验收。 +现有三条 Java 发行线的 `OpenClawResponsesClient` JSON 路径将 `stream` 透传后再按 `ResponseResult` 解析。评审范围保留发送前拒绝错误入口和独立 SSE 解码。混合输出、空工具输出、SDK 主动取消、终态前断流,以及实际 SDK 流式入口,仍需实施和验收。 运行 [review-responses.py](fixtures/review-responses.py),位置参数依次为两个已安装的 OpenClaw 包目录。脚本检查版本并在进程退出前清理模型桩和 Gateway。工具桩只返回合成协议帧,未执行实际工具。 + + +## 下游断开与上游连接回收 + +模型桩在发送文本增量后保持连接,既不发送终态也不自行关闭。客户端收到首个文本增量后关闭 SSE。两版 Gateway 均在桩的 8 秒保持窗口内关闭模型连接,桩通过 TCP EOF 确认。每版的被取消请求只进入模型桩一次。同一 JSON user 和 agent 随后的非流式请求成功完成。此处验证 Gateway 对真实断开的处理。Java SDK 主动取消、调用方收到的终态,以及无终态断流仍需实施后验证。 diff --git a/openspec/changes/fix-openclaw-protocol-contracts/evidence/fixtures/review-responses.py b/openspec/changes/fix-openclaw-protocol-contracts/evidence/fixtures/review-responses.py index d487b63..c71adf1 100644 --- a/openspec/changes/fix-openclaw-protocol-contracts/evidence/fixtures/review-responses.py +++ b/openspec/changes/fix-openclaw-protocol-contracts/evidence/fixtures/review-responses.py @@ -2,6 +2,7 @@ import json import os import secrets +import select import socket import subprocess import sys @@ -47,6 +48,13 @@ def emit(delta, reason=None): emit({"content": "Gateway "}) time.sleep(0.1) emit({"content": "fixture"}) + if mode == "hold": + deadline = time.monotonic() + 8 + while time.monotonic() < deadline and not self.server.finished_hold.is_set(): + readable, _, _ = select.select([self.connection], [], [], 0.2) + if readable and not self.connection.recv(1, socket.MSG_PEEK): + self.server.cancelled_connection.set() + return emit({}, "length" if mode == "length" else "stop") usage = {"id": "fixture", "object": "chat.completion.chunk", "created": 1, "model": "local-fixture", "choices": [], "usage": {"prompt_tokens": 8, "completion_tokens": 2, "total_tokens": 10}} @@ -54,7 +62,7 @@ def emit(delta, reason=None): self.wfile.flush() -def request(base, token, user, mode, provider, session_header=None, **parameters): +def open_request(base, token, user, mode, provider, session_header=None, **parameters): provider.mode = mode body = {"model": "openclaw", "user": user, **parameters} headers = {"Authorization": "Bearer " + token, "Content-Type": "application/json"} @@ -62,10 +70,13 @@ def request(base, token, user, mode, provider, session_header=None, **parameters headers["x-openclaw-session-key"] = session_header req = Request(base + "/v1/responses", json.dumps(body).encode(), headers) try: - response = OPENER.open(req, timeout=25) + return OPENER.open(req, timeout=25) except HTTPError as error: - response = error - with response: + return error + + +def request(*args, **kwargs): + with open_request(*args, **kwargs) as response: if response.headers.get_content_type() != "text/event-stream": return response.status, json.load(response) frames = [] @@ -141,6 +152,31 @@ def probe(base, token, provider, candidate): print("locked release returned a tool call and rejected empty tool output", flush=True) + +def verify_disconnect(base, token, provider): + provider.cancelled_connection = threading.Event() + provider.finished_hold = threading.Event() + before = provider.requests + try: + with open_request(base, token, "cancel-probe", "hold", provider, input="fixture", stream=True) as response: + assert response.status == 200 + assert response.headers.get_content_type() == "text/event-stream" + for raw in response: + if raw.startswith(b"event: response.output_text.delta"): + break + else: + raise AssertionError("expected a text delta before disconnect") + started = time.monotonic() + assert provider.cancelled_connection.wait(timeout=9), "provider socket remained open after disconnect" + print(f"downstream disconnect closed provider socket in {time.monotonic() - started:.3f}s", flush=True) + finally: + provider.finished_hold.set() + assert provider.requests == before + 1 + status, next_turn = request(base, token, "cancel-probe", "normal", provider, input="after disconnect") + assert status == 200 and next_turn["status"] == "completed" + print("same session accepted another turn", flush=True) + + def release(runtime, version): assert json.loads((runtime / "package.json").read_bytes())["version"] == version with tempfile.TemporaryDirectory(prefix="openclaw-responses-review-") as tmp, \ @@ -192,6 +228,7 @@ def release(runtime, version): raise RuntimeError("Gateway did not start") print(version, flush=True) probe(base, token, provider, candidate) + verify_disconnect(base, token, provider) finally: child.terminate() try: From 34565917fe5136285ba036527873ec328e875930 Mon Sep 17 00:00:00 2001 From: loong10k <20489781+loong10k@users.noreply.github.com> Date: Thu, 19 Nov 2026 09:20:25 +0800 Subject: [PATCH 18/22] docs: verify chat replacement and terminal snapshots on both Gateway versions --- .../2026-11-19-gateway-chat-isolation.md | 18 +++ .../GatewayChatSnapshotFixtureTest.java | 107 ++++++++++++++++++ .../fixtures/run-gateway-streaming.py | 13 ++- 3 files changed, 134 insertions(+), 4 deletions(-) create mode 100644 openspec/changes/fix-openclaw-protocol-contracts/evidence/fixtures/GatewayChatSnapshotFixtureTest.java diff --git a/openspec/changes/fix-openclaw-protocol-contracts/evidence/2026-11-19-gateway-chat-isolation.md b/openspec/changes/fix-openclaw-protocol-contracts/evidence/2026-11-19-gateway-chat-isolation.md index 7d0e3fc..094cd6d 100644 --- a/openspec/changes/fix-openclaw-protocol-contracts/evidence/2026-11-19-gateway-chat-isolation.md +++ b/openspec/changes/fix-openclaw-protocol-contracts/evidence/2026-11-19-gateway-chat-isolation.md @@ -33,3 +33,21 @@ 3. 将[启动器](fixtures/run-gateway-streaming.py)复制到同一临时目录,分别运行 `python3 run-gateway-streaming.py locked` 和 `python3 run-gateway-streaming.py candidate`。它会启动独立的回环 Gateway 和本地模型夹具,并写出三条版本线的测试日志。 候选补丁和测试证据供评审,SDK 分支仍指向表中的基线。该结果覆盖 CHAT-02-S1。版本确认、人审、会话代际和其他 G1 场景沿用现有验收项。 + +## CHAT-01 替换事件与最终快照 + +在上述三个 SDK 基线上,用通用事件监听器采集同一 `runId` 的原始 `chat` 事件,并核对每帧的 `sessionKey`。两个官方 Gateway 版本分别运行在回环地址,使用本地固定 SSE 模型和独立状态目录。每个版本分别发出三个模型请求,三条 Java 线共执行六项测试,零失败、零错误、零跳过。 + +| Gateway | 普通增量拼接结果 | `replace=true` 事件 | `final.message.content` 文本 | +| --- | --- | --- | --- | +| `2026.7.1-2` | `Gateway fixture ✓` | 0 次 | `Gateway fixture ✓` | +| `2026.11.5` | `Gateway fixture ✓` | 1 次,`deltaText=""` | `Gateway fixture ✓` | + +候选版在普通增量之后、最终帧之前发送空文本替换。空字符串是实际事件值,最终帧仍携带完整文本。这个序列为 CHAT-01 的替换与最终快照对账提供真实输入。非空替换、重复终态和 SDK 如何把替换通知给旧回调仍需按相应场景验收。 + +在前述临时源码树中复制 [GatewayChatSnapshotFixtureTest.java](fixtures/GatewayChatSnapshotFixtureTest.java),逐个启动 Gateway 以隔离 Maven 构建目录,重放命令如下。 + +```bash +FIXTURE_WORKERS=1 FIXTURE_TEST=GatewayChatSnapshotFixtureTest python3 run-gateway-streaming.py locked +FIXTURE_WORKERS=1 FIXTURE_TEST=GatewayChatSnapshotFixtureTest python3 run-gateway-streaming.py candidate +``` diff --git a/openspec/changes/fix-openclaw-protocol-contracts/evidence/fixtures/GatewayChatSnapshotFixtureTest.java b/openspec/changes/fix-openclaw-protocol-contracts/evidence/fixtures/GatewayChatSnapshotFixtureTest.java new file mode 100644 index 0000000..b1b4cb2 --- /dev/null +++ b/openspec/changes/fix-openclaw-protocol-contracts/evidence/fixtures/GatewayChatSnapshotFixtureTest.java @@ -0,0 +1,107 @@ +package io.github.easy4j.openclaw.ws; + +import io.github.easy4j.openclaw.OpenClawHttpClientConfig; +import io.github.easy4j.openclaw.ws.protocol.ChatSendParams; +import io.github.easy4j.openclaw.ws.protocol.EventFrame; +import org.junit.jupiter.api.Test; + +import java.net.URI; +import java.util.ArrayList; +import java.util.Arrays; +import java.util.Map; +import java.util.List; +import java.util.Objects; +import java.util.UUID; +import java.util.concurrent.CountDownLatch; +import java.util.concurrent.TimeUnit; + +import static org.junit.jupiter.api.Assertions.assertEquals; +import static org.junit.jupiter.api.Assertions.assertTrue; + +final class GatewayChatSnapshotFixtureTest { + @Test + void recordsReplacementAndFinalSnapshotForTheRequestedRun() throws Exception { + URI endpoint = URI.create(Objects.requireNonNull(System.getenv("SDK_PROBE_URL"))); + assertEquals("ws", endpoint.getScheme()); + assertEquals("127.0.0.1", endpoint.getHost()); + + OpenClawHttpClientConfig config = new OpenClawHttpClientConfig(); + config.setBaseUrl(endpoint.toString().replaceFirst("^ws:", "http:")); + config.setGatewayAuthToken(Objects.requireNonNull(System.getenv("OPENCLAW_GATEWAY_TOKEN"))); + config.setGatewayClientId("gateway-client"); + config.setGatewayClientMode("backend"); + config.setGatewayScopes(Arrays.asList("operator.read", "operator.write")); + + CountDownLatch finalReceived = new CountDownLatch(1); + List> chatEvents = new ArrayList<>(); + String runId = "sdk-chat-snapshot-" + UUID.randomUUID(); + String sessionKey = "agent:main:" + runId; + try (OpenClawGatewayWsClient client = new OpenClawGatewayWsClient(config, endpoint)) { + client.addListener(new OpenClawWsListener() { + @Override + public void onEvent(EventFrame frame) { + if (!"chat".equals(frame.getEvent()) || finalReceived.getCount() == 0) { + return; + } + if (!(frame.getPayload() instanceof Map)) { + return; + } + Map payload = (Map) frame.getPayload(); + if (!runId.equals(payload.get("runId"))) { + return; + } + chatEvents.add(payload); + if ("final".equals(payload.get("state"))) { + finalReceived.countDown(); + } + } + }); + assertEquals(4, client.connectHandshake().getProtocol()); + client.chatSend(ChatSendParams.builder() + .sessionKey(sessionKey) + .message("Return the local fixture response.") + .idempotencyKey(runId) + .timeoutMs(30000) + .build(), new ChatStreamHandler() { + @Override public void onDelta(String text) { } + @Override public void onComplete(String text) { } + @Override public void onError(String message) { } + }); + assertTrue(finalReceived.await(45, TimeUnit.SECONDS), "Expected the selected run's final frame"); + } + + StringBuilder appendText = new StringBuilder(); + List replacements = new ArrayList<>(); + for (Map event : chatEvents) { + assertEquals(sessionKey, event.get("sessionKey")); + if ("delta".equals(event.get("state")) && event.get("deltaText") instanceof String) { + String text = (String) event.get("deltaText"); + if (Boolean.TRUE.equals(event.get("replace"))) { + replacements.add(text); + } else { + appendText.append(text); + } + } + } + Map terminal = chatEvents.get(chatEvents.size() - 1); + Map message = (Map) terminal.get("message"); + List blocks = (List) message.get("content"); + List finalText = new ArrayList<>(); + for (Object value : blocks) { + Map block = (Map) value; + if ("text".equals(block.get("type"))) { + finalText.add((String) block.get("text")); + } + } + System.out.printf("chat snapshot append=%s replacementCount=%d replacementLengths=%s finalText=%s%n", + appendText, replacements.size(), replacements.stream().map(String::length) + .collect(java.util.stream.Collectors.toList()), finalText); + assertEquals("Gateway fixture ✓", appendText.toString()); + assertEquals(Arrays.asList("Gateway fixture ✓"), finalText); + if ("candidate".equals(System.getenv("SDK_FIXTURE_VERSION"))) { + assertEquals(Arrays.asList(""), replacements); + } else { + assertTrue(replacements.isEmpty()); + } + } +} diff --git a/openspec/changes/fix-openclaw-protocol-contracts/evidence/fixtures/run-gateway-streaming.py b/openspec/changes/fix-openclaw-protocol-contracts/evidence/fixtures/run-gateway-streaming.py index 8ac5989..19c8168 100644 --- a/openspec/changes/fix-openclaw-protocol-contracts/evidence/fixtures/run-gateway-streaming.py +++ b/openspec/changes/fix-openclaw-protocol-contracts/evidence/fixtures/run-gateway-streaming.py @@ -48,7 +48,12 @@ def chunk(delta, finish=None): version = os.sys.argv[1] workers = int(os.environ.get("FIXTURE_WORKERS", "3")) streams_started = threading.Barrier(workers) -prefix = f"chat-provenance-{workers}-{version}-" +fixture = os.environ.get("FIXTURE_TEST", "GatewayStreamingLiveFixtureTest") +fixture_labels = { + "GatewayStreamingLiveFixtureTest": "provenance", + "GatewayChatSnapshotFixtureTest": "snapshot-wire", +} +prefix = f"chat-{fixture_labels[fixture]}-{workers}-{version}-" runtime = root / (("locked-" if version == "locked" else "") + "runtime/node_modules/openclaw") token = secrets.token_hex(24) with socket.socket() as reservation: @@ -81,14 +86,14 @@ def verify(args): java = subprocess.check_output(["/usr/libexec/java_home", "-v", jdk], text=True).strip() env = dict(os.environ, JAVA_HOME=java, PATH=java + "/bin:" + os.environ["PATH"], SDK_PROBE_URL=f"ws://127.0.0.1:{port}", - OPENCLAW_GATEWAY_TOKEN=token) + OPENCLAW_GATEWAY_TOKEN=token, SDK_FIXTURE_VERSION=version) with (root / f"{prefix}tests-{line}.log").open("w") as log: mvn = ["bash", "./mvnw"] if line == 3 else ["mvn"] subprocess.run(mvn + ["-version"], env=env, cwd=root / f"sdk-{line}", stdout=log, stderr=log) build = subprocess.run(mvn + ["-B", "-ntp", "-o", "-Dmaven.repo.local=" + str(root / f"m2-{line}"), "-Dmaven.repo.local.tail=" + str(Path.home() / ".m2/repository"), - "-Dtest=" + test, "test"], + "-Dtest=" + test, "clean", "test"], env=env, cwd=root / f"sdk-{line}", stdout=log, stderr=log, timeout=120) return line, build.returncode @@ -111,7 +116,7 @@ def verify(args): raise RuntimeError("Gateway did not become ready") runs = [] with concurrent.futures.ThreadPoolExecutor(max_workers=workers) as executor: - for line, result in executor.map(verify, tuple((line, jdk, "GatewayStreamingLiveFixtureTest") for line, jdk in ((1, "1.8"), (2, "17"), (3, "21")))): + for line, result in executor.map(verify, tuple((line, jdk, fixture) for line, jdk in ((1, "1.8"), (2, "17"), (3, "21")))): print(f"SDK line {line}: Maven exit {result}", flush=True) runs.append(result) if any(runs): From 440f0504333fd4748ab9d9fcf7c82d20f8c62097 Mon Sep 17 00:00:00 2001 From: loong10k <20489781+loong10k@users.noreply.github.com> Date: Thu, 19 Nov 2026 10:51:09 +0800 Subject: [PATCH 19/22] docs: verify Responses empty tool output on both Gateway versions Refs #7 --- .../2026-11-19-responses-version-review.md | 8 ++- .../evidence/fixtures/review-responses.py | 51 +++++++++++++++++-- 2 files changed, 54 insertions(+), 5 deletions(-) diff --git a/openspec/changes/fix-openclaw-protocol-contracts/evidence/2026-11-19-responses-version-review.md b/openspec/changes/fix-openclaw-protocol-contracts/evidence/2026-11-19-responses-version-review.md index e190800..83bf866 100644 --- a/openspec/changes/fix-openclaw-protocol-contracts/evidence/2026-11-19-responses-version-review.md +++ b/openspec/changes/fix-openclaw-protocol-contracts/evidence/2026-11-19-responses-version-review.md @@ -11,10 +11,14 @@ | 同令牌、同 agent,改动 JSON 的 `user` 后继续使用有效 ID | 请求成功 | 请求成功 | | 使用有效 ID 但切换显式会话请求头 | 本轮未测 | HTTP 400,模型桩收不到此请求 | | JSON 与 SSE 分别使用不存在的旧 ID | 两次都返回 HTTP 200,模型桩实际收到调用 | 两次都返回 HTTP 400 `invalid_request_error`,模型桩均未被调用 | -| 模型桩只给出合成客户端工具调用 | 取得 `function_call`,仅提交空的工具输出续接会返回 HTTP 400 | 本模型桩组合得到 HTTP 500 `api_error`,空工具输出的候选版验收未完成 | +| 使用正常文本响应的有效 ID,以合成 `call_id` 提交空字符串工具输出 | JSON 和 SSE 均在调用模型前返回 HTTP 400 | JSON 和 SSE 均只调用模型一次,终态为 `completed` | +| 模型桩只给出合成客户端工具调用 | 取得 `function_call`,仅提交空的工具输出续接会返回 HTTP 400 | 本模型桩组合得到 HTTP 500 `api_error` | +| 模型桩给出文本与工具调用,客户端使用 SSE | 两个输出项,终态事件 `response.completed` 的资源状态为 `incomplete`,保留文本、调用 ID、参数和用量。工具项在 `output_item.done` 带 `status=completed`,最终快照省略该字段 | 本模型桩组合得到 `response.failed`,错误码 `api_error` | 候选版应让 SDK 同时保留 SSE 事件名和资源状态。旧版长度耗尽响应说明,仅看事件名会误判成功。续接拒绝时应保留 400,宿主需要显式选择是否携带完整历史重开。JSON `user` 在本次共享令牌模式中不是独立身份约束。候选实现以认证主体、agent 和显式会话请求头查找对应关系。 [候选版续接实现](https://github.com/openclaw/openclaw/blob/v2026.11.5/src/gateway/openresponses-http.ts) +候选版接受带空字符串的续接请求。该对照使用正常文本响应的有效 ID 和合成调用 ID,尚缺 Gateway 生成工具调用后再提交空结果的端到端证据。候选版标记的上游测试覆盖该流程,其中 agent 运行结果来自 mock。 [候选版空结果续接测试](https://github.com/openclaw/openclaw/blob/v2026.11.5/src/gateway/openresponses-http.test.ts#L1454) + 现有三条 Java 发行线的 `OpenClawResponsesClient` JSON 路径将 `stream` 透传后再按 `ResponseResult` 解析。评审范围保留发送前拒绝错误入口和独立 SSE 解码。混合输出、空工具输出、SDK 主动取消、终态前断流,以及实际 SDK 流式入口,仍需实施和验收。 运行 [review-responses.py](fixtures/review-responses.py),位置参数依次为两个已安装的 OpenClaw 包目录。脚本检查版本并在进程退出前清理模型桩和 Gateway。工具桩只返回合成协议帧,未执行实际工具。 @@ -22,4 +26,4 @@ ## 下游断开与上游连接回收 -模型桩在发送文本增量后保持连接,既不发送终态也不自行关闭。客户端收到首个文本增量后关闭 SSE。两版 Gateway 均在桩的 8 秒保持窗口内关闭模型连接,桩通过 TCP EOF 确认。每版的被取消请求只进入模型桩一次。同一 JSON user 和 agent 随后的非流式请求成功完成。此处验证 Gateway 对真实断开的处理。Java SDK 主动取消、调用方收到的终态,以及无终态断流仍需实施后验证。 +模型桩在发送文本增量后保持连接,既不发送终态也不自行关闭。客户端收到首个文本增量后关闭 SSE。两版 Gateway 均在桩的 8 秒保持窗口内关闭模型连接,桩通过 TCP EOF 或连接重置确认。每版的被取消请求只进入模型桩一次。同一 JSON user 和 agent 随后的非流式请求成功完成。此处验证 Gateway 对真实断开的处理。Java SDK 主动取消、调用方收到的终态,以及无终态断流仍需实施后验证。 diff --git a/openspec/changes/fix-openclaw-protocol-contracts/evidence/fixtures/review-responses.py b/openspec/changes/fix-openclaw-protocol-contracts/evidence/fixtures/review-responses.py index c71adf1..e18af4a 100644 --- a/openspec/changes/fix-openclaw-protocol-contracts/evidence/fixtures/review-responses.py +++ b/openspec/changes/fix-openclaw-protocol-contracts/evidence/fixtures/review-responses.py @@ -40,7 +40,9 @@ def emit(delta, reason=None): self.wfile.flush() emit({"role": "assistant"}) - if mode == "tool": + if mode in ("tool", "mixed"): + if mode == "mixed": + emit({"content": "Mixed fixture"}) emit({"tool_calls": [{"index": 0, "id": "call_fixture", "type": "function", "function": {"name": "fixture_result", "arguments": "{}"}}]}) emit({}, "tool_calls") @@ -52,7 +54,12 @@ def emit(delta, reason=None): deadline = time.monotonic() + 8 while time.monotonic() < deadline and not self.server.finished_hold.is_set(): readable, _, _ = select.select([self.connection], [], [], 0.2) - if readable and not self.connection.recv(1, socket.MSG_PEEK): + if readable: + try: + if self.connection.recv(1, socket.MSG_PEEK): + continue + except ConnectionResetError: + pass self.server.cancelled_connection.set() return emit({}, "length" if mode == "length" else "stop") @@ -139,10 +146,29 @@ def probe(base, token, provider, candidate): assert code == 200 and provider.requests > before print("unknown continuation", "SSE" if stream else "JSON", code, flush=True) + empty_result = [{"type": "function_call_output", "call_id": "call_fixture", "output": ""}] + for stream in (False, True): + before = provider.requests + status, result = request(base, token, "continuation", "normal", provider, + previous_response_id=response_id, input=empty_result, stream=stream) + if candidate: + assert status == 200 and provider.requests == before + 1 + if stream: + assert [(name, payload["response"]["status"]) for name, payload in result + if name in ("response.completed", "response.incomplete", "response.failed")] == [ + ("response.completed", "completed")] + assert result[-1] == ("done", None) + else: + assert result["status"] == "completed" + else: + assert status == 400 and result["error"]["message"] == "Missing user message in `input`." + assert provider.requests == before + print("synthetic empty tool result", "SSE" if stream else "JSON", status, flush=True) + code, tool = request(base, token, "tool", "tool", provider, input="fixture", tools=TOOLS) if candidate: assert code == 500 and tool["status"] == "failed" and tool["error"]["code"] == "api_error" - print("candidate client tool fixture failed; empty tool continuation remains unverified", flush=True) + print("candidate could not generate a tool call from this model fixture", flush=True) else: assert code == 200 and tool["status"] == "incomplete" call, = [item for item in tool["output"] if item.get("type") == "function_call"] @@ -151,6 +177,25 @@ def probe(base, token, provider, candidate): assert code == 400 and continuation["error"]["type"] == "invalid_request_error" print("locked release returned a tool call and rejected empty tool output", flush=True) + status, frames = request(base, token, "mixed", "mixed", provider, input="fixture", tools=TOOLS, stream=True) + assert status == 200 and frames[-1] == ("done", None) + terminal, = [(name, data["response"]) for name, data in frames + if name in ("response.completed", "response.incomplete", "response.failed")] + event, response = terminal + if candidate: + assert (event, response["status"]) == ("response.failed", "failed") + assert response["error"]["code"] == "api_error" + else: + assert (event, response["status"]) == ("response.completed", "incomplete") + text, call = response["output"] + assert text["content"][0]["text"] == "Mixed fixture" + assert call["type"] == "function_call" and call["name"] == "fixture_result" + assert call["call_id"] and json.loads(call["arguments"]) == {} + assert response["usage"]["total_tokens"] == 10 + items = [(data["output_index"], data["item"]) for name, data in frames + if name == "response.output_item.done"] + assert items == [(0, text), (1, {**call, "status": "completed"})] + print("mixed text and tool", event, response["status"], flush=True) def verify_disconnect(base, token, provider): From 2554092d01962ebcb1f1e611ba2b0094b5fd1414 Mon Sep 17 00:00:00 2001 From: loong10k <20489781+loong10k@users.noreply.github.com> Date: Thu, 19 Nov 2026 10:54:42 +0800 Subject: [PATCH 20/22] docs: verify configured OpenClaw Responses tool continuation Refs #7 --- .../2026-11-19-responses-version-review.md | 13 +++++- .../evidence/fixtures/review-responses.py | 44 ++++++++++++++++--- 2 files changed, 49 insertions(+), 8 deletions(-) diff --git a/openspec/changes/fix-openclaw-protocol-contracts/evidence/2026-11-19-responses-version-review.md b/openspec/changes/fix-openclaw-protocol-contracts/evidence/2026-11-19-responses-version-review.md index 83bf866..c4a5691 100644 --- a/openspec/changes/fix-openclaw-protocol-contracts/evidence/2026-11-19-responses-version-review.md +++ b/openspec/changes/fix-openclaw-protocol-contracts/evidence/2026-11-19-responses-version-review.md @@ -17,13 +17,22 @@ 候选版应让 SDK 同时保留 SSE 事件名和资源状态。旧版长度耗尽响应说明,仅看事件名会误判成功。续接拒绝时应保留 400,宿主需要显式选择是否携带完整历史重开。JSON `user` 在本次共享令牌模式中不是独立身份约束。候选实现以认证主体、agent 和显式会话请求头查找对应关系。 [候选版续接实现](https://github.com/openclaw/openclaw/blob/v2026.11.5/src/gateway/openresponses-http.ts) -候选版接受带空字符串的续接请求。该对照使用正常文本响应的有效 ID 和合成调用 ID,尚缺 Gateway 生成工具调用后再提交空结果的端到端证据。候选版标记的上游测试覆盖该流程,其中 agent 运行结果来自 mock。 [候选版空结果续接测试](https://github.com/openclaw/openclaw/blob/v2026.11.5/src/gateway/openresponses-http.test.ts#L1454) +前表的空字符串对照使用正常文本响应的有效 ID 和合成调用 ID。候选版标记的上游测试也覆盖工具结果续接,其中 agent 运行结果来自 mock。 [候选版空结果续接测试](https://github.com/openclaw/openclaw/blob/v2026.11.5/src/gateway/openresponses-http.test.ts#L1454) -现有三条 Java 发行线的 `OpenClawResponsesClient` JSON 路径将 `stream` 透传后再按 `ResponseResult` 解析。评审范围保留发送前拒绝错误入口和独立 SSE 解码。混合输出、空工具输出、SDK 主动取消、终态前断流,以及实际 SDK 流式入口,仍需实施和验收。 +现有三条 Java 发行线的 `OpenClawResponsesClient` JSON 路径将 `stream` 透传后再按 `ResponseResult` 解析。评审范围保留发送前拒绝错误入口和独立 SSE 解码。Java 的混合输出重建、空工具输出序列化、主动取消、终态前断流和流式入口仍需实施和验收。 运行 [review-responses.py](fixtures/review-responses.py),位置参数依次为两个已安装的 OpenClaw 包目录。脚本检查版本并在进程退出前清理模型桩和 Gateway。工具桩只返回合成协议帧,未执行实际工具。 +## 候选版显式工具配置 + +默认配置的候选版模型请求没有直接列出合成客户端工具。另起一个回环 Gateway,只允许 `fixture_result`,关闭工具发现,并将模型桩的上下文声明设为 262144。该配置仅用于验证客户端显式传入的合成工具。全程没有执行该工具。 + +- 首次 JSON 请求返回 `function_call`。续接请求重新提供工具声明,并使用原响应 ID、Gateway 返回的 `call_id` 和空字符串结果。真实 Gateway 只调用模型桩一次,模型输入携带相同工具 ID,SSE 以唯一的 `response.completed` 和 `[DONE]` 结束。 +- 混合 SSE 请求在两个不同的 `output_index` 结束文本和工具项,终态保留相同项、调用 ID、参数与用量。候选版的最终资源和工具项都携带 `status=completed`。 + +这两项可作为 RSP-02-S1 与 RSP-03-S1 的 Gateway 输入样本。验收仍需覆盖 Java 协议层及部署所用的工具配置。 + ## 下游断开与上游连接回收 模型桩在发送文本增量后保持连接,既不发送终态也不自行关闭。客户端收到首个文本增量后关闭 SSE。两版 Gateway 均在桩的 8 秒保持窗口内关闭模型连接,桩通过 TCP EOF 或连接重置确认。每版的被取消请求只进入模型桩一次。同一 JSON user 和 agent 随后的非流式请求成功完成。此处验证 Gateway 对真实断开的处理。Java SDK 主动取消、调用方收到的终态,以及无终态断流仍需实施后验证。 diff --git a/openspec/changes/fix-openclaw-protocol-contracts/evidence/fixtures/review-responses.py b/openspec/changes/fix-openclaw-protocol-contracts/evidence/fixtures/review-responses.py index e18af4a..1d024c9 100644 --- a/openspec/changes/fix-openclaw-protocol-contracts/evidence/fixtures/review-responses.py +++ b/openspec/changes/fix-openclaw-protocol-contracts/evidence/fixtures/review-responses.py @@ -29,6 +29,7 @@ def do_POST(self): return mode = self.server.mode self.server.requests += 1 + self.server.last_model_messages = body["messages"] self.send_response(200) self.send_header("Content-Type", "text/event-stream") self.end_headers() @@ -177,16 +178,20 @@ def probe(base, token, provider, candidate): assert code == 400 and continuation["error"]["type"] == "invalid_request_error" print("locked release returned a tool call and rejected empty tool output", flush=True) + verify_mixed_tool_stream(base, token, provider, candidate) + + +def verify_mixed_tool_stream(base, token, provider, candidate, inline_tools=False): status, frames = request(base, token, "mixed", "mixed", provider, input="fixture", tools=TOOLS, stream=True) assert status == 200 and frames[-1] == ("done", None) terminal, = [(name, data["response"]) for name, data in frames if name in ("response.completed", "response.incomplete", "response.failed")] event, response = terminal - if candidate: + if candidate and not inline_tools: assert (event, response["status"]) == ("response.failed", "failed") assert response["error"]["code"] == "api_error" else: - assert (event, response["status"]) == ("response.completed", "incomplete") + assert (event, response["status"]) == ("response.completed", "completed" if candidate else "incomplete") text, call = response["output"] assert text["content"][0]["text"] == "Mixed fixture" assert call["type"] == "function_call" and call["name"] == "fixture_result" @@ -198,6 +203,26 @@ def probe(base, token, provider, candidate): print("mixed text and tool", event, response["status"], flush=True) +def verify_inline_tool_continuation(base, token, provider): + status, first = request(base, token, "inline-tool", "tool", provider, input="fixture", tools=TOOLS) + assert status == 200 and first["status"] == "completed" + call, = first["output"] + assert call["type"] == "function_call" and call["name"] == "fixture_result" and call["call_id"] + before = provider.requests + status, frames = request(base, token, "inline-tool", "normal", provider, previous_response_id=first["id"], + input=[{"type": "function_call_output", "call_id": call["call_id"], "output": ""}], + tools=TOOLS, stream=True) + assert status == 200 and provider.requests == before + 1 and frames[-1] == ("done", None) + terminal, = [(name, data["response"]) for name, data in frames + if name in ("response.completed", "response.incomplete", "response.failed")] + event, response = terminal + assert (event, response["status"]) == ("response.completed", "completed") + assert response["output"][0]["content"][0]["text"] == "Gateway fixture" + assert f'Tool:{call["call_id"]}:' in json.dumps(provider.last_model_messages) + print("returned call ID accepted with empty output in SSE continuation", flush=True) + verify_mixed_tool_stream(base, token, provider, candidate=True, inline_tools=True) + + def verify_disconnect(base, token, provider): provider.cancelled_connection = threading.Event() provider.finished_hold = threading.Event() @@ -222,7 +247,7 @@ def verify_disconnect(base, token, provider): print("same session accepted another turn", flush=True) -def release(runtime, version): +def release(runtime, version, inline_tools=False): assert json.loads((runtime / "package.json").read_bytes())["version"] == version with tempfile.TemporaryDirectory(prefix="openclaw-responses-review-") as tmp, \ ThreadingHTTPServer(("127.0.0.1", 0), Provider) as provider: @@ -239,7 +264,9 @@ def release(runtime, version): candidate = version == "2026.11.5" catalog = {"catalogRefresh": {"enabled": False}} if candidate else {} config = state / "gateway.json" + tool_policy = {"tools": {"allow": ["fixture_result"], "toolSearch": False}} if inline_tools else {} config.write_text(json.dumps({ + **tool_policy, "gateway": {"mode": "local", "bind": "loopback", "port": port, "auth": {"mode": "token", "allowTailscale": False}, "http": {"endpoints": {"responses": {"enabled": True}}}, @@ -250,7 +277,8 @@ def release(runtime, version): "localprobe": {"baseUrl": f"http://127.0.0.1:{provider.server_port}/v1", "apiKey": "local-fixture-key", "api": "openai-completions", "models": [{"id": "local-fixture", "name": "Local fixture", "reasoning": False, - "input": ["text"], "contextWindow": 32768, "maxTokens": 1024}]}}}, + "input": ["text"], "contextWindow": 262144 if inline_tools else 32768, + "maxTokens": 1024}]}}}, "discovery": {"mdns": {"mode": "off"}}, "cron": {"enabled": False}, "plugins": {"enabled": False}, })) env = {"PATH": os.environ["PATH"], "OPENCLAW_HOME": tmp, "OPENCLAW_CONFIG_PATH": str(config), @@ -272,8 +300,11 @@ def release(runtime, version): else: raise RuntimeError("Gateway did not start") print(version, flush=True) - probe(base, token, provider, candidate) - verify_disconnect(base, token, provider) + if inline_tools: + verify_inline_tool_continuation(base, token, provider) + else: + probe(base, token, provider, candidate) + verify_disconnect(base, token, provider) finally: child.terminate() try: @@ -289,3 +320,4 @@ def release(runtime, version): raise SystemExit("usage: review-responses.py LOCKED_PACKAGE_DIR CANDIDATE_PACKAGE_DIR") for directory, version in zip(sys.argv[1:], ("2026.7.1-2", "2026.11.5"), strict=True): release(Path(directory).resolve(), version) + release(Path(sys.argv[2]).resolve(), "2026.11.5", inline_tools=True) From 7a007c23d875c01ec412f4fc739935f95fb051bd Mon Sep 17 00:00:00 2001 From: loong10k <20489781+loong10k@users.noreply.github.com> Date: Thu, 19 Nov 2026 10:57:06 +0800 Subject: [PATCH 21/22] docs: reproduce OpenClaw Responses JSON entry gap on three JDKs Refs #7 --- .../2026-11-19-responses-version-review.md | 12 ++++ .../ResponsesJsonEntryFixtureTest.java | 64 +++++++++++++++++++ 2 files changed, 76 insertions(+) create mode 100644 openspec/changes/fix-openclaw-protocol-contracts/evidence/fixtures/ResponsesJsonEntryFixtureTest.java diff --git a/openspec/changes/fix-openclaw-protocol-contracts/evidence/2026-11-19-responses-version-review.md b/openspec/changes/fix-openclaw-protocol-contracts/evidence/2026-11-19-responses-version-review.md index c4a5691..ab1d70b 100644 --- a/openspec/changes/fix-openclaw-protocol-contracts/evidence/2026-11-19-responses-version-review.md +++ b/openspec/changes/fix-openclaw-protocol-contracts/evidence/2026-11-19-responses-version-review.md @@ -36,3 +36,15 @@ ## 下游断开与上游连接回收 模型桩在发送文本增量后保持连接,既不发送终态也不自行关闭。客户端收到首个文本增量后关闭 SSE。两版 Gateway 均在桩的 8 秒保持窗口内关闭模型连接,桩通过 TCP EOF 或连接重置确认。每版的被取消请求只进入模型桩一次。同一 JSON user 和 agent 随后的非流式请求成功完成。此处验证 Gateway 对真实断开的处理。Java SDK 主动取消、调用方收到的终态,以及无终态断流仍需实施后验证。 + +## RSP-01-S2 的 Java 基线 + +[共享回环夹具](fixtures/ResponsesJsonEntryFixtureTest.java)在三条 Java 发行线各执行一项测试,均零失败、零错误、零跳过。每项先用普通 JSON 请求确认控制组成功,再向同一个 JSON 入口传 `stream=true`。回环服务器实际收到两次 HTTP 请求,其中一次带 `stream=true`。返回 SSE 后客户端才抛出 JSON 解析异常。该结果记录了现状,并验证了请求发出前拦截的验收缺口。 + +| Java | 发行线验证提交 | +| --- | --- | +| 8 | `3dc46a0e58200b086efc59029a43aa5c136bf61b` | +| 17 | `9293a8cd2580435ec076b076d98c7965b77f0049` | +| 21 | `34b003b5c2c2158e536d3290ef67de7932ab78ef` | + +将夹具放入各提交的 `src/test/java/io/github/easy4j/openclaw/`,使用对应 JDK,运行 `mvn -B -ntp -Dtest=ResponsesJsonEntryFixtureTest test`。Java 21 使用 `./mvnw`。 diff --git a/openspec/changes/fix-openclaw-protocol-contracts/evidence/fixtures/ResponsesJsonEntryFixtureTest.java b/openspec/changes/fix-openclaw-protocol-contracts/evidence/fixtures/ResponsesJsonEntryFixtureTest.java new file mode 100644 index 0000000..ec51962 --- /dev/null +++ b/openspec/changes/fix-openclaw-protocol-contracts/evidence/fixtures/ResponsesJsonEntryFixtureTest.java @@ -0,0 +1,64 @@ +package io.github.easy4j.openclaw; + +import com.sun.net.httpserver.HttpServer; +import io.github.easy4j.openclaw.api.OpenClawResponsesClient; +import io.github.easy4j.openclaw.api.model.ResponseRequest; +import io.github.easy4j.openclaw.exception.OpenClawHttpException; +import org.junit.jupiter.api.Test; + +import java.io.IOException; +import java.io.OutputStream; +import java.net.InetSocketAddress; +import java.nio.charset.StandardCharsets; +import java.util.Scanner; +import java.util.concurrent.atomic.AtomicInteger; + +import static org.junit.jupiter.api.Assertions.assertEquals; +import static org.junit.jupiter.api.Assertions.assertThrows; +import static org.junit.jupiter.api.Assertions.assertTrue; + +class ResponsesJsonEntryFixtureTest { + + @Test + void existingJsonEntrySendsStreamRequestAndAttemptsJsonParsing() throws IOException { + AtomicInteger requests = new AtomicInteger(); + AtomicInteger streamRequests = new AtomicInteger(); + HttpServer server = HttpServer.create(new InetSocketAddress("127.0.0.1", 0), 0); + server.createContext("/v1/responses", exchange -> { + try (Scanner body = new Scanner(exchange.getRequestBody(), "UTF-8")) { + requests.incrementAndGet(); + String json = body.useDelimiter("\\A").next(); + boolean stream = json.contains("\"stream\":true"); + if (stream) { + streamRequests.incrementAndGet(); + } + String payload = stream + ? "event: response.completed\ndata: {\"type\":\"response.completed\"," + + "\"response\":{\"id\":\"resp_fixture\",\"status\":\"completed\"}}\n\ndata: [DONE]\n\n" + : "{\"id\":\"resp_fixture\",\"status\":\"completed\",\"output\":[]}"; + byte[] bytes = payload.getBytes(StandardCharsets.UTF_8); + exchange.getResponseHeaders().set("Content-Type", stream ? "text/event-stream" : "application/json"); + exchange.sendResponseHeaders(200, bytes.length); + try (OutputStream output = exchange.getResponseBody()) { + output.write(bytes); + } + } finally { + exchange.close(); + } + }); + server.start(); + OpenClawHttpClientConfig config = new OpenClawHttpClientConfig(); + config.setBaseUrl("http://127.0.0.1:" + server.getAddress().getPort()); + try (OpenClawResponsesClient client = new OpenClawResponsesClient(config)) { + assertEquals("resp_fixture", client.createResponse( + ResponseRequest.builder().model("openclaw").input("fixture").build()).getId()); + OpenClawHttpException failure = assertThrows(OpenClawHttpException.class, () -> client.createResponse( + ResponseRequest.builder().model("openclaw").input("fixture").stream(true).build())); + assertTrue(failure.getMessage().contains("parse"), failure.getMessage()); + assertEquals(2, requests.get()); + assertEquals(1, streamRequests.get()); + } finally { + server.stop(0); + } + } +} From c5cd03a8ac6159752972f1a6072f203a9457f7e4 Mon Sep 17 00:00:00 2001 From: loong10k <20489781+loong10k@users.noreply.github.com> Date: Thu, 19 Nov 2026 12:16:41 +0800 Subject: [PATCH 22/22] docs: review OpenClaw device handshake on 2026.11.5 --- .../2026-11-19-device-auth-version-review.md | 26 +++++++++++++++++++ .../fix-openclaw-protocol-contracts/tasks.md | 2 ++ 2 files changed, 28 insertions(+) create mode 100644 openspec/changes/fix-openclaw-protocol-contracts/evidence/2026-11-19-device-auth-version-review.md diff --git a/openspec/changes/fix-openclaw-protocol-contracts/evidence/2026-11-19-device-auth-version-review.md b/openspec/changes/fix-openclaw-protocol-contracts/evidence/2026-11-19-device-auth-version-review.md new file mode 100644 index 0000000..63c2b44 --- /dev/null +++ b/openspec/changes/fix-openclaw-protocol-contracts/evidence/2026-11-19-device-auth-version-review.md @@ -0,0 +1,26 @@ +# OpenClaw 2026.11.5 设备握手范围复评 + +G1 的 AUTH-01 仍适用于 2026.11.5。候选版在 hello-ok 中增加了认证方法等元数据,设备 Token 缺省仍是正常成功路径。SDK 需要保留 Gateway 实际返回的认证结果和权限。凭据存储、轮换以及权限变更由后续批准的契约和验证决定。 + +## 真实 Gateway + +使用两个 npm 发布版,在 Node 24.18.0 上分别启动只监听回环地址的 Gateway。每版使用独立配置、状态目录和临时 Token,关闭插件、发现、定时任务、Control UI。使用各版本自带的 GatewayClient,请求 `operator.read`。握手响应只记录字段是否存在。输入 Java 验证的样本用占位值替换凭据和连接 ID。 + +| Gateway | 无设备身份的 backend 握手 | 设备签名 CLI 握手 | `auth.method` | +| --- | --- | --- | --- | +| `2026.7.1-2` | 成功,无 `deviceToken` | 成功,有 `deviceToken` | 缺省 | +| `2026.11.5` | 成功,无 `deviceToken` | 成功,有 `deviceToken` | 均为 `token` | + +四次握手均协商协议 4,返回 `snapshot`、`role=operator` 和 `scopes=[operator.read]`。这组连接全部只涉及 operator 角色,均未出现额外 `deviceTokens`。之前带设备签名的 backend 握手在两版同样成功,均未签发设备 Token。 + +## Java SDK 基线 + +将两版各两份脱敏 hello-ok 样本输入 SDK 使用的 Jackson 映射。三个 JDK 各执行 1 项测试,覆盖四份样本,均无失败、错误或跳过。SDK 保留协议、服务端版本、角色和 scopes,映射后的 `HelloOk` 缺少 `snapshot`、`deviceToken`、`issuedAtMs` 和候选版新增的 `auth.method`。 + +| JDK | SDK 提交 | +| --- | --- | +| 8 | `3dc46a0e58200b086efc59029a43aa5c136bf61b` | +| 17 | `9293a8cd2580435ec076b076d98c7965b77f0049` | +| 21 | `34b003b5c2c2158e536d3290ef67de7932ab78ef` | + +候选版生成的 schema 还声明了可选的 `recoveryMigrationAllowed`、`recoveryScope`、`roleAllowsAdmin`、`sessionCap`。本次样本仅用于 AUTH-01 静态比较和真实握手观察。多角色 `deviceTokens`、宿主凭据保存和隔离、轮换与权限升级拒绝待真实验收。G0 版本锁定与 G1 实施范围待维护者批准。[上游协议 schema](https://github.com/openclaw/openclaw/tree/e13cf15ece9bbd969b7362927c315362c90c97ff/packages/gateway-protocol) · [版本及基础 Gateway 验证](../../establish-sdk-compatibility-governance/evidence/2026-11-18-live-gateway.md) diff --git a/openspec/changes/fix-openclaw-protocol-contracts/tasks.md b/openspec/changes/fix-openclaw-protocol-contracts/tasks.md index ec12dca..cc8bbd6 100644 --- a/openspec/changes/fix-openclaw-protocol-contracts/tasks.md +++ b/openspec/changes/fix-openclaw-protocol-contracts/tasks.md @@ -48,3 +48,5 @@ Tools Invoke 的锁定版与 2026.11.5 两轮真实回环验证及 Java DTO 差 会话历史的两版真实 Gateway 游标、增量及重置差异见 [版本评审](evidence/2026-11-19-chat-history-version-review.md)。 Responses 的两版真实 Gateway 终态及续接差异见 [版本评审](evidence/2026-11-19-responses-version-review.md)。 + +设备身份握手的两版真实 Gateway 观察与三条 Java 发行线的 hello-ok 映射差距见 [设备认证版本复评](evidence/2026-11-19-device-auth-version-review.md)。