@wrongstack/tools 0.293.0 → 0.295.1

package/dist/todo.d.ts

@@ -1,4 +1,5 @@
-import type { TodoItem, Tool } from '@wrongstack/core';
+import type { TodoItem } from '@wrongstack/core/agent';
+import type { Tool } from '@wrongstack/core/types';
 interface TodoInput {
     todos: TodoItem[];
 }

package/dist/todo.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"todo.d.ts","sourceRoot":"","sources":["../src/todo.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAIvD,UAAU,SAAS;IACjB,KAAK,EAAE,QAAQ,EAAE,CAAC;CACnB;AAED,UAAU,UAAU;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,eAAO,MAAM,QAAQ,EAAE,IAAI,CAAC,SAAS,EAAE,UAAU,CA2IhD,CAAC"}
+{"version":3,"file":"todo.d.ts","sourceRoot":"","sources":["../src/todo.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AACvD,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,wBAAwB,CAAC;AAInD,UAAU,SAAS;IACjB,KAAK,EAAE,QAAQ,EAAE,CAAC;CACnB;AAED,UAAU,UAAU;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,eAAO,MAAM,QAAQ,EAAE,IAAI,CAAC,SAAS,EAAE,UAAU,CA2IhD,CAAC"}

package/dist/todo.js

@@ -1,15 +1,15 @@
 // src/todo.ts
-import { loadPlan as loadPlan2, loadTasks as loadTasks2, savePlan, saveTasks, setPlanItemStatus } from "@wrongstack/core";
+import { loadPlan as loadPlan2, loadTasks as loadTasks2, savePlan, saveTasks, setPlanItemStatus } from "@wrongstack/core/storage";
 
 // src/session-kanban.ts
+import { GlobalMailbox } from "@wrongstack/core/coordination";
 import {
-  deserializeTaskGraph,
-  GlobalMailbox,
   loadPlan,
   loadTasks,
   mutatePlan,
   mutateTasks
-} from "@wrongstack/core";
+} from "@wrongstack/core/storage";
+import { deserializeTaskGraph } from "@wrongstack/core/tasking";
 import { resolveWstackPaths } from "@wrongstack/core/utils";
 import {
   createBoard,

package/dist/todo.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../src/todo.ts", "../src/session-kanban.ts"],
-  "sourcesContent": ["import type { TodoItem, Tool } from '@wrongstack/core';\nimport { loadPlan, loadTasks, savePlan, saveTasks, setPlanItemStatus } from '@wrongstack/core';\nimport { projectSessionTodosToKanban } from './session-kanban.js';\n\ninterface TodoInput {\n  todos: TodoItem[];\n}\n\ninterface TodoOutput {\n  count: number;\n  in_progress: number;\n}\n\nexport const todoTool: Tool<TodoInput, TodoOutput> = {\n  name: 'todo',\n  category: 'Session',\n  description:\n    'Manage the session-level todo list. This is the primary mechanism for tracking multi-step work. ' +\n    'The list is fully replaced on every call (not appended).',\n  usageHint:\n    'BEST PRACTICE for complex tasks:\\n' +\n    '- At the beginning of a non-trivial task, create a clear todo list with specific, actionable items.\\n' +\n    '- Only **one** item should be `in_progress` at any time.\\n' +\n    '- Update the list frequently as work progresses (mark items done, add new ones, change status).\\n' +\n    '- **Re-order items** to reflect current priorities \u2014 the full list is replaced each call, so item order is entirely under your control.\\n' +\n    '- When all items are completed the board auto-clears \u2014 you do NOT need to send an empty list.\\n' +\n    '- The system and user can see this list, so keep it honest and up-to-date.\\n' +\n    'This tool is extremely valuable for maintaining focus and giving the user visibility into your plan.',\n  permission: 'auto',\n  mutating: false, // mutates only conversation state (ctx.todos), not external state \u2014 no confirmation needed\n  timeoutMs: 5_000,\n  capabilities: ['session.todo'],\n  icon: 'todo',\n  inputSchema: {\n    type: 'object',\n    properties: {\n      todos: {\n        type: 'array',\n        items: {\n          type: 'object',\n          properties: {\n            id: {\n              type: 'string',\n              description: 'Unique identifier for the todo item (e.g. \"1\", \"auth-flow\").',\n            },\n            content: {\n              type: 'string',\n              description: 'Clear, actionable description of the task.',\n            },\n            status: {\n              type: 'string',\n              enum: ['pending', 'in_progress', 'completed'],\n              description: 'Current status. Only one item should be \"in_progress\" at a time.',\n            },\n            activeForm: {\n              type: 'string',\n              description:\n                'Optional present-tense form shown while the task is active (e.g. \"Fixing auth bug\").',\n            },\n          },\n          required: ['id', 'content', 'status'],\n        },\n        description: 'The complete new list of todos. This replaces the previous list entirely.',\n      },\n    },\n    required: ['todos'],\n  },\n  async execute(input, ctx) {\n    if (!Array.isArray(input?.todos)) {\n      throw new Error('todo: todos must be an array');\n    }\n    const items = input.todos.filter((t): t is TodoItem => Boolean(t?.id && t.content));\n    const inProgress = items.filter((t) => t.status === 'in_progress');\n    if (inProgress.length > 1) {\n      // Keep only the first as in_progress, mark rest pending\n      let seenInProgress = false;\n      for (const item of items) {\n        if (item.status === 'in_progress') {\n          if (seenInProgress) item.status = 'pending';\n          seenInProgress = true;\n        }\n      }\n    }\n    ctx.state.replaceTodos(items);\n\n    // Kanban is the session work surface. Mirror the requested list (rather\n    // than ctx.todos) so the final all-completed snapshot reaches Done even\n    // though ConversationState auto-clears an all-done tactical todo list.\n    await projectSessionTodosToKanban(ctx.projectRoot, items, ctx.session?.id ?? 'session');\n\n    // Auto-complete parent plan items / tasks when all their promoted\n    // todos are done. Runs after state mutation so the UI sees the new\n    // todo list before we touch the plan/task files.\n    const completedPlanIds = new Set<string>();\n    const completedTaskIds = new Set<string>();\n    const pendingPlanIds = new Set<string>();\n    const pendingTaskIds = new Set<string>();\n\n    for (const item of items) {\n      if (item.promotedFromPlan) {\n        (item.status === 'completed' ? completedPlanIds : pendingPlanIds).add(\n          item.promotedFromPlan,\n        );\n      }\n      if (item.promotedFromTask) {\n        (item.status === 'completed' ? completedTaskIds : pendingTaskIds).add(\n          item.promotedFromTask,\n        );\n      }\n    }\n\n    // Mark fully-completed plan items as done\n    for (const planId of completedPlanIds) {\n      if (pendingPlanIds.has(planId)) continue; // not all done yet\n      const planPath = (ctx.meta as Record<string, unknown>)['plan.path'];\n      if (typeof planPath !== 'string' || !planPath) continue;\n      try {\n        const plan = await loadPlan(planPath);\n        if (plan) {\n          const updated = setPlanItemStatus(plan, planId, 'done');\n          await savePlan(planPath, updated);\n        }\n      } catch {\n        /* best-effort */\n      }\n    }\n\n    // Mark fully-completed tasks as completed\n    for (const taskId of completedTaskIds) {\n      if (pendingTaskIds.has(taskId)) continue; // not all done yet\n      const taskPath = (ctx.meta as Record<string, unknown>)['task.path'];\n      if (typeof taskPath !== 'string' || !taskPath) continue;\n      try {\n        const file = await loadTasks(taskPath);\n        if (file) {\n          const task = file.tasks.find((t) => t.id === taskId);\n          if (task && task.status !== 'completed') {\n            task.status = 'completed';\n            task.updatedAt = new Date().toISOString();\n            await saveTasks(taskPath, file);\n          }\n        }\n      } catch {\n        /* best-effort */\n      }\n    }\n\n    return {\n      count: items.length,\n      in_progress: items.filter((t) => t.status === 'in_progress').length,\n    };\n  },\n};\n", "import { type FSWatcher, watch } from 'node:fs';\nimport { basename, dirname } from 'node:path';\nimport {\n  type Context,\n  deserializeTaskGraph,\n  GlobalMailbox,\n  loadPlan,\n  loadTasks,\n  mutatePlan,\n  mutateTasks,\n  type PlanFile,\n  type PlanItem,\n  type SerializedTaskGraph,\n  type TaskFile,\n  type TaskItem,\n  type TaskStatus,\n  type TodoItem,\n} from '@wrongstack/core';\nimport { resolveWstackPaths } from '@wrongstack/core/utils';\nimport {\n  createBoard,\n  getBoard,\n  getKanbanDir,\n  type KanbanBoard,\n  type KanbanColumn,\n  type KanbanTask,\n  listBoards,\n  removeBoard,\n  syncBoardFromTaskGraph,\n  touchKanbanPresence,\n  updateBoard,\n} from '@wrongstack/kanban';\n\nconst SESSION_BOARD_TAG = 'session-work';\nconst MIRROR_DISABLED_ENV = 'WRONGSTACK_KANBAN_TASK_MIRROR';\n\n/** The canonical workflow shared by WebUI and TUI session boards. */\nexport const SESSION_KANBAN_COLUMNS: KanbanColumn[] = [\n  { id: 'todo', title: 'Todo', order: 0, wipLimit: 0, color: '#2563eb' },\n  { id: 'in-progress', title: 'Running', order: 1, wipLimit: 1, color: '#d97706' },\n  { id: 'review', title: 'Preview', order: 2, wipLimit: 0, color: '#7c3aed' },\n  { id: 'done', title: 'Done', order: 3, wipLimit: 0, color: '#16a34a' },\n];\n\nconst boardQueue = new Map<string, Promise<void>>();\nconst boardEnsures = new Map<string, Promise<KanbanBoard>>();\ntype PendingMirror = {\n  projectRoot: string;\n  sessionId: string;\n  graph: SerializedTaskGraph;\n  sourceSystem: 'session-todo' | 'session-task' | 'session-plan';\n};\nconst pendingMirrors = new Map<string, PendingMirror>();\nconst activeMirrors = new Set<string>();\nconst bindings = new WeakMap<Context, () => void>();\nconst suppressedTodoMirrors = new WeakSet<Context>();\nconst activeSessionBoards = new Map<string, number>();\n\nfunction boardKey(projectRoot: string, sessionId: string): string {\n  return `${projectRoot}\\0${sessionId}`;\n}\n\nfunction mirrorKey(\n  projectRoot: string,\n  sessionId: string,\n  sourceSystem: PendingMirror['sourceSystem'],\n): string {\n  return `${boardKey(projectRoot, sessionId)}\\0${sourceSystem}`;\n}\n\nfunction sessionTag(sessionId: string): string {\n  return `session:${sessionId}`;\n}\n\nfunction sessionBoardTitle(sessionId: string): string {\n  const leaf = sessionId.split(/[\\\\/]/).filter(Boolean).pop() ?? sessionId;\n  return `Session ${leaf.slice(0, 12)}`;\n}\n\nfunction sessionBoardTags(sessionId: string): string[] {\n  return ['session', SESSION_BOARD_TAG, sessionTag(sessionId)];\n}\n\nfunction sessionIdFromTags(tags: readonly string[] | undefined): string | null {\n  const tag = tags?.find((candidate) => candidate.startsWith('session:'));\n  return tag?.slice('session:'.length) || null;\n}\n\nfunction isOwnedSessionBoard(tags: readonly string[] | undefined): boolean {\n  return Boolean(tags?.includes(SESSION_BOARD_TAG) && sessionIdFromTags(tags));\n}\n\nfunction retainActiveSessionBoard(projectRoot: string, sessionId: string): void {\n  const key = boardKey(projectRoot, sessionId);\n  activeSessionBoards.set(key, (activeSessionBoards.get(key) ?? 0) + 1);\n}\n\nfunction releaseActiveSessionBoard(projectRoot: string, sessionId: string): void {\n  const key = boardKey(projectRoot, sessionId);\n  const remaining = (activeSessionBoards.get(key) ?? 0) - 1;\n  if (remaining > 0) activeSessionBoards.set(key, remaining);\n  else activeSessionBoards.delete(key);\n}\n\nfunction isSessionBoardActive(projectRoot: string, sessionId: string): boolean {\n  return (activeSessionBoards.get(boardKey(projectRoot, sessionId)) ?? 0) > 0;\n}\n\nfunction sameColumns(columns: readonly KanbanColumn[]): boolean {\n  return (\n    columns.length === SESSION_KANBAN_COLUMNS.length &&\n    columns.every((column, index) => column.id === SESSION_KANBAN_COLUMNS[index]?.id)\n  );\n}\n\n/** Create (or migrate) the single Kanban board owned by a session. */\nexport async function ensureSessionKanbanBoard(\n  projectRoot: string | undefined,\n  sessionId: string,\n): Promise<KanbanBoard | null> {\n  if (!projectRoot || !sessionId || process.env[MIRROR_DISABLED_ENV] === '0') return null;\n  const key = boardKey(projectRoot, sessionId);\n  const inFlight = boardEnsures.get(key);\n  if (inFlight) return inFlight;\n\n  const promise = (async () => {\n    const summary = (await listBoards(projectRoot)).find((board) =>\n      board.tags?.includes(sessionTag(sessionId)),\n    );\n    let board = summary ? await getBoard(projectRoot, summary.id) : null;\n    if (!board) {\n      return createBoard(projectRoot, {\n        title: sessionBoardTitle(sessionId),\n        description: 'Live session work: todos, tasks, and plan items.',\n        tags: sessionBoardTags(sessionId),\n        columns: SESSION_KANBAN_COLUMNS,\n        generatedBy: `session-kanban:${sessionId}`,\n      });\n    }\n\n    // Boards produced by the older task/plan mirrors used the generic five\n    // columns. Migrate only session-owned boards; updateBoard reconciles cards\n    // from Backlog into Todo while preserving Running/Preview/Done cards.\n    if (!sameColumns(board.columns) || !board.tags?.includes(SESSION_BOARD_TAG)) {\n      board =\n        (await updateBoard(projectRoot, board.id, {\n          title: sessionBoardTitle(sessionId),\n          description: 'Live session work: todos, tasks, and plan items.',\n          tags: [...new Set([...(board.tags ?? []), ...sessionBoardTags(sessionId)])],\n          columns: SESSION_KANBAN_COLUMNS,\n        })) ?? board;\n    }\n    return board;\n  })();\n\n  boardEnsures.set(key, promise);\n  try {\n    return await promise;\n  } finally {\n    boardEnsures.delete(key);\n  }\n}\n\nfunction enqueueBoardWork<T>(\n  projectRoot: string,\n  sessionId: string,\n  work: () => Promise<T>,\n): Promise<T> {\n  const key = boardKey(projectRoot, sessionId);\n  const previous = boardQueue.get(key) ?? Promise.resolve();\n  const result = previous.catch(() => undefined).then(work);\n  const tail = result.then(\n    () => undefined,\n    () => undefined,\n  );\n  boardQueue.set(key, tail);\n  void tail.then(() => {\n    if (boardQueue.get(key) === tail) boardQueue.delete(key);\n  });\n  return result;\n}\n\nasync function removeEmptySessionBoard(\n  projectRoot: string,\n  boardId: string,\n  sessionId: string,\n): Promise<string | null> {\n  return enqueueBoardWork(projectRoot, sessionId, async () => {\n    if (isSessionBoardActive(projectRoot, sessionId)) return null;\n    const board = await getBoard(projectRoot, boardId);\n    if (!board || board.tasks.length > 0 || !isOwnedSessionBoard(board.tags)) return null;\n    if (sessionIdFromTags(board.tags) !== sessionId) return null;\n    return (await removeBoard(projectRoot, board.id)) ? board.id : null;\n  });\n}\n\n/** Remove a particular inactive session's system-owned board when it has no cards. */\nexport async function cleanupSessionKanbanBoardIfEmpty(\n  projectRoot: string | undefined,\n  sessionId: string,\n): Promise<string[]> {\n  if (!projectRoot || !sessionId || process.env[MIRROR_DISABLED_ENV] === '0') return [];\n  if (isSessionBoardActive(projectRoot, sessionId)) return [];\n  const candidates = (await listBoards(projectRoot)).filter(\n    (board) =>\n      board.taskCount === 0 &&\n      isOwnedSessionBoard(board.tags) &&\n      sessionIdFromTags(board.tags) === sessionId,\n  );\n  const removed = await Promise.all(\n    candidates.map((board) => removeEmptySessionBoard(projectRoot, board.id, sessionId)),\n  );\n  return removed.filter((boardId): boardId is string => Boolean(boardId));\n}\n\n/** Prune stale empty session boards while preserving manual and live boards. */\nexport async function cleanupEmptySessionKanbanBoards(\n  projectRoot: string | undefined,\n  activeSessionId = '',\n): Promise<string[]> {\n  if (!projectRoot || process.env[MIRROR_DISABLED_ENV] === '0') return [];\n  const candidates = (await listBoards(projectRoot)).flatMap((board) => {\n    const ownerSessionId = sessionIdFromTags(board.tags);\n    return board.taskCount === 0 &&\n      isOwnedSessionBoard(board.tags) &&\n      ownerSessionId &&\n      ownerSessionId !== activeSessionId &&\n      !isSessionBoardActive(projectRoot, ownerSessionId)\n      ? [{ boardId: board.id, sessionId: ownerSessionId }]\n      : [];\n  });\n  const removed = await Promise.all(\n    candidates.map(({ boardId, sessionId }) =>\n      removeEmptySessionBoard(projectRoot, boardId, sessionId),\n    ),\n  );\n  return removed.filter((boardId): boardId is string => Boolean(boardId));\n}\n\nasync function projectGraph(\n  projectRoot: string | undefined,\n  sessionId: string,\n  graph: SerializedTaskGraph,\n  sourceSystem: 'session-todo' | 'session-task' | 'session-plan',\n): Promise<KanbanBoard | null> {\n  if (!projectRoot || !sessionId || process.env[MIRROR_DISABLED_ENV] === '0') return null;\n  return enqueueBoardWork(projectRoot, sessionId, async () => {\n    const board = await ensureSessionKanbanBoard(projectRoot, sessionId);\n    if (!board) return null;\n    const result = await syncBoardFromTaskGraph(\n      projectRoot,\n      board.id,\n      deserializeTaskGraph(graph),\n      {\n        sourceSystem,\n        tags: [...new Set([...(board.tags ?? []), ...sessionBoardTags(sessionId)])],\n        archiveMissingTasks: true,\n        includeCompletedTasks: true,\n      },\n    );\n    return result?.board ?? null;\n  });\n}\n\n/**\n * Queue an observational mirror without retaining every intermediate state.\n * Todo/task/plan streams are independent, but within each stream only the\n * newest pending graph matters. This bounds a stalled file lock to one active\n * and one pending projection instead of an arbitrarily long Promise chain.\n */\nfunction queueLatestMirror(\n  projectRoot: string | undefined,\n  sessionId: string,\n  graph: SerializedTaskGraph,\n  sourceSystem: PendingMirror['sourceSystem'],\n): void {\n  if (!projectRoot || !sessionId || process.env[MIRROR_DISABLED_ENV] === '0') return;\n  const key = mirrorKey(projectRoot, sessionId, sourceSystem);\n  pendingMirrors.set(key, { projectRoot, sessionId, graph, sourceSystem });\n  if (activeMirrors.has(key)) return;\n  activeMirrors.add(key);\n  void (async () => {\n    try {\n      for (;;) {\n        const pending = pendingMirrors.get(key);\n        if (!pending) break;\n        pendingMirrors.delete(key);\n        try {\n          await projectGraph(\n            pending.projectRoot,\n            pending.sessionId,\n            pending.graph,\n            pending.sourceSystem,\n          );\n        } catch {\n          // Mirrors are observational. A newer pending snapshot, if present,\n          // still gets a chance after a transient lock or filesystem failure.\n        }\n      }\n    } finally {\n      activeMirrors.delete(key);\n      // A mirror can arrive between the last Map read and deleting the active\n      // marker. Re-arm once so that snapshot cannot be stranded.\n      const pending = pendingMirrors.get(key);\n      if (pending) {\n        pendingMirrors.delete(key);\n        queueLatestMirror(\n          pending.projectRoot,\n          pending.sessionId,\n          pending.graph,\n          pending.sourceSystem,\n        );\n      }\n    }\n  })();\n}\n\nexport function todoListToSerializedGraph(\n  todos: readonly TodoItem[],\n  sessionId: string,\n): SerializedTaskGraph {\n  const nodes = todos.map((todo, index) => ({\n    id: todo.id,\n    title: todo.content,\n    description: todo.activeForm ?? '',\n    type: 'chore' as const,\n    priority: 'medium' as const,\n    status: todo.status,\n    createdAt: index,\n    updatedAt: index,\n  }));\n  return {\n    id: `todo:${sessionId}`,\n    specId: `todo:${sessionId}`,\n    title: 'Session todos',\n    nodes,\n    edges: [],\n    rootNodes: nodes.map((node) => node.id),\n    createdAt: 0,\n    updatedAt: 0,\n  };\n}\n\nexport function taskFileToSerializedGraph(\n  tasks: readonly TaskItem[],\n  sessionId: string,\n): SerializedTaskGraph {\n  const ids = new Set(tasks.map((task) => task.id));\n  const nodes = tasks.map((task, index) => ({\n    id: task.id,\n    title: task.title,\n    description: task.description ?? '',\n    type: task.type,\n    priority: task.priority,\n    status: task.status,\n    ...(task.assignee ? { assignee: task.assignee } : {}),\n    ...(task.estimateHours !== undefined ? { estimateHours: task.estimateHours } : {}),\n    createdAt: index,\n    updatedAt: index,\n  }));\n  const edges = tasks.flatMap((task) =>\n    (task.dependsOn ?? [])\n      .filter((dependency) => ids.has(dependency))\n      .map((dependency) => ({\n        id: `${dependency}->${task.id}`,\n        from: dependency,\n        to: task.id,\n        type: 'depends_on' as const,\n      })),\n  );\n  const hasIncoming = new Set(edges.map((edge) => edge.to));\n  const rootNodes = nodes.filter((node) => !hasIncoming.has(node.id)).map((node) => node.id);\n  return {\n    // Keep the historical graph id so existing mirrored task cards are reused.\n    id: `session:${sessionId}`,\n    specId: `session:${sessionId}`,\n    title: 'Session tasks',\n    nodes,\n    edges,\n    rootNodes: rootNodes.length ? rootNodes : nodes[0] ? [nodes[0].id] : [],\n    createdAt: 0,\n    updatedAt: 0,\n  };\n}\n\nconst PLAN_STATUS_TO_TASK: Record<PlanItem['status'], TaskStatus> = {\n  open: 'pending',\n  in_progress: 'in_progress',\n  done: 'completed',\n};\n\nexport function planFileToSerializedGraph(\n  items: readonly PlanItem[],\n  sessionId: string,\n): SerializedTaskGraph {\n  const nodes = items.map((item, index) => ({\n    id: item.id,\n    title: item.title,\n    description: item.details ?? '',\n    type: 'chore' as const,\n    priority: 'medium' as const,\n    status: PLAN_STATUS_TO_TASK[item.status],\n    createdAt: index,\n    updatedAt: index,\n  }));\n  return {\n    id: `plan:${sessionId}`,\n    specId: `plan:${sessionId}`,\n    title: 'Session plan',\n    nodes,\n    edges: [],\n    rootNodes: nodes.map((node) => node.id),\n    createdAt: 0,\n    updatedAt: 0,\n  };\n}\n\nexport function projectSessionTodosToKanban(\n  projectRoot: string | undefined,\n  todos: readonly TodoItem[],\n  sessionId: string,\n): Promise<KanbanBoard | null> {\n  return projectGraph(\n    projectRoot,\n    sessionId,\n    todoListToSerializedGraph(todos, sessionId),\n    'session-todo',\n  );\n}\n\nexport function projectSessionTasksToKanban(\n  projectRoot: string | undefined,\n  tasks: readonly TaskItem[],\n  sessionId: string,\n): Promise<KanbanBoard | null> {\n  return projectGraph(\n    projectRoot,\n    sessionId,\n    taskFileToSerializedGraph(tasks, sessionId),\n    'session-task',\n  );\n}\n\nexport function projectSessionPlanToKanban(\n  projectRoot: string | undefined,\n  items: readonly PlanItem[],\n  sessionId: string,\n): Promise<KanbanBoard | null> {\n  return projectGraph(\n    projectRoot,\n    sessionId,\n    planFileToSerializedGraph(items, sessionId),\n    'session-plan',\n  );\n}\n\nfunction fireAndForget(work: Promise<unknown>): void {\n  void work.catch(() => {\n    // The session files/state remain recoverable if the observational board\n    // cannot be written; the next mutation or file watcher retries the mirror.\n  });\n}\n\nfunction broadcastTodoUpdate(context: Context, todos: readonly TodoItem[]): void {\n  const sessionId = context.session?.id ?? '';\n  if (!context.agentId || !sessionId) return;\n  const projectDir = resolveWstackPaths({ projectRoot: context.projectRoot }).projectDir;\n  const mailbox = new GlobalMailbox(projectDir);\n  void mailbox\n    .send({\n      from: context.agentId,\n      to: '*',\n      type: 'status',\n      subject: `Kanban todo list updated (${todos.length} item${todos.length === 1 ? '' : 's'})`,\n      body: JSON.stringify({\n        kind: 'kanban.todos.updated',\n        sessionId,\n        revision: context.state.revision,\n        todos,\n      }),\n      priority: 'normal',\n      senderSessionId: sessionId,\n      ttlMs: 6 * 60 * 60 * 1000,\n    })\n    .catch(() => {\n      // Mailbox awareness is best-effort; canonical state is already updated.\n    });\n}\n\nfunction notifyTodoUpdate(context: Context, todos: readonly TodoItem[]): void {\n  const summary = todos.length\n    ? todos\n        .map((todo) => `- [${todo.status}] ${todo.content} (${todo.id})`)\n        .join('\\n')\n    : '- No active todos remain.';\n  const text = `[KANBAN TODO UPDATE]\\nAnother Kanban agent reassessed the shared board. The canonical todo list is now:\\n${summary}\\nReassess your current plan before continuing; do not rely on the initial todo snapshot.`;\n  const state = context.state as Partial<Context['state']>;\n  if (typeof state.appendBlockToLastUserMessage === 'function') {\n    if (state.appendBlockToLastUserMessage({ type: 'text', text })) return;\n  }\n  if (typeof state.appendMessage === 'function') {\n    state.appendMessage({ role: 'user', content: [{ type: 'text', text }] });\n  }\n}\n\nexport function mirrorSessionTodosToKanban(\n  projectRoot: string | undefined,\n  todos: readonly TodoItem[],\n  sessionId: string,\n): void {\n  queueLatestMirror(\n    projectRoot,\n    sessionId,\n    todoListToSerializedGraph(todos, sessionId),\n    'session-todo',\n  );\n}\n\nexport function mirrorSessionTasksToKanban(\n  projectRoot: string | undefined,\n  tasks: readonly TaskItem[],\n  sessionId: string,\n): void {\n  queueLatestMirror(\n    projectRoot,\n    sessionId,\n    taskFileToSerializedGraph(tasks, sessionId),\n    'session-task',\n  );\n}\n\nexport function mirrorSessionPlanToKanban(\n  projectRoot: string | undefined,\n  items: readonly PlanItem[],\n  sessionId: string,\n): void {\n  queueLatestMirror(\n    projectRoot,\n    sessionId,\n    planFileToSerializedGraph(items, sessionId),\n    'session-plan',\n  );\n}\n\n/**\n * Bind all live session work paths to Kanban. Todo changes are observed from\n * ConversationState; plan/task sidecars are watched so slash commands, WebUI,\n * plugins, and tools all pass through the same board.\n */\nexport function attachSessionKanbanMirror(context: Context): () => void {\n  const existing = bindings.get(context);\n  if (existing) return existing;\n\n  const attachedProjectRoot = context.projectRoot ?? '';\n  let registeredSessionId = '';\n  const syncActiveSessionRegistration = () => {\n    if (!attachedProjectRoot) return;\n    const currentSessionId = context.session?.id ?? '';\n    if (currentSessionId === registeredSessionId) return;\n    if (registeredSessionId) {\n      releaseActiveSessionBoard(attachedProjectRoot, registeredSessionId);\n      fireAndForget(cleanupSessionKanbanBoardIfEmpty(attachedProjectRoot, registeredSessionId));\n    }\n    registeredSessionId = currentSessionId;\n    if (registeredSessionId) {\n      retainActiveSessionBoard(attachedProjectRoot, registeredSessionId);\n    }\n  };\n  syncActiveSessionRegistration();\n\n  let watcher: FSWatcher | null = null;\n  let watchedDir = '';\n  let timer: NodeJS.Timeout | null = null;\n  let boardWatcher: FSWatcher | null = null;\n  let watchedBoardId = '';\n  let boardTimer: NodeJS.Timeout | null = null;\n  let presenceTimer: NodeJS.Timeout | null = null;\n\n  const sessionId = () => context.session?.id ?? '';\n  const refreshFiles = async () => {\n    const id = sessionId();\n    if (!id) return;\n    const planPath = context.meta['plan.path'];\n    if (typeof planPath === 'string' && planPath) {\n      const plan = await loadPlan(planPath);\n      if (plan) await projectSessionPlanToKanban(context.projectRoot, plan.items, id);\n    }\n    const taskPath = context.meta['task.path'];\n    if (typeof taskPath === 'string' && taskPath) {\n      const tasks = await loadTasks(taskPath);\n      if (tasks) await projectSessionTasksToKanban(context.projectRoot, tasks.tasks, id);\n    }\n  };\n\n  const refreshBoard = async () => {\n    if (!watchedBoardId) return;\n    const board = await getBoard(context.projectRoot, watchedBoardId);\n    if (board) applySessionKanbanBoardToTodos(context, board);\n  };\n\n  const configureBoardWatcher = async () => {\n    const id = sessionId();\n    const board = id ? await ensureSessionKanbanBoard(context.projectRoot, id) : null;\n    if (!board || board.id === watchedBoardId) return;\n    boardWatcher?.close();\n    boardWatcher = null;\n    watchedBoardId = board.id;\n    try {\n      const boardFileName = `${board.id}.json`;\n      boardWatcher = watch(\n        getKanbanDir(context.projectRoot),\n        { persistent: false },\n        (_event, filename) => {\n          if (filename?.toString() !== boardFileName) return;\n          if (boardTimer) clearTimeout(boardTimer);\n          boardTimer = setTimeout(() => fireAndForget(refreshBoard()), 60);\n        },\n      );\n      const touchPresence = () =>\n        touchKanbanPresence(context.projectRoot, board.id, {\n          sessionId: id,\n          agentId: context.agentId,\n          agentName: context.agentName,\n        });\n      fireAndForget(touchPresence());\n      if (presenceTimer) clearInterval(presenceTimer);\n      presenceTimer = setInterval(() => fireAndForget(touchPresence()), 60_000);\n      presenceTimer.unref?.();\n      boardWatcher.on('error', () => {\n        boardWatcher?.close();\n        boardWatcher = null;\n        watchedBoardId = '';\n      });\n    } catch {\n      boardWatcher = null;\n      watchedBoardId = '';\n    }\n  };\n\n  const configureWatcher = () => {\n    const planPath = context.meta['plan.path'];\n    const taskPath = context.meta['task.path'];\n    const candidate =\n      typeof planPath === 'string' && planPath\n        ? dirname(planPath)\n        : typeof taskPath === 'string' && taskPath\n          ? dirname(taskPath)\n          : '';\n    if (!candidate || candidate === watchedDir) return;\n    watcher?.close();\n    watcher = null;\n    watchedDir = candidate;\n    try {\n      watcher = watch(candidate, { persistent: false }, (_event, filename) => {\n        const name = filename?.toString();\n        const currentPlanPath = context.meta['plan.path'];\n        const currentTaskPath = context.meta['task.path'];\n        const planName = typeof currentPlanPath === 'string' ? basename(currentPlanPath) : '';\n        const taskName = typeof currentTaskPath === 'string' ? basename(currentTaskPath) : '';\n        if (name && name !== planName && name !== taskName) return;\n        if (timer) clearTimeout(timer);\n        timer = setTimeout(() => fireAndForget(refreshFiles()), 60);\n      });\n      watcher.on('error', () => watcher?.close());\n    } catch {\n      // The session directory can briefly disappear during project/session\n      // switches; the next meta update re-attempts the binding.\n      watcher = null;\n      watchedDir = '';\n    }\n  };\n\n  const unsubscribe = context.state.onChange((change) => {\n    if (change.kind === 'todos_replaced' && !suppressedTodoMirrors.has(context)) {\n      // ConversationState auto-clears an all-done tactical list. Project the\n      // pre-clear completion snapshot so every card reaches Done atomically.\n      mirrorSessionTodosToKanban(\n        context.projectRoot,\n        change.completedSnapshot ?? change.todos,\n        sessionId(),\n      );\n      return;\n    }\n    if (change.kind === 'meta_set' && (change.key === 'plan.path' || change.key === 'task.path')) {\n      syncActiveSessionRegistration();\n      configureWatcher();\n      fireAndForget(ensureSessionKanbanBoard(context.projectRoot, sessionId()));\n      fireAndForget(configureBoardWatcher());\n      fireAndForget(refreshFiles());\n    }\n  });\n\n  configureWatcher();\n  fireAndForget(configureBoardWatcher());\n\n  const detach = () => {\n    unsubscribe();\n    if (timer) clearTimeout(timer);\n    if (boardTimer) clearTimeout(boardTimer);\n    if (presenceTimer) clearInterval(presenceTimer);\n    watcher?.close();\n    boardWatcher?.close();\n    bindings.delete(context);\n    if (attachedProjectRoot && registeredSessionId) {\n      releaseActiveSessionBoard(attachedProjectRoot, registeredSessionId);\n      fireAndForget(cleanupSessionKanbanBoardIfEmpty(attachedProjectRoot, registeredSessionId));\n      registeredSessionId = '';\n    }\n  };\n  bindings.set(context, detach);\n  return detach;\n}\n\n/** Fully hydrate a session board before a host announces the session as ready. */\nexport async function hydrateSessionKanban(context: Context): Promise<KanbanBoard | null> {\n  const id = context.session?.id ?? '';\n  if (!id) return null;\n  await cleanupEmptySessionKanbanBoards(context.projectRoot, id);\n  let board = await ensureSessionKanbanBoard(context.projectRoot, id);\n  if (context.todos.length) {\n    board = await projectSessionTodosToKanban(context.projectRoot, context.todos, id);\n  }\n  const planPath = context.meta['plan.path'];\n  if (typeof planPath === 'string' && planPath) {\n    const plan = await loadPlan(planPath);\n    if (plan) board = await projectSessionPlanToKanban(context.projectRoot, plan.items, id);\n  }\n  const taskPath = context.meta['task.path'];\n  if (typeof taskPath === 'string' && taskPath) {\n    const tasks = await loadTasks(taskPath);\n    if (tasks) board = await projectSessionTasksToKanban(context.projectRoot, tasks.tasks, id);\n  }\n  return board;\n}\n\nexport interface SessionKanbanSourceUpdate {\n  source: 'todo' | 'task' | 'plan' | null;\n  todos?: TodoItem[] | undefined;\n  tasks?: TaskFile | undefined;\n  plan?: PlanFile | undefined;\n}\n\nfunction sourceStatus(task: KanbanTask): TaskStatus {\n  if (task.status === 'completed') return 'completed';\n  if (task.status === 'in_progress') return 'in_progress';\n  if (task.status === 'review') return 'review';\n  if (task.status === 'blocked') return 'blocked';\n  if (task.status === 'failed') return 'failed';\n  return 'pending';\n}\n\nfunction todoStatus(task: KanbanTask): TodoItem['status'] {\n  const status = sourceStatus(task);\n  if (status === 'completed') return 'completed';\n  if (status === 'in_progress' || status === 'review') return 'in_progress';\n  return 'pending';\n}\n\nfunction sessionTodoFromTask(task: KanbanTask): TodoItem {\n  return {\n    id: task.origin?.taskId ?? task.id,\n    content: task.title,\n    status: todoStatus(task),\n    ...(task.description ? { activeForm: task.description } : {}),\n  };\n}\n\nfunction sameTodos(left: readonly TodoItem[], right: readonly TodoItem[]): boolean {\n  return (\n    left.length === right.length &&\n    left.every((todo, index) => {\n      const candidate = right[index];\n      return (\n        candidate?.id === todo.id &&\n        candidate.content === todo.content &&\n        candidate.status === todo.status &&\n        candidate.activeForm === todo.activeForm &&\n        candidate.promotedFromPlan === todo.promotedFromPlan &&\n        candidate.promotedFromTask === todo.promotedFromTask\n      );\n    })\n  );\n}\n\n/**\n * Replace the tactical todo list from the current cards on a session-owned board.\n *\n * Existing mirrored todo cards retain their stable source ids. New cards created\n * by a Kanban worker become todos under their card ids, so reassessment can add,\n * split, merge, reprioritize, or remove work without being overwritten by the\n * todo list that happened to exist when the run started.\n */\nexport function applySessionKanbanBoardToTodos(context: Context, board: KanbanBoard): TodoItem[] {\n  const sessionId = context.session?.id ?? '';\n  if (!sessionId || sessionIdFromTags(board.tags) !== sessionId || !isOwnedSessionBoard(board.tags)) {\n    return [...context.todos];\n  }\n\n  const projectedTodos = board.tasks\n    .filter(\n      (task) =>\n        task.status !== 'archived' &&\n        (!task.origin ||\n          task.origin.system === 'session-todo' ||\n          (task.origin.graphId ?? '').startsWith('todo:')),\n    )\n    .sort((left, right) => {\n      const leftColumn = board.columns.find((column) => column.id === left.columnId)?.order ?? 0;\n      const rightColumn = board.columns.find((column) => column.id === right.columnId)?.order ?? 0;\n      return leftColumn - rightColumn || left.order - right.order || left.createdAt.localeCompare(right.createdAt);\n    })\n    .map(sessionTodoFromTask);\n\n  const allCompleted =\n    projectedTodos.length > 0 && projectedTodos.every((todo) => todo.status === 'completed');\n  const effectiveTodos = allCompleted ? [] : projectedTodos;\n  if (sameTodos(context.todos, effectiveTodos)) return [...context.todos];\n  suppressedTodoMirrors.add(context);\n  try {\n    context.state.replaceTodos(projectedTodos);\n  } finally {\n    suppressedTodoMirrors.delete(context);\n  }\n  notifyTodoUpdate(context, context.todos);\n  broadcastTodoUpdate(context, context.todos);\n  return [...context.todos];\n}\n\n/** Reflect a TUI/WebUI Kanban card edit back to its originating work list. */\nexport async function applySessionKanbanTaskToSource(\n  context: Context,\n  task: KanbanTask,\n  options: { remove?: boolean | undefined } = {},\n): Promise<SessionKanbanSourceUpdate> {\n  const originId = task.origin?.taskId;\n  const graphId = task.origin?.graphId ?? '';\n  if (!originId) return { source: null };\n\n  if (task.origin?.system === 'session-todo' || graphId.startsWith('todo:')) {\n    const next = options.remove\n      ? context.todos.filter((todo) => todo.id !== originId)\n      : context.todos.map((todo) =>\n          todo.id === originId\n            ? {\n                ...todo,\n                content: task.title,\n                status:\n                  sourceStatus(task) === 'completed'\n                    ? ('completed' as const)\n                    : sourceStatus(task) === 'in_progress' || sourceStatus(task) === 'review'\n                      ? ('in_progress' as const)\n                      : ('pending' as const),\n              }\n            : todo,\n        );\n    suppressedTodoMirrors.add(context);\n    try {\n      context.state.replaceTodos(next);\n    } finally {\n      suppressedTodoMirrors.delete(context);\n    }\n    return { source: 'todo', todos: [...context.todos] };\n  }\n\n  const id = context.session?.id ?? '';\n  if (task.origin?.system === 'session-plan' || graphId.startsWith('plan:')) {\n    const planPath = context.meta['plan.path'];\n    if (typeof planPath !== 'string' || !planPath) return { source: 'plan' };\n    const plan = await mutatePlan(planPath, id, (file) => ({\n      ...file,\n      updatedAt: new Date().toISOString(),\n      items: options.remove\n        ? file.items.filter((item) => item.id !== originId)\n        : file.items.map((item) =>\n            item.id === originId\n              ? {\n                  ...item,\n                  title: task.title,\n                  details: task.description,\n                  status:\n                    task.status === 'completed'\n                      ? ('done' as const)\n                      : task.status === 'in_progress' || task.status === 'review'\n                        ? ('in_progress' as const)\n                        : ('open' as const),\n                  updatedAt: new Date().toISOString(),\n                }\n              : item,\n          ),\n    }));\n    return { source: 'plan', plan };\n  }\n\n  if (\n    task.origin?.system === 'session-task' ||\n    task.origin?.system === 'session' ||\n    graphId.startsWith('session:')\n  ) {\n    const taskPath = context.meta['task.path'];\n    if (typeof taskPath !== 'string' || !taskPath) return { source: 'task' };\n    const tasks = await mutateTasks(taskPath, id, (file) => ({\n      ...file,\n      tasks: options.remove\n        ? file.tasks.filter((item) => item.id !== originId)\n        : file.tasks.map((item) =>\n            item.id === originId\n              ? {\n                  ...item,\n                  title: task.title,\n                  description: task.description,\n                  status: sourceStatus(task),\n                  updatedAt: new Date().toISOString(),\n                }\n              : item,\n          ),\n    }));\n    return { source: 'task', tasks };\n  }\n\n  return { source: null };\n}\n"],
-  "mappings": "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",
+  "sourcesContent": ["import type { TodoItem } from '@wrongstack/core/agent';\nimport type { Tool } from '@wrongstack/core/types';\nimport { loadPlan, loadTasks, savePlan, saveTasks, setPlanItemStatus } from '@wrongstack/core/storage';\nimport { projectSessionTodosToKanban } from './session-kanban.js';\n\ninterface TodoInput {\n  todos: TodoItem[];\n}\n\ninterface TodoOutput {\n  count: number;\n  in_progress: number;\n}\n\nexport const todoTool: Tool<TodoInput, TodoOutput> = {\n  name: 'todo',\n  category: 'Session',\n  description:\n    'Manage the session-level todo list. This is the primary mechanism for tracking multi-step work. ' +\n    'The list is fully replaced on every call (not appended).',\n  usageHint:\n    'BEST PRACTICE for complex tasks:\\n' +\n    '- At the beginning of a non-trivial task, create a clear todo list with specific, actionable items.\\n' +\n    '- Only **one** item should be `in_progress` at any time.\\n' +\n    '- Update the list frequently as work progresses (mark items done, add new ones, change status).\\n' +\n    '- **Re-order items** to reflect current priorities \u2014 the full list is replaced each call, so item order is entirely under your control.\\n' +\n    '- When all items are completed the board auto-clears \u2014 you do NOT need to send an empty list.\\n' +\n    '- The system and user can see this list, so keep it honest and up-to-date.\\n' +\n    'This tool is extremely valuable for maintaining focus and giving the user visibility into your plan.',\n  permission: 'auto',\n  mutating: false, // mutates only conversation state (ctx.todos), not external state \u2014 no confirmation needed\n  timeoutMs: 5_000,\n  capabilities: ['session.todo'],\n  icon: 'todo',\n  inputSchema: {\n    type: 'object',\n    properties: {\n      todos: {\n        type: 'array',\n        items: {\n          type: 'object',\n          properties: {\n            id: {\n              type: 'string',\n              description: 'Unique identifier for the todo item (e.g. \"1\", \"auth-flow\").',\n            },\n            content: {\n              type: 'string',\n              description: 'Clear, actionable description of the task.',\n            },\n            status: {\n              type: 'string',\n              enum: ['pending', 'in_progress', 'completed'],\n              description: 'Current status. Only one item should be \"in_progress\" at a time.',\n            },\n            activeForm: {\n              type: 'string',\n              description:\n                'Optional present-tense form shown while the task is active (e.g. \"Fixing auth bug\").',\n            },\n          },\n          required: ['id', 'content', 'status'],\n        },\n        description: 'The complete new list of todos. This replaces the previous list entirely.',\n      },\n    },\n    required: ['todos'],\n  },\n  async execute(input, ctx) {\n    if (!Array.isArray(input?.todos)) {\n      throw new Error('todo: todos must be an array');\n    }\n    const items = input.todos.filter((t): t is TodoItem => Boolean(t?.id && t.content));\n    const inProgress = items.filter((t) => t.status === 'in_progress');\n    if (inProgress.length > 1) {\n      // Keep only the first as in_progress, mark rest pending\n      let seenInProgress = false;\n      for (const item of items) {\n        if (item.status === 'in_progress') {\n          if (seenInProgress) item.status = 'pending';\n          seenInProgress = true;\n        }\n      }\n    }\n    ctx.state.replaceTodos(items);\n\n    // Kanban is the session work surface. Mirror the requested list (rather\n    // than ctx.todos) so the final all-completed snapshot reaches Done even\n    // though ConversationState auto-clears an all-done tactical todo list.\n    await projectSessionTodosToKanban(ctx.projectRoot, items, ctx.session?.id ?? 'session');\n\n    // Auto-complete parent plan items / tasks when all their promoted\n    // todos are done. Runs after state mutation so the UI sees the new\n    // todo list before we touch the plan/task files.\n    const completedPlanIds = new Set<string>();\n    const completedTaskIds = new Set<string>();\n    const pendingPlanIds = new Set<string>();\n    const pendingTaskIds = new Set<string>();\n\n    for (const item of items) {\n      if (item.promotedFromPlan) {\n        (item.status === 'completed' ? completedPlanIds : pendingPlanIds).add(\n          item.promotedFromPlan,\n        );\n      }\n      if (item.promotedFromTask) {\n        (item.status === 'completed' ? completedTaskIds : pendingTaskIds).add(\n          item.promotedFromTask,\n        );\n      }\n    }\n\n    // Mark fully-completed plan items as done\n    for (const planId of completedPlanIds) {\n      if (pendingPlanIds.has(planId)) continue; // not all done yet\n      const planPath = (ctx.meta as Record<string, unknown>)['plan.path'];\n      if (typeof planPath !== 'string' || !planPath) continue;\n      try {\n        const plan = await loadPlan(planPath);\n        if (plan) {\n          const updated = setPlanItemStatus(plan, planId, 'done');\n          await savePlan(planPath, updated);\n        }\n      } catch {\n        /* best-effort */\n      }\n    }\n\n    // Mark fully-completed tasks as completed\n    for (const taskId of completedTaskIds) {\n      if (pendingTaskIds.has(taskId)) continue; // not all done yet\n      const taskPath = (ctx.meta as Record<string, unknown>)['task.path'];\n      if (typeof taskPath !== 'string' || !taskPath) continue;\n      try {\n        const file = await loadTasks(taskPath);\n        if (file) {\n          const task = file.tasks.find((t) => t.id === taskId);\n          if (task && task.status !== 'completed') {\n            task.status = 'completed';\n            task.updatedAt = new Date().toISOString();\n            await saveTasks(taskPath, file);\n          }\n        }\n      } catch {\n        /* best-effort */\n      }\n    }\n\n    return {\n      count: items.length,\n      in_progress: items.filter((t) => t.status === 'in_progress').length,\n    };\n  },\n};\n", "import { type FSWatcher, watch } from 'node:fs';\nimport { basename, dirname } from 'node:path';\nimport type { Context, TodoItem } from '@wrongstack/core/agent';\nimport { GlobalMailbox } from '@wrongstack/core/coordination';\nimport {\n  loadPlan,\n  loadTasks,\n  mutatePlan,\n  mutateTasks,\n  type PlanFile,\n  type PlanItem,\n  type TaskFile,\n} from '@wrongstack/core/storage';\nimport { deserializeTaskGraph } from '@wrongstack/core/tasking';\nimport type { SerializedTaskGraph, TaskStatus } from '@wrongstack/core/types';\nimport { resolveWstackPaths, type TaskItem } from '@wrongstack/core/utils';\nimport {\n  createBoard,\n  getBoard,\n  getKanbanDir,\n  type KanbanBoard,\n  type KanbanColumn,\n  type KanbanTask,\n  listBoards,\n  removeBoard,\n  syncBoardFromTaskGraph,\n  touchKanbanPresence,\n  updateBoard,\n} from '@wrongstack/kanban';\n\nconst SESSION_BOARD_TAG = 'session-work';\nconst MIRROR_DISABLED_ENV = 'WRONGSTACK_KANBAN_TASK_MIRROR';\n\n/** The canonical workflow shared by WebUI and TUI session boards. */\nexport const SESSION_KANBAN_COLUMNS: KanbanColumn[] = [\n  { id: 'todo', title: 'Todo', order: 0, wipLimit: 0, color: '#2563eb' },\n  { id: 'in-progress', title: 'Running', order: 1, wipLimit: 1, color: '#d97706' },\n  { id: 'review', title: 'Preview', order: 2, wipLimit: 0, color: '#7c3aed' },\n  { id: 'done', title: 'Done', order: 3, wipLimit: 0, color: '#16a34a' },\n];\n\nconst boardQueue = new Map<string, Promise<void>>();\nconst boardEnsures = new Map<string, Promise<KanbanBoard>>();\ntype PendingMirror = {\n  projectRoot: string;\n  sessionId: string;\n  graph: SerializedTaskGraph;\n  sourceSystem: 'session-todo' | 'session-task' | 'session-plan';\n};\nconst pendingMirrors = new Map<string, PendingMirror>();\nconst activeMirrors = new Set<string>();\nconst bindings = new WeakMap<Context, () => void>();\nconst suppressedTodoMirrors = new WeakSet<Context>();\nconst activeSessionBoards = new Map<string, number>();\n\nfunction boardKey(projectRoot: string, sessionId: string): string {\n  return `${projectRoot}\\0${sessionId}`;\n}\n\nfunction mirrorKey(\n  projectRoot: string,\n  sessionId: string,\n  sourceSystem: PendingMirror['sourceSystem'],\n): string {\n  return `${boardKey(projectRoot, sessionId)}\\0${sourceSystem}`;\n}\n\nfunction sessionTag(sessionId: string): string {\n  return `session:${sessionId}`;\n}\n\nfunction sessionBoardTitle(sessionId: string): string {\n  const leaf = sessionId.split(/[\\\\/]/).filter(Boolean).pop() ?? sessionId;\n  return `Session ${leaf.slice(0, 12)}`;\n}\n\nfunction sessionBoardTags(sessionId: string): string[] {\n  return ['session', SESSION_BOARD_TAG, sessionTag(sessionId)];\n}\n\nfunction sessionIdFromTags(tags: readonly string[] | undefined): string | null {\n  const tag = tags?.find((candidate) => candidate.startsWith('session:'));\n  return tag?.slice('session:'.length) || null;\n}\n\nfunction isOwnedSessionBoard(tags: readonly string[] | undefined): boolean {\n  return Boolean(tags?.includes(SESSION_BOARD_TAG) && sessionIdFromTags(tags));\n}\n\nfunction retainActiveSessionBoard(projectRoot: string, sessionId: string): void {\n  const key = boardKey(projectRoot, sessionId);\n  activeSessionBoards.set(key, (activeSessionBoards.get(key) ?? 0) + 1);\n}\n\nfunction releaseActiveSessionBoard(projectRoot: string, sessionId: string): void {\n  const key = boardKey(projectRoot, sessionId);\n  const remaining = (activeSessionBoards.get(key) ?? 0) - 1;\n  if (remaining > 0) activeSessionBoards.set(key, remaining);\n  else activeSessionBoards.delete(key);\n}\n\nfunction isSessionBoardActive(projectRoot: string, sessionId: string): boolean {\n  return (activeSessionBoards.get(boardKey(projectRoot, sessionId)) ?? 0) > 0;\n}\n\nfunction sameColumns(columns: readonly KanbanColumn[]): boolean {\n  return (\n    columns.length === SESSION_KANBAN_COLUMNS.length &&\n    columns.every((column, index) => column.id === SESSION_KANBAN_COLUMNS[index]?.id)\n  );\n}\n\n/** Create (or migrate) the single Kanban board owned by a session. */\nexport async function ensureSessionKanbanBoard(\n  projectRoot: string | undefined,\n  sessionId: string,\n): Promise<KanbanBoard | null> {\n  if (!projectRoot || !sessionId || process.env[MIRROR_DISABLED_ENV] === '0') return null;\n  const key = boardKey(projectRoot, sessionId);\n  const inFlight = boardEnsures.get(key);\n  if (inFlight) return inFlight;\n\n  const promise = (async () => {\n    const summary = (await listBoards(projectRoot)).find((board) =>\n      board.tags?.includes(sessionTag(sessionId)),\n    );\n    let board = summary ? await getBoard(projectRoot, summary.id) : null;\n    if (!board) {\n      return createBoard(projectRoot, {\n        title: sessionBoardTitle(sessionId),\n        description: 'Live session work: todos, tasks, and plan items.',\n        tags: sessionBoardTags(sessionId),\n        columns: SESSION_KANBAN_COLUMNS,\n        generatedBy: `session-kanban:${sessionId}`,\n      });\n    }\n\n    // Boards produced by the older task/plan mirrors used the generic five\n    // columns. Migrate only session-owned boards; updateBoard reconciles cards\n    // from Backlog into Todo while preserving Running/Preview/Done cards.\n    if (!sameColumns(board.columns) || !board.tags?.includes(SESSION_BOARD_TAG)) {\n      board =\n        (await updateBoard(projectRoot, board.id, {\n          title: sessionBoardTitle(sessionId),\n          description: 'Live session work: todos, tasks, and plan items.',\n          tags: [...new Set([...(board.tags ?? []), ...sessionBoardTags(sessionId)])],\n          columns: SESSION_KANBAN_COLUMNS,\n        })) ?? board;\n    }\n    return board;\n  })();\n\n  boardEnsures.set(key, promise);\n  try {\n    return await promise;\n  } finally {\n    boardEnsures.delete(key);\n  }\n}\n\nfunction enqueueBoardWork<T>(\n  projectRoot: string,\n  sessionId: string,\n  work: () => Promise<T>,\n): Promise<T> {\n  const key = boardKey(projectRoot, sessionId);\n  const previous = boardQueue.get(key) ?? Promise.resolve();\n  const result = previous.catch(() => undefined).then(work);\n  const tail = result.then(\n    () => undefined,\n    () => undefined,\n  );\n  boardQueue.set(key, tail);\n  void tail.then(() => {\n    if (boardQueue.get(key) === tail) boardQueue.delete(key);\n  });\n  return result;\n}\n\nasync function removeEmptySessionBoard(\n  projectRoot: string,\n  boardId: string,\n  sessionId: string,\n): Promise<string | null> {\n  return enqueueBoardWork(projectRoot, sessionId, async () => {\n    if (isSessionBoardActive(projectRoot, sessionId)) return null;\n    const board = await getBoard(projectRoot, boardId);\n    if (!board || board.tasks.length > 0 || !isOwnedSessionBoard(board.tags)) return null;\n    if (sessionIdFromTags(board.tags) !== sessionId) return null;\n    return (await removeBoard(projectRoot, board.id)) ? board.id : null;\n  });\n}\n\n/** Remove a particular inactive session's system-owned board when it has no cards. */\nexport async function cleanupSessionKanbanBoardIfEmpty(\n  projectRoot: string | undefined,\n  sessionId: string,\n): Promise<string[]> {\n  if (!projectRoot || !sessionId || process.env[MIRROR_DISABLED_ENV] === '0') return [];\n  if (isSessionBoardActive(projectRoot, sessionId)) return [];\n  const candidates = (await listBoards(projectRoot)).filter(\n    (board) =>\n      board.taskCount === 0 &&\n      isOwnedSessionBoard(board.tags) &&\n      sessionIdFromTags(board.tags) === sessionId,\n  );\n  const removed = await Promise.all(\n    candidates.map((board) => removeEmptySessionBoard(projectRoot, board.id, sessionId)),\n  );\n  return removed.filter((boardId): boardId is string => Boolean(boardId));\n}\n\n/** Prune stale empty session boards while preserving manual and live boards. */\nexport async function cleanupEmptySessionKanbanBoards(\n  projectRoot: string | undefined,\n  activeSessionId = '',\n): Promise<string[]> {\n  if (!projectRoot || process.env[MIRROR_DISABLED_ENV] === '0') return [];\n  const candidates = (await listBoards(projectRoot)).flatMap((board) => {\n    const ownerSessionId = sessionIdFromTags(board.tags);\n    return board.taskCount === 0 &&\n      isOwnedSessionBoard(board.tags) &&\n      ownerSessionId &&\n      ownerSessionId !== activeSessionId &&\n      !isSessionBoardActive(projectRoot, ownerSessionId)\n      ? [{ boardId: board.id, sessionId: ownerSessionId }]\n      : [];\n  });\n  const removed = await Promise.all(\n    candidates.map(({ boardId, sessionId }) =>\n      removeEmptySessionBoard(projectRoot, boardId, sessionId),\n    ),\n  );\n  return removed.filter((boardId): boardId is string => Boolean(boardId));\n}\n\nasync function projectGraph(\n  projectRoot: string | undefined,\n  sessionId: string,\n  graph: SerializedTaskGraph,\n  sourceSystem: 'session-todo' | 'session-task' | 'session-plan',\n): Promise<KanbanBoard | null> {\n  if (!projectRoot || !sessionId || process.env[MIRROR_DISABLED_ENV] === '0') return null;\n  return enqueueBoardWork(projectRoot, sessionId, async () => {\n    const board = await ensureSessionKanbanBoard(projectRoot, sessionId);\n    if (!board) return null;\n    const result = await syncBoardFromTaskGraph(\n      projectRoot,\n      board.id,\n      deserializeTaskGraph(graph),\n      {\n        sourceSystem,\n        tags: [...new Set([...(board.tags ?? []), ...sessionBoardTags(sessionId)])],\n        archiveMissingTasks: true,\n        includeCompletedTasks: true,\n      },\n    );\n    return result?.board ?? null;\n  });\n}\n\n/**\n * Queue an observational mirror without retaining every intermediate state.\n * Todo/task/plan streams are independent, but within each stream only the\n * newest pending graph matters. This bounds a stalled file lock to one active\n * and one pending projection instead of an arbitrarily long Promise chain.\n */\nfunction queueLatestMirror(\n  projectRoot: string | undefined,\n  sessionId: string,\n  graph: SerializedTaskGraph,\n  sourceSystem: PendingMirror['sourceSystem'],\n): void {\n  if (!projectRoot || !sessionId || process.env[MIRROR_DISABLED_ENV] === '0') return;\n  const key = mirrorKey(projectRoot, sessionId, sourceSystem);\n  pendingMirrors.set(key, { projectRoot, sessionId, graph, sourceSystem });\n  if (activeMirrors.has(key)) return;\n  activeMirrors.add(key);\n  void (async () => {\n    try {\n      for (;;) {\n        const pending = pendingMirrors.get(key);\n        if (!pending) break;\n        pendingMirrors.delete(key);\n        try {\n          await projectGraph(\n            pending.projectRoot,\n            pending.sessionId,\n            pending.graph,\n            pending.sourceSystem,\n          );\n        } catch {\n          // Mirrors are observational. A newer pending snapshot, if present,\n          // still gets a chance after a transient lock or filesystem failure.\n        }\n      }\n    } finally {\n      activeMirrors.delete(key);\n      // A mirror can arrive between the last Map read and deleting the active\n      // marker. Re-arm once so that snapshot cannot be stranded.\n      const pending = pendingMirrors.get(key);\n      if (pending) {\n        pendingMirrors.delete(key);\n        queueLatestMirror(\n          pending.projectRoot,\n          pending.sessionId,\n          pending.graph,\n          pending.sourceSystem,\n        );\n      }\n    }\n  })();\n}\n\nexport function todoListToSerializedGraph(\n  todos: readonly TodoItem[],\n  sessionId: string,\n): SerializedTaskGraph {\n  const nodes = todos.map((todo, index) => ({\n    id: todo.id,\n    title: todo.content,\n    description: todo.activeForm ?? '',\n    type: 'chore' as const,\n    priority: 'medium' as const,\n    status: todo.status,\n    createdAt: index,\n    updatedAt: index,\n  }));\n  return {\n    id: `todo:${sessionId}`,\n    specId: `todo:${sessionId}`,\n    title: 'Session todos',\n    nodes,\n    edges: [],\n    rootNodes: nodes.map((node) => node.id),\n    createdAt: 0,\n    updatedAt: 0,\n  };\n}\n\nexport function taskFileToSerializedGraph(\n  tasks: readonly TaskItem[],\n  sessionId: string,\n): SerializedTaskGraph {\n  const ids = new Set(tasks.map((task) => task.id));\n  const nodes = tasks.map((task, index) => ({\n    id: task.id,\n    title: task.title,\n    description: task.description ?? '',\n    type: task.type,\n    priority: task.priority,\n    status: task.status,\n    ...(task.assignee ? { assignee: task.assignee } : {}),\n    ...(task.estimateHours !== undefined ? { estimateHours: task.estimateHours } : {}),\n    createdAt: index,\n    updatedAt: index,\n  }));\n  const edges = tasks.flatMap((task) =>\n    (task.dependsOn ?? [])\n      .filter((dependency) => ids.has(dependency))\n      .map((dependency) => ({\n        id: `${dependency}->${task.id}`,\n        from: dependency,\n        to: task.id,\n        type: 'depends_on' as const,\n      })),\n  );\n  const hasIncoming = new Set(edges.map((edge) => edge.to));\n  const rootNodes = nodes.filter((node) => !hasIncoming.has(node.id)).map((node) => node.id);\n  return {\n    // Keep the historical graph id so existing mirrored task cards are reused.\n    id: `session:${sessionId}`,\n    specId: `session:${sessionId}`,\n    title: 'Session tasks',\n    nodes,\n    edges,\n    rootNodes: rootNodes.length ? rootNodes : nodes[0] ? [nodes[0].id] : [],\n    createdAt: 0,\n    updatedAt: 0,\n  };\n}\n\nconst PLAN_STATUS_TO_TASK: Record<PlanItem['status'], TaskStatus> = {\n  open: 'pending',\n  in_progress: 'in_progress',\n  done: 'completed',\n};\n\nexport function planFileToSerializedGraph(\n  items: readonly PlanItem[],\n  sessionId: string,\n): SerializedTaskGraph {\n  const nodes = items.map((item, index) => ({\n    id: item.id,\n    title: item.title,\n    description: item.details ?? '',\n    type: 'chore' as const,\n    priority: 'medium' as const,\n    status: PLAN_STATUS_TO_TASK[item.status],\n    createdAt: index,\n    updatedAt: index,\n  }));\n  return {\n    id: `plan:${sessionId}`,\n    specId: `plan:${sessionId}`,\n    title: 'Session plan',\n    nodes,\n    edges: [],\n    rootNodes: nodes.map((node) => node.id),\n    createdAt: 0,\n    updatedAt: 0,\n  };\n}\n\nexport function projectSessionTodosToKanban(\n  projectRoot: string | undefined,\n  todos: readonly TodoItem[],\n  sessionId: string,\n): Promise<KanbanBoard | null> {\n  return projectGraph(\n    projectRoot,\n    sessionId,\n    todoListToSerializedGraph(todos, sessionId),\n    'session-todo',\n  );\n}\n\nexport function projectSessionTasksToKanban(\n  projectRoot: string | undefined,\n  tasks: readonly TaskItem[],\n  sessionId: string,\n): Promise<KanbanBoard | null> {\n  return projectGraph(\n    projectRoot,\n    sessionId,\n    taskFileToSerializedGraph(tasks, sessionId),\n    'session-task',\n  );\n}\n\nexport function projectSessionPlanToKanban(\n  projectRoot: string | undefined,\n  items: readonly PlanItem[],\n  sessionId: string,\n): Promise<KanbanBoard | null> {\n  return projectGraph(\n    projectRoot,\n    sessionId,\n    planFileToSerializedGraph(items, sessionId),\n    'session-plan',\n  );\n}\n\nfunction fireAndForget(context: string, work: Promise<unknown>): void {\n  void work.catch((err: unknown) => {\n    const message = err instanceof Error ? err.message : String(err);\n    console.warn(JSON.stringify({ level: 'warn', event: 'session-kanban', context, message, timestamp: new Date().toISOString() }));\n  });\n}\n\nfunction broadcastTodoUpdate(context: Context, todos: readonly TodoItem[]): void {\n  const sessionId = context.session?.id ?? '';\n  if (!context.agentId || !sessionId) return;\n  const projectDir = resolveWstackPaths({ projectRoot: context.projectRoot }).projectDir;\n  const mailbox = new GlobalMailbox(projectDir);\n  void mailbox\n    .send({\n      from: context.agentId,\n      to: '*',\n      type: 'status',\n      subject: `Kanban todo list updated (${todos.length} item${todos.length === 1 ? '' : 's'})`,\n      body: JSON.stringify({\n        kind: 'kanban.todos.updated',\n        sessionId,\n        revision: context.state.revision,\n        todos,\n      }),\n      priority: 'normal',\n      senderSessionId: sessionId,\n      ttlMs: 6 * 60 * 60 * 1000,\n    })\n    .catch(() => {\n      // Mailbox awareness is best-effort; canonical state is already updated.\n    });\n}\n\nfunction notifyTodoUpdate(context: Context, todos: readonly TodoItem[]): void {\n  const summary = todos.length\n    ? todos.map((todo) => `- [${todo.status}] ${todo.content} (${todo.id})`).join('\\n')\n    : '- No active todos remain.';\n  const text = `[KANBAN TODO UPDATE]\\nAnother Kanban agent reassessed the shared board. The canonical todo list is now:\\n${summary}\\nReassess your current plan before continuing; do not rely on the initial todo snapshot.`;\n  const state = context.state as Partial<Context['state']>;\n  if (typeof state.appendBlockToLastUserMessage === 'function') {\n    if (state.appendBlockToLastUserMessage({ type: 'text', text })) return;\n  }\n  if (typeof state.appendMessage === 'function') {\n    state.appendMessage({ role: 'user', content: [{ type: 'text', text }] });\n  }\n}\n\nexport function mirrorSessionTodosToKanban(\n  projectRoot: string | undefined,\n  todos: readonly TodoItem[],\n  sessionId: string,\n): void {\n  queueLatestMirror(\n    projectRoot,\n    sessionId,\n    todoListToSerializedGraph(todos, sessionId),\n    'session-todo',\n  );\n}\n\nexport function mirrorSessionTasksToKanban(\n  projectRoot: string | undefined,\n  tasks: readonly TaskItem[],\n  sessionId: string,\n): void {\n  queueLatestMirror(\n    projectRoot,\n    sessionId,\n    taskFileToSerializedGraph(tasks, sessionId),\n    'session-task',\n  );\n}\n\nexport function mirrorSessionPlanToKanban(\n  projectRoot: string | undefined,\n  items: readonly PlanItem[],\n  sessionId: string,\n): void {\n  queueLatestMirror(\n    projectRoot,\n    sessionId,\n    planFileToSerializedGraph(items, sessionId),\n    'session-plan',\n  );\n}\n\n/**\n * Bind all live session work paths to Kanban. Todo changes are observed from\n * ConversationState; plan/task sidecars are watched so slash commands, WebUI,\n * plugins, and tools all pass through the same board.\n */\nexport function attachSessionKanbanMirror(context: Context): () => void {\n  const existing = bindings.get(context);\n  if (existing) return existing;\n\n  const attachedProjectRoot = context.projectRoot ?? '';\n  let registeredSessionId = '';\n  const syncActiveSessionRegistration = () => {\n    if (!attachedProjectRoot) return;\n    const currentSessionId = context.session?.id ?? '';\n    if (currentSessionId === registeredSessionId) return;\n    if (registeredSessionId) {\n      releaseActiveSessionBoard(attachedProjectRoot, registeredSessionId);\n      fireAndForget(\n        'cleanup-board',\n        cleanupSessionKanbanBoardIfEmpty(attachedProjectRoot, registeredSessionId),\n      );\n    }\n    registeredSessionId = currentSessionId;\n    if (registeredSessionId) {\n      retainActiveSessionBoard(attachedProjectRoot, registeredSessionId);\n    }\n  };\n  syncActiveSessionRegistration();\n\n  let watcher: FSWatcher | null = null;\n  let watchedDir = '';\n  let timer: NodeJS.Timeout | null = null;\n  let boardWatcher: FSWatcher | null = null;\n  let watchedBoardId = '';\n  let boardTimer: NodeJS.Timeout | null = null;\n  let presenceTimer: NodeJS.Timeout | null = null;\n\n  const sessionId = () => context.session?.id ?? '';\n  const refreshFiles = async () => {\n    const id = sessionId();\n    if (!id) return;\n    const planPath = context.meta['plan.path'];\n    if (typeof planPath === 'string' && planPath) {\n      const plan = await loadPlan(planPath);\n      if (plan) await projectSessionPlanToKanban(context.projectRoot, plan.items, id);\n    }\n    const taskPath = context.meta['task.path'];\n    if (typeof taskPath === 'string' && taskPath) {\n      const tasks = await loadTasks(taskPath);\n      if (tasks) await projectSessionTasksToKanban(context.projectRoot, tasks.tasks, id);\n    }\n  };\n\n  const refreshBoard = async () => {\n    if (!watchedBoardId) return;\n    const board = await getBoard(context.projectRoot, watchedBoardId);\n    if (board) applySessionKanbanBoardToTodos(context, board);\n  };\n\n  const configureBoardWatcher = async () => {\n    const id = sessionId();\n    const board = id ? await ensureSessionKanbanBoard(context.projectRoot, id) : null;\n    if (!board || board.id === watchedBoardId) return;\n    boardWatcher?.close();\n    boardWatcher = null;\n    watchedBoardId = board.id;\n    try {\n      const boardFileName = `${board.id}.json`;\n      boardWatcher = watch(\n        getKanbanDir(context.projectRoot),\n        { persistent: false },\n        (_event, filename) => {\n          if (filename?.toString() !== boardFileName) return;\n          if (boardTimer) clearTimeout(boardTimer);\n          boardTimer = setTimeout(() => fireAndForget('refresh-board', refreshBoard()), 60);\n        },\n      );\n      const touchPresence = () =>\n        touchKanbanPresence(context.projectRoot, board.id, {\n          sessionId: id,\n          agentId: context.agentId,\n          agentName: context.agentName,\n        });\n      fireAndForget('touch-presence', touchPresence());\n      if (presenceTimer) clearInterval(presenceTimer);\n      presenceTimer = setInterval(() => fireAndForget('touch-presence', touchPresence()), 60_000);\n      presenceTimer.unref?.();\n      boardWatcher.on('error', () => {\n        boardWatcher?.close();\n        boardWatcher = null;\n        watchedBoardId = '';\n      });\n    } catch {\n      boardWatcher = null;\n      watchedBoardId = '';\n    }\n  };\n\n  const configureWatcher = () => {\n    const planPath = context.meta['plan.path'];\n    const taskPath = context.meta['task.path'];\n    const candidate =\n      typeof planPath === 'string' && planPath\n        ? dirname(planPath)\n        : typeof taskPath === 'string' && taskPath\n          ? dirname(taskPath)\n          : '';\n    if (!candidate || candidate === watchedDir) return;\n    watcher?.close();\n    watcher = null;\n    watchedDir = candidate;\n    try {\n      watcher = watch(candidate, { persistent: false }, (_event, filename) => {\n        const name = filename?.toString();\n        const currentPlanPath = context.meta['plan.path'];\n        const currentTaskPath = context.meta['task.path'];\n        const planName = typeof currentPlanPath === 'string' ? basename(currentPlanPath) : '';\n        const taskName = typeof currentTaskPath === 'string' ? basename(currentTaskPath) : '';\n        if (name && name !== planName && name !== taskName) return;\n        if (timer) clearTimeout(timer);\n        timer = setTimeout(() => fireAndForget('refresh-files', refreshFiles()), 60);\n      });\n      watcher.on('error', () => watcher?.close());\n    } catch {\n      // The session directory can briefly disappear during project/session\n      // switches; the next meta update re-attempts the binding.\n      watcher = null;\n      watchedDir = '';\n    }\n  };\n\n  const unsubscribe = context.state.onChange((change) => {\n    if (change.kind === 'todos_replaced' && !suppressedTodoMirrors.has(context)) {\n      // ConversationState auto-clears an all-done tactical list. Project the\n      // pre-clear completion snapshot so every card reaches Done atomically.\n      mirrorSessionTodosToKanban(\n        context.projectRoot,\n        change.completedSnapshot ?? change.todos,\n        sessionId(),\n      );\n      return;\n    }\n    if (change.kind === 'meta_set' && (change.key === 'plan.path' || change.key === 'task.path')) {\n      syncActiveSessionRegistration();\n      configureWatcher();\n      fireAndForget('ensure-board', ensureSessionKanbanBoard(context.projectRoot, sessionId()));\n      fireAndForget('configure-watcher', configureBoardWatcher());\n      fireAndForget('refresh-files', refreshFiles());\n    }\n  });\n\n  configureWatcher();\n  fireAndForget('configure-watcher', configureBoardWatcher());\n\n  const detach = () => {\n    unsubscribe();\n    if (timer) clearTimeout(timer);\n    if (boardTimer) clearTimeout(boardTimer);\n    if (presenceTimer) clearInterval(presenceTimer);\n    watcher?.close();\n    boardWatcher?.close();\n    bindings.delete(context);\n    if (attachedProjectRoot && registeredSessionId) {\n      releaseActiveSessionBoard(attachedProjectRoot, registeredSessionId);\n      fireAndForget(\n        'cleanup-board',\n        cleanupSessionKanbanBoardIfEmpty(attachedProjectRoot, registeredSessionId),\n      );\n      registeredSessionId = '';\n    }\n  };\n  bindings.set(context, detach);\n  return detach;\n}\n\n/** Fully hydrate a session board before a host announces the session as ready. */\nexport async function hydrateSessionKanban(context: Context): Promise<KanbanBoard | null> {\n  const id = context.session?.id ?? '';\n  if (!id) return null;\n  await cleanupEmptySessionKanbanBoards(context.projectRoot, id);\n  let board = await ensureSessionKanbanBoard(context.projectRoot, id);\n  if (context.todos.length) {\n    board = await projectSessionTodosToKanban(context.projectRoot, context.todos, id);\n  }\n  const planPath = context.meta['plan.path'];\n  if (typeof planPath === 'string' && planPath) {\n    const plan = await loadPlan(planPath);\n    if (plan) board = await projectSessionPlanToKanban(context.projectRoot, plan.items, id);\n  }\n  const taskPath = context.meta['task.path'];\n  if (typeof taskPath === 'string' && taskPath) {\n    const tasks = await loadTasks(taskPath);\n    if (tasks) board = await projectSessionTasksToKanban(context.projectRoot, tasks.tasks, id);\n  }\n  return board;\n}\n\nexport interface SessionKanbanSourceUpdate {\n  source: 'todo' | 'task' | 'plan' | null;\n  todos?: TodoItem[] | undefined;\n  tasks?: TaskFile | undefined;\n  plan?: PlanFile | undefined;\n}\n\nfunction sourceStatus(task: KanbanTask): TaskStatus {\n  if (task.status === 'completed') return 'completed';\n  if (task.status === 'in_progress') return 'in_progress';\n  if (task.status === 'review') return 'review';\n  if (task.status === 'blocked') return 'blocked';\n  if (task.status === 'failed') return 'failed';\n  return 'pending';\n}\n\nfunction todoStatus(task: KanbanTask): TodoItem['status'] {\n  const status = sourceStatus(task);\n  if (status === 'completed') return 'completed';\n  if (status === 'in_progress' || status === 'review') return 'in_progress';\n  return 'pending';\n}\n\nfunction sessionTodoFromTask(task: KanbanTask): TodoItem {\n  return {\n    id: task.origin?.taskId ?? task.id,\n    content: task.title,\n    status: todoStatus(task),\n    ...(task.description ? { activeForm: task.description } : {}),\n  };\n}\n\nfunction sameTodos(left: readonly TodoItem[], right: readonly TodoItem[]): boolean {\n  return (\n    left.length === right.length &&\n    left.every((todo, index) => {\n      const candidate = right[index];\n      return (\n        candidate?.id === todo.id &&\n        candidate.content === todo.content &&\n        candidate.status === todo.status &&\n        candidate.activeForm === todo.activeForm &&\n        candidate.promotedFromPlan === todo.promotedFromPlan &&\n        candidate.promotedFromTask === todo.promotedFromTask\n      );\n    })\n  );\n}\n\n/**\n * Replace the tactical todo list from the current cards on a session-owned board.\n *\n * Existing mirrored todo cards retain their stable source ids. New cards created\n * by a Kanban worker become todos under their card ids, so reassessment can add,\n * split, merge, reprioritize, or remove work without being overwritten by the\n * todo list that happened to exist when the run started.\n */\nexport function applySessionKanbanBoardToTodos(context: Context, board: KanbanBoard): TodoItem[] {\n  const sessionId = context.session?.id ?? '';\n  if (\n    !sessionId ||\n    sessionIdFromTags(board.tags) !== sessionId ||\n    !isOwnedSessionBoard(board.tags)\n  ) {\n    return [...context.todos];\n  }\n\n  const projectedTodos = board.tasks\n    .filter(\n      (task) =>\n        task.status !== 'archived' &&\n        (!task.origin ||\n          task.origin.system === 'session-todo' ||\n          (task.origin.graphId ?? '').startsWith('todo:')),\n    )\n    .sort((left, right) => {\n      const leftColumn = board.columns.find((column) => column.id === left.columnId)?.order ?? 0;\n      const rightColumn = board.columns.find((column) => column.id === right.columnId)?.order ?? 0;\n      return (\n        leftColumn - rightColumn ||\n        left.order - right.order ||\n        left.createdAt.localeCompare(right.createdAt)\n      );\n    })\n    .map(sessionTodoFromTask);\n\n  const allCompleted =\n    projectedTodos.length > 0 && projectedTodos.every((todo) => todo.status === 'completed');\n  const effectiveTodos = allCompleted ? [] : projectedTodos;\n  if (sameTodos(context.todos, effectiveTodos)) return [...context.todos];\n  suppressedTodoMirrors.add(context);\n  try {\n    context.state.replaceTodos(projectedTodos);\n  } finally {\n    suppressedTodoMirrors.delete(context);\n  }\n  notifyTodoUpdate(context, context.todos);\n  broadcastTodoUpdate(context, context.todos);\n  return [...context.todos];\n}\n\n/** Reflect a TUI/WebUI Kanban card edit back to its originating work list. */\nexport async function applySessionKanbanTaskToSource(\n  context: Context,\n  task: KanbanTask,\n  options: { remove?: boolean | undefined } = {},\n): Promise<SessionKanbanSourceUpdate> {\n  const originId = task.origin?.taskId;\n  const graphId = task.origin?.graphId ?? '';\n  if (!originId) return { source: null };\n\n  if (task.origin?.system === 'session-todo' || graphId.startsWith('todo:')) {\n    const next = options.remove\n      ? context.todos.filter((todo) => todo.id !== originId)\n      : context.todos.map((todo) =>\n          todo.id === originId\n            ? {\n                ...todo,\n                content: task.title,\n                status:\n                  sourceStatus(task) === 'completed'\n                    ? ('completed' as const)\n                    : sourceStatus(task) === 'in_progress' || sourceStatus(task) === 'review'\n                      ? ('in_progress' as const)\n                      : ('pending' as const),\n              }\n            : todo,\n        );\n    suppressedTodoMirrors.add(context);\n    try {\n      context.state.replaceTodos(next);\n    } finally {\n      suppressedTodoMirrors.delete(context);\n    }\n    return { source: 'todo', todos: [...context.todos] };\n  }\n\n  const id = context.session?.id ?? '';\n  if (task.origin?.system === 'session-plan' || graphId.startsWith('plan:')) {\n    const planPath = context.meta['plan.path'];\n    if (typeof planPath !== 'string' || !planPath) return { source: 'plan' };\n    const plan = await mutatePlan(planPath, id, (file) => ({\n      ...file,\n      updatedAt: new Date().toISOString(),\n      items: options.remove\n        ? file.items.filter((item) => item.id !== originId)\n        : file.items.map((item) =>\n            item.id === originId\n              ? {\n                  ...item,\n                  title: task.title,\n                  details: task.description,\n                  status:\n                    task.status === 'completed'\n                      ? ('done' as const)\n                      : task.status === 'in_progress' || task.status === 'review'\n                        ? ('in_progress' as const)\n                        : ('open' as const),\n                  updatedAt: new Date().toISOString(),\n                }\n              : item,\n          ),\n    }));\n    return { source: 'plan', plan };\n  }\n\n  if (\n    task.origin?.system === 'session-task' ||\n    task.origin?.system === 'session' ||\n    graphId.startsWith('session:')\n  ) {\n    const taskPath = context.meta['task.path'];\n    if (typeof taskPath !== 'string' || !taskPath) return { source: 'task' };\n    const tasks = await mutateTasks(taskPath, id, (file) => ({\n      ...file,\n      tasks: options.remove\n        ? file.tasks.filter((item) => item.id !== originId)\n        : file.tasks.map((item) =>\n            item.id === originId\n              ? {\n                  ...item,\n                  title: task.title,\n                  description: task.description,\n                  status: sourceStatus(task),\n                  updatedAt: new Date().toISOString(),\n                }\n              : item,\n          ),\n    }));\n    return { source: 'task', tasks };\n  }\n\n  return { source: null };\n}\n"],
+  "mappings": "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",
   "names": ["loadPlan", "loadTasks", "board", "loadPlan", "loadTasks"]
 }

