@goodandready/dsh-kanban 0.1.22 → 0.1.24

package/README.md

@@ -216,6 +216,32 @@ npm test
 
 ---
 
+### 8. Metrics: Where the Work Stands
+
+The transition log has been filling up since day one, but it could only be read
+one task at a time. The **Metrics** screen adds it up: how long tasks sit in each
+column (median first — one task forgotten for half a year drags the average
+until it describes nothing), how many reached Done in the last week and month,
+and which tasks have been sitting still longer than the threshold.
+
+Sitting time counts from entering the column, not from creation: a task can be
+old and still move every day. Nothing is written — a metric that writes stops
+being an observation and becomes another source of truth to disagree with.
+
+### 9. Milestones and Reviving a Dead Session
+
+The milestone travels with the issue and becomes a filter dimension of its own,
+so "what is left before 0.2.0" is answered on the board rather than in Gitea.
+Removing a milestone is news too, so an emptied field is synced like any other
+change. Setting a milestone from the board is deliberately out of scope for now:
+reading first, writing later, or we get a second place where it is edited.
+
+A task whose session died — the harness restarted, the agent is gone — shows
+"stopped". Its card now offers **resume work**: the old session is tried first,
+and only if it cannot be revived does a new one start. The board says which of
+the two happened, because "continued" and "started over" differ by whether the
+conversation still exists.
+
 ## 🔌 Core Compatibility Check
 
 A named import of an export the installed core no longer has is a `SyntaxError`
@@ -234,6 +260,12 @@ compares the requested names against the actual exports. It is deliberately not
 part of `npm test`: the test suite runs without a core and without a profile.
 Run it on the machine where the harness lives, before publishing.
 
