@goodandready/dsh-kanban 0.2.7 → 0.2.9

package/README.md

@@ -296,3 +296,17 @@ deregistration.
 ## 📄 License
 
 MIT © [GooDAnDReaDY](https://github.com/GooDAnDReaDY)
+
+## Public composition service
+
+The server half exposes an optional dshKanban composition service. Its
+createTask({ title, body, board, column, labels, owner, repo, issueNumber,
+issueUrl, externalRef }) method validates the target board and column, stores
+the task through the existing SQLite-backed path, and returns { ok, task,
+taskId, alreadyExists }. A repeated externalRef returns the original card,
+including after a restart.
+
+This service only creates a card. It does not launch an agent, create a branch,
+create a worktree, or accept credentials from a consumer. The canonical
+consumer contract for task provisioning is
+dsh-drives.task-provision.v1.

package/README.zh.md

@@ -181,3 +181,14 @@ npm test
 ## 📄 开源许可证
 
 MIT © [GooDAnDReaDY](https://github.com/GooDAnDReaDY)
+
+## 公共组合服务
+
+服务器端暴露可选的 dshKanban 组合服务。其
+createTask({ title, body, board, column, labels, owner, repo, issueNumber,
+issueUrl, externalRef }) 方法校验目标看板和列，通过现有的 SQLite 存储路径
+保存任务，并返回 { ok, task, taskId, alreadyExists }。重复的 externalRef
+会返回原有卡片，重启后仍然有效。
+
+该服务只创建卡片，不启动代理、不创建分支或 worktree，也不接受调用方传入的
+凭据。任务供应的规范消费者契约是 dsh-drives.task-provision.v1。

package/lib/board-tool.js

@@ -426,7 +426,7 @@ export function boardDecomposeDefinition({ store, gitea }) {
               issueNumber = giteaIssue.number
               issueUrl = giteaIssue.html_url || null
             }
-          } catch {}
+          } catch { /* gitea issue creation best-effort */ }
         }
 
         const sub = store.createTask({

package/lib/client.js

@@ -115,7 +115,7 @@ window.__ModuleLoader__.load({
     function rememberLaunch(board, choice) {
       try {
         window.localStorage.setItem(RECALL_KEY + (board || 'main'), JSON.stringify(choice))
-      } catch { /* нечем запомнить — не повод ломать запуск */ }
+      } catch { /* storage unavailable */ }
     }
 
     /**
@@ -707,7 +707,7 @@ window.__ModuleLoader__.load({
         try {
           const s = (ctx?.get && ctx.get('lanSettings')) || ctx?.settingsScope
           s?.describe?.()?.load?.()
-        } catch (_) {}
+        } catch (_) { /* clipboard read best-effort */ }
       }, 1000)
       return () => clearTimer(timer)
     }
