import { MultiDbManager } from '../core/multi-db-manager';
import { EntityReference } from '../models/entity-reference';
import { Evidence } from '../models/evidence';
/**
 * System explanation interface.
 * Describes what the system is, how it works, and entry points.
 */
export interface SystemExplanation {
    what_am_i: string;
    how_do_i_work: string;
    dimensions: Array<{
        id: 'X' | 'Y' | 'Z' | 'W' | 'T' | 'V';
        name: string;
        description: string;
        entity_count?: number;
    }>;
    entry_points: Array<EntityReference & {
        reason?: string;
    }>;
    architecture_adrs: Array<{
        adr_number: string;
        title: string;
    }>;
    suggested_start: string;
    evidence?: Evidence;
}
/**
 * System overview interface.
 */
export interface SystemOverview {
    total_modules: number;
    total_symbols: number;
    total_dependencies: number;
    total_adrs: number;
    total_change_reports: number;
    entry_points: Array<EntityReference & {
        reason?: string;
    }>;
    architecture_adrs: Array<{
        adr_number: string;
        title: string;
    }>;
    evidence?: Evidence;
}
/**
 * API for system self-explanation.
 * Provides meta-information about the system WITHOUT AI generation.
 */
export declare class SelfExplanationApi {
    private dbManager;
    private adrApi;
    private moduleApi;
    private symbolApi;
    private dependencyApi;
    private changeApi;
    private evidenceGrader;
    constructor(dbManager: MultiDbManager);
    /**
     * Gets system overview with statistics and entry points.
     */
    getSystemOverview(pluginId: string): Promise<SystemOverview>;
    /**
     * Explains the system: what it is, how it works, entry points, and architecture ADRs.
     * REQUIRED: Must NOT throw if DB files/tables are missing. If DB queries fail, treat as Mode A (No Data).
     */
    explainSystem(pluginId: string): Promise<SystemExplanation>;
    /**
     * Gets entry points for the system.
     */
    private getEntryPoints;
    /**
     * Gets architecture ADRs (typically ADR-001, ADR-002, etc.).
     */
    private getArchitectureAdrs;
    /**
     * Identifies the system by reading package.json, README.md, or inferring from data.
     * Returns system name, description, source, evidence grade, and source path (for FACT sources).
     */
    private identifySystem;
}
//# sourceMappingURL=self-explanation-api.d.ts.map