@ankhorage/rules 0.2.0

package/CHANGELOG.md

@@ -0,0 +1,13 @@
+# @ankhorage/rules
+
+## 0.2.0
+
+### Minor Changes
+
+- 94f1dfb: Restore feature-first Rules ownership, canonical CLI command layout, standalone runtime independence, precise configuration diagnostics, and complete evaluation status semantics.
+
+## 0.1.0
+
+### Minor Changes
+
+- 67e49ab: Bootstrap the generic rule registry, JSON configuration, deterministic evaluator, status model, and config validation CLI provider.

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Ankhorage
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,63 @@
+<!-- markdownlint-disable MD013 MD033 -->
+<!-- This file is generated by Paradox. Do not edit manually. -->
+
+# @ankhorage/rules
+
+![license: MIT](././paradox/badges/license.svg) ![npm: v0.2.0](././paradox/badges/npm.svg) ![runtime: bun](././paradox/badges/runtime.svg) ![typescript: strict](././paradox/badges/typescript.svg) ![eslint: checked](././paradox/badges/eslint.svg) ![prettier: checked](././paradox/badges/prettier.svg) ![build: checked](././paradox/badges/build.svg) ![tests: checked](././paradox/badges/tests.svg) ![paradox: canonical](././paradox/badges/docs.svg)
+
+Domain-agnostic rule engine and JSON configuration for Ankhorage.
+
+## Usage
+
+### CLI
+
+Ankhorage packages expose their command-line interface through `ankh`. Use `ankh --help` to discover available package commands, or run a package command with `--help` for package-specific usage.
+
+```zsh
+# Install the Ankhorage CLI
+bun add --global @ankhorage/ankh
+
+# Show usage information for rules
+ankh rules --help
+```
+
+### Validate Rules Configuration
+
+Validate a repository rules.json file through the public generic Rules API.
+
+```ts
+import { readRulesConfigAsync } from '@ankhorage/rules';
+```
+
+## Configuration
+
+### Example
+
+```ts
+import { defineParadoxConfig } from '@ankhorage/paradox';
+
+export default defineParadoxConfig({
+  mode: 'write',
+  docs: {
+    title: '@ankhorage/rules',
+    description: 'Domain-agnostic rule engine and JSON configuration for Ankhorage.',
+  },
+  package: {
+    root: '.',
+    entrypoints: ['src/index.ts'],
+  },
+  output: { dir: './paradox' },
+});
+```
+
+## Generated documentation
+
+- [Interactive documentation app](././paradox/index.html)
+- [Public API reference](././paradox/exports.md)
+- [Component registry](././paradox/components.md)
+- [Architecture overview](././paradox/diagrams/architecture-overview.mmd)
+- [Module relationships](././paradox/diagrams/module-relationships.mmd)
+- [Export graph](././paradox/diagrams/export-graph.mmd)
+- [ankhorage-rules sequence](././paradox/diagrams/sequences/ankhorage-rules.mmd)
+- [createRuleRegistry sequence](././paradox/diagrams/sequences/create-rule-registry.mmd)
+- [validateRulesConfig sequence](././paradox/diagrams/sequences/validate-rules-config.mmd)

package/dist/cli/commands/config/validate.d.ts

@@ -0,0 +1,6 @@
+/*** Execute the public `ankh rules config validate` command through the configuration feature. */
+export declare function validate(argv: readonly string[], cwd: string): Promise<{
+    readonly exitCode: number;
+    readonly stdout: string;
+}>;
+//# sourceMappingURL=validate.d.ts.map

package/dist/cli/commands/config/validate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/config/validate.ts"],"names":[],"mappings":"AAIA,kGAAkG;AAClG,wBAAsB,QAAQ,CAC5B,IAAI,EAAE,SAAS,MAAM,EAAE,EACvB,GAAG,EAAE,MAAM,GACV,OAAO,CAAC;IAAE,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC,CAUjE"}

package/dist/cli/commands/config/validate.js

@@ -0,0 +1,25 @@
+import { resolve } from 'node:path';
+import { readRulesConfigAsync } from '../../../features/configuration/composition/readRulesConfigAsync.js';
+/*** Execute the public `ankh rules config validate` command through the configuration feature. */
+export async function validate(argv, cwd) {
+    if (argv.length > 1) {
+        throw new Error('ankh rules config validate accepts at most one rules.json path.');
+    }
+    const result = await readRulesConfigAsync(resolve(cwd, argv.at(0) ?? 'rules.json'));
+    return {
+        exitCode: result.diagnostics.length === 0 ? 0 : 1,
+        stdout: renderConfigValidation(result),
+    };
+}
+/*** Render the command result without coupling the configuration feature to a transport. */
+function renderConfigValidation(result) {
+    if (result.diagnostics.length === 0)
+        return `rules config validate\nvalid: ${result.path}\n`;
+    return [
+        'rules config validate',
+        `invalid: ${result.path}`,
+        ...result.diagnostics.map((diagnostic) => `- ${diagnostic.code}: ${diagnostic.message}`),
+        '',
+    ].join('\n');
+}
+//# sourceMappingURL=validate.js.map

