import { KnowledgeAdapterRegistry, type AdapterRegistration } from "./adapter-registry.js";
import { type CodeImpactTarget, type CodeImpactResult, type CodeImportDiagnostics, type CodeEvidenceAdapterRosterEntry, type CodeEvidenceHit, type CodeEvidenceIndex, type CodeEvidenceSnapshot, type CodeEvidenceUpdateReport, type CodeReference, type CodeSearchOptions, type KnowledgeAdapter, type KnowledgeFragment, type ProjectStructure } from "./types.js";
export declare function codeEvidenceIndexFile(wikiRoot: string): string;
export declare function readCodeEvidenceSnapshot(wikiRoot: string, adapters?: readonly CodeEvidenceAdapterRosterEntry[]): Promise<CodeEvidenceSnapshot>;
/** Internal diagnostics for capacity checks; not part of the MCP tool payload. */
export declare function getCodeQueryCacheDiagnostics(wikiRoot: string): {
    cached: boolean;
    estimatedBytes: number;
    maxEstimatedBytes: number;
};
export declare function scoreFragment(fragment: KnowledgeFragment, queryNormalized: string, terms: readonly string[]): {
    score: number;
    matchedTerms: string[];
};
export declare function codeResourceUri(fragment: KnowledgeFragment): string;
export declare class PersistentCodeEvidenceIndex implements CodeEvidenceIndex {
    readonly repositoryRoot: string;
    readonly wikiRoot: string;
    readonly registry: KnowledgeAdapterRegistry;
    constructor(params: {
        repositoryRoot: string;
        wikiRoot: string;
        adapter?: KnowledgeAdapter;
        adapters?: readonly (KnowledgeAdapter | AdapterRegistration)[];
        registry?: KnowledgeAdapterRegistry;
    });
    snapshot(): Promise<CodeEvidenceSnapshot>;
    private queryRuntime;
    private ensureCurrentSnapshotSchema;
    rebuild(): Promise<CodeEvidenceUpdateReport>;
    updateFile(path: string): Promise<CodeEvidenceUpdateReport>;
    removeFile(path: string): Promise<CodeEvidenceUpdateReport>;
    private isProjectManifest;
    private invalidateProjectStructure;
    search(query: string, options?: CodeSearchOptions): Promise<CodeEvidenceHit[]>;
    symbol(name: string, options?: CodeSearchOptions): Promise<CodeEvidenceHit[]>;
    references(symbolId: string, options?: CodeSearchOptions): Promise<CodeReference[]>;
    relatedEvidence(symbolId: string): Promise<{
        candidates: import("./types.js").RelatedCodeEvidence[];
        truncated: boolean;
        generatedAt: string;
    }>;
    /** One snapshot and manifest refresh for a bounded batch of authored claims.
     * Per-target failures preserve successful proposals in the same generation. */
    relatedEvidenceBatch(symbolIds: readonly string[]): Promise<Map<string, PromiseSettledResult<{
        candidates: import("./types.js").RelatedCodeEvidence[];
        truncated: boolean;
        generatedAt: string;
    }>>>;
    private assertScopedSnapshot;
    /** Read-only context expansion. Shares the ordinary runtime/admission policy;
     * never rebuilds, updates source files or writes a snapshot on failure. */
    impact(targets: readonly CodeImpactTarget[]): Promise<CodeImpactResult>;
    referencesWithDiagnostics(symbolId: string, options?: CodeSearchOptions): Promise<{
        references: CodeReference[];
        targetPath?: string;
        manifestWarnings: ProjectStructure["warnings"];
        importDiagnostics: CodeImportDiagnostics;
    }>;
    private referenceQuery;
    /** Bounded callers may expose these warnings without changing existing hit shapes. */
    projectStructureWarnings(options?: {
        refresh?: boolean;
    }): Promise<ProjectStructure["warnings"]>;
}
//# sourceMappingURL=index.d.ts.map