@open-press/cli 0.3.0 → 0.5.0

package/template/core/engine/commands/upgrade.mjs

@@ -0,0 +1,117 @@
+import { existsSync } from "node:fs";
+import { readFile } from "node:fs/promises";
+import path from "node:path";
+import { diagnose } from "./doctor.mjs";
+import { runCommand } from "./_shared.mjs";
+
+export async function run({ root, options }) {
+  const dryRun = Boolean(options?.dryRun);
+  const skipSkills = Boolean(options?.noSkills);
+  const skipDeps = Boolean(options?.noDeps);
+  const json = Boolean(options?.json);
+
+  // 1. Fresh diagnose (force re-check, ignore cache).
+  const before = await diagnose(root, { noCache: true });
+
+  if (!before.stale) {
+    const message = "open-press is already up to date.";
+    if (json) {
+      process.stdout.write(JSON.stringify({ status: "noop", before }, null, 2) + "\n");
+    } else {
+      process.stdout.write(`✓ ${message}\n`);
+    }
+    return 0;
+  }
+
+  if (!json) {
+    process.stdout.write("○ open-press upgrade\n\n");
+    if (before.coreUpdateAvailable) {
+      process.stdout.write(
+        `  @open-press/core: ${before.coreVersion} → ${before.coreLatest}\n`,
+      );
+    }
+    if (before.pendingMigrations.length > 0) {
+      process.stdout.write(`  migration notes: ${before.pendingMigrations.join(", ")}\n`);
+    }
+    process.stdout.write("\n");
+  }
+
+  if (dryRun) {
+    if (!json) {
+      process.stdout.write("dry run — nothing changed. The agent should:\n");
+      process.stdout.write("  1. read each docs/migrations/<version>.md for document-level changes\n");
+      process.stdout.write("  2. apply edits to document/ where needed\n");
+      process.stdout.write("  3. re-run: npx open-press upgrade   (without --dry-run)\n");
+    } else {
+      process.stdout.write(JSON.stringify({ status: "dry-run", before }, null, 2) + "\n");
+    }
+    return 0;
+  }
+
+  // 2. Refresh framework dep (only when workspace declares @open-press/core).
+  if (!skipDeps && (await hasCoreDep(root))) {
+    if (!json) process.stdout.write("▸ updating @open-press/core via npm…\n");
+    const code = runCommand("npm", ["update", "@open-press/core"], root);
+    if (code !== 0) {
+      if (!json) process.stdout.write("  ⚠ npm update returned non-zero; continuing\n");
+    }
+  }
+
+  // 3. Refresh skills (npx skills upgrade respects skills-lock.json).
+  if (!skipSkills) {
+    if (!json) process.stdout.write("▸ refreshing skills via npx skills upgrade…\n");
+    runCommand("npx", ["-y", "skills@latest", "upgrade"], root);
+  }
+
+  // 4. Surface migration notes for the agent to read.
+  const migrationContents = await loadMigrations(root, before.pendingMigrations);
+
+  // 5. Re-diagnose to confirm the move.
+  const after = await diagnose(root, { noCache: true });
+
+  if (json) {
+    process.stdout.write(
+      JSON.stringify(
+        { status: "applied", before, after, migrationContents: migrationContents.map((m) => m.path) },
+        null,
+        2,
+      ) + "\n",
+    );
+    return 0;
+  }
+
+  process.stdout.write("\n✓ upgrade applied. Now read these migration notes:\n\n");
+  if (migrationContents.length === 0) {
+    process.stdout.write("  (no migration docs in this version range)\n\n");
+  } else {
+    for (const m of migrationContents) {
+      process.stdout.write(`  ─ ${m.path}\n`);
+    }
+    process.stdout.write(
+      "\nAgent: open each file, identify document-level changes, grep document/ for affected patterns, propose edits before applying.\n",
+    );
+  }
+
+  process.stdout.write("\nVerify with:\n  npm run openpress:validate\n  npm run openpress:render\n\n");
+  return 0;
+}
+
+async function hasCoreDep(root) {
+  try {
+    const pkg = JSON.parse(await readFile(path.join(root, "package.json"), "utf8"));
+    return Boolean(pkg.dependencies?.["@open-press/core"] || pkg.devDependencies?.["@open-press/core"]);
+  } catch {
+    return false;
+  }
+}
+
+async function loadMigrations(root, versions) {
+  const results = [];
+  for (const v of versions) {
+    const p = path.join(root, "docs", "migrations", `${v}.md`);
+    if (existsSync(p)) {
+      results.push({ version: v, path: path.relative(root, p) });
+    }
+  }
+  return results;
+}