package/dist/cli/commands/config/validate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.js","sourceRoot":"","sources":["../../../../src/cli/commands/config/validate.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,OAAO,EAAE,oBAAoB,EAAE,MAAM,qEAAqE,CAAC;AAE3G,kGAAkG;AAClG,MAAM,CAAC,KAAK,UAAU,QAAQ,CAC5B,IAAuB,EACvB,GAAW;IAEX,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACpB,MAAM,IAAI,KAAK,CAAC,iEAAiE,CAAC,CAAC;IACrF,CAAC;IAED,MAAM,MAAM,GAAG,MAAM,oBAAoB,CAAC,OAAO,CAAC,GAAG,EAAE,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,YAAY,CAAC,CAAC,CAAC;IACpF,OAAO;QACL,QAAQ,EAAE,MAAM,CAAC,WAAW,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QACjD,MAAM,EAAE,sBAAsB,CAAC,MAAM,CAAC;KACvC,CAAC;AACJ,CAAC;AAED,4FAA4F;AAC5F,SAAS,sBAAsB,CAAC,MAAwD;IACtF,IAAI,MAAM,CAAC,WAAW,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,iCAAiC,MAAM,CAAC,IAAI,IAAI,CAAC;IAC7F,OAAO;QACL,uBAAuB;QACvB,YAAY,MAAM,CAAC,IAAI,EAAE;QACzB,GAAG,MAAM,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,KAAK,UAAU,CAAC,IAAI,KAAK,UAAU,CAAC,OAAO,EAAE,CAAC;QACxF,EAAE;KACH,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC","sourcesContent":["import { resolve } from 'node:path';\n\nimport { readRulesConfigAsync } from '../../../features/configuration/composition/readRulesConfigAsync.js';\n\n/*** Execute the public `ankh rules config validate` command through the configuration feature. */\nexport async function validate(\n  argv: readonly string[],\n  cwd: string,\n): Promise<{ readonly exitCode: number; readonly stdout: string }> {\n  if (argv.length > 1) {\n    throw new Error('ankh rules config validate accepts at most one rules.json path.');\n  }\n\n  const result = await readRulesConfigAsync(resolve(cwd, argv.at(0) ?? 'rules.json'));\n  return {\n    exitCode: result.diagnostics.length === 0 ? 0 : 1,\n    stdout: renderConfigValidation(result),\n  };\n}\n\n/*** Render the command result without coupling the configuration feature to a transport. */\nfunction renderConfigValidation(result: Awaited<ReturnType<typeof readRulesConfigAsync>>): string {\n  if (result.diagnostics.length === 0) return `rules config validate\\nvalid: ${result.path}\\n`;\n  return [\n    'rules config validate',\n    `invalid: ${result.path}`,\n    ...result.diagnostics.map((diagnostic) => `- ${diagnostic.code}: ${diagnostic.message}`),\n    '',\n  ].join('\\n');\n}\n"]}

package/dist/cli/createRulesRuntimeProvider.d.ts

@@ -0,0 +1,4 @@
+import type { AnkhRuntimeCommandProvider } from '@ankhorage/ankh';
+/*** Create the Ankh provider that registers the generic Rules configuration command. */
+export declare function createRulesRuntimeProvider(): AnkhRuntimeCommandProvider;
+//# sourceMappingURL=createRulesRuntimeProvider.d.ts.map

package/dist/cli/createRulesRuntimeProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createRulesRuntimeProvider.d.ts","sourceRoot":"","sources":["../../src/cli/createRulesRuntimeProvider.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,iBAAiB,CAAC;AASlE,wFAAwF;AACxF,wBAAgB,0BAA0B,IAAI,0BAA0B,CAwBvE"}

package/dist/cli/createRulesRuntimeProvider.js

@@ -0,0 +1,29 @@
+import { RULES_CAPABILITIES, RULES_COMMAND_CATEGORY, RULES_PACKAGE_VERSION, } from '../constants/rules.js';
+import { validate } from './commands/config/validate.js';
+/*** Create the Ankh provider that registers the generic Rules configuration command. */
+export function createRulesRuntimeProvider() {
+    return {
+        id: '@ankhorage/rules',
+        category: RULES_COMMAND_CATEGORY,
+        version: RULES_PACKAGE_VERSION,
+        capabilities: [...RULES_CAPABILITIES],
+        commands: [
+            {
+                path: ['config', 'validate'],
+                capability: RULES_CAPABILITIES[0],
+                summary: 'Validate the generic JSON shape of a repository rules.json file.',
+            },
+        ],
+        handlers: [
+            {
+                path: ['config', 'validate'],
+                handler: async ({ argv, context }) => {
+                    const result = await validate(argv, context.cwd);
+                    context.writeStdout(result.stdout);
+                    return { exitCode: result.exitCode };
+                },
+            },
+        ],
+    };
+}
+//# sourceMappingURL=createRulesRuntimeProvider.js.map

