@webpieces/rules-config 0.3.189 → 0.3.191

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@webpieces/rules-config",
-  "version": "0.3.189",
+  "version": "0.3.191",
   "description": "Shared webpieces.config.json loader. Single source of truth for validation rule configuration consumed by @webpieces/ai-hook-rules, @webpieces/code-rules, and @webpieces/nx-webpieces-rules.",
   "type": "commonjs",
   "main": "./src/index.js",

package/src/config-file.d.ts

@@ -0,0 +1,15 @@
+export declare const CONFIG_FILENAME = "webpieces.config.json";
+export interface RawConfigFile {
+    extends?: string;
+    rules?: Record<string, Record<string, unknown>>;
+    rulesDir?: string[];
+    'pr-gate'?: unknown;
+}
+/**
+ * Walk up from `startDir` looking for webpieces.config.json. Returns its absolute path or null.
+ */
+export declare function findConfigFile(startDir: string): string | null;
+/**
+ * Read + JSON.parse webpieces.config.json, surfacing parse failures as a readable InformAiError.
+ */
+export declare function readRawConfig(configPath: string): RawConfigFile;

package/src/config-file.js

@@ -0,0 +1,43 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CONFIG_FILENAME = void 0;
+exports.findConfigFile = findConfigFile;
+exports.readRawConfig = readRawConfig;
+const tslib_1 = require("tslib");
+const fs = tslib_1.__importStar(require("fs"));
+const path = tslib_1.__importStar(require("path"));
+const inform_ai_error_1 = require("./inform-ai-error");
+const to_error_1 = require("./to-error");
+exports.CONFIG_FILENAME = 'webpieces.config.json';
+/**
+ * Walk up from `startDir` looking for webpieces.config.json. Returns its absolute path or null.
+ */
+function findConfigFile(startDir) {
+    let dir = startDir;
+    while (true) {
+        const primary = path.join(dir, exports.CONFIG_FILENAME);
+        if (fs.existsSync(primary))
+            return primary;
+        const parent = path.dirname(dir);
+        if (parent === dir)
+            return null;
+        dir = parent;
+    }
+}
+/**
+ * Read + JSON.parse webpieces.config.json, surfacing parse failures as a readable InformAiError.
+ */
+function readRawConfig(configPath) {
+    const raw = fs.readFileSync(configPath, 'utf8');
+    // eslint-disable-next-line @webpieces/no-unmanaged-exceptions
+    try {
+        return JSON.parse(raw);
+    }
+    catch (err) {
+        const error = (0, to_error_1.toError)(err);
+        throw new inform_ai_error_1.InformAiError(`webpieces.config.json has invalid JSON — fix the file, then retry.\n` +
+            `Parse error: ${error.message}\n` +
+            `File: ${configPath}`);
+    }
+}
+//# sourceMappingURL=config-file.js.map

package/src/config-file.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-file.js","sourceRoot":"","sources":["../../../../../packages/tooling/rules-config/src/config-file.ts"],"names":[],"mappings":";;;AAuBA,wCASC;AAKD,sCAaC;;AAlDD,+CAAyB;AACzB,mDAA6B;AAE7B,uDAAkD;AAClD,yCAAqC;AAExB,QAAA,eAAe,GAAG,uBAAuB,CAAC;AAcvD;;GAEG;AACH,SAAgB,cAAc,CAAC,QAAgB;IAC3C,IAAI,GAAG,GAAG,QAAQ,CAAC;IACnB,OAAO,IAAI,EAAE,CAAC;QACV,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,uBAAe,CAAC,CAAC;QAChD,IAAI,EAAE,CAAC,UAAU,CAAC,OAAO,CAAC;YAAE,OAAO,OAAO,CAAC;QAC3C,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QACjC,IAAI,MAAM,KAAK,GAAG;YAAE,OAAO,IAAI,CAAC;QAChC,GAAG,GAAG,MAAM,CAAC;IACjB,CAAC;AACL,CAAC;AAED;;GAEG;AACH,SAAgB,aAAa,CAAC,UAAkB;IAC5C,MAAM,GAAG,GAAG,EAAE,CAAC,YAAY,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;IAChD,8DAA8D;IAC9D,IAAI,CAAC;QACD,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAkB,CAAC;IAC5C,CAAC;IAAC,OAAO,GAAY,EAAE,CAAC;QACpB,MAAM,KAAK,GAAG,IAAA,kBAAO,EAAC,GAAG,CAAC,CAAC;QAC3B,MAAM,IAAI,+BAAa,CACnB,sEAAsE;YACtE,gBAAgB,KAAK,CAAC,OAAO,IAAI;YACjC,SAAS,UAAU,EAAE,CACxB,CAAC;IACN,CAAC;AACL,CAAC","sourcesContent":["import * as fs from 'fs';\nimport * as path from 'path';\n\nimport { InformAiError } from './inform-ai-error';\nimport { toError } from './to-error';\n\nexport const CONFIG_FILENAME = 'webpieces.config.json';\n\n// Raw shape of webpieces.config.json as parsed from JSON, before validation/typing. `pr-gate` is a\n// top-level sibling of `rules` (its nested `gates` array can't be expressed in the FieldDef schema),\n// so it is carried here as opaque JSON and validated structurally by validatePrGateSection.\n// webpieces-disable no-any-unknown -- consumer JSON config has opaque rule option values\nexport interface RawConfigFile {\n    extends?: string;\n    rules?: Record<string, Record<string, unknown>>;\n    rulesDir?: string[];\n    // webpieces-disable no-any-unknown -- opaque pr-gate JSON, validated by validatePrGateSection\n    'pr-gate'?: unknown;\n}\n\n/**\n * Walk up from `startDir` looking for webpieces.config.json. Returns its absolute path or null.\n */\nexport function findConfigFile(startDir: string): string | null {\n    let dir = startDir;\n    while (true) {\n        const primary = path.join(dir, CONFIG_FILENAME);\n        if (fs.existsSync(primary)) return primary;\n        const parent = path.dirname(dir);\n        if (parent === dir) return null;\n        dir = parent;\n    }\n}\n\n/**\n * Read + JSON.parse webpieces.config.json, surfacing parse failures as a readable InformAiError.\n */\nexport function readRawConfig(configPath: string): RawConfigFile {\n    const raw = fs.readFileSync(configPath, 'utf8');\n    // eslint-disable-next-line @webpieces/no-unmanaged-exceptions\n    try {\n        return JSON.parse(raw) as RawConfigFile;\n    } catch (err: unknown) {\n        const error = toError(err);\n        throw new InformAiError(\n            `webpieces.config.json has invalid JSON — fix the file, then retry.\\n` +\n            `Parse error: ${error.message}\\n` +\n            `File: ${configPath}`,\n        );\n    }\n}\n"]}

package/src/constants.js

@@ -43,7 +43,7 @@ exports.MERGE_IN_PROGRESS_FILE = 'merge-in-progress.json';
 // Proof-of-work the AI must produce for every conflicted file it resolves during a 3-point
 // merge: a short explanation written NEXT TO that file's 3-point context (the same
 // `updatemain-<safe_path>/` dir that holds A-forkpoint.txt / B-A.diff / C-A.diff). The
-// merge-complete gate requires a non-empty file of this name per conflicted file before passing —
+// wp-finish-upsert-pr gate requires a non-empty file of this name per conflicted file before passing —
 // it is the only check on the part of the process the AI actually owns (resolving files). Using a
 // sidecar file (rather than an in-source comment) works for any file type, including comment-less
 // ones like JSON and files resolved by deletion.

package/src/constants.js.map

