@brandlab-digital/conformance 3.7.0 → 3.8.0

package/dist/site-system/checks.d.ts

@@ -0,0 +1,389 @@
+/**
+ * The Site System v2 ready gate: every check, the adoption tier it blocks at and the release that brings it.
+ *
+ * A site declares `siteSystem: { tier }` in brandlab.config.ts. Checks of that tier and the tiers below it block;
+ * checks of higher tiers report without blocking. A check blocks only from the release named here, so new checks
+ * arrive with version bumps and never turn the fleet red at once. Holdouts use the project's Romie-owned
+ * `exceptions` record. D6 (leave reviews as they are) removes every review-exclusion clause; D7 (no call tracking)
+ * means no number-swap check.
+ *
+ * `kind` says where a check runs:
+ * - `journey`: the Playwright site-system journeys (`defineBrandlabSiteSystemTests`), in the site's e2e run;
+ * - `rendered`: rules over the built site's server HTML and assets (`brandlab-ready` reads them);
+ * - `static`: source and data rules (`brandlab-verify` and `brandlab-ready`);
+ * - `record`: launch-day and human steps recorded with `brandlab-ready record <id> --evidence <ref>`.
+ */
+export declare const SITE_SYSTEM_TIERS: readonly ["shell", "enquiry", "full"];
+export type SiteSystemTier = (typeof SITE_SYSTEM_TIERS)[number];
+/** The design check D4 blocks every new build and redesign, whatever its tier. */
+export type SiteSystemCheckScope = SiteSystemTier | "new-build";
+export type SiteSystemCheckKind = "journey" | "rendered" | "static" | "record";
+export interface SiteSystemCheck {
+    readonly id: string;
+    readonly tier: SiteSystemCheckScope;
+    /** The first release in which the check blocks at its tier. */
+    readonly from: `3.${number}.0`;
+    readonly kind: SiteSystemCheckKind;
+    readonly summary: string;
+}
+export declare const SITE_SYSTEM_CHECKS: readonly [{
+    readonly id: "N1";
+    readonly tier: "shell";
+    readonly from: "3.9.0";
+    readonly kind: "static";
+    readonly summary: "Required nav links, About in the first two, services before Areas, Contact last, labels from the closed list, recorded orders kept.";
+}, {
+    readonly id: "N2";
+    readonly tier: "shell";
+    readonly from: "3.8.0";
+    readonly kind: "rendered";
+    readonly summary: "Every dropdown link and hub link is an <a href> in the server HTML.";
+}, {
+    readonly id: "N3";
+    readonly tier: "shell";
+    readonly from: "3.8.0";
+    readonly kind: "journey";
+    readonly summary: "Hover opens after a short delay and a diagonal path stays open; mouse-out closes; nothing sticks open.";
+}, {
+    readonly id: "N4";
+    readonly tier: "shell";
+    readonly from: "3.8.0";
+    readonly kind: "journey";
+    readonly summary: "A chevron click after hover keeps the panel open; a link click closes it; click, Enter and outside click work.";
+}, {
+    readonly id: "N5";
+    readonly tier: "shell";
+    readonly from: "3.8.0";
+    readonly kind: "journey";
+    readonly summary: "Keyboard and ARIA: aria-expanded follows the panel, Arrow keys move, Escape closes and returns focus; axe passes open and closed.";
+}, {
+    readonly id: "N6";
+    readonly tier: "shell";
+    readonly from: "3.8.0";
+    readonly kind: "journey";
+    readonly summary: "The header stays at the top with the phone and quote visible at every desktop width; the compact band shows them from 1024 to 1279 px.";
+}, {
+    readonly id: "N8";
+    readonly tier: "shell";
+    readonly from: "3.9.0";
+    readonly kind: "journey";
+    readonly summary: "The drawer is a modal dialog that traps focus and resets; the call bar uses placement fab; back-to-top appears (from 3.11.0).";
+}, {
+    readonly id: "K1";
+    readonly tier: "shell";
+    readonly from: "3.9.0";
+    readonly kind: "rendered";
+    readonly summary: "Shared components in use for the parts the tier covers (data-bl present); no literal tel: outside PhoneLink.";
+}, {
+    readonly id: "K3";
+    readonly tier: "shell";
+    readonly from: "3.8.0";
+    readonly kind: "journey";
+    readonly summary: "Text contrast 4.5:1 and non-text 3:1 in the browser.";
+}, {
+    readonly id: "K4";
+    readonly tier: "shell";
+    readonly from: "3.8.0";
+    readonly kind: "journey";
+    readonly summary: "Targets at least 24 px, and 44 px for primary actions (call, quote, menu).";
+}, {
+    readonly id: "K5";
+    readonly tier: "shell";
+    readonly from: "3.8.0";
+    readonly kind: "journey";
+    readonly summary: "Focus is never fully hidden by the sticky header or call bar at 390 px, in Chromium and WebKit.";
+}, {
+    readonly id: "K6";
+    readonly tier: "shell";
+    readonly from: "3.8.0";
+    readonly kind: "journey";
+    readonly summary: "Phone and quote in the same relative order on every page, in the header, hero and call bar.";
+}, {
+    readonly id: "K7";
+    readonly tier: "shell";
+    readonly from: "3.8.0";
+    readonly kind: "rendered";
+    readonly summary: "Dropdown links, accordion and tab panels and full review text are in the server HTML.";
+}, {
+    readonly id: "K10";
+    readonly tier: "shell";
+    readonly from: "3.8.0";
+    readonly kind: "record";
+    readonly summary: "Adoption parity in the lenient harness: no section, link or text lost against the baseline.";
+}, {
+    readonly id: "C4";
+    readonly tier: "shell";
+    readonly from: "3.8.0";
+    readonly kind: "journey";
+    readonly summary: "Phone taps report an allowed placement (header, footer, hero, cta, fab, contact, location, page).";
+}, {
+    readonly id: "C5";
+    readonly tier: "shell";
+    readonly from: "3.8.0";
+    readonly kind: "rendered";
+    readonly summary: "Call-to-action labels come from the closed list or a recorded label.";
+}, {
+    readonly id: "C9";
+    readonly tier: "shell";
+    readonly from: "3.8.0";
+    readonly kind: "rendered";
+    readonly summary: "No interstitial overlay in the first screen.";
+}, {
+    readonly id: "C10";
+    readonly tier: "shell";
+    readonly from: "3.8.0";
+    readonly kind: "rendered";
+    readonly summary: "Every tel: href is E.164 (national digits for 13, 1300 and 1800) and matches the evidence-file phone.";
+}, {
+    readonly id: "E1";
+    readonly tier: "shell";
+    readonly from: "3.8.0";
+    readonly kind: "static";
+    readonly summary: "Title patterns on new or changed URLs; recorded titles unchanged.";
+}, {
+    readonly id: "E2";
+    readonly tier: "shell";
+    readonly from: "3.8.0";
+    readonly kind: "rendered";
+    readonly summary: "Exactly one H1 on every page, rendered once.";
+}, {
+    readonly id: "E8";
+    readonly tier: "shell";
+    readonly from: "3.8.0";
+    readonly kind: "rendered";
+    readonly summary: "No banned phrase from any of the three layers, environmental claims included.";
+}, {
+    readonly id: "T3";
+    readonly tier: "shell";
+    readonly from: "3.8.0";
+    readonly kind: "rendered";
+    readonly summary: "A licence line renders wherever licensed work is advertised, with the licensee where it differs.";
+}, {
+    readonly id: "T4";
+    readonly tier: "shell";
+    readonly from: "3.8.0";
+    readonly kind: "rendered";
+    readonly summary: "No hard-coded rating or review numbers; proof claims resolve to renderable evidence.";
+}, {
+    readonly id: "T11";
+    readonly tier: "shell";
+    readonly from: "3.8.0";
+    readonly kind: "static";
+    readonly summary: "No page for work over $5,000 outside the licence classes held; licence conditions carried.";
+}, {
+    readonly id: "X1";
+    readonly tier: "shell";
+    readonly from: "3.8.0";
+    readonly kind: "record";
+    readonly summary: "Legacy URLs answer 200 or one redirect hop; earning-URL depth, titles and dollar figures kept.";
+}, {
+    readonly id: "B1";
+    readonly tier: "shell";
+    readonly from: "3.8.0";
+    readonly kind: "rendered";
+    readonly summary: "Lab budgets: JavaScript, third-party requests, hero image and HTML within budget; no unrecorded chat widget, pixel, heatmap or tag manager.";
+}, {
+    readonly id: "L10-hero";
+    readonly tier: "shell";
+    readonly from: "3.8.0";
+    readonly kind: "rendered";
+    readonly summary: "No kilometre figures, \"km from\" or \"based in\" in hero copy.";
+}, {
+    readonly id: "C1";
+    readonly tier: "enquiry";
+    readonly from: "3.8.0";
+    readonly kind: "journey";
+    readonly summary: "Money pages: the form in the first section; at 390 x 844 the H1, a call and a quote action in the first viewport; at 1440 x 900 the form.";
+}, {
+    readonly id: "C2";
+    readonly tier: "enquiry";
+    readonly from: "3.8.0";
+    readonly kind: "rendered";
+    readonly summary: "Form layout and labels; phone and email required; no helper or reassurance lines, no \"(required)\", no job select.";
+}, {
+    readonly id: "E9";
+    readonly tier: "enquiry";
+    readonly from: "3.8.0";
+    readonly kind: "rendered";
+    readonly summary: "Every cost guide carries at least 8 dollar figures in a renderable price state.";
+}, {
+    readonly id: "T5";
+    readonly tier: "enquiry";
+    readonly from: "3.8.0";
+    readonly kind: "rendered";
+    readonly summary: "Reviews from the feed, with Google's rating, count and link beside any selection; none on the contact page; no empty reviews section.";
+}, {
+    readonly id: "K8";
+    readonly tier: "enquiry";
+    readonly from: "3.8.0";
+    readonly kind: "rendered";
+    readonly summary: "Section contract: no empty section, one H2 each, at most one band tone, neighbours differ, proof within the first five sections.";
+}, {
+    readonly id: "C7";
+    readonly tier: "enquiry";
+    readonly from: "3.10.0";
+    readonly kind: "rendered";
+    readonly summary: "Thank-you page: a reply time, a tel: link and noindex, follow.";
+}, {
+    readonly id: "C8";
+    readonly tier: "enquiry";
+    readonly from: "3.10.0";
+    readonly kind: "rendered";
+    readonly summary: "Forgiving form: tolerant phone input (13, 1300 and 1800 too), autocomplete tokens, no capture on the photo input.";
+}, {
+    readonly id: "C11";
+    readonly tier: "enquiry";
+    readonly from: "3.10.0";
+    readonly kind: "static";
+    readonly summary: "The test marker is stripped before delivery and reporting; /api/contact is rate-limited.";
+}, {
+    readonly id: "N9";
+    readonly tier: "enquiry";
+    readonly from: "3.11.0";
+    readonly kind: "rendered";
+    readonly summary: "Footer content: column 1 brand, licences, socials and contact; services, areas and company columns; © name, ABN and legal links; no CTA, \"based in\", hours or guides column.";
+}, {
+    readonly id: "K2";
+    readonly tier: "enquiry";
+    readonly from: "3.11.0";
+    readonly kind: "rendered";
+    readonly summary: "Every rendered shared component has a skin entry; no reference-skin class ships.";
+}, {
+    readonly id: "K11";
+    readonly tier: "enquiry";
+    readonly from: "3.11.0";
+    readonly kind: "rendered";
+    readonly summary: "Density: no section with more than one H2, more than 8 cards or more than 2 calls to action; measure and section padding within limits.";
+}, {
+    readonly id: "K12-contact";
+    readonly tier: "enquiry";
+    readonly from: "3.11.0";
+    readonly kind: "rendered";
+    readonly summary: "The contact page is the page header, then the contact block, and nothing else.";
+}, {
+    readonly id: "T6";
+    readonly tier: "enquiry";
+    readonly from: "3.11.0";
+    readonly kind: "static";
+    readonly summary: "Every image has a media.ts entry with provenance.";
+}, {
+    readonly id: "T7";
+    readonly tier: "enquiry";
+    readonly from: "3.11.0";
+    readonly kind: "rendered";
+    readonly summary: "No image is the main image of two pages.";
+}, {
+    readonly id: "T8";
+    readonly tier: "enquiry";
+    readonly from: "3.11.0";
+    readonly kind: "rendered";
+    readonly summary: "Prices: GST flag set; no \"+ GST\" or \"from $X\" teasers on cards and menus; one band per job site-wide.";
+}, {
+    readonly id: "T9";
+    readonly tier: "enquiry";
+    readonly from: "3.11.0";
+    readonly kind: "static";
+    readonly summary: "No image in /public carries location metadata.";
+}, {
+    readonly id: "K12";
+    readonly tier: "full";
+    readonly from: "3.12.0";
+    readonly kind: "rendered";
+    readonly summary: "Section manifest: every required section rendered or skipped with a data-backed reason; conditional sections render when their data exists; canonical or recorded order.";
+}, {
+    readonly id: "E5";
+    readonly tier: "full";
+    readonly from: "3.12.0";
+    readonly kind: "static";
+    readonly summary: "No orphan indexable pages, from the route catalogue and link data.";
+}, {
+    readonly id: "E10";
+    readonly tier: "full";
+    readonly from: "3.12.0";
+    readonly kind: "static";
+    readonly summary: "Phrase-owner uniqueness in strategy data; no service-in-suburb page for the suburb page phrase; no service-region hub for the main trade.";
+}, {
+    readonly id: "L3";
+    readonly tier: "full";
+    readonly from: "3.12.0";
+    readonly kind: "static";
+    readonly summary: "Neighbours by real distance.";
+}, {
+    readonly id: "L4";
+    readonly tier: "full";
+    readonly from: "3.12.0";
+    readonly kind: "rendered";
+    readonly summary: "No copy rotated by page address, no name-swapped FAQs, no other suburb's job without the nearby label.";
+}, {
+    readonly id: "L6";
+    readonly tier: "full";
+    readonly from: "3.12.0";
+    readonly kind: "static";
+    readonly summary: "Location pages have 6 or more inbound links from 3 or more page types.";
+}, {
+    readonly id: "L7";
+    readonly tier: "full";
+    readonly from: "3.12.0";
+    readonly kind: "static";
+    readonly summary: "Location pages are 3 clicks or fewer from home.";
+}, {
+    readonly id: "L8";
+    readonly tier: "full";
+    readonly from: "3.12.0";
+    readonly kind: "static";
+    readonly summary: "A hub per family per region.";
+}, {
+    readonly id: "L9";
+    readonly tier: "full";
+    readonly from: "3.12.0";
+    readonly kind: "rendered";
+    readonly summary: "Data contract on service-location pages: price or cost-guide link, reviews or fallback, local facts; the nearby job card or none.";
+}, {
+    readonly id: "L10";
+    readonly tier: "full";
+    readonly from: "3.12.0";
+    readonly kind: "rendered";
+    readonly summary: "No kilometre figures, \"km from\", \"based in\" or year stamps as local detail in location copy.";
+}, {
+    readonly id: "S4";
+    readonly tier: "full";
+    readonly from: "3.12.0";
+    readonly kind: "static";
+    readonly summary: "No hand-written per-service or per-suburb files; no dynamic route with zero pages.";
+}, {
+    readonly id: "LOC-INDEX";
+    readonly tier: "full";
+    readonly from: "3.12.0";
+    readonly kind: "static";
+    readonly summary: "No location route is noindex or left out of the sitemap unless the recorded wave schedule dates it (Romie's 20 Oct decision: every suburb page stays indexed).";
+}, {
+    readonly id: "D4";
+    readonly tier: "new-build";
+    readonly from: "3.8.0";
+    readonly kind: "static";
+    readonly summary: "Same-trade distinctness: at least four of seven look levers differ from every listed competitor (advisory in 3.8.0, blocking from 3.9.0).";
+}];
+export type SiteSystemCheckId = (typeof SITE_SYSTEM_CHECKS)[number]["id"];
+/** A release as one comparable number: "3.8.0" < "3.10.0". */
+export declare function siteSystemReleaseRank(version: string): number;
+/**
+ * Whether a check blocks for a site at `tier` on `release`. Checks of higher tiers, and checks newer than the
+ * installed release, report without blocking. D4 blocks new builds and redesigns from 3.9.0 whatever their tier.
+ */
+export declare function siteSystemCheckBlocks(check: Pick<SiteSystemCheck, "id" | "tier" | "from">, site: {
+    tier: SiteSystemTier;
+    release: string;
+    newBuild?: boolean;
+}): boolean;
+/** One result of one check, from any runner. `brandlab-ready` merges them into the ready report. */
+export interface SiteSystemFinding {
+    readonly checkId: SiteSystemCheckId;
+    readonly status: "pass" | "fail" | "not-applicable";
+    /** The page path or file the result is about, when it is about one. */
+    readonly target?: string;
+    /** One plain sentence: what passed or what is wrong and where. */
+    readonly message: string;
+    /** A warning never blocks: the check still passes and the report shows "pass (warning)". */
+    readonly severity?: "warning";
+}
+//# sourceMappingURL=checks.d.ts.map

