feat(tree): checkpoint resource lifecycle work

提交当前顶层 mnote Git 工作区，范围集中在 04-tree-domain 的 resource/trash/filetree 生命周期、mnote-web resource_trash 路由、Convex/Next 兼容接口、sidebar/file-tree 客户端适配、smoke 脚本与对应设计/bug 记录。不包含被 ignore 的 design/05-editor-mainline/reference-code/leptos-tiptap 嵌套仓库改动。新增 smoke 的测试密码改为运行时读取 MNOTE_E2E_PASSWORD，避免提交明文 credential assignment。
2026-05-16 07:38:45 +08:00
parent 274779c0d8
commit 384da4e44c
85 changed files with 12570 additions and 394 deletions
@@ -0,0 +1,221 @@
+"use strict";
+
+const assert = require("node:assert");
+const fs = require("node:fs");
+const os = require("node:os");
+const path = require("node:path");
+const { chromium } = require("playwright");
+
+const BASE_URL = (process.env.MNOTE_WEB_SMOKE_BASE_URL || "http://127.0.0.1:3000").replace(/\/+$/, "");
+const UI_TIMEOUT_MS = Number(process.env.MNOTE_SMOKE_UI_TIMEOUT_MS || 30_000);
+const OUTPUT_DIR = path.join(process.cwd(), "tmp", "task436-local-markdown-open-document-external-change-smoke");
+const RESULT_PATH = path.join(OUTPUT_DIR, "result.json");
+
+function fileUrl(localPath) {
+  return `file://${localPath}`;
+}
+
+function localMdDocumentId(relativePath) {
+  return `local-md:${relativePath.replaceAll("/", "~2F")}`;
+}
+
+function documentUrl(root, relativePath) {
+  const url = new URL(`${BASE_URL}/documents/${encodeURIComponent(localMdDocumentId(relativePath))}`);
+  url.searchParams.set("sourceKind", "local_folder");
+  url.searchParams.set("rootUri", fileUrl(root));
+  return url.toString();
+}
+
+function markdown(title, lines) {
+  return [
+    "---",
+    `title: ${title}`,
+    "---",
+    "",
+    ...lines,
+    "",
+  ].join("\n");
+}
+
+async function quickLogin(page) {
+  await page.goto(`${BASE_URL}/auth`, { waitUntil: "domcontentloaded", timeout: UI_TIMEOUT_MS });
+  const quickLoginButton = page.getByRole("button", { name: "测试账号快速登录" });
+  if (await quickLoginButton.count()) {
+    await quickLoginButton.click({ timeout: UI_TIMEOUT_MS });
+    await page.waitForURL((url) => url.pathname === "/", { timeout: UI_TIMEOUT_MS });
+  }
+}
+
+async function openDocument(page, root, relativePath) {
+  await page.goto(documentUrl(root, relativePath), { waitUntil: "domcontentloaded", timeout: UI_TIMEOUT_MS });
+  await page.locator('[data-testid="mnote-leptos-tiptap-island-editor-root"]').first().waitFor({
+    state: "visible",
+    timeout: UI_TIMEOUT_MS,
+  });
+  await page.locator(".document-pane[data-pane-role=\"primary\"] .editor-surface .ProseMirror").first().waitFor({
+    state: "visible",
+    timeout: UI_TIMEOUT_MS,
+  });
+}
+
+async function waitForEditorText(page, text) {
+  await page.waitForFunction(
+    (expected) => {
+      const editor = document.querySelector(".document-pane[data-pane-role=\"primary\"] .editor-surface .ProseMirror");
+      return (editor?.textContent || "").includes(expected);
+    },
+    text,
+    { timeout: UI_TIMEOUT_MS },
+  );
+}
+
+async function waitForEditorStatus(page, status) {
+  await page.waitForFunction(
+    (expected) => {
+      const root = document.querySelector('[data-testid="mnote-leptos-tiptap-island-editor-root"]');
+      return root?.getAttribute("data-runtime-editor-status") === expected;
+    },
+    status,
+    { timeout: UI_TIMEOUT_MS },
+  );
+}
+
+async function readEditorRuntime(page) {
+  return await page.evaluate(() => {
+    const root = document.querySelector('[data-testid="mnote-leptos-tiptap-island-editor-root"]');
+    const editor = document.querySelector(".document-pane[data-pane-role=\"primary\"] .editor-surface .ProseMirror");
+    return {
+      status: root?.getAttribute("data-runtime-editor-status") || "",
+      error: root?.getAttribute("data-runtime-editor-error") || "",
+      text: editor?.textContent || "",
+    };
+  });
+}
+
+async function typeDirtyText(page, text) {
+  const editor = page.locator(".document-pane[data-pane-role=\"primary\"] .editor-surface .ProseMirror").first();
+  await editor.click({ timeout: UI_TIMEOUT_MS });
+  await page.keyboard.type(text, { delay: 10 });
+  await waitForEditorText(page, text.trim());
+}
+
+async function runStep(label, navigationEvents, action) {
+  const before = navigationEvents.length;
+  await action();
+  const after = navigationEvents.length;
+  assert.equal(after, before, `${label} 不应触发浏览器导航或 reload`);
+  return {
+    label,
+    navigationEventsBefore: before,
+    navigationEventsAfter: after,
+  };
+}
+
+async function run() {
+  fs.mkdirSync(OUTPUT_DIR, { recursive: true });
+  const root = fs.mkdtempSync(path.join(os.tmpdir(), "mnote-local-open-doc-external-"));
+  const files = {
+    clean: "clean-sync.md",
+    dirty: "dirty-conflict.md",
+    rename: "rename-open.md",
+    delete: "delete-open.md",
+  };
+  fs.writeFileSync(path.join(root, files.clean), markdown("Clean Sync", ["initial clean"]), "utf8");
+  fs.writeFileSync(path.join(root, files.dirty), markdown("Dirty Conflict", ["initial dirty"]), "utf8");
+  fs.writeFileSync(path.join(root, files.rename), markdown("Rename Open", ["initial rename"]), "utf8");
+  fs.writeFileSync(path.join(root, files.delete), markdown("Delete Open", ["initial delete"]), "utf8");
+
+  const browser = await chromium.launch({ headless: true });
+  const context = await browser.newContext({
+    viewport: { width: 1280, height: 860 },
+    extraHTTPHeaders: {
+      "x-mnote-actor-id": "user_real",
+      "x-mnote-actor-type": "user",
+    },
+  });
+  const page = await context.newPage();
+  const navigationEvents = [];
+  page.on("framenavigated", (frame) => {
+    if (frame === page.mainFrame()) {
+      navigationEvents.push({ url: frame.url(), timestamp: Date.now() });
+    }
+  });
+
+  const steps = [];
+  try {
+    await quickLogin(page);
+
+    await openDocument(page, root, files.clean);
+    await waitForEditorText(page, "initial clean");
+    await page.waitForTimeout(300);
+    navigationEvents.length = 0;
+    steps.push(await runStep("打开文档外部修改后自动同步内容", navigationEvents, async () => {
+      const token = `external-clean-${Date.now()}`;
+      fs.writeFileSync(path.join(root, files.clean), markdown("Clean Sync", ["initial clean", token]), "utf8");
+      await waitForEditorText(page, token);
+      await waitForEditorStatus(page, "synced-external-change");
+    }));
+
+    await openDocument(page, root, files.dirty);
+    await waitForEditorText(page, "initial dirty");
+    await page.waitForTimeout(300);
+    navigationEvents.length = 0;
+    steps.push(await runStep("dirty 文档外部修改后进入冲突提示", navigationEvents, async () => {
+      const localToken = `local-dirty-${Date.now()}`;
+      const externalToken = `external-dirty-${Date.now()}`;
+      await typeDirtyText(page, ` ${localToken}`);
+      fs.writeFileSync(path.join(root, files.dirty), markdown("Dirty Conflict", ["initial dirty", externalToken]), "utf8");
+      await waitForEditorStatus(page, "external-change-conflict");
+      const runtime = await readEditorRuntime(page);
+      assert(runtime.error.includes("本地 Markdown 文件已在外部更新"), `冲突提示不正确: ${JSON.stringify(runtime)}`);
+      assert(runtime.text.includes(localToken), "dirty 冲突时不应静默覆盖用户正在编辑的内容");
+    }));
+
+    await openDocument(page, root, files.rename);
+    await waitForEditorText(page, "initial rename");
+    await page.waitForTimeout(300);
+    navigationEvents.length = 0;
+    steps.push(await runStep("打开文档外部重命名后给出冲突提示", navigationEvents, async () => {
+      fs.renameSync(path.join(root, files.rename), path.join(root, "rename-open-renamed.md"));
+      await waitForEditorStatus(page, "external-change-conflict");
+      const runtime = await readEditorRuntime(page);
+      assert(runtime.error.includes("本地 Markdown 文件已在外部更新"), `重命名提示不正确: ${JSON.stringify(runtime)}`);
+    }));
+
+    await openDocument(page, root, files.delete);
+    await waitForEditorText(page, "initial delete");
+    await page.waitForTimeout(300);
+    navigationEvents.length = 0;
+    steps.push(await runStep("打开文档外部删除后给出冲突提示", navigationEvents, async () => {
+      fs.rmSync(path.join(root, files.delete));
+      await waitForEditorStatus(page, "external-change-conflict");
+      const runtime = await readEditorRuntime(page);
+      assert(runtime.error.includes("本地 Markdown 文件已在外部更新"), `删除提示不正确: ${JSON.stringify(runtime)}`);
+    }));
+
+    const result = {
+      ok: true,
+      baseUrl: BASE_URL,
+      root,
+      steps,
+      navigationEvents,
+    };
+    fs.writeFileSync(RESULT_PATH, `${JSON.stringify(result, null, 2)}\n`, "utf8");
+    console.log(`task436 local markdown open document external change smoke passed: ${RESULT_PATH}`);
+  } finally {
+    await browser.close().catch(() => {});
+    fs.rmSync(root, { recursive: true, force: true });
+  }
+}
+
+run().catch((error) => {
+  const result = {
+    ok: false,
+    baseUrl: BASE_URL,
+    error: error && error.stack ? error.stack : String(error),
+  };
+  fs.mkdirSync(OUTPUT_DIR, { recursive: true });
+  fs.writeFileSync(RESULT_PATH, `${JSON.stringify(result, null, 2)}\n`, "utf8");
+  console.error(error && error.stack ? error.stack : error);
+  process.exit(1);
+});