export interface AnalyzeInput {
    /** 源码目录列表 */
    sources: string[];
    /** 需求文档路径列表 */
    requirements: string[];
    /** 输出范围 */
    scope: 'global' | 'iteration' | 'task';
    /** 迭代名称 (scope=iteration|task 必填) */
    iteration?: string;
    /** 任务 ID (scope=task 必填) */
    taskId?: string;
    /** 分析深度 */
    depth: 'quick' | 'normal' | 'deep';
    /** 输出文件名 */
    output?: string;
    /** 是否读取源码内容（默认 true） */
    readSource?: boolean;
    /** 指定源码扫描范围（逗号分隔目录） */
    sourceScope?: string;
}
export interface AnalysisResult {
    /** 输出文件路径 */
    outputPath: string;
    /** 报告内容 */
    report: string;
    /** 摘要统计 */
    summary: {
        issues: number;
        blockers: number;
        filesAnalyzed: number;
        apisFound: number;
        risks: number;
    };
}
export declare function runAnalysis(input: AnalyzeInput): Promise<AnalysisResult>;
/**
 * 局部分析：只分析单个功能模块，写入 020-specs/features/{feature}.md
 * 用于 --feature 模式，避免全量重跑
 */
export declare function analyzeSingleFeature(iterDir: string, featureName: string): Promise<{
    outputPath: string;
    report: string;
} | null>;
/**
 * 局部分析：单个类型文档（bugs/refactors/research）
 *
 * @param iterDir   迭代目录
 * @param docPath   类型路径，如 "bugs/login-timeout" 或 "refactors/db-pool"
 *                  对应 010-requirements/{typeDir}/{slug}.md
 */
export declare function analyzeSingleTypedDoc(iterDir: string, docPath: string): Promise<{
    outputPath: string;
    report: string;
} | null>;
export interface SupplementResult {
    outputPath: string;
    addedFiles: string[];
    totalRead: number;
    remainingUncovered: number;
}
/**
 * 补充分析：读取已有报告，找到未覆盖的源码文件，追加到报告中
 * 不重新生成全部文档，只追加源码内容
 */
export declare function supplementAnalysis(input: {
    reportPath: string;
    scope?: string;
    maxFiles?: number;
}): Promise<SupplementResult | null>;
export interface SpecGenerationResult {
    files: {
        filename: string;
        content: string;
    }[];
    summary: {
        total: number;
        withContent: number;
        skipped: number;
    };
}
/**
 * 从需求文档内容中提取结构化信息，生成有实质内容的 Spec 文件。
 * 用于 analyze --auto 模式，替代 init 创建的空模板。
 */
export declare function generateSpecsFromRequirements(reqPaths: string[], iteration: string, specDir: string): Promise<SpecGenerationResult>;
//# sourceMappingURL=analyze-engine.d.ts.map