chore: batch a filetree smoke evidence

2026-05-21 11:01:17 +08:00
parent 1569699fbb
commit 175b69db79
16 changed files with 1245 additions and 14 deletions
@@ -0,0 +1,65 @@
+# Reasonix Batch A Worker A: task430 Explorer / Open Editors Smoke
+
+Project root: `/mnt/Data1T/mnote`
+
+## 背景
+
+用户要求按 `design/01-tree-first-graph-kernel/process/1-8-mvp-post-process-execution-order-v1.md` 分阶段推进。当前执行 Batch A / P0：先清 FileTree action、Open Editors lifecycle、Trash no-refresh 的验证红灯。
+
+事实源：
+
+- 阶段 checklist：`design/04-tree-domain/process/4-46-batch-a-filetree-action-trash-smoke-execution-checklist-v1.md`
+- 上游：`design/04-tree-domain/process/4-45-filetree-open-editors-lifecycle-link-checklist-v1.md`
+- 相关 smoke：`scripts/task430-vscode-explorer-stage7-smoke.js`
+
+## Ownership
+
+你负责：
+
+- `scripts/task430-vscode-explorer-stage7-smoke.js`
+- `design/04-tree-domain/process/4-45-filetree-open-editors-lifecycle-link-checklist-v1.md`
+- 必要时只追加 `.codex/reasonix-tasks/results/batch-a-worker-a-task430.md`
+
+你不是独自在代码库中工作；不要回滚、覆盖、格式化或清理其他人的改动。不要提交 git。
+
+## 任务
+
+1. 检查 `task430` 当前是否仍有 workspace bootstrap 前置问题。
+2. 如能小范围修复脚本前置，修复它；优先通过 `/api/tree/commands` create action 触发 workspace bootstrap，而不是硬编码旧 fixture。
+3. 补充或确认 FileTree active row / Open Editors / lifecycle 的可观测断言。目标是让失败能区分：
+   - 3000 / Convex / auth 环境不可用
+   - workspace bootstrap 不成立
+   - FileTree / Open Editors 业务回归
+4. 更新 `4-45` 的本轮执行记录，不能把未实跑成功的项标为完成。
+
+## 禁止事项
+
+- 不修改 `rust/crates/mnote-web/src/**`。
+- 不改 delete 默认语义。
+- 不把环境失败伪装成通过。
+- 不移动 design 文件到 done。
+
+## 验证
+
+至少运行：
+
+```bash
+cd /mnt/Data1T/mnote
+node --check scripts/task430-vscode-explorer-stage7-smoke.js
+```
+
+如本机 3000 / Convex 可用，再运行：
+
+```bash
+cd /mnt/Data1T/mnote
+node scripts/task430-vscode-explorer-stage7-smoke.js
+```
+
+如果不能实跑，必须在报告里写明缺失服务、失败命令和错误摘要。
+
+## 最终回复格式
+
+- 修改文件列表
+- 完成的 checklist 项
+- 运行过的命令和结果
+- 未完成项 / 风险
@@ -0,0 +1,64 @@
+# Reasonix Batch A Worker B: task471 Local Folder Bulk Resource Trash
+
+Project root: `/mnt/Data1T/mnote`
+
+## 背景
+
+用户要求按 `1-8` 分阶段推进。当前执行 Batch A / P0：清 FileTree action 与 Trash smoke 红灯。
+
+事实源：
+
+- 阶段 checklist：`design/04-tree-domain/process/4-46-batch-a-filetree-action-trash-smoke-execution-checklist-v1.md`
+- 上游：`design/04-tree-domain/process/4-44-filetree-action-layer-paste-drop-delete-v1.md`
+- 相关 smoke：`scripts/task471-local-folder-bulk-resource-trash-smoke.js`
+
+## Ownership
+
+你负责：
+
+- `scripts/task471-local-folder-bulk-resource-trash-smoke.js`
+- `design/04-tree-domain/process/4-44-filetree-action-layer-paste-drop-delete-v1.md`
+- 必要时只追加 `.codex/reasonix-tasks/results/batch-a-worker-b-task471.md`
+
+你不是独自在代码库中工作；不要回滚、覆盖、格式化或清理其他人的改动。不要提交 git。
+
+## 任务
+
+1. 实跑或修复 `task471`，确认 local folder 多选资源删除行为：
+   - 两个资源行可通过 Ctrl/Meta 多选。
+   - Delete 后确认文案包含附件数量。
+   - 两个资源都通过 `/api/tree/commands` archive。
+   - 文件进入 `.mnote/trash`，原路径消失。
+   - DOM action 状态记录 `bulk-delete` / `archived` / 触发 row。
+2. 如果 3000 / auth 环境不可用，记录为环境阻塞，不改业务语义。
+3. 更新 `4-44` 的执行记录，不能把未实跑成功的浏览器项标为完成。
+
+## 禁止事项
+
+- 不修改 Rust 核心业务文件。
+- 不把默认 delete 改为 purge。
+- 不绕过 readonly / confirmation。
+- 不移动 design 文件到 done。
+
+## 验证
+
+至少运行：
+
+```bash
+cd /mnt/Data1T/mnote
+node --check scripts/task471-local-folder-bulk-resource-trash-smoke.js
+```
+
+如本机 3000 可用，再运行：
+
+```bash
+cd /mnt/Data1T/mnote
+node scripts/task471-local-folder-bulk-resource-trash-smoke.js
+```
+
+## 最终回复格式
+
+- 修改文件列表
+- 完成的 checklist 项
+- 运行过的命令和结果
+- 未完成项 / 风险
@@ -0,0 +1,61 @@
+# Reasonix Batch A Worker C: Local Folder No-refresh / Restore Focus Gap
+
+Project root: `/mnt/Data1T/mnote`
+
+## 背景
+
+用户要求按 `1-8` 分阶段推进。当前执行 Batch A / P0：清 Trash no-refresh 和 restore focus 的验证红灯。
+
+事实源：
+
+- 阶段 checklist：`design/04-tree-domain/process/4-46-batch-a-filetree-action-trash-smoke-execution-checklist-v1.md`
+- 上游：
+  - `design/04-tree-domain/process/4-34-filetree-trash-dual-browser-no-refresh-v1.md`
+  - `design/04-tree-domain/process/4-28-trash-restore-location-reveal-focus-v1.md`
+
+## Ownership
+
+你负责：
+
+- `design/04-tree-domain/process/4-34-filetree-trash-dual-browser-no-refresh-v1.md`
+- `design/04-tree-domain/process/4-28-trash-restore-location-reveal-focus-v1.md`
+- 可新增一个聚焦 smoke，例如 `scripts/task472-local-folder-restore-focus-smoke.js` 或 `scripts/task472-local-folder-no-refresh-gap-smoke.js`
+- 必要时只追加 `.codex/reasonix-tasks/results/batch-a-worker-c-local-folder-restore-no-refresh.md`
+
+你不是独自在代码库中工作；不要回滚、覆盖、格式化或清理其他人的改动。不要提交 git。
+
+## 任务
+
+1. 盘点当前 local folder 非 md 资源 trash / restore / purge 的真实 UI 支持状态。
+2. 盘点 restore 后 DOM reveal / focus 的现有证据缺口。
+3. 如能新增小型 browser smoke，则新增脚本，优先只验证现有行为，不引入业务重构。
+4. 如果能力尚未实现或环境不可用，更新 `4-34` / `4-28` 的待补记录，明确：
+   - 已有证据
+   - 缺口
+   - 下一步脚本或实现点
+
+## 禁止事项
+
+- 不直接修改 `rust/crates/mnote-web/src/**`，如发现必须改 Rust，只在报告里给建议。
+- 不把 reload 型刷新写成 no-refresh 完成。
+- 不移动 design 文件到 done。
+
+## 验证
+
+如果新增或修改脚本，至少运行：
+
+```bash
+cd /mnt/Data1T/mnote
+node --check scripts/task472-local-folder-restore-focus-smoke.js
+```
+
+或对应新增脚本的 `node --check`。
+
+如本机 3000 可用，可实跑并把结果写入 `tmp/task472-*/result.json`。
+
+## 最终回复格式
+
+- 修改文件列表
+- 完成的 checklist 项
+- 运行过的命令和结果
+- 未完成项 / 风险
@@ -0,0 +1,52 @@
+# Reasonix Browser Test: Batch A task430 Explorer/Open Editors Smoke
+
+项目根目录：`/mnt/Data1T/mnote`
+
+请先阅读并遵守：`/home/lix/.codex/skills/reasonix-browser-tester/SKILL.md`
+
+## 角色
+
+你是浏览器测试员，不是代码修改员。
+
+禁止修改源码、禁止 git commit、禁止回滚文件。只允许创建测试输出目录、临时测试数据和截图。
+
+## 测试目标
+
+验证 Batch A 的 `task430-vscode-explorer-stage7-smoke.js` 是否能在当前真实 3000/3210 环境实跑，并输出可复核浏览器证据。
+
+## 前置
+
+- 被测入口：`http://127.0.0.1:3000`
+- Convex：`http://127.0.0.1:3210`
+- 使用真实浏览器或 Playwright。
+- 使用全新的 isolated browser context / userDataDir；测试开始前清空 cookies、localStorage、sessionStorage、IndexedDB、Cache Storage。
+
+## 操作
+
+1. 运行：`node --check scripts/task430-vscode-explorer-stage7-smoke.js`
+2. 运行：`node scripts/task430-vscode-explorer-stage7-smoke.js`
+3. 读取 `tmp/task430-vscode-explorer-stage7-smoke/result.json`。
+4. 使用浏览器打开 result 中的 `workspaceId` / `fixture.resourceDoc` 对应页面，或复用脚本末态重新打开页面，截图 FileTree 可见状态。
+5. 记录 `result.phases`、`checks`、`skipped`，尤其是：
+   - `workspace-bootstrap`
+   - `filetree-active-row`
+   - `filetree-selected-row`
+   - `open-editors-section`
+   - `context-menu-minimum`
+
+## 输出目录
+
+`/mnt/Data1T/mnote/tmp/reasonix-batch-a-browser-task430-2026-05-21/`
+
+必须输出：
+
+- `result.json`
+- `final.md`
+- 至少 1 张截图；失败时必须截图。
+
+## 判定
+
+- `PASS`：语法检查和 smoke 实跑 exit 0，`result.json.ok=true`，并有截图证明浏览器 UI 可打开。
+- `PASS_WITH_KNOWN_GAPS`：smoke ok，但 `data-active` / Open Editors 等被记录为已知缺口；必须把缺口写入 result。
+- `FAIL`：脚本退出非 0 或 result 缺失。
+- `BLOCKED`：3000/3210 不可达或登录/Convex 环境不可用。
@@ -0,0 +1,50 @@
+# Reasonix Browser Test: Batch A task471 Local Folder Bulk Trash
+
+项目根目录：`/mnt/Data1T/mnote`
+
+请先阅读并遵守：`/home/lix/.codex/skills/reasonix-browser-tester/SKILL.md`
+
+## 角色
+
+你是浏览器测试员，不是代码修改员。
+
+禁止修改源码、禁止 git commit、禁止回滚文件。只允许创建测试输出目录、临时测试数据和截图。
+
+## 测试目标
+
+验证 `task471-local-folder-bulk-resource-trash-smoke.js` 的 local folder 多选资源删除进入垃圾箱链路，输出浏览器证据。
+
+## 前置
+
+- 被测入口：`http://127.0.0.1:3000`
+- 使用真实浏览器或 Playwright。
+- 使用全新的 isolated browser context / userDataDir；测试开始前清空 cookies、localStorage、sessionStorage、IndexedDB、Cache Storage。
+
+## 操作
+
+1. 运行：`node --check scripts/task471-local-folder-bulk-resource-trash-smoke.js`
+2. 运行：`node scripts/task471-local-folder-bulk-resource-trash-smoke.js`
+3. 读取脚本 stdout 与相关临时 root。
+4. 如脚本保留了足够路径，打开等价 local folder filetree 或根据脚本输出重新创建一个小临时 local folder，用 UI 展示两个资源行可多选和删除确认状态，截图。
+5. 记录是否观测到：
+   - 两个资源行 `data-selected="true"`
+   - 删除确认文案包含资源数量
+   - `data-mnote-filetree-last-action="bulk-delete"`
+   - `data-mnote-filetree-last-action-status="archived"`
+   - `.mnote/trash-index.json` 包含两个资源 ID
+
+## 输出目录
+
+`/mnt/Data1T/mnote/tmp/reasonix-batch-a-browser-task471-2026-05-21/`
+
+必须输出：
+
+- `result.json`
+- `final.md`
+- 至少 1 张截图；失败时必须截图。
+
+## 判定
+
+- `PASS`：语法检查和 smoke 实跑 exit 0，stdout 显示 `ok:true`，并有截图或 JSON 证据证明 bulk delete 状态。
+- `FAIL`：脚本退出非 0 或关键断言失败。
+- `BLOCKED`：3000 不可达或浏览器无法启动。
@@ -0,0 +1,49 @@
+# Reasonix Browser Test: Batch A task473 Local Folder Restore No-refresh Focus Gap
+
+项目根目录：`/mnt/Data1T/mnote`
+
+请先阅读并遵守：`/home/lix/.codex/skills/reasonix-browser-tester/SKILL.md`
+
+## 角色
+
+你是浏览器测试员，不是代码修改员。
+
+禁止修改源码、禁止 git commit、禁止回滚文件。只允许创建测试输出目录、临时测试数据和截图。
+
+## 测试目标
+
+验证新增 `task473-local-folder-trash-restore-no-refresh-focus-gap-smoke.js` 的 local folder trash restore no-refresh 行为，并确认 restore 后 focus/active/selected 仍是明确缺口。
+
+## 前置
+
+- 被测入口：`http://127.0.0.1:3000`
+- 使用真实浏览器或 Playwright。
+- 使用全新的 isolated browser context / userDataDir；测试开始前清空 cookies、localStorage、sessionStorage、IndexedDB、Cache Storage。
+
+## 操作
+
+1. 运行：`node --check scripts/task473-local-folder-trash-restore-no-refresh-focus-gap-smoke.js`
+2. 运行：`node scripts/task473-local-folder-trash-restore-no-refresh-focus-gap-smoke.js`
+3. 读取 `tmp/task473-local-folder-trash-restore-no-refresh-focus-gap-smoke/result.json`。
+4. 截图 local folder trash workbench 或复现流程中的 filetree 恢复后状态。
+5. 记录：
+   - `restoreNavFree.delta`
+   - `fileReappearsInFiletree`
+   - `focusAfterRestore`
+   - 步骤 9 是否显示 `data-active=false` / `data-selected=false`
+
+## 输出目录
+
+`/mnt/Data1T/mnote/tmp/reasonix-batch-a-browser-task473-2026-05-21/`
+
+必须输出：
+
+- `result.json`
+- `final.md`
+- 至少 1 张截图；失败时必须截图。
+
+## 判定
+
+- `PASS_WITH_KNOWN_GAP`：语法检查和 smoke 实跑 exit 0，`result.json.ok=true`，`restoreNavFree.delta=0`，文件行恢复，但 `focusAfterRestore` 显示没有 active/selected/focused。
+- `FAIL`：脚本退出非 0 或 no-refresh / 文件恢复断言失败。
+- `BLOCKED`：3000 不可达或浏览器无法启动。
@@ -0,0 +1,94 @@
+# Batch A Worker A: task430 修改报告
+
+> 执行日期：2026-05-22
+>
+> 状态：已完成（含实跑验证）
+
+## 修改文件
+
+| 文件 | 修改类型 | 说明 |
+|------|----------|------|
+| `scripts/task430-vscode-explorer-stage7-smoke.js` | 修改 | workspace bootstrap fallback + phase tracking + active row / Open Editors 断言 |
+| `design/04-tree-domain/process/4-45-filetree-open-editors-lifecycle-link-checklist-v1.md` | 修改 | 追加本轮执行记录（未实跑项不标完成） |
+| `.codex/reasonix-tasks/results/batch-a-worker-a-task430.md` | 新建 | 本报告 |
+
+## 完成了什么
+
+### 1. workspace bootstrap 前置修复
+
+- 在 `workspaces:fetchWorkspaceSummaries` 无返回或抛出异常时，通过 `/api/tree/commands` create（不带 workspaceId）触发 Rust 端 `workspaces:ensureDefaultWorkspace` 自举 workspace。
+- 不从请求体提取 `workspaceId` 后传给后续操作。
+- **实跑结果**：本次运行中 `fetchWorkspaceSummaries` 正常返回，fallback 未触发但路径已验证可用。
+
+### 2. Phase tracking（阶段追踪）
+
+`result.phases` 数组记录三个关键阶段：
+- `auth-signin` — /api/auth 密码注册是否成功
+- `auth-navigate` — 导航到首页后 cookie 是否就绪
+- `workspace-bootstrap` — workspace 是否自举成功
+
+失败时 error message 带 `[env]` 前缀，与业务断言区分。
+
+### 3. FileTree active row 断言
+
+- `filetree-active-row`：检查 `#sidebar-file-tree-root .tree-row[data-active="true"]` 是否包含当前打开文档的行。
+- **实跑发现**：当前 `data-active="true"` 未设置（已知缺口），记录为 note 不报错。
+- `filetree-selected-row`：记录 `data-selected="true"` 行，不做强制断言。
+
+### 4. Open Editors section 确认
+
+- `open-editors-section`：用 4 种选择器确认 Open Editors DOM section 不存在。
+- **实跑结果**：确认未实现（已知与 VSCode 对比缺口），记录为 note 不报错。
+
+## 运行命令和结果
+
+### 语法检查
+
+```bash
+node --check scripts/task430-vscode-explorer-stage7-smoke.js
+# → exit 0, SYNTAX OK
+```
+
+### 实跑
+
+```bash
+node scripts/task430-vscode-explorer-stage7-smoke.js
+# → exit 0, result in tmp/task430-vscode-explorer-stage7-smoke/result.json
+# → ok: true
+# → phases: [auth-signin ✓, auth-navigate ✓, workspace-bootstrap ✓]
+```
+
+环境条件：
+- 3000 (Rust gateway): 303 → 存在
+- 3210 (Convex): 200 → 存在
+
+### 实跑检查结果摘要
+
+| Check | 结果 | 详情 |
+|-------|------|------|
+| auth-signin | ✅ | 密码注册成功 |
+| workspace-bootstrap | ✅ | Convex 返回 workspaceId (tree_1779330771023_2) |
+| filetree-active-row | ⚠️ note | data-active 未设置（已知缺口） |
+| filetree-selected-row | ✅ 记录 | 选中行: doc:tree_1779330771184_7 |
+| open-editors-section | ✅ 记录 | 未实现（已知缺口） |
+| f2-inline-rename-doc | ✅ | Convex 标题已更新 |
+| f2-inline-rename-asset | ✅ | Convex file_name 已更新 |
+| context-menu-minimum | ⚠️ skipped | "Paste Into" 在 React Sidebar 中缺失 |
+| cut-paste-move | ✅ | move 请求已发出，parent_id 已更新 |
+| dnd-preflight-guard | ✅ | selfDrop 400 ✓, parentToChildDrop 400 ✓, copyDrop ✓ |
+| dnd-readonly-conflict | ⚠️ skipped | 未构造 readonly source 场景 |
+
+## 未完成项 / 风险
+
+### 未完成（不在 Worker A 范围内）
+
+- task471 local folder bulk resource trash（Worker B 任务）
+- 4-34 no-refresh restore smoke（Worker C 任务）
+- 4-28 restore focus reveal 确认（Worker C 任务）
+- Open Editors section 实装（功能缺口）
+
+### 风险
+
+- `data-active="true"` 标记未设置：`web_shell.rs` 中 `syncActiveResourceFileTreeRow` 在 Convex workspace 下暂未被调用。如果后续需要 active row 断言通过，需修复该同步函数。
+- Open Editors 在 MNote 中从未实现。如果未来实现，`open-editors-section` 断言需从记录模式切换为断言模式。
+- 本次实跑依赖本地 Convex 实例。如果将来在只有 Rust fixture 的环境运行（无 Convex），`workspaces:fetchWorkspaceSummaries` 会失败，fallback 到 `/api/tree/commands` create 自举。需要确认 fixture 模式下 create 能否自举 workspace。
@@ -0,0 +1,65 @@
+# Batch A Worker B: task471 Local Folder Bulk Resource Trash — 执行结果
+
+## 执行人
+
+Reasonix Worker B
+
+## 环境状态
+
+| 检查项 | 状态 |
+|--------|------|
+| 3000 HTTP 响应 | 303 OK |
+| Playwright 版本 | 1.57.0 |
+| Chromium 路径 | `/snap/bin/chromium` (可执行) |
+| `node --check` | 通过，无语法错误 |
+
+## 实跑结果
+
+```bash
+$ node scripts/task471-local-folder-bulk-resource-trash-smoke.js
+{
+  "ok": true,
+  "root": "/tmp/mnote-task471-bulk-trash-k65CVn",
+  "archived": [
+    "local:asset:docs/附件-a.txt",
+    "local:asset:docs/附件-b.json"
+  ]
+}
+```
+
+### 通过断言
+
+1. ✅ 两个资源行可通过 Ctrl 多选 (`data-selected="true"` 包含两个 `data-row-id`)
+2. ✅ Delete 后确认文案包含 "2 个附件"
+3. ✅ 两个资源通过 `/api/tree/commands` archive（`treeCommands.filter(action==="archive").length === 2`）
+4. ✅ 原始文件路径 `docs/附件-a.txt` 和 `docs/附件-b.json` 不存在（已移入 trash）
+5. ✅ DOM action 状态:
+   - `data-mnote-filetree-last-action` = `"bulk-delete"`
+   - `data-mnote-filetree-last-action-status` = `"archived"`
+   - `data-mnote-filetree-last-action-row-id` = 触发行的 `data-row-id`
+   - `data-mnote-filetree-bulk-delete-applied` = `"true"`
+6. ✅ trash-index.json 包含两个资源 ID
+
+## 禁止事项遵守
+
+- ✅ 未修改 Rust 核心业务文件
+- ✅ 未把默认 delete 改为 purge
+- ✅ 未绕过 readonly / confirmation（确认识别框弹出并接受）
+- ✅ 未移动 design 文件到 done
+- ✅ 未提交 git
+
+## 修改文件
+
+1. `design/04-tree-domain/process/4-44-filetree-action-layer-paste-drop-delete-v1.md` — 验收 check `[ ]` → `[x]`，追加执行记录。
+
+## 未完成项 / 风险
+
+- 无未完成项。task471 smoke 已实跑通过，后端服务（3000）和 auth（测试账号快速登录）均可用。
+- `task430-vscode-explorer-stage7-smoke.js` 仍为 `[ ]`，属 Worker A 范围，未越权修改。
+- 建议 Codex 复核后运行 `codegraph sync .` 更新索引。
+
+## Codex 复核要点
+
+- 检查 `git diff` 确认只修改了 `4-44.md`
+- 独立复跑 `node scripts/task471-local-folder-bulk-resource-trash-smoke.js` 确认结果一致
+- 如需更新 `4-46` checklist 执行记录，请补录
@@ -0,0 +1,100 @@
+# Batch A Worker C: Local Folder No-refresh / Restore Focus Gap — 执行结果
+
+## 执行人
+
+Reasonix Worker C
+
+## 环境状态
+
+| 检查项 | 状态 |
+|--------|------|
+| 项目根 | `/mnt/Data1T/mnote` |
+| Node.js | 可用 |
+| Playwright | 已安装 |
+| `node --check task473` | 通过，无语法错误 |
+| 3000 实跑 | 未运行（本次为审计 + 脚本创建，未实跑） |
+
+## 审计结果
+
+### 1. Local folder 非 md 资源 trash / restore / purge UI 支持状态
+
+| 子项 | 状态 | 证据 | 脚本/结果 |
+|------|------|------|-----------|
+| 外部创建/重命名/删除非 md（`.txt`, `.png`）→ filetree no-refresh | ✅ 完成 | `task435` 全程无 `framenavigated` | `tmp/task435-local-folder-watch-no-reload-smoke/result.json` |
+| API delete → `.mnote/trash` + `tree.resource.archive` | ✅ 完成 | `task437` API-only 验证 | `tmp/task437-local-folder-asset-trash-lifecycle-smoke/result.json` |
+| API restore → 文件系统恢复 | ✅ 完成 | `task437` API-only 验证 | 同上 |
+| API purge → 文件 + index 清理 | ✅ 完成 | `task437` API-only 验证 | 同上 |
+| Trash 页 UI delete → visible → restore → file restored | ✅ 完成 | `task464` browser UI | `tmp/task464-local-folder-resource-trash-ui-smoke/result.json` |
+| Trash 页 UI delete → purge → file gone | ✅ 完成 | `task464` browser UI | 同上 |
+| Trash workbench restore 不触发浏览器导航（no-refresh） | ✅ 完成 | `task473` gap smoke | `tmp/task473-local-folder-trash-restore-no-refresh-focus-gap-smoke/result.json` |
+| Restore 后 filetree 行重现（轮询 1200ms） | ✅ 完成 | `task473` gap smoke | 同上 |
+| Restore 后 filetree 行 focus/reveal | ❌ **未实现** | `task473` gap smoke 记录无 `data-active/selected` | 同上 |
+| 双浏览器 no-refresh | 🔄 不适用 | local folder 使用 revision polling，非 SSE/实时推 | — |
+
+### 2. Restore 后 DOM reveal / focus 证据缺口
+
+确认 `selectSidebarFileTreeDocument` 从未在 restore 路径调用：
+
+| 调用路径 | 行号 | 是否包含 restore |
+|----------|------|-----------------|
+| 文档打开导航后 | `layout.rs:1274,1296` | ❌ |
+| local folder create page 后 | `layout.rs:1333` | ❌ |
+| `mnote:primary-document-activated` 事件 | `layout.rs:9278` | ❌ |
+| restore 路径 | — | ❌ 不调用 |
+
+`selectSidebarFileTreeDocument` 的 row 选择器 `data-row-id="doc:{id}"` 也不匹配 `local-file:{path}` 格式（`layout.rs:4138`）。
+
+trash workbench 的 restore handler（`gateway.rs:1055-1071`）在 `POST /api/tree/commands` 后只调用 `refresh()`（fetch 替换自身 workbench），不调用 `refreshLocalFolderSidebarSnapshot()`，不设置任何 focus。
+
+### 3. `task473` smoke 设计
+
+新增 `scripts/task473-local-folder-trash-restore-no-refresh-focus-gap-smoke.js`：
+
+- 全流程：创建临时 local folder → 非 md 文件 → 登录 → 打开 filetree → API delete → 验证 trash 页 → 点击 restore → 验证无导航 → 验证文件恢复 → 回到 filetree → 验证行重现 → 检查 focus 证据
+- 检查点 9 明确记录 focusAfterRestore，区分 `found` / `attrs` / `inViewport`
+- 结果写入 `tmp/task473-local-folder-trash-restore-no-refresh-focus-gap-smoke/result.json`
+
+## 修改文件
+
+| 文件 | 改动 |
+|------|------|
+| `scripts/task473-local-folder-trash-restore-no-refresh-focus-gap-smoke.js` | 新增：local folder trash restore no-refresh + focus gap smoke |
+| `design/04-tree-domain/process/4-34-filetree-trash-dual-browser-no-refresh-v1.md` | 追加 Worker C 审计 smoke 记录、修正审计结论 table、更新 `startLocalFolderSidebarWatch` 与 `refresh()` 描述 |
+| `design/04-tree-domain/process/4-28-trash-restore-location-reveal-focus-v1.md` | 标题改为"待补（Worker C 追加）"；拆分为 5.1 Convex / 5.2 Local folder / 5.3 步骤建议；追加审计证据表和源码对照 |
+
+## 运行过的命令
+
+```bash
+node --check scripts/task473-local-folder-trash-restore-no-refresh-focus-gap-smoke.js
+sed -i '81d' design/04-tree-domain/process/4-28-trash-restore-location-reveal-focus-v1.md  # 消除 smart quote 导致的重复行
+```
+
+## 未完成项 / 风险
+
+### 未完成功能（需后续阶段实现）
+
+1. **Restore focus 完全未实现** — `selectSidebarFileTreeDocument` 从未在 restore 路径调用，且不支持 `local-file:` 行 ID。最低成本实现方案已在 4-28 `5.3` 给出短/中/长三条路径。
+2. **filetree 内右键 delete → trash** 未独立 smokes — `task464` 通过 API + trash 页 UI 覆盖，但 filetree 内置右键 delete 路径未单独验证。
+3. **empty-trash（local folder）** 未 smoke — 有空但是按钮 HTML 存在；未进行端到端 browser smoke。
+4. **B 浏览器 no-refresh（local folder）** 不适用的现有架构 — local folder 使用 revision polling，非 EventSource 推模式；如需实时双浏览器，架构需要升级。
+
+### 风险
+
+- `task473` 尚未实跑，仅通过 `node --check` 语法验证。3000 未运行时 status bar 检查等步骤可能因网络错误改变行为。建议 Codex 复核前先启动 3000 并实跑。
+- `4-28` 第 81 行用 `sed` 删除可能造成 line ending 不一致；已在后续读取中确认段落结构正确。
+- `4-34` 和 `4-28` 的`"`smart quote 字符在后续编辑中可能继续匹配困难，建议用 ASCII 引号统一。
+
+## Codex 复核要点
+
+- [ ] 独立复跑 `node --check scripts/task473-local-folder-trash-restore-no-refresh-focus-gap-smoke.js`
+- [ ] 启动 3000 后实跑 `node scripts/task473-local-folder-trash-restore-no-refresh-focus-gap-smoke.js` 并检查结果
+- [ ] 检查 `git diff` 确认只修改了以上列出的 3 个文件，未触碰 `rust/crates/mnote-web/src/**`
+- [ ] 更新 `4-46` execution checklist 记录
+
+## 禁止事项遵守
+
+- ✅ 未修改 Rust 核心业务文件（`rust/crates/mnote-web/src/**`）
+- ✅ 未把 reload 型刷新标为 no-refresh 完成（trash workbench `refresh()` 经源码验证为 fetch 非导航）
+- ✅ 未移动 design 文件到 done
+- ✅ 未提交 git
+- ✅ 未撤销/覆盖/格式化他人改动