@pellux/goodvibes-sdk 0.27.12 → 0.28.0

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

@@ -12,6 +12,7 @@ import { ingestKnowledgeArtifact, ingestKnowledgeBookmarkSeeds, ingestKnowledgeC
 import { decideKnowledgeConsolidationCandidate, runKnowledgeConsolidation, } from './consolidation.js';
 import { reviewKnowledgeIssue, } from './review.js';
 import { KnowledgeScheduleService } from './scheduling.js';
+import { runKnowledgeServiceJobByKind } from './service-jobs.js';
 import { lintKnowledgeStore } from './lint.js';
 import { syncKnowledgeMemoryNodes } from './memory-sync.js';
 import { emitKnowledgeExtractionCompleted, emitKnowledgeExtractionFailed, emitKnowledgeIngestCompleted, emitKnowledgeIngestFailed, emitKnowledgeIngestStarted, emitKnowledgePacketBuilt, emitKnowledgeProjectionMaterialized, emitKnowledgeProjectionRendered, } from '../runtime/emitters/index.js';
@@ -377,79 +378,61 @@ export class KnowledgeService {
     listJobRuns(limit = 100, jobId) {
         return this.scheduleService.listJobRuns(limit, jobId);
     }
+    listRefinementTasks(limit = 100, input = {}) {
+        return this.store.listRefinementTasks(limit, input);
+    }
+    getRefinementTask(id) {
+        return this.store.getRefinementTask(id);
+    }
+    async cancelRefinementTask(id) {
+        const task = this.store.getRefinementTask(id);
+        if (!task)
+            return null;
+        return this.store.upsertRefinementTask({
+            id: task.id,
+            spaceId: task.spaceId,
+            subjectKind: task.subjectKind,
+            subjectId: task.subjectId,
+            subjectTitle: task.subjectTitle,
+            subjectType: task.subjectType,
+            gapId: task.gapId,
+            issueId: task.issueId,
+            state: 'cancelled',
+            priority: task.priority,
+            trigger: task.trigger,
+            budget: task.budget,
+            attemptCount: task.attemptCount,
+            appendTrace: [{
+                    at: Date.now(),
+                    state: 'cancelled',
+                    message: 'Refinement task was cancelled by request.',
+                }],
+            metadata: task.metadata,
+        });
+    }
+    async runRefinement(input = {}) {
+        return this.semanticService.selfImprove({
+            knowledgeSpaceId: input.knowledgeSpaceId,
+            gapIds: input.gapIds,
+            sourceIds: input.sourceIds,
+            limit: input.limit,
+            force: input.force,
+            reason: 'manual',
+        });
+    }
     async runJob(id, input = {}) {
         return this.scheduleService.runJob(id, input);
     }
     async runJobByKind(kind, input) {
-        switch (kind) {
-            case 'lint': {
-                const issues = await lintKnowledgeStore({ store: this.store, emitIfReady: this.emitIfReady.bind(this) });
-                return { issueCount: issues.length };
-            }
-            case 'reindex': {
-                const result = await this.reindex();
-                return { sourceCount: result.status.sourceCount, issueCount: result.issues.length };
-            }
-            case 'refresh-stale': {
-                const refreshed = await refreshKnowledgeSources(this.getIngestContext(), pickKnowledgeRefreshCandidates({ store: this.store }, 'stale', input.sourceIds, input.limit));
-                return { refreshed };
-            }
-            case 'refresh-bookmarks': {
-                const refreshed = await refreshKnowledgeSources(this.getIngestContext(), pickKnowledgeRefreshCandidates({ store: this.store }, 'bookmark', input.sourceIds, input.limit));
-                return { refreshed };
-            }
-            case 'sync-browser-history': {
-                const result = await this.syncBrowserHistory({
-                    limit: input.limit,
-                });
-                return {
-                    imported: result.imported,
-                    failed: result.failed,
-                    profileCount: result.profiles.length,
-                    errorCount: result.errors.length,
-                };
-            }
-            case 'rebuild-projections': {
-                const overview = await this.materializeProjection({ kind: 'overview', limit: Math.max(8, input.limit ?? 12) });
-                const bundle = await this.materializeProjection({ kind: 'bundle', limit: Math.max(12, input.limit ?? 18) });
-                return {
-                    projections: [
-                        { targetId: overview.bundle.target.targetId, artifactId: overview.artifact.id },
-                        { targetId: bundle.bundle.target.targetId, artifactId: bundle.artifact.id },
-                    ],
-                };
-            }
-            case 'semantic-enrichment': {
-                return this.semanticService.reindex({
-                    sourceIds: input.sourceIds,
-                    limit: input.limit,
-                });
-            }
-            case 'semantic-self-improvement': {
-                const result = await this.semanticService.selfImprove({
-                    sourceIds: input.sourceIds,
-                    limit: input.limit,
-                    reason: 'scheduled',
-                });
-                return { ...result };
-            }
-            case 'light-consolidation': {
-                const report = await runKnowledgeConsolidation(this.getConsolidationContext(), 'light-consolidation', {
-                    limit: input.limit,
-                    autoPromote: false,
-                });
-                return { reportId: report.id, metrics: report.metrics };
-            }
-            case 'deep-consolidation': {
-                const report = await runKnowledgeConsolidation(this.getConsolidationContext(), 'deep-consolidation', {
-                    limit: input.limit,
-                    autoPromote: true,
-                });
-                return { reportId: report.id, metrics: report.metrics };
-            }
-            default:
-                return {};
-        }
+        return runKnowledgeServiceJobByKind(kind, input, {
+            lint: () => lintKnowledgeStore({ store: this.store, emitIfReady: this.emitIfReady.bind(this) }),
+            reindex: () => this.reindex(),
+            refreshSources: async (refreshKind, sourceIds, limit) => refreshKnowledgeSources(this.getIngestContext(), pickKnowledgeRefreshCandidates({ store: this.store }, refreshKind, sourceIds, limit)),
+            syncBrowserHistory: (options) => this.syncBrowserHistory(options),
+            materializeProjection: (options) => this.materializeProjection(options),
+            semanticService: this.semanticService,
+            runConsolidation: (jobKind, options) => runKnowledgeConsolidation(this.getConsolidationContext(), jobKind, options),
+        });
     }
     deferUsage(input) {
         queueMicrotask(() => {

package/dist/_internal/platform/knowledge/store-config.d.ts

@@ -0,0 +1,8 @@
+export interface KnowledgeStoreConfig {
+    readonly dbPath?: string;
+    readonly configManager?: {
+        getControlPlaneConfigDir?: () => string;
+    };
+}
+export declare function resolveKnowledgeDbPath(config: KnowledgeStoreConfig): string;
+//# sourceMappingURL=store-config.d.ts.map

package/dist/_internal/platform/knowledge/store-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"store-config.d.ts","sourceRoot":"","sources":["../../../../src/_internal/platform/knowledge/store-config.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,aAAa,CAAC,EAAE;QACvB,wBAAwB,CAAC,EAAE,MAAM,MAAM,CAAC;KACzC,CAAC;CACH;AAED,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,oBAAoB,GAAG,MAAM,CAO3E"}

package/dist/_internal/platform/knowledge/store-config.js

@@ -0,0 +1,10 @@
+import { resolveKnowledgeDbPathFromControlPlaneDir } from './store-schema.js';
+export function resolveKnowledgeDbPath(config) {
+    const controlPlaneDir = typeof config.configManager?.getControlPlaneConfigDir === 'function'
+        ? config.configManager.getControlPlaneConfigDir()
+        : undefined;
+    const dbPath = config.dbPath ?? (controlPlaneDir ? resolveKnowledgeDbPathFromControlPlaneDir(controlPlaneDir) : undefined);
+    if (!dbPath)
+        throw new Error('KnowledgeStore requires an explicit dbPath or configManager.getControlPlaneConfigDir().');
+    return dbPath;
+}

package/dist/_internal/platform/knowledge/store-load.d.ts

@@ -1,5 +1,5 @@
 import type { SQLiteStore } from '../state/sqlite-store.js';
-import type { KnowledgeConsolidationCandidateRecord, KnowledgeConsolidationReportRecord, KnowledgeEdgeRecord, KnowledgeExtractionRecord, KnowledgeIssueRecord, KnowledgeJobRunRecord, KnowledgeNodeRecord, KnowledgeScheduleRecord, KnowledgeSourceRecord, KnowledgeUsageRecord } from './types.js';
+import type { KnowledgeConsolidationCandidateRecord, KnowledgeConsolidationReportRecord, KnowledgeEdgeRecord, KnowledgeExtractionRecord, KnowledgeIssueRecord, KnowledgeJobRunRecord, KnowledgeNodeRecord, KnowledgeRefinementTaskRecord, KnowledgeScheduleRecord, KnowledgeSourceRecord, KnowledgeUsageRecord } from './types.js';
 export interface KnowledgeStoreSnapshot {
     readonly sources: KnowledgeSourceRecord[];
     readonly nodes: KnowledgeNodeRecord[];
@@ -7,6 +7,7 @@ export interface KnowledgeStoreSnapshot {
     readonly issues: KnowledgeIssueRecord[];
     readonly extractions: KnowledgeExtractionRecord[];
     readonly jobRuns: KnowledgeJobRunRecord[];
+    readonly refinementTasks: KnowledgeRefinementTaskRecord[];
     readonly usageRecords: KnowledgeUsageRecord[];
     readonly consolidationCandidates: KnowledgeConsolidationCandidateRecord[];
     readonly consolidationReports: KnowledgeConsolidationReportRecord[];

package/dist/_internal/platform/knowledge/store-load.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"store-load.d.ts","sourceRoot":"","sources":["../../../../src/_internal/platform/knowledge/store-load.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAa5D,OAAO,KAAK,EACV,qCAAqC,EACrC,kCAAkC,EAClC,mBAAmB,EACnB,yBAAyB,EACzB,oBAAoB,EACpB,qBAAqB,EACrB,mBAAmB,EACnB,uBAAuB,EACvB,qBAAqB,EACrB,oBAAoB,EACrB,MAAM,YAAY,CAAC;AAEpB,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,OAAO,EAAE,qBAAqB,EAAE,CAAC;IAC1C,QAAQ,CAAC,KAAK,EAAE,mBAAmB,EAAE,CAAC;IACtC,QAAQ,CAAC,KAAK,EAAE,mBAAmB,EAAE,CAAC;IACtC,QAAQ,CAAC,MAAM,EAAE,oBAAoB,EAAE,CAAC;IACxC,QAAQ,CAAC,WAAW,EAAE,yBAAyB,EAAE,CAAC;IAClD,QAAQ,CAAC,OAAO,EAAE,qBAAqB,EAAE,CAAC;IAC1C,QAAQ,CAAC,YAAY,EAAE,oBAAoB,EAAE,CAAC;IAC9C,QAAQ,CAAC,uBAAuB,EAAE,qCAAqC,EAAE,CAAC;IAC1E,QAAQ,CAAC,oBAAoB,EAAE,kCAAkC,EAAE,CAAC;IACpE,QAAQ,CAAC,SAAS,EAAE,uBAAuB,EAAE,CAAC;CAC/C;AAQD,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,WAAW,GAAG,sBAAsB,CAatF"}
+{"version":3,"file":"store-load.d.ts","sourceRoot":"","sources":["../../../../src/_internal/platform/knowledge/store-load.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAc5D,OAAO,KAAK,EACV,qCAAqC,EACrC,kCAAkC,EAClC,mBAAmB,EACnB,yBAAyB,EACzB,oBAAoB,EACpB,qBAAqB,EACrB,mBAAmB,EACnB,6BAA6B,EAC7B,uBAAuB,EACvB,qBAAqB,EACrB,oBAAoB,EACrB,MAAM,YAAY,CAAC;AAEpB,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,OAAO,EAAE,qBAAqB,EAAE,CAAC;IAC1C,QAAQ,CAAC,KAAK,EAAE,mBAAmB,EAAE,CAAC;IACtC,QAAQ,CAAC,KAAK,EAAE,mBAAmB,EAAE,CAAC;IACtC,QAAQ,CAAC,MAAM,EAAE,oBAAoB,EAAE,CAAC;IACxC,QAAQ,CAAC,WAAW,EAAE,yBAAyB,EAAE,CAAC;IAClD,QAAQ,CAAC,OAAO,EAAE,qBAAqB,EAAE,CAAC;IAC1C,QAAQ,CAAC,eAAe,EAAE,6BAA6B,EAAE,CAAC;IAC1D,QAAQ,CAAC,YAAY,EAAE,oBAAoB,EAAE,CAAC;IAC9C,QAAQ,CAAC,uBAAuB,EAAE,qCAAqC,EAAE,CAAC;IAC1E,QAAQ,CAAC,oBAAoB,EAAE,kCAAkC,EAAE,CAAC;IACpE,QAAQ,CAAC,SAAS,EAAE,uBAAuB,EAAE,CAAC;CAC/C;AAQD,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,WAAW,GAAG,sBAAsB,CActF"}

package/dist/_internal/platform/knowledge/store-load.js

@@ -1,4 +1,4 @@
-import { mapCandidateRow, mapEdgeRow, mapExtractionRow, mapIssueRow, mapJobRunRow, mapNodeRow, mapReportRow, mapScheduleRow, mapSourceRow, mapUsageRow, } from './store-schema.js';
+import { mapCandidateRow, mapEdgeRow, mapExtractionRow, mapIssueRow, mapJobRunRow, mapNodeRow, mapRefinementTaskRow, mapReportRow, mapScheduleRow, mapSourceRow, mapUsageRow, } from './store-schema.js';
 function loadRows(sqlite, sql, mapRow) {
     const rows = sqlite.exec(sql);
     if (!rows.length)
@@ -13,6 +13,7 @@ export function loadKnowledgeStoreSnapshot(sqlite) {
         issues: loadRows(sqlite, 'SELECT * FROM knowledge_issues', mapIssueRow),
         extractions: loadRows(sqlite, 'SELECT * FROM knowledge_extractions', mapExtractionRow),
         jobRuns: loadRows(sqlite, 'SELECT * FROM knowledge_job_runs', mapJobRunRow),
+        refinementTasks: loadRows(sqlite, 'SELECT * FROM knowledge_refinement_tasks', mapRefinementTaskRow),
         usageRecords: loadRows(sqlite, 'SELECT * FROM knowledge_usage_records', mapUsageRow),
         consolidationCandidates: loadRows(sqlite, 'SELECT * FROM knowledge_consolidation_candidates', mapCandidateRow),
         consolidationReports: loadRows(sqlite, 'SELECT * FROM knowledge_consolidation_reports', mapReportRow),

package/dist/_internal/platform/knowledge/store-read.d.ts

@@ -1,4 +1,4 @@
-import type { KnowledgeEdgeRecord, KnowledgeItemView, KnowledgeIssueRecord, KnowledgeJobRunRecord, KnowledgeNodeRecord, KnowledgeScheduleRecord, KnowledgeSourceRecord, KnowledgeStatus, KnowledgeUsageRecord, KnowledgeConsolidationCandidateRecord, KnowledgeConsolidationReportRecord, KnowledgeExtractionRecord } from './types.js';
+import type { KnowledgeEdgeRecord, KnowledgeItemView, KnowledgeIssueRecord, KnowledgeJobRunRecord, KnowledgeRefinementTaskRecord, KnowledgeNodeRecord, KnowledgeScheduleRecord, KnowledgeSourceRecord, KnowledgeStatus, KnowledgeUsageRecord, KnowledgeConsolidationCandidateRecord, KnowledgeConsolidationReportRecord, KnowledgeExtractionRecord } from './types.js';
 export interface KnowledgeStoreReadView {
     readonly ready: boolean;
     readonly dbPath: string;
@@ -8,6 +8,7 @@ export interface KnowledgeStoreReadView {
     readonly issues: Map<string, KnowledgeIssueRecord>;
     readonly extractions: Map<string, KnowledgeExtractionRecord>;
     readonly jobRuns: Map<string, KnowledgeJobRunRecord>;
+    readonly refinementTasks: Map<string, KnowledgeRefinementTaskRecord>;
     readonly usageRecords: Map<string, KnowledgeUsageRecord>;
     readonly consolidationCandidates: Map<string, KnowledgeConsolidationCandidateRecord>;
     readonly consolidationReports: Map<string, KnowledgeConsolidationReportRecord>;
@@ -20,6 +21,13 @@ export declare function listKnowledgeEdges(view: KnowledgeStoreReadView): Knowle
 export declare function listKnowledgeIssues(view: KnowledgeStoreReadView, limit?: number): KnowledgeIssueRecord[];
 export declare function listKnowledgeExtractions(view: KnowledgeStoreReadView, limit?: number): KnowledgeExtractionRecord[];
 export declare function listKnowledgeJobRuns(view: KnowledgeStoreReadView, limit?: number, jobId?: string): KnowledgeJobRunRecord[];
+export declare function listKnowledgeRefinementTasks(view: KnowledgeStoreReadView, limit?: number, input?: {
+    readonly spaceId?: string;
+    readonly state?: string;
+    readonly subjectKind?: string;
+    readonly subjectId?: string;
+    readonly gapId?: string;
+}): KnowledgeRefinementTaskRecord[];
 export declare function listKnowledgeUsageRecords(view: KnowledgeStoreReadView, limit?: number, input?: {
     readonly targetKind?: KnowledgeUsageRecord['targetKind'];
     readonly targetId?: string;
@@ -38,6 +46,7 @@ export declare function getKnowledgeIssue(view: KnowledgeStoreReadView, id: stri
 export declare function getKnowledgeExtraction(view: KnowledgeStoreReadView, id: string): KnowledgeExtractionRecord | null;
 export declare function getKnowledgeExtractionBySourceId(view: KnowledgeStoreReadView, sourceId: string): KnowledgeExtractionRecord | null;
 export declare function getKnowledgeJobRun(view: KnowledgeStoreReadView, id: string): KnowledgeJobRunRecord | null;
+export declare function getKnowledgeRefinementTask(view: KnowledgeStoreReadView, id: string): KnowledgeRefinementTaskRecord | null;
 export declare function getKnowledgeUsageRecord(view: KnowledgeStoreReadView, id: string): KnowledgeUsageRecord | null;
 export declare function getKnowledgeConsolidationCandidate(view: KnowledgeStoreReadView, id: string): KnowledgeConsolidationCandidateRecord | null;
 export declare function getKnowledgeConsolidationCandidateBySubject(view: KnowledgeStoreReadView, subjectKind: KnowledgeConsolidationCandidateRecord['subjectKind'], subjectId: string, candidateType: KnowledgeConsolidationCandidateRecord['candidateType']): KnowledgeConsolidationCandidateRecord | null;

package/dist/_internal/platform/knowledge/store-read.d.ts.map

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

package/dist/_internal/platform/knowledge/store-read.js

@@ -23,6 +23,7 @@ export function getKnowledgeStoreStatus(view) {
         issueCount: view.issues.size,
         extractionCount: view.extractions.size,
         jobRunCount: view.jobRuns.size,
+        refinementTaskCount: view.refinementTasks.size,
         usageCount: view.usageRecords.size,
         candidateCount: view.consolidationCandidates.size,
         reportCount: view.consolidationReports.size,
@@ -58,6 +59,16 @@ export function listKnowledgeJobRuns(view, limit = 100, jobId) {
         .sort(byRequestedAtDesc)
         .slice(0, sliceLimit(limit));
 }
+export function listKnowledgeRefinementTasks(view, limit = 100, input = {}) {
+    return [...view.refinementTasks.values()]
+        .filter((task) => ((!input.spaceId || task.spaceId === input.spaceId)
+        && (!input.state || task.state === input.state)
+        && (!input.subjectKind || task.subjectKind === input.subjectKind)
+        && (!input.subjectId || task.subjectId === input.subjectId)
+        && (!input.gapId || task.gapId === input.gapId)))
+        .sort(byUpdatedAtDesc)
+        .slice(0, sliceLimit(limit));
+}
 export function listKnowledgeUsageRecords(view, limit = 100, input = {}) {
     return [...view.usageRecords.values()]
         .filter((record) => ((!input.targetKind || record.targetKind === input.targetKind)
@@ -106,6 +117,9 @@ export function getKnowledgeExtractionBySourceId(view, sourceId) {
 export function getKnowledgeJobRun(view, id) {
     return view.jobRuns.get(id) ?? null;
 }
+export function getKnowledgeRefinementTask(view, id) {
+    return view.refinementTasks.get(id) ?? null;
+}
 export function getKnowledgeUsageRecord(view, id) {
     return view.usageRecords.get(id) ?? null;
 }

package/dist/_internal/platform/knowledge/store-refinement.d.ts

@@ -0,0 +1,4 @@
+import type { SQLiteStore } from '../state/sqlite-store.js';
+import type { KnowledgeRefinementTaskRecord, KnowledgeRefinementTaskUpsertInput } from './types.js';
+export declare function upsertKnowledgeRefinementTask(sqlite: SQLiteStore, refinementTasks: Map<string, KnowledgeRefinementTaskRecord>, input: KnowledgeRefinementTaskUpsertInput, createId: () => string): Promise<KnowledgeRefinementTaskRecord>;
+//# sourceMappingURL=store-refinement.d.ts.map

package/dist/_internal/platform/knowledge/store-refinement.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"store-refinement.d.ts","sourceRoot":"","sources":["../../../../src/_internal/platform/knowledge/store-refinement.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAE5D,OAAO,KAAK,EACV,6BAA6B,EAC7B,kCAAkC,EACnC,MAAM,YAAY,CAAC;AAEpB,wBAAsB,6BAA6B,CACjD,MAAM,EAAE,WAAW,EACnB,eAAe,EAAE,GAAG,CAAC,MAAM,EAAE,6BAA6B,CAAC,EAC3D,KAAK,EAAE,kCAAkC,EACzC,QAAQ,EAAE,MAAM,MAAM,GACrB,OAAO,CAAC,6BAA6B,CAAC,CAmExC"}

package/dist/_internal/platform/knowledge/store-refinement.js

@@ -0,0 +1,69 @@
+import { nowMs, stableText } from './store-schema.js';
+export async function upsertKnowledgeRefinementTask(sqlite, refinementTasks, input, createId) {
+    const existing = input.id ? refinementTasks.get(input.id) : null;
+    const now = nowMs();
+    const _subjectKind = stableText(input.subjectKind);
+    const _subjectId = stableText(input.subjectId);
+    const _subjectTitle = stableText(input.subjectTitle);
+    const _subjectType = stableText(input.subjectType);
+    const _gapId = stableText(input.gapId);
+    const _issueId = stableText(input.issueId);
+    const _blockedReason = stableText(input.blockedReason);
+    const replacementTrace = input.trace ? [...input.trace] : existing?.trace ?? [];
+    const trace = [...replacementTrace, ...(input.appendTrace ?? [])].slice(-80);
+    const record = {
+        id: existing?.id ?? input.id ?? createId(),
+        spaceId: input.spaceId,
+        ...(_subjectKind !== null ? { subjectKind: _subjectKind } : existing?.subjectKind ? { subjectKind: existing.subjectKind } : {}),
+        ...(_subjectId !== null ? { subjectId: _subjectId } : existing?.subjectId ? { subjectId: existing.subjectId } : {}),
+        ...(_subjectTitle !== null ? { subjectTitle: _subjectTitle } : existing?.subjectTitle ? { subjectTitle: existing.subjectTitle } : {}),
+        ...(_subjectType !== null ? { subjectType: _subjectType } : existing?.subjectType ? { subjectType: existing.subjectType } : {}),
+        ...(_gapId !== null ? { gapId: _gapId } : existing?.gapId ? { gapId: existing.gapId } : {}),
+        ...(_issueId !== null ? { issueId: _issueId } : existing?.issueId ? { issueId: existing.issueId } : {}),
+        state: input.state,
+        priority: input.priority ?? existing?.priority ?? 'normal',
+        trigger: input.trigger,
+        budget: {
+            ...(existing?.budget ?? {}),
+            ...(input.budget ?? {}),
+        },
+        attemptCount: Math.max(0, Math.trunc(input.attemptCount ?? existing?.attemptCount ?? 0)),
+        ...(_blockedReason !== null ? { blockedReason: _blockedReason } : existing?.blockedReason && input.state === existing.state ? { blockedReason: existing.blockedReason } : {}),
+        trace,
+        metadata: {
+            ...(existing?.metadata ?? {}),
+            ...(input.metadata ?? {}),
+        },
+        createdAt: existing?.createdAt ?? now,
+        updatedAt: now,
+    };
+    sqlite.run(`
+    INSERT OR REPLACE INTO knowledge_refinement_tasks (
+      id, space_id, subject_kind, subject_id, subject_title, subject_type, gap_id,
+      issue_id, state, priority, trigger, budget, attempt_count, blocked_reason,
+      trace, metadata, created_at, updated_at
+    ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
+  `, [
+        record.id,
+        record.spaceId,
+        record.subjectKind ?? null,
+        record.subjectId ?? null,
+        record.subjectTitle ?? null,
+        record.subjectType ?? null,
+        record.gapId ?? null,
+        record.issueId ?? null,
+        record.state,
+        record.priority,
+        record.trigger,
+        JSON.stringify(record.budget),
+        record.attemptCount,
+        record.blockedReason ?? null,
+        JSON.stringify(record.trace),
+        JSON.stringify(record.metadata),
+        record.createdAt,
+        record.updatedAt,
+    ]);
+    refinementTasks.set(record.id, record);
+    await sqlite.save();
+    return record;
+}

package/dist/_internal/platform/knowledge/store-schema.d.ts

@@ -1,4 +1,4 @@
-import type { KnowledgeConsolidationCandidateRecord, KnowledgeConsolidationReportRecord, KnowledgeEdgeRecord, KnowledgeExtractionRecord, KnowledgeIssueRecord, KnowledgeIssueUpsertInput, KnowledgeJobRunRecord, KnowledgeNodeRecord, KnowledgeScheduleRecord, KnowledgeSourceRecord, KnowledgeUsageRecord } from './types.js';
+import type { KnowledgeConsolidationCandidateRecord, KnowledgeConsolidationReportRecord, KnowledgeEdgeRecord, KnowledgeExtractionRecord, KnowledgeIssueRecord, KnowledgeIssueUpsertInput, KnowledgeJobRunRecord, KnowledgeNodeRecord, KnowledgeScheduleRecord, KnowledgeSourceRecord, KnowledgeRefinementTaskRecord, KnowledgeUsageRecord } from './types.js';
 export declare function resolveKnowledgeDbPathFromControlPlaneDir(controlPlaneDir: string): string;
 export declare function nowMs(): number;
 export declare function stableText(value: string | undefined): string | null;
@@ -16,6 +16,7 @@ export declare function mapEdgeRow(columns: string[], values: unknown[]): Knowle
 export declare function mapIssueRow(columns: string[], values: unknown[]): KnowledgeIssueRecord;
 export declare function mapExtractionRow(columns: string[], values: unknown[]): KnowledgeExtractionRecord;
 export declare function mapJobRunRow(columns: string[], values: unknown[]): KnowledgeJobRunRecord;
+export declare function mapRefinementTaskRow(columns: string[], values: unknown[]): KnowledgeRefinementTaskRecord;
 export declare function mapUsageRow(columns: string[], values: unknown[]): KnowledgeUsageRecord;
 export declare function mapCandidateRow(columns: string[], values: unknown[]): KnowledgeConsolidationCandidateRecord;
 export declare function mapReportRow(columns: string[], values: unknown[]): KnowledgeConsolidationReportRecord;

package/dist/_internal/platform/knowledge/store-schema.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"store-schema.d.ts","sourceRoot":"","sources":["../../../../src/_internal/platform/knowledge/store-schema.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,qCAAqC,EACrC,kCAAkC,EAClC,mBAAmB,EACnB,yBAAyB,EACzB,oBAAoB,EACpB,yBAAyB,EACzB,qBAAqB,EACrB,mBAAmB,EACnB,uBAAuB,EACvB,qBAAqB,EAWrB,oBAAoB,EACrB,MAAM,YAAY,CAAC;AAEpB,wBAAgB,yCAAyC,CAAC,eAAe,EAAE,MAAM,GAAG,MAAM,CAEzF;AAED,wBAAgB,KAAK,IAAI,MAAM,CAE9B;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,IAAI,CAInE;AAED,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,oBAAoB,GAAG,IAAI,GAAG,SAAS,EACjD,KAAK,EAAE,yBAAyB,GAC/B,oBAAoB,CAAC,QAAQ,CAAC,CAOhC;AAED,wBAAgB,IAAI,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,GAAG,MAAM,EAAE,CAWpE;AAED,wBAAgB,cAAc,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC,GAAG,CAAC,CAOhE;AAED,wBAAgB,YAAY,CAAC,EAAE,EAAE;IAAE,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,GAAG,IAAI,CAmLjE;AAED,wBAAgB,4BAA4B,IAAI,SAAS,MAAM,EAAE,CAShE;AAED,wBAAgB,wBAAwB,IAAI,MAAM,CAIjD;AAMD,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,qBAAqB,CAuBxF;AAED,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,mBAAmB,CAgBpF;AAED,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,mBAAmB,CAcpF;AAED,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,oBAAoB,CActF;AAED,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,yBAAyB,CAmBhG;AAED,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,qBAAqB,CAgBxF;AAED,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,oBAAoB,CAatF;AAED,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,qCAAqC,CAoB3G;AAED,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,kCAAkC,CAarG;AAED,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,uBAAuB,CAc5F"}
+{"version":3,"file":"store-schema.d.ts","sourceRoot":"","sources":["../../../../src/_internal/platform/knowledge/store-schema.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,qCAAqC,EACrC,kCAAkC,EAClC,mBAAmB,EACnB,yBAAyB,EACzB,oBAAoB,EACpB,yBAAyB,EACzB,qBAAqB,EACrB,mBAAmB,EACnB,uBAAuB,EACvB,qBAAqB,EAOrB,6BAA6B,EAQ7B,oBAAoB,EACrB,MAAM,YAAY,CAAC;AAEpB,wBAAgB,yCAAyC,CAAC,eAAe,EAAE,MAAM,GAAG,MAAM,CAEzF;AAED,wBAAgB,KAAK,IAAI,MAAM,CAE9B;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,IAAI,CAInE;AAED,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,oBAAoB,GAAG,IAAI,GAAG,SAAS,EACjD,KAAK,EAAE,yBAAyB,GAC/B,oBAAoB,CAAC,QAAQ,CAAC,CAOhC;AAED,wBAAgB,IAAI,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,GAAG,MAAM,EAAE,CAWpE;AAED,wBAAgB,cAAc,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC,GAAG,CAAC,CAOhE;AAED,wBAAgB,YAAY,CAAC,EAAE,EAAE;IAAE,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,GAAG,IAAI,CA4MjE;AAED,wBAAgB,4BAA4B,IAAI,SAAS,MAAM,EAAE,CAShE;AAED,wBAAgB,wBAAwB,IAAI,MAAM,CAIjD;AAMD,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,qBAAqB,CAuBxF;AAED,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,mBAAmB,CAgBpF;AAED,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,mBAAmB,CAcpF;AAED,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,oBAAoB,CActF;AAED,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,yBAAyB,CAmBhG;AAED,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,qBAAqB,CAgBxF;AAED,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,6BAA6B,CAsBxG;AAED,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,oBAAoB,CAatF;AAED,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,qCAAqC,CAoB3G;AAED,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,kCAAkC,CAarG;AAED,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,uBAAuB,CAc5F"}

package/dist/_internal/platform/knowledge/store-schema.js

@@ -158,6 +158,31 @@ export function createSchema(db) {
     db.run(`CREATE INDEX IF NOT EXISTS idx_knowledge_job_runs_job_id ON knowledge_job_runs(job_id)`);
     db.run(`CREATE INDEX IF NOT EXISTS idx_knowledge_job_runs_requested_at ON knowledge_job_runs(requested_at)`);
     db.run(`
+    CREATE TABLE IF NOT EXISTS knowledge_refinement_tasks (
+      id TEXT PRIMARY KEY,
+      space_id TEXT NOT NULL,
+      subject_kind TEXT,
+      subject_id TEXT,
+      subject_title TEXT,
+      subject_type TEXT,
+      gap_id TEXT,
+      issue_id TEXT,
+      state TEXT NOT NULL,
+      priority TEXT NOT NULL,
+      trigger TEXT NOT NULL,
+      budget TEXT NOT NULL DEFAULT '{}',
+      attempt_count INTEGER NOT NULL DEFAULT 0,
+      blocked_reason TEXT,
+      trace TEXT NOT NULL DEFAULT '[]',
+      metadata TEXT NOT NULL DEFAULT '{}',
+      created_at INTEGER NOT NULL,
+      updated_at INTEGER NOT NULL
+    )
+  `);
+    db.run(`CREATE INDEX IF NOT EXISTS idx_knowledge_refinement_space_state ON knowledge_refinement_tasks(space_id, state)`);
+    db.run(`CREATE INDEX IF NOT EXISTS idx_knowledge_refinement_gap ON knowledge_refinement_tasks(gap_id)`);
+    db.run(`CREATE INDEX IF NOT EXISTS idx_knowledge_refinement_subject ON knowledge_refinement_tasks(subject_kind, subject_id)`);
+    db.run(`
     CREATE TABLE IF NOT EXISTS knowledge_usage_records (
       id TEXT PRIMARY KEY,
       target_kind TEXT NOT NULL,
@@ -351,6 +376,29 @@ export function mapJobRunRow(columns, values) {
         updatedAt: Number(row.updated_at),
     };
 }
+export function mapRefinementTaskRow(columns, values) {
+    const row = rowObject(columns, values);
+    return {
+        id: String(row.id),
+        spaceId: String(row.space_id),
+        ...(stableText(row.subject_kind) ? { subjectKind: String(row.subject_kind) } : {}),
+        ...(stableText(row.subject_id) ? { subjectId: String(row.subject_id) } : {}),
+        ...(stableText(row.subject_title) ? { subjectTitle: String(row.subject_title) } : {}),
+        ...(stableText(row.subject_type) ? { subjectType: String(row.subject_type) } : {}),
+        ...(stableText(row.gap_id) ? { gapId: String(row.gap_id) } : {}),
+        ...(stableText(row.issue_id) ? { issueId: String(row.issue_id) } : {}),
+        state: String(row.state),
+        priority: String(row.priority),
+        trigger: String(row.trigger),
+        budget: parseJsonValue(row.budget, {}),
+        attemptCount: Number(row.attempt_count),
+        ...(stableText(row.blocked_reason) ? { blockedReason: String(row.blocked_reason) } : {}),
+        trace: parseJsonValue(row.trace, []),
+        metadata: parseJsonValue(row.metadata, {}),
+        createdAt: Number(row.created_at),
+        updatedAt: Number(row.updated_at),
+    };
+}
 export function mapUsageRow(columns, values) {
     const row = rowObject(columns, values);
     return {

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

@@ -1,10 +1,5 @@
-import type { KnowledgeConsolidationCandidateRecord, KnowledgeConsolidationCandidateUpsertInput, KnowledgeConsolidationReportRecord, KnowledgeConsolidationReportUpsertInput, KnowledgeEdgeRecord, KnowledgeEdgeUpsertInput, KnowledgeExtractionRecord, KnowledgeExtractionUpsertInput, KnowledgeIssueRecord, KnowledgeIssueUpsertInput, KnowledgeItemView, KnowledgeJobRunRecord, KnowledgeJobRunUpsertInput, KnowledgeNodeRecord, KnowledgeNodeUpsertInput, KnowledgeScheduleRecord, KnowledgeScheduleUpsertInput, KnowledgeSourceRecord, KnowledgeSourceUpsertInput, KnowledgeStatus, KnowledgeUsageRecord, KnowledgeUsageUpsertInput } from './types.js';
-export interface KnowledgeStoreConfig {
-    readonly dbPath?: string;
-    readonly configManager?: {
-        getControlPlaneConfigDir?: () => string;
-    };
-}
+import type { KnowledgeConsolidationCandidateRecord, KnowledgeConsolidationCandidateUpsertInput, KnowledgeConsolidationReportRecord, KnowledgeConsolidationReportUpsertInput, KnowledgeEdgeRecord, KnowledgeEdgeUpsertInput, KnowledgeExtractionRecord, KnowledgeExtractionUpsertInput, KnowledgeIssueRecord, KnowledgeIssueUpsertInput, KnowledgeItemView, KnowledgeJobRunRecord, KnowledgeJobRunUpsertInput, KnowledgeRefinementTaskFilter, KnowledgeRefinementTaskRecord, KnowledgeRefinementTaskUpsertInput, KnowledgeNodeRecord, KnowledgeNodeUpsertInput, KnowledgeScheduleRecord, KnowledgeScheduleUpsertInput, KnowledgeSourceRecord, KnowledgeSourceUpsertInput, KnowledgeStatus, KnowledgeUsageRecord, KnowledgeUsageUpsertInput } from './types.js';
+import { type KnowledgeStoreConfig } from './store-config.js';
 export declare class KnowledgeStore {
     private readonly sqlite;
     private readonly dbPath;
@@ -16,6 +11,7 @@ export declare class KnowledgeStore {
     private readonly issues;
     private readonly extractions;
     private readonly jobRuns;
+    private readonly refinementTasks;
     private readonly usageRecords;
     private readonly consolidationCandidates;
     private readonly consolidationReports;
@@ -32,6 +28,7 @@ export declare class KnowledgeStore {
     listIssues(limit?: number): KnowledgeIssueRecord[];
     listExtractions(limit?: number): KnowledgeExtractionRecord[];
     listJobRuns(limit?: number, jobId?: string): KnowledgeJobRunRecord[];
+    listRefinementTasks(limit?: number, input?: KnowledgeRefinementTaskFilter): KnowledgeRefinementTaskRecord[];
     listUsageRecords(limit?: number, input?: {
         readonly targetKind?: KnowledgeUsageRecord['targetKind'];
         readonly targetId?: string;
@@ -50,6 +47,7 @@ export declare class KnowledgeStore {
     getExtraction(id: string): KnowledgeExtractionRecord | null;
     getExtractionBySourceId(sourceId: string): KnowledgeExtractionRecord | null;
     getJobRun(id: string): KnowledgeJobRunRecord | null;
+    getRefinementTask(id: string): KnowledgeRefinementTaskRecord | null;
     getUsageRecord(id: string): KnowledgeUsageRecord | null;
     getConsolidationCandidate(id: string): KnowledgeConsolidationCandidateRecord | null;
     getConsolidationCandidateBySubject(subjectKind: KnowledgeConsolidationCandidateRecord['subjectKind'], subjectId: string, candidateType: KnowledgeConsolidationCandidateRecord['candidateType']): KnowledgeConsolidationCandidateRecord | null;
@@ -66,6 +64,7 @@ export declare class KnowledgeStore {
     upsertIssue(input: KnowledgeIssueUpsertInput): Promise<KnowledgeIssueRecord>;
     upsertExtraction(input: KnowledgeExtractionUpsertInput): Promise<KnowledgeExtractionRecord>;
     upsertJobRun(input: KnowledgeJobRunUpsertInput): Promise<KnowledgeJobRunRecord>;
+    upsertRefinementTask(input: KnowledgeRefinementTaskUpsertInput): Promise<KnowledgeRefinementTaskRecord>;
     upsertUsageRecord(input: KnowledgeUsageUpsertInput): Promise<KnowledgeUsageRecord>;
     upsertConsolidationCandidate(input: KnowledgeConsolidationCandidateUpsertInput): Promise<KnowledgeConsolidationCandidateRecord>;
     upsertConsolidationReport(input: KnowledgeConsolidationReportUpsertInput): Promise<KnowledgeConsolidationReportRecord>;

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

@@ -1 +1 @@
-{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../../../src/_internal/platform/knowledge/store.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,qCAAqC,EACrC,0CAA0C,EAC1C,kCAAkC,EAClC,uCAAuC,EACvC,mBAAmB,EACnB,wBAAwB,EACxB,yBAAyB,EACzB,8BAA8B,EAC9B,oBAAoB,EACpB,yBAAyB,EACzB,iBAAiB,EACjB,qBAAqB,EACrB,0BAA0B,EAC1B,mBAAmB,EACnB,wBAAwB,EACxB,uBAAuB,EACvB,4BAA4B,EAC5B,qBAAqB,EACrB,0BAA0B,EAC1B,eAAe,EACf,oBAAoB,EACpB,yBAAyB,EAC1B,MAAM,YAAY,CAAC;AAuCpB,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,aAAa,CAAC,EAAE;QACvB,wBAAwB,CAAC,EAAE,MAAM,MAAM,CAAC;KACzC,CAAC;CACH;AAeD,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAc;IACrC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,WAAW,CAA8B;IACjD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA4C;IACpE,OAAO,CAAC,QAAQ,CAAC,KAAK,CAA0C;IAChE,OAAO,CAAC,QAAQ,CAAC,KAAK,CAA0C;IAChE,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA2C;IAClE,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAgD;IAC5E,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA4C;IACpE,OAAO,CAAC,QAAQ,CAAC,YAAY,CAA2C;IACxE,OAAO,CAAC,QAAQ,CAAC,uBAAuB,CAA4D;IACpG,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAAyD;IAC9F,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA8C;gBAE5D,MAAM,EAAE,oBAAoB;IAMxC,IAAI,OAAO,IAAI,OAAO,CAErB;IAED,IAAI,WAAW,IAAI,MAAM,CAExB;IAED,OAAO,CAAC,UAAU;IAIZ,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAW3B,MAAM,IAAI,eAAe;IAIzB,WAAW,CAAC,KAAK,SAAM,GAAG,qBAAqB,EAAE;IAIjD,SAAS,CAAC,KAAK,SAAM,GAAG,mBAAmB,EAAE;IAI7C,SAAS,IAAI,mBAAmB,EAAE;IAIlC,UAAU,CAAC,KAAK,SAAM,GAAG,oBAAoB,EAAE;IAI/C,eAAe,CAAC,KAAK,SAAM,GAAG,yBAAyB,EAAE;IAIzD,WAAW,CAAC,KAAK,SAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,qBAAqB,EAAE;IAIjE,gBAAgB,CAAC,KAAK,SAAM,EAAE,KAAK,GAAE;QACnC,QAAQ,CAAC,UAAU,CAAC,EAAE,oBAAoB,CAAC,YAAY,CAAC,CAAC;QACzD,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;QAC3B,QAAQ,CAAC,SAAS,CAAC,EAAE,oBAAoB,CAAC,WAAW,CAAC,CAAC;KACnD,GAAG,oBAAoB,EAAE;IAI/B,2BAA2B,CAAC,KAAK,SAAM,EAAE,KAAK,GAAE;QAC9C,QAAQ,CAAC,MAAM,CAAC,EAAE,qCAAqC,CAAC,QAAQ,CAAC,CAAC;QAClE,QAAQ,CAAC,WAAW,CAAC,EAAE,qCAAqC,CAAC,aAAa,CAAC,CAAC;QAC5E,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;KACxB,GAAG,qCAAqC,EAAE;IAIhD,wBAAwB,CAAC,KAAK,SAAM,GAAG,kCAAkC,EAAE;IAI3E,aAAa,CAAC,KAAK,SAAM,GAAG,uBAAuB,EAAE;IAIrD,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,qBAAqB,GAAG,IAAI;IAInD,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,mBAAmB,GAAG,IAAI;IAI/C,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,oBAAoB,GAAG,IAAI;IAIjD,aAAa,CAAC,EAAE,EAAE,MAAM,GAAG,yBAAyB,GAAG,IAAI;IAI3D,uBAAuB,CAAC,QAAQ,EAAE,MAAM,GAAG,yBAAyB,GAAG,IAAI;IAI3E,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,qBAAqB,GAAG,IAAI;IAInD,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,oBAAoB,GAAG,IAAI;IAIvD,yBAAyB,CAAC,EAAE,EAAE,MAAM,GAAG,qCAAqC,GAAG,IAAI;IAInF,kCAAkC,CAChC,WAAW,EAAE,qCAAqC,CAAC,aAAa,CAAC,EACjE,SAAS,EAAE,MAAM,EACjB,aAAa,EAAE,qCAAqC,CAAC,eAAe,CAAC,GACpE,qCAAqC,GAAG,IAAI;IAI/C,sBAAsB,CAAC,EAAE,EAAE,MAAM,GAAG,kCAAkC,GAAG,IAAI;IAI7E,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,uBAAuB,GAAG,IAAI;IAIvD,uBAAuB,CAAC,YAAY,EAAE,MAAM,GAAG,qBAAqB,GAAG,IAAI;IAI3E,oBAAoB,CAAC,IAAI,EAAE,mBAAmB,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,MAAM,GAAG,mBAAmB,GAAG,IAAI;IAIjG,QAAQ,CAAC,IAAI,EAAE,mBAAmB,CAAC,UAAU,CAAC,GAAG,mBAAmB,CAAC,QAAQ,CAAC,EAAE,EAAE,EAAE,MAAM,GAAG,mBAAmB,EAAE;IAIlH,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,iBAAiB,GAAG,IAAI;IAIvC,YAAY,CAAC,KAAK,EAAE,0BAA0B,GAAG,OAAO,CAAC,qBAAqB,CAAC;IA0E/E,UAAU,CAAC,KAAK,EAAE,wBAAwB,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAgDzE,UAAU,CAAC,KAAK,EAAE,wBAAwB,GAAG,OAAO,CAAC,mBAAmB,CAAC;IA8CzE,aAAa,CAAC,MAAM,EAAE,SAAS,yBAAyB,EAAE,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,oBAAoB,EAAE,CAAC;IAqBhH,WAAW,CAAC,KAAK,EAAE,yBAAyB,GAAG,OAAO,CAAC,oBAAoB,CAAC;IA0C5E,gBAAgB,CAAC,KAAK,EAAE,8BAA8B,GAAG,OAAO,CAAC,yBAAyB,CAAC;IA4D3F,YAAY,CAAC,KAAK,EAAE,0BAA0B,GAAG,OAAO,CAAC,qBAAqB,CAAC;IAgD/E,iBAAiB,CAAC,KAAK,EAAE,yBAAyB,GAAG,OAAO,CAAC,oBAAoB,CAAC;IAmClF,4BAA4B,CAChC,KAAK,EAAE,0CAA0C,GAChD,OAAO,CAAC,qCAAqC,CAAC;IA2D3C,yBAAyB,CAC7B,KAAK,EAAE,uCAAuC,GAC7C,OAAO,CAAC,kCAAkC,CAAC;IAyCxC,cAAc,CAAC,KAAK,EAAE,4BAA4B,GAAG,OAAO,CAAC,uBAAuB,CAAC;IAwCrF,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;YAUpC,UAAU;CAyBzB"}
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../../../src/_internal/platform/knowledge/store.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,qCAAqC,EACrC,0CAA0C,EAC1C,kCAAkC,EAClC,uCAAuC,EACvC,mBAAmB,EACnB,wBAAwB,EACxB,yBAAyB,EACzB,8BAA8B,EAC9B,oBAAoB,EACpB,yBAAyB,EACzB,iBAAiB,EACjB,qBAAqB,EACrB,0BAA0B,EAC1B,6BAA6B,EAC7B,6BAA6B,EAC7B,kCAAkC,EAClC,mBAAmB,EACnB,wBAAwB,EACxB,uBAAuB,EACvB,4BAA4B,EAC5B,qBAAqB,EACrB,0BAA0B,EAC1B,eAAe,EACf,oBAAoB,EACpB,yBAAyB,EAC1B,MAAM,YAAY,CAAC;AAOpB,OAAO,EAA0B,KAAK,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAkCtF,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAc;IACrC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,WAAW,CAA8B;IACjD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA4C;IACpE,OAAO,CAAC,QAAQ,CAAC,KAAK,CAA0C;IAChE,OAAO,CAAC,QAAQ,CAAC,KAAK,CAA0C;IAChE,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA2C;IAClE,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAgD;IAC5E,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA4C;IACpE,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAoD;IACpF,OAAO,CAAC,QAAQ,CAAC,YAAY,CAA2C;IACxE,OAAO,CAAC,QAAQ,CAAC,uBAAuB,CAA4D;IACpG,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAAyD;IAC9F,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA8C;gBAE5D,MAAM,EAAE,oBAAoB;IAMxC,IAAI,OAAO,IAAI,OAAO,CAErB;IAED,IAAI,WAAW,IAAI,MAAM,CAExB;IAED,OAAO,CAAC,UAAU;IAIZ,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAW3B,MAAM,IAAI,eAAe;IAIzB,WAAW,CAAC,KAAK,SAAM,GAAG,qBAAqB,EAAE;IAIjD,SAAS,CAAC,KAAK,SAAM,GAAG,mBAAmB,EAAE;IAI7C,SAAS,IAAI,mBAAmB,EAAE;IAIlC,UAAU,CAAC,KAAK,SAAM,GAAG,oBAAoB,EAAE;IAI/C,eAAe,CAAC,KAAK,SAAM,GAAG,yBAAyB,EAAE;IAIzD,WAAW,CAAC,KAAK,SAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,qBAAqB,EAAE;IAIjE,mBAAmB,CAAC,KAAK,SAAM,EAAE,KAAK,GAAE,6BAAkC,GAAG,6BAA6B,EAAE;IAI5G,gBAAgB,CAAC,KAAK,SAAM,EAAE,KAAK,GAAE;QACnC,QAAQ,CAAC,UAAU,CAAC,EAAE,oBAAoB,CAAC,YAAY,CAAC,CAAC;QACzD,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;QAC3B,QAAQ,CAAC,SAAS,CAAC,EAAE,oBAAoB,CAAC,WAAW,CAAC,CAAC;KACnD,GAAG,oBAAoB,EAAE;IAI/B,2BAA2B,CAAC,KAAK,SAAM,EAAE,KAAK,GAAE;QAC9C,QAAQ,CAAC,MAAM,CAAC,EAAE,qCAAqC,CAAC,QAAQ,CAAC,CAAC;QAClE,QAAQ,CAAC,WAAW,CAAC,EAAE,qCAAqC,CAAC,aAAa,CAAC,CAAC;QAC5E,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;KACxB,GAAG,qCAAqC,EAAE;IAIhD,wBAAwB,CAAC,KAAK,SAAM,GAAG,kCAAkC,EAAE;IAI3E,aAAa,CAAC,KAAK,SAAM,GAAG,uBAAuB,EAAE;IAIrD,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,qBAAqB,GAAG,IAAI;IAInD,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,mBAAmB,GAAG,IAAI;IAI/C,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,oBAAoB,GAAG,IAAI;IAIjD,aAAa,CAAC,EAAE,EAAE,MAAM,GAAG,yBAAyB,GAAG,IAAI;IAI3D,uBAAuB,CAAC,QAAQ,EAAE,MAAM,GAAG,yBAAyB,GAAG,IAAI;IAI3E,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,qBAAqB,GAAG,IAAI;IAInD,iBAAiB,CAAC,EAAE,EAAE,MAAM,GAAG,6BAA6B,GAAG,IAAI;IAInE,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,oBAAoB,GAAG,IAAI;IAIvD,yBAAyB,CAAC,EAAE,EAAE,MAAM,GAAG,qCAAqC,GAAG,IAAI;IAInF,kCAAkC,CAChC,WAAW,EAAE,qCAAqC,CAAC,aAAa,CAAC,EACjE,SAAS,EAAE,MAAM,EACjB,aAAa,EAAE,qCAAqC,CAAC,eAAe,CAAC,GACpE,qCAAqC,GAAG,IAAI;IAI/C,sBAAsB,CAAC,EAAE,EAAE,MAAM,GAAG,kCAAkC,GAAG,IAAI;IAI7E,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,uBAAuB,GAAG,IAAI;IAIvD,uBAAuB,CAAC,YAAY,EAAE,MAAM,GAAG,qBAAqB,GAAG,IAAI;IAI3E,oBAAoB,CAAC,IAAI,EAAE,mBAAmB,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,MAAM,GAAG,mBAAmB,GAAG,IAAI;IAIjG,QAAQ,CAAC,IAAI,EAAE,mBAAmB,CAAC,UAAU,CAAC,GAAG,mBAAmB,CAAC,QAAQ,CAAC,EAAE,EAAE,EAAE,MAAM,GAAG,mBAAmB,EAAE;IAIlH,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,iBAAiB,GAAG,IAAI;IAIvC,YAAY,CAAC,KAAK,EAAE,0BAA0B,GAAG,OAAO,CAAC,qBAAqB,CAAC;IA0E/E,UAAU,CAAC,KAAK,EAAE,wBAAwB,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAgDzE,UAAU,CAAC,KAAK,EAAE,wBAAwB,GAAG,OAAO,CAAC,mBAAmB,CAAC;IA8CzE,aAAa,CAAC,MAAM,EAAE,SAAS,yBAAyB,EAAE,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,oBAAoB,EAAE,CAAC;IAqBhH,WAAW,CAAC,KAAK,EAAE,yBAAyB,GAAG,OAAO,CAAC,oBAAoB,CAAC;IA0C5E,gBAAgB,CAAC,KAAK,EAAE,8BAA8B,GAAG,OAAO,CAAC,yBAAyB,CAAC;IA4D3F,YAAY,CAAC,KAAK,EAAE,0BAA0B,GAAG,OAAO,CAAC,qBAAqB,CAAC;IAgD/E,oBAAoB,CAAC,KAAK,EAAE,kCAAkC,GAAG,OAAO,CAAC,6BAA6B,CAAC;IAKvG,iBAAiB,CAAC,KAAK,EAAE,yBAAyB,GAAG,OAAO,CAAC,oBAAoB,CAAC;IAmClF,4BAA4B,CAChC,KAAK,EAAE,0CAA0C,GAChD,OAAO,CAAC,qCAAqC,CAAC;IA2D3C,yBAAyB,CAC7B,KAAK,EAAE,uCAAuC,GAC7C,OAAO,CAAC,kCAAkC,CAAC;IAyCxC,cAAc,CAAC,KAAK,EAAE,4BAA4B,GAAG,OAAO,CAAC,uBAAuB,CAAC;IAwCrF,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;YAUpC,UAAU;CA2BzB"}

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

@@ -1,19 +1,10 @@
 import { randomUUID } from 'node:crypto';
-import { join } from 'node:path';
 import { SQLiteStore } from '../state/sqlite-store.js';
-import { createSchema, issueStatusForUpsert, nowMs, resolveKnowledgeDbPathFromControlPlaneDir, stableText, uniq, } from './store-schema.js';
-import { edgesForKnowledgeStore, getKnowledgeConsolidationCandidate, getKnowledgeConsolidationCandidateBySubject, getKnowledgeConsolidationReport, getKnowledgeExtraction, getKnowledgeExtractionBySourceId, getKnowledgeIssue, getKnowledgeItem, getKnowledgeJobRun, getKnowledgeNode, getKnowledgeNodeByKindAndSlug, getKnowledgeSchedule, getKnowledgeSource, getKnowledgeSourceByCanonicalUri, getKnowledgeStoreStatus, getKnowledgeUsageRecord, listKnowledgeConsolidationCandidates, listKnowledgeConsolidationReports, listKnowledgeEdges, listKnowledgeExtractions, listKnowledgeIssues, listKnowledgeJobRuns, listKnowledgeNodes, listKnowledgeSchedules, listKnowledgeSources, listKnowledgeUsageRecords, } from './store-read.js';
+import { createSchema, issueStatusForUpsert, nowMs, stableText, uniq, } from './store-schema.js';
+import { resolveKnowledgeDbPath } from './store-config.js';
+import { upsertKnowledgeRefinementTask } from './store-refinement.js';
+import { edgesForKnowledgeStore, getKnowledgeConsolidationCandidate, getKnowledgeConsolidationCandidateBySubject, getKnowledgeConsolidationReport, getKnowledgeExtraction, getKnowledgeExtractionBySourceId, getKnowledgeIssue, getKnowledgeItem, getKnowledgeJobRun, getKnowledgeRefinementTask, getKnowledgeNode, getKnowledgeNodeByKindAndSlug, getKnowledgeSchedule, getKnowledgeSource, getKnowledgeSourceByCanonicalUri, getKnowledgeStoreStatus, getKnowledgeUsageRecord, listKnowledgeConsolidationCandidates, listKnowledgeConsolidationReports, listKnowledgeEdges, listKnowledgeExtractions, listKnowledgeIssues, listKnowledgeJobRuns, listKnowledgeRefinementTasks, listKnowledgeNodes, listKnowledgeSchedules, listKnowledgeSources, listKnowledgeUsageRecords, } from './store-read.js';
 import { loadKnowledgeStoreSnapshot } from './store-load.js';
-function resolveKnowledgeDbPath(config) {
-    const controlPlaneDir = typeof config.configManager?.getControlPlaneConfigDir === 'function'
-        ? config.configManager.getControlPlaneConfigDir()
-        : undefined;
-    const dbPath = config.dbPath ?? (controlPlaneDir ? resolveKnowledgeDbPathFromControlPlaneDir(controlPlaneDir) : undefined);
-    if (!dbPath) {
-        throw new Error('KnowledgeStore requires an explicit dbPath or configManager.getControlPlaneConfigDir().');
-    }
-    return dbPath;
-}
 export class KnowledgeStore {
     sqlite;
     dbPath;
@@ -25,6 +16,7 @@ export class KnowledgeStore {
     issues = new Map();
     extractions = new Map();
     jobRuns = new Map();
+    refinementTasks = new Map();
     usageRecords = new Map();
     consolidationCandidates = new Map();
     consolidationReports = new Map();
@@ -77,6 +69,9 @@ export class KnowledgeStore {
     listJobRuns(limit = 100, jobId) {
         return listKnowledgeJobRuns(this.asReadView(), limit, jobId);
     }
+    listRefinementTasks(limit = 100, input = {}) {
+        return listKnowledgeRefinementTasks(this.asReadView(), limit, input);
+    }
     listUsageRecords(limit = 100, input = {}) {
         return listKnowledgeUsageRecords(this.asReadView(), limit, input);
     }
@@ -107,6 +102,9 @@ export class KnowledgeStore {
     getJobRun(id) {
         return getKnowledgeJobRun(this.asReadView(), id);
     }
+    getRefinementTask(id) {
+        return getKnowledgeRefinementTask(this.asReadView(), id);
+    }
     getUsageRecord(id) {
         return getKnowledgeUsageRecord(this.asReadView(), id);
     }
@@ -466,6 +464,10 @@ export class KnowledgeStore {
         await this.sqlite.save();
         return record;
     }
+    async upsertRefinementTask(input) {
+        await this.init();
+        return upsertKnowledgeRefinementTask(this.sqlite, this.refinementTasks, input, () => `kref-${randomUUID().slice(0, 8)}`);
+    }
     async upsertUsageRecord(input) {
         await this.init();
         const _task = stableText(input.task);
@@ -668,6 +670,9 @@ export class KnowledgeStore {
         this.jobRuns.clear();
         for (const record of snapshot.jobRuns)
             this.jobRuns.set(record.id, record);
+        this.refinementTasks.clear();
+        for (const record of snapshot.refinementTasks)
+            this.refinementTasks.set(record.id, record);
         this.usageRecords.clear();
         for (const record of snapshot.usageRecords)
             this.usageRecords.set(record.id, record);