@brandlab-digital/conformance 1.0.0-rc.37 → 1.0.0-rc.5

package/dist/cli.d.ts

@@ -3,6 +3,9 @@ import { type BrandlabConformanceMode } from "./project.js";
 interface CliOptions {
     root: string;
     installedRelease?: string | null;
+    targetRelease?: string | null;
+    supportPolicyPath: string | null;
+    releaseManifestPaths: string[];
     mode: BrandlabConformanceMode;
     json: boolean;
     help: boolean;
@@ -13,6 +16,5 @@ interface CliIo {
 }
 export declare function parseBrandlabConformanceArgs(argv: readonly string[]): CliOptions;
 export declare function runBrandlabConformanceCli(argv: readonly string[], io?: CliIo): number;
-export declare function isBrandlabConformanceCliEntrypoint(moduleUrl: string, argvPath: string | undefined): boolean;
 export {};
 //# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AAIA,OAAO,EAGL,KAAK,uBAAuB,EAE7B,MAAM,cAAc,CAAC;AAEtB,UAAU,UAAU;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,gBAAgB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,IAAI,EAAE,uBAAuB,CAAC;IAC9B,IAAI,EAAE,OAAO,CAAC;IACd,IAAI,EAAE,OAAO,CAAC;CACf;AAED,UAAU,KAAK;IACb,MAAM,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAChC,MAAM,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;CACjC;AAmBD,wBAAgB,4BAA4B,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,UAAU,CA2BhF;AAED,wBAAgB,yBAAyB,CACvC,IAAI,EAAE,SAAS,MAAM,EAAE,EACvB,EAAE,GAAE,KAGH,GACA,MAAM,CAkBR;AAmDD,wBAAgB,kCAAkC,CAChD,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,GAAG,SAAS,GAC3B,OAAO,CAOT"}
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AAIA,OAAO,EAGL,KAAK,uBAAuB,EAE7B,MAAM,cAAc,CAAC;AAOtB,UAAU,UAAU;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,gBAAgB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,oBAAoB,EAAE,MAAM,EAAE,CAAC;IAC/B,IAAI,EAAE,uBAAuB,CAAC;IAC9B,IAAI,EAAE,OAAO,CAAC;IACd,IAAI,EAAE,OAAO,CAAC;CACf;AAED,UAAU,KAAK;IACb,MAAM,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAChC,MAAM,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;CACjC;AAeD,wBAAgB,4BAA4B,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,UAAU,CAgDhF;AAED,wBAAgB,yBAAyB,CACvC,IAAI,EAAE,SAAS,MAAM,EAAE,EACvB,EAAE,GAAE,KAGH,GACA,MAAM,CAqCR"}

package/dist/cli.js

@@ -1,47 +1,58 @@
 #!/usr/bin/env node
-import { realpathSync } from "node:fs";
-import { resolve } from "node:path";
-import { fileURLToPath } from "node:url";
+import { existsSync, readFileSync } from "node:fs";
+import { dirname, isAbsolute, resolve } from "node:path";
+import { pathToFileURL } from "node:url";
 import { evaluateBrandlabProject, shouldFailBrandlabConformance, } from "./project.js";
-const HELP = `Brandlab verification
-
-Runs the current objective verification checks for one project.
+import { compareBrandlabSemver, } from "./release-manifest.js";
+const HELP = `Brandlab version-aware conformance
 
 Usage:
-  brandlab-verify [--root <path>]
+  brandlab-conformance --support-policy <path> [--root <path>]
     [--installed-release <version|unadopted>]
-    [--mode <local|ci|preflight>] [--json]
+    [--release-manifest <path>]...
+    [--target-release <version|none>] [--mode <local|ci|preflight>] [--json]
 
 Exit status:
-  local/ci   fail only for objective current-release blockers
-  preflight  uses the same checks against an isolated candidate
-
-Static verification reports tests, builds, browsers and deployments as not run
-until real evidence is supplied.
+  local/ci   fail only for installed-release maintenance blockers
+  preflight  also fails for target-release migration blockers
 `;
 export function parseBrandlabConformanceArgs(argv) {
     const parsed = {
         root: process.cwd(),
+        supportPolicyPath: null,
+        releaseManifestPaths: [],
         mode: "local",
         json: false,
         help: false,
     };
     for (let index = 0; index < argv.length; index += 1) {
         const argument = argv[index];
-        if (argument === "--help" || argument === "-h")
+        if (argument === "--help" || argument === "-h") {
             parsed.help = true;
-        else if (argument === "--json")
+        }
+        else if (argument === "--json") {
             parsed.json = true;
+        }
         else if (argument === "--root") {
             parsed.root = resolve(requireValue(argv, ++index, "--root"));
         }
+        else if (argument === "--support-policy") {
+            parsed.supportPolicyPath = resolve(requireValue(argv, ++index, "--support-policy"));
+        }
+        else if (argument === "--release-manifest") {
+            parsed.releaseManifestPaths.push(resolve(requireValue(argv, ++index, "--release-manifest")));
+        }
         else if (argument === "--installed-release") {
             const value = requireValue(argv, ++index, "--installed-release");
             parsed.installedRelease = value === "unadopted" ? null : value;
         }
+        else if (argument === "--target-release") {
+            const value = requireValue(argv, ++index, "--target-release");
+            parsed.targetRelease = value === "none" ? null : value;
+        }
         else if (argument === "--mode") {
             const value = requireValue(argv, ++index, "--mode");
-            if (!["local", "ci", "preflight"].includes(value)) {
+            if (value !== "local" && value !== "ci" && value !== "preflight") {
                 throw new Error(`Invalid --mode ${value}.`);
             }
             parsed.mode = value;
@@ -50,6 +61,9 @@ export function parseBrandlabConformanceArgs(argv) {
             throw new Error(`Unknown argument ${argument}.`);
         }
     }
+    if (!parsed.help && parsed.supportPolicyPath === null) {
+        throw new Error("--support-policy is required.");
+    }
     return parsed;
 }
 export function runBrandlabConformanceCli(argv, io = {
@@ -62,10 +76,23 @@ export function runBrandlabConformanceCli(argv, io = {
             io.stdout(HELP);
             return 0;
         }
+        const supportPolicy = loadSupportPolicy(options.supportPolicyPath);
+        const policyManifestPaths = resolveSupportPolicyReleaseManifestPaths(options.supportPolicyPath, supportPolicy);
+        const releaseManifests = [
+            ...new Set([
+                ...policyManifestPaths,
+                ...options.releaseManifestPaths,
+            ]),
+        ]
+            .map(loadReleaseManifest)
+            .sort((left, right) => compareBrandlabSemver(left.releaseVersion, right.releaseVersion));
         const result = evaluateBrandlabProject({
             root: options.root,
             installedRelease: options.installedRelease,
+            targetRelease: options.targetRelease,
             mode: options.mode,
+            releaseManifests,
+            supportPolicy,
         });
         io.stdout(options.json ? `${JSON.stringify(result, null, 2)}\n` : formatResult(result));
         return shouldFailBrandlabConformance(result) ? 1 : 0;
@@ -75,33 +102,64 @@ export function runBrandlabConformanceCli(argv, io = {
         return 2;
     }
 }
+function loadSupportPolicy(path) {
+    if (path === null)
+        throw new Error("--support-policy is required.");
+    try {
+        return JSON.parse(readFileSync(path, "utf8"));
+    }
+    catch (error) {
+        const detail = error instanceof Error ? error.message : String(error);
+        throw new Error(`Unable to load support policy from ${path}: ${detail}`);
+    }
+}
+function loadReleaseManifest(path) {
+    try {
+        return JSON.parse(readFileSync(path, "utf8"));
+    }
+    catch (error) {
+        const detail = error instanceof Error ? error.message : String(error);
+        throw new Error(`Unable to load release manifest from ${path}: ${detail}`);
+    }
+}
+function resolveSupportPolicyReleaseManifestPaths(supportPolicyPath, supportPolicy) {
+    if (supportPolicyPath === null)
+        throw new Error("--support-policy is required.");
+    const references = Object.values(supportPolicy.releases ?? {}).map((release) => release?.manifest);
+    if (references.length === 0 ||
+        references.some((reference) => typeof reference !== "string" ||
+            reference.length === 0 ||
+            isAbsolute(reference) ||
+            reference.includes("\\") ||
+            reference.split("/").some((segment) => segment === ".."))) {
+        throw new Error("Support policy must use safe relative immutable release-manifest paths.");
+    }
+    let candidateRoot = dirname(supportPolicyPath);
+    while (true) {
+        const candidates = references.map((reference) => resolve(candidateRoot, reference));
+        if (candidates.every((candidate) => existsSync(candidate)))
+            return candidates;
+        const parent = dirname(candidateRoot);
+        if (parent === candidateRoot)
+            break;
+        candidateRoot = parent;
+    }
+    throw new Error(`Cannot resolve every support-policy release manifest from ${supportPolicyPath}.`);
+}
 function formatResult(result) {
-    const externalChecks = result.verification.checks.filter((check) => check.status === "not_run");
-    const staticStatus = result.verification.summary.blockers > 0
-        ? "blocked"
-        : result.verification.summary.warnings > 0
-            ? "warning"
-            : "pass";
     const lines = [
-        "Brandlab verification",
+        "Brandlab conformance",
         `installed: ${result.installedRelease ?? "unadopted"}`,
-        `policy: ${result.verification.policyVersion}`,
-        `static checks: ${staticStatus}`,
-        `external evidence: ${externalChecks.length > 0
-            ? `not run (${externalChecks.map((check) => check.title).join(", ")})`
-            : "complete"}`,
-        `findings: ${formatSummary(result.verification.summary)}`,
+        `target: ${result.targetRelease ?? "none"}`,
+        `maintenance: ${formatSummary(result.maintenance)}`,
+        `migration: ${formatSummary(result.migration)}`,
+        `advisory: ${formatSummary(result.advisory)}`,
     ];
-    for (const family of result.verification.families) {
-        if (family.status === "pass")
-            continue;
-        lines.push(`[${family.status}] ${family.title}: ${family.blockers} blocker(s), ${family.warnings} warning(s)`);
-    }
-    for (const finding of result.operationalFindings) {
+    for (const finding of result.findings) {
         const location = finding.path
             ? ` (${finding.path}${finding.line ? `:${finding.line}` : ""})`
             : "";
-        lines.push(`[${finding.familyId}/${finding.severity}] ${finding.ruleId}${location}: ${finding.actual}`);
+        lines.push(`[${finding.classification}/${finding.severity}] ${finding.ruleId}${location}: ${finding.actual}`);
     }
     return `${lines.join("\n")}\n`;
 }
@@ -114,17 +172,7 @@ function requireValue(argv, index, argument) {
         throw new Error(`${argument} requires a value.`);
     return value;
 }
-export function isBrandlabConformanceCliEntrypoint(moduleUrl, argvPath) {
-    if (!argvPath)
-        return false;
-    try {
-        return realpathSync(fileURLToPath(moduleUrl)) === realpathSync(resolve(argvPath));
-    }
-    catch {
-        return false;
-    }
-}
-if (isBrandlabConformanceCliEntrypoint(import.meta.url, process.argv[1])) {
+if (process.argv[1] && import.meta.url === pathToFileURL(resolve(process.argv[1])).href) {
     process.exitCode = runBrandlabConformanceCli(process.argv.slice(2));
 }
 //# sourceMappingURL=cli.js.map

package/dist/cli.js.map

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

package/dist/legacy-architecture-contracts.d.ts

@@ -0,0 +1,31 @@
+import { type BrandlabArchitectureConfigLike, type BrandlabArchitectureIssue, type BrandlabArchitectureReport } from "./vitest.js";
+export type BrandlabLegacyArchitectureContract = "architecture-v1" | "architecture-v2";
+export interface BrandlabLegacyArchitectureInspection {
+    contract: BrandlabLegacyArchitectureContract;
+    rulesetId: string;
+    report: BrandlabArchitectureReport;
+    issues: readonly BrandlabArchitectureIssue[];
+}
+/**
+ * Architecture v1 made only contract presence operationally blocking. The
+ * deeper architecture diagnosis existed, but did not become maintenance debt
+ * until architecture v2.
+ */
+export declare const BRANDLAB_LEGACY_ARCHITECTURE_V1_RULESET_ID = "legacy-architecture-v1-config-presence@6e9dfbd25280f1092b6d88c71c4164e5e9a53d4e";
+/**
+ * The v2 evaluator source is identical in Alpha.18, Alpha.19, Alpha.23 and
+ * RC.1. The evaluator depends on constants and helpers throughout vitest.ts,
+ * so that entire source module is the deliberate freeze boundary. Its digest
+ * is pinned by project.test.ts; later edits must introduce a new contract or
+ * immutable snapshot instead of silently becoming historical maintenance.
+ */
+export declare const BRANDLAB_LEGACY_ARCHITECTURE_V2_RULESET_ID = "legacy-architecture-v2@sha256:5f4979b80552b98b9bb558a3bbce12001bf354b05ea9b979c638c2d1a6c4cdac";
+export declare const BRANDLAB_LEGACY_ARCHITECTURE_V2_SOURCE_SHA256 = "5f4979b80552b98b9bb558a3bbce12001bf354b05ea9b979c638c2d1a6c4cdac";
+export declare function inspectLegacyArchitectureContract(options: {
+    root: string;
+    architecture: BrandlabArchitectureConfigLike | null | undefined;
+    contract: BrandlabLegacyArchitectureContract;
+}): BrandlabLegacyArchitectureInspection;
+export declare function legacyArchitectureRulesetId(contract: string | null | undefined): string | null;
+export declare function targetOnlyLegacyArchitectureIssues(installed: BrandlabLegacyArchitectureInspection | null, target: BrandlabLegacyArchitectureInspection): readonly BrandlabArchitectureIssue[];
+//# sourceMappingURL=legacy-architecture-contracts.d.ts.map

package/dist/legacy-architecture-contracts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"legacy-architecture-contracts.d.ts","sourceRoot":"","sources":["../src/legacy-architecture-contracts.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,8BAA8B,EACnC,KAAK,yBAAyB,EAC9B,KAAK,0BAA0B,EAChC,MAAM,aAAa,CAAC;AAErB,MAAM,MAAM,kCAAkC,GAC1C,iBAAiB,GACjB,iBAAiB,CAAC;AAEtB,MAAM,WAAW,oCAAoC;IACnD,QAAQ,EAAE,kCAAkC,CAAC;IAC7C,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,0BAA0B,CAAC;IACnC,MAAM,EAAE,SAAS,yBAAyB,EAAE,CAAC;CAC9C;AAED;;;;GAIG;AACH,eAAO,MAAM,0CAA0C,oFAC4B,CAAC;AAEpF;;;;;;GAMG;AACH,eAAO,MAAM,0CAA0C,mGAC2C,CAAC;AAEnG,eAAO,MAAM,6CAA6C,qEACU,CAAC;AAMrE,wBAAgB,iCAAiC,CAAC,OAAO,EAAE;IACzD,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,8BAA8B,GAAG,IAAI,GAAG,SAAS,CAAC;IAChE,QAAQ,EAAE,kCAAkC,CAAC;CAC9C,GAAG,oCAAoC,CAevC;AAED,wBAAgB,2BAA2B,CACzC,QAAQ,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAClC,MAAM,GAAG,IAAI,CAQf;AAED,wBAAgB,kCAAkC,CAChD,SAAS,EAAE,oCAAoC,GAAG,IAAI,EACtD,MAAM,EAAE,oCAAoC,GAC3C,SAAS,yBAAyB,EAAE,CAKtC"}

package/dist/legacy-architecture-contracts.js

@@ -0,0 +1,49 @@
+import { evaluateBrandlabArchitecture, } from "./vitest.js";
+/**
+ * Architecture v1 made only contract presence operationally blocking. The
+ * deeper architecture diagnosis existed, but did not become maintenance debt
+ * until architecture v2.
+ */
+export const BRANDLAB_LEGACY_ARCHITECTURE_V1_RULESET_ID = "legacy-architecture-v1-config-presence@6e9dfbd25280f1092b6d88c71c4164e5e9a53d4e";
+/**
+ * The v2 evaluator source is identical in Alpha.18, Alpha.19, Alpha.23 and
+ * RC.1. The evaluator depends on constants and helpers throughout vitest.ts,
+ * so that entire source module is the deliberate freeze boundary. Its digest
+ * is pinned by project.test.ts; later edits must introduce a new contract or
+ * immutable snapshot instead of silently becoming historical maintenance.
+ */
+export const BRANDLAB_LEGACY_ARCHITECTURE_V2_RULESET_ID = "legacy-architecture-v2@sha256:5f4979b80552b98b9bb558a3bbce12001bf354b05ea9b979c638c2d1a6c4cdac";
+export const BRANDLAB_LEGACY_ARCHITECTURE_V2_SOURCE_SHA256 = "5f4979b80552b98b9bb558a3bbce12001bf354b05ea9b979c638c2d1a6c4cdac";
+const V1_MAINTENANCE_RULE_IDS = new Set([
+    "brandlab-architecture-config-missing",
+]);
+export function inspectLegacyArchitectureContract(options) {
+    const report = evaluateBrandlabArchitecture({
+        root: options.root,
+        architecture: options.architecture,
+    });
+    return {
+        contract: options.contract,
+        rulesetId: options.contract === "architecture-v1"
+            ? BRANDLAB_LEGACY_ARCHITECTURE_V1_RULESET_ID
+            : BRANDLAB_LEGACY_ARCHITECTURE_V2_RULESET_ID,
+        report,
+        issues: options.contract === "architecture-v1"
+            ? report.issues.filter((issue) => V1_MAINTENANCE_RULE_IDS.has(issue.code))
+            : report.issues,
+    };
+}
+export function legacyArchitectureRulesetId(contract) {
+    if (contract === "architecture-v1") {
+        return BRANDLAB_LEGACY_ARCHITECTURE_V1_RULESET_ID;
+    }
+    if (contract === "architecture-v2") {
+        return BRANDLAB_LEGACY_ARCHITECTURE_V2_RULESET_ID;
+    }
+    return null;
+}
+export function targetOnlyLegacyArchitectureIssues(installed, target) {
+    const installedRuleIds = new Set((installed?.issues ?? []).map((issue) => issue.code));
+    return target.issues.filter((issue) => !installedRuleIds.has(issue.code));
+}
+//# sourceMappingURL=legacy-architecture-contracts.js.map

package/dist/legacy-architecture-contracts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"legacy-architecture-contracts.js","sourceRoot":"","sources":["../src/legacy-architecture-contracts.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,4BAA4B,GAI7B,MAAM,aAAa,CAAC;AAarB;;;;GAIG;AACH,MAAM,CAAC,MAAM,0CAA0C,GACrD,iFAAiF,CAAC;AAEpF;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,0CAA0C,GACrD,gGAAgG,CAAC;AAEnG,MAAM,CAAC,MAAM,6CAA6C,GACxD,kEAAkE,CAAC;AAErE,MAAM,uBAAuB,GAAG,IAAI,GAAG,CAAC;IACtC,sCAAsC;CACvC,CAAC,CAAC;AAEH,MAAM,UAAU,iCAAiC,CAAC,OAIjD;IACC,MAAM,MAAM,GAAG,4BAA4B,CAAC;QAC1C,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,YAAY,EAAE,OAAO,CAAC,YAAY;KACnC,CAAC,CAAC;IACH,OAAO;QACL,QAAQ,EAAE,OAAO,CAAC,QAAQ;QAC1B,SAAS,EAAE,OAAO,CAAC,QAAQ,KAAK,iBAAiB;YAC/C,CAAC,CAAC,0CAA0C;YAC5C,CAAC,CAAC,0CAA0C;QAC9C,MAAM;QACN,MAAM,EAAE,OAAO,CAAC,QAAQ,KAAK,iBAAiB;YAC5C,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,uBAAuB,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YAC1E,CAAC,CAAC,MAAM,CAAC,MAAM;KAClB,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,2BAA2B,CACzC,QAAmC;IAEnC,IAAI,QAAQ,KAAK,iBAAiB,EAAE,CAAC;QACnC,OAAO,0CAA0C,CAAC;IACpD,CAAC;IACD,IAAI,QAAQ,KAAK,iBAAiB,EAAE,CAAC;QACnC,OAAO,0CAA0C,CAAC;IACpD,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,UAAU,kCAAkC,CAChD,SAAsD,EACtD,MAA4C;IAE5C,MAAM,gBAAgB,GAAG,IAAI,GAAG,CAC9B,CAAC,SAAS,EAAE,MAAM,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CACrD,CAAC;IACF,OAAO,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,gBAAgB,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;AAC5E,CAAC"}

package/dist/locations.d.ts

@@ -0,0 +1,63 @@
+/**
+ * Location-page conformance rules (Brandlab Location Pages Standard §11).
+ *
+ * These checks are heuristics over project source text and sitemap output.
+ * They are deliberately conservative: each rule documents its escape hatch so
+ * a compliant pattern is never impossible, only explicit.
+ */
+import type { SourcePattern, SourcePatternMatch, SourceTextFile } from "./vitest.js";
+export declare const BRANDLAB_LOCATION_FORBIDDEN_SOURCE_PATTERNS: readonly SourcePattern[];
+/**
+ * Flags `approvedIndexable*` assignments whose value is produced by code
+ * (call/map/flatMap) instead of an explicit literal list (standard §7.4).
+ *
+ * Escape hatch: statements that reference an identifier containing "frozen"
+ * are allowed — that is the documented snapshot pattern (an explicit,
+ * human-edited literal module filtered into record shape).
+ */
+export declare function findGeneratedServiceLocationApprovals(files: readonly SourceTextFile[]): SourcePatternMatch[];
+export interface LocationLinkDumpOptions {
+    files: readonly SourceTextFile[];
+    /** Path prefixes that identify location URLs, e.g. ['/locations/']. */
+    locationPathPrefixes: readonly string[];
+    /** Only files whose path matches are checked. Default: footer/nav components. */
+    filePathPattern?: RegExp;
+    /** Maximum location links allowed per matching file. Default 20 (≈ regions, never all suburbs). */
+    maxLinks?: number;
+}
+export interface LocationLinkDumpFinding {
+    file: string;
+    linkCount: number;
+    maxLinks: number;
+}
+/**
+ * Flags footer/nav components that link a suburb dump (standard §6.6 — nav
+ * and footer carry region links only; "blocks of text that list cities and
+ * regions" is Google's own keyword-stuffing example).
+ */
+export declare function findLocationLinkDumps({ files, locationPathPrefixes, filePathPattern, maxLinks, }: LocationLinkDumpOptions): LocationLinkDumpFinding[];
+/**
+ * Copy-hygiene patterns for location data modules (standard §3.8). Applied to
+ * `src/data/locations/**` and `src/data/serviceLocations/**` rendered-string
+ * sources: unresolved tokens and template wording must never reach a
+ * customer-facing surface.
+ */
+export declare const BRANDLAB_LOCATION_COPY_PATTERNS: readonly SourcePattern[];
+export interface LocationUrlShareOptions {
+    /** All sitemap entry URLs (absolute or root-relative). */
+    urls: readonly string[];
+    /** Predicate identifying location-family URLs. */
+    isLocationUrl: (url: string) => boolean;
+    /** Warn when location URLs exceed this share of all URLs. Default 0.4 (standard §8.8). */
+    maxShare?: number;
+}
+export interface LocationUrlShareResult {
+    locationUrlCount: number;
+    totalUrlCount: number;
+    share: number;
+    maxShare: number;
+    exceeded: boolean;
+}
+/** Volume alarm for location-heavy sitemaps (standard §8.8). */
+export declare function evaluateLocationUrlShare({ urls, isLocationUrl, maxShare, }: LocationUrlShareOptions): LocationUrlShareResult;
+//# sourceMappingURL=locations.d.ts.map

package/dist/locations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"locations.d.ts","sourceRoot":"","sources":["../src/locations.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,KAAK,EAAE,aAAa,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAErF,eAAO,MAAM,2CAA2C,EAAE,SAAS,aAAa,EAkB/E,CAAC;AAEF;;;;;;;GAOG;AACH,wBAAgB,qCAAqC,CACnD,KAAK,EAAE,SAAS,cAAc,EAAE,GAC/B,kBAAkB,EAAE,CAuBtB;AAED,MAAM,WAAW,uBAAuB;IACtC,KAAK,EAAE,SAAS,cAAc,EAAE,CAAC;IACjC,uEAAuE;IACvE,oBAAoB,EAAE,SAAS,MAAM,EAAE,CAAC;IACxC,iFAAiF;IACjF,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,mGAAmG;IACnG,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,uBAAuB;IACtC,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,EACpC,KAAK,EACL,oBAAoB,EACpB,eAAiC,EACjC,QAAa,GACd,EAAE,uBAAuB,GAAG,uBAAuB,EAAE,CAiBrD;AAED;;;;;GAKG;AACH,eAAO,MAAM,+BAA+B,EAAE,SAAS,aAAa,EAcnE,CAAC;AAEF,MAAM,WAAW,uBAAuB;IACtC,0DAA0D;IAC1D,IAAI,EAAE,SAAS,MAAM,EAAE,CAAC;IACxB,kDAAkD;IAClD,aAAa,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC;IACxC,0FAA0F;IAC1F,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,sBAAsB;IACrC,gBAAgB,EAAE,MAAM,CAAC;IACzB,aAAa,EAAE,MAAM,CAAC;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED,gEAAgE;AAChE,wBAAgB,wBAAwB,CAAC,EACvC,IAAI,EACJ,aAAa,EACb,QAAc,GACf,EAAE,uBAAuB,GAAG,sBAAsB,CAYlD"}

package/dist/locations.js

@@ -0,0 +1,105 @@
+export const BRANDLAB_LOCATION_FORBIDDEN_SOURCE_PATTERNS = [
+    {
+        // Rating markup about the business/its services is never emitted
+        // (standard §6.2). Matches emission sites, not prose/comments.
+        name: "self-serving rating schema emission",
+        pattern: /['"]@type['"]\s*:\s*['"](?:AggregateRating|Review)['"]/,
+    },
+    {
+        name: "self-serving rating schema builder",
+        pattern: /\bbuild(?:Service)?(?:AggregateRating|Rating|Review)Schema\b/,
+    },
+    {
+        // Named constant reused as every sitemap entry's lastModified defeats
+        // the freshness signal (standard §6.3). Use per-record
+        // lastSubstantialUpdate dates instead.
+        name: "constant sitemap lastModified",
+        pattern: /lastModified\s*:\s*SITEMAP_LAST_MODIFIED\b/,
+    },
+];
+/**
+ * Flags `approvedIndexable*` assignments whose value is produced by code
+ * (call/map/flatMap) instead of an explicit literal list (standard §7.4).
+ *
+ * Escape hatch: statements that reference an identifier containing "frozen"
+ * are allowed — that is the documented snapshot pattern (an explicit,
+ * human-edited literal module filtered into record shape).
+ */
+export function findGeneratedServiceLocationApprovals(files) {
+    const matches = [];
+    const assignment = /\bapprovedIndexable\w*\s*[:=]/;
+    const generated = /[:=][^;\n]*(?:\.flatMap\(|\.map\(|\w+\(\s*\))/;
+    for (const file of files) {
+        const lines = file.text.split("\n");
+        lines.forEach((line, index) => {
+            if (!assignment.test(line))
+                return;
+            if (/frozen/i.test(line))
+                return;
+            if (!generated.test(line))
+                return;
+            matches.push({
+                file: file.path,
+                patternName: "generated service-location approvals",
+                line: index + 1,
+                column: line.search(assignment) + 1,
+                text: line.trim(),
+            });
+        });
+    }
+    return matches;
+}
+/**
+ * Flags footer/nav components that link a suburb dump (standard §6.6 — nav
+ * and footer carry region links only; "blocks of text that list cities and
+ * regions" is Google's own keyword-stuffing example).
+ */
+export function findLocationLinkDumps({ files, locationPathPrefixes, filePathPattern = /(footer|nav)/i, maxLinks = 20, }) {
+    const findings = [];
+    for (const file of files) {
+        if (!filePathPattern.test(file.path))
+            continue;
+        let linkCount = 0;
+        for (const prefix of locationPathPrefixes) {
+            linkCount += file.text.split(prefix).length - 1;
+        }
+        if (linkCount > maxLinks) {
+            findings.push({ file: file.path, linkCount, maxLinks });
+        }
+    }
+    return findings;
+}
+/**
+ * Copy-hygiene patterns for location data modules (standard §3.8). Applied to
+ * `src/data/locations/**` and `src/data/serviceLocations/**` rendered-string
+ * sources: unresolved tokens and template wording must never reach a
+ * customer-facing surface.
+ */
+export const BRANDLAB_LOCATION_COPY_PATTERNS = [
+    {
+        name: "unresolved bracket token",
+        pattern: /\[(?:Suburb|Region|Location|Service|Business Name|Phone|Email)\]/,
+    },
+    {
+        name: "unresolved curly token in string",
+        pattern: /['"`][^'"`\n]*\{(?:suburb|region|location|service)\}[^'"`\n]*['"`]/,
+    },
+    {
+        name: "template wording",
+        pattern: /\b(?:lorem ipsum|placeholder copy|copy goes here|content goes here|insert copy|TODO copy|sample copy|starter copy|boilerplate copy)\b/i,
+    },
+];
+/** Volume alarm for location-heavy sitemaps (standard §8.8). */
+export function evaluateLocationUrlShare({ urls, isLocationUrl, maxShare = 0.4, }) {
+    const totalUrlCount = urls.length;
+    const locationUrlCount = urls.filter((url) => isLocationUrl(url)).length;
+    const share = totalUrlCount === 0 ? 0 : locationUrlCount / totalUrlCount;
+    return {
+        locationUrlCount,
+        totalUrlCount,
+        share,
+        maxShare,
+        exceeded: share > maxShare,
+    };
+}
+//# sourceMappingURL=locations.js.map

package/dist/locations.js.map

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

package/dist/project-config-v2-contract.d.ts

@@ -0,0 +1,32 @@
+export declare const BRANDLAB_CONFIG_V2_RULESET_ID = "project-config-v2@1.0.0-rc.1:5d6c4a9a27abd65e5a8e55d5f66145ff499ead7d";
+export declare const BRANDLAB_CONFIG_V2_PROFILES: readonly ["next-local-service", "next-root-level", "next-static-legacy", "legacy-php"];
+export interface InspectedBrandlabProjectConfig {
+    projectId: string;
+    profile: (typeof BRANDLAB_CONFIG_V2_PROFILES)[number];
+    routes: {
+        families: readonly string[];
+    };
+    capabilities: {
+        blogAdapter: string | null;
+        contactEnabled: boolean;
+    };
+}
+export interface BrandlabConfigV2Issue {
+    ruleId: string;
+    surface: string;
+    severity: "blocker" | "warning" | "info";
+    evidenceKind: "static" | "behavioural" | "runtime";
+    path?: string;
+    line?: number;
+    expected: string;
+    actual: string;
+    remediation: string;
+}
+export interface BrandlabConfigV2Inspection {
+    config: InspectedBrandlabProjectConfig | null;
+    imports: ReadonlySet<string>;
+    executableImports: ReadonlySet<string>;
+    issues: BrandlabConfigV2Issue[];
+}
+export declare function inspectBrandlabConfigV2(root: string): BrandlabConfigV2Inspection;
+//# sourceMappingURL=project-config-v2-contract.d.ts.map

package/dist/project-config-v2-contract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-config-v2-contract.d.ts","sourceRoot":"","sources":["../src/project-config-v2-contract.ts"],"names":[],"mappings":"AAYA,eAAO,MAAM,6BAA6B,0EAC+B,CAAC;AAE1E,eAAO,MAAM,2BAA2B,wFAK9B,CAAC;AA0CX,MAAM,WAAW,8BAA8B;IAC7C,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,CAAC,OAAO,2BAA2B,CAAC,CAAC,MAAM,CAAC,CAAC;IACtD,MAAM,EAAE;QACN,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;KAC7B,CAAC;IACF,YAAY,EAAE;QACZ,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;QAC3B,cAAc,EAAE,OAAO,CAAC;KACzB,CAAC;CACH;AAED,MAAM,WAAW,qBAAqB;IACpC,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,SAAS,GAAG,SAAS,GAAG,MAAM,CAAC;IACzC,YAAY,EAAE,QAAQ,GAAG,aAAa,GAAG,SAAS,CAAC;IACnD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,0BAA0B;IACzC,MAAM,EAAE,8BAA8B,GAAG,IAAI,CAAC;IAC9C,OAAO,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IAC7B,iBAAiB,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IACvC,MAAM,EAAE,qBAAqB,EAAE,CAAC;CACjC;AAqDD,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,GAAG,0BAA0B,CA2FhF"}