@goodandready/dsh-kanban 0.1.21 → 0.1.22

package/README.md

@@ -141,6 +141,15 @@ 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.
@@ -207,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,
@@ -948,6 +969,11 @@ window.__ModuleLoader__.load({
       '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',
@@ -1199,6 +1225,11 @@ window.__ModuleLoader__.load({
       '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': '我来接',
@@ -1741,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)
       // Чем запускать: профиль агента и уровень доступа. Обе службы у ядра
       // необязательны, поэтому пустой список — не поломка, а «выбирать не из
       // чего»: поле тогда не рисуется вовсе.
@@ -1830,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
@@ -2011,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),
@@ -2204,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', {
@@ -2226,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
@@ -2239,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))),

package/lib/index.js

@@ -387,6 +387,7 @@ export function apply(ctx, config) {
           agentPreset: typeof input.agentPreset === 'string' ? input.agentPreset : undefined,
           permission: typeof input.permission === 'string' ? input.permission : undefined,
           permissions: ctx.get('permissionPresets'),
+          claimAs: await whoAmI(),
         }))
       } catch (error) {
         writeJson(res, error?.status ?? 500, { error: 'batch-failed' })
@@ -525,6 +526,33 @@ export function apply(ctx, config) {
   // самый путь, на котором с первого дня живёт импорт issue из Gitea. Два
   // обработчика на одном пути означают, что один из них не отвечает вовсе, и
   // какой именно — решает порядок регистрации, а не мы.
+  /**
+   * Кто мы для Gitea, с памятью на время работы.
+   *
+   * Логин нужен и «взять себе», и запуску работы. Спрашивать его у Gitea
+   * каждый раз значит добавить в путь запуска ещё одну сеть, которая может не
+   * ответить; поэтому спрашиваем один раз и помним. Не ответила — работаем без
+   * назначения, а не отказываем в запуске.
+   */
+  let knownLogin
+  const whoAmI = async () => {
+    if (knownLogin !== undefined) return knownLogin
+    try {
+      knownLogin = await gitea.me()
+    } catch (error) {
+      knownLogin = ''
+    }
+    return knownLogin
+  }
+
+  ctx.effect(() => ctx.webServer.register({
+    kind: 'exact',
+    path: '/dsh-kanban/whoami',
+    // Пустой логин — законный ответ: Gitea может быть не настроен или не
+    // отвечать. Браузер по нему просто не рисует «Мои», а не показывает ноль.
+    handler: async (req, res) => { reply(res, { login: await whoAmI() }) },
+  }), 'dsh-kanban: кто мы для Gitea')
+
   ctx.effect(() => ctx.webServer.register({
     kind: 'exact',
     path: '/dsh-kanban/snapshot',
@@ -619,6 +647,7 @@ export function apply(ctx, config) {
             agentPreset: typeof input.agentPreset === 'string' ? input.agentPreset : undefined,
             permission: typeof input.permission === 'string' ? input.permission : undefined,
             permissions: ctx.get('permissionPresets'),
+            claimAs: await whoAmI(),
           }))
         } catch (error) {
           ctx.logger?.warn?.(`dsh-kanban: запуск задачи не удался: ${error?.message}`)
@@ -681,12 +710,8 @@ export function apply(ctx, config) {
           // токеном ходит доска: своего понятия пользователя у харнесса нет.
           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
-            }
+            login = await whoAmI()
+            if (login === '') { writeJson(res, 502, { error: 'gitea-unreachable' }); return }
           }
           const out = assignTask({ store, id, login })
           if (out.task !== undefined && config.pushToGitea !== false) {

package/lib/launcher.js

@@ -199,10 +199,34 @@ export async function obtainAgent({
  * @param {string} [text] сообщение человека; пусто — встроенная заготовка
  * @returns {{sessionId: string, mode: string, task: object}}
  */
+/**
+ * Взять задачу на себя при запуске.
+ *
+ * Запустить работу и оставить задачу ничьей — значит показать её свободной,
+ * когда над ней уже работают. Чужое назначение не трогаем: задачу могли отдать
+ * другому осознанно.
+ *
+ * @returns {string} логин, если назначение случилось; иначе пустая строка
+ */
+export function claimOnStart({ store, task, login }) {
+  const who = typeof login === 'string' ? login.trim() : ''
+  if (who === '') return ''
+  if (typeof task?.assignee === 'string' && task.assignee !== '') return ''
+  store.updateTask(task.id, { assignee: who })
+  store.addTransition({
+    taskId: task.id,
+    fromCol: task.column,
+    toCol: task.column,
+    source: 'manual',
+    detail: `ответственный: ${who} (взял при запуске)`,
+  })
+  return who
+}
+
 export async function runTask({
   agents, store, task, config, provider, model,
   mintSessionId, createMessage, cwdOf, logger, text,
-  agentPreset, permission, permissions,
+  agentPreset, permission, permissions, claimAs,
 }) {
   const taken = await obtainAgent({
     agents, task, config, provider, model, mintSessionId, cwdOf, logger,
@@ -220,6 +244,9 @@ export async function runTask({
   const before = store.getTask(task.id)
   const patch = { sessionId: taken.sessionId, provider, model }
   store.updateTask(task.id, patch)
+  // Запустил — значит отвечаешь: свободная задача становится твоей, чужая
+  // остаётся чужой.
+  claimOnStart({ store, task: before, login: claimAs })
 
   // Подмена чата не должна быть молчаливой: человек вернётся к задаче и не
   // поймёт, куда делась переписка.
@@ -297,7 +324,7 @@ export function buildQueuedMessage(task, config, at, total) {
 export async function runBatch({
   agents, store, tasks, config, provider, model,
   mintSessionId, createMessage, cwdOf, logger, text, now = Date.now(),
-  agentPreset, permission, permissions,
+  agentPreset, permission, permissions, claimAs,
 }) {
   const list = (tasks ?? []).filter((task) => task !== undefined)
   if (list.length === 0) return { error: 'nothing-picked', status: 400 }
@@ -329,6 +356,9 @@ export async function runBatch({
     // даже когда всё случилось в одну миллисекунду.
     const patch = { sessionId: taken.sessionId, provider, model, queuedAt: at === 0 ? 0 : now + at }
     store.updateTask(task.id, patch)
+    // Пачку берёт на себя тот, кто её запустил: пять карточек в работе без
+    // ответственного выглядят свободными.
+    claimOnStart({ store, task: before, login: claimAs })
     if (at === 0 && before.column === 'backlog') {
       store.moveTask(task.id, { column: 'in-progress' })
       store.addTransition({

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@goodandready/dsh-kanban",
-  "version": "0.1.21",
+  "version": "0.1.22",
   "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",
@@ -18,7 +18,8 @@
     "LICENSE"
   ],
   "scripts": {
-    "test": "node --test test/*.test.mjs"
+    "test": "node --test test/*.test.mjs",
+    "compat": "node tools/compat.mjs"
   },
   "keywords": [
     "dsh",