@goodandready/dsh-kanban 0.2.2 → 0.2.8

package/lib/commands.js

@@ -23,28 +23,23 @@ const TABLE = {
   project: {
     'backlog': { stops: true },
     'in-progress': {
-      instruction: 'Начни или продолжи реализацию этой задачи по стандартному воркфлоу.',
+      instruction: 'Start or continue implementing this task following standard workflow.',
     },
     'review': {
-      instruction: 'Доведи работу до ревью: сними с pull request пометку черновика '
-        + 'и запроси проверку.',
+      instruction: 'Prepare work for review: mark pull request ready for review and request code review.',
     },
     'deploy': {
-      // Воркфлоу требует явного «ок» человека перед deploy. Сказать это надо
-      // прямо, иначе агент будет спрашивать разрешение, которое уже получил.
-      instruction: 'Влей pull request и выкати. Перенос карточки в Deploy — это и есть '
-        + 'явное «ок» человека на deploy, отдельно спрашивать не нужно.',
+      instruction: 'Merge pull request and deploy. Moving card to Deploy serves as explicit OK for deploy; do not ask separately.',
     },
     'cleanup': {
-      instruction: 'Прибери за задачей: удали ветку в Gitea, worktree и локальную ветку, '
-        + 'запиши сделанное в issue.',
+      instruction: 'Clean up after task: delete branch in Gitea, worktree, and local branch; record summary in issue.',
     },
     'done': { humanOnly: true },
   },
   simple: {
     'backlog': { stops: true },
-    'in-progress': { instruction: 'Начни или продолжи работу по этой задаче.' },
-    'review': { instruction: 'Покажи результат и жди ответа человека.' },
+    'in-progress': { instruction: 'Start or continue work on this task.' },
+    'review': { instruction: 'Present result and wait for human response.' },
     'done': { humanOnly: true },
   },
 }

package/lib/config.js

