@aspruyt/xfg 3.13.1 → 4.0.1

package/dist/cli/settings/process-rulesets.js

@@ -1,118 +0,0 @@
-import { resolve, join } from "node:path";
-import chalk from "chalk";
-import { parseGitUrl, getRepoDisplayName, isGitHubRepo, } from "../../shared/repo-detector.js";
-import { logger } from "../../shared/logger.js";
-import { generateWorkspaceName } from "../../shared/workspace-utils.js";
-import { buildErrorResult } from "../../output/summary-utils.js";
-import { getManagedRulesets, parseManifestContent, MANIFEST_FILENAME, } from "../../sync/manifest.js";
-import { defaultExecutor } from "../../shared/command-executor.js";
-import { escapeShellArg } from "../../shared/shell-utils.js";
-/**
- * Process rulesets for all configured repositories.
- */
-export async function processRulesets(repos, config, options, processor, repoProcessor, results, collector, lifecycleSkipped) {
-    for (let i = 0; i < repos.length; i++) {
-        const repoConfig = repos[i];
-        if (lifecycleSkipped.has(repoConfig.git)) {
-            continue;
-        }
-        let repoInfo;
-        try {
-            repoInfo = parseGitUrl(repoConfig.git, {
-                githubHosts: config.githubHosts,
-            });
-        }
-        catch (error) {
-            logger.error(i + 1, repoConfig.git, String(error));
-            results.push(buildErrorResult(repoConfig.git, error));
-            collector.appendError(repoConfig.git, error);
-            continue;
-        }
-        const repoName = getRepoDisplayName(repoInfo);
-        if (!isGitHubRepo(repoInfo)) {
-            logger.skip(i + 1, repoName, "GitHub Rulesets only supported for GitHub repos");
-            continue;
-        }
-        const managedRulesets = await fetchManagedRulesets(repoInfo, config.id);
-        try {
-            logger.progress(i + 1, repoName, "Processing rulesets...");
-            const result = await processor.process(repoConfig, repoInfo, {
-                configId: config.id,
-                dryRun: options.dryRun,
-                managedRulesets,
-                noDelete: options.noDelete,
-            });
-            if (result.planOutput && result.planOutput.lines.length > 0) {
-                logger.info("");
-                logger.info(chalk.bold(`${repoName} - Rulesets:`));
-                for (const line of result.planOutput.lines) {
-                    logger.info(line);
-                }
-            }
-            if (result.skipped) {
-                logger.skip(i + 1, repoName, result.message);
-            }
-            else if (result.success) {
-                logger.success(i + 1, repoName, result.message);
-                if (result.manifestUpdate &&
-                    result.manifestUpdate.rulesets.length > 0) {
-                    const workDir = resolve(join(options.workDir ?? "./tmp", generateWorkspaceName(i)));
-                    logger.progress(i + 1, repoName, "Updating manifest...");
-                    const manifestResult = await repoProcessor.updateManifestOnly(repoInfo, repoConfig, {
-                        branchName: "chore/sync-rulesets",
-                        workDir,
-                        configId: config.id,
-                        dryRun: options.dryRun,
-                        retries: options.retries,
-                    }, result.manifestUpdate);
-                    if (!manifestResult.success && !manifestResult.skipped) {
-                        logger.info(`Warning: Failed to update manifest for ${repoName}: ${manifestResult.message}`);
-                    }
-                }
-            }
-            else {
-                logger.error(i + 1, repoName, result.message);
-                collector.appendError(repoName, result.message);
-            }
-            results.push({
-                repoName,
-                status: result.skipped
-                    ? "skipped"
-                    : result.success
-                        ? "succeeded"
-                        : "failed",
-                message: result.message,
-                rulesetPlanDetails: result.planOutput?.entries,
-            });
-            if (!result.skipped) {
-                collector.getOrCreate(repoName).rulesetResult = result;
-            }
-        }
-        catch (error) {
-            logger.error(i + 1, repoName, String(error));
-            results.push(buildErrorResult(repoName, error));
-            collector.appendError(repoName, error);
-        }
-    }
-}
-/**
- * Fetches the managed rulesets list from a remote GitHub repo's manifest.
- * Returns an empty array if the manifest doesn't exist or can't be read.
- *
- * Uses the project's ICommandExecutor + escapeShellArg pattern for safe
- * command execution. All inputs are from parsed config (owner/repo), not
- * user input.
- */
-async function fetchManagedRulesets(repoInfo, configId) {
-    try {
-        const endpoint = `/repos/${repoInfo.owner}/${repoInfo.repo}/contents/${MANIFEST_FILENAME}`;
-        const command = `gh api ${escapeShellArg(endpoint)} --jq '.content'`;
-        const base64Content = await defaultExecutor.exec(command, process.cwd());
-        const content = Buffer.from(base64Content.trim(), "base64").toString("utf-8");
-        const manifest = parseManifestContent(content);
-        return getManagedRulesets(manifest, configId);
-    }
-    catch {
-        return [];
-    }
-}

