@webpieces/rules-config 0.3.355 → 0.3.357

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@webpieces/rules-config",
-  "version": "0.3.355",
+  "version": "0.3.357",
   "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",
@@ -14,6 +14,11 @@
     "README.md"
   ],
   "dependencies": {
+    "@webpieces/core-context": "0.3.357",
+    "@webpieces/core-util": "0.3.357",
+    "@inversifyjs/binding-decorators": "1.1.5",
+    "inversify": "7.10.4",
+    "reflect-metadata": "0.2.2",
     "minimatch": "10.0.1"
   },
   "author": "Dean Hiller",

package/src/config-file.d.ts

@@ -9,6 +9,16 @@ export interface RawConfigFile {
     rulesDir?: string[];
     'pr-gate'?: unknown;
 }
+/**
+ * Locates + reads webpieces.config.json. `@provideSingleton` so it can be injected into the config
+ * loader and appear in the rules-config DI design.
+ */
+export declare class ConfigFile {
+    /** Walk up from `startDir` looking for webpieces.config.json. Returns its absolute path or null. */
+    findConfigFile(startDir: string): string | null;
+    /** Read + JSON.parse webpieces.config.json, surfacing parse failures as a readable InformAiError. */
+    readRawConfig(configPath: string): RawConfigFile;
+}
 /**
  * Walk up from `startDir` looking for webpieces.config.json. Returns its absolute path or null.
  */

package/src/config-file.js

@@ -1,43 +1,67 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.CONFIG_FILENAME = void 0;
+exports.ConfigFile = 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 core_context_1 = require("@webpieces/core-context");
+const inversify_1 = require("inversify");
 const inform_ai_error_1 = require("./inform-ai-error");
 const to_error_1 = require("./to-error");
 exports.CONFIG_FILENAME = 'webpieces.config.json';
+/**
+ * Locates + reads webpieces.config.json. `@provideSingleton` so it can be injected into the config
+ * loader and appear in the rules-config DI design.
+ */
+let ConfigFile = class ConfigFile {
+    /** Walk up from `startDir` looking for webpieces.config.json. Returns its absolute path or null. */
+    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. */
+    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}`);
+        }
+    }
+};
+exports.ConfigFile = ConfigFile;
+exports.ConfigFile = ConfigFile = tslib_1.__decorate([
+    (0, core_context_1.provideSingleton)(),
+    (0, inversify_1.injectable)()
+], ConfigFile);
+// Temporary migration delegators — consumers migrate to injecting ConfigFile over follow-up PRs, then
+// these free functions are removed. Declarations kept identical to the originals (unchanged lines).
+const configFileSvc = new ConfigFile();
 /**
  * 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;
-    }
+    return configFileSvc.findConfigFile(startDir);
 }
 /**
  * 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}`);
-    }
+    return configFileSvc.readRawConfig(configPath);
 }
 //# sourceMappingURL=config-file.js.map

package/src/config-file.js.map

@@ -1 +1 @@
-{"version":3,"file":"config-file.js","sourceRoot":"","sources":["../../../../../packages/tooling/rules-config/src/config-file.ts"],"names":[],"mappings":";;;AAuCA,wCASC;AAKD,sCAaC;;AAlED,+CAAyB;AACzB,mDAA6B;AAE7B,uDAAkD;AAClD,yCAAqC;AAExB,QAAA,eAAe,GAAG,uBAAuB,CAAC;AA8BvD;;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.\n//  - `rules`      — code-style validators (scope edit/file).\n//  - `hookGuards` — git/PR/branch protection guards (scope bash).\n//  - `commands`   — gated command config the guards point at; `pr-gate` lives inside it. Carried as\n//                   opaque JSON because its nested `gates` array can't be expressed in the FieldDef\n//                   schema; validated structurally by validateCommandsSection.\n//  - `pr-gate`    — DEPRECATED top-level block (pre-migration layout). Read only as a back-compat\n//                   fallback / to emit a \"move it under commands\" migration error.\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    hookGuards?: Record<string, Record<string, unknown>>;\n    // webpieces-disable no-any-unknown -- opaque commands JSON, validated by validateCommandsSection\n    commands?: unknown;\n    // REQUIRED top-level block: two glob lists that suppress hook enforcement per file path.\n    // Opaque here (validated structurally by validateExcludePaths, then parsed into ExcludePaths).\n    // webpieces-disable no-any-unknown -- opaque excludePaths JSON, validated by validateExcludePaths\n    excludePaths?: unknown;\n    // REQUIRED top-level array of client-authored content guards (regex patterns + message + scoping).\n    // Opaque here; validated structurally by validateMatchRulesSection, then parsed into MatchRuleConfig[].\n    // webpieces-disable no-any-unknown -- opaque match-rules JSON, validated by validateMatchRulesSection\n    'match-rules'?: unknown;\n    rulesDir?: string[];\n    // webpieces-disable no-any-unknown -- DEPRECATED top-level pr-gate, migrated under `commands`\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"]}
+{"version":3,"file":"config-file.js","sourceRoot":"","sources":["../../../../../packages/tooling/rules-config/src/config-file.ts"],"names":[],"mappings":";;;AAiFA,wCAEC;AAKD,sCAEC;;AA1FD,+CAAyB;AACzB,mDAA6B;AAC7B,0DAA2D;AAC3D,yCAAuC;AAEvC,uDAAkD;AAClD,yCAAqC;AAExB,QAAA,eAAe,GAAG,uBAAuB,CAAC;AA8BvD;;;GAGG;AAGI,IAAM,UAAU,GAAhB,MAAM,UAAU;IACnB,oGAAoG;IACpG,cAAc,CAAC,QAAgB;QAC3B,IAAI,GAAG,GAAG,QAAQ,CAAC;QACnB,OAAO,IAAI,EAAE,CAAC;YACV,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,uBAAe,CAAC,CAAC;YAChD,IAAI,EAAE,CAAC,UAAU,CAAC,OAAO,CAAC;gBAAE,OAAO,OAAO,CAAC;YAC3C,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;YACjC,IAAI,MAAM,KAAK,GAAG;gBAAE,OAAO,IAAI,CAAC;YAChC,GAAG,GAAG,MAAM,CAAC;QACjB,CAAC;IACL,CAAC;IAED,qGAAqG;IACrG,aAAa,CAAC,UAAkB;QAC5B,MAAM,GAAG,GAAG,EAAE,CAAC,YAAY,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;QAChD,8DAA8D;QAC9D,IAAI,CAAC;YACD,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAkB,CAAC;QAC5C,CAAC;QAAC,OAAO,GAAY,EAAE,CAAC;YACpB,MAAM,KAAK,GAAG,IAAA,kBAAO,EAAC,GAAG,CAAC,CAAC;YAC3B,MAAM,IAAI,+BAAa,CACnB,sEAAsE;gBACtE,gBAAgB,KAAK,CAAC,OAAO,IAAI;gBACjC,SAAS,UAAU,EAAE,CACxB,CAAC;QACN,CAAC;IACL,CAAC;CACJ,CAAA;AA5BY,gCAAU;qBAAV,UAAU;IAFtB,IAAA,+BAAgB,GAAE;IAClB,IAAA,sBAAU,GAAE;GACA,UAAU,CA4BtB;AAED,sGAAsG;AACtG,oGAAoG;AACpG,MAAM,aAAa,GAAG,IAAI,UAAU,EAAE,CAAC;AAEvC;;GAEG;AACH,SAAgB,cAAc,CAAC,QAAgB;IAC3C,OAAO,aAAa,CAAC,cAAc,CAAC,QAAQ,CAAC,CAAC;AAClD,CAAC;AAED;;GAEG;AACH,SAAgB,aAAa,CAAC,UAAkB;IAC5C,OAAO,aAAa,CAAC,aAAa,CAAC,UAAU,CAAC,CAAC;AACnD,CAAC","sourcesContent":["import * as fs from 'fs';\nimport * as path from 'path';\nimport { provideSingleton } from '@webpieces/core-context';\nimport { injectable } from 'inversify';\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.\n//  - `rules`      — code-style validators (scope edit/file).\n//  - `hookGuards` — git/PR/branch protection guards (scope bash).\n//  - `commands`   — gated command config the guards point at; `pr-gate` lives inside it. Carried as\n//                   opaque JSON because its nested `gates` array can't be expressed in the FieldDef\n//                   schema; validated structurally by validateCommandsSection.\n//  - `pr-gate`    — DEPRECATED top-level block (pre-migration layout). Read only as a back-compat\n//                   fallback / to emit a \"move it under commands\" migration error.\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    hookGuards?: Record<string, Record<string, unknown>>;\n    // webpieces-disable no-any-unknown -- opaque commands JSON, validated by validateCommandsSection\n    commands?: unknown;\n    // REQUIRED top-level block: two glob lists that suppress hook enforcement per file path.\n    // Opaque here (validated structurally by validateExcludePaths, then parsed into ExcludePaths).\n    // webpieces-disable no-any-unknown -- opaque excludePaths JSON, validated by validateExcludePaths\n    excludePaths?: unknown;\n    // REQUIRED top-level array of client-authored content guards (regex patterns + message + scoping).\n    // Opaque here; validated structurally by validateMatchRulesSection, then parsed into MatchRuleConfig[].\n    // webpieces-disable no-any-unknown -- opaque match-rules JSON, validated by validateMatchRulesSection\n    'match-rules'?: unknown;\n    rulesDir?: string[];\n    // webpieces-disable no-any-unknown -- DEPRECATED top-level pr-gate, migrated under `commands`\n    'pr-gate'?: unknown;\n}\n\n/**\n * Locates + reads webpieces.config.json. `@provideSingleton` so it can be injected into the config\n * loader and appear in the rules-config DI design.\n */\n@provideSingleton()\n@injectable()\nexport class ConfigFile {\n    /** Walk up from `startDir` looking for webpieces.config.json. Returns its absolute path or null. */\n    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    /** Read + JSON.parse webpieces.config.json, surfacing parse failures as a readable InformAiError. */\n    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}\n\n// Temporary migration delegators — consumers migrate to injecting ConfigFile over follow-up PRs, then\n// these free functions are removed. Declarations kept identical to the originals (unchanged lines).\nconst configFileSvc = new ConfigFile();\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    return configFileSvc.findConfigFile(startDir);\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    return configFileSvc.readRawConfig(configPath);\n}\n"]}

package/src/index.d.ts

@@ -4,13 +4,14 @@ export { RuleFailError } from './rule-fail-error';
 export { CliExitError } from './cli-exit-error';
 export { runMain } from './run-main';
 export { toError } from './to-error';
-export { loadAndValidate, LoadedConfig } from './load-config';
-export { findConfigFile, CONFIG_FILENAME } from './config-file';
+export { loadAndValidate, LoadedConfig, ConfigLoader } from './load-config';
+export { findConfigFile, CONFIG_FILENAME, ConfigFile } from './config-file';
 export { RepoRootFinder, INSTRUCT_AI_DIR } from './repo-root';
+export { RulesConfigDesign } from './rules-config-design';
 export { ExcludePaths } from './exclude-hook-paths';
 export { isPathExcluded } from './exclude-paths';
 export { defaultRules, defaultRulesDir } from './default-rules';
-export { loadTemplate, writeTemplateIfMissing, writeTemplate } from './load-template';
+export { loadTemplate, writeTemplateIfMissing, writeTemplate, TemplateWriter } from './load-template';
 export { validateWebpiecesConfig, validatePrGateSection, validateSectionPlacement, validateCommandsSection, validateExcludePaths, validateMatchRulesSection, allRuleNames } from './validate-config';
 export { MatchRuleConfig, MatchRuleViolation, findMatchRuleViolations, isMatchRuleAllowedPath, compileMatchRulePatterns, renderMatchRuleMessage, DEFAULT_MATCH_RULES, } from './match-rules-config';
 export type { ConfigSection } from './sections';

package/src/index.js

