@webpieces/ai-hook-rules 0.4.847 → 0.4.849

package/src/core/rules/max-file-lines.js

@@ -8,26 +8,33 @@ const hook_runtime_3 = require("@webpieces/hook-runtime");
 const DEFAULT_LIMIT = 900;
 const INSTRUCT_FILE = 'webpieces.filesize.md';
 class MaxFileLinesRule extends hook_runtime_2.FileRuleBase {
-    constructor(config) { super(config, 'max-file-lines', 'max-file-lines'); }
+    constructor(config) {
+        super(config, 'max-file-lines', 'max-file-lines');
+    }
     description = 'Cap file length at a configured line limit.';
     files = ['**/*.ts', '**/*.tsx'];
     defaultOptions = { limit: DEFAULT_LIMIT, allowedPaths: [] };
     get fixHint() {
         return new hook_runtime_3.FixHint('File exceeds the max-file-lines limit.', 'Pick one:', [
             new rules_config_1.Option('Refactor to reduce the file size — READ the instruct-ai doc at the absolute path on the violation line above.', true),
-            new rules_config_1.Option('If this file is MACHINE-GENERATED and its size is not yours to control, add its tree to max-file-lines.allowedPaths in webpieces.config.json (the generated trees in GENERATED_CODE_PATHS are already exempt with no config at all). Never do this for hand-written code.'),
+            new rules_config_1.Option('If this file is MACHINE-GENERATED and its size is not yours to control, add its tree to max-file-lines.allowedPaths in {configFile} (the generated trees in GENERATED_CODE_PATHS are already exempt with no config at all). Never do this for hand-written code.'),
         ], new hook_runtime_3.DisableEscape(this.config.disableAllowed ?? true, '// eslint-disable-next-line @webpieces/max-file-lines  (also suppresses the eslint rule)'));
     }
     check(ctx) {
         const limit = this.config.limit ?? DEFAULT_LIMIT;
         // Machine-generated trees are exempt unconditionally; allowedPaths ADDS to that floor.
-        if ((0, rules_config_1.isPathExcluded)(ctx.relativePath, [...rules_config_1.GENERATED_CODE_PATHS, ...(this.config.allowedPaths ?? [])]))
+        if ((0, rules_config_1.isPathExcluded)(ctx.relativePath, [
+            ...rules_config_1.GENERATED_CODE_PATHS,
+            ...(this.config.allowedPaths ?? []),
+        ]))
             return [];
         if (ctx.projectedFileLines <= limit)
             return [];
         (0, rules_config_1.writeTemplateIfMissing)(ctx.workspaceRoot, INSTRUCT_FILE);
         const docPath = new rules_config_1.RepoRootFinder().instructAiDocPath(ctx.workspaceRoot, INSTRUCT_FILE);
-        return [new hook_runtime_1.Violation(1, `(projected ${String(ctx.projectedFileLines)} lines)`, `File will be ${String(ctx.projectedFileLines)} lines, exceeding the ${String(limit)}-line limit. READ ${docPath} for detailed refactoring instructions.`)];
+        return [
+            new hook_runtime_1.Violation(1, `(projected ${String(ctx.projectedFileLines)} lines)`, `File will be ${String(ctx.projectedFileLines)} lines, exceeding the ${String(limit)}-line limit. READ ${docPath} for detailed refactoring instructions.`),
+        ];
     }
 }
 exports.MaxFileLinesRule = MaxFileLinesRule;

package/src/core/rules/max-file-lines.js.map

@@ -1 +1 @@
-{"version":3,"file":"max-file-lines.js","sourceRoot":"","sources":["../../../../../../../packages/tooling/ai-hook-rules/src/core/rules/max-file-lines.ts"],"names":[],"mappings":";;;AACA,0DAA+H;AAG/H,0DAAyD;AACzD,0DAAuD;AACvD,0DAAiE;AAEjE,MAAM,aAAa,GAAG,GAAG,CAAC;AAC1B,MAAM,aAAa,GAAG,uBAAuB,CAAC;AAE9C,MAAa,gBAAiB,SAAQ,2BAAsC;IACxE,YAAY,MAAgC,IAAI,KAAK,CAAC,MAAM,EAAE,gBAAgB,EAAE,gBAAgB,CAAC,CAAC,CAAC,CAAC;IAE3F,WAAW,GAAG,6CAA6C,CAAC;IACnD,KAAK,GAAG,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC;IAChC,cAAc,GAAG,EAAE,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,EAAE,EAAE,CAAC;IAC9E,IAAI,OAAO;QACP,OAAO,IAAI,sBAAO,CACd,wCAAwC,EACxC,WAAW,EACX;YACI,IAAI,qBAAM,CAAC,+GAA+G,EAAE,IAAI,CAAC;YACjI,IAAI,qBAAM,CAAC,2QAA2Q,CAAC;SAC1R,EACD,IAAI,4BAAa,CAAC,IAAI,CAAC,MAAM,CAAC,cAAc,IAAI,IAAI,EAAE,0FAA0F,CAAC,CACpJ,CAAC;IACN,CAAC;IAED,KAAK,CAAC,GAAgB;QAClB,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,KAAK,IAAI,aAAa,CAAC;QACjD,uFAAuF;QACvF,IAAI,IAAA,6BAAc,EAAC,GAAG,CAAC,YAAY,EAAE,CAAC,GAAG,mCAAoB,EAAE,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,YAAY,IAAI,EAAE,CAAC,CAAC,CAAC;YAAE,OAAO,EAAE,CAAC;QAChH,IAAI,GAAG,CAAC,kBAAkB,IAAI,KAAK;YAAE,OAAO,EAAE,CAAC;QAC/C,IAAA,qCAAsB,EAAC,GAAG,CAAC,aAAa,EAAE,aAAa,CAAC,CAAC;QACzD,MAAM,OAAO,GAAG,IAAI,6BAAc,EAAE,CAAC,iBAAiB,CAAC,GAAG,CAAC,aAAa,EAAE,aAAa,CAAC,CAAC;QACzF,OAAO,CAAC,IAAI,wBAAC,CACT,CAAC,EACD,cAAc,MAAM,CAAC,GAAG,CAAC,kBAAkB,CAAC,SAAS,EACrD,gBAAgB,MAAM,CAAC,GAAG,CAAC,kBAAkB,CAAC,yBAAyB,MAAM,CAAC,KAAK,CAAC,qBAAqB,OAAO,yCAAyC,CAC5J,CAAC,CAAC;IACP,CAAC;CACJ;AA/BD,4CA+BC","sourcesContent":["import { SourceContributionConfig } from \"../source-contribution-config\";\nimport { writeTemplateIfMissing, RepoRootFinder, isPathExcluded, GENERATED_CODE_PATHS, Option } from \"@webpieces/rules-config\";\n\nimport type { FileContext, Violation } from '@webpieces/hook-runtime';\nimport { Violation as V } from '@webpieces/hook-runtime';\nimport { FileRuleBase } from '@webpieces/hook-runtime';\nimport { FixHint, DisableEscape } from '@webpieces/hook-runtime';\n\nconst DEFAULT_LIMIT = 900;\nconst INSTRUCT_FILE = 'webpieces.filesize.md';\n\nexport class MaxFileLinesRule extends FileRuleBase<SourceContributionConfig> {\n    constructor(config: SourceContributionConfig) { super(config, 'max-file-lines', 'max-file-lines'); }\n\n    readonly description = 'Cap file length at a configured line limit.';\n    override readonly files = ['**/*.ts', '**/*.tsx'];\n    override readonly defaultOptions = { limit: DEFAULT_LIMIT, allowedPaths: [] };\n    get fixHint(): FixHint {\n        return new FixHint(\n            'File exceeds the max-file-lines limit.',\n            'Pick one:',\n            [\n                new Option('Refactor to reduce the file size — READ the instruct-ai doc at the absolute path on the violation line above.', true),\n                new Option('If this file is MACHINE-GENERATED and its size is not yours to control, add its tree to max-file-lines.allowedPaths in webpieces.config.json (the generated trees in GENERATED_CODE_PATHS are already exempt with no config at all). Never do this for hand-written code.'),\n            ],\n            new DisableEscape(this.config.disableAllowed ?? true, '// eslint-disable-next-line @webpieces/max-file-lines  (also suppresses the eslint rule)'),\n        );\n    }\n\n    check(ctx: FileContext): readonly Violation[] {\n        const limit = this.config.limit ?? DEFAULT_LIMIT;\n        // Machine-generated trees are exempt unconditionally; allowedPaths ADDS to that floor.\n        if (isPathExcluded(ctx.relativePath, [...GENERATED_CODE_PATHS, ...(this.config.allowedPaths ?? [])])) return [];\n        if (ctx.projectedFileLines <= limit) return [];\n        writeTemplateIfMissing(ctx.workspaceRoot, INSTRUCT_FILE);\n        const docPath = new RepoRootFinder().instructAiDocPath(ctx.workspaceRoot, INSTRUCT_FILE);\n        return [new V(\n            1,\n            `(projected ${String(ctx.projectedFileLines)} lines)`,\n            `File will be ${String(ctx.projectedFileLines)} lines, exceeding the ${String(limit)}-line limit. READ ${docPath} for detailed refactoring instructions.`,\n        )];\n    }\n}\n"]}
+{"version":3,"file":"max-file-lines.js","sourceRoot":"","sources":["../../../../../../../packages/tooling/ai-hook-rules/src/core/rules/max-file-lines.ts"],"names":[],"mappings":";;;AACA,0DAMiC;AAGjC,0DAAyD;AACzD,0DAAuD;AACvD,0DAAiE;AAEjE,MAAM,aAAa,GAAG,GAAG,CAAC;AAC1B,MAAM,aAAa,GAAG,uBAAuB,CAAC;AAE9C,MAAa,gBAAiB,SAAQ,2BAAsC;IACxE,YAAY,MAAgC;QACxC,KAAK,CAAC,MAAM,EAAE,gBAAgB,EAAE,gBAAgB,CAAC,CAAC;IACtD,CAAC;IAEQ,WAAW,GAAG,6CAA6C,CAAC;IACnD,KAAK,GAAG,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC;IAChC,cAAc,GAAG,EAAE,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,EAAE,EAAE,CAAC;IAC9E,IAAI,OAAO;QACP,OAAO,IAAI,sBAAO,CACd,wCAAwC,EACxC,WAAW,EACX;YACI,IAAI,qBAAM,CACN,+GAA+G,EAC/G,IAAI,CACP;YACD,IAAI,qBAAM,CACN,kQAAkQ,CACrQ;SACJ,EACD,IAAI,4BAAa,CACb,IAAI,CAAC,MAAM,CAAC,cAAc,IAAI,IAAI,EAClC,0FAA0F,CAC7F,CACJ,CAAC;IACN,CAAC;IAED,KAAK,CAAC,GAAgB;QAClB,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,KAAK,IAAI,aAAa,CAAC;QACjD,uFAAuF;QACvF,IACI,IAAA,6BAAc,EAAC,GAAG,CAAC,YAAY,EAAE;YAC7B,GAAG,mCAAoB;YACvB,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,YAAY,IAAI,EAAE,CAAC;SACtC,CAAC;YAEF,OAAO,EAAE,CAAC;QACd,IAAI,GAAG,CAAC,kBAAkB,IAAI,KAAK;YAAE,OAAO,EAAE,CAAC;QAC/C,IAAA,qCAAsB,EAAC,GAAG,CAAC,aAAa,EAAE,aAAa,CAAC,CAAC;QACzD,MAAM,OAAO,GAAG,IAAI,6BAAc,EAAE,CAAC,iBAAiB,CAAC,GAAG,CAAC,aAAa,EAAE,aAAa,CAAC,CAAC;QACzF,OAAO;YACH,IAAI,wBAAC,CACD,CAAC,EACD,cAAc,MAAM,CAAC,GAAG,CAAC,kBAAkB,CAAC,SAAS,EACrD,gBAAgB,MAAM,CAAC,GAAG,CAAC,kBAAkB,CAAC,yBAAyB,MAAM,CAAC,KAAK,CAAC,qBAAqB,OAAO,yCAAyC,CAC5J;SACJ,CAAC;IACN,CAAC;CACJ;AAjDD,4CAiDC","sourcesContent":["import { SourceContributionConfig } from '../source-contribution-config';\nimport {\n    writeTemplateIfMissing,\n    RepoRootFinder,\n    isPathExcluded,\n    GENERATED_CODE_PATHS,\n    Option,\n} from '@webpieces/rules-config';\n\nimport type { FileContext, Violation } from '@webpieces/hook-runtime';\nimport { Violation as V } from '@webpieces/hook-runtime';\nimport { FileRuleBase } from '@webpieces/hook-runtime';\nimport { FixHint, DisableEscape } from '@webpieces/hook-runtime';\n\nconst DEFAULT_LIMIT = 900;\nconst INSTRUCT_FILE = 'webpieces.filesize.md';\n\nexport class MaxFileLinesRule extends FileRuleBase<SourceContributionConfig> {\n    constructor(config: SourceContributionConfig) {\n        super(config, 'max-file-lines', 'max-file-lines');\n    }\n\n    readonly description = 'Cap file length at a configured line limit.';\n    override readonly files = ['**/*.ts', '**/*.tsx'];\n    override readonly defaultOptions = { limit: DEFAULT_LIMIT, allowedPaths: [] };\n    get fixHint(): FixHint {\n        return new FixHint(\n            'File exceeds the max-file-lines limit.',\n            'Pick one:',\n            [\n                new Option(\n                    'Refactor to reduce the file size — READ the instruct-ai doc at the absolute path on the violation line above.',\n                    true,\n                ),\n                new Option(\n                    'If this file is MACHINE-GENERATED and its size is not yours to control, add its tree to max-file-lines.allowedPaths in {configFile} (the generated trees in GENERATED_CODE_PATHS are already exempt with no config at all). Never do this for hand-written code.',\n                ),\n            ],\n            new DisableEscape(\n                this.config.disableAllowed ?? true,\n                '// eslint-disable-next-line @webpieces/max-file-lines  (also suppresses the eslint rule)',\n            ),\n        );\n    }\n\n    check(ctx: FileContext): readonly Violation[] {\n        const limit = this.config.limit ?? DEFAULT_LIMIT;\n        // Machine-generated trees are exempt unconditionally; allowedPaths ADDS to that floor.\n        if (\n            isPathExcluded(ctx.relativePath, [\n                ...GENERATED_CODE_PATHS,\n                ...(this.config.allowedPaths ?? []),\n            ])\n        )\n            return [];\n        if (ctx.projectedFileLines <= limit) return [];\n        writeTemplateIfMissing(ctx.workspaceRoot, INSTRUCT_FILE);\n        const docPath = new RepoRootFinder().instructAiDocPath(ctx.workspaceRoot, INSTRUCT_FILE);\n        return [\n            new V(\n                1,\n                `(projected ${String(ctx.projectedFileLines)} lines)`,\n                `File will be ${String(ctx.projectedFileLines)} lines, exceeding the ${String(limit)}-line limit. READ ${docPath} for detailed refactoring instructions.`,\n            ),\n        ];\n    }\n}\n"]}

