@xopcai/xopc 0.0.228 → 0.0.230

package/dist/src/connectors/connected-source-understanding.js

@@ -6,7 +6,6 @@ import { upsertUserFocus } from "../user-context/sources/repository.js";
 import { claimRegisteredExtraction } from "../user-context/extraction/registry.js";
 import { allowsRemoteSourceProcessing } from "../user-context/sources/processing-policy.js";
 import { analyzeUnderstandingSources } from "../work-discovery/analyzer.js";
-import { createHash } from "node:crypto";
 //#region src/connectors/connected-source-understanding.ts
 const MAX_CONNECTED_ITEMS = 150;
 function normalizedValue(item) {
@@ -60,17 +59,14 @@ function connectedItemsForUnderstanding(items) {
 		}];
 	});
 }
-function understandingKind(category) {
-	if (category === "preference") return "preference";
-	if (category === "routine") return "routine";
-	return "project_context";
+function isConnectedPortraitCandidate(candidate) {
+	return candidate.category === "preference" || candidate.category === "routine";
 }
 function understandingCandidate(candidate) {
-	const normalized = candidate.statement.toLocaleLowerCase().replace(/[^\p{L}\p{N}]+/gu, " ").trim();
 	return {
-		kind: understandingKind(candidate.category),
+		kind: candidate.category,
 		content: candidate.statement,
-		canonicalKey: `connected-semantic:${candidate.category}:${createHash("sha256").update(normalized).digest("hex").slice(0, 20)}`,
+		canonicalKey: `understanding:${candidate.category}:${candidate.factKey}`,
 		confidence: candidate.confidence === "high" ? .9 : candidate.confidence === "medium" ? .72 : .55,
 		importance: .68,
 		explicitness: "inferred",
@@ -84,6 +80,18 @@ function hasLongVerbatimOverlap(value, sourceTexts, minimumLength = 32) {
 	if (normalized.length < minimumLength) return false;
 	return sourceTexts.some((source) => source.replace(/\s+/g, " ").includes(normalized));
 }
+function evidenceDate(item) {
+	const timestamp = item.occurredAt ?? item.modifiedAt;
+	return timestamp == null ? void 0 : new Date(timestamp).toISOString().slice(0, 10);
+}
+function durableConnectedEvidence(candidate, itemsByRef) {
+	if (candidate.confidence !== "high") return [];
+	const items = [...new Set(candidate.evidenceRefs ?? [])].flatMap((ref) => itemsByRef.get(ref) ?? []);
+	if (items.some((item) => item.ownerAttribution !== "user")) return [];
+	const required = candidate.category === "routine" ? 3 : 2;
+	const dates = new Set(items.map(evidenceDate).filter((value) => Boolean(value)));
+	return items.length >= required && dates.size >= required ? items : [];
+}
 async function deriveConnectedSourceUnderstanding(input) {
 	const knowledgeItems = listKnowledgeSourceItems({
 		agentId: input.agentId,
@@ -115,22 +123,28 @@ async function deriveConnectedSourceUnderstanding(input) {
 			items
 		});
 		const rawTexts = items.flatMap((item) => item.text ? [item.text] : []);
-		const profileCandidates = analysis.profileCandidates.filter((candidate) => !hasLongVerbatimOverlap(candidate.statement, rawTexts));
-		const sourceItemIds = [...new Set([...profileCandidates.flatMap((candidate) => candidate.evidenceRefs ?? []), ...analysis.workThreadCandidates.flatMap((candidate) => candidate.evidenceRefs)].map((ref) => ref.startsWith("knowledge-source://") ? ref.slice(19) : ""))].filter(Boolean).slice(0, 20);
-		const reviewed = profileCandidates.length ? await input.memoryManager.applyUnderstandingCandidates(profileCandidates.map(understandingCandidate), {
-			agentId: input.agentId,
-			sourceItemIds,
-			sourceText: "Bounded semantic synthesis from explicitly connected work sources.",
-			source: {
-				provider: "connected-sources",
-				sourceInstanceId: input.sourceInstanceId
-			},
-			reviewSource: "background",
-			extractionRunId: extraction.run.id
-		}) : {
+		const itemsByRef = new Map(items.map((item) => [item.evidenceRef, item]));
+		const profileCandidates = analysis.profileCandidates.filter(isConnectedPortraitCandidate).filter((candidate) => !hasLongVerbatimOverlap(candidate.statement, rawTexts) && durableConnectedEvidence(candidate, itemsByRef).length > 0);
+		const reviewed = {
 			created: 0,
 			writeOutputs: []
 		};
+		for (const candidate of profileCandidates) {
+			const evidenceItems = durableConnectedEvidence(candidate, itemsByRef);
+			const applied = await input.memoryManager.applyUnderstandingCandidates([understandingCandidate(candidate)], {
+				agentId: input.agentId,
+				sourceItemIds: evidenceItems.map((item) => item.id).slice(0, 20),
+				sourceText: "Bounded semantic synthesis from explicitly connected work sources.",
+				source: {
+					provider: "connected-sources",
+					sourceInstanceId: input.sourceInstanceId
+				},
+				reviewSource: "background",
+				extractionRunId: extraction.run.id
+			});
+			reviewed.created += applied.created;
+			reviewed.writeOutputs.push(...applied.writeOutputs ?? []);
+		}
 		const focuses = analysis.workThreadCandidates.filter((candidate) => !hasLongVerbatimOverlap(candidate.title, rawTexts) && !hasLongVerbatimOverlap(candidate.summary, rawTexts)).map((candidate) => upsertUserFocus({
 			canonicalKey: `connected-focus:${candidate.topicKey}`,
 			title: candidate.title,

package/dist/src/connectors/learning-coordinator.js

@@ -1,6 +1,5 @@
 import { createLogger } from "../utils/logger/index.js";
 import { init_logger } from "../utils/logger.js";
-import { finishContextExtractionRun } from "../storage/sqlite/context-extraction-repository.js";
 import { claimNextConnectorLearningJob, enqueueConnectorLearningJob, listConnectorLearningJobs, recoverStaleConnectorLearningJobs, setConnectorLearningPaused, updateConnectorLearningJob } from "../storage/sqlite/connector-learning-repository.js";
 import { getConnectorInstallation, listConnectorConnections, upsertConnectorConnection } from "../storage/sqlite/connector-repository.js";
 import { getConnectorAccount, reconcileConnectorAccount } from "../storage/sqlite/connector-account-repository.js";
@@ -11,10 +10,8 @@ import { ComposioSessionsAdapter } from "./composio-sessions.js";
 import { buildConnectorLearningArguments, getConnectorLearningPlan } from "./learning-recipes.js";
 import { getConnectorDefinition } from "./catalog.js";
 import { createUnderstandingSourceRun, getUnderstandingSourceGrant, listUnderstandingSourceRuns, updateUnderstandingSourceGrantCheckpoint, updateUnderstandingSourceRun, upsertUnderstandingSourceGrant } from "../user-context/sources/repository.js";
-import { claimRegisteredExtraction } from "../user-context/extraction/registry.js";
 import { getWorkspacePath } from "../config/workspace-path-helpers.js";
 import { ConnectedKnowledgePipeline } from "../knowledge/connected-knowledge-pipeline.js";
-import { ConnectedUnderstandingPipeline } from "../knowledge/connected-understanding-pipeline.js";
 import "../knowledge/index.js";
 import { ingestComposioConnectedSource } from "./connected-source-ingestion.js";
 import { deriveConnectedSourceUnderstanding } from "./connected-source-understanding.js";
@@ -210,44 +207,6 @@ function startConnectorLearningCoordinator(options) {
 			itemsIndexed
 		}));
 		publish(updateConnectorLearningJob(job.id, { phase: "deriving" }));
-		const structuralExtraction = claimRegisteredExtraction({
-			extractorId: "connector-structural",
-			sourceRef: `understanding-source-run:${sourceRun.id}`,
-			contentForHash: `${job.sourceInstanceId}:${itemsSeen}:${itemsIndexed}`,
-			processingPolicy: "local_only",
-			destination: "deterministic"
-		});
-		let understanding = {
-			proposed: 0,
-			created: 0,
-			deduplicated: 0,
-			rejected: 0,
-			createdRecords: [],
-			writeOutputs: []
-		};
-		if (structuralExtraction.shouldExecute) try {
-			understanding = await new ConnectedUnderstandingPipeline(options.getMemoryManager()).process(job.agentId, structuralExtraction.run.id);
-			finishContextExtractionRun({
-				runId: structuralExtraction.run.id,
-				status: "completed",
-				outputs: (understanding.writeOutputs ?? []).map((output) => ({
-					candidateKey: output.candidateKey,
-					...output.objectId ? {
-						objectType: "understanding",
-						objectId: output.objectId
-					} : {},
-					...output.versionId ? { versionId: output.versionId } : {},
-					outcome: output.outcome
-				}))
-			});
-		} catch (error) {
-			finishContextExtractionRun({
-				runId: structuralExtraction.run.id,
-				status: "failed",
-				errorCode: "extractor_failed"
-			});
-			throw error;
-		}
 		let semantic = {
 			created: 0,
 			focusCount: 0,
@@ -276,7 +235,7 @@ function startConnectorLearningCoordinator(options) {
 				connectorId: job.connectorId
 			}, `Connected source semantic analysis failed: ${errorMessage}`);
 		}
-		const candidatesCreated = understanding.created + semantic.created + semantic.focusCount;
+		const candidatesCreated = semantic.created + semantic.focusCount;
 		const incomplete = enrichmentErrors.length > 0 || semantic.status !== "completed";
 		const completed = updateConnectorLearningJob(job.id, {
 			status: "completed",

package/dist/src/gateway/chat-stream/mapper.d.ts

@@ -15,6 +15,7 @@ export declare class ChatStreamMapper {
     private currentAssistantMessageId;
     private lastAssistantMessageId;
     private currentAssistantText;
+    private lastAssistantText;
     private currentAssistantReviewEmitted;
     private toolCallToMessageId;
     private turnDiffs;
@@ -28,6 +29,7 @@ export declare class ChatStreamMapper {
     start(): ChatStreamEvent[];
     end(status: ChatStreamStatus, summary?: string): ChatStreamEvent[];
     error(message: string, code?: string): ChatStreamEvent[];
+    getLastAssistantText(): string;
     private mapMessageStart;
     private mapMessageUpdate;
     private mapAssistantSnapshot;

package/dist/src/gateway/chat-stream/mapper.js

@@ -14,6 +14,7 @@ var ChatStreamMapper = class {
 	currentAssistantMessageId;
 	lastAssistantMessageId;
 	currentAssistantText = "";
+	lastAssistantText = "";
 	currentAssistantReviewEmitted = false;
 	toolCallToMessageId = /* @__PURE__ */ new Map();
 	turnDiffs = [];
@@ -154,6 +155,9 @@ var ChatStreamMapper = class {
 			petFeedback: createPetFeedback("error", { recoverable: false })
 		})];
 	}
+	getLastAssistantText() {
+		return this.currentAssistantText || this.lastAssistantText;
+	}
 	mapMessageStart(raw) {
 		if (raw?.role !== "assistant") return [];
 		const messageId = this.nextAssistantMessageId();
@@ -260,6 +264,7 @@ var ChatStreamMapper = class {
 			presentation: hasToolCall(message) ? "narration" : "answer",
 			usage: extractUsage(message)
 		}));
+		if (this.currentAssistantText) this.lastAssistantText = this.currentAssistantText;
 		this.lastAssistantMessageId = messageId;
 		this.currentAssistantMessageId = void 0;
 		this.currentAssistantText = "";
@@ -337,6 +342,17 @@ var ChatStreamMapper = class {
 			errorMessage: event.isError ? result?.text ?? extractText(result?.content) : void 0
 		})];
 		const details = asRecord(fullResult?.details);
+		if (toolName === "text_to_speech" && !event.isError && details) {
+			const audio = (Array.isArray(details.media) ? details.media : []).map(asRecord).find((item) => item?.type === "voice" || String(item?.mimeType ?? "").startsWith("audio/"));
+			const uri = typeof audio?.uri === "string" ? audio.uri.trim() : "";
+			if (uri) events.push(this.make("tts_audio", {
+				uri,
+				mimeType: typeof audio?.mimeType === "string" ? audio.mimeType : "audio/mpeg",
+				name: typeof audio?.name === "string" ? audio.name : "voice.mp3",
+				attachTo: "last_assistant",
+				messageId
+			}));
+		}
 		if (toolName === "exec_command" && details) events.push(this.make("command_completed", {
 			messageId,
 			toolCallId,

package/dist/src/gateway/hono/routes/understanding-sources.js

@@ -67,7 +67,10 @@ function applySourceRevocationChoices(impact, options) {
 	} else updateUserFocus(id, { status: "paused" });
 	for (const id of impact.understandingIds) if (options.derived === "delete") {
 		if (deleteUnderstanding(id)) derivedDeleted += 1;
-	} else setUnderstandingStatus(id, "needs_review");
+	} else setUnderstandingStatus(id, "needs_review", {
+		actorType: "runtime",
+		source: "understanding-source-revoked"
+	});
 	if (options.derived === "delete" && impact.sourceInstanceId) derivedDeleted += deleteMemoryRecordsBySourceInstanceId(impact.sourceInstanceId);
 	const rawDeleted = options.raw === "delete" && impact.sourceInstanceId ? deleteKnowledgeSourceItems(impact.sourceInstanceId) : 0;
 	return {

package/dist/src/gateway/hono/routes/voice.js

@@ -14,8 +14,8 @@ import "../../../voice/stt/index.js";
 import { listSttProvidersForApi } from "../../../voice/stt/list-providers.js";
 import "../../../voice/tts/index.js";
 import { createGatewayRouteLogger } from "../lib/route-logger.js";
-import { listLocalVoiceModelStatuses, removeLocalVoiceModel, startLocalVoiceModelInstall } from "../../../voice/local/model-manager.js";
 import { listTtsProvidersForApi } from "../../../voice/tts/list-providers.js";
+import { listLocalVoiceModelStatuses, removeLocalVoiceModel, startLocalVoiceModelInstall } from "../../../voice/local/model-manager.js";
 //#region src/gateway/hono/routes/voice.ts
 init_providers();
 const log = createGatewayRouteLogger("Voice");

package/dist/src/gateway/hono/routes/you.js

@@ -1,7 +1,7 @@
 import { UNDERSTANDING_KINDS } from "../../../user-context/domain.js";
 import { listContextExtractionRuns } from "../../../storage/sqlite/context-extraction-repository.js";
 import { listContextConsolidationRuns } from "../../../storage/sqlite/context-consolidation-repository.js";
-import { createCollaborationRule, createUnderstanding, decideContextConsent, deleteCollaborationRule, deleteUnderstanding, getCollaborationRule, getTurnPersonalization, getUnderstanding, getUserProfile, listCollaborationRules, listUnderstandingEvidence, listUnderstandings, recordContextFeedback, rejectUnderstanding, reviseCollaborationRule, reviseUnderstanding, setCollaborationRuleStatus, setUnderstandingStatus, updateUserProfile } from "../../../storage/sqlite/user-context-repository.js";
+import { createCollaborationRule, createUnderstanding, decideContextConsent, deleteCollaborationRule, deleteUnderstanding, getCollaborationRule, getTurnPersonalization, getUnderstanding, getUserProfile, listCollaborationRules, listUnderstandingEvidence, listUnderstandingStatusEvents, listUnderstandings, recordContextFeedback, rejectUnderstanding, reviseCollaborationRule, reviseUnderstanding, setCollaborationRuleStatus, setUnderstandingStatus, updateUserProfile } from "../../../storage/sqlite/user-context-repository.js";
 import "../../../storage/sqlite/index.js";
 import { listUserFocuses, updateUserFocus } from "../../../user-context/sources/repository.js";
 import { canonicalUnderstandingKey, findDuplicateUnderstanding } from "../../../user-context/understanding.js";
@@ -199,8 +199,13 @@ function registerYouRoutes(authenticated, deps) {
 		const objects = normalized.map(({ objectType, objectId, action }) => {
 			if (objectType === "understanding") return action === "accept" ? setUnderstandingStatus(objectId, "active", {
 				explicitness: "explicit",
-				confidence: 1
-			}) : action === "reject" ? rejectUnderstanding(objectId, "Rejected during context review") : setUnderstandingStatus(objectId, "needs_review");
+				confidence: 1,
+				actorType: "user",
+				source: "context-review"
+			}) : action === "reject" ? rejectUnderstanding(objectId, "Rejected during context review", "user") : setUnderstandingStatus(objectId, "needs_review", {
+				actorType: "user",
+				source: "context-review-later"
+			});
 			return updateUserFocus(objectId, { status: action === "accept" ? "active" : action === "reject" ? "rejected" : "paused" });
 		});
 		return c.json({ objects });
@@ -271,7 +276,10 @@ function registerYouRoutes(authenticated, deps) {
 	authenticated.get("/api/you/understandings/:id/evidence", (c) => {
 		const understanding = getUnderstanding(c.req.param("id"));
 		if (!understanding) return c.json({ error: "Understanding not found" }, 404);
-		return c.json({ evidence: listUnderstandingEvidence(understanding.id) });
+		return c.json({
+			evidence: listUnderstandingEvidence(understanding.id),
+			statusEvents: listUnderstandingStatusEvents(understanding.id)
+		});
 	});
 	authenticated.patch("/api/you/understandings/:id", write, async (c) => {
 		const id = c.req.param("id");
@@ -299,10 +307,14 @@ function registerYouRoutes(authenticated, deps) {
 		}
 		if (body.status !== void 0) {
 			if (!UNDERSTANDING_STATUSES.has(body.status)) return c.json({ error: "Invalid status" }, 400);
-			understanding = body.status === "rejected" ? rejectUnderstanding(id, nonEmptyString(body.reason, 500) ?? "Rejected by user") : setUnderstandingStatus(id, body.status, body.status === "active" ? {
-				explicitness: "explicit",
-				confidence: 1
-			} : void 0);
+			understanding = body.status === "rejected" ? rejectUnderstanding(id, nonEmptyString(body.reason, 500) ?? "Rejected by user", "user") : setUnderstandingStatus(id, body.status, {
+				...body.status === "active" ? {
+					explicitness: "explicit",
+					confidence: 1
+				} : {},
+				actorType: "user",
+				source: "understanding-edit"
+			});
 		}
 		return c.json({ understanding });
 	});
@@ -374,9 +386,15 @@ function registerYouRoutes(authenticated, deps) {
 			...typeof body.reason === "string" ? { reason: body.reason.slice(0, 500) } : {}
 		});
 		if (objectType === "understanding" && typeof objectId === "string") {
-			if (rating === "wrong") rejectUnderstanding(objectId, "Marked wrong from turn feedback");
-			if (rating === "stale") setUnderstandingStatus(objectId, "stale");
-			if (rating === "sensitive") setUnderstandingStatus(objectId, "needs_review");
+			if (rating === "wrong") rejectUnderstanding(objectId, "Marked wrong from turn feedback", "user");
+			if (rating === "stale") setUnderstandingStatus(objectId, "stale", {
+				actorType: "user",
+				source: "turn-feedback-stale"
+			});
+			if (rating === "sensitive") setUnderstandingStatus(objectId, "needs_review", {
+				actorType: "user",
+				source: "turn-feedback-sensitive"
+			});
 		}
 		if (objectType === "focus" && typeof objectId === "string") {
 			if (rating === "wrong") updateUserFocus(objectId, { status: "rejected" });

package/dist/src/gateway/service/run-gateway-agent.js

@@ -331,6 +331,9 @@ async function* runGatewayAgent(deps, message, channel, chatId, origin, attachme
 		}
 		if (webchatSessionKey) {
 			const metaAfter = await sessionIndex.getSessionMetadata(webchatSessionKey).catch(() => void 0);
+			const normalizedResponse = terminalStatus === "success" ? mapper.getLastAssistantText().replace(/\s+/g, " ").trim() : "";
+			const responseCharacters = Array.from(normalizedResponse);
+			const responsePreview = responseCharacters.length > 180 ? `${responseCharacters.slice(0, 179).join("")}…` : normalizedResponse;
 			if (metaAfter?.name) emit("session.updated", {
 				key: webchatSessionKey,
 				name: metaAfter.name
@@ -346,7 +349,8 @@ async function* runGatewayAgent(deps, message, channel, chatId, origin, attachme
 					sessionKey: webchatSessionKey
 				},
 				source: "webchat",
-				...metaAfter?.name?.trim() ? { sessionTitle: metaAfter.name.trim().slice(0, 100) } : {}
+				...metaAfter?.name?.trim() ? { sessionTitle: metaAfter.name.trim().slice(0, 100) } : {},
+				...responsePreview ? { responsePreview } : {}
 			});
 		}
 	}

package/dist/src/knowledge/index.d.ts

@@ -1,6 +1,5 @@
 export * from './types.js';
 export * from './ingestion-service.js';
 export * from './connected-knowledge-pipeline.js';
-export * from './connected-understanding-pipeline.js';
 export * from './coordinator.js';
 export * from './local-folder-adapter.js';

package/dist/src/knowledge/index.js

@@ -1,6 +1,5 @@
 import { KnowledgeIngestionService, SqliteKnowledgeSourceStateStore } from "./ingestion-service.js";
 import { ConnectedKnowledgePipeline } from "./connected-knowledge-pipeline.js";
-import { ConnectedUnderstandingPipeline, deriveConnectedClaimObservations, renderConnectedObservation } from "./connected-understanding-pipeline.js";
 import { startConnectedKnowledgeCoordinator } from "./coordinator.js";
 import { LocalFolderKnowledgeSourceAdapter } from "./local-folder-adapter.js";
-export { ConnectedKnowledgePipeline, ConnectedUnderstandingPipeline, KnowledgeIngestionService, LocalFolderKnowledgeSourceAdapter, SqliteKnowledgeSourceStateStore, deriveConnectedClaimObservations, renderConnectedObservation, startConnectedKnowledgeCoordinator };
+export { ConnectedKnowledgePipeline, KnowledgeIngestionService, LocalFolderKnowledgeSourceAdapter, SqliteKnowledgeSourceStateStore, startConnectedKnowledgeCoordinator };

package/dist/src/notifications/planner.js

@@ -14,6 +14,7 @@ function chatPlan(payload) {
 		zh: "打开对话查看结果。"
 	};
 	const sessionTitle = typeof event.sessionTitle === "string" ? event.sessionTitle.trim().slice(0, 120) : "";
+	const responsePreview = completed && typeof event.responsePreview === "string" ? Array.from(event.responsePreview.trim()).slice(0, 180).join("") : "";
 	return {
 		dedupeKey: `${type}:${event.runId}`,
 		notification: {
@@ -27,7 +28,10 @@ function chatPlan(payload) {
 				en: "Response needs attention",
 				zh: "回答需要处理"
 			},
-			body: sessionTitle ? {
+			body: responsePreview ? {
+				en: responsePreview,
+				zh: responsePreview
+			} : sessionTitle ? {
 				en: sessionTitle,
 				zh: sessionTitle
 			} : fallback,

package/dist/src/storage/sqlite/index.d.ts

@@ -9,7 +9,7 @@ export { claimContextExtractionRun, finishContextExtractionRun, getContextExtrac
 export { closeTemporalAssertions, createTemporalAssertion, linkContextObjects, listContextObjectRelations, listTemporalAssertions, type ContextObjectRelation, type ContextTemporalAssertion, } from './context-relation-repository.js';
 export { finishContextConsolidationRun, getContextConsolidationRun, listContextConsolidationDecisions, listContextConsolidationRuns, recordContextConsolidationDecision, startContextConsolidationRun, type ContextConsolidationDecision, type ContextConsolidationRun, } from './context-consolidation-repository.js';
 export { summarizeUnderstandingFeedback, summarizeUserUnderstandingQuality, type UnderstandingFeedbackSummary, type UserUnderstandingQualityMetrics, } from './user-context-quality-repository.js';
-export { createCollaborationRule, createContextEvidence, createUnderstanding, closeUnderstandingValidity, consumeContextConsent, deleteCollaborationRule, deleteUnderstanding, decideContextConsent, ensureContextConsent, getCollaborationRule, getTurnPersonalization, getUnderstanding, getUserProfile, hasContextConsent, isUnderstandingSuppressed, listCollaborationRules, listUnderstandingEvidence, listUnderstandings, linkUnderstandingEvidence, recordContextFeedback, recordContextRun, rejectUnderstanding, reviseCollaborationRule, reviseUnderstanding, searchActiveUnderstandings, setCollaborationRuleStatus, setUnderstandingStatus, updateUserProfile, type CreateUnderstandingInput, } from './user-context-repository.js';
+export { createCollaborationRule, createContextEvidence, createUnderstanding, closeUnderstandingValidity, consumeContextConsent, deleteCollaborationRule, deleteUnderstanding, decideContextConsent, ensureContextConsent, getCollaborationRule, getTurnPersonalization, getUnderstanding, getUserProfile, hasContextConsent, isUnderstandingSuppressed, listCollaborationRules, listUnderstandingEvidence, listUnderstandingStatusEvents, listUnderstandings, linkUnderstandingEvidence, recordContextFeedback, recordContextRun, rejectUnderstanding, reviseCollaborationRule, reviseUnderstanding, searchActiveUnderstandings, setCollaborationRuleStatus, setUnderstandingStatus, updateUserProfile, type CreateUnderstandingInput, type UnderstandingStatusEvent, } from './user-context-repository.js';
 export { getUserPerson, getUserPeopleIndexState, listUserPeople, mergeUserPeople, replaceUserPeopleIndex, summarizeUserPeople, updateUserPerson, } from './user-people-repository.js';
 export { cancelQueuedSessionInput, claimNextSessionInput, findSessionInput, finishSessionInputRun, getSessionInputState, getSessionInputById, insertSessionInput, listActiveSessionInputRuns, mutateQueuedSessionInput, recoverSessionInputState, setSessionInputStatus, type SessionInput, type SessionInputDelivery, type SessionInputState, type SessionInputStatus, } from './session-input-repository.js';
 export { replaceLatestSessionTurnAndQueueInput, validateLatestSessionTurnTarget, type ReplaceLatestSessionTurnInput, type ReplaceLatestSessionTurnResult, } from './session-turn-replace-repository.js';

package/dist/src/storage/sqlite/index.js

@@ -10,7 +10,7 @@ import { claimContextExtractionRun, finishContextExtractionRun, getContextExtrac
 import { closeTemporalAssertions, createTemporalAssertion, linkContextObjects, listContextObjectRelations, listTemporalAssertions } from "./context-relation-repository.js";
 import { finishContextConsolidationRun, getContextConsolidationRun, listContextConsolidationDecisions, listContextConsolidationRuns, recordContextConsolidationDecision, startContextConsolidationRun } from "./context-consolidation-repository.js";
 import { summarizeUnderstandingFeedback, summarizeUserUnderstandingQuality } from "./user-context-quality-repository.js";
-import { closeUnderstandingValidity, consumeContextConsent, createCollaborationRule, createContextEvidence, createUnderstanding, decideContextConsent, deleteCollaborationRule, deleteUnderstanding, ensureContextConsent, getCollaborationRule, getTurnPersonalization, getUnderstanding, getUserProfile, hasContextConsent, isUnderstandingSuppressed, linkUnderstandingEvidence, listCollaborationRules, listUnderstandingEvidence, listUnderstandings, recordContextFeedback, recordContextRun, rejectUnderstanding, reviseCollaborationRule, reviseUnderstanding, searchActiveUnderstandings, setCollaborationRuleStatus, setUnderstandingStatus, updateUserProfile } from "./user-context-repository.js";
+import { closeUnderstandingValidity, consumeContextConsent, createCollaborationRule, createContextEvidence, createUnderstanding, decideContextConsent, deleteCollaborationRule, deleteUnderstanding, ensureContextConsent, getCollaborationRule, getTurnPersonalization, getUnderstanding, getUserProfile, hasContextConsent, isUnderstandingSuppressed, linkUnderstandingEvidence, listCollaborationRules, listUnderstandingEvidence, listUnderstandingStatusEvents, listUnderstandings, recordContextFeedback, recordContextRun, rejectUnderstanding, reviseCollaborationRule, reviseUnderstanding, searchActiveUnderstandings, setCollaborationRuleStatus, setUnderstandingStatus, updateUserProfile } from "./user-context-repository.js";
 import { getUserPeopleIndexState, getUserPerson, listUserPeople, mergeUserPeople, replaceUserPeopleIndex, summarizeUserPeople, updateUserPerson } from "./user-people-repository.js";
 import { cancelQueuedSessionInput, claimNextSessionInput, findSessionInput, finishSessionInputRun, getSessionInputById, getSessionInputState, insertSessionInput, listActiveSessionInputRuns, mutateQueuedSessionInput, recoverSessionInputState, setSessionInputStatus } from "./session-input-repository.js";
 import { buildDefaultSessionMetadata } from "./session-metadata.js";
@@ -36,4 +36,4 @@ import { appendConnectorExecutionAudit, claimConnectorWebhookDelivery, completeC
 import { getConnectorAccount, listConnectorAccounts, reconcileConnectorAccount, refreshConnectorAccountCurrent } from "./connector-account-repository.js";
 import { getConnectorSyncPolicy, getConnectorSyncPolicyForConnection, listConnectorSyncPolicies, upsertConnectorSyncPolicy } from "./connector-sync-policy-repository.js";
 import { getUserTrustPolicy, setUserTrustPolicy } from "./user-trust-repository.js";
-export { COMPOSER_INPUT_HISTORY_LIMIT, DatabaseSchemaMigrationGapError, DatabaseSchemaTooNewError, SCHEMA_META_SCHEMA_VERSION_KEY, XOPC_DB_BASELINE_SCHEMA_VERSION, XOPC_DB_FILENAME, XOPC_DB_SCHEMA_VERSION, acknowledgeHomeAttention, appendCompactionBoundaryIfUnchanged, appendComposerInputHistory, appendConnectorExecutionAudit, appendMemorySignal, appendMemoryTraceEvent, appendTranscriptEntry, applyPendingMigrations, attachMemoryEvidence, bindEndpointPrincipal, buildDefaultSessionMetadata, buildGlobalSessionStats, buildRelationshipPrompt, cancelQueuedSessionInput, claimConnectorWebhookDelivery, claimContextExtractionRun, claimKnowledgeSourceItems, claimNextConnectorLearningJob, claimNextSessionInput, classifyStoredRow, clearComposerInputHistory, closeTemporalAssertions, closeUnderstandingValidity, closeXopcDatabase, completeConnectorWebhookDelivery, completeKnowledgeSourceItemSynthesis, consumeConnectorApproval, consumeContextConsent, countKnowledgeSourceItems, countMemoryRecordsBySourceInstanceId, createCollaborationRule, createConnectorApproval, createContextEvidence, createEndpointPrincipal, createObjectLinkRecord, createTemporalAssertion, createUnderstanding, decideConnectorApproval, decideContextConsent, deleteCollaborationRule, deleteConnectorConnection, deleteConnectorInstallation, deleteKnowledgeSourceItems, deleteMemoryEvidenceForRecord, deleteMemoryRecord, deleteMemoryRecordsBySourceInstanceId, deleteNoteAgentContextRecord, deleteNoteRecord, deleteObjectLinkRecord, deleteSessionConfig, deleteSessionRecord, deleteUnderstanding, discoverSqlMigrations, enqueueConnectorLearningJob, ensureContextConsent, ensureSessionRecord, ensureXopcDatabaseSchema, estimateTokensFromMessages, extractFtsContent, findSessionInput, findSessionKeyBySessionId, finishContextConsolidationRun, finishContextExtractionRun, finishEndpointToolInvocationAudit, finishKnowledgeSyncRun, finishSessionInputRun, getActivityEventRecord, getCachedConnectorCatalogEntry, getCollaborationRule, getConnectorAccount, getConnectorApproval, getConnectorConnection, getConnectorInstallation, getConnectorSyncPolicy, getConnectorSyncPolicyForConnection, getContextConsolidationRun, getContextExtractionRun, getCurrentSessionId, getEndpointPrincipal, getGlobalSessionStats, getInteractionState, getKnowledgeConsumerWatermark, getKnowledgeSourceCursor, getKnowledgeSourceItem, getMemoryProviderState, getMemoryRecord, getMemoryTurnFeedback, getNoteAgentContextRecord, getNoteRecord, getRelationshipSettings, getSessionConfig, getSessionInputById, getSessionInputState, getSessionMetadata, getSessionPersistedLevels, getSessionTaskPlan, getSqliteDatabase, getTurnPersonalization, getUnderstanding, getUserPeopleIndexState, getUserPerson, getUserProfile, getUserTrustPolicy, getXopcDatabase, hasContextConsent, hasIndependentExtractionOutput, hasSessionConfig, hasUnresolvedMemoryConflict, incrementSessionStatsOnAppend, insertSessionInput, inspectSchemaMigrationStatus, isHomeAttentionAcknowledged, isProactiveSupportAllowed, isUnderstandingSuppressed, isXopcDatabaseOpen, linkContextObjects, linkUnderstandingEvidence, listActiveSessionInputRuns, listActivityRecords, listCachedConnectorCatalogEntries, listCollaborationRules, listCompactionBoundaries, listComposerInputHistory, listConnectorAccounts, listConnectorActionMetadata, listConnectorApprovals, listConnectorConnections, listConnectorExecutionAudit, listConnectorInstallations, listConnectorLearningJobs, listConnectorSyncPolicies, listContextConsolidationDecisions, listContextConsolidationRuns, listContextExtractionOutputs, listContextExtractionRuns, listContextObjectRelations, listEndpointPrincipals, listEndpointToolInvocationAudits, listKnowledgeSourceChanges, listKnowledgeSourceItems, listKnowledgeSyncRuns, listMemoryEvidence, listMemoryRecords, listMemorySignals, listMemoryTraceEvents, listNoteRecords, listObjectActivityRecords, listObjectLinkRecords, listProjectActivityRecords, listRegisteredMigrationTargets, listSessionMetadata, listSessionsByAgent, listTemporalAssertions, listUnderstandingEvidence, listUnderstandings, listUserPeople, loadCompactionSourceSnapshot, loadLlmMessagesForSession, loadTranscriptHistoryRowsForSession, loadTranscriptRows, loadTranscriptRowsForSession, markMemoryRecordsConflicted, mergeUserPeople, metadataToSessionInsert, mutateQueuedSessionInput, openXopcDatabase, paginateTranscriptMessages, patchSessionMetadata, pruneBoundedKnowledgeSourceItems, readSchemaVersion, readSchemaVersionForTest, reconcileConnectorAccount, recordActivityEvent, recordContextConsolidationDecision, recordContextFeedback, recordContextRun, recoverSessionInputState, recoverStaleConnectorLearningJobs, refreshConnectorAccountCurrent, rejectUnderstanding, releaseConnectorWebhookDelivery, replaceConnectorCatalogEntries, replaceLatestSessionTurnAndQueueInput, replaceTranscriptRows, replaceUserPeopleIndex, requireXopcDatabase, resetSessionRecord, resetXopcDatabaseSingletonForTest, resolveMigrationsDir, resolveSessionAgentId, resolveXopcDatabasePath, restoreBeforeCompactionBoundary, reviseCollaborationRule, reviseUnderstanding, revokeEndpointPrincipal, runSqliteWriteTransaction, searchActiveUnderstandings, searchMemoryRecords, searchSessionTranscript, sessionConfigRowToConfig, sessionRowToMetadata, setCollaborationRuleStatus, setConnectorLearningPaused, setInteractionState, setKnowledgeConsumerWatermark, setKnowledgeSourceCursor, setKnowledgeSourceItemSynthesisStatus, setMemoryProviderState, setMemoryRecordStatus, setMemoryTurnFeedback, setSessionConfig, setSessionInputStatus, setSessionTaskPlan, setUnderstandingStatus, setUserTrustPolicy, startContextConsolidationRun, startEndpointToolInvocationAudit, startKnowledgeSyncRun, summarizeMemoryRecallFeedback, summarizeUnderstandingFeedback, summarizeUserPeople, summarizeUserUnderstandingQuality, touchEndpointPrincipal, transcriptEntryRowToStoredRow, updateConnectorLearningJob, updateInteractionStateFromMessage, updateRelationshipSettings, updateSessionConfig, updateSessionStats, updateUserPerson, updateUserProfile, upsertConnectorActionMetadata, upsertConnectorCatalogEntry, upsertConnectorConnection, upsertConnectorInstallation, upsertConnectorSyncPolicy, upsertKnowledgeSourceItems, upsertMemoryRecord, upsertNoteAgentContextRecord, upsertNoteRecord, validateLatestSessionTurnTarget };
+export { COMPOSER_INPUT_HISTORY_LIMIT, DatabaseSchemaMigrationGapError, DatabaseSchemaTooNewError, SCHEMA_META_SCHEMA_VERSION_KEY, XOPC_DB_BASELINE_SCHEMA_VERSION, XOPC_DB_FILENAME, XOPC_DB_SCHEMA_VERSION, acknowledgeHomeAttention, appendCompactionBoundaryIfUnchanged, appendComposerInputHistory, appendConnectorExecutionAudit, appendMemorySignal, appendMemoryTraceEvent, appendTranscriptEntry, applyPendingMigrations, attachMemoryEvidence, bindEndpointPrincipal, buildDefaultSessionMetadata, buildGlobalSessionStats, buildRelationshipPrompt, cancelQueuedSessionInput, claimConnectorWebhookDelivery, claimContextExtractionRun, claimKnowledgeSourceItems, claimNextConnectorLearningJob, claimNextSessionInput, classifyStoredRow, clearComposerInputHistory, closeTemporalAssertions, closeUnderstandingValidity, closeXopcDatabase, completeConnectorWebhookDelivery, completeKnowledgeSourceItemSynthesis, consumeConnectorApproval, consumeContextConsent, countKnowledgeSourceItems, countMemoryRecordsBySourceInstanceId, createCollaborationRule, createConnectorApproval, createContextEvidence, createEndpointPrincipal, createObjectLinkRecord, createTemporalAssertion, createUnderstanding, decideConnectorApproval, decideContextConsent, deleteCollaborationRule, deleteConnectorConnection, deleteConnectorInstallation, deleteKnowledgeSourceItems, deleteMemoryEvidenceForRecord, deleteMemoryRecord, deleteMemoryRecordsBySourceInstanceId, deleteNoteAgentContextRecord, deleteNoteRecord, deleteObjectLinkRecord, deleteSessionConfig, deleteSessionRecord, deleteUnderstanding, discoverSqlMigrations, enqueueConnectorLearningJob, ensureContextConsent, ensureSessionRecord, ensureXopcDatabaseSchema, estimateTokensFromMessages, extractFtsContent, findSessionInput, findSessionKeyBySessionId, finishContextConsolidationRun, finishContextExtractionRun, finishEndpointToolInvocationAudit, finishKnowledgeSyncRun, finishSessionInputRun, getActivityEventRecord, getCachedConnectorCatalogEntry, getCollaborationRule, getConnectorAccount, getConnectorApproval, getConnectorConnection, getConnectorInstallation, getConnectorSyncPolicy, getConnectorSyncPolicyForConnection, getContextConsolidationRun, getContextExtractionRun, getCurrentSessionId, getEndpointPrincipal, getGlobalSessionStats, getInteractionState, getKnowledgeConsumerWatermark, getKnowledgeSourceCursor, getKnowledgeSourceItem, getMemoryProviderState, getMemoryRecord, getMemoryTurnFeedback, getNoteAgentContextRecord, getNoteRecord, getRelationshipSettings, getSessionConfig, getSessionInputById, getSessionInputState, getSessionMetadata, getSessionPersistedLevels, getSessionTaskPlan, getSqliteDatabase, getTurnPersonalization, getUnderstanding, getUserPeopleIndexState, getUserPerson, getUserProfile, getUserTrustPolicy, getXopcDatabase, hasContextConsent, hasIndependentExtractionOutput, hasSessionConfig, hasUnresolvedMemoryConflict, incrementSessionStatsOnAppend, insertSessionInput, inspectSchemaMigrationStatus, isHomeAttentionAcknowledged, isProactiveSupportAllowed, isUnderstandingSuppressed, isXopcDatabaseOpen, linkContextObjects, linkUnderstandingEvidence, listActiveSessionInputRuns, listActivityRecords, listCachedConnectorCatalogEntries, listCollaborationRules, listCompactionBoundaries, listComposerInputHistory, listConnectorAccounts, listConnectorActionMetadata, listConnectorApprovals, listConnectorConnections, listConnectorExecutionAudit, listConnectorInstallations, listConnectorLearningJobs, listConnectorSyncPolicies, listContextConsolidationDecisions, listContextConsolidationRuns, listContextExtractionOutputs, listContextExtractionRuns, listContextObjectRelations, listEndpointPrincipals, listEndpointToolInvocationAudits, listKnowledgeSourceChanges, listKnowledgeSourceItems, listKnowledgeSyncRuns, listMemoryEvidence, listMemoryRecords, listMemorySignals, listMemoryTraceEvents, listNoteRecords, listObjectActivityRecords, listObjectLinkRecords, listProjectActivityRecords, listRegisteredMigrationTargets, listSessionMetadata, listSessionsByAgent, listTemporalAssertions, listUnderstandingEvidence, listUnderstandingStatusEvents, listUnderstandings, listUserPeople, loadCompactionSourceSnapshot, loadLlmMessagesForSession, loadTranscriptHistoryRowsForSession, loadTranscriptRows, loadTranscriptRowsForSession, markMemoryRecordsConflicted, mergeUserPeople, metadataToSessionInsert, mutateQueuedSessionInput, openXopcDatabase, paginateTranscriptMessages, patchSessionMetadata, pruneBoundedKnowledgeSourceItems, readSchemaVersion, readSchemaVersionForTest, reconcileConnectorAccount, recordActivityEvent, recordContextConsolidationDecision, recordContextFeedback, recordContextRun, recoverSessionInputState, recoverStaleConnectorLearningJobs, refreshConnectorAccountCurrent, rejectUnderstanding, releaseConnectorWebhookDelivery, replaceConnectorCatalogEntries, replaceLatestSessionTurnAndQueueInput, replaceTranscriptRows, replaceUserPeopleIndex, requireXopcDatabase, resetSessionRecord, resetXopcDatabaseSingletonForTest, resolveMigrationsDir, resolveSessionAgentId, resolveXopcDatabasePath, restoreBeforeCompactionBoundary, reviseCollaborationRule, reviseUnderstanding, revokeEndpointPrincipal, runSqliteWriteTransaction, searchActiveUnderstandings, searchMemoryRecords, searchSessionTranscript, sessionConfigRowToConfig, sessionRowToMetadata, setCollaborationRuleStatus, setConnectorLearningPaused, setInteractionState, setKnowledgeConsumerWatermark, setKnowledgeSourceCursor, setKnowledgeSourceItemSynthesisStatus, setMemoryProviderState, setMemoryRecordStatus, setMemoryTurnFeedback, setSessionConfig, setSessionInputStatus, setSessionTaskPlan, setUnderstandingStatus, setUserTrustPolicy, startContextConsolidationRun, startEndpointToolInvocationAudit, startKnowledgeSyncRun, summarizeMemoryRecallFeedback, summarizeUnderstandingFeedback, summarizeUserPeople, summarizeUserUnderstandingQuality, touchEndpointPrincipal, transcriptEntryRowToStoredRow, updateConnectorLearningJob, updateInteractionStateFromMessage, updateRelationshipSettings, updateSessionConfig, updateSessionStats, updateUserPerson, updateUserProfile, upsertConnectorActionMetadata, upsertConnectorCatalogEntry, upsertConnectorConnection, upsertConnectorInstallation, upsertConnectorSyncPolicy, upsertKnowledgeSourceItems, upsertMemoryRecord, upsertNoteAgentContextRecord, upsertNoteRecord, validateLatestSessionTurnTarget };

package/dist/src/storage/sqlite/migrations/137_understanding_status_audit.sql

@@ -0,0 +1,71 @@
+CREATE TABLE understanding_status_events (
+  event_id TEXT PRIMARY KEY,
+  understanding_id TEXT NOT NULL REFERENCES user_understandings(understanding_id) ON DELETE CASCADE,
+  from_status TEXT CHECK (from_status IS NULL OR from_status IN (
+    'candidate', 'active', 'needs_review', 'stale', 'archived', 'rejected'
+  )),
+  to_status TEXT NOT NULL CHECK (to_status IN (
+    'candidate', 'active', 'needs_review', 'stale', 'archived', 'rejected'
+  )),
+  actor_type TEXT NOT NULL CHECK (actor_type IN ('user', 'runtime', 'migration')),
+  source TEXT NOT NULL,
+  created_at INTEGER NOT NULL
+);
+
+CREATE INDEX idx_understanding_status_events_item
+  ON understanding_status_events(understanding_id, created_at DESC);
+
+INSERT INTO understanding_status_events (
+  event_id, understanding_id, from_status, to_status, actor_type, source, created_at
+)
+SELECT
+  lower(hex(randomblob(16))), understanding_id, NULL, status, 'migration', 'status-audit-baseline', updated_at
+FROM user_understandings;
+
+INSERT INTO understanding_status_events (
+  event_id, understanding_id, from_status, to_status, actor_type, source, created_at
+)
+SELECT
+  lower(hex(randomblob(16))), u.understanding_id, u.status, 'needs_review', 'migration',
+  'repair-untrusted-portrait-v1', CAST(strftime('%s', 'now') AS INTEGER) * 1000
+FROM user_understandings u
+JOIN user_understanding_versions v ON v.version_id = u.current_version_id
+WHERE u.status = 'active'
+  AND (
+    u.canonical_key LIKE 'connected:%'
+    OR u.canonical_key LIKE 'connected-semantic:%'
+    OR (u.canonical_key LIKE 'work-discovery:%' AND v.created_by <> 'user')
+    OR EXISTS (
+      SELECT 1
+      FROM understanding_evidence_links l
+      JOIN context_evidence e ON e.evidence_id = l.evidence_id
+      WHERE l.version_id = u.current_version_id
+        AND e.extractor_id IN ('connector-structural', 'connector-semantic', 'explicit-command')
+    )
+    OR (u.kind = 'task_lesson' AND length(v.statement) > 240)
+    OR (u.kind = 'boundary' AND (
+      v.statement LIKE '%不要再问%'
+      OR v.statement LIKE '%直接执行%'
+      OR lower(v.statement) LIKE '%do not ask%'
+      OR lower(v.statement) LIKE '%just do it%'
+    ))
+  );
+
+UPDATE user_understandings
+SET status = 'needs_review',
+    updated_at = CAST(strftime('%s', 'now') AS INTEGER) * 1000
+WHERE understanding_id IN (
+  SELECT understanding_id
+  FROM understanding_status_events
+  WHERE source = 'repair-untrusted-portrait-v1'
+);
+
+UPDATE context_temporal_assertions
+SET status = 'candidate',
+    updated_at = CAST(strftime('%s', 'now') AS INTEGER) * 1000
+WHERE object_type = 'understanding'
+  AND object_id IN (
+    SELECT understanding_id
+    FROM understanding_status_events
+    WHERE source = 'repair-untrusted-portrait-v1'
+  );

package/dist/src/storage/sqlite/migrations/runner.d.ts

@@ -3,7 +3,7 @@ import type { ApplyMigrationsOptions } from './types.js';
 /** Baseline schema version applied from schema.sql on first open. */
 export declare const XOPC_DB_BASELINE_SCHEMA_VERSION = 11;
 /** Latest schema version this release supports (increment when adding migrations). */
-export declare const XOPC_DB_SCHEMA_VERSION = 136;
+export declare const XOPC_DB_SCHEMA_VERSION = 137;
 export declare function resolveMigrationsDir(override?: string): string;
 /**
  * Apply sequential SQL migrations from (currentVersion + 1) through targetVersion.

package/dist/src/storage/sqlite/migrations/runner.js

@@ -12,7 +12,7 @@ const log = createLogger("Sqlite:Migrations");
 /** Baseline schema version applied from schema.sql on first open. */
 const XOPC_DB_BASELINE_SCHEMA_VERSION = 11;
 /** Latest schema version this release supports (increment when adding migrations). */
-const XOPC_DB_SCHEMA_VERSION = 136;
+const XOPC_DB_SCHEMA_VERSION = 137;
 const MODULE_DIR = dirname(fileURLToPath(import.meta.url));
 function backupBeforeTaskCutover(db, databasePath) {
 	db.exec("PRAGMA wal_checkpoint(FULL)");
@@ -57,7 +57,7 @@ function applySingleMigration(db, migration) {
 * Each step runs in its own transaction and updates schema_meta on success.
 */
 function applyPendingMigrations(db, options = {}) {
-	const targetVersion = options.targetVersion ?? 136;
+	const targetVersion = options.targetVersion ?? 137;
 	let currentVersion = readSchemaVersion(db);
 	if (currentVersion > targetVersion) throw new DatabaseSchemaTooNewError(currentVersion, targetVersion);
 	if (currentVersion >= targetVersion) return currentVersion;
@@ -94,7 +94,7 @@ function applyPendingMigrations(db, options = {}) {
 }
 /** Inspect schema version without mutating the database. */
 function inspectSchemaMigrationStatus(db, options = {}) {
-	const appVersion = options.targetVersion ?? 136;
+	const appVersion = options.targetVersion ?? 137;
 	const dbVersion = readSchemaVersion(db);
 	if (dbVersion > appVersion) return {
 		dbVersion,

package/dist/src/storage/sqlite/migrations/runner.ts

@@ -19,7 +19,7 @@ const log = createLogger('Sqlite:Migrations');
 export const XOPC_DB_BASELINE_SCHEMA_VERSION = 11;
 
 /** Latest schema version this release supports (increment when adding migrations). */
-export const XOPC_DB_SCHEMA_VERSION = 136;
+export const XOPC_DB_SCHEMA_VERSION = 137;
 
 const MODULE_DIR = dirname(fileURLToPath(import.meta.url));
 

package/dist/src/storage/sqlite/schema.js

@@ -32,7 +32,7 @@ function ensureXopcDatabaseSchema(db, options = {}) {
 		currentVersion = 11;
 	}
 	applyPendingMigrations(db, {
-		targetVersion: 136,
+		targetVersion: 137,
 		databasePath: options.databasePath
 	});
 }

package/dist/src/storage/sqlite/user-context-repository.d.ts

@@ -1,4 +1,13 @@
 import { type CollaborationRule, type ContextEvidence, type PersonalizationItem, type UnderstandingStatus, type UserContextScope, type UserProfile, type UserUnderstanding } from '../../user-context/domain.js';
+export type UnderstandingStatusEvent = {
+    id: string;
+    understandingId: string;
+    fromStatus?: UnderstandingStatus;
+    toStatus: UnderstandingStatus;
+    actorType: 'user' | 'runtime' | 'migration';
+    source: string;
+    createdAt: number;
+};
 export declare function getUserProfile(principalId?: string): UserProfile;
 export declare function updateUserProfile(patch: Partial<Pick<UserProfile, 'callName' | 'role' | 'primaryGoal' | 'pronouns' | 'timezone' | 'locale' | 'accessibility'>>, principalId?: string): UserProfile;
 export type CreateUnderstandingInput = Omit<UserUnderstanding, 'id' | 'versionId' | 'createdAt' | 'updatedAt' | 'statement' | 'payload'> & {
@@ -21,12 +30,15 @@ export declare function reviseUnderstanding(id: string, statement: string, optio
     confidence?: number;
     changeReason: string;
 }): UserUnderstanding;
-export declare function setUnderstandingStatus(id: string, status: UnderstandingStatus, confirmation?: {
-    explicitness: UserUnderstanding['explicitness'];
-    confidence: number;
+export declare function setUnderstandingStatus(id: string, status: UnderstandingStatus, options?: {
+    explicitness?: UserUnderstanding['explicitness'];
+    confidence?: number;
+    actorType?: UnderstandingStatusEvent['actorType'];
+    source?: string;
 }): UserUnderstanding;
 export declare function closeUnderstandingValidity(id: string, validTo?: number): UserUnderstanding;
-export declare function rejectUnderstanding(id: string, reason: string): UserUnderstanding;
+export declare function rejectUnderstanding(id: string, reason: string, actorType?: UnderstandingStatusEvent['actorType']): UserUnderstanding;
+export declare function listUnderstandingStatusEvents(id: string): UnderstandingStatusEvent[];
 export declare function deleteUnderstanding(id: string): boolean;
 export declare function isUnderstandingSuppressed(canonicalKey: string, scope: UserContextScope, principalId?: string): boolean;
 export declare function createCollaborationRule(input: Pick<CollaborationRule, 'category' | 'priority' | 'scope' | 'conditions' | 'statement'>, principalId?: string): CollaborationRule;