@@ -1,8 +1,8 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.WEBPIECES_DISABLE = exports.AbstractRule = exports.isNewOrModified = exports.hasChangesInRange = exports.findNewMethodSignaturesInDiff = exports.getChangedLineNumbers = exports.getFileDiff = exports.getChangedFiles = exports.resolveBase = exports.detectBase = exports.getCurrentBranch = exports.shouldSkipRule = exports.FieldDef = exports.sectionForRule = exports.isHookGuard = exports.HOOK_GUARD_NAMES = exports.DEFAULT_MATCH_RULES = exports.renderMatchRuleMessage = exports.compileMatchRulePatterns = exports.isMatchRuleAllowedPath = exports.findMatchRuleViolations = exports.MatchRuleViolation = exports.MatchRuleConfig = exports.allRuleNames = exports.validateMatchRulesSection = exports.validateExcludePaths = exports.validateCommandsSection = exports.validateSectionPlacement = exports.validatePrGateSection = exports.validateWebpiecesConfig = exports.writeTemplate = exports.writeTemplateIfMissing = exports.loadTemplate = exports.defaultRulesDir = exports.defaultRules = exports.isPathExcluded = exports.ExcludePaths = exports.INSTRUCT_AI_DIR = exports.RepoRootFinder = exports.CONFIG_FILENAME = exports.findConfigFile = exports.LoadedConfig = exports.loadAndValidate = exports.toError = exports.runMain = exports.CliExitError = exports.RuleFailError = exports.InformAiError = exports.ResolvedRuleConfig = exports.ResolvedConfig = void 0;
-exports.THROW_CAUSE_MODES = exports.DIRECT_API_RESOLVER_MODES = exports.PRISMA_CONVERTER_MODES = exports.PRISMA_DTOS_MODES = exports.PROJECT_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.DiGraphConfig = exports.NxWiringConfig = exports.RuntimeArchitectureConfig = exports.NoFileImportCyclesConfig = exports.FeatureBranchGuardConfig = exports.RedirectHowToMergeMainConfig = exports.PrMergeGuardConfig = exports.MergeInProgressGuardConfig = exports.PrCreationOrPushGuardConfig = exports.BranchCreationGuardConfig = exports.RoleTagConfig = exports.FrameworkTagConfig = exports.InjectAnnotationNotNeededForConcreteClassConfig = exports.NoFunctionOutsideClassConfig = exports.NoProcessExitOutsideMainConfig = 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.PR_REVIEW_DIR = exports.MERGE_INFO_DIR = exports.WEBPIECES_TMP_DIR = exports.hasDisable = exports.RULE_NAMES = void 0;
-exports.DEFAULT_MERGE_COMPLETE_COMMAND = exports.DEFAULT_UPSERT_PR_COMMAND = exports.buildCommandsConfig = exports.CommandsConfig = exports.logBranchMutation = exports.branchMutationLogPath = exports.BranchMutationEvent = exports.squashRecoverySteps = exports.stampCleanMainSyncStatus = exports.computeMainSyncStatus = exports.finishedLock = exports.inProcessLock = exports.isRefreshInProgress = exports.isLockStale = exports.writeMainSyncLock = exports.readMainSyncLock = exports.writeMainSyncStatus = exports.readMainSyncStatus = exports.mainSyncLockPath = exports.mainSyncStatusPath = exports.DEFAULT_HANG_TIMEOUT_MINUTES = exports.MainSyncLock = exports.MainSyncStatus = exports.reviewJsonSchemaHint = exports.reviewJsonPath = exports.prDirFor = exports.loadReviewJson = exports.ReviewJson = exports.buildPrGateConfig = exports.defaultPrGateConfig = exports.defaultGates = exports.PrGateConfig = exports.GateDefinition = exports.VALIDATE_TS_MODES = exports.STRUCTURAL_MODES = exports.ON_OFF_MODES = void 0;
+exports.findNewMethodSignaturesInDiff = exports.getChangedLineNumbers = exports.getFileDiff = exports.getChangedFiles = exports.resolveBase = exports.detectBase = exports.getCurrentBranch = exports.shouldSkipRule = exports.FieldDef = exports.sectionForRule = exports.isHookGuard = exports.HOOK_GUARD_NAMES = exports.DEFAULT_MATCH_RULES = exports.renderMatchRuleMessage = exports.compileMatchRulePatterns = exports.isMatchRuleAllowedPath = exports.findMatchRuleViolations = exports.MatchRuleViolation = exports.MatchRuleConfig = exports.allRuleNames = exports.validateMatchRulesSection = exports.validateExcludePaths = exports.validateCommandsSection = exports.validateSectionPlacement = exports.validatePrGateSection = exports.validateWebpiecesConfig = exports.TemplateWriter = exports.writeTemplate = exports.writeTemplateIfMissing = exports.loadTemplate = exports.defaultRulesDir = exports.defaultRules = exports.isPathExcluded = exports.ExcludePaths = exports.RulesConfigDesign = exports.INSTRUCT_AI_DIR = exports.RepoRootFinder = exports.ConfigFile = exports.CONFIG_FILENAME = exports.findConfigFile = exports.ConfigLoader = exports.LoadedConfig = exports.loadAndValidate = exports.toError = exports.runMain = exports.CliExitError = exports.RuleFailError = exports.InformAiError = exports.ResolvedRuleConfig = exports.ResolvedConfig = void 0;
+exports.PROJECT_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.DiGraphConfig = exports.NxWiringConfig = exports.RuntimeArchitectureConfig = exports.NoFileImportCyclesConfig = exports.FeatureBranchGuardConfig = exports.RedirectHowToMergeMainConfig = exports.PrMergeGuardConfig = exports.MergeInProgressGuardConfig = exports.PrCreationOrPushGuardConfig = exports.BranchCreationGuardConfig = exports.RoleTagConfig = exports.FrameworkTagConfig = exports.InjectAnnotationNotNeededForConcreteClassConfig = exports.NoFunctionOutsideClassConfig = exports.NoProcessExitOutsideMainConfig = 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.PR_REVIEW_DIR = exports.MERGE_INFO_DIR = exports.WEBPIECES_TMP_DIR = exports.hasDisable = exports.RULE_NAMES = exports.WEBPIECES_DISABLE = exports.AbstractRule = exports.isNewOrModified = exports.hasChangesInRange = void 0;
+exports.DEFAULT_MERGE_COMPLETE_COMMAND = exports.DEFAULT_UPSERT_PR_COMMAND = exports.buildCommandsConfig = exports.CommandsConfig = exports.logBranchMutation = exports.branchMutationLogPath = exports.BranchMutationEvent = exports.squashRecoverySteps = exports.stampCleanMainSyncStatus = exports.computeMainSyncStatus = exports.finishedLock = exports.inProcessLock = exports.isRefreshInProgress = exports.isLockStale = exports.writeMainSyncLock = exports.readMainSyncLock = exports.writeMainSyncStatus = exports.readMainSyncStatus = exports.mainSyncLockPath = exports.mainSyncStatusPath = exports.DEFAULT_HANG_TIMEOUT_MINUTES = exports.MainSyncLock = exports.MainSyncStatus = exports.reviewJsonSchemaHint = exports.reviewJsonPath = exports.prDirFor = exports.loadReviewJson = exports.ReviewJson = exports.buildPrGateConfig = exports.defaultPrGateConfig = exports.defaultGates = exports.PrGateConfig = exports.GateDefinition = exports.VALIDATE_TS_MODES = exports.STRUCTURAL_MODES = exports.ON_OFF_MODES = exports.THROW_CAUSE_MODES = exports.DIRECT_API_RESOLVER_MODES = exports.PRISMA_CONVERTER_MODES = exports.PRISMA_DTOS_MODES = 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; } });
@@ -19,12 +19,16 @@ Object.defineProperty(exports, "toError", { enumerable: true, get: function () {
 var load_config_1 = require("./load-config");
 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; } });
+Object.defineProperty(exports, "ConfigLoader", { enumerable: true, get: function () { return load_config_1.ConfigLoader; } });
 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; } });
+Object.defineProperty(exports, "ConfigFile", { enumerable: true, get: function () { return config_file_1.ConfigFile; } });
 var repo_root_1 = require("./repo-root");
 Object.defineProperty(exports, "RepoRootFinder", { enumerable: true, get: function () { return repo_root_1.RepoRootFinder; } });
 Object.defineProperty(exports, "INSTRUCT_AI_DIR", { enumerable: true, get: function () { return repo_root_1.INSTRUCT_AI_DIR; } });
+var rules_config_design_1 = require("./rules-config-design");
+Object.defineProperty(exports, "RulesConfigDesign", { enumerable: true, get: function () { return rules_config_design_1.RulesConfigDesign; } });
 var exclude_hook_paths_1 = require("./exclude-hook-paths");
 Object.defineProperty(exports, "ExcludePaths", { enumerable: true, get: function () { return exclude_hook_paths_1.ExcludePaths; } });
 var exclude_paths_1 = require("./exclude-paths");
@@ -36,6 +40,7 @@ var load_template_1 = require("./load-template");
 Object.defineProperty(exports, "loadTemplate", { enumerable: true, get: function () { return load_template_1.loadTemplate; } });
 Object.defineProperty(exports, "writeTemplateIfMissing", { enumerable: true, get: function () { return load_template_1.writeTemplateIfMissing; } });
 Object.defineProperty(exports, "writeTemplate", { enumerable: true, get: function () { return load_template_1.writeTemplate; } });
+Object.defineProperty(exports, "TemplateWriter", { enumerable: true, get: function () { return load_template_1.TemplateWriter; } });
 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; } });

