@pellux/goodvibes-sdk 1.1.0 → 1.3.0

package/dist/platform/knowledge/home-graph/link.d.ts

@@ -1,5 +1,5 @@
 import type { KnowledgeStore } from '../store.js';
-import type { HomeGraphLinkInput, HomeGraphLinkResult } from './types.js';
+import type { HomeGraphLinkInput, HomeGraphLinkResult, HomeGraphUnlinkResult } from './types.js';
 export declare function linkHomeGraphKnowledge(store: KnowledgeStore, input: HomeGraphLinkInput & {
     readonly spaceId: string;
     readonly installationId: string;
@@ -7,5 +7,5 @@ export declare function linkHomeGraphKnowledge(store: KnowledgeStore, input: Hom
 export declare function unlinkHomeGraphKnowledge(store: KnowledgeStore, input: HomeGraphLinkInput & {
     readonly spaceId: string;
     readonly installationId: string;
-}): Promise<HomeGraphLinkResult>;
+}): Promise<HomeGraphUnlinkResult>;
 //# sourceMappingURL=link.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"link.d.ts","sourceRoot":"","sources":["../../../../src/platform/knowledge/home-graph/link.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAQlD,OAAO,KAAK,EAA4B,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAEpG,wBAAsB,sBAAsB,CAC1C,KAAK,EAAE,cAAc,EACrB,KAAK,EAAE,kBAAkB,GAAG;IAAE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAA;CAAE,GACxF,OAAO,CAAC,mBAAmB,CAAC,CAgB9B;AAED,wBAAsB,wBAAwB,CAC5C,KAAK,EAAE,cAAc,EACrB,KAAK,EAAE,kBAAkB,GAAG;IAAE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAA;CAAE,GACxF,OAAO,CAAC,mBAAmB,CAAC,CAU9B"}
+{"version":3,"file":"link.d.ts","sourceRoot":"","sources":["../../../../src/platform/knowledge/home-graph/link.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AASlD,OAAO,KAAK,EAA4B,kBAAkB,EAAE,mBAAmB,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAQ3H,wBAAsB,sBAAsB,CAC1C,KAAK,EAAE,cAAc,EACrB,KAAK,EAAE,kBAAkB,GAAG;IAAE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAA;CAAE,GACxF,OAAO,CAAC,mBAAmB,CAAC,CAgB9B;AAED,wBAAsB,wBAAwB,CAC5C,KAAK,EAAE,cAAc,EACrB,KAAK,EAAE,kBAAkB,GAAG;IAAE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAA;CAAE,GACxF,OAAO,CAAC,qBAAqB,CAAC,CA+BhC"}

package/dist/platform/knowledge/home-graph/link.js

@@ -1,4 +1,5 @@
 import { GoodVibesSdkError } from '@pellux/goodvibes-errors';
+import { isActiveKnowledgeEdge } from '../projection-utils.js';
 import { belongsToSpace, buildHomeGraphMetadata, homeGraphNodeId, nodeKindForHomeGraphObject, targetToReference, } from './helpers.js';
 export async function linkHomeGraphKnowledge(store, input) {
     const from = resolveLinkSource(store, input.spaceId, input);
@@ -18,15 +19,62 @@ export async function linkHomeGraphKnowledge(store, input) {
     return { ok: true, spaceId: input.spaceId, edge, target: target.record };
 }
 export async function unlinkHomeGraphKnowledge(store, input) {
-    const linked = await linkHomeGraphKnowledge(store, {
-        ...input,
-        metadata: {
-            ...(input.metadata ?? {}),
-            linkStatus: 'unlinked',
-            unlinkedAt: Date.now(),
-        },
-    });
-    return { ...linked, edge: linked.edge };
+    const from = resolveLinkSource(store, input.spaceId, input);
+    const target = resolveExistingHomeGraphTarget(store, input.spaceId, input.target);
+    const relation = input.relation ?? input.target.relation ?? 'source_for';
+    // Never-linked target: nothing to reverse, and we materialize no phantom records.
+    if (!target) {
+        return { ok: true, spaceId: input.spaceId, reversed: false, target: null };
+    }
+    const edge = findHomeGraphLinkEdge(store, from, target, relation);
+    if (!edge) {
+        return { ok: true, spaceId: input.spaceId, reversed: false, target: target.record };
+    }
+    await store.deleteEdge(edge.id);
+    let removedNodeId;
+    if (target.kind === 'node'
+        && target.record
+        && wasLinkCreatedNode(target.record)
+        && !hasOtherActiveEdges(store, target.id, edge.id)) {
+        await store.deleteNode(target.id);
+        removedNodeId = target.id;
+    }
+    return {
+        ok: true,
+        spaceId: input.spaceId,
+        reversed: true,
+        removedEdgeId: edge.id,
+        ...(removedNodeId ? { removedNodeId } : {}),
+        target: target.record,
+    };
+}
+function resolveExistingHomeGraphTarget(store, spaceId, target) {
+    const ref = targetToReference(target);
+    if (ref.kind === 'source') {
+        const source = store.getSource(ref.id);
+        return source && belongsToSpace(source, spaceId) ? { kind: 'source', id: source.id, record: source } : null;
+    }
+    const existing = store.getNode(ref.id);
+    if (existing && belongsToSpace(existing, spaceId))
+        return { kind: 'node', id: existing.id, record: existing };
+    const kind = ref.nodeKind ?? nodeKindForHomeGraphObject(target.kind);
+    const deterministic = store.getNode(homeGraphNodeId(spaceId, kind, ref.id));
+    return deterministic && belongsToSpace(deterministic, spaceId)
+        ? { kind: 'node', id: deterministic.id, record: deterministic }
+        : null;
+}
+function findHomeGraphLinkEdge(store, from, target, relation) {
+    return store.edgesFor(from.kind, from.id).find((edge) => (edge.fromKind === from.kind
+        && edge.fromId === from.id
+        && edge.toKind === target.kind
+        && edge.toId === target.id
+        && edge.relation === relation));
+}
+function wasLinkCreatedNode(node) {
+    return node.metadata.linkCreated === true;
+}
+function hasOtherActiveEdges(store, nodeId, excludeEdgeId) {
+    return store.edgesFor('node', nodeId).some((edge) => edge.id !== excludeEdgeId && isActiveKnowledgeEdge(edge));
 }
 function resolveLinkSource(store, spaceId, input) {
     if (input.sourceId) {
@@ -88,6 +136,9 @@ async function ensureHomeGraphLinkTarget(store, spaceId, installationId, target)
         confidence: 60,
         metadata: buildHomeGraphMetadata(spaceId, installationId, {
             homeAssistant: { installationId, objectKind: kind, objectId: target.id },
+            // Marks a node the link itself materialized, so unlink can cleanly remove it
+            // (and only it) on reversal.
+            linkCreated: true,
         }),
     };
     const node = await store.upsertNode(nodeInput);

package/dist/platform/knowledge/home-graph/refinement.d.ts

@@ -1,6 +1,7 @@
 import type { KnowledgeSemanticService } from '../semantic/index.js';
 import type { KnowledgeStore } from '../store.js';
 import type { KnowledgeRefinementTaskRecord } from '../types.js';
+import { type HomeGraphTriageOptions, type HomeGraphTriageResult } from './triage.js';
 import type { HomeGraphSpaceInput } from './types.js';
 export declare function listHomeGraphRefinementTasks(input: HomeGraphSpaceInput & {
     readonly store: KnowledgeStore;
@@ -29,16 +30,20 @@ export declare function runHomeGraphRefinement(input: HomeGraphSpaceInput & {
     readonly limit?: number | undefined;
     readonly maxRunMs?: number | undefined;
     readonly force?: boolean | undefined;
+    /**
+     * Run the LLM issue-triage pass over open device-quality issues. `true` uses
+     * defaults; an object customizes thresholds/limits/rules. Omitted → unchanged
+     * gap-refinement behavior for existing callers.
+     */
+    readonly triage?: HomeGraphTriageOptions | boolean | undefined;
+    /** Skip the gap self-improvement pass (e.g. a triage-only run). */
+    readonly skipGapRefinement?: boolean | undefined;
 }): Promise<{
-    ok: boolean;
-    spaceId: string;
-    error: string;
-    result?: never;
-} | {
-    ok: boolean;
-    spaceId: string;
-    result: import("../semantic/types.js").KnowledgeSemanticSelfImproveResult;
-    error?: never;
+    readonly ok: boolean;
+    readonly spaceId: string;
+    readonly error?: string | undefined;
+    readonly result?: Awaited<ReturnType<KnowledgeSemanticService['selfImprove']>> | undefined;
+    readonly triage?: HomeGraphTriageResult | undefined;
 }>;
 export declare function cancelHomeGraphRefinementTask(input: HomeGraphSpaceInput & {
     readonly store: KnowledgeStore;

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

@@ -1 +1 @@
-{"version":3,"file":"refinement.d.ts","sourceRoot":"","sources":["../../../../src/platform/knowledge/home-graph/refinement.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,sBAAsB,CAAC;AACrE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,KAAK,EAAE,6BAA6B,EAAE,MAAM,aAAa,CAAC;AAEjE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAEtD,wBAAsB,4BAA4B,CAAC,KAAK,EAAE,mBAAmB,GAAG;IAC9E,QAAQ,CAAC,KAAK,EAAE,cAAc,CAAC;IAC/B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACpC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACpC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACxC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACrC,GAAG,OAAO,CAAC;IAAE,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,SAAS,6BAA6B,EAAE,CAAA;CAAE,CAAC,CAcrH;AAED,wBAAsB,0BAA0B,CAAC,KAAK,EAAE,mBAAmB,GAAG;IAC5E,QAAQ,CAAC,KAAK,EAAE,cAAc,CAAC;IAC/B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB,GAAG,OAAO,CAAC;IAAE,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,6BAA6B,GAAG,IAAI,CAAA;CAAE,CAAC,CAKhH;AAED,wBAAsB,sBAAsB,CAAC,KAAK,EAAE,mBAAmB,GAAG;IACxE,QAAQ,CAAC,KAAK,EAAE,cAAc,CAAC;IAC/B,QAAQ,CAAC,eAAe,CAAC,EAAE,wBAAwB,GAAG,SAAS,CAAC;IAChE,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,CAAC;IAChD,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,CAAC;IACnD,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACpC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACvC,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;CACtC;;;;;;;;;;GAcA;AAED,wBAAsB,6BAA6B,CAAC,KAAK,EAAE,mBAAmB,GAAG;IAC/E,QAAQ,CAAC,KAAK,EAAE,cAAc,CAAC;IAC/B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;;;;;;;;;;GAuBA"}
+{"version":3,"file":"refinement.d.ts","sourceRoot":"","sources":["../../../../src/platform/knowledge/home-graph/refinement.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,sBAAsB,CAAC;AACrE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,KAAK,EAAE,6BAA6B,EAAE,MAAM,aAAa,CAAC;AAEjE,OAAO,EAEL,KAAK,sBAAsB,EAC3B,KAAK,qBAAqB,EAC3B,MAAM,aAAa,CAAC;AACrB,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAEtD,wBAAsB,4BAA4B,CAAC,KAAK,EAAE,mBAAmB,GAAG;IAC9E,QAAQ,CAAC,KAAK,EAAE,cAAc,CAAC;IAC/B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACpC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACpC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACxC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACrC,GAAG,OAAO,CAAC;IAAE,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,SAAS,6BAA6B,EAAE,CAAA;CAAE,CAAC,CAcrH;AAED,wBAAsB,0BAA0B,CAAC,KAAK,EAAE,mBAAmB,GAAG;IAC5E,QAAQ,CAAC,KAAK,EAAE,cAAc,CAAC;IAC/B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB,GAAG,OAAO,CAAC;IAAE,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,6BAA6B,GAAG,IAAI,CAAA;CAAE,CAAC,CAKhH;AAED,wBAAsB,sBAAsB,CAAC,KAAK,EAAE,mBAAmB,GAAG;IACxE,QAAQ,CAAC,KAAK,EAAE,cAAc,CAAC;IAC/B,QAAQ,CAAC,eAAe,CAAC,EAAE,wBAAwB,GAAG,SAAS,CAAC;IAChE,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,CAAC;IAChD,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,CAAC;IACnD,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACpC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACvC,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IACrC;;;;OAIG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,sBAAsB,GAAG,OAAO,GAAG,SAAS,CAAC;IAC/D,mEAAmE;IACnE,QAAQ,CAAC,iBAAiB,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;CAClD,GAAG,OAAO,CAAC;IACV,QAAQ,CAAC,EAAE,EAAE,OAAO,CAAC;IACrB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACpC,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,UAAU,CAAC,wBAAwB,CAAC,aAAa,CAAC,CAAC,CAAC,GAAG,SAAS,CAAC;IAC3F,QAAQ,CAAC,MAAM,CAAC,EAAE,qBAAqB,GAAG,SAAS,CAAC;CACrD,CAAC,CAgCD;AAED,wBAAsB,6BAA6B,CAAC,KAAK,EAAE,mBAAmB,GAAG;IAC/E,QAAQ,CAAC,KAAK,EAAE,cAAc,CAAC;IAC/B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;;;;;;;;;;GAuBA"}

package/dist/platform/knowledge/home-graph/refinement.js

@@ -1,4 +1,5 @@
 import { resolveReadableHomeGraphSpace } from './space-selection.js';
+import { runHomeGraphIssueTriage, } from './triage.js';
 export async function listHomeGraphRefinementTasks(input) {
     await input.store.init();
     const { spaceId } = resolveReadableHomeGraphSpace(input.store, input);
@@ -23,8 +24,22 @@ export async function getHomeGraphRefinementTask(input) {
 export async function runHomeGraphRefinement(input) {
     await input.store.init();
     const { spaceId } = resolveReadableHomeGraphSpace(input.store, input);
-    if (!input.semanticService)
-        return { ok: false, spaceId, error: 'Semantic refinement is not configured.' };
+    const triageRequested = input.triage !== undefined && input.triage !== false;
+    const triage = triageRequested
+        ? await runHomeGraphIssueTriage({
+            store: input.store,
+            ...(input.semanticService ? { semanticService: input.semanticService } : {}),
+            ...(input.installationId ? { installationId: input.installationId } : {}),
+            ...(input.knowledgeSpaceId ? { knowledgeSpaceId: input.knowledgeSpaceId } : {}),
+            options: typeof input.triage === 'object' ? input.triage : {},
+        })
+        : undefined;
+    if (input.skipGapRefinement === true) {
+        return { ok: true, spaceId, ...(triage ? { triage } : {}) };
+    }
+    if (!input.semanticService) {
+        return { ok: false, spaceId, error: 'Semantic refinement is not configured.', ...(triage ? { triage } : {}) };
+    }
     const result = await input.semanticService.selfImprove({
         knowledgeSpaceId: spaceId,
         gapIds: input.gapIds,
@@ -34,7 +49,7 @@ export async function runHomeGraphRefinement(input) {
         force: input.force,
         reason: 'manual',
     });
-    return { ok: true, spaceId, result };
+    return { ok: true, spaceId, result, ...(triage ? { triage } : {}) };
 }
 export async function cancelHomeGraphRefinementTask(input) {
     await input.store.init();

package/dist/platform/knowledge/home-graph/reset.js

@@ -1,4 +1,4 @@
-import { getKnowledgeSpaceId, normalizeKnowledgeSpaceId } from '../spaces.js';
+import { getExplicitKnowledgeSpaceId, getKnowledgeSpaceId, normalizeKnowledgeSpaceId } from '../spaces.js';
 import { resolveReadableHomeGraphSpace } from './space-selection.js';
 export async function resetHomeGraphSpace(store, artifactStore, input) {
     await store.init();
@@ -26,12 +26,29 @@ export async function resetHomeGraphSpace(store, artifactStore, input) {
 function collectKnowledgeSpaceArtifactIds(store, artifactStore, spaceId) {
     const normalized = normalizeKnowledgeSpaceId(spaceId);
     const ids = new Set();
+    // Scope-checked deletion (HAZARD H1): the ArtifactStore is shared across the
+    // wiki / home-graph / agent families. A blob that a *different* family owns —
+    // identifiable by its own explicit knowledge-space stamp — must never be deleted
+    // by a home-graph reset, even if a home-graph source references it, because that
+    // would orphan the other family's reference. We err toward preserving: an
+    // artifact is a delete candidate only when it is not explicitly owned by another
+    // space.
+    const ownedByOtherSpace = (artifactId) => {
+        const descriptor = artifactStore.get(artifactId);
+        if (!descriptor)
+            return false;
+        const artifactSpace = getExplicitKnowledgeSpaceId({ metadata: descriptor.metadata });
+        return artifactSpace !== undefined && artifactSpace !== normalized;
+    };
     for (const source of store.listSources(100_000)) {
         if (getKnowledgeSpaceId(source) !== normalized)
             continue;
-        if (typeof source.artifactId === 'string' && source.artifactId.trim().length > 0) {
-            ids.add(source.artifactId.trim());
-        }
+        const artifactId = typeof source.artifactId === 'string' ? source.artifactId.trim() : '';
+        if (artifactId.length === 0)
+            continue;
+        if (ownedByOtherSpace(artifactId))
+            continue;
+        ids.add(artifactId);
     }
     for (const artifact of artifactStore.list(100_000)) {
         if (getKnowledgeSpaceId({ metadata: artifact.metadata }) === normalized)

package/dist/platform/knowledge/home-graph/service.d.ts

@@ -3,7 +3,8 @@ import type { KnowledgeStore } from '../store.js';
 import type { KnowledgeEdgeRecord, KnowledgeIssueRecord, KnowledgeNodeRecord, KnowledgeSourceRecord } from '../types.js';
 import { type HomeGraphReviewResult } from './review.js';
 import type { KnowledgeSemanticService } from '../semantic/index.js';
-import type { HomeGraphAskInput, HomeGraphAskResult, HomeGraphDevicePassportResult, HomeGraphExport, HomeGraphIngestArtifactInput, HomeGraphIngestNoteInput, HomeGraphIngestResult, HomeGraphIngestUrlInput, HomeGraphLinkInput, HomeGraphLinkResult, HomeGraphMapInput, HomeGraphMapResult, HomeGraphProjectionInput, HomeGraphProjectionResult, HomeGraphPageListResult, HomeGraphReindexInput, HomeGraphReindexResult, HomeGraphResetInput, HomeGraphResetResult, HomeGraphReviewInput, HomeGraphSpaceInput, HomeGraphSnapshotInput, HomeGraphStatus, HomeGraphSyncResult } from './types.js';
+import type { HomeGraphTriageOptions } from './triage.js';
+import type { HomeGraphAskInput, HomeGraphAskResult, HomeGraphDevicePassportResult, HomeGraphExport, HomeGraphIngestArtifactInput, HomeGraphIngestNoteInput, HomeGraphIngestResult, HomeGraphIngestUrlInput, HomeGraphLinkInput, HomeGraphLinkResult, HomeGraphUnlinkResult, HomeGraphMapInput, HomeGraphMapResult, HomeGraphProjectionInput, HomeGraphProjectionResult, HomeGraphPageListResult, HomeGraphReindexInput, HomeGraphReindexResult, HomeGraphResetInput, HomeGraphResetResult, HomeGraphReviewInput, HomeGraphSpaceInput, HomeGraphSnapshotInput, HomeGraphStatus, HomeGraphSyncResult } from './types.js';
 export declare class HomeGraphService {
     private readonly store;
     private readonly artifactStore;
@@ -24,7 +25,7 @@ export declare class HomeGraphService {
     ingestNote(input: HomeGraphIngestNoteInput): Promise<HomeGraphIngestResult>;
     ingestArtifact(input: HomeGraphIngestArtifactInput): Promise<HomeGraphIngestResult>;
     linkKnowledge(input: HomeGraphLinkInput): Promise<HomeGraphLinkResult>;
-    unlinkKnowledge(input: HomeGraphLinkInput): Promise<HomeGraphLinkResult>;
+    unlinkKnowledge(input: HomeGraphLinkInput): Promise<HomeGraphUnlinkResult>;
     ask(input: HomeGraphAskInput): Promise<HomeGraphAskResult>;
     reindex(input?: HomeGraphReindexInput): Promise<HomeGraphReindexResult>;
     private repairStaleExtractionsForAsk;
@@ -76,16 +77,14 @@ export declare class HomeGraphService {
         readonly limit?: number | undefined;
         readonly maxRunMs?: number | undefined;
         readonly force?: boolean | undefined;
+        readonly triage?: HomeGraphTriageOptions | boolean | undefined;
+        readonly skipGapRefinement?: boolean | undefined;
     }): Promise<{
-        ok: boolean;
-        spaceId: string;
-        error: string;
-        result?: never;
-    } | {
-        ok: boolean;
-        spaceId: string;
-        result: import("../semantic/types.js").KnowledgeSemanticSelfImproveResult;
-        error?: never;
+        readonly ok: boolean;
+        readonly spaceId: string;
+        readonly error?: string | undefined;
+        readonly result?: Awaited<ReturnType<KnowledgeSemanticService["selfImprove"]>> | undefined;
+        readonly triage?: import("./triage.js").HomeGraphTriageResult | undefined;
     }>;
     cancelRefinementTask(input: HomeGraphSpaceInput & {
         readonly taskId: string;

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

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

package/dist/platform/knowledge/home-graph/triage.d.ts

@@ -0,0 +1,103 @@
+import type { KnowledgeStore } from '../store.js';
+import type { KnowledgeSemanticService } from '../semantic/index.js';
+import type { HomeGraphSpaceInput } from './types.js';
+/**
+ * Default auto-apply threshold for LLM triage decisions, expressed on the SDK's
+ * 0-100 confidence scale. This mirrors the Home Assistant Python triage engine's
+ * `0.85` gate and reuses the same "trust above a threshold" idiom as the semantic
+ * gap-repair `minConfidence` precedent (`knowledge/semantic/gap-repair.ts`).
+ */
+export declare const HOME_GRAPH_TRIAGE_DEFAULT_MIN_CONFIDENCE = 85;
+/** Issues sent to the model per completion call. */
+export declare const HOME_GRAPH_TRIAGE_DEFAULT_CHUNK_SIZE = 25;
+/** Untriaged open issues examined in a single run by default. */
+export declare const HOME_GRAPH_TRIAGE_DEFAULT_LIMIT = 25;
+/**
+ * One entry in the extensible issue-code → applicability-rule framework. Adding a
+ * rule for a new `homegraph.*` issue code makes that code eligible for LLM triage
+ * without touching the loop itself. This replaces the two hardcoded codes the
+ * heuristic layer knows about.
+ */
+export interface HomeGraphTriageRule {
+    /** The issue code this rule governs, e.g. `homegraph.device.unknown_battery`. */
+    readonly code: string;
+    /** Extra model guidance appended to the triage instruction for this code. */
+    readonly promptGuidance?: string | undefined;
+    /** Review category recorded when the model omits one for a reject. */
+    readonly defaultCategory?: string | undefined;
+}
+/**
+ * The built-in rules. These reproduce the applicability judgment the Python triage
+ * prompt asked for, for exactly the two codes `quality.ts` raises today. The
+ * `deriveIssueFacts` mapping in `review.ts` supplies the code-specific facts when a
+ * reject is applied, so rules only carry the prompt guidance and default category.
+ */
+export declare const DEFAULT_HOME_GRAPH_TRIAGE_RULES: readonly HomeGraphTriageRule[];
+export interface HomeGraphTriageOptions {
+    /** Auto-apply threshold on the 0-100 scale. Default 85. */
+    readonly minConfidence?: number | undefined;
+    /** Max untriaged open issues to examine this run. Default 25. */
+    readonly limit?: number | undefined;
+    /** Issues per model completion. Default 25. */
+    readonly chunkSize?: number | undefined;
+    /** Re-triage even issues whose cached fingerprint is unchanged. */
+    readonly force?: boolean | undefined;
+    /** Issue ids to leave untouched this run. */
+    readonly skipIssueIds?: readonly string[] | undefined;
+    /** Restrict triage to this subset of issue codes (must still have a rule). */
+    readonly issueCodes?: readonly string[] | undefined;
+    /** Extra rules merged over the built-ins (by code) — the extensibility hook. */
+    readonly additionalRules?: readonly HomeGraphTriageRule[] | undefined;
+    /** Per-completion model timeout in ms. */
+    readonly timeoutMs?: number | undefined;
+    /** Reviewer label recorded on applied decisions. */
+    readonly reviewer?: string | undefined;
+}
+export interface HomeGraphTriageDecision {
+    readonly issueId: string;
+    readonly code: string;
+    readonly action: 'reject' | 'review';
+    readonly category?: string | undefined;
+    readonly confidence: number;
+    readonly reason?: string | undefined;
+    /** True when the decision cleared the threshold and was auto-applied. */
+    readonly applied: boolean;
+    /** Facts written to the device node when applied. */
+    readonly appliedFacts?: Record<string, unknown> | undefined;
+    /** Provenance tag — always `homegraph-triage`. */
+    readonly source: string;
+}
+export interface HomeGraphTriageResult {
+    readonly ok: true;
+    readonly spaceId: string;
+    /** False when no semantic LLM is configured — the loop is a no-op. */
+    readonly configured: boolean;
+    readonly processed: number;
+    /** Open triageable issues skipped because their cached fingerprint was unchanged. */
+    readonly skipped: number;
+    readonly applied: number;
+    readonly reviewed: number;
+    readonly decisions: readonly HomeGraphTriageDecision[];
+    /** Open triageable issues still unresolved after this run. */
+    readonly remaining: number;
+    readonly minConfidence: number;
+    readonly reason?: string | undefined;
+}
+/**
+ * LLM-driven triage over open Home Graph device-quality issues. Operates strictly
+ * on the resolved Home Assistant knowledge space: it reads that space's issues and
+ * nodes, prompts the configured semantic LLM to classify each open issue as
+ * `reject` (safe to auto-dismiss) or `review` (needs a human), auto-applies rejects
+ * at or above the confidence threshold via {@link reviewHomeGraphFact}, and caches
+ * every decision on the issue so an unchanged issue is never re-sent to the model.
+ *
+ * This never reads or writes any other knowledge space — Home Graph shares this
+ * code with the wiki/agent knowledge functions but never their data.
+ */
+export declare function runHomeGraphIssueTriage(input: HomeGraphSpaceInput & {
+    readonly store: KnowledgeStore;
+    readonly semanticService?: KnowledgeSemanticService | undefined;
+    readonly options?: HomeGraphTriageOptions | undefined;
+    readonly signal?: AbortSignal | undefined;
+}): Promise<HomeGraphTriageResult>;
+//# sourceMappingURL=triage.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"triage.d.ts","sourceRoot":"","sources":["../../../../src/platform/knowledge/home-graph/triage.ts"],"names":[],"mappings":"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"}