team-toon-tack 2.3.4 → 3.0.0

package/.claude-plugin/marketplace.json

@@ -5,15 +5,15 @@
 		"email": "wayne930242@gmail.com"
 	},
 	"metadata": {
-		"description": "Linear task management tools for Claude Code - efficient workflow without MCP overhead",
+		"description": "Task management tools for Claude Code - supports Linear and Trello, efficient workflow without MCP overhead",
 		"version": "1.0.0"
 	},
 	"plugins": [
 		{
 			"name": "team-toon-tack",
 			"source": "./",
-			"description": "Linear task sync & management CLI with commands and skills",
-			"version": "2.3.2"
+			"description": "Linear/Trello task sync & management CLI with commands and skills",
+			"version": "2.4.0"
 		}
 	]
 }

package/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
 	"name": "team-toon-tack",
-	"description": "Linear task sync & management CLI for Claude Code - saves tokens vs MCP",
-	"version": "2.3.2",
+	"description": "Linear/Trello task sync & management CLI for Claude Code - saves tokens vs MCP",
+	"version": "2.4.0",
 	"author": {
 		"name": "wayne930242",
 		"email": "wayne930242@gmail.com"
@@ -11,6 +11,7 @@
 	"keywords": [
 		"claude-code",
 		"linear",
+		"trello",
 		"task-management",
 		"workflow",
 		"productivity"

package/README.md

@@ -2,21 +2,21 @@
 
 [繁體中文](./README.zh-TW.md) | English
 
-Optimized Linear workflow for Claude Code — saves significant tokens compared to MCP.
+Optimized task workflow for Claude Code — supports Linear and Trello, saves significant tokens compared to MCP.
 
 ## Features
 
-- **Token Efficient** — Local cycle cache eliminates repeated API calls, saving significant tokens vs Linear MCP
+- **Token Efficient** — Local cycle cache eliminates repeated API calls, saving significant tokens vs MCP
+- **Multi-source Support** — Works with both Linear and Trello
 - **Smart Task Selection** — Auto-pick highest priority unassigned work with `/work-on next`
-- **Multi-team Support** — Sync and filter issues across multiple teams
-- **Flexible Sync Modes** — Choose between remote (immediate Linear sync) or local (offline-first, sync later with `--update`)
-- **Completion Modes** — Four modes for task completion: simple, strict review, upstream strict, upstream not strict
-- **QA Team Support** — Auto-update parent issues in QA team to "Testing" when completing dev tasks
-- **Attachment Download** — Auto-download Linear images and files to local `.ttt/output/` for AI vision analysis
+- **Multi-team Support** — Sync and filter issues across multiple teams/boards
+- **Flexible Sync Modes** — Choose between remote (immediate sync) or local (offline-first, sync later with `--update`)
+- **Completion Modes** — Four modes for task completion (Linear): simple, strict review, upstream strict, upstream not strict
+- **QA Team Support** — Auto-update parent issues in QA team to "Testing" when completing dev tasks (Linear)
+- **Attachment Download** — Auto-download images and files to local `.ttt/output/` for AI vision analysis
 - **Blocked Status** — Set tasks as blocked when waiting on external dependencies
 - **Claude Code Plugin** — Install plugin for `/ttt:*` commands and auto-activated skills
 - **Cycle History** — Local `.toon` files preserve cycle data for AI context
-- **User Filtering** — Only see issues assigned to you or unassigned
 
 ## Quick Start
 
@@ -24,20 +24,34 @@ Optimized Linear workflow for Claude Code — saves significant tokens compared
 
 ```bash
 npm install -g team-toon-tack
+
+# For Linear
 export LINEAR_API_KEY="lin_api_xxxxx"
 
+# For Trello
+export TRELLO_API_KEY="your-api-key"
+export TRELLO_TOKEN="your-token"
+
 cd your-project
 ttt init
 ```
 
-During init, you'll configure:
+During init, you'll be prompted to select your task source (Linear or Trello) and configure:
+
+**For Linear:**
 - **Dev team**: Your development team (single selection)
 - **Dev testing status**: Testing/review status for your dev team (optional)
 - **QA team(s)**: For cross-team parent issue updates, each with its own testing status (optional)
 - **Completion mode**: How task completion is handled (see below)
 - **Status source**: `remote` (update Linear immediately) or `local` (work offline, sync with `ttt sync --update`)
 
-### Completion Modes
+**For Trello:**
+- **Board**: The Trello board to sync
+- **User**: Your Trello username
+- **Status mappings**: Map Trello lists to Todo/In Progress/Done
+- **Label filter**: Optional label to filter cards
+
+### Completion Modes (Linear only)
 
 | Mode | Behavior |
 |------|----------|
@@ -46,6 +60,8 @@ During init, you'll configure:
 | `upstream_strict` | Mark task as Done + parent to Testing. Falls back to dev testing if no parent. Default when QA team configured. |
 | `upstream_not_strict` | Mark task as Done + parent to Testing. No fallback if no parent. |
 
+> **Note:** Trello always uses simple completion mode as it doesn't support parent issues.
+
 ### 2. Install Claude Code Plugin (Optional)
 
 ```
@@ -58,7 +74,7 @@ During init, you'll configure:
 In Claude Code (with plugin installed):
 
 ```
-/ttt:sync              # Fetch all Linear issues for current cycle
+/ttt:sync              # Fetch all issues/cards for current cycle
 /ttt:work-on next      # Pick highest priority task & start working
 /ttt:done              # Complete task with AI-generated summary
 ```
@@ -80,7 +96,9 @@ ttt done -m "Completed the task"
 Initialize configuration in current directory.
 
 ```bash
-ttt init                           # Interactive mode
+ttt init                           # Interactive mode (select source)
+ttt init --source=linear           # Initialize for Linear
+ttt init --source=trello           # Initialize for Trello
 ttt init --user alice@example.com  # Pre-select user
 ttt init --label Frontend          # Set default label
 ttt init --force                   # Overwrite existing config
@@ -88,12 +106,13 @@ ttt init --force                   # Overwrite existing config
 
 ### `ttt sync`
 
-Sync current cycle issues from Linear.
+Sync current cycle issues from Linear/Trello.
 
 ```bash
-ttt sync              # Sync all matching issues
+ttt sync              # Sync Todo/In Progress issues (fast)
+ttt sync --all        # Sync all issues regardless of status
 ttt sync MP-123       # Sync specific issue only
-ttt sync --update     # Push local status changes to Linear (for local mode)
+ttt sync --update     # Push local status changes to remote (for local mode)
 ```
 
 ### `ttt work-on`
@@ -111,11 +130,14 @@ ttt work-on next         # Auto-select highest priority
 Mark task as completed.
 
 ```bash
-ttt done                    # Auto-select if only one in-progress
-ttt done MP-123             # Specific issue
-ttt done -m "Fixed the bug" # With completion message
+ttt done                         # Auto-select if only one in-progress
+ttt done MP-123                  # Specific issue
+ttt done -m "Fixed the bug"      # With completion message
+ttt done MP-123 --from-remote    # Fetch from remote (bypasses local data check)
 ```
 
+Use `--from-remote` (or `-r`) when the issue exists in remote but not in local sync data.
+
 ### `ttt status`
 
 Show or modify task status.
@@ -135,7 +157,7 @@ Show issue details or search issues from local cycle data.
 ```bash
 ttt show                       # Show all issues in local cycle data
 ttt show MP-123                # Show specific issue from local data
-ttt show MP-123 --remote       # Fetch specific issue from Linear
+ttt show MP-123 --remote       # Fetch specific issue from remote
 ttt show --label frontend      # Filter by label
 ttt show --status "In Progress" --user me   # My in-progress issues
 ttt show --priority 1          # Show urgent issues
@@ -170,9 +192,28 @@ your-project/
 
 | Variable | Description |
 |----------|-------------|
-| `LINEAR_API_KEY` | **Required.** Your Linear API key |
+| `LINEAR_API_KEY` | **Required for Linear.** Your Linear API key |
+| `TRELLO_API_KEY` | **Required for Trello.** Your Trello API key |
+| `TRELLO_TOKEN` | **Required for Trello.** Your Trello authorization token |
 | `TOON_DIR` | Config directory (default: `.ttt`) |
 
+### Trello Setup
+
+1. Get your API key from: https://trello.com/power-ups/admin
+2. Generate a token by visiting the authorization URL shown during `ttt init`
+3. Set both `TRELLO_API_KEY` and `TRELLO_TOKEN` in your environment
+
+### Concept Mapping: Linear vs Trello
+
+| Concept | Linear | Trello |
+|---------|--------|--------|
+| Container | Team | Board |
+| Task | Issue | Card |
+| Status | Workflow State | List |
+| Tag | Label | Label |
+| Sprint | Cycle | - (not supported) |
+| Parent | Parent Issue | - (not supported) |
+
 ## Claude Code Plugin
 
 Install the plugin for Claude Code integration:
@@ -186,7 +227,7 @@ Install the plugin for Claude Code integration:
 
 | Command | Description |
 |---------|-------------|
-| `/ttt:sync` | Sync Linear issues to local cycle data |
+| `/ttt:sync` | Sync issues to local cycle data |
 | `/ttt:work-on` | Start working on a task |
 | `/ttt:done` | Mark current task as completed |
 | `/ttt:status` | Show or modify task status |
@@ -194,7 +235,7 @@ Install the plugin for Claude Code integration:
 
 ### Auto-Activated Skill
 
-The plugin includes a `linear-task-manager` skill that automatically activates when working with Linear tasks, providing workflow guidance and best practices.
+The plugin includes a `linear-task-manager` skill that automatically activates when working with tasks, providing workflow guidance and best practices.
 
 ## License
 

package/README.zh-TW.md

@@ -2,21 +2,21 @@
 
 繁體中文 | [English](./README.md)
 
-為 Claude Code 最佳化的 Linear 工作流 — 比 MCP 節省大量 token。
+為 Claude Code 最佳化的任務工作流 — 支援 Linear 和 Trello，比 MCP 節省大量 token。
 
 ## 特色功能
 
-- **節省 Token** — 本地 cycle 快取避免重複 API 呼叫，比 Linear MCP 省下大量 token
+- **節省 Token** — 本地 cycle 快取避免重複 API 呼叫，比 MCP 省下大量 token
+- **多來源支援** — 支援 Linear 和 Trello
 - **智慧任務挑選** — `/work-on next` 自動選擇最高優先級的未指派工作
-- **多團隊支援** — 跨多個團隊同步與過濾 issue
-- **彈性同步模式** — 選擇 remote（即時同步 Linear）或 local（離線優先，稍後用 `--update` 同步）
-- **完成模式** — 四種任務完成模式：簡單、嚴格審查、上下游嚴格、上下游非嚴格
-- **QA 團隊支援** — 完成開發任務時自動將 QA 團隊的 parent issue 更新為「Testing」
-- **附件下載** — 自動下載 Linear 圖片和檔案到本地 `.ttt/output/`，供 AI 視覺分析
+- **多團隊支援** — 跨多個團隊/看板同步與過濾 issue
+- **彈性同步模式** — 選擇 remote（即時同步）或 local（離線優先，稍後用 `--update` 同步）
+- **完成模式** — 四種任務完成模式（Linear）：簡單、嚴格審查、上下游嚴格、上下游非嚴格
+- **QA 團隊支援** — 完成開發任務時自動將 QA 團隊的 parent issue 更新為「Testing」（Linear）
+- **附件下載** — 自動下載圖片和檔案到本地 `.ttt/output/`，供 AI 視覺分析
 - **阻塞狀態** — 等待外部依賴時可設定任務為 blocked
 - **Claude Code Plugin** — 安裝 plugin 即可使用 `/ttt:*` 指令和自動啟用的技能
 - **Cycle 歷史保存** — 本地 `.toon` 檔案保留 cycle 資料，方便 AI 檢閱
-- **使用者過濾** — 只顯示指派給你或未指派的工作
 
 ## 快速開始
 
@@ -24,20 +24,34 @@
 
 ```bash
 npm install -g team-toon-tack
+
+# Linear 用
 export LINEAR_API_KEY="lin_api_xxxxx"
 
+# Trello 用
+export TRELLO_API_KEY="your-api-key"
+export TRELLO_TOKEN="your-token"
+
 cd your-project
 ttt init
 ```
 
-初始化時會設定：
+初始化時會提示選擇任務來源（Linear 或 Trello），然後設定：
+
+**Linear：**
 - **開發團隊**：你的開發團隊（單選）
 - **開發團隊測試狀態**：開發團隊的 testing/review 狀態（可選）
 - **QA 團隊**：跨團隊 parent issue 更新，各自設定 testing 狀態（可選）
 - **完成模式**：任務完成時的處理方式（見下方說明）
 - **狀態來源**：`remote`（即時更新 Linear）或 `local`（離線工作，用 `ttt sync --update` 同步）
 
-### 完成模式
+**Trello：**
+- **看板**：要同步的 Trello 看板
+- **使用者**：你的 Trello 使用者名稱
+- **狀態映射**：將 Trello 列表映射到 Todo/In Progress/Done
+- **標籤過濾**：可選的卡片過濾標籤
+
+### 完成模式（僅 Linear）
 
 | 模式 | 行為 |
 |------|------|
@@ -46,6 +60,8 @@ ttt init
 | `upstream_strict` | 任務標記為 Done，parent 移動到 Testing。若無 parent，fallback 到開發團隊的 testing 狀態。設定 QA 團隊時的預設值。 |
 | `upstream_not_strict` | 任務標記為 Done，parent 移動到 Testing。若無 parent 不做 fallback。 |
 
+> **注意**：Trello 因不支援 parent issue，一律使用簡單完成模式。
+
 ### 2. 安裝 Claude Code Plugin（選擇性）
 
 ```
@@ -58,7 +74,7 @@ ttt init
 在 Claude Code 中（安裝 plugin 後）：
 
 ```
-/ttt:sync              # 從 Linear 取得當前 cycle 所有 issue
+/ttt:sync              # 取得當前 cycle 所有 issue/card
 /ttt:work-on next      # 挑選最高優先級任務並開始工作
 /ttt:done              # 完成任務，附上 AI 生成的摘要
 ```
@@ -80,7 +96,9 @@ ttt done -m "完成任務"
 在當前目錄初始化配置。
 
 ```bash
-ttt init                           # 互動模式
+ttt init                           # 互動模式（選擇來源）
+ttt init --source=linear           # 初始化 Linear
+ttt init --source=trello           # 初始化 Trello
 ttt init --user alice@example.com  # 預選使用者
 ttt init --label Frontend          # 設定預設標籤
 ttt init --force                   # 覆蓋現有配置
@@ -88,12 +106,13 @@ ttt init --force                   # 覆蓋現有配置
 
 ### `ttt sync`
 
-從 Linear 同步當前 cycle 的 issue。
+從 Linear/Trello 同步當前 cycle 的 issue。
 
 ```bash
-ttt sync              # 同步所有符合條件的 issue
+ttt sync              # 同步 Todo/In Progress 狀態的 issue（較快）
+ttt sync --all        # 同步所有狀態的 issue
 ttt sync MP-123       # 只同步特定 issue
-ttt sync --update     # 將本地狀態推送到 Linear（local 模式用）
+ttt sync --update     # 將本地狀態推送到遠端（local 模式用）
 ```
 
 ### `ttt work-on`
@@ -111,11 +130,14 @@ ttt work-on next         # 自動選擇最高優先級
 標記任務完成。
 
 ```bash
-ttt done                    # 若只有一個進行中，自動選擇
-ttt done MP-123             # 指定 issue
-ttt done -m "修復了錯誤"      # 附上完成說明
+ttt done                         # 若只有一個進行中，自動選擇
+ttt done MP-123                  # 指定 issue
+ttt done -m "修復了錯誤"           # 附上完成說明
+ttt done MP-123 --from-remote    # 從遠端取得（略過本地資料檢查）
 ```
 
+當 issue 存在於遠端但未同步到本地資料時，使用 `--from-remote`（或 `-r`）。
+
 ### `ttt status`
 
 顯示或修改任務狀態。
@@ -135,7 +157,7 @@ ttt status MP-123 --set blocked # 設為阻塞（等待外部依賴）
 ```bash
 ttt show                       # 顯示本地 cycle 資料中的所有 issue
 ttt show MP-123                # 顯示特定 issue（從本地資料）
-ttt show MP-123 --remote       # 從 Linear 取得特定 issue
+ttt show MP-123 --remote       # 從遠端取得特定 issue
 ttt show --label frontend      # 依標籤過濾
 ttt show --status "In Progress" --user me   # 我進行中的 issue
 ttt show --priority 1          # 顯示緊急 issue
@@ -170,9 +192,28 @@ your-project/
 
 | 變數 | 說明 |
 |------|------|
-| `LINEAR_API_KEY` | **必填**。你的 Linear API 金鑰 |
+| `LINEAR_API_KEY` | **Linear 必填**。你的 Linear API 金鑰 |
+| `TRELLO_API_KEY` | **Trello 必填**。你的 Trello API 金鑰 |
+| `TRELLO_TOKEN` | **Trello 必填**。你的 Trello 授權 token |
 | `TOON_DIR` | 配置目錄（預設：`.ttt`） |
 
+### Trello 設定
+
+1. 從 https://trello.com/power-ups/admin 取得 API 金鑰
+2. 在 `ttt init` 時會顯示授權網址，前往取得 token
+3. 在環境變數中設定 `TRELLO_API_KEY` 和 `TRELLO_TOKEN`
+
+### 概念對照：Linear vs Trello
+
+| 概念 | Linear | Trello |
+|------|--------|--------|
+| 容器 | Team | Board（看板）|
+| 任務 | Issue | Card（卡片）|
+| 狀態 | Workflow State | List（列表）|
+| 標籤 | Label | Label |
+| 週期 | Cycle | -（不支援）|
+| 上層 | Parent Issue | -（不支援）|
+
 ## Claude Code Plugin
 
 安裝 plugin 以整合 Claude Code：
@@ -186,7 +227,7 @@ your-project/
 
 | 指令 | 說明 |
 |------|------|
-| `/ttt:sync` | 同步 Linear issue 到本地 |
+| `/ttt:sync` | 同步 issue 到本地 |
 | `/ttt:work-on` | 開始處理任務 |
 | `/ttt:done` | 標記當前任務完成 |
 | `/ttt:status` | 顯示或修改任務狀態 |
@@ -194,7 +235,7 @@ your-project/
 
 ### 自動啟用技能
 
-Plugin 包含 `linear-task-manager` 技能，在處理 Linear 任務時會自動啟用，提供工作流程指導和最佳實踐。
+Plugin 包含 `linear-task-manager` 技能，在處理任務時會自動啟用，提供工作流程指導和最佳實踐。
 
 ## 授權
 

package/dist/scripts/done-job.d.ts

@@ -1 +1,6 @@
+#!/usr/bin/env bun
+/**
+ * ttt done - Complete a task
+ * Entry point that delegates to source-specific completion handlers
+ */
 export {};