package/dist/cli/createRulesRuntimeProvider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"createRulesRuntimeProvider.js","sourceRoot":"","sources":["../../src/cli/createRulesRuntimeProvider.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,kBAAkB,EAClB,sBAAsB,EACtB,qBAAqB,GACtB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,QAAQ,EAAE,MAAM,+BAA+B,CAAC;AAEzD,wFAAwF;AACxF,MAAM,UAAU,0BAA0B;IACxC,OAAO;QACL,EAAE,EAAE,kBAAkB;QACtB,QAAQ,EAAE,sBAAsB;QAChC,OAAO,EAAE,qBAAqB;QAC9B,YAAY,EAAE,CAAC,GAAG,kBAAkB,CAAC;QACrC,QAAQ,EAAE;YACR;gBACE,IAAI,EAAE,CAAC,QAAQ,EAAE,UAAU,CAAC;gBAC5B,UAAU,EAAE,kBAAkB,CAAC,CAAC,CAAC;gBACjC,OAAO,EAAE,kEAAkE;aAC5E;SACF;QACD,QAAQ,EAAE;YACR;gBACE,IAAI,EAAE,CAAC,QAAQ,EAAE,UAAU,CAAC;gBAC5B,OAAO,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,EAAE;oBACnC,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC;oBACjD,OAAO,CAAC,WAAW,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;oBACnC,OAAO,EAAE,QAAQ,EAAE,MAAM,CAAC,QAAQ,EAAE,CAAC;gBACvC,CAAC;aACF;SACF;KACF,CAAC;AACJ,CAAC","sourcesContent":["import type { AnkhRuntimeCommandProvider } from '@ankhorage/ankh';\n\nimport {\n  RULES_CAPABILITIES,\n  RULES_COMMAND_CATEGORY,\n  RULES_PACKAGE_VERSION,\n} from '../constants/rules.js';\nimport { validate } from './commands/config/validate.js';\n\n/*** Create the Ankh provider that registers the generic Rules configuration command. */\nexport function createRulesRuntimeProvider(): AnkhRuntimeCommandProvider {\n  return {\n    id: '@ankhorage/rules',\n    category: RULES_COMMAND_CATEGORY,\n    version: RULES_PACKAGE_VERSION,\n    capabilities: [...RULES_CAPABILITIES],\n    commands: [\n      {\n        path: ['config', 'validate'],\n        capability: RULES_CAPABILITIES[0],\n        summary: 'Validate the generic JSON shape of a repository rules.json file.',\n      },\n    ],\n    handlers: [\n      {\n        path: ['config', 'validate'],\n        handler: async ({ argv, context }) => {\n          const result = await validate(argv, context.cwd);\n          context.writeStdout(result.stdout);\n          return { exitCode: result.exitCode };\n        },\n      },\n    ],\n  };\n}\n"]}

package/dist/cli/index.d.ts

@@ -0,0 +1,4 @@
+export { createRulesRuntimeProvider } from './createRulesRuntimeProvider.js';
+declare const _default: import("@ankhorage/ankh").AnkhRuntimeCommandProvider;
+export default _default;
+//# sourceMappingURL=index.d.ts.map

package/dist/cli/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,0BAA0B,EAAE,MAAM,iCAAiC,CAAC;;AAE7E,wBAA4C"}

package/dist/cli/index.js

@@ -0,0 +1,4 @@
+import { createRulesRuntimeProvider } from './createRulesRuntimeProvider.js';
+export { createRulesRuntimeProvider } from './createRulesRuntimeProvider.js';
+export default createRulesRuntimeProvider();
+//# sourceMappingURL=index.js.map

package/dist/cli/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,0BAA0B,EAAE,MAAM,iCAAiC,CAAC;AAE7E,OAAO,EAAE,0BAA0B,EAAE,MAAM,iCAAiC,CAAC;AAE7E,eAAe,0BAA0B,EAAE,CAAC","sourcesContent":["import { createRulesRuntimeProvider } from './createRulesRuntimeProvider.js';\n\nexport { createRulesRuntimeProvider } from './createRulesRuntimeProvider.js';\n\nexport default createRulesRuntimeProvider();\n"]}

package/dist/cli/standalone.d.ts

@@ -0,0 +1,6 @@
+#!/usr/bin/env bun
+/*** Run the standalone Rules CLI without depending on the Ankh runtime package. */
+export declare function runCli(argv: readonly string[]): Promise<{
+    readonly exitCode: number;
+}>;
+//# sourceMappingURL=standalone.d.ts.map

package/dist/cli/standalone.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"standalone.d.ts","sourceRoot":"","sources":["../../src/cli/standalone.ts"],"names":[],"mappings":";AAIA,mFAAmF;AACnF,wBAAsB,MAAM,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAAC;IAAE,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC,CAmB5F"}

package/dist/cli/standalone.js

@@ -0,0 +1,43 @@
+#!/usr/bin/env bun
+import { validate } from './commands/config/validate.js';
+/*** Run the standalone Rules CLI without depending on the Ankh runtime package. */
+export async function runCli(argv) {
+    const [firstToken, ...restTokens] = argv;
+    if (firstToken === undefined || isHelpToken(firstToken)) {
+        process.stdout.write(renderHelp());
+        return { exitCode: 0 };
+    }
+    if (firstToken !== 'config' || restTokens.at(0) !== 'validate') {
+        process.stderr.write('Unknown Rules command. Run ankhorage-rules --help.\n');
+        return { exitCode: 1 };
+    }
+    try {
+        const result = await validate(restTokens.slice(1), process.cwd());
+        process.stdout.write(result.stdout);
+        return { exitCode: result.exitCode };
+    }
+    catch (error) {
+        process.stderr.write(`${error instanceof Error ? error.message : 'Rules command failed.'}\n`);
+        return { exitCode: 1 };
+    }
+}
+/*** Identify help tokens accepted by the standalone delivery adapter. */
+function isHelpToken(value) {
+    return value === '--help' || value === '-h' || value === 'help';
+}
+/*** Render standalone help without introducing a second command implementation. */
+function renderHelp() {
+    return [
+        '@ankhorage/rules',
+        '',
+        'Usage:',
+        '  ankhorage-rules config validate [rules.json]',
+        '  ankh rules config validate [rules.json]',
+        '',
+    ].join('\n');
+}
+if (import.meta.main) {
+    const result = await runCli(process.argv.slice(2));
+    process.exit(result.exitCode);
+}
+//# sourceMappingURL=standalone.js.map

