@wrongstack/tools 0.302.0 → 0.303.0

package/dist/session-kanban.d.ts

@@ -7,6 +7,12 @@ import { type KanbanBoard, type KanbanColumn, type KanbanTask } from '@wrongstac
 export declare const SESSION_KANBAN_COLUMNS: KanbanColumn[];
 /** Create (or migrate) the single Kanban board owned by a session. */
 export declare function ensureSessionKanbanBoard(projectRoot: string | undefined, sessionId: string): Promise<KanbanBoard | null>;
+/**
+ * Remove an inactive session's observational mirror, including its cards.
+ * The durable source remains the session todo/task/plan files; retaining the
+ * mirror after detach only creates historical duplicate work in project views.
+ */
+export declare function cleanupSessionKanbanBoard(projectRoot: string | undefined, sessionId: string): Promise<string[]>;
 /** Remove a particular inactive session's system-owned board when it has no cards. */
 export declare function cleanupSessionKanbanBoardIfEmpty(projectRoot: string | undefined, sessionId: string): Promise<string[]>;
 /** Prune stale empty session boards while preserving manual and live boards. */
@@ -43,6 +49,8 @@ export interface SessionKanbanSourceUpdate {
  * todo list that happened to exist when the run started.
  */
 export declare function applySessionKanbanBoardToTodos(context: Context, board: KanbanBoard): TodoItem[];
+/** Project a durable managed board into the session's compact todo surface. */
+export declare function applyManagedKanbanBoardToTodos(context: Context, board: KanbanBoard): TodoItem[];
 /** Reflect a TUI/WebUI Kanban card edit back to its originating work list. */
 export declare function applySessionKanbanTaskToSource(context: Context, task: KanbanTask, options?: {
     remove?: boolean | undefined;

package/dist/session-kanban.js

@@ -135,6 +135,26 @@ async function removeEmptySessionBoard(projectRoot, boardId, sessionId) {
     return await removeBoard(projectRoot, board.id) ? board.id : null;
   });
 }
+async function removeOwnedSessionBoard(projectRoot, boardId, sessionId) {
+  return enqueueBoardWork(projectRoot, sessionId, async () => {
+    if (isSessionBoardActive(projectRoot, sessionId)) return null;
+    const board = await getBoard(projectRoot, boardId);
+    if (!board || !isOwnedSessionBoard(board.tags)) return null;
+    if (sessionIdFromTags(board.tags) !== sessionId) return null;
+    return await removeBoard(projectRoot, board.id) ? board.id : null;
+  });
+}
+async function cleanupSessionKanbanBoard(projectRoot, sessionId) {
+  if (!projectRoot || !sessionId || process.env[MIRROR_DISABLED_ENV] === "0") return [];
+  if (isSessionBoardActive(projectRoot, sessionId)) return [];
+  const candidates = (await listBoards(projectRoot)).filter(
+    (board) => isOwnedSessionBoard(board.tags) && sessionIdFromTags(board.tags) === sessionId
+  );
+  const removed = await Promise.all(
+    candidates.map((board) => removeOwnedSessionBoard(projectRoot, board.id, sessionId))
+  );
+  return removed.filter((boardId) => Boolean(boardId));
+}
 async function cleanupSessionKanbanBoardIfEmpty(projectRoot, sessionId) {
   if (!projectRoot || !sessionId || process.env[MIRROR_DISABLED_ENV] === "0") return [];
   if (isSessionBoardActive(projectRoot, sessionId)) return [];
@@ -197,7 +217,17 @@ function queueLatestMirror(projectRoot, sessionId, graph, sourceSystem) {
             pending.graph,
             pending.sourceSystem
           );
-        } catch {
+        } catch (error) {
+          console.warn(
+            JSON.stringify({
+              level: "warn",
+              event: "session-kanban.mirror-failed",
+              sessionId: pending.sessionId,
+              sourceSystem: pending.sourceSystem,
+              message: error instanceof Error ? error.message : String(error),
+              timestamp: (/* @__PURE__ */ new Date()).toISOString()
+            })
+          );
         }
       }
     } finally {
@@ -216,6 +246,7 @@ function queueLatestMirror(projectRoot, sessionId, graph, sourceSystem) {
   })();
 }
 function todoListToSerializedGraph(todos, sessionId) {
+  const graphId = `todo:${sessionId}`;
   const nodes = todos.map((todo, index) => ({
     id: todo.id,
     title: todo.content,
@@ -223,12 +254,14 @@ function todoListToSerializedGraph(todos, sessionId) {
     type: "chore",
     priority: "medium",
     status: todo.status,
+    specRequirementId: `${graphId}:${todo.id}`,
     createdAt: index,
     updatedAt: index
   }));
   return {
-    id: `todo:${sessionId}`,
-    specId: `todo:${sessionId}`,
+    id: graphId,
+    specId: graphId,
+    requiredRequirementIds: nodes.map((node) => node.specRequirementId),
     title: "Session todos",
     nodes,
     edges: [],
@@ -238,6 +271,7 @@ function todoListToSerializedGraph(todos, sessionId) {
   };
 }
 function taskFileToSerializedGraph(tasks, sessionId) {
+  const graphId = `session:${sessionId}`;
   const ids = new Set(tasks.map((task) => task.id));
   const nodes = tasks.map((task, index) => ({
     id: task.id,
@@ -246,6 +280,7 @@ function taskFileToSerializedGraph(tasks, sessionId) {
     type: task.type,
     priority: task.priority,
     status: task.status,
+    specRequirementId: `${graphId}:${task.id}`,
     ...task.assignee ? { assignee: task.assignee } : {},
     ...task.estimateHours !== void 0 ? { estimateHours: task.estimateHours } : {},
     createdAt: index,
@@ -263,8 +298,9 @@ function taskFileToSerializedGraph(tasks, sessionId) {
   const rootNodes = nodes.filter((node) => !hasIncoming.has(node.id)).map((node) => node.id);
   return {
     // Keep the historical graph id so existing mirrored task cards are reused.
-    id: `session:${sessionId}`,
-    specId: `session:${sessionId}`,
+    id: graphId,
+    specId: graphId,
+    requiredRequirementIds: nodes.map((node) => node.specRequirementId),
     title: "Session tasks",
     nodes,
     edges,
@@ -279,6 +315,7 @@ var PLAN_STATUS_TO_TASK = {
   done: "completed"
 };
 function planFileToSerializedGraph(items, sessionId) {
+  const graphId = `plan:${sessionId}`;
   const nodes = items.map((item, index) => ({
     id: item.id,
     title: item.title,
@@ -286,12 +323,14 @@ function planFileToSerializedGraph(items, sessionId) {
     type: "chore",
     priority: "medium",
     status: PLAN_STATUS_TO_TASK[item.status],
+    specRequirementId: `${graphId}:${item.id}`,
     createdAt: index,
     updatedAt: index
   }));
   return {
-    id: `plan:${sessionId}`,
-    specId: `plan:${sessionId}`,
+    id: graphId,
+    specId: graphId,
+    requiredRequirementIds: nodes.map((node) => node.specRequirementId),
     title: "Session plan",
     nodes,
     edges: [],
@@ -417,7 +456,7 @@ function attachSessionKanbanMirror(context) {
       releaseActiveSessionBoard(attachedProjectRoot, registeredSessionId);
       fireAndForget(
         "cleanup-board",
-        cleanupSessionKanbanBoardIfEmpty(attachedProjectRoot, registeredSessionId)
+        cleanupSessionKanbanBoard(attachedProjectRoot, registeredSessionId)
       );
     }
     registeredSessionId = currentSessionId;
@@ -434,6 +473,11 @@ function attachSessionKanbanMirror(context) {
   let boardTimer = null;
   let presenceTimer = null;
   const sessionId = () => context.session?.id ?? "";
+  const activeManagedBoardId = () => {
+    const metaKanban = context.meta["kanban"];
+    const metaBoardId = metaKanban && typeof metaKanban === "object" ? metaKanban["boardId"] : void 0;
+    return context.currentKanbanBoardId ?? (typeof metaBoardId === "string" && metaBoardId ? metaBoardId : "");
+  };
   const refreshFiles = async () => {
     const id = sessionId();
     if (!id) return;
@@ -451,12 +495,19 @@ function attachSessionKanbanMirror(context) {
   const refreshBoard = async () => {
     if (!watchedBoardId) return;
     const board = await getBoard(context.projectRoot, watchedBoardId);
-    if (board) applySessionKanbanBoardToTodos(context, board);
+    if (!board) return;
+    if (board.lifecycle?.mode === "managed") applyManagedKanbanBoardToTodos(context, board);
+    else applySessionKanbanBoardToTodos(context, board);
   };
   const configureBoardWatcher = async () => {
     const id = sessionId();
-    const board = id ? await ensureSessionKanbanBoard(context.projectRoot, id) : null;
-    if (!board || board.id === watchedBoardId) return;
+    const managedBoardId = activeManagedBoardId();
+    const board = managedBoardId ? await getBoard(context.projectRoot, managedBoardId) : id ? await ensureSessionKanbanBoard(context.projectRoot, id) : null;
+    if (!board) return;
+    if (board.id === watchedBoardId) {
+      await refreshBoard();
+      return;
+    }
     unsubscribeBoardEvents?.();
     unsubscribeBoardEvents = null;
     watchedBoardId = board.id;
@@ -480,6 +531,7 @@ function attachSessionKanbanMirror(context) {
       if (presenceTimer) clearInterval(presenceTimer);
       presenceTimer = setInterval(() => fireAndForget("touch-presence", touchPresence()), 6e4);
       presenceTimer.unref?.();
+      if (board.lifecycle?.mode === "managed") applyManagedKanbanBoardToTodos(context, board);
     } catch {
       unsubscribeBoardEvents = null;
       watchedBoardId = "";
@@ -512,6 +564,12 @@ function attachSessionKanbanMirror(context) {
   };
   const unsubscribe = context.state.onChange((change) => {
     if (change.kind === "todos_replaced" && !suppressedTodoMirrors.has(context)) {
+      const snapshot = change.completedSnapshot ?? change.todos;
+      if (snapshot.length > 0 && snapshot.every(
+        (todo) => todo.kanbanBoardId === activeManagedBoardId() && Boolean(todo.kanbanTaskId)
+      )) {
+        return;
+      }
       mirrorSessionTodosToKanban(
         context.projectRoot,
         change.completedSnapshot ?? change.todos,
@@ -519,11 +577,14 @@ function attachSessionKanbanMirror(context) {
       );
       return;
     }
-    if (change.kind === "meta_set" && (change.key === "plan.path" || change.key === "task.path")) {
+    if (change.kind === "meta_set" && (change.key === "plan.path" || change.key === "task.path" || change.key === "kanban")) {
       syncActiveSessionRegistration();
       configureWatcher();
-      fireAndForget("ensure-board", ensureSessionKanbanBoard(context.projectRoot, sessionId()));
+      if (!activeManagedBoardId()) {
+        fireAndForget("ensure-board", ensureSessionKanbanBoard(context.projectRoot, sessionId()));
+      }
       fireAndForget("configure-watcher", configureBoardWatcher());
+      fireAndForget("refresh-board", refreshBoard());
       fireAndForget("refresh-files", refreshFiles());
     }
   });
@@ -541,7 +602,7 @@ function attachSessionKanbanMirror(context) {
       releaseActiveSessionBoard(attachedProjectRoot, registeredSessionId);
       fireAndForget(
         "cleanup-board",
-        cleanupSessionKanbanBoardIfEmpty(attachedProjectRoot, registeredSessionId)
+        cleanupSessionKanbanBoard(attachedProjectRoot, registeredSessionId)
       );
       registeredSessionId = "";
     }
@@ -583,18 +644,26 @@ function todoStatus(task) {
   if (status === "in_progress" || status === "review") return "in_progress";
   return "pending";
 }
-function sessionTodoFromTask(task) {
+function sessionTodoFromTask(task, boardId) {
   return {
     id: task.origin?.taskId ?? task.id,
     content: task.title,
     status: todoStatus(task),
+    kanbanBoardId: boardId,
+    kanbanTaskId: task.id,
     ...task.description ? { activeForm: task.description } : {}
   };
 }
+function managedTodoFromTask(task, boardId) {
+  return {
+    ...sessionTodoFromTask(task, boardId),
+    status: task.status === "completed" ? "completed" : task.status === "in_progress" ? "in_progress" : "pending"
+  };
+}
 function sameTodos(left, right) {
   return left.length === right.length && left.every((todo, index) => {
     const candidate = right[index];
-    return candidate?.id === todo.id && candidate.content === todo.content && candidate.status === todo.status && candidate.activeForm === todo.activeForm && candidate.promotedFromPlan === todo.promotedFromPlan && candidate.promotedFromTask === todo.promotedFromTask;
+    return candidate?.id === todo.id && candidate.content === todo.content && candidate.status === todo.status && candidate.activeForm === todo.activeForm && candidate.promotedFromPlan === todo.promotedFromPlan && candidate.promotedFromTask === todo.promotedFromTask && candidate.kanbanBoardId === todo.kanbanBoardId && candidate.kanbanTaskId === todo.kanbanTaskId;
   });
 }
 function applySessionKanbanBoardToTodos(context, board) {
@@ -608,7 +677,7 @@ function applySessionKanbanBoardToTodos(context, board) {
     const leftColumn = board.columns.find((column) => column.id === left.columnId)?.order ?? 0;
     const rightColumn = board.columns.find((column) => column.id === right.columnId)?.order ?? 0;
     return leftColumn - rightColumn || left.order - right.order || left.createdAt.localeCompare(right.createdAt);
-  }).map(sessionTodoFromTask);
+  }).map((task) => sessionTodoFromTask(task, board.id));
   const allCompleted = projectedTodos.length > 0 && projectedTodos.every((todo) => todo.status === "completed");
   const effectiveTodos = allCompleted ? [] : projectedTodos;
   if (sameTodos(context.todos, effectiveTodos)) return [...context.todos];
@@ -622,6 +691,29 @@ function applySessionKanbanBoardToTodos(context, board) {
   broadcastTodoUpdate(context, context.todos);
   return [...context.todos];
 }
+function applyManagedKanbanBoardToTodos(context, board) {
+  const metaKanban = context.meta["kanban"];
+  const metaBoardId = metaKanban && typeof metaKanban === "object" ? metaKanban["boardId"] : void 0;
+  const activeBoardId = context.currentKanbanBoardId ?? (typeof metaBoardId === "string" ? metaBoardId : void 0);
+  if (!activeBoardId || board.id !== activeBoardId || board.lifecycle?.mode !== "managed") {
+    return [...context.todos];
+  }
+  const projectedTodos = board.tasks.filter(
+    (task) => task.status !== "archived" && task.mergedIntoTaskId === void 0 && (!task.childTaskIds || task.childTaskIds.length === 0)
+  ).sort(
+    (left, right) => left.createdAt.localeCompare(right.createdAt) || left.order - right.order
+  ).map((task) => managedTodoFromTask(task, board.id));
+  if (sameTodos(context.todos, projectedTodos)) return [...context.todos];
+  suppressedTodoMirrors.add(context);
+  try {
+    context.state.replaceTodos(projectedTodos);
+  } finally {
+    suppressedTodoMirrors.delete(context);
+  }
+  notifyTodoUpdate(context, context.todos);
+  broadcastTodoUpdate(context, context.todos);
+  return [...context.todos];
+}
 async function applySessionKanbanTaskToSource(context, task, options = {}) {
   const originId = task.origin?.taskId;
   const graphId = task.origin?.graphId ?? "";
@@ -682,10 +774,12 @@ async function applySessionKanbanTaskToSource(context, task, options = {}) {
 }
 export {
   SESSION_KANBAN_COLUMNS,
+  applyManagedKanbanBoardToTodos,
   applySessionKanbanBoardToTodos,
   applySessionKanbanTaskToSource,
   attachSessionKanbanMirror,
   cleanupEmptySessionKanbanBoards,
+  cleanupSessionKanbanBoard,
   cleanupSessionKanbanBoardIfEmpty,
   ensureSessionKanbanBoard,
   hydrateSessionKanban,

package/dist/task.d.ts

@@ -1,13 +1,14 @@
-import type { TaskStatus } from '@wrongstack/core/types';
+import type { TaskStatus, Tool } from '@wrongstack/core/types';
 import { type TaskItem } from '@wrongstack/core/utils';
-import type { Tool } from '@wrongstack/core/types';
+type TaskReplacementItem = Omit<TaskItem, 'createdAt' | 'updatedAt'> & Partial<Pick<TaskItem, 'createdAt' | 'updatedAt'>>;
+type TaskAdditionItem = Omit<TaskItem, 'id' | 'createdAt' | 'updatedAt' | 'status'> & Partial<Pick<TaskItem, 'status'>>;
 interface TaskInput {
     /** Replace: set new task list. Add: append a task. Status: update task status. Promote: convert a task to todo items. */
     action: 'replace' | 'add' | 'status' | 'show' | 'promote' | 'planify';
     /** Full task list for action=replace. */
-    tasks?: TaskItem[] | undefined;
+    tasks?: TaskReplacementItem[] | undefined;
     /** Single task for action=add. id, createdAt, updatedAt are auto-generated. */
-    task?: Omit<TaskItem, 'id' | 'createdAt' | 'updatedAt'> | undefined;
+    task?: TaskAdditionItem | undefined;
     /** Task id for action=status or target for action=promote. */
     id?: string | undefined;
     /** New status for action=status. */