@agimon-ai/doompi-task 0.0.1-alpha.71 → 0.0.1-alpha.73

package/dist/src/services/reducer/index.mjs

@@ -0,0 +1,345 @@
+import { detectCycle } from "../../models/taskGraph.mjs";
+import { DELETED_STATUS, isDelegationActive } from "../../models/task.mjs";
+import { isTransitionValid } from "../invariants/index.mjs";
+//#region src/services/reducer/index.ts
+/** Default board capacity when a caller does not provide a configured limit. */
+const DEFAULT_REDUCER_MAX_TASKS = 15;
+/** Bounds the work one call can do, and with it the size of one committed write. */
+const MAX_UPSERT_ITEMS = 100;
+/**
+* A ref must start with a letter, which makes it structurally unconfusable with
+* a stringified id. That is why resolving a dependency token is just a `typeof`
+* check with no coercion heuristics.
+*/
+const REF_PATTERN = /^[A-Za-z][A-Za-z0-9_-]{0,31}$/;
+/**
+* Does this op represent state that must reach disk?
+*
+* The exhaustive switch is the point: a future `Op` variant cannot be added
+* without declaring its persistence intent, so nothing silently starts or stops
+* bumping `rev`.
+*/
+function isCommittingOp(op) {
+	switch (op.kind) {
+		case "error":
+		case "list":
+		case "get": return false;
+		case "upsert": return op.items.some((item) => item.kind === "created" || item.kind === "updated");
+		case "delete":
+		case "clear": return true;
+	}
+}
+/** Joined per-item failures, for the thrown error when an upsert applied nothing. */
+function formatUpsertFailure(op) {
+	return op.items.filter((item) => item.kind === "failed").map((item) => `item[${item.index}]: ${item.message}`).join("\n");
+}
+/** The single item's outcome, for callers that only ever send a batch of one. */
+function singleItemOutcome(op) {
+	return op.kind === "upsert" ? op.items[0] : void 0;
+}
+function errorResult(document, message) {
+	return {
+		document,
+		op: {
+			kind: "error",
+			message
+		}
+	};
+}
+function sameNumberList(a, b) {
+	const x = a ?? [];
+	const y = b ?? [];
+	return x.length === y.length && x.every((value, index) => value === y[index]);
+}
+function sameRecord(a, b) {
+	return JSON.stringify(a ?? null) === JSON.stringify(b ?? null);
+}
+/**
+* Did this update change anything? A no-effect update (status re-set to its
+* current value, fields re-sent unchanged) reports "No change" rather than
+* "Updated #N" — without the distinction a model can loop re-issuing the same
+* call believing it never landed.
+*/
+function taskChanged(before, after) {
+	return before.subject !== after.subject || before.status !== after.status || before.description !== after.description || before.activeForm !== after.activeForm || before.owner !== after.owner || !sameNumberList(before.blockedBy, after.blockedBy) || !sameRecord(before.metadata, after.metadata);
+}
+function withTasks(document, tasks, nextId = document.nextId) {
+	return {
+		...document,
+		tasks,
+		nextId
+	};
+}
+/** Merge incoming metadata over a base; a `null` value deletes its key. */
+function mergeMetadata(base, incoming) {
+	const merged = { ...base };
+	for (const [key, value] of Object.entries(incoming)) if (value === null) delete merged[key];
+	else merged[key] = value;
+	return Object.keys(merged).length ? merged : void 0;
+}
+/** Copy the optional scalar fields an item may set onto a task, in place. */
+function assignScalars(target, item) {
+	if (item.subject !== void 0) target.subject = item.subject;
+	if (item.description !== void 0) target.description = item.description;
+	if (item.activeForm !== void 0) target.activeForm = item.activeForm;
+	if (item.owner !== void 0) target.owner = item.owner;
+	if (item.metadata !== void 0) {
+		const merged = mergeMetadata(target.metadata, item.metadata);
+		if (merged === void 0) delete target.metadata;
+		else target.metadata = merged;
+	}
+}
+function resolveDep(context, field, token) {
+	if (typeof token === "number") return {
+		ok: true,
+		id: token
+	};
+	if (!REF_PATTERN.test(token)) return {
+		ok: false,
+		message: `${field}: "${token}" is not a valid ref; pass an existing task id as a number`
+	};
+	const id = context.refIds.get(token);
+	if (id !== void 0) return {
+		ok: true,
+		id
+	};
+	const failedAt = context.failedRefs.get(token);
+	if (failedAt !== void 0) return {
+		ok: false,
+		message: `${field}: ref "${token}" refers to item[${failedAt}], which failed`
+	};
+	return {
+		ok: false,
+		message: `${field}: unknown ref "${token}" — a ref must be declared by an earlier entry in the same call`
+	};
+}
+function fail(message) {
+	return {
+		ok: false,
+		message
+	};
+}
+/** Structural checks that apply to every entry, whichever kind it is. */
+function checkShape(context, item) {
+	if (item.ref !== void 0) {
+		if (item.id !== void 0) return "ref is only valid when creating a task; drop the id, or drop the ref";
+		if (!REF_PATTERN.test(item.ref)) return `ref "${item.ref}" is invalid: a ref must start with a letter and contain only letters, digits, - or _`;
+		if (context.refIds.get(item.ref) !== void 0 || context.failedRefs.has(item.ref)) return `duplicate ref "${item.ref}": it was already declared by an earlier entry`;
+	}
+}
+function applyCreateItem(context, item, index, now) {
+	if (item.subject === void 0) return fail("subject is required when the entry has no id");
+	if (!item.subject.trim()) return fail("subject must not be blank");
+	if (item.addBlockedBy !== void 0 || item.removeBlockedBy !== void 0) return fail("addBlockedBy / removeBlockedBy are only for an entry with an id; a new task uses blockedBy");
+	if (item.status === "deleted") return fail("cannot create a task with status deleted; create it, then use action delete");
+	if (context.tasks.filter((task) => task.status !== "deleted").length >= context.maxTasks) return fail(`task limit of ${context.maxTasks} reached; delete completed tasks first before creating new tasks`);
+	const blockedBy = [];
+	for (const token of item.blockedBy ?? []) {
+		const resolved = resolveDep(context, "blockedBy", token);
+		if (!resolved.ok) return fail(resolved.message);
+		const dep = context.tasks.find((task) => task.id === resolved.id);
+		if (!dep) return fail(`blockedBy: #${resolved.id} not found`);
+		if (dep.status === "deleted") return fail(`blockedBy: #${resolved.id} is deleted`);
+		if (!blockedBy.includes(resolved.id)) blockedBy.push(resolved.id);
+	}
+	const created = {
+		id: context.nextId,
+		subject: item.subject,
+		status: item.status ?? "pending",
+		createdAt: now,
+		updatedAt: now
+	};
+	assignScalars(created, item);
+	if (blockedBy.length) created.blockedBy = blockedBy;
+	context.nextId += 1;
+	context.tasks.push(created);
+	if (item.ref) context.refIds.set(item.ref, created.id);
+	return {
+		ok: true,
+		outcome: {
+			index,
+			kind: "created",
+			id: created.id,
+			subject: created.subject,
+			status: created.status,
+			...item.ref ? { ref: item.ref } : {},
+			...blockedBy.length ? { blockedBy } : {}
+		}
+	};
+}
+function applyUpdateItem(context, item, index, now) {
+	const id = item.id;
+	const at = context.tasks.findIndex((task) => task.id === id);
+	if (at === -1) return fail(`#${id} not found`);
+	if (item.blockedBy !== void 0) return fail("blockedBy is only for a new entry; use addBlockedBy / removeBlockedBy on an entry that has an id");
+	if (!(item.subject !== void 0 || item.description !== void 0 || item.activeForm !== void 0 || item.status !== void 0 || item.owner !== void 0 || item.metadata !== void 0 || Boolean(item.addBlockedBy?.length) || Boolean(item.removeBlockedBy?.length))) return fail("nothing to change: provide at least one of subject, description, activeForm, status, owner, metadata, addBlockedBy, or removeBlockedBy");
+	const current = context.tasks[at];
+	if (item.subject !== void 0 && !item.subject.trim()) return fail("subject must not be blank");
+	let newStatus = current.status;
+	if (item.status !== void 0) {
+		if (!isTransitionValid(current.status, item.status)) return fail(`illegal transition ${current.status} -> ${item.status}`);
+		newStatus = item.status;
+	}
+	let newBlockedBy = current.blockedBy ? [...current.blockedBy] : [];
+	for (const token of item.removeBlockedBy ?? []) {
+		const resolved = resolveDep(context, "removeBlockedBy", token);
+		if (!resolved.ok) return fail(resolved.message);
+		newBlockedBy = newBlockedBy.filter((dep) => dep !== resolved.id);
+	}
+	for (const token of item.addBlockedBy ?? []) {
+		const resolved = resolveDep(context, "addBlockedBy", token);
+		if (!resolved.ok) return fail(resolved.message);
+		if (resolved.id === id) return fail(`cannot block #${id} on itself`);
+		const dep = context.tasks.find((task) => task.id === resolved.id);
+		if (!dep) return fail(`addBlockedBy: #${resolved.id} not found`);
+		if (dep.status === "deleted") return fail(`addBlockedBy: #${resolved.id} is deleted`);
+		if (!newBlockedBy.includes(resolved.id)) newBlockedBy.push(resolved.id);
+	}
+	const updated = {
+		...current,
+		status: newStatus
+	};
+	assignScalars(updated, item);
+	if (newBlockedBy.length) updated.blockedBy = newBlockedBy;
+	else delete updated.blockedBy;
+	const candidate = [...context.tasks];
+	candidate[at] = updated;
+	if (item.addBlockedBy?.length && detectCycle(candidate, id, newBlockedBy)) return fail("addBlockedBy would create a cycle in the blockedBy graph");
+	const changed = taskChanged(current, updated);
+	if (changed) updated.updatedAt = now;
+	context.tasks = candidate;
+	return {
+		ok: true,
+		outcome: changed ? {
+			index,
+			kind: "updated",
+			id,
+			fromStatus: current.status,
+			toStatus: newStatus
+		} : {
+			index,
+			kind: "unchanged",
+			id,
+			status: newStatus
+		}
+	};
+}
+/**
+* Apply every entry in request order, threading the document.
+*
+* Each entry lands completely or not at all: a create whose dependencies fail
+* is not kept dependency-free, because handing back an unblocked task the
+* caller asked to be blocked is a lie it may immediately act on.
+*/
+function applyUpsert(document, items, now, maxTasks) {
+	const context = {
+		tasks: [...document.tasks],
+		nextId: document.nextId,
+		maxTasks,
+		refIds: /* @__PURE__ */ new Map(),
+		failedRefs: /* @__PURE__ */ new Map()
+	};
+	const outcomes = [];
+	let applied = 0;
+	for (const [index, item] of items.entries()) {
+		const shapeError = checkShape(context, item);
+		const result = shapeError ? fail(shapeError) : item.id === void 0 ? applyCreateItem(context, item, index, now) : applyUpdateItem(context, item, index, now);
+		if (result.ok) {
+			outcomes.push(result.outcome);
+			applied += 1;
+			continue;
+		}
+		if (item.ref && REF_PATTERN.test(item.ref) && !context.refIds.has(item.ref)) context.failedRefs.set(item.ref, index);
+		outcomes.push({
+			index,
+			kind: "failed",
+			message: result.message,
+			...item.id === void 0 ? {} : { id: item.id },
+			...item.ref ? { ref: item.ref } : {}
+		});
+	}
+	return {
+		document: applied > 0 ? withTasks(document, context.tasks, context.nextId) : document,
+		op: {
+			kind: "upsert",
+			items: outcomes,
+			applied,
+			failed: outcomes.length - applied
+		}
+	};
+}
+/**
+* Pure reducer: (document, action, params) -> (document, op).
+*
+* All validation is in-line: structural guards plus state-aware checks
+* (transition legality, dangling or deleted blockedBy, self-block, cycles,
+* in-flight delegations). The caller owns persistence and formatting.
+*/
+function applyTaskMutation(document, action, params, now = (/* @__PURE__ */ new Date()).toISOString(), maxTasks = DEFAULT_REDUCER_MAX_TASKS) {
+	switch (action) {
+		case "upsert": {
+			const items = params.tasks;
+			if (!Array.isArray(items) || items.length === 0) return errorResult(document, "upsert requires a non-empty tasks array, e.g. {\"action\":\"upsert\",\"tasks\":[{\"subject\":\"Write tests\"}]}");
+			if (items.length > 100) return errorResult(document, `upsert accepts at most 100 entries per call (received ${items.length})`);
+			return applyUpsert(document, items, now, maxTasks);
+		}
+		case "list": return {
+			document,
+			op: {
+				kind: "list",
+				includeDeleted: params.includeDeleted === true,
+				...params.status !== void 0 ? { statusFilter: params.status } : {}
+			}
+		};
+		case "get": {
+			if (params.id === void 0) return errorResult(document, "id required for get");
+			const task = document.tasks.find((candidate) => candidate.id === params.id);
+			if (!task) return errorResult(document, `#${params.id} not found`);
+			return {
+				document,
+				op: {
+					kind: "get",
+					task
+				}
+			};
+		}
+		case "delete": {
+			if (params.id === void 0) return errorResult(document, "id required for delete");
+			const index = document.tasks.findIndex((task) => task.id === params.id);
+			if (index === -1) return errorResult(document, `#${params.id} not found`);
+			const current = document.tasks[index];
+			if (current.status === "deleted") return errorResult(document, `#${current.id} is already deleted`);
+			if (isDelegationActive(current)) return errorResult(document, `#${current.id} has a running delegation — cancel it before deleting`);
+			const tasks = [...document.tasks];
+			tasks[index] = {
+				...current,
+				status: DELETED_STATUS,
+				updatedAt: now
+			};
+			return {
+				document: withTasks(document, tasks),
+				op: {
+					kind: "delete",
+					id: current.id,
+					subject: current.subject
+				}
+			};
+		}
+		case "clear": {
+			const active = document.tasks.filter(isDelegationActive);
+			if (active.length > 0) return errorResult(document, `cannot clear while delegations are running (${active.map((task) => `#${task.id}`).join(", ")}) — cancel them first`);
+			const count = document.tasks.length;
+			return {
+				document: withTasks(document, [], 1),
+				op: {
+					kind: "clear",
+					count
+				}
+			};
+		}
+	}
+}
+//#endregion
+export { MAX_UPSERT_ITEMS, REF_PATTERN, applyTaskMutation, formatUpsertFailure, isCommittingOp, singleItemOutcome };
+
+//# sourceMappingURL=index.mjs.map

package/dist/src/services/reducer/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","names":[],"sources":["../../../../src/services/reducer/index.ts"],"sourcesContent":["import {\n  DELETED_STATUS,\n  type DepToken,\n  isDelegationActive,\n  type Task,\n  type TaskAction,\n  type TaskDocument,\n  type TaskItemMutation,\n  type TaskMutationParams,\n  type TaskStatus,\n  type UpsertItemOutcome,\n} from '../../models/task';\nimport { detectCycle } from '../../models/taskGraph';\nimport { isTransitionValid } from '../invariants';\n\n/** Default board capacity when a caller does not provide a configured limit. */\nconst DEFAULT_REDUCER_MAX_TASKS = 15;\n\n/** Bounds the work one call can do, and with it the size of one committed write. */\nexport const MAX_UPSERT_ITEMS = 100;\n\n/**\n * A ref must start with a letter, which makes it structurally unconfusable with\n * a stringified id. That is why resolving a dependency token is just a `typeof`\n * check with no coercion heuristics.\n */\nexport const REF_PATTERN = /^[A-Za-z][A-Za-z0-9_-]{0,31}$/;\n\n/**\n * Reducer outcome. Closed tagged union: adding an action requires extending\n * this union and the response formatter, which the compiler enforces.\n *\n * `upsert` carries one outcome per request item. It is returned even when every\n * item failed — `error` is reserved for whole-call faults — so the tool layer\n * still has the per-item messages to report.\n */\nexport type Op =\n  | { kind: 'upsert'; items: UpsertItemOutcome[]; applied: number; failed: number }\n  | { kind: 'delete'; id: number; subject: string }\n  | { kind: 'list'; statusFilter?: TaskStatus; includeDeleted: boolean }\n  | { kind: 'get'; task: Task }\n  | { kind: 'clear'; count: number }\n  | { kind: 'error'; message: string };\n\nexport interface ApplyResult {\n  document: TaskDocument;\n  op: Op;\n}\n\n/** Actions the reducer owns. `assign`/`cancel` are handled by the delegation manager. */\nexport type ReducerAction = Exclude<TaskAction, 'assign' | 'cancel'>;\n\n/**\n * Does this op represent state that must reach disk?\n *\n * The exhaustive switch is the point: a future `Op` variant cannot be added\n * without declaring its persistence intent, so nothing silently starts or stops\n * bumping `rev`.\n */\nexport function isCommittingOp(op: Op): boolean {\n  switch (op.kind) {\n    case 'error':\n    case 'list':\n    case 'get':\n      return false;\n    case 'upsert':\n      return op.items.some((item) => item.kind === 'created' || item.kind === 'updated');\n    case 'delete':\n    case 'clear':\n      return true;\n  }\n}\n\n/** Joined per-item failures, for the thrown error when an upsert applied nothing. */\nexport function formatUpsertFailure(op: Extract<Op, { kind: 'upsert' }>): string {\n  return op.items\n    .filter((item) => item.kind === 'failed')\n    .map((item) => `item[${item.index}]: ${item.message}`)\n    .join('\\n');\n}\n\n/** The single item's outcome, for callers that only ever send a batch of one. */\nexport function singleItemOutcome(op: Op): UpsertItemOutcome | undefined {\n  return op.kind === 'upsert' ? op.items[0] : undefined;\n}\n\nfunction errorResult(document: TaskDocument, message: string): ApplyResult {\n  return { document, op: { kind: 'error', message } };\n}\n\nfunction sameNumberList(a: number[] | undefined, b: number[] | undefined): boolean {\n  const x = a ?? [];\n  const y = b ?? [];\n  return x.length === y.length && x.every((value, index) => value === y[index]);\n}\n\nfunction sameRecord(a: Record<string, unknown> | undefined, b: Record<string, unknown> | undefined): boolean {\n  return JSON.stringify(a ?? null) === JSON.stringify(b ?? null);\n}\n\n/**\n * Did this update change anything? A no-effect update (status re-set to its\n * current value, fields re-sent unchanged) reports \"No change\" rather than\n * \"Updated #N\" — without the distinction a model can loop re-issuing the same\n * call believing it never landed.\n */\nfunction taskChanged(before: Task, after: Task): boolean {\n  return (\n    before.subject !== after.subject ||\n    before.status !== after.status ||\n    before.description !== after.description ||\n    before.activeForm !== after.activeForm ||\n    before.owner !== after.owner ||\n    !sameNumberList(before.blockedBy, after.blockedBy) ||\n    !sameRecord(before.metadata, after.metadata)\n  );\n}\n\nfunction withTasks(document: TaskDocument, tasks: Task[], nextId = document.nextId): TaskDocument {\n  return { ...document, tasks, nextId };\n}\n\n/** Merge incoming metadata over a base; a `null` value deletes its key. */\nfunction mergeMetadata(\n  base: Record<string, unknown> | undefined,\n  incoming: Record<string, unknown>,\n): Record<string, unknown> | undefined {\n  const merged: Record<string, unknown> = { ...base };\n  for (const [key, value] of Object.entries(incoming)) {\n    if (value === null) delete merged[key];\n    else merged[key] = value;\n  }\n  return Object.keys(merged).length ? merged : undefined;\n}\n\n/** Copy the optional scalar fields an item may set onto a task, in place. */\nfunction assignScalars(target: Task, item: TaskItemMutation): void {\n  if (item.subject !== undefined) target.subject = item.subject;\n  if (item.description !== undefined) target.description = item.description;\n  if (item.activeForm !== undefined) target.activeForm = item.activeForm;\n  if (item.owner !== undefined) target.owner = item.owner;\n  if (item.metadata !== undefined) {\n    const merged = mergeMetadata(target.metadata, item.metadata);\n    if (merged === undefined) delete target.metadata;\n    else target.metadata = merged;\n  }\n}\n\n/**\n * Working state threaded item to item, so entry N observes every effect of\n * entries 1..N-1. `refIds` and `failedRefs` are what make the cascade work:\n * refs resolve backward only, so an entry that names a failed sibling is always\n * processed after the failure that killed it.\n */\ninterface UpsertContext {\n  tasks: Task[];\n  nextId: number;\n  maxTasks: number;\n  refIds: Map<string, number>;\n  failedRefs: Map<string, number>;\n}\n\ntype Resolved = { ok: true; id: number } | { ok: false; message: string };\n\nfunction resolveDep(context: UpsertContext, field: string, token: DepToken): Resolved {\n  if (typeof token === 'number') return { ok: true, id: token };\n  if (!REF_PATTERN.test(token)) {\n    return { ok: false, message: `${field}: \"${token}\" is not a valid ref; pass an existing task id as a number` };\n  }\n  const id = context.refIds.get(token);\n  if (id !== undefined) return { ok: true, id };\n  const failedAt = context.failedRefs.get(token);\n  if (failedAt !== undefined) {\n    return { ok: false, message: `${field}: ref \"${token}\" refers to item[${failedAt}], which failed` };\n  }\n  return {\n    ok: false,\n    message: `${field}: unknown ref \"${token}\" — a ref must be declared by an earlier entry in the same call`,\n  };\n}\n\ntype ItemResult = { ok: true; outcome: UpsertItemOutcome } | { ok: false; message: string };\n\nfunction fail(message: string): ItemResult {\n  return { ok: false, message };\n}\n\n/** Structural checks that apply to every entry, whichever kind it is. */\nfunction checkShape(context: UpsertContext, item: TaskItemMutation): string | undefined {\n  if (item.ref !== undefined) {\n    if (item.id !== undefined) return 'ref is only valid when creating a task; drop the id, or drop the ref';\n    if (!REF_PATTERN.test(item.ref)) {\n      return `ref \"${item.ref}\" is invalid: a ref must start with a letter and contain only letters, digits, - or _`;\n    }\n    const owner = context.refIds.get(item.ref) !== undefined || context.failedRefs.has(item.ref);\n    if (owner) return `duplicate ref \"${item.ref}\": it was already declared by an earlier entry`;\n  }\n  return undefined;\n}\n\nfunction applyCreateItem(context: UpsertContext, item: TaskItemMutation, index: number, now: string): ItemResult {\n  if (item.subject === undefined) return fail('subject is required when the entry has no id');\n  if (!item.subject.trim()) return fail('subject must not be blank');\n  if (item.addBlockedBy !== undefined || item.removeBlockedBy !== undefined) {\n    return fail('addBlockedBy / removeBlockedBy are only for an entry with an id; a new task uses blockedBy');\n  }\n  // A task created as a tombstone is invisible to every view and can never\n  // leave `deleted`, so it would be a write-only black hole.\n  if (item.status === DELETED_STATUS) {\n    return fail('cannot create a task with status deleted; create it, then use action delete');\n  }\n\n  const taskCount = context.tasks.filter((task) => task.status !== DELETED_STATUS).length;\n  if (taskCount >= context.maxTasks) {\n    return fail(`task limit of ${context.maxTasks} reached; delete completed tasks first before creating new tasks`);\n  }\n\n  const blockedBy: number[] = [];\n  for (const token of item.blockedBy ?? []) {\n    const resolved = resolveDep(context, 'blockedBy', token);\n    if (!resolved.ok) return fail(resolved.message);\n    const dep = context.tasks.find((task) => task.id === resolved.id);\n    if (!dep) return fail(`blockedBy: #${resolved.id} not found`);\n    if (dep.status === DELETED_STATUS) return fail(`blockedBy: #${resolved.id} is deleted`);\n    if (!blockedBy.includes(resolved.id)) blockedBy.push(resolved.id);\n  }\n\n  // No cycle check is needed: the id is freshly allocated, so nothing already\n  // in the document can point at it yet.\n  const created: Task = {\n    id: context.nextId,\n    subject: item.subject,\n    status: item.status ?? 'pending',\n    createdAt: now,\n    updatedAt: now,\n  };\n  assignScalars(created, item);\n  if (blockedBy.length) created.blockedBy = blockedBy;\n\n  context.nextId += 1;\n  context.tasks.push(created);\n  if (item.ref) context.refIds.set(item.ref, created.id);\n\n  return {\n    ok: true,\n    outcome: {\n      index,\n      kind: 'created',\n      id: created.id,\n      subject: created.subject,\n      status: created.status,\n      ...(item.ref ? { ref: item.ref } : {}),\n      ...(blockedBy.length ? { blockedBy } : {}),\n    },\n  };\n}\n\nfunction applyUpdateItem(context: UpsertContext, item: TaskItemMutation, index: number, now: string): ItemResult {\n  const id = item.id as number;\n  const at = context.tasks.findIndex((task) => task.id === id);\n  if (at === -1) return fail(`#${id} not found`);\n  if (item.blockedBy !== undefined) {\n    return fail('blockedBy is only for a new entry; use addBlockedBy / removeBlockedBy on an entry that has an id');\n  }\n\n  const hasMutation =\n    item.subject !== undefined ||\n    item.description !== undefined ||\n    item.activeForm !== undefined ||\n    item.status !== undefined ||\n    item.owner !== undefined ||\n    item.metadata !== undefined ||\n    Boolean(item.addBlockedBy?.length) ||\n    Boolean(item.removeBlockedBy?.length);\n  if (!hasMutation) {\n    return fail(\n      'nothing to change: provide at least one of subject, description, activeForm, status, owner, metadata, addBlockedBy, or removeBlockedBy',\n    );\n  }\n\n  const current = context.tasks[at];\n\n  // The Task Space overlay commits free text from an inline editor, so a blank\n  // subject reaches the reducer as a real update rather than as a missing\n  // field. Persisting it would leave an unidentifiable row.\n  if (item.subject !== undefined && !item.subject.trim()) return fail('subject must not be blank');\n\n  let newStatus = current.status;\n  if (item.status !== undefined) {\n    if (!isTransitionValid(current.status, item.status)) {\n      return fail(`illegal transition ${current.status} -> ${item.status}`);\n    }\n    newStatus = item.status;\n  }\n\n  let newBlockedBy = current.blockedBy ? [...current.blockedBy] : [];\n  for (const token of item.removeBlockedBy ?? []) {\n    const resolved = resolveDep(context, 'removeBlockedBy', token);\n    if (!resolved.ok) return fail(resolved.message);\n    // Removing an id that is not there is a well-defined no-op, so unlike the\n    // add path this deliberately skips the existence check.\n    newBlockedBy = newBlockedBy.filter((dep) => dep !== resolved.id);\n  }\n  for (const token of item.addBlockedBy ?? []) {\n    const resolved = resolveDep(context, 'addBlockedBy', token);\n    if (!resolved.ok) return fail(resolved.message);\n    if (resolved.id === id) return fail(`cannot block #${id} on itself`);\n    const dep = context.tasks.find((task) => task.id === resolved.id);\n    if (!dep) return fail(`addBlockedBy: #${resolved.id} not found`);\n    if (dep.status === DELETED_STATUS) return fail(`addBlockedBy: #${resolved.id} is deleted`);\n    if (!newBlockedBy.includes(resolved.id)) newBlockedBy.push(resolved.id);\n  }\n\n  const updated: Task = { ...current, status: newStatus };\n  assignScalars(updated, item);\n  if (newBlockedBy.length) updated.blockedBy = newBlockedBy;\n  else delete updated.blockedBy;\n\n  // The candidate is written before the check because `detectCycle` unions the\n  // node's stored edges with the ones passed in: checking against the old array\n  // would resurrect an edge `removeBlockedBy` just stripped and reject a\n  // remove+add that legitimately breaks a cycle.\n  const candidate = [...context.tasks];\n  candidate[at] = updated;\n  if (item.addBlockedBy?.length && detectCycle(candidate, id, newBlockedBy)) {\n    return fail('addBlockedBy would create a cycle in the blockedBy graph');\n  }\n\n  const changed = taskChanged(current, updated);\n  if (changed) updated.updatedAt = now;\n  context.tasks = candidate;\n\n  return {\n    ok: true,\n    outcome: changed\n      ? { index, kind: 'updated', id, fromStatus: current.status, toStatus: newStatus }\n      : { index, kind: 'unchanged', id, status: newStatus },\n  };\n}\n\n/**\n * Apply every entry in request order, threading the document.\n *\n * Each entry lands completely or not at all: a create whose dependencies fail\n * is not kept dependency-free, because handing back an unblocked task the\n * caller asked to be blocked is a lie it may immediately act on.\n */\nfunction applyUpsert(document: TaskDocument, items: TaskItemMutation[], now: string, maxTasks: number): ApplyResult {\n  const context: UpsertContext = {\n    tasks: [...document.tasks],\n    nextId: document.nextId,\n    maxTasks,\n    refIds: new Map(),\n    failedRefs: new Map(),\n  };\n  const outcomes: UpsertItemOutcome[] = [];\n  let applied = 0;\n\n  for (const [index, item] of items.entries()) {\n    const shapeError = checkShape(context, item);\n    const result = shapeError\n      ? fail(shapeError)\n      : item.id === undefined\n        ? applyCreateItem(context, item, index, now)\n        : applyUpdateItem(context, item, index, now);\n\n    if (result.ok) {\n      outcomes.push(result.outcome);\n      applied += 1;\n      continue;\n    }\n    // A ref whose owner failed must not read as a typo to the entries that\n    // depend on it, so the dead ref is recorded rather than left unknown.\n    if (item.ref && REF_PATTERN.test(item.ref) && !context.refIds.has(item.ref)) {\n      context.failedRefs.set(item.ref, index);\n    }\n    outcomes.push({\n      index,\n      kind: 'failed',\n      message: result.message,\n      ...(item.id === undefined ? {} : { id: item.id }),\n      ...(item.ref ? { ref: item.ref } : {}),\n    });\n  }\n\n  return {\n    // Nothing applied means nothing to write: returning the original object by\n    // reference keeps the caller's write-skip path identical to a hard error.\n    document: applied > 0 ? withTasks(document, context.tasks, context.nextId) : document,\n    op: { kind: 'upsert', items: outcomes, applied, failed: outcomes.length - applied },\n  };\n}\n\n/**\n * Pure reducer: (document, action, params) -> (document, op).\n *\n * All validation is in-line: structural guards plus state-aware checks\n * (transition legality, dangling or deleted blockedBy, self-block, cycles,\n * in-flight delegations). The caller owns persistence and formatting.\n */\nexport function applyTaskMutation(\n  document: TaskDocument,\n  action: ReducerAction,\n  params: TaskMutationParams,\n  now: string = new Date().toISOString(),\n  maxTasks = DEFAULT_REDUCER_MAX_TASKS,\n): ApplyResult {\n  switch (action) {\n    case 'upsert': {\n      const items = params.tasks;\n      if (!Array.isArray(items) || items.length === 0) {\n        return errorResult(\n          document,\n          'upsert requires a non-empty tasks array, e.g. {\"action\":\"upsert\",\"tasks\":[{\"subject\":\"Write tests\"}]}',\n        );\n      }\n      if (items.length > MAX_UPSERT_ITEMS) {\n        return errorResult(\n          document,\n          `upsert accepts at most ${MAX_UPSERT_ITEMS} entries per call (received ${items.length})`,\n        );\n      }\n      return applyUpsert(document, items, now, maxTasks);\n    }\n\n    case 'list': {\n      return {\n        document,\n        op: {\n          kind: 'list',\n          includeDeleted: params.includeDeleted === true,\n          ...(params.status !== undefined ? { statusFilter: params.status } : {}),\n        },\n      };\n    }\n\n    case 'get': {\n      if (params.id === undefined) return errorResult(document, 'id required for get');\n      const task = document.tasks.find((candidate) => candidate.id === params.id);\n      if (!task) return errorResult(document, `#${params.id} not found`);\n      return { document, op: { kind: 'get', task } };\n    }\n\n    case 'delete': {\n      if (params.id === undefined) return errorResult(document, 'id required for delete');\n      const index = document.tasks.findIndex((task) => task.id === params.id);\n      if (index === -1) return errorResult(document, `#${params.id} not found`);\n      const current = document.tasks[index];\n      if (current.status === DELETED_STATUS) return errorResult(document, `#${current.id} is already deleted`);\n      if (isDelegationActive(current)) {\n        return errorResult(document, `#${current.id} has a running delegation — cancel it before deleting`);\n      }\n\n      const tasks = [...document.tasks];\n      tasks[index] = { ...current, status: DELETED_STATUS, updatedAt: now };\n      return {\n        document: withTasks(document, tasks),\n        op: { kind: 'delete', id: current.id, subject: current.subject },\n      };\n    }\n\n    case 'clear': {\n      const active = document.tasks.filter(isDelegationActive);\n      if (active.length > 0) {\n        const ids = active.map((task) => `#${task.id}`).join(', ');\n        return errorResult(document, `cannot clear while delegations are running (${ids}) — cancel them first`);\n      }\n      const count = document.tasks.length;\n      return {\n        document: withTasks(document, [], 1),\n        op: { kind: 'clear', count },\n      };\n    }\n  }\n}\n"],"mappings":"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"}

package/dist/src/services/taskNarration/index.cjs

@@ -0,0 +1,32 @@
+//#region src/services/taskNarration/index.ts
+const COMPLETED_STATUS = "completed";
+const CANCELLED_STATE = "cancelled";
+const DELETED_STATUS = "deleted";
+function visibleTasks(document) {
+	return document.tasks.filter((task) => task.status !== DELETED_STATUS);
+}
+function formatTasks(prefix, tasks) {
+	return `${prefix} ${tasks.map((task) => `Task ${task.id}: ${task.subject}`).join(". ")}.`;
+}
+/**
+* Translate committed task-domain transitions into generic speech requests.
+* Voice remains unaware of tasks; this service owns all task-specific wording.
+*/
+function narrateTaskCommit(requester, previous, committed) {
+	const previousById = new Map(previous.tasks.map((task) => [task.id, task]));
+	const created = visibleTasks(committed).filter((task) => !previousById.has(task.id));
+	if (created.length > 0) {
+		const prefix = visibleTasks(previous).length === 0 ? "Task list created." : "Task list updated.";
+		requester.narrate(formatTasks(prefix, created));
+	}
+	for (const task of committed.tasks) {
+		const prior = previousById.get(task.id);
+		if (!prior) continue;
+		if (prior.status !== COMPLETED_STATUS && task.status === COMPLETED_STATUS) requester.narrate(`Task completed: ${task.subject}.`);
+		if (prior.delegation?.state !== CANCELLED_STATE && task.delegation?.state === CANCELLED_STATE) requester.narrate(`Task cancelled: ${task.subject}.`);
+	}
+}
+//#endregion
+exports.narrateTaskCommit = narrateTaskCommit;
+
+//# sourceMappingURL=index.cjs.map

package/dist/src/services/taskNarration/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs","names":[],"sources":["../../../../src/services/taskNarration/index.ts"],"sourcesContent":["import type { Task, TaskDocument } from '../../models/task';\n\n/** Package-local narration sink; the Pi adapter binds it to the injected Cordis service. */\nexport interface TaskNarrationSink {\n  narrate(text: string): void;\n}\n\nconst COMPLETED_STATUS = 'completed';\nconst CANCELLED_STATE = 'cancelled';\nconst DELETED_STATUS = 'deleted';\n\nfunction visibleTasks(document: TaskDocument): Task[] {\n  return document.tasks.filter((task) => task.status !== DELETED_STATUS);\n}\n\nfunction formatTasks(prefix: string, tasks: Task[]): string {\n  const entries = tasks.map((task) => `Task ${task.id}: ${task.subject}`);\n  return `${prefix} ${entries.join('. ')}.`;\n}\n\n/**\n * Translate committed task-domain transitions into generic speech requests.\n * Voice remains unaware of tasks; this service owns all task-specific wording.\n */\nexport function narrateTaskCommit(requester: TaskNarrationSink, previous: TaskDocument, committed: TaskDocument): void {\n  const previousById = new Map(previous.tasks.map((task) => [task.id, task]));\n  const created = visibleTasks(committed).filter((task) => !previousById.has(task.id));\n  if (created.length > 0) {\n    const prefix = visibleTasks(previous).length === 0 ? 'Task list created.' : 'Task list updated.';\n    requester.narrate(formatTasks(prefix, created));\n  }\n\n  for (const task of committed.tasks) {\n    const prior = previousById.get(task.id);\n    if (!prior) continue;\n    if (prior.status !== COMPLETED_STATUS && task.status === COMPLETED_STATUS) {\n      requester.narrate(`Task completed: ${task.subject}.`);\n    }\n    if (prior.delegation?.state !== CANCELLED_STATE && task.delegation?.state === CANCELLED_STATE) {\n      requester.narrate(`Task cancelled: ${task.subject}.`);\n    }\n  }\n}\n"],"mappings":";AAOA,MAAM,mBAAmB;AACzB,MAAM,kBAAkB;AACxB,MAAM,iBAAiB;AAEvB,SAAS,aAAa,UAAgC;CACpD,OAAO,SAAS,MAAM,QAAQ,SAAS,KAAK,WAAW,cAAc;AACvE;AAEA,SAAS,YAAY,QAAgB,OAAuB;CAE1D,OAAO,GAAG,OAAO,GADD,MAAM,KAAK,SAAS,QAAQ,KAAK,GAAG,IAAI,KAAK,SACnC,CAAC,CAAC,KAAK,IAAI,EAAE;AACzC;;;;;AAMA,SAAgB,kBAAkB,WAA8B,UAAwB,WAA+B;CACrH,MAAM,eAAe,IAAI,IAAI,SAAS,MAAM,KAAK,SAAS,CAAC,KAAK,IAAI,IAAI,CAAC,CAAC;CAC1E,MAAM,UAAU,aAAa,SAAS,CAAC,CAAC,QAAQ,SAAS,CAAC,aAAa,IAAI,KAAK,EAAE,CAAC;CACnF,IAAI,QAAQ,SAAS,GAAG;EACtB,MAAM,SAAS,aAAa,QAAQ,CAAC,CAAC,WAAW,IAAI,uBAAuB;EAC5E,UAAU,QAAQ,YAAY,QAAQ,OAAO,CAAC;CAChD;CAEA,KAAK,MAAM,QAAQ,UAAU,OAAO;EAClC,MAAM,QAAQ,aAAa,IAAI,KAAK,EAAE;EACtC,IAAI,CAAC,OAAO;EACZ,IAAI,MAAM,WAAW,oBAAoB,KAAK,WAAW,kBACvD,UAAU,QAAQ,mBAAmB,KAAK,QAAQ,EAAE;EAEtD,IAAI,MAAM,YAAY,UAAU,mBAAmB,KAAK,YAAY,UAAU,iBAC5E,UAAU,QAAQ,mBAAmB,KAAK,QAAQ,EAAE;CAExD;AACF"}

package/dist/src/services/taskNarration/index.mjs

@@ -0,0 +1,32 @@
+//#region src/services/taskNarration/index.ts
+const COMPLETED_STATUS = "completed";
+const CANCELLED_STATE = "cancelled";
+const DELETED_STATUS = "deleted";
+function visibleTasks(document) {
+	return document.tasks.filter((task) => task.status !== DELETED_STATUS);
+}
+function formatTasks(prefix, tasks) {
+	return `${prefix} ${tasks.map((task) => `Task ${task.id}: ${task.subject}`).join(". ")}.`;
+}
+/**
+* Translate committed task-domain transitions into generic speech requests.
+* Voice remains unaware of tasks; this service owns all task-specific wording.
+*/
+function narrateTaskCommit(requester, previous, committed) {
+	const previousById = new Map(previous.tasks.map((task) => [task.id, task]));
+	const created = visibleTasks(committed).filter((task) => !previousById.has(task.id));
+	if (created.length > 0) {
+		const prefix = visibleTasks(previous).length === 0 ? "Task list created." : "Task list updated.";
+		requester.narrate(formatTasks(prefix, created));
+	}
+	for (const task of committed.tasks) {
+		const prior = previousById.get(task.id);
+		if (!prior) continue;
+		if (prior.status !== COMPLETED_STATUS && task.status === COMPLETED_STATUS) requester.narrate(`Task completed: ${task.subject}.`);
+		if (prior.delegation?.state !== CANCELLED_STATE && task.delegation?.state === CANCELLED_STATE) requester.narrate(`Task cancelled: ${task.subject}.`);
+	}
+}
+//#endregion
+export { narrateTaskCommit };
+
+//# sourceMappingURL=index.mjs.map

package/dist/src/services/taskNarration/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","names":[],"sources":["../../../../src/services/taskNarration/index.ts"],"sourcesContent":["import type { Task, TaskDocument } from '../../models/task';\n\n/** Package-local narration sink; the Pi adapter binds it to the injected Cordis service. */\nexport interface TaskNarrationSink {\n  narrate(text: string): void;\n}\n\nconst COMPLETED_STATUS = 'completed';\nconst CANCELLED_STATE = 'cancelled';\nconst DELETED_STATUS = 'deleted';\n\nfunction visibleTasks(document: TaskDocument): Task[] {\n  return document.tasks.filter((task) => task.status !== DELETED_STATUS);\n}\n\nfunction formatTasks(prefix: string, tasks: Task[]): string {\n  const entries = tasks.map((task) => `Task ${task.id}: ${task.subject}`);\n  return `${prefix} ${entries.join('. ')}.`;\n}\n\n/**\n * Translate committed task-domain transitions into generic speech requests.\n * Voice remains unaware of tasks; this service owns all task-specific wording.\n */\nexport function narrateTaskCommit(requester: TaskNarrationSink, previous: TaskDocument, committed: TaskDocument): void {\n  const previousById = new Map(previous.tasks.map((task) => [task.id, task]));\n  const created = visibleTasks(committed).filter((task) => !previousById.has(task.id));\n  if (created.length > 0) {\n    const prefix = visibleTasks(previous).length === 0 ? 'Task list created.' : 'Task list updated.';\n    requester.narrate(formatTasks(prefix, created));\n  }\n\n  for (const task of committed.tasks) {\n    const prior = previousById.get(task.id);\n    if (!prior) continue;\n    if (prior.status !== COMPLETED_STATUS && task.status === COMPLETED_STATUS) {\n      requester.narrate(`Task completed: ${task.subject}.`);\n    }\n    if (prior.delegation?.state !== CANCELLED_STATE && task.delegation?.state === CANCELLED_STATE) {\n      requester.narrate(`Task cancelled: ${task.subject}.`);\n    }\n  }\n}\n"],"mappings":";AAOA,MAAM,mBAAmB;AACzB,MAAM,kBAAkB;AACxB,MAAM,iBAAiB;AAEvB,SAAS,aAAa,UAAgC;CACpD,OAAO,SAAS,MAAM,QAAQ,SAAS,KAAK,WAAW,cAAc;AACvE;AAEA,SAAS,YAAY,QAAgB,OAAuB;CAE1D,OAAO,GAAG,OAAO,GADD,MAAM,KAAK,SAAS,QAAQ,KAAK,GAAG,IAAI,KAAK,SACnC,CAAC,CAAC,KAAK,IAAI,EAAE;AACzC;;;;;AAMA,SAAgB,kBAAkB,WAA8B,UAAwB,WAA+B;CACrH,MAAM,eAAe,IAAI,IAAI,SAAS,MAAM,KAAK,SAAS,CAAC,KAAK,IAAI,IAAI,CAAC,CAAC;CAC1E,MAAM,UAAU,aAAa,SAAS,CAAC,CAAC,QAAQ,SAAS,CAAC,aAAa,IAAI,KAAK,EAAE,CAAC;CACnF,IAAI,QAAQ,SAAS,GAAG;EACtB,MAAM,SAAS,aAAa,QAAQ,CAAC,CAAC,WAAW,IAAI,uBAAuB;EAC5E,UAAU,QAAQ,YAAY,QAAQ,OAAO,CAAC;CAChD;CAEA,KAAK,MAAM,QAAQ,UAAU,OAAO;EAClC,MAAM,QAAQ,aAAa,IAAI,KAAK,EAAE;EACtC,IAAI,CAAC,OAAO;EACZ,IAAI,MAAM,WAAW,oBAAoB,KAAK,WAAW,kBACvD,UAAU,QAAQ,mBAAmB,KAAK,QAAQ,EAAE;EAEtD,IAAI,MAAM,YAAY,UAAU,mBAAmB,KAAK,YAAY,UAAU,iBAC5E,UAAU,QAAQ,mBAAmB,KAAK,QAAQ,EAAE;CAExD;AACF"}

package/dist/src/services/taskResult/index.cjs

@@ -0,0 +1,174 @@
+const require_taskGraph = require("../../models/taskGraph.cjs");
+//#region src/services/taskResult/index.ts
+const MSG_ALL_COMPLETE_CLEAR = "All tasks are completed. Review the full task list once more, then close it with task {\"action\":\"clear\"}.";
+/**
+* Steering for a mixed batch. Unlike a batch of spawned subagents, a failed
+* entry here had no side effect at all, so retrying the failures is the safe
+* move and the model must be told so or it will do nothing. The hazard is the
+* other half: resending an applied create would make a second task.
+*/
+const MSG_UPSERT_PARTIAL = "The applied entries are committed. Resend only the failed entries, corrected — a failed entry changed nothing, so a corrected retry is safe. Do not resend an entry that already applied: an entry without an id creates a second task.";
+const MSG_UPSERT_NONE_APPLIED = "No task changed, so the whole call can be resent once corrected.";
+const MSG_ASSIGN_PARTIAL = "Successful assignments are already running. Retry only the failed entries after correcting their task state or arguments; do not resend successful entries.";
+/** LLM-facing report for a native assignment batch. */
+function formatAssignmentResults(items) {
+	if (items.length === 1) return items[0].message;
+	const succeeded = items.filter((item) => item.ok).length;
+	const failed = items.length - succeeded;
+	const lines = [`Assigned ${succeeded}/${items.length} tasks${failed > 0 ? `; ${failed} failed` : ""}.`, ...items.map((item) => item.ok ? `- [${item.index}] Delegated #${item.id} to ${item.agent}` : `- [${item.index}] Failed #${item.id} → ${item.agent}: ${item.message}`)];
+	if (failed > 0 && succeeded > 0) lines.push("", MSG_ASSIGN_PARTIAL);
+	if (failed === 0) lines.push("", "All assignments are running independently in the background. Continue non-overlapping work, or end your turn.");
+	return lines.join("\n");
+}
+/** `[status] #id subject (activeForm) [agent] ⛓ #dep` — the `list` line format. */
+function formatListLine(task) {
+	const block = task.blockedBy?.length ? ` ⛓ ${task.blockedBy.map((id) => `#${id}`).join(",")}` : "";
+	const form = task.status === "in_progress" && task.activeForm ? ` (${task.activeForm})` : "";
+	const delegated = task.delegation && task.delegation.state !== "cancelled" ? ` [${task.delegation.agent}]` : "";
+	return `[${task.status}] #${task.id} ${task.subject}${form}${delegated}${block}`;
+}
+function formatDelegationLines(task) {
+	const delegation = task.delegation;
+	if (!delegation) return [];
+	const lines = [`  delegated to: ${delegation.agent} (${delegation.state})`];
+	if (delegation.model) lines.push(`  model: ${delegation.model}`);
+	if (delegation.result?.error) lines.push(`  error: ${delegation.result.error}`);
+	if (delegation.result?.outputPath) lines.push(`  output file: ${delegation.result.outputPath}`);
+	if (delegation.result?.output) lines.push(`  output: ${delegation.result.output}`);
+	return lines;
+}
+function formatGetLines(task, document) {
+	const blocks = require_taskGraph.deriveBlocks(document.tasks).get(task.id) ?? [];
+	const lines = [`#${task.id} [${task.status}] ${task.subject}`];
+	if (task.description) lines.push(`  description: ${task.description}`);
+	if (task.activeForm) lines.push(`  activeForm: ${task.activeForm}`);
+	if (task.blockedBy?.length) lines.push(`  blockedBy: ${task.blockedBy.map((id) => `#${id}`).join(", ")}`);
+	if (blocks.length) lines.push(`  blocks: ${blocks.map((id) => `#${id}`).join(", ")}`);
+	if (task.owner) lines.push(`  owner: ${task.owner}`);
+	lines.push(...formatDelegationLines(task));
+	return lines.join("\n");
+}
+/** One entry's outcome. Batch lines prefix this with `- [n] `. */
+function formatUpsertItem(item) {
+	switch (item.kind) {
+		case "created": {
+			const ref = item.ref ? ` (ref "${item.ref}")` : "";
+			const deps = item.blockedBy?.length ? ` — blocked by ${item.blockedBy.map((id) => `#${id}`).join(", ")}` : "";
+			return `Created #${item.id}${ref}: ${item.subject} (${item.status})${deps}`;
+		}
+		case "updated": {
+			const transition = item.fromStatus === item.toStatus ? "" : ` (${item.fromStatus} -> ${item.toStatus})`;
+			return `Updated #${item.id}${transition}`;
+		}
+		case "unchanged": return `No change: #${item.id} already matches the requested values (status: ${item.status})`;
+		case "failed": return `Failed${item.id === void 0 ? "" : ` #${item.id}`}: ${item.message}`;
+	}
+}
+/**
+* The thrown message when an upsert applied nothing. Kept separate from
+* `formatContent` because the caller wraps it in the actionable Options block
+* rather than returning it as a successful result.
+*/
+function formatUpsertFailureText(op) {
+	if (op.items.length === 1) return op.items[0].kind === "failed" ? op.items[0].message : "no entry was applied";
+	return [
+		"no entry was applied.",
+		...op.items.map((item) => `- [${item.index}] ${formatUpsertItem(item)}`),
+		MSG_UPSERT_NONE_APPLIED
+	].join("\n");
+}
+/**
+* Pure formatter: `(op, document) -> string`. The switch is closed over `Op`,
+* so a new reducer variant fails to compile until it is handled here.
+*/
+function formatContent(op, document) {
+	switch (op.kind) {
+		case "upsert": {
+			const lines = op.items.length === 1 ? [formatUpsertItem(op.items[0])] : [
+				`Upsert applied ${op.applied}/${op.items.length} entries${op.failed > 0 ? `; ${op.failed} failed` : ""}.`,
+				...op.items.map((item) => `- [${item.index}] ${formatUpsertItem(item)}`),
+				...op.failed > 0 ? ["", MSG_UPSERT_PARTIAL] : []
+			];
+			if (op.applied > 0 && require_taskGraph.isTaskListComplete(document.tasks)) lines.push(MSG_ALL_COMPLETE_CLEAR);
+			return lines.join("\n");
+		}
+		case "delete": return `Deleted #${op.id}: ${op.subject}`;
+		case "clear": return `Closed task list (cleared ${op.count} tasks)`;
+		case "list": {
+			let view = document.tasks;
+			if (!op.includeDeleted) view = view.filter((task) => task.status !== "deleted");
+			if (op.statusFilter) view = view.filter((task) => task.status === op.statusFilter);
+			return view.length === 0 ? "No tasks" : view.map(formatListLine).join("\n");
+		}
+		case "get": return formatGetLines(op.task, document);
+		case "error": return `Error: ${op.message}`;
+	}
+}
+/** Build the LLM-facing envelope. `details` carries the post-mutation snapshot. */
+function buildToolResult(action, params, document, op) {
+	return {
+		content: [{
+			type: "text",
+			text: formatContent(op, document)
+		}],
+		details: {
+			action,
+			params,
+			tasks: document.tasks,
+			nextId: document.nextId,
+			rev: document.rev,
+			...op.kind === "error" ? { error: op.message } : {},
+			...op.kind === "upsert" ? { upsert: {
+				applied: op.items.flatMap((item) => item.kind === "failed" ? [] : [item.id]),
+				failed: op.failed
+			} } : {}
+		}
+	};
+}
+/** Envelope for a native assignment batch, including ids used by the consolidated TUI result. */
+function buildAssignmentResult(params, document, text, assignment) {
+	return {
+		content: [{
+			type: "text",
+			text
+		}],
+		details: {
+			action: "assign",
+			params,
+			tasks: document.tasks,
+			nextId: document.nextId,
+			rev: document.rev,
+			assignment
+		}
+	};
+}
+/** Envelope for delegation actions, which do not flow through the reducer. */
+function buildTextResult(action, params, document, text, error) {
+	return {
+		content: [{
+			type: "text",
+			text: error ? `Error: ${error}` : text
+		}],
+		details: {
+			action,
+			params,
+			tasks: document.tasks,
+			nextId: document.nextId,
+			rev: document.rev,
+			...error ? { error } : {}
+		}
+	};
+}
+//#endregion
+exports.MSG_ALL_COMPLETE_CLEAR = MSG_ALL_COMPLETE_CLEAR;
+exports.MSG_ASSIGN_PARTIAL = MSG_ASSIGN_PARTIAL;
+exports.MSG_UPSERT_NONE_APPLIED = MSG_UPSERT_NONE_APPLIED;
+exports.MSG_UPSERT_PARTIAL = MSG_UPSERT_PARTIAL;
+exports.buildAssignmentResult = buildAssignmentResult;
+exports.buildTextResult = buildTextResult;
+exports.buildToolResult = buildToolResult;
+exports.formatAssignmentResults = formatAssignmentResults;
+exports.formatContent = formatContent;
+exports.formatUpsertFailureText = formatUpsertFailureText;
+
+//# sourceMappingURL=index.cjs.map