feat: land page aggregate and phase7 document ai mainline

- 收口 page aggregate 读取、本地状态与命令客户端\n- 接入 phase7 document ai sidecar 与前端编排入口\n- 更新 architecture 与 design 状态迁移

wolai-frontend/src/app/api/documents/route-adapters.test.ts

@@ -4,6 +4,28 @@ vi.mock("@/lib/convex/enabled", () => ({
   isConvexEnabled: vi.fn(() => true),
 }));
 
+vi.mock("@/lib/auth/authContext", () => ({
+  HttpError: class HttpError extends Error {
+    status: number;
+
+    constructor(status: number, message: string) {
+      super(message);
+      this.status = status;
+    }
+  },
+  requireAuthContext: vi.fn(async () => ({
+    userId: "user_1",
+  })),
+}));
+
+vi.mock("@/lib/api-utils", () => ({
+  apiErrorResponse: vi.fn((message: string, status = 500, details?: unknown) => ({
+    message,
+    status,
+    details,
+  })),
+}));
+
 vi.mock("@/lib/documents/page-command-adapter", () => ({
   executeDocumentCreateChildBridgeCommand: vi.fn(async () => new Response(JSON.stringify({ ok: true }))),
   executeDocumentEmbedBridgeCommand: vi.fn(async () => new Response(JSON.stringify({ ok: true }))),
@@ -12,11 +34,52 @@ vi.mock("@/lib/documents/page-command-adapter", () => ({
   executeDocumentPurgeBridgeCommand: vi.fn(async () => new Response(JSON.stringify({ ok: true }))),
 }));
 
+vi.mock("@/lib/documents/page-write-command-adapter", () => ({
+  executePageWriteBridgeCommand: vi.fn(async () => ({
+    requestId: "req_1",
+    traceId: "trace_1",
+    commandId: "cmd_1",
+    commandName: "page.command",
+    revision: 1,
+    conflictDetectionKey: "doc_1:1",
+  })),
+}));
+
+vi.mock("@/lib/documents/page-aggregate-loader", () => ({
+  loadPageAggregate: vi.fn(async () => ({
+    page: {
+      identity: { documentId: "doc_1", workspaceId: "ws_1" },
+      head: {
+        title: "页面标题",
+        updatedAt: null,
+        permissions: {
+          readOnly: false,
+          disableDownload: false,
+          disableCopy: false,
+        },
+      },
+      layout: { pageOptions: { wideLayout: false } },
+      body: { content: null, revision: 0, conflictDetectionKey: "doc_1:0" },
+      tree: { pageSubtree: null },
+      stats: null,
+    },
+    bridge: {
+      requestId: "req_1",
+      traceId: "trace_1",
+      queryName: "documents.page.get",
+    },
+  })),
+}));
+
 import { POST as postCreateChild } from "@/app/api/documents/create-child/route";
 import { POST as postEmbed } from "@/app/api/documents/embed/route";
 import { POST as postTemplate } from "@/app/api/documents/template/route";
 import { POST as postEmptyTrash } from "@/app/api/documents/empty-trash/route";
 import { POST as postPurge } from "@/app/api/documents/purge/route";
+import { POST as postTitle } from "@/app/api/documents/title/route";
+import { POST as postOptions } from "@/app/api/documents/options/route";
+import { POST as postSave } from "@/app/api/documents/save/route";
+import { GET as getPage } from "@/app/api/documents/page/route";
 import {
   executeDocumentCreateChildBridgeCommand,
   executeDocumentEmbedBridgeCommand,
@@ -24,6 +87,8 @@ import {
   executeDocumentEmptyTrashBridgeCommand,
   executeDocumentPurgeBridgeCommand,
 } from "@/lib/documents/page-command-adapter";
+import { executePageWriteBridgeCommand } from "@/lib/documents/page-write-command-adapter";
+import { loadPageAggregate } from "@/lib/documents/page-aggregate-loader";
 
 describe("documents route adapters", () => {
   it("creates child route delegates to unified adapter", async () => {
@@ -65,4 +130,46 @@ describe("documents route adapters", () => {
     }));
     expect(executeDocumentPurgeBridgeCommand).toHaveBeenCalled();
   });
+
+  it("page route delegates to unified aggregate loader", async () => {
+    const response = await getPage(
+      new Request("http://localhost/api/documents/page?documentId=doc_1&workspaceId=ws_1"),
+    );
+    const payload = await response.json() as {
+      page: { identity: { documentId: string } };
+      meta: { queryName: string };
+    };
+
+    expect(loadPageAggregate).toHaveBeenCalled();
+    expect(response.status).toBe(200);
+    expect(payload.page.identity.documentId).toBe("doc_1");
+    expect(payload.meta.queryName).toBe("documents.page.get");
+  });
+
+  it("title route delegates to unified page write adapter", async () => {
+    await postTitle(new Request("http://localhost/api/documents/title", {
+      method: "POST",
+      body: JSON.stringify({ documentId: "doc_1", workspaceId: "ws_1", title: "新标题" }),
+    }));
+
+    expect(executePageWriteBridgeCommand).toHaveBeenCalled();
+  });
+
+  it("options route delegates to unified page write adapter", async () => {
+    await postOptions(new Request("http://localhost/api/documents/options", {
+      method: "POST",
+      body: JSON.stringify({ documentId: "doc_1", workspaceId: "ws_1", options: { wideLayout: true } }),
+    }));
+
+    expect(executePageWriteBridgeCommand).toHaveBeenCalled();
+  });
+
+  it("save route delegates to unified page write adapter", async () => {
+    await postSave(new Request("http://localhost/api/documents/save", {
+      method: "POST",
+      body: JSON.stringify({ documentId: "doc_1", workspaceId: "ws_1", content: [] }),
+    }));
+
+    expect(executePageWriteBridgeCommand).toHaveBeenCalled();
+  });
 });