package/dist/cli/standalone.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"standalone.js","sourceRoot":"","sources":["../../src/cli/standalone.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,QAAQ,EAAE,MAAM,+BAA+B,CAAC;AAEzD,mFAAmF;AACnF,MAAM,CAAC,KAAK,UAAU,MAAM,CAAC,IAAuB;IAClD,MAAM,CAAC,UAAU,EAAE,GAAG,UAAU,CAAC,GAAG,IAAI,CAAC;IACzC,IAAI,UAAU,KAAK,SAAS,IAAI,WAAW,CAAC,UAAU,CAAC,EAAE,CAAC;QACxD,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,UAAU,EAAE,CAAC,CAAC;QACnC,OAAO,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC;IACzB,CAAC;IACD,IAAI,UAAU,KAAK,QAAQ,IAAI,UAAU,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,UAAU,EAAE,CAAC;QAC/D,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,sDAAsD,CAAC,CAAC;QAC7E,OAAO,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC;IACzB,CAAC;IAED,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;QAClE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QACpC,OAAO,EAAE,QAAQ,EAAE,MAAM,CAAC,QAAQ,EAAE,CAAC;IACvC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,uBAAuB,IAAI,CAAC,CAAC;QAC9F,OAAO,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC;IACzB,CAAC;AACH,CAAC;AAED,yEAAyE;AACzE,SAAS,WAAW,CAAC,KAAa;IAChC,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,MAAM,CAAC;AAClE,CAAC;AAED,mFAAmF;AACnF,SAAS,UAAU;IACjB,OAAO;QACL,kBAAkB;QAClB,EAAE;QACF,QAAQ;QACR,gDAAgD;QAChD,2CAA2C;QAC3C,EAAE;KACH,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC;AAED,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;IACrB,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IACnD,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;AAChC,CAAC","sourcesContent":["#!/usr/bin/env bun\n\nimport { validate } from './commands/config/validate.js';\n\n/*** Run the standalone Rules CLI without depending on the Ankh runtime package. */\nexport async function runCli(argv: readonly string[]): Promise<{ readonly exitCode: number }> {\n  const [firstToken, ...restTokens] = argv;\n  if (firstToken === undefined || isHelpToken(firstToken)) {\n    process.stdout.write(renderHelp());\n    return { exitCode: 0 };\n  }\n  if (firstToken !== 'config' || restTokens.at(0) !== 'validate') {\n    process.stderr.write('Unknown Rules command. Run ankhorage-rules --help.\\n');\n    return { exitCode: 1 };\n  }\n\n  try {\n    const result = await validate(restTokens.slice(1), process.cwd());\n    process.stdout.write(result.stdout);\n    return { exitCode: result.exitCode };\n  } catch (error) {\n    process.stderr.write(`${error instanceof Error ? error.message : 'Rules command failed.'}\\n`);\n    return { exitCode: 1 };\n  }\n}\n\n/*** Identify help tokens accepted by the standalone delivery adapter. */\nfunction isHelpToken(value: string): boolean {\n  return value === '--help' || value === '-h' || value === 'help';\n}\n\n/*** Render standalone help without introducing a second command implementation. */\nfunction renderHelp(): string {\n  return [\n    '@ankhorage/rules',\n    '',\n    'Usage:',\n    '  ankhorage-rules config validate [rules.json]',\n    '  ankh rules config validate [rules.json]',\n    '',\n  ].join('\\n');\n}\n\nif (import.meta.main) {\n  const result = await runCli(process.argv.slice(2));\n  process.exit(result.exitCode);\n}\n"]}

package/dist/constants/rules.d.ts

@@ -0,0 +1,5 @@
+/*** Package-wide Rules metadata used by CLI delivery edges. */
+export declare const RULES_COMMAND_CATEGORY = "rules";
+export declare const RULES_CAPABILITIES: readonly ["rules.config.validate"];
+export declare const RULES_PACKAGE_VERSION: string;
+//# sourceMappingURL=rules.d.ts.map

package/dist/constants/rules.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rules.d.ts","sourceRoot":"","sources":["../../src/constants/rules.ts"],"names":[],"mappings":"AAEA,+DAA+D;AAC/D,eAAO,MAAM,sBAAsB,UAAU,CAAC;AAC9C,eAAO,MAAM,kBAAkB,oCAAqC,CAAC;AACrE,eAAO,MAAM,qBAAqB,QAAsB,CAAC"}

package/dist/constants/rules.js

@@ -0,0 +1,6 @@
+import packageJson from '../../package.json';
+/*** Package-wide Rules metadata used by CLI delivery edges. */
+export const RULES_COMMAND_CATEGORY = 'rules';
+export const RULES_CAPABILITIES = ['rules.config.validate'];
+export const RULES_PACKAGE_VERSION = packageJson.version;
+//# sourceMappingURL=rules.js.map

