@pellux/goodvibes-sdk 0.27.8 → 0.27.10

package/dist/_internal/platform/knowledge/scheduling.d.ts

@@ -40,6 +40,7 @@ export declare class KnowledgeScheduleService {
     }): Promise<KnowledgeJobRunRecord>;
     dispose(): void;
     private initializeSchedules;
+    private ensureBootstrapSchedule;
     private clearScheduleTimer;
     private reconcileSchedules;
     private runScheduledJob;

package/dist/_internal/platform/knowledge/scheduling.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"scheduling.d.ts","sourceRoot":"","sources":["../../../../src/_internal/platform/knowledge/scheduling.ts"],"names":[],"mappings":"AAAA,OAAO,EAA8E,KAAK,4BAA4B,EAAE,MAAM,4BAA4B,CAAC;AAC3J,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AACjD,OAAO,KAAK,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,qBAAqB,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAC;AAEvH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAGlE,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,KAAK,EAAE,cAAc,CAAC;IAC/B,QAAQ,CAAC,WAAW,EAAE,CACpB,EAAE,EAAE,CAAC,GAAG,EAAE,eAAe,EAAE,GAAG,EAAE;QAAE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,EAC1H,SAAS,CAAC,EAAE,MAAM,KACf,IAAI,CAAC;IACV,QAAQ,CAAC,YAAY,EAAE,CACrB,IAAI,EAAE,kBAAkB,CAAC,MAAM,CAAC,EAChC,KAAK,EAAE;QAAE,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;QAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,KACvE,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;CACvC;AAED,qBAAa,wBAAwB;IAKvB,OAAO,CAAC,QAAQ,CAAC,OAAO;IAJpC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAgC;IACrD,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAoD;IACnF,OAAO,CAAC,oBAAoB,CAAS;gBAER,OAAO,EAAE,0BAA0B;IAehE,QAAQ,IAAI,SAAS,kBAAkB,EAAE;IAIzC,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,kBAAkB,GAAG,IAAI;IAIvC,YAAY,CAAC,KAAK,EAAE;QACxB,QAAQ,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC;QACrB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;QACvB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QACxB,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;QAC3B,QAAQ,CAAC,QAAQ,EAAE,4BAA4B,CAAC;QAChD,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KAC7C,GAAG,OAAO,CAAC,uBAAuB,CAAC;IAqB9B,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAM5C,kBAAkB,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,uBAAuB,GAAG,IAAI,CAAC;IAiB/F,WAAW,CAAC,KAAK,SAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,qBAAqB,EAAE;IAIpE,MAAM,CACV,EAAE,EAAE,MAAM,EACV,KAAK,GAAE;QACL,QAAQ,CAAC,IAAI,CAAC,EAAE,gBAAgB,CAAC;QACjC,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;QACvC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;KACpB,GACL,OAAO,CAAC,qBAAqB,CAAC;IA6BjC,OAAO,IAAI,IAAI;YAOD,mBAAmB;IAyBjC,OAAO,CAAC,kBAAkB;YAQZ,kBAAkB;YA6BlB,eAAe;YAmBf,aAAa;CA0D5B"}
+{"version":3,"file":"scheduling.d.ts","sourceRoot":"","sources":["../../../../src/_internal/platform/knowledge/scheduling.ts"],"names":[],"mappings":"AAAA,OAAO,EAA8E,KAAK,4BAA4B,EAAE,MAAM,4BAA4B,CAAC;AAC3J,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AACjD,OAAO,KAAK,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,qBAAqB,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAC;AAEvH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAGlE,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,KAAK,EAAE,cAAc,CAAC;IAC/B,QAAQ,CAAC,WAAW,EAAE,CACpB,EAAE,EAAE,CAAC,GAAG,EAAE,eAAe,EAAE,GAAG,EAAE;QAAE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,EAC1H,SAAS,CAAC,EAAE,MAAM,KACf,IAAI,CAAC;IACV,QAAQ,CAAC,YAAY,EAAE,CACrB,IAAI,EAAE,kBAAkB,CAAC,MAAM,CAAC,EAChC,KAAK,EAAE;QAAE,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;QAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,KACvE,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;CACvC;AAED,qBAAa,wBAAwB;IAKvB,OAAO,CAAC,QAAQ,CAAC,OAAO;IAJpC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAgC;IACrD,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAoD;IACnF,OAAO,CAAC,oBAAoB,CAAS;gBAER,OAAO,EAAE,0BAA0B;IAgBhE,QAAQ,IAAI,SAAS,kBAAkB,EAAE;IAIzC,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,kBAAkB,GAAG,IAAI;IAIvC,YAAY,CAAC,KAAK,EAAE;QACxB,QAAQ,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC;QACrB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;QACvB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QACxB,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;QAC3B,QAAQ,CAAC,QAAQ,EAAE,4BAA4B,CAAC;QAChD,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KAC7C,GAAG,OAAO,CAAC,uBAAuB,CAAC;IAqB9B,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAM5C,kBAAkB,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,uBAAuB,GAAG,IAAI,CAAC;IAiB/F,WAAW,CAAC,KAAK,SAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,qBAAqB,EAAE;IAIpE,MAAM,CACV,EAAE,EAAE,MAAM,EACV,KAAK,GAAE;QACL,QAAQ,CAAC,IAAI,CAAC,EAAE,gBAAgB,CAAC;QACjC,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;QACvC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;KACpB,GACL,OAAO,CAAC,qBAAqB,CAAC;IA6BjC,OAAO,IAAI,IAAI;YAOD,mBAAmB;YAUnB,uBAAuB;IAiBrC,OAAO,CAAC,kBAAkB;YAQZ,kBAAkB;YA6BlB,eAAe;YAmBf,aAAa;CA0D5B"}

