docs: classify stale smoke paths

scripts/TESTING_REFERENCE.md

@@ -7,6 +7,42 @@
 - `scripts/` 里的主力仍然是 `Playwright smoke + Node 断言`。
 - 对 `mnote` 来说，最有价值的不是把所有测试都换成“浏览器插件式控制”，而是把已有 smoke 的结果变得更可看、更易复核。
 - `/doko` 适合作为 smoke 之后的“真实页面直观复核层”，不是用来替代 smoke。
+- 2026-05-20 起，默认主入口固定按 `http://127.0.0.1:3000` 理解；历史记录里的 `3001` 只代表当时临时 mnote-web 实例，不再作为默认验收入口。
+- 历史 smoke 分三类维护：`current` 可直接作为当前主链证据，`compat` 只验证 Convex/control-plane/兼容链，`retired/debug` 不应进入默认回归，除非脚本自身要求显式环境变量。
+
+## 0. 当前 smoke 状态清单
+
+这一节用于避免历史脚本被误当作当前架构主链验收。
+
+### 0.1 当前主链优先脚本
+
+- 入口与认证：`task114-rust-web-gateway-entry-smoke.js`、`task159-auth-entry-smoke.js`、`task097-homepage-entry-smoke.js`
+- Rust SSR 文档页 / Page Aggregate：`task110-page-title-single-truth-smoke.js`、`task-page-aggregate-body-sync-smoke.js`、`task-page-aggregate-options-sync-smoke.js`、`task-page-aggregate-refresh-persistence-smoke.js`
+- local-first 本地工作区：`task164-desktop-hot-local-folder-main-entry-smoke.js`、`task166-local-first-managed-workspace-no-convex-smoke.js`、`task167-local-markdown-title-body-options-no-convex-smoke.js`、`task436-local-markdown-open-document-external-change-smoke.js`、`task443-local-markdown-asset-upload-smoke.js`、`task451-local-markdown-conflict-resolution-ui-smoke.js`、`task452-local-search-index-browser-smoke.js`、`task453-local-folder-page-ai-changed-files-smoke.js`
+- tree realtime / live cache：`task446-tree-rename-dual-browser-live-smoke.js`、`task447-tree-move-order-dual-browser-live-smoke.js`、`task448-tree-resync-recovery-dual-browser-smoke.js`、`task449-tree-sse-reconnect-snapshot-recovery-smoke.js`
+- 资源对象与 mindmap：`task455-local-folder-mindmap-clean-smoke.js`、`task456-resource-object-shell-sync-smoke.js`、`task166-mindmap-phase6-block-smoke.js`、`task167-mindmap-kmind-parity-smoke.js`、`task168-mindmap-put-validator-smoke.js`
+- local resource lifecycle API：`task437-local-folder-asset-trash-lifecycle-smoke.js`，现在只验证 `local-file:*` delete / restore / purge，不再依赖普通 `.txt` 是否出现在 UI 文件树。
+
+### 0.2 兼容/control-plane 脚本
+
+这些脚本仍可用于 Convex/control-plane 或 cloud-source 兼容链，但不能单独证明 local-first 主链正确：
+
+- `task427-trash-empty-isolated-workspace-smoke.js`
+- `task428-filetree-bulk-delete-selection-smoke.js`
+- `task432-filetree-trash-page-dual-browser-no-refresh-smoke.js`
+- `task433-filetree-trash-file-asset-dual-browser-no-refresh-smoke.js`
+- `task434-filetree-trash-mindmap-table-dual-browser-no-refresh-smoke.js`
+- `task444-convex-workspace-export-local-fixture-smoke.js`
+- `task455-convex-export-plan-rollback-smoke.js`
+
+注意：上述 427 / 428 / 432 / 433 / 434 脚本默认入口已改回 `3000`；如需对临时端口验证，显式设置 `MNOTE_UI_BASE_URL`。
+
+### 0.3 需要退役或拆分的历史脚本
+
+- `task179-tree-create-delete-no-reload-smoke.js`：覆盖 `/tree` debug shell。`/tree` 已是显式 debug/internal 边界，脚本默认阻断；只有设置 `MNOTE_ALLOW_DEBUG_TREE_SMOKE=1` 时才可执行。
+- `task163-local-folder-unified-tree-browser-smoke.js`：历史“大一统”脚本，同时混合 local folder、Convex、拖拽、复制粘贴、watcher 和文件树行为。后续不要作为默认回归入口；优先用 164 / 166 / 436 / 441 / 443 / 451 / 452 / 455 这些聚焦脚本替代。
+- `task123-rust-web-tree-live-stream-consumer-smoke.js`：只证明 `/api/tree/events` SSE fallback 仍可用。当前 realtime 主链是 WebSocket push + SSE fallback；验证主链时优先使用 446 / 447 / 448，只有排查 fallback 时再跑 123。
+- 旧 `task019`、`task021`、`task022` 这类早期 UI regression 脚本只作为历史对照；后续默认不要用于当前 Rust SSR / local-first 主路径验收。
 
 ## 1. 当前测试分层
 
@@ -39,9 +75,11 @@
 - `task112-tree-rust-family-regression-smoke.js`
 - `task120-rust-web-tree-integration-smoke.js`
 - `task122-rust-web-create-page-ui-smoke.js`
-- `task163-local-folder-unified-tree-browser-smoke.js`
 - `task164-page-options-visible-effect-smoke.js`
 - `task165-rust-web-dual-pane-smoke.js`
+- `task164-desktop-hot-local-folder-main-entry-smoke.js`
+- `task166-local-first-managed-workspace-no-convex-smoke.js`
+- `task455-local-folder-mindmap-clean-smoke.js`
 
 这一层已经覆盖了当前主线里最重要的部分：
 
@@ -120,6 +158,7 @@ node scripts/task097-homepage-entry-smoke.js
 
 - tree / sidebar 改动：`task112`、`task120`、`task122`
 - document shell / island：`task110`、`task121`
+- local-first：优先使用 `task164-desktop-hot-local-folder-main-entry-smoke.js`、`task166-local-first-managed-workspace-no-convex-smoke.js`、`task167-local-markdown-title-body-options-no-convex-smoke.js`、`task455-local-folder-mindmap-clean-smoke.js`
 - 页面设置：`task160`、`task164-page-options-visible-effect-smoke.js`
 - 双栏：`task165`
 - AI：优先使用 `task-hermes-page-ai-retirement-guard.js`、`task-page-block-ai-tools-smoke.js` 和当前 Hermes 页面 AI smoke；`task155`、`task156`、`task161` 等旧 `/api/ai-agent/run` smoke 只保留在本机 gitignored `recycle/scripts/retired-ai-agent-run-smokes/` 做历史对照