package/dist/constants/rules.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rules.js","sourceRoot":"","sources":["../../src/constants/rules.ts"],"names":[],"mappings":"AAAA,OAAO,WAAW,MAAM,oBAAoB,CAAC;AAE7C,+DAA+D;AAC/D,MAAM,CAAC,MAAM,sBAAsB,GAAG,OAAO,CAAC;AAC9C,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,uBAAuB,CAAU,CAAC;AACrE,MAAM,CAAC,MAAM,qBAAqB,GAAG,WAAW,CAAC,OAAO,CAAC","sourcesContent":["import packageJson from '../../package.json';\n\n/*** Package-wide Rules metadata used by CLI delivery edges. */\nexport const RULES_COMMAND_CATEGORY = 'rules';\nexport const RULES_CAPABILITIES = ['rules.config.validate'] as const;\nexport const RULES_PACKAGE_VERSION = packageJson.version;\n"]}

package/dist/features/configuration/adapters/filesystem/readRulesConfigSourceAsync.d.ts

@@ -0,0 +1,3 @@
+/*** Read serialized Rules configuration at the filesystem edge. */
+export declare function readRulesConfigSourceAsync(path: string): Promise<string>;
+//# sourceMappingURL=readRulesConfigSourceAsync.d.ts.map

package/dist/features/configuration/adapters/filesystem/readRulesConfigSourceAsync.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"readRulesConfigSourceAsync.d.ts","sourceRoot":"","sources":["../../../../../src/features/configuration/adapters/filesystem/readRulesConfigSourceAsync.ts"],"names":[],"mappings":"AAEA,mEAAmE;AACnE,wBAAsB,0BAA0B,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAE9E"}

package/dist/features/configuration/adapters/filesystem/readRulesConfigSourceAsync.js

@@ -0,0 +1,6 @@
+import { readFile } from 'node:fs/promises';
+/*** Read serialized Rules configuration at the filesystem edge. */
+export async function readRulesConfigSourceAsync(path) {
+    return await readFile(path, 'utf8');
+}
+//# sourceMappingURL=readRulesConfigSourceAsync.js.map

package/dist/features/configuration/adapters/filesystem/readRulesConfigSourceAsync.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"readRulesConfigSourceAsync.js","sourceRoot":"","sources":["../../../../../src/features/configuration/adapters/filesystem/readRulesConfigSourceAsync.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAE5C,mEAAmE;AACnE,MAAM,CAAC,KAAK,UAAU,0BAA0B,CAAC,IAAY;IAC3D,OAAO,MAAM,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;AACtC,CAAC","sourcesContent":["import { readFile } from 'node:fs/promises';\n\n/*** Read serialized Rules configuration at the filesystem edge. */\nexport async function readRulesConfigSourceAsync(path: string): Promise<string> {\n  return await readFile(path, 'utf8');\n}\n"]}

package/dist/features/configuration/adapters/filesystem/writeRulesConfigAsync.d.ts

@@ -0,0 +1,4 @@
+import type { RulesConfig } from '../../../../types/rules.js';
+/*** Validate and atomically write canonical rules.json configuration through the filesystem adapter. */
+export declare function writeRulesConfigAsync(path: string, config: RulesConfig): Promise<void>;
+//# sourceMappingURL=writeRulesConfigAsync.d.ts.map

package/dist/features/configuration/adapters/filesystem/writeRulesConfigAsync.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"writeRulesConfigAsync.d.ts","sourceRoot":"","sources":["../../../../../src/features/configuration/adapters/filesystem/writeRulesConfigAsync.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAI9D,wGAAwG;AACxG,wBAAsB,qBAAqB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAO5F"}

package/dist/features/configuration/adapters/filesystem/writeRulesConfigAsync.js

@@ -0,0 +1,19 @@
+import { writeJsonFileAtomic } from '@ankhorage/utility/node/fs';
+import { compareRuleEntityIds } from '../../../../utils/compareRuleEntityIds.js';
+import { validateRulesConfig } from '../../domain/validateRulesConfig.js';
+/*** Validate and atomically write canonical rules.json configuration through the filesystem adapter. */
+export async function writeRulesConfigAsync(path, config) {
+    const validation = validateRulesConfig(config);
+    if (validation.config === null) {
+        throw new Error(validation.diagnostics.map((diagnostic) => diagnostic.message).join('\n'));
+    }
+    await writeJsonFileAtomic(path, canonicalizeRulesConfig(validation.config));
+}
+/*** Canonicalize rule selection order so writing preserves deterministic configuration composition. */
+function canonicalizeRulesConfig(config) {
+    return {
+        version: 1,
+        rules: [...config.rules].sort(compareRuleEntityIds),
+    };
+}
+//# sourceMappingURL=writeRulesConfigAsync.js.map

