repopo 0.10.0 → 0.13.0

package/esm/adapters/fluidFramework.d.ts

@@ -1,10 +1,10 @@
-import type { PolicyDefinition } from "../policy.js";
+import type { FilePolicyDefinition } from "../policy.js";
 /**
  * A FluidFramework build-tools policy handler interface.
  *
  * This interface matches the `Handler` interface from `@fluidframework/build-tools`.
  *
- * @alpha
+ * @public
  */
 export interface FluidHandler {
     /**
@@ -31,17 +31,21 @@ export interface FluidHandler {
      * @returns An object indicating whether the fix was successful.
      */
     resolver?: (file: string, root: string) => Promise<{
+        /** Whether the violation was fixed. */
         resolved: boolean;
+        /** Optional explanation of the fix result. */
         message?: string;
     }> | {
+        /** Whether the violation was fixed. */
         resolved: boolean;
+        /** Optional explanation of the fix result. */
         message?: string;
     };
 }
 /**
  * Options for converting FluidFramework handlers to repopo policies.
  *
- * @alpha
+ * @public
  */
 export interface FluidAdapterOptions {
     /**
@@ -62,19 +66,19 @@ export interface FluidAdapterOptions {
  * Key differences handled by this adapter:
  *
  * - **Handler signature**: Fluid uses `(file, root) => string | undefined`,
- *   repopo uses `(args) => PolicyHandlerResult`
+ *   repopo uses `(args) => Promise<PolicyResult> | Operation<PolicyResult>`
  *
  * - **File paths**: Fluid passes absolute paths, repopo passes repo-relative paths.
  *   The adapter converts between the two.
  *
  * - **Return types**: Fluid returns `string | undefined` (error message or success),
- *   repopo returns `true | PolicyFailure | PolicyFixResult`
+ *   repopo returns `readonly PolicyFinding[]`
  *
  * For a single handler, wrap it in an array: `fromFluidHandlers([handler])`.
  *
  * @example
  * ```typescript
- * import { fromFluidHandlers, makePolicy } from "repopo";
+ * import { fromFluidHandlers, makePolicy, type RepopoConfig } from "repopo";
  * import { copyrightFileHeaderHandlers, fluidCaseHandler } from "@fluidframework/build-tools";
  *
  * // Convert multiple handlers with a namespace prefix
@@ -87,7 +91,7 @@ export interface FluidAdapterOptions {
  *
  * const config: RepopoConfig = {
  *   policies: [
- *     ...FluidCopyrightPolicies.map(p => makePolicy(p)),
+ *     ...FluidCopyrightPolicies.map((p) => makePolicy(p)),
  *     makePolicy(FluidCasePolicy),
  *   ],
  * };
@@ -97,7 +101,7 @@ export interface FluidAdapterOptions {
  * @param options - Optional configuration applied to all conversions.
  * @returns An array of repopo PolicyDefinitions.
  *
- * @alpha
+ * @public
  */
-export declare function fromFluidHandlers(fluidHandlers: FluidHandler[], options?: FluidAdapterOptions): PolicyDefinition[];
+export declare function fromFluidHandlers(fluidHandlers: FluidHandler[], options?: FluidAdapterOptions): FilePolicyDefinition[];
 //# sourceMappingURL=fluidFramework.d.ts.map

package/esm/adapters/fluidFramework.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"fluidFramework.d.ts","sourceRoot":"","sources":["../../src/adapters/fluidFramework.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACX,gBAAgB,EAIhB,MAAM,cAAc,CAAC;AAEtB;;;;;;GAMG;AACH,MAAM,WAAW,YAAY;IAC5B;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;IAEd;;;;;;OAMG;IACH,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;IAErE;;;;;;OAMG;IACH,QAAQ,CAAC,EAAE,CACV,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,KAEV,OAAO,CAAC;QAAE,QAAQ,EAAE,OAAO,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,GAChD;QAAE,QAAQ,EAAE,OAAO,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CAC3C;AAED;;;;GAIG;AACH,MAAM,WAAW,mBAAmB;IACnC;;;;OAIG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;CACpB;AAwFD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+CG;AACH,wBAAgB,iBAAiB,CAChC,aAAa,EAAE,YAAY,EAAE,EAC7B,OAAO,CAAC,EAAE,mBAAmB,GAC3B,gBAAgB,EAAE,CAEpB"}
+{"version":3,"file":"fluidFramework.d.ts","sourceRoot":"","sources":["../../src/adapters/fluidFramework.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,oBAAoB,EAAiB,MAAM,cAAc,CAAC;AAExE;;;;;;GAMG;AACH,MAAM,WAAW,YAAY;IAC5B;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;IAEd;;;;;;OAMG;IACH,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;IAErE;;;;;;OAMG;IACH,QAAQ,CAAC,EAAE,CACV,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,KAEV,OAAO,CAAC;QACR,uCAAuC;QACvC,QAAQ,EAAE,OAAO,CAAC;QAClB,8CAA8C;QAC9C,OAAO,CAAC,EAAE,MAAM,CAAC;KAChB,CAAC,GACF;QACA,uCAAuC;QACvC,QAAQ,EAAE,OAAO,CAAC;QAClB,8CAA8C;QAC9C,OAAO,CAAC,EAAE,MAAM,CAAC;KAChB,CAAC;CACL;AAED;;;;GAIG;AACH,MAAM,WAAW,mBAAmB;IACnC;;;;OAIG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;CACpB;AA8DD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+CG;AACH,wBAAgB,iBAAiB,CAChC,aAAa,EAAE,YAAY,EAAE,EAC7B,OAAO,CAAC,EAAE,mBAAmB,GAC3B,oBAAoB,EAAE,CAExB"}

package/esm/adapters/fluidFramework.js

@@ -1,5 +1,4 @@
 import path from "pathe";
-import { makePolicyDefinition } from "../makePolicy.js";
 /**
  * Converts a FluidFramework handler to a repopo PolicyDefinition.
  *
@@ -19,56 +18,34 @@ function fromFluidHandler(fluidHandler, options) {
         const absolutePath = path.join(root, file);
         const errorMessage = await fluidHandler.handler(absolutePath, root);
         if (errorMessage === undefined) {
-            return true;
+            return [];
         }
         // Check if resolver exists to determine if auto-fixable
         const autoFixable = fluidHandler.resolver !== undefined;
         // If resolve is requested and we have a resolver, try to fix
         if (resolve && fluidHandler.resolver !== undefined) {
             const resolveResult = await fluidHandler.resolver(absolutePath, root);
-            return {
-                name: policyName,
-                file,
-                errorMessages: [resolveResult.message ?? errorMessage],
-                autoFixable: true,
-                resolved: resolveResult.resolved,
-            };
+            return [
+                {
+                    message: resolveResult.message ?? errorMessage,
+                    fixStatus: resolveResult.resolved ? "fixed" : "failed",
+                },
+            ];
         }
-        return {
-            name: policyName,
-            file,
-            errorMessages: [errorMessage],
-            autoFixable,
-        };
+        return [
+            {
+                message: errorMessage,
+                fixStatus: autoFixable ? "available" : undefined,
+            },
+        ];
     };
-    // Create standalone resolver if Fluid handler has one
-    let resolver;
-    if (fluidHandler.resolver !== undefined) {
-        resolver = async ({ file, root }) => {
-            const absolutePath = path.join(root, file);
-            // First get the error message for context
-            const errorMessage = await fluidHandler.handler(absolutePath, root);
-            // biome-ignore lint/style/noNonNullAssertion: we checked this is defined above
-            const resolveResult = await fluidHandler.resolver(absolutePath, root);
-            return {
-                name: policyName,
-                file,
-                errorMessages: [
-                    resolveResult.message ?? errorMessage ?? "Unknown error",
-                ],
-                autoFixable: true,
-                resolved: resolveResult.resolved,
-            };
-        };
-    }
-    return makePolicyDefinition({
+    return {
         name: policyName,
         description: `FluidFramework policy: ${fluidHandler.name}`,
         match: fluidHandler.match,
         handler,
         defaultConfig: undefined, // no config
-        resolver,
-    });
+    };
 }
 /**
  * Converts FluidFramework handlers to repopo PolicyDefinitions.
@@ -81,19 +58,19 @@ function fromFluidHandler(fluidHandler, options) {
  * Key differences handled by this adapter:
  *
  * - **Handler signature**: Fluid uses `(file, root) => string | undefined`,
- *   repopo uses `(args) => PolicyHandlerResult`
+ *   repopo uses `(args) => Promise<PolicyResult> | Operation<PolicyResult>`
  *
  * - **File paths**: Fluid passes absolute paths, repopo passes repo-relative paths.
  *   The adapter converts between the two.
  *
  * - **Return types**: Fluid returns `string | undefined` (error message or success),
- *   repopo returns `true | PolicyFailure | PolicyFixResult`
+ *   repopo returns `readonly PolicyFinding[]`
  *
  * For a single handler, wrap it in an array: `fromFluidHandlers([handler])`.
  *
  * @example
  * ```typescript
- * import { fromFluidHandlers, makePolicy } from "repopo";
+ * import { fromFluidHandlers, makePolicy, type RepopoConfig } from "repopo";
  * import { copyrightFileHeaderHandlers, fluidCaseHandler } from "@fluidframework/build-tools";
  *
  * // Convert multiple handlers with a namespace prefix
@@ -106,7 +83,7 @@ function fromFluidHandler(fluidHandler, options) {
  *
  * const config: RepopoConfig = {
  *   policies: [
- *     ...FluidCopyrightPolicies.map(p => makePolicy(p)),
+ *     ...FluidCopyrightPolicies.map((p) => makePolicy(p)),
  *     makePolicy(FluidCasePolicy),
  *   ],
  * };
@@ -116,7 +93,7 @@ function fromFluidHandler(fluidHandler, options) {
  * @param options - Optional configuration applied to all conversions.
  * @returns An array of repopo PolicyDefinitions.
  *
- * @alpha
+ * @public
  */
 export function fromFluidHandlers(fluidHandlers, options) {
     return fluidHandlers.map((h) => fromFluidHandler(h, options));

package/esm/adapters/fluidFramework.js.map

@@ -1 +1 @@
-{"version":3,"file":"fluidFramework.js","sourceRoot":"","sources":["../../src/adapters/fluidFramework.ts"],"names":[],"mappings":"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","sourcesContent":["import path from \"pathe\";\nimport { makePolicyDefinition } from \"../makePolicy.js\";\nimport type {\n\tPolicyDefinition,\n\tPolicyFixResult,\n\tPolicyHandler,\n\tPolicyStandaloneResolver,\n} from \"../policy.js\";\n\n/**\n * A FluidFramework build-tools policy handler interface.\n *\n * This interface matches the `Handler` interface from `@fluidframework/build-tools`.\n *\n * @alpha\n */\nexport interface FluidHandler {\n\t/**\n\t * The name of the handler, used for filtering and display.\n\t */\n\tname: string;\n\n\t/**\n\t * A regex pattern that determines which files this handler applies to.\n\t */\n\tmatch: RegExp;\n\n\t/**\n\t * The handler function that checks a file against the policy.\n\t *\n\t * @param file - Absolute path to the file.\n\t * @param root - Path to the repo root.\n\t * @returns `undefined` if the check passes, otherwise an error message string.\n\t */\n\thandler: (file: string, root: string) => Promise<string | undefined>;\n\n\t/**\n\t * Optional resolver function that attempts to fix policy violations.\n\t *\n\t * @param file - Absolute path to the file.\n\t * @param root - Path to the repo root.\n\t * @returns An object indicating whether the fix was successful.\n\t */\n\tresolver?: (\n\t\tfile: string,\n\t\troot: string,\n\t) =>\n\t\t| Promise<{ resolved: boolean; message?: string }>\n\t\t| { resolved: boolean; message?: string };\n}\n\n/**\n * Options for converting FluidFramework handlers to repopo policies.\n *\n * @alpha\n */\nexport interface FluidAdapterOptions {\n\t/**\n\t * Optional prefix to add to policy names. Useful for namespacing Fluid policies.\n\t *\n\t * @example \"Fluid:\" would result in \"Fluid:my-handler-name\"\n\t */\n\tnamePrefix?: string;\n}\n\n/**\n * Converts a FluidFramework handler to a repopo PolicyDefinition.\n *\n * This is an internal function used by {@link fromFluidHandlers}.\n *\n * @param fluidHandler - A FluidFramework Handler object to convert.\n * @param options - Optional configuration for the conversion.\n * @returns A repopo PolicyDefinition that wraps the Fluid handler.\n *\n * @internal\n */\nfunction fromFluidHandler(\n\tfluidHandler: FluidHandler,\n\toptions?: FluidAdapterOptions,\n): PolicyDefinition {\n\tconst { namePrefix = \"\" } = options ?? {};\n\tconst policyName = `${namePrefix}${fluidHandler.name}`;\n\n\tconst handler: PolicyHandler = async ({ file, root, resolve }) => {\n\t\t// Fluid handlers expect absolute paths\n\t\tconst absolutePath = path.join(root, file);\n\n\t\tconst errorMessage = await fluidHandler.handler(absolutePath, root);\n\n\t\tif (errorMessage === undefined) {\n\t\t\treturn true;\n\t\t}\n\n\t\t// Check if resolver exists to determine if auto-fixable\n\t\tconst autoFixable = fluidHandler.resolver !== undefined;\n\n\t\t// If resolve is requested and we have a resolver, try to fix\n\t\tif (resolve && fluidHandler.resolver !== undefined) {\n\t\t\tconst resolveResult = await fluidHandler.resolver(absolutePath, root);\n\n\t\t\treturn {\n\t\t\t\tname: policyName,\n\t\t\t\tfile,\n\t\t\t\terrorMessages: [resolveResult.message ?? errorMessage],\n\t\t\t\tautoFixable: true,\n\t\t\t\tresolved: resolveResult.resolved,\n\t\t\t} satisfies PolicyFixResult;\n\t\t}\n\n\t\treturn {\n\t\t\tname: policyName,\n\t\t\tfile,\n\t\t\terrorMessages: [errorMessage],\n\t\t\tautoFixable,\n\t\t};\n\t};\n\n\t// Create standalone resolver if Fluid handler has one\n\tlet resolver: PolicyStandaloneResolver | undefined;\n\tif (fluidHandler.resolver !== undefined) {\n\t\tresolver = async ({ file, root }) => {\n\t\t\tconst absolutePath = path.join(root, file);\n\n\t\t\t// First get the error message for context\n\t\t\tconst errorMessage = await fluidHandler.handler(absolutePath, root);\n\n\t\t\t// biome-ignore lint/style/noNonNullAssertion: we checked this is defined above\n\t\t\tconst resolveResult = await fluidHandler.resolver!(absolutePath, root);\n\n\t\t\treturn {\n\t\t\t\tname: policyName,\n\t\t\t\tfile,\n\t\t\t\terrorMessages: [\n\t\t\t\t\tresolveResult.message ?? errorMessage ?? \"Unknown error\",\n\t\t\t\t],\n\t\t\t\tautoFixable: true,\n\t\t\t\tresolved: resolveResult.resolved,\n\t\t\t};\n\t\t};\n\t}\n\n\treturn makePolicyDefinition({\n\t\tname: policyName,\n\t\tdescription: `FluidFramework policy: ${fluidHandler.name}`,\n\t\tmatch: fluidHandler.match,\n\t\thandler,\n\t\tdefaultConfig: undefined, // no config\n\t\tresolver,\n\t});\n}\n\n/**\n * Converts FluidFramework handlers to repopo PolicyDefinitions.\n *\n * This adapter bridges the gap between FluidFramework's build-tools policy system\n * and repopo's policy system, allowing you to reuse existing Fluid policies in repopo.\n *\n * @remarks\n *\n * Key differences handled by this adapter:\n *\n * - **Handler signature**: Fluid uses `(file, root) => string | undefined`,\n *   repopo uses `(args) => PolicyHandlerResult`\n *\n * - **File paths**: Fluid passes absolute paths, repopo passes repo-relative paths.\n *   The adapter converts between the two.\n *\n * - **Return types**: Fluid returns `string | undefined` (error message or success),\n *   repopo returns `true | PolicyFailure | PolicyFixResult`\n *\n * For a single handler, wrap it in an array: `fromFluidHandlers([handler])`.\n *\n * @example\n * ```typescript\n * import { fromFluidHandlers, makePolicy } from \"repopo\";\n * import { copyrightFileHeaderHandlers, fluidCaseHandler } from \"@fluidframework/build-tools\";\n *\n * // Convert multiple handlers with a namespace prefix\n * const FluidCopyrightPolicies = fromFluidHandlers(copyrightFileHeaderHandlers, {\n *   namePrefix: \"Fluid:\",\n * });\n *\n * // For a single handler, wrap it in an array\n * const [FluidCasePolicy] = fromFluidHandlers([fluidCaseHandler]);\n *\n * const config: RepopoConfig = {\n *   policies: [\n *     ...FluidCopyrightPolicies.map(p => makePolicy(p)),\n *     makePolicy(FluidCasePolicy),\n *   ],\n * };\n * ```\n *\n * @param fluidHandlers - An array of FluidFramework Handler objects to convert.\n * @param options - Optional configuration applied to all conversions.\n * @returns An array of repopo PolicyDefinitions.\n *\n * @alpha\n */\nexport function fromFluidHandlers(\n\tfluidHandlers: FluidHandler[],\n\toptions?: FluidAdapterOptions,\n): PolicyDefinition[] {\n\treturn fluidHandlers.map((h) => fromFluidHandler(h, options));\n}\n"]}
+{"version":3,"file":"fluidFramework.js","sourceRoot":"","sources":["../../src/adapters/fluidFramework.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,OAAO,CAAC;AAqEzB;;;;;;;;;;GAUG;AACH,SAAS,gBAAgB,CACxB,YAA0B,EAC1B,OAA6B;IAE7B,MAAM,EAAE,UAAU,GAAG,EAAE,EAAE,GAAG,OAAO,IAAI,EAAE,CAAC;IAC1C,MAAM,UAAU,GAAG,GAAG,UAAU,GAAG,YAAY,CAAC,IAAI,EAAE,CAAC;IAEvD,MAAM,OAAO,GAAkB,KAAK,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,EAAE;QAChE,uCAAuC;QACvC,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QAE3C,MAAM,YAAY,GAAG,MAAM,YAAY,CAAC,OAAO,CAAC,YAAY,EAAE,IAAI,CAAC,CAAC;QAEpE,IAAI,YAAY,KAAK,SAAS,EAAE,CAAC;YAChC,OAAO,EAAE,CAAC;QACX,CAAC;QAED,wDAAwD;QACxD,MAAM,WAAW,GAAG,YAAY,CAAC,QAAQ,KAAK,SAAS,CAAC;QAExD,6DAA6D;QAC7D,IAAI,OAAO,IAAI,YAAY,CAAC,QAAQ,KAAK,SAAS,EAAE,CAAC;YACpD,MAAM,aAAa,GAAG,MAAM,YAAY,CAAC,QAAQ,CAAC,YAAY,EAAE,IAAI,CAAC,CAAC;YAEtE,OAAO;gBACN;oBACC,OAAO,EAAE,aAAa,CAAC,OAAO,IAAI,YAAY;oBAC9C,SAAS,EAAE,aAAa,CAAC,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ;iBACtD;aACD,CAAC;QACH,CAAC;QAED,OAAO;YACN;gBACC,OAAO,EAAE,YAAY;gBACrB,SAAS,EAAE,WAAW,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,SAAS;aAChD;SACD,CAAC;IACH,CAAC,CAAC;IAEF,OAAO;QACN,IAAI,EAAE,UAAU;QAChB,WAAW,EAAE,0BAA0B,YAAY,CAAC,IAAI,EAAE;QAC1D,KAAK,EAAE,YAAY,CAAC,KAAK;QACzB,OAAO;QACP,aAAa,EAAE,SAAS,EAAE,YAAY;KACP,CAAC;AAClC,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+CG;AACH,MAAM,UAAU,iBAAiB,CAChC,aAA6B,EAC7B,OAA6B;IAE7B,OAAO,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,gBAAgB,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC;AAC/D,CAAC","sourcesContent":["import path from \"pathe\";\nimport type { FilePolicyDefinition, PolicyHandler } from \"../policy.js\";\n\n/**\n * A FluidFramework build-tools policy handler interface.\n *\n * This interface matches the `Handler` interface from `@fluidframework/build-tools`.\n *\n * @public\n */\nexport interface FluidHandler {\n\t/**\n\t * The name of the handler, used for filtering and display.\n\t */\n\tname: string;\n\n\t/**\n\t * A regex pattern that determines which files this handler applies to.\n\t */\n\tmatch: RegExp;\n\n\t/**\n\t * The handler function that checks a file against the policy.\n\t *\n\t * @param file - Absolute path to the file.\n\t * @param root - Path to the repo root.\n\t * @returns `undefined` if the check passes, otherwise an error message string.\n\t */\n\thandler: (file: string, root: string) => Promise<string | undefined>;\n\n\t/**\n\t * Optional resolver function that attempts to fix policy violations.\n\t *\n\t * @param file - Absolute path to the file.\n\t * @param root - Path to the repo root.\n\t * @returns An object indicating whether the fix was successful.\n\t */\n\tresolver?: (\n\t\tfile: string,\n\t\troot: string,\n\t) =>\n\t\t| Promise<{\n\t\t\t\t/** Whether the violation was fixed. */\n\t\t\t\tresolved: boolean;\n\t\t\t\t/** Optional explanation of the fix result. */\n\t\t\t\tmessage?: string;\n\t\t  }>\n\t\t| {\n\t\t\t\t/** Whether the violation was fixed. */\n\t\t\t\tresolved: boolean;\n\t\t\t\t/** Optional explanation of the fix result. */\n\t\t\t\tmessage?: string;\n\t\t  };\n}\n\n/**\n * Options for converting FluidFramework handlers to repopo policies.\n *\n * @public\n */\nexport interface FluidAdapterOptions {\n\t/**\n\t * Optional prefix to add to policy names. Useful for namespacing Fluid policies.\n\t *\n\t * @example \"Fluid:\" would result in \"Fluid:my-handler-name\"\n\t */\n\tnamePrefix?: string;\n}\n\n/**\n * Converts a FluidFramework handler to a repopo PolicyDefinition.\n *\n * This is an internal function used by {@link fromFluidHandlers}.\n *\n * @param fluidHandler - A FluidFramework Handler object to convert.\n * @param options - Optional configuration for the conversion.\n * @returns A repopo PolicyDefinition that wraps the Fluid handler.\n *\n * @internal\n */\nfunction fromFluidHandler(\n\tfluidHandler: FluidHandler,\n\toptions?: FluidAdapterOptions,\n): FilePolicyDefinition {\n\tconst { namePrefix = \"\" } = options ?? {};\n\tconst policyName = `${namePrefix}${fluidHandler.name}`;\n\n\tconst handler: PolicyHandler = async ({ file, root, resolve }) => {\n\t\t// Fluid handlers expect absolute paths\n\t\tconst absolutePath = path.join(root, file);\n\n\t\tconst errorMessage = await fluidHandler.handler(absolutePath, root);\n\n\t\tif (errorMessage === undefined) {\n\t\t\treturn [];\n\t\t}\n\n\t\t// Check if resolver exists to determine if auto-fixable\n\t\tconst autoFixable = fluidHandler.resolver !== undefined;\n\n\t\t// If resolve is requested and we have a resolver, try to fix\n\t\tif (resolve && fluidHandler.resolver !== undefined) {\n\t\t\tconst resolveResult = await fluidHandler.resolver(absolutePath, root);\n\n\t\t\treturn [\n\t\t\t\t{\n\t\t\t\t\tmessage: resolveResult.message ?? errorMessage,\n\t\t\t\t\tfixStatus: resolveResult.resolved ? \"fixed\" : \"failed\",\n\t\t\t\t},\n\t\t\t];\n\t\t}\n\n\t\treturn [\n\t\t\t{\n\t\t\t\tmessage: errorMessage,\n\t\t\t\tfixStatus: autoFixable ? \"available\" : undefined,\n\t\t\t},\n\t\t];\n\t};\n\n\treturn {\n\t\tname: policyName,\n\t\tdescription: `FluidFramework policy: ${fluidHandler.name}`,\n\t\tmatch: fluidHandler.match,\n\t\thandler,\n\t\tdefaultConfig: undefined, // no config\n\t} satisfies FilePolicyDefinition;\n}\n\n/**\n * Converts FluidFramework handlers to repopo PolicyDefinitions.\n *\n * This adapter bridges the gap between FluidFramework's build-tools policy system\n * and repopo's policy system, allowing you to reuse existing Fluid policies in repopo.\n *\n * @remarks\n *\n * Key differences handled by this adapter:\n *\n * - **Handler signature**: Fluid uses `(file, root) => string | undefined`,\n *   repopo uses `(args) => Promise<PolicyResult> | Operation<PolicyResult>`\n *\n * - **File paths**: Fluid passes absolute paths, repopo passes repo-relative paths.\n *   The adapter converts between the two.\n *\n * - **Return types**: Fluid returns `string | undefined` (error message or success),\n *   repopo returns `readonly PolicyFinding[]`\n *\n * For a single handler, wrap it in an array: `fromFluidHandlers([handler])`.\n *\n * @example\n * ```typescript\n * import { fromFluidHandlers, makePolicy, type RepopoConfig } from \"repopo\";\n * import { copyrightFileHeaderHandlers, fluidCaseHandler } from \"@fluidframework/build-tools\";\n *\n * // Convert multiple handlers with a namespace prefix\n * const FluidCopyrightPolicies = fromFluidHandlers(copyrightFileHeaderHandlers, {\n *   namePrefix: \"Fluid:\",\n * });\n *\n * // For a single handler, wrap it in an array\n * const [FluidCasePolicy] = fromFluidHandlers([fluidCaseHandler]);\n *\n * const config: RepopoConfig = {\n *   policies: [\n *     ...FluidCopyrightPolicies.map((p) => makePolicy(p)),\n *     makePolicy(FluidCasePolicy),\n *   ],\n * };\n * ```\n *\n * @param fluidHandlers - An array of FluidFramework Handler objects to convert.\n * @param options - Optional configuration applied to all conversions.\n * @returns An array of repopo PolicyDefinitions.\n *\n * @public\n */\nexport function fromFluidHandlers(\n\tfluidHandlers: FluidHandler[],\n\toptions?: FluidAdapterOptions,\n): FilePolicyDefinition[] {\n\treturn fluidHandlers.map((h) => fromFluidHandler(h, options));\n}\n"]}

package/esm/api.d.ts

@@ -1,2 +1,65 @@
-export {};
+/**
+ * A tool for enforcing repository policies and standards across codebases.
+ *
+ * @remarks
+ * Repopo provides a framework for defining and enforcing policies across repositories,
+ * such as file headers, package.json consistency, and other code standards.
+ * It can be used as a CLI tool or integrated into CI/CD pipelines.
+ *
+ * @packageDocumentation
+ */
+export { type FluidAdapterOptions, type FluidHandler, fromFluidHandlers, } from "./adapters/fluidFramework.js";
+export type { RepopoConfig } from "./config.js";
+export { makePolicy } from "./makePolicy.js";
+export type { PolicyAction, PolicyHandlerPerfStats } from "./perf.js";
+export type { CargoLicenceValidatedConfig } from "./policies/CargoLicenceValidated.js";
+export type { CargoLintsConfiguredConfig } from "./policies/CargoLintsConfigured.js";
+export type { CargoLockPolicyConfig } from "./policies/CargoLockPolicy.js";
+export type { CargoTomlRequiredConfig } from "./policies/CargoTomlRequired.js";
+export type { CargoTomlSortedConfig } from "./policies/CargoTomlSorted.js";
+export type { ConditionalScriptEntry, ConditionalScriptRule, ConditionalScriptsConfig, } from "./policies/ConditionalScripts.js";
+export type { ExactScriptsConfig } from "./policies/ExactScripts.js";
+export type { GleamDepVersionsConfig } from "./policies/GleamDepVersions.js";
+export type { GleamDocExistsConfig } from "./policies/GleamDocExists.js";
+export type { GleamInternalModulesConfiguredConfig } from "./policies/GleamInternalModulesConfigured.js";
+export type { GleamLicenceConfiguredConfig } from "./policies/GleamLicenceConfigured.js";
+export type { GleamMonorepoConsistencyConfig } from "./policies/GleamMonorepoConsistency.js";
+export type { GleamNameRestrictionsConfig } from "./policies/GleamNameRestrictions.js";
+export type { GleamNoPathDepsInPublishedConfig } from "./policies/GleamNoPathDepsInPublished.js";
+export type { GleamProjectStructureConfig } from "./policies/GleamProjectStructure.js";
+export type { GleamSharedDependencyVersionsConfig } from "./policies/GleamSharedDependencyVersions.js";
+export type { GleamTomlRequiredConfig } from "./policies/GleamTomlRequired.js";
+export type { GleamTomlSortedConfig } from "./policies/GleamTomlSorted.js";
+export type { GleamVersionConstraintConfig } from "./policies/GleamVersionConstraint.js";
+export type { LicenseFileExistsSettings } from "./policies/LicenseFileExists.js";
+export type { MutuallyExclusiveScriptsConfig } from "./policies/MutuallyExclusiveScripts.js";
+export type { NoLargeBinaryFilesSettings } from "./policies/NoLargeBinaryFiles.js";
+export type { NoPrivateWorkspaceDependenciesSettings } from "./policies/NoPrivateWorkspaceDependencies.js";
+export type { NoUnsafeWithoutJustificationConfig } from "./policies/NoUnsafeWithoutJustification.js";
+export type { NoWildcardDependenciesConfig } from "./policies/NoWildcardDependencies.js";
+export type { PackageAllowedScopesConfig } from "./policies/PackageAllowedScopes.js";
+export type { PackageEsmTypeConfig } from "./policies/PackageEsmType.js";
+export type { PackageFolderNameConfig } from "./policies/PackageFolderName.js";
+export type { PackageJsonPropertiesSettings } from "./policies/PackageJsonProperties.js";
+export type { PackageLicenseSettings } from "./policies/PackageLicense.js";
+export type { PackagePrivateFieldConfig } from "./policies/PackagePrivateField.js";
+export type { PackageReadmeSettings } from "./policies/PackageReadme.js";
+export type { PackageScriptsSettings, ScriptMustContainRule, } from "./policies/PackageScripts.js";
+export type { PackageTestScriptsConfig } from "./policies/PackageTestScripts.js";
+export type { PublicApiDocumentedConfig } from "./policies/PublicApiDocumented.js";
+export type { RequiredGitignorePatternsSettings } from "./policies/RequiredGitignorePatterns.js";
+export type { RequiredScriptEntry, RequiredScriptsConfig, } from "./policies/RequiredScripts.js";
+export type { RustDocExistsConfig } from "./policies/RustDocExists.js";
+export type { RustfmtConfigExistsConfig } from "./policies/RustfmtConfigExists.js";
+export type { RustToolchainExistsConfig } from "./policies/RustToolchainExists.js";
+export type { ScriptContainsConfig, ScriptContainsRule, } from "./policies/ScriptContains.js";
+export type { SharedDependencyVersionsConfig } from "./policies/SharedDependencyVersions.js";
+export type { WorkspaceInheritanceConfig } from "./policies/WorkspaceInheritance.js";
+export type { WorkspaceMembersValidConfig } from "./policies/WorkspaceMembersValid.js";
+export type { ConfiguredFilePolicy, ConfiguredPolicy, ConfiguredRepositoryPolicy, FilePolicyDefinition, IdentifiedPolicy, PolicyArgs, PolicyDefinition, PolicyFinding, PolicyHandler, PolicyInstanceId, PolicyName, PolicyOptions, PolicyResolver, PolicyResult, RepositoryPolicyArgs, RepositoryPolicyDefinition, RepositoryPolicyHandler, } from "./policy.js";
+export { type CargoToml, type CargoTomlHandler, type DefineCargoPolicyArgs, defineCargoPolicy, } from "./policyDefiners/defineCargoPolicy.js";
+export { type DefineFileHeaderPolicyArgs, defineFileHeaderPolicy, type FileHeaderGeneratorConfig, type FileHeaderPolicyConfig, } from "./policyDefiners/defineFileHeaderPolicy.js";
+export { type DefineGleamPolicyArgs, defineGleamPolicy, type GleamToml, type GleamTomlHandler, } from "./policyDefiners/defineGleamPolicy.js";
+export { type DefinePackagePolicyArgs, definePackagePolicy, type PackageJsonHandler, } from "./policyDefiners/definePackagePolicy.js";
+export { type PolicyExecutionError, type PolicyRunFinding, PolicyRunner, type PolicyRunnerOptions, type PolicyRunResults, type PolicySkippedWork, type RepositoryInventory, runPolicies, } from "./runner.js";
 //# sourceMappingURL=api.d.ts.map

package/esm/api.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../src/api.ts"],"names":[],"mappings":""}
+{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../src/api.ts"],"names":[],"mappings":"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"}

package/esm/api.js

@@ -1,2 +1,18 @@
-export {};
+/**
+ * A tool for enforcing repository policies and standards across codebases.
+ *
+ * @remarks
+ * Repopo provides a framework for defining and enforcing policies across repositories,
+ * such as file headers, package.json consistency, and other code standards.
+ * It can be used as a CLI tool or integrated into CI/CD pipelines.
+ *
+ * @packageDocumentation
+ */
+export { fromFluidHandlers, } from "./adapters/fluidFramework.js";
+export { makePolicy } from "./makePolicy.js";
+export { defineCargoPolicy, } from "./policyDefiners/defineCargoPolicy.js";
+export { defineFileHeaderPolicy, } from "./policyDefiners/defineFileHeaderPolicy.js";
+export { defineGleamPolicy, } from "./policyDefiners/defineGleamPolicy.js";
+export { definePackagePolicy, } from "./policyDefiners/definePackagePolicy.js";
+export { PolicyRunner, runPolicies, } from "./runner.js";
 //# sourceMappingURL=api.js.map

package/esm/api.js.map

@@ -1 +1 @@
-{"version":3,"file":"api.js","sourceRoot":"","sources":["../src/api.ts"],"names":[],"mappings":"","sourcesContent":[""]}
+{"version":3,"file":"api.js","sourceRoot":"","sources":["../src/api.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAGN,iBAAiB,GACjB,MAAM,8BAA8B,CAAC;AAEtC,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AA8E7C,OAAO,EAIN,iBAAiB,GACjB,MAAM,uCAAuC,CAAC;AAC/C,OAAO,EAEN,sBAAsB,GAGtB,MAAM,4CAA4C,CAAC;AACpD,OAAO,EAEN,iBAAiB,GAGjB,MAAM,uCAAuC,CAAC;AAC/C,OAAO,EAEN,mBAAmB,GAEnB,MAAM,yCAAyC,CAAC;AACjD,OAAO,EAGN,YAAY,EAKZ,WAAW,GACX,MAAM,aAAa,CAAC","sourcesContent":["/**\n * A tool for enforcing repository policies and standards across codebases.\n *\n * @remarks\n * Repopo provides a framework for defining and enforcing policies across repositories,\n * such as file headers, package.json consistency, and other code standards.\n * It can be used as a CLI tool or integrated into CI/CD pipelines.\n *\n * @packageDocumentation\n */\n\nexport {\n\ttype FluidAdapterOptions,\n\ttype FluidHandler,\n\tfromFluidHandlers,\n} from \"./adapters/fluidFramework.js\";\nexport type { RepopoConfig } from \"./config.js\";\nexport { makePolicy } from \"./makePolicy.js\";\nexport type { PolicyAction, PolicyHandlerPerfStats } from \"./perf.js\";\nexport type { CargoLicenceValidatedConfig } from \"./policies/CargoLicenceValidated.js\";\nexport type { CargoLintsConfiguredConfig } from \"./policies/CargoLintsConfigured.js\";\nexport type { CargoLockPolicyConfig } from \"./policies/CargoLockPolicy.js\";\nexport type { CargoTomlRequiredConfig } from \"./policies/CargoTomlRequired.js\";\nexport type { CargoTomlSortedConfig } from \"./policies/CargoTomlSorted.js\";\nexport type {\n\tConditionalScriptEntry,\n\tConditionalScriptRule,\n\tConditionalScriptsConfig,\n} from \"./policies/ConditionalScripts.js\";\nexport type { ExactScriptsConfig } from \"./policies/ExactScripts.js\";\nexport type { GleamDepVersionsConfig } from \"./policies/GleamDepVersions.js\";\nexport type { GleamDocExistsConfig } from \"./policies/GleamDocExists.js\";\nexport type { GleamInternalModulesConfiguredConfig } from \"./policies/GleamInternalModulesConfigured.js\";\nexport type { GleamLicenceConfiguredConfig } from \"./policies/GleamLicenceConfigured.js\";\nexport type { GleamMonorepoConsistencyConfig } from \"./policies/GleamMonorepoConsistency.js\";\nexport type { GleamNameRestrictionsConfig } from \"./policies/GleamNameRestrictions.js\";\nexport type { GleamNoPathDepsInPublishedConfig } from \"./policies/GleamNoPathDepsInPublished.js\";\nexport type { GleamProjectStructureConfig } from \"./policies/GleamProjectStructure.js\";\nexport type { GleamSharedDependencyVersionsConfig } from \"./policies/GleamSharedDependencyVersions.js\";\nexport type { GleamTomlRequiredConfig } from \"./policies/GleamTomlRequired.js\";\nexport type { GleamTomlSortedConfig } from \"./policies/GleamTomlSorted.js\";\nexport type { GleamVersionConstraintConfig } from \"./policies/GleamVersionConstraint.js\";\nexport type { LicenseFileExistsSettings } from \"./policies/LicenseFileExists.js\";\nexport type { MutuallyExclusiveScriptsConfig } from \"./policies/MutuallyExclusiveScripts.js\";\nexport type { NoLargeBinaryFilesSettings } from \"./policies/NoLargeBinaryFiles.js\";\nexport type { NoPrivateWorkspaceDependenciesSettings } from \"./policies/NoPrivateWorkspaceDependencies.js\";\nexport type { NoUnsafeWithoutJustificationConfig } from \"./policies/NoUnsafeWithoutJustification.js\";\nexport type { NoWildcardDependenciesConfig } from \"./policies/NoWildcardDependencies.js\";\nexport type { PackageAllowedScopesConfig } from \"./policies/PackageAllowedScopes.js\";\nexport type { PackageEsmTypeConfig } from \"./policies/PackageEsmType.js\";\nexport type { PackageFolderNameConfig } from \"./policies/PackageFolderName.js\";\nexport type { PackageJsonPropertiesSettings } from \"./policies/PackageJsonProperties.js\";\nexport type { PackageLicenseSettings } from \"./policies/PackageLicense.js\";\nexport type { PackagePrivateFieldConfig } from \"./policies/PackagePrivateField.js\";\nexport type { PackageReadmeSettings } from \"./policies/PackageReadme.js\";\nexport type {\n\tPackageScriptsSettings,\n\tScriptMustContainRule,\n} from \"./policies/PackageScripts.js\";\nexport type { PackageTestScriptsConfig } from \"./policies/PackageTestScripts.js\";\nexport type { PublicApiDocumentedConfig } from \"./policies/PublicApiDocumented.js\";\nexport type { RequiredGitignorePatternsSettings } from \"./policies/RequiredGitignorePatterns.js\";\nexport type {\n\tRequiredScriptEntry,\n\tRequiredScriptsConfig,\n} from \"./policies/RequiredScripts.js\";\nexport type { RustDocExistsConfig } from \"./policies/RustDocExists.js\";\nexport type { RustfmtConfigExistsConfig } from \"./policies/RustfmtConfigExists.js\";\nexport type { RustToolchainExistsConfig } from \"./policies/RustToolchainExists.js\";\nexport type {\n\tScriptContainsConfig,\n\tScriptContainsRule,\n} from \"./policies/ScriptContains.js\";\nexport type { SharedDependencyVersionsConfig } from \"./policies/SharedDependencyVersions.js\";\nexport type { WorkspaceInheritanceConfig } from \"./policies/WorkspaceInheritance.js\";\nexport type { WorkspaceMembersValidConfig } from \"./policies/WorkspaceMembersValid.js\";\nexport type {\n\tConfiguredFilePolicy,\n\tConfiguredPolicy,\n\tConfiguredRepositoryPolicy,\n\tFilePolicyDefinition,\n\tIdentifiedPolicy,\n\tPolicyArgs,\n\tPolicyDefinition,\n\tPolicyFinding,\n\tPolicyHandler,\n\tPolicyInstanceId,\n\tPolicyName,\n\tPolicyOptions,\n\tPolicyResolver,\n\tPolicyResult,\n\tRepositoryPolicyArgs,\n\tRepositoryPolicyDefinition,\n\tRepositoryPolicyHandler,\n} from \"./policy.js\";\nexport {\n\ttype CargoToml,\n\ttype CargoTomlHandler,\n\ttype DefineCargoPolicyArgs,\n\tdefineCargoPolicy,\n} from \"./policyDefiners/defineCargoPolicy.js\";\nexport {\n\ttype DefineFileHeaderPolicyArgs,\n\tdefineFileHeaderPolicy,\n\ttype FileHeaderGeneratorConfig,\n\ttype FileHeaderPolicyConfig,\n} from \"./policyDefiners/defineFileHeaderPolicy.js\";\nexport {\n\ttype DefineGleamPolicyArgs,\n\tdefineGleamPolicy,\n\ttype GleamToml,\n\ttype GleamTomlHandler,\n} from \"./policyDefiners/defineGleamPolicy.js\";\nexport {\n\ttype DefinePackagePolicyArgs,\n\tdefinePackagePolicy,\n\ttype PackageJsonHandler,\n} from \"./policyDefiners/definePackagePolicy.js\";\nexport {\n\ttype PolicyExecutionError,\n\ttype PolicyRunFinding,\n\tPolicyRunner,\n\ttype PolicyRunnerOptions,\n\ttype PolicyRunResults,\n\ttype PolicySkippedWork,\n\ttype RepositoryInventory,\n\trunPolicies,\n} from \"./runner.js\";\n"]}

package/esm/baseCommand.d.ts

@@ -1,7 +1,7 @@
 import { CommandWithConfig, type CommandWithContext, type RequiresGit } from "@tylerbu/cli-api";
 import { type SimpleGit } from "simple-git";
 import { type RepopoConfig } from "./config.js";
-import type { RepopoCommandContext } from "./context.js";
+import { type RepopoCommandContext } from "./context.js";
 /**
  * This class is the base for all repopo commands. It contains common flags and config loading.
  */

package/esm/baseCommand.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"baseCommand.d.ts","sourceRoot":"","sources":["../src/baseCommand.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,iBAAiB,EACjB,KAAK,kBAAkB,EACvB,KAAK,WAAW,EAChB,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EAAE,KAAK,SAAS,EAAa,MAAM,YAAY,CAAC;AACvD,OAAO,EAAuB,KAAK,YAAY,EAAE,MAAM,aAAa,CAAC;AACrE,OAAO,KAAK,EAAyB,oBAAoB,EAAE,MAAM,cAAc,CAAC;AAKhF;;GAEG;AACH,8BAAsB,iBAAiB,CACrC,CAAC,SAAS,OAAO,iBAAiB,GAAG;IACpC,IAAI,EAAE,OAAO,iBAAiB,CAAC,IAAI,CAAC;IACpC,KAAK,EAAE,OAAO,iBAAiB,CAAC,KAAK,CAAC;CACtC,CAEF,SAAQ,iBAAiB,CAAC,CAAC,EAAE,YAAY,CACzC,YAAW,kBAAkB,CAAC,oBAAoB,CAAC,EAAE,WAAW;IAEhE,UAAmB,aAAa,eAAuB;IACvD,UAAmB,OAAO,oCAAyB;IAEnD,gBAAgC,KAAK;;MAE1B;IAEX,OAAO,CAAC,IAAI,CAAwB;IACpC,IAAW,GAAG,IAAI,SAAS,CAK1B;IAEqB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAyB3C,OAAO,CAAC,QAAQ,CAAmC;IAEtC,UAAU,IAAI,OAAO,CAAC,oBAAoB,CAAC;CAMxD"}
+{"version":3,"file":"baseCommand.d.ts","sourceRoot":"","sources":["../src/baseCommand.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,iBAAiB,EACjB,KAAK,kBAAkB,EACvB,KAAK,WAAW,EAChB,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EAAE,KAAK,SAAS,EAAa,MAAM,YAAY,CAAC;AACvD,OAAO,EAAuB,KAAK,YAAY,EAAE,MAAM,aAAa,CAAC;AACrE,OAAO,EAGN,KAAK,oBAAoB,EACzB,MAAM,cAAc,CAAC;AAKtB;;GAEG;AACH,8BAAsB,iBAAiB,CACrC,CAAC,SAAS,OAAO,iBAAiB,GAAG;IACpC,IAAI,EAAE,OAAO,iBAAiB,CAAC,IAAI,CAAC;IACpC,KAAK,EAAE,OAAO,iBAAiB,CAAC,KAAK,CAAC;CACtC,CAEF,SAAQ,iBAAiB,CAAC,CAAC,EAAE,YAAY,CACzC,YAAW,kBAAkB,CAAC,oBAAoB,CAAC,EAAE,WAAW;IAEhE,UAAmB,aAAa,eAAuB;IACvD,UAAmB,OAAO,oCAAyB;IAEnD,gBAAgC,KAAK;;MAE1B;IAEX,OAAO,CAAC,IAAI,CAAwB;IACpC,IAAW,GAAG,IAAI,SAAS,CAK1B;IAEqB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAqB3C,OAAO,CAAC,QAAQ,CAAmC;IAEtC,UAAU,IAAI,OAAO,CAAC,oBAAoB,CAAC;CAMxD"}

package/esm/baseCommand.js

@@ -3,7 +3,8 @@ import { createConsolaLogger } from "@tylerbu/cli-api/loggers/consola";
 import { findGitRootSync } from "@tylerbu/fundamentals/git";
 import { simpleGit } from "simple-git";
 import { DefaultPolicyConfig } from "./config.js";
-import { makePolicy } from "./makePolicy.js";
+import { createExcludedPolicyFileMap, exclusionRegex, } from "./context.js";
+import { identifyPolicyInstances, makePolicy } from "./makePolicy.js";
 import { newPerfStats } from "./perf.js";
 import { DefaultPolicies } from "./policy.js";
 /**
@@ -24,19 +25,15 @@ export class BaseRepopoCommand extends CommandWithConfig {
     }
     async init() {
         await super.init();
-        const excludeFiles = this.commandConfig?.excludeFiles?.map((e) => new RegExp(e, "i")) ?? [];
-        const excludePoliciesForFiles = new Map();
-        for (const policy of this.commandConfig?.policies ?? []) {
-            const regexes = policy.excludeFiles?.map((e) => new RegExp(e, "i")) ?? [];
-            excludePoliciesForFiles.set(policy.name, regexes);
-        }
+        const excludeFiles = this.commandConfig?.excludeFiles?.map(exclusionRegex) ?? [];
+        const policies = identifyPolicyInstances(this.commandConfig?.policies ??
+            DefaultPolicies.map((configuredPolicy) => makePolicy(configuredPolicy)));
         const gitRoot = findGitRootSync();
         this._git = simpleGit({ baseDir: gitRoot });
         this._context = {
             excludeFromAll: excludeFiles,
-            policies: this.commandConfig?.policies ??
-                DefaultPolicies.map((p) => makePolicy(p)),
-            excludePoliciesForFiles,
+            policies,
+            excludePoliciesForFiles: createExcludedPolicyFileMap(policies),
             gitRoot,
             perfStats: newPerfStats(),
         };

package/esm/baseCommand.js.map

@@ -1 +1 @@
-{"version":3,"file":"baseCommand.js","sourceRoot":"","sources":["../src/baseCommand.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,iBAAiB,GAGjB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AACvE,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAC5D,OAAO,EAAkB,SAAS,EAAE,MAAM,YAAY,CAAC;AACvD,OAAO,EAAE,mBAAmB,EAAqB,MAAM,aAAa,CAAC;AAErE,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAE9C;;GAEG;AACH,MAAM,OAAgB,iBAMrB,SAAQ,iBAAkC;IAGvB,aAAa,GAAG,mBAAmB,CAAC;IACpC,OAAO,GAAG,mBAAmB,EAAE,CAAC;IAE5C,MAAM,CAAmB,KAAK,GAAG;QACvC,GAAG,iBAAiB,CAAC,KAAK;KACjB,CAAC;IAEH,IAAI,CAAwB;IACpC,IAAW,GAAG;QACb,IAAI,IAAI,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;YAC7B,MAAM,IAAI,KAAK,CAAC,2BAA2B,CAAC,CAAC;QAC9C,CAAC;QACD,OAAO,IAAI,CAAC,IAAI,CAAC;IAClB,CAAC;IAEe,KAAK,CAAC,IAAI;QACzB,MAAM,KAAK,CAAC,IAAI,EAAE,CAAC;QAEnB,MAAM,YAAY,GACjB,IAAI,CAAC,aAAa,EAAE,YAAY,EAAE,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,MAAM,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;QAExE,MAAM,uBAAuB,GAA0B,IAAI,GAAG,EAAE,CAAC;QACjE,KAAK,MAAM,MAAM,IAAI,IAAI,CAAC,aAAa,EAAE,QAAQ,IAAI,EAAE,EAAE,CAAC;YACzD,MAAM,OAAO,GAAG,MAAM,CAAC,YAAY,EAAE,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,MAAM,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;YAC1E,uBAAuB,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QACnD,CAAC;QAED,MAAM,OAAO,GAAG,eAAe,EAAE,CAAC;QAClC,IAAI,CAAC,IAAI,GAAG,SAAS,CAAC,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC,CAAC;QAC5C,IAAI,CAAC,QAAQ,GAAG;YACf,cAAc,EAAE,YAAY;YAC5B,QAAQ,EACP,IAAI,CAAC,aAAa,EAAE,QAAQ;gBAC5B,eAAe,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;YAC1C,uBAAuB;YACvB,OAAO;YACP,SAAS,EAAE,YAAY,EAAE;SACzB,CAAC;IACH,CAAC;IAEO,QAAQ,CAAmC;IAE5C,KAAK,CAAC,UAAU;QACtB,IAAI,IAAI,CAAC,QAAQ,KAAK,SAAS,EAAE,CAAC;YACjC,MAAM,IAAI,KAAK,CAAC,0BAA0B,CAAC,CAAC;QAC7C,CAAC;QACD,OAAO,IAAI,CAAC,QAAQ,CAAC;IACtB,CAAC","sourcesContent":["import {\n\tCommandWithConfig,\n\ttype CommandWithContext,\n\ttype RequiresGit,\n} from \"@tylerbu/cli-api\";\nimport { createConsolaLogger } from \"@tylerbu/cli-api/loggers/consola\";\nimport { findGitRootSync } from \"@tylerbu/fundamentals/git\";\nimport { type SimpleGit, simpleGit } from \"simple-git\";\nimport { DefaultPolicyConfig, type RepopoConfig } from \"./config.js\";\nimport type { ExcludedPolicyFileMap, RepopoCommandContext } from \"./context.js\";\nimport { makePolicy } from \"./makePolicy.js\";\nimport { newPerfStats } from \"./perf.js\";\nimport { DefaultPolicies } from \"./policy.js\";\n\n/**\n * This class is the base for all repopo commands. It contains common flags and config loading.\n */\nexport abstract class BaseRepopoCommand<\n\t\tT extends typeof BaseRepopoCommand & {\n\t\t\targs: typeof CommandWithConfig.args;\n\t\t\tflags: typeof CommandWithConfig.flags;\n\t\t},\n\t>\n\textends CommandWithConfig<T, RepopoConfig>\n\timplements CommandWithContext<RepopoCommandContext>, RequiresGit\n{\n\tprotected override defaultConfig = DefaultPolicyConfig;\n\tprotected override _logger = createConsolaLogger();\n\n\tpublic static override readonly flags = {\n\t\t...CommandWithConfig.flags,\n\t} as const;\n\n\tprivate _git: SimpleGit | undefined;\n\tpublic get git(): SimpleGit {\n\t\tif (this._git === undefined) {\n\t\t\tthrow new Error(\"git property is undefined\");\n\t\t}\n\t\treturn this._git;\n\t}\n\n\tpublic override async init(): Promise<void> {\n\t\tawait super.init();\n\n\t\tconst excludeFiles: RegExp[] =\n\t\t\tthis.commandConfig?.excludeFiles?.map((e) => new RegExp(e, \"i\")) ?? [];\n\n\t\tconst excludePoliciesForFiles: ExcludedPolicyFileMap = new Map();\n\t\tfor (const policy of this.commandConfig?.policies ?? []) {\n\t\t\tconst regexes = policy.excludeFiles?.map((e) => new RegExp(e, \"i\")) ?? [];\n\t\t\texcludePoliciesForFiles.set(policy.name, regexes);\n\t\t}\n\n\t\tconst gitRoot = findGitRootSync();\n\t\tthis._git = simpleGit({ baseDir: gitRoot });\n\t\tthis._context = {\n\t\t\texcludeFromAll: excludeFiles,\n\t\t\tpolicies:\n\t\t\t\tthis.commandConfig?.policies ??\n\t\t\t\tDefaultPolicies.map((p) => makePolicy(p)),\n\t\t\texcludePoliciesForFiles,\n\t\t\tgitRoot,\n\t\t\tperfStats: newPerfStats(),\n\t\t};\n\t}\n\n\tprivate _context: RepopoCommandContext | undefined;\n\n\tpublic async getContext(): Promise<RepopoCommandContext> {\n\t\tif (this._context === undefined) {\n\t\t\tthrow new Error(\"Context not initialized.\");\n\t\t}\n\t\treturn this._context;\n\t}\n}\n"]}
+{"version":3,"file":"baseCommand.js","sourceRoot":"","sources":["../src/baseCommand.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,iBAAiB,GAGjB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AACvE,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAC5D,OAAO,EAAkB,SAAS,EAAE,MAAM,YAAY,CAAC;AACvD,OAAO,EAAE,mBAAmB,EAAqB,MAAM,aAAa,CAAC;AACrE,OAAO,EACN,2BAA2B,EAC3B,cAAc,GAEd,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,uBAAuB,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AACtE,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAE9C;;GAEG;AACH,MAAM,OAAgB,iBAMrB,SAAQ,iBAAkC;IAGvB,aAAa,GAAG,mBAAmB,CAAC;IACpC,OAAO,GAAG,mBAAmB,EAAE,CAAC;IAE5C,MAAM,CAAmB,KAAK,GAAG;QACvC,GAAG,iBAAiB,CAAC,KAAK;KACjB,CAAC;IAEH,IAAI,CAAwB;IACpC,IAAW,GAAG;QACb,IAAI,IAAI,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;YAC7B,MAAM,IAAI,KAAK,CAAC,2BAA2B,CAAC,CAAC;QAC9C,CAAC;QACD,OAAO,IAAI,CAAC,IAAI,CAAC;IAClB,CAAC;IAEe,KAAK,CAAC,IAAI;QACzB,MAAM,KAAK,CAAC,IAAI,EAAE,CAAC;QAEnB,MAAM,YAAY,GACjB,IAAI,CAAC,aAAa,EAAE,YAAY,EAAE,GAAG,CAAC,cAAc,CAAC,IAAI,EAAE,CAAC;QAE7D,MAAM,QAAQ,GAAG,uBAAuB,CACvC,IAAI,CAAC,aAAa,EAAE,QAAQ;YAC3B,eAAe,CAAC,GAAG,CAAC,CAAC,gBAAgB,EAAE,EAAE,CAAC,UAAU,CAAC,gBAAgB,CAAC,CAAC,CACxE,CAAC;QACF,MAAM,OAAO,GAAG,eAAe,EAAE,CAAC;QAClC,IAAI,CAAC,IAAI,GAAG,SAAS,CAAC,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC,CAAC;QAC5C,IAAI,CAAC,QAAQ,GAAG;YACf,cAAc,EAAE,YAAY;YAC5B,QAAQ;YACR,uBAAuB,EAAE,2BAA2B,CAAC,QAAQ,CAAC;YAC9D,OAAO;YACP,SAAS,EAAE,YAAY,EAAE;SACzB,CAAC;IACH,CAAC;IAEO,QAAQ,CAAmC;IAE5C,KAAK,CAAC,UAAU;QACtB,IAAI,IAAI,CAAC,QAAQ,KAAK,SAAS,EAAE,CAAC;YACjC,MAAM,IAAI,KAAK,CAAC,0BAA0B,CAAC,CAAC;QAC7C,CAAC;QACD,OAAO,IAAI,CAAC,QAAQ,CAAC;IACtB,CAAC","sourcesContent":["import {\n\tCommandWithConfig,\n\ttype CommandWithContext,\n\ttype RequiresGit,\n} from \"@tylerbu/cli-api\";\nimport { createConsolaLogger } from \"@tylerbu/cli-api/loggers/consola\";\nimport { findGitRootSync } from \"@tylerbu/fundamentals/git\";\nimport { type SimpleGit, simpleGit } from \"simple-git\";\nimport { DefaultPolicyConfig, type RepopoConfig } from \"./config.js\";\nimport {\n\tcreateExcludedPolicyFileMap,\n\texclusionRegex,\n\ttype RepopoCommandContext,\n} from \"./context.js\";\nimport { identifyPolicyInstances, makePolicy } from \"./makePolicy.js\";\nimport { newPerfStats } from \"./perf.js\";\nimport { DefaultPolicies } from \"./policy.js\";\n\n/**\n * This class is the base for all repopo commands. It contains common flags and config loading.\n */\nexport abstract class BaseRepopoCommand<\n\t\tT extends typeof BaseRepopoCommand & {\n\t\t\targs: typeof CommandWithConfig.args;\n\t\t\tflags: typeof CommandWithConfig.flags;\n\t\t},\n\t>\n\textends CommandWithConfig<T, RepopoConfig>\n\timplements CommandWithContext<RepopoCommandContext>, RequiresGit\n{\n\tprotected override defaultConfig = DefaultPolicyConfig;\n\tprotected override _logger = createConsolaLogger();\n\n\tpublic static override readonly flags = {\n\t\t...CommandWithConfig.flags,\n\t} as const;\n\n\tprivate _git: SimpleGit | undefined;\n\tpublic get git(): SimpleGit {\n\t\tif (this._git === undefined) {\n\t\t\tthrow new Error(\"git property is undefined\");\n\t\t}\n\t\treturn this._git;\n\t}\n\n\tpublic override async init(): Promise<void> {\n\t\tawait super.init();\n\n\t\tconst excludeFiles: RegExp[] =\n\t\t\tthis.commandConfig?.excludeFiles?.map(exclusionRegex) ?? [];\n\n\t\tconst policies = identifyPolicyInstances(\n\t\t\tthis.commandConfig?.policies ??\n\t\t\t\tDefaultPolicies.map((configuredPolicy) => makePolicy(configuredPolicy)),\n\t\t);\n\t\tconst gitRoot = findGitRootSync();\n\t\tthis._git = simpleGit({ baseDir: gitRoot });\n\t\tthis._context = {\n\t\t\texcludeFromAll: excludeFiles,\n\t\t\tpolicies,\n\t\t\texcludePoliciesForFiles: createExcludedPolicyFileMap(policies),\n\t\t\tgitRoot,\n\t\t\tperfStats: newPerfStats(),\n\t\t};\n\t}\n\n\tprivate _context: RepopoCommandContext | undefined;\n\n\tpublic async getContext(): Promise<RepopoCommandContext> {\n\t\tif (this._context === undefined) {\n\t\t\tthrow new Error(\"Context not initialized.\");\n\t\t}\n\t\treturn this._context;\n\t}\n}\n"]}

package/esm/commands/check-native.d.ts

@@ -0,0 +1,25 @@
+import { Command } from "@oclif/core";
+/**
+ * Runs the Rust-based repopo-core engine with the Node.js sidecar for
+ * per-policy execution. Rust owns matching, ordering, concurrency, exception
+ * boundaries, repository scheduling and aggregation.
+ */
+export declare class CheckNative extends Command {
+    static readonly summary = "Checks and applies policies using the Rust engine.";
+    static readonly description: string;
+    static readonly flags: {
+        readonly concurrency: import("@oclif/core/interfaces").OptionFlag<number, import("@oclif/core/interfaces").CustomOptions>;
+        readonly fix: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        readonly stdin: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        readonly verbose: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        readonly quiet: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        readonly config: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        readonly "sidecar-path": import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        readonly "binary-path": import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        readonly runtime: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    run(): Promise<void>;
+    private resolveBinaryPath;
+    private resolveSidecarPath;
+}
+//# sourceMappingURL=check-native.d.ts.map

package/esm/commands/check-native.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"check-native.d.ts","sourceRoot":"","sources":["../../src/commands/check-native.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,OAAO,EAAS,MAAM,aAAa,CAAC;AAM7C;;;;GAIG;AACH,qBAAa,WAAY,SAAQ,OAAO;IACvC,gBAAgC,OAAO,wDACe;IAEtD,gBAAgC,WAAW,SAIsC;IAEjF,gBAAgC,KAAK;;;;;;;;;;MAgD1B;IAEW,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;IAkE1C,OAAO,CAAC,iBAAiB;IAiDzB,OAAO,CAAC,kBAAkB;CAQ1B"}

package/esm/commands/check-native.js

@@ -0,0 +1,156 @@
+import { spawn } from "node:child_process";
+import { existsSync } from "node:fs";
+import { fileURLToPath } from "node:url";
+import { Command, Flags } from "@oclif/core";
+import { dirname, resolve } from "pathe";
+import { DEFAULT_CONCURRENCY, validateConcurrency } from "../concurrency.js";
+const __dirname = dirname(fileURLToPath(import.meta.url));
+/**
+ * Runs the Rust-based repopo-core engine with the Node.js sidecar for
+ * per-policy execution. Rust owns matching, ordering, concurrency, exception
+ * boundaries, repository scheduling and aggregation.
+ */
+export class CheckNative extends Command {
+    static summary = "Checks and applies policies using the Rust engine.";
+    static description = "Runs the Rust-based repopo-core engine with the Node.js sidecar. " +
+        "Rust handles file matching, scheduling and reporting; the sidecar shares per-policy contracts with 'check'. " +
+        "Repository policies always run with the full repository inventory, including with --stdin. " +
+        "With --fix, repository policies can modify files outside the stdin selection.";
+    static flags = {
+        concurrency: Flags.integer({
+            description: "Maximum concurrent files in read-only checks. Fixes remain sequential.",
+            default: DEFAULT_CONCURRENCY,
+            parse: async (value) => validateConcurrency(Number(value)),
+        }),
+        fix: Flags.boolean({
+            aliases: ["resolve"],
+            description: "Fix errors if possible.",
+            required: false,
+            char: "f",
+        }),
+        stdin: Flags.boolean({
+            description: "Read list of files from stdin.",
+            required: false,
+        }),
+        verbose: Flags.boolean({
+            description: "Show verbose output including per-policy timing.",
+            required: false,
+            char: "v",
+        }),
+        quiet: Flags.boolean({
+            description: "Suppress all output except errors.",
+            required: false,
+            char: "q",
+        }),
+        config: Flags.string({
+            description: "Path to the config file.",
+            required: false,
+            char: "c",
+        }),
+        "sidecar-path": Flags.string({
+            description: "Path to the Node.js sidecar script.",
+            required: false,
+            env: "REPOPO_SIDECAR_PATH",
+        }),
+        "binary-path": Flags.string({
+            description: "Path to the repopo-core Rust binary.",
+            required: false,
+            env: "REPOPO_CORE_PATH",
+        }),
+        runtime: Flags.string({
+            description: "JS runtime for the sidecar process (auto, node, bun).",
+            required: false,
+            env: "REPOPO_RUNTIME",
+            options: ["auto", "node", "bun"],
+        }),
+    };
+    async run() {
+        const { flags } = await this.parse(CheckNative);
+        const binaryPath = this.resolveBinaryPath(flags["binary-path"]);
+        const sidecarPath = this.resolveSidecarPath(flags["sidecar-path"]);
+        const args = ["check", "--sidecar-path", sidecarPath];
+        args.push("--concurrency", String(flags.concurrency));
+        if (flags.fix) {
+            args.push("--fix");
+        }
+        if (flags.stdin) {
+            args.push("--stdin");
+        }
+        if (flags.verbose) {
+            args.push("--verbose");
+        }
+        if (flags.quiet) {
+            args.push("--quiet");
+        }
+        if (flags.config) {
+            args.push("--config", flags.config);
+        }
+        if (flags.runtime) {
+            args.push("--runtime", flags.runtime);
+        }
+        return new Promise((resolvePromise, reject) => {
+            const child = spawn(binaryPath, args, {
+                stdio: "inherit",
+                // biome-ignore lint/style/noProcessEnv: Need to pass parent environment to child process
+                env: { ...process.env },
+            });
+            const interrupt = () => child.kill("SIGINT");
+            const terminate = () => child.kill("SIGTERM");
+            const cleanup = () => {
+                process.removeListener("SIGINT", interrupt);
+                process.removeListener("SIGTERM", terminate);
+            };
+            process.on("SIGINT", interrupt);
+            process.on("SIGTERM", terminate);
+            child.on("error", (err) => {
+                cleanup();
+                reject(new Error(`Failed to spawn repopo-core: ${err.message}\n` +
+                    `Binary path: ${binaryPath}\n` +
+                    "Make sure the Rust binary has been built: cargo build --manifest-path crates/core/Cargo.toml"));
+            });
+            child.on("close", (code, signal) => {
+                cleanup();
+                if (code !== 0) {
+                    process.exitCode =
+                        code ??
+                            (signal === "SIGINT" ? 130 : signal === "SIGTERM" ? 143 : 1);
+                }
+                resolvePromise();
+            });
+        });
+    }
+    resolveBinaryPath(explicit) {
+        if (explicit) {
+            return explicit;
+        }
+        const packageRoot = resolve(__dirname, "..", "..");
+        const binaryName = process.platform === "win32" ? "repopo-core.exe" : "repopo-core";
+        // Check paths in priority order:
+        // 1. Postinstall-downloaded binary (npm install)
+        const nativePath = resolve(packageRoot, "native", binaryName);
+        if (existsSync(nativePath)) {
+            return nativePath;
+        }
+        // 2. Local release build (cargo build --release)
+        const releasePath = resolve(packageRoot, "crates", "core", "target", "release", binaryName);
+        if (existsSync(releasePath)) {
+            return releasePath;
+        }
+        // 3. Local debug build (cargo build)
+        const debugPath = resolve(packageRoot, "crates", "core", "target", "debug", binaryName);
+        if (existsSync(debugPath)) {
+            return debugPath;
+        }
+        throw new Error("repopo-core binary not found. Either:\n" +
+            "  - Install the package (npm install repopo) to download pre-built binaries\n" +
+            "  - Build from source: cargo build --manifest-path crates/core/Cargo.toml");
+    }
+    resolveSidecarPath(explicit) {
+        if (explicit) {
+            return explicit;
+        }
+        const packageRoot = resolve(__dirname, "..", "..");
+        return resolve(packageRoot, "sidecar", "sidecar.mjs");
+    }
+}
+//# sourceMappingURL=check-native.js.map