@prenta/core 0.118.0 → 0.119.0

package/dist/seo/page-audit.d.ts

@@ -0,0 +1,163 @@
+/**
+ * Per-page SEO and GEO audit.
+ *
+ * Deterministic, dependency-free, and fast enough to run on every keystroke —
+ * it is the number an editor watches while typing, and it also backs the REST
+ * and MCP surfaces so an agent grades a page the same way the UI does.
+ *
+ * ── Why this is not `analyzeContent` ──────────────────────────────────────
+ *
+ * `./analysis.ts` is a CONTENT analyser: fuzzy checks over prose (readability,
+ * keyphrase density, sentence length) with partial credit. It is useful, but
+ * it is not a page score, and measuring it showed why it should not be used as
+ * one:
+ *
+ *   - Its denominator moves. The seven keyphrase checks exist only when a
+ *     keyphrase is set, so setting one — the most standard SEO action there is
+ *     — dropped a real page from 67 to 60 even when the keyphrase was well
+ *     used.
+ *   - Its floor is 47, not 0. A page with no title, no slug and no content
+ *     scores 47, because `improvement` awards half credit to checks that were
+ *     never attempted. Any band scale calibrated for 0–100 is wrong against it.
+ *
+ * This module is a PAGE checklist: every check is binary, every check is
+ * either applicable or explicitly not, and the score spans the full range.
+ *
+ * ── The four properties, and why each exists ──────────────────────────────
+ *
+ * 1. STABLE, VISIBLE DENOMINATOR. A check that cannot apply is `not-applicable`
+ *    and leaves the denominator, but it is still returned with the reason it
+ *    does not apply and the action that would enable it. The score is always
+ *    "% of what applies to this page", and the UI can say "6 of 8 apply"
+ *    rather than leaving a moving number unexplained.
+ *
+ * 2. NOT-APPLICABLE IS NOT PARTIAL CREDIT. There is no half-pass. A blank page
+ *    fails everything it can fail and scores 0, which is what a blank page
+ *    should score.
+ *
+ * 3. WEIGHTED. "Open to search engines" and "meta description length" are not
+ *    the same size of problem — a noindex page is invisible no matter how good
+ *    its title is. Weights are documented at each check rather than hidden in
+ *    a table.
+ *
+ * UNKNOWN INPUTS. A caller that cannot resolve a field passes `undefined`, and
+ * the check reports not-applicable rather than failing. This matters: a red
+ * check an editor has no way to act on is noise, and it drags the score down
+ * for a shortcoming in the plumbing rather than in the page. `null` still means
+ * a genuine absence and still fails.
+ *
+ * 4. BANDS FROM MEASUREMENT. See `SCORE_BANDS` — set from a measured corpus
+ *    (`scripts/calibrate-page-audit.mjs`), not from intuition.
+ */
+import type { PageSection } from '../sections/types.js';
+export type CheckOutcome = 'pass' | 'fail' | 'not-applicable';
+export type AuditGroup = 'seo' | 'geo';
+export interface AuditCheck {
+    id: string;
+    group: AuditGroup;
+    label: string;
+    outcome: CheckOutcome;
+    /**
+     * Relative importance among applicable checks. 1 is a normal check; higher
+     * means failing it does more damage than failing an average one.
+     *
+     * Weight 0 marks a GATE: a precondition that is reported but never scored.
+     * See `indexable` for why being crawlable is not an achievement.
+     */
+    weight: number;
+    /** What to do about it — shown when the check fails. */
+    hint: string;
+    /**
+     * Why the check cannot apply, and what would enable it. Present only when
+     * `outcome === 'not-applicable'`, and never a euphemism for a failure.
+     */
+    naReason?: string;
+}
+export interface AuditGroupResult {
+    group: AuditGroup;
+    checks: AuditCheck[];
+    /** Applicable checks that passed. */
+    passed: number;
+    /** Checks that could be judged — the denominator the score is a share of. */
+    applicable: number;
+    /** Total checks, applicable or not. `applicable`/`total` is what the UI shows. */
+    total: number;
+    /**
+     * 0–100, weighted. `null` when nothing applies: a page with no judgeable
+     * checks has no score, which is different from scoring zero.
+     */
+    score: number | null;
+}
+export interface PageAuditResult {
+    seo: AuditGroupResult;
+    geo: AuditGroupResult;
+}
+export interface PageAuditInput {
+    sections: PageSection[];
+    seo: {
+        title: string;
+        description: string;
+        slug: string;
+        /** Focus keyword. Empty disables the three placement checks. */
+        keyword: string;
+        /** Schema.org type bound to the page, e.g. 'Article'. */
+        schema: string;
+        /**
+         * `null` = no image chosen. `undefined` = an image exists but its
+         * dimensions are not available to the caller, which is a different
+         * statement and must not be scored as a failure — see UNKNOWN below.
+         */
+        ogImage?: {
+            width: number;
+            height: number;
+        } | null;
+        robots: {
+            index: boolean;
+            snippet: boolean;
+        };
+    };
+    /** Site-level: an llms.txt is served. */
+    llmsTxt: boolean;
+    /** Brand name, for the "named up front" check. Empty makes the check n/a. */
+    brand: string;
+    /** `null` = no author. `undefined` = the caller cannot resolve one yet. */
+    author?: {
+        name: string;
+        isBrandByline: boolean;
+    } | null;
+}
+/**
+ * Image slots the TEMPLATE renders, not assets that happen to be filled.
+ *
+ * This distinction is the whole point of the alt-text check. An Image+Text
+ * section always renders an image, so its slot counts whether or not an asset
+ * was picked — counting filled assets instead would let an undescribed image
+ * on the live page report a pass, and a false pass on an accessibility
+ * checklist is worse than having no check.
+ *
+ * Returns one entry per rendered slot with the alt text currently on it.
+ */
+export declare function imageSlots(sections: PageSection[]): Array<{
+    sectionId: string;
+    alt: string;
+}>;
+export declare function auditPage(input: PageAuditInput): PageAuditResult;
+export type ScoreBand = 'good' | 'fair' | 'poor';
+/**
+ * Thresholds measured, not guessed.
+ *
+ * `scripts/calibrate-page-audit.mjs` runs the audit over a corpus spanning
+ * blank pages to fully-optimised ones and reports the distribution. These
+ * bounds come from that run; re-run it when checks or weights change, because
+ * altering a weight moves the distribution and can silently invalidate them.
+ *
+ * The handoff proposed 80 / 55 against the old content analyser, whose floor
+ * was 47 — a scale where `poor` was nearly unreachable. This model spans the
+ * full range, so the boundaries can mean what they say.
+ */
+export declare const SCORE_BANDS: {
+    readonly good: 80;
+    readonly fair: 55;
+};
+export declare function scoreBand(score: number): ScoreBand;
+//# sourceMappingURL=page-audit.d.ts.map

