import { MultiDbManager } from '../../core/multi-db-manager';
import { IdMapper } from '../../core/id-mapper';
/**
 * MCP Tool: gap_analysis
 * Finds documentation gaps by analyzing modules with many dependencies but few/no ADRs.
 */
export declare class GapAnalysisTool {
    private crossDimensionApi;
    private dependencyApi;
    private adrApi;
    private moduleApi;
    private dbManager;
    private idMapper;
    private workspaceRoot;
    constructor(dbManager: MultiDbManager, idMapper: IdMapper, workspaceRoot?: string);
    /**
     * Executes the gap_analysis tool.
     *
     * @param args Arguments: minDependencies (default: 5), pluginId, limit (default: 50), autoGenerateAdrs (default: false)
     * @returns JSON string with gap analysis results including context information for ADR generation by KI-Agent
     *
     * Note: autoGenerateAdrs is false by default. When false, the tool provides context information
     * (similar modules with ADRs, dependency details, cross-dimension context) to help the KI-Agent
     * create ADRs according to the schema defined in .cursor/rules/022-adr-workflow.mdc
     */
    execute(args: {
        minDependencies?: number;
        pluginId: string;
        limit?: number;
        autoGenerateAdrs?: boolean;
    }): Promise<string>;
    /**
     * Builds context information for ADR generation by KI-Agent.
     * Includes similar modules with ADRs, existing patterns, and cross-dimension context.
     */
    private buildAdrGenerationContext;
    /**
     * Calculates a gap score for prioritization.
     * Higher score = more urgent to document.
     *
     * Formula: (dependency_count * 2) - (adr_count * 10) - (hasApiDocs ? 50 : 0)
     * This prioritizes modules with many dependencies but few ADRs.
     * Module mit API-Docs sind bereits dokumentiert, daher großer Penalty (-50).
     * Da buildArchitecturalView nur Module aus X-Dimension zurückgibt, haben alle Module API-Docs.
     */
    private calculateGapScore;
    /**
     * Generates recommendations based on gaps.
     */
    private generateRecommendations;
    /**
     * Fallback: Direct database queries when buildArchitecturalView returns empty.
     * This handles cases where pluginId might not match or data structure differs.
     */
    private fallbackDirectQuery;
}
//# sourceMappingURL=gap-analysis.d.ts.map