package/dist/features/configuration/adapters/filesystem/writeRulesConfigAsync.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"writeRulesConfigAsync.js","sourceRoot":"","sources":["../../../../../src/features/configuration/adapters/filesystem/writeRulesConfigAsync.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AAGjE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,mBAAmB,EAAE,MAAM,qCAAqC,CAAC;AAE1E,wGAAwG;AACxG,MAAM,CAAC,KAAK,UAAU,qBAAqB,CAAC,IAAY,EAAE,MAAmB;IAC3E,MAAM,UAAU,GAAG,mBAAmB,CAAC,MAAM,CAAC,CAAC;IAC/C,IAAI,UAAU,CAAC,MAAM,KAAK,IAAI,EAAE,CAAC;QAC/B,MAAM,IAAI,KAAK,CAAC,UAAU,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;IAC7F,CAAC;IAED,MAAM,mBAAmB,CAAC,IAAI,EAAE,uBAAuB,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC;AAC9E,CAAC;AAED,uGAAuG;AACvG,SAAS,uBAAuB,CAAC,MAAmB;IAClD,OAAO;QACL,OAAO,EAAE,CAAC;QACV,KAAK,EAAE,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,oBAAoB,CAAC;KACpD,CAAC;AACJ,CAAC","sourcesContent":["import { writeJsonFileAtomic } from '@ankhorage/utility/node/fs';\n\nimport type { RulesConfig } from '../../../../types/rules.js';\nimport { compareRuleEntityIds } from '../../../../utils/compareRuleEntityIds.js';\nimport { validateRulesConfig } from '../../domain/validateRulesConfig.js';\n\n/*** Validate and atomically write canonical rules.json configuration through the filesystem adapter. */\nexport async function writeRulesConfigAsync(path: string, config: RulesConfig): Promise<void> {\n  const validation = validateRulesConfig(config);\n  if (validation.config === null) {\n    throw new Error(validation.diagnostics.map((diagnostic) => diagnostic.message).join('\\n'));\n  }\n\n  await writeJsonFileAtomic(path, canonicalizeRulesConfig(validation.config));\n}\n\n/*** Canonicalize rule selection order so writing preserves deterministic configuration composition. */\nfunction canonicalizeRulesConfig(config: RulesConfig): RulesConfig {\n  return {\n    version: 1,\n    rules: [...config.rules].sort(compareRuleEntityIds),\n  };\n}\n"]}

package/dist/features/configuration/application/validateRulesConfigFileAsync.d.ts

@@ -0,0 +1,4 @@
+import type { RulesConfigReadResult } from '../../../types/rules.js';
+/*** Read and validate one Rules configuration through a caller supplied source reader. */
+export declare function validateRulesConfigFileAsync(path: string, readSourceAsync: (path: string) => Promise<string>): Promise<RulesConfigReadResult>;
+//# sourceMappingURL=validateRulesConfigFileAsync.d.ts.map

package/dist/features/configuration/application/validateRulesConfigFileAsync.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validateRulesConfigFileAsync.d.ts","sourceRoot":"","sources":["../../../../src/features/configuration/application/validateRulesConfigFileAsync.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAyB,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAG5F,0FAA0F;AAC1F,wBAAsB,4BAA4B,CAChD,IAAI,EAAE,MAAM,EACZ,eAAe,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,GACjD,OAAO,CAAC,qBAAqB,CAAC,CAWhC"}

package/dist/features/configuration/application/validateRulesConfigFileAsync.js

@@ -0,0 +1,27 @@
+import { validateRulesConfig } from '../domain/validateRulesConfig.js';
+/*** Read and validate one Rules configuration through a caller supplied source reader. */
+export async function validateRulesConfigFileAsync(path, readSourceAsync) {
+    try {
+        const source = await readSourceAsync(path);
+        return { path, ...validateRulesConfig(parseJson(source)) };
+    }
+    catch (error) {
+        return {
+            path,
+            config: null,
+            diagnostics: [createReadDiagnostic(error)],
+        };
+    }
+}
+/*** Parse JSON without conflating a syntax failure with a valid null configuration. */
+function parseJson(source) {
+    return JSON.parse(source);
+}
+/*** Convert source and JSON failures into a portable configuration diagnostic. */
+function createReadDiagnostic(error) {
+    return {
+        code: 'invalid-config',
+        message: error instanceof Error ? error.message : 'Unable to read rules.json.',
+    };
+}
+//# sourceMappingURL=validateRulesConfigFileAsync.js.map

package/dist/features/configuration/application/validateRulesConfigFileAsync.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validateRulesConfigFileAsync.js","sourceRoot":"","sources":["../../../../src/features/configuration/application/validateRulesConfigFileAsync.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AAEvE,0FAA0F;AAC1F,MAAM,CAAC,KAAK,UAAU,4BAA4B,CAChD,IAAY,EACZ,eAAkD;IAElD,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,eAAe,CAAC,IAAI,CAAC,CAAC;QAC3C,OAAO,EAAE,IAAI,EAAE,GAAG,mBAAmB,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC;IAC7D,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO;YACL,IAAI;YACJ,MAAM,EAAE,IAAI;YACZ,WAAW,EAAE,CAAC,oBAAoB,CAAC,KAAK,CAAC,CAAC;SAC3C,CAAC;IACJ,CAAC;AACH,CAAC;AAED,uFAAuF;AACvF,SAAS,SAAS,CAAC,MAAc;IAC/B,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,CAAY,CAAC;AACvC,CAAC;AAED,kFAAkF;AAClF,SAAS,oBAAoB,CAAC,KAAc;IAC1C,OAAO;QACL,IAAI,EAAE,gBAAgB;QACtB,OAAO,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,4BAA4B;KAC/E,CAAC;AACJ,CAAC","sourcesContent":["import type { RulesConfigDiagnostic, RulesConfigReadResult } from '../../../types/rules.js';\nimport { validateRulesConfig } from '../domain/validateRulesConfig.js';\n\n/*** Read and validate one Rules configuration through a caller supplied source reader. */\nexport async function validateRulesConfigFileAsync(\n  path: string,\n  readSourceAsync: (path: string) => Promise<string>,\n): Promise<RulesConfigReadResult> {\n  try {\n    const source = await readSourceAsync(path);\n    return { path, ...validateRulesConfig(parseJson(source)) };\n  } catch (error) {\n    return {\n      path,\n      config: null,\n      diagnostics: [createReadDiagnostic(error)],\n    };\n  }\n}\n\n/*** Parse JSON without conflating a syntax failure with a valid null configuration. */\nfunction parseJson(source: string): unknown {\n  return JSON.parse(source) as unknown;\n}\n\n/*** Convert source and JSON failures into a portable configuration diagnostic. */\nfunction createReadDiagnostic(error: unknown): RulesConfigDiagnostic {\n  return {\n    code: 'invalid-config',\n    message: error instanceof Error ? error.message : 'Unable to read rules.json.',\n  };\n}\n"]}