package/dist/seo/page-audit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"page-audit.d.ts","sourceRoot":"","sources":["../../src/seo/page-audit.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkDG;AAGH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAA;AAMvD,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,MAAM,GAAG,gBAAgB,CAAA;AAE7D,MAAM,MAAM,UAAU,GAAG,KAAK,GAAG,KAAK,CAAA;AAEtC,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAA;IACV,KAAK,EAAE,UAAU,CAAA;IACjB,KAAK,EAAE,MAAM,CAAA;IACb,OAAO,EAAE,YAAY,CAAA;IACrB;;;;;;OAMG;IACH,MAAM,EAAE,MAAM,CAAA;IACd,wDAAwD;IACxD,IAAI,EAAE,MAAM,CAAA;IACZ;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB;AAED,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,UAAU,CAAA;IACjB,MAAM,EAAE,UAAU,EAAE,CAAA;IACpB,qCAAqC;IACrC,MAAM,EAAE,MAAM,CAAA;IACd,6EAA6E;IAC7E,UAAU,EAAE,MAAM,CAAA;IAClB,kFAAkF;IAClF,KAAK,EAAE,MAAM,CAAA;IACb;;;OAGG;IACH,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;CACrB;AAED,MAAM,WAAW,eAAe;IAC9B,GAAG,EAAE,gBAAgB,CAAA;IACrB,GAAG,EAAE,gBAAgB,CAAA;CACtB;AAMD,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,WAAW,EAAE,CAAA;IACvB,GAAG,EAAE;QACH,KAAK,EAAE,MAAM,CAAA;QACb,WAAW,EAAE,MAAM,CAAA;QACnB,IAAI,EAAE,MAAM,CAAA;QACZ,gEAAgE;QAChE,OAAO,EAAE,MAAM,CAAA;QACf,yDAAyD;QACzD,MAAM,EAAE,MAAM,CAAA;QACd;;;;WAIG;QACH,OAAO,CAAC,EAAE;YAAE,KAAK,EAAE,MAAM,CAAC;YAAC,MAAM,EAAE,MAAM,CAAA;SAAE,GAAG,IAAI,CAAA;QAClD,MAAM,EAAE;YAAE,KAAK,EAAE,OAAO,CAAC;YAAC,OAAO,EAAE,OAAO,CAAA;SAAE,CAAA;KAC7C,CAAA;IACD,yCAAyC;IACzC,OAAO,EAAE,OAAO,CAAA;IAChB,6EAA6E;IAC7E,KAAK,EAAE,MAAM,CAAA;IACb,2EAA2E;IAC3E,MAAM,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,aAAa,EAAE,OAAO,CAAA;KAAE,GAAG,IAAI,CAAA;CACzD;AAaD;;;;;;;;;;GAUG;AACH,wBAAgB,UAAU,CAAC,QAAQ,EAAE,WAAW,EAAE,GAAG,KAAK,CAAC;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,CAAC,CA6C7F;AAyUD,wBAAgB,SAAS,CAAC,KAAK,EAAE,cAAc,GAAG,eAAe,CAKhE;AAMD,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,CAAA;AAEhD;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,WAAW;;;CAAkC,CAAA;AAE1D,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,CAIlD"}