package/dist/tool-help.d.ts

@@ -1,4 +1,4 @@
-import type { Tool } from '@wrongstack/core';
+import type { Tool } from '@wrongstack/core/types';
 interface ToolHelpInput {
     tool?: string | undefined;
     format?: 'short' | 'full' | 'markdown' | undefined;

package/dist/tool-help.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tool-help.d.ts","sourceRoot":"","sources":["../src/tool-help.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAE7C,UAAU,aAAa;IACrB,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,MAAM,CAAC,EAAE,OAAO,GAAG,MAAM,GAAG,UAAU,GAAG,SAAS,CAAC;IACnD,gBAAgB,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;CACxC;AAED,UAAU,cAAc;IACtB,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE;QACL,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,EAAE,MAAM,CAAC;QACpB,SAAS,EAAE,MAAM,CAAC;QAClB,WAAW,EAAE,OAAO,CAAC;QACrB,UAAU,EAAE,MAAM,CAAC;QACnB,QAAQ,EAAE,OAAO,CAAC;KACnB,EAAE,CAAC;IACJ,KAAK,EAAE,MAAM,CAAC;CACf;AAED,eAAO,MAAM,YAAY,EAAE,IAAI,CAAC,aAAa,EAAE,cAAc,CAoF5D,CAAC"}
+{"version":3,"file":"tool-help.d.ts","sourceRoot":"","sources":["../src/tool-help.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,wBAAwB,CAAC;AAEnD,UAAU,aAAa;IACrB,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,MAAM,CAAC,EAAE,OAAO,GAAG,MAAM,GAAG,UAAU,GAAG,SAAS,CAAC;IACnD,gBAAgB,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;CACxC;AAED,UAAU,cAAc;IACtB,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE;QACL,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,EAAE,MAAM,CAAC;QACpB,SAAS,EAAE,MAAM,CAAC;QAClB,WAAW,EAAE,OAAO,CAAC;QACrB,UAAU,EAAE,MAAM,CAAC;QACnB,QAAQ,EAAE,OAAO,CAAC;KACnB,EAAE,CAAC;IACJ,KAAK,EAAE,MAAM,CAAC;CACf;AAED,eAAO,MAAM,YAAY,EAAE,IAAI,CAAC,aAAa,EAAE,cAAc,CAoF5D,CAAC"}

package/dist/tool-help.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../src/tool-help.ts"],
-  "sourcesContent": ["import type { Tool } from '@wrongstack/core';\n\ninterface ToolHelpInput {\n  tool?: string | undefined;\n  format?: 'short' | 'full' | 'markdown' | undefined;\n  include_examples?: boolean | undefined;\n}\n\ninterface ToolHelpOutput {\n  tool?: string | undefined;\n  help: string;\n  tools: {\n    name: string;\n    description: string;\n    usageHint: string;\n    inputSchema: unknown;\n    permission: string;\n    mutating: boolean;\n  }[];\n  total: number;\n}\n\nexport const toolHelpTool: Tool<ToolHelpInput, ToolHelpOutput> = {\n  name: 'tool_help',\n  category: 'Meta',\n  description:\n    'Get detailed help for a specific tool, including its full input schema and usage guidance. ' +\n    'If you do not know which tool to use, search with `tool_search` first, then call this with the tool name.',\n  usageHint:\n    'USE WHEN YOU NEED PRECISE TOOL INFORMATION:\\n\\n' +\n    '- Call with a specific `tool` name when you want the full schema and current usageHint.\\n' +\n    '- Omit `tool` to get an overview of all available tools.\\n' +\n    '- Different `format` options give you different levels of detail.\\n' +\n    '- Tip: use `tool_search` to find the right tool name, then `tool_help` for the full schema.\\n' +\n    'This tool is extremely valuable for self-correction when you are unsure about a tool\\'s interface.',\n  permission: 'auto',\n  mutating: false,\n  timeoutMs: 5_000,\n  capabilities: ['tool.meta'],\n  icon: 'meta',\n  inputSchema: {\n    type: 'object',\n    properties: {\n      tool: {\n        type: 'string',\n        description: 'Specific tool name to get detailed help for. Omit to get a list of all tools.',\n      },\n      format: {\n        type: 'string',\n        enum: ['short', 'full', 'markdown'],\n        description: 'Level of detail: \"short\" (summary), \"full\" (with full schema), \"markdown\" (human readable).',\n      },\n      include_examples: {\n        type: 'boolean',\n        description: 'Whether to include example usage in the response.',\n      },\n    },\n  },\n  async execute(input, ctx) {\n    const format = input.format ?? 'short';\n    const includeExamples = input.include_examples ?? false;\n\n    if (input.tool) {\n      const tool = ctx.tools.find((t: Tool) => t.name === input.tool);\n      if (!tool) {\n        return {\n          tool: input.tool,\n          help: `No tool found with name \"${input.tool}\"`,\n          tools: [],\n          total: 0,\n        };\n      }\n\n      return {\n        tool: tool.name,\n        help: formatToolHelp(tool, format, includeExamples),\n        tools: [\n          {\n            name: tool.name,\n            description: tool.description,\n            usageHint: tool.usageHint ?? '',\n            inputSchema: tool.inputSchema,\n            permission: tool.permission,\n            mutating: tool.mutating,\n          },\n        ],\n        total: 1,\n      };\n    }\n\n    const allTools = ctx.tools.map((t: Tool) => ({\n      name: t.name,\n      description: t.description,\n      usageHint: t.usageHint ?? '',\n      inputSchema: format === 'full' ? t.inputSchema : undefined,\n      permission: t.permission,\n      mutating: t.mutating,\n    }));\n\n    return {\n      help:\n        format === 'markdown' ? formatAllToolsMarkdown(allTools) : formatAllToolsShort(allTools),\n      tools: allTools,\n      total: allTools.length,\n    };\n  },\n};\n\nfunction formatToolHelp(tool: Tool, format: string, includeExamples: boolean): string {\n  const lines: string[] = [];\n\n  if (format === 'short') {\n    lines.push(`${tool.name}: ${tool.description}`);\n    if (tool.usageHint) lines.push(`Hint: ${tool.usageHint}`);\n    return lines.join('\\n');\n  }\n\n  if (format === 'markdown') {\n    lines.push(`## ${tool.name}`);\n    lines.push('');\n    lines.push(tool.description);\n    lines.push('');\n    lines.push('**Permission:** ' + tool.permission);\n    lines.push('**Mutating:** ' + (tool.mutating ? 'yes' : 'no'));\n    if (tool.usageHint) {\n      lines.push('');\n      lines.push('### Usage Hint');\n      lines.push(tool.usageHint);\n    }\n    if (includeExamples && tool.inputSchema) {\n      lines.push('');\n      lines.push('### Input Schema');\n      lines.push('```json');\n      lines.push(JSON.stringify(tool.inputSchema, null, 2));\n      lines.push('```');\n    }\n    return lines.join('\\n');\n  }\n\n  lines.push(`Tool: ${tool.name}`);\n  lines.push(`Description: ${tool.description}`);\n  lines.push(`Permission: ${tool.permission}`);\n  lines.push(`Mutating: ${tool.mutating}`);\n  if (tool.usageHint) lines.push(`Usage: ${tool.usageHint}`);\n  if (format === 'full' && tool.inputSchema) {\n    lines.push('Schema: ' + JSON.stringify(tool.inputSchema, null, 2));\n  }\n  return lines.join('\\n');\n}\n\nfunction formatAllToolsShort(tools: { name: string; description: string }[]): string {\n  return tools.map((t) => `  ${t.name.padEnd(16)} ${t.description}`).join('\\n');\n}\n\nfunction formatAllToolsMarkdown(\n  tools: { name: string; description: string; usageHint: string }[],\n): string {\n  const lines: string[] = ['## Available Tools', ''];\n  lines.push('| Tool | Description |');\n  lines.push('|------|-------------|');\n  for (const t of tools) {\n    lines.push(`| \\`${t.name}\\` | ${t.description} |`);\n  }\n  return lines.join('\\n');\n}\n"],
+  "sourcesContent": ["import type { Tool } from '@wrongstack/core/types';\n\ninterface ToolHelpInput {\n  tool?: string | undefined;\n  format?: 'short' | 'full' | 'markdown' | undefined;\n  include_examples?: boolean | undefined;\n}\n\ninterface ToolHelpOutput {\n  tool?: string | undefined;\n  help: string;\n  tools: {\n    name: string;\n    description: string;\n    usageHint: string;\n    inputSchema: unknown;\n    permission: string;\n    mutating: boolean;\n  }[];\n  total: number;\n}\n\nexport const toolHelpTool: Tool<ToolHelpInput, ToolHelpOutput> = {\n  name: 'tool_help',\n  category: 'Meta',\n  description:\n    'Get detailed help for a specific tool, including its full input schema and usage guidance. ' +\n    'If you do not know which tool to use, search with `tool_search` first, then call this with the tool name.',\n  usageHint:\n    'USE WHEN YOU NEED PRECISE TOOL INFORMATION:\\n\\n' +\n    '- Call with a specific `tool` name when you want the full schema and current usageHint.\\n' +\n    '- Omit `tool` to get an overview of all available tools.\\n' +\n    '- Different `format` options give you different levels of detail.\\n' +\n    '- Tip: use `tool_search` to find the right tool name, then `tool_help` for the full schema.\\n' +\n    'This tool is extremely valuable for self-correction when you are unsure about a tool\\'s interface.',\n  permission: 'auto',\n  mutating: false,\n  timeoutMs: 5_000,\n  capabilities: ['tool.meta'],\n  icon: 'meta',\n  inputSchema: {\n    type: 'object',\n    properties: {\n      tool: {\n        type: 'string',\n        description: 'Specific tool name to get detailed help for. Omit to get a list of all tools.',\n      },\n      format: {\n        type: 'string',\n        enum: ['short', 'full', 'markdown'],\n        description: 'Level of detail: \"short\" (summary), \"full\" (with full schema), \"markdown\" (human readable).',\n      },\n      include_examples: {\n        type: 'boolean',\n        description: 'Whether to include example usage in the response.',\n      },\n    },\n  },\n  async execute(input, ctx) {\n    const format = input.format ?? 'short';\n    const includeExamples = input.include_examples ?? false;\n\n    if (input.tool) {\n      const tool = ctx.tools.find((t: Tool) => t.name === input.tool);\n      if (!tool) {\n        return {\n          tool: input.tool,\n          help: `No tool found with name \"${input.tool}\"`,\n          tools: [],\n          total: 0,\n        };\n      }\n\n      return {\n        tool: tool.name,\n        help: formatToolHelp(tool, format, includeExamples),\n        tools: [\n          {\n            name: tool.name,\n            description: tool.description,\n            usageHint: tool.usageHint ?? '',\n            inputSchema: tool.inputSchema,\n            permission: tool.permission,\n            mutating: tool.mutating,\n          },\n        ],\n        total: 1,\n      };\n    }\n\n    const allTools = ctx.tools.map((t: Tool) => ({\n      name: t.name,\n      description: t.description,\n      usageHint: t.usageHint ?? '',\n      inputSchema: format === 'full' ? t.inputSchema : undefined,\n      permission: t.permission,\n      mutating: t.mutating,\n    }));\n\n    return {\n      help:\n        format === 'markdown' ? formatAllToolsMarkdown(allTools) : formatAllToolsShort(allTools),\n      tools: allTools,\n      total: allTools.length,\n    };\n  },\n};\n\nfunction formatToolHelp(tool: Tool, format: string, includeExamples: boolean): string {\n  const lines: string[] = [];\n\n  if (format === 'short') {\n    lines.push(`${tool.name}: ${tool.description}`);\n    if (tool.usageHint) lines.push(`Hint: ${tool.usageHint}`);\n    return lines.join('\\n');\n  }\n\n  if (format === 'markdown') {\n    lines.push(`## ${tool.name}`);\n    lines.push('');\n    lines.push(tool.description);\n    lines.push('');\n    lines.push('**Permission:** ' + tool.permission);\n    lines.push('**Mutating:** ' + (tool.mutating ? 'yes' : 'no'));\n    if (tool.usageHint) {\n      lines.push('');\n      lines.push('### Usage Hint');\n      lines.push(tool.usageHint);\n    }\n    if (includeExamples && tool.inputSchema) {\n      lines.push('');\n      lines.push('### Input Schema');\n      lines.push('```json');\n      lines.push(JSON.stringify(tool.inputSchema, null, 2));\n      lines.push('```');\n    }\n    return lines.join('\\n');\n  }\n\n  lines.push(`Tool: ${tool.name}`);\n  lines.push(`Description: ${tool.description}`);\n  lines.push(`Permission: ${tool.permission}`);\n  lines.push(`Mutating: ${tool.mutating}`);\n  if (tool.usageHint) lines.push(`Usage: ${tool.usageHint}`);\n  if (format === 'full' && tool.inputSchema) {\n    lines.push('Schema: ' + JSON.stringify(tool.inputSchema, null, 2));\n  }\n  return lines.join('\\n');\n}\n\nfunction formatAllToolsShort(tools: { name: string; description: string }[]): string {\n  return tools.map((t) => `  ${t.name.padEnd(16)} ${t.description}`).join('\\n');\n}\n\nfunction formatAllToolsMarkdown(\n  tools: { name: string; description: string; usageHint: string }[],\n): string {\n  const lines: string[] = ['## Available Tools', ''];\n  lines.push('| Tool | Description |');\n  lines.push('|------|-------------|');\n  for (const t of tools) {\n    lines.push(`| \\`${t.name}\\` | ${t.description} |`);\n  }\n  return lines.join('\\n');\n}\n"],
   "mappings": "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",
   "names": []
 }

package/dist/tool-search.d.ts

@@ -1,4 +1,4 @@
-import type { Tool } from '@wrongstack/core';
+import type { Tool } from '@wrongstack/core/types';
 interface ToolSearchInput {
     query?: string | undefined;
     tags?: string[] | undefined;

package/dist/tool-search.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tool-search.d.ts","sourceRoot":"","sources":["../src/tool-search.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAE7C,UAAU,eAAe;IACvB,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,IAAI,CAAC,EAAE,MAAM,EAAE,GAAG,SAAS,CAAC;IAC5B,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAAC;IACrD,QAAQ,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC/B,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC5B;AAED,UAAU,gBAAgB;IACxB,KAAK,EAAE;QACL,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,EAAE,MAAM,CAAC;QACpB,UAAU,EAAE,MAAM,CAAC;QACnB,QAAQ,EAAE,OAAO,CAAC;KACnB,EAAE,CAAC;IACJ,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,OAAO,CAAC;IACnB,qEAAqE;IACrE,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,eAAO,MAAM,cAAc,EAAE,IAAI,CAAC,eAAe,EAAE,gBAAgB,CAmGlE,CAAC"}
+{"version":3,"file":"tool-search.d.ts","sourceRoot":"","sources":["../src/tool-search.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,wBAAwB,CAAC;AAEnD,UAAU,eAAe;IACvB,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,IAAI,CAAC,EAAE,MAAM,EAAE,GAAG,SAAS,CAAC;IAC5B,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAAC;IACrD,QAAQ,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC/B,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC5B;AAED,UAAU,gBAAgB;IACxB,KAAK,EAAE;QACL,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,EAAE,MAAM,CAAC;QACpB,UAAU,EAAE,MAAM,CAAC;QACnB,QAAQ,EAAE,OAAO,CAAC;KACnB,EAAE,CAAC;IACJ,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,OAAO,CAAC;IACnB,qEAAqE;IACrE,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,eAAO,MAAM,cAAc,EAAE,IAAI,CAAC,eAAe,EAAE,gBAAgB,CAmGlE,CAAC"}

package/dist/tool-search.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../src/tool-search.ts"],
-  "sourcesContent": ["import type { Tool } from '@wrongstack/core';\n\ninterface ToolSearchInput {\n  query?: string | undefined;\n  tags?: string[] | undefined;\n  permission?: 'auto' | 'confirm' | 'deny' | undefined;\n  mutating?: boolean | undefined;\n  limit?: number | undefined;\n}\n\ninterface ToolSearchOutput {\n  tools: {\n    name: string;\n    description: string;\n    permission: string;\n    mutating: boolean;\n  }[];\n  total: number;\n  truncated: boolean;\n  /** Total count of tools in the registry (for \"no results\" hints). */\n  _available?: number;\n}\n\nexport const toolSearchTool: Tool<ToolSearchInput, ToolSearchOutput> = {\n  name: 'tool_search',\n  category: 'Meta',\n  description:\n    'Search the catalog of available tools by name or description. Use this to discover which tool to use for a task. ' +\n    'For the full schema and usage details of a specific tool, use `tool_help` instead.',\n  usageHint:\n    'SELF-DISCOVERY TOOL:\\n\\n' +\n    '- Use when you need to find the right tool for a job.\\n' +\n    '- `query` searches names and descriptions.\\n' +\n    '- You can filter by `tags` (category), `permission`, or `mutating`.\\n' +\n    '- Once you find the right tool name, use `tool_help` with that name for full schema details.\\n' +\n    'Call this before guessing tool names. It helps you discover the best tool for the current situation.',\n  permission: 'auto',\n  mutating: false,\n  timeoutMs: 1_000,\n  capabilities: ['tool.meta'],\n  icon: 'meta',\n  inputSchema: {\n    type: 'object',\n    properties: {\n      query: {\n        type: 'string',\n        description: 'Search query for tool name or description',\n      },\n      tags: {\n        type: 'array',\n        items: { type: 'string' },\n        description: 'Filter by tags (e.g. \"filesystem\", \"network\", \"dev\")',\n      },\n      permission: {\n        type: 'string',\n        enum: ['auto', 'confirm', 'deny'],\n        description: 'Filter by required permission level',\n      },\n      mutating: {\n        type: 'boolean',\n        description: 'Filter by mutating flag (true=filters that modify, false=read-only)',\n      },\n      limit: {\n        type: 'integer',\n        description: 'Maximum results to return (default: 20)',\n        minimum: 1,\n        maximum: 100,\n      },\n    },\n  },\n  async execute(input, ctx) {\n    const limit = Math.min(input.limit ?? 20, 100);\n    const tools = ctx.tools;\n    const query = input.query?.toLowerCase() ?? '';\n\n    const filtered = tools.filter((t: Tool) => {\n      if (\n        query &&\n        !t.name.toLowerCase().includes(query) &&\n        !t.description.toLowerCase().includes(query)\n      ) {\n        return false;\n      }\n      if (input.tags && input.tags.length > 0) {\n        const toolCat = (t.category ?? '').toLowerCase();\n        if (!input.tags.some((tag: string) => toolCat.includes(tag.toLowerCase()))) {\n          return false;\n        }\n      }\n      if (input.permission && t.permission !== input.permission) {\n        return false;\n      }\n      if (typeof input.mutating === 'boolean' && t.mutating !== input.mutating) {\n        return false;\n      }\n      return true;\n    });\n\n    const results = filtered.slice(0, limit).map((t: Tool) => ({\n      name: t.name,\n      description: t.description,\n      permission: t.permission,\n      mutating: t.mutating,\n    }));\n\n    // When no tools match, give the model actionable guidance so it\n    // doesn't spiral through random queries. Point it at tool-help\n    // which lists every available tool with descriptions.\n    const totalAvailable = tools.length;\n    const hint =\n      results.length === 0 && query\n        ? `No tools matched \"${input.query}\". Use tool-help (without arguments) to see all ${totalAvailable} available tools.`\n        : undefined;\n\n    return {\n      tools: results,\n      total: filtered.length,\n      truncated: filtered.length > limit,\n      ...(hint ? { hint } : {}),\n      _available: totalAvailable,\n    };\n  },\n};"],
+  "sourcesContent": ["import type { Tool } from '@wrongstack/core/types';\n\ninterface ToolSearchInput {\n  query?: string | undefined;\n  tags?: string[] | undefined;\n  permission?: 'auto' | 'confirm' | 'deny' | undefined;\n  mutating?: boolean | undefined;\n  limit?: number | undefined;\n}\n\ninterface ToolSearchOutput {\n  tools: {\n    name: string;\n    description: string;\n    permission: string;\n    mutating: boolean;\n  }[];\n  total: number;\n  truncated: boolean;\n  /** Total count of tools in the registry (for \"no results\" hints). */\n  _available?: number;\n}\n\nexport const toolSearchTool: Tool<ToolSearchInput, ToolSearchOutput> = {\n  name: 'tool_search',\n  category: 'Meta',\n  description:\n    'Search the catalog of available tools by name or description. Use this to discover which tool to use for a task. ' +\n    'For the full schema and usage details of a specific tool, use `tool_help` instead.',\n  usageHint:\n    'SELF-DISCOVERY TOOL:\\n\\n' +\n    '- Use when you need to find the right tool for a job.\\n' +\n    '- `query` searches names and descriptions.\\n' +\n    '- You can filter by `tags` (category), `permission`, or `mutating`.\\n' +\n    '- Once you find the right tool name, use `tool_help` with that name for full schema details.\\n' +\n    'Call this before guessing tool names. It helps you discover the best tool for the current situation.',\n  permission: 'auto',\n  mutating: false,\n  timeoutMs: 1_000,\n  capabilities: ['tool.meta'],\n  icon: 'meta',\n  inputSchema: {\n    type: 'object',\n    properties: {\n      query: {\n        type: 'string',\n        description: 'Search query for tool name or description',\n      },\n      tags: {\n        type: 'array',\n        items: { type: 'string' },\n        description: 'Filter by tags (e.g. \"filesystem\", \"network\", \"dev\")',\n      },\n      permission: {\n        type: 'string',\n        enum: ['auto', 'confirm', 'deny'],\n        description: 'Filter by required permission level',\n      },\n      mutating: {\n        type: 'boolean',\n        description: 'Filter by mutating flag (true=filters that modify, false=read-only)',\n      },\n      limit: {\n        type: 'integer',\n        description: 'Maximum results to return (default: 20)',\n        minimum: 1,\n        maximum: 100,\n      },\n    },\n  },\n  async execute(input, ctx) {\n    const limit = Math.min(input.limit ?? 20, 100);\n    const tools = ctx.tools;\n    const query = input.query?.toLowerCase() ?? '';\n\n    const filtered = tools.filter((t: Tool) => {\n      if (\n        query &&\n        !t.name.toLowerCase().includes(query) &&\n        !t.description.toLowerCase().includes(query)\n      ) {\n        return false;\n      }\n      if (input.tags && input.tags.length > 0) {\n        const toolCat = (t.category ?? '').toLowerCase();\n        if (!input.tags.some((tag: string) => toolCat.includes(tag.toLowerCase()))) {\n          return false;\n        }\n      }\n      if (input.permission && t.permission !== input.permission) {\n        return false;\n      }\n      if (typeof input.mutating === 'boolean' && t.mutating !== input.mutating) {\n        return false;\n      }\n      return true;\n    });\n\n    const results = filtered.slice(0, limit).map((t: Tool) => ({\n      name: t.name,\n      description: t.description,\n      permission: t.permission,\n      mutating: t.mutating,\n    }));\n\n    // When no tools match, give the model actionable guidance so it\n    // doesn't spiral through random queries. Point it at tool-help\n    // which lists every available tool with descriptions.\n    const totalAvailable = tools.length;\n    const hint =\n      results.length === 0 && query\n        ? `No tools matched \"${input.query}\". Use tool-help (without arguments) to see all ${totalAvailable} available tools.`\n        : undefined;\n\n    return {\n      tools: results,\n      total: filtered.length,\n      truncated: filtered.length > limit,\n      ...(hint ? { hint } : {}),\n      _available: totalAvailable,\n    };\n  },\n};"],
   "mappings": ";AAuBO,IAAM,iBAA0D;AAAA,EACrE,MAAM;AAAA,EACN,UAAU;AAAA,EACV,aACE;AAAA,EAEF,WACE;AAAA,EAMF,YAAY;AAAA,EACZ,UAAU;AAAA,EACV,WAAW;AAAA,EACX,cAAc,CAAC,WAAW;AAAA,EAC1B,MAAM;AAAA,EACN,aAAa;AAAA,IACX,MAAM;AAAA,IACN,YAAY;AAAA,MACV,OAAO;AAAA,QACL,MAAM;AAAA,QACN,aAAa;AAAA,MACf;AAAA,MACA,MAAM;AAAA,QACJ,MAAM;AAAA,QACN,OAAO,EAAE,MAAM,SAAS;AAAA,QACxB,aAAa;AAAA,MACf;AAAA,MACA,YAAY;AAAA,QACV,MAAM;AAAA,QACN,MAAM,CAAC,QAAQ,WAAW,MAAM;AAAA,QAChC,aAAa;AAAA,MACf;AAAA,MACA,UAAU;AAAA,QACR,MAAM;AAAA,QACN,aAAa;AAAA,MACf;AAAA,MACA,OAAO;AAAA,QACL,MAAM;AAAA,QACN,aAAa;AAAA,QACb,SAAS;AAAA,QACT,SAAS;AAAA,MACX;AAAA,IACF;AAAA,EACF;AAAA,EACA,MAAM,QAAQ,OAAO,KAAK;AACxB,UAAM,QAAQ,KAAK,IAAI,MAAM,SAAS,IAAI,GAAG;AAC7C,UAAM,QAAQ,IAAI;AAClB,UAAM,QAAQ,MAAM,OAAO,YAAY,KAAK;AAE5C,UAAM,WAAW,MAAM,OAAO,CAAC,MAAY;AACzC,UACE,SACA,CAAC,EAAE,KAAK,YAAY,EAAE,SAAS,KAAK,KACpC,CAAC,EAAE,YAAY,YAAY,EAAE,SAAS,KAAK,GAC3C;AACA,eAAO;AAAA,MACT;AACA,UAAI,MAAM,QAAQ,MAAM,KAAK,SAAS,GAAG;AACvC,cAAM,WAAW,EAAE,YAAY,IAAI,YAAY;AAC/C,YAAI,CAAC,MAAM,KAAK,KAAK,CAAC,QAAgB,QAAQ,SAAS,IAAI,YAAY,CAAC,CAAC,GAAG;AAC1E,iBAAO;AAAA,QACT;AAAA,MACF;AACA,UAAI,MAAM,cAAc,EAAE,eAAe,MAAM,YAAY;AACzD,eAAO;AAAA,MACT;AACA,UAAI,OAAO,MAAM,aAAa,aAAa,EAAE,aAAa,MAAM,UAAU;AACxE,eAAO;AAAA,MACT;AACA,aAAO;AAAA,IACT,CAAC;AAED,UAAM,UAAU,SAAS,MAAM,GAAG,KAAK,EAAE,IAAI,CAAC,OAAa;AAAA,MACzD,MAAM,EAAE;AAAA,MACR,aAAa,EAAE;AAAA,MACf,YAAY,EAAE;AAAA,MACd,UAAU,EAAE;AAAA,IACd,EAAE;AAKF,UAAM,iBAAiB,MAAM;AAC7B,UAAM,OACJ,QAAQ,WAAW,KAAK,QACpB,qBAAqB,MAAM,KAAK,mDAAmD,cAAc,sBACjG;AAEN,WAAO;AAAA,MACL,OAAO;AAAA,MACP,OAAO,SAAS;AAAA,MAChB,WAAW,SAAS,SAAS;AAAA,MAC7B,GAAI,OAAO,EAAE,KAAK,IAAI,CAAC;AAAA,MACvB,YAAY;AAAA,IACd;AAAA,EACF;AACF;",
   "names": []
 }

package/dist/tool-tier.d.ts

@@ -0,0 +1,16 @@
+import type { ConcreteTokenSavingTier, Tool } from '@wrongstack/core/types';
+import type { ToolRegistry } from '@wrongstack/core/registry';
+/**
+ * Select built-in tools for a concrete token-saving tier while preserving the
+ * order and instances supplied by the caller.
+ */
+export declare function selectBuiltinToolsForTier(tier: ConcreteTokenSavingTier, allTools: readonly Tool[]): Tool[];
+export interface RegisterBuiltinToolTierOptions {
+    registry: Pick<ToolRegistry, 'registerAllOrThrow'>;
+    tier: ConcreteTokenSavingTier;
+    tools?: readonly Tool[] | undefined;
+    owner?: string | undefined;
+}
+/** Register the canonical built-in subset for a host and return that subset. */
+export declare function registerBuiltinToolTier(options: RegisterBuiltinToolTierOptions): Tool[];
+//# sourceMappingURL=tool-tier.d.ts.map

package/dist/tool-tier.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-tier.d.ts","sourceRoot":"","sources":["../src/tool-tier.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,uBAAuB,EAAE,IAAI,EAAE,MAAM,wBAAwB,CAAC;AAC5E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAQ9D;;;GAGG;AACH,wBAAgB,yBAAyB,CACvC,IAAI,EAAE,uBAAuB,EAC7B,QAAQ,EAAE,SAAS,IAAI,EAAE,GACxB,IAAI,EAAE,CA0BR;AAED,MAAM,WAAW,8BAA8B;IAC7C,QAAQ,EAAE,IAAI,CAAC,YAAY,EAAE,oBAAoB,CAAC,CAAC;IACnD,IAAI,EAAE,uBAAuB,CAAC;IAC9B,KAAK,CAAC,EAAE,SAAS,IAAI,EAAE,GAAG,SAAS,CAAC;IACpC,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC5B;AAED,gFAAgF;AAChF,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,8BAA8B,GAAG,IAAI,EAAE,CAOvF"}