package/dist/features/configuration/composition/readRulesConfigAsync.d.ts

@@ -0,0 +1,4 @@
+import type { RulesConfigReadResult } from '../../../types/rules.js';
+/*** Wire the configuration source reader into the public file-validation operation. */
+export declare function readRulesConfigAsync(path: string): Promise<RulesConfigReadResult>;
+//# sourceMappingURL=readRulesConfigAsync.d.ts.map

package/dist/features/configuration/composition/readRulesConfigAsync.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"readRulesConfigAsync.d.ts","sourceRoot":"","sources":["../../../../src/features/configuration/composition/readRulesConfigAsync.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAIrE,uFAAuF;AACvF,wBAAsB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,qBAAqB,CAAC,CAEvF"}

package/dist/features/configuration/composition/readRulesConfigAsync.js

@@ -0,0 +1,7 @@
+import { readRulesConfigSourceAsync } from '../adapters/filesystem/readRulesConfigSourceAsync.js';
+import { validateRulesConfigFileAsync } from '../application/validateRulesConfigFileAsync.js';
+/*** Wire the configuration source reader into the public file-validation operation. */
+export async function readRulesConfigAsync(path) {
+    return await validateRulesConfigFileAsync(path, readRulesConfigSourceAsync);
+}
+//# sourceMappingURL=readRulesConfigAsync.js.map

package/dist/features/configuration/composition/readRulesConfigAsync.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"readRulesConfigAsync.js","sourceRoot":"","sources":["../../../../src/features/configuration/composition/readRulesConfigAsync.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,0BAA0B,EAAE,MAAM,sDAAsD,CAAC;AAClG,OAAO,EAAE,4BAA4B,EAAE,MAAM,gDAAgD,CAAC;AAE9F,uFAAuF;AACvF,MAAM,CAAC,KAAK,UAAU,oBAAoB,CAAC,IAAY;IACrD,OAAO,MAAM,4BAA4B,CAAC,IAAI,EAAE,0BAA0B,CAAC,CAAC;AAC9E,CAAC","sourcesContent":["import type { RulesConfigReadResult } from '../../../types/rules.js';\nimport { readRulesConfigSourceAsync } from '../adapters/filesystem/readRulesConfigSourceAsync.js';\nimport { validateRulesConfigFileAsync } from '../application/validateRulesConfigFileAsync.js';\n\n/*** Wire the configuration source reader into the public file-validation operation. */\nexport async function readRulesConfigAsync(path: string): Promise<RulesConfigReadResult> {\n  return await validateRulesConfigFileAsync(path, readRulesConfigSourceAsync);\n}\n"]}

package/dist/features/configuration/domain/validateRulesConfig.d.ts

@@ -0,0 +1,4 @@
+import type { RulesConfigValidationOptions, RulesConfigValidationResult } from '../../../types/rules.js';
+/*** Validate canonical rules.json data, optionally against a concrete rule registry. */
+export declare function validateRulesConfig<TContext>(value: unknown, options?: RulesConfigValidationOptions<TContext>): RulesConfigValidationResult;
+//# sourceMappingURL=validateRulesConfig.d.ts.map

package/dist/features/configuration/domain/validateRulesConfig.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validateRulesConfig.d.ts","sourceRoot":"","sources":["../../../../src/features/configuration/domain/validateRulesConfig.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAKV,4BAA4B,EAC5B,2BAA2B,EAE5B,MAAM,yBAAyB,CAAC;AAEjC,wFAAwF;AACxF,wBAAgB,mBAAmB,CAAC,QAAQ,EAC1C,KAAK,EAAE,OAAO,EACd,OAAO,GAAE,4BAA4B,CAAC,QAAQ,CAAM,GACnD,2BAA2B,CAS7B"}

package/dist/features/configuration/domain/validateRulesConfig.js

