@aspruyt/xfg 3.9.12 → 3.9.14

package/dist/settings/labels/processor.js

@@ -0,0 +1,189 @@
+import { isGitHubRepo, getRepoDisplayName, } from "../../shared/repo-detector.js";
+import { GitHubLabelsStrategy } from "./github-labels-strategy.js";
+import { diffLabels } from "./diff.js";
+import { formatLabelsPlan } from "./formatter.js";
+import { labelConfigToPayload } from "./converter.js";
+import { hasGitHubAppCredentials } from "../../vcs/index.js";
+import { GitHubAppTokenManager } from "../../vcs/github-app-token-manager.js";
+// =============================================================================
+// Processor Implementation
+// =============================================================================
+/**
+ * Processes label configuration for a repository.
+ * Handles create/update/delete operations via GitHub Labels API.
+ */
+export class LabelsProcessor {
+    strategy;
+    tokenManager;
+    constructor(strategy) {
+        this.strategy = strategy ?? new GitHubLabelsStrategy();
+        if (hasGitHubAppCredentials()) {
+            this.tokenManager = new GitHubAppTokenManager(process.env.XFG_GITHUB_APP_ID, process.env.XFG_GITHUB_APP_PRIVATE_KEY);
+        }
+        else {
+            this.tokenManager = null;
+        }
+    }
+    /**
+     * Process labels for a single repository.
+     */
+    async process(repoConfig, repoInfo, options) {
+        const repoName = getRepoDisplayName(repoInfo);
+        const { dryRun, managedLabels, noDelete, token } = options;
+        // Check if this is a GitHub repo
+        if (!isGitHubRepo(repoInfo)) {
+            return {
+                success: true,
+                repoName,
+                message: `Skipped: ${repoName} is not a GitHub repository`,
+                skipped: true,
+            };
+        }
+        const githubRepo = repoInfo;
+        const settings = repoConfig.settings;
+        const desiredLabels = settings?.labels ?? {};
+        const deleteOrphaned = settings?.deleteOrphaned ?? false;
+        // If no labels configured, skip
+        if (Object.keys(desiredLabels).length === 0 && managedLabels.length === 0) {
+            return {
+                success: true,
+                repoName,
+                message: "No labels configured",
+                skipped: true,
+            };
+        }
+        try {
+            // Resolve App token if available, fall back to provided token
+            const effectiveToken = token ?? (await this.getInstallationToken(githubRepo));
+            const strategyOptions = { token: effectiveToken, host: githubRepo.host };
+            const currentLabels = await this.strategy.list(githubRepo, strategyOptions);
+            // Compute diff
+            const changes = diffLabels(currentLabels, desiredLabels, managedLabels, noDelete ?? false);
+            // Count changes by type
+            const changeCounts = {
+                create: changes.filter((c) => c.action === "create").length,
+                update: changes.filter((c) => c.action === "update").length,
+                delete: changes.filter((c) => c.action === "delete").length,
+                unchanged: changes.filter((c) => c.action === "unchanged").length,
+            };
+            const planOutput = formatLabelsPlan(changes);
+            // Dry run mode - report planned changes without applying
+            if (dryRun) {
+                const summary = this.formatChangeSummary(changeCounts);
+                return {
+                    success: true,
+                    repoName,
+                    message: `[DRY RUN] ${summary}`,
+                    dryRun: true,
+                    changes: changeCounts,
+                    planOutput,
+                    manifestUpdate: this.computeManifestUpdate(desiredLabels, deleteOrphaned),
+                };
+            }
+            // Apply changes (diff is already sorted: delete, update, create, unchanged)
+            let appliedCount = 0;
+            for (const change of changes) {
+                switch (change.action) {
+                    case "create":
+                        if (change.desired) {
+                            const payload = labelConfigToPayload(change.name, change.desired);
+                            await this.strategy.create(githubRepo, {
+                                name: payload.name,
+                                color: payload.color,
+                                ...(payload.description !== undefined
+                                    ? { description: payload.description }
+                                    : {}),
+                            }, strategyOptions);
+                            appliedCount++;
+                        }
+                        break;
+                    case "update":
+                        if (change.desired) {
+                            const updatePayload = {};
+                            for (const prop of change.propertyChanges ?? []) {
+                                if (prop.property === "color") {
+                                    updatePayload.color = prop.newValue;
+                                }
+                                else if (prop.property === "description") {
+                                    updatePayload.description = prop.newValue;
+                                }
+                                else if (prop.property === "new_name") {
+                                    updatePayload.new_name = prop.newValue;
+                                }
+                            }
+                            await this.strategy.update(githubRepo, change.name, updatePayload, strategyOptions);
+                            appliedCount++;
+                        }
+                        break;
+                    case "delete":
+                        if (!noDelete && deleteOrphaned) {
+                            await this.strategy.delete(githubRepo, change.name, strategyOptions);
+                            appliedCount++;
+                        }
+                        break;
+                    case "unchanged":
+                        // No action needed
+                        break;
+                }
+            }
+            const summary = this.formatChangeSummary(changeCounts);
+            return {
+                success: true,
+                repoName,
+                message: appliedCount > 0 ? `Applied: ${summary}` : "No changes needed",
+                changes: changeCounts,
+                planOutput,
+                manifestUpdate: this.computeManifestUpdate(desiredLabels, deleteOrphaned),
+            };
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            return {
+                success: false,
+                repoName,
+                message: `Failed: ${message}`,
+            };
+        }
+    }
+    /**
+     * Format change counts into a summary string.
+     */
+    formatChangeSummary(counts) {
+        const parts = [];
+        if (counts.create > 0)
+            parts.push(`${counts.create} created`);
+        if (counts.update > 0)
+            parts.push(`${counts.update} updated`);
+        if (counts.delete > 0)
+            parts.push(`${counts.delete} deleted`);
+        if (counts.unchanged > 0)
+            parts.push(`${counts.unchanged} unchanged`);
+        return parts.length > 0 ? parts.join(", ") : "no changes";
+    }
+    /**
+     * Compute manifest update based on current config.
+     * Only labels with deleteOrphaned enabled should be tracked.
+     */
+    computeManifestUpdate(labels, deleteOrphaned) {
+        if (!deleteOrphaned) {
+            return undefined;
+        }
+        const labelNames = Object.keys(labels).sort();
+        return { labels: labelNames };
+    }
+    /**
+     * Resolves a GitHub App installation token for the given repo.
+     */
+    async getInstallationToken(repoInfo) {
+        if (!this.tokenManager) {
+            return undefined;
+        }
+        try {
+            const token = await this.tokenManager.getTokenForRepo(repoInfo);
+            return token ?? undefined;
+        }
+        catch {
+            return undefined;
+        }
+    }
+}