package/dist/cli/settings-command.d.ts

@@ -1,11 +0,0 @@
-import { SharedOptions } from "./sync-command.js";
-import { ProcessorFactory, RulesetProcessorFactory, RepoSettingsProcessorFactory, LabelsProcessorFactory } from "./types.js";
-import { type IRepoLifecycleManager } from "../lifecycle/index.js";
-/**
- * Options for the settings command.
- */
-export type SettingsOptions = SharedOptions;
-/**
- * Run the settings command - manages GitHub Rulesets, repo settings, and labels.
- */
-export declare function runSettings(options: SettingsOptions, processorFactory?: RulesetProcessorFactory, repoProcessorFactory?: ProcessorFactory, repoSettingsProcessorFactory?: RepoSettingsProcessorFactory, lifecycleManager?: IRepoLifecycleManager, labelsProcessorFactory?: LabelsProcessorFactory): Promise<void>;

package/dist/cli/settings-command.js

@@ -1,90 +0,0 @@
-import { resolve } from "node:path";
-import { existsSync } from "node:fs";
-import { loadRawConfig, normalizeConfig } from "../config/index.js";
-import { validateForSettings } from "../config/validator.js";
-import { hasGitHubAppCredentials, GitHubAppTokenManager, } from "../vcs/index.js";
-import { logger } from "../shared/logger.js";
-import { formatSettingsReportCLI } from "../output/settings-report.js";
-import { writeUnifiedSummary } from "../output/unified-summary.js";
-import { buildSettingsReport } from "./settings-report-builder.js";
-import { defaultProcessorFactory, defaultRulesetProcessorFactory, defaultRepoSettingsProcessorFactory, defaultLabelsProcessorFactory, } from "./types.js";
-import { RepoLifecycleManager, } from "../lifecycle/index.js";
-import { ResultsCollector } from "./settings/results-collector.js";
-import { runLifecycleChecks } from "./settings/lifecycle-checks.js";
-import { processRulesets } from "./settings/process-rulesets.js";
-import { processRepoSettings } from "./settings/process-repo-settings.js";
-import { processLabels } from "./settings/process-labels.js";
-/**
- * Run the settings command - manages GitHub Rulesets, repo settings, and labels.
- */
-export async function runSettings(options, processorFactory = defaultRulesetProcessorFactory, repoProcessorFactory = defaultProcessorFactory, repoSettingsProcessorFactory = defaultRepoSettingsProcessorFactory, lifecycleManager, labelsProcessorFactory = defaultLabelsProcessorFactory) {
-    const configPath = resolve(options.config);
-    if (!existsSync(configPath)) {
-        console.error(`Config file not found: ${configPath}`);
-        process.exit(1);
-    }
-    console.log(`Loading config from: ${configPath}`);
-    if (options.dryRun) {
-        console.log("Running in DRY RUN mode - no changes will be made\n");
-    }
-    const rawConfig = loadRawConfig(configPath);
-    try {
-        validateForSettings(rawConfig);
-    }
-    catch (error) {
-        console.error(error instanceof Error ? error.message : String(error));
-        process.exit(1);
-    }
-    const config = normalizeConfig(rawConfig);
-    const reposWithRulesets = config.repos.filter((r) => r.settings?.rulesets && Object.keys(r.settings.rulesets).length > 0);
-    const reposWithRepoSettings = config.repos.filter((r) => r.settings?.repo && Object.keys(r.settings.repo).length > 0);
-    const reposWithLabels = config.repos.filter((r) => r.settings?.labels && Object.keys(r.settings.labels).length > 0);
-    if (reposWithRulesets.length === 0 &&
-        reposWithRepoSettings.length === 0 &&
-        reposWithLabels.length === 0) {
-        console.log("No settings configured. Add settings.rulesets, settings.repo, or settings.labels to your config.");
-        return;
-    }
-    if (reposWithRulesets.length > 0) {
-        console.log(`Found ${reposWithRulesets.length} repositories with rulesets`);
-    }
-    if (reposWithRepoSettings.length > 0) {
-        console.log(`Found ${reposWithRepoSettings.length} repositories with repo settings`);
-    }
-    if (reposWithLabels.length > 0) {
-        console.log(`Found ${reposWithLabels.length} repositories with labels`);
-    }
-    console.log("");
-    logger.setTotal(reposWithRulesets.length +
-        reposWithRepoSettings.length +
-        reposWithLabels.length);
-    const processor = processorFactory();
-    const repoProcessor = repoProcessorFactory();
-    const lm = lifecycleManager ?? new RepoLifecycleManager(undefined, options.retries);
-    const tokenManager = hasGitHubAppCredentials()
-        ? new GitHubAppTokenManager(process.env.XFG_GITHUB_APP_ID, process.env.XFG_GITHUB_APP_PRIVATE_KEY)
-        : null;
-    const results = [];
-    const collector = new ResultsCollector();
-    // Pre-check lifecycle for all unique repos before processing
-    const allRepos = [
-        ...reposWithRulesets,
-        ...reposWithRepoSettings,
-        ...reposWithLabels,
-    ];
-    const lifecycleSkipped = await runLifecycleChecks(allRepos, config, options, lm, results, collector, tokenManager);
-    await processRulesets(reposWithRulesets, config, options, processor, repoProcessor, results, collector, lifecycleSkipped);
-    await processRepoSettings(reposWithRepoSettings, config, options, repoSettingsProcessorFactory, results, collector, lifecycleSkipped, reposWithRulesets.length);
-    await processLabels(reposWithLabels, config, options, labelsProcessorFactory(), repoProcessor, results, collector, lifecycleSkipped, reposWithRulesets.length + reposWithRepoSettings.length);
-    console.log("");
-    const report = buildSettingsReport(collector.getAll());
-    const lines = formatSettingsReportCLI(report);
-    for (const line of lines) {
-        console.log(line);
-    }
-    writeUnifiedSummary({ settings: report, dryRun: options.dryRun ?? false });
-    const hasErrors = report.repos.some((r) => r.error);
-    if (hasErrors) {
-        process.exit(1);
-    }
-}

