@devflow-tools/knowledge-engine 0.17.8 → 0.18.0

package/dist/knowledge-source-lifecycle.js

@@ -0,0 +1,152 @@
+import { createHash } from 'node:crypto';
+const ALLOWED = {
+    discovered: new Set(['queued', 'failed']),
+    queued: new Set(['fetched', 'stale', 'failed']),
+    fetched: new Set(['compiled', 'stale', 'failed']),
+    compiled: new Set(['indexed', 'degraded', 'stale', 'failed']),
+    indexed: new Set(['ready', 'degraded', 'stale', 'failed']),
+    ready: new Set(['queued', 'degraded', 'stale']),
+    degraded: new Set(['queued', 'indexed', 'ready', 'stale', 'failed']),
+    stale: new Set(['queued', 'failed']),
+    failed: new Set(['queued']),
+};
+export function createKnowledgeSourceIdentityV1(input) {
+    const body = {
+        schemaVersion: 'knowledge-source-identity.v1',
+        identityVersion: 1,
+        projectId: input.projectId,
+        scope: { kind: 'project', id: input.projectId },
+        sourceId: input.sourceId.normalize('NFKC').trim(),
+        sourceKind: input.sourceKind,
+        normalizedLocator: normalizeSourceLocator(input.sourceLocator),
+        ...(input.framework?.trim() ? { framework: input.framework.normalize('NFKC').trim() } : {}),
+        ...(input.packageName?.trim() ? { packageName: input.packageName.normalize('NFKC').trim() } : {}),
+        ...(input.version?.trim() ? { version: input.version.normalize('NFKC').trim() } : {}),
+        ...(input.versionPolicy?.expectedVersion
+            ? { versionRange: input.versionPolicy.expectedVersion.normalize('NFKC').trim() }
+            : {}),
+        authority: input.authority,
+    };
+    return Object.freeze({ ...body, identityHash: stableHash(body) });
+}
+export function reduceKnowledgeSource(previous, input) {
+    if (previous && previous.identity.identityHash !== input.identity.identityHash) {
+        throw new Error('KNOWLEDGE_SOURCE_IDENTITY_MISMATCH');
+    }
+    if (!previous && input.to !== 'discovered')
+        throw new Error('KNOWLEDGE_SOURCE_MUST_START_DISCOVERED');
+    if (previous && previous.state !== input.to && !ALLOWED[previous.state].has(input.to)) {
+        throw new Error(`KNOWLEDGE_SOURCE_TRANSITION_INVALID:${previous.state}:${input.to}`);
+    }
+    const createdAt = input.createdAt ?? Date.now();
+    const sequence = (previous?.revision ?? 0) + 1;
+    const eventBody = {
+        identityHash: input.identity.identityHash,
+        sequence,
+        ...(previous ? { from: previous.state } : {}),
+        to: input.to,
+        ...(input.contentHash ? { contentHash: input.contentHash } : {}),
+        reasonCode: input.reasonCode,
+        createdAt,
+    };
+    const event = {
+        eventId: `knowledge-source-event:${stableHash(eventBody).slice(0, 32)}`,
+        ...eventBody,
+    };
+    const aggregateBody = {
+        schemaVersion: 'knowledge-source-aggregate.v1',
+        identity: input.identity,
+        state: input.to,
+        revision: sequence,
+        ...(input.contentHash ?? previous?.contentHash
+            ? { contentHash: input.contentHash ?? previous?.contentHash }
+            : {}),
+        ...(input.readiness ? { readiness: input.readiness } : previous?.readiness ? { readiness: previous.readiness } : {}),
+        lastEventId: event.eventId,
+        updatedAt: createdAt,
+    };
+    return {
+        event,
+        aggregate: { ...aggregateBody, aggregateHash: stableHash(aggregateBody) },
+    };
+}
+export function compileKnowledgeClaims(input) {
+    const claims = [];
+    const add = (subject, predicate, object, evidence, status = 'verified') => {
+        const verificationState = validateClaimEvidence(evidence, input.page.markdown)
+            ? 'source_bound'
+            : 'unverified';
+        const body = {
+            schemaVersion: 'knowledge-claim.v1',
+            identityHash: input.identity.identityHash,
+            sourceId: input.identity.sourceId,
+            pageId: input.page.id,
+            subject,
+            predicate,
+            object,
+            status: verificationState === 'source_bound' ? status : 'candidate',
+            effectiveAt: input.page.compiledAt,
+            sourceSpan: evidence,
+            sourceContentHash: input.page.contentHash,
+            extractorVersion: input.manifest.version,
+            verificationState,
+        };
+        claims.push({
+            ...body,
+            claimId: `knowledge-claim:${stableHash(body).slice(0, 32)}`,
+            claimHash: stableHash(body),
+        });
+    };
+    for (const item of input.manifest.entities)
+        add(input.identity.sourceId, 'documents_entity', item.value, item.evidence);
+    for (const item of input.manifest.symbols)
+        add(input.identity.sourceId, 'documents_symbol', item.value, item.evidence);
+    for (const item of input.manifest.concepts)
+        add(input.identity.sourceId, 'documents_concept', item.value, item.evidence);
+    for (const item of input.manifest.constraints)
+        add(input.identity.sourceId, 'states_constraint', item.value, item.evidence);
+    for (const item of input.manifest.contradictions)
+        add(input.identity.sourceId, 'states_contradiction', item.value, item.evidence, 'contradicted');
+    for (const relation of input.manifest.relations)
+        add(relation.source, relation.type, relation.target, relation.evidence);
+    return claims;
+}
+function validateClaimEvidence(evidence, source) {
+    return Number.isSafeInteger(evidence.start)
+        && Number.isSafeInteger(evidence.end)
+        && evidence.start >= 0
+        && evidence.end > evidence.start
+        && evidence.end <= source.length
+        && Boolean(evidence.quote.trim())
+        && source.slice(evidence.start, evidence.end) === evidence.quote
+        && createHash('sha256').update(evidence.quote).digest('hex') === evidence.hash;
+}
+function normalizeSourceLocator(value) {
+    const normalized = value.normalize('NFKC').trim();
+    try {
+        const url = new URL(normalized);
+        url.hash = '';
+        url.hostname = url.hostname.toLocaleLowerCase('en-US');
+        url.pathname = url.pathname.replace(/\/{2,}/gu, '/').replace(/\/$/u, '') || '/';
+        return url.toString();
+    }
+    catch {
+        return normalized.replace(/\\/gu, '/').replace(/\/{2,}/gu, '/').replace(/\/$/u, '');
+    }
+}
+function stableHash(value) {
+    return createHash('sha256').update(stableJson(value)).digest('hex');
+}
+function stableJson(value) {
+    if (value === null || typeof value === 'string' || typeof value === 'boolean')
+        return JSON.stringify(value);
+    if (typeof value === 'number')
+        return Number.isFinite(value) ? JSON.stringify(value) : 'null';
+    if (Array.isArray(value))
+        return `[${value.map(stableJson).join(',')}]`;
+    if (!value || typeof value !== 'object')
+        return JSON.stringify(String(value));
+    const record = value;
+    return `{${Object.keys(record).sort().map(key => `${JSON.stringify(key)}:${stableJson(record[key])}`).join(',')}}`;
+}
+//# sourceMappingURL=knowledge-source-lifecycle.js.map

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

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

package/dist/knowledge-source-service.d.ts

@@ -0,0 +1,66 @@
+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

package/dist/knowledge-source-service.d.ts.map

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