0681ac47de
chore(gui): mission work logs — cordis design finalization, tool-card wire archive, incident records chore: missions chore: missions chore(gui): mission ledger — batch-2 answers, parallel dispatch state, jsdom coverage re-scope chore(gui): ledger — night-mode standing orders (self-commit small, no push, 5-min refresh) chore(gui): ledger — jsdom batches 2-4 landed (233 green), coverage probe next chore(gui): ledger — web-ui coverage probe 65%, four-tier fill plan approved chore(gui): ledger — cordis-impl B1 state after third API drop, decisions on file chore(gui): ledger — 01:32 patrol snapshot (jsdom tier-1 landed, coverage-fixer probed) chore(gui): ledger — 01:37 patrol (peer src trio landed, coverage-fixer still silent) chore(gui): ledger — 01:42 patrol (jsdom tier-2 landed, peer committed x2, coverage-fixer 2nd probe) chore(gui): ledger — coverage diagnosis complete (6-file gap list), web-ui at 91.4% chore(gui): ledger — 01:46 patrol (B1 done, jsdom tier-3 landed, coverage fix batch running) chore(gui): ledger — 01:51 patrol (jsdom tails x2 landed, B2 underway) chore(gui): ledger — 01:56 patrol (gateway.ts 337 lines, checkpoint T-7min) chore(gui): ledger — hold/pending split ruling, coverage-fixer externalize-or-restart ultimatum chore(gui): ledger — 02:01 patrol (B2 done, jsdom final arms, coverage ultimatum pending) chore(gui): ledger — 02:03 checkpoint executed (fixer2 respawn, four lanes released, three owners cold-started) chore(gui): ledger — all six lanes acked, type isolation first live proof (client closure clean) chore(gui): ledger — 02:08 patrol (all seven lanes active, wire carrier assembled) docs(gui): respond-design task checkpoint — apiproxy wire-layer recon done chore(gui): ledger — P0-2 contributor AGENTS.md landed (dd28a5019) docs(gui): respond-design checkpoint 2 — host-side recon (stub respond, frame types, approval seam, ACP answerer precedent) docs(gui): OOP debt inventory — seven territories, 2 real debts (createApiProxy, createFixtureApi), rest ruled keep-as-is docs(gui): disambiguation note on the archived i18n design task chore(gui): ledger — 02:12 patrol (exclude removed, mixed-knife incident under reconciliation) chore(gui): ledger — 02:15 wave (jsdom mission closed, OOP audit done, B3 isolation proof, mixed-knife resolved) chore(gui): ledger — 02:17 patrol (attribution reversal filed, arch-session probed) chore(gui): ledger — 02:22 patrol (B4 done, B5+B6 merged batch, arch-session deadline set) docs(gui): respond-design checkpoint 3 — client-side recon (pending map, PendingCard onRespond stub, AbstractApiClient.respond ready, bootHost missing approval mounts) docs(gui): peer carrier territory review — 2 fixes (SSE cancel leak, route-reservation guard), 1 ruling ask (RPC-log visibility), compliance ledger chore(gui): ledger — 02:27 (arch-shell respawn, territory review verdicts routed, ask-deny finding flagged) docs(gui): P1-5 respond design page complete — pending registry, wire answerer, client state machine, first-wins arbitration chore(gui): ledger — 02:31 patrol (respond design complete, B5 wire smoke green, shell knife 1 underway) docs(gui): respond design — add §0 status warning (web host ask defaults to deny), mount-behavior delta, no-timeout ruling with Config discipline chore(gui): ledger — 02:42 patrol (respond line closed pending review, B7 last piece underway) docs(gui): respond design contract review — direction pass, 2 doc fixes (settle-order contradiction, answering-state race), A/B/C compliance ledger docs(gui): respond design — contract review fixes (R1 verify-before-delete arbitration, R2 answering+resolved-frame transition, ask dual-source wording, rejected-is-ok-value note) chore(gui): ledger — 02:46 patrol (respond line final, two user decisions distilled, arch-shell deadline) docs(gui): respond review addendum — contract-gap ruling: approve plan A (ApprovalRequest.id), wire unchanged, drop plan B backscan chore(gui): ledger — cordis B7 summit: real-browser 10/10 green, user acceptance criterion proven docs(gui): respond design — contract gap #4 approved as plan A (ApprovalRequest.id), backscan fallback retired, blade 0 prepended docs(gui): respond design — final polish (owner-approval vs user-go-ahead wording, implementation handoff notes) chore(gui): ledger — 02:51 (shell-exec third respawn with operational script, respond line 4-knife final) chore(gui): ledger — 02:53 wave (respond five-knife true final, B7 closed 12/12, client.ts green) chore(gui): ledger — 02:56 patrol (cordis closeout bounced pending R1/R2/N1, shell-exec first sign of life) chore(gui): ledger — 03:01 patrol (R1/R2/N1 remediation in flight across four files) chore(gui): ledger — cordis line officially closed and archived, verified on disk (24 knives, 12/12, reviews closed) chore(gui): ledger — 03:06 patrol (shell-exec final window, lowered first-knife bar) chore(gui): ledger — 03:11 patrol (shell line iced-broken: three registries on disk) chore(gui): ledger — 03:15 patrol (quiet window, both active lanes within threshold) chore(gui): ledger — 03:20 patrol (shell five files up, api-proxy plan reported) chore(gui): ledger — 03:25 patrol (shell migration in flight with history-preserving moves, webserver green) chore(gui): ledger — 03:30 patrol (shell knife-1 in verification, api-proxy patching) chore(gui): ledger — shell knife 1 accepted (694cecc53), knife 2 released chore(gui): ledger — 03:40 patrol (knife 2 pre-move stage, cold-list spec appears) chore(gui): ledger — 03:45 patrol (rpclog moves staged, api-proxy two specs in flight) chore(gui): ledger — 03:54 patrol (knife-2 code done, coverage full-run final check) docs(gui): coverage-fixer task ledger — fixer2 takeover, per-file fix log, isolated reportsDirectory pitfall chore(gui): ledger — coverage lane closed and accepted (a19f069a5), the PR #443 CI fix knife chore(gui): ledger — 04:04 patrol (knife-2 calibration, sole active lane) chore(gui): ledger — shell knife 2 accepted (f8fb77b95), knife 3 released as final night task chore(gui): ledger — 04:19 patrol (knife-3 past half: callback chain through, ToolCallDetail up) chore(gui): ledger — night closeout summary: seven lanes closed, wake-up decision sheet chore: missions chore: missions chore: missions chore(gui): mission-local browser/probe verify scripts under missions/scripts/ The six acceptance/probe scripts move here as mission-side working material (headers and relative imports adjusted for the new location): carrier-errors, rpclog-panel, session, session-real, webserver-backpressure, webserver-hardening. chore(gui): verify-relocate mission log chore(gui): verify-relocate mission log — R1 guard addendum chore(gui): gates-continue mission log — CI-equivalent sequence all green chore(gui): VS Code 扩展体系双边设计调研报告 chore(gui): 调研追加 4.5 节——git 扩展数据面与 scope 绑定 docs(gui): web plugin system RFC — walkthrough + design notes docs(gui): RFC — restore existing SSE/POST as the v1 transport; envelope rides on it (D16) docs(gui): RFC — envelope demoted to chan-dispatch, scope out of envelope, rpc-log cut, peer deferred, scope tree is native cordis (D17-D21) docs(gui): RFC — hooks re-derived from component needs: useWatch/useAction only, useService removed; sessionHub cut, projections user-space, router rename, loader-only root (D22-D25) docs(gui): RFC — drop stale fork vocabulary (vendored cordis has Fiber only; scope = mintScope pattern), hook idempotence contract (D26-D27) docs(gui): RFC — session precision seam: plugins read scope key (host paradigm), React gets it from tree position via SlotOutlet (D28) docs(gui): RFC — domain hooks owned by plugins over framework primitives; useConversation paradigm carried over (D29) docs(gui): RFC — ctx services are the inter-plugin API (cordis proper); declarations are wire-only; get(id) returns scoped ctx (D30) docs(gui): RFC — full ctx.conversation walkthrough: root-singleton scope-sensitive service, caller-ctx scope key, get(key) as scoped ctx (D31) docs(gui): RFC — no client-side agents collection: session state machine already expresses the duality; agent resolution stays host authority (D32) docs(gui): RFC — v1 stays session-precision, no agent-level isolation; incarnation/agent-axis designs archived in ledger (D33) docs(gui): RFC walkthrough — full rewrite to final state (D16-D33 consolidated), end-to-end chain restored docs(gui): RFC — apiproxy demoted to generic channel routing; domain RPCs dissolve into owner plugins (D34) docs(gui): RFC — TS-interface-first wire contract (zod internal), conversation owns the dialogue frame with pluggable views (D35) docs(gui): RFC — page skeleton (sidebar+conversation), projects as plugin not service, nested slots via owner registries (D36) docs(gui): RFC — SlotMap declaration-merging slot model: single register API, inject-as-ownership, FC-typed registration, typed outlets (D37) docs(gui): RFC — slot props whitelist: identity, display params, materialized snapshot slices, stable UI callbacks (D38) docs(gui): RFC — end-to-end data flow: three transforms, equality protocol table, immer placement; i18n/theme kept standard (D39-D40) docs(gui): RFC — full external-injection model: props carry values + stable injected hooks; shared/client/react example rewritten (D41-D43) docs(gui): RFC final trio — modules.md (agent implementation spec), architecture.md (human walkthrough), plugins.md (business plugin inventory) docs(gui): RFC — props three-source merge (scope-standard useSession auto-injected); keyed key vs list id disambiguated (D44) docs(gui): RFC — inject comment says what it is (the React-facing props bundle); SessionHandle rename; snapshot-production story unified on buildSnapshot docs(gui): RFC architecture — full React component tree walkthrough: props three sources, slot vs plain children, hook taxonomy per node docs(gui): RFC — module map finalized (ui-slots/web-react/connection/runtime/ui-*/web); slots onChange replaced by cordis events; toolcall dimension; detail sidebar default-collapsed with toolName-keyed routing docs(gui): RFC plugins — openDetail relay chain: toolcard calls chat-view injected action, chat-view relays to conversation sidebar chore(gui): progress ledger — full archive rewrite: RFC outcome digest, open gaps, dispatch plan, cold-start entry docs(gui): RFC grill pass 1 — SlotScope axis (root/session) on declares, Gate dependency inversion, inject handle by scope, W5 acceptance list, gantt relay chain fixed docs(gui): figma analysis — sidebar/projects/sessions 区域交互视觉理解报告 docs(gui): figma 解析报告 — details 面板/多视图 tabs/未来功能区盘点 + slot 需求清单 docs(gui): figma 对话主区解析报告 — 消息流/tool calls 变体/审批接管输入框/Header tabs/视觉 token docs(gui): plugins.md rewritten from figma analysis — three-column layout, full slot reservation table, selection channel, composer-takeover approvals, phased scope docs(gui): layout dynamics ruled (drag+collapse both rails, details yields first, composer swap-panel, same-component transition); toolviews promoted to named scope-aware registry docs(gui): P-I scope locked (details minimal, dual theme, chat-view, custom toolview sample); teammate dispatch plan — 6 owners by package, dependency-driven waves, contract arbitration docs(gui): P-I api-contracts (full inter-package API spec) + dispatch plan (T0 skeleton knife, 7-dev roster, task briefs, milestones) docs(gui): api-contracts v2 — scope tree in P-I, bundle loader + per-plugin CSS isolation in P-I, agent-scoped toolviews live, zustand engine, renames (SessionProvider/ObservableSnapshot/SessionBinding), router owns all shell view-state docs(gui): services roster + progressive loading (no blocking loadAll), SlotsService as real cordis Service, renderSlot/renderSuspenseSlot duo, ui-traj teammate docs(gui): loading-chain gaps ruled — dev=rebundle no HMR, ui-primitives package, externals on globals (no import map), host injects __DSH_BOOT__ into HTML (zero round-trip) docs(gui): api-contracts v3 + dispatch v2 final — 12 packages, services merged in, progressive loader, global externals, __DSH_BOOT__ injection, 8-dev roster with convo split and ui-traj docs(gui): v3 amendments — router renamed ctx.layout, ui-trajectory has no service (pure consumer sample), wait-for-settled loading (no Suspense in P-I, ledger 6b) chore(gui): progress — pre-compact final state: v3 revision chain, 8-dev roster, T0 procedure, doc authority order docs(gui): authority banners — modules/architecture get v3 term-mapping headers, walkthrough marked as archived process doc docs(gui): cssdesign token set is THE theme source (--dsw-* variables, data-ds-dark-theme switch); recorded in contracts + progress docs(gui): architecture.md full v3 rewrite — loading chain, 12-package map, service roster, slot/inject/toolviews, data flow, component tree, perf model, all current docs(gui): contracts — UI plugins are dual-entry host plugins (node half serves client asset via ctx.webPlugins; __DSH_BOOT__ derives from it; client-closure gate back in scope) docs(gui): contracts — closure-factory bundles with DI require (no globals), package.json dshWeb declarative discovery (no serve ritual), create-then-send empty state with project picker, ancestry() for breadcrumb, unload stubbed until HMR, props.renderSlot confirmed docs(gui): dshClient declaration (inject/platform/immediately, exports./client), closure-DI require loading — synced across contracts/dispatch/modules/architecture/walkthrough chore(gui): progress — record final loading-chain rulings (dshClient declaration, closure-DI require, startSession) before compact docs(gui): architecture.md — developer-facing whole-web architecture on master baseline 6b16a67cb: what exists, what is new, no process narrative docs(gui): architecture.md — self-contained whole-web architecture: absorbs still-valid substance from the branch RFCs (host layering, four-quadrant RPC, object layer, testing tiers) under the new plugin system as the override chore(gui): progress — final pre-compact snapshot: contracts digest, apiproxy purity ruling, T0 procedure with first-action list docs(gui): api-contracts v3 §3.1 — apiproxy purity principle with three-way existing-code verdicts docs(gui): api-contracts v3 — immediately reinterpreted as static-infra group (8-package dshClient scope, boot manifest reconciliation) docs(gui): api-contracts v3 — immediately corrected to early-load dynamic group (prod shell must not rebundle); loader shell-held; bundles register their export surface into module table docs(gui): architecture — align with immediately=early-load dynamic group ruling; loader shell-held; module-table registration of loaded bundles docs(gui): T0 checklist — 12-package skeleton table, 4-cut sequence, mv/attic/rewire rules (pre-drafted, awaiting go) docs(gui): t0-checklist — pin figma-flows findings (missing font-family base vars, three alias vars behind upstream) docs(gui): dispatch v2.1 — drop cordis-web salvage wording, two-wave staffing, loader/immediately boundary updates docs(gui): progress + t0-checklist ledger — T0 landed, staffing status, execution accounting docs(gui): api-contracts v3 — arbitration round 1: renderBody deps, RootBindingProvider, flush default sync, prune current, loader subpath, config-source P-I bar docs(gui): v3 §3.2 connection 导出清单附录（rt-core 对账）+ rt-core 实现计划档案 docs(gui): progress — T1 milestone, arbitration round 1 ledger, fw-react timeout escalation docs(gui): progress rolling update — per-line battlefield state at 00:2x, mailbox-vs-contract lesson, small-batch discipline reinforced docs(gui): fw-react notes — v3 §2 complete, seven knives, T1/T2 follow-ups docs(fw-slots): archive — four packages landed, open tails logged docs(gui): progress — framework layer complete (web-react five, fw-slots four packages), T2 gated on rt-core runtime knife only docs: api-contracts docs: style-spec docs docs(gui): tsconfig convergence ruling — no host.json, root resumes host-aggregate duty, typecheck = root + client aggregates docs(gui): missions 根三份 07-18 世代档案加「已被取代」头注——指向 web-plugin-rfc 现行权威并注明新旧对应 missions docs(gui): progress rewritten for post-closeout state — wave ledger, architecture finale, teammate roster with handover notes, pending-user-command queue
52 lines
7.2 KiB
Markdown
52 lines
7.2 KiB
Markdown
# web smoke 测试（client 组包三层测试体系）
|
||
|
||
> owner：web-test（常驻）。口径升级（2026-07-20 16:0x team-lead 转述用户）：三层——①fetch/SSE 协议较强覆盖；②session/connection 对象层编排式测试；③React 层最简浏览器冒烟。
|
||
|
||
## 三层落点（全部零新依赖）
|
||
|
||
| 层 | 文件 | 车道 | 用例 |
|
||
|---|---|---|---|
|
||
| 1 协议载体 | `packages/host/apiproxy/tests/client-handler.spec.ts` | 根 vitest include 天然扫到；窄循环 `test:gui` | 17：unary 往返/业务错 200/rpcId 失配 throw/zod 拒收/method-path 失配/坏信封空 rpcId/404/400/500/超时/SSE 顺序+注释行/跨 chunk 重组/mid-stream throw→stream/error/abort 停流/respond 往返+坏形/tap 合批+throw 隔离+零订阅+退订 |
|
||
| 2 对象层 | `packages/client/web-runtime/tests/{session,manager,connection}.spec.ts` + `fake-api.ts`（可编程 IApiClient+deferred 控时序+流手泵）+ `event-script.ts`（事件构造器） | 同上 | 34：open 状态机/幂等/错误折叠/liveBuffer 缝合去重/chunk→partial→定稿/中断冻结（partial+孤儿 tool call）/seq 洞修复重拉/翻页锚定+断层 fail-soft+防重入/乐观清稿恢复/重入丢弃/pending 增删/resync generation 守卫/引用稳定 toBe/manager 懒建常驻+pending 缓冲重放+list 单飞+host 四帧路由+handleConnected 只 resync 已开/connection 就绪握手+断流重连+describe 失败重试+stream/error 收敛+sink 隔离+stop 停环 |
|
||
| 3 浏览器 smoke | `apps/web/tests/smoke-{fixture,real}.e2e.ts` + `support.ts`、`vitest.web.config.ts` | `test:web`（独立 config，先重建 dist） | 4：fixture 起页+一轮对话+零 /api+零 pageerror；真 host 起 dsc web+真模型一轮（skipIf 无 key） |
|
||
|
||
npm scripts：`test:gui`（1+2 层窄循环，~1s）、`test:web`（3 层）。**coverage 处置**：根 vitest.config.ts coverage.exclude 加 `packages/client/*/src/**`（pr-gates 拍板「client 显式排除」的机械落地）；host/apiproxy src 被 1 层测试拉进 per-file 100% 门后的补齐属 pr-gates 既定活。
|
||
|
||
## 对表状态（已全部闭环 2026-07-20 17:1x）
|
||
|
||
- **arch-carrier**：五问逐答收到（f720e8847/5a880f202 = 终态），闭环确认无异议。落盘行为全钉：A4 rpcId 抢救/'invalid-request' 哨兵双分支、A2 S→C 值域二级 parse throw + SSE 坏帧三型丢弃不杀流、A1 stream/error 两层分工（载体层断帧到达、connection 层断收敛重连）、onOpen 时机四断言、外部 signal abort（reason 传递）。他的 verify-carrier-errors.mjs 与 vitest 两车道互补不收编。
|
||
- **arch-session**：两条对表（S3/S4/S5 + C2/C1 增量）收到并闭环确认。他点名的 vitest 独有断言全钉：pendingBuffers 上限 32 保最新+removed 清 buffer、createEnvelopeIngest 闭包隔离（同 rpcId 双实例不串味/id 各起/orphan→'(unknown)'）、S5 四面引用稳定、C2 严格握手（holdStreamOpen 手控就绪窗口：describe ok 双流未 establish 时 onConnected 必须等；suppressStreamOpen→超时兜底不 wedge）、onStateChange 去重序列。**分工定型**：verify 脚本管浏览器黑盒回归，vitest 管数据层语义一等断言；他后续行为刀会在落盘回执附「对表增量」直接点我。
|
||
|
||
## 踩坑记录
|
||
|
||
1. apps/web/tests 在根 tsconfig include 外 → vite-tsconfig-paths 不映射 → vitest.web.config resolve.alias 一条解决。
|
||
2. temp-cwd 下 tsx 双重失效：包名不可解析（createRequire(REPO_ROOT) 解析绝对 loader URL）+ tsconfig paths 丢（TSX_TSCONFIG_PATH 指回仓库根）。
|
||
3. 真回复提示词要求 ~100 字防 pulse 竞态假红（verify-session-real 教训）。
|
||
4. `pnpm run typecheck` 对 client/host 包本有 26 处 TS6307（根 tsconfig references 未含 client/host 项目——构型批在途活），我的 4 处同源新增不另修，构型批并 references 后自愈。
|
||
5. InProcessApiClient 下 caller abort 表现为流正常结束而非 fetch reject（无真网络）；测试两态兼容。
|
||
6. SessionListEntry 是平铺 `{...summary, depth}` 不是 `{summary}` 包裹。
|
||
|
||
## coverage 复核（2026-07-20 17:2x-18:1x，用户命题「client 排除能否取消」）
|
||
|
||
**判定：web-runtime → a 档（可开），web-ui → b 档（维持排除，我任长期 owner）。**
|
||
|
||
实测基线（62 用例时）：web-runtime 整体 65%/63%（session 93、manager 87、connection 97、纯函数件 50-75、boot/intents/fixture/web-api-client 全 0）；web-ui 24 文件全 0（React 层，无 jsdom 基建，组件将大改——结构性缺口，前置条件=组件重做完成+RTL 基建决策（新依赖需用户点头））。
|
||
|
||
补齐动作（冻结期工作区，+6 个新 spec：partial/lineage/notifier/api-helpers/boot-intents/fixture/preinit + 3 个既有 spec 扩容；web-runtime 用例 62→125，test:gui 全量 149）。终态 **99.5%/97.3%**，残余 12 处全部为防御性不可达臂（逐条核实）：
|
||
- session.ts 175/316/371、manager.ts 92：`transportError` 恒 ok:false 的 `folded.ok?` 防御臂、`older[0]?.seq ??` 空数组臂、repairGap 重入卫（acceptLiveEvent 已先挡）。
|
||
- connection.ts 101-102：Promise executor 同步替换的占位箭头函数。
|
||
- fixture.ts 81/229/285/346：稠密日志的稀疏卫、非空串 match 的 null 臂、steer 前置已保证的 `?? 1`、gamma 恒在的 `!== undefined`。
|
||
- rpc-log.ts 45：非空 Map 首键恒非 undefined。
|
||
- fold-adapter.ts 32/58/126：materializeNode default 臂（surface-eligible 过滤后不可达）+ padded 稀疏卫。
|
||
|
||
**已收官（de2180d76）**：main 授权（annotation-only 豁免）后 12 处 `/* v8 ignore -- reason */` 已注（含 connection.ts 双占位箭头需拆两条单行 ignore 的坑——`next 2` 不剥第二个箭头的函数计数）；探针实测 941/941 stmts + 389/389 branches per-file 100% 过门；exclude 已收窄为 `packages/client/web-ui/src/**`；全仓 test:coverage 零 client 阈值报错。临时探针 config 已删。收官时发现 `compact-basic/tests/loader-composition.spec.ts` 1 例 5s 超时——**stash 验证与我的改动无关**（干净树同样红，环境性慢），已按「记台账不追修」口径入账。
|
||
|
||
**web-ui 缺口档案**（b 档长期表）：24 文件全 0；分层=components/*（17 个 tsx，等组件重做）、hooks/*（useConversation/useSessionList，uSES 接线，RTL 后可测）、utils/*（formatRelative/renderProbe/theme，纯函数，RTL 无关**随时可补**）、App/index（装配，跟组件走）。触发条件：组件重做完成 → 先补 utils 纯函数与 hooks，再议组件层。
|
||
|
||
## 验证记录（2026-07-20 终态）
|
||
|
||
- `pnpm run test:gui`：5 文件 62 用例全绿 ~1.2s（apiproxy 21 + session 22 + manager 8 + connection 9 + rpc-log 2；均对两位 arch 落盘终态验证）。
|
||
- `pnpm run test:web`：build+4 用例全绿 ~8s（含真模型一轮）；keyless 下 real 自跳。
|
||
- commit 链：e561e7e0a（3 层）→ c945b4ae9（1/2 层 +1070 行）→ d04f5d018（carrier A1/A2/A4 终态钉）→ 7130f3658（C2 严格握手对齐+S5 子结构）→ ddf681aa0（pendingBuffers 上限/held 握手窗口）→ cb767aa1e（rpc-log 隔离）。
|
||
- 期间两次「teammate 落盘打红我用例」均当场校准（A4 空串→哨兵、C2 grace→严格握手），印证「落盘代码即答案」的对表工作流。
|