paseo-kanban 0.1.4 → 0.2.0

package/OVERVIEW.md

@@ -4,6 +4,7 @@ A lightweight, responsive Kanban board plugin for Paseo workspaces.
 
 ## Features
 
+- **GitHub issue import**: Import up to 25 open issues from the project’s GitHub.com origin into a chosen lane. Tasks remain independent and link back to their source. Requires Git and an authenticated `gh` on the daemon machine.
 - **Flexible swimlanes**: Add, delete, and rename lanes.
 - **Rich task cards**: Edit task titles and multi-line descriptions, manage subtask checklists, and link tasks to Paseo projects.
 - **Task completion**: Check a card or drag it into the completion lane to finish; uncheck or drag out to restore.
@@ -12,8 +13,8 @@ A lightweight, responsive Kanban board plugin for Paseo workspaces.
 
 ## Storage and requirements
 
-- **Data and privacy**: Board data is stored locally in host-scoped plugin settings with revision checks for concurrent edits. No accounts, tokens, or external network requests are required.
-- **Host requirement**: Paseo 0.8.0 or later.
+- **Data and privacy**: Board data is stored locally in host-scoped plugin settings with revision checks for concurrent edits. Core board use requires no external service; optional GitHub import reads GitHub using the daemon machine’s existing `gh` authentication and copies selected issue content into local settings.
+- **Host requirement**: Paseo 0.11.4 or later.
 
 ---
 
@@ -23,6 +24,7 @@ A lightweight, responsive Kanban board plugin for Paseo workspaces.
 
 ## 核心功能
 
+- **GitHub Issue 导入**：从项目的 GitHub.com origin 选择 Open Issues，每次最多导入 25 项到指定泳道；任务独立管理并保留外链。需要在 daemon 所在机器安装 Git 并登录 `gh`。
 - **灵活的泳道管理**：支持泳道增删与改名。
 - **丰富的任务卡片**：支持任务标题与多行描述编辑、子步骤清单管理，以及关联 Paseo 项目。
 - **任务完成与恢复**：通过卡片勾选或拖入完成泳道标记完成；取消勾选或拖出即可恢复。
@@ -31,5 +33,5 @@ A lightweight, responsive Kanban board plugin for Paseo workspaces.
 
 ## 存储与要求
 
-- **数据与隐私**：看板数据保存在宿主本地插件设置中，具备版本并发冲突保护（CAS）。无需账号、Token 或任何外部网络请求。
-- **宿主要求**：Paseo 0.8.0 或更高版本。
+- **数据与隐私**：看板数据保存在宿主本地插件设置中，具备版本并发冲突保护（CAS）。看板基础功能无需外部服务；可选的 GitHub 导入使用 daemon 所在机器的 `gh` 登录态读取 GitHub，并将选中的 Issue 内容复制到本地设置。
+- **宿主要求**：Paseo 0.11.4 或更高版本。

package/README.md

