@pellux/goodvibes-sdk 0.28.15 → 0.28.16

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

@@ -3,7 +3,7 @@
   "product": {
     "id": "goodvibes",
     "surface": "operator",
-    "version": "0.28.15"
+    "version": "0.28.16"
   },
   "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.28.15";
+    readonly productVersion: "0.28.16";
     readonly operatorMethodCount: 265;
     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.28.15",
+    "productVersion": "0.28.16",
     "operatorMethodCount": 265,
     "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.28.15"
+        "version": "0.28.16"
     },
     "auth": {
         "modes": [

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

@@ -18,6 +18,7 @@ async function repairKnowledgeGapsWithWeb(request, options) {
     const sourceLimit = Math.max(2, Math.min(5, request.maxSources ?? options.maxSources ?? options.maxIngest ?? 5));
     const searchLimit = Math.max(1, Math.min(5, options.maxSearches ?? queries.length));
     const existingCandidates = selectExistingRepairSources(request, options, sourceLimit);
+    const acceptedExisting = candidateCanonicalUris(existingCandidates);
     const searchResults = new Map();
     const providerIds = new Set();
     let lastError;
@@ -47,7 +48,7 @@ async function repairKnowledgeGapsWithWeb(request, options) {
                     continue;
                 searchResults.set(canonical, { ...result, searchQuery: query, searchProviderId: response.providerId });
             }
-            const partial = mergeRepairCandidates(existingCandidates, selectGapRepairCandidates([...searchResults.values()], existing, options, request, sourceLimit), sourceLimit);
+            const partial = mergeRepairCandidates(existingCandidates, selectGapRepairCandidates([...searchResults.values()], acceptedExisting, options, request, sourceLimit), sourceLimit);
             if (hasEnoughRepairEvidence(partial, options))
                 break;
         }
@@ -58,7 +59,7 @@ async function repairKnowledgeGapsWithWeb(request, options) {
         }
     }
     const allResults = [...searchResults.values()];
-    const candidates = mergeRepairCandidates(existingCandidates, selectGapRepairCandidates(allResults, existing, options, request, sourceLimit), sourceLimit);
+    const candidates = mergeRepairCandidates(existingCandidates, selectGapRepairCandidates(allResults, acceptedExisting, options, request, sourceLimit), sourceLimit);
     if (!hasEnoughRepairEvidence(candidates, options)) {
         return {
             searched: true,
@@ -228,7 +229,7 @@ function selectExistingRepairSources(request, options, sourceLimit) {
     const minimumConfidence = Math.max(1, Math.min(100, options.minConfidence ?? 70));
     const byDomain = new Map();
     for (const source of request.sources) {
-        if (source.status !== 'indexed' || isGeneratedOrSyntheticSource(source))
+        if ((source.status !== 'indexed' && source.status !== 'pending') || isGeneratedOrSyntheticSource(source))
             continue;
         const url = source.sourceUri ?? source.canonicalUri;
         if (!url)
@@ -251,7 +252,10 @@ function selectExistingRepairSources(request, options, sourceLimit) {
             ...(snippet ? { snippet } : {}),
         };
         const assessment = assessGapRepairSource(result, request.query, request);
-        if (assessment.confidence < minimumConfidence && !isOfficialOrVendorSource(assessment.reasons))
+        const officialOrVendor = isOfficialOrVendorSource(assessment.reasons);
+        if (source.status !== 'indexed' && !officialOrVendor)
+            continue;
+        if (assessment.confidence < minimumConfidence && !officialOrVendor)
             continue;
         byDomain.set(domain, {
             ...result,
@@ -262,6 +266,9 @@ function selectExistingRepairSources(request, options, sourceLimit) {
     }
     return [...byDomain.values()].sort(compareRepairCandidates).slice(0, sourceLimit);
 }
+function candidateCanonicalUris(candidates) {
+    return new Set(candidates.map((candidate) => canonicalizeUri(candidate.url)).filter((value) => Boolean(value)));
+}
 function assessGapRepairSource(result, query, request) {
     const searchable = [result.title, result.snippet, result.url, result.domain].filter(Boolean).join(' ').toLowerCase();
     const reasons = [];

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

@@ -7,5 +7,5 @@ export interface SelfImprovePromotionContext {
         readonly knowledgeSpaceId?: string;
     }) => Promise<unknown>;
 }
-export declare function promoteRepairSources(context: SelfImprovePromotionContext, spaceId: string, gap: KnowledgeNodeRecord, sourceIds: readonly string[], task: KnowledgeRefinementTaskRecord, deadlineAt: number): Promise<void>;
+export declare function promoteRepairSources(context: SelfImprovePromotionContext, spaceId: string, gap: KnowledgeNodeRecord, sourceIds: readonly string[], task: KnowledgeRefinementTaskRecord, deadlineAt: number): Promise<number>;
 //# sourceMappingURL=self-improvement-promotion.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"self-improvement-promotion.d.ts","sourceRoot":"","sources":["../../../../../src/_internal/platform/knowledge/semantic/self-improvement-promotion.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,KAAK,EAEV,mBAAmB,EACnB,6BAA6B,EAE9B,MAAM,aAAa,CAAC;AAiBrB,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,CAAC,KAAK,EAAE,cAAc,CAAC;IAC/B,QAAQ,CAAC,YAAY,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE;QAAE,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;QAAC,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAA;KAAE,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;CAC3I;AAED,wBAAsB,oBAAoB,CACxC,OAAO,EAAE,2BAA2B,EACpC,OAAO,EAAE,MAAM,EACf,GAAG,EAAE,mBAAmB,EACxB,SAAS,EAAE,SAAS,MAAM,EAAE,EAC5B,IAAI,EAAE,6BAA6B,EACnC,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,IAAI,CAAC,CAoBf"}
+{"version":3,"file":"self-improvement-promotion.d.ts","sourceRoot":"","sources":["../../../../../src/_internal/platform/knowledge/semantic/self-improvement-promotion.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,KAAK,EAEV,mBAAmB,EACnB,6BAA6B,EAE9B,MAAM,aAAa,CAAC;AAiBrB,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,CAAC,KAAK,EAAE,cAAc,CAAC;IAC/B,QAAQ,CAAC,YAAY,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE;QAAE,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;QAAC,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAA;KAAE,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;CAC3I;AAED,wBAAsB,oBAAoB,CACxC,OAAO,EAAE,2BAA2B,EACpC,OAAO,EAAE,MAAM,EACf,GAAG,EAAE,mBAAmB,EACxB,SAAS,EAAE,SAAS,MAAM,EAAE,EAC5B,IAAI,EAAE,6BAA6B,EACnC,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,MAAM,CAAC,CAwBjB"}

package/dist/_internal/platform/knowledge/semantic/self-improvement-promotion.js

@@ -17,10 +17,14 @@ export async function promoteRepairSources(context, spaceId, gap, sourceIds, tas
     }
     const promotedFactCount = await promoteRepairEvidenceFacts(context.store, spaceId, gap, sourceIds);
     await linkPromotedFactsToRepairSubjects(context.store, spaceId, gap, sourceIds);
+    const usableFactCount = promotedFactCount > 0
+        ? promotedFactCount
+        : countUsableRepairFacts(context.store, spaceId, sourceIds);
     await updateRefinementTask(context.store, context.store.getRefinementTask(task.id) ?? task, 'verified', 'Accepted repair sources were semantically enriched.', {
         promotedSourceIds: sourceIds,
-        promotedFactCount,
+        promotedFactCount: usableFactCount,
     });
+    return usableFactCount;
 }
 async function promoteRepairEvidenceFacts(store, spaceId, gap, sourceIds) {
     const subjects = linkedRepairSubjects(store, spaceId, gap);
@@ -225,6 +229,15 @@ function sourceAuthority(source) {
         return 'vendor';
     return 'secondary';
 }
+function countUsableRepairFacts(store, spaceId, sourceIds) {
+    const sources = new Set(sourceIds);
+    return store.listNodes(10_000)
+        .filter((node) => node.kind === 'fact' && node.status !== 'stale')
+        .filter((node) => getKnowledgeSpaceId(node) === spaceId)
+        .filter((node) => node.sourceId && sources.has(node.sourceId))
+        .filter((node) => ['feature', 'capability', 'specification', 'compatibility', 'configuration'].includes(readString(node.metadata.factKind) ?? ''))
+        .length;
+}
 function uniqueById(items) {
     const seen = new Set();
     const result = [];

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

@@ -1 +1 @@
-{"version":3,"file":"self-improvement.d.ts","sourceRoot":"","sources":["../../../../../src/_internal/platform/knowledge/semantic/self-improvement.ts"],"names":[],"mappings":"AAGA,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;IACvC,QAAQ,CAAC,YAAY,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE;QAAE,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;QAAC,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAA;KAAE,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;CAC3I;AAUD,wBAAsB,mCAAmC,CACvD,OAAO,EAAE,kBAAkB,EAC3B,KAAK,GAAE,iCAAsC,GAC5C,OAAO,CAAC,kCAAkC,CAAC,CA2N7C"}
+{"version":3,"file":"self-improvement.d.ts","sourceRoot":"","sources":["../../../../../src/_internal/platform/knowledge/semantic/self-improvement.ts"],"names":[],"mappings":"AAGA,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;IACvC,QAAQ,CAAC,YAAY,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE;QAAE,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;QAAC,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAA;KAAE,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;CAC3I;AAUD,wBAAsB,mCAAmC,CACvD,OAAO,EAAE,kBAAkB,EAC3B,KAAK,GAAE,iCAAsC,GAC5C,OAAO,CAAC,kCAAkC,CAAC,CA8N7C"}

package/dist/_internal/platform/knowledge/semantic/self-improvement.js

@@ -145,7 +145,7 @@ export async function runKnowledgeSemanticSelfImprovement(context, input = {}) {
             ingestedSources += result?.ingestedSourceIds.length ?? 0;
             ingestedSourceIds.push(...(result?.ingestedSourceIds ?? []));
             const acceptedSourceIds = uniqueStrings([...(result?.acceptedSourceIds ?? []), ...(result?.ingestedSourceIds ?? [])]);
-            const evidenceSufficient = result?.evidenceSufficient !== false && acceptedSourceIds.length > 0;
+            let promotedFactCount = 0;
             task = await updateRefinementTask(context.store, task, 'evaluating', result?.reason ?? 'Source discovery completed.', {
                 query: result?.query ?? gap.title,
                 sourceAssessments: result?.sourceAssessments ?? [],
@@ -158,8 +158,9 @@ export async function runKnowledgeSemanticSelfImprovement(context, input = {}) {
             }
             linkedRepairs += await linkRepairSources(context.store, spaceId, gap, acceptedSourceIds, result?.query ?? gap.title);
             if (acceptedSourceIds.length > 0) {
-                await promoteRepairSources(context, spaceId, gap, acceptedSourceIds, task, startedAt + maxRunMs);
+                promotedFactCount = await promoteRepairSources(context, spaceId, gap, acceptedSourceIds, task, startedAt + maxRunMs);
             }
+            const evidenceSufficient = result?.evidenceSufficient !== false && acceptedSourceIds.length > 0 && promotedFactCount > 0;
             await markGapRepairAttempt(context.store, gap, spaceId, {
                 status: evidenceSufficient ? 'repaired' : acceptedSourceIds.length ? 'deferred' : 'searched_no_sources',
                 reason: result?.reason,
@@ -170,12 +171,14 @@ export async function runKnowledgeSemanticSelfImprovement(context, input = {}) {
                 await updateRefinementTask(context.store, task, 'closed', 'Repair sources were accepted and linked to the gap.', {
                     acceptedSourceIds,
                     ingestedSourceIds: result?.ingestedSourceIds ?? [],
+                    promotedFactCount,
                 });
             }
             else if (acceptedSourceIds.length) {
                 blockedGaps += 1;
                 await updateRefinementTask(context.store, task, 'blocked', result?.reason ?? 'Accepted source evidence was linked, but the gap still needs corroboration.', {
                     acceptedSourceIds,
+                    promotedFactCount,
                     retryable: true,
                     nextRepairAttemptAt: Date.now() + RETRY_DELAY_MS,
                 });
@@ -413,8 +416,8 @@ function classifyGap(context, force) {
         return { action: 'skip', reason: 'Gap already has linked repair sources.', status: 'repaired' };
     if (!force && nextAttemptAt && nextAttemptAt > Date.now())
         return { action: 'skip', reason: 'Gap repair retry window has not elapsed.', status: 'retry_wait', markAttempt: true };
-    if (hasRepairEdge(context))
-        return { action: 'skip', reason: 'Gap already has a repair source.', status: 'already_repaired' };
+    if (!force && hasRepairEdge(context) && hasRepairFactEvidence(context))
+        return { action: 'skip', reason: 'Gap already has promoted repair facts.', status: 'already_repaired' };
     if (isNotApplicableGap(context))
         return { action: 'suppress', reason: 'The gap is not applicable to the linked subject.' };
     if (!hasConcreteSubject(context)) {
@@ -428,6 +431,10 @@ function classifyGap(context, force) {
 function hasRepairEdge(context) {
     return context.repairSourceIds.length > 0;
 }
+function hasRepairFactEvidence(context) {
+    const repairSourceIds = new Set(context.repairSourceIds);
+    return context.facts.some((fact) => fact.sourceId && repairSourceIds.has(fact.sourceId) && readString(fact.metadata.extractor) === 'repair-promotion');
+}
 function isNotApplicableGap(context) {
     const text = `${context.gap.title} ${context.gap.summary ?? ''}`.toLowerCase();
     if (text.includes('battery')) {

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":"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"}
+{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../../../../../src/_internal/platform/knowledge/semantic/service.ts"],"names":[],"mappings":"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"}

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

@@ -101,11 +101,26 @@ export class KnowledgeSemanticService {
     }
     async answer(input) {
         await this.store.init();
-        const answer = await answerKnowledgeQuery({ store: this.store, llm: this.options.llm }, input);
+        let answer = await answerKnowledgeQuery({ store: this.store, llm: this.options.llm }, input);
         if (input.autoRepairGaps === false)
             return answer;
         if (this.options.gapRepairer && answer.answer.gaps.length > 0) {
             const repairSpaceId = answerRepairSpaceId(answer);
+            const foregroundBudgetMs = foregroundAnswerRepairBudget(input, answer);
+            const foregroundTaskIds = [];
+            if (foregroundBudgetMs > 0) {
+                const repaired = await this.repairAnswerGaps({
+                    answer,
+                    maxRunMs: foregroundBudgetMs,
+                    limit: Math.min(5, answer.answer.gaps.length),
+                });
+                foregroundTaskIds.push(...repaired.taskIds);
+                if (repaired.closedGaps > 0 || repaired.linkedRepairs > 0) {
+                    answer = withRefinementTaskIds(await answerKnowledgeQuery({ store: this.store, llm: this.options.llm }, input), foregroundTaskIds);
+                    if (answer.answer.gaps.length === 0 || answerHasUsableEvidence(answer))
+                        return answer;
+                }
+            }
             const refinement = await this.selfImprove({
                 knowledgeSpaceId: repairSpaceId,
                 gapIds: answer.answer.gaps.map((gap) => gap.id),
@@ -115,17 +130,12 @@ export class KnowledgeSemanticService {
             });
             this.runAnswerRefinementInBackground(repairSpaceId, answer.answer.gaps.map((gap) => gap.id));
             const taskIds = uniqueStrings([
+                ...foregroundTaskIds,
                 ...refinement.taskIds,
                 ...this.taskIdsForGaps(repairSpaceId, answer.answer.gaps.map((gap) => gap.id)),
             ]);
             if (taskIds.length > 0) {
-                return {
-                    ...answer,
-                    answer: {
-                        ...answer.answer,
-                        refinementTaskIds: taskIds,
-                    },
-                };
+                return withRefinementTaskIds(answer, taskIds);
             }
         }
         return answer;
@@ -239,12 +249,45 @@ function answerRepairSpaceId(answer) {
     }
     return answer.spaceId;
 }
+function foregroundAnswerRepairBudget(input, answer) {
+    if (!answerNeedsForegroundRepair(input, answer))
+        return 0;
+    const requested = typeof input.timeoutMs === 'number' && Number.isFinite(input.timeoutMs)
+        ? input.timeoutMs
+        : 45_000;
+    if (requested < 15_000)
+        return 0;
+    return Math.max(5_000, Math.min(35_000, requested - 5_000));
+}
+function answerNeedsForegroundRepair(input, answer) {
+    const repairSpaceId = answerRepairSpaceId(answer);
+    const homeAssistantScoped = repairSpaceId === 'homeassistant' || repairSpaceId.startsWith('homeassistant:');
+    if (!input.strictCandidates && !homeAssistantScoped)
+        return false;
+    return answer.answer.facts.length === 0 || answer.answer.sources.length === 0 || answer.answer.confidence < 50;
+}
+function answerHasUsableEvidence(answer) {
+    return answer.answer.facts.length > 0 && answer.answer.sources.length > 0 && answer.answer.confidence >= 50;
+}
+function withRefinementTaskIds(answer, taskIds) {
+    const ids = uniqueStrings([...(answer.answer.refinementTaskIds ?? []), ...taskIds]);
+    if (ids.length === 0)
+        return answer;
+    return {
+        ...answer,
+        answer: {
+            ...answer.answer,
+            refinementTaskIds: ids,
+        },
+    };
+}
 function activeSelfImproveResult(input) {
     const requestedLimit = Math.max(1, input.limit ?? 1);
     return {
         ...emptySelfImproveResult(),
         skippedGaps: 1,
         requestedLimit,
+        effectiveLimit: requestedLimit,
         truncated: true,
         budgetExhausted: true,
     };

package/dist/_internal/platform/version.js

@@ -1,6 +1,6 @@
 import { readFileSync } from 'node:fs';
 import { join } from 'node:path';
-let version = '0.28.15';
+let version = '0.28.16';
 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.28.15",
+  "version": "0.28.16",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/mgd34msu/goodvibes-sdk.git"