@growth-labs/seo 0.1.5 → 0.2.0

package/dist/routes/revalidate.js

@@ -0,0 +1,243 @@
+import { resolveAeoTwins } from '../options.js';
+import { getConfig, getContentProvider } from '../state.js';
+import { generateAeoMarkdown } from '../utils/aeo.js';
+import { generateSummaryTwin } from '../utils/aeo-summary.js';
+import { deleteFreshTwin, writeFreshTwin } from '../utils/fresh-layer.js';
+export const prerender = false;
+const MAX_BATCH = 50;
+const DEFAULT_RATE_LIMIT_RPM = 10;
+/**
+ * POST /_seo/revalidate — CMS webhook target. Re-renders the listed slugs,
+ * writes to R2 under the current deployment prefix, purges the edge cache for
+ * the markdown sitemap so newly-published content is discoverable within seconds.
+ *
+ * Auth: Authorization: Bearer <revalidateToken>. Token is the same ≥32-byte
+ * value configured in aeoTwins.revalidateToken. Compared with constant-time
+ * string compare.
+ *
+ * Rate limit + per-slug lock + idempotency all delegate to the Revalidation
+ * Coordinator Durable Object (spec "Revalidation Coordinator DO topology").
+ */
+export const POST = async (context) => {
+    const config = getConfig();
+    const contentProvider = getContentProvider();
+    const aeo = resolveAeoTwins(config.aeoTwins);
+    if (!aeo?.onDemandRevalidation || !aeo.freshLayer || !aeo.revalidateToken) {
+        return json({ error: 'revalidation_disabled' }, 404);
+    }
+    const env = context.locals?.runtime?.env;
+    if (!env) {
+        return json({ error: 'binding_unavailable' }, 503);
+    }
+    // 1. Auth: Bearer token, constant-time compare.
+    const authz = context.request.headers.get('Authorization') ?? '';
+    const bearerPrefix = 'Bearer ';
+    if (!authz.startsWith(bearerPrefix)) {
+        return json({ error: 'unauthorized' }, 401);
+    }
+    const presented = authz.slice(bearerPrefix.length);
+    if (!constantTimeEqual(presented, aeo.revalidateToken)) {
+        return json({ error: 'unauthorized' }, 401);
+    }
+    // 2. Parse body.
+    let body;
+    try {
+        body = (await context.request.json());
+    }
+    catch {
+        return json({ error: 'bad_json' }, 400);
+    }
+    const slugs = body.slugs ?? [];
+    if (!Array.isArray(slugs) || slugs.length === 0) {
+        return json({ error: 'no_slugs' }, 400);
+    }
+    if (slugs.length > MAX_BATCH) {
+        return json({ error: 'batch_too_large', limit: MAX_BATCH }, 400);
+    }
+    // 3. Resolve the Revalidation Coordinator DO for this hostname.
+    const hostname = new URL(context.request.url).host;
+    const coordBindingName = aeo.freshLayer.coordinatorBindingName;
+    const coordBinding = env[coordBindingName];
+    const coord = coordBinding ? coordBinding.get(coordBinding.idFromName(hostname)) : undefined;
+    // 4. Rate-limit check (per-token).
+    if (coord) {
+        const rl = await coordCall(coord, {
+            action: 'rate-check',
+            token: presented,
+            limitRpm: DEFAULT_RATE_LIMIT_RPM,
+        });
+        if (!rl.ok) {
+            return new Response(JSON.stringify({ error: 'rate_limited', retryAfterMs: rl.retryAfterMs }), {
+                status: 429,
+                headers: {
+                    'Content-Type': 'application/json',
+                    'Retry-After': String(Math.ceil(Number(rl.retryAfterMs ?? 5000) / 1000)),
+                },
+            });
+        }
+    }
+    // 5. Idempotency check — dedupe concurrent webhooks for the same CMS event.
+    if (coord && body.idempotency_key) {
+        const cached = await coordCall(coord, {
+            action: 'idempotency-check',
+            key: body.idempotency_key,
+        });
+        if (cached.ok && cached.hit) {
+            return json({ ok: true, deduped: true, ...cached.result });
+        }
+    }
+    // 6. Resolve fresh layer + content provider.
+    const freshLayerImpl = env[aeo.freshLayer.bindingName];
+    if (!freshLayerImpl || !contentProvider) {
+        return json({ error: 'binding_unavailable' }, 503);
+    }
+    const freshLayer = {
+        type: aeo.freshLayer.type,
+        impl: freshLayerImpl,
+        deploymentId: env.CF_VERSION_METADATA?.id ?? 'dev',
+    };
+    const outcomes = [];
+    for (const slug of slugs) {
+        const outcome = await revalidateSlug({
+            slug,
+            action: body.action ?? 'publish',
+            config,
+            contentProvider,
+            freshLayer,
+            coord,
+        });
+        outcomes.push(outcome);
+    }
+    // 7. Purge sitemap-markdown cache so newly-published articles show up.
+    await purgeSitemapMarkdownCache(context.request).catch(() => { });
+    // 8. Cache idempotency result for future replays.
+    if (coord && body.idempotency_key) {
+        await coordCall(coord, {
+            action: 'idempotency-set',
+            key: body.idempotency_key,
+            result: { outcomes },
+        });
+    }
+    return json({ ok: true, outcomes });
+};
+async function revalidateSlug(input) {
+    const { slug, action, config, contentProvider, freshLayer, coord } = input;
+    const start = Date.now();
+    // Acquire per-slug lock; if someone else holds it, serialize.
+    let leaseId;
+    if (coord) {
+        const acquire = await coordCall(coord, { action: 'acquire-lock', slug });
+        if (acquire.ok) {
+            leaseId = acquire.leaseId;
+        }
+        else if (acquire.error === 'locked') {
+            // Someone else is rendering this slug. Return without duplicating work;
+            // the winner's writeback will be visible to subsequent requests.
+            return { slug, outcome: 'serialized' };
+        }
+        else {
+            return { slug, outcome: 'error', error: acquire.error };
+        }
+    }
+    try {
+        if (action === 'unpublish') {
+            const url = new URL(`${config.site.replace(/\/$/, '')}/${slug}`).pathname;
+            const aeo = resolveAeoTwins(config.aeoTwins);
+            const twinPath = `${url.replace(/\/+$/, '')}.md`;
+            const summaryPath = `${twinPath}.summary.md`;
+            await deleteFreshTwin(freshLayer, twinPath);
+            if (aeo?.summaryTwin)
+                await deleteFreshTwin(freshLayer, summaryPath);
+            return { slug, outcome: 'deleted', durationMs: Date.now() - start };
+        }
+        // Publish / update.
+        let items;
+        try {
+            items = await contentProvider({ type: 'articles', slugs: [slug] }, {});
+        }
+        catch (err) {
+            return {
+                slug,
+                outcome: 'error',
+                error: err instanceof Error ? err.message : String(err),
+            };
+        }
+        const item = items.find((i) => i.url.endsWith(`/${slug}`) || i.url === slug);
+        if (!item)
+            return { slug, outcome: 'not_found' };
+        const body = item.description ?? '';
+        const aeo = resolveAeoTwins(config.aeoTwins);
+        const primaryUrl = (aeo?.twinUrl ?? defaultTwin)(item.url);
+        const summaryUrl = aeo?.summaryTwin ? `${primaryUrl}.summary.md` : undefined;
+        const markdown = generateAeoMarkdown(item, {
+            publisherName: config.organization.name,
+            schemaType: config.schemaType,
+            content: body,
+            ragChunkMarkers: aeo?.ragChunkMarkers,
+            canonical: item.url,
+            twinUrl: primaryUrl,
+            summaryUrl,
+        });
+        await writeFreshTwin(freshLayer, pathOf(primaryUrl), markdown);
+        if (aeo?.summaryTwin && summaryUrl) {
+            const summary = generateSummaryTwin(item, {
+                publisherName: config.organization.name,
+                schemaType: config.schemaType,
+                content: body,
+                fullUrl: primaryUrl,
+            });
+            await writeFreshTwin(freshLayer, pathOf(summaryUrl), summary.markdown);
+        }
+        return { slug, outcome: 'written', durationMs: Date.now() - start };
+    }
+    finally {
+        if (coord && leaseId) {
+            await coordCall(coord, { action: 'release-lock', slug, leaseId }).catch(() => { });
+        }
+    }
+}
+// ─── Helpers ───
+async function coordCall(stub, body) {
+    try {
+        const res = await stub.fetch(new Request('https://internal/', {
+            method: 'POST',
+            body: JSON.stringify(body),
+            headers: { 'Content-Type': 'application/json' },
+        }));
+        return (await res.json());
+    }
+    catch {
+        return { ok: false, error: 'coord_unavailable' };
+    }
+}
+function constantTimeEqual(a, b) {
+    if (a.length !== b.length)
+        return false;
+    let diff = 0;
+    for (let i = 0; i < a.length; i++)
+        diff |= a.charCodeAt(i) ^ b.charCodeAt(i);
+    return diff === 0;
+}
+function defaultTwin(url) {
+    return `${url.replace(/\/+$/, '')}.md`;
+}
+function pathOf(url) {
+    try {
+        return new URL(url).pathname;
+    }
+    catch {
+        return url.startsWith('/') ? url : `/${url}`;
+    }
+}
+async function purgeSitemapMarkdownCache(request) {
+    const origin = new URL(request.url).origin;
+    const key = new Request(`${origin}/sitemap-markdown.xml`);
+    await caches.default.delete(key).catch(() => { });
+}
+function json(body, status = 200) {
+    return new Response(JSON.stringify(body), {
+        status,
+        headers: { 'Content-Type': 'application/json' },
+    });
+}
+//# sourceMappingURL=revalidate.js.map