@@ -4,23 +4,51 @@
 
 A lightweight, responsive Kanban board plugin for [Paseo](https://paseo.sh) workspaces.
 
+![Paseo Kanban Board](./assets/marketplace/board-0.1.3.png)
+
 ---
 
-## Features
+## Highlights
+
+- **Swimlane Management**: Freely add, rename, and delete custom swimlanes to organize tasks according to your team's workflow stages.
+- **Drag-and-Drop Interaction**: Fluid intra-lane reordering and cross-lane movement with animated drop-slot displacement, viewport edge auto-scrolling, and smooth drop-in feedback.
+- **GitHub Issue Import**: One-way import of open issues from the project repository's GitHub origin into a chosen lane, featuring pagination, repository-wide creation-time sorting, automatic deduplication, and source links.
+
+---
+
+## Other Features
 
-- **Flexible Swimlanes**: Add, delete, and rename lanes.
 - **Rich Task Cards**:
-  - Task title and multi-line description editing.
-  - Subtasks checklist.
-  - Support linking tasks to projects created in Paseo.
-- **Workspace Tabs and Splits**: Open the board beside an agent or terminal, initially filtered to the workspace's project, or use the sidebar entry.
-- **Smooth Drag-and-Drop**: Support intra-lane reordering and cross-lane movement.
+  - Task title and multi-line description editing (with resizable description area).
+  - Subtask checklists with live completion progress tracking.
+  - Link tasks to projects created in Paseo.
+- **Task Completion & Restoration**: Check a card or drag it into the completion lane to finish; uncheck or drag out to restore cards to their original ordinary swimlane.
+- **Workspace Tabs and Splits**: Open the board beside an agent or terminal with Paseo's native split controls, initially filtered to the workspace's project, or use the sidebar entry.
+- **Independent Project Filtering**: Filter cards by specific Paseo projects or view unassigned tasks without isolating the shared underlying board data.
+- **Host Storage & Concurrency Protection**: Board data is safely stored in host-scoped plugin settings with optimistic revision checks (CAS) to prevent silent overwrites and preserve form drafts.
+
+---
+
+## Screenshots
+
+### Board Overview
+
+![Board Overview](./assets/marketplace/board-0.1.3.png)
+
+### Task Details & Subtasks Checklist
+
+![Task Editor](./assets/marketplace/task-editor-0.1.3.png)
+
+### Workspace Tabs & Split Controls
+
+![Workspace Split](./assets/marketplace/workspace-split-0.1.3.png)
 
 ---
 
 ## Requirements
 
-- **Paseo host**: `>= 0.8.0` (declared in `paseo-plugin.json`). The host runs the plugin.
+- **Paseo host**: `>= 0.11.4` (declared in `paseo-plugin.json`). The host runs the plugin.
+- **GitHub import (optional)**: Install Git and GitHub CLI (`gh`) on the daemon machine, sign in with `gh auth login`, and configure the project repository’s `origin` on GitHub.com. Both public and authorized private repositories are supported.
 - **Development and CI**: Node.js 24 (pinned in `.nvmrc` and `.node-version`) for checks, TypeScript stripping, and native tests.
 
 ---
@@ -91,7 +119,7 @@ Individual commands (`npm test`, `npm run typecheck`, `npm run lint`, `npm run f
 
 ## Releases
 
-See the [0.1.4 release notes](./docs/releases/0.1.4.md). Each release's npm package and GitHub Release share the same version tag; GitHub includes the verified npm tarball. `main` may contain changes beyond the latest release.
+See the [CHANGELOG](./CHANGELOG.md). Each release's npm package and GitHub Release share the same version tag; GitHub includes the verified npm tarball. `main` may contain changes beyond the latest release.
 
 ---
 

package/README.zh-CN.md

@@ -4,23 +4,51 @@
 
 专为 [Paseo](https://paseo.sh) 工作区打造的轻量响应式看板插件。
 
+![Paseo 看板全景概览](./assets/marketplace/board-0.1.3.png)
+
 ---
 
-## 核心功能
+## 亮点特性
+
+- **泳道管理**：自由新增、重命名与删除自定义泳道，按团队工作流灵活组织任务流转阶段。
+- **拖拽交互**：流畅的同泳道排序与跨泳道状态流转，支持动态占位槽避让、视口边缘自动滚动与平滑落位动画。
+- **GitHub Issue 导入**：从项目关联的 GitHub 仓库单向导入 Open Issues 到指定泳道，具备分页、全仓库创建时间排序、自动去重及来源外链直达能力。
+
+---
+
+## 其他特性
 
-- **灵活的泳道管理**：支持泳道增删与改名。
 - **丰富的任务卡片**：
-  - 任务标题与多行描述编辑。
-  - 子步骤清单。
-  - 支持关联 Paseo 中创建的项目。
-- **工作区标签页与分屏**：与 Agent、Terminal 并排打开看板，默认筛选工作区所属项目；或使用侧边栏入口。
-- **流畅拖拽交互**：支持同泳道排序与跨泳道状态流转。
+  - 任务标题与多行描述编辑（支持多行描述框拖拽调节高度）。
+  - 子步骤清单与完成进度实时统计。
+  - 支持将任务关联至 Paseo 中创建的项目。
+- **任务完成与恢复**：卡片左侧勾选复选框或拖入专用完成泳道即可标记完成；取消勾选或拖出即可无损恢复至原普通泳道。
+- **工作区标签页与分屏**：支持通过 Paseo 原生分屏控件与 Agent、终端任意并排打开，默认自动筛选当前工作区项目，亦可通过侧边栏独立打开。
+- **独立项目筛选**：支持按关联项目快速筛选或查看未关联任务，各打开窗口筛选独立且共享整板底层数据。
+- **宿主持久化与并发保护**：看板数据安全保存在宿主设置中，具备版本并发冲突保护（CAS），表单草稿与错误状态受保护不被静默覆盖。
+
+---
+
+## 界面预览
+
+### 看板全景
+
+![看板全景](./assets/marketplace/board-0.1.3.png)
+
+### 任务详情与子步骤
+
+![任务详情与子步骤](./assets/marketplace/task-editor-0.1.3.png)
+
+### 工作区标签页与分屏
+
+![工作区标签页与分屏](./assets/marketplace/workspace-split-0.1.3.png)
 
 ---
 
 ## 环境要求
 
-- **Paseo 宿主**：`>= 0.8.0`（声明于 `paseo-plugin.json`），由 Paseo 运行插件。
+- **Paseo 宿主**：`>= 0.11.4`（声明于 `paseo-plugin.json`），由 Paseo 运行插件。
+- **GitHub 导入（可选）**：在 daemon 所在机器安装 Git 与 GitHub CLI（`gh`），执行 `gh auth login`，并将项目仓库的 `origin` 配置为 GitHub.com 仓库；支持公开及有权访问的私有仓库。
 - **开发与 CI**：使用 Node.js 24（声明于 `.nvmrc` 与 `.node-version`）执行质量检查、TypeScript 类型擦除和原生测试。
 
 ---
@@ -91,7 +119,7 @@ npm run check
 
 ## 版本发布
 
-参见 [0.1.4 版本说明](./docs/releases/0.1.4.md)。每版 npm 包与 GitHub Release 对应同一个版本 tag，GitHub 附带经过验证的 npm tarball。`main` 可能包含最新发布版之后的改动。
+参见 [更新日志 (CHANGELOG)](./CHANGELOG.md)。每版 npm 包与 GitHub Release 对应同一个版本 tag，GitHub 附带经过验证的 npm tarball。`main` 可能包含最新发布版之后的改动。
 
 ---