@@ -721,7 +721,7 @@ window.__ModuleLoader__.load({
       '.dkb-headText{flex-direction:column;flex:1;gap:4px;min-width:0;display:flex}' +
       '.dkb-title{color:var(--dsw-alias-label-primary);font-size:15px;font-weight:600;line-height:1.4}' +
       '.dkb-sub{color:var(--dsw-alias-label-secondary);font-size:13px}' +
-      '.dkb-chevron{color:var(--dsw-alias-label-secondary);flex:none;transition:transform .16s}' +
+      '.dkb-chevron{color:var(--dsw-alias-label-secondary);display:inline-flex;align-items:center;justify-content:center;flex:none;transition:transform .16s}' +
       '.dkb-chevronOpen{transform:rotate(180deg)}' +
       '.dkb-body{border-top:1px solid var(--dsw-alias-border-l2);margin:0 16px;padding-bottom:8px}' +
       '.dkb-group{color:var(--dsw-alias-label-secondary);font-size:12px;font-weight:600;letter-spacing:.04em;text-transform:uppercase;padding:14px 0 2px}' +
@@ -791,7 +791,7 @@ window.__ModuleLoader__.load({
       '.dkb-cols{overscroll-behavior-inline:contain;scrollbar-color:var(--dsw-alias-border-l3) var(--dsw-alias-interactive-bg-hover);scrollbar-width:thin;flex:1;gap:12px;min-height:0;padding-bottom:6px;display:flex;overflow:auto hidden}' +
       '.dkb-cols::-webkit-scrollbar{height:10px}' +
       '.dkb-cols::-webkit-scrollbar-track{background:var(--dsw-alias-interactive-bg-hover);border-radius:999px}' +
-      '.dkb-cols::-webkit-scrollbar-thumb{background:var(--dsw-alias-border-l3);background-clip:content-box;border:2px solid #0000;border-radius:999px}' +
+      '.dkb-cols::-webkit-scrollbar-thumb{background:var(--dsw-alias-border-l3);background-clip:content-box;border:2px solid transparent;border-radius:999px}' +
       '.dkb-col{flex:1 1 220px;min-width:220px;background:var(--dsw-alias-bg-layer-2);border:1px solid var(--dsw-alias-border-l1);border-radius:12px;flex-direction:column;min-height:0;display:flex;overflow:hidden}' +
       '.dkb-colOver{border-color:var(--dsw-alias-border-l3)}' +
       '.dkb-colHead{appearance:none;width:100%;font:inherit;color:inherit;text-align:left;cursor:pointer;background:0 0;border:0;flex:none;align-items:center;gap:6px;padding:10px 12px;display:flex}' +
@@ -813,7 +813,7 @@ window.__ModuleLoader__.load({
       '.dkb-count[data-col=review]{background:var(--dsw-alias-state-business-primary)}' +
       '.dkb-count[data-col=deploy]{background:var(--dsw-alias-state-business-primary)}' +
       '.dkb-count[data-col=done]{background:var(--dsw-alias-state-success-primary)}' +
-      '.dkb-countOver{background:var(--dsw-alias-state-error-primary);color:#fff}' +
+      '.dkb-countOver{background:var(--dsw-alias-state-error-primary);color:var(--dsw-alias-label-inverse,#fff)}' +
       '.dkb-overdue{border-color:var(--dsw-alias-state-error-primary)}' +
       '.dkb-dueOver{color:var(--dsw-alias-state-error-primary);font-weight:600}' +
       '.dkb-list{flex-direction:column;flex:1;gap:8px;min-height:0;padding:2px 8px 10px;display:flex;overflow-y:auto}' +
@@ -858,7 +858,7 @@ window.__ModuleLoader__.load({
       '.dkb-waiting{color:var(--dsw-alias-state-warn-primary);font-weight:600}' +
       '.dkb-waitDot{border-radius:50%;flex:none;width:8px;height:8px;background:var(--dsw-alias-state-warn-primary);display:inline-block}' +
       '.dkb-tag{white-space:nowrap;color:var(--dsw-alias-label-secondary);background:var(--dsw-alias-interactive-bg-hover);border:1px solid transparent;border-radius:999px;padding:1px 7px;font-size:11px;line-height:1.5;font-weight:500}' +
-      '.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-modal{position:absolute;inset:0;background:var(--dsw-alias-mask-bg,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}' +
@@ -866,7 +866,7 @@ window.__ModuleLoader__.load({
       '.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}' +
-      '.dkb-dialog{position:absolute;inset:0;background:rgba(0,0,0,.4);display:flex;align-items:center;justify-content:center;z-index:80}' +
+      '.dkb-dialog{position:absolute;inset:0;background:var(--dsw-alias-mask-bg,rgba(0,0,0,.4));display:flex;align-items:center;justify-content:center;z-index:80}' +
       '.dkb-dialogBox{width:min(560px,94%);max-height:86%;overflow-y:auto;background:var(--dsw-alias-bg-layer-2);border:1px solid var(--dsw-alias-border-l2);border-radius:12px;padding:16px;display:flex;flex-direction:column;gap:10px}' +
       '.dkb-issue{appearance:none;font:inherit;text-align:left;cursor:pointer;background:0 0;border:1px solid var(--dsw-alias-border-l2);border-radius:8px;padding:8px 10px;color:var(--dsw-alias-label-primary);font-size:13px}' +
       '.dkb-issueUsed{opacity:.5}' +
@@ -880,15 +880,26 @@ window.__ModuleLoader__.load({
       '.dkb-quickFilterBar{display:flex;gap:6px;align-items:center;flex-wrap:wrap;padding:4px 0}' +
       '.dkb-filterChip{appearance:none;font:inherit;cursor:pointer;background:var(--dsw-alias-interactive-bg-hover);border:1px solid var(--dsw-alias-border-l2);border-radius:999px;padding:3px 10px;font-size:12px;color:var(--dsw-alias-label-secondary);transition:all .15s}' +
       '.dkb-filterChip:hover{background:var(--dsw-alias-interactive-bg-active);color:var(--dsw-alias-label-primary)}' +
-      '.dkb-filterChipActive{background:var(--dsw-alias-state-business-primary);color:#fff;border-color:transparent;font-weight:600}' +
+      '.dkb-filterChipActive{background:var(--dsw-alias-state-business-primary);color:var(--dsw-alias-label-inverse,#fff);border-color:transparent;font-weight:600}' +
       '.dkb-epicTag{background:var(--dsw-alias-state-info-bg,#ddf4ff);color:var(--dsw-alias-state-info-primary,#0969da);font-weight:600}' +
       '.dkb-progressBar{height:4px;background:var(--dsw-alias-border-l2);border-radius:2px;overflow:hidden;margin:4px 0}' +
       '.dkb-progressFill{height:100%;background:var(--dsw-alias-state-success-primary,#16a34a);transition:width .2s}' +
-      '.dkb-consolePre{background:#0d1117;color:#58a6ff;padding:12px;border-radius:8px;font-family:monospace;font-size:11px;max-height:260px;overflow-y:auto;white-space:pre-wrap;border:1px solid #30363d}'
+      '.dkb-consolePre{background:var(--dsw-alias-bg-layer-1,#0d1117);color:var(--dsw-alias-state-info-primary,#58a6ff);border:1px solid var(--dsw-alias-border-l2);padding:12px;border-radius:8px;font-family:monospace;font-size:11px;max-height:260px;overflow-y:auto;white-space:pre-wrap}'
 
 
 
     const en = {
+      'updater.title': 'Plugin Updates',
+      'updater.check': 'Check updates',
+      'updater.checking': 'Checking…',
+      'updater.current': 'Current version',
+      'updater.latest': 'Latest version',
+      'updater.upToDate': 'Up to date',
+      'updater.updateNow': 'Update to v{version}',
+      'updater.updating': 'Updating…',
+      'updater.success': 'Plugin updated successfully! Please restart DSH service.',
+      'updater.failed': 'Update check failed: ',
+
       'title': 'Kanban',
       'subtitle': 'Task board: Gitea issues and a session per task',
       'section.label': 'Kanban',
@@ -1256,6 +1267,17 @@ window.__ModuleLoader__.load({
     }
 
     const zh = {
+      'updater.title': '插件更新',
+      'updater.check': '检查更新',
+      'updater.checking': '正在检查…',
+      'updater.current': '当前版本',
+      'updater.latest': '最新版本',
+      'updater.upToDate': '已是最新',
+      'updater.updateNow': '一键更新至 v{version}',
+      'updater.updating': '正在更新…',
+      'updater.success': '插件更新成功！请重启 DSH 服务以生效。',
+      'updater.failed': '更新检查失败：',
+
       'title': '看板',
       'subtitle': '任务看板：Gitea issue，每个任务一个会话',
       'section.label': '看板',
@@ -1671,16 +1693,126 @@ window.__ModuleLoader__.load({
       return 'hint.' + spec.field
     }
 
-    function Chevron(props) {
+    let ChevronIcon = null
+    try {
+      const primitives = typeof require === 'function' ? require('@deepseek-ai/dsh-client-ui-primitives') : null
+      ChevronIcon = primitives && (primitives.IconChevronDownOutline14 || primitives.IconChevronDown)
+    } catch (_) {
+      ChevronIcon = null
+    }
+
+    function FallbackChevron(props) {
       return h('svg', {
-        className: 'dkb-chevron' + (props.open ? ' dkb-chevronOpen' : ''),
-        width: 16, height: 16, viewBox: '0 0 16 16', 'aria-hidden': 'true',
+        width: 14,
+        height: 14,
+        viewBox: '0 0 14 14',
+        fill: 'none',
+        'aria-hidden': 'true',
       }, h('path', {
-        d: 'M4 6l4 4 4-4', fill: 'none', stroke: 'currentColor', strokeWidth: '1.5',
-        strokeLinecap: 'round', strokeLinejoin: 'round',
+        d: 'M3.5 5.25L7 8.75L10.5 5.25',
+        stroke: 'currentColor',
+        strokeWidth: '1.5',
+        strokeLinecap: 'round',
+        strokeLinejoin: 'round',
       }))
     }
 
+    function Chevron(props) {
+      const Icon = ChevronIcon || FallbackChevron
+      return h('span', {
+        className: 'dkb-chevron' + (props.open ? ' dkb-chevronOpen' : ''),
+        'aria-hidden': 'true',
+      }, h(Icon))
+    }
+
+
+    function PluginUpdaterSection(props) {
+      const t = props.t || fallbackT
+      const [status, setStatus] = React.useState(null)
+      const [loading, setLoading] = React.useState(false)
+      const [updating, setUpdating] = React.useState(false)
+      const [msg, setMsg] = React.useState(null)
+
+      const checkUpdate = React.useCallback(async () => {
+        setLoading(true)
+        setMsg(null)
+        try {
+          const res = await fetch('/api/dsh-kanban/update', {
+            headers: { accept: 'application/json' },
+            cache: 'no-store',
+          })
+          if (!res.ok) throw new Error('HTTP ' + res.status)
+          const data = await res.json()
+          setStatus(data)
+        } catch (e) {
+          setMsg({ ok: false, text: (t('updater.failed') || 'Update check failed: ') + (e?.message || String(e)) })
+        } finally {
+          setLoading(false)
+        }
+      }, [t])
+
+      const onUpdateNow = async () => {
+        setUpdating(true)
+        setMsg(null)
+        try {
+          const res = await fetch('/api/dsh-kanban/update', {
+            method: 'POST',
+            headers: {
+              'x-dsh-plugin-update': '1',
+              'content-type': 'application/json',
+            },
+          })
+          const data = await res.json()
+          if (!res.ok) throw new Error(data?.error || 'HTTP ' + res.status)
+          setStatus(data)
+          setMsg({ ok: true, text: t('updater.success') || 'Plugin updated successfully! Please restart DSH service.' })
+        } catch (e) {
+          setMsg({ ok: false, text: e?.message || String(e) })
+        } finally {
+          setUpdating(false)
+        }
+      }
+
+      React.useEffect(() => {
+        checkUpdate()
+      }, [checkUpdate])
+
+      const currentVer = status?.currentVersion || '0.2.7'
+      const latestVer = status?.latestVersion
+      const updateAvailable = Boolean(status?.updateAvailable && latestVer && latestVer !== currentVer)
+
+      return h('div', { className: 'dkb-section-card', key: 'g-updater' },
+        h('div', { className: 'dkb-section-title' },
+          h('span', null, '🔄 ' + t('updater.title')),
+          h('span', { className: 'dkb-section-badge' + (!updateAvailable ? ' dkb-section-badge-ok' : '') },
+            updateAvailable ? 'v' + latestVer + ' available' : 'v' + currentVer + ' (' + t('updater.upToDate') + ')'
+          ),
+        ),
+        h('div', { style: { display: 'flex', alignItems: 'center', justifyContent: 'space-between', flexWrap: 'wrap', gap: '8px', marginTop: '6px' } },
+          h('span', { style: { fontSize: '12px', color: 'var(--dsw-alias-label-secondary)' } },
+            updateAvailable ? (t('updater.latest') + ': v' + latestVer) : (t('updater.current') + ': v' + currentVer)
+          ),
+          h('div', { style: { display: 'flex', gap: '8px' } },
+            updateAvailable ? h('button', {
+              type: 'button',
+              className: 'dkb-save',
+              style: { padding: '4px 10px', fontSize: '12px' },
+              onClick: onUpdateNow,
+              disabled: updating || loading,
+            }, updating ? (t('updater.updating') || 'Updating…') : (t('updater.updateNow') || 'Update now').replace('{version}', latestVer)) : null,
+            h('button', {
+              type: 'button',
+              className: 'dkb-discard',
+              style: { padding: '4px 10px', fontSize: '12px' },
+              onClick: checkUpdate,
+              disabled: loading || updating,
+            }, loading ? (t('updater.checking') || 'Checking…') : (t('updater.check') || 'Check updates')),
+          ),
+        ),
+        msg ? h('p', { className: msg.ok ? 'dkb-note' : 'dkb-failed', style: { margin: '4px 0 0 0', fontSize: '12px' } }, msg.text) : null,
+      )
+    }
+
     function KanbanSettingsCard(props) {
       const ctx = props.ctx
       const t = props.t || fallbackT
@@ -1835,6 +1967,7 @@ window.__ModuleLoader__.load({
         else if (!writable) note = h('p', { className: 'dkb-note', role: 'status' }, t('settings.readOnly'))
         else if (saved) note = h('p', { className: 'dkb-note', role: 'status' }, t('settings.saved'))
         else note = h('p', { className: 'dkb-note' })
+        rows.push(h(PluginUpdaterSection, { t, key: 'updater' }))
         rows.push(h('div', { className: 'dkb-foot', key: 'foot' },
           note,
           h('button', { type: 'button', className: 'dkb-discard', disabled: !dirty || saving, onClick: discard }, t('discard')),
@@ -1879,7 +2012,7 @@ window.__ModuleLoader__.load({
         tabIndex: 0,
         draggable: true,
         onDragStart: (e) => {
-          try { e.dataTransfer.setData('text/plain', task.id) } catch { /* не всякий носитель умеет */ }
+          try { e.dataTransfer.setData('text/plain', task.id) } catch { /* dataTransfer unsupported */ }
           props.onDragStart(task)
         },
         onClick: () => props.onOpen(task),
@@ -2139,7 +2272,7 @@ window.__ModuleLoader__.load({
             es.addEventListener('task:change', scheduleReload)
             es.onerror = () => {
               if (es) {
-                try { es.close() } catch {}
+                try { es.close() } catch { /* eventsource close best-effort */ }
                 es = null
               }
               if (!reconnectTimer) {
@@ -2149,7 +2282,7 @@ window.__ModuleLoader__.load({
                 }, 5000)
               }
             }
-          } catch {}
+          } catch { /* eventsource setup best-effort */ }
         }
 
         connect()
@@ -2157,7 +2290,7 @@ window.__ModuleLoader__.load({
         return () => {
           if (reconnectTimer) clearTimeout(reconnectTimer)
           if (es) {
-            try { es.close() } catch {}
+            try { es.close() } catch { /* eventsource close best-effort */ }
             es = null
           }
         }
@@ -2779,7 +2912,7 @@ window.__ModuleLoader__.load({
                     method: 'POST',
                     body: JSON.stringify({ reasoningEffort: val }),
                   })
-                } catch {}
+                } catch { /* update reasoning effort best-effort */ }
               },
             },
               h('option', { value: '' }, t('reasoning.default')),
@@ -3179,8 +3312,8 @@ window.__ModuleLoader__.load({
                       ? h('pre', {
                           style: {
                             margin: 0, padding: 8, maxHeight: 280, overflowY: 'auto',
-                            background: 'var(--dsw-alias-bg-layer-2, #1e1e1e)',
-                            color: 'var(--dsw-alias-label-primary, #ddd)',
+                            background: 'var(--dsw-alias-bg-layer-2)',
+                            color: 'var(--dsw-alias-label-primary)',
                             fontSize: 11, fontFamily: 'monospace', borderRadius: 4, whiteSpace: 'pre-wrap',
                             border: '1px solid var(--dsw-alias-border-l1)',
                           },
@@ -3204,7 +3337,7 @@ window.__ModuleLoader__.load({
                     ? h('button', {
                         type: 'button', className: 'dkb-save',
                         disabled: merging,
-                        style: { background: 'var(--dsw-alias-bg-success, #16a34a)', color: '#fff' },
+                        style: { background: 'var(--dsw-alias-state-success-primary, #16a34a)', color: 'var(--dsw-alias-label-inverse, #fff)' },
                         onClick: async () => {
                           try {
                             setMerging(true)
@@ -3234,7 +3367,7 @@ window.__ModuleLoader__.load({
                     ? h('button', {
                         type: 'button', className: 'dkb-save',
                         disabled: prCreating,
-                        style: { background: 'var(--dsw-alias-state-info-primary, #0969da)', color: '#fff' },
+                        style: { background: 'var(--dsw-alias-state-info-primary, #0969da)', color: 'var(--dsw-alias-label-inverse, #fff)' },
                         onClick: async () => {
                           setPrCreating(true)
                           try {
@@ -3252,7 +3385,7 @@ window.__ModuleLoader__.load({
                   createdPr
                     ? h('a', {
                         className: 'dkb-save',
-                        style: { background: 'var(--dsw-alias-state-success-primary, #16a34a)', color: '#fff', textDecoration: 'none', display: 'inline-flex', alignItems: 'center' },
+                        style: { background: 'var(--dsw-alias-state-success-primary, #16a34a)', color: 'var(--dsw-alias-label-inverse, #fff)', textDecoration: 'none', display: 'inline-flex', alignItems: 'center' },
                         href: createdPr.html_url,
                         target: '_blank', rel: 'noopener noreferrer',
                       }, '↗ ' + t('pr.view') + ` #${createdPr.number}`)
@@ -3600,7 +3733,7 @@ window.__ModuleLoader__.load({
             (openTask.worktree || openTask.rejectReason || (Array.isArray(openTask.runs) && openTask.runs.length > 0)) ? h('button', {
               type: 'button',
               className: 'dkb-secondary',
-              style: { marginRight: '8px', border: '1px solid var(--dsw-alias-border-color-primary, #444)' },
+              style: { marginRight: '8px', border: '1px solid var(--dsw-alias-border-l2)' },
               disabled: starting || model === '',
               onClick: async () => {
                 setStarting(true)
@@ -4082,7 +4215,7 @@ window.__ModuleLoader__.load({
           })
           setTask(out.task)
           setOpen(false)
-        } catch { /* причину показывает доска; шапку не ломаем */ }
+        } catch { /* board handles error; keep header intact */ }
       }, [task])
 
       if (!task) return null
@@ -4125,7 +4258,7 @@ window.__ModuleLoader__.load({
                 setTask(out.task)
                 setNote('')
                 setOpen(false)
-              } catch { /* причину показывает доска; шапку не ломаем */ } finally {
+              } catch { /* board handles error; keep header intact */ } finally {
                 setSaving(false)
               }
             },
@@ -4356,7 +4489,7 @@ window.__ModuleLoader__.load({
           if (registeredInSlot || (res !== null && res !== false && res !== undefined)) {
             return entry.name
           }
-        } catch { /* слота нет в этой сборке — пробуем следующий */ }
+        } catch { /* slot missing in build — try next */ }
       }
       return undefined
     }
@@ -4364,7 +4497,7 @@ window.__ModuleLoader__.load({
     helpers.createToggle = createToggle
 
     function apply(ctx) {
-      ctx.effect(() => ctx.locale.register(NS, { en, zh }), 'dsh-kanban: словари')
+      ctx.effect(() => ctx.locale.register(NS, { en, zh }), 'dsh-kanban: locales')
 
       refreshMirrorUntilVisible(ctx)
       const SettingsErrorBoundary = createErrorBoundary()
@@ -4377,7 +4510,7 @@ window.__ModuleLoader__.load({
       ctx.effect(() => {
         const off = [mountSidebarEntry(toggle, fallbackT('section.label')), mountBoard(ctx, toggle)]
         return () => { for (const dispose of off) dispose() }
-      }, 'dsh-kanban: доска в оболочке')
+      }, 'dsh-kanban: shell board')
 
       const chipSlot = registerFirst(ctx, [
         { name: 'conversation.session.header.utilities', id: '@goodandready/dsh-kanban.chip', order: 26, locale: NS, inject: () => ({ ctx, toggle }) },

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 },
   },
 }
@@ -101,7 +96,7 @@ export function dispatchMove({ agents, task, column, kind = 'project', createMes
     try {
       agent.cancel({ kind: 'user' })
     } catch (error) {
-      logger?.warn?.(`dsh-kanban: ход по задаче ${task.id} не прервался: ${error?.message}`)
+      logger?.warn?.(`dsh-kanban: agent turn for task ${task.id} was not interrupted: ${error?.message}`)
       return { acted: 'idle' }
     }
     return { acted: 'stopped' }
@@ -138,7 +133,7 @@ export function stopWork({ agents, task, logger }) {
   try {
     agent.cancel({ kind: 'user' })
   } catch (error) {
-    logger?.warn?.(`dsh-kanban: ход по задаче ${task.id} не прервался: ${error?.message}`)
+    logger?.warn?.(`dsh-kanban: agent turn for task ${task.id} was not interrupted: ${error?.message}`)
     return { acted: 'idle' }
   }
   return { acted: 'stopped' }
@@ -146,9 +141,9 @@ export function stopWork({ agents, task, logger }) {
 
 /** Пояснения к остановке в журнале задачи. */
 export const STOP_DETAIL = {
-  stopped: 'человек остановил ход агента',
-  idle: 'агент не работал, останавливать было нечего',
-  'no-session': 'у задачи нет сессии',
+  stopped: 'user stopped agent turn',
+  idle: 'agent was idle, nothing to stop',
+  'no-session': 'task has no session',
 }
 
 /**
@@ -158,10 +153,10 @@ export const STOP_DETAIL = {
  * значило бы задваивать событие, которое было одним.
  */
 export const MOVE_DETAIL = {
-  stopped: 'перенос прервал идущий ход агента',
-  sent: 'команда отправлена в чат задачи',
-  idle: 'агент не работал, останавливать было нечего',
-  'no-session': 'у задачи нет сессии, карточка просто передвинута',
-  human: 'решение человека',
+  stopped: 'move interrupted running agent turn',
+  sent: 'command sent to task chat',
+  idle: 'agent was idle, nothing to stop',
+  'no-session': 'task has no session, card moved',
+  human: 'human decision',
   unknown: '',
 }

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()
   }