@goodandready/dsh-kanban 0.1.20 → 0.1.22

package/README.md

@@ -127,7 +127,34 @@ A due date can be set on any card. Overdue cards are highlighted, and a switch i
 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
+### 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".
+
+Three shortcuts follow from ownership. The column groups **by assignee** as
+well as by project, with "nobody took it" always first — that group is what the
+layout is opened for. A **"Mine: N"** button in the header narrows the board to
+your own tasks in one click; it is drawn only when Gitea told the board who you
+are and you actually have tasks, because a lying counter is worse than none.
+And **starting work takes the task**: a free task becomes yours on launch, alone
+or as part of a batch, while a task already assigned to someone else is left
+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
@@ -189,6 +216,24 @@ npm test
 
 ---
 
+## 🔌 Core Compatibility Check
+
+A named import of an export the installed core no longer has is a `SyntaxError`
+at parse time: the whole plugin tree fails to load and the harness restarts in a
+loop. That happened twice in one week, and both times the owner found out before
+the tests did.
+
+```bash
+npm run compat            # uses $DSH_HOME, or ~/.dsh/profiles/web
+npm run compat -- /path/to/profile
+```
+
+The check reads every `import { … } from '@deepseek-ai/…'` in `lib/`, resolves
+each package the way the harness resolves it — from the profile directory — and
+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.
+
 ## 📄 License
 
 MIT © [GooDAnDReaDY](https://github.com/GooDAnDReaDY)

package/lib/client.js

@@ -149,6 +149,27 @@ window.__ModuleLoader__.load({
       return out
     }
 
+    /**
+     * Разложить колонку по ответственным.
+     *
+     * Группа «никто» идёт первой: свободные задачи — то, ради чего в эту
+     * раскладку и заглядывают. Дальше по алфавиту, чтобы порядок не плясал от
+     * того, кто первым попался в списке.
+     *
+     * @returns {Array<{who: string, tasks: object[]}>}
+     */
+    function groupByAssignee(tasks) {
+      const by = new Map()
+      for (const task of tasks || []) {
+        const who = typeof task.assignee === 'string' && task.assignee !== '' ? task.assignee : ''
+        if (!by.has(who)) by.set(who, [])
+        by.get(who).push(task)
+      }
+      return [...by.entries()]
+        .sort((a, b) => (a[0] === '' ? -1 : b[0] === '' ? 1 : a[0].localeCompare(b[0])))
+        .map(([who, list]) => ({ who, tasks: list }))
+    }
+
     function cardRef(task) {
       if (!task || !task.repo) return ''
       if (typeof task.issueNumber !== 'number') return task.repo
@@ -599,7 +620,7 @@ window.__ModuleLoader__.load({
     }
 
     const helpers = {
-      neighboursFor, tasksOf, sortTasks, packInfo, applyToEach, recallLaunch, rememberLaunch, stillOffered,
+      neighboursFor, tasksOf, sortTasks, packInfo, groupByAssignee, applyToEach, recallLaunch, rememberLaunch, stillOffered,
       cardRef, taskRef, cardStatus, facetLabel, boardTitle,
       columnTitle, planLine, stateLabel, isCollapsed,
       agoText, exactAt, shortDate, syncLine, readableOn, tagStyle, priorityColor, renderBlocks, renderSpans, matchesFilters, anySelected, toggleValue, normalizeBoard, errorKey,
@@ -682,6 +703,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}' +
@@ -946,6 +968,17 @@ window.__ModuleLoader__.load({
       'sync.neverSeen': 'no successful check since the harness started',
       'facet.repo': 'Repository',
       'facet.author': 'Author',
+      'facet.assignee': 'Assignee',
+      'board.mine': 'Mine: {n}',
+      'board.mineHint': 'Tasks assigned to {who}',
+      'group.repo': 'By project',
+      'group.assignee': 'By assignee',
+      'group.nobody': 'nobody took it',
+      '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…',
@@ -1191,6 +1224,17 @@ window.__ModuleLoader__.load({
       'sync.neverSeen': '自 harness 启动以来没有一次成功的核对',
       'facet.repo': '仓库',
       'facet.author': '创建者',
+      'facet.assignee': '负责人',
+      'board.mine': '我的：{n}',
+      'board.mineHint': '指派给 {who} 的任务',
+      'group.repo': '按项目',
+      'group.assignee': '按负责人',
+      'group.nobody': '无人接手',
+      'card.assigneeHint': '谁接下了这个任务',
+      'panel.assignee': '由 {who} 接手',
+      'panel.assignMe': '我来接',
+      'panel.assignDrop': '放手',
+      'error.gitea-unreachable': 'Gitea 没有响应，无从得知以谁的身份接手。',
       'board.pickArchive': '移入归档',
       'board.pickUnqueue': '移出队列',
       'board.pickMove': '移动到…',
@@ -1623,6 +1667,10 @@ window.__ModuleLoader__.load({
                 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'),
@@ -1724,6 +1772,13 @@ window.__ModuleLoader__.load({
       const [onlyOverdue, setOnlyOverdue] = React.useState(false)
       const [hoverSession, setHoverSession] = React.useState('')
       const [order, setOrder] = React.useState('manual')
+      // «По проектам» — как приходит с сервера; «по ответственному» — своя
+      // раскладка поверх того же порядка.
+      const [grouping, setGrouping] = React.useState('repo')
+      // Кто «я»: спрашивается один раз у сервера. Пусто — Gitea не ответил, и
+      // кнопку «Мои» рисовать нельзя: соврать числом хуже, чем не показать.
+      const [me, setMe] = React.useState('')
+      const [onlyMine, setOnlyMine] = React.useState(false)
       // Чем запускать: профиль агента и уровень доступа. Обе службы у ядра
       // необязательны, поэтому пустой список — не поломка, а «выбирать не из
       // чего»: поле тогда не рисуется вовсе.
@@ -1813,6 +1868,9 @@ window.__ModuleLoader__.load({
 
       React.useEffect(() => {
         let alive = true
+        api('/whoami')
+          .then((out) => { if (alive && out) setMe(typeof out.login === 'string' ? out.login : '') })
+          .catch(() => {})
         api('/presets')
           .then((out) => {
             if (!alive || !out) return
@@ -1994,6 +2052,26 @@ window.__ModuleLoader__.load({
             onClick: () => setOnlyOverdue((cur) => !cur),
           }, t('board.overdueCount', { n: overdue }))
         })(),
+        (() => {
+          // Ноль своих задач — кнопки нет: пустой счётчик в шапке перестают
+          // замечать вместе с непустым.
+          if (me === '') return null
+          const mine = state.tasks.filter((x) => x.assignee === me).length
+          if (mine === 0) return null
+          return React.createElement('button', {
+            type: 'button',
+            className: 'dkb-waitCount' + (onlyMine ? ' dkb-save' : ''),
+            title: t('board.mineHint', { who: me }),
+            onClick: () => setOnlyMine((cur) => !cur),
+          }, t('board.mine', { n: mine }))
+        })(),
+        React.createElement('select', {
+          className: 'dkb-input', style: { width: 'auto' }, value: grouping,
+          onChange: (e) => setGrouping(e.target.value),
+        },
+          React.createElement('option', { value: 'repo' }, t('group.repo')),
+          React.createElement('option', { value: 'assignee' }, t('group.assignee')),
+        ),
         React.createElement('select', {
           className: 'dkb-input', style: { width: 'auto' }, value: order,
           onChange: (e) => setOrder(e.target.value),
@@ -2187,9 +2265,18 @@ window.__ModuleLoader__.load({
           const items = sortTasks(
             all.filter((task) => matchesQuery(task, query))
               .filter((task) => !onlyWaiting || task.state === 'waiting')
-              .filter((task) => !onlyOverdue || task.overdue === true),
+              .filter((task) => !onlyOverdue || task.overdue === true)
+              .filter((task) => !onlyMine || task.assignee === me),
             order,
           )
+          // Ключ группы решает переключатель: заголовки, сворачивание и
+          // счётчики остаются те же, меняется только по чему делим.
+          const groupKeyOf = (task) => (grouping === 'assignee'
+            ? (task.assignee || '')
+            : (task.repo || ''))
+          const ordered = grouping === 'assignee'
+            ? groupByAssignee(items).flatMap((one) => one.tasks)
+            : items
           const limit = col.limit
           const overLimit = limit !== undefined && limit !== null && all.length > limit
           const slot = (index) => React.createElement('div', {
@@ -2209,11 +2296,11 @@ window.__ModuleLoader__.load({
           // разложенными, поэтому группы идут подряд и разрываться не могут.
           let group = null
           const sizes = new Map()
-          for (const x of items) sizes.set(x.repo || '', (sizes.get(x.repo || '') || 0) + 1)
+          for (const x of ordered) sizes.set(groupKeyOf(x), (sizes.get(groupKeyOf(x)) || 0) + 1)
           const manyGroups = sizes.size > 1
 
-          items.forEach((task, i) => {
-            const repo = task.repo || ''
+          ordered.forEach((task, i) => {
+            const repo = groupKeyOf(task)
             if (manyGroups && repo !== group) {
               group = repo
               const shut = groups[col.id + '/' + repo] === true
@@ -2222,7 +2309,8 @@ window.__ModuleLoader__.load({
                 'aria-expanded': !shut,
                 onClick: () => setGroups((cur) => Object.assign({}, cur, { [col.id + '/' + repo]: !shut })),
               },
-                React.createElement('span', null, repo || t('board.noRepo')),
+                React.createElement('span', null,
+                  repo || t(grouping === 'assignee' ? 'group.nobody' : 'board.noRepo')),
                 // Счётчик виден и у свёрнутой: группа с работой, выглядящая
                 // пустой, — то же зло, что и свёрнутая колонка без числа.
                 React.createElement('span', { className: 'dkb-groupCount' }, String(sizes.get(repo))),
@@ -2355,6 +2443,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 }) : ''),
@@ -2420,6 +2509,22 @@ window.__ModuleLoader__.load({
               },
             }, 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' },