@jdevalk/astro-seo-graph 1.4.1 → 2.1.0

package/dist/indexnow-manifest.js

@@ -0,0 +1,96 @@
+import { createHash } from 'node:crypto';
+/** Identifier for the default hash, recorded in the serialized manifest. */
+export const DEFAULT_HASH_ALGORITHM = 'sha256-16';
+/** Current serialized-manifest format version. */
+export const MANIFEST_VERSION = 1;
+/** SHA-256 of `content` as hex, truncated to 16 chars (64 bits of collision space). */
+export function hashContent(content) {
+    return createHash('sha256').update(content, 'utf8').digest('hex').slice(0, 16);
+}
+/**
+ * Build a `{ url: hash }` manifest from the eligible page entries.
+ *
+ * Pass a custom `hash` to normalize volatile markup (per-build nonces,
+ * timestamps, build ids) before hashing, so unchanged content doesn't read as
+ * "updated". The default hashes the raw content.
+ */
+export function buildUrlManifest(entries, hash = (content) => hashContent(content)) {
+    const manifest = {};
+    for (const entry of entries) {
+        manifest[entry.url] = hash(entry.content, entry.url);
+    }
+    return manifest;
+}
+/**
+ * Diff a previous manifest against the current one. Result arrays are sorted
+ * for stable logs and deterministic output.
+ */
+export function diffManifests(prev, curr) {
+    const added = [];
+    const updated = [];
+    const deleted = [];
+    for (const url of Object.keys(curr)) {
+        if (!(url in prev))
+            added.push(url);
+        else if (prev[url] !== curr[url])
+            updated.push(url);
+    }
+    for (const url of Object.keys(prev)) {
+        if (!(url in curr))
+            deleted.push(url);
+    }
+    added.sort();
+    updated.sort();
+    deleted.sort();
+    return { added, updated, deleted };
+}
+/**
+ * Flatten a diff into the URL set to submit to IndexNow: added + updated +
+ * deleted. IndexNow accepts removed URLs (the engine recrawls and drops the
+ * 404/410), so deletions are included.
+ */
+export function changedUrls(diff) {
+    return [...diff.added, ...diff.updated, ...diff.deleted];
+}
+/**
+ * Serialize a manifest to stable JSON with sorted keys (so the published file
+ * diffs cleanly between deploys).
+ */
+export function serializeManifest(urls, algorithm = DEFAULT_HASH_ALGORITHM) {
+    const sorted = {};
+    for (const url of Object.keys(urls).sort()) {
+        const hash = urls[url];
+        if (hash !== undefined)
+            sorted[url] = hash;
+    }
+    const payload = { version: MANIFEST_VERSION, algorithm, urls: sorted };
+    return JSON.stringify(payload, null, 2);
+}
+/**
+ * Parse a previously published manifest. Returns the `{ url: hash }` map, or
+ * `null` when the input is missing or not a recognizable manifest — the caller
+ * decides whether that means "first run" or "fetch failed, skip submission".
+ */
+export function parseManifest(text) {
+    if (!text)
+        return null;
+    let data;
+    try {
+        data = JSON.parse(text);
+    }
+    catch {
+        return null;
+    }
+    if (typeof data !== 'object' || data === null)
+        return null;
+    const urls = data.urls;
+    if (typeof urls !== 'object' || urls === null)
+        return null;
+    const out = {};
+    for (const [url, hash] of Object.entries(urls)) {
+        if (typeof hash === 'string')
+            out[url] = hash;
+    }
+    return out;
+}
+//# sourceMappingURL=indexnow-manifest.js.map

