@xopcai/xopc 0.0.228 → 0.0.229

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 = "";

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/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;

package/dist/src/storage/sqlite/user-context-repository.js

@@ -4,6 +4,11 @@ import { retrievalQueryAuditValue } from "../../retrieval/audit.js";
 import { buildFts5SearchQuery, fts5RankToScore } from "./fts.js";
 import { createHash, randomUUID } from "node:crypto";
 //#region src/storage/sqlite/user-context-repository.ts
+function insertUnderstandingStatusEvent(db, input) {
+	db.prepare(`INSERT INTO understanding_status_events (
+    event_id, understanding_id, from_status, to_status, actor_type, source, created_at
+  ) VALUES (?, ?, ?, ?, ?, ?, ?)`).run(randomUUID(), input.understandingId, input.fromStatus ?? null, input.toStatus, input.actorType, input.source, input.createdAt);
+}
 function evidenceFromRow(row) {
 	return {
 		id: row.evidence_id,
@@ -144,6 +149,13 @@ function createUnderstanding(input, principalId = USER_CONTEXT_PRINCIPAL_ID) {
       version_id, understanding_id, statement, payload_json, created_by, change_reason, created_at
     ) VALUES (?, ?, ?, ?, ?, ?, ?)`).run(versionId, id, input.statement.trim(), JSON.stringify(input.payload ?? {}), input.createdBy, input.changeReason, now);
 		db.prepare("INSERT INTO user_understanding_fts (statement, understanding_id, version_id) VALUES (?, ?, ?)").run(input.statement.trim(), id, versionId);
+		insertUnderstandingStatusEvent(db, {
+			understandingId: id,
+			toStatus: input.status,
+			actorType: input.createdBy === "user" ? "user" : "runtime",
+			source: `create:${input.changeReason}`,
+			createdAt: now
+		});
 	});
 	return getUnderstanding(id);
 }
@@ -197,17 +209,29 @@ function reviseUnderstanding(id, statement, options) {
 	});
 	return getUnderstanding(id);
 }
-function setUnderstandingStatus(id, status, confirmation) {
+function setUnderstandingStatus(id, status, options) {
+	const current = getUnderstanding(id);
+	if (!current) throw new Error(`User understanding not found: ${id}`);
 	const now = Date.now();
-	getSqliteDatabase().prepare(`UPDATE user_understandings
-    SET status = ?,
-        explicitness = COALESCE(?, explicitness),
-        confidence = COALESCE(?, confidence),
-        updated_at = ?
-    WHERE understanding_id = ?`).run(status, confirmation?.explicitness ?? null, confirmation?.confidence ?? null, now, id);
-	const assertionStatus = status === "active" ? "active" : status === "archived" ? "closed" : status === "rejected" ? "rejected" : "candidate";
-	getSqliteDatabase().prepare(`UPDATE context_temporal_assertions
-    SET status = ?, updated_at = ? WHERE object_type = 'understanding' AND object_id = ?`).run(assertionStatus, now, id);
+	runSqliteWriteTransaction((db) => {
+		db.prepare(`UPDATE user_understandings
+      SET status = ?,
+          explicitness = COALESCE(?, explicitness),
+          confidence = COALESCE(?, confidence),
+          updated_at = ?
+      WHERE understanding_id = ?`).run(status, options?.explicitness ?? null, options?.confidence ?? null, now, id);
+		const assertionStatus = status === "active" ? "active" : status === "archived" ? "closed" : status === "rejected" ? "rejected" : "candidate";
+		db.prepare(`UPDATE context_temporal_assertions
+      SET status = ?, updated_at = ? WHERE object_type = 'understanding' AND object_id = ?`).run(assertionStatus, now, id);
+		if (current.status !== status) insertUnderstandingStatusEvent(db, {
+			understandingId: id,
+			fromStatus: current.status,
+			toStatus: status,
+			actorType: options?.actorType ?? "runtime",
+			source: options?.source ?? "repository-status-change",
+			createdAt: now
+		});
+	});
 	const result = getUnderstanding(id);
 	if (!result) throw new Error(`User understanding not found: ${id}`);
 	return result;
@@ -219,12 +243,20 @@ function closeUnderstandingValidity(id, validTo = Date.now()) {
 	if (!result) throw new Error(`User understanding not found: ${id}`);
 	return result;
 }
-function rejectUnderstanding(id, reason) {
+function rejectUnderstanding(id, reason, actorType = "runtime") {
 	const current = getUnderstanding(id);
 	if (!current) throw new Error(`User understanding not found: ${id}`);
 	const now = Date.now();
 	runSqliteWriteTransaction((db) => {
 		db.prepare("UPDATE user_understandings SET status = 'rejected', updated_at = ? WHERE understanding_id = ?").run(now, id);
+		if (current.status !== "rejected") insertUnderstandingStatusEvent(db, {
+			understandingId: id,
+			fromStatus: current.status,
+			toStatus: "rejected",
+			actorType,
+			source: reason,
+			createdAt: now
+		});
 		db.prepare(`INSERT INTO context_suppressions (
       suppression_id, principal_id, canonical_key, scope_type, scope_id, reason, expires_at, created_at
     ) VALUES (?, ?, ?, ?, ?, ?, NULL, ?)
@@ -232,6 +264,18 @@ function rejectUnderstanding(id, reason) {
 	});
 	return getUnderstanding(id);
 }
