export interface SpecAnnotation {
    type: 'module' | 'api' | 'entity' | 'dependency' | 'scope';
    value: string;
    file: string;
    line: number;
}
export interface ModuleGroup {
    name: string;
    directory: string;
    files: string[];
    apis: string[];
    entities: string[];
    dependencies: string[];
}
/**
 * 扫描单个文件的 Spec 注释标记
 */
export declare function extractAnnotations(filePath: string): Promise<SpecAnnotation[]>;
/**
 * 从注释标记构建模块分组
 */
export declare function buildModuleGroups(annotations: SpecAnnotation[]): ModuleGroup[];
/**
 * 根据需求描述查找对应模块（用于精准读取）
 */
export declare function matchModule(requirement: string, modules: ModuleGroup[]): ModuleGroup | null;
/**
 * 自动发现项目根目录（多工程场景）
 */
export declare function discoverProjectRoots(cwd: string): Promise<string[]>;
/**
 * 生成模块清单报告
 */
export declare function generateModuleReport(modules: ModuleGroup[]): string;
//# sourceMappingURL=spec-annotations.d.ts.map