@goodandready/dsh-kanban 0.1.30 → 0.1.32

package/docs/design/DESIGN.md

@@ -64,4 +64,10 @@
   - Привязка проекта сессии: при создании агента с воркдеревом поле 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 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/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',
@@ -1195,6 +1197,8 @@ window.__ModuleLoader__.load({
       'field.sessionDefaultPermission': '基线默认权限',
       'hint.sessionDefaultPermission': '超出此权限的任务需要点击人工确认。',
       'field.announceToAgent': '在系统提示词中声明看板',
+      'field.maxConcurrentSessions': '最大并发会话数',
+      'field.workspaceClaimBoundaries': '工作区认领边界',
       'hint.announceToAgent': '向 Agent 系统提示词注入看板与进度协作说明。',
       'task.runs': '执行历史',
       'task.noRuns': '暂无执行记录',
@@ -1513,6 +1517,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) {

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,7 +28,7 @@ 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'
@@ -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 }))),

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/package.json

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