@@ -30,7 +30,7 @@ export const COLUMN_ORDER = ['backlog', 'in-progress', 'review', 'deploy', 'clea
 export const BOARD_KINDS = ['project', 'simple']
 
 /** Вид доски по умолчанию: неизвестный вид откатывается сюда, а не в пустоту. */
-export const DEFAULT_KIND = 'project'
+const DEFAULT_KIND = 'project'
 
 const COLUMNS_BY_KIND = {
   project: COLUMN_ORDER,
@@ -49,8 +49,8 @@ export function normalizeKind(kind) {
 
 /** Заводимые при первом запуске доски. Их ровно две, и обе нужны сразу. */
 export const DEFAULT_BOARDS = [
-  { id: 'main', title: 'Проектная доска', kind: 'project' },
-  { id: 'simple', title: 'Простая доска', kind: 'simple' },
+  { id: 'main', title: 'Project Board', kind: 'project' },
+  { id: 'simple', title: 'Simple Board', kind: 'simple' },
 ]
 
 /** Значения по умолчанию. Из них же собирается схема в `lib/index.js`. */
@@ -59,7 +59,7 @@ export const CONFIG_DEFAULTS = {
   giteaTokenRef: 'GITEA_TOKEN',
   defaultProjectRoot: '',
   startPrompt: '',
-  replyInstruction: 'Отвечай по-русски.',
+  replyInstruction: '',
   wipInProgress: 3,
   wipReview: 0,
   syncIntervalSec: 120,
@@ -86,31 +86,33 @@ export const CONFIG_DEFAULTS = {
 
 /** Пояснения к полям; повторно используются схемой и карточкой настроек. */
 export const CONFIG_HINTS = {
-  giteaUrl: 'Адрес инстанса Gitea или Forgejo, например https://gitea.example.com. Пусто — импорт недоступен.',
-  giteaTokenRef: 'ИМЯ учётной записи DSH, в которой лежит токен. Сам токен сюда не вводить.',
-  defaultProjectRoot: 'Корень, в котором лежат рабочие копии проектов. Пусто — рабочая папка харнесса.',
-  startPrompt: 'Шаблон первого сообщения агенту. Пусто — встроенный шаблон.',
-  replyInstruction: 'Постоянная приписка к первому сообщению — например язык ответа. Пусто — ничего не добавляется.',
-  wipInProgress: 'Предел числа карточек в колонке «В работе». Ноль — без предела.',
-  wipReview: 'Предел числа карточек в колонке «Ревью». Ноль — без предела.',
-  syncIntervalSec: 'Как часто сверяться с Gitea, в секундах. Ноль — не сверяться.',
-  staleAfterMin: 'После скольких минут молчания задача с сессией помечается тревожно. Ноль — не помечать.',
-  giteaOwner: 'Организация Gitea, чьи репозитории смотрит доска. Пусто — определяется сама, если организация одна.',
-  columnNames: 'Свои названия колонок парами «идентификатор=Название» через запятую. Пусто — обычные названия.',
-  watchRepos: 'Сузить подхват до этих репозиториев, через запятую. Пусто — все репозитории организации, где есть открытые задачи.',
-  archiveAfterDays: 'Через сколько дней в колонке «Выполнено» карточка уходит в архив. Ноль — не убирать.',
-  boardToolEnabled: 'Разрешить агенту двигать карточки инструментом board_move. Выключено, пока скилл воркфлоу запрещает CLI трогать канбан.',
-  webhookSecretRef: 'ИМЯ учётной записи DSH с секретом вебхука Gitea. Пусто — вебхук не принимается, остаётся только опрос.',
-  pushToGitea: 'Закрывать issue в Gitea, когда карточка уходит в колонку «Выполнено».',
-  worktreeIsolation: 'Изолировать сессии задач в отдельные git worktrees для предотвращения коллизий.',
-  worktreeRoot: 'Каталог для воркдеревьев задач. Пусто — $DSH_HOME/worktrees или .worktrees проекта.',
-  cronEnabled: 'Включить фоновый запуск задач по расписанию cron на стороне хоста.',
-  preventIdleSleep: 'Запретить переход хоста в спящий режим, пока есть активные сессии задач.',
-  progressDumpEnabled: 'Включить поддержку фиксации срезов PROGRESSDUMP для передачи эстафеты между сессиями.',
-  permissionGateEnabled: 'Требовать подтверждения человеком для запуска задач с повышенными правами.',
-  sessionDefaultPermission: 'Базовый уровень прав без подтверждения. Права выше этого требуют одобрения.',
-  announceToAgent: 'Добавлять секцию о доске задач в системный промпт агентов.',
-  autoSyncSessions: 'Автоматически создавать карточки задач для обычных сессий чата DSH.',
+  giteaUrl: 'Gitea or Forgejo instance URL, e.g. https://gitea.example.com. Empty disables import.',
+  giteaTokenRef: 'Name of DSH credential holding the access token. Do not enter raw token.',
+  defaultProjectRoot: 'Directory containing project repositories. Empty uses harness working directory.',
+  startPrompt: 'Template for initial message to agent session. Empty uses built-in default.',
+  replyInstruction: 'Instruction appended to initial message (e.g. language/format constraints). Empty adds nothing.',
+  wipInProgress: 'Maximum task cards allowed in "In Progress" column. 0 means unlimited.',
+  wipReview: 'Maximum task cards allowed in "Review" column. 0 means unlimited.',
+  syncIntervalSec: 'Interval in seconds for polling Gitea synchronization. 0 disables polling.',
+  staleAfterMin: 'Minutes of inactivity before active task session is flagged stale. 0 disables.',
+  giteaOwner: 'Default Gitea organization/user to track. Auto-detected if single organization.',
+  columnNames: 'Custom column title mappings as "id=Name" pairs comma-separated.',
+  watchRepos: 'Filter sync to specific repository names comma-separated. Empty watches all repos.',
+  archiveAfterDays: 'Days completed tasks remain before automatic archiving. 0 disables.',
+  boardToolEnabled: 'Allow autonomous agent to advance cards via board_move tool.',
+  webhookSecretRef: 'Name of DSH credential holding Gitea webhook secret.',
+  pushToGitea: 'Automatically close corresponding Gitea issue when card moves to Done.',
+  worktreeIsolation: 'Isolate task sessions in dedicated git worktrees to prevent workspace collisions.',
+  worktreeRoot: 'Custom root directory for task worktrees. Empty defaults to $DSH_HOME/worktrees.',
+  cronEnabled: 'Enable background scheduled task execution via cron expressions.',
+  preventIdleSleep: 'Prevent host sleep while task agent sessions are running.',
+  progressDumpEnabled: 'Enable PROGRESSDUMP state checkpoints between agent sessions.',
+  permissionGateEnabled: 'Require human confirmation before launching elevated permission tasks.',
+  sessionDefaultPermission: 'Default permission tier for task sessions (read-only, workspace-write, full).',
+  announceToAgent: 'Post stage change announcement messages directly into task agent session.',
+  maxConcurrentSessions: 'Maximum number of simultaneous active agent sessions on the board.',
+  workspaceClaimBoundaries: 'Enforce workspace ownership boundaries to prevent cross-workspace task execution.',
+  autoSyncSessions: 'Automatically sync and attach live background agent sessions to cards.',
 }
 
 /** Поле настроек с пределом числа карточек; задан не у всех колонок. */

package/lib/events.js

@@ -42,7 +42,7 @@ export class KanbanEventHub {
 
     const cleanup = () => {
       this.clients.delete(res)
-      try { res.end() } catch {}
+      try { res.end() } catch { /* client already disconnected */ }
     }
 
     if (typeof req.on === 'function') req.on('close', cleanup)
@@ -82,7 +82,7 @@ export class KanbanEventHub {
       try {
         client.write('event: close\ndata: {}\n\n')
         client.end()
-      } catch {}
+      } catch { /* client already closed */ }
     }
     this.clients.clear()
   }

package/lib/filters.js

@@ -41,7 +41,7 @@ export const NOBODY = '—'
 export const NO_MILESTONE = '—'
 
 /** Порядок приоритетов в отборе: срочное сверху. */
-export const PRIORITY_ORDER = ['critical', 'high', 'medium', 'low']
+const PRIORITY_ORDER = ['critical', 'high', 'medium', 'low']
 
 /**
  * Порядок известных пространств.
@@ -279,7 +279,7 @@ export function liveRank(task) {
 }
 
 /** Вес приоритета при подъёме: срочное впереди тихого. */
-export function priorityWeight(priority) {
+function priorityWeight(priority) {
   const at = PRIORITY_ORDER.indexOf(priority)
   return at === -1 ? PRIORITY_ORDER.length : at
 }

package/lib/gitea.js

@@ -287,6 +287,21 @@ export function createGiteaClient({ getConfig, resolveToken, fetchImpl = fetch,
       })
     },
 
+    /** Создать Pull Request в репозитории. */
+    async createPullRequest({ owner, repo, title, body, head, base = 'main' }) {
+      const name = String(title ?? '').trim()
+      if (name === '') throw Object.assign(new Error('пустой заголовок'), { code: 'bad-title' })
+      const h = String(head ?? '').trim()
+      const b = String(base ?? 'main').trim()
+      if (!h) throw Object.assign(new Error('ветка head обязательна'), { code: 'bad-head' })
+      return request('POST', repoPath(owner, repo, '/pulls'), {
+        title: name,
+        body: String(body ?? ''),
+        head: h,
+        base: b,
+      })
+    },
+
     /**
      * Ветки репозитория: по ним видно, начата ли работа и сделан ли cleanup.
      *