[tbrandenburg]

Fork 合并验收（最终授权）

本 PR 现在用于合并到 tbrandenburg/opencode-a2a:main；不是要求合并 upstream stack。用户已明确授权在验收通过后 normal merge，保留历史与贡献分支。

• Exact candidate: da51304fbfd15298e1b82f1a4311057dad1246c2；fork base 5d4700204445ce658361010cbda2fd344bc60dec。
• 本轮重新执行 doctor：1021 passed，0 failed，92.65% coverage；pre-commit/lint/format/secret scan、mypy（95 source files）、coverage policy、build/wheel smoke 通过。
• 本轮重新执行 conformance：8 passed，0 failed。
• 重新计算生产 Python source digest，与已记录 V1 1.18.19 / V2 2.0.28 live acceptance 精确一致：ecd2b57cfab3506704aeabacb8acdc58d4ddc9e6f4bd578be691536e8cf3bef8。本轮没有把历史 live evidence 说成新执行的 live run。
• 两个独立 scoped read-only reviews 未发现已确认的 HIGH/CRITICAL blocker。GitHub 当前无 review comments、无上报 CI checks，mergeable；本地 exact-head gates 是本次验收依据。
• V1 默认不变；V2 execution 仍要求 OPENCODE_API_VERSION=v2 + OPENCODE_V2_EXECUTION=exclusive。Private network/credentials/workspace、fresh upstream state、单 gateway/upstream pair 等部署前提不变。
• 计划 GitHub-only experimental fork prerelease，不发布 PyPI。[V1] 按 originating prompt 关联流式事件与 terminal 状态 #8、[OpenCode V2] 后续：非独占 session 的 input-scoped 结果、恢复与取消 #9 保持 open；[OpenCode V2][Epic] Deliver opt-in server API V2 support in five reviewable upstream PRs #1–[OpenCode V2][5/5] Finalize capability honesty, pinned V1/V2 E2E and compatibility docs #6 的 upstream/原广义 DoD 不因 fork merge 自动完成。

下面保留先前 Draft 阶段的实现/审查记录；其中“未 merge / 等待 maintainer”描述当时状态，fork 最终合并状态以本节及 merge event 为准。Upstream Intelligent-Internet#551–Intelligent-Internet#555 继续待审。

---

集成参考，不是可独立合并的 upstream PR

关联 #1、#2、#3、#4、#5、#6；保留本 PR 的既有历史与 Draft 状态，没有 force-push 或 merge。

本轮用户授权先完成 private / gateway-exclusive / single-flight profile。原始非独占 shared-session 验收没有被静默改成完成，另见 #9。V1 仍为默认；OPENCODE_API_VERSION=v2 单独选择仍 fail closed，只有额外的 OPENCODE_V2_EXECUTION=exclusive 才启用明确受限的执行路径。

已实现的受限 profile

• 一个有界 native /api/event subscriber，等待 server.connected，复用现有 HTTP client、A2A coordinator、renderer、ownership、task store 和 callback registry。
• 仅 gateway 创建的 live sessions；同 session 单飞、不同 session 可并发。成功要求 own input admission/delivery、assistant step identity、durable terminal ordering、native settlement 与精确持久化 projection。
• 独立 active-work budget、健康 idle LRU retirement、取消 barrier/原 invocation identity；不确定工作保留 quarantine，不 blind resubmit。
• REST / JSON-RPC streaming 与 unary text、连续上下文、streaming read permission once/reject、string/multiselect question form。
• principal/task/session/request 绑定、expiry、重复/跨 owner/失去观察后的 callback 拒绝；保留真实 native 204 语义。Preferred IDs 要求已提交 ownership；已保留的 model/workspace/session/directory metadata 即使是空值或错误类型也不会静默采用默认值。
• discovery/dispatch/header/OpenAPI 均只声明实际支持的 subset；attachments、request-scoped models、arbitrary tools、a2a_call、unary interventions 与 transparent replay/restart recovery 仍不可用。

实际证据

