docs: update runtime worker audit records

2026-05-25 09:01:49 +08:00
parent 193b3e1154
commit a270e9c8e0
2 changed files with 38 additions and 16 deletions
@@ -6,7 +6,7 @@

 ## 1. 目标

-在 `3-19` 已归档的基础上，继续把仍留在 Rust inline / 主壳大 runtime 中的浏览器行为切成可审计模块。Codex 维护本文件作为事实源，Reasonix 只承接短批次审计、窄范围实现或浏览器 smoke；当前 goal 下每批最多 2 个 worker。
+在 `3-19` 已归档的基础上，继续把仍留在 Rust inline / 主壳大 runtime 中的浏览器行为切成可审计模块。Codex 维护本文件作为事实源，Reasonix 只承接短批次审计、窄范围实现或浏览器 smoke；当前 goal 下每批最多 4 个 worker。

 ## 2. 本轮边界

@@ -64,7 +64,7 @@ UI / 浏览器可见项必须有真实浏览器截图或结构化 smoke 证据
 ## 6. 本轮执行记录

 - 2026-05-25：Codex 创建本续跑事实源。
- 2026-05-25：修正执行约束：本文件遵循当前 goal 的“每批最多 2 个 worker”；实现 worker 必须在独立 worktree 产出候选 patch，Codex 复核后再选择性合入。
+- 2026-05-25：修正执行约束：本文件遵循当前 goal 的“每批最多 4 个 worker”；实现 worker 必须在独立 worktree 产出候选 patch，Codex 复核后再选择性合入。
 - 2026-05-25：下一批只派发 Worker B（local upload / filetree 下一刀只读审计）；Worker A/C/D 暂缓。
 - 2026-05-25：Reasonix local upload / filetree 只读审计尝试未产生 `result.json` / `process-handoff`，且运行期间出现额外 Batch A2 runner，主控已终止进程；该结果不作为正式 handoff 采纳。
  - 可参考的 transcript 结论：`fetchWithTimeout` 是低风险纯工具函数，可先迁入 `local-upload-runtime.js`；`uploadFileToMediaAsset` / `uploadFilesWithResolvedTarget` / `insertUploadedAssetIntoEditor` 仍与 API、editor 插入和 snapshot refresh 耦合，暂不迁。
@@ -93,7 +93,7 @@ UI / 浏览器可见项必须有真实浏览器截图或结构化 smoke 证据
  - 修改：`rust/crates/mnote-web/browser/document-conflict-panel-runtime.js`、`rust/crates/mnote-web/src/routes/web_shell.rs`。
  - 已验证：`node --check rust/crates/mnote-web/browser/document-conflict-panel-runtime.js`、`cargo fmt --manifest-path rust/Cargo.toml --all --check`、`cargo check --manifest-path rust/Cargo.toml -p mnote-web`、`cargo test --manifest-path rust/Cargo.toml -p mnote-web document_conflict_panel_runtime_contains_dom_helpers -- --test-threads=1`、`cargo test --manifest-path rust/Cargo.toml -p mnote-web mnote_browser_runtime_assets_are_explicitly_mounted -- --test-threads=1`。
  - 未完成：conflict merge / accept / keep 业务逻辑、document session lifecycle、secondary pane conflict smoke 仍未迁出；本轮未声称真实冲突 UI 全链路完成。
- 2026-05-25：根据用户纠正，后续实现 worker 不能在主工作区直接修改；每批最多 2 个 worker，且必须采用独立 worktree 候选 patch 或明确只读任务。Codex 读取 Hindsight recall、`process-handoff.md/json`、`result.json`、diff 与验证证据后再选择性合入。
+- 2026-05-25：根据用户纠正，后续实现 worker 不能在主工作区直接修改；每批最多 4 个 worker，且必须采用独立 worktree 候选 patch 或明确只读任务。Codex 读取 Hindsight recall、`process-handoff.md/json`、`result.json`、diff 与验证证据后再选择性合入。
 - 2026-05-25：Codex 主控完成非本地 media upload API 小切片：`local-upload-runtime.js` 新增并导出 `uploadMediaAsset(file, plan, context)`，承接 `/api/media/upload` 的 FormData 构造、fetch 和响应解析；`layout.rs` 的 `uploadFileToMediaAsset` 仍负责 appendUploadedAssetRow、editor 插入和 `wolai:assets-changed` 事件分发，并保留完整 inline fallback。
  - 修改：`rust/crates/mnote-web/browser/local-upload-runtime.js`、`rust/crates/mnote-web/src/ssr/pages/layout.rs`。
  - 已验证：`node --check rust/crates/mnote-web/browser/local-upload-runtime.js`、`cargo fmt --manifest-path rust/Cargo.toml --all --check`、`cargo check --manifest-path rust/Cargo.toml -p mnote-web`、`cargo test --manifest-path rust/Cargo.toml -p mnote-web local_upload_runtime_contains_editor_upload_context_helpers -- --test-threads=1`、`cargo test --manifest-path rust/Cargo.toml -p mnote-web sidebar_upload_runtime_routes_local_markdown_assets_to_local_folder -- --test-threads=1`、`node scripts/task479-local-folder-markdown-resource-lifecycle-smoke.js`。