package/dist/seo/page-audit.js

@@ -0,0 +1,456 @@
+/**
+ * Per-page SEO and GEO audit.
+ *
+ * Deterministic, dependency-free, and fast enough to run on every keystroke —
+ * it is the number an editor watches while typing, and it also backs the REST
+ * and MCP surfaces so an agent grades a page the same way the UI does.
+ *
+ * ── Why this is not `analyzeContent` ──────────────────────────────────────
+ *
+ * `./analysis.ts` is a CONTENT analyser: fuzzy checks over prose (readability,
+ * keyphrase density, sentence length) with partial credit. It is useful, but
+ * it is not a page score, and measuring it showed why it should not be used as
+ * one:
+ *
+ *   - Its denominator moves. The seven keyphrase checks exist only when a
+ *     keyphrase is set, so setting one — the most standard SEO action there is
+ *     — dropped a real page from 67 to 60 even when the keyphrase was well
+ *     used.
+ *   - Its floor is 47, not 0. A page with no title, no slug and no content
+ *     scores 47, because `improvement` awards half credit to checks that were
+ *     never attempted. Any band scale calibrated for 0–100 is wrong against it.
+ *
+ * This module is a PAGE checklist: every check is binary, every check is
+ * either applicable or explicitly not, and the score spans the full range.
+ *
+ * ── The four properties, and why each exists ──────────────────────────────
+ *
+ * 1. STABLE, VISIBLE DENOMINATOR. A check that cannot apply is `not-applicable`
+ *    and leaves the denominator, but it is still returned with the reason it
+ *    does not apply and the action that would enable it. The score is always
+ *    "% of what applies to this page", and the UI can say "6 of 8 apply"
+ *    rather than leaving a moving number unexplained.
+ *
+ * 2. NOT-APPLICABLE IS NOT PARTIAL CREDIT. There is no half-pass. A blank page
+ *    fails everything it can fail and scores 0, which is what a blank page
+ *    should score.
+ *
+ * 3. WEIGHTED. "Open to search engines" and "meta description length" are not
+ *    the same size of problem — a noindex page is invisible no matter how good
+ *    its title is. Weights are documented at each check rather than hidden in
+ *    a table.
+ *
+ * UNKNOWN INPUTS. A caller that cannot resolve a field passes `undefined`, and
+ * the check reports not-applicable rather than failing. This matters: a red
+ * check an editor has no way to act on is noise, and it drags the score down
+ * for a shortcoming in the plumbing rather than in the page. `null` still means
+ * a genuine absence and still fails.
+ *
+ * 4. BANDS FROM MEASUREMENT. See `SCORE_BANDS` — set from a measured corpus
+ *    (`scripts/calibrate-page-audit.mjs`), not from intuition.
+ */
+import { getSectionType } from '../sections/registry.js';
+// ---------------------------------------------------------------------------
+// Content helpers
+// ---------------------------------------------------------------------------
+const str = (v) => (typeof v === 'string' ? v : '');
+/** Sections that render on the live page. Hidden ones are not audited. */
+function visible(sections) {
+    return sections.filter((s) => s?.visible !== false);
+}
+/**
+ * Image slots the TEMPLATE renders, not assets that happen to be filled.
+ *
+ * This distinction is the whole point of the alt-text check. An Image+Text
+ * section always renders an image, so its slot counts whether or not an asset
+ * was picked — counting filled assets instead would let an undescribed image
+ * on the live page report a pass, and a false pass on an accessibility
+ * checklist is worse than having no check.
+ *
+ * Returns one entry per rendered slot with the alt text currently on it.
+ */
+export function imageSlots(sections) {
+    const slots = [];
+    for (const section of visible(sections)) {
+        const def = getSectionType(section.sectionType);
+        if (!def)
+            continue;
+        const content = (section.content ?? {});
+        for (const field of def.fields) {
+            if (field.type === 'media') {
+                // The slot exists because the template declares it. Alt lives on a
+                // sibling key by convention (`imageUrl` → `imageAlt`).
+                const altKey = field.key.replace(/Url$/, '') + 'Alt';
+                slots.push({ sectionId: section.id, alt: str(content[altKey]) });
+            }
+            else if (field.type === 'gallery') {
+                // A gallery renders one slot per row the editor added. Zero rows means
+                // zero rendered images — nothing to describe.
+                const rows = Array.isArray(content[field.key]) ? content[field.key] : [];
+                for (const row of rows) {
+                    const r = (row ?? {});
+                    slots.push({ sectionId: section.id, alt: str(r.alt) });
+                }
+            }
+            else if (field.type === 'repeater' && field.fields?.some((f) => f.type === 'media')) {
+                // A repeater whose rows carry a media sub-field renders one image per
+                // row, exactly like a gallery — a logo/badge strip is the usual case.
+                //
+                // Walking these is not optional. The rule is "count the slots the
+                // template renders", and a repeater that fell through would let a whole
+                // strip of undescribed logos report a clean pass, which is the specific
+                // false pass this check exists to prevent.
+                const rows = Array.isArray(content[field.key]) ? content[field.key] : [];
+                const mediaSubFields = field.fields.filter((f) => f.type === 'media');
+                for (const row of rows) {
+                    const r = (row ?? {});
+                    for (const sub of mediaSubFields) {
+                        const altKey = sub.key.replace(/Url$/, '') + 'Alt';
+                        // `alt` as the fallback key matches the gallery row convention.
+                        slots.push({ sectionId: section.id, alt: str(r[altKey] ?? r.alt) });
+                    }
+                }
+            }
+        }
+    }
+    return slots;
+}
+/**
+ * Body copy across visible sections, in render order.
+ *
+ * Field TYPE is not enough to identify prose: the registry types headings as
+ * `textarea` too, because they are multi-line inputs. Selecting on type alone
+ * made the "opens with a direct answer" check measure the headline — a 29
+ * character string that can never fall in the 80–340 quotable range, so the
+ * check was unpassable and silently capped the GEO score.
+ */
+function bodyText(sections) {
+    const out = [];
+    for (const section of visible(sections)) {
+        const def = getSectionType(section.sectionType);
+        if (!def)
+            continue;
+        const content = (section.content ?? {});
+        for (const field of def.fields) {
+            if (field.type !== 'textarea' && field.type !== 'richText')
+                continue;
+            if (HEADING_KEY.test(field.key))
+                continue;
+            const value = str(content[field.key])
+                .replace(/<[^>]*>/g, ' ')
+                .trim();
+            if (value)
+                out.push(value);
+        }
+    }
+    return out;
+}
+/** Keys the registry uses for headings, which are `textarea` like body copy. */
+const HEADING_KEY = /heading|title/i;
+/** First heading on the page — the H1 a crawler sees. */
+function firstHeading(sections) {
+    for (const section of visible(sections)) {
+        const def = getSectionType(section.sectionType);
+        if (!def)
+            continue;
+        const content = (section.content ?? {});
+        for (const field of def.fields) {
+            if (!HEADING_KEY.test(field.key))
+                continue;
+            const value = str(content[field.key]).trim();
+            if (value)
+                return value;
+        }
+    }
+    return '';
+}
+function hasVisibleType(sections, type) {
+    return visible(sections).some((s) => s.sectionType === type);
+}
+const norm = (s) => s.toLowerCase().trim();
+// ---------------------------------------------------------------------------
+// Checks
+// ---------------------------------------------------------------------------
+function seoChecks(input) {
+    const { seo, sections } = input;
+    const keyword = seo.keyword.trim();
+    const hasKeyword = keyword.length > 0;
+    const kw = norm(keyword);
+    // Not-applicable rather than failing: without a keyword there is nothing to
+    // locate, and failing three checks for a field the editor has not filled in
+    // punishes them twice for one omission. The reason names the enabling action
+    // so the panel can show them greyed rather than hidden.
+    const noKeyword = 'Set a focus keyword to enable this check.';
+    const slots = imageSlots(sections);
+    const described = slots.filter((s) => s.alt.trim().length > 3);
+    const og = seo.ogImage;
+    const ogUnknown = og === undefined;
+    const ogRatio = og && og.height > 0 ? og.width / og.height : 0;
+    return [
+        {
+            id: 'title-length',
+            group: 'seo',
+            label: 'Title tag length',
+            // Weight 2: the title is the strongest on-page signal and the line a
+            // searcher actually reads in the result.
+            weight: 2,
+            outcome: seo.title.length >= 30 && seo.title.length <= 60 ? 'pass' : 'fail',
+            hint: 'Aim for 30–60 characters so it is descriptive without being truncated.',
+        },
+        {
+            id: 'description-length',
+            group: 'seo',
+            label: 'Meta description length',
+            weight: 1,
+            outcome: seo.description.length >= 70 && seo.description.length <= 160 ? 'pass' : 'fail',
+            hint: 'Aim for 70–160 characters — enough to earn the click, short enough to survive.',
+        },
+        {
+            id: 'keyword-set',
+            group: 'seo',
+            label: 'Focus keyword chosen',
+            // Carries the cost of having no keyword, so the three placement checks
+            // below can be not-applicable without shrinking the denominator into
+            // flattery. Without this, a page with only a title and description
+            // scored "good" on 3 of 4 checks — technically true, and misleading.
+            weight: 1,
+            outcome: hasKeyword ? 'pass' : 'fail',
+            hint: 'Choose the phrase this page should rank for; it unlocks three more checks.',
+        },
+        {
+            id: 'keyword-in-title',
+            group: 'seo',
+            label: 'Focus keyword in title',
+            weight: 2,
+            outcome: !hasKeyword ? 'not-applicable' : norm(seo.title).includes(kw) ? 'pass' : 'fail',
+            hint: 'Work the focus keyword into the title tag.',
+            ...(hasKeyword ? {} : { naReason: noKeyword }),
+        },
+        {
+            id: 'keyword-in-h1',
+            group: 'seo',
+            label: 'Focus keyword in H1',
+            weight: 1,
+            outcome: !hasKeyword
+                ? 'not-applicable'
+                : norm(firstHeading(sections)).includes(kw)
+                    ? 'pass'
+                    : 'fail',
+            hint: 'Work the focus keyword into the page’s first heading.',
+            ...(hasKeyword ? {} : { naReason: noKeyword }),
+        },
+        {
+            id: 'keyword-in-url',
+            group: 'seo',
+            label: 'Focus keyword in URL',
+            weight: 1,
+            outcome: !hasKeyword
+                ? 'not-applicable'
+                : norm(seo.slug).includes(kw.replace(/\s+/g, '-'))
+                    ? 'pass'
+                    : 'fail',
+            hint: 'Include the focus keyword in the URL slug.',
+            ...(hasKeyword ? {} : { naReason: noKeyword }),
+        },
+        {
+            id: 'images-have-alt',
+            group: 'seo',
+            label: 'Every image has alt text',
+            // Weight 2: this is an accessibility failure before it is an SEO one.
+            weight: 2,
+            // Genuinely not applicable when the template renders no image slots —
+            // unlike an empty keyword, there is no action that would enable it.
+            outcome: slots.length === 0 ? 'not-applicable' : described.length === slots.length ? 'pass' : 'fail',
+            hint: 'Describe every image the template renders, including ones with no asset chosen yet.',
+            ...(slots.length === 0 ? { naReason: 'This page renders no images.' } : {}),
+        },
+        {
+            id: 'indexable',
+            group: 'seo',
+            label: 'Open to search engines',
+            // A GATE (weight 0), not a scored check. Being crawlable is the price of
+            // entry, not an accomplishment — scoring it hands a blank page free
+            // credit for doing nothing, which is exactly the floor problem that made
+            // the old content scorer's bands meaningless.
+            //
+            // When it fails, every other SEO check becomes not-applicable and the
+            // group has no score: a page deliberately hidden from search has no
+            // search performance to rate, and shouting "0" at someone who noindexed
+            // a thank-you page on purpose is noise, not information.
+            weight: 0,
+            outcome: seo.robots.index ? 'pass' : 'fail',
+            hint: 'This page is set to noindex — search engines will not list it.',
+        },
+        {
+            id: 'social-image',
+            group: 'seo',
+            label: 'Social share image',
+            weight: 1,
+            outcome: ogUnknown
+                ? 'not-applicable'
+                : og && og.width >= 1200 && ogRatio >= 1.7 && ogRatio <= 2.1
+                    ? 'pass'
+                    : 'fail',
+            hint: 'Use an image at least 1200px wide with roughly a 1.91:1 ratio.',
+            ...(ogUnknown ? { naReason: 'Image dimensions are not available here.' } : {}),
+        },
+    ];
+}
+function geoChecks(input) {
+    const { sections, seo, brand, author } = input;
+    const bodies = bodyText(sections);
+    const opening = bodies[0] ?? '';
+    const upFront = bodies.join(' ').slice(0, 170);
+    return [
+        {
+            id: 'direct-answer',
+            group: 'geo',
+            label: 'Opens with a direct answer',
+            // Weight 2: the quotable opening is what an answer engine lifts.
+            weight: 2,
+            outcome: opening.length >= 80 && opening.length <= 340 ? 'pass' : 'fail',
+            hint: 'Open with an 80–340 character answer to the question this page addresses.',
+        },
+        {
+            id: 'brand-up-front',
+            group: 'geo',
+            label: 'Brand named up front',
+            weight: 1,
+            outcome: !brand.trim()
+                ? 'not-applicable'
+                : norm(upFront).includes(norm(brand))
+                    ? 'pass'
+                    : 'fail',
+            hint: 'Name the brand in the first 170 characters so a citation attributes it.',
+            ...(brand.trim() ? {} : { naReason: 'No brand name configured for this site.' }),
+        },
+        {
+            id: 'citable-figures',
+            group: 'geo',
+            label: 'Citable figures on page',
+            weight: 1,
+            outcome: hasVisibleType(sections, 'stats') ? 'pass' : 'fail',
+            hint: 'Concrete figures give an answer engine something specific to quote.',
+        },
+        {
+            id: 'first-party-quotes',
+            group: 'geo',
+            label: 'First-party quotes',
+            weight: 1,
+            outcome: hasVisibleType(sections, 'quote') || hasVisibleType(sections, 'widget-embed')
+                ? 'pass'
+                : 'fail',
+            hint: 'A testimonial or pull quote provides attributable first-party material.',
+        },
+        {
+            id: 'structured-data',
+            group: 'geo',
+            label: 'Structured data attached',
+            weight: 2,
+            outcome: seo.schema.trim() ? 'pass' : 'fail',
+            hint: 'Bind a schema.org type so machines can classify the page.',
+        },
+        {
+            id: 'llms-txt',
+            group: 'geo',
+            label: 'llms.txt served',
+            // Site-level, not page-level: shown for context, weighted low because no
+            // page edit can change it.
+            weight: 1,
+            outcome: input.llmsTxt ? 'pass' : 'fail',
+            hint: 'Serve an llms.txt at the site root to declare content for AI crawlers.',
+        },
+        {
+            id: 'author-attributed',
+            group: 'geo',
+            label: 'Author attributed',
+            weight: 1,
+            outcome: author === undefined
+                ? 'not-applicable'
+                : author && author.name.trim() && !author.isBrandByline
+                    ? 'pass'
+                    : 'fail',
+            hint: 'Attribute a named person — a brand byline carries less authorial weight.',
+            ...(author === undefined ? { naReason: 'No author is resolved for this page yet.' } : {}),
+        },
+        {
+            id: 'snippets-allowed',
+            group: 'geo',
+            label: 'Snippets allowed',
+            // A GATE (weight 0), for the same reason as `indexable`. nosnippet
+            // blocks AI Overviews and chat citations outright, so every other GEO
+            // check is moot — but allowing snippets is a precondition, not a score.
+            weight: 0,
+            outcome: seo.robots.snippet ? 'pass' : 'fail',
+            hint: 'nosnippet blocks AI Overviews and chat citations entirely.',
+        },
+    ];
+}
+// ---------------------------------------------------------------------------
+// Scoring
+// ---------------------------------------------------------------------------
+/**
+ * A failed gate (weight 0, outcome fail) suppresses its whole group: nothing
+ * else in it can be judged, so every other check becomes not-applicable and the
+ * group reports no score. A page held back from search has no search
+ * performance to rate — that is a different statement from scoring zero, and
+ * conflating them would nag every editor who noindexed a page on purpose.
+ */
+function applyGates(checks) {
+    const failedGate = checks.find((c) => c.weight === 0 && c.outcome === 'fail');
+    if (!failedGate)
+        return checks;
+    return checks.map((c) => c.weight === 0
+        ? c
+        : {
+            ...c,
+            outcome: 'not-applicable',
+            naReason: `Not evaluated: ${failedGate.label.toLowerCase()} is off for this page.`,
+        });
+}
+function summarize(group, rawChecks) {
+    const checks = applyGates(rawChecks);
+    // Gates are reported but never scored, so they leave the denominator too.
+    const applicable = checks.filter((c) => c.outcome !== 'not-applicable' && c.weight > 0);
+    const possible = applicable.reduce((sum, c) => sum + c.weight, 0);
+    const earned = applicable
+        .filter((c) => c.outcome === 'pass')
+        .reduce((sum, c) => sum + c.weight, 0);
+    return {
+        group,
+        checks,
+        passed: applicable.filter((c) => c.outcome === 'pass').length,
+        applicable: applicable.length,
+        total: checks.filter((c) => c.weight > 0).length,
+        // No applicable checks means there is nothing to judge. Reporting 0 would
+        // read as failure and 100 as success; both would be inventions.
+        score: possible === 0 ? null : Math.round((earned / possible) * 100),
+    };
+}
+export function auditPage(input) {
+    return {
+        seo: summarize('seo', seoChecks(input)),
+        geo: summarize('geo', geoChecks(input)),
+    };
+}
+/**
+ * Thresholds measured, not guessed.
+ *
+ * `scripts/calibrate-page-audit.mjs` runs the audit over a corpus spanning
+ * blank pages to fully-optimised ones and reports the distribution. These
+ * bounds come from that run; re-run it when checks or weights change, because
+ * altering a weight moves the distribution and can silently invalidate them.
+ *
+ * The handoff proposed 80 / 55 against the old content analyser, whose floor
+ * was 47 — a scale where `poor` was nearly unreachable. This model spans the
+ * full range, so the boundaries can mean what they say.
+ */
+export const SCORE_BANDS = { good: 80, fair: 55 };
+export function scoreBand(score) {
+    if (score >= SCORE_BANDS.good)
+        return 'good';
+    if (score >= SCORE_BANDS.fair)
+        return 'fair';
+    return 'poor';
+}
+//# sourceMappingURL=page-audit.js.map

package/dist/seo/page-audit.js.map

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

package/dist/seo/page-meta.d.ts

@@ -170,10 +170,6 @@ export declare function resolveContentDates(params: {
     datePublished?: string;
     dateModified?: string;
 };
-/**
- * Compose page meta + JSON-LD from a CMS document + collection config.
- * Pure function — safe to call in any runtime (Edge, Node, browser).
- */
 export declare function composePageMeta(input: ComposePageMetaInput): ComposedPageMeta;
 export { detectSchemaType };
 //# sourceMappingURL=page-meta.d.ts.map