@aspruyt/xfg 5.1.2 → 5.1.4

package/README.md

@@ -2,6 +2,7 @@
 
 [![CI](https://github.com/anthony-spruyt/xfg/actions/workflows/ci.yaml/badge.svg?branch=main)](https://github.com/anthony-spruyt/xfg/actions/workflows/ci.yaml)
 [![codecov](https://codecov.io/gh/anthony-spruyt/xfg/graph/badge.svg)](https://codecov.io/gh/anthony-spruyt/xfg)
+[![Socket Badge](https://badge.socket.dev/npm/package/@aspruyt/xfg)](https://socket.dev/npm/package/@aspruyt/xfg)
 [![npm version](https://img.shields.io/npm/v/@aspruyt/xfg.svg)](https://www.npmjs.com/package/@aspruyt/xfg)
 [![npm downloads](https://img.shields.io/npm/dw/@aspruyt/xfg.svg)](https://www.npmjs.com/package/@aspruyt/xfg)
 [![GitHub Marketplace](https://img.shields.io/badge/Marketplace-xfg-blue?logo=github)](https://github.com/marketplace/actions/xfg-repo-as-code)

package/dist/cli/lifecycle-report-builder.d.ts

@@ -0,0 +1,2 @@
+import type { LifecycleReport, LifecycleAction } from "../output/lifecycle-report.js";
+export declare function buildLifecycleReport(results: LifecycleAction[]): LifecycleReport;

package/dist/cli/lifecycle-report-builder.js

@@ -0,0 +1,15 @@
+export function buildLifecycleReport(results) {
+    const actions = [];
+    const totals = { created: 0, forked: 0, migrated: 0, existed: 0 };
+    for (const result of results) {
+        actions.push({
+            repoName: result.repoName,
+            action: result.action,
+            upstream: result.upstream,
+            source: result.source,
+            settings: result.settings,
+        });
+        totals[result.action]++;
+    }
+    return { actions, totals };
+}

package/dist/cli/program.js

@@ -6,12 +6,14 @@ import { ValidationError } from "../shared/errors.js";
 import { runSync } from "./sync-command.js";
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = dirname(__filename);
-let packageJson;
-try {
-    packageJson = JSON.parse(readFileSync(join(__dirname, "../..", "package.json"), "utf-8"));
-}
-catch {
-    packageJson = { version: "0.0.0" };
+function getVersion() {
+    try {
+        const pkg = JSON.parse(readFileSync(join(__dirname, "../..", "package.json"), "utf-8"));
+        return pkg.version;
+    }
+    catch {
+        return "0.0.0";
+    }
 }
 // =============================================================================
 // Shared CLI Options
@@ -50,7 +52,7 @@ export function parseMergeStrategy(value) {
 program
     .name("xfg")
     .description("Manage files, settings, and repositories across GitHub, Azure DevOps, and GitLab")
-    .version(packageJson.version);
+    .version(getVersion());
 // Sync command (file synchronization)
 const syncCommand = new Command("sync")
     .description("Sync configuration files across repositories")
@@ -58,11 +60,14 @@ const syncCommand = new Command("sync")
     .option("-m, --merge <mode>", "PR merge mode: manual, auto (default, merge when checks pass), force (bypass requirements), direct (push to default branch, no PR)", parseMergeMode)
     .option("--merge-strategy <strategy>", "Merge strategy: merge, squash (default), rebase", parseMergeStrategy)
     .option("--delete-branch", "Delete source branch after merge")
-    .action((opts) => {
-    runSync(opts).catch((error) => {
+    .action(async (opts) => {
+    try {
+        await runSync(opts);
+    }
+    catch (error) {
         console.error("Fatal error:", error);
-        process.exit(1);
-    });
+        return process.exit(1);
+    }
 });
 addSharedOptions(syncCommand);
 program.addCommand(syncCommand);

package/dist/cli/settings-report-builder.d.ts

@@ -1,5 +1,5 @@
 import type { SettingsReport } from "../output/settings-report.js";
-import type { RepoSettingsPlanEntry, RulesetPlanEntry, LabelsPlanEntry } from "../settings/index.js";
+import { type RepoSettingsPlanEntry, type RulesetPlanEntry, type LabelsPlanEntry } from "../settings/index.js";
 /**
  * Result from processing a repository's settings and rulesets.
  * Used to collect results during settings command execution.

package/dist/cli/settings-report-builder.js

@@ -1,3 +1,4 @@
+import { countActions, isActiveAction, } from "../settings/index.js";
 export function buildSettingsReport(results) {
     const repos = [];
     const totals = {
@@ -19,64 +20,51 @@ export function buildSettingsReport(results) {
                 if (entry.oldValue === undefined && entry.newValue === undefined) {
                     continue;
                 }
-                const settingChange = {
+                repoChanges.settings.push({
                     name: entry.property,
                     action: entry.action,
                     oldValue: entry.oldValue,
                     newValue: entry.newValue,
-                };
-                repoChanges.settings.push(settingChange);
-                if (entry.action === "create") {
-                    totals.settings.create++;
-                }
-                else {
-                    totals.settings.update++;
-                }
+                });
             }
+            const counts = countActions(repoChanges.settings);
+            totals.settings.create += counts.create;
+            totals.settings.update += counts.update;
         }
         // Convert ruleset processor output
         if (result.rulesetResult?.planOutput?.entries) {
             for (const entry of result.rulesetResult.planOutput.entries) {
-                if (entry.action === "unchanged")
+                if (!isActiveAction(entry))
                     continue;
-                const rulesetChange = {
+                repoChanges.rulesets.push({
                     name: entry.name,
                     action: entry.action,
                     propertyDiffs: entry.propertyDiffs,
                     config: entry.config,
-                };
-                repoChanges.rulesets.push(rulesetChange);
-                if (entry.action === "create") {
-                    totals.rulesets.create++;
-                }
-                else if (entry.action === "update") {
-                    totals.rulesets.update++;
-                }
-                else if (entry.action === "delete") {
-                    totals.rulesets.delete++;
-                }
+                });
             }
+            const counts = countActions(repoChanges.rulesets);
+            totals.rulesets.create += counts.create;
+            totals.rulesets.update += counts.update;
+            totals.rulesets.delete += counts.delete;
         }
         // Convert labels processor output
         if (result.labelsResult?.planOutput?.entries) {
             for (const entry of result.labelsResult.planOutput.entries) {
-                if (entry.action === "unchanged")
+                if (!isActiveAction(entry))
                     continue;
-                const labelChange = {
+                repoChanges.labels.push({
                     name: entry.name,
                     action: entry.action,
                     newName: entry.newName,
                     propertyChanges: entry.propertyChanges,
                     config: entry.config,
-                };
-                repoChanges.labels.push(labelChange);
-                if (entry.action === "create")
-                    totals.labels.create++;
-                else if (entry.action === "update")
-                    totals.labels.update++;
-                else if (entry.action === "delete")
-                    totals.labels.delete++;
+                });
             }
+            const counts = countActions(repoChanges.labels);
+            totals.labels.create += counts.create;
+            totals.labels.update += counts.update;
+            totals.labels.delete += counts.delete;
         }
         if (result.error) {
             repoChanges.error = result.error;

package/dist/cli/sync-command.js

@@ -1,8 +1,7 @@
 import { resolve, join } from "node:path";
 import { existsSync } from "node:fs";
-import { loadRawConfig, normalizeConfig } from "../config/index.js";
+import { loadRawConfig, normalizeConfig, validateForSync, } from "../config/index.js";
 import { ValidationError, SyncError } from "../shared/errors.js";
-import { validateForSync } from "../config/validator.js";
 import { parseGitUrl, getRepoDisplayName, isGitHubRepo, } from "../shared/repo-detector.js";
 import { sanitizeBranchName, validateBranchName, } from "../shared/branch-utils.js";
 import { createTokenManager } from "../vcs/index.js";
@@ -32,18 +31,16 @@ function createDefaultLabelsProcessorFactory() {
     return () => new LabelsProcessor(new GitHubLabelsStrategy(getDefaultExecutor(), { cwd }));
 }
 import { ResultsCollector } from "./results-collector.js";
-import { buildSettingsReport } from "./settings-report-builder.js";
+import { buildSettingsReport, } from "./settings-report-builder.js";
 import { formatSettingsReportCLI } from "../output/settings-report.js";
 import { buildSyncReport } from "./sync-report-builder.js";
 import { formatSyncReportCLI } from "../output/sync-report.js";
-import { buildLifecycleReport, formatLifecycleReportCLI, hasLifecycleChanges, } from "../output/lifecycle-report.js";
+import { buildLifecycleReport } from "./lifecycle-report-builder.js";
+import { formatLifecycleReportCLI, hasLifecycleChanges, } from "../output/lifecycle-report.js";
 import { writeUnifiedSummary } from "../output/unified-summary.js";
 import { toErrorMessage } from "../shared/type-guards.js";
 import { resolveGitHubToken } from "../shared/gh-api-utils.js";
 import { RepoLifecycleManager, runLifecycleCheck, toCreateRepoSettings, } from "../lifecycle/index.js";
-/**
- * Get unique file names from all repos in the config
- */
 function getUniqueFileNames(config) {
     const fileNames = new Set();
     for (const repo of config.repos) {
@@ -53,18 +50,12 @@ function getUniqueFileNames(config) {
     }
     return Array.from(fileNames);
 }
-/**
- * Generate default branch name based on files being synced
- */
 function generateBranchName(fileNames) {
     if (fileNames.length === 1) {
         return `chore/sync-${sanitizeBranchName(fileNames[0])}`;
     }
     return "chore/sync-config";
 }
-/**
- * Format file names for display
- */
 function formatFileNames(fileNames) {
     if (fileNames.length === 1) {
         return fileNames[0];
@@ -85,7 +76,7 @@ function determineMergeOutcome(result) {
         return "auto";
     return "manual";
 }
-function logSettingsResult(result, label, current, repoName, settingsCollector) {
+function logSettingsResult(result, label, repoNumber, repoName, settingsCollector) {
     if (result.planOutput?.lines?.length) {
         getLogger().info("");
         getLogger().info(`${repoName} - ${label}:`);
@@ -99,70 +90,74 @@ function logSettingsResult(result, label, current, repoName, settingsCollector)
         }
     }
     else if (!result.skipped && result.success) {
-        getLogger().success(current, repoName, `${label}: ${result.message}`);
+        getLogger().success(repoNumber, repoName, `${label}: ${result.message}`);
     }
     if (!result.success && !result.skipped) {
-        getLogger().error(current, repoName, `${label}: ${result.message}`);
+        getLogger().error(repoNumber, repoName, `${label}: ${result.message}`);
         settingsCollector.appendError(repoName, result.message);
     }
 }
-async function applyRepoSettings(ctx) {
-    const { repoConfig, repoInfo, repoName, current, options, token, settingsCollector, rulesetProcessorFactory, repoSettingsProcessorFactory, labelsProcessorFactory, } = ctx;
-    if (!repoConfig.settings || !isGitHubRepo(repoInfo))
-        return;
-    const settingsDescriptors = [
+function buildSettingsDescriptors(ctx) {
+    const { repoConfig, repoInfo, options, token, repoName, settingsCollector, rulesetProcessorFactory, repoSettingsProcessorFactory, labelsProcessorFactory, } = ctx;
+    const sharedOpts = {
+        dryRun: options.dryRun,
+        noDelete: options.noDelete,
+        token,
+    };
+    // Each processor returns a subtype of BaseProcessorResult whose planOutput
+    // contains both `lines` (for CLI display) and `entries` (for report building).
+    // ProcessorResults fields capture only the `entries` slice; the runtime object
+    // satisfies both views, so we assign with an explicit per-field cast.
+    const runAndStore = async (factory, opts, assign) => {
+        const result = await runSettingsProcessor(factory, repoConfig, repoInfo, opts);
+        if (!result.skipped) {
+            assign(settingsCollector.getOrCreate(repoName), result);
+        }
+        return result;
+    };
+    return [
         {
             key: "rulesets",
             label: "Rulesets",
-            run: async () => {
-                const result = await rulesetProcessorFactory().process(repoConfig, repoInfo, {
-                    dryRun: options.dryRun,
-                    noDelete: options.noDelete,
-                    token,
-                });
-                if (!result.skipped) {
-                    settingsCollector.getOrCreate(repoName).rulesetResult = result;
-                }
-                return result;
-            },
+            run: () => runAndStore(rulesetProcessorFactory, sharedOpts, (e, r) => {
+                e.rulesetResult = r;
+            }),
         },
         {
             key: "labels",
             label: "Labels",
-            run: async () => {
-                const result = await labelsProcessorFactory().process(repoConfig, repoInfo, {
-                    dryRun: options.dryRun,
-                    noDelete: options.noDelete,
-                    token,
-                });
-                if (!result.skipped) {
-                    settingsCollector.getOrCreate(repoName).labelsResult = result;
-                }
-                return result;
-            },
+            run: () => runAndStore(labelsProcessorFactory, sharedOpts, (e, r) => {
+                e.labelsResult = r;
+            }),
         },
         {
             key: "repo",
             label: "Repo Settings",
-            run: async () => {
-                const result = await repoSettingsProcessorFactory().process(repoConfig, repoInfo, { dryRun: options.dryRun, token });
-                if (!result.skipped) {
-                    settingsCollector.getOrCreate(repoName).settingsResult = result;
-                }
-                return result;
-            },
+            run: () => runAndStore(repoSettingsProcessorFactory, { dryRun: options.dryRun, token }, (e, r) => {
+                e.settingsResult = r;
+            }),
         },
     ];
-    for (const desc of settingsDescriptors) {
+}
+function runSettingsProcessor(factory, repoConfig, repoInfo, processOptions) {
+    return factory()
+        .process(repoConfig, repoInfo, processOptions)
+        .then((result) => result);
+}
+async function applyRepoSettings(ctx) {
+    const { repoConfig, repoInfo, repoName, repoNumber, settingsCollector } = ctx;
+    if (!repoConfig.settings || !isGitHubRepo(repoInfo))
+        return;
+    for (const desc of buildSettingsDescriptors(ctx)) {
         const settingsValue = repoConfig.settings[desc.key];
         if (!settingsValue || Object.keys(settingsValue).length === 0)
             continue;
         try {
             const result = await desc.run();
-            logSettingsResult(result, desc.label, current, repoName, settingsCollector);
+            logSettingsResult(result, desc.label, repoNumber, repoName, settingsCollector);
         }
         catch (error) {
-            getLogger().error(current, repoName, `${desc.label}: ${toErrorMessage(error)}`);
+            getLogger().error(repoNumber, repoName, `${desc.label}: ${toErrorMessage(error)}`);
             settingsCollector.appendError(repoName, error);
         }
     }
@@ -208,7 +203,7 @@ function displayReports(reportResults, lifecycleReportInputs, settingsCollector,
  */
 async function processSingleRepo(repoConfig, index, ctx) {
     const { config, options } = ctx;
-    const current = index + 1;
+    const repoNumber = index + 1;
     // Apply CLI-level PR option overrides
     if (options.merge || options.mergeStrategy || options.deleteBranch) {
         repoConfig.prOptions = {
@@ -229,7 +224,7 @@ async function processSingleRepo(repoConfig, index, ctx) {
         });
     }
     catch (error) {
-        getLogger().error(current, repoConfig.git, toErrorMessage(error));
+        getLogger().error(repoNumber, repoConfig.git, toErrorMessage(error));
         ctx.reportResults.push({
             repoName: repoConfig.git,
             success: false,
@@ -267,7 +262,7 @@ async function processSingleRepo(repoConfig, index, ctx) {
         repoConfig,
         repoInfo,
         repoName,
-        current,
+        repoNumber,
         options,
         token: repoToken,
         settingsCollector: ctx.settingsCollector,
@@ -281,7 +276,7 @@ async function processSingleRepo(repoConfig, index, ctx) {
  * Returns true if the main loop should skip file sync for this repo.
  */
 async function runLifecyclePhase(repo, ctx) {
-    const current = repo.index + 1;
+    const repoNumber = repo.index + 1;
     try {
         const { outputLines, lifecycleResult } = await runLifecycleCheck(repo.repoConfig, repo.repoInfo, {
             dryRun: ctx.options.dryRun ?? false,
@@ -320,7 +315,7 @@ async function runLifecyclePhase(repo, ctx) {
         return false;
     }
     catch (error) {
-        getLogger().error(current, repo.repoName, `Lifecycle error: ${toErrorMessage(error)}`);
+        getLogger().error(repoNumber, repo.repoName, `Lifecycle error: ${toErrorMessage(error)}`);
         ctx.reportResults.push({
             repoName: repo.repoName,
             success: false,
@@ -334,9 +329,9 @@ async function runLifecyclePhase(repo, ctx) {
  * Run the file sync processor for a single repo and collect results.
  */
 async function runFileSyncPhase(repo, ctx) {
-    const current = repo.index + 1;
+    const repoNumber = repo.index + 1;
     try {
-        getLogger().progress(current, repo.repoName, "Processing...");
+        getLogger().progress(repoNumber, repo.repoName, "Processing...");
         const result = await ctx.processor.process(repo.repoConfig, repo.repoInfo, {
             branchName: ctx.branchName,
             workDir: repo.workDir,
@@ -363,17 +358,17 @@ async function runFileSyncPhase(repo, ctx) {
             error: result.success ? undefined : result.message,
         });
         if (result.skipped) {
-            getLogger().skip(current, repo.repoName, result.message);
+            getLogger().skip(repoNumber, repo.repoName, result.message);
         }
         else if (result.success) {
-            getLogger().success(current, repo.repoName, result.message);
+            getLogger().success(repoNumber, repo.repoName, result.message);
         }
         else {
-            getLogger().error(current, repo.repoName, result.message);
+            getLogger().error(repoNumber, repo.repoName, result.message);
         }
     }
     catch (error) {
-        getLogger().error(current, repo.repoName, toErrorMessage(error));
+        getLogger().error(repoNumber, repo.repoName, toErrorMessage(error));
         ctx.reportResults.push({
             repoName: repo.repoName,
             success: false,

package/dist/cli/types.d.ts

@@ -1,7 +1,7 @@
 import type { MergeMode, MergeStrategy, RepoConfig } from "../config/index.js";
 import type { IRepoLifecycleManager } from "../lifecycle/index.js";
 import type { IRepositoryProcessor } from "../sync/index.js";
-import type { ISettingsProcessor, IRulesetProcessor, IRepoSettingsProcessor, ILabelsProcessor } from "../settings/index.js";
+import type { ISettingsProcessor, IRulesetProcessor, IRepoSettingsProcessor, ILabelsProcessor, BaseProcessorResult } from "../settings/index.js";
 import type { RepoInfo } from "../shared/repo-detector.js";
 import type { ResultsCollector } from "./results-collector.js";
 export type ProcessorFactory = () => IRepositoryProcessor;
@@ -44,10 +44,7 @@ export interface SyncResultEntry {
     mergeOutcome?: "manual" | "auto" | "force" | "direct";
     error?: string;
 }
-export interface SettingsResult {
-    success: boolean;
-    message: string;
-    skipped?: boolean;
+export interface SettingsResult extends Pick<BaseProcessorResult, "success" | "message" | "skipped"> {
     planOutput?: {
         lines?: string[];
     };
@@ -61,7 +58,7 @@ export interface ApplyRepoSettingsContext {
     repoConfig: RepoConfig;
     repoInfo: RepoInfo;
     repoName: string;
-    current: number;
+    repoNumber: number;
     options: SyncOptions;
     token: string | undefined;
     settingsCollector: ResultsCollector;

package/dist/config/formatter.js

@@ -94,11 +94,6 @@ export function convertContentToString(content, fileName, options) {
             defaultKeyType: "PLAIN",
         });
     }
-    if (format === "json5") {
-        // JSON5 format - output standard JSON (which is valid JSON5)
-        // Using JSON.stringify for standard JSON output that's compatible everywhere
-        return JSON.stringify(content, null, 2) + "\n";
-    }
-    // JSON format - comments not supported, ignore header/schemaUrl
+    // JSON and JSON5 — both use standard JSON.stringify (valid JSON5 superset)
     return JSON.stringify(content, null, 2) + "\n";
 }

package/dist/config/index.d.ts

@@ -1,4 +1,5 @@
-export type { MergeMode, MergeStrategy, BypassActor, StatusCheckConfig, CodeScanningTool, PullRequestRuleParameters, RulesetRule, Ruleset, GitHubRepoSettings, RepoVisibility, SquashMergeCommitTitle, SquashMergeCommitMessage, MergeCommitTitle, MergeCommitMessage, Label, RepoSettings, ContentValue, RawFileConfig, RawRepoFileOverride, RawRepoSettings, RawRepoConfig, RawConfig, RepoConfig, Config, } from "./types.js";
+export type { MergeMode, MergeStrategy, BypassActor, StatusCheckConfig, CodeScanningTool, PullRequestRuleParameters, RulesetRule, Ruleset, GitHubRepoSettings, RepoVisibility, SquashMergeCommitTitle, SquashMergeCommitMessage, MergeCommitTitle, MergeCommitMessage, Label, RepoSettings, RawFileConfig, RawRepoFileOverride, RawRepoSettings, RawRepoConfig, RawConfig, RepoConfig, Config, FileContent, ContentValue, } from "./types.js";
 export { RULESET_COMPARABLE_FIELDS } from "./types.js";
 export { loadRawConfig, loadConfig, normalizeConfig } from "./loader.js";
 export { convertContentToString } from "./formatter.js";
+export { validateForSync } from "./validator.js";

package/dist/config/index.js

@@ -4,3 +4,5 @@ export { RULESET_COMPARABLE_FIELDS } from "./types.js";
 export { loadRawConfig, loadConfig, normalizeConfig } from "./loader.js";
 // Config formatting
 export { convertContentToString } from "./formatter.js";
+// Config validation
+export { validateForSync } from "./validator.js";

package/dist/config/merge.d.ts

@@ -20,13 +20,7 @@ export declare function deepMerge(base: Record<string, unknown>, overlay: Record
  * Standard $-prefixed keys ($schema, $id, $ref, etc.) are preserved.
  */
 export declare function stripMergeDirectives(obj: Record<string, unknown>): Record<string, unknown>;
-/**
- * Create a default merge context.
- */
 export declare function createMergeContext(defaultStrategy?: ArrayMergeStrategy): MergeContext;
-/**
- * Check if content is text type (string or string[]).
- */
 export declare function isTextContent(content: unknown): content is string | string[];
 /**
  * Merge two text content values.

package/dist/config/merge.js

@@ -9,18 +9,11 @@ import { isPlainObject } from "../shared/type-guards.js";
  * like $schema, $id, $ref, $generated are preserved.
  */
 const XFG_DIRECTIVES = new Set(["$arrayMerge", "$values"]);
-/**
- * Strategy map for array merge operations.
- * Extensible: add new strategies by adding to this map.
- */
 const arrayMergeStrategies = new Map([
     ["replace", (_base, overlay) => overlay],
     ["append", (base, overlay) => [...base, ...overlay]],
     ["prepend", (base, overlay) => [...overlay, ...base]],
 ]);
-/**
- * Merge two arrays based on the specified strategy.
- */
 function mergeArrays(base, overlay, strategy) {
     const handler = arrayMergeStrategies.get(strategy);
     if (handler) {
@@ -94,9 +87,6 @@ export function stripMergeDirectives(obj) {
     }
     return result;
 }
-/**
- * Create a default merge context.
- */
 export function createMergeContext(defaultStrategy = "replace") {
     return {
         defaultArrayStrategy: defaultStrategy,
@@ -105,9 +95,6 @@ export function createMergeContext(defaultStrategy = "replace") {
 // =============================================================================
 // Text Content Utilities
 // =============================================================================
-/**
- * Check if content is text type (string or string[]).
- */
 export function isTextContent(content) {
     return (typeof content === "string" ||
         (Array.isArray(content) &&

package/dist/config/types.d.ts

@@ -8,21 +8,13 @@ export interface PRMergeOptions {
     bypassReason?: string;
     labels?: string[];
 }
-/** Ruleset target type */
 export type RulesetTarget = "branch" | "tag";
-/** Ruleset enforcement level */
 export type RulesetEnforcement = "active" | "disabled" | "evaluate";
-/** Bypass actor type */
 export type BypassActorType = "Team" | "User" | "Integration";
-/** Bypass mode - always bypass or only for PRs */
 export type BypassMode = "always" | "pull_request";
-/** Pattern operator for pattern-based rules */
 type PatternOperator = "starts_with" | "ends_with" | "contains" | "regex";
-/** Allowed merge methods */
 export type MergeMethod = "merge" | "squash" | "rebase";
-/** Code scanning alerts threshold */
 export type AlertsThreshold = "none" | "errors" | "errors_and_warnings" | "all";
-/** Security alerts threshold */
 export type SecurityAlertsThreshold = "none" | "critical" | "high_or_higher" | "medium_or_higher" | "all";
 export interface BypassActor {
     actorId: number;
@@ -190,7 +182,6 @@ export interface MaxFileSizeRule {
     type: "max_file_size";
     parameters?: MaxFileSizeParameters;
 }
-/** Union of all rule types */
 export type RulesetRule = PullRequestRule | RequiredStatusChecksRule | RequiredSignaturesRule | RequiredLinearHistoryRule | NonFastForwardRule | CreationRule | UpdateRule | DeletionRule | RequiredDeploymentsRule | CodeScanningRule | CodeQualityRule | WorkflowsRule | CommitAuthorEmailPatternRule | CommitMessagePatternRule | CommitterEmailPatternRule | BranchNamePatternRule | TagNamePatternRule | FilePathRestrictionRule | FileExtensionRestrictionRule | MaxFilePathLengthRule | MaxFileSizeRule;
 /**
  * GitHub Ruleset configuration.

package/dist/config/validator.d.ts

@@ -1,7 +1,7 @@
 import type { RawConfig, RawRepoSettings, RawRootSettings } from "./types.js";
 /**
  * Validates raw config structure before normalization.
- * @throws Error if validation fails
+ * @throws ValidationError if validation fails
  */
 export declare function validateRawConfig(config: RawConfig): void;
 /**

package/dist/config/validator.js

@@ -418,7 +418,7 @@ function hasGroupFiles(config) {
 }
 /**
  * Validates raw config structure before normalization.
- * @throws Error if validation fails
+ * @throws ValidationError if validation fails
  */
 export function validateRawConfig(config) {
     validateConfigId(config);