package/dist/sync/manifest-strategy.d.ts

@@ -1,21 +0,0 @@
-import type { RepoConfig } from "../config/types.js";
-import type { RepoInfo } from "../shared/repo-detector.js";
-import type { ILogger } from "../shared/logger.js";
-import type { IWorkStrategy, WorkResult, SessionContext, ProcessorOptions } from "./types.js";
-/**
- * Parameters for manifest-only updates
- */
-export interface ManifestUpdateParams {
-    rulesets?: string[];
-    labels?: string[];
-}
-/**
- * Strategy that only updates the manifest with ruleset tracking.
- * Used by updateManifestOnly() for settings command ruleset sync.
- */
-export declare class ManifestStrategy implements IWorkStrategy {
-    private readonly params;
-    private readonly log;
-    constructor(params: ManifestUpdateParams, log: ILogger);
-    execute(_repoConfig: RepoConfig, _repoInfo: RepoInfo, _session: SessionContext, options: ProcessorOptions): Promise<WorkResult | null>;
-}

package/dist/sync/manifest-strategy.js

@@ -1,67 +0,0 @@
-import { loadManifest, saveManifest, updateManifestRulesets, updateManifestLabels, MANIFEST_FILENAME, } from "./manifest.js";
-/**
- * Strategy that only updates the manifest with ruleset tracking.
- * Used by updateManifestOnly() for settings command ruleset sync.
- */
-export class ManifestStrategy {
-    params;
-    log;
-    constructor(params, log) {
-        this.params = params;
-        this.log = log;
-    }
-    async execute(_repoConfig, _repoInfo, _session, options) {
-        const { workDir, dryRun, configId } = options;
-        // Load and update manifest
-        const existingManifest = loadManifest(workDir);
-        let newManifest = existingManifest;
-        // Apply rulesets update if present
-        if (this.params.rulesets) {
-            const rulesetsWithDeleteOrphaned = new Map(this.params.rulesets.map((name) => [name, true]));
-            const result = updateManifestRulesets(newManifest, configId, rulesetsWithDeleteOrphaned);
-            newManifest = result.manifest;
-        }
-        // Apply labels update if present
-        if (this.params.labels) {
-            const labelsWithDeleteOrphaned = new Map(this.params.labels.map((name) => [name, true]));
-            const result = updateManifestLabels(newManifest, configId, labelsWithDeleteOrphaned);
-            newManifest = result.manifest;
-        }
-        // Check if changed
-        const existingConfigs = existingManifest?.configs ?? {};
-        if (JSON.stringify(existingConfigs) === JSON.stringify(newManifest.configs)) {
-            return null;
-        }
-        // Build dynamic commit message
-        const parts = [];
-        if (this.params.rulesets)
-            parts.push("ruleset");
-        if (this.params.labels)
-            parts.push("labels");
-        const trackingType = parts.join("/");
-        if (dryRun) {
-            this.log.info(`Would update ${MANIFEST_FILENAME} with ${trackingType} tracking`);
-        }
-        else {
-            saveManifest(workDir, newManifest);
-        }
-        const fileChanges = new Map([
-            [
-                MANIFEST_FILENAME,
-                {
-                    fileName: MANIFEST_FILENAME,
-                    content: JSON.stringify(newManifest, null, 2) + "\n",
-                    action: "update",
-                },
-            ],
-        ]);
-        return {
-            fileChanges,
-            changedFiles: [
-                { fileName: MANIFEST_FILENAME, action: "update" },
-            ],
-            commitMessage: `chore: update manifest with ${trackingType} tracking`,
-            fileChangeDetails: [{ path: MANIFEST_FILENAME, action: "update" }],
-        };
-    }
-}