@pellux/goodvibes-sdk 0.27.5 → 0.27.7

package/dist/_internal/contracts/artifacts/operator-contract.json

@@ -3,7 +3,7 @@
   "product": {
     "id": "goodvibes",
     "surface": "operator",
-    "version": "0.27.5"
+    "version": "0.27.7"
   },
   "auth": {
     "modes": [

package/dist/_internal/contracts/generated/foundation-metadata.d.ts

@@ -1,6 +1,6 @@
 export declare const FOUNDATION_METADATA: {
     readonly productId: "goodvibes";
-    readonly productVersion: "0.27.5";
+    readonly productVersion: "0.27.7";
     readonly operatorMethodCount: 256;
     readonly operatorEventCount: 30;
     readonly peerEndpointCount: 6;

package/dist/_internal/contracts/generated/foundation-metadata.js

@@ -1,7 +1,7 @@
 // Synced from packages/contracts/src/generated/foundation-metadata.ts
 export const FOUNDATION_METADATA = {
     "productId": "goodvibes",
-    "productVersion": "0.27.5",
+    "productVersion": "0.27.7",
     "operatorMethodCount": 256,
     "operatorEventCount": 30,
     "peerEndpointCount": 6

package/dist/_internal/contracts/generated/operator-contract.js

@@ -3,7 +3,7 @@ export const OPERATOR_CONTRACT = {
     "product": {
         "id": "goodvibes",
         "surface": "operator",
-        "version": "0.27.5"
+        "version": "0.27.7"
     },
     "auth": {
         "modes": [

package/dist/_internal/platform/knowledge/home-graph/ask.js

@@ -3,10 +3,10 @@ export async function answerHomeGraphQuery(input) {
     const sources = input.results.flatMap((result) => result.source ? [result.source] : []);
     const linkedObjects = collectLinkedObjects(input.results, input.state);
     if (input.semanticService) {
-        await input.semanticService.enrichSources(uniqueSources(sources), {
+        void input.semanticService.enrichSources(uniqueSources(sources), {
             knowledgeSpaceId: input.spaceId,
             limit: Math.min(3, Math.max(1, sources.length)),
-        });
+        }).catch(() => { });
         const answer = await input.semanticService.answer({
             query: input.query.query,
             knowledgeSpaceId: input.spaceId,

package/dist/_internal/platform/knowledge/home-graph/generated-pages.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"generated-pages.d.ts","sourceRoot":"","sources":["../../../../../src/_internal/platform/knowledge/home-graph/generated-pages.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAK9D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AA8BlD,OAAO,KAAK,EACV,6BAA6B,EAC7B,8BAA8B,EAC9B,wBAAwB,EACxB,yBAAyB,EACzB,sBAAsB,EACvB,MAAM,YAAY,CAAC;AAEpB,UAAU,oBAAoB;IAC5B,QAAQ,CAAC,KAAK,EAAE,cAAc,CAAC;IAC/B,QAAQ,CAAC,aAAa,EAAE,aAAa,CAAC;IACtC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;CACjC;AAED,wBAAsB,+BAA+B,CACnD,OAAO,EAAE,oBAAoB,GAAG;IAAE,QAAQ,CAAC,KAAK,EAAE,sBAAsB,CAAA;CAAE,GACzE,OAAO,CAAC,8BAA8B,CAAC,CAEzC;AAED,wBAAsB,8BAA8B,CAClD,OAAO,EAAE,oBAAoB,GAC5B,OAAO,CAAC,8BAA8B,CAAC,CAEzC;AA2ED,wBAAsB,8BAA8B,CAClD,OAAO,EAAE,oBAAoB,GAAG;IAAE,QAAQ,CAAC,KAAK,EAAE,wBAAwB,CAAA;CAAE,GAC3E,OAAO,CAAC,6BAA6B,GAAG;IAAE,QAAQ,CAAC,eAAe,EAAE,OAAO,CAAA;CAAE,CAAC,CA2EhF;AAED,wBAAsB,yBAAyB,CAC7C,OAAO,EAAE,oBAAoB,GAAG;IAAE,QAAQ,CAAC,KAAK,EAAE,wBAAwB,CAAA;CAAE,GAC3E,OAAO,CAAC,yBAAyB,GAAG;IAAE,QAAQ,CAAC,eAAe,EAAE,OAAO,CAAA;CAAE,CAAC,CAsC5E;AAED,wBAAsB,uBAAuB,CAC3C,OAAO,EAAE,oBAAoB,GAAG;IAAE,QAAQ,CAAC,KAAK,EAAE,wBAAwB,CAAA;CAAE,GAC3E,OAAO,CAAC,yBAAyB,GAAG;IAAE,QAAQ,CAAC,eAAe,EAAE,OAAO,CAAA;CAAE,CAAC,CAyB5E"}
+{"version":3,"file":"generated-pages.d.ts","sourceRoot":"","sources":["../../../../../src/_internal/platform/knowledge/home-graph/generated-pages.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAK9D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AA+BlD,OAAO,KAAK,EACV,6BAA6B,EAC7B,8BAA8B,EAC9B,wBAAwB,EACxB,yBAAyB,EACzB,sBAAsB,EACvB,MAAM,YAAY,CAAC;AAEpB,UAAU,oBAAoB;IAC5B,QAAQ,CAAC,KAAK,EAAE,cAAc,CAAC;IAC/B,QAAQ,CAAC,aAAa,EAAE,aAAa,CAAC;IACtC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;CACjC;AAED,wBAAsB,+BAA+B,CACnD,OAAO,EAAE,oBAAoB,GAAG;IAAE,QAAQ,CAAC,KAAK,EAAE,sBAAsB,CAAA;CAAE,GACzE,OAAO,CAAC,8BAA8B,CAAC,CAEzC;AAED,wBAAsB,8BAA8B,CAClD,OAAO,EAAE,oBAAoB,GAC5B,OAAO,CAAC,8BAA8B,CAAC,CAEzC;AA2ED,wBAAsB,8BAA8B,CAClD,OAAO,EAAE,oBAAoB,GAAG;IAAE,QAAQ,CAAC,KAAK,EAAE,wBAAwB,CAAA;CAAE,GAC3E,OAAO,CAAC,6BAA6B,GAAG;IAAE,QAAQ,CAAC,eAAe,EAAE,OAAO,CAAA;CAAE,CAAC,CA2EhF;AAED,wBAAsB,yBAAyB,CAC7C,OAAO,EAAE,oBAAoB,GAAG;IAAE,QAAQ,CAAC,KAAK,EAAE,wBAAwB,CAAA;CAAE,GAC3E,OAAO,CAAC,yBAAyB,GAAG;IAAE,QAAQ,CAAC,eAAe,EAAE,OAAO,CAAA;CAAE,CAAC,CAsC5E;AAED,wBAAsB,uBAAuB,CAC3C,OAAO,EAAE,oBAAoB,GAAG;IAAE,QAAQ,CAAC,KAAK,EAAE,wBAAwB,CAAA;CAAE,GAC3E,OAAO,CAAC,yBAAyB,GAAG;IAAE,QAAQ,CAAC,eAAe,EAAE,OAAO,CAAA;CAAE,CAAC,CAyB5E"}

package/dist/_internal/platform/knowledge/home-graph/generated-pages.js

@@ -2,6 +2,7 @@ import { materializeGeneratedKnowledgeProjection, } from '../generated-projectio
 import { HOME_GRAPH_CONNECTOR_ID, buildHomeGraphMetadata, edgeIsActive, homeGraphNodeId, homeGraphSourceId, isGeneratedPageSource, namespacedCanonicalUri, readRecord, uniqueStrings, } from './helpers.js';
 import { findHomeAssistantNode, missingDevicePassportFields, readHomeGraphState, renderHomeGraphState, safeHomeGraphFilename, sourcesLinkedToNode, } from './state.js';
 import { renderDevicePassportPage, renderPacketPage, renderRoomPage, } from './rendering.js';
+import { isUsefulHomeGraphPageFact } from '../semantic/fact-quality.js';
 export async function generateAutomaticHomeGraphPages(context) {
     return generateHomeGraphPagesForCurrentState(context, context.input.pageAutomation ?? {});
 }
@@ -286,7 +287,7 @@ function semanticFactsLinkedToSources(sources, nodes, edges) {
         && sourceIds.has(edge.fromId)
         && edge.toKind === 'node'
         && edge.relation === 'supports_fact')).map((edge) => edge.toId));
-    return nodes.filter((node) => factIds.has(node.id));
+    return nodes.filter((node) => factIds.has(node.id) && isUsefulHomeGraphPageFact(node));
 }
 function limitRecords(records, limit) {
     if (typeof limit !== 'number')

package/dist/_internal/platform/knowledge/home-graph/rendering.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"rendering.d.ts","sourceRoot":"","sources":["../../../../../src/_internal/platform/knowledge/home-graph/rendering.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,mBAAmB,EACnB,yBAAyB,EACzB,oBAAoB,EAEpB,mBAAmB,EACnB,qBAAqB,EACtB,MAAM,aAAa,CAAC;AAKrB,OAAO,KAAK,EAA6B,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAEnG,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,OAAO,EAAE,SAAS,qBAAqB,EAAE,CAAC;IACnD,QAAQ,CAAC,KAAK,EAAE,SAAS,mBAAmB,EAAE,CAAC;IAC/C,QAAQ,CAAC,KAAK,EAAE,SAAS,mBAAmB,EAAE,CAAC;IAC/C,QAAQ,CAAC,MAAM,EAAE,SAAS,oBAAoB,EAAE,CAAC;IACjD,QAAQ,CAAC,WAAW,CAAC,EAAE,SAAS,yBAAyB,EAAE,CAAC;CAC7D;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,oBAAoB,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAmDnF;AAED,wBAAgB,wBAAwB,CAAC,KAAK,EAAE;IAC9C,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,mBAAmB,CAAC;IACrC,QAAQ,CAAC,QAAQ,EAAE,SAAS,mBAAmB,EAAE,CAAC;IAClD,QAAQ,CAAC,OAAO,EAAE,SAAS,qBAAqB,EAAE,CAAC;IACnD,QAAQ,CAAC,WAAW,CAAC,EAAE,SAAS,yBAAyB,EAAE,CAAC;IAC5D,QAAQ,CAAC,MAAM,EAAE,SAAS,oBAAoB,EAAE,CAAC;IACjD,QAAQ,CAAC,aAAa,EAAE,SAAS,MAAM,EAAE,CAAC;IAC1C,QAAQ,CAAC,aAAa,CAAC,EAAE,SAAS,mBAAmB,EAAE,CAAC;CACzD,GAAG,MAAM,CA+BT;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,oBAAoB,EAAE,OAAO,GAAE;IACrE,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,aAAa,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC3C,QAAQ,CAAC,aAAa,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CACvC,GAAG,MAAM,CAkBd;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,oBAAoB,EAAE,OAAO,GAAE,iBAAsB,GAAG,kBAAkB,CAcnH"}
+{"version":3,"file":"rendering.d.ts","sourceRoot":"","sources":["../../../../../src/_internal/platform/knowledge/home-graph/rendering.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,mBAAmB,EACnB,yBAAyB,EACzB,oBAAoB,EAEpB,mBAAmB,EACnB,qBAAqB,EACtB,MAAM,aAAa,CAAC;AAKrB,OAAO,KAAK,EAA6B,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAGnG,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,OAAO,EAAE,SAAS,qBAAqB,EAAE,CAAC;IACnD,QAAQ,CAAC,KAAK,EAAE,SAAS,mBAAmB,EAAE,CAAC;IAC/C,QAAQ,CAAC,KAAK,EAAE,SAAS,mBAAmB,EAAE,CAAC;IAC/C,QAAQ,CAAC,MAAM,EAAE,SAAS,oBAAoB,EAAE,CAAC;IACjD,QAAQ,CAAC,WAAW,CAAC,EAAE,SAAS,yBAAyB,EAAE,CAAC;CAC7D;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,oBAAoB,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAmDnF;AAED,wBAAgB,wBAAwB,CAAC,KAAK,EAAE;IAC9C,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,mBAAmB,CAAC;IACrC,QAAQ,CAAC,QAAQ,EAAE,SAAS,mBAAmB,EAAE,CAAC;IAClD,QAAQ,CAAC,OAAO,EAAE,SAAS,qBAAqB,EAAE,CAAC;IACnD,QAAQ,CAAC,WAAW,CAAC,EAAE,SAAS,yBAAyB,EAAE,CAAC;IAC5D,QAAQ,CAAC,MAAM,EAAE,SAAS,oBAAoB,EAAE,CAAC;IACjD,QAAQ,CAAC,aAAa,EAAE,SAAS,MAAM,EAAE,CAAC;IAC1C,QAAQ,CAAC,aAAa,CAAC,EAAE,SAAS,mBAAmB,EAAE,CAAC;CACzD,GAAG,MAAM,CA+BT;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,oBAAoB,EAAE,OAAO,GAAE;IACrE,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,aAAa,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC3C,QAAQ,CAAC,aAAa,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CACvC,GAAG,MAAM,CAkBd;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,oBAAoB,EAAE,OAAO,GAAE,iBAAsB,GAAG,kBAAkB,CAcnH"}

package/dist/_internal/platform/knowledge/home-graph/rendering.js

@@ -2,6 +2,7 @@ import { renderKnowledgeMap } from '../map.js';
 import { countFacet, normalizeStringArray, readString } from '../map-filters.js';
 import { isUnusableHomeGraphExtractionText } from './extraction-quality.js';
 import { edgeIsActive, isGeneratedPageSource, readRecord, uniqueStrings } from './helpers.js';
+import { isLowValueFeatureOrSpecText, isUsefulHomeGraphPageFact } from '../semantic/fact-quality.js';
 export function renderRoomPage(state, areaId) {
     const area = areaId
         ? findNodeByHaId(state.nodes, 'ha_area', areaId) ?? findNodeByHaId(state.nodes, 'ha_room', areaId)
@@ -295,7 +296,7 @@ function sourceEvidenceSnippets(source, extraction, tokens, limit) {
         ...featureSentences(searchText),
         source.summary,
         source.description,
-    ]).filter((entry) => !isUnusableHomeGraphExtractionText(entry)).slice(0, 80);
+    ]).filter((entry) => !isUnusableHomeGraphExtractionText(entry) && !isLowValueFeatureOrSpecText(entry)).slice(0, 80);
     const scored = candidates
         .map((text) => ({ text: clampEvidence(text), score: evidenceScore(text, tokens) }))
         .filter((entry) => entry.text.length > 0)
@@ -327,7 +328,7 @@ function featureSentences(value) {
     const keywords = /\b(feature|features|support|supports|capability|capabilities|specification|specifications|mode|modes|hdmi|hdr|dolby|battery|reset|warranty|firmware|voice|remote)\b/i;
     return (text.match(/[^.!?\n]+[.!?]?/g) ?? [])
         .map((entry) => entry.trim())
-        .filter((entry) => keywords.test(entry))
+        .filter((entry) => keywords.test(entry) && !isLowValueFeatureOrSpecText(entry))
         .slice(0, 24);
 }
 function evidenceScore(value, tokens) {
@@ -390,7 +391,7 @@ function renderSourceList(title, sources) {
 }
 function renderSemanticFacts(title, facts) {
     const entries = facts
-        .filter((node) => node.metadata.semanticKind === 'fact')
+        .filter(isUsefulHomeGraphPageFact)
         .sort((left, right) => semanticFactSortKey(left).localeCompare(semanticFactSortKey(right)) || left.title.localeCompare(right.title))
         .slice(0, 80);
     if (entries.length === 0)
@@ -423,7 +424,7 @@ function semanticFactsLinkedToSources(sources, nodes, edges) {
         && sourceIds.has(edge.fromId)
         && edge.toKind === 'node'
         && edge.relation === 'supports_fact')).map((edge) => edge.toId));
-    return nodes.filter((node) => factIds.has(node.id));
+    return nodes.filter((node) => factIds.has(node.id) && isUsefulHomeGraphPageFact(node));
 }
 function semanticFactSortKey(node) {
     const order = {

package/dist/_internal/platform/knowledge/home-graph/search.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../../../../../src/_internal/platform/knowledge/home-graph/search.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,KAAK,EACV,mBAAmB,EACnB,yBAAyB,EACzB,mBAAmB,EACnB,qBAAqB,EACtB,MAAM,aAAa,CAAC;AAGrB,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAqGxD,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,SAAS,qBAAqB,EAAE,CAAC;IACnD,QAAQ,CAAC,KAAK,EAAE,SAAS,mBAAmB,EAAE,CAAC;IAC/C,QAAQ,CAAC,KAAK,EAAE,SAAS,mBAAmB,EAAE,CAAC;IAC/C,QAAQ,CAAC,oBAAoB,EAAE,WAAW,CAAC,MAAM,EAAE,yBAAyB,CAAC,CAAC;CAC/E;AAED,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,cAAc,EAAE,OAAO,EAAE,MAAM,GAAG,oBAAoB,CAuBrG;AAED,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,SAAS,qBAAqB,EAAE,EACzC,KAAK,EAAE,SAAS,mBAAmB,EAAE,EACrC,KAAK,EAAE,SAAS,mBAAmB,EAAE,EACrC,oBAAoB,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,yBAAyB,GAAG,IAAI,GAAG,SAAS,EACxF,KAAK,EAAE,MAAM,GACZ,qBAAqB,EAAE,CAmFzB;AAED,wBAAgB,yCAAyC,CACvD,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,SAAS,qBAAqB,EAAE,EACzC,KAAK,EAAE,SAAS,mBAAmB,EAAE,EACrC,KAAK,EAAE,SAAS,mBAAmB,EAAE,EACrC,oBAAoB,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,yBAAyB,GAAG,IAAI,GAAG,SAAS,EACxF,KAAK,EAAE,MAAM,GACZ,qBAAqB,EAAE,CAoCzB;AAwMD,wBAAgB,8BAA8B,CAAC,UAAU,EAAE,yBAAyB,GAAG,IAAI,GAAG,SAAS,GAAG,OAAO,CAWhH"}
+{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../../../../../src/_internal/platform/knowledge/home-graph/search.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,KAAK,EACV,mBAAmB,EACnB,yBAAyB,EACzB,mBAAmB,EACnB,qBAAqB,EACtB,MAAM,aAAa,CAAC;AAGrB,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAoIxD,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,SAAS,qBAAqB,EAAE,CAAC;IACnD,QAAQ,CAAC,KAAK,EAAE,SAAS,mBAAmB,EAAE,CAAC;IAC/C,QAAQ,CAAC,KAAK,EAAE,SAAS,mBAAmB,EAAE,CAAC;IAC/C,QAAQ,CAAC,oBAAoB,EAAE,WAAW,CAAC,MAAM,EAAE,yBAAyB,CAAC,CAAC;CAC/E;AAED,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,cAAc,EAAE,OAAO,EAAE,MAAM,GAAG,oBAAoB,CAuBrG;AAED,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,SAAS,qBAAqB,EAAE,EACzC,KAAK,EAAE,SAAS,mBAAmB,EAAE,EACrC,KAAK,EAAE,SAAS,mBAAmB,EAAE,EACrC,oBAAoB,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,yBAAyB,GAAG,IAAI,GAAG,SAAS,EACxF,KAAK,EAAE,MAAM,GACZ,qBAAqB,EAAE,CAoFzB;AAED,wBAAgB,yCAAyC,CACvD,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,SAAS,qBAAqB,EAAE,EACzC,KAAK,EAAE,SAAS,mBAAmB,EAAE,EACrC,KAAK,EAAE,SAAS,mBAAmB,EAAE,EACrC,oBAAoB,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,yBAAyB,GAAG,IAAI,GAAG,SAAS,EACxF,KAAK,EAAE,MAAM,GACZ,qBAAqB,EAAE,CAoCzB;AAmND,wBAAgB,8BAA8B,CAAC,UAAU,EAAE,yBAAyB,GAAG,IAAI,GAAG,SAAS,GAAG,OAAO,CAWhH"}

package/dist/_internal/platform/knowledge/home-graph/search.js

@@ -91,10 +91,39 @@ const SOURCE_EVIDENCE_TOKENS = new Set([
     'supports',
     'warranty',
 ]);
+const ANCHOR_INTENT_TOKENS = new Set([
+    ...SOURCE_EVIDENCE_TOKENS,
+    'function',
+    'functions',
+    'mode',
+    'modes',
+    'setup',
+    'install',
+    'configure',
+    'documentation',
+    'manual',
+]);
+const HOME_GRAPH_ANCHOR_KINDS = new Set([
+    'ha_home',
+    'ha_entity',
+    'ha_device',
+    'ha_area',
+    'ha_automation',
+    'ha_script',
+    'ha_scene',
+    'ha_label',
+    'ha_integration',
+    'ha_room',
+    'ha_device_passport',
+    'ha_maintenance_item',
+    'ha_troubleshooting_case',
+    'ha_purchase',
+    'ha_network_node',
+]);
 const INTEGRATION_QUERY_TOKENS = new Set(['automation', 'automations', 'homeassistant', 'integration', 'integrations', 'webostv']);
 export function readHomeGraphSearchState(store, spaceId) {
     const sources = store.listSources(10_000).filter((source) => (belongsToSpace(source, spaceId) && !isGeneratedPageSource(source)));
-    const nodes = store.listNodes(10_000).filter((node) => belongsToSpace(node, spaceId));
+    const nodes = store.listNodes(10_000).filter((node) => belongsToSpace(node, spaceId) && node.status !== 'stale');
     const sourceIds = new Set(sources.map((source) => source.id));
     const nodeIds = new Set(nodes.map((node) => node.id));
     const edges = store.listEdges().filter((edge) => (edgeIsActive(edge)
@@ -118,8 +147,9 @@ export function scoreHomeGraphResults(query, sources, nodes, edges, extractionBy
     if (tokens.length === 0)
         return [];
     const expandedTokens = expandTokens(tokens);
-    const anchors = selectAnchorNodes(tokens, nodes);
-    const sourceAnchors = selectSourceAnchors(tokens, anchors.map((anchor) => anchor.node));
+    const anchorTokens = selectAnchorQueryTokens(tokens);
+    const anchors = selectAnchorNodes(anchorTokens, nodes);
+    const sourceAnchors = selectSourceAnchors(anchorTokens, anchors.map((anchor) => anchor.node));
     const anchorIds = new Set(sourceAnchors.map((node) => node.id));
     const anchorIdentityTokens = collectAnchorIdentityTokens(sourceAnchors);
     const sourceLinks = buildSourceLinkIndex(edges);
@@ -319,7 +349,11 @@ function sourceAnchorIdentityScore(anchorTokens, source, extraction) {
     ]);
 }
 function selectAnchorNodes(tokens, nodes) {
+    if (tokens.length === 0)
+        return [];
     return nodes.map((node) => {
+        if (!isHomeGraphAnchorNode(node))
+            return { node, score: 0 };
         const baseScore = scoreFields(tokens, nodeIdentityFields(node));
         const intentBoost = sourceAnchorIntentBoost(tokens, node);
         return {
@@ -331,6 +365,14 @@ function selectAnchorNodes(tokens, nodes) {
         .sort((a, b) => b.score - a.score || a.node.id.localeCompare(b.node.id))
         .slice(0, 12);
 }
+function selectAnchorQueryTokens(tokens) {
+    return tokens.filter((token) => !ANCHOR_INTENT_TOKENS.has(token));
+}
+function isHomeGraphAnchorNode(node) {
+    if (typeof node.metadata.semanticKind === 'string')
+        return false;
+    return HOME_GRAPH_ANCHOR_KINDS.has(node.kind);
+}
 function selectSourceAnchors(tokens, nodes) {
     const preferred = nodes.filter((node) => sourceAnchorIntentBoost(tokens, node) >= 0);
     if (preferred.length > 0)

package/dist/_internal/platform/knowledge/home-graph/state.js

@@ -1,7 +1,7 @@
 import { belongsToSpace, edgeIsActive, readRecord } from './helpers.js';
 export function readHomeGraphState(store, spaceId) {
     const sources = store.listSources(10_000).filter((source) => belongsToSpace(source, spaceId));
-    const nodes = store.listNodes(10_000).filter((node) => belongsToSpace(node, spaceId));
+    const nodes = store.listNodes(10_000).filter((node) => belongsToSpace(node, spaceId) && node.status !== 'stale');
     const sourceIds = new Set(sources.map((source) => source.id));
     const nodeIds = new Set(nodes.map((node) => node.id));
     const edges = store.listEdges().filter((edge) => (edgeIsActive(edge)

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;AAOlD,OAAO,KAAK,EACV,4BAA4B,EAC5B,6BAA6B,EAE7B,oBAAoB,EAErB,MAAM,YAAY,CAAC;AAepB,UAAU,sBAAsB;IAC9B,QAAQ,CAAC,KAAK,EAAE,cAAc,CAAC;IAC/B,QAAQ,CAAC,GAAG,CAAC,EAAE,oBAAoB,GAAG,IAAI,CAAC;CAC5C;AAaD,wBAAsB,oBAAoB,CACxC,OAAO,EAAE,sBAAsB,EAC/B,KAAK,EAAE,4BAA4B,GAClC,OAAO,CAAC,6BAA6B,CAAC,CAiDxC"}
+{"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;AAOlD,OAAO,KAAK,EACV,4BAA4B,EAC5B,6BAA6B,EAE7B,oBAAoB,EAErB,MAAM,YAAY,CAAC;AAqBpB,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,CAmDxC"}

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

@@ -1,5 +1,30 @@
 import { getKnowledgeSpaceId, isInKnowledgeSpace, normalizeKnowledgeSpaceId } from '../spaces.js';
 import { MAX_ANSWER_EVIDENCE_CHARS, clampText, normalizeWhitespace, readRecord, readString, scoreSemanticText, semanticHash, semanticMetadata, sourceSemanticText, tokenizeSemanticQuery, uniqueStrings, } from './utils.js';
+import { hasConcreteFeatureSignal, isLowValueFeatureOrSpecText, isSemanticAnswerLinkedObject, semanticFactText, } from './fact-quality.js';
+const GENERIC_ANSWER_INTENT_TOKENS = new Set([
+    'capabilities',
+    'capability',
+    'configuration',
+    'configure',
+    'feature',
+    'features',
+    'function',
+    'functions',
+    'install',
+    'mode',
+    'modes',
+    'procedure',
+    'setting',
+    'settings',
+    'setup',
+    'spec',
+    'specification',
+    'specifications',
+    'specs',
+    'support',
+    'supported',
+    'supports',
+]);
 export async function answerKnowledgeQuery(context, input) {
     const spaceId = normalizeKnowledgeSpaceId(input.knowledgeSpaceId);
     const mode = input.mode ?? 'standard';
@@ -29,7 +54,9 @@ export async function answerKnowledgeQuery(context, input) {
     const sources = uniqueSources(evidence.flatMap((item) => item.source ? [item.source] : [])).slice(0, limit);
     const linkedObjects = input.includeLinkedObjects === false
         ? []
-        : uniqueNodes([...(input.linkedObjects ?? []), ...evidence.flatMap((item) => item.node ? [item.node] : [])]).slice(0, 24);
+        : uniqueNodes([...(input.linkedObjects ?? []), ...evidence.flatMap((item) => item.node ? [item.node] : [])])
+            .filter(isSemanticAnswerLinkedObject)
+            .slice(0, 24);
     const gaps = await persistAnswerGaps(context.store, spaceId, input.query, llmAnswer?.gaps ?? []);
     const text = llmAnswer?.answer?.trim() || renderFallbackAnswer(input.query, mode, evidence);
     return {
@@ -53,6 +80,7 @@ function collectAnswerEvidence(store, input, spaceId, limit) {
     const tokens = expandQueryTokens(tokenizeSemanticQuery(input.query));
     if (tokens.length === 0)
         return [];
+    const subjectTokens = tokens.filter((token) => !GENERIC_ANSWER_INTENT_TOKENS.has(token));
     const candidateSourceIds = new Set(input.candidateSourceIds ?? []);
     const candidateNodeIds = new Set(input.candidateNodeIds ?? []);
     const linkedObjectIds = new Set((input.linkedObjects ?? []).map((node) => node.id));
@@ -66,17 +94,28 @@ function collectAnswerEvidence(store, input, spaceId, limit) {
         const extraction = store.getExtractionBySourceId(source.id);
         const facts = filterFactsForQuery(input.query, sourceFacts.get(source.id) ?? []);
         const text = sourceSemanticText(source, extraction);
-        const baseScore = scoreSemanticText([
+        const scoringText = [
             source.title,
             source.summary,
             source.description,
             source.tags.join(' '),
             text,
             facts.map(renderFactForScoring).join(' '),
-        ].join('\n'), tokens);
+        ].join('\n');
+        const baseScore = scoreSemanticText(scoringText, tokens);
+        const subjectScore = subjectTokens.length > 0 ? scoreSemanticText(scoringText, subjectTokens) : 0;
         const candidateBoost = candidateSourceIds.has(source.id) ? 220 : 0;
         const linkedBoost = linkedSourceIds.has(source.id) ? 160 : 0;
-        const score = baseScore + candidateBoost + linkedBoost + Math.min(60, facts.length * 6);
+        const genericOnly = subjectTokens.length > 0 && subjectScore === 0;
+        const weakStrictCandidate = strictCandidates
+            && candidateSourceIds.size > 1
+            && candidateSourceIds.has(source.id)
+            && !linkedSourceIds.has(source.id)
+            && genericOnly;
+        const weakBroadMatch = !strictCandidates && genericOnly;
+        const score = weakStrictCandidate || weakBroadMatch
+            ? 0
+            : baseScore + candidateBoost + linkedBoost + Math.min(60, facts.length * 6);
         return {
             kind: 'source',
             id: source.id,
@@ -88,18 +127,25 @@ function collectAnswerEvidence(store, input, spaceId, limit) {
         };
     });
     const nodeItems = store.listNodes(10_000)
-        .filter((node) => belongsToAnswerSpace(node, spaceId))
+        .filter((node) => belongsToAnswerSpace(node, spaceId) && node.status !== 'stale')
         .filter((node) => !strictCandidates
         || candidateNodeIds.has(node.id)
         || linkedObjectIds.has(node.id)
         || (typeof node.sourceId === 'string' && candidateSourceIds.has(node.sourceId)))
         .map((node) => {
-        const score = scoreSemanticText([
+        const scoringText = [
             node.title,
             node.summary,
             node.aliases.join(' '),
             JSON.stringify(node.metadata),
-        ].join('\n'), tokens) + (candidateNodeIds.has(node.id) || linkedObjectIds.has(node.id) ? 120 : 0) + semanticKindBoost(node);
+        ].join('\n');
+        const baseScore = scoreSemanticText(scoringText, tokens);
+        const subjectScore = subjectTokens.length > 0 ? scoreSemanticText(scoringText, subjectTokens) : 0;
+        const genericOnly = subjectTokens.length > 0 && subjectScore === 0;
+        const candidateOrLinked = candidateNodeIds.has(node.id) || linkedObjectIds.has(node.id);
+        const score = genericOnly && !candidateOrLinked
+            ? 0
+            : baseScore + (candidateOrLinked ? 120 : 0) + semanticKindBoost(node);
         return {
             kind: 'node',
             id: node.id,
@@ -184,10 +230,14 @@ function renderFallbackAnswer(query, mode, evidence) {
     return lines.length > 0 ? lines.join('\n') : `No knowledge matched "${query}".`;
 }
 function filterFactsForQuery(query, facts) {
-    const intent = factIntent(tokenizeSemanticQuery(query));
-    if (!intent)
-        return [...facts];
-    return facts.filter((fact) => intent.has(readString(fact.metadata.factKind) ?? 'note'));
+    const tokens = tokenizeSemanticQuery(query);
+    const intent = factIntent(tokens);
+    const matching = intent
+        ? facts.filter((fact) => intent.has(readString(fact.metadata.factKind) ?? 'note'))
+        : [...facts];
+    return matching
+        .filter((fact) => fact.status !== 'stale' && !isLowValueFactForQuery(tokens, intent, fact))
+        .sort(compareFactQuality);
 }
 function factIntent(tokens) {
     const tokenSet = new Set(tokens);
@@ -207,6 +257,37 @@ function factIntent(tokens) {
 function hasAny(values, candidates) {
     return candidates.some((candidate) => values.has(candidate));
 }
+function isLowValueFactForQuery(tokens, intent, fact) {
+    if (!intent || !hasFeatureIntent(intent))
+        return false;
+    const kind = readString(fact.metadata.factKind) ?? 'note';
+    if (!['feature', 'capability', 'specification', 'compatibility', 'configuration', 'identity'].includes(kind))
+        return false;
+    const text = semanticFactText(fact);
+    if (isLowValueFeatureOrSpecText(text))
+        return true;
+    const extractor = readString(fact.metadata.extractor);
+    const confidence = typeof fact.confidence === 'number' ? fact.confidence : 0;
+    if (extractor !== 'deterministic' || confidence > 60)
+        return false;
+    const subjectTokens = tokens.filter((token) => !GENERIC_ANSWER_INTENT_TOKENS.has(token));
+    return subjectTokens.length > 0 && !hasConcreteFeatureSignal(text);
+}
+function hasFeatureIntent(intent) {
+    return intent.has('feature') || intent.has('capability') || intent.has('specification') || intent.has('compatibility');
+}
+function compareFactQuality(left, right) {
+    return factQuality(right) - factQuality(left) || left.title.localeCompare(right.title);
+}
+function factQuality(fact) {
+    const extractor = readString(fact.metadata.extractor);
+    const kind = readString(fact.metadata.factKind);
+    const value = readString(fact.metadata.value);
+    return (extractor === 'llm' ? 40 : 0)
+        + (value ? 12 : 0)
+        + (kind === 'capability' || kind === 'feature' ? 8 : kind === 'specification' ? 6 : 0)
+        + Math.round(fact.confidence / 10);
+}
 async function persistAnswerGap(store, spaceId, query, reason) {
     const node = await store.upsertNode({
         id: `sem-answer-gap-${semanticHash(spaceId, query)}`,
@@ -245,7 +326,7 @@ async function persistAnswerGaps(store, spaceId, query, gaps) {
     return nodes;
 }
 function buildSourceFactIndex(store, spaceId) {
-    const facts = store.listNodes(10_000).filter((node) => (node.metadata.semanticKind === 'fact' && belongsToAnswerSpace(node, spaceId)));
+    const facts = store.listNodes(10_000).filter((node) => (node.status !== 'stale' && node.metadata.semanticKind === 'fact' && belongsToAnswerSpace(node, spaceId)));
     const bySource = new Map();
     for (const fact of facts) {
         const sourceId = readString(fact.metadata.sourceId) ?? fact.sourceId;
@@ -271,12 +352,17 @@ function sourceIdsLinkedToNodes(store, nodeIds, spaceId) {
 }
 function selectEvidenceExcerpt(query, text, facts) {
     const tokens = expandQueryTokens(tokenizeSemanticQuery(query));
+    const intent = factIntent(tokenizeSemanticQuery(query));
+    const featureIntent = Boolean(intent && hasFeatureIntent(intent));
     const factLines = facts
         .map(renderFactForPrompt)
         .filter((line) => scoreSemanticText(line, tokens) > 0)
         .slice(0, 12);
-    const windows = evidenceWindows(text, tokens).slice(0, 4);
-    return uniqueStrings([...factLines, ...windows, clampText(text, 720)]).join('\n');
+    const windows = evidenceWindows(text, tokens)
+        .filter((line) => !featureIntent || !isLowValueFeatureOrSpecText(line))
+        .slice(0, 4);
+    const fallback = featureIntent && (factLines.length > 0 || windows.length > 0) ? [] : [clampText(text, 720)];
+    return uniqueStrings([...factLines, ...windows, ...fallback]).join('\n');
 }
 function evidenceWindows(text, tokens) {
     const normalized = normalizeWhitespace(text);

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,CA6BtC"}
+{"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"}

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

@@ -4,7 +4,9 @@ export async function enrichKnowledgeSource(context, source, options = {}) {
     const text = sourceSemanticText(source, extraction);
     const textHash = sourceSemanticHash(source, extraction);
     const existingSemantic = readRecord(source.metadata.semanticEnrichment);
-    if (!options.force && existingSemantic.textHash === textHash) {
+    const currentExtractor = readString(existingSemantic.extractor);
+    const shouldUpgradeDeterministic = Boolean(context.llm && existingSemantic.textHash === textHash && currentExtractor !== 'llm');
+    if (!options.force && existingSemantic.textHash === textHash && !shouldUpgradeDeterministic) {
         return emptyResult(source, true, 'semantic enrichment is current');
     }
     if (text.length < 40) {
@@ -257,8 +259,39 @@ async function persistSemanticExtraction(store, source, extraction, semantic, op
         });
     }
     const wikiPage = await persistWikiPage(store, source, semantic, spaceId, options.textHash);
+    await markPreviousSemanticNodesStale(store, source.id, spaceId, new Set([
+        ...entities.map((node) => node.id),
+        ...facts.map((node) => node.id),
+        ...gaps.map((node) => node.id),
+        ...(wikiPage ? [wikiPage.id] : []),
+    ]));
     return { source, skipped: false, extractor: semantic.extractor, facts, entities, gaps, ...(wikiPage ? { wikiPage } : {}) };
 }
+async function markPreviousSemanticNodesStale(store, sourceId, spaceId, activeIds) {
+    const supersededAt = Date.now();
+    const semanticNodes = store.listNodes(10_000).filter((node) => (node.sourceId === sourceId
+        && typeof node.metadata.semanticKind === 'string'
+        && node.status !== 'stale'
+        && !activeIds.has(node.id)));
+    for (const node of semanticNodes) {
+        await store.upsertNode({
+            id: node.id,
+            kind: node.kind,
+            slug: node.slug,
+            title: node.title,
+            summary: node.summary,
+            aliases: node.aliases,
+            status: 'stale',
+            confidence: node.confidence,
+            ...(node.sourceId ? { sourceId: node.sourceId } : {}),
+            metadata: {
+                ...node.metadata,
+                supersededAt,
+                supersededInSpaceId: spaceId,
+            },
+        });
+    }
+}
 async function persistWikiPage(store, source, semantic, spaceId, textHash) {
     const markdown = semantic.wikiPage?.markdown ?? renderDeterministicWikiPage(source, semantic.facts);
     if (!markdown.trim())

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

@@ -0,0 +1,7 @@
+import type { KnowledgeNodeRecord } from '../types.js';
+export declare function isSemanticAnswerLinkedObject(node: KnowledgeNodeRecord): boolean;
+export declare function semanticFactText(fact: KnowledgeNodeRecord): string;
+export declare function isLowValueFeatureOrSpecText(text: string): boolean;
+export declare function hasConcreteFeatureSignal(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

@@ -0,0 +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,CAmBjE;AAED,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAE9D;AAED,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,mBAAmB,GAAG,OAAO,CAa5E"}

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

@@ -0,0 +1,69 @@
+import { readString } from './utils.js';
+const USEFUL_PAGE_FACT_KINDS = new Set([
+    'feature',
+    'capability',
+    'specification',
+    'identity',
+    'maintenance',
+    'compatibility',
+    'configuration',
+    'troubleshooting',
+]);
+export function isSemanticAnswerLinkedObject(node) {
+    if (node.status === 'stale')
+        return false;
+    const semanticKind = readString(node.metadata.semanticKind);
+    if (semanticKind)
+        return false;
+    return node.kind !== 'fact' && node.kind !== 'wiki_page' && node.kind !== 'knowledge_gap';
+}
+export function semanticFactText(fact) {
+    return [
+        fact.title,
+        fact.summary,
+        readString(fact.metadata.value),
+        readString(fact.metadata.evidence),
+        Array.isArray(fact.metadata.labels) ? fact.metadata.labels.join(' ') : '',
+    ].filter(Boolean).join(' ').toLowerCase();
+}
+export function isLowValueFeatureOrSpecText(text) {
+    const lower = text.toLowerCase();
+    const magicRemoteDetail = /\bmagic remote\b/.test(lower) || /\bbluetooth\b/.test(lower);
+    if (/\b(items? supplied|supplied items?|included accessories|optional extras?|sold separately|separate purchase|accessories may vary|contents? of (this )?manual|may be changed|without prior notice|available menus? and options?|certified cable|unapproved items?)\b/.test(lower)) {
+        return true;
+    }
+    if (!magicRemoteDetail && /\b(may vary|depending (upon|on) (the )?model|depending on country|depending on region)\b/.test(lower)) {
+        return true;
+    }
+    if (/\b(fasten|screws?|stand|tip over|overturn|fall over|transporting|move the tv|moving the tv|oils?|lubricants?|cleaning cloth|power cord|electric shock|fire hazard|near water|ventilation|antenna grounding)\b/.test(lower)) {
+        return true;
+    }
+    if (/\b(bezel|less than \d+(?:\.\d+)?\s*(mm|cm|inches?)|does not fit|will not fit|fit your tv'?s usb port|usb port may not fit)\b/.test(lower)) {
+        return true;
+    }
+    if (/\b(warning|caution|risk|hazard|do not|never)\b/.test(lower) && !/\b(feature|supports?|hdmi|usb|hdr|remote|bluetooth)\b/.test(lower)) {
+        return true;
+    }
+    return false;
+}
+export function hasConcreteFeatureSignal(text) {
+    return /\b(hdmi|usb|hdr|hdr10|dolby|vision|earc|arc|bluetooth|wi-?fi|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)\b/.test(text.toLowerCase());
+}
+export function isUsefulHomeGraphPageFact(fact) {
+    if (fact.status === 'stale')
+        return false;
+    if (fact.metadata.semanticKind !== 'fact')
+        return false;
+    const kind = readString(fact.metadata.factKind) ?? 'note';
+    if (!USEFUL_PAGE_FACT_KINDS.has(kind))
+        return false;
+    const text = semanticFactText(fact);
+    if (isLowValueFeatureOrSpecText(text))
+        return false;
+    const extractor = readString(fact.metadata.extractor);
+    const confidence = typeof fact.confidence === 'number' ? fact.confidence : 0;
+    if (extractor === 'deterministic' && confidence <= 60 && ['feature', 'capability', 'specification', 'compatibility', 'configuration'].includes(kind)) {
+        return hasConcreteFeatureSignal(text);
+    }
+    return true;
+}

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

@@ -1 +1 @@
-{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../../../../../src/_internal/platform/knowledge/semantic/service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAGzD,OAAO,KAAK,EACV,4BAA4B,EAC5B,6BAA6B,EAC7B,iCAAiC,EACjC,oBAAoB,EACrB,MAAM,YAAY,CAAC;AAEpB,MAAM,WAAW,+BAA+B;IAC9C,QAAQ,CAAC,GAAG,CAAC,EAAE,oBAAoB,GAAG,IAAI,CAAC;IAC3C,QAAQ,CAAC,uBAAuB,CAAC,EAAE,MAAM,CAAC;CAC3C;AAED,qBAAa,wBAAwB;IAEjC,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,OAAO;gBADP,KAAK,EAAE,cAAc,EACrB,OAAO,GAAE,+BAAoC;IAG1D,YAAY,CAChB,QAAQ,EAAE,MAAM,EAChB,KAAK,GAAE;QAAE,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;QAAC,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAA;KAAO,GAC3E,OAAO,CAAC,iCAAiC,GAAG,IAAI,CAAC;IAO9C,aAAa,CACjB,OAAO,EAAE,SAAS,qBAAqB,EAAE,EACzC,KAAK,GAAE;QAAE,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;QAAC,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAO,GACpG,OAAO,CAAC,SAAS,iCAAiC,EAAE,CAAC;IASlD,OAAO,CAAC,KAAK,GAAE;QACnB,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;QACvC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QACxB,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;QACzB,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;KAC/B,GAAG,OAAO,CAAC;QACf,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;QACzB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;QAC1B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;QACzB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;QACxB,QAAQ,CAAC,MAAM,EAAE,SAAS;YAAE,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;YAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;SAAE,EAAE,CAAC;KACnF,CAAC;IA2BI,MAAM,CAAC,KAAK,EAAE,4BAA4B,GAAG,OAAO,CAAC,6BAA6B,CAAC;CAI1F"}
+{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../../../../../src/_internal/platform/knowledge/semantic/service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAGzD,OAAO,KAAK,EACV,4BAA4B,EAC5B,6BAA6B,EAC7B,iCAAiC,EACjC,oBAAoB,EACrB,MAAM,YAAY,CAAC;AAGpB,MAAM,WAAW,+BAA+B;IAC9C,QAAQ,CAAC,GAAG,CAAC,EAAE,oBAAoB,GAAG,IAAI,CAAC;IAC3C,QAAQ,CAAC,uBAAuB,CAAC,EAAE,MAAM,CAAC;CAC3C;AAED,qBAAa,wBAAwB;IAEjC,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,OAAO;gBADP,KAAK,EAAE,cAAc,EACrB,OAAO,GAAE,+BAAoC;IAG1D,YAAY,CAChB,QAAQ,EAAE,MAAM,EAChB,KAAK,GAAE;QAAE,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;QAAC,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAA;KAAO,GAC3E,OAAO,CAAC,iCAAiC,GAAG,IAAI,CAAC;IAO9C,aAAa,CACjB,OAAO,EAAE,SAAS,qBAAqB,EAAE,EACzC,KAAK,GAAE;QAAE,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;QAAC,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAO,GACpG,OAAO,CAAC,SAAS,iCAAiC,EAAE,CAAC;IASlD,OAAO,CAAC,KAAK,GAAE;QACnB,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;QACvC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QACxB,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;QACzB,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;KAC/B,GAAG,OAAO,CAAC;QACf,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;QACzB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;QAC1B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;QACzB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;QACxB,QAAQ,CAAC,MAAM,EAAE,SAAS;YAAE,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;YAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;SAAE,EAAE,CAAC;KACnF,CAAC;IA6BI,MAAM,CAAC,KAAK,EAAE,4BAA4B,GAAG,OAAO,CAAC,6BAA6B,CAAC;CAI1F"}

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

@@ -1,5 +1,6 @@
 import { answerKnowledgeQuery } from './answer.js';
 import { enrichKnowledgeSource } from './enrichment.js';
+import { readRecord, readString, sourceSemanticHash, sourceSemanticText } from './utils.js';
 export class KnowledgeSemanticService {
     store;
     options;
@@ -37,7 +38,9 @@ export class KnowledgeSemanticService {
         const errors = [];
         for (const source of sources) {
             try {
-                const llm = this.options.llm && llmAttempts < maxLlmSources ? this.options.llm : null;
+                const llm = this.options.llm && llmAttempts < maxLlmSources && sourceCanUseLlmUpgrade(this.store, source)
+                    ? this.options.llm
+                    : null;
                 if (llm)
                     llmAttempts += 1;
                 const result = await enrichKnowledgeSource({ store: this.store, llm }, source, input);
@@ -58,3 +61,12 @@ export class KnowledgeSemanticService {
         return answerKnowledgeQuery({ store: this.store, llm: this.options.llm }, input);
     }
 }
+function sourceCanUseLlmUpgrade(store, source) {
+    const extraction = store.getExtractionBySourceId(source.id);
+    const text = sourceSemanticText(source, extraction);
+    if (text.length < 40)
+        return false;
+    const existingSemantic = readRecord(source.metadata.semanticEnrichment);
+    return existingSemantic.textHash !== sourceSemanticHash(source, extraction)
+        || readString(existingSemantic.extractor) !== 'llm';
+}

package/dist/_internal/platform/version.js

@@ -1,6 +1,6 @@
 import { readFileSync } from 'node:fs';
 import { join } from 'node:path';
-let version = '0.27.5';
+let version = '0.27.7';
 try {
     const pkg = JSON.parse(readFileSync(join(import.meta.dir, '..', '..', 'package.json'), 'utf-8'));
     version = pkg.version ?? version;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pellux/goodvibes-sdk",
-  "version": "0.27.5",
+  "version": "0.27.7",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/mgd34msu/goodvibes-sdk.git"