package/template/core/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@open-press/core",
-  "version": "0.3.0",
+  "version": "0.5.0",
   "type": "module",
   "description": "open-press core — runtime primitives, CLI, and render pipeline for AI-first fixed-layout documents.",
   "license": "MIT",
@@ -65,6 +65,8 @@
     "js-yaml": "^4.1.1",
     "katex": "^0.16.47",
     "lucide-react": "^1.16.0",
+    "playwright": "^1.60.0",
+    "postcss": "^8.5.6",
     "react": "^19.2.6",
     "react-dom": "^19.2.6",
     "rehype-katex": "^7.0.1",

package/template/core/vite.config.ts

@@ -9,13 +9,18 @@ import { loadConfig, publicPdfHref } from "./engine/config.mjs";
 import { handleCommentRequest } from "./engine/react/comment-endpoint.mjs";
 import { handleProjectAssetRequest } from "./engine/react/project-asset-endpoint.mjs";
 
-const sourceRoot = fileURLToPath(new URL("./src", import.meta.url));
-const workspaceRoot = fileURLToPath(new URL("./", import.meta.url));
-const openpressCoreEntry = fileURLToPath(new URL("./src/openpress/core/index.tsx", import.meta.url));
-const reactDocumentComponentsRoot = path.join(workspaceRoot, "document", "components");
+const frameworkRoot = fileURLToPath(new URL("./", import.meta.url));
+const workspaceRoot = process.env.OPENPRESS_WORKSPACE_ROOT
+  ? path.resolve(process.env.OPENPRESS_WORKSPACE_ROOT)
+  : frameworkRoot;
+const sourceRoot = path.join(frameworkRoot, "src");
+const openpressCliPath = path.join(frameworkRoot, "engine", "cli.mjs");
+const staticServerPath = path.join(frameworkRoot, "engine", "static-server.mjs");
+const openpressCoreEntry = path.join(frameworkRoot, "src", "openpress", "core", "index.tsx");
 const openpressConfig = await loadConfig(workspaceRoot);
 const outputDir = openpressConfig.paths.outputDir;
-const reactDocumentRoot = path.join(workspaceRoot, "document");
+const reactDocumentRoot = openpressConfig.paths.documentRoot;
+const reactDocumentComponentsRoot = openpressConfig.paths.componentsDir;
 const reactDocumentEntry = path.join(reactDocumentRoot, "index.tsx");
 const activeContentDir = await fileExists(reactDocumentEntry)
   ? path.join(reactDocumentRoot, "chapters")
