[REQ-087] Legacy Session 边界映射完成并退出实验路径

[jinjunnn]

简明目的

把已经完成使命的 Session 可行性实验收尾：补齐少量映射和观测证据，然后删除实验开关与探针，不再继续扩张 spike。

Outcome（专业定义）

REQ-087 仅交付一份可执行的 Legacy Session 边界映射、必要的 provider/SSE 生命周期观测，以及实验资产退出方案；这些结果为 #203 的正式 Session shell 提供约束。原型 GO/NO-GO 已完成，本需求不再承担产品实现或长期性能研究。

Complexity

S — 剩余范围仅为已有 spike 的映射、计数证据和清理，不应引入新架构。

Context

#180 已完成最初可行性 spike；当前仍开放的 #268/#269 是未补齐的 side-panel/private-context 映射与 provider/SSE 计数。继续保留旧的开放式 10 条实验验收会让已过时的 spike 与 #203 正式实现重复。

Scope

• 完成 side panel、private context 与正式 adapter 边界映射。
• 记录 session/server 切换时 provider 与 SSE subscription 的基线计数。
• 指明 [REQ-088] Alpha Session Shell 稳定挂载并管理生命周期 #203 必须保留的生命周期不变量和不允许的 deep import。
• 删除或明确移交 spike host、flags、probe-only assets。

Non-goals

• 不继续开发 LegacySessionAdapter 原型或发布 legacy host。
• 不实现 Session shell、Workbench、timeline、composer 或 route composition；分别归 [REQ-088] Alpha Session Shell 稳定挂载并管理生命周期 #203/[REQ-094] Session Workbench 统一承载产物与上下文工具 #206/[REQ-089] Alpha route manifest 成为唯一的路由组合真相 #204。
• 不以“再观察一个迭代”为由保持无限期开放。
• 不保留旧页面回退或双挂载兼容。

Acceptance criteria

AC1. side panel、private context、Provider 与事件订阅均映射到明确的正式 owner 或删除结论，没有“待后续研究”的未归属边界。
AC2. session/server 切换的 provider 数量、SSE subscription 和关键注册项有可重复的基线，未出现线性累积。 —— 2026-09-17 删除(owner 裁决):计数基线的唯一消费方 REQ-088(#203)已由 owner 裁决被 REQ-125 取代并关闭,承载计数的探针已删除(#269 以前提不成立关闭),基线没有读者。
AC3. #203 可直接引用一份明确的 mount/unmount、scope 与 deep-import 约束清单。
AC4. spike host、实验 flag、probe-only asset 已从产品代码(packages/ui-mac/src)删除;packages/ui-mac/test-live/req087/ 及其脚本入口作为已知残留保留(owner 接受,不另开清理票)。 (2026-09-17 按 owner 裁决改写,原文见编辑历史)
AC5. #268 与 #269 完成后，本需求不再阻塞 #203，并按现有 REQ-087 身份关闭。

Evidence map

AC	Evidence surface
AC1	#268(已关,DONE)
AC2	已删除(见 AC2)
AC3	#268 → packages/ui-mac/src/renderer/alpha-ui/surface-seam-contract.test.ts:116 闭世界深导入清单
AC4	4f81918(#502,PR #517)删除 spike;残留 packages/ui-mac/test-live/req087/ 按裁决接受
AC5	#268 CLOSED、#269 CLOSED(not planned)、#203 CLOSED

Acceptance owner

@jinjunnn — 按 AC 逐条验收并手工关闭；PR 不得关闭父需求。

设计要点

• 只记录 [REQ-088] Alpha Session Shell 稳定挂载并管理生命周期 #203 实现真正需要的边界，不把 spike 变成第二套架构文档。
• 计数探针用于发现泄漏，完成后不默认进入产品 telemetry。
• 任何仍有价值的测试应迁到正式 capability harness，实验 UI/flag 直接删除。

潜在问题与风险

• 继续扩大 spike 会与 [REQ-088] Alpha Session Shell 稳定挂载并管理生命周期 #203 发生范围和所有权冲突。
• 只写结论不补生产生命周期计数，可能漏掉 subscription 泄漏。
• 实验资产残留会被误认为发布回退路径。

过时性与兼容性结论

原开放式 spike 已过时，当前只保留 #268/#269 的映射、观测与清理。legacy host、实验 flags 与 reload 回退不兼容保留；完成剩余证据后关闭同一 REQ，不新建替代编号。

关联与职责边界

• [REQ-088] Alpha Session Shell 稳定挂载并管理生命周期 #203 拥有正式 Session shell mount/lifecycle。
• [REQ-094] Session Workbench 统一承载产物与上下文工具 #206 拥有 Workbench container/state/discovery。
• [REQ-089] Alpha route manifest 成为唯一的路由组合真相 #204 拥有最终 route composition。
• 本票只提供一次性边界证据，不拥有任何产品 surface。

Delivery plan / 建议子票

• [REQ-087] LegacySessionAdapter feasibility spike #180 — 初始可行性 spike。
• [REQ-087][CODE] Complete side-panel and private-context cleanup/test mappings #268 — side-panel/private-context 映射与清理（已关）。
• [REQ-087][CODE] Add provider/SSE counters and server-change sampling to the session probe #269 — provider/SSE 计数与 server-change 采样。 探针已删除，2026-09-16 以前提不成立关闭。
• 产品代码中的 spike assets 已删除；test-live/req087/ 残留按 owner 2026-09-17 裁决接受，验收关闭 REQ-087。

Dependencies

• 原生依赖：[REQ-084] Alpha 页面通过窄 typed surface 接入路由 #199。
• 不再把 [REQ-088] Alpha Session Shell 稳定挂载并管理生命周期 #203 的编码激活建立在新的 GO/NO-GO 轮次上。

[jinjunnn]

需求收口(REQ-087,S41):唯一实现子项 #180 已交付并关闭(PR #239,证据见该 issue)。spike 按验收给出 CONDITIONAL GO 签署与 REQ-088 输入,原型未默认启用(AC#9/#10 满足)。按交付标准关闭为 completed。

[jinjunnn]

按 2026-07-14 逐需求独立审计(alpha-work/governance/audits/2026-07-14-s40-s49-per-requirement-audit.md),REQ-087 完整度 = partial,未满足全部原始 AC,故 reopen 并移出 Done。

核心缺口:spike CONDITIONAL GO 当日即关违反关闭语义;Electron 生产入口矩阵仍缺

处置(v2 关闭契约):残余工作以本 REQ 身份补窄 [REQ-087][CODE|VERIFY] 子票(待 triage,不换 REQ 编号)。完整 file:line 证据见审计档同名目录 REQ-087.md。父需求在全部 required 子票关闭且每条 AC 有证据 PASS 前保持 open;安全类缺口如已单列 bug 票以其为准。