paseo-kanban 0.1.3 → 0.1.4

package/OVERVIEW.md

@@ -1,9 +1,35 @@
 # Kanban
 
-Organize tasks in customizable swimlanes, add descriptions and subtasks, and link tasks to Paseo projects. Drag cards to reorder them within a lane or move them between lanes.
+A lightweight, responsive Kanban board plugin for Paseo workspaces.
 
-Open the board from the sidebar or from a workspace's `+` menu. Workspace tabs initially filter to their project's tasks and can sit beside an agent or terminal using Paseo's native split controls. Each open board has its own project filter; all boards on the same host share tasks and lanes.
+## Features
 
-Board data is stored in Paseo's host-scoped plugin settings. Concurrent edits use revision checks so a stale edit cannot overwrite a newer board. If a project's name cannot be read, its stored ID remains available. If workspace project context is unavailable when the board opens, it initially shows all tasks.
+- **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.
+- **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.
+- **Smooth drag and drop**: Support intra-lane reordering and cross-lane movement.
 
-Requires Paseo 0.8.0 or later. No accounts, tokens, or additional setup are required.
+## 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.
+
+---
+
+# 看板 (Kanban)
+
+专为 Paseo 工作区打造的轻量响应式看板插件。
+
+## 核心功能
+
+- **灵活的泳道管理**：支持泳道增删与改名。
+- **丰富的任务卡片**：支持任务标题与多行描述编辑、子步骤清单管理，以及关联 Paseo 项目。
+- **任务完成与恢复**：通过卡片勾选或拖入完成泳道标记完成；取消勾选或拖出即可恢复。
+- **工作区标签页与分屏**：支持通过 Paseo 原生分屏控件与 Agent、Terminal 并排打开，默认筛选工作区所属项目，或使用侧边栏入口。
+- **流畅拖拽交互**：支持同泳道排序与跨泳道状态流转。
+
+## 存储与要求
+
+- **数据与隐私**：看板数据保存在宿主本地插件设置中，具备版本并发冲突保护（CAS）。无需账号、Token 或任何外部网络请求。
+- **宿主要求**：Paseo 0.8.0 或更高版本。

package/README.md

@@ -2,21 +2,19 @@
 
 [简体中文](./README.zh-CN.md)
 
