repopo 0.10.0 → 0.13.0

package/esm/makePolicy.js

@@ -1,102 +1,58 @@
-import { call } from "effection";
-import { isGeneratorFunction } from "./generators.js";
-/**
- * Normalizes a handler to always return an Effection Operation.
- * Detection happens once at registration time, not per-invocation.
- */
-function normalizeHandler(handler) {
-    if (isGeneratorFunction(handler)) {
-        // Already a generator, return as-is
-        return handler;
+import { exclusionRegex } from "./context.js";
+export function makePolicy(definition, options, ...extra) {
+    const guidance = "Use makePolicy(definition, { config, exclude, instanceId }); positional config, third arguments and excludeFiles are no longer supported.";
+    if (extra.length > 0 ||
+        (options !== undefined &&
+            (typeof options !== "object" ||
+                options === null ||
+                Array.isArray(options) ||
+                Object.keys(options).some((key) => !["config", "exclude", "instanceId"].includes(key))))) {
+        throw new TypeError(guidance);
     }
-    // Async function - wrap with call()
-    return function* (args) {
-        const asyncHandler = handler;
-        return yield* call(() => asyncHandler(args));
-    };
+    if (definition.scope === "repository" && definition.resolver !== undefined) {
+        throw new TypeError("Repository policies support inline fixes only; remove resolver.");
+    }
+    if (options?.exclude !== undefined &&
+        !(Array.isArray(options.exclude) &&
+            options.exclude.every((value) => typeof value === "string" || value instanceof RegExp))) {
+        throw new TypeError(guidance);
+    }
+    if (options?.instanceId !== undefined &&
+        (typeof options.instanceId !== "string" || options.instanceId.length === 0)) {
+        throw new TypeError("instanceId must be a nonempty string.");
+    }
+    options?.exclude?.forEach(exclusionRegex);
+    const config = options?.config === undefined ? definition.defaultConfig : options.config;
+    if (definition.requiresConfig && config === undefined) {
+        throw new TypeError(`Policy '${definition.name}' requires config. ${guidance}`);
+    }
+    return { ...definition, ...options, config };
 }
-/** @alpha */
-export function policy(policyDef, configOrOptions, maybeOptions) {
-    // Determine if the second argument is config or options
-    let config;
-    let options;
-    if (maybeOptions !== undefined) {
-        // Three-argument form: policy(def, config, options)
-        config = configOrOptions;
-        options = maybeOptions;
+/** Assign stable IDs, rejecting ambiguous duplicates. @internal */
+export function identifyPolicyInstances(policies) {
+    const names = new Map();
+    const ids = new Set();
+    for (const policy of policies) {
+        names.set(policy.name, (names.get(policy.name) ?? 0) + 1);
+        if (policy.instanceId !== undefined) {
+            if (ids.has(policy.instanceId)) {
+                throw new Error(`Duplicate policy instance ID: ${policy.instanceId}`);
+            }
+            ids.add(policy.instanceId);
+        }
     }
-    else if (configOrOptions !== undefined) {
-        // Two-argument form: need to determine if it's config or options
-        // PolicyOptions has a specific shape with 'exclude' property
-        if (typeof configOrOptions === "object" &&
-            configOrOptions !== null &&
-            "exclude" in configOrOptions &&
-            !("name" in configOrOptions) &&
-            Object.keys(configOrOptions).every((k) => k === "exclude")) {
-            // It's options (has only 'exclude')
-            options = configOrOptions;
+    return policies.map((policy) => {
+        if (policy.instanceId !== undefined) {
+            return { ...policy, instanceId: policy.instanceId };
         }
-        else {
-            // It's config
-            config = configOrOptions;
+        if ((names.get(policy.name) ?? 0) > 1) {
+            throw new Error(`Policy '${policy.name}' is configured multiple times. Set a unique instanceId for each instance.`);
         }
-    }
-    // Merge with default config if available
-    const effectiveConfig = config ?? policyDef.defaultConfig;
-    // Support both 'exclude' and 'excludeFiles' for backward compatibility
-    const excludePatterns = options?.exclude;
-    return {
-        ...policyDef,
-        config: effectiveConfig,
-        exclude: excludePatterns,
-        excludeFiles: excludePatterns,
-        _internalHandler: normalizeHandler(policyDef.handler),
-    };
-}
-/**
- * Creates a {@link PolicyDefinition} from the provided arguments.
- *
- * @deprecated Define policies as object literals satisfying {@link PolicyShape} instead.
- *
- * @example
- * ```typescript
- * const MyPolicy = makePolicyDefinition({
- *   name: "MyPolicy",
- *   description: "Ensures files follow conventions",
- *   match: /\.ts$/,
- *   handler: async ({ file }) => true,
- * });
- * ```
- *
- * @alpha
- */
-export function makePolicyDefinition(args) {
-    return {
-        name: args.name,
-        description: args.description,
-        match: args.match,
-        handler: args.handler,
-        defaultConfig: args.defaultConfig,
-        resolver: args.resolver,
-    };
-}
-/**
- * Combine a {@link PolicyDefinition} with a policy-specific config and other settings.
- *
- * @deprecated Use the `policy` function instead, which has a simpler API.
- *
- * @example
- * ```typescript
- * makePolicy(NoJsFileExtensions, undefined, { excludeFiles: ["bin/*"] })
- * ```
- *
- * @alpha
- */
-export function makePolicy(definition, config, settings) {
-    return {
-        ...definition,
-        ...settings,
-        config,
-    };
+        if (ids.has(policy.name)) {
+            throw new Error(`Policy instance ID '${policy.name}' conflicts with another configured policy. Set an explicit unique instanceId.`);
+        }
+        ids.add(policy.name);
+        return { ...policy, instanceId: policy.name };
+    });
 }
 //# sourceMappingURL=makePolicy.js.map

package/esm/makePolicy.js.map

@@ -1 +1 @@
-{"version":3,"file":"makePolicy.js","sourceRoot":"","sources":["../src/makePolicy.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAkB,MAAM,WAAW,CAAC;AACjD,OAAO,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AA6BtD;;;GAGG;AACH,SAAS,gBAAgB,CACxB,OAAyB;IAEzB,IAAI,mBAAmB,CAAC,OAAO,CAAC,EAAE,CAAC;QAClC,oCAAoC;QACpC,OAAO,OAAkE,CAAC;IAC3E,CAAC;IAED,oCAAoC;IACpC,OAAO,QAAQ,CAAC,EAAE,IAAmB;QACpC,MAAM,YAAY,GAAG,OAEY,CAAC;QAClC,OAAO,KAAK,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC;IAC9C,CAAC,CAAC;AACH,CAAC;AAoCD,aAAa;AACb,MAAM,UAAU,MAAM,CACrB,SAAyB,EACzB,eAAmC,EACnC,YAA4B;IAE5B,wDAAwD;IACxD,IAAI,MAAqB,CAAC;IAC1B,IAAI,OAAkC,CAAC;IAEvC,IAAI,YAAY,KAAK,SAAS,EAAE,CAAC;QAChC,oDAAoD;QACpD,MAAM,GAAG,eAAoB,CAAC;QAC9B,OAAO,GAAG,YAAY,CAAC;IACxB,CAAC;SAAM,IAAI,eAAe,KAAK,SAAS,EAAE,CAAC;QAC1C,iEAAiE;QACjE,6DAA6D;QAC7D,IACC,OAAO,eAAe,KAAK,QAAQ;YACnC,eAAe,KAAK,IAAI;YACxB,SAAS,IAAI,eAAe;YAC5B,CAAC,CAAC,MAAM,IAAI,eAAe,CAAC;YAC5B,MAAM,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,SAAS,CAAC,EACzD,CAAC;YACF,oCAAoC;YACpC,OAAO,GAAG,eAAgC,CAAC;QAC5C,CAAC;aAAM,CAAC;YACP,cAAc;YACd,MAAM,GAAG,eAAoB,CAAC;QAC/B,CAAC;IACF,CAAC;IAED,yCAAyC;IACzC,MAAM,eAAe,GAAG,MAAM,IAAK,SAAS,CAAC,aAA+B,CAAC;IAE7E,uEAAuE;IACvE,MAAM,eAAe,GAAG,OAAO,EAAE,OAAO,CAAC;IAEzC,OAAO;QACN,GAAG,SAAS;QACZ,MAAM,EAAE,eAAe;QACvB,OAAO,EAAE,eAAe;QACxB,YAAY,EAAE,eAAe;QAC7B,gBAAgB,EAAE,gBAAgB,CAAC,SAAS,CAAC,OAAO,CAAC;KACrD,CAAC;AACH,CAAC;AAeD;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,oBAAoB,CACnC,IAA8B;IAE9B,OAAO;QACN,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,WAAW,EAAE,IAAI,CAAC,WAAW;QAC7B,KAAK,EAAE,IAAI,CAAC,KAAK;QACjB,OAAO,EAAE,IAAI,CAAC,OAAO;QACrB,aAAa,EAAE,IAAI,CAAC,aAAa;QACjC,QAAQ,EAAE,IAAI,CAAC,QAAQ;KACvB,CAAC;AACH,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,UAAU,CACzB,UAA+B,EAC/B,MAAU,EACV,QAAoC;IAEpC,OAAO;QACN,GAAG,UAAU;QACb,GAAG,QAAQ;QACX,MAAM;KACsB,CAAC;AAC/B,CAAC","sourcesContent":["import { call, type Operation } from \"effection\";\nimport { isGeneratorFunction } from \"./generators.js\";\nimport type {\n\tConfiguredPolicy,\n\tPolicyArgs,\n\tPolicyDefinition,\n\tPolicyHandler,\n\tPolicyHandlerResult,\n\tPolicyInstance,\n\tPolicyInstanceSettings,\n\tPolicyShape,\n} from \"./policy.js\";\n\n// ============================================================================\n// New API: policy() function\n// ============================================================================\n\n/**\n * Options for configuring a policy instance.\n *\n * @alpha\n */\nexport interface PolicyOptions {\n\t/**\n\t * File paths matching these patterns will be excluded from this policy.\n\t * Patterns are matched against repo-relative paths.\n\t */\n\texclude?: (string | RegExp)[];\n}\n\n/**\n * Normalizes a handler to always return an Effection Operation.\n * Detection happens once at registration time, not per-invocation.\n */\nfunction normalizeHandler<C>(\n\thandler: PolicyHandler<C>,\n): (args: PolicyArgs<C>) => Operation<PolicyHandlerResult> {\n\tif (isGeneratorFunction(handler)) {\n\t\t// Already a generator, return as-is\n\t\treturn handler as (args: PolicyArgs<C>) => Operation<PolicyHandlerResult>;\n\t}\n\n\t// Async function - wrap with call()\n\treturn function* (args: PolicyArgs<C>): Operation<PolicyHandlerResult> {\n\t\tconst asyncHandler = handler as (\n\t\t\tpolicyArgs: PolicyArgs<C>,\n\t\t) => Promise<PolicyHandlerResult>;\n\t\treturn yield* call(() => asyncHandler(args));\n\t};\n}\n\n/**\n * Configure a policy for use in repopo.\n *\n * @remarks\n * This function takes a policy definition and returns a configured policy instance\n * that can be added to the `policies` array in `repopo.config.ts`.\n *\n * Handlers are automatically normalized: async functions are wrapped for Effection\n * compatibility, while generator functions are used directly.\n *\n * @example\n * ```typescript\n * // Policy with no config, just options\n * policy(NoJsFileExtensions, { exclude: [\"bin/*\"] })\n *\n * // Policy with config\n * policy(PackageJsonProperties, { verbatim: { license: \"MIT\" } })\n *\n * // Policy with config and options\n * policy(PackageJsonProperties, { verbatim: { license: \"MIT\" } }, { exclude: [\"vendor/*\"] })\n * ```\n *\n * @alpha\n */\nexport function policy<C = void>(\n\tpolicyDef: PolicyShape<C>,\n\toptions?: PolicyOptions,\n): ConfiguredPolicy<C>;\n/** @alpha */\nexport function policy<C>(\n\tpolicyDef: PolicyShape<C>,\n\tconfig: C,\n\toptions?: PolicyOptions,\n): ConfiguredPolicy<C>;\n/** @alpha */\nexport function policy<C>(\n\tpolicyDef: PolicyShape<C>,\n\tconfigOrOptions?: C | PolicyOptions,\n\tmaybeOptions?: PolicyOptions,\n): ConfiguredPolicy<C> {\n\t// Determine if the second argument is config or options\n\tlet config: C | undefined;\n\tlet options: PolicyOptions | undefined;\n\n\tif (maybeOptions !== undefined) {\n\t\t// Three-argument form: policy(def, config, options)\n\t\tconfig = configOrOptions as C;\n\t\toptions = maybeOptions;\n\t} else if (configOrOptions !== undefined) {\n\t\t// Two-argument form: need to determine if it's config or options\n\t\t// PolicyOptions has a specific shape with 'exclude' property\n\t\tif (\n\t\t\ttypeof configOrOptions === \"object\" &&\n\t\t\tconfigOrOptions !== null &&\n\t\t\t\"exclude\" in configOrOptions &&\n\t\t\t!(\"name\" in configOrOptions) &&\n\t\t\tObject.keys(configOrOptions).every((k) => k === \"exclude\")\n\t\t) {\n\t\t\t// It's options (has only 'exclude')\n\t\t\toptions = configOrOptions as PolicyOptions;\n\t\t} else {\n\t\t\t// It's config\n\t\t\tconfig = configOrOptions as C;\n\t\t}\n\t}\n\n\t// Merge with default config if available\n\tconst effectiveConfig = config ?? (policyDef.defaultConfig as C | undefined);\n\n\t// Support both 'exclude' and 'excludeFiles' for backward compatibility\n\tconst excludePatterns = options?.exclude;\n\n\treturn {\n\t\t...policyDef,\n\t\tconfig: effectiveConfig,\n\t\texclude: excludePatterns,\n\t\texcludeFiles: excludePatterns,\n\t\t_internalHandler: normalizeHandler(policyDef.handler),\n\t};\n}\n\n// ============================================================================\n// Legacy API (Still supported for backward compatibility)\n// ============================================================================\n\n/**\n * Input arguments for creating a policy definition.\n *\n * @deprecated Use {@link PolicyShape} directly instead.\n *\n * @alpha\n */\nexport type PolicyDefinitionInput<C = undefined> = PolicyDefinition<C>;\n\n/**\n * Creates a {@link PolicyDefinition} from the provided arguments.\n *\n * @deprecated Define policies as object literals satisfying {@link PolicyShape} instead.\n *\n * @example\n * ```typescript\n * const MyPolicy = makePolicyDefinition({\n *   name: \"MyPolicy\",\n *   description: \"Ensures files follow conventions\",\n *   match: /\\.ts$/,\n *   handler: async ({ file }) => true,\n * });\n * ```\n *\n * @alpha\n */\nexport function makePolicyDefinition<C = undefined>(\n\targs: PolicyDefinitionInput<C>,\n): PolicyDefinition<C> {\n\treturn {\n\t\tname: args.name,\n\t\tdescription: args.description,\n\t\tmatch: args.match,\n\t\thandler: args.handler,\n\t\tdefaultConfig: args.defaultConfig,\n\t\tresolver: args.resolver,\n\t};\n}\n\n/**\n * Combine a {@link PolicyDefinition} with a policy-specific config and other settings.\n *\n * @deprecated Use the `policy` function instead, which has a simpler API.\n *\n * @example\n * ```typescript\n * makePolicy(NoJsFileExtensions, undefined, { excludeFiles: [\"bin/*\"] })\n * ```\n *\n * @alpha\n */\nexport function makePolicy<C>(\n\tdefinition: PolicyDefinition<C>,\n\tconfig?: C,\n\tsettings?: PolicyInstanceSettings<C>,\n): PolicyInstance<C> {\n\treturn {\n\t\t...definition,\n\t\t...settings,\n\t\tconfig,\n\t} satisfies PolicyInstance<C>;\n}\n"]}
+{"version":3,"file":"makePolicy.js","sourceRoot":"","sources":["../src/makePolicy.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AA6C9C,MAAM,UAAU,UAAU,CACzB,UAAqC,EACrC,OAAgC,EAChC,GAAG,KAAgB;IAEnB,MAAM,QAAQ,GACb,2IAA2I,CAAC;IAC7I,IACC,KAAK,CAAC,MAAM,GAAG,CAAC;QAChB,CAAC,OAAO,KAAK,SAAS;YACrB,CAAC,OAAO,OAAO,KAAK,QAAQ;gBAC3B,OAAO,KAAK,IAAI;gBAChB,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC;gBACtB,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,IAAI,CACxB,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,EAAE,SAAS,EAAE,YAAY,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,CAC3D,CAAC,CAAC,EACJ,CAAC;QACF,MAAM,IAAI,SAAS,CAAC,QAAQ,CAAC,CAAC;IAC/B,CAAC;IACD,IAAI,UAAU,CAAC,KAAK,KAAK,YAAY,IAAI,UAAU,CAAC,QAAQ,KAAK,SAAS,EAAE,CAAC;QAC5E,MAAM,IAAI,SAAS,CAClB,iEAAiE,CACjE,CAAC;IACH,CAAC;IACD,IACC,OAAO,EAAE,OAAO,KAAK,SAAS;QAC9B,CAAC,CACA,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC;YAC9B,OAAO,CAAC,OAAO,CAAC,KAAK,CACpB,CAAC,KAAK,EAAE,EAAE,CAAC,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,YAAY,MAAM,CAC/D,CACD,EACA,CAAC;QACF,MAAM,IAAI,SAAS,CAAC,QAAQ,CAAC,CAAC;IAC/B,CAAC;IACD,IACC,OAAO,EAAE,UAAU,KAAK,SAAS;QACjC,CAAC,OAAO,OAAO,CAAC,UAAU,KAAK,QAAQ,IAAI,OAAO,CAAC,UAAU,CAAC,MAAM,KAAK,CAAC,CAAC,EAC1E,CAAC;QACF,MAAM,IAAI,SAAS,CAAC,uCAAuC,CAAC,CAAC;IAC9D,CAAC;IACD,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,cAAc,CAAC,CAAC;IAC1C,MAAM,MAAM,GACX,OAAO,EAAE,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,UAAU,CAAC,aAAa,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC;IAC3E,IAAI,UAAU,CAAC,cAAc,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;QACvD,MAAM,IAAI,SAAS,CAClB,WAAW,UAAU,CAAC,IAAI,sBAAsB,QAAQ,EAAE,CAC1D,CAAC;IACH,CAAC;IACD,OAAO,EAAE,GAAG,UAAU,EAAE,GAAG,OAAO,EAAE,MAAM,EAAE,CAAC;AAC9C,CAAC;AAED,mEAAmE;AACnE,MAAM,UAAU,uBAAuB,CAErC,QAAsB;IACvB,MAAM,KAAK,GAAG,IAAI,GAAG,EAAkB,CAAC;IACxC,MAAM,GAAG,GAAG,IAAI,GAAG,EAAU,CAAC;IAC9B,KAAK,MAAM,MAAM,IAAI,QAAQ,EAAE,CAAC;QAC/B,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;QAC1D,IAAI,MAAM,CAAC,UAAU,KAAK,SAAS,EAAE,CAAC;YACrC,IAAI,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,UAAU,CAAC,EAAE,CAAC;gBAChC,MAAM,IAAI,KAAK,CAAC,iCAAiC,MAAM,CAAC,UAAU,EAAE,CAAC,CAAC;YACvE,CAAC;YACD,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;QAC5B,CAAC;IACF,CAAC;IACD,OAAO,QAAQ,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE;QAC9B,IAAI,MAAM,CAAC,UAAU,KAAK,SAAS,EAAE,CAAC;YACrC,OAAO,EAAE,GAAG,MAAM,EAAE,UAAU,EAAE,MAAM,CAAC,UAAU,EAAE,CAAC;QACrD,CAAC;QACD,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC;YACvC,MAAM,IAAI,KAAK,CACd,WAAW,MAAM,CAAC,IAAI,4EAA4E,CAClG,CAAC;QACH,CAAC;QACD,IAAI,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC;YAC1B,MAAM,IAAI,KAAK,CACd,uBAAuB,MAAM,CAAC,IAAI,gFAAgF,CAClH,CAAC;QACH,CAAC;QACD,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QACrB,OAAO,EAAE,GAAG,MAAM,EAAE,UAAU,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC;IAC/C,CAAC,CAAC,CAAC;AACJ,CAAC","sourcesContent":["import { exclusionRegex } from \"./context.js\";\nimport type {\n\tConfiguredFilePolicy,\n\tConfiguredPolicy,\n\tConfiguredRepositoryPolicy,\n\tDefinedConfig,\n\tFilePolicyDefinition,\n\tPolicyDefinition,\n\tPolicyInstanceId,\n\tPolicyName,\n\tPolicyOptions,\n\tRepositoryPolicyDefinition,\n} from \"./policy.js\";\n\ntype ConfigOf<D> = D extends PolicyDefinition<infer C> ? C : never;\ntype RequiredConfigDefinitions<D> = D extends { requiresConfig: true }\n\t? D extends { defaultConfig: infer Default }\n\t\t? undefined extends Default\n\t\t\t? D\n\t\t\t: never\n\t\t: D\n\t: never;\ntype OptionsFor<D> = [RequiredConfigDefinitions<D>] extends [never]\n\t? [options?: PolicyOptions<ConfigOf<D>>]\n\t: [\n\t\t\toptions: PolicyOptions<ConfigOf<D>> & {\n\t\t\t\tconfig: DefinedConfig<ConfigOf<RequiredConfigDefinitions<D>>>;\n\t\t\t},\n\t\t];\n\n/** Configure a file definition using a single options object. @public */\nexport function makePolicy<D extends FilePolicyDefinition<unknown>>(\n\tdefinition: D,\n\t...options: OptionsFor<D>\n): ConfiguredFilePolicy<ConfigOf<D>>;\n/** Configure a repository definition using a single options object. @public */\nexport function makePolicy<D extends RepositoryPolicyDefinition<unknown>>(\n\tdefinition: D,\n\t...options: OptionsFor<D>\n): ConfiguredRepositoryPolicy<ConfigOf<D>>;\n/** Configure a common-union definition without losing scope discrimination. @public */\nexport function makePolicy<D extends PolicyDefinition<unknown>>(\n\tdefinition: D,\n\t...options: OptionsFor<D>\n): ConfiguredPolicy<ConfigOf<D>>;\nexport function makePolicy(\n\tdefinition: PolicyDefinition<unknown>,\n\toptions?: PolicyOptions<unknown>,\n\t...extra: unknown[]\n): ConfiguredPolicy<unknown> {\n\tconst guidance =\n\t\t\"Use makePolicy(definition, { config, exclude, instanceId }); positional config, third arguments and excludeFiles are no longer supported.\";\n\tif (\n\t\textra.length > 0 ||\n\t\t(options !== undefined &&\n\t\t\t(typeof options !== \"object\" ||\n\t\t\t\toptions === null ||\n\t\t\t\tArray.isArray(options) ||\n\t\t\t\tObject.keys(options).some(\n\t\t\t\t\t(key) => ![\"config\", \"exclude\", \"instanceId\"].includes(key),\n\t\t\t\t)))\n\t) {\n\t\tthrow new TypeError(guidance);\n\t}\n\tif (definition.scope === \"repository\" && definition.resolver !== undefined) {\n\t\tthrow new TypeError(\n\t\t\t\"Repository policies support inline fixes only; remove resolver.\",\n\t\t);\n\t}\n\tif (\n\t\toptions?.exclude !== undefined &&\n\t\t!(\n\t\t\tArray.isArray(options.exclude) &&\n\t\t\toptions.exclude.every(\n\t\t\t\t(value) => typeof value === \"string\" || value instanceof RegExp,\n\t\t\t)\n\t\t)\n\t) {\n\t\tthrow new TypeError(guidance);\n\t}\n\tif (\n\t\toptions?.instanceId !== undefined &&\n\t\t(typeof options.instanceId !== \"string\" || options.instanceId.length === 0)\n\t) {\n\t\tthrow new TypeError(\"instanceId must be a nonempty string.\");\n\t}\n\toptions?.exclude?.forEach(exclusionRegex);\n\tconst config =\n\t\toptions?.config === undefined ? definition.defaultConfig : options.config;\n\tif (definition.requiresConfig && config === undefined) {\n\t\tthrow new TypeError(\n\t\t\t`Policy '${definition.name}' requires config. ${guidance}`,\n\t\t);\n\t}\n\treturn { ...definition, ...options, config };\n}\n\n/** Assign stable IDs, rejecting ambiguous duplicates. @internal */\nexport function identifyPolicyInstances<\n\tT extends { name: PolicyName; instanceId?: PolicyInstanceId | undefined },\n>(policies: readonly T[]): (T & { instanceId: PolicyInstanceId })[] {\n\tconst names = new Map<string, number>();\n\tconst ids = new Set<string>();\n\tfor (const policy of policies) {\n\t\tnames.set(policy.name, (names.get(policy.name) ?? 0) + 1);\n\t\tif (policy.instanceId !== undefined) {\n\t\t\tif (ids.has(policy.instanceId)) {\n\t\t\t\tthrow new Error(`Duplicate policy instance ID: ${policy.instanceId}`);\n\t\t\t}\n\t\t\tids.add(policy.instanceId);\n\t\t}\n\t}\n\treturn policies.map((policy) => {\n\t\tif (policy.instanceId !== undefined) {\n\t\t\treturn { ...policy, instanceId: policy.instanceId };\n\t\t}\n\t\tif ((names.get(policy.name) ?? 0) > 1) {\n\t\t\tthrow new Error(\n\t\t\t\t`Policy '${policy.name}' is configured multiple times. Set a unique instanceId for each instance.`,\n\t\t\t);\n\t\t}\n\t\tif (ids.has(policy.name)) {\n\t\t\tthrow new Error(\n\t\t\t\t`Policy instance ID '${policy.name}' conflicts with another configured policy. Set an explicit unique instanceId.`,\n\t\t\t);\n\t\t}\n\t\tids.add(policy.name);\n\t\treturn { ...policy, instanceId: policy.name };\n\t});\n}\n"]}

package/esm/perf.d.ts

@@ -1,14 +1,22 @@
 import type { Logger } from "@tylerbu/cli-api";
 import type { Operation } from "effection";
-import type { PolicyName } from "./policy.js";
+import type { PolicyInstanceId } from "./policy.js";
+/**
+ * The type of action a policy can perform.
+ * @public
+ */
 export type PolicyAction = "check" | "resolve" | "handle";
 /**
  * Stores performance data for each handler. Used to collect and display performance stats.
+ * @public
  */
 export interface PolicyHandlerPerfStats {
+    /** Number of candidate file paths supplied to the runner. */
     count: number;
+    /** Number of candidate files admitted past global exclusions. */
     processed: number;
-    data: Map<PolicyAction, Map<PolicyName, number>>;
+    /** Total elapsed milliseconds per action and configured policy instance. */
+    data: Map<PolicyAction, Map<PolicyInstanceId, number>>;
 }
 export declare function newPerfStats(): PolicyHandlerPerfStats;
 export declare function runWithPerf<T>(name: string, action: PolicyAction, stats: PolicyHandlerPerfStats, run: () => Operation<T>): Operation<T>;

package/esm/perf.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"perf.d.ts","sourceRoot":"","sources":["../src/perf.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAC3C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAE9C,MAAM,MAAM,YAAY,GAAG,OAAO,GAAG,SAAS,GAAG,QAAQ,CAAC;AAE1D;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACtC,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,GAAG,CAAC,YAAY,EAAE,GAAG,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC,CAAC;CACjD;AAED,wBAAgB,YAAY,IAAI,sBAAsB,CAMrD;AAED,wBAAiB,WAAW,CAAC,CAAC,EAC7B,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,YAAY,EACpB,KAAK,EAAE,sBAAsB,EAC7B,GAAG,EAAE,MAAM,SAAS,CAAC,CAAC,CAAC,GACrB,SAAS,CAAC,CAAC,CAAC,CAWd;AAED,wBAAgB,QAAQ,CAAC,KAAK,EAAE,sBAAsB,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI,CAWzE"}
+{"version":3,"file":"perf.d.ts","sourceRoot":"","sources":["../src/perf.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAC3C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAEpD;;;GAGG;AACH,MAAM,MAAM,YAAY,GAAG,OAAO,GAAG,SAAS,GAAG,QAAQ,CAAC;AAE1D;;;GAGG;AACH,MAAM,WAAW,sBAAsB;IACtC,6DAA6D;IAC7D,KAAK,EAAE,MAAM,CAAC;IACd,iEAAiE;IACjE,SAAS,EAAE,MAAM,CAAC;IAClB,4EAA4E;IAC5E,IAAI,EAAE,GAAG,CAAC,YAAY,EAAE,GAAG,CAAC,gBAAgB,EAAE,MAAM,CAAC,CAAC,CAAC;CACvD;AAED,wBAAgB,YAAY,IAAI,sBAAsB,CAMrD;AAED,wBAAiB,WAAW,CAAC,CAAC,EAC7B,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,YAAY,EACpB,KAAK,EAAE,sBAAsB,EAC7B,GAAG,EAAE,MAAM,SAAS,CAAC,CAAC,CAAC,GACrB,SAAS,CAAC,CAAC,CAAC,CASd;AAED,wBAAgB,QAAQ,CAAC,KAAK,EAAE,sBAAsB,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI,CAWzE"}

package/esm/perf.js

@@ -6,14 +6,15 @@ export function newPerfStats() {
     };
 }
 export function* runWithPerf(name, action, stats, run) {
-    const actionMap = stats.data.get(action) ?? new Map();
-    let dur = actionMap.get(name) ?? 0;
-    const start = Date.now();
-    const result = yield* run();
-    dur += Date.now() - start;
-    actionMap.set(name, dur);
-    stats.data.set(action, actionMap);
-    return result;
+    const start = performance.now();
+    try {
+        return yield* run();
+    }
+    finally {
+        const actionMap = stats.data.get(action) ?? new Map();
+        actionMap.set(name, (actionMap.get(name) ?? 0) + performance.now() - start);
+        stats.data.set(action, actionMap);
+    }
 }
 export function logStats(stats, log) {
     log.log(`Statistics: ${stats.processed} files processed, ` +
@@ -21,7 +22,7 @@ export function logStats(stats, log) {
     for (const [action, handlerPerf] of stats.data.entries()) {
         log.log(`Performance for "${action}":`);
         for (const [handler, dur] of handlerPerf.entries()) {
-            log.log(`    ${handler}: ${dur}ms`);
+            log.log(`    ${handler}: ${Math.round(dur * 10) / 10}ms`);
         }
     }
 }

package/esm/perf.js.map

@@ -1 +1 @@
-{"version":3,"file":"perf.js","sourceRoot":"","sources":["../src/perf.ts"],"names":[],"mappings":"AAeA,MAAM,UAAU,YAAY;IAC3B,OAAO;QACN,KAAK,EAAE,CAAC;QACR,SAAS,EAAE,CAAC;QACZ,IAAI,EAAE,IAAI,GAAG,EAAyC;KACtD,CAAC;AACH,CAAC;AAED,MAAM,SAAS,CAAC,CAAC,WAAW,CAC3B,IAAY,EACZ,MAAoB,EACpB,KAA6B,EAC7B,GAAuB;IAEvB,MAAM,SAAS,GAAG,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,IAAI,GAAG,EAAkB,CAAC;IACtE,IAAI,GAAG,GAAG,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAEnC,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IACzB,MAAM,MAAM,GAAG,KAAK,CAAC,CAAC,GAAG,EAAE,CAAC;IAC5B,GAAG,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC;IAE1B,SAAS,CAAC,GAAG,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;IACzB,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IAClC,OAAO,MAAM,CAAC;AACf,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,KAA6B,EAAE,GAAW;IAClE,GAAG,CAAC,GAAG,CACN,eAAe,KAAK,CAAC,SAAS,oBAAoB;QACjD,GAAG,KAAK,CAAC,KAAK,GAAG,KAAK,CAAC,SAAS,cAAc,KAAK,CAAC,KAAK,QAAQ,CAClE,CAAC;IACF,KAAK,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,IAAI,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,EAAE,CAAC;QAC1D,GAAG,CAAC,GAAG,CAAC,oBAAoB,MAAM,IAAI,CAAC,CAAC;QACxC,KAAK,MAAM,CAAC,OAAO,EAAE,GAAG,CAAC,IAAI,WAAW,CAAC,OAAO,EAAE,EAAE,CAAC;YACpD,GAAG,CAAC,GAAG,CAAC,OAAO,OAAO,KAAK,GAAG,IAAI,CAAC,CAAC;QACrC,CAAC;IACF,CAAC;AACF,CAAC","sourcesContent":["import type { Logger } from \"@tylerbu/cli-api\";\nimport type { Operation } from \"effection\";\nimport type { PolicyName } from \"./policy.js\";\n\nexport type PolicyAction = \"check\" | \"resolve\" | \"handle\";\n\n/**\n * Stores performance data for each handler. Used to collect and display performance stats.\n */\nexport interface PolicyHandlerPerfStats {\n\tcount: number;\n\tprocessed: number;\n\tdata: Map<PolicyAction, Map<PolicyName, number>>;\n}\n\nexport function newPerfStats(): PolicyHandlerPerfStats {\n\treturn {\n\t\tcount: 0,\n\t\tprocessed: 0,\n\t\tdata: new Map<PolicyAction, Map<PolicyName, number>>(),\n\t};\n}\n\nexport function* runWithPerf<T>(\n\tname: string,\n\taction: PolicyAction,\n\tstats: PolicyHandlerPerfStats,\n\trun: () => Operation<T>,\n): Operation<T> {\n\tconst actionMap = stats.data.get(action) ?? new Map<string, number>();\n\tlet dur = actionMap.get(name) ?? 0;\n\n\tconst start = Date.now();\n\tconst result = yield* run();\n\tdur += Date.now() - start;\n\n\tactionMap.set(name, dur);\n\tstats.data.set(action, actionMap);\n\treturn result;\n}\n\nexport function logStats(stats: PolicyHandlerPerfStats, log: Logger): void {\n\tlog.log(\n\t\t`Statistics: ${stats.processed} files processed, ` +\n\t\t\t`${stats.count - stats.processed} excluded, ${stats.count} total`,\n\t);\n\tfor (const [action, handlerPerf] of stats.data.entries()) {\n\t\tlog.log(`Performance for \"${action}\":`);\n\t\tfor (const [handler, dur] of handlerPerf.entries()) {\n\t\t\tlog.log(`    ${handler}: ${dur}ms`);\n\t\t}\n\t}\n}\n"]}
+{"version":3,"file":"perf.js","sourceRoot":"","sources":["../src/perf.ts"],"names":[],"mappings":"AAuBA,MAAM,UAAU,YAAY;IAC3B,OAAO;QACN,KAAK,EAAE,CAAC;QACR,SAAS,EAAE,CAAC;QACZ,IAAI,EAAE,IAAI,GAAG,EAA+C;KAC5D,CAAC;AACH,CAAC;AAED,MAAM,SAAS,CAAC,CAAC,WAAW,CAC3B,IAAY,EACZ,MAAoB,EACpB,KAA6B,EAC7B,GAAuB;IAEvB,MAAM,KAAK,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC;IAChC,IAAI,CAAC;QACJ,OAAO,KAAK,CAAC,CAAC,GAAG,EAAE,CAAC;IACrB,CAAC;YAAS,CAAC;QACV,MAAM,SAAS,GAAG,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,IAAI,GAAG,EAAkB,CAAC;QACtE,SAAS,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,WAAW,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC,CAAC;QAC5E,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IACnC,CAAC;AACF,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,KAA6B,EAAE,GAAW;IAClE,GAAG,CAAC,GAAG,CACN,eAAe,KAAK,CAAC,SAAS,oBAAoB;QACjD,GAAG,KAAK,CAAC,KAAK,GAAG,KAAK,CAAC,SAAS,cAAc,KAAK,CAAC,KAAK,QAAQ,CAClE,CAAC;IACF,KAAK,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,IAAI,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,EAAE,CAAC;QAC1D,GAAG,CAAC,GAAG,CAAC,oBAAoB,MAAM,IAAI,CAAC,CAAC;QACxC,KAAK,MAAM,CAAC,OAAO,EAAE,GAAG,CAAC,IAAI,WAAW,CAAC,OAAO,EAAE,EAAE,CAAC;YACpD,GAAG,CAAC,GAAG,CAAC,OAAO,OAAO,KAAK,IAAI,CAAC,KAAK,CAAC,GAAG,GAAG,EAAE,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;QAC3D,CAAC;IACF,CAAC;AACF,CAAC","sourcesContent":["import type { Logger } from \"@tylerbu/cli-api\";\nimport type { Operation } from \"effection\";\nimport type { PolicyInstanceId } from \"./policy.js\";\n\n/**\n * The type of action a policy can perform.\n * @public\n */\nexport type PolicyAction = \"check\" | \"resolve\" | \"handle\";\n\n/**\n * Stores performance data for each handler. Used to collect and display performance stats.\n * @public\n */\nexport interface PolicyHandlerPerfStats {\n\t/** Number of candidate file paths supplied to the runner. */\n\tcount: number;\n\t/** Number of candidate files admitted past global exclusions. */\n\tprocessed: number;\n\t/** Total elapsed milliseconds per action and configured policy instance. */\n\tdata: Map<PolicyAction, Map<PolicyInstanceId, number>>;\n}\n\nexport function newPerfStats(): PolicyHandlerPerfStats {\n\treturn {\n\t\tcount: 0,\n\t\tprocessed: 0,\n\t\tdata: new Map<PolicyAction, Map<PolicyInstanceId, number>>(),\n\t};\n}\n\nexport function* runWithPerf<T>(\n\tname: string,\n\taction: PolicyAction,\n\tstats: PolicyHandlerPerfStats,\n\trun: () => Operation<T>,\n): Operation<T> {\n\tconst start = performance.now();\n\ttry {\n\t\treturn yield* run();\n\t} finally {\n\t\tconst actionMap = stats.data.get(action) ?? new Map<string, number>();\n\t\tactionMap.set(name, (actionMap.get(name) ?? 0) + performance.now() - start);\n\t\tstats.data.set(action, actionMap);\n\t}\n}\n\nexport function logStats(stats: PolicyHandlerPerfStats, log: Logger): void {\n\tlog.log(\n\t\t`Statistics: ${stats.processed} files processed, ` +\n\t\t\t`${stats.count - stats.processed} excluded, ${stats.count} total`,\n\t);\n\tfor (const [action, handlerPerf] of stats.data.entries()) {\n\t\tlog.log(`Performance for \"${action}\":`);\n\t\tfor (const [handler, dur] of handlerPerf.entries()) {\n\t\t\tlog.log(`    ${handler}: ${Math.round(dur * 10) / 10}ms`);\n\t\t}\n\t}\n}\n"]}

package/esm/policies/CargoLicenceValidated.d.ts

@@ -0,0 +1,41 @@
+import type { FilePolicyDefinition } from "../policy.js";
+/**
+ * Configuration for the CargoLicenceValidated policy.
+ *
+ * @public
+ */
+export interface CargoLicenceValidatedConfig {
+    /**
+     * Allowed SPDX licence identifiers. If set, only these are accepted.
+     */
+    allowedLicences?: string[];
+    /**
+     * If true, validate the licence value against the SPDX licence list
+     * using `spdx-correct`. When enabled, typos like "MIIT" are detected
+     * and can be auto-fixed to the correct identifier ("MIT").
+     *
+     * Requires the optional peer dependency `spdx-correct` to be installed.
+     *
+     * @defaultValue true
+     */
+    validateSpdx?: boolean;
+    /**
+     * If true, skip workspace-only Cargo.toml files (those without a [package] section).
+     *
+     * @defaultValue true
+     */
+    skipWorkspace?: boolean;
+}
+/**
+ * A policy that validates the `license` field in Cargo.toml against the SPDX
+ * licence list. Supports auto-fixing correctable identifiers.
+ *
+ * @remarks
+ * Cargo.toml uses a single `license` string field (not an array like Gleam's
+ * `licences`). This policy validates that the value is a recognized SPDX
+ * identifier and can auto-fix common mistakes like wrong casing.
+ *
+ * @public
+ */
+export declare const CargoLicenceValidated: FilePolicyDefinition<CargoLicenceValidatedConfig>;
+//# sourceMappingURL=CargoLicenceValidated.d.ts.map

package/esm/policies/CargoLicenceValidated.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CargoLicenceValidated.d.ts","sourceRoot":"","sources":["../../src/policies/CargoLicenceValidated.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AAOzD;;;;GAIG;AACH,MAAM,WAAW,2BAA2B;IAC3C;;OAEG;IACH,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAE3B;;;;;;;;OAQG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC;IAEvB;;;;OAIG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC;CACxB;AAKD;;;;;;;;;;GAUG;AACH,eAAO,MAAM,qBAAqB,mDAsC4B,CAAC"}

package/esm/policies/CargoLicenceValidated.js

@@ -0,0 +1,47 @@
+import { resolve } from "pathe";
+import { defineCargoPolicy, } from "../policyDefiners/defineCargoPolicy.js";
+import { validateLicenceField } from "../policyDefiners/spdxValidator.js";
+const MANUAL_FIX = "Use a valid SPDX licence identifier (e.g., MIT, Apache-2.0, MPL-2.0).";
+/**
+ * A policy that validates the `license` field in Cargo.toml against the SPDX
+ * licence list. Supports auto-fixing correctable identifiers.
+ *
+ * @remarks
+ * Cargo.toml uses a single `license` string field (not an array like Gleam's
+ * `licences`). This policy validates that the value is a recognized SPDX
+ * identifier and can auto-fix common mistakes like wrong casing.
+ *
+ * @public
+ */
+export const CargoLicenceValidated = defineCargoPolicy({
+    name: "CargoLicenceValidated",
+    description: "Validates that Cargo.toml has a valid SPDX licence identifier.",
+    handler: async (toml, { file, root, resolve: shouldResolve, config }) => {
+        const skipWorkspace = config?.skipWorkspace ?? true;
+        const pkg = toml.package;
+        if (!pkg && skipWorkspace) {
+            return [];
+        }
+        const licence = pkg?.license;
+        if (!licence || licence.trim() === "") {
+            return [
+                {
+                    message: "Missing or empty license field in [package] section.",
+                    manualFix: 'Add license = "MIT" (or appropriate SPDX identifier) to [package] in Cargo.toml.',
+                },
+            ];
+        }
+        const result = await validateLicenceField({
+            licences: [licence],
+            ...(config?.allowedLicences !== undefined && {
+                allowedLicences: config.allowedLicences,
+            }),
+            validateSpdx: config?.validateSpdx ?? true,
+            shouldResolve,
+            filePath: resolve(root, file),
+            manualFixMessage: MANUAL_FIX,
+        });
+        return result;
+    },
+});
+//# sourceMappingURL=CargoLicenceValidated.js.map

package/esm/policies/CargoLicenceValidated.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CargoLicenceValidated.js","sourceRoot":"","sources":["../../src/policies/CargoLicenceValidated.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC;AAEhC,OAAO,EAEN,iBAAiB,GACjB,MAAM,wCAAwC,CAAC;AAChD,OAAO,EAAE,oBAAoB,EAAE,MAAM,oCAAoC,CAAC;AAgC1E,MAAM,UAAU,GACf,uEAAuE,CAAC;AAEzE;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,iBAAiB,CAAC;IACtD,IAAI,EAAE,uBAAuB;IAC7B,WAAW,EAAE,gEAAgE;IAC7E,OAAO,EAAE,KAAK,EACb,IAAe,EACf,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,EAAE,EAC7C,EAAE;QACH,MAAM,aAAa,GAAG,MAAM,EAAE,aAAa,IAAI,IAAI,CAAC;QACpD,MAAM,GAAG,GAAG,IAAI,CAAC,OAA8C,CAAC;QAEhE,IAAI,CAAC,GAAG,IAAI,aAAa,EAAE,CAAC;YAC3B,OAAO,EAAE,CAAC;QACX,CAAC;QAED,MAAM,OAAO,GAAG,GAAG,EAAE,OAA6B,CAAC;QAEnD,IAAI,CAAC,OAAO,IAAI,OAAO,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;YACvC,OAAO;gBACN;oBACC,OAAO,EAAE,sDAAsD;oBAC/D,SAAS,EACR,kFAAkF;iBACnF;aACD,CAAC;QACH,CAAC;QAED,MAAM,MAAM,GAAG,MAAM,oBAAoB,CAAC;YACzC,QAAQ,EAAE,CAAC,OAAO,CAAC;YACnB,GAAG,CAAC,MAAM,EAAE,eAAe,KAAK,SAAS,IAAI;gBAC5C,eAAe,EAAE,MAAM,CAAC,eAAe;aACvC,CAAC;YACF,YAAY,EAAE,MAAM,EAAE,YAAY,IAAI,IAAI;YAC1C,aAAa;YACb,QAAQ,EAAE,OAAO,CAAC,IAAI,EAAE,IAAI,CAAC;YAC7B,gBAAgB,EAAE,UAAU;SAC5B,CAAC,CAAC;QACH,OAAO,MAAM,CAAC;IACf,CAAC;CACD,CAA6D,CAAC","sourcesContent":["import { resolve } from \"pathe\";\nimport type { FilePolicyDefinition } from \"../policy.js\";\nimport {\n\ttype CargoToml,\n\tdefineCargoPolicy,\n} from \"../policyDefiners/defineCargoPolicy.js\";\nimport { validateLicenceField } from \"../policyDefiners/spdxValidator.js\";\n\n/**\n * Configuration for the CargoLicenceValidated policy.\n *\n * @public\n */\nexport interface CargoLicenceValidatedConfig {\n\t/**\n\t * Allowed SPDX licence identifiers. If set, only these are accepted.\n\t */\n\tallowedLicences?: string[];\n\n\t/**\n\t * If true, validate the licence value against the SPDX licence list\n\t * using `spdx-correct`. When enabled, typos like \"MIIT\" are detected\n\t * and can be auto-fixed to the correct identifier (\"MIT\").\n\t *\n\t * Requires the optional peer dependency `spdx-correct` to be installed.\n\t *\n\t * @defaultValue true\n\t */\n\tvalidateSpdx?: boolean;\n\n\t/**\n\t * If true, skip workspace-only Cargo.toml files (those without a [package] section).\n\t *\n\t * @defaultValue true\n\t */\n\tskipWorkspace?: boolean;\n}\n\nconst MANUAL_FIX =\n\t\"Use a valid SPDX licence identifier (e.g., MIT, Apache-2.0, MPL-2.0).\";\n\n/**\n * A policy that validates the `license` field in Cargo.toml against the SPDX\n * licence list. Supports auto-fixing correctable identifiers.\n *\n * @remarks\n * Cargo.toml uses a single `license` string field (not an array like Gleam's\n * `licences`). This policy validates that the value is a recognized SPDX\n * identifier and can auto-fix common mistakes like wrong casing.\n *\n * @public\n */\nexport const CargoLicenceValidated = defineCargoPolicy({\n\tname: \"CargoLicenceValidated\",\n\tdescription: \"Validates that Cargo.toml has a valid SPDX licence identifier.\",\n\thandler: async (\n\t\ttoml: CargoToml,\n\t\t{ file, root, resolve: shouldResolve, config },\n\t) => {\n\t\tconst skipWorkspace = config?.skipWorkspace ?? true;\n\t\tconst pkg = toml.package as Record<string, unknown> | undefined;\n\n\t\tif (!pkg && skipWorkspace) {\n\t\t\treturn [];\n\t\t}\n\n\t\tconst licence = pkg?.license as string | undefined;\n\n\t\tif (!licence || licence.trim() === \"\") {\n\t\t\treturn [\n\t\t\t\t{\n\t\t\t\t\tmessage: \"Missing or empty license field in [package] section.\",\n\t\t\t\t\tmanualFix:\n\t\t\t\t\t\t'Add license = \"MIT\" (or appropriate SPDX identifier) to [package] in Cargo.toml.',\n\t\t\t\t},\n\t\t\t];\n\t\t}\n\n\t\tconst result = await validateLicenceField({\n\t\t\tlicences: [licence],\n\t\t\t...(config?.allowedLicences !== undefined && {\n\t\t\t\tallowedLicences: config.allowedLicences,\n\t\t\t}),\n\t\t\tvalidateSpdx: config?.validateSpdx ?? true,\n\t\t\tshouldResolve,\n\t\t\tfilePath: resolve(root, file),\n\t\t\tmanualFixMessage: MANUAL_FIX,\n\t\t});\n\t\treturn result;\n\t},\n}) satisfies FilePolicyDefinition<CargoLicenceValidatedConfig>;\n"]}

package/esm/policies/CargoLintsConfigured.d.ts

@@ -0,0 +1,30 @@
+import type { FilePolicyDefinition } from "../policy.js";
+/**
+ * Configuration for the CargoLintsConfigured policy.
+ *
+ * @public
+ */
+export interface CargoLintsConfiguredConfig {
+    /**
+     * Required clippy lint levels. Keys are lint names (without the `clippy::` prefix),
+     * values are the minimum level ("warn" or "deny").
+     *
+     * @example
+     * ```typescript
+     * { pedantic: "warn", nursery: "warn" }
+     * ```
+     */
+    required?: Record<string, string>;
+    /**
+     * If true, just require that a [lints.clippy] section exists (without checking specific lints).
+     * @defaultValue true
+     */
+    requireSection?: boolean;
+}
+/**
+ * A policy that ensures Cargo.toml has a [lints.clippy] section configured.
+ *
+ * @public
+ */
+export declare const CargoLintsConfigured: FilePolicyDefinition<CargoLintsConfiguredConfig>;
+//# sourceMappingURL=CargoLintsConfigured.d.ts.map

package/esm/policies/CargoLintsConfigured.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CargoLintsConfigured.d.ts","sourceRoot":"","sources":["../../src/policies/CargoLintsConfigured.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAgB,MAAM,cAAc,CAAC;AAMvE;;;;GAIG;AACH,MAAM,WAAW,0BAA0B;IAC1C;;;;;;;;OAQG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAElC;;;OAGG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC;CACzB;AAmED;;;;GAIG;AACH,eAAO,MAAM,oBAAoB,kDAY4B,CAAC"}

package/esm/policies/CargoLintsConfigured.js

@@ -0,0 +1,65 @@
+import { defineCargoPolicy, } from "../policyDefiners/defineCargoPolicy.js";
+function checkClippyLints(clippy, required) {
+    const errors = [];
+    for (const [lint, expectedLevel] of Object.entries(required)) {
+        const actual = clippy[lint];
+        if (actual === undefined) {
+            errors.push(`Missing clippy lint: ${lint} (expected level: "${expectedLevel}")`);
+        }
+        else if (String(actual) !== expectedLevel) {
+            errors.push(`Clippy lint ${lint} = "${String(actual)}", expected "${expectedLevel}"`);
+        }
+    }
+    return errors;
+}
+function checkLintsSection(toml, config) {
+    const lints = toml.lints;
+    const requireSection = config?.requireSection ?? true;
+    if (requireSection && lints === undefined) {
+        return [
+            {
+                message: "Missing [lints] section in Cargo.toml.",
+                manualFix: 'Add a [lints.clippy] section, e.g.:\n[lints.clippy]\npedantic = "warn"',
+            },
+        ];
+    }
+    if (lints === undefined) {
+        return [];
+    }
+    const clippy = lints.clippy;
+    if (requireSection && clippy === undefined) {
+        return [
+            {
+                message: "Missing [lints.clippy] section in Cargo.toml.",
+                manualFix: 'Add a [lints.clippy] section, e.g.:\n[lints.clippy]\npedantic = "warn"',
+            },
+        ];
+    }
+    if (config?.required && clippy) {
+        const errors = checkClippyLints(clippy, config.required);
+        if (errors.length > 0) {
+            return errors.map((message) => ({
+                message,
+                manualFix: "Update the [lints.clippy] section with the required lint levels.",
+            }));
+        }
+    }
+    return [];
+}
+/**
+ * A policy that ensures Cargo.toml has a [lints.clippy] section configured.
+ *
+ * @public
+ */
+export const CargoLintsConfigured = defineCargoPolicy({
+    name: "CargoLintsConfigured",
+    description: "Ensures Cargo.toml has clippy lints configured in the [lints] section.",
+    handler: async (toml, { config }) => {
+        // Skip workspace root Cargo.toml files
+        if (toml.workspace !== undefined && toml.package === undefined) {
+            return [];
+        }
+        return checkLintsSection(toml, config);
+    },
+});
+//# sourceMappingURL=CargoLintsConfigured.js.map

package/esm/policies/CargoLintsConfigured.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CargoLintsConfigured.js","sourceRoot":"","sources":["../../src/policies/CargoLintsConfigured.ts"],"names":[],"mappings":"AACA,OAAO,EAEN,iBAAiB,GACjB,MAAM,wCAAwC,CAAC;AA0BhD,SAAS,gBAAgB,CACxB,MAA+B,EAC/B,QAAgC;IAEhC,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,KAAK,MAAM,CAAC,IAAI,EAAE,aAAa,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC9D,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC;QAC5B,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;YAC1B,MAAM,CAAC,IAAI,CACV,wBAAwB,IAAI,sBAAsB,aAAa,IAAI,CACnE,CAAC;QACH,CAAC;aAAM,IAAI,MAAM,CAAC,MAAM,CAAC,KAAK,aAAa,EAAE,CAAC;YAC7C,MAAM,CAAC,IAAI,CACV,eAAe,IAAI,OAAO,MAAM,CAAC,MAAM,CAAC,gBAAgB,aAAa,GAAG,CACxE,CAAC;QACH,CAAC;IACF,CAAC;IACD,OAAO,MAAM,CAAC;AACf,CAAC;AAED,SAAS,iBAAiB,CACzB,IAAe,EACf,MAA8C;IAE9C,MAAM,KAAK,GAAG,IAAI,CAAC,KAA4C,CAAC;IAChE,MAAM,cAAc,GAAG,MAAM,EAAE,cAAc,IAAI,IAAI,CAAC;IAEtD,IAAI,cAAc,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QAC3C,OAAO;YACN;gBACC,OAAO,EAAE,wCAAwC;gBACjD,SAAS,EACR,wEAAwE;aACzE;SACD,CAAC;IACH,CAAC;IAED,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACzB,OAAO,EAAE,CAAC;IACX,CAAC;IAED,MAAM,MAAM,GAAG,KAAK,CAAC,MAA6C,CAAC;IACnE,IAAI,cAAc,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;QAC5C,OAAO;YACN;gBACC,OAAO,EAAE,+CAA+C;gBACxD,SAAS,EACR,wEAAwE;aACzE;SACD,CAAC;IACH,CAAC;IAED,IAAI,MAAM,EAAE,QAAQ,IAAI,MAAM,EAAE,CAAC;QAChC,MAAM,MAAM,GAAG,gBAAgB,CAAC,MAAM,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC;QACzD,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACvB,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;gBAC/B,OAAO;gBACP,SAAS,EACR,kEAAkE;aACnE,CAAC,CAAC,CAAC;QACL,CAAC;IACF,CAAC;IACD,OAAO,EAAE,CAAC;AACX,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,iBAAiB,CAAC;IACrD,IAAI,EAAE,sBAAsB;IAC5B,WAAW,EACV,wEAAwE;IACzE,OAAO,EAAE,KAAK,EAAE,IAAe,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE;QAC9C,uCAAuC;QACvC,IAAI,IAAI,CAAC,SAAS,KAAK,SAAS,IAAI,IAAI,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;YAChE,OAAO,EAAE,CAAC;QACX,CAAC;QAED,OAAO,iBAAiB,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IACxC,CAAC;CACD,CAA4D,CAAC","sourcesContent":["import type { FilePolicyDefinition, PolicyResult } from \"../policy.js\";\nimport {\n\ttype CargoToml,\n\tdefineCargoPolicy,\n} from \"../policyDefiners/defineCargoPolicy.js\";\n\n/**\n * Configuration for the CargoLintsConfigured policy.\n *\n * @public\n */\nexport interface CargoLintsConfiguredConfig {\n\t/**\n\t * Required clippy lint levels. Keys are lint names (without the `clippy::` prefix),\n\t * values are the minimum level (\"warn\" or \"deny\").\n\t *\n\t * @example\n\t * ```typescript\n\t * { pedantic: \"warn\", nursery: \"warn\" }\n\t * ```\n\t */\n\trequired?: Record<string, string>;\n\n\t/**\n\t * If true, just require that a [lints.clippy] section exists (without checking specific lints).\n\t * @defaultValue true\n\t */\n\trequireSection?: boolean;\n}\n\nfunction checkClippyLints(\n\tclippy: Record<string, unknown>,\n\trequired: Record<string, string>,\n): string[] {\n\tconst errors: string[] = [];\n\tfor (const [lint, expectedLevel] of Object.entries(required)) {\n\t\tconst actual = clippy[lint];\n\t\tif (actual === undefined) {\n\t\t\terrors.push(\n\t\t\t\t`Missing clippy lint: ${lint} (expected level: \"${expectedLevel}\")`,\n\t\t\t);\n\t\t} else if (String(actual) !== expectedLevel) {\n\t\t\terrors.push(\n\t\t\t\t`Clippy lint ${lint} = \"${String(actual)}\", expected \"${expectedLevel}\"`,\n\t\t\t);\n\t\t}\n\t}\n\treturn errors;\n}\n\nfunction checkLintsSection(\n\ttoml: CargoToml,\n\tconfig: CargoLintsConfiguredConfig | undefined,\n): PolicyResult {\n\tconst lints = toml.lints as Record<string, unknown> | undefined;\n\tconst requireSection = config?.requireSection ?? true;\n\n\tif (requireSection && lints === undefined) {\n\t\treturn [\n\t\t\t{\n\t\t\t\tmessage: \"Missing [lints] section in Cargo.toml.\",\n\t\t\t\tmanualFix:\n\t\t\t\t\t'Add a [lints.clippy] section, e.g.:\\n[lints.clippy]\\npedantic = \"warn\"',\n\t\t\t},\n\t\t];\n\t}\n\n\tif (lints === undefined) {\n\t\treturn [];\n\t}\n\n\tconst clippy = lints.clippy as Record<string, unknown> | undefined;\n\tif (requireSection && clippy === undefined) {\n\t\treturn [\n\t\t\t{\n\t\t\t\tmessage: \"Missing [lints.clippy] section in Cargo.toml.\",\n\t\t\t\tmanualFix:\n\t\t\t\t\t'Add a [lints.clippy] section, e.g.:\\n[lints.clippy]\\npedantic = \"warn\"',\n\t\t\t},\n\t\t];\n\t}\n\n\tif (config?.required && clippy) {\n\t\tconst errors = checkClippyLints(clippy, config.required);\n\t\tif (errors.length > 0) {\n\t\t\treturn errors.map((message) => ({\n\t\t\t\tmessage,\n\t\t\t\tmanualFix:\n\t\t\t\t\t\"Update the [lints.clippy] section with the required lint levels.\",\n\t\t\t}));\n\t\t}\n\t}\n\treturn [];\n}\n\n/**\n * A policy that ensures Cargo.toml has a [lints.clippy] section configured.\n *\n * @public\n */\nexport const CargoLintsConfigured = defineCargoPolicy({\n\tname: \"CargoLintsConfigured\",\n\tdescription:\n\t\t\"Ensures Cargo.toml has clippy lints configured in the [lints] section.\",\n\thandler: async (toml: CargoToml, { config }) => {\n\t\t// Skip workspace root Cargo.toml files\n\t\tif (toml.workspace !== undefined && toml.package === undefined) {\n\t\t\treturn [];\n\t\t}\n\n\t\treturn checkLintsSection(toml, config);\n\t},\n}) satisfies FilePolicyDefinition<CargoLintsConfiguredConfig>;\n"]}

package/esm/policies/CargoLockPolicy.d.ts

@@ -0,0 +1,34 @@
+import type { FilePolicyDefinition } from "../policy.js";
+/**
+ * Configuration for the CargoLockPolicy.
+ *
+ * @public
+ */
+export interface CargoLockPolicyConfig {
+    /**
+     * Policy for binary crates.
+     * - "require": Cargo.lock must be committed (default for binaries)
+     * - "warn": Emit a warning if missing
+     * - "ignore": Skip check
+     *
+     * @defaultValue "require"
+     */
+    binaries?: "require" | "warn" | "ignore";
+    /**
+     * Policy for library crates.
+     * - "require": Cargo.lock must be committed
+     * - "warn": Emit a warning if committed (default for libraries)
+     * - "ignore": Skip check
+     *
+     * @defaultValue "ignore"
+     */
+    libraries?: "require" | "warn" | "ignore";
+}
+/**
+ * A context-aware policy for Cargo.lock files.
+ * Binary crates should commit Cargo.lock; library crates typically shouldn't.
+ *
+ * @public
+ */
+export declare const CargoLockPolicy: FilePolicyDefinition<CargoLockPolicyConfig>;
+//# sourceMappingURL=CargoLockPolicy.d.ts.map

package/esm/policies/CargoLockPolicy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CargoLockPolicy.d.ts","sourceRoot":"","sources":["../../src/policies/CargoLockPolicy.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AAMzD;;;;GAIG;AACH,MAAM,WAAW,qBAAqB;IACrC;;;;;;;OAOG;IACH,QAAQ,CAAC,EAAE,SAAS,GAAG,MAAM,GAAG,QAAQ,CAAC;IAEzC;;;;;;;OAOG;IACH,SAAS,CAAC,EAAE,SAAS,GAAG,MAAM,GAAG,QAAQ,CAAC;CAC1C;AAsBD;;;;;GAKG;AACH,eAAO,MAAM,eAAe,6CAyC4B,CAAC"}

package/esm/policies/CargoLockPolicy.js

@@ -0,0 +1,61 @@
+import { existsSync } from "node:fs";
+import path from "pathe";
+import { defineCargoPolicy, } from "../policyDefiners/defineCargoPolicy.js";
+function isBinaryCrate(toml) {
+    // Has [[bin]] entries
+    if (Array.isArray(toml.bin) && toml.bin.length > 0) {
+        return true;
+    }
+    // Has a default binary (src/main.rs is handled by Cargo implicitly)
+    const pkg = toml.package;
+    if (pkg) {
+        // If there's no explicit lib section and no [[bin]], Cargo assumes binary
+        // if src/main.rs exists, but we can't check filesystem here.
+        // Best heuristic: if there's no [lib] section, it could be a binary.
+        return toml.lib === undefined;
+    }
+    return false;
+}
+function isLibraryCrate(toml) {
+    return toml.lib !== undefined;
+}
+/**
+ * A context-aware policy for Cargo.lock files.
+ * Binary crates should commit Cargo.lock; library crates typically shouldn't.
+ *
+ * @public
+ */
+export const CargoLockPolicy = defineCargoPolicy({
+    name: "CargoLockPolicy",
+    description: "Context-aware Cargo.lock validation: binaries should commit it, libraries typically should not.",
+    handler: async (toml, { root, file, config }) => {
+        // Skip workspace root Cargo.toml
+        if (toml.workspace !== undefined && toml.package === undefined) {
+            return [];
+        }
+        const dir = path.dirname(path.resolve(root, file));
+        const lockExists = existsSync(path.join(dir, "Cargo.lock"));
+        const isBinary = isBinaryCrate(toml);
+        const isLib = isLibraryCrate(toml);
+        const binaryPolicy = config?.binaries ?? "require";
+        const libraryPolicy = config?.libraries ?? "ignore";
+        if (isBinary && binaryPolicy === "require" && !lockExists) {
+            return [
+                {
+                    message: "Binary crate is missing Cargo.lock. Binary crates should commit their lockfile for reproducible builds.",
+                    manualFix: "Run `cargo generate-lockfile` and commit the Cargo.lock file.",
+                },
+            ];
+        }
+        if (isLib && !isBinary && libraryPolicy === "warn" && lockExists) {
+            return [
+                {
+                    message: "Library crate has Cargo.lock committed. Library crates typically should not commit their lockfile.",
+                    manualFix: "Consider adding Cargo.lock to .gitignore for library crates.",
+                },
+            ];
+        }
+        return [];
+    },
+});
+//# sourceMappingURL=CargoLockPolicy.js.map