mnote/design/05-editor-mainline/process/5-29-editor-runtime-followup-checklist-v1.md

5-29 Editor Runtime 后续收口 Checklist v1

创建时间：2026-05-25 状态：process 来源：承接 design/05-editor-mainline/done/5-28-leptos-tiptap-editor-runtime-module-extraction-v1.md 的后续未专项完成项。

1. 目标

在 5-28 已完成附件链接、history-safe delete、command sync、persistence、attachment upload intent 首批拆分后，继续把 editor runtime 的 selection / overlay / block menu / mindmap node view 切成可索引模块。Codex 维护本文件作为事实源，Reasonix 只做短批次审计、窄范围实现或浏览器 smoke；每批最多 2 个 worker。

2. 本轮边界

本轮优先处理：

• editor_runtime/dom_selection.rs 第一刀。
• overlay / block menu 后续切片的只读审计。
• 仍使用 HTML 整文替换的用户编辑路径风险复核，例如块手柄拖拽重排和复制副本。
• task488 / task489 / task479 作为回归基线。

本轮不处理：

• shell host resource open / local upload 落盘语义；这些归 3-20。
• Page AI 流式 apply / review session。
• mindmap 事实源重构；本轮最多审计 node view 拆分边界。

3. Batch A 候选任务

• Worker A：实现 dom_selection.rs 第一刀。
  • 允许修改：rust/spikes/leptos-tiptap-spike/src/lib.rs、rust/spikes/leptos-tiptap-spike/src/editor_runtime/mod.rs、新增 rust/spikes/leptos-tiptap-spike/src/editor_runtime/dom_selection.rs。
  • 目标函数：active_editor_text_selection、selection_summary、has_active_text_selection、selection_has_rich_marks，以及必要的 selection payload helper。
  • 禁止：迁出 block menu DOM、overlay state、host bridge、resource open。
• Worker B：只读审计 overlay / block menu 拆分。
  • 目标：列出强依赖 Leptos signal 的函数，判断是否先抽 context struct 或先迁纯 helper。
  • 输出：下一刀最小实现范围和 smoke 建议。
• Worker C：只读审计剩余 HTML 整文替换用户编辑路径。
  • 目标：查 set_content、apply_html_update、apply_document_update 的用户触发链路，列出可迁 Tiptap command/transaction 的候选。
  • 输出：风险表和建议 RED smoke。
• Worker D：浏览器 smoke 审计 editor runtime 基线。
  • 目标：只读运行或复核 task488、task489、task479，截图/结果证明附件删除和块菜单删除 undo/redo 仍可用。
  • 输出：result.json、截图、console/network；不修改源码。

4. 验收命令

cargo fmt --manifest-path rust/Cargo.toml --all --check
cargo check --manifest-path rust/spikes/leptos-tiptap-spike/Cargo.toml
cargo build --manifest-path rust/spikes/leptos-tiptap-spike/Cargo.toml --target wasm32-unknown-unknown --release
wasm-bindgen rust/spikes/leptos-tiptap-spike/target/wasm32-unknown-unknown/release/mnote_leptos_tiptap_spike.wasm --target web --out-dir rust/spikes/leptos-tiptap-spike/generated/island --out-name mnote-leptos-tiptap-spike-island
node scripts/task488-local-attachment-link-delete-undo-smoke.js
node scripts/task489-block-menu-delete-undo-smoke.js
node scripts/task479-local-folder-markdown-resource-lifecycle-smoke.js

UI / 浏览器可见项必须有真实浏览器截图或结构化 smoke 证据。

5. 采纳规则

• Reasonix 结果必须先查 Hindsight reasonix recall，再读 process-handoff.md/json、result.json、diff 和验证证据。
• 实现 worker 只能改允许范围；只读和 smoke worker 必须没有源码 diff。
• lib.rs 不能新增附件/history/DOM bridge 大块逻辑。
• 本文件只记录真实完成项；未验证项保持未勾选。

6. 本轮执行记录

• 2026-05-25：Codex 创建本续跑事实源。
• 2026-05-25：Worker A 未继续派发；Codex 主控已在主工作区完成 dom_selection.rs 第一刀并提交 c7ab4e56 refactor: extract editor dom selection runtime。
  • 已迁函数：node_is_within_root、active_editor_text_selection、has_active_text_selection、selection_summary、selection_has_rich_marks。
  • 未迁：SelectionPayload、selection_payload、send_selection_state*、selection_event_payload，原因是仍依赖 bridge event、HoveredBlockState 和 runtime block id 边界。
  • 已验证：cargo fmt --manifest-path rust/Cargo.toml --all --check、cargo check --manifest-path rust/spikes/leptos-tiptap-spike/Cargo.toml、wasm release build、wasm-bindgen、task488、task489、CodeGraph pending 0。
