@pellux/goodvibes-sdk 0.28.17 → 0.28.19

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

@@ -17,7 +17,9 @@ export function rankAnswerSources(evidence, facts) {
             promotedFactCountBySource.set(sourceId, (promotedFactCountBySource.get(sourceId) ?? 0) + 1);
         }
     }
-    return uniqueSources(evidence.flatMap((item) => item.source ? [item.source] : []))
+    const sources = uniqueSources(evidence.flatMap((item) => item.source ? [item.source] : []));
+    const realSources = sources.filter((source) => source.metadata.homeGraphGeneratedPage !== true);
+    return (realSources.length > 0 ? realSources : sources)
         .sort((left, right) => (sourceAnswerQuality(right, evidenceScoreBySource, factCountBySource, promotedFactCountBySource)
         - sourceAnswerQuality(left, evidenceScoreBySource, factCountBySource, promotedFactCountBySource)
         || left.id.localeCompare(right.id)));
@@ -26,14 +28,14 @@ function sourceAnswerQuality(source, evidenceScoreBySource, factCountBySource, p
     const discovery = readRecord(source.metadata.sourceDiscovery);
     const rank = typeof discovery.sourceRank === 'number' ? Math.max(0, 12 - discovery.sourceRank) : 0;
     return Math.round((evidenceScoreBySource.get(source.id) ?? 0) / 4)
-        + sourceAuthorityBoost(source)
+        + sourceAuthorityBoostForAnswer(source)
         + Math.min(80, (factCountBySource.get(source.id) ?? 0) * 10)
         + Math.min(90, (promotedFactCountBySource.get(source.id) ?? 0) * 18)
         + rank * 4
         + (source.status === 'indexed' ? 12 : source.status === 'pending' ? 2 : 0)
         - (source.metadata.homeGraphGeneratedPage === true ? 90 : 0);
 }
