@pellux/goodvibes-sdk 0.30.3 → 0.33.0

package/dist/platform/knowledge/semantic/answer-evidence.js

@@ -1,4 +1,5 @@
 import { getKnowledgeSpaceId, isHomeAssistantKnowledgeSpace, isInKnowledgeSpace, normalizeKnowledgeSpaceId, } from '../spaces.js';
+import { isActiveKnowledgeEdge } from '../projection-utils.js';
 import { clampText, normalizeWhitespace, readRecord, readString, readStringArray, scoreSemanticText, sourceSemanticText, splitSentences, tokenizeSemanticQuery, uniqueStrings, } from './utils.js';
 import { isLowValueFeatureOrSpecText, isSemanticAnswerLinkedObject, } from './fact-quality.js';
 import { inferAnswerObjectScope, nodeInAnswerObjectScope, sourceInAnswerObjectScope, } from './object-scope.js';
@@ -15,7 +16,9 @@ export function collectAnswerEvidence(store, input, spaceId, limit, objectProfil
     const candidateNodeIds = new Set(input.candidateNodeIds ?? []);
     const linkedObjectIds = new Set((input.linkedObjects ?? []).map((node) => node.id));
     const strictCandidates = input.strictCandidates === true && (candidateSourceIds.size > 0 || candidateNodeIds.size > 0);
-    const sourceFacts = buildSourceFactIndex(store, spaceId);
+    const answerSources = listAnswerSources(store, spaceId).filter(isUsableAnswerSource);
+    const usableSourceIds = new Set(answerSources.map((source) => source.id));
+    const sourceFacts = buildSourceFactIndex(store, spaceId, usableSourceIds);
     const linkedSourceIds = sourceIdsLinkedToNodes(store, new Set([...candidateNodeIds, ...linkedObjectIds]), spaceId);
     const broadNamespaceAlias = isBroadKnowledgeSpaceAlias(spaceId) && !strictCandidates;
     if (broadNamespaceAlias && subjectTokens.length === 0 && linkedObjectIds.size === 0)
@@ -23,7 +26,7 @@ export function collectAnswerEvidence(store, input, spaceId, limit, objectProfil
     const objectScope = !strictCandidates
         ? inferAnswerObjectScope(store, spaceId, input.query, subjectTokens, objectProfiles)
         : null;
-    const sourceItems = listAnswerSources(store, spaceId)
+    const sourceItems = answerSources
         .filter((source) => belongsToAnswerSpace(source, spaceId))
         .filter((source) => sourceInAnswerObjectScope(store, source, objectScope))
         .filter((source) => !strictCandidates || candidateSourceIds.has(source.id) || linkedSourceIds.has(source.id))
@@ -66,6 +69,7 @@ export function collectAnswerEvidence(store, input, spaceId, limit, objectProfil
     });
     const nodeItems = listAnswerNodes(store, spaceId)
         .filter((node) => belongsToAnswerSpace(node, spaceId) && node.status !== 'stale')
+        .filter((node) => node.metadata.semanticKind !== 'fact' || factHasUsableSource(node, usableSourceIds))
         .filter((node) => nodeInAnswerObjectScope(node, objectScope))
         .filter((node) => !strictCandidates
         || candidateNodeIds.has(node.id)
@@ -133,6 +137,7 @@ export function includeOfficialLinkedSources(store, spaceId, rankedSources, link
     const linkedIds = new Set(linkedObjects.map((node) => node.id));
     const linkedSourceIds = sourceIdsLinkedToNodes(store, linkedIds, spaceId);
     const official = listAnswerSources(store, spaceId)
+        .filter(isUsableAnswerSource)
         .filter((source) => belongsToAnswerSpace(source, spaceId))
         .filter((source) => sourceAuthorityBoostForAnswer(source) > 0)
         .filter((source) => {
@@ -149,8 +154,10 @@ export function includeOfficialLinkedEvidence(store, spaceId, query, evidence, l
     const linkedIds = new Set(linkedObjects.map((node) => node.id));
     const linkedSourceIds = sourceIdsLinkedToNodes(store, linkedIds, spaceId);
     const tokens = expandQueryTokens(tokenizeSemanticQuery(query));
-    const sourceFacts = buildSourceFactIndex(store, spaceId);
+    const usableSourceIds = new Set(listAnswerSources(store, spaceId).filter(isUsableAnswerSource).map((source) => source.id));
+    const sourceFacts = buildSourceFactIndex(store, spaceId, usableSourceIds);
     const officialItems = listAnswerSources(store, spaceId)
+        .filter(isUsableAnswerSource)
         .filter((source) => belongsToAnswerSpace(source, spaceId))
         .filter((source) => sourceAuthorityBoostForAnswer(source) > 0)
         .filter((source) => linkedSourceIds.has(source.id) || readStringArray(readRecord(source.metadata.sourceDiscovery).linkedObjectIds).some((id) => linkedIds.has(id)))
@@ -212,53 +219,100 @@ export function withAnswerSourceAliases(source) {
         url: source.sourceUri ?? source.canonicalUri,
     };
 }
-function buildSourceFactIndex(store, spaceId) {
+function buildSourceFactIndex(store, spaceId, usableSourceIds) {
     const facts = listAnswerNodes(store, spaceId).filter((node) => (node.status !== 'stale' && node.metadata.semanticKind === 'fact' && belongsToAnswerSpace(node, spaceId)));
+    const factsById = new Map(facts.map((fact) => [fact.id, fact]));
     const bySource = new Map();
     for (const fact of facts) {
-        const sourceId = readString(fact.metadata.sourceId) ?? fact.sourceId;
-        if (!sourceId)
+        for (const sourceId of factSourceIds(fact)) {
+            addSourceFact(bySource, usableSourceIds, sourceId, fact);
+        }
+    }
+    for (const edge of store.listEdges()) {
+        if (!edgeIsActive(edge))
+            continue;
+        if (!belongsToAnswerSpace(edge, spaceId))
             continue;
-        bySource.set(sourceId, [...(bySource.get(sourceId) ?? []), fact]);
+        if (edge.fromKind !== 'source' || edge.toKind !== 'node' || edge.relation !== 'supports_fact')
+            continue;
+        const fact = factsById.get(edge.toId);
+        if (!fact)
+            continue;
+        addSourceFact(bySource, usableSourceIds, edge.fromId, fact);
     }
     return bySource;
 }
+function factHasUsableSource(node, usableSourceIds) {
+    return factSourceIds(node).some((sourceId) => usableSourceIds.has(sourceId));
+}
+function factSourceIds(fact) {
+    return uniqueStrings([
+        ...readStringArray(fact.metadata.sourceIds),
+        readString(fact.metadata.sourceId),
+        fact.sourceId,
+    ]);
+}
+function addSourceFact(bySource, usableSourceIds, sourceId, fact) {
+    if (!sourceId || !usableSourceIds.has(sourceId))
+        return;
+    const existing = bySource.get(sourceId) ?? [];
+    if (existing.some((entry) => entry.id === fact.id))
+        return;
+    bySource.set(sourceId, [...existing, fact]);
+}
+function isUsableAnswerSource(source) {
+    return source.status === 'indexed';
+}
 function listAnswerSources(store, spaceId) {
-    if (isBroadKnowledgeSpaceAlias(spaceId))
-        return store.listSources(Number.MAX_SAFE_INTEGER);
-    return store.listSourcesInSpace(spaceId);
+    const sources = isBroadKnowledgeSpaceAlias(spaceId)
+        ? store.listSources(Number.MAX_SAFE_INTEGER)
+        : store.listSourcesInSpace(spaceId);
+    return sources.filter((source) => source.status !== 'stale');
 }
 function listAnswerNodes(store, spaceId) {
-    if (isBroadKnowledgeSpaceAlias(spaceId))
-        return store.listNodes(Number.MAX_SAFE_INTEGER);
-    return store.listNodesInSpace(spaceId);
+    const nodes = isBroadKnowledgeSpaceAlias(spaceId)
+        ? store.listNodes(Number.MAX_SAFE_INTEGER)
+        : store.listNodesInSpace(spaceId);
+    return nodes.filter((node) => node.status !== 'stale');
 }
 function sourceIdsLinkedToNodes(store, nodeIds, spaceId) {
     const sourceIds = new Set();
     if (nodeIds.size === 0)
         return sourceIds;
+    const usableSourceIds = new Set(listAnswerSources(store, spaceId).map((source) => source.id));
     const edges = store.listEdges();
     const factIds = new Set();
     for (const edge of edges) {
+        if (!edgeIsActive(edge))
+            continue;
         if (!belongsToAnswerSpace(edge, spaceId))
             continue;
-        if (edge.fromKind === 'source' && edge.toKind === 'node' && nodeIds.has(edge.toId))
+        if (edge.fromKind === 'source' && edge.toKind === 'node' && nodeIds.has(edge.toId) && usableSourceIds.has(edge.fromId))
             sourceIds.add(edge.fromId);
-        if (edge.fromKind === 'node' && nodeIds.has(edge.fromId) && edge.toKind === 'source')
+        if (edge.fromKind === 'node' && nodeIds.has(edge.fromId) && edge.toKind === 'source' && usableSourceIds.has(edge.toId))
             sourceIds.add(edge.toId);
         if (edge.fromKind === 'node' && edge.toKind === 'node' && nodeIds.has(edge.toId) && edge.relation === 'describes') {
             factIds.add(edge.fromId);
         }
     }
     for (const edge of edges) {
+        if (!edgeIsActive(edge))
+            continue;
         if (!belongsToAnswerSpace(edge, spaceId))
             continue;
-        if (edge.fromKind === 'source' && edge.toKind === 'node' && factIds.has(edge.toId) && edge.relation === 'supports_fact') {
+        if (edge.fromKind === 'source'
+            && edge.toKind === 'node'
+            && factIds.has(edge.toId)
+            && edge.relation === 'supports_fact'
+            && usableSourceIds.has(edge.fromId)) {
             sourceIds.add(edge.fromId);
         }
     }
     return sourceIds;
 }
+function edgeIsActive(edge) {
+    return isActiveKnowledgeEdge(edge);
+}
 function selectEvidenceExcerpt(query, text, facts) {
     const tokens = expandQueryTokens(tokenizeSemanticQuery(query));
     const intent = factIntent(tokenizeSemanticQuery(query));

package/dist/platform/knowledge/semantic/answer-fallback.d.ts

@@ -1,7 +1,7 @@
 import type { KnowledgeNodeRecord } from '../types.js';
 export interface AnswerFallbackEvidence {
     readonly title: string;
-    readonly excerpt?: string;
+    readonly excerpt?: string | undefined;
 }
 export interface FallbackAnswer {
     readonly text: string;
@@ -12,7 +12,7 @@ export interface AnswerFallbackPolicy {
         readonly query: string;
         readonly sourceTitles: readonly string[];
     }) => FallbackAnswer;
-    readonly renderNoMatch?: (query: string) => FallbackAnswer;
+    readonly renderNoMatch?: ((query: string) => FallbackAnswer) | undefined;
 }
 export declare function renderFallbackAnswer(query: string, mode: string, evidence: readonly AnswerFallbackEvidence[], facts: readonly KnowledgeNodeRecord[], policy?: AnswerFallbackPolicy): FallbackAnswer;
 //# sourceMappingURL=answer-fallback.d.ts.map

package/dist/platform/knowledge/semantic/answer-fallback.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"answer-fallback.d.ts","sourceRoot":"","sources":["../../../../src/platform/knowledge/semantic/answer-fallback.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAIvD,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;CAC/B;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,uBAAuB,CAAC,EAAE,CAAC,KAAK,EAAE;QACzC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;QACvB,QAAQ,CAAC,YAAY,EAAE,SAAS,MAAM,EAAE,CAAC;KAC1C,KAAK,cAAc,CAAC;IACrB,QAAQ,CAAC,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,cAAc,CAAC;CAC5D;AAaD,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,SAAS,sBAAsB,EAAE,EAC3C,KAAK,EAAE,SAAS,mBAAmB,EAAE,EACrC,MAAM,GAAE,oBAAqD,GAC5D,cAAc,CA0BhB"}
+{"version":3,"file":"answer-fallback.d.ts","sourceRoot":"","sources":["../../../../src/platform/knowledge/semantic/answer-fallback.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAIvD,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACvC;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;CAC/B;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,uBAAuB,CAAC,EAAE,CAAC,KAAK,EAAE;QACzC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;QACvB,QAAQ,CAAC,YAAY,EAAE,SAAS,MAAM,EAAE,CAAC;KAC1C,KAAK,cAAc,CAAC;IACrB,QAAQ,CAAC,aAAa,CAAC,EAAE,CAAC,CAAC,KAAK,EAAE,MAAM,KAAK,cAAc,CAAC,GAAG,SAAS,CAAC;CAC1E;AAaD,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,SAAS,sBAAsB,EAAE,EAC3C,KAAK,EAAE,SAAS,mBAAmB,EAAE,EACrC,MAAM,GAAE,oBAAqD,GAC5D,cAAc,CA0BhB"}

package/dist/platform/knowledge/semantic/answer-fallback.js

@@ -44,7 +44,12 @@ function renderFactPhrase(fact) {
     const cleaned = normalizeWhitespace(clampText(phrase, 220));
     if (isRawSourceFragment(cleaned))
         return '';
-    return isLowValueFeatureOrSpecText(cleaned) ? '' : cleaned;
+    if (!isLowValueFeatureOrSpecText(cleaned))
+        return cleaned;
+    const fallback = normalizeWhitespace(clampText(value ?? summary ?? fact.title, 220));
+    if (!fallback || isRawSourceFragment(fallback))
+        return '';
+    return isLowValueFeatureOrSpecText(fallback) ? '' : fallback;
 }
 function renderFeatureProfile(query, facts, evidence) {
     if (!/\b(feature|features|capabilit|spec|specs|specification|specifications|support|supports)\b/i.test(query))

package/dist/platform/knowledge/semantic/answer-gaps.d.ts

@@ -3,13 +3,13 @@ import type { KnowledgeNodeRecord, KnowledgeSourceRecord } from '../types.js';
 import type { KnowledgeSemanticGapInput } from './types.js';
 export declare function shouldPersistNoMatchGap(spaceId: string, query: string, linkedObjects: readonly KnowledgeNodeRecord[]): boolean;
 export declare function persistAnswerGap(store: KnowledgeStore, spaceId: string, query: string, reason: string, context?: {
-    readonly subject?: string;
-    readonly sources?: readonly KnowledgeSourceRecord[];
-    readonly linkedObjects?: readonly KnowledgeNodeRecord[];
+    readonly subject?: string | undefined;
+    readonly sources?: readonly KnowledgeSourceRecord[] | undefined;
+    readonly linkedObjects?: readonly KnowledgeNodeRecord[] | undefined;
 }): Promise<KnowledgeNodeRecord>;
 export declare function persistAnswerGaps(store: KnowledgeStore, spaceId: string, query: string, gaps: readonly KnowledgeSemanticGapInput[], context?: {
-    readonly sources?: readonly KnowledgeSourceRecord[];
-    readonly linkedObjects?: readonly KnowledgeNodeRecord[];
+    readonly sources?: readonly KnowledgeSourceRecord[] | undefined;
+    readonly linkedObjects?: readonly KnowledgeNodeRecord[] | undefined;
 }): Promise<readonly KnowledgeNodeRecord[]>;
 export declare function isRepairedAnswerGap(node: KnowledgeNodeRecord): boolean;
 //# sourceMappingURL=answer-gaps.d.ts.map

package/dist/platform/knowledge/semantic/answer-gaps.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"answer-gaps.d.ts","sourceRoot":"","sources":["../../../../src/platform/knowledge/semantic/answer-gaps.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,KAAK,EAAE,mBAAmB,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAC9E,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,YAAY,CAAC;AAgB5D,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,EACb,aAAa,EAAE,SAAS,mBAAmB,EAAE,GAC5C,OAAO,CAKT;AAED,wBAAsB,gBAAgB,CACpC,KAAK,EAAE,cAAc,EACrB,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACd,OAAO,GAAE;IACP,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,qBAAqB,EAAE,CAAC;IACpD,QAAQ,CAAC,aAAa,CAAC,EAAE,SAAS,mBAAmB,EAAE,CAAC;CACpD,GACL,OAAO,CAAC,mBAAmB,CAAC,CA2E9B;AAED,wBAAsB,iBAAiB,CACrC,KAAK,EAAE,cAAc,EACrB,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,SAAS,yBAAyB,EAAE,EAC1C,OAAO,GAAE;IACP,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,qBAAqB,EAAE,CAAC;IACpD,QAAQ,CAAC,aAAa,CAAC,EAAE,SAAS,mBAAmB,EAAE,CAAC;CACpD,GACL,OAAO,CAAC,SAAS,mBAAmB,EAAE,CAAC,CAUzC;AAED,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,mBAAmB,GAAG,OAAO,CAKtE"}
+{"version":3,"file":"answer-gaps.d.ts","sourceRoot":"","sources":["../../../../src/platform/knowledge/semantic/answer-gaps.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,KAAK,EAAE,mBAAmB,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAC9E,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,YAAY,CAAC;AAgB5D,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,EACb,aAAa,EAAE,SAAS,mBAAmB,EAAE,GAC5C,OAAO,CAKT;AAED,wBAAsB,gBAAgB,CACpC,KAAK,EAAE,cAAc,EACrB,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACd,OAAO,GAAE;IACP,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACtC,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,qBAAqB,EAAE,GAAG,SAAS,CAAC;IAChE,QAAQ,CAAC,aAAa,CAAC,EAAE,SAAS,mBAAmB,EAAE,GAAG,SAAS,CAAC;CAChE,GACL,OAAO,CAAC,mBAAmB,CAAC,CA6E9B;AAED,wBAAsB,iBAAiB,CACrC,KAAK,EAAE,cAAc,EACrB,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,SAAS,yBAAyB,EAAE,EAC1C,OAAO,GAAE;IACP,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,qBAAqB,EAAE,GAAG,SAAS,CAAC;IAChE,QAAQ,CAAC,aAAa,CAAC,EAAE,SAAS,mBAAmB,EAAE,GAAG,SAAS,CAAC;CAChE,GACL,OAAO,CAAC,SAAS,mBAAmB,EAAE,CAAC,CAUzC;AAED,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,mBAAmB,GAAG,OAAO,CAKtE"}

package/dist/platform/knowledge/semantic/answer-gaps.js

@@ -16,75 +16,77 @@ export async function persistAnswerGap(store, spaceId, query, reason, context =
     const fingerprint = answerGapFingerprint(spaceId, query, subject, linkedObjects[0]?.id);
     const id = `sem-answer-gap-${fingerprint}`;
     const existing = store.getNode(id);
-    const node = await store.upsertNode({
-        id,
-        kind: 'knowledge_gap',
-        slug: `answer-gap-${fingerprint}`,
-        title: query,
-        summary: reason,
-        confidence: 70,
-        ...(sources[0] ? { sourceId: sources[0].id } : {}),
-        metadata: semanticMetadata(spaceId, {
-            semanticKind: 'gap',
-            gapKind: 'answer',
-            query,
-            reason,
-            subject,
-            subjectFingerprint: fingerprint,
-            sourceIds: sources.map((source) => source.id),
-            linkedObjectIds: linkedObjects.map((node) => node.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 } : {}),
-            visibility: 'refinement',
-            displayRole: 'knowledge-gap',
-        }),
-    });
-    for (const source of sources) {
-        await store.upsertEdge({
-            fromKind: 'source',
-            fromId: source.id,
-            toKind: 'node',
-            toId: node.id,
-            relation: 'has_gap',
-            metadata: semanticMetadata(spaceId, { gapKind: 'answer' }),
-        });
-    }
-    for (const object of linkedObjects) {
-        await store.upsertEdge({
-            fromKind: 'node',
-            fromId: object.id,
-            toKind: 'node',
-            toId: node.id,
-            relation: 'has_gap',
-            metadata: semanticMetadata(spaceId, { gapKind: 'answer' }),
-        });
-    }
-    if (!isRepairedAnswerGap(node)) {
-        await store.upsertIssue({
-            id: `sem-answer-gap-issue-${fingerprint}`,
-            severity: 'info',
-            code: 'knowledge.answer_gap',
-            message: `No knowledge answer available for: ${query}`,
-            status: 'open',
+    return store.batch(async () => {
+        const node = await store.upsertNode({
+            id,
+            kind: 'knowledge_gap',
+            slug: `answer-gap-${fingerprint}`,
+            title: query,
+            summary: reason,
+            confidence: 70,
             ...(sources[0] ? { sourceId: sources[0].id } : {}),
-            nodeId: node.id,
             metadata: semanticMetadata(spaceId, {
-                namespace: `knowledge:${spaceId}:answers`,
+                semanticKind: 'gap',
+                gapKind: 'answer',
                 query,
                 reason,
                 subject,
                 subjectFingerprint: fingerprint,
                 sourceIds: sources.map((source) => source.id),
-                linkedObjectIds: linkedObjects.map((entry) => entry.id),
+                linkedObjectIds: linkedObjects.map((node) => node.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 } : {}),
+                visibility: 'refinement',
+                displayRole: 'knowledge-gap',
             }),
         });
-    }
-    else {
-        await resolveAnswerGapIssues(store, spaceId, node.id);
-    }
-    return node;
+        for (const source of sources) {
+            await store.upsertEdge({
+                fromKind: 'source',
+                fromId: source.id,
+                toKind: 'node',
+                toId: node.id,
+                relation: 'has_gap',
+                metadata: semanticMetadata(spaceId, { gapKind: 'answer' }),
+            });
+        }
+        for (const object of linkedObjects) {
+            await store.upsertEdge({
+                fromKind: 'node',
+                fromId: object.id,
+                toKind: 'node',
+                toId: node.id,
+                relation: 'has_gap',
+                metadata: semanticMetadata(spaceId, { gapKind: 'answer' }),
+            });
+        }
+        if (!isRepairedAnswerGap(node)) {
+            await store.upsertIssue({
+                id: `sem-answer-gap-issue-${fingerprint}`,
+                severity: 'info',
+                code: 'knowledge.answer_gap',
+                message: `No knowledge answer available for: ${query}`,
+                status: 'open',
+                ...(sources[0] ? { sourceId: sources[0].id } : {}),
+                nodeId: node.id,
+                metadata: semanticMetadata(spaceId, {
+                    namespace: `knowledge:${spaceId}:answers`,
+                    query,
+                    reason,
+                    subject,
+                    subjectFingerprint: fingerprint,
+                    sourceIds: sources.map((source) => source.id),
+                    linkedObjectIds: linkedObjects.map((entry) => entry.id),
+                }),
+            });
+        }
+        else {
+            await resolveAnswerGapIssues(store, spaceId, node.id);
+        }
+        return node;
+    });
 }
 export async function persistAnswerGaps(store, spaceId, query, gaps, context = {}) {
     const nodes = [];

package/dist/platform/knowledge/semantic/answer-llm.d.ts

@@ -0,0 +1,5 @@
+import type { KnowledgeSemanticLlm, KnowledgeSemanticLlmAnswer } from './types.js';
+import type { EvidenceItem } from './answer-common.js';
+export declare function synthesizeAnswer(llm: KnowledgeSemanticLlm | null, query: string, mode: string, evidence: readonly EvidenceItem[], requestedTimeoutMs: number | undefined): Promise<KnowledgeSemanticLlmAnswer | null>;
+export declare function answerConfidence(answer: KnowledgeSemanticLlmAnswer | null, evidence: readonly EvidenceItem[]): number;
+//# sourceMappingURL=answer-llm.d.ts.map

package/dist/platform/knowledge/semantic/answer-llm.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"answer-llm.d.ts","sourceRoot":"","sources":["../../../../src/platform/knowledge/semantic/answer-llm.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,oBAAoB,EACpB,0BAA0B,EAC3B,MAAM,YAAY,CAAC;AACpB,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAYvD,wBAAsB,gBAAgB,CACpC,GAAG,EAAE,oBAAoB,GAAG,IAAI,EAChC,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,SAAS,YAAY,EAAE,EACjC,kBAAkB,EAAE,MAAM,GAAG,SAAS,GACrC,OAAO,CAAC,0BAA0B,GAAG,IAAI,CAAC,CAgC5C;AAED,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,0BAA0B,GAAG,IAAI,EAAE,QAAQ,EAAE,SAAS,YAAY,EAAE,GAAG,MAAM,CAKrH"}

package/dist/platform/knowledge/semantic/answer-llm.js

@@ -0,0 +1,99 @@
+import { MAX_ANSWER_EVIDENCE_CHARS, clampText, readRecord, readString, readStringArray, } from './utils.js';
+import { renderFactForPrompt } from './answer-fact-selection.js';
+import { uniqueNodes } from './answer-evidence.js';
+import { clampTimeoutMs, withTimeoutOrNull } from './timeouts.js';
+export async function synthesizeAnswer(llm, query, mode, evidence, requestedTimeoutMs) {
+    if (!llm)
+        return null;
+    const timeoutMs = clampTimeoutMs(requestedTimeoutMs, 15_000, 1_000, 15_000);
+    const controller = new AbortController();
+    const response = await withTimeoutOrNull(llm.completeJson({
+        purpose: 'knowledge-answer-synthesis',
+        maxTokens: mode === 'detailed' ? 2200 : mode === 'concise' ? 700 : 1400,
+        signal: controller.signal,
+        timeoutMs,
+        systemPrompt: [
+            'You answer questions from a GoodVibes self-improving knowledge wiki.',
+            'Use only the supplied evidence. Synthesize the answer for the user intent rather than dumping snippets.',
+            'If evidence is insufficient, say what is missing. Prefer concrete features, specs, procedures, and relationships.',
+            'For feature or specification questions, ignore manual boilerplate about accessories, cable recommendations, USB/HDMI physical-fit guidance, button maps, remote aiming instructions, batteries, cleaning, servicing, safety, furniture, wall mounting, and future product changes unless the user asks about those topics.',
+            'Do not mention future features, specifications changing without notice, cable fit, USB extension cables, remote sensor aiming, service personnel, or child-safety/furniture/platform guidance in a feature/spec answer.',
+            'Return only JSON with answer, confidence, usedSourceIds, usedNodeIds, and optional gaps.',
+        ].join(' '),
+        prompt: JSON.stringify({
+            query,
+            mode,
+            evidence: renderEvidenceForPrompt(evidence),
+            outputShape: {
+                answer: 'source-backed natural language answer',
+                confidence: 0,
+                usedSourceIds: ['source ids used'],
+                usedNodeIds: ['node ids used'],
+                gaps: [{ question: 'unanswered follow-up gap', reason: 'missing evidence', severity: 'info' }],
+            },
+        }),
+    }), timeoutMs);
+    controller.abort();
+    return normalizeLlmAnswer(response);
+}
+export function answerConfidence(answer, evidence) {
+    if (typeof answer?.confidence === 'number')
+        return answer.confidence;
+    const top = evidence[0]?.score ?? 0;
+    const factBoost = Math.min(35, uniqueNodes(evidence.flatMap((item) => item.facts)).length * 4);
+    return Math.max(10, Math.min(92, Math.round(top / 5) + factBoost));
+}
+function renderEvidenceForPrompt(evidence) {
+    let budget = MAX_ANSWER_EVIDENCE_CHARS;
+    const rendered = [];
+    for (const item of evidence.slice(0, 12)) {
+        if (budget <= 0)
+            break;
+        const factText = item.facts.slice(0, 16).map(renderFactForPrompt).join('\n');
+        const excerpt = clampText(item.excerpt, Math.min(1600, budget));
+        const record = {
+            kind: item.kind,
+            id: item.id,
+            title: item.title,
+            sourceId: item.source?.id,
+            nodeId: item.node?.id,
+            sourceType: item.source?.sourceType,
+            nodeKind: item.node?.kind,
+            excerpt,
+            facts: factText,
+        };
+        budget -= JSON.stringify(record).length;
+        rendered.push(record);
+    }
+    return rendered;
+}
+function normalizeLlmAnswer(value) {
+    const record = readRecord(value);
+    const answer = readString(record.answer);
+    if (!answer)
+        return null;
+    return {
+        answer,
+        ...(typeof record.confidence === 'number' ? { confidence: Math.max(0, Math.min(100, Math.round(record.confidence))) } : {}),
+        usedSourceIds: readStringArray(record.usedSourceIds),
+        usedNodeIds: readStringArray(record.usedNodeIds),
+        gaps: readGapArray(record.gaps),
+    };
+}
+function readGapArray(value) {
+    if (!Array.isArray(value))
+        return [];
+    return value.flatMap((entry) => {
+        const record = readRecord(entry);
+        const question = readString(record.question);
+        if (!question)
+            return [];
+        const severity = readString(record.severity);
+        return [{
+                question,
+                ...(readString(record.reason) ? { reason: readString(record.reason) } : {}),
+                ...(readString(record.subject) ? { subject: readString(record.subject) } : {}),
+                severity: severity === 'warning' || severity === 'error' ? severity : 'info',
+            }];
+    });
+}

package/dist/platform/knowledge/semantic/answer-quality.d.ts

@@ -1,10 +1,10 @@
 import type { KnowledgeNodeRecord, KnowledgeSourceRecord } from '../types.js';
 export interface CleanSynthesizedAnswerOptions {
-    readonly fallbackText?: string;
+    readonly fallbackText?: string | undefined;
 }
 export declare function answerNeedsFeatureGap(input: {
     readonly query: string;
-    readonly text?: string;
+    readonly text?: string | undefined;
     readonly facts: readonly KnowledgeNodeRecord[];
     readonly sources: readonly KnowledgeSourceRecord[];
     readonly linkedObjects: readonly KnowledgeNodeRecord[];

package/dist/platform/knowledge/semantic/answer-quality.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"answer-quality.d.ts","sourceRoot":"","sources":["../../../../src/platform/knowledge/semantic/answer-quality.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAI9E,MAAM,WAAW,6BAA6B;IAC5C,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;CAChC;AAED,wBAAgB,qBAAqB,CAAC,KAAK,EAAE;IAC3C,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,KAAK,EAAE,SAAS,mBAAmB,EAAE,CAAC;IAC/C,QAAQ,CAAC,OAAO,EAAE,SAAS,qBAAqB,EAAE,CAAC;IACnD,QAAQ,CAAC,aAAa,EAAE,SAAS,mBAAmB,EAAE,CAAC;CACxD,GAAG,OAAO,CAoBV;AAED,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,MAAM,EACZ,aAAa,EAAE,OAAO,EACtB,OAAO,GAAE,6BAAkC,GAC1C,MAAM,CAiBR"}
+{"version":3,"file":"answer-quality.d.ts","sourceRoot":"","sources":["../../../../src/platform/knowledge/semantic/answer-quality.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAI9E,MAAM,WAAW,6BAA6B;IAC5C,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC5C;AAED,wBAAgB,qBAAqB,CAAC,KAAK,EAAE;IAC3C,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACnC,QAAQ,CAAC,KAAK,EAAE,SAAS,mBAAmB,EAAE,CAAC;IAC/C,QAAQ,CAAC,OAAO,EAAE,SAAS,qBAAqB,EAAE,CAAC;IACnD,QAAQ,CAAC,aAAa,EAAE,SAAS,mBAAmB,EAAE,CAAC;CACxD,GAAG,OAAO,CAoBV;AAED,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,MAAM,EACZ,aAAa,EAAE,OAAO,EACtB,OAAO,GAAE,6BAAkC,GAC1C,MAAM,CAiBR"}

package/dist/platform/knowledge/semantic/answer-quality.js

@@ -66,7 +66,7 @@ function hasBroadFeatureQueryIntent(query) {
     return /\b(features?|specs?|specifications?|capabilities|what can|what does .* have)\b/i.test(query);
 }
 function queryFeatureTerms(query) {
-    return Array.from(query.toLowerCase().matchAll(/\b(hdmi(?:\s*2\.1)?|usb|hdr10?|dolby vision|dolby|earc|arc|bluetooth|wi-?fi|ethernet|remote|refresh|120\s*hz|60\s*hz|ports?|speakers?|audio|apps?|airplay|homekit|tuner|atsc|qam|gaming|game|vrr|allm)\b/g)).map((match) => match[1].replace(/\s+/g, ' '));
+    return Array.from(query.toLowerCase().matchAll(/\b(hdmi(?:\s*2\.1)?|usb|hdr10?|dolby vision|dolby|earc|arc|bluetooth|wi-?fi|ethernet|remote|refresh|120\s*hz|60\s*hz|ports?|speakers?|audio|apps?|airplay|homekit|tuner|atsc|qam|gaming|game|vrr|allm)\b/g)).map((match) => (match[1] ?? '').replace(/\s+/g, ' '));
 }
 function featureSignalFamilyCount(text) {
     const lower = text.toLowerCase();

package/dist/platform/knowledge/semantic/answer-source-ranking.d.ts

@@ -1,7 +1,7 @@
 import type { KnowledgeNodeRecord, KnowledgeSourceRecord } from '../types.js';
 export interface AnswerSourceRankingEvidence {
     readonly score: number;
-    readonly source?: KnowledgeSourceRecord;
+    readonly source?: KnowledgeSourceRecord | undefined;
 }
 export declare function rankAnswerSources(evidence: readonly AnswerSourceRankingEvidence[], facts: readonly KnowledgeNodeRecord[]): KnowledgeSourceRecord[];
 export declare function sourceAuthorityBoostForAnswer(source: KnowledgeSourceRecord): number;

package/dist/platform/knowledge/semantic/answer-source-ranking.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"answer-source-ranking.d.ts","sourceRoot":"","sources":["../../../../src/platform/knowledge/semantic/answer-source-ranking.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAI9E,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,CAAC,EAAE,qBAAqB,CAAC;CACzC;AAED,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,SAAS,2BAA2B,EAAE,EAChD,KAAK,EAAE,SAAS,mBAAmB,EAAE,GACpC,qBAAqB,EAAE,CAwBzB;AAmBD,wBAAgB,6BAA6B,CAAC,MAAM,EAAE,qBAAqB,GAAG,MAAM,CAgBnF"}
+{"version":3,"file":"answer-source-ranking.d.ts","sourceRoot":"","sources":["../../../../src/platform/knowledge/semantic/answer-source-ranking.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAI9E,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,CAAC,EAAE,qBAAqB,GAAG,SAAS,CAAC;CACrD;AAED,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,SAAS,2BAA2B,EAAE,EAChD,KAAK,EAAE,SAAS,mBAAmB,EAAE,GACpC,qBAAqB,EAAE,CAgCzB;AAmBD,wBAAgB,6BAA6B,CAAC,MAAM,EAAE,qBAAqB,GAAG,MAAM,CAgBnF"}

package/dist/platform/knowledge/semantic/answer-source-ranking.js

@@ -1,5 +1,5 @@
 import { isGeneratedKnowledgeSource } from '../generated-projections.js';
-import { readRecord, readString } from './utils.js';
+import { readRecord, readString, readStringArray, uniqueStrings } from './utils.js';
 export function rankAnswerSources(evidence, facts) {
     const evidenceScoreBySource = new Map();
     for (const item of evidence) {
@@ -10,12 +10,20 @@ export function rankAnswerSources(evidence, facts) {
     const factCountBySource = new Map();
     const promotedFactCountBySource = new Map();
     for (const fact of facts) {
-        const sourceId = readString(fact.metadata.sourceId) ?? fact.sourceId;
-        if (!sourceId)
+        const sourceIds = uniqueStrings([
+            ...readStringArray(fact.metadata.sourceIds),
+            readString(fact.metadata.sourceId),
+            fact.sourceId,
+        ]);
+        if (sourceIds.length === 0)
             continue;
-        factCountBySource.set(sourceId, (factCountBySource.get(sourceId) ?? 0) + 1);
         if (readString(fact.metadata.extractor) === 'repair-promotion') {
-            promotedFactCountBySource.set(sourceId, (promotedFactCountBySource.get(sourceId) ?? 0) + 1);
+            for (const sourceId of sourceIds) {
+                promotedFactCountBySource.set(sourceId, (promotedFactCountBySource.get(sourceId) ?? 0) + 1);
+            }
+        }
+        for (const sourceId of sourceIds) {
+            factCountBySource.set(sourceId, (factCountBySource.get(sourceId) ?? 0) + 1);
         }
     }
     const sources = uniqueSources(evidence.flatMap((item) => item.source ? [item.source] : []));

package/dist/platform/knowledge/semantic/answer-space.d.ts

@@ -1,7 +1,7 @@
 import type { KnowledgeNodeRecord, KnowledgeSourceRecord } from '../types.js';
 interface AnswerEvidenceRecord {
-    readonly node?: KnowledgeNodeRecord;
-    readonly source?: KnowledgeSourceRecord;
+    readonly node?: KnowledgeNodeRecord | undefined;
+    readonly source?: KnowledgeSourceRecord | undefined;
 }
 export declare function concreteAnswerGapSpaceId(requestedSpaceId: string, evidence: readonly AnswerEvidenceRecord[], sources: readonly KnowledgeSourceRecord[], linkedObjects: readonly KnowledgeNodeRecord[]): string;
 export {};

package/dist/platform/knowledge/semantic/answer-space.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"answer-space.d.ts","sourceRoot":"","sources":["../../../../src/platform/knowledge/semantic/answer-space.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,mBAAmB,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAE9E,UAAU,oBAAoB;IAC5B,QAAQ,CAAC,IAAI,CAAC,EAAE,mBAAmB,CAAC;IACpC,QAAQ,CAAC,MAAM,CAAC,EAAE,qBAAqB,CAAC;CACzC;AAED,wBAAgB,wBAAwB,CACtC,gBAAgB,EAAE,MAAM,EACxB,QAAQ,EAAE,SAAS,oBAAoB,EAAE,EACzC,OAAO,EAAE,SAAS,qBAAqB,EAAE,EACzC,aAAa,EAAE,SAAS,mBAAmB,EAAE,GAC5C,MAAM,CAWR"}
+{"version":3,"file":"answer-space.d.ts","sourceRoot":"","sources":["../../../../src/platform/knowledge/semantic/answer-space.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,mBAAmB,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAE9E,UAAU,oBAAoB;IAC5B,QAAQ,CAAC,IAAI,CAAC,EAAE,mBAAmB,GAAG,SAAS,CAAC;IAChD,QAAQ,CAAC,MAAM,CAAC,EAAE,qBAAqB,GAAG,SAAS,CAAC;CACrD;AAED,wBAAgB,wBAAwB,CACtC,gBAAgB,EAAE,MAAM,EACxB,QAAQ,EAAE,SAAS,oBAAoB,EAAE,EACzC,OAAO,EAAE,SAAS,qBAAqB,EAAE,EACzC,aAAa,EAAE,SAAS,mBAAmB,EAAE,GAC5C,MAAM,CAWR"}

package/dist/platform/knowledge/semantic/answer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"answer.d.ts","sourceRoot":"","sources":["../../../../src/platform/knowledge/semantic/answer.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EACV,4BAA4B,EAC5B,6BAA6B,EAI9B,MAAM,YAAY,CAAC;AAmBpB,OAAO,EAGL,KAAK,sBAAsB,EAC5B,MAAM,oBAAoB,CAAC;AAwB5B,wBAAsB,oBAAoB,CACxC,OAAO,EAAE,sBAAsB,EAC/B,KAAK,EAAE,4BAA4B,GAClC,OAAO,CAAC,6BAA6B,CAAC,CAiIxC"}
+{"version":3,"file":"answer.d.ts","sourceRoot":"","sources":["../../../../src/platform/knowledge/semantic/answer.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EACV,4BAA4B,EAC5B,6BAA6B,EAE9B,MAAM,YAAY,CAAC;AAgBpB,OAAO,EAGL,KAAK,sBAAsB,EAC5B,MAAM,oBAAoB,CAAC;AAwB5B,wBAAsB,oBAAoB,CACxC,OAAO,EAAE,sBAAsB,EAC/B,KAAK,EAAE,4BAA4B,GAClC,OAAO,CAAC,6BAA6B,CAAC,CA4ExC"}