feat(client): 收敛重复实现（api envelope/extOf/lineage/错误归一化）并删除死代码

[Menghuan1918]

概述

行为不变的纯重构流（仅 SubagentView 两处日志级别按计划 warn→error 对齐）：六项去重中的四项落地为 4 个 commit，收敛五处重复实现并删除一处死代码。tests/ 零改动（无断言修改），既有测试全部原样通过。

各项 before/after

1. api envelope 解析收敛（857646e）

• before：src/client/api.ts 的 call() 与 fetchUpload() 各持一份逐字相同的 envelope 解析（response.json().catch(() => null) + !ok || parsed === null || parsed.ok !== true || parsed.value === undefined 判断 + 同款 SidebarApiError 构造）。
• after：私有 readEnvelope<T>(response) 一份实现，两处 return readEnvelope<T>(response)。判断顺序、parsed?.error?.code ?? 'http' / HTTP <status> 回退逐字保留。

2. 取扩展名双实现收敛（857646e）

• before：lang.ts 的 extOf 与 service.ts 模块私有的 extOfPath 函数体相同。
• after：实现迁至零依赖的 paths.ts；lang.ts re-export extOf 保持既有导入面（tests/file-types.spec.ts 从 lang.ts 导入）；service.ts 删除 extOfPath，matchFileViewer 改用 extOf。
• 方向论证：service.ts → lang.ts 不可行——lang.ts 携带全部 @codemirror/* 依赖且只经 editor 懒加载 chunk 进入浏览器，core bundle 静态引用会把 CodeMirror 拉进核心包（违反懒加载 chunk 约束）；反向（lang→service）会把整个 service 内联进 editor chunk。故落位基础模块 paths.ts。构建产物已验证：client.js / client-registry.js 中 codemirror 引用为 0，client-editor.js 不变。

3. lineage 遍历收敛（69cc801）

• before：rootAncestor / countSubagentDescendants（subagent-detect.ts）与 treeSessionIds（subagent-jobs.ts）三份「沿 subagent-origin 链上行 + seen 防环 fail-soft」walk。
• after：新模块 src/client/subagent-lineage.ts 持有唯一核心生成器 subagentOriginChain()（seen 防环，仅在节点为 subagent 且有 parent 时前行）；三函数迁入并基于它重写；isSideThreadSummary 一并迁入（countSubagentDescendants 依赖它，避免 detect↔lineage 循环依赖）；subagent-detect.ts / subagent-jobs.ts re-export 全部迁出符号——既有 import 调用点零变化。
• 语义等价性论证（逐函数，含 fail-soft 边界）：
  • rootAncestor：链为空 → start.id（原循环条件不满足时返回 current?.id，同一行）；链非空 → byId[末节点.parentId]?.id ?? sessionId（原循环退出时 current 恰为该行；断链/父行缺失回退 sessionId 不变；环路径下两者同在 seen 处截止，返回同一行）。
  • countSubagentDescendants：生成器在 seen.add 后 yield，消费方判 parentId === sessionId 即 break——与原循环体判断顺序一致；descendant.running 判定与 side-thread 过滤位置不变。
  • treeSessionIds：原实现的成员判定是「上行 walk 访问到的某行 id === rootId」，访问集恒为 byId 中真实存在的行，故根行缺失时提前返回空集等价；根行自身（通常非 subagent）经 summary.id === rootId 特判入集（对应原首轮访问判定）；其余行经「链节点 parentId === rootId」判定，与「上行走到 id === rootId 的行」指向同一行（链节点斜上一步的 next 行）。
• 与背景描述的偏差（按实际证据处置）：directSubagentCount 是直接子行的单层过滤，没有上行 walk，无共享逻辑，不迁移；collectBranchIds 遍历 catalog 结构而非 session 链，不动。

4. GitLens 错误归一化 + SubagentView 日志分级（4002f3c）

• before：GitLens.tsx 六处 catch (reason) { … reason instanceof Error ? reason.message : String(reason) … }（refreshTarget / refresh / loadMoreLog / commit / checkout / runConfirmed）；SubagentView.tsx 两处同严重度失败用 console.warn。
• after：模块级 errorMessage(reason) 一份，六处复用（含两处 t('historyLoadError')/t('checkoutError') 前缀的模板插值）；console.warn → console.error，与 Sidebar.tsx（tab badge）、TerminalView.tsx（xterm open）、service.ts（urlTarget / plugin callback）对齐。前缀 [dsh-better-sidebar] 与消息文本不变；tests/ 无钉 console.warn 的断言（已核实）。

5. 死代码删除（bc1984b）

• src/sidechat-core.ts 的 sidechatSeed()：src+tests 全仓零引用（含 re-export 面核查，仓库无 export * barrel），删除。SeedEvent / copyEvents 仍被 SidechatInheritance 使用，保留。

测试证据

检查	结果
pnpm typecheck	✅ 通过
pnpm build（tsc + tsdown 全产物）	✅ 通过；core bundle 无 codemirror 泄漏
pnpm test（vitest 全量）	✅ 118 files / 1241 passed / 9 skipped（既有 skip），exit 0
指定套件单独复跑（subagent-detect / subagent-jobs / subagent-jobs-view / git / git-view-worktree / api-surface / sidechat-core / sidechat-seed-validation + file-types）	✅ 9 files / 73 tests 全绿，断言零改动
pnpm check:consumer-types	✅ 通过（service.ts 有改动故按规则执行）

tests/ 目录零文件改动（git diff --name-only | grep ^tests/ 为空）。