@hale-bopp/valentino-engine 1.0.0 → 2.1.0

package/dist/core/extension-registry.js

@@ -0,0 +1,62 @@
+/** Create a fresh, empty registry. */
+export function createExtensionRegistry() {
+    return {
+        sectionRenderers: new Map(),
+        guardrails: new Map(),
+        customStatuses: new Set(),
+        contentResolver: null,
+        mediaResolver: null,
+        editorPanels: new Map(),
+    };
+}
+// ---------------------------------------------------------------------------
+// Registration API
+// ---------------------------------------------------------------------------
+/** Register a custom section renderer for a given section type. */
+export function registerSectionRenderer(registry, sectionType, renderer) {
+    registry.sectionRenderers.set(sectionType, renderer);
+}
+/** Register a custom guardrail rule. */
+export function registerGuardrail(registry, name, guardrail) {
+    registry.guardrails.set(name, guardrail);
+}
+/** Register a custom page status value beyond draft/published/scheduled. */
+export function registerCustomStatus(registry, status) {
+    registry.customStatuses.add(status);
+}
+/** Set the content resolver (replaces any existing one). */
+export function setContentResolver(registry, resolver) {
+    registry.contentResolver = resolver;
+}
+/** Set the media resolver (replaces any existing one). */
+export function setMediaResolver(registry, resolver) {
+    registry.mediaResolver = resolver;
+}
+/** Register an editor panel for specific section types. */
+export function registerEditorPanel(registry, panel) {
+    registry.editorPanels.set(panel.id, panel);
+}
+// ---------------------------------------------------------------------------
+// Query API
+// ---------------------------------------------------------------------------
+/** Check if a section type has a custom renderer. */
+export function hasCustomRenderer(registry, sectionType) {
+    return registry.sectionRenderers.has(sectionType);
+}
+/** Get a custom renderer for a section type (or undefined). */
+export function getCustomRenderer(registry, sectionType) {
+    return registry.sectionRenderers.get(sectionType);
+}
+/** Run all custom guardrails and return combined warnings. */
+export function runCustomGuardrails(registry, context) {
+    const warnings = [];
+    for (const guardrail of registry.guardrails.values()) {
+        warnings.push(...guardrail(context));
+    }
+    return warnings;
+}
+/** Get editor panels applicable to a given section type. */
+export function getEditorPanels(registry, sectionType) {
+    return [...registry.editorPanels.values()].filter((p) => p.sectionTypes.includes(sectionType));
+}
+//# sourceMappingURL=extension-registry.js.map

package/dist/core/extension-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"extension-registry.js","sourceRoot":"","sources":["../../src/core/extension-registry.ts"],"names":[],"mappings":"AAsDA,sCAAsC;AACtC,MAAM,UAAU,uBAAuB;IACnC,OAAO;QACH,gBAAgB,EAAE,IAAI,GAAG,EAAE;QAC3B,UAAU,EAAE,IAAI,GAAG,EAAE;QACrB,cAAc,EAAE,IAAI,GAAG,EAAE;QACzB,eAAe,EAAE,IAAI;QACrB,aAAa,EAAE,IAAI;QACnB,YAAY,EAAE,IAAI,GAAG,EAAE;KAC1B,CAAC;AACN,CAAC;AAED,8EAA8E;AAC9E,mBAAmB;AACnB,8EAA8E;AAE9E,mEAAmE;AACnE,MAAM,UAAU,uBAAuB,CACnC,QAA2B,EAC3B,WAAmB,EACnB,QAA+B;IAE/B,QAAQ,CAAC,gBAAgB,CAAC,GAAG,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC;AACzD,CAAC;AAED,wCAAwC;AACxC,MAAM,UAAU,iBAAiB,CAC7B,QAA2B,EAC3B,IAAY,EACZ,SAA0B;IAE1B,QAAQ,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;AAC7C,CAAC;AAED,4EAA4E;AAC5E,MAAM,UAAU,oBAAoB,CAChC,QAA2B,EAC3B,MAAc;IAEd,QAAQ,CAAC,cAAc,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;AACxC,CAAC;AAED,4DAA4D;AAC5D,MAAM,UAAU,kBAAkB,CAC9B,QAA2B,EAC3B,QAAyB;IAEzB,QAAQ,CAAC,eAAe,GAAG,QAAQ,CAAC;AACxC,CAAC;AAED,0DAA0D;AAC1D,MAAM,UAAU,gBAAgB,CAC5B,QAA2B,EAC3B,QAAuB;IAEvB,QAAQ,CAAC,aAAa,GAAG,QAAQ,CAAC;AACtC,CAAC;AAED,2DAA2D;AAC3D,MAAM,UAAU,mBAAmB,CAC/B,QAA2B,EAC3B,KAAqB;IAErB,QAAQ,CAAC,YAAY,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC;AAC/C,CAAC;AAED,8EAA8E;AAC9E,YAAY;AACZ,8EAA8E;AAE9E,qDAAqD;AACrD,MAAM,UAAU,iBAAiB,CAAC,QAA2B,EAAE,WAAmB;IAC9E,OAAO,QAAQ,CAAC,gBAAgB,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;AACtD,CAAC;AAED,+DAA+D;AAC/D,MAAM,UAAU,iBAAiB,CAAC,QAA2B,EAAE,WAAmB;IAC9E,OAAO,QAAQ,CAAC,gBAAgB,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;AACtD,CAAC;AAED,8DAA8D;AAC9D,MAAM,UAAU,mBAAmB,CAAC,QAA2B,EAAE,OAAyB;IACtF,MAAM,QAAQ,GAAiB,EAAE,CAAC;IAClC,KAAK,MAAM,SAAS,IAAI,QAAQ,CAAC,UAAU,CAAC,MAAM,EAAE,EAAE,CAAC;QACnD,QAAQ,CAAC,IAAI,CAAC,GAAG,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC;IACzC,CAAC;IACD,OAAO,QAAQ,CAAC;AACpB,CAAC;AAED,4DAA4D;AAC5D,MAAM,UAAU,eAAe,CAAC,QAA2B,EAAE,WAAmB;IAC5E,OAAO,CAAC,GAAG,QAAQ,CAAC,YAAY,CAAC,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,YAAY,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC,CAAC;AACnG,CAAC"}

