@wrongstack/tools 0.289.0 → 0.291.0

package/dist/plan.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../src/plan.ts", "../src/session-kanban.ts"],
-  "sourcesContent": ["import {\n  type PlanFile,\n  addPlanItem,\n  clearPlan,\n  deriveTodosFromPlanItem,\n  formatPlan,\n  getPlanTemplate,\n  mutatePlan,\n  removePlanItem,\n  setPlanItemStatus,\n} from '@wrongstack/core';\nimport {\n  type TaskFile,\n  mutateTasks,\n  formatTaskList,\n} from '@wrongstack/core';\nimport { randomUUID } from 'node:crypto';\nimport type { Tool } from '@wrongstack/core';\nimport { projectSessionPlanToKanban } from './session-kanban.js';\n\n/**\n * `planTool` \u2014 the LLM-callable counterpart to the `/plan` slash command.\n *\n * Plans capture strategic, multi-step approaches that survive across\n * session resumes (unlike todos, which are tactical and per-turn).\n * Storage path comes from `ctx.meta['plan.path']` \u2014 the CLI seeds this\n * during startup so the tool always knows where to read/write.\n *\n * One tool, multiple actions, JSON in/out. The action discriminates the\n * operation so the LLM can do show / add / start / done / remove / promote /\n * derive / template_use / clear via a single tool registration instead of\n * bloating the surface with nine near-identical tools.\n */\ninterface PlanInput {\n  action:\n    | 'show'\n    | 'add'\n    | 'start'\n    | 'done'\n    | 'remove'\n    | 'promote'\n    | 'template_use'\n    | 'clear'\n    | 'taskify';\n  /** Required for add. */\n  title?: string | undefined;\n  /** Optional detail line for add. */\n  details?: string | undefined;\n  /** Required for start/done/remove/promote \u2014 accepts plan item id OR 1-based index OR title substring. */\n  target?: string | undefined;\n  /** Optional subtasks for promote. If omitted, a single todo is created from the plan item title. */\n  subtasks?: string[] | undefined;\n  /** Required for template_use \u2014 the template name (e.g. \"new-feature\", \"bug-fix\"). */\n  template?: string | undefined;\n  /**\n   * Storage scope. Default (unset): uses the session-scoped path \u2014 isolated to this\n   * session, survives resume within the same session.\n   * `scope: 'project'`: uses a shared project-level path, visible to all sessions\n   * for this project. Useful for a shared roadmap that outlasts any single session.\n   */\n  scope?: 'session' | 'project';\n}\n\ninterface PlanOutput {\n  ok: boolean;\n  message: string;\n  /** Formatted plan after the operation. Same string the user sees from `/plan show`. */\n  plan: string;\n  /** Total item count after the operation. */\n  count: number;\n  /** Number of items not in 'done' status. */\n  open: number;\n  /** When promote/derive succeed, the generated todo items so the caller can inspect them. */\n  todos?: Array<{ id: string; content: string; status: string; activeForm?: string | undefined; promotedFromPlan?: string | undefined }>;\n}\n\nexport const planTool: Tool<PlanInput, PlanOutput> = {\n  name: 'plan',\n  category: 'Session',\n  description:\n    'Manage a session-persistent strategic plan. The plan is written to disk and survives conversation resumptions within the same session, but is isolated to this session \u2014 other sessions have their own separate plans. ' +\n    'Unlike todos (which are per-turn and lost on restart), a plan tracks high-level progress across multiple turns. ' +\n    'Use this to outline big-picture work, then promote concrete items into the todo list when ready to execute. ' +\n    'By default plans are isolated to this session; use `scope: \"project\"` to store the plan in a shared project-level file visible to all sessions.',\n  usageHint:\n    'RECOMMENDED FOR COMPLEX, MULTI-PHASE WORK:\\n\\n' +\n    '- Start by creating a high-level plan with `action: \"add\"` or using templates (`template_use`).\\n' +\n    '- Use `promote` to turn a plan item into actionable todos.\\n' +\n    '- Use `taskify` to convert a plan item into a structured task (with type/priority/deps).\\n' +\n    '- Keep plans at the \"why and what\" level, and todos at the \"how and next step\" level.\\n' +\n    '- Common templates: \"new-feature\", \"bug-fix\", \"refactor\", \"release\", \"security-audit\".\\n\\n' +\n    'This tool is excellent for maintaining long-term direction across many turns within a session. Plans survive resume but are not shared across separate sessions.\\n' +\n    'Use `scope: \"project\"` to use a shared project-level plan file.',\n  permission: 'confirm',\n  mutating: true,\n  capabilities: ['fs.write'],\n  icon: 'plan',\n  timeoutMs: 2_000,\n  inputSchema: {\n    type: 'object',\n    properties: {\n      action: {\n        type: 'string',\n        enum: [\n          'show',\n          'add',\n          'start',\n          'done',\n          'remove',\n          'promote',\n          'template_use',\n          'clear',\n          'taskify',\n        ],\n        description: 'The operation to perform on the plan board.',\n      },\n      title: {\n        type: 'string',\n        description: 'Title of the plan item. Required for action=add.',\n      },\n      details: {\n        type: 'string',\n        description: 'Additional details or description for a new plan item (action=add).',\n      },\n      target: {\n        type: 'string',\n        description:\n          'Identifier for the target plan item (id, 1-based index, or partial title). Required for most actions except add/show/clear.',\n      },\n      subtasks: {\n        type: 'array',\n        items: { type: 'string' },\n        description:\n          'List of subtask titles. Used with promote to break a plan item into multiple todos.',\n      },\n      template: {\n        type: 'string',\n        description:\n          'Template identifier when using action=template_use. Common values: new-feature, bug-fix, refactor, release, security-audit.',\n      },\n      scope: {\n        type: 'string',\n        enum: ['session', 'project'],\n        description: 'Storage scope: \"session\" (default, isolated to this session) or \"project\" (shared across all sessions for this project).',\n      },\n    },\n    required: ['action'],\n  },\n  async execute(input, ctx) {\n    const sessionPlanPath = (ctx.meta as Record<string, unknown>)['plan.path'] as string | undefined;\n    let planPath: string | undefined;\n\n    if (input.scope === 'project') {\n      // Project-level: derive from the session path by replacing the filename with\n      // 'backlog.plan.json' so all sessions share the same file.\n      if (typeof sessionPlanPath === 'string') {\n        // Handle BOTH separators \u2014 a Windows-native path uses '\\\\', and a\n        // '/'-only search would miss it and fall back to a bare relative path\n        // written into the process CWD instead of the sessions dir.\n        const lastSep = Math.max(sessionPlanPath.lastIndexOf('/'), sessionPlanPath.lastIndexOf('\\\\'));\n        planPath = lastSep >= 0\n          ? sessionPlanPath.slice(0, lastSep + 1) + 'backlog.plan.json'\n          : 'backlog.plan.json';\n      }\n    } else {\n      planPath = sessionPlanPath;\n    }\n    if (typeof planPath !== 'string' || !planPath) {\n      return {\n        ok: false,\n        message: 'Plan storage path is not configured for this session.',\n        plan: '',\n        count: 0,\n        open: 0,\n      };\n    }\n    const sessionId = ctx.session?.id ?? 'unknown';\n\n    let early: PlanOutput | null = null;\n    // Track taskify data \u2014 task write happens after the plan lock releases\n    const taskifyMeta = { title: '', details: '' };\n    let didTaskify = false;\n\n    let plan: PlanFile;\n    try {\n    plan = await mutatePlan(planPath, sessionId, async (p) => {\n      switch (input.action) {\n        case 'show':\n          break;\n\n        case 'add': {\n          const title = input.title?.trim();\n          if (!title) {\n            early = mkResult(p, false, 'add requires `title`.');\n            return p;\n          }\n          const { plan: updated } = addPlanItem(p, title, input.details?.trim() || undefined);\n          return updated;\n        }\n\n        case 'start':\n        case 'done': {\n          if (!input.target) {\n            early = mkResult(p, false, `${input.action} requires \\`target\\` (id|index|substring).`);\n            return p;\n          }\n          const next = setPlanItemStatus(\n            p,\n            input.target,\n            input.action === 'start' ? 'in_progress' : 'done',\n          );\n          if (next === p) {\n            early = mkResult(p, false, `No plan item matched \"${input.target}\".`);\n            return p;\n          }\n          return next;\n        }\n\n        case 'remove': {\n          if (!input.target) {\n            early = mkResult(p, false, 'remove requires `target` (id|index|substring).');\n            return p;\n          }\n          const next = removePlanItem(p, input.target);\n          if (next === p) {\n            early = mkResult(p, false, `No plan item matched \"${input.target}\".`);\n            return p;\n          }\n          return next;\n        }\n\n        case 'promote': {\n          if (!input.target) {\n            early = mkResult(p, false, `${input.action} requires \\`target\\` (id|index|substring).`);\n            return p;\n          }\n          const derived = deriveTodosFromPlanItem(p, input.target, input.subtasks);\n          if (!derived) {\n            early = mkResult(p, false, `No plan item matched \"${input.target}\".`);\n            return p;\n          }\n          ctx.state.replaceTodos(derived.todos);\n          early = mkResult(\n            derived.plan,\n            true,\n            `${input.action} ok \u2014 ${derived.todos.length} todo(s) created.`,\n            derived.todos,\n          );\n          return derived.plan;\n        }\n\n        case 'template_use': {\n          const templateName = input.template?.trim();\n          if (!templateName) {\n            early = mkResult(p, false, 'template_use requires `template` name.');\n            return p;\n          }\n          const template = getPlanTemplate(templateName);\n          if (!template) {\n            early = mkResult(p, false, `Unknown template \"${templateName}\".`);\n            return p;\n          }\n          let updated = p;\n          for (const item of template.items) {\n            ({ plan: updated } = addPlanItem(updated, item.title, item.details));\n          }\n          early = mkResult(\n            updated,\n            true,\n            `Applied template \"${template.name}\" \u2014 ${template.items.length} items added.`,\n          );\n          return updated;\n        }\n\n        case 'clear':\n          return clearPlan(p);\n\n        case 'taskify': {\n          if (!input.target) {\n            early = mkResult(p, false, 'taskify requires `target` (plan item id|index|substring).');\n            return p;\n          }\n          // Find plan item by 1-based index, exact id, or title substring\n          let itemIdx = -1;\n          const asNum = Number.parseInt(input.target, 10);\n          if (!Number.isNaN(asNum) && asNum >= 1 && asNum <= p.items.length) {\n            itemIdx = asNum - 1;\n          } else {\n            itemIdx = p.items.findIndex((it) => it.id === input.target);\n            if (itemIdx === -1) {\n              const lower = input.target.toLowerCase();\n              itemIdx = p.items.findIndex((it) => it.title.toLowerCase().includes(lower));\n            }\n          }\n          if (itemIdx === -1 || !p.items[itemIdx]) {\n            early = mkResult(p, false, `No plan item matched \"${input.target}\".`);\n            return p;\n          }\n          const item = p.items[itemIdx]!;\n          // Extract data \u2014 task write happens after the plan lock releases\n          taskifyMeta.title = item.title;\n          taskifyMeta.details = item.details ?? '';\n          didTaskify = true;\n          break;\n        }\n\n        default:\n          early = mkResult(p, false, `Unknown action \"${(input as { action: string }).action}\".`);\n          return p;\n      }\n\n      return p;\n    });\n    } catch (err) {\n      // Persist failed (mutatePlan throws on a failed save) \u2014 report ok:false\n      // with the real reason instead of falsely claiming the plan was saved.\n      return {\n        ok: false,\n        message: `Plan change not saved \u2014 ${err instanceof Error ? err.message : String(err)}`,\n        plan: '',\n        count: 0,\n        open: 0,\n      };\n    }\n\n    // A successful plan mutation includes its projection onto the unified\n    // session board; callers never observe plan state ahead of Kanban state.\n    await projectSessionPlanToKanban(ctx.projectRoot, plan.items, sessionId);\n\n    // If the callback set an early-return result, use it\n    if (early) return early;\n\n    // If taskify copied plan item data, write it to the task file now\n    if (didTaskify) {\n      const taskPathRaw = (ctx.meta as Record<string, unknown>)['task.path'];\n      if (typeof taskPathRaw !== 'string' || !taskPathRaw) {\n        return mkResult(plan, false, 'Task storage path not configured \u2014 cannot taskify.');\n      }\n      let taskPath: string = taskPathRaw;\n      // Honor project scope for the TASK file too: a project-scoped taskify must\n      // append to the shared backlog.tasks.json, not the per-session task file\n      // (mirrors the plan-path derivation above; handles both separators).\n      if (input.scope === 'project') {\n        const lastSep = Math.max(taskPath.lastIndexOf('/'), taskPath.lastIndexOf('\\\\'));\n        taskPath = lastSep >= 0 ? taskPath.slice(0, lastSep + 1) + 'backlog.tasks.json' : 'backlog.tasks.json';\n      }\n      const now = new Date().toISOString();\n      // Mutate the cross-file under ITS OWN lock \u2014 a raw loadTasks/push/saveTasks\n      // can interleave with a concurrent task tool call in the same batch and\n      // clobber writes. mutateTasks is the documented race-safe write path.\n      try {\n        const taskFile: TaskFile = await mutateTasks(taskPath, sessionId, (f) => {\n          f.tasks.push({\n            id: `task_${randomUUID()}`,\n            title: taskifyMeta.title,\n            description: taskifyMeta.details || undefined,\n            type: 'feature',\n            priority: 'medium',\n            status: 'pending',\n            createdAt: now,\n            updatedAt: now,\n          });\n          return f;\n        });\n        return mkResult(\n          plan,\n          true,\n          `taskify ok \u2014 added \"${taskifyMeta.title}\" to tasks.\\n${formatTaskList(taskFile.tasks)}`,\n        );\n      } catch (err) {\n        // The plan item was saved, but copying it into the task file failed.\n        return mkResult(plan, false, `taskify: task not saved \u2014 ${err instanceof Error ? err.message : String(err)}`);\n      }\n    }\n\n    return mkResult(plan, true, `Plan ${input.action} ok.`);\n  },\n};\n\nfunction mkResult(\n  plan: PlanFile,\n  ok: boolean,\n  message: string,\n  todos?: PlanOutput['todos'],\n): PlanOutput {\n  const open = plan.items.filter((i) => i.status !== 'done').length;\n  const result: PlanOutput = {\n    ok,\n    message,\n    plan: formatPlan(plan),\n    count: plan.items.length,\n    open,\n  };\n  if (todos !== undefined) result.todos = todos;\n  return result;\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>>();\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 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\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  fireAndForget(projectSessionTodosToKanban(projectRoot, todos, sessionId));\n}\n\nexport function mirrorSessionTasksToKanban(\n  projectRoot: string | undefined,\n  tasks: readonly TaskItem[],\n  sessionId: string,\n): void {\n  fireAndForget(projectSessionTasksToKanban(projectRoot, tasks, sessionId));\n}\n\nexport function mirrorSessionPlanToKanban(\n  projectRoot: string | undefined,\n  items: readonly PlanItem[],\n  sessionId: string,\n): void {\n  fireAndForget(projectSessionPlanToKanban(projectRoot, items, sessionId));\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 {\n  type PlanFile,\n  addPlanItem,\n  clearPlan,\n  deriveTodosFromPlanItem,\n  formatPlan,\n  getPlanTemplate,\n  mutatePlan,\n  removePlanItem,\n  setPlanItemStatus,\n} from '@wrongstack/core';\nimport {\n  type TaskFile,\n  mutateTasks,\n  formatTaskList,\n} from '@wrongstack/core';\nimport { randomUUID } from 'node:crypto';\nimport type { Tool } from '@wrongstack/core';\nimport { projectSessionPlanToKanban } from './session-kanban.js';\n\n/**\n * `planTool` \u2014 the LLM-callable counterpart to the `/plan` slash command.\n *\n * Plans capture strategic, multi-step approaches that survive across\n * session resumes (unlike todos, which are tactical and per-turn).\n * Storage path comes from `ctx.meta['plan.path']` \u2014 the CLI seeds this\n * during startup so the tool always knows where to read/write.\n *\n * One tool, multiple actions, JSON in/out. The action discriminates the\n * operation so the LLM can do show / add / start / done / remove / promote /\n * derive / template_use / clear via a single tool registration instead of\n * bloating the surface with nine near-identical tools.\n */\ninterface PlanInput {\n  action:\n    | 'show'\n    | 'add'\n    | 'start'\n    | 'done'\n    | 'remove'\n    | 'promote'\n    | 'template_use'\n    | 'clear'\n    | 'taskify';\n  /** Required for add. */\n  title?: string | undefined;\n  /** Optional detail line for add. */\n  details?: string | undefined;\n  /** Required for start/done/remove/promote \u2014 accepts plan item id OR 1-based index OR title substring. */\n  target?: string | undefined;\n  /** Optional subtasks for promote. If omitted, a single todo is created from the plan item title. */\n  subtasks?: string[] | undefined;\n  /** Required for template_use \u2014 the template name (e.g. \"new-feature\", \"bug-fix\"). */\n  template?: string | undefined;\n  /**\n   * Storage scope. Default (unset): uses the session-scoped path \u2014 isolated to this\n   * session, survives resume within the same session.\n   * `scope: 'project'`: uses a shared project-level path, visible to all sessions\n   * for this project. Useful for a shared roadmap that outlasts any single session.\n   */\n  scope?: 'session' | 'project';\n}\n\ninterface PlanOutput {\n  ok: boolean;\n  message: string;\n  /** Formatted plan after the operation. Same string the user sees from `/plan show`. */\n  plan: string;\n  /** Total item count after the operation. */\n  count: number;\n  /** Number of items not in 'done' status. */\n  open: number;\n  /** When promote/derive succeed, the generated todo items so the caller can inspect them. */\n  todos?: Array<{ id: string; content: string; status: string; activeForm?: string | undefined; promotedFromPlan?: string | undefined }>;\n}\n\nexport const planTool: Tool<PlanInput, PlanOutput> = {\n  name: 'plan',\n  category: 'Session',\n  description:\n    'Manage a session-persistent strategic plan. The plan is written to disk and survives conversation resumptions within the same session, but is isolated to this session \u2014 other sessions have their own separate plans. ' +\n    'Unlike todos (which are per-turn and lost on restart), a plan tracks high-level progress across multiple turns. ' +\n    'Use this to outline big-picture work, then promote concrete items into the todo list when ready to execute. ' +\n    'By default plans are isolated to this session; use `scope: \"project\"` to store the plan in a shared project-level file visible to all sessions.',\n  usageHint:\n    'RECOMMENDED FOR COMPLEX, MULTI-PHASE WORK:\\n\\n' +\n    '- Start by creating a high-level plan with `action: \"add\"` or using templates (`template_use`).\\n' +\n    '- Use `promote` to turn a plan item into actionable todos.\\n' +\n    '- Use `taskify` to convert a plan item into a structured task (with type/priority/deps).\\n' +\n    '- Keep plans at the \"why and what\" level, and todos at the \"how and next step\" level.\\n' +\n    '- Common templates: \"new-feature\", \"bug-fix\", \"refactor\", \"release\", \"security-audit\".\\n\\n' +\n    'This tool is excellent for maintaining long-term direction across many turns within a session. Plans survive resume but are not shared across separate sessions.\\n' +\n    'Use `scope: \"project\"` to use a shared project-level plan file.',\n  permission: 'confirm',\n  mutating: true,\n  capabilities: ['fs.write'],\n  icon: 'plan',\n  timeoutMs: 2_000,\n  inputSchema: {\n    type: 'object',\n    properties: {\n      action: {\n        type: 'string',\n        enum: [\n          'show',\n          'add',\n          'start',\n          'done',\n          'remove',\n          'promote',\n          'template_use',\n          'clear',\n          'taskify',\n        ],\n        description: 'The operation to perform on the plan board.',\n      },\n      title: {\n        type: 'string',\n        description: 'Title of the plan item. Required for action=add.',\n      },\n      details: {\n        type: 'string',\n        description: 'Additional details or description for a new plan item (action=add).',\n      },\n      target: {\n        type: 'string',\n        description:\n          'Identifier for the target plan item (id, 1-based index, or partial title). Required for most actions except add/show/clear.',\n      },\n      subtasks: {\n        type: 'array',\n        items: { type: 'string' },\n        description:\n          'List of subtask titles. Used with promote to break a plan item into multiple todos.',\n      },\n      template: {\n        type: 'string',\n        description:\n          'Template identifier when using action=template_use. Common values: new-feature, bug-fix, refactor, release, security-audit.',\n      },\n      scope: {\n        type: 'string',\n        enum: ['session', 'project'],\n        description: 'Storage scope: \"session\" (default, isolated to this session) or \"project\" (shared across all sessions for this project).',\n      },\n    },\n    required: ['action'],\n  },\n  async execute(input, ctx) {\n    const sessionPlanPath = (ctx.meta as Record<string, unknown>)['plan.path'] as string | undefined;\n    let planPath: string | undefined;\n\n    if (input.scope === 'project') {\n      // Project-level: derive from the session path by replacing the filename with\n      // 'backlog.plan.json' so all sessions share the same file.\n      if (typeof sessionPlanPath === 'string') {\n        // Handle BOTH separators \u2014 a Windows-native path uses '\\\\', and a\n        // '/'-only search would miss it and fall back to a bare relative path\n        // written into the process CWD instead of the sessions dir.\n        const lastSep = Math.max(sessionPlanPath.lastIndexOf('/'), sessionPlanPath.lastIndexOf('\\\\'));\n        planPath = lastSep >= 0\n          ? sessionPlanPath.slice(0, lastSep + 1) + 'backlog.plan.json'\n          : 'backlog.plan.json';\n      }\n    } else {\n      planPath = sessionPlanPath;\n    }\n    if (typeof planPath !== 'string' || !planPath) {\n      return {\n        ok: false,\n        message: 'Plan storage path is not configured for this session.',\n        plan: '',\n        count: 0,\n        open: 0,\n      };\n    }\n    const sessionId = ctx.session?.id ?? 'unknown';\n\n    let early: PlanOutput | null = null;\n    // Track taskify data \u2014 task write happens after the plan lock releases\n    const taskifyMeta = { title: '', details: '' };\n    let didTaskify = false;\n\n    let plan: PlanFile;\n    try {\n    plan = await mutatePlan(planPath, sessionId, async (p) => {\n      switch (input.action) {\n        case 'show':\n          break;\n\n        case 'add': {\n          const title = input.title?.trim();\n          if (!title) {\n            early = mkResult(p, false, 'add requires `title`.');\n            return p;\n          }\n          const { plan: updated } = addPlanItem(p, title, input.details?.trim() || undefined);\n          return updated;\n        }\n\n        case 'start':\n        case 'done': {\n          if (!input.target) {\n            early = mkResult(p, false, `${input.action} requires \\`target\\` (id|index|substring).`);\n            return p;\n          }\n          const next = setPlanItemStatus(\n            p,\n            input.target,\n            input.action === 'start' ? 'in_progress' : 'done',\n          );\n          if (next === p) {\n            early = mkResult(p, false, `No plan item matched \"${input.target}\".`);\n            return p;\n          }\n          return next;\n        }\n\n        case 'remove': {\n          if (!input.target) {\n            early = mkResult(p, false, 'remove requires `target` (id|index|substring).');\n            return p;\n          }\n          const next = removePlanItem(p, input.target);\n          if (next === p) {\n            early = mkResult(p, false, `No plan item matched \"${input.target}\".`);\n            return p;\n          }\n          return next;\n        }\n\n        case 'promote': {\n          if (!input.target) {\n            early = mkResult(p, false, `${input.action} requires \\`target\\` (id|index|substring).`);\n            return p;\n          }\n          const derived = deriveTodosFromPlanItem(p, input.target, input.subtasks);\n          if (!derived) {\n            early = mkResult(p, false, `No plan item matched \"${input.target}\".`);\n            return p;\n          }\n          ctx.state.replaceTodos(derived.todos);\n          early = mkResult(\n            derived.plan,\n            true,\n            `${input.action} ok \u2014 ${derived.todos.length} todo(s) created.`,\n            derived.todos,\n          );\n          return derived.plan;\n        }\n\n        case 'template_use': {\n          const templateName = input.template?.trim();\n          if (!templateName) {\n            early = mkResult(p, false, 'template_use requires `template` name.');\n            return p;\n          }\n          const template = getPlanTemplate(templateName);\n          if (!template) {\n            early = mkResult(p, false, `Unknown template \"${templateName}\".`);\n            return p;\n          }\n          let updated = p;\n          for (const item of template.items) {\n            ({ plan: updated } = addPlanItem(updated, item.title, item.details));\n          }\n          early = mkResult(\n            updated,\n            true,\n            `Applied template \"${template.name}\" \u2014 ${template.items.length} items added.`,\n          );\n          return updated;\n        }\n\n        case 'clear':\n          return clearPlan(p);\n\n        case 'taskify': {\n          if (!input.target) {\n            early = mkResult(p, false, 'taskify requires `target` (plan item id|index|substring).');\n            return p;\n          }\n          // Find plan item by 1-based index, exact id, or title substring\n          let itemIdx = -1;\n          const asNum = Number.parseInt(input.target, 10);\n          if (!Number.isNaN(asNum) && asNum >= 1 && asNum <= p.items.length) {\n            itemIdx = asNum - 1;\n          } else {\n            itemIdx = p.items.findIndex((it) => it.id === input.target);\n            if (itemIdx === -1) {\n              const lower = input.target.toLowerCase();\n              itemIdx = p.items.findIndex((it) => it.title.toLowerCase().includes(lower));\n            }\n          }\n          if (itemIdx === -1 || !p.items[itemIdx]) {\n            early = mkResult(p, false, `No plan item matched \"${input.target}\".`);\n            return p;\n          }\n          const item = p.items[itemIdx]!;\n          // Extract data \u2014 task write happens after the plan lock releases\n          taskifyMeta.title = item.title;\n          taskifyMeta.details = item.details ?? '';\n          didTaskify = true;\n          break;\n        }\n\n        default:\n          early = mkResult(p, false, `Unknown action \"${(input as { action: string }).action}\".`);\n          return p;\n      }\n\n      return p;\n    });\n    } catch (err) {\n      // Persist failed (mutatePlan throws on a failed save) \u2014 report ok:false\n      // with the real reason instead of falsely claiming the plan was saved.\n      return {\n        ok: false,\n        message: `Plan change not saved \u2014 ${err instanceof Error ? err.message : String(err)}`,\n        plan: '',\n        count: 0,\n        open: 0,\n      };\n    }\n\n    // A successful plan mutation includes its projection onto the unified\n    // session board; callers never observe plan state ahead of Kanban state.\n    await projectSessionPlanToKanban(ctx.projectRoot, plan.items, sessionId);\n\n    // If the callback set an early-return result, use it\n    if (early) return early;\n\n    // If taskify copied plan item data, write it to the task file now\n    if (didTaskify) {\n      const taskPathRaw = (ctx.meta as Record<string, unknown>)['task.path'];\n      if (typeof taskPathRaw !== 'string' || !taskPathRaw) {\n        return mkResult(plan, false, 'Task storage path not configured \u2014 cannot taskify.');\n      }\n      let taskPath: string = taskPathRaw;\n      // Honor project scope for the TASK file too: a project-scoped taskify must\n      // append to the shared backlog.tasks.json, not the per-session task file\n      // (mirrors the plan-path derivation above; handles both separators).\n      if (input.scope === 'project') {\n        const lastSep = Math.max(taskPath.lastIndexOf('/'), taskPath.lastIndexOf('\\\\'));\n        taskPath = lastSep >= 0 ? taskPath.slice(0, lastSep + 1) + 'backlog.tasks.json' : 'backlog.tasks.json';\n      }\n      const now = new Date().toISOString();\n      // Mutate the cross-file under ITS OWN lock \u2014 a raw loadTasks/push/saveTasks\n      // can interleave with a concurrent task tool call in the same batch and\n      // clobber writes. mutateTasks is the documented race-safe write path.\n      try {\n        const taskFile: TaskFile = await mutateTasks(taskPath, sessionId, (f) => {\n          f.tasks.push({\n            id: `task_${randomUUID()}`,\n            title: taskifyMeta.title,\n            description: taskifyMeta.details || undefined,\n            type: 'feature',\n            priority: 'medium',\n            status: 'pending',\n            createdAt: now,\n            updatedAt: now,\n          });\n          return f;\n        });\n        return mkResult(\n          plan,\n          true,\n          `taskify ok \u2014 added \"${taskifyMeta.title}\" to tasks.\\n${formatTaskList(taskFile.tasks)}`,\n        );\n      } catch (err) {\n        // The plan item was saved, but copying it into the task file failed.\n        return mkResult(plan, false, `taskify: task not saved \u2014 ${err instanceof Error ? err.message : String(err)}`);\n      }\n    }\n\n    return mkResult(plan, true, `Plan ${input.action} ok.`);\n  },\n};\n\nfunction mkResult(\n  plan: PlanFile,\n  ok: boolean,\n  message: string,\n  todos?: PlanOutput['todos'],\n): PlanOutput {\n  const open = plan.items.filter((i) => i.status !== 'done').length;\n  const result: PlanOutput = {\n    ok,\n    message,\n    plan: formatPlan(plan),\n    count: plan.items.length,\n    open,\n  };\n  if (todos !== undefined) result.todos = todos;\n  return result;\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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",
   "names": ["mutatePlan", "mutateTasks", "board", "mutatePlan", "mutateTasks"]
 }

