@goodandready/dsh-kanban 0.1.19 → 0.1.21

package/README.md

@@ -116,6 +116,45 @@ Unlike passive task boards, `dsh-kanban` actively drives the agents:
 
 ---
 
+### 5. Card Detail: Labels, Priority and Deadlines
+
+Cards carry more than a title. Labels and priority are editable right in the card
+window — for a Gitea-backed task they travel back to the issue, for a board-only
+task they live locally. Priority drives an "urgent first" ordering, so the column
+answers "what now" without reading every card.
+
+A due date can be set on any card. Overdue cards are highlighted, and a switch in
+the board header narrows the board to them alone — the answer to "what is already
+late" is one click, not a scan.
+
+### 6. Ownership: Who Took the Task
+
+The board carries two different people per task and never confuses them: the
+**author** who filed the issue and the **assignee** who took it. Both arrive
+from Gitea, both are filter dimensions, and the assignee is shown on the card
+itself — "who is doing this" is asked more often than "who wrote it".
+
+A single button in the task window takes the task or drops it. Taking assigns
+the account whose token the board uses: the harness has no user of its own, so
+"me" is resolved by asking Gitea rather than by guessing. The change travels
+back to the issue through the outbound queue, so the board keeps working while
+Gitea is down; dropping sends an empty assignee list, because Gitea reads a
+missing field as "leave it alone".
+
+Assignment made in Gitea arrives on the next sync — in both directions,
+including removal. Filtering by "nobody" answers the question the board is
+opened for most often: what is free to pick up.
+
+### 7. Board Snapshot: Export and Import
+
+`GET /dsh-kanban/snapshot` returns the whole board as JSON; `POST` to the same
+route restores it. Import is idempotent: a task whose id is already on the board
+is skipped rather than duplicated, so re-running an import is safe.
+
+The snapshot is one resource with two verbs on purpose. An earlier build gave the
+upload the path `/dsh-kanban/import`, which the Gitea issue import already owned —
+two handlers on one path mean one of them silently never answers.
+
 ## 📦 Installation
 
 Install via DeepSeek Harness CLI:

package/lib/client.js