• 2026-05-25：执行口径修正：继续遵循当前 goal 的“每批最多 2 个 worker”；Reasonix 后续必须使用独立 worktree 或明确只读任务，完成后由 Codex 读取 handoff 并复核。
• 2026-05-25：Reasonix runner 异常：后续实现 run 未写 result.json、process-handoff.md/json，部分 transcript 停在工具调用阶段；Codex 不采纳其文字结论，只复核实际 diff。
• 2026-05-25：Reasonix overlay / block menu 只读审计尝试未产生 result.json / process-handoff，且运行期间出现额外 Batch A2 runner，主控已终止进程；该结果不作为正式 handoff 采纳。
  • transcript 只显示探索过程，未形成函数归属表；下一次应改为更窄的单问题只读任务，例如只审计 floating_toolbar_anchor_from_selection / sync_text_selection_overlay 能否迁入 overlays.rs。
• 2026-05-25：Codex 主控直接完成 overlay 第一刀：新增 editor_runtime/overlays.rs，迁出 FloatingToolbarAnchor、floating_toolbar_anchor_from_selection、sync_text_selection_overlay。
  • 未迁：sync_editor_overlay_state / try_sync_editor_overlay_state，原因是仍依赖 HoveredBlockState、slash/block menu signal 和 overlay 关闭策略。
  • 已验证：cargo fmt --manifest-path rust/Cargo.toml --all --check、cargo check --manifest-path rust/spikes/leptos-tiptap-spike/Cargo.toml、wasm release build、wasm-bindgen、node scripts/task488-local-attachment-link-delete-undo-smoke.js、node scripts/task489-block-menu-delete-undo-smoke.js。
  • 运行中再次出现额外 Batch A2 Reasonix runner，主控已终止；这些 runner 未作为本批证据。
• 2026-05-25：采纳并复核 Worker B 候选 patch：新增 editor_runtime/block_menu_legacy_html.rs，迁出 duplicate_top_level_block_html、reorder_top_level_block_html；lib.rs 仅保留调用点和 DropPlacement 的 pub(crate) 可见性。
  • Reasonix run：reasonix-2026-05-24T17-07-59-603Z-bfe72d77，已读取 Hindsight recall、process-handoff.md/json、diff，并由 Codex 独立复核。
  • Codex 合入时保持实现逻辑同构，仅收口模块边界和 checklist 事实记录。
  • 已验证：cargo fmt --manifest-path rust/Cargo.toml --all --check、cargo check --manifest-path rust/spikes/leptos-tiptap-spike/Cargo.toml、wasm release build、wasm-bindgen、node scripts/task488-local-attachment-link-delete-undo-smoke.js、node scripts/task489-block-menu-delete-undo-smoke.js。
  • 未完成：HTML 整文替换仍是 legacy 路径，后续要用 history-safe Tiptap command 替换；sync_editor_overlay_state、block menu signal 仍未拆出。
• 2026-05-25：复跑浏览器 smoke 后修正上一条验收口径：task488 通过，但 task489-block-menu-delete-undo-smoke 连续两次失败，失败点是块菜单删除后 Control+Z 未恢复 Beta block。
  • 证据：tmp/task489-block-menu-delete-undo-smoke/result.json、tmp/task489-block-menu-delete-undo-smoke/failure.png。
  • 已登记缺陷：bugs/05-editor-mainline/done/5-39-block-menu-delete-undo-regression-v1.md。
  • Worker E（reasonix-2026-05-24T17-34-41-774Z-85427058）已在独立 worktree /mnt/Data1T/mnote-worktrees/0525-b3-block-delete-undo 派发修复任务，但 runner 仅产出 prompt.md / memory-recall.json / reasonix-transcript.jsonl，无 final.md、result.json、process-handoff.md/json，worktree 无 diff，拒绝采纳。
  • 当前结论：5-29 仍未完成；下一步应先定位 delete_top_level_block_with_history、sync_persisted_editor_command、editor focus / undo keydown 之间的真实断点，再修复。
• 2026-05-25：Codex 主控修复 5-39：块菜单删除成功并关闭菜单状态后追加一次 editor.focus()，确保 Control+Z 进入 ProseMirror；缺陷文档已移到 bugs/05-editor-mainline/done/5-39-block-menu-delete-undo-regression-v1.md。
  • 同批新增 editor_runtime/block_menu_document.rs，迁出未走当前运行路径的 legacy 顶层块 JSON helper：duplicate_top_level_block、delete_top_level_block、reorder_top_level_block；replace_top_level_block_kind 暂不迁，因仍依赖 slash action、mindmap 和 image placeholder 语义。
  • 已验证：cargo fmt --manifest-path rust/Cargo.toml --all --check、cargo check --manifest-path rust/spikes/leptos-tiptap-spike/Cargo.toml、wasm release build、wasm-bindgen、node scripts/task489-block-menu-delete-undo-smoke.js、node scripts/task488-local-attachment-link-delete-undo-smoke.js。
  • 未覆盖：cargo test --manifest-path rust/spikes/leptos-tiptap-spike/Cargo.toml block_menu_document -- --test-threads=1 被既有 STYLE 测试编译错误阻断，未进入本次新增 helper 测试。
• 2026-05-25：根据用户纠正，后续 B/C/D 等实现 worker 不再只读或在主工作区直接修改；Batch C 统一采用独立 worktree 候选 patch，Codex 读取 Hindsight recall、process-handoff.md/json、result.json、diff 与验证证据后再选择性合入。