@devflow-tools/knowledge-engine 0.17.8 → 0.18.0

package/dist/knowledge-source-service.js

@@ -0,0 +1,444 @@
+import { emitSemanticControlLog } from '@devflow-tools/telemetry';
+import { compileKnowledgeClaims, createKnowledgeSourceIdentityV1, reduceKnowledgeSource, } from './knowledge-source-lifecycle.js';
+export class KnowledgeSourceService {
+    store;
+    catalog;
+    projectRoot;
+    constructor(store, catalog, projectRoot) {
+        this.store = store;
+        this.catalog = catalog;
+        this.projectRoot = projectRoot;
+    }
+    registerSourceSchema(input, operationTimestamp = Date.now()) {
+        this.catalog.refreshProjectProfile({ generatedAt: operationTimestamp });
+        return this.catalog.registerSourceSchema(input, operationTimestamp);
+    }
+    recordCoverageGap(input) {
+        return this.catalog.recordCoverageGap(input);
+    }
+    requireCoverage(input) {
+        return this.catalog.requireCoverage(input);
+    }
+    publishCompiledSource(input) {
+        const identity = this.identityFor(input.compiled, input.schema);
+        const embeddings = input.embeddings ?? [];
+        const current = this.store.getSourceAggregate(identity.identityHash);
+        const active = this.store.listActiveCatalogEntries(this.catalog.projectId).find(entry => entry.sourceId === identity.sourceId
+            && entry.schemaId === input.schema.id
+            && entry.contentHash === input.compiled.page.contentHash);
+        const replayable = current?.contentHash === input.compiled.page.contentHash
+            && (current.state === 'ready' || (current.state === 'degraded' && embeddings.length === 0));
+        if (replayable && active?.activeRevisionId) {
+            return {
+                identity,
+                aggregate: current,
+                entry: active,
+                snapshotId: active.activeRevisionId,
+                changed: false,
+                claimCount: this.store.listKnowledgeClaims(identity.sourceId)
+                    .filter(claim => claim.sourceContentHash === input.compiled.page.contentHash).length,
+                documentsRetired: 0,
+            };
+        }
+        const refreshJobId = input.refreshJobId
+            ?? this.catalog.beginRefresh(identity.sourceId, input.compiled.page.contentHash, input.operationTimestamp).id;
+        const transitions = [];
+        try {
+            const result = this.store.transaction(() => {
+                this.ensureRefreshStarted(identity, input.compiled.page.contentHash, transitions, input.operationTimestamp);
+                this.store.recordImmutableRawSource({
+                    projectId: this.catalog.projectId,
+                    sourceId: identity.sourceId,
+                    contentHash: input.compiled.page.contentHash,
+                    sourceUri: input.compiled.page.provenance.sourceUri,
+                    sourceVersion: input.compiled.page.version,
+                    metadata: {
+                        sourceKind: identity.sourceKind,
+                        sourceSchemaId: input.schema.id,
+                        identityHash: identity.identityHash,
+                    },
+                    retrievedAt: input.compiled.page.provenance.retrievedAt,
+                });
+                this.transition(identity, 'fetched', input.compiled.page.contentHash, 'source_content_verified', transitions, undefined, input.operationTimestamp);
+                this.store.publishCompiledSource({
+                    page: input.compiled.page,
+                    chunks: input.compiled.chunks,
+                    manifest: input.compiled.analysis.manifest,
+                    quarantined: input.compiled.analysis.quarantined,
+                    operationTimestamp: input.operationTimestamp,
+                });
+                const documentsRetired = this.store.deactivateSourceDocuments(identity.sourceId, input.compiled.page.id);
+                this.transition(identity, 'compiled', input.compiled.page.contentHash, 'semantic_artifacts_validated', transitions, undefined, input.operationTimestamp);
+                if (embeddings.length > 0) {
+                    if (embeddings.length !== input.compiled.chunks.length) {
+                        throw new Error(`KNOWLEDGE_EMBEDDING_COUNT_MISMATCH:${embeddings.length}:${input.compiled.chunks.length}`);
+                    }
+                    this.store.insertEmbeddingBatch(input.compiled.chunks.map((chunk, index) => ({
+                        id: chunk.id,
+                        embedding: embeddings[index],
+                    })));
+                    this.transition(identity, 'indexed', input.compiled.page.contentHash, 'derived_indexes_published', transitions, undefined, input.operationTimestamp);
+                }
+                const readiness = this.deriveReadiness({
+                    sourceId: identity.sourceId,
+                    contentHash: input.compiled.page.contentHash,
+                    documents: 1,
+                    previousHealthyRevisionRetained: input.previousHealthyRevisionRetained ?? false,
+                    operationTimestamp: input.operationTimestamp,
+                });
+                const activated = this.catalog.activateSource({
+                    schemaId: input.schema.id,
+                    version: input.compiled.page.version,
+                    contentHash: input.compiled.page.contentHash,
+                    readiness,
+                    entities: [identity.sourceId, ...input.compiled.page.entities],
+                    symbols: input.compiled.page.symbols,
+                    taskKinds: input.schema.supportedTaskKinds,
+                    refreshJobId,
+                    operationTimestamp: input.operationTimestamp,
+                });
+                const claimCount = this.store.insertKnowledgeClaims(compileKnowledgeClaims({
+                    identity,
+                    page: input.compiled.page,
+                    manifest: input.compiled.analysis.manifest,
+                }));
+                const terminalState = readiness.status === 'ready' ? 'ready' : 'degraded';
+                const aggregate = this.transition(identity, terminalState, input.compiled.page.contentHash, readiness.status === 'ready' ? 'source_ready' : 'source_degraded', transitions, readiness, input.operationTimestamp);
+                this.store.refreshSourceReadiness({ [identity.sourceId]: input.compiled.page.version }, input.operationTimestamp);
+                this.resolveCoveredGaps(activated.entry);
+                return { ...activated, aggregate, claimCount, documentsRetired };
+            });
+            this.logTransitions(identity, transitions);
+            return { identity, ...result };
+        }
+        catch (error) {
+            this.catalog.failRefresh(refreshJobId, error, input.operationTimestamp);
+            this.recordFailure(identity, input.compiled.page.contentHash, error, input.operationTimestamp);
+            throw error;
+        }
+    }
+    activateExistingRevision(input) {
+        const identity = createKnowledgeSourceIdentityV1({
+            projectId: this.catalog.projectId,
+            sourceId: input.schema.sourceId,
+            sourceKind: input.schema.sourceKind,
+            sourceLocator: input.sourceLocator,
+            authority: input.schema.authority,
+            version: input.version,
+            versionPolicy: input.schema.versionPolicy,
+            ...(input.schema.sourceKind === 'dependency'
+                ? { packageName: input.schema.sourceId.replace(/^dependency:/u, '') }
+                : { framework: input.schema.sourceId }),
+        });
+        const readiness = this.deriveReadiness({
+            sourceId: input.schema.sourceId,
+            contentHash: input.contentHash,
+            documents: input.documents,
+            previousHealthyRevisionRetained: false,
+            operationTimestamp: input.operationTimestamp,
+        });
+        const current = this.store.getSourceAggregate(identity.identityHash);
+        const active = this.store.listActiveCatalogEntries(this.catalog.projectId).find(entry => entry.sourceId === input.schema.sourceId
+            && entry.schemaId === input.schema.id
+            && entry.contentHash === input.contentHash);
+        const targetState = readiness.status === 'ready' ? 'ready' : 'degraded';
+        if (current?.state === targetState && current.contentHash === input.contentHash
+            && active && readinessEquivalent(active.readiness, readiness)) {
+            return active;
+        }
+        const transitions = [];
+        const result = this.store.transaction(() => {
+            this.ensureRefreshStarted(identity, input.contentHash, transitions, input.operationTimestamp);
+            this.transition(identity, 'fetched', input.contentHash, 'persisted_source_recovered', transitions, undefined, input.operationTimestamp);
+            this.transition(identity, 'compiled', input.contentHash, 'persisted_artifacts_validated', transitions, undefined, input.operationTimestamp);
+            if (this.store.countEmbeddings(input.schema.sourceId) > 0) {
+                this.transition(identity, 'indexed', input.contentHash, 'persisted_indexes_validated', transitions, undefined, input.operationTimestamp);
+            }
+            const activated = this.catalog.activateSource({
+                schemaId: input.schema.id,
+                version: input.version,
+                contentHash: input.contentHash,
+                readiness,
+                entities: input.entities,
+                symbols: input.symbols,
+                taskKinds: input.schema.supportedTaskKinds,
+                operationTimestamp: input.operationTimestamp,
+            });
+            this.transition(identity, readiness.status === 'ready' ? 'ready' : 'degraded', input.contentHash, 'persisted_source_activated', transitions, readiness, input.operationTimestamp);
+            this.store.refreshSourceReadiness({ [identity.sourceId]: input.version }, input.operationTimestamp);
+            this.resolveCoveredGaps(activated.entry);
+            return activated.entry;
+        });
+        this.logTransitions(identity, transitions);
+        return result;
+    }
+    refreshIndexReadiness(entry, operationTimestamp = Date.now()) {
+        const page = this.store.listChunks({ sources: [entry.sourceId], limit: 1 })[0];
+        const sourceLocator = page?.source_url || page?.url || `devflow://knowledge/${entry.sourceId}`;
+        const schema = this.store.getSourceSchema(entry.schemaId);
+        if (!schema)
+            throw new Error(`Knowledge source schema ${entry.schemaId} is not registered`);
+        const identity = createKnowledgeSourceIdentityV1({
+            projectId: this.catalog.projectId,
+            sourceId: entry.sourceId,
+            sourceKind: entry.sourceKind,
+            sourceLocator,
+            authority: entry.authority,
+            version: entry.version,
+            versionPolicy: schema.versionPolicy,
+            ...(entry.sourceKind === 'dependency'
+                ? { packageName: entry.sourceId.replace(/^dependency:/u, '') }
+                : { framework: entry.sourceId }),
+        });
+        const transitions = [];
+        const derived = this.deriveReadiness({
+            sourceId: entry.sourceId,
+            contentHash: entry.contentHash,
+            documents: entry.readiness.documents,
+            previousHealthyRevisionRetained: true,
+            operationTimestamp,
+        });
+        const current = this.store.getSourceAggregate(identity.identityHash);
+        const targetState = derived.status === 'ready' ? 'ready' : 'degraded';
+        if (current?.state === targetState && current.contentHash === entry.contentHash
+            && readinessEquivalent(entry.readiness, derived)) {
+            return entry.readiness;
+        }
+        const readiness = this.store.transaction(() => {
+            const persisted = this.store.getSourceAggregate(identity.identityHash);
+            if (!persisted) {
+                this.ensureRefreshStarted(identity, entry.contentHash, transitions, operationTimestamp);
+                this.transition(identity, 'fetched', entry.contentHash, 'persisted_source_recovered', transitions, undefined, operationTimestamp);
+                this.transition(identity, 'compiled', entry.contentHash, 'persisted_artifacts_validated', transitions, undefined, operationTimestamp);
+            }
+            if (this.store.countEmbeddings(entry.sourceId) > 0
+                && this.store.getSourceAggregate(identity.identityHash)?.state !== 'ready') {
+                this.transition(identity, 'indexed', entry.contentHash, 'vector_backfill_projected', transitions, undefined, operationTimestamp);
+            }
+            this.catalog.activateSource({
+                schemaId: entry.schemaId,
+                version: entry.version,
+                contentHash: entry.contentHash,
+                readiness: derived,
+                entities: entry.entities,
+                symbols: entry.symbols,
+                taskKinds: entry.taskKinds,
+                operationTimestamp,
+            });
+            this.transition(identity, derived.status === 'ready' ? 'ready' : 'degraded', entry.contentHash, derived.status === 'ready' ? 'vector_backfill_complete' : 'vector_backfill_pending', transitions, derived, operationTimestamp);
+            this.store.refreshSourceReadiness({ [entry.sourceId]: entry.version }, operationTimestamp);
+            return derived;
+        });
+        this.logTransitions(identity, transitions);
+        return readiness;
+    }
+    quarantineRevision(input) {
+        const page = this.store.getNormalizedPage(input.pageId);
+        if (!page || page.sourceId !== input.sourceId || page.contentHash !== input.contentHash) {
+            throw new Error('KNOWLEDGE_QUARANTINE_REVISION_MISMATCH');
+        }
+        const schema = this.store.getSourceSchema(page.sourceSchemaId);
+        const sourceKind = schema?.sourceKind ?? page.provenance.sourceKind;
+        const authority = schema?.authority
+            ?? (sourceKind === 'official' ? 'official'
+                : sourceKind === 'project' ? 'project'
+                    : sourceKind === 'dependency' || sourceKind === 'plugin' ? 'maintainer' : 'community');
+        const identity = createKnowledgeSourceIdentityV1({
+            projectId: this.catalog.projectId,
+            sourceId: page.sourceId,
+            sourceKind,
+            sourceLocator: page.provenance.sourceUri,
+            authority,
+            version: page.version,
+            versionPolicy: schema?.versionPolicy ?? { mode: 'unversioned' },
+            ...(sourceKind === 'dependency'
+                ? { packageName: page.sourceId.replace(/^dependency:/u, '') }
+                : { framework: page.sourceId }),
+        });
+        const current = this.store.getSourceAggregate(identity.identityHash);
+        if (current?.state === 'stale' && current.contentHash === page.contentHash) {
+            return {
+                pagesQuarantined: 0,
+                documentsDeactivated: 0,
+                catalogSnapshotsDeactivated: 0,
+                readinessSourcesDegraded: 0,
+            };
+        }
+        const transitions = [];
+        const changes = this.store.transaction(() => {
+            if (!this.store.getSourceAggregate(identity.identityHash)) {
+                this.ensureRefreshStarted(identity, page.contentHash, transitions, Date.now());
+                this.transition(identity, 'fetched', page.contentHash, 'persisted_source_recovered', transitions);
+                this.transition(identity, 'compiled', page.contentHash, 'persisted_artifacts_validated', transitions);
+            }
+            const result = this.store.quarantineSourceRevision({
+                projectId: this.catalog.projectId,
+                sourceId: input.sourceId,
+                pageId: input.pageId,
+                contentHash: input.contentHash,
+                reason: input.reason,
+                expectedVersion: input.expectedVersion,
+            });
+            this.transition(identity, 'stale', page.contentHash, 'source_revision_quarantined', transitions, {
+                status: 'degraded', documents: 0, chunks: 0, vectors: 0, coverage: 0,
+                lastAttempt: Date.now(),
+                degradation: {
+                    reason: input.reason,
+                    category: 'partial', recoverable: true, previousHealthyRevisionRetained: false,
+                },
+            });
+            return result;
+        });
+        this.logTransitions(identity, transitions);
+        return changes;
+    }
+    getClaims(sourceId) {
+        return this.store.listKnowledgeClaims(sourceId);
+    }
+    identityFor(compiled, schema) {
+        return createKnowledgeSourceIdentityV1({
+            projectId: this.catalog.projectId,
+            sourceId: compiled.page.sourceId,
+            sourceKind: schema.sourceKind,
+            sourceLocator: compiled.page.provenance.sourceUri,
+            authority: schema.authority,
+            version: compiled.page.version,
+            versionPolicy: schema.versionPolicy,
+            ...(schema.sourceKind === 'dependency'
+                ? { packageName: compiled.page.sourceId.replace(/^dependency:/u, '') }
+                : { framework: compiled.page.sourceId }),
+        });
+    }
+    ensureRefreshStarted(identity, contentHash, transitions, operationTimestamp) {
+        let current = this.store.getSourceAggregate(identity.identityHash);
+        if (!current)
+            current = this.transition(identity, 'discovered', contentHash, 'source_discovered', transitions, undefined, operationTimestamp);
+        if (current.state !== 'queued') {
+            this.transition(identity, 'queued', contentHash, 'source_refresh_queued', transitions, undefined, operationTimestamp);
+        }
+    }
+    transition(identity, to, contentHash, reasonCode, transitions, readiness, operationTimestamp = Date.now()) {
+        const current = this.store.getSourceAggregate(identity.identityHash);
+        if (current?.state === to && current.contentHash === contentHash
+            && (!readiness || JSON.stringify(current.readiness) === JSON.stringify(readiness))) {
+            return current;
+        }
+        const reduced = reduceKnowledgeSource(current, {
+            identity,
+            to,
+            contentHash,
+            readiness,
+            reasonCode,
+            createdAt: operationTimestamp,
+        });
+        this.store.appendSourceTransition({ aggregate: reduced.aggregate, transition: reduced.event });
+        transitions.push(reduced.event);
+        return reduced.aggregate;
+    }
+    deriveReadiness(input) {
+        const chunks = this.store.countChunks(input.sourceId);
+        const vectors = this.store.countEmbeddings(input.sourceId);
+        const coverage = chunks > 0 ? vectors / chunks : 0;
+        const now = input.operationTimestamp;
+        if (input.documents > 0 && chunks > 0 && coverage >= 0.95) {
+            return {
+                status: 'ready', activeContentHash: input.contentHash,
+                documents: input.documents, chunks, vectors, coverage,
+                lastSuccessfulRefresh: now, lastAttempt: now,
+            };
+        }
+        return {
+            status: 'degraded', activeContentHash: input.contentHash,
+            documents: input.documents, chunks, vectors, coverage,
+            lastAttempt: now,
+            degradation: {
+                reason: chunks === 0 ? 'compiled_source_empty' : 'vector_backfill_pending',
+                category: chunks === 0 ? 'compile_failed' : 'vector_degraded',
+                recoverable: true,
+                previousHealthyRevisionRetained: input.previousHealthyRevisionRetained,
+            },
+        };
+    }
+    resolveCoveredGaps(entry) {
+        for (const gap of this.store.listCoverageGaps(this.catalog.projectId)) {
+            if (gap.sourceId !== entry.sourceId)
+                continue;
+            if (gap.requiredVersion && major(gap.requiredVersion) !== major(entry.version))
+                continue;
+            if (gap.entity && !hasNormalized(entry.entities, gap.entity))
+                continue;
+            if (gap.symbol && !hasNormalized(entry.symbols, gap.symbol))
+                continue;
+            if (entry.readiness.status !== 'ready'
+                && !(entry.readiness.status === 'degraded' && entry.readiness.chunks > 0))
+                continue;
+            this.store.resolveCoverageGap(gap.id);
+        }
+    }
+    recordFailure(identity, contentHash, error, operationTimestamp) {
+        const transitions = [];
+        try {
+            this.store.transaction(() => {
+                const current = this.store.getSourceAggregate(identity.identityHash);
+                if (!current)
+                    this.transition(identity, 'discovered', contentHash, 'source_discovered', transitions, undefined, operationTimestamp);
+                const next = this.store.getSourceAggregate(identity.identityHash);
+                if (next?.state === 'ready' || next?.state === 'degraded')
+                    return;
+                this.transition(identity, 'failed', contentHash, 'source_publish_failed', transitions, {
+                    status: 'error', documents: 0, chunks: 0, vectors: 0, coverage: 0,
+                    lastAttempt: operationTimestamp,
+                    degradation: {
+                        reason: error instanceof Error ? error.message : String(error),
+                        category: 'compile_failed', recoverable: true, previousHealthyRevisionRetained: false,
+                    },
+                }, operationTimestamp);
+            });
+            this.logTransitions(identity, transitions);
+        }
+        catch {
+            // The original publication error remains authoritative.
+        }
+    }
+    logTransitions(identity, transitions) {
+        for (const transition of transitions) {
+            emitSemanticControlLog({
+                event: 'knowledge.source.transitioned',
+                identity: { projectRoot: this.projectRoot },
+                level: transition.to === 'failed' || transition.to === 'degraded' ? 'warn' : 'info',
+                timestamp: transition.createdAt,
+                data: {
+                    sourceId: identity.sourceId,
+                    sourceIdentityHash: identity.identityHash,
+                    eventId: transition.eventId,
+                    sequence: transition.sequence,
+                    from: transition.from,
+                    to: transition.to,
+                    contentHash: transition.contentHash,
+                    reasonCode: transition.reasonCode,
+                },
+            });
+        }
+    }
+}
+function hasNormalized(values, expected) {
+    const key = expected.normalize('NFKC').trim().toLocaleLowerCase('en-US');
+    return values.some(value => value.normalize('NFKC').trim().toLocaleLowerCase('en-US') === key);
+}
+function major(value) {
+    return value?.match(/\d+/u)?.[0];
+}
+function readinessEquivalent(left, right) {
+    return left.status === right.status
+        && left.activeContentHash === right.activeContentHash
+        && left.documents === right.documents
+        && left.chunks === right.chunks
+        && left.vectors === right.vectors
+        && left.coverage === right.coverage
+        && left.degradation?.reason === right.degradation?.reason
+        && left.degradation?.category === right.degradation?.category
+        && left.degradation?.recoverable === right.degradation?.recoverable
+        && left.degradation?.previousHealthyRevisionRetained
+            === right.degradation?.previousHealthyRevisionRetained;
+}
+//# sourceMappingURL=knowledge-source-service.js.map

