@xopcai/xopc 0.0.180 → 0.0.187

package/dist/src/agent/tools/xopc-use-tool.js

@@ -1,29 +1,59 @@
 import { runWithActivityContext } from "../../activity/context.js";
 import { getSessionMetadata } from "../../storage/sqlite/session-repository.js";
 import "../../storage/sqlite/index.js";
+import { ObjectLinkService } from "../../activity/service.js";
 import "../../activity/index.js";
+import { TaskRepository } from "../../tasks/task-repository.js";
+import { TaskRunRepository } from "../../tasks/task-run-repository.js";
+import { TaskReadModelProjector } from "../../tasks/task-read-model-projector.js";
+import { TaskCommandSchema, TaskContextInputSchema } from "../../../packages/gateway-contract/src/tasks.js";
 import { appendProductDeliveryText } from "../../../packages/gateway-contract/src/product-delivery.js";
+import { CreateAutomationSchema, UpdateAutomationSchema } from "../../automations/domain/validation.js";
+import "../../automations/index.js";
 import { isValidProjectAgentId, normalizeProjectAgentId } from "../../projects/project-agent.js";
 import "../../projects/index.js";
+import { TaskContextRepository } from "../../tasks/task-context-repository.js";
+import { TaskDependencyError, TaskDependencyService } from "../../tasks/task-dependency-service.js";
+import { TaskApplicationService } from "../../tasks/task-application-service.js";
+import { defineTaskContract } from "../../tasks/task-contract-definition.js";
+import "../../tasks/index.js";
+import { randomUUID } from "node:crypto";
 import { Type } from "@sinclair/typebox";
 //#region src/agent/tools/xopc-use-tool.ts
 const XopcUseToolSchema = Type.Object({
 	mode: Type.Union([
 		Type.Literal("project"),
+		Type.Literal("automation"),
 		Type.Literal("note"),
-		Type.Literal("work_item"),
+		Type.Literal("task"),
+		Type.Literal("task_run"),
 		Type.Literal("local_app"),
 		Type.Literal("settings")
 	]),
-	command: Type.String({ description: "Object command. Supports project list/get/create/update/resolve_workspace, note list/get/create/append/update/preview_edit, work_item list/get/create/update, local_app list/get/create/validate, and settings open." }),
+	command: Type.String({ description: "Object command. Supports project list/get/create/update/resolve_workspace/list_milestones/create_milestone/update_milestone/list_updates/create_update, automation list/get/create/update/delete/run/pause/resume/history, note list/get/create/append/update/preview_edit, task list/get/create/update_dependencies/add_context/remove_context/command, task_run list/get/cancel, local_app list/get/create/validate, and settings open." }),
 	args: Type.Optional(Type.Record(Type.String(), Type.Any())),
 	dryRun: Type.Optional(Type.Boolean({ description: "Validate and preview the action without mutating xopc state." }))
 });
 const PROJECT_STATUSES = new Set([
+	"planned",
 	"active",
 	"paused",
+	"completed",
+	"cancelled",
 	"archived"
 ]);
