@pellux/goodvibes-sdk 0.28.15 → 0.28.17

package/dist/_internal/platform/knowledge/semantic/answer.js

@@ -6,11 +6,13 @@ import { concreteAnswerGapSpaceId } from './answer-space.js';
 import { answerNeedsFeatureGap, cleanSynthesizedAnswer } from './answer-quality.js';
 import { clampTimeoutMs, withTimeoutOrNull } from './timeouts.js';
 import { renderFallbackAnswer } from './answer-fallback.js';
+import { rankAnswerSources } from './answer-source-ranking.js';
 const GENERIC_ANSWER_INTENT_TOKENS = new Set([
     'capabilities',
     'capability',
     'configuration',
     'configure',
+    'device',
     'feature',
     'features',
     'function',
@@ -26,9 +28,11 @@ const GENERIC_ANSWER_INTENT_TOKENS = new Set([
     'specification',
     'specifications',
     'specs',
+    'object',
     'support',
     'supported',
     'supports',
+    'thing',
 ]);
 export async function answerKnowledgeQuery(context, input) {
     const spaceId = normalizeKnowledgeSpaceId(input.knowledgeSpaceId);
@@ -60,12 +64,22 @@ export async function answerKnowledgeQuery(context, input) {
     }
     const llmAnswer = await synthesizeAnswer(context.llm ?? null, input.query, mode, evidence, input.timeoutMs);
     const facts = filterFactsForQuery(input.query, uniqueNodes(evidence.flatMap((item) => item.facts))).slice(0, 24);
-    const sources = uniqueSources(evidence.flatMap((item) => item.source ? [item.source] : []))
+    const sources = rankAnswerSources(evidence, facts)
         .slice(0, limit)
         .map(withAnswerSourceAliases);
+    const inferredHomeAssistantLinkedObjects = input.includeLinkedObjects === false
+        ? []
+        : inferHomeAssistantLinkedObjects(context.store, spaceId, input.query);
+    const evidenceLinkedObjects = shouldUseEvidenceLinkedObjects(spaceId, input, inferredHomeAssistantLinkedObjects)
+        ? evidence.flatMap((item) => item.node ? [item.node] : [])
+        : [];
     const linkedObjects = input.includeLinkedObjects === false
         ? []
-        : uniqueNodes([...(input.linkedObjects ?? []), ...evidence.flatMap((item) => item.node ? [item.node] : [])])
+        : uniqueNodes([
+            ...(input.linkedObjects ?? []),
+            ...evidenceLinkedObjects,
+            ...inferredHomeAssistantLinkedObjects,
+        ])
             .filter(isSemanticAnswerLinkedObject)
             .slice(0, 24);
     const gapSpaceId = concreteAnswerGapSpaceId(spaceId, evidence, sources, linkedObjects);
@@ -86,8 +100,17 @@ export async function answerKnowledgeQuery(context, input) {
             linkedObjects,
         })
         : null;
-    const fallback = llmAnswer?.answer ? null : renderFallbackAnswer(input.query, mode, evidence, facts);
-    const text = cleanSynthesizedAnswer(llmAnswer?.answer?.trim() || fallback?.text || '', featureIntent);
+    const llmText = llmAnswer?.answer?.trim();
+    const cleanedLlmText = llmText ? cleanSynthesizedAnswer(llmText, featureIntent) : undefined;
+    const dropLowValueLlmAnswer = featureIntent && Boolean(cleanedLlmText) && isLowValueFeatureOrSpecText(cleanedLlmText ?? '');
+    const fallback = !llmText || dropLowValueLlmAnswer
+        ? renderFallbackAnswer(input.query, mode, evidence, facts)
+        : null;
+    const synthesizedAnswer = dropLowValueLlmAnswer ? undefined : cleanedLlmText;
+    const text = synthesizedAnswer || cleanSynthesizedAnswer(fallback?.text || '', featureIntent);
+    const confidence = input.includeConfidence === false
+        ? 0
+        : dropLowValueLlmAnswer ? 0 : answerConfidence(llmAnswer, evidence);
     return {
         ok: true,
         spaceId,
@@ -95,12 +118,12 @@ export async function answerKnowledgeQuery(context, input) {
         answer: {
             text,
             mode,
-            confidence: input.includeConfidence === false ? 0 : answerConfidence(llmAnswer, evidence),
+            confidence,
             sources: input.includeSources === false ? [] : sources,
             linkedObjects,
             facts,
             gaps: evidenceGap ? uniqueNodes([...gaps, evidenceGap]) : gaps,
-            synthesized: Boolean(llmAnswer?.answer) || Boolean(fallback?.synthesized),
+            synthesized: Boolean(synthesizedAnswer) || Boolean(fallback?.synthesized),
         },
         results: evidence.map(toSearchResult),
     };
@@ -198,6 +221,26 @@ function collectAnswerEvidence(store, input, spaceId, limit) {
         .sort((left, right) => right.score - left.score || left.id.localeCompare(right.id));
     return pruneEvidence(items, limit, broadHomeAssistantAlias);
 }
+function inferHomeAssistantLinkedObjects(store, spaceId, query) {
+    const tokens = expandQueryTokens(tokenizeSemanticQuery(query));
+    const subjectTokens = tokens.filter((token) => !GENERIC_ANSWER_INTENT_TOKENS.has(token));
+    const scope = inferHomeAssistantAnswerScope(store, spaceId, query, subjectTokens);
+    if (!scope || scope.anchorNodeIds.size === 0)
+        return [];
+    return store.listNodes(10_000)
+        .filter((node) => scope.anchorNodeIds.has(node.id))
+        .filter((node) => belongsToAnswerSpace(node, spaceId))
+        .filter(isSemanticAnswerLinkedObject);
+}
+function shouldUseEvidenceLinkedObjects(spaceId, input, inferredHomeAssistantLinkedObjects) {
+    if (input.linkedObjects?.length)
+        return true;
+    const normalized = normalizeKnowledgeSpaceId(spaceId);
+    if (normalized === 'homeassistant' || isHomeAssistantKnowledgeSpace(normalized)) {
+        return inferredHomeAssistantLinkedObjects.length > 0;
+    }
+    return true;
+}
 async function synthesizeAnswer(llm, query, mode, evidence, requestedTimeoutMs) {
     if (!llm)
         return null;
@@ -465,13 +508,25 @@ function sourceIdsLinkedToNodes(store, nodeIds, spaceId) {
     const sourceIds = new Set();
     if (nodeIds.size === 0)
         return sourceIds;
-    for (const edge of store.listEdges()) {
+    const edges = store.listEdges();
+    const factIds = new Set();
+    for (const edge of edges) {
         if (!belongsToAnswerSpace(edge, spaceId))
             continue;
         if (edge.fromKind === 'source' && edge.toKind === 'node' && nodeIds.has(edge.toId))
             sourceIds.add(edge.fromId);
         if (edge.fromKind === 'node' && nodeIds.has(edge.fromId) && edge.toKind === 'source')
             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 (!belongsToAnswerSpace(edge, spaceId))
+            continue;
+        if (edge.fromKind === 'source' && edge.toKind === 'node' && factIds.has(edge.toId) && edge.relation === 'supports_fact') {
+            sourceIds.add(edge.fromId);
+        }
     }
     return sourceIds;
 }

package/dist/_internal/platform/knowledge/semantic/fact-quality.d.ts

@@ -3,6 +3,5 @@ export declare function isSemanticAnswerLinkedObject(node: KnowledgeNodeRecord):
 export declare function semanticFactText(fact: KnowledgeNodeRecord): string;
 export declare function isLowValueFeatureOrSpecText(text: string): boolean;
 export declare function hasConcreteFeatureSignal(text: string): boolean;
-export declare function isUsefulHomeGraphSourceBackedNote(text: string): boolean;
 export declare function isUsefulHomeGraphPageFact(fact: KnowledgeNodeRecord): boolean;
 //# sourceMappingURL=fact-quality.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"fact-quality.d.ts","sourceRoot":"","sources":["../../../../../src/_internal/platform/knowledge/semantic/fact-quality.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAcvD,wBAAgB,4BAA4B,CAAC,IAAI,EAAE,mBAAmB,GAAG,OAAO,CAK/E;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,mBAAmB,GAAG,MAAM,CAQlE;AAED,wBAAgB,2BAA2B,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAmHjE;AAWD,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAE9D;AAED,wBAAgB,iCAAiC,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAcvE;AAED,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,mBAAmB,GAAG,OAAO,CAiB5E"}
+{"version":3,"file":"fact-quality.d.ts","sourceRoot":"","sources":["../../../../../src/_internal/platform/knowledge/semantic/fact-quality.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAcvD,wBAAgB,4BAA4B,CAAC,IAAI,EAAE,mBAAmB,GAAG,OAAO,CAK/E;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,mBAAmB,GAAG,MAAM,CAQlE;AAED,wBAAgB,2BAA2B,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAuHjE;AAWD,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAE9D;AAED,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,mBAAmB,GAAG,OAAO,CAiB5E"}

package/dist/_internal/platform/knowledge/semantic/fact-quality.js

@@ -29,6 +29,8 @@ export function semanticFactText(fact) {
 export function isLowValueFeatureOrSpecText(text) {
     const lower = text.toLowerCase();
     const magicRemoteDetail = /\bmagic remote\b/.test(lower) || /\bbluetooth\b/.test(lower);
+    if (/\?\s*$/.test(text.trim()))
+        return true;
     if (isTruncatedManualFragment(lower))
         return true;
     if (/\b(items? supplied|supplied items?|included accessories|optional extras?|sold separately|separate purchase|accessories may vary|contents? of (this )?manual|may be changed|may change|subject to change|without prior notice|available menus? and options?|certified cable|unapproved items?)\b/.test(lower)) {
@@ -42,7 +44,10 @@ export function isLowValueFeatureOrSpecText(text) {
     }
     if (/^\s*\d+\s*(yes|no)\b/.test(lower)
         || /^\s*\d+(hdmi|usb|audio|ports?|features?|smart)\b/.test(lower)
-        || /\b\d+\s+features such as\b/.test(lower)) {
+        || /^\s*0\s+ports\b/.test(lower)
+        || /\b\d+\s+features such as\b/.test(lower)
+        || /\b(case color|hardware cpu cores|hardware gpu cores)\b/.test(lower)
+        || /^\s*\d+\s*kg\d*/.test(lower)) {
         return true;
     }
     if (/\b(button|buttons|remote control)\b/.test(lower) && /[\u25b2\u25bc\u25c4\u25ba]|[▲▼◄►]|\\u25/.test(text)) {
@@ -156,23 +161,6 @@ function isTruncatedManualFragment(value) {
 export function hasConcreteFeatureSignal(text) {
     return /\b(hdmi|usb|hdr|hdr10|dolby|vision|earc|arc|bluetooth|wi-?fi|wireless lan|ethernet|voice|remote|game|filmmaker|airplay|chromecast|resolution|4k|8k|refresh|ports?|speakers?|audio|display|screen|apps?|streaming|matter|energy monitoring|scheduling|sensor|battery|z-?wave|zigbee|thread|motion|temperature|humidity|camera|recording|lock|garage|local control|api|automation|atsc|ntsc|qam|tuner|broadcast|rs-?232c|external control)\b/.test(text.toLowerCase());
 }
-export function isUsefulHomeGraphSourceBackedNote(text) {
-    if (isLowValueFeatureOrSpecText(text))
-        return false;
-    const lower = text.toLowerCase();
-    if (/\b(magic remote|remote control)\b/.test(lower))
-        return false;
-    const signalCount = [
-        /\b(hdmi|usb|ethernet|wi-?fi|bluetooth|airplay|miracast|chromecast)\b/,
-        /\b(hdr|hdr10|dolby vision|dolby atmos|filmmaker|game optimizer|freesync|g-sync|allm|vrr)\b/,
-        /\b(4k|8k|uhd|resolution|refresh rate|120\s*hz|60\s*hz|nanocell|led|lcd|display|screen)\b/,
-        /\b(tuner|atsc|qam|ntsc|codec|mpeg|dolby digital|audio formats?|video formats?)\b/,
-        /\b(ports?|speaker system|speaker power|channels?|arc|earc)\b/,
-    ].filter((pattern) => pattern.test(lower)).length;
-    return signalCount >= 2
-        || /\b(supported external devices|supports? .* (hdr|hdmi|usb|wi-?fi|bluetooth|earc|arc|4k|120\s*hz))\b/.test(lower)
-        || /\b(dtv audio supported codec|supported codecs?|supported audio formats?|supported video formats?|supported picture formats?)\b/.test(lower);
-}
 export function isUsefulHomeGraphPageFact(fact) {
     if (fact.status === 'stale')
         return false;

package/dist/_internal/platform/knowledge/semantic/gap-repair.js

@@ -18,6 +18,7 @@ async function repairKnowledgeGapsWithWeb(request, options) {
     const sourceLimit = Math.max(2, Math.min(5, request.maxSources ?? options.maxSources ?? options.maxIngest ?? 5));
     const searchLimit = Math.max(1, Math.min(5, options.maxSearches ?? queries.length));
     const existingCandidates = selectExistingRepairSources(request, options, sourceLimit);
+    const acceptedExisting = candidateCanonicalUris(existingCandidates);
     const searchResults = new Map();
     const providerIds = new Set();
     let lastError;
@@ -47,7 +48,7 @@ async function repairKnowledgeGapsWithWeb(request, options) {
                     continue;
                 searchResults.set(canonical, { ...result, searchQuery: query, searchProviderId: response.providerId });
             }
-            const partial = mergeRepairCandidates(existingCandidates, selectGapRepairCandidates([...searchResults.values()], existing, options, request, sourceLimit), sourceLimit);
+            const partial = mergeRepairCandidates(existingCandidates, selectGapRepairCandidates([...searchResults.values()], acceptedExisting, options, request, sourceLimit), sourceLimit);
             if (hasEnoughRepairEvidence(partial, options))
                 break;
         }
@@ -58,7 +59,7 @@ async function repairKnowledgeGapsWithWeb(request, options) {
         }
     }
     const allResults = [...searchResults.values()];
-    const candidates = mergeRepairCandidates(existingCandidates, selectGapRepairCandidates(allResults, existing, options, request, sourceLimit), sourceLimit);
+    const candidates = mergeRepairCandidates(existingCandidates, selectGapRepairCandidates(allResults, acceptedExisting, options, request, sourceLimit), sourceLimit);
     if (!hasEnoughRepairEvidence(candidates, options)) {
         return {
             searched: true,
@@ -228,7 +229,7 @@ function selectExistingRepairSources(request, options, sourceLimit) {
     const minimumConfidence = Math.max(1, Math.min(100, options.minConfidence ?? 70));
     const byDomain = new Map();
     for (const source of request.sources) {
-        if (source.status !== 'indexed' || isGeneratedOrSyntheticSource(source))
+        if ((source.status !== 'indexed' && source.status !== 'pending') || isGeneratedOrSyntheticSource(source))
             continue;
         const url = source.sourceUri ?? source.canonicalUri;
         if (!url)
@@ -251,7 +252,10 @@ function selectExistingRepairSources(request, options, sourceLimit) {
             ...(snippet ? { snippet } : {}),
         };
         const assessment = assessGapRepairSource(result, request.query, request);
-        if (assessment.confidence < minimumConfidence && !isOfficialOrVendorSource(assessment.reasons))
+        const officialOrVendor = isOfficialOrVendorSource(assessment.reasons);
+        if (source.status !== 'indexed' && !officialOrVendor)
+            continue;
+        if (assessment.confidence < minimumConfidence && !officialOrVendor)
             continue;
         byDomain.set(domain, {
             ...result,
@@ -262,6 +266,9 @@ function selectExistingRepairSources(request, options, sourceLimit) {
     }
     return [...byDomain.values()].sort(compareRepairCandidates).slice(0, sourceLimit);
 }
+function candidateCanonicalUris(candidates) {
+    return new Set(candidates.map((candidate) => canonicalizeUri(candidate.url)).filter((value) => Boolean(value)));
+}
 function assessGapRepairSource(result, query, request) {
     const searchable = [result.title, result.snippet, result.url, result.domain].filter(Boolean).join(' ').toLowerCase();
     const reasons = [];

package/dist/_internal/platform/knowledge/semantic/homeassistant-scope.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"homeassistant-scope.d.ts","sourceRoot":"","sources":["../../../../../src/_internal/platform/knowledge/semantic/homeassistant-scope.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,KAAK,EAAE,mBAAmB,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAI9E,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,aAAa,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IAC5C,QAAQ,CAAC,eAAe,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IAC9C,QAAQ,CAAC,UAAU,EAAE,SAAS,MAAM,EAAE,CAAC;CACxC;AAED,wBAAgB,qCAAqC,CACnD,KAAK,EAAE,cAAc,EACrB,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,GACZ,wBAAwB,GAAG,IAAI,CAIjC;AAED,wBAAgB,6BAA6B,CAC3C,KAAK,EAAE,cAAc,EACrB,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,EACb,aAAa,EAAE,SAAS,MAAM,EAAE,GAC/B,wBAAwB,GAAG,IAAI,CA6BjC;AAED,wBAAgB,gCAAgC,CAC9C,KAAK,EAAE,cAAc,EACrB,MAAM,EAAE,qBAAqB,EAC7B,KAAK,EAAE,wBAAwB,GAAG,IAAI,GACrC,OAAO,CAMT;AAED,wBAAgB,8BAA8B,CAC5C,IAAI,EAAE,mBAAmB,EACzB,KAAK,EAAE,wBAAwB,GAAG,IAAI,GACrC,OAAO,CAKT"}
+{"version":3,"file":"homeassistant-scope.d.ts","sourceRoot":"","sources":["../../../../../src/_internal/platform/knowledge/semantic/homeassistant-scope.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,KAAK,EAAE,mBAAmB,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAI9E,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,aAAa,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IAC5C,QAAQ,CAAC,eAAe,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IAC9C,QAAQ,CAAC,UAAU,EAAE,SAAS,MAAM,EAAE,CAAC;CACxC;AAED,wBAAgB,qCAAqC,CACnD,KAAK,EAAE,cAAc,EACrB,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,GACZ,wBAAwB,GAAG,IAAI,CAIjC;AAED,wBAAgB,6BAA6B,CAC3C,KAAK,EAAE,cAAc,EACrB,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,EACb,aAAa,EAAE,SAAS,MAAM,EAAE,GAC/B,wBAAwB,GAAG,IAAI,CAgCjC;AAED,wBAAgB,gCAAgC,CAC9C,KAAK,EAAE,cAAc,EACrB,MAAM,EAAE,qBAAqB,EAC7B,KAAK,EAAE,wBAAwB,GAAG,IAAI,GACrC,OAAO,CAMT;AAED,wBAAgB,8BAA8B,CAC5C,IAAI,EAAE,mBAAmB,EACzB,KAAK,EAAE,wBAAwB,GAAG,IAAI,GACrC,OAAO,CAKT"}

package/dist/_internal/platform/knowledge/semantic/homeassistant-scope.js

@@ -1,5 +1,5 @@
 import { getKnowledgeSpaceId, isHomeAssistantKnowledgeSpace, normalizeKnowledgeSpaceId } from '../spaces.js';
-import { readRecord, readString, scoreSemanticText, sourceSemanticText, tokenizeSemanticQuery } from './utils.js';
+import { readRecord, readString, scoreSemanticText, sourceSemanticText, tokenizeSemanticQuery, uniqueStrings } from './utils.js';
 export function inferHomeAssistantAnswerScopeForQuery(store, spaceId, query) {
     const subjectTokens = tokenizeSemanticQuery(query)
         .filter((token) => !GENERIC_ANSWER_INTENT_TOKENS.has(token));
@@ -9,19 +9,23 @@ export function inferHomeAssistantAnswerScope(store, spaceId, query, subjectToke
     const normalized = normalizeKnowledgeSpaceId(spaceId);
     if (normalized !== 'homeassistant' && !isHomeAssistantKnowledgeSpace(normalized))
         return null;
-    if (subjectTokens.length === 0)
+    const queryTokens = tokenizeSemanticQuery(query);
+    if (subjectTokens.length === 0 && queryTokens.length === 0)
         return null;
-    const singularObjectQuery = isSingularObjectQuery(query, subjectTokens);
+    const singularObjectQuery = isSingularObjectQuery(query, queryTokens);
     const strongIdentityTokens = subjectTokens.filter(isStrongIdentityToken);
     if (!singularObjectQuery && strongIdentityTokens.length === 0)
         return null;
+    if (singularObjectQuery && strongIdentityTokens.length === 0 && !hasSpecificObjectTypeToken(queryTokens))
+        return null;
     const linkedSourceQualityByNode = linkedSourceQualityByAnchor(store);
+    const anchorTokens = uniqueStrings([...subjectTokens, ...queryTokens]);
     const anchors = store.listNodes(10_000)
         .filter((node) => node.status !== 'stale' && isHomeAssistantObjectNode(node))
         .filter((node) => normalized === 'homeassistant' || normalizeKnowledgeSpaceId(getKnowledgeSpaceId(node)) === normalized)
         .map((node) => ({
         node,
-        score: scoreHomeAssistantObject(node, subjectTokens)
+        score: scoreHomeAssistantObject(node, anchorTokens)
             + Math.min(64, linkedSourceQualityByNode.get(node.id) ?? 0),
     }))
         .filter((entry) => entry.score > 0)
@@ -58,11 +62,21 @@ function sourceIdsLinkedToAnchors(store, anchorNodeIds) {
     const sourceIds = new Set();
     if (anchorNodeIds.size === 0)
         return sourceIds;
-    for (const edge of store.listEdges()) {
+    const edges = store.listEdges();
+    const factIds = new Set();
+    for (const edge of edges) {
         if (edge.fromKind === 'source' && edge.toKind === 'node' && anchorNodeIds.has(edge.toId))
             sourceIds.add(edge.fromId);
         if (edge.fromKind === 'node' && anchorNodeIds.has(edge.fromId) && edge.toKind === 'source')
             sourceIds.add(edge.toId);
+        if (edge.fromKind === 'node' && edge.toKind === 'node' && anchorNodeIds.has(edge.toId) && edge.relation === 'describes') {
+            factIds.add(edge.fromId);
+        }
+    }
+    for (const edge of edges) {
+        if (edge.fromKind === 'source' && edge.toKind === 'node' && factIds.has(edge.toId) && edge.relation === 'supports_fact') {
+            sourceIds.add(edge.fromId);
+        }
     }
     return sourceIds;
 }
@@ -85,6 +99,25 @@ function linkedSourceQualityByAnchor(store) {
             scores.set(edge.fromId, (scores.get(edge.fromId) ?? 0) + score);
         }
     }
+    const describingFacts = new Map();
+    for (const edge of store.listEdges()) {
+        if (edge.fromKind === 'node' && edge.toKind === 'node' && edge.relation === 'describes') {
+            const current = describingFacts.get(edge.fromId) ?? new Set();
+            current.add(edge.toId);
+            describingFacts.set(edge.fromId, current);
+        }
+    }
+    for (const edge of store.listEdges()) {
+        if (edge.fromKind !== 'source' || edge.toKind !== 'node' || edge.relation !== 'supports_fact')
+            continue;
+        const source = sourcesById.get(edge.fromId);
+        if (!source)
+            continue;
+        const score = linkedSourceQuality(source, edge.relation);
+        for (const anchorId of describingFacts.get(edge.toId) ?? []) {
+            scores.set(anchorId, (scores.get(anchorId) ?? 0) + score);
+        }
+    }
     return scores;
 }
 function linkedSourceQuality(source, relation) {
@@ -169,6 +202,31 @@ function isSingularObjectQuery(query, tokens) {
 function isStrongIdentityToken(token) {
     return token.length >= 4 && !GENERIC_ANCHOR_TOKENS.has(token);
 }
+function hasSpecificObjectTypeToken(tokens) {
+    return tokens.some((token) => SPECIFIC_OBJECT_TYPE_TOKENS.has(token));
+}
+const SPECIFIC_OBJECT_TYPE_TOKENS = new Set([
+    'appliance',
+    'bridge',
+    'camera',
+    'console',
+    'doorbell',
+    'garage',
+    'hub',
+    'lock',
+    'phone',
+    'printer',
+    'projector',
+    'remote',
+    'router',
+    'sensor',
+    'speaker',
+    'switch',
+    'television',
+    'thermostat',
+    'tv',
+    'xbox',
+]);
 function sourceMatchesAnchor(sourceText, anchorText) {
     const tokens = anchorText
         .toLowerCase()

package/dist/_internal/platform/knowledge/semantic/repair-profile.d.ts

@@ -0,0 +1,16 @@
+import type { KnowledgeSourceRecord } from '../types.js';
+export interface RepairProfileFact {
+    readonly kind: 'feature' | 'capability' | 'specification' | 'compatibility' | 'configuration';
+    readonly title: string;
+    readonly value?: string;
+    readonly summary: string;
+    readonly evidence: string;
+    readonly labels: readonly string[];
+    readonly aliases: readonly string[];
+}
+export declare function deriveRepairProfileFacts(input: {
+    readonly query: string;
+    readonly source: KnowledgeSourceRecord;
+    readonly text: string;
+}): readonly RepairProfileFact[];
+//# sourceMappingURL=repair-profile.d.ts.map

package/dist/_internal/platform/knowledge/semantic/repair-profile.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"repair-profile.d.ts","sourceRoot":"","sources":["../../../../../src/_internal/platform/knowledge/semantic/repair-profile.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAIzD,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,IAAI,EAAE,SAAS,GAAG,YAAY,GAAG,eAAe,GAAG,eAAe,GAAG,eAAe,CAAC;IAC9F,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;IACnC,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;CACrC;AA0HD,wBAAgB,wBAAwB,CAAC,KAAK,EAAE;IAC9C,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,qBAAqB,CAAC;IACvC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB,GAAG,SAAS,iBAAiB,EAAE,CA8B/B"}

package/dist/_internal/platform/knowledge/semantic/repair-profile.js

@@ -0,0 +1,152 @@
+import { hasConcreteFeatureSignal, isLowValueFeatureOrSpecText } from './fact-quality.js';
+import { clampText, normalizeWhitespace, uniqueStrings } from './utils.js';
+const PROFILE_RULES = [
+    {
+        title: 'Display and picture specifications',
+        kind: 'specification',
+        labels: ['display', 'picture'],
+        aliases: ['display', 'picture', 'screen'],
+        intent: /\b(display|screen|resolution|picture|panel|hdr|refresh|hz|dolby vision|nanocell|lcd|led|oled)\b/,
+        minimumMatches: 2,
+        terms: [
+            ['86-inch class screen', /\b86(?:\.0)?\s*(?:inch|inches|in\.|")\b|\b86nano/i],
+            ['4K UHD resolution', /\b4k\b|\buhd\b|\b3840\s*(?:x|×)\s*2160\b/i],
+            ['NanoCell display technology', /\bnanocell\b/i],
+            ['LCD/LED display', /\blcd\b|\bled\b/i],
+            ['100/120 Hz refresh-rate evidence', /\b(?:100|120)\s*hz\b|\btrumotion\s*240\b/i],
+            ['HDR10', /\bhdr10\b/i],
+            ['Dolby Vision', /\bdolby vision\b/i],
+            ['HLG', /\bhlg\b/i],
+        ],
+    },
+    {
+        title: 'Input and output ports',
+        kind: 'specification',
+        labels: ['ports', 'connectivity'],
+        aliases: ['ports', 'inputs', 'outputs', 'connectivity'],
+        intent: /\b(port|ports|input|output|i\/o|hdmi|usb|optical|rf|antenna|ethernet|rs-?232|composite|component|earc|arc)\b/,
+        minimumMatches: 2,
+        terms: [
+            ['HDMI inputs', /\bhdmi\b/i],
+            ['HDMI ARC/eARC', /\bearc\b|\barc\b/i],
+            ['USB ports', /\busb\b/i],
+            ['Ethernet', /\bethernet\b|\brj-?45\b/i],
+            ['Optical audio output', /\boptical\b|\btoslink\b/i],
+            ['RF antenna input', /\brf\b|\bantenna\b/i],
+            ['Composite/component video', /\bcomposite\b|\bcomponent\b/i],
+            ['RS-232C/external control', /\brs-?232c?\b|\bexternal control\b/i],
+        ],
+    },
+    {
+        title: 'Smart TV platform and integrations',
+        kind: 'feature',
+        labels: ['smart-tv', 'apps'],
+        aliases: ['smart tv', 'apps', 'platform'],
+        intent: /\b(smart|webos|apps?|streaming|airplay|homekit|thinq|voice|assistant|alexa|google assistant)\b/,
+        minimumMatches: 1,
+        terms: [
+            ['webOS smart TV platform', /\bwebos\b/i],
+            ['LG ThinQ AI', /\bthinq\b/i],
+            ['Apple AirPlay 2', /\bairplay\s*2?\b/i],
+            ['Apple HomeKit', /\bhomekit\b/i],
+            ['voice assistant support', /\bvoice\b|\balexa\b|\bgoogle assistant\b/i],
+            ['streaming app support', /\bapps?\b|\bstreaming\b/i],
+        ],
+    },
+    {
+        title: 'Network and wireless capabilities',
+        kind: 'capability',
+        labels: ['network', 'wireless'],
+        aliases: ['network', 'wireless', 'bluetooth', 'wi-fi'],
+        intent: /\b(wi-?fi|wireless|bluetooth|ethernet|network|lan)\b/,
+        minimumMatches: 1,
+        terms: [
+            ['Wi-Fi/wireless LAN', /\bwi-?fi\b|\bwireless lan\b/i],
+            ['Bluetooth', /\bbluetooth\b/i],
+            ['Ethernet/LAN', /\bethernet\b|\blan\b/i],
+        ],
+    },
+    {
+        title: 'Gaming and HDMI features',
+        kind: 'feature',
+        labels: ['gaming', 'hdmi'],
+        aliases: ['gaming', 'game mode', 'hdmi 2.1'],
+        intent: /\b(game|gaming|vrr|allm|freesync|g-?sync|low latency|hdmi\s*2\.1|4k\s*120)\b/,
+        minimumMatches: 1,
+        terms: [
+            ['FreeSync/VRR evidence', /\bfreesync\b|\bvrr\b/i],
+            ['ALLM/low latency evidence', /\ballm\b|\blow latency\b/i],
+            ['Game Optimizer/game mode', /\bgame optimizer\b|\bgame mode\b|\bgaming\b/i],
+            ['HDMI 2.1/high-bandwidth HDMI evidence', /\bhdmi\s*2\.1\b|\b4k\s*(?:at|@)?\s*120\b|\b120\s*hz\b/i],
+        ],
+    },
+    {
+        title: 'Audio capabilities',
+        kind: 'specification',
+        labels: ['audio'],
+        aliases: ['audio', 'speakers', 'sound'],
+        intent: /\b(audio|speaker|sound|dolby atmos|dolby digital|earc|arc|watts?|channels?)\b/,
+        minimumMatches: 1,
+        terms: [
+            ['speaker/audio output evidence', /\bspeakers?\b|\b(?:10|20|40)\s*w\b|\b2(?:\.0)?\s*ch\b/i],
+            ['Dolby audio formats', /\bdolby atmos\b|\bdolby digital\b|\bdolby audio\b/i],
+            ['HDMI ARC/eARC audio', /\bearc\b|\barc\b/i],
+            ['supported audio formats', /\bsupported audio formats?\b|\bpcm\b|\btruehd\b/i],
+        ],
+    },
+    {
+        title: 'Tuner and broadcast support',
+        kind: 'specification',
+        labels: ['tuner', 'broadcast'],
+        aliases: ['tuner', 'broadcast', 'antenna'],
+        intent: /\b(tuner|atsc|ntsc|qam|broadcast|clear qam|antenna)\b/,
+        minimumMatches: 1,
+        terms: [
+            ['ATSC tuner support', /\batsc\b/i],
+            ['NTSC analog tuner support', /\bntsc\b/i],
+            ['Clear QAM support', /\bqam\b|\bclear qam\b/i],
+            ['RF/antenna input', /\brf\b|\bantenna\b/i],
+        ],
+    },
+];
+export function deriveRepairProfileFacts(input) {
+    const text = normalizeWhitespace([
+        input.source.title,
+        input.source.summary,
+        input.source.description,
+        input.source.sourceUri,
+        input.source.canonicalUri,
+        input.text,
+    ].filter(Boolean).join(' '));
+    if (!hasConcreteFeatureSignal(text))
+        return [];
+    const query = input.query.toLowerCase();
+    const broadProfileIntent = /\b(features?|specifications?|profile|capabilities)\b/.test(query);
+    return PROFILE_RULES.flatMap((rule) => {
+        const values = uniqueStrings(rule.terms
+            .filter(([, pattern]) => pattern.test(text))
+            .map(([label]) => label));
+        const wanted = broadProfileIntent || rule.intent.test(query);
+        if (values.length < (wanted ? 1 : rule.minimumMatches))
+            return [];
+        const summary = `${rule.title} evidence includes ${joinValues(values)}.`;
+        if (isLowValueFeatureOrSpecText(summary))
+            return [];
+        return [{
+                kind: rule.kind,
+                title: rule.title,
+                value: values.join(', '),
+                summary,
+                evidence: clampText(summary, 360),
+                labels: rule.labels,
+                aliases: rule.aliases,
+            }];
+    }).slice(0, 10);
+}
+function joinValues(values) {
+    if (values.length <= 1)
+        return values[0] ?? '';
+    if (values.length === 2)
+        return `${values[0]} and ${values[1]}`;
+    return `${values.slice(0, -1).join(', ')}, and ${values[values.length - 1]}`;
+}

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

@@ -7,5 +7,5 @@ export interface SelfImprovePromotionContext {
         readonly knowledgeSpaceId?: string;
     }) => Promise<unknown>;
 }
-export declare function promoteRepairSources(context: SelfImprovePromotionContext, spaceId: string, gap: KnowledgeNodeRecord, sourceIds: readonly string[], task: KnowledgeRefinementTaskRecord, deadlineAt: number): Promise<void>;
+export declare function promoteRepairSources(context: SelfImprovePromotionContext, spaceId: string, gap: KnowledgeNodeRecord, sourceIds: readonly string[], task: KnowledgeRefinementTaskRecord, deadlineAt: number): Promise<number>;
 //# sourceMappingURL=self-improvement-promotion.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"self-improvement-promotion.d.ts","sourceRoot":"","sources":["../../../../../src/_internal/platform/knowledge/semantic/self-improvement-promotion.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,KAAK,EAEV,mBAAmB,EACnB,6BAA6B,EAE9B,MAAM,aAAa,CAAC;AAiBrB,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,CAAC,KAAK,EAAE,cAAc,CAAC;IAC/B,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,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,IAAI,CAAC,CAoBf"}
+{"version":3,"file":"self-improvement-promotion.d.ts","sourceRoot":"","sources":["../../../../../src/_internal/platform/knowledge/semantic/self-improvement-promotion.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,KAAK,EAEV,mBAAmB,EACnB,6BAA6B,EAE9B,MAAM,aAAa,CAAC;AAkBrB,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,CAAC,KAAK,EAAE,cAAc,CAAC;IAC/B,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,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,MAAM,CAAC,CAwBjB"}