@pellux/goodvibes-sdk 0.30.2 → 0.33.0

package/dist/platform/knowledge/semantic/self-improvement-intrinsic-gaps.js

@@ -65,61 +65,63 @@ async function upsertIntrinsicFeatureGap(store, spaceId, subject, facts, sources
         return false;
     const title = `What are the complete features and specifications for ${subjectTitle(subject)}?`;
     const primarySource = sources[0];
-    const gap = await store.upsertNode({
-        id,
-        kind: 'knowledge_gap',
-        slug: semanticSlug(`${spaceId}-intrinsic-gap-${subject.title}`),
-        title,
-        summary: `The current source-backed facts for ${subjectTitle(subject)} do not yet cover the full feature/specification profile.`,
-        aliases: [subject.title, ...subject.aliases].slice(0, 8),
-        confidence: 75,
-        ...(primarySource ? { sourceId: primarySource.id } : {}),
-        metadata: semanticMetadata(spaceId, {
-            semanticKind: 'gap',
-            gapKind: 'intrinsic_features',
-            subject: subject.title,
-            sourceIds: sources.map((source) => source.id),
-            linkedObjectIds: [subject.id],
-            repairStatus: readString(existing?.metadata.repairStatus) ?? 'open',
-            ...((readStringArray(existing?.metadata.acceptedSourceIds).length > 0) ? { acceptedSourceIds: readStringArray(existing?.metadata.acceptedSourceIds) } : {}),
-            ...(typeof existing?.metadata.promotedFactCount === 'number' ? { promotedFactCount: existing.metadata.promotedFactCount } : {}),
-            ...(typeof existing?.metadata.nextRepairAttemptAt === 'number' ? { nextRepairAttemptAt: existing.metadata.nextRepairAttemptAt } : {}),
-            createdBy: 'semantic-self-improvement',
-        }),
-    });
-    for (const source of sources) {
+    return store.batch(async () => {
+        const gap = await store.upsertNode({
+            id,
+            kind: 'knowledge_gap',
+            slug: semanticSlug(`${spaceId}-intrinsic-gap-${subject.title}`),
+            title,
+            summary: `The current source-backed facts for ${subjectTitle(subject)} do not yet cover the full feature/specification profile.`,
+            aliases: [subject.title, ...subject.aliases].slice(0, 8),
+            confidence: 75,
+            ...(primarySource ? { sourceId: primarySource.id } : {}),
+            metadata: semanticMetadata(spaceId, {
+                semanticKind: 'gap',
+                gapKind: 'intrinsic_features',
+                subject: subject.title,
+                sourceIds: sources.map((source) => source.id),
+                linkedObjectIds: [subject.id],
+                repairStatus: readString(existing?.metadata.repairStatus) ?? 'open',
+                ...((readStringArray(existing?.metadata.acceptedSourceIds).length > 0) ? { acceptedSourceIds: readStringArray(existing?.metadata.acceptedSourceIds) } : {}),
+                ...(typeof existing?.metadata.promotedFactCount === 'number' ? { promotedFactCount: existing.metadata.promotedFactCount } : {}),
+                ...(typeof existing?.metadata.nextRepairAttemptAt === 'number' ? { nextRepairAttemptAt: existing.metadata.nextRepairAttemptAt } : {}),
+                createdBy: 'semantic-self-improvement',
+            }),
+        });
+        for (const source of sources) {
+            await store.upsertEdge({
+                fromKind: 'source',
+                fromId: source.id,
+                toKind: 'node',
+                toId: gap.id,
+                relation: 'has_gap',
+                metadata: semanticMetadata(spaceId, { intrinsic: true }),
+            });
+        }
         await store.upsertEdge({
-            fromKind: 'source',
-            fromId: source.id,
+            fromKind: 'node',
+            fromId: subject.id,
             toKind: 'node',
             toId: gap.id,
             relation: 'has_gap',
             metadata: semanticMetadata(spaceId, { intrinsic: true }),
         });
-    }
-    await store.upsertEdge({
-        fromKind: 'node',
-        fromId: subject.id,
-        toKind: 'node',
-        toId: gap.id,
-        relation: 'has_gap',
-        metadata: semanticMetadata(spaceId, { intrinsic: true }),
-    });
-    await store.upsertIssue({
-        id: `sem-intrinsic-gap-issue-${semanticHash(spaceId, subject.id, 'features-specifications')}`,
-        severity: 'info',
-        code: 'knowledge.intrinsic_gap',
-        message: title,
-        status: 'open',
-        ...(primarySource ? { sourceId: primarySource.id } : {}),
-        nodeId: gap.id,
-        metadata: semanticMetadata(spaceId, {
-            namespace: `knowledge:${spaceId}:semantic`,
-            subjectId: subject.id,
-            gapKind: 'intrinsic_features',
-        }),
+        await store.upsertIssue({
+            id: `sem-intrinsic-gap-issue-${semanticHash(spaceId, subject.id, 'features-specifications')}`,
+            severity: 'info',
+            code: 'knowledge.intrinsic_gap',
+            message: title,
+            status: 'open',
+            ...(primarySource ? { sourceId: primarySource.id } : {}),
+            nodeId: gap.id,
+            metadata: semanticMetadata(spaceId, {
+                namespace: `knowledge:${spaceId}:semantic`,
+                subjectId: subject.id,
+                gapKind: 'intrinsic_features',
+            }),
+        });
+        return !existing;
     });
-    return !existing;
 }
 function shouldCreateIntrinsicFeatureGap(subject, facts, objectProfiles, source) {
     if (!isConcreteRepairSubject(subject, objectProfiles))

package/dist/platform/knowledge/semantic/self-improvement-promotion.d.ts

@@ -1,9 +1,11 @@
 import type { KnowledgeObjectProfilePolicy } from '../extensions.js';
 import type { KnowledgeStore } from '../store.js';
-import type { KnowledgeNodeRecord, KnowledgeRefinementTaskRecord } from '../types.js';
+import type { KnowledgeNodeRecord, KnowledgeRefinementTaskRecord, KnowledgeSourceRecord } from '../types.js';
+import { type RepairProfileFact } from './repair-profile.js';
+import { type RepairFactClassification } from './repair-fact-selection.js';
 export interface SelfImprovePromotionContext {
     readonly store: KnowledgeStore;
-    readonly objectProfiles?: readonly KnowledgeObjectProfilePolicy[];
+    readonly objectProfiles?: readonly KnowledgeObjectProfilePolicy[] | undefined;
     readonly enrichSource?: (sourceId: string, options: {
         readonly force?: boolean;
         readonly knowledgeSpaceId?: string;
@@ -15,4 +17,22 @@ export interface PromoteRepairSourcesResult {
     readonly promotedSourceIds: readonly string[];
 }
 export declare function promoteRepairSources(context: SelfImprovePromotionContext, spaceId: string, gap: KnowledgeNodeRecord, sourceIds: readonly string[], task: KnowledgeRefinementTaskRecord, deadlineAt: number): Promise<PromoteRepairSourcesResult>;
+export declare function upsertSourceLinkedRepairProfileFact(input: {
+    readonly store: KnowledgeStore;
+    readonly spaceId: string;
+    readonly source: KnowledgeSourceRecord;
+    readonly subjects: readonly KnowledgeNodeRecord[];
+    readonly authority: 'official-vendor' | 'vendor' | 'secondary';
+    readonly title: string;
+    readonly summary: string;
+    readonly evidence: string;
+    readonly classification: RepairFactClassification | RepairProfileFact;
+    readonly extractor: string;
+    readonly confidence?: number | undefined;
+    readonly supportWeight?: number | undefined;
+    readonly describesWeight?: number | undefined;
+    readonly factMetadata?: Record<string, unknown> | undefined;
+    readonly edgeMetadata?: Record<string, unknown> | undefined;
+    readonly metadataBuilder?: ((metadata: Record<string, unknown>) => Record<string, unknown>) | undefined;
+}): Promise<KnowledgeNodeRecord>;
 //# sourceMappingURL=self-improvement-promotion.d.ts.map

package/dist/platform/knowledge/semantic/self-improvement-promotion.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"self-improvement-promotion.d.ts","sourceRoot":"","sources":["../../../../src/platform/knowledge/semantic/self-improvement-promotion.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,kBAAkB,CAAC;AACrE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,KAAK,EACV,mBAAmB,EACnB,6BAA6B,EAE9B,MAAM,aAAa,CAAC;AA0BrB,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,CAAC,KAAK,EAAE,cAAc,CAAC;IAC/B,QAAQ,CAAC,cAAc,CAAC,EAAE,SAAS,4BAA4B,EAAE,CAAC;IAClE,QAAQ,CAAC,YAAY,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE;QAAE,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;QAAC,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAA;KAAE,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;CAC3I;AAED,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,cAAc,EAAE,OAAO,CAAC;IACjC,QAAQ,CAAC,iBAAiB,EAAE,SAAS,MAAM,EAAE,CAAC;CAC/C;AAID,wBAAsB,oBAAoB,CACxC,OAAO,EAAE,2BAA2B,EACpC,OAAO,EAAE,MAAM,EACf,GAAG,EAAE,mBAAmB,EACxB,SAAS,EAAE,SAAS,MAAM,EAAE,EAC5B,IAAI,EAAE,6BAA6B,EACnC,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,0BAA0B,CAAC,CAyErC"}
+{"version":3,"file":"self-improvement-promotion.d.ts","sourceRoot":"","sources":["../../../../src/platform/knowledge/semantic/self-improvement-promotion.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,kBAAkB,CAAC;AACrE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,KAAK,EACV,mBAAmB,EACnB,6BAA6B,EAC7B,qBAAqB,EACtB,MAAM,aAAa,CAAC;AAErB,OAAO,EAA4B,KAAK,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAMvF,OAAO,EAIL,KAAK,wBAAwB,EAC9B,MAAM,4BAA4B,CAAC;AAcpC,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,CAAC,KAAK,EAAE,cAAc,CAAC;IAC/B,QAAQ,CAAC,cAAc,CAAC,EAAE,SAAS,4BAA4B,EAAE,GAAG,SAAS,CAAC;IAC9E,QAAQ,CAAC,YAAY,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE;QAAE,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;QAAC,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAA;KAAE,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;CAC3I;AAED,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,cAAc,EAAE,OAAO,CAAC;IACjC,QAAQ,CAAC,iBAAiB,EAAE,SAAS,MAAM,EAAE,CAAC;CAC/C;AAID,wBAAsB,oBAAoB,CACxC,OAAO,EAAE,2BAA2B,EACpC,OAAO,EAAE,MAAM,EACf,GAAG,EAAE,mBAAmB,EACxB,SAAS,EAAE,SAAS,MAAM,EAAE,EAC5B,IAAI,EAAE,6BAA6B,EACnC,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,0BAA0B,CAAC,CAyErC;AAwJD,wBAAsB,mCAAmC,CAAC,KAAK,EAAE;IAC/D,QAAQ,CAAC,KAAK,EAAE,cAAc,CAAC;IAC/B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,qBAAqB,CAAC;IACvC,QAAQ,CAAC,QAAQ,EAAE,SAAS,mBAAmB,EAAE,CAAC;IAClD,QAAQ,CAAC,SAAS,EAAE,iBAAiB,GAAG,QAAQ,GAAG,WAAW,CAAC;IAC/D,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,cAAc,EAAE,wBAAwB,GAAG,iBAAiB,CAAC;IACtE,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACzC,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5C,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9C,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAC;IAC5D,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAC;IAC5D,QAAQ,CAAC,eAAe,CAAC,EAAE,CAAC,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC;CACzG,GAAG,OAAO,CAAC,mBAAmB,CAAC,CA2E/B"}

package/dist/platform/knowledge/semantic/self-improvement-promotion.js

@@ -8,7 +8,8 @@ import { updateRefinementTask } from './self-improvement-tasks.js';
 import { withTimeout } from './timeouts.js';
 import { canonicalRepairSubjectNodes, repairSubjectHints } from './repair-subjects.js';
 import { classifyRepairFact, selectRepairFactSentences, sourceAuthority, } from './repair-fact-selection.js';
-import { normalizeWhitespace, readRecord, readString, readStringArray, semanticHash, semanticMetadata, semanticSlug, sourceSemanticText, uniqueStrings, } from './utils.js';
+import { sourceAuthorityBoostForAnswer } from './answer-source-ranking.js';
+import { normalizeWhitespace, readRecord, readString, readStringArray, semanticFactId, semanticMetadata, semanticSlug, sourceSemanticText, uniqueStrings, } from './utils.js';
 const REPAIR_SOURCE_TEXT_WAIT_MS = 1_500;
 export async function promoteRepairSources(context, spaceId, gap, sourceIds, task, deadlineAt) {
     const targetUsableFactCount = repairTargetUsableFactCount(gap);
@@ -195,31 +196,76 @@ async function promoteRepairEvidenceFacts(store, spaceId, gap, sourceIds) {
     return promoted;
 }
 async function upsertPromotedRepairFact(input) {
+    await upsertSourceLinkedRepairProfileFact({
+        store: input.store,
+        spaceId: input.spaceId,
+        source: input.source,
+        subjects: input.subjects,
+        authority: input.authority,
+        title: input.title,
+        summary: input.summary,
+        evidence: input.evidence,
+        classification: input.classification,
+        extractor: 'repair-promotion',
+        factMetadata: {
+            gapId: input.gap.id,
+            sourceDiscovery: readRecord(input.source.metadata.sourceDiscovery),
+        },
+        edgeMetadata: {
+            linkedBy: 'semantic-gap-repair',
+            gapId: input.gap.id,
+        },
+    });
+    return 1;
+}
+export async function upsertSourceLinkedRepairProfileFact(input) {
+    const subjectIds = input.subjects.map((subject) => subject.id);
+    const factId = semanticFactId({
+        spaceId: input.spaceId,
+        kind: input.classification.kind,
+        title: input.title,
+        value: input.classification.value,
+        summary: input.summary,
+        subjectIds,
+        fallbackScope: input.source.id,
+    });
+    const existingFact = input.store.getNode(factId);
+    const sourceIds = uniqueStrings([
+        ...readStringArray(existingFact?.metadata.sourceIds),
+        readString(existingFact?.metadata.sourceId),
+        existingFact?.sourceId,
+        input.source.id,
+    ]);
+    const primarySourceId = preferredRepairFactSourceId(input.store, sourceIds, input.source.id);
+    const metadataBuilder = input.metadataBuilder ?? ((metadata) => semanticMetadata(input.spaceId, metadata));
+    const confidence = input.confidence ?? (input.authority === 'official-vendor' ? 90 : input.authority === 'vendor' ? 82 : 76);
+    const supportWeight = input.supportWeight ?? (input.authority === 'official-vendor' ? 0.96 : 0.84);
+    const describesWeight = input.describesWeight ?? (input.authority === 'official-vendor' ? 0.95 : 0.82);
     const fact = await input.store.upsertNode({
-        id: `sem-fact-${semanticHash(input.spaceId, input.source.id, input.gap.id, input.title, input.summary)}`,
+        id: factId,
         kind: 'fact',
         slug: semanticSlug(`${input.spaceId}-${input.title}-${input.summary}-${input.source.id}`),
         title: input.title,
         summary: input.summary,
         aliases: input.classification.aliases,
         status: 'active',
-        confidence: input.authority === 'official-vendor' ? 90 : input.authority === 'vendor' ? 82 : 76,
-        sourceId: input.source.id,
-        metadata: semanticMetadata(input.spaceId, {
+        confidence,
+        sourceId: primarySourceId,
+        metadata: metadataBuilder({
             semanticKind: 'fact',
             factKind: input.classification.kind,
             value: input.classification.value,
             evidence: input.evidence,
             labels: input.classification.labels,
-            sourceId: input.source.id,
-            gapId: input.gap.id,
+            sourceId: primarySourceId,
+            sourceIds,
             subject: input.subjects[0]?.title,
-            subjectIds: input.subjects.map((subject) => subject.id),
+            subjectIds,
             targetHints: repairSubjectHints(input.subjects),
-            linkedObjectIds: input.subjects.map((subject) => subject.id),
-            extractor: 'repair-promotion',
+            linkedObjectIds: subjectIds,
+            extractor: input.extractor,
             sourceAuthority: input.authority,
-            sourceDiscovery: readRecord(input.source.metadata.sourceDiscovery),
+            ...(input.factMetadata ?? {}),
         }),
     });
     await input.store.upsertEdge({
@@ -228,11 +274,8 @@ async function upsertPromotedRepairFact(input) {
         toKind: 'node',
         toId: fact.id,
         relation: 'supports_fact',
-        weight: input.authority === 'official-vendor' ? 0.96 : 0.84,
-        metadata: semanticMetadata(input.spaceId, {
-            linkedBy: 'semantic-gap-repair',
-            gapId: input.gap.id,
-        }),
+        weight: supportWeight,
+        metadata: metadataBuilder(input.edgeMetadata ?? {}),
     });
     for (const subject of input.subjects) {
         await input.store.upsertEdge({
@@ -241,16 +284,15 @@ async function upsertPromotedRepairFact(input) {
             toKind: 'node',
             toId: subject.id,
             relation: 'describes',
-            weight: input.authority === 'official-vendor' ? 0.95 : 0.82,
-            metadata: semanticMetadata(input.spaceId, {
-                linkedBy: 'semantic-gap-repair',
+            weight: describesWeight,
+            metadata: metadataBuilder({
+                ...(input.edgeMetadata ?? {}),
                 repairedAt: Date.now(),
                 sourceId: input.source.id,
-                gapId: input.gap.id,
             }),
         });
     }
-    return 1;
+    return fact;
 }
 async function linkPromotedFactsToRepairSubjects(store, spaceId, gap, sourceIds) {
     const subjects = linkedRepairSubjects(store, spaceId, gap, []);
@@ -262,48 +304,56 @@ async function linkPromotedFactsToRepairSubjects(store, spaceId, gap, sourceIds)
     const edges = graph.edges;
     const nodesById = graph.nodesById;
     for (const sourceId of sourceIds) {
-        for (const fact of factsForSource(sourceId, edges, nodesById)) {
-            if (!isUsableRepairFact(fact) || !isRepairFactCompatibleWithSubjects(fact, subjects))
-                continue;
-            await store.upsertNode({
-                id: fact.id,
-                kind: fact.kind,
-                slug: fact.slug,
-                title: fact.title,
-                summary: fact.summary,
-                aliases: fact.aliases,
-                status: fact.status,
-                confidence: fact.confidence,
-                sourceId: fact.sourceId ?? sourceId,
-                metadata: semanticMetadata(spaceId, {
-                    ...fact.metadata,
-                    subject: readString(fact.metadata.subject) ?? subjects[0]?.title,
-                    subjectIds: uniqueStrings([...readStringArray(fact.metadata.subjectIds), ...linkedObjectIds]),
-                    linkedObjectIds: uniqueStrings([...readStringArray(fact.metadata.linkedObjectIds), ...linkedObjectIds]),
-                    targetHints: uniqueTargetHints([
-                        ...readTargetHints(fact.metadata.targetHints),
-                        ...targetHints,
-                    ]),
+        await store.batch(async () => {
+            for (const fact of factsForSource(sourceId, edges, nodesById)) {
+                if (!isUsableRepairFact(fact) || !isRepairFactCompatibleWithSubjects(fact, subjects))
+                    continue;
+                await store.upsertNode({
+                    id: fact.id,
+                    kind: fact.kind,
+                    slug: fact.slug,
+                    title: fact.title,
+                    summary: fact.summary,
+                    aliases: fact.aliases,
+                    status: fact.status,
+                    confidence: fact.confidence,
                     sourceId: fact.sourceId ?? sourceId,
-                    linkedBy: readString(fact.metadata.linkedBy) ?? 'semantic-gap-repair',
-                }),
-            });
-            for (const objectId of linkedObjectIds) {
-                await store.upsertEdge({
-                    fromKind: 'node',
-                    fromId: fact.id,
-                    toKind: 'node',
-                    toId: objectId,
-                    relation: 'describes',
-                    weight: 0.82,
                     metadata: semanticMetadata(spaceId, {
-                        linkedBy: 'semantic-gap-repair',
-                        repairedAt: Date.now(),
-                        sourceId,
+                        ...fact.metadata,
+                        subject: readString(fact.metadata.subject) ?? subjects[0]?.title,
+                        subjectIds: uniqueStrings([...readStringArray(fact.metadata.subjectIds), ...linkedObjectIds]),
+                        linkedObjectIds: uniqueStrings([...readStringArray(fact.metadata.linkedObjectIds), ...linkedObjectIds]),
+                        targetHints: uniqueTargetHints([
+                            ...readTargetHints(fact.metadata.targetHints),
+                            ...targetHints,
+                        ]),
+                        sourceId: fact.sourceId ?? sourceId,
+                        sourceIds: uniqueStrings([
+                            ...readStringArray(fact.metadata.sourceIds),
+                            readString(fact.metadata.sourceId),
+                            fact.sourceId,
+                            sourceId,
+                        ]),
+                        linkedBy: readString(fact.metadata.linkedBy) ?? 'semantic-gap-repair',
                     }),
                 });
+                for (const objectId of linkedObjectIds) {
+                    await store.upsertEdge({
+                        fromKind: 'node',
+                        fromId: fact.id,
+                        toKind: 'node',
+                        toId: objectId,
+                        relation: 'describes',
+                        weight: 0.82,
+                        metadata: semanticMetadata(spaceId, {
+                            linkedBy: 'semantic-gap-repair',
+                            repairedAt: Date.now(),
+                            sourceId,
+                        }),
+                    });
+                }
             }
-        }
+        });
     }
 }
 function linkedRepairSubjects(store, spaceId, gap, objectProfiles) {
@@ -331,10 +381,19 @@ function linkedRepairSubjects(store, spaceId, gap, objectProfiles) {
 }
 function countUsableRepairFacts(store, spaceId, sourceIds, subjectIds) {
     const sources = new Set(sourceIds);
-    return [...buildKnowledgeSemanticGraphIndex(store, spaceId).nodesById.values()]
+    const graph = buildKnowledgeSemanticGraphIndex(store, spaceId);
+    const sourceIdsByFactId = new Map();
+    for (const edge of graph.edges) {
+        if (edge.fromKind !== 'source' || edge.toKind !== 'node' || edge.relation !== 'supports_fact')
+            continue;
+        const current = sourceIdsByFactId.get(edge.toId) ?? new Set();
+        current.add(edge.fromId);
+        sourceIdsByFactId.set(edge.toId, current);
+    }
+    return [...graph.nodesById.values()]
         .filter((node) => node.kind === 'fact' && node.status !== 'stale')
         .filter((node) => getKnowledgeSpaceId(node) === spaceId)
-        .filter((node) => node.sourceId && sources.has(node.sourceId))
+        .filter((node) => factSourceIds(node, sourceIdsByFactId).some((sourceId) => sources.has(sourceId)))
         .filter(isUsableRepairFact)
         .filter((node) => {
         if (subjectIds.size === 0)
@@ -347,6 +406,28 @@ function countUsableRepairFacts(store, spaceId, sourceIds, subjectIds) {
     })
         .length;
 }
+function factSourceIds(fact, sourceIdsByFactId = new Map()) {
+    return uniqueStrings([
+        ...readStringArray(fact.metadata.sourceIds),
+        readString(fact.metadata.sourceId),
+        fact.sourceId,
+        ...(sourceIdsByFactId.get(fact.id) ?? []),
+    ]);
+}
+function preferredRepairFactSourceId(store, sourceIds, fallbackSourceId) {
+    const candidates = uniqueStrings(sourceIds)
+        .map((sourceId) => store.getSource(sourceId))
+        .filter((source) => Boolean(source && source.status !== 'stale'));
+    if (candidates.length === 0)
+        return fallbackSourceId;
+    return candidates
+        .sort((left, right) => repairFactSourceQuality(right) - repairFactSourceQuality(left) || left.id.localeCompare(right.id))[0].id;
+}
+function repairFactSourceQuality(source) {
+    return sourceAuthorityBoostForAnswer(source)
+        + (source.status === 'indexed' ? 40 : source.status === 'pending' ? 5 : 0)
+        + (source.sourceType === 'manual' || source.sourceType === 'document' ? 12 : source.sourceType === 'url' ? 8 : 0);
+}
 function isUsableRepairFact(node) {
     if (!['feature', 'capability', 'specification', 'compatibility', 'configuration'].includes(readString(node.metadata.factKind) ?? '')) {
         return false;

package/dist/platform/knowledge/semantic/self-improvement-recovery.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"self-improvement-recovery.d.ts","sourceRoot":"","sources":["../../../../src/platform/knowledge/semantic/self-improvement-recovery.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAgBlD,wBAAsB,uBAAuB,CAAC,KAAK,EAAE,cAAc,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAcnG;AAED,wBAAsB,sBAAsB,CAAC,KAAK,EAAE,cAAc,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAqClG"}
+{"version":3,"file":"self-improvement-recovery.d.ts","sourceRoot":"","sources":["../../../../src/platform/knowledge/semantic/self-improvement-recovery.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAgBlD,wBAAsB,uBAAuB,CAAC,KAAK,EAAE,cAAc,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAgBnG;AAED,wBAAsB,sBAAsB,CAAC,KAAK,EAAE,cAAc,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAuClG"}

package/dist/platform/knowledge/semantic/self-improvement-recovery.js

@@ -13,39 +13,43 @@ export async function recoverStaleActiveTasks(store, spaceId) {
     const staleTasks = store.listRefinementTasks(10_000, { spaceId })
         .filter((task) => ACTIVE_REFINEMENT_STATES.has(task.state))
         .filter((task) => now - task.updatedAt >= STALE_ACTIVE_TASK_MS);
-    for (const task of staleTasks) {
-        await upsertRecoveredTask(store, task, 'blocked', 'Refinement task was interrupted or exceeded the active window; it can be retried.', { recoveredFrom: 'stale_active' });
-    }
+    await store.batch(async () => {
+        for (const task of staleTasks) {
+            await upsertRecoveredTask(store, task, 'blocked', 'Refinement task was interrupted or exceeded the active window; it can be retried.', { recoveredFrom: 'stale_active' });
+        }
+    });
 }
 export async function recoverNoRepairerTasks(store, spaceId) {
     const tasks = store.listRefinementTasks(10_000, { spaceId })
         .filter((task) => task.state === 'blocked')
         .filter((task) => /no semantic gap repairer is configured/i.test(task.blockedReason ?? ''));
     for (const task of tasks) {
-        if (task.gapId) {
-            const gap = store.getNode(task.gapId);
-            if (gap && getKnowledgeSpaceId(gap) === spaceId && readString(gap.metadata.repairStatus) === 'no_repairer') {
-                await store.upsertNode({
-                    id: gap.id,
-                    kind: gap.kind,
-                    slug: gap.slug,
-                    title: gap.title,
-                    summary: gap.summary,
-                    aliases: gap.aliases,
-                    status: gap.status,
-                    confidence: gap.confidence,
-                    sourceId: gap.sourceId,
-                    metadata: {
-                        ...gap.metadata,
-                        repairStatus: 'open',
-                        repairReason: 'Semantic gap repairer is now configured; retry is allowed.',
-                        nextRepairAttemptAt: undefined,
-                        knowledgeSpaceId: spaceId,
-                    },
-                });
+        await store.batch(async () => {
+            if (task.gapId) {
+                const gap = store.getNode(task.gapId);
+                if (gap && getKnowledgeSpaceId(gap) === spaceId && readString(gap.metadata.repairStatus) === 'no_repairer') {
+                    await store.upsertNode({
+                        id: gap.id,
+                        kind: gap.kind,
+                        slug: gap.slug,
+                        title: gap.title,
+                        summary: gap.summary,
+                        aliases: gap.aliases,
+                        status: gap.status,
+                        confidence: gap.confidence,
+                        sourceId: gap.sourceId,
+                        metadata: {
+                            ...gap.metadata,
+                            repairStatus: 'open',
+                            repairReason: 'Semantic gap repairer is now configured; retry is allowed.',
+                            nextRepairAttemptAt: undefined,
+                            knowledgeSpaceId: spaceId,
+                        },
+                    });
+                }
             }
-        }
-        await upsertRecoveredTask(store, task, 'detected', 'Semantic gap repairer is now configured; task can be retried.', { recoveredFrom: 'no_repairer' }, { repairStatus: 'open', recoveredFrom: 'no_repairer', recoveredAt: Date.now() });
+            await upsertRecoveredTask(store, task, 'detected', 'Semantic gap repairer is now configured; task can be retried.', { recoveredFrom: 'no_repairer' }, { repairStatus: 'open', recoveredFrom: 'no_repairer', recoveredAt: Date.now() });
+        });
     }
 }
 async function upsertRecoveredTask(store, task, state, message, data, metadata = {}) {

package/dist/platform/knowledge/semantic/self-improvement.d.ts

@@ -3,9 +3,9 @@ import type { KnowledgeObjectProfilePolicy } from '../extensions.js';
 import type { KnowledgeSemanticGapRepairer, KnowledgeSemanticSelfImproveInput, KnowledgeSemanticSelfImproveResult } from './types.js';
 interface SelfImproveContext {
     readonly store: KnowledgeStore;
-    readonly gapRepairer?: KnowledgeSemanticGapRepairer | null;
+    readonly gapRepairer?: KnowledgeSemanticGapRepairer | null | undefined;
     readonly activeGapRepairs: Set<string>;
-    readonly objectProfiles?: readonly KnowledgeObjectProfilePolicy[];
+    readonly objectProfiles?: readonly KnowledgeObjectProfilePolicy[] | undefined;
     readonly enrichSource?: (sourceId: string, options: {
         readonly force?: boolean;
         readonly knowledgeSpaceId?: string;

package/dist/platform/knowledge/semantic/self-improvement.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"self-improvement.d.ts","sourceRoot":"","sources":["../../../../src/platform/knowledge/semantic/self-improvement.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,kBAAkB,CAAC;AAKrE,OAAO,KAAK,EACV,4BAA4B,EAC5B,iCAAiC,EACjC,kCAAkC,EACnC,MAAM,YAAY,CAAC;AA2BpB,UAAU,kBAAkB;IAC1B,QAAQ,CAAC,KAAK,EAAE,cAAc,CAAC;IAC/B,QAAQ,CAAC,WAAW,CAAC,EAAE,4BAA4B,GAAG,IAAI,CAAC;IAC3D,QAAQ,CAAC,gBAAgB,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IACvC,QAAQ,CAAC,cAAc,CAAC,EAAE,SAAS,4BAA4B,EAAE,CAAC;IAClE,QAAQ,CAAC,YAAY,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE;QAAE,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;QAAC,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAA;KAAE,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;CAC3I;AAED,wBAAsB,mCAAmC,CACvD,OAAO,EAAE,kBAAkB,EAC3B,KAAK,GAAE,iCAAsC,GAC5C,OAAO,CAAC,kCAAkC,CAAC,CAiQ7C"}
+{"version":3,"file":"self-improvement.d.ts","sourceRoot":"","sources":["../../../../src/platform/knowledge/semantic/self-improvement.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,kBAAkB,CAAC;AAOrE,OAAO,KAAK,EACV,4BAA4B,EAC5B,iCAAiC,EACjC,kCAAkC,EACnC,MAAM,YAAY,CAAC;AAyBpB,UAAU,kBAAkB;IAC1B,QAAQ,CAAC,KAAK,EAAE,cAAc,CAAC;IAC/B,QAAQ,CAAC,WAAW,CAAC,EAAE,4BAA4B,GAAG,IAAI,GAAG,SAAS,CAAC;IACvE,QAAQ,CAAC,gBAAgB,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IACvC,QAAQ,CAAC,cAAc,CAAC,EAAE,SAAS,4BAA4B,EAAE,GAAG,SAAS,CAAC;IAC9E,QAAQ,CAAC,YAAY,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE;QAAE,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;QAAC,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAA;KAAE,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;CAC3I;AAwDD,wBAAsB,mCAAmC,CACvD,OAAO,EAAE,kBAAkB,EAC3B,KAAK,GAAE,iCAAsC,GAC5C,OAAO,CAAC,kCAAkC,CAAC,CAsF7C"}