@goodandready/dsh-kanban 0.2.2 → 0.2.7

package/lib/gitea.js

@@ -287,6 +287,21 @@ export function createGiteaClient({ getConfig, resolveToken, fetchImpl = fetch,
       })
     },
 
+    /** Создать Pull Request в репозитории. */
+    async createPullRequest({ owner, repo, title, body, head, base = 'main' }) {
+      const name = String(title ?? '').trim()
+      if (name === '') throw Object.assign(new Error('пустой заголовок'), { code: 'bad-title' })
+      const h = String(head ?? '').trim()
+      const b = String(base ?? 'main').trim()
+      if (!h) throw Object.assign(new Error('ветка head обязательна'), { code: 'bad-head' })
+      return request('POST', repoPath(owner, repo, '/pulls'), {
+        title: name,
+        body: String(body ?? ''),
+        head: h,
+        base: b,
+      })
+    },
+
     /**
      * Ветки репозитория: по ним видно, начата ли работа и сделан ли cleanup.
      *

package/lib/index.js

@@ -9,21 +9,44 @@
 // `routes.js`) и проверяется тестами без харнесса. Здесь остаётся обвязка
 // cordis: настройки, хранилище и маршруты.
 
-import { homedir } from 'node:os'
-import { join } from 'node:path'
-import { randomUUID } from 'node:crypto'
-import z from '@deepseek-ai/schemastery'
-import { defineTool } from '@deepseek-ai/dsh-tools'
-import { SessionId } from '@deepseek-ai/dsh-session'
-import { createUserMessage } from '@deepseek-ai/dsh-llm'
-import { CONFIG_DEFAULTS, CONFIG_HINTS, withDefaults, rootOf } from './config.js'
-import { openStore } from './store.js'
 import {
-  MAX_BODY_BYTES, isTrustedRequest, parseTaskPath,
-  buildBoard, applyMove, createTask, updateTask, deleteTask, appendNote, setArchived, listArchive,
-  taskBody,
-  taskLog, taskBySession, exportBoard, importBoard, exportTasksCsv, assignTask, boardMetrics,
+  MAX_BODY_BYTES,
+  isTrustedRequest,
+  parseTaskPath,
+  buildBoard,
+  applyMove,
+  createTask,
+  updateTask,
   confirmPermission,
+  appendNote,
+  setArchived,
+  listArchive,
+  assignTask,
+  deleteTask,
+  boardMetrics,
+  taskBody,
+  taskLog,
+  taskBySession,
+  exportBoard,
+  importBoard,
+  exportTasksCsv,
+  handleCleanupWorktree,
+  handleTaskDiff,
+  handleTaskCommits,
+  handleTaskMerge,
+  handleTaskWorktreeStatus,
+  handleTaskChecklist,
+  handleTaskReport,
+  handleGetTaskComments,
+  handleAddTaskComment,
+  handleAcceptTask,
+  handleRejectTask,
+  handleProgressDump,
+  handleTriageTask,
+  handleGetSubtasks,
+  handleCreateSubtask,
+  handleToggleChecklistItem,
+  handleCreateTaskPr,
 } from './routes.js'
 import { listImportable, importIssue, refreshTask, searchRepos, createProjectTask } from './import.js'
 import {
@@ -44,6 +67,8 @@ import {
   boardReportDefinition,
   boardCommentsDefinition,
   boardCommentAddDefinition,
+  boardDecomposeDefinition,
+  boardChecklistItemDefinition,
 } from './board-tool.js'
 import { verifySignature, parseEvent } from './webhook.js'
 import { planOutbound, planAssign, createOutbox } from './outbound.js'
@@ -51,6 +76,19 @@ import { computeNextRun } from './cron.js'
 import { PowerInhibitor } from './power.js'
 import { formatProgressDump, parseProgressDump } from './progress-dump.js'
 import { credentialRef } from '@deepseek-ai/dsh-credentials'
+import { defineTool } from '@deepseek-ai/dsh-tools'
+import z from '@deepseek-ai/schemastery'
+import { join } from 'node:path'
+import { homedir } from 'node:os'
+import { openStore } from './store.js'
+import {
+  COLUMN_ORDER,
+  wipLimitField,
+  withDefaults,
+  CONFIG_DEFAULTS,
+  CONFIG_HINTS,
+  rootOf,
+} from './config.js'
 import { eventHub } from './events.js'
 import { TASK_TEMPLATES } from './templates.js'
 
@@ -688,6 +726,8 @@ export function apply(ctx, config) {
         ctx.tools.register(defineTool(boardReportDefinition({ store }))),
         ctx.tools.register(defineTool(boardCommentsDefinition({ store }))),
         ctx.tools.register(defineTool(boardCommentAddDefinition({ store }))),
+        ctx.tools.register(defineTool(boardDecomposeDefinition({ store, gitea }))),
+        ctx.tools.register(defineTool(boardChecklistItemDefinition({ store }))),
       ]
       return () => { for (const stop of off) stop?.() }
     }
@@ -949,112 +989,93 @@ export function apply(ctx, config) {
           return
         }
         if (req.method === 'POST' && action === 'cleanup-worktree') {
-          const task = store.getTask(id)
-          if (task === undefined) { writeJson(res, 404, { error: 'task-not-found' }); return }
-          const out = await cleanupTaskWorktree({
-            store,
-            task,
+          const resObj = await handleCleanupWorktree({
+            store, task: store.getTask(id),
             workspaceRegistry: ctx.get('workspaceRegistry'),
             force: input?.force === true,
+            cleanupTaskWorktree,
           })
-          reply(res, out)
+          writeJson(res, resObj.status, resObj.body)
           return
         }
         if (req.method === 'GET' && action === 'diff') {
-          const task = store.getTask(id)
-          if (task === undefined) { writeJson(res, 404, { error: 'task-not-found' }); return }
-          const diffResult = await getTaskDiff({ worktreePath: task.worktree })
-          reply(res, diffResult)
+          const resObj = await handleTaskDiff({ task: store.getTask(id), getTaskDiff })
+          writeJson(res, resObj.status, resObj.body)
           return
         }
         if (req.method === 'GET' && action === 'commits') {
-          const task = store.getTask(id)
-          if (task === undefined) { writeJson(res, 404, { error: 'task-not-found' }); return }
-          const commits = await getTaskCommits({ worktreePath: task.worktree })
-          reply(res, { commits })
+          const resObj = await handleTaskCommits({ task: store.getTask(id), getTaskCommits })
+          writeJson(res, resObj.status, resObj.body)
           return
         }
         if (req.method === 'POST' && action === 'merge') {
-          const task = store.getTask(id)
-          if (task === undefined) { writeJson(res, 404, { error: 'task-not-found' }); return }
-          const mergeResult = await mergeTaskWorktree({
-            task,
-            targetBranch: typeof input?.targetBranch === 'string' ? input.targetBranch.trim() : undefined,
+          const resObj = await handleTaskMerge({
+            store, task: store.getTask(id),
+            targetBranch: input?.targetBranch,
             workspaceRegistry: ctx.get('workspaceRegistry'),
+            mergeTaskWorktree,
           })
-          if (!mergeResult.success) {
-            writeJson(res, 400, { error: mergeResult.error, detail: mergeResult.detail, files: mergeResult.files })
-            return
-          }
-          const updated = store.acceptTask(id)
-          store.addTransition({
-            taskId: id,
-            fromCol: task.column,
-            toCol: 'done',
-            source: 'manual',
-            detail: `принята и смержена ветка ${task.branch} в ${mergeResult.targetBranch}`,
-          })
-          reply(res, { task: updated, merged: true, targetBranch: mergeResult.targetBranch })
+          writeJson(res, resObj.status, resObj.body)
           return
         }
         if (req.method === 'GET' && action === 'worktree-status') {
-          const task = store.getTask(id)
-          if (task === undefined) { writeJson(res, 404, { error: 'task-not-found' }); return }
-          const dirtyCheck = await checkWorktreeDirty({ worktreePath: task.worktree })
-          reply(res, {
-            worktree: task.worktree || '',
-            branch: task.branch || '',
-            workspaceId: task.workspaceId || '',
-            dirty: dirtyCheck.dirty,
-            files: dirtyCheck.files,
-          })
+          const resObj = await handleTaskWorktreeStatus({ task: store.getTask(id), checkWorktreeDirty })
+          writeJson(res, resObj.status, resObj.body)
           return
         }
-                if (req.method === 'POST' && action === 'checklist') {
-          const task = store.getTask(id)
-          if (task === undefined) { writeJson(res, 404, { error: 'task-not-found' }); return }
-          const list = Array.isArray(input?.checklist) ? input.checklist : Array.isArray(input) ? input : []
-          const updated = store.updateChecklist(id, list)
-          reply(res, { task: updated })
+        if (req.method === 'GET' && action === 'subtasks') {
+          const resObj = handleGetSubtasks({ store, task: store.getTask(id) })
+          writeJson(res, resObj.status, resObj.body)
+          return
+        }
+        if (req.method === 'POST' && action === 'triage') {
+          const resObj = await handleTriageTask({ store, gitea, task: store.getTask(id), input })
+          writeJson(res, resObj.status, resObj.body)
+          return
+        }
+        if (req.method === 'POST' && (action === 'subtask' || action === 'subtasks')) {
+          const resObj = await handleCreateSubtask({ store, gitea, task: store.getTask(id), input })
+          writeJson(res, resObj.status, resObj.body)
+          return
+        }
+        if (req.method === 'POST' && action === 'checklist-toggle') {
+          const resObj = handleToggleChecklistItem({ store, task: store.getTask(id), input })
+          writeJson(res, resObj.status, resObj.body)
+          return
+        }
+        if (req.method === 'POST' && action === 'pr') {
+          const resObj = await handleCreateTaskPr({ store, gitea, task: store.getTask(id), input })
+          writeJson(res, resObj.status, resObj.body)
+          return
+        }
+        if (req.method === 'POST' && action === 'checklist') {
+          const resObj = handleTaskChecklist({ store, task: store.getTask(id), input })
+          writeJson(res, resObj.status, resObj.body)
           return
         }
         if (req.method === 'POST' && action === 'report') {
-          const task = store.getTask(id)
-          if (task === undefined) { writeJson(res, 404, { error: 'task-not-found' }); return }
-          const updated = store.setReport(id, input)
-          reply(res, { task: updated })
+          const resObj = handleTaskReport({ store, task: store.getTask(id), input })
+          writeJson(res, resObj.status, resObj.body)
           return
         }
         if (req.method === 'GET' && action === 'comments') {
-          const task = store.getTask(id)
-          if (task === undefined) { writeJson(res, 404, { error: 'task-not-found' }); return }
-          reply(res, { comments: task.comments || [] })
+          const resObj = handleGetTaskComments({ task: store.getTask(id) })
+          writeJson(res, resObj.status, resObj.body)
           return
         }
         if (req.method === 'POST' && action === 'comments') {
-          const task = store.getTask(id)
-          if (task === undefined) { writeJson(res, 404, { error: 'task-not-found' }); return }
-          const author = input?.author || 'user'
-          const role = input?.role || 'user'
-          const text = input?.text || ''
-          const updated = store.addComment(id, { author, role, text })
-          reply(res, { task: updated })
+          const resObj = handleAddTaskComment({ store, task: store.getTask(id), input })
+          writeJson(res, resObj.status, resObj.body)
           return
         }
         if (req.method === 'POST' && action === 'accept') {
-          const task = store.getTask(id)
-          if (task === undefined) { writeJson(res, 404, { error: 'task-not-found' }); return }
-          const updated = store.acceptTask(id)
-          reply(res, { task: updated })
+          const resObj = handleAcceptTask({ store, task: store.getTask(id) })
+          writeJson(res, resObj.status, resObj.body)
           return
         }
         if (req.method === 'POST' && action === 'reject') {
-          const task = store.getTask(id)
-          if (task === undefined) { writeJson(res, 404, { error: 'task-not-found' }); return }
-          const reason = String(input?.reason || '').trim()
-          if (!reason) { writeJson(res, 400, { error: 'reason-required' }); return }
-          const updated = store.rejectTask(id, reason)
-          reply(res, { task: updated })
+          const resObj = handleRejectTask({ store, task: store.getTask(id), input })
+          writeJson(res, resObj.status, resObj.body)
           return
         }
         if (req.method === 'POST' && action === 'resume') {
@@ -1080,7 +1101,7 @@ export function apply(ctx, config) {
             text: input?.text,
             agentPreset: input?.agentPreset || task.agentPreset,
             permission: input?.permission || task.permission,
-            permissions: ctx.permissions,
+            permissions: ctx.get('permissionPresets'),
             claimAs: req.headers['x-dsh-user'],
             gitRunner,
             workspaceRegistry: ctx.get('workspaceRegistry'),
@@ -1095,11 +1116,8 @@ export function apply(ctx, config) {
           return
         }
         if (req.method === 'POST' && action === 'progress-dump') {
-          const task = store.getTask(id)
-          if (task === undefined) { writeJson(res, 404, { error: 'task-not-found' }); return }
-          const formatted = typeof input === 'string' ? input : formatProgressDump(input)
-          const updated = store.updateTask(id, { progressDump: formatted })
-          reply(res, { task: updated })
+          const resObj = handleProgressDump({ store, task: store.getTask(id), input, formatProgressDump })
+          writeJson(res, resObj.status, resObj.body)
           return
         }
         if (req.method === 'POST' && action === 'stop') {

package/lib/routes.js

@@ -115,7 +115,13 @@ export function buildBoard({ store, config, board = 'main', repo, liveOf, sync,
     bySession.get(id).push(task)
   }
   const tasks = orderForBoard(
-    raw.map((task) => withPlan(task, liveOf, config, now, bySession.get(task.sessionId) ?? [])),
+    raw.map((task) => {
+      const enriched = withPlan(task, liveOf, config, now, bySession.get(task.sessionId) ?? [])
+      if (task.isEpic) {
+        enriched.subtasksCount = store.countSubtasks(task.id)
+      }
+      return enriched
+    }),
     columnsOf(store.boardKind(board)),
   )
   const kind = store.boardKind(board)
@@ -495,3 +501,353 @@ export function exportTasksCsv({ store, board = 'main' }) {
   // Префикс UTF-8 BOM для Microsoft Excel
   return '\uFEFF' + rows.join('\r\n')
 }
+
+
+/**
+ * Очистить воркдерево задачи.
+ */
+export async function handleCleanupWorktree({ store, task, workspaceRegistry, force, cleanupTaskWorktree }) {
+  if (!task) return { status: 404, body: { error: 'task-not-found' } }
+  const out = await cleanupTaskWorktree({
+    store,
+    task,
+    workspaceRegistry,
+    force: force === true,
+  })
+  return { status: 200, body: out }
+}
+
+/**
+ * Получить diff рабочей копии задачи.
+ */
+export async function handleTaskDiff({ task, getTaskDiff }) {
+  if (!task) return { status: 404, body: { error: 'task-not-found' } }
+  const diffResult = await getTaskDiff({ worktreePath: task.worktree })
+  return { status: 200, body: diffResult }
+}
+
+/**
+ * Получить список коммитов задачи.
+ */
+export async function handleTaskCommits({ task, getTaskCommits }) {
+  if (!task) return { status: 404, body: { error: 'task-not-found' } }
+  const commits = await getTaskCommits({ worktreePath: task.worktree })
+  return { status: 200, body: { commits } }
+}
+
+/**
+ * Слить воркдерево задачи и перевести в done.
+ */
+export async function handleTaskMerge({ store, task, targetBranch, workspaceRegistry, mergeTaskWorktree }) {
+  if (!task) return { status: 404, body: { error: 'task-not-found' } }
+  const mergeResult = await mergeTaskWorktree({
+    task,
+    targetBranch: typeof targetBranch === 'string' ? targetBranch.trim() : undefined,
+    workspaceRegistry,
+  })
+  if (!mergeResult.success) {
+    return {
+      status: 400,
+      body: { error: mergeResult.error, detail: mergeResult.detail, files: mergeResult.files },
+    }
+  }
+  const updated = store.acceptTask(task.id)
+  store.addTransition({
+    taskId: task.id,
+    fromCol: task.column,
+    toCol: 'done',
+    source: 'manual',
+    detail: `принята и смержена ветка ${task.branch} в ${mergeResult.targetBranch}`,
+  })
+  return { status: 200, body: { task: updated, merged: true, targetBranch: mergeResult.targetBranch } }
+}
+
+/**
+ * Проверить статус воркдерева задачи (ветка, dirty, воркспейс).
+ */
+export async function handleTaskWorktreeStatus({ task, checkWorktreeDirty }) {
+  if (!task) return { status: 404, body: { error: 'task-not-found' } }
+  const dirtyCheck = await checkWorktreeDirty({ worktreePath: task.worktree })
+  return {
+    status: 200,
+    body: {
+      worktree: task.worktree || '',
+      branch: task.branch || '',
+      workspaceId: task.workspaceId || '',
+      dirty: dirtyCheck.dirty,
+      files: dirtyCheck.files,
+    },
+  }
+}
+
+/**
+ * Обновить DoD чеклист задачи.
+ */
+export function handleTaskChecklist({ store, task, input }) {
+  if (!task) return { status: 404, body: { error: 'task-not-found' } }
+  const list = Array.isArray(input?.checklist) ? input.checklist : Array.isArray(input) ? input : []
+  const updated = store.updateChecklist(task.id, list)
+  return { status: 200, body: { task: updated } }
+}
+
+/**
+ * Установить отчёт выполнения задачи.
+ */
+export function handleTaskReport({ store, task, input }) {
+  if (!task) return { status: 404, body: { error: 'task-not-found' } }
+  const updated = store.setReport(task.id, input)
+  return { status: 200, body: { task: updated } }
+}
+
+/**
+ * Получить комментарии задачи.
+ */
+export function handleGetTaskComments({ task }) {
+  if (!task) return { status: 404, body: { error: 'task-not-found' } }
+  return { status: 200, body: { comments: task.comments || [] } }
+}
+
+/**
+ * Добавить комментарий к задаче.
+ */
+export function handleAddTaskComment({ store, task, input }) {
+  if (!task) return { status: 404, body: { error: 'task-not-found' } }
+  const author = input?.author || 'user'
+  const role = input?.role || 'user'
+  const text = input?.text || ''
+  const updated = store.addComment(task.id, { author, role, text })
+  return { status: 200, body: { task: updated } }
+}
+
+/**
+ * Принять задачу на ревью (перевод в done).
+ */
+export function handleAcceptTask({ store, task }) {
+  if (!task) return { status: 404, body: { error: 'task-not-found' } }
+  const updated = store.acceptTask(task.id)
+  return { status: 200, body: { task: updated } }
+}
+
+/**
+ * Отклонить задачу на ревью (перевод обратно в in_progress).
+ */
+export function handleRejectTask({ store, task, input }) {
+  if (!task) return { status: 404, body: { error: 'task-not-found' } }
+  const reason = String(input?.reason || '').trim()
+  if (!reason) return { status: 400, body: { error: 'reason-required' } }
+  const updated = store.rejectTask(task.id, reason)
+  return { status: 200, body: { task: updated } }
+}
+
+/**
+ * Сохранить дамп прогресса задачи.
+ */
+export function handleProgressDump({ store, task, input, formatProgressDump }) {
+  if (!task) return { status: 404, body: { error: 'task-not-found' } }
+  const formatted = typeof input === 'string' ? input : formatProgressDump(input)
+  const updated = store.updateTask(task.id, { progressDump: formatted })
+  return { status: 200, body: { task: updated } }
+}
+
+/**
+ * Decompose a task into subtasks and make the parent an Epic.
+ */
+export async function handleTriageTask({ store, gitea, task, input }) {
+  if (!task) return { status: 404, body: { error: 'task-not-found' } }
+  const subtasksInput = Array.isArray(input?.subtasks) ? input.subtasks : []
+  if (subtasksInput.length === 0) {
+    return { status: 400, body: { error: 'subtasks-required' } }
+  }
+  const createGitea = input?.createGiteaIssues === true && Boolean(task.owner && task.repo && gitea)
+
+  // Convert parent into Epic
+  store.updateTask(task.id, { isEpic: true })
+
+  const created = []
+  for (const item of subtasksInput) {
+    const title = String(item?.title ?? '').trim()
+    if (!title) continue
+    const body = String(item?.body ?? '').trim()
+    let issueNumber = null
+    let issueUrl = null
+
+    if (createGitea) {
+      try {
+        const issueBody = body ? `${body}\n\nParent epic: #${task.issueNumber || task.id}` : `Parent epic: #${task.issueNumber || task.id}`
+        const giteaIssue = await gitea.createIssue({
+          owner: task.owner,
+          repo: task.repo,
+          title,
+          body: issueBody,
+        })
+        if (giteaIssue?.number) {
+          issueNumber = giteaIssue.number
+          issueUrl = giteaIssue.html_url || null
+        }
+      } catch {}
+    }
+
+    const sub = store.createTask({
+      board: task.board || 'main',
+      column: 'backlog',
+      title,
+      body,
+      parentId: task.id,
+      owner: task.owner || null,
+      repo: task.repo || null,
+      issueNumber,
+      issueUrl,
+      labels: Array.isArray(item?.labels) ? item.labels : [],
+      workspaceId: task.workspaceId || '',
+    })
+    created.push(sub)
+  }
+
+  store.addTransition({
+    taskId: task.id,
+    fromCol: task.column,
+    toCol: task.column,
+    source: 'manual',
+    detail: `decomposed into ${created.length} subtasks (epic triage)`,
+  })
+
+  return {
+    status: 200,
+    body: {
+      epic: store.getTask(task.id),
+      subtasks: store.listSubtasks(task.id),
+      counts: store.countSubtasks(task.id),
+      createdCount: created.length,
+    },
+  }
+}
+
+/**
+ * Get subtasks of a task.
+ */
+export function handleGetSubtasks({ store, task }) {
+  if (!task) return { status: 404, body: { error: 'task-not-found' } }
+  return {
+    status: 200,
+    body: {
+      subtasks: store.listSubtasks(task.id),
+      counts: store.countSubtasks(task.id),
+    },
+  }
+}
+
+/**
+ * Create a single subtask linked to a parent task.
+ */
+export async function handleCreateSubtask({ store, gitea, task, input }) {
+  if (!task) return { status: 404, body: { error: 'task-not-found' } }
+  const title = String(input?.title ?? '').trim()
+  if (!title) return { status: 400, body: { error: 'title-required' } }
+  const body = String(input?.body ?? '').trim()
+  let issueNumber = null
+  let issueUrl = null
+
+  if (input?.createGiteaIssue === true && task.owner && task.repo && gitea) {
+    try {
+      const issueBody = body ? `${body}\n\nParent epic: #${task.issueNumber || task.id}` : `Parent epic: #${task.issueNumber || task.id}`
+      const giteaIssue = await gitea.createIssue({
+        owner: task.owner,
+        repo: task.repo,
+        title,
+        body: issueBody,
+      })
+      if (giteaIssue?.number) {
+        issueNumber = giteaIssue.number
+        issueUrl = giteaIssue.html_url || null
+      }
+    } catch {}
+  }
+
+  store.updateTask(task.id, { isEpic: true })
+  const sub = store.createTask({
+    board: task.board || 'main',
+    column: input?.column || 'backlog',
+    title,
+    body,
+    parentId: task.id,
+    owner: task.owner || null,
+    repo: task.repo || null,
+    issueNumber,
+    issueUrl,
+    labels: Array.isArray(input?.labels) ? input.labels : [],
+    workspaceId: task.workspaceId || '',
+  })
+  return { status: 200, body: { subtask: sub, counts: store.countSubtasks(task.id) } }
+}
+
+/**
+ * Toggle a checklist item atomically by index or text.
+ */
+export function handleToggleChecklistItem({ store, task, input }) {
+  if (!task) return { status: 404, body: { error: 'task-not-found' } }
+  const current = Array.isArray(task.checklist) ? [...task.checklist] : []
+  let targetIndex = -1
+
+  if (typeof input?.index === 'number' && input.index >= 0 && input.index < current.length) {
+    targetIndex = input.index
+  } else if (typeof input?.text === 'string' && input.text.trim()) {
+    const q = input.text.trim().toLowerCase()
+    targetIndex = current.findIndex((item) => {
+      const t = typeof item === 'string' ? item : item?.text
+      return typeof t === 'string' && t.toLowerCase().includes(q)
+    })
+  }
+
+  if (targetIndex === -1) {
+    return { status: 404, body: { error: 'checklist-item-not-found' } }
+  }
+
+  const item = current[targetIndex]
+  let updatedItem
+  if (typeof item === 'string') {
+    const checked = input?.checked !== undefined ? Boolean(input.checked) : true
+    updatedItem = { text: item, done: checked }
+  } else {
+    const checked = input?.checked !== undefined ? Boolean(input.checked) : !item.done
+    updatedItem = { ...item, done: checked }
+  }
+  current[targetIndex] = updatedItem
+  const updated = store.updateChecklist(task.id, current)
+  return { status: 200, body: { task: updated, item: updatedItem, index: targetIndex } }
+}
+
+/**
+ * Create a Gitea Pull Request for a task.
+ */
+export async function handleCreateTaskPr({ store, gitea, task, input }) {
+  if (!task) return { status: 404, body: { error: 'task-not-found' } }
+  if (!task.owner || !task.repo) {
+    return { status: 400, body: { error: 'task-no-repo' } }
+  }
+  const head = String(input?.head || task.branch || '').trim()
+  if (!head) return { status: 400, body: { error: 'branch-required' } }
+  const base = String(input?.base || 'main').trim()
+  const title = String(input?.title || task.title || `PR: ${task.title}`).trim()
+  const body = String(input?.body || (task.issueNumber ? `Closes #${task.issueNumber}` : '')).trim()
+
+  try {
+    const pr = await gitea.createPullRequest({
+      owner: task.owner,
+      repo: task.repo,
+      title,
+      body,
+      head,
+      base,
+    })
+    store.addTransition({
+      taskId: task.id,
+      fromCol: task.column,
+      toCol: task.column,
+      source: 'manual',
+      detail: `Created PR #${pr?.number || ''}: ${head} -> ${base}`,
+    })
+    return { status: 200, body: { pr, prUrl: pr?.html_url } }
+  } catch (err) {
+    return { status: 502, body: { error: 'gitea-pr-failed', detail: err?.message } }
+  }
+}