@@ -682,6 +682,7 @@ window.__ModuleLoader__.load({
       '.dkb-archiveRow{background:var(--dsw-alias-bg-layer-2);border:1px solid var(--dsw-alias-border-l1);border-radius:10px;align-items:center;gap:12px;padding:8px 12px;display:flex}' +
       '.dkb-start{display:contents}' +
       '.dkb-pack{color:var(--dsw-alias-label-secondary)}' +
+      '.dkb-who{color:var(--dsw-alias-label-secondary)}' +
       '.dkb-sameSession{outline:1px solid var(--dsw-alias-label-secondary);outline-offset:1px}' +
       '.dkb-waitCount{background:var(--dsw-alias-bg-layer-2);border:1px solid var(--dsw-alias-border-l1);border-radius:8px;padding:0 10px;height:30px;cursor:pointer;color:var(--dsw-alias-label-primary)}' +
       '.dkb-archiveOpen{background:none;border:0;padding:0;text-align:left;cursor:pointer;font:inherit}' +
@@ -734,6 +735,8 @@ window.__ModuleLoader__.load({
       '.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-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}' +
       '.dkb-empty{text-align:center;color:var(--dsw-alias-label-tertiary);padding:24px 8px;font-size:12px}' +
       '.dkb-taskCard{text-align:left;background:var(--dsw-alias-bg-base);border:1px solid var(--dsw-alias-border-l2);cursor:pointer;color:var(--dsw-alias-label-primary);border-radius:10px;flex-direction:column;gap:6px;padding:10px 12px;font-family:inherit;transition:box-shadow .12s,border-color .12s,transform .12s;display:flex}' +
@@ -894,6 +897,7 @@ window.__ModuleLoader__.load({
       'board.expand': 'Expand the column',
       'card.move': 'move',
       'card.toChat': 'to the chat',
+      'card.due': 'due {date}',
       'card.pick': 'Select for a group start',
       'card.queue': 'to a queue...',
       'card.unqueue': 'take out of the queue',
@@ -925,6 +929,11 @@ window.__ModuleLoader__.load({
       'error.repo-not-created': 'The repository was not created; nothing else was done.',
       'error.issue-not-created': 'The issue was not created. If the repository was new, it stayed — nothing was deleted.',
       'board.archive': 'Archive',
+      'board.export': 'Download',
+      'board.import': 'Import',
+      'board.exportHint': 'Download the whole board as JSON',
+      'board.imported': 'Imported {n} tasks',
+      'error.badImport': 'That file is not a valid board backup.',
       'panel.archive': 'To the archive',
       'archive.hint': 'Cards that spent their term in Done. Nothing is deleted: a restored card returns to the column it left.',
       'archive.empty': 'The archive is empty.',
@@ -938,6 +947,12 @@ window.__ModuleLoader__.load({
       'sync.neverSeen': 'no successful check since the harness started',
       'facet.repo': 'Repository',
       'facet.author': 'Author',
+      'facet.assignee': 'Assignee',
+      'card.assigneeHint': 'Who took the task',
+      'panel.assignee': 'taken by {who}',
+      'panel.assignMe': 'Take it',
+      'panel.assignDrop': 'Drop it',
+      'error.gitea-unreachable': 'Gitea did not answer, so there is nobody to take the task as.',
       'board.pickArchive': 'To the archive',
       'board.pickUnqueue': 'Out of the queue',
       'board.pickMove': 'Move to…',
@@ -1017,6 +1032,16 @@ window.__ModuleLoader__.load({
       'panel.startHint': 'A dedicated agent session opens for this task. Branch and worktree are created by the agent after its preflight, not here.',
       'panel.workDir': 'Working folder: {path}',
       'panel.workDirHint': 'The project root is not set in settings, so this folder is used.',
+      'panel.priority': 'Priority',
+      'panel.priorityNone': 'No priority',
+      'priority.high': 'High',
+      'priority.medium': 'Medium',
+      'priority.low': 'Low',
+      'panel.labels': 'Labels',
+      'panel.due': 'Due date',
+      'panel.saveEdit': 'Save',
+      'board.overdueCount': 'Overdue: {n}',
+      'board.overdueHint': 'Show only overdue tasks',
       'error.startFailed': 'Could not start the session.',
       'error.sessionNotOpened': 'The session started ({id}) but this build cannot switch to it. Find it in the session list.',
       'error.modelNotSelected': 'No model selected — pick one in Settings, or type it here.',
@@ -1123,6 +1148,7 @@ window.__ModuleLoader__.load({
       'board.expand': '展开该列',
       'card.move': '移动',
       'card.toChat': '进入对话',
+      'card.due': '截止 {date}',
       'card.pick': '选中以便批量启动',
       'card.queue': '加入队列…',
       'card.unqueue': '移出队列',
@@ -1154,6 +1180,11 @@ window.__ModuleLoader__.load({
       'error.repo-not-created': '仓库没有创建，其他动作也未执行。',
       'error.issue-not-created': 'issue 没有创建。如果仓库是新建的，它仍然保留——没有删除任何东西。',
       'board.archive': '归档',
+      'board.export': '下载',
+      'board.import': '导入',
+      'board.exportHint': '将整个看板下载为 JSON',
+      'board.imported': '已导入 {n} 个任务',
+      'error.badImport': '该文件不是有效的看板备份。',
       'panel.archive': '移入归档',
       'archive.hint': '在「已完成」里待够时间的卡片。什么都没有删除：恢复的卡片会回到它离开的那一列。',
       'archive.empty': '归档是空的。',
@@ -1167,6 +1198,12 @@ window.__ModuleLoader__.load({
       'sync.neverSeen': '自 harness 启动以来没有一次成功的核对',
       'facet.repo': '仓库',
       'facet.author': '创建者',
+      'facet.assignee': '负责人',
+      'card.assigneeHint': '谁接下了这个任务',
+      'panel.assignee': '由 {who} 接手',
+      'panel.assignMe': '我来接',
+      'panel.assignDrop': '放手',
+      'error.gitea-unreachable': 'Gitea 没有响应，无从得知以谁的身份接手。',
       'board.pickArchive': '移入归档',
       'board.pickUnqueue': '移出队列',
       'board.pickMove': '移动到…',
@@ -1246,6 +1283,16 @@ window.__ModuleLoader__.load({
       'panel.startHint': '会为该任务打开一个专属的 Agent 会话。分支和 worktree 由 Agent 在自检之后创建，不在这里。',
       'panel.workDir': '工作目录：{path}',
       'panel.workDirHint': '设置中未指定项目根目录，因此使用此目录。',
+      'panel.priority': '优先级',
+      'panel.priorityNone': '无优先级',
+      'priority.high': '高',
+      'priority.medium': '中',
+      'priority.low': '低',
+      'panel.labels': '标签',
+      'panel.due': '截止日期',
+      'panel.saveEdit': '保存',
+      'board.overdueCount': '已逾期：{n}',
+      'board.overdueHint': '仅显示已逾期的任务',
       'error.startFailed': '会话没能启动。',
       'error.sessionNotOpened': '会话已启动（{id}），但此版本无法切换过去。请到会话列表中查找。',
       'error.modelNotSelected': '没有选择模型——请在设置中选择，或在此处填写。',
@@ -1481,8 +1528,10 @@ window.__ModuleLoader__.load({
       const touched = task.sessionId ? agoText(now, task.updatedAt, t) : ''
       const menu = props.menuOpen
       const urgent = priorityColor(task)
+      const overdue = task.overdue === true
       return React.createElement('div', {
         className: 'dkb-taskCard' + (urgent ? ' dkb-urgent' : '')
+          + (overdue ? ' dkb-overdue' : '')
           + (props.sameSession ? ' dkb-sameSession' : ''),
         onMouseEnter: () => { if (props.onHover) props.onHover(task.sessionId || '') },
         onMouseLeave: () => { if (props.onHover) props.onHover('') },
@@ -1581,6 +1630,16 @@ window.__ModuleLoader__.load({
             born
               ? React.createElement('span', { title: exactAt(task.createdAt) }, born)
               : null,
+            task.dueAt > 0
+              ? React.createElement('span', {
+                className: overdue ? 'dkb-dueOver' : '',
+                title: exactAt(task.dueAt),
+              }, t('card.due', { date: shortDate(task.dueAt) }))
+              : null,
+            task.assignee
+              ? React.createElement('span', { className: 'dkb-who', title: t('card.assigneeHint') },
+                '@' + task.assignee)
+              : null,
             pack
               ? React.createElement('span', {
                 className: 'dkb-pack', title: t('card.packHint'),
@@ -1644,6 +1703,12 @@ window.__ModuleLoader__.load({
       const [openTask, setOpenTask] = React.useState(null)
       const [log, setLog] = React.useState([])
       const [dialog, setDialog] = React.useState(null)
+      // Черновик правки приоритета и меток в окне задачи. Живёт отдельно от
+      // карточки: пока человек не нажал «Сохранить», доска не должна видеть
+      // полувведённое.
+      const [editPriority, setEditPriority] = React.useState('')
+      const [editLabels, setEditLabels] = React.useState('')
+      const [editDue, setEditDue] = React.useState('')
       const [overColumn, setOverColumn] = React.useState('')
       const [model, setModel] = React.useState('')
       const [provider, setProvider] = React.useState('')
@@ -1673,6 +1738,7 @@ window.__ModuleLoader__.load({
       // «Только ждущие» держим отдельно от отборов: это не значение измерения,
       // а взгляд «покажи, где стоит работа», и складывается он с любым отбором.
       const [onlyWaiting, setOnlyWaiting] = React.useState(false)
+      const [onlyOverdue, setOnlyOverdue] = React.useState(false)
       const [hoverSession, setHoverSession] = React.useState('')
       const [order, setOrder] = React.useState('manual')
       // Чем запускать: профиль агента и уровень доступа. Обе службы у ядра
@@ -1840,6 +1906,11 @@ window.__ModuleLoader__.load({
         setOpenTask(task)
         setDraftText('')
         setBody(null)
+        setEditPriority(typeof task?.priority === 'string' ? task.priority : '')
+        setEditLabels(Array.isArray(task?.labels) ? task.labels.join(', ') : '')
+        setEditDue(typeof task?.dueAt === 'number' && task.dueAt > 0
+          ? new Date(task.dueAt).toISOString().slice(0, 10)
+          : '')
         api('/task/' + encodeURIComponent(task.id) + '/body')
           .then((out) => setBody((out && out.blocks) || []))
           .catch(() => setBody([]))
@@ -1928,6 +1999,18 @@ window.__ModuleLoader__.load({
             onClick: () => setOnlyWaiting((cur) => !cur),
           }, t('board.waitCount', { n: waiting }))
         })(),
+        (() => {
+          // Просроченные — те, чей дедлайн уже прошёл. Счётчик появляется
+          // только когда такие есть: ноль в шапке — мебель.
+          const overdue = state.tasks.filter((x) => x.overdue === true).length
+          if (overdue === 0) return null
+          return React.createElement('button', {
+            type: 'button',
+            className: 'dkb-waitCount' + (onlyOverdue ? ' dkb-save' : ''),
+            title: t('board.overdueHint'),
+            onClick: () => setOnlyOverdue((cur) => !cur),
+          }, t('board.overdueCount', { n: overdue }))
+        })(),
         React.createElement('select', {
           className: 'dkb-input', style: { width: 'auto' }, value: order,
           onChange: (e) => setOrder(e.target.value),
@@ -1946,6 +2029,39 @@ window.__ModuleLoader__.load({
             } catch (e) { setError(t(e.key || 'error.unknown')) }
           },
         }, t('board.archive')),
+        // Экспорт скачивает полный снимок доски; импорт восстанавливает его.
+        React.createElement('button', {
+          type: 'button', className: 'dkb-discard',
+          title: t('board.exportHint'),
+          onClick: async () => {
+            try {
+              const out = await api('/snapshot')
+              const blob = new Blob([JSON.stringify(out, null, 2)], { type: 'application/json' })
+              const url = URL.createObjectURL(blob)
+              const a = document.createElement('a')
+              a.href = url
+              a.download = 'kanban-' + new Date().toISOString().slice(0, 10) + '.json'
+              a.click()
+              URL.revokeObjectURL(url)
+            } catch (e) { setError(t(e.key || 'error.unknown')) }
+          },
+        }, t('board.export')),
+        React.createElement('label', { className: 'dkb-discard dkb-import' },
+          t('board.import'),
+          React.createElement('input', {
+            type: 'file', accept: 'application/json,.json', style: { display: 'none' },
+            onChange: async (e) => {
+              const file = e.target.files && e.target.files[0]
+              e.target.value = ''
+              if (!file) return
+              try {
+                const input = JSON.parse(await file.text())
+                const out = await api('/snapshot', { method: 'POST', body: JSON.stringify(input) })
+                setError(out.error ? t('error.' + out.error) : t('board.imported', { n: out.imported }))
+                await load(board)
+              } catch { setError(t('error.badImport')) }
+            },
+          })),
         // «Показано 12 из 81» появляется, только когда что-то отобрано или
         // введён поиск: на нетронутой доске эта строка была бы шумом.
         anySelected(filters) || query.trim() !== ''
@@ -2087,7 +2203,8 @@ window.__ModuleLoader__.load({
           const all = tasksOf(state.tasks, col.id).filter((task) => matchesFilters(task, filters))
           const items = sortTasks(
             all.filter((task) => matchesQuery(task, query))
-              .filter((task) => !onlyWaiting || task.state === 'waiting'),
+              .filter((task) => !onlyWaiting || task.state === 'waiting')
+              .filter((task) => !onlyOverdue || task.overdue === true),
             order,
           )
           const limit = col.limit
@@ -2255,6 +2372,7 @@ window.__ModuleLoader__.load({
           React.createElement('div', { className: 'dkb-title' }, openTask.title),
           React.createElement('div', { className: 'dkb-note' },
             t('panel.created', { ago: agoText(state.now, openTask.createdAt, t) })
+              + (openTask.assignee ? ' · ' + t('panel.assignee', { who: openTask.assignee }) : '')
               // Автор стоит рядом с датой заведения: это одно событие — кто и
               // когда завёл, — и разносить его по разным углам незачем.
               + (openTask.author ? ' · ' + t('panel.author', { who: openTask.author }) : ''),
@@ -2272,6 +2390,70 @@ window.__ModuleLoader__.load({
             : body.length === 0
               ? null
               : React.createElement('div', { className: 'dkb-mdBody' }, renderBlocks(body)),
+          // Приоритет и метки — локальное свойство доски: правятся здесь, а не
+          // в Gitea. У задач из issue метки приезжают сверкой, но приоритет
+          // всегда свой.
+          React.createElement('div', { className: 'dkb-edit' },
+            React.createElement('div', { className: 'dkb-field' },
+              React.createElement('span', { className: 'dkb-label' }, t('panel.priority')),
+              React.createElement('select', {
+                className: 'dkb-input', value: editPriority,
+                onChange: (e) => setEditPriority(e.target.value),
+              },
+                React.createElement('option', { value: '' }, t('panel.priorityNone')),
+                ['high', 'medium', 'low'].map((p) => React.createElement('option', { value: p, key: p }, t('priority.' + p)))),
+            ),
+            React.createElement('div', { className: 'dkb-field' },
+              React.createElement('span', { className: 'dkb-label' }, t('panel.labels')),
+              React.createElement('input', {
+                className: 'dkb-input', value: editLabels,
+                placeholder: t('dialog.labelsHint'),
+                onChange: (e) => setEditLabels(e.target.value),
+              }),
+            ),
+            React.createElement('div', { className: 'dkb-field' },
+              React.createElement('span', { className: 'dkb-label' }, t('panel.due')),
+              React.createElement('input', {
+                type: 'date', className: 'dkb-input', value: editDue,
+                onChange: (e) => setEditDue(e.target.value),
+              }),
+            ),
+            React.createElement('button', {
+              type: 'button', className: 'dkb-save', style: { alignSelf: 'flex-start' },
+              onClick: async () => {
+                try {
+                  const labels = editLabels.split(',').map((s) => s.trim()).filter(Boolean)
+                  // Пустая дата снимает дедлайн (0); заполненная — полночь
+                  // этого дня по местному времени.
+                  const dueAt = editDue === ''
+                    ? 0
+                    : new Date(editDue + 'T00:00:00').getTime()
+                  const out = await api('/task/' + encodeURIComponent(openTask.id) + '/update', {
+                    method: 'POST',
+                    body: JSON.stringify({ priority: editPriority, labels, dueAt }),
+                  })
+                  setOpenTask(out.task)
+                  await load(board)
+                } catch (e) { setError(t(e.key || 'error.unknown')) }
+              },
+            }, t('panel.saveEdit')),
+          ),
+          // Взять и отдать — одна кнопка в двух состояниях: держать рядом
+          // «взять» и «отказаться» значит предлагать бессмысленное действие.
+          React.createElement('button', {
+            type: 'button', className: 'dkb-discard', style: { alignSelf: 'flex-start' },
+            onClick: async () => {
+              const mine = openTask.assignee !== '' && openTask.assignee !== undefined
+              try {
+                const out = await api('/task/' + encodeURIComponent(openTask.id) + '/assign', {
+                  method: 'POST',
+                  body: JSON.stringify({ login: mine ? '' : 'me' }),
+                })
+                if (out && out.task) setOpenTask(out.task)
+                await load(board)
+              } catch (e) { setError(t(e.key || 'error.unknown')) }
+            },
+          }, openTask.assignee ? t('panel.assignDrop') : t('panel.assignMe')),
           openTask.sessionId
             ? React.createElement('button', {
               type: 'button', className: 'dkb-discard', style: { alignSelf: 'flex-start' },

package/lib/filters.js

@@ -11,6 +11,12 @@ export const REPO = 'repo'
 /** Автор задачи — такое же измерение отбора, как метка, но живёт своим полем. */
 export const AUTHOR = 'author'
 
+/** Ответственный: кто взял задачу, а не кто её завёл. */
+export const ASSIGNEE = 'assignee'
+
+/** Приоритет — локальное свойство доски, своё измерение отбора. */
+export const PRIORITY = 'priority'
+
 /**
  * Значение для задач без автора.
  *
@@ -20,6 +26,17 @@ export const AUTHOR = 'author'
  */
 export const NO_AUTHOR = '—'
 
+/**
+ * Значение для задач без ответственного.
+ *
+ * «Никто не взял» — самый нужный отбор на доске: именно эти задачи ищут, когда
+ * спрашивают «что свободно».
+ */
+export const NOBODY = '—'
+
+/** Порядок приоритетов в отборе: срочное сверху. */
+export const PRIORITY_ORDER = ['critical', 'high', 'medium', 'low']
+
 /**
  * Порядок известных пространств.
  *
@@ -61,7 +78,12 @@ export function facetsOf(tasks) {
 
   for (const task of tasks ?? []) {
     add(REPO, typeof task?.repo === 'string' ? task.repo : '')
+    add(ASSIGNEE, typeof task?.assignee === 'string' && task.assignee !== '' ? task.assignee : NOBODY)
     add(AUTHOR, typeof task?.author === 'string' && task.author !== '' ? task.author : NO_AUTHOR)
+    // Приоритет живёт и полем (свои карточки), и меткой `priority/*` (задачи
+    // из Gitea). Оба попадают в одно измерение — отбор по срочности не должен
+    // зависеть от того, откуда пришло значение.
+    add(PRIORITY, typeof task?.priority === 'string' ? task.priority : '')
     for (const name of task?.labels ?? []) {
       const parsed = splitLabel(name)
       if (parsed !== undefined) add(parsed.ns, parsed.value)
@@ -73,19 +95,34 @@ export function facetsOf(tasks) {
       ns,
       values: [...values.entries()]
         .map(([value, count]) => ({ value, count }))
-        .sort((a, b) => a.value.localeCompare(b.value)),
+        .sort((a, b) => valueRank(ns, a.value) - valueRank(ns, b.value) || a.value.localeCompare(b.value)),
     }))
     .sort((a, b) => rank(a.ns) - rank(b.ns) || a.ns.localeCompare(b.ns))
 }
 
 /** Репозиторий первым, затем известные пространства, затем всё прочее. */
 function rank(ns) {
-  if (ns === REPO) return -2
+  if (ns === REPO) return -3
+  // Ответственный идёт раньше автора: «кто делает» спрашивают чаще, чем «кто
+  // завёл».
+  if (ns === ASSIGNEE) return -2
   if (ns === AUTHOR) return -1
   const at = KNOWN_ORDER.indexOf(ns)
   return at === -1 ? KNOWN_ORDER.length : at
 }
 
+/**
+ * Порядок значений внутри пространства.
+ *
+ * Приоритет — «срочное сначала», а не алфавит: `critical` сперва, `low`
+ * в самом низу. Для остальных — обычное сравнение строк.
+ */
+function valueRank(ns, value) {
+  if (ns !== PRIORITY) return 0
+  const at = PRIORITY_ORDER.indexOf(value)
+  return at === -1 ? PRIORITY_ORDER.length : at
+}
+
 /**
  * Подходит ли задача под выбранное.
  *
@@ -107,10 +144,24 @@ export function matchesFilters(task, selected) {
 
 function hasAny(task, ns, wanted) {
   if (ns === REPO) return wanted.includes(task?.repo ?? '')
+  if (ns === ASSIGNEE) {
+    const who = typeof task?.assignee === 'string' && task.assignee !== '' ? task.assignee : NOBODY
+    return wanted.includes(who)
+  }
   if (ns === AUTHOR) {
     const author = typeof task?.author === 'string' && task.author !== '' ? task.author : NO_AUTHOR
     return wanted.includes(author)
   }
+  if (ns === PRIORITY) {
+    // Приоритет и полем, и меткой `priority/*` — отбор по срочности не должен
+    // зависеть от источника значения.
+    if (wanted.includes(typeof task?.priority === 'string' ? task.priority : '')) return true
+    for (const name of task?.labels ?? []) {
+      const parsed = splitLabel(name)
+      if (parsed !== undefined && parsed.ns === PRIORITY && wanted.includes(parsed.value)) return true
+    }
+    return false
+  }
   for (const name of task?.labels ?? []) {
     const parsed = splitLabel(name)
     if (parsed !== undefined && parsed.ns === ns && wanted.includes(parsed.value)) return true
@@ -213,11 +264,24 @@ export function liveRank(task) {
   return 3
 }
 
-/** Поднять идущее наверх, не теряя прежнего порядка. */
+/** Вес приоритета при подъёме: срочное впереди тихого. */
+export function priorityWeight(priority) {
+  const at = PRIORITY_ORDER.indexOf(priority)
+  return at === -1 ? PRIORITY_ORDER.length : at
+}
+
+/**
+ * Поднять идущее наверх и приоритетное следом, не теряя прежнего порядка.
+ *
+ * Две независимые оси: сначала жизнь (ждёт/идёт/стоит), затем срочность
+ * (critical → low). Ручной порядок внутри ступени сохраняется.
+ */
 export function sortByLife(tasks) {
   return (tasks ?? [])
     .map((task, at) => ({ task, at }))
-    .sort((a, b) => liveRank(a.task) - liveRank(b.task) || a.at - b.at)
+    .sort((a, b) => liveRank(a.task) - liveRank(b.task)
+      || priorityWeight(a.task?.priority) - priorityWeight(b.task?.priority)
+      || a.at - b.at)
     .map((x) => x.task)
 }
 

package/lib/gitea.js

@@ -222,6 +222,34 @@ export function createGiteaClient({ getConfig, resolveToken, fetchImpl = fetch,
       return request('PATCH', repoPath(owner, repo, `/issues/${n}`), { state: 'closed' })
     },
 
+    /**
+     * Назначить ответственного за issue.
+     *
+     * Пустой список снимает назначение: Gitea понимает это как «никто», и
+     * доска обязана уметь то же самое — иначе снять с себя задачу можно было
+     * бы только руками в Gitea.
+     */
+    async setAssignees({ owner, repo, index, logins }) {
+      const n = safeSegment(index)
+      if (n === undefined) throw Object.assign(new Error('недопустимый номер issue'), { code: 'bad-segment' })
+      const list = (Array.isArray(logins) ? logins : [])
+        .filter((one) => typeof one === 'string' && one !== '')
+      return request('PATCH', repoPath(owner, repo, `/issues/${n}`), { assignees: list })
+    },
+
+    /**
+     * Кто мы для Gitea.
+     *
+     * «Взять себе» на доске значит «назначить того, чьим токеном доска ходит»:
+     * своего понятия пользователя у харнесса нет, и выдумывать его вместо
+     * ответа сервера нельзя.
+     */
+    async me() {
+      const row = await request('GET', '/user')
+      const login = row?.login
+      return typeof login === 'string' ? login : ''
+    },
+
     /** Организации, доступные токену. Нужны, чтобы не спрашивать владельца лишний раз. */
     async listOrgs() {
       const rows = await request('GET', '/user/orgs?limit=50')

package/lib/import.js

@@ -33,6 +33,22 @@ export function issueAuthor(issue) {
   return typeof login === 'string' ? login : ''
 }
 
+/**
+ * Кто отвечает за issue.
+ *
+ * Gitea отдаёт назначенного двумя способами: одиночным `assignee` и списком
+ * `assignees`. Берём первого из списка, когда одиночного нет: доска показывает
+ * ОДНОГО ответственного, потому что «отвечают все» означает «не отвечает
+ * никто».
+ */
+export function issueAssignee(issue) {
+  const one = issue?.assignee?.login
+  if (typeof one === 'string' && one !== '') return one
+  const many = Array.isArray(issue?.assignees) ? issue.assignees : []
+  const first = many.find((x) => typeof x?.login === 'string' && x.login !== '')
+  return first === undefined ? '' : first.login
+}
+
 /**
  * Поля задачи из issue.
  *
@@ -60,6 +76,7 @@ export function issueToTask(issue, { board = 'main', column = 'backlog', owner,
     issueUrl: typeof issue?.html_url === 'string' ? issue.html_url : undefined,
     createdAt: issueBornAt(issue),
     author: issueAuthor(issue),
+    assignee: issueAssignee(issue),
   }
 }
 
@@ -103,6 +120,12 @@ export function refreshPatch(task, issue) {
   if (born !== undefined) patch.createdAt = born
   const author = issueAuthor(issue)
   if (author !== '') patch.author = author
+  // Снятие ответственного — тоже факт, поэтому пустое значение пишется наравне
+  // с именем: иначе доска показывала бы вчерашнего владельца задачи, с которой
+  // его уже сняли.
+  if (issue?.assignee !== undefined || Array.isArray(issue?.assignees)) {
+    patch.assignee = issueAssignee(issue)
+  }
   return patch
 }
 

package/lib/index.js

@@ -22,7 +22,7 @@ import {
   MAX_BODY_BYTES, isTrustedRequest, parseTaskPath,
   buildBoard, applyMove, createTask, updateTask, deleteTask, appendNote, setArchived, listArchive,
   taskBody,
-  taskLog, taskBySession,
+  taskLog, taskBySession, exportBoard, importBoard, assignTask,
 } from './routes.js'
 import { listImportable, importIssue, refreshTask, searchRepos, createProjectTask } from './import.js'
 import {
@@ -36,7 +36,7 @@ import { isWatched } from './intake.js'
 import { handleSessionEvent } from './lifecycle.js'
 import { boardMoveDefinition, boardPlanDefinition } from './board-tool.js'
 import { verifySignature, parseEvent } from './webhook.js'
-import { planOutbound, createOutbox } from './outbound.js'
+import { planOutbound, planAssign, createOutbox } from './outbound.js'
 import { credentialRef } from '@deepseek-ai/dsh-credentials'
 
 export { COLUMN_ORDER, wipLimitField, withDefaults } from './config.js'
@@ -519,6 +519,28 @@ export function apply(ctx, config) {
     },
   }), 'dsh-kanban: маршрут доски')
 
+  // Снимок доски — ОДИН ресурс с двумя действиями, а не две ручки.
+  //
+  // Прежде выгрузка звалась `/export`, а загрузка занимала `/import` — тот
+  // самый путь, на котором с первого дня живёт импорт issue из Gitea. Два
+  // обработчика на одном пути означают, что один из них не отвечает вовсе, и
+  // какой именно — решает порядок регистрации, а не мы.
+  ctx.effect(() => ctx.webServer.register({
+    kind: 'exact',
+    path: '/dsh-kanban/snapshot',
+    handler: async (req, res) => {
+      if (req.method === 'GET') { reply(res, exportBoard({ store })); return }
+      if (req.method !== 'POST') { writeJson(res, 405, { error: 'method-not-allowed' }); return }
+      if (!isTrustedRequest(req)) { writeJson(res, 403, { error: 'cross-site' }); return }
+      try {
+        const input = await readBody(req)
+        reply(res, importBoard({ store, input }))
+      } catch {
+        writeJson(res, 400, { error: 'bad-request' })
+      }
+    },
+  }), 'dsh-kanban: снимок доски')
+
   ctx.effect(() => ctx.webServer.register({
     // Префикс регистрируется БЕЗ завершающего слэша: со слэшем сопоставление
     // сводится к равенству пути, и всё, что глубже, уходит в статику.
@@ -556,6 +578,17 @@ export function apply(ctx, config) {
       }
       if (!isTrustedRequest(req)) { writeJson(res, 403, { error: 'cross-site' }); return }
       if (req.method === 'DELETE' && action === undefined) { reply(res, deleteTask({ store, id })); return }
+      // Правка полей карточки: title, body, метки, приоритет. Приоритет —
+      // локальное свойство доски, в Gitea не пишется (updateTask это знает).
+      if (req.method === 'POST' && action === 'update') {
+        try {
+          const input = await readBody(req)
+          reply(res, updateTask({ store, id, input }))
+        } catch {
+          writeJson(res, 400, { error: 'bad-request' })
+        }
+        return
+      }
       if (req.method === 'POST' && action === 'refresh') {
         reply(res, await refreshTask({ gitea, store, id }))
         return
@@ -641,6 +674,29 @@ export function apply(ctx, config) {
           reply(res, out)
           return
         }
+        if (req.method === 'POST' && action === 'assign') {
+          const was = store.getTask(id)
+          if (was === undefined) { writeJson(res, 404, { error: 'task-not-found' }); return }
+          // Пустой логин снимает назначение; слово «me» просит того, чьим
+          // токеном ходит доска: своего понятия пользователя у харнесса нет.
+          let login = typeof input.login === 'string' ? input.login.trim() : ''
+          if (login === 'me') {
+            try {
+              login = await gitea.me()
+            } catch (error) {
+              writeJson(res, 502, { error: 'gitea-unreachable' })
+              return
+            }
+          }
+          const out = assignTask({ store, id, login })
+          if (out.task !== undefined && config.pushToGitea !== false) {
+            // В Gitea уходит очередью: доска не ждёт сеть и работает, когда
+            // Gitea лежит.
+            outbox.push(id, planAssign(out.task, login))
+          }
+          reply(res, out)
+          return
+        }
         if (req.method === 'POST' && action === 'archive') {
           reply(res, setArchived({ store, id, archived: true }))
           return

package/lib/outbound.js

@@ -13,6 +13,22 @@
 // из состояния issue, ветки и pull request, а метка лишь пересказывала в Gitea
 // то, что там уже написано. Взамен доска не трогает чужую разметку вовсе.
 
+/**
+ * Что отправить в Gitea при смене ответственного.
+ *
+ * Своей задачи (без issue) это не касается: назначать там некого и негде.
+ */
+export function planAssign(task, login) {
+  if (typeof task?.issueNumber !== 'number') return []
+  return [{
+    kind: 'assign',
+    owner: task.owner,
+    repo: task.repo,
+    index: task.issueNumber,
+    login: typeof login === 'string' ? login : '',
+  }]
+}
+
 export function planOutbound(task, column, config) {
   if (typeof task?.issueNumber !== 'number') return []
   // Закрытие issue — единственное, что доска сообщает Gitea: это факт, а не
@@ -58,6 +74,12 @@ export function createOutbox({ gitea, store, logger, maxAttempts = 4 }) {
           if (item.op.kind === 'close') {
             await gitea.closeIssue({ owner: item.op.owner, repo: item.op.repo, index: item.op.index })
           }
+          if (item.op.kind === 'assign') {
+            await gitea.setAssignees({
+              owner: item.op.owner, repo: item.op.repo, index: item.op.index,
+              logins: item.op.login === '' ? [] : [item.op.login],
+            })
+          }
           sent += 1
         } catch (error) {
           item.attempts += 1

package/lib/routes.js

@@ -67,6 +67,9 @@ function withPlan(task, liveOf, config, now, sameSession) {
       sessionId: task.sessionId,
       afterMinutes: config?.staleAfterMin,
     }),
+    // Просрочено — дедлайн есть и он раньше «сейчас». Считается на хосте,
+    // чтобы браузер не зависел от своих часов.
+    overdue: typeof task.dueAt === 'number' && task.dueAt > 0 && task.dueAt < now,
   }
 }
 
@@ -184,9 +187,21 @@ export function updateTask({ store, id, input }) {
   if (typeof input?.title === 'string' && input.title.trim() !== '') patch.title = input.title.trim()
   if (typeof input?.body === 'string') patch.body = input.body
   if (Array.isArray(input?.labels)) patch.labels = input.labels.filter((l) => typeof l === 'string')
+  // Приоритет — локальное свойство доски: в Gitea назад не пишется. Чужие
+  // значения отбрасываются: одно испорченное поле не должно ронять правку
+  // остальных.
+  if (PRIORITIES.includes(input?.priority)) patch.priority = input.priority
+  // Дедлайн — тоже локальное свойство. Ноль снимает, положительное число —
+  // ставит; отрицательное и мусор отбрасываются.
+  if (typeof input?.dueAt === 'number' && Number.isFinite(input.dueAt) && input.dueAt >= 0) {
+    patch.dueAt = Math.floor(input.dueAt)
+  }
   return { task: store.updateTask(id, patch) }
 }
 
+/** Известные приоритеты. Пустой — «без приоритета». */
+export const PRIORITIES = ['', 'high', 'medium', 'low']
+
 /**
  * Дописать заметку в тело задачи.
  *
@@ -222,6 +237,30 @@ export function listArchive({ store }) {
   return { tasks: store.listArchived() }
 }
 
+/**
+ * Назначить ответственного или снять назначение.
+ *
+ * Пустой логин — это снятие, а не отказ: «никто» такое же законное состояние
+ * задачи, как и любой исполнитель.
+ *
+ * @returns {{task: object}|{error: string, status: number}}
+ */
+export function assignTask({ store, id, login }) {
+  const task = store.getTask(id)
+  if (task === undefined) return { error: 'task-not-found', status: 404 }
+  const who = typeof login === 'string' ? login.trim() : ''
+  if (who === (task.assignee ?? '')) return { task }
+  store.updateTask(id, { assignee: who })
+  store.addTransition({
+    taskId: id,
+    fromCol: task.column,
+    toCol: task.column,
+    source: 'manual',
+    detail: who === '' ? 'ответственный снят' : `ответственный: ${who}`,
+  })
+  return { task: store.getTask(id) }
+}
+
 export function deleteTask({ store, id }) {
   if (store.getTask(id) === undefined) return { error: 'task-not-found', status: 404 }
   store.deleteTask(id)
@@ -254,3 +293,63 @@ export function taskBySession({ store, sessionId }) {
   // `deploy` задаче с простой доски значит звать в колонку, которой нет.
   return { task, columns: columnsOf(store.boardKind(task.board)) }
 }
+
+/**
+ * Полный снимок доски для бэкапа/переноса.
+ *
+ * Отдаём всё, что есть в хранилище: доски, задачи (включая архивные) и журнал
+ * переходов. Импорт восстанавливает это как есть.
+ */
+export function exportBoard({ store }) {
+  return store.exportAll()
+}
+
+/**
+ * Восстановить доску из снимка.
+ *
+ * Идемпотентно: существующая задача с тем же id не перезаписывается, а
+ * пропускается — повторный импорт не плодит дубли. Доски создаются, если их
+ * ещё нет.
+ *
+ * @returns {{imported: number, skipped: number, error?: string}}
+ */
+export function importBoard({ store, input }) {
+  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 }
+
+  let imported = 0
+  let skipped = 0
+
+  for (const board of Array.isArray(input.boards) ? input.boards : []) {
+    if (typeof board?.id !== 'string' || board.id === '') continue
+    store.createBoard({ id: board.id, title: board.title, kind: board.kind })
+  }
+
+  for (const task of input.tasks) {
+    if (typeof task?.id !== 'string' || task.id === '') continue
+    if (store.getTask(task.id) !== undefined) { skipped += 1; continue }
+    store.createTask({
+      id: task.id,
+      board: task.board ?? 'main',
+      column: task.column ?? 'backlog',
+      title: task.title ?? '',
+      body: task.body ?? '',
+      owner: task.owner, repo: task.repo,
+      issueNumber: task.issueNumber, issueUrl: task.issueUrl,
+      labels: Array.isArray(task.labels) ? task.labels : [],
+      branch: task.branch, worktree: task.worktree,
+      sessionId: task.sessionId, model: task.model, provider: task.provider,
+      waiting: task.waiting === true,
+      plan: task.plan ?? '',
+      labelColors: task.labelColors ?? {},
+      author: task.author ?? '',
+      priority: task.priority ?? '',
+      dueAt: typeof task.dueAt === 'number' ? task.dueAt : 0,
+      createdAt: task.createdAt,
+    })
+    imported += 1
+  }
+
+  return { imported, skipped }
+}

package/lib/store.js

@@ -50,6 +50,9 @@ CREATE TABLE IF NOT EXISTS tasks (
   queuedAt     INTEGER NOT NULL DEFAULT 0,
   labelColors  TEXT NOT NULL DEFAULT '{}',
   author       TEXT NOT NULL DEFAULT '',
+  assignee     TEXT NOT NULL DEFAULT '',
+  priority     TEXT NOT NULL DEFAULT '',
+  dueAt        INTEGER NOT NULL DEFAULT 0,
   syncedAt     INTEGER NOT NULL DEFAULT 0,
   createdAt    INTEGER NOT NULL,
   updatedAt    INTEGER NOT NULL
@@ -79,7 +82,7 @@ CREATE TABLE IF NOT EXISTS dismissed (
 const WRITABLE = [
   'title', 'body', 'owner', 'repo', 'issueNumber', 'issueUrl', 'labels',
   'branch', 'worktree', 'sessionId', 'model', 'provider', 'waiting', 'syncedAt', 'plan',
-  'labelColors', 'queuedAt', 'createdAt', 'author',
+  'labelColors', 'queuedAt', 'createdAt', 'author', 'assignee', 'priority', 'dueAt',
 ]
 
 /** Источники перехода; чужое значение не пишем, чтобы журнал оставался читаемым. */
@@ -124,6 +127,9 @@ export function openStore({ dir }) {
     ['queuedAt', 'INTEGER NOT NULL DEFAULT 0'],
     ['labelColors', "TEXT NOT NULL DEFAULT '{}'"],
     ['author', "TEXT NOT NULL DEFAULT ''"],
+    ['assignee', "TEXT NOT NULL DEFAULT ''"],
+    ['priority', "TEXT NOT NULL DEFAULT ''"],
+    ['dueAt', 'INTEGER NOT NULL DEFAULT 0'],
   ]) {
     try { db.exec(`ALTER TABLE tasks ADD COLUMN ${column} ${definition}`) } catch { /* столбец уже есть */ }
   }
@@ -138,6 +144,8 @@ export function openStore({ dir }) {
     insertBoard: db.prepare('INSERT INTO boards (id, title, kind, position, createdAt) VALUES (?, ?, ?, ?, ?)'),
     lastBoard: db.prepare('SELECT position FROM boards ORDER BY position DESC LIMIT 1'),
     taskById: db.prepare('SELECT * FROM tasks WHERE id = ?'),
+    allTasks: db.prepare('SELECT * FROM tasks ORDER BY board, col, position'),
+    allTransitions: db.prepare('SELECT * FROM transitions ORDER BY id'),
     tasksByBoard: db.prepare('SELECT * FROM tasks WHERE board = ? AND archivedAt = 0 ORDER BY col, position'),
     archived: db.prepare('SELECT * FROM tasks WHERE archivedAt > 0 ORDER BY archivedAt DESC'),
     archivable: db.prepare(
@@ -244,13 +252,15 @@ export function openStore({ dir }) {
       const born = Number(input.createdAt) || now
       const board = input.board ?? 'main'
       const column = input.column ?? 'backlog'
-      const id = randomUUID()
+      // Импорт восстанавливает задачу с её прежним id; обычное заведение
+      // генерирует новый.
+      const id = typeof input.id === 'string' && input.id !== '' ? input.id : randomUUID()
       const position = positionFor(board, column, input.beforeId, input.afterId)
       db.prepare(`INSERT INTO tasks
         (id, board, col, position, title, body, owner, repo, issueNumber, issueUrl,
          labels, branch, worktree, sessionId, model, provider, waiting, syncedAt,
-         labelColors, author, columnAt, createdAt, updatedAt)
-        VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`).run(
+         labelColors, author, assignee, priority, dueAt, columnAt, createdAt, updatedAt)
+        VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`).run(
         id, board, column, position,
         input.title ?? '', input.body ?? '',
         input.owner ?? null, input.repo ?? null,
@@ -262,6 +272,9 @@ export function openStore({ dir }) {
         Number(input.syncedAt) || 0,
         JSON.stringify(input.labelColors ?? {}),
         input.author ?? '',
+        input.assignee ?? '',
+        input.priority ?? '',
+        Number(input.dueAt) || 0,
         now, born, now,
       )
       return rowToTask(q.taskById.get(id))
@@ -359,6 +372,19 @@ export function openStore({ dir }) {
       return q.transitionsOf.all(taskId)
     },
 
+    /**
+     * Полный снимок доски для экспорта: все доски, все задачи (включая
+     * архивные) и журнал переходов. Импорт восстанавливает его как есть.
+     */
+    exportAll() {
+      return {
+        version: 1,
+        boards: q.boards.all(),
+        tasks: q.allTasks.all().map(rowToTask),
+        transitions: q.allTransitions.all(),
+      }
+    },
+
     close() {
       db.close()
     },

package/lib/sync.js

@@ -7,7 +7,7 @@
 import { deriveColumn, resolveTransition, branchOfTask, pullsOfTask, resolveConflict } from './transitions.js'
 import { watchedRepos, shouldTake, archiveBefore, isWatched } from './intake.js'
 import { colorsOfIssue } from './filters.js'
-import { issueToTask, issueBornAt, issueAuthor } from './import.js'
+import { issueToTask, issueBornAt, issueAuthor, issueAssignee } from './import.js'
 
 /**
  * Наблюдения по одному репозиторию.
@@ -94,6 +94,12 @@ function remoteFields(task, issue) {
   if (born !== undefined && born !== task.createdAt) patch.createdAt = born
   const author = issueAuthor(issue)
   if (author !== '' && author !== task.author) patch.author = author
+  // Ответственного сверка подхватывает В ОБЕ стороны: назначили в Gitea —
+  // видно на доске, сняли — тоже видно.
+  if (issue?.assignee !== undefined || Array.isArray(issue?.assignees)) {
+    const assignee = issueAssignee(issue)
+    if (assignee !== (task.assignee ?? '')) patch.assignee = assignee
+  }
   return patch
 }
 

package/lib/transitions.js

@@ -1,162 +1,162 @@
-// Автоперемещение карточек: вывод колонки из наблюдений и приоритет источников.
-//
-// Модуль чистый — ни сети, ни хранилища, ни харнесса. Наблюдения приходят
-// готовыми, решение возвращается значением. Поэтому вся логика переходов
-// проверяется тестами, а места, где она вызывается, остаются тонкими.
-
-/**
- * Приоритет источников. Без него «PR влит → deploy» через секунду перебивалось
- * бы «ход завершился → in-progress», и карточка прыгала бы туда-сюда.
- *
- * Меньше число — сильнее источник.
- */
-const PRIORITY = { gitea: 0, tool: 1, session: 2, manual: 3 }
-
-/** Pull request считается черновиком, пока с него не снят признак WIP. */
-export function isDraftPull(pull) {
-  if (pull?.draft === true) return true
-  return /^\s*(wip|draft)\b[:\s-]/i.test(String(pull?.title ?? ''))
-}
-
-/**
- * Колонка, которую диктуют наблюдения в Gitea.
- *
- * Порядок проверок идёт от самого позднего состояния к самому раннему: задача
- * не может «вернуться» в in-progress только потому, что ветка ещё цела, если
- * issue уже закрыт.
- *
- * WIP PR намеренно НЕ двигает карточку в review: он открывается рано и означает
- * «работа идёт», а не «смотрите».
- *
- * @param {object} obs наблюдения
- * @param {object} [obs.issue] issue из Gitea (`state`)
- * @param {Array}  [obs.pulls] pull request-ы, связанные с задачей
- * @param {boolean} [obs.branchExists] существует ли ветка задачи
- * @returns {string|undefined} колонка либо undefined, если наблюдения молчат
- */
-export function deriveColumn(obs) {
-  const issueClosed = obs?.issue?.state === 'closed'
-  const pulls = Array.isArray(obs?.pulls) ? obs.pulls : []
-  const branchExists = obs?.branchExists === true
-
-  // Задача завершена, только когда cleanup сделан: issue закрыт И ветки нет.
-  // Пока ветка цела, работа не закончена, сколько бы issue ни был закрыт.
-  if (issueClosed && !branchExists) return 'done'
-  if (issueClosed) return 'cleanup'
-
-  if (pulls.some((p) => p?.merged === true || p?.merged_at)) return 'deploy'
-  if (pulls.some((p) => p?.state === 'open' && !isDraftPull(p))) return 'review'
-  if (branchExists) return 'in-progress'
-  return undefined
-}
-
-/**
- * Выбрать перевод из нескольких предложений разных источников.
- *
- * Предложение, совпадающее с текущей колонкой, отбрасывается: перевод в ту же
- * колонку — не перевод, а лишняя строка в журнале.
- *
- * @param {string} current текущая колонка
- * @param {Array<{column: string, source: string, detail?: string}>} candidates
- * @returns {{column: string, source: string, detail: string}|undefined}
- */
-export function resolveTransition(current, candidates) {
-  const usable = (candidates ?? [])
-    .filter((c) => c && typeof c.column === 'string' && c.column !== '' && c.column !== current)
-    .filter((c) => PRIORITY[c.source] !== undefined)
-  if (usable.length === 0) return undefined
-  const best = usable.reduce((a, b) => (PRIORITY[a.source] <= PRIORITY[b.source] ? a : b))
-  return { column: best.column, source: best.source, detail: best.detail ?? '' }
-}
-
-/**
- * Нужен ли человек по событию сессии.
- *
- * Колонки «Блокировано» в согласованном наборе нет, поэтому запрос разрешения и
- * вопрос агента не двигают карточку, а поднимают на ней признак ожидания.
- * Двигать в несуществующую колонку нельзя, а прятать «агент стоит и ждёт» —
- * значит терять главное, ради чего смотрят на доску.
- *
- * @returns {boolean|undefined} true — поднять, false — снять, undefined — событие не про это
- */
-export function waitingFromEvent(type) {
-  switch (type) {
-    case 'approval/asked':
-    case 'question/requested':
-      return true
-    case 'approval/decided':
-    case 'turn/start':
-    case 'user/message':
-      return false
-    default:
-      return undefined
-  }
-}
-
-/** Имя ветки, по которому задача узнаёт свою: то, что наблюдалось, либо ничего. */
-export function branchOfTask(task, branches) {
-  const known = typeof task?.branch === 'string' && task.branch !== '' ? task.branch : undefined
-  const names = (branches ?? []).map((b) => (typeof b === 'string' ? b : b?.name)).filter(Boolean)
-  if (known !== undefined) return names.includes(known) ? known : undefined
-
-  // Ветку задачи заводит агент и называет как хочет, но номер issue в имени —
-  // общее правило воркфлоу. Ищем по номеру, а не по угаданному шаблону.
-  if (typeof task?.issueNumber !== 'number') return undefined
-  const marker = String(task.issueNumber)
-  return names.find((n) => new RegExp(`(^|[^0-9])${marker}([^0-9]|$)`).test(n))
-}
-
-/** Pull request-ы, относящиеся к задаче: по ветке либо по упоминанию issue. */
-export function pullsOfTask(task, pulls, branch) {
-  const number = typeof task?.issueNumber === 'number' ? task.issueNumber : undefined
-  return (pulls ?? []).filter((p) => {
-    if (branch !== undefined && p?.head?.ref === branch) return true
-    if (number === undefined) return false
-    const haystack = `${p?.title ?? ''} ${p?.body ?? ''}`
-    return new RegExp(`#${number}([^0-9]|$)`).test(haystack)
-  })
-}
-
-/**
- * Кто победил, когда обе стороны изменились с последней сверки.
- *
- * Правило простое: побеждает более позднее изменение. Важно другое —
- * проигравшая сторона НЕ исчезает молча, а возвращается в поле `overridden`,
- * чтобы вызывающий записал её в журнал задачи. Синхронизация, которая тихо
- * отменяет правку человека, хуже синхронизации, которой нет: расхождение
- * остаётся, а узнать о нём неоткуда.
- *
- * @param {object} state
- * @param {string} state.localColumn колонка на доске
- * @param {string} [state.remoteColumn] колонка, выведенная из Gitea
- * @param {number} state.localUpdatedAt когда правили на доске
- * @param {number} state.remoteUpdatedAt когда правили в Gitea
- * @param {number} state.syncedAt время последней удачной сверки
- * @returns {{winner: 'local'|'remote'|'none', column?: string, overridden?: string}}
- */
-export function resolveConflict({ localColumn, remoteColumn, localUpdatedAt, remoteUpdatedAt, syncedAt }) {
-  if (remoteColumn === undefined || remoteColumn === null || remoteColumn === '') return { winner: 'local' }
-  if (remoteColumn === localColumn) return { winner: 'none' }
-
-  const since = Number(syncedAt) || 0
-
-  // До первой сверки «изменилось с прошлого раза» не имеет смысла: прошлого
-  // раза не было. Карточку только что завели или импортировали, защищать в ней
-  // нечего, и первая сверка обязана принять положение дел, а не спорить с ним.
-  const firstSync = since === 0
-  const localChanged = !firstSync && (Number(localUpdatedAt) || 0) > since
-  const remoteChanged = firstSync || (Number(remoteUpdatedAt) || 0) > since
-
-  if (localChanged && remoteChanged) {
-    // Обе стороны двигались. Побеждает более позднее, проигравшее называется.
-    if ((Number(localUpdatedAt) || 0) > (Number(remoteUpdatedAt) || 0)) {
-      return { winner: 'local', overridden: remoteColumn }
-    }
-    return { winner: 'remote', column: remoteColumn, overridden: localColumn }
-  }
-
-  // Двигалась только доска — Gitea не имеет права тянуть карточку назад.
-  if (localChanged) return { winner: 'local' }
-
-  return { winner: 'remote', column: remoteColumn }
-}
+// Автоперемещение карточек: вывод колонки из наблюдений и приоритет источников.
+//
+// Модуль чистый — ни сети, ни хранилища, ни харнесса. Наблюдения приходят
+// готовыми, решение возвращается значением. Поэтому вся логика переходов
+// проверяется тестами, а места, где она вызывается, остаются тонкими.
+
+/**
+ * Приоритет источников. Без него «PR влит → deploy» через секунду перебивалось
+ * бы «ход завершился → in-progress», и карточка прыгала бы туда-сюда.
+ *
+ * Меньше число — сильнее источник.
+ */
+const PRIORITY = { gitea: 0, tool: 1, session: 2, manual: 3 }
+
+/** Pull request считается черновиком, пока с него не снят признак WIP. */
+export function isDraftPull(pull) {
+  if (pull?.draft === true) return true
+  return /^\s*(wip|draft)\b[:\s-]/i.test(String(pull?.title ?? ''))
+}
+
+/**
+ * Колонка, которую диктуют наблюдения в Gitea.
+ *
+ * Порядок проверок идёт от самого позднего состояния к самому раннему: задача
+ * не может «вернуться» в in-progress только потому, что ветка ещё цела, если
+ * issue уже закрыт.
+ *
+ * WIP PR намеренно НЕ двигает карточку в review: он открывается рано и означает
+ * «работа идёт», а не «смотрите».
+ *
+ * @param {object} obs наблюдения
+ * @param {object} [obs.issue] issue из Gitea (`state`)
+ * @param {Array}  [obs.pulls] pull request-ы, связанные с задачей
+ * @param {boolean} [obs.branchExists] существует ли ветка задачи
+ * @returns {string|undefined} колонка либо undefined, если наблюдения молчат
+ */
+export function deriveColumn(obs) {
+  const issueClosed = obs?.issue?.state === 'closed'
+  const pulls = Array.isArray(obs?.pulls) ? obs.pulls : []
+  const branchExists = obs?.branchExists === true
+
+  // Задача завершена, только когда cleanup сделан: issue закрыт И ветки нет.
+  // Пока ветка цела, работа не закончена, сколько бы issue ни был закрыт.
+  if (issueClosed && !branchExists) return 'done'
+  if (issueClosed) return 'cleanup'
+
+  if (pulls.some((p) => p?.merged === true || p?.merged_at)) return 'deploy'
+  if (pulls.some((p) => p?.state === 'open' && !isDraftPull(p))) return 'review'
+  if (branchExists) return 'in-progress'
+  return undefined
+}
+
+/**
+ * Выбрать перевод из нескольких предложений разных источников.
+ *
+ * Предложение, совпадающее с текущей колонкой, отбрасывается: перевод в ту же
+ * колонку — не перевод, а лишняя строка в журнале.
+ *
+ * @param {string} current текущая колонка
+ * @param {Array<{column: string, source: string, detail?: string}>} candidates
+ * @returns {{column: string, source: string, detail: string}|undefined}
+ */
+export function resolveTransition(current, candidates) {
+  const usable = (candidates ?? [])
+    .filter((c) => c && typeof c.column === 'string' && c.column !== '' && c.column !== current)
+    .filter((c) => PRIORITY[c.source] !== undefined)
+  if (usable.length === 0) return undefined
+  const best = usable.reduce((a, b) => (PRIORITY[a.source] <= PRIORITY[b.source] ? a : b))
+  return { column: best.column, source: best.source, detail: best.detail ?? '' }
+}
+
+/**
+ * Нужен ли человек по событию сессии.
+ *
+ * Колонки «Блокировано» в согласованном наборе нет, поэтому запрос разрешения и
+ * вопрос агента не двигают карточку, а поднимают на ней признак ожидания.
+ * Двигать в несуществующую колонку нельзя, а прятать «агент стоит и ждёт» —
+ * значит терять главное, ради чего смотрят на доску.
+ *
+ * @returns {boolean|undefined} true — поднять, false — снять, undefined — событие не про это
+ */
+export function waitingFromEvent(type) {
+  switch (type) {
+    case 'approval/asked':
+    case 'question/requested':
+      return true
+    case 'approval/decided':
+    case 'turn/start':
+    case 'user/message':
+      return false
+    default:
+      return undefined
+  }
+}
+
+/** Имя ветки, по которому задача узнаёт свою: то, что наблюдалось, либо ничего. */
+export function branchOfTask(task, branches) {
+  const known = typeof task?.branch === 'string' && task.branch !== '' ? task.branch : undefined
+  const names = (branches ?? []).map((b) => (typeof b === 'string' ? b : b?.name)).filter(Boolean)
+  if (known !== undefined) return names.includes(known) ? known : undefined
+
+  // Ветку задачи заводит агент и называет как хочет, но номер issue в имени —
+  // общее правило воркфлоу. Ищем по номеру, а не по угаданному шаблону.
+  if (typeof task?.issueNumber !== 'number') return undefined
+  const marker = String(task.issueNumber)
+  return names.find((n) => new RegExp(`(^|[^0-9])${marker}([^0-9]|$)`).test(n))
+}
+
+/** Pull request-ы, относящиеся к задаче: по ветке либо по упоминанию issue. */
+export function pullsOfTask(task, pulls, branch) {
+  const number = typeof task?.issueNumber === 'number' ? task.issueNumber : undefined
+  return (pulls ?? []).filter((p) => {
+    if (branch !== undefined && p?.head?.ref === branch) return true
+    if (number === undefined) return false
+    const haystack = `${p?.title ?? ''} ${p?.body ?? ''}`
+    return new RegExp(`#${number}([^0-9]|$)`).test(haystack)
+  })
+}
+
+/**
+ * Кто победил, когда обе стороны изменились с последней сверки.
+ *
+ * Правило простое: побеждает более позднее изменение. Важно другое —
+ * проигравшая сторона НЕ исчезает молча, а возвращается в поле `overridden`,
+ * чтобы вызывающий записал её в журнал задачи. Синхронизация, которая тихо
+ * отменяет правку человека, хуже синхронизации, которой нет: расхождение
+ * остаётся, а узнать о нём неоткуда.
+ *
+ * @param {object} state
+ * @param {string} state.localColumn колонка на доске
+ * @param {string} [state.remoteColumn] колонка, выведенная из Gitea
+ * @param {number} state.localUpdatedAt когда правили на доске
+ * @param {number} state.remoteUpdatedAt когда правили в Gitea
+ * @param {number} state.syncedAt время последней удачной сверки
+ * @returns {{winner: 'local'|'remote'|'none', column?: string, overridden?: string}}
+ */
+export function resolveConflict({ localColumn, remoteColumn, localUpdatedAt, remoteUpdatedAt, syncedAt }) {
+  if (remoteColumn === undefined || remoteColumn === null || remoteColumn === '') return { winner: 'local' }
+  if (remoteColumn === localColumn) return { winner: 'none' }
+
+  const since = Number(syncedAt) || 0
+
+  // До первой сверки «изменилось с прошлого раза» не имеет смысла: прошлого
+  // раза не было. Карточку только что завели или импортировали, защищать в ней
+  // нечего, и первая сверка обязана принять положение дел, а не спорить с ним.
+  const firstSync = since === 0
+  const localChanged = !firstSync && (Number(localUpdatedAt) || 0) > since
+  const remoteChanged = firstSync || (Number(remoteUpdatedAt) || 0) > since
+
+  if (localChanged && remoteChanged) {
+    // Обе стороны двигались. Побеждает более позднее, проигравшее называется.
+    if ((Number(localUpdatedAt) || 0) > (Number(remoteUpdatedAt) || 0)) {
+      return { winner: 'local', overridden: remoteColumn }
+    }
+    return { winner: 'remote', column: remoteColumn, overridden: localColumn }
+  }
+
+  // Двигалась только доска — Gitea не имеет права тянуть карточку назад.
+  if (localChanged) return { winner: 'local' }
+
+  return { winner: 'remote', column: remoteColumn }
+}

package/package.json

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