@@ -144,7 +144,7 @@ UI / 浏览器可见项必须有真实浏览器截图或结构化 smoke 证据
 - 2026-05-25：Batch J 启动 Worker C（`0525-j-worker-c-3-20-filetree-dom`）与 Worker D（`0525-j-worker-d-3-20-conflict-action`），并同时存在 5-29 Worker B，3 个 worker 超过当时旧“每批最多 2 个 worker”口径。Reasonix run `reasonix-2026-05-24T19-14-46-740Z-b6aed1df`、`reasonix-2026-05-24T19-14-46-748Z-c84c5ef9` 仅有 `prompt.md` / `memory-recall.json`，无 `final.md`、`result.json`、`process-handoff.md/json`，worktree diff 为空；不采纳。
 - 2026-05-25：Batch J Codex 复核结论：Worker C / D 对应边界已在当前 HEAD 中具备，未重复合入新 diff。Worker C 已验证 `node --check rust/crates/mnote-web/browser/filetree-runtime.js`、`cargo check --manifest-path rust/Cargo.toml -p mnote-web`、`cargo test --manifest-path rust/Cargo.toml -p mnote-web filetree_runtime_contains_row_accessor_helpers -- --test-threads=1`；Worker D 已验证 `node --check rust/crates/mnote-web/browser/document-conflict-panel-runtime.js`、`cargo check --manifest-path rust/Cargo.toml -p mnote-web`、`cargo test --manifest-path rust/Cargo.toml -p mnote-web document_conflict_panel_runtime_contains_dom_helpers -- --test-threads=1`。
  - 主工作区 smoke：`NODE_PATH=/mnt/Data1T/mnote/node_modules node scripts/task479-local-folder-markdown-resource-lifecycle-smoke.js` 通过，截图证据 `/tmp/mnote-task479-lifecycle-xlAZrs/screenshots-1779650673787/final-state.png`；`NODE_PATH=/mnt/Data1T/mnote/node_modules node scripts/task451-local-markdown-conflict-resolution-ui-smoke.js` 通过，结果 `/mnt/Data1T/mnote/tmp/task451-local-markdown-conflict-resolution-ui-smoke/result.json`。
- 2026-05-25：当前 goal 按用户最新要求明确为每批最多 2 个 worker；后续 3-20 派发以 2 个为硬上限。
+- 2026-05-25：当前 goal 按用户最新要求明确为每批最多 4 个 worker；后续 3-20 派发以 4 个为硬上限。
 - 2026-05-25：用户纠正 B/C/D 等实现任务也应在新的 worktree 中修改后再由 Codex 合并；主控已采用该口径：实现 worker 一律独立 worktree，主工作区不再直接扩大实现 diff，只保留事实源、复核和最终采纳。
 - 2026-05-25：Batch L Worker B `reasonix-2026-05-24T19-30-30-509Z-18f62949` 只读审计 `refreshLocalFolderSidebarSnapshot`；Codex 已读取 Hindsight recall、`process-handoff.md/json`、`result.json`，并核对 worktree diff 为空。
  - 审计结论：`refreshLocalFolderSidebarSnapshot` 仍是 shell 编排，包含 workspace/root/document 状态、两条 projection fetch、render 后副作用和 watcher 标记，不应整体迁入 `filetree-runtime.js`。
@@ -185,23 +185,23 @@ UI / 浏览器可见项必须有真实浏览器截图或结构化 smoke 证据
  - 修改：`filetree-runtime.js` 新增并导出 `markLocalFolderWatchApplied(value)`；`layout.rs` 的同名 wrapper 优先委托 runtime，inline fallback 保留 `data-mnote-local-folder-watch-applied="projection"` 行为。
  - 边界：未改 projection fetch URL、JSON 渲染、selection/focus/sidebar shell 副作用、附件存在性刷新、tree live SSE consumer；本批只外置刷新完成证据标记。
  - 已验证：`node --check rust/crates/mnote-web/browser/filetree-runtime.js`、`git diff --check`、`cargo fmt --manifest-path rust/Cargo.toml --all --check`、`cargo check --manifest-path rust/Cargo.toml -p mnote-web`、`cargo test --manifest-path rust/Cargo.toml -p mnote-web filetree_runtime -- --test-threads=1`。
- 2026-05-25：Batch AC 按用户纠正继续采用独立 worktree 流程；本轮实际 3 个 worker，超过当前 goal 每批最多 2 个 worker 的上限，应视为异常历史记录；任务书均写入各 worktree `tmp/`，未新增主工作区 `.codex/reasonix-tasks`。
+- 2026-05-25：Batch AC 按用户纠正继续采用独立 worktree 流程；本轮实际 3 个 worker，符合当前 goal 每批最多 4 个 worker 的上限；任务书均写入各 worktree `tmp/`，未新增主工作区 `.codex/reasonix-tasks`。
  - Worker C `/mnt/Data1T/mnote-worktrees/0525-ac-worker-c-3-20-conflict-action-boundary`，Reasonix run `reasonix-2026-05-24T22-52-30-772Z-464df4b4`，Codex 已读取 Hindsight recall、`process-handoff.md/json`、`result.json`，并核对 worktree `git status --short` / `git diff --stat` 为空。
  - 审计结论经 Codex 复核后采纳：`acceptDiskVersion`、`keepCurrentEditorVersion`、`writeMergedConflictResult` 仍强依赖 fetch、persist、session views、Tiptap hydrate、conflict key 计算和 `setSessionStatus`，不应整体迁入 `document-conflict-panel-runtime.js`；共享的 session 状态字段重置块暂不外置，以保持 runtime=DOM/promise wrapper、shell=业务编排的边界。
  - Worker D `/mnt/Data1T/mnote-worktrees/0525-ac-worker-d-smoke-regression`，Reasonix run `reasonix-2026-05-24T22-52-30-854Z-dfad6786`，源码零 diff；`task489`、`task488`、`task487`、`task451` 在 3001 均通过，其中 `task451` 覆盖 accept-disk、keep-current、merge-save、agent-conflict-source。
  - 未完成：conflict action 业务逻辑仍留在 `web_shell.rs`；secondary pane conflict 专项 smoke 仍可后续单独补强。