package/dist/site-system/checks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"checks.d.ts","sourceRoot":"","sources":["../../src/site-system/checks.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,eAAO,MAAM,iBAAiB,uCAAwC,CAAC;AACvE,MAAM,MAAM,cAAc,GAAG,CAAC,OAAO,iBAAiB,CAAC,CAAC,MAAM,CAAC,CAAC;AAEhE,kFAAkF;AAClF,MAAM,MAAM,oBAAoB,GAAG,cAAc,GAAG,WAAW,CAAC;AAEhE,MAAM,MAAM,mBAAmB,GAAG,SAAS,GAAG,UAAU,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAE/E,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,oBAAoB,CAAC;IACpC,+DAA+D;IAC/D,QAAQ,CAAC,IAAI,EAAE,KAAK,MAAM,IAAI,CAAC;IAC/B,QAAQ,CAAC,IAAI,EAAE,mBAAmB,CAAC;IACnC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAgEgB,CAAC;AAEhD,MAAM,MAAM,iBAAiB,GAAG,CAAC,OAAO,kBAAkB,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC;AAI1E,8DAA8D;AAC9D,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAG7D;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,IAAI,CAAC,eAAe,EAAE,IAAI,GAAG,MAAM,GAAG,MAAM,CAAC,EACpD,IAAI,EAAE;IAAE,IAAI,EAAE,cAAc,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,OAAO,CAAA;CAAE,GAClE,OAAO,CAIT;AAED,oGAAoG;AACpG,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,OAAO,EAAE,iBAAiB,CAAC;IACpC,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,gBAAgB,CAAC;IACpD,uEAAuE;IACvE,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,kEAAkE;IAClE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,4FAA4F;IAC5F,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,CAAC;CAC/B"}

