@mark1russell7/site-pages 0.2.8 → 0.2.9

package/README.md

@@ -161,10 +161,29 @@ The gate has three rules. A fault of one rule gives the exit code 1.
 2. The data of a page is at most 3 days old (`MAX_DATA_AGE_DAYS`), or a run on newer engines is in flight. The stamp of that run is at most 3 days old, so an old stamp does not hold the gate open.
 3. The engines of the newest run are at most 1 minor version behind npm at the start of the run (`MAX_MINORS_BEHIND`). A release during a long run does not fail the gate.
 
+Two fields of a stamp change the age rule:
+
+- `"study": true` marks a fixed study. The data has no age limit, and the rule 3 does not apply. The run names the method or the run, the date and the engine version. The stamp line tells in plain words that the page is a fixed study of that version. A page with a claim about the current engine is not a fixed study.
+- `"limit"` sets a longer age limit: `{ "days": 7, "reason": "The scan is weekly.", "workflow": ".github/workflows/scan.yml" }`. The stamp line shows the limit and the reason. The schedule of that workflow must meet the limit, or the gate fails. A limit with no schedule fails. A limit over 14 days (`MAX_LIMIT_DAYS_WITHOUT_RULING`) also needs a `ruling`, a public https link for that site.
+
 When npm does not answer, the gate prints the rule 3 under `Not run` and does not fail. A workflow turns the gate on with the input `data-stamps` of `reusable-pages.yml`. The gate then runs from the template commit, so it needs no install.
 
 `renderDataStamp(stamp)` gives the line that the page shows with its data: the run, its date, its engine versions and the run in flight.
 
+A Vite site uses the plugin `siteStamps` from `@mark1russell7/site-pages/vite`. Give the stamps, or a function that reads them from the record of the run. The plugin replaces `<!-- data-stamp -->` in each measured page. It also adds `data-stamps.json` to the built site. So the page and the gate read one record:
+
+```ts
+export default defineConfig({
+  plugins: [siteStamps(() => stampsOf(readRun()))],
+});
+```
+
+```yaml
+      data-stamps: packages/site/dist/data-stamps.json
+```
+
+A fault stops the build. A fault is a bad stamp, a mark with no stamp or a stamp with no mark. A stamp of a page that the build does not hold is also a fault.
+
 ## The releases
 
 The command merges four sources by version:
@@ -466,6 +485,7 @@ showBuild(byId("build"), __BUILD__, "owner/my-site");
 | Export of `./vite` | Operation |
 | --- | --- |
 | `siteShell({ themeKey, packageFile })` | Makes the plugin. A `base` or a `build.target` in the config of the site has priority. |
+| `siteStamps(input)` | Makes the plugin of the data stamps of a site. |
 | `themeScript(storageKey)` | Gives the text of the theme script, for a page without the plugin. |
 | `siteBase(env)` | Gives `SITE_BASE` with one `/` at the end, or `/`. |
 | `buildInfo(version, env, now)` | Gives the data of `__BUILD__`: the short commit, the date and the version. |

package/build/chunks/build.js

@@ -1,70 +1,8 @@
-import { d as headingDate, f as isShallow, l as gitTagDates, p as originRepository, r as KpiError, s as readKpi, t as KPI_FILE, u as headCommit } from "./kpi.js";
+import { A as npmPublishTimes, D as isShallow, E as headingDate, M as kindOf, N as parseVersion, O as originRepository, P as versionOfTag, S as readKpi, T as headCommit, d as inlineMarkdown, f as link, g as KPI_FILE, j as compareVersions, m as plural, p as listText, u as escapeHtml, v as KpiError, w as gitTagDates } from "./freshness.js";
 import { stripTypeScriptTypes } from "node:module";
 import { existsSync, mkdirSync, readFileSync, readdirSync, statSync, writeFileSync } from "node:fs";
 import { basename, dirname, isAbsolute, join, posix, resolve } from "node:path";
 import { parseArgs } from "node:util";