package/dist/core/guardrails-cms.d.ts

@@ -0,0 +1,70 @@
+/**
+ * CMS Guardrails — Pure validation rules for CMS capabilities.
+ * Migrated from easyway-portal scripts/guardrails-cms.mjs (PBI #606).
+ * Extended with media, language, breadcrumb, and route checks (PBI #605).
+ * No I/O (no fs, no fetch) — works on pre-loaded data only.
+ */
+import type { PagesManifestV1 } from './types.js';
+import type { RedirectRule } from './redirects.js';
+import type { SeoSpec } from './seo.js';
+import type { MediaManifest } from './media.js';
+export type CmsWarning = {
+    type: string;
+    severity: 'warning' | 'error';
+    file: string;
+    message: string;
+};
+/** Warn about draft pages without a scheduled publishAt date. */
+export declare function checkDraftOrphans(manifest: PagesManifestV1): CmsWarning[];
+/** Validate publishAt dates: format and coherence with status. */
+export declare function checkPublishAtCoherence(manifest: PagesManifestV1): CmsWarning[];
+/** Warn if maintenanceMode is active. */
+export declare function checkMaintenanceModeLeak(manifest: PagesManifestV1): CmsWarning[];
+/** Error if no "not-found" page exists in manifest. */
+export declare function check404Exists(manifest: PagesManifestV1): CmsWarning[];
+/** Validate redirect rules: target exists, no chains. */
+export declare function checkRedirects(manifest: PagesManifestV1, rules: RedirectRule[]): CmsWarning[];
+/**
+ * Check that navigable published pages have SEO metadata.
+ * Requires pre-loaded specs (the consumer handles I/O).
+ */
+export declare function checkSeoCompleteness(manifest: PagesManifestV1, specsById: Map<string, {
+    seo?: SeoSpec;
+}>): CmsWarning[];
+/**
+ * Check that ogImage in page specs references an existing media key.
+ * Requires pre-loaded specs and media manifest.
+ */
+export declare function checkOgImageExists(specsById: Map<string, {
+    seo?: SeoSpec;
+}>, mediaManifest: MediaManifest): CmsWarning[];
+/**
+ * Find media assets not referenced by any page spec.
+ * Scans all spec sections for media keys in known fields.
+ */
+export declare function checkMediaOrphans(specsById: Map<string, {
+    seo?: SeoSpec;
+    sections?: Array<Record<string, any>>;
+}>, mediaManifest: MediaManifest): CmsWarning[];
+/** Warn about media assets without alt text (accessibility). */
+export declare function checkMediaMissingAlt(mediaManifest: MediaManifest): CmsWarning[];
+/** Warn about pages with deep routes (3+ segments) that may need intermediate breadcrumb pages. */
+export declare function checkBreadcrumbDepth(manifest: PagesManifestV1): CmsWarning[];
+/**
+ * Check language coverage: keys in one language map missing from another.
+ * Accepts flattened key sets (consumer handles the JSON loading/flattening).
+ */
+export declare function checkLanguageCoverage(contentByLang: Map<string, Set<string>>): CmsWarning[];
+/** Error if manifest has duplicate routes. */
+export declare function checkDuplicateRoutes(manifest: PagesManifestV1): CmsWarning[];
+/** Run all pure CMS guardrails. Returns combined warnings. */
+export declare function collectPureCmsWarnings(manifest: PagesManifestV1, options?: {
+    redirectRules?: RedirectRule[];
+    specsById?: Map<string, {
+        seo?: SeoSpec;
+        sections?: Array<Record<string, any>>;
+    }>;
+    mediaManifest?: MediaManifest;
+    contentByLang?: Map<string, Set<string>>;
+}): CmsWarning[];
+//# sourceMappingURL=guardrails-cms.d.ts.map