+function listUnderstandingStatusEvents(id) {
+	return getSqliteDatabase().prepare(`SELECT * FROM understanding_status_events
+    WHERE understanding_id = ? ORDER BY created_at DESC, rowid DESC`).all(id).map((row) => ({
+		id: row.event_id,
+		understandingId: row.understanding_id,
+		...row.from_status ? { fromStatus: row.from_status } : {},
+		toStatus: row.to_status,
+		actorType: row.actor_type,
+		source: row.source,
+		createdAt: row.created_at
+	}));
+}
 function deleteUnderstanding(id) {
 	return runSqliteWriteTransaction((db) => {
 		db.prepare("DELETE FROM user_understanding_fts WHERE understanding_id = ?").run(id);
@@ -442,4 +486,4 @@ function decideContextConsent(id, decision) {
 	return Number(result.changes) > 0;
 }
 //#endregion
-export { 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 };
+export { 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 };

package/dist/src/user-context/config.d.ts

@@ -96,6 +96,10 @@ export declare const UserMemoryConfigSchema: z.ZodDefault<z.ZodObject<{
 }, z.core.$strict>>;
 export declare const UserUnderstandingConfigSchema: z.ZodDefault<z.ZodObject<{
     enabled: z.ZodDefault<z.ZodBoolean>;
+    processingPolicy: z.ZodDefault<z.ZodEnum<{
+        local_only: "local_only";
+        remote_allowed: "remote_allowed";
+    }>>;
     adaptiveCadence: z.ZodDefault<z.ZodBoolean>;
     reviewIntervalTurns: z.ZodDefault<z.ZodNumber>;
     maxHistoryMessages: z.ZodDefault<z.ZodNumber>;
@@ -204,6 +208,10 @@ export declare const UserContextConfigSchema: z.ZodDefault<z.ZodObject<{
     }, z.core.$strict>>;
     understanding: z.ZodDefault<z.ZodObject<{
         enabled: z.ZodDefault<z.ZodBoolean>;
+        processingPolicy: z.ZodDefault<z.ZodEnum<{
+            local_only: "local_only";
+            remote_allowed: "remote_allowed";
+        }>>;
         adaptiveCadence: z.ZodDefault<z.ZodBoolean>;
         reviewIntervalTurns: z.ZodDefault<z.ZodNumber>;
         maxHistoryMessages: z.ZodDefault<z.ZodNumber>;

package/dist/src/user-context/config.js

@@ -91,12 +91,14 @@ var init_config = __esmMin((() => {
 	});
 	UserUnderstandingConfigSchema = z.object({
 		enabled: z.boolean().default(true),
+		processingPolicy: z.enum(["local_only", "remote_allowed"]).default("remote_allowed"),
 		adaptiveCadence: z.boolean().default(true),
 		reviewIntervalTurns: z.number().int().min(1).max(1e3).default(10),
 		maxHistoryMessages: z.number().int().min(1).max(200).default(80),
 		maxDurationMs: z.number().int().min(1e3).max(6e5).default(12e4)
 	}).strict().default({
 		enabled: true,
+		processingPolicy: "remote_allowed",
 		adaptiveCadence: true,
 		reviewIntervalTurns: 10,
 		maxHistoryMessages: 80,
@@ -161,6 +163,7 @@ var init_config = __esmMin((() => {
 		},
 		understanding: {
 			enabled: true,
+			processingPolicy: "remote_allowed",
 			adaptiveCadence: true,
 			reviewIntervalTurns: 10,
 			maxHistoryMessages: 80,

package/dist/src/user-context/consolidation.js

@@ -97,7 +97,10 @@ async function runContextConsolidation(input) {
 			const evidenceCount = distinctEvidenceCount(understanding.id, "supports");
 			const contradictionCount = distinctEvidenceCount(understanding.id, "contradicts");
 			if (understanding.validTo != null && understanding.validTo <= now || understanding.expiresAt != null && understanding.expiresAt <= now) {
-				setUnderstandingStatus(understanding.id, "stale");
+				setUnderstandingStatus(understanding.id, "stale", {
+					actorType: "runtime",
+					source: "consolidation-expired"
+				});
 				recordContextConsolidationDecision({
 					runId: run.runId,
 					understandingId: understanding.id,
@@ -110,7 +113,10 @@ async function runContextConsolidation(input) {
 				continue;
 			}
 			if (contradictionCount > 0) {
-				setUnderstandingStatus(understanding.id, "needs_review");
+				setUnderstandingStatus(understanding.id, "needs_review", {
+					actorType: "runtime",
+					source: "consolidation-contradiction"
+				});
 				recordContextConsolidationDecision({
 					runId: run.runId,
 					understandingId: understanding.id,
@@ -123,7 +129,10 @@ async function runContextConsolidation(input) {
 				continue;
 			}
 			if (understanding.status === "active" && understanding.reviewAt != null && understanding.reviewAt <= now) {
-				setUnderstandingStatus(understanding.id, "needs_review");
+				setUnderstandingStatus(understanding.id, "needs_review", {
+					actorType: "runtime",
+					source: "consolidation-review-due"
+				});
 				recordContextConsolidationDecision({
 					runId: run.runId,
 					understandingId: understanding.id,
@@ -136,7 +145,10 @@ async function runContextConsolidation(input) {
 				continue;
 			}
 			if (understanding.status === "candidate" && evidenceCount >= resolved.minEvidenceSources) {
-				setUnderstandingStatus(understanding.id, "needs_review");
+				setUnderstandingStatus(understanding.id, "needs_review", {
+					actorType: "runtime",
+					source: "consolidation-evidence-threshold"
+				});
 				recordContextConsolidationDecision({
 					runId: run.runId,
 					understandingId: understanding.id,

package/dist/src/user-context/extraction/executor.d.ts

@@ -0,0 +1,22 @@
+import type { Config } from '../../config/schema.js';
+import type { MemoryManager } from '../../agent/memory/manager.js';
+import type { UnderstandingReviewResult } from '../../agent/memory/understanding/types.js';
+import { type ExtractorId } from './registry.js';
+import type { SemanticEvidence, SemanticUnderstandingInterpretation } from './semantic.js';
+export type UnderstandingEvidenceMessage = SemanticEvidence & {
+    createdAt: number;
+    message: unknown;
+};
+export declare function emptyUnderstandingReview(): UnderstandingReviewResult;
+export declare function executeUnderstandingInterpretation(params: {
+    interpretation: SemanticUnderstandingInterpretation;
+    evidence: UnderstandingEvidenceMessage[];
+    extractionRunId: string;
+    extractorId: ExtractorId;
+    sessionKey: string;
+    turnId?: string;
+    memoryManager: MemoryManager;
+    getConfig: () => Config | undefined;
+    reviewSource: 'turn' | 'background';
+    processingPolicy: 'local_only' | 'remote_allowed';
+}): Promise<UnderstandingReviewResult>;