lix/mnote

Files

T

lix-2026 47e224d419 chore: align sqlite control plane architecture

- replace default Convex control-plane wording with Rust SQLite control-plane across architecture, AGENTS, Reasonix, and design docs

- retire root Convex functions source and deploy script into recycle while keeping explicit cloud/compat/sync-replica boundaries

- add control-plane migration guard/docs and keep CodeGraph refreshed after the SQLite control-plane cutover

2026-05-22 17:45:22 +08:00

9.3 KiB

Raw Blame History

15 Design Governance MVP 后阶段 Review v1

状态：done

归档说明（2026-05-21）：四个 Reasonix worker 审查、Codex 复核、done 归档与 reference 迁移已完成；本文归档为本轮 design governance 事实源。

创建时间：2026-05-21

目标：在 local-first MVP 已初步完成、架构方向基本稳定后，统一 design/ 目录口径，归档过时 process 文档，并明确仍需继续执行的 process 文档。

1. 当前统一口径

MNote 当前已进入 local-first MVP 后阶段：

本地 workspace folder 是默认数据真相。
本地 .md 是页面正文真相。
Rust kernel / projection / command 持有树、页面、资源和权限语义。
mnote-web 是 3000 主 Web 执行面。
Rust SQLite control-plane 承接 auth、membership、share grants、sync state、AI policy、ACP/Hermes runtime session 等默认控制面；Convex / 服务端仅保留历史迁移源、显式 cloud source、compat 和 sync replica 边界。
旧 Next / React / wolai-frontend、BlockNote 默认主链、Convex 默认正文/附件/AI 会话全文主存储口径均为 legacy / recycle / compat 背景。

2. 本轮整理原则

仍代表长期方向或当前执行入口的文档保留在 process/，但必须叠加 MVP 后阶段口径。
已完成、已有真实代码或 smoke 证据的执行清单移动到同域 done/，并补充归档说明。
被后续文档覆盖、但不代表已完成的旧稿移动到 design/old/<domain>/process/，标题或开头标记 [recycle]。
参考资料、外部产品取证、长期方向说明可以保留在 process/，但需要明确“不作为当前执行 checklist”。
不把旧 Convex / Next / BlockNote 说法改写成当前主线；若保留，必须标注为历史快照或反例。

3. 并行审查切片

Worker A：01 / 02 / 03，重点判断 long-term 架构稿和 Rust Web process 是否仍应继续执行。
Worker B：04-tree-domain，重点判断 file tree / resource lifecycle / trash / open target 相关 process 是否已由近期 bug/smoke 完成。
Worker C：05-editor-mainline / 06-mindmap / 08-wolai / 09-siyuan，重点判断编辑器 tab、OnlyOffice、mindmap 和对标流程文档是否仍活跃。
Worker D：07-ai / 10-review，重点判断 AI process 与 review process 是否已被后续 Hermes/ACP/local-first 文件编辑口径覆盖。

4. Codex 归档判定状态

本轮使用以下状态：

keep-process：继续留在 process/，后续仍需执行。
mark-reference：留在 reference/，但只作为长期方向、流程或参考基线，不作为当前直接执行 checklist。
archive-done：移动到同域 done/，因为目标已完成或当前代码已覆盖。
archive-old-process：移动到 design/old/<domain>/process/ 并标 [recycle]，因为被后续稿覆盖或口径过时但未必完成。
needs-human-confirmation：证据不足，暂不移动。

5. 初步本地发现

design/01-tree-first-graph-kernel/process/1-1-* 与 design/03-rust-web/process/3-1-* 已自述为全景参考，当前优先级应由 01-05 和后续 MVP 后阶段 checklist 驱动。
design/03-rust-web/process/3-15-* 已写明代码、单测和 HTTP smoke 完成，仅真实浏览器 smoke 待补；需要核对是否已有后续真实浏览器证据。
design/04-tree-domain/process/4-38 到 4-45 是 2026-05-20 之后针对资源生命周期、open target、下载、拖拽上传等 bug 的近期 checklist，可能有部分已经由当前未提交 smoke / bug done 覆盖。
design/05-editor-mainline/process/5-15 到 5-26 初始盘点时大多是近期 main editor tab/resource open/OnlyOffice 收口 checklist；本轮已按真实代码和 smoke 证据逐项判定，5-15 到 5-25 中除继续执行项外已归档到 done/，5-26 继续保留为 active process。
design/07-ai/process/7-15 已包含大量完成记录，但仍有 HTTP proxy compat、session resume、permission loop、tool location 等后续切片，不能仅凭完成项归档。

6. 本轮不做事项

不改 design/11-wolai/ 和 design/90-reference/ 的参考资料归类。
不删除历史文档。
不把 old/ 下历史稿移动回主线。
不改代码，不跑浏览器 smoke；本轮只做设计文档治理。

7. Reasonix 并行审查结果

本轮已派发四个只读 Reasonix worker，报告路径如下：

Worker A（01/02/03）：.codex/reasonix-tasks/results/design-governance-worker-a-01-03.md
Worker B（04 tree-domain）：.codex/reasonix-tasks/results/design-governance-worker-b-04-tree.md
Worker C（05/06/08/09）：.codex/reasonix-tasks/results/design-governance-worker-c-05-06-08-09.md
Worker D（07/10）：.codex/reasonix-tasks/results/design-governance-worker-d-07-10.md