@@ -0,0 +1,159 @@
+import { isRecord } from '@ankhorage/utility/object';
+/*** Validate canonical rules.json data, optionally against a concrete rule registry. */
+export function validateRulesConfig(value, options = {}) {
+    const structuralResult = validateRulesConfigStructure(value);
+    if (structuralResult.config === null)
+        return structuralResult;
+    const diagnostics = validateConfiguredRules(structuralResult.config, options);
+    return {
+        config: diagnostics.length === 0 ? structuralResult.config : null,
+        diagnostics,
+    };
+}
+/*** Validate the JSON-only shape before any provider-specific interpretation occurs. */
+function validateRulesConfigStructure(value) {
+    if (!isRecord(value))
+        return invalidConfig('rules.json must contain an object.');
+    if (value.version !== 1)
+        return invalidConfig('rules.json "version" must be 1.', 'version');
+    if (!Array.isArray(value.rules)) {
+        return invalidConfig('rules.json "rules" must be an array.', 'rules');
+    }
+    const ruleResults = value.rules.map((rule, index) => validateRulesConfigRule(rule, index));
+    const diagnostics = ruleResults.flatMap((result) => result.diagnostics);
+    if (diagnostics.length > 0)
+        return { config: null, diagnostics };
+    const rules = ruleResults.flatMap((result) => (result.rule === null ? [] : [result.rule]));
+    const duplicateIds = findDuplicateRuleIds(rules);
+    if (duplicateIds.length > 0) {
+        return {
+            config: null,
+            diagnostics: duplicateIds.map((id) => ({
+                code: 'invalid-rule-id',
+                message: `rules.json configures rule "${id}" more than once.`,
+                path: 'rules',
+                ruleId: id,
+            })),
+        };
+    }
+    return { config: { version: 1, rules }, diagnostics: [] };
+}
+/*** Validate one serialized rule selection while retaining its original options exactly. */
+function validateRulesConfigRule(value, index) {
+    const path = `rules[${index}]`;
+    if (!isRecord(value)) {
+        return invalidRuleField('invalid-config', path, 'must be an object.');
+    }
+    if (!isNonEmptyString(value.id)) {
+        return invalidRuleField('invalid-rule-id', `${path}.id`, 'must define a non-empty "id".');
+    }
+    if (typeof value.enabled !== 'boolean') {
+        return invalidRuleField('invalid-config', `${path}.enabled`, 'must define boolean "enabled".', value.id);
+    }
+    if (value.severity !== undefined && !isRuleSeverity(value.severity)) {
+        return invalidRuleField('invalid-severity', `${path}.severity`, 'has an invalid "severity".', value.id);
+    }
+    if (value.options !== undefined && !isJsonValue(value.options)) {
+        return invalidRuleField('invalid-options', `${path}.options`, 'has non-serializable "options".', value.id);
+    }
+    return {
+        diagnostics: [],
+        rule: {
+            id: value.id,
+            enabled: value.enabled,
+            ...(value.severity === undefined ? {} : { severity: value.severity }),
+            ...(value.options === undefined ? {} : { options: value.options }),
+        },
+    };
+}
+/*** Apply optional registry and capability knowledge without creating provider-specific engine paths. */
+function validateConfiguredRules(config, options) {
+    const { registry } = options;
+    if (registry === undefined)
+        return [];
+    const availableCapabilities = new Set(options.capabilities ?? []);
+    return config.rules.reduce((diagnostics, configuredRule, index) => {
+        if (!configuredRule.enabled)
+            return diagnostics;
+        const rule = registry.ruleById.get(configuredRule.id);
+        if (rule === undefined) {
+            return [
+                ...diagnostics,
+                {
+                    code: 'unknown-rule',
+                    message: `rules.json configures unknown rule "${configuredRule.id}".`,
+                    path: `rules[${index}].id`,
+                    ruleId: configuredRule.id,
+                },
+            ];
+        }
+        const missingCapabilities = options.capabilities === undefined
+            ? []
+            : (rule.requiredCapabilities ?? []).filter((capability) => !availableCapabilities.has(capability));
+        const capabilityDiagnostics = missingCapabilities.map((capability) => ({
+            code: 'missing-capability',
+            message: `Rule "${rule.id}" requires unavailable capability "${capability}".`,
+            path: `rules[${index}]`,
+            ruleId: rule.id,
+        }));
+        const optionDiagnostics = (rule.validateOptions?.(configuredRule.options) ?? []).map((diagnostic) => ({
+            code: 'invalid-options',
+            message: `Rule "${rule.id}": ${diagnostic.message}`,
+            ruleId: rule.id,
+            ...(diagnostic.path === undefined
+                ? {}
+                : { path: `rules[${index}].options.${diagnostic.path}` }),
+        }));
+        return [...diagnostics, ...capabilityDiagnostics, ...optionDiagnostics];
+    }, []);
+}
+/*** Create a consistent structural configuration diagnostic. */
+function invalidConfig(message, path) {
+    return {
+        config: null,
+        diagnostics: [{ code: 'invalid-config', message, ...(path === undefined ? {} : { path }) }],
+    };
+}
+/*** Create a field-specific diagnostic for one invalid configured rule. */
+function invalidRuleField(code, path, detail, ruleId) {
+    return {
+        rule: null,
+        diagnostics: [
+            {
+                code,
+                message: `rules.json ${path} ${detail}`,
+                path,
+                ...(ruleId === undefined ? {} : { ruleId }),
+            },
+        ],
+    };
+}
+/*** Find duplicate explicit rule selections without relying on object-key ordering. */
+function findDuplicateRuleIds(rules) {
+    const seen = new Set();
+    return rules.flatMap((rule) => {
+        if (seen.has(rule.id))
+            return [rule.id];
+        seen.add(rule.id);
+        return [];
+    });
+}
+/*** Determine whether a value is a supported generic severity. */
+function isRuleSeverity(value) {
+    return value === 'error' || value === 'info' || value === 'warning';
+}
+/*** Determine whether a value can be preserved losslessly in JSON configuration. */
+function isJsonValue(value) {
+    if (value === null || typeof value === 'boolean' || typeof value === 'string')
+        return true;
+    if (typeof value === 'number')
+        return Number.isFinite(value);
+    if (Array.isArray(value))
+        return value.every(isJsonValue);
+    return isRecord(value) && Object.values(value).every(isJsonValue);
+}
+/*** Determine whether a raw configuration field is a non-empty identifier. */
+function isNonEmptyString(value) {
+    return typeof value === 'string' && value.trim().length > 0;
+}
+//# sourceMappingURL=validateRulesConfig.js.map