package/dist/core/guardrails-cms.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"guardrails-cms.d.ts","sourceRoot":"","sources":["../../src/core/guardrails-cms.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAkB,eAAe,EAAE,MAAM,YAAY,CAAC;AAClE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AACxC,OAAO,KAAK,EAAc,aAAa,EAAE,MAAM,YAAY,CAAC;AAE5D,MAAM,MAAM,UAAU,GAAG;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,SAAS,GAAG,OAAO,CAAC;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,iEAAiE;AACjE,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,eAAe,GAAG,UAAU,EAAE,CAazE;AAED,kEAAkE;AAClE,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,eAAe,GAAG,UAAU,EAAE,CAyB/E;AAED,yCAAyC;AACzC,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,eAAe,GAAG,UAAU,EAAE,CAUhF;AAED,uDAAuD;AACvD,wBAAgB,cAAc,CAAC,QAAQ,EAAE,eAAe,GAAG,UAAU,EAAE,CAWtE;AAED,yDAAyD;AACzD,wBAAgB,cAAc,CAAC,QAAQ,EAAE,eAAe,EAAE,KAAK,EAAE,YAAY,EAAE,GAAG,UAAU,EAAE,CAyB7F;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAChC,QAAQ,EAAE,eAAe,EACzB,SAAS,EAAE,GAAG,CAAC,MAAM,EAAE;IAAE,GAAG,CAAC,EAAE,OAAO,CAAA;CAAE,CAAC,GAC1C,UAAU,EAAE,CAsBd;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAC9B,SAAS,EAAE,GAAG,CAAC,MAAM,EAAE;IAAE,GAAG,CAAC,EAAE,OAAO,CAAA;CAAE,CAAC,EACzC,aAAa,EAAE,aAAa,GAC7B,UAAU,EAAE,CAmBd;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAC7B,SAAS,EAAE,GAAG,CAAC,MAAM,EAAE;IAAE,GAAG,CAAC,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,CAAA;CAAE,CAAC,EAChF,aAAa,EAAE,aAAa,GAC7B,UAAU,EAAE,CAiCd;AAED,gEAAgE;AAChE,wBAAgB,oBAAoB,CAAC,aAAa,EAAE,aAAa,GAAG,UAAU,EAAE,CAa/E;AAED,mGAAmG;AACnG,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,eAAe,GAAG,UAAU,EAAE,CAmB5E;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CACjC,aAAa,EAAE,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC,GACxC,UAAU,EAAE,CAkCd;AAED,8CAA8C;AAC9C,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,eAAe,GAAG,UAAU,EAAE,CAkB5E;AAED,8DAA8D;AAC9D,wBAAgB,sBAAsB,CAClC,QAAQ,EAAE,eAAe,EACzB,OAAO,CAAC,EAAE;IACN,aAAa,CAAC,EAAE,YAAY,EAAE,CAAC;IAC/B,SAAS,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE;QAAE,GAAG,CAAC,EAAE,OAAO,CAAC;QAAC,QAAQ,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,CAAA;KAAE,CAAC,CAAC;IAClF,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,aAAa,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC;CAC5C,GACF,UAAU,EAAE,CAed"}

package/dist/core/guardrails-cms.js