+## 💻 Cross-Platform Path Handling
+
+Task working directories (`resolveCwd`) respect operating system path conventions.
+On Windows, repository root fencing accounts for drive letters and backslash path
+separators, ensuring full test and runtime compatibility across POSIX and Windows.
+
 ## 📄 License
 
 MIT © [GooDAnDReaDY](https://github.com/GooDAnDReaDY)

package/docs/design/DESIGN.md

@@ -0,0 +1,52 @@
+# DESIGN.md — dsh-kanban
+
+## Product / Purpose
+- Назначение: Интегрированная доска задач для DeepSeek Harness с двусторонней сверкой с Gitea, автоматическим подхватом сессий агентов и управлением жизненным циклом.
+- Аудитория: Разработчики и операторы DeepSeek Harness, ведущие проектные задачи и сессии агентов.
+- Статус: Production, версия 0.1.23+.
+
+## User Surfaces
+- Web/UI: Экран доски в центральной колонке интерфейса DSH (mountBoard), выдвигающаяся панель задач, фильтры, группировки (по проектам, по исполнителю), метрики переходов.
+- DSH UI / settings / slots:
+  - Карточка настроек в слоте settings.plugin.item (пространство dsh-kanban).
+  - Чип активной задачи в conversation.session.header.utilities.
+  - Пункт бокового меню для вызова экрана доски.
+- API: HTTP эндпоинты /dsh-kanban/* (board, snapshot, task, sync, webhook, metrics, whoami).
+- CLI: node tools/compat.mjs (проверка совместимости экспортов ядра).
+- Документация: README.md, docs/README.ru.md, docs/README.zh.md, index.md.
+
+## Visual Direction
+- Атмосфера: Строгий утилитарный инструментальный интерфейс в едином стиле темы DeepSeek Harness.
+- Утверждённые референсы и что из них берём: Системные карточки DSH (стили заголовков, отступы, шрифты, цветовые токены --dsw-alias-*).
+- Не копировать: Внешние неинтегрированные темы, разнородные цвета рамок и теней.
+
+## Foundations
+- Цвета и роли: Использование CSS-переменных DSH темы (--dsw-alias-bg-layer-3, --dsw-alias-border-l2, --dsw-alias-label-primary, --dsw-alias-label-secondary).
+- Типографика: Системный стек шрифтов DSH (inherit, 13-14px базовый размер, 11-12px для бейджей и служебных меток).
+- Сетка, отступы, responsive: 5 стандартных колонок (backlog, ready, progress, review, done) с горизонтальным скроллом и адаптивными карточками.
+- Accessibility: Нативные кнопки button, role="status" для сообщений, семантичные поля ввода с aria-label/label.
+
+## Components And States
+- Компоненты: BoardScreen, Column, Card, TaskDrawer, KanbanSettingsCard, TaskChip, MetricsModal.
+- Loading / empty / error / success:
+  - Загрузка: состояние скелетона/лоадера без блокировки скролла.
+  - Пустые колонки: пунктирная область перетаскивания.
+  - Ошибки: всплывающий баннер с ключом локализации t('error.' + err).
+- Формы, валидация и действия: Валидация обязательных полей при создании задачи, блокировка повторных кликов при сохранении.
+
+## User Flows
+- Критические сценарии:
+  1. Создание задачи / подхват из Gitea Issue.
+  2. Перемещение карточки между колонками человеком или через инструмент агента board_move.
+  3. Запуск сессии агента по карточке с автоматическим назначением ответственного.
+  4. Автоматическое обновление статуса (waiting) по событиям ядра (session/event).
+  5. Экспорт и импорт снимка доски в JSON.
+
+## Do / Don't
+- Do: Использовать только токены темы --dsw-alias-*, очищать все слушатели событий при размонтировании, соблюдать порядок хуков React.
+- Don't: Не переводить карточку в done агентом (колонка done фиксируется только по факту закрытия issue и ветки).
+
+## Locked Design Decisions
+- 2026-08-20 — Карточка настроек монтируется в settings.plugin.item с резервом в settings.section.
+- 2026-08-25 — Использование дробной индексации ($O(1)$) для позиционирования карточек.
+- 2026-09-02 — Снимок доски объединён на маршруте /dsh-kanban/snapshot (GET: выгрузка, POST: загрузка).

package/lib/client.js

@@ -950,6 +950,14 @@ 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.metrics': 'Metrics',
+      'metrics.hint': '{n} tasks on the board · done in a week: {week} · in a month: {month}',
+      'metrics.columns': 'Time spent in a column',
+      'metrics.median': 'median {time}',
+      'metrics.mean': 'average {time}',
+      'metrics.stale': 'Sitting still longer than {days} days',
+      'metrics.noStale': 'Nothing has been sitting that long.',
+      'metrics.empty': 'No transitions yet — nothing to measure.',
       'board.export': 'Download',
       'board.import': 'Import',
       'board.exportHint': 'Download the whole board as JSON',
@@ -984,6 +992,9 @@ window.__ModuleLoader__.load({
       'board.pickMove': 'Move to…',
       'board.someFailed': 'Done for {done} of {total}; the rest refused.',
       'card.stop': 'stop',
+      'card.revive': 'resume work',
+      'revive.same': 'The old session came back — the chat is where you left it.',
+      'revive.fresh': 'The old session was gone, so a new one started; the previous chat is not there any more.',
       'card.pack': 'batch {at} of {total}',
       'card.packHint': 'Started together, one session; the agent takes them in this order.',
       'stop.idle': 'The agent was not running — there was nothing to stop.',
@@ -1206,6 +1217,14 @@ window.__ModuleLoader__.load({
       'error.repo-not-created': '仓库没有创建，其他动作也未执行。',
       'error.issue-not-created': 'issue 没有创建。如果仓库是新建的，它仍然保留——没有删除任何东西。',
       'board.archive': '归档',
+      'board.metrics': '指标',
+      'metrics.hint': '看板上有 {n} 个任务 · 一周完成 {week} 个 · 一个月完成 {month} 个',
+      'metrics.columns': '在每一列停留的时间',
+      'metrics.median': '中位数 {time}',
+      'metrics.mean': '平均 {time}',
+      'metrics.stale': '停滞超过 {days} 天',
+      'metrics.noStale': '没有停滞这么久的任务。',
+      'metrics.empty': '还没有流转记录，无从统计。',
       'board.export': '下载',
       'board.import': '导入',
       'board.exportHint': '将整个看板下载为 JSON',
@@ -1240,6 +1259,9 @@ window.__ModuleLoader__.load({
       'board.pickMove': '移动到…',
       'board.someFailed': '{total} 个中完成了 {done} 个，其余被拒绝。',
       'card.stop': '停止',
+      'card.revive': '继续工作',
+      'revive.same': '原会话已恢复，对话还在原处。',
+      'revive.fresh': '原会话已不在，因此新开了一个；先前的对话不在其中。',
       'card.pack': '批次 {at}/{total}',
       'card.packHint': '一起启动，同一个会话；Agent 按这个顺序接手。',
       'stop.idle': 'Agent 本来就没有在跑，没有什么可停。',
@@ -1620,6 +1642,12 @@ window.__ModuleLoader__.load({
               // работу», разница лишь в том, кому и когда.
               // Останавливать нечего у того, кто не идёт: пункт, который
               // ничего не делает, хуже отсутствующего.
+              task.state === 'stopped'
+                ? React.createElement('button', {
+                  type: 'button', className: 'dkb-facetRow', key: 'revive',
+                  onClick: (e) => { e.stopPropagation(); props.onMenu(''); props.onRevive(task) },
+                }, t('card.revive'))
+                : null,
               task.state === 'running' || task.state === 'waiting'
                 ? React.createElement('button', {
                   type: 'button', className: 'dkb-facetRow', key: 'stop',
@@ -1766,6 +1794,7 @@ window.__ModuleLoader__.load({
       // выбор переживает и открытие окна, и обновление доски.
       const [picked, setPicked] = React.useState({})
       const [archive, setArchive] = React.useState(null)
+      const [metrics, setMetrics] = React.useState(null)
       // «Только ждущие» держим отдельно от отборов: это не значение измерения,
       // а взгляд «покажи, где стоит работа», и складывается он с любым отбором.
       const [onlyWaiting, setOnlyWaiting] = React.useState(false)
@@ -2080,11 +2109,22 @@ window.__ModuleLoader__.load({
           React.createElement('option', { value: 'old' }, t('order.old')),
           React.createElement('option', { value: 'new' }, t('order.new')),
         ),
+        React.createElement('button', {
+          type: 'button', className: metrics ? 'dkb-save' : 'dkb-discard',
+          onClick: async () => {
+            if (metrics) { setMetrics(null); return }
+            try {
+              setArchive(null)
+              setMetrics(await api('/metrics?board=' + encodeURIComponent(board)))
+            } catch (e) { setError(t(e.key || 'error.unknown')) }
+          },
+        }, t('board.metrics')),
         React.createElement('button', {
           type: 'button', className: archive ? 'dkb-save' : 'dkb-discard',
           onClick: async () => {
             if (archive) { setArchive(null); return }
             try {
+              setMetrics(null)
               const out = await api('/archive')
               setArchive(Array.isArray(out.tasks) ? out.tasks : [])
             } catch (e) { setError(t(e.key || 'error.unknown')) }
@@ -2332,6 +2372,18 @@ window.__ModuleLoader__.load({
               pack: packs[task.id],
               sameSession: hoverSession !== '' && task.sessionId === hoverSession,
               onHover: setHoverSession,
+              onRevive: async (x) => {
+                // Переиспользуем обычный запуск: он сам пробует возобновить
+                // прежнюю сессию и только потом заводит новую. Здесь важно
+                // сказать, что именно вышло.
+                try {
+                  const out = await api('/task/' + encodeURIComponent(x.id) + '/start', {
+                    method: 'POST', body: JSON.stringify({ revive: true }),
+                  })
+                  setError(t(out && out.mode === 'created' ? 'revive.fresh' : 'revive.same'))
+                  await load(board)
+                } catch (e) { setError(t(e.key || 'error.unknown')) }
+              },
               onStop: async (x) => {
                 try {
                   const out = await api('/task/' + encodeURIComponent(x.id) + '/stop', { method: 'POST', body: '{}' })
@@ -3073,10 +3125,46 @@ window.__ModuleLoader__.load({
         )
         : null
 
+      // Метрика — это взгляд на журнал, а не новые данные: экран ничего не
+      // меняет, поэтому и кнопок действий на нём нет.
+      const metricsEl = metrics
+        ? React.createElement('div', { className: 'dkb-archive' },
+          React.createElement('p', { className: 'dkb-hint' },
+            t('metrics.hint', { n: metrics.tasks, week: metrics.done.week, month: metrics.done.month })),
+          React.createElement('div', { className: 'dkb-group' }, t('metrics.columns')),
+          metrics.columns.length === 0
+            ? React.createElement('p', { className: 'dkb-note' }, t('metrics.empty'))
+            : React.createElement('ul', { className: 'dkb-archiveList' },
+              metrics.columns.map((row) => React.createElement('li', {
+                className: 'dkb-archiveRow', key: row.column,
+              },
+                React.createElement('span', { className: 'dkb-archiveTitle' }, columnTitle({ id: row.column }, t)),
+                React.createElement('span', { className: 'dkb-taskRef' },
+                  t('metrics.median', { time: agoText(0, -row.median, t) })),
+                React.createElement('span', { className: 'dkb-taskRef' },
+                  t('metrics.mean', { time: agoText(0, -row.mean, t) })),
+                React.createElement('span', { className: 'dkb-count' }, String(row.tasks)),
+              ))),
+          React.createElement('div', { className: 'dkb-group' },
+            t('metrics.stale', { days: metrics.staleDays })),
+          metrics.stale.length === 0
+            ? React.createElement('p', { className: 'dkb-note' }, t('metrics.noStale'))
+            : React.createElement('ul', { className: 'dkb-archiveList' },
+              metrics.stale.map((row) => React.createElement('li', {
+                className: 'dkb-archiveRow', key: row.id,
+              },
+                React.createElement('span', { className: 'dkb-archiveTitle' }, row.title),
+                React.createElement('span', { className: 'dkb-taskRef' }, columnTitle({ id: row.column }, t)),
+                React.createElement('span', { className: 'dkb-taskRef', title: exactAt(row.since) },
+                  agoText(state.now, row.since, t)),
+              ))),
+        )
+        : null
+
       return React.createElement('div', { className: 'dkb-screen' },
         style, bar,
         error ? React.createElement('p', { className: 'dkb-failed' }, error) : null,
-        archive ? archiveEl : columns,
+        metrics ? metricsEl : archive ? archiveEl : columns,
         panel, dialogEl, moveDialogEl, batchEl, queueEl,
       )
     }

package/lib/filters.js

@@ -14,6 +14,9 @@ export const AUTHOR = 'author'
 /** Ответственный: кто взял задачу, а не кто её завёл. */
 export const ASSIGNEE = 'assignee'
 
+/** Выпуск, к которому задача отнесена в Gitea. */
+export const MILESTONE = 'milestone'
+
 /** Приоритет — локальное свойство доски, своё измерение отбора. */
 export const PRIORITY = 'priority'
 
@@ -34,6 +37,9 @@ export const NO_AUTHOR = '—'
  */
 export const NOBODY = '—'
 
+/** Значение для задач вне выпусков: «когда-нибудь» — тоже ответ. */
+export const NO_MILESTONE = '—'
+
 /** Порядок приоритетов в отборе: срочное сверху. */
 export const PRIORITY_ORDER = ['critical', 'high', 'medium', 'low']
 
@@ -79,6 +85,7 @@ 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(MILESTONE, typeof task?.milestone === 'string' && task.milestone !== '' ? task.milestone : NO_MILESTONE)
     add(AUTHOR, typeof task?.author === 'string' && task.author !== '' ? task.author : NO_AUTHOR)
     // Приоритет живёт и полем (свои карточки), и меткой `priority/*` (задачи
     // из Gitea). Оба попадают в одно измерение — отбор по срочности не должен
@@ -106,6 +113,9 @@ function rank(ns) {
   // Ответственный идёт раньше автора: «кто делает» спрашивают чаще, чем «кто
   // завёл».
   if (ns === ASSIGNEE) return -2
+  // Выпуск идёт сразу за ответственным: «что осталось до релиза» спрашивают
+  // тогда же, когда «кто делает».
+  if (ns === MILESTONE) return -1.5
   if (ns === AUTHOR) return -1
   const at = KNOWN_ORDER.indexOf(ns)
   return at === -1 ? KNOWN_ORDER.length : at
@@ -148,6 +158,10 @@ function hasAny(task, ns, wanted) {
     const who = typeof task?.assignee === 'string' && task.assignee !== '' ? task.assignee : NOBODY
     return wanted.includes(who)
   }
+  if (ns === MILESTONE) {
+    const to = typeof task?.milestone === 'string' && task.milestone !== '' ? task.milestone : NO_MILESTONE
+    return wanted.includes(to)
+  }
   if (ns === AUTHOR) {
     const author = typeof task?.author === 'string' && task.author !== '' ? task.author : NO_AUTHOR
     return wanted.includes(author)

package/lib/import.js

@@ -49,6 +49,17 @@ export function issueAssignee(issue) {
   return first === undefined ? '' : first.login
 }
 
+/**
+ * К какому выпуску относится issue.
+ *
+ * Релизы ведут майлстоунами Gitea, а доска о них не знала: «что осталось до
+ * 0.2.0» приходилось смотреть в другом месте, хотя карточки лежат здесь.
+ */
+export function issueMilestone(issue) {
+  const title = issue?.milestone?.title
+  return typeof title === 'string' ? title : ''
+}
+
 /**
  * Поля задачи из issue.
  *
@@ -77,6 +88,7 @@ export function issueToTask(issue, { board = 'main', column = 'backlog', owner,
     createdAt: issueBornAt(issue),
     author: issueAuthor(issue),
     assignee: issueAssignee(issue),
+    milestone: issueMilestone(issue),
   }
 }
 
@@ -126,6 +138,9 @@ export function refreshPatch(task, issue) {
   if (issue?.assignee !== undefined || Array.isArray(issue?.assignees)) {
     patch.assignee = issueAssignee(issue)
   }
+  // Майлстоун снимают так же часто, как ставят, поэтому пустое значение —
+  // тоже новость, а не отсутствие новостей.
+  if ('milestone' in (issue ?? {})) patch.milestone = issueMilestone(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, exportBoard, importBoard, assignTask,
+  taskLog, taskBySession, exportBoard, importBoard, assignTask, boardMetrics,
 } from './routes.js'
 import { listImportable, importIssue, refreshTask, searchRepos, createProjectTask } from './import.js'
 import {
@@ -545,6 +545,20 @@ export function apply(ctx, config) {
     return knownLogin
   }
 
+  ctx.effect(() => ctx.webServer.register({
+    kind: 'exact',
+    path: '/dsh-kanban/metrics',
+    handler: (req, res) => {
+      const url = urlOf(req)
+      const days = Number(url.searchParams.get('staleDays'))
+      reply(res, boardMetrics({
+        store,
+        board: url.searchParams.get('board') || 'main',
+        staleDays: Number.isFinite(days) && days > 0 ? days : 14,
+      }))
+    },
+  }), 'dsh-kanban: метрики доски')
+
   ctx.effect(() => ctx.webServer.register({
     kind: 'exact',
     path: '/dsh-kanban/whoami',

package/lib/launcher.js

@@ -12,7 +12,7 @@
 // Пакеты ядра здесь не импортируются: идентификатор сессии и сборка сообщения
 // приходят параметрами. Так модуль проверяется без харнесса и без сети.
 
-import { isAbsolute, join, resolve } from 'node:path'
+import { isAbsolute, join, resolve, sep } from 'node:path'
 
 /**
  * Хвост своей задачи — УСЛОВИЕ, а не приказ.
@@ -110,7 +110,8 @@ export function resolveCwd(task, config, cwdOf = () => process.cwd()) {
 
   const target = resolve(join(root, repo))
   const fence = resolve(root)
-  if (target !== fence && !target.startsWith(fence.endsWith('/') ? fence : fence + '/')) {
+  const fenceSep = fence.endsWith(sep) || fence.endsWith('/') ? fence : fence + sep
+  if (target !== fence && !target.startsWith(fenceSep) && !target.startsWith(fence.endsWith('/') ? fence : fence + '/')) {
     throw new Error('имя репозитория выводит за пределы корня проектов')
   }
   return target
@@ -199,6 +200,19 @@ export async function obtainAgent({
  * @param {string} [text] сообщение человека; пусто — встроенная заготовка
  * @returns {{sessionId: string, mode: string, task: object}}
  */
+/**
+ * Что случилось при попытке продолжить работу.
+ *
+ * «Продолжил» и «начал заново» — разные вещи, и человек обязан видеть, какая
+ * из них произошла: в первом случае переписка на месте, во втором её больше
+ * нет.
+ *
+ * @returns {'opened'|'resumed'|'created'} как в obtainAgent
+ */
+export function revivalKind(mode) {
+  return mode === 'opened' || mode === 'resumed' ? mode : 'created'
+}
+
 /**
  * Взять задачу на себя при запуске.
  *

package/lib/metrics.js

@@ -0,0 +1,127 @@
+// Метрики доски: взгляд на журнал переходов, а не новые данные.
+//
+// Журнал копится с первого дня, но прочитать его можно было только по одной
+// задаче. Вопросы «где затык», «сколько живёт задача» и «что лежит месяц» имеют
+// ответ в тех же записях — их надо только сложить.
+//
+// Ничего не записываем: метрика, которая пишет, перестаёт быть наблюдением и
+// становится ещё одним источником правды, расходящимся с журналом.
+
+/**
+ * Сколько времени задача пробыла в каждой колонке.
+ *
+ * Переход закрывает предыдущий отрезок и открывает следующий. Последний
+ * отрезок закрывается «сейчас»: задача всё ещё лежит там, и это время идёт.
+ *
+ * @param {Array<{toCol: string, at: number}>} moves переходы задачи, старые первыми
+ * @param {number} bornAt когда задача заведена — начало первого отрезка
+ * @param {number} now
+ * @returns {Object<string, number>} колонка → миллисекунды
+ */
+export function timeInColumns(moves, bornAt, now) {
+  const rows = (moves ?? [])
+    .filter((m) => typeof m?.at === 'number' && typeof m?.toCol === 'string')
+    .slice()
+    .sort((a, b) => a.at - b.at)
+
+  const out = {}
+  // До первого перехода задача лежит там, где её завели. Колонку начала берём
+  // из первого перехода: `fromCol` и есть то, откуда она уехала.
+  let col = rows.length > 0 && typeof rows[0].fromCol === 'string' ? rows[0].fromCol : 'backlog'
+  let since = typeof bornAt === 'number' ? bornAt : (rows[0]?.at ?? now)
+
+  const add = (where, ms) => {
+    if (ms <= 0) return
+    out[where] = (out[where] ?? 0) + ms
+  }
+
+  for (const move of rows) {
+    add(col, move.at - since)
+    col = move.toCol
+    since = move.at
+  }
+  add(col, now - since)
+  return out
+}
+
+/** Медиана: половина значений меньше, половина больше. */
+export function median(values) {
+  const rows = (values ?? []).filter((x) => typeof x === 'number').slice().sort((a, b) => a - b)
+  if (rows.length === 0) return 0
+  const mid = Math.floor(rows.length / 2)
+  return rows.length % 2 === 1 ? rows[mid] : Math.round((rows[mid - 1] + rows[mid]) / 2)
+}
+
+/** Среднее; пустой набор даёт ноль, а не деление на ноль. */
+export function mean(values) {
+  const rows = (values ?? []).filter((x) => typeof x === 'number')
+  if (rows.length === 0) return 0
+  return Math.round(rows.reduce((sum, x) => sum + x, 0) / rows.length)
+}
+
+/**
+ * Сводка по колонкам: сколько в среднем и по медиане в них лежат.
+ *
+ * Медиана важнее среднего: одна задача, забытая на полгода, сдвигает среднее
+ * так, что оно перестаёт описывать хоть что-нибудь.
+ *
+ * @param {Array<{task: object, moves: object[]}>} rows
+ * @returns {Array<{column: string, mean: number, median: number, tasks: number}>}
+ */
+export function columnStats(rows, now) {
+  const byColumn = new Map()
+  for (const row of rows ?? []) {
+    const spent = timeInColumns(row.moves, row.task?.createdAt, now)
+    for (const [column, ms] of Object.entries(spent)) {
+      if (!byColumn.has(column)) byColumn.set(column, [])
+      byColumn.get(column).push(ms)
+    }
+  }
+  return [...byColumn.entries()]
+    .map(([column, values]) => ({
+      column,
+      mean: mean(values),
+      median: median(values),
+      tasks: values.length,
+    }))
+    .sort((a, b) => b.median - a.median)
+}
+
+/**
+ * Задачи, залежавшиеся в своей колонке дольше порога.
+ *
+ * Считаем от входа в колонку, а не от заведения: задача может быть старой и
+ * при этом двигаться каждый день.
+ *
+ * @returns {Array<{id: string, title: string, column: string, since: number}>}
+ */
+export function stale(tasks, now, thresholdMs) {
+  if (!(thresholdMs > 0)) return []
+  return (tasks ?? [])
+    .filter((task) => {
+      const at = typeof task?.columnAt === 'number' && task.columnAt > 0 ? task.columnAt : task?.createdAt
+      return typeof at === 'number' && now - at >= thresholdMs
+    })
+    .map((task) => ({
+      id: task.id,
+      title: task.title,
+      column: task.column,
+      since: (typeof task.columnAt === 'number' && task.columnAt > 0 ? task.columnAt : task.createdAt),
+    }))
+    .sort((a, b) => a.since - b.since)
+}
+
+/**
+ * Сколько задач доехало до «Выполнено» за период.
+ *
+ * Считаем по переходам, а не по текущей колонке: задача, ушедшая в архив,
+ * всё равно была сделана.
+ */
+export function doneWithin(rows, from, to) {
+  let count = 0
+  for (const row of rows ?? []) {
+    const hit = (row.moves ?? []).some((m) => m?.toCol === 'done' && m.at >= from && m.at <= to)
+    if (hit) count += 1
+  }
+  return count
+}

package/lib/routes.js

@@ -10,6 +10,7 @@
 
 import { COLUMN_ORDER, columnsOf, wipLimitField, columnNamesOf } from './config.js'
 import { parsePlan, planItems, planProgress, taskState, queuePosition } from './plan.js'
+import { columnStats, doneWithin, stale } from './metrics.js'
 import { isStale } from './time.js'
 import { facetsOf, facetsOfTask, groupByRepo, sortByLife } from './filters.js'
 import { parseBody } from './markdown.js'
@@ -274,6 +275,48 @@ export function deleteTask({ store, id }) {
  * позвать `lib/markdown.js` не может. Заодно тело не едет в разметку строкой,
  * и подставить туда чужое нечем.
  */
+/**
+ * Метрики доски: где стоит работа и что залежалось.
+ *
+ * Считается по журналу переходов и ничего не записывает. Порог «залежалось»
+ * приходит запросом, а не настройкой: это вопрос, который задают по-разному в
+ * разные дни, а не свойство доски.
+ *
+ * @returns {{columns: object[], done: object, stale: object[], tasks: number}}
+ */
+export function boardMetrics({ store, board = 'main', now = Date.now(), staleDays = 14 }) {
+  const tasks = store.listTasks({ board })
+  const byTask = new Map()
+  for (const row of store.listAllTransitions()) {
+    if (!byTask.has(row.taskId)) byTask.set(row.taskId, [])
+    byTask.get(row.taskId).push(row)
+  }
+  const rows = tasks.map((task) => ({ task, moves: byTask.get(task.id) ?? [] }))
+  const day = 24 * 60 * 60 * 1000
+
+  return {
+    tasks: tasks.length,
+    columns: columnStats(rows, now),
+    done: {
+      week: doneWithin(rows, now - 7 * day, now),
+      month: doneWithin(rows, now - 30 * day, now),
+    },
+    staleDays,
+    stale: stale(tasks, now, staleDays * day).slice(0, 50),
+  }
+}
+
+/**
+ * Можно ли предлагать «продолжить работу».
+ *
+ * Только когда сессия у задачи записана, а живого агента за ней нет: у живой
+ * продолжать нечего, у задачи без сессии — нечего возобновлять.
+ */
+export function canRevive(task, live) {
+  const has = typeof task?.sessionId === 'string' && task.sessionId !== ''
+  return has && (live === undefined || live === null)
+}
+
 export function taskBody({ store, id }) {
   const task = store.getTask(id)
   if (task === undefined) return { error: 'task-not-found', status: 404 }

package/lib/store.js

@@ -51,6 +51,7 @@ CREATE TABLE IF NOT EXISTS tasks (
   labelColors  TEXT NOT NULL DEFAULT '{}',
   author       TEXT NOT NULL DEFAULT '',
   assignee     TEXT NOT NULL DEFAULT '',
+  milestone    TEXT NOT NULL DEFAULT '',
   priority     TEXT NOT NULL DEFAULT '',
   dueAt        INTEGER NOT NULL DEFAULT 0,
   syncedAt     INTEGER NOT NULL DEFAULT 0,
@@ -82,7 +83,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', 'assignee', 'priority', 'dueAt',
+  'labelColors', 'queuedAt', 'createdAt', 'author', 'assignee', 'milestone', 'priority', 'dueAt',
 ]
 
 /** Источники перехода; чужое значение не пишем, чтобы журнал оставался читаемым. */
@@ -128,6 +129,7 @@ export function openStore({ dir }) {
     ['labelColors', "TEXT NOT NULL DEFAULT '{}'"],
     ['author', "TEXT NOT NULL DEFAULT ''"],
     ['assignee', "TEXT NOT NULL DEFAULT ''"],
+    ['milestone', "TEXT NOT NULL DEFAULT ''"],
     ['priority', "TEXT NOT NULL DEFAULT ''"],
     ['dueAt', 'INTEGER NOT NULL DEFAULT 0'],
   ]) {
@@ -259,8 +261,8 @@ export function openStore({ dir }) {
       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, assignee, priority, dueAt, columnAt, createdAt, updatedAt)
-        VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`).run(
+         labelColors, author, assignee, milestone, priority, dueAt, columnAt, createdAt, updatedAt)
+        VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`).run(
         id, board, column, position,
         input.title ?? '', input.body ?? '',
         input.owner ?? null, input.repo ?? null,
@@ -273,6 +275,7 @@ export function openStore({ dir }) {
         JSON.stringify(input.labelColors ?? {}),
         input.author ?? '',
         input.assignee ?? '',
+        input.milestone ?? '',
         input.priority ?? '',
         Number(input.dueAt) || 0,
         now, born, now,
@@ -372,6 +375,11 @@ export function openStore({ dir }) {
       return q.transitionsOf.all(taskId)
     },
 
+    /** Все переходы разом: метрике нужен журнал целиком, а не по одной задаче. */
+    listAllTransitions() {
+      return q.allTransitions.all()
+    },
+
     /**
      * Полный снимок доски для экспорта: все доски, все задачи (включая
      * архивные) и журнал переходов. Импорт восстанавливает его как есть.

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, issueAssignee } from './import.js'
+import { issueToTask, issueBornAt, issueAuthor, issueAssignee, issueMilestone } from './import.js'
 
 /**
  * Наблюдения по одному репозиторию.
@@ -100,6 +100,10 @@ function remoteFields(task, issue) {
     const assignee = issueAssignee(issue)
     if (assignee !== (task.assignee ?? '')) patch.assignee = assignee
   }
+  if ('milestone' in (issue ?? {})) {
+    const milestone = issueMilestone(issue)
+    if (milestone !== (task.milestone ?? '')) patch.milestone = milestone
+  }
   return patch
 }
 

package/package.json

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