package/dist/site-system/checks.js

@@ -0,0 +1,96 @@
+/**
+ * The Site System v2 ready gate: every check, the adoption tier it blocks at and the release that brings it.
+ *
+ * A site declares `siteSystem: { tier }` in brandlab.config.ts. Checks of that tier and the tiers below it block;
+ * checks of higher tiers report without blocking. A check blocks only from the release named here, so new checks
+ * arrive with version bumps and never turn the fleet red at once. Holdouts use the project's Romie-owned
+ * `exceptions` record. D6 (leave reviews as they are) removes every review-exclusion clause; D7 (no call tracking)
+ * means no number-swap check.
+ *
+ * `kind` says where a check runs:
+ * - `journey`: the Playwright site-system journeys (`defineBrandlabSiteSystemTests`), in the site's e2e run;
+ * - `rendered`: rules over the built site's server HTML and assets (`brandlab-ready` reads them);
+ * - `static`: source and data rules (`brandlab-verify` and `brandlab-ready`);
+ * - `record`: launch-day and human steps recorded with `brandlab-ready record <id> --evidence <ref>`.
+ */
+export const SITE_SYSTEM_TIERS = ["shell", "enquiry", "full"];
+export const SITE_SYSTEM_CHECKS = [
+    // shell: header, nav, call bar, placements, crawlable links, contrast and targets, call links, budgets, legal
+    { id: "N1", tier: "shell", from: "3.9.0", kind: "static", summary: "Required nav links, About in the first two, services before Areas, Contact last, labels from the closed list, recorded orders kept." },
+    { id: "N2", tier: "shell", from: "3.8.0", kind: "rendered", summary: "Every dropdown link and hub link is an <a href> in the server HTML." },
+    { id: "N3", tier: "shell", from: "3.8.0", kind: "journey", summary: "Hover opens after a short delay and a diagonal path stays open; mouse-out closes; nothing sticks open." },
+    { id: "N4", tier: "shell", from: "3.8.0", kind: "journey", summary: "A chevron click after hover keeps the panel open; a link click closes it; click, Enter and outside click work." },
+    { id: "N5", tier: "shell", from: "3.8.0", kind: "journey", summary: "Keyboard and ARIA: aria-expanded follows the panel, Arrow keys move, Escape closes and returns focus; axe passes open and closed." },
+    { id: "N6", tier: "shell", from: "3.8.0", kind: "journey", summary: "The header stays at the top with the phone and quote visible at every desktop width; the compact band shows them from 1024 to 1279 px." },
+    { id: "N8", tier: "shell", from: "3.9.0", kind: "journey", summary: "The drawer is a modal dialog that traps focus and resets; the call bar uses placement fab; back-to-top appears (from 3.11.0)." },
+    { id: "K1", tier: "shell", from: "3.9.0", kind: "rendered", summary: "Shared components in use for the parts the tier covers (data-bl present); no literal tel: outside PhoneLink." },
+    { id: "K3", tier: "shell", from: "3.8.0", kind: "journey", summary: "Text contrast 4.5:1 and non-text 3:1 in the browser." },
+    { id: "K4", tier: "shell", from: "3.8.0", kind: "journey", summary: "Targets at least 24 px, and 44 px for primary actions (call, quote, menu)." },
+    { id: "K5", tier: "shell", from: "3.8.0", kind: "journey", summary: "Focus is never fully hidden by the sticky header or call bar at 390 px, in Chromium and WebKit." },
+    { id: "K6", tier: "shell", from: "3.8.0", kind: "journey", summary: "Phone and quote in the same relative order on every page, in the header, hero and call bar." },
+    { id: "K7", tier: "shell", from: "3.8.0", kind: "rendered", summary: "Dropdown links, accordion and tab panels and full review text are in the server HTML." },
+    { id: "K10", tier: "shell", from: "3.8.0", kind: "record", summary: "Adoption parity in the lenient harness: no section, link or text lost against the baseline." },
+    { id: "C4", tier: "shell", from: "3.8.0", kind: "journey", summary: "Phone taps report an allowed placement (header, footer, hero, cta, fab, contact, location, page)." },
+    { id: "C5", tier: "shell", from: "3.8.0", kind: "rendered", summary: "Call-to-action labels come from the closed list or a recorded label." },
+    { id: "C9", tier: "shell", from: "3.8.0", kind: "rendered", summary: "No interstitial overlay in the first screen." },
+    { id: "C10", tier: "shell", from: "3.8.0", kind: "rendered", summary: "Every tel: href is E.164 (national digits for 13, 1300 and 1800) and matches the evidence-file phone." },
+    { id: "E1", tier: "shell", from: "3.8.0", kind: "static", summary: "Title patterns on new or changed URLs; recorded titles unchanged." },
+    { id: "E2", tier: "shell", from: "3.8.0", kind: "rendered", summary: "Exactly one H1 on every page, rendered once." },
+    { id: "E8", tier: "shell", from: "3.8.0", kind: "rendered", summary: "No banned phrase from any of the three layers, environmental claims included." },
+    { id: "T3", tier: "shell", from: "3.8.0", kind: "rendered", summary: "A licence line renders wherever licensed work is advertised, with the licensee where it differs." },
+    { id: "T4", tier: "shell", from: "3.8.0", kind: "rendered", summary: "No hard-coded rating or review numbers; proof claims resolve to renderable evidence." },
+    { id: "T11", tier: "shell", from: "3.8.0", kind: "static", summary: "No page for work over $5,000 outside the licence classes held; licence conditions carried." },
+    { id: "X1", tier: "shell", from: "3.8.0", kind: "record", summary: "Legacy URLs answer 200 or one redirect hop; earning-URL depth, titles and dollar figures kept." },
+    { id: "B1", tier: "shell", from: "3.8.0", kind: "rendered", summary: "Lab budgets: JavaScript, third-party requests, hero image and HTML within budget; no unrecorded chat widget, pixel, heatmap or tag manager." },
+    { id: "L10-hero", tier: "shell", from: "3.8.0", kind: "rendered", summary: 'No kilometre figures, "km from" or "based in" in hero copy.' },
+    // enquiry: the form, thank-you page, reviews, proof strip, footer, CTA band, contact page, prices, media, density
+    { id: "C1", tier: "enquiry", from: "3.8.0", kind: "journey", summary: "Money pages: the form in the first section; at 390 x 844 the H1, a call and a quote action in the first viewport; at 1440 x 900 the form." },
+    { id: "C2", tier: "enquiry", from: "3.8.0", kind: "rendered", summary: 'Form layout and labels; phone and email required; no helper or reassurance lines, no "(required)", no job select.' },
+    { id: "E9", tier: "enquiry", from: "3.8.0", kind: "rendered", summary: "Every cost guide carries at least 8 dollar figures in a renderable price state." },
+    { id: "T5", tier: "enquiry", from: "3.8.0", kind: "rendered", summary: "Reviews from the feed, with Google's rating, count and link beside any selection; none on the contact page; no empty reviews section." },
+    { id: "K8", tier: "enquiry", from: "3.8.0", kind: "rendered", summary: "Section contract: no empty section, one H2 each, at most one band tone, neighbours differ, proof within the first five sections." },
+    { id: "C7", tier: "enquiry", from: "3.10.0", kind: "rendered", summary: "Thank-you page: a reply time, a tel: link and noindex, follow." },
+    { id: "C8", tier: "enquiry", from: "3.10.0", kind: "rendered", summary: "Forgiving form: tolerant phone input (13, 1300 and 1800 too), autocomplete tokens, no capture on the photo input." },
+    { id: "C11", tier: "enquiry", from: "3.10.0", kind: "static", summary: "The test marker is stripped before delivery and reporting; /api/contact is rate-limited." },
+    { id: "N9", tier: "enquiry", from: "3.11.0", kind: "rendered", summary: 'Footer content: column 1 brand, licences, socials and contact; services, areas and company columns; © name, ABN and legal links; no CTA, "based in", hours or guides column.' },
+    { id: "K2", tier: "enquiry", from: "3.11.0", kind: "rendered", summary: "Every rendered shared component has a skin entry; no reference-skin class ships." },
+    { id: "K11", tier: "enquiry", from: "3.11.0", kind: "rendered", summary: "Density: no section with more than one H2, more than 8 cards or more than 2 calls to action; measure and section padding within limits." },
+    { id: "K12-contact", tier: "enquiry", from: "3.11.0", kind: "rendered", summary: "The contact page is the page header, then the contact block, and nothing else." },
+    { id: "T6", tier: "enquiry", from: "3.11.0", kind: "static", summary: "Every image has a media.ts entry with provenance." },
+    { id: "T7", tier: "enquiry", from: "3.11.0", kind: "rendered", summary: "No image is the main image of two pages." },
+    { id: "T8", tier: "enquiry", from: "3.11.0", kind: "rendered", summary: 'Prices: GST flag set; no "+ GST" or "from $X" teasers on cards and menus; one band per job site-wide.' },
+    { id: "T9", tier: "enquiry", from: "3.11.0", kind: "static", summary: "No image in /public carries location metadata." },
+    // full: page families, location estates, section manifests, links and the data contract
+    { id: "K12", tier: "full", from: "3.12.0", kind: "rendered", summary: "Section manifest: every required section rendered or skipped with a data-backed reason; conditional sections render when their data exists; canonical or recorded order." },
+    { id: "E5", tier: "full", from: "3.12.0", kind: "static", summary: "No orphan indexable pages, from the route catalogue and link data." },
+    { id: "E10", tier: "full", from: "3.12.0", kind: "static", summary: "Phrase-owner uniqueness in strategy data; no service-in-suburb page for the suburb page phrase; no service-region hub for the main trade." },
+    { id: "L3", tier: "full", from: "3.12.0", kind: "static", summary: "Neighbours by real distance." },
+    { id: "L4", tier: "full", from: "3.12.0", kind: "rendered", summary: "No copy rotated by page address, no name-swapped FAQs, no other suburb's job without the nearby label." },
+    { id: "L6", tier: "full", from: "3.12.0", kind: "static", summary: "Location pages have 6 or more inbound links from 3 or more page types." },
+    { id: "L7", tier: "full", from: "3.12.0", kind: "static", summary: "Location pages are 3 clicks or fewer from home." },
+    { id: "L8", tier: "full", from: "3.12.0", kind: "static", summary: "A hub per family per region." },
+    { id: "L9", tier: "full", from: "3.12.0", kind: "rendered", summary: "Data contract on service-location pages: price or cost-guide link, reviews or fallback, local facts; the nearby job card or none." },
+    { id: "L10", tier: "full", from: "3.12.0", kind: "rendered", summary: 'No kilometre figures, "km from", "based in" or year stamps as local detail in location copy.' },
+    { id: "S4", tier: "full", from: "3.12.0", kind: "static", summary: "No hand-written per-service or per-suburb files; no dynamic route with zero pages." },
+    { id: "LOC-INDEX", tier: "full", from: "3.12.0", kind: "static", summary: "No location route is noindex or left out of the sitemap unless the recorded wave schedule dates it (Romie's 20 Oct decision: every suburb page stays indexed)." },
+    // new builds and redesigns
+    { id: "D4", tier: "new-build", from: "3.8.0", kind: "static", summary: "Same-trade distinctness: at least four of seven look levers differ from every listed competitor (advisory in 3.8.0, blocking from 3.9.0)." },
+];
+const TIER_RANK = { shell: 0, enquiry: 1, full: 2 };
+/** A release as one comparable number: "3.8.0" < "3.10.0". */
+export function siteSystemReleaseRank(version) {
+    const [major = 0, minor = 0, patch = 0] = version.split(/[.-]/).map((part) => Number.parseInt(part, 10) || 0);
+    return major * 1_000_000 + minor * 1_000 + patch;
+}
+/**
+ * Whether a check blocks for a site at `tier` on `release`. Checks of higher tiers, and checks newer than the
+ * installed release, report without blocking. D4 blocks new builds and redesigns from 3.9.0 whatever their tier.
+ */
+export function siteSystemCheckBlocks(check, site) {
+    if (check.tier === "new-build")
+        return site.newBuild === true && siteSystemReleaseRank(site.release) >= siteSystemReleaseRank("3.9.0");
+    if (siteSystemReleaseRank(site.release) < siteSystemReleaseRank(check.from))
+        return false;
+    return TIER_RANK[check.tier] <= TIER_RANK[site.tier];
+}
+//# sourceMappingURL=checks.js.map

