@goodandready/dsh-kanban 0.2.2 → 0.2.7

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.2",
+  "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,94 +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 исключён по #238).
-- 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.2 (Issue #238)**: Удалён устаревший фоллбэк на `settings.section` в пользу строгого размещения карточки в `settings.plugin.item`; все обращения к службам Cordis (в частности к `llm`) приведены к каноническому `ctx.get('...')`.
-- **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 копий перед перезаписью данных.

package/docs/plans/2026-08-26-dsh-kanban-0.1.md

@@ -1,169 +0,0 @@
-# dsh-kanban — план реализации
-
-> **Для исполнителя:** это план для агента, у которого нет контекста обсуждения.
-> Перед любой правкой плагина DSH загрузи `dsh-plugin-authoring`.
-> Перед правкой профиля `web` — `dsh-web-profile-repair`.
-> Работа ведётся по `gitea-project-workflow`: issue → worktree от свежего
-> `origin/main` → WIP PR → ревью → merge → deploy → cleanup → закрытие issue.
-
-**Цель:** доска задач внутри DeepSeek Harness, которая берёт задачи из Gitea,
-показывает по ним ход работы и умеет запускать по каждой задаче отдельную
-сессию агента с выбранной моделью.
-
-**Архитектура:** отдельный плагин `@goodandready/dsh-kanban` со своим
-хранилищем задач. Gitea-доступ не дублируется — используется существующий
-плагин `@goodandready/dsh-gitea`, которому для этого добавляется сервис cordis.
-Запуск работы идёт через штатные сервисы ядра `agents`/`sessions`; плагин
-поднимает сессию и отдаёт первое сообщение, дальше работу ведёт агент по
-действующему воркфлоу.
-
-**Стек:** Node (ESM), cordis, `@deepseek-ai/schemastery`, React в браузерной
-половине через `window.__ModuleLoader__`, хранилище — `node:sqlite`.
-
-## Глобальные ограничения
-
-- Имя пакета `@goodandready/dsh-kanban` обязано совпадать в трёх местах:
-  `package.json` → `name`, `cordis.patch.yml` → `name:`, `lib/client.js` →
-  `load({ id })`. Короткий id патча — `dsh-kanban`.
-- Пространство настроек: `dsh-kanban`. Ключ слота карточки настроек обязан быть
-  равен пространству настроек, иначе карточка молча не появится.
-- Настройки — карточкой в `settings.plugin.item`. Свой раздел настроек НЕ
-  заводить. Раздел верхнего уровня заводится только для экрана доски.
-- Токен Gitea плагин не хранит, не спрашивает и не логирует. Доступ — только
-  через сервис `gitea` из `dsh-gitea`.
-- Ни абсолютных путей, ни адресов инстансов, ни имён машин в коде и README.
-  Машинно-зависимое живёт в настройках с пустым значением по умолчанию.
-- Все Git-операции — только через wrapper `git-<agent>`. Bare `git` запрещён.
-- Conventional Commits обязательны: `<type>(<scope>)!: <действие>`, footer
-  `Refs: #<номер>`.
-- Тесты идут без харнесса и без сети: `node --test test/*.test.mjs`.
-- Всё поднятое в `ctx.effect` гасится возвращённым уборщиком.
-- Хуки React объявляются выше всех возвратов.
-
-## Колонки доски
-
-Колонки повторяют реальный воркфлоу, а не абстрактный «в работе → готово».
-
-| Колонка | Признак входа |
-|---|---|
-| `backlog` | issue есть, никто не взял |
-| `in-progress` | сессия поднята, в issue есть стартовый комментарий с планом и веткой |
-| `review` | PR снят с WIP, ревьюер даёт PASS/FAIL |
-| `deploy` | PR влит в `main`, ждём согласованный deploy и production-проверку |
-| `cleanup` | ветка в Gitea, worktree и локальная ветка ещё не удалены |
-| `done` | issue закрыт И cleanup записан в итоговом комментарии |
-
-Колонка `cleanup` существует потому, что по воркфлоу задача не завершена, пока
-cleanup не сделан и не записан. Доска, отправляющая карточку в `done` по merge,
-будет врать ровно там, где копятся забытые ветки.
-
-WIP PR НЕ двигает карточку в `review`: он открывается рано и означает «работа
-идёт», а не «смотрите».
-
-## Что плагин НЕ делает
-
-Эти границы заданы воркфлоу и нарушать их нельзя:
-
-- Не создаёт ветки и worktree. По воркфлоу агент сначала делает preflight
-  (открытые ветки, `git status --short`) и только потом заводит worktree от
-  свежего `origin/main`. Плагин, создающий ветку заранее, ломает preflight.
-- Не пишет стартовый комментарий в issue — это делает агент после preflight.
-- Ветка и worktree на карточке — НАБЛЮДЕНИЕ, вычитанное из issue и событий
-  Gitea, а не намерение, заданное плагином.
-- Не трогает Hermes Kanban. Это другая система, и она этому CLI запрещена.
-
-## Выпуски
-
-**0.1 — доска, импорт, запуск.** Задачи хранятся локально, импортируются из
-Gitea по кнопке, карточки двигаются вручную, по кнопке «Начать» поднимается
-сессия с выбранной моделью. Синхронизация односторонняя: Gitea → канбан, в
-момент импорта и по кнопке обновления.
-
-**0.2 — автоперемещение.** События сессии агента, события Gitea, журнал
-переходов с источником. Инструмент `board_move` для агента пишется, но по
-умолчанию выключен — включается вместе с правкой скилла
-`gitea-project-workflow`.
-
-**0.3 — двусторонняя синхронизация.** Вебхуки Gitea, разрешение конфликтов по
-времени изменения, очередь повторов, деградация до опроса.
-
-## Состав 0.1
-
-| Issue | Репозиторий | Тема |
-|---|---|---|
-| G1 | dsh-gitea | Выставить сервис `gitea` наружу |
-| G2 | dsh-gitea | Техдолг: `gitea_worktree_add` зовёт bare git |
-| K1 | dsh-kanban | Каркас плагина и карточка настроек |
-| K2 | dsh-kanban | Хранилище задач |
-| K3 | dsh-kanban | HTTP-маршруты доски |
-| K4 | dsh-kanban | Импорт задачи из Gitea |
-| K5 | dsh-kanban | Экран доски |
-| K6 | dsh-kanban | Запуск работы по задаче |
-| K7 | dsh-kanban | Чип задачи в шапке чата |
-| K8 | dsh-kanban | Документация и релизный гейт 0.1 |
-
-Порядок: G1 → K1 → K2 → K3 → (K4, K5 параллельно) → K6 → K7 → K8.
-G2 независим и может идти когда угодно.
-
-## Структура файлов
-
-```
-lib/index.js        точка входа хоста: Config, apply, регистрация маршрутов
-lib/store.js        хранилище задач: схема, CRUD, дробный индекс
-lib/order.js        дробный индекс (чистая функция, без БД)
-lib/import.js       перенос issue Gitea в задачу доски
-lib/launcher.js     запуск сессии по задаче
-lib/routes.js       обработчики HTTP
-lib/client.js       браузерная половина: раздел доски, карточка настроек, чип
-test/*.test.mjs     тесты без харнесса и без сети
-```
-
-Разделение по ответственности, а не по слою. `order.js` отделён от `store.js`
-потому, что дробный индекс — единственная нетривиальная логика в хранилище и
-проверяется без БД вообще.
-
-## Проверенные интерфейсы ядра
-
-Ниже — реальные сигнатуры, снятые с исходников, а не пересказ. Исполнитель
-может опираться на них как есть.
-
-Создание сессии с выбранной моделью и первое сообщение:
-
-```js
-import { SessionId } from '@deepseek-ai/dsh-session'
-import { createUserMessage } from '@deepseek-ai/dsh-llm'
-
-const handle = await ctx.agents.create({
-  sessionId: SessionId(`kanban-${taskId}-${randomUUID()}`),
-  meta: { cwd },                       // ОБЯЗАТЕЛЬНО абсолютный путь
-  agentOptions: { provider, model },   // maxTokens необязателен
-})
-await handle.agent.whenIdle()
-handle.agent.followup(createUserMessage({
-  content,
-  source: { kind: 'plugin', plugin: 'dsh-kanban', form: 'task-start' },
-}))
-```
-
-- `ctx.agents.create(options)` возвращает `AgentHandle` с полями `agent` и
-  `dispose`. Живой образец — `dsh-messenger-gateway/lib/gateway.js:465`.
-- `meta.cwd` валидируется ядром: неабсолютный путь бросает исключение.
-- `agent.followup(message)` ставит обычный следующий ход и будит драйвер.
-- `agent.session.id` — идентификатор сессии, по нему карточка связывается с
-  чатом.
-- Модель по умолчанию берётся из сервиса `agentDefaultModel`; образец
-  разрешения провайдера и модели — `gateway.js:455`.
-
-События сессии, нужные в 0.2: `assistant/message`, `turn/end`,
-`approval/asked` (несёт `id`, имя инструмента, причину), `question/requested`.
-
-## Открытый технический риск
-
-`node:sqlite` — встроенный модуль Node, но он появился не во всех версиях.
-ПЕРВЫЙ шаг задачи K2 — проверить, что модуль есть в той версии Node, на которой
-крутится харнесс. Если модуля нет, хранилище делается на одном JSON-файле с
-атомарной записью (запись во временный файл рядом, затем `rename`), а схема
-таблиц из K2 переносится в форму объекта один-в-один. Дробный индекс и весь
-остальной план от выбора хранилища не зависят.
-
-Решение принимается фактом проверки, а не догадкой, и записывается в issue K2.

package/docs/plans/2026-09-07-quality-acceptance-gateway.md

@@ -1,25 +0,0 @@
-# План реализации: Human-in-the-Loop Quality & Acceptance Gateway (#205–#209)
-
-Пакетная реализация сквозного контура контроля качества и человеческой приёмки для `@goodandready/dsh-kanban`:
-- **#205**: DoD Acceptance Checklist с фиксацией доказательств (`board_checklist`)
-- **#206**: Структурированный отчёт выполнения задачи (`board_report`)
-- **#207**: Двусторонний цикл приёмки человеком (Accept / Send back with reason)
-- **#208**: Ветка комментариев к задаче и синхронизация с агентом (`board_comments`, `board_comment_add`)
-- **#209**: Протокольный шлюз запрета перевода задачи в Done агентом
-
-## 1. Архитектурные требования
-1. **Протокольный шлюз Done (#209)**: агент через инструмент `board_move` не может перевести задачу в `done`. Статус `done` может быть установлен только человеком.
-2. **Шлюз перехода в Review (#205)**: если в задаче заданы обязательные пункты Definition of Done, переход в `review` блокируется до закрытия всех обязательных пунктов с предоставлением evidence.
-3. **Отчёт выполнения (#206)**: агент формирует структурированный отчёт (`board_report`) с полями `summary`, `changed_files`, `checks_run`, `artifacts`, `risks`.
-4. **Приёмка и возврат (#207)**: в колонке `review` человек может нажать «Принять» (в `done`) или «Вернуть» (в `in-progress`) с обязательным указанием причины, которая инжектируется в следующую сессию агента.
-5. **Обсуждение задачи (#208)**: карточка содержит тред комментариев с поддержкой ролей `user` и `agent`, доступный через HTTP API и инструменты `board_comments`, `board_comment_add`.
-
-## 2. Пошаговые задачи
-- [ ] 1. Модель данных и миграции SQLite в `lib/store.js`.
-- [ ] 2. Инструменты агента `board_checklist`, `board_report`, `board_comments`, `board_comment_add`, валидаторы `board_move` в `lib/board-tool.js`.
-- [ ] 3. Регистрация инструментов в `lib/index.js`.
-- [ ] 4. Маршруты `/accept`, `/reject`, `/checklist`, `/report`, `/comments` в `lib/routes.js`.
-- [ ] 5. Инъекция замечаний возврата и DoD в `lib/launcher.js`.
-- [ ] 6. Пользовательский интерфейс Task Drawer и карточек в `lib/client.js`.
-- [ ] 7. Юнит-тесты: `test/checklist.test.mjs`, `test/report.test.mjs`, `test/acceptance.test.mjs`, `test/comments.test.mjs`.
-- [ ] 8. Актуализация `docs/design/DESIGN.md`.

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

@@ -1,8 +0,0 @@
-# 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

@@ -1,7 +0,0 @@
-# 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/docs/plans/2026-09-08-session-worktree-stability.md

@@ -1,33 +0,0 @@
-# План: Вектор 1 — Стабильность сессий и воркдеревьев (#227, #226, #213, #215)
-
-## 1. Контекст и цели
-Повышение отказоустойчивости жизненного цикла сессий задач в DSH Kanban:
-- Сохранение привязки сессии к проекту в левом сайдбаре DSH (meta.cwd = projectRoot) при изоляции в воркдереве (#227).
-- Возможность продолжить работу над задачей («↻ Продолжить / Resume») в существующем воркдереве без деструктивного сброса ветки (#226).
-- Игнорирование структурного шума субмодулей и gitlink drift в проверках чистоты воркдерева checkWorktreeDirty (#213).
-- Исключение дочерних сессий субагентов (invoke_subagent) из списка живых сессий и трекинга карточек (#215).
-
-## 2. Архитектурные изменения
-- **lib/worktree.js**:
-  - checkWorktreeDirty: вызов gitRunner(['status', '--porcelain', '--ignore-submodules=all'], worktreePath) для устранения ложного dirty-статуса от субмодулей.
-- **lib/launcher.js**:
-  - obtainAgent: meta.cwd фиксируется как projectRoot, meta.worktreePath = worktreePath.
-  - 
-  - liveSessions: фильтрация сессий с origin === 'subagent' или parentId !== undefined.
-- **lib/lifecycle.js**:
-  - handleSessionEvent: игнорирование событий от сессий-субагентов.
-- **lib/routes.js**:
-  - Эндпоинт POST /tasks/:id/resume.
-- **lib/index.js**:
-  - Регистрация маршрута /dsh-kanban/tasks/:id/resume.
-- **lib/client.js**:
-  - Кнопка «↻ Resume» в TaskDrawer.
-
-## 3. Верификация
-- Юнит-тесты: 	est/worktree-dirty.test.mjs, 	est/launcher-cwd.test.mjs, 	est/resume.test.mjs, 	est/subagent-filter.test.mjs.
-- Полный прогон 
-pm test и 
-pm run compat.
-- Проверка пакета 
-pm pack --dry-run --json.
-- Тест на MiniPC test runner через dsh-test-plugin.

package/docs/plans/2026-09-10-issue-238-settings-scope.md

@@ -1,13 +0,0 @@
-# Issue #238: Убрать settings.section fallback и перевести обращение к службам на ctx.get
-
-## Контекст
-Issue #238 (priority/low, type/tech-debt, scope/webui) указывает:
-1. Карточка настроек регистрирует запасной слот settings.section (строку в боковом списке настроек). Согласно дизайн-контракту и политике DSH-плагинов, боковой список настроек плоский и перегружен, а набор полей плагина должен жить исключительно как карточка внутри «Настройки → Плагины → Настройки плагинов» (settings.plugin.item).
-2. В коде обнаружено обращение ctx.llm вместо канонического ctx.get('llm'). Контекст Cordis оборачивается в прокси, и свойства-поля могут возвращать undefined, поэтому доступ к службам должен выполняться строго через ctx.get('...').
-
-## План работ
-- [ ] 1. Исправить вызовы ctx.llm на ctx.get('llm') в lib/index.js (GET /dsh-kanban/models).
-- [ ] 2. В lib/client.js убрать запасную регистрацию settings.section, оставив карточку только в слоте settings.plugin.item.
-- [ ] 3. Актуализировать тесты в test/board-ui.test.mjs и test/identity.test.mjs.
-- [ ] 4. Обновить docs/design/DESIGN.md (зафиксировать решение #238).
-- [ ] 5. Выполнить полный тестовый прогон npm test (все 651 тест) и npm run compat.