-A lightweight, responsive Kanban board plugin for [Paseo](https://paseo.sh) workspaces. Organize tasks across customizable swimlanes, break them down into subtasks, associate cards with native Paseo projects, and manage workflow status with intuitive drag-and-drop.
+A lightweight, responsive Kanban board plugin for [Paseo](https://paseo.sh) workspaces.
 
 ---
 
 ## Features
 
-- **Flexible Swimlanes**: Three initial lanes that you can rename, with support for adding and deleting custom lanes.
+- **Flexible Swimlanes**: Add, delete, and rename lanes.
 - **Rich Task Cards**:
-  - Task title and multi-line description.
-  - Subtasks checklist with completion toggles and live progress tracking.
-  - Native Paseo project association.
-- **Workspace Tabs and Splits**: Open the board beside an agent or terminal, initially filtered to the workspace's project. The sidebar remains available.
-- **Project Filtering**: Instantly filter board cards by linked Paseo project to keep context focused.
-- **Smooth Drag-and-Drop**: Real-time hit-testing for reordering cards within lanes and moving cards across lanes.
-- **Versioned State Persistence**: Persists board data through Paseo's settings API with optimistic concurrency control (CAS) to prevent race conditions and accidental overwrites.
+  - 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.
 
 ---
 
@@ -57,12 +55,10 @@ Verify that the plugin is running:
 paseo plugin ls
 ```
 
-Once active, open the board from either entry:
+Open the board from either entry:
 
 - **Sidebar → Kanban**: shows all tasks by default.
-- **Workspace → `+` → Kanban**: initially filters to the workspace's project, with other filters available. Use Paseo's native split controls to place it beside an agent or terminal.
-
-Both entries share tasks and lanes with full editing support; their filters are independent. Closing and reopening the board or restarting restores the entry's default filter. If workspace project context is unavailable, the board silently shows all tasks and keeps that filter even if context arrives later. Narrow splits retain horizontal lane scrolling.
+- **Workspace → `+` → Kanban**: initially filters to the workspace's project, with other filters available; use Paseo's native split controls to place it beside an agent or terminal.
 
 ### Local Development
 
@@ -95,13 +91,13 @@ Individual commands (`npm test`, `npm run typecheck`, `npm run lint`, `npm run f
 
 ## Releases
 
-See the [0.1.3 release notes](./docs/releases/0.1.3.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 [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.
 
 ---
 
 ## Architecture & Design
 
-Core terminology and design decisions are documented in [`CONTEXT.md`](./CONTEXT.md) and [`docs/adr/`](./docs/adr/).
+Core terminology and design decisions are documented in [`GLOSSARY.md`](./GLOSSARY.md) and [`docs/adr/`](./docs/adr/).
 
 ---
 

package/README.zh-CN.md

@@ -2,21 +2,19 @@
 
 [English](./README.md)
 
-专为 [Paseo](https://paseo.sh) 工作区打造的轻量响应式看板插件。支持自定义泳道分类、任务子步骤细化、原生 Paseo 项目关联筛选，以及跨泳道流畅拖拽管理。
+专为 [Paseo](https://paseo.sh) 工作区打造的轻量响应式看板插件。
 
 ---
 
 ## 核心功能
 
-- **灵活的泳道管理**：开箱即用三列基础泳道（`待规划`、`执行中`、`已完成`），支持自由添加、重命名与删除自定义泳道。
+- **灵活的泳道管理**：支持泳道增删与改名。
 - **丰富的任务卡片**：
   - 任务标题与多行描述编辑。
-  - 子步骤清单支持独立增删改、完成状态勾选及实时进度展示。
-  - 支持关联本地已有的 Paseo 项目。
-- **工作区标签页与分屏**：与 Agent、Terminal 并排打开看板，默认筛选工作区所属项目；保留侧边栏入口。
-- **项目维度筛选**：一键按关联的 Paseo 项目过滤看板卡片，聚焦当前目标。
-- **流畅拖拽交互**：精准的拖拽命中测试（Hit-Testing），支持同泳道排序与跨泳道状态流转。
-- **版本化数据持久化**：通过 Paseo settings API 存储看板，使用乐观并发版本控制（CAS）处理多会话写入冲突。
+  - 子步骤清单。
+  - 支持关联 Paseo 中创建的项目。
+- **工作区标签页与分屏**：与 Agent、Terminal 并排打开看板，默认筛选工作区所属项目；或使用侧边栏入口。
+- **流畅拖拽交互**：支持同泳道排序与跨泳道状态流转。
 
 ---
 
@@ -57,13 +55,11 @@ paseo plugin add breathi3552/paseo-kanban --ref main
 paseo plugin ls
 ```
 
-状态显示为 `running` 后，可从两个入口打开看板：
+可从两个入口打开看板：
 
 - **侧边栏 → 看板**：默认展示全部任务。
 - **工作区 → `+` → 看板**：默认筛选工作区所属项目，可切换范围；使用 Paseo 原生分屏操作与 Agent、Terminal 等并排显示。
 
-两个入口共享任务和泳道，保留完整编辑能力，筛选互不影响。关闭重开或重启后恢复入口默认筛选。无法取得工作区所属项目时静默展示全部任务，本次打开期间不因项目上下文恢复而自动切换。窄分屏保持横向滚动浏览泳道。
-
 ### 本地开发与调试
 
 如需进行本地源码调试或二次开发：
@@ -95,13 +91,13 @@ npm run check
 
 ## 版本发布
 
-参见 [0.1.3 版本说明](./docs/releases/0.1.3.md)。每版 npm 包与 GitHub Release 对应同一个版本 tag，GitHub 附带经过验证的 npm tarball。`main` 可能包含最新发布版之后的改动。
+参见 [0.1.4 版本说明](./docs/releases/0.1.4.md)。每版 npm 包与 GitHub Release 对应同一个版本 tag，GitHub 附带经过验证的 npm tarball。`main` 可能包含最新发布版之后的改动。
 
 ---
 
 ## 架构设计
 
-核心术语和架构决策见 [`CONTEXT.md`](./CONTEXT.md) 与 [`docs/adr/`](./docs/adr/)。
+核心术语和架构决策见 [`GLOSSARY.md`](./GLOSSARY.md) 与 [`docs/adr/`](./docs/adr/)。
 
 ---
 

package/client/i18n.tsx

@@ -1,7 +1,11 @@
-import { useState, useEffect, useMemo } from "react";
+import { useState, useEffect, useMemo, createContext, useContext } from "react";
 
 export type SupportedLanguage = "zh" | "en";
 
+export const I18nLanguageContext = createContext<SupportedLanguage | null>(
+  null,
+);
+
 export type TranslationParams = Record<
   string,
   string | number | boolean | null | undefined
@@ -9,6 +13,19 @@ export type TranslationParams = Record<
 
 export const translations = {
   zh: {
+    "notification.taskCreated": "任务已创建",
+    "notification.taskUpdated": "任务已更新",
+    "notification.taskDeleted": "任务已删除",
+    "notification.laneCreated": "泳道已创建",
+    "notification.laneRenamed": "泳道已重命名",
+    "notification.laneDeleted": "泳道已删除",
+    "notification.taskSaveFailed": "任务保存失败，草稿已保留，请核实最新数据。",
+    "notification.taskDeleteFailed": "任务删除失败，请核实最新数据。",
+    "notification.laneSaveFailed": "泳道保存失败，草稿已保留，请核实最新数据。",
+    "notification.laneDeleteFailed": "泳道删除失败，请核实最新数据。",
+    "notification.taskReorderFailed": "任务移动失败，请刷新最新数据后重试。",
+    "notification.taskCompletionFailed":
+      "任务完成状态保存失败，请核实最新状态。",
     "kanban.sidebarTitle": "看板",
     "kanban.title": "任务看板",
     "kanban.loading": "正在加载看板数据...",
@@ -31,13 +48,18 @@ export const translations = {
     "lane.add": "+ 添加",
     "lane.manage": "管理",
     "lane.emptyHint": "暂无卡片，可点击右上角添加或拖动卡片至此",
+    "lane.emptyCompletionHint": "暂无已完成任务，可勾选任务或将卡片拖入此泳道",
+    "card.completeTask": "完成任务：{title}",
+    "card.reopenTask": "取消完成：{title}",
     "card.dragHandle": "拖动手柄",
     "card.subtasksCount": "子步骤 {completed}/{total}",
     "laneModal.titleEdit": "管理泳道",
     "laneModal.titleCreate": "新增泳道",
     "laneModal.nameLabel": "泳道名称 *",
     "laneModal.namePlaceholder": "例如：待测试、发布中...",
-    "laneModal.cannotDeleteLast": "看板必须至少保留一条泳道，无法删除此泳道。",
+    "laneModal.cannotDeleteLast":
+      "看板必须至少保留一条普通泳道，无法删除此泳道。",
+    "laneModal.cannotDeleteCompletion": "完成泳道不可删除，可以修改名称。",
     "laneModal.cannotDeleteHasTasks":
       "此泳道当前包含 {count} 个任务，需清空或移走任务后方可删除。",
     "laneModal.deleteLane": "删除此泳道",
@@ -69,6 +91,24 @@ export const translations = {
     "taskModal.submitCreate": "创建",
   },
   en: {
+    "notification.taskCreated": "Task created",
+    "notification.taskUpdated": "Task updated",
+    "notification.taskDeleted": "Task deleted",
+    "notification.laneCreated": "Lane created",
+    "notification.laneRenamed": "Lane renamed",
+    "notification.laneDeleted": "Lane deleted",
+    "notification.taskSaveFailed":
+      "Task save failed. Draft preserved; check the latest data.",
+    "notification.taskDeleteFailed":
+      "Task deletion failed. Check the latest data.",
+    "notification.laneSaveFailed":
+      "Lane save failed. Draft preserved; check the latest data.",
+    "notification.laneDeleteFailed":
+      "Lane deletion failed. Check the latest data.",
+    "notification.taskReorderFailed":
+      "Task move failed. Refresh the latest data and try again.",
+    "notification.taskCompletionFailed":
+      "Task completion change failed. Check the latest state.",
     "kanban.sidebarTitle": "Kanban",
     "kanban.title": "Task Kanban",
     "kanban.loading": "Loading kanban board data...",
@@ -92,6 +132,10 @@ export const translations = {
     "lane.manage": "Manage",
     "lane.emptyHint":
       "No cards yet. Click '+' in the top right or drag cards here.",
+    "lane.emptyCompletionHint":
+      "No completed tasks. Check a task or drag it into this lane.",
+    "card.completeTask": "Mark {title} complete",
+    "card.reopenTask": "Mark {title} incomplete",
     "card.dragHandle": "Drag handle",
     "card.subtasksCount": "Subtasks {completed}/{total}",
     "laneModal.titleEdit": "Manage Lane",
@@ -99,7 +143,9 @@ export const translations = {
     "laneModal.nameLabel": "Lane Name *",
     "laneModal.namePlaceholder": "e.g., Testing, In Review...",
     "laneModal.cannotDeleteLast":
-      "A kanban board must retain at least one lane. Cannot delete this lane.",
+      "A kanban board must retain at least one ordinary lane. Cannot delete this lane.",
+    "laneModal.cannotDeleteCompletion":
+      "The completion lane cannot be deleted. You can rename it.",
     "laneModal.cannotDeleteHasTasks":
       "This lane currently contains {count} tasks. Clear or move tasks before deleting.",
     "laneModal.deleteLane": "Delete Lane",
@@ -172,6 +218,7 @@ interface EnvironmentGlobals {
   };
   navigator?: {
     language?: string;
+    languages?: readonly string[];
   };
   window?: {
     addEventListener(
@@ -214,6 +261,12 @@ export function detectPaseoLanguage(
     } catch {}
   }
 
+  // Match Paseo's web system-language source before page/Intl defaults.
+  const navLocale = env.navigator?.languages?.[0] || env.navigator?.language;
+  if (navLocale) {
+    return normalizeLanguage(navLocale);
+  }
+
   const docLang = env.document?.documentElement?.lang;
   if (docLang) {
     return normalizeLanguage(docLang);
@@ -232,11 +285,6 @@ export function detectPaseoLanguage(
     return normalizeLanguage(intlLocale);
   }
 
-  const navLocale = env.navigator?.language;
-  if (navLocale) {
-    return normalizeLanguage(navLocale);
-  }
-
   return "en";
 }
 
@@ -323,6 +371,7 @@ export interface I18nContextValue {
 }
 
 export function useI18n(hostProps?: DetectLanguageOptions): I18nContextValue {
+  const inheritedLanguage = useContext(I18nLanguageContext);
   const hostLocale =
     hostProps?.locale ??
     hostProps?.language ??
@@ -341,14 +390,15 @@ export function useI18n(hostProps?: DetectLanguageOptions): I18nContextValue {
     });
   }, [hostLocale, hostProps]);
 
+  const language = hostLocale ? lang : (inheritedLanguage ?? lang);
   const tBound = useMemo(
     () => (key: TranslationKey, params?: TranslationParams) =>
-      t(key, lang, params),
-    [lang],
+      t(key, language, params),
+    [language],
   );
 
   return {
-    language: lang,
+    language,
     t: tBound,
   };
 }

package/client/kanban-board.tsx

@@ -1,4 +1,4 @@
-import { useState, useMemo } from "react";
+import { useState, useMemo, useRef } from "react";
 import {
   View,
   Text,
@@ -9,8 +9,9 @@ import {
   type LayoutChangeEvent,
 } from "react-native";
 import { useSettings } from "@getpaseo/plugin/client";
+import { useToast } from "@getpaseo/plugin/client/react-native";
 import type { PluginSurfaceProps } from "@getpaseo/plugin/client";
-import { kanbanSettings, filterTasksByProject } from "../shared/kanban";
+import { kanbanSettings, getLaneTasks } from "../shared/kanban";
 import { useProjects } from "./use-projects";
 import { TaskModal } from "./task-modal";
 import { LaneModal } from "./lane-modal";
@@ -21,16 +22,26 @@ import {
   openTaskSession,
   openLaneSession,
   executeTaskReorder,
+  executeTaskCompletion,
   type TaskEditSession,
   type LaneEditSession,
 } from "./kanban-session";
-import { useI18n } from "./i18n";
+import { useI18n, I18nLanguageContext } from "./i18n";
 
 interface KanbanBoardProps extends PluginSurfaceProps {
   initialProjectId?: string | null;
 }
 
 export function KanbanBoardView(props: KanbanBoardProps) {
+  const { language } = useI18n(props);
+  return (
+    <I18nLanguageContext.Provider value={language}>
+      <KanbanBoardContent {...props} />
+    </I18nLanguageContext.Provider>
+  );
+}
+
+function KanbanBoardContent(props: KanbanBoardProps) {
   const { theme } = props;
   const [panelWidth, setPanelWidth] = useState<number | null>(null);
   const compact =
@@ -43,8 +54,9 @@ export function KanbanBoardView(props: KanbanBoardProps) {
     const { width } = event.nativeEvent.layout;
     if (width > 0) setPanelWidth(width);
   };
-  const { t, language } = useI18n(props);
+  const { t, language } = useI18n();
   const settings = useSettings(kanbanSettings);
+  const toast = useToast();
   const {
     projects,
     resolveProjectName,
@@ -58,7 +70,11 @@ export function KanbanBoardView(props: KanbanBoardProps) {
     useState<TaskEditSession | null>(null);
   const [activeLaneSession, setActiveLaneSession] =
     useState<LaneEditSession | null>(null);
-  const [reorderError, setReorderError] = useState<string | null>(null);
+  const [taskOperationError, setTaskOperationError] = useState<string | null>(
+    null,
+  );
+  const [completionPending, setCompletionPending] = useState(false);
+  const completionPendingRef = useRef(false);
 
   const selectableProjects = useMemo(() => {
     const missingIds = new Set([props.initialProjectId, selectedProjectId]);
@@ -78,18 +94,12 @@ export function KanbanBoardView(props: KanbanBoardProps) {
   const board = isReady ? settings.values : null;
   const revision = isReady ? settings.revision : "";
 
-  // Filter tasks based on selected project
-  const filteredTasks = useMemo(() => {
-    if (!board) return [];
-    return filterTasksByProject(board.tasks, selectedProjectId);
-  }, [board, selectedProjectId]);
-
   const handleReorderTask = async (
     taskId: string,
     targetLaneId: string,
     targetIndex: number,
   ) => {
-    if (!board) return;
+    if (!board || completionPendingRef.current) return;
     const result = await executeTaskReorder({
       baseBoard: board,
       baseRevision: revision,
@@ -101,9 +111,10 @@ export function KanbanBoardView(props: KanbanBoardProps) {
       language,
     });
     if (!result.success) {
-      setReorderError(result.error);
+      setTaskOperationError(result.error);
+      toast.error(t("notification.taskReorderFailed"));
     } else {
-      setReorderError(null);
+      setTaskOperationError(null);
     }
   };
 
@@ -122,8 +133,29 @@ export function KanbanBoardView(props: KanbanBoardProps) {
     getTaskPreview,
   });
 
+  const handleSetCompleted = async (taskId: string, completed: boolean) => {
+    if (!board || completionPendingRef.current || drag.isDragLocked()) return;
+    completionPendingRef.current = true;
+    setCompletionPending(true);
+    try {
+      const result = await executeTaskCompletion({
+        baseBoard: board,
+        baseRevision: revision,
+        taskId,
+        completed,
+        save: (next, expectedRevision) => settings.save(next, expectedRevision),
+        language,
+      });
+      setTaskOperationError(result.success ? null : result.error);
+      if (!result.success) toast.error(t("notification.taskCompletionFailed"));
+    } finally {
+      completionPendingRef.current = false;
+      setCompletionPending(false);
+    }
+  };
+
   const openNewTask = (defaultLaneId?: string) => {
-    if (drag.isDragLocked() || !board) return;
+    if (completionPendingRef.current || drag.isDragLocked() || !board) return;
     setActiveTaskSession(
       openTaskSession({
         mode: "create",
@@ -141,7 +173,7 @@ export function KanbanBoardView(props: KanbanBoardProps) {
   };
 
   const openEditTask = (taskId: string) => {
-    if (drag.isDragLocked() || !board) return;
+    if (completionPendingRef.current || drag.isDragLocked() || !board) return;
     setActiveTaskSession(
       openTaskSession({
         mode: "edit",
@@ -155,7 +187,7 @@ export function KanbanBoardView(props: KanbanBoardProps) {
   };
 
   const openNewLane = () => {
-    if (drag.isDragLocked() || !board) return;
+    if (completionPendingRef.current || drag.isDragLocked() || !board) return;
     setActiveLaneSession(
       openLaneSession({
         mode: "create",
@@ -168,7 +200,7 @@ export function KanbanBoardView(props: KanbanBoardProps) {
   };
 
   const openEditLane = (laneId: string) => {
-    if (drag.isDragLocked() || !board) return;
+    if (completionPendingRef.current || drag.isDragLocked() || !board) return;
     setActiveLaneSession(
       openLaneSession({
         mode: "edit",
@@ -544,16 +576,16 @@ export function KanbanBoardView(props: KanbanBoardProps) {
       </View>
 
       {/* Conflict / Save Error Notification */}
-      {(settings.saveError || reorderError) && (
+      {(settings.saveError || taskOperationError) && (
         <View style={styles.conflictBanner}>
           <Text style={styles.conflictText}>
-            {reorderError
-              ? t("kanban.saveFailed", { error: reorderError })
+            {taskOperationError
+              ? t("kanban.saveFailed", { error: taskOperationError })
               : t("kanban.conflictError", { error: settings.saveError })}
           </Text>
           <Pressable
             onPress={() => {
-              setReorderError(null);
+              setTaskOperationError(null);
               settings.reload();
             }}
             style={styles.conflictAction}
@@ -579,7 +611,7 @@ export function KanbanBoardView(props: KanbanBoardProps) {
           scrollEventThrottle={16}
         >
           {board.lanes.map((lane) => {
-            const laneTasks = filteredTasks.filter((t) => t.laneId === lane.id);
+            const laneTasks = getLaneTasks(board, lane.id, selectedProjectId);
             return (
               <KanbanLaneView
                 key={lane.id}
@@ -593,6 +625,8 @@ export function KanbanBoardView(props: KanbanBoardProps) {
                 onAddTask={(laneId) => openNewTask(laneId)}
                 onManageLane={(laneId) => openEditLane(laneId)}
                 onSelectTask={(task) => openEditTask(task.id)}
+                onSetCompleted={handleSetCompleted}
+                completionPending={completionPending}
               />
             );
           })}