package/dist/_internal/platform/knowledge/scheduling.js

@@ -16,6 +16,7 @@ export class KnowledgeScheduleService {
             { id: 'knowledge-sync-browser-history', kind: 'sync-browser-history', title: 'Sync Browser History', description: 'Index local browser history and bookmarks as metadata-first structured knowledge.', defaultMode: 'background', metadata: { category: 'ingest', localOnly: true } },
             { id: 'knowledge-rebuild-projections', kind: 'rebuild-projections', title: 'Rebuild Projections', description: 'Render and materialize the major derived markdown/wiki projections.', defaultMode: 'background', metadata: { category: 'projection' } },
             { id: 'knowledge-semantic-enrichment', kind: 'semantic-enrichment', title: 'Semantic Enrichment', description: 'Extract durable facts, entities, wiki pages, and gaps from indexed sources.', defaultMode: 'background', metadata: { category: 'semantic' } },
+            { id: 'knowledge-semantic-self-improvement', kind: 'semantic-self-improvement', title: 'Semantic Self-Improvement', description: 'Classify semantic gaps and repair eligible concrete subjects with corroborated source-backed ingest.', defaultMode: 'background', metadata: { category: 'semantic' } },
             { id: 'knowledge-light-consolidation', kind: 'light-consolidation', title: 'Light Consolidation', description: 'Score recent usage, refresh candidate promotions, and write a deterministic consolidation report.', defaultMode: 'background', metadata: { category: 'consolidation' } },
             { id: 'knowledge-deep-consolidation', kind: 'deep-consolidation', title: 'Deep Consolidation', description: 'Run the full consolidation loop, including high-confidence memory promotion and deterministic reporting.', defaultMode: 'background', metadata: { category: 'consolidation' } },
         ];
