lix/mnote
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

test: 收口本地文件夹垃圾箱 A3 smoke

Browse Source
This commit is contained in:
lix-2026
2026-05-21 15:07:00 +08:00
parent 83ad32dd67
commit e709c0705c
12 changed files with 1205 additions and 7 deletions
Download Patch File Download Diff File Expand all files Collapse all files
.codex/reasonix-tasks/results/batch-a3-worker-a-empty-trash.md
+103
View File
@@ -0,0 +1,103 @@
# Batch A3 Worker A：local folder empty-trash UI smoke
> 更新时间：2026-05-22
> 任务：`task474-local-folder-empty-trash-ui-smoke`
## 修改文件
| 文件 | 操作 |
|------|------|
| `scripts/task474-local-folder-empty-trash-ui-smoke.js` | 新增 |
| `design/04-tree-domain/process/4-34-filetree-trash-dual-browser-no-refresh-v1.md` | 更新验收矩阵、执行记录、边界和完成标准 |
| `.codex/reasonix-tasks/results/batch-a3-worker-a-empty-trash.md` | 本文件 |
## Smoke 覆盖内容
### 测试场景
- **临时 local folder root**：创建松散 Markdown 页面 (`docs/test-page.md`) 和非 md 资源 (`docs/resource.txt`)
- **归档到垃圾箱**：通过 `POST /api/tree/commands` 将两个条目都 `delete` 进入 `.mnote/trash/`
- **打开 trash 页**：`/trash?sourceKind=local_folder&rootUri=file://...`
- **清空页面垃圾箱**：
- 点击 `data-trash-action="local-empty-documents"` 按钮
- accept `window.confirm('清空后无法恢复，确定继续吗？')`
- 断言：MD trash row 消失、资源行仍然存在、`trash-index.json` 中 MD entry 删除、trash 文件删除、按钮变为 disabled
- 导航断言：全程 `framenavigated` delta = 0
- **清空资源垃圾箱**：
- 点击 `data-trash-action="local-empty-resources"` 按钮
- accept confirm dialog
- 断言：资源 trash row 消失、`trash-index.json` 中资源 entry 删除、trash 文件删除、按钮变为 disabled
- 导航断言：全程 `framenavigated` delta = 0
- **最终验证**：`trash-index.json` 为空、原始源文件未恢复
### 关键选择器
| 元素 | 选择器 |
|------|--------|
| Trash workbench | `[data-testid="mnote-trash-workbench"][data-trash-source-kind="local_folder"]` |
| 清空页面垃圾箱 | `[data-trash-action="local-empty-documents"]` |
| 清空资源垃圾箱 | `[data-trash-action="local-empty-resources"]` |
| MD trash row | `article[data-trash-row="local"][data-trash-entry-id="local-md:docs~2Ftest-page.md"]` |
| Asset trash row | `article[data-trash-row="local"][data-trash-entry-id="local-file:docs/resource.txt"]` |
| Confirm 文本 | `'清空后无法恢复，确定继续吗？'` |
### 数据流
```
postTreeCommand(delete, "local-md:docs~2Ftest-page.md")
→ tree.resource.archive → 文件移至 .mnote/trash/ → trash-index.json 记录
postTreeCommand(delete, "local-file:docs/resource.txt")
→ tree.resource.archive → 文件移至 .mnote/trash/ → trash-index.json 记录
→ 打开 /trash → 两行可见
→ 点击 empty-documents → confirm.accept → Promise.all(rows.map purge) → refresh() (fetch+DOMParser)
→ MD 行消失，按钮 disabled，trash-index 清理，trash 文件删除，framenavigated=0
→ 点击 empty-resources → confirm.accept → Promise.all(rows.map purge) → refresh()
→ 资源行消失，按钮 disabled，trash-index 为空，trash 文件删除，framenavigated=0
```
## 验证命令和结果
```bash
# 语法验证
node --check scripts/task474-local-folder-empty-trash-ui-smoke.js
# → exit 0
# Codex 复核：最新 mnote-web 临时端口 3014 + Chromium 实跑
MNOTE_WEB_SMOKE_BASE_URL=http://127.0.0.1:3014 \
PLAYWRIGHT_CHROMIUM_EXECUTABLE_PATH=/usr/bin/google-chrome-stable \
node scripts/task474-local-folder-empty-trash-ui-smoke.js
# → exit 0
# → 写入 tmp/task474-local-folder-empty-trash-ui-smoke/result.json
```
Codex 复核结果：
- `result.json.ok=true`
- `emptyDocuments.navDelta=0`
- `emptyResources.navDelta=0`
- `emptyDocuments.mdEntryClean=true`
- `emptyResources.assetEntryClean=true`
- `steps.length=5`
Reasonix Browser Worker 也已独立复测，输出：
- `tmp/reasonix-batch-a3-browser-task474-empty-trash-2026-05-21/result.json`
- `tmp/reasonix-batch-a3-browser-task474-empty-trash-2026-05-21/trash-workbench-empty.png`
- `tmp/reasonix-batch-a3-browser-task474-empty-trash-2026-05-21/trash-workbench-ui.png`
## 更新到 4-34 的内容
1. **验收矩阵**：local folder Markdown 和 local folder 非 md 资源两行的 empty-trash 列已从 `❌ 未覆盖` 改为 `✅ task474 UI empty-trash`
2. **执行记录**：在 3.5 末尾追加 task474 的覆盖说明
3. **当前边界**：补充 task474 覆盖的 empty-trash 项
4. **完成标准**：local folder 子项增加 `474`
## 未完成项 / 风险
| # | 项 | 状态 | 说明 |
|---|-----|------|------|
| 1 | bundled Markdown empty-trash | ❌ 未覆盖 | task474 只验证了松散 `.md` 的 empty-trash；bundled Markdown page（目录含 `Page.md`）未覆盖。empty-trash 操作通过 `data-resource-kind="markdown"/"markdown_bundle"` 选择器选择行，理论上 bundled Markdown 也会被选中，但未实地验证 |
| 2 | 双浏览器 empty-trash 实时性 | ❌ 未验证 | task474 是单浏览器 UI smoke（A 浏览器操作 + 断言）。B 浏览器不刷新可见更新（Convex 双浏览器矩阵）未覆盖。当前 local folder trash 的 `refresh()` 只刷新 A 浏览器自身 DOM，`tree:delta resync_required` 事件不推送跨浏览器 |
| 3 | 3000 未重新编译 | ✅ 已处理 | Codex 已在最新临时端口 `3014` 实跑通过 |
| 4 | GitHub 资源空 trash 后按钮状态 | ✅ 已验证 | 脚本断言清空后按钮变为 disabled |
| 5 | 大文件 empty-trash | ❌ 未验证 | 脚本仅用了几 KB 的小文件；大 trash 数量的 `refresh()` 性能未覆盖 |
.codex/reasonix-tasks/results/batch-a3-worker-b-markdown-lifecycle.md
+60
View File
@@ -0,0 +1,60 @@
# Batch A3 Worker B — Local folder Markdown trash lifecycle smoke
## 修改文件
| 文件 | 操作 | 说明 |
| --- | --- | --- |
| `scripts/task475-local-folder-markdown-trash-lifecycle-smoke.js` | 新增 | loose Markdown 页面的 delete/restore/delete+purge 完整生命周期 smoke |
| `design/04-tree-domain/process/4-34-filetree-trash-dual-browser-no-refresh-v1.md` | 修改 | 更新验收矩阵、审计结论、执行记录、边界和完成标准 |
## Smoke 覆盖内容
- **测试对象**：loose Markdown 页面（非 bundle 目录形式），`docs/test-page.md`
- **documentId 格式**：`local-md:docs~2Ftest-page.md`
- **API 路径**：`POST /api/tree/commands` with `sourceKind: "local_folder"`
- **5 个步骤**：
1. `delete` → 源 `.md` 消失，`.mnote/trash` 出现对应文件，`trash-index.json` 记录 `local-md:*` entry
2. `restore` → `.md` 回原路径（内容不变），trash 文件消失，index 清理
3. 再次 `delete` → 同步骤 1，验证可重复
4. `purge` → 源路径与 trash 路径均不存在，index 清理
5. 重建后 delete+purge 周期 → `trash-index.json` 仍为合法 JSON
## 当前实现观察
- `trash_local_markdown_page` 响应**不包含** `canonicalCommand` 字段（与 `trash_local_raw_file` / `trash_local_directory` 不同，后两者返回 `"canonicalCommand": "tree.resource.archive"`）
- `restore_local_markdown_page` 响应包含 `previousDocumentId`、`relativePath`、`documentId`
- `purge_local_markdown_page` 响应包含 `ok: true`
## 未覆盖：bundled Markdown
bundled Markdown（页面目录形式，含 `Page.md` + 资源文件）未在 smoke 中覆盖，原因：
- `trash_local_markdown_page` 会将 bundle 目录整体移入 trash（`resourceKind: "markdown_bundle"`），涉及目录遍历和子文件处理
- `restore_local_markdown_bundle` 路径还原有额外逻辑（同名冲突处理等）
- Rust 单测已覆盖：
- `local_tree_command_manages_loose_markdown_like_regular_file`（loose rename/copy/delete/restore）
- `local_tree_command_delete_page_bundle_directory_uses_page_trash`（bundle delete/restore）
- `local_tree_command_delete_local_file_id_uses_trash_index`（local file trash/restore/purge）
- `local_tree_command_delete_chinese_named_asset_in_subdir_uses_trash_index`（中文资源名 trash 周期）
bundled Markdown case 可在后续独立编写——需构造含 `Page.md` 和附件的页面目录，验证 bundle 整体移入/移出 trash。
## 验证命令和结果
```bash
# 语法检查
node --check scripts/task475-local-folder-markdown-trash-lifecycle-smoke.js # exit 0
# 运行 smoke（需要 mnote-web 在 3000 运行）
node scripts/task475-local-folder-markdown-trash-lifecycle-smoke.js
# 输出: task475 local folder Markdown trash lifecycle smoke passed
# result: tmp/task475-local-folder-markdown-trash-lifecycle-smoke/result.json
```
## 风险
| 风险 | 说明 |
| --- | --- |
| canonicalCommand 缺失 | loose Markdown 的 `delete`/`restore`/`purge` 响应不含 `canonicalCommand`，与非 md 资源 lifecycle 响应不一致。如果未来统一添加，smoke 需同步更新。 |
| trash 文件名冲突 | `next_available_path` 使用 file_stem_title 生成文件名，同名文件会附加序号（如 `test-page 2.md`）。smoke 中的路径 `trash/test-page.md` 在当前实现下恰好是单文件场景，若后续并行场景新增同名文件会冲突——但 smoke 每次使用独立 temp dir，不受影响。 |
| API 响应结构变动 | smoke 依赖 `result.result?.execution` 的 JSON 路径，若 `json_response` 包装层变动需同步更新。 |
.codex/reasonix-tasks/results/batch-a3-worker-c-doc-archive.md
+29
View File
@@ -0,0 +1,29 @@
# Batch A3 Worker C — 4-34 / 4-46 / 4-47 归档审查
## 结论
Codex 已完成 Worker C 归档审查，`4-34`、`4-46`、`4-47` 均满足归档条件并移动到 `design/04-tree-domain/done/`。
## 移动文件
| 来源 | 目标 |
| --- | --- |
| `design/04-tree-domain/process/4-34-filetree-trash-dual-browser-no-refresh-v1.md` | `design/04-tree-domain/done/4-34-filetree-trash-dual-browser-no-refresh-v1.md` |
| `design/04-tree-domain/process/4-46-batch-a-filetree-action-trash-smoke-execution-checklist-v1.md` | `design/04-tree-domain/done/4-46-batch-a-filetree-action-trash-smoke-execution-checklist-v1.md` |
| `design/04-tree-domain/process/4-47-batch-a3-local-folder-trash-final-smoke-checklist-v1.md` | `design/04-tree-domain/done/4-47-batch-a3-local-folder-trash-final-smoke-checklist-v1.md` |
## 归档依据
- `task474-local-folder-empty-trash-ui-smoke.js` 通过，覆盖 local folder 页面垃圾箱与资源垃圾箱清空 UI。
- `task475-local-folder-markdown-trash-lifecycle-smoke.js` 通过，覆盖 loose Markdown 页面 delete / restore / purge 生命周期。
- Codex 在最新临时 `mnote-web` `http://127.0.0.1:3014` 上独立复跑 `task474` / `task475` 均通过。
- Reasonix Browser Worker 复测 `task474` 并输出截图：
- `tmp/reasonix-batch-a3-browser-task474-empty-trash-2026-05-21/result.json`
- `tmp/reasonix-batch-a3-browser-task474-empty-trash-2026-05-21/trash-workbench-empty.png`
- `tmp/reasonix-batch-a3-browser-task474-empty-trash-2026-05-21/trash-workbench-ui.png`
- `4-28`、`4-44`、`4-45` 已在前序 Batch A/A2 归档，`4-46` 的 Batch A P0 目标已闭环。
## 保留边界
- bundled Markdown 目录形式未新增 JS smoke，但已有 Rust 单测覆盖；后续如要补浏览器矩阵，应另开小 checklist。
- local folder 的跨浏览器实时推送不是本批目标；本批验证的是 local-first trash workbench 的 UI 清空与 no-navigation 行为。