import type { Catalog } from "./model.js";
import type { Diagnostic } from "./types/diagnostics.js";
import type { ParsedDocument } from "./types/metadata.js";
export declare const CONTEXT_LENS_DIAGNOSTIC_CODES: {
    readonly UNSUPPORTED_LEGACY_FIELD: "CONTEXT-LENS-UNSUPPORTED-LEGACY-FIELD";
    readonly DUPLICATE_ID: "CONTEXT-LENS-DUPLICATE-ID";
    readonly EMPTY_DEFINITION: "CONTEXT-LENS-EMPTY-DEFINITION";
    readonly GOVERNANCE_MEANINGLESS: "CONTEXT-LENS-GOVERNANCE-MEANINGLESS";
    readonly MISSING_REQUIRED_FIELD: "CONTEXT-LENS-MISSING-REQUIRED-FIELD";
    readonly PATH_NORMALIZATION_MISMATCH: "CONTEXT-LENS-PATH-NORMALIZATION-MISMATCH";
    readonly TARGET_NOT_CONTEXT: "CONTEXT-LENS-TARGET-NOT-CONTEXT";
    readonly TARGET_NOT_FOUND: "CONTEXT-LENS-TARGET-NOT-FOUND";
    readonly UNPARSEABLE_FRONTMATTER: "CONTEXT-LENS-UNPARSEABLE-FRONTMATTER";
    readonly UNSUPPORTED_KIND: "CONTEXT-LENS-UNSUPPORTED-KIND";
    readonly UNSUPPORTED_SCOPE: "CONTEXT-LENS-UNSUPPORTED-SCOPE";
    readonly UNSUPPORTED_VERSION: "CONTEXT-LENS-UNSUPPORTED-VERSION";
};
export interface ContextLensDiagnosticCounts {
    error: number;
    warning: number;
    info: number;
}
export interface ContextLensItemSummary {
    id: string;
    path: string;
    valid: boolean;
    scope: string;
    targets: string[];
    targetPaths: string[];
    diagnosticCounts: ContextLensDiagnosticCounts;
    diagnosticCodes: string[];
}
export interface ContextLensSummary {
    enabled: boolean;
    detected: boolean;
    totalLensCount: number;
    validLensCount: number;
    invalidLensCount: number;
    diagnosticCounts: ContextLensDiagnosticCounts;
    representativeDiagnosticCode?: string;
    definitionPaths: string[];
    targetReferences: string[];
    targetPaths: string[];
    unresolvedTargetReferences: string[];
    scopeSummary: Array<{
        scope: string;
        count: number;
    }>;
    lenses: ContextLensItemSummary[];
}
export interface ContextLensReport {
    summary: ContextLensSummary;
    diagnostics: Diagnostic[];
}
/** Deterministically summarize and validate Context Lens governance state. */
export declare function summarizeContextLensGovernance(documents: ParsedDocument[], catalog: Catalog): ContextLensReport;
export declare function zeroContextLensSummary(): ContextLensSummary;