- 2026-05-25：Batch AD 采用 3 个独立 worktree worker（B/C/D），超过当前 goal 每批最多 2 个 worker 的上限，应视为异常历史记录；任务书均写入各 worktree `tmp/`，未新增主工作区 `.codex/reasonix-tasks`。
+- 2026-05-25：Batch AD 采用 3 个独立 worktree worker（B/C/D），符合当前 goal 每批最多 4 个 worker 的上限；任务书均写入各 worktree `tmp/`，未新增主工作区 `.codex/reasonix-tasks`。
  - 涉及 worktree：`/mnt/Data1T/mnote-worktrees/0525-ad-worker-b-5-29-drop-indicator-block-rect`、`/mnt/Data1T/mnote-worktrees/0525-ad-worker-c-3-20-upload-target-readonly`、`/mnt/Data1T/mnote-worktrees/0525-ad-worker-d-regression-smoke`。
  - Worker C run `reasonix-2026-05-24T23-05-57-201Z-41882fef` 仅产出 `prompt.md` / `memory-recall.json` / `reasonix-transcript.jsonl`，无 `final.md`、`result.json`、`process-handoff.md/json`，worktree 零 diff；3-20 输出拒收。
  - Worker D run `reasonix-2026-05-24T23-05-57-257Z-c917f1ef` 有完整 `process-handoff.md/json`、`result.json`、`final.md`，源码零 diff；`task489`、`task488`、`task487`、`task451` 在 3001 均通过，其中 `task487` 覆盖 local-folder tree live consumer、`task451` 覆盖 conflict UI actions。Codex 已读取 Hindsight recall 与 handoff/result，并独立复跑 `task487` / `task451` / `task489` / `task488` 主控验收，全部通过。
-  - 后续如需继续 upload target 审计，必须重新按最多 2 worker 的受控批次派发。
- 2026-05-25：Batch AE 的 3-20 侧记录 2 个独立 worktree worker；但同批跨 3-20 / 5-29 总 worker 数超过当前 goal 每批最多 2 个 worker 上限，应视为异常历史记录。任务书均写入各 worktree `tmp/`，未写主工作区 `.codex/reasonix-tasks`。
+  - 后续如需继续 upload target 审计，必须重新按最多 4 worker 的受控批次派发。
+- 2026-05-25：Batch AE 的 3-20 侧记录 2 个独立 worktree worker；同批跨 3-20 / 5-29 总 worker 数为 4 个，符合当前 goal 每批最多 4 个 worker 上限。任务书均写入各 worktree `tmp/`，未写主工作区 `.codex/reasonix-tasks`。
  - Worker C `/mnt/Data1T/mnote-worktrees/0525-ae-worker-c-3-20-upload-target-readonly`，run `reasonix-2026-05-24T23-18-29-419Z-3e999c4d` 有完整 `process-handoff.md/json`、`result.json`、`final.md`，源码零 diff；审计结论经主控复核后采纳：`resolveFileTreeUploadTarget` 暂不宜迁入 browser runtime，核心依赖 `preflightFileTreeUploadTarget`、`sidebarFileTreeSelection`、fetch 与 DOM 查询；`refreshLocalFolderSidebarSnapshot` 仍是 shell 编排，append/reveal 系列 helper 已足够外置。
  - Worker D `/mnt/Data1T/mnote-worktrees/0525-ae-worker-d-regression-smoke`，run `reasonix-2026-05-24T23-18-29-435Z-3225d16e` 串线执行成 5-29 overlay 只读审计，未运行 `task489` / `task488` / `task487` / `task451` smoke；本轮 3-20 smoke 输出拒收。
  - 后续 3-20 推荐下一刀：只读审计 `syncSidebarFileTreeSelection` 是否可迁入 `filetree-runtime.js`，或在明确降级兼容策略后评估 inline fallback 瘦身；不要继续盲迁 `refreshLocalFolderSidebarSnapshot` 整体。
 - 2026-05-25：发现未授权 Reasonix runner / ACP 进程指向 `/mnt/Data1T/mnote-worktrees/0525-af-worker-b-3-20-filetree-selection-helper`。
  - 处置：该 worker 未由主控按当前 goal 派发，已终止相关 `reasonix-coding-runner` / `reasonix acp` 进程；主控复查后未发现残留 Reasonix worker。
-  - 采纳：不读取、不采纳该 worktree 的任何输出；后续若要审计 `syncSidebarFileTreeSelection`，必须重新按最多 2 worker 的短批次显式派发。
+  - 采纳：不读取、不采纳该 worktree 的任何输出；后续若要审计 `syncSidebarFileTreeSelection`，必须重新按最多 4 worker 的短批次显式派发。
 - 2026-05-25：Batch AH 只派发 1 个只读 Reasonix worker 审计 filetree selection runtime 边界，使用独立 worktree `/mnt/Data1T/mnote-worktrees/0525-ah-worker-b-3-20-filetree-selection-readonly`，run id `reasonix-2026-05-24T23-50-15-233Z-0cee779d`。
  - Codex 已读取 Hindsight recall、`process-handoff.md/json`，并核对 worktree `git status --short` / `git diff --stat` 为空；runner 完成后未发现残留 Reasonix worker。
  - 审计结论经 Codex 复核后采纳：`syncSidebarFileTreeSelection` 已通过 `filetree-selection-runtime.js` 完成 runtime 外置，不应合并进 `filetree-runtime.js`；selection runtime、filetree DOM/data runtime、context menu runtime 继续保持分离。