package/dist/settings/labels/types.d.ts

@@ -0,0 +1,33 @@
+import type { RepoInfo } from "../../shared/repo-detector.js";
+export interface LabelsStrategyOptions {
+    token?: string;
+    host?: string;
+}
+/**
+ * GitHub label as returned by the API.
+ */
+export interface GitHubLabel {
+    id: number;
+    name: string;
+    color: string;
+    description: string | null;
+    default: boolean;
+}
+/**
+ * Strategy interface for label operations.
+ * Abstracts platform-specific API calls.
+ */
+export interface ILabelsStrategy {
+    list(repoInfo: RepoInfo, options?: LabelsStrategyOptions): Promise<GitHubLabel[]>;
+    create(repoInfo: RepoInfo, label: {
+        name: string;
+        color: string;
+        description?: string;
+    }, options?: LabelsStrategyOptions): Promise<void>;
+    update(repoInfo: RepoInfo, currentName: string, label: {
+        new_name?: string;
+        color?: string;
+        description?: string;
+    }, options?: LabelsStrategyOptions): Promise<void>;
+    delete(repoInfo: RepoInfo, name: string, options?: LabelsStrategyOptions): Promise<void>;
+}

package/dist/settings/labels/types.js

@@ -0,0 +1 @@
+export {};

package/dist/sync/index.d.ts

