import { type GraphEdgeKind } from "./graph-index.js";
export declare const CURRENT_WIKI_FORMAT = 4;
export type WikiFormatVersion = 1 | 2 | 3 | 4;
export type MigrationSourceNamespace = "knowledge_rail" | "llm_wiki" | "schema";
export interface LegacyManifestAssessment {
    status: "absent" | "invalid" | "current" | "stale";
    entryCount: number;
    exactMatches: number;
    metadataOnlyChanges: number;
    lineEndingEquivalentMatches: number;
    changedEntries: number;
    missingEntries: number;
    addedEntries: number;
    error?: string;
}
export interface WikiState {
    formatVersion: 4;
    artifactVersions: {
        manifest: 2;
        graph: 2;
        retrieval: 1;
        semantic: 1;
        codeEvidence: 1;
        sourceCoverage: 1;
    };
    migratedAt: string;
    migratedFrom: WikiFormatVersion;
}
export interface MigrationPlan {
    detectedVersion: WikiFormatVersion | "unknown";
    sourceNamespace: MigrationSourceNamespace;
    targetVersion: 4;
    steps: string[];
    warnings: string[];
    blockers: string[];
    changedFiles: string[];
    canonicalFileCount: number;
    pageCount: number;
    sourceCount: number;
    legacyManifest?: LegacyManifestAssessment;
}
export interface CanonicalFileSnapshot {
    path: string;
    size: number;
    sha256: string;
}
export interface CanonicalSnapshot {
    digest: string;
    files: CanonicalFileSnapshot[];
}
export interface LegacyCoverageEntry {
    sourceRef: string;
    normalizedSourceUri?: string;
    pageRefs: string[];
    verification: "existing_ledger" | "source_verified" | "source_unverified";
    status: "preserved" | "legacy_unverified";
    reason: string;
    ledgerRef?: string;
}
export interface LegacyCoverageReport {
    version: 1;
    generatedAt: string;
    state: "requires_reconciliation";
    entries: LegacyCoverageEntry[];
    enrichment: {
        status: "not_generated";
        proposalCount: 0;
    };
}
export interface MigrationProbeResult {
    path: string;
    query: string;
    recovered: boolean;
}
export interface MigrationRegressionReport {
    pageCount: number;
    sourceCount: number;
    retrieval: MigrationProbeResult[];
    documentContext: MigrationProbeResult[];
    graphLinks: Partial<Record<GraphEdgeKind, number>>;
}
export interface MigrationResult {
    plan: MigrationPlan;
    runId: string;
    backupDir: string;
    journalFile: string;
    coverageReportFile: string;
    canonicalDigest: string;
    regression: {
        before: MigrationRegressionReport;
        after: MigrationRegressionReport;
    };
}
export declare function migrateSchemaText(schema: string): string;
export declare function initializeWikiState(wikiRoot: string): Promise<void>;
export declare function detectWikiVersion(wikiRoot: string): Promise<WikiFormatVersion | "unknown">;
export declare function planWikiMigration(wikiRoot: string, targetVersion?: string): Promise<MigrationPlan>;
export declare function applyWikiMigration(wikiRoot: string, options: {
    targetVersion?: string;
    backup: boolean;
    projectRoot?: string;
}): Promise<MigrationResult>;
export declare function rollbackWikiMigration(wikiRoot: string, runId: string): Promise<{
    runId: string;
    status: "rolled_back";
    restoredFiles: number;
}>;
export declare function formatMigrationPlan(plan: MigrationPlan): string;
//# sourceMappingURL=migration-service.d.ts.map