import type { SpecOverview } from '../orient.types.js';
/**
 * @purpose Scan specs/ directory and build overview of spec files with their task references.
 * @invariant Recursively walks specs/, parses task files to link specs to task IDs.
 * @param projectRoot Absolute project root path.
 * @returns Array of SpecOverview entries.
 */
export declare function loadSpecOverview(projectRoot: string): SpecOverview[];
/**
 * @purpose Search for a specific spec file by name and return its tasks-to-files mapping.
 * @param projectRoot Absolute project root path.
 * @param specName Spec file name to search for.
 * @returns Spec overview entry or null if not found.
 */
export declare function searchSpec(projectRoot: string, specName: string): SpecOverview | null;