@@ -12,6 +12,6 @@ export { ManifestStrategy, type ManifestUpdateParams, } from "./manifest-strateg
 export { SyncWorkflow } from "./sync-workflow.js";
 export type { IFileWriter, FileWriteContext, FileWriterDeps, FileWriteAllResult, FileWriteResult, IManifestManager, OrphanProcessResult, OrphanDeleteOptions, OrphanDeleteDeps, IBranchManager, BranchSetupOptions, IAuthOptionsBuilder, AuthResult, IRepositorySession, SessionOptions, SessionContext, ICommitPushManager, CommitPushOptions, CommitPushResult, GitOpsFactory, IRepositoryProcessor, ProcessorOptions, ProcessorResult, FileChangeDetail, IFileSyncOrchestrator, FileSyncResult, IPRMergeHandler, PRHandlerOptions, WorkResult, IWorkStrategy, ISyncWorkflow, } from "./types.js";
 export { RepositoryProcessor } from "./repository-processor.js";
-export { createEmptyManifest, loadManifest, saveManifest, getManagedFiles, getManagedRulesets, updateManifest, updateManifestRulesets, MANIFEST_FILENAME, type XfgManifest, type XfgManifestConfigEntry, } from "./manifest.js";
+export { createEmptyManifest, loadManifest, saveManifest, getManagedFiles, getManagedRulesets, getManagedLabels, updateManifest, updateManifestRulesets, updateManifestLabels, MANIFEST_FILENAME, type XfgManifest, type XfgManifestConfigEntry, } from "./manifest.js";
 export { getFileStatus, formatStatusBadge, formatDiffLine, generateDiff, createDiffStats, incrementDiffStats, type FileStatus, type DiffStats, } from "./diff-utils.js";
 export { interpolateXfgContent, type XfgTemplateContext, type XfgInterpolationOptions, } from "./xfg-template.js";

package/dist/sync/index.js

@@ -14,7 +14,7 @@ export { SyncWorkflow } from "./sync-workflow.js";
 // Repository processor
 export { RepositoryProcessor } from "./repository-processor.js";
 // Manifest handling
-export { createEmptyManifest, loadManifest, saveManifest, getManagedFiles, getManagedRulesets, updateManifest, updateManifestRulesets, MANIFEST_FILENAME, } from "./manifest.js";
+export { createEmptyManifest, loadManifest, saveManifest, getManagedFiles, getManagedRulesets, getManagedLabels, updateManifest, updateManifestRulesets, updateManifestLabels, MANIFEST_FILENAME, } from "./manifest.js";
 // Diff utilities
 export { getFileStatus, formatStatusBadge, formatDiffLine, generateDiff, createDiffStats, incrementDiffStats, } from "./diff-utils.js";
 // XFG templating

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

@@ -6,7 +6,8 @@ import type { IWorkStrategy, WorkResult, SessionContext, ProcessorOptions } from
  * Parameters for manifest-only updates
  */
 export interface ManifestUpdateParams {
-    rulesets: string[];
+    rulesets?: string[];
+    labels?: string[];
 }
 /**
  * Strategy that only updates the manifest with ruleset tracking.

package/dist/sync/manifest-strategy.js

@@ -1,4 +1,4 @@
-import { loadManifest, saveManifest, updateManifestRulesets, MANIFEST_FILENAME, } from "./manifest.js";
+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.
@@ -14,15 +14,33 @@ export class ManifestStrategy {
         const { workDir, dryRun, configId } = options;
         // Load and update manifest
         const existingManifest = loadManifest(workDir);
-        const rulesetsWithDeleteOrphaned = new Map(this.params.rulesets.map((name) => [name, true]));
-        const { manifest: newManifest } = updateManifestRulesets(existingManifest, configId, rulesetsWithDeleteOrphaned);
+        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 rulesets`);
+            this.log.info(`Would update ${MANIFEST_FILENAME} with ${trackingType} tracking`);
         }
         else {
             saveManifest(workDir, newManifest);
@@ -42,7 +60,7 @@ export class ManifestStrategy {
             changedFiles: [
                 { fileName: MANIFEST_FILENAME, action: "update" },
             ],
-            commitMessage: "chore: update manifest with ruleset tracking",
+            commitMessage: `chore: update manifest with ${trackingType} tracking`,
             fileChangeDetails: [{ path: MANIFEST_FILENAME, action: "update" }],
         };
     }

package/dist/sync/manifest.d.ts

@@ -2,6 +2,7 @@ export declare const MANIFEST_FILENAME = ".xfg.json";
 export interface XfgManifestConfigEntry {
     files?: string[];
     rulesets?: string[];
+    labels?: string[];
 }
 export interface XfgManifest {
     version: 3;
@@ -25,6 +26,11 @@ export declare function createEmptyManifest(): XfgManifest;
  * @returns The manifest or null if not found or incompatible
  */
 export declare function loadManifest(workDir: string): XfgManifest | null;
