@aspruyt/xfg 3.9.0 → 3.9.2

package/dist/cli/settings-command.js

@@ -9,7 +9,8 @@ import { logger } from "../shared/logger.js";
 import { generateWorkspaceName } from "../shared/workspace-utils.js";
 import { buildErrorResult } from "../output/summary-utils.js";
 import { getManagedRulesets } from "../sync/manifest.js";
-import { formatSettingsReportCLI, writeSettingsReportSummary, } from "../output/settings-report.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, } from "./types.js";
 import { RepoLifecycleManager, runLifecycleCheck, } from "../lifecycle/index.js";
@@ -318,7 +319,7 @@ export async function runSettings(options, processorFactory = defaultRulesetProc
     for (const line of lines) {
         console.log(line);
     }
-    writeSettingsReportSummary(report, options.dryRun ?? false);
+    writeUnifiedSummary({ settings: report, dryRun: options.dryRun ?? false });
     const hasErrors = report.repos.some((r) => r.error);
     if (hasErrors) {
         process.exit(1);

package/dist/cli/sync-command.js

@@ -9,8 +9,9 @@ import { logger } from "../shared/logger.js";
 import { generateWorkspaceName } from "../shared/workspace-utils.js";
 import { defaultProcessorFactory } from "./types.js";
 import { buildSyncReport } from "./sync-report-builder.js";
-import { formatSyncReportCLI, writeSyncReportSummary, } from "../output/sync-report.js";
-import { buildLifecycleReport, formatLifecycleReportCLI, writeLifecycleReportSummary, hasLifecycleChanges, } from "../output/lifecycle-report.js";
+import { formatSyncReportCLI } from "../output/sync-report.js";
+import { buildLifecycleReport, formatLifecycleReportCLI, hasLifecycleChanges, } from "../output/lifecycle-report.js";
+import { writeUnifiedSummary } from "../output/unified-summary.js";
 import { RepoLifecycleManager, runLifecycleCheck, toCreateRepoSettings, } from "../lifecycle/index.js";
 /**
  * Get unique file names from all repos in the config
@@ -238,14 +239,18 @@ export async function runSync(options, processorFactory = defaultProcessorFactor
             console.log(line);
         }
     }
-    writeLifecycleReportSummary(lifecycleReport, options.dryRun ?? false);
     // Build and display sync report
     const report = buildSyncReport(reportResults);
     console.log("");
     for (const line of formatSyncReportCLI(report)) {
         console.log(line);
     }
-    writeSyncReportSummary(report, options.dryRun ?? false);
+    // Write unified summary to GITHUB_STEP_SUMMARY
+    writeUnifiedSummary({
+        lifecycle: lifecycleReport,
+        sync: report,
+        dryRun: options.dryRun ?? false,
+    });
     // Exit with error if any failures
     const hasErrors = reportResults.some((r) => r.error);
     if (hasErrors) {

package/dist/output/index.d.ts

@@ -1,4 +1,5 @@
 export { formatSyncReportCLI, formatSyncReportMarkdown, writeSyncReportSummary, type SyncReport, type RepoFileChanges, type FileChange, } from "./sync-report.js";
-export { formatSettingsReportCLI, formatSettingsReportMarkdown, writeSettingsReportSummary, type SettingsReport, type RepoChanges, type RulesetChange, type SettingChange, } from "./settings-report.js";
+export { formatSettingsReportCLI, formatSettingsReportMarkdown, writeSettingsReportSummary, formatValuePlain, formatRulesetConfigPlain, type SettingsReport, type RepoChanges, type RulesetChange, type SettingChange, } from "./settings-report.js";
+export { formatUnifiedSummaryMarkdown, writeUnifiedSummary, type UnifiedSummaryInput, } from "./unified-summary.js";
 export { formatSummary, isGitHubActions, writeSummary, type MergeOutcome, type FileChanges, type RulesetPlanDetail, type RepoSettingsPlanDetail, type RepoResult, type SummaryData, } from "./github-summary.js";
 export { getMergeOutcome, toFileChanges, buildRepoResult, buildErrorResult, } from "./summary-utils.js";

package/dist/output/index.js

@@ -1,7 +1,9 @@
 // Sync report (repo-grouped file changes)
 export { formatSyncReportCLI, formatSyncReportMarkdown, writeSyncReportSummary, } from "./sync-report.js";
 // Settings report (repo-grouped settings changes)
-export { formatSettingsReportCLI, formatSettingsReportMarkdown, writeSettingsReportSummary, } from "./settings-report.js";
+export { formatSettingsReportCLI, formatSettingsReportMarkdown, writeSettingsReportSummary, formatValuePlain, formatRulesetConfigPlain, } from "./settings-report.js";
+// Unified summary (lifecycle + sync + settings in one diff block)
+export { formatUnifiedSummaryMarkdown, writeUnifiedSummary, } from "./unified-summary.js";
 // GitHub Actions summary
 export { formatSummary, isGitHubActions, writeSummary, } from "./github-summary.js";
 // Summary utilities

package/dist/output/lifecycle-report.js

@@ -1,12 +1,6 @@
 // src/output/lifecycle-report.ts
 import { appendFileSync } from "node:fs";
 import chalk from "chalk";
-function escapeHtml(text) {
-    return text
-        .replace(/&/g, "&")
-        .replace(/</g, "&lt;")
-        .replace(/>/g, "&gt;");
-}
 // =============================================================================
 // Builder
 // =============================================================================
@@ -103,35 +97,35 @@ export function formatLifecycleReportMarkdown(report, dryRun) {
         lines.push("> This was a dry run — no changes were applied");
         lines.push("");
     }
-    // Colored diff output using HTML <pre> with inline styles
+    // Diff block
     const diffLines = [];
     for (const action of report.actions) {
         if (action.action === "existed")
             continue;
         switch (action.action) {
             case "created":
-                diffLines.push(`<span style="color:#3fb950">+ CREATE ${escapeHtml(action.repoName)}</span>`);
+                diffLines.push(`+ CREATE ${action.repoName}`);
                 break;
             case "forked":
-                diffLines.push(`<span style="color:#3fb950">+ FORK ${escapeHtml(action.upstream ?? "upstream")} -&gt; ${escapeHtml(action.repoName)}</span>`);
+                diffLines.push(`+ FORK ${action.upstream ?? "upstream"} -> ${action.repoName}`);
                 break;
             case "migrated":
-                diffLines.push(`<span style="color:#3fb950">+ MIGRATE ${escapeHtml(action.source ?? "source")} -&gt; ${escapeHtml(action.repoName)}</span>`);
+                diffLines.push(`+ MIGRATE ${action.source ?? "source"} -> ${action.repoName}`);
                 break;
         }
         if (action.settings) {
             if (action.settings.visibility) {
-                diffLines.push(`<span style="color:#3fb950">    visibility: ${escapeHtml(action.settings.visibility)}</span>`);
+                diffLines.push(`    visibility: ${action.settings.visibility}`);
             }
             if (action.settings.description) {
-                diffLines.push(`<span style="color:#3fb950">    description: "${escapeHtml(action.settings.description)}"</span>`);
+                diffLines.push(`    description: "${action.settings.description}"`);
             }
         }
     }
     if (diffLines.length > 0) {
-        lines.push("<pre>");
+        lines.push("```diff");
         lines.push(...diffLines);
-        lines.push("</pre>");
+        lines.push("```");
         lines.push("");
     }
     // Summary

package/dist/output/settings-report.d.ts

@@ -33,5 +33,7 @@ export interface RulesetChange {
     config?: Ruleset;
 }
 export declare function formatSettingsReportCLI(report: SettingsReport): string[];
+export declare function formatValuePlain(val: unknown): string;
+export declare function formatRulesetConfigPlain(config: Ruleset): string[];
 export declare function formatSettingsReportMarkdown(report: SettingsReport, dryRun: boolean): string;
 export declare function writeSettingsReportSummary(report: SettingsReport, dryRun: boolean): void;

package/dist/output/settings-report.js

@@ -1,12 +1,6 @@
 import { appendFileSync } from "node:fs";
 import chalk from "chalk";
 import { formatPropertyTree, } from "../settings/rulesets/formatter.js";
-function escapeHtml(text) {
-    return text
-        .replace(/&/g, "&")
-        .replace(/</g, "&lt;")
-        .replace(/>/g, "&gt;");
-}
 // =============================================================================
 // Helpers
 // =============================================================================
@@ -159,7 +153,7 @@ export function formatSettingsReportCLI(report) {
 // =============================================================================
 // Markdown Formatter
 // =============================================================================
-function formatValuePlain(val) {
+export function formatValuePlain(val) {
     if (val === null)
         return "null";
     if (val === undefined)
@@ -170,7 +164,7 @@ function formatValuePlain(val) {
         return val ? "true" : "false";
     return String(val);
 }
-function formatRulesetConfigPlain(config) {
+export function formatRulesetConfigPlain(config) {
     const lines = [];
     function renderObject(obj, depth) {
         for (const [k, v] of Object.entries(obj)) {
@@ -222,8 +216,8 @@ function formatRulesetConfigPlain(config) {
 export function formatSettingsReportMarkdown(report, dryRun) {
     const lines = [];
     // Title
-    const titleSuffix = dryRun ? " (Dry Run)" : "";
-    lines.push(`## Repository Settings Summary${titleSuffix}`);
+    const title = dryRun ? "## xfg Plan" : "## xfg Apply";
+    lines.push(title);
     lines.push("");
     // Dry-run warning
     if (dryRun) {
@@ -239,57 +233,55 @@ export function formatSettingsReportMarkdown(report, dryRun) {
             !repo.error) {
             continue;
         }
-        diffLines.push(`<span style="color:#d29922">~ ${escapeHtml(repo.repoName)}</span>`);
+        diffLines.push(`@@ ${repo.repoName} @@`);
         for (const setting of repo.settings) {
             // Skip settings where both values are undefined
             if (setting.oldValue === undefined && setting.newValue === undefined) {
                 continue;
             }
             if (setting.action === "add") {
-                diffLines.push(`<span style="color:#3fb950">    + ${escapeHtml(setting.name)}: ${escapeHtml(formatValuePlain(setting.newValue))}</span>`);
+                diffLines.push(`+ ${setting.name}: ${formatValuePlain(setting.newValue)}`);
             }
             else {
-                diffLines.push(`<span style="color:#d29922">    ~ ${escapeHtml(setting.name)}: ${escapeHtml(formatValuePlain(setting.oldValue))} → ${escapeHtml(formatValuePlain(setting.newValue))}</span>`);
+                diffLines.push(`! ${setting.name}: ${formatValuePlain(setting.oldValue)} → ${formatValuePlain(setting.newValue)}`);
             }
         }
         for (const ruleset of repo.rulesets) {
             if (ruleset.action === "create") {
-                diffLines.push(`<span style="color:#3fb950">    + ruleset "${escapeHtml(ruleset.name)}"</span>`);
+                diffLines.push(`+ ruleset "${ruleset.name}"`);
                 if (ruleset.config) {
-                    for (const line of formatRulesetConfigPlain(ruleset.config)) {
-                        diffLines.push(`<span style="color:#3fb950">${escapeHtml(line)}</span>`);
-                    }
+                    diffLines.push(...formatRulesetConfigPlain(ruleset.config));
                 }
             }
             else if (ruleset.action === "update") {
-                diffLines.push(`<span style="color:#d29922">    ~ ruleset "${escapeHtml(ruleset.name)}"</span>`);
+                diffLines.push(`! ruleset "${ruleset.name}"`);
                 if (ruleset.propertyDiffs && ruleset.propertyDiffs.length > 0) {
                     for (const diff of ruleset.propertyDiffs) {
                         const path = diff.path.join(".");
                         if (diff.action === "add") {
-                            diffLines.push(`<span style="color:#3fb950">        + ${escapeHtml(path)}: ${escapeHtml(formatValuePlain(diff.newValue))}</span>`);
+                            diffLines.push(`+   ${path}: ${formatValuePlain(diff.newValue)}`);
                         }
                         else if (diff.action === "change") {
-                            diffLines.push(`<span style="color:#d29922">        ~ ${escapeHtml(path)}: ${escapeHtml(formatValuePlain(diff.oldValue))} → ${escapeHtml(formatValuePlain(diff.newValue))}</span>`);
+                            diffLines.push(`!   ${path}: ${formatValuePlain(diff.oldValue)} → ${formatValuePlain(diff.newValue)}`);
                         }
                         else if (diff.action === "remove") {
-                            diffLines.push(`<span style="color:#f85149">        - ${escapeHtml(path)}</span>`);
+                            diffLines.push(`-   ${path}`);
                         }
                     }
                 }
             }
             else if (ruleset.action === "delete") {
-                diffLines.push(`<span style="color:#f85149">    - ruleset "${escapeHtml(ruleset.name)}"</span>`);
+                diffLines.push(`- ruleset "${ruleset.name}"`);
             }
         }
         if (repo.error) {
-            diffLines.push(`<span style="color:#f85149">    ! Error: ${escapeHtml(repo.error)}</span>`);
+            diffLines.push(`- Error: ${repo.error}`);
         }
     }
     if (diffLines.length > 0) {
-        lines.push("<pre>");
+        lines.push("```diff");
         lines.push(...diffLines);
-        lines.push("</pre>");
+        lines.push("```");
         lines.push("");
     }
     // Summary

package/dist/output/sync-report.js

@@ -1,12 +1,6 @@
 // src/output/sync-report.ts
 import { appendFileSync } from "node:fs";
 import chalk from "chalk";
-function escapeHtml(text) {
-    return text
-        .replace(/&/g, "&")
-        .replace(/</g, "&lt;")
-        .replace(/>/g, "&gt;");
-}
 function formatSummary(totals) {
     const total = totals.files.create + totals.files.update + totals.files.delete;
     if (total === 0) {
@@ -55,8 +49,8 @@ export function formatSyncReportCLI(report) {
 export function formatSyncReportMarkdown(report, dryRun) {
     const lines = [];
     // Title
-    const titleSuffix = dryRun ? " (Dry Run)" : "";
-    lines.push(`## Config Sync Summary${titleSuffix}`);
+    const title = dryRun ? "## xfg Plan" : "## xfg Apply";
+    lines.push(title);
     lines.push("");
     // Dry-run warning
     if (dryRun) {
@@ -64,33 +58,32 @@ export function formatSyncReportMarkdown(report, dryRun) {
         lines.push("> This was a dry run — no changes were applied");
         lines.push("");
     }
-    // Colored diff output using HTML <pre> with inline styles
-    // Colors: green (#3fb950) for creates, yellow (#d29922) for changes, red (#f85149) for deletes
+    // Diff block
     const diffLines = [];
     for (const repo of report.repos) {
         if (repo.files.length === 0 && !repo.error) {
             continue;
         }
-        diffLines.push(`<span style="color:#d29922">~ ${escapeHtml(repo.repoName)}</span>`);
+        diffLines.push(`@@ ${repo.repoName} @@`);
         for (const file of repo.files) {
             if (file.action === "create") {
-                diffLines.push(`<span style="color:#3fb950">    + ${escapeHtml(file.path)}</span>`);
+                diffLines.push(`+ ${file.path}`);
             }
             else if (file.action === "update") {
-                diffLines.push(`<span style="color:#d29922">    ~ ${escapeHtml(file.path)}</span>`);
+                diffLines.push(`! ${file.path}`);
             }
             else if (file.action === "delete") {
-                diffLines.push(`<span style="color:#f85149">    - ${escapeHtml(file.path)}</span>`);
+                diffLines.push(`- ${file.path}`);
             }
         }
         if (repo.error) {
-            diffLines.push(`<span style="color:#f85149">    ! Error: ${escapeHtml(repo.error)}</span>`);
+            diffLines.push(`- Error: ${repo.error}`);
         }
     }
     if (diffLines.length > 0) {
-        lines.push("<pre>");
+        lines.push("```diff");
         lines.push(...diffLines);
-        lines.push("</pre>");
+        lines.push("```");
         lines.push("");
     }
     // Summary

package/dist/output/unified-summary.d.ts

@@ -0,0 +1,11 @@
+import type { LifecycleReport } from "./lifecycle-report.js";
+import type { SyncReport } from "./sync-report.js";
+import type { SettingsReport } from "./settings-report.js";
+export interface UnifiedSummaryInput {
+    lifecycle?: LifecycleReport;
+    sync?: SyncReport;
+    settings?: SettingsReport;
+    dryRun: boolean;
+}
+export declare function formatUnifiedSummaryMarkdown(input: UnifiedSummaryInput): string;
+export declare function writeUnifiedSummary(input: UnifiedSummaryInput): void;

package/dist/output/unified-summary.js

@@ -0,0 +1,245 @@
+// src/output/unified-summary.ts
+import { appendFileSync } from "node:fs";
+import { hasLifecycleChanges } from "./lifecycle-report.js";
+import { formatValuePlain, formatRulesetConfigPlain, } from "./settings-report.js";
+// =============================================================================
+// Helpers
+// =============================================================================
+function formatCombinedSummary(input) {
+    const parts = [];
+    // Lifecycle totals
+    if (input.lifecycle) {
+        const t = input.lifecycle.totals;
+        const repoTotal = t.created + t.forked + t.migrated;
+        if (repoTotal > 0) {
+            const repoParts = [];
+            if (t.created > 0)
+                repoParts.push(`${t.created} to create`);
+            if (t.forked > 0)
+                repoParts.push(`${t.forked} to fork`);
+            if (t.migrated > 0)
+                repoParts.push(`${t.migrated} to migrate`);
+            const repoWord = repoTotal === 1 ? "repo" : "repos";
+            parts.push(`${repoTotal} ${repoWord} (${repoParts.join(", ")})`);
+        }
+    }
+    // Sync totals
+    if (input.sync) {
+        const t = input.sync.totals;
+        const fileTotal = t.files.create + t.files.update + t.files.delete;
+        if (fileTotal > 0) {
+            const fileParts = [];
+            if (t.files.create > 0)
+                fileParts.push(`${t.files.create} to create`);
+            if (t.files.update > 0)
+                fileParts.push(`${t.files.update} to update`);
+            if (t.files.delete > 0)
+                fileParts.push(`${t.files.delete} to delete`);
+            const fileWord = fileTotal === 1 ? "file" : "files";
+            parts.push(`${fileTotal} ${fileWord} (${fileParts.join(", ")})`);
+        }
+    }
+    // Settings totals
+    if (input.settings) {
+        const t = input.settings.totals;
+        const settingsTotal = t.settings.add + t.settings.change;
+        if (settingsTotal > 0) {
+            const settingWord = settingsTotal === 1 ? "setting" : "settings";
+            const actions = [];
+            if (t.settings.add > 0)
+                actions.push(`${t.settings.add} to add`);
+            if (t.settings.change > 0)
+                actions.push(`${t.settings.change} to change`);
+            parts.push(`${settingsTotal} ${settingWord} (${actions.join(", ")})`);
+        }
+        const rulesetsTotal = t.rulesets.create + t.rulesets.update + t.rulesets.delete;
+        if (rulesetsTotal > 0) {
+            const rulesetWord = rulesetsTotal === 1 ? "ruleset" : "rulesets";
+            const actions = [];
+            if (t.rulesets.create > 0)
+                actions.push(`${t.rulesets.create} to create`);
+            if (t.rulesets.update > 0)
+                actions.push(`${t.rulesets.update} to update`);
+            if (t.rulesets.delete > 0)
+                actions.push(`${t.rulesets.delete} to delete`);
+            parts.push(`${rulesetsTotal} ${rulesetWord} (${actions.join(", ")})`);
+        }
+    }
+    if (parts.length === 0) {
+        return "No changes";
+    }
+    return `Plan: ${parts.join(", ")}`;
+}
+function hasAnyChanges(input) {
+    if (input.lifecycle && hasLifecycleChanges(input.lifecycle))
+        return true;
+    if (input.sync?.repos.some((r) => r.files.length > 0 || r.error))
+        return true;
+    if (input.settings?.repos.some((r) => r.settings.length > 0 || r.rulesets.length > 0 || r.error))
+        return true;
+    return false;
+}
+// =============================================================================
+// Diff line builders
+// =============================================================================
+function renderLifecycleLines(lcAction, diffLines) {
+    if (lcAction.action === "existed")
+        return;
+    switch (lcAction.action) {
+        case "created":
+            diffLines.push(`+ CREATE`);
+            break;
+        case "forked":
+            diffLines.push(`+ FORK ${lcAction.upstream ?? "upstream"} -> ${lcAction.repoName}`);
+            break;
+        case "migrated":
+            diffLines.push(`+ MIGRATE ${lcAction.source ?? "source"} -> ${lcAction.repoName}`);
+            break;
+    }
+    if (lcAction.settings) {
+        if (lcAction.settings.visibility) {
+            diffLines.push(`+   visibility: ${lcAction.settings.visibility}`);
+        }
+        if (lcAction.settings.description) {
+            diffLines.push(`+   description: "${lcAction.settings.description}"`);
+        }
+    }
+}
+function renderSyncLines(syncRepo, diffLines) {
+    for (const file of syncRepo.files) {
+        if (file.action === "create") {
+            diffLines.push(`+ ${file.path}`);
+        }
+        else if (file.action === "update") {
+            diffLines.push(`! ${file.path}`);
+        }
+        else if (file.action === "delete") {
+            diffLines.push(`- ${file.path}`);
+        }
+    }
+    if (syncRepo.error) {
+        diffLines.push(`- Error: ${syncRepo.error}`);
+    }
+}
+function renderSettingsLines(settingsRepo, diffLines) {
+    for (const setting of settingsRepo.settings) {
+        if (setting.oldValue === undefined && setting.newValue === undefined) {
+            continue;
+        }
+        if (setting.action === "add") {
+            diffLines.push(`+ ${setting.name}: ${formatValuePlain(setting.newValue)}`);
+        }
+        else {
+            diffLines.push(`! ${setting.name}: ${formatValuePlain(setting.oldValue)} → ${formatValuePlain(setting.newValue)}`);
+        }
+    }
+    for (const ruleset of settingsRepo.rulesets) {
+        if (ruleset.action === "create") {
+            diffLines.push(`+ ruleset "${ruleset.name}"`);
+            if (ruleset.config) {
+                diffLines.push(...formatRulesetConfigPlain(ruleset.config));
+            }
+        }
+        else if (ruleset.action === "update") {
+            diffLines.push(`! ruleset "${ruleset.name}"`);
+            if (ruleset.propertyDiffs && ruleset.propertyDiffs.length > 0) {
+                for (const diff of ruleset.propertyDiffs) {
+                    const path = diff.path.join(".");
+                    if (diff.action === "add") {
+                        diffLines.push(`+   ${path}: ${formatValuePlain(diff.newValue)}`);
+                    }
+                    else if (diff.action === "change") {
+                        diffLines.push(`!   ${path}: ${formatValuePlain(diff.oldValue)} → ${formatValuePlain(diff.newValue)}`);
+                    }
+                    else if (diff.action === "remove") {
+                        diffLines.push(`-   ${path}`);
+                    }
+                }
+            }
+        }
+        else if (ruleset.action === "delete") {
+            diffLines.push(`- ruleset "${ruleset.name}"`);
+        }
+    }
+    if (settingsRepo.error) {
+        diffLines.push(`- Error: ${settingsRepo.error}`);
+    }
+}
+// =============================================================================
+// Markdown Formatter
+// =============================================================================
+export function formatUnifiedSummaryMarkdown(input) {
+    if (!hasAnyChanges(input)) {
+        return "";
+    }
+    const lines = [];
+    // Title: "xfg Plan" for dry-run, "xfg Apply" otherwise
+    const title = input.dryRun ? "## xfg Plan" : "## xfg Apply";
+    lines.push(title);
+    lines.push("");
+    // Dry-run warning
+    if (input.dryRun) {
+        lines.push("> [!WARNING]");
+        lines.push("> This was a dry run — no changes were applied");
+        lines.push("");
+    }
+    // Build lookup maps
+    const lifecycleByRepo = new Map((input.lifecycle?.actions ?? []).map((a) => [a.repoName, a]));
+    const syncByRepo = new Map((input.sync?.repos ?? []).map((r) => [r.repoName, r]));
+    const settingsByRepo = new Map((input.settings?.repos ?? []).map((r) => [r.repoName, r]));
+    // Collect all repo names in order
+    const allRepos = [];
+    const addRepo = (name) => {
+        if (!allRepos.includes(name))
+            allRepos.push(name);
+    };
+    for (const a of input.lifecycle?.actions ?? [])
+        addRepo(a.repoName);
+    for (const r of input.sync?.repos ?? [])
+        addRepo(r.repoName);
+    for (const r of input.settings?.repos ?? [])
+        addRepo(r.repoName);
+    // Diff block
+    const diffLines = [];
+    for (const repoName of allRepos) {
+        const lcAction = lifecycleByRepo.get(repoName);
+        const syncRepo = syncByRepo.get(repoName);
+        const settingsRepo = settingsByRepo.get(repoName);
+        const hasLcChange = lcAction && lcAction.action !== "existed";
+        const hasSyncChanges = syncRepo && (syncRepo.files.length > 0 || syncRepo.error);
+        const hasSettingsChanges = settingsRepo &&
+            (settingsRepo.settings.length > 0 ||
+                settingsRepo.rulesets.length > 0 ||
+                settingsRepo.error);
+        if (!hasLcChange && !hasSyncChanges && !hasSettingsChanges)
+            continue;
+        diffLines.push(`@@ ${repoName} @@`);
+        if (lcAction)
+            renderLifecycleLines(lcAction, diffLines);
+        if (syncRepo)
+            renderSyncLines(syncRepo, diffLines);
+        if (settingsRepo)
+            renderSettingsLines(settingsRepo, diffLines);
+    }
+    if (diffLines.length > 0) {
+        lines.push("```diff");
+        lines.push(...diffLines);
+        lines.push("```");
+        lines.push("");
+    }
+    // Combined summary
+    lines.push(`**${formatCombinedSummary(input)}**`);
+    return lines.join("\n");
+}
+// =============================================================================
+// File Writer
+// =============================================================================
+export function writeUnifiedSummary(input) {
+    const summaryPath = process.env.GITHUB_STEP_SUMMARY;
+    if (!summaryPath)
+        return;
+    const markdown = formatUnifiedSummaryMarkdown(input);
+    if (!markdown)
+        return;
+    appendFileSync(summaryPath, "\n" + markdown + "\n");
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aspruyt/xfg",
-  "version": "3.9.0",
+  "version": "3.9.2",
   "description": "CLI tool for repository-as-code: sync files and manage settings across GitHub, Azure DevOps, and GitLab",
   "type": "module",
   "main": "dist/index.js",