package/dist/read.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"read.d.ts","sourceRoot":"","sources":["../src/read.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,IAAI,EAAgD,MAAM,kBAAkB,CAAC;AAG3F,UAAU,SAAS;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,IAAI,CAAC,EAAE,SAAS,GAAG,SAAS,GAAG,SAAS,CAAC;CAC1C;AAED,UAAU,UAAU;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,OAAO,CAAC;IACnB,MAAM,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC7B,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC3B;AAID,eAAO,MAAM,QAAQ,EAAE,IAAI,CAAC,SAAS,EAAE,UAAU,CAsLhD,CAAC"}
+{"version":3,"file":"read.d.ts","sourceRoot":"","sources":["../src/read.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,IAAI,EAAgD,MAAM,kBAAkB,CAAC;AAG3F,UAAU,SAAS;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,IAAI,CAAC,EAAE,SAAS,GAAG,SAAS,GAAG,SAAS,CAAC;CAC1C;AAED,UAAU,UAAU;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,OAAO,CAAC;IACnB,MAAM,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC7B,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC3B;AAID,eAAO,MAAM,QAAQ,EAAE,IAAI,CAAC,SAAS,EAAE,UAAU,CAuLhD,CAAC"}

package/dist/read.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../src/read.ts", "../src/_util.ts"],
-  "sourcesContent": ["import * as fs from 'node:fs/promises';\nimport { type Tool, FsError, toErrorMessage, ToolValidationError } from '@wrongstack/core';\nimport { isBinaryBuffer, safeResolveReal, sha256hex } from './_util.js';\n\ninterface ReadInput {\n  path: string;\n  offset?: number | undefined;\n  limit?: number | undefined;\n  mode?: 'content' | 'summary' | undefined;\n}\n\ninterface ReadOutput {\n  text: string;\n  total_lines: number;\n  encoding: string;\n  truncated: boolean;\n  cached?: boolean | undefined;\n  note?: string | undefined;\n}\n\nconst MAX_BYTES = 5 * 1024 * 1024;\n\nexport const readTool: Tool<ReadInput, ReadOutput> = {\n  name: 'read',\n  category: 'Filesystem',\n  description:\n    'Read the contents of a file with line numbers. This is the primary way to inspect source code, configuration, or any text file before making changes. ' +\n    'Lines are returned 1-indexed with a `   N| ` prefix for easy reference in edits.',\n  usageHint:\n    'FOUNDATIONAL TOOL \u2014 call this before almost any edit operation.\\n\\n' +\n    'Best practices:\\n' +\n    '- Always read a file before using `edit`, `replace`, or `write` on it (the system often requires it for safety).\\n' +\n    '- Use `offset` + `limit` for very large files instead of reading everything at once.\\n' +\n    '- Default limit is generous (2000 lines) but can be increased.\\n' +\n    '- The output format is designed to be directly usable as context for `edit` operations.',\n  selection: {\n    doNotUseWhen: 'you need to search many files for matching content.',\n    useInstead: ['grep'],\n  },\n  permission: 'auto',\n  mutating: false,\n  capabilities: ['fs.read'],\n  icon: 'file',\n  maxOutputBytes: 262_144,\n  timeoutMs: 5_000,\n  inputSchema: {\n    type: 'object',\n    properties: {\n      path: {\n        type: 'string',\n        description: 'Path to the file (relative to project root or absolute within project).',\n      },\n      offset: {\n        type: 'integer',\n        description: '1-based starting line number. Use together with `limit` for large files.',\n      },\n      limit: {\n        type: 'integer',\n        description: 'Maximum number of lines to return (default is 2000).',\n      },\n      mode: {\n        type: 'string',\n        enum: ['content', 'summary'],\n        description:\n          'Return full line-numbered content (default) or a compact file summary with imports/exports/symbols.',\n      },\n    },\n    required: ['path'],\n  },\n  async execute(input, ctx) {\n    if (!input?.path) {\n      throw new ToolValidationError({\n        message: 'read: path is required',\n        field: 'path',\n      });\n    }\n    const absPath = await safeResolveReal(input.path, ctx);\n\n    let stat: Awaited<ReturnType<typeof fs.stat>>;\n    try {\n      stat = await fs.stat(absPath);\n    } catch (err) {\n      const code = (err as NodeJS.ErrnoException).code;\n      if (code === 'ENOENT') {\n        throw new FsError({\n          message: `read: file not found \"${input.path}\"`,\n          code: 'FS_READ_FAILED',\n          path: absPath,\n          context: { errno: 'ENOENT' },\n        });\n      }\n      throw new FsError({\n        message: `read: failed to stat \"${input.path}\": ${toErrorMessage(err)}`,\n        code: 'FS_READ_FAILED',\n        path: absPath,\n        context: { errno: code },\n        cause: err,\n      });\n    }\n    if (!stat.isFile()) {\n      throw new FsError({\n        message: `read: \"${input.path}\" is not a regular file`,\n        code: 'FS_READ_FAILED',\n        path: absPath,\n        context: { reason: 'not-a-regular-file' },\n      });\n    }\n    if (stat.size > MAX_BYTES) {\n      throw new FsError({\n        message: `read: file too large (${stat.size} bytes, limit ${MAX_BYTES})`,\n        code: 'FS_READ_FAILED',\n        path: absPath,\n        context: { size: stat.size, limit: MAX_BYTES, reason: 'too-large' },\n      });\n    }\n\n    const offset = Math.max(1, input.offset ?? 1);\n    const limit = Math.max(0, Math.min(input.limit ?? 2000, 5000));\n    const prior = getReadRangeRecord(ctx, absPath);\n    const requestedEnd = prior\n      ? Math.min(offset + limit - 1, prior.totalLines)\n      : offset + limit - 1;\n    if (\n      input.mode !== 'summary' &&\n      limit > 0 &&\n      prior &&\n      coversRange(prior, stat.mtimeMs, offset, requestedEnd)\n    ) {\n      ctx.recordRead(absPath, stat.mtimeMs);\n      return {\n        text:\n          `[unchanged since previous read: \"${input.path}\" mtime=${Math.round(stat.mtimeMs)}; ` +\n          `requested lines ${offset}-${requestedEnd} were already shown. Use offset/limit for a new range if needed.]`,\n        total_lines: prior.totalLines,\n        encoding: 'utf8',\n        truncated: requestedEnd < prior.totalLines,\n        cached: true,\n        note: 'Repeated read suppressed to save tokens.',\n      };\n    }\n\n    const buf = await fs.readFile(absPath);\n    if (isBinaryBuffer(buf)) {\n      throw new Error(`read: \"${input.path}\" appears to be binary`);\n    }\n\n    const text = buf.toString('utf8');\n    // Content hash recorded alongside the mtime: `edit` uses it as the\n    // authoritative staleness check (mtime alone has a 2 s tolerance window\n    // on Windows). The full file is read even for offset/limit slices, so\n    // the hash always covers the whole content.\n    const contentHash = sha256hex(text);\n    const allLines = text.split(/\\r\\n|\\r|\\n/);\n    const total = allLines.length;\n    if (input.mode === 'summary') {\n      ctx.recordRead(absPath, stat.mtimeMs, 'user', contentHash);\n      rememberReadRange(ctx, absPath, stat.mtimeMs, total, 1, Math.min(total, 200));\n      return {\n        text: summarizeFile(input.path, stat.size, allLines),\n        total_lines: total,\n        encoding: 'utf8',\n        truncated: total > 200,\n        note: 'Summary mode returned compact structure instead of full file content.',\n      };\n    }\n    if (limit === 0) {\n      ctx.recordRead(absPath, stat.mtimeMs, 'user', contentHash);\n      rememberReadRange(ctx, absPath, stat.mtimeMs, total, 1, 0);\n      return { text: '', total_lines: total, encoding: 'utf8', truncated: total > 0 };\n    }\n    // Offset past EOF: return an explicit message instead of an empty string.\n    // Without this, models with weak instruction-following (e.g. k2p7) see an\n    // empty result, assume the read failed transiently, and retry the exact\n    // same offset indefinitely \u2014 a tight tool-use loop that burns iterations\n    // and context without making progress.\n    if (offset > total) {\n      ctx.recordRead(absPath, stat.mtimeMs, 'user', contentHash);\n      rememberReadRange(ctx, absPath, stat.mtimeMs, total, total + 1, total + 1);\n      return {\n        text: `[offset ${offset} is past end of file \"${input.path}\" \u2014 file has ${total} line(s). Do not retry this offset.]`,\n        total_lines: total,\n        encoding: 'utf8',\n        truncated: false,\n      };\n    }\n\n    const slice = allLines.slice(offset - 1, offset - 1 + limit);\n    const truncated = offset - 1 + slice.length < total;\n\n    const width = String(offset + slice.length - 1).length;\n    const numbered = slice\n      .map((line, i) => `${String(offset + i).padStart(width, ' ')}\u2192${line}`)\n      .join('\\n');\n\n    ctx.recordRead(absPath, stat.mtimeMs, 'user', contentHash);\n    rememberReadRange(ctx, absPath, stat.mtimeMs, total, offset, offset + slice.length - 1);\n\n    return {\n      text: numbered,\n      total_lines: total,\n      encoding: 'utf8',\n      truncated,\n    };\n  },\n};\n\ninterface ReadRangeRecord {\n  mtimeMs: number;\n  totalLines: number;\n  ranges: Array<{ start: number; end: number }>;\n}\n\nconst READ_RANGES_META_KEY = 'tools.read.ranges.v1';\n\nfunction getReadRanges(ctx: import('@wrongstack/core').Context): Record<string, ReadRangeRecord> {\n  const existing = ctx.meta[READ_RANGES_META_KEY];\n  if (existing && typeof existing === 'object' && !Array.isArray(existing)) {\n    return existing as Record<string, ReadRangeRecord>;\n  }\n  const next: Record<string, ReadRangeRecord> = {};\n  ctx.meta[READ_RANGES_META_KEY] = next;\n  return next;\n}\n\nfunction getReadRangeRecord(\n  ctx: import('@wrongstack/core').Context,\n  absPath: string,\n): ReadRangeRecord | undefined {\n  return getReadRanges(ctx)[absPath];\n}\n\nfunction rememberReadRange(\n  ctx: import('@wrongstack/core').Context,\n  absPath: string,\n  mtimeMs: number,\n  totalLines: number,\n  start: number,\n  end: number,\n): void {\n  if (end < start) return;\n  const ranges = getReadRanges(ctx);\n  const prior = ranges[absPath];\n  const nextRanges = prior && Math.abs(prior.mtimeMs - mtimeMs) <= 1 ? prior.ranges.slice() : [];\n  nextRanges.push({ start, end });\n  ranges[absPath] = {\n    mtimeMs,\n    totalLines,\n    ranges: mergeRanges(nextRanges),\n  };\n}\n\nfunction coversRange(\n  record: ReadRangeRecord,\n  mtimeMs: number,\n  start: number,\n  end: number,\n): boolean {\n  if (Math.abs(record.mtimeMs - mtimeMs) > 1) return false;\n  return record.ranges.some((range) => range.start <= start && range.end >= end);\n}\n\nfunction mergeRanges(\n  ranges: Array<{ start: number; end: number }>,\n): Array<{ start: number; end: number }> {\n  const sorted = ranges.slice().sort((a, b) => a.start - b.start);\n  const merged: Array<{ start: number; end: number }> = [];\n  for (const range of sorted) {\n    const last = merged[merged.length - 1];\n    if (!last || range.start > last.end + 1) {\n      merged.push({ ...range });\n      continue;\n    }\n    last.end = Math.max(last.end, range.end);\n  }\n  return merged;\n}\n\nfunction summarizeFile(filePath: string, bytes: number, lines: string[]): string {\n  const interesting = lines\n    .map((line, index) => ({ line: line.trim(), number: index + 1 }))\n    .filter(({ line }) =>\n      /^(import\\s|export\\s|class\\s|interface\\s|type\\s|function\\s|const\\s+\\w+\\s*=|let\\s+\\w+\\s*=|var\\s+\\w+\\s*=|def\\s+|async\\s+function\\s)/.test(\n        line,\n      ),\n    )\n    .slice(0, 80)\n    .map(({ line, number }) => `${number}: ${line}`);\n  return [\n    `summary: ${filePath}`,\n    `bytes=${bytes}`,\n    `total_lines=${lines.length}`,\n    interesting.length > 0\n      ? `symbols/imports:\\n${interesting.join('\\n')}`\n      : 'symbols/imports: (none detected)',\n  ].join('\\n');\n}\n", "import { createHash } from 'node:crypto';\nimport * as fsp from 'node:fs/promises';\nimport * as path from 'node:path';\nimport * as Core from '@wrongstack/core';\nimport type { Context } from '@wrongstack/core';\n\n/**\n * sha-256 hex of a UTF-8 string. Used by the file tools to record a content\n * hash alongside the mtime in `ctx.recordRead` \u2014 the hash is the authoritative\n * staleness arbiter for `edit` (mtime has a 2 s tolerance window on Windows).\n */\nexport function sha256hex(content: string): string {\n  return createHash('sha256').update(content, 'utf8').digest('hex');\n}\n/** Detected package manager for a project directory. */\nexport type PackageManager = 'pnpm' | 'yarn' | 'npm';\n\n/**\n * Detect the project's package manager by inspecting lockfiles in `cwd`.\n * Order: pnpm \u2192 yarn \u2192 npm (default). Missing or unreadable directories fall\n * back to `npm` rather than throwing, so a `safeResolve`-checked cwd that\n * happens to be empty never aborts the tool.\n */\nexport async function detectPackageManager(cwd: string): Promise<PackageManager> {\n  const { stat } = await import('node:fs/promises');\n  try {\n    await stat(`${cwd}/pnpm-lock.yaml`);\n    return 'pnpm';\n  } catch {\n    /* not pnpm */\n  }\n  try {\n    await stat(`${cwd}/yarn.lock`);\n    return 'yarn';\n  } catch {\n    /* not yarn */\n  }\n  return 'npm';\n}\n\nexport function resolvePath(input: string, ctx: Context): string {\n  return path.isAbsolute(input) ? path.normalize(input) : path.resolve(ctx.workingDir ?? ctx.cwd, input);\n}\n\n/**\n * Roots every file tool may always reach, even in restricted mode: the\n * project root and the user-global `~/.wrongstack` directory (config, memory,\n * sessions, skills). `~/.wrongstack` honors the `WRONGSTACK_HOME` override.\n */\nfunction allowedRoots(ctx: Context): string[] {\n  return [path.resolve(ctx.projectRoot), path.resolve(Core.wstackGlobalRoot())];\n}\n\n/** True if `target` is `root` itself or nested inside any of `roots`. */\nfunction isInsideAny(target: string, roots: string[]): boolean {\n  return roots.some((root) => {\n    const rel = path.relative(root, target);\n    return rel === '' || (!rel.startsWith('..') && !path.isAbsolute(rel));\n  });\n}\n\nexport function ensureInsideRoot(absPath: string, ctx: Context): string {\n  const target = path.resolve(absPath);\n  // Unrestricted filesystem access: skip the project-root containment check.\n  if (ctx.allowOutsideProjectRoot) return target;\n  if (isInsideAny(target, allowedRoots(ctx))) return target;\n  throw new Error(`Path \"${absPath}\" is outside project root \"${path.resolve(ctx.projectRoot)}\"`);\n}\n\nexport function safeResolve(input: string, ctx: Context): string {\n  return ensureInsideRoot(resolvePath(input, ctx), ctx);\n}\n\n/**\n * Defense against in-root\u2192out-of-root symlink escape (CWE-59). `safeResolve`\n * only does a syntactic `../` check, so a symlink that lives *inside* the\n * project root but points outside still passes it. This resolves the path\n * through `fs.realpath` and re-verifies containment against the realpath of\n * the project root (comparing like-for-like, since the root itself may be a\n * symlink \u2014 macOS `/var`\u2192`/private/var`, Windows 8.3 short names). For a path\n * that does not exist yet (e.g. a `write` to a new file) the nearest existing\n * ancestor directory is checked instead. Throws if the real target escapes.\n *\n * Mirrors the per-file guard already used in `replace.ts`/`grep.ts`; applied\n * to single-file `read`/`edit`/`write` it throws (rather than skips) because\n * the caller named exactly one file.\n */\nexport async function assertRealInsideRoot(absPath: string, ctx: Context): Promise<void> {\n  // Unrestricted filesystem access: no symlink-escape check to perform.\n  if (ctx.allowOutsideProjectRoot) return;\n  // Compare like-for-like against the realpath of each always-allowed root\n  // (project root + ~/.wrongstack), since a root may itself be a symlink.\n  const realRoots = await Promise.all(\n    allowedRoots(ctx).map((r) => fsp.realpath(r).catch(() => path.resolve(r))),\n  );\n  let probe = absPath;\n  for (;;) {\n    let real: string;\n    try {\n      real = await fsp.realpath(probe);\n    } catch (err) {\n      if ((err as NodeJS.ErrnoException).code === 'ENOENT') {\n        const parent = path.dirname(probe);\n        if (parent === probe) return; // reached fs root without escaping\n        probe = parent;\n        continue;\n      }\n      throw err;\n    }\n    if (isInsideAny(real, realRoots)) return;\n    throw new Error(\n      `Path \"${absPath}\" resolves through a symlink outside project root \"${realRoots[0]}\"`,\n    );\n  }\n}\n\n/** `safeResolve` + symlink realpath containment check. Async. */\nexport async function safeResolveReal(input: string, ctx: Context): Promise<string> {\n  const abs = safeResolve(input, ctx);\n  await assertRealInsideRoot(abs, ctx);\n  return abs;\n}\n\nexport function truncateMiddle(s: string, max: number): string {\n  if (Buffer.byteLength(s, 'utf8') <= max) return s;\n  const half = Math.floor(max / 2);\n  return (\n    s.slice(0, half) +\n    `\\n\u2026[truncated ${Buffer.byteLength(s, 'utf8') - max} bytes from middle]\u2026\\n` +\n    s.slice(-half)\n  );\n}\n\nexport function isBinaryBuffer(buf: Buffer): boolean {\n  const len = Math.min(buf.length, 8192);\n  for (let i = 0; i < len; i++) {\n    if (buf[i] === 0) return true;\n  }\n  return false;\n}\n\n// \u2500\u2500\u2500 Command-output normalization (token-saving) \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n//\n// Raw process output is full of tokens the model gains nothing from: ANSI\n// escapes, carriage-return progress spam, runs of identical warning lines, and\n// huge tails of build noise. These helpers strip that noise before the output\n// reaches the LLM. They are scoped to COMMAND tools (bash/git/exec and the\n// _spawn-stream consumers) \u2014 never applied to structured/code outputs.\n\n/** Unified byte cap for all command tool output fed to the model. */\nexport const COMMAND_OUTPUT_MAX_BYTES = 32_768;\n\n/** Runs of >= this many identical consecutive lines are collapsed. */\nconst REPEAT_RUN_THRESHOLD = 3;\n\n/**\n * Collapse carriage-return overwrites the way a terminal would: `\\r\\n` becomes\n * `\\n`, and a bare `\\r` (progress redraw) keeps only the text after the LAST\n * `\\r` on its physical line. Without this, a single progress bar that redraws\n * 200 times explodes into 200 lines.\n */\nexport function collapseCarriageReturns(text: string): string {\n  const lf = text.replace(/\\r\\n/g, '\\n');\n  if (!lf.includes('\\r')) return lf;\n  return lf\n    .split('\\n')\n    .map((line) => (line.includes('\\r') ? line.slice(line.lastIndexOf('\\r') + 1) : line))\n    .join('\\n');\n}\n\n/**\n * Collapse a run of `minRun`+ identical consecutive lines into the line once\n * plus a marker. Consecutive-only \u2014 it never reorders or dedups non-adjacent\n * lines, so diffs/source stay intact.\n */\nexport function collapseConsecutiveDuplicates(text: string, minRun = REPEAT_RUN_THRESHOLD): string {\n  const lines = text.split('\\n');\n  const out: string[] = [];\n  let i = 0;\n  while (i < lines.length) {\n    let j = i + 1;\n    while (j < lines.length && lines[j] === lines[i]) j++;\n    const run = j - i;\n    if (run >= minRun) {\n      out.push(lines[i]!, `\u2026 \u27E8repeated ${run}\u00D7\u27E9`);\n    } else {\n      for (let k = i; k < j; k++) out.push(lines[k]!);\n    }\n    i = j;\n  }\n  return out.join('\\n');\n}\n\n/** Largest prefix of `s` whose UTF-8 byte length is <= `maxBytes`. */\nfunction takeHeadBytes(s: string, maxBytes: number): string {\n  if (maxBytes <= 0) return '';\n  /* v8 ignore next -- only caller (truncateHeadTail) passes a budget smaller than s; defensive. */\n  if (Buffer.byteLength(s, 'utf8') <= maxBytes) return s;\n  let lo = 0;\n  let hi = s.length;\n  while (lo < hi) {\n    const mid = Math.ceil((lo + hi) / 2);\n    if (Buffer.byteLength(s.slice(0, mid), 'utf8') <= maxBytes) lo = mid;\n    else hi = mid - 1;\n  }\n  return s.slice(0, lo);\n}\n\n/** Largest suffix of `s` whose UTF-8 byte length is <= `maxBytes`. */\nfunction takeTailBytes(s: string, maxBytes: number): string {\n  if (maxBytes <= 0) return '';\n  /* v8 ignore next -- only caller (truncateHeadTail) passes a budget smaller than s; defensive. */\n  if (Buffer.byteLength(s, 'utf8') <= maxBytes) return s;\n  let lo = 0;\n  let hi = s.length;\n  while (lo < hi) {\n    const mid = Math.ceil((lo + hi) / 2);\n    if (Buffer.byteLength(s.slice(s.length - mid), 'utf8') <= maxBytes) lo = mid;\n    else hi = mid - 1;\n  }\n  return s.slice(s.length - lo);\n}\n\n/**\n * Truncate to `maxBytes` keeping BOTH ends \u2014 the head (what ran / early context)\n * and the tail (errors and summaries usually land last), biased ~45/55 toward\n * the tail. The result never exceeds `maxBytes`.\n */\nexport function truncateHeadTail(s: string, maxBytes: number): string {\n  const total = Buffer.byteLength(s, 'utf8');\n  if (total <= maxBytes) return s;\n  // Reserve a fixed allowance for the marker so the final string can't exceed\n  // the cap even though the dropped-byte count's digit width varies.\n  const MARKER_RESERVE = 64;\n  const avail = Math.max(0, maxBytes - MARKER_RESERVE);\n  const headBudget = Math.floor(avail * 0.45);\n  const head = takeHeadBytes(s, headBudget);\n  const tail = takeTailBytes(s, avail - Buffer.byteLength(head, 'utf8'));\n  const kept = Buffer.byteLength(head, 'utf8') + Buffer.byteLength(tail, 'utf8');\n  return `${head}\\n\u2026[truncated ${total - kept} bytes]\u2026\\n${tail}`;\n}\n\n/**\n * Full token-saving pipeline for command tool output: strip ANSI \u2192 collapse\n * carriage-return progress \u2192 trim trailing whitespace \u2192 collapse identical\n * consecutive lines \u2192 squeeze blank-line runs \u2192 head+tail truncate to the cap.\n */\nexport function normalizeCommandOutput(\n  raw: string,\n  opts: { maxBytes?: number | undefined } = {},\n): string {\n  if (!raw) return raw;\n  let text = Core.stripAnsi(raw);\n  text = collapseCarriageReturns(text);\n  text = text.replace(/[ \\t]+$/gm, ''); // trailing whitespace per line\n  text = collapseConsecutiveDuplicates(text);\n  text = text.replace(/\\n{3,}/g, '\\n\\n'); // >=2 blank lines \u2192 1\n  return truncateHeadTail(text, opts.maxBytes ?? COMMAND_OUTPUT_MAX_BYTES);\n}\n"],
-  "mappings": "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",
+  "sourcesContent": ["import * as fs from 'node:fs/promises';\nimport { type Tool, FsError, toErrorMessage, ToolValidationError } from '@wrongstack/core';\nimport { isBinaryBuffer, safeResolveReal, sha256hex } from './_util.js';\n\ninterface ReadInput {\n  path: string;\n  offset?: number | undefined;\n  limit?: number | undefined;\n  mode?: 'content' | 'summary' | undefined;\n}\n\ninterface ReadOutput {\n  text: string;\n  total_lines: number;\n  encoding: string;\n  truncated: boolean;\n  cached?: boolean | undefined;\n  note?: string | undefined;\n}\n\nconst MAX_BYTES = 5 * 1024 * 1024;\n\nexport const readTool: Tool<ReadInput, ReadOutput> = {\n  name: 'read',\n  category: 'Filesystem',\n  description:\n    'Read the contents of a file with line numbers. This is the primary way to inspect source code, configuration, or any text file before making changes. ' +\n    'Lines are returned 1-indexed with a `   N| ` prefix for easy reference in edits.',\n  usageHint:\n    'FOUNDATIONAL TOOL \u2014 call this before almost any edit operation.\\n\\n' +\n    'Best practices:\\n' +\n    '- Always read a file before using `edit`, `replace`, or `write` on it (the system often requires it for safety).\\n' +\n    '- Use `offset` + `limit` for very large files instead of reading everything at once.\\n' +\n    '- Default limit is generous (2000 lines) but can be increased.\\n' +\n    '- The output format is designed to be directly usable as context for `edit` operations.',\n  selection: {\n    doNotUseWhen: 'you need to search many files for matching content.',\n    useInstead: ['grep'],\n  },\n  permission: 'auto',\n  mutating: false,\n  capabilities: ['fs.read'],\n  icon: 'file',\n  maxOutputBytes: 262_144,\n  timeoutMs: 5_000,\n  inputSchema: {\n    type: 'object',\n    properties: {\n      path: {\n        type: 'string',\n        description: 'Path to the file (relative to project root or absolute within project).',\n      },\n      offset: {\n        type: 'integer',\n        description: '1-based starting line number. Use together with `limit` for large files.',\n      },\n      limit: {\n        type: 'integer',\n        description: 'Maximum number of lines to return (default is 2000).',\n      },\n      mode: {\n        type: 'string',\n        enum: ['content', 'summary'],\n        description:\n          'Return full line-numbered content (default) or a compact file summary with imports/exports/symbols.',\n      },\n    },\n    required: ['path'],\n  },\n  async execute(input, ctx) {\n    if (!input?.path) {\n      throw new ToolValidationError({\n        message: 'read: path is required',\n        field: 'path',\n      });\n    }\n    const absPath = await safeResolveReal(input.path, ctx);\n\n    let stat: Awaited<ReturnType<typeof fs.stat>>;\n    try {\n      stat = await fs.stat(absPath);\n    } catch (err) {\n      const code = (err as NodeJS.ErrnoException).code;\n      if (code === 'ENOENT') {\n        throw new FsError({\n          message: `read: file not found \"${input.path}\"`,\n          code: 'FS_READ_FAILED',\n          path: absPath,\n          context: { errno: 'ENOENT' },\n        });\n      }\n      throw new FsError({\n        message: `read: failed to stat \"${input.path}\": ${toErrorMessage(err)}`,\n        code: 'FS_READ_FAILED',\n        path: absPath,\n        context: { errno: code },\n        cause: err,\n      });\n    }\n    if (!stat.isFile()) {\n      throw new FsError({\n        message: `read: \"${input.path}\" is not a regular file`,\n        code: 'FS_READ_FAILED',\n        path: absPath,\n        context: { reason: 'not-a-regular-file' },\n      });\n    }\n    if (stat.size > MAX_BYTES) {\n      throw new FsError({\n        message: `read: file too large (${stat.size} bytes, limit ${MAX_BYTES})`,\n        code: 'FS_READ_FAILED',\n        path: absPath,\n        context: { size: stat.size, limit: MAX_BYTES, reason: 'too-large' },\n      });\n    }\n\n    const offset = Math.max(1, input.offset ?? 1);\n    const limit = Math.max(0, Math.min(input.limit ?? 2000, 5000));\n    const prior = getReadRangeRecord(ctx, absPath);\n    const requestedEnd = prior\n      ? Math.min(offset + limit - 1, prior.totalLines)\n      : offset + limit - 1;\n    if (\n      input.mode !== 'summary' &&\n      limit > 0 &&\n      prior &&\n      coversRange(prior, stat.mtimeMs, offset, requestedEnd)\n    ) {\n      ctx.recordRead(absPath, stat.mtimeMs);\n      return {\n        text:\n          `[unchanged since previous read: \"${input.path}\" mtime=${Math.round(stat.mtimeMs)}; ` +\n          `requested lines ${offset}-${requestedEnd} were already shown. Use offset/limit for a new range if needed.]`,\n        total_lines: prior.totalLines,\n        encoding: 'utf8',\n        truncated: requestedEnd < prior.totalLines,\n        cached: true,\n        note: 'Repeated read suppressed to save tokens.',\n      };\n    }\n\n    const buf = await fs.readFile(absPath);\n    if (isBinaryBuffer(buf)) {\n      throw new Error(`read: \"${input.path}\" appears to be binary`);\n    }\n\n    const text = buf.toString('utf8');\n    // Content hash recorded alongside the mtime: `edit` uses it as the\n    // authoritative staleness check (mtime alone has a 2 s tolerance window\n    // on Windows). The full file is read even for offset/limit slices, so\n    // the hash always covers the whole content.\n    const contentHash = sha256hex(text);\n    const allLines = text.split(/\\r\\n|\\r|\\n/);\n    const total = allLines.length;\n\n    if (input.mode === 'summary') {\n      ctx.recordRead(absPath, stat.mtimeMs, 'user', contentHash);\n      rememberReadRange(ctx, absPath, stat.mtimeMs, total, 1, Math.min(total, 200));\n      return {\n        text: summarizeFile(input.path, stat.size, allLines),\n        total_lines: total,\n        encoding: 'utf8',\n        truncated: total > 200,\n        note: 'Summary mode returned compact structure instead of full file content.',\n      };\n    }\n    if (limit === 0) {\n      ctx.recordRead(absPath, stat.mtimeMs, 'user', contentHash);\n      rememberReadRange(ctx, absPath, stat.mtimeMs, total, 1, 0);\n      return { text: '', total_lines: total, encoding: 'utf8', truncated: total > 0 };\n    }\n    // Offset past EOF: return an explicit message instead of an empty string.\n    // Without this, models with weak instruction-following (e.g. k2p7) see an\n    // empty result, assume the read failed transiently, and retry the exact\n    // same offset indefinitely \u2014 a tight tool-use loop that burns iterations\n    // and context without making progress.\n    if (offset > total) {\n      ctx.recordRead(absPath, stat.mtimeMs, 'user', contentHash);\n      rememberReadRange(ctx, absPath, stat.mtimeMs, total, total + 1, total + 1);\n      return {\n        text: `[offset ${offset} is past end of file \"${input.path}\" \u2014 file has ${total} line(s). Do not retry this offset.]`,\n        total_lines: total,\n        encoding: 'utf8',\n        truncated: false,\n      };\n    }\n\n    const slice = allLines.slice(offset - 1, offset - 1 + limit);\n    const truncated = offset - 1 + slice.length < total;\n\n    const width = String(offset + slice.length - 1).length;\n    const numbered = slice\n      .map((line, i) => `${String(offset + i).padStart(width, ' ')}\u2192${line}`)\n      .join('\\n');\n\n    ctx.recordRead(absPath, stat.mtimeMs, 'user', contentHash);\n    rememberReadRange(ctx, absPath, stat.mtimeMs, total, offset, offset + slice.length - 1);\n\n    return {\n      text: numbered,\n      total_lines: total,\n      encoding: 'utf8',\n      truncated,\n    };\n  },\n};\n\ninterface ReadRangeRecord {\n  mtimeMs: number;\n  totalLines: number;\n  ranges: Array<{ start: number; end: number }>;\n}\n\nconst READ_RANGES_META_KEY = 'tools.read.ranges.v1';\n\nfunction getReadRanges(ctx: import('@wrongstack/core').Context): Record<string, ReadRangeRecord> {\n  const existing = ctx.meta[READ_RANGES_META_KEY];\n  if (existing && typeof existing === 'object' && !Array.isArray(existing)) {\n    return existing as Record<string, ReadRangeRecord>;\n  }\n  const next: Record<string, ReadRangeRecord> = {};\n  ctx.meta[READ_RANGES_META_KEY] = next;\n  return next;\n}\n\nfunction getReadRangeRecord(\n  ctx: import('@wrongstack/core').Context,\n  absPath: string,\n): ReadRangeRecord | undefined {\n  return getReadRanges(ctx)[absPath];\n}\n\nfunction rememberReadRange(\n  ctx: import('@wrongstack/core').Context,\n  absPath: string,\n  mtimeMs: number,\n  totalLines: number,\n  start: number,\n  end: number,\n): void {\n  if (end < start) return;\n  const ranges = getReadRanges(ctx);\n  const prior = ranges[absPath];\n  const nextRanges = prior && Math.abs(prior.mtimeMs - mtimeMs) <= 1 ? prior.ranges.slice() : [];\n  nextRanges.push({ start, end });\n  ranges[absPath] = {\n    mtimeMs,\n    totalLines,\n    ranges: mergeRanges(nextRanges),\n  };\n}\n\nfunction coversRange(\n  record: ReadRangeRecord,\n  mtimeMs: number,\n  start: number,\n  end: number,\n): boolean {\n  if (Math.abs(record.mtimeMs - mtimeMs) > 1) return false;\n  return record.ranges.some((range) => range.start <= start && range.end >= end);\n}\n\nfunction mergeRanges(\n  ranges: Array<{ start: number; end: number }>,\n): Array<{ start: number; end: number }> {\n  const sorted = ranges.slice().sort((a, b) => a.start - b.start);\n  const merged: Array<{ start: number; end: number }> = [];\n  for (const range of sorted) {\n    const last = merged[merged.length - 1];\n    if (!last || range.start > last.end + 1) {\n      merged.push({ ...range });\n      continue;\n    }\n    last.end = Math.max(last.end, range.end);\n  }\n  return merged;\n}\n\nfunction summarizeFile(filePath: string, bytes: number, lines: string[]): string {\n  const interesting = lines\n    .map((line, index) => ({ line: line.trim(), number: index + 1 }))\n    .filter(({ line }) =>\n      /^(import\\s|export\\s|class\\s|interface\\s|type\\s|function\\s|const\\s+\\w+\\s*=|let\\s+\\w+\\s*=|var\\s+\\w+\\s*=|def\\s+|async\\s+function\\s)/.test(\n        line,\n      ),\n    )\n    .slice(0, 80)\n    .map(({ line, number }) => `${number}: ${line}`);\n  return [\n    `summary: ${filePath}`,\n    `bytes=${bytes}`,\n    `total_lines=${lines.length}`,\n    interesting.length > 0\n      ? `symbols/imports:\\n${interesting.join('\\n')}`\n      : 'symbols/imports: (none detected)',\n  ].join('\\n');\n}\n", "import { createHash } from 'node:crypto';\nimport * as fsp from 'node:fs/promises';\nimport * as path from 'node:path';\nimport * as Core from '@wrongstack/core';\nimport type { Context } from '@wrongstack/core';\n\n/**\n * sha-256 hex of a UTF-8 string. Used by the file tools to record a content\n * hash alongside the mtime in `ctx.recordRead` \u2014 the hash is the authoritative\n * staleness arbiter for `edit` (mtime has a 2 s tolerance window on Windows).\n */\nexport function sha256hex(content: string): string {\n  return createHash('sha256').update(content, 'utf8').digest('hex');\n}\n/** Detected package manager for a project directory. */\nexport type PackageManager = 'pnpm' | 'yarn' | 'npm';\n\n/**\n * Detect the project's package manager by inspecting lockfiles in `cwd`.\n * Order: pnpm \u2192 yarn \u2192 npm (default). Missing or unreadable directories fall\n * back to `npm` rather than throwing, so a `safeResolve`-checked cwd that\n * happens to be empty never aborts the tool.\n */\nexport async function detectPackageManager(cwd: string): Promise<PackageManager> {\n  const { stat } = await import('node:fs/promises');\n  try {\n    await stat(`${cwd}/pnpm-lock.yaml`);\n    return 'pnpm';\n  } catch {\n    /* not pnpm */\n  }\n  try {\n    await stat(`${cwd}/yarn.lock`);\n    return 'yarn';\n  } catch {\n    /* not yarn */\n  }\n  return 'npm';\n}\n\nexport function resolvePath(input: string, ctx: Context): string {\n  return path.isAbsolute(input) ? path.normalize(input) : path.resolve(ctx.workingDir ?? ctx.cwd, input);\n}\n\n/**\n * Roots every file tool may always reach, even in restricted mode: the\n * project root and the user-global `~/.wrongstack` directory (config, memory,\n * sessions, skills). `~/.wrongstack` honors the `WRONGSTACK_HOME` override.\n */\nfunction allowedRoots(ctx: Context): string[] {\n  return [path.resolve(ctx.projectRoot), path.resolve(Core.wstackGlobalRoot())];\n}\n\n/** True if `target` is `root` itself or nested inside any of `roots`. */\nfunction isInsideAny(target: string, roots: string[]): boolean {\n  return roots.some((root) => {\n    const rel = path.relative(root, target);\n    return rel === '' || (!rel.startsWith('..') && !path.isAbsolute(rel));\n  });\n}\n\nexport function ensureInsideRoot(absPath: string, ctx: Context): string {\n  const target = path.resolve(absPath);\n  // Unrestricted filesystem access: skip the project-root containment check.\n  if (ctx.allowOutsideProjectRoot) return target;\n  if (isInsideAny(target, allowedRoots(ctx))) return target;\n  throw new Error(`Path \"${absPath}\" is outside project root \"${path.resolve(ctx.projectRoot)}\"`);\n}\n\nexport function safeResolve(input: string, ctx: Context): string {\n  return ensureInsideRoot(resolvePath(input, ctx), ctx);\n}\n\n/**\n * Defense against in-root\u2192out-of-root symlink escape (CWE-59). `safeResolve`\n * only does a syntactic `../` check, so a symlink that lives *inside* the\n * project root but points outside still passes it. This resolves the path\n * through `fs.realpath` and re-verifies containment against the realpath of\n * the project root (comparing like-for-like, since the root itself may be a\n * symlink \u2014 macOS `/var`\u2192`/private/var`, Windows 8.3 short names). For a path\n * that does not exist yet (e.g. a `write` to a new file) the nearest existing\n * ancestor directory is checked instead. Throws if the real target escapes.\n *\n * Mirrors the per-file guard already used in `replace.ts`/`grep.ts`; applied\n * to single-file `read`/`edit`/`write` it throws (rather than skips) because\n * the caller named exactly one file.\n */\nexport async function assertRealInsideRoot(absPath: string, ctx: Context): Promise<void> {\n  // Unrestricted filesystem access: no symlink-escape check to perform.\n  if (ctx.allowOutsideProjectRoot) return;\n  // Compare like-for-like against the realpath of each always-allowed root\n  // (project root + ~/.wrongstack), since a root may itself be a symlink.\n  const realRoots = await Promise.all(\n    allowedRoots(ctx).map((r) => fsp.realpath(r).catch(() => path.resolve(r))),\n  );\n  let probe = absPath;\n  for (;;) {\n    let real: string;\n    try {\n      real = await fsp.realpath(probe);\n    } catch (err) {\n      if ((err as NodeJS.ErrnoException).code === 'ENOENT') {\n        const parent = path.dirname(probe);\n        if (parent === probe) return; // reached fs root without escaping\n        probe = parent;\n        continue;\n      }\n      throw err;\n    }\n    if (isInsideAny(real, realRoots)) return;\n    throw new Error(\n      `Path \"${absPath}\" resolves through a symlink outside project root \"${realRoots[0]}\"`,\n    );\n  }\n}\n\n/** `safeResolve` + symlink realpath containment check. Async. */\nexport async function safeResolveReal(input: string, ctx: Context): Promise<string> {\n  const abs = safeResolve(input, ctx);\n  await assertRealInsideRoot(abs, ctx);\n  return abs;\n}\n\nexport function truncateMiddle(s: string, max: number): string {\n  if (Buffer.byteLength(s, 'utf8') <= max) return s;\n  const half = Math.floor(max / 2);\n  return (\n    s.slice(0, half) +\n    `\\n\u2026[truncated ${Buffer.byteLength(s, 'utf8') - max} bytes from middle]\u2026\\n` +\n    s.slice(-half)\n  );\n}\n\nexport function isBinaryBuffer(buf: Buffer): boolean {\n  const len = Math.min(buf.length, 8192);\n  for (let i = 0; i < len; i++) {\n    if (buf[i] === 0) return true;\n  }\n  return false;\n}\n\n// \u2500\u2500\u2500 Command-output normalization (token-saving) \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n//\n// Raw process output is full of tokens the model gains nothing from: ANSI\n// escapes, carriage-return progress spam, runs of identical warning lines, and\n// huge tails of build noise. These helpers strip that noise before the output\n// reaches the LLM. They are scoped to COMMAND tools (bash/git/exec and the\n// _spawn-stream consumers) \u2014 never applied to structured/code outputs.\n\n/** Unified byte cap for all command tool output fed to the model. */\nexport const COMMAND_OUTPUT_MAX_BYTES = 32_768;\n\n/** Runs of >= this many identical consecutive lines are collapsed. */\nconst REPEAT_RUN_THRESHOLD = 3;\n\n/**\n * Collapse carriage-return overwrites the way a terminal would: `\\r\\n` becomes\n * `\\n`, and a bare `\\r` (progress redraw) keeps only the text after the LAST\n * `\\r` on its physical line. Without this, a single progress bar that redraws\n * 200 times explodes into 200 lines.\n */\nexport function collapseCarriageReturns(text: string): string {\n  const lf = text.replace(/\\r\\n/g, '\\n');\n  if (!lf.includes('\\r')) return lf;\n  return lf\n    .split('\\n')\n    .map((line) => (line.includes('\\r') ? line.slice(line.lastIndexOf('\\r') + 1) : line))\n    .join('\\n');\n}\n\n/**\n * Collapse a run of `minRun`+ identical consecutive lines into the line once\n * plus a marker. Consecutive-only \u2014 it never reorders or dedups non-adjacent\n * lines, so diffs/source stay intact.\n */\nexport function collapseConsecutiveDuplicates(text: string, minRun = REPEAT_RUN_THRESHOLD): string {\n  const lines = text.split('\\n');\n  const out: string[] = [];\n  let i = 0;\n  while (i < lines.length) {\n    let j = i + 1;\n    while (j < lines.length && lines[j] === lines[i]) j++;\n    const run = j - i;\n    if (run >= minRun) {\n      out.push(lines[i]!, `\u2026 \u27E8repeated ${run}\u00D7\u27E9`);\n    } else {\n      for (let k = i; k < j; k++) out.push(lines[k]!);\n    }\n    i = j;\n  }\n  return out.join('\\n');\n}\n\n/** Largest prefix of `s` whose UTF-8 byte length is <= `maxBytes`. */\nfunction takeHeadBytes(s: string, maxBytes: number): string {\n  if (maxBytes <= 0) return '';\n  /* v8 ignore next -- only caller (truncateHeadTail) passes a budget smaller than s; defensive. */\n  if (Buffer.byteLength(s, 'utf8') <= maxBytes) return s;\n  let lo = 0;\n  let hi = s.length;\n  while (lo < hi) {\n    const mid = Math.ceil((lo + hi) / 2);\n    if (Buffer.byteLength(s.slice(0, mid), 'utf8') <= maxBytes) lo = mid;\n    else hi = mid - 1;\n  }\n  return s.slice(0, lo);\n}\n\n/** Largest suffix of `s` whose UTF-8 byte length is <= `maxBytes`. */\nfunction takeTailBytes(s: string, maxBytes: number): string {\n  if (maxBytes <= 0) return '';\n  /* v8 ignore next -- only caller (truncateHeadTail) passes a budget smaller than s; defensive. */\n  if (Buffer.byteLength(s, 'utf8') <= maxBytes) return s;\n  let lo = 0;\n  let hi = s.length;\n  while (lo < hi) {\n    const mid = Math.ceil((lo + hi) / 2);\n    if (Buffer.byteLength(s.slice(s.length - mid), 'utf8') <= maxBytes) lo = mid;\n    else hi = mid - 1;\n  }\n  return s.slice(s.length - lo);\n}\n\n/**\n * Truncate to `maxBytes` keeping BOTH ends \u2014 the head (what ran / early context)\n * and the tail (errors and summaries usually land last), biased ~45/55 toward\n * the tail. The result never exceeds `maxBytes`.\n */\nexport function truncateHeadTail(s: string, maxBytes: number): string {\n  const total = Buffer.byteLength(s, 'utf8');\n  if (total <= maxBytes) return s;\n  // Reserve a fixed allowance for the marker so the final string can't exceed\n  // the cap even though the dropped-byte count's digit width varies.\n  const MARKER_RESERVE = 64;\n  const avail = Math.max(0, maxBytes - MARKER_RESERVE);\n  const headBudget = Math.floor(avail * 0.45);\n  const head = takeHeadBytes(s, headBudget);\n  const tail = takeTailBytes(s, avail - Buffer.byteLength(head, 'utf8'));\n  const kept = Buffer.byteLength(head, 'utf8') + Buffer.byteLength(tail, 'utf8');\n  return `${head}\\n\u2026[truncated ${total - kept} bytes]\u2026\\n${tail}`;\n}\n\n/**\n * Full token-saving pipeline for command tool output: strip ANSI \u2192 collapse\n * carriage-return progress \u2192 trim trailing whitespace \u2192 collapse identical\n * consecutive lines \u2192 squeeze blank-line runs \u2192 head+tail truncate to the cap.\n */\nexport function normalizeCommandOutput(\n  raw: string,\n  opts: { maxBytes?: number | undefined } = {},\n): string {\n  if (!raw) return raw;\n  let text = Core.stripAnsi(raw);\n  text = collapseCarriageReturns(text);\n  text = text.replace(/[ \\t]+$/gm, ''); // trailing whitespace per line\n  text = collapseConsecutiveDuplicates(text);\n  text = text.replace(/\\n{3,}/g, '\\n\\n'); // >=2 blank lines \u2192 1\n  return truncateHeadTail(text, opts.maxBytes ?? COMMAND_OUTPUT_MAX_BYTES);\n}\n"],
+  "mappings": "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",
   "names": ["stat"]
 }