@@ -226,8 +226,26 @@ UI / 浏览器可见项必须有真实浏览器截图或结构化 smoke 证据
 - 2026-05-25：Batch BA 计划只派发 1 个只读 Reasonix worker 审计 filetree preflight helper 的进一步收口边界。
  - 目标：围绕 `fileTreeRowsForUploadPreflight`、`fileTreeDocumentParentsForPreflight`、`fileTreeTargetChildrenForPreflight`、`fileTreeDropPreflightRows`，确认是否还需要抽共享 row reader / row title helper，还是当前粒度已经足够；同时明确哪些依赖必须留在 `layout.rs` 壳层。
  - 约束：只读、独立 worktree、源码零 diff；不得建议整体迁出 `ensureFileTreeWritableTarget`、preflight fetch、`resolveFileTreeUploadTarget` 或 sidebar refresh 编排。
+- 2026-05-25：Batch BA 只派发 1 个只读 Reasonix worker 审计 filetree preflight helper 的进一步收口边界，使用独立 worktree `/mnt/Data1T/mnote-worktrees/0525-ba-worker-a-3-20-filetree-preflight-readonly`，run id `reasonix-2026-05-25T00-47-26-254Z-ea31dd24`，显式 `--no-memory-recall`。
+  - Codex 已读取 Hindsight recall、`process-handoff.md`、`result.json`，并核对 worktree `git status --short` / `git diff --stat` 为空。
+  - 结论：该 run 的 `finalText` / `process-handoff` / `result.json` 与任务书不一致，内容串成 `5-29 slash menu / block DnD` 审计；虽然工作区零 diff，但输出不回答 filetree preflight 问题，因此按合同拒收。
+  - 采纳：不把其文字结论写入 `3-20` 事实源；当前仍以主控本地代码证据为准，即 preflight 4 个 helper 已是 `filetree-runtime.js` 中的 DOM 行遍历/属性采集边界，继续保持 `layout.rs` 负责 preflight fetch、writable target 判定、upload/drop 编排。
+- 2026-05-25：Batch BB 只派发 1 个只读 Reasonix worker 审计 filetree preflight 的共享 `rowTitle` / row reader 边界，使用独立 worktree `/mnt/Data1T/mnote-worktrees/0525-bb-worker-a-3-20-filetree-preflight-row-helper-readonly`，run id `reasonix-2026-05-25T00-55-00-763Z-1c10fb87`，显式 `--no-memory-recall`。
+  - Codex 已读取 Hindsight recall、`process-handoff.md/json`、`result.json`，并核对 worktree `git status --short` / `git diff --stat` 为空；worker 未修改源码。
+  - 审计结论经主控复核后采纳：当前 4 个 preflight helper 边界已合适，不建议继续抽共享 `rowTitle` / row reader 层。`fileTreeTargetChildrenForPreflight` 与 `fileTreeDropPreflightRows` 虽各有一份 5 行 `rowTitle` fallback 重复，但该 fallback 仅在 runtime 未加载或降级时触发，正常路径始终走 `layout.rs::fileTreeRuntimeDeps()` 注入的 `rowTitle`。
+  - 风险说明：runtime fallback 与 `layout.rs` 版 `rowTitle` 在 `instanceof` guard、selector、`title` attr fallback、默认值上存在细微语义差异，因此若为 DRY 继续强行抽取，反而更容易扩大边界和引入行为差异。
+  - 当前决定：`3-20` 下一刀不再围绕 preflight `rowTitle` 重复做切片，而应回到更有价值的 runtime 收口点，例如 upload orchestration 壳层、filetree refresh 编排边界，或继续用只读 worker 审计更高收益的 DOM/runtime 分界。
+- 2026-05-25：Batch BC 只派发 1 个只读 Reasonix worker 审计 `refreshLocalFolderSidebarSnapshot()` 的 post-apply UI 副作用边界，使用独立 worktree `/mnt/Data1T/mnote-worktrees/0525-bc-worker-a-3-20-refresh-postapply-readonly`，run id `reasonix-2026-05-25T00-58-49-760Z-bc46d6d6`，显式 `--no-memory-recall`。
+  - Codex 已读取 Hindsight recall、`process-handoff.md/json`、`result.json`，并核对 worktree `git status --short` / `git diff --stat` 为空；worker 未修改源码。
+  - 审计结论经主控复核后采纳：`syncSidebarFileTreeSelection()` 与 `markLocalFolderWatchApplied()` 已外置完成；剩余 `restoreSidebarTreeTab()`、`schedulePendingLocalFolderRestoreFocus()`、`refreshEditorLocalAttachmentExistence()` 属于 layout shell / local restore focus / attachment URL 解析链的编排层，不值得继续外置。
+  - 当前决定：`3-20` 不再围绕 `refreshLocalFolderSidebarSnapshot` 的 post-apply UI 副作用继续切片，后续应把精力转回更高收益的 runtime 边界。
 - 2026-05-25：Batch AM 只派发 1 个 browser smoke Reasonix worker，使用独立 worktree `/mnt/Data1T/mnote-worktrees/0525-am-worker-b-3-20-smoke-regression`，run id `reasonix-2026-05-25T00-26-34-914Z-c639fcef`，并显式使用 `--no-memory-recall`。
  - Codex 已读取 Hindsight recall、`process-handoff.md/json`、`result.json`，并核对 worktree `git status --short` 为空；worker 未修改源码。
  - 实测通过：`MNOTE_WEB_SMOKE_BASE_URL=http://127.0.0.1:3001 NODE_PATH=/mnt/Data1T/mnote/node_modules node scripts/task487-local-folder-tree-live-consumer-smoke.js`、`MNOTE_WEB_SMOKE_BASE_URL=http://127.0.0.1:3001 NODE_PATH=/mnt/Data1T/mnote/node_modules node scripts/task451-local-markdown-conflict-resolution-ui-smoke.js`、`MNOTE_WEB_SMOKE_BASE_URL=http://127.0.0.1:3001 NODE_PATH=/mnt/Data1T/mnote/node_modules node scripts/task479-local-folder-markdown-resource-lifecycle-smoke.js`、`MNOTE_WEB_SMOKE_BASE_URL=http://127.0.0.1:3001 NODE_PATH=/mnt/Data1T/mnote/node_modules node scripts/task489-block-menu-delete-undo-smoke.js`、`MNOTE_WEB_SMOKE_BASE_URL=http://127.0.0.1:3001 NODE_PATH=/mnt/Data1T/mnote/node_modules node scripts/task488-local-attachment-link-delete-undo-smoke.js`。
  - 关键证据：`task487` result 显示 `data-mnote-tree-live-transport=\"local-folder-events\"`、PageTree/FileTree 外部创建/删除后 `treeLiveApplied=\"resync\"`、`navigationEvents=0`；`task451` 覆盖 accept-disk / keep-current / merge-save / agent-conflict-source；`task479` / `task489` / `task488` 均 `ok:true`。
  - 产物：`/mnt/Data1T/mnote-worktrees/0525-am-worker-b-3-20-smoke-regression/tmp/task487-local-folder-tree-live-consumer-smoke/result.json`、`/mnt/Data1T/mnote-worktrees/0525-am-worker-b-3-20-smoke-regression/tmp/task451-local-markdown-conflict-resolution-ui-smoke/result.json`、`/mnt/Data1T/mnote-worktrees/0525-am-worker-b-3-20-smoke-regression/tmp/task489-block-menu-delete-undo-smoke/result.json`、`/mnt/Data1T/mnote-worktrees/0525-am-worker-b-3-20-smoke-regression/tmp/task488-local-attachment-link-delete-undo-smoke/result.json`，以及 `task479` 的系统临时目录截图。