package/dist/indexnow-manifest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"indexnow-manifest.js","sourceRoot":"","sources":["../src/indexnow-manifest.ts"],"names":[],"mappings":"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","sourcesContent":["import { createHash } from 'node:crypto';\n\n/**\n * Incremental-IndexNow manifest helpers.\n *\n * The integration submits the whole site to IndexNow on every build, which\n * the IndexNow spec discourages (submit only added/updated/deleted URLs) and\n * which can trip per-host rate limits. These pure helpers let a caller compute\n * a content-hash manifest of the built pages, diff it against the previously\n * published manifest, and submit only the URLs that actually changed.\n *\n * The helpers are runtime-agnostic and IO-free: the caller decides how to\n * read the built pages, where to fetch the previous manifest from, and where\n * to publish the new one. The integration wires them to the Astro build\n * output and the live site (see `seoGraph({ indexNow: { incremental } })`).\n */\n\n/** Mapping of each eligible page URL to a short content hash. */\nexport type UrlManifest = Record<string, string>;\n\n/** A single page's URL plus the content to hash (typically built HTML). */\nexport interface ManifestEntry {\n    url: string;\n    content: string;\n}\n\n/** Identifier for the default hash, recorded in the serialized manifest. */\nexport const DEFAULT_HASH_ALGORITHM = 'sha256-16';\n\n/** Current serialized-manifest format version. */\nexport const MANIFEST_VERSION = 1;\n\n/** The on-disk / over-the-wire manifest shape. */\nexport interface SerializedManifest {\n    version: number;\n    algorithm: string;\n    urls: UrlManifest;\n}\n\n/** SHA-256 of `content` as hex, truncated to 16 chars (64 bits of collision space). */\nexport function hashContent(content: string): string {\n    return createHash('sha256').update(content, 'utf8').digest('hex').slice(0, 16);\n}\n\n/**\n * Build a `{ url: hash }` manifest from the eligible page entries.\n *\n * Pass a custom `hash` to normalize volatile markup (per-build nonces,\n * timestamps, build ids) before hashing, so unchanged content doesn't read as\n * \"updated\". The default hashes the raw content.\n */\nexport function buildUrlManifest(\n    entries: readonly ManifestEntry[],\n    hash: (content: string, url: string) => string = (content) => hashContent(content),\n): UrlManifest {\n    const manifest: UrlManifest = {};\n    for (const entry of entries) {\n        manifest[entry.url] = hash(entry.content, entry.url);\n    }\n    return manifest;\n}\n\n/** The three change sets produced by comparing two manifests. */\nexport interface ManifestDiff {\n    /** URLs present now but not in the previous manifest. */\n    added: string[];\n    /** URLs present in both, with a different hash. */\n    updated: string[];\n    /** URLs present previously but gone now. */\n    deleted: string[];\n}\n\n/**\n * Diff a previous manifest against the current one. Result arrays are sorted\n * for stable logs and deterministic output.\n */\nexport function diffManifests(prev: UrlManifest, curr: UrlManifest): ManifestDiff {\n    const added: string[] = [];\n    const updated: string[] = [];\n    const deleted: string[] = [];\n\n    for (const url of Object.keys(curr)) {\n        if (!(url in prev)) added.push(url);\n        else if (prev[url] !== curr[url]) updated.push(url);\n    }\n    for (const url of Object.keys(prev)) {\n        if (!(url in curr)) deleted.push(url);\n    }\n\n    added.sort();\n    updated.sort();\n    deleted.sort();\n    return { added, updated, deleted };\n}\n\n/**\n * Flatten a diff into the URL set to submit to IndexNow: added + updated +\n * deleted. IndexNow accepts removed URLs (the engine recrawls and drops the\n * 404/410), so deletions are included.\n */\nexport function changedUrls(diff: ManifestDiff): string[] {\n    return [...diff.added, ...diff.updated, ...diff.deleted];\n}\n\n/**\n * Serialize a manifest to stable JSON with sorted keys (so the published file\n * diffs cleanly between deploys).\n */\nexport function serializeManifest(\n    urls: UrlManifest,\n    algorithm: string = DEFAULT_HASH_ALGORITHM,\n): string {\n    const sorted: UrlManifest = {};\n    for (const url of Object.keys(urls).sort()) {\n        const hash = urls[url];\n        if (hash !== undefined) sorted[url] = hash;\n    }\n    const payload: SerializedManifest = { version: MANIFEST_VERSION, algorithm, urls: sorted };\n    return JSON.stringify(payload, null, 2);\n}\n\n/**\n * Parse a previously published manifest. Returns the `{ url: hash }` map, or\n * `null` when the input is missing or not a recognizable manifest — the caller\n * decides whether that means \"first run\" or \"fetch failed, skip submission\".\n */\nexport function parseManifest(text: string | null | undefined): UrlManifest | null {\n    if (!text) return null;\n    let data: unknown;\n    try {\n        data = JSON.parse(text);\n    } catch {\n        return null;\n    }\n    if (typeof data !== 'object' || data === null) return null;\n    const urls = (data as Partial<SerializedManifest>).urls;\n    if (typeof urls !== 'object' || urls === null) return null;\n    const out: UrlManifest = {};\n    for (const [url, hash] of Object.entries(urls)) {\n        if (typeof hash === 'string') out[url] = hash;\n    }\n    return out;\n}\n"]}