package/dist/session-kanban.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"session-kanban.d.ts","sourceRoot":"","sources":["../src/session-kanban.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"session-kanban.d.ts","sourceRoot":"","sources":["../src/session-kanban.ts"],"names":[],"mappings":"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"}

package/dist/session-kanban.js

@@ -30,12 +30,17 @@ var SESSION_KANBAN_COLUMNS = [
 ];
 var boardQueue = /* @__PURE__ */ new Map();
 var boardEnsures = /* @__PURE__ */ new Map();
+var pendingMirrors = /* @__PURE__ */ new Map();
+var activeMirrors = /* @__PURE__ */ new Set();
 var bindings = /* @__PURE__ */ new WeakMap();
 var suppressedTodoMirrors = /* @__PURE__ */ new WeakSet();
 var activeSessionBoards = /* @__PURE__ */ new Map();
 function boardKey(projectRoot, sessionId) {
   return `${projectRoot}\0${sessionId}`;
 }
+function mirrorKey(projectRoot, sessionId, sourceSystem) {
+  return `${boardKey(projectRoot, sessionId)}\0${sourceSystem}`;
+}
 function sessionTag(sessionId) {
   return `session:${sessionId}`;
 }
@@ -171,6 +176,43 @@ async function projectGraph(projectRoot, sessionId, graph, sourceSystem) {
     return result?.board ?? null;
   });
 }