Codex 已复核 worker 输出，并额外核对 3-15 的真实浏览器 smoke 证据。

8. 本轮归档到 done

以下文档已从 process/ 移动到对应 done/，并在文件头部补充 done 状态或归档说明：

design/01-tree-first-graph-kernel/done/1-7-local-workspace-root-page-bundle-checklist-v1.md
design/02-convex-rust-long-term-architecture/done/2-3-local-workspace-access-control-productization-v1.md
design/03-rust-web/done/3-15-local-markdown-asset-upload-relative-path-v1.md
design/04-tree-domain/done/4-27-resource-lifecycle-command-cutover-v1.md
design/04-tree-domain/done/4-39-filetree-open-target-resource-identity-checklist-v1.md
design/04-tree-domain/done/4-40-resource-lifecycle-command-cutover-smoke-checklist-v1.md
design/04-tree-domain/done/4-41-filetree-bulk-resource-command-cutover-v1.md
design/04-tree-domain/done/4-42-filetree-open-target-rooturi-contract-v1.md
design/04-tree-domain/done/4-43-local-folder-sort-order-persistence-v1.md
design/05-editor-mainline/done/5-15-local-markdown-path-identity-unification-checklist-v1.md
design/05-editor-mainline/done/5-16-editor-group-resource-tab-safety-checklist-v1.md
design/05-editor-mainline/done/5-17-resource-editor-kind-and-smoke-matrix-checklist-v1.md
design/05-editor-mainline/done/5-18-main-editor-tab-state-and-error-placeholder-checklist-v1.md
design/05-editor-mainline/done/5-19-resource-open-resolver-and-onlyoffice-checklist-v1.md
design/05-editor-mainline/done/5-20-resource-tab-close-confirm-checklist-v1.md
design/05-editor-mainline/done/5-21-editor-tab-url-active-identity-checklist-v1.md
design/05-editor-mainline/done/5-22-mindmap-main-editor-tab-kind-v1.md
design/05-editor-mainline/done/5-23-editor-side-target-secondary-pane-v1.md
design/05-editor-mainline/done/5-24-open-editors-lightweight-view-checklist-v1.md
design/05-editor-mainline/done/5-25-editor-tab-keyboard-and-mru-checklist-v1.md
design/07-ai/done/7-16-page-block-ai-real-smoke-followup-matrix-v1.md
design/07-ai/done/7-30-acp-session-load-resume-checklist-v1.md
design/07-ai/done/7-31-acp-permission-decision-loop-checklist-v1.md
design/07-ai/done/7-32-acp-tool-location-and-open-action-checklist-v1.md
design/07-ai/done/7-33-acp-session-info-plan-ui-checklist-v1.md

9. 本轮迁入 reference

以下文档已迁入 reference/，不再作为当前直接执行 checklist：

design/03-rust-web/reference/3-17-convex-export-web-entry-v1.md
design/04-tree-domain/reference/4-23-local-cloud-explicit-bridge-p3-candidate-v1.md
design/05-editor-mainline/reference/5-2-tiptap-notion-like-template-adoption-v1.md
design/05-editor-mainline/reference/5-5-page-aggregate-single-truth-alignment-v1.md
design/05-editor-mainline/reference/5-7-wolai-page-tree-main-editor-experience-restoration-v1.md
design/05-editor-mainline/reference/5-14-zed-lapce-vscode-reference-adoption-matrix-v1.md
design/06-mindmap/reference/6-mindmap-leptos-adapter-reference-notes-v1.md
design/07-ai/reference/7-17-acp-session-convex-sharing-contract-v1.md
design/07-ai/reference/7-28-resource-ai-tool-contract-v1.md
design/08-wolai-aline-test-flow/reference/wolai-aline-test-flow-v1.md
design/09-siyuan-reference/reference/9-siyuan-reference-boundary-and-adoption-v1.md
design/10-review/reference/12-sidex-vscode-workbench-gap-review-v1.md
design/10-review/reference/13-hermes-vscode-plugin-gap-review-v1.md
design/10-review/reference/14-sidex-workbench-gap-followup-review-v1.md

10. 仍需继续执行的 process

本轮保留为 active process 的主要文档与原因：

01：1-tree-first-graph-kernel-v1、1-1、1-2、1-3、1-4、1-5、1-6 仍分别承担长期主线、全景参考、产品愿景、持续执行与下一阶段缺口跟踪。
03：3-rust-web-long-term-architecture-v1、3-1、3-3、3-13 仍有架构或未完成迁移项。
04：4-28、4-34、4-38、4-44、4-45 仍有 restore focus、local folder no-refresh、open target 前端 cutover、action-layer smoke 和 open editors lifecycle 验证缺口。
05：5-6、5-9、5-26 仍分别跟踪 Page Aggregate 小尾项、Wolai-aline 持续项和 resource open resolver 收敛。
06：6-mindmap-kernel-phase6-projection-editor-v1 与 6-mindmap-phase6-leptos-ui-shell-reuse-checklist-v1 仍保留 mindmap 内核/视觉尾项。
07：7-10、7-12、7-14、7-15、7-27 仍分别承担 Phase 8 冻结缺口、Hermes tool routing、online/local markdown convergence、ACP 统一层和 final markdown truth 后续修复。

9.3 KiB Raw Blame History Unescape Escape