team-toon-tack 3.9.3 → 3.10.0

package/.claude-plugin/marketplace.json

@@ -13,7 +13,7 @@
 			"name": "team-toon-tack",
 			"source": "./",
 			"description": "Linear/Trello task sync & management CLI with commands and skills",
-			"version": "3.9.1"
+			"version": "3.10.0"
 		}
 	]
 }

package/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
 	"name": "team-toon-tack",
 	"description": "Linear/Trello task sync & management CLI for Claude Code - saves tokens vs MCP",
-	"version": "3.9.1",
+	"version": "3.10.0",
 	"author": {
 		"name": "wayne930242",
 		"email": "wayne930242@gmail.com"

package/.codex-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
 	"name": "team-toon-tack",
-	"version": "3.9.1",
+	"version": "3.10.0",
 	"description": "透過 ttt CLI 同步與管理 Linear、Trello 任務。",
 	"author": {
 		"name": "wayne930242"

package/README.md

@@ -8,7 +8,7 @@ Optimized task workflow for Claude Code — supports Linear and Trello, saves si
 
 - **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 your highest priority pending task with `/work-on next`
+- **Batch Ticket Claiming** — Claim one or many tickets at once with `ttt claim`, or auto-pick your highest priority pending tasks with `ttt claim next <n>`
 - **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
@@ -99,7 +99,7 @@ In Claude Code (with plugin installed):
 
 ```
 /ttt:sync              # Fetch all issues/cards for current cycle
-/ttt:work-on next      # Pick highest priority task & start working
+/ttt:work-on next      # Claim highest priority ticket & start working
 /ttt:estimate MP-123 6 # Save a local 6-hour estimate
 /ttt:done              # Complete task with AI-generated summary
 ```
@@ -108,7 +108,7 @@ Or using CLI directly:
 
 ```bash
 ttt sync
-ttt work-on next
+ttt claim next
 ttt estimate MP-123 6
 ttt done -m "Completed the task"
 ```
@@ -144,16 +144,23 @@ ttt sync MP-123       # Sync specific issue only
 ttt sync --update     # Push local status changes to remote (for local mode)
 ```
 
-### `ttt work-on`
+### `ttt claim`
 
-Start working on a task.
+Claim ticket(s): move them to in-progress locally and on the remote source.
+Alias: `ttt work-on`.
 
 ```bash
-ttt work-on              # Interactive selection
-ttt work-on MP-123       # Specific issue
-ttt work-on next         # Auto-select highest priority
+ttt claim                  # Interactive multi-select
+ttt claim MP-123           # Claim one ticket
+ttt claim MP-123 MP-124    # Batch claim
+ttt claim next             # Claim highest priority pending task
+ttt claim next 3           # Claim top 3 pending tasks
+ttt claim --dry-run        # Preview without changes
 ```
 
+Completed, in-review, and blocked tickets are reported and skipped without
+stopping the rest of the batch. An unknown ID aborts before anything is claimed.
+
 ### `ttt estimate`
 
 Save a local human-effort estimate that persists in `.ttt/cycle.toon`.
@@ -268,7 +275,7 @@ Install the plugin for Claude Code integration:
 | Command | Description |
 |---------|-------------|
 | `/ttt:sync` | Sync issues to local cycle data |
-| `/ttt:work-on` | Start working on a task |
+| `/ttt:work-on` | Claim ticket(s) and work on them |
 | `/ttt:estimate` | Save a local human-effort estimate |
 | `/ttt:done` | Mark current task as completed |
 | `/ttt:status` | Show or modify task status |

package/README.zh-TW.md

@@ -8,7 +8,7 @@
 
 - **節省 Token** — 本地 cycle 快取避免重複 API 呼叫，比 MCP 省下大量 token
 - **多來源支援** — 支援 Linear 和 Trello
-- **智慧任務挑選** — `/work-on next` 自動選擇指派給你的最高優先級待辦任務
+- **批次領票** — `ttt claim` 可一次領一張或多張票，`ttt claim next <n>` 自動領取最高優先級的待辦任務
 - **多團隊支援** — 跨多個團隊/看板同步與過濾 issue
 - **彈性同步模式** — 選擇 remote（即時同步）或 local（離線優先，稍後用 `--update` 同步）
 - **完成模式** — 四種任務完成模式（Linear）：簡單、嚴格審查、上下游嚴格、上下游非嚴格
@@ -99,7 +99,7 @@ codex plugin add team-toon-tack@ttt-marketplace
 
 ```
 /ttt:sync              # 取得當前 cycle 所有 issue/card
-/ttt:work-on next      # 挑選最高優先級任務並開始工作
+/ttt:work-on next      # 領取最高優先級的票並開始工作
 /ttt:estimate MP-123 6 # 寫入本地 6 小時估時
 /ttt:done              # 完成任務，附上 AI 生成的摘要
 ```
@@ -108,7 +108,7 @@ codex plugin add team-toon-tack@ttt-marketplace
 
 ```bash
 ttt sync
-ttt work-on next
+ttt claim next
 ttt estimate MP-123 6
 ttt done -m "完成任務"
 ```
@@ -144,16 +144,23 @@ ttt sync MP-123       # 只同步特定 issue
 ttt sync --update     # 將本地狀態推送到遠端（local 模式用）
 ```
 
-### `ttt work-on`
+### `ttt claim`
 
-開始處理任務。
+領票：把票在本地與遠端來源改成 in-progress。
+別名：`ttt work-on`。
 
 ```bash
-ttt work-on              # 互動選擇
-ttt work-on MP-123       # 指定 issue
-ttt work-on next         # 自動選擇最高優先級
+ttt claim                  # 互動多選
+ttt claim MP-123           # 領一張票
+ttt claim MP-123 MP-124    # 批次領票
+ttt claim next             # 領最高優先級的待辦任務
+ttt claim next 3           # 領最高優先級的前 3 張票
+ttt claim --dry-run        # 預覽，不改狀態
 ```
 
+已完成、審核中、blocked 的票會逐張回報並跳過，不中斷整批。
+批次中出現不存在的 ID 時，整批在動任何票之前中止。
+
 ### `ttt estimate`
 
 把人類工程工時估算寫進 `.ttt/cycle.toon`，並在之後的同步中保留下來。
@@ -268,7 +275,7 @@ your-project/
 | 指令 | 說明 |
 |------|------|
 | `/ttt:sync` | 同步 issue 到本地 |
-| `/ttt:work-on` | 開始處理任務 |
+| `/ttt:work-on` | 領票並開始處理 |
 | `/ttt:estimate` | 寫入本地人力估時 |
 | `/ttt:done` | 標記當前任務完成 |
 | `/ttt:status` | 顯示或修改任務狀態 |

package/commands/ttt-comment.md

@@ -57,5 +57,5 @@ Report:
 | Error | Solution |
 |-------|----------|
 | `Message is required` | Add `-m "your message"` |
-| `No in-progress task` | Specify issue-id or run `ttt work-on` first |
+| `No in-progress task` | Specify issue-id or run `ttt claim` first |
 | `Issue not found` | Issue doesn't exist in remote either — check the ID |

package/commands/ttt-status.md

@@ -80,5 +80,5 @@ If a `--set` operation is performed, the remote task is added to local cycle dat
 
 | Error | Solution |
 |-------|----------|
-| `No in-progress task` | Specify issue-id or run `ttt work-on` first |
+| `No in-progress task` | Specify issue-id or run `ttt claim` first |
 | `Issue not found` | Issue doesn't exist in remote either — check the ID |

package/commands/ttt-work-on.md

@@ -1,9 +1,9 @@
 ---
 name: ttt:work-on
-description: Start working on a Linear task
+description: Claim Linear/Trello ticket(s) and work on them
 arguments:
-  - name: issue-id
-    description: "Issue ID (e.g., MP-624) or 'next' for auto-select. Defaults to 'next'."
+  - name: issue-ids
+    description: "One or more issue IDs (e.g., MP-624 MP-625), or 'next' / 'next <n>' for auto-select. Defaults to 'next'."
     required: false
   - name: dry-run
     description: Preview selection without changing status
@@ -11,45 +11,59 @@ arguments:
 ---
 
 <law>
-YOU MUST execute the `ttt work-on` command using the Bash tool.
+YOU MUST execute the `ttt claim` command using the Bash tool.
 DO NOT manually edit cycle.toon or change task status by other means.
-After the task is completed, YOU MUST execute `/ttt:done -m "summary"`. This is MANDATORY.
+After each task is completed, YOU MUST execute `/ttt:done -m "summary"`. This is MANDATORY.
 </law>
 
-# /ttt:work-on — Start Working on a Task
+# /ttt:work-on — Claim a Ticket and Work on It
+
+`ttt claim` is the command; `ttt work-on` is its alias. Claiming moves the ticket
+to in-progress locally and on the remote source.
 
 ## Execution
 
 ```bash
-ttt work-on {{ issue-id | default: "next" }} {{ "--dry-run" if dry-run }}
+ttt claim {{ issue-ids | default: "next" }} {{ "--dry-run" if dry-run }}
 ```
 
 ### Argument Resolution
 
 | Input | Command |
 |-------|---------|
-| (none) | `ttt work-on next` |
-| `next` | `ttt work-on next` |
-| `MP-624` | `ttt work-on MP-624` |
-| `--dry-run` | `ttt work-on next --dry-run` |
-| `MP-624 --dry-run` | `ttt work-on MP-624 --dry-run` |
+| (none) | `ttt claim next` |
+| `next` | `ttt claim next` |
+| `next 3` | `ttt claim next 3` |
+| `MP-624` | `ttt claim MP-624` |
+| `MP-624 MP-625` | `ttt claim MP-624 MP-625` |
+| `--dry-run` | `ttt claim next --dry-run` |
+| `MP-624 --dry-run` | `ttt claim MP-624 --dry-run` |
 
 ## Full CLI Reference
 
 ```
-Usage: ttt work-on [issue-id] [options]
+Usage: ttt claim [issue-id...] [options]
+
+Claim ticket(s): move them to in-progress locally and on the remote source.
+Alias: ttt work-on
 
 Arguments:
-  issue-id    Issue ID (e.g., MP-624) or 'next' for auto-select
-              If omitted, shows interactive selection
+  issue-id    One or more issue IDs (e.g., MP-624 MP-625)
+              'next' claims the highest priority pending task
+              'next <n>' claims the top <n> pending tasks
+              If omitted, shows interactive multi-select
 
 Options:
-  --dry-run   Pick task without changing status (preview only)
+  --dry-run   Pick tickets without changing status (preview only)
 ```
 
-## After Selection — Delegate the Implementation
+Tickets that are already completed, in review, or blocked are reported and
+skipped without stopping the rest of the batch. An unknown ID aborts before
+anything is claimed.
+
+## After Claiming — Delegate the Implementation
 
-This command picks the task. The implementation workflow belongs to the user.
+This command claims the tickets. The implementation workflow belongs to the user.
 
 **Use the user's own workflow whenever one exists** — routing or laws in their root `CLAUDE.md`, the project `CLAUDE.md`, or a `work-on` / `start-work` skill. Follow it as written and add nothing.
 
@@ -61,7 +75,8 @@ This command picks the task. The implementation workflow belongs to the user.
 - Run lint / type / test and report the real output before claiming completion.
 - Offer `/ttt:write-work-on-skill` to capture this project's commands as a reusable skill.
 
-Either path closes the task with `/ttt:done -m "summary"`.
+When several tickets were claimed at once, carry them one at a time and close
+each with `/ttt:done -m "summary"` before starting the next.
 
 ## Error Handling
 

package/commands/ttt-write-work-on-skill.md

@@ -49,7 +49,7 @@ Create `.claude/skills/{{ $1 | default: "work-on" }}/SKILL.md` using the Plan
 ```markdown
 ---
 name: {{ $1 | default: "work-on" }}
-description: Project workflow — Plan → Test → Code → Review. Invoke after ttt work-on picks a task.
+description: Project workflow — Plan → Test → Code → Review. Invoke after ttt claim claims a ticket.
 ---
 
 # Work-On Skill ({{ project-name }})

package/dist/bin/cli.js

@@ -10,6 +10,7 @@ const VERSION = pkg.version;
 const COMMANDS = [
     "init",
     "sync",
+    "claim",
     "work-on",
     "estimate",
     "done",
@@ -34,7 +35,8 @@ USAGE:
 COMMANDS:
   init       Initialize config files in current directory
   sync       Sync issues from Linear to local cycle.ttt
-  work-on    Start working on a task (interactive or by ID)
+  claim      Claim ticket(s) and move them to in-progress
+  work-on    Alias for claim
   estimate   Store a local human-effort estimate for a task
   done       Mark current task as completed
   status     Show or modify task status
@@ -58,9 +60,9 @@ EXAMPLES:
   ttt init                      # Initialize .ttt directory
   ttt init -d ./custom          # Initialize in custom directory
   ttt sync                      # Sync from Linear
-  ttt work-on                   # Interactive task selection
-  ttt work-on MP-123            # Work on specific issue
-  ttt work-on next              # Auto-select highest priority
+  ttt claim                     # Interactive multi-select
+  ttt claim MP-123 MP-124       # Claim several tickets at once
+  ttt claim next 3              # Claim top 3 pending tasks
   ttt estimate MP-123 6         # Save a 6-hour estimate locally
   ttt done                      # Complete current task
   ttt done -m "Fixed the bug"   # With completion message
@@ -146,9 +148,10 @@ async function main() {
                 process.argv = ["node", "sync.js", ...commandArgs];
                 await importScript("sync.js");
                 break;
+            case "claim":
             case "work-on":
-                process.argv = ["node", "work-on.js", ...commandArgs];
-                await importScript("work-on.js");
+                process.argv = ["node", "claim.js", ...commandArgs];
+                await importScript("claim.js");
                 break;
             case "estimate":
                 process.argv = ["node", "estimate.js", ...commandArgs];

package/dist/scripts/claim.js

@@ -0,0 +1,235 @@
+import { checkbox } from "@inquirer/prompts";
+import { createAdapter } from "./lib/adapters/index.js";
+import { displayTaskFull, PRIORITY_LABELS } from "./lib/display.js";
+import { getStatusTransitions } from "./lib/linear.js";
+import { findTaskByIssueId, getPrioritySortIndex, getSourceType, loadConfig, loadCycleData, loadLocalConfig, saveCycleData, } from "./utils.js";
+const NEXT_ALIASES = ["next", "下一個", "下一個工作"];
+const NO_PENDING_MESSAGE = "✅ 沒有待處理的任務，所有工作已完成或進行中";
+const HELP = `Usage: ttt claim [issue-id...] [options]
+
+Claim ticket(s): move them to in-progress locally and on the remote source.
+Alias: ttt work-on
+
+Arguments:
+  issue-id    One or more issue IDs (e.g., MP-624 MP-625)
+              'next' claims the highest priority pending task
+              'next <n>' claims the top <n> pending tasks
+              If omitted, shows interactive multi-select
+
+Options:
+  --dry-run   Pick tickets without changing status (preview only)
+
+Examples:
+  ttt claim                     # Interactive multi-select
+  ttt claim MP-624              # Claim one ticket
+  ttt claim MP-624 MP-625       # Claim several tickets at once
+  ttt claim next                # Claim highest priority pending task
+  ttt claim next 3              # Claim top 3 pending tasks
+  ttt claim --dry-run           # Preview without changes`;
+function pickTasks(outcomes, match) {
+    return outcomes.filter((o) => match(o.action)).map((o) => o.task);
+}
+/** Pending tasks assigned to the current user, highest priority first. */
+function getPendingTasks(data, config, localConfig) {
+    const userKeys = Array.isArray(localConfig.current_user)
+        ? localConfig.current_user
+        : localConfig.current_user
+            ? [localConfig.current_user]
+            : [];
+    const currentUserEmails = userKeys
+        .map((key) => config.users[key]?.email?.toLowerCase())
+        .filter((email) => !!email);
+    return data.tasks
+        .filter((t) => {
+        if (t.localStatus !== "pending")
+            return false;
+        if (currentUserEmails.length === 0)
+            return true; // No filter = all users
+        if (!t.assignee)
+            return false;
+        return currentUserEmails.includes(t.assignee.toLowerCase());
+    })
+        .sort((a, b) => {
+        const pa = getPrioritySortIndex(a.priority, config.priority_order);
+        const pb = getPrioritySortIndex(b.priority, config.priority_order);
+        return pa - pb;
+    });
+}
+async function selectInteractively(pendingTasks) {
+    if (pendingTasks.length === 0) {
+        console.log(NO_PENDING_MESSAGE);
+        process.exit(0);
+    }
+    const selected = await checkbox({
+        message: "選擇要領的票 (空白鍵多選, Enter 確認):",
+        choices: pendingTasks.map((task) => ({
+            name: `${PRIORITY_LABELS[task.priority] || "⚪"} ${task.id}: ${task.title}`,
+            value: task.id,
+            description: task.labels.join(", "),
+        })),
+    });
+    if (selected.length === 0) {
+        console.log("已取消");
+        process.exit(0);
+    }
+    return selected;
+}
+function selectNext(countArg, pendingTasks) {
+    const count = countArg ? Number.parseInt(countArg, 10) : 1;
+    if (!Number.isInteger(count) || count < 1) {
+        console.error(`Invalid count: ${countArg}`);
+        process.exit(1);
+    }
+    if (pendingTasks.length === 0) {
+        console.log(NO_PENDING_MESSAGE);
+        process.exit(0);
+    }
+    const ids = pendingTasks.slice(0, count).map((t) => t.id);
+    console.log(`Auto-selected: ${ids.join(", ")}`);
+    return ids;
+}
+/** Resolve the requested tickets, exiting if any ID is unknown. */
+function resolveTasks(data, issueIds) {
+    const tasks = [];
+    const missing = [];
+    for (const issueId of issueIds) {
+        const task = findTaskByIssueId(data.tasks, issueId);
+        if (task) {
+            tasks.push(task);
+        }
+        else {
+            missing.push(issueId);
+        }
+    }
+    if (missing.length > 0) {
+        console.error(`Issue ${missing.join(", ")} not found in current cycle. No ticket claimed.`);
+        process.exit(1);
+    }
+    return tasks;
+}
+function decide(task) {
+    switch (task.localStatus) {
+        case "pending":
+            return { task, action: "claim" };
+        case "in-progress":
+            console.log(`⚠️ 此任務 ${task.id} 已在進行中`);
+            return { task, action: "already-in-progress" };
+        case "completed":
+            console.log(`⚠️ 此任務 ${task.id} 已完成`);
+            return { task, action: "skip" };
+        case "in-review":
+            console.log(`⚠️ 此任務 ${task.id} 正在審核中`);
+            return { task, action: "skip" };
+        case "blocked":
+            console.log(`⚠️ 此任務 ${task.id} 已被阻擋`);
+            return { task, action: "skip" };
+    }
+}
+/**
+ * Resolve the remote target status once for the whole batch.
+ * Returns null when the source is unreachable or not configured, which keeps
+ * claiming local-only (e.g. no API key).
+ */
+async function resolveRemoteTarget(config, teamId, inProgressStatus) {
+    if (!teamId)
+        return null;
+    try {
+        const adapter = createAdapter(config);
+        const statuses = await adapter.getStatuses(teamId);
+        const status = statuses.find((s) => s.name === inProgressStatus);
+        return status ? { adapter, status } : null;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Push one ticket to the remote in-progress status. One failing ticket must not
+ * abort the batch, and a local/remote divergence has to stay visible.
+ */
+async function pushRemoteStatus(remote, task, statusName, sourceName) {
+    const sourceId = task.sourceId ?? task.linearId;
+    if (!sourceId)
+        return;
+    try {
+        const result = await remote.adapter.updateIssueStatus(sourceId, remote.status.id);
+        if (result.success) {
+            task.status = statusName;
+            console.log(`${sourceName}: ${task.id} → ${statusName}`);
+        }
+        else {
+            console.log(`⚠️ ${sourceName}: ${task.id} 未更新 (${result.error ?? "unknown error"})`);
+        }
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        console.log(`⚠️ ${sourceName}: ${task.id} 未更新 (${message})`);
+    }
+}
+async function applyClaims(toClaim, data, config, localConfig) {
+    const statusSource = localConfig.status_source || "remote";
+    const sourceName = getSourceType(config) === "trello" ? "Trello" : "Linear";
+    const transitions = getStatusTransitions(config);
+    const remote = statusSource === "remote"
+        ? await resolveRemoteTarget(config, config.teams[localConfig.team]?.id, transitions.in_progress)
+        : null;
+    for (const task of toClaim) {
+        if (remote) {
+            await pushRemoteStatus(remote, task, transitions.in_progress, sourceName);
+        }
+        task.localStatus = "in-progress";
+        console.log(`Local: ${task.id} → in-progress`);
+    }
+    await saveCycleData(data);
+    if (statusSource === "local") {
+        console.log(`(${sourceName} status not updated - use 'sync --update' to push)`);
+    }
+}
+async function resolveIssueIds(positional, pendingTasks) {
+    if (positional.length === 0)
+        return selectInteractively(pendingTasks);
+    if (NEXT_ALIASES.includes(positional[0])) {
+        return selectNext(positional[1], pendingTasks);
+    }
+    return [...new Set(positional)];
+}
+async function claim() {
+    const args = process.argv.slice(2);
+    if (args.includes("--help") || args.includes("-h")) {
+        console.log(HELP);
+        process.exit(0);
+    }
+    const dryRun = args.includes("--dry-run");
+    const positional = args.filter((a) => a !== "--dry-run");
+    const config = await loadConfig();
+    const data = await loadCycleData();
+    if (!data) {
+        console.error("No cycle data found. Run /sync-linear first.");
+        process.exit(1);
+    }
+    const localConfig = await loadLocalConfig();
+    const pendingTasks = getPendingTasks(data, config, localConfig);
+    const issueIds = await resolveIssueIds(positional, pendingTasks);
+    // Availability Check — resolve the whole batch before mutating anything
+    const outcomes = resolveTasks(data, issueIds).map(decide);
+    const toClaim = pickTasks(outcomes, (a) => a === "claim");
+    const toDisplay = pickTasks(outcomes, (a) => a !== "skip");
+    if (toDisplay.length === 0) {
+        process.exit(0);
+    }
+    if (toClaim.length > 0 && !dryRun) {
+        await applyClaims(toClaim, data, config, localConfig);
+    }
+    // Display task info
+    const icon = dryRun ? "🔍" : "👷";
+    for (const task of toDisplay) {
+        displayTaskFull(task, icon);
+    }
+    if (dryRun) {
+        console.log("(dry-run: no changes made)");
+    }
+    else {
+        console.log("Next: bun type-check && bun lint");
+    }
+}
+claim().catch(console.error);

package/dist/scripts/comment.js

@@ -1,6 +1,6 @@
 #!/usr/bin/env bun
 import { createAdapter } from "./lib/adapters/index.js";
-import { getSourceType, loadConfig, loadCycleData, } from "./utils.js";
+import { findTaskByIssueId, getSourceType, loadConfig, loadCycleData, } from "./utils.js";
 function parseArgs(args) {
     let issueId;
     let message;
@@ -79,7 +79,7 @@ Examples:
         issueId = task.id;
     }
     else {
-        task = data?.tasks.find((t) => t.id === issueId || t.id === `MP-${issueId}`);
+        task = data ? findTaskByIssueId(data.tasks, issueId) : undefined;
         if (!task) {
             console.error(`Issue ${issueId} not in local data. Fetching from remote...`);
             task = await fetchTaskFromRemote(issueId, config);

package/dist/scripts/done-job.js

@@ -7,7 +7,7 @@ import { input, select } from "@inquirer/prompts";
 import { handleLinearCompletion, handleTrelloCompletion, parseArgs, printHelp, } from "./lib/done/index.js";
 import { getLatestCommit } from "./lib/git.js";
 import { fetchIssueDetail, syncSingleIssue } from "./lib/sync.js";
-import { getSourceType, loadConfig, loadCycleData, loadLocalConfig, saveCycleData, } from "./utils.js";
+import { findTaskByIssueId, getSourceType, loadConfig, loadCycleData, loadLocalConfig, saveCycleData, } from "./utils.js";
 async function doneJob() {
     const args = process.argv.slice(2);
     if (args.includes("--help") || args.includes("-h")) {
@@ -80,7 +80,7 @@ async function doneJob() {
             }
         }
         // Find task in local data
-        const localTask = data.tasks.find((t) => t.id === issueId || t.id === `MP-${issueId}`);
+        const localTask = findTaskByIssueId(data.tasks, issueId);
         if (!localTask) {
             console.error(`Issue ${issueId} not found in local data.`);
             console.error(`Hint: Run 'ttt sync ${issueId}' or use '--from-remote' flag.`);

package/dist/scripts/estimate.js

@@ -1,6 +1,6 @@
 #!/usr/bin/env bun
 import { input, select } from "@inquirer/prompts";
-import { loadCycleData, saveCycleData } from "./utils.js";
+import { findTaskByIssueId, loadCycleData, saveCycleData, } from "./utils.js";
 function parseEstimateArgs(args) {
     const parsed = { clear: false };
     for (let i = 0; i < args.length; i++) {
@@ -31,7 +31,7 @@ function parseEstimateArgs(args) {
 }
 function findTask(tasks, issueId) {
     if (issueId) {
-        return tasks.find((task) => task.id === issueId || task.id === `MP-${issueId}`);
+        return findTaskByIssueId(tasks, issueId);
     }
     const inProgressTasks = tasks.filter((task) => task.localStatus === "in-progress");
     if (inProgressTasks.length === 1) {

package/dist/scripts/lib/init/file-ops.js

@@ -67,7 +67,7 @@ export function showPluginInstallInstructions() {
     console.log("│                                                             │");
     console.log("│  Available commands after install:                          │");
     console.log("│     /ttt:sync        - Sync Linear issues                   │");
-    console.log("│     /ttt:work-on     - Start working on a task              │");
+    console.log("│     /ttt:work-on     - Claim ticket(s) and work on them     │");
     console.log("│     /ttt:done        - Complete current task                │");
     console.log("│     /ttt:status      - Show/modify task status              │");
     console.log("│     /ttt:show        - Show/search issues                   │");

package/dist/scripts/lib/init/linear-init.js

@@ -257,11 +257,11 @@ export async function initLinear(options, paths) {
         console.log(`  1. Set ${envName} in your shell profile:`);
         console.log(`     export ${envName}="${maskedKey}"`);
         console.log("  2. Run sync: ttt sync");
-        console.log("  3. Start working: ttt work-on");
+        console.log("  3. Claim a ticket: ttt claim");
     }
     else {
         console.log("  1. Run sync: ttt sync");
-        console.log("  2. Start working: ttt work-on");
+        console.log("  2. Claim a ticket: ttt claim");
     }
     // Show Claude Code plugin installation instructions at the end
     showPluginInstallInstructions();

package/dist/scripts/lib/init/prompts.js

@@ -87,7 +87,7 @@ export async function selectStatusSource(options) {
             {
                 name: "Remote (recommended)",
                 value: "remote",
-                description: "Update Linear immediately when you work-on or complete tasks",
+                description: "Update Linear immediately when you claim or complete tasks",
             },
             {
                 name: "Local",

package/dist/scripts/lib/init/trello-init.js

@@ -252,10 +252,10 @@ export async function initTrello(options, paths) {
         console.log(`     export TRELLO_API_KEY="${maskedKey}"`);
         console.log(`     export TRELLO_TOKEN="<your-token>"`);
         console.log("  2. Run sync: ttt sync");
-        console.log("  3. Start working: ttt work-on");
+        console.log("  3. Claim a ticket: ttt claim");
     }
     else {
         console.log("  1. Run sync: ttt sync");
-        console.log("  2. Start working: ttt work-on");
+        console.log("  2. Claim a ticket: ttt claim");
     }
 }

package/dist/scripts/status.js

@@ -3,7 +3,7 @@ import { createAdapter } from "./lib/adapters/index.js";
 import { displayTaskWithStatus, getStatusIcon } from "./lib/display.js";
 import { getStatusTransitions, mapLocalStatusToLinear } from "./lib/linear.js";
 import { getFirstTodoStatus } from "./lib/status-helpers.js";
-import { getSourceType, loadConfig, loadCycleData, loadLocalConfig, saveCycleData, } from "./utils.js";
+import { findTaskByIssueId, getSourceType, loadConfig, loadCycleData, loadLocalConfig, saveCycleData, } from "./utils.js";
 const LOCAL_STATUS_ORDER = [
     "pending",
     "in-progress",
@@ -115,7 +115,7 @@ Examples:
         issueId = task.id;
     }
     else {
-        task = data.tasks.find((t) => t.id === issueId || t.id === `MP-${issueId}`);
+        task = findTaskByIssueId(data.tasks, issueId);
         if (!task) {
             // Fetch from remote
             console.error(`Issue ${issueId} not in local data. Fetching from remote...`);

package/dist/scripts/utils.d.ts

@@ -1,5 +1,10 @@
 import { LinearClient } from "@linear/sdk";
 import type { SourceIssue } from "./lib/adapters/types.js";
+/**
+ * Resolved on every call, so a TOON_DIR set after this module loads still
+ * applies. Caching it at module load made the base directory depend on import
+ * order.
+ */
 export declare function getPaths(): {
     baseDir: string;
     configPath: string;
@@ -153,6 +158,15 @@ export declare function getDefaultTeamKey(config: Config): string;
 export declare function getTeamId(config: Config, teamKey?: string): string;
 export declare function getSourceType(config: Config): TaskSourceType;
 export declare function getTaskSourceId(task: Task): string;
+/**
+ * Find a task by its display ID.
+ *
+ * A full ID (e.g. "MP-624") matches exactly. A bare number (e.g. "624") matches
+ * the ticket with that number regardless of team prefix; when several teams
+ * share the number the candidates are reported and nothing is returned, so the
+ * caller asks for the full ID instead of acting on a guess.
+ */
+export declare function findTaskByIssueId(tasks: Task[], issueId: string): Task | undefined;
 export declare function preserveLocalTaskFields(task: Task, existingTask?: Task): Task;
 /**
  * Update or insert a task in cycle data and save to disk.

package/dist/scripts/utils.js

@@ -17,20 +17,20 @@ function getBaseDir() {
     // 3. Default: .ttt directory in current working directory
     return path.join(process.cwd(), ".ttt");
 }
-const BASE_DIR = getBaseDir();
-const CONFIG_PATH = path.join(BASE_DIR, "config.toon");
-const CYCLE_PATH = path.join(BASE_DIR, "cycle.toon");
-const LOCAL_PATH = path.join(BASE_DIR, "local.toon");
-const OUTPUT_PATH = path.join(BASE_DIR, "output");
-const ENV_PATH = path.join(BASE_DIR, ".env");
+/**
+ * Resolved on every call, so a TOON_DIR set after this module loads still
+ * applies. Caching it at module load made the base directory depend on import
+ * order.
+ */
 export function getPaths() {
+    const baseDir = getBaseDir();
     return {
-        baseDir: BASE_DIR,
-        configPath: CONFIG_PATH,
-        cyclePath: CYCLE_PATH,
-        localPath: LOCAL_PATH,
-        outputPath: OUTPUT_PATH,
-        envPath: ENV_PATH,
+        baseDir,
+        configPath: path.join(baseDir, "config.toon"),
+        cyclePath: path.join(baseDir, "cycle.toon"),
+        localPath: path.join(baseDir, "local.toon"),
+        outputPath: path.join(baseDir, "output"),
+        envPath: path.join(baseDir, ".env"),
     };
 }
 // Linear priority value to name mapping (fixed by Linear API)
@@ -64,23 +64,25 @@ export async function fileExists(filePath) {
     }
 }
 export async function loadConfig() {
+    const { configPath } = getPaths();
     try {
-        const fileContent = await fs.readFile(CONFIG_PATH, "utf-8");
+        const fileContent = await fs.readFile(configPath, "utf-8");
         return decode(fileContent, { strict: false });
     }
     catch (error) {
-        console.error(`Error loading config from ${CONFIG_PATH}:`, error);
+        console.error(`Error loading config from ${configPath}:`, error);
         console.error("Run `bun run init` to create configuration files.");
         process.exit(1);
     }
 }
 export async function loadLocalConfig() {
+    const { localPath } = getPaths();
     try {
-        const fileContent = await fs.readFile(LOCAL_PATH, "utf-8");
+        const fileContent = await fs.readFile(localPath, "utf-8");
         return decode(fileContent, { strict: false });
     }
     catch {
-        console.error(`Error: ${LOCAL_PATH} not found.`);
+        console.error(`Error: ${localPath} not found.`);
         console.error("Run `bun run init` to create local configuration.");
         process.exit(1);
     }
@@ -174,32 +176,33 @@ export async function withRetry(fn, opts = {}) {
     throw lastErr;
 }
 export async function loadCycleData() {
+    const { cyclePath } = getPaths();
     try {
-        await fs.access(CYCLE_PATH);
+        await fs.access(cyclePath);
     }
     catch {
         return null;
     }
     try {
-        const fileContent = await fs.readFile(CYCLE_PATH, "utf-8");
+        const fileContent = await fs.readFile(cyclePath, "utf-8");
         return decode(fileContent, { strict: false });
     }
     catch (error) {
-        console.error(`Warning: Failed to decode ${CYCLE_PATH}: ${error instanceof Error ? error.message : error}`);
+        console.error(`Warning: Failed to decode ${cyclePath}: ${error instanceof Error ? error.message : error}`);
         return null;
     }
 }
 export async function saveCycleData(data) {
     const toonString = encode(data);
-    await fs.writeFile(CYCLE_PATH, toonString, "utf-8");
+    await fs.writeFile(getPaths().cyclePath, toonString, "utf-8");
 }
 export async function saveConfig(config) {
     const toonString = encode(config);
-    await fs.writeFile(CONFIG_PATH, toonString, "utf-8");
+    await fs.writeFile(getPaths().configPath, toonString, "utf-8");
 }
 export async function saveLocalConfig(config) {
     const toonString = encode(config);
-    await fs.writeFile(LOCAL_PATH, toonString, "utf-8");
+    await fs.writeFile(getPaths().localPath, toonString, "utf-8");
 }
 // Get first team key from config
 export function getDefaultTeamKey(config) {
@@ -229,6 +232,28 @@ export function getSourceType(config) {
 export function getTaskSourceId(task) {
     return task.sourceId ?? task.linearId;
 }
+/**
+ * Find a task by its display ID.
+ *
+ * A full ID (e.g. "MP-624") matches exactly. A bare number (e.g. "624") matches
+ * the ticket with that number regardless of team prefix; when several teams
+ * share the number the candidates are reported and nothing is returned, so the
+ * caller asks for the full ID instead of acting on a guess.
+ */
+export function findTaskByIssueId(tasks, issueId) {
+    const exact = tasks.find((t) => t.id === issueId);
+    if (exact)
+        return exact;
+    if (!/^\d+$/.test(issueId))
+        return undefined;
+    const matches = tasks.filter((t) => t.id.endsWith(`-${issueId}`));
+    if (matches.length === 1)
+        return matches[0];
+    if (matches.length > 1) {
+        console.error(`Ambiguous issue "${issueId}": ${matches.map((t) => t.id).join(", ")}. Use the full ID.`);
+    }
+    return undefined;
+}
 export function preserveLocalTaskFields(task, existingTask) {
     if (!existingTask) {
         return task;

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "team-toon-tack",
-	"version": "3.9.3",
+	"version": "3.10.0",
 	"description": "Linear & Trello task sync & management CLI with TOON format",
 	"type": "module",
 	"bin": {
@@ -23,6 +23,7 @@
 		"lint": "biome lint .",
 		"format": "biome check --write .",
 		"type": "tsc --noEmit",
+		"test": "bun test",
 		"prepublishOnly": "npm run build",
 		"release": "npm config set //registry.npmjs.org/:_authToken=$NPM_PUBLISH_KEY && npm publish"
 	},

package/skills/managing-linear-tasks/SKILL.md

@@ -23,7 +23,7 @@ Manage developer task workflows using the `ttt` CLI.
 |-------------|---------|---------|
 | Sync/fetch issues | `ttt sync` | "sync my issues", "pull from Linear" |
 | Show/search issues | `ttt show` | "show MP-624", "list my tasks", "what issues do I have" |
-| Start working on a task | `ttt work-on` | "work on next", "start MP-624" |
+| Claim ticket(s) → in-progress | `ttt claim` | "領票", "work on next", "start MP-624", "claim MP-624 MP-625" |
 | Create a new issue | `ttt create` | "create issue", "open a ticket", "new task" |
 | Reassign an issue | `ttt assign` | "assign MP-624 to john", "reassign to jane" |
 | Edit issue fields | `ttt edit` | "rename MP-624", "change priority", "update labels" |
@@ -44,8 +44,9 @@ ttt sync MP-624             # Sync specific issue
 ttt show                    # List all local issues
 ttt show MP-624             # Show issue details
 ttt show --user me          # My issues
-ttt work-on next            # Auto-select highest priority
-ttt work-on MP-624          # Start specific task
+ttt claim next              # Claim highest priority pending task
+ttt claim next 3            # Claim top 3 pending tasks
+ttt claim MP-624 MP-625     # Batch claim (alias: ttt work-on)
 ttt create                  # Create new issue (interactive)
 ttt create -t "Title" -p 2  # Quick create with flags
 ttt assign MP-624 -a john   # Reassign issue
@@ -68,7 +69,7 @@ ttt done -m "summary"       # Complete with message
 ## Standard Workflow
 
 ```
-ttt sync → ttt work-on next → ttt estimate <id> <hours> → [implement] → git commit → ttt comment -m "notes" → ttt done -m "..."
+ttt sync → ttt claim next → ttt estimate <id> <hours> → [implement] → git commit → ttt comment -m "notes" → ttt done -m "..."
 ```
 
 ## File Structure
@@ -112,7 +113,7 @@ digraph ttt_router {
 
     sync     [label="ttt sync",    shape=box];
     show     [label="ttt show",    shape=box];
-    work_on  [label="ttt work-on", shape=box];
+    claim    [label="ttt claim",   shape=box];
     create   [label="ttt create",  shape=box];
     assign   [label="ttt assign",  shape=box];
     edit     [label="ttt edit",    shape=box];
@@ -125,7 +126,7 @@ digraph ttt_router {
     user -> classify;
     classify -> sync     [label="fetch / pull"];
     classify -> show     [label="show / list"];
-    classify -> work_on  [label="start / next"];
+    classify -> claim    [label="claim / start / next"];
     classify -> create   [label="create / new"];
     classify -> assign   [label="assign / reassign"];
     classify -> edit     [label="rename / change field"];

package/dist/scripts/work-on.js

@@ -1,153 +0,0 @@
-import { select } from "@inquirer/prompts";
-import { createAdapter } from "./lib/adapters/index.js";
-import { displayTaskFull, PRIORITY_LABELS } from "./lib/display.js";
-import { getStatusTransitions } from "./lib/linear.js";
-import { getPrioritySortIndex, getSourceType, loadConfig, loadCycleData, loadLocalConfig, saveCycleData, } from "./utils.js";
-async function workOn() {
-    const args = process.argv.slice(2);
-    if (args.includes("--help") || args.includes("-h")) {
-        console.log(`Usage: ttt work-on [issue-id] [options]
-
-Arguments:
-  issue-id    Issue ID (e.g., MP-624) or 'next' for auto-select
-              If omitted, shows interactive selection
-
-Options:
-  --dry-run   Pick task without changing status (preview only)
-
-Examples:
-  ttt work-on           # Interactive selection
-  ttt work-on MP-624    # Work on specific issue
-  ttt work-on next      # Auto-select highest priority
-  ttt work-on --dry-run # Preview selection without changes`);
-        process.exit(0);
-    }
-    const dryRun = args.includes("--dry-run");
-    const filteredArgs = args.filter((a) => a !== "--dry-run");
-    let issueId = filteredArgs[0];
-    const config = await loadConfig();
-    const data = await loadCycleData();
-    if (!data) {
-        console.error("No cycle data found. Run /sync-linear first.");
-        process.exit(1);
-    }
-    const localConfig = await loadLocalConfig();
-    // Get current user email(s) for filtering
-    const userKeys = Array.isArray(localConfig.current_user)
-        ? localConfig.current_user
-        : localConfig.current_user
-            ? [localConfig.current_user]
-            : [];
-    const currentUserEmails = userKeys
-        .map((key) => config.users[key]?.email?.toLowerCase())
-        .filter((email) => !!email);
-    const pendingTasks = data.tasks
-        .filter((t) => {
-        if (t.localStatus !== "pending")
-            return false;
-        if (currentUserEmails.length === 0)
-            return true; // No filter = all users
-        if (!t.assignee)
-            return false;
-        return currentUserEmails.includes(t.assignee.toLowerCase());
-    })
-        .sort((a, b) => {
-        const pa = getPrioritySortIndex(a.priority, config.priority_order);
-        const pb = getPrioritySortIndex(b.priority, config.priority_order);
-        return pa - pb;
-    });
-    // Issue Resolution
-    if (!issueId) {
-        if (pendingTasks.length === 0) {
-            console.log("✅ 沒有待處理的任務，所有工作已完成或進行中");
-            process.exit(0);
-        }
-        const choices = pendingTasks.map((task) => ({
-            name: `${PRIORITY_LABELS[task.priority] || "⚪"} ${task.id}: ${task.title}`,
-            value: task.id,
-            description: task.labels.join(", "),
-        }));
-        const selectedId = await select({
-            message: "選擇要處理的任務:",
-            choices: choices,
-        });
-        if (!selectedId) {
-            console.log("已取消");
-            process.exit(0);
-        }
-        issueId = selectedId;
-    }
-    else if (["next", "下一個", "下一個工作"].includes(issueId)) {
-        if (pendingTasks.length === 0) {
-            console.log("✅ 沒有待處理的任務，所有工作已完成或進行中");
-            process.exit(0);
-        }
-        issueId = pendingTasks[0].id;
-        console.log(`Auto-selected: ${issueId}`);
-    }
-    // Find task
-    const task = data.tasks.find((t) => t.id === issueId || t.id === `MP-${issueId}`);
-    if (!task) {
-        console.error(`Issue ${issueId} not found in current cycle.`);
-        process.exit(1);
-    }
-    // Availability Check
-    if (task.localStatus === "in-progress") {
-        console.log(`⚠️ 此任務 ${task.id} 已在進行中`);
-    }
-    else if (task.localStatus === "completed") {
-        console.log(`⚠️ 此任務 ${task.id} 已完成`);
-        process.exit(0);
-    }
-    else if (task.localStatus === "in-review") {
-        console.log(`⚠️ 此任務 ${task.id} 正在審核中`);
-        process.exit(0);
-    }
-    // Mark as In Progress (skip if dry-run)
-    if (task.localStatus === "pending" && !dryRun) {
-        task.localStatus = "in-progress";
-        // Update remote (only if status_source is 'remote' or not set)
-        const statusSource = localConfig.status_source || "remote";
-        const sourceType = getSourceType(config);
-        const sourceId = task.sourceId ?? task.linearId;
-        if (statusSource === "remote" && sourceId) {
-            const transitions = getStatusTransitions(config);
-            try {
-                const adapter = createAdapter(config);
-                // Get statuses to find status ID
-                const teamId = config.teams[localConfig.team]?.id;
-                if (teamId) {
-                    const statuses = await adapter.getStatuses(teamId);
-                    const targetStatus = statuses.find((s) => s.name === transitions.in_progress);
-                    if (targetStatus) {
-                        const result = await adapter.updateIssueStatus(sourceId, targetStatus.id);
-                        if (result.success) {
-                            task.status = transitions.in_progress;
-                            const sourceName = sourceType === "trello" ? "Trello" : "Linear";
-                            console.log(`${sourceName}: ${task.id} → ${transitions.in_progress}`);
-                        }
-                    }
-                }
-            }
-            catch (_error) {
-                // Silently fail if adapter not available (e.g., no API key)
-            }
-        }
-        await saveCycleData(data);
-        console.log(`Local: ${task.id} → in-progress`);
-        if (statusSource === "local") {
-            const sourceName = sourceType === "trello" ? "Trello" : "Linear";
-            console.log(`(${sourceName} status not updated - use 'sync --update' to push)`);
-        }
-    }
-    // Display task info
-    const icon = dryRun ? "🔍" : "👷";
-    displayTaskFull(task, icon);
-    if (dryRun) {
-        console.log("(dry-run: no changes made)");
-    }
-    else {
-        console.log("Next: bun type-check && bun lint");
-    }
-}
-workOn().catch(console.error);