-// src/data/versions.ts
-const SEMVER = /^(0|[1-9]\d*)\.(0|[1-9]\d*)\.(0|[1-9]\d*)(?:-([0-9A-Za-z-]+(?:\.[0-9A-Za-z-]+)*))?(?:\+[0-9A-Za-z-]+(?:\.[0-9A-Za-z-]+)*)?$/;
-/** This function gives the parts of a version, or null when the text is not a SemVer version. */
-function parseVersion(version) {
-	const match = SEMVER.exec(version);
-	if (!match) return null;
-	return {
-		major: Number(match[1]),
-		minor: Number(match[2]),
-		patch: Number(match[3]),
-		prerelease: match[4] ? match[4].split(".") : []
-	};
-}
-/**
-* This function compares two versions by the SemVer precedence. It gives a negative number when `a`
-* is older, a positive number when `a` is newer, and 0 for the same version. A text that is not a
-* version comes before each version.
-*/
-function compareVersions(a, b) {
-	const x = parseVersion(a);
-	const y = parseVersion(b);
-	if (!x || !y) return x ? 1 : y ? -1 : a.localeCompare(b);
-	const core = x.major - y.major || x.minor - y.minor || x.patch - y.patch;
-	if (core !== 0) return core;
-	if (x.prerelease.length === 0 || y.prerelease.length === 0) return y.prerelease.length - x.prerelease.length;
-	for (let index = 0; index < Math.max(x.prerelease.length, y.prerelease.length); index++) {
-		const p = x.prerelease[index];
-		const q = y.prerelease[index];
-		if (p === void 0) return -1;
-		if (q === void 0) return 1;
-		if (p === q) continue;
-		const pNumber = /^\d+$/.test(p);
-		const qNumber = /^\d+$/.test(q);
-		if (pNumber && qNumber) return Number(p) - Number(q);
-		if (pNumber !== qNumber) return pNumber ? -1 : 1;
-		return p < q ? -1 : 1;
-	}
-	return 0;
-}
-/**
-* This function gives the kind of a version. The oldest version of the list is "first". The caller
-* tells if the version is the oldest.
-*/
-function kindOf(version, oldest) {
-	if (oldest) return "first";
-	const parsed = parseVersion(version);
-	if (!parsed) return "patch";
-	if (parsed.major > 0 && parsed.minor === 0 && parsed.patch === 0) return "major";
-	return parsed.patch === 0 ? "minor" : "patch";
-}
-/**
-* This function reads the version of a git tag. It knows `1.2.3`, `v1.2.3` and the tags of Changesets:
-* `name@1.2.3` and `@scope/name@1.2.3`. It gives null for another tag.
-*/
-function versionOfTag(tag) {
-	const match = /^(?:(.+)@)?v?(\d+\.\d+\.\d+(?:[-+][0-9A-Za-z.+-]*)?)$/.exec(tag.trim());
-	if (!match || match[2] === void 0 || !parseVersion(match[2])) return null;
-	return {
-		version: match[2],
-		package: match[1] ?? null
-	};
-}
 // src/data/changelog.ts
 const VERSION_HEADING = /^##\s+\[?v?(\d+\.\d+\.\d+(?:-[0-9A-Za-z.-]+)?)\]?(?:\s.*)?$/;
 const COMMIT_ENTRY = /^([0-9a-f]{7,40}):\s+([\s\S]*)$/;
@@ -235,13 +173,13 @@ function checkStateOf(rollup) {
 		default: return "none";
 	}
 }
-const object$1 = (value) => value !== null && typeof value === "object" ? value : {};
+const object = (value) => value !== null && typeof value === "object" ? value : {};
 const list = (value) => Array.isArray(value) ? value : [];
 const text = (value, fallback = "") => typeof value === "string" ? value : fallback;
