refactor(frontend): 消融前端死表面与两端契约分岔——收回 136 处 0 消费者 export（13 处连实现删）+ web/desktop 4 条契约收敛到单一来源 + 21 处过期注释/路径订正（净 −119 行）

[DeliciousBuding]

这个 PR 做什么

前端消融批：把「导出但全仓 0 消费者」的公共表面收回去，并把 web / desktop 两端各抄一份、且已经分岔的契约收敛到单一来源。净 −119 行（78 文件，+327/−446）。

两条 lane 写集不相交（A：app/{shared,workbench,mobile-rn}；E：app/{web,desktop}），主机已在主 checkout 里把两条分支合到一棵树上跑完真实门禁后才开这个 PR。

A 半：死表面（app/shared、app/workbench、app/mobile-rn）

项	内容
C-4	删 34 处 export 修饰符（18 文件，实现保留）。判据：符号仅本文件内使用，全仓代码/注释/barrel/测试 0 外部消费。
C-2	删 13 个真死符号（连实现，7 文件）：BottomSheet.motion 3 个常量、theme/motion.resolveMotionTiming、hubClientTeamTypes 4 个无人消费的兼容别名、hubWS 2 个从未被引用的内部事件名常量、surfaceMetadata.getSurfaceByWebRoute、e2eDataModeContract.isE2ERequestAllowed、workbenchApprovalEvents.ApprovalJumpDetail。
P5-①	21 处过期注释/路径订正：diff.ts/index.ts 不再点名 #2151 已删除的 edge-server/internal/diff；vitest.config.ts 删掉不存在的 src/mock.ts 排除项及其编造的理由；normalizeHubMessages 的 pin 溯源注释重写为实况；14 处测试里的旧路径字面量 app/shared/src/workbench/ → app/workbench/src/；mobile-rn 去掉指向仓外一次性 lane 工件的裸 BLOCKED.md 指针。
主机补	HubWSGapPayload 头注仍点名同批删掉的 HUB_WS_GAP_EVENT，改为点名真正的投递口 HubWSHandle.onGap。

刻意没删：COMPOSER_APPROVAL_MODES（composerApprovalMode.ts:50）虽然仍 0 消费者，但 #2277 明确把它重构成「唯一来源」（从 APPROVAL_MODE_ROWS 派生）而不是删掉，属设计意图，不逆操作。

E 半：两端契约分岔（app/web、app/desktop）

项	内容
D-P1-3	执行目标清单收敛到 desktop 已有的 50×10 cursor 翻页，取满 500 并如实报 hasMore（此前 web 侧静默截断）。
D-P2-1 / D-P3-1	执行目标健康态白名单两端对齐：web 补 registered，两端去掉 | string 吸收（它会让任何拼错的态静默通过），desktop 的 online 改计入 healthy。
D-P2-3	web/hubClient.ts 删掉 shared DTO 的本地副本，不再遮蔽 SSOT 同名别名。
D-P1-4	desktop 登录页错误处理回灌 web 的 i18n 规则，不再把 err.message 直出给用户。
D-2	hubEventBridge 头注指向真实 Edge 事件入口（断链修复）。
死 export	清理写集内 102 处死 export 修饰符；其中 23 处删修饰符后暴露 no-unused-vars，连实现一起删。

真实验证（主机在主 checkout 的合并树上跑，node_modules 是真的）

$ git merge --no-ff refactor/fe-dead-surface && git merge --no-ff fix/fe-two-end-forks
78 files changed, 327 insertions(+), 446 deletions(-)

$ cd app && pnpm -r typecheck
shared / mobile-rn / workbench / web / desktop — 5 包全部 Done（1m5.8s）

$ pnpm --filter agenthub-web test        Test Files 33 passed (33)   Tests 271 passed (271)
$ pnpm --filter agenthub-desktop test    Test Files 51 passed (51)   Tests 458 passed (458)
$ pnpm --filter @agenthub/shared test    Test Files 150 passed (150) Tests 2734 passed (2734)

lane 侧各自还跑过：@agenthub/workbench 全量 168 文件 / 1717 用例通过（A 分支上，其中 RuntimeBrandIcon.test.tsx 出现过一次 vitest 池级超时，单独复跑 7/7 通过 9.12s，判定为 4 核机 worker 启动 flake）；web lint 0 problems；desktop lint 10 problems（6 errors + 4 warnings，与改前基线逐条一致，未加重，desktop lint 在 CI 里是 advisory，理由见 #2278）。

暗卷（主机自跑）：对 C-2 删掉的 13 个符号逐个 git grep -w 复核，前端侧全部 0 命中；TeamTaskDependencyState / HumanReviewState / TeamRouteAuditState / HumanReviewChange 的剩余命中全部在 hub-server/internal/model/agent_team_state.go 与 api/openapi.yaml，即被删的只是 TS 侧无人消费的兼容别名，Go 侧同名真身与其消费者不受影响。

未做 / 待裁决（不在本 PR 内）

• app/web/src/i18n/index.ts:38 的 ?? 'en'（D-6）：属 web 写集但两条 lane 都判定需要口径裁决，未动。
• desktop 汇总计数器是否补 mismatch / stale：产品裁决，未发明。
• A 的自建扫描器另外发现 320 个「导出但仅本文件内使用」 的死 export（round-68 只扫了 shared/ui + workbench，未列全）。本 PR 只处理有清单依据的那批；320 条是纯修饰符 churn，是否扩圈另开 issue 裁决。
• 6 对 web/desktop 同名「镜像」测试逐对 diff 后确认内容各不相同，不是重复副本，故 0 删除。

Refs #2274
Refs #2256
Refs #2246

[coderabbitai]

Important

Review skipped

Auto reviews are disabled on this repository. Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Team

Run ID: 4e28d2ba-727c-44ae-958c-bef43ab52c1e

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

• 🔍 Trigger review

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands.}