/**
 * Parent Change Handler
 *
 * Detects and handles parent changes during re-import.
 *
 * @module importers/item-converter/parent-change-handler
 * @since v1.0.115
 */
import type { ExternalIdReference } from '../duplicate-detector.js';
import type { ExternalItem } from './types.js';
/**
 * Check if parent has changed between existing reference and new item
 *
 * CRITICAL (2025-12-01): Detects orphan → has parent, or parent ID change
 *
 * @param existingRef - Existing reference from living docs
 * @param newItem - New item being imported
 * @returns True if parent has changed and file should be moved
 */
export declare function hasParentChanged(existingRef: ExternalIdReference, newItem: ExternalItem): boolean;
/**
 * Update parent metadata in file content
 */
export declare function updateParentMetadataInContent(content: string, newParentId: string | undefined, newFeatureId: string, isOrphan: boolean): string;
export interface MoveFileResult {
    moved: boolean;
    newFilePath?: string;
    reason?: string;
}
/**
 * Move user story file to new feature folder
 */
export declare function moveUserStoryFile(oldFilePath: string, newFeatureId: string, baseDir: string, newParentId: string | undefined): Promise<MoveFileResult>;
//# sourceMappingURL=parent-change-handler.d.ts.map