Coder/deepseek-harness
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
0ab49fa4566f8f3d6f0596cae1fb35b9c36d30a8
deepseek-harness/missions/tasks/20260721-0041-web-agents-md
History
imccyu 0681ac47de chore(gui): mission work logs 
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
2026-07-22 21:30:30 +08:00
..
README.md
chore(gui): mission work logs
2026-07-22 21:30:30 +08:00

README.md

P0-2 Web 贡献者规范 packages/client/AGENTS.md — 任务档

  • 派发：夜间自动化（progress.md 〇-pre；决策 #4 用户亲拍：英文 AGENTS.md + 中文摘要供 review）。执行人 i18n-design（i18n 任务封存中人力复用）。
  • 交付物：① packages/client/AGENTS.md（英文，体裁对齐仓内 AGENTS.md 惯例：短句、可执行、链接不复述）；② 本 README 附中文摘要。一刀 commit：docs(client): contributor AGENTS.md for the web stack，不 push。
  • 红线：不写任何「TUI 环境红」等自家环境问题（用户令）；批间清收件箱（硬前置）。

内容清单（派发单六条 → 成文结构）

  1. 分层红线：web-runtime 对象层 / hooks 纯数据层 / 纯 props 组件三层；store 无业务对象；Notifier 双通道；web 纯呈现层不进 session log——自 conventions 架构红线节提炼英文化。
  2. 目录约定：两级制 leftmenu/<bar>/、sessiontabs/<tab>/——以 arch-session 的 app-shell design（missions/tasks/20260721-0041-app-shell/design.md，已落盘）为准。
  3. 样式：token 体系，引 docs/web-styling.md。
  4. 测试与门禁：test:gui 窄循环 / test:web / check:pre-push；jsdom=E2E 行为定位不追覆盖率；web-ui 在 coverage exclude 的口径；新组件配最小 spec。
  5. 新组件 checklist：认领坑位→建目录→组件+spec→跑窄循环→commit 规矩。
  6. 链接：三篇 GUI Agent Notes（gui-layering-and-rpc-protocol / gui-web-client-architecture / web-styling-system）+ 测试 RFC（gui-testing-system）。

素材核实记录

  • app-shell design 已落盘（20260721-0041-app-shell/design.md）：两级制目录、三注册表（leftMenu/sessionTab/detail）、互不 import 规矩、共享件下沉 components/。
  • 门禁命令核实：package.json test:gui（vitest packages/client packages/host）、test:web（先 build dist 再 vitest.web.config）、check:pre-push（run-gates pre-push）。
  • coverage 口径核实：vitest.config.ts exclude packages/client/web-ui/src/**（注释：组件重做前暂缓，jsdom 车道已存在）；web-runtime 全量 per-file 100%。
  • spec 模板已存在：missions/tasks/20260721-0010-gate-friendly/component.spec.tsx.template（P0-3 产物，AGENTS.md 指向它的正式落点等 P0-3 定，先按模板现位引）。
  • verify 脚本惯例：scripts/verify-*.mjs（browser 黑盒回归，每 bug 钉断言）。
  • Notifier 双通道：web-runtime/src/session/notifier.ts（markDirty 合批 / notifyNow 手势直达）。

工作日志

  • 0041 接单，清收件箱（无积压），盘素材：progress.md 〇-pre、app-shell design、vitest 配置、testing note、web-styling、spec 模板。
  • 0052 README 落盘。

中文摘要（供用户 review；对应 packages/client/AGENTS.md 六节）

定位：packages/client/*（+构建入口 apps/web）的贡献者规范，英文、agent-readable，补充根 AGENTS.md 与 packages/README.md，不复述链接目标内容。

  1. 分层红线：三层单向知晓——web-runtime 对象层（React-free，grep 可断言）→ hooks 纯数据层（uSES 订快照，无 JSX）→ 纯 props 展示组件（耗材可整体重写）。四条不可谈判：store 无业务对象（zustand 只装跨视图呈现态，视图局部事实进组件 state）；rpcId 严格双向（发起方 mint、业务签名只见 RpcRequest

    ）；Notifier 双通道（notifyNow 仅用户手势直接回响，帧驱动一律 markDirty 合批）；web 纯呈现层（「怎么画」不进 session log，host 现算随帧下发，重放重算）。

  2. 目录两级制（对齐 app-shell design 词汇）：shell/（壳+三注册表+builtins）、leftmenu/<bar>/、sessiontabs/<tab>/、components/（共享叶）、hooks/ utils/ style/（横切）。互不 import（跨功能共享下沉 components/）；bar/tab/detail 块走 shell 注册表（register 返 disposer，toolCardRegistry 同构，将来插件纯加法）；坑位认领流程：挑 placeholder tab→建目录→换掉占位组件，不许在体制外造功能。
  3. 样式：docs/web-styling.md 权威；token 住 global.css，组件 CSS 只引 token 零字面量色值；CSS Modules+clsx、无组件库无 tailwind；产品文案中文、注释英文。
  4. 测试与覆盖率（新口径）：两个 client 包都进 per-file 100% 门——web-runtime 走 node 套件、web-ui 走 jsdom 车道；防御臂 /* v8 ignore -- <reason> */ 必带真理由。web-ui spec=端到端行为核验非单测（真实 props 渲染断用户所见，不断 class/hook 内部/渲染次数——行为形 spec 经得起组件重写）；jsdom 走 per-file pragma；分层断言纪律（数据层语义归 web-runtime/apiproxy 套件，浏览器黑盒归 verify 脚本，每个浏览器可见 bug 修复钉断言进 verify）。
  5. 三级检查阶梯：改 GUI 码=test:gui（秒级内环）；动构建面/boot/静态承载=加 test:web（重建 dist+浏览器 smoke 对）；PR 前=check:pre-push（窗口间不要求每 commit 跑）。别人的红不默修不默过，记 handoff 等 PR 窗口清算。
  6. 新组件 checklist 六步：认领坑位→容器进功能目录（叶子纯 props、数据走 hooks 层）→抄邻近 jsdom spec（一条 happy path+一条边界即完整首版）→token/中文文案/英文注释→test:gui 绿（动构建面加 test:web）→非平凡改动同 PR 配 Agent Note。

供稿处理：web-test 两节（agents-md-contribution.md）已融入；其 Section A 前两条（旧「exclude 长期化」口径）按 main 检查点新口径改写，已知会 web-test。

工作日志（续）

  • 0104 收全停令系列四单，冻结在 README 态。
  • 0203 检查点放行（P0-2+P0-3 合刀），开工回执。
  • 0206 核对新口径：vitest.config.ts exclude 已只剩 web-ui/src/index.tsx（jsdom-e2e 线口径变更记录一致）；web-test 供稿覆盖率两条须改写。
  • 0209 AGENTS.md 本体落盘（英文六节）；回执 main+知会 web-test。
  • 0212 中文摘要落盘本 README；下一步 commit。
  • 0224 main 补令：目录节加时态说明。盘面核实 shell/leftmenu/sessiontabs 尚未建目录（壳三刀在途），AGENTS.md 目录节加「Shell restructure in progress; tree converges to this layout」一行；amend 进原刀（未 push，历史安全）。
  • 0241 web-test 点出残留：checklist 第 3 步「one happy path + one edge state is a complete first spec」是旧口径（01:3x 升级前）；改写为「start from happy path/edges, widen until branches covered — coverage gate applies, assertion style stays behavior-level」。
Reference in New Issue View Git Blame Copy Permalink