• bash ./scripts/doctor.sh：1021 passed，0 failed，92.65% coverage；typing/lint/format、critical-file coverage、build 和 built-wheel smoke 通过。
• bash ./scripts/conformance.sh：8/8 passed。
• bash ./scripts/live_opencode_v2_session_smoke.sh：默认 V2 session-only transport、Basic-auth rejection、info/location/session routes 通过，无 model prompt。
• V2 2.0.28 + 实际观察的 openai/gpt-6-luna-fast：真实 REST/JSON-RPC stream/unary、follow-up、parallel sessions、same-session serialization、local queued cancellation、active cancellation、read allow/reject、string/multiselect form、invalid/stale/cross-owner callbacks 均通过。期望输出只从 assistant artifacts 重建，不从用户回显匹配。一次 positive matrix 14 admissions / 1 global SSE。
• 真实 upstream + test-only transport fault：mid-run disconnect、dropped terminal、lost admission response、真实 provider 拒绝 synthetic invalid key、pending-form disconnect、expired callback，均为明确 non-success/拒绝；每次一个 admission、没有 blind resend。
• V1 1.18.19：仓库 streaming smoke 通过；独立扩展 matrix 12/12，包含 assistant-artifact-only output、真实 permission allow 的精确文件 side effect、reject 的原生 tool artifact/无文件、question、auth/owner 与 6/6 cancellation。另观察 46 秒后 SQLite/GetTask/event history 没有 canceled → failed/completed 覆盖。
• Live reasoning blocks：NOT VERIFIED；deterministic native mapping tests 通过，不把 provider 未返回的 reasoning 当成已验证。

完整的 sanitized record：docs/evidence/v2-exclusive-acceptance.json。
部署条件、normal/gap/unsupported paths 和可复现命令：docs/v2-exclusive-execution.md。

Review 修复

已修复 split PR 中遗漏的两个 HIGH typed-outcome / duplicate-send regressions，并追加到 Intelligent-Internet#551/Intelligent-Internet#552。受限实现独立 review 进一步发现并修复：delayed cancel 误伤 successor、poisoned lease 仍可 callback、lifetime session cap、active-work capacity、queued waiter 释放别人的 lock、SDK cancel settlement/deadlock、V1 canceled 被 late FAILED 覆盖、SSE readiness reader retention、lost intervention resolution、multiselect metadata 与不诚实的 extension activation/OpenAPI examples。最终 scoped review 没有待处理 HIGH/CRITICAL；不是“代码无任何 bug”的保证。

上游审查顺序

1. refactor: add typed upstream protocol adapter boundary Intelligent-Internet/opencode-a2a#551 — typed boundary；head 65c15e9，exact-head doctor 841 passed。
2. [Draft] feat: add opt-in OpenCode V2 session transport (stacked) Intelligent-Internet/opencode-a2a#552 — session slice；head cc8470d，exact-head doctor 890 passed；仍 stacked Draft。
3. [Draft] V2：有界 native event hub 与独占执行内核（stacked） Intelligent-Internet/opencode-a2a#553 — native engine，未接公开 execution；exact-head doctor 943 passed；stacked Draft。
4. [Draft] V2：接入独占 profile 与绑定式 interventions（stacked） Intelligent-Internet/opencode-a2a#554 — 受限 profile/intervention wiring；依赖 [Draft] V2：有界 native event hub 与独占执行内核（stacked） Intelligent-Internet/opencode-a2a#553。
5. [Draft] V2：隔离式 live acceptance、fault probes 与兼容性证据（stacked） Intelligent-Internet/opencode-a2a#555 — acceptance harness 与独立 head QA；依赖 [Draft] V2：接入独占 profile 与绑定式 interventions（stacked） Intelligent-Internet/opencode-a2a#554。

没有 PR 被自动合并，没有 tracking issue 被关闭。当前结果是受限实现与其验收完成，不是 upstream 已发布完整 V2 支持。需要 maintainer 审查 stack、明确接受 restricted scope，再决定原 epic 的最终处置。

[tbrandenburg]

已完成 fork merge / prerelease

本 PR 已 normal merge：19943955704bf05347619ca5b98addb94a683c97。Merge tree 与经过验收的 head da51304fbfd15298e1b82f1a4311057dad1246c2 完全一致，author/integration/upstream contribution 分支均保留；没有 force-push 或 upstream PR merge。

Main 再次 doctor 1021 passed / 0 failed，92.67% coverage；conformance 8/8；真实 pinned V2 session/auth smoke 通过（无 model prompt）；default/opt-in focused tests 36 passed。Recorded V1/V2 model-backed acceptance 的生产 source digest 与 main 精确一致，没有把复用记录说成新跑完整 live matrix。V1 default、V2 double opt-in 及完整 private operator boundary 不变。

已发布 1.4.1rc1+fork.v2exclusive：OpenCode V2 2.0.28 — experimental private exclusive execution。GitHub-only；非 v* tag 避免继承 workflow 的自动 PyPI 发布，未执行 PyPI publish。Wheel/sdist build/version/source identity/install smoke、runtime/dev/build audit、release download checksums 均通过；release 附 SBOM、SHA256SUMS、sanitized verification。

#2/#3 按明确 fork delivery reconciliation 关闭；#1/#4/#5/#6 保留原广义/upstream DoD，保持 open；#8/#9 保持 open。Upstream stack 的 patch-equivalent ancestry gaps 不为 cosmetic graph 改写，现状与后续验证顺序记录在 #1。Upstream contribution PR 仍待审，不代表 upstream 已发布支持。