+/**
+ * Parses manifest content from a string (e.g., fetched from a remote API).
+ * Handles V2→V3 migration, returns null for V1/unknown/invalid formats.
+ */
+export declare function parseManifestContent(content: string): XfgManifest | null;
 /**
  * Saves the xfg manifest to a repository's working directory.
  *
@@ -50,6 +56,11 @@ export declare function getManagedFiles(manifest: XfgManifest | null, configId:
  * @returns Array of managed ruleset names for the given config
  */
 export declare function getManagedRulesets(manifest: XfgManifest | null, configId: string): string[];
+/**
+ * Gets the list of managed labels for a specific config from a manifest.
+ * Returns an empty array if the manifest is null or the config isn't found.
+ */
+export declare function getManagedLabels(manifest: XfgManifest | null, configId: string): string[];
 /**
  * Updates the manifest with the current set of files that have deleteOrphaned enabled
  * for a specific config. Only modifies that config's files namespace - other configs are untouched.
@@ -80,3 +91,16 @@ export declare function updateManifestRulesets(manifest: XfgManifest | null, con
     manifest: XfgManifest;
     rulesetsToDelete: string[];
 };
+/**
+ * Updates the manifest with the current set of labels that have deleteOrphaned enabled
+ * for a specific config. Only modifies that config's labels namespace - other configs are untouched.
+ *
+ * @param manifest - The existing manifest (or null for new repos)
+ * @param configId - The config ID to update
+ * @param labelsWithDeleteOrphaned - Map of label name to deleteOrphaned value (true/false/undefined)
+ * @returns Updated manifest and list of labels to delete
+ */
+export declare function updateManifestLabels(manifest: XfgManifest | null, configId: string, labelsWithDeleteOrphaned: Map<string, boolean | undefined>): {
+    manifest: XfgManifest;
+    labelsToDelete: string[];
+};

package/dist/sync/manifest.js

@@ -96,6 +96,25 @@ export function loadManifest(workDir) {
         return null;
     }
 }
