@goodandready/dsh-kanban 0.2.1 → 0.2.7

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 } }
+  }
+}

package/lib/store.js

@@ -70,6 +70,8 @@ CREATE TABLE IF NOT EXISTS tasks (
   comments              TEXT NOT NULL DEFAULT '[]',
   rejectReason          TEXT NOT NULL DEFAULT '',
   rejectedAt            INTEGER NOT NULL DEFAULT 0,
+  parentId              TEXT NOT NULL DEFAULT '',
+  isEpic                INTEGER NOT NULL DEFAULT 0,
   updatedAt    INTEGER NOT NULL
 );
 CREATE INDEX IF NOT EXISTS tasks_board_col ON tasks(board, col, position);
@@ -98,7 +100,8 @@ const WRITABLE = [
   'title', 'body', 'owner', 'repo', 'issueNumber', 'issueUrl', 'labels',
   'branch', 'worktree', 'workspaceId', 'sessionId', 'model', 'provider', 'waiting', 'syncedAt', 'plan',
   'labelColors', 'queuedAt', 'createdAt', 'author', 'assignee', 'milestone', 'priority', 'dueAt',
-  'cron', 'nextRunAt', 'lastRunAt', 'progressDump', 'permission', 'reasoningEffort', 'permissionConfirmedAt', 'runs', 'checklist', 'report', 'comments', 'rejectReason', 'rejectedAt',
+  'cron', 'nextRunAt', 'lastRunAt', 'progressDump', 'permission', 'reasoningEffort', 'permissionConfirmedAt',
+  'runs', 'checklist', 'report', 'comments', 'rejectReason', 'rejectedAt', 'parentId', 'isEpic',
 ]
 
 /** Источники перехода; чужое значение не пишем, чтобы журнал оставался читаемым. */
@@ -106,7 +109,7 @@ const SOURCES = new Set(['manual', 'session', 'gitea', 'tool'])
 
 function rowToTask(row) {
   if (row === undefined) return undefined
-  const { col, labels, waiting, labelColors, runs, checklist, report, comments, rejectReason, rejectedAt, ...rest } = row
+  const { col, labels, waiting, labelColors, runs, checklist, report, comments, rejectReason, rejectedAt, isEpic, parentId, ...rest } = row
   let parsedChecklist = []
   try {
     const value = JSON.parse(checklist ?? '[]')
@@ -150,6 +153,8 @@ function rowToTask(row) {
     rejectReason: rejectReason ?? '',
     rejectedAt: Number(rejectedAt) || 0,
     reasoningEffort: rest.reasoningEffort ?? '',
+    isEpic: isEpic === 1,
+    parentId: parentId ?? '',
   }
 }
 
@@ -194,6 +199,8 @@ export function openStore({ dir }) {
     ['comments', "TEXT NOT NULL DEFAULT '[]'"],
     ['rejectReason', "TEXT NOT NULL DEFAULT ''"],
     ['rejectedAt', "INTEGER NOT NULL DEFAULT 0"],
+    ['parentId', "TEXT NOT NULL DEFAULT ''"],
+    ['isEpic', "INTEGER NOT NULL DEFAULT 0"],
   ]) {
     try { db.exec(`ALTER TABLE tasks ADD COLUMN ${column} ${definition}`) } catch { /* столбец уже есть */ }
   }