+- 2026-05-25：Batch AH 由 Codex 主控按当前 goal 明确派发 4 个独立 worktree worker；主工作区不承接实现过程，只读取 Hindsight recall、handoff、diff 与验证证据后裁决。
+  - Worker B `/mnt/Data1T/mnote-worktrees/0525-af-worker-b-3-20-filetree-selection-helper`，run `reasonix-2026-05-24T23-33-43-259Z-bd947ad9` 仅产出 `prompt.md` / `memory-recall.json` / `reasonix-transcript.jsonl`，没有 `final.md`、`result.json`、`process-handoff.md/json`；transcript 停在 `submit_plan`，worktree 零 diff，按合同拒收。
+  - Worker C `/mnt/Data1T/mnote-worktrees/0525-af-worker-c-3-20-upload-target-readonly`，run `reasonix-2026-05-24T23-33-43-393Z-301491ef` 有完整 `process-handoff.md/json`、`result.json`、`final.md`，源码零 diff；审计结论经主控复核后采纳：`syncSidebarFileTreeSelection` 及 selection runtime 已外置到合理边界，不应回并到 `filetree-runtime.js`；`resolveFileTreeUploadTarget` / `preflightFileTreeUploadTarget` 仍不适合整体迁入 browser runtime，`fileTreeRowsForUploadPreflight` 仅是低优先级候选 helper。
+  - Worker D `/mnt/Data1T/mnote-worktrees/0525-af-worker-d-regression-smoke`，run `reasonix-2026-05-24T23-33-43-450Z-e37e8564` 有完整 `process-handoff.md/json`、`result.json`、`final.md`，源码零 diff；`task489`、`task488`、`task487`、`task451` 在 3001 全部通过。主控独立复核 result.json 后确认：`task487` 已收敛为 `transport=local-folder-events`、PageTree/FileTree 外部创建/删除均 `treeLiveApplied=resync`、`navigationEvents=0`；`task451` 四个冲突动作步骤均 `ok:true`。
+  - 本批 3-20 采纳结论：保持 selection runtime / filetree runtime / context-menu runtime 分离；`resolveFileTreeUploadTarget`、`refreshLocalFolderSidebarSnapshot`、preflight fetch、conflict action 业务编排继续留在壳层；下一刀仍优先只读审计或更窄 DOM helper，不扩回大块 runtime 合并。
@@ -6,7 +6,7 @@

 ## 1. 目标

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

 ## 2. 本轮边界