+/**
+ * Parses manifest content from a string (e.g., fetched from a remote API).
+ * Handles V2→V3 migration, returns null for V1/unknown/invalid formats.
+ */
+export function parseManifestContent(content) {
+    try {
+        const parsed = JSON.parse(content);
+        if (isV3Manifest(parsed)) {
+            return parsed;
+        }
+        if (isV2Manifest(parsed)) {
+            return migrateV2ToV3(parsed);
+        }
+        return null;
+    }
+    catch {
+        return null;
+    }
+}
 /**
  * Saves the xfg manifest to a repository's working directory.
  *
@@ -135,6 +154,16 @@ export function getManagedRulesets(manifest, configId) {
     }
     return [...(manifest.configs[configId]?.rulesets ?? [])];
 }
+/**
+ * Gets the list of managed labels for a specific config from a manifest.
+ * Returns an empty array if the manifest is null or the config isn't found.
+ */
+export function getManagedLabels(manifest, configId) {
+    if (!manifest) {
+        return [];
+    }
+    return [...(manifest.configs[configId]?.labels ?? [])];
+}
 /**
  * Updates the manifest with the current set of files that have deleteOrphaned enabled
  * for a specific config. Only modifies that config's files namespace - other configs are untouched.
@@ -173,22 +202,27 @@ export function updateManifest(manifest, configId, filesWithDeleteOrphaned) {
     const updatedConfigs = {
         ...(manifest?.configs ?? {}),
     };
-    // Preserve existing rulesets for this config
+    // Preserve existing rulesets and labels for this config
     const existingEntry = manifest?.configs[configId];
     const existingRulesets = existingEntry?.rulesets;
+    const existingLabels = existingEntry?.labels;
     // Update this config's managed files
     const sortedManaged = Array.from(newManaged).sort();
     if (sortedManaged.length > 0 ||
-        (existingRulesets && existingRulesets.length > 0)) {
+        (existingRulesets && existingRulesets.length > 0) ||
+        (existingLabels && existingLabels.length > 0)) {
         updatedConfigs[configId] = {
             ...(sortedManaged.length > 0 ? { files: sortedManaged } : {}),
             ...(existingRulesets && existingRulesets.length > 0
                 ? { rulesets: existingRulesets }
                 : {}),
+            ...(existingLabels && existingLabels.length > 0
+                ? { labels: existingLabels }
+                : {}),
         };
     }
     else {
-        // Remove config entry if no managed files or rulesets
+        // Remove config entry if no managed files, rulesets, or labels
         delete updatedConfigs[configId];
     }
     return {
@@ -229,21 +263,27 @@ export function updateManifestRulesets(manifest, configId, rulesetsWithDeleteOrp
     const updatedConfigs = {
         ...(manifest?.configs ?? {}),
     };
-    // Preserve existing files for this config
+    // Preserve existing files and labels for this config
     const existingEntry = manifest?.configs[configId];
     const existingFiles = existingEntry?.files;
+    const existingLabels = existingEntry?.labels;
     // Update this config's managed rulesets
     const sortedManaged = Array.from(newManaged).sort();
-    if (sortedManaged.length > 0 || (existingFiles && existingFiles.length > 0)) {
+    if (sortedManaged.length > 0 ||
+        (existingFiles && existingFiles.length > 0) ||
+        (existingLabels && existingLabels.length > 0)) {
         updatedConfigs[configId] = {
             ...(existingFiles && existingFiles.length > 0
                 ? { files: existingFiles }
                 : {}),
             ...(sortedManaged.length > 0 ? { rulesets: sortedManaged } : {}),
+            ...(existingLabels && existingLabels.length > 0
+                ? { labels: existingLabels }
+                : {}),
         };
     }
     else {
-        // Remove config entry if no managed files or rulesets
+        // Remove config entry if no managed files, rulesets, or labels
         delete updatedConfigs[configId];
     }
     return {
@@ -254,3 +294,55 @@ export function updateManifestRulesets(manifest, configId, rulesetsWithDeleteOrp
         rulesetsToDelete,
     };
 }
+/**
+ * Updates the manifest with the current set of labels that have deleteOrphaned enabled
+ * for a specific config. Only modifies that config's labels namespace - other configs are untouched.
+ *
+ * @param manifest - The existing manifest (or null for new repos)
+ * @param configId - The config ID to update
+ * @param labelsWithDeleteOrphaned - Map of label name to deleteOrphaned value (true/false/undefined)
+ * @returns Updated manifest and list of labels to delete
+ */
+export function updateManifestLabels(manifest, configId, labelsWithDeleteOrphaned) {
+    const existingManaged = new Set(getManagedLabels(manifest, configId));
+    const newManaged = new Set();
+    const labelsToDelete = [];
+    for (const [labelName, deleteOrphaned] of labelsWithDeleteOrphaned) {
+        if (deleteOrphaned === true) {
+            newManaged.add(labelName);
+        }
+    }
+    for (const labelName of existingManaged) {
+        if (!labelsWithDeleteOrphaned.has(labelName)) {
+            labelsToDelete.push(labelName);
+        }
+    }
+    const updatedConfigs = {
+        ...(manifest?.configs ?? {}),
+    };
+    // Preserve existing files and rulesets for this config
+    const existingEntry = manifest?.configs[configId];
+    const existingFiles = existingEntry?.files;
+    const existingRulesets = existingEntry?.rulesets;
+    const sortedManaged = Array.from(newManaged).sort();
+    if (sortedManaged.length > 0 ||
+        (existingFiles && existingFiles.length > 0) ||
+        (existingRulesets && existingRulesets.length > 0)) {
+        updatedConfigs[configId] = {
+            ...(existingFiles && existingFiles.length > 0
+                ? { files: existingFiles }
+                : {}),
+            ...(existingRulesets && existingRulesets.length > 0
+                ? { rulesets: existingRulesets }
+                : {}),
+            ...(sortedManaged.length > 0 ? { labels: sortedManaged } : {}),
+        };
+    }
+    else {
+        delete updatedConfigs[configId];
+    }
+    return {
+        manifest: { version: 3, configs: updatedConfigs },
+        labelsToDelete,
+    };
+}

