@wrongstack/tools 0.313.1 → 0.316.1

package/dist/{chunk-55KF77OK.js → chunk-JNNVRHMV.js}

@@ -1,7 +1,7 @@
 import {
   applySessionKanbanTaskToSource,
   taskFileToSerializedGraph
-} from "./chunk-QNJ7AQ4B.js";
+} from "./chunk-PY2IOS7C.js";
 
 // src/kanban.ts
 import { stripLifecycleIssues as stripLifecycleIssues2 } from "@wrongstack/kanban";
@@ -99,7 +99,7 @@ function okTask(board, task, message) {
 }
 
 // src/kanban-split-task-handler.ts
-async function handleSplitTask(projectRoot, input, extraSplitOptions) {
+async function handleSplitTask(projectRoot, input, extraSplitOptions, eventContext) {
   const boardId = input.boardId;
   const taskId = input.taskId;
   const childTitles = input.childTitles;
@@ -116,18 +116,24 @@ async function handleSplitTask(projectRoot, input, extraSplitOptions) {
     chainChildren,
     rewireDependents
   } = input;
-  const result = await splitTask(projectRoot, boardId, taskId, {
-    titles: childTitles,
-    ...extraSplitOptions,
-    ...targetColumnId !== void 0 ? { columnId: targetColumnId } : {},
-    ...inheritAssignment !== void 0 ? { inheritAssignment } : {},
-    ...inheritLabels !== void 0 ? { inheritLabels } : {},
-    ...inheritSuccessCriteria !== void 0 ? { inheritSuccessCriteria } : {},
-    ...inheritGoalMetrics !== void 0 ? { inheritGoalMetrics } : {},
-    ...inheritDependencies !== void 0 ? { inheritDependencies } : {},
-    ...chainChildren !== void 0 ? { chainChildren } : {},
-    ...rewireDependents !== void 0 ? { rewireDependents } : {}
-  });
+  const result = await splitTask(
+    projectRoot,
+    boardId,
+    taskId,
+    {
+      titles: childTitles,
+      ...extraSplitOptions,
+      ...targetColumnId !== void 0 ? { columnId: targetColumnId } : {},
+      ...inheritAssignment !== void 0 ? { inheritAssignment } : {},
+      ...inheritLabels !== void 0 ? { inheritLabels } : {},
+      ...inheritSuccessCriteria !== void 0 ? { inheritSuccessCriteria } : {},
+      ...inheritGoalMetrics !== void 0 ? { inheritGoalMetrics } : {},
+      ...inheritDependencies !== void 0 ? { inheritDependencies } : {},
+      ...chainChildren !== void 0 ? { chainChildren } : {},
+      ...rewireDependents !== void 0 ? { rewireDependents } : {}
+    },
+    eventContext
+  );
   if (!result) return fail("Task not found.");
   const freshParent = result.board.tasks?.find((t) => t.id === taskId);
   if (!freshParent) {
@@ -149,6 +155,10 @@ async function requireBoard(projectRoot, boardId) {
 
 // src/kanban-board-actions.ts
 async function handleKanbanBoardAction(projectRoot, input, ctx) {
+  const eventContext = {
+    sessionId: ctx.eventSessionId(),
+    ...ctx.agentId !== void 0 ? { actor: ctx.agentId } : {}
+  };
   switch (input.action) {
     case "list_boards": {
       const boards = await listBoards(projectRoot);
@@ -226,7 +236,7 @@ async function handleKanbanBoardAction(projectRoot, input, ctx) {
         input.description,
         board.columns[0]?.id ?? "backlog"
       )) {
-        await addTask(projectRoot, board.id, tInput);
+        await addTask(projectRoot, board.id, tInput, eventContext);
       }
       return okBoard(await getBoard2(projectRoot, board.id) ?? board, "Board generated.");
     }
@@ -406,7 +416,8 @@ import {
   removeContractNode,
   upsertContractNode
 } from "@wrongstack/kanban";
-async function handleKanbanContractAction(projectRoot, input, actor) {
+async function handleKanbanContractAction(projectRoot, input, actor, sessionId) {
+  const eventContext = { sessionId, ...actor !== void 0 ? { actor } : {} };
   switch (input.action) {
     case "get_contract_graph": {
       if (!input.boardId) return fail("get_contract_graph requires boardId.");
@@ -425,7 +436,12 @@ async function handleKanbanContractAction(projectRoot, input, actor) {
     case "configure_contract_graph": {
       if (!input.boardId) return fail("configure_contract_graph requires boardId.");
       const enforcement = input.contractEnforcement ?? "advisory";
-      const board = await configureContractGraph(projectRoot, input.boardId, enforcement);
+      const board = await configureContractGraph(
+        projectRoot,
+        input.boardId,
+        enforcement,
+        eventContext
+      );
       return board ? okBoard(board, `Contract map enforcement set to ${enforcement}.`) : fail("Board not found.");
     }
     case "upsert_contract_node": {
@@ -443,19 +459,24 @@ async function handleKanbanContractAction(projectRoot, input, actor) {
       if (waiver && !waiver.reason.trim()) {
         return fail("A waived contract node requires contractWaiverReason.");
       }
-      const result = await upsertContractNode(projectRoot, input.boardId, {
-        taskId: input.taskId,
-        kind: input.contractNodeKind,
-        title: input.contractNodeTitle,
-        ...input.contractNodeId !== void 0 ? { id: input.contractNodeId } : {},
-        ...input.contractNodeDescription !== void 0 ? { description: input.contractNodeDescription } : {},
-        ...input.contractNodeState !== void 0 ? { state: input.contractNodeState } : {},
-        ...input.contractNodeEnforcement !== void 0 ? { enforcement: input.contractNodeEnforcement } : {},
-        ...input.contractCheckId !== void 0 ? { checkId: input.contractCheckId } : {},
-        ...input.contractMetricId !== void 0 ? { metricId: input.contractMetricId } : {},
-        ...waiver ? { waiver } : {},
-        ...actor !== void 0 ? { createdBy: actor } : {}
-      });
+      const result = await upsertContractNode(
+        projectRoot,
+        input.boardId,
+        {
+          taskId: input.taskId,
+          kind: input.contractNodeKind,
+          title: input.contractNodeTitle,
+          ...input.contractNodeId !== void 0 ? { id: input.contractNodeId } : {},
+          ...input.contractNodeDescription !== void 0 ? { description: input.contractNodeDescription } : {},
+          ...input.contractNodeState !== void 0 ? { state: input.contractNodeState } : {},
+          ...input.contractNodeEnforcement !== void 0 ? { enforcement: input.contractNodeEnforcement } : {},
+          ...input.contractCheckId !== void 0 ? { checkId: input.contractCheckId } : {},
+          ...input.contractMetricId !== void 0 ? { metricId: input.contractMetricId } : {},
+          ...waiver ? { waiver } : {},
+          ...actor !== void 0 ? { createdBy: actor } : {}
+        },
+        eventContext
+      );
       if (!result) return fail("Board or task not found.");
       return {
         ok: true,
@@ -468,7 +489,12 @@ async function handleKanbanContractAction(projectRoot, input, actor) {
       if (!input.boardId || !input.contractNodeId) {
         return fail("remove_contract_node requires boardId and contractNodeId.");
       }
-      const board = await removeContractNode(projectRoot, input.boardId, input.contractNodeId);
+      const board = await removeContractNode(
+        projectRoot,
+        input.boardId,
+        input.contractNodeId,
+        eventContext
+      );
       return board ? okBoard(board, "Contract node removed, along with every edge that touched it.") : fail("Contract node not found.");
     }
     case "add_contract_edge": {
@@ -476,15 +502,20 @@ async function handleKanbanContractAction(projectRoot, input, actor) {
         return fail("add_contract_edge requires boardId, contractEdgeFrom, and contractEdgeTo.");
       }
       if (!input.contractEdgeType) return fail("add_contract_edge requires contractEdgeType.");
-      const result = await addContractEdge(projectRoot, input.boardId, {
-        from: input.contractEdgeFrom,
-        to: input.contractEdgeTo,
-        type: input.contractEdgeType,
-        ...input.contractEdgeId !== void 0 ? { id: input.contractEdgeId } : {},
-        ...input.contractNodeEnforcement !== void 0 ? { enforcement: input.contractNodeEnforcement } : {},
-        ...input.contractEdgeRationale !== void 0 ? { rationale: input.contractEdgeRationale } : {},
-        ...actor !== void 0 ? { createdBy: actor } : {}
-      });
+      const result = await addContractEdge(
+        projectRoot,
+        input.boardId,
+        {
+          from: input.contractEdgeFrom,
+          to: input.contractEdgeTo,
+          type: input.contractEdgeType,
+          ...input.contractEdgeId !== void 0 ? { id: input.contractEdgeId } : {},
+          ...input.contractNodeEnforcement !== void 0 ? { enforcement: input.contractNodeEnforcement } : {},
+          ...input.contractEdgeRationale !== void 0 ? { rationale: input.contractEdgeRationale } : {},
+          ...actor !== void 0 ? { createdBy: actor } : {}
+        },
+        eventContext
+      );
       if (!result) return fail("Board not found.");
       return {
         ok: true,
@@ -497,7 +528,12 @@ async function handleKanbanContractAction(projectRoot, input, actor) {
       if (!input.boardId || !input.contractEdgeId) {
         return fail("remove_contract_edge requires boardId and contractEdgeId.");
       }
-      const board = await removeContractEdge(projectRoot, input.boardId, input.contractEdgeId);
+      const board = await removeContractEdge(
+        projectRoot,
+        input.boardId,
+        input.contractEdgeId,
+        eventContext
+      );
       return board ? okBoard(board, "Contract edge removed.") : fail("Contract edge not found.");
     }
     default:
@@ -538,6 +574,10 @@ function recordKanbanVerificationEvidence(ctx, report) {
 
 // src/kanban-decomposition-actions.ts
 async function handleKanbanDecompositionAction(projectRoot, input, ctx) {
+  const eventContext = {
+    sessionId: ctx.eventSessionId(),
+    ...ctx.agentId !== void 0 ? { actor: ctx.agentId } : {}
+  };
   switch (input.action) {
     case "assess_atomicity": {
       if (!input.boardId || !input.taskId) {
@@ -545,7 +585,7 @@ async function handleKanbanDecompositionAction(projectRoot, input, ctx) {
       }
       const result = await assessTaskAtomicity(projectRoot, input.boardId, input.taskId, {
         assessedBy: "agent",
-        ...ctx.agentId !== void 0 ? { eventContext: { actor: ctx.agentId } } : {}
+        eventContext
       });
       if (!result) return fail("Task not found.");
       const failing = result.assessment.criteria.filter((entry) => entry.score < 1).map((entry) => entry.reason);
@@ -576,7 +616,7 @@ async function handleKanbanDecompositionAction(projectRoot, input, ctx) {
           ...input.note !== void 0 ? { rationale: input.note } : {},
           ...ctx.agentId !== void 0 ? { proposedBy: ctx.agentId } : {}
         },
-        ctx.agentId !== void 0 ? { actor: ctx.agentId } : {}
+        eventContext
       );
       if (!result) return fail("Task not found.");
       const message = result.proposal.status === "applied" ? `Decomposition applied: ${result.proposal.appliedChildTaskIds?.length ?? 0} child tasks created (parent marked atomic).` : 'Decomposition proposal recorded \u2014 awaiting approval (board policy is "propose"). It can be approved from the WebUI or via update_task.';
@@ -587,10 +627,16 @@ async function handleKanbanDecompositionAction(projectRoot, input, ctx) {
         return fail("verify_completion requires boardId and taskId.");
       }
       const verResult = await verifyTaskCompletion(projectRoot, input.boardId, input.taskId);
-      const persistedBoard = await updateTask(projectRoot, input.boardId, input.taskId, {
-        verificationReport: verResult.report,
-        successCriteria: verResult.task.successCriteria
-      });
+      const persistedBoard = await updateTask(
+        projectRoot,
+        input.boardId,
+        input.taskId,
+        {
+          verificationReport: verResult.report,
+          successCriteria: verResult.task.successCriteria
+        },
+        eventContext
+      );
       if (!persistedBoard) {
         return {
           ok: false,
@@ -629,7 +675,11 @@ import {
   updateCheckOnTask,
   updateGoalMetricOnTask
 } from "@wrongstack/kanban";
-async function handleKanbanDetailAction(projectRoot, input) {
+async function handleKanbanDetailAction(projectRoot, input, ctx) {
+  const eventContext = {
+    sessionId: ctx.eventSessionId(),
+    ...ctx.agentId !== void 0 ? { actor: ctx.agentId } : {}
+  };
   switch (input.action) {
     case "workbench": {
       const workbench = await getKanbanWorkbench(projectRoot, {
@@ -649,7 +699,8 @@ async function handleKanbanDetailAction(projectRoot, input) {
         projectRoot,
         input.boardId,
         input.taskId,
-        input.dependencyTaskId
+        input.dependencyTaskId,
+        eventContext
       );
       return board ? okBoard(board, "Dependency added.") : fail("Task not found.");
     }
@@ -657,15 +708,21 @@ async function handleKanbanDetailAction(projectRoot, input) {
       if (!input.boardId || !input.taskId || !input.metricName) {
         return fail("add_goal_metric requires boardId, taskId, and metricName.");
       }
-      const board = await addGoalMetricToTask(projectRoot, input.boardId, input.taskId, {
-        name: input.metricName,
-        ...input.metricStatus !== void 0 ? { status: input.metricStatus } : {},
-        ...input.metricTarget !== void 0 ? { target: input.metricTarget } : {},
-        ...input.metricCurrent !== void 0 ? { current: input.metricCurrent } : {},
-        ...input.metricDirection !== void 0 ? { direction: input.metricDirection } : {},
-        ...input.metricUnit !== void 0 ? { unit: input.metricUnit } : {},
-        ...input.metricNotes !== void 0 ? { notes: input.metricNotes } : {}
-      });
+      const board = await addGoalMetricToTask(
+        projectRoot,
+        input.boardId,
+        input.taskId,
+        {
+          name: input.metricName,
+          ...input.metricStatus !== void 0 ? { status: input.metricStatus } : {},
+          ...input.metricTarget !== void 0 ? { target: input.metricTarget } : {},
+          ...input.metricCurrent !== void 0 ? { current: input.metricCurrent } : {},
+          ...input.metricDirection !== void 0 ? { direction: input.metricDirection } : {},
+          ...input.metricUnit !== void 0 ? { unit: input.metricUnit } : {},
+          ...input.metricNotes !== void 0 ? { notes: input.metricNotes } : {}
+        },
+        eventContext
+      );
       return board ? okBoard(board, "Goal metric added.") : fail("Task not found.");
     }
     case "update_goal_metric": {
@@ -685,7 +742,8 @@ async function handleKanbanDetailAction(projectRoot, input) {
           ...input.metricDirection !== void 0 ? { direction: input.metricDirection } : {},
           ...input.metricUnit !== void 0 ? { unit: input.metricUnit } : {},
           ...input.metricNotes !== void 0 ? { notes: input.metricNotes } : {}
-        }
+        },
+        eventContext
       );
       return board ? okBoard(board, "Goal metric updated.") : fail("Metric not found.");
     }
@@ -693,12 +751,18 @@ async function handleKanbanDetailAction(projectRoot, input) {
       if (!input.boardId || !input.taskId || !input.checkDescription) {
         return fail("add_check requires boardId, taskId, and checkDescription.");
       }
-      const board = await addCheckToTask(projectRoot, input.boardId, input.taskId, {
-        description: input.checkDescription,
-        type: input.checkType ?? "manual",
-        status: input.checkStatus,
-        ...input.checkNotes !== void 0 ? { notes: input.checkNotes } : {}
-      });
+      const board = await addCheckToTask(
+        projectRoot,
+        input.boardId,
+        input.taskId,
+        {
+          description: input.checkDescription,
+          type: input.checkType ?? "manual",
+          status: input.checkStatus,
+          ...input.checkNotes !== void 0 ? { notes: input.checkNotes } : {}
+        },
+        eventContext
+      );
       return board ? okBoard(board, "Check added.") : fail("Task not found.");
     }
     case "update_check": {
@@ -717,7 +781,8 @@ async function handleKanbanDetailAction(projectRoot, input) {
           // common repair: the card was written before anyone knew the command.
           ...input.checkType !== void 0 ? { type: input.checkType } : {},
           ...input.checkNotes !== void 0 ? { notes: input.checkNotes } : {}
-        }
+        },
+        eventContext
       );
       return board ? okBoard(board, "Check updated.") : fail("Check not found.");
     }
@@ -729,34 +794,47 @@ async function handleKanbanDetailAction(projectRoot, input) {
         projectRoot,
         input.boardId,
         input.taskId,
-        input.checkId
+        input.checkId,
+        eventContext
       );
       return board ? okBoard(board, "Acceptance criterion removed.") : fail("Check not found on this task.");
     }
     case "add_note": {
       if (!input.boardId || !input.taskId || !input.note)
         return fail("add_note requires boardId, taskId, and note.");
-      const board = await addNoteToTask(projectRoot, input.boardId, input.taskId, {
-        author: input.author ?? "agent",
-        content: input.note
-      });
+      const board = await addNoteToTask(
+        projectRoot,
+        input.boardId,
+        input.taskId,
+        {
+          author: input.author ?? "agent",
+          content: input.note
+        },
+        eventContext
+      );
       return board ? okBoard(board, "Note added.") : fail("Task not found.");
     }
     case "add_link": {
       if (!input.boardId || !input.taskId || !input.url)
         return fail("add_link requires boardId, taskId, and url.");
-      const board = await addLinkToTask(projectRoot, input.boardId, input.taskId, {
-        url: input.url,
-        type: input.linkType ?? "url",
-        ...input.linkTitle !== void 0 ? { title: input.linkTitle } : {}
-      });
+      const board = await addLinkToTask(
+        projectRoot,
+        input.boardId,
+        input.taskId,
+        {
+          url: input.url,
+          type: input.linkType ?? "url",
+          ...input.linkTitle !== void 0 ? { title: input.linkTitle } : {}
+        },
+        eventContext
+      );
       return board ? okBoard(board, "Link added.") : fail("Task not found.");
     }
     case "split_atomic": {
       if (!input.boardId || !input.taskId || !input.childTitles?.length) {
         return fail("split_atomic requires boardId, taskId, and childTitles (at least one).");
       }
-      return handleSplitTask(projectRoot, input, { atomic: true });
+      return handleSplitTask(projectRoot, input, { atomic: true }, eventContext);
     }
     default:
       return void 0;
@@ -976,10 +1054,14 @@ async function syncContextTask(ctx, task, options = {}) {
   }
 }
 async function handleKanbanLifecycleAction(projectRoot, input, ctx) {
+  const eventContext = {
+    sessionId: ctx.eventSessionId(),
+    ...ctx.agentId !== void 0 ? { actor: ctx.agentId } : {}
+  };
   switch (input.action) {
     case "add_task": {
       if (!input.boardId || !input.title) return fail("add_task requires boardId and title.");
-      const result = await addTask2(projectRoot, input.boardId, taskInput(input));
+      const result = await addTask2(projectRoot, input.boardId, taskInput(input), eventContext);
       if (!result) return fail("Board not found.");
       await syncContextTask(ctx, result.task);
       return okTask(result.board, result.task, `Task added.${atomicityNudge(result.task)}`);
@@ -988,20 +1070,25 @@ async function handleKanbanLifecycleAction(projectRoot, input, ctx) {
       if (!input.boardId || !input.taskId || !input.childTitles?.length) {
         return fail("split_task requires boardId, taskId, and childTitles.");
       }
-      return handleSplitTask(projectRoot, input, {});
+      return handleSplitTask(projectRoot, input, {}, eventContext);
     }
     case "merge_tasks": {
       if (!input.boardId || !input.taskIds?.length || !input.title) {
         return fail("merge_tasks requires boardId, taskIds, and title.");
       }
-      const result = await mergeTasks(projectRoot, input.boardId, {
-        taskIds: input.taskIds,
-        title: input.title,
-        ...input.description !== void 0 ? { description: input.description } : {},
-        ...input.targetColumnId !== void 0 ? { targetColumnId: input.targetColumnId } : {},
-        ...input.preserveAssignment !== void 0 ? { preserveAssignment: input.preserveAssignment } : {},
-        ...input.closeSourceTasks !== void 0 ? { closeSourceTasks: input.closeSourceTasks } : {}
-      });
+      const result = await mergeTasks(
+        projectRoot,
+        input.boardId,
+        {
+          taskIds: input.taskIds,
+          title: input.title,
+          ...input.description !== void 0 ? { description: input.description } : {},
+          ...input.targetColumnId !== void 0 ? { targetColumnId: input.targetColumnId } : {},
+          ...input.preserveAssignment !== void 0 ? { preserveAssignment: input.preserveAssignment } : {},
+          ...input.closeSourceTasks !== void 0 ? { closeSourceTasks: input.closeSourceTasks } : {}
+        },
+        eventContext
+      );
       return result ? okTask(result.board, result.task, "Tasks merged.") : fail("Board or task not found.");
     }
     case "copy_task": {
@@ -1017,7 +1104,8 @@ async function handleKanbanLifecycleAction(projectRoot, input, ctx) {
           ...input.targetColumnId !== void 0 ? { targetColumnId: input.targetColumnId } : {},
           ...input.order !== void 0 ? { targetOrder: input.order } : {},
           ...input.preserveAssignment !== void 0 ? { preserveAssignment: input.preserveAssignment } : {},
-          ...input.preserveDependencies !== void 0 ? { preserveDependencies: input.preserveDependencies } : {}
+          ...input.preserveDependencies !== void 0 ? { preserveDependencies: input.preserveDependencies } : {},
+          eventContext
         }
       );
       return result ? okTask(result.targetBoard, result.task, "Task copied to target board.") : fail("Board or task not found.");
@@ -1035,7 +1123,8 @@ async function handleKanbanLifecycleAction(projectRoot, input, ctx) {
           ...input.targetColumnId !== void 0 ? { targetColumnId: input.targetColumnId } : {},
           ...input.order !== void 0 ? { targetOrder: input.order } : {},
           ...input.preserveAssignment !== void 0 ? { preserveAssignment: input.preserveAssignment } : {},
-          ...input.preserveDependencies !== void 0 ? { preserveDependencies: input.preserveDependencies } : {}
+          ...input.preserveDependencies !== void 0 ? { preserveDependencies: input.preserveDependencies } : {},
+          eventContext
         }
       );
       return result ? okTask(result.targetBoard, result.task, "Task transferred to target board.") : fail("Board or task not found.");
@@ -1060,20 +1149,30 @@ async function handleKanbanLifecycleAction(projectRoot, input, ctx) {
       }
       if (board.lifecycle?.mode !== "managed") {
         const now = /* @__PURE__ */ new Date();
-        const assigned = await updateTaskAssignment(projectRoot, board.id, task.id, {
-          status: "running",
-          agentId: input.agentId ?? input.author,
-          leaseId: input.leaseId ?? randomUUID2(),
-          claimedAt: input.claimedAt ?? now.toISOString(),
-          heartbeatAt: input.heartbeatAt ?? now.toISOString(),
-          leaseExpiresAt: input.leaseExpiresAt ?? new Date(now.getTime() + 15 * 6e4).toISOString(),
-          attempt: input.attempt ?? 1,
-          maxAttempts: input.maxAttempts ?? 3
-        });
+        const assigned = await updateTaskAssignment(
+          projectRoot,
+          board.id,
+          task.id,
+          {
+            status: "running",
+            agentId: input.agentId ?? input.author,
+            leaseId: input.leaseId ?? randomUUID2(),
+            claimedAt: input.claimedAt ?? now.toISOString(),
+            heartbeatAt: input.heartbeatAt ?? now.toISOString(),
+            leaseExpiresAt: input.leaseExpiresAt ?? new Date(now.getTime() + 15 * 6e4).toISOString(),
+            attempt: input.attempt ?? 1,
+            maxAttempts: input.maxAttempts ?? 3
+          },
+          eventContext
+        );
         if (!assigned) return fail("Task assignment could not be started.");
-        const started = await updateTask2(projectRoot, board.id, task.id, {
-          status: "in_progress"
-        });
+        const started = await updateTask2(
+          projectRoot,
+          board.id,
+          task.id,
+          { status: "in_progress" },
+          eventContext
+        );
         const current = started ?? assigned;
         const claimed = task;
         const currentTask = current.tasks.find((candidate) => candidate.id === claimed.id) ?? claimed;
@@ -1088,6 +1187,7 @@ async function handleKanbanLifecycleAction(projectRoot, input, ctx) {
       if (stage === "backlog") {
         const moved = await transitionTask(projectRoot, board.id, task.id, {
           to: "todo",
+          sessionId: eventContext.sessionId,
           actor: input.author,
           comment: input.transitionComment
         });
@@ -1099,19 +1199,26 @@ async function handleKanbanLifecycleAction(projectRoot, input, ctx) {
       if (stage === "todo" || stage === "review") {
         const now = /* @__PURE__ */ new Date();
         const leaseId = input.leaseId ?? randomUUID2();
-        const assigned = await updateTaskAssignment(projectRoot, board.id, task.id, {
-          status: "running",
-          agentId: input.agentId ?? input.author,
-          leaseId,
-          claimedAt: input.claimedAt ?? now.toISOString(),
-          heartbeatAt: input.heartbeatAt ?? now.toISOString(),
-          leaseExpiresAt: input.leaseExpiresAt ?? new Date(now.getTime() + 15 * 6e4).toISOString(),
-          attempt: input.attempt ?? 1,
-          maxAttempts: input.maxAttempts ?? 3
-        });
+        const assigned = await updateTaskAssignment(
+          projectRoot,
+          board.id,
+          task.id,
+          {
+            status: "running",
+            agentId: input.agentId ?? input.author,
+            leaseId,
+            claimedAt: input.claimedAt ?? now.toISOString(),
+            heartbeatAt: input.heartbeatAt ?? now.toISOString(),
+            leaseExpiresAt: input.leaseExpiresAt ?? new Date(now.getTime() + 15 * 6e4).toISOString(),
+            attempt: input.attempt ?? 1,
+            maxAttempts: input.maxAttempts ?? 3
+          },
+          eventContext
+        );
         if (!assigned) return fail("Task assignment could not be started.");
         const moved = await transitionTask(projectRoot, board.id, task.id, {
           to: "running",
+          sessionId: eventContext.sessionId,
           actor: input.author,
           comment: input.transitionComment
         });
@@ -1135,9 +1242,18 @@ async function handleKanbanLifecycleAction(projectRoot, input, ctx) {
     }
     case "update_task": {
       if (!input.boardId || !input.taskId) return fail("update_task requires boardId and taskId.");
-      const board = await updateTask2(projectRoot, input.boardId, input.taskId, taskPatch(input));
+      const board = await updateTask2(
+        projectRoot,
+        input.boardId,
+        input.taskId,
+        taskPatch(input),
+        eventContext
+      );
       if (board) {
-        await syncContextTask(ctx, board.tasks.find((t) => t.id === input.taskId));
+        await syncContextTask(
+          ctx,
+          board.tasks.find((t) => t.id === input.taskId)
+        );
       }
       return board ? okBoard(board, "Task updated.") : fail("Task not found.");
     }
@@ -1154,14 +1270,21 @@ async function handleKanbanLifecycleAction(projectRoot, input, ctx) {
           const preGate = await verifyTaskCompletion2(projectRoot, input.boardId, taskBefore.id, {
             persist: false
           });
-          await updateTask2(projectRoot, input.boardId, taskBefore.id, {
-            verificationReport: preGate.report,
-            successCriteria: preGate.task.successCriteria
-          });
+          await updateTask2(
+            projectRoot,
+            input.boardId,
+            taskBefore.id,
+            {
+              verificationReport: preGate.report,
+              successCriteria: preGate.task.successCriteria
+            },
+            eventContext
+          );
         }
       }
       const result = await transitionTask(projectRoot, input.boardId, input.taskId, {
         to: input.lifecycleStage,
+        sessionId: eventContext.sessionId,
         actor: input.author,
         comment: input.transitionComment,
         ...input.transitionAction !== void 0 ? { action: input.transitionAction } : {},
@@ -1211,10 +1334,14 @@ async function handleKanbanLifecycleAction(projectRoot, input, ctx) {
         input.boardId,
         input.taskId,
         input.targetColumnId,
-        input.order
+        input.order,
+        eventContext
       );
       if (board) {
-        await syncContextTask(ctx, board.tasks.find((t) => t.id === input.taskId));
+        await syncContextTask(
+          ctx,
+          board.tasks.find((t) => t.id === input.taskId)
+        );
       }
       return board ? okBoard(board, "Task moved.") : fail("Move failed.");
     }
@@ -1222,7 +1349,7 @@ async function handleKanbanLifecycleAction(projectRoot, input, ctx) {
       if (!input.boardId || !input.taskId) return fail("delete_task requires boardId and taskId.");
       const boardBefore = await getBoard3(projectRoot, input.boardId);
       const taskToDelete = boardBefore?.tasks.find((t) => t.id === input.taskId);
-      const board = await removeTask(projectRoot, input.boardId, input.taskId);
+      const board = await removeTask(projectRoot, input.boardId, input.taskId, eventContext);
       if (board && ctx.currentKanbanTaskId === input.taskId) {
         ctx.setCurrentKanbanTask?.(void 0, ctx.currentKanbanBoardId);
       }
@@ -1235,11 +1362,16 @@ async function handleKanbanLifecycleAction(projectRoot, input, ctx) {
       if (!input.boardId || !input.taskIds?.length) {
         return fail("set_chain requires boardId and taskIds.");
       }
-      const result = await setTaskChain(projectRoot, input.boardId, {
-        taskIds: input.taskIds,
-        ...input.chainId !== void 0 ? { chainId: input.chainId } : {},
-        ...input.enforceDependencies !== void 0 ? { enforceDependencies: input.enforceDependencies } : {}
-      });
+      const result = await setTaskChain(
+        projectRoot,
+        input.boardId,
+        {
+          taskIds: input.taskIds,
+          ...input.chainId !== void 0 ? { chainId: input.chainId } : {},
+          ...input.enforceDependencies !== void 0 ? { enforceDependencies: input.enforceDependencies } : {}
+        },
+        eventContext
+      );
       return result ? {
         ok: true,
         message: `Chain set: ${result.chainId}`,
@@ -1264,23 +1396,33 @@ async function handleKanbanLifecycleAction(projectRoot, input, ctx) {
       } : fail("Chain not found.");
     }
     case "claim_task": {
-      const result = await claimReadyTask(projectRoot, {
-        ...input.boardId !== void 0 ? { boardId: input.boardId } : {},
-        ...input.taskId !== void 0 ? { taskId: input.taskId } : {},
-        ...assignmentInput(input),
-        status: input.assignmentStatus ?? "queued"
-      });
+      const result = await claimReadyTask(
+        projectRoot,
+        {
+          ...input.boardId !== void 0 ? { boardId: input.boardId } : {},
+          ...input.taskId !== void 0 ? { taskId: input.taskId } : {},
+          ...assignmentInput(input),
+          status: input.assignmentStatus ?? "queued"
+        },
+        eventContext
+      );
       return result ? okTask(result.board, result.task, "Task claimed.") : fail("No ready kanban task matched the claim.");
     }
     case "release_task": {
       if (!input.boardId || !input.taskId) {
         return fail("release_task requires boardId and taskId.");
       }
-      const board = await releaseTaskClaim(projectRoot, input.boardId, input.taskId, {
-        ...input.releaseStatus !== void 0 ? { status: input.releaseStatus } : {},
-        ...input.releaseReason !== void 0 ? { reason: input.releaseReason } : {},
-        ...input.clearAssignee !== void 0 ? { clearAssignee: input.clearAssignee } : {}
-      });
+      const board = await releaseTaskClaim(
+        projectRoot,
+        input.boardId,
+        input.taskId,
+        {
+          ...input.releaseStatus !== void 0 ? { status: input.releaseStatus } : {},
+          ...input.releaseReason !== void 0 ? { reason: input.releaseReason } : {},
+          ...input.clearAssignee !== void 0 ? { clearAssignee: input.clearAssignee } : {}
+        },
+        eventContext
+      );
       return board ? okBoard(board, "Task claim released.") : fail("Task not found.");
     }
     case "assign_task": {
@@ -1289,7 +1431,8 @@ async function handleKanbanLifecycleAction(projectRoot, input, ctx) {
         projectRoot,
         input.boardId,
         input.taskId,
-        assignmentInput(input)
+        assignmentInput(input),
+        eventContext
       );
       return board ? okBoard(board, "Task assigned.") : fail("Task not found.");
     }
@@ -1315,14 +1458,17 @@ async function handleKanbanLifecycleAction(projectRoot, input, ctx) {
           ...input.attempt !== void 0 ? { attempt: input.attempt } : {},
           ...input.maxAttempts !== void 0 ? { maxAttempts: input.maxAttempts } : {}
         },
-        input.expectedLeaseId !== void 0 ? { expectedLeaseId: input.expectedLeaseId } : {}
+        {
+          ...eventContext,
+          ...input.expectedLeaseId !== void 0 ? { expectedLeaseId: input.expectedLeaseId } : {}
+        }
       );
       if (!board) return fail("Task not found.");
       if (assignmentStatus === "completed" && board.lifecycle?.mode !== "managed") {
         const envGate = readEnvGateEnforcement();
         const finalized = await finalizeTaskCompletion(projectRoot, board.id, input.taskId, {
           ...board.completionGate === void 0 && envGate !== void 0 ? { enforcement: envGate } : {},
-          ...ctx.agentId !== void 0 ? { eventContext: { actor: ctx.agentId } } : {}
+          eventContext
         });
         if (finalized) {
           if (finalized.gate.report) {
@@ -1351,6 +1497,7 @@ async function handleKanbanLifecycleAction(projectRoot, input, ctx) {
           try {
             transitionResult = await transitionTask(projectRoot, board.id, input.taskId, {
               to: "running",
+              sessionId: eventContext.sessionId,
               actor,
               comment: "Work started."
             });
@@ -1365,6 +1512,7 @@ async function handleKanbanLifecycleAction(projectRoot, input, ctx) {
           try {
             transitionResult = await transitionTask(projectRoot, board.id, input.taskId, {
               to: "review",
+              sessionId: eventContext.sessionId,
               actor,
               comment,
               attachment: {
@@ -1389,10 +1537,16 @@ async function handleKanbanLifecycleAction(projectRoot, input, ctx) {
                 if (verResult.report) {
                   recordKanbanVerificationEvidence(ctx, verResult.report);
                 }
-                await updateTask2(projectRoot, board.id, input.taskId, {
-                  verificationReport: verResult.report,
-                  successCriteria: verResult.task.successCriteria
-                });
+                await updateTask2(
+                  projectRoot,
+                  board.id,
+                  input.taskId,
+                  {
+                    verificationReport: verResult.report,
+                    successCriteria: verResult.task.successCriteria
+                  },
+                  eventContext
+                );
                 const verdict = verResult.report.verdict;
                 if (verdict === "passed" && !resolveAutoAccept(board)) {
                   lifecycleWarnings.push(
@@ -1402,6 +1556,7 @@ async function handleKanbanLifecycleAction(projectRoot, input, ctx) {
                   try {
                     const doneResult = await transitionTask(projectRoot, board.id, input.taskId, {
                       to: "done",
+                      sessionId: eventContext.sessionId,
                       actor,
                       action: "Automated acceptance after verification",
                       comment: "Auto-accepted: verification passed.",
@@ -1450,11 +1605,17 @@ async function handleKanbanLifecycleAction(projectRoot, input, ctx) {
       if (!input.boardId || !input.taskId) {
         return fail("heartbeat_assignment requires boardId and taskId.");
       }
-      const board = await heartbeatTaskAssignment(projectRoot, input.boardId, input.taskId, {
-        ...input.heartbeatAt !== void 0 ? { heartbeatAt: input.heartbeatAt } : {},
-        ...input.leaseExpiresAt !== void 0 ? { leaseExpiresAt: input.leaseExpiresAt } : {},
-        ...input.expectedLeaseId !== void 0 ? { expectedLeaseId: input.expectedLeaseId } : {}
-      });
+      const board = await heartbeatTaskAssignment(
+        projectRoot,
+        input.boardId,
+        input.taskId,
+        {
+          ...input.heartbeatAt !== void 0 ? { heartbeatAt: input.heartbeatAt } : {},
+          ...input.leaseExpiresAt !== void 0 ? { leaseExpiresAt: input.leaseExpiresAt } : {},
+          ...input.expectedLeaseId !== void 0 ? { expectedLeaseId: input.expectedLeaseId } : {}
+        },
+        eventContext
+      );
       return board ? okBoard(board, "Assignment heartbeat updated.") : fail("Task assignment not found.");
     }
     case "recover_stale": {
@@ -1465,26 +1626,31 @@ async function handleKanbanLifecycleAction(projectRoot, input, ctx) {
         input.recoveryPolicyReleaseOnHeartbeatDue !== void 0,
         input.recoveryPolicyRetryPolicyOverride !== void 0
       ].some(Boolean);
-      const result = await recoverStaleTaskAssignments(projectRoot, input.boardId, {
-        ...input.recoveryMode !== void 0 ? { mode: input.recoveryMode } : {},
-        ...input.recoveryNow !== void 0 ? { now: input.recoveryNow } : {},
-        ...input.releaseReason !== void 0 ? { reason: input.releaseReason } : {},
-        ...input.clearAssignee !== void 0 ? { clearAssignee: input.clearAssignee } : {},
-        ...policyFields ? {
-          policy: {
-            ...input.recoveryPolicyFailOnCostCeiling !== void 0 ? { failWhenCostCeilingSet: input.recoveryPolicyFailOnCostCeiling } : {},
-            ...input.recoveryPolicyReleaseOnFailureKinds !== void 0 ? {
-              releaseOnFailureKinds: input.recoveryPolicyReleaseOnFailureKinds
-            } : {},
-            ...input.recoveryPolicyReleaseOnHeartbeatDue !== void 0 ? {
-              releaseOnHeartbeatDue: input.recoveryPolicyReleaseOnHeartbeatDue
-            } : {},
-            ...input.recoveryPolicyRetryPolicyOverride !== void 0 ? {
-              retryPolicyOverride: input.recoveryPolicyRetryPolicyOverride
-            } : {}
-          }
-        } : {}
-      });
+      const result = await recoverStaleTaskAssignments(
+        projectRoot,
+        input.boardId,
+        {
+          ...input.recoveryMode !== void 0 ? { mode: input.recoveryMode } : {},
+          ...input.recoveryNow !== void 0 ? { now: input.recoveryNow } : {},
+          ...input.releaseReason !== void 0 ? { reason: input.releaseReason } : {},
+          ...input.clearAssignee !== void 0 ? { clearAssignee: input.clearAssignee } : {},
+          ...policyFields ? {
+            policy: {
+              ...input.recoveryPolicyFailOnCostCeiling !== void 0 ? { failWhenCostCeilingSet: input.recoveryPolicyFailOnCostCeiling } : {},
+              ...input.recoveryPolicyReleaseOnFailureKinds !== void 0 ? {
+                releaseOnFailureKinds: input.recoveryPolicyReleaseOnFailureKinds
+              } : {},
+              ...input.recoveryPolicyReleaseOnHeartbeatDue !== void 0 ? {
+                releaseOnHeartbeatDue: input.recoveryPolicyReleaseOnHeartbeatDue
+              } : {},
+              ...input.recoveryPolicyRetryPolicyOverride !== void 0 ? {
+                retryPolicyOverride: input.recoveryPolicyRetryPolicyOverride
+              } : {}
+            }
+          } : {}
+        },
+        eventContext
+      );
       return result ? {
         ok: true,
         message: `Recovered ${result.tasks.length} stale assignment(s).`,
@@ -1918,10 +2084,11 @@ var kanbanTool = {
         const contractResult = await handleKanbanContractAction(
           projectRoot,
           input,
-          input.author ?? input.agentId
+          input.author ?? input.agentId,
+          ctx.eventSessionId()
         );
         if (contractResult !== void 0) return contractResult;
-        const detailResult = await handleKanbanDetailAction(projectRoot, input);
+        const detailResult = await handleKanbanDetailAction(projectRoot, input, ctx);
         if (detailResult !== void 0) return detailResult;
         return fail(`Unknown kanban action: ${input.action}`);
       })();
@@ -1941,4 +2108,4 @@ export {
   recordKanbanVerificationEvidence,
   kanbanTool
 };
-//# sourceMappingURL=chunk-55KF77OK.js.map
+//# sourceMappingURL=chunk-JNNVRHMV.js.map