aeoptimize 0.6.2 → 0.7.0

package/dist/core/static-audit.d.ts

@@ -0,0 +1,30 @@
+export type StaticAuditStatus = 'PASS' | 'WARNING' | 'FAIL' | 'N/A';
+export interface StaticAuditOptions {
+    expectIndexable?: boolean;
+    /** Absolute deployed page URL, or deployment root when auditing a directory. */
+    baseUrl?: string;
+}
+export interface StaticAuditCheck {
+    id: string;
+    status: StaticAuditStatus;
+    evidence: string[];
+    message: string;
+    remediation: string | null;
+    validation: string;
+}
+export interface StaticPageAudit {
+    target: string;
+    checks: StaticAuditCheck[];
+}
+export interface StaticAuditReport {
+    contractVersion: '1.0';
+    source: 'local-html';
+    pages: StaticPageAudit[];
+    summary: Record<StaticAuditStatus, number>;
+    limitations: string[];
+    timestamp: string;
+}
+/** Audits observed source HTML only; it neither fetches URLs nor changes the readiness score. */
+export declare function auditHtml(html: string, target: string, options?: StaticAuditOptions): StaticPageAudit;
+/** Recursively audits local HTML files. Read/parse failures stop the run rather than silently omitting pages. */
+export declare function auditPath(input: string, options?: StaticAuditOptions): Promise<StaticAuditReport>;

package/dist/core/static-audit.js

