@aspruyt/xfg 4.0.4 → 5.0.0

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

@@ -1,22 +1,5 @@
-import type { FileChangeDetail } from "../sync/types.js";
-export type ReportFileChange = FileChangeDetail;
-export interface SyncReport {
-    repos: RepoFileChanges[];
-    totals: {
-        files: {
-            create: number;
-            update: number;
-            delete: number;
-        };
-    };
-}
-export interface RepoFileChanges {
-    repoName: string;
-    files: ReportFileChange[];
-    prUrl?: string;
-    mergeOutcome?: "manual" | "auto" | "force" | "direct";
-    error?: string;
-}
+import type { SyncReport, RepoFileChanges, ReportFileChange } from "./types.js";
+export type { SyncReport, RepoFileChanges, ReportFileChange };
 export declare function formatSyncReportCLI(report: SyncReport): string[];
 export declare function formatSyncReportMarkdown(report: SyncReport, dryRun: boolean): string;
 export declare function writeSyncReportSummary(report: SyncReport, dryRun: boolean, summaryPath: string | undefined): void;

package/dist/output/sync-report.js

@@ -1,20 +1,15 @@
-// src/output/sync-report.ts
 import chalk from "chalk";
 import { writeGitHubStepSummary } from "./github-summary.js";
+import { formatCountEntry } from "./settings-report.js";
+import { renderSyncLines } from "./unified-summary.js";
+import { formatDiffLine } from "../sync/index.js";
 function formatSyncSummary(totals) {
-    const total = totals.files.create + totals.files.update + totals.files.delete;
-    if (total === 0) {
-        return "No changes";
-    }
-    const parts = [];
-    if (totals.files.create > 0)
-        parts.push(`${totals.files.create} to create`);
-    if (totals.files.update > 0)
-        parts.push(`${totals.files.update} to update`);
-    if (totals.files.delete > 0)
-        parts.push(`${totals.files.delete} to delete`);
-    const fileWord = total === 1 ? "file" : "files";
-    return `Plan: ${total} ${fileWord} (${parts.join(", ")})`;
+    const entry = formatCountEntry("file", "files", [
+        { label: "to create", value: totals.files.create },
+        { label: "to update", value: totals.files.update },
+        { label: "to delete", value: totals.files.delete },
+    ]);
+    return entry ? `Plan: ${entry}` : "No changes";
 }
 export function formatSyncReportCLI(report) {
     const lines = [];
@@ -35,6 +30,12 @@ export function formatSyncReportCLI(report) {
             else if (file.action === "delete") {
                 lines.push(chalk.red(`    - ${file.path}`));
             }
+            // Content diff for structured data files
+            if (file.diffLines) {
+                for (const diffLine of file.diffLines) {
+                    lines.push(`      ${formatDiffLine(diffLine)}`);
+                }
+            }
         }
         // Error
         if (repo.error) {
@@ -65,20 +66,7 @@ export function formatSyncReportMarkdown(report, dryRun) {
             continue;
         }
         diffLines.push(`@@ ${repo.repoName} @@`);
-        for (const file of repo.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 (repo.error) {
-            diffLines.push(`- Error: ${repo.error}`);
-        }
+        renderSyncLines(repo, diffLines);
     }
     if (diffLines.length > 0) {
         lines.push("```diff");

package/dist/output/types.d.ts

@@ -0,0 +1,19 @@
+import type { FileChangeDetail } from "../sync/index.js";
+export type ReportFileChange = FileChangeDetail;
+export interface SyncReport {
+    repos: RepoFileChanges[];
+    totals: {
+        files: {
+            create: number;
+            update: number;
+            delete: number;
+        };
+    };
+}
+export interface RepoFileChanges {
+    repoName: string;
+    files: ReportFileChange[];
+    prUrl?: string;
+    mergeOutcome?: "manual" | "auto" | "force" | "direct";
+    error?: string;
+}

package/dist/output/types.js

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

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

@@ -1,5 +1,5 @@
 import type { LifecycleReport } from "./lifecycle-report.js";
-import type { SyncReport } from "./sync-report.js";
+import type { SyncReport, RepoFileChanges } from "./types.js";
 import type { SettingsReport } from "./settings-report.js";
 interface UnifiedSummaryInput {
     lifecycle?: LifecycleReport;
@@ -8,6 +8,7 @@ interface UnifiedSummaryInput {
     dryRun: boolean;
     summaryPath?: string | undefined;
 }
+export declare function renderSyncLines(syncRepo: RepoFileChanges, diffLines: string[]): void;
 export declare function formatUnifiedSummaryMarkdown(input: UnifiedSummaryInput): string;
 export declare function writeUnifiedSummary(input: UnifiedSummaryInput): void;
 export {};

package/dist/output/unified-summary.js

@@ -130,7 +130,7 @@ function renderLifecycleLines(lcAction, diffLines) {
         }
     }
 }
-function renderSyncLines(syncRepo, diffLines) {
+export function renderSyncLines(syncRepo, diffLines) {
     for (const file of syncRepo.files) {
         if (file.action === "create") {
             diffLines.push(`+ ${file.path}`);
@@ -141,6 +141,9 @@ function renderSyncLines(syncRepo, diffLines) {
         else if (file.action === "delete") {
             diffLines.push(`- ${file.path}`);
         }
+        if (file.diffLines) {
+            diffLines.push(...file.diffLines);
+        }
     }
     if (syncRepo.error) {
         diffLines.push(`- Error: ${syncRepo.error}`);

package/dist/settings/base-processor.d.ts

@@ -33,6 +33,8 @@ interface SettingsGuards<TOptions extends BaseProcessorOptions, TResult extends
  * empty settings check, token resolution, and error wrapping.
  */
 export declare function withGitHubGuards<TOptions extends BaseProcessorOptions, TResult extends BaseProcessorResult>(repoConfig: RepoConfig, repoInfo: RepoInfo, options: TOptions, guards: SettingsGuards<TOptions, TResult>): Promise<TResult>;
+/** Common action literals shared by all settings processors. */
+export type SettingsAction = "create" | "update" | "delete" | "unchanged";
 export interface ChangeCounts {
     create: number;
     update: number;
@@ -44,7 +46,7 @@ export interface ChangeCounts {
  * Works with any change type that has an `action` field.
  */
 export declare function countActions(changes: ReadonlyArray<{
-    action: string;
+    action: SettingsAction;
 }>): ChangeCounts;
 export declare function formatChangeSummary(counts: ChangeCounts): string;
 /**

package/dist/settings/base-processor.js

@@ -39,12 +39,16 @@ export async function withGitHubGuards(repoConfig, repoInfo, options, guards) {
  * Works with any change type that has an `action` field.
  */
 export function countActions(changes) {
-    return {
-        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 counts = {
+        create: 0,
+        update: 0,
+        delete: 0,
+        unchanged: 0,
     };
+    for (const c of changes) {
+        counts[c.action]++;
+    }
+    return counts;
 }
 export function formatChangeSummary(counts) {
     const parts = [];

package/dist/settings/index.d.ts

@@ -1,4 +1,4 @@
-export { type ISettingsProcessor } from "./base-processor.js";
+export { type ISettingsProcessor, type SettingsAction, } from "./base-processor.js";
 export { type PropertyDiff, formatPropertyTree, type RulesetPlanEntry, RulesetProcessor, type IRulesetProcessor, GitHubRulesetStrategy, } from "./rulesets/index.js";
 export { RepoSettingsProcessor, type IRepoSettingsProcessor, type RepoSettingsPlanEntry, GitHubRepoSettingsStrategy, } from "./repo-settings/index.js";
 export { type LabelsPlanEntry, LabelsProcessor, type ILabelsProcessor, GitHubLabelsStrategy, } from "./labels/index.js";

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

@@ -1,6 +1,7 @@
 import type { Label } from "../../config/types.js";
 import type { GitHubLabel } from "./types.js";
-export type LabelAction = "create" | "update" | "delete" | "unchanged";
+import type { SettingsAction } from "../base-processor.js";
+export type LabelAction = SettingsAction;
 export interface LabelChange {
     action: LabelAction;
     name: string;

package/dist/settings/labels/formatter.js

@@ -1,18 +1,16 @@
 import chalk from "chalk";
+import { countActions } from "../base-processor.js";
 /**
  * Format label changes as a Terraform-style plan.
  */
 export function formatLabelsPlan(changes) {
     const lines = [];
     const entries = [];
+    const { create: creates, update: updates, delete: deletes, unchanged, } = countActions(changes);
     const createChanges = changes.filter((c) => c.action === "create");
     const updateChanges = changes.filter((c) => c.action === "update");
     const deleteChanges = changes.filter((c) => c.action === "delete");
     const unchangedItems = changes.filter((c) => c.action === "unchanged");
-    const creates = createChanges.length;
-    const updates = updateChanges.length;
-    const deletes = deleteChanges.length;
-    const unchanged = unchangedItems.length;
     // Format creates
     if (createChanges.length > 0) {
         lines.push(chalk.bold("  Create:"));

package/dist/settings/labels/github-labels-strategy.js

@@ -1,5 +1,6 @@
 import { assertGitHubRepo } from "../../shared/repo-detector.js";
-import { GhApiClient, parseApiJson, } from "../../shared/gh-api-utils.js";
+import { GhApiClient } from "../../shared/gh-api-utils.js";
+import { parseApiJson } from "../../shared/json-utils.js";
 export class GitHubLabelsStrategy {
     api;
     constructor(executor, options) {

package/dist/settings/labels/processor.js

@@ -74,7 +74,6 @@ export class LabelsProcessor {
                     }
                     break;
                 case "unchanged":
-                    // No action needed
                     break;
             }
         }

package/dist/settings/repo-settings/github-repo-settings-strategy.js

@@ -1,5 +1,6 @@
 import { assertGitHubRepo, } from "../../shared/repo-detector.js";
-import { GhApiClient, parseApiJson, isHttp404Error, } from "../../shared/gh-api-utils.js";
+import { GhApiClient, isHttp404Error, } from "../../shared/gh-api-utils.js";
+import { parseApiJson } from "../../shared/json-utils.js";
 import { camelToSnake } from "../../shared/string-utils.js";
 /**
  * Converts GitHubRepoSettings (camelCase) to GitHub API format (snake_case).

package/dist/settings/rulesets/diff-algorithm.js

@@ -1,4 +1,3 @@
-// src/settings/rulesets/diff-algorithm.ts
 import { isPlainObject } from "../../shared/type-guards.js";
 export function deepEqual(a, b) {
     if (a === b)

package/dist/settings/rulesets/diff.d.ts

@@ -1,6 +1,7 @@
 import { type Ruleset } from "../../config/index.js";
+import { type SettingsAction } from "../base-processor.js";
 import type { GitHubRuleset } from "./types.js";
-export type RulesetAction = "create" | "update" | "delete" | "unchanged";
+export type RulesetAction = SettingsAction;
 export interface RulesetChange {
     action: RulesetAction;
     name: string;

package/dist/settings/rulesets/diff.js

@@ -1,6 +1,7 @@
 import { RULESET_COMPARABLE_FIELDS } from "../../config/index.js";
 import { isPlainObject } from "../../shared/type-guards.js";
 import { camelToSnake } from "../../shared/string-utils.js";
+import { countActions } from "../base-processor.js";
 /**
  * Normalizes a value recursively, converting keys to a consistent format (snake_case).
  * This allows comparing GitHub API responses (snake_case) with config (camelCase).
@@ -128,34 +129,54 @@ function projectObjects(current, desired) {
     }
     return result;
 }
+/**
+ * Candidate keys for matching array items by identity rather than index.
+ * Order matters — first key found across all items wins.
+ */
+const MATCH_KEY_CANDIDATES = ["type", "actor_id"];
+/**
+ * Finds a key that uniquely identifies items in both arrays.
+ * Returns the first candidate key present in every item of both arrays, or undefined.
+ */
+function findMatchKey(current, desired) {
+    const allItems = [...current, ...desired];
+    if (allItems.length === 0)
+        return undefined;
+    for (const candidate of MATCH_KEY_CANDIDATES) {
+        const everyItemHasKey = allItems.every((item) => isPlainObject(item) && candidate in item);
+        if (everyItemHasKey)
+            return candidate;
+    }
+    return undefined;
+}
 function projectArrays(current, desired) {
     // Primitive arrays — return current as-is
     if (desired.length === 0 || !isPlainObject(desired[0])) {
         return current;
     }
-    // Arrays of objects — match by `type` field if available
-    const hasType = desired.every((item) => isPlainObject(item) && "type" in item);
-    if (hasType) {
-        return matchByType(current, desired);
+    // Arrays of objects — match by identifying key if available
+    const matchKey = findMatchKey(current, desired);
+    if (matchKey) {
+        return matchByKey(current, desired, matchKey);
     }
     // Fallback: match by index
     return matchByIndex(current, desired);
 }
-function matchByType(current, desired) {
-    const currentByType = new Map();
+function matchByKey(current, desired, key) {
+    const currentByKey = new Map();
     for (const item of current) {
         if (isPlainObject(item)) {
-            const type = item.type;
-            if (type)
-                currentByType.set(type, item);
+            const keyValue = item[key];
+            if (keyValue !== undefined)
+                currentByKey.set(keyValue, item);
         }
     }
-    const desiredTypes = new Set();
+    const desiredKeys = new Set();
     const result = [];
     for (const desiredItem of desired) {
-        const type = desiredItem.type;
-        desiredTypes.add(type);
-        const currentItem = currentByType.get(type);
+        const keyValue = desiredItem[key];
+        desiredKeys.add(keyValue);
+        const currentItem = currentByKey.get(keyValue);
         if (currentItem) {
             result.push(projectToDesiredShape(currentItem, desiredItem));
         }
@@ -165,8 +186,8 @@ function matchByType(current, desired) {
     // deepEqual must detect (length mismatch). Fixes #549.
     for (const item of current) {
         if (isPlainObject(item)) {
-            const type = item.type;
-            if (type && !desiredTypes.has(type)) {
+            const keyValue = item[key];
+            if (keyValue !== undefined && !desiredKeys.has(keyValue)) {
                 result.push(item);
             }
         }
@@ -286,12 +307,7 @@ export function formatDiff(changes) {
         lines.push(formatChange(change));
     }
     // Summary
-    const counts = {
-        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 counts = countActions(changes);
     lines.push("");
     lines.push("Summary:");
     const parts = [];

package/dist/settings/rulesets/formatter.js

@@ -118,6 +118,49 @@ function getActionStyle(action) {
             return { symbol: "~", color: chalk.yellow };
     }
 }
+/**
+ * Render a leaf tree node (no children) with its value.
+ */
+function renderLeafNode(child, style, indentStr, indent) {
+    const lines = [];
+    const hasComplexNew = isPlainObject(child.newValue) ||
+        (Array.isArray(child.newValue) &&
+            child.newValue.some((v) => isPlainObject(v)));
+    const hasComplexOld = isPlainObject(child.oldValue) ||
+        (Array.isArray(child.oldValue) &&
+            child.oldValue.some((v) => isPlainObject(v)));
+    if (child.action === "add" && hasComplexNew) {
+        lines.push(style.color(`${indentStr}${style.symbol} ${child.name}:`));
+        lines.push(...renderNestedValue(child.newValue, child.action, indent + 1));
+    }
+    else if (child.action === "remove" && hasComplexOld) {
+        lines.push(style.color(`${indentStr}${style.symbol} ${child.name} (removed):`));
+        lines.push(...renderNestedValue(child.oldValue, child.action, indent + 1));
+    }
+    else if (child.action === "change" && (hasComplexNew || hasComplexOld)) {
+        lines.push(style.color(`${indentStr}${style.symbol} ${child.name}:`));
+        if (hasComplexOld) {
+            lines.push(...renderNestedValue(child.oldValue, "remove", indent + 1));
+        }
+        if (hasComplexNew) {
+            lines.push(...renderNestedValue(child.newValue, "add", indent + 1));
+        }
+    }
+    else {
+        let valuePart = "";
+        if (child.action === "change") {
+            valuePart = `: ${formatValue(child.oldValue)} → ${formatValue(child.newValue)}`;
+        }
+        else if (child.action === "add") {
+            valuePart = `: ${formatValue(child.newValue)}`;
+        }
+        else if (child.action === "remove") {
+            valuePart = ` (was: ${formatValue(child.oldValue)})`;
+        }
+        lines.push(style.color(`${indentStr}${style.symbol} ${child.name}${valuePart}`));
+    }
+    return lines;
+}
 /**
  * Recursively render tree nodes to formatted lines.
  */
@@ -135,44 +178,7 @@ function renderTree(node, indent = 0) {
             lines.push(...renderTree(child, indent + 1));
         }
         else {
-            // Leaf node with value
-            const hasComplexNew = isPlainObject(child.newValue) ||
-                (Array.isArray(child.newValue) &&
-                    child.newValue.some((v) => isPlainObject(v)));
-            const hasComplexOld = isPlainObject(child.oldValue) ||
-                (Array.isArray(child.oldValue) &&
-                    child.oldValue.some((v) => isPlainObject(v)));
-            if (child.action === "add" && hasComplexNew) {
-                lines.push(style.color(`${indentStr}${style.symbol} ${child.name}:`));
-                lines.push(...renderNestedValue(child.newValue, child.action, indent + 1));
-            }
-            else if (child.action === "remove" && hasComplexOld) {
-                lines.push(style.color(`${indentStr}${style.symbol} ${child.name} (removed):`));
-                lines.push(...renderNestedValue(child.oldValue, child.action, indent + 1));
-            }
-            else if (child.action === "change" &&
-                (hasComplexNew || hasComplexOld)) {
-                lines.push(style.color(`${indentStr}${style.symbol} ${child.name}:`));
-                if (hasComplexOld) {
-                    lines.push(...renderNestedValue(child.oldValue, "remove", indent + 1));
-                }
-                if (hasComplexNew) {
-                    lines.push(...renderNestedValue(child.newValue, "add", indent + 1));
-                }
-            }
-            else {
-                let valuePart = "";
-                if (child.action === "change") {
-                    valuePart = `: ${formatValue(child.oldValue)} → ${formatValue(child.newValue)}`;
-                }
-                else if (child.action === "add") {
-                    valuePart = `: ${formatValue(child.newValue)}`;
-                }
-                else if (child.action === "remove") {
-                    valuePart = ` (was: ${formatValue(child.oldValue)})`;
-                }
-                lines.push(style.color(`${indentStr}${style.symbol} ${child.name}${valuePart}`));
-            }
+            lines.push(...renderLeafNode(child, style, indentStr, indent));
         }
     }
     return lines;

package/dist/settings/rulesets/github-ruleset-strategy.js

@@ -1,6 +1,7 @@
 import { assertGitHubRepo } from "../../shared/repo-detector.js";
 import { camelToSnake } from "../../shared/string-utils.js";
-import { GhApiClient, parseApiJson, } from "../../shared/gh-api-utils.js";
+import { GhApiClient } from "../../shared/gh-api-utils.js";
+import { parseApiJson } from "../../shared/json-utils.js";
 /**
  * Converts camelCase config ruleset to snake_case GitHub API format.
  */

package/dist/settings/rulesets/processor.js

@@ -68,7 +68,6 @@ export class RulesetProcessor {
                     }
                     break;
                 case "unchanged":
-                    // No action needed
                     break;
             }
         }

package/dist/shared/gh-api-utils.d.ts

@@ -31,12 +31,19 @@ export declare class GhApiClient {
     constructor(executor: ICommandExecutor, retries: number, cwd: string);
     call(method: HttpMethod, endpoint: string, params?: GhApiCallParams): Promise<string>;
 }
+export interface ResolveGitHubTokenOptions {
+    repoInfo: GitHubRepoInfo;
+    tokenManager: ITokenManager | null;
+    context: string;
+    log?: DebugLog;
+    envToken?: string;
+}
 /**
  * Resolve a GitHub token for a repo: GitHub App token → envToken fallback.
  * Returns { token, skipped } where skipped=true means no App installation found
  * for this owner (token will be undefined). Both sync and settings paths use this.
  */
-export declare function resolveGitHubToken(repoInfo: GitHubRepoInfo, tokenManager: ITokenManager | null, context: string, log?: DebugLog, envToken?: string): Promise<{
+export declare function resolveGitHubToken(options: ResolveGitHubTokenOptions): Promise<{
     token: string | undefined;
     skipped: boolean;
 }>;
@@ -44,10 +51,4 @@ export declare function resolveGitHubToken(repoInfo: GitHubRepoInfo, tokenManage
  * Check if an error message indicates an HTTP 404 response from the GitHub API.
  */
 export declare function isHttp404Error(error: unknown): boolean;
-/**
- * Parse a JSON API response with a contextual error message.
- * Wraps JSON.parse so callers get "Failed to parse <context>: ..." instead of
- * a bare "Unexpected token" SyntaxError.
- */
-export declare function parseApiJson<T>(response: string, context: string): T;
 export {};

package/dist/shared/gh-api-utils.js

@@ -1,7 +1,6 @@
 import { escapeShellArg } from "./shell-utils.js";
 import { withRetry } from "./retry-utils.js";
 import { toErrorMessage } from "./type-guards.js";
-import { SyncError } from "./errors.js";
 /**
  * Get the hostname flag for gh commands.
  * Returns "--hostname HOST" for GHE, empty string for github.com.
@@ -78,7 +77,8 @@ export class GhApiClient {
  * Returns { token, skipped } where skipped=true means no App installation found
  * for this owner (token will be undefined). Both sync and settings paths use this.
  */
-export async function resolveGitHubToken(repoInfo, tokenManager, context, log, envToken) {
+export async function resolveGitHubToken(options) {
+    const { repoInfo, tokenManager, context, log, envToken } = options;
     try {
         const appToken = await tokenManager?.getTokenForRepo(repoInfo);
         if (appToken === null) {
@@ -102,17 +102,3 @@ export async function resolveGitHubToken(repoInfo, tokenManager, context, log, e
 export function isHttp404Error(error) {
     return toErrorMessage(error).includes("HTTP 404");
 }
-/**
- * Parse a JSON API response with a contextual error message.
- * Wraps JSON.parse so callers get "Failed to parse <context>: ..." instead of
- * a bare "Unexpected token" SyntaxError.
- */
-export function parseApiJson(response, context) {
-    try {
-        return JSON.parse(response);
-    }
-    catch (error) {
-        const preview = response.slice(0, 200);
-        throw new SyncError(`Failed to parse ${context}: ${toErrorMessage(error)} — ${preview}`);
-    }
-}

package/dist/shared/interpolation-engine.d.ts

@@ -28,4 +28,7 @@ export declare function interpolateString(value: string, config: InterpolationCo
 /**
  * Recursively process a value, interpolating strings within objects and arrays.
  */
+export declare function interpolateValue(value: string, config: InterpolationConfig): string;
+export declare function interpolateValue(value: unknown[], config: InterpolationConfig): unknown[];
+export declare function interpolateValue(value: Record<string, unknown>, config: InterpolationConfig): Record<string, unknown>;
 export declare function interpolateValue(value: unknown, config: InterpolationConfig): unknown;

package/dist/shared/interpolation-engine.js

@@ -28,9 +28,6 @@ export function interpolateString(value, config) {
     });
     return processed;
 }
-/**
- * Recursively process a value, interpolating strings within objects and arrays.
- */
 export function interpolateValue(value, config) {
     if (typeof value === "string") {
         return interpolateString(value, config);

package/dist/shared/json-utils.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Parse a JSON API response with a contextual error message.
+ * Wraps JSON.parse so callers get "Failed to parse <context>: ..." instead of
+ * a bare "Unexpected token" SyntaxError.
+ */
+export declare function parseApiJson<T>(response: string, context: string): T;

package/dist/shared/json-utils.js

@@ -0,0 +1,16 @@
+import { toErrorMessage } from "./type-guards.js";
+import { SyncError } from "./errors.js";
+/**
+ * Parse a JSON API response with a contextual error message.
+ * Wraps JSON.parse so callers get "Failed to parse <context>: ..." instead of
+ * a bare "Unexpected token" SyntaxError.
+ */
+export function parseApiJson(response, context) {
+    try {
+        return JSON.parse(response);
+    }
+    catch (error) {
+        const preview = response.slice(0, 200);
+        throw new SyncError(`Failed to parse ${context}: ${toErrorMessage(error)} — ${preview}`);
+    }
+}

package/dist/shared/repo-detector.js

@@ -83,7 +83,6 @@ function isGitLabStyleUrl(gitUrl) {
     return false;
 }
 export function detectRepoType(gitUrl, context) {
-    // Check for GitHub Enterprise hosts first (if configured)
     if (context?.githubHosts?.length) {
         const host = extractHostFromUrl(gitUrl)?.toLowerCase();
         const normalizedHosts = context.githubHosts.map((h) => h.toLowerCase());
@@ -91,19 +90,16 @@ export function detectRepoType(gitUrl, context) {
             return "github";
         }
     }
-    // Check for Azure DevOps formats (most specific patterns)
     for (const pattern of AZURE_DEVOPS_URL_PATTERNS) {
         if (pattern.test(gitUrl)) {
             return "azure-devops";
         }
     }
-    // Check for GitHub formats
     for (const pattern of GITHUB_URL_PATTERNS) {
         if (pattern.test(gitUrl)) {
             return "github";
         }
     }
-    // Check for GitLab SaaS formats
     for (const pattern of GITLAB_SAAS_URL_PATTERNS) {
         if (pattern.test(gitUrl)) {
             return "gitlab";

package/dist/shared/xfg-template.d.ts

@@ -40,5 +40,8 @@ interface XfgInterpolationOptions {
  * @param options - Interpolation options (default: strict mode)
  * @returns Content with interpolated values
  */
+export declare function interpolateXfgContent(content: string, ctx: XfgTemplateContext, options?: XfgInterpolationOptions): string;
+export declare function interpolateXfgContent(content: string[], ctx: XfgTemplateContext, options?: XfgInterpolationOptions): string[];
+export declare function interpolateXfgContent(content: Record<string, unknown>, ctx: XfgTemplateContext, options?: XfgInterpolationOptions): Record<string, unknown>;
 export declare function interpolateXfgContent(content: TemplateContent, ctx: XfgTemplateContext, options?: XfgInterpolationOptions): TemplateContent;
 export {};