@@ -1 +1 @@
-{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../../../packages/tooling/rules-config/src/constants.ts"],"names":[],"mappings":";AAAA,iFAAiF;AACjF,sEAAsE;AACtE,EAAE;AACF,yFAAyF;AACzF,qFAAqF;AACrF,kFAAkF;;;AAoDlF,gCAEC;AApDY,QAAA,iBAAiB,GAAG,mBAAmB,CAAC;AAErD,kFAAkF;AAClF,uFAAuF;AACvF,uEAAuE;AACvE,sFAAsF;AACzE,QAAA,UAAU,GAAG;IACtB,cAAc,EAAE,gBAAgB;IAChC,eAAe,EAAE,iBAAiB;IAClC,cAAc,EAAE,gBAAgB;IAChC,uBAAuB,EAAE,yBAAyB;IAClD,mBAAmB,EAAE,qBAAqB;IAC1C,oBAAoB,EAAE,sBAAsB;IAC5C,mBAAmB,EAAE,qBAAqB;IAC1C,mBAAmB,EAAE,qBAAqB;IAC1C,eAAe,EAAE,iBAAiB;IAClC,sBAAsB,EAAE,wBAAwB;IAChD,gBAAgB,EAAE,kBAAkB;IACpC,qBAAqB,EAAE,uBAAuB;IAC9C,wBAAwB,EAAE,0BAA0B;IACpD,kBAAkB,EAAE,oBAAoB;CAClC,CAAC;AAEX,wFAAwF;AACxF,0FAA0F;AAC1F,sFAAsF;AACtF,0DAA0D;AAC1D,EAAE;AACF,mFAAmF;AACnF,yFAAyF;AACzF,yFAAyF;AAC5E,QAAA,iBAAiB,GAAG,YAAY,CAAC;AACjC,QAAA,gBAAgB,GAAG,QAAQ,CAAC;AAC5B,QAAA,sBAAsB,GAAG,wBAAwB,CAAC;AAE/D,2FAA2F;AAC3F,mFAAmF;AACnF,uFAAuF;AACvF,kGAAkG;AAClG,kGAAkG;AAClG,kGAAkG;AAClG,iDAAiD;AACpC,QAAA,sBAAsB,GAAG,sBAAsB,CAAC;AAE7D;;;;;GAKG;AACH,SAAgB,UAAU,CAAC,IAAY,EAAE,QAAgB;IACrD,OAAO,IAAI,CAAC,QAAQ,CAAC,yBAAiB,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;AACvE,CAAC","sourcesContent":["// Single source of truth for the disable-comment token and rule-name identifiers\n// shared across rules-config, ai-hook-rules, code-rules, and pr-gate.\n//\n// There is exactly ONE disable form: `// webpieces-disable <rule>[, <rule2>] -- reason`.\n// The legacy `ai-hook-disable` alias and the `-file`/`-next`/`-all` variants and the\n// `*`/bare (no-rule) wildcard have been removed — every disable MUST name a rule.\n\nexport const WEBPIECES_DISABLE = 'webpieces-disable';\n\n// Rule-name tokens as they appear AFTER `webpieces-disable` in a disable comment.\n// Values must match existing comments exactly — changing a value silently breaks every\n// disable that names that rule. Note MAX_LINES_MODIFIED is a prefix of\n// MAX_LINES_MODIFIED_FILES (a historical substring-match quirk preserved on purpose).\nexport const RULE_NAMES = {\n    NO_ANY_UNKNOWN: 'no-any-unknown',\n    NO_IMPLICIT_ANY: 'no-implicit-any',\n    NO_DESTRUCTURE: 'no-destructure',\n    NO_UNMANAGED_EXCEPTIONS: 'no-unmanaged-exceptions',\n    CATCH_ERROR_PATTERN: 'catch-error-pattern',\n    THROW_CAUSE_REQUIRED: 'throw-cause-required',\n    REQUIRE_RETURN_TYPE: 'require-return-type',\n    NO_SYMBOL_DI_TOKENS: 'no-symbol-di-tokens',\n    NO_INLINE_TYPES: 'no-inline-types',\n    NO_DIRECT_API_RESOLVER: 'no-direct-api-resolver',\n    PRISMA_CONVERTER: 'prisma-converter',\n    MAX_LINES_NEW_METHODS: 'max-lines-new-methods',\n    MAX_LINES_MODIFIED_FILES: 'max-lines-modified-files',\n    MAX_LINES_MODIFIED: 'max-lines-modified',\n} as const;\n\n// Merge-state convention shared by the pr-gate scripts (which WRITE the marker during a\n// conflicted 3-point merge) and the ai-hook-rules merge-in-progress-guard (which READS it\n// to block commit/push/PR until the merge is validated). Kept here so neither package\n// depends on the other — they only share this vocabulary.\n//\n// `.webpieces/` is the single working dir for all webpieces tooling: ai-hook-rules\n// bootstrap/cache, the instruct-ai docs, and the per-feature merge-/review-/pr- workflow\n// dirs. It is gitignored. Only the prefixed workflow dirs are subject to 30-day cleanup.\nexport const WEBPIECES_TMP_DIR = '.webpieces';\nexport const MERGE_DIR_PREFIX = 'merge-';\nexport const MERGE_IN_PROGRESS_FILE = 'merge-in-progress.json';\n\n// Proof-of-work the AI must produce for every conflicted file it resolves during a 3-point\n// merge: a short explanation written NEXT TO that file's 3-point context (the same\n// `updatemain-<safe_path>/` dir that holds A-forkpoint.txt / B-A.diff / C-A.diff). The\n// merge-complete gate requires a non-empty file of this name per conflicted file before passing —\n// it is the only check on the part of the process the AI actually owns (resolving files). Using a\n// sidecar file (rather than an in-source comment) works for any file type, including comment-less\n// ones like JSON and files resolved by deletion.\nexport const MERGE_EXPLANATION_FILE = 'merge-explanation.md';\n\n/**\n * Fast predicate: does this text carry a webpieces-disable for the given rule?\n * Line-agnostic — the caller decides which line(s) or block of text to feed it.\n * This is the cheap substring form used by code-rules detection and pr-gate's\n * dashboard grep/count. (ai-hook-rules uses a richer line-mapping parser.)\n */\nexport function hasDisable(text: string, ruleName: string): boolean {\n    return text.includes(WEBPIECES_DISABLE) && text.includes(ruleName);\n}\n"]}
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../../../packages/tooling/rules-config/src/constants.ts"],"names":[],"mappings":";AAAA,iFAAiF;AACjF,sEAAsE;AACtE,EAAE;AACF,yFAAyF;AACzF,qFAAqF;AACrF,kFAAkF;;;AAoDlF,gCAEC;AApDY,QAAA,iBAAiB,GAAG,mBAAmB,CAAC;AAErD,kFAAkF;AAClF,uFAAuF;AACvF,uEAAuE;AACvE,sFAAsF;AACzE,QAAA,UAAU,GAAG;IACtB,cAAc,EAAE,gBAAgB;IAChC,eAAe,EAAE,iBAAiB;IAClC,cAAc,EAAE,gBAAgB;IAChC,uBAAuB,EAAE,yBAAyB;IAClD,mBAAmB,EAAE,qBAAqB;IAC1C,oBAAoB,EAAE,sBAAsB;IAC5C,mBAAmB,EAAE,qBAAqB;IAC1C,mBAAmB,EAAE,qBAAqB;IAC1C,eAAe,EAAE,iBAAiB;IAClC,sBAAsB,EAAE,wBAAwB;IAChD,gBAAgB,EAAE,kBAAkB;IACpC,qBAAqB,EAAE,uBAAuB;IAC9C,wBAAwB,EAAE,0BAA0B;IACpD,kBAAkB,EAAE,oBAAoB;CAClC,CAAC;AAEX,wFAAwF;AACxF,0FAA0F;AAC1F,sFAAsF;AACtF,0DAA0D;AAC1D,EAAE;AACF,mFAAmF;AACnF,yFAAyF;AACzF,yFAAyF;AAC5E,QAAA,iBAAiB,GAAG,YAAY,CAAC;AACjC,QAAA,gBAAgB,GAAG,QAAQ,CAAC;AAC5B,QAAA,sBAAsB,GAAG,wBAAwB,CAAC;AAE/D,2FAA2F;AAC3F,mFAAmF;AACnF,uFAAuF;AACvF,uGAAuG;AACvG,kGAAkG;AAClG,kGAAkG;AAClG,iDAAiD;AACpC,QAAA,sBAAsB,GAAG,sBAAsB,CAAC;AAE7D;;;;;GAKG;AACH,SAAgB,UAAU,CAAC,IAAY,EAAE,QAAgB;IACrD,OAAO,IAAI,CAAC,QAAQ,CAAC,yBAAiB,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;AACvE,CAAC","sourcesContent":["// Single source of truth for the disable-comment token and rule-name identifiers\n// shared across rules-config, ai-hook-rules, code-rules, and pr-gate.\n//\n// There is exactly ONE disable form: `// webpieces-disable <rule>[, <rule2>] -- reason`.\n// The legacy `ai-hook-disable` alias and the `-file`/`-next`/`-all` variants and the\n// `*`/bare (no-rule) wildcard have been removed — every disable MUST name a rule.\n\nexport const WEBPIECES_DISABLE = 'webpieces-disable';\n\n// Rule-name tokens as they appear AFTER `webpieces-disable` in a disable comment.\n// Values must match existing comments exactly — changing a value silently breaks every\n// disable that names that rule. Note MAX_LINES_MODIFIED is a prefix of\n// MAX_LINES_MODIFIED_FILES (a historical substring-match quirk preserved on purpose).\nexport const RULE_NAMES = {\n    NO_ANY_UNKNOWN: 'no-any-unknown',\n    NO_IMPLICIT_ANY: 'no-implicit-any',\n    NO_DESTRUCTURE: 'no-destructure',\n    NO_UNMANAGED_EXCEPTIONS: 'no-unmanaged-exceptions',\n    CATCH_ERROR_PATTERN: 'catch-error-pattern',\n    THROW_CAUSE_REQUIRED: 'throw-cause-required',\n    REQUIRE_RETURN_TYPE: 'require-return-type',\n    NO_SYMBOL_DI_TOKENS: 'no-symbol-di-tokens',\n    NO_INLINE_TYPES: 'no-inline-types',\n    NO_DIRECT_API_RESOLVER: 'no-direct-api-resolver',\n    PRISMA_CONVERTER: 'prisma-converter',\n    MAX_LINES_NEW_METHODS: 'max-lines-new-methods',\n    MAX_LINES_MODIFIED_FILES: 'max-lines-modified-files',\n    MAX_LINES_MODIFIED: 'max-lines-modified',\n} as const;\n\n// Merge-state convention shared by the pr-gate scripts (which WRITE the marker during a\n// conflicted 3-point merge) and the ai-hook-rules merge-in-progress-guard (which READS it\n// to block commit/push/PR until the merge is validated). Kept here so neither package\n// depends on the other — they only share this vocabulary.\n//\n// `.webpieces/` is the single working dir for all webpieces tooling: ai-hook-rules\n// bootstrap/cache, the instruct-ai docs, and the per-feature merge-/review-/pr- workflow\n// dirs. It is gitignored. Only the prefixed workflow dirs are subject to 30-day cleanup.\nexport const WEBPIECES_TMP_DIR = '.webpieces';\nexport const MERGE_DIR_PREFIX = 'merge-';\nexport const MERGE_IN_PROGRESS_FILE = 'merge-in-progress.json';\n\n// Proof-of-work the AI must produce for every conflicted file it resolves during a 3-point\n// merge: a short explanation written NEXT TO that file's 3-point context (the same\n// `updatemain-<safe_path>/` dir that holds A-forkpoint.txt / B-A.diff / C-A.diff). The\n// wp-finish-upsert-pr gate requires a non-empty file of this name per conflicted file before passing —\n// it is the only check on the part of the process the AI actually owns (resolving files). Using a\n// sidecar file (rather than an in-source comment) works for any file type, including comment-less\n// ones like JSON and files resolved by deletion.\nexport const MERGE_EXPLANATION_FILE = 'merge-explanation.md';\n\n/**\n * Fast predicate: does this text carry a webpieces-disable for the given rule?\n * Line-agnostic — the caller decides which line(s) or block of text to feed it.\n * This is the cheap substring form used by code-rules detection and pr-gate's\n * dashboard grep/count. (ai-hook-rules uses a richer line-mapping parser.)\n */\nexport function hasDisable(text: string, ruleName: string): boolean {\n    return text.includes(WEBPIECES_DISABLE) && text.includes(ruleName);\n}\n"]}

package/src/index.d.ts

@@ -1,12 +1,12 @@
 export { ResolvedConfig, ResolvedRuleConfig, RuleOptions } from './types';
 export { InformAiError } from './inform-ai-error';
 export { toError } from './to-error';
-export { loadConfig, findConfigFile, CONFIG_FILENAME, loadWebpiecesRulesConfig } from './load-config';
-export type { LoadedWebpiecesConfig } from './load-config';
+export { loadAndValidate, LoadedConfig } from './load-config';
+export { findConfigFile, CONFIG_FILENAME } from './config-file';
 export { isPathExcluded } from './exclude-paths';
 export { defaultRules, defaultRulesDir } from './default-rules';
 export { loadTemplate, writeTemplateIfMissing, writeTemplate } from './load-template';
-export { validateWebpiecesConfig } from './validate-config';
+export { validateWebpiecesConfig, validatePrGateSection } from './validate-config';
 export { FieldDef } from './field-def';
 export type { SchemaShape } from './field-def';
 export { shouldSkipRule, getCurrentBranch } from './skip-rule';
@@ -17,4 +17,5 @@ export { WebpiecesRulesConfig } from './WebpiecesRulesConfig';
 export { MaxMethodLinesConfig, MaxFileLinesConfig, RequireReturnTypeConfig, NoInlineTypeLiteralsConfig, NoAnyUnknownConfig, NoImplicitAnyConfig, PrismaValidateDtosConfig, PrismaConverterConfig, NoDestructureConfig, NoUnmanagedExceptionsConfig, CatchErrorPatternConfig, ThrowCauseRequiredConfig, AngularNoDirectApiInResolverConfig, NoSymbolDiTokensConfig, NoShellSubstitutionConfig, BranchCreationGuardConfig, PrCreationGuardConfig, MergeInProgressGuardConfig, PrMergeCleanupConfig, NoDirectMainUpdateConfig, NoEditOnMainConfig, NoFileImportCyclesConfig, RuntimeArchitectureConfig, NoJsFilesConfig, ValidateTsInSrcConfig, BaseRuleConfig, } from './rule-configs';
 export { METHOD_LIMIT_MODES, FILE_LIMIT_MODES, RETURN_TYPE_MODES, INLINE_TYPE_MODES, MODIFIED_CODE_MODES, PRISMA_DTOS_MODES, PRISMA_CONVERTER_MODES, DIRECT_API_RESOLVER_MODES, THROW_CAUSE_MODES, ON_OFF_MODES, VALIDATE_TS_MODES, } from './rule-configs';
 export type { MethodLimitMode, FileLimitMode, ReturnTypeMode, InlineTypeMode, ModifiedCodeMode, PrismaValidateDtosMode, PrismaConverterMode, DirectApiResolverMode, ThrowCauseMode, OnOffMode, ValidateTsMode, } from './rule-configs';
-export { GateDefinition, PrGateConfig, defaultGates, defaultPrGateConfig, loadPrGateConfig, } from './pr-gate-config';
+export { GateDefinition, PrGateConfig, defaultGates, defaultPrGateConfig, buildPrGateConfig, } from './pr-gate-config';
+export { ReviewJson, loadReviewJson, reviewJsonPath, reviewJsonSchemaHint, } from './review-json';

package/src/index.js

@@ -1,7 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.RuntimeArchitectureConfig = exports.NoFileImportCyclesConfig = exports.NoEditOnMainConfig = exports.NoDirectMainUpdateConfig = exports.PrMergeCleanupConfig = exports.MergeInProgressGuardConfig = exports.PrCreationGuardConfig = exports.BranchCreationGuardConfig = exports.NoShellSubstitutionConfig = exports.NoSymbolDiTokensConfig = exports.AngularNoDirectApiInResolverConfig = exports.ThrowCauseRequiredConfig = exports.CatchErrorPatternConfig = exports.NoUnmanagedExceptionsConfig = exports.NoDestructureConfig = exports.PrismaConverterConfig = exports.PrismaValidateDtosConfig = exports.NoImplicitAnyConfig = exports.NoAnyUnknownConfig = exports.NoInlineTypeLiteralsConfig = exports.RequireReturnTypeConfig = exports.MaxFileLinesConfig = exports.MaxMethodLinesConfig = exports.WebpiecesRulesConfig = exports.MERGE_EXPLANATION_FILE = exports.MERGE_IN_PROGRESS_FILE = exports.MERGE_DIR_PREFIX = exports.WEBPIECES_TMP_DIR = exports.hasDisable = exports.RULE_NAMES = exports.WEBPIECES_DISABLE = exports.AbstractRule = exports.getCurrentBranch = exports.shouldSkipRule = exports.FieldDef = exports.validateWebpiecesConfig = exports.writeTemplate = exports.writeTemplateIfMissing = exports.loadTemplate = exports.defaultRulesDir = exports.defaultRules = exports.isPathExcluded = exports.loadWebpiecesRulesConfig = exports.CONFIG_FILENAME = exports.findConfigFile = exports.loadConfig = exports.toError = exports.InformAiError = exports.ResolvedRuleConfig = exports.ResolvedConfig = void 0;
-exports.loadPrGateConfig = exports.defaultPrGateConfig = exports.defaultGates = exports.PrGateConfig = exports.GateDefinition = exports.VALIDATE_TS_MODES = exports.ON_OFF_MODES = exports.THROW_CAUSE_MODES = exports.DIRECT_API_RESOLVER_MODES = exports.PRISMA_CONVERTER_MODES = exports.PRISMA_DTOS_MODES = exports.MODIFIED_CODE_MODES = exports.INLINE_TYPE_MODES = exports.RETURN_TYPE_MODES = exports.FILE_LIMIT_MODES = exports.METHOD_LIMIT_MODES = exports.BaseRuleConfig = exports.ValidateTsInSrcConfig = exports.NoJsFilesConfig = void 0;
+exports.NoFileImportCyclesConfig = exports.NoEditOnMainConfig = exports.NoDirectMainUpdateConfig = exports.PrMergeCleanupConfig = exports.MergeInProgressGuardConfig = exports.PrCreationGuardConfig = exports.BranchCreationGuardConfig = exports.NoShellSubstitutionConfig = exports.NoSymbolDiTokensConfig = exports.AngularNoDirectApiInResolverConfig = exports.ThrowCauseRequiredConfig = exports.CatchErrorPatternConfig = exports.NoUnmanagedExceptionsConfig = exports.NoDestructureConfig = exports.PrismaConverterConfig = exports.PrismaValidateDtosConfig = exports.NoImplicitAnyConfig = exports.NoAnyUnknownConfig = exports.NoInlineTypeLiteralsConfig = exports.RequireReturnTypeConfig = exports.MaxFileLinesConfig = exports.MaxMethodLinesConfig = exports.WebpiecesRulesConfig = exports.MERGE_EXPLANATION_FILE = exports.MERGE_IN_PROGRESS_FILE = exports.MERGE_DIR_PREFIX = exports.WEBPIECES_TMP_DIR = exports.hasDisable = exports.RULE_NAMES = exports.WEBPIECES_DISABLE = exports.AbstractRule = exports.getCurrentBranch = exports.shouldSkipRule = exports.FieldDef = exports.validatePrGateSection = exports.validateWebpiecesConfig = exports.writeTemplate = exports.writeTemplateIfMissing = exports.loadTemplate = exports.defaultRulesDir = exports.defaultRules = exports.isPathExcluded = exports.CONFIG_FILENAME = exports.findConfigFile = exports.LoadedConfig = exports.loadAndValidate = exports.toError = exports.InformAiError = exports.ResolvedRuleConfig = exports.ResolvedConfig = void 0;
+exports.reviewJsonSchemaHint = exports.reviewJsonPath = exports.loadReviewJson = exports.ReviewJson = exports.buildPrGateConfig = exports.defaultPrGateConfig = exports.defaultGates = exports.PrGateConfig = exports.GateDefinition = exports.VALIDATE_TS_MODES = exports.ON_OFF_MODES = exports.THROW_CAUSE_MODES = exports.DIRECT_API_RESOLVER_MODES = exports.PRISMA_CONVERTER_MODES = exports.PRISMA_DTOS_MODES = exports.MODIFIED_CODE_MODES = exports.INLINE_TYPE_MODES = exports.RETURN_TYPE_MODES = exports.FILE_LIMIT_MODES = exports.METHOD_LIMIT_MODES = exports.BaseRuleConfig = exports.ValidateTsInSrcConfig = exports.NoJsFilesConfig = exports.RuntimeArchitectureConfig = void 0;
 var types_1 = require("./types");
 Object.defineProperty(exports, "ResolvedConfig", { enumerable: true, get: function () { return types_1.ResolvedConfig; } });
 Object.defineProperty(exports, "ResolvedRuleConfig", { enumerable: true, get: function () { return types_1.ResolvedRuleConfig; } });
@@ -10,10 +10,11 @@ Object.defineProperty(exports, "InformAiError", { enumerable: true, get: functio
 var to_error_1 = require("./to-error");
 Object.defineProperty(exports, "toError", { enumerable: true, get: function () { return to_error_1.toError; } });
 var load_config_1 = require("./load-config");
-Object.defineProperty(exports, "loadConfig", { enumerable: true, get: function () { return load_config_1.loadConfig; } });
-Object.defineProperty(exports, "findConfigFile", { enumerable: true, get: function () { return load_config_1.findConfigFile; } });
-Object.defineProperty(exports, "CONFIG_FILENAME", { enumerable: true, get: function () { return load_config_1.CONFIG_FILENAME; } });
-Object.defineProperty(exports, "loadWebpiecesRulesConfig", { enumerable: true, get: function () { return load_config_1.loadWebpiecesRulesConfig; } });
+Object.defineProperty(exports, "loadAndValidate", { enumerable: true, get: function () { return load_config_1.loadAndValidate; } });
+Object.defineProperty(exports, "LoadedConfig", { enumerable: true, get: function () { return load_config_1.LoadedConfig; } });
+var config_file_1 = require("./config-file");
+Object.defineProperty(exports, "findConfigFile", { enumerable: true, get: function () { return config_file_1.findConfigFile; } });
+Object.defineProperty(exports, "CONFIG_FILENAME", { enumerable: true, get: function () { return config_file_1.CONFIG_FILENAME; } });
 var exclude_paths_1 = require("./exclude-paths");
 Object.defineProperty(exports, "isPathExcluded", { enumerable: true, get: function () { return exclude_paths_1.isPathExcluded; } });
 var default_rules_1 = require("./default-rules");
@@ -25,6 +26,7 @@ Object.defineProperty(exports, "writeTemplateIfMissing", { enumerable: true, get
 Object.defineProperty(exports, "writeTemplate", { enumerable: true, get: function () { return load_template_1.writeTemplate; } });
 var validate_config_1 = require("./validate-config");
 Object.defineProperty(exports, "validateWebpiecesConfig", { enumerable: true, get: function () { return validate_config_1.validateWebpiecesConfig; } });
+Object.defineProperty(exports, "validatePrGateSection", { enumerable: true, get: function () { return validate_config_1.validatePrGateSection; } });
 var field_def_1 = require("./field-def");
 Object.defineProperty(exports, "FieldDef", { enumerable: true, get: function () { return field_def_1.FieldDef; } });
 var skip_rule_1 = require("./skip-rule");
@@ -87,5 +89,10 @@ Object.defineProperty(exports, "GateDefinition", { enumerable: true, get: functi
 Object.defineProperty(exports, "PrGateConfig", { enumerable: true, get: function () { return pr_gate_config_1.PrGateConfig; } });
 Object.defineProperty(exports, "defaultGates", { enumerable: true, get: function () { return pr_gate_config_1.defaultGates; } });
 Object.defineProperty(exports, "defaultPrGateConfig", { enumerable: true, get: function () { return pr_gate_config_1.defaultPrGateConfig; } });
-Object.defineProperty(exports, "loadPrGateConfig", { enumerable: true, get: function () { return pr_gate_config_1.loadPrGateConfig; } });
+Object.defineProperty(exports, "buildPrGateConfig", { enumerable: true, get: function () { return pr_gate_config_1.buildPrGateConfig; } });
+var review_json_1 = require("./review-json");
+Object.defineProperty(exports, "ReviewJson", { enumerable: true, get: function () { return review_json_1.ReviewJson; } });
+Object.defineProperty(exports, "loadReviewJson", { enumerable: true, get: function () { return review_json_1.loadReviewJson; } });
+Object.defineProperty(exports, "reviewJsonPath", { enumerable: true, get: function () { return review_json_1.reviewJsonPath; } });
+Object.defineProperty(exports, "reviewJsonSchemaHint", { enumerable: true, get: function () { return review_json_1.reviewJsonSchemaHint; } });
 //# sourceMappingURL=index.js.map

package/src/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../packages/tooling/rules-config/src/index.ts"],"names":[],"mappings":";;;;AAAA,iCAA0E;AAAjE,uGAAA,cAAc,OAAA;AAAE,2GAAA,kBAAkB,OAAA;AAC3C,qDAAkD;AAAzC,gHAAA,aAAa,OAAA;AACtB,uCAAqC;AAA5B,mGAAA,OAAO,OAAA;AAChB,6CAAsG;AAA7F,yGAAA,UAAU,OAAA;AAAE,6GAAA,cAAc,OAAA;AAAE,8GAAA,eAAe,OAAA;AAAE,uHAAA,wBAAwB,OAAA;AAE9E,iDAAiD;AAAxC,+GAAA,cAAc,OAAA;AACvB,iDAAgE;AAAvD,6GAAA,YAAY,OAAA;AAAE,gHAAA,eAAe,OAAA;AACtC,iDAAsF;AAA7E,6GAAA,YAAY,OAAA;AAAE,uHAAA,sBAAsB,OAAA;AAAE,8GAAA,aAAa,OAAA;AAC5D,qDAA4D;AAAnD,0HAAA,uBAAuB,OAAA;AAChC,yCAAuC;AAA9B,qGAAA,QAAQ,OAAA;AAEjB,yCAA+D;AAAtD,2GAAA,cAAc,OAAA;AAAE,6GAAA,gBAAgB,OAAA;AAEzC,iDAA+C;AAAtC,6GAAA,YAAY,OAAA;AACrB,yCAQqB;AAPjB,8GAAA,iBAAiB,OAAA;AACjB,uGAAA,UAAU,OAAA;AACV,uGAAA,UAAU,OAAA;AACV,8GAAA,iBAAiB,OAAA;AACjB,6GAAA,gBAAgB,OAAA;AAChB,mHAAA,sBAAsB,OAAA;AACtB,mHAAA,sBAAsB,OAAA;AAE1B,+DAA8D;AAArD,4HAAA,oBAAoB,OAAA;AAC7B,+CA2BwB;AA1BpB,oHAAA,oBAAoB,OAAA;AACpB,kHAAA,kBAAkB,OAAA;AAClB,uHAAA,uBAAuB,OAAA;AACvB,0HAAA,0BAA0B,OAAA;AAC1B,kHAAA,kBAAkB,OAAA;AAClB,mHAAA,mBAAmB,OAAA;AACnB,wHAAA,wBAAwB,OAAA;AACxB,qHAAA,qBAAqB,OAAA;AACrB,mHAAA,mBAAmB,OAAA;AACnB,2HAAA,2BAA2B,OAAA;AAC3B,uHAAA,uBAAuB,OAAA;AACvB,wHAAA,wBAAwB,OAAA;AACxB,kIAAA,kCAAkC,OAAA;AAClC,sHAAA,sBAAsB,OAAA;AACtB,yHAAA,yBAAyB,OAAA;AACzB,yHAAA,yBAAyB,OAAA;AACzB,qHAAA,qBAAqB,OAAA;AACrB,0HAAA,0BAA0B,OAAA;AAC1B,oHAAA,oBAAoB,OAAA;AACpB,wHAAA,wBAAwB,OAAA;AACxB,kHAAA,kBAAkB,OAAA;AAClB,wHAAA,wBAAwB,OAAA;AACxB,yHAAA,yBAAyB,OAAA;AACzB,+GAAA,eAAe,OAAA;AACf,qHAAA,qBAAqB,OAAA;AACrB,8GAAA,cAAc,OAAA;AAElB,wFAAwF;AACxF,+CAYwB;AAXpB,kHAAA,kBAAkB,OAAA;AAClB,gHAAA,gBAAgB,OAAA;AAChB,iHAAA,iBAAiB,OAAA;AACjB,iHAAA,iBAAiB,OAAA;AACjB,mHAAA,mBAAmB,OAAA;AACnB,iHAAA,iBAAiB,OAAA;AACjB,sHAAA,sBAAsB,OAAA;AACtB,yHAAA,yBAAyB,OAAA;AACzB,iHAAA,iBAAiB,OAAA;AACjB,4GAAA,YAAY,OAAA;AACZ,iHAAA,iBAAiB,OAAA;AAerB,mDAM0B;AALtB,gHAAA,cAAc,OAAA;AACd,8GAAA,YAAY,OAAA;AACZ,8GAAA,YAAY,OAAA;AACZ,qHAAA,mBAAmB,OAAA;AACnB,kHAAA,gBAAgB,OAAA","sourcesContent":["export { ResolvedConfig, ResolvedRuleConfig, RuleOptions } from './types';\nexport { InformAiError } from './inform-ai-error';\nexport { toError } from './to-error';\nexport { loadConfig, findConfigFile, CONFIG_FILENAME, loadWebpiecesRulesConfig } from './load-config';\nexport type { LoadedWebpiecesConfig } from './load-config';\nexport { isPathExcluded } from './exclude-paths';\nexport { defaultRules, defaultRulesDir } from './default-rules';\nexport { loadTemplate, writeTemplateIfMissing, writeTemplate } from './load-template';\nexport { validateWebpiecesConfig } from './validate-config';\nexport { FieldDef } from './field-def';\nexport type { SchemaShape } from './field-def';\nexport { shouldSkipRule, getCurrentBranch } from './skip-rule';\nexport type { SkipRuleResult } from './skip-rule';\nexport { AbstractRule } from './abstract-rule';\nexport {\n    WEBPIECES_DISABLE,\n    RULE_NAMES,\n    hasDisable,\n    WEBPIECES_TMP_DIR,\n    MERGE_DIR_PREFIX,\n    MERGE_IN_PROGRESS_FILE,\n    MERGE_EXPLANATION_FILE,\n} from './constants';\nexport { WebpiecesRulesConfig } from './WebpiecesRulesConfig';\nexport {\n    MaxMethodLinesConfig,\n    MaxFileLinesConfig,\n    RequireReturnTypeConfig,\n    NoInlineTypeLiteralsConfig,\n    NoAnyUnknownConfig,\n    NoImplicitAnyConfig,\n    PrismaValidateDtosConfig,\n    PrismaConverterConfig,\n    NoDestructureConfig,\n    NoUnmanagedExceptionsConfig,\n    CatchErrorPatternConfig,\n    ThrowCauseRequiredConfig,\n    AngularNoDirectApiInResolverConfig,\n    NoSymbolDiTokensConfig,\n    NoShellSubstitutionConfig,\n    BranchCreationGuardConfig,\n    PrCreationGuardConfig,\n    MergeInProgressGuardConfig,\n    PrMergeCleanupConfig,\n    NoDirectMainUpdateConfig,\n    NoEditOnMainConfig,\n    NoFileImportCyclesConfig,\n    RuntimeArchitectureConfig,\n    NoJsFilesConfig,\n    ValidateTsInSrcConfig,\n    BaseRuleConfig,\n} from './rule-configs';\n// Mode unions + their value arrays — the single source of truth shared with code-rules.\nexport {\n    METHOD_LIMIT_MODES,\n    FILE_LIMIT_MODES,\n    RETURN_TYPE_MODES,\n    INLINE_TYPE_MODES,\n    MODIFIED_CODE_MODES,\n    PRISMA_DTOS_MODES,\n    PRISMA_CONVERTER_MODES,\n    DIRECT_API_RESOLVER_MODES,\n    THROW_CAUSE_MODES,\n    ON_OFF_MODES,\n    VALIDATE_TS_MODES,\n} from './rule-configs';\nexport type {\n    MethodLimitMode,\n    FileLimitMode,\n    ReturnTypeMode,\n    InlineTypeMode,\n    ModifiedCodeMode,\n    PrismaValidateDtosMode,\n    PrismaConverterMode,\n    DirectApiResolverMode,\n    ThrowCauseMode,\n    OnOffMode,\n    ValidateTsMode,\n} from './rule-configs';\nexport {\n    GateDefinition,\n    PrGateConfig,\n    defaultGates,\n    defaultPrGateConfig,\n    loadPrGateConfig,\n} from './pr-gate-config';\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../packages/tooling/rules-config/src/index.ts"],"names":[],"mappings":";;;;AAAA,iCAA0E;AAAjE,uGAAA,cAAc,OAAA;AAAE,2GAAA,kBAAkB,OAAA;AAC3C,qDAAkD;AAAzC,gHAAA,aAAa,OAAA;AACtB,uCAAqC;AAA5B,mGAAA,OAAO,OAAA;AAChB,6CAA8D;AAArD,8GAAA,eAAe,OAAA;AAAE,2GAAA,YAAY,OAAA;AACtC,6CAAgE;AAAvD,6GAAA,cAAc,OAAA;AAAE,8GAAA,eAAe,OAAA;AACxC,iDAAiD;AAAxC,+GAAA,cAAc,OAAA;AACvB,iDAAgE;AAAvD,6GAAA,YAAY,OAAA;AAAE,gHAAA,eAAe,OAAA;AACtC,iDAAsF;AAA7E,6GAAA,YAAY,OAAA;AAAE,uHAAA,sBAAsB,OAAA;AAAE,8GAAA,aAAa,OAAA;AAC5D,qDAAmF;AAA1E,0HAAA,uBAAuB,OAAA;AAAE,wHAAA,qBAAqB,OAAA;AACvD,yCAAuC;AAA9B,qGAAA,QAAQ,OAAA;AAEjB,yCAA+D;AAAtD,2GAAA,cAAc,OAAA;AAAE,6GAAA,gBAAgB,OAAA;AAEzC,iDAA+C;AAAtC,6GAAA,YAAY,OAAA;AACrB,yCAQqB;AAPjB,8GAAA,iBAAiB,OAAA;AACjB,uGAAA,UAAU,OAAA;AACV,uGAAA,UAAU,OAAA;AACV,8GAAA,iBAAiB,OAAA;AACjB,6GAAA,gBAAgB,OAAA;AAChB,mHAAA,sBAAsB,OAAA;AACtB,mHAAA,sBAAsB,OAAA;AAE1B,+DAA8D;AAArD,4HAAA,oBAAoB,OAAA;AAC7B,+CA2BwB;AA1BpB,oHAAA,oBAAoB,OAAA;AACpB,kHAAA,kBAAkB,OAAA;AAClB,uHAAA,uBAAuB,OAAA;AACvB,0HAAA,0BAA0B,OAAA;AAC1B,kHAAA,kBAAkB,OAAA;AAClB,mHAAA,mBAAmB,OAAA;AACnB,wHAAA,wBAAwB,OAAA;AACxB,qHAAA,qBAAqB,OAAA;AACrB,mHAAA,mBAAmB,OAAA;AACnB,2HAAA,2BAA2B,OAAA;AAC3B,uHAAA,uBAAuB,OAAA;AACvB,wHAAA,wBAAwB,OAAA;AACxB,kIAAA,kCAAkC,OAAA;AAClC,sHAAA,sBAAsB,OAAA;AACtB,yHAAA,yBAAyB,OAAA;AACzB,yHAAA,yBAAyB,OAAA;AACzB,qHAAA,qBAAqB,OAAA;AACrB,0HAAA,0BAA0B,OAAA;AAC1B,oHAAA,oBAAoB,OAAA;AACpB,wHAAA,wBAAwB,OAAA;AACxB,kHAAA,kBAAkB,OAAA;AAClB,wHAAA,wBAAwB,OAAA;AACxB,yHAAA,yBAAyB,OAAA;AACzB,+GAAA,eAAe,OAAA;AACf,qHAAA,qBAAqB,OAAA;AACrB,8GAAA,cAAc,OAAA;AAElB,wFAAwF;AACxF,+CAYwB;AAXpB,kHAAA,kBAAkB,OAAA;AAClB,gHAAA,gBAAgB,OAAA;AAChB,iHAAA,iBAAiB,OAAA;AACjB,iHAAA,iBAAiB,OAAA;AACjB,mHAAA,mBAAmB,OAAA;AACnB,iHAAA,iBAAiB,OAAA;AACjB,sHAAA,sBAAsB,OAAA;AACtB,yHAAA,yBAAyB,OAAA;AACzB,iHAAA,iBAAiB,OAAA;AACjB,4GAAA,YAAY,OAAA;AACZ,iHAAA,iBAAiB,OAAA;AAerB,mDAM0B;AALtB,gHAAA,cAAc,OAAA;AACd,8GAAA,YAAY,OAAA;AACZ,8GAAA,YAAY,OAAA;AACZ,qHAAA,mBAAmB,OAAA;AACnB,mHAAA,iBAAiB,OAAA;AAErB,6CAKuB;AAJnB,yGAAA,UAAU,OAAA;AACV,6GAAA,cAAc,OAAA;AACd,6GAAA,cAAc,OAAA;AACd,mHAAA,oBAAoB,OAAA","sourcesContent":["export { ResolvedConfig, ResolvedRuleConfig, RuleOptions } from './types';\nexport { InformAiError } from './inform-ai-error';\nexport { toError } from './to-error';\nexport { loadAndValidate, LoadedConfig } from './load-config';\nexport { findConfigFile, CONFIG_FILENAME } from './config-file';\nexport { isPathExcluded } from './exclude-paths';\nexport { defaultRules, defaultRulesDir } from './default-rules';\nexport { loadTemplate, writeTemplateIfMissing, writeTemplate } from './load-template';\nexport { validateWebpiecesConfig, validatePrGateSection } from './validate-config';\nexport { FieldDef } from './field-def';\nexport type { SchemaShape } from './field-def';\nexport { shouldSkipRule, getCurrentBranch } from './skip-rule';\nexport type { SkipRuleResult } from './skip-rule';\nexport { AbstractRule } from './abstract-rule';\nexport {\n    WEBPIECES_DISABLE,\n    RULE_NAMES,\n    hasDisable,\n    WEBPIECES_TMP_DIR,\n    MERGE_DIR_PREFIX,\n    MERGE_IN_PROGRESS_FILE,\n    MERGE_EXPLANATION_FILE,\n} from './constants';\nexport { WebpiecesRulesConfig } from './WebpiecesRulesConfig';\nexport {\n    MaxMethodLinesConfig,\n    MaxFileLinesConfig,\n    RequireReturnTypeConfig,\n    NoInlineTypeLiteralsConfig,\n    NoAnyUnknownConfig,\n    NoImplicitAnyConfig,\n    PrismaValidateDtosConfig,\n    PrismaConverterConfig,\n    NoDestructureConfig,\n    NoUnmanagedExceptionsConfig,\n    CatchErrorPatternConfig,\n    ThrowCauseRequiredConfig,\n    AngularNoDirectApiInResolverConfig,\n    NoSymbolDiTokensConfig,\n    NoShellSubstitutionConfig,\n    BranchCreationGuardConfig,\n    PrCreationGuardConfig,\n    MergeInProgressGuardConfig,\n    PrMergeCleanupConfig,\n    NoDirectMainUpdateConfig,\n    NoEditOnMainConfig,\n    NoFileImportCyclesConfig,\n    RuntimeArchitectureConfig,\n    NoJsFilesConfig,\n    ValidateTsInSrcConfig,\n    BaseRuleConfig,\n} from './rule-configs';\n// Mode unions + their value arrays — the single source of truth shared with code-rules.\nexport {\n    METHOD_LIMIT_MODES,\n    FILE_LIMIT_MODES,\n    RETURN_TYPE_MODES,\n    INLINE_TYPE_MODES,\n    MODIFIED_CODE_MODES,\n    PRISMA_DTOS_MODES,\n    PRISMA_CONVERTER_MODES,\n    DIRECT_API_RESOLVER_MODES,\n    THROW_CAUSE_MODES,\n    ON_OFF_MODES,\n    VALIDATE_TS_MODES,\n} from './rule-configs';\nexport type {\n    MethodLimitMode,\n    FileLimitMode,\n    ReturnTypeMode,\n    InlineTypeMode,\n    ModifiedCodeMode,\n    PrismaValidateDtosMode,\n    PrismaConverterMode,\n    DirectApiResolverMode,\n    ThrowCauseMode,\n    OnOffMode,\n    ValidateTsMode,\n} from './rule-configs';\nexport {\n    GateDefinition,\n    PrGateConfig,\n    defaultGates,\n    defaultPrGateConfig,\n    buildPrGateConfig,\n} from './pr-gate-config';\nexport {\n    ReviewJson,\n    loadReviewJson,\n    reviewJsonPath,\n    reviewJsonSchemaHint,\n} from './review-json';\n"]}

package/src/load-config.d.ts

@@ -1,13 +1,25 @@
+import { PrGateConfig } from './pr-gate-config';
 import { ResolvedConfig } from './types';
 import { WebpiecesRulesConfig } from './WebpiecesRulesConfig';
-export declare const CONFIG_FILENAME = "webpieces.config.json";
 /**
- * Walk up from `startDir` looking for webpieces.config.json.
+ * Everything a consumer might need from webpieces.config.json, produced from ONE parse + ONE
+ * validation pass. Data-only (per CLAUDE.md, classes for data):
+ *  - `resolved`    — Map-based view merged with defaultRules (nx executors).
+ *  - `rulesConfig` — typed WebpiecesRulesConfig (ai-hook-rules, code-rules).
+ *  - `prGate`      — the pr-gate section (pr-gate scripts).
+ *  - `configPath`  — absolute path, or null when no config file was found.
  */
-export declare function findConfigFile(startDir: string): string | null;
-export declare function loadConfig(cwd: string): ResolvedConfig;
-export interface LoadedWebpiecesConfig {
-    readonly config: WebpiecesRulesConfig;
-    readonly configPath: string;
+export declare class LoadedConfig {
+    readonly resolved: ResolvedConfig;
+    readonly rulesConfig: WebpiecesRulesConfig;
+    readonly prGate: PrGateConfig;
+    readonly configPath: string | null;
+    constructor(resolved: ResolvedConfig, rulesConfig: WebpiecesRulesConfig, prGate: PrGateConfig, configPath: string | null);
 }
-export declare function loadWebpiecesRulesConfig(cwd: string): LoadedWebpiecesConfig | null;
+/**
+ * The single load+validate entry point for ALL consumers (ai-hook-rules, code-rules,
+ * nx-webpieces-rules, pr-gate scripts). Reads webpieces.config.json once, validates BOTH the `rules`
+ * map and the top-level `pr-gate` block, and throws one InformAiError listing every error. When no
+ * config file is found it returns lenient empties/defaults (matching prior no-file behavior).
+ */
+export declare function loadAndValidate(cwd: string): LoadedConfig;

package/src/load-config.js

@@ -1,34 +1,14 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.CONFIG_FILENAME = void 0;
-exports.findConfigFile = findConfigFile;
-exports.loadConfig = loadConfig;
-exports.loadWebpiecesRulesConfig = loadWebpiecesRulesConfig;
-const tslib_1 = require("tslib");
-const fs = tslib_1.__importStar(require("fs"));
-const path = tslib_1.__importStar(require("path"));
+exports.LoadedConfig = void 0;
+exports.loadAndValidate = loadAndValidate;
+const config_file_1 = require("./config-file");
 const default_rules_1 = require("./default-rules");
 const inform_ai_error_1 = require("./inform-ai-error");
-const to_error_1 = require("./to-error");
+const pr_gate_config_1 = require("./pr-gate-config");
 const types_1 = require("./types");
 const validate_config_1 = require("./validate-config");
 const WebpiecesRulesConfig_1 = require("./WebpiecesRulesConfig");
-exports.CONFIG_FILENAME = 'webpieces.config.json';
-/**
- * Walk up from `startDir` looking for webpieces.config.json.
- */
-function findConfigFile(startDir) {
-    let dir = startDir;
-    while (true) {
-        const primary = path.join(dir, exports.CONFIG_FILENAME);
-        if (fs.existsSync(primary))
-            return primary;
-        const parent = path.dirname(dir);
-        if (parent === dir)
-            return null;
-        dir = parent;
-    }
-}
 // webpieces-disable no-any-unknown -- merging opaque option bags from config JSON
 function mergeRule(
 // webpieces-disable no-any-unknown -- opaque option bag
@@ -49,31 +29,60 @@ overrideRule) {
         merged[key] = overrideRule[key];
     return new types_1.ResolvedRuleConfig(merged);
 }
-function readRawConfig(configPath) {
-    const raw = fs.readFileSync(configPath, 'utf8');
-    // eslint-disable-next-line @webpieces/no-unmanaged-exceptions
-    try {
-        return JSON.parse(raw);
+function buildWebpiecesRulesConfig(
+// webpieces-disable no-any-unknown -- JSON values are opaque until assigned to typed fields
+rawRules, rulesDir) {
+    const typed = new WebpiecesRulesConfig_1.WebpiecesRulesConfig();
+    for (const key of Object.keys(rawRules)) {
+        // webpieces-disable no-any-unknown -- dynamic key assignment to typed class
+        typed[key] = rawRules[key];
     }
-    catch (err) {
-        const error = (0, to_error_1.toError)(err);
-        throw new inform_ai_error_1.InformAiError(`webpieces.config.json has invalid JSON — fix the file, then retry.\n` +
-            `Parse error: ${error.message}\n` +
-            `File: ${configPath}`);
+    typed.rulesDir = rulesDir;
+    return typed;
+}
+/**
+ * Everything a consumer might need from webpieces.config.json, produced from ONE parse + ONE
+ * validation pass. Data-only (per CLAUDE.md, classes for data):
+ *  - `resolved`    — Map-based view merged with defaultRules (nx executors).
+ *  - `rulesConfig` — typed WebpiecesRulesConfig (ai-hook-rules, code-rules).
+ *  - `prGate`      — the pr-gate section (pr-gate scripts).
+ *  - `configPath`  — absolute path, or null when no config file was found.
+ */
+class LoadedConfig {
+    resolved;
+    rulesConfig;
+    prGate;
+    configPath;
+    constructor(resolved, rulesConfig, prGate, configPath) {
+        this.resolved = resolved;
+        this.rulesConfig = rulesConfig;
+        this.prGate = prGate;
+        this.configPath = configPath;
     }
 }
-function loadConfig(cwd) {
-    const configPath = findConfigFile(cwd);
+exports.LoadedConfig = LoadedConfig;
+/**
+ * The single load+validate entry point for ALL consumers (ai-hook-rules, code-rules,
+ * nx-webpieces-rules, pr-gate scripts). Reads webpieces.config.json once, validates BOTH the `rules`
+ * map and the top-level `pr-gate` block, and throws one InformAiError listing every error. When no
+ * config file is found it returns lenient empties/defaults (matching prior no-file behavior).
+ */
+function loadAndValidate(cwd) {
+    const configPath = (0, config_file_1.findConfigFile)(cwd);
     if (!configPath) {
-        return new types_1.ResolvedConfig(new Map(), new Set(), [], null);
+        return new LoadedConfig(new types_1.ResolvedConfig(new Map(), new Set(), [], null), new WebpiecesRulesConfig_1.WebpiecesRulesConfig(), (0, pr_gate_config_1.buildPrGateConfig)(undefined), null);
     }
-    const consumerConfig = readRawConfig(configPath);
+    const consumerConfig = (0, config_file_1.readRawConfig)(configPath);
     const overrideRules = consumerConfig.rules || {};
-    const validationErrors = (0, validate_config_1.validateWebpiecesConfig)(overrideRules);
-    if (validationErrors.length > 0) {
-        throw new inform_ai_error_1.InformAiError(`webpieces.config.json has ${validationErrors.length} validation error(s) — fix ALL, then retry:\n\n` +
-            validationErrors.map(e => `  • ${e}`).join('\n'));
+    const errors = [
+        ...(0, validate_config_1.validateWebpiecesConfig)(overrideRules),
+        ...(0, validate_config_1.validatePrGateSection)(consumerConfig['pr-gate']),
+    ];
+    if (errors.length > 0) {
+        throw new inform_ai_error_1.InformAiError(`webpieces.config.json has ${errors.length} validation error(s) — fix ALL, then retry:\n\n` +
+            errors.map(e => `  • ${e}`).join('\n'));
     }
+    const rulesDir = consumerConfig.rulesDir ?? [];
     const userConfiguredRuleNames = new Set(Object.keys(overrideRules));
     const mergedRules = new Map();
     const allRuleNames = new Set([
@@ -83,32 +92,9 @@ function loadConfig(cwd) {
     for (const name of allRuleNames) {
         mergedRules.set(name, mergeRule(default_rules_1.defaultRules[name], overrideRules[name]));
     }
-    const rulesDir = consumerConfig.rulesDir ?? [];
-    return new types_1.ResolvedConfig(mergedRules, userConfiguredRuleNames, rulesDir, configPath);
-}
-function buildWebpiecesRulesConfig(
-// webpieces-disable no-any-unknown -- JSON values are opaque until assigned to typed fields
-rawRules, rulesDir) {
-    const typed = new WebpiecesRulesConfig_1.WebpiecesRulesConfig();
-    for (const key of Object.keys(rawRules)) {
-        // webpieces-disable no-any-unknown -- dynamic key assignment to typed class
-        typed[key] = rawRules[key];
-    }
-    typed.rulesDir = rulesDir;
-    return typed;
-}
-function loadWebpiecesRulesConfig(cwd) {
-    const configPath = findConfigFile(cwd);
-    if (!configPath)
-        return null;
-    const consumerConfig = readRawConfig(configPath);
-    const overrideRules = consumerConfig.rules || {};
-    const validationErrors = (0, validate_config_1.validateWebpiecesConfig)(overrideRules);
-    if (validationErrors.length > 0) {
-        throw new inform_ai_error_1.InformAiError(`webpieces.config.json has ${validationErrors.length} validation error(s) — fix ALL, then retry:\n\n` +
-            validationErrors.map(e => `  • ${e}`).join('\n'));
-    }
-    const rulesDir = consumerConfig.rulesDir ?? [];
-    return { config: buildWebpiecesRulesConfig(overrideRules, rulesDir), configPath };
+    const resolved = new types_1.ResolvedConfig(mergedRules, userConfiguredRuleNames, rulesDir, configPath);
+    const rulesConfig = buildWebpiecesRulesConfig(overrideRules, rulesDir);
+    const prGate = (0, pr_gate_config_1.buildPrGateConfig)(consumerConfig['pr-gate']);
+    return new LoadedConfig(resolved, rulesConfig, prGate, configPath);
 }
 //# sourceMappingURL=load-config.js.map

package/src/load-config.js.map

@@ -1 +1 @@
-{"version":3,"file":"load-config.js","sourceRoot":"","sources":["../../../../../packages/tooling/rules-config/src/load-config.ts"],"names":[],"mappings":"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","sourcesContent":["import * as fs from 'fs';\nimport * as path from 'path';\n\nimport { defaultRules } from './default-rules';\nimport { InformAiError } from './inform-ai-error';\nimport { toError } from './to-error';\nimport { ResolvedConfig, ResolvedRuleConfig, RuleOptions } from './types';\nimport { validateWebpiecesConfig } from './validate-config';\nimport { WebpiecesRulesConfig } from './WebpiecesRulesConfig';\n\nexport const CONFIG_FILENAME = 'webpieces.config.json';\n\n// webpieces-disable no-any-unknown -- consumer JSON config has opaque rule option values\ninterface RawConfigFile {\n    extends?: string;\n    rules?: Record<string, Record<string, unknown>>;\n    rulesDir?: string[];\n}\n\n/**\n * Walk up from `startDir` looking for webpieces.config.json.\n */\nexport function findConfigFile(startDir: string): string | null {\n    let dir = startDir;\n    while (true) {\n        const primary = path.join(dir, CONFIG_FILENAME);\n        if (fs.existsSync(primary)) return primary;\n        const parent = path.dirname(dir);\n        if (parent === dir) return null;\n        dir = parent;\n    }\n}\n\n// webpieces-disable no-any-unknown -- merging opaque option bags from config JSON\nfunction mergeRule(\n    // webpieces-disable no-any-unknown -- opaque option bag\n    baseRule: Record<string, unknown> | undefined,\n    // webpieces-disable no-any-unknown -- opaque option bag\n    overrideRule: Record<string, unknown> | undefined,\n): ResolvedRuleConfig {\n    if (!baseRule && !overrideRule) return new ResolvedRuleConfig({ mode: 'OFF' });\n    if (!baseRule) return new ResolvedRuleConfig(overrideRule! as RuleOptions);\n    if (!overrideRule) return new ResolvedRuleConfig(baseRule as RuleOptions);\n\n    // webpieces-disable no-any-unknown -- building merged option bag\n    const merged: Record<string, unknown> = {};\n    for (const key of Object.keys(baseRule)) merged[key] = baseRule[key];\n    for (const key of Object.keys(overrideRule)) merged[key] = overrideRule[key];\n    return new ResolvedRuleConfig(merged as RuleOptions);\n}\n\nfunction readRawConfig(configPath: string): RawConfigFile {\n    const raw = fs.readFileSync(configPath, 'utf8');\n    // eslint-disable-next-line @webpieces/no-unmanaged-exceptions\n    try {\n        return JSON.parse(raw) as RawConfigFile;\n    } catch (err: unknown) {\n        const error = toError(err);\n        throw new InformAiError(\n            `webpieces.config.json has invalid JSON — fix the file, then retry.\\n` +\n            `Parse error: ${error.message}\\n` +\n            `File: ${configPath}`,\n        );\n    }\n}\n\nexport function loadConfig(cwd: string): ResolvedConfig {\n    const configPath = findConfigFile(cwd);\n\n    if (!configPath) {\n        return new ResolvedConfig(new Map(), new Set(), [], null);\n    }\n\n    const consumerConfig = readRawConfig(configPath);\n    const overrideRules = consumerConfig.rules || {};\n\n    const validationErrors = validateWebpiecesConfig(overrideRules);\n    if (validationErrors.length > 0) {\n        throw new InformAiError(\n            `webpieces.config.json has ${validationErrors.length} validation error(s) — fix ALL, then retry:\\n\\n` +\n            validationErrors.map(e => `  • ${e}`).join('\\n'),\n        );\n    }\n\n    const userConfiguredRuleNames = new Set(Object.keys(overrideRules));\n    const mergedRules = new Map<string, ResolvedRuleConfig>();\n\n    const allRuleNames = new Set([\n        ...Object.keys(defaultRules),\n        ...Object.keys(overrideRules),\n    ]);\n    for (const name of allRuleNames) {\n        mergedRules.set(name, mergeRule(defaultRules[name], overrideRules[name]));\n    }\n\n    const rulesDir = consumerConfig.rulesDir ?? [];\n\n    return new ResolvedConfig(mergedRules, userConfiguredRuleNames, rulesDir, configPath);\n}\n\nexport interface LoadedWebpiecesConfig {\n    readonly config: WebpiecesRulesConfig;\n    readonly configPath: string;\n}\n\nfunction buildWebpiecesRulesConfig(\n    // webpieces-disable no-any-unknown -- JSON values are opaque until assigned to typed fields\n    rawRules: Record<string, Record<string, unknown>>,\n    rulesDir: string[],\n): WebpiecesRulesConfig {\n    const typed = new WebpiecesRulesConfig();\n    for (const key of Object.keys(rawRules)) {\n        // webpieces-disable no-any-unknown -- dynamic key assignment to typed class\n        (typed as Record<string, unknown>)[key] = rawRules[key];\n    }\n    typed.rulesDir = rulesDir;\n    return typed;\n}\n\nexport function loadWebpiecesRulesConfig(cwd: string): LoadedWebpiecesConfig | null {\n    const configPath = findConfigFile(cwd);\n    if (!configPath) return null;\n\n    const consumerConfig = readRawConfig(configPath);\n    const overrideRules = consumerConfig.rules || {};\n\n    const validationErrors = validateWebpiecesConfig(overrideRules);\n    if (validationErrors.length > 0) {\n        throw new InformAiError(\n            `webpieces.config.json has ${validationErrors.length} validation error(s) — fix ALL, then retry:\\n\\n` +\n            validationErrors.map(e => `  • ${e}`).join('\\n'),\n        );\n    }\n\n    const rulesDir = consumerConfig.rulesDir ?? [];\n    return { config: buildWebpiecesRulesConfig(overrideRules, rulesDir), configPath };\n}\n"]}
+{"version":3,"file":"load-config.js","sourceRoot":"","sources":["../../../../../packages/tooling/rules-config/src/load-config.ts"],"names":[],"mappings":"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","sourcesContent":["import { findConfigFile, readRawConfig } from './config-file';\nimport { defaultRules } from './default-rules';\nimport { InformAiError } from './inform-ai-error';\nimport { buildPrGateConfig, PrGateConfig } from './pr-gate-config';\nimport { ResolvedConfig, ResolvedRuleConfig, RuleOptions } from './types';\nimport { validatePrGateSection, validateWebpiecesConfig } from './validate-config';\nimport { WebpiecesRulesConfig } from './WebpiecesRulesConfig';\n\n// webpieces-disable no-any-unknown -- merging opaque option bags from config JSON\nfunction mergeRule(\n    // webpieces-disable no-any-unknown -- opaque option bag\n    baseRule: Record<string, unknown> | undefined,\n    // webpieces-disable no-any-unknown -- opaque option bag\n    overrideRule: Record<string, unknown> | undefined,\n): ResolvedRuleConfig {\n    if (!baseRule && !overrideRule) return new ResolvedRuleConfig({ mode: 'OFF' });\n    if (!baseRule) return new ResolvedRuleConfig(overrideRule! as RuleOptions);\n    if (!overrideRule) return new ResolvedRuleConfig(baseRule as RuleOptions);\n\n    // webpieces-disable no-any-unknown -- building merged option bag\n    const merged: Record<string, unknown> = {};\n    for (const key of Object.keys(baseRule)) merged[key] = baseRule[key];\n    for (const key of Object.keys(overrideRule)) merged[key] = overrideRule[key];\n    return new ResolvedRuleConfig(merged as RuleOptions);\n}\n\nfunction buildWebpiecesRulesConfig(\n    // webpieces-disable no-any-unknown -- JSON values are opaque until assigned to typed fields\n    rawRules: Record<string, Record<string, unknown>>,\n    rulesDir: string[],\n): WebpiecesRulesConfig {\n    const typed = new WebpiecesRulesConfig();\n    for (const key of Object.keys(rawRules)) {\n        // webpieces-disable no-any-unknown -- dynamic key assignment to typed class\n        (typed as Record<string, unknown>)[key] = rawRules[key];\n    }\n    typed.rulesDir = rulesDir;\n    return typed;\n}\n\n/**\n * Everything a consumer might need from webpieces.config.json, produced from ONE parse + ONE\n * validation pass. Data-only (per CLAUDE.md, classes for data):\n *  - `resolved`    — Map-based view merged with defaultRules (nx executors).\n *  - `rulesConfig` — typed WebpiecesRulesConfig (ai-hook-rules, code-rules).\n *  - `prGate`      — the pr-gate section (pr-gate scripts).\n *  - `configPath`  — absolute path, or null when no config file was found.\n */\nexport class LoadedConfig {\n    constructor(\n        readonly resolved: ResolvedConfig,\n        readonly rulesConfig: WebpiecesRulesConfig,\n        readonly prGate: PrGateConfig,\n        readonly configPath: string | null,\n    ) {}\n}\n\n/**\n * The single load+validate entry point for ALL consumers (ai-hook-rules, code-rules,\n * nx-webpieces-rules, pr-gate scripts). Reads webpieces.config.json once, validates BOTH the `rules`\n * map and the top-level `pr-gate` block, and throws one InformAiError listing every error. When no\n * config file is found it returns lenient empties/defaults (matching prior no-file behavior).\n */\nexport function loadAndValidate(cwd: string): LoadedConfig {\n    const configPath = findConfigFile(cwd);\n    if (!configPath) {\n        return new LoadedConfig(\n            new ResolvedConfig(new Map(), new Set(), [], null),\n            new WebpiecesRulesConfig(),\n            buildPrGateConfig(undefined),\n            null,\n        );\n    }\n\n    const consumerConfig = readRawConfig(configPath);\n    const overrideRules = consumerConfig.rules || {};\n\n    const errors = [\n        ...validateWebpiecesConfig(overrideRules),\n        ...validatePrGateSection(consumerConfig['pr-gate']),\n    ];\n    if (errors.length > 0) {\n        throw new InformAiError(\n            `webpieces.config.json has ${errors.length} validation error(s) — fix ALL, then retry:\\n\\n` +\n            errors.map(e => `  • ${e}`).join('\\n'),\n        );\n    }\n\n    const rulesDir = consumerConfig.rulesDir ?? [];\n\n    const userConfiguredRuleNames = new Set(Object.keys(overrideRules));\n    const mergedRules = new Map<string, ResolvedRuleConfig>();\n    const allRuleNames = new Set([\n        ...Object.keys(defaultRules),\n        ...Object.keys(overrideRules),\n    ]);\n    for (const name of allRuleNames) {\n        mergedRules.set(name, mergeRule(defaultRules[name], overrideRules[name]));\n    }\n    const resolved = new ResolvedConfig(mergedRules, userConfiguredRuleNames, rulesDir, configPath);\n\n    const rulesConfig = buildWebpiecesRulesConfig(overrideRules, rulesDir);\n    const prGate = buildPrGateConfig(consumerConfig['pr-gate']);\n\n    return new LoadedConfig(resolved, rulesConfig, prGate, configPath);\n}\n"]}

package/src/pr-gate-config.d.ts

@@ -1,8 +1,9 @@
 export declare class GateDefinition {
     name: string;
     patterns: string[];
-    severity: string;
-    constructor(name: string, patterns: string[], severity: string);
+    color: string;
+    disabled: boolean;
+    constructor(name: string, patterns: string[], color: string, disabled?: boolean);
 }
 export declare class PrGateConfig {
     mode: string;
@@ -13,7 +14,9 @@ export declare class PrGateConfig {
 export declare function defaultGates(): GateDefinition[];
 export declare function defaultPrGateConfig(): PrGateConfig;
 /**
- * Load the `pr-gate` section from webpieces.config.json, falling back to defaults for any
- * field the consumer omits. Returns defaults entirely if no config file is found.
+ * Build a PrGateConfig from the already-parsed top-level `pr-gate` section, falling back to defaults
+ * for any field the consumer omits. Pure transform — the file read + structural validation happen in
+ * loadAndValidate (load-config.ts) so every consumer goes through one validated path. Pass undefined
+ * (no `pr-gate` key / no config file) to get full defaults.
  */
-export declare function loadPrGateConfig(cwd: string): PrGateConfig;
+export declare function buildPrGateConfig(section: unknown): PrGateConfig;

package/src/pr-gate-config.js

@@ -1,23 +1,29 @@
 "use strict";
+// PrGateConfig is the "special section" for the pr-gate dashboard. It does NOT live in the
+// validated `rules` map (the FieldDef schema can't express nested object arrays), but as a
+// top-level `pr-gate` key in webpieces.config.json. It is built and validated by
+// loadAndValidate (load-config.ts); this module holds only the data classes + defaults + toGate.
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.PrGateConfig = exports.GateDefinition = void 0;
 exports.defaultGates = defaultGates;
 exports.defaultPrGateConfig = defaultPrGateConfig;
-exports.loadPrGateConfig = loadPrGateConfig;
-const tslib_1 = require("tslib");
-const fs = tslib_1.__importStar(require("fs"));
-const load_config_1 = require("./load-config");
-// PrGateConfig is the "special section" for the pr-gate dashboard. It does NOT live in the
-// validated `rules` map (the FieldDef schema can't express nested object arrays), but as a
-// top-level `pr-gate` key in webpieces.config.json. Loaded by loadPrGateConfig with defaults.
+exports.buildPrGateConfig = buildPrGateConfig;
 class GateDefinition {
     name;
     patterns;
-    severity; // 'warn' (yellow) | 'block' (red, fails the gate)
-    constructor(name, patterns, severity) {
+    // The color shown on the dashboard WHEN this gate's patterns match a changed file. Green is
+    // implicit (shown when nothing matched), so it is never configured. Color is purely visual —
+    // even 'red' never fails/blocks the PR (only the build gate can). 'yellow' = caution,
+    // 'red' = louder "look here" flag (e.g. DB schema / migration changes).
+    color; // 'yellow' | 'red'
+    // Example/inactive gate: parsed and kept in the file (JSON has no comments) but skipped at
+    // compute/render time. Other projects flip this to false and tune patterns/color.
+    disabled;
+    constructor(name, patterns, color, disabled = false) {
         this.name = name;
         this.patterns = patterns;
-        this.severity = severity;
+        this.color = color;
+        this.disabled = disabled;
     }
 }
 exports.GateDefinition = GateDefinition;
@@ -36,34 +42,33 @@ exports.PrGateConfig = PrGateConfig;
 // whole list via the `pr-gate.gates` array in webpieces.config.json.
 function defaultGates() {
     return [
-        new GateDefinition('API Changed', ['libraries/apis/**', '**/*Api.ts'], 'warn'),
-        new GateDefinition('Config Files Changed', ['**/package.json', '**/tsconfig*.json', 'nx.json', '**/*.config.*'], 'warn'),
-        new GateDefinition('Dependency Graph Changed', ['architecture/dependencies.json'], 'warn'),
-        new GateDefinition('Claude / Rules Changed', ['**/CLAUDE.md', '**/claude.*.md', '.claude/**', 'webpieces.config.json'], 'warn'),
+        new GateDefinition('API Changed', ['libraries/apis/**', '**/*Api.ts'], 'yellow'),
+        new GateDefinition('Config Files Changed', ['**/package.json', '**/tsconfig*.json', 'nx.json', '**/*.config.*'], 'yellow'),
+        new GateDefinition('Dependency Graph Changed', ['architecture/dependencies.json'], 'yellow'),
+        new GateDefinition('Claude / Rules Changed', ['**/CLAUDE.md', '**/claude.*.md', '.claude/**', 'webpieces.config.json'], 'yellow'),
     ];
 }
 function defaultPrGateConfig() {
     return new PrGateConfig('ON', '', defaultGates());
 }
 function toGate(raw) {
-    return new GateDefinition(raw.name ?? '', raw.patterns ?? [], raw.severity ?? 'warn');
+    return new GateDefinition(raw.name ?? '', raw.patterns ?? [], raw.color ?? 'yellow', raw.disabled ?? false);
 }
 /**
- * Load the `pr-gate` section from webpieces.config.json, falling back to defaults for any
- * field the consumer omits. Returns defaults entirely if no config file is found.
+ * Build a PrGateConfig from the already-parsed top-level `pr-gate` section, falling back to defaults
+ * for any field the consumer omits. Pure transform — the file read + structural validation happen in
+ * loadAndValidate (load-config.ts) so every consumer goes through one validated path. Pass undefined
+ * (no `pr-gate` key / no config file) to get full defaults.
  */
-function loadPrGateConfig(cwd) {
+// webpieces-disable no-any-unknown -- `section` is opaque consumer JSON until narrowed here
+function buildPrGateConfig(section) {
     const defaults = defaultPrGateConfig();
-    const configPath = (0, load_config_1.findConfigFile)(cwd);
-    if (!configPath)
-        return defaults;
-    const parsed = JSON.parse(fs.readFileSync(configPath, 'utf8'));
-    const section = parsed['pr-gate'];
-    if (!section)
+    if (section === undefined || section === null || typeof section !== 'object')
         return defaults;
-    const mode = section.mode ?? defaults.mode;
-    const buildCommand = section.buildCommand ?? defaults.buildCommand;
-    const gates = section.gates !== undefined ? section.gates.map(toGate) : defaults.gates;
+    const raw = section;
+    const mode = raw.mode ?? defaults.mode;
+    const buildCommand = raw.buildCommand ?? defaults.buildCommand;
+    const gates = raw.gates !== undefined ? raw.gates.map(toGate) : defaults.gates;
     return new PrGateConfig(mode, buildCommand, gates);
 }
 //# sourceMappingURL=pr-gate-config.js.map