@usefragments/core 1.5.1 → 1.6.0

package/dist/{governance-B88uR3Zq.d.ts → governance-DxFipN5V.d.ts}

@@ -915,7 +915,10 @@ type TokenSourceFormat = "auto" | "css" | "scss" | "dtcg" | "tailwind";
 interface TokenSourceConfig {
     /** Repo-root-relative token file or glob. */
     path: RepoRelativePath;
-    /** Explicit token format, or "auto" to infer from extension/content. */
+    /**
+     * Explicit token format, or "auto" to infer from extension/content. Use
+     * "auto" for statically analyzable TypeScript and JavaScript token modules.
+     */
     format?: TokenSourceFormat;
 }
 interface TokenConfig {
@@ -924,7 +927,10 @@ interface TokenConfig {
      * e.g., ["src/styles/theme.scss", "src/styles/variables.css"]
      */
     include?: string[];
-    /** Repo-root-relative token source files/globs for monorepos and Cloud setup. */
+    /**
+     * Repo-root-relative token source files/globs for monorepos and Cloud setup.
+     * Set each source to format "auto" for TypeScript or JavaScript token modules.
+     */
     sources?: TokenSourceConfig[];
     /**
      * npm package names whose shipped `fragments.json` token vocabulary seeds the
@@ -956,7 +962,10 @@ interface TokenConfig {
     themeSelectors?: Record<string, string>;
     /** Enable token comparison in style diffs (default: true) */
     enabled?: boolean;
-    /** Token source format detection ('auto' detects from file extension) */
+    /**
+     * Token source format detection. "auto" infers supported formats from the
+     * file extension, including statically analyzable TypeScript/JavaScript modules.
+     */
     format?: TokenSourceFormat;
     /** Vendor namespace for Fragments extensions in DTCG files (default: 'com.usefragments') */
     namespace?: string;
@@ -1116,12 +1125,17 @@ interface FragmentsConfig {
     recognizedClassHelpers?: string[];
     /** Local component-identity decisions used when Cloud does not own the key. */
     identity?: {
+        /** Authored sanctions, rejections, and dismissals keyed by portable component identity. */
         decisions?: Array<{
             /** Portable component key (`file#exportName`). */
             component: string;
+            /** The identity disposition recorded for this component. */
             kind: "sanction" | "reject" | "dismiss";
+            /** Optional canonical target (`moduleSpecifier#exportName`) for sanctions. */
             canonicalTarget?: string;
+            /** Human-readable rationale stored with the decision. */
             reason?: string;
+            /** Stable external identifier used to reconcile an existing decision. */
             decisionId?: string;
         }>;
     };
@@ -1350,89 +1364,215 @@ declare const globalStyleGovernanceRecordSchema: z.ZodDiscriminatedUnion<"kind",
     except: z.ZodArray<z.ZodString, "many">;
     prefer: z.ZodEnum<["token", "css-variable"]>;
     severity: z.ZodEnum<["error", "warn", "info"]>;
+    exclude: z.ZodOptional<z.ZodArray<z.ZodUnion<[z.ZodString, z.ZodObject<{
+        glob: z.ZodString;
+        reason: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        glob: string;
+        reason?: string | undefined;
+    }, {
+        glob: string;
+        reason?: string | undefined;
+    }>]>, "many">>;
 }, "strip", z.ZodTypeAny, {
     kind: "style.rawColors.forbid";
     severity: "error" | "info" | "warn";
     except: string[];
     prefer: "token" | "css-variable";
+    exclude?: (string | {
+        glob: string;
+        reason?: string | undefined;
+    })[] | undefined;
 }, {
     kind: "style.rawColors.forbid";
     severity: "error" | "info" | "warn";
     except: string[];
     prefer: "token" | "css-variable";
+    exclude?: (string | {
+        glob: string;
+        reason?: string | undefined;
+    })[] | undefined;
 }>, z.ZodObject<{
     kind: z.ZodLiteral<"style.rawDimensions.forbid">;
     appliesTo: z.ZodArray<z.ZodString, "many">;
     prefer: z.ZodEnum<["token", "css-variable"]>;
     severity: z.ZodEnum<["error", "warn", "info"]>;
+    exclude: z.ZodOptional<z.ZodArray<z.ZodUnion<[z.ZodString, z.ZodObject<{
+        glob: z.ZodString;
+        reason: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        glob: string;
+        reason?: string | undefined;
+    }, {
+        glob: string;
+        reason?: string | undefined;
+    }>]>, "many">>;
 }, "strip", z.ZodTypeAny, {
     kind: "style.rawDimensions.forbid";
     severity: "error" | "info" | "warn";
     prefer: "token" | "css-variable";
     appliesTo: string[];
+    exclude?: (string | {
+        glob: string;
+        reason?: string | undefined;
+    })[] | undefined;
 }, {
     kind: "style.rawDimensions.forbid";
     severity: "error" | "info" | "warn";
     prefer: "token" | "css-variable";
     appliesTo: string[];
+    exclude?: (string | {
+        glob: string;
+        reason?: string | undefined;
+    })[] | undefined;
 }>, z.ZodObject<{
     kind: z.ZodLiteral<"style.rawSpacing.mustMatchScale">;
     scale: z.ZodString;
     appliesTo: z.ZodArray<z.ZodString, "many">;
     severity: z.ZodEnum<["error", "warn", "info"]>;
+    exclude: z.ZodOptional<z.ZodArray<z.ZodUnion<[z.ZodString, z.ZodObject<{
+        glob: z.ZodString;
+        reason: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        glob: string;
+        reason?: string | undefined;
+    }, {
+        glob: string;
+        reason?: string | undefined;
+    }>]>, "many">>;
 }, "strip", z.ZodTypeAny, {
     kind: "style.rawSpacing.mustMatchScale";
     severity: "error" | "info" | "warn";
     scale: string;
     appliesTo: string[];
+    exclude?: (string | {
+        glob: string;
+        reason?: string | undefined;
+    })[] | undefined;
 }, {
     kind: "style.rawSpacing.mustMatchScale";
     severity: "error" | "info" | "warn";
     scale: string;
     appliesTo: string[];
+    exclude?: (string | {
+        glob: string;
+        reason?: string | undefined;
+    })[] | undefined;
 }>, z.ZodObject<{
     kind: z.ZodLiteral<"style.fontSize.mustMatchScale">;
     scale: z.ZodString;
     severity: z.ZodEnum<["error", "warn", "info"]>;
+    exclude: z.ZodOptional<z.ZodArray<z.ZodUnion<[z.ZodString, z.ZodObject<{
+        glob: z.ZodString;
+        reason: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        glob: string;
+        reason?: string | undefined;
+    }, {
+        glob: string;
+        reason?: string | undefined;
+    }>]>, "many">>;
 }, "strip", z.ZodTypeAny, {
     kind: "style.fontSize.mustMatchScale";
     severity: "error" | "info" | "warn";
     scale: string;
+    exclude?: (string | {
+        glob: string;
+        reason?: string | undefined;
+    })[] | undefined;
 }, {
     kind: "style.fontSize.mustMatchScale";
     severity: "error" | "info" | "warn";
     scale: string;
+    exclude?: (string | {
+        glob: string;
+        reason?: string | undefined;
+    })[] | undefined;
 }>, z.ZodObject<{
     kind: z.ZodLiteral<"style.cssVars.mustBeDefined">;
     severity: z.ZodEnum<["error", "warn", "info"]>;
+    exclude: z.ZodOptional<z.ZodArray<z.ZodUnion<[z.ZodString, z.ZodObject<{
+        glob: z.ZodString;
+        reason: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        glob: string;
+        reason?: string | undefined;
+    }, {
+        glob: string;
+        reason?: string | undefined;
+    }>]>, "many">>;
 }, "strip", z.ZodTypeAny, {
     kind: "style.cssVars.mustBeDefined";
     severity: "error" | "info" | "warn";
+    exclude?: (string | {
+        glob: string;
+        reason?: string | undefined;
+    })[] | undefined;
 }, {
     kind: "style.cssVars.mustBeDefined";
     severity: "error" | "info" | "warn";
+    exclude?: (string | {
+        glob: string;
+        reason?: string | undefined;
+    })[] | undefined;
 }>]>;
 declare const globalJsxGovernanceRecordSchema: z.ZodDiscriminatedUnion<"kind", [z.ZodObject<{
     kind: z.ZodLiteral<"jsx.unknownProps.forbid">;
     severity: z.ZodEnum<["error", "warn", "info"]>;
+    exclude: z.ZodOptional<z.ZodArray<z.ZodUnion<[z.ZodString, z.ZodObject<{
+        glob: z.ZodString;
+        reason: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        glob: string;
+        reason?: string | undefined;
+    }, {
+        glob: string;
+        reason?: string | undefined;
+    }>]>, "many">>;
 }, "strip", z.ZodTypeAny, {
     kind: "jsx.unknownProps.forbid";
     severity: "error" | "info" | "warn";
+    exclude?: (string | {
+        glob: string;
+        reason?: string | undefined;
+    })[] | undefined;
 }, {
     kind: "jsx.unknownProps.forbid";
     severity: "error" | "info" | "warn";
+    exclude?: (string | {
+        glob: string;
+        reason?: string | undefined;
+    })[] | undefined;
 }>, z.ZodObject<{
     kind: z.ZodLiteral<"jsx.inlineStyle.forbidRaw">;
     properties: z.ZodArray<z.ZodString, "many">;
     severity: z.ZodEnum<["error", "warn", "info"]>;
+    exclude: z.ZodOptional<z.ZodArray<z.ZodUnion<[z.ZodString, z.ZodObject<{
+        glob: z.ZodString;
+        reason: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        glob: string;
+        reason?: string | undefined;
+    }, {
+        glob: string;
+        reason?: string | undefined;
+    }>]>, "many">>;
 }, "strip", z.ZodTypeAny, {
     kind: "jsx.inlineStyle.forbidRaw";
     severity: "error" | "info" | "warn";
     properties: string[];
+    exclude?: (string | {
+        glob: string;
+        reason?: string | undefined;
+    })[] | undefined;
 }, {
     kind: "jsx.inlineStyle.forbidRaw";
     severity: "error" | "info" | "warn";
     properties: string[];
+    exclude?: (string | {
+        glob: string;
+        reason?: string | undefined;
+    })[] | undefined;
 }>, z.ZodObject<{
     kind: z.ZodLiteral<"jsx.importPath.prefer">;
     from: z.ZodString;
@@ -1440,11 +1580,25 @@ declare const globalJsxGovernanceRecordSchema: z.ZodDiscriminatedUnion<"kind", [
     imported: z.ZodOptional<z.ZodString>;
     because: z.ZodOptional<z.ZodString>;
     severity: z.ZodEnum<["error", "warn", "info"]>;
+    exclude: z.ZodOptional<z.ZodArray<z.ZodUnion<[z.ZodString, z.ZodObject<{
+        glob: z.ZodString;
+        reason: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        glob: string;
+        reason?: string | undefined;
+    }, {
+        glob: string;
+        reason?: string | undefined;
+    }>]>, "many">>;
 }, "strip", z.ZodTypeAny, {
     kind: "jsx.importPath.prefer";
     from: string;
     to: string;
     severity: "error" | "info" | "warn";
+    exclude?: (string | {
+        glob: string;
+        reason?: string | undefined;
+    })[] | undefined;
     imported?: string | undefined;
     because?: string | undefined;
 }, {
@@ -1452,6 +1606,10 @@ declare const globalJsxGovernanceRecordSchema: z.ZodDiscriminatedUnion<"kind", [
     from: string;
     to: string;
     severity: "error" | "info" | "warn";
+    exclude?: (string | {
+        glob: string;
+        reason?: string | undefined;
+    })[] | undefined;
     imported?: string | undefined;
     because?: string | undefined;
 }>, z.ZodObject<{
@@ -1460,17 +1618,35 @@ declare const globalJsxGovernanceRecordSchema: z.ZodDiscriminatedUnion<"kind", [
     to: z.ZodString;
     because: z.ZodOptional<z.ZodString>;
     severity: z.ZodEnum<["error", "warn", "info"]>;
+    exclude: z.ZodOptional<z.ZodArray<z.ZodUnion<[z.ZodString, z.ZodObject<{
+        glob: z.ZodString;
+        reason: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        glob: string;
+        reason?: string | undefined;
+    }, {
+        glob: string;
+        reason?: string | undefined;
+    }>]>, "many">>;
 }, "strip", z.ZodTypeAny, {
     kind: "jsx.component.prefer";
     from: string;
     to: string;
     severity: "error" | "info" | "warn";
+    exclude?: (string | {
+        glob: string;
+        reason?: string | undefined;
+    })[] | undefined;
     because?: string | undefined;
 }, {
     kind: "jsx.component.prefer";
     from: string;
     to: string;
     severity: "error" | "info" | "warn";
+    exclude?: (string | {
+        glob: string;
+        reason?: string | undefined;
+    })[] | undefined;
     because?: string | undefined;
 }>]>;
 declare const globalGovernanceRecordSchema: z.ZodDiscriminatedUnion<"kind", [z.ZodObject<{
@@ -1499,88 +1675,214 @@ declare const globalGovernanceRecordSchema: z.ZodDiscriminatedUnion<"kind", [z.Z
     except: z.ZodArray<z.ZodString, "many">;
     prefer: z.ZodEnum<["token", "css-variable"]>;
     severity: z.ZodEnum<["error", "warn", "info"]>;
+    exclude: z.ZodOptional<z.ZodArray<z.ZodUnion<[z.ZodString, z.ZodObject<{
+        glob: z.ZodString;
+        reason: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        glob: string;
+        reason?: string | undefined;
+    }, {
+        glob: string;
+        reason?: string | undefined;
+    }>]>, "many">>;
 }, "strip", z.ZodTypeAny, {
     kind: "style.rawColors.forbid";
     severity: "error" | "info" | "warn";
     except: string[];
     prefer: "token" | "css-variable";
+    exclude?: (string | {
+        glob: string;
+        reason?: string | undefined;
+    })[] | undefined;
 }, {
     kind: "style.rawColors.forbid";
     severity: "error" | "info" | "warn";
     except: string[];
     prefer: "token" | "css-variable";
+    exclude?: (string | {
+        glob: string;
+        reason?: string | undefined;
+    })[] | undefined;
 }>, z.ZodObject<{
     kind: z.ZodLiteral<"style.rawDimensions.forbid">;
     appliesTo: z.ZodArray<z.ZodString, "many">;
     prefer: z.ZodEnum<["token", "css-variable"]>;
     severity: z.ZodEnum<["error", "warn", "info"]>;
+    exclude: z.ZodOptional<z.ZodArray<z.ZodUnion<[z.ZodString, z.ZodObject<{
+        glob: z.ZodString;
+        reason: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        glob: string;
+        reason?: string | undefined;
+    }, {
+        glob: string;
+        reason?: string | undefined;
+    }>]>, "many">>;
 }, "strip", z.ZodTypeAny, {
     kind: "style.rawDimensions.forbid";
     severity: "error" | "info" | "warn";
     prefer: "token" | "css-variable";
     appliesTo: string[];
+    exclude?: (string | {
+        glob: string;
+        reason?: string | undefined;
+    })[] | undefined;
 }, {
     kind: "style.rawDimensions.forbid";
     severity: "error" | "info" | "warn";
     prefer: "token" | "css-variable";
     appliesTo: string[];
+    exclude?: (string | {
+        glob: string;
+        reason?: string | undefined;
+    })[] | undefined;
 }>, z.ZodObject<{
     kind: z.ZodLiteral<"style.rawSpacing.mustMatchScale">;
     scale: z.ZodString;
     appliesTo: z.ZodArray<z.ZodString, "many">;
     severity: z.ZodEnum<["error", "warn", "info"]>;
+    exclude: z.ZodOptional<z.ZodArray<z.ZodUnion<[z.ZodString, z.ZodObject<{
+        glob: z.ZodString;
+        reason: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        glob: string;
+        reason?: string | undefined;
+    }, {
+        glob: string;
+        reason?: string | undefined;
+    }>]>, "many">>;
 }, "strip", z.ZodTypeAny, {
     kind: "style.rawSpacing.mustMatchScale";
     severity: "error" | "info" | "warn";
     scale: string;
     appliesTo: string[];
+    exclude?: (string | {
+        glob: string;
+        reason?: string | undefined;
+    })[] | undefined;
 }, {
     kind: "style.rawSpacing.mustMatchScale";
     severity: "error" | "info" | "warn";
     scale: string;
     appliesTo: string[];
+    exclude?: (string | {
+        glob: string;
+        reason?: string | undefined;
+    })[] | undefined;
 }>, z.ZodObject<{
     kind: z.ZodLiteral<"style.fontSize.mustMatchScale">;
     scale: z.ZodString;
     severity: z.ZodEnum<["error", "warn", "info"]>;
+    exclude: z.ZodOptional<z.ZodArray<z.ZodUnion<[z.ZodString, z.ZodObject<{
+        glob: z.ZodString;
+        reason: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        glob: string;
+        reason?: string | undefined;
+    }, {
+        glob: string;
+        reason?: string | undefined;
+    }>]>, "many">>;
 }, "strip", z.ZodTypeAny, {
     kind: "style.fontSize.mustMatchScale";
     severity: "error" | "info" | "warn";
     scale: string;
+    exclude?: (string | {
+        glob: string;
+        reason?: string | undefined;
+    })[] | undefined;
 }, {
     kind: "style.fontSize.mustMatchScale";
     severity: "error" | "info" | "warn";
     scale: string;
+    exclude?: (string | {
+        glob: string;
+        reason?: string | undefined;
+    })[] | undefined;
 }>, z.ZodObject<{
     kind: z.ZodLiteral<"style.cssVars.mustBeDefined">;
     severity: z.ZodEnum<["error", "warn", "info"]>;
+    exclude: z.ZodOptional<z.ZodArray<z.ZodUnion<[z.ZodString, z.ZodObject<{
+        glob: z.ZodString;
+        reason: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        glob: string;
+        reason?: string | undefined;
+    }, {
+        glob: string;
+        reason?: string | undefined;
+    }>]>, "many">>;
 }, "strip", z.ZodTypeAny, {
     kind: "style.cssVars.mustBeDefined";
     severity: "error" | "info" | "warn";
+    exclude?: (string | {
+        glob: string;
+        reason?: string | undefined;
+    })[] | undefined;
 }, {
     kind: "style.cssVars.mustBeDefined";
     severity: "error" | "info" | "warn";
+    exclude?: (string | {
+        glob: string;
+        reason?: string | undefined;
+    })[] | undefined;
 }>, z.ZodObject<{
     kind: z.ZodLiteral<"jsx.unknownProps.forbid">;
     severity: z.ZodEnum<["error", "warn", "info"]>;
+    exclude: z.ZodOptional<z.ZodArray<z.ZodUnion<[z.ZodString, z.ZodObject<{
+        glob: z.ZodString;
+        reason: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        glob: string;
+        reason?: string | undefined;
+    }, {
+        glob: string;
+        reason?: string | undefined;
+    }>]>, "many">>;
 }, "strip", z.ZodTypeAny, {
     kind: "jsx.unknownProps.forbid";
     severity: "error" | "info" | "warn";
+    exclude?: (string | {
+        glob: string;
+        reason?: string | undefined;
+    })[] | undefined;
 }, {
     kind: "jsx.unknownProps.forbid";
     severity: "error" | "info" | "warn";
+    exclude?: (string | {
+        glob: string;
+        reason?: string | undefined;
+    })[] | undefined;
 }>, z.ZodObject<{
     kind: z.ZodLiteral<"jsx.inlineStyle.forbidRaw">;
     properties: z.ZodArray<z.ZodString, "many">;
     severity: z.ZodEnum<["error", "warn", "info"]>;
+    exclude: z.ZodOptional<z.ZodArray<z.ZodUnion<[z.ZodString, z.ZodObject<{
+        glob: z.ZodString;
+        reason: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        glob: string;
+        reason?: string | undefined;
+    }, {
+        glob: string;
+        reason?: string | undefined;
+    }>]>, "many">>;
 }, "strip", z.ZodTypeAny, {
     kind: "jsx.inlineStyle.forbidRaw";
     severity: "error" | "info" | "warn";
     properties: string[];
+    exclude?: (string | {
+        glob: string;
+        reason?: string | undefined;
+    })[] | undefined;
 }, {
     kind: "jsx.inlineStyle.forbidRaw";
     severity: "error" | "info" | "warn";
     properties: string[];
+    exclude?: (string | {
+        glob: string;
+        reason?: string | undefined;
+    })[] | undefined;
 }>, z.ZodObject<{
     kind: z.ZodLiteral<"jsx.importPath.prefer">;
     from: z.ZodString;
@@ -1588,11 +1890,25 @@ declare const globalGovernanceRecordSchema: z.ZodDiscriminatedUnion<"kind", [z.Z
     imported: z.ZodOptional<z.ZodString>;
     because: z.ZodOptional<z.ZodString>;
     severity: z.ZodEnum<["error", "warn", "info"]>;
+    exclude: z.ZodOptional<z.ZodArray<z.ZodUnion<[z.ZodString, z.ZodObject<{
+        glob: z.ZodString;
+        reason: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        glob: string;
+        reason?: string | undefined;
+    }, {
+        glob: string;
+        reason?: string | undefined;
+    }>]>, "many">>;
 }, "strip", z.ZodTypeAny, {
     kind: "jsx.importPath.prefer";
     from: string;
     to: string;
     severity: "error" | "info" | "warn";
+    exclude?: (string | {
+        glob: string;
+        reason?: string | undefined;
+    })[] | undefined;
     imported?: string | undefined;
     because?: string | undefined;
 }, {
@@ -1600,6 +1916,10 @@ declare const globalGovernanceRecordSchema: z.ZodDiscriminatedUnion<"kind", [z.Z
     from: string;
     to: string;
     severity: "error" | "info" | "warn";
+    exclude?: (string | {
+        glob: string;
+        reason?: string | undefined;
+    })[] | undefined;
     imported?: string | undefined;
     because?: string | undefined;
 }>, z.ZodObject<{
@@ -1608,17 +1928,35 @@ declare const globalGovernanceRecordSchema: z.ZodDiscriminatedUnion<"kind", [z.Z
     to: z.ZodString;
     because: z.ZodOptional<z.ZodString>;
     severity: z.ZodEnum<["error", "warn", "info"]>;
+    exclude: z.ZodOptional<z.ZodArray<z.ZodUnion<[z.ZodString, z.ZodObject<{
+        glob: z.ZodString;
+        reason: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        glob: string;
+        reason?: string | undefined;
+    }, {
+        glob: string;
+        reason?: string | undefined;
+    }>]>, "many">>;
 }, "strip", z.ZodTypeAny, {
     kind: "jsx.component.prefer";
     from: string;
     to: string;
     severity: "error" | "info" | "warn";
+    exclude?: (string | {
+        glob: string;
+        reason?: string | undefined;
+    })[] | undefined;
     because?: string | undefined;
 }, {
     kind: "jsx.component.prefer";
     from: string;
     to: string;
     severity: "error" | "info" | "warn";
+    exclude?: (string | {
+        glob: string;
+        reason?: string | undefined;
+    })[] | undefined;
     because?: string | undefined;
 }>]>;
 declare const componentGovernanceRecordSchema: z.ZodDiscriminatedUnion<"kind", [z.ZodObject<{
@@ -2226,15 +2564,15 @@ declare const canonicalSourceSchema: z.ZodDiscriminatedUnion<"kind", [z.ZodObjec
 }, "strip", z.ZodTypeAny, {
     kind: "npm";
     specifier: string;
+    exclude?: string[] | undefined;
     implementationPath?: string | undefined;
     include?: string[] | undefined;
-    exclude?: string[] | undefined;
 }, {
     kind: "npm";
     specifier: string;
+    exclude?: string[] | undefined;
     implementationPath?: string | undefined;
     include?: string[] | undefined;
-    exclude?: string[] | undefined;
 }>, z.ZodObject<{
     kind: z.ZodLiteral<"directory">;
     path: z.ZodString;
@@ -2243,13 +2581,13 @@ declare const canonicalSourceSchema: z.ZodDiscriminatedUnion<"kind", [z.ZodObjec
 }, "strip", z.ZodTypeAny, {
     path: string;
     kind: "directory";
-    include?: string[] | undefined;
     exclude?: string[] | undefined;
+    include?: string[] | undefined;
 }, {
     path: string;
     kind: "directory";
-    include?: string[] | undefined;
     exclude?: string[] | undefined;
+    include?: string[] | undefined;
 }>, z.ZodObject<{
     kind: z.ZodLiteral<"registry">;
     registryId: z.ZodString;
@@ -2267,8 +2605,8 @@ declare const canonicalSourceSchema: z.ZodDiscriminatedUnion<"kind", [z.ZodObjec
     installPath: string;
     severity?: "error" | "info" | "warn" | undefined;
     importPath?: string | undefined;
-    include?: string[] | undefined;
     exclude?: string[] | undefined;
+    include?: string[] | undefined;
     registryHash?: string | undefined;
 }, {
     kind: "registry";
@@ -2276,8 +2614,8 @@ declare const canonicalSourceSchema: z.ZodDiscriminatedUnion<"kind", [z.ZodObjec
     installPath: string;
     severity?: "error" | "info" | "warn" | undefined;
     importPath?: string | undefined;
-    include?: string[] | undefined;
     exclude?: string[] | undefined;
+    include?: string[] | undefined;
     registryHash?: string | undefined;
     receiptPath?: string | undefined;
 }>]>;
@@ -2303,15 +2641,15 @@ declare const governanceConfigSchema: z.ZodObject<{
     }, "strip", z.ZodTypeAny, {
         kind: "npm";
         specifier: string;
+        exclude?: string[] | undefined;
         implementationPath?: string | undefined;
         include?: string[] | undefined;
-        exclude?: string[] | undefined;
     }, {
         kind: "npm";
         specifier: string;
+        exclude?: string[] | undefined;
         implementationPath?: string | undefined;
         include?: string[] | undefined;
-        exclude?: string[] | undefined;
     }>, z.ZodObject<{
         kind: z.ZodLiteral<"directory">;
         path: z.ZodString;
@@ -2320,13 +2658,13 @@ declare const governanceConfigSchema: z.ZodObject<{
     }, "strip", z.ZodTypeAny, {
         path: string;
         kind: "directory";
-        include?: string[] | undefined;
         exclude?: string[] | undefined;
+        include?: string[] | undefined;
     }, {
         path: string;
         kind: "directory";
-        include?: string[] | undefined;
         exclude?: string[] | undefined;
+        include?: string[] | undefined;
     }>, z.ZodObject<{
         kind: z.ZodLiteral<"registry">;
         registryId: z.ZodString;
@@ -2344,8 +2682,8 @@ declare const governanceConfigSchema: z.ZodObject<{
         installPath: string;
         severity?: "error" | "info" | "warn" | undefined;
         importPath?: string | undefined;
-        include?: string[] | undefined;
         exclude?: string[] | undefined;
+        include?: string[] | undefined;
         registryHash?: string | undefined;
     }, {
         kind: "registry";
@@ -2353,8 +2691,8 @@ declare const governanceConfigSchema: z.ZodObject<{
         installPath: string;
         severity?: "error" | "info" | "warn" | undefined;
         importPath?: string | undefined;
-        include?: string[] | undefined;
         exclude?: string[] | undefined;
+        include?: string[] | undefined;
         registryHash?: string | undefined;
         receiptPath?: string | undefined;
     }>]>, "many">>;
@@ -2484,89 +2822,215 @@ declare const governanceConfigSchema: z.ZodObject<{
         except: z.ZodArray<z.ZodString, "many">;
         prefer: z.ZodEnum<["token", "css-variable"]>;
         severity: z.ZodEnum<["error", "warn", "info"]>;
+        exclude: z.ZodOptional<z.ZodArray<z.ZodUnion<[z.ZodString, z.ZodObject<{
+            glob: z.ZodString;
+            reason: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            glob: string;
+            reason?: string | undefined;
+        }, {
+            glob: string;
+            reason?: string | undefined;
+        }>]>, "many">>;
     }, "strip", z.ZodTypeAny, {
         kind: "style.rawColors.forbid";
         severity: "error" | "info" | "warn";
         except: string[];
         prefer: "token" | "css-variable";
+        exclude?: (string | {
+            glob: string;
+            reason?: string | undefined;
+        })[] | undefined;
     }, {
         kind: "style.rawColors.forbid";
         severity: "error" | "info" | "warn";
         except: string[];
         prefer: "token" | "css-variable";
+        exclude?: (string | {
+            glob: string;
+            reason?: string | undefined;
+        })[] | undefined;
     }>, z.ZodObject<{
         kind: z.ZodLiteral<"style.rawDimensions.forbid">;
         appliesTo: z.ZodArray<z.ZodString, "many">;
         prefer: z.ZodEnum<["token", "css-variable"]>;
         severity: z.ZodEnum<["error", "warn", "info"]>;
+        exclude: z.ZodOptional<z.ZodArray<z.ZodUnion<[z.ZodString, z.ZodObject<{
+            glob: z.ZodString;
+            reason: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            glob: string;
+            reason?: string | undefined;
+        }, {
+            glob: string;
+            reason?: string | undefined;
+        }>]>, "many">>;
     }, "strip", z.ZodTypeAny, {
         kind: "style.rawDimensions.forbid";
         severity: "error" | "info" | "warn";
         prefer: "token" | "css-variable";
         appliesTo: string[];
+        exclude?: (string | {
+            glob: string;
+            reason?: string | undefined;
+        })[] | undefined;
     }, {
         kind: "style.rawDimensions.forbid";
         severity: "error" | "info" | "warn";
         prefer: "token" | "css-variable";
         appliesTo: string[];
+        exclude?: (string | {
+            glob: string;
+            reason?: string | undefined;
+        })[] | undefined;
     }>, z.ZodObject<{
         kind: z.ZodLiteral<"style.rawSpacing.mustMatchScale">;
         scale: z.ZodString;
         appliesTo: z.ZodArray<z.ZodString, "many">;
         severity: z.ZodEnum<["error", "warn", "info"]>;
+        exclude: z.ZodOptional<z.ZodArray<z.ZodUnion<[z.ZodString, z.ZodObject<{
+            glob: z.ZodString;
+            reason: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            glob: string;
+            reason?: string | undefined;
+        }, {
+            glob: string;
+            reason?: string | undefined;
+        }>]>, "many">>;
     }, "strip", z.ZodTypeAny, {
         kind: "style.rawSpacing.mustMatchScale";
         severity: "error" | "info" | "warn";
         scale: string;
         appliesTo: string[];
+        exclude?: (string | {
+            glob: string;
+            reason?: string | undefined;
+        })[] | undefined;
     }, {
         kind: "style.rawSpacing.mustMatchScale";
         severity: "error" | "info" | "warn";
         scale: string;
         appliesTo: string[];
+        exclude?: (string | {
+            glob: string;
+            reason?: string | undefined;
+        })[] | undefined;
     }>, z.ZodObject<{
         kind: z.ZodLiteral<"style.fontSize.mustMatchScale">;
         scale: z.ZodString;
         severity: z.ZodEnum<["error", "warn", "info"]>;
+        exclude: z.ZodOptional<z.ZodArray<z.ZodUnion<[z.ZodString, z.ZodObject<{
+            glob: z.ZodString;
+            reason: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            glob: string;
+            reason?: string | undefined;
+        }, {
+            glob: string;
+            reason?: string | undefined;
+        }>]>, "many">>;
     }, "strip", z.ZodTypeAny, {
         kind: "style.fontSize.mustMatchScale";
         severity: "error" | "info" | "warn";
         scale: string;
+        exclude?: (string | {
+            glob: string;
+            reason?: string | undefined;
+        })[] | undefined;
     }, {
         kind: "style.fontSize.mustMatchScale";
         severity: "error" | "info" | "warn";
         scale: string;
+        exclude?: (string | {
+            glob: string;
+            reason?: string | undefined;
+        })[] | undefined;
     }>, z.ZodObject<{
         kind: z.ZodLiteral<"style.cssVars.mustBeDefined">;
         severity: z.ZodEnum<["error", "warn", "info"]>;
+        exclude: z.ZodOptional<z.ZodArray<z.ZodUnion<[z.ZodString, z.ZodObject<{
+            glob: z.ZodString;
+            reason: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            glob: string;
+            reason?: string | undefined;
+        }, {
+            glob: string;
+            reason?: string | undefined;
+        }>]>, "many">>;
     }, "strip", z.ZodTypeAny, {
         kind: "style.cssVars.mustBeDefined";
         severity: "error" | "info" | "warn";
+        exclude?: (string | {
+            glob: string;
+            reason?: string | undefined;
+        })[] | undefined;
     }, {
         kind: "style.cssVars.mustBeDefined";
         severity: "error" | "info" | "warn";
+        exclude?: (string | {
+            glob: string;
+            reason?: string | undefined;
+        })[] | undefined;
     }>]>, "many">>;
     jsx: z.ZodOptional<z.ZodArray<z.ZodDiscriminatedUnion<"kind", [z.ZodObject<{
         kind: z.ZodLiteral<"jsx.unknownProps.forbid">;
         severity: z.ZodEnum<["error", "warn", "info"]>;
+        exclude: z.ZodOptional<z.ZodArray<z.ZodUnion<[z.ZodString, z.ZodObject<{
+            glob: z.ZodString;
+            reason: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            glob: string;
+            reason?: string | undefined;
+        }, {
+            glob: string;
+            reason?: string | undefined;
+        }>]>, "many">>;
     }, "strip", z.ZodTypeAny, {
         kind: "jsx.unknownProps.forbid";
         severity: "error" | "info" | "warn";
+        exclude?: (string | {
+            glob: string;
+            reason?: string | undefined;
+        })[] | undefined;
     }, {
         kind: "jsx.unknownProps.forbid";
         severity: "error" | "info" | "warn";
+        exclude?: (string | {
+            glob: string;
+            reason?: string | undefined;
+        })[] | undefined;
     }>, z.ZodObject<{
         kind: z.ZodLiteral<"jsx.inlineStyle.forbidRaw">;
         properties: z.ZodArray<z.ZodString, "many">;
         severity: z.ZodEnum<["error", "warn", "info"]>;
+        exclude: z.ZodOptional<z.ZodArray<z.ZodUnion<[z.ZodString, z.ZodObject<{
+            glob: z.ZodString;
+            reason: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            glob: string;
+            reason?: string | undefined;
+        }, {
+            glob: string;
+            reason?: string | undefined;
+        }>]>, "many">>;
     }, "strip", z.ZodTypeAny, {
         kind: "jsx.inlineStyle.forbidRaw";
         severity: "error" | "info" | "warn";
         properties: string[];
+        exclude?: (string | {
+            glob: string;
+            reason?: string | undefined;
+        })[] | undefined;
     }, {
         kind: "jsx.inlineStyle.forbidRaw";
         severity: "error" | "info" | "warn";
         properties: string[];
+        exclude?: (string | {
+            glob: string;
+            reason?: string | undefined;
+        })[] | undefined;
     }>, z.ZodObject<{
         kind: z.ZodLiteral<"jsx.importPath.prefer">;
         from: z.ZodString;
@@ -2574,11 +3038,25 @@ declare const governanceConfigSchema: z.ZodObject<{
         imported: z.ZodOptional<z.ZodString>;
         because: z.ZodOptional<z.ZodString>;
         severity: z.ZodEnum<["error", "warn", "info"]>;
+        exclude: z.ZodOptional<z.ZodArray<z.ZodUnion<[z.ZodString, z.ZodObject<{
+            glob: z.ZodString;
+            reason: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            glob: string;
+            reason?: string | undefined;
+        }, {
+            glob: string;
+            reason?: string | undefined;
+        }>]>, "many">>;
     }, "strip", z.ZodTypeAny, {
         kind: "jsx.importPath.prefer";
         from: string;
         to: string;
         severity: "error" | "info" | "warn";
+        exclude?: (string | {
+            glob: string;
+            reason?: string | undefined;
+        })[] | undefined;
         imported?: string | undefined;
         because?: string | undefined;
     }, {
@@ -2586,6 +3064,10 @@ declare const governanceConfigSchema: z.ZodObject<{
         from: string;
         to: string;
         severity: "error" | "info" | "warn";
+        exclude?: (string | {
+            glob: string;
+            reason?: string | undefined;
+        })[] | undefined;
         imported?: string | undefined;
         because?: string | undefined;
     }>, z.ZodObject<{
@@ -2594,17 +3076,35 @@ declare const governanceConfigSchema: z.ZodObject<{
         to: z.ZodString;
         because: z.ZodOptional<z.ZodString>;
         severity: z.ZodEnum<["error", "warn", "info"]>;
+        exclude: z.ZodOptional<z.ZodArray<z.ZodUnion<[z.ZodString, z.ZodObject<{
+            glob: z.ZodString;
+            reason: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            glob: string;
+            reason?: string | undefined;
+        }, {
+            glob: string;
+            reason?: string | undefined;
+        }>]>, "many">>;
     }, "strip", z.ZodTypeAny, {
         kind: "jsx.component.prefer";
         from: string;
         to: string;
         severity: "error" | "info" | "warn";
+        exclude?: (string | {
+            glob: string;
+            reason?: string | undefined;
+        })[] | undefined;
         because?: string | undefined;
     }, {
         kind: "jsx.component.prefer";
         from: string;
         to: string;
         severity: "error" | "info" | "warn";
+        exclude?: (string | {
+            glob: string;
+            reason?: string | undefined;
+        })[] | undefined;
         because?: string | undefined;
     }>]>, "many">>;
     tailwind: z.ZodOptional<z.ZodObject<{
@@ -3004,10 +3504,13 @@ declare const governanceConfigSchema: z.ZodObject<{
     }>, "many">>;
     ci: z.ZodOptional<z.ZodObject<{
         failOnWarnings: z.ZodOptional<z.ZodBoolean>;
+        failOnInert: z.ZodOptional<z.ZodBoolean>;
     }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
         failOnWarnings: z.ZodOptional<z.ZodBoolean>;
+        failOnInert: z.ZodOptional<z.ZodBoolean>;
     }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
         failOnWarnings: z.ZodOptional<z.ZodBoolean>;
+        failOnInert: z.ZodOptional<z.ZodBoolean>;
     }, z.ZodTypeAny, "passthrough">>>;
 }, "strict", z.ZodTypeAny, {
     components?: Record<string, {
@@ -3055,36 +3558,68 @@ declare const governanceConfigSchema: z.ZodObject<{
         severity: "error" | "info" | "warn";
         except: string[];
         prefer: "token" | "css-variable";
+        exclude?: (string | {
+            glob: string;
+            reason?: string | undefined;
+        })[] | undefined;
     } | {
         kind: "style.rawDimensions.forbid";
         severity: "error" | "info" | "warn";
         prefer: "token" | "css-variable";
         appliesTo: string[];
+        exclude?: (string | {
+            glob: string;
+            reason?: string | undefined;
+        })[] | undefined;
     } | {
         kind: "style.rawSpacing.mustMatchScale";
         severity: "error" | "info" | "warn";
         scale: string;
         appliesTo: string[];
+        exclude?: (string | {
+            glob: string;
+            reason?: string | undefined;
+        })[] | undefined;
     } | {
         kind: "style.fontSize.mustMatchScale";
         severity: "error" | "info" | "warn";
         scale: string;
+        exclude?: (string | {
+            glob: string;
+            reason?: string | undefined;
+        })[] | undefined;
     } | {
         kind: "style.cssVars.mustBeDefined";
         severity: "error" | "info" | "warn";
+        exclude?: (string | {
+            glob: string;
+            reason?: string | undefined;
+        })[] | undefined;
     })[] | undefined;
     jsx?: ({
         kind: "jsx.unknownProps.forbid";
         severity: "error" | "info" | "warn";
+        exclude?: (string | {
+            glob: string;
+            reason?: string | undefined;
+        })[] | undefined;
     } | {
         kind: "jsx.inlineStyle.forbidRaw";
         severity: "error" | "info" | "warn";
         properties: string[];
+        exclude?: (string | {
+            glob: string;
+            reason?: string | undefined;
+        })[] | undefined;
     } | {
         kind: "jsx.importPath.prefer";
         from: string;
         to: string;
         severity: "error" | "info" | "warn";
+        exclude?: (string | {
+            glob: string;
+            reason?: string | undefined;
+        })[] | undefined;
         imported?: string | undefined;
         because?: string | undefined;
     } | {
@@ -3092,6 +3627,10 @@ declare const governanceConfigSchema: z.ZodObject<{
         from: string;
         to: string;
         severity: "error" | "info" | "warn";
+        exclude?: (string | {
+            glob: string;
+            reason?: string | undefined;
+        })[] | undefined;
         because?: string | undefined;
     })[] | undefined;
     tailwind?: z.objectOutputType<{
@@ -3157,14 +3696,14 @@ declare const governanceConfigSchema: z.ZodObject<{
     canonicalSources?: ({
         kind: "npm";
         specifier: string;
+        exclude?: string[] | undefined;
         implementationPath?: string | undefined;
         include?: string[] | undefined;
-        exclude?: string[] | undefined;
     } | {
         path: string;
         kind: "directory";
-        include?: string[] | undefined;
         exclude?: string[] | undefined;
+        include?: string[] | undefined;
     } | {
         kind: "registry";
         registryId: string;
@@ -3172,8 +3711,8 @@ declare const governanceConfigSchema: z.ZodObject<{
         installPath: string;
         severity?: "error" | "info" | "warn" | undefined;
         importPath?: string | undefined;
-        include?: string[] | undefined;
         exclude?: string[] | undefined;
+        include?: string[] | undefined;
         registryHash?: string | undefined;
     })[] | undefined;
     canonicalBridges?: {
@@ -3198,6 +3737,7 @@ declare const governanceConfigSchema: z.ZodObject<{
     }, z.ZodTypeAny, "passthrough"> | undefined;
     ci?: z.objectOutputType<{
         failOnWarnings: z.ZodOptional<z.ZodBoolean>;
+        failOnInert: z.ZodOptional<z.ZodBoolean>;
     }, z.ZodTypeAny, "passthrough"> | undefined;
 }, {
     components?: Record<string, {
@@ -3245,36 +3785,68 @@ declare const governanceConfigSchema: z.ZodObject<{
         severity: "error" | "info" | "warn";
         except: string[];
         prefer: "token" | "css-variable";
+        exclude?: (string | {
+            glob: string;
+            reason?: string | undefined;
+        })[] | undefined;
     } | {
         kind: "style.rawDimensions.forbid";
         severity: "error" | "info" | "warn";
         prefer: "token" | "css-variable";
         appliesTo: string[];
+        exclude?: (string | {
+            glob: string;
+            reason?: string | undefined;
+        })[] | undefined;
     } | {
         kind: "style.rawSpacing.mustMatchScale";
         severity: "error" | "info" | "warn";
         scale: string;
         appliesTo: string[];
+        exclude?: (string | {
+            glob: string;
+            reason?: string | undefined;
+        })[] | undefined;
     } | {
         kind: "style.fontSize.mustMatchScale";
         severity: "error" | "info" | "warn";
         scale: string;
+        exclude?: (string | {
+            glob: string;
+            reason?: string | undefined;
+        })[] | undefined;
     } | {
         kind: "style.cssVars.mustBeDefined";
         severity: "error" | "info" | "warn";
+        exclude?: (string | {
+            glob: string;
+            reason?: string | undefined;
+        })[] | undefined;
     })[] | undefined;
     jsx?: ({
         kind: "jsx.unknownProps.forbid";
         severity: "error" | "info" | "warn";
+        exclude?: (string | {
+            glob: string;
+            reason?: string | undefined;
+        })[] | undefined;
     } | {
         kind: "jsx.inlineStyle.forbidRaw";
         severity: "error" | "info" | "warn";
         properties: string[];
+        exclude?: (string | {
+            glob: string;
+            reason?: string | undefined;
+        })[] | undefined;
     } | {
         kind: "jsx.importPath.prefer";
         from: string;
         to: string;
         severity: "error" | "info" | "warn";
+        exclude?: (string | {
+            glob: string;
+            reason?: string | undefined;
+        })[] | undefined;
         imported?: string | undefined;
         because?: string | undefined;
     } | {
@@ -3282,6 +3854,10 @@ declare const governanceConfigSchema: z.ZodObject<{
         from: string;
         to: string;
         severity: "error" | "info" | "warn";
+        exclude?: (string | {
+            glob: string;
+            reason?: string | undefined;
+        })[] | undefined;
         because?: string | undefined;
     })[] | undefined;
     tailwind?: z.objectInputType<{
@@ -3347,22 +3923,22 @@ declare const governanceConfigSchema: z.ZodObject<{
     canonicalSources?: ({
         kind: "npm";
         specifier: string;
+        exclude?: string[] | undefined;
         implementationPath?: string | undefined;
         include?: string[] | undefined;
-        exclude?: string[] | undefined;
     } | {
         path: string;
         kind: "directory";
-        include?: string[] | undefined;
         exclude?: string[] | undefined;
+        include?: string[] | undefined;
     } | {
         kind: "registry";
         registryId: string;
         installPath: string;
         severity?: "error" | "info" | "warn" | undefined;
         importPath?: string | undefined;
-        include?: string[] | undefined;
         exclude?: string[] | undefined;
+        include?: string[] | undefined;
         registryHash?: string | undefined;
         receiptPath?: string | undefined;
     })[] | undefined;
@@ -3388,6 +3964,7 @@ declare const governanceConfigSchema: z.ZodObject<{
     }, z.ZodTypeAny, "passthrough"> | undefined;
     ci?: z.objectInputType<{
         failOnWarnings: z.ZodOptional<z.ZodBoolean>;
+        failOnInert: z.ZodOptional<z.ZodBoolean>;
     }, z.ZodTypeAny, "passthrough"> | undefined;
 }>;
 type ScaleGovernanceRecord = z.infer<typeof scaleGovernanceRecordSchema>;
@@ -3400,20 +3977,45 @@ type ComponentPolicyOverride = z.infer<typeof componentPolicyOverrideSchema>;
 type CanonicalSource = z.infer<typeof canonicalSourceSchema>;
 type CanonicalBridgeV1 = z.infer<typeof canonicalBridgeV1Schema>;
 interface GovernanceConfig {
+    /** Shared governance config modules to extend before applying this file's declarations. */
     extends?: string[];
+    /** Default severity for governance rules that do not declare their own severity. */
     severity?: GovernanceSeverity;
+    /**
+     * Rule-id keyed enablement and severity overrides. Only fields consumed by the named
+     * rule are valid; unsupported fields are reported as inert config.
+     */
     rules?: Record<string, unknown>;
+    /** Agent-id keyed rule overrides for supported agent-specific governance policies. */
     agents?: Record<string, {
         rules?: Record<string, unknown>;
     }>;
+    /** Reserved audit compatibility object; undeclared child keys are reported as inert. */
     audit?: Record<string, unknown>;
+    /** Reserved runner compatibility map; undeclared child keys are reported as inert. */
     runners?: Record<string, Record<string, unknown>>;
+    /**
+     * Canonical component authorities: npm packages, repository directories, or registry
+     * receipts whose included exports arm canonical-component rules.
+     */
     canonicalSources?: CanonicalSource[];
+    /**
+     * Confirmed mappings from an underlying library export to the approved local wrapper.
+     * The wrapper's implementationFiles scope permits its direct underlying import.
+     */
     canonicalBridges?: CanonicalBridgeV1[];
+    /** Versioned governance presets to resolve before applying local rule overrides. */
     presets?: string[];
+    /**
+     * Named numeric scales. Spacing rules bind through
+     * style.rawSpacing.mustMatchScale; the built-in spacing policy references `space`.
+     */
     scales?: Record<string, ScaleGovernanceRecord>;
+    /** Legacy typed style-policy records, normalized into the active rule policy. */
     styles?: GlobalStyleGovernanceRecord[];
+    /** Legacy typed JSX-policy records, normalized into the active rule policy. */
     jsx?: GlobalJsxGovernanceRecord[];
+    /** Tailwind palette allow/deny policy used by Tailwind governance rules. */
     tailwind?: {
         palette?: {
             allow?: string[];
@@ -3421,18 +4023,48 @@ interface GovernanceConfig {
         };
         [key: string]: unknown;
     };
+    /** Agent repair-order guidance consumed when presenting deterministic fixes. */
     agent?: {
         repairOrder?: string[];
         [key: string]: unknown;
     };
+    /** Component-keyed governance records for canonical component metadata and prop policy. */
     components?: Record<string, ComponentPolicyRecord>;
+    /** Ordered component-policy overrides selected by component identity fields. */
     overrides?: ComponentPolicyOverride[];
+    /**
+     * Governance CI rendering options: `failOnWarnings` makes warning findings fail the
+     * `--ci` verdict, `failOnInert` makes inert-config diagnostics (FUI9004-FUI9008) fail
+     * it. Both are opt-in; `--allow-inert` bypasses the inert gates.
+     */
     ci?: {
         failOnWarnings?: boolean;
+        /**
+         * Fail the `--ci` verdict when the run reports inert-config diagnostics
+         * (FUI9004-FUI9008). Opt-in: the diagnostics themselves stay verdict-neutral,
+         * so a team can adopt the gate once its config is clean. `--allow-inert`
+         * bypasses it, like the governance-inert gate.
+         */
+        failOnInert?: boolean;
         [key: string]: unknown;
     };
     [key: string]: unknown;
 }
+/**
+ * Tag every entry of a preset's `govern.rules` map as preset-sourced. Non-object entries
+ * (the `"warn"` string shorthand) cannot carry a symbol and are passed through untagged —
+ * presets author the object form, so this is a documented floor, not a silent gap.
+ *
+ * **Non-enumerable**, which is the difference between "does not serialize" and "is not
+ * there". A symbol key already survives neither `JSON.stringify` nor `Object.keys`, but
+ * it does survive `toEqual` — so an enumerable marker turns every consumer that compares
+ * a composed rule config structurally into a failing test, for a property they cannot see
+ * and did not ask for. Fragments Cloud's own policy composer was the first to hit it.
+ * Read it through `isPresetSourcedRule`; nothing else should know it exists.
+ */
+declare function markPresetSourcedRules(rules: Record<string, unknown> | undefined): Record<string, unknown> | undefined;
+/** Whether a merged `govern.rules` entry came from a preset rather than the user. */
+declare function isPresetSourcedRule(entry: unknown): boolean;
 type SeverityOption = {
     severity?: GovernanceSeverity;
 };
@@ -3535,4 +4167,4 @@ declare const g: {
     component: ComponentGovernanceBuilder<Record<string, unknown>>;
 };
 
-export { type DesignSystemConfig as $, type AIMetadata as A, type BlockDefinition as B, type CompiledBlock as C, type CanonicalMappingStatus as D, type CompiledFragmentsFile as E, type FragmentDefinition as F, type GovernanceSeverity as G, type CompiledRecipe as H, type CompiledTokenData as I, type CompiledTokenEntry as J, type ComponentGovernanceBuilder as K, type ComponentGovernanceRecord as L, type ComponentRef as M, type ComponentRelation as N, type CompositionMetadata as O, type ContractComponentInput as P, type ContractIdentityPin as Q, type ResolvedGovernedFragmentDefinition as R, type StorybookFilterConfig as S, type TokenConfig as T, type ContractPolicyInput as U, type VariantRenderOptions as V, type ContractPreimage as W, type ContractPropMappingInput as X, type ContractTokenInput as Y, type ContractWaiverInput as Z, type ControlType as _, type FragmentDefinitionV2 as a, type ComponentRelation$1 as a$, type DiffResult as a0, type FigmaPropMapping as a1, type FragmentContract as a2, type FragmentExample as a3, type FragmentGenerated as a4, type FragmentGuidance as a5, type FragmentMeta as a6, type FragmentProvenance as a7, type FragmentUsage as a8, type FragmentVariant as a9, type SnippetPolicyConfig as aA, type Theme as aB, type ThemeSeeds as aC, type TokenSourceConfig as aD, type TokenSourceFormat as aE, type VerifyRequest as aF, type VerifyResult as aG, type Viewport as aH, canonicalBridgeV1Schema as aI, componentGovernanceRecordSchema as aJ, componentGovernanceRecordsSchema as aK, contractComponentsFromFragments as aL, contractPolicyFromGovernanceConfig as aM, diffContractDomains as aN, g as aO, globalGovernanceRecordSchema as aP, globalJsxGovernanceRecordSchema as aQ, globalStyleGovernanceRecordSchema as aR, governanceConfigSchema as aS, governanceConfigWithLocalCanonical as aT, governanceSeveritySchema as aU, localCanonicalContractMappings as aV, normalizeGovernanceConfig as aW, projectContractPreimage as aX, scaleGovernanceRecordSchema as aY, verifiedContractPreimageFromPin as aZ, type AIMetadata$1 as a_, type GlobalGovernanceRecord as aa, type GlobalJsxGovernanceRecord as ab, type GlobalStyleGovernanceRecord as ac, type GovernancePropValue as ad, type InspectConfig as ae, type LocalCanonicalDeclaration as af, type LocalCanonicalResolveRule as ag, type Manifest as ah, type ObservedComponentUsage as ai, type ObservedUsageProp as aj, type PlayFunction as ak, type PlayFunctionContext as al, type PropDefinition as am, type PropGovernanceBuilder as an, type PropGovernanceOptions as ao, type PropKey as ap, type PropType as aq, type RecipeDefinition as ar, type RegistryOptions as as, type RepoRelativePath as at, type ScaleGovernanceRecord as au, type Screenshot as av, type ScreenshotConfig as aw, type ScreenshotMetadata as ax, type ServiceConfig as ay, type SnapshotConfig as az, type CompiledFragment as b, type FragmentContract$1 as b0, type FragmentGenerated$1 as b1, type FragmentMeta$1 as b2, type FragmentUsage$1 as b3, type ImportEntry as b4, type PerformanceData as b5, type PerformanceSummary as b6, type PropDefinition$1 as b7, type Theme$1 as b8, type VerifyResult$1 as b9, type ContractDomain as c, type ContractCatalogInput as d, type GovernedFragmentDefinition as e, type GovernanceConfig as f, type FragmentsConfig as g, type FragmentComponent as h, type FigmaStringMapping as i, type FigmaBooleanMapping as j, type FigmaEnumMapping as k, type FigmaInstanceMapping as l, type FigmaChildrenMapping as m, type FigmaTextContentMapping as n, type RelationshipType as o, type VariantLoader as p, type CanonicalSource as q, type CanonicalBridgeV1 as r, type ContractCanonicalMappingInput as s, type AccessibilityGovernanceBuilder as t, type AppConfig as u, type BaselineInfo as v, type BoundingBox as w, CONTRACT_DOMAINS as x, CONTRACT_PREIMAGE_CAPABILITY_HEADER as y, CONTRACT_PREIMAGE_SCHEMA as z };
+export { type DesignSystemConfig as $, type AIMetadata as A, type BlockDefinition as B, type CompiledBlock as C, type CanonicalMappingStatus as D, type CompiledFragmentsFile as E, type FragmentDefinition as F, type GovernanceSeverity as G, type CompiledRecipe as H, type CompiledTokenData as I, type CompiledTokenEntry as J, type ComponentGovernanceBuilder as K, type ComponentGovernanceRecord as L, type ComponentRef as M, type ComponentRelation as N, type CompositionMetadata as O, type ContractComponentInput as P, type ContractIdentityPin as Q, type ResolvedGovernedFragmentDefinition as R, type StorybookFilterConfig as S, type TokenConfig as T, type ContractPolicyInput as U, type VariantRenderOptions as V, type ContractPreimage as W, type ContractPropMappingInput as X, type ContractTokenInput as Y, type ContractWaiverInput as Z, type ControlType as _, type FragmentDefinitionV2 as a, verifiedContractPreimageFromPin as a$, type DiffResult as a0, type FigmaPropMapping as a1, type FragmentContract as a2, type FragmentExample as a3, type FragmentGenerated as a4, type FragmentGuidance as a5, type FragmentMeta as a6, type FragmentProvenance as a7, type FragmentUsage as a8, type FragmentVariant as a9, type SnippetPolicyConfig as aA, type Theme as aB, type ThemeSeeds as aC, type TokenSourceConfig as aD, type TokenSourceFormat as aE, type VerifyRequest as aF, type VerifyResult as aG, type Viewport as aH, canonicalBridgeV1Schema as aI, componentGovernanceRecordSchema as aJ, componentGovernanceRecordsSchema as aK, contractComponentsFromFragments as aL, contractPolicyFromGovernanceConfig as aM, diffContractDomains as aN, g as aO, globalGovernanceRecordSchema as aP, globalJsxGovernanceRecordSchema as aQ, globalStyleGovernanceRecordSchema as aR, governanceConfigSchema as aS, governanceConfigWithLocalCanonical as aT, governanceSeveritySchema as aU, isPresetSourcedRule as aV, localCanonicalContractMappings as aW, markPresetSourcedRules as aX, normalizeGovernanceConfig as aY, projectContractPreimage as aZ, scaleGovernanceRecordSchema as a_, type GlobalGovernanceRecord as aa, type GlobalJsxGovernanceRecord as ab, type GlobalStyleGovernanceRecord as ac, type GovernancePropValue as ad, type InspectConfig as ae, type LocalCanonicalDeclaration as af, type LocalCanonicalResolveRule as ag, type Manifest as ah, type ObservedComponentUsage as ai, type ObservedUsageProp as aj, type PlayFunction as ak, type PlayFunctionContext as al, type PropDefinition as am, type PropGovernanceBuilder as an, type PropGovernanceOptions as ao, type PropKey as ap, type PropType as aq, type RecipeDefinition as ar, type RegistryOptions as as, type RepoRelativePath as at, type ScaleGovernanceRecord as au, type Screenshot as av, type ScreenshotConfig as aw, type ScreenshotMetadata as ax, type ServiceConfig as ay, type SnapshotConfig as az, type CompiledFragment as b, type AIMetadata$1 as b0, type ComponentRelation$1 as b1, type FragmentContract$1 as b2, type FragmentGenerated$1 as b3, type FragmentMeta$1 as b4, type FragmentUsage$1 as b5, type ImportEntry as b6, type PerformanceData as b7, type PerformanceSummary as b8, type PropDefinition$1 as b9, type Theme$1 as ba, type VerifyResult$1 as bb, type ContractDomain as c, type ContractCatalogInput as d, type GovernedFragmentDefinition as e, type GovernanceConfig as f, type FragmentsConfig as g, type FragmentComponent as h, type FigmaStringMapping as i, type FigmaBooleanMapping as j, type FigmaEnumMapping as k, type FigmaInstanceMapping as l, type FigmaChildrenMapping as m, type FigmaTextContentMapping as n, type RelationshipType as o, type VariantLoader as p, type CanonicalSource as q, type CanonicalBridgeV1 as r, type ContractCanonicalMappingInput as s, type AccessibilityGovernanceBuilder as t, type AppConfig as u, type BaselineInfo as v, type BoundingBox as w, CONTRACT_DOMAINS as x, CONTRACT_PREIMAGE_CAPABILITY_HEADER as y, CONTRACT_PREIMAGE_SCHEMA as z };