@@ -0,0 +1,202 @@
+import * as cheerio from 'cheerio';
+import { lstat, readFile, readdir } from 'node:fs/promises';
+import { extname, join, relative, resolve, sep } from 'node:path';
+function httpUrl(value, base) {
+    if (/[\u0000-\u0020\u007f]/.test(value))
+        throw new Error('URL contains whitespace or control characters');
+    const url = new URL(value, base);
+    if (!['http:', 'https:'].includes(url.protocol) || url.username || url.password) {
+        throw new Error('Expected an HTTP(S) URL without credentials');
+    }
+    return url;
+}
+/** Audits observed source HTML only; it neither fetches URLs nor changes the readiness score. */
+export function auditHtml(html, target, options = {}) {
+    const $ = cheerio.load(html);
+    const checks = [];
+    const add = (id, status, evidence, message, remediation, validation) => {
+        checks.push({ id, status, evidence, message, remediation, validation });
+    };
+    const pageUrl = options.baseUrl ? httpUrl(options.baseUrl).href : undefined;
+    const titles = $('title').map((_, el) => $(el).text().trim()).get();
+    const titleOk = titles.length === 1 && titles[0].length > 0;
+    add('document-title', titleOk ? 'PASS' : 'WARNING', titles, titleOk ? 'One non-empty title element found.' : 'Expected one non-empty title element.', titleOk ? null : 'Write one descriptive title in the document head; remove duplicate title elements.', 'Rebuild and inspect the title element in the generated HTML.');
+    const descriptions = $('meta').filter((_, el) => ($(el).attr('name') || '').trim().toLowerCase() === 'description')
+        .map((_, el) => $(el).attr('content')?.trim() || '').get();
+    const descriptionOk = descriptions.length === 1 && descriptions[0].length > 0;
+    add('meta-description', descriptionOk ? 'PASS' : 'WARNING', descriptions, descriptionOk ? 'One non-empty meta description found.' : 'Expected one non-empty meta description.', descriptionOk ? null : 'Write a page-specific description and remove duplicate description tags.', 'Inspect the rebuilt meta description; search engines may select a different snippet.');
+    const canonicals = $('link').filter((_, el) => ($(el).attr('rel') || '').toLowerCase().split(/\s+/).includes('canonical'))
+        .map((_, el) => $(el).attr('href')?.trim() || '').get();
+    const canonicalValidation = 'Rebuild and check the canonical URL, then verify its HTTP response and indexability on the deployed site.';
+    if (canonicals.length === 0) {
+        add('canonical', 'WARNING', [], 'No HTML canonical declaration found; HTTP canonical headers were not checked.', 'Review the intended canonical URL and declare it in HTML or the HTTP Link header where appropriate.', canonicalValidation);
+    }
+    else if (canonicals.length > 1 || !canonicals[0]) {
+        add('canonical', 'FAIL', canonicals, 'Canonical declarations are multiple or empty.', 'Emit one non-empty canonical declaration for the intended page.', canonicalValidation);
+    }
+    else {
+        const href = canonicals[0];
+        let base = pageUrl;
+        const htmlBase = $('base[href]').first().attr('href');
+        try {
+            const isAbsolute = /^[a-z][a-z\d+.-]*:/i.test(href);
+            if (htmlBase !== undefined && !isAbsolute) {
+                const baseValue = htmlBase.trim();
+                if (!pageUrl && !/^[a-z][a-z\d+.-]*:/i.test(baseValue)) {
+                    httpUrl(baseValue, 'https://audit.invalid/');
+                }
+                else {
+                    base = httpUrl(baseValue, pageUrl).href;
+                }
+            }
+            if (!isAbsolute && !base) {
+                // Validate the reference shape without inventing the deployed origin.
+                httpUrl(href, 'https://audit.invalid/');
+                add('canonical', 'N/A', [href], 'A relative canonical needs the deployed page URL for resolution.', 'Supply --base-url or emit an absolute canonical URL.', canonicalValidation);
+            }
+            else {
+                const url = httpUrl(href, base);
+                const hadFragment = Boolean(url.hash);
+                url.hash = '';
+                add('canonical', hadFragment ? 'WARNING' : 'PASS', [url.href], hadFragment ? 'Canonical contains a fragment.' : 'One HTTP(S) canonical URL resolves; its destination was not fetched.', hadFragment ? 'Use a canonical URL without a fragment.' : null, canonicalValidation);
+            }
+        }
+        catch {
+            add('canonical', 'FAIL', canonicals, 'Canonical URL or HTML base cannot resolve to an HTTP(S) URL without credentials.', 'Correct the canonical href and any HTML base href.', canonicalValidation);
+        }
+    }
+    const robotTags = $('meta').filter((_, el) => ['robots', 'googlebot'].includes(($(el).attr('name') || '').trim().toLowerCase()));
+    const robotEvidence = [];
+    let blocksIndexing = false;
+    robotTags.each((_, el) => {
+        const name = ($(el).attr('name') || '').trim().toLowerCase();
+        const content = $(el).attr('content') || '';
+        robotEvidence.push(`${name}: ${content}`);
+        // Keep parameter values attached to their directive, e.g. max-image-preview: none.
+        const tokens = content.toLowerCase().replace(/:\s+/g, ':').split(/[\s,]+/);
+        if (tokens.includes('noindex') || tokens.includes('none'))
+            blocksIndexing = true;
+    });
+    add('indexing-directives', blocksIndexing ? (options.expectIndexable ? 'FAIL' : 'WARNING') : 'PASS', robotEvidence, blocksIndexing
+        ? 'An HTML robots or googlebot directive blocks standalone indexing; index does not override noindex.'
+        : 'No noindex or none token found in HTML robots/googlebot meta tags. HTTP headers and actual indexing remain unverified.', blocksIndexing ? 'Confirm the page policy. Remove noindex/none only if this page should be indexed.' : null, 'Inspect every robots/googlebot tag after rebuilding, then check deployed headers and Search Console URL Inspection.');
+    const blocks = $('script').filter((_, el) => ($(el).attr('type') || '').trim().toLowerCase() === 'application/ld+json');
+    const jsonEvidence = [];
+    let invalidJson = false;
+    const isObject = (value) => value !== null && typeof value === 'object' && !Array.isArray(value);
+    blocks.each((index, el) => {
+        try {
+            const value = JSON.parse($(el).html() || '');
+            if (!(isObject(value) || (Array.isArray(value) && value.every(isObject)))) {
+                invalidJson = true;
+                jsonEvidence.push(`Block ${index + 1}: expected an object or an array of objects.`);
+            }
+            else {
+                jsonEvidence.push(`Block ${index + 1}: JSON parses with an object or object-array root.`);
+            }
+        }
+        catch {
+            invalidJson = true;
+            jsonEvidence.push(`Block ${index + 1}: malformed JSON.`);
+        }
+    });
+    add('jsonld-syntax', blocks.length === 0 ? 'N/A' : invalidJson ? 'FAIL' : 'PASS', jsonEvidence, blocks.length === 0 ? 'No JSON-LD present; structured data is optional.'
+        : invalidJson ? 'JSON-LD has a syntax or root-shape error.'
+            : 'JSON syntax and root shape pass. Schema vocabulary, visible-content consistency and rich-result eligibility were not validated.', invalidJson ? 'Fix the reported blocks and validate the appropriate schema against visible page content.' : null, 'Re-run this audit, then use Schema Markup Validator and the applicable search-engine validation tool.');
+    add('http-indexing', 'N/A', [], 'Local HTML cannot establish HTTP status, X-Robots-Tag, robots.txt access, redirects, or actual search indexing.', 'Check the deployed response and crawler policy; use Search Console for Google indexing evidence.', 'Inspect the deployed HTTP response and Search Console URL Inspection.');
+    return { target, checks };
+}
+function markDuplicates(pages, sourceId, id, normalize) {
+    const groups = new Map();
+    for (const page of pages) {
+        const check = page.checks.find((item) => item.id === sourceId);
+        if (!check || (check.status !== 'PASS' && !(sourceId === 'canonical' && check.status === 'WARNING'))
+            || check.evidence.length !== 1)
+            continue;
+        const value = normalize(check.evidence[0]);
+        if (value)
+            groups.set(value, [...(groups.get(value) || []), page]);
+    }
+    for (const [value, matches] of groups) {
+        if (matches.length < 2)
+            continue;
+        for (const page of matches) {
+            page.checks.push({
+                id, status: 'WARNING', evidence: [value, ...matches.map((match) => match.target)],
+                message: sourceId === 'canonical'
+                    ? 'Multiple audited files point to the same canonical. This may be an intentional consolidation.'
+                    : 'Multiple audited files share a title. Review whether they serve distinct page purposes.',
+                remediation: 'Review the listed files and correct template reuse only where the duplication is unintended.',
+                validation: 'Rebuild and rerun the directory audit; confirm any intentional duplicates manually.',
+            });
+        }
+    }
+}
+/** Recursively audits local HTML files. Read/parse failures stop the run rather than silently omitting pages. */
+export async function auditPath(input, options = {}) {
+    if (options.baseUrl)
+        httpUrl(options.baseUrl);
+    const root = resolve(input);
+    const rootStat = await lstat(root);
+    if (rootStat.isSymbolicLink())
+        throw new Error('Symbolic link targets are not supported.');
+    const files = [];
+    async function collect(path) {
+        const info = await lstat(path);
+        if (info.isSymbolicLink())
+            return;
+        if (info.isDirectory()) {
+            const entries = await readdir(path);
+            for (const entry of entries.sort()) {
+                if (entry.startsWith('.') || entry === 'node_modules')
+                    continue;
+                await collect(join(path, entry));
+            }
+        }
+        else if (info.isFile() && ['.html', '.htm'].includes(extname(path).toLowerCase())) {
+            files.push(path);
+        }
+    }
+    if (!rootStat.isDirectory() && !['.html', '.htm'].includes(extname(root).toLowerCase())) {
+        throw new Error('Static audit supports .html and .htm files or directories containing HTML.');
+    }
+    await collect(root);
+    if (!files.length)
+        throw new Error('No HTML files found to audit.');
+    const pages = [];
+    for (const file of files.sort()) {
+        const info = await lstat(file);
+        if (info.isSymbolicLink() || !info.isFile())
+            throw new Error(`Input changed during audit: ${file}`);
+        if (info.size > 5 * 1024 * 1024)
+            throw new Error(`HTML file exceeds the 5 MB audit limit: ${file}`);
+        let baseUrl = options.baseUrl;
+        if (rootStat.isDirectory() && baseUrl) {
+            const rootUrl = httpUrl(baseUrl);
+            if (rootUrl.search || rootUrl.hash)
+                throw new Error('A directory --base-url must not contain a query or fragment.');
+            if (!rootUrl.pathname.endsWith('/'))
+                rootUrl.pathname += '/';
+            const deployedPath = relative(root, file).split(sep).map(encodeURIComponent).join('/');
+            baseUrl = new URL(deployedPath, rootUrl).href;
+        }
+        pages.push(auditHtml(await readFile(file, 'utf8'), file, { ...options, baseUrl }));
+    }
+    markDuplicates(pages, 'document-title', 'duplicate-document-title', (value) => value.replace(/\s+/g, ' ').trim().toLowerCase());
+    markDuplicates(pages, 'canonical', 'duplicate-canonical', (value) => value);
+    const summary = { PASS: 0, WARNING: 0, FAIL: 0, 'N/A': 0 };
+    for (const page of pages)
+        for (const check of page.checks)
+            summary[check.status]++;
+    return {
+        contractVersion: '1.0', source: 'local-html', pages, summary,
+        limitations: [
+            'Source HTML only. No browser rendering, network requests, HTTP headers, robots.txt, sitemap or search-performance data were inspected.',
+            'PASS applies to the named check only; it does not establish crawlability, indexing, ranking, AI citation or rich-result eligibility.',
+            'Cross-page findings cover only audited files. Symbolic links, hidden entries and node_modules are excluded.',
+            'Directory base URLs map relative file paths directly; hosting-specific clean-URL rewrites are not inferred.',
+        ],
+        timestamp: new Date().toISOString(),
+    };
+}
+//# sourceMappingURL=static-audit.js.map

