@pellux/goodvibes-sdk 0.28.16 → 0.28.18

package/dist/_internal/platform/knowledge/ingest-compile.js

@@ -94,7 +94,7 @@ export async function recompileKnowledgeSource(context, source) {
 function extractionNeedsRefresh(extraction) {
     if (!extraction)
         return true;
-    if (extraction.format === 'pdf' && extraction.extractorId !== 'pdfjs')
+    if (extraction.format === 'pdf' && extraction.extractorId === 'pdf')
         return true;
     const searchText = readSearchText(extraction.structure) ?? readSearchText(extraction.metadata);
     if (searchText)

package/dist/_internal/platform/knowledge/pdf-extractor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pdf-extractor.d.ts","sourceRoot":"","sources":["../../../../src/_internal/platform/knowledge/pdf-extractor.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,iBAAiB,CAAC;AAgEjE,wBAAsB,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,yBAAyB,CAAC,CAInF"}
+{"version":3,"file":"pdf-extractor.d.ts","sourceRoot":"","sources":["../../../../src/_internal/platform/knowledge/pdf-extractor.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,iBAAiB,CAAC;AAgEjE,wBAAsB,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,yBAAyB,CAAC,CAMnF"}

package/dist/_internal/platform/knowledge/pdf-extractor.js

@@ -63,7 +63,10 @@ export async function extractPdf(buffer) {
     const parsed = await extractPdfWithPdfJs(buffer);
     if (parsed)
         return parsed;
-    return extractPdfRawStreams(buffer);
+    const raw = extractPdfRawStreams(buffer);
+    if (raw)
+        return raw;
+    throw new Error('PDF extraction failed: no readable text was extracted. OCR or a dedicated PDF provider may be required.');
 }
 async function extractPdfWithPdfJs(buffer) {
     try {
@@ -148,11 +151,13 @@ function extractPdfRawStreams(buffer) {
     const combined = uniqueStrings(texts, 64).join('\n');
     const searchable = uniqueStrings(texts, 512).join('\n');
     const searchText = searchTextPayload(searchable);
+    if (!searchText)
+        return undefined;
     return {
-        extractorId: 'pdf',
+        extractorId: 'pdf-raw',
         format: 'pdf',
         title: firstNonEmptyLine(combined) ?? 'PDF document',
-        summary: summarizeText(combined) ?? 'PDF extraction produced limited text; OCR is not used in-core.',
+        summary: summarizeText(combined) ?? 'PDF document text extracted from raw streams.',
         excerpt: excerptText(combined),
         sections: uniqueStrings(combined.split(/\n+/), 8),
         links: uniqueStrings(Array.from(combined.matchAll(/\bhttps?:\/\/[^\s)]+/g), (linkMatch) => linkMatch[0]), 50),

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

@@ -1 +1 @@
-{"version":3,"file":"answer-fallback.d.ts","sourceRoot":"","sources":["../../../../../src/_internal/platform/knowledge/semantic/answer-fallback.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAGvD,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,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,SAAS,sBAAsB,EAAE,EAC3C,KAAK,EAAE,SAAS,mBAAmB,EAAE,GACpC,cAAc,CAuBhB"}
+{"version":3,"file":"answer-fallback.d.ts","sourceRoot":"","sources":["../../../../../src/_internal/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,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,SAAS,sBAAsB,EAAE,EAC3C,KAAK,EAAE,SAAS,mBAAmB,EAAE,GACpC,cAAc,CAuBhB"}

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

@@ -1,3 +1,4 @@
+import { isLowValueFeatureOrSpecText } from './fact-quality.js';
 import { clampText, normalizeWhitespace, readString } from './utils.js';
 export function renderFallbackAnswer(query, mode, evidence, facts) {
     const factLimit = mode === 'detailed' ? 12 : mode === 'concise' ? 3 : 8;
@@ -5,17 +6,17 @@ export function renderFallbackAnswer(query, mode, evidence, facts) {
     if (factPhrases.length > 0) {
         return {
             synthesized: true,
-            text: `The source-backed facts I found indicate ${joinFactPhrases(factPhrases)}.`,
+            text: `Available source-backed details include ${joinFactPhrases(factPhrases)}.`,
         };
     }
-    const evidencePhrases = evidence
-        .slice(0, mode === 'detailed' ? 8 : mode === 'concise' ? 2 : 5)
-        .map(renderEvidencePhrase)
+    const sourceTitles = evidence
+        .slice(0, mode === 'detailed' ? 6 : mode === 'concise' ? 2 : 4)
+        .map((item) => normalizeWhitespace(item.title))
         .filter(Boolean);
-    if (evidencePhrases.length > 0) {
+    if (sourceTitles.length > 0) {
         return {
-            synthesized: true,
-            text: `The indexed evidence currently indicates ${joinFactPhrases(evidencePhrases)}. It does not yet contain enough extracted source-backed facts to answer every part of "${query}".`,
+            synthesized: false,
+            text: `I found matching sources (${joinFactPhrases(sourceTitles)}), but they have not produced enough source-backed facts to answer "${query}" yet.`,
         };
     }
     return {
@@ -26,9 +27,19 @@ export function renderFallbackAnswer(query, mode, evidence, facts) {
 function renderFactPhrase(fact) {
     const value = readString(fact.metadata.value);
     const summary = fact.summary ?? readString(fact.metadata.evidence);
-    if (value)
-        return `${fact.title}: ${value}`;
-    return summary ? `${fact.title}: ${summary}` : fact.title;
+    const phrase = value ? `${fact.title}: ${value}` : summary ? `${fact.title}: ${summary}` : fact.title;
+    const cleaned = normalizeWhitespace(clampText(phrase, 220));
+    if (isRawSourceFragment(cleaned))
+        return '';
+    return isLowValueFeatureOrSpecText(cleaned) ? '' : cleaned;
+}
+function isRawSourceFragment(value) {
+    const lower = value.toLowerCase();
+    return /\bsemantic-gap-repair\b/.test(lower)
+        || /\bsource-backed facts identify\b/.test(lower)
+        || /\b(manual\.nz|current page|loading)\b/.test(lower)
+        || /\b[a-z0-9-]+\.(com|net|org|io|dev|tv|ca)\/[a-z0-9/_?=&.#-]+/.test(lower)
+        || /\b[a-z]{2}\/[a-z0-9/_-]+\/[a-z0-9._-]+/.test(lower);
 }
 function joinFactPhrases(phrases) {
     if (phrases.length <= 1)
@@ -37,9 +48,3 @@ function joinFactPhrases(phrases) {
         return `${phrases[0]} and ${phrases[1]}`;
     return `${phrases.slice(0, -1).join('; ')}; and ${phrases[phrases.length - 1]}`;
 }
-function renderEvidencePhrase(item) {
-    const excerpt = normalizeWhitespace(item.excerpt ?? '');
-    if (!excerpt)
-        return item.title;
-    return `${item.title}: ${clampText(excerpt, 260)}`;
-}

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

@@ -0,0 +1,7 @@
+import type { KnowledgeNodeRecord, KnowledgeSourceRecord } from '../types.js';
+export interface AnswerSourceRankingEvidence {
+    readonly score: number;
+    readonly source?: KnowledgeSourceRecord;
+}
+export declare function rankAnswerSources(evidence: readonly AnswerSourceRankingEvidence[], facts: readonly KnowledgeNodeRecord[]): KnowledgeSourceRecord[];
+//# sourceMappingURL=answer-source-ranking.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"answer-source-ranking.d.ts","sourceRoot":"","sources":["../../../../../src/_internal/platform/knowledge/semantic/answer-source-ranking.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAG9E,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"}

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

@@ -0,0 +1,57 @@
+import { readRecord, readString } from './utils.js';
+export function rankAnswerSources(evidence, facts) {
+    const evidenceScoreBySource = new Map();
+    for (const item of evidence) {
+        if (!item.source)
+            continue;
+        evidenceScoreBySource.set(item.source.id, Math.max(evidenceScoreBySource.get(item.source.id) ?? 0, item.score));
+    }
+    const factCountBySource = new Map();
+    const promotedFactCountBySource = new Map();
+    for (const fact of facts) {
+        const sourceId = readString(fact.metadata.sourceId) ?? fact.sourceId;
+        if (!sourceId)
+            continue;
+        factCountBySource.set(sourceId, (factCountBySource.get(sourceId) ?? 0) + 1);
+        if (readString(fact.metadata.extractor) === 'repair-promotion') {
+            promotedFactCountBySource.set(sourceId, (promotedFactCountBySource.get(sourceId) ?? 0) + 1);
+        }
+    }
+    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)));
+}
+function sourceAnswerQuality(source, evidenceScoreBySource, factCountBySource, promotedFactCountBySource) {
+    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)
+        + 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) {
+    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))
+        return 140;
+    if (/\bmanufacturer-domain\b/.test(text))
+        return 80;
+    return 0;
+}
+function uniqueSources(values) {
+    const seen = new Set();
+    const result = [];
+    for (const source of values) {
+        if (seen.has(source.id))
+            continue;
+        seen.add(source.id);
+        result.push(source);
+    }
+    return result;
+}

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;AA+BpB,UAAU,sBAAsB;IAC9B,QAAQ,CAAC,KAAK,EAAE,cAAc,CAAC;IAC/B,QAAQ,CAAC,GAAG,CAAC,EAAE,oBAAoB,GAAG,IAAI,CAAC;CAC5C;AAsCD,wBAAsB,oBAAoB,CACxC,OAAO,EAAE,sBAAsB,EAC/B,KAAK,EAAE,4BAA4B,GAClC,OAAO,CAAC,6BAA6B,CAAC,CA2ExC"}
+{"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,CA+FxC"}

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

@@ -6,11 +6,14 @@ 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 { canonicalRepairSubjectNodes } from './repair-subjects.js';
 const GENERIC_ANSWER_INTENT_TOKENS = new Set([
     'capabilities',
     'capability',
     'configuration',
     'configure',
+    'device',
     'feature',
     'features',
     'function',
@@ -26,9 +29,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,14 +65,25 @@ 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 linkedObjects = input.includeLinkedObjects === false
+    const inferredHomeAssistantLinkedObjects = input.includeLinkedObjects === false
         ? []
-        : uniqueNodes([...(input.linkedObjects ?? []), ...evidence.flatMap((item) => item.node ? [item.node] : [])])
+        : inferHomeAssistantLinkedObjects(context.store, spaceId, input.query);
+    const evidenceLinkedObjects = shouldUseEvidenceLinkedObjects(spaceId, input, inferredHomeAssistantLinkedObjects)
+        ? evidence.flatMap((item) => item.node ? [item.node] : [])
+        : [];
+    const rawLinkedObjects = input.includeLinkedObjects === false
+        ? []
+        : uniqueNodes([
+            ...(input.linkedObjects ?? []),
+            ...evidenceLinkedObjects,
+            ...inferredHomeAssistantLinkedObjects,
+        ])
             .filter(isSemanticAnswerLinkedObject)
             .slice(0, 24);
+    const linkedObjects = filterAnswerLinkedObjects(spaceId, input.query, rawLinkedObjects);
     const gapSpaceId = concreteAnswerGapSpaceId(spaceId, evidence, sources, linkedObjects);
     const gaps = await persistAnswerGaps(context.store, gapSpaceId, input.query, llmAnswer?.gaps ?? [], {
         sources,
@@ -86,8 +102,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 +120,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),
     };
@@ -123,7 +148,7 @@ function collectAnswerEvidence(store, input, spaceId, limit) {
     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) ?? []);
@@ -198,6 +223,36 @@ 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 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;
+    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 +520,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,CA0HjE;AAkBD,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,14 @@ 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 (/\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)) {
@@ -42,7 +50,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)) {
@@ -143,6 +154,12 @@ export function isLowValueFeatureOrSpecText(text) {
     }
     return false;
 }
+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)
@@ -156,23 +173,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/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"}