@@ -48,6 +53,7 @@ export default defineConfig({
   plugins: [openpressLocalDeployPlugin(), react()],
   define: workspaceDefines,
   resolve: {
+    dedupe: ["react", "react-dom", "@mdx-js/react"],
     alias: {
       "@openpress/core": openpressCoreEntry,
       "@/components": reactDocumentComponentsRoot,
@@ -69,6 +75,9 @@ export default defineConfig({
   server: {
     host: "127.0.0.1",
     port: 5173,
+    fs: {
+      allow: Array.from(new Set([frameworkRoot, workspaceRoot])),
+    },
     watch: {
       ignored: ["**/.openpress/tmp/**", `**/${openpressConfig.outputDir}/**`],
     },
@@ -201,7 +210,7 @@ async function handleLocalPdfExportRequest(req: IncomingMessage, res: ServerResp
     ok: result.code === 0 && exists,
     code: result.code,
     pdf: `/__openpress/local-pdf-file?ts=${Date.now()}`,
-    command: "node engine/cli.mjs pdf .",
+    command: openpressCliCommand(["pdf", "."]),
     stdout: result.stdout,
     stderr: result.stderr,
   });
@@ -266,7 +275,7 @@ async function handleLocalDeployRequest(req: IncomingMessage, res: ServerRespons
       deploy_adapter: openpressConfig.deploy.adapter,
       deploy_source: openpressConfig.deploy.source,
       deploy_project_name: openpressConfig.deploy.projectName,
-      command: "node engine/cli.mjs deploy . --confirm",
+      command: openpressCliCommand(["deploy", ".", "--confirm"]),
     });
     return;
   }
@@ -285,7 +294,7 @@ async function handleLocalDeployRequest(req: IncomingMessage, res: ServerRespons
     pdf: deployedUrl ? `${deployedUrl}/${openpressConfig.pdf.filename}` : deploymentInfo.pdf,
     public_url: publicUrl,
     dirty: false,
-    command: "node engine/cli.mjs deploy . --confirm",
+    command: openpressCliCommand(["deploy", ".", "--confirm"]),
     stdout: result.stdout,
     stderr: result.stderr,
   });
@@ -293,7 +302,7 @@ async function handleLocalDeployRequest(req: IncomingMessage, res: ServerRespons
 
 function runLocalPdfExport() {
   return new Promise<{ code: number; stdout: string; stderr: string }>((resolve) => {
-    const child = spawn("node", ["engine/cli.mjs", "pdf", "."], {
+    const child = spawn("node", [openpressCliPath, "pdf", "."], {
       cwd: workspaceRoot,
       shell: false,
     });
@@ -316,7 +325,7 @@ function runLocalPdfExport() {
 
 function runLocalDeploy() {
   return new Promise<{ code: number; stdout: string; stderr: string }>((resolve) => {
-    const child = spawn("node", ["engine/cli.mjs", "deploy", ".", "--confirm"], {
+    const child = spawn("node", [openpressCliPath, "deploy", ".", "--confirm"], {
       cwd: workspaceRoot,
       shell: false,
     });
@@ -405,7 +414,7 @@ function getLocalDeploymentSourcePaths() {
     openpressConfig.paths.themeDir,
     openpressConfig.paths.designDoc,
     openpressConfig.paths.componentsDir,
-    path.join(workspaceRoot, "src"),
+    path.join(frameworkRoot, "src"),
     path.join(workspaceRoot, "index.html"),
     path.join(workspaceRoot, "package.json"),
     path.join(workspaceRoot, "openpress.config.mjs"),
@@ -414,6 +423,12 @@ function getLocalDeploymentSourcePaths() {
   ];
 }
 
+function openpressCliCommand(args: string[]) {
+  const relativeCliPath = path.relative(workspaceRoot, openpressCliPath).replaceAll("\\", "/");
+  const displayCliPath = relativeCliPath && !relativeCliPath.startsWith("../") ? relativeCliPath : openpressCliPath;
+  return `node ${displayCliPath} ${args.join(" ")}`;
+}
+
 async function findNewestLocalSourceMtime(paths: string[]) {
   const times = await Promise.all(paths.map((sourcePath) => findNewestLocalMtime(sourcePath)));
   return Math.max(0, ...times);

package/template/{skills/editorial-monograph/starter → packs/editorial-monograph}/document/chapters/03-agent-skills-contributors/content/01-agent-skills-contributors.mdx

@@ -10,7 +10,7 @@
 | 從既有資料建立文件 | 請參考這一份文件（自行上傳），使用 `openpress-writing skill` 協助整理成 8 頁產品提案。保留既有事實，不要新增未確認的數字。 |
 | 以風格起手建立新文件 | 請以 `editorial-monograph skill` 作為風格，使用 `openpress-writing skill` 建立一份研究報告。讀者是管理層，缺少的事實請標成 placeholder。 |
 | 開啟本機審稿 | 請使用 `openpress skill` 打開本機 workbench，讓我檢查 Document、Design System 與 Project 狀態。 |
-| 規劃長篇文件層級 | 請使用 `openpress-document-hierarchy skill` 規劃 H2/H3/H4、目錄深度與附錄位置。 |
+| 規劃長篇文件層級 | 請使用 `openpress-writing skill` 規劃 H2/H3/H4、目錄深度與附錄位置（已併入 writing skill 的 Hierarchy section）。 |
 | 重寫章節 | 請使用 `openpress-writing skill` 重整章節，讓第一章先講問題、第二章講方案，語氣維持正式研究報告。 |
 | 調整版面 | 請使用 `openpress-design skill` 調整 theme 與 components，讓文件維持 A4 長文閱讀節奏。 |
 | 中文潤飾 | 請使用 `chinese-ai-writing-polish skill` 潤飾中文，保留原意，不要改成廣告文案。 |
@@ -26,8 +26,7 @@ open-press 使用 skill 讓 Agent 在不同層次工作。`openpress` 是 Core /
 | --- | --- | --- |
 | `openpress` | CLI、workspace inspect/search/replace、本機 workbench、驗證與輸出邊界 | Agent 不確定該用哪個 open-press 工具、要開本機審稿、或要選 specialist skill |
 | `openpress-deploy` | 部署設定、preflight、dry run、公開發布確認 | 準備上線或接前端部署按鈕 |
-| `openpress-document-hierarchy` | H1/H2/H3/H4、TOC 深度、reader outline、附錄位置 | 長篇文件或多章節文件需要重整骨架 |
-| `openpress-writing` | 章節順序、敘事結構、表格與 caption 文案 | 建立、重寫或重整內容 |
+| `openpress-writing` | 章節順序、敘事結構、表格與 caption 文案、**H1/H2/H3/H4 結構、TOC 深度、附錄位置** | 建立、重寫或重整內容；長文骨架調整 |
 | `openpress-design` | theme、版面、page rhythm、components | 調整視覺系統與輸出穩定性 |
 | `openpress-style-pack-contributor` | style pack 設計、starter 契約、貢獻驗證 | 新增或改良 `skills/<pack>/starter/` |
 | `editorial-monograph` | A4 嚴肅長文風格 | 報告、提案、白皮書、產品說明 |

package/template/core/.turbo/turbo-test.log

@@ -1,341 +0,0 @@
-
-> @open-press/core@0.2.0 test /Users/quan/Desktop/QDoc Playgorund/data structure note/packages/core
-> pnpm run test:node && pnpm run test:react
-
-
-> @open-press/core@0.2.0 test:node /Users/quan/Desktop/QDoc Playgorund/data structure note/packages/core
-> node --test tests/*.test.mjs
-
-TAP version 13
-# Subtest: cli pdf and deploy dry runs use workspace config
-ok 1 - cli pdf and deploy dry runs use workspace config
-  ---
-  duration_ms: 1898.54
-  ...
-# Subtest: static server serves workspace pdf and exposes deployment status
-ok 2 - static server serves workspace pdf and exposes deployment status
-  ---
-  duration_ms: 459.933375
-  ...
-# Subtest: deploy gate validates public adapters require confirmation
-ok 3 - deploy gate validates public adapters require confirmation
-  ---
-  duration_ms: 860.309125
-  ...
-# Subtest: validate supports machine-readable issue report JSON
-ok 4 - validate supports machine-readable issue report JSON
-  ---
-  duration_ms: 872.810334
-  ...
-# Subtest: validate warns when React source still contains pending openpress comments
-ok 5 - validate warns when React source still contains pending openpress comments
-  ---
-  duration_ms: 867.950458
-  ...
-# Subtest: validate reports React pagination overflow warnings from exported document metadata
-ok 6 - validate reports React pagination overflow warnings from exported document metadata
-  ---
-  duration_ms: 867.326666
-  ...
-# Subtest: inspect dry run describes render and browser inspection steps
-ok 7 - inspect dry run describes render and browser inspection steps
-  ---
-  duration_ms: 733.269791
-  ...
-# Subtest: export copies theme font stylesheet and font files for nested workspaces
-ok 8 - export copies theme font stylesheet and font files for nested workspaces
-  ---
-  duration_ms: 1151.318875
-  ...
-# Subtest: export supports chapter-opener pages as no-footer page surfaces
-ok 9 - export supports chapter-opener pages as no-footer page surfaces
-  ---
-  duration_ms: 1118.779584
-  ...
-# Subtest: export includes katex stylesheet and font assets for latex math
-ok 10 - export includes katex stylesheet and font assets for latex math
-  ---
-  duration_ms: 1114.688208
-  ...
-# Subtest: inspection source scan reads React MDX chapters when document/index.tsx is present
-ok 11 - inspection source scan reads React MDX chapters when document/index.tsx is present
-  ---
-  duration_ms: 94.999084
-  ...
-# Subtest: overflow measurements become page warnings with source metadata
-ok 12 - overflow measurements become page warnings with source metadata
-  ---
-  duration_ms: 0.838333
-  ...
-# Subtest: project asset endpoint renames media and updates document references
-ok 13 - project asset endpoint renames media and updates document references
-  ---
-  duration_ms: 176.032333
-  ...
-# Subtest: project asset endpoint refuses to delete referenced media
-ok 14 - project asset endpoint refuses to delete referenced media
-  ---
-  duration_ms: 81.165209
-  ...
-# Subtest: project asset endpoint renames component support directory and literal references
-ok 15 - project asset endpoint renames component support directory and literal references
-  ---
-  duration_ms: 62.403042
-  ...
-# Subtest: project asset endpoint creates a source comment from the asset dialog
-ok 16 - project asset endpoint creates a source comment from the asset dialog
-  ---
-  duration_ms: 48.93275
-  ...
-# Subtest: insertCommentMarker writes a JSX marker before the selected MDX block line
-ok 17 - insertCommentMarker writes a JSX marker before the selected MDX block line
-  ---
-  duration_ms: 37.651084
-  ...
-# Subtest: insertCommentMarker rejects paths outside editable React document sources
-ok 18 - insertCommentMarker rejects paths outside editable React document sources
-  ---
-  duration_ms: 5.009083
-  ...
-# Subtest: listCommentMarkers returns decoded pending comments from editable React sources
-ok 19 - listCommentMarkers returns decoded pending comments from editable React sources
-  ---
-  duration_ms: 222.229375
-  ...
-# Subtest: clearCommentMarkers removes one or all pending comments
-ok 20 - clearCommentMarkers removes one or all pending comments
-  ---
-  duration_ms: 135.881
-  ...
-# Subtest: updateCommentMarker updates an existing source marker without duplicating it
-ok 21 - updateCommentMarker updates an existing source marker without duplicating it
-  ---
-  duration_ms: 44.983834
-  ...
-# Subtest: handleCommentRequest accepts React inspector targets and writes source markers
-ok 22 - handleCommentRequest accepts React inspector targets and writes source markers
-  ---
-  duration_ms: 4.229959
-  ...
-# Subtest: handleCommentRequest updates pending comments through PATCH
-ok 23 - handleCommentRequest updates pending comments through PATCH
-  ---
-  duration_ms: 50.044709
-  ...
-# Subtest: handleCommentRequest lists and clears pending comments
-ok 24 - handleCommentRequest lists and clears pending comments
-  ---
-  duration_ms: 55.842959
-  ...
-# Subtest: handleCommentRequest rejects unsupported methods
-ok 25 - handleCommentRequest rejects unsupported methods
-  ---
-  duration_ms: 0.326792
-  ...
-# Subtest: scopeChapterCss prefixes ordinary selectors and nested media rules
-ok 26 - scopeChapterCss prefixes ordinary selectors and nested media rules
-  ---
-  duration_ms: 5.827334
-  ...
-# Subtest: buildChapterScopedCss reads chapter styles in discovery order
-ok 27 - buildChapterScopedCss reads chapter styles in discovery order
-  ---
-  duration_ms: 30.566
-  ...
-# Subtest: discovers React document chapters and component scopes from filesystem structure
-ok 28 - discovers React document chapters and component scopes from filesystem structure
-  ---
-  duration_ms: 63.16425
-  ...
-# Subtest: discovers React workspace using normalized config path overrides
-ok 29 - discovers React workspace using normalized config path overrides
-  ---
-  duration_ms: 7.797125
-  ...
-# Subtest: loadReactDocumentEntry loads document/index.tsx and normalizes config defaults
-ok 30 - loadReactDocumentEntry loads document/index.tsx and normalizes config defaults
-  ---
-  duration_ms: 190.757833
-  ...
-# Subtest: loadReactDocumentEntry maps manifest path overrides into normalized config
-ok 31 - loadReactDocumentEntry maps manifest path overrides into normalized config
-  ---
-  duration_ms: 43.071958
-  ...
-# Subtest: loadReactDocumentEntry rejects obvious top-level side effects before import
-ok 32 - loadReactDocumentEntry rejects obvious top-level side effects before import
-  ---
-  duration_ms: 18.955959
-  ...
-# Subtest: loadReactDocumentEntry rejects side-effect imports and top-level browser or file IO
-ok 33 - loadReactDocumentEntry rejects side-effect imports and top-level browser or file IO
-  ---
-  duration_ms: 20.809917
-  ...
-# Subtest: Vite and TypeScript expose React document import aliases
-ok 34 - Vite and TypeScript expose React document import aliases
-  ---
-  duration_ms: 9.857875
-  ...
-# Subtest: exportReactDocument writes a reader document from React shell pages and MDX chapters
-ok 35 - exportReactDocument writes a reader document from React shell pages and MDX chapters
-  ---
-  duration_ms: 208.410208
-  ...
-# Subtest: exportReactDocument paginates MDX by measured block groups and rerenders page subtrees
-ok 36 - exportReactDocument paginates MDX by measured block groups and rerenders page subtrees
-  ---
-  duration_ms: 58.566208
-  ...
-# Subtest: exportReactDocument injects static table-of-contents entries from rendered headings
-ok 37 - exportReactDocument injects static table-of-contents entries from rendered headings
-  ---
-  duration_ms: 65.722958
-  ...
-# Subtest: exportDocument delegates to React export when document/index.tsx is present
-ok 38 - exportDocument delegates to React export when document/index.tsx is present
-  ---
-  duration_ms: 77.547709
-  ...
-# Subtest: compileMdx renders MDX with stable block ids and component wrappers
-ok 39 - compileMdx renders MDX with stable block ids and component wrappers
-  ---
-  duration_ms: 18.214959
-  ...
-# Subtest: compileMdx rejects import declarations in chapter prose
-ok 40 - compileMdx rejects import declarations in chapter prose
-  ---
-  duration_ms: 0.331958
-  ...
-# Subtest: compileMdx can render only selected block ids for pagination subtrees
-ok 41 - compileMdx can render only selected block ids for pagination subtrees
-  ---
-  duration_ms: 7.782041
-  ...
-# Subtest: compileMdx rejects inline JSX components inside prose
-ok 42 - compileMdx rejects inline JSX components inside prose
-  ---
-  duration_ms: 0.939334
-  ...
-# Subtest: compileMdx renders GitHub-flavored markdown tables as table elements
-ok 43 - compileMdx renders GitHub-flavored markdown tables as table elements
-  ---
-  duration_ms: 5.05425
-  ...
-# Subtest: compileMdx converts TableCaption components into table captions
-ok 44 - compileMdx converts TableCaption components into table captions
-  ---
-  duration_ms: 7.21325
-  ...
-# Subtest: compileMdx renders inline LaTeX math without treating braces as MDX expressions
-ok 45 - compileMdx renders inline LaTeX math without treating braces as MDX expressions
-  ---
-  duration_ms: 13.443666
-  ...
-# Subtest: compileMdx renders display LaTeX math as a paginable block
-ok 46 - compileMdx renders display LaTeX math as a paginable block
-  ---
-  duration_ms: 38.801375
-  ...
-# Subtest: compileMdx treats a whole-line double-dollar formula as display math
-ok 47 - compileMdx treats a whole-line double-dollar formula as display math
-  ---
-  duration_ms: 12.7585
-  ...
-# Subtest: paginateMeasuredBlocks groups measured block ids without splitting atomic blocks
-ok 48 - paginateMeasuredBlocks groups measured block ids without splitting atomic blocks
-  ---
-  duration_ms: 0.982167
-  ...
-# Subtest: paginateMeasuredBlocks keeps an overlong block atomic and emits an overflow warning
-ok 49 - paginateMeasuredBlocks keeps an overlong block atomic and emits an overflow warning
-  ---
-  duration_ms: 0.219083
-  ...
-# Subtest: measureBlocksInChromium derives safe height from rendered page body when no fixed height is configured
-ok 50 - measureBlocksInChromium derives safe height from rendered page body when no fixed height is configured
-  ---
-  duration_ms: 229.745917
-  ...
-# Subtest: buildReactMeasurementCss includes real theme, component and chapter scoped CSS
-ok 51 - buildReactMeasurementCss includes real theme, component and chapter scoped CSS
-  ---
-  duration_ms: 35.629459
-  ...
-# Subtest: reader page registry reports same-index DOM replacements
-ok 52 - reader page registry reports same-index DOM replacements
-  ---
-  duration_ms: 55.891958
-  ...
-# Subtest: page route serializes and validates reader page hashes
-ok 53 - page route serializes and validates reader page hashes
-  ---
-  duration_ms: 20.061375
-  ...
-# Subtest: reader runtime leaves touch gestures to scrolling instead of page turns
-ok 54 - reader runtime leaves touch gestures to scrolling instead of page turns
-  ---
-  duration_ms: 3.51525
-  ...
-# Subtest: search emits source match JSON with file, line, column and preview
-ok 55 - search emits source match JSON with file, line, column and preview
-  ---
-  duration_ms: 1006.144209
-  ...
-# Subtest: replace preview reports changes without writing files
-ok 56 - replace preview reports changes without writing files
-  ---
-  duration_ms: 822.123458
-  ...
-# Subtest: replace apply writes prose matches and skips fenced code by default
-ok 57 - replace apply writes prose matches and skips fenced code by default
-  ---
-  duration_ms: 818.346291
-  ...
-# Subtest: search reads React MDX chapter content when document/index.tsx is present
-ok 58 - search reads React MDX chapter content when document/index.tsx is present
-  ---
-  duration_ms: 825.881375
-  ...
-# Subtest: replace applies to React MDX chapter content when document/index.tsx is present
-ok 59 - replace applies to React MDX chapter content when document/index.tsx is present
-  ---
-  duration_ms: 829.073666
-  ...
-# Subtest: search all includes React document entry and chapter implementation sources
-ok 60 - search all includes React document entry and chapter implementation sources
-  ---
-  duration_ms: 826.43775
-  ...
-1..60
-# tests 60
-# suites 0
-# pass 60
-# fail 0
-# cancelled 0
-# skipped 0
-# todo 0
-# duration_ms 10037.053417
-
-> @open-press/core@0.2.0 test:react /Users/quan/Desktop/QDoc Playgorund/data structure note/packages/core
-> vitest run
-
-
- RUN  v4.1.7 /Users/quan/Desktop/QDoc Playgorund/data structure note/packages/core
-
- ✓ tests/openpress-composer-mentions.test.ts (4 tests) 6ms
- ✓ tests/openpress-react-document-metadata.test.ts (3 tests) 6ms
- ✓ tests/openpress-frame-scheduler.test.ts (3 tests) 10ms
- ✓ tests/openpress-project-mentions.test.ts (1 test) 261ms
- ✓ tests/openpress-pagination.test.ts (11 tests) 179ms
- ✓ tests/openpress-core-primitives.react.test.tsx (4 tests) 52ms
- ✓ tests/openpress-bookmarks.react.test.tsx (4 tests) 145ms
- ✓ tests/openpress-renderer.react.test.tsx (2 tests) 258ms
- ✓ tests/openpress-inspector.react.test.tsx (13 tests) 105ms
- ✓ tests/reader-runtime.react.test.tsx (7 tests) 367ms
-
- Test Files  10 passed (10)
-      Tests  52 passed (52)
-   Start at  14:37:54
-   Duration  1.56s (transform 947ms, setup 0ms, import 1.82s, tests 1.39s, environment 7.26s)
-