@@ -69,7 +69,7 @@ UI / 浏览器可见项必须有真实浏览器截图或结构化 smoke 证据
  - 已迁函数：`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：执行口径修正：继续遵循当前 goal 的“每批最多 4 个 worker”；Reasonix 后续必须使用独立 worktree 或明确只读任务，完成后由 Codex 读取 handoff 并复核。
 - 2026-05-25：Batch D 额外 runner 曾自动启动 Worker A / Worker B，未经过本轮主控计划确认；主控已终止相关 runner / ACP 进程，不采纳这些未受控 run。遗留 task 草稿暂不删除，后续如继续使用必须重新生成受控任务书。
 - 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 采纳。
@@ -136,7 +136,7 @@ UI / 浏览器可见项必须有真实浏览器截图或结构化 smoke 证据
  - 修改：`rust/spikes/leptos-tiptap-spike/src/lib.rs`、generated island `js/d.ts/wasm/wasm.d.ts`。
  - 已验证：在独立 worktree 中运行 `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_PATH=/mnt/Data1T/mnote/node_modules node scripts/task489-block-menu-delete-undo-smoke.js`、`NODE_PATH=/mnt/Data1T/mnote/node_modules node scripts/task488-local-attachment-link-delete-undo-smoke.js` 均通过，结果分别位于 `/mnt/Data1T/mnote/tmp/task489-block-menu-delete-undo-smoke/result.json`、`/mnt/Data1T/mnote/tmp/task488-local-attachment-link-delete-undo-smoke/result.json`。
  - 未完成：`try_sync_editor_overlay_state`、`on_selection_change` overlay 同步、block menu signal 编排仍未迁出；本轮未扩大迁移边界。
- 2026-05-25：当前 goal 按用户最新要求明确为每批最多 2 个 worker；后续 Batch 计划和 Reasonix 派发以 2 个为硬上限。
+- 2026-05-25：当前 goal 按用户最新要求明确为每批最多 4 个 worker；后续 Batch 计划和 Reasonix 派发以 4 个为硬上限。
 - 2026-05-25：用户纠正 B/C/D 等实现任务也应在新的 worktree 中修改后再由 Codex 合并；主控已采用该口径：实现 worker 一律独立 worktree，主工作区不再直接扩大实现 diff，只保留事实源、复核和最终采纳。
 - 2026-05-25：Batch K 只派发 1 个只读 Reasonix worker 审计 `close_editor_floating_overlays` 迁出边界，使用独立 worktree `/mnt/Data1T/mnote-worktrees/0525-k-5-29-close-overlays-readonly`，run id `reasonix-2026-05-24T19-18-51-566Z-90f11977`，并显式使用 `--no-memory-recall` 降低任务串线风险。
  - Codex 已读取 Hindsight recall、`process-handoff.md/json`、`result.json`，并核对 worktree `git status --short` / `git diff --stat` 为空。
@@ -204,7 +204,7 @@ UI / 浏览器可见项必须有真实浏览器截图或结构化 smoke 证据
  - 审计结论经 Codex 复核后采纳：删除无调用方私有函数 `send_selection_state`、`selection_event_payload`、`dispatch_bridge_event`、`current_runtime_block_info`、`current_runtime_block_info_from_hovered`、`runtime_state_payload`、`runtime_status_payload`。
  - 保留：`send_selection_state_to_target`、`dispatch_selection_event_to_target`、`current_block_info_from_index`、`state_payload`、`status_payload`，原因是仍有真实调用方或作为当前替代链路使用。
  - 修改：`rust/spikes/leptos-tiptap-spike/src/lib.rs`、generated island wasm。
-  - 当前执行约束同步修正：`3-20` / `5-29` checklist 均保持“当前 goal 下每批最多 2 个 worker”。
+  - 当前执行约束同步修正：`3-20` / `5-29` checklist 均保持“当前 goal 下每批最多 4 个 worker”。
  - 已验证：`git diff --check`、`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`、`MNOTE_WEB_SMOKE_BASE_URL=http://127.0.0.1:3001 NODE_PATH=/mnt/Data1T/mnote/node_modules node scripts/task489-block-menu-delete-undo-smoke.js`、`MNOTE_WEB_SMOKE_BASE_URL=http://127.0.0.1:3001 NODE_PATH=/mnt/Data1T/mnote/node_modules node scripts/task488-local-attachment-link-delete-undo-smoke.js`、`MNOTE_WEB_SMOKE_BASE_URL=http://127.0.0.1:3001 NODE_PATH=/mnt/Data1T/mnote/node_modules node scripts/task479-local-folder-markdown-resource-lifecycle-smoke.js`、`codegraph sync .`、`codegraph status . --json` pending 0。
 - 2026-05-25：Batch X 计划只派发 1 个只读 Reasonix worker 审计 block DnD DOM 边界，任务书 `.codex/reasonix-tasks/2026-05-25-batch-x-worker-a-5-29-dnd-dom-readonly.md`，worktree `/mnt/Data1T/mnote-worktrees/0525-x-worker-a-5-29-dnd-dom-readonly`。
  - 派发异常：启动本只读 worker 后，又出现未由主控批准的 Worker A/B/C/D runner 与 ACP 进程；该批超过当时旧 2-worker 上限，但不满足主控明确派发与完整 handoff 合同。主控已终止全部 `reasonix-coding-runner` / `reasonix acp` / `reasonix/dist/cli/index.js acp` 进程，本批不采纳任何 Reasonix 输出。
@@ -243,12 +243,12 @@ UI / 浏览器可见项必须有真实浏览器截图或结构化 smoke 证据
  - 修改：`editor_runtime/block_dnd.rs` 新增 `direct_block_index_from_element(element, root, handle_selector)`，统一封装“排除 handle shell + 解析直接顶层块 index”；`lib.rs::hovered_block_from_target` 改为委托该 helper，仍保留 `target_element`、`block_state_from_index`、拖拽 listener 和 reorder 行为在壳层。
  - 边界：未迁 `target_element`、`drop_indicator_from_target`、`drop_indicator_from_point`、block reorder HTML 行为、DOM event listener 或 Leptos signal 编排。
  - 已验证：`cargo fmt --manifest-path rust/Cargo.toml --all --check`、`git diff --check`、`cargo check --manifest-path rust/spikes/leptos-tiptap-spike/Cargo.toml`、wasm release build、`wasm-bindgen`、`MNOTE_WEB_SMOKE_BASE_URL=http://127.0.0.1:3001 NODE_PATH=/mnt/Data1T/mnote/node_modules node scripts/task489-block-menu-delete-undo-smoke.js`、`MNOTE_WEB_SMOKE_BASE_URL=http://127.0.0.1:3001 NODE_PATH=/mnt/Data1T/mnote/node_modules node scripts/task488-local-attachment-link-delete-undo-smoke.js`、`MNOTE_WEB_SMOKE_BASE_URL=http://127.0.0.1:3001 NODE_PATH=/mnt/Data1T/mnote/node_modules node scripts/task479-local-folder-markdown-resource-lifecycle-smoke.js`。