package/dist/site-system/checks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"checks.js","sourceRoot":"","sources":["../../src/site-system/checks.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * The Site System v2 ready gate: every check, the adoption tier it blocks at and the release that brings it.\n *\n * A site declares `siteSystem: { tier }` in brandlab.config.ts. Checks of that tier and the tiers below it block;\n * checks of higher tiers report without blocking. A check blocks only from the release named here, so new checks\n * arrive with version bumps and never turn the fleet red at once. Holdouts use the project's Romie-owned\n * `exceptions` record. D6 (leave reviews as they are) removes every review-exclusion clause; D7 (no call tracking)\n * means no number-swap check.\n *\n * `kind` says where a check runs:\n * - `journey`: the Playwright site-system journeys (`defineBrandlabSiteSystemTests`), in the site's e2e run;\n * - `rendered`: rules over the built site's server HTML and assets (`brandlab-ready` reads them);\n * - `static`: source and data rules (`brandlab-verify` and `brandlab-ready`);\n * - `record`: launch-day and human steps recorded with `brandlab-ready record <id> --evidence <ref>`.\n */\n\nexport const SITE_SYSTEM_TIERS = [\"shell\", \"enquiry\", \"full\"] as const;\nexport type SiteSystemTier = (typeof SITE_SYSTEM_TIERS)[number];\n\n/** The design check D4 blocks every new build and redesign, whatever its tier. */\nexport type SiteSystemCheckScope = SiteSystemTier | \"new-build\";\n\nexport type SiteSystemCheckKind = \"journey\" | \"rendered\" | \"static\" | \"record\";\n\nexport interface SiteSystemCheck {\n  readonly id: string;\n  readonly tier: SiteSystemCheckScope;\n  /** The first release in which the check blocks at its tier. */\n  readonly from: `3.${number}.0`;\n  readonly kind: SiteSystemCheckKind;\n  readonly summary: string;\n}\n\nexport const SITE_SYSTEM_CHECKS = [\n  // shell: header, nav, call bar, placements, crawlable links, contrast and targets, call links, budgets, legal\n  { id: \"N1\", tier: \"shell\", from: \"3.9.0\", kind: \"static\", summary: \"Required nav links, About in the first two, services before Areas, Contact last, labels from the closed list, recorded orders kept.\" },\n  { id: \"N2\", tier: \"shell\", from: \"3.8.0\", kind: \"rendered\", summary: \"Every dropdown link and hub link is an <a href> in the server HTML.\" },\n  { id: \"N3\", tier: \"shell\", from: \"3.8.0\", kind: \"journey\", summary: \"Hover opens after a short delay and a diagonal path stays open; mouse-out closes; nothing sticks open.\" },\n  { id: \"N4\", tier: \"shell\", from: \"3.8.0\", kind: \"journey\", summary: \"A chevron click after hover keeps the panel open; a link click closes it; click, Enter and outside click work.\" },\n  { id: \"N5\", tier: \"shell\", from: \"3.8.0\", kind: \"journey\", summary: \"Keyboard and ARIA: aria-expanded follows the panel, Arrow keys move, Escape closes and returns focus; axe passes open and closed.\" },\n  { id: \"N6\", tier: \"shell\", from: \"3.8.0\", kind: \"journey\", summary: \"The header stays at the top with the phone and quote visible at every desktop width; the compact band shows them from 1024 to 1279 px.\" },\n  { id: \"N8\", tier: \"shell\", from: \"3.9.0\", kind: \"journey\", summary: \"The drawer is a modal dialog that traps focus and resets; the call bar uses placement fab; back-to-top appears (from 3.11.0).\" },\n  { id: \"K1\", tier: \"shell\", from: \"3.9.0\", kind: \"rendered\", summary: \"Shared components in use for the parts the tier covers (data-bl present); no literal tel: outside PhoneLink.\" },\n  { id: \"K3\", tier: \"shell\", from: \"3.8.0\", kind: \"journey\", summary: \"Text contrast 4.5:1 and non-text 3:1 in the browser.\" },\n  { id: \"K4\", tier: \"shell\", from: \"3.8.0\", kind: \"journey\", summary: \"Targets at least 24 px, and 44 px for primary actions (call, quote, menu).\" },\n  { id: \"K5\", tier: \"shell\", from: \"3.8.0\", kind: \"journey\", summary: \"Focus is never fully hidden by the sticky header or call bar at 390 px, in Chromium and WebKit.\" },\n  { id: \"K6\", tier: \"shell\", from: \"3.8.0\", kind: \"journey\", summary: \"Phone and quote in the same relative order on every page, in the header, hero and call bar.\" },\n  { id: \"K7\", tier: \"shell\", from: \"3.8.0\", kind: \"rendered\", summary: \"Dropdown links, accordion and tab panels and full review text are in the server HTML.\" },\n  { id: \"K10\", tier: \"shell\", from: \"3.8.0\", kind: \"record\", summary: \"Adoption parity in the lenient harness: no section, link or text lost against the baseline.\" },\n  { id: \"C4\", tier: \"shell\", from: \"3.8.0\", kind: \"journey\", summary: \"Phone taps report an allowed placement (header, footer, hero, cta, fab, contact, location, page).\" },\n  { id: \"C5\", tier: \"shell\", from: \"3.8.0\", kind: \"rendered\", summary: \"Call-to-action labels come from the closed list or a recorded label.\" },\n  { id: \"C9\", tier: \"shell\", from: \"3.8.0\", kind: \"rendered\", summary: \"No interstitial overlay in the first screen.\" },\n  { id: \"C10\", tier: \"shell\", from: \"3.8.0\", kind: \"rendered\", summary: \"Every tel: href is E.164 (national digits for 13, 1300 and 1800) and matches the evidence-file phone.\" },\n  { id: \"E1\", tier: \"shell\", from: \"3.8.0\", kind: \"static\", summary: \"Title patterns on new or changed URLs; recorded titles unchanged.\" },\n  { id: \"E2\", tier: \"shell\", from: \"3.8.0\", kind: \"rendered\", summary: \"Exactly one H1 on every page, rendered once.\" },\n  { id: \"E8\", tier: \"shell\", from: \"3.8.0\", kind: \"rendered\", summary: \"No banned phrase from any of the three layers, environmental claims included.\" },\n  { id: \"T3\", tier: \"shell\", from: \"3.8.0\", kind: \"rendered\", summary: \"A licence line renders wherever licensed work is advertised, with the licensee where it differs.\" },\n  { id: \"T4\", tier: \"shell\", from: \"3.8.0\", kind: \"rendered\", summary: \"No hard-coded rating or review numbers; proof claims resolve to renderable evidence.\" },\n  { id: \"T11\", tier: \"shell\", from: \"3.8.0\", kind: \"static\", summary: \"No page for work over $5,000 outside the licence classes held; licence conditions carried.\" },\n  { id: \"X1\", tier: \"shell\", from: \"3.8.0\", kind: \"record\", summary: \"Legacy URLs answer 200 or one redirect hop; earning-URL depth, titles and dollar figures kept.\" },\n  { id: \"B1\", tier: \"shell\", from: \"3.8.0\", kind: \"rendered\", summary: \"Lab budgets: JavaScript, third-party requests, hero image and HTML within budget; no unrecorded chat widget, pixel, heatmap or tag manager.\" },\n  { id: \"L10-hero\", tier: \"shell\", from: \"3.8.0\", kind: \"rendered\", summary: 'No kilometre figures, \"km from\" or \"based in\" in hero copy.' },\n\n  // enquiry: the form, thank-you page, reviews, proof strip, footer, CTA band, contact page, prices, media, density\n  { id: \"C1\", tier: \"enquiry\", from: \"3.8.0\", kind: \"journey\", summary: \"Money pages: the form in the first section; at 390 x 844 the H1, a call and a quote action in the first viewport; at 1440 x 900 the form.\" },\n  { id: \"C2\", tier: \"enquiry\", from: \"3.8.0\", kind: \"rendered\", summary: 'Form layout and labels; phone and email required; no helper or reassurance lines, no \"(required)\", no job select.' },\n  { id: \"E9\", tier: \"enquiry\", from: \"3.8.0\", kind: \"rendered\", summary: \"Every cost guide carries at least 8 dollar figures in a renderable price state.\" },\n  { id: \"T5\", tier: \"enquiry\", from: \"3.8.0\", kind: \"rendered\", summary: \"Reviews from the feed, with Google's rating, count and link beside any selection; none on the contact page; no empty reviews section.\" },\n  { id: \"K8\", tier: \"enquiry\", from: \"3.8.0\", kind: \"rendered\", summary: \"Section contract: no empty section, one H2 each, at most one band tone, neighbours differ, proof within the first five sections.\" },\n  { id: \"C7\", tier: \"enquiry\", from: \"3.10.0\", kind: \"rendered\", summary: \"Thank-you page: a reply time, a tel: link and noindex, follow.\" },\n  { id: \"C8\", tier: \"enquiry\", from: \"3.10.0\", kind: \"rendered\", summary: \"Forgiving form: tolerant phone input (13, 1300 and 1800 too), autocomplete tokens, no capture on the photo input.\" },\n  { id: \"C11\", tier: \"enquiry\", from: \"3.10.0\", kind: \"static\", summary: \"The test marker is stripped before delivery and reporting; /api/contact is rate-limited.\" },\n  { id: \"N9\", tier: \"enquiry\", from: \"3.11.0\", kind: \"rendered\", summary: 'Footer content: column 1 brand, licences, socials and contact; services, areas and company columns; © name, ABN and legal links; no CTA, \"based in\", hours or guides column.' },\n  { id: \"K2\", tier: \"enquiry\", from: \"3.11.0\", kind: \"rendered\", summary: \"Every rendered shared component has a skin entry; no reference-skin class ships.\" },\n  { id: \"K11\", tier: \"enquiry\", from: \"3.11.0\", kind: \"rendered\", summary: \"Density: no section with more than one H2, more than 8 cards or more than 2 calls to action; measure and section padding within limits.\" },\n  { id: \"K12-contact\", tier: \"enquiry\", from: \"3.11.0\", kind: \"rendered\", summary: \"The contact page is the page header, then the contact block, and nothing else.\" },\n  { id: \"T6\", tier: \"enquiry\", from: \"3.11.0\", kind: \"static\", summary: \"Every image has a media.ts entry with provenance.\" },\n  { id: \"T7\", tier: \"enquiry\", from: \"3.11.0\", kind: \"rendered\", summary: \"No image is the main image of two pages.\" },\n  { id: \"T8\", tier: \"enquiry\", from: \"3.11.0\", kind: \"rendered\", summary: 'Prices: GST flag set; no \"+ GST\" or \"from $X\" teasers on cards and menus; one band per job site-wide.' },\n  { id: \"T9\", tier: \"enquiry\", from: \"3.11.0\", kind: \"static\", summary: \"No image in /public carries location metadata.\" },\n\n  // full: page families, location estates, section manifests, links and the data contract\n  { id: \"K12\", tier: \"full\", from: \"3.12.0\", kind: \"rendered\", summary: \"Section manifest: every required section rendered or skipped with a data-backed reason; conditional sections render when their data exists; canonical or recorded order.\" },\n  { id: \"E5\", tier: \"full\", from: \"3.12.0\", kind: \"static\", summary: \"No orphan indexable pages, from the route catalogue and link data.\" },\n  { id: \"E10\", tier: \"full\", from: \"3.12.0\", kind: \"static\", summary: \"Phrase-owner uniqueness in strategy data; no service-in-suburb page for the suburb page phrase; no service-region hub for the main trade.\" },\n  { id: \"L3\", tier: \"full\", from: \"3.12.0\", kind: \"static\", summary: \"Neighbours by real distance.\" },\n  { id: \"L4\", tier: \"full\", from: \"3.12.0\", kind: \"rendered\", summary: \"No copy rotated by page address, no name-swapped FAQs, no other suburb's job without the nearby label.\" },\n  { id: \"L6\", tier: \"full\", from: \"3.12.0\", kind: \"static\", summary: \"Location pages have 6 or more inbound links from 3 or more page types.\" },\n  { id: \"L7\", tier: \"full\", from: \"3.12.0\", kind: \"static\", summary: \"Location pages are 3 clicks or fewer from home.\" },\n  { id: \"L8\", tier: \"full\", from: \"3.12.0\", kind: \"static\", summary: \"A hub per family per region.\" },\n  { id: \"L9\", tier: \"full\", from: \"3.12.0\", kind: \"rendered\", summary: \"Data contract on service-location pages: price or cost-guide link, reviews or fallback, local facts; the nearby job card or none.\" },\n  { id: \"L10\", tier: \"full\", from: \"3.12.0\", kind: \"rendered\", summary: 'No kilometre figures, \"km from\", \"based in\" or year stamps as local detail in location copy.' },\n  { id: \"S4\", tier: \"full\", from: \"3.12.0\", kind: \"static\", summary: \"No hand-written per-service or per-suburb files; no dynamic route with zero pages.\" },\n  { id: \"LOC-INDEX\", tier: \"full\", from: \"3.12.0\", kind: \"static\", summary: \"No location route is noindex or left out of the sitemap unless the recorded wave schedule dates it (Romie's 20 Oct decision: every suburb page stays indexed).\" },\n\n  // new builds and redesigns\n  { id: \"D4\", tier: \"new-build\", from: \"3.8.0\", kind: \"static\", summary: \"Same-trade distinctness: at least four of seven look levers differ from every listed competitor (advisory in 3.8.0, blocking from 3.9.0).\" },\n] as const satisfies readonly SiteSystemCheck[];\n\nexport type SiteSystemCheckId = (typeof SITE_SYSTEM_CHECKS)[number][\"id\"];\n\nconst TIER_RANK: Record<SiteSystemTier, number> = { shell: 0, enquiry: 1, full: 2 };\n\n/** A release as one comparable number: \"3.8.0\" < \"3.10.0\". */\nexport function siteSystemReleaseRank(version: string): number {\n  const [major = 0, minor = 0, patch = 0] = version.split(/[.-]/).map((part) => Number.parseInt(part, 10) || 0);\n  return major * 1_000_000 + minor * 1_000 + patch;\n}\n\n/**\n * Whether a check blocks for a site at `tier` on `release`. Checks of higher tiers, and checks newer than the\n * installed release, report without blocking. D4 blocks new builds and redesigns from 3.9.0 whatever their tier.\n */\nexport function siteSystemCheckBlocks(\n  check: Pick<SiteSystemCheck, \"id\" | \"tier\" | \"from\">,\n  site: { tier: SiteSystemTier; release: string; newBuild?: boolean },\n): boolean {\n  if (check.tier === \"new-build\") return site.newBuild === true && siteSystemReleaseRank(site.release) >= siteSystemReleaseRank(\"3.9.0\");\n  if (siteSystemReleaseRank(site.release) < siteSystemReleaseRank(check.from)) return false;\n  return TIER_RANK[check.tier] <= TIER_RANK[site.tier];\n}\n\n/** One result of one check, from any runner. `brandlab-ready` merges them into the ready report. */\nexport interface SiteSystemFinding {\n  readonly checkId: SiteSystemCheckId;\n  readonly status: \"pass\" | \"fail\" | \"not-applicable\";\n  /** The page path or file the result is about, when it is about one. */\n  readonly target?: string;\n  /** One plain sentence: what passed or what is wrong and where. */\n  readonly message: string;\n  /** A warning never blocks: the check still passes and the report shows \"pass (warning)\". */\n  readonly severity?: \"warning\";\n}\n"]}

