@goodandready/dsh-kanban 0.1.31 → 0.1.33

package/docs/design/DESIGN.md

@@ -64,4 +64,15 @@
   - Привязка проекта сессии: при создании агента с воркдеревом поле meta.cwd сохраняет канонический projectRoot (repoDir), предотвращая выпадение сессий в категорию «Ungrouped» в сайдбаре DSH; путь воркдерева передается в meta.worktreePath и инструкциях агента (#227).
   - Режим «↻ Продолжить» (Resume Execution): эндпоинт POST /dsh-kanban/tasks/:id/resume и кнопка в TaskDrawer; сохраняет существующее воркдерево, ветку и незакоммиченные файлы, передавая агенту преамбулу продолжения и актуальный PROGRESSDUMP (#226).
   - Фильтрация structural noise в проверках dirtyFiles: в checkWorktreeDirty добавлен флаг --ignore-submodules=all, исключающий ложные блокировки удаления воркдеревьев из-за субмодулей и дрейфа gitlinks (#213).
-  - Фильтрация сессий субагентов: сессии с маркером subagent (origin === 'subagent' или parentId !== undefined) исключаются из liveSessions и не перезаписывают состояние корневых задач (#215).
+  - Фильтрация сессий субагентов: сессии с маркером subagent (origin === 'subagent' или parentId !== undefined) исключаются из liveSessions и не перезаписывают состояние корневых задач (#215).
+## Locked Decisions
+
+### 2026-09-08: Релиз Vector 3 (Просмотр Git Diff / Коммитов и Однокликовый Merge) (#211, #212)
+- **Git Diff & Commits Viewer**: В `TaskDrawer` интегрирован блок просмотра истории коммитов сессии и unified diff измененных файлов воркдерева (`GET /tasks/:id/diff` и `GET /tasks/:id/commits`). Diff безопасно ограничен 250 КБ.
+- **One-Click Merge (--no-ff)**: В секции Review Acceptance Gate добавлена кнопка «✓ Принять и смержить» (`POST /tasks/:id/merge`). Выполняется проверка на отсутствие незакоммиченных изменений (`checkWorktreeDirty`), слияние `git merge --no-ff` в целевую ветку (`main`), автоматическая дерегистрация и удаление воркдерева с переводом задачи в `done`.
+
+
+### 2026-09-08: Релиз Vector 2 (Управление параллелизмом и безопасность) (#214, #216, #224)
+- **maxConcurrentSessions**: Лимит параллельных сессий агентов (по умолчанию 3) предотвращает исчерпание памяти/CPU на хосте. Задачи сверх лимита переводятся в очередь (`queuedAt > 0`) и автоматически запускаются диспетчером при завершении активных сессий.
+- **workspaceClaimBoundaries**: Инструмент `board_move` проверяет принадлежность задачи к воркспейсу текущей сессии агента, предотвращая случайный межпроектный захват карточек.
+- **Страховочный бэкап при импорте снимка**: `importBoard` в `/dsh-kanban/snapshot` автоматически делает снимок базы SQLite в `backups/kanban-backup-<timestamp>.db` с ротацией последних 10 копий перед перезаписью данных.

package/docs/plans/2026-09-08-concurrency-safety.md

@@ -0,0 +1,8 @@
+# Implementation Plan: Vector 2 — Concurrency & Safety (#214, #216, #224)
+
+Implementation of resource protection, workspace claim boundaries, and database backup before snapshot import in `@goodandready/dsh-kanban` (v0.1.32).
+
+## Issues Scope
+1. **#214**: Global concurrent session limit and task queue (`maxConcurrentSessions`).
+2. **#216**: Project workspace claim boundaries (`workspaceClaimBoundaries`).
+3. **#224**: Automatic database safety backup before board snapshot import.

package/docs/plans/2026-09-08-diff-viewer-merge.md

@@ -0,0 +1,7 @@
+# Implementation Plan: Vector 3 — Git Diff / Commit Viewer & One-Click Merge (#211, #212)
+
+Implementation of in-board git diff viewer and one-click worktree merge in `@goodandready/dsh-kanban` (v0.1.33).
+
+## Issues Scope
+1. **#211**: In-drawer Git Diff and commits viewer for human acceptance.
+2. **#212**: One-click worktree branch merge upon acceptance (`--no-ff`) with automated cleanup.

package/lib/board-tool.js

@@ -80,7 +80,7 @@ function nameOf(task) {
 }
 
 /** Определение board_move, готовое к передаче в `defineTool`. */
-export function boardMoveDefinition({ store }) {
+export function boardMoveDefinition({ store, config }) {
   return {
     name: 'board_move',
     description: 'Move the kanban card of the current task to another column. '
@@ -109,6 +109,15 @@ export function boardMoveDefinition({ store }) {
       const picked = pickTask(store, exec, ref)
       if (picked.error !== undefined) return picked.error
       const task = picked.task
+
+      // Проверка границ владения воркспейсом (#216)
+      const claimBoundaries = typeof config === 'function' ? config()?.workspaceClaimBoundaries : config?.workspaceClaimBoundaries
+      if (claimBoundaries !== false && typeof task.workspaceId === 'string' && task.workspaceId.trim() !== '') {
+        const sessionWs = String(exec?.agent?.session?.meta?.workspaceId ?? exec?.session?.meta?.workspaceId ?? '').trim()
+        if (sessionWs !== '' && sessionWs !== task.workspaceId.trim()) {
+          return `Cannot move card: task belongs to workspace "${task.workspaceId}", but current session belongs to workspace "${sessionWs}". Cross-workspace moves are restricted by workspaceClaimBoundaries.`
+        }
+      }
       // Перечисление уже не предлагает `done`, но модель может прислать его
       // мимо схемы, а завершение задачи не должно опираться на заявление.
       if (column === 'done' || TOOL_FORBIDDEN_COLUMNS.includes(column)) {

package/lib/client.js

@@ -873,6 +873,8 @@ window.__ModuleLoader__.load({
       'field.sessionDefaultPermission': 'Default permission baseline',
       'hint.sessionDefaultPermission': 'Tasks requesting permissions above this rank require confirmation.',
       'field.announceToAgent': 'Announce board in system prompt',
+      'field.maxConcurrentSessions': 'Max concurrent agent sessions',
+      'field.workspaceClaimBoundaries': 'Workspace claim boundaries',
       'hint.announceToAgent': 'Injects guidance section into the agent system prompt.',
       'task.runs': 'Execution History',
       'task.noRuns': 'No runs yet',
@@ -1132,6 +1134,15 @@ window.__ModuleLoader__.load({
       'report.checksRun': 'Verification checks',
       'report.artifacts': 'Artifacts',
       'report.risks': 'Risks & notes',
+      'diff.title': 'Git Changes & Diff',
+      'diff.empty': 'No changes detected in worktree.',
+      'diff.commits': 'Commits ({n})',
+      'diff.filesChanged': '{n} files changed',
+      'diff.truncated': 'Diff truncated (exceeded limit)',
+      'diff.show': 'Show diff',
+      'diff.hide': 'Hide diff',
+      'acceptance.acceptAndMerge': 'Accept & Merge (--no-ff)',
+      'acceptance.merging': 'Merging...',
       'acceptance.title': 'Review Acceptance Gate',
       'acceptance.accept': 'Accept (Done)',
       'acceptance.reject': 'Send back for rework',
@@ -1195,6 +1206,8 @@ window.__ModuleLoader__.load({
       'field.sessionDefaultPermission': '基线默认权限',
       'hint.sessionDefaultPermission': '超出此权限的任务需要点击人工确认。',
       'field.announceToAgent': '在系统提示词中声明看板',
+      'field.maxConcurrentSessions': '最大并发会话数',
+      'field.workspaceClaimBoundaries': '工作区认领边界',
       'hint.announceToAgent': '向 Agent 系统提示词注入看板与进度协作说明。',
       'task.runs': '执行历史',
       'task.noRuns': '暂无执行记录',
@@ -1454,6 +1467,15 @@ window.__ModuleLoader__.load({
       'report.checksRun': '验证检查',
       'report.artifacts': '生成产物',
       'report.risks': '风险与说明',
+      'diff.title': 'Git 变更与 Diff',
+      'diff.empty': '工作区未检测到变更。',
+      'diff.commits': '提交历史 ({n})',
+      'diff.filesChanged': '{n} 个文件变更',
+      'diff.truncated': 'Diff 超限已截断',
+      'diff.show': '查看 diff',
+      'diff.hide': '收起 diff',
+      'acceptance.acceptAndMerge': '验收并合并 (--no-ff)',
+      'acceptance.merging': '合并中...',
       'acceptance.title': '评审验收网关',
       'acceptance.accept': '验收通过 (完成)',
       'acceptance.reject': '退回重做',
@@ -1513,6 +1535,8 @@ window.__ModuleLoader__.load({
       { field: 'permissionGateEnabled', kind: 'bool', group: 'general' },
       { field: 'sessionDefaultPermission', kind: 'text', group: 'general' },
       { field: 'announceToAgent', kind: 'bool', group: 'general' },
+      { field: 'maxConcurrentSessions', kind: 'number', group: 'limits' },
+      { field: 'workspaceClaimBoundaries', kind: 'bool', group: 'general' },
     ]
 
     function hintKey(spec) {
@@ -2845,6 +2869,59 @@ window.__ModuleLoader__.load({
                 }, '⚠️ ' + t('acceptance.rejectedAlert', { reason: openTask.rejectReason })),
               )
             : null,
+          openTask.worktree
+            ? React.createElement('div', {
+                style: {
+                  margin: '8px 0', padding: 12,
+                  background: 'var(--dsw-alias-bg-layer-3)',
+                  border: '1px solid var(--dsw-alias-border-l2)',
+                  borderRadius: 8, display: 'flex', flexDirection: 'column', gap: 8,
+                },
+              },
+                React.createElement('div', { style: { display: 'flex', justifyContent: 'space-between', alignItems: 'center' } },
+                  React.createElement('div', { className: 'dkb-group', style: { margin: 0 } },
+                    t('diff.title'),
+                    commitsData.length > 0 ? ` · ${t('diff.commits', { n: commitsData.length })}` : '',
+                    diffData?.filesChanged ? ` · ${t('diff.filesChanged', { n: diffData.filesChanged })}` : '',
+                  ),
+                  React.createElement('button', {
+                    type: 'button', className: 'dkb-discard',
+                    style: { padding: '2px 8px', fontSize: 11 },
+                    onClick: () => {
+                      if (!diffData && !diffExpanded) loadDiffAndCommits()
+                      setDiffExpanded(!diffExpanded)
+                    },
+                  }, diffExpanded ? t('diff.hide') : t('diff.show')),
+                ),
+                diffExpanded ? React.createElement('div', { style: { display: 'flex', flexDirection: 'column', gap: 6 } },
+                  commitsData.length > 0
+                    ? React.createElement('div', { style: { display: 'flex', flexDirection: 'column', gap: 4, marginBottom: 4 } },
+                        commitsData.map((cm) => React.createElement('div', {
+                          key: cm.hash,
+                          style: { fontSize: 11, display: 'flex', gap: 6, opacity: 0.85, fontFamily: 'monospace' },
+                        },
+                          React.createElement('span', { style: { color: 'var(--dsw-alias-label-link, #3b82f6)' } }, cm.hash),
+                          React.createElement('span', { style: { flex: 1, whiteSpace: 'nowrap', overflow: 'hidden', textOverflow: 'ellipsis' } }, cm.subject),
+                          React.createElement('span', { style: { opacity: 0.6 } }, cm.date),
+                        ))
+                      )
+                    : null,
+                  diffLoading
+                    ? React.createElement('div', { style: { fontSize: 12, opacity: 0.7 } }, 'Loading diff...')
+                    : diffData?.diff
+                      ? React.createElement('pre', {
+                          style: {
+                            margin: 0, padding: 8, maxHeight: 280, overflowY: 'auto',
+                            background: 'var(--dsw-alias-bg-layer-2, #1e1e1e)',
+                            color: 'var(--dsw-alias-label-primary, #ddd)',
+                            fontSize: 11, fontFamily: 'monospace', borderRadius: 4, whiteSpace: 'pre-wrap',
+                            border: '1px solid var(--dsw-alias-border-l1)',
+                          },
+                        }, diffData.diff)
+                      : React.createElement('div', { style: { fontSize: 12, opacity: 0.7 } }, t('diff.empty'))
+                ) : null
+              )
+            : null,
           openTask.column === 'review'
             ? React.createElement('div', {
                 style: {
@@ -2856,6 +2933,22 @@ window.__ModuleLoader__.load({
               },
                 React.createElement('div', { className: 'dkb-group', style: { margin: 0 } }, t('acceptance.title')),
                 React.createElement('div', { style: { display: 'flex', gap: 8 } },
+                  openTask.worktree
+                    ? React.createElement('button', {
+                        type: 'button', className: 'dkb-save',
+                        disabled: merging,
+                        style: { background: 'var(--dsw-alias-bg-success, #16a34a)', color: '#fff' },
+                        onClick: async () => {
+                          try {
+                            setMerging(true)
+                            const out = await api('/task/' + encodeURIComponent(openTask.id) + '/merge', { method: 'POST', body: '{}' })
+                            if (out && out.task) setOpenTask(out.task)
+                            await load(board)
+                          } catch (e) { setError(t(e.key || e.error || 'error.unknown')) }
+                          finally { setMerging(false) }
+                        },
+                      }, merging ? t('acceptance.merging') : '🔀 ' + t('acceptance.acceptAndMerge'))
+                    : null,
                   React.createElement('button', {
                     type: 'button', className: 'dkb-save',
                     onClick: async () => {

package/lib/config.js

@@ -79,6 +79,8 @@ export const CONFIG_DEFAULTS = {
   permissionGateEnabled: false,
   sessionDefaultPermission: 'read-only',
   announceToAgent: true,
+  maxConcurrentSessions: 3,
+  workspaceClaimBoundaries: true,
 }
 
 /** Пояснения к полям; повторно используются схемой и карточкой настроек. */

package/lib/index.js

@@ -28,10 +28,10 @@ import {
 import { listImportable, importIssue, refreshTask, searchRepos, createProjectTask } from './import.js'
 import {
   runTask, resolveModel, buildStartMessage,
-  runBatch, queueTask, unqueueTask, liveSessions,
+  runBatch, queueTask, unqueueTask, liveSessions, dispatchNextQueuedTask,
   PERMISSION_RANKS,
 } from './launcher.js'
-import { cleanupTaskWorktree, checkWorktreeDirty } from './worktree.js'
+import { cleanupTaskWorktree, checkWorktreeDirty, getTaskDiff, getTaskCommits, mergeTaskWorktree } from './worktree.js'
 import { dispatchMove, MOVE_DETAIL, stopWork, STOP_DETAIL } from './commands.js'
 import { createGiteaClient } from './gitea.js'
 import { syncAll, createSyncState, intakeAll, archiveOverdue } from './sync.js'
@@ -265,7 +265,7 @@ export function apply(ctx, config) {
   ctx.effect(() => ctx.on('session/event', (session, event) => {
     try {
       const text = event?.content?.[0]?.text ?? event?.text ?? ''
-      handleSessionEvent({
+      const res = handleSessionEvent({
         store,
         sessionId: String(session?.id ?? ''),
         session,
@@ -274,6 +274,20 @@ export function apply(ctx, config) {
         error: event?.error,
       })
       syncPower()
+      // Если сессия завершила шаг или упала — пробуем продвинуть очередь задач (#214)
+      if (event?.type === 'turn/end' || event?.type === 'turn/completed' || event?.type === 'session/error' || event?.type === 'turn/error') {
+        dispatchNextQueuedTask({
+          agents: ctx.agents,
+          store,
+          config: getConfig(),
+          mintSessionId: () => SessionId(`kanban-queued-${randomUUID()}`),
+          createMessage: createUserMessage,
+          logger: ctx.logger,
+          permissions: ctx.get('permissionPresets'),
+          workspaceRegistry: ctx.get('workspaceRegistry'),
+          claimAs: 'queue-dispatcher',
+        }).catch(() => {})
+      }
     } catch (error) {
       ctx.logger?.warn?.(`dsh-kanban: событие сессии не обработано: ${error?.message}`)
     }
@@ -623,7 +637,7 @@ export function apply(ctx, config) {
     // множить настройки ради разницы, которой человек не почувствует.
     const registerBoardTool = () => {
       const off = [
-        ctx.tools.register(defineTool(boardMoveDefinition({ store }))),
+        ctx.tools.register(defineTool(boardMoveDefinition({ store, config: getConfig }))),
         ctx.tools.register(defineTool(boardPlanDefinition({ store }))),
         ctx.tools.register(defineTool(boardChecklistDefinition({ store }))),
         ctx.tools.register(defineTool(boardReportDefinition({ store }))),
@@ -868,6 +882,43 @@ export function apply(ctx, config) {
           reply(res, out)
           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)
+          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 })
+          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,
+            workspaceRegistry: ctx.get('workspaceRegistry'),
+          })
+          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 })
+          return
+        }
         if (req.method === 'GET' && action === 'worktree-status') {
           const task = store.getTask(id)
           if (task === undefined) { writeJson(res, 404, { error: 'task-not-found' }); return }

package/lib/launcher.js

@@ -296,6 +296,25 @@ export async function runTask({
   agentPreset, permission, permissions, claimAs,
   gitRunner, workspaceRegistry, resume = false,
 }) {
+  // Проверка лимита параллелизма (#214)
+  const maxConcurrent = typeof config?.maxConcurrentSessions === 'number' ? config.maxConcurrentSessions : 3
+  if (maxConcurrent > 0) {
+    const activeCount = countActiveSessions({ store, agents })
+    // Если задача уже в очереди или это новый запуск, и слоты исчерпаны
+    const isAlreadyRunning = task.sessionId && agents?.get?.(task.sessionId)?.status === 'running'
+    if (!isAlreadyRunning && activeCount >= maxConcurrent) {
+      const now = Date.now()
+      store.updateTask(task.id, { queuedAt: task.queuedAt > 0 ? task.queuedAt : now })
+      store.addTransition({
+        taskId: task.id,
+        fromCol: task.column,
+        toCol: task.column,
+        source: 'session',
+        detail: `превышен лимит параллельных сессий (${activeCount}/${maxConcurrent}), задача поставлена в очередь`,
+      })
+      return { mode: 'queued', queued: true, taskId: task.id, activeCount, maxConcurrent }
+    }
+  }
   if (config?.permissionGateEnabled) {
     const perm = permission || task.permission || 'read-only'
     const defaultPerm = config?.sessionDefaultPermission || 'read-only'
@@ -314,6 +333,10 @@ export async function runTask({
     agentPreset, permission, permissions, gitRunner, workspaceRegistry,
   })
 
+  if (task.queuedAt > 0) {
+    store.updateTask(task.id, { queuedAt: 0 })
+  }
+
   // Фиксируем запуск в истории задачи
   if (typeof store.recordTaskRun === 'function') {
     store.recordTaskRun(task.id, {
@@ -601,6 +624,11 @@ export function unqueueTask({ store, task }) {
  * Сессия без живого агента в список не попадает — предлагать её значило бы
  * предлагать очередь, из которой никто ничего не возьмёт.
  */
+export function countActiveSessions({ store, agents }) {
+  const sessions = liveSessions({ store, agents })
+  return sessions.filter((s) => s.status === 'running' || s.status === 'busy' || s.status === 'thinking').length
+}
+
 export function liveSessions({ store, agents }) {
   const byId = new Map()
   const all = [...store.listTasks({ board: 'main' }), ...store.listTasks({ board: 'simple' })]
@@ -622,3 +650,45 @@ export function liveSessions({ store, agents }) {
   }
   return [...byId.values()]
 }
+
+/**
+ * Автоматический запуск следующей задачи из очереди при освобождении слота (#214).
+ */
+export async function dispatchNextQueuedTask({
+  agents, store, config, mintSessionId, createMessage, cwdOf, logger,
+  agentPreset, permissions, workspaceRegistry, claimAs, gitRunner,
+}) {
+  if (!store || !agents) return null
+  const maxConcurrent = typeof config?.maxConcurrentSessions === 'number' ? config.maxConcurrentSessions : 3
+  if (maxConcurrent > 0) {
+    const active = countActiveSessions({ store, agents })
+    if (active >= maxConcurrent) return null
+  }
+
+  const queued = typeof store.listQueuedTasks === 'function' ? store.listQueuedTasks() : []
+  if (queued.length === 0) return null
+
+  const nextTask = queued[0]
+  try {
+    return await runTask({
+      agents,
+      store,
+      task: nextTask,
+      config,
+      provider: nextTask.provider || undefined,
+      model: nextTask.model || undefined,
+      mintSessionId: mintSessionId || (() => `kanban-${nextTask.id}-${randomUUID()}`),
+      createMessage: createMessage || ((msg) => msg),
+      cwdOf,
+      logger,
+      agentPreset,
+      permissions,
+      workspaceRegistry,
+      claimAs: claimAs || 'queue-dispatcher',
+      gitRunner,
+    })
+  } catch (err) {
+    logger?.warn?.(`dsh-kanban: не удалось запустить задачу ${nextTask.id} из очереди: ${err?.message}`)
+    return null
+  }
+}

package/lib/routes.js

@@ -382,6 +382,12 @@ export function exportBoard({ store }) {
  * @returns {{imported: number, skipped: number, error?: string}}
  */
 export function importBoard({ store, input }) {
+  let backupMeta = undefined
+  if (typeof store.backupDatabase === 'function') {
+    try {
+      backupMeta = store.backupDatabase()
+    } catch {}
+  }
   if (input === null || typeof input !== 'object') return { error: 'bad-import', status: 400 }
   if (input.version !== 1) return { error: 'bad-import-version', status: 400 }
   if (!Array.isArray(input.tasks)) return { error: 'bad-import', status: 400 }
@@ -419,5 +425,5 @@ export function importBoard({ store, input }) {
     imported += 1
   }
 
-  return { imported, skipped }
+  return { imported, skipped, backup: backupMeta?.backup }
 }

package/lib/store.js

@@ -13,7 +13,7 @@
 
 import { DatabaseSync } from 'node:sqlite'
 import { randomUUID } from 'node:crypto'
-import { mkdirSync } from 'node:fs'
+import { mkdirSync, copyFileSync, readdirSync, unlinkSync, statSync } from 'node:fs'
 import { join } from 'node:path'
 import { keyBetween } from './order.js'
 import { DEFAULT_BOARDS, normalizeKind } from './config.js'
@@ -257,6 +257,37 @@ export function openStore({ dir }) {
   }
 
   return {
+    backupDatabase() {
+      const backupsDir = join(dir, 'backups')
+      mkdirSync(backupsDir, { recursive: true })
+      const stamp = new Date().toISOString().replace(/[:.]/g, '-')
+      const backupName = `kanban-backup-${stamp}.db`
+      const dest = join(backupsDir, backupName)
+      try {
+        db.exec('PRAGMA wal_checkpoint(TRUNCATE)')
+      } catch { /* wal checkpoint may not be strictly required */ }
+      copyFileSync(join(dir, 'kanban.db'), dest)
+
+      // Ротация: сохраняем только последние 10 бэкапов
+      try {
+        const files = readdirSync(backupsDir)
+          .filter((f) => f.startsWith('kanban-backup-') && f.endsWith('.db'))
+          .map((f) => ({ name: f, path: join(backupsDir, f), time: statSync(join(backupsDir, f)).mtimeMs }))
+          .sort((a, b) => b.time - a.time)
+        if (files.length > 10) {
+          for (const old of files.slice(10)) {
+            try { unlinkSync(old.path) } catch {}
+          }
+        }
+      } catch {}
+      return { backup: backupName, path: dest }
+    },
+
+    listQueuedTasks() {
+      const rows = db.prepare('SELECT * FROM tasks WHERE queuedAt > 0 AND archivedAt = 0 ORDER BY queuedAt ASC').all()
+      return rows.map(rowToTask)
+    },
+
     listBoards() {
       return q.boards.all()
     },

package/lib/worktree.js

@@ -117,7 +117,7 @@ export async function isGitRepo(repoDir, gitRunner = defaultGitRunner) {
   if (!repoDir) return false
   try {
     const res = await gitRunner(['rev-parse', '--is-inside-work-tree'], repoDir)
-    return res.stdout === 'true'
+    return res.stdout?.trim() === 'true'
   } catch {
     return false
   }
@@ -368,3 +368,161 @@ export async function cleanupTaskWorktree({
 
   return { success: true, removed: true, branchDeleted: result.branchDeleted }
 }
+
+/**
+ * Получить unified diff изменений в воркдереве задачи (#211).
+ *
+ * @param {{worktreePath: string, baseRef?: string, gitRunner?: Function}} options
+ * @returns {Promise<{diff: string, truncated: boolean, filesChanged: number}>}
+ */
+export async function getTaskDiff({ worktreePath, baseRef, gitRunner = defaultGitRunner }) {
+  if (!worktreePath) return { diff: '', truncated: false, filesChanged: 0 }
+  const isRepo = await isGitRepo(worktreePath, gitRunner)
+  if (!isRepo) return { diff: '', truncated: false, filesChanged: 0 }
+
+  let base = baseRef
+  if (!base) {
+    base = await determineBaseRef(worktreePath, gitRunner)
+  }
+
+  // Сначала пробуем git diff base...HEAD, если base доступен
+  let diffOut = ''
+  if (base) {
+    const res = await gitRunner(['diff', `${base}...HEAD`], worktreePath)
+    if (res.exitCode === 0) {
+      diffOut = res.stdout
+    }
+  }
+
+  // Дополнительно смотрим незакоммиченные изменения (unstaged + staged)
+  const unstaged = await gitRunner(['diff', 'HEAD'], worktreePath)
+  if (unstaged.exitCode === 0 && unstaged.stdout.trim() !== '') {
+    diffOut = diffOut ? `${diffOut}\n\n# Uncommitted Changes:\n${unstaged.stdout}` : unstaged.stdout
+  }
+
+  // Если и base...HEAD, и HEAD ничего не дали, берём чистый git diff
+  if (!diffOut.trim()) {
+    const fallback = await gitRunner(['diff'], worktreePath)
+    if (fallback.exitCode === 0) diffOut = fallback.stdout
+  }
+
+  // Подсчитываем число затронутых файлов
+  const fileLines = diffOut.split('\n').filter((l) => l.startsWith('diff --git'))
+  const filesChanged = fileLines.length
+
+  // Защита от переполнения: обрезаем diff до 250 КБ
+  const MAX_DIFF_BYTES = 250 * 1024
+  let truncated = false
+  if (Buffer.byteLength(diffOut, 'utf8') > MAX_DIFF_BYTES) {
+    diffOut = diffOut.slice(0, MAX_DIFF_BYTES) + '\n\n... [Diff truncated: exceeded 250 KB limit]'
+    truncated = true
+  }
+
+  return { diff: diffOut, truncated, filesChanged }
+}
+
+/**
+ * Получить список коммитов ветки задачи относительно базовой ветки (#211).
+ *
+ * @param {{worktreePath: string, baseRef?: string, gitRunner?: Function}} options
+ * @returns {Promise<Array<{hash: string, subject: string, author: string, date: string}>>}
+ */
+export async function getTaskCommits({ worktreePath, baseRef, gitRunner = defaultGitRunner }) {
+  if (!worktreePath) return []
+  const isRepo = await isGitRepo(worktreePath, gitRunner)
+  if (!isRepo) return []
+
+  let base = baseRef
+  if (!base) {
+    base = await determineBaseRef(worktreePath, gitRunner)
+  }
+
+  const range = base ? `${base}..HEAD` : '-n 20'
+  const logRes = await gitRunner(['log', range, '--pretty=format:%h%x09%an%x09%ad%x09%s', '--date=short'], worktreePath)
+  if (logRes.exitCode !== 0 || !logRes.stdout.trim()) {
+    // fallback на последние 10 коммитов
+    const fallback = await gitRunner(['log', '-n', '10', '--pretty=format:%h%x09%an%x09%ad%x09%s', '--date=short'], worktreePath)
+    if (fallback.exitCode !== 0 || !fallback.stdout.trim()) return []
+    return fallback.stdout.trim().split('\n').map(parseCommitLine).filter(Boolean)
+  }
+
+  return logRes.stdout.trim().split('\n').map(parseCommitLine).filter(Boolean)
+}
+
+function parseCommitLine(line) {
+  const parts = line.split('\t')
+  if (parts.length < 4) return null
+  return {
+    hash: parts[0],
+    author: parts[1],
+    date: parts[2],
+    subject: parts[3],
+  }
+}
+
+/**
+ * Слияние ветки воркдерева в основную ветку репозитория (--no-ff) при приёмке (#212).
+ *
+ * @param {{task: object, targetBranch?: string, gitRunner?: Function, workspaceRegistry?: object}} options
+ * @returns {Promise<{success: boolean, merged: boolean, error?: string}>}
+ */
+export async function mergeTaskWorktree({
+  task, targetBranch, gitRunner = defaultGitRunner, workspaceRegistry,
+}) {
+  if (!task.worktree || !task.branch) {
+    return { success: false, merged: false, error: 'no-worktree-or-branch' }
+  }
+
+  // 1. Проверяем чистоту воркдерева
+  const dirtyCheck = await checkWorktreeDirty({ worktreePath: task.worktree, gitRunner })
+  if (dirtyCheck.dirty) {
+    return { success: false, merged: false, error: 'worktree-dirty', files: dirtyCheck.files }
+  }
+
+  // 2. Находим корень основного репозитория (из .git файла воркдерева или config)
+  let mainRepoDir = ''
+  const revParse = await gitRunner(['rev-parse', '--git-common-dir'], task.worktree)
+  if (revParse.exitCode === 0 && revParse.stdout.trim()) {
+    const commonDir = revParse.stdout.trim()
+    mainRepoDir = commonDir.endsWith('/.git') ? commonDir.slice(0, -5) : commonDir
+  }
+
+  if (!mainRepoDir) {
+    return { success: false, merged: false, error: 'main-repo-not-found' }
+  }
+
+  // 3. Определяем целевую ветку для слияния
+  let target = targetBranch
+  if (!target) {
+    target = await determineBaseRef(mainRepoDir, gitRunner)
+  }
+  if (!target) target = 'main'
+
+  // 4. Переключаемся или проверяем, что в целевой ветке в основном репо
+  const currentBranch = await gitRunner(['branch', '--show-current'], mainRepoDir)
+  if (currentBranch.stdout.trim() !== target) {
+    const checkoutRes = await gitRunner(['checkout', target], mainRepoDir)
+    if (checkoutRes.exitCode !== 0) {
+      return { success: false, merged: false, error: 'checkout-target-failed', detail: checkoutRes.stderr }
+    }
+  }
+
+  // 5. Выполняем git merge --no-ff
+  const mergeMsg = `Merge branch '${task.branch}' for task ${task.id}`
+  const mergeRes = await gitRunner(['merge', '--no-ff', task.branch, '-m', mergeMsg], mainRepoDir)
+  if (mergeRes.exitCode !== 0) {
+    // В случае конфликта откатываем мерж
+    await gitRunner(['merge', '--abort'], mainRepoDir)
+    return { success: false, merged: false, error: 'merge-conflict', detail: mergeRes.stderr || mergeRes.stdout }
+  }
+
+  // 6. Очищаем воркдерево задачи
+  await cleanupTaskWorktree({
+    task,
+    workspaceRegistry,
+    gitRunner,
+    force: true,
+  })
+
+  return { success: true, merged: true, targetBranch: target }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@goodandready/dsh-kanban",
-  "version": "0.1.31",
+  "version": "0.1.33",
   "description": "Visual Kanban board for DeepSeek Harness: Gitea-backed tasks, workflow columns, and a dedicated agent session per task.",
   "type": "module",
   "main": "lib/index.js",