/**
 * GapReportGenerator -- Identifies governance gaps in discovered agents.
 *
 * Maps missing controls to compliance framework requirements (SOC 2, HIPAA,
 * GDPR, PCI DSS, DORA, EU AI Act) and scores overall governance coverage.
 *
 * GATE 9: T-147
 *
 * @connexum/ai-governance
 */
import type { ScanResult, GovernanceStatus } from './index';
/** A missing governance control for a specific agent */
export interface MissingControl {
    /** Control identifier */
    controlId: string;
    /** Human-readable control name */
    name: string;
    /** What this control does */
    description: string;
    /** Severity of the gap: CRITICAL, HIGH, MEDIUM, LOW */
    severity: 'CRITICAL' | 'HIGH' | 'MEDIUM' | 'LOW';
    /** Which compliance frameworks require this control */
    frameworks: string[];
}
/** Gap details for a single agent */
export interface AgentGap {
    /** Agent name */
    name: string;
    /** Agent platform */
    platform: string;
    /** Agent file path */
    filePath: string;
    /** Current governance status */
    governanceStatus: GovernanceStatus;
    /** List of missing controls */
    missingControls: MissingControl[];
    /** Agent-level coverage score (0-100) */
    coverageScore: number;
}
/** Framework-level gap summary */
export interface FrameworkGap {
    /** Framework identifier (e.g., 'soc2', 'hipaa') */
    frameworkId: string;
    /** Framework display name */
    frameworkName: string;
    /** Requirements that are not met */
    unmetRequirements: Array<{
        requirementId: string;
        description: string;
        affectedAgents: string[];
    }>;
    /** Framework-level coverage percentage */
    coveragePercent: number;
}
/** A recommendation for improving governance */
export interface GapRecommendation {
    /** Priority order (1 = highest) */
    priority: number;
    /** Short title */
    title: string;
    /** Detailed description */
    description: string;
    /** Which agents this affects */
    affectedAgents: string[];
    /** Impact if addressed: 'high', 'medium', 'low' */
    impact: 'high' | 'medium' | 'low';
}
/** Complete gap analysis report */
export interface GapReport {
    /** Project directory analyzed */
    projectDir: string;
    /** ISO timestamp of report generation */
    generatedAt: string;
    /** Agents with governance gaps */
    agentGaps: AgentGap[];
    /** Framework-level gap analysis */
    frameworkGaps: FrameworkGap[];
    /** Overall governance coverage score (0-100) */
    overallScore: number;
    /** Prioritized recommendations */
    recommendations: GapRecommendation[];
}
export declare class GapReportGenerator {
    /**
     * Generate a gap report from scan results.
     *
     * @param scanResult - Output from AgentScanner.scan()
     * @param frameworks - Optional list of framework IDs to assess against (default: all)
     */
    generate(scanResult: ScanResult, frameworks?: string[]): GapReport;
    /**
     * Analyze a single agent for missing governance controls.
     */
    private analyzeAgentGaps;
    /**
     * Analyze gap coverage for a specific compliance framework.
     */
    private analyzeFrameworkGaps;
    /**
     * Compute overall governance coverage score.
     */
    private computeOverallScore;
    /**
     * Generate prioritized recommendations based on gaps found.
     */
    private generateRecommendations;
}
//# sourceMappingURL=gap-report.d.ts.map