@goodandready/dsh-kanban 0.1.18 → 0.1.20

package/README.md

@@ -116,6 +116,27 @@ 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. 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

@@ -734,6 +734,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 +896,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 +928,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.',
@@ -1017,6 +1025,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 +1141,7 @@ window.__ModuleLoader__.load({
       'board.expand': '展开该列',
       'card.move': '移动',
       'card.toChat': '进入对话',
+      'card.due': '截止 {date}',
       'card.pick': '选中以便批量启动',
       'card.queue': '加入队列…',
       'card.unqueue': '移出队列',
@@ -1154,6 +1173,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': '归档是空的。',
@@ -1246,6 +1270,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 +1515,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 +1617,12 @@ 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,
             pack
               ? React.createElement('span', {
                 className: 'dkb-pack', title: t('card.packHint'),
@@ -1644,6 +1686,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 +1721,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 +1889,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 +1982,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 +2012,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 +2186,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
@@ -2272,6 +2372,54 @@ 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')),
+          ),
           openTask.sessionId
             ? React.createElement('button', {
               type: 'button', className: 'dkb-discard', style: { alignSelf: 'flex-start' },