@@ -113,26 +114,24 @@ export class KnowledgeScheduleService {
             return;
         this.schedulesInitialized = true;
         await this.context.store.init();
-        if (this.context.store.listSchedules(10_000).length === 0) {
-            await this.context.store.upsertSchedule({
-                jobId: 'knowledge-light-consolidation',
-                label: 'Daily Light Consolidation',
-                enabled: true,
-                schedule: normalizeEverySchedule('24h'),
-                nextRunAt: getNextAutomationOccurrence(normalizeEverySchedule('24h'), Date.now(), 'knowledge-light-consolidation'),
-                metadata: { bootstrap: true },
-            });
-            await this.context.store.upsertSchedule({
-                jobId: 'knowledge-deep-consolidation',
-                label: 'Weekly Deep Consolidation',
-                enabled: true,
-                schedule: normalizeCronSchedule('15 4 * * 0'),
-                nextRunAt: getNextAutomationOccurrence(normalizeCronSchedule('15 4 * * 0'), Date.now(), 'knowledge-deep-consolidation'),
-                metadata: { bootstrap: true },
-            });
-        }
+        await this.ensureBootstrapSchedule('knowledge-light-consolidation', 'Daily Light Consolidation', normalizeEverySchedule('24h'));
+        await this.ensureBootstrapSchedule('knowledge-deep-consolidation', 'Weekly Deep Consolidation', normalizeCronSchedule('15 4 * * 0'));
+        await this.ensureBootstrapSchedule('knowledge-semantic-self-improvement', 'Continuous Semantic Self-Improvement', normalizeEverySchedule('6h'));
         await this.reconcileSchedules();
     }