package/dist/sync/repository-processor.d.ts

@@ -23,6 +23,7 @@ export declare class RepositoryProcessor implements IRepositoryProcessor {
     });
     process(repoConfig: RepoConfig, repoInfo: RepoInfo, options: ProcessorOptions): Promise<ProcessorResult>;
     updateManifestOnly(repoInfo: RepoInfo, repoConfig: RepoConfig, options: ProcessorOptions, manifestUpdate: {
-        rulesets: string[];
+        rulesets?: string[];
+        labels?: string[];
     }): Promise<ProcessorResult>;
 }

package/dist/sync/repository-processor.js

@@ -3,7 +3,7 @@ import { AuthenticatedGitOps } from "../vcs/authenticated-git-ops.js";
 import { logger } from "../shared/logger.js";
 import { hasGitHubAppCredentials } from "../vcs/index.js";
 import { GitHubAppTokenManager } from "../vcs/github-app-token-manager.js";
-import { FileWriter, ManifestManager, BranchManager, AuthOptionsBuilder, RepositorySession, CommitPushManager, FileSyncOrchestrator, PRMergeHandler, FileSyncStrategy, ManifestStrategy, SyncWorkflow, loadManifest, updateManifestRulesets, MANIFEST_FILENAME, } from "./index.js";
+import { FileWriter, ManifestManager, BranchManager, AuthOptionsBuilder, RepositorySession, CommitPushManager, FileSyncOrchestrator, PRMergeHandler, FileSyncStrategy, ManifestStrategy, SyncWorkflow, loadManifest, updateManifestRulesets, updateManifestLabels, MANIFEST_FILENAME, } from "./index.js";
 import { getRepoDisplayName } from "../shared/repo-detector.js";
 /**
  * Thin facade that delegates to SyncWorkflow with appropriate strategy.
@@ -47,10 +47,20 @@ export class RepositoryProcessor {
         const { workDir, dryRun } = options;
         // Pre-check manifest changes (preserves original early-return behavior)
         const existingManifest = loadManifest(workDir);
-        const rulesetsWithDeleteOrphaned = new Map(manifestUpdate.rulesets.map((name) => [name, true]));
-        const { manifest: newManifest } = updateManifestRulesets(existingManifest, options.configId, rulesetsWithDeleteOrphaned);
+        let simulatedManifest = existingManifest;
+        if (manifestUpdate.rulesets) {
+            const rulesetsWithDeleteOrphaned = new Map(manifestUpdate.rulesets.map((name) => [name, true]));
+            const result = updateManifestRulesets(simulatedManifest, options.configId, rulesetsWithDeleteOrphaned);
+            simulatedManifest = result.manifest;
+        }
+        if (manifestUpdate.labels) {
+            const labelsWithDeleteOrphaned = new Map(manifestUpdate.labels.map((name) => [name, true]));
+            const result = updateManifestLabels(simulatedManifest, options.configId, labelsWithDeleteOrphaned);
+            simulatedManifest = result.manifest;
+        }
         const existingConfigs = existingManifest?.configs ?? {};
-        if (JSON.stringify(existingConfigs) === JSON.stringify(newManifest.configs)) {
+        if (JSON.stringify(existingConfigs) ===
+            JSON.stringify(simulatedManifest.configs)) {
             return {
                 success: true,
                 repoName,
@@ -62,7 +72,13 @@ export class RepositoryProcessor {
             { path: MANIFEST_FILENAME, action: "update" },
         ];
         if (dryRun) {
-            this.log.info(`Would update ${MANIFEST_FILENAME} with rulesets`);
+            const parts = [];
+            if (manifestUpdate.rulesets)
+                parts.push("ruleset");
+            if (manifestUpdate.labels)
+                parts.push("labels");
+            const trackingType = parts.join("/") || "settings";
+            this.log.info(`Would update ${MANIFEST_FILENAME} with ${trackingType} tracking`);
             return {
                 success: true,
                 repoName,

package/dist/sync/types.d.ts

@@ -258,7 +258,8 @@ export interface ProcessorResult {
 export interface IRepositoryProcessor {
     process(repoConfig: RepoConfig, repoInfo: RepoInfo, options: ProcessorOptions): Promise<ProcessorResult>;
     updateManifestOnly(repoInfo: RepoInfo, repoConfig: RepoConfig, options: ProcessorOptions, manifestUpdate: {
-        rulesets: string[];
+        rulesets?: string[];
+        labels?: string[];
     }): Promise<ProcessorResult>;
 }
 /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aspruyt/xfg",
-  "version": "3.9.12",
+  "version": "3.9.14",
   "description": "Manage files, settings, and repositories across GitHub, Azure DevOps, and GitLab — declaratively, from a single YAML config",
   "type": "module",
   "main": "dist/index.js",
@@ -27,13 +27,14 @@
     "start": "node dist/cli.js",
     "dev": "ts-node src/cli.ts",
     "test": "node --import tsx scripts/run-tests.js",
-    "test:coverage": "c8 --check-coverage --lines 95 --reporter=text --reporter=lcov --all --src=src --exclude='test/**/*.test.ts' --exclude='scripts/**' --exclude='src/vcs/types.ts' --exclude='src/settings/rulesets/types.ts' --exclude='src/settings/repo-settings/types.ts' --exclude='src/**/index.ts' --exclude='test/mocks/**' --exclude='src/sync/types.ts' --exclude='src/lifecycle/types.ts' --exclude='src/cli/program.ts' --exclude='src/cli.ts' --exclude='src/index.ts' npm test",
+    "test:coverage": "c8 --check-coverage --lines 95 --reporter=text --reporter=lcov --all --src=src --exclude='test/**/*.test.ts' --exclude='scripts/**' --exclude='src/vcs/types.ts' --exclude='src/settings/rulesets/types.ts' --exclude='src/settings/repo-settings/types.ts' --exclude='src/settings/labels/types.ts' --exclude='src/**/index.ts' --exclude='test/mocks/**' --exclude='src/sync/types.ts' --exclude='src/lifecycle/types.ts' --exclude='src/cli/program.ts' --exclude='src/cli.ts' --exclude='src/index.ts' npm test",
     "test:integration:github": "npm run build && node --import tsx --test test/integration/github.test.ts",
     "test:integration:ado": "npm run build && node --import tsx --test test/integration/ado.test.ts",
     "test:integration:gitlab": "npm run build && node --import tsx --test test/integration/gitlab.test.ts",
     "test:integration:github-app": "npm run build && node --import tsx --test test/integration/github-app.test.ts",
     "test:integration:github-rulesets": "npm run build && node --import tsx --test test/integration/github-rulesets.test.ts",
     "test:integration:github-repo-settings": "npm run build && node --import tsx --test test/integration/github-repo-settings.test.ts",
+    "test:integration:github-labels": "npm run build && node --import tsx --test test/integration/github-labels.test.ts",
     "test:integration:github-lifecycle": "npm run build && node --import tsx --test test/integration/github-lifecycle.test.ts",
     "test:integration:github-lifecycle-app": "npm run build && node --import tsx --test test/integration/github-lifecycle-app.test.ts",
     "prepublishOnly": "npm run build"
@@ -64,7 +65,7 @@
   },
   "devDependencies": {
     "@types/node": "^24.0.0",
-    "c8": "^10.1.3",
+    "c8": "^11.0.0",
     "tsx": "^4.15.0",
     "typescript": "^5.4.5"
   }