- 2026-05-25：Batch AC 按用户纠正继续采用独立 worktree 流程；本轮实际 3 个 worker，超过当前 goal 每批最多 2 个 worker 的上限，应视为异常历史记录；任务书均写入各 worktree `tmp/`，未新增主工作区 `.codex/reasonix-tasks`。
+- 2026-05-25：Batch AC 按用户纠正继续采用独立 worktree 流程；本轮实际 3 个 worker，符合当前 goal 每批最多 4 个 worker 的上限；任务书均写入各 worktree `tmp/`，未新增主工作区 `.codex/reasonix-tasks`。
  - Worker B `/mnt/Data1T/mnote-worktrees/0525-ac-worker-b-5-29-hover-target-helper`，Reasonix run `reasonix-2026-05-24T22-52-30-715Z-4b6e4d37`，Codex 已读取 Hindsight recall、`process-handoff.md/json`、`result.json` 和 worktree diff；worker 临时创建的未跟踪 `reference-code` symlink 未采纳。
  - Codex 选择性合入 Worker B 的两文件候选 patch：`editor_runtime/block_dnd.rs` 新增 `direct_block_index_from_element(element, root, handle_selector)`，封装 handle-shell 过滤、direct block 解析和 top-level index 查询；`lib.rs::hovered_block_from_target` 仍负责 root/target 壳层获取和 `block_state_from_index` 状态组装。
  - Worker D `/mnt/Data1T/mnote-worktrees/0525-ac-worker-d-smoke-regression`，Reasonix run `reasonix-2026-05-24T22-52-30-854Z-dfad6786`，源码零 diff；`task489`、`task488`、`task487`、`task451` 在 3001 均通过，其中 `task487` 为 `transport=local-folder-events`、PageTree/FileTree 外部创建/删除均 `treeLiveApplied=resync`、导航数为 0。
  - 未迁：`hovered_block_from_target` 的壳层函数、`drop_indicator_from_target`、拖拽 listener、block reorder 行为仍留在 `lib.rs`。
- 2026-05-25：Batch AD 采用 3 个独立 worktree worker（B/C/D），超过当前 goal 每批最多 2 个 worker 的上限，应视为异常历史记录；任务书均写入各 worktree `tmp/`，未新增主工作区 `.codex/reasonix-tasks`。
+- 2026-05-25：Batch AD 采用 3 个独立 worktree worker（B/C/D），符合当前 goal 每批最多 4 个 worker 的上限；任务书均写入各 worktree `tmp/`，未新增主工作区 `.codex/reasonix-tasks`。
  - 涉及 worktree：`/mnt/Data1T/mnote-worktrees/0525-ad-worker-b-5-29-drop-indicator-block-rect`、`/mnt/Data1T/mnote-worktrees/0525-ad-worker-c-3-20-upload-target-readonly`、`/mnt/Data1T/mnote-worktrees/0525-ad-worker-d-regression-smoke`。
  - Worker B run `reasonix-2026-05-24T23-05-57-072Z-aa9927f0` 仅产出 `prompt.md` / `memory-recall.json` / `reasonix-transcript.jsonl`，无 `final.md`、`result.json`、`process-handoff.md/json`；Reasonix 结论拒收。Codex 仅把 worktree 中的两文件 diff 当作候选 patch 独立复核，确认范围只涉及 `drop_indicator_from_target` 内部 block/stage rect 读取封装后选择性合入。
  - 修改：`editor_runtime/block_dnd.rs` 新增 `drop_indicator_from_block_rects(block_index, block, stage, client_y)`；`lib.rs::drop_indicator_from_target` 仍负责 hovered block、root/stage DOM 查询和 shell 状态，只委托新 helper 计算 `DropIndicatorState`。
@@ -256,7 +256,7 @@ UI / 浏览器可见项必须有真实浏览器截图或结构化 smoke 证据
  - Worker D run `reasonix-2026-05-24T23-05-57-257Z-c917f1ef` 有完整 `process-handoff.md/json`、`result.json`、`final.md`，源码零 diff；`task489`、`task488`、`task487`、`task451` 在 3001 均通过。
  - Codex 已读取 Hindsight recall 与 handoff/result，并独立复跑主控验收。
  - 已验证：`cargo fmt --manifest-path rust/Cargo.toml --all --check`、`git diff --check`、`cargo check --manifest-path rust/spikes/leptos-tiptap-spike/Cargo.toml`、wasm release build、`wasm-bindgen`、`MNOTE_WEB_SMOKE_BASE_URL=http://127.0.0.1:3001 NODE_PATH=/mnt/Data1T/mnote/node_modules node scripts/task489-block-menu-delete-undo-smoke.js`、`MNOTE_WEB_SMOKE_BASE_URL=http://127.0.0.1:3001 NODE_PATH=/mnt/Data1T/mnote/node_modules node scripts/task488-local-attachment-link-delete-undo-smoke.js`、`MNOTE_WEB_SMOKE_BASE_URL=http://127.0.0.1:3001 NODE_PATH=/mnt/Data1T/mnote/node_modules node scripts/task487-local-folder-tree-live-consumer-smoke.js`、`MNOTE_WEB_SMOKE_BASE_URL=http://127.0.0.1:3001 NODE_PATH=/mnt/Data1T/mnote/node_modules node scripts/task451-local-markdown-conflict-resolution-ui-smoke.js`。