package/src/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../packages/tooling/rules-config/src/index.ts"],"names":[],"mappings":"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","sourcesContent":["export { ResolvedConfig, ResolvedRuleConfig, RuleOptions } from './types';\nexport { InformAiError } from './inform-ai-error';\nexport { RuleFailError } from './rule-fail-error';\nexport { CliExitError } from './cli-exit-error';\nexport { runMain } from './run-main';\nexport { toError } from './to-error';\nexport { loadAndValidate, LoadedConfig } from './load-config';\nexport { findConfigFile, CONFIG_FILENAME } from './config-file';\nexport { RepoRootFinder, INSTRUCT_AI_DIR } from './repo-root';\nexport { ExcludePaths } from './exclude-hook-paths';\nexport { isPathExcluded } from './exclude-paths';\nexport { defaultRules, defaultRulesDir } from './default-rules';\nexport { loadTemplate, writeTemplateIfMissing, writeTemplate } from './load-template';\nexport { validateWebpiecesConfig, validatePrGateSection, validateSectionPlacement, validateCommandsSection, validateExcludePaths, validateMatchRulesSection, allRuleNames } from './validate-config';\nexport {\n    MatchRuleConfig,\n    MatchRuleViolation,\n    findMatchRuleViolations,\n    isMatchRuleAllowedPath,\n    compileMatchRulePatterns,\n    renderMatchRuleMessage,\n    DEFAULT_MATCH_RULES,\n} from './match-rules-config';\nexport type { ConfigSection } from './sections';\nexport { HOOK_GUARD_NAMES, isHookGuard, sectionForRule } from './sections';\nexport { FieldDef } from './field-def';\nexport type { SchemaShape } from './field-def';\nexport { shouldSkipRule, getCurrentBranch } from './skip-rule';\nexport type { SkipRuleResult } from './skip-rule';\nexport {\n    detectBase,\n    resolveBase,\n    getChangedFiles,\n    getFileDiff,\n    getChangedLineNumbers,\n    findNewMethodSignaturesInDiff,\n    hasChangesInRange,\n    isNewOrModified,\n} from './diff-scope';\nexport { AbstractRule } from './abstract-rule';\nexport {\n    WEBPIECES_DISABLE,\n    RULE_NAMES,\n    hasDisable,\n    WEBPIECES_TMP_DIR,\n    MERGE_INFO_DIR,\n    PR_REVIEW_DIR,\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    NoProcessExitOutsideMainConfig,\n    NoFunctionOutsideClassConfig,\n    InjectAnnotationNotNeededForConcreteClassConfig,\n    FrameworkTagConfig,\n    RoleTagConfig,\n    BranchCreationGuardConfig,\n    PrCreationOrPushGuardConfig,\n    MergeInProgressGuardConfig,\n    PrMergeGuardConfig,\n    RedirectHowToMergeMainConfig,\n    FeatureBranchGuardConfig,\n    NoFileImportCyclesConfig,\n    RuntimeArchitectureConfig,\n    NxWiringConfig,\n    DiGraphConfig,\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    PROJECT_MODES,\n    PRISMA_DTOS_MODES,\n    PRISMA_CONVERTER_MODES,\n    DIRECT_API_RESOLVER_MODES,\n    THROW_CAUSE_MODES,\n    ON_OFF_MODES,\n    STRUCTURAL_MODES,\n    VALIDATE_TS_MODES,\n} from './rule-configs';\nexport type {\n    MethodLimitMode,\n    FileLimitMode,\n    ReturnTypeMode,\n    InlineTypeMode,\n    ModifiedCodeMode,\n    ProjectMode,\n    PrismaValidateDtosMode,\n    PrismaConverterMode,\n    DirectApiResolverMode,\n    ThrowCauseMode,\n    OnOffMode,\n    StructuralMode,\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    prDirFor,\n    reviewJsonPath,\n    reviewJsonSchemaHint,\n} from './review-json';\nexport {\n    MainSyncStatus,\n    MainSyncLock,\n    DEFAULT_HANG_TIMEOUT_MINUTES,\n    mainSyncStatusPath,\n    mainSyncLockPath,\n    readMainSyncStatus,\n    writeMainSyncStatus,\n    readMainSyncLock,\n    writeMainSyncLock,\n    isLockStale,\n    isRefreshInProgress,\n    inProcessLock,\n    finishedLock,\n    computeMainSyncStatus,\n    stampCleanMainSyncStatus,\n    squashRecoverySteps,\n} from './main-sync-status';\nexport type { MutationVerb, MutationPhase } from './branch-mutation-log';\nexport {\n    BranchMutationEvent,\n    branchMutationLogPath,\n    logBranchMutation,\n} from './branch-mutation-log';\nexport {\n    CommandsConfig,\n    buildCommandsConfig,\n    DEFAULT_UPSERT_PR_COMMAND,\n    DEFAULT_MERGE_COMPLETE_COMMAND,\n} from './commands-config';\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../packages/tooling/rules-config/src/index.ts"],"names":[],"mappings":"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","sourcesContent":["export { ResolvedConfig, ResolvedRuleConfig, RuleOptions } from './types';\nexport { InformAiError } from './inform-ai-error';\nexport { RuleFailError } from './rule-fail-error';\nexport { CliExitError } from './cli-exit-error';\nexport { runMain } from './run-main';\nexport { toError } from './to-error';\nexport { loadAndValidate, LoadedConfig, ConfigLoader } from './load-config';\nexport { findConfigFile, CONFIG_FILENAME, ConfigFile } from './config-file';\nexport { RepoRootFinder, INSTRUCT_AI_DIR } from './repo-root';\nexport { RulesConfigDesign } from './rules-config-design';\nexport { ExcludePaths } from './exclude-hook-paths';\nexport { isPathExcluded } from './exclude-paths';\nexport { defaultRules, defaultRulesDir } from './default-rules';\nexport { loadTemplate, writeTemplateIfMissing, writeTemplate, TemplateWriter } from './load-template';\nexport { validateWebpiecesConfig, validatePrGateSection, validateSectionPlacement, validateCommandsSection, validateExcludePaths, validateMatchRulesSection, allRuleNames } from './validate-config';\nexport {\n    MatchRuleConfig,\n    MatchRuleViolation,\n    findMatchRuleViolations,\n    isMatchRuleAllowedPath,\n    compileMatchRulePatterns,\n    renderMatchRuleMessage,\n    DEFAULT_MATCH_RULES,\n} from './match-rules-config';\nexport type { ConfigSection } from './sections';\nexport { HOOK_GUARD_NAMES, isHookGuard, sectionForRule } from './sections';\nexport { FieldDef } from './field-def';\nexport type { SchemaShape } from './field-def';\nexport { shouldSkipRule, getCurrentBranch } from './skip-rule';\nexport type { SkipRuleResult } from './skip-rule';\nexport {\n    detectBase,\n    resolveBase,\n    getChangedFiles,\n    getFileDiff,\n    getChangedLineNumbers,\n    findNewMethodSignaturesInDiff,\n    hasChangesInRange,\n    isNewOrModified,\n} from './diff-scope';\nexport { AbstractRule } from './abstract-rule';\nexport {\n    WEBPIECES_DISABLE,\n    RULE_NAMES,\n    hasDisable,\n    WEBPIECES_TMP_DIR,\n    MERGE_INFO_DIR,\n    PR_REVIEW_DIR,\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    NoProcessExitOutsideMainConfig,\n    NoFunctionOutsideClassConfig,\n    InjectAnnotationNotNeededForConcreteClassConfig,\n    FrameworkTagConfig,\n    RoleTagConfig,\n    BranchCreationGuardConfig,\n    PrCreationOrPushGuardConfig,\n    MergeInProgressGuardConfig,\n    PrMergeGuardConfig,\n    RedirectHowToMergeMainConfig,\n    FeatureBranchGuardConfig,\n    NoFileImportCyclesConfig,\n    RuntimeArchitectureConfig,\n    NxWiringConfig,\n    DiGraphConfig,\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    PROJECT_MODES,\n    PRISMA_DTOS_MODES,\n    PRISMA_CONVERTER_MODES,\n    DIRECT_API_RESOLVER_MODES,\n    THROW_CAUSE_MODES,\n    ON_OFF_MODES,\n    STRUCTURAL_MODES,\n    VALIDATE_TS_MODES,\n} from './rule-configs';\nexport type {\n    MethodLimitMode,\n    FileLimitMode,\n    ReturnTypeMode,\n    InlineTypeMode,\n    ModifiedCodeMode,\n    ProjectMode,\n    PrismaValidateDtosMode,\n    PrismaConverterMode,\n    DirectApiResolverMode,\n    ThrowCauseMode,\n    OnOffMode,\n    StructuralMode,\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    prDirFor,\n    reviewJsonPath,\n    reviewJsonSchemaHint,\n} from './review-json';\nexport {\n    MainSyncStatus,\n    MainSyncLock,\n    DEFAULT_HANG_TIMEOUT_MINUTES,\n    mainSyncStatusPath,\n    mainSyncLockPath,\n    readMainSyncStatus,\n    writeMainSyncStatus,\n    readMainSyncLock,\n    writeMainSyncLock,\n    isLockStale,\n    isRefreshInProgress,\n    inProcessLock,\n    finishedLock,\n    computeMainSyncStatus,\n    stampCleanMainSyncStatus,\n    squashRecoverySteps,\n} from './main-sync-status';\nexport type { MutationVerb, MutationPhase } from './branch-mutation-log';\nexport {\n    BranchMutationEvent,\n    branchMutationLogPath,\n    logBranchMutation,\n} from './branch-mutation-log';\nexport {\n    CommandsConfig,\n    buildCommandsConfig,\n    DEFAULT_UPSERT_PR_COMMAND,\n    DEFAULT_MERGE_COMPLETE_COMMAND,\n} from './commands-config';\n"]}

package/src/load-config.d.ts

@@ -1,4 +1,5 @@
 import { CommandsConfig } from './commands-config';
+import { ConfigFile } from './config-file';
 import { ExcludePaths } from './exclude-hook-paths';
 import { PrGateConfig } from './pr-gate-config';
 import { ResolvedConfig } from './types';
@@ -6,14 +7,7 @@ import { MatchRuleConfig } from './match-rules-config';
 import { WebpiecesRulesConfig } from './WebpiecesRulesConfig';
 /**
  * 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); rules + hookGuards merged.
- *  - `commands`    — the `commands` section (gated commands + pr-gate).
- *  - `prGate`      — convenience alias of `commands.prGate` (pr-gate scripts).
- *  - `excludePaths`— the required `excludePaths` block (per-category glob suppression lists).
- *  - `matchRules`  — the required `match-rules` array (client-authored content guards).
- *  - `configPath`  — absolute path, or null when no config file was found.
+ * validation pass. Data-only (per CLAUDE.md, classes for data).
  */
 export declare class LoadedConfig {
     readonly resolved: ResolvedConfig;
@@ -27,8 +21,24 @@ export declare class 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).
+ * nx-webpieces-rules, pr-gate scripts). `@provideSingleton` + injects {@link ConfigFile} so it appears
+ * in the rules-config DI design.
  */
+export declare class ConfigLoader {
+    private readonly configFile;
+    constructor(configFile: ConfigFile);
+    /**
+     * 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).
+     */
+    loadAndValidate(cwd: string): LoadedConfig;
+    private applyCommandDefaults;
+    private mergeRule;
+    private parseExcludePaths;
+    private parseMatchRules;
+    private buildWebpiecesRulesConfig;
+    private normalizeDeprecatedKeys;
+    private formatConfigErrorsBanner;
+}
 export declare function loadAndValidate(cwd: string): LoadedConfig;

package/src/load-config.js

@@ -1,7 +1,10 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.LoadedConfig = void 0;
+exports.ConfigLoader = exports.LoadedConfig = void 0;
 exports.loadAndValidate = loadAndValidate;
+const tslib_1 = require("tslib");
+const core_context_1 = require("@webpieces/core-context");
+const inversify_1 = require("inversify");
 const commands_config_1 = require("./commands-config");
 const config_file_1 = require("./config-file");
 const default_rules_1 = require("./default-rules");
@@ -10,83 +13,9 @@ const inform_ai_error_1 = require("./inform-ai-error");
 const types_1 = require("./types");
 const validate_config_1 = require("./validate-config");
 const WebpiecesRulesConfig_1 = require("./WebpiecesRulesConfig");