-const labelsOf = (node) => list(object$1(node["labels"])["nodes"]).map((label) => object$1(label)["name"]).filter((name) => typeof name === "string");
-const authorOf = (node) => text(object$1(node["author"])["login"], "ghost");
+const labelsOf = (node) => list(object(node["labels"])["nodes"]).map((label) => object(label)["name"]).filter((name) => typeof name === "string");
+const authorOf = (node) => text(object(node["author"])["login"], "ghost");
 function failure(error, timeoutMs) {
-	if (object$1(error)["name"] === "TimeoutError") return {
+	if (object(error)["name"] === "TimeoutError") return {
 		available: false,
 		reason: `GitHub did not answer in ${timeoutMs / 1e3} s`
 	};
@@ -297,22 +235,22 @@ async function githubOpenWork(options) {
 			available: false,
 			reason: `GitHub answered with HTTP ${response.status}`
 		};
-		const body = object$1(await response.json());
+		const body = object(await response.json());
 		const errors = list(body["errors"]);
 		if (errors.length > 0) return {
 			available: false,
-			reason: `GitHub gave an error: ${text(object$1(errors[0])["message"], "no message")}`
+			reason: `GitHub gave an error: ${text(object(errors[0])["message"], "no message")}`
 		};
-		const repository = object$1(body["data"])["repository"];
+		const repository = object(body["data"])["repository"];
 		if (repository === null || typeof repository !== "object") return {
 			available: false,
 			reason: `GitHub has no repository ${owner}/${repo}`
 		};
-		const pulls = object$1(repository["pullRequests"]);
-		const open = object$1(repository["issues"]);
+		const pulls = object(repository["pullRequests"]);
+		const open = object(repository["issues"]);
 		const pullRequests = list(pulls["nodes"]).filter((node) => node !== null && typeof node === "object").map((value) => {
-			const node = object$1(value);
-			const lastCommit = object$1(object$1(list(object$1(node["commits"])["nodes"])[0])["commit"]);
+			const node = object(value);
+			const lastCommit = object(object(list(object(node["commits"])["nodes"])[0])["commit"]);
 			return {
 				number: Number(node["number"]),
 				title: text(node["title"]),
@@ -323,11 +261,11 @@ async function githubOpenWork(options) {
 				createdAt: text(node["createdAt"]),
 				updatedAt: text(node["updatedAt"]),
 				labels: labelsOf(node),
-				checks: checkStateOf(object$1(lastCommit["statusCheckRollup"]))
+				checks: checkStateOf(object(lastCommit["statusCheckRollup"]))
 			};
 		});
 		const issues = list(open["nodes"]).filter((node) => node !== null && typeof node === "object").map((value) => {
-			const node = object$1(value);
+			const node = object(value);
 			return {
 				number: Number(node["number"]),
 				title: text(node["title"]),
@@ -400,7 +338,7 @@ async function githubReleases(options) {
 				reason: "GitHub gave no list of releases"
 			};
 			for (const value of body) {
-				const release = object$1(value);
+				const release = object(value);
 				const tag = release["tag_name"];
 				if (release["draft"] === true || typeof tag !== "string") continue;
 				releases.push({
@@ -422,80 +360,6 @@ async function githubReleases(options) {
 		return failure(error, timeoutMs);
 	}
 }
-// src/data/npm.ts
-/** The public npm registry. */
-const NPM_REGISTRY = "https://registry.npmjs.org";
-const object = (value) => value !== null && typeof value === "object" ? value : {};
-function message(error) {
-	if (object(error)["name"] === "TimeoutError") return "npm did not answer in time";
-	return error instanceof Error ? error.message : String(error);
-}
-/**
-* This function reads the publication time of each version of the packages from the npm registry.
-* A scope (`@name`) gives each package of the scope. It does not throw. Each failure gives a
-* message in `problems`.
-*/
-async function npmPublishTimes(options) {
-	const { registry = NPM_REGISTRY, timeoutMs = 15e3 } = options;
-	const fetcher = options.fetch ?? globalThis.fetch;
-	const problems = [];
-	const times = [];
-	if (typeof fetcher !== "function") return {
-		times,
-		problems: ["this Node has no fetch"]
-	};
-	const get = async (url) => {
-		const response = await fetcher(url, {
-			headers: { accept: "application/json" },
-			signal: AbortSignal.timeout(timeoutMs)
-		});
-		if (!response.ok) throw new Error(`HTTP ${response.status}`);
-		return response.json();
-	};
-	const names = /* @__PURE__ */ new Set();
-	for (const entry of options.packages.map((name) => name.trim()).filter(Boolean)) {
-		if (!/^@[^/]+$/.test(entry)) {
-			names.add(entry);
-			continue;
-		}
-		try {
-			const found = object(await get(`${registry}/-/v1/search?text=scope:${encodeURIComponent(entry.slice(1))}&size=250`));
-			const objects = Array.isArray(found["objects"]) ? found["objects"] : [];
-			const before = names.size;
-			for (const item of objects) {
-				const name = object(object(item)["package"])["name"];
-				if (typeof name === "string" && name.startsWith(`${entry}/`)) names.add(name);
-			}
-			if (names.size === before) problems.push(`npm has no package in the scope ${entry}`);
-		} catch (error) {
-			problems.push(`npm did not give the packages of ${entry}: ${message(error)}`);
-		}
-	}
-	const queue = [...names].sort();
-	const worker = async () => {
-		for (let name = queue.shift(); name !== void 0; name = queue.shift()) try {
-			const packument = object(await get(`${registry}/${name.replaceAll("/", "%2f")}`));
-			const published = object(packument["versions"]);
-			for (const [version, date] of Object.entries(object(packument["time"]))) {
-				if (version === "created" || version === "modified" || typeof date !== "string") continue;
-				if (!(version in published)) continue;
-				times.push({
-					name,
-					version,
-					date
-				});
-			}
-		} catch (error) {
-			problems.push(`npm did not give the versions of ${name}: ${message(error)}`);
-		}
-	};
-	await Promise.all(Array.from({ length: 4 }, worker));
-	times.sort((a, b) => a.name.localeCompare(b.name) || a.date.localeCompare(b.date));
-	return {
-		times,
-		problems
-	};
-}
 // src/data/glob.ts
 /**
 * A small glob for the changelog files. The syntax has `*` and `?` in one path segment, and `**` for
@@ -1332,89 +1196,12 @@ async function readStatusBoard(options) {
 		...options.generatedAt ? { generatedAt: options.generatedAt } : {}
 	});
 }
-// src/render/html.ts
-/**
-* The HTML helpers of the pages: the escape functions and a small inline Markdown renderer.
-*/
-const ESCAPES = {
-	"&": "&amp;",
-	"<": "&lt;",
-	">": "&gt;",
-	"\"": "&quot;",
-	"'": "&#39;"
-};
-/** This function escapes a text for HTML content and for an attribute value in double quotes. */
-function escapeHtml(text) {
-	return String(text).replace(/[&<>"']/g, (char) => ESCAPES[char] ?? char);
-}
-/**
-* This function removes the control characters and the spaces (U+0000 to U+0020) at the two ends
-* of a text. A loop does it, because the regular expression `[\u0000- ]+$` backtracks. For a long
-* run of these characters, its time grows with the square of the length.
-*/
-function trimControl(text) {
-	let start = 0;
-	let end = text.length;
-	while (start < end && text.charCodeAt(start) <= 32) start++;
-	while (end > start && text.charCodeAt(end - 1) <= 32) end--;
-	return text.slice(start, end);
-}
-/**
-* This function gives a URL that a link can hold, or null. It accepts `http:`, `https:` and
-* `mailto:` URLs, and relative URLs. It refuses each other scheme, for example `javascript:`.
-*
-* The URL parser of a browser removes each tab and line break, and the control characters and
-* spaces at the two ends. This function removes them before the scheme check, as the browser does.
-* Thus a control character before `javascript:` does not hide the scheme.
-*/
-function safeUrl(url) {
-	const trimmed = trimControl(url.trim().replace(/[\t\n\r]/g, ""));
-	if (/^(?:https?:|mailto:)/i.test(trimmed)) return trimmed;
-	if (/^[a-z][a-z0-9+.-]*:/i.test(trimmed) || /^[/\\]{2}/.test(trimmed)) return null;
-	return trimmed;
-}
-/** This function gives an `<a>` element, or the escaped text when the URL is not safe. */
-function link(url, html, attributes = "") {
-	const href = safeUrl(url);
-	return href === null ? html : `<a href="${escapeHtml(href)}"${attributes ? ` ${attributes}` : ""}>${html}</a>`;
-}
-/** The emphasis of a text without code spans or links. The text is already escaped. */
-function emphasis(escaped) {
-	return escaped.replace(/\*\*([^*]+?)\*\*/g, "<strong>$1</strong>").replace(/(^|[^\w*])\*([^*\s][^*]*?)\*(?![\w*])/g, "$1<em>$2</em>").replace(/(^|[^\w])_([^_\s][^_]*?)_(?![\w])/g, "$1<em>$2</em>");
-}
-const INLINE = "`([^`]+)`|\\[((?:[^\\]`]|`[^`]*`)+)\\]\\(([^)\\s]+)\\)";
-/**
-* This function renders inline Markdown as HTML: code spans, links, strong text and emphasis. It
-* escapes all other text, so the result is safe.
-*/
-function inlineMarkdown(markdown) {
-	const text = String(markdown ?? "");
-	const pattern = new RegExp(INLINE, "g");
-	let html = "";
-	let last = 0;
-	for (let match = pattern.exec(text); match; match = pattern.exec(text)) {
-		html += emphasis(escapeHtml(text.slice(last, match.index)));
-		if (match[1] !== void 0) html += `<code>${escapeHtml(match[1])}</code>`;
-		else html += link(match[3] ?? "", inlineMarkdown(match[2] ?? ""));
-		last = match.index + match[0].length;
-	}
-	return html + emphasis(escapeHtml(text.slice(last)));
-}
-/** This function gives "1 item" or "2 items". */
-function plural(count, word, many = `${word}s`) {
-	return `${count} ${count === 1 ? word : many}`;
-}
-/** This function gives "a", "a and b" or "a, b and c". */
-function listText(parts) {
-	if (parts.length <= 1) return parts.join("");
-	return `${parts.slice(0, -1).join(", ")} and ${parts[parts.length - 1]}`;
-}
 // src/render/dates.ts
 /**
 * The dates of the pages. The pages show each date in UTC, so the build and the browser agree.
 */
 /** The milliseconds of one day. */
-const DAY_MS$1 = 864e5;
+const DAY_MS = 864e5;
 const MONTHS = [
 	"Jan",
 	"Feb",
@@ -1431,7 +1218,7 @@ const MONTHS = [
 ];
 /** This function gives the start of the UTC day of a time. */
 function utcDay(time) {
-	return Math.floor(time / DAY_MS$1) * DAY_MS$1;
+	return Math.floor(time / DAY_MS) * DAY_MS;
 }
 /** This function gives "Oct 18": the UTC day of a time or of an ISO date. */
 function shortDate(date) {
@@ -1688,13 +1475,13 @@ function timelineLayout(releases, options) {
 		counts.set(day, (counts.get(day) ?? 0) + 1);
 	}
 	const raw = [];
-	for (let day = utcDay(Date.parse(first.date)); day <= utcDay(Date.parse(last.date)); day += DAY_MS$1) {
+	for (let day = utcDay(Date.parse(first.date)); day <= utcDay(Date.parse(last.date)); day += DAY_MS) {
 		const count = counts.get(day) ?? 0;
 		const previous = raw[raw.length - 1];
-		if (count === 0 && previous?.empty) previous.end = day + DAY_MS$1;
+		if (count === 0 && previous?.empty) previous.end = day + DAY_MS;
 		else raw.push({
 			start: day,
-			end: day + DAY_MS$1,
+			end: day + DAY_MS,
 			count,
 			empty: count === 0,
 			weight: count === 0 ? emptyWeight : 1
@@ -2307,195 +2094,6 @@ const TYPESCRIPT_PROBE = /\.[cm]?ts$/i;
 function probeScript(source) {
 	return stripTypeScriptTypes(source, { mode: "strip" }).replace(/^export \{\s*\};?[ \t]*$/m, "");
 }
-// src/check/freshness.ts
-/**
-* The freshness gate of a measured page. A site keeps a file of data stamps.
-* Each stamp names the page, its runs, their dates and their engine versions.
-* The gate fails on a page with no versions or no run date, and on old data with no newer run in flight.
-* The gate also fails on a run that started behind the engines on npm.
-* This file imports only Node.js and the folder `data`, so `reusable-pages.yml` starts it with no npm release of the package.
-*/
-/** The schema of a file of data stamps. */
-const DATA_STAMP_SCHEMA = "data-stamp/1";
-/** The largest age of the data of a page, in days, when no newer run is in flight. */
-const MAX_DATA_AGE_DAYS = 3;
-/** The most minor versions that an engine of a run can be behind npm at the start of the run. */
-const MAX_MINORS_BEHIND = 1;
-const DAY_MS = 864e5;
-const record = (value) => value !== null && typeof value === "object" && !Array.isArray(value) ? value : null;
-/** This function gives the faults of one run of a stamp. */
-function runFaults(raw, at) {
-	const run = record(raw);
-	if (run === null) return [`${at}: a run is not an object.`];
-	const faults = [];
-	if (typeof run["id"] !== "string" || run["id"] === "") faults.push(`${at}: a run has no id.`);
-	const label = `${at}, run ${String(run["id"])}`;
-	if (typeof run["url"] !== "string" || !run["url"].startsWith("https://")) faults.push(`${label}: the run has no https link.`);
-	if (typeof run["date"] !== "string" || !Number.isFinite(Date.parse(run["date"]))) faults.push(`${label}: the run has no date.`);
-	const engines = record(run["engines"]);
-	if (engines === null || Object.keys(engines).length === 0) return [...faults, `${label}: the run names no engine versions.`];
-	for (const [name, version] of Object.entries(engines)) if (typeof version !== "string" || parseVersion(version) === null) faults.push(`${label}: the version of ${name} is not a version.`);
-	return faults;
-}
-/**
-* This function reads the content of a file of data stamps. It gives each fault of the content, so a page with no versions
-* or no run date fails here.
-*/
-function parseDataStamps(raw) {
-	const file = record(raw);
-	if (file === null) return {
-		ok: false,
-		faults: ["The file is not an object."]
-	};
-	if (file["schema"] !== "data-stamp/1") return {
-		ok: false,
-		faults: [`The schema is not ${DATA_STAMP_SCHEMA}.`]
-	};
-	const pages = file["pages"];
-	if (!Array.isArray(pages) || pages.length === 0) return {
-		ok: false,
-		faults: ["The file has no pages."]
-	};
-	const faults = [];
-	for (const item of pages) {
-		const page = record(item);
-		if (page === null || typeof page["page"] !== "string" || page["page"] === "") {
-			faults.push("A stamp has no page.");
-			continue;
-		}
-		const at = page["page"];
-		const runs = page["runs"];
-		if (!Array.isArray(runs) || runs.length === 0) faults.push(`${at}: the page names no run.`);
-		else for (const run of runs) faults.push(...runFaults(run, at));
-		if (page["inFlight"] !== void 0) faults.push(...runFaults(page["inFlight"], `${at}, in flight`));
-	}
-	return faults.length > 0 ? {
-		ok: false,
-		faults
-	} : {
-		ok: true,
-		stamps: raw
-	};
-}
-/** This function gives the count of minor versions from `used` to `latest`. A newer major version counts as no limit. */
-function minorsBehind(used, latest) {
-	const a = parseVersion(used);
-	const b = parseVersion(latest);
-	if (a === null || b === null) return Number.POSITIVE_INFINITY;
-	if (a.major !== b.major) return b.major > a.major ? Number.POSITIVE_INFINITY : 0;
-	return Math.max(0, b.minor - a.minor);
-}
-/** This function gives the newest stable version of a package on npm at a time, or undefined when npm has none. */
-function latestAt(times, name, date) {
-	const limit = Date.parse(date);
-	return times.filter((t) => t.name === name && Date.parse(t.date) <= limit && parseVersion(t.version)?.prerelease.length === 0).map((t) => t.version).sort(compareVersions).at(-1);
-}
-const ageInDays = (date, now) => (now - Date.parse(date)) / DAY_MS;
-/** This function tells if a run uses a newer version of an engine than another run. */
-function hasNewerEngine(run, than) {
-	return Object.entries(run.engines).some(([name, version]) => {
-		const old = than.engines[name];
-		return old !== void 0 && compareVersions(version, old) > 0;
-	});
-}
-/**
-* This function applies the rules of the gate to the stamps.
-*
-* - The data of each page is at most `maxAgeDays` old, or a run on newer engines is in flight.
-* - The engines of the newest run are at most `maxMinorsBehind` behind npm at the start of that run.
-* - A run in flight has the same age limit, so an old stamp does not hold the gate open.
-*/
-function checkFreshness(stamps, options) {
-	const { times, maxAgeDays = 3, maxMinorsBehind = 1 } = options;
-	const now = Date.parse(options.now);
-	const faults = [];
-	const notRun = [];
-	for (const stamp of stamps.pages) {
-		for (const run of [...stamp.runs, ...stamp.inFlight === void 0 ? [] : [stamp.inFlight]]) if (ageInDays(run.date, now) < 0) faults.push(`${stamp.page}: the run ${run.id} has a date after the check.`);
-		const flight = stamp.inFlight;
-		const flying = flight !== void 0 && ageInDays(flight.date, now) <= maxAgeDays;
-		if (flight !== void 0 && !flying) faults.push(`${stamp.page}: the run ${flight.id} is in flight for more than ${maxAgeDays} days.`);
-		for (const run of stamp.runs) {
-			const age = ageInDays(run.date, now);
-			if (age > maxAgeDays && !(flying && hasNewerEngine(flight, run))) faults.push(`${stamp.page}: the run ${run.id} is ${age.toFixed(1)} days old, over the limit of ${maxAgeDays}, and no run on newer engines is in flight.`);
-		}
-		const newest = flight ?? [...stamp.runs].sort((a, b) => Date.parse(a.date) - Date.parse(b.date)).at(-1);
-		if (newest === void 0) continue;
-		for (const [name, version] of Object.entries(newest.engines)) {
-			const latest = latestAt(times, name, newest.date);
-			if (latest === void 0) notRun.push(`${stamp.page}: npm gives no version of ${name} at the start of the run ${newest.id}.`);
-			else if (minorsBehind(version, latest) > maxMinorsBehind) faults.push(`${stamp.page}: the run ${newest.id} used ${name} ${version}, and npm had ${latest} at its start. The limit is ${maxMinorsBehind} minor version behind.`);
-		}
-	}
-	return {
-		faults,
-		notRun
-	};
-}
-/** The help of the command `site-pages freshness`. */
-const FRESHNESS_HELP = `Usage: site-pages freshness --stamps <file> [options]
-
-Examine the data stamps of the measured pages of a site.
-
-  --stamps <file>  The file of data stamps, schema ${DATA_STAMP_SCHEMA}. (necessary)
-  --now <time>     The ISO time of the check. The default is the time of the call.
-  --help           Show this text.
-
-The exit code is 0 when the stamps pass, 1 for a fault, and 2 for an incorrect command line.
-`;
-/** This function is the command `site-pages freshness`. The `fetch` option is for a test. */
-async function runFreshnessCli(argv, io, fetcher) {
-	let values;
-	try {
-		({values} = parseArgs({
-			args: [...argv],
-			allowPositionals: false,
-			options: {
-				stamps: { type: "string" },
-				now: { type: "string" },
-				help: { type: "boolean" }
-			}
-		}));
-	} catch (error) {
-		io.stderr(`site-pages freshness: ${error instanceof Error ? error.message : String(error)}\n\n${FRESHNESS_HELP}`);
-		return 2;
-	}
-	if (values.help === true) {
-		io.stdout(FRESHNESS_HELP);
-		return 0;
-	}
-	if (values.stamps === void 0) {
-		io.stderr(`site-pages freshness: --stamps is necessary.\n\n${FRESHNESS_HELP}`);
-		return 2;
-	}
-	const path = isAbsolute(values.stamps) ? values.stamps : join(io.cwd, values.stamps);
-	let raw;
-	try {
-		raw = JSON.parse(readFileSync(path, "utf8"));
-	} catch (error) {
-		io.stderr(`site-pages freshness: the file ${values.stamps} cannot be read: ${error instanceof Error ? error.message : String(error)}\n`);
-		return 1;
-	}
-	const parsed = parseDataStamps(raw);
-	if (!parsed.ok) {
-		for (const fault of parsed.faults) io.stderr(`${fault}\n`);
-		return 1;
-	}
-	const engines = parsed.stamps.pages.flatMap((p) => [...p.runs, ...p.inFlight === void 0 ? [] : [p.inFlight]]).flatMap((r) => Object.keys(r.engines));
-	const npm = await npmPublishTimes({
-		packages: [...new Set(engines)],
-		...fetcher === void 0 ? {} : { fetch: fetcher }
-	});
-	const result = checkFreshness(parsed.stamps, {
-		now: values.now ?? (/* @__PURE__ */ new Date()).toISOString(),
-		times: npm.times
-	});
-	for (const problem of [...npm.problems, ...result.notRun]) io.stdout(`Not run: ${problem}\n`);
-	for (const fault of result.faults) io.stderr(`${fault}\n`);
-	if (result.faults.length > 0) return 1;
-	io.stdout(`The data stamps of ${parsed.stamps.pages.length} pages pass.\n`);
-	return 0;
-}
 // src/build.ts
 /**
 * The `site-pages build` command. It reads the sources. Then it writes the JSON data and the two
@@ -2704,6 +2302,6 @@ async function runCli(argv, io) {
 		throw error;
 	}
 }
-export { DEFAULT_CHANGELOGS as $, BASE_CSS as A, safeUrl as B, RELEASES_SCRIPT as C, oldestFirst as D, laneCenter as E, utcDay as F, linksOf as G, RoadmapParseError as H, escapeHtml as I, plainText as J, markdownTables as K, inlineMarkdown as L, dayRange as M, longDate as N, releaseSummary as O, shortDate as P, statusClassOf as Q, link as R, statusLead as S, renderReleasesPage as T, STATUS_CLASSES as U, OPEN_CLASSES as V, buildStatusBoard as W, roadmapItems as X, readStatusBoard as Y, splitRow as Z, classCounts as _, kindOf as _t, runCli as a, NPM_REGISTRY as at, sectionsOf as b, MAX_MINORS_BEHIND as c, GITHUB_GRAPHQL as ct, minorsBehind as d, githubReleases as dt, ReleaseDataError as et, parseDataStamps as f, firstSentence as ft, STATUS_SCRIPT as g, compareVersions as gt, probeScript as h, releaseBodyEntries as ht, parseBuildArgs as i, globFiles as it, pageShell as j, timelineLayout as k, checkFreshness as l, checkStateOf as lt, TYPESCRIPT_PROBE as m, parseChangelog as mt, UsageError as n, readChangelogs as nt, DATA_STAMP_SCHEMA as o, npmPublishTimes as ot, runFreshnessCli as p, headingAnchor as pt, parseRoadmap as q, build as r, readReleases as rt, MAX_DATA_AGE_DAYS as s, GITHUB_API as st, HELP as t, mergeReleases as tt, latestAt as u, githubOpenWork as ut, openGroups as v, parseVersion as vt, releasesLead as w, slugOf as x, renderStatusPage as y, versionOfTag as yt, listText as z };
+export { parseChangelog as $, STATUS_CLASSES as A, DEFAULT_CHANGELOGS as B, pageShell as C, utcDay as D, shortDate as E, plainText as F, globFiles as G, mergeReleases as H, readStatusBoard as I, checkStateOf as J, GITHUB_API as K, roadmapItems as L, linksOf as M, markdownTables as N, OPEN_CLASSES as O, parseRoadmap as P, headingAnchor as Q, splitRow as R, BASE_CSS as S, longDate as T, readChangelogs as U, ReleaseDataError as V, readReleases as W, githubReleases as X, githubOpenWork as Y, firstSentence as Z, renderReleasesPage as _, runCli as a, releaseSummary as b, STATUS_SCRIPT as c, renderStatusPage as d, releaseBodyEntries as et, sectionsOf as f, releasesLead as g, RELEASES_SCRIPT as h, parseBuildArgs as i, buildStatusBoard as j, RoadmapParseError as k, classCounts as l, statusLead as m, UsageError as n, TYPESCRIPT_PROBE as o, slugOf as p, GITHUB_GRAPHQL as q, build as r, probeScript as s, HELP as t, openGroups as u, laneCenter as v, dayRange as w, timelineLayout as x, oldestFirst as y, statusClassOf as z };
 
 //# sourceMappingURL=build.js.map