@alpacachen/dsh-kanban 1.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 alpacachen
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,144 @@
+<div align="center">
+
+# dsh-kanban
+
+**Plan with your AI. See the work move.**
+
+A shared kanban board for [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness), built for both people and agents.
+
+[简体中文](README.zh.md) · English
+
+</div>
+
+Turn a conversation into an actionable plan without copying tasks between your AI assistant and a project tracker. Ask the agent to break down a feature, prioritize a bug, or move finished work—the same changes appear instantly in the **Board** tab, where you can continue organizing everything by hand.
+
+<p align="center">
+  <img src="./image.png" alt="dsh-kanban board inside DeepSeek Harness" width="100%">
+</p>
+
+## Why dsh-kanban?
+
+- **Plan in conversation** — 13 `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.
+- **Install and go** — the browser bundle is prebuilt; no frontend toolchain or native build step is required.
+
+## Quick start
+
+### 1. Install the plugin
+
+```sh
+# From GitHub
+dsh plugin --profile web add github:alpacachen/dsh-kanban
+```
+
+You can also install the published npm package or a local checkout:
+
+```sh
+dsh plugin --profile web add @alpacachen/dsh-kanban
+dsh plugin --profile web add ./dsh-kanban
+```
+
+Restart `dsh web` after installation so the plugin bundle is loaded. To confirm that it was added successfully:
+
+```sh
+dsh --profile web --dump-config
+```
+
+The output should include a `dsh-kanban` layer.
+
+### 2. Open the board
+
+Open a workspace and select the **Board** tab next to the conversation views. A new board starts with **Todo**, **In Progress**, **Review**, and **Done**.
+
+### 3. Plan with the agent
+
+Try a prompt like:
+
+> Break the authentication feature into implementation tasks, add one card per step, and mark the security review as P0.
+
+The agent updates the board directly. You can then refine the plan in the UI, or keep working through conversation.
+
+## What you can do
+
+### From the Board tab
+
+- Create, edit, delete, and drag cards between lists
+- Add notes, labels, and P0 / P1 / P2 priorities
+- Create, rename, reorder, and remove lists
+- Create labels and customize their colors
+- Filter the board by priority
+
+### From a conversation
+
+The plugin makes these tools available automatically in every workspace conversation:
+
+| Area | Tools |
+| --- | --- |
+| Board | `kanban_get` |
+| Cards | `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` |
+
+A few more things you can ask:
+
+- “Summarize what is currently in progress.”
+- “Move ‘Fix login redirect’ to In Progress and set it to P0.”
+- “Add a Blocked list after In Progress.”
+- “Create a red Urgent label and apply it to the release card.”
+
+## Data and persistence
+
+Boards are isolated by workspace and stored through the DSH filesystem service as `kanban-board-<workspaceId>.json`. They survive browser refreshes and DSH restarts, and uninstalling the plugin does not delete existing board data.
+
+## How it works
+
+`dsh-kanban` uses the standard DSH bundle format:
+
+- `index.js` registers the agent tools and the `/api/kanban` browser endpoint.
+- Both interfaces share one data layer, so the agent and the Board tab always operate on the same board.
+- `cordis.patch.yml` adds the plugin to the selected DSH profile.
+- `lib/client.js` is the prebuilt web client loaded by DSH.
+
+The client is built with React, TypeScript, Tailwind CSS, shadcn/ui, Radix UI, and dnd-kit. React itself is provided by DSH, keeping the distributed bundle smaller and avoiding duplicate runtimes.
+
+## Development
+
+Requirements: Node.js and pnpm.
+
+```sh
+pnpm install
+pnpm build
+pnpm typecheck
+```
+
+For an unminified client bundle while debugging:
+
+```sh
+node build.mjs --no-minify
+```
+
+Project layout:
+
+```text
+index.js              # Host plugin, tools, persistence, and HTTP endpoint
+cordis.patch.yml      # DSH bundle patch
+build.mjs             # Client build script
+src/client/           # React and TypeScript source
+lib/client.js         # Prebuilt browser bundle published with the package
+```
+
+## Contributing
+
+Issues and pull requests are welcome. If you are planning a larger change, opening an issue first is a good way to align on the approach before implementation.
+
+## Uninstall
+
+```sh
+dsh plugin --profile web remove @alpacachen/dsh-kanban
+```
+
+## License
+
+MIT

package/README.zh.md

@@ -0,0 +1,144 @@
+<div align="center">
+
+# dsh-kanban
+
+**和 AI 一起规划，在看板上看到进展。**
+
+一个为 [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) 打造、由你和 Agent 共同维护的项目看板。
+
+简体中文 · [English](README.md)
+
+</div>
+
+不用再把 AI 给出的计划手动搬进项目管理工具。让 Agent 拆解功能、调整优先级或推进任务，变更会立即出现在 **「看板」**标签页；你也可以随时接手，通过拖拽和编辑继续整理工作。
+
+<p align="center">
+  <img src="./image.png" alt="DeepSeek Harness 中的 dsh-kanban 看板界面" width="100%">
+</p>
+
+## 为什么是 dsh-kanban？
+
+- **在对话里完成规划**：13 个 `kanban_*` 工具让 Agent 能直接管理卡片、列表和标签。
+- **一切仍由你掌控**：编辑卡片、跨列拖拽、调整工作流，或按优先级筛选任务。
+- **项目之间互不干扰**：每个 DSH 工作区都有独立看板，并自动持久化数据。
+- **自然融入 DSH**：界面跟随当前语言和主题，也支持暗色模式。
+- **安装后即可使用**：浏览器端已预构建，不需要额外配置前端工具链，也没有原生构建步骤。
+
+## 快速开始
+
+### 1. 安装插件
+
+```sh
+# 从 GitHub 安装
+dsh plugin --profile web add github:alpacachen/dsh-kanban
+```
+
+也可以从 npm 或本地目录安装：
+
+```sh
+dsh plugin --profile web add @alpacachen/dsh-kanban
+dsh plugin --profile web add ./dsh-kanban
+```
+
+安装后重启 `dsh web`，让插件 bundle 在启动时加载。可以通过下面的命令确认配置：
+
+```sh
+dsh --profile web --dump-config
+```
+
+如果安装成功，输出中会包含 `dsh-kanban` 配置层。
+
+### 2. 打开看板
+
+进入任意工作区，在会话视图旁打开**「看板」**标签页。新看板默认包含 **Todo**、**In Progress**、**Review** 和 **Done** 四个列表。
+
+### 3. 让 Agent 开始规划
+
+试试这样说：
+
+> 把登录功能拆成具体的实现任务，每一步建一张卡片，并把安全审查标为 P0。
+
+Agent 会直接更新当前看板。之后你可以在界面中继续调整，也可以留在对话里推进任务。
+
+## 你可以做什么
+
+### 在「看板」标签页中
+
+- 创建、编辑、删除卡片，并将卡片拖到其他列表
+- 为卡片补充备注、标签和 P0 / P1 / P2 优先级
+- 创建、重命名、排序和删除列表
+- 创建标签并自定义颜色
+- 按优先级筛选整个看板
+
+### 在对话中
+
+插件会自动为工作区内的对话提供以下工具：
+
+| 范围 | 工具 |
+| --- | --- |
+| 看板 | `kanban_get` |
+| 卡片 | `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` |
+
+你还可以这样使用：
+
+- 「总结一下目前正在进行的任务。」
+- 「把『修复登录跳转』移到进行中，并设为 P0。」
+- 「在进行中后面新增一个阻塞列表。」
+- 「创建一个红色的『紧急』标签，并加到发布卡片上。」
+
+## 数据与持久化
+
+看板按工作区隔离，并通过 DSH 文件系统服务保存为 `kanban-board-<workspaceId>.json`。刷新页面或重启 DSH 都不会丢失数据；卸载插件时，已有的看板数据也会保留。
+
+## 工作原理
+
+`dsh-kanban` 使用标准的 DSH bundle 格式：
+
+- `index.js` 注册 Agent 工具和浏览器端使用的 `/api/kanban` 接口。
+- Agent 与「看板」标签页共享同一套数据层，双方看到的始终是同一块看板。
+- `cordis.patch.yml` 将插件加入指定的 DSH profile。
+- `lib/client.js` 是由 DSH 直接加载的预构建 Web 客户端。
+
+客户端使用 React、TypeScript、Tailwind CSS、shadcn/ui、Radix UI 和 dnd-kit 构建。React 由 DSH 提供，以减少发布体积并避免重复运行时。
+
+## 本地开发
+
+需要准备 Node.js 和 pnpm。
+
+```sh
+pnpm install
+pnpm build
+pnpm typecheck
+```
+
+调试时可以生成未压缩的客户端 bundle：
+
+```sh
+node build.mjs --no-minify
+```
+
+项目结构：
+
+```text
+index.js              # 宿主插件、Agent 工具、持久化与 HTTP 接口
+cordis.patch.yml      # DSH bundle 补丁
+build.mjs             # 客户端构建脚本
+src/client/           # React 与 TypeScript 源码
+lib/client.js         # 随包发布的预构建浏览器 bundle
+```
+
+## 参与贡献
+
+欢迎提交 Issue 和 Pull Request。如果准备进行较大的改动，建议先开一个 Issue 讨论目标和实现方式，避免重复工作。
+
+## 卸载
+
+```sh
+dsh plugin --profile web remove @alpacachen/dsh-kanban
+```
+
+## 开源许可
+
+MIT

package/cordis.patch.yml

@@ -0,0 +1,6 @@
+# dsh-kanban bundle patch：把看板插件行插入 profile 组合。
+# 安装后该行通过包名 @alpacachen/dsh-kanban 解析（Node 从 profile 的 node_modules 找到本包）。
+# 层顺序：@deepseek-ai/dsh-base → 本 bundle → profile 自己的 cordis.patch.yml → 用户 --patch 覆盖。
+- insert:
+    - id: dsh-kanban
+      name: "@alpacachen/dsh-kanban"