package/dist/site-system/config.d.ts

@@ -0,0 +1,40 @@
+import { type SiteSystemTier } from "./checks.js";
+export interface SiteSystemSettings {
+    readonly tier: SiteSystemTier;
+    /** A new build or redesign: D4 blocks whatever the tier. */
+    readonly newBuild: boolean;
+    /** Extra pages to sample for the rendered checks. */
+    readonly samples: readonly string[];
+    /** Quote and call-to-action labels recorded for this site, beyond the closed list (C5). */
+    readonly labels: readonly string[];
+    /** Whether the business offers free quotes; null when not recorded. */
+    readonly freeQuotes: boolean | null;
+    /** Third-party hostnames the site may load (B1). */
+    readonly thirdParties: readonly string[];
+    /** Extra tel: links the site legitimately shows (C10). */
+    readonly phones: readonly string[];
+}
+/** A Romie-owned holdout; `ruleId` names the check it covers. */
+export interface SiteSystemException {
+    readonly ruleId: string;
+    readonly rationale: string;
+    readonly evidence: string;
+    readonly expiresAt?: string;
+    readonly reviewTrigger: string;
+}
+export interface SiteSystemProjectConfig {
+    readonly projectId: string | null;
+    /** Null when the site has not adopted Site System v2: nothing in the gate blocks. */
+    readonly siteSystem: SiteSystemSettings | null;
+    readonly exceptions: readonly SiteSystemException[];
+    /** `searchCertification.representativeRoutes` (home, contact, service, location, blog). */
+    readonly representativeRoutes: Readonly<Record<string, string>>;
+    /** False when defineBrandlabProject({ ... }) spreads or computes a member, so a tier could be hidden. */
+    readonly complete: boolean;
+    /** Fields that could not be read; the gate reports them and carries on without them. */
+    readonly problems: readonly string[];
+}
+export declare function readSiteSystemProjectConfig(root: string): SiteSystemProjectConfig;
+/** Throws when siteSystem is present but unreadable or invalid: a declared tier must never be skipped silently. */
+export declare function parseSiteSystemProjectConfig(text: string): SiteSystemProjectConfig;
+//# sourceMappingURL=config.d.ts.map

