import type { KnowledgeCoverageGap, KnowledgeReadiness, KnowledgeSourceCatalogEntry, KnowledgeSourceSchema, KnowledgeTaskKind } from '@devflow-tools/sdk';
import type { CompiledKnowledgeSource } from './knowledge-compiler.js';
import type { KnowledgeStore } from './knowledge-store.js';
import type { CreateKnowledgeSourceSchemaInput, SourceCatalog } from './source-catalog.js';
import { type KnowledgeSourceAggregateV1, type KnowledgeSourceIdentityV1 } from './knowledge-source-lifecycle.js';
export interface PublishKnowledgeSourceInput {
    compiled: CompiledKnowledgeSource;
    schema: KnowledgeSourceSchema;
    embeddings?: Float32Array[];
    refreshJobId?: string;
    previousHealthyRevisionRetained?: boolean;
    operationTimestamp: number;
}
export declare class KnowledgeSourceService {
    private readonly store;
    private readonly catalog;
    private readonly projectRoot;
    constructor(store: KnowledgeStore, catalog: SourceCatalog, projectRoot: string);
    registerSourceSchema(input: CreateKnowledgeSourceSchemaInput, operationTimestamp?: number): KnowledgeSourceSchema;
    recordCoverageGap(input: Omit<KnowledgeCoverageGap, 'id' | 'projectId' | 'detectedAt'> & {
        detectedAt?: number;
    }): KnowledgeCoverageGap;
    requireCoverage(input: {
        sourceId: string;
        entity?: string;
        symbol?: string;
        requiredVersion?: string;
        taskKind?: KnowledgeTaskKind;
    }): KnowledgeCoverageGap | null;
    publishCompiledSource(input: PublishKnowledgeSourceInput): {
        identity: KnowledgeSourceIdentityV1;
        aggregate: KnowledgeSourceAggregateV1;
        entry: KnowledgeSourceCatalogEntry;
        snapshotId: string;
        changed: boolean;
        claimCount: number;
        documentsRetired: number;
    };
    activateExistingRevision(input: {
        schema: KnowledgeSourceSchema;
        sourceLocator: string;
        version?: string;
        contentHash: string;
        documents: number;
        entities: string[];
        symbols: string[];
        operationTimestamp: number;
    }): KnowledgeSourceCatalogEntry;
    refreshIndexReadiness(entry: KnowledgeSourceCatalogEntry, operationTimestamp?: number): KnowledgeReadiness;
    quarantineRevision(input: {
        pageId: string;
        sourceId: string;
        contentHash: string;
        reason: string;
        expectedVersion?: string;
    }): ReturnType<KnowledgeStore['quarantineSourceRevision']>;
    getClaims(sourceId?: string): import("./knowledge-source-lifecycle.js").KnowledgeClaimV1[];
    private identityFor;
    private ensureRefreshStarted;
    private transition;
    private deriveReadiness;
    private resolveCoveredGaps;
    private recordFailure;
    private logTransitions;
}
//# sourceMappingURL=knowledge-source-service.d.ts.map