+    async ensureBootstrapSchedule(jobId, label, schedule) {
+        const existing = this.context.store.listSchedules(10_000).find((entry) => entry.jobId === jobId && entry.metadata.bootstrap === true);
+        if (existing)
+            return;
+        await this.context.store.upsertSchedule({
+            jobId,
+            label,
+            enabled: true,
+            schedule,
+            nextRunAt: getNextAutomationOccurrence(schedule, Date.now(), jobId),
+            metadata: { bootstrap: true },
+        });
+    }
     clearScheduleTimer(id) {
         const timer = this.scheduleTimers.get(id);
         if (timer) {

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;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"}
+{"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;AAsBpB,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,CAuDxC"}

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

@@ -1,5 +1,5 @@
 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 { MAX_ANSWER_EVIDENCE_CHARS, clampText, normalizeWhitespace, readRecord, readString, scoreSemanticText, semanticHash, semanticMetadata, sourceSemanticText, splitSentences, tokenizeSemanticQuery, uniqueStrings, } from './utils.js';
 import { hasConcreteFeatureSignal, isLowValueFeatureOrSpecText, isSemanticAnswerLinkedObject, semanticFactText, } from './fact-quality.js';
 const GENERIC_ANSWER_INTENT_TOKENS = new Set([
     'capabilities',
@@ -58,7 +58,8 @@ export async function answerKnowledgeQuery(context, input) {
             .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);
+    const featureIntent = hasFeatureIntentForQuery(input.query);
+    const text = cleanSynthesizedAnswer(llmAnswer?.answer?.trim() || renderFallbackAnswer(input.query, mode, evidence), featureIntent);
     return {
         ok: true,
         spaceId,
@@ -172,6 +173,8 @@ async function synthesizeAnswer(llm, query, mode, evidence) {
             'You answer questions from a GoodVibes self-improving knowledge wiki.',
             'Use only the supplied evidence. Synthesize the answer for the user intent rather than dumping snippets.',
             'If evidence is insufficient, say what is missing. Prefer concrete features, specs, procedures, and relationships.',
+            'For feature or specification questions, ignore manual boilerplate about accessories, cable recommendations, USB/HDMI physical-fit guidance, button maps, remote aiming instructions, batteries, cleaning, servicing, safety, furniture, wall mounting, and future product changes unless the user asks about those topics.',
+            'Do not mention future features, specifications changing without notice, cable fit, USB extension cables, remote sensor aiming, service personnel, or child-safety/furniture/platform guidance in a feature/spec answer.',
             'Return only JSON with answer, confidence, usedSourceIds, usedNodeIds, and optional gaps.',
         ].join(' '),
         prompt: JSON.stringify({
@@ -276,6 +279,10 @@ function isLowValueFactForQuery(tokens, intent, fact) {
 function hasFeatureIntent(intent) {
     return intent.has('feature') || intent.has('capability') || intent.has('specification') || intent.has('compatibility');
 }
+function hasFeatureIntentForQuery(query) {
+    const intent = factIntent(tokenizeSemanticQuery(query));
+    return Boolean(intent && hasFeatureIntent(intent));
+}
 function compareFactQuality(left, right) {
     return factQuality(right) - factQuality(left) || left.title.localeCompare(right.title);
 }
@@ -367,6 +374,10 @@ function selectEvidenceExcerpt(query, text, facts) {
 }
 function evidenceWindows(text, tokens) {
     const normalized = normalizeWhitespace(text);
+    const sentences = splitSentences(normalized, 420);
+    const sentenceMatches = sentences.filter((sentence) => scoreSemanticText(sentence, tokens) > 0);
+    if (sentenceMatches.length > 0)
+        return uniqueStrings(sentenceMatches).slice(0, 12);
     const lower = normalized.toLowerCase();
     const windows = [];
     for (const token of tokens) {
@@ -375,12 +386,34 @@ function evidenceWindows(text, tokens) {
         const index = lower.indexOf(token);
         if (index < 0)
             continue;
-        const start = Math.max(0, index - 220);
-        const end = Math.min(normalized.length, index + 620);
-        windows.push(`${start > 0 ? '...' : ''}${normalized.slice(start, end)}${end < normalized.length ? '...' : ''}`);
+        const start = Math.max(0, normalized.lastIndexOf('.', index - 1) + 1, index - 160);
+        const nextPeriod = normalized.indexOf('.', index + token.length);
+        const end = nextPeriod >= 0 ? Math.min(normalized.length, nextPeriod + 1) : Math.min(normalized.length, index + 360);
+        windows.push(`${start > 0 ? '...' : ''}${normalized.slice(start, end).trim()}${end < normalized.length ? '...' : ''}`);
     }
     return uniqueStrings(windows);
 }
+function cleanSynthesizedAnswer(text, featureIntent) {
+    if (!featureIntent)
+        return text;
+    const blocks = text.split(/\n{2,}/).map((block) => block.trim()).filter(Boolean);
+    const cleanedBlocks = blocks.map((block) => {
+        const lines = block.split(/\n/).map((line) => line.trim()).filter(Boolean);
+        const kept = lines.filter((line) => !isLowValueFeatureOrSpecText(line));
+        if (kept.length > 0 && kept.length < lines.length)
+            return kept.join('\n');
+        if (lines.length > 1)
+            return kept.join('\n');
+        const sentences = splitSentences(block, 600);
+        const keptSentences = sentences.filter((sentence) => !isLowValueFeatureOrSpecText(sentence));
+        return keptSentences.length > 0 && keptSentences.length < sentences.length
+            ? keptSentences.join(' ')
+            : block;
+    }).filter(Boolean);
+    return cleanedBlocks.length > 0
+        ? cleanedBlocks.join('\n\n')
+        : 'The available evidence did not contain source-backed feature or specification details after filtering manual boilerplate.';
+}
 function expandQueryTokens(tokens) {
     const expansions = {
         capabilities: ['capability', 'feature', 'features', 'function', 'functions', 'supports', 'specifications'],

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,CAgCjE;AAWD,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAE9D;AAED,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,mBAAmB,GAAG,OAAO,CAa5E"}
+{"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,CA6CjE;AAWD,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

@@ -46,13 +46,26 @@ export function isLowValueFeatureOrSpecText(text) {
     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|dry cloth|power cord|electric shock|fire hazard|near water|ventilation|antenna grounding|qualified personnel|customer service|servicing|repair is required|refer all servicing)\b/.test(lower)) {
+    if (/\b(fasten|screws?|stand|tip over|overturn|fall over|transporting|move the tv|moving the tv|oils?|lubricants?|cleaning cloth|dry cloth|power cord|electric shock|fire hazard|near water|ventilation|antenna grounding|qualified personnel|qualified service personnel|service personnel|customer service|servicing|repair is required|refer all servicing)\b/.test(lower)) {
+        return true;
+    }
+    if (/\b(platform|cabinet|furniture|supporting furniture|television placement|child safety|proper television placement|wall mount|mounting bracket|stand hole)\b/.test(lower)
+        && /\b(support|supports|safe|safely|recommended|install|installation|place|placement|mount|mounting)\b/.test(lower)) {
+        return true;
+    }
+    if (/\b(infrared light|remote control sensor|point (the )?(magic )?remote|aim (the )?(magic )?remote)\b/.test(lower)) {
+        return true;
+    }
+    if (/\bif (the )?device (doesn'?t|does not) support\b/.test(lower) && /\bmay not work properly\b/.test(lower)) {
+        return true;
+    }
+    if (/\bchange\b/.test(lower) && /\bsetting to off\b/.test(lower)) {
         return true;
     }
     if (/\bbatter(y|ies)\b/.test(lower) && /\b(remote|magic remote|button)\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)) {
+    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|usb flash drive does not fit|usb cable does 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)) {
@@ -71,7 +84,7 @@ function isTruncatedManualFragment(value) {
     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());
+    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 isUsefulHomeGraphPageFact(fact) {
     if (fact.status === 'stale')

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

@@ -0,0 +1,32 @@
+import type { WebSearchRequest, WebSearchResponse } from '../../web-search/types.js';
+import type { KnowledgeSourceType } from '../types.js';
+import type { KnowledgeSemanticGapRepairer } from './types.js';
+interface GapRepairSearch {
+    search(request: WebSearchRequest): Promise<WebSearchResponse>;
+}
+interface GapRepairIngest {
+    ingestUrl(input: {
+        readonly url: string;
+        readonly title?: string;
+        readonly tags?: readonly string[];
+        readonly sourceType?: KnowledgeSourceType;
+        readonly connectorId?: string;
+        readonly allowPrivateHosts?: boolean;
+        readonly metadata?: Record<string, unknown>;
+    }): Promise<{
+        readonly source: {
+            readonly id: string;
+            readonly status: string;
+        };
+    }>;
+}
+export interface WebGapRepairOptions {
+    readonly searchService: GapRepairSearch;
+    readonly ingestService: GapRepairIngest;
+    readonly maxResults?: number;
+    readonly minDistinctDomains?: number;
+    readonly maxIngest?: number;
+}
+export declare function createWebKnowledgeGapRepairer(options: WebGapRepairOptions): KnowledgeSemanticGapRepairer;
+export {};
+//# sourceMappingURL=gap-repair.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"gap-repair.d.ts","sourceRoot":"","sources":["../../../../../src/_internal/platform/knowledge/semantic/gap-repair.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,gBAAgB,EAChB,iBAAiB,EAElB,MAAM,2BAA2B,CAAC;AAEnC,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AACvD,OAAO,KAAK,EACV,4BAA4B,EAG7B,MAAM,YAAY,CAAC;AAGpB,UAAU,eAAe;IACvB,MAAM,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC;CAC/D;AAED,UAAU,eAAe;IACvB,SAAS,CAAC,KAAK,EAAE;QACf,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;QACrB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QACxB,QAAQ,CAAC,IAAI,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;QAClC,QAAQ,CAAC,UAAU,CAAC,EAAE,mBAAmB,CAAC;QAC1C,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;QAC9B,QAAQ,CAAC,iBAAiB,CAAC,EAAE,OAAO,CAAC;QACrC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KAC7C,GAAG,OAAO,CAAC;QAAE,QAAQ,CAAC,MAAM,EAAE;YAAE,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;YAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;SAAE,CAAA;KAAE,CAAC,CAAC;CACpF;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,aAAa,EAAE,eAAe,CAAC;IACxC,QAAQ,CAAC,aAAa,EAAE,eAAe,CAAC;IACxC,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,kBAAkB,CAAC,EAAE,MAAM,CAAC;IACrC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,wBAAgB,6BAA6B,CAAC,OAAO,EAAE,mBAAmB,GAAG,4BAA4B,CAExG"}

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

@@ -0,0 +1,148 @@
+import { canonicalizeUri } from '../internal.js';
+import { readString, scoreSemanticText, tokenizeSemanticQuery, uniqueStrings } from './utils.js';
+export function createWebKnowledgeGapRepairer(options) {
+    return async (request) => repairKnowledgeGapsWithWeb(request, options);
+}
+async function repairKnowledgeGapsWithWeb(request, options) {
+    const query = buildGapRepairQuery(request);
+    if (!query) {
+        return {
+            searched: false,
+            ingestedSourceIds: [],
+            skippedUrls: [],
+            reason: 'No concrete subject was available for gap repair.',
+        };
+    }
+    let response;
+    try {
+        response = await options.searchService.search({
+            query,
+            maxResults: Math.max(2, Math.min(12, options.maxResults ?? 6)),
+            verbosity: 'snippets',
+            safeSearch: 'moderate',
+            metadata: {
+                purpose: 'knowledge-gap-repair',
+                knowledgeSpaceId: request.spaceId,
+            },
+        });
+    }
+    catch (error) {
+        return {
+            searched: true,
+            query,
+            ingestedSourceIds: [],
+            skippedUrls: [],
+            reason: error instanceof Error ? error.message : String(error),
+        };
+    }
+    const existing = new Set(request.sources.flatMap((source) => [
+        canonicalizeUri(source.canonicalUri ?? ''),
+        canonicalizeUri(source.sourceUri ?? ''),
+    ].filter((value) => Boolean(value))));
+    const candidates = selectGapRepairCandidates(response.results, existing, options, query);
+    if (candidates.length < Math.max(2, options.minDistinctDomains ?? 2)) {
+        return {
+            searched: true,
+            query,
+            ingestedSourceIds: [],
+            skippedUrls: response.results.map((result) => result.url),
+            reason: 'Fewer than two distinct external sources were found for source-backed gap repair.',
+        };
+    }
+    const ingestedSourceIds = [];
+    const skippedUrls = [];
+    for (const result of candidates.slice(0, Math.max(2, Math.min(4, options.maxIngest ?? 3)))) {
+        try {
+            const ingested = await options.ingestService.ingestUrl({
+                url: result.url,
+                ...(result.title ? { title: result.title } : {}),
+                sourceType: 'url',
+                connectorId: 'semantic-gap-repair',
+                tags: ['semantic-gap-repair', 'gap-repair', ...gapRepairTags(request)],
+                metadata: {
+                    knowledgeSpaceId: request.spaceId,
+                    sourceDiscovery: {
+                        purpose: 'semantic-gap-repair',
+                        query,
+                        providerId: response.providerId,
+                        gapIds: request.gaps.map((gap) => gap.id),
+                        gapQuestions: request.gaps.map((gap) => gap.title),
+                        originalSourceIds: request.sources.map((source) => source.id),
+                        linkedObjectIds: request.linkedObjects.map((node) => node.id),
+                        searchedAt: Date.now(),
+                    },
+                },
+            });
+            if (ingested.source.status === 'indexed' || ingested.source.status === 'pending') {
+                ingestedSourceIds.push(ingested.source.id);
+            }
+        }
+        catch {
+            skippedUrls.push(result.url);
+        }
+    }
+    return {
+        searched: true,
+        query,
+        ingestedSourceIds,
+        skippedUrls,
+        ...(ingestedSourceIds.length < 2 ? { reason: 'Gap repair searched but fewer than two sources were ingested.' } : {}),
+    };
+}
+function buildGapRepairQuery(request) {
+    const subject = bestSubject(request);
+    if (!subject)
+        return null;
+    const gapTerms = uniqueStrings(request.gaps.flatMap((gap) => [
+        gap.title,
+        gap.summary,
+        readString(gap.metadata.reason),
+    ])).join(' ');
+    return uniqueStrings([
+        subject,
+        gapTerms,
+        'official specifications features',
+    ]).join(' ');
+}
+function bestSubject(request) {
+    const linked = request.linkedObjects[0];
+    const source = request.sources[0];
+    const metadata = linked?.metadata ?? {};
+    return uniqueStrings([
+        readString(metadata.manufacturer),
+        readString(metadata.model),
+        linked?.title,
+        source?.title,
+    ]).join(' ') || null;
+}
+function selectGapRepairCandidates(results, existingCanonicalUris, options, query) {
+    const tokens = tokenizeSemanticQuery(query);
+    const byDomain = new Map();
+    for (const result of results) {
+        const canonical = canonicalizeUri(result.url);
+        if (!canonical || existingCanonicalUris.has(canonical))
+            continue;
+        const searchable = [result.title, result.snippet, result.url, result.domain].filter(Boolean).join(' ');
+        if (tokens.length > 0 && scoreSemanticText(searchable, tokens) === 0)
+            continue;
+        const domain = result.domain ?? safeDomain(result.url);
+        if (!domain || byDomain.has(domain))
+            continue;
+        byDomain.set(domain, result);
+    }
+    return [...byDomain.values()].slice(0, Math.max(2, Math.min(8, options.maxResults ?? 6)));
+}
+function safeDomain(url) {
+    try {
+        return new URL(url).hostname;
+    }
+    catch {
+        return undefined;
+    }
+}
+function gapRepairTags(request) {
+    return uniqueStrings([
+        ...request.linkedObjects.flatMap((node) => [node.kind, node.title]),
+        ...request.sources.flatMap((source) => source.tags),
+    ]).slice(0, 12);
+}

package/dist/_internal/platform/knowledge/semantic/index.d.ts

@@ -1,5 +1,8 @@
 export { createProviderBackedKnowledgeSemanticLlm } from './llm.js';
+export { createWebKnowledgeGapRepairer } from './gap-repair.js';
 export { KnowledgeSemanticService } from './service.js';
+export { runKnowledgeSemanticSelfImprovement } from './self-improvement.js';
+export type { WebGapRepairOptions } from './gap-repair.js';
 export type { KnowledgeSemanticServiceOptions } from './service.js';
-export type { KnowledgeSemanticAnswer, KnowledgeSemanticAnswerInput, KnowledgeSemanticAnswerResult, KnowledgeSemanticEnrichmentResult, KnowledgeSemanticExtraction, KnowledgeSemanticFactInput, KnowledgeSemanticFactKind, KnowledgeSemanticGapInput, KnowledgeSemanticLlm, KnowledgeSemanticLlmAnswer, } from './types.js';
+export type { KnowledgeSemanticAnswer, KnowledgeSemanticAnswerInput, KnowledgeSemanticAnswerResult, KnowledgeSemanticEnrichmentResult, KnowledgeSemanticExtraction, KnowledgeSemanticFactInput, KnowledgeSemanticFactKind, KnowledgeSemanticGapRepairer, KnowledgeSemanticGapRepairRequest, KnowledgeSemanticGapRepairResult, KnowledgeSemanticGapInput, KnowledgeSemanticLlm, KnowledgeSemanticLlmAnswer, KnowledgeSemanticSelfImproveInput, KnowledgeSemanticSelfImproveResult, } from './types.js';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/_internal/platform/knowledge/semantic/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,wCAAwC,EAAE,MAAM,UAAU,CAAC;AACpE,OAAO,EAAE,wBAAwB,EAAE,MAAM,cAAc,CAAC;AACxD,YAAY,EAAE,+BAA+B,EAAE,MAAM,cAAc,CAAC;AACpE,YAAY,EACV,uBAAuB,EACvB,4BAA4B,EAC5B,6BAA6B,EAC7B,iCAAiC,EACjC,2BAA2B,EAC3B,0BAA0B,EAC1B,yBAAyB,EACzB,yBAAyB,EACzB,oBAAoB,EACpB,0BAA0B,GAC3B,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/_internal/platform/knowledge/semantic/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,wCAAwC,EAAE,MAAM,UAAU,CAAC;AACpE,OAAO,EAAE,6BAA6B,EAAE,MAAM,iBAAiB,CAAC;AAChE,OAAO,EAAE,wBAAwB,EAAE,MAAM,cAAc,CAAC;AACxD,OAAO,EAAE,mCAAmC,EAAE,MAAM,uBAAuB,CAAC;AAC5E,YAAY,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAC3D,YAAY,EAAE,+BAA+B,EAAE,MAAM,cAAc,CAAC;AACpE,YAAY,EACV,uBAAuB,EACvB,4BAA4B,EAC5B,6BAA6B,EAC7B,iCAAiC,EACjC,2BAA2B,EAC3B,0BAA0B,EAC1B,yBAAyB,EACzB,4BAA4B,EAC5B,iCAAiC,EACjC,gCAAgC,EAChC,yBAAyB,EACzB,oBAAoB,EACpB,0BAA0B,EAC1B,iCAAiC,EACjC,kCAAkC,GACnC,MAAM,YAAY,CAAC"}

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

@@ -1,2 +1,4 @@
 export { createProviderBackedKnowledgeSemanticLlm } from './llm.js';
+export { createWebKnowledgeGapRepairer } from './gap-repair.js';
 export { KnowledgeSemanticService } from './service.js';
+export { runKnowledgeSemanticSelfImprovement } from './self-improvement.js';

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

@@ -0,0 +1,10 @@
+import type { KnowledgeStore } from '../store.js';
+import type { KnowledgeSemanticGapRepairer, KnowledgeSemanticSelfImproveInput, KnowledgeSemanticSelfImproveResult } from './types.js';
+interface SelfImproveContext {
+    readonly store: KnowledgeStore;
+    readonly gapRepairer?: KnowledgeSemanticGapRepairer | null;
+    readonly activeGapRepairs: Set<string>;
+}
+export declare function runKnowledgeSemanticSelfImprovement(context: SelfImproveContext, input?: KnowledgeSemanticSelfImproveInput): Promise<KnowledgeSemanticSelfImproveResult>;
+export {};
+//# sourceMappingURL=self-improvement.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"self-improvement.d.ts","sourceRoot":"","sources":["../../../../../src/_internal/platform/knowledge/semantic/self-improvement.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAOlD,OAAO,KAAK,EACV,4BAA4B,EAC5B,iCAAiC,EACjC,kCAAkC,EACnC,MAAM,YAAY,CAAC;AAapB,UAAU,kBAAkB;IAC1B,QAAQ,CAAC,KAAK,EAAE,cAAc,CAAC;IAC/B,QAAQ,CAAC,WAAW,CAAC,EAAE,4BAA4B,GAAG,IAAI,CAAC;IAC3D,QAAQ,CAAC,gBAAgB,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;CACxC;AASD,wBAAsB,mCAAmC,CACvD,OAAO,EAAE,kBAAkB,EAC3B,KAAK,GAAE,iCAAsC,GAC5C,OAAO,CAAC,kCAAkC,CAAC,CAwF7C"}