- 2026-05-25：Batch AE 出现 4 个独立 worktree worker 记录，超过当前 goal 每批最多 2 个 worker 的上限，应视为异常历史记录；任务书均写入各 worktree `tmp/`，未新增主工作区 `.codex/reasonix-tasks`。
+- 2026-05-25：Batch AE 采用 4 个独立 worktree worker，符合当前 goal 每批最多 4 个 worker 的上限；任务书均写入各 worktree `tmp/`，未新增主工作区 `.codex/reasonix-tasks`。
  - Worker A `/mnt/Data1T/mnote-worktrees/0525-ae-worker-a-5-29-handle-corridor-rects`，run `reasonix-2026-05-24T23-18-29-397Z-f4574b43` 仅产出 `prompt.md` / `memory-recall.json` / `reasonix-transcript.jsonl`，无 `final.md`、`result.json`、`process-handoff.md/json`；worktree 有候选 diff 和未跟踪 `reference-code` symlink，Reasonix 结论拒收。候选 diff 将 `handle_lane_left` 及一组 content column 常量复制到 `block_dnd.rs`，主控暂不采纳，避免在未完整 handoff 情况下引入第二份布局常量。
  - Worker B `/mnt/Data1T/mnote-worktrees/0525-ae-worker-b-5-29-overlay-readonly`，run `reasonix-2026-05-24T23-18-29-427Z-8bb6f43e` 有完整 `process-handoff.md/json`、`result.json`、`final.md`，源码零 diff；审计结论经主控复核后作为下一刀参考：table/image overlay anchor、`block_label_for_element`、`target_element` 等仍可继续拆，event listener / host bridge / `on_selection_change` 继续留在 `lib.rs`。
  - Worker C `/mnt/Data1T/mnote-worktrees/0525-ae-worker-c-3-20-upload-target-readonly`，run `reasonix-2026-05-24T23-18-29-419Z-3e999c4d` 有完整 handoff/result，源码零 diff；结论归 3-20 事实源：`resolveFileTreeUploadTarget` 暂不迁，`refreshLocalFolderSidebarSnapshot` 仍留 shell，append/reveal 系列已足够外置。
@@ -287,6 +287,10 @@ UI / 浏览器可见项必须有真实浏览器截图或结构化 smoke 证据
  - 审计结论经 Codex 复核后采纳：`handle_lane_left(stage_rect_width)` 属于 editor layout helper，不应迁入 `editor_runtime/block_dnd.rs`；若继续推进 DnD 边界，下一刀应迁 `pointer_in_handle_corridor` 这一层 DOM 查询包装，而不是复制 `CONTENT_COLUMN_*` / `HANDLE_*` 常量。
  - Codex 主控完成后续小切片：`editor_runtime/block_dnd.rs` 新增 `pointer_in_handle_corridor(client_x, client_y, block, handle_selector, handle_left_fallback, handle_width)`，承接 block/stage/handle DOM 查询与 `HandleCorridorGeometry` 组装；`lib.rs` 删除同名 wrapper，调用点改为显式委托 `block_dnd` helper，并继续由壳层传入 `handle_lane_left(stage_rect.width())` fallback，不复制布局常量。
  - 已验证：`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`、临时当前源码服务 `MNOTE_WEB_BIND=127.0.0.1:3018 MNOTE_WEB_PUBLIC_BIND=127.0.0.1:3018 cargo run --manifest-path rust/Cargo.toml -p mnote-web`、`MNOTE_WEB_SMOKE_BASE_URL=http://127.0.0.1:3018 NODE_PATH=/mnt/Data1T/mnote/node_modules node scripts/task489-block-menu-delete-undo-smoke.js`、`MNOTE_WEB_SMOKE_BASE_URL=http://127.0.0.1:3018 NODE_PATH=/mnt/Data1T/mnote/node_modules node scripts/task488-local-attachment-link-delete-undo-smoke.js`、`MNOTE_WEB_SMOKE_BASE_URL=http://127.0.0.1:3018 NODE_PATH=/mnt/Data1T/mnote/node_modules node scripts/task479-local-folder-markdown-resource-lifecycle-smoke.js`。
+- 2026-05-25：Batch BB 由 Codex 主控按当前 goal 明确派发 4 个独立 worktree worker；其中 5-29 侧 Worker A 只产出候选 patch，最终未直接采纳。
+  - Worker A `/mnt/Data1T/mnote-worktrees/0525-af-worker-a-5-29-block-label-helper`，run `reasonix-2026-05-24T23-33-43-253Z-8083f267` 有完整 `process-handoff.md/json`、`result.json`、`final.md`，worktree diff 只涉及 `block_label_for_element` 从 `lib.rs` 迁到 `editor_runtime/block_dnd.rs`。主控读取 Hindsight recall、handoff 与 diff 后裁决：不直接采纳该候选 patch，因为当前主工作区已存在更贴近 `HoveredBlockState` 所属边界的本地实现，`block_label_for_element` 已迁入 `editor_runtime/block_hover_state.rs`，与该候选的 `block_dnd.rs` 归属不同。
+  - 采纳规则执行：本批不把 Worker A diff 合入主工作区，只把它作为“block label helper 已适合迁出 `lib.rs`”的旁证；实际主链以后续主控本地切片 `block_hover_state.rs` 为准，不重复记录第二条实现真相。
+  - 本批 5-29 结论：`block_label_for_element` 已完成从 `lib.rs` 迁出，但应归 `block_hover_state` 而非 `block_dnd`；后续 5-29 Reasonix 实现 worker 如涉及同一区域，必须先避开主工作区现有未提交 Rust 改动，再由 Codex 复核合并。
 - 2026-05-25：Batch AJ 未派发 Reasonix worker；主控直接收口 `hovered_block_from_target` 的共享 DnD/hover 解析层。
  - 修改：`editor_runtime/block_dnd.rs` 新增 `hovered_block_from_target(target, root, handle_selector)`，承接 `target_element`、handle shell 过滤、direct block index 解析和 `block_state_from_index(index)` 委托；`lib.rs` 的同名函数退化为只负责获取 `editor_root_element()` 后调用 runtime helper。
  - 边界：未迁 `hovered_block_from_selection`、`drop_indicator_from_target`、`drop_indicator_from_point`、drag/drop listener、keyboard signal 分支或 block reorder 行为；本批只外置共享 target -> `HoveredBlockState` 解析层。