package/dist/routes/revalidate.js.map

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

package/dist/routes/rss.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"rss.d.ts","sourceRoot":"","sources":["../../src/routes/rss.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAA;AAKrC,eAAO,MAAM,SAAS,QAAQ,CAAA;AAE9B,eAAO,MAAM,GAAG,EAAE,QAgBjB,CAAA"}
+{"version":3,"file":"rss.d.ts","sourceRoot":"","sources":["../../src/routes/rss.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAA;AAMrC,eAAO,MAAM,SAAS,QAAQ,CAAA;AAE9B,eAAO,MAAM,GAAG,EAAE,QAkBjB,CAAA"}

package/dist/routes/rss.js

@@ -1,4 +1,5 @@
 import { getConfig, getContentProvider } from '../state.js';
+import { forRss } from '../utils/content-filter.js';
 import { generateRssFeed } from '../utils/rss.js';
 export const prerender = false;
 export const GET = async (context) => {
@@ -11,7 +12,9 @@ export const GET = async (context) => {
         }
         catch { }
     }
-    const xml = generateRssFeed(articles, config);
+    // Members items excluded unconditionally. Public items respect includeInFeed.
+    const filtered = forRss(articles);
+    const xml = generateRssFeed(filtered, config);
     return new Response(xml, {
         headers: { 'Content-Type': 'application/rss+xml; charset=utf-8' },
     });

package/dist/routes/rss.js.map

@@ -1 +1 @@
-{"version":3,"file":"rss.js","sourceRoot":"","sources":["../../src/routes/rss.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAA;AAE3D,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAA;AAEjD,MAAM,CAAC,MAAM,SAAS,GAAG,KAAK,CAAA;AAE9B,MAAM,CAAC,MAAM,GAAG,GAAa,KAAK,EAAE,OAAO,EAAE,EAAE;IAC9C,MAAM,MAAM,GAAG,SAAS,EAAE,CAAA;IAC1B,MAAM,eAAe,GAAG,kBAAkB,EAAE,CAAA;IAE5C,IAAI,QAAQ,GAAkB,EAAE,CAAA;IAChC,IAAI,eAAe,EAAE,CAAC;QACrB,IAAI,CAAC;YACJ,QAAQ,GAAG,MAAM,eAAe,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,EAAE,OAAc,CAAC,CAAA;QACvE,CAAC;QAAC,MAAM,CAAC,CAAA,CAAC;IACX,CAAC;IAED,MAAM,GAAG,GAAG,eAAe,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAA;IAE7C,OAAO,IAAI,QAAQ,CAAC,GAAG,EAAE;QACxB,OAAO,EAAE,EAAE,cAAc,EAAE,oCAAoC,EAAE;KACjE,CAAC,CAAA;AACH,CAAC,CAAA"}
+{"version":3,"file":"rss.js","sourceRoot":"","sources":["../../src/routes/rss.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAA;AAE3D,OAAO,EAAE,MAAM,EAAE,MAAM,4BAA4B,CAAA;AACnD,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAA;AAEjD,MAAM,CAAC,MAAM,SAAS,GAAG,KAAK,CAAA;AAE9B,MAAM,CAAC,MAAM,GAAG,GAAa,KAAK,EAAE,OAAO,EAAE,EAAE;IAC9C,MAAM,MAAM,GAAG,SAAS,EAAE,CAAA;IAC1B,MAAM,eAAe,GAAG,kBAAkB,EAAE,CAAA;IAE5C,IAAI,QAAQ,GAAkB,EAAE,CAAA;IAChC,IAAI,eAAe,EAAE,CAAC;QACrB,IAAI,CAAC;YACJ,QAAQ,GAAG,MAAM,eAAe,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,EAAE,OAAO,CAAC,CAAA;QAChE,CAAC;QAAC,MAAM,CAAC,CAAA,CAAC;IACX,CAAC;IAED,8EAA8E;IAC9E,MAAM,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAA;IACjC,MAAM,GAAG,GAAG,eAAe,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAA;IAE7C,OAAO,IAAI,QAAQ,CAAC,GAAG,EAAE;QACxB,OAAO,EAAE,EAAE,cAAc,EAAE,oCAAoC,EAAE;KACjE,CAAC,CAAA;AACH,CAAC,CAAA"}

package/dist/routes/sitemap-markdown.d.ts

@@ -0,0 +1,4 @@
+import type { APIRoute } from 'astro';
+export declare const prerender = false;
+export declare const GET: APIRoute;
+//# sourceMappingURL=sitemap-markdown.d.ts.map

package/dist/routes/sitemap-markdown.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sitemap-markdown.d.ts","sourceRoot":"","sources":["../../src/routes/sitemap-markdown.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAA;AAMrC,eAAO,MAAM,SAAS,QAAQ,CAAA;AAE9B,eAAO,MAAM,GAAG,EAAE,QA6BjB,CAAA"}

package/dist/routes/sitemap-markdown.js

@@ -0,0 +1,32 @@
+import { resolveAeoTwins } from '../options.js';
+import { getConfig, getContentProvider } from '../state.js';
+import { generateMarkdownSitemap } from '../utils/sitemap-markdown.js';
+export const prerender = false;
+export const GET = async (context) => {
+    const config = getConfig();
+    const contentProvider = getContentProvider();
+    // Only emit when twin URLs actually exist on disk (static or both modes).
+    // Middleware-mode twins live at the same URL as HTML; no distinct twin URLs.
+    const aeo = resolveAeoTwins(config.aeoTwins);
+    if (!config.markdownSitemap || !aeo || aeo.mode === 'middleware') {
+        return new Response('sitemap-markdown not enabled', { status: 404 });
+    }
+    let articles = [];
+    if (contentProvider) {
+        try {
+            articles = await contentProvider({ type: 'articles' }, context);
+        }
+        catch { }
+    }
+    const xml = generateMarkdownSitemap({
+        items: articles,
+        twinUrl: aeo.twinUrl,
+        // R2-freshness freshLayerLastmod is wired at middleware level via the DO;
+        // at the build-route layer we use build-time dateModified. After revalidation
+        // writes, the consumer's cache purge causes this route to regenerate.
+    });
+    return new Response(xml, {
+        headers: { 'Content-Type': 'application/xml; charset=utf-8' },
+    });
+};
+//# sourceMappingURL=sitemap-markdown.js.map

package/dist/routes/sitemap-markdown.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sitemap-markdown.js","sourceRoot":"","sources":["../../src/routes/sitemap-markdown.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAA;AAC/C,OAAO,EAAE,SAAS,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAA;AAE3D,OAAO,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAA;AAEtE,MAAM,CAAC,MAAM,SAAS,GAAG,KAAK,CAAA;AAE9B,MAAM,CAAC,MAAM,GAAG,GAAa,KAAK,EAAE,OAAO,EAAE,EAAE;IAC9C,MAAM,MAAM,GAAG,SAAS,EAAE,CAAA;IAC1B,MAAM,eAAe,GAAG,kBAAkB,EAAE,CAAA;IAE5C,0EAA0E;IAC1E,6EAA6E;IAC7E,MAAM,GAAG,GAAG,eAAe,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAA;IAC5C,IAAI,CAAC,MAAM,CAAC,eAAe,IAAI,CAAC,GAAG,IAAI,GAAG,CAAC,IAAI,KAAK,YAAY,EAAE,CAAC;QAClE,OAAO,IAAI,QAAQ,CAAC,8BAA8B,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,CAAA;IACrE,CAAC;IAED,IAAI,QAAQ,GAAkB,EAAE,CAAA;IAChC,IAAI,eAAe,EAAE,CAAC;QACrB,IAAI,CAAC;YACJ,QAAQ,GAAG,MAAM,eAAe,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,EAAE,OAAO,CAAC,CAAA;QAChE,CAAC;QAAC,MAAM,CAAC,CAAA,CAAC;IACX,CAAC;IAED,MAAM,GAAG,GAAG,uBAAuB,CAAC;QACnC,KAAK,EAAE,QAAQ;QACf,OAAO,EAAE,GAAG,CAAC,OAAO;QACpB,0EAA0E;QAC1E,8EAA8E;QAC9E,sEAAsE;KACtE,CAAC,CAAA;IAEF,OAAO,IAAI,QAAQ,CAAC,GAAG,EAAE;QACxB,OAAO,EAAE,EAAE,cAAc,EAAE,gCAAgC,EAAE;KAC7D,CAAC,CAAA;AACH,CAAC,CAAA"}

package/dist/types.d.ts

@@ -3,6 +3,7 @@ export interface ContentAuthor {
     name: string;
     url?: string;
     jobTitle?: string;
+    knowsAbout?: string[];
     sameAs?: string[];
 }
 export interface ContentAudio {
@@ -52,6 +53,7 @@ export interface PodcastEpisodeMeta {
     seasonNumber?: number;
     episodeType?: 'full' | 'trailer' | 'bonus';
 }
+export type ContentAccess = 'public' | 'members';
 export interface ContentItem {
     url: string;
     title: string;
@@ -64,6 +66,14 @@ export interface ContentItem {
     podcastEpisode?: PodcastEpisodeMeta;
     locale?: string;
     alternateLocales?: ContentLocaleAlternate[];
+    appleNewsId?: string;
+    appleNewsPublishable?: 'yes' | 'no';
+    appleNewsSection?: string;
+    newsKeywords?: string[];
+    access?: ContentAccess;
+    includeInSitemap?: boolean;
+    includeInFeed?: boolean;
+    summary?: string;
     isAccessibleForFree?: boolean;
     paywallCssSelector?: string;
     product?: ContentProduct;
@@ -84,9 +94,13 @@ export interface ContentItem {
     };
 }
 export type ContentType = 'articles' | 'pages' | 'videos' | 'products' | 'authors';
-export type ContentProvider = (params: {
+export interface ContentProviderParams {
     type: ContentType;
-}, context: APIContext) => Promise<ContentItem[]>;
+    slugs?: string[];
+}
+export type ContentProvider = (params: ContentProviderParams, context: APIContext) => Promise<ContentItem[]>;
+export type CrawlerClass = 'verifiedSearchCrawler' | 'llmTrainingCrawler' | 'userDirectedLlmAgent' | 'anonymous';
+export type EffectiveAuthSegment = 'anon' | 'member' | 'search-full';
 export interface MetaTag {
     [key: string]: string;
 }

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,OAAO,CAAA;AAIvC,MAAM,WAAW,aAAa;IAC7B,IAAI,EAAE,MAAM,CAAA;IACZ,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAA;IACrB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAA;CACjB;AAED,MAAM,WAAW,YAAY;IAC5B,GAAG,EAAE,MAAM,CAAA;IACX,QAAQ,EAAE,MAAM,CAAA;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAA;CACjB;AAED,MAAM,WAAW,sBAAsB;IACtC,IAAI,EAAE,MAAM,CAAA;IACZ,GAAG,EAAE,MAAM,CAAA;CACX;AAED,MAAM,WAAW,cAAc;IAC9B,IAAI,EAAE,MAAM,CAAA;IACZ,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,MAAM,CAAA;IACb,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,YAAY,EAAE,SAAS,GAAG,YAAY,GAAG,UAAU,GAAG,cAAc,CAAA;IACpE,KAAK,CAAC,EAAE,MAAM,CAAA;CACd;AAED,MAAM,WAAW,cAAc;IAC9B,IAAI,EAAE,MAAM,CAAA;IACZ,WAAW,EAAE,MAAM,CAAA;IACnB,KAAK,EAAE,MAAM,CAAA;IACb,QAAQ,EAAE,MAAM,CAAA;IAChB,YAAY,EAAE,SAAS,GAAG,YAAY,GAAG,UAAU,GAAG,cAAc,CAAA;IACpE,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,MAAM,EAAE,MAAM,EAAE,CAAA;IAChB,MAAM,CAAC,EAAE;QACR,KAAK,EAAE,MAAM,CAAA;QACb,KAAK,EAAE,MAAM,CAAA;QACb,UAAU,CAAC,EAAE,MAAM,CAAA;KACnB,CAAA;IACD,OAAO,CAAC,EAAE,KAAK,CAAC;QACf,MAAM,EAAE,MAAM,CAAA;QACd,MAAM,EAAE,MAAM,CAAA;QACd,IAAI,CAAC,EAAE,MAAM,CAAA;QACb,aAAa,CAAC,EAAE,MAAM,CAAA;KACtB,CAAC,CAAA;IACF,QAAQ,CAAC,EAAE,cAAc,EAAE,CAAA;IAC3B,SAAS,CAAC,EAAE,cAAc,GAAG,eAAe,GAAG,sBAAsB,CAAA;CACrE;AAED,MAAM,WAAW,kBAAkB;IAClC,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAAA;CAC1C;AAOD,MAAM,MAAM,aAAa,GAAG,QAAQ,GAAG,SAAS,CAAA;AAEhD,MAAM,WAAW,WAAW;IAE3B,GAAG,EAAE,MAAM,CAAA;IACX,KAAK,EAAE,MAAM,CAAA;IACb,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,OAAO,CAAC,EAAE,aAAa,EAAE,CAAA;IAGzB,KAAK,CAAC,EAAE,YAAY,CAAA;IACpB,cAAc,CAAC,EAAE,kBAAkB,CAAA;IAGnC,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,gBAAgB,CAAC,EAAE,sBAAsB,EAAE,CAAA;IAG3C,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,oBAAoB,CAAC,EAAE,KAAK,GAAG,IAAI,CAAA;IACnC,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAA;IAGvB,MAAM,CAAC,EAAE,aAAa,CAAA;IACtB,gBAAgB,CAAC,EAAE,OAAO,CAAA;IAC1B,aAAa,CAAC,EAAE,OAAO,CAAA;IACvB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,mBAAmB,CAAC,EAAE,OAAO,CAAA;IAC7B,kBAAkB,CAAC,EAAE,MAAM,CAAA;IAG3B,OAAO,CAAC,EAAE,cAAc,CAAA;IAGxB,GAAG,CAAC,EAAE,KAAK,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;IACjD,UAAU,CAAC,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;IAClE,KAAK,CAAC,EAAE;QACP,YAAY,EAAE,MAAM,CAAA;QACpB,QAAQ,EAAE,MAAM,CAAA;QAChB,UAAU,CAAC,EAAE,MAAM,CAAA;QACnB,QAAQ,CAAC,EAAE,MAAM,CAAA;KACjB,CAAA;CACD;AAID,MAAM,MAAM,WAAW,GAAG,UAAU,GAAG,OAAO,GAAG,QAAQ,GAAG,UAAU,GAAG,SAAS,CAAA;AAElF,MAAM,WAAW,qBAAqB;IACrC,IAAI,EAAE,WAAW,CAAA;IACjB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAA;CAChB;AAED,MAAM,MAAM,eAAe,GAAG,CAC7B,MAAM,EAAE,qBAAqB,EAC7B,OAAO,EAAE,UAAU,KACf,OAAO,CAAC,WAAW,EAAE,CAAC,CAAA;AAM3B,MAAM,MAAM,YAAY,GACrB,uBAAuB,GACvB,oBAAoB,GACpB,sBAAsB,GACtB,WAAW,CAAA;AAKd,MAAM,MAAM,oBAAoB,GAAG,MAAM,GAAG,QAAQ,GAAG,aAAa,CAAA;AAIpE,MAAM,WAAW,OAAO;IACvB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAA;CACrB;AAED,MAAM,WAAW,aAAa;IAC7B,GAAG,EAAE,WAAW,CAAA;IAChB,IAAI,EAAE,MAAM,CAAA;CACZ;AAED,MAAM,WAAW,YAAY;IAC5B,GAAG,EAAE,WAAW,CAAA;IAChB,QAAQ,EAAE,MAAM,CAAA;IAChB,IAAI,EAAE,MAAM,CAAA;CACZ;AAID,MAAM,MAAM,YAAY,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA"}

package/dist/utils/aeo-summary.d.ts

@@ -0,0 +1,35 @@
+import type { ContentItem } from '../types.js';
+export interface GenerateSummaryTwinOptions {
+    publisherName: string;
+    schemaType: string;
+    /** Full article body in markdown (used by tiers 2 and 3 when item.summary is absent). */
+    content?: string;
+    /** URL of the full twin for the `fullUrl` frontmatter cross-link. */
+    fullUrl: string;
+    /** Target cap in tokens. Default 400; hard ceiling. */
+    maxTokens?: number;
+    /** Emits a build-time warning callback when tier-4 fallback fires (spec 1483). */
+    onMinimalFallback?: (item: ContentItem) => void;
+}
+export interface GenerateSummaryTwinResult {
+    markdown: string;
+    tier: 1 | 2 | 3 | 4;
+}
+/**
+ * Generate a summary twin for a ContentItem via the 4-tier fallback chain
+ * (spec "Summary twin"):
+ *
+ *   1. item.summary (consumer-provided) — used verbatim.
+ *   2. Bullet-list extraction from the article body — 3-5 claims pulled from
+ *      top-level `- ` / `* ` list items.
+ *   3. Narrative fallback — description + first sentence of each `## section`
+ *      (max 5) + final sentence of article as conclusion.
+ *   4. Minimal — description only. NO frontmatter flag (LLMs would propagate it
+ *      into user-visible citations per v5 review). Build-time telemetry only,
+ *      via the onMinimalFallback callback.
+ *
+ * The returned markdown includes frontmatter: `type: summary`, `title`, `url`,
+ * `fullUrl`, `datePublished`/`dateModified` if set. First-match wins.
+ */
+export declare function generateSummaryTwin(item: ContentItem, options: GenerateSummaryTwinOptions): GenerateSummaryTwinResult;
+//# sourceMappingURL=aeo-summary.d.ts.map

package/dist/utils/aeo-summary.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"aeo-summary.d.ts","sourceRoot":"","sources":["../../src/utils/aeo-summary.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AAK9C,MAAM,WAAW,0BAA0B;IAC1C,aAAa,EAAE,MAAM,CAAA;IACrB,UAAU,EAAE,MAAM,CAAA;IAClB,yFAAyF;IACzF,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,qEAAqE;IACrE,OAAO,EAAE,MAAM,CAAA;IACf,uDAAuD;IACvD,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,kFAAkF;IAClF,iBAAiB,CAAC,EAAE,CAAC,IAAI,EAAE,WAAW,KAAK,IAAI,CAAA;CAC/C;AAED,MAAM,WAAW,yBAAyB;IACzC,QAAQ,EAAE,MAAM,CAAA;IAChB,IAAI,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;CACnB;AAID;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,mBAAmB,CAClC,IAAI,EAAE,WAAW,EACjB,OAAO,EAAE,0BAA0B,GACjC,yBAAyB,CAU3B"}

package/dist/utils/aeo-summary.js

@@ -0,0 +1,141 @@
+import { estimateTokenCount } from './aeo.js';
+const DEFAULT_MAX_TOKENS = 400;
+/**
+ * Generate a summary twin for a ContentItem via the 4-tier fallback chain
+ * (spec "Summary twin"):
+ *
+ *   1. item.summary (consumer-provided) — used verbatim.
+ *   2. Bullet-list extraction from the article body — 3-5 claims pulled from
+ *      top-level `- ` / `* ` list items.
+ *   3. Narrative fallback — description + first sentence of each `## section`
+ *      (max 5) + final sentence of article as conclusion.
+ *   4. Minimal — description only. NO frontmatter flag (LLMs would propagate it
+ *      into user-visible citations per v5 review). Build-time telemetry only,
+ *      via the onMinimalFallback callback.
+ *
+ * The returned markdown includes frontmatter: `type: summary`, `title`, `url`,
+ * `fullUrl`, `datePublished`/`dateModified` if set. First-match wins.
+ */
+export function generateSummaryTwin(item, options) {
+    const maxTokens = options.maxTokens ?? DEFAULT_MAX_TOKENS;
+    const { body, tier } = pickBody(item, options.content, options.onMinimalFallback);
+    const capped = capToTokens(body, maxTokens);
+    const fm = buildFrontmatter(item, options);
+    const markdown = `---\n${fm}\n---\n\n${capped}`;
+    return { markdown, tier };
+}
+// ─── Internals ───
+function pickBody(item, content, onMinimalFallback) {
+    // Tier 1: explicit summary
+    if (item.summary && item.summary.trim().length > 0) {
+        return { body: item.summary.trim(), tier: 1 };
+    }
+    // Tier 2: bullet-list extraction
+    if (content) {
+        const bullets = extractTopLevelBullets(content);
+        if (bullets.length >= 3) {
+            const selected = bullets.slice(0, 5);
+            const lede = item.description?.trim() ?? item.title;
+            return {
+                body: `${lede}\n\n${selected.map((b) => `- ${b}`).join('\n')}`,
+                tier: 2,
+            };
+        }
+    }
+    // Tier 3: narrative fallback
+    if (content) {
+        const sectionFirsts = extractFirstSentencePerSection(content).slice(0, 5);
+        const lastSentence = extractLastSentence(content);
+        const lede = item.description?.trim();
+        const narrativeParts = [];
+        if (lede)
+            narrativeParts.push(lede);
+        if (sectionFirsts.length > 0) {
+            narrativeParts.push(sectionFirsts.map((s) => `- ${s}`).join('\n'));
+        }
+        if (lastSentence)
+            narrativeParts.push(lastSentence);
+        const narrative = narrativeParts.join('\n\n');
+        if (narrative.length >= 100) {
+            return { body: narrative, tier: 3 };
+        }
+    }
+    // Tier 4: minimal fallback
+    onMinimalFallback?.(item);
+    return { body: item.description ?? item.title, tier: 4 };
+}
+function extractTopLevelBullets(md) {
+    const out = [];
+    // Match top-level (no leading whitespace) `- ` or `* ` bullets.
+    const re = /^[ \t]*(?:[-*])\s+(.+)$/gm;
+    let m = re.exec(md);
+    while (m !== null) {
+        const line = m[1]?.trim();
+        if (line && line.length > 0)
+            out.push(line);
+        m = re.exec(md);
+    }
+    return out;
+}
+function extractFirstSentencePerSection(md) {
+    const out = [];
+    // Split on `## ` headings; skip the heading line itself and find first sentence of body.
+    const sections = md.split(/^## .+$/gm).slice(1);
+    for (const section of sections) {
+        const firstPara = section
+            .split(/\n{2,}/)
+            .map((p) => p.trim())
+            .find((p) => p.length > 0 && !p.startsWith('#'));
+        if (firstPara) {
+            const sentence = firstSentence(firstPara);
+            if (sentence)
+                out.push(sentence);
+        }
+    }
+    return out;
+}
+function extractLastSentence(md) {
+    // Take the last non-empty paragraph, pick its last sentence.
+    const paras = md
+        .split(/\n{2,}/)
+        .map((p) => p.trim())
+        .filter((p) => p.length > 0 && !p.startsWith('#'));
+    const lastPara = paras[paras.length - 1];
+    if (!lastPara)
+        return undefined;
+    const sentences = lastPara.split(/(?<=[.!?])\s+/);
+    return sentences[sentences.length - 1]?.trim();
+}
+function firstSentence(text) {
+    const match = /^(.+?[.!?])(?:\s|$)/.exec(text);
+    return match?.[1]?.trim() ?? text.split('\n')[0]?.trim();
+}
+function capToTokens(body, maxTokens) {
+    if (estimateTokenCount(body) <= maxTokens)
+        return body;
+    const maxChars = maxTokens * 4;
+    return `${body.slice(0, maxChars).trimEnd()}…`;
+}
+function buildFrontmatter(item, options) {
+    const lines = [];
+    lines.push(`type: summary`);
+    lines.push(`title: ${yv(item.title)}`);
+    lines.push(`url: ${yv(`${options.fullUrl}.summary.md`)}`);
+    lines.push(`fullUrl: ${yv(options.fullUrl)}`);
+    if (item.datePublished)
+        lines.push(`datePublished: ${yv(item.datePublished)}`);
+    if (item.dateModified)
+        lines.push(`dateModified: ${yv(item.dateModified)}`);
+    lines.push(`publisher: ${yv(options.publisherName)}`);
+    lines.push(`schemaType: ${yv(options.schemaType)}`);
+    return lines.join('\n');
+}
+function yv(v) {
+    const isUrl = /^https?:\/\//.test(v);
+    const isDate = /^\d{4}-\d{2}-\d{2}/.test(v);
+    const needsQuotes = /[#{}[\],&*?|>!%@`'"\n]/.test(v) || (v.includes(':') && !isUrl && !isDate);
+    if (!needsQuotes)
+        return v;
+    return `"${v.replace(/\\/g, '\\\\').replace(/"/g, '\\"').replace(/\n/g, '\\n')}"`;
+}
+//# sourceMappingURL=aeo-summary.js.map

package/dist/utils/aeo-summary.js.map

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