@goodandready/dsh-kanban 0.2.2 → 0.2.8

package/README.md

@@ -21,6 +21,16 @@
   <a href="README.zh.md"><b>🇨🇳 中文说明</b></a>
 </p>
 
+<table align="center">
+  <tr>
+    <td align="center">
+      ⭐ <strong>If you like this plugin, please star it on GitHub</strong> — it shows me that the plugin is useful to you and motivates me to keep developing it.
+      <br><br>
+      🐛 <strong>If you find a bug or would like to request a feature</strong>, open a GitHub issue in any language — I will review your proposal and implement useful suggestions in a future plugin version.
+    </td>
+  </tr>
+</table>
+
 </div>
 
 ---
@@ -286,3 +296,17 @@ deregistration.
 ## 📄 License
 
 MIT © [GooDAnDReaDY](https://github.com/GooDAnDReaDY)
+
+## Public composition service
+
+The server half exposes an optional dshKanban composition service. Its
+createTask({ title, body, board, column, labels, owner, repo, issueNumber,
+issueUrl, externalRef }) method validates the target board and column, stores
+the task through the existing SQLite-backed path, and returns { ok, task,
+taskId, alreadyExists }. A repeated externalRef returns the original card,
+including after a restart.
+
+This service only creates a card. It does not launch an agent, create a branch,
+create a worktree, or accept credentials from a consumer. The canonical
+consumer contract for task provisioning is
+dsh-drives.task-provision.v1.

package/{docs/README.ru.md → README.ru.md}

@@ -21,6 +21,16 @@
   <a href="README.zh.md"><b>🇨🇳 中文说明</b></a>
 </p>
 
+<table align="center">
+  <tr>
+    <td align="center">
+      ⭐ <strong>Если вам нравится этот плагин, поставьте ему звезду на GitHub</strong> — это покажет мне, что плагин вам полезен, и будет мотивировать меня развивать его дальше.
+      <br><br>
+      🐛 <strong>Если вы нашли баг или хотите предложить новый функционал</strong>, создайте issue на GitHub на любом языке — я рассмотрю ваше предложение и реализую полезные идеи в одной из следующих версий плагина.
+    </td>
+  </tr>
+</table>
+
 </div>
 
 ---

package/{docs/README.zh.md → README.zh.md}

@@ -21,6 +21,16 @@
   <a href="README.zh.md"><b>🇨🇳 中文说明</b></a>
 </p>
 
+<table align="center">
+  <tr>
+    <td align="center">
+      ⭐ <strong>如果您喜欢这个插件，请在 GitHub 上为它点亮 Star</strong> — 这能让我知道插件对您有用，并鼓励我继续开发和维护它。
+      <br><br>
+      🐛 <strong>如果您发现 Bug 或希望增加功能</strong>，请使用任意语言在 GitHub 上提交 Issue — 我会评估您的建议，并在后续版本中实现有价值的改进。
+    </td>
+  </tr>
+</table>
+
 </div>
 
 ---
@@ -171,3 +181,14 @@ npm test
 ## 📄 开源许可证
 
 MIT © [GooDAnDReaDY](https://github.com/GooDAnDReaDY)
+
+## 公共组合服务
+
+服务器端暴露可选的 dshKanban 组合服务。其
+createTask({ title, body, board, column, labels, owner, repo, issueNumber,
+issueUrl, externalRef }) 方法校验目标看板和列，通过现有的 SQLite 存储路径
+保存任务，并返回 { ok, task, taskId, alreadyExists }。重复的 externalRef
+会返回原有卡片，重启后仍然有效。
+
+该服务只创建卡片，不启动代理、不创建分支或 worktree，也不接受调用方传入的
+凭据。任务供应的规范消费者契约是 dsh-drives.task-provision.v1。

package/lib/board-tool.js

@@ -367,3 +367,154 @@ export function boardCommentAddDefinition({ store }) {
     },
   }
 }
