@goodandready/dsh-kanban 0.1.35 → 0.2.1

package/docs/design/DESIGN.md

@@ -66,6 +66,14 @@
   - Фильтрация structural noise в проверках dirtyFiles: в checkWorktreeDirty добавлен флаг --ignore-submodules=all, исключающий ложные блокировки удаления воркдеревьев из-за субмодулей и дрейфа gitlinks (#213).
   - Фильтрация сессий субагентов: сессии с маркером subagent (origin === 'subagent' или parentId !== undefined) исключаются из liveSessions и не перезаписывают состояние корневых задач (#215).
 ## Locked Decisions
+- **0.2.1**: Карточка настроек плагина перенесена строго в слот `settings.plugin.item` (раздел «Настройки → Плагины → Настройки плагинов») без одновременной дублирующей регистрации в `settings.section` (Issue #236).
+
+### 2026-09-08: Релиз v0.2.0 — Milestone (SSE, Chat Sync, Templates, Two-Column Drawer, Multi-Repo) (#210, #219, #220, #222, #225)
+- **Live SSE Channel (`/dsh-kanban/events`)**: Постоянное SSE-соединение с автоматическим переподключением для мгновенного пуша обновлений доски (`task:change`, `board:change`) без избыточного поллинга (#222).
+- **Auto-sync Sessions (`autoSyncSessions`)**: Опциональная автоматическая синхронизация стандартных диалогов чата DSH в карточки доски канбана с надежной фильтрацией внутренних сессий и субагентов (#225).
+- **Task Templates Library (`/dsh-kanban/templates`)**: Библиотека из 5 встроенных типовых шаблонов (Feature, Bugfix, Refactor, Security, Release) с предзаполненными чеклистами DoD и шаблонами промптов (#220).
+- **Two-Column Drawer Layout**: Адаптивный двухколоночный макет для TaskDrawer на экранах шириной от 960px с разделением метаданных и контентной области (#219).
+- **Multi-Repo Workspace Mirroring**: Сканирование нескольких вложенных git-репозиториев (`findWorkspaceGitRepos`) и подготовка зеркальных воркдеревьев на единой ветке задачи (`prepareMultiRepoMirror`) (#210).
 
 ### 2026-09-08: Релиз Vector 4 (UX оператора, управление моделями и аналитика) (#217, #218, #221, #223, #228)
 - **reasoningEffort**: Добавлен селектор глубины рассуждения (low, medium, high) в карточке `TaskDrawer`, сохраняется в SQLite и передается в метаданные сессии DSH для моделей с рассуждением (DeepSeek-R1, OpenAI o1/o3).

package/lib/client.js

@@ -806,6 +806,9 @@ window.__ModuleLoader__.load({
       // оказывается под ними — нажать нельзя, а выглядит как «ничего не работает».
       '.dkb-modal{position:absolute;inset:0;background:rgba(0,0,0,.4);display:flex;align-items:center;justify-content:center;padding:24px 24px 84px;box-sizing:border-box;z-index:70}' +
       '.dkb-panel{width:min(720px,100%);max-height:100%;background:var(--dsw-alias-bg-layer-2);border:1px solid var(--dsw-alias-border-l2);border-radius:12px;padding:16px;box-sizing:border-box;overflow-y:auto;display:flex;flex-direction:column;gap:12px}' +
+      '@media (min-width: 960px){.dkb-panelWide{width:min(1100px,96%)}.dkb-drawerGrid{display:grid;grid-template-columns:300px 1fr;gap:20px;align-items:start}}' +
+      '.dkb-drawerSidebar{display:flex;flex-direction:column;gap:12px;border-right:1px solid var(--dsw-alias-border-l2);padding-right:16px}' +
+      '.dkb-drawerMain{display:flex;flex-direction:column;gap:12px;min-width:0}' +
       '.dkb-panelBody{white-space:pre-wrap;color:var(--dsw-alias-label-secondary);font-size:13px;line-height:1.5;margin:0}' +
       '.dkb-log{list-style:none;margin:0;padding:0;display:flex;flex-direction:column;gap:4px}' +
       '.dkb-logRow{color:var(--dsw-alias-label-secondary);font-size:12px}' +
@@ -875,6 +878,8 @@ window.__ModuleLoader__.load({
       'field.announceToAgent': 'Announce board in system prompt',
       'field.maxConcurrentSessions': 'Max concurrent agent sessions',
       'field.workspaceClaimBoundaries': 'Workspace claim boundaries',
+      'field.autoSyncSessions': 'Auto-sync external chat sessions',
+      'hint.autoSyncSessions': 'Automatically create board cards for standard DSH chat conversations.',
       'hint.announceToAgent': 'Injects guidance section into the agent system prompt.',
       'task.runs': 'Execution History',
       'task.noRuns': 'No runs yet',
@@ -1141,6 +1146,13 @@ window.__ModuleLoader__.load({
       'reasoning.high': 'High (Deep Thinking)',
       'action.exportCsv': 'Export CSV (Excel)',
       'slash.hint': 'Type / for commands & skills',
+      'template.label': 'Task Template',
+      'template.none': 'None (Empty template)',
+      'template.feature': 'Feature (New functionality)',
+      'template.bugfix': 'Bugfix (Defect fix)',
+      'template.refactor': 'Refactor (Code cleanup)',
+      'template.security': 'Security (Audit & CVE)',
+      'template.release': 'Release (Release preparation)',
       'diff.title': 'Git Changes & Diff',
       'diff.empty': 'No changes detected in worktree.',
       'diff.commits': 'Commits ({n})',
@@ -1215,6 +1227,8 @@ window.__ModuleLoader__.load({
       'field.announceToAgent': '在系统提示词中声明看板',
       'field.maxConcurrentSessions': '最大并发会话数',
       'field.workspaceClaimBoundaries': '工作区认领边界',
+      'field.autoSyncSessions': '自动同步外部聊天会话',
+      'hint.autoSyncSessions': '自动将 DSH 的标准聊天会话同步为看板任务卡片。',
       'hint.announceToAgent': '向 Agent 系统提示词注入看板与进度协作说明。',
       'task.runs': '执行历史',
       'task.noRuns': '暂无执行记录',
@@ -1481,6 +1495,13 @@ window.__ModuleLoader__.load({
       'reasoning.high': '高（深度推理）',
       'action.exportCsv': '导出 CSV (Excel)',
       'slash.hint': '输入 / 获取命令与技能',
+      'template.label': '任务模板',
+      'template.none': '无（空白模板）',
+      'template.feature': '功能特性 (Feature)',
+      'template.bugfix': '缺陷修复 (Bugfix)',
+      'template.refactor': '重构优化 (Refactor)',
+      'template.security': '安全审计 (Security)',
+      'template.release': '版本发布 (Release)',
       'diff.title': 'Git 变更与 Diff',
       'diff.empty': '工作区未检测到变更。',
       'diff.commits': '提交历史 ({n})',
@@ -1551,6 +1572,7 @@ window.__ModuleLoader__.load({
       { field: 'announceToAgent', kind: 'bool', group: 'general' },
       { field: 'maxConcurrentSessions', kind: 'number', group: 'limits' },
       { field: 'workspaceClaimBoundaries', kind: 'bool', group: 'general' },
+      { field: 'autoSyncSessions', kind: 'bool', group: 'sync' },
     ]
 
     function hintKey(spec) {
@@ -2004,6 +2026,47 @@ window.__ModuleLoader__.load({
 
       React.useEffect(() => { load(board) }, [load, board])
 
+      // Подписка на Server-Sent Events (SSE) для мгновенного обновления доски (#222).
+      React.useEffect(() => {
+        if (typeof window === 'undefined' || typeof window.EventSource !== 'function') return undefined
+        let es = null
+        let reconnectTimer = null
+
+        const connect = () => {
+          try {
+            es = new window.EventSource('/dsh-kanban/events')
+            es.addEventListener('board:change', () => {
+              load(board)
+            })
+            es.addEventListener('task:change', () => {
+              load(board)
+            })
+            es.onerror = () => {
+              if (es) {
+                try { es.close() } catch {}
+                es = null
+              }
+              if (!reconnectTimer) {
+                reconnectTimer = setTimeout(() => {
+                  reconnectTimer = null
+                  connect()
+                }, 5000)
+              }
+            }
+          } catch {}
+        }
+
+        connect()
+
+        return () => {
+          if (reconnectTimer) clearTimeout(reconnectTimer)
+          if (es) {
+            try { es.close() } catch {}
+            es = null
+          }
+        }
+      }, [load, board])
+
       // Просьба чипа «покажи вот эту». Забираем её один раз: повтор открывал
       // бы окно снова после каждого закрытия.
       const [wanted, setWanted] = React.useState('')
@@ -2650,7 +2713,7 @@ window.__ModuleLoader__.load({
           className: 'dkb-modal',
           onClick: () => setOpenTask(null),
         }, React.createElement('div', {
-          className: 'dkb-panel',
+          className: 'dkb-panel dkb-panelWide',
           role: 'dialog', 'aria-modal': 'true',
           onClick: (e) => e.stopPropagation(),
         },
@@ -4154,12 +4217,14 @@ window.__ModuleLoader__.load({
           if (typeof ctx.slots?.has === 'function' && !ctx.slots.has(entry.name)) {
             continue
           }
-          let ok = false
-          ctx.slots.inject(entry.name, () => {
+          let registeredInSlot = false
+          const res = ctx.slots.inject(entry.name, () => {
             ctx.slots.register(entry, component)
-            ok = true
+            registeredInSlot = true
           })
-          if (ok) return entry.name
+          if (registeredInSlot || (res !== null && res !== false && res !== undefined)) {
+            return entry.name
+          }
         } catch { /* слота нет в этой сборке — пробуем следующий */ }
       }
       return undefined
@@ -4170,9 +4235,12 @@ window.__ModuleLoader__.load({
     function apply(ctx) {
       ctx.effect(() => ctx.locale.register(NS, { en, zh }), 'dsh-kanban: словари')
 
-      // Карточка настроек. Ключ обязан совпадать с пространством настроек:
-      // вкладка перебирает объявленные пространства и рисует слот с entryKey,
+      // Карточка настроек в Настройки → Плагины → Настройки плагинов.
+      // Ключ обязан совпадать с пространством настроек: вкладка перебирает
+      // объявленные пространства и рисует слот settings.plugin.item с entryKey,
       // равным имени пространства.
+      // Карточка настроек. В сборке с вкладкой «Настройки плагинов» регистрируется
+      // в settings.plugin.item, иначе откатывается в отдельный раздел settings.section.
       const cardSlot = registerFirst(ctx, [
         { name: 'settings.plugin.item', key: NS, locale: NS, inject: () => ({ ctx }) },
         { name: 'settings.section', id: '@goodandready/dsh-kanban', order: 32, locale: NS, label: () => fallbackT('title'), inject: () => ({ ctx }) },

package/lib/config.js

@@ -81,6 +81,7 @@ export const CONFIG_DEFAULTS = {
   announceToAgent: true,
   maxConcurrentSessions: 3,
   workspaceClaimBoundaries: true,
+  autoSyncSessions: false,
 }
 
 /** Пояснения к полям; повторно используются схемой и карточкой настроек. */
@@ -109,6 +110,7 @@ export const CONFIG_HINTS = {
   permissionGateEnabled: 'Требовать подтверждения человеком для запуска задач с повышенными правами.',
   sessionDefaultPermission: 'Базовый уровень прав без подтверждения. Права выше этого требуют одобрения.',
   announceToAgent: 'Добавлять секцию о доске задач в системный промпт агентов.',
+  autoSyncSessions: 'Автоматически создавать карточки задач для обычных сессий чата DSH.',
 }
 
 /** Поле настроек с пределом числа карточек; задан не у всех колонок. */

package/lib/events.js

@@ -0,0 +1,91 @@
+// Broadcaster для Server-Sent Events (SSE) (#222).
+
+export class KanbanEventHub {
+  constructor(options = {}) {
+    this.clients = new Set()
+    this.heartbeatIntervalMs = options.heartbeatIntervalMs || 15000
+    this.heartbeatTimer = null
+    this._startHeartbeat()
+  }
+
+  _startHeartbeat() {
+    if (this.heartbeatTimer) clearInterval(this.heartbeatTimer)
+    this.heartbeatTimer = setInterval(() => {
+      this._pingAll()
+    }, this.heartbeatIntervalMs)
+    if (this.heartbeatTimer.unref) {
+      this.heartbeatTimer.unref()
+    }
+  }
+
+  _pingAll() {
+    for (const client of this.clients) {
+      try {
+        client.write(':keepalive\n\n')
+      } catch {
+        this.clients.delete(client)
+      }
+    }
+  }
+
+  handleSseRequest(req, res) {
+    res.writeHead(200, {
+      'Content-Type': 'text/event-stream',
+      'Cache-Control': 'no-cache, no-transform',
+      'Connection': 'keep-alive',
+      'X-Accel-Buffering': 'no',
+      'Access-Control-Allow-Origin': '*',
+    })
+
+    res.write(':connected\n\n')
+    this.clients.add(res)
+
+    const cleanup = () => {
+      this.clients.delete(res)
+      try { res.end() } catch {}
+    }
+
+    if (typeof req.on === 'function') req.on('close', cleanup)
+    if (typeof req.on === 'function') req.on('error', cleanup)
+    if (typeof res.on === 'function') res.on('error', cleanup)
+
+    return cleanup
+  }
+
+  broadcast(eventType, payload = {}) {
+    const data = JSON.stringify(payload)
+    const message = `event: ${eventType}\ndata: ${data}\n\n`
+    let sentCount = 0
+
+    for (const client of this.clients) {
+      try {
+        client.write(message)
+        sentCount++
+      } catch {
+        this.clients.delete(client)
+      }
+    }
+
+    return sentCount
+  }
+
+  getClientCount() {
+    return this.clients.size
+  }
+
+  closeAll() {
+    if (this.heartbeatTimer) {
+      clearInterval(this.heartbeatTimer)
+      this.heartbeatTimer = null
+    }
+    for (const client of this.clients) {
+      try {
+        client.write('event: close\ndata: {}\n\n')
+        client.end()
+      } catch {}
+    }
+    this.clients.clear()
+  }
+}
+
+export const eventHub = new KanbanEventHub()

package/lib/index.js

@@ -51,6 +51,8 @@ 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 { eventHub } from './events.js'
+import { TASK_TEMPLATES } from './templates.js'
 
 export { COLUMN_ORDER, wipLimitField, withDefaults } from './config.js'
 
@@ -264,6 +266,49 @@ export function apply(ctx, config) {
   // Признак ожидания, исходы сессий и PROGRESSDUMP по событиям сессии.
   ctx.effect(() => ctx.on('session/event', (session, event) => {
     try {
+      // Автосинхронизация сессий чата DSH в карточки канбана (#225)
+      const sessionIdStr = String(session?.id ?? '')
+      if (
+        getConfig().autoSyncSessions === true &&
+        session &&
+        !session.isSubagent &&
+        session.origin !== 'subagent' &&
+        session.parentId === undefined &&
+        session.meta?.origin !== 'subagent' &&
+        !sessionIdStr.startsWith('kanban-') &&
+        !sessionIdStr.startsWith('kanban_')
+      ) {
+        let existingTask = store?.findTaskBySession?.(sessionIdStr)
+        if (!existingTask && (event?.type === 'turn/start' || event?.type === 'session/created' || event?.type === 'input/user' || event?.type === 'message')) {
+          const userText = (event?.content?.[0]?.text ?? event?.text ?? '').trim()
+          const sessionTitle = session.title || session.name || (userText ? userText.slice(0, 50) : `Диалог ${sessionIdStr.slice(0, 8)}`)
+          const createdTask = store.createTask({
+            title: sessionTitle,
+            body: userText || `Автоматически создано из сессии чата ${sessionIdStr}`,
+            column: 'in-progress',
+            board: 'main',
+            sessionId: sessionIdStr,
+            labels: ['chat-sync'],
+          })
+          if (createdTask) {
+            existingTask = createdTask
+            eventHub.broadcast('task:change', { taskId: createdTask.id, action: 'created' })
+          }
+        } else if (existingTask) {
+          if (event?.type === 'turn/end' || event?.type === 'turn/completed') {
+            if (existingTask.column === 'in-progress') {
+              store.moveTask(existingTask.id, { column: 'review' })
+              eventHub.broadcast('task:change', { taskId: existingTask.id, action: 'moved', toCol: 'review' })
+            }
+          } else if (event?.type === 'turn/error' || event?.type === 'session/error') {
+            if (existingTask.column === 'in-progress') {
+              store.moveTask(existingTask.id, { column: 'todo' })
+              eventHub.broadcast('task:change', { taskId: existingTask.id, action: 'moved', toCol: 'todo' })
+            }
+          }
+        }
+      }
+
       const text = event?.content?.[0]?.text ?? event?.text ?? ''
       const res = handleSessionEvent({
         store,
@@ -741,6 +786,22 @@ export function apply(ctx, config) {
     },
   }), 'dsh-kanban: экспорт в CSV')
 
+  ctx.effect(() => ctx.webServer.register({
+    kind: 'exact',
+    path: '/dsh-kanban/events',
+    handler: (req, res) => {
+      eventHub.handleSseRequest(req, res)
+    },
+  }), 'dsh-kanban: поток живых событий SSE')
+
+  ctx.effect(() => ctx.webServer.register({
+    kind: 'exact',
+    path: '/dsh-kanban/templates',
+    handler: (req, res) => {
+      reply(res, { templates: TASK_TEMPLATES })
+    },
+  }), 'dsh-kanban: шаблоны задач')
+
   ctx.effect(() => ctx.webServer.register({
     kind: 'exact',
     path: '/dsh-kanban/snapshot',
@@ -873,6 +934,7 @@ export function apply(ctx, config) {
             detail: acted === undefined ? '' : (MOVE_DETAIL[acted] ?? ''),
           })
           if (out?.task !== undefined) {
+            eventHub.broadcast('task:change', { taskId: id, action: 'moved', toCol: out.task.column })
             queueOutbound(id, out.task.column)
             if (acted !== undefined) out.command = acted
             if (input.column === 'cleanup' && was?.worktree) {

package/lib/templates.js

@@ -0,0 +1,65 @@
+// Шаблоны задач для быстрой постановки типовых работ (#220).
+
+export const TASK_TEMPLATES = [
+  {
+    id: 'feature',
+    title: 'Новая функциональность (Feature)',
+    promptTemplate: 'Реализовать новую функциональность:\n- Цель:\n- Требования:\n- Границы изменений:',
+    checklist: [
+      { id: '1', text: 'Архитектурный план и дизайн-контракт согласованы', required: true, completed: false },
+      { id: '2', text: 'Код написан с соблюдением стандартов проекта', required: true, completed: false },
+      { id: '3', text: 'Написаны автоматические модульные/интеграционные тесты', required: true, completed: false },
+      { id: '4', text: 'Документация обновлена (README, docs/)', required: true, completed: false },
+    ],
+    priority: 'medium',
+  },
+  {
+    id: 'bugfix',
+    title: 'Исправление ошибки (Bugfix)',
+    promptTemplate: 'Локализовать и исправить дефект:\n- Шаги воспроизведения:\n- Ожидаемое поведение:\n- Фактическое поведение:',
+    checklist: [
+      { id: '1', text: 'Дефект воспроизведен изолированным тестом', required: true, completed: false },
+      { id: '2', text: 'Причина устранена без побочных эффектов', required: true, completed: false },
+      { id: '3', text: 'Регрессионный тест добавлен в test suite', required: true, completed: false },
+    ],
+    priority: 'high',
+  },
+  {
+    id: 'refactor',
+    title: 'Рефакторинг и оптимизация (Refactoring)',
+    promptTemplate: 'Провести рефакторинг модуля без изменения внешнего поведения:\n- Целевой модуль:\n- Проблема архитектуры:\n- Критерии завершения:',
+    checklist: [
+      { id: '1', text: 'Покрыто существующими тестами (100% green)', required: true, completed: false },
+      { id: '2', text: 'Упрощена структура/устранен техдолг', required: true, completed: false },
+      { id: '3', text: 'Производительность не деградировала', required: true, completed: false },
+    ],
+    priority: 'low',
+  },
+  {
+    id: 'security',
+    title: 'Аудит безопасности и зависимостей (Security)',
+    promptTemplate: 'Проверить безопасность и уязвимости зависимостей:\n- Область проверки:\n- Ревизия зависимостей:',
+    checklist: [
+      { id: '1', text: 'Проверен supply-chain и лицензии зависимостей', required: true, completed: false },
+      { id: '2', text: 'Устранены известные CVE', required: true, completed: false },
+      { id: '3', text: 'Секреты и токены проверены на отсутствие утечек', required: true, completed: false },
+    ],
+    priority: 'high',
+  },
+  {
+    id: 'release',
+    title: 'Подготовка и выпуск релиза (Release Prep)',
+    promptTemplate: 'Подготовить релиз пакета:\n- Версия:\n- Список изменений:\n- Проверки перед публикацией:',
+    checklist: [
+      { id: '1', text: 'Все тесты репозитория пройдены (npm test)', required: true, completed: false },
+      { id: '2', text: 'Совместимость с ядром подтверждена (npm run compat)', required: true, completed: false },
+      { id: '3', text: 'Размер упакованного пакета проверен (< 256 КБ)', required: true, completed: false },
+      { id: '4', text: 'Документация и changelog дополнены', required: true, completed: false },
+    ],
+    priority: 'medium',
+  },
+]
+
+export function getTemplateById(id) {
+  return TASK_TEMPLATES.find((t) => t.id === id)
+}

package/lib/worktree.js

@@ -13,7 +13,8 @@
 
 import { execFile } from 'node:child_process'
 import { promisify } from 'node:util'
-import { existsSync, readFileSync } from 'node:fs'
+import { existsSync, readFileSync, readdirSync } from 'node:fs'
+import { basename, relative } from 'node:path'
 import { isAbsolute, join, resolve, sep } from 'node:path'
 
 const execFileAsync = promisify(execFile)
@@ -526,3 +527,98 @@ export async function mergeTaskWorktree({
 
   return { success: true, merged: true, targetBranch: target }
 }
+
+
+/**
+ * Рекурсивное обнаружение всех git-репозиториев в каталоге воркспейса (#210).
+ *
+ * @param {string} rootDir Корневой каталог для поиска
+ * @param {{maxDepth?: number, maxRepos?: number, gitRunner?: Function}} options
+ * @returns {Promise<Array<{relPath: string, fullPath: string, name: string}>>}
+ */
+export async function findWorkspaceGitRepos(rootDir, options = {}) {
+  const maxDepth = options.maxDepth ?? 3
+  const maxRepos = options.maxRepos ?? 20
+  const gitRunner = options.gitRunner ?? defaultGitRunner
+
+  if (!rootDir || !existsSync(rootDir)) return []
+
+  const results = []
+
+  async function scan(dir, depth) {
+    if (depth > maxDepth || results.length >= maxRepos) return
+    try {
+      const isRepo = await isGitRepo(dir, gitRunner)
+      if (isRepo) {
+        const rel = relative(rootDir, dir) || '.'
+        results.push({
+          relPath: rel,
+          fullPath: resolve(dir),
+          name: basename(resolve(dir)),
+        })
+        // Если это репозиторий (не root), глубже в него обычно не сканируем (кроме субмодулей если нужно)
+        if (depth > 0) return
+      }
+
+      const entries = readdirSync(dir, { withFileTypes: true })
+      for (const entry of entries) {
+        if (!entry.isDirectory()) continue
+        if (entry.name === '.git' || entry.name === 'node_modules' || entry.name === '.worktrees') continue
+        await scan(join(dir, entry.name), depth + 1)
+      }
+    } catch {
+      // Игнорируем недоступные директории
+    }
+  }
+
+  await scan(rootDir, 0)
+  return results
+}
+
+/**
+ * Подготовка мультирепозиторного зеркалирования для воркспейса с несколькими git-репозиториями (#210).
+ *
+ * @param {{task: object, workspacePath: string, gitRunner?: Function, config?: object}} options
+ * @returns {Promise<{mirrors: Array<{repo: string, worktreePath: string, branch: string}>, errors?: Array<string>}>}
+ */
+export async function prepareMultiRepoMirror({ task, workspacePath, gitRunner = defaultGitRunner, config }) {
+  if (!workspacePath || !existsSync(workspacePath)) {
+    return { mirrors: [], errors: ['workspace-path-not-found'] }
+  }
+
+  const repos = await findWorkspaceGitRepos(workspacePath, { gitRunner })
+  const mirrors = []
+  const errors = []
+  const branchName = resolveTaskBranch(task)
+
+  for (const repo of repos) {
+    try {
+      const mirrorRoot = resolve(workspacePath, '.dsh-worktrees', task.id, repo.relPath === '.' ? 'root' : repo.relPath)
+      const existing = await listWorktrees(repo.fullPath, gitRunner)
+      if (existing.includes(mirrorRoot)) {
+        mirrors.push({ repo: repo.name, worktreePath: mirrorRoot, branch: branchName, reused: true })
+        continue
+      }
+
+      let branchExists = false
+      try {
+        await gitRunner(['rev-parse', '--verify', '--quiet', `refs/heads/${branchName}`], repo.fullPath)
+        branchExists = true
+      } catch {
+        branchExists = false
+      }
+
+      if (branchExists) {
+        await gitRunner(['worktree', 'add', mirrorRoot, branchName], repo.fullPath)
+      } else {
+        const baseRef = await determineBaseRef(repo.fullPath, gitRunner)
+        await gitRunner(['worktree', 'add', '-b', branchName, mirrorRoot, baseRef], repo.fullPath)
+      }
+      mirrors.push({ repo: repo.name, worktreePath: mirrorRoot, branch: branchName, created: true })
+    } catch (err) {
+      errors.push(`${repo.name}: ${err?.message || 'failed'}`)
+    }
+  }
+
+  return { mirrors, errors: errors.length > 0 ? errors : undefined }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@goodandready/dsh-kanban",
-  "version": "0.1.35",
+  "version": "0.2.1",
   "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",