package/dist/indexnow.js.map

@@ -1 +1 @@
-{"version":3,"file":"indexnow.js","sourceRoot":"","sources":["../src/indexnow.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,yBAAyB,EAAE,MAAM,yBAAyB,CAAC;AASpE;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,sBAAsB,CAAC,OAAgC;IACnE,MAAM,IAAI,GAAG,yBAAyB,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IACpD,MAAM,YAAY,GACd,OAAO,CAAC,YAAY,KAAK,SAAS,CAAC,CAAC,CAAC,uBAAuB,CAAC,CAAC,CAAC,OAAO,CAAC,YAAY,CAAC;IAExF,OAAO,KAAK,IAAI,EAAE;QACd,MAAM,OAAO,GAA2B;YACpC,cAAc,EAAE,2BAA2B;SAC9C,CAAC;QACF,IAAI,YAAY,KAAK,IAAI;YAAE,OAAO,CAAC,eAAe,CAAC,GAAG,YAAY,CAAC;QACnE,OAAO,IAAI,QAAQ,CAAC,IAAI,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC;IAC3C,CAAC,CAAC;AACN,CAAC;AAED,OAAO,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC"}
+{"version":3,"file":"indexnow.js","sourceRoot":"","sources":["../src/indexnow.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,yBAAyB,EAAE,MAAM,yBAAyB,CAAC;AASpE;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,sBAAsB,CAAC,OAAgC;IACnE,MAAM,IAAI,GAAG,yBAAyB,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IACpD,MAAM,YAAY,GACd,OAAO,CAAC,YAAY,KAAK,SAAS,CAAC,CAAC,CAAC,uBAAuB,CAAC,CAAC,CAAC,OAAO,CAAC,YAAY,CAAC;IAExF,OAAO,KAAK,IAAI,EAAE;QACd,MAAM,OAAO,GAA2B;YACpC,cAAc,EAAE,2BAA2B;SAC9C,CAAC;QACF,IAAI,YAAY,KAAK,IAAI;YAAE,OAAO,CAAC,eAAe,CAAC,GAAG,YAAY,CAAC;QACnE,OAAO,IAAI,QAAQ,CAAC,IAAI,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC;IAC3C,CAAC,CAAC;AACN,CAAC;AAED,OAAO,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC","sourcesContent":["import type { APIRoute } from 'astro';\nimport { getIndexNowKeyFileContent } from '@jdevalk/seo-graph-core';\n\nexport interface IndexNowKeyRouteOptions {\n    /** IndexNow key (8–128 characters from `[A-Za-z0-9-]`). */\n    key: string;\n    /** Defaults to `public, max-age=86400`. Pass `null` to omit. */\n    cacheControl?: string | null;\n}\n\n/**\n * Returns an Astro `APIRoute` that serves the IndexNow key verification\n * file. Place this at `src/pages/[key].txt.ts` or `src/pages/<key>.txt.ts`\n * so it resolves to `/<key>.txt` on the deployed site.\n *\n * @example\n * ```ts\n * // src/pages/your-key-here.txt.ts\n * import { createIndexNowKeyRoute } from '@jdevalk/astro-seo-graph';\n *\n * export const GET = createIndexNowKeyRoute({ key: 'your-key-here' });\n * ```\n */\nexport function createIndexNowKeyRoute(options: IndexNowKeyRouteOptions): APIRoute {\n    const body = getIndexNowKeyFileContent(options.key);\n    const cacheControl =\n        options.cacheControl === undefined ? 'public, max-age=86400' : options.cacheControl;\n\n    return async () => {\n        const headers: Record<string, string> = {\n            'Content-Type': 'text/plain; charset=utf-8',\n        };\n        if (cacheControl !== null) headers['Cache-Control'] = cacheControl;\n        return new Response(body, { headers });\n    };\n}\n\nexport { submitToIndexNow, validateIndexNowKey } from '@jdevalk/seo-graph-core';\nexport type { IndexNowSubmitResult } from '@jdevalk/seo-graph-core';\n"]}

package/dist/integration.d.ts

@@ -62,6 +62,54 @@ export interface IndexNowIntegrationOptions {
      * ```
      */
     filter?: (url: string) => boolean;
+    /**
+     * Submit only URLs that changed since the last build, instead of the
+     * whole site every time (the IndexNow spec asks for added/updated/
+     * deleted URLs only, and full resubmits can trip per-host rate limits).
+     *
+     * Enabled with `true` (defaults) or an options object. On each build the
+     * integration hashes every eligible page into a manifest, fetches the
+     * previously published manifest from the live site, diffs them, and
+     * submits only the difference — then writes the new manifest into the
+     * build output so it ships with this deploy and becomes the next baseline.
+     *
+     * The previous state lives on the live site (not local disk or a
+     * key/value store), so this works the same whether you build locally or
+     * in CI, and adds no infrastructure. Default is off (full submit).
+     */
+    incremental?: boolean | IndexNowIncrementalOptions;
+}
+/**
+ * Options for incremental IndexNow submission (`indexNow.incremental`).
+ */
+export interface IndexNowIncrementalOptions {
+    /**
+     * Build-output path the manifest is written to, and the URL path it is
+     * served from. Defaults to `indexnow-manifest.json` at the site root.
+     */
+    manifestPath?: string;
+    /**
+     * Absolute URL to fetch the previous manifest from. Defaults to
+     * `<siteUrl>/<manifestPath>`. Override if the manifest is served from a
+     * different host or path than where it's written.
+     */
+    manifestUrl?: string;
+    /**
+     * Normalize a page's HTML before hashing, to strip per-build volatile
+     * markup (CSP nonces, timestamps, build ids) that would otherwise make
+     * unchanged pages look modified. Receives the raw HTML and the page URL.
+     */
+    normalize?: (html: string, url: string) => string;
+    /**
+     * What to do when the previous manifest can't be fetched or parsed for a
+     * reason other than a clean 404 (network error, 5xx, malformed body). A
+     * 404 is always treated as "first run" (submit everything once).
+     *
+     * - `'skip'` (default): submit nothing this build, so a transient fetch
+     *   failure can't trigger an accidental full resubmit.
+     * - `'full'`: fall back to submitting every eligible URL.
+     */
+    onError?: 'skip' | 'full';
 }
 /**
  * Pathnames that `indexNow` excludes by default, regardless of any
@@ -74,6 +122,40 @@ export interface IndexNowIntegrationOptions {
  * when the build emits `404/index.html`).
  */
 export declare function isDefaultExcludedFromIndexNow(url: string): boolean;
+/**
+ * Return `options` only when `branch` matches `productionBranch` (default
+ * `"main"`), otherwise return `undefined` so that `seoGraph()` skips
+ * IndexNow submission entirely.
+ *
+ * This is useful on CI/CD platforms that expose the current branch as an
+ * environment variable (e.g. `CF_PAGES_BRANCH`, `VERCEL_GIT_COMMIT_REF`,
+ * `BRANCH`) so that preview deployments never submit URLs to IndexNow.
+ *
+ * @example
+ * ```js
+ * // astro.config.mjs
+ * import { seoGraph, indexNowOnBranch } from '@jdevalk/astro-seo-graph/integration';
+ *
+ * export default defineConfig({
+ *     integrations: [
+ *         seoGraph({
+ *             indexNow: indexNowOnBranch(process.env.CF_PAGES_BRANCH ?? '', {
+ *                 key: 'your-key-here',
+ *                 host: 'example.com',
+ *                 siteUrl: 'https://example.com',
+ *             }),
+ *         }),
+ *     ],
+ * });
+ * ```
+ */
+export declare function indexNowOnBranch(
+/** Current branch name, e.g. process.env.WORKERS_CI_BRANCH or process.env.VERCEL_GIT_COMMIT_REF or process.env.BRANCH, etc. */
+branch: string, 
+/** Options for IndexNow submission. */
+options: IndexNowIntegrationOptions, 
+/** Branch name that triggers production submission, defaults to `"main"` */
+productionBranch?: string): IndexNowIntegrationOptions | undefined;
 export interface LlmsTxtIntegrationOptions {
     /** H1 of the generated `llms.txt`. */
     title: string;
@@ -353,7 +435,10 @@ export declare function classifyInternalLink(href: string, builtPaths: ReadonlyS
  * Two WCAG-sanctioned ways to mark an image as decorative are respected
  * and NOT flagged:
  *
- *   - `alt=""` — the canonical decorative-image pattern.
+ *   - `alt=""` — the canonical decorative-image pattern. Also recognized
+ *     in HTML5 boolean-attribute form `<img ... alt>` (no `=`), which is
+ *     spec-equivalent to `alt=""` and is what Vite's HTML minifier (used
+ *     by Astro) emits when given `alt=""`.
  *   - `role="presentation"` (or `role="none"`) — removes the image from
  *     the accessibility tree; typically paired with `alt=""` but some
  *     codebases use it alone.

package/dist/integration.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"integration.d.ts","sourceRoot":"","sources":["../src/integration.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"integration.d.ts","sourceRoot":"","sources":["../src/integration.ts"],"names":[],"mappings":"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"}

package/dist/integration.js

@@ -3,6 +3,7 @@ import { join, relative } from 'node:path';
 import { fileURLToPath } from 'node:url';
 import { submitToIndexNow } from '@jdevalk/seo-graph-core';
 import { renderLlmsTxt } from './llms-txt.js';
+import { buildUrlManifest, changedUrls, diffManifests, hashContent, parseManifest, serializeManifest, } from './indexnow-manifest.js';
 /**
  * Pathnames that `indexNow` excludes by default, regardless of any
  * caller-supplied `filter`. The 404 page is the only universal case —
@@ -23,6 +24,42 @@ export function isDefaultExcludedFromIndexNow(url) {
     }
     return pathname === '/404' || pathname === '/404/';
 }
+/**
+ * Return `options` only when `branch` matches `productionBranch` (default
+ * `"main"`), otherwise return `undefined` so that `seoGraph()` skips
+ * IndexNow submission entirely.
+ *
+ * This is useful on CI/CD platforms that expose the current branch as an
+ * environment variable (e.g. `CF_PAGES_BRANCH`, `VERCEL_GIT_COMMIT_REF`,
+ * `BRANCH`) so that preview deployments never submit URLs to IndexNow.
+ *
+ * @example
+ * ```js
+ * // astro.config.mjs
+ * import { seoGraph, indexNowOnBranch } from '@jdevalk/astro-seo-graph/integration';
+ *
+ * export default defineConfig({
+ *     integrations: [
+ *         seoGraph({
+ *             indexNow: indexNowOnBranch(process.env.CF_PAGES_BRANCH ?? '', {
+ *                 key: 'your-key-here',
+ *                 host: 'example.com',
+ *                 siteUrl: 'https://example.com',
+ *             }),
+ *         }),
+ *     ],
+ * });
+ * ```
+ */
+export function indexNowOnBranch(
+/** Current branch name, e.g. process.env.WORKERS_CI_BRANCH or process.env.VERCEL_GIT_COMMIT_REF or process.env.BRANCH, etc. */
+branch, 
+/** Options for IndexNow submission. */
+options, 
+/** Branch name that triggers production submission, defaults to `"main"` */
+productionBranch = 'main') {
+    return branch === productionBranch ? options : undefined;
+}
 /** Defaults applied when `validateMetadataLength: true`. */
 export const DEFAULT_METADATA_LENGTH_BOUNDS = {
     title: { min: 30, max: 65 },
@@ -258,7 +295,10 @@ export function classifyInternalLink(href, builtPaths, origin) {
  * Two WCAG-sanctioned ways to mark an image as decorative are respected
  * and NOT flagged:
  *
- *   - `alt=""` — the canonical decorative-image pattern.
+ *   - `alt=""` — the canonical decorative-image pattern. Also recognized
+ *     in HTML5 boolean-attribute form `<img ... alt>` (no `=`), which is
+ *     spec-equivalent to `alt=""` and is what Vite's HTML minifier (used
+ *     by Astro) emits when given `alt=""`.
  *   - `role="presentation"` (or `role="none"`) — removes the image from
  *     the accessibility tree; typically paired with `alt=""` but some
  *     codebases use it alone.
@@ -270,7 +310,11 @@ export function findImagesWithoutAlt(html) {
     const results = [];
     for (const match of html.matchAll(/<img\b[^>]*>/gi)) {
         const tag = match[0];
-        if (/\balt\s*=/i.test(tag))
+        // Match `alt` whether written as `alt="..."`, bare-boolean `alt`,
+        // or self-closed `alt/`. Leading `\s` anchors `alt` to an
+        // attribute slot inside the tag, avoiding false matches on
+        // attribute names like `data-alt` or `data-altitude`.
+        if (/\salt(?:\s*=|\s|\/?>|$)/i.test(tag))
             continue;
         if (/\brole\s*=\s*["'](?:presentation|none)["']/i.test(tag))
             continue;
@@ -729,14 +773,15 @@ export default function seoGraph(options = {}) {
                     }
                 }
                 if (indexNow) {
-                    const urls = htmlFiles
-                        .map((f) => htmlFileToUrl(f, indexNow.siteUrl))
-                        .filter((u) => !isDefaultExcludedFromIndexNow(u))
-                        .filter((u) => (indexNow.filter ? indexNow.filter(u) : true));
-                    if (urls.length === 0) {
-                        logger.info('IndexNow: no URLs to submit.');
-                    }
-                    else {
+                    const eligible = htmlFiles
+                        .map((f) => ({ file: f, url: htmlFileToUrl(f, indexNow.siteUrl) }))
+                        .filter((e) => !isDefaultExcludedFromIndexNow(e.url))
+                        .filter((e) => (indexNow.filter ? indexNow.filter(e.url) : true));
+                    const submit = async (urls) => {
+                        if (urls.length === 0) {
+                            logger.info('IndexNow: no URLs to submit.');
+                            return;
+                        }
                         const results = await submitToIndexNow({
                             host: indexNow.host,
                             key: indexNow.key,
@@ -752,6 +797,60 @@ export default function seoGraph(options = {}) {
                                 logger.warn(`IndexNow: submission failed (status ${r.status}): ${r.message}`);
                             }
                         }
+                    };
+                    if (!indexNow.incremental) {
+                        await submit(eligible.map((e) => e.url));
+                    }
+                    else {
+                        const opts = indexNow.incremental === true ? {} : indexNow.incremental;
+                        const manifestRelPath = (opts.manifestPath ?? 'indexnow-manifest.json').replace(/^\//, '');
+                        const siteBase = indexNow.siteUrl.replace(/\/$/, '');
+                        const manifestUrl = opts.manifestUrl ?? `${siteBase}/${manifestRelPath}`;
+                        const onError = opts.onError ?? 'skip';
+                        const normalize = opts.normalize;
+                        // Current manifest: hash every eligible page's built HTML.
+                        const entries = [];
+                        for (const e of eligible) {
+                            const html = await readFile(join(buildDir, e.file), 'utf8');
+                            entries.push({ url: e.url, content: html });
+                        }
+                        const current = buildUrlManifest(entries, normalize
+                            ? (content, url) => hashContent(normalize(content, url))
+                            : undefined);
+                        // Previous state lives on the live site. A clean 404 means
+                        // "first run" (baseline). Any other failure leaves `previous`
+                        // null so we never accidentally full-resubmit on a transient
+                        // network blip.
+                        let previous = null;
+                        try {
+                            const res = await fetch(manifestUrl);
+                            if (res.status === 404) {
+                                previous = {};
+                            }
+                            else if (res.ok) {
+                                previous = parseManifest(await res.text());
+                            }
+                        }
+                        catch {
+                            previous = null;
+                        }
+                        // Always publish the new manifest so it ships with this
+                        // deploy and becomes the next build's baseline.
+                        await writeFile(join(buildDir, manifestRelPath), serializeManifest(current), 'utf8');
+                        if (previous === null) {
+                            if (onError === 'full') {
+                                logger.warn(`IndexNow: could not read previous manifest at ${manifestUrl}; submitting all URLs.`);
+                                await submit(Object.keys(current));
+                            }
+                            else {
+                                logger.warn(`IndexNow: could not read previous manifest at ${manifestUrl}; skipping submission this build.`);
+                            }
+                        }
+                        else {
+                            const diff = diffManifests(previous, current);
+                            logger.info(`IndexNow: ${diff.added.length} added, ${diff.updated.length} updated, ${diff.deleted.length} deleted.`);
+                            await submit(changedUrls(diff));
+                        }
                     }
                 }
                 if (llmsTxt) {