@@ -202,6 +209,15 @@ export function openStore({ dir }) {
   // заведения: это честнее нуля, который читался бы как «в 1970 году».
   db.exec('UPDATE tasks SET columnAt = createdAt WHERE columnAt = 0')
 
+  // Индексы для ускорения выборок активных задач, поиска по Gitea issue и cron-задач
+  db.exec('CREATE INDEX IF NOT EXISTS tasks_board_active ON tasks(board, archivedAt, col, position)')
+  db.exec('CREATE INDEX IF NOT EXISTS tasks_gitea_issue ON tasks(owner, repo, issueNumber)')
+  db.exec('CREATE INDEX IF NOT EXISTS tasks_cron_next ON tasks(archivedAt, nextRunAt)')
+  db.exec('CREATE INDEX IF NOT EXISTS tasks_queued ON tasks(archivedAt, queuedAt)')
+  db.exec('CREATE INDEX IF NOT EXISTS tasks_parent_id ON tasks(parentId)')
+  db.exec('PRAGMA synchronous = NORMAL')
+  try { db.exec('PRAGMA optimize') } catch {}
+
   const q = {
     boards: db.prepare('SELECT * FROM boards ORDER BY position'),
     boardById: db.prepare('SELECT * FROM boards WHERE id = ?'),
@@ -227,6 +243,9 @@ export function openStore({ dir }) {
       "SELECT * FROM tasks WHERE issueNumber IS NOT NULL AND col NOT IN ('done') ORDER BY updatedAt DESC"),
     scheduledDue: db.prepare(
       "SELECT * FROM tasks WHERE cron != '' AND nextRunAt > 0 AND nextRunAt <= ? AND archivedAt = 0 ORDER BY nextRunAt ASC"),
+    subtasksOf: db.prepare('SELECT * FROM tasks WHERE parentId = ? AND archivedAt = 0 ORDER BY createdAt ASC, position ASC'),
+    countSubtasks: db.prepare(
+      "SELECT COUNT(*) AS total, SUM(CASE WHEN col = 'done' THEN 1 ELSE 0 END) AS completed FROM tasks WHERE parentId = ? AND archivedAt = 0"),
   }
 
   function ensureBoard(id, title, kind) {
@@ -358,8 +377,8 @@ export function openStore({ dir }) {
          labels, branch, worktree, workspaceId, sessionId, model, provider, waiting, syncedAt,
          labelColors, author, assignee, milestone, priority, dueAt, columnAt, createdAt, updatedAt,
          cron, nextRunAt, lastRunAt, progressDump, permission, permissionConfirmedAt, runs,
-         checklist, report, comments, rejectReason, rejectedAt, reasoningEffort)
-        VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`).run(
+         checklist, report, comments, rejectReason, rejectedAt, reasoningEffort, parentId, isEpic)
+        VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`).run(
         id, board, column, position,
         input.title ?? '', input.body ?? '',
         input.owner ?? null, input.repo ?? null,
@@ -389,6 +408,8 @@ export function openStore({ dir }) {
         input.rejectReason ?? '',
         Number(input.rejectedAt) || 0,
         typeof input.reasoningEffort === 'string' ? input.reasoningEffort : '',
+        input.parentId ?? '',
+        input.isEpic ? 1 : 0,
       )
       return rowToTask(q.taskById.get(id))
     },
@@ -411,6 +432,8 @@ export function openStore({ dir }) {
         else if (key === 'rejectReason') values.push(String(patch[key] ?? ''))
         else if (key === 'waiting') values.push(patch[key] ? 1 : 0)
         else if (key === 'syncedAt') values.push(Number(patch[key]) || 0)
+        else if (key === 'isEpic') values.push(patch[key] ? 1 : 0)
+        else if (key === 'parentId') values.push(String(patch[key] ?? ''))
         else values.push(patch[key] ?? null)
       }
       if (fields.length > 0) {
@@ -546,6 +569,21 @@ export function openStore({ dir }) {
       return rowToTask(q.byIssue.get(owner, repo, issueNumber))
     },
 
+    listSubtasks(parentId) {
+      if (!parentId) return []
+      return q.subtasksOf.all(parentId).map(rowToTask)
+    },
+
+    countSubtasks(parentId) {
+      if (!parentId) return { total: 0, completed: 0 }
+      const res = q.countSubtasks.get(parentId)
+      return { total: res?.total ?? 0, completed: res?.completed ?? 0 }
+    },
+
+    setParent(id, parentId) {
+      return this.updateTask(id, { parentId: parentId ?? '' })
+    },
+
     /** Задачи в архиве: свой список, а не колонка. */
     listArchived() {
       return q.archived.all().map(rowToTask)

package/lib/sync.js

@@ -9,6 +9,29 @@ import { watchedRepos, shouldTake, archiveBefore, isWatched } from './intake.js'
 import { colorsOfIssue } from './filters.js'
 import { issueToTask, issueBornAt, issueAuthor, issueAssignee, issueMilestone } from './import.js'
 
+/**
+ * Выполнить операцию с экспоненциальной задержкой (exponential backoff) при сбоях сети.
+ * @template T
+ * @param {() => Promise<T>} fn асинхронная операция
+ * @param {{retries?: number, baseMs?: number, maxMs?: number}} [opts]
+ * @returns {Promise<T>}
+ */
+export async function withBackoff(fn, { retries = 2, baseMs = 50, maxMs = 500 } = {}) {
+  let attempt = 0
+  let firstErr
+  while (true) {
+    try {
+      return await fn()
+    } catch (err) {
+      if (!firstErr) firstErr = err
+      if (attempt >= retries) throw (firstErr || err)
+      const delay = Math.min(baseMs * (2 ** attempt), maxMs)
+      attempt += 1
+      await new Promise((resolve) => setTimeout(resolve, delay))
+    }
+  }
+}
+
 /**
  * Наблюдения по одному репозиторию.
  *
@@ -202,7 +225,7 @@ export async function syncAll({ gitea, store, logger, only, now = Date.now() })
   for (const group of byRepo.values()) {
     let repoState
     try {
-      repoState = await readRepo({ gitea, owner: group.owner, repo: group.repo })
+      repoState = await withBackoff(() => readRepo({ gitea, owner: group.owner, repo: group.repo }), { retries: 2, baseMs: 40 })
     } catch (error) {
       failed += group.tasks.length
       reposFailed += 1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@goodandready/dsh-kanban",
-  "version": "0.2.1",
+  "version": "0.2.7",
   "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",
@@ -14,7 +14,8 @@
     "lib/",
     "cordis.patch.yml",
     "README.md",
-    "docs/",
+    "README.zh.md",
+    "README.ru.md",
     "LICENSE"
   ],
   "scripts": {

package/docs/design/DESIGN.md

@@ -1,93 +0,0 @@
-# DESIGN.md — dsh-kanban
-
-## Product / Purpose
-- Назначение: Интегрированная доска задач для DeepSeek Harness с двусторонней сверкой с Gitea, автоматическим подхватом сессий агентов и управлением жизненным циклом.
-- Аудитория: Разработчики и операторы DeepSeek Harness, ведущие проектные задачи и сессии агентов.
-- Статус: Production, версия 0.1.23+.
-
-## User Surfaces
-- Web/UI: Экран доски в центральной колонке интерфейса DSH (mountBoard), выдвигающаяся панель задач, фильтры, группировки (по проектам, по исполнителю), метрики переходов.
-- DSH UI / settings / slots:
-  - Карточка настроек в слоте settings.plugin.item (пространство dsh-kanban).
-  - Чип активной задачи в conversation.session.header.utilities.
-  - Пункт бокового меню для вызова экрана доски.
-- API: HTTP эндпоинты /dsh-kanban/* (board, snapshot, task, sync, webhook, metrics, whoami, checklist, report, comments, accept, reject).
-- CLI: node tools/compat.mjs (проверка совместимости экспортов ядра).
-- Документация: README.md, docs/README.ru.md, docs/README.zh.md, index.md.
-
-## Visual Direction
-- Атмосфера: Строгий утилитарный инструментальный интерфейс в едином стиле темы DeepSeek Harness.
-- Утверждённые референсы и что из них берём: Системные карточки DSH (стили заголовков, отступы, шрифты, цветовые токены --dsw-alias-*).
-- Не копировать: Внешние неинтегрированные темы, разнородные цвета рамок и теней.
-
-## Foundations
-- Цвета и роли: Использование CSS-переменных DSH темы (--dsw-alias-bg-layer-3, --dsw-alias-border-l2, --dsw-alias-label-primary, --dsw-alias-label-secondary).
-- Типографика: Системный стек шрифтов DSH (inherit, 13-14px базовый размер, 11-12px для бейджей и служебных меток).
-- Сетка, отступы, responsive: 5 стандартных колонок (backlog, ready, progress, review, done) с горизонтальным скроллом и адаптивными карточками.
-- Accessibility: Нативные кнопки button, role="status" для сообщений, семантичные поля ввода с aria-label/label.
-
-## Components And States
-- Компоненты: BoardScreen, Column, Card, TaskDrawer (включая секции DoD Checklist, Execution Report, Comments Thread, Review Acceptance Gate), KanbanSettingsCard, TaskChip, MetricsModal.
-- Loading / empty / error / success:
-  - Загрузка: состояние скелетона/лоадера без блокировки скролла.
-  - Пустые колонки: пунктирная область перетаскивания.
-  - Ошибки: всплывающий баннер с ключом локализации t('error.' + err).
-- Формы, валидация и действия: Валидация обязательных полей при создании задачи, блокировка повторных кликов при сохранении.
-
-## User Flows
-- Критические сценарии:
-  1. Создание задачи / подхват из Gitea Issue.
-  2. Перемещение карточки между колонками человеком или через инструмент агента board_move.
-  3. Запуск сессии агента по карточке с автоматическим назначением ответственного.
-  4. Автоматическое обновление статуса (waiting) по событиям ядра (session/event).
-  5. Экспорт и импорт снимка доски в JSON.
-
-## Do / Don't
-- Do: Использовать только токены темы --dsw-alias-*, очищать все слушатели событий при размонтировании, соблюдать порядок хуков React.
-- Don't: Не переводить карточку в done агентом (колонка done фиксируется только по факту закрытия issue и ветки).
-
-## Locked Design Decisions
-- 2026-08-20 — Карточка настроек монтируется в settings.plugin.item с резервом в settings.section.
-- 2026-08-25 — Использование дробной индексации ($O(1)$) для позиционирования карточек.
-- 2026-09-02 — Снимок доски объединён на маршруте /dsh-kanban/snapshot (GET: выгрузка, POST: загрузка).
-- 2026-09-03 — Изоляция сессий задач в git worktree ($DSH_HOME/worktrees/<repo-key>/<task-id>/ на ветке task/<id>-<slug>), регистрация воркдерева в workspaceRegistry, проверка dirtyFiles и безопасная очистка в фазе cleanup (#193).
-- 2026-09-03 — Серверная инфраструктура автономности и безопасности (#195): Host-Side 5-field Cron, PowerInhibitor (кроссплатформенная блокировка сна системы во время работы задач), PROGRESSDUMP (фиксация срезов контекста, маскирование секретов и передача эстафеты), Permission Confirmation Gate (ручное одобрение прав выше базовых), инъекция секции доски в systemPrompt и хранение истории запусков прямо в карточке задачи (tasks.runs).
-
-- 2026-09-07 — Контур качества и приёмка человеком (#205–#209):
-  - Протокольный шлюз: колонка done является исключительной границей приёмки человеком; инструменту board_move запрещён прямой перевод задачи в done.
-  - DoD Acceptance Checklist: перевод в review блокируется до закрытия обязательных пунктов чеклиста с фиксацией доказательств (evidence).
-  - Structured Report: фиксация отчёта выполнения (summary, changedFiles, checksRun, artifacts, risks) в карточке задачи.
-  - Двусторонний цикл приёмки: явные действия человека Accept (в done) и Reject (возврат в in-progress с обязательной причиной rejectReason, инжектируемой в следующую сессию агента).
-  - Ветка комментариев к задаче с поддержкой ролей user и agent для сквозного диалога прямо в Task Drawer.
-
-- 2026-09-08 — Стабильность сессий и воркдеревьев (#227, #226, #213, #215):
-  - Привязка проекта сессии: при создании агента с воркдеревом поле 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).
-## 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).
-- **Экспорт в CSV с UTF-8 BOM**: Добавлен эндпоинт `GET /dsh-kanban/export.csv` и кнопка в тулбаре для выгрузки аналитики задач в Microsoft Excel без искажения кодировки.
-- **Адаптивный 36x36 Rail Icon**: Кнопка канбана в сайдбаре автоматически принимает компактный размер 36×36 px с центрированием иконки при сворачивании панели в rail.
-- **Lightbox для изображений**: Превью Markdown-изображений в карточке открываются в модальном полноэкранном лайтбоксе.
-
-
-### 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 копий перед перезаписью данных.