mnote/design/10-review/done/19-non-lightrag-design-cleanup-followup-checklist-v1.md

# 19 Non-LightRAG design cleanup and follow-up checklist v1

> 创建时间：2026-06-06
>
> 状态：`done`
>
> Owner：10-review / 03-rust-web / 05-editor-mainline / 07-ai

## 1. 边界

当前另一个 agent 正在修改 LightRAG 相关实现与设计。本 checklist 暂不写 `design/07-ai/done/7-50-lightrag-knowledge-rag-provider-v1.md`、`rust/crates/mnote-web/src/routes/knowledge_rag.rs`、`rust/crates/mnote-web/src/hermes_tools/knowledge_rag.rs` 或 LightRAG smoke。等对方改动稳定后，再单独做 LightRAG diff review。

本轮先减少非 LightRAG 设计误读：关闭已完成 process、降级历史快照、把真实未完成项拆成更小 checklist。

## 2. 已执行清理

- [x] `4-25-filetree-view-state-model-driven-lazy-reveal-v1.md` 从 `04-tree-domain/process/` 移到 `04-tree-domain/done/`，并标注历史 18 秒冷加载当前未复现。
- [x] `3-23-sidebar-local-folder-resource-runtime-followup-v1.md` 从 `03-rust-web/process/` 移到 `03-rust-web/reference/`，并固定 `refreshLocalFolderSidebarSnapshot` 的 shell 编排边界。
- [x] `5-13-tiptap-runtime-cold-load-mindmap-split-checklist-v1.md` 从 `05-editor-mainline/process/` 移到 `05-editor-mainline/done/`，只归档 mindmap 重包拆分。
- [x] 新增并复核 `5-36-tiptap-real-shell-cold-load-followup-v1.md`。当前 checkout 未复现 18 秒冷加载，已降级为 `05-editor-mainline/reference/`。
- [x] 给 `3-6-rust-web-main-execution-plane-checklist-v1.md` 增加历史快照说明，避免从旧 `[ ]` 项继续派活。
- [x] 收紧 `10-current-mnote-ai-runtime-review-v1.md` 的 `mnote.doc.markdown_edit` 口径，避免把历史工具描述成 local-first 新 agent fallback。

## 3. 下一批非 LightRAG checklist

### P0：Tiptap real shell cold-load

- [x] 执行 7-45 当前 checkout 临时复核：`domContentLoadedMs=102`、`editorVisibleMs=271`、`tableVisibleMs=274`、`mindmapRuntimeRequested=false`。
- [x] 因未复现，`5-36` 降为 reference；暂不改 modulepreload、runtime prewarm 或非关键 surface 初始化顺序。

### P1：Local-folder event bus

- [x] 已完成并归档 `design/03-rust-web/done/3-24-local-folder-browser-event-bus-v1.md`。
- [x] sidebar、document session、resource tab 已订阅同一 local-folder event bus。
- [x] `task540` 已验证同一页面只有一个 local-folder EventSource，且后台写入仍能触发 document refresh 与 localized filetree refresh。

### P2：Page Aggregate local-first hard guard

- [x] 已完成并归档 `design/05-editor-mainline/done/5-36-page-aggregate-local-first-hard-guard-v1.md`。
- [x] 对 `compat.legacy_content` fallback 增加 local-first DOM diagnostic，`task541` 断言 local `.md` 为 `page_aggregate.block_document`。
- [x] 保存链路未扩大 legacyBlocks 使用面，`task167` 覆盖 local-first title/body/options 写入回读。

### P3：7-18 agent edit clean/dirty smoke

- [x] 在不碰 LightRAG 的前提下，拆出并完成 `design/07-ai/done/7-18-agent-edit-clean-dirty-smoke-checklist-v1.md`。
- [x] 验 clean buffer：agent 原生 patch 修改当前 `.md` 后，watcher -> BufferStore -> Page Aggregate -> ProseMirror 可见更新。
- [x] 验 dirty buffer：外部 agent 写入不会静默覆盖，必须出现冲突或 review 状态。
- [x] 验 readonly：写入型 run 在 ACP/tool 层前置拒绝，而不是只靠审计后置记录。
- [x] 剩余归档项已在 `design/10-review/done/20-post-lightrag-runtime-hardening-checklist-v1.md` P1 完成：补真实后端 auditScope / allowed root 外写入拒绝证据后归档 7-18。

### P4：LightRAG post-commit audit gate

- [x] LightRAG 已提交并统一为 7-50 主线，旧 LiteParse / evidence / local OCR 默认路径已退役。
- [x] 只读检查 7-50 post-commit 状态。
- [x] 重点核对 source registry、watcher stale/delete/reindex、query scope、`locatorDegraded`、status bridge、image wrapper 与 smoke 是否互相一致。
- [x] 发现的硬化项已拆到 `20-post-lightrag-runtime-hardening-checklist-v1.md` 并完成 `design/07-ai/done/7-51-lightrag-post-commit-hardening-v1.md`。

### P5：7-47 capability registry / local search / design governance follow-up

- [x] `20-post-lightrag-runtime-hardening-checklist-v1.md` 已继续完成 capability registry 口径重写、local search 边界和 design 状态治理。
- [x] `7-46` / `7-48` 已降级到 `design/07-ai/reference/`，避免 worker 继续按旧 evidence / LiteParse 主线派活。

## 4. 非目标

- 不在本 checklist 中修改 LightRAG 实现。
- 不删除历史设计证据；只通过移动目录、状态说明和新 checklist 降低误读。
- 不把已归档文件中的旧 checklist 当作新 worker 的任务来源。