@@ -0,0 +1,299 @@
+/** Warn about draft pages without a scheduled publishAt date. */
+export function checkDraftOrphans(manifest) {
+    const warnings = [];
+    for (const page of manifest.pages) {
+        if (page.status !== 'draft')
+            continue;
+        if (page.publishAt)
+            continue;
+        warnings.push({
+            type: 'cms-draft-orphan',
+            severity: 'warning',
+            file: 'pages.manifest.json',
+            message: `Page "${page.id}" is draft without publishAt — consider setting a publish date or removing it`,
+        });
+    }
+    return warnings;
+}
+/** Validate publishAt dates: format and coherence with status. */
+export function checkPublishAtCoherence(manifest) {
+    const warnings = [];
+    const now = new Date();
+    for (const page of manifest.pages) {
+        if (!page.publishAt)
+            continue;
+        const d = new Date(page.publishAt);
+        if (isNaN(d.getTime())) {
+            warnings.push({
+                type: 'cms-publishat-invalid',
+                severity: 'error',
+                file: 'pages.manifest.json',
+                message: `Page "${page.id}" has invalid publishAt: "${page.publishAt}"`,
+            });
+            continue;
+        }
+        if (d < now && page.status !== 'published' && page.status !== undefined) {
+            warnings.push({
+                type: 'cms-publishat-past',
+                severity: 'warning',
+                file: 'pages.manifest.json',
+                message: `Page "${page.id}" has publishAt in the past (${page.publishAt}) but status is "${page.status}" — should be "published"?`,
+            });
+        }
+    }
+    return warnings;
+}
+/** Warn if maintenanceMode is active. */
+export function checkMaintenanceModeLeak(manifest) {
+    if (manifest.maintenanceMode === true) {
+        return [{
+                type: 'cms-maintenance-mode-active',
+                severity: 'warning',
+                file: 'pages.manifest.json',
+                message: 'maintenanceMode is TRUE — all pages will show maintenance screen in production. Intentional?',
+            }];
+    }
+    return [];
+}
+/** Error if no "not-found" page exists in manifest. */
+export function check404Exists(manifest) {
+    const has404 = manifest.pages.some((p) => p.id === 'not-found');
+    if (!has404) {
+        return [{
+                type: 'cms-no-404-page',
+                severity: 'error',
+                file: 'pages.manifest.json',
+                message: 'No "not-found" page in manifest — users hitting invalid URLs will see plain text',
+            }];
+    }
+    return [];
+}
+/** Validate redirect rules: target exists, no chains. */
+export function checkRedirects(manifest, rules) {
+    const warnings = [];
+    if (!rules.length)
+        return warnings;
+    const validRoutes = new Set(manifest.pages.map((p) => p.route));
+    for (const rule of rules) {
+        if (!validRoutes.has(rule.to)) {
+            warnings.push({
+                type: 'cms-redirect-target-missing',
+                severity: 'error',
+                file: 'redirects.json',
+                message: `Redirect "${rule.from}" → "${rule.to}" targets a non-existent route`,
+            });
+        }
+        const chainTarget = rules.find((r) => r.from === rule.to);
+        if (chainTarget) {
+            warnings.push({
+                type: 'cms-redirect-chain',
+                severity: 'warning',
+                file: 'redirects.json',
+                message: `Redirect chain: "${rule.from}" → "${rule.to}" → "${chainTarget.to}"`,
+            });
+        }
+    }
+    return warnings;
+}
+/**
+ * Check that navigable published pages have SEO metadata.
+ * Requires pre-loaded specs (the consumer handles I/O).
+ */
+export function checkSeoCompleteness(manifest, specsById) {
+    const warnings = [];
+    const skipIds = new Set(['not-found', 'maintenance', 'editor', 'templates']);
+    for (const page of manifest.pages) {
+        if (!page.nav)
+            continue;
+        if (page.status === 'draft')
+            continue;
+        if (page.id.startsWith('pag-work-'))
+            continue;
+        if (skipIds.has(page.id))
+            continue;
+        const spec = specsById.get(page.id);
+        if (!spec)
+            continue;
+        if (!spec.seo || (!spec.seo.metaTitle && !spec.seo.metaDescription)) {
+            warnings.push({
+                type: 'cms-seo-missing',
+                severity: 'warning',
+                file: page.spec,
+                message: `Page "${page.id}" has navigation but no SEO block — add seo.metaTitle and seo.metaDescription`,
+            });
+        }
+    }
+    return warnings;
+}
+/**
+ * Check that ogImage in page specs references an existing media key.
+ * Requires pre-loaded specs and media manifest.
+ */
+export function checkOgImageExists(specsById, mediaManifest) {
+    const warnings = [];
+    const mediaKeys = new Set(mediaManifest.assets.map((a) => a.key));
+    for (const [pageId, spec] of specsById) {
+        const ogImage = spec.seo?.ogImage;
+        if (!ogImage)
+            continue;
+        // Skip if it looks like a path/URL (only validate media key references)
+        if (ogImage.includes('/') || ogImage.includes('.'))
+            continue;
+        if (!mediaKeys.has(ogImage)) {
+            warnings.push({
+                type: 'cms-og-image-missing',
+                severity: 'warning',
+                file: `/pages/${pageId}.json`,
+                message: `Page "${pageId}" has seo.ogImage="${ogImage}" but no matching media asset found`,
+            });
+        }
+    }
+    return warnings;
+}
+/**
+ * Find media assets not referenced by any page spec.
+ * Scans all spec sections for media keys in known fields.
+ */
+export function checkMediaOrphans(specsById, mediaManifest) {
+    const warnings = [];
+    if (!mediaManifest.assets.length)
+        return warnings;
+    // Collect all referenced media keys from specs
+    const referencedKeys = new Set();
+    for (const [, spec] of specsById) {
+        // OG image
+        if (spec.seo?.ogImage)
+            referencedKeys.add(spec.seo.ogImage);
+        // Scan sections for common media fields
+        for (const section of spec.sections ?? []) {
+            const json = JSON.stringify(section);
+            for (const asset of mediaManifest.assets) {
+                if (json.includes(asset.key) || json.includes(asset.file)) {
+                    referencedKeys.add(asset.key);
+                }
+            }
+        }
+    }
+    for (const asset of mediaManifest.assets) {
+        if (!referencedKeys.has(asset.key)) {
+            warnings.push({
+                type: 'cms-media-orphan',
+                severity: 'warning',
+                file: 'media.manifest.json',
+                message: `Media asset "${asset.key}" (${asset.file}) is not referenced by any page spec`,
+            });
+        }
+    }
+    return warnings;
+}
+/** Warn about media assets without alt text (accessibility). */
+export function checkMediaMissingAlt(mediaManifest) {
+    const warnings = [];
+    for (const asset of mediaManifest.assets) {
+        if (!asset.alt || !asset.alt.trim()) {
+            warnings.push({
+                type: 'cms-media-missing-alt',
+                severity: 'warning',
+                file: 'media.manifest.json',
+                message: `Media asset "${asset.key}" has no alt text — accessibility issue`,
+            });
+        }
+    }
+    return warnings;
+}
+/** Warn about pages with deep routes (3+ segments) that may need intermediate breadcrumb pages. */
+export function checkBreadcrumbDepth(manifest) {
+    const warnings = [];
+    const routes = new Set(manifest.pages.map((p) => p.route));
+    for (const page of manifest.pages) {
+        const segments = page.route.split('/').filter(Boolean);
+        if (segments.length < 3)
+            continue;
+        // Check if parent route exists
+        const parentRoute = '/' + segments.slice(0, -1).join('/');
+        if (!routes.has(parentRoute)) {
+            warnings.push({
+                type: 'cms-breadcrumb-depth',
+                severity: 'warning',
+                file: 'pages.manifest.json',
+                message: `Page "${page.id}" has deep route "${page.route}" but parent "${parentRoute}" doesn't exist — breadcrumb will have gaps`,
+            });
+        }
+    }
+    return warnings;
+}
+/**
+ * Check language coverage: keys in one language map missing from another.
+ * Accepts flattened key sets (consumer handles the JSON loading/flattening).
+ */
+export function checkLanguageCoverage(contentByLang) {
+    const warnings = [];
+    const langs = [...contentByLang.keys()];
+    for (let i = 0; i < langs.length; i++) {
+        for (let j = i + 1; j < langs.length; j++) {
+            const langA = langs[i];
+            const langB = langs[j];
+            const keysA = contentByLang.get(langA);
+            const keysB = contentByLang.get(langB);
+            for (const key of keysA) {
+                if (!keysB.has(key)) {
+                    warnings.push({
+                        type: 'cms-language-coverage',
+                        severity: 'warning',
+                        file: `content/${langA}.json`,
+                        message: `Key "${key}" exists in ${langA.toUpperCase()} but not in ${langB.toUpperCase()}`,
+                    });
+                }
+            }
+            for (const key of keysB) {
+                if (!keysA.has(key)) {
+                    warnings.push({
+                        type: 'cms-language-coverage',
+                        severity: 'warning',
+                        file: `content/${langB}.json`,
+                        message: `Key "${key}" exists in ${langB.toUpperCase()} but not in ${langA.toUpperCase()}`,
+                    });
+                }
+            }
+        }
+    }
+    return warnings;
+}
+/** Error if manifest has duplicate routes. */
+export function checkDuplicateRoutes(manifest) {
+    const warnings = [];
+    const seen = new Map();
+    for (const page of manifest.pages) {
+        const existing = seen.get(page.route);
+        if (existing) {
+            warnings.push({
+                type: 'cms-duplicate-route',
+                severity: 'error',
+                file: 'pages.manifest.json',
+                message: `Route "${page.route}" is claimed by both "${existing}" and "${page.id}"`,
+            });
+        }
+        else {
+            seen.set(page.route, page.id);
+        }
+    }
+    return warnings;
+}
+/** Run all pure CMS guardrails. Returns combined warnings. */
+export function collectPureCmsWarnings(manifest, options) {
+    return [
+        ...checkDraftOrphans(manifest),
+        ...checkPublishAtCoherence(manifest),
+        ...checkMaintenanceModeLeak(manifest),
+        ...check404Exists(manifest),
+        ...checkDuplicateRoutes(manifest),
+        ...checkBreadcrumbDepth(manifest),
+        ...checkRedirects(manifest, options?.redirectRules ?? []),
+        ...(options?.specsById ? checkSeoCompleteness(manifest, options.specsById) : []),
+        ...(options?.specsById && options?.mediaManifest ? checkOgImageExists(options.specsById, options.mediaManifest) : []),
+        ...(options?.specsById && options?.mediaManifest ? checkMediaOrphans(options.specsById, options.mediaManifest) : []),
+        ...(options?.mediaManifest ? checkMediaMissingAlt(options.mediaManifest) : []),
+        ...(options?.contentByLang ? checkLanguageCoverage(options.contentByLang) : []),
+    ];
+}
+//# sourceMappingURL=guardrails-cms.js.map