package/dist/core/static-audit.js.map

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

package/dist/core/types.d.ts

@@ -35,6 +35,13 @@ export interface Link {
     text: string;
     rel?: string;
 }
+export interface ImageReference {
+    src: string;
+    alt?: string;
+    width?: string;
+    height?: string;
+    loading?: string;
+}
 export interface JsonLdObject {
     '@type'?: string;
     '@context'?: string;
@@ -43,16 +50,93 @@ export interface JsonLdObject {
 export interface ParsedDocument {
     url: string;
     title: string;
+    documentTitle?: string;
     html?: string;
     markdown?: string;
     frontmatter?: Record<string, unknown>;
     headings: Heading[];
     paragraphs: string[];
     jsonLd: JsonLdObject[];
+    jsonLdBlockCount?: number;
+    jsonLdErrors?: string[];
     metaTags: Record<string, string>;
+    metaTagValues?: Record<string, string[]>;
     links: Link[];
+    images?: ImageReference[];
+    language?: string;
+    canonicalLinks?: string[];
     rawText: string;
 }
+export type AuditStatus = 'PASS' | 'WARNING' | 'FAIL' | 'N/A';
+export type AuditEvidenceSource = 'http' | 'html' | 'markdown' | 'derived';
+export type AuditEvidenceValue = string | number | boolean | null | string[];
+export interface AuditEvidence {
+    source: AuditEvidenceSource;
+    observed: Record<string, AuditEvidenceValue>;
+}
+export interface AuditCheck {
+    id: string;
+    label: string;
+    status: AuditStatus;
+    evidence: AuditEvidence[];
+    explanation: string;
+    remediation: string | null;
+    validation: string;
+}
+export interface AuditReport {
+    contractVersion: '1.0';
+    target: {
+        type: 'url' | 'file';
+        input: string;
+        finalUrl?: string;
+    };
+    rendering: 'response-html' | 'browser' | 'local-html' | 'markdown';
+    checks: AuditCheck[];
+    summary: Record<AuditStatus, number>;
+    limitations: string[];
+    timestamp: string;
+}
+export interface SiteAuditPage {
+    requestedUrl: string;
+    finalUrl: string;
+    status: number;
+    statusText: string;
+    redirects: string[];
+    contentType: string | null;
+    title: string | null;
+    language: string | null;
+    canonicalLinks: string[];
+    internalLinkCount: number;
+    externalLinkCount: number;
+    discoveredFrom: string[];
+}
+export interface SiteAuditSitemap {
+    url: string;
+    status: number;
+    kind: 'urlset' | 'index' | 'unknown';
+    urlCount: number;
+}
+export interface SiteAuditReport {
+    contractVersion: '1.0';
+    startUrl: string;
+    origin: string;
+    maxPages: number;
+    crawledPages: number;
+    truncated: boolean;
+    robots: {
+        url: string;
+        status: number;
+        applicableRules: string[];
+        sitemapUrls: string[];
+        skippedUrls: string[];
+    };
+    sitemaps: SiteAuditSitemap[];
+    pages: SiteAuditPage[];
+    checks: AuditCheck[];
+    summary: Record<AuditStatus, number>;
+    limitations: string[];
+    timestamp: string;
+}
 export interface RuleResult {
     score: number;
     maxScore: number;

package/docs/methodology.md

@@ -66,6 +66,27 @@ A scoring-rule change must include:
 
 The v0.6 fixture corpus is published in [`fixtures/v0.6/rule-corpus.ts`](../fixtures/v0.6/rule-corpus.ts) and is enforced by the release-contract tests. Outcome research, if added later, will be reported separately from the readiness score.
 
+## Evidence-backed audit contract
+
+The `audit` command is separate from the v0.6 score contract. It reports one of four statuses for each bounded check:
+
+| Status | Meaning |
+| --- | --- |
+| `PASS` | The inspected evidence satisfies the check's documented condition. This is not an external-outcome guarantee. |
+| `WARNING` | A deterministic observation needs contextual review or may be intentional. |
+| `FAIL` | The inspected evidence confirms a structural or retrieval failure within the check's scope. |
+| `N/A` | The required evidence is unavailable or the check does not apply to this source type. |
+
+Each check includes observed evidence, an explanation, optional remediation, and a validation step. The contract does not derive robots.txt policy, sitemap membership, hreflang reciprocity, site-wide duplication, orphan status, Core Web Vitals, analytics, or search-engine index state from a single document.
+
+### Bounded site audit
+
+The `audit-site` contract uses a same-origin, sequential queue with an explicit 1–200 page limit. It processes links in discovery order before sitemap-only seeds, reads applicable `aeoptimize` or wildcard robots rules, and does not follow subsequent redirects outside the audited origin.
+
+The crawler uses response HTML without browser rendering. A Sitemap-only URL with no internal inlink is reported as an orphan candidate because JavaScript navigation, pages beyond the configured limit, and other discovery sources may still link to it. Broken-link findings require an observed failed response; queued but unfetched links remain warnings.
+
+robots.txt matching covers applicable user-agent groups, `Allow`, `Disallow`, `*` wildcards, and `$` endings. Unusual policies need manual review. An unavailable robots.txt response that is not an ordinary 404 causes conservative skipping of subsequent matching URLs.
+
 ## Primary sources
 
 - [Google Search: AI features and your website](https://developers.google.com/search/docs/appearance/ai-features)

package/docs/release-v0.7.md

@@ -0,0 +1,42 @@
+# v0.7 release and rollback guide
+
+Version 0.7.0 adds three evidence-backed audit workflows while retaining the v0.6.0 scoring methodology and existing `scan --json` contract.
+
+- `audit` inspects one URL or a local HTML/Markdown file.
+- `audit-build` checks built HTML with cross-page review and optional CI failure gates.
+- `audit-site` performs a bounded, same-origin crawl and compares discovered links, canonical declarations and sitemap entries.
+
+Audit statuses describe the evidence collected. Unavailable evidence remains unassessed. Actual search indexing, rankings, traffic and AI citation outcomes are outside these contracts.
+
+## Release acceptance
+
+1. Build from a clean release commit after `npm ci` and run `npm run release:check`.
+2. Require passing Node.js 22 and 24 CI, package reproducibility, and Action contract checks on the exact merged `main` commit.
+3. Preserve the candidate manifest and SHA-256. Confirm all three CLI aliases and audit commands work from that exact packed artifact in a clean consumer.
+4. Verify the npm account immediately before publication, fetch `origin/main`, and require the publish source gate to confirm the exact commit.
+5. Publish npm 0.7.0, then create the immutable `v0.7.0` tag and GitHub Release at that same commit. These external steps require maintainer authorization.
+
+`prepublishOnly` runs the candidate and source gates. The source gate requires `HEAD` to equal the freshly fetched `origin/main` commit. Do not bypass it or publish a pre-merge feature commit.
+
+## Publication readback
+
+Verify npm metadata and the exact version, download its tarball, compare its SHA-256 with the candidate, and install all CLI aliases from those verified bytes. Confirm the immutable tag and published GitHub Release independently.
+
+```bash
+npm view aeoptimize version dist-tags --json
+npm view aeoptimize@0.7.0 version gitHead dist --json
+bash scripts/verify-release-v0.6.sh <verified-release-commit> <verified-package-sha256>
+```
+
+The public verifier keeps its historical filename and reads the expected version from package.json. When npm supplies `gitHead`, it must match the release commit. The tarball hash is required even when that optional metadata field is absent.
+
+## Rollback
+
+With explicit rollback authorization, restore `latest` to the last fully published release and deprecate the problematic version.
+
+```bash
+npm dist-tag add aeoptimize@0.6.2 latest
+npm deprecate aeoptimize@0.7.0 "Use 0.6.2 while an audit regression is corrected."
+```
+
+Update the GitHub Release with the same warning. Preserve existing tags and exact-version artifacts, then fix forward with a new version and repeat the release gates.

package/examples/github-action-sample/.github/workflows/aeoptimize.yml

@@ -12,7 +12,7 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v4
-      - uses: cucuwang/aeoptimize@v0.6.2
+      - uses: cucuwang/aeoptimize@v0.7.0
         with:
           path: site
           fail-on-low-score: 'false'

package/examples/github-action-sample/README.md

@@ -6,4 +6,4 @@ This directory is a copyable end-to-end sample for the v0.6 Action contract.
 - `site/index.html` is a deterministic public input.
 - The Action is advisory by default. The sample does not block a pull request on an unreviewed score threshold.
 
-The workflow becomes reproducible only after both `aeoptimize@0.6.2` exists on npm and the immutable `v0.6.2` Git tag points to the matching release commit. Until both artifacts exist, use the local CLI or the release-candidate package during controlled verification.
+The workflow becomes reproducible only after both `aeoptimize@0.7.0` exists on npm and the immutable `v0.7.0` Git tag points to the matching release commit. Until both artifacts exist, use the local CLI or the release-candidate package during controlled verification.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "aeoptimize",
-  "version": "0.6.2",
+  "version": "0.7.0",
   "description": "Deterministic content-readiness lint for static websites and documentation",
   "type": "module",
   "main": "./dist/core/index.js",
@@ -26,6 +26,7 @@
     ".claude-plugin/",
     "docs/methodology.md",
     "docs/release-v0.6.md",
+    "docs/release-v0.7.md",
     "CHANGELOG.md",
     "CONTRIBUTING.md",
     "ROADMAP.md",

package/scripts/verify-release-candidate.sh

@@ -52,6 +52,10 @@ PACKAGE_SHA256=$(node -e "const crypto=require('node:crypto');const fs=require('
 
 jq -e '
   (.[0].files | map(.path) | index("dist/cli/index.js")) != null and
+  (.[0].files | map(.path) | index("dist/core/audit.js")) != null and
+  (.[0].files | map(.path) | index("dist/core/static-audit.js")) != null and
+  (.[0].files | map(.path) | index("dist/core/site-audit.js")) != null and
+  (.[0].files | map(.path) | index("docs/release-v0.7.md")) != null and
   (.[0].files | map(.path) | index("fixtures/v0.6/rule-corpus.ts")) != null and
   (.[0].files | map(.path) | index("examples/github-action-sample/.github/workflows/aeoptimize.yml")) != null and
   (.[0].files | map(.path) | index("scripts/verify-release-candidate.sh")) != null and
@@ -70,6 +74,19 @@ for binary in aeoptimize aeo aeo-cli; do
   fi
 done
 
+for audit_command in audit audit-build audit-site; do
+  "$CONSUMER_ROOT/node_modules/.bin/aeoptimize" "$audit_command" --help >/dev/null
+done
+
+"$CONSUMER_ROOT/node_modules/.bin/aeoptimize" audit \
+  "$CONSUMER_ROOT/node_modules/aeoptimize/examples/github-action-sample/site/index.html" \
+  --json > "$VERIFY_ROOT/page-audit.json"
+"$CONSUMER_ROOT/node_modules/.bin/aeoptimize" audit-build \
+  "$CONSUMER_ROOT/node_modules/aeoptimize/examples/github-action-sample/site" \
+  --json > "$VERIFY_ROOT/build-audit.json"
+jq -e '.contractVersion == "1.0" and (.checks | length > 0)' "$VERIFY_ROOT/page-audit.json" >/dev/null
+jq -e '.contractVersion == "1.0" and .source == "local-html" and (.pages | length == 1)' "$VERIFY_ROOT/build-audit.json" >/dev/null
+
 MANIFEST=$(jq -n \
   --arg version "$PACKAGE_VERSION" \
   --arg filename "$PACKAGE_FILENAME" \