@pellux/goodvibes-sdk 0.28.15 → 0.28.17

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

@@ -1,6 +1,7 @@
 import { yieldEvery, yieldToEventLoop } from '../cooperative.js';
 import { getKnowledgeSpaceId } from '../spaces.js';
 import { hasConcreteFeatureSignal, isLowValueFeatureOrSpecText } from './fact-quality.js';
+import { deriveRepairProfileFacts } from './repair-profile.js';
 import { updateRefinementTask } from './self-improvement-tasks.js';
 import { withTimeout } from './timeouts.js';
 import { clampText, normalizeWhitespace, readRecord, readString, semanticHash, semanticMetadata, semanticSlug, sourceSemanticText, splitSentences, uniqueStrings, } from './utils.js';
@@ -17,10 +18,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);
@@ -33,70 +38,104 @@ async function promoteRepairEvidenceFacts(store, spaceId, gap, sourceIds) {
             continue;
         const extraction = store.getExtractionBySourceId(source.id);
         const authority = sourceAuthority(source);
+        const text = sourceSemanticText(source, extraction);
+        const profileFacts = deriveRepairProfileFacts({
+            query: gap.title,
+            source,
+            text,
+        });
+        for (const profileFact of profileFacts) {
+            promoted += await upsertPromotedRepairFact({
+                store,
+                spaceId,
+                gap,
+                source,
+                subjects,
+                authority,
+                title: profileFact.title,
+                summary: profileFact.summary,
+                classification: profileFact,
+                evidence: profileFact.evidence,
+            });
+        }
         const sentences = selectRepairFactSentences({
             query: gap.title,
             source,
-            text: sourceSemanticText(source, extraction),
+            text,
         });
-        for (const [index, sentence] of sentences.entries()) {
+        for (const sentence of sentences) {
             const classification = classifyRepairFact(sentence);
-            const fact = await store.upsertNode({
-                id: `sem-fact-${semanticHash(spaceId, source.id, gap.id, classification.title, sentence)}`,
-                kind: 'fact',
-                slug: semanticSlug(`${spaceId}-${classification.title}-${source.id}-${index}`),
+            promoted += await upsertPromotedRepairFact({
+                store,
+                spaceId,
+                gap,
+                source,
+                subjects,
+                authority,
                 title: classification.title,
                 summary: sentence,
-                aliases: classification.aliases,
-                status: 'active',
-                confidence: authority === 'official-vendor' ? 88 : 76,
-                sourceId: source.id,
-                metadata: semanticMetadata(spaceId, {
-                    semanticKind: 'fact',
-                    factKind: classification.kind,
-                    value: classification.value,
-                    evidence: sentence,
-                    labels: classification.labels,
-                    sourceId: source.id,
-                    gapId: gap.id,
-                    linkedObjectIds: subjects.map((subject) => subject.id),
-                    extractor: 'repair-promotion',
-                    sourceAuthority: authority,
-                    sourceDiscovery: readRecord(source.metadata.sourceDiscovery),
-                }),
-            });
-            await store.upsertEdge({
-                fromKind: 'source',
-                fromId: source.id,
-                toKind: 'node',
-                toId: fact.id,
-                relation: 'supports_fact',
-                weight: authority === 'official-vendor' ? 0.95 : 0.84,
-                metadata: semanticMetadata(spaceId, {
-                    linkedBy: 'semantic-gap-repair',
-                    gapId: gap.id,
-                }),
+                classification,
+                evidence: sentence,
             });
-            for (const subject of subjects) {
-                await store.upsertEdge({
-                    fromKind: 'node',
-                    fromId: fact.id,
-                    toKind: 'node',
-                    toId: subject.id,
-                    relation: 'describes',
-                    weight: authority === 'official-vendor' ? 0.94 : 0.82,
-                    metadata: semanticMetadata(spaceId, {
-                        linkedBy: 'semantic-gap-repair',
-                        repairedAt: Date.now(),
-                        sourceId: source.id,
-                        gapId: gap.id,
-                    }),
-                });
-            }
-            promoted += 1;
         }
     }
     return promoted;
 }
+async function upsertPromotedRepairFact(input) {
+    const fact = await input.store.upsertNode({
+        id: `sem-fact-${semanticHash(input.spaceId, input.source.id, input.gap.id, input.title, input.summary)}`,
+        kind: 'fact',
+        slug: semanticSlug(`${input.spaceId}-${input.title}-${input.source.id}`),
+        title: input.title,
+        summary: input.summary,
+        aliases: input.classification.aliases,
+        status: 'active',
+        confidence: input.authority === 'official-vendor' ? 90 : input.authority === 'vendor' ? 82 : 76,
+        sourceId: input.source.id,
+        metadata: semanticMetadata(input.spaceId, {
+            semanticKind: 'fact',
+            factKind: input.classification.kind,
+            value: input.classification.value,
+            evidence: input.evidence,
+            labels: input.classification.labels,
+            sourceId: input.source.id,
+            gapId: input.gap.id,
+            linkedObjectIds: input.subjects.map((subject) => subject.id),
+            extractor: 'repair-promotion',
+            sourceAuthority: input.authority,
+            sourceDiscovery: readRecord(input.source.metadata.sourceDiscovery),
+        }),
+    });
+    await input.store.upsertEdge({
+        fromKind: 'source',
+        fromId: input.source.id,
+        toKind: 'node',
+        toId: fact.id,
+        relation: 'supports_fact',
+        weight: input.authority === 'official-vendor' ? 0.96 : 0.84,
+        metadata: semanticMetadata(input.spaceId, {
+            linkedBy: 'semantic-gap-repair',
+            gapId: input.gap.id,
+        }),
+    });
+    for (const subject of input.subjects) {
+        await input.store.upsertEdge({
+            fromKind: 'node',
+            fromId: fact.id,
+            toKind: 'node',
+            toId: subject.id,
+            relation: 'describes',
+            weight: input.authority === 'official-vendor' ? 0.95 : 0.82,
+            metadata: semanticMetadata(input.spaceId, {
+                linkedBy: 'semantic-gap-repair',
+                repairedAt: Date.now(),
+                sourceId: input.source.id,
+                gapId: input.gap.id,
+            }),
+        });
+    }
+    return 1;
+}
 async function linkPromotedFactsToRepairSubjects(store, spaceId, gap, sourceIds) {
     const linkedObjectIds = readStringArray(gap.metadata.linkedObjectIds).filter((nodeId) => Boolean(store.getNode(nodeId)));
     if (linkedObjectIds.length === 0)
@@ -225,6 +264,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,CA+N7C"}

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

@@ -23,11 +23,12 @@ export async function runKnowledgeSemanticSelfImprovement(context, input = {}) {
     const createdGaps = await discoverIntrinsicGaps(context.store, spaceId, sourceIdFilter);
     const candidates = collectCandidateGaps(context.store, spaceId, sourceIdFilter, gapIdFilter);
     const requestedLimit = Math.max(1, input.limit ?? DEFAULT_REFINEMENT_LIMIT);
-    const effectiveLimit = Math.min(requestedLimit, MAX_REFINEMENT_LIMIT);
+    const cappedLimit = Math.min(requestedLimit, MAX_REFINEMENT_LIMIT);
     const maxRunMs = Math.min(MAX_REFINEMENT_RUN_MS, Math.max(5_000, input.maxRunMs ?? DEFAULT_REFINEMENT_RUN_MS));
     const startedAt = Date.now();
-    const gaps = candidates.slice(0, effectiveLimit);
-    let truncated = candidates.length > gaps.length || requestedLimit > effectiveLimit;
+    const gaps = candidates.slice(0, cappedLimit);
+    const effectiveLimit = gaps.length;
+    let truncated = candidates.length > gaps.length || requestedLimit > cappedLimit;
     let budgetExhausted = false;
     let processedGaps = 0;
     let repairableGaps = 0;
@@ -145,7 +146,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 +159,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 +172,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 +417,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 +432,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: 0,
         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.17';
 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.17",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/mgd34msu/goodvibes-sdk.git"
@@ -13,6 +13,7 @@
     "@ast-grep/napi": "^0.42.0",
     "@aws/bedrock-token-generator": "^1.1.0",
     "@mozilla/readability": "^0.6.0",
+    "@smithy/util-retry": "4.3.6",
     "bash-language-server": "file:vendor/bash-language-server",
     "bplist-parser": "^0.3.2",
     "cloudflare": "5.2.0",