+
+/** Определение board_decompose (#248) */
+export function boardDecomposeDefinition({ store, gitea }) {
+  return {
+    name: 'board_decompose',
+    description: 'Decompose a task into child subtasks, converting the task into an Epic with linked progress tracking.',
+    parameters: {
+      subtasks: {
+        type: 'array',
+        items: { type: 'string' },
+        description: 'List of child subtask titles to create.',
+        required: true,
+      },
+      create_gitea_issues: {
+        type: 'boolean',
+        description: 'Whether to create linked Gitea issues for each subtask if repository is linked.',
+      },
+      task: {
+        type: 'string',
+        description: 'Task reference (`repo#number` or card id). Required if this session carries multiple tasks.',
+      },
+    },
+    output: {
+      schema: { type: 'string', description: 'Status and list of created subtasks.' },
+      render: (_args, value) => [{ type: 'text', text: String(value) }],
+    },
+    async execute({ subtasks, create_gitea_issues, task: ref }, exec) {
+      const picked = pickTask(store, exec, ref)
+      if (picked.error !== undefined) return picked.error
+      const task = picked.task
+      if (!Array.isArray(subtasks) || subtasks.length === 0) {
+        return 'At least one subtask title is required in `subtasks`.'
+      }
+
+      store.updateTask(task.id, { isEpic: true })
+      const created = []
+      const giteaClient = typeof gitea === 'function' ? gitea() : gitea
+      const createGitea = create_gitea_issues === true && Boolean(task.owner && task.repo && giteaClient)
+
+      for (const item of subtasks) {
+        const title = (typeof item === 'string' ? item : item?.title || '').trim()
+        if (!title) continue
+        const body = typeof item === 'object' && item?.body ? String(item.body).trim() : ''
+        let issueNumber = null
+        let issueUrl = null
+
+        if (createGitea) {
+          try {
+            const issueBody = body ? `${body}\n\nParent epic: #${task.issueNumber || task.id}` : `Parent epic: #${task.issueNumber || task.id}`
+            const giteaIssue = await giteaClient.createIssue({
+              owner: task.owner,
+              repo: task.repo,
+              title,
+              body: issueBody,
+            })
+            if (giteaIssue?.number) {
+              issueNumber = giteaIssue.number
+              issueUrl = giteaIssue.html_url || null
+            }
+          } catch { /* gitea issue creation best-effort */ }
+        }
+
+        const sub = store.createTask({
+          board: task.board || 'main',
+          column: 'backlog',
+          title,
+          body,
+          parentId: task.id,
+          owner: task.owner || null,
+          repo: task.repo || null,
+          issueNumber,
+          issueUrl,
+          workspaceId: task.workspaceId || '',
+        })
+        created.push(sub)
+      }
+
+      store.addTransition({
+        taskId: task.id,
+        fromCol: task.column,
+        toCol: task.column,
+        source: 'tool',
+        detail: `agent decomposed task into ${created.length} subtasks`,
+      })
+
+      return `Decomposed task "${task.title}" into ${created.length} subtasks:\n`
+        + created.map((s, i) => `${i + 1}. [${s.id.slice(0, 8)}] ${s.title}${s.issueNumber ? ` (#${s.issueNumber})` : ''}`).join('\n')
+    },
+  }
+}
+
+/** Определение board_checklist_item (#248) */
+export function boardChecklistItemDefinition({ store }) {
+  return {
+    name: 'board_checklist_item',
+    description: 'Toggle or check a specific DoD checklist item by text or index without replacing the entire list.',
+    parameters: {
+      text: {
+        type: 'string',
+        description: 'Text substring matching the checklist item to toggle.',
+      },
+      index: {
+        type: 'number',
+        description: 'Zero-based index of the checklist item to toggle.',
+      },
+      done: {
+        type: 'boolean',
+        description: 'Explicit completion state (true to mark done, false to unmark). If omitted, toggles state.',
+      },
+      task: {
+        type: 'string',
+        description: 'Task reference (`repo#number` or card id). Required if this session carries multiple tasks.',
+      },
+    },
+    output: {
+      schema: { type: 'string', description: 'Status confirmation.' },
+      render: (_args, value) => [{ type: 'text', text: String(value) }],
+    },
+    async execute({ text, index, done, task: ref }, exec) {
+      const picked = pickTask(store, exec, ref)
+      if (picked.error !== undefined) return picked.error
+      const task = picked.task
+      const checklist = Array.isArray(task.checklist) ? [...task.checklist] : []
+      let targetIndex = -1
+
+      if (typeof index === 'number' && index >= 0 && index < checklist.length) {
+        targetIndex = index
+      } else if (typeof text === 'string' && text.trim()) {
+        const q = text.trim().toLowerCase()
+        targetIndex = checklist.findIndex((item) => {
+          const t = typeof item === 'string' ? item : item?.text
+          return typeof t === 'string' && t.toLowerCase().includes(q)
+        })
+      }
+
+      if (targetIndex === -1) {
+        return `Checklist item matching index=${index} / text="${text}" not found.`
+      }
+
+      const item = checklist[targetIndex]
+      const oldDone = typeof item === 'object' && item !== null ? Boolean(item.done) : false
+      const newDone = done !== undefined ? Boolean(done) : !oldDone
+      const title = typeof item === 'string' ? item : (item?.text || '')
+      checklist[targetIndex] = { text: title, done: newDone }
+
+      store.updateChecklist(task.id, checklist)
+      return `Checklist item #${targetIndex + 1} "${title}" marked as ${newDone ? 'DONE' : 'PENDING'}.`
+    },
+  }
+}
+