package/dist/knowledge-source-service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"knowledge-source-service.js","sourceRoot":"","sources":["../src/knowledge-source-service.ts"],"names":[],"mappings":"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"}

package/dist/knowledge-store.d.ts

@@ -1,5 +1,6 @@
 import type { KnowledgeChunkKind } from './types.js';
-import type { KnowledgeChunk as CompiledKnowledgeChunk, KnowledgeCoverageGap, KnowledgeAnalysisManifest, KnowledgeSourceCatalogEntry, KnowledgeSourceSchema, NormalizedKnowledgePage, ProjectKnowledgeProfile } from '@devflow-tools/sdk';
+import type { EmbeddingProfileV1, KnowledgeChunk as CompiledKnowledgeChunk, KnowledgeCoverageGap, KnowledgeAnalysisManifest, KnowledgeSourceCatalogEntry, KnowledgeSourceSchema, NormalizedKnowledgePage, ProjectKnowledgeProfile } from '@devflow-tools/sdk';
+import type { KnowledgeClaimV1, KnowledgeSourceAggregateV1, KnowledgeSourceTransitionV1 } from './knowledge-source-lifecycle.js';
 export interface KnowledgeDocInput {
     id: string;
     source: string;
@@ -8,6 +9,7 @@ export interface KnowledgeDocInput {
     version?: string;
     contentHash?: string;
     chunkPolicyVersion?: number;
+    fetchedAt?: number;
 }
 export interface KnowledgeChunkInput {
     id: string;
@@ -42,7 +44,7 @@ export interface KnowledgeChunkRow {
     source_url: string | null;
     content_hash: string;
     page_id: string | null;
-    project_root: string;
+    project_id: string;
     heading_breadcrumbs: string;
     embedding_text: string;
     original_start: number | null;
@@ -66,11 +68,11 @@ export interface KnowledgeIndexHealth {
     emptyTitleCount: number;
 }
 export declare class KnowledgeStore {
+    private readonly embeddingProfile;
     private db;
-    constructor(dbPath: string);
-    private migrateQualitySchema;
-    private migrateCompiledKnowledgeSchema;
-    private ensureTrigramFts;
+    constructor(dbPath: string, embeddingProfile?: EmbeddingProfileV1);
+    private assertCanonicalSchemaOrEmpty;
+    private tableColumns;
     upsertDoc(doc: KnowledgeDocInput): void;
     clearChunks(docId: string): void;
     insertChunk(chunk: KnowledgeChunkInput): void;
@@ -99,6 +101,16 @@ export declare class KnowledgeStore {
         id: string;
         distance: number;
     }>;
+    getEmbeddingProfileState(source?: string): {
+        status: 'ready' | 'backfill_pending' | 'dimension_mismatch';
+        profileHash: string;
+        generation: number;
+        indexed: number;
+        total: number;
+    };
+    private putEmbeddingProfile;
+    private deleteEmbeddingProfile;
+    private assertEmbeddingProfile;
     getChunk(id: string): any;
     getDocChunks(source: string, limit?: number): any[];
     listChunks(options?: {
@@ -118,7 +130,7 @@ export declare class KnowledgeStore {
         chunks: number;
         vectors: number;
     }>;
-    refreshSourceReadiness(expectedVersions?: Record<string, string | undefined>): void;
+    refreshSourceReadiness(expectedVersions?: Record<string, string | undefined>, operationTimestamp?: number): void;
     getSourceReadiness(): Array<{
         source: string;
         expected_version: string | null;
@@ -134,12 +146,12 @@ export declare class KnowledgeStore {
     getDistinctSources(): string[];
     getIndexHealth(): KnowledgeIndexHealth;
     upsertProjectProfile(profile: ProjectKnowledgeProfile): boolean;
-    getProjectProfile(projectRoot: string): ProjectKnowledgeProfile | null;
+    getProjectProfile(projectId: string): ProjectKnowledgeProfile | null;
     upsertSourceSchema(schema: KnowledgeSourceSchema, now?: number): boolean;
     getSourceSchema(id: string): KnowledgeSourceSchema | null;
     listSourceSchemas(): KnowledgeSourceSchema[];
     activateCatalogEntry(input: {
-        projectRoot: string;
+        projectId: string;
         profileHash: string;
         entry: KnowledgeSourceCatalogEntry;
         activatedAt?: number;
@@ -147,9 +159,9 @@ export declare class KnowledgeStore {
         snapshotId: string;
         changed: boolean;
     };
-    listActiveCatalogEntries(projectRoot: string): KnowledgeSourceCatalogEntry[];
+    listActiveCatalogEntries(projectId: string): KnowledgeSourceCatalogEntry[];
     beginRefreshJob(input: {
-        projectRoot: string;
+        projectId: string;
         sourceId: string;
         inputContentHash: string;
         now?: number;
@@ -162,7 +174,7 @@ export declare class KnowledgeStore {
     failRefreshJob(id: string, error: string, now?: number): boolean;
     getRefreshJob(id: string): {
         id: string;
-        project_root: string;
+        project_id: string;
         source_id: string;
         input_content_hash: string;
         previous_snapshot_id: string | null;
@@ -174,18 +186,18 @@ export declare class KnowledgeStore {
     } | null;
     recordCoverageGap(gap: KnowledgeCoverageGap): boolean;
     resolveCoverageGap(id: string, resolvedAt?: number): boolean;
-    listCoverageGaps(projectRoot: string, options?: {
+    listCoverageGaps(projectId: string, options?: {
         includeResolved?: boolean;
     }): KnowledgeCoverageGap[];
     upsertNormalizedPage(page: NormalizedKnowledgePage): boolean;
-    replaceCompiledPage(page: NormalizedKnowledgePage, chunks: CompiledKnowledgeChunk[]): void;
+    replaceCompiledPage(page: NormalizedKnowledgePage, chunks: CompiledKnowledgeChunk[], operationTimestamp?: number): void;
     replaceKnowledgeAnalysisManifest(manifest: KnowledgeAnalysisManifest, quarantined: Array<{
         kind: string;
         value: string;
         reason: string;
-    }>): void;
+    }>, operationTimestamp?: number): void;
     recordImmutableRawSource(input: {
-        projectRoot: string;
+        projectId: string;
         sourceId: string;
         contentHash: string;
         sourceUri: string;
@@ -202,8 +214,39 @@ export declare class KnowledgeStore {
             value: string;
             reason: string;
         }>;
+        operationTimestamp: number;
     }): void;
     getNormalizedPage(id: string): NormalizedKnowledgePage | null;
+    transaction<T>(operation: () => T): T;
+    getSourceAggregate(identityHash: string): KnowledgeSourceAggregateV1 | null;
+    appendSourceTransition(input: {
+        aggregate: KnowledgeSourceAggregateV1;
+        transition: KnowledgeSourceTransitionV1;
+    }): {
+        replayed: boolean;
+    };
+    insertKnowledgeClaims(claims: KnowledgeClaimV1[]): number;
+    listKnowledgeClaims(sourceId?: string): KnowledgeClaimV1[];
+    quarantineSourceRevision(input: {
+        projectId: string;
+        sourceId: string;
+        pageId: string;
+        contentHash: string;
+        reason: string;
+        expectedVersion?: string;
+        updatedAt?: number;
+    }): {
+        pagesQuarantined: number;
+        documentsDeactivated: number;
+        catalogSnapshotsDeactivated: number;
+        readinessSourcesDegraded: number;
+    };
+    recordKnowledgeMaintenanceRun(input: {
+        id: string;
+        manifest: unknown;
+        createdAt: number;
+    }): void;
+    rebuildFullTextIndex(): void;
     private replacePageLinks;
     close(): void;
 }