@pellux/goodvibes-sdk 1.2.0 → 1.3.1

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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"}

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

@@ -0,0 +1,362 @@
+import { yieldEvery } from '../cooperative.js';
+import { readRecord, readString, stableHash } from './helpers.js';
+import { readHomeGraphState } from './state.js';
+import { reviewHomeGraphFact } from './review.js';
+import { resolveReadableHomeGraphSpace } from './space-selection.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 const HOME_GRAPH_TRIAGE_DEFAULT_MIN_CONFIDENCE = 85;
+/** Issues sent to the model per completion call. */
+export const HOME_GRAPH_TRIAGE_DEFAULT_CHUNK_SIZE = 25;
+/** Untriaged open issues examined in a single run by default. */
+export const HOME_GRAPH_TRIAGE_DEFAULT_LIMIT = 25;
+/** Ceiling on how many open issues are scanned before limit/skip filtering. */
+const TRIAGE_ISSUE_SCAN_LIMIT = 1_000;
+/** Issue-metadata key under which a triage decision + fingerprint is cached. */
+const TRIAGE_METADATA_KEY = 'triage';
+/** Provenance tag stamped on every triage decision and review value. */
+const TRIAGE_SOURCE = 'homegraph-triage';
+/**
+ * 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 const DEFAULT_HOME_GRAPH_TRIAGE_RULES = [
+    {
+        code: 'homegraph.device.unknown_battery',
+        defaultCategory: 'not_applicable',
+        promptGuidance: [
+            'For unknown battery type issues: reject software objects, integrations, automations,',
+            'scripts, scenes, areas, helpers, the sun, weather, Home Assistant host/core/supervisor',
+            'objects, servers, adapters, hubs, coordinators, bridges, and mains-powered media devices',
+            'or appliances. Include fact {"batteryPowered":false,"batteryType":"none"} for those',
+            'not-applicable rejects. Review sensors, locks, remotes, buttons, keypads, contact sensors,',
+            'motion sensors, leak sensors, smoke detectors, thermostats, shades, blinds, and any',
+            'ambiguous physical device that could plausibly be battery powered.',
+        ].join(' '),
+    },
+    {
+        code: 'homegraph.device.missing_manual',
+        defaultCategory: 'not_applicable',
+        promptGuidance: [
+            'For missing manual issues that are not applicable to software, helpers, or generated Home',
+            'Assistant objects, include fact {"manualRequired":false}.',
+        ].join(' '),
+    },
+];
+/**
+ * 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 async function runHomeGraphIssueTriage(input) {
+    await input.store.init();
+    const { spaceId, installationId } = resolveReadableHomeGraphSpace(input.store, input);
+    const options = input.options ?? {};
+    const minConfidence = clampConfidence(options.minConfidence ?? HOME_GRAPH_TRIAGE_DEFAULT_MIN_CONFIDENCE);
+    const llm = input.semanticService?.llm ?? null;
+    const rulesByCode = mergeTriageRules(options.additionalRules);
+    const codeFilter = options.issueCodes ? new Set(options.issueCodes) : null;
+    const state = readHomeGraphState(input.store, spaceId);
+    const nodeById = new Map(state.nodes.map((node) => [node.id, node]));
+    const openTriageable = state.issues.filter((issue) => (issue.status === 'open'
+        && rulesByCode.has(issue.code)
+        && (!codeFilter || codeFilter.has(issue.code))));
+    if (!llm) {
+        return emptyResult(spaceId, minConfidence, openTriageable.length, false, 'triage-llm-not-configured');
+    }
+    const skipIssueIds = new Set(options.skipIssueIds ?? []);
+    const scannable = openTriageable.slice(0, TRIAGE_ISSUE_SCAN_LIMIT);
+    let cacheSkipped = 0;
+    const candidates = [];
+    for (const issue of scannable) {
+        if (skipIssueIds.has(issue.id))
+            continue;
+        const node = issue.nodeId ? nodeById.get(issue.nodeId) : undefined;
+        if (!options.force && isCachedTriage(issue, node)) {
+            cacheSkipped += 1;
+            continue;
+        }
+        candidates.push(issue);
+    }
+    const limit = Math.max(1, options.limit ?? HOME_GRAPH_TRIAGE_DEFAULT_LIMIT);
+    const selected = candidates.slice(0, limit);
+    if (selected.length === 0) {
+        const reason = cacheSkipped > 0 ? 'no-untriaged-open-issues' : 'no-open-issues';
+        return emptyResult(spaceId, minConfidence, openTriageable.length, true, reason, cacheSkipped);
+    }
+    const records = selected.map((issue) => buildTriageRecord(issue, issue.nodeId ? nodeById.get(issue.nodeId) : undefined));
+    const chunkSize = Math.max(1, options.chunkSize ?? HOME_GRAPH_TRIAGE_DEFAULT_CHUNK_SIZE);
+    const decisionByIssueId = new Map();
+    for (let index = 0; index < records.length; index += chunkSize) {
+        if (input.signal?.aborted)
+            break;
+        const chunk = records.slice(index, index + chunkSize);
+        const response = await llm.completeJson({
+            purpose: 'homegraph-issue-triage',
+            maxTokens: 2_000,
+            systemPrompt: buildTriageSystemPrompt(rulesByCode, chunk),
+            prompt: JSON.stringify({ issues: chunk }),
+            ...(options.timeoutMs !== undefined ? { timeoutMs: options.timeoutMs } : {}),
+            ...(input.signal ? { signal: input.signal } : {}),
+        });
+        for (const decision of parseTriageDecisions(response)) {
+            decisionByIssueId.set(decision.issueId, decision);
+        }
+        await yieldEvery(index, chunkSize);
+    }
+    const issueById = new Map(selected.map((issue) => [issue.id, issue]));
+    const decisions = [];
+    let appliedCount = 0;
+    for (const issue of selected) {
+        const parsed = decisionByIssueId.get(issue.id);
+        if (!parsed)
+            continue;
+        const rule = rulesByCode.get(issue.code);
+        const category = parsed.category ?? rule?.defaultCategory;
+        const shouldApply = parsed.action === 'reject' && parsed.confidence >= minConfidence;
+        let appliedFacts;
+        if (shouldApply) {
+            const review = await reviewHomeGraphFact(input.store, spaceId, installationId, {
+                knowledgeSpaceId: spaceId,
+                issueId: issue.id,
+                action: 'reject',
+                reviewer: options.reviewer ?? `${TRIAGE_SOURCE}:auto`,
+                value: buildReviewValue(category, parsed, rule),
+            });
+            appliedFacts = review.appliedFacts;
+            appliedCount += 1;
+        }
+        const decision = {
+            issueId: issue.id,
+            code: issue.code,
+            action: parsed.action,
+            ...(category ? { category } : {}),
+            confidence: parsed.confidence,
+            ...(parsed.reason ? { reason: parsed.reason } : {}),
+            applied: shouldApply,
+            ...(appliedFacts && Object.keys(appliedFacts).length > 0 ? { appliedFacts } : {}),
+            source: TRIAGE_SOURCE,
+        };
+        decisions.push(decision);
+        await recordTriageDecision(input.store, issue.id, issueById.get(issue.id) ?? issue, decision, nodeById);
+    }
+    const remaining = countOpenTriageable(input.store, spaceId, rulesByCode, codeFilter);
+    return {
+        ok: true,
+        spaceId,
+        configured: true,
+        processed: selected.length,
+        skipped: cacheSkipped,
+        applied: appliedCount,
+        reviewed: decisions.length - appliedCount,
+        decisions,
+        remaining,
+        minConfidence,
+    };
+}
+function emptyResult(spaceId, minConfidence, remaining, configured, reason, skipped = 0) {
+    return {
+        ok: true,
+        spaceId,
+        configured,
+        processed: 0,
+        skipped,
+        applied: 0,
+        reviewed: 0,
+        decisions: [],
+        remaining,
+        minConfidence,
+        reason,
+    };
+}
+function mergeTriageRules(additional) {
+    const byCode = new Map();
+    for (const rule of DEFAULT_HOME_GRAPH_TRIAGE_RULES)
+        byCode.set(rule.code, rule);
+    for (const rule of additional ?? []) {
+        if (typeof rule?.code === 'string' && rule.code.trim())
+            byCode.set(rule.code, rule);
+    }
+    return byCode;
+}
+function buildTriageRecord(issue, node) {
+    const record = {
+        issueId: issue.id,
+        code: issue.code,
+        severity: issue.severity,
+        status: issue.status,
+        message: issue.message,
+        ...(issue.nodeId ? { nodeId: issue.nodeId } : {}),
+        ...(issue.sourceId ? { sourceId: issue.sourceId } : {}),
+    };
+    if (!node)
+        return record;
+    const homeAssistant = readRecord(node.metadata.homeAssistant);
+    const nodeSummary = pruneEmpty({
+        id: node.id,
+        kind: node.kind,
+        title: node.title,
+        summary: node.summary,
+        aliases: node.aliases.slice(0, 8),
+        confidence: node.confidence,
+        manufacturer: readString(node.metadata.manufacturer),
+        model: readString(node.metadata.model),
+        homeAssistant: pruneEmpty({
+            objectKind: readString(homeAssistant.objectKind),
+            objectId: readString(homeAssistant.objectId),
+            entityId: readString(homeAssistant.entityId),
+            deviceId: readString(homeAssistant.deviceId),
+            areaId: readString(homeAssistant.areaId),
+            integrationId: readString(homeAssistant.integrationId),
+        }),
+    });
+    return { ...record, node: nodeSummary };
+}
+function buildTriageSystemPrompt(rulesByCode, records) {
+    const activeCodes = new Set(records.map((record) => record.code));
+    const guidance = [...rulesByCode.values()]
+        .filter((rule) => activeCodes.has(rule.code))
+        .map((rule) => rule.promptGuidance)
+        .filter((line) => Boolean(line));
+    return [
+        'You are GoodVibes Home Graph review triage for Home Assistant.',
+        'Classify each issue so people only review uncertain cases.',
+        'Return only strict JSON with this shape:',
+        '{"decisions":[{"issueId":"...","action":"reject|review","category":"...","confidence":0,"reason":"...","fact":{}}]}.',
+        'Echo the issueId exactly as supplied. confidence is a number from 0 to 100.',
+        'Use action reject only when the issue is clearly not applicable or incorrect and can be safely',
+        'dismissed. Use action review for anything uncertain, anything that may require household',
+        'knowledge, or any physical device that could plausibly be affected.',
+        ...guidance,
+        'Do not invent facts. Do not choose accept, resolve, edit, or forget.',
+    ].join('\n');
+}
+function parseTriageDecisions(value) {
+    const record = readRecord(value);
+    const raw = Array.isArray(record.decisions) ? record.decisions : Array.isArray(value) ? value : [];
+    const parsed = [];
+    for (const entry of raw) {
+        const decision = readRecord(entry);
+        const issueId = readString(decision.issueId) ?? readString(decision.id);
+        if (!issueId)
+            continue;
+        const action = readString(decision.action)?.toLowerCase() === 'reject' ? 'reject' : 'review';
+        const fact = readRecord(decision.fact);
+        parsed.push({
+            issueId,
+            action,
+            ...(readString(decision.category) ? { category: normalizeCategory(readString(decision.category)) } : {}),
+            confidence: normalizeConfidence(decision.confidence),
+            ...(readString(decision.reason) ? { reason: readString(decision.reason) } : {}),
+            ...(Object.keys(fact).length > 0 ? { fact } : {}),
+        });
+    }
+    return parsed;
+}
+function buildReviewValue(category, parsed, rule) {
+    const value = {
+        category: category ?? rule?.defaultCategory ?? 'not_applicable',
+        confidence: parsed.confidence,
+        reason: parsed.reason ?? 'LLM triage classified this issue as not applicable.',
+        source: TRIAGE_SOURCE,
+    };
+    if (parsed.fact && Object.keys(parsed.fact).length > 0)
+        value.fact = parsed.fact;
+    return value;
+}
+async function recordTriageDecision(store, issueId, fallback, decision, nodeById) {
+    // Re-read so an applied reject (which resolved the issue via reviewFact) keeps
+    // its fresh status/metadata; upsertIssue shallow-merges metadata, preserving it.
+    const current = store.getIssue(issueId) ?? fallback;
+    const node = current.nodeId ? nodeById.get(current.nodeId) : undefined;
+    await store.upsertIssue({
+        id: current.id,
+        severity: current.severity,
+        code: current.code,
+        message: current.message,
+        status: current.status,
+        ...(current.sourceId ? { sourceId: current.sourceId } : {}),
+        ...(current.nodeId ? { nodeId: current.nodeId } : {}),
+        metadata: {
+            ...current.metadata,
+            [TRIAGE_METADATA_KEY]: {
+                fingerprint: triageFingerprint(current, node),
+                action: decision.action,
+                ...(decision.category ? { category: decision.category } : {}),
+                confidence: decision.confidence,
+                ...(decision.reason ? { reason: decision.reason } : {}),
+                applied: decision.applied,
+                source: TRIAGE_SOURCE,
+                decidedAt: Date.now(),
+            },
+        },
+    });
+}
+function isCachedTriage(issue, node) {
+    const cached = readRecord(issue.metadata[TRIAGE_METADATA_KEY]);
+    const fingerprint = readString(cached.fingerprint);
+    if (!fingerprint)
+        return false;
+    return fingerprint === triageFingerprint(issue, node);
+}
+function triageFingerprint(issue, node) {
+    const homeAssistant = node ? readRecord(node.metadata.homeAssistant) : {};
+    return stableHash(JSON.stringify({
+        code: issue.code,
+        severity: issue.severity,
+        message: issue.message,
+        nodeId: issue.nodeId ?? null,
+        sourceId: issue.sourceId ?? null,
+        title: node?.title ?? null,
+        confidence: node?.confidence ?? null,
+        manufacturer: node ? readString(node.metadata.manufacturer) ?? null : null,
+        model: node ? readString(node.metadata.model) ?? null : null,
+        objectKind: readString(homeAssistant.objectKind) ?? null,
+        entityId: readString(homeAssistant.entityId) ?? null,
+        deviceId: readString(homeAssistant.deviceId) ?? null,
+    }));
+}
+function countOpenTriageable(store, spaceId, rulesByCode, codeFilter) {
+    return readHomeGraphState(store, spaceId).issues.filter((issue) => (issue.status === 'open'
+        && rulesByCode.has(issue.code)
+        && (!codeFilter || codeFilter.has(issue.code)))).length;
+}
+function normalizeConfidence(value) {
+    const parsed = typeof value === 'number' ? value : typeof value === 'string' ? Number(value) : NaN;
+    if (!Number.isFinite(parsed))
+        return 0;
+    // Accept both the 0-1 fraction the Python engine used and the 0-100 SDK scale.
+    const scaled = parsed > 0 && parsed <= 1 ? parsed * 100 : parsed;
+    return clampConfidence(scaled);
+}
+function clampConfidence(value) {
+    return Math.max(0, Math.min(100, Math.round(value)));
+}
+function normalizeCategory(value) {
+    return value.trim().toLowerCase().replace(/[-\s]+/g, '_');
+}
+function pruneEmpty(record) {
+    const result = {};
+    for (const [key, value] of Object.entries(record)) {
+        if (value === undefined || value === null || value === '')
+            continue;
+        if (Array.isArray(value) && value.length === 0)
+            continue;
+        if (typeof value === 'object' && !Array.isArray(value) && Object.keys(value).length === 0)
+            continue;
+        result[key] = value;
+    }
+    return result;
+}

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

@@ -161,6 +161,21 @@ export interface HomeGraphLinkResult {
     readonly edge: KnowledgeEdgeRecord;
     readonly target: KnowledgeNodeRecord | KnowledgeSourceRecord | null;
 }
+/**
+ * Result of an unlink. Unlink is a real reversal: it removes the link edge (and,
+ * if the prior link materialized the target node and nothing else references it,
+ * that node too). Unlinking a never-linked target is an honest no-op — it creates
+ * no phantom records. `reversed` is true only when an active link was actually
+ * removed.
+ */
+export interface HomeGraphUnlinkResult {
+    readonly ok: true;
+    readonly spaceId: string;
+    readonly reversed: boolean;
+    readonly removedEdgeId?: string | undefined;
+    readonly removedNodeId?: string | undefined;
+    readonly target: KnowledgeNodeRecord | KnowledgeSourceRecord | null;
+}
 export interface HomeGraphAskInput extends HomeGraphSpaceInput {
     readonly query: string;
     readonly limit?: number | undefined;