@pellux/goodvibes-sdk 0.27.5 → 0.27.6

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

@@ -3,7 +3,7 @@
   "product": {
     "id": "goodvibes",
     "surface": "operator",
-    "version": "0.27.5"
+    "version": "0.27.6"
   },
   "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.6";
     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.6",
     "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.6"
     },
     "auth": {
         "modes": [

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;AAepB,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,CAiDxC"}

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

@@ -1,5 +1,29 @@
 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';
+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';
@@ -53,6 +77,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 +91,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 +124,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 +227,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 +254,49 @@ 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 = [
+        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();
+    if (isManualBoilerplateFeatureText(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 isManualBoilerplateFeatureText(text) {
+    return /\b(items? supplied|accessories supplied|contents? of (this )?manual|may vary|may be changed|without prior notice|depending (upon|on) (the )?model|available menus? and options?|product specifications?|power cord|electric shock|fire hazard|certified cable|do not|warning|caution|risk|hazard|clean only|near water|ventilation|antenna grounding)\b/.test(text);
+}
+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);
+}
+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 +335,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;

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/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.6';
 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.6",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/mgd34msu/goodvibes-sdk.git"