package/dist/core/guardrails-cms.js.map

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

package/dist/core/hero-contract.js

@@ -18,10 +18,10 @@ export function probeHeroContract(hero) {
         ctaCount++;
     if (hero.ctaTertiary)
         ctaCount++;
-    if (ctaCount > 3) {
+    if (ctaCount > 2) {
         warnings.push({
             rule: 'cta-discipline',
-            message: `Hero has ${ctaCount} CTAs — maximum is 3.`,
+            message: `Hero has ${ctaCount} CTAs — maximum recommended is 2 (primary + secondary).`,
         });
     }
     // Rule 2: Single decorative source

package/dist/core/hero-contract.js.map

@@ -1 +1 @@
-{"version":3,"file":"hero-contract.js","sourceRoot":"","sources":["../../src/core/hero-contract.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAcH;;;;;GAKG;AACH,MAAM,UAAU,iBAAiB,CAAC,IAAiB;IAC/C,MAAM,QAAQ,GAA0B,EAAE,CAAC;IAE3C,sCAAsC;IACtC,IAAI,QAAQ,GAAG,CAAC,CAAC;IACjB,IAAI,IAAI,CAAC,GAAG;QAAE,QAAQ,EAAE,CAAC;IACzB,IAAI,IAAI,CAAC,YAAY;QAAE,QAAQ,EAAE,CAAC;IAClC,IAAI,IAAI,CAAC,WAAW;QAAE,QAAQ,EAAE,CAAC;IACjC,IAAI,QAAQ,GAAG,CAAC,EAAE,CAAC;QACf,QAAQ,CAAC,IAAI,CAAC;YACV,IAAI,EAAE,gBAAgB;YACtB,OAAO,EAAE,YAAY,QAAQ,uBAAuB;SACvD,CAAC,CAAC;IACP,CAAC;IAED,mCAAmC;IACnC,MAAM,cAAc,GAAG,CAAC,CAAC,IAAI,CAAC,eAAe,CAAC;IAC9C,MAAM,cAAc,GAAG,CAAC,CAAC,IAAI,CAAC,YAAY,EAAE,WAAW,IAAI,IAAI,CAAC,YAAY,CAAC,WAAW,KAAK,MAAM,CAAC;IACpG,IAAI,cAAc,IAAI,cAAc,EAAE,CAAC;QACnC,QAAQ,CAAC,IAAI,CAAC;YACV,IAAI,EAAE,0BAA0B;YAChC,OAAO,EAAE,iFAAiF;SAC7F,CAAC,CAAC;IACP,CAAC;IAED,4CAA4C;IAC5C,IAAI,WAAW,GAAG,CAAC,CAAC;IACpB,IAAI,IAAI,CAAC,QAAQ;QAAE,WAAW,EAAE,CAAC;IACjC,IAAI,IAAI,CAAC,UAAU;QAAE,WAAW,EAAE,CAAC;IACnC,IAAI,IAAI,CAAC,UAAU;QAAE,WAAW,EAAE,CAAC;IACnC,IAAI,IAAI,CAAC,UAAU;QAAE,WAAW,EAAE,CAAC;IACnC,IAAI,IAAI,CAAC,QAAQ;QAAE,WAAW,EAAE,CAAC;IACjC,IAAI,IAAI,CAAC,cAAc;QAAE,WAAW,EAAE,CAAC;IACvC,IAAI,IAAI,CAAC,mBAAmB;QAAE,WAAW,EAAE,CAAC;IAC5C,IAAI,WAAW,GAAG,CAAC,EAAE,CAAC;QAClB,QAAQ,CAAC,IAAI,CAAC;YACV,IAAI,EAAE,cAAc;YACpB,OAAO,EAAE,YAAY,WAAW,2DAA2D;SAC9F,CAAC,CAAC;IACP,CAAC;IAED,2BAA2B;IAC3B,IAAI,IAAI,CAAC,UAAU,IAAI,IAAI,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAChD,QAAQ,CAAC,IAAI,CAAC;YACV,IAAI,EAAE,oBAAoB;YAC1B,OAAO,EAAE,wBAAwB,IAAI,CAAC,UAAU,CAAC,MAAM,oCAAoC;SAC9F,CAAC,CAAC;IACP,CAAC;IAED,OAAO;QACH,KAAK,EAAE,QAAQ,CAAC,MAAM,KAAK,CAAC;QAC5B,QAAQ;KACX,CAAC;AACN,CAAC"}
+{"version":3,"file":"hero-contract.js","sourceRoot":"","sources":["../../src/core/hero-contract.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAcH;;;;;GAKG;AACH,MAAM,UAAU,iBAAiB,CAAC,IAAiB;IAC/C,MAAM,QAAQ,GAA0B,EAAE,CAAC;IAE3C,sCAAsC;IACtC,IAAI,QAAQ,GAAG,CAAC,CAAC;IACjB,IAAI,IAAI,CAAC,GAAG;QAAE,QAAQ,EAAE,CAAC;IACzB,IAAI,IAAI,CAAC,YAAY;QAAE,QAAQ,EAAE,CAAC;IAClC,IAAI,IAAI,CAAC,WAAW;QAAE,QAAQ,EAAE,CAAC;IACjC,IAAI,QAAQ,GAAG,CAAC,EAAE,CAAC;QACf,QAAQ,CAAC,IAAI,CAAC;YACV,IAAI,EAAE,gBAAgB;YACtB,OAAO,EAAE,YAAY,QAAQ,yDAAyD;SACzF,CAAC,CAAC;IACP,CAAC;IAED,mCAAmC;IACnC,MAAM,cAAc,GAAG,CAAC,CAAC,IAAI,CAAC,eAAe,CAAC;IAC9C,MAAM,cAAc,GAAG,CAAC,CAAC,IAAI,CAAC,YAAY,EAAE,WAAW,IAAI,IAAI,CAAC,YAAY,CAAC,WAAW,KAAK,MAAM,CAAC;IACpG,IAAI,cAAc,IAAI,cAAc,EAAE,CAAC;QACnC,QAAQ,CAAC,IAAI,CAAC;YACV,IAAI,EAAE,0BAA0B;YAChC,OAAO,EAAE,iFAAiF;SAC7F,CAAC,CAAC;IACP,CAAC;IAED,4CAA4C;IAC5C,IAAI,WAAW,GAAG,CAAC,CAAC;IACpB,IAAI,IAAI,CAAC,QAAQ;QAAE,WAAW,EAAE,CAAC;IACjC,IAAI,IAAI,CAAC,UAAU;QAAE,WAAW,EAAE,CAAC;IACnC,IAAI,IAAI,CAAC,UAAU;QAAE,WAAW,EAAE,CAAC;IACnC,IAAI,IAAI,CAAC,UAAU;QAAE,WAAW,EAAE,CAAC;IACnC,IAAI,IAAI,CAAC,QAAQ;QAAE,WAAW,EAAE,CAAC;IACjC,IAAI,IAAI,CAAC,cAAc;QAAE,WAAW,EAAE,CAAC;IACvC,IAAI,IAAI,CAAC,mBAAmB;QAAE,WAAW,EAAE,CAAC;IAC5C,IAAI,WAAW,GAAG,CAAC,EAAE,CAAC;QAClB,QAAQ,CAAC,IAAI,CAAC;YACV,IAAI,EAAE,cAAc;YACpB,OAAO,EAAE,YAAY,WAAW,2DAA2D;SAC9F,CAAC,CAAC;IACP,CAAC;IAED,2BAA2B;IAC3B,IAAI,IAAI,CAAC,UAAU,IAAI,IAAI,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAChD,QAAQ,CAAC,IAAI,CAAC;YACV,IAAI,EAAE,oBAAoB;YAC1B,OAAO,EAAE,wBAAwB,IAAI,CAAC,UAAU,CAAC,MAAM,oCAAoC;SAC9F,CAAC,CAAC;IACP,CAAC;IAED,OAAO;QACH,KAAK,EAAE,QAAQ,CAAC,MAAM,KAAK,CAAC;QAC5B,QAAQ;KACX,CAAC;AACN,CAAC"}

package/dist/core/hero-contract.test.js

@@ -9,14 +9,21 @@ describe('probeHeroContract', () => {
         expect(result.valid).toBe(true);
         expect(result.warnings).toHaveLength(0);
     });
-    it('passes with 3 CTAs', () => {
+    it('passes with 2 CTAs', () => {
         const result = probeHeroContract(makeHero({
             cta: { labelKey: 'c1', action: { type: 'link', href: '/' } },
             ctaSecondary: { labelKey: 'c2', action: { type: 'noop' } },
-            ctaTertiary: { labelKey: 'c3', action: { type: 'noop' } },
         }));
         expect(result.valid).toBe(true);
     });
+    it('warns with 3 CTAs', () => {
+        const result = probeHeroContract(makeHero({
+            cta: { labelKey: 'c1', action: { type: 'link', href: '/' } },
+            ctaSecondary: { labelKey: 'c2', action: { type: 'noop' } },
+            ctaTertiary: { labelKey: 'c3', action: { type: 'noop' } },
+        }));
+        expect(result.warnings).toContainEqual(expect.objectContaining({ rule: 'cta-discipline' }));
+    });
     it('warns on single-decorative-source violation', () => {
         const result = probeHeroContract(makeHero({
             visualAssetPath: '/img/hero.jpg',

package/dist/core/hero-contract.test.js.map

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

package/dist/core/llms-generator.d.ts

@@ -0,0 +1,36 @@
+/**
+ * LLMs.txt Generator — Pure functions to produce llms.txt and llms-full.txt
+ * from a PagesManifest and optional content/spec data.
+ * No I/O — the consumer provides the loaded data.
+ *
+ * llms.txt  = L0 Matrioska (max ~50 lines, site index for LLM agents)
+ * llms-full.txt = L1 Matrioska (detailed per-page breakdown)
+ *
+ * Follows the emerging llms.txt standard (like robots.txt for AI crawlers).
+ */
+import type { PagesManifestV1, PageSpecV1 } from './types.js';
+export type LlmsGeneratorOptions = {
+    /** Site name displayed in the header */
+    siteName: string;
+    /** One-line tagline / description */
+    tagline?: string;
+    /** Base URL (e.g. https://example.com) — used in llms-full.txt links */
+    baseUrl?: string;
+    /** Capabilities bullet points */
+    capabilities?: string[];
+    /** Content resolver: given a content key, returns the string value (or undefined) */
+    resolveContent?: (key: string) => string | undefined;
+    /** Pre-loaded page specs by page id (for llms-full.txt section details) */
+    specsById?: Map<string, PageSpecV1>;
+};
+/**
+ * Generate llms.txt — compact site index (L0 Matrioska).
+ * Max ~50 lines: header, pages list, capabilities.
+ */
+export declare function generateLlmsTxt(manifest: PagesManifestV1, options: LlmsGeneratorOptions): string;
+/**
+ * Generate llms-full.txt — detailed per-page breakdown (L1 Matrioska).
+ * Includes section types, SEO metadata, and page purpose.
+ */
+export declare function generateLlmsFullTxt(manifest: PagesManifestV1, options: LlmsGeneratorOptions): string;
+//# sourceMappingURL=llms-generator.d.ts.map

package/dist/core/llms-generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"llms-generator.d.ts","sourceRoot":"","sources":["../../src/core/llms-generator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,KAAK,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAG9D,MAAM,MAAM,oBAAoB,GAAG;IAC/B,wCAAwC;IACxC,QAAQ,EAAE,MAAM,CAAC;IACjB,qCAAqC;IACrC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,wEAAwE;IACxE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,iCAAiC;IACjC,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,qFAAqF;IACrF,cAAc,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,CAAC;IACrD,2EAA2E;IAC3E,SAAS,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;CACvC,CAAC;AAEF;;;GAGG;AACH,wBAAgB,eAAe,CAC3B,QAAQ,EAAE,eAAe,EACzB,OAAO,EAAE,oBAAoB,GAC9B,MAAM,CAwCR;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAC/B,QAAQ,EAAE,eAAe,EACzB,OAAO,EAAE,oBAAoB,GAC9B,MAAM,CAuDR"}