-function sourceAuthorityBoost(source) {
+export function sourceAuthorityBoostForAnswer(source) {
     const discovery = readRecord(source.metadata.sourceDiscovery);
     const text = `${readString(discovery.trustReason) ?? ''} ${readString(discovery.sourceDomain) ?? ''} ${source.sourceUri ?? ''} ${source.canonicalUri ?? ''}`.toLowerCase();
     if (/\bofficial-vendor-domain\b/.test(text) || /(^|[/.])(?:lg|sony|samsung|apple)\.com\b/.test(text))

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

@@ -1 +1 @@
-{"version":3,"file":"answer.d.ts","sourceRoot":"","sources":["../../../../../src/_internal/platform/knowledge/semantic/answer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAYlD,OAAO,KAAK,EACV,4BAA4B,EAC5B,6BAA6B,EAE7B,oBAAoB,EAErB,MAAM,YAAY,CAAC;AAgCpB,UAAU,sBAAsB;IAC9B,QAAQ,CAAC,KAAK,EAAE,cAAc,CAAC;IAC/B,QAAQ,CAAC,GAAG,CAAC,EAAE,oBAAoB,GAAG,IAAI,CAAC;CAC5C;AAyCD,wBAAsB,oBAAoB,CACxC,OAAO,EAAE,sBAAsB,EAC/B,KAAK,EAAE,4BAA4B,GAClC,OAAO,CAAC,6BAA6B,CAAC,CA8FxC"}
+{"version":3,"file":"answer.d.ts","sourceRoot":"","sources":["../../../../../src/_internal/platform/knowledge/semantic/answer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAYlD,OAAO,KAAK,EACV,4BAA4B,EAC5B,6BAA6B,EAE7B,oBAAoB,EAErB,MAAM,YAAY,CAAC;AAiCpB,UAAU,sBAAsB;IAC9B,QAAQ,CAAC,KAAK,EAAE,cAAc,CAAC;IAC/B,QAAQ,CAAC,GAAG,CAAC,EAAE,oBAAoB,GAAG,IAAI,CAAC;CAC5C;AAyCD,wBAAsB,oBAAoB,CACxC,OAAO,EAAE,sBAAsB,EAC/B,KAAK,EAAE,4BAA4B,GAClC,OAAO,CAAC,6BAA6B,CAAC,CAyGxC"}

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

@@ -6,7 +6,8 @@ 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';
+import { rankAnswerSources, sourceAuthorityBoostForAnswer } from './answer-source-ranking.js';
+import { canonicalRepairSubjectNodes } from './repair-subjects.js';
 const GENERIC_ANSWER_INTENT_TOKENS = new Set([
     'capabilities',
     'capability',
@@ -38,42 +39,45 @@ export async function answerKnowledgeQuery(context, input) {
     const spaceId = normalizeKnowledgeSpaceId(input.knowledgeSpaceId);
     const mode = input.mode ?? 'standard';
     const limit = Math.max(1, input.limit ?? 8);
-    const evidence = collectAnswerEvidence(context.store, input, spaceId, limit);
+    let evidence = collectAnswerEvidence(context.store, input, spaceId, limit);
     if (evidence.length === 0) {
-        const linkedObjects = input.includeLinkedObjects === false ? [] : [...input.linkedObjects ?? []];
-        const gapSpaceId = concreteAnswerGapSpaceId(spaceId, [], [], linkedObjects);
-        const gap = await persistAnswerGap(context.store, gapSpaceId, input.query, 'No indexed evidence matched the question.', {
-            linkedObjects,
-        });
-        return {
-            ok: true,
-            spaceId,
-            query: input.query,
-            answer: {
-                text: input.noMatchMessage ?? `No knowledge matched "${input.query}".`,
-                mode,
-                confidence: 0,
-                sources: [],
-                linkedObjects,
-                facts: [],
-                gaps: [gap],
-                synthesized: false,
-            },
-            results: [],
-        };
+        const linkedObjects = input.includeLinkedObjects === false ? [] : filterAnswerLinkedObjects(spaceId, input.query, [...(input.linkedObjects ?? [])]);
+        const linkedEvidence = includeOfficialLinkedEvidence(context.store, spaceId, input.query, evidence, linkedObjects, limit);
+        if (linkedEvidence.length > 0) {
+            evidence = linkedEvidence;
+        }
+        else {
+            const gap = shouldPersistNoMatchGap(spaceId, input.query, linkedObjects)
+                ? await persistAnswerGap(context.store, concreteAnswerGapSpaceId(spaceId, [], [], linkedObjects), input.query, 'No indexed evidence matched the question.', {
+                    linkedObjects,
+                })
+                : null;
+            return {
+                ok: true,
+                spaceId,
+                query: input.query,
+                answer: {
+                    text: input.noMatchMessage ?? `No knowledge matched "${input.query}".`,
+                    mode,
+                    confidence: 0,
+                    sources: [],
+                    linkedObjects,
+                    facts: [],
+                    gaps: gap ? [gap] : [],
+                    synthesized: false,
+                },
+                results: [],
+            };
+        }
     }
-    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 = rankAnswerSources(evidence, facts)
-        .slice(0, limit)
-        .map(withAnswerSourceAliases);
+    let rawFacts = filterFactsForQuery(input.query, uniqueNodes(evidence.flatMap((item) => item.facts))).slice(0, 24);
     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
+    const rawLinkedObjects = input.includeLinkedObjects === false
         ? []
         : uniqueNodes([
             ...(input.linkedObjects ?? []),
@@ -82,6 +86,15 @@ export async function answerKnowledgeQuery(context, input) {
         ])
             .filter(isSemanticAnswerLinkedObject)
             .slice(0, 24);
+    const linkedObjects = filterAnswerLinkedObjects(spaceId, input.query, rawLinkedObjects);
+    evidence = includeOfficialLinkedEvidence(context.store, spaceId, input.query, evidence, linkedObjects, limit);
+    rawFacts = filterFactsForQuery(input.query, uniqueNodes(evidence.flatMap((item) => item.facts))).slice(0, 24);
+    const llmAnswer = await synthesizeAnswer(context.llm ?? null, input.query, mode, evidence, input.timeoutMs);
+    const rankedSources = rankAnswerSources(evidence, rawFacts);
+    const facts = withAnswerFactContract(context.store, rawFacts, linkedObjects);
+    const sources = includeOfficialLinkedSources(context.store, spaceId, rankedSources, linkedObjects)
+        .slice(0, limit)
+        .map(withAnswerSourceAliases);
     const gapSpaceId = concreteAnswerGapSpaceId(spaceId, evidence, sources, linkedObjects);
     const gaps = await persistAnswerGaps(context.store, gapSpaceId, input.query, llmAnswer?.gaps ?? [], {
         sources,
@@ -103,14 +116,14 @@ export async function answerKnowledgeQuery(context, input) {
     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 fallback = renderFallbackAnswer(input.query, mode, evidence, facts);
+    const preferFallback = shouldPreferFallbackAnswer(featureIntent, cleanedLlmText, fallback.text);
+    const useFallback = dropLowValueLlmAnswer || preferFallback || !cleanedLlmText;
+    const text = cleanSynthesizedAnswer((useFallback ? fallback.text : cleanedLlmText) || '', featureIntent);
+    const synthesized = useFallback ? fallback.synthesized : Boolean(cleanedLlmText);
     const confidence = input.includeConfidence === false
         ? 0
-        : dropLowValueLlmAnswer ? 0 : answerConfidence(llmAnswer, evidence);
+        : dropLowValueLlmAnswer || (useFallback && !fallback.synthesized) ? 0 : answerConfidence(preferFallback ? null : llmAnswer, evidence);
     return {
         ok: true,
         spaceId,
@@ -123,11 +136,19 @@ export async function answerKnowledgeQuery(context, input) {
             linkedObjects,
             facts,
             gaps: evidenceGap ? uniqueNodes([...gaps, evidenceGap]) : gaps,
-            synthesized: Boolean(synthesizedAnswer) || Boolean(fallback?.synthesized),
+            synthesized,
         },
         results: evidence.map(toSearchResult),
     };
 }
+function shouldPersistNoMatchGap(spaceId, query, linkedObjects) {
+    if (linkedObjects.length > 0)
+        return true;
+    if (normalizeKnowledgeSpaceId(spaceId) !== 'homeassistant')
+        return true;
+    const subjectTokens = tokenizeSemanticQuery(query).filter((token) => !GENERIC_ANSWER_INTENT_TOKENS.has(token));
+    return subjectTokens.length > 0;
+}
 function collectAnswerEvidence(store, input, spaceId, limit) {
     const tokens = expandQueryTokens(tokenizeSemanticQuery(input.query));
     if (tokens.length === 0)
@@ -140,13 +161,15 @@ function collectAnswerEvidence(store, input, spaceId, limit) {
     const sourceFacts = buildSourceFactIndex(store, spaceId);
     const linkedSourceIds = sourceIdsLinkedToNodes(store, new Set([...candidateNodeIds, ...linkedObjectIds]), spaceId);
     const broadHomeAssistantAlias = normalizeKnowledgeSpaceId(spaceId) === 'homeassistant' && !strictCandidates;
+    if (broadHomeAssistantAlias && subjectTokens.length === 0 && linkedObjectIds.size === 0)
+        return [];
     const homeAssistantScope = !strictCandidates
         ? inferHomeAssistantAnswerScope(store, spaceId, input.query, subjectTokens)
         : null;
     const sourceItems = store.listSources(10_000)
         .filter((source) => belongsToAnswerSpace(source, spaceId))
         .filter((source) => sourceInHomeAssistantAnswerScope(store, source, homeAssistantScope))
-        .filter((source) => !strictCandidates || candidateSourceIds.has(source.id) || (candidateSourceIds.size === 0 && linkedSourceIds.has(source.id)))
+        .filter((source) => !strictCandidates || candidateSourceIds.has(source.id) || linkedSourceIds.has(source.id))
         .map((source) => {
         const extraction = store.getExtractionBySourceId(source.id);
         const facts = filterFactsForQuery(input.query, sourceFacts.get(source.id) ?? []);
@@ -232,6 +255,16 @@ function inferHomeAssistantLinkedObjects(store, spaceId, query) {
         .filter((node) => belongsToAnswerSpace(node, spaceId))
         .filter(isSemanticAnswerLinkedObject);
 }
+function filterAnswerLinkedObjects(spaceId, query, nodes) {
+    const normalized = normalizeKnowledgeSpaceId(spaceId);
+    if (normalized !== 'homeassistant' && !isHomeAssistantKnowledgeSpace(normalized))
+        return nodes;
+    const canonical = canonicalRepairSubjectNodes({ nodes, text: query });
+    if (canonical.length > 0)
+        return canonical.slice(0, 24);
+    const integrationIntent = /\b(integration|platform|add-?on|addon|plugin|service|api|setup|configure|configuration|auth|credential|rate limit)\b/i.test(query);
+    return nodes.filter((node) => integrationIntent || node.kind !== 'ha_integration').slice(0, 24);
+}
 function shouldUseEvidenceLinkedObjects(spaceId, input, inferredHomeAssistantLinkedObjects) {
     if (input.linkedObjects?.length)
         return true;
@@ -241,6 +274,140 @@ function shouldUseEvidenceLinkedObjects(spaceId, input, inferredHomeAssistantLin
     }
     return true;
 }
+function withAnswerFactContract(store, facts, linkedObjects) {
+    if (facts.length === 0)
+        return [];
+    const linkedObjectIds = new Set(linkedObjects.map((node) => node.id));
+    return facts.map((fact) => {
+        const source = fact.sourceId ? store.getSource(fact.sourceId) : null;
+        const discovery = readRecord(source?.metadata.sourceDiscovery);
+        const metadataLinkedIds = uniqueStrings([
+            ...readStringArray(fact.metadata.linkedObjectIds),
+            ...readStringArray(fact.metadata.subjectIds),
+            ...readStringArray(discovery.linkedObjectIds),
+        ]);
+        const subjectIds = metadataLinkedIds.filter((id) => linkedObjectIds.has(id));
+        const fallbackSubjectIds = subjectIds.length > 0
+            ? subjectIds
+            : linkedObjects.length === 1 ? [linkedObjects[0].id] : [];
+        const subjects = fallbackSubjectIds
+            .map((id) => linkedObjects.find((node) => node.id === id) ?? store.getNode(id))
+            .filter((node) => Boolean(node && node.status !== 'stale'));
+        if (subjects.length === 0)
+            return fact;
+        const targetHints = answerTargetHints(subjects);
+        const metadata = {
+            ...fact.metadata,
+            subject: readString(fact.metadata.subject) ?? subjects[0]?.title,
+            subjectIds: subjects.map((node) => node.id),
+            linkedObjectIds: subjects.map((node) => node.id),
+            targetHints,
+        };
+        return {
+            ...fact,
+            metadata,
+            subject: metadata.subject,
+            subjectIds: metadata.subjectIds,
+            linkedObjectIds: metadata.linkedObjectIds,
+            targetHints,
+        };
+    });
+}
+function answerTargetHints(nodes) {
+    return nodes.map((node) => ({
+        id: node.id,
+        kind: node.kind,
+        title: node.title,
+        ...(node.summary ? { summary: node.summary } : {}),
+    }));
+}
+function includeOfficialLinkedSources(store, spaceId, rankedSources, linkedObjects) {
+    if (linkedObjects.length === 0)
+        return rankedSources;
+    const linkedIds = new Set(linkedObjects.map((node) => node.id));
+    const linkedSourceIds = sourceIdsLinkedToNodes(store, linkedIds, spaceId);
+    const official = store.listSources(10_000)
+        .filter((source) => belongsToAnswerSpace(source, spaceId))
+        .filter((source) => sourceAuthorityBoostForAnswer(source) > 0)
+        .filter((source) => {
+        const discovery = readRecord(source.metadata.sourceDiscovery);
+        return linkedSourceIds.has(source.id)
+            || readStringArray(discovery.linkedObjectIds).some((id) => linkedIds.has(id));
+    })
+        .sort((left, right) => sourceAuthorityBoostForAnswer(right) - sourceAuthorityBoostForAnswer(left));
+    return uniqueSources([...official, ...rankedSources]);
+}
+function includeOfficialLinkedEvidence(store, spaceId, query, evidence, linkedObjects, limit) {
+    if (linkedObjects.length === 0)
+        return [...evidence];
+    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 officialItems = store.listSources(10_000)
+        .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)))
+        .map((source) => {
+        const extraction = store.getExtractionBySourceId(source.id);
+        const facts = filterFactsForQuery(query, sourceFacts.get(source.id) ?? []);
+        const text = sourceSemanticText(source, extraction);
+        const scoringText = [
+            source.title,
+            source.summary,
+            source.description,
+            source.tags.join(' '),
+            text,
+            facts.map(renderFactForScoring).join(' '),
+        ].join('\n');
+        const semanticScore = scoreSemanticText(scoringText, tokens);
+        return {
+            kind: 'source',
+            id: source.id,
+            title: source.title ?? source.canonicalUri ?? source.sourceUri ?? source.id,
+            score: semanticScore + sourceAuthorityBoostForAnswer(source) + Math.min(80, facts.length * 10),
+            source,
+            excerpt: selectEvidenceExcerpt(query, text, facts),
+            facts,
+        };
+    })
+        .filter((item) => item.score > 0);
+    if (officialItems.length === 0)
+        return [...evidence];
+    return uniqueEvidenceItems([...officialItems, ...evidence]
+        .sort((left, right) => right.score - left.score || left.id.localeCompare(right.id)))
+        .slice(0, Math.max(limit, evidence.length, 1));
+}
+function shouldPreferFallbackAnswer(featureIntent, llmText, fallbackText) {
+    if (!featureIntent || !fallbackText)
+        return false;
+    if (!llmText)
+        return true;
+    const lower = llmText.toLowerCase();
+    if (isLowValueFeatureOrSpecText(llmText))
+        return true;
+    if (/\b(source-backed facts identify|available source-backed details include|matching sources exist|not enough source-backed facts|not enough concrete source-backed)\b/.test(lower)) {
+        return hasConcreteFeatureSignal(fallbackText);
+    }
+    if (/\bevidence\b/.test(lower) && featureFamilyCount(fallbackText) >= 2)
+        return true;
+    if (featureFamilyCount(llmText) < 2 && featureFamilyCount(fallbackText) >= 2)
+        return true;
+    return false;
+}
+function featureFamilyCount(text) {
+    const lower = text.toLowerCase();
+    return [
+        /\b(hdmi|earc|arc|ports?|usb|ethernet|optical|rf|antenna|rs-?232c?)\b/,
+        /\b(hdr|hdr10|dolby vision|hlg|filmmaker)\b/,
+        /\b(4k|8k|uhd|resolution|refresh|120\s*hz|100\s*hz|nanocell|display|screen)\b/,
+        /\b(webos|apps?|streaming|airplay|homekit|chromecast|smart tv|thinq)\b/,
+        /\b(wi-?fi|bluetooth|wireless lan)\b/,
+        /\b(audio|speakers?|dolby atmos|sound)\b/,
+        /\b(game|gaming|vrr|allm|freesync|g-sync)\b/,
+        /\b(tuner|atsc|qam|ntsc|broadcast)\b/,
+    ].filter((pattern) => pattern.test(lower)).length;
+}
 async function synthesizeAnswer(llm, query, mode, evidence, requestedTimeoutMs) {
     if (!llm)
         return null;
@@ -534,17 +701,26 @@ function selectEvidenceExcerpt(query, text, facts) {
     const tokens = expandQueryTokens(tokenizeSemanticQuery(query));
     const intent = factIntent(tokenizeSemanticQuery(query));
     const featureIntent = Boolean(intent && hasFeatureIntent(intent));
+    const evidenceText = stripEvidenceRoutingFragments(text);
     const factLines = facts
         .map(renderFactForPrompt)
         .filter((line) => scoreSemanticText(line, tokens) > 0)
         .filter((line) => !featureIntent || !isLowValueFeatureOrSpecText(line))
         .slice(0, 12);
-    const windows = evidenceWindows(text, tokens)
+    const windows = evidenceWindows(evidenceText, tokens)
         .filter((line) => !featureIntent || !isLowValueFeatureOrSpecText(line))
         .slice(0, 4);
-    const fallback = featureIntent && (factLines.length > 0 || windows.length > 0) ? [] : [clampText(text, 720)];
+    const fallback = featureIntent && (factLines.length > 0 || windows.length > 0) ? [] : [clampText(evidenceText, 720)];
     return uniqueStrings([...factLines, ...windows, ...fallback]).join('\n');
 }
+function stripEvidenceRoutingFragments(text) {
+    return normalizeWhitespace(text
+        .replace(/homegraph:\/\/\S+/gi, ' ')
+        .replace(/https?:\/\/\S+/gi, ' ')
+        .replace(/\bsemantic-gap-repair\b/gi, ' ')
+        .replace(/\bgenerated-page\b/gi, ' ')
+        .replace(/\b[a-z0-9-]+\.(?:com|net|org|io|dev|tv|ca|co\.uk)(?:\/\S*)?/gi, ' '));
+}
 function evidenceWindows(text, tokens) {
     const normalized = normalizeWhitespace(text);
     const sentences = splitSentences(normalized, 420);
@@ -694,6 +870,18 @@ function uniqueSources(sources) {
     }
     return out;
 }
+function uniqueEvidenceItems(items) {
+    const seen = new Set();
+    const out = [];
+    for (const item of items) {
+        const key = `${item.kind}:${item.id}`;
+        if (seen.has(key))
+            continue;
+        seen.add(key);
+        out.push(item);
+    }
+    return out;
+}
 function withAnswerSourceAliases(source) {
     return {
         ...source,

package/dist/_internal/platform/knowledge/semantic/enrichment.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"enrichment.d.ts","sourceRoot":"","sources":["../../../../../src/_internal/platform/knowledge/semantic/enrichment.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,KAAK,EAEV,mBAAmB,EACnB,qBAAqB,EACtB,MAAM,aAAa,CAAC;AACrB,OAAO,KAAK,EAKV,oBAAoB,EAErB,MAAM,YAAY,CAAC;AAkBpB,MAAM,WAAW,kCAAkC;IACjD,QAAQ,CAAC,KAAK,EAAE,cAAc,CAAC;IAC/B,QAAQ,CAAC,GAAG,CAAC,EAAE,oBAAoB,GAAG,IAAI,CAAC;CAC5C;AAED,MAAM,WAAW,4BAA4B;IAC3C,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;CACpC;AAED,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,CAAC,MAAM,EAAE,qBAAqB,CAAC;IACvC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,SAAS,CAAC,EAAE,KAAK,GAAG,eAAe,CAAC;IAC7C,QAAQ,CAAC,KAAK,EAAE,SAAS,mBAAmB,EAAE,CAAC;IAC/C,QAAQ,CAAC,QAAQ,EAAE,SAAS,mBAAmB,EAAE,CAAC;IAClD,QAAQ,CAAC,QAAQ,CAAC,EAAE,mBAAmB,CAAC;IACxC,QAAQ,CAAC,IAAI,EAAE,SAAS,mBAAmB,EAAE,CAAC;CAC/C;AAED,wBAAsB,qBAAqB,CACzC,OAAO,EAAE,kCAAkC,EAC3C,MAAM,EAAE,qBAAqB,EAC7B,OAAO,GAAE,4BAAiC,GACzC,OAAO,CAAC,2BAA2B,CAAC,CA+BtC"}
+{"version":3,"file":"enrichment.d.ts","sourceRoot":"","sources":["../../../../../src/_internal/platform/knowledge/semantic/enrichment.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,KAAK,EAEV,mBAAmB,EACnB,qBAAqB,EACtB,MAAM,aAAa,CAAC;AACrB,OAAO,KAAK,EAKV,oBAAoB,EAErB,MAAM,YAAY,CAAC;AAmBpB,MAAM,WAAW,kCAAkC;IACjD,QAAQ,CAAC,KAAK,EAAE,cAAc,CAAC;IAC/B,QAAQ,CAAC,GAAG,CAAC,EAAE,oBAAoB,GAAG,IAAI,CAAC;CAC5C;AAED,MAAM,WAAW,4BAA4B;IAC3C,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;CACpC;AAED,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,CAAC,MAAM,EAAE,qBAAqB,CAAC;IACvC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,SAAS,CAAC,EAAE,KAAK,GAAG,eAAe,CAAC;IAC7C,QAAQ,CAAC,KAAK,EAAE,SAAS,mBAAmB,EAAE,CAAC;IAC/C,QAAQ,CAAC,QAAQ,EAAE,SAAS,mBAAmB,EAAE,CAAC;IAClD,QAAQ,CAAC,QAAQ,CAAC,EAAE,mBAAmB,CAAC;IACxC,QAAQ,CAAC,IAAI,EAAE,SAAS,mBAAmB,EAAE,CAAC;CAC/C;AAED,wBAAsB,qBAAqB,CACzC,OAAO,EAAE,kCAAkC,EAC3C,MAAM,EAAE,qBAAqB,EAC7B,OAAO,GAAE,4BAAiC,GACzC,OAAO,CAAC,2BAA2B,CAAC,CA+BtC"}

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

@@ -1,4 +1,5 @@
 import { MAX_SEMANTIC_SOURCE_CHARS, applySourceMetadata, clampText, normalizeWhitespace, readRecord, readString, semanticHash, semanticMetadata, semanticSlug, sourceKnowledgeSpace, sourceSemanticHash, sourceSemanticText, splitSentences, uniqueStrings, } from './utils.js';
+import { canonicalRepairSubjectNodes } from './repair-subjects.js';
 export async function enrichKnowledgeSource(context, source, options = {}) {
     const extraction = context.store.getExtractionBySourceId(source.id);
     const text = sourceSemanticText(source, extraction);
@@ -192,7 +193,11 @@ async function persistSemanticExtraction(store, source, extraction, semantic, op
         entities.push(node);
         await linkSourceToNode(store, source.id, node.id, 'mentions_entity', spaceId, semantic.extractor);
     }
+    const sourceLinkedObjects = linkedObjectsForSource(store, source);
+    const sourceLinkedObjectIds = sourceLinkedObjects.map((node) => node.id);
+    const sourceTargetHints = sourceLinkedObjects.map((node) => ({ id: node.id, kind: node.kind, title: node.title }));
     for (const fact of semantic.facts.slice(0, 160)) {
+        const targetHints = fact.targetHints?.length ? fact.targetHints : sourceTargetHints;
         const node = await store.upsertNode({
             id: `sem-fact-${semanticHash(spaceId, source.id, fact.kind, fact.title, fact.value ?? fact.summary)}`,
             kind: 'fact',
@@ -208,7 +213,12 @@ async function persistSemanticExtraction(store, source, extraction, semantic, op
                 value: fact.value,
                 evidence: fact.evidence,
                 labels: fact.labels ?? [],
-                targetHints: fact.targetHints ?? [],
+                targetHints,
+                ...(sourceLinkedObjectIds.length > 0 ? {
+                    subject: sourceLinkedObjects[0]?.title,
+                    subjectIds: sourceLinkedObjectIds,
+                    linkedObjectIds: sourceLinkedObjectIds,
+                } : {}),
                 sourceId: source.id,
                 extractionId: extraction?.id,
                 extractor: semantic.extractor,
@@ -480,6 +490,31 @@ function readStringArray(value) {
         ? uniqueStrings(value.map((entry) => typeof entry === 'string' ? entry : undefined))
         : [];
 }
+function linkedObjectsForSource(store, source) {
+    const discovery = readRecord(source.metadata.sourceDiscovery);
+    const sourceSpaceId = sourceKnowledgeSpace(source);
+    const ids = uniqueStrings([
+        ...readStringArray(discovery.linkedObjectIds),
+        ...store.listEdges()
+            .filter((edge) => edge.fromKind === 'source' && edge.fromId === source.id)
+            .filter((edge) => edge.toKind === 'node' && edge.relation === 'source_for')
+            .filter((edge) => {
+            const edgeSpaceId = readString(edge.metadata.knowledgeSpaceId);
+            return !edgeSpaceId || edgeSpaceId === sourceSpaceId;
+        })
+            .map((edge) => edge.toId),
+    ]);
+    const nodes = [];
+    for (const id of ids) {
+        const node = store.getNode(id);
+        if (node && node.status !== 'stale')
+            nodes.push(node);
+    }
+    return canonicalRepairSubjectNodes({
+        nodes,
+        text: `${source.title ?? ''} ${source.summary ?? ''} ${source.description ?? ''}`,
+    });
+}
 function isFact(value) {
     return Boolean(value);
 }

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,CAuHjE;AAWD,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAE9D;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,CAiIjE;AAsBD,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,8 +29,15 @@ export function semanticFactText(fact) {
 export function isLowValueFeatureOrSpecText(text) {
     const lower = text.toLowerCase();
     const magicRemoteDetail = /\bmagic remote\b/.test(lower) || /\bbluetooth\b/.test(lower);
+    const nonRemoteFeatureSignal = hasNonRemoteFeatureSignal(lower);
     if (/\?\s*$/.test(text.trim()))
         return true;
+    if (/\bsemantic-gap-repair\b/.test(lower))
+        return true;
+    if (isUrlOrPathFragment(lower) && !hasConcreteFeatureSignal(lower))
+        return true;
+    if (isUrlOrPathFragment(lower) && /\b(source-backed facts identify|current page|database|manual\.nz|loading|semantic-gap-repair)\b/.test(lower))
+        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)) {
@@ -43,6 +50,7 @@ export function isLowValueFeatureOrSpecText(text) {
         return true;
     }
     if (/^\s*\d+\s*(yes|no)\b/.test(lower)
+        || /^\s*\d+\s*m\s*\(/.test(lower)
         || /^\s*\d+(hdmi|usb|audio|ports?|features?|smart)\b/.test(lower)
         || /^\s*0\s+ports\b/.test(lower)
         || /\b\d+\s+features such as\b/.test(lower)
@@ -50,6 +58,9 @@ export function isLowValueFeatureOrSpecText(text) {
         || /^\s*\d+\s*kg\d*/.test(lower)) {
         return true;
     }
+    if (/\b(series_url|exhibition display|supported audio formats|supported video formats|supported picture formats)\b/.test(lower)) {
+        return true;
+    }
     if (/\b(button|buttons|remote control)\b/.test(lower) && /[\u25b2\u25bc\u25c4\u25ba]|[▲▼◄►]|\\u25/.test(text)) {
         return true;
     }
@@ -67,7 +78,8 @@ export function isLowValueFeatureOrSpecText(text) {
         return true;
     }
     if (/\b(magic remote|remote control)\b/.test(lower)
-        && /\b(accessor(y|ies)|battery|batteries|button|environment|infrared|mr20ga|point|pointer|remote sensor|sap|sensor|shake|voice recognition)\b/.test(lower)) {
+        && /\b(accessor(y|ies)|battery|batteries|button|environment|infrared|mr20ga|point|pointer|remote sensor|sap|sensor|shake|voice recognition)\b/.test(lower)
+        && !nonRemoteFeatureSignal) {
         return true;
     }
     if (/\b(crutchfield|speakercompare|speaker compare|equal[- ]power|equal[- ]volume|speaker shopping|speaker recommendations?)\b/.test(lower)) {
@@ -111,7 +123,8 @@ export function isLowValueFeatureOrSpecText(text) {
         return true;
     }
     if (/\b(magic remote|remote)\b/.test(lower)
-        && /\b(shake|pointer|cursor appears|environment|operating environment|voice recognition|recognition performance|point|sensor|press|button|sap|more actions?)\b/.test(lower)) {
+        && /\b(shake|pointer|cursor appears|environment|operating environment|voice recognition|recognition performance|point|sensor|press|button|sap|more actions?)\b/.test(lower)
+        && !nonRemoteFeatureSignal) {
         return true;
     }
     if (/\b(sap|secondary audio program)\b/.test(lower) && /\b(button|press|enabled|audio)\b/.test(lower)) {
@@ -148,6 +161,15 @@ export function isLowValueFeatureOrSpecText(text) {
     }
     return false;
 }
+function hasNonRemoteFeatureSignal(text) {
+    return /\b(hdmi|earc|arc|hdr|hdr10|dolby vision|hlg|filmmaker|game optimizer|game mode|gaming|freesync|vrr|allm|4k|uhd|resolution|refresh|webos|airplay|homekit|wi-?fi|ethernet|usb|optical|tuner|atsc|qam|speaker|audio)\b/.test(text);
+}
+function isUrlOrPathFragment(value) {
+    return /https?:\/\//.test(value)
+        || /\b[a-z0-9-]+\.(com|net|org|io|dev|tv|ca|co\.uk)\/[a-z0-9/_?=&.#-]+/.test(value)
+        || /\b[a-z]{2}\/[a-z0-9/_-]+\/[a-z0-9._-]+/.test(value)
+        || /\b[a-z0-9._-]+\/(specifications?|manuals?|products?|support|features?)\/[a-z0-9._-]+/.test(value);
+}
 function isTruncatedManualFragment(value) {
     const trimmed = value.trim();
     if (trimmed.length === 0)

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

@@ -1 +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"}
+{"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,CA6B/B"}

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

@@ -13,7 +13,7 @@ const PROFILE_RULES = [
             ['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],
+            ['100/120 Hz refresh rate', /\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],
@@ -74,10 +74,10 @@ const PROFILE_RULES = [
         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],
+            ['FreeSync/VRR support', /\bfreesync\b|\bvrr\b/i],
+            ['ALLM/low-latency support', /\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],
+            ['HDMI 2.1/high-bandwidth HDMI', /\bhdmi\s*2\.1\b|\b4k\s*(?:at|@)?\s*120\b|\b120\s*hz\b/i],
         ],
     },
     {
@@ -88,10 +88,10 @@ const PROFILE_RULES = [
         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],
+            ['speaker/audio output', /\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],
+            ['audio format support', /\bsupported audio formats?\b|\bpcm\b|\btruehd\b/i],
         ],
     },
     {
@@ -110,14 +110,12 @@ const PROFILE_RULES = [
     },
 ];
 export function deriveRepairProfileFacts(input) {
-    const text = normalizeWhitespace([
+    const text = profileEvidenceText([
         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();
@@ -127,9 +125,10 @@ export function deriveRepairProfileFacts(input) {
             .filter(([, pattern]) => pattern.test(text))
             .map(([label]) => label));
         const wanted = broadProfileIntent || rule.intent.test(query);
-        if (values.length < (wanted ? 1 : rule.minimumMatches))
+        const minimumMatches = rule.intent.test(query) ? 1 : rule.minimumMatches;
+        if (values.length < minimumMatches || !wanted)
             return [];
-        const summary = `${rule.title} evidence includes ${joinValues(values)}.`;
+        const summary = `${rule.title}: ${joinValues(values)}.`;
         if (isLowValueFeatureOrSpecText(summary))
             return [];
         return [{
@@ -143,6 +142,15 @@ export function deriveRepairProfileFacts(input) {
             }];
     }).slice(0, 10);
 }
+function profileEvidenceText(values) {
+    return normalizeWhitespace(values
+        .filter(Boolean)
+        .join(' ')
+        .replace(/homegraph:\/\/\S+/g, ' ')
+        .replace(/https?:\/\/\S+/g, ' ')
+        .replace(/\b[a-z0-9.-]+\.(?:com|net|org|io|dev|tv|ca|co\.uk)\/[a-z0-9/_?=&.#-]+/gi, ' ')
+        .replace(/\b(?:series_url|current page|loading)\b/gi, ' '));
+}
 function joinValues(values) {
     if (values.length <= 1)
         return values[0] ?? '';

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

@@ -0,0 +1,16 @@
+import type { KnowledgeNodeRecord } from '../types.js';
+export interface RepairSubjectHint {
+    readonly id: string;
+    readonly kind: string;
+    readonly title: string;
+}
+export declare function canonicalRepairSubjectNodes(input: {
+    readonly nodes: readonly (KnowledgeNodeRecord | undefined)[];
+    readonly text?: string;
+}): KnowledgeNodeRecord[];
+export declare function repairSubjectIds(input: {
+    readonly nodes: readonly (KnowledgeNodeRecord | undefined)[];
+    readonly text?: string;
+}): string[];
+export declare function repairSubjectHints(subjects: readonly KnowledgeNodeRecord[]): RepairSubjectHint[];
+//# sourceMappingURL=repair-subjects.d.ts.map