+function queueLatestMirror(projectRoot, sessionId, graph, sourceSystem) {
+  if (!projectRoot || !sessionId || process.env[MIRROR_DISABLED_ENV] === "0") return;
+  const key = mirrorKey(projectRoot, sessionId, sourceSystem);
+  pendingMirrors.set(key, { projectRoot, sessionId, graph, sourceSystem });
+  if (activeMirrors.has(key)) return;
+  activeMirrors.add(key);
+  void (async () => {
+    try {
+      for (; ; ) {
+        const pending = pendingMirrors.get(key);
+        if (!pending) break;
+        pendingMirrors.delete(key);
+        try {
+          await projectGraph(
+            pending.projectRoot,
+            pending.sessionId,
+            pending.graph,
+            pending.sourceSystem
+          );
+        } catch {
+        }
+      }
+    } finally {
+      activeMirrors.delete(key);
+      const pending = pendingMirrors.get(key);
+      if (pending) {
+        pendingMirrors.delete(key);
+        queueLatestMirror(
+          pending.projectRoot,
+          pending.sessionId,
+          pending.graph,
+          pending.sourceSystem
+        );
+      }
+    }
+  })();
+}
 function todoListToSerializedGraph(todos, sessionId) {
   const nodes = todos.map((todo, index) => ({
     id: todo.id,
@@ -321,13 +363,28 @@ Reassess your current plan before continuing; do not rely on the initial todo sn
   }
 }
 function mirrorSessionTodosToKanban(projectRoot, todos, sessionId) {
-  fireAndForget(projectSessionTodosToKanban(projectRoot, todos, sessionId));
+  queueLatestMirror(
+    projectRoot,
+    sessionId,
+    todoListToSerializedGraph(todos, sessionId),
+    "session-todo"
+  );
 }
 function mirrorSessionTasksToKanban(projectRoot, tasks, sessionId) {
-  fireAndForget(projectSessionTasksToKanban(projectRoot, tasks, sessionId));
+  queueLatestMirror(
+    projectRoot,
+    sessionId,
+    taskFileToSerializedGraph(tasks, sessionId),
+    "session-task"
+  );
 }
 function mirrorSessionPlanToKanban(projectRoot, items, sessionId) {
-  fireAndForget(projectSessionPlanToKanban(projectRoot, items, sessionId));
+  queueLatestMirror(
+    projectRoot,
+    sessionId,
+    planFileToSerializedGraph(items, sessionId),
+    "session-plan"
+  );
 }
 function attachSessionKanbanMirror(context) {
   const existing = bindings.get(context);