agentquad 0.3.0

package/src/routes/todos.js

@@ -0,0 +1,649 @@
+ import { Router } from 'express'
+import { watch as fsWatch } from 'node:fs'
+import { loadTranscript, renderPtyLogText } from '../transcript.js'
+import { summarizeTurns } from '../summarize.js'
+import { buildTodoExport, renderTodoMarkdown } from '../export/todoMarkdown.js'
+import { SUPPORTED_TOOLS } from '../config.js'
+
+const ALLOWED_STAGE_TAGS = ['dev', 'review', 'test', 'release', 'blocked']
+
+export function createTodosRouter({ db, logDir, getPricing, getTools, getLiveSession, getPty }) {
+  const router = Router()
+
+  router.get('/', (req, res) => {
+    try {
+      try { db.sweepRecurring(Date.now()) } catch (e) { console.warn('[sweepRecurring]', e?.message) }
+      const { quadrant, status, keyword } = req.query
+      const list = db.listTodos({ quadrant, status, keyword })
+      res.json({ ok: true, list })
+    } catch (e) {
+      res.status(500).json({ ok: false, error: e.message })
+    }
+  })
+
+  router.post('/', (req, res) => {
+    try {
+      const { title, description, quadrant, dueDate, workDir, brainstorm, appliedTemplateIds, parentId } = req.body || {}
+      if (!title || typeof title !== 'string') {
+        res.status(400).json({ ok: false, error: 'missing title' })
+        return
+      }
+      const parent = parentId ? db.getTodo(parentId) : null
+      if (parentId && !parent) {
+        res.status(400).json({ ok: false, error: 'parent_not_found' })
+        return
+      }
+      if (parent?.parentId) {
+        res.status(400).json({ ok: false, error: 'nested_subtodo_not_allowed' })
+        return
+      }
+      const q = parent ? parent.quadrant : (Number(quadrant) || 4)
+      if (![1, 2, 3, 4].includes(q)) {
+        res.status(400).json({ ok: false, error: 'invalid quadrant' })
+        return
+      }
+      const todo = db.createTodo({
+        title,
+        description: description || '',
+        quadrant: q,
+        dueDate: dueDate ?? null,
+        workDir: workDir || null,
+        brainstorm: !!brainstorm,
+        appliedTemplateIds: Array.isArray(appliedTemplateIds) ? appliedTemplateIds : [],
+        parentId: parent?.id ?? null,
+      })
+      res.json({ ok: true, todo })
+    } catch (e) {
+      if (['parent_not_found', 'nested_subtodo_not_allowed', 'parent_quadrant_mismatch'].includes(e.message)) {
+        res.status(400).json({ ok: false, error: e.message })
+        return
+      }
+      res.status(500).json({ ok: false, error: e.message })
+    }
+  })
+
+  router.put('/:id', (req, res) => {
+    try {
+      const existing = db.getTodo(req.params.id)
+      if (!existing) {
+        res.status(404).json({ ok: false, error: 'not_found' })
+        return
+      }
+      const patch = req.body || {}
+      if (patch.stageTag !== undefined) {
+        if (patch.stageTag !== null && !ALLOWED_STAGE_TAGS.includes(patch.stageTag)) {
+          res.status(400).json({ ok: false, error: 'invalid_stage_tag' })
+          return
+        }
+      }
+      if (patch.parentId !== undefined) {
+        if (existing.parentId && patch.parentId !== existing.parentId) {
+          res.status(400).json({ ok: false, error: 'reparent_not_allowed' })
+          return
+        }
+        if (existing.parentId && patch.parentId === null) {
+          res.status(400).json({ ok: false, error: 'promote_not_allowed' })
+          return
+        }
+        if (!existing.parentId && patch.parentId !== null && patch.parentId !== existing.parentId) {
+          res.status(400).json({ ok: false, error: 'reparent_not_allowed' })
+          return
+        }
+      }
+      const targetParentId = patch.parentId !== undefined ? patch.parentId : existing.parentId
+      const parent = targetParentId ? db.getTodo(targetParentId) : null
+      if (targetParentId && !parent) {
+        res.status(400).json({ ok: false, error: 'parent_not_found' })
+        return
+      }
+      if (parent?.parentId) {
+        res.status(400).json({ ok: false, error: 'nested_subtodo_not_allowed' })
+        return
+      }
+      if (parent && patch.quadrant !== undefined && Number(patch.quadrant) !== parent.quadrant) {
+        res.status(400).json({ ok: false, error: 'parent_quadrant_mismatch' })
+        return
+      }
+      const todo = db.updateTodo(req.params.id, patch)
+
+      // Auto-close PTY when status transitions to 'done':
+      // - kill all live AI sessions of this todo and its subtodos
+      // - tag parent's live sessions with userClosedReason so PTY 'done' handler
+      //   doesn't overwrite the just-written status back to 'todo'.
+      // - subtodo sessions are NOT tagged (subtodo lifecycle is independent;
+      //   normal PTY 'done' handler will reset them to 'todo' which is correct)
+      if (existing.status !== 'done' && patch.status === 'done') {
+        const pty = typeof getPty === 'function' ? getPty() : null
+        if (pty && typeof getLiveSession === 'function') {
+          const parentSessions = Array.isArray(todo.aiSessions) ? todo.aiSessions : []
+          for (const s of parentSessions) {
+            const live = getLiveSession(s.sessionId)
+            if (live && (live.status === 'running' || live.status === 'pending_confirm' || live.status === 'idle')) {
+              live.userClosedReason = 'todo_marked_done'
+              try { pty.stop(s.sessionId) } catch (e) { console.warn('[todos] pty.stop parent failed:', e?.message) }
+            }
+          }
+          const subtodos = typeof db.listSubtodosByParent === 'function' ? db.listSubtodosByParent(todo.id) : []
+          for (const sub of subtodos) {
+            const subSessions = Array.isArray(sub.aiSessions) ? sub.aiSessions : []
+            for (const s of subSessions) {
+              const live = getLiveSession(s.sessionId)
+              if (live && (live.status === 'running' || live.status === 'pending_confirm' || live.status === 'idle')) {
+                try { pty.stop(s.sessionId) } catch (e) { console.warn('[todos] pty.stop subtodo failed:', e?.message) }
+              }
+            }
+          }
+        }
+      }
+
+      res.json({ ok: true, todo })
+    } catch (e) {
+      if (['parent_not_found', 'nested_subtodo_not_allowed', 'parent_quadrant_mismatch', 'parent_cycle'].includes(e.message)) {
+        res.status(400).json({ ok: false, error: e.message })
+        return
+      }
+      res.status(500).json({ ok: false, error: e.message })
+    }
+  })
+
+  router.delete('/:id', (req, res) => {
+    try {
+      const existing = db.getTodo(req.params.id)
+      if (!existing) {
+        res.status(404).json({ ok: false, error: 'not_found' })
+        return
+      }
+      db.deleteTodo(req.params.id)
+      res.json({ ok: true })
+    } catch (e) {
+      res.status(500).json({ ok: false, error: e.message })
+    }
+  })
+
+  router.get('/:id/comments', (req, res) => {
+    try {
+      const existing = db.getTodo(req.params.id)
+      if (!existing) {
+        res.status(404).json({ ok: false, error: 'not_found' })
+        return
+      }
+      const list = db.listComments(req.params.id)
+      res.json({ ok: true, list })
+    } catch (e) {
+      res.status(500).json({ ok: false, error: e.message })
+    }
+  })
+
+  router.post('/:id/comments', (req, res) => {
+    try {
+      const existing = db.getTodo(req.params.id)
+      if (!existing) {
+        res.status(404).json({ ok: false, error: 'not_found' })
+        return
+      }
+      const { content } = req.body || {}
+      if (!content || typeof content !== 'string' || !content.trim()) {
+        res.status(400).json({ ok: false, error: 'missing content' })
+        return
+      }
+      const comment = db.addComment(req.params.id, content.trim())
+      res.json({ ok: true, comment })
+    } catch (e) {
+      res.status(500).json({ ok: false, error: e.message })
+    }
+  })
+
+  router.delete('/:id/comments/:commentId', (req, res) => {
+    try {
+      const comment = db.getComment(req.params.commentId)
+      if (!comment || comment.todoId !== req.params.id) {
+        res.status(404).json({ ok: false, error: 'comment_not_found' })
+        return
+      }
+      db.deleteComment(req.params.commentId)
+      res.json({ ok: true })
+    } catch (e) {
+      res.status(500).json({ ok: false, error: e.message })
+    }
+  })
+
+  router.patch('/:id/ai-sessions/:sessionId', (req, res) => {
+    try {
+      const existing = db.getTodo(req.params.id)
+      if (!existing) {
+        res.status(404).json({ ok: false, error: 'not_found' })
+        return
+      }
+      const { label } = req.body || {}
+      const nextAiSessions = (existing.aiSessions || []).map(item => {
+        if (item?.sessionId !== req.params.sessionId) return item
+        return { ...item, label: typeof label === 'string' ? label.trim() : (item.label || '') }
+      })
+      const found = nextAiSessions.some(item => item?.sessionId === req.params.sessionId)
+      if (!found) {
+        res.status(404).json({ ok: false, error: 'session_not_found' })
+        return
+      }
+      const todo = db.updateTodo(req.params.id, { aiSessions: nextAiSessions })
+      res.json({ ok: true, todo })
+    } catch (e) {
+      res.status(500).json({ ok: false, error: e.message })
+    }
+  })
+
+  router.delete('/:id/ai-sessions/:sessionId', (req, res) => {
+    try {
+      const existing = db.getTodo(req.params.id)
+      if (!existing) {
+        res.status(404).json({ ok: false, error: 'not_found' })
+        return
+      }
+
+      const nextAiSessions = (existing.aiSessions || []).filter(item => item?.sessionId !== req.params.sessionId)
+      if (nextAiSessions.length === (existing.aiSessions || []).length) {
+        res.status(404).json({ ok: false, error: 'session_not_found' })
+        return
+      }
+
+      const todo = db.updateTodo(req.params.id, { aiSessions: nextAiSessions })
+      res.json({ ok: true, todo })
+    } catch (e) {
+      res.status(500).json({ ok: false, error: e.message })
+    }
+  })
+
+  router.get('/:id/ai-sessions/:sessionId/transcript', async (req, res) => {
+    try {
+      const todo = db.getTodo(req.params.id)
+      if (!todo) {
+        res.status(404).json({ ok: false, error: 'not_found' })
+        return
+      }
+      const session = (todo.aiSessions || []).find(s => s?.sessionId === req.params.sessionId)
+      if (!session) {
+        res.status(404).json({ ok: false, error: 'session_not_found' })
+        return
+      }
+      const liveSession = typeof getLiveSession === 'function'
+        ? getLiveSession(session.sessionId)
+        : null
+      const result = await loadTranscript({
+        tool: session.tool,
+        nativeSessionId: session.nativeSessionId,
+        cwd: session.cwd || todo.workDir || null,
+        sessionId: session.sessionId,
+        logDir,
+        liveOutputHistory: liveSession?.outputHistory || null,
+        liveTimestamp: liveSession?.lastOutputAt || Date.now(),
+      })
+      const since = Number(req.query.since)
+      const turns = Number.isFinite(since) && since > 0
+        ? result.turns.slice(since)
+        : result.turns
+      res.json({
+        ok: true,
+        source: result.source,
+        total: result.turns.length,
+        offset: Number.isFinite(since) && since > 0 ? since : 0,
+        turns,
+        session: {
+          sessionId: session.sessionId,
+          tool: session.tool,
+          nativeSessionId: session.nativeSessionId,
+          status: session.status,
+          label: session.label || '',
+          startedAt: session.startedAt,
+          completedAt: session.completedAt,
+        },
+      })
+    } catch (e) {
+      console.error('[transcript]', e)
+      res.status(500).json({ ok: false, error: e.message })
+    }
+  })
+
+  // SSE 推流：jsonl 源 fs.watch 实时推送新 turn；ptylog 源推一次 snapshot 后让客户端 fallback 轮询
+  router.get('/:id/ai-sessions/:sessionId/transcript/stream', async (req, res) => {
+    const todo = db.getTodo(req.params.id)
+    if (!todo) { res.status(404).json({ ok: false, error: 'not_found' }); return }
+    const session = (todo.aiSessions || []).find(s => s?.sessionId === req.params.sessionId)
+    if (!session) { res.status(404).json({ ok: false, error: 'session_not_found' }); return }
+
+    res.set({
+      'Content-Type': 'text/event-stream; charset=utf-8',
+      'Cache-Control': 'no-cache, no-transform',
+      'Connection': 'keep-alive',
+      'X-Accel-Buffering': 'no',
+    })
+    res.flushHeaders?.()
+
+    let closed = false
+    const sendEvent = (event, data) => {
+      if (closed) return
+      try {
+        res.write(`event: ${event}\n`)
+        res.write(`data: ${JSON.stringify(data)}\n\n`)
+      } catch { /* client gone */ }
+    }
+
+    const loadArgs = () => ({
+      tool: session.tool,
+      nativeSessionId: session.nativeSessionId,
+      cwd: session.cwd || todo.workDir || null,
+      sessionId: session.sessionId,
+      logDir,
+      liveOutputHistory: (typeof getLiveSession === 'function' ? getLiveSession(session.sessionId) : null)?.outputHistory || null,
+      liveTimestamp: (typeof getLiveSession === 'function' ? getLiveSession(session.sessionId) : null)?.lastOutputAt || Date.now(),
+    })
+
+    let initial
+    try { initial = await loadTranscript(loadArgs()) }
+    catch (e) { sendEvent('error', { message: e.message }); res.end(); return }
+
+    sendEvent('snapshot', {
+      source: initial.source,
+      turns: initial.turns,
+      total: initial.turns.length,
+      session: {
+        sessionId: session.sessionId,
+        tool: session.tool,
+        nativeSessionId: session.nativeSessionId,
+        status: session.status,
+        label: session.label || '',
+        startedAt: session.startedAt,
+        completedAt: session.completedAt,
+      },
+    })
+
+    let watcher = null
+    let debounceTimer = null
+    let keepaliveTimer = null
+    let lastTotal = initial.turns.length
+    // Live PTY streaming：Claude Code 的 jsonl 只在每条消息"收尾"时才落盘，
+    // token 级别的增量看不到；订阅 PTY 输出并渲染成文本，让 Chat 续聊 tab
+    // 也能实时看到正在生成的内容。
+    let ptyListener = null
+    let liveDebounceTimer = null
+    let lastLiveContent = ''
+    // resume 刚起来那会儿，新 session 的 jsonl 还没写出来。把 findClaudeFile
+    // 放进定时轮询里，等 Claude 写出新 jsonl 再补挂 fsWatch + 对齐 lastTotal。
+    let jsonlRecheckTimer = null
+    const pty = typeof getPty === 'function' ? getPty() : null
+    const hasPty = pty && typeof pty.on === 'function'
+    const cleanup = () => {
+      if (closed) return
+      closed = true
+      if (debounceTimer) clearTimeout(debounceTimer)
+      if (liveDebounceTimer) clearTimeout(liveDebounceTimer)
+      if (keepaliveTimer) clearInterval(keepaliveTimer)
+      if (jsonlRecheckTimer) clearTimeout(jsonlRecheckTimer)
+      try { watcher?.close() } catch { /* ignore */ }
+      if (ptyListener && pty) {
+        try { pty.off('output', ptyListener) } catch { /* ignore */ }
+      }
+      try { res.end() } catch { /* ignore */ }
+    }
+    req.on('close', cleanup)
+    req.on('error', cleanup)
+
+    // 既没有 jsonl 也没有 PTY 订阅能力，才让前端降级去轮询
+    if ((initial.source !== 'jsonl' || !initial.filePath) && !hasPty) {
+      sendEvent('stream-not-supported', { source: initial.source })
+      cleanup()
+      return
+    }
+
+    keepaliveTimer = setInterval(() => {
+      if (!closed) { try { res.write(': keepalive\n\n') } catch { cleanup() } }
+    }, 15_000)
+
+    const handleJsonlChange = () => {
+      if (closed) return
+      if (debounceTimer) clearTimeout(debounceTimer)
+      debounceTimer = setTimeout(async () => {
+        debounceTimer = null
+        if (closed) return
+        try {
+          const parsed = await loadTranscript(loadArgs())
+          if (parsed.source !== 'jsonl') return
+          const newTotal = parsed.turns.length
+          if (newTotal > lastTotal) {
+            sendEvent('turn-added', {
+              turns: parsed.turns.slice(lastTotal),
+              total: newTotal,
+            })
+            lastTotal = newTotal
+          } else if (newTotal < lastTotal) {
+            // 文件被重写/截断：重新整体下发
+            sendEvent('snapshot', {
+              source: 'jsonl',
+              turns: parsed.turns,
+              total: newTotal,
+              session: {
+                sessionId: session.sessionId, tool: session.tool,
+                nativeSessionId: session.nativeSessionId, status: session.status,
+                label: session.label || '',
+                startedAt: session.startedAt, completedAt: session.completedAt,
+              },
+            })
+            lastTotal = newTotal
+          }
+        } catch (e) {
+          console.warn('[transcript stream] re-parse failed:', e?.message)
+        }
+      }, 120)
+    }
+
+    const attachJsonlWatcher = (filePath) => {
+      if (closed || watcher) return
+      try {
+        watcher = fsWatch(filePath, handleJsonlChange)
+        watcher.on?.('error', () => cleanup())
+      } catch (e) {
+        sendEvent('error', { message: `watch failed: ${e.message}` })
+      }
+    }
+
+    if (initial.source === 'jsonl' && initial.filePath) {
+      attachJsonlWatcher(initial.filePath)
+    } else {
+      // resume 新 session 时老 nativeSessionId 对应的 jsonl 存在但和新会话无关，
+      // loadTranscript 在拿到 'native-session' 事件后会自动指向新路径；这里周期
+      // 重试直到新 jsonl 出现，再挂 fsWatch 把完成的 turn 推给前端。
+      const recheck = async () => {
+        jsonlRecheckTimer = null
+        if (closed || watcher) return
+        try {
+          const parsed = await loadTranscript(loadArgs())
+          if (parsed.source === 'jsonl' && parsed.filePath) {
+            if (parsed.turns.length > lastTotal) {
+              sendEvent('turn-added', {
+                turns: parsed.turns.slice(lastTotal),
+                total: parsed.turns.length,
+              })
+              lastTotal = parsed.turns.length
+            }
+            attachJsonlWatcher(parsed.filePath)
+            return
+          }
+        } catch { /* ignore, just retry */ }
+        if (!closed) jsonlRecheckTimer = setTimeout(recheck, 1500)
+      }
+      jsonlRecheckTimer = setTimeout(recheck, 1500)
+    }
+
+    // ─── 订阅 PTY 输出，边生成边推送 ───
+    if (hasPty) {
+      const emitLive = async () => {
+        if (closed) return
+        const live = typeof getLiveSession === 'function' ? getLiveSession(session.sessionId) : null
+        if (!live?.outputHistory?.length) return
+        if (live.status !== 'running' && live.status !== 'pending_confirm') return
+        try {
+          const raw = live.outputHistory.join('')
+          const content = await renderPtyLogText(raw)
+          if (closed || content === lastLiveContent) return
+          lastLiveContent = content
+          sendEvent('live-output', {
+            content,
+            timestamp: live.lastOutputAt || Date.now(),
+          })
+        } catch (e) {
+          // 渲染失败就吞掉，不影响 jsonl 主通道
+          if (process.env.DEBUG) console.warn('[transcript stream] render live failed:', e?.message)
+        }
+      }
+      ptyListener = (payload) => {
+        if (!payload || payload.sessionId !== session.sessionId) return
+        if (closed || liveDebounceTimer) return
+        // 300ms 节流：xterm 每次重放 outputHistory 有成本；SSE 事件过密前端也会卡顿
+        liveDebounceTimer = setTimeout(() => {
+          liveDebounceTimer = null
+          void emitLive()
+        }, 300)
+      }
+      pty.on('output', ptyListener)
+      // 连上来时如果已经在生成（比如刷新页面），立刻推一次当前屏
+      setTimeout(() => { void emitLive() }, 0)
+    }
+  })
+
+  router.post('/:id/ai-sessions/:sessionId/fork', async (req, res) => {
+    try {
+      const sourceTodo = db.getTodo(req.params.id)
+      if (!sourceTodo) {
+        res.status(404).json({ ok: false, error: 'not_found' })
+        return
+      }
+      const session = (sourceTodo.aiSessions || []).find(s => s?.sessionId === req.params.sessionId)
+      if (!session) {
+        res.status(404).json({ ok: false, error: 'session_not_found' })
+        return
+      }
+      const liveSession = typeof getLiveSession === 'function'
+        ? getLiveSession(session.sessionId)
+        : null
+
+      const {
+        targetTodoId,
+        tool = session.tool,
+        newInstruction = '',
+        keepLastTurns = 6,
+        summarize = true,
+      } = req.body || {}
+
+      if (!SUPPORTED_TOOLS.includes(tool)) {
+        res.status(400).json({ ok: false, error: 'invalid tool' })
+        return
+      }
+
+      const targetTodo = targetTodoId ? db.getTodo(targetTodoId) : sourceTodo
+      if (!targetTodo) {
+        res.status(404).json({ ok: false, error: 'target_not_found' })
+        return
+      }
+
+      const transcript = await loadTranscript({
+        tool: session.tool,
+        nativeSessionId: session.nativeSessionId,
+        cwd: session.cwd || sourceTodo.workDir || null,
+        sessionId: session.sessionId,
+        logDir,
+        liveOutputHistory: liveSession?.outputHistory || null,
+        liveTimestamp: liveSession?.lastOutputAt || Date.now(),
+      })
+
+      const allTurns = transcript.turns || []
+      const keep = Math.max(0, Math.min(Number(keepLastTurns) || 0, allTurns.length))
+      const tail = keep > 0 ? allTurns.slice(-keep) : []
+      const head = keep > 0 ? allTurns.slice(0, -keep) : allTurns.slice()
+
+      let summary = ''
+      if (summarize && head.length > 0) {
+        try {
+          summary = await summarizeTurns(head, {
+            tool,
+            tools: typeof getTools === 'function' ? getTools() : undefined,
+          })
+        } catch (e) {
+          console.warn('[fork] summarize failed:', e.message)
+          summary = `（自动摘要失败：${e.message}）`
+        }
+      }
+
+      const parts = []
+      parts.push(`# 继续任务：${targetTodo.title}`)
+      if (targetTodo.description) parts.push(`## 任务描述\n${targetTodo.description}`)
+      if (summary) parts.push(`## 历史会话摘要\n${summary}`)
+      if (tail.length > 0) {
+        const tailText = tail.map(t => {
+          const role = t.role === 'user' ? '用户' : t.role === 'assistant' ? 'AI' : t.role
+          return `【${role}】${String(t.content || '').slice(0, 2000)}`
+        }).join('\n\n')
+        parts.push(`## 最近 ${tail.length} 轮原始对话\n${tailText}`)
+      }
+      if (newInstruction && newInstruction.trim()) {
+        parts.push(`## 新指令\n${newInstruction.trim()}`)
+      } else {
+        parts.push(`## 新指令\n请在上面的上下文基础上继续推进。`)
+      }
+
+      const prompt = parts.join('\n\n')
+
+      res.json({
+        ok: true,
+        prompt,
+        targetTodoId: targetTodo.id,
+        tool,
+        cwd: targetTodo.workDir || session.cwd || null,
+        sourceSessionId: session.sessionId,
+        summaryUsed: !!summary,
+        tailCount: tail.length,
+        headCount: head.length,
+      })
+    } catch (e) {
+      console.error('[fork]', e)
+      res.status(500).json({ ok: false, error: e.message })
+    }
+  })
+
+  router.get('/:id/export.md', async (req, res) => {
+    try {
+      const turns = ['summary', 'full', 'none'].includes(String(req.query.turns)) ? String(req.query.turns) : 'summary'
+      const turnLimit = req.query.turnLimit ? Math.min(Math.max(Number(req.query.turnLimit) || 0, 1), 500) : 80
+      const pricing = typeof getPricing === 'function' ? getPricing() : undefined
+      const report = await buildTodoExport(db, req.params.id, { turns, turnLimit, pricing })
+      if (!report) {
+        res.status(404).json({ ok: false, error: 'not_found' })
+        return
+      }
+      const md = renderTodoMarkdown(report)
+      res.set('Content-Type', 'text/markdown; charset=utf-8')
+      res.set('Content-Disposition', `inline; filename="todo-${req.params.id}.md"`)
+      res.send(md)
+    } catch (e) {
+      console.error('[export.md]', e)
+      res.status(500).json({ ok: false, error: e.message })
+    }
+  })
+
+  router.get('/:id/export.json', async (req, res) => {
+    try {
+      const turns = ['summary', 'full', 'none'].includes(String(req.query.turns)) ? String(req.query.turns) : 'summary'
+      const turnLimit = req.query.turnLimit ? Math.min(Math.max(Number(req.query.turnLimit) || 0, 1), 500) : 80
+      const pricing = typeof getPricing === 'function' ? getPricing() : undefined
+      const report = await buildTodoExport(db, req.params.id, { turns, turnLimit, pricing })
+      if (!report) {
+        res.status(404).json({ ok: false, error: 'not_found' })
+        return
+      }
+      const md = renderTodoMarkdown(report)
+      res.json({ ok: true, markdown: md, todo: { id: report.todo.id, title: report.todo.title } })
+    } catch (e) {
+      console.error('[export.json]', e)
+      res.status(500).json({ ok: false, error: e.message })
+    }
+  })
+
+  return router
+}