package/dist/site-system/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/site-system/config.ts"],"names":[],"mappings":"AAQA,OAAO,EAAqB,KAAK,cAAc,EAAE,MAAM,aAAa,CAAC;AAErE,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,IAAI,EAAE,cAAc,CAAC;IAC9B,4DAA4D;IAC5D,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,qDAAqD;IACrD,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;IACpC,2FAA2F;IAC3F,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;IACnC,uEAAuE;IACvE,QAAQ,CAAC,UAAU,EAAE,OAAO,GAAG,IAAI,CAAC;IACpC,oDAAoD;IACpD,QAAQ,CAAC,YAAY,EAAE,SAAS,MAAM,EAAE,CAAC;IACzC,0DAA0D;IAC1D,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;CACpC;AAED,iEAAiE;AACjE,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;CAChC;AAED,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,qFAAqF;IACrF,QAAQ,CAAC,UAAU,EAAE,kBAAkB,GAAG,IAAI,CAAC;IAC/C,QAAQ,CAAC,UAAU,EAAE,SAAS,mBAAmB,EAAE,CAAC;IACpD,2FAA2F;IAC3F,QAAQ,CAAC,oBAAoB,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IAChE,yGAAyG;IACzG,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,wFAAwF;IACxF,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;CACtC;AAQD,wBAAgB,2BAA2B,CAAC,IAAI,EAAE,MAAM,GAAG,uBAAuB,CAIjF;AAED,mHAAmH;AACnH,wBAAgB,4BAA4B,CAAC,IAAI,EAAE,MAAM,GAAG,uBAAuB,CAmDlF"}