package/src/core/rules/no-custom-css.d.ts

@@ -1,4 +1,4 @@
-import { SourceContributionConfig } from "../source-contribution-config";
+import { SourceContributionConfig } from '../source-contribution-config';
 import type { EditContext, Violation } from '@webpieces/hook-runtime';
 import { EditRuleBase } from '@webpieces/hook-runtime';
 import { FixHint } from '@webpieces/hook-runtime';

package/src/core/rules/no-custom-css.js

@@ -29,7 +29,7 @@ class NoCustomCssRule extends hook_runtime_2.EditRuleBase {
             new rules_config_1.Option('Delete the CSS and use Tailwind utility classes (flex, grid, gap-4, text-red-600).', true),
             new rules_config_1.Option('Need a specific value? Use an arbitrary-value class: w-[240px], bg-[#fffde7], grid-cols-[2fr_2fr_48px].'),
             new rules_config_1.Option('Dynamic on/off? Prefer [class.x]="cond" over a style binding.'),
-            new rules_config_1.Option('Whole tree not yours to restyle (a vendored kit, a generated artifact)? Add a glob to no-custom-css.allowGlobs in webpieces.config.json — it exempts the path in the editor and in CI alike.'),
+            new rules_config_1.Option('Whole tree not yours to restyle (a vendored kit, a generated artifact)? Add a glob to no-custom-css.allowGlobs in {configFile} — it exempts the path in the editor and in CI alike.'),
         ], new hook_runtime_3.DisableEscape(this.config.disableAllowed ?? true, '// webpieces-disable no-custom-css -- <reason>'));
     }
     check(ctx) {
@@ -43,7 +43,7 @@ class NoCustomCssRule extends hook_runtime_2.EditRuleBase {
             if (!detail)
                 continue;
             const lineNum = i + 1;
-            if (disableAllowed && ctx.isLineDisabled(lineNum, "no-custom-css"))
+            if (disableAllowed && ctx.isLineDisabled(lineNum, 'no-custom-css'))
                 continue;
             violations.push(new hook_runtime_1.Violation(lineNum, `${detail}: ${ctx.lines[i]?.trim() ?? ''}`));
         }

package/src/core/rules/no-custom-css.js.map

@@ -1 +1 @@
-{"version":3,"file":"no-custom-css.js","sourceRoot":"","sources":["../../../../../../../packages/tooling/ai-hook-rules/src/core/rules/no-custom-css.ts"],"names":[],"mappings":"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","sourcesContent":["import { SourceContributionConfig } from \"../source-contribution-config\";\nimport { NoCustomCssScope, Option } from \"@webpieces/rules-config\";\n\nimport type { EditContext, Violation } from '@webpieces/hook-runtime';\nimport { Violation as V } from '@webpieces/hook-runtime';\nimport { EditRuleBase } from '@webpieces/hook-runtime';\nimport { FixHint, DisableEscape } from '@webpieces/hook-runtime';\n\n// Edit-time (regex/line) counterpart to the CI code-rule validate-no-custom-css. The hook has no TS\n// AST, so the `.ts` side matches the @Component style props by shape; the `.html` side matches inline\n// style attributes/bindings. Both are diff-precise via the hook's per-line edit context.\nconst RE_STYLE_URLS = /(^|\\s)styleUrls?\\s*:/; // styleUrls: / styleUrl:\nconst RE_STYLES_ARRAY = /(^|\\s)styles\\s*:\\s*\\[/; // styles: [ ... ] (component inline CSS)\nconst RE_INLINE_STYLE = /(^|\\s)style\\s*=\\s*[\"']/; // static style=\"…\"\nconst RE_NG_STYLE = /\\[?ngStyle\\]?\\s*=/; // [ngStyle]=\"…\"\nconst RE_STYLE_BINDING = /\\[style(?:\\.[\\w.-]+)?\\]/; // [style] / [style.width]\n\nexport class NoCustomCssRule extends EditRuleBase<SourceContributionConfig> {\n    // The SAME exemption the CI validator narrows its changed-file set with. Shared, because a second copy\n    // of this predicate is how `allowGlobs` came to be honoured here and ignored there.\n    private readonly pathScope: NoCustomCssScope;\n\n    constructor(config: SourceContributionConfig) {\n        super(config, 'no-custom-css', 'no-custom-css');\n        this.pathScope = new NoCustomCssScope(config);\n    }\n\n    readonly description =\n        'Ban hand-written CSS in Angular (styles/styleUrls in @Component, inline style=, [style.x], [ngStyle]) — style with Tailwind utility classes.';\n    override readonly files = ['**/*.ts', '**/*.tsx', '**/*.html'];\n    override readonly defaultOptions = { allowGlobs: [] };\n\n    get fixHint(): FixHint {\n        return new FixHint(\n            'Custom CSS bypasses Tailwind-first styling.',\n            'Pick one:',\n            [\n                new Option('Delete the CSS and use Tailwind utility classes (flex, grid, gap-4, text-red-600).', true),\n                new Option('Need a specific value? Use an arbitrary-value class: w-[240px], bg-[#fffde7], grid-cols-[2fr_2fr_48px].'),\n                new Option('Dynamic on/off? Prefer [class.x]=\"cond\" over a style binding.'),\n                new Option('Whole tree not yours to restyle (a vendored kit, a generated artifact)? Add a glob to no-custom-css.allowGlobs in webpieces.config.json — it exempts the path in the editor and in CI alike.'),\n            ],\n            new DisableEscape(this.config.disableAllowed ?? true, '// webpieces-disable no-custom-css -- <reason>'),\n        );\n    }\n\n    check(ctx: EditContext): readonly Violation[] {\n        if (this.pathScope.isExempt(ctx.relativePath)) return [];\n\n        const isHtml = ctx.relativePath.endsWith('.html');\n        const disableAllowed = this.config.disableAllowed ?? true;\n        const violations: V[] = [];\n        for (let i = 0; i < ctx.strippedLines.length; i += 1) {\n            const detail = this.detailForLine(ctx.strippedLines[i] ?? '', isHtml);\n            if (!detail) continue;\n            const lineNum = i + 1;\n            if (disableAllowed && ctx.isLineDisabled(lineNum, \"no-custom-css\")) continue;\n            violations.push(new V(lineNum, `${detail}: ${ctx.lines[i]?.trim() ?? ''}`));\n        }\n        return violations;\n    }\n\n    /** The banned-pattern label for a line, or '' when clean. Branches on the file being a template. */\n    private detailForLine(line: string, isHtml: boolean): string {\n        if (isHtml) {\n            if (RE_NG_STYLE.test(line)) return 'inline `[ngStyle]`';\n            if (RE_STYLE_BINDING.test(line)) return 'inline `[style.x]` binding';\n            if (RE_INLINE_STYLE.test(line)) return 'inline `style=` attribute';\n            return '';\n        }\n        if (RE_STYLE_URLS.test(line)) return '`styleUrls`/`styleUrl` in @Component';\n        if (RE_STYLES_ARRAY.test(line)) return '`styles` block in @Component';\n        return '';\n    }\n}\n"]}
+{"version":3,"file":"no-custom-css.js","sourceRoot":"","sources":["../../../../../../../packages/tooling/ai-hook-rules/src/core/rules/no-custom-css.ts"],"names":[],"mappings":";;;AACA,0DAAmE;AAGnE,0DAAyD;AACzD,0DAAuD;AACvD,0DAAiE;AAEjE,oGAAoG;AACpG,sGAAsG;AACtG,yFAAyF;AACzF,MAAM,aAAa,GAAG,sBAAsB,CAAC,CAAC,yBAAyB;AACvE,MAAM,eAAe,GAAG,uBAAuB,CAAC,CAAC,yCAAyC;AAC1F,MAAM,eAAe,GAAG,wBAAwB,CAAC,CAAC,mBAAmB;AACrE,MAAM,WAAW,GAAG,mBAAmB,CAAC,CAAC,gBAAgB;AACzD,MAAM,gBAAgB,GAAG,yBAAyB,CAAC,CAAC,0BAA0B;AAE9E,MAAa,eAAgB,SAAQ,2BAAsC;IACvE,uGAAuG;IACvG,oFAAoF;IACnE,SAAS,CAAmB;IAE7C,YAAY,MAAgC;QACxC,KAAK,CAAC,MAAM,EAAE,eAAe,EAAE,eAAe,CAAC,CAAC;QAChD,IAAI,CAAC,SAAS,GAAG,IAAI,+BAAgB,CAAC,MAAM,CAAC,CAAC;IAClD,CAAC;IAEQ,WAAW,GAChB,8IAA8I,CAAC;IACjI,KAAK,GAAG,CAAC,SAAS,EAAE,UAAU,EAAE,WAAW,CAAC,CAAC;IAC7C,cAAc,GAAG,EAAE,UAAU,EAAE,EAAE,EAAE,CAAC;IAEtD,IAAI,OAAO;QACP,OAAO,IAAI,sBAAO,CACd,6CAA6C,EAC7C,WAAW,EACX;YACI,IAAI,qBAAM,CACN,oFAAoF,EACpF,IAAI,CACP;YACD,IAAI,qBAAM,CACN,yGAAyG,CAC5G;YACD,IAAI,qBAAM,CAAC,+DAA+D,CAAC;YAC3E,IAAI,qBAAM,CACN,qLAAqL,CACxL;SACJ,EACD,IAAI,4BAAa,CACb,IAAI,CAAC,MAAM,CAAC,cAAc,IAAI,IAAI,EAClC,gDAAgD,CACnD,CACJ,CAAC;IACN,CAAC;IAED,KAAK,CAAC,GAAgB;QAClB,IAAI,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,GAAG,CAAC,YAAY,CAAC;YAAE,OAAO,EAAE,CAAC;QAEzD,MAAM,MAAM,GAAG,GAAG,CAAC,YAAY,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;QAClD,MAAM,cAAc,GAAG,IAAI,CAAC,MAAM,CAAC,cAAc,IAAI,IAAI,CAAC;QAC1D,MAAM,UAAU,GAAQ,EAAE,CAAC;QAC3B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,GAAG,CAAC,aAAa,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;YACnD,MAAM,MAAM,GAAG,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,EAAE,EAAE,MAAM,CAAC,CAAC;YACtE,IAAI,CAAC,MAAM;gBAAE,SAAS;YACtB,MAAM,OAAO,GAAG,CAAC,GAAG,CAAC,CAAC;YACtB,IAAI,cAAc,IAAI,GAAG,CAAC,cAAc,CAAC,OAAO,EAAE,eAAe,CAAC;gBAAE,SAAS;YAC7E,UAAU,CAAC,IAAI,CAAC,IAAI,wBAAC,CAAC,OAAO,EAAE,GAAG,MAAM,KAAK,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC;QAChF,CAAC;QACD,OAAO,UAAU,CAAC;IACtB,CAAC;IAED,oGAAoG;IAC5F,aAAa,CAAC,IAAY,EAAE,MAAe;QAC/C,IAAI,MAAM,EAAE,CAAC;YACT,IAAI,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC;gBAAE,OAAO,oBAAoB,CAAC;YACxD,IAAI,gBAAgB,CAAC,IAAI,CAAC,IAAI,CAAC;gBAAE,OAAO,4BAA4B,CAAC;YACrE,IAAI,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC;gBAAE,OAAO,2BAA2B,CAAC;YACnE,OAAO,EAAE,CAAC;QACd,CAAC;QACD,IAAI,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC;YAAE,OAAO,sCAAsC,CAAC;QAC5E,IAAI,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC;YAAE,OAAO,8BAA8B,CAAC;QACtE,OAAO,EAAE,CAAC;IACd,CAAC;CACJ;AAnED,0CAmEC","sourcesContent":["import { SourceContributionConfig } from '../source-contribution-config';\nimport { NoCustomCssScope, Option } from '@webpieces/rules-config';\n\nimport type { EditContext, Violation } from '@webpieces/hook-runtime';\nimport { Violation as V } from '@webpieces/hook-runtime';\nimport { EditRuleBase } from '@webpieces/hook-runtime';\nimport { FixHint, DisableEscape } from '@webpieces/hook-runtime';\n\n// Edit-time (regex/line) counterpart to the CI code-rule validate-no-custom-css. The hook has no TS\n// AST, so the `.ts` side matches the @Component style props by shape; the `.html` side matches inline\n// style attributes/bindings. Both are diff-precise via the hook's per-line edit context.\nconst RE_STYLE_URLS = /(^|\\s)styleUrls?\\s*:/; // styleUrls: / styleUrl:\nconst RE_STYLES_ARRAY = /(^|\\s)styles\\s*:\\s*\\[/; // styles: [ ... ] (component inline CSS)\nconst RE_INLINE_STYLE = /(^|\\s)style\\s*=\\s*[\"']/; // static style=\"…\"\nconst RE_NG_STYLE = /\\[?ngStyle\\]?\\s*=/; // [ngStyle]=\"…\"\nconst RE_STYLE_BINDING = /\\[style(?:\\.[\\w.-]+)?\\]/; // [style] / [style.width]\n\nexport class NoCustomCssRule extends EditRuleBase<SourceContributionConfig> {\n    // The SAME exemption the CI validator narrows its changed-file set with. Shared, because a second copy\n    // of this predicate is how `allowGlobs` came to be honoured here and ignored there.\n    private readonly pathScope: NoCustomCssScope;\n\n    constructor(config: SourceContributionConfig) {\n        super(config, 'no-custom-css', 'no-custom-css');\n        this.pathScope = new NoCustomCssScope(config);\n    }\n\n    readonly description =\n        'Ban hand-written CSS in Angular (styles/styleUrls in @Component, inline style=, [style.x], [ngStyle]) — style with Tailwind utility classes.';\n    override readonly files = ['**/*.ts', '**/*.tsx', '**/*.html'];\n    override readonly defaultOptions = { allowGlobs: [] };\n\n    get fixHint(): FixHint {\n        return new FixHint(\n            'Custom CSS bypasses Tailwind-first styling.',\n            'Pick one:',\n            [\n                new Option(\n                    'Delete the CSS and use Tailwind utility classes (flex, grid, gap-4, text-red-600).',\n                    true,\n                ),\n                new Option(\n                    'Need a specific value? Use an arbitrary-value class: w-[240px], bg-[#fffde7], grid-cols-[2fr_2fr_48px].',\n                ),\n                new Option('Dynamic on/off? Prefer [class.x]=\"cond\" over a style binding.'),\n                new Option(\n                    'Whole tree not yours to restyle (a vendored kit, a generated artifact)? Add a glob to no-custom-css.allowGlobs in {configFile} — it exempts the path in the editor and in CI alike.',\n                ),\n            ],\n            new DisableEscape(\n                this.config.disableAllowed ?? true,\n                '// webpieces-disable no-custom-css -- <reason>',\n            ),\n        );\n    }\n\n    check(ctx: EditContext): readonly Violation[] {\n        if (this.pathScope.isExempt(ctx.relativePath)) return [];\n\n        const isHtml = ctx.relativePath.endsWith('.html');\n        const disableAllowed = this.config.disableAllowed ?? true;\n        const violations: V[] = [];\n        for (let i = 0; i < ctx.strippedLines.length; i += 1) {\n            const detail = this.detailForLine(ctx.strippedLines[i] ?? '', isHtml);\n            if (!detail) continue;\n            const lineNum = i + 1;\n            if (disableAllowed && ctx.isLineDisabled(lineNum, 'no-custom-css')) continue;\n            violations.push(new V(lineNum, `${detail}: ${ctx.lines[i]?.trim() ?? ''}`));\n        }\n        return violations;\n    }\n\n    /** The banned-pattern label for a line, or '' when clean. Branches on the file being a template. */\n    private detailForLine(line: string, isHtml: boolean): string {\n        if (isHtml) {\n            if (RE_NG_STYLE.test(line)) return 'inline `[ngStyle]`';\n            if (RE_STYLE_BINDING.test(line)) return 'inline `[style.x]` binding';\n            if (RE_INLINE_STYLE.test(line)) return 'inline `style=` attribute';\n            return '';\n        }\n        if (RE_STYLE_URLS.test(line)) return '`styleUrls`/`styleUrl` in @Component';\n        if (RE_STYLES_ARRAY.test(line)) return '`styles` block in @Component';\n        return '';\n    }\n}\n"]}

package/src/core/rules/no-destructure.d.ts

@@ -1,4 +1,4 @@
-import { SourceContributionConfig } from "../source-contribution-config";
+import { SourceContributionConfig } from '../source-contribution-config';
 import type { EditContext, Violation } from '@webpieces/hook-runtime';
 import { EditRuleBase } from '@webpieces/hook-runtime';
 import { FixHint } from '@webpieces/hook-runtime';

package/src/core/rules/no-destructure.js

@@ -7,14 +7,16 @@ const hook_runtime_2 = require("@webpieces/hook-runtime");
 const hook_runtime_3 = require("@webpieces/hook-runtime");
 const VARIABLE_DESTRUCTURE = /\b(?:const|let|var)\s*\{/;
 class NoDestructureRule extends hook_runtime_2.EditRuleBase {
-    constructor(config) { super(config, 'no-destructure', 'no-destructure'); }
+    constructor(config) {
+        super(config, 'no-destructure', 'no-destructure');
+    }
     description = 'Disallow destructuring patterns. Assign the whole result and pass it around or access properties explicitly.';
     files = ['**/*.ts', '**/*.tsx'];
     defaultOptions = { allowTopLevel: true, allowedPaths: [] };
     get fixHint() {
         return new hook_runtime_3.FixHint('Destructuring pattern on a call result.', 'Pick one:', [
             new rules_config_1.Option('Assign the whole result instead: const obj = methodCall(); then pass obj around or use obj.x.', true),
-            new rules_config_1.Option('If this whole tree is destructuring by construction (a React/React Native component or hook tree), add a glob to no-destructure.allowedPaths in webpieces.config.json'),
+            new rules_config_1.Option('If this whole tree is destructuring by construction (a React/React Native component or hook tree), add a glob to no-destructure.allowedPaths in {configFile}'),
         ], new hook_runtime_3.DisableEscape(this.config.disableAllowed ?? true, '// webpieces-disable no-destructure -- <reason>'));
     }
     check(ctx) {
@@ -28,7 +30,7 @@ class NoDestructureRule extends hook_runtime_2.EditRuleBase {
             if (!VARIABLE_DESTRUCTURE.test(stripped))
                 continue;
             const lineNum = i + 1;
-            if (disableAllowed && ctx.isLineDisabled(lineNum, "no-destructure"))
+            if (disableAllowed && ctx.isLineDisabled(lineNum, 'no-destructure'))
                 continue;
             violations.push(new hook_runtime_1.Violation(lineNum, ctx.lines[i].trim()));
         }

package/src/core/rules/no-destructure.js.map

@@ -1 +1 @@
-{"version":3,"file":"no-destructure.js","sourceRoot":"","sources":["../../../../../../../packages/tooling/ai-hook-rules/src/core/rules/no-destructure.ts"],"names":[],"mappings":";;;AACA,0DAAiE;AAGjE,0DAAyD;AACzD,0DAAuD;AACvD,0DAAiE;AAEjE,MAAM,oBAAoB,GAAG,0BAA0B,CAAC;AAExD,MAAa,iBAAkB,SAAQ,2BAAsC;IACzE,YAAY,MAAgC,IAAI,KAAK,CAAC,MAAM,EAAE,gBAAgB,EAAE,gBAAgB,CAAC,CAAC,CAAC,CAAC;IAE3F,WAAW,GAAG,8GAA8G,CAAC;IACpH,KAAK,GAAG,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC;IAChC,cAAc,GAAG,EAAE,aAAa,EAAE,IAAI,EAAE,YAAY,EAAE,EAAE,EAAE,CAAC;IAC7E,IAAI,OAAO;QACP,OAAO,IAAI,sBAAO,CACd,yCAAyC,EACzC,WAAW,EACX;YACI,IAAI,qBAAM,CAAC,+FAA+F,EAAE,IAAI,CAAC;YACjH,IAAI,qBAAM,CAAC,uKAAuK,CAAC;SACtL,EACD,IAAI,4BAAa,CAAC,IAAI,CAAC,MAAM,CAAC,cAAc,IAAI,IAAI,EAAE,iDAAiD,CAAC,CAC3G,CAAC;IACN,CAAC;IAED,KAAK,CAAC,GAAgB;QAClB,MAAM,YAAY,GAAG,IAAI,CAAC,MAAM,CAAC,YAAY,IAAI,EAAE,CAAC;QACpD,IAAI,IAAA,6BAAc,EAAC,GAAG,CAAC,YAAY,EAAE,YAAY,CAAC;YAAE,OAAO,EAAE,CAAC;QAE9D,MAAM,cAAc,GAAG,IAAI,CAAC,MAAM,CAAC,cAAc,IAAI,IAAI,CAAC;QAC1D,MAAM,UAAU,GAAQ,EAAE,CAAC;QAC3B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,GAAG,CAAC,aAAa,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;YACnD,MAAM,QAAQ,GAAG,GAAG,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC;YACtC,IAAI,CAAC,oBAAoB,CAAC,IAAI,CAAC,QAAQ,CAAC;gBAAE,SAAS;YACnD,MAAM,OAAO,GAAG,CAAC,GAAG,CAAC,CAAC;YACtB,IAAI,cAAc,IAAI,GAAG,CAAC,cAAc,CAAC,OAAO,EAAE,gBAAgB,CAAC;gBAAE,SAAS;YAC9E,UAAU,CAAC,IAAI,CAAC,IAAI,wBAAC,CAAC,OAAO,EAAE,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;QACzD,CAAC;QACD,OAAO,UAAU,CAAC;IACtB,CAAC;CACJ;AAjCD,8CAiCC","sourcesContent":["import { SourceContributionConfig } from \"../source-contribution-config\";\nimport { isPathExcluded, Option } from \"@webpieces/rules-config\";\n\nimport type { EditContext, Violation } from '@webpieces/hook-runtime';\nimport { Violation as V } from '@webpieces/hook-runtime';\nimport { EditRuleBase } from '@webpieces/hook-runtime';\nimport { FixHint, DisableEscape } from '@webpieces/hook-runtime';\n\nconst VARIABLE_DESTRUCTURE = /\\b(?:const|let|var)\\s*\\{/;\n\nexport class NoDestructureRule extends EditRuleBase<SourceContributionConfig> {\n    constructor(config: SourceContributionConfig) { super(config, 'no-destructure', 'no-destructure'); }\n\n    readonly description = 'Disallow destructuring patterns. Assign the whole result and pass it around or access properties explicitly.';\n    override readonly files = ['**/*.ts', '**/*.tsx'];\n    override readonly defaultOptions = { allowTopLevel: true, allowedPaths: [] };\n    get fixHint(): FixHint {\n        return new FixHint(\n            'Destructuring pattern on a call result.',\n            'Pick one:',\n            [\n                new Option('Assign the whole result instead: const obj = methodCall(); then pass obj around or use obj.x.', true),\n                new Option('If this whole tree is destructuring by construction (a React/React Native component or hook tree), add a glob to no-destructure.allowedPaths in webpieces.config.json'),\n            ],\n            new DisableEscape(this.config.disableAllowed ?? true, '// webpieces-disable no-destructure -- <reason>'),\n        );\n    }\n\n    check(ctx: EditContext): readonly Violation[] {\n        const allowedPaths = this.config.allowedPaths ?? [];\n        if (isPathExcluded(ctx.relativePath, allowedPaths)) return [];\n\n        const disableAllowed = this.config.disableAllowed ?? true;\n        const violations: V[] = [];\n        for (let i = 0; i < ctx.strippedLines.length; i += 1) {\n            const stripped = ctx.strippedLines[i];\n            if (!VARIABLE_DESTRUCTURE.test(stripped)) continue;\n            const lineNum = i + 1;\n            if (disableAllowed && ctx.isLineDisabled(lineNum, \"no-destructure\")) continue;\n            violations.push(new V(lineNum, ctx.lines[i].trim()));\n        }\n        return violations;\n    }\n}\n"]}
+{"version":3,"file":"no-destructure.js","sourceRoot":"","sources":["../../../../../../../packages/tooling/ai-hook-rules/src/core/rules/no-destructure.ts"],"names":[],"mappings":";;;AACA,0DAAiE;AAGjE,0DAAyD;AACzD,0DAAuD;AACvD,0DAAiE;AAEjE,MAAM,oBAAoB,GAAG,0BAA0B,CAAC;AAExD,MAAa,iBAAkB,SAAQ,2BAAsC;IACzE,YAAY,MAAgC;QACxC,KAAK,CAAC,MAAM,EAAE,gBAAgB,EAAE,gBAAgB,CAAC,CAAC;IACtD,CAAC;IAEQ,WAAW,GAChB,8GAA8G,CAAC;IACjG,KAAK,GAAG,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC;IAChC,cAAc,GAAG,EAAE,aAAa,EAAE,IAAI,EAAE,YAAY,EAAE,EAAE,EAAE,CAAC;IAC7E,IAAI,OAAO;QACP,OAAO,IAAI,sBAAO,CACd,yCAAyC,EACzC,WAAW,EACX;YACI,IAAI,qBAAM,CACN,+FAA+F,EAC/F,IAAI,CACP;YACD,IAAI,qBAAM,CACN,8JAA8J,CACjK;SACJ,EACD,IAAI,4BAAa,CACb,IAAI,CAAC,MAAM,CAAC,cAAc,IAAI,IAAI,EAClC,iDAAiD,CACpD,CACJ,CAAC;IACN,CAAC;IAED,KAAK,CAAC,GAAgB;QAClB,MAAM,YAAY,GAAG,IAAI,CAAC,MAAM,CAAC,YAAY,IAAI,EAAE,CAAC;QACpD,IAAI,IAAA,6BAAc,EAAC,GAAG,CAAC,YAAY,EAAE,YAAY,CAAC;YAAE,OAAO,EAAE,CAAC;QAE9D,MAAM,cAAc,GAAG,IAAI,CAAC,MAAM,CAAC,cAAc,IAAI,IAAI,CAAC;QAC1D,MAAM,UAAU,GAAQ,EAAE,CAAC;QAC3B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,GAAG,CAAC,aAAa,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;YACnD,MAAM,QAAQ,GAAG,GAAG,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC;YACtC,IAAI,CAAC,oBAAoB,CAAC,IAAI,CAAC,QAAQ,CAAC;gBAAE,SAAS;YACnD,MAAM,OAAO,GAAG,CAAC,GAAG,CAAC,CAAC;YACtB,IAAI,cAAc,IAAI,GAAG,CAAC,cAAc,CAAC,OAAO,EAAE,gBAAgB,CAAC;gBAAE,SAAS;YAC9E,UAAU,CAAC,IAAI,CAAC,IAAI,wBAAC,CAAC,OAAO,EAAE,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;QACzD,CAAC;QACD,OAAO,UAAU,CAAC;IACtB,CAAC;CACJ;AA5CD,8CA4CC","sourcesContent":["import { SourceContributionConfig } from '../source-contribution-config';\nimport { isPathExcluded, Option } from '@webpieces/rules-config';\n\nimport type { EditContext, Violation } from '@webpieces/hook-runtime';\nimport { Violation as V } from '@webpieces/hook-runtime';\nimport { EditRuleBase } from '@webpieces/hook-runtime';\nimport { FixHint, DisableEscape } from '@webpieces/hook-runtime';\n\nconst VARIABLE_DESTRUCTURE = /\\b(?:const|let|var)\\s*\\{/;\n\nexport class NoDestructureRule extends EditRuleBase<SourceContributionConfig> {\n    constructor(config: SourceContributionConfig) {\n        super(config, 'no-destructure', 'no-destructure');\n    }\n\n    readonly description =\n        'Disallow destructuring patterns. Assign the whole result and pass it around or access properties explicitly.';\n    override readonly files = ['**/*.ts', '**/*.tsx'];\n    override readonly defaultOptions = { allowTopLevel: true, allowedPaths: [] };\n    get fixHint(): FixHint {\n        return new FixHint(\n            'Destructuring pattern on a call result.',\n            'Pick one:',\n            [\n                new Option(\n                    'Assign the whole result instead: const obj = methodCall(); then pass obj around or use obj.x.',\n                    true,\n                ),\n                new Option(\n                    'If this whole tree is destructuring by construction (a React/React Native component or hook tree), add a glob to no-destructure.allowedPaths in {configFile}',\n                ),\n            ],\n            new DisableEscape(\n                this.config.disableAllowed ?? true,\n                '// webpieces-disable no-destructure -- <reason>',\n            ),\n        );\n    }\n\n    check(ctx: EditContext): readonly Violation[] {\n        const allowedPaths = this.config.allowedPaths ?? [];\n        if (isPathExcluded(ctx.relativePath, allowedPaths)) return [];\n\n        const disableAllowed = this.config.disableAllowed ?? true;\n        const violations: V[] = [];\n        for (let i = 0; i < ctx.strippedLines.length; i += 1) {\n            const stripped = ctx.strippedLines[i];\n            if (!VARIABLE_DESTRUCTURE.test(stripped)) continue;\n            const lineNum = i + 1;\n            if (disableAllowed && ctx.isLineDisabled(lineNum, 'no-destructure')) continue;\n            violations.push(new V(lineNum, ctx.lines[i].trim()));\n        }\n        return violations;\n    }\n}\n"]}

package/src/core/rules/no-js-files.d.ts

@@ -1,4 +1,4 @@
-import { NoJsFilesConfig } from "../../configs/rule-configs";
+import { NoJsFilesConfig } from '../../configs/rule-configs';
 import type { FileContext, Violation } from '@webpieces/hook-runtime';
 import { FileRuleBase } from '@webpieces/hook-runtime';
 import { FixHint } from '@webpieces/hook-runtime';

package/src/core/rules/no-js-files.js

@@ -6,13 +6,15 @@ const hook_runtime_1 = require("@webpieces/hook-runtime");
 const hook_runtime_2 = require("@webpieces/hook-runtime");
 const hook_runtime_3 = require("@webpieces/hook-runtime");
 class NoJsFilesRule extends hook_runtime_2.FileRuleBase {
-    constructor(config) { super(config, 'no-js-files', 'no-js-files'); }
+    constructor(config) {
+        super(config, 'no-js-files', 'no-js-files');
+    }
     description = 'Disallow writing new .js/.jsx files. Use .ts/.tsx instead.';
     files = ['**/*.js', '**/*.jsx'];
     defaultOptions = { allowedPaths: [] };
     fixHint = new hook_runtime_3.FixHint('Writing .js/.jsx files is not allowed. Use .ts/.tsx instead.', 'Pick one:', [
         new rules_config_1.Option('Write a .ts or .tsx file instead of .js/.jsx.', true),
-        new rules_config_1.Option('If this path must be .js (generated/legacy), add it to no-js-files.allowedPaths in webpieces.config.json'),
+        new rules_config_1.Option('If this path must be .js (generated/legacy), add it to no-js-files.allowedPaths in {configFile}'),
     ]);
     check(ctx) {
         if (ctx.tool !== 'Write')

package/src/core/rules/no-js-files.js.map

@@ -1 +1 @@
-{"version":3,"file":"no-js-files.js","sourceRoot":"","sources":["../../../../../../../packages/tooling/ai-hook-rules/src/core/rules/no-js-files.ts"],"names":[],"mappings":";;;AAAA,0DAAiE;AAIjE,0DAAyD;AACzD,0DAAuD;AACvD,0DAAkD;AAElD,MAAa,aAAc,SAAQ,2BAA6B;IAC5D,YAAY,MAAuB,IAAI,KAAK,CAAC,MAAM,EAAE,aAAa,EAAE,aAAa,CAAC,CAAC,CAAC,CAAC;IAE5E,WAAW,GAAG,4DAA4D,CAAC;IAClE,KAAK,GAAG,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC;IAChC,cAAc,GAAG,EAAE,YAAY,EAAE,EAAE,EAAE,CAAC;IAC/C,OAAO,GAAG,IAAI,sBAAO,CAC1B,8DAA8D,EAC9D,WAAW,EACX;QACI,IAAI,qBAAM,CAAC,+CAA+C,EAAE,IAAI,CAAC;QACjE,IAAI,qBAAM,CAAC,0GAA0G,CAAC;KACzH,CACJ,CAAC;IAEF,KAAK,CAAC,GAAgB;QAClB,IAAI,GAAG,CAAC,IAAI,KAAK,OAAO;YAAE,OAAO,EAAE,CAAC;QAEpC,MAAM,YAAY,GAAG,IAAI,CAAC,MAAM,CAAC,YAAY,IAAI,EAAE,CAAC;QAEpD,IAAI,IAAA,6BAAc,EAAC,GAAG,CAAC,YAAY,EAAE,YAAY,CAAC;YAAE,OAAO,EAAE,CAAC;QAE9D,OAAO,CAAC,IAAI,wBAAC,CAAC,CAAC,EAAE,GAAG,CAAC,YAAY,CAAC,CAAC,CAAC;IACxC,CAAC;CACJ;AAxBD,sCAwBC","sourcesContent":["import { isPathExcluded, Option } from \"@webpieces/rules-config\";\nimport { NoJsFilesConfig } from \"../../configs/rule-configs\";\n\nimport type { FileContext, Violation } from '@webpieces/hook-runtime';\nimport { Violation as V } from '@webpieces/hook-runtime';\nimport { FileRuleBase } from '@webpieces/hook-runtime';\nimport { FixHint } from '@webpieces/hook-runtime';\n\nexport class NoJsFilesRule extends FileRuleBase<NoJsFilesConfig> {\n    constructor(config: NoJsFilesConfig) { super(config, 'no-js-files', 'no-js-files'); }\n\n    readonly description = 'Disallow writing new .js/.jsx files. Use .ts/.tsx instead.';\n    override readonly files = ['**/*.js', '**/*.jsx'];\n    override readonly defaultOptions = { allowedPaths: [] };\n    readonly fixHint = new FixHint(\n        'Writing .js/.jsx files is not allowed. Use .ts/.tsx instead.',\n        'Pick one:',\n        [\n            new Option('Write a .ts or .tsx file instead of .js/.jsx.', true),\n            new Option('If this path must be .js (generated/legacy), add it to no-js-files.allowedPaths in webpieces.config.json'),\n        ],\n    );\n\n    check(ctx: FileContext): readonly Violation[] {\n        if (ctx.tool !== 'Write') return [];\n\n        const allowedPaths = this.config.allowedPaths ?? [];\n\n        if (isPathExcluded(ctx.relativePath, allowedPaths)) return [];\n\n        return [new V(1, ctx.relativePath)];\n    }\n}\n"]}
+{"version":3,"file":"no-js-files.js","sourceRoot":"","sources":["../../../../../../../packages/tooling/ai-hook-rules/src/core/rules/no-js-files.ts"],"names":[],"mappings":";;;AAAA,0DAAiE;AAIjE,0DAAyD;AACzD,0DAAuD;AACvD,0DAAkD;AAElD,MAAa,aAAc,SAAQ,2BAA6B;IAC5D,YAAY,MAAuB;QAC/B,KAAK,CAAC,MAAM,EAAE,aAAa,EAAE,aAAa,CAAC,CAAC;IAChD,CAAC;IAEQ,WAAW,GAAG,4DAA4D,CAAC;IAClE,KAAK,GAAG,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC;IAChC,cAAc,GAAG,EAAE,YAAY,EAAE,EAAE,EAAE,CAAC;IAC/C,OAAO,GAAG,IAAI,sBAAO,CAC1B,8DAA8D,EAC9D,WAAW,EACX;QACI,IAAI,qBAAM,CAAC,+CAA+C,EAAE,IAAI,CAAC;QACjE,IAAI,qBAAM,CACN,iGAAiG,CACpG;KACJ,CACJ,CAAC;IAEF,KAAK,CAAC,GAAgB;QAClB,IAAI,GAAG,CAAC,IAAI,KAAK,OAAO;YAAE,OAAO,EAAE,CAAC;QAEpC,MAAM,YAAY,GAAG,IAAI,CAAC,MAAM,CAAC,YAAY,IAAI,EAAE,CAAC;QAEpD,IAAI,IAAA,6BAAc,EAAC,GAAG,CAAC,YAAY,EAAE,YAAY,CAAC;YAAE,OAAO,EAAE,CAAC;QAE9D,OAAO,CAAC,IAAI,wBAAC,CAAC,CAAC,EAAE,GAAG,CAAC,YAAY,CAAC,CAAC,CAAC;IACxC,CAAC;CACJ;AA5BD,sCA4BC","sourcesContent":["import { isPathExcluded, Option } from '@webpieces/rules-config';\nimport { NoJsFilesConfig } from '../../configs/rule-configs';\n\nimport type { FileContext, Violation } from '@webpieces/hook-runtime';\nimport { Violation as V } from '@webpieces/hook-runtime';\nimport { FileRuleBase } from '@webpieces/hook-runtime';\nimport { FixHint } from '@webpieces/hook-runtime';\n\nexport class NoJsFilesRule extends FileRuleBase<NoJsFilesConfig> {\n    constructor(config: NoJsFilesConfig) {\n        super(config, 'no-js-files', 'no-js-files');\n    }\n\n    readonly description = 'Disallow writing new .js/.jsx files. Use .ts/.tsx instead.';\n    override readonly files = ['**/*.js', '**/*.jsx'];\n    override readonly defaultOptions = { allowedPaths: [] };\n    readonly fixHint = new FixHint(\n        'Writing .js/.jsx files is not allowed. Use .ts/.tsx instead.',\n        'Pick one:',\n        [\n            new Option('Write a .ts or .tsx file instead of .js/.jsx.', true),\n            new Option(\n                'If this path must be .js (generated/legacy), add it to no-js-files.allowedPaths in {configFile}',\n            ),\n        ],\n    );\n\n    check(ctx: FileContext): readonly Violation[] {\n        if (ctx.tool !== 'Write') return [];\n\n        const allowedPaths = this.config.allowedPaths ?? [];\n\n        if (isPathExcluded(ctx.relativePath, allowedPaths)) return [];\n\n        return [new V(1, ctx.relativePath)];\n    }\n}\n"]}

package/src/core/rules/validate-ts-in-src.d.ts

@@ -1,4 +1,4 @@
-import { ValidateTsInSrcConfig } from "../../configs/rule-configs";
+import { ValidateTsInSrcConfig } from '../../configs/rule-configs';
 import type { FileContext, Violation } from '@webpieces/hook-runtime';
 import { FileRuleBase } from '@webpieces/hook-runtime';
 import { FixHint } from '@webpieces/hook-runtime';

package/src/core/rules/validate-ts-in-src.js

@@ -9,8 +9,12 @@ const hook_runtime_1 = require("@webpieces/hook-runtime");
 const hook_runtime_2 = require("@webpieces/hook-runtime");
 const hook_runtime_3 = require("@webpieces/hook-runtime");
 const DEFAULT_EXCLUDE_PATHS = [
-    'node_modules', 'dist', '.nx', '.git',
-    '**/*.d.ts', '**/jest.config.ts',
+    'node_modules',
+    'dist',
+    '.nx',
+    '.git',
+    '**/*.d.ts',
+    '**/jest.config.ts',
 ];
 const DEFAULT_ALLOWED_ROOT_FILES = ['jest.setup.ts'];
 function findProjectRoot(filePath, workspaceRoot) {
@@ -23,16 +27,18 @@ function findProjectRoot(filePath, workspaceRoot) {
     return null;
 }
 class ValidateTsInSrcRule extends hook_runtime_2.FileRuleBase {
-    constructor(config) { super(config, 'validate-ts-in-src', 'validate-ts-in-src'); }
-    description = 'Every .ts file must belong to a project\'s src/ directory.';
+    constructor(config) {
+        super(config, 'validate-ts-in-src', 'validate-ts-in-src');
+    }
+    description = "Every .ts file must belong to a project's src/ directory.";
     files = ['**/*.ts', '**/*.tsx'];
     defaultOptions = {
         excludePaths: DEFAULT_EXCLUDE_PATHS,
         allowedRootFiles: DEFAULT_ALLOWED_ROOT_FILES,
     };
     fixHint = new hook_runtime_3.FixHint('TypeScript file is outside a project src/ directory.', 'Fix by one of:', [
-        new rules_config_1.Option('Move the file into an existing project\'s src/ directory, or create a new project with project.json that owns the directory.', true),
-        new rules_config_1.Option('Add a dir or glob (e.g. "**/codegen.ts") to validate-ts-in-src.excludePaths in webpieces.config.json'),
+        new rules_config_1.Option("Move the file into an existing project's src/ directory, or create a new project with project.json that owns the directory.", true),
+        new rules_config_1.Option('Add a dir or glob (e.g. "**/codegen.ts") to validate-ts-in-src.excludePaths in {configFile}'),
     ]);
     check(ctx) {
         if (ctx.tool !== 'Write')
@@ -47,12 +53,16 @@ class ValidateTsInSrcRule extends hook_runtime_2.FileRuleBase {
             return [];
         const projectRoot = findProjectRoot(ctx.filePath, ctx.targetRoot);
         if (!projectRoot) {
-            return [new hook_runtime_1.Violation(1, ctx.targetRelativePath, 'File is not inside any Nx project. Move it into a project\'s src/ directory.')];
+            return [
+                new hook_runtime_1.Violation(1, ctx.targetRelativePath, "File is not inside any Nx project. Move it into a project's src/ directory."),
+            ];
         }
         const relToProject = path.relative(projectRoot, ctx.filePath);
         if (!relToProject.startsWith('src' + path.sep) && relToProject !== 'src') {
             const projectName = path.relative(ctx.targetRoot, projectRoot);
-            return [new hook_runtime_1.Violation(1, ctx.targetRelativePath, `File is inside project \`${projectName}\` but outside its src/ directory. Move it into src/.`)];
+            return [
+                new hook_runtime_1.Violation(1, ctx.targetRelativePath, `File is inside project \`${projectName}\` but outside its src/ directory. Move it into src/.`),
+            ];
         }
         return [];
     }

package/src/core/rules/validate-ts-in-src.js.map

@@ -1 +1 @@
-{"version":3,"file":"validate-ts-in-src.js","sourceRoot":"","sources":["../../../../../../../packages/tooling/ai-hook-rules/src/core/rules/validate-ts-in-src.ts"],"names":[],"mappings":"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","sourcesContent":["import * as fs from 'fs';\nimport * as path from 'path';\n\nimport { isPathExcluded, Option } from \"@webpieces/rules-config\";\nimport { ValidateTsInSrcConfig } from \"../../configs/rule-configs\";\n\nimport type { FileContext, Violation } from '@webpieces/hook-runtime';\nimport { Violation as V } from '@webpieces/hook-runtime';\nimport { FileRuleBase } from '@webpieces/hook-runtime';\nimport { FixHint } from '@webpieces/hook-runtime';\n\nconst DEFAULT_EXCLUDE_PATHS = [\n    'node_modules', 'dist', '.nx', '.git',\n    '**/*.d.ts', '**/jest.config.ts',\n];\nconst DEFAULT_ALLOWED_ROOT_FILES = ['jest.setup.ts'];\n\nfunction findProjectRoot(filePath: string, workspaceRoot: string): string | null {\n    let dir = path.dirname(filePath);\n    while (dir !== workspaceRoot && dir.startsWith(workspaceRoot)) {\n        if (fs.existsSync(path.join(dir, 'project.json'))) return dir;\n        dir = path.dirname(dir);\n    }\n    return null;\n}\n\nexport class ValidateTsInSrcRule extends FileRuleBase<ValidateTsInSrcConfig> {\n    constructor(config: ValidateTsInSrcConfig) { super(config, 'validate-ts-in-src', 'validate-ts-in-src'); }\n\n    readonly description = 'Every .ts file must belong to a project\\'s src/ directory.';\n    override readonly files = ['**/*.ts', '**/*.tsx'];\n    override readonly defaultOptions = {\n        excludePaths: DEFAULT_EXCLUDE_PATHS,\n        allowedRootFiles: DEFAULT_ALLOWED_ROOT_FILES,\n    };\n    readonly fixHint = new FixHint(\n        'TypeScript file is outside a project src/ directory.',\n        'Fix by one of:',\n        [\n            new Option('Move the file into an existing project\\'s src/ directory, or create a new project with project.json that owns the directory.', true),\n            new Option('Add a dir or glob (e.g. \"**/codegen.ts\") to validate-ts-in-src.excludePaths in webpieces.config.json'),\n        ],\n    );\n\n    check(ctx: FileContext): readonly Violation[] {\n        if (ctx.tool !== 'Write') return [];\n\n        const excludePaths = this.config.excludePaths ?? DEFAULT_EXCLUDE_PATHS;\n        const allowedRootFiles = this.config.allowedRootFiles ?? DEFAULT_ALLOWED_ROOT_FILES;\n\n        // Holistic exclusion (Layer 1 + Layer 2): bare dir names + globs.\n        if (isPathExcluded(ctx.targetRelativePath, excludePaths)) return [];\n\n        const relParts = ctx.targetRelativePath.split(path.sep);\n        if (relParts.length === 1 && allowedRootFiles.indexOf(relParts[0] ?? '') >= 0) return [];\n\n        const projectRoot = findProjectRoot(ctx.filePath, ctx.targetRoot);\n\n        if (!projectRoot) {\n            return [new V(\n                1,\n                ctx.targetRelativePath,\n                'File is not inside any Nx project. Move it into a project\\'s src/ directory.',\n            )];\n        }\n\n        const relToProject = path.relative(projectRoot, ctx.filePath);\n        if (!relToProject.startsWith('src' + path.sep) && relToProject !== 'src') {\n            const projectName = path.relative(ctx.targetRoot, projectRoot);\n            return [new V(\n                1,\n                ctx.targetRelativePath,\n                `File is inside project \\`${projectName}\\` but outside its src/ directory. Move it into src/.`,\n            )];\n        }\n\n        return [];\n    }\n}\n"]}
+{"version":3,"file":"validate-ts-in-src.js","sourceRoot":"","sources":["../../../../../../../packages/tooling/ai-hook-rules/src/core/rules/validate-ts-in-src.ts"],"names":[],"mappings":";;;;AAAA,+CAAyB;AACzB,mDAA6B;AAE7B,0DAAiE;AAIjE,0DAAyD;AACzD,0DAAuD;AACvD,0DAAkD;AAElD,MAAM,qBAAqB,GAAG;IAC1B,cAAc;IACd,MAAM;IACN,KAAK;IACL,MAAM;IACN,WAAW;IACX,mBAAmB;CACtB,CAAC;AACF,MAAM,0BAA0B,GAAG,CAAC,eAAe,CAAC,CAAC;AAErD,SAAS,eAAe,CAAC,QAAgB,EAAE,aAAqB;IAC5D,IAAI,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IACjC,OAAO,GAAG,KAAK,aAAa,IAAI,GAAG,CAAC,UAAU,CAAC,aAAa,CAAC,EAAE,CAAC;QAC5D,IAAI,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,cAAc,CAAC,CAAC;YAAE,OAAO,GAAG,CAAC;QAC9D,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IAC5B,CAAC;IACD,OAAO,IAAI,CAAC;AAChB,CAAC;AAED,MAAa,mBAAoB,SAAQ,2BAAmC;IACxE,YAAY,MAA6B;QACrC,KAAK,CAAC,MAAM,EAAE,oBAAoB,EAAE,oBAAoB,CAAC,CAAC;IAC9D,CAAC;IAEQ,WAAW,GAAG,2DAA2D,CAAC;IACjE,KAAK,GAAG,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC;IAChC,cAAc,GAAG;QAC/B,YAAY,EAAE,qBAAqB;QACnC,gBAAgB,EAAE,0BAA0B;KAC/C,CAAC;IACO,OAAO,GAAG,IAAI,sBAAO,CAC1B,sDAAsD,EACtD,gBAAgB,EAChB;QACI,IAAI,qBAAM,CACN,6HAA6H,EAC7H,IAAI,CACP;QACD,IAAI,qBAAM,CACN,6FAA6F,CAChG;KACJ,CACJ,CAAC;IAEF,KAAK,CAAC,GAAgB;QAClB,IAAI,GAAG,CAAC,IAAI,KAAK,OAAO;YAAE,OAAO,EAAE,CAAC;QAEpC,MAAM,YAAY,GAAG,IAAI,CAAC,MAAM,CAAC,YAAY,IAAI,qBAAqB,CAAC;QACvE,MAAM,gBAAgB,GAAG,IAAI,CAAC,MAAM,CAAC,gBAAgB,IAAI,0BAA0B,CAAC;QAEpF,kEAAkE;QAClE,IAAI,IAAA,6BAAc,EAAC,GAAG,CAAC,kBAAkB,EAAE,YAAY,CAAC;YAAE,OAAO,EAAE,CAAC;QAEpE,MAAM,QAAQ,GAAG,GAAG,CAAC,kBAAkB,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACxD,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,IAAI,gBAAgB,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,IAAI,CAAC;YAAE,OAAO,EAAE,CAAC;QAEzF,MAAM,WAAW,GAAG,eAAe,CAAC,GAAG,CAAC,QAAQ,EAAE,GAAG,CAAC,UAAU,CAAC,CAAC;QAElE,IAAI,CAAC,WAAW,EAAE,CAAC;YACf,OAAO;gBACH,IAAI,wBAAC,CACD,CAAC,EACD,GAAG,CAAC,kBAAkB,EACtB,6EAA6E,CAChF;aACJ,CAAC;QACN,CAAC;QAED,MAAM,YAAY,GAAG,IAAI,CAAC,QAAQ,CAAC,WAAW,EAAE,GAAG,CAAC,QAAQ,CAAC,CAAC;QAC9D,IAAI,CAAC,YAAY,CAAC,UAAU,CAAC,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,YAAY,KAAK,KAAK,EAAE,CAAC;YACvE,MAAM,WAAW,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,UAAU,EAAE,WAAW,CAAC,CAAC;YAC/D,OAAO;gBACH,IAAI,wBAAC,CACD,CAAC,EACD,GAAG,CAAC,kBAAkB,EACtB,4BAA4B,WAAW,uDAAuD,CACjG;aACJ,CAAC;QACN,CAAC;QAED,OAAO,EAAE,CAAC;IACd,CAAC;CACJ;AA/DD,kDA+DC","sourcesContent":["import * as fs from 'fs';\nimport * as path from 'path';\n\nimport { isPathExcluded, Option } from '@webpieces/rules-config';\nimport { ValidateTsInSrcConfig } from '../../configs/rule-configs';\n\nimport type { FileContext, Violation } from '@webpieces/hook-runtime';\nimport { Violation as V } from '@webpieces/hook-runtime';\nimport { FileRuleBase } from '@webpieces/hook-runtime';\nimport { FixHint } from '@webpieces/hook-runtime';\n\nconst DEFAULT_EXCLUDE_PATHS = [\n    'node_modules',\n    'dist',\n    '.nx',\n    '.git',\n    '**/*.d.ts',\n    '**/jest.config.ts',\n];\nconst DEFAULT_ALLOWED_ROOT_FILES = ['jest.setup.ts'];\n\nfunction findProjectRoot(filePath: string, workspaceRoot: string): string | null {\n    let dir = path.dirname(filePath);\n    while (dir !== workspaceRoot && dir.startsWith(workspaceRoot)) {\n        if (fs.existsSync(path.join(dir, 'project.json'))) return dir;\n        dir = path.dirname(dir);\n    }\n    return null;\n}\n\nexport class ValidateTsInSrcRule extends FileRuleBase<ValidateTsInSrcConfig> {\n    constructor(config: ValidateTsInSrcConfig) {\n        super(config, 'validate-ts-in-src', 'validate-ts-in-src');\n    }\n\n    readonly description = \"Every .ts file must belong to a project's src/ directory.\";\n    override readonly files = ['**/*.ts', '**/*.tsx'];\n    override readonly defaultOptions = {\n        excludePaths: DEFAULT_EXCLUDE_PATHS,\n        allowedRootFiles: DEFAULT_ALLOWED_ROOT_FILES,\n    };\n    readonly fixHint = new FixHint(\n        'TypeScript file is outside a project src/ directory.',\n        'Fix by one of:',\n        [\n            new Option(\n                \"Move the file into an existing project's src/ directory, or create a new project with project.json that owns the directory.\",\n                true,\n            ),\n            new Option(\n                'Add a dir or glob (e.g. \"**/codegen.ts\") to validate-ts-in-src.excludePaths in {configFile}',\n            ),\n        ],\n    );\n\n    check(ctx: FileContext): readonly Violation[] {\n        if (ctx.tool !== 'Write') return [];\n\n        const excludePaths = this.config.excludePaths ?? DEFAULT_EXCLUDE_PATHS;\n        const allowedRootFiles = this.config.allowedRootFiles ?? DEFAULT_ALLOWED_ROOT_FILES;\n\n        // Holistic exclusion (Layer 1 + Layer 2): bare dir names + globs.\n        if (isPathExcluded(ctx.targetRelativePath, excludePaths)) return [];\n\n        const relParts = ctx.targetRelativePath.split(path.sep);\n        if (relParts.length === 1 && allowedRootFiles.indexOf(relParts[0] ?? '') >= 0) return [];\n\n        const projectRoot = findProjectRoot(ctx.filePath, ctx.targetRoot);\n\n        if (!projectRoot) {\n            return [\n                new V(\n                    1,\n                    ctx.targetRelativePath,\n                    \"File is not inside any Nx project. Move it into a project's src/ directory.\",\n                ),\n            ];\n        }\n\n        const relToProject = path.relative(projectRoot, ctx.filePath);\n        if (!relToProject.startsWith('src' + path.sep) && relToProject !== 'src') {\n            const projectName = path.relative(ctx.targetRoot, projectRoot);\n            return [\n                new V(\n                    1,\n                    ctx.targetRelativePath,\n                    `File is inside project \\`${projectName}\\` but outside its src/ directory. Move it into src/.`,\n                ),\n            ];\n        }\n\n        return [];\n    }\n}\n"]}

package/src/core/runner.d.ts

@@ -1,9 +1,9 @@
 import { LoadedConfig } from '@webpieces/rules-config';
 import { Rule, HookRuleSet, ToolKind, NormalizedToolInput, HookMode, BlockedResult } from '@webpieces/hook-runtime';
 export declare class SourceHookRuleSet extends HookRuleSet {
-    readonly builtInRules: readonly Rule[];
-    readonly extensionRules: readonly Rule[];
-    constructor(builtInRules: readonly Rule[], extensionRules: readonly Rule[], configuredRules: readonly Rule[]);
+    readonly contributedRules: readonly Rule[];
+    readonly matchRules: readonly Rule[];
+    constructor(contributedRules: readonly Rule[], matchRules: readonly Rule[]);
 }
 export declare class SourceHookRules {
     load(loaded: LoadedConfig): SourceHookRuleSet;

package/src/core/runner.js

@@ -2,26 +2,24 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.SourceHookRules = exports.SourceHookRuleSet = void 0;
 exports.run = run;
-const tslib_1 = require("tslib");
-const path = tslib_1.__importStar(require("path"));
+const rule_runtime_1 = require("../rule-runtime");
 const rules_config_1 = require("@webpieces/rules-config");
 const hook_runtime_1 = require("@webpieces/hook-runtime");
 const load_rules_1 = require("./load-rules");
 class SourceHookRuleSet extends hook_runtime_1.HookRuleSet {
-    builtInRules;
-    extensionRules;
-    constructor(builtInRules, extensionRules, configuredRules) {
-        super([...builtInRules, ...extensionRules], configuredRules);
-        this.builtInRules = builtInRules;
-        this.extensionRules = extensionRules;
+    contributedRules;
+    matchRules;
+    constructor(contributedRules, matchRules) {
+        super([...contributedRules, ...matchRules]);
+        this.contributedRules = contributedRules;
+        this.matchRules = matchRules;
     }
 }
 exports.SourceHookRuleSet = SourceHookRuleSet;
 class SourceHookRules {
     load(loaded) {
-        const builtIns = (0, load_rules_1.loadBuiltInRules)(loaded.rulesConfig);
-        const custom = (0, load_rules_1.loadCustomRules)(loaded.rulesConfig, path.dirname(loaded.configPath ?? ''));
-        return new SourceHookRuleSet(builtIns, [...custom, ...(0, load_rules_1.loadMatchRules)(loaded.matchRules)], [...builtIns, ...custom]);
+        const builtIns = new hook_runtime_1.HookPolicyContributions(new Map([['@webpieces/ai-hook-rules/rule-runtime', new rule_runtime_1.SourceRuleRuntime()]])).load(loaded, 'source-hook');
+        return new SourceHookRuleSet(builtIns, (0, load_rules_1.loadMatchRules)(loaded.matchRules));
     }
 }
 exports.SourceHookRules = SourceHookRules;
@@ -29,9 +27,15 @@ exports.SourceHookRules = SourceHookRules;
 function run(toolKind, input, cwd, mode = 'rules') {
     if (mode === 'guards')
         return null;
+    if (toolKind !== 'Delete' &&
+        (new rules_config_1.ConfigRepairAccess().isRepairFile(new rules_config_1.RepoRootFinder().resolveRepoRoot(cwd), input.filePath) ||
+            (0, hook_runtime_1.isRootManifest)(input.filePath) ||
+            new rules_config_1.HomeConfigService().isHomeConfigPath(input.filePath)))
+        return null;
     const loaded = (0, rules_config_1.loadAndValidate)(cwd);
     if (loaded.configPath === null)
-        return new hook_runtime_1.BlockedResult(rules_config_1.CONFIG_MISSING_REPORT + (0, rules_config_1.guardMatrixPointer)((0, rules_config_1.writeGuardMatrixDoc)(new rules_config_1.RepoRootFinder().resolveRepoRoot(cwd))), rules_config_1.L0_FAULT_CONFIG_MISSING);
+        return new hook_runtime_1.BlockedResult(rules_config_1.CONFIG_MISSING_REPORT +
+            (0, rules_config_1.guardMatrixPointer)((0, rules_config_1.writeGuardMatrixDoc)(new rules_config_1.RepoRootFinder().resolveRepoRoot(cwd))), rules_config_1.L0_FAULT_CONFIG_MISSING);
     return new hook_runtime_1.HookFileEvaluation().evaluate(toolKind, input, loaded, new SourceHookRules().load(loaded));
 }
 //# sourceMappingURL=runner.js.map

package/src/core/runner.js.map

@@ -1 +1 @@
-{"version":3,"file":"runner.js","sourceRoot":"","sources":["../../../../../../packages/tooling/ai-hook-rules/src/core/runner.ts"],"names":[],"mappings":";;;AAoBA,kBAKC;;AAzBD,mDAA6B;AAC7B,0DAAiL;AACjL,0DAAwI;AACxI,6CAAiF;AAEjF,MAAa,iBAAkB,SAAQ,0BAAW;IACzB;IAAwC;IAA7D,YAAqB,YAA6B,EAAW,cAA+B,EAAE,eAAgC;QAC1H,KAAK,CAAC,CAAC,GAAG,YAAY,EAAE,GAAG,cAAc,CAAC,EAAE,eAAe,CAAC,CAAC;QAD5C,iBAAY,GAAZ,YAAY,CAAiB;QAAW,mBAAc,GAAd,cAAc,CAAiB;IAE5F,CAAC;CACJ;AAJD,8CAIC;AAED,MAAa,eAAe;IACxB,IAAI,CAAC,MAAoB;QACrB,MAAM,QAAQ,GAAG,IAAA,6BAAgB,EAAC,MAAM,CAAC,WAAW,CAAC,CAAC;QACtD,MAAM,MAAM,GAAG,IAAA,4BAAe,EAAC,MAAM,CAAC,WAAW,EAAE,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,UAAU,IAAI,EAAE,CAAC,CAAC,CAAC;QAC1F,OAAO,IAAI,iBAAiB,CAAC,QAAQ,EAAE,CAAC,GAAG,MAAM,EAAE,GAAG,IAAA,2BAAc,EAAC,MAAM,CAAC,UAAU,CAAC,CAAC,EAAE,CAAC,GAAG,QAAQ,EAAE,GAAG,MAAM,CAAC,CAAC,CAAC;IACxH,CAAC;CACJ;AAND,0CAMC;AAED,kGAAkG;AAClG,SAAgB,GAAG,CAAC,QAAkB,EAAE,KAA0B,EAAE,GAAW,EAAE,OAAiB,OAAO;IACrG,IAAI,IAAI,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC;IACnC,MAAM,MAAM,GAAG,IAAA,8BAAe,EAAC,GAAG,CAAC,CAAC;IACpC,IAAI,MAAM,CAAC,UAAU,KAAK,IAAI;QAAE,OAAO,IAAI,4BAAa,CAAC,oCAAqB,GAAG,IAAA,iCAAkB,EAAC,IAAA,kCAAmB,EAAC,IAAI,6BAAc,EAAE,CAAC,eAAe,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,sCAAuB,CAAC,CAAC;IAC9L,OAAO,IAAI,iCAAkB,EAAE,CAAC,QAAQ,CAAC,QAAQ,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,eAAe,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC;AAC1G,CAAC","sourcesContent":["import * as path from 'path';\nimport { loadAndValidate, LoadedConfig, CONFIG_MISSING_REPORT, L0_FAULT_CONFIG_MISSING, RepoRootFinder, writeGuardMatrixDoc, guardMatrixPointer } from '@webpieces/rules-config';\nimport { Rule, HookRuleSet, HookFileEvaluation, ToolKind, NormalizedToolInput, HookMode, BlockedResult } from '@webpieces/hook-runtime';\nimport { loadBuiltInRules, loadCustomRules, loadMatchRules } from './load-rules';\n\nexport class SourceHookRuleSet extends HookRuleSet {\n    constructor(readonly builtInRules: readonly Rule[], readonly extensionRules: readonly Rule[], configuredRules: readonly Rule[]) {\n        super([...builtInRules, ...extensionRules], configuredRules);\n    }\n}\n\nexport class SourceHookRules {\n    load(loaded: LoadedConfig): SourceHookRuleSet {\n        const builtIns = loadBuiltInRules(loaded.rulesConfig);\n        const custom = loadCustomRules(loaded.rulesConfig, path.dirname(loaded.configPath ?? ''));\n        return new SourceHookRuleSet(builtIns, [...custom, ...loadMatchRules(loaded.matchRules)], [...builtIns, ...custom]);\n    }\n}\n\n// webpieces-disable no-function-outside-class -- preserves the existing source runner entry point\nexport function run(toolKind: ToolKind, input: NormalizedToolInput, cwd: string, mode: HookMode = 'rules'): BlockedResult | null {\n    if (mode === 'guards') return null;\n    const loaded = loadAndValidate(cwd);\n    if (loaded.configPath === null) return new BlockedResult(CONFIG_MISSING_REPORT + guardMatrixPointer(writeGuardMatrixDoc(new RepoRootFinder().resolveRepoRoot(cwd))), L0_FAULT_CONFIG_MISSING);\n    return new HookFileEvaluation().evaluate(toolKind, input, loaded, new SourceHookRules().load(loaded));\n}\n"]}
+{"version":3,"file":"runner.js","sourceRoot":"","sources":["../../../../../../packages/tooling/ai-hook-rules/src/core/runner.ts"],"names":[],"mappings":";;;AA4CA,kBA8BC;AA1ED,kDAAoD;AACpD,0DAUiC;AACjC,0DAUiC;AACjC,6CAA8C;AAE9C,MAAa,iBAAkB,SAAQ,0BAAW;IAEjC;IACA;IAFb,YACa,gBAAiC,EACjC,UAA2B;QAEpC,KAAK,CAAC,CAAC,GAAG,gBAAgB,EAAE,GAAG,UAAU,CAAC,CAAC,CAAC;QAHnC,qBAAgB,GAAhB,gBAAgB,CAAiB;QACjC,eAAU,GAAV,UAAU,CAAiB;IAGxC,CAAC;CACJ;AAPD,8CAOC;AAED,MAAa,eAAe;IACxB,IAAI,CAAC,MAAoB;QACrB,MAAM,QAAQ,GAAG,IAAI,sCAAuB,CACxC,IAAI,GAAG,CAAC,CAAC,CAAC,uCAAuC,EAAE,IAAI,gCAAiB,EAAE,CAAC,CAAC,CAAC,CAChF,CAAC,IAAI,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;QAC9B,OAAO,IAAI,iBAAiB,CAAC,QAAQ,EAAE,IAAA,2BAAc,EAAC,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC;IAC9E,CAAC;CACJ;AAPD,0CAOC;AAED,kGAAkG;AAClG,SAAgB,GAAG,CACf,QAAkB,EAClB,KAA0B,EAC1B,GAAW,EACX,OAAiB,OAAO;IAExB,IAAI,IAAI,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC;IACnC,IACI,QAAQ,KAAK,QAAQ;QACrB,CAAC,IAAI,iCAAkB,EAAE,CAAC,YAAY,CAClC,IAAI,6BAAc,EAAE,CAAC,eAAe,CAAC,GAAG,CAAC,EACzC,KAAK,CAAC,QAAQ,CACjB;YACG,IAAA,6BAAc,EAAC,KAAK,CAAC,QAAQ,CAAC;YAC9B,IAAI,gCAAiB,EAAE,CAAC,gBAAgB,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;QAE7D,OAAO,IAAI,CAAC;IAChB,MAAM,MAAM,GAAG,IAAA,8BAAe,EAAC,GAAG,CAAC,CAAC;IACpC,IAAI,MAAM,CAAC,UAAU,KAAK,IAAI;QAC1B,OAAO,IAAI,4BAAa,CACpB,oCAAqB;YACjB,IAAA,iCAAkB,EAAC,IAAA,kCAAmB,EAAC,IAAI,6BAAc,EAAE,CAAC,eAAe,CAAC,GAAG,CAAC,CAAC,CAAC,EACtF,sCAAuB,CAC1B,CAAC;IACN,OAAO,IAAI,iCAAkB,EAAE,CAAC,QAAQ,CACpC,QAAQ,EACR,KAAK,EACL,MAAM,EACN,IAAI,eAAe,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,CACrC,CAAC;AACN,CAAC","sourcesContent":["import { SourceRuleRuntime } from '../rule-runtime';\nimport {\n    loadAndValidate,\n    LoadedConfig,\n    ConfigRepairAccess,\n    HomeConfigService,\n    CONFIG_MISSING_REPORT,\n    L0_FAULT_CONFIG_MISSING,\n    RepoRootFinder,\n    writeGuardMatrixDoc,\n    guardMatrixPointer,\n} from '@webpieces/rules-config';\nimport {\n    Rule,\n    isRootManifest,\n    HookPolicyContributions,\n    HookRuleSet,\n    HookFileEvaluation,\n    ToolKind,\n    NormalizedToolInput,\n    HookMode,\n    BlockedResult,\n} from '@webpieces/hook-runtime';\nimport { loadMatchRules } from './load-rules';\n\nexport class SourceHookRuleSet extends HookRuleSet {\n    constructor(\n        readonly contributedRules: readonly Rule[],\n        readonly matchRules: readonly Rule[],\n    ) {\n        super([...contributedRules, ...matchRules]);\n    }\n}\n\nexport class SourceHookRules {\n    load(loaded: LoadedConfig): SourceHookRuleSet {\n        const builtIns = new HookPolicyContributions(\n            new Map([['@webpieces/ai-hook-rules/rule-runtime', new SourceRuleRuntime()]]),\n        ).load(loaded, 'source-hook');\n        return new SourceHookRuleSet(builtIns, loadMatchRules(loaded.matchRules));\n    }\n}\n\n// webpieces-disable no-function-outside-class -- preserves the existing source runner entry point\nexport function run(\n    toolKind: ToolKind,\n    input: NormalizedToolInput,\n    cwd: string,\n    mode: HookMode = 'rules',\n): BlockedResult | null {\n    if (mode === 'guards') return null;\n    if (\n        toolKind !== 'Delete' &&\n        (new ConfigRepairAccess().isRepairFile(\n            new RepoRootFinder().resolveRepoRoot(cwd),\n            input.filePath,\n        ) ||\n            isRootManifest(input.filePath) ||\n            new HomeConfigService().isHomeConfigPath(input.filePath))\n    )\n        return null;\n    const loaded = loadAndValidate(cwd);\n    if (loaded.configPath === null)\n        return new BlockedResult(\n            CONFIG_MISSING_REPORT +\n                guardMatrixPointer(writeGuardMatrixDoc(new RepoRootFinder().resolveRepoRoot(cwd))),\n            L0_FAULT_CONFIG_MISSING,\n        );\n    return new HookFileEvaluation().evaluate(\n        toolKind,\n        input,\n        loaded,\n        new SourceHookRules().load(loaded),\n    );\n}\n"]}

package/src/rule-help.d.ts

@@ -0,0 +1,3 @@
+import { RuleHelp } from '@webpieces/rules-sdk';
+/** Owner-authored guidance consumed by the registry catalog. */
+export declare const ruleHelp: Readonly<Record<string, RuleHelp>>;

package/src/rule-help.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ruleHelp = void 0;
+const rules_sdk_1 = require("@webpieces/rules-sdk");
+/** Owner-authored guidance consumed by the registry catalog. */
+exports.ruleHelp = {
+    'throw-cause-required': new rules_sdk_1.RuleHelp('Preserve the original error as cause when throwing a replacement error.', 'Apply this policy in source, or review its explicit settings in {configFile}. An intentional opt-out requires complete OFF settings.'),
+    'no-js-files': new rules_sdk_1.RuleHelp('Keep governed source in TypeScript rather than JavaScript.', 'Apply this policy in source, or review its explicit settings in {configFile}. An intentional opt-out requires complete OFF settings.'),
+    'validate-ts-in-src': new rules_sdk_1.RuleHelp('Keep TypeScript implementation files inside their project source directory.', 'Apply this policy in source, or review its explicit settings in {configFile}. An intentional opt-out requires complete OFF settings.'),
+};
+//# sourceMappingURL=rule-help.js.map

package/src/rule-help.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rule-help.js","sourceRoot":"","sources":["../../../../../packages/tooling/ai-hook-rules/src/rule-help.ts"],"names":[],"mappings":";;;AAAA,oDAAgD;AAEhD,gEAAgE;AACnD,QAAA,QAAQ,GAAuC;IACxD,sBAAsB,EAAE,IAAI,oBAAQ,CAChC,yEAAyE,EACzE,sIAAsI,CACzI;IACD,aAAa,EAAE,IAAI,oBAAQ,CACvB,4DAA4D,EAC5D,sIAAsI,CACzI;IACD,oBAAoB,EAAE,IAAI,oBAAQ,CAC9B,6EAA6E,EAC7E,sIAAsI,CACzI;CACJ,CAAC","sourcesContent":["import { RuleHelp } from '@webpieces/rules-sdk';\n\n/** Owner-authored guidance consumed by the registry catalog. */\nexport const ruleHelp: Readonly<Record<string, RuleHelp>> = {\n    'throw-cause-required': new RuleHelp(\n        'Preserve the original error as cause when throwing a replacement error.',\n        'Apply this policy in source, or review its explicit settings in {configFile}. An intentional opt-out requires complete OFF settings.',\n    ),\n    'no-js-files': new RuleHelp(\n        'Keep governed source in TypeScript rather than JavaScript.',\n        'Apply this policy in source, or review its explicit settings in {configFile}. An intentional opt-out requires complete OFF settings.',\n    ),\n    'validate-ts-in-src': new RuleHelp(\n        'Keep TypeScript implementation files inside their project source directory.',\n        'Apply this policy in source, or review its explicit settings in {configFile}. An intentional opt-out requires complete OFF settings.',\n    ),\n};\n"]}

package/src/rule-pack.js

@@ -1,27 +1,8 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.rulePackManifest = void 0;
-const rule_settings_1 = require("./rule-settings");
 const rules_sdk_1 = require("@webpieces/rules-sdk");
-const rule_configs_1 = require("./configs/rule-configs");
+const source_policy_registry_1 = require("./source-policy-registry");
 const package_json_1 = require("../package.json");
-/** Source policies own their schema; other contributions consume their canonical owner's settings. */
-const ownedRules = [
-    new rules_sdk_1.OwnedRuleDefinition('throw-cause-required', rule_configs_1.ThrowCauseRequiredConfig.SCHEMA, rules_sdk_1.RULE_SCHEMA_API_VERSION, rule_settings_1.optionalTuning['throw-cause-required'], rule_settings_1.recommendedSeeds['throw-cause-required'], 'rules'),
-    new rules_sdk_1.OwnedRuleDefinition('no-js-files', rule_configs_1.NoJsFilesConfig.SCHEMA, rules_sdk_1.RULE_SCHEMA_API_VERSION, rule_settings_1.optionalTuning['no-js-files'], rule_settings_1.recommendedSeeds['no-js-files'], 'rules'),
-    new rules_sdk_1.OwnedRuleDefinition('validate-ts-in-src', rule_configs_1.ValidateTsInSrcConfig.SCHEMA, rules_sdk_1.RULE_SCHEMA_API_VERSION, rule_settings_1.optionalTuning['validate-ts-in-src'], rule_settings_1.recommendedSeeds['validate-ts-in-src'], 'rules'),
-];
-exports.rulePackManifest = new rules_sdk_1.RulePackManifest('@webpieces/ai-hook-rules', package_json_1.version, rules_sdk_1.RULE_PACK_API_VERSION, ownedRules, [
-    ...ownedRules.map(rule => new rules_sdk_1.RuleContribution(rule.id, '@webpieces/ai-hook-rules', 'source-hook')),
-    new rules_sdk_1.RuleContribution('no-any-unknown', '@webpieces/code-rules', 'source-hook'),
-    new rules_sdk_1.RuleContribution('no-implicit-any', '@webpieces/code-rules', 'source-hook'),
-    new rules_sdk_1.RuleContribution('max-file-lines', '@webpieces/code-rules', 'source-hook'),
-    new rules_sdk_1.RuleContribution('no-destructure', '@webpieces/code-rules', 'source-hook'),
-    new rules_sdk_1.RuleContribution('require-return-type', '@webpieces/code-rules', 'source-hook'),
-    new rules_sdk_1.RuleContribution('no-unmanaged-exceptions', '@webpieces/code-rules', 'source-hook'),
-    new rules_sdk_1.RuleContribution('catch-error-pattern', '@webpieces/code-rules', 'source-hook'),
-    new rules_sdk_1.RuleContribution('no-symbol-di-tokens', '@webpieces/code-rules', 'source-hook'),
-    new rules_sdk_1.RuleContribution('no-custom-css', '@webpieces/code-rules', 'source-hook'),
-    new rules_sdk_1.RuleContribution('no-process-exit-outside-main', '@webpieces/code-rules', 'source-hook'),
-], [], []);
+exports.rulePackManifest = new rules_sdk_1.RulePackManifest('@webpieces/ai-hook-rules', package_json_1.version, rules_sdk_1.RULE_PACK_API_VERSION, source_policy_registry_1.ownedRules, source_policy_registry_1.SOURCE_POLICIES.map((policy) => new rules_sdk_1.RuleContribution(policy.id, policy.ownerPack, 'source-hook', '@webpieces/ai-hook-rules/rule-runtime')), [], []);
 //# sourceMappingURL=rule-pack.js.map

package/src/rule-pack.js.map

@@ -1 +1 @@
-{"version":3,"file":"rule-pack.js","sourceRoot":"","sources":["../../../../../packages/tooling/ai-hook-rules/src/rule-pack.ts"],"names":[],"mappings":";;;AAAA,mDAAmE;AACnE,oDAA+I;AAC/I,yDAA0G;AAC1G,kDAA0C;AAE1C,sGAAsG;AACtG,MAAM,UAAU,GAAG;IACf,IAAI,+BAAmB,CAAC,sBAAsB,EAAE,uCAAwB,CAAC,MAAM,EAAE,mCAAuB,EAAE,8BAAc,CAAC,sBAAsB,CAAC,EAAE,gCAAgB,CAAC,sBAAsB,CAAC,EAAE,OAAO,CAAC;IACpM,IAAI,+BAAmB,CAAC,aAAa,EAAE,8BAAe,CAAC,MAAM,EAAE,mCAAuB,EAAE,8BAAc,CAAC,aAAa,CAAC,EAAE,gCAAgB,CAAC,aAAa,CAAC,EAAE,OAAO,CAAC;IAChK,IAAI,+BAAmB,CAAC,oBAAoB,EAAE,oCAAqB,CAAC,MAAM,EAAE,mCAAuB,EAAE,8BAAc,CAAC,oBAAoB,CAAC,EAAE,gCAAgB,CAAC,oBAAoB,CAAC,EAAE,OAAO,CAAC;CAC9L,CAAC;AAEW,QAAA,gBAAgB,GAAG,IAAI,4BAAgB,CAChD,0BAA0B,EAC1B,sBAAO,EACP,iCAAqB,EACrB,UAAU,EACV;IACI,GAAG,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,4BAAgB,CAAC,IAAI,CAAC,EAAE,EAAE,0BAA0B,EAAE,aAAa,CAAC,CAAC;IACnG,IAAI,4BAAgB,CAAC,gBAAgB,EAAE,uBAAuB,EAAE,aAAa,CAAC;IAC9E,IAAI,4BAAgB,CAAC,iBAAiB,EAAE,uBAAuB,EAAE,aAAa,CAAC;IAC/E,IAAI,4BAAgB,CAAC,gBAAgB,EAAE,uBAAuB,EAAE,aAAa,CAAC;IAC9E,IAAI,4BAAgB,CAAC,gBAAgB,EAAE,uBAAuB,EAAE,aAAa,CAAC;IAC9E,IAAI,4BAAgB,CAAC,qBAAqB,EAAE,uBAAuB,EAAE,aAAa,CAAC;IACnF,IAAI,4BAAgB,CAAC,yBAAyB,EAAE,uBAAuB,EAAE,aAAa,CAAC;IACvF,IAAI,4BAAgB,CAAC,qBAAqB,EAAE,uBAAuB,EAAE,aAAa,CAAC;IACnF,IAAI,4BAAgB,CAAC,qBAAqB,EAAE,uBAAuB,EAAE,aAAa,CAAC;IACnF,IAAI,4BAAgB,CAAC,eAAe,EAAE,uBAAuB,EAAE,aAAa,CAAC;IAC7E,IAAI,4BAAgB,CAAC,8BAA8B,EAAE,uBAAuB,EAAE,aAAa,CAAC;CAC/F,EACD,EAAE,EACF,EAAE,CACL,CAAC","sourcesContent":["import { optionalTuning, recommendedSeeds } from './rule-settings';\nimport { OwnedRuleDefinition, RuleContribution, RulePackManifest, RULE_PACK_API_VERSION, RULE_SCHEMA_API_VERSION } from '@webpieces/rules-sdk';\nimport { ThrowCauseRequiredConfig, NoJsFilesConfig, ValidateTsInSrcConfig } from './configs/rule-configs';\nimport { version } from '../package.json';\n\n/** Source policies own their schema; other contributions consume their canonical owner's settings. */\nconst ownedRules = [\n    new OwnedRuleDefinition('throw-cause-required', ThrowCauseRequiredConfig.SCHEMA, RULE_SCHEMA_API_VERSION, optionalTuning['throw-cause-required'], recommendedSeeds['throw-cause-required'], 'rules'),\n    new OwnedRuleDefinition('no-js-files', NoJsFilesConfig.SCHEMA, RULE_SCHEMA_API_VERSION, optionalTuning['no-js-files'], recommendedSeeds['no-js-files'], 'rules'),\n    new OwnedRuleDefinition('validate-ts-in-src', ValidateTsInSrcConfig.SCHEMA, RULE_SCHEMA_API_VERSION, optionalTuning['validate-ts-in-src'], recommendedSeeds['validate-ts-in-src'], 'rules'),\n];\n\nexport const rulePackManifest = new RulePackManifest(\n    '@webpieces/ai-hook-rules',\n    version,\n    RULE_PACK_API_VERSION,\n    ownedRules,\n    [\n        ...ownedRules.map(rule => new RuleContribution(rule.id, '@webpieces/ai-hook-rules', 'source-hook')),\n        new RuleContribution('no-any-unknown', '@webpieces/code-rules', 'source-hook'),\n        new RuleContribution('no-implicit-any', '@webpieces/code-rules', 'source-hook'),\n        new RuleContribution('max-file-lines', '@webpieces/code-rules', 'source-hook'),\n        new RuleContribution('no-destructure', '@webpieces/code-rules', 'source-hook'),\n        new RuleContribution('require-return-type', '@webpieces/code-rules', 'source-hook'),\n        new RuleContribution('no-unmanaged-exceptions', '@webpieces/code-rules', 'source-hook'),\n        new RuleContribution('catch-error-pattern', '@webpieces/code-rules', 'source-hook'),\n        new RuleContribution('no-symbol-di-tokens', '@webpieces/code-rules', 'source-hook'),\n        new RuleContribution('no-custom-css', '@webpieces/code-rules', 'source-hook'),\n        new RuleContribution('no-process-exit-outside-main', '@webpieces/code-rules', 'source-hook'),\n    ],\n    [],\n    [],\n);\n"]}
+{"version":3,"file":"rule-pack.js","sourceRoot":"","sources":["../../../../../packages/tooling/ai-hook-rules/src/rule-pack.ts"],"names":[],"mappings":";;;AAAA,oDAAiG;AACjG,qEAAqF;AACrF,kDAA0C;AAE7B,QAAA,gBAAgB,GAAG,IAAI,4BAAgB,CAChD,0BAA0B,EAC1B,sBAAO,EACP,iCAAqB,EACrB,mCAAU,EACV,wCAAe,CAAC,GAAG,CACf,CAAC,MAAoB,EAAE,EAAE,CACrB,IAAI,4BAAgB,CAChB,MAAM,CAAC,EAAE,EACT,MAAM,CAAC,SAAS,EAChB,aAAa,EACb,uCAAuC,CAC1C,CACR,EACD,EAAE,EACF,EAAE,CACL,CAAC","sourcesContent":["import { RuleContribution, RulePackManifest, RULE_PACK_API_VERSION } from '@webpieces/rules-sdk';\nimport { ownedRules, SOURCE_POLICIES, SourcePolicy } from './source-policy-registry';\nimport { version } from '../package.json';\n\nexport const rulePackManifest = new RulePackManifest(\n    '@webpieces/ai-hook-rules',\n    version,\n    RULE_PACK_API_VERSION,\n    ownedRules,\n    SOURCE_POLICIES.map(\n        (policy: SourcePolicy) =>\n            new RuleContribution(\n                policy.id,\n                policy.ownerPack,\n                'source-hook',\n                '@webpieces/ai-hook-rules/rule-runtime',\n            ),\n    ),\n    [],\n    [],\n);\n"]}

package/src/rule-runtime.d.ts

@@ -0,0 +1,7 @@
+import { PolicyRuntimeRequest } from '@webpieces/rules-sdk';
+import { Rule } from '@webpieces/hook-runtime';
+/** Runtime imports are isolated from the public metadata module. */
+export declare class SourceRuleRuntime {
+    create(request: PolicyRuntimeRequest): readonly Rule[];
+}
+export declare const sourceRuleRuntime: SourceRuleRuntime;

package/src/rule-runtime.js

@@ -0,0 +1,27 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.sourceRuleRuntime = exports.SourceRuleRuntime = void 0;
+const tslib_1 = require("tslib");
+const tooling_common_1 = require("@webpieces/tooling-common");
+const source_policy_registry_1 = require("./source-policy-registry");
+const implementations = tslib_1.__importStar(require("./core/rules"));
+/** Runtime imports are isolated from the public metadata module. */
+class SourceRuleRuntime {
+    create(request) {
+        return request.ruleIds.map((id) => {
+            const policy = source_policy_registry_1.SOURCE_POLICIES.find((entry) => entry.id === id);
+            if (!policy)
+                throw new tooling_common_1.InformAiError(`Source runtime has no implementation of ${id}. Repair its contribution.`);
+            const config = request.configs[id];
+            if (!config)
+                throw new tooling_common_1.InformAiError(`Missing explicit config for ${id}. Repair its declared owner file.`);
+            const ctor = implementations[policy.implementationExport];
+            if (!ctor)
+                throw new tooling_common_1.InformAiError(`Missing source implementation ${policy.implementationExport}. Repair its runtime export.`);
+            return new ctor(config);
+        });
+    }
+}
+exports.SourceRuleRuntime = SourceRuleRuntime;
+exports.sourceRuleRuntime = new SourceRuleRuntime();
+//# sourceMappingURL=rule-runtime.js.map

package/src/rule-runtime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rule-runtime.js","sourceRoot":"","sources":["../../../../../packages/tooling/ai-hook-rules/src/rule-runtime.ts"],"names":[],"mappings":";;;;AAEA,8DAA0D;AAC1D,qEAAyE;AACzE,sEAAgD;AAIhD,oEAAoE;AACpE,MAAa,iBAAiB;IAC1B,MAAM,CAAC,OAA6B;QAChC,OAAO,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,EAAU,EAAE,EAAE;YACtC,MAAM,MAAM,GAAG,wCAAe,CAAC,IAAI,CAAC,CAAC,KAAmB,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;YAC9E,IAAI,CAAC,MAAM;gBACP,MAAM,IAAI,8BAAa,CACnB,2CAA2C,EAAE,4BAA4B,CAC5E,CAAC;YACN,MAAM,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;YACnC,IAAI,CAAC,MAAM;gBACP,MAAM,IAAI,8BAAa,CACnB,+BAA+B,EAAE,mCAAmC,CACvE,CAAC;YACN,MAAM,IAAI,GAAI,eAAkD,CAC5D,MAAM,CAAC,oBAAoB,CAC9B,CAAC;YACF,IAAI,CAAC,IAAI;gBACL,MAAM,IAAI,8BAAa,CACnB,iCAAiC,MAAM,CAAC,oBAAoB,8BAA8B,CAC7F,CAAC;YACN,OAAO,IAAI,IAAI,CAAC,MAAwB,CAAC,CAAC;QAC9C,CAAC,CAAC,CAAC;IACP,CAAC;CACJ;AAvBD,8CAuBC;AAEY,QAAA,iBAAiB,GAAG,IAAI,iBAAiB,EAAE,CAAC","sourcesContent":["import { BaseRuleConfig, PolicyRuntimeRequest } from '@webpieces/rules-sdk';\nimport { Rule } from '@webpieces/hook-runtime';\nimport { InformAiError } from '@webpieces/tooling-common';\nimport { SOURCE_POLICIES, SourcePolicy } from './source-policy-registry';\nimport * as implementations from './core/rules';\n\ntype SourceRuleCtor = new (config: BaseRuleConfig) => Rule;\n\n/** Runtime imports are isolated from the public metadata module. */\nexport class SourceRuleRuntime {\n    create(request: PolicyRuntimeRequest): readonly Rule[] {\n        return request.ruleIds.map((id: string) => {\n            const policy = SOURCE_POLICIES.find((entry: SourcePolicy) => entry.id === id);\n            if (!policy)\n                throw new InformAiError(\n                    `Source runtime has no implementation of ${id}. Repair its contribution.`,\n                );\n            const config = request.configs[id];\n            if (!config)\n                throw new InformAiError(\n                    `Missing explicit config for ${id}. Repair its declared owner file.`,\n                );\n            const ctor = (implementations as Record<string, SourceRuleCtor>)[\n                policy.implementationExport\n            ];\n            if (!ctor)\n                throw new InformAiError(\n                    `Missing source implementation ${policy.implementationExport}. Repair its runtime export.`,\n                );\n            return new ctor(config as BaseRuleConfig);\n        });\n    }\n}\n\nexport const sourceRuleRuntime = new SourceRuleRuntime();\n"]}

package/src/source-policy-registry.d.ts

@@ -0,0 +1,10 @@
+import { OwnedRuleDefinition } from '@webpieces/rules-sdk';
+export declare const ownedRules: OwnedRuleDefinition[];
+export declare class SourcePolicy {
+    readonly id: string;
+    readonly ownerPack: string;
+    readonly implementationExport: string;
+    constructor(id: string, ownerPack: string, implementationExport: string);
+}
+/** Source implementations and their canonical owners are declared exactly once. */
+export declare const SOURCE_POLICIES: readonly SourcePolicy[];