/**
 * Backwards-compatibility mapping for pre-annotation synced files.
 *
 * Files generated before the annotation-driven sync format have `#`-level
 * section headings with no `<!-- ado-field: ... -->` comment. We can still
 * parse them by matching known headings against a fixed refname table.
 *
 * Type-aware: Bug work items historically used `# Description` for what is
 * semantically Repro Steps. After upgrade, a Bug's `# Description` section
 * maps to `Microsoft.VSTS.TCM.ReproSteps`, not `System.Description`.
 */
export interface LegacyHeadingRule {
    heading: string;
    refname: string;
    /** Optional type filter — if set, only applies when workItemType matches. */
    typeFilter?: string;
}
/**
 * Ordered list of legacy heading → refname rules.
 * First matching rule wins.
 *
 * Evaluated in order — bug-specific rules come before generic rules for
 * the same heading.
 */
export declare const LEGACY_HEADING_RULES: LegacyHeadingRule[];
/**
 * Resolve a legacy heading to an ADO refname given the work item type.
 * Returns null if the heading has no known mapping (section stays local-only).
 */
export declare function resolveLegacyHeading(heading: string, workItemType: string): string | null;
/**
 * Override the default custom-field refnames from env vars. Preserved so that
 * existing installs relying on `AZUREDEVOPS_SYNC_FIELD_*` env vars still parse
 * their legacy files correctly. New installs should use templates instead.
 */
export declare function applyLegacyEnvOverrides(): void;
//# sourceMappingURL=legacy-mappings.d.ts.map