@xopcai/xopc 0.0.255 → 0.0.257

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

@@ -57,7 +57,7 @@ function connectedItemsForUnderstanding(items) {
 	});
 }
 function isPortraitCandidate(candidate) {
-	return candidate.category === "preference" || candidate.category === "routine";
+	return candidate.category === "preference" || candidate.category === "routine" || candidate.category === "communication";
 }
 function durableEvidence(candidate, items) {
 	const evidence = [...new Set(candidate.evidenceRefs ?? [])].flatMap((ref) => items.get(ref) ?? []);
@@ -120,7 +120,7 @@ async function deriveConnectedSourceUnderstanding(input) {
 						type: "agent",
 						id: input.agentId
 					},
-					kind: candidate.category,
+					kind: candidate.category === "communication" ? "preference" : candidate.category,
 					value: candidate.statement,
 					normalizedValue: candidate.statement.toLocaleLowerCase(),
 					statement: candidate.statement,
@@ -129,8 +129,8 @@ async function deriveConnectedSourceUnderstanding(input) {
 					inferredImportance: .65,
 					consequence: "medium",
 					actionability: .6,
-					volatility: candidate.category === "routine" ? "slow" : "stable",
-					sensitivity: "personal",
+					volatility: candidate.category === "routine" || candidate.category === "communication" ? "slow" : "stable",
+					sensitivity: "normal",
 					disclosurePolicy: "referenceable",
 					observedAt: evidenceItem.occurredAt ?? evidenceItem.modifiedAt ?? Date.now(),
 					createdBy: "connector",

package/dist/src/gateway/agent-builtin-tools.d.ts

@@ -174,6 +174,12 @@ export declare const GATEWAY_BUILTIN_TOOLS: readonly [{
         readonly en: "Read a typed user assertion.";
         readonly zh: "读取一条结构化用户事实。";
     };
+}, {
+    readonly id: "user_context_update";
+    readonly description: {
+        readonly en: "Apply an explicit user correction to an existing assertion.";
+        readonly zh: "根据用户明确表达修正已有用户理解。";
+    };
 }, {
     readonly id: "knowledge_search";
     readonly description: {
@@ -265,4 +271,4 @@ export declare const GATEWAY_BUILTIN_TOOLS: readonly [{
         readonly zh: "使用已验证的参数执行选定的外部工具。";
     };
 }];
-export declare const GATEWAY_BUILTIN_TOOL_IDS: ("automation" | "workflow" | "find" | "image" | "web_search" | "web_fetch" | "browser_use" | "grep" | "session_search" | "read_file" | "list_dir" | "write_file" | "apply_patch" | "exec_command" | "update_plan" | "todo" | "clarify" | "web_extract" | "image_generate" | "skills_list" | "skill_view" | "skill_manage" | "skills_marketplace_search" | "xopc_tool_search" | "xopc_tool_describe" | "xopc_tool_execute" | "user_context_search" | "user_context_get" | "knowledge_search" | "knowledge_get" | "knowledge_write" | "send_message" | "send_media" | "read_media" | "create_share" | "session_status" | "memory_maintenance" | "tool_manual" | "delegate_task" | "skill_install" | "text_to_speech" | "execute_code" | "create_desktop_pet")[];
+export declare const GATEWAY_BUILTIN_TOOL_IDS: ("automation" | "workflow" | "find" | "image" | "web_search" | "web_fetch" | "browser_use" | "grep" | "session_search" | "read_file" | "list_dir" | "write_file" | "apply_patch" | "exec_command" | "update_plan" | "todo" | "clarify" | "web_extract" | "image_generate" | "skills_list" | "skill_view" | "skill_manage" | "skills_marketplace_search" | "xopc_tool_search" | "xopc_tool_describe" | "xopc_tool_execute" | "user_context_search" | "user_context_get" | "user_context_update" | "knowledge_search" | "knowledge_get" | "knowledge_write" | "send_message" | "send_media" | "read_media" | "create_share" | "session_status" | "memory_maintenance" | "tool_manual" | "delegate_task" | "skill_install" | "text_to_speech" | "execute_code" | "create_desktop_pet")[];

package/dist/src/gateway/agent-builtin-tools.js

@@ -199,6 +199,13 @@ const GATEWAY_BUILTIN_TOOLS = [
 			zh: "读取一条结构化用户事实。"
 		}
 	},
+	{
+		id: "user_context_update",
+		description: {
+			en: "Apply an explicit user correction to an existing assertion.",
+			zh: "根据用户明确表达修正已有用户理解。"
+		}
+	},
 	{
 		id: "knowledge_search",
 		description: {

package/dist/src/gateway/hono/routes/user-model.js

@@ -2,11 +2,14 @@ import { createCollaborationRule, getCollaborationRule, listCollaborationRules,
 import { getKnowledgeItem, listKnowledgeItems, searchKnowledgeItems, setKnowledgeStatus } from "../../../knowledge-memory/repository.js";
 import "../../../knowledge-memory/index.js";
 import { createPriorityWindow, createUserGoal, listPriorityWindows, listUserGoals, setUserGoalStatus } from "../../../user-model/goals.js";
-import { getActiveAssertionForSlot, getAssertionSlot, getUserAssertion, listUserAssertions, reconcileAssertion, setAssertionStatus } from "../../../user-model/repository.js";
+import { getAssertionSlot, getUserAssertion, listUserAssertions, reconcileAssertion, setAssertionStatus } from "../../../user-model/repository.js";
+import { applyUserProfilePatch, getUserProfileSnapshot } from "../../../user-model/profile.js";
+import { bootstrapUserModel } from "../../../user-model/bootstrap.js";
 import "../../../user-model/index.js";
 import { listMemoryMaintenanceRuns } from "../../../memory-maintenance/service.js";
 import "../../../memory-maintenance/index.js";
 import { getExecutionContextAudit, recordExecutionContextFeedback } from "../../../agent/context/audit.js";
+import { userInfo } from "node:os";
 //#region src/gateway/hono/routes/user-model.ts
 function object(value) {
 	return value && typeof value === "object" && !Array.isArray(value) ? value : void 0;
@@ -50,6 +53,19 @@ function subject(value) {
 function errorMessage(error) {
 	return error instanceof Error ? error.message : String(error);
 }
+function machineCallName() {
+	try {
+		const username = userInfo().username.trim();
+		return [
+			"root",
+			"admin",
+			"administrator",
+			"user"
+		].includes(username.toLocaleLowerCase()) ? "" : username.slice(0, 100);
+	} catch {
+		return "";
+	}
+}
 const ASSERTION_STATUSES = new Set([
 	"candidate",
 	"active",
@@ -86,65 +102,6 @@ const RULE_STATUSES = new Set([
 	"disabled",
 	"archived"
 ]);
-function profileAssertion(predicate) {
-	return getActiveAssertionForSlot({
-		subject: {
-			type: "user",
-			id: "self"
-		},
-		predicate,
-		scope: { type: "global" }
-	});
-}
-function profileValue(predicate) {
-	return profileAssertion(predicate)?.value;
-}
-function profileSnapshot() {
-	return {
-		callName: profileValue("identity.call_name"),
-		pronouns: profileValue("identity.pronouns"),
-		timezone: profileValue("preference.timezone"),
-		locale: profileValue("preference.locale"),
-		role: profileValue("identity.role")
-	};
-}
-const PROFILE_FIELDS = {
-	callName: {
-		predicate: "identity.call_name",
-		kind: "identity",
-		volatility: "stable",
-		importance: .95,
-		statement: (value) => `The user prefers to be called ${value}.`
-	},
-	role: {
-		predicate: "identity.role",
-		kind: "identity",
-		volatility: "slow",
-		importance: .9,
-		statement: (value) => `The user's role is ${value}.`
-	},
-	pronouns: {
-		predicate: "identity.pronouns",
-		kind: "identity",
-		volatility: "stable",
-		importance: .75,
-		statement: (value) => `The user's pronouns are ${value}.`
-	},
-	timezone: {
-		predicate: "preference.timezone",
-		kind: "preference",
-		volatility: "slow",
-		importance: .85,
-		statement: (value) => `The user's timezone is ${value}.`
-	},
-	locale: {
-		predicate: "preference.locale",
-		kind: "preference",
-		volatility: "slow",
-		importance: .85,
-		statement: (value) => `The user's language and locale are ${value}.`
-	}
-};
 function assertionView(assertion) {
 	const slot = getAssertionSlot(assertion.slotId);
 	if (!slot) throw new Error(`Assertion slot not found: ${assertion.slotId}`);
@@ -174,6 +131,7 @@ function registerUserModelRoutes(authenticated, deps) {
 			recordClass: "memory",
 			limit: 1e3
 		});
+		const profile = getUserProfileSnapshot();
 		return c.json({
 			assertions,
 			goals,
@@ -181,7 +139,8 @@ function registerUserModelRoutes(authenticated, deps) {
 			rules: listCollaborationRules(),
 			knowledge,
 			maintenance: { lastRun: listMemoryMaintenanceRuns(1)[0] ?? null },
-			profile: profileSnapshot(),
+			profile,
+			suggestedCallName: profile.callName || machineCallName(),
 			counts: {
 				activeAssertions: assertions.filter((item) => item.status === "active").length,
 				reviewAssertions: assertions.filter((item) => item.status === "needs_review" || item.status === "conflicted").length,
@@ -194,48 +153,38 @@ function registerUserModelRoutes(authenticated, deps) {
 	authenticated.patch("/api/user-model/profile", write, async (c) => {
 		const input = await body(c);
 		if (!input) return c.json({ error: "A profile patch is required" }, 400);
-		const entries = Object.entries(PROFILE_FIELDS).filter(([key]) => Object.hasOwn(input, key));
-		if (!entries.length || entries.some(([key]) => typeof input[key] !== "string")) return c.json({ error: "Profile fields must be strings" }, 400);
+		const entries = [
+			"callName",
+			"role",
+			"pronouns",
+			"timezone",
+			"locale"
+		].filter((key) => Object.hasOwn(input, key));
+		if (!entries.length || entries.some((key) => typeof input[key] !== "string")) return c.json({ error: "Profile fields must be strings" }, 400);
 		try {
-			const now = Date.now();
-			for (const [key, field] of entries) {
-				const value = input[key].trim();
-				const current = profileAssertion(field.predicate);
-				if (!value) {
-					if (current) setAssertionStatus(current.id, "archived", {
-						actor: "user",
-						reason: "Profile field cleared by user.",
-						now
-					});
-					continue;
-				}
-				reconcileAssertion({
-					subject: {
-						type: "user",
-						id: "self"
-					},
-					predicate: field.predicate,
-					cardinality: "single",
-					scope: { type: "global" },
-					kind: field.kind,
-					value,
-					normalizedValue: value.toLocaleLowerCase(),
-					statement: field.statement(value),
-					authority: "user_explicit",
-					confidence: 1,
-					declaredImportance: field.importance,
-					inferredImportance: field.importance,
-					consequence: "medium",
-					actionability: .9,
-					volatility: field.volatility,
-					sensitivity: "normal",
-					disclosurePolicy: "referenceable",
-					observedAt: now,
-					createdBy: "user",
-					...current ? { correctionOfAssertionId: current.id } : {}
-				});
-			}
-			return c.json({ profile: profileSnapshot() });
+			return c.json({ profile: applyUserProfilePatch(Object.fromEntries(entries.map((key) => [key, input[key]]))) });
+		} catch (error) {
+			return c.json({ error: errorMessage(error) }, 400);
+		}
+	});
+	authenticated.post("/api/user-model/bootstrap", write, async (c) => {
+		const input = await body(c);
+		const profile = object(input?.profile);
+		const listFields = [
+			"responsibilities",
+			"goals",
+			"communicationPreferences",
+			"boundaries",
+			"relationships"
+		];
+		const validProfile = profile && Object.values(profile).every((value) => typeof value === "string");
+		const validLists = listFields.every((key) => input?.[key] === void 0 || Array.isArray(input[key]) && input[key].every((value) => typeof value === "string"));
+		if (!input || !validProfile || !validLists) return c.json({ error: "profile and string-list user-model fields are required" }, 400);
+		try {
+			return c.json(bootstrapUserModel({
+				profile,
+				...Object.fromEntries(listFields.flatMap((key) => input[key] === void 0 ? [] : [[key, input[key]]]))
+			}), 201);
 		} catch (error) {
 			return c.json({ error: errorMessage(error) }, 400);
 		}

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

@@ -9,8 +9,8 @@ import { resolveWorkflowRunArtifactsDir } from "../../../workflows/store/paths.j
 import { WorkflowDraftService } from "../../../workflows/draft/workflow-draft-service.js";
 import { WorkflowDraftConflictError, WorkflowDraftStore } from "../../../workflows/authoring/workflow-draft-store.js";
 import "../../../workflows/authoring/index.js";
-import { ProjectWorkflowPresetRepository } from "../../../workflows/project-presets/project-workflow-preset-repository.js";
 import "../../../workflows/draft/index.js";
+import { ProjectWorkflowPresetRepository } from "../../../workflows/project-presets/project-workflow-preset-repository.js";
 import { basename, join } from "node:path";
 import { readFile, stat } from "node:fs/promises";
 //#region src/gateway/hono/routes/workflows.ts
@@ -103,7 +103,8 @@ function registerWorkflowRoutes(authenticated, deps) {
 		const body = await readJsonBody(c.req.raw);
 		const result = validateWorkflowDefinitionInput({
 			name: body.name,
-			graph: body.graph
+			graph: body.graph,
+			manifest: body.manifest
 		});
 		return c.json(result);
 	});
@@ -132,7 +133,8 @@ function registerWorkflowRoutes(authenticated, deps) {
 		if (body.expectedRevision !== 0) return c.json({ error: "expectedRevision must be 0 when creating a workflow" }, 400);
 		const validation = validateWorkflowDefinitionInput({
 			name: body.name,
-			graph: body.graph
+			graph: body.graph,
+			manifest: body.manifest
 		});
 		if (!validation.valid) return c.json({
 			error: validation.errors[0]?.message ?? "Invalid workflow definition",
@@ -171,7 +173,8 @@ function registerWorkflowRoutes(authenticated, deps) {
 		if (!Number.isSafeInteger(body.expectedRevision) || body.expectedRevision < 1) return c.json({ error: "expectedRevision is required" }, 400);
 		const validation = validateWorkflowDefinitionInput({
 			name: id,
-			graph: body.graph
+			graph: body.graph,
+			manifest: body.manifest
 		});
 		if (!validation.valid) return c.json({
 			error: validation.errors[0]?.message ?? "Invalid workflow definition",

package/dist/src/gateway/service.js

@@ -21,9 +21,6 @@ import { loadConfig, saveConfig } from "../config/loader.js";
 import { buildSessionKey, init_session_key, sanitizeSegment } from "../routing/session-key.js";
 import { getDefaultAgentId, init_resolve_route } from "../routing/resolve-route.js";
 import { init_providers, providers_exports } from "../providers/index.js";
-import { AutomationService } from "../automations/service/automation-service.js";
-import { onAutomationProductEvent, publishAutomationProductEvent } from "../automations/product-events.js";
-import "../automations/index.js";
 import { resolveEffectiveAgentProfileForSession } from "../config/agent-profile.js";
 import { TaskRepository } from "../tasks/task-repository.js";
 import { TaskConversationRepository } from "../tasks/task-conversation-repository.js";
@@ -34,6 +31,9 @@ import { resolveProjectAgentId } from "../projects/project-agent.js";
 import "../projects/index.js";
 import { resolveEffectiveGatewayPort } from "./host.js";
 import { onSessionTranscriptUpdate } from "../session/transcript-events.js";
+import { AutomationService } from "../automations/service/automation-service.js";
+import { onAutomationProductEvent, publishAutomationProductEvent } from "../automations/product-events.js";
+import "../automations/index.js";
 import { TaskApplicationService } from "../tasks/task-application-service.js";
 import { ProactiveScenarioService } from "../proactive/scenarios/service.js";
 import { TaskOutboxDispatcher } from "../tasks/task-outbox-dispatcher.js";
@@ -54,12 +54,6 @@ import { registerClarificationChannelRuntime } from "./clarify-runtime.js";
 import { ChannelManager } from "../channels/manager.js";
 import { getWorkspacePath } from "../config/workspace-path-helpers.js";
 import "../config/index.js";
-import { DiscussionService } from "../discussions/service.js";
-import { DiscussionOrganizer } from "../discussions/organizer.js";
-import { DiscussionLiveWorker } from "../discussions/live-worker.js";
-import { DiscussionOrganizerWorker } from "../discussions/organizer-worker.js";
-import { DiscussionSealer } from "../discussions/sealer.js";
-import "../discussions/index.js";
 import { ManagedComposioEventPoller } from "../connectors/composio-managed-events.js";
 import { startConnectedKnowledgeCoordinator } from "../knowledge/coordinator.js";
 import "../knowledge/index.js";
@@ -67,6 +61,12 @@ import { ConnectionRecoveryService } from "../connectors/connection-recovery-ser
 import { startConnectorLearningCoordinator } from "../connectors/learning-coordinator.js";
 import { ConnectedSourceChangePublisher } from "../connectors/source-change-publisher.js";
 import { startConnectorSupervisor } from "../connectors/supervisor.js";
+import { DiscussionService } from "../discussions/service.js";
+import { DiscussionOrganizer } from "../discussions/organizer.js";
+import { DiscussionLiveWorker } from "../discussions/live-worker.js";
+import { DiscussionOrganizerWorker } from "../discussions/organizer-worker.js";
+import { DiscussionSealer } from "../discussions/sealer.js";
+import "../discussions/index.js";
 import { EndpointToolRuntime } from "../endpoint-tools/runtime.js";
 import "../endpoint-tools/index.js";
 import { assertGatewayAuthConfigured, extractToken, resolveGatewayAuth, validateToken } from "./auth.js";

package/dist/src/notifications/planner.js

@@ -153,11 +153,46 @@ function proactivePlan(payload) {
 		}
 	};
 }
+function workDiscoveryPlan(eventType, payload) {
+	if (!payload || typeof payload !== "object") return null;
+	const event = payload;
+	const completed = eventType === "work-discovery.completed";
+	if (typeof event.runId !== "string" || !event.runId || typeof event.sessionKey !== "string" || !event.sessionKey || event.status !== (completed ? "completed" : "failed")) return null;
+	const type = completed ? "work_discovery.review_ready" : "work_discovery.failed";
+	return {
+		dedupeKey: `${type}:${event.runId}`,
+		notification: {
+			type,
+			target: {
+				kind: "work_discovery",
+				runId: event.runId,
+				sessionKey: event.sessionKey
+			},
+			priority: completed ? "normal" : "high",
+			title: completed ? {
+				en: "Understanding ready for review",
+				zh: "用户理解已可确认"
+			} : {
+				en: "Understanding needs attention",
+				zh: "用户理解需要处理"
+			},
+			body: completed ? {
+				en: "Review what xopc learned about your work.",
+				zh: "查看并确认 xopc 对你工作的理解。"
+			} : {
+				en: "Open user understanding to review or retry.",
+				zh: "打开用户理解，查看详情或重试。"
+			},
+			payload: { runId: event.runId }
+		}
+	};
+}
 function notificationPlanFromGatewayEvent(type, payload) {
 	if (type === "agent.run.ended") return chatPlan(payload);
 	if (type === "task.attention_required.v2" || type === "task.phase_changed.v2") return taskPlan(payload);
 	if (type === "automation.run.completed") return automationPlan(payload);
 	if (type === "proactive.inbox.created") return proactivePlan(payload);
+	if (type === "work-discovery.completed" || type === "work-discovery.failed") return workDiscoveryPlan(type, payload);
 	return null;
 }
 //#endregion

package/dist/src/notifications/service.js

@@ -29,6 +29,8 @@ function preferenceAllows(type, preferences) {
 		case "automation.completed": return preferences.automationCompleted;
 		case "automation.failed": return preferences.automationFailed;
 		case "proactive.insight": return preferences.proactiveInsight;
+		case "work_discovery.review_ready":
+		case "work_discovery.failed": return true;
 	}
 }
 function retryAt(attempts, now) {

package/dist/src/tasks/home-query-service.js

@@ -2,10 +2,10 @@ import { isHomeAttentionAcknowledged } from "../storage/sqlite/home-attention-re
 import { getRelationshipSettings } from "../storage/sqlite/relationship-settings-repository.js";
 import { listConnectorApprovals } from "../storage/sqlite/connector-repository.js";
 import "../storage/sqlite/index.js";
-import "../automations/domain/defaults.js";
-import "../automations/index.js";
 import { TaskRepository } from "./task-repository.js";
 import { TaskReadModelProjector } from "./task-read-model-projector.js";
+import "../automations/domain/defaults.js";
+import "../automations/index.js";
 import { AttentionGovernor } from "./attention-governor.js";
 import { listGatewayAgents } from "../gateway/agents-admin.js";
 //#region src/tasks/home-query-service.ts

package/dist/src/tui/tui-workflow-slash.d.ts

@@ -11,17 +11,14 @@
  *   shortest reliable path is to turn `/audit_repo` into the same plain-text
  *   request the model already knows how to handle.
  *
- * Why catalog the workflow list at the TUI layer?
- *   The catalog reads `~/.xopc/workflows/` synchronously (single `readdir`),
- *   so the slash dispatch stays sync and the user sees no latency. The lookup
- *   only runs for inputs that started with `/` and didn't match any built-in
- *   or extension command, so the cost is negligible.
+ * The lookup only runs for inputs that started with `/` and did not match a
+ * built-in or extension command. A short cache keeps repeated dispatch cheap.
  *
  * Built-in TUI command names that overlap with a workflow file name keep their
  * existing TUI behaviour — the slash dispatcher matches the built-in switch
  * cases before this helper is consulted.
  */
-/** Reset the cache (for tests, or after a `/workflow save`). */
+/** Reset the cache after workflow changes and in tests. */
 export declare function resetWorkflowSlashCache(): void;
 /**
  * Returns a rewritten user message when `name` matches a known workflow,

package/dist/src/tui/tui-workflow-slash.js

@@ -13,11 +13,8 @@ import { createWorkflowCatalog } from "../agent/workflow/catalog.js";
 *   shortest reliable path is to turn `/audit_repo` into the same plain-text
 *   request the model already knows how to handle.
 *
-* Why catalog the workflow list at the TUI layer?
-*   The catalog reads `~/.xopc/workflows/` synchronously (single `readdir`),
-*   so the slash dispatch stays sync and the user sees no latency. The lookup
-*   only runs for inputs that started with `/` and didn't match any built-in
-*   or extension command, so the cost is negligible.
+* The lookup only runs for inputs that started with `/` and did not match a
+* built-in or extension command. A short cache keeps repeated dispatch cheap.
 *
 * Built-in TUI command names that overlap with a workflow file name keep their
 * existing TUI behaviour — the slash dispatcher matches the built-in switch
@@ -26,7 +23,7 @@ import { createWorkflowCatalog } from "../agent/workflow/catalog.js";
 let cachedNames = null;
 let cachedAt = 0;
 const CACHE_TTL_MS = 5e3;
-/** Reset the cache (for tests, or after a `/workflow save`). */
+/** Reset the cache after workflow changes and in tests. */
 function resetWorkflowSlashCache() {
 	cachedNames = null;
 	cachedAt = 0;

package/dist/src/user-model/bootstrap.d.ts

@@ -0,0 +1,17 @@
+import { type UserProfilePatch } from './profile.js';
+export interface UserModelBootstrapInput {
+    profile: UserProfilePatch;
+    responsibilities?: string[];
+    goals?: string[];
+    communicationPreferences?: string[];
+    boundaries?: string[];
+    relationships?: string[];
+}
+export declare function bootstrapUserModel(input: UserModelBootstrapInput, now?: number): {
+    profile: Partial<Record<import("./profile.js").UserProfileField, string>>;
+    created: {
+        assertions: number;
+        goals: number;
+        rules: number;
+    };
+};

package/dist/src/user-model/bootstrap.js

@@ -0,0 +1,118 @@
+import { createCollaborationRule, listCollaborationRules } from "../storage/sqlite/collaboration-rule-repository.js";
+import { createPriorityWindow, createUserGoal, listPriorityWindows, listUserGoals } from "./goals.js";
+import { reconcileAssertion } from "./repository.js";
+import { applyUserProfilePatch } from "./profile.js";
+//#region src/user-model/bootstrap.ts
+function statements(values, limit) {
+	return [...new Set((values ?? []).map((value) => value.trim().slice(0, 500)).filter(Boolean))].slice(0, limit);
+}
+function addExplicitAssertions(values, input, now) {
+	let created = 0;
+	for (const statement of values) if (reconcileAssertion({
+		subject: {
+			type: "user",
+			id: "self"
+		},
+		predicate: input.predicate,
+		cardinality: "multiple",
+		scope: { type: "global" },
+		kind: input.kind,
+		value: statement,
+		normalizedValue: statement.toLocaleLowerCase(),
+		statement,
+		authority: "user_explicit",
+		confidence: 1,
+		declaredImportance: input.importance,
+		inferredImportance: input.importance,
+		consequence: "medium",
+		actionability: .8,
+		volatility: "slow",
+		sensitivity: input.kind === "relationship" ? "personal" : "normal",
+		disclosurePolicy: "referenceable",
+		observedAt: now,
+		createdBy: "user"
+	}, now).action !== "deduplicated") created += 1;
+	return created;
+}
+function addRules(category, values) {
+	const existing = new Set(listCollaborationRules().filter((rule) => rule.category === category && rule.status !== "archived").map((rule) => rule.statement.toLocaleLowerCase()));
+	let created = 0;
+	for (const statement of values) {
+		if (existing.has(statement.toLocaleLowerCase())) continue;
+		createCollaborationRule({
+			category,
+			priority: category === "boundary" ? 0 : 50,
+			scope: { type: "global" },
+			conditions: {
+				enforcementLevel: "prompt",
+				source: "onboarding"
+			},
+			statement
+		});
+		existing.add(statement.toLocaleLowerCase());
+		created += 1;
+	}
+	return created;
+}
+function bootstrapUserModel(input, now = Date.now()) {
+	const responsibilities = statements(input.responsibilities, 8);
+	const goals = statements(input.goals, 5);
+	const communicationPreferences = statements(input.communicationPreferences, 8);
+	const boundaries = statements(input.boundaries, 8);
+	const relationships = statements(input.relationships, 12);
+	const profile = applyUserProfilePatch(input.profile, now);
+	const assertionCount = addExplicitAssertions(responsibilities, {
+		predicate: "identity.responsibility",
+		kind: "identity",
+		importance: .85
+	}, now) + addExplicitAssertions(relationships, {
+		predicate: "relationship.important",
+		kind: "relationship",
+		importance: .8
+	}, now);
+	const existingGoals = new Map(listUserGoals().filter((goal) => goal.status === "active" || goal.status === "proposed").map((goal) => [goal.desiredOutcome.toLocaleLowerCase(), goal]));
+	const activePriorities = new Set(listPriorityWindows().filter((priority) => priority.status === "active").map((priority) => priority.targetId));
+	let goalCount = 0;
+	for (const [index, desiredOutcome] of goals.entries()) {
+		const key = desiredOutcome.toLocaleLowerCase();
+		const existing = existingGoals.get(key);
+		const goal = existing ?? createUserGoal({
+			title: desiredOutcome.slice(0, 80),
+			desiredOutcome,
+			scope: { type: "global" },
+			declaredImportance: index === 0 ? 1 : .8,
+			status: "active",
+			authority: "user_explicit",
+			confidence: 1,
+			createdBy: "user",
+			now
+		});
+		if (!existing) goalCount += 1;
+		if (index === 0 && !activePriorities.has(goal.id)) {
+			createPriorityWindow({
+				targetType: "goal",
+				targetId: goal.id,
+				rank: "primary",
+				urgency: .9,
+				scope: { type: "global" },
+				validFrom: now,
+				validTo: now + 720 * 60 * 60 * 1e3,
+				reviewAt: now + 10080 * 60 * 1e3,
+				declaredImportance: 1,
+				now
+			});
+			activePriorities.add(goal.id);
+		}
+		existingGoals.set(key, goal);
+	}
+	return {
+		profile,
+		created: {
+			assertions: assertionCount,
+			goals: goalCount,
+			rules: addRules("communication", communicationPreferences) + addRules("boundary", boundaries)
+		}
+	};
+}
+//#endregion
+export { bootstrapUserModel };

package/dist/src/user-model/index.d.ts

@@ -1,5 +1,8 @@
 export * from './domain.js';
 export * from './importance.js';
 export * from './goals.js';
+export * from './bootstrap.js';
+export * from './profile.js';
 export * from './repository.js';
 export * from './temporal.js';
+export * from './usage-policy.js';

package/dist/src/user-model/index.js

@@ -3,4 +3,7 @@ import { calculateExecutionValue } from "./importance.js";
 import { createPriorityWindow, createUserGoal, listPriorityWindows, listUserGoals, setUserGoalStatus } from "./goals.js";
 import { defaultReviewAt, isAssertionValidAt, requiresBoundedValidity, resolveCurrentAssertion } from "./temporal.js";
 import { getActiveAssertionByPredicate, getActiveAssertionForSlot, getAssertionSlot, getUserAssertion, getUserTimezone, linkAssertionEvidence, listSlotAssertions, listUserAssertions, reconcileAssertion, setAssertionStatus } from "./repository.js";
-export { USER_MODEL_PRINCIPAL_ID, calculateExecutionValue, createPriorityWindow, createUserGoal, defaultReviewAt, getActiveAssertionByPredicate, getActiveAssertionForSlot, getAssertionSlot, getUserAssertion, getUserTimezone, isAssertionValidAt, linkAssertionEvidence, listPriorityWindows, listSlotAssertions, listUserAssertions, listUserGoals, reconcileAssertion, requiresBoundedValidity, resolveCurrentAssertion, setAssertionStatus, setUserGoalStatus, validateCandidate, validateScope };
+import { applyUserProfilePatch, getUserProfileSnapshot } from "./profile.js";
+import { bootstrapUserModel } from "./bootstrap.js";
+import { isWorkingAssumption } from "./usage-policy.js";
+export { USER_MODEL_PRINCIPAL_ID, applyUserProfilePatch, bootstrapUserModel, calculateExecutionValue, createPriorityWindow, createUserGoal, defaultReviewAt, getActiveAssertionByPredicate, getActiveAssertionForSlot, getAssertionSlot, getUserAssertion, getUserProfileSnapshot, getUserTimezone, isAssertionValidAt, isWorkingAssumption, linkAssertionEvidence, listPriorityWindows, listSlotAssertions, listUserAssertions, listUserGoals, reconcileAssertion, requiresBoundedValidity, resolveCurrentAssertion, setAssertionStatus, setUserGoalStatus, validateCandidate, validateScope };

package/dist/src/user-model/profile.d.ts

@@ -0,0 +1,5 @@
+export type UserProfileField = 'callName' | 'role' | 'pronouns' | 'timezone' | 'locale';
+export type UserProfilePatch = Partial<Record<UserProfileField, string>>;
+export type UserProfileSnapshot = Partial<Record<UserProfileField, string>>;
+export declare function getUserProfileSnapshot(): UserProfileSnapshot;
+export declare function applyUserProfilePatch(input: UserProfilePatch, now?: number): UserProfileSnapshot;