/**
 * Canonical Metadata Paths for JIRA Issue Keys
 *
 * Single source of truth for reading/writing JIRA issue keys in metadata.
 * All plugin files MUST use these helpers instead of direct property access.
 *
 * Canonical path: external_sync.jira.issueKey
 * Legacy paths (read-only fallback): jira.issue, jira.issueKey
 *
 * @module metadata-paths
 */
/** Canonical dot-path for JIRA issue key in metadata */
export declare const CANONICAL_JIRA_KEY_PATH = "external_sync.jira.issueKey";
/**
 * Read JIRA issue key from metadata, checking canonical path first
 * then falling back to legacy paths for backward compatibility.
 */
export declare function readIssueKey(metadata: any): string | null;
/**
 * Write JIRA issue key to the canonical metadata path.
 * Creates intermediate objects if needed.
 */
export declare function writeIssueKey(metadata: any, key: string): any;
/**
 * Migrate legacy metadata paths to canonical path.
 * Reads from legacy, writes to canonical, optionally cleans up legacy keys.
 */
export declare function migrateToCanonical(metadata: any, cleanup?: boolean): any;
//# sourceMappingURL=metadata-paths.d.ts.map