edgepress 2026.9.3 → 2026.9.5

package/README.md

@@ -2,7 +2,7 @@
 
 [![Deploy to Cloudflare](https://deploy.workers.cloudflare.com/button)](https://deploy.workers.cloudflare.com/?url=https://github.com/jsw-teams/edgepress)
 
-The button deploys this repository's demo site to your Cloudflare account. To create a new site, follow the npm quick start below.
+The button creates a copy of this repository in your GitHub account and a new Worker in your Cloudflare account. It is for creating a separate site, not updating an existing one. Choose unused destination repository and Worker names during setup. If `edgepress` already exists, choose a different name such as `my-edgepress-site`; to update an existing deployment, use that repository's connected Workers Builds integration instead of clicking the button again.
 
 EdgePress builds static websites for Cloudflare Workers. Write posts in Markdown, compose pages from editable rows and elements, choose a shared theme, and build the site into dist/.
 
@@ -48,23 +48,23 @@ Posts under content/posts/ use the Markdown renderer. Themes own shared head, na
 - edgepress init: scaffold a new site in a project directory.
 - edgepress new "Article title": create a Markdown post.
 - edgepress build and edgepress generate: run the same generator and write static files to dist/ for Cloudflare Workers or static hosting.
-- edgepress server: start live local preview, rebuild on source changes, and refresh the audit report.
-- edgepress check: build, generate accessibility, agent-friendliness, and Markdown rendering findings, capture post/page desktop and mobile screenshots, and write the PDF report under tools/.
+- edgepress server: start live local preview, rebuild on source changes, and refresh the PDF audit report.
+- edgepress check: build, audit accessibility, agent-friendliness, and Markdown rendering, capture post/page desktop and mobile screenshots temporarily, and write only the PDF report under tools/.
 - edgepress doctor: inspect runtime and Worker compatibility.
 - edgepress theme list and edgepress theme use <name>: inspect or select an installed theme.
 - edgepress theme install <npm-package>[@version]: install a theme package from npm without running its install scripts.
 - edgepress theme create <name>: make an empty, accessible HTML theme skeleton with editable partials and a blank stylesheet.
 - edgepress secret put BACKEND_TOKEN: store the backend token in Wrangler.
 - edgepress deploy: build and deploy to Cloudflare Workers.
-- Connect a GitHub repository to Cloudflare Workers Builds to deploy on pushes to main. The build and deploy scripts are detected from package.json.
+- Connect a GitHub repository to Cloudflare Workers Builds to deploy on pushes to main. Set root directory `/`, build command `npm run build`, deploy command `npx wrangler deploy`, and leave build variables empty. See the [Cloudflare build troubleshooting guide](content/pages/quick-start/) if initialization stalls before commands run.
 - edgepress clean: remove generated site and report files.
 - edgepress iterate: create a report-only maintenance plan.
 - edgepress security: check dependency advisories.
 
-The generated report is written to tools/page-check.md and tools/page-check.json. The accessible HTML source is tools/page-check-visual.html; the tagged PDF report is tools/page-check.pdf, with desktop and mobile post/page screenshots in tools/page-check-screenshots/. The mobile entries include their measured viewport and document widths. These automated checks do not replace manual accessibility or legal review.
+The only persisted page-audit report is the accessible PDF at tools/page-check.pdf. Desktop and mobile screenshots are embedded in the PDF and removed from temporary storage afterward. Automated checks do not replace manual accessibility or legal review.
 
 The header search page filters Markdown posts from the generated local search index; it does not send search queries to an external service. The first post, “EdgePress and Markdown: a complete writing guide,” documents and verifies the supported Markdown syntax in English and Chinese.
 
 Project guides are published from content/pages/: project introduction, quick start, theme development, plugin development, and privacy policy. The privacy policy intentionally reports that the starter site still needs a real site URL, operator name, and privacy contact before publication.
 
-Version 2026.9.3 records the third requested release update for September 2026. It is available as the `edgepress` npm package. See the [request 1 notes](content/posts/2026-09-24-edgepress-release-2026-9-1/), [request 2 notes](content/posts/2026-09-25-edgepress-release-2026-9-2/), and [request 3 notes](content/posts/2026-09-25-edgepress-release-2026-9-3/).
+Version 2026.9.5 records the fifth requested release update for September 2026. It is available as the `edgepress` npm package. See the [request 1 notes](content/posts/2026-09-24-edgepress-release-2026-9-1/), [request 2 notes](content/posts/2026-09-25-edgepress-release-2026-9-2/), [request 3 notes](content/posts/2026-09-25-edgepress-release-2026-9-3/), [request 4 notes](content/posts/2026-09-25-edgepress-release-2026-9-4/), and [request 5 notes](content/posts/2026-09-25-edgepress-release-2026-9-5/).

package/content/pages/quick-start/en.md

@@ -10,7 +10,7 @@ blocks:
         - type: hero
           eyebrow: Start here
           title: Set up the project and open the live preview.
-          text: Use the edgepress command after installing project dependencies. Local preview rebuilds changed source files and refreshes the accessibility and agent-friendliness report.
+          text: Use the edgepress command after installing project dependencies. Local preview rebuilds changed source files and refreshes the PDF accessibility and agent-friendliness report.
   - columns: 1
     cells:
       -
@@ -76,7 +76,7 @@ blocks:
                 - Edit site title, description, canonical URL, agent SEO, site navigation, footer text, and privacy controller details in config.yml. Theme colors live in theme CSS.
                 - Change the selected theme with edgepress theme list and edgepress theme use <theme-name>. Theme paths are stored in edgepress.config.mjs.
                 - Install a theme package with edgepress theme install <npm-package> or start with a blank theme using edgepress theme create <name>.
-                - edgepress server starts a local Wrangler server, watches source files, rebuilds changed pages, reloads the browser, and rewrites tools/page-check.md and tools/page-check.json.
+                - edgepress server starts a local Wrangler server, watches source files, rebuilds changed pages, reloads the browser, and refreshes tools/page-check.pdf. Screenshots are embedded in the PDF and temporary files are removed after generation.
             - type: code
               title: Build, inspect, and deploy
               language: sh
@@ -85,14 +85,16 @@ blocks:
                 edgepress doctor
                 edgepress deploy
             - type: text
-              text: Compatibility checks read the Node.js baseline, Worker entry, and compatibility date from project-compatibility.json and wrangler.jsonc. Check the generated report before deploying.
+              text: Compatibility checks read the Node.js baseline, Worker entry, and compatibility date from project-compatibility.json and wrangler.jsonc. Review the PDF report before deploying.
             - type: section
               title: Publish the source on GitHub
               blocks:
                 - type: text
                   paragraphs:
                     - Create an empty repository on GitHub, then push the EdgePress source. In the Cloudflare dashboard, create a Worker and connect that repository with Workers Builds. Choose main as the production branch. Set a unique Worker name in wrangler.jsonc before deployment.
-                    - The build and deploy scripts in package.json are detected by Workers Builds. It runs npm run build to generate dist/, then npm run deploy to publish the Worker. dist/ stays out of Git. Cloudflare manages the build authorization for this connection.
+                    - For this repository, set Workers Builds root directory to /, build command to npm run build, and deploy command to npx wrangler deploy. No build variables are required. The build command generates dist/ before Wrangler publishes the Worker; dist/ stays out of Git.
+                    - The Deploy to Cloudflare button in the GitHub README creates a new GitHub repository copy and a new Worker. During setup, choose unused names for both. If a repository or Worker named edgepress already exists, choose a different name. To update an existing Worker, use its existing repository and Workers Builds connection; the button does not attach to or update an existing project.
+                    - If the log remains at Initializing build environment before cloning the repository or running commands, verify that the Cloudflare Workers and Pages GitHub App still has access to this repository. Reconnect the repository or reinstall and reauthorize the app, then retry. Check that the selected Cloudflare API token is still valid; Workers Builds can create a token automatically, and stale tokens must be replaced in Build settings. This stage runs before the project build command.
                 - type: code
                   title: Upload the source repository
                   language: sh
@@ -108,10 +110,14 @@ blocks:
                 - type: link-list
                   title: Deployment references
                   items:
-                    - label: Connect GitHub to Cloudflare Workers Builds
+                    - label: Connect or reauthorize the GitHub integration
                       url: https://developers.cloudflare.com/workers/ci-cd/builds/git-integration/github-integration/
                     - label: Configure Workers Builds commands
                       url: https://developers.cloudflare.com/workers/ci-cd/builds/configuration/
+                    - label: Troubleshoot Workers Builds
+                      url: https://developers.cloudflare.com/workers/ci-cd/builds/troubleshoot/
+                    - label: Deploy button behavior and setup
+                      url: https://developers.cloudflare.com/workers/platform/deploy-buttons/
             - type: section
               title: Generate files for OpenResty or Nginx
               blocks:

package/content/pages/quick-start/zh-cn.md

@@ -10,7 +10,7 @@ blocks:
         - type: hero
           eyebrow: 从这里开始
           title: 配置项目并打开实时预览。
-          text: 安装项目依赖后使用 edgepress 命令。本地预览会在源文件变更后自动构建，并刷新无障碍化和 agent 友好度报告。
+          text: 安装项目依赖后使用 edgepress 命令。本地预览会在源文件变更后自动构建，并刷新无障碍化和 agent 友好度 PDF 报告。
   - columns: 1
     cells:
       -
@@ -76,7 +76,7 @@ blocks:
                 - 在 config.yml 中编辑站点标题、简介、规范 URL、agent SEO、导航、页脚文字和隐私运营者信息。主题配色保存在各自主题的 CSS 中。
                 - 使用 edgepress theme list 查看主题，使用 edgepress theme use <主题名称> 切换主题。主题路径保存在 edgepress.config.mjs 中。
                 - 使用 edgepress theme install <npm-package> 安装主题包，或使用 edgepress theme create <名称> 创建空白主题。
-                - edgepress server 会启动本地 Wrangler 服务、监视源文件、重新构建变更页面、刷新浏览器，并更新 tools/page-check.md 和 tools/page-check.json。
+                - edgepress server 会启动本地 Wrangler 服务、监视源文件、重新构建变更页面、刷新浏览器，并更新 tools/page-check.pdf。截图会嵌入 PDF，生成后会清理临时文件。
             - type: code
               title: 构建、检查和部署
               language: sh
@@ -85,14 +85,16 @@ blocks:
                 edgepress doctor
                 edgepress deploy
             - type: text
-              text: 兼容性检查会读取 project-compatibility.json 和 wrangler.jsonc 中的 Node.js 基线、Worker 入口和兼容日期。部署前请查看生成的报告。
+              text: 兼容性检查会读取 project-compatibility.json 和 wrangler.jsonc 中的 Node.js 基线、Worker 入口和兼容日期。部署前请查看 PDF 报告。
             - type: section
               title: 将源代码上传到 GitHub
               blocks:
                 - type: text
                   paragraphs:
                     - 在 GitHub 创建空仓库并推送 EdgePress 源代码。然后在 Cloudflare 控制台创建 Worker，并通过 Workers Builds 连接该仓库，选择 main 作为生产分支。部署前请在 wrangler.jsonc 中设置唯一的 Worker 名称。
-                    - Workers Builds 会读取 package.json 中的 build 和 deploy 脚本，先运行 npm run build 生成 dist/，再运行 npm run deploy 发布 Worker。dist/ 不会提交到 Git；Cloudflare 会管理此连接的构建授权。
+                    - 此仓库的 Workers Builds 设置为：根目录 /、构建命令 npm run build、部署命令 npx wrangler deploy。无需添加构建变量。构建命令会先生成 dist/，再由 Wrangler 发布 Worker；dist/ 不会提交到 Git。
+                    - GitHub README 中的一键部署按钮会在你的 GitHub 账户创建一份新仓库副本，并在 Cloudflare 创建一个新 Worker。设置时请为目标仓库和 Worker 选择未占用的名称。如果 `edgepress` 已存在，请改用其他名称。要更新已有 Worker，请继续使用它已连接的仓库和 Workers Builds；按钮不会连接或更新已有项目。
+                    - 如果日志在克隆仓库或运行命令前一直停留在 Initializing build environment，请检查 Cloudflare Workers and Pages GitHub App 是否仍有此仓库的访问权限。重新连接仓库，或重新安装并授权该 App 后再试。还需确认所选 Cloudflare API Token 仍有效；Workers Builds 可以自动创建 Token，如果已选 Token 失效，需要在 Build 设置中替换。此阶段尚未运行项目构建命令。
                 - type: code
                   title: 推送源代码仓库
                   language: sh
@@ -108,10 +110,14 @@ blocks:
                 - type: link-list
                   title: 部署参考
                   items:
-                    - label: 将 GitHub 连接到 Cloudflare Workers Builds
+                    - label: 连接或重新授权 GitHub 集成
                       url: https://developers.cloudflare.com/workers/ci-cd/builds/git-integration/github-integration/
                     - label: 配置 Workers Builds 命令
                       url: https://developers.cloudflare.com/workers/ci-cd/builds/configuration/
+                    - label: 排查 Workers Builds
+                      url: https://developers.cloudflare.com/workers/ci-cd/builds/troubleshoot/
+                    - label: 一键部署按钮的工作方式
+                      url: https://developers.cloudflare.com/workers/platform/deploy-buttons/
             - type: section
               title: 为 OpenResty 或 Nginx 生成静态文件
               blocks:

package/content/posts/2026-09-25-edgepress-release-2026-9-4/en.md

@@ -0,0 +1,26 @@
+---
+title: "EdgePress September 2026 update: request 4"
+date: 2026-09-25
+lang: en
+slug: edgepress-release-2026-9-4
+tags:
+  - release
+  - reports
+  - cloudflare
+---
+
+This is the fourth requested EdgePress update for September 2026.
+
+## Keep the audit report in one PDF
+
+`edgepress check` and `edgepress server` now persist only `tools/page-check.pdf`. Desktop and mobile screenshots are embedded in the PDF; temporary HTML and screenshot files are removed after generation.
+
+## Remove the templates directory
+
+`edgepress init` now writes its generated README and `.gitignore` directly from the CLI package. The source and npm package no longer include a `templates/` directory.
+
+## Cloudflare Workers Builds setup
+
+The quick-start guide records the repository settings: root directory `/`, build command `npm run build`, deploy command `npx wrangler deploy`, and no required build variables. It also explains that a build stuck at `Initializing build environment` has not run the project build command yet; reconnect the GitHub integration or replace a stale Cloudflare build API token before retrying.
+
+Wrangler requires `compatibility_date` for this Worker, so the project pins it to the first day of the month: `2026-09-01`.

package/content/posts/2026-09-25-edgepress-release-2026-9-4/zh-cn.md

@@ -0,0 +1,26 @@
+---
+title: EdgePress 2026 年 9 月更新：第 4 次需求
+date: 2026-09-25
+lang: zh-CN
+slug: edgepress-release-2026-9-4
+tags:
+  - 发布
+  - 报告
+  - Cloudflare
+---
+
+这是 EdgePress 在 2026 年 9 月针对第 4 次需求的更新。
+
+## 审核报告只保留 PDF
+
+`edgepress check` 和 `edgepress server` 现在只在 `tools/page-check.pdf` 保存报告。桌面和移动端截图会嵌入 PDF，临时 HTML 和截图文件会在生成后清理。
+
+## 移除 templates 目录
+
+`edgepress init` 现在由 CLI 包直接写入新项目的 README 和 `.gitignore`。源码与 npm 包不再包含 `templates/` 目录。
+
+## Cloudflare Workers Builds 设置
+
+快速入门指南现已记录本仓库设置：根目录 `/`、构建命令 `npm run build`、部署命令 `npx wrangler deploy`，且无需配置构建变量。指南也说明，构建若停留在 `Initializing build environment`，表示项目构建命令还未运行；应重新连接 GitHub 集成，或替换失效的 Cloudflare 构建 API Token 后再试。
+
+Wrangler 要求此 Worker 设置 `compatibility_date`，因此项目将其固定为本月第一天：`2026-09-01`。

package/content/posts/2026-09-25-edgepress-release-2026-9-5/en.md

@@ -0,0 +1,17 @@
+---
+title: "EdgePress September 2026 update: request 5"
+date: 2026-09-25
+lang: en
+slug: edgepress-release-2026-9-5
+tags:
+  - release
+  - cloudflare
+---
+
+This is the fifth requested EdgePress update for September 2026.
+
+## Clarify Cloudflare one-click deployment
+
+The README and bilingual quick-start guides now explain that Cloudflare's Deploy button creates a new GitHub repository copy and a new Worker. Choose unused names for both during setup. The button does not connect to or update an existing Worker; use the existing repository's Workers Builds connection to publish updates.
+
+The release notes and project compatibility history are updated as version `2026.9.5`.

package/content/posts/2026-09-25-edgepress-release-2026-9-5/zh-cn.md

@@ -0,0 +1,17 @@
+---
+title: EdgePress 2026 年 9 月更新：第 5 次需求
+date: 2026-09-25
+lang: zh-CN
+slug: edgepress-release-2026-9-5
+tags:
+  - 发布
+  - Cloudflare
+---
+
+这是 EdgePress 在 2026 年 9 月针对第 5 次需求的更新。
+
+## 说明 Cloudflare 一键部署的行为
+
+README 和中英文快速入门现已说明，Cloudflare 一键部署按钮会创建新的 GitHub 仓库副本和新的 Worker。设置时需要为两者选择未占用的名称。按钮不会连接或更新已有 Worker；更新已有项目应使用原仓库连接的 Workers Builds。
+
+发布说明和项目兼容性历史已更新至 `2026.9.5`。

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "edgepress",
-  "version": "2026.9.3",
+  "version": "2026.9.5",
   "description": "A static website builder for Cloudflare Workers with editable pages, Markdown posts, local search, themes, and consent-gated integrations.",
   "type": "module",
   "bin": {
@@ -12,7 +12,6 @@
     "plugins",
     "src",
     "static",
-    "templates",
     "themes",
     "config.yml",
     "edgepress.config.mjs",

package/project-compatibility.json

@@ -1,6 +1,6 @@
 {
   "schemaVersion": 1,
-  "frameworkVersion": "2026.9.3",
+  "frameworkVersion": "2026.9.5",
   "requirements": {
     "nodeMajor": 22,
     "nodeMinimumVersion": "22.12.0",
@@ -15,7 +15,7 @@
     { "name": "Row-based editable pages and reusable layout components", "stage": "experimental", "since": "2026.9.1" },
     { "name": "Image/video with text and display typography elements", "stage": "experimental", "since": "2026.9.1" },
     { "name": "i18n locale routes", "stage": "experimental", "since": "2026.9.1" },
-    { "name": "Accessibility and agent-friendliness report with screenshots and PDF", "stage": "experimental", "since": "2026.9.1" },
+    { "name": "Accessibility and agent-friendliness PDF report with embedded screenshots", "stage": "experimental", "since": "2026.9.1" },
     { "name": "Consent-gated browser plugins", "stage": "experimental", "since": "2026.9.1" },
     { "name": "Service binding and URL/token backend proxy", "stage": "experimental", "since": "2026.9.1" },
     { "name": "Live local preview and theme switching", "stage": "experimental", "since": "2026.9.1" },
@@ -23,7 +23,9 @@
     { "name": "Local browser search across Markdown posts", "stage": "experimental", "since": "2026.9.2" },
     { "name": "Markdown syntax verification and responsive post screenshots", "stage": "experimental", "since": "2026.9.2" },
     { "name": "Compact localized language selector", "stage": "experimental", "since": "2026.9.2" },
-    { "name": "npm theme installation and blank theme scaffolds", "stage": "experimental", "since": "2026.9.3" }
+    { "name": "npm theme installation and blank theme scaffolds", "stage": "experimental", "since": "2026.9.3" },
+    { "name": "PDF-only audit output and temporary screenshot capture", "stage": "experimental", "since": "2026.9.4" },
+    { "name": "Cloudflare one-click deployment guidance for existing and new projects", "stage": "stable", "since": "2026.9.5" }
   ],
   "releaseHistory": [
     {
@@ -43,6 +45,18 @@
       "date": "2026-09-25",
       "request": 3,
       "notes": "Published EdgePress for npm installation, added npm theme installation and blank theme packages, documented GitHub and Cloudflare Workers Builds deployment, and added a Cloudflare one-click deployment button."
+    },
+    {
+      "version": "2026.9.4",
+      "date": "2026-09-25",
+      "request": 4,
+      "notes": "Keep audit output as a single accessible PDF with embedded screenshots, remove the templates directory and package archive, document Workers Builds initialization troubleshooting, and pin the Wrangler compatibility date to the first of the month."
+    },
+    {
+      "version": "2026.9.5",
+      "date": "2026-09-25",
+      "request": 5,
+      "notes": "Clarify that the Cloudflare one-click deployment button creates a new repository copy and Worker, explain unique naming and the path for updating existing Workers, and publish the guidance in README and bilingual quick-start pages."
     }
   ]
 }

package/src/cli.js

@@ -10,6 +10,31 @@ import { slugify } from './content.js';
 import { checkPages } from './page-check.js';
 import { checkCompatibility, writeIterationPlan } from './maintenance.js';
 
+const siteGitignore = ['node_modules/', 'dist/', '.edgepress/', '.wrangler/', '.dev.vars', '*.tgz', ''].join('\n');
+const siteReadme = [
+  '# My EdgePress site',
+  '',
+  'Static site source built with EdgePress. Use Node.js 22.12 or newer.',
+  '',
+  '## Start locally',
+  '',
+  '    npm install',
+  '    edgepress server',
+  '',
+  'Edit localized pages in `content/pages/` and Markdown posts in `content/posts/`. Choose a shared layout with `edgepress theme list` and `edgepress theme use <name>`.',
+  '',
+  '## Deploy to Cloudflare Workers',
+  '',
+  'Push this source repository to GitHub, then connect the repository to Cloudflare Workers Builds. The `build` and `deploy` scripts in `package.json` generate the static files and deploy the Worker. Set a unique Worker name in `wrangler.jsonc` first.',
+  '',
+  'For a local deployment, run `npx wrangler login`, then `edgepress deploy`.',
+  '',
+  '## Use another static web server',
+  '',
+  'Run `edgepress generate` and upload the contents of `dist/` to the server document root. OpenResty and Nginx can serve the generated directories as static files. Worker API routes and service bindings need a Worker or an equivalent server-side route.',
+  ''
+].join('\n');
+
 async function initializeProject() {
   const packageRoot = resolve(dirname(fileURLToPath(import.meta.url)), '..');
   const root = process.cwd();
@@ -61,11 +86,11 @@ async function initializeProject() {
   };
   for (const directory of directories) await cp(resolve(packageRoot, directory), resolve(root, directory), { recursive: true, errorOnExist: true });
   for (const file of files) {
-    const source = file === '.gitignore' ? resolve(packageRoot, 'templates/gitignore') :
-      file === 'README.md' ? resolve(packageRoot, 'templates/site-readme.md') : resolve(packageRoot, file);
     const destination = resolve(root, file);
     await mkdir(dirname(destination), { recursive: true });
-    await cp(source, destination, { errorOnExist: true });
+    if (file === '.gitignore') await writeFile(destination, siteGitignore, { flag: 'wx' });
+    else if (file === 'README.md') await writeFile(destination, siteReadme, { flag: 'wx' });
+    else await cp(resolve(packageRoot, file), destination, { errorOnExist: true });
   }
   await mkdir(resolve(root, 'src'), { recursive: true });
   await cp(resolve(packageRoot, 'src/worker.js'), resolve(root, 'src/worker.js'), { errorOnExist: true });
@@ -324,7 +349,7 @@ try {
     await buildSite(config.root);
     const pageReport = await checkPages(config);
     const compatibilityReport = await checkCompatibility(config);
-    await showReport('Page check', pageReport, resolve(config.root, 'tools/page-check.md'));
+    await showReport('Page check', pageReport, resolve(config.root, 'tools/page-check.pdf'));
     await showReport('Compatibility check', compatibilityReport, resolve(config.resolvedPaths.cache, 'reports/compatibility.md'));
     if (pageReport.errors || compatibilityReport.issues.some((issue) => issue.severity === 'error')) process.exitCode = 1;
   } else if (command === 'doctor') {

package/src/page-check.js

@@ -1,4 +1,4 @@
-import { access, lstat, mkdir, readFile, readdir, realpath, writeFile } from 'node:fs/promises';
+import { access, lstat, mkdir, readFile, readdir, realpath, rm } from 'node:fs/promises';
 import { extname, isAbsolute, relative, resolve, sep } from 'node:path';
 import { addVisualEvidence } from './report-visuals.js';
 
@@ -136,49 +136,6 @@ function auditSummary(checks, findings) {
   };
 }
 
-function markdownReport(report) {
-  const lines = [
-    '# EdgePress accessibility and agent-friendliness audit',
-    '',
-    'Overall status: **' + report.status + '**',
-    '',
-    '| Audit | Status | Score | Checks | Errors | Warnings |',
-    '| --- | --- | ---: | ---: | ---: | ---: |',
-    '| Accessibility | ' + report.accessibility.status + ' | ' + report.accessibility.score + '% | ' + report.accessibility.checks + ' | ' + report.accessibility.errors + ' | ' + report.accessibility.warnings + ' |',
-    '| Agent friendliness | ' + report.agentFriendliness.status + ' | ' + report.agentFriendliness.score + '% | ' + report.agentFriendliness.checks + ' | ' + report.agentFriendliness.errors + ' | ' + report.agentFriendliness.warnings + ' |',
-    '| Markdown rendering | ' + report.markdownRendering.status + ' | ' + Math.floor(report.markdownRendering.passed / Math.max(1, report.markdownRendering.checks) * 100) + '% | ' + report.markdownRendering.checks + ' | ' + (report.markdownRendering.checks - report.markdownRendering.passed) + ' | 0 |',
-    '| Report reading structure | ' + (report.visualEvidence?.reportAccessibility?.status || 'pending') + ' | ' +
-      Math.floor((report.visualEvidence?.reportAccessibility?.passed || 0) / Math.max(1, report.visualEvidence?.reportAccessibility?.checks || 0) * 100) + '% | ' +
-      (report.visualEvidence?.reportAccessibility?.checks || 0) + ' | ' +
-      ((report.visualEvidence?.reportAccessibility?.checks || 0) - (report.visualEvidence?.reportAccessibility?.passed || 0)) + ' | 0 |',
-    '',
-    'Generated documents: ' + report.pages + ' | Posts: ' + report.contentSummary.posts + ' | Pages: ' + report.contentSummary.pages +
-      ' | System routes: ' + report.contentSummary.system + ' | Errors: ' + report.errors + ' | Warnings: ' + report.warnings,
-    'HTML bytes: ' + report.metrics.htmlBytes + ' | Stylesheet references: ' + report.metrics.stylesheets +
-      ' | Potentially render-blocking stylesheets: ' + report.metrics.blockingStylesheets +
-    ' | Script references: ' + report.metrics.scripts + ' | Blocking scripts: ' + report.metrics.blockingScripts,
-    '',
-    report.visualEvidence?.status === 'complete'
-      ? 'Accessible PDF evidence: [page-check.pdf](page-check.pdf) | HTML report: [page-check-visual.html](page-check-visual.html) | Screenshots: ' +
-        report.visualEvidence.screenshots.map((item) => '[' + item.title + ' · ' + item.viewport + ' (' + item.viewportWidth + '/' + item.documentWidth + ' px)](' + item.path.replace(/^tools\//, '') + ')').join(' · ')
-      : 'Visual evidence: ' + (report.visualEvidence?.reason || 'not generated'),
-    '',
-    '## Findings',
-    ''
-  ];
-  if (!report.issues.length) lines.push('No findings.');
-  for (const issue of report.issues) lines.push('- **' + issue.severity.toUpperCase() + ' · ' + issue.category + '** ' + issue.page + ' — ' + issue.message);
-  lines.push('', '## Markdown rendering', '', 'Verified ' + report.markdownRendering.passed + ' of ' + report.markdownRendering.checks +
-    ' syntax combinations in the generated tutorial post.');
-  for (const document of report.markdownRendering.documents) {
-    lines.push('', '### ' + document.path, '', ...document.checks.map((item) => '- [' + (item.passed ? 'x' : ' ') + '] ' + item.feature));
-  }
-  lines.push('', '## Documents reviewed', '', '| Type | Count |', '| --- | ---: |', '| Posts | ' + report.contentSummary.posts + ' |',
-    '| Customizable pages and homepages | ' + report.contentSummary.pages + ' |', '| System routes | ' + report.contentSummary.system + ' |');
-  lines.push('', '## Scope', '', ...report.scope.map((item) => '- ' + item), '', 'This report is written outside the public output directory.');
-  return lines.join('\n');
-}
-
 export async function checkPages(config) {
   const output = config.resolvedPaths.output;
   const files = await htmlFiles(output);
@@ -380,28 +337,35 @@ export async function checkPages(config) {
   const root = await realpath(config.root);
   const directory = await realpath(requestedDirectory);
   if (!isInside(root, directory)) throw new Error('Page-check report directory must stay inside the project root');
-  const jsonPath = resolve(directory, 'page-check.json');
-  const markdownPath = resolve(directory, 'page-check.md');
-  for (const file of [jsonPath, markdownPath]) {
+  for (const name of ['page-check.json', 'page-check.md', 'page-check-visual.html']) {
+    const file = resolve(directory, name);
     try {
       const info = await lstat(file);
-      if (info.isSymbolicLink() || !info.isFile()) throw new Error('Refusing an unsafe page-check report path: ' + file);
+      if (info.isSymbolicLink() || !info.isFile()) throw new Error('Refusing an unsafe legacy report path: ' + file);
+      await rm(file);
     } catch (error) {
       if (error.code !== 'ENOENT') throw error;
     }
   }
-  for (const file of [resolve(directory, 'page-check.pdf'), resolve(directory, 'page-check-visual.html')]) {
-    try {
-      const info = await lstat(file);
-      if (info.isSymbolicLink() || !info.isFile()) throw new Error('Refusing an unsafe visual report path: ' + file);
-    } catch (error) {
-      if (error.code !== 'ENOENT') throw error;
-    }
+  const screenshotsDirectory = resolve(directory, 'page-check-screenshots');
+  try {
+    const info = await lstat(screenshotsDirectory);
+    if (info.isSymbolicLink() || !info.isDirectory()) throw new Error('Refusing an unsafe legacy screenshots path: ' + screenshotsDirectory);
+    await rm(screenshotsDirectory, { recursive: true });
+  } catch (error) {
+    if (error.code !== 'ENOENT') throw error;
+  }
+  const pdfPath = resolve(directory, 'page-check.pdf');
+  try {
+    const info = await lstat(pdfPath);
+    if (info.isSymbolicLink() || !info.isFile()) throw new Error('Refusing an unsafe PDF report path: ' + pdfPath);
+  } catch (error) {
+    if (error.code !== 'ENOENT') throw error;
   }
   try {
     report.visualEvidence = await addVisualEvidence(config, report);
     if (report.visualEvidence.status !== 'complete') {
-      issues.push({ severity: 'warning', category: 'visual-evidence', page: 'report', message: report.visualEvidence.reason || 'Visual evidence was not generated.' });
+      issues.push({ severity: 'warning', category: 'visual-evidence', page: 'report', message: report.visualEvidence.reason || 'PDF generation failed.' });
     }
   } catch (error) {
     report.visualEvidence = { status: 'failed', reason: error.message };
@@ -410,7 +374,5 @@ export async function checkPages(config) {
   report.errors = issues.filter((issue) => issue.severity === 'error').length;
   report.warnings = issues.filter((issue) => issue.severity === 'warning').length;
   report.status = report.errors ? 'fail' : report.warnings ? 'warning' : 'pass';
-  await writeFile(jsonPath, JSON.stringify(report, null, 2), 'utf8');
-  await writeFile(markdownPath, markdownReport(report), 'utf8');
   return report;
 }

package/src/preview.js

@@ -57,7 +57,7 @@ async function main() {
     await buildSite(root, { preview: true });
     const currentConfig = await loadConfig(root);
     const report = await checkPages(currentConfig);
-    console.log('Accessibility and agent-friendliness report: ' + report.status +
+    console.log('Accessibility and agent-friendliness PDF report: ' + report.status +
       ' (' + report.accessibility.status + ', ' + report.agentFriendliness.status + ')');
   }
 

package/src/report-visuals.js

@@ -247,7 +247,7 @@ function reportHtml(report, screenshots) {
     escapeHtml(String(report.markdownRendering?.checks || 0)) + ' syntax checks passed across the tutorial post locales.</p>' + markdownDetails + '</section>' +
     '<section id="evidence" class="appendix"><h2>Responsive page screenshots</h2><p>Mobile screenshots use a 390 by 844 CSS pixel viewport. Each caption includes the measured document width so horizontal overflow is visible in the report.</p>' +
     screenshotGroups + '</section><section id="scope"><h2>Scope and limits</h2><ul>' + report.scope.map((item) => '<li>' + escapeHtml(item) + '</li>').join('') +
-    '</ul></section></main><footer><p>EdgePress local build report. Use the HTML source for reflowable reading; screenshots are evidence and may contain text too small to read when printed.</p></footer></body></html>';
+    '</ul></section></main><footer><p>EdgePress local PDF report. Screenshot details are included as evidence and may be small when printed.</p></footer></body></html>';
 }
 
 function checkReportReadingStructure(html) {
@@ -351,73 +351,67 @@ function siteAddress(relativeFile) {
 
 export async function addVisualEvidence(config, report) {
   const root = resolve(config.root, 'tools');
-  const evidenceDirectory = resolve(root, 'page-check-screenshots');
   const directoryInfo = await lstat(root);
   if (directoryInfo.isSymbolicLink() || !directoryInfo.isDirectory()) throw new Error('Report directory must be a real directory');
-  await mkdir(evidenceDirectory, { recursive: true });
-  const evidenceInfo = await lstat(evidenceDirectory);
-  if (evidenceInfo.isSymbolicLink() || !evidenceInfo.isDirectory()) throw new Error('Screenshot directory must be a real directory');
   const browser = await browserPath();
   if (!browser) {
     return { status: 'unavailable', reason: 'Install Microsoft Edge, Chrome, or Chromium to capture page screenshots and PDF evidence.' };
   }
 
-  const documents = new Map((report.documents || []).map((item) => [item.path, item]));
-  const candidates = new Set((report.documents || [])
-    .filter((item) => ['post', 'page', 'homepage'].includes(item.type))
-    .map((item) => item.path));
-  for (const locale of config.i18n.locales) {
-    const prefix = locale === config.i18n.defaultLocale ? '' : locale + '/';
-    candidates.add(prefix + 'index.html');
-    candidates.add(prefix + 'privacy-policy/index.html');
-  }
-  for (const issue of report.issues) {
-    if (issue.page && issue.page.toLowerCase().endsWith('.html')) candidates.add(issue.page);
-  }
-
-  const available = [];
-  for (const relativeFile of candidates) {
-    const target = resolve(config.resolvedPaths.output, relativeFile);
-    try {
-      const info = await lstat(target);
-      if (info.isFile() && !info.isSymbolicLink()) available.push(relativeFile);
-    } catch (error) {
-      if (error.code !== 'ENOENT') throw error;
+  const stamp = createHash('sha256').update(report.generatedAt).digest('hex').slice(0, 8);
+  const profile = await mkdtemp(resolve(tmpdir(), 'edgepress-report-' + process.pid + '-' + stamp + '-'));
+  const evidenceDirectory = resolve(profile, 'page-check-screenshots');
+  const htmlPath = resolve(profile, 'report.html');
+  const pdfPath = resolve(root, 'page-check.pdf');
+  let reportServer;
+  let browserSession;
+  try {
+    await mkdir(evidenceDirectory, { recursive: true });
+    const evidenceInfo = await lstat(evidenceDirectory);
+    if (evidenceInfo.isSymbolicLink() || !evidenceInfo.isDirectory()) throw new Error('Temporary screenshot directory must be a real directory');
+    const documents = new Map((report.documents || []).map((item) => [item.path, item]));
+    const candidates = new Set((report.documents || [])
+      .filter((item) => ['post', 'page', 'homepage'].includes(item.type))
+      .map((item) => item.path));
+    for (const locale of config.i18n.locales) {
+      const prefix = locale === config.i18n.defaultLocale ? '' : locale + '/';
+      candidates.add(prefix + 'index.html');
+      candidates.add(prefix + 'privacy-policy/index.html');
+    }
+    for (const issue of report.issues) {
+      if (issue.page && issue.page.toLowerCase().endsWith('.html')) candidates.add(issue.page);
     }
-  }
 
-  const stamp = createHash('sha256').update(report.generatedAt).digest('hex').slice(0, 8);
-  const screenshots = [];
-  const desktop = { name: 'desktop', width: 1440, height: 1100 };
-  const mobile = { name: 'mobile', width: 390, height: 844 };
-  const homePaths = new Set(config.i18n.locales.map((locale) => locale === config.i18n.defaultLocale ? 'index.html' : locale + '/index.html'));
-  const privacyPaths = new Set(config.i18n.locales.map((locale) =>
-    (locale === config.i18n.defaultLocale ? '' : locale + '/') + 'privacy-policy/index.html'));
-  for (const relativeFile of available) {
-    const document = documents.get(relativeFile) || { type: 'system', title: relativeFile };
-    const viewports = homePaths.has(relativeFile) || privacyPaths.has(relativeFile) || document.type === 'post'
-      ? [desktop, mobile] : [mobile];
-    for (const viewport of viewports) {
-      const digest = createHash('sha256').update(relativeFile + ':' + viewport.name).digest('hex').slice(0, 10);
-      const file = 'page-' + digest + '.png';
-      const target = resolve(evidenceDirectory, file);
+    const available = [];
+    for (const relativeFile of candidates) {
+      const target = resolve(config.resolvedPaths.output, relativeFile);
       try {
-        const existing = await lstat(target);
-        if (existing.isSymbolicLink() || !existing.isFile()) throw new Error('Refusing an unsafe screenshot path: ' + target);
+        const info = await lstat(target);
+        if (info.isFile() && !info.isSymbolicLink()) available.push(relativeFile);
       } catch (error) {
         if (error.code !== 'ENOENT') throw error;
       }
-      screenshots.push({ page: relativeFile, type: document.type, title: document.title, viewport: viewport.name, width: viewport.width,
-        height: viewport.height, file, target,
-        label: relativeFile + ' · ' + viewport.name + ' (' + viewport.width + '×' + viewport.height + ')' });
     }
-  }
-  const htmlPath = resolve(root, 'page-check-visual.html');
-  const pdfPath = resolve(root, 'page-check.pdf');
-  const profile = await mkdtemp(resolve(tmpdir(), 'edgepress-report-' + process.pid + '-' + stamp + '-'));
-  let reportServer;
-  let browserSession;
-  try {
+
+    const screenshots = [];
+    const desktop = { name: 'desktop', width: 1440, height: 1100 };
+    const mobile = { name: 'mobile', width: 390, height: 844 };
+    const homePaths = new Set(config.i18n.locales.map((locale) => locale === config.i18n.defaultLocale ? 'index.html' : locale + '/index.html'));
+    const privacyPaths = new Set(config.i18n.locales.map((locale) =>
+      (locale === config.i18n.defaultLocale ? '' : locale + '/') + 'privacy-policy/index.html'));
+    for (const relativeFile of available) {
+      const document = documents.get(relativeFile) || { type: 'system', title: relativeFile };
+      const viewports = homePaths.has(relativeFile) || privacyPaths.has(relativeFile) || document.type === 'post'
+        ? [desktop, mobile] : [mobile];
+      for (const viewport of viewports) {
+        const digest = createHash('sha256').update(relativeFile + ':' + viewport.name).digest('hex').slice(0, 10);
+        const file = 'page-' + digest + '.png';
+        const target = resolve(evidenceDirectory, file);
+        screenshots.push({ page: relativeFile, type: document.type, title: document.title, viewport: viewport.name, width: viewport.width,
+          height: viewport.height, file, target,
+          label: relativeFile + ' · ' + viewport.name + ' (' + viewport.width + '×' + viewport.height + ')' });
+      }
+    }
     reportServer = await startReportServer(config.resolvedPaths.output, evidenceDirectory, htmlPath);
     browserSession = await startHeadlessBrowser(browser, profile);
     for (const screenshot of screenshots) {
@@ -449,13 +443,13 @@ export async function addVisualEvidence(config, report) {
     report.visualEvidence = { status: 'complete', pdf: 'tools/page-check.pdf', screenshots: screenshots.map((item) => ({
       page: item.page, type: item.type, title: item.title, viewport: item.viewport, width: item.width, height: item.height,
       viewportWidth: item.viewportWidth, documentWidth: item.documentWidth,
-      path: 'tools/page-check-screenshots/' + item.file, label: item.label
+      label: item.label
     })) };
     const initialHtml = reportHtml(report, screenshots);
     const reportAccessibility = checkReportReadingStructure(initialHtml);
     report.visualEvidence.reportAccessibility = reportAccessibility;
     for (const check of reportAccessibility.results.filter((item) => !item.passed)) {
-      report.issues.push({ severity: 'error', category: 'report-accessibility', page: 'tools/page-check-visual.html',
+      report.issues.push({ severity: 'error', category: 'report-accessibility', page: 'tools/page-check.pdf',
         message: 'Report reading requirement failed: ' + check.name + '.' });
     }
     report.errors = report.issues.filter((item) => item.severity === 'error').length;

package/wrangler.jsonc

@@ -3,7 +3,7 @@
   "$schema": "./node_modules/wrangler/config-schema.json",
   "name": "edgepress",
   "main": "./src/worker.js",
-  "compatibility_date": "2026-09-24",
+  "compatibility_date": "2026-09-01",
   "assets": {
     "directory": "./dist",
     "binding": "ASSETS",

package/templates/gitignore

@@ -1,6 +0,0 @@
-node_modules/
-dist/
-.edgepress/
-.wrangler/
-.dev.vars
-*.tgz

package/templates/site-readme.md

@@ -1,20 +0,0 @@
-# My EdgePress site
-
-Static site source built with EdgePress. Use Node.js 22.12 or newer.
-
-## Start locally
-
-    npm install
-    edgepress server
-
-Edit localized pages in `content/pages/` and Markdown posts in `content/posts/`. Choose a shared layout with `edgepress theme list` and `edgepress theme use <name>`.
-
-## Deploy to Cloudflare Workers
-
-Push this source repository to GitHub, then connect the repository to Cloudflare Workers Builds. The `build` and `deploy` scripts in `package.json` generate the static files and deploy the Worker. Set a unique Worker name in `wrangler.jsonc` first.
-
-For a local deployment, run `npx wrangler login`, then `edgepress deploy`.
-
-## Use another static web server
-
-Run `edgepress generate` and upload the contents of `dist/` to the server document root. OpenResty and Nginx can serve the generated directories as static files. Worker API routes and service bindings need a Worker or an equivalent server-side route.