@alpacachen/dsh-kanban 1.1.0 → 1.2.0

package/README.md

@@ -18,7 +18,7 @@ Turn a conversation into an actionable plan without copying tasks between your A
 
 ## Why dsh-kanban?
 
-- **Plan in conversation** — 13 `kanban_*` tools let the agent create and manage cards, lists, and labels.
+- **Plan in conversation** — 14 `kanban_*` tools let the agent create and manage cards, lists, and labels.
 - **Stay in control** — edit cards, drag work between lists, reorder your workflow, and filter by priority from the UI.
 - **Keep projects separate** — every DSH workspace gets its own board and persisted data.
 - **Feel at home in DSH** — the board follows the active language and theme, including dark mode.
@@ -73,7 +73,7 @@ The plugin makes these tools available automatically in every workspace conversa
 | Area | Tools |
 | --- | --- |
 | Board | `kanban_get` |
-| Cards | `kanban_add_card`, `kanban_update_card`, `kanban_delete_card`, `kanban_move_card` |
+| Cards | `kanban_get_card`, `kanban_add_card`, `kanban_update_card`, `kanban_delete_card`, `kanban_move_card` |
 | Lists | `kanban_add_column`, `kanban_rename_column`, `kanban_delete_column`, `kanban_move_column` |
 | Labels | `kanban_get_label`, `kanban_add_label`, `kanban_update_label`, `kanban_delete_label` |
 

package/README.zh.md

@@ -18,7 +18,7 @@
 
 ## 为什么是 dsh-kanban？
 
-- **在对话里完成规划**：13 个 `kanban_*` 工具让 Agent 能直接管理卡片、列表和标签。
+- **在对话里完成规划**：14 个 `kanban_*` 工具让 Agent 能直接管理卡片、列表和标签。
 - **一切仍由你掌控**：编辑卡片、跨列拖拽、调整工作流，或按优先级筛选任务。
 - **项目之间互不干扰**：每个 DSH 工作区都有独立看板，并自动持久化数据。
 - **自然融入 DSH**：界面跟随当前语言和主题，也支持暗色模式。
@@ -73,7 +73,7 @@ Agent 会直接更新当前看板。之后你可以在界面中继续调整，
 | 范围 | 工具 |
 | --- | --- |
 | 看板 | `kanban_get` |
-| 卡片 | `kanban_add_card`、`kanban_update_card`、`kanban_delete_card`、`kanban_move_card` |
+| 卡片 | `kanban_get_card`、`kanban_add_card`、`kanban_update_card`、`kanban_delete_card`、`kanban_move_card` |
 | 列表 | `kanban_add_column`、`kanban_rename_column`、`kanban_delete_column`、`kanban_move_column` |
 | 标签 | `kanban_get_label`、`kanban_add_label`、`kanban_update_label`、`kanban_delete_label` |
 

package/index.js

@@ -7,7 +7,7 @@
  * 职责：
  *  - 按工作区（项目）隔离：boards 以 workspaceId 为键，每个工作区一块独立看板
  *  - 磁盘持久化：经 ctx.fs 写入 <workspaceRoot>/kanban-board-<workspaceId>.json
- *  - 模型工具：经 ctx.tools.register 注册 8 个 kanban_* 工具
+ *  - 模型工具：经 ctx.tools.register 注册 14 个 kanban_* 工具
  *  - 浏览器数据层：经 ctx.get('webServer') 注册 /api/kanban 前缀路由
  *
  * 数据模型（每工作区）：
@@ -156,6 +156,12 @@ export function apply(ctx) {
       case 'get':
         return { board: cloneBoard(board), persisted: persisted(), message: 'Board loaded' }
 
+      case 'getCard': {
+        const card = cloneBoard(board).cards.find((c) => c.id === str(a.id, ''))
+        if (!card) return { error: 'Card not found: ' + str(a.id, '') }
+        return { card }
+      }
+
       case 'addCard': {
         const col = findColumn(board, str(a.columnId, '')) || board.columns[0]
         if (!col) return result({ error: 'No list available' })
@@ -412,6 +418,46 @@ export function apply(ctx) {
         return runTool('get', args, exec)
       },
     },
+    {
+      name: 'kanban_get_card',
+      description: "Read one card's full details (title, note, label, priority) by id from the current project (workspace) board. Use kanban_get first to discover card ids, then this tool to read a card's complete note and fields.",
+      parameters: {
+        type: 'object',
+        properties: {
+          id: { type: 'string', description: 'Card id (see kanban_get output)' },
+        },
+        required: ['id'],
+      },
+      output: {
+        schema: {
+          type: 'object',
+          properties: {
+            ok: { type: 'boolean' },
+            message: { type: 'string' },
+            card: { type: 'object' },
+          },
+          required: ['ok', 'message'],
+          additionalProperties: false,
+        },
+        render: (args, value) => {
+          const c = value && value.card
+          const lines = [String((value && value.message) || '')]
+          if (c) {
+            lines.push('[' + c.id + '] ' + c.title)
+            if (c.priority) lines.push('Priority: ' + c.priority)
+            if (c.label) lines.push('Label: ' + c.label)
+            if (c.note) lines.push('Note: ' + c.note)
+          }
+          return [{ type: 'text', text: lines.join('\n') }]
+        },
+      },
+      async execute(args, exec) {
+        const wsid = await wsidOfExec(exec)
+        const r = await dispatch(wsid, 'getCard', args)
+        if (r.error) return { ok: false, message: r.error }
+        return { ok: true, message: 'Card ' + String(args.id || '') + ' details', card: r.card }
+      },
+    },
     {
       name: 'kanban_add_card',
       description: 'Add a card to the current project (workspace) kanban board. Write feature breakdowns and plans to the board: one card per task step.',