+const PROJECT_HEALTHS = new Set([
+	"unknown",
+	"on_track",
+	"at_risk",
+	"off_track"
+]);
+const MILESTONE_STATUSES = new Set([
+	"planned",
+	"active",
+	"completed",
+	"cancelled"
+]);
 const NOTE_KINDS = new Set([
 	"thought",
 	"todo",
@@ -39,22 +69,31 @@ const NOTE_STATUSES = new Set([
 	"archived",
 	"trashed"
 ]);
-const WORK_ITEM_STATUSES = new Set([
+const TASK_PHASES = new Set([
 	"backlog",
-	"todo",
-	"in_progress",
-	"blocked",
-	"needs_input",
-	"in_review",
-	"done",
-	"cancelled"
+	"ready",
+	"active",
+	"review",
+	"closed"
 ]);
-const WORK_ITEM_PRIORITIES = new Set([
-	"urgent",
-	"high",
+const TASK_PRIORITIES = new Set([
+	"low",
 	"normal",
-	"low"
+	"high",
+	"critical"
 ]);
+const TASK_COMMANDS = new Set([
+	"mark_ready",
+	"start",
+	"request_review",
+	"close",
+	"reopen",
+	"add_wait",
+	"resolve_wait",
+	"delegate",
+	"revise_contract"
+]);
+const TASK_CREATE_MODES = new Set(["capture", "start"]);
 function okText(details) {
 	return {
 		content: [{
@@ -109,7 +148,7 @@ function stringArray(value) {
 	if (!Array.isArray(value)) return void 0;
 	return value.filter((item) => typeof item === "string");
 }
-function nullableNumber(value) {
+function nullableFiniteNumber(value) {
 	if (value === null) return null;
 	return finiteNumber(value);
 }
@@ -154,6 +193,28 @@ function deliveryForXopcResult(mode, command, result, dryRun) {
 				"continue_in_chat"
 			]
 		};
+	} else if (mode === "automation") {
+		source = record(resultRecord.automation);
+		const id = deliveryText(source?.id);
+		if (id) {
+			const enabled = source?.enabled === true;
+			primary = {
+				kind: "automation",
+				id,
+				title: deliveryText(source?.name) ?? "Automation",
+				summary: deliverySummary(source?.description),
+				status: enabled ? "enabled" : "paused",
+				revision: deliveryRevision(source?.updatedAtMs),
+				projectId: deliveryText(source?.projectId),
+				capabilities: [
+					"open",
+					"edit",
+					"continue_in_chat",
+					"run",
+					enabled ? "pause" : "resume"
+				]
+			};
+		}
 	} else if (mode === "note") {
 		source = record(resultRecord.note);
 		const id = deliveryText(source?.id);
@@ -164,6 +225,7 @@ function deliveryForXopcResult(mode, command, result, dryRun) {
 			summary: deliverySummary(source?.markdown),
 			status: deliveryText(source?.status),
 			revision: deliveryRevision(source?.localVersion) ?? deliveryRevision(source?.updatedAt),
+			projectId: deliveryText(resultRecord.projectId),
 			capabilities: [
 				"open",
 				"preview",
@@ -172,22 +234,40 @@ function deliveryForXopcResult(mode, command, result, dryRun) {
 				"share"
 			]
 		};
-	} else if (mode === "work_item") {
-		source = record(resultRecord.item);
+	} else if (mode === "task") {
+		source = record(resultRecord.task);
 		const id = deliveryText(source?.id);
-		if (id) primary = {
-			kind: "work_item",
-			id,
-			title: deliveryText(source?.title) ?? "Work item",
-			summary: deliverySummary(source?.description, source?.nextAction),
-			status: deliveryText(source?.status),
-			revision: deliveryRevision(source?.updatedAt),
+		if (id) {
+			const phase = deliveryText(source?.phase);
+			const operationalState = deliveryText(resultRecord.operationalState);
+			const runCapability = phase === "ready" && (!operationalState || operationalState === "idle") ? "run" : void 0;
+			primary = {
+				kind: "task",
+				id,
+				title: deliveryText(source?.title) ?? "Task",
+				status: operationalState ? `${phase}/${operationalState}` : phase,
+				revision: deliveryRevision(source?.version) ?? deliveryRevision(source?.updatedAt),
+				projectId: deliveryText(source?.projectId),
+				capabilities: [
+					"open",
+					"edit",
+					"continue_in_chat",
+					...runCapability ? [runCapability] : []
+				]
+			};
+		}
+	} else if (mode === "task_run") {
+		const run = record(resultRecord.run);
+		source = record(record(resultRecord.model)?.task);
+		const taskId = deliveryText(source?.id) ?? deliveryText(run?.taskId);
+		if (taskId) primary = {
+			kind: "task",
+			id: taskId,
+			title: deliveryText(source?.title) ?? "Task",
+			status: deliveryText(run?.status),
+			revision: deliveryRevision(run?.version),
 			projectId: deliveryText(source?.projectId),
-			capabilities: [
-				"open",
-				"edit",
-				"continue_in_chat"
-			]
+			capabilities: ["open", "continue_in_chat"]
 		};
 	} else if (mode === "local_app") {
 		source = record(resultRecord.app);
@@ -208,7 +288,7 @@ function deliveryForXopcResult(mode, command, result, dryRun) {
 				"run"
 			]
 		};
-	} else {
+	} else if (mode === "settings") {
 		source = record(resultRecord.settings);
 		const id = deliveryText(source?.section);
 		if (id) primary = {
@@ -226,7 +306,7 @@ function deliveryForXopcResult(mode, command, result, dryRun) {
 	if (!primary) return void 0;
 	return {
 		version: 1,
-		operation: command === "create" ? "created" : command === "get" || command === "resolve_workspace" || mode === "settings" ? "opened" : command === "validate" ? "completed" : "updated",
+		operation: mode === "task" && deliveryText(resultRecord.runId) || mode === "automation" && command === "run" ? "started" : command === "create" ? "created" : command === "get" || command === "resolve_workspace" || mode === "settings" ? "opened" : command === "validate" ? "completed" : "updated",
 		primary
 	};
 }
@@ -236,6 +316,18 @@ function currentProjectId(args, deps) {
 	const sessionKey = trimString(args.sessionKey) ?? deps.getCurrentSessionKey?.();
 	return sessionKey ? getSessionMetadata(sessionKey)?.projectId : void 0;
 }
+function automationPayload(args, key) {
+	return record(args[key]) ?? args;
+}
+function pickDefined(source, fields) {
+	return Object.fromEntries(fields.filter((field) => source[field] !== void 0).map((field) => [field, source[field]]));
+}
+function automationProjectError(projectId, deps) {
+	if (!projectId) return void 0;
+	const projects = deps.getProjectService?.();
+	if (!projects) return "Project service is unavailable";
+	return projects.get(projectId) ? void 0 : `Project not found: ${projectId}`;
+}
 function projectWorkspaceRootArg(args) {
 	return trimString(args.workspaceRoot) ?? trimString(args.workspacePath) ?? trimString(args.path);
 }
@@ -330,7 +422,34 @@ async function handleProject(command, args, deps, dryRun) {
 			createWorkspaceRoot: args.createWorkspaceRoot === true,
 			projectKind: trimString(args.projectKind),
 			brief: trimString(args.brief),
-			instructions: trimString(args.instructions)
+			instructions: trimString(args.instructions),
+			outcome: trimString(args.outcome),
+			successCriteria: args.successCriteria === void 0 ? void 0 : stringArray(args.successCriteria),
+			scope: args.scope === void 0 ? void 0 : record(args.scope),
+			nonGoals: args.nonGoals === void 0 ? void 0 : stringArray(args.nonGoals),
+			health: args.health === void 0 ? void 0 : enumValue(args.health, PROJECT_HEALTHS),
+			ownerId: trimString(args.ownerId),
+			targetAt: args.targetAt === void 0 ? void 0 : finiteNumber(args.targetAt)
+		};
+		if (args.successCriteria !== void 0 && !input.successCriteria) return {
+			ok: false,
+			error: "Invalid successCriteria"
+		};
+		if (args.scope !== void 0 && !input.scope) return {
+			ok: false,
+			error: "Invalid scope"
+		};
+		if (args.nonGoals !== void 0 && !input.nonGoals) return {
+			ok: false,
+			error: "Invalid nonGoals"
+		};
+		if (args.health !== void 0 && !input.health) return {
+			ok: false,
+			error: "Invalid project health"
+		};
+		if (args.targetAt !== void 0 && input.targetAt === void 0) return {
+			ok: false,
+			error: "Invalid targetAt"
 		};
 		if (dryRun) return {
 			ok: true,
@@ -358,12 +477,39 @@ async function handleProject(command, args, deps, dryRun) {
 			...workspaceRoot !== void 0 ? { workspaceRoot } : {},
 			...args.createWorkspaceRoot === true ? { createWorkspaceRoot: true } : {},
 			...args.brief !== void 0 ? { brief: optionalString(args.brief) } : {},
-			...args.instructions !== void 0 ? { instructions: optionalString(args.instructions) } : {}
+			...args.instructions !== void 0 ? { instructions: optionalString(args.instructions) } : {},
+			...args.outcome !== void 0 ? { outcome: optionalString(args.outcome) } : {},
+			...args.successCriteria !== void 0 ? { successCriteria: stringArray(args.successCriteria) } : {},
+			...args.scope !== void 0 ? { scope: record(args.scope) } : {},
+			...args.nonGoals !== void 0 ? { nonGoals: stringArray(args.nonGoals) } : {},
+			...args.health !== void 0 ? { health: enumValue(args.health, PROJECT_HEALTHS) } : {},
+			...args.ownerId !== void 0 ? { ownerId: optionalString(args.ownerId) } : {},
+			...args.targetAt !== void 0 ? { targetAt: nullableFiniteNumber(args.targetAt) } : {}
 		};
 		if (args.status !== void 0 && patch.status === void 0) return {
 			ok: false,
 			error: "Invalid project status"
 		};
+		if (args.successCriteria !== void 0 && patch.successCriteria === void 0) return {
+			ok: false,
+			error: "Invalid successCriteria"
+		};
+		if (args.scope !== void 0 && patch.scope === void 0) return {
+			ok: false,
+			error: "Invalid scope"
+		};
+		if (args.nonGoals !== void 0 && patch.nonGoals === void 0) return {
+			ok: false,
+			error: "Invalid nonGoals"
+		};
+		if (args.health !== void 0 && patch.health === void 0) return {
+			ok: false,
+			error: "Invalid project health"
+		};
+		if (args.targetAt !== void 0 && patch.targetAt === void 0) return {
+			ok: false,
+			error: "Invalid targetAt"
+		};
 		if (dryRun) return {
 			ok: true,
 			dryRun: true,
@@ -376,35 +522,385 @@ async function handleProject(command, args, deps, dryRun) {
 			project: projects.update(id, patch)
 		};
 	}
+	const projectId = trimString(args.projectId) ?? trimString(args.id);
+	if (command === "list_milestones") {
+		if (!projectId) return {
+			ok: false,
+			error: "projectId is required"
+		};
+		return {
+			ok: true,
+			projectId,
+			items: projects.listMilestones(projectId)
+		};
+	}
+	if (command === "create_milestone") {
+		if (!projectId) return {
+			ok: false,
+			error: "projectId is required"
+		};
+		const title = trimString(args.title);
+		const status = args.status === void 0 ? void 0 : enumValue(args.status, MILESTONE_STATUSES);
+		const targetAt = args.targetAt === void 0 ? void 0 : finiteNumber(args.targetAt);
+		const sortOrder = args.sortOrder === void 0 ? void 0 : finiteNumber(args.sortOrder);
+		if (!title) return {
+			ok: false,
+			error: "title is required"
+		};
+		if (args.status !== void 0 && !status) return {
+			ok: false,
+			error: "Invalid milestone status"
+		};
+		if (args.targetAt !== void 0 && targetAt === void 0) return {
+			ok: false,
+			error: "Invalid targetAt"
+		};
+		if (args.sortOrder !== void 0 && sortOrder === void 0) return {
+			ok: false,
+			error: "Invalid sortOrder"
+		};
+		const input = {
+			title,
+			description: trimString(args.description),
+			status,
+			targetAt,
+			sortOrder
+		};
+		if (dryRun) return {
+			ok: true,
+			dryRun: true,
+			action: "create_project_milestone",
+			projectId,
+			input
+		};
+		return {
+			ok: true,
+			milestone: projects.createMilestone(projectId, input),
+			project: projects.get(projectId)
+		};
+	}
+	if (command === "update_milestone") {
+		if (!projectId) return {
+			ok: false,
+			error: "projectId is required"
+		};
+		const milestoneId = trimString(args.milestoneId);
+		if (!milestoneId) return {
+			ok: false,
+			error: "milestoneId is required"
+		};
+		const patch = {
+			...args.title !== void 0 ? { title: trimString(args.title) ?? "" } : {},
+			...args.description !== void 0 ? { description: optionalString(args.description) } : {},
+			...args.status !== void 0 ? { status: enumValue(args.status, MILESTONE_STATUSES) } : {},
+			...args.targetAt !== void 0 ? { targetAt: nullableFiniteNumber(args.targetAt) } : {},
+			...args.sortOrder !== void 0 ? { sortOrder: finiteNumber(args.sortOrder) } : {}
+		};
+		if (args.status !== void 0 && patch.status === void 0) return {
+			ok: false,
+			error: "Invalid milestone status"
+		};
+		if (args.targetAt !== void 0 && patch.targetAt === void 0) return {
+			ok: false,
+			error: "Invalid targetAt"
+		};
+		if (args.sortOrder !== void 0 && patch.sortOrder === void 0) return {
+			ok: false,
+			error: "Invalid sortOrder"
+		};
+		if (dryRun) return {
+			ok: true,
+			dryRun: true,
+			action: "update_project_milestone",
+			projectId,
+			milestoneId,
+			patch
+		};
+		return {
+			ok: true,
+			milestone: projects.updateMilestone(projectId, milestoneId, patch),
+			project: projects.get(projectId)
+		};
+	}
+	if (command === "list_updates") {
+		if (!projectId) return {
+			ok: false,
+			error: "projectId is required"
+		};
+		return {
+			ok: true,
+			projectId,
+			items: projects.listUpdates(projectId, boundedLimit(args.limit))
+		};
+	}
+	if (command === "create_update") {
+		if (!projectId) return {
+			ok: false,
+			error: "projectId is required"
+		};
+		const health = enumValue(args.health, PROJECT_HEALTHS);
+		const summary = trimString(args.summary);
+		const progress = args.progress === void 0 ? void 0 : stringArray(args.progress);
+		const risks = args.risks === void 0 ? void 0 : stringArray(args.risks);
+		const nextSteps = args.nextSteps === void 0 ? void 0 : stringArray(args.nextSteps);
+		if (!health) return {
+			ok: false,
+			error: "health is required"
+		};
+		if (!summary) return {
+			ok: false,
+			error: "summary is required"
+		};
+		if (args.progress !== void 0 && !progress) return {
+			ok: false,
+			error: "Invalid progress"
+		};
+		if (args.risks !== void 0 && !risks) return {
+			ok: false,
+			error: "Invalid risks"
+		};
+		if (args.nextSteps !== void 0 && !nextSteps) return {
+			ok: false,
+			error: "Invalid nextSteps"
+		};
+		const input = {
+			health,
+			summary,
+			progress,
+			risks,
+			nextSteps,
+			actor: {
+				kind: "agent",
+				agentId: deps.getCurrentAgentId?.(),
+				sessionKey: deps.getCurrentSessionKey?.()
+			}
+		};
+		if (dryRun) return {
+			ok: true,
+			dryRun: true,
+			action: "create_project_update",
+			projectId,
+			input
+		};
+		return {
+			ok: true,
+			update: projects.createUpdate(projectId, input),
+			project: projects.get(projectId)
+		};
+	}
 	return {
 		ok: false,
 		error: `Unsupported project command: ${command}`
 	};
 }
+async function handleAutomation(command, args, deps, dryRun) {
+	const automations = deps.getAutomationService?.();
+	if (!automations) return {
+		ok: false,
+		error: "Automation service is unavailable"
+	};
+	if (command === "list") {
+		const projectId = currentProjectId(args, deps);
+		const projectError = automationProjectError(projectId, deps);
+		if (projectError) return {
+			ok: false,
+			error: projectError
+		};
+		return {
+			ok: true,
+			items: await automations.list({ projectId }),
+			...projectId ? { projectId } : {}
+		};
+	}
+	if (command === "get") {
+		const id = trimString(args.automationId) ?? trimString(args.id);
+		if (!id) return {
+			ok: false,
+			error: "automationId is required"
+		};
+		const automation = await automations.get(id);
+		return automation ? {
+			ok: true,
+			automation
+		} : {
+			ok: false,
+			error: `Automation not found: ${id}`
+		};
+	}
+	if (command === "create") {
+		const source = automationPayload(args, "automation");
+		const projectId = trimString(args.projectId) ?? trimString(source.projectId) ?? currentProjectId({}, deps);
+		const projectError = automationProjectError(projectId, deps);
+		if (projectError) return {
+			ok: false,
+			error: projectError
+		};
+		const input = CreateAutomationSchema.parse({
+			...pickDefined(source, [
+				"id",
+				"name",
+				"description",
+				"enabled",
+				"trigger",
+				"action",
+				"safety",
+				"afterRun",
+				"reliability",
+				"state"
+			]),
+			...projectId ? { projectId } : {}
+		});
+		if (dryRun) return {
+			ok: true,
+			dryRun: true,
+			action: "create_automation",
+			input,
+			projectId
+		};
+		return {
+			ok: true,
+			automation: await automations.create(input),
+			...projectId ? { projectId } : {}
+		};
+	}
+	if (command === "update") {
+		const id = trimString(args.automationId) ?? trimString(args.id);
+		if (!id) return {
+			ok: false,
+			error: "automationId is required"
+		};
+		const source = automationPayload(args, "patch");
+		const patch = UpdateAutomationSchema.parse(pickDefined(source, [
+			"name",
+			"description",
+			"projectId",
+			"enabled",
+			"trigger",
+			"action",
+			"safety",
+			"afterRun",
+			"reliability",
+			"state"
+		]));
+		const projectError = automationProjectError(patch.projectId, deps);
+		if (projectError) return {
+			ok: false,
+			error: projectError
+		};
+		if (dryRun) return {
+			ok: true,
+			dryRun: true,
+			action: "update_automation",
+			automationId: id,
+			patch
+		};
+		const automation = await automations.update(id, patch);
+		return automation ? {
+			ok: true,
+			automation
+		} : {
+			ok: false,
+			error: `Automation not found: ${id}`
+		};
+	}
+	if (command === "history") {
+		const automationId = trimString(args.automationId) ?? trimString(args.id);
+		const projectId = automationId ? void 0 : currentProjectId(args, deps);
+		const projectError = automationProjectError(projectId, deps);
+		if (projectError) return {
+			ok: false,
+			error: projectError
+		};
+		return {
+			ok: true,
+			items: await automations.listRuns({
+				automationId,
+				projectId,
+				limit: boundedLimit(args.limit, 20, 50)
+			}),
+			...projectId ? { projectId } : {}
+		};
+	}
+	if (![
+		"delete",
+		"run",
+		"pause",
+		"resume"
+	].includes(command)) return {
+		ok: false,
+		error: `Unsupported automation command: ${command}`
+	};
+	const id = trimString(args.automationId) ?? trimString(args.id);
+	if (!id) return {
+		ok: false,
+		error: "automationId is required"
+	};
+	const current = await automations.get(id);
+	if (!current) return {
+		ok: false,
+		error: `Automation not found: ${id}`
+	};
+	if (dryRun) return {
+		ok: true,
+		dryRun: true,
+		action: `${command}_automation`,
+		automationId: id,
+		automation: current
+	};
+	if (command === "delete") return {
+		ok: true,
+		removed: await automations.remove(id),
+		automation: current
+	};
+	if (command === "run") return {
+		ok: true,
+		automation: current,
+		run: await automations.runNow(id)
+	};
+	if (command === "pause" || command === "resume") {
+		const automation = command === "pause" ? await automations.pause(id) : await automations.resume(id);
+		return automation ? {
+			ok: true,
+			automation
+		} : {
+			ok: false,
+			error: `Automation not found: ${id}`
+		};
+	}
+	return {
+		ok: false,
+		error: `Automation command failed: ${command}`
+	};
+}
 async function handleNote(command, args, deps, dryRun) {
 	const notes = deps.getNotesService?.();
 	if (!notes) return {
 		ok: false,
 		error: "Notes service is unavailable"
 	};
-	if (command === "list") return {
-		ok: true,
-		...await notes.listNotes({
-			status: enumValue(args.status, NOTE_STATUSES),
-			kind: enumValue(args.kind, NOTE_KINDS),
-			tag: trimString(args.tag),
-			search: trimString(args.search),
-			pinned: typeof args.pinned === "boolean" ? args.pinned : void 0,
-			limit: boundedLimit(args.limit),
-			offset: offset(args.offset),
-			sortBy: enumValue(args.sortBy, new Set([
-				"createdAt",
-				"updatedAt",
-				"lastOpenedAt"
-			])),
-			sortOrder: enumValue(args.sortOrder, new Set(["asc", "desc"]))
-		})
-	};
+	if (command === "list") {
+		const projectId = currentProjectId(args, deps);
+		return {
+			ok: true,
+			...await notes.listNotes({
+				status: enumValue(args.status, NOTE_STATUSES),
+				kind: enumValue(args.kind, NOTE_KINDS),
+				tag: trimString(args.tag),
+				projectId,
+				search: trimString(args.search),
+				pinned: typeof args.pinned === "boolean" ? args.pinned : void 0,
+				limit: boundedLimit(args.limit),
+				offset: offset(args.offset),
+				sortBy: enumValue(args.sortBy, new Set([
+					"createdAt",
+					"updatedAt",
+					"lastOpenedAt"
+				])),
+				sortOrder: enumValue(args.sortOrder, new Set(["asc", "desc"]))
+			}),
+			...projectId ? { projectId } : {}
+		};
+	}
 	if (command === "get") {
 		const id = trimString(args.noteId) ?? trimString(args.id);
 		if (!id) return {
@@ -421,6 +917,17 @@ async function handleNote(command, args, deps, dryRun) {
 		};
 	}
 	if (command === "create") {
+		const projectId = currentProjectId(args, deps);
+		const projectService = projectId ? deps.getProjectService?.() : void 0;
+		if (projectId && !projectService) return {
+			ok: false,
+			error: "Project service is unavailable"
+		};
+		const project = projectId ? projectService?.get(projectId) : void 0;
+		if (projectId && !project) return {
+			ok: false,
+			error: `Project not found: ${projectId}`
+		};
 		const markdown = typeof args.markdown === "string" ? args.markdown : trimString(args.content) ?? "";
 		const input = {
 			title: trimString(args.title),
@@ -434,11 +941,29 @@ async function handleNote(command, args, deps, dryRun) {
 			ok: true,
 			dryRun: true,
 			action: "create_note",
-			input
-		};
+			input,
+			projectId
+		};
+		const note = await notes.createNote(input);
+		if (project) new ObjectLinkService().create({
+			id: `note:${note.id}:project:${project.id}`,
+			from: {
+				kind: "note",
+				id: note.id,
+				title: note.title
+			},
+			to: {
+				kind: "project",
+				id: project.id,
+				title: project.name
+			},
+			relation: "belongs_to",
+			source: "user"
+		});
 		return {
 			ok: true,
-			note: await notes.createNote(input)
+			note,
+			...projectId ? { projectId } : {}
 		};
 	}
 	if (command === "append") {
@@ -548,151 +1073,470 @@ async function handleNote(command, args, deps, dryRun) {
 		error: `Unsupported note command: ${command}`
 	};
 }
-async function handleWorkItem(command, args, deps, dryRun) {
-	const workItems = deps.getWorkItemService?.();
-	if (!workItems) return {
-		ok: false,
-		error: "Work item service is unavailable"
-	};
+async function handleTask(command, args, deps, dryRun) {
+	const tasks = new TaskRepository();
+	const dependencies = new TaskDependencyService();
+	const context = new TaskContextRepository();
+	const runs = new TaskRunRepository();
+	const projector = new TaskReadModelProjector();
 	if (command === "list") {
 		const projectId = currentProjectId(args, deps);
-		if (!projectId) return {
-			ok: false,
-			error: "projectId is required"
-		};
+		const phase = enumValue(args.phase, TASK_PHASES);
+		const priority = enumValue(args.priority, TASK_PRIORITIES);
+		const search = trimString(args.search)?.toLocaleLowerCase();
+		const start = offset(args.offset) ?? 0;
+		const limit = boundedLimit(args.limit);
+		const matching = (projectId ? tasks.listByProject(projectId, 200) : tasks.list({ limit: 200 })).filter((task) => (!phase || task.phase === phase) && (!priority || task.priority === priority) && (!search || `${task.title}\n${task.contract?.objective ?? ""}`.toLocaleLowerCase().includes(search)));
 		return {
 			ok: true,
-			...workItems.listProjectWorkItems(projectId, {
-				status: enumValue(args.status, WORK_ITEM_STATUSES),
-				priority: enumValue(args.priority, WORK_ITEM_PRIORITIES),
-				includeArchived: args.includeArchived === true,
-				search: trimString(args.search),
-				sortBy: enumValue(args.sortBy, new Set([
-					"updatedAt",
-					"createdAt",
-					"priority",
-					"status"
-				])),
-				sortOrder: enumValue(args.sortOrder, new Set(["asc", "desc"])),
-				limit: boundedLimit(args.limit),
-				offset: offset(args.offset)
-			})
+			items: matching.slice(start, start + limit),
+			total: matching.length,
+			...projectId ? { projectId } : {}
 		};
 	}
 	if (command === "get") {
-		const id = trimString(args.workItemId) ?? trimString(args.id);
+		const id = trimString(args.taskId) ?? trimString(args.id);
 		if (!id) return {
 			ok: false,
-			error: "workItemId is required"
+			error: "taskId is required"
 		};
-		const item = workItems.getWorkItem(id);
-		return item ? {
-			ok: true,
-			item
-		} : {
+		const task = tasks.get(id);
+		if (!task) return {
 			ok: false,
-			error: `Work item not found: ${id}`
+			error: `Task not found: ${id}`
+		};
+		const model = projector.project(task);
+		return {
+			ok: true,
+			task,
+			model,
+			operationalState: model.operationalState,
+			attention: model.attention,
+			allowedCommands: model.allowedCommands,
+			dependencies: dependencies.listDependencies(id),
+			dependents: dependencies.listDependents(id),
+			context: context.list(id),
+			authorityGrants: context.listActiveGrants(id),
+			runs: runs.listByTask(id),
+			receipts: runs.listReceipts(id),
+			waits: runs.listActiveWaits(id)
 		};
 	}
 	if (command === "create") {
+		const objective = trimString(args.objective) ?? trimString(args.title);
+		if (!objective) return {
+			ok: false,
+			error: "objective is required"
+		};
+		const createMode = args.createMode === void 0 ? "capture" : enumValue(args.createMode, TASK_CREATE_MODES);
+		if (!createMode) return {
+			ok: false,
+			error: "Invalid createMode"
+		};
+		if (createMode === "start" && !deps.dispatchTaskRuns) return {
+			ok: false,
+			error: "Task execution service is unavailable"
+		};
 		const projectId = currentProjectId(args, deps);
-		const title = trimString(args.title);
-		if (!projectId) return {
+		if (projectId) {
+			const projects = deps.getProjectService?.();
+			if (!projects) return {
+				ok: false,
+				error: "Project service is unavailable"
+			};
+			if (!projects.get(projectId)) return {
+				ok: false,
+				error: `Project not found: ${projectId}`
+			};
+		}
+		const priority = args.priority === void 0 ? void 0 : enumValue(args.priority, TASK_PRIORITIES);
+		if (args.priority !== void 0 && !priority) return {
 			ok: false,
-			error: "projectId is required"
+			error: "Invalid task priority"
 		};
-		if (!title) return {
+		const dueAt = args.dueAt === void 0 ? void 0 : finiteNumber(args.dueAt);
+		if (args.dueAt !== void 0 && (dueAt === void 0 || dueAt < 0)) return {
 			ok: false,
-			error: "title is required"
+			error: "Invalid dueAt"
+		};
+		const locale = args.locale === void 0 ? void 0 : enumValue(args.locale, new Set(["en", "zh"]));
+		if (args.locale !== void 0 && !locale) return {
+			ok: false,
+			error: "Invalid locale"
 		};
+		const dependsOnTaskIds = args.dependsOnTaskIds === void 0 ? [] : stringArray(args.dependsOnTaskIds);
+		if (!dependsOnTaskIds) return {
+			ok: false,
+			error: "Invalid dependsOnTaskIds"
+		};
+		const baseContract = defineTaskContract(objective);
+		const contractFields = [
+			"expectedOutputs",
+			"acceptanceCriteria",
+			"constraints",
+			"approvalRequired",
+			"assumptions",
+			"risks"
+		];
+		const contract = { ...baseContract };
+		for (const field of contractFields) {
+			if (args[field] === void 0) continue;
+			const value = stringArray(args[field]);
+			if (!value) return {
+				ok: false,
+				error: `Invalid ${field}`
+			};
+			contract[field] = value;
+		}
+		const sessionKey = trimString(args.sessionKey) ?? deps.getCurrentSessionKey?.();
+		const agentId = trimString(args.agentId) ?? deps.getCurrentAgentId?.() ?? "main";
 		const input = {
-			title,
-			description: trimString(args.description),
-			status: enumValue(args.status, WORK_ITEM_STATUSES),
-			priority: enumValue(args.priority, WORK_ITEM_PRIORITIES),
-			ownerAgentId: trimString(args.ownerAgentId),
-			nextAction: trimString(args.nextAction),
-			blockedReason: trimString(args.blockedReason),
-			dueAt: finiteNumber(args.dueAt)
+			idempotencyKey: trimString(args.idempotencyKey) ?? randomUUID(),
+			title: trimString(args.title) ?? objective,
+			priority: priority ?? "normal",
+			...dueAt === void 0 ? {} : { dueAt },
+			...projectId ? { projectId } : {},
+			...locale ? { locale } : {},
+			contract: {
+				...contract,
+				acceptancePolicy: "verified_auto",
+				outputDestinations: []
+			},
+			dependencies: dependsOnTaskIds,
+			context: sessionKey ? [{
+				targetKind: "session",
+				targetId: sessionKey,
+				role: "input",
+				pinned: false,
+				retrievalPolicy: {},
+				metadata: {}
+			}] : [],
+			authorityGrants: [],
+			activation: createMode === "capture" ? {
+				mode: "capture",
+				phase: "backlog"
+			} : {
+				mode: "start",
+				executor: {
+					kind: "agent",
+					agentId
+				}
+			}
+		};
+		if (dryRun) return {
+			ok: true,
+			dryRun: true,
+			action: "create_task",
+			createMode,
+			input,
+			dependsOnTaskIds
+		};
+		const created = new TaskApplicationService().create(input, {
+			kind: "agent",
+			id: agentId
+		});
+		if (created.ok === false) return {
+			ok: false,
+			error: created.reason,
+			...created
+		};
+		if (created.runId) deps.dispatchTaskRuns?.();
+		return {
+			ok: true,
+			task: created.model.task,
+			operationalState: created.model.operationalState,
+			createMode,
+			...created.runId ? { runId: created.runId } : {}
 		};
-		if (args.status !== void 0 && input.status === void 0) return {
+	}
+	if (command === "update_dependencies") {
+		const id = trimString(args.taskId) ?? trimString(args.id);
+		const expectedVersion = finiteNumber(args.expectedVersion);
+		const dependsOnTaskIds = stringArray(args.dependsOnTaskIds);
+		if (!id) return {
 			ok: false,
-			error: "Invalid work item status"
+			error: "taskId is required"
 		};
-		if (args.priority !== void 0 && input.priority === void 0) return {
+		if (expectedVersion === void 0 || !Number.isInteger(expectedVersion) || expectedVersion < 1) return {
 			ok: false,
-			error: "Invalid work item priority"
+			error: "expectedVersion is required"
 		};
-		if (args.dueAt !== void 0 && input.dueAt === void 0) return {
+		if (!dependsOnTaskIds) return {
 			ok: false,
-			error: "Invalid dueAt"
+			error: "dependsOnTaskIds is required"
 		};
 		if (dryRun) return {
 			ok: true,
 			dryRun: true,
-			action: "create_work_item",
-			projectId,
+			action: "update_task_dependencies",
+			taskId: id,
+			expectedVersion,
+			dependsOnTaskIds
+		};
+		try {
+			return {
+				ok: true,
+				task: dependencies.replace({
+					taskId: id,
+					dependsOnTaskIds,
+					expectedVersion
+				}),
+				dependencies: dependencies.listDependencies(id),
+				dependents: dependencies.listDependents(id)
+			};
+		} catch (error) {
+			if (!(error instanceof TaskDependencyError)) throw error;
+			return {
+				ok: false,
+				error: error.message,
+				reason: error.code
+			};
+		}
+	}
+	if (command === "add_context") {
+		const id = trimString(args.taskId) ?? trimString(args.id);
+		if (!id) return {
+			ok: false,
+			error: "taskId is required"
+		};
+		if (!tasks.get(id)) return {
+			ok: false,
+			error: `Task not found: ${id}`
+		};
+		const parsed = TaskContextInputSchema.safeParse({
+			targetKind: args.targetKind,
+			targetId: args.targetId,
+			role: args.role,
+			title: args.title,
+			pinned: args.pinned === true,
+			retrievalPolicy: record(args.retrievalPolicy) ?? {},
+			metadata: record(args.metadata) ?? {}
+		});
+		if (!parsed.success) return {
+			ok: false,
+			error: "Invalid task context edge"
+		};
+		const input = {
+			taskId: id,
+			...parsed.data,
+			createdBy: {
+				kind: "agent",
+				id: deps.getCurrentAgentId?.()
+			}
+		};
+		if (dryRun) return {
+			ok: true,
+			dryRun: true,
+			action: "add_task_context",
 			input
 		};
 		return {
 			ok: true,
-			item: workItems.createProjectWorkItem(projectId, input)
+			edge: context.add(input),
+			context: context.list(id)
 		};
 	}
-	if (command === "update") {
-		const id = trimString(args.workItemId) ?? trimString(args.id);
+	if (command === "remove_context") {
+		const id = trimString(args.taskId) ?? trimString(args.id);
+		const edgeId = trimString(args.edgeId);
 		if (!id) return {
 			ok: false,
-			error: "workItemId is required"
+			error: "taskId is required"
 		};
-		const dueAt = args.dueAt !== void 0 ? nullableNumber(args.dueAt) : void 0;
-		const archivedAt = args.archivedAt !== void 0 ? nullableNumber(args.archivedAt) : void 0;
-		const patch = {
-			...args.title !== void 0 ? { title: trimString(args.title) ?? "" } : {},
-			...args.description !== void 0 ? { description: optionalString(args.description) } : {},
-			...args.status !== void 0 ? { status: enumValue(args.status, WORK_ITEM_STATUSES) } : {},
-			...args.priority !== void 0 ? { priority: enumValue(args.priority, WORK_ITEM_PRIORITIES) } : {},
-			...args.ownerAgentId !== void 0 ? { ownerAgentId: optionalString(args.ownerAgentId) } : {},
-			...args.nextAction !== void 0 ? { nextAction: optionalString(args.nextAction) } : {},
-			...args.blockedReason !== void 0 ? { blockedReason: optionalString(args.blockedReason) } : {},
-			...args.dueAt !== void 0 ? { dueAt } : {},
-			...args.archivedAt !== void 0 ? { archivedAt } : {}
+		if (!edgeId) return {
+			ok: false,
+			error: "edgeId is required"
 		};
-		if (args.status !== void 0 && patch.status === void 0) return {
+		if (dryRun) return {
+			ok: true,
+			dryRun: true,
+			action: "remove_task_context",
+			taskId: id,
+			edgeId
+		};
+		return context.remove(id, edgeId) ? {
+			ok: true,
+			taskId: id,
+			edgeId,
+			context: context.list(id)
+		} : {
 			ok: false,
-			error: "Invalid work item status"
+			error: `Task context edge not found: ${edgeId}`
 		};
-		if (args.priority !== void 0 && patch.priority === void 0) return {
+	}
+	if (command === "command") {
+		const id = trimString(args.taskId) ?? trimString(args.id);
+		const commandType = enumValue(args.type, TASK_COMMANDS);
+		const expectedVersion = finiteNumber(args.expectedVersion);
+		if (!id) return {
 			ok: false,
-			error: "Invalid work item priority"
+			error: "taskId is required"
 		};
-		if (args.dueAt !== void 0 && dueAt === void 0) return {
+		if (!commandType) return {
 			ok: false,
-			error: "Invalid dueAt"
+			error: "Invalid task command type"
 		};
-		if (args.archivedAt !== void 0 && archivedAt === void 0) return {
+		if (expectedVersion === void 0 || !Number.isInteger(expectedVersion) || expectedVersion < 1) return {
 			ok: false,
-			error: "Invalid archivedAt"
+			error: "expectedVersion is required"
+		};
+		if (commandType === "start" && !deps.dispatchTaskRuns) return {
+			ok: false,
+			error: "Task execution service is unavailable"
+		};
+		const commandArgs = args.commandArgs && typeof args.commandArgs === "object" ? args.commandArgs : {};
+		const parsedCommand = TaskCommandSchema.safeParse({
+			type: commandType,
+			...commandArgs
+		});
+		if (!parsedCommand.success) return {
+			ok: false,
+			error: "Invalid task command payload"
 		};
 		if (dryRun) return {
 			ok: true,
 			dryRun: true,
-			action: "update_work_item",
-			workItemId: id,
-			patch
+			action: "execute_task_command",
+			taskId: id,
+			command: parsedCommand.data,
+			expectedVersion
+		};
+		const result = new TaskApplicationService().execute({
+			taskId: id,
+			idempotencyKey: trimString(args.idempotencyKey) ?? randomUUID(),
+			expectedVersion,
+			command: parsedCommand.data,
+			actor: {
+				kind: "agent",
+				id: deps.getCurrentAgentId?.()
+			}
+		});
+		if (result.ok === false) return {
+			ok: false,
+			error: result.reason,
+			command: parsedCommand.data,
+			...result
 		};
-		const item = workItems.updateWorkItem(id, patch);
-		return item ? {
+		if (result.runId) deps.dispatchTaskRuns?.();
+		return {
 			ok: true,
-			item
-		} : {
+			task: result.model.task,
+			operationalState: result.model.operationalState,
+			command: parsedCommand.data,
+			...result.runId ? { runId: result.runId } : {}
+		};
+	}
+	return {
+		ok: false,
+		error: `Unsupported task command: ${command}`
+	};
+}
+async function handleTaskRun(command, args, dryRun, deps) {
+	const runs = new TaskRunRepository();
+	if (command === "list") {
+		const taskId = trimString(args.taskId);
+		if (!taskId) return {
+			ok: false,
+			error: "taskId is required"
+		};
+		const limit = boundedLimit(args.limit);
+		return {
+			ok: true,
+			taskId,
+			items: runs.listByTask(taskId).slice(0, limit),
+			receipts: runs.listReceipts(taskId, limit),
+			activeWaits: runs.listActiveWaits(taskId)
+		};
+	}
+	if (command === "get") {
+		const runId = trimString(args.runId) ?? trimString(args.id);
+		if (!runId) return {
 			ok: false,
-			error: `Work item not found: ${id}`
+			error: "runId is required"
+		};
+		const run = runs.get(runId);
+		if (!run) return {
+			ok: false,
+			error: `TaskRun not found: ${runId}`
+		};
+		return {
+			ok: true,
+			run,
+			receipt: runs.getReceipt(runId),
+			events: runs.listEvents(runId),
+			activeWaits: runs.listActiveWaits(run.taskId)
+		};
+	}
+	if (command === "cancel") {
+		const runId = trimString(args.runId) ?? trimString(args.id);
+		const expectedVersion = finiteNumber(args.expectedVersion);
+		if (!runId) return {
+			ok: false,
+			error: "runId is required"
+		};
+		if (expectedVersion === void 0 || !Number.isInteger(expectedVersion) || expectedVersion < 1) return {
+			ok: false,
+			error: "expectedVersion is required"
+		};
+		const run = runs.get(runId);
+		if (!run) return {
+			ok: false,
+			error: `TaskRun not found: ${runId}`
+		};
+		if (run.version !== expectedVersion) return {
+			ok: false,
+			error: "TaskRun changed",
+			reason: "conflict",
+			run
+		};
+		const task = new TaskRepository().require(run.taskId);
+		const reason = trimString(args.reason) ?? "TaskRun cancelled by agent";
+		if (dryRun) return {
+			ok: true,
+			dryRun: true,
+			action: "cancel_task_run",
+			runId,
+			expectedVersion,
+			reason
+		};
+		const result = new TaskApplicationService().completeRun({
+			runId,
+			expectedRunVersion: expectedVersion,
+			actor: {
+				kind: "agent",
+				id: deps.getCurrentAgentId?.()
+			},
+			terminalCode: "cancelled_by_agent",
+			terminalMessage: reason,
+			receipt: {
+				status: "cancelled",
+				summary: reason,
+				changes: [],
+				evidence: [],
+				verification: {
+					status: "unverified",
+					checks: []
+				},
+				remainingWork: [task.contract?.objective ?? task.title],
+				needsUser: false,
+				completionVerdict: "not_achieved"
+			}
+		});
+		if (result.ok === false) return {
+			ok: false,
+			error: result.reason,
+			...result
+		};
+		return {
+			ok: true,
+			run: runs.get(runId),
+			receipt: runs.getReceipt(runId),
+			model: result.model
 		};
 	}
 	return {
 		ok: false,
-		error: `Unsupported work_item command: ${command}`
+		error: `Unsupported task_run command: ${command}`
 	};
 }
 async function handleLocalApp(command, args, deps, dryRun) {
@@ -791,7 +1635,7 @@ function createXopcUseTool(deps) {
 	return {
 		name: "xopc_use",
 		label: "XOPC Use",
-		description: "Operate first-class xopc objects through one safe entry point. Use for projects, notes, project work items, local apps, and exact settings jump targets instead of editing storage files directly. For non-trivial object changes, load the built-in manual first with tool_manual({ tool: \"xopc_use\" }).",
+		description: "Operate first-class xopc objects through one safe entry point. Use for projects, automations, notes, tasks, TaskRuns, local apps, and exact settings jump targets instead of editing storage files directly. For non-trivial object changes, load the built-in manual first with tool_manual({ tool: \"xopc_use\" }).",
 		parameters: XopcUseToolSchema,
 		mutatesWorkspace: true,
 		mutationScope: "external",
@@ -825,7 +1669,7 @@ function createXopcUseTool(deps) {
 						kind: "xopc_use",
 						toolCallId
 					}
-				}, async () => mode === "project" ? await handleProject(command, args, deps, dryRun) : mode === "note" ? await handleNote(command, args, deps, dryRun) : mode === "work_item" ? await handleWorkItem(command, args, deps, dryRun) : mode === "local_app" ? await handleLocalApp(command, args, deps, dryRun) : mode === "settings" ? handleSettings(command, args) : {
+				}, async () => mode === "project" ? await handleProject(command, args, deps, dryRun) : mode === "automation" ? await handleAutomation(command, args, deps, dryRun) : mode === "note" ? await handleNote(command, args, deps, dryRun) : mode === "task" ? await handleTask(command, args, deps, dryRun) : mode === "task_run" ? await handleTaskRun(command, args, dryRun, deps) : mode === "local_app" ? await handleLocalApp(command, args, deps, dryRun) : mode === "settings" ? handleSettings(command, args) : {
 					ok: false,
 					error: `Unsupported mode: ${String(mode)}`
 				});