-// Inject the canonical command strings (from the `commands` section) as the DEFAULT for the guards
-// that surface them in their fix hints, so a project renames a command in one place. Only fills a
-// gap — an explicit per-guard override wins. Mutates the merged guard entries in place.
-function applyCommandDefaults(
-// webpieces-disable no-any-unknown -- opaque merged rule/guard map
-rules, commands) {
-    const prCreation = rules['pr-creation-or-push-guard'];
-    if (prCreation && prCreation['upsertPrCommand'] === undefined) {
-        prCreation['upsertPrCommand'] = commands.upsertPr;
-    }
-    const mergeInProgress = rules['merge-in-progress-guard'];
-    if (mergeInProgress && mergeInProgress['mergeCompleteCommand'] === undefined) {
-        mergeInProgress['mergeCompleteCommand'] = commands.mergeComplete;
-    }
-}
-// webpieces-disable no-any-unknown -- merging opaque option bags from config JSON
-function mergeRule(
-// webpieces-disable no-any-unknown -- opaque option bag
-baseRule, 
-// webpieces-disable no-any-unknown -- opaque option bag
-overrideRule) {
-    if (!baseRule && !overrideRule)
-        return new types_1.ResolvedRuleConfig({ mode: 'OFF' });
-    if (!baseRule)
-        return new types_1.ResolvedRuleConfig(overrideRule);
-    if (!overrideRule)
-        return new types_1.ResolvedRuleConfig(baseRule);
-    // webpieces-disable no-any-unknown -- building merged option bag
-    const merged = {};
-    for (const key of Object.keys(baseRule))
-        merged[key] = baseRule[key];
-    for (const key of Object.keys(overrideRule))
-        merged[key] = overrideRule[key];
-    return new types_1.ResolvedRuleConfig(merged);
-}
-// Parse the (already-validated) raw excludePaths block into the typed ExcludePaths. Defensive
-// defaults keep this total even though validateExcludePaths guarantees both string[] lists are set.
-// webpieces-disable no-any-unknown -- `raw` is opaque consumer JSON until narrowed here
-function parseExcludePaths(raw) {
-    if (typeof raw !== 'object' || raw === null || Array.isArray(raw))
-        return new exclude_hook_paths_1.ExcludePaths([], []);
-    // webpieces-disable no-any-unknown -- validateExcludePaths already proved both are string[]
-    const s = raw;
-    const rules = Array.isArray(s['rules']) ? s['rules'].filter(p => typeof p === 'string') : [];
-    const guards = Array.isArray(s['guards']) ? s['guards'].filter(p => typeof p === 'string') : [];
-    return new exclude_hook_paths_1.ExcludePaths(rules, guards);
-}
-// Parse the (already-validated) raw match-rules array into typed MatchRuleConfig[]. Each entry is a
-// plain object from JSON; the engines consume its fields only (no methods), so a structural cast is
-// sufficient. Defensive [] keeps this total even though validateMatchRulesSection ran first.
-// webpieces-disable no-any-unknown -- validated array; each entry cast to the typed MatchRuleConfig
-function parseMatchRules(raw) {
-    if (!Array.isArray(raw))
-        return [];
-    return 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];
-    }
-    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); rules + hookGuards merged.
- *  - `commands`    — the `commands` section (gated commands + pr-gate).
- *  - `prGate`      — convenience alias of `commands.prGate` (pr-gate scripts).
- *  - `excludePaths`— the required `excludePaths` block (per-category glob suppression lists).
- *  - `matchRules`  — the required `match-rules` array (client-authored content guards).
- *  - `configPath`  — absolute path, or null when no config file was found.
+ * validation pass. Data-only (per CLAUDE.md, classes for data).
  */
 class LoadedConfig {
     resolved;
@@ -111,86 +40,163 @@ exports.LoadedConfig = LoadedConfig;
 // Config keys that were renamed. A project's webpieces.config.json may still use the OLD key (it can
 // legitimately lag the published rules-config by a release), so normalize any deprecated key to its
 // canonical name BEFORE validation/placement/loading — every downstream consumer then sees one name.
-// The old key stays accepted indefinitely; teams can flip to the new name whenever convenient.
 const DEPRECATED_RULE_ALIASES = {
     'pr-merge-cleanup': 'pr-merge-guard',
-    // pr-creation-guard was broadened to also block a manual `git push` and renamed accordingly.
     'pr-creation-guard': 'pr-creation-or-push-guard',
 };
-function normalizeDeprecatedKeys(section) {
-    const out = {};
-    for (const key of Object.keys(section)) {
-        out[DEPRECATED_RULE_ALIASES[key] ?? key] = section[key];
-    }
-    return out;
-}
-// Assemble the validation-failure banner. Most of these errors are version skew, not bad config: a dep
-// bump updated webpieces.config.json (+ package.json/lockfile) with new rule names/values, but this
-// checkout's node_modules was never re-installed, so the OLDER guard binary that is running rejects the
-// newer config. Deleting the flagged keys destroys valid config — so lead the AI to `pnpm install`
-// first. Both `pnpm install` (installer bypass) and edits to webpieces.config.json (fix-target bypass)
-// are ALWAYS allowed through the guard even while the config is invalid, so neither step can deadlock.
-function formatConfigErrorsBanner(errors) {
-    return (`webpieces.config.json has ${errors.length} validation error(s) — fix ALL, then retry:\n\n` +
-        errors.map(e => `  • ${e}`).join('\n') +
-        `\n\n👉 FIX ORDER (do NOT start by deleting keys — that usually deletes VALID config):\n` +
-        `  1. Run \`pnpm install\`. It is ALWAYS allowed through the guard (installer bypass), even ` +
-        `while this config is invalid. This is the #1 cause: your installed @webpieces guard is a ` +
-        `release BEHIND webpieces.config.json (a dep bump updated the config + lockfile, but ` +
-        `node_modules here was never re-installed), so the running validator doesn't know the newer ` +
-        `rule names/values yet. \`pnpm install\` syncs node_modules to the pinned version.\n` +
-        `  2. Retry your command. If the errors are gone, you're DONE — do not touch webpieces.config.json.\n` +
-        `  3. ONLY if an error survives a fresh install is it a genuine typo / removed / renamed rule. ` +
-        `Then edit webpieces.config.json (edits to it are ALWAYS allowed) to fix each • above.`);
-}
 /**
  * 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).
+ * nx-webpieces-rules, pr-gate scripts). `@provideSingleton` + injects {@link ConfigFile} so it appears
+ * in the rules-config DI design.
  */
-function loadAndValidate(cwd) {
-    const configPath = (0, config_file_1.findConfigFile)(cwd);
-    if (!configPath) {
-        const emptyCommands = (0, commands_config_1.buildCommandsConfig)(undefined);
-        return new LoadedConfig(new types_1.ResolvedConfig(new Map(), new Set(), [], null), new WebpiecesRulesConfig_1.WebpiecesRulesConfig(), emptyCommands, emptyCommands.prGate, new exclude_hook_paths_1.ExcludePaths([], []), [], null);
+let ConfigLoader = class ConfigLoader {
+    configFile;
+    constructor(configFile) {
+        this.configFile = configFile;
+    }
+    /**
+     * 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).
+     */
+    // webpieces-disable max-lines-new-methods -- the single load+validate pass is one cohesive method
+    loadAndValidate(cwd) {
+        const configPath = this.configFile.findConfigFile(cwd);
+        if (!configPath) {
+            const emptyCommands = (0, commands_config_1.buildCommandsConfig)(undefined);
+            return new LoadedConfig(new types_1.ResolvedConfig(new Map(), new Set(), [], null), new WebpiecesRulesConfig_1.WebpiecesRulesConfig(), emptyCommands, emptyCommands.prGate, new exclude_hook_paths_1.ExcludePaths([], []), [], null);
+        }
+        const consumerConfig = this.configFile.readRawConfig(configPath);
+        const rulesSection = this.normalizeDeprecatedKeys(consumerConfig.rules || {});
+        const hookGuardsSection = this.normalizeDeprecatedKeys(consumerConfig.hookGuards || {});
+        const legacyPrGate = consumerConfig['pr-gate'];
+        // rules + hookGuards are validated/loaded as one flat name→config map (the runtime dispatches
+        // by each rule's own `scope`). Placement is enforced separately.
+        const overrideRules = { ...rulesSection, ...hookGuardsSection };
+        const rulesDir = consumerConfig.rulesDir ?? [];
+        const errors = [
+            ...(0, validate_config_1.validateWebpiecesConfig)(overrideRules, rulesDir.length > 0),
+            ...(0, validate_config_1.validateSectionPlacement)(rulesSection, hookGuardsSection),
+            ...(0, validate_config_1.validateCommandsSection)(consumerConfig.commands, legacyPrGate),
+            ...(0, validate_config_1.validateExcludePaths)(consumerConfig.excludePaths),
+            ...(0, validate_config_1.validateMatchRulesSection)(consumerConfig['match-rules']),
+        ];
+        if (errors.length > 0) {
+            throw new inform_ai_error_1.InformAiError(this.formatConfigErrorsBanner(errors));
+        }
+        const commands = (0, commands_config_1.buildCommandsConfig)(consumerConfig.commands, legacyPrGate);
+        this.applyCommandDefaults(overrideRules, commands);
+        const userConfiguredRuleNames = new Set(Object.keys(overrideRules));
+        const mergedRules = new Map();
+        const allRuleNames = new Set([
+            ...Object.keys(default_rules_1.defaultRules),
+            ...Object.keys(overrideRules),
+        ]);
+        for (const name of allRuleNames) {
+            mergedRules.set(name, this.mergeRule(default_rules_1.defaultRules[name], overrideRules[name]));
+        }
+        const resolved = new types_1.ResolvedConfig(mergedRules, userConfiguredRuleNames, rulesDir, configPath);
+        const rulesConfig = this.buildWebpiecesRulesConfig(overrideRules, rulesDir);
+        const excludePaths = this.parseExcludePaths(consumerConfig.excludePaths);
+        const matchRules = this.parseMatchRules(consumerConfig['match-rules']);
+        return new LoadedConfig(resolved, rulesConfig, commands, commands.prGate, excludePaths, matchRules, configPath);
+    }
+    // Inject the canonical command strings (from the `commands` section) as the DEFAULT for the guards
+    // that surface them in their fix hints. Only fills a gap — an explicit per-guard override wins.
+    applyCommandDefaults(
+    // webpieces-disable no-any-unknown -- opaque merged rule/guard map
+    rules, commands) {
+        const prCreation = rules['pr-creation-or-push-guard'];
+        if (prCreation && prCreation['upsertPrCommand'] === undefined) {
+            prCreation['upsertPrCommand'] = commands.upsertPr;
+        }
+        const mergeInProgress = rules['merge-in-progress-guard'];
+        if (mergeInProgress && mergeInProgress['mergeCompleteCommand'] === undefined) {
+            mergeInProgress['mergeCompleteCommand'] = commands.mergeComplete;
+        }
+    }
+    // webpieces-disable no-any-unknown -- merging opaque option bags from config JSON
+    mergeRule(
+    // webpieces-disable no-any-unknown -- opaque option bag
+    baseRule, 
+    // webpieces-disable no-any-unknown -- opaque option bag
+    overrideRule) {
+        if (!baseRule && !overrideRule)
+            return new types_1.ResolvedRuleConfig({ mode: 'OFF' });
+        if (!baseRule)
+            return new types_1.ResolvedRuleConfig(overrideRule);
+        if (!overrideRule)
+            return new types_1.ResolvedRuleConfig(baseRule);
+        // webpieces-disable no-any-unknown -- building merged option bag
+        const merged = {};
+        for (const key of Object.keys(baseRule))
+            merged[key] = baseRule[key];
+        for (const key of Object.keys(overrideRule))
+            merged[key] = overrideRule[key];
+        return new types_1.ResolvedRuleConfig(merged);
     }
-    const consumerConfig = (0, config_file_1.readRawConfig)(configPath);
-    const rulesSection = normalizeDeprecatedKeys(consumerConfig.rules || {});
-    const hookGuardsSection = normalizeDeprecatedKeys(consumerConfig.hookGuards || {});
-    const legacyPrGate = consumerConfig['pr-gate'];
-    // rules + hookGuards are validated/loaded as one flat name→config map (the runtime dispatches by
-    // each rule's own `scope`, so it needs no section knowledge). Placement is enforced separately.
-    const overrideRules = { ...rulesSection, ...hookGuardsSection };
-    // A non-empty rulesDir means custom rules exist (loaded at runtime by ai-hook-rules), so a config
-    // key with no built-in schema may be a legitimate custom rule. With no rulesDir, an unknown key is
-    // a dead/typo'd entry and is rejected (validateWebpiecesConfig).
-    const rulesDir = consumerConfig.rulesDir ?? [];
-    const errors = [
-        ...(0, validate_config_1.validateWebpiecesConfig)(overrideRules, rulesDir.length > 0),
-        ...(0, validate_config_1.validateSectionPlacement)(rulesSection, hookGuardsSection),
-        ...(0, validate_config_1.validateCommandsSection)(consumerConfig.commands, legacyPrGate),
-        ...(0, validate_config_1.validateExcludePaths)(consumerConfig.excludePaths),
-        ...(0, validate_config_1.validateMatchRulesSection)(consumerConfig['match-rules']),
-    ];
-    if (errors.length > 0) {
-        throw new inform_ai_error_1.InformAiError(formatConfigErrorsBanner(errors));
+    // Parse the (already-validated) raw excludePaths block into the typed ExcludePaths.
+    // webpieces-disable no-any-unknown -- `raw` is opaque consumer JSON until narrowed here
+    parseExcludePaths(raw) {
+        if (typeof raw !== 'object' || raw === null || Array.isArray(raw))
+            return new exclude_hook_paths_1.ExcludePaths([], []);
+        // webpieces-disable no-any-unknown -- validateExcludePaths already proved both are string[]
+        const s = raw;
+        const rules = Array.isArray(s['rules']) ? s['rules'].filter(p => typeof p === 'string') : [];
+        const guards = Array.isArray(s['guards']) ? s['guards'].filter(p => typeof p === 'string') : [];
+        return new exclude_hook_paths_1.ExcludePaths(rules, guards);
     }
-    const commands = (0, commands_config_1.buildCommandsConfig)(consumerConfig.commands, legacyPrGate);
-    applyCommandDefaults(overrideRules, commands);
-    const userConfiguredRuleNames = new Set(Object.keys(overrideRules));
-    const mergedRules = new Map();
-    const allRuleNames = new Set([
-        ...Object.keys(default_rules_1.defaultRules),
-        ...Object.keys(overrideRules),
-    ]);
-    for (const name of allRuleNames) {
-        mergedRules.set(name, mergeRule(default_rules_1.defaultRules[name], overrideRules[name]));
+    // Parse the (already-validated) raw match-rules array into typed MatchRuleConfig[].
+    // webpieces-disable no-any-unknown -- validated array; each entry cast to the typed MatchRuleConfig
+    parseMatchRules(raw) {
+        if (!Array.isArray(raw))
+            return [];
+        return raw;
     }
-    const resolved = new types_1.ResolvedConfig(mergedRules, userConfiguredRuleNames, rulesDir, configPath);
-    const rulesConfig = buildWebpiecesRulesConfig(overrideRules, rulesDir);
-    const excludePaths = parseExcludePaths(consumerConfig.excludePaths);
-    const matchRules = parseMatchRules(consumerConfig['match-rules']);
-    return new LoadedConfig(resolved, rulesConfig, commands, commands.prGate, excludePaths, matchRules, configPath);
+    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;
+    }
+    normalizeDeprecatedKeys(section) {
+        const out = {};
+        for (const key of Object.keys(section)) {
+            out[DEPRECATED_RULE_ALIASES[key] ?? key] = section[key];
+        }
+        return out;
+    }
+    // Assemble the validation-failure banner. Most of these errors are version skew, not bad config.
+    formatConfigErrorsBanner(errors) {
+        return (`webpieces.config.json has ${errors.length} validation error(s) — fix ALL, then retry:\n\n` +
+            errors.map(e => `  • ${e}`).join('\n') +
+            `\n\n👉 FIX ORDER (do NOT start by deleting keys — that usually deletes VALID config):\n` +
+            `  1. Run \`pnpm install\`. It is ALWAYS allowed through the guard (installer bypass), even ` +
+            `while this config is invalid. This is the #1 cause: your installed @webpieces guard is a ` +
+            `release BEHIND webpieces.config.json (a dep bump updated the config + lockfile, but ` +
+            `node_modules here was never re-installed), so the running validator doesn't know the newer ` +
+            `rule names/values yet. \`pnpm install\` syncs node_modules to the pinned version.\n` +
+            `  2. Retry your command. If the errors are gone, you're DONE — do not touch webpieces.config.json.\n` +
+            `  3. ONLY if an error survives a fresh install is it a genuine typo / removed / renamed rule. ` +
+            `Then edit webpieces.config.json (edits to it are ALWAYS allowed) to fix each • above.`);
+    }
+};
+exports.ConfigLoader = ConfigLoader;
+exports.ConfigLoader = ConfigLoader = tslib_1.__decorate([
+    (0, core_context_1.provideSingleton)(),
+    (0, inversify_1.injectable)(),
+    tslib_1.__metadata("design:paramtypes", [config_file_1.ConfigFile])
+], ConfigLoader);
+// Temporary migration delegator — consumers migrate to injecting ConfigLoader over follow-up PRs,
+// then this free function is removed. The logic now lives in the injected ConfigLoader class.
+const configLoaderSvc = new ConfigLoader(new config_file_1.ConfigFile());
+// webpieces-disable no-function-outside-class -- temporary back-compat delegator to ConfigLoader; removed once all 118 consumers inject it
+function loadAndValidate(cwd) {
+    return configLoaderSvc.loadAndValidate(cwd);
 }
 //# 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 { buildCommandsConfig, CommandsConfig } from './commands-config';\nimport { findConfigFile, readRawConfig } from './config-file';\nimport { defaultRules } from './default-rules';\nimport { ExcludePaths } from './exclude-hook-paths';\nimport { InformAiError } from './inform-ai-error';\nimport { PrGateConfig } from './pr-gate-config';\nimport { ResolvedConfig, ResolvedRuleConfig, RuleOptions } from './types';\nimport { validateCommandsSection, validateExcludePaths, validateMatchRulesSection, validateSectionPlacement, validateWebpiecesConfig } from './validate-config';\nimport { MatchRuleConfig } from './match-rules-config';\nimport { WebpiecesRulesConfig } from './WebpiecesRulesConfig';\n\n// Inject the canonical command strings (from the `commands` section) as the DEFAULT for the guards\n// that surface them in their fix hints, so a project renames a command in one place. Only fills a\n// gap — an explicit per-guard override wins. Mutates the merged guard entries in place.\nfunction applyCommandDefaults(\n    // webpieces-disable no-any-unknown -- opaque merged rule/guard map\n    rules: Record<string, Record<string, unknown>>,\n    commands: CommandsConfig,\n): void {\n    const prCreation = rules['pr-creation-or-push-guard'];\n    if (prCreation && prCreation['upsertPrCommand'] === undefined) {\n        prCreation['upsertPrCommand'] = commands.upsertPr;\n    }\n    const mergeInProgress = rules['merge-in-progress-guard'];\n    if (mergeInProgress && mergeInProgress['mergeCompleteCommand'] === undefined) {\n        mergeInProgress['mergeCompleteCommand'] = commands.mergeComplete;\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\n// Parse the (already-validated) raw excludePaths block into the typed ExcludePaths. Defensive\n// defaults keep this total even though validateExcludePaths guarantees both string[] lists are set.\n// webpieces-disable no-any-unknown -- `raw` is opaque consumer JSON until narrowed here\nfunction parseExcludePaths(raw: unknown): ExcludePaths {\n    if (typeof raw !== 'object' || raw === null || Array.isArray(raw)) return new ExcludePaths([], []);\n    // webpieces-disable no-any-unknown -- validateExcludePaths already proved both are string[]\n    const s = raw as Record<string, string[]>;\n    const rules = Array.isArray(s['rules']) ? s['rules'].filter(p => typeof p === 'string') : [];\n    const guards = Array.isArray(s['guards']) ? s['guards'].filter(p => typeof p === 'string') : [];\n    return new ExcludePaths(rules, guards);\n}\n\n// Parse the (already-validated) raw match-rules array into typed MatchRuleConfig[]. Each entry is a\n// plain object from JSON; the engines consume its fields only (no methods), so a structural cast is\n// sufficient. Defensive [] keeps this total even though validateMatchRulesSection ran first.\n// webpieces-disable no-any-unknown -- validated array; each entry cast to the typed MatchRuleConfig\nfunction parseMatchRules(raw: unknown): MatchRuleConfig[] {\n    if (!Array.isArray(raw)) return [];\n    return raw as MatchRuleConfig[];\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); rules + hookGuards merged.\n *  - `commands`    — the `commands` section (gated commands + pr-gate).\n *  - `prGate`      — convenience alias of `commands.prGate` (pr-gate scripts).\n *  - `excludePaths`— the required `excludePaths` block (per-category glob suppression lists).\n *  - `matchRules`  — the required `match-rules` array (client-authored content guards).\n *  - `configPath`  — absolute path, or null when no config file was found.\n */\nexport class LoadedConfig {\n    // eslint-disable-next-line @typescript-eslint/max-params\n    constructor(\n        readonly resolved: ResolvedConfig,\n        readonly rulesConfig: WebpiecesRulesConfig,\n        readonly commands: CommandsConfig,\n        readonly prGate: PrGateConfig,\n        readonly excludePaths: ExcludePaths,\n        readonly matchRules: readonly MatchRuleConfig[],\n        readonly configPath: string | null,\n    ) {}\n}\n\n// Config keys that were renamed. A project's webpieces.config.json may still use the OLD key (it can\n// legitimately lag the published rules-config by a release), so normalize any deprecated key to its\n// canonical name BEFORE validation/placement/loading — every downstream consumer then sees one name.\n// The old key stays accepted indefinitely; teams can flip to the new name whenever convenient.\nconst DEPRECATED_RULE_ALIASES: Readonly<Record<string, string>> = {\n    'pr-merge-cleanup': 'pr-merge-guard',\n    // pr-creation-guard was broadened to also block a manual `git push` and renamed accordingly.\n    'pr-creation-guard': 'pr-creation-or-push-guard',\n};\n\n// webpieces-disable no-any-unknown -- opaque per-rule option bags from consumer JSON, validated later\ntype RuleSectionMap = Record<string, Record<string, unknown>>;\n\nfunction normalizeDeprecatedKeys(section: RuleSectionMap): RuleSectionMap {\n    const out: RuleSectionMap = {};\n    for (const key of Object.keys(section)) {\n        out[DEPRECATED_RULE_ALIASES[key] ?? key] = section[key];\n    }\n    return out;\n}\n\n// Assemble the validation-failure banner. Most of these errors are version skew, not bad config: a dep\n// bump updated webpieces.config.json (+ package.json/lockfile) with new rule names/values, but this\n// checkout's node_modules was never re-installed, so the OLDER guard binary that is running rejects the\n// newer config. Deleting the flagged keys destroys valid config — so lead the AI to `pnpm install`\n// first. Both `pnpm install` (installer bypass) and edits to webpieces.config.json (fix-target bypass)\n// are ALWAYS allowed through the guard even while the config is invalid, so neither step can deadlock.\nfunction formatConfigErrorsBanner(errors: string[]): string {\n    return (\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👉 FIX ORDER (do NOT start by deleting keys — that usually deletes VALID config):\\n` +\n        `  1. Run \\`pnpm install\\`. It is ALWAYS allowed through the guard (installer bypass), even ` +\n        `while this config is invalid. This is the #1 cause: your installed @webpieces guard is a ` +\n        `release BEHIND webpieces.config.json (a dep bump updated the config + lockfile, but ` +\n        `node_modules here was never re-installed), so the running validator doesn't know the newer ` +\n        `rule names/values yet. \\`pnpm install\\` syncs node_modules to the pinned version.\\n` +\n        `  2. Retry your command. If the errors are gone, you're DONE — do not touch webpieces.config.json.\\n` +\n        `  3. ONLY if an error survives a fresh install is it a genuine typo / removed / renamed rule. ` +\n        `Then edit webpieces.config.json (edits to it are ALWAYS allowed) to fix each • above.`\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        const emptyCommands = buildCommandsConfig(undefined);\n        return new LoadedConfig(\n            new ResolvedConfig(new Map(), new Set(), [], null),\n            new WebpiecesRulesConfig(),\n            emptyCommands,\n            emptyCommands.prGate,\n            new ExcludePaths([], []),\n            [],\n            null,\n        );\n    }\n\n    const consumerConfig = readRawConfig(configPath);\n    const rulesSection = normalizeDeprecatedKeys(consumerConfig.rules || {});\n    const hookGuardsSection = normalizeDeprecatedKeys(consumerConfig.hookGuards || {});\n    const legacyPrGate = consumerConfig['pr-gate'];\n\n    // rules + hookGuards are validated/loaded as one flat name→config map (the runtime dispatches by\n    // each rule's own `scope`, so it needs no section knowledge). Placement is enforced separately.\n    const overrideRules = { ...rulesSection, ...hookGuardsSection };\n\n    // A non-empty rulesDir means custom rules exist (loaded at runtime by ai-hook-rules), so a config\n    // key with no built-in schema may be a legitimate custom rule. With no rulesDir, an unknown key is\n    // a dead/typo'd entry and is rejected (validateWebpiecesConfig).\n    const rulesDir = consumerConfig.rulesDir ?? [];\n\n    const errors = [\n        ...validateWebpiecesConfig(overrideRules, rulesDir.length > 0),\n        ...validateSectionPlacement(rulesSection, hookGuardsSection),\n        ...validateCommandsSection(consumerConfig.commands, legacyPrGate),\n        ...validateExcludePaths(consumerConfig.excludePaths),\n        ...validateMatchRulesSection(consumerConfig['match-rules']),\n    ];\n    if (errors.length > 0) {\n        throw new InformAiError(formatConfigErrorsBanner(errors));\n    }\n    const commands = buildCommandsConfig(consumerConfig.commands, legacyPrGate);\n    applyCommandDefaults(overrideRules, commands);\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 excludePaths = parseExcludePaths(consumerConfig.excludePaths);\n    const matchRules = parseMatchRules(consumerConfig['match-rules']);\n\n    return new LoadedConfig(resolved, rulesConfig, commands, commands.prGate, excludePaths, matchRules, 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 { provideSingleton } from '@webpieces/core-context';\nimport { injectable } from 'inversify';\n\nimport { buildCommandsConfig, CommandsConfig } from './commands-config';\nimport { ConfigFile } from './config-file';\nimport { defaultRules } from './default-rules';\nimport { ExcludePaths } from './exclude-hook-paths';\nimport { InformAiError } from './inform-ai-error';\nimport { PrGateConfig } from './pr-gate-config';\nimport { ResolvedConfig, ResolvedRuleConfig, RuleOptions } from './types';\nimport { validateCommandsSection, validateExcludePaths, validateMatchRulesSection, validateSectionPlacement, validateWebpiecesConfig } from './validate-config';\nimport { MatchRuleConfig } from './match-rules-config';\nimport { WebpiecesRulesConfig } from './WebpiecesRulesConfig';\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 */\nexport class LoadedConfig {\n    // eslint-disable-next-line @typescript-eslint/max-params\n    constructor(\n        readonly resolved: ResolvedConfig,\n        readonly rulesConfig: WebpiecesRulesConfig,\n        readonly commands: CommandsConfig,\n        readonly prGate: PrGateConfig,\n        readonly excludePaths: ExcludePaths,\n        readonly matchRules: readonly MatchRuleConfig[],\n        readonly configPath: string | null,\n    ) {}\n}\n\n// Config keys that were renamed. A project's webpieces.config.json may still use the OLD key (it can\n// legitimately lag the published rules-config by a release), so normalize any deprecated key to its\n// canonical name BEFORE validation/placement/loading — every downstream consumer then sees one name.\nconst DEPRECATED_RULE_ALIASES: Readonly<Record<string, string>> = {\n    'pr-merge-cleanup': 'pr-merge-guard',\n    'pr-creation-guard': 'pr-creation-or-push-guard',\n};\n\n// webpieces-disable no-any-unknown -- opaque per-rule option bags from consumer JSON, validated later\ntype RuleSectionMap = Record<string, Record<string, unknown>>;\n\n/**\n * The single load+validate entry point for ALL consumers (ai-hook-rules, code-rules,\n * nx-webpieces-rules, pr-gate scripts). `@provideSingleton` + injects {@link ConfigFile} so it appears\n * in the rules-config DI design.\n */\n@provideSingleton()\n@injectable()\nexport class ConfigLoader {\n    constructor(private readonly configFile: ConfigFile) {}\n\n    /**\n     * Reads webpieces.config.json once, validates BOTH the `rules` map and the top-level `pr-gate`\n     * block, and throws one InformAiError listing every error. When no config file is found it returns\n     * lenient empties/defaults (matching prior no-file behavior).\n     */\n    // webpieces-disable max-lines-new-methods -- the single load+validate pass is one cohesive method\n    loadAndValidate(cwd: string): LoadedConfig {\n        const configPath = this.configFile.findConfigFile(cwd);\n        if (!configPath) {\n            const emptyCommands = buildCommandsConfig(undefined);\n            return new LoadedConfig(\n                new ResolvedConfig(new Map(), new Set(), [], null),\n                new WebpiecesRulesConfig(),\n                emptyCommands,\n                emptyCommands.prGate,\n                new ExcludePaths([], []),\n                [],\n                null,\n            );\n        }\n\n        const consumerConfig = this.configFile.readRawConfig(configPath);\n        const rulesSection = this.normalizeDeprecatedKeys(consumerConfig.rules || {});\n        const hookGuardsSection = this.normalizeDeprecatedKeys(consumerConfig.hookGuards || {});\n        const legacyPrGate = consumerConfig['pr-gate'];\n\n        // rules + hookGuards are validated/loaded as one flat name→config map (the runtime dispatches\n        // by each rule's own `scope`). Placement is enforced separately.\n        const overrideRules = { ...rulesSection, ...hookGuardsSection };\n\n        const rulesDir = consumerConfig.rulesDir ?? [];\n\n        const errors = [\n            ...validateWebpiecesConfig(overrideRules, rulesDir.length > 0),\n            ...validateSectionPlacement(rulesSection, hookGuardsSection),\n            ...validateCommandsSection(consumerConfig.commands, legacyPrGate),\n            ...validateExcludePaths(consumerConfig.excludePaths),\n            ...validateMatchRulesSection(consumerConfig['match-rules']),\n        ];\n        if (errors.length > 0) {\n            throw new InformAiError(this.formatConfigErrorsBanner(errors));\n        }\n        const commands = buildCommandsConfig(consumerConfig.commands, legacyPrGate);\n        this.applyCommandDefaults(overrideRules, commands);\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, this.mergeRule(defaultRules[name], overrideRules[name]));\n        }\n        const resolved = new ResolvedConfig(mergedRules, userConfiguredRuleNames, rulesDir, configPath);\n\n        const rulesConfig = this.buildWebpiecesRulesConfig(overrideRules, rulesDir);\n        const excludePaths = this.parseExcludePaths(consumerConfig.excludePaths);\n        const matchRules = this.parseMatchRules(consumerConfig['match-rules']);\n\n        return new LoadedConfig(resolved, rulesConfig, commands, commands.prGate, excludePaths, matchRules, configPath);\n    }\n\n    // Inject the canonical command strings (from the `commands` section) as the DEFAULT for the guards\n    // that surface them in their fix hints. Only fills a gap — an explicit per-guard override wins.\n    private applyCommandDefaults(\n        // webpieces-disable no-any-unknown -- opaque merged rule/guard map\n        rules: Record<string, Record<string, unknown>>,\n        commands: CommandsConfig,\n    ): void {\n        const prCreation = rules['pr-creation-or-push-guard'];\n        if (prCreation && prCreation['upsertPrCommand'] === undefined) {\n            prCreation['upsertPrCommand'] = commands.upsertPr;\n        }\n        const mergeInProgress = rules['merge-in-progress-guard'];\n        if (mergeInProgress && mergeInProgress['mergeCompleteCommand'] === undefined) {\n            mergeInProgress['mergeCompleteCommand'] = commands.mergeComplete;\n        }\n    }\n\n    // webpieces-disable no-any-unknown -- merging opaque option bags from config JSON\n    private 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\n    // Parse the (already-validated) raw excludePaths block into the typed ExcludePaths.\n    // webpieces-disable no-any-unknown -- `raw` is opaque consumer JSON until narrowed here\n    private parseExcludePaths(raw: unknown): ExcludePaths {\n        if (typeof raw !== 'object' || raw === null || Array.isArray(raw)) return new ExcludePaths([], []);\n        // webpieces-disable no-any-unknown -- validateExcludePaths already proved both are string[]\n        const s = raw as Record<string, string[]>;\n        const rules = Array.isArray(s['rules']) ? s['rules'].filter(p => typeof p === 'string') : [];\n        const guards = Array.isArray(s['guards']) ? s['guards'].filter(p => typeof p === 'string') : [];\n        return new ExcludePaths(rules, guards);\n    }\n\n    // Parse the (already-validated) raw match-rules array into typed MatchRuleConfig[].\n    // webpieces-disable no-any-unknown -- validated array; each entry cast to the typed MatchRuleConfig\n    private parseMatchRules(raw: unknown): MatchRuleConfig[] {\n        if (!Array.isArray(raw)) return [];\n        return raw as MatchRuleConfig[];\n    }\n\n    private 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    private normalizeDeprecatedKeys(section: RuleSectionMap): RuleSectionMap {\n        const out: RuleSectionMap = {};\n        for (const key of Object.keys(section)) {\n            out[DEPRECATED_RULE_ALIASES[key] ?? key] = section[key];\n        }\n        return out;\n    }\n\n    // Assemble the validation-failure banner. Most of these errors are version skew, not bad config.\n    private formatConfigErrorsBanner(errors: string[]): string {\n        return (\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👉 FIX ORDER (do NOT start by deleting keys — that usually deletes VALID config):\\n` +\n            `  1. Run \\`pnpm install\\`. It is ALWAYS allowed through the guard (installer bypass), even ` +\n            `while this config is invalid. This is the #1 cause: your installed @webpieces guard is a ` +\n            `release BEHIND webpieces.config.json (a dep bump updated the config + lockfile, but ` +\n            `node_modules here was never re-installed), so the running validator doesn't know the newer ` +\n            `rule names/values yet. \\`pnpm install\\` syncs node_modules to the pinned version.\\n` +\n            `  2. Retry your command. If the errors are gone, you're DONE — do not touch webpieces.config.json.\\n` +\n            `  3. ONLY if an error survives a fresh install is it a genuine typo / removed / renamed rule. ` +\n            `Then edit webpieces.config.json (edits to it are ALWAYS allowed) to fix each • above.`\n        );\n    }\n}\n\n// Temporary migration delegator — consumers migrate to injecting ConfigLoader over follow-up PRs,\n// then this free function is removed. The logic now lives in the injected ConfigLoader class.\nconst configLoaderSvc = new ConfigLoader(new ConfigFile());\n\n// webpieces-disable no-function-outside-class -- temporary back-compat delegator to ConfigLoader; removed once all 118 consumers inject it\nexport function loadAndValidate(cwd: string): LoadedConfig {\n    return configLoaderSvc.loadAndValidate(cwd);\n}\n"]}

package/src/load-template.d.ts

@@ -1,3 +1,12 @@
+/**
+ * Writes the AI-facing instruct-ai template docs under `<workspaceRoot>/.webpieces/instruct-ai/`.
+ * `@provideSingleton` so it can be injected and appear in the rules-config DI design.
+ */
+export declare class TemplateWriter {
+    loadTemplate(name: string): string;
+    writeTemplateIfMissing(workspaceRoot: string, name: string, instructDir?: string): void;
+    writeTemplate(workspaceRoot: string, name: string, instructDir?: string): string;
+}
 export declare function loadTemplate(name: string): string;
 export declare function writeTemplateIfMissing(workspaceRoot: string, name: string, instructDir?: string): void;
 export declare function writeTemplate(workspaceRoot: string, name: string, instructDir?: string): string;

package/src/load-template.js

@@ -1,27 +1,52 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.TemplateWriter = void 0;
 exports.loadTemplate = loadTemplate;
 exports.writeTemplateIfMissing = writeTemplateIfMissing;
 exports.writeTemplate = writeTemplate;
 const tslib_1 = require("tslib");
 const fs = tslib_1.__importStar(require("fs"));
 const path = tslib_1.__importStar(require("path"));
+const core_context_1 = require("@webpieces/core-context");
+const inversify_1 = require("inversify");
 const TEMPLATES_DIR = path.join(__dirname, '..', 'templates');
 const DEFAULT_INSTRUCT_DIR = '.webpieces/instruct-ai';
+/**
+ * Writes the AI-facing instruct-ai template docs under `<workspaceRoot>/.webpieces/instruct-ai/`.
+ * `@provideSingleton` so it can be injected and appear in the rules-config DI design.
+ */
+let TemplateWriter = class TemplateWriter {
+    loadTemplate(name) {
+        return fs.readFileSync(path.join(TEMPLATES_DIR, name), 'utf-8');
+    }
+    writeTemplateIfMissing(workspaceRoot, name, instructDir = DEFAULT_INSTRUCT_DIR) {
+        const dest = path.join(workspaceRoot, instructDir, name);
+        if (fs.existsSync(dest))
+            return;
+        fs.mkdirSync(path.dirname(dest), { recursive: true });
+        fs.writeFileSync(dest, this.loadTemplate(name), 'utf-8');
+    }
+    writeTemplate(workspaceRoot, name, instructDir = DEFAULT_INSTRUCT_DIR) {
+        const dest = path.join(workspaceRoot, instructDir, name);
+        fs.mkdirSync(path.dirname(dest), { recursive: true });
+        fs.writeFileSync(dest, this.loadTemplate(name), 'utf-8');
+        return dest;
+    }
+};
+exports.TemplateWriter = TemplateWriter;
+exports.TemplateWriter = TemplateWriter = tslib_1.__decorate([
+    (0, core_context_1.provideSingleton)(),
+    (0, inversify_1.injectable)()
+], TemplateWriter);
+// Temporary migration delegators — consumers migrate to injecting TemplateWriter over follow-up PRs.
+const templateWriterSvc = new TemplateWriter();
 function loadTemplate(name) {
-    return fs.readFileSync(path.join(TEMPLATES_DIR, name), 'utf-8');
+    return templateWriterSvc.loadTemplate(name);
 }
 function writeTemplateIfMissing(workspaceRoot, name, instructDir = DEFAULT_INSTRUCT_DIR) {
-    const dest = path.join(workspaceRoot, instructDir, name);
-    if (fs.existsSync(dest))
-        return;
-    fs.mkdirSync(path.dirname(dest), { recursive: true });
-    fs.writeFileSync(dest, loadTemplate(name), 'utf-8');
+    templateWriterSvc.writeTemplateIfMissing(workspaceRoot, name, instructDir);
 }
 function writeTemplate(workspaceRoot, name, instructDir = DEFAULT_INSTRUCT_DIR) {
-    const dest = path.join(workspaceRoot, instructDir, name);
-    fs.mkdirSync(path.dirname(dest), { recursive: true });
-    fs.writeFileSync(dest, loadTemplate(name), 'utf-8');
-    return dest;
+    return templateWriterSvc.writeTemplate(workspaceRoot, name, instructDir);
 }
 //# sourceMappingURL=load-template.js.map

package/src/load-template.js.map

@@ -1 +1 @@
-{"version":3,"file":"load-template.js","sourceRoot":"","sources":["../../../../../packages/tooling/rules-config/src/load-template.ts"],"names":[],"mappings":";;AAMA,oCAEC;AAED,wDASC;AAED,sCASC;;AA9BD,+CAAyB;AACzB,mDAA6B;AAE7B,MAAM,aAAa,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,EAAE,WAAW,CAAC,CAAC;AAC9D,MAAM,oBAAoB,GAAG,wBAAwB,CAAC;AAEtD,SAAgB,YAAY,CAAC,IAAY;IACrC,OAAO,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,IAAI,CAAC,EAAE,OAAO,CAAC,CAAC;AACpE,CAAC;AAED,SAAgB,sBAAsB,CAClC,aAAqB,EACrB,IAAY,EACZ,cAAsB,oBAAoB;IAE1C,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,WAAW,EAAE,IAAI,CAAC,CAAC;IACzD,IAAI,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC;QAAE,OAAO;IAChC,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACtD,EAAE,CAAC,aAAa,CAAC,IAAI,EAAE,YAAY,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC,CAAC;AACxD,CAAC;AAED,SAAgB,aAAa,CACzB,aAAqB,EACrB,IAAY,EACZ,cAAsB,oBAAoB;IAE1C,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,WAAW,EAAE,IAAI,CAAC,CAAC;IACzD,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACtD,EAAE,CAAC,aAAa,CAAC,IAAI,EAAE,YAAY,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC,CAAC;IACpD,OAAO,IAAI,CAAC;AAChB,CAAC","sourcesContent":["import * as fs from 'fs';\nimport * as path from 'path';\n\nconst TEMPLATES_DIR = path.join(__dirname, '..', 'templates');\nconst DEFAULT_INSTRUCT_DIR = '.webpieces/instruct-ai';\n\nexport function loadTemplate(name: string): string {\n    return fs.readFileSync(path.join(TEMPLATES_DIR, name), 'utf-8');\n}\n\nexport function writeTemplateIfMissing(\n    workspaceRoot: string,\n    name: string,\n    instructDir: string = DEFAULT_INSTRUCT_DIR\n): void {\n    const dest = path.join(workspaceRoot, instructDir, name);\n    if (fs.existsSync(dest)) return;\n    fs.mkdirSync(path.dirname(dest), { recursive: true });\n    fs.writeFileSync(dest, loadTemplate(name), 'utf-8');\n}\n\nexport function writeTemplate(\n    workspaceRoot: string,\n    name: string,\n    instructDir: string = DEFAULT_INSTRUCT_DIR\n): string {\n    const dest = path.join(workspaceRoot, instructDir, name);\n    fs.mkdirSync(path.dirname(dest), { recursive: true });\n    fs.writeFileSync(dest, loadTemplate(name), 'utf-8');\n    return dest;\n}\n"]}
+{"version":3,"file":"load-template.js","sourceRoot":"","sources":["../../../../../packages/tooling/rules-config/src/load-template.ts"],"names":[],"mappings":";;;AAqCA,oCAEC;AAED,wDAMC;AAED,sCAMC;;AAvDD,+CAAyB;AACzB,mDAA6B;AAC7B,0DAA2D;AAC3D,yCAAuC;AAEvC,MAAM,aAAa,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,EAAE,WAAW,CAAC,CAAC;AAC9D,MAAM,oBAAoB,GAAG,wBAAwB,CAAC;AAEtD;;;GAGG;AAGI,IAAM,cAAc,GAApB,MAAM,cAAc;IACvB,YAAY,CAAC,IAAY;QACrB,OAAO,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,IAAI,CAAC,EAAE,OAAO,CAAC,CAAC;IACpE,CAAC;IAED,sBAAsB,CAAC,aAAqB,EAAE,IAAY,EAAE,cAAsB,oBAAoB;QAClG,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,WAAW,EAAE,IAAI,CAAC,CAAC;QACzD,IAAI,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC;YAAE,OAAO;QAChC,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACtD,EAAE,CAAC,aAAa,CAAC,IAAI,EAAE,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC,CAAC;IAC7D,CAAC;IAED,aAAa,CAAC,aAAqB,EAAE,IAAY,EAAE,cAAsB,oBAAoB;QACzF,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,WAAW,EAAE,IAAI,CAAC,CAAC;QACzD,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACtD,EAAE,CAAC,aAAa,CAAC,IAAI,EAAE,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC,CAAC;QACzD,OAAO,IAAI,CAAC;IAChB,CAAC;CACJ,CAAA;AAlBY,wCAAc;yBAAd,cAAc;IAF1B,IAAA,+BAAgB,GAAE;IAClB,IAAA,sBAAU,GAAE;GACA,cAAc,CAkB1B;AAED,qGAAqG;AACrG,MAAM,iBAAiB,GAAG,IAAI,cAAc,EAAE,CAAC;AAE/C,SAAgB,YAAY,CAAC,IAAY;IACrC,OAAO,iBAAiB,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;AAChD,CAAC;AAED,SAAgB,sBAAsB,CAClC,aAAqB,EACrB,IAAY,EACZ,cAAsB,oBAAoB;IAE1C,iBAAiB,CAAC,sBAAsB,CAAC,aAAa,EAAE,IAAI,EAAE,WAAW,CAAC,CAAC;AAC/E,CAAC;AAED,SAAgB,aAAa,CACzB,aAAqB,EACrB,IAAY,EACZ,cAAsB,oBAAoB;IAE1C,OAAO,iBAAiB,CAAC,aAAa,CAAC,aAAa,EAAE,IAAI,EAAE,WAAW,CAAC,CAAC;AAC7E,CAAC","sourcesContent":["import * as fs from 'fs';\nimport * as path from 'path';\nimport { provideSingleton } from '@webpieces/core-context';\nimport { injectable } from 'inversify';\n\nconst TEMPLATES_DIR = path.join(__dirname, '..', 'templates');\nconst DEFAULT_INSTRUCT_DIR = '.webpieces/instruct-ai';\n\n/**\n * Writes the AI-facing instruct-ai template docs under `<workspaceRoot>/.webpieces/instruct-ai/`.\n * `@provideSingleton` so it can be injected and appear in the rules-config DI design.\n */\n@provideSingleton()\n@injectable()\nexport class TemplateWriter {\n    loadTemplate(name: string): string {\n        return fs.readFileSync(path.join(TEMPLATES_DIR, name), 'utf-8');\n    }\n\n    writeTemplateIfMissing(workspaceRoot: string, name: string, instructDir: string = DEFAULT_INSTRUCT_DIR): void {\n        const dest = path.join(workspaceRoot, instructDir, name);\n        if (fs.existsSync(dest)) return;\n        fs.mkdirSync(path.dirname(dest), { recursive: true });\n        fs.writeFileSync(dest, this.loadTemplate(name), 'utf-8');\n    }\n\n    writeTemplate(workspaceRoot: string, name: string, instructDir: string = DEFAULT_INSTRUCT_DIR): string {\n        const dest = path.join(workspaceRoot, instructDir, name);\n        fs.mkdirSync(path.dirname(dest), { recursive: true });\n        fs.writeFileSync(dest, this.loadTemplate(name), 'utf-8');\n        return dest;\n    }\n}\n\n// Temporary migration delegators — consumers migrate to injecting TemplateWriter over follow-up PRs.\nconst templateWriterSvc = new TemplateWriter();\n\nexport function loadTemplate(name: string): string {\n    return templateWriterSvc.loadTemplate(name);\n}\n\nexport function writeTemplateIfMissing(\n    workspaceRoot: string,\n    name: string,\n    instructDir: string = DEFAULT_INSTRUCT_DIR,\n): void {\n    templateWriterSvc.writeTemplateIfMissing(workspaceRoot, name, instructDir);\n}\n\nexport function writeTemplate(\n    workspaceRoot: string,\n    name: string,\n    instructDir: string = DEFAULT_INSTRUCT_DIR,\n): string {\n    return templateWriterSvc.writeTemplate(workspaceRoot, name, instructDir);\n}\n"]}

package/src/repo-root.js

@@ -4,6 +4,8 @@ exports.RepoRootFinder = exports.INSTRUCT_AI_DIR = void 0;
 const tslib_1 = require("tslib");
 const child_process_1 = require("child_process");
 const path = tslib_1.__importStar(require("path"));
+const core_context_1 = require("@webpieces/core-context");
+const inversify_1 = require("inversify");
 const config_file_1 = require("./config-file");
 const constants_1 = require("./constants");
 // The single instruct-ai home under `.webpieces/`. Kept here (not just in load-template) so callers
@@ -19,7 +21,7 @@ exports.INSTRUCT_AI_DIR = `${constants_1.WEBPIECES_TMP_DIR}/instruct-ai`;
  * writer of `.webpieces/...` (logs, instruct-ai docs, sync cache, merge/pr state) MUST anchor its
  * path here rather than at `process.cwd()`.
  */
-class RepoRootFinder {
+let RepoRootFinder = class RepoRootFinder {
     /**
      * The repo root for `startDir`. Resolution order (first hit wins):
      *   1. Directory holding webpieces.config.json — the webpieces workspace root, and the exact
@@ -59,6 +61,10 @@ class RepoRootFinder {
         const root = (r.stdout ?? '').trim();
         return root !== '' ? root : null;
     }
-}
+};
 exports.RepoRootFinder = RepoRootFinder;
+exports.RepoRootFinder = RepoRootFinder = tslib_1.__decorate([
+    (0, core_context_1.provideSingleton)(),
+    (0, inversify_1.injectable)()
+], RepoRootFinder);
 //# sourceMappingURL=repo-root.js.map

package/src/repo-root.js.map

@@ -1 +1 @@
-{"version":3,"file":"repo-root.js","sourceRoot":"","sources":["../../../../../packages/tooling/rules-config/src/repo-root.ts"],"names":[],"mappings":";;;;AAAA,iDAA0C;AAC1C,mDAA6B;AAE7B,+CAA+C;AAC/C,2CAAgD;AAEhD,oGAAoG;AACpG,0FAA0F;AAC7E,QAAA,eAAe,GAAG,GAAG,6BAAiB,cAAc,CAAC;AAElE;;;;;;;;;GASG;AACH,MAAa,cAAc;IACvB;;;;;;;OAOG;IACH,eAAe,CAAC,QAAgB;QAC5B,MAAM,UAAU,GAAG,IAAA,4BAAc,EAAC,QAAQ,CAAC,CAAC;QAC5C,IAAI,UAAU,KAAK,IAAI;YAAE,OAAO,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;QACzD,MAAM,OAAO,GAAG,IAAI,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC;QAC3C,IAAI,OAAO,KAAK,IAAI;YAAE,OAAO,OAAO,CAAC;QACrC,OAAO,QAAQ,CAAC;IACpB,CAAC;IAED;;;;OAIG;IACH,iBAAiB,CAAC,QAAgB,EAAE,OAAe;QAC/C,OAAO,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,uBAAe,EAAE,OAAO,CAAC,CAAC;IACzD,CAAC;IAED,gGAAgG;IAChG,WAAW,CAAC,QAAgB,EAAE,OAAe;QACzC,OAAO,IAAI,CAAC,iBAAiB,CAAC,IAAI,CAAC,eAAe,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC,CAAC;IAC3E,CAAC;IAED,gGAAgG;IAChG,6FAA6F;IAC7F,8FAA8F;IACtF,WAAW,CAAC,GAAW;QAC3B,MAAM,CAAC,GAAG,IAAA,yBAAS,EAAC,KAAK,EAAE,CAAC,IAAI,EAAE,GAAG,EAAE,WAAW,EAAE,iBAAiB,CAAC,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC,CAAC;QAC9F,IAAI,CAAC,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,IAAI,CAAC;QAChC,MAAM,IAAI,GAAG,CAAC,CAAC,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;QACrC,OAAO,IAAI,KAAK,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC;IACrC,CAAC;CACJ;AAxCD,wCAwCC","sourcesContent":["import { spawnSync } from 'child_process';\nimport * as path from 'path';\n\nimport { findConfigFile } from './config-file';\nimport { WEBPIECES_TMP_DIR } from './constants';\n\n// The single instruct-ai home under `.webpieces/`. Kept here (not just in load-template) so callers\n// building AI-facing messages can render the ABSOLUTE doc path from a resolved repo root.\nexport const INSTRUCT_AI_DIR = `${WEBPIECES_TMP_DIR}/instruct-ai`;\n\n/**\n * Resolves the single repo root that owns the `.webpieces/` tree, and renders absolute paths beneath\n * it.\n *\n * `.webpieces/` MUST live at the repo root — never in a CWD-dependent subdirectory. A tool invoked\n * from a subdir (a nested package, a `services/*` app) that naively joined `.webpieces` onto its own\n * cwd would scatter stray `.webpieces` trees across the tree — the exact bug this prevents. Every\n * writer of `.webpieces/...` (logs, instruct-ai docs, sync cache, merge/pr state) MUST anchor its\n * path here rather than at `process.cwd()`.\n */\nexport class RepoRootFinder {\n    /**\n     * The repo root for `startDir`. Resolution order (first hit wins):\n     *   1. Directory holding webpieces.config.json — the webpieces workspace root, and the exact\n     *      anchor the hook runner already uses. Walks UP from startDir, so a subdir resolves to root.\n     *   2. git toplevel (`git rev-parse --show-toplevel`) — the repo root when no config is present\n     *      yet (e.g. the installer runs before webpieces.config.json exists).\n     *   3. `startDir` — last resort (git unavailable / not a repo / no config). Best-effort only.\n     */\n    resolveRepoRoot(startDir: string): string {\n        const configPath = findConfigFile(startDir);\n        if (configPath !== null) return path.dirname(configPath);\n        const gitRoot = this.gitToplevel(startDir);\n        if (gitRoot !== null) return gitRoot;\n        return startDir;\n    }\n\n    /**\n     * Absolute path to an instruct-ai doc under `repoRoot`. Hand THIS to the AI in a violation/fix\n     * message — never a bare `.webpieces/instruct-ai/...` relative path, which an AI whose cwd is a\n     * subdirectory would resolve against the wrong directory and fail to open.\n     */\n    instructAiDocPath(repoRoot: string, docName: string): string {\n        return path.join(repoRoot, INSTRUCT_AI_DIR, docName);\n    }\n\n    /** Absolute instruct-ai doc path resolved directly from `startDir` (resolveRepoRoot + join). */\n    docPathFrom(startDir: string, docName: string): string {\n        return this.instructAiDocPath(this.resolveRepoRoot(startDir), docName);\n    }\n\n    // git repo root of `cwd`, or null when cwd is not in a git repo. `status !== 0` is the EXPECTED\n    // \"not a repo\" value (spawnSync does not throw on non-zero exit), so we never swallow a real\n    // failure with try/catch — a genuine git crash still surfaces. Mirrors runner.ts:gitToplevel.\n    private gitToplevel(cwd: string): string | null {\n        const r = spawnSync('git', ['-C', cwd, 'rev-parse', '--show-toplevel'], { encoding: 'utf8' });\n        if (r.status !== 0) return null;\n        const root = (r.stdout ?? '').trim();\n        return root !== '' ? root : null;\n    }\n}\n"]}
+{"version":3,"file":"repo-root.js","sourceRoot":"","sources":["../../../../../packages/tooling/rules-config/src/repo-root.ts"],"names":[],"mappings":";;;;AAAA,iDAA0C;AAC1C,mDAA6B;AAC7B,0DAA2D;AAC3D,yCAAuC;AAEvC,+CAA+C;AAC/C,2CAAgD;AAEhD,oGAAoG;AACpG,0FAA0F;AAC7E,QAAA,eAAe,GAAG,GAAG,6BAAiB,cAAc,CAAC;AAElE;;;;;;;;;GASG;AAGI,IAAM,cAAc,GAApB,MAAM,cAAc;IACvB;;;;;;;OAOG;IACH,eAAe,CAAC,QAAgB;QAC5B,MAAM,UAAU,GAAG,IAAA,4BAAc,EAAC,QAAQ,CAAC,CAAC;QAC5C,IAAI,UAAU,KAAK,IAAI;YAAE,OAAO,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;QACzD,MAAM,OAAO,GAAG,IAAI,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC;QAC3C,IAAI,OAAO,KAAK,IAAI;YAAE,OAAO,OAAO,CAAC;QACrC,OAAO,QAAQ,CAAC;IACpB,CAAC;IAED;;;;OAIG;IACH,iBAAiB,CAAC,QAAgB,EAAE,OAAe;QAC/C,OAAO,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,uBAAe,EAAE,OAAO,CAAC,CAAC;IACzD,CAAC;IAED,gGAAgG;IAChG,WAAW,CAAC,QAAgB,EAAE,OAAe;QACzC,OAAO,IAAI,CAAC,iBAAiB,CAAC,IAAI,CAAC,eAAe,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC,CAAC;IAC3E,CAAC;IAED,gGAAgG;IAChG,6FAA6F;IAC7F,8FAA8F;IACtF,WAAW,CAAC,GAAW;QAC3B,MAAM,CAAC,GAAG,IAAA,yBAAS,EAAC,KAAK,EAAE,CAAC,IAAI,EAAE,GAAG,EAAE,WAAW,EAAE,iBAAiB,CAAC,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC,CAAC;QAC9F,IAAI,CAAC,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,IAAI,CAAC;QAChC,MAAM,IAAI,GAAG,CAAC,CAAC,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;QACrC,OAAO,IAAI,KAAK,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC;IACrC,CAAC;CACJ,CAAA;AAxCY,wCAAc;yBAAd,cAAc;IAF1B,IAAA,+BAAgB,GAAE;IAClB,IAAA,sBAAU,GAAE;GACA,cAAc,CAwC1B","sourcesContent":["import { spawnSync } from 'child_process';\nimport * as path from 'path';\nimport { provideSingleton } from '@webpieces/core-context';\nimport { injectable } from 'inversify';\n\nimport { findConfigFile } from './config-file';\nimport { WEBPIECES_TMP_DIR } from './constants';\n\n// The single instruct-ai home under `.webpieces/`. Kept here (not just in load-template) so callers\n// building AI-facing messages can render the ABSOLUTE doc path from a resolved repo root.\nexport const INSTRUCT_AI_DIR = `${WEBPIECES_TMP_DIR}/instruct-ai`;\n\n/**\n * Resolves the single repo root that owns the `.webpieces/` tree, and renders absolute paths beneath\n * it.\n *\n * `.webpieces/` MUST live at the repo root — never in a CWD-dependent subdirectory. A tool invoked\n * from a subdir (a nested package, a `services/*` app) that naively joined `.webpieces` onto its own\n * cwd would scatter stray `.webpieces` trees across the tree — the exact bug this prevents. Every\n * writer of `.webpieces/...` (logs, instruct-ai docs, sync cache, merge/pr state) MUST anchor its\n * path here rather than at `process.cwd()`.\n */\n@provideSingleton()\n@injectable()\nexport class RepoRootFinder {\n    /**\n     * The repo root for `startDir`. Resolution order (first hit wins):\n     *   1. Directory holding webpieces.config.json — the webpieces workspace root, and the exact\n     *      anchor the hook runner already uses. Walks UP from startDir, so a subdir resolves to root.\n     *   2. git toplevel (`git rev-parse --show-toplevel`) — the repo root when no config is present\n     *      yet (e.g. the installer runs before webpieces.config.json exists).\n     *   3. `startDir` — last resort (git unavailable / not a repo / no config). Best-effort only.\n     */\n    resolveRepoRoot(startDir: string): string {\n        const configPath = findConfigFile(startDir);\n        if (configPath !== null) return path.dirname(configPath);\n        const gitRoot = this.gitToplevel(startDir);\n        if (gitRoot !== null) return gitRoot;\n        return startDir;\n    }\n\n    /**\n     * Absolute path to an instruct-ai doc under `repoRoot`. Hand THIS to the AI in a violation/fix\n     * message — never a bare `.webpieces/instruct-ai/...` relative path, which an AI whose cwd is a\n     * subdirectory would resolve against the wrong directory and fail to open.\n     */\n    instructAiDocPath(repoRoot: string, docName: string): string {\n        return path.join(repoRoot, INSTRUCT_AI_DIR, docName);\n    }\n\n    /** Absolute instruct-ai doc path resolved directly from `startDir` (resolveRepoRoot + join). */\n    docPathFrom(startDir: string, docName: string): string {\n        return this.instructAiDocPath(this.resolveRepoRoot(startDir), docName);\n    }\n\n    // git repo root of `cwd`, or null when cwd is not in a git repo. `status !== 0` is the EXPECTED\n    // \"not a repo\" value (spawnSync does not throw on non-zero exit), so we never swallow a real\n    // failure with try/catch — a genuine git crash still surfaces. Mirrors runner.ts:gitToplevel.\n    private gitToplevel(cwd: string): string | null {\n        const r = spawnSync('git', ['-C', cwd, 'rev-parse', '--show-toplevel'], { encoding: 'utf8' });\n        if (r.status !== 0) return null;\n        const root = (r.stdout ?? '').trim();\n        return root !== '' ? root : null;\n    }\n}\n"]}

package/src/rules-config-design.d.ts

@@ -0,0 +1,18 @@
+import { RepoRootFinder } from './repo-root';
+import { ConfigLoader } from './load-config';
+import { TemplateWriter } from './load-template';
+/**
+ * DI-design root for @webpieces/rules-config (role:designed-lib).
+ *
+ * `@DocumentDesign` marks the top of the DAG the DI-design analyzer roots on, so the library's design
+ * (design.json / design.md / design.html) is generated. rules-config is the shared foundation whose
+ * utilities are being migrated from free functions to injected `@provideSingleton` service classes; as
+ * each service class lands (config loader, template writer, diff/git services, …) it is injected HERE
+ * so it appears in the drawn design.
+ */
+export declare class RulesConfigDesign {
+    private readonly repoRootFinder;
+    private readonly configLoader;
+    private readonly templateWriter;
+    constructor(repoRootFinder: RepoRootFinder, configLoader: ConfigLoader, templateWriter: TemplateWriter);
+}

package/src/rules-config-design.js

@@ -0,0 +1,39 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RulesConfigDesign = void 0;
+const tslib_1 = require("tslib");
+const core_util_1 = require("@webpieces/core-util");
+const core_context_1 = require("@webpieces/core-context");
+const inversify_1 = require("inversify");
+const repo_root_1 = require("./repo-root");
+const load_config_1 = require("./load-config");
+const load_template_1 = require("./load-template");
+/**
+ * DI-design root for @webpieces/rules-config (role:designed-lib).
+ *
+ * `@DocumentDesign` marks the top of the DAG the DI-design analyzer roots on, so the library's design
+ * (design.json / design.md / design.html) is generated. rules-config is the shared foundation whose
+ * utilities are being migrated from free functions to injected `@provideSingleton` service classes; as
+ * each service class lands (config loader, template writer, diff/git services, …) it is injected HERE
+ * so it appears in the drawn design.
+ */
+let RulesConfigDesign = class RulesConfigDesign {
+    repoRootFinder;
+    configLoader;
+    templateWriter;
+    constructor(repoRootFinder, configLoader, templateWriter) {
+        this.repoRootFinder = repoRootFinder;
+        this.configLoader = configLoader;
+        this.templateWriter = templateWriter;
+    }
+};
+exports.RulesConfigDesign = RulesConfigDesign;
+exports.RulesConfigDesign = RulesConfigDesign = tslib_1.__decorate([
+    (0, core_util_1.DocumentDesign)(),
+    (0, core_context_1.provideSingleton)(),
+    (0, inversify_1.injectable)(),
+    tslib_1.__metadata("design:paramtypes", [repo_root_1.RepoRootFinder,
+        load_config_1.ConfigLoader,
+        load_template_1.TemplateWriter])
+], RulesConfigDesign);
+//# sourceMappingURL=rules-config-design.js.map

package/src/rules-config-design.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rules-config-design.js","sourceRoot":"","sources":["../../../../../packages/tooling/rules-config/src/rules-config-design.ts"],"names":[],"mappings":";;;;AAAA,oDAAsD;AACtD,0DAA2D;AAC3D,yCAAuC;AAEvC,2CAA6C;AAC7C,+CAA6C;AAC7C,mDAAiD;AAEjD;;;;;;;;GAQG;AAII,IAAM,iBAAiB,GAAvB,MAAM,iBAAiB;IAEL;IACA;IACA;IAHrB,YACqB,cAA8B,EAC9B,YAA0B,EAC1B,cAA8B;QAF9B,mBAAc,GAAd,cAAc,CAAgB;QAC9B,iBAAY,GAAZ,YAAY,CAAc;QAC1B,mBAAc,GAAd,cAAc,CAAgB;IAChD,CAAC;CACP,CAAA;AANY,8CAAiB;4BAAjB,iBAAiB;IAH7B,IAAA,0BAAc,GAAE;IAChB,IAAA,+BAAgB,GAAE;IAClB,IAAA,sBAAU,GAAE;6CAG4B,0BAAc;QAChB,0BAAY;QACV,8BAAc;GAJ1C,iBAAiB,CAM7B","sourcesContent":["import { DocumentDesign } from '@webpieces/core-util';\nimport { provideSingleton } from '@webpieces/core-context';\nimport { injectable } from 'inversify';\n\nimport { RepoRootFinder } from './repo-root';\nimport { ConfigLoader } from './load-config';\nimport { TemplateWriter } from './load-template';\n\n/**\n * DI-design root for @webpieces/rules-config (role:designed-lib).\n *\n * `@DocumentDesign` marks the top of the DAG the DI-design analyzer roots on, so the library's design\n * (design.json / design.md / design.html) is generated. rules-config is the shared foundation whose\n * utilities are being migrated from free functions to injected `@provideSingleton` service classes; as\n * each service class lands (config loader, template writer, diff/git services, …) it is injected HERE\n * so it appears in the drawn design.\n */\n@DocumentDesign()\n@provideSingleton()\n@injectable()\nexport class RulesConfigDesign {\n    constructor(\n        private readonly repoRootFinder: RepoRootFinder,\n        private readonly configLoader: ConfigLoader,\n        private readonly templateWriter: TemplateWriter,\n    ) {}\n}\n"]}