@webpieces/rules-sdk 0.4.847 → 0.4.848

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@webpieces/rules-sdk",
-  "version": "0.4.847",
+  "version": "0.4.848",
   "description": "Pure schema and rule pack value contracts.",
   "type": "commonjs",
   "main": "./src/index.js",

package/src/index.d.ts

@@ -1,9 +1,13 @@
 export { FieldDef } from './field-def';
 export type { SchemaShape } from './field-def';
 export { BaseRuleConfig, BASE_RULE_SCHEMA } from './base-rule-config';
-export { RULE_PACK_API_VERSION, RULE_SCHEMA_API_VERSION, ConfigObject, OwnedRuleDefinition, RuleContribution, RulePackManifest, RulePackDeclaration } from './rule-pack';
+export { RULE_PACK_API_VERSION, RULE_SCHEMA_API_VERSION, ConfigObject, RuleHelp, OwnedRuleDefinition, RuleContribution, RulePackManifest, RulePackDeclaration, } from './rule-pack';
 export type { ExecutionKind, ConfigValue } from './rule-pack';
 export { FILE_LIMIT_MODES, MODIFIED_CODE_MODES, ON_OFF_MODES } from './scope-modes';
 export type { FileLimitMode, ModifiedCodeMode, OnOffMode } from './scope-modes';
 export { RetiredConfigKey, SafeguardDefinition } from './rule-pack';
 export type { RuleConfigSection } from './rule-pack';
+export { PolicyRuntimeRequest, BuildPolicyResult } from './rule-runtime';
+export type { BuildPolicy, BuildRuleRuntime } from './rule-runtime';
+export { PolicyDebugSelection, BuildDebugRequest } from './rule-runtime';
+export type { BuildDebugRuntime } from './rule-runtime';

package/src/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.SafeguardDefinition = exports.RetiredConfigKey = exports.ON_OFF_MODES = exports.MODIFIED_CODE_MODES = exports.FILE_LIMIT_MODES = exports.RulePackDeclaration = exports.RulePackManifest = exports.RuleContribution = exports.OwnedRuleDefinition = exports.ConfigObject = exports.RULE_SCHEMA_API_VERSION = exports.RULE_PACK_API_VERSION = exports.BASE_RULE_SCHEMA = exports.BaseRuleConfig = exports.FieldDef = void 0;
+exports.BuildDebugRequest = exports.PolicyDebugSelection = exports.BuildPolicyResult = exports.PolicyRuntimeRequest = exports.SafeguardDefinition = exports.RetiredConfigKey = exports.ON_OFF_MODES = exports.MODIFIED_CODE_MODES = exports.FILE_LIMIT_MODES = exports.RulePackDeclaration = exports.RulePackManifest = exports.RuleContribution = exports.OwnedRuleDefinition = exports.RuleHelp = exports.ConfigObject = exports.RULE_SCHEMA_API_VERSION = exports.RULE_PACK_API_VERSION = exports.BASE_RULE_SCHEMA = exports.BaseRuleConfig = exports.FieldDef = void 0;
 var field_def_1 = require("./field-def");
 Object.defineProperty(exports, "FieldDef", { enumerable: true, get: function () { return field_def_1.FieldDef; } });
 var base_rule_config_1 = require("./base-rule-config");
@@ -10,6 +10,7 @@ var rule_pack_1 = require("./rule-pack");
 Object.defineProperty(exports, "RULE_PACK_API_VERSION", { enumerable: true, get: function () { return rule_pack_1.RULE_PACK_API_VERSION; } });
 Object.defineProperty(exports, "RULE_SCHEMA_API_VERSION", { enumerable: true, get: function () { return rule_pack_1.RULE_SCHEMA_API_VERSION; } });
 Object.defineProperty(exports, "ConfigObject", { enumerable: true, get: function () { return rule_pack_1.ConfigObject; } });
+Object.defineProperty(exports, "RuleHelp", { enumerable: true, get: function () { return rule_pack_1.RuleHelp; } });
 Object.defineProperty(exports, "OwnedRuleDefinition", { enumerable: true, get: function () { return rule_pack_1.OwnedRuleDefinition; } });
 Object.defineProperty(exports, "RuleContribution", { enumerable: true, get: function () { return rule_pack_1.RuleContribution; } });
 Object.defineProperty(exports, "RulePackManifest", { enumerable: true, get: function () { return rule_pack_1.RulePackManifest; } });
@@ -21,4 +22,10 @@ Object.defineProperty(exports, "ON_OFF_MODES", { enumerable: true, get: function
 var rule_pack_2 = require("./rule-pack");
 Object.defineProperty(exports, "RetiredConfigKey", { enumerable: true, get: function () { return rule_pack_2.RetiredConfigKey; } });
 Object.defineProperty(exports, "SafeguardDefinition", { enumerable: true, get: function () { return rule_pack_2.SafeguardDefinition; } });
+var rule_runtime_1 = require("./rule-runtime");
+Object.defineProperty(exports, "PolicyRuntimeRequest", { enumerable: true, get: function () { return rule_runtime_1.PolicyRuntimeRequest; } });
+Object.defineProperty(exports, "BuildPolicyResult", { enumerable: true, get: function () { return rule_runtime_1.BuildPolicyResult; } });
+var rule_runtime_2 = require("./rule-runtime");
+Object.defineProperty(exports, "PolicyDebugSelection", { enumerable: true, get: function () { return rule_runtime_2.PolicyDebugSelection; } });
+Object.defineProperty(exports, "BuildDebugRequest", { enumerable: true, get: function () { return rule_runtime_2.BuildDebugRequest; } });
 //# sourceMappingURL=index.js.map

package/src/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../packages/tooling/rules-sdk/src/index.ts"],"names":[],"mappings":";;;AAAA,yCAAuC;AAA9B,qGAAA,QAAQ,OAAA;AAEjB,uDAAsE;AAA7D,kHAAA,cAAc,OAAA;AAAE,oHAAA,gBAAgB,OAAA;AACzC,yCAAyK;AAAhK,kHAAA,qBAAqB,OAAA;AAAE,oHAAA,uBAAuB,OAAA;AAAE,yGAAA,YAAY,OAAA;AAAE,gHAAA,mBAAmB,OAAA;AAAE,6GAAA,gBAAgB,OAAA;AAAE,6GAAA,gBAAgB,OAAA;AAAE,gHAAA,mBAAmB,OAAA;AAEnJ,6CAAoF;AAA3E,+GAAA,gBAAgB,OAAA;AAAE,kHAAA,mBAAmB,OAAA;AAAE,2GAAA,YAAY,OAAA;AAG5D,yCAAoE;AAA3D,6GAAA,gBAAgB,OAAA;AAAE,gHAAA,mBAAmB,OAAA","sourcesContent":["export { FieldDef } from './field-def';\nexport type { SchemaShape } from './field-def';\nexport { BaseRuleConfig, BASE_RULE_SCHEMA } from './base-rule-config';\nexport { RULE_PACK_API_VERSION, RULE_SCHEMA_API_VERSION, ConfigObject, OwnedRuleDefinition, RuleContribution, RulePackManifest, RulePackDeclaration } from './rule-pack';\nexport type { ExecutionKind, ConfigValue } from './rule-pack';\nexport { FILE_LIMIT_MODES, MODIFIED_CODE_MODES, ON_OFF_MODES } from './scope-modes';\nexport type { FileLimitMode, ModifiedCodeMode, OnOffMode } from './scope-modes';\n\nexport { RetiredConfigKey, SafeguardDefinition } from './rule-pack';\nexport type { RuleConfigSection } from './rule-pack';\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../packages/tooling/rules-sdk/src/index.ts"],"names":[],"mappings":";;;AAAA,yCAAuC;AAA9B,qGAAA,QAAQ,OAAA;AAEjB,uDAAsE;AAA7D,kHAAA,cAAc,OAAA;AAAE,oHAAA,gBAAgB,OAAA;AACzC,yCASqB;AARjB,kHAAA,qBAAqB,OAAA;AACrB,oHAAA,uBAAuB,OAAA;AACvB,yGAAA,YAAY,OAAA;AACZ,qGAAA,QAAQ,OAAA;AACR,gHAAA,mBAAmB,OAAA;AACnB,6GAAA,gBAAgB,OAAA;AAChB,6GAAA,gBAAgB,OAAA;AAChB,gHAAA,mBAAmB,OAAA;AAGvB,6CAAoF;AAA3E,+GAAA,gBAAgB,OAAA;AAAE,kHAAA,mBAAmB,OAAA;AAAE,2GAAA,YAAY,OAAA;AAG5D,yCAAoE;AAA3D,6GAAA,gBAAgB,OAAA;AAAE,gHAAA,mBAAmB,OAAA;AAE9C,+CAAyE;AAAhE,oHAAA,oBAAoB,OAAA;AAAE,iHAAA,iBAAiB,OAAA;AAEhD,+CAAyE;AAAhE,oHAAA,oBAAoB,OAAA;AAAE,iHAAA,iBAAiB,OAAA","sourcesContent":["export { FieldDef } from './field-def';\nexport type { SchemaShape } from './field-def';\nexport { BaseRuleConfig, BASE_RULE_SCHEMA } from './base-rule-config';\nexport {\n    RULE_PACK_API_VERSION,\n    RULE_SCHEMA_API_VERSION,\n    ConfigObject,\n    RuleHelp,\n    OwnedRuleDefinition,\n    RuleContribution,\n    RulePackManifest,\n    RulePackDeclaration,\n} from './rule-pack';\nexport type { ExecutionKind, ConfigValue } from './rule-pack';\nexport { FILE_LIMIT_MODES, MODIFIED_CODE_MODES, ON_OFF_MODES } from './scope-modes';\nexport type { FileLimitMode, ModifiedCodeMode, OnOffMode } from './scope-modes';\n\nexport { RetiredConfigKey, SafeguardDefinition } from './rule-pack';\nexport type { RuleConfigSection } from './rule-pack';\nexport { PolicyRuntimeRequest, BuildPolicyResult } from './rule-runtime';\nexport type { BuildPolicy, BuildRuleRuntime } from './rule-runtime';\nexport { PolicyDebugSelection, BuildDebugRequest } from './rule-runtime';\nexport type { BuildDebugRuntime } from './rule-runtime';\n"]}

package/src/policy-debug-selection.typecheck.d.ts

@@ -0,0 +1 @@
+export {};

package/src/policy-debug-selection.typecheck.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+/** Compiled with the SDK: debug selection cannot accept an absent rule. */
+class PolicyDebugSelectionTypeCheck {
+    requireRule() {
+        const acceptsUndefined = false;
+        void acceptsUndefined;
+    }
+}
+new PolicyDebugSelectionTypeCheck().requireRule();
+//# sourceMappingURL=policy-debug-selection.typecheck.js.map

package/src/policy-debug-selection.typecheck.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"policy-debug-selection.typecheck.js","sourceRoot":"","sources":["../../../../../packages/tooling/rules-sdk/src/policy-debug-selection.typecheck.ts"],"names":[],"mappings":";;AAEA,2EAA2E;AAC3E,MAAM,6BAA6B;IAC/B,WAAW;QACP,MAAM,gBAAgB,GAIR,KAAK,CAAC;QACpB,KAAK,gBAAgB,CAAC;IAC1B,CAAC;CACJ;AAED,IAAI,6BAA6B,EAAE,CAAC,WAAW,EAAE,CAAC","sourcesContent":["import { PolicyDebugSelection } from './rule-runtime';\n\n/** Compiled with the SDK: debug selection cannot accept an absent rule. */\nclass PolicyDebugSelectionTypeCheck {\n    requireRule(): void {\n        const acceptsUndefined: undefined extends ConstructorParameters<\n            typeof PolicyDebugSelection\n        >[0]\n            ? true\n            : false = false;\n        void acceptsUndefined;\n    }\n}\n\nnew PolicyDebugSelectionTypeCheck().requireRule();\n"]}

package/src/rule-pack.d.ts

@@ -1,12 +1,18 @@
 import { FieldDef } from './field-def';
 /** Versioned independently from npm releases: incompatible contracts require an explicit bump. */
-export declare const RULE_PACK_API_VERSION = 2;
+export declare const RULE_PACK_API_VERSION = 3;
 export declare const RULE_SCHEMA_API_VERSION = 1;
 export type ExecutionKind = 'build' | 'source-hook' | 'workflow-guard' | 'lint';
 export type ConfigValue = string | number | boolean | null | ConfigValue[] | ConfigObject;
 export declare class ConfigObject {
     [key: string]: ConfigValue;
 }
+/** Owner-authored catalog guidance; {configFile} is replaced by the client's exact declaration. */
+export declare class RuleHelp {
+    readonly description: string;
+    readonly remediation: string;
+    constructor(description: string, remediation: string);
+}
 /** The single owner supplies the configuration schema, regardless of implementation count. */
 export declare class OwnedRuleDefinition {
     readonly id: string;
@@ -15,14 +21,16 @@ export declare class OwnedRuleDefinition {
     readonly optionalTuning: ConfigObject;
     readonly recommendedSeed: ConfigObject;
     readonly section: RuleConfigSection;
-    constructor(id: string, schema: Readonly<Record<string, FieldDef>>, schemaApiVersion: number, optionalTuning: ConfigObject, recommendedSeed: ConfigObject, section: RuleConfigSection);
+    readonly help: RuleHelp;
+    constructor(id: string, schema: Readonly<Record<string, FieldDef>>, schemaApiVersion: number, optionalTuning: ConfigObject, recommendedSeed: ConfigObject, section: RuleConfigSection, help: RuleHelp);
 }
 /** Each pack may implement an owned rule or contribute an execution kind to another owner. */
 export declare class RuleContribution {
     readonly ruleId: string;
     readonly ownerPack: string;
     readonly executionKind: ExecutionKind;
-    constructor(ruleId: string, ownerPack: string, executionKind: ExecutionKind);
+    readonly implementationModule: string;
+    constructor(ruleId: string, ownerPack: string, executionKind: ExecutionKind, implementationModule: string);
 }
 export declare class RulePackManifest {
     readonly packageName: string;

package/src/rule-pack.js

@@ -1,12 +1,22 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.RetiredConfigKey = exports.SafeguardDefinition = exports.RulePackDeclaration = exports.RulePackManifest = exports.RuleContribution = exports.OwnedRuleDefinition = exports.ConfigObject = exports.RULE_SCHEMA_API_VERSION = exports.RULE_PACK_API_VERSION = void 0;
+exports.RetiredConfigKey = exports.SafeguardDefinition = exports.RulePackDeclaration = exports.RulePackManifest = exports.RuleContribution = exports.OwnedRuleDefinition = exports.RuleHelp = exports.ConfigObject = exports.RULE_SCHEMA_API_VERSION = exports.RULE_PACK_API_VERSION = void 0;
 /** Versioned independently from npm releases: incompatible contracts require an explicit bump. */
-exports.RULE_PACK_API_VERSION = 2;
+exports.RULE_PACK_API_VERSION = 3;
 exports.RULE_SCHEMA_API_VERSION = 1;
 class ConfigObject {
 }
 exports.ConfigObject = ConfigObject;
+/** Owner-authored catalog guidance; {configFile} is replaced by the client's exact declaration. */
+class RuleHelp {
+    description;
+    remediation;
+    constructor(description, remediation) {
+        this.description = description;
+        this.remediation = remediation;
+    }
+}
+exports.RuleHelp = RuleHelp;
 /** The single owner supplies the configuration schema, regardless of implementation count. */
 class OwnedRuleDefinition {
     id;
@@ -15,14 +25,16 @@ class OwnedRuleDefinition {
     optionalTuning;
     recommendedSeed;
     section;
+    help;
     // eslint-disable-next-line @typescript-eslint/max-params
-    constructor(id, schema, schemaApiVersion, optionalTuning, recommendedSeed, section) {
+    constructor(id, schema, schemaApiVersion, optionalTuning, recommendedSeed, section, help) {
         this.id = id;
         this.schema = schema;
         this.schemaApiVersion = schemaApiVersion;
         this.optionalTuning = optionalTuning;
         this.recommendedSeed = recommendedSeed;
         this.section = section;
+        this.help = help;
     }
 }
 exports.OwnedRuleDefinition = OwnedRuleDefinition;
@@ -31,10 +43,12 @@ class RuleContribution {
     ruleId;
     ownerPack;
     executionKind;
-    constructor(ruleId, ownerPack, executionKind) {
+    implementationModule;
+    constructor(ruleId, ownerPack, executionKind, implementationModule) {
         this.ruleId = ruleId;
         this.ownerPack = ownerPack;
         this.executionKind = executionKind;
+        this.implementationModule = implementationModule;
     }
 }
 exports.RuleContribution = RuleContribution;

package/src/rule-pack.js.map

@@ -1 +1 @@
-{"version":3,"file":"rule-pack.js","sourceRoot":"","sources":["../../../../../packages/tooling/rules-sdk/src/rule-pack.ts"],"names":[],"mappings":";;;AAEA,kGAAkG;AACrF,QAAA,qBAAqB,GAAG,CAAC,CAAC;AAC1B,QAAA,uBAAuB,GAAG,CAAC,CAAC;AAGzC,MAAa,YAAY;CAExB;AAFD,oCAEC;AAED,8FAA8F;AAC9F,MAAa,mBAAmB;IAGf;IACA;IACA;IACA;IACA;IACA;IAPb,yDAAyD;IACzD,YACa,EAAU,EACV,MAA0C,EAC1C,gBAAwB,EACxB,cAA4B,EAC5B,eAA6B,EAC7B,OAA0B;QAL1B,OAAE,GAAF,EAAE,CAAQ;QACV,WAAM,GAAN,MAAM,CAAoC;QAC1C,qBAAgB,GAAhB,gBAAgB,CAAQ;QACxB,mBAAc,GAAd,cAAc,CAAc;QAC5B,oBAAe,GAAf,eAAe,CAAc;QAC7B,YAAO,GAAP,OAAO,CAAmB;IACpC,CAAC;CACP;AAVD,kDAUC;AAED,8FAA8F;AAC9F,MAAa,gBAAgB;IAEZ;IACA;IACA;IAHb,YACa,MAAc,EACd,SAAiB,EACjB,aAA4B;QAF5B,WAAM,GAAN,MAAM,CAAQ;QACd,cAAS,GAAT,SAAS,CAAQ;QACjB,kBAAa,GAAb,aAAa,CAAe;IACtC,CAAC;CACP;AAND,4CAMC;AAED,MAAa,gBAAgB;IAGZ;IACA;IACA;IACA;IACA;IACA;IACA;IARb,yDAAyD;IACzD,YACa,WAAmB,EACnB,cAAsB,EACtB,UAAkB,EAClB,UAA0C,EAC1C,aAA0C,EAC1C,UAAuC,EACvC,UAA0C;QAN1C,gBAAW,GAAX,WAAW,CAAQ;QACnB,mBAAc,GAAd,cAAc,CAAQ;QACtB,eAAU,GAAV,UAAU,CAAQ;QAClB,eAAU,GAAV,UAAU,CAAgC;QAC1C,kBAAa,GAAb,aAAa,CAA6B;QAC1C,eAAU,GAAV,UAAU,CAA6B;QACvC,eAAU,GAAV,UAAU,CAAgC;IACpD,CAAC;CACP;AAXD,4CAWC;AAED,mGAAmG;AACnG,MAAa,mBAAmB;IACP;IAArB,YAAqB,MAAc;QAAd,WAAM,GAAN,MAAM,CAAQ;IAAG,CAAC;CAC1C;AAFD,kDAEC;AAID,0GAA0G;AAC1G,MAAa,mBAAmB;IACP;IAAqB;IAA+C;IAAzF,YAAqB,EAAU,EAAW,UAAoC,EAAW,WAAmB;QAAvF,OAAE,GAAF,EAAE,CAAQ;QAAW,eAAU,GAAV,UAAU,CAA0B;QAAW,gBAAW,GAAX,WAAW,CAAQ;IAAG,CAAC;CACnH;AAFD,kDAEC;AAED,8GAA8G;AAC9G,MAAa,gBAAgB;IAGZ;IAAwB;IAAsB;IAC9C;IAA8B;IAAwB;IAHnE,yDAAyD;IACzD,YACa,KAAa,EAAW,GAAW,EAAW,OAAe,EAC7D,WAAmB,EAAW,KAAa,EAAW,QAAiB;QADvE,UAAK,GAAL,KAAK,CAAQ;QAAW,QAAG,GAAH,GAAG,CAAQ;QAAW,YAAO,GAAP,OAAO,CAAQ;QAC7D,gBAAW,GAAX,WAAW,CAAQ;QAAW,UAAK,GAAL,KAAK,CAAQ;QAAW,aAAQ,GAAR,QAAQ,CAAS;IACjF,CAAC;CACP;AAND,4CAMC","sourcesContent":["import { FieldDef } from './field-def';\n\n/** Versioned independently from npm releases: incompatible contracts require an explicit bump. */\nexport const RULE_PACK_API_VERSION = 2;\nexport const RULE_SCHEMA_API_VERSION = 1;\nexport type ExecutionKind = 'build' | 'source-hook' | 'workflow-guard' | 'lint';\nexport type ConfigValue = string | number | boolean | null | ConfigValue[] | ConfigObject;\nexport class ConfigObject {\n    [key: string]: ConfigValue;\n}\n\n/** The single owner supplies the configuration schema, regardless of implementation count. */\nexport class OwnedRuleDefinition {\n    // eslint-disable-next-line @typescript-eslint/max-params\n    constructor(\n        readonly id: string,\n        readonly schema: Readonly<Record<string, FieldDef>>,\n        readonly schemaApiVersion: number,\n        readonly optionalTuning: ConfigObject,\n        readonly recommendedSeed: ConfigObject,\n        readonly section: RuleConfigSection,\n    ) {}\n}\n\n/** Each pack may implement an owned rule or contribute an execution kind to another owner. */\nexport class RuleContribution {\n    constructor(\n        readonly ruleId: string,\n        readonly ownerPack: string,\n        readonly executionKind: ExecutionKind,\n    ) {}\n}\n\nexport class RulePackManifest {\n    // eslint-disable-next-line @typescript-eslint/max-params\n    constructor(\n        readonly packageName: string,\n        readonly packageVersion: string,\n        readonly apiVersion: number,\n        readonly ownedRules: readonly OwnedRuleDefinition[],\n        readonly contributions: readonly RuleContribution[],\n        readonly migrations: readonly RetiredConfigKey[],\n        readonly safeguards: readonly SafeguardDefinition[],\n    ) {}\n}\n\n/** Explicit module declarations let a client add packs without a central built-in package list. */\nexport class RulePackDeclaration {\n    constructor(readonly module: string) {}\n}\n\nexport type RuleConfigSection = 'rules' | 'hookGuards' | 'lint';\n\n/** A fixed invariant has no config switch; experimental safeguards require a separate explicit opt-in. */\nexport class SafeguardDefinition {\n    constructor(readonly id: string, readonly activation: 'fixed' | 'experimental', readonly description: string) {}\n}\n\n/** Owner-provided migration instructions are data; the framework rejects rather than aliases retired keys. */\nexport class RetiredConfigKey {\n    // eslint-disable-next-line @typescript-eslint/max-params\n    constructor(\n        readonly scope: string, readonly key: string, readonly movedTo: string,\n        readonly instruction: string, readonly label: string, readonly prunable: boolean,\n    ) {}\n}\n"]}
+{"version":3,"file":"rule-pack.js","sourceRoot":"","sources":["../../../../../packages/tooling/rules-sdk/src/rule-pack.ts"],"names":[],"mappings":";;;AAEA,kGAAkG;AACrF,QAAA,qBAAqB,GAAG,CAAC,CAAC;AAC1B,QAAA,uBAAuB,GAAG,CAAC,CAAC;AAGzC,MAAa,YAAY;CAExB;AAFD,oCAEC;AAED,mGAAmG;AACnG,MAAa,QAAQ;IAEJ;IACA;IAFb,YACa,WAAmB,EACnB,WAAmB;QADnB,gBAAW,GAAX,WAAW,CAAQ;QACnB,gBAAW,GAAX,WAAW,CAAQ;IAC7B,CAAC;CACP;AALD,4BAKC;AAED,8FAA8F;AAC9F,MAAa,mBAAmB;IAGf;IACA;IACA;IACA;IACA;IACA;IACA;IARb,yDAAyD;IACzD,YACa,EAAU,EACV,MAA0C,EAC1C,gBAAwB,EACxB,cAA4B,EAC5B,eAA6B,EAC7B,OAA0B,EAC1B,IAAc;QANd,OAAE,GAAF,EAAE,CAAQ;QACV,WAAM,GAAN,MAAM,CAAoC;QAC1C,qBAAgB,GAAhB,gBAAgB,CAAQ;QACxB,mBAAc,GAAd,cAAc,CAAc;QAC5B,oBAAe,GAAf,eAAe,CAAc;QAC7B,YAAO,GAAP,OAAO,CAAmB;QAC1B,SAAI,GAAJ,IAAI,CAAU;IACxB,CAAC;CACP;AAXD,kDAWC;AAED,8FAA8F;AAC9F,MAAa,gBAAgB;IAEZ;IACA;IACA;IACA;IAJb,YACa,MAAc,EACd,SAAiB,EACjB,aAA4B,EAC5B,oBAA4B;QAH5B,WAAM,GAAN,MAAM,CAAQ;QACd,cAAS,GAAT,SAAS,CAAQ;QACjB,kBAAa,GAAb,aAAa,CAAe;QAC5B,yBAAoB,GAApB,oBAAoB,CAAQ;IACtC,CAAC;CACP;AAPD,4CAOC;AAED,MAAa,gBAAgB;IAGZ;IACA;IACA;IACA;IACA;IACA;IACA;IARb,yDAAyD;IACzD,YACa,WAAmB,EACnB,cAAsB,EACtB,UAAkB,EAClB,UAA0C,EAC1C,aAA0C,EAC1C,UAAuC,EACvC,UAA0C;QAN1C,gBAAW,GAAX,WAAW,CAAQ;QACnB,mBAAc,GAAd,cAAc,CAAQ;QACtB,eAAU,GAAV,UAAU,CAAQ;QAClB,eAAU,GAAV,UAAU,CAAgC;QAC1C,kBAAa,GAAb,aAAa,CAA6B;QAC1C,eAAU,GAAV,UAAU,CAA6B;QACvC,eAAU,GAAV,UAAU,CAAgC;IACpD,CAAC;CACP;AAXD,4CAWC;AAED,mGAAmG;AACnG,MAAa,mBAAmB;IACP;IAArB,YAAqB,MAAc;QAAd,WAAM,GAAN,MAAM,CAAQ;IAAG,CAAC;CAC1C;AAFD,kDAEC;AAID,0GAA0G;AAC1G,MAAa,mBAAmB;IAEf;IACA;IACA;IAHb,YACa,EAAU,EACV,UAAoC,EACpC,WAAmB;QAFnB,OAAE,GAAF,EAAE,CAAQ;QACV,eAAU,GAAV,UAAU,CAA0B;QACpC,gBAAW,GAAX,WAAW,CAAQ;IAC7B,CAAC;CACP;AAND,kDAMC;AAED,8GAA8G;AAC9G,MAAa,gBAAgB;IAGZ;IACA;IACA;IACA;IACA;IACA;IAPb,yDAAyD;IACzD,YACa,KAAa,EACb,GAAW,EACX,OAAe,EACf,WAAmB,EACnB,KAAa,EACb,QAAiB;QALjB,UAAK,GAAL,KAAK,CAAQ;QACb,QAAG,GAAH,GAAG,CAAQ;QACX,YAAO,GAAP,OAAO,CAAQ;QACf,gBAAW,GAAX,WAAW,CAAQ;QACnB,UAAK,GAAL,KAAK,CAAQ;QACb,aAAQ,GAAR,QAAQ,CAAS;IAC3B,CAAC;CACP;AAVD,4CAUC","sourcesContent":["import { FieldDef } from './field-def';\n\n/** Versioned independently from npm releases: incompatible contracts require an explicit bump. */\nexport const RULE_PACK_API_VERSION = 3;\nexport const RULE_SCHEMA_API_VERSION = 1;\nexport type ExecutionKind = 'build' | 'source-hook' | 'workflow-guard' | 'lint';\nexport type ConfigValue = string | number | boolean | null | ConfigValue[] | ConfigObject;\nexport class ConfigObject {\n    [key: string]: ConfigValue;\n}\n\n/** Owner-authored catalog guidance; {configFile} is replaced by the client's exact declaration. */\nexport class RuleHelp {\n    constructor(\n        readonly description: string,\n        readonly remediation: string,\n    ) {}\n}\n\n/** The single owner supplies the configuration schema, regardless of implementation count. */\nexport class OwnedRuleDefinition {\n    // eslint-disable-next-line @typescript-eslint/max-params\n    constructor(\n        readonly id: string,\n        readonly schema: Readonly<Record<string, FieldDef>>,\n        readonly schemaApiVersion: number,\n        readonly optionalTuning: ConfigObject,\n        readonly recommendedSeed: ConfigObject,\n        readonly section: RuleConfigSection,\n        readonly help: RuleHelp,\n    ) {}\n}\n\n/** Each pack may implement an owned rule or contribute an execution kind to another owner. */\nexport class RuleContribution {\n    constructor(\n        readonly ruleId: string,\n        readonly ownerPack: string,\n        readonly executionKind: ExecutionKind,\n        readonly implementationModule: string,\n    ) {}\n}\n\nexport class RulePackManifest {\n    // eslint-disable-next-line @typescript-eslint/max-params\n    constructor(\n        readonly packageName: string,\n        readonly packageVersion: string,\n        readonly apiVersion: number,\n        readonly ownedRules: readonly OwnedRuleDefinition[],\n        readonly contributions: readonly RuleContribution[],\n        readonly migrations: readonly RetiredConfigKey[],\n        readonly safeguards: readonly SafeguardDefinition[],\n    ) {}\n}\n\n/** Explicit module declarations let a client add packs without a central built-in package list. */\nexport class RulePackDeclaration {\n    constructor(readonly module: string) {}\n}\n\nexport type RuleConfigSection = 'rules' | 'hookGuards' | 'lint';\n\n/** A fixed invariant has no config switch; experimental safeguards require a separate explicit opt-in. */\nexport class SafeguardDefinition {\n    constructor(\n        readonly id: string,\n        readonly activation: 'fixed' | 'experimental',\n        readonly description: string,\n    ) {}\n}\n\n/** Owner-provided migration instructions are data; the framework rejects rather than aliases retired keys. */\nexport class RetiredConfigKey {\n    // eslint-disable-next-line @typescript-eslint/max-params\n    constructor(\n        readonly scope: string,\n        readonly key: string,\n        readonly movedTo: string,\n        readonly instruction: string,\n        readonly label: string,\n        readonly prunable: boolean,\n    ) {}\n}\n"]}

package/src/rule-runtime.d.ts

@@ -0,0 +1,36 @@
+import { ConfigObject } from './rule-pack';
+/** Validated owner settings, restricted to the policies supplied by this runtime module. */
+export declare class PolicyRuntimeRequest {
+    readonly workspaceRoot: string;
+    readonly configs: Readonly<Record<string, ConfigObject>>;
+    readonly ruleIds: readonly string[];
+    constructor(workspaceRoot: string, configs: Readonly<Record<string, ConfigObject>>, ruleIds: readonly string[]);
+}
+export declare class BuildPolicyResult {
+    readonly success: boolean;
+    constructor(success: boolean);
+}
+/** A runtime may supply multiple named checks for one configured policy. */
+export interface BuildPolicy {
+    readonly name: string;
+    readonly configKey: string;
+    shouldRun(): boolean;
+    run(workspaceRoot: string): Promise<BuildPolicyResult>;
+}
+export interface BuildRuleRuntime {
+    create(request: PolicyRuntimeRequest): Promise<readonly BuildPolicy[]>;
+}
+export declare class PolicyDebugSelection {
+    readonly rule: string;
+    readonly mode: string | undefined;
+    readonly projects: string | readonly string[] | undefined;
+    constructor(rule: string, mode: string | undefined, projects: string | readonly string[] | undefined);
+}
+export declare class BuildDebugRequest {
+    readonly workspaceRoot: string;
+    readonly selection: PolicyDebugSelection;
+    constructor(workspaceRoot: string, selection: PolicyDebugSelection);
+}
+export interface BuildDebugRuntime {
+    run(request: BuildDebugRequest): Promise<BuildPolicyResult>;
+}

package/src/rule-runtime.js

@@ -0,0 +1,43 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BuildDebugRequest = exports.PolicyDebugSelection = exports.BuildPolicyResult = exports.PolicyRuntimeRequest = void 0;
+/** Validated owner settings, restricted to the policies supplied by this runtime module. */
+class PolicyRuntimeRequest {
+    workspaceRoot;
+    configs;
+    ruleIds;
+    constructor(workspaceRoot, configs, ruleIds) {
+        this.workspaceRoot = workspaceRoot;
+        this.configs = configs;
+        this.ruleIds = ruleIds;
+    }
+}
+exports.PolicyRuntimeRequest = PolicyRuntimeRequest;
+class BuildPolicyResult {
+    success;
+    constructor(success) {
+        this.success = success;
+    }
+}
+exports.BuildPolicyResult = BuildPolicyResult;
+class PolicyDebugSelection {
+    rule;
+    mode;
+    projects;
+    constructor(rule, mode, projects) {
+        this.rule = rule;
+        this.mode = mode;
+        this.projects = projects;
+    }
+}
+exports.PolicyDebugSelection = PolicyDebugSelection;
+class BuildDebugRequest {
+    workspaceRoot;
+    selection;
+    constructor(workspaceRoot, selection) {
+        this.workspaceRoot = workspaceRoot;
+        this.selection = selection;
+    }
+}
+exports.BuildDebugRequest = BuildDebugRequest;
+//# sourceMappingURL=rule-runtime.js.map

package/src/rule-runtime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rule-runtime.js","sourceRoot":"","sources":["../../../../../packages/tooling/rules-sdk/src/rule-runtime.ts"],"names":[],"mappings":";;;AAEA,4FAA4F;AAC5F,MAAa,oBAAoB;IAEhB;IACA;IACA;IAHb,YACa,aAAqB,EACrB,OAA+C,EAC/C,OAA0B;QAF1B,kBAAa,GAAb,aAAa,CAAQ;QACrB,YAAO,GAAP,OAAO,CAAwC;QAC/C,YAAO,GAAP,OAAO,CAAmB;IACpC,CAAC;CACP;AAND,oDAMC;AAED,MAAa,iBAAiB;IACL;IAArB,YAAqB,OAAgB;QAAhB,YAAO,GAAP,OAAO,CAAS;IAAG,CAAC;CAC5C;AAFD,8CAEC;AAcD,MAAa,oBAAoB;IAEhB;IACA;IACA;IAHb,YACa,IAAY,EACZ,IAAwB,EACxB,QAAgD;QAFhD,SAAI,GAAJ,IAAI,CAAQ;QACZ,SAAI,GAAJ,IAAI,CAAoB;QACxB,aAAQ,GAAR,QAAQ,CAAwC;IAC1D,CAAC;CACP;AAND,oDAMC;AAED,MAAa,iBAAiB;IAEb;IACA;IAFb,YACa,aAAqB,EACrB,SAA+B;QAD/B,kBAAa,GAAb,aAAa,CAAQ;QACrB,cAAS,GAAT,SAAS,CAAsB;IACzC,CAAC;CACP;AALD,8CAKC","sourcesContent":["import { ConfigObject } from './rule-pack';\n\n/** Validated owner settings, restricted to the policies supplied by this runtime module. */\nexport class PolicyRuntimeRequest {\n    constructor(\n        readonly workspaceRoot: string,\n        readonly configs: Readonly<Record<string, ConfigObject>>,\n        readonly ruleIds: readonly string[],\n    ) {}\n}\n\nexport class BuildPolicyResult {\n    constructor(readonly success: boolean) {}\n}\n\n/** A runtime may supply multiple named checks for one configured policy. */\nexport interface BuildPolicy {\n    readonly name: string;\n    readonly configKey: string;\n    shouldRun(): boolean;\n    run(workspaceRoot: string): Promise<BuildPolicyResult>;\n}\n\nexport interface BuildRuleRuntime {\n    create(request: PolicyRuntimeRequest): Promise<readonly BuildPolicy[]>;\n}\n\nexport class PolicyDebugSelection {\n    constructor(\n        readonly rule: string,\n        readonly mode: string | undefined,\n        readonly projects: string | readonly string[] | undefined,\n    ) {}\n}\n\nexport class BuildDebugRequest {\n    constructor(\n        readonly workspaceRoot: string,\n        readonly selection: PolicyDebugSelection,\n    ) {}\n}\n\nexport interface BuildDebugRuntime {\n    run(request: BuildDebugRequest): Promise<BuildPolicyResult>;\n}\n"]}