team-toon-tack 3.10.3 → 3.12.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.10.3"
+			"version": "3.12.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.10.3",
+	"version": "3.12.0",
 	"author": {
 		"name": "wayne930242",
 		"email": "wayne930242@gmail.com"

package/.codex-plugin/plugin.json

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

package/README.md

@@ -58,7 +58,7 @@ During init, you'll be prompted to select your task source (Linear or Trello) an
 |------|----------|
 | `simple` | Mark task as Done + parent as Done. Default when no QA team configured. |
 | `strict_review` | Mark task to dev testing + parent to QA testing. |
-| `upstream_strict` | Mark task as Done + parent to Testing. Falls back to dev testing if no parent. Default when QA team configured. |
+| `upstream_strict` | Mark task as Done + parent to Testing. Falls back to dev testing if no parent (the task then goes straight to testing, without a Done step). 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.
@@ -159,7 +159,14 @@ 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.
+stopping the rest of the batch. An ID that local data does not hold (for example
+a Backlog ticket outside the cycle) is fetched from the source, stored locally,
+and claimed like any other; with `--dry-run` it is shown but not stored. An ID
+found neither locally nor at the source aborts before anything is claimed.
+A ticket that is already closed (done or canceled) is reported and skipped. Note
+that a full `ttt sync` rewrites local data from the current cycle, so a stored
+ticket outside it drops out on the next sync (`ttt done <id> --from-remote`
+still completes it).
 
 ### `ttt estimate`
 
@@ -181,9 +188,13 @@ 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)
+ttt done MP-123 --commit 1a2b3c4 # Record this commit instead of HEAD
+ttt done MP-123 --commit 1a2b3c4 --repo ~/projects/app   # ...read from another repository
 ```
 
-Use `--from-remote` (or `-r`) when the issue exists in remote but not in local sync data.
+Use `--from-remote` (or `-r`) when the issue exists in remote but not in local sync data, or when the ticket is still Todo and you want to complete it without `ttt claim` (no extra In Progress transition). `ttt done` without it only accepts in-progress tasks.
+
+Use `--commit <sha>` (and `--repo <path>` when the commit lives in another checkout) to close a ticket whose commit was merged earlier. Without it, the current HEAD is recorded.
 
 ### `ttt status`
 
@@ -209,8 +220,22 @@ 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
 ttt show --export              # Export as markdown
+ttt show --remote --status Backlog --creator me   # Backlog tickets I created
+ttt show --remote --status Backlog --user me      # Backlog tickets assigned to me
+ttt show --remote --any-cycle --creator me        # My tickets in any cycle
 ```
 
+Two options widen a `--remote` search beyond what `ttt sync` stores (both need
+`--remote`; otherwise the command fails instead of ignoring them):
+
+- `--creator <me|email|name>` filters by who created the issue (Linear only;
+  Trello cards expose no creator, so it fails there). Without `--user`, the
+  assignee scope is lifted, so tickets you created for others or left
+  unassigned show up.
+- `--any-cycle` searches outside the current cycle. `--status Backlog` implies
+  it, because backlog tickets usually belong to no cycle. Trello has no cycles,
+  so there it changes nothing.
+
 ### `ttt config`
 
 Configure settings.

package/README.zh-TW.md

@@ -58,7 +58,7 @@ ttt init
 |------|------|
 | `simple` | 任務標記為 Done，parent 也標記為 Done。未設定 QA 團隊時的預設值。 |
 | `strict_review` | 任務標記到開發團隊的 testing 狀態，parent 標記到 QA 團隊的 testing 狀態。 |
-| `upstream_strict` | 任務標記為 Done，parent 移動到 Testing。若無 parent，fallback 到開發團隊的 testing 狀態。設定 QA 團隊時的預設值。 |
+| `upstream_strict` | 任務標記為 Done，parent 移動到 Testing。若無 parent，fallback 到開發團隊的 testing 狀態（此時任務直接進 testing，不會先寫 Done）。設定 QA 團隊時的預設值。 |
 | `upstream_not_strict` | 任務標記為 Done，parent 移動到 Testing。若無 parent 不做 fallback。 |
 
 > **注意**：Trello 因不支援 parent issue，一律使用簡單完成模式。
@@ -159,7 +159,10 @@ ttt claim --dry-run        # 預覽，不改狀態
 ```
 
 已完成、審核中、blocked 的票會逐張回報並跳過，不中斷整批。
-批次中出現不存在的 ID 時，整批在動任何票之前中止。
+本地資料沒有的 ID（例如不在 cycle 內的 Backlog 票）會從來源抓回、存進本地，再照一般流程領票；
+加 `--dry-run` 時只顯示、不存入。本地與來源都找不到的 ID，整批在動任何票之前中止。
+已關閉（完成或取消）的票會回報並跳過。
+注意：完整的 `ttt sync` 會依目前 cycle 重寫本地資料，不在 cycle 內的票下次同步後會消失（仍可用 `ttt done <id> --from-remote` 完成）。
 
 ### `ttt estimate`
 
@@ -181,9 +184,13 @@ ttt done                         # 若只有一個進行中，自動選擇
 ttt done MP-123                  # 指定 issue
 ttt done -m "修復了錯誤"           # 附上完成說明
 ttt done MP-123 --from-remote    # 從遠端取得（略過本地資料檢查）
+ttt done MP-123 --commit 1a2b3c4 # 記錄指定 commit，而非目前 HEAD
+ttt done MP-123 --commit 1a2b3c4 --repo ~/projects/app   # ...從另一個 repository 讀取
 ```
 
-當 issue 存在於遠端但未同步到本地資料時，使用 `--from-remote`（或 `-r`）。
+當 issue 存在於遠端但未同步到本地資料，或 ticket 仍是 Todo、想不經 `ttt claim`（不多一次 In Progress 轉換）直接完成時，使用 `--from-remote`（或 `-r`）。不加此參數時，`ttt done` 只接受進行中的任務。
+
+要關閉 commit 早已合併的 ticket，用 `--commit <sha>`（commit 在另一個 checkout 時再加 `--repo <path>`）。未指定時記錄目前的 HEAD。
 
 ### `ttt status`
 
@@ -209,8 +216,18 @@ ttt show --label frontend      # 依標籤過濾
 ttt show --status "In Progress" --user me   # 我進行中的 issue
 ttt show --priority 1          # 顯示緊急 issue
 ttt show --export              # 輸出為 markdown 格式
+ttt show --remote --status Backlog --creator me   # 我建立的 Backlog 票
+ttt show --remote --status Backlog --user me      # 指派給我的 Backlog 票
+ttt show --remote --any-cycle --creator me        # 我建立、不限 cycle 的票
 ```
 
+兩個選項可把 `--remote` 搜尋範圍放寬到 `ttt sync` 之外（都必須搭配 `--remote`，否則直接報錯，不會默默忽略）：
+
+- `--creator <me|email|name>`：依建立者過濾（僅 Linear；Trello 卡片沒有建立者，會報錯）。
+  未指定 `--user` 時會解除指派對象的限制，因此你建給別人或未指派的票也找得到。
+- `--any-cycle`：不限目前 cycle。`--status Backlog` 會自動帶上它，因為 Backlog 票通常不屬於任何 cycle。
+  Trello 沒有 cycle，所以在 Trello 上沒有作用。
+
 ### `ttt config`
 
 配置設定。

package/commands/ttt-create.md

@@ -45,7 +45,7 @@ Options:
   -d, --description <text> Description
   -a, --assignee <key>     Assignee user key from config
   -p, --priority <0-4>     Priority (0=none, 1=urgent, 2=high, 3=medium, 4=low)
-  -l, --label <names>      Label names (comma-separated)
+  -l, --label <names>      Label names (comma-separated; config first, then looked up live in Linear)
   -s, --status <name>      Initial status name
   --parent <id>            Parent issue identifier (e.g., MP-100)
   --no-interactive         Skip interactive prompts

package/commands/ttt-done.md

@@ -11,6 +11,12 @@ arguments:
   - name: from-remote
     description: Fetch issue from Linear (bypass local data check)
     required: false
+  - name: commit
+    description: Commit to record instead of HEAD (e.g., an already merged commit)
+    required: false
+  - name: repo
+    description: Git repository to read the commit from (default - cwd)
+    required: false
 ---
 
 <law>
@@ -24,7 +30,7 @@ DO NOT skip this command — it updates both local and remote status, posts a co
 ## Execution
 
 ```bash
-ttt done {{ issue-id }} {{ "-m \"" + message + "\"" if message }} {{ "--from-remote" if from-remote }}
+ttt done {{ issue-id }} {{ "-m \"" + message + "\"" if message }} {{ "--from-remote" if from-remote }} {{ "--commit " + commit if commit }} {{ "--repo " + repo if repo }}
 ```
 
 ### Common Examples
@@ -34,20 +40,24 @@ ttt done                                # Complete current in-progress task
 ttt done MP-624                         # Complete specific task
 ttt done -m "Fixed null check"          # With completion message
 ttt done MP-624 -m "Refactored auth"    # Specific task with message
-ttt done MP-624 --from-remote           # Issue not in local data
+ttt done MP-624 --from-remote           # Issue not in local data, or still Todo (no claim needed)
+ttt done MP-624 --commit 1a2b3c4        # Record an earlier commit, not HEAD
 ```
 
 ## Full CLI Reference
 
 ```
-Usage: ttt done [issue-id] [-m message] [--from-remote]
+Usage: ttt done [issue-id] [-m message] [--from-remote] [--commit <sha>] [--repo <path>]
 
 Arguments:
   issue-id              Optional. Issue ID if multiple tasks in-progress
 
 Options:
   -m, --message         Completion message describing what was done
-  -r, --from-remote     Fetch issue from Linear (bypass local data check)
+  -r, --from-remote     Fetch issue from Linear (bypass local data check;
+                        also completes a Todo ticket without `ttt claim`)
+  --commit <sha>        Record this commit instead of HEAD
+  --repo <path>         Git repository to read the commit from (default: cwd)
 ```
 
 ## Before Running
@@ -64,7 +74,7 @@ Based on configured completion mode:
 |------|-------------|---------------|
 | `simple` | → Done | → Done |
 | `strict_review` | → Testing | → QA Testing |
-| `upstream_strict` | → Done | → Testing |
+| `upstream_strict` | → Done | → Testing (no valid parent: task goes straight to Testing) |
 | `upstream_not_strict` | → Done | → Testing (no fallback) |
 
 Additionally:
@@ -79,4 +89,5 @@ Additionally:
 | `No in-progress task` | Specify issue-id explicitly |
 | `Multiple in-progress` | Specify issue-id to disambiguate |
 | `Issue not found` | Use `--from-remote` flag |
+| `不在進行中狀態` (task is Todo) | `ttt claim <id>` first, or `ttt done <id> --from-remote` |
 | `No commits found` | Commit your changes first |

package/commands/ttt-show.md

@@ -20,6 +20,12 @@ arguments:
   - name: remote
     description: Fetch from Linear API instead of local data
     required: false
+  - name: creator
+    description: "Filter by creator ('me', email, or name). Needs remote; Linear only"
+    required: false
+  - name: any-cycle
+    description: Search outside the current cycle. Needs remote
+    required: false
   - name: export
     description: Output as markdown format
     required: false
@@ -43,6 +49,8 @@ ttt show {{ issue-id }} \
   {{ "--status \"" + status + "\"" if status }} \
   {{ "--user " + user if user }} \
   {{ "--priority " + priority if priority }} \
+  {{ "--creator " + creator if creator }} \
+  {{ "--any-cycle" if any-cycle }} \
   {{ "--remote" if remote }} \
   {{ "--export" if export }}
 ```
@@ -58,6 +66,9 @@ ttt show --label frontend                   # Filter by label
 ttt show --status "In Progress" --user me   # My in-progress issues
 ttt show --priority 1                       # All urgent issues
 ttt show --export                           # Export all as markdown
+ttt show --remote --status Backlog --creator me   # Backlog tickets I created
+ttt show --remote --status Backlog --user me      # Backlog tickets assigned to me
+ttt show --remote --any-cycle --creator me        # My tickets in any cycle
 ```
 
 ## Full CLI Reference
@@ -75,8 +86,14 @@ Options:
   --status <status>     Filter by status
   --user <email>        Filter by assignee ("me", "unassigned", or email)
   --priority <n>        Filter by priority (0=None, 1=Urgent, 2=High, 3=Medium, 4=Low)
+  --creator <who>       Filter by creator ("me", email, or name). Needs --remote,
+                        Linear only. Without --user, the assignee scope is lifted
+  --any-cycle           Search outside the current cycle. Needs --remote
 ```
 
+`--status Backlog` implies `--any-cycle`. `--creator` and `--any-cycle` fail
+without `--remote` instead of being ignored, and `--creator` fails on Trello.
+
 ## After Execution
 
 Present the output to the user. If `--export` was used, the output is markdown-formatted and can be used as context.

package/commands/ttt-work-on.md

@@ -52,14 +52,18 @@ Arguments:
               'next' claims the highest priority pending task
               'next <n>' claims the top <n> pending tasks
               If omitted, shows interactive multi-select
+              An ID missing from local data (e.g. a Backlog ticket outside
+              the cycle) is fetched from the source, stored locally, and
+              claimed like any other
 
 Options:
   --dry-run   Pick tickets without changing status (preview only)
 ```
 
 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.
+skipped without stopping the rest of the batch. An ID found neither locally nor
+at the source aborts before anything is claimed. Find Backlog tickets first with
+`ttt show --remote --status Backlog --creator me` (or `--user me`), then claim by ID.
 
 ## After Claiming — Delegate the Implementation
 

package/dist/scripts/claim.js

@@ -2,6 +2,8 @@ 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 { sourceIssueToTask } from "./lib/remote-task.js";
+import { mapRemoteToLocalStatus } from "./lib/status-helpers.js";
 import { findTaskByIssueId, getPrioritySortIndex, getSourceType, loadConfig, loadCycleData, loadLocalConfig, saveCycleData, } from "./utils.js";
 const NEXT_ALIASES = ["next", "下一個", "下一個工作"];
 const NO_PENDING_MESSAGE = "✅ 沒有待處理的任務，所有工作已完成或進行中";
@@ -15,6 +17,9 @@ Arguments:
               'next' claims the highest priority pending task
               'next <n>' claims the top <n> pending tasks
               If omitted, shows interactive multi-select
+              An ID missing from local data (e.g. a Backlog ticket outside
+              the cycle) is fetched from the source, stored locally, and
+              claimed like any other
 
 Options:
   --dry-run   Pick tickets without changing status (preview only)
@@ -88,24 +93,65 @@ function selectNext(countArg, pendingTasks) {
     console.log(`Auto-selected: ${ids.join(", ")}`);
     return ids;
 }
-/** Resolve the requested tickets, exiting if any ID is unknown. */
-function resolveTasks(data, issueIds) {
+/**
+ * Fetch a ticket that local data does not hold. Returns null when the source
+ * is unreachable or has no such ticket; the caller aborts the batch.
+ */
+async function fetchRemoteTask(issueId, config, localConfig) {
+    try {
+        const adapter = createAdapter(config);
+        const issue = await adapter.searchIssue(issueId);
+        if (!issue)
+            return null;
+        const task = sourceIssueToTask(issue, getSourceType(config));
+        task.localStatus = mapRemoteToLocalStatus(task.status, getStatusTransitions(config), localConfig);
+        // Closed states are named per team ("Canceled", "Duplicate", ...), so
+        // the configured done name alone misses them; the state type does not.
+        const teamId = config.teams[localConfig.team]?.id;
+        if (task.localStatus === "pending" && teamId) {
+            const statuses = await adapter.getStatuses(teamId);
+            const type = statuses.find((s) => s.name === task.status)?.type;
+            if (type === "completed" || type === "canceled") {
+                task.localStatus = "completed";
+            }
+        }
+        return task;
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        console.error(`Could not look up ${issueId} remotely: ${message}`);
+        return null;
+    }
+}
+/**
+ * Resolve the requested tickets, exiting if any ID is unknown both locally
+ * and at the source. `fetched` holds the tickets that came from the source so
+ * the caller can store them once it knows they will be claimed.
+ */
+async function resolveTasks(data, issueIds, config, localConfig) {
     const tasks = [];
+    const fetched = new Set();
     const missing = [];
     for (const issueId of issueIds) {
-        const task = findTaskByIssueId(data.tasks, issueId);
-        if (task) {
-            tasks.push(task);
+        const local = findTaskByIssueId(data.tasks, issueId);
+        if (local) {
+            tasks.push(local);
+            continue;
+        }
+        const remote = await fetchRemoteTask(issueId, config, localConfig);
+        if (remote) {
+            tasks.push(remote);
+            fetched.add(remote);
         }
         else {
             missing.push(issueId);
         }
     }
     if (missing.length > 0) {
-        console.error(`Issue ${missing.join(", ")} not found in current cycle. No ticket claimed.`);
+        console.error(`Issue ${missing.join(", ")} not found in local data or at the source (use the full ID, e.g. MP-123). No ticket claimed.`);
         process.exit(1);
     }
-    return tasks;
+    return { tasks, fetched };
 }
 function decide(task) {
     switch (task.localStatus) {
@@ -211,14 +257,27 @@ async function claim() {
     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 resolved = await resolveTasks(data, issueIds, config, localConfig);
+    const outcomes = resolved.tasks.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);
+    // Fetched tickets are stored when they are claimed or already in progress,
+    // so a later `ttt done` finds them; a dry run or a skipped ticket leaves
+    // local data untouched.
+    if (!dryRun) {
+        const toStore = outcomes
+            .filter((o) => resolved.fetched.has(o.task) && o.action !== "skip")
+            .map((o) => o.task);
+        data.tasks.push(...toStore);
+        if (toClaim.length > 0) {
+            await applyClaims(toClaim, data, config, localConfig);
+        }
+        else if (toStore.length > 0) {
+            await saveCycleData(data);
+        }
     }
     // Display task info
     const icon = dryRun ? "🔍" : "👷";

package/dist/scripts/create.d.ts

@@ -1,2 +1,10 @@
 #!/usr/bin/env bun
+import type { SourceLabel } from "./lib/adapters/types.js";
+import { type Config } from "./utils.js";
+/**
+ * Resolve `-l` names to label ids. Config is checked first (key or display
+ * name); anything it does not know is looked up live in the source, so a
+ * label added after `ttt init` still works.
+ */
+export declare function resolveLabelIds(config: Config, labelArg: string | undefined, fetchSourceLabels: () => Promise<SourceLabel[]>): Promise<string[] | undefined>;
 export declare function create(args?: string[]): Promise<void>;

package/dist/scripts/create.js

@@ -95,20 +95,50 @@ async function resolveStatusId(config, adapter, teamId, statusName) {
     }
     return target.id;
 }
-function resolveLabelIds(config, labelArg) {
-    if (!labelArg || !config.labels)
+/**
+ * Resolve `-l` names to label ids. Config is checked first (key or display
+ * name); anything it does not know is looked up live in the source, so a
+ * label added after `ttt init` still works.
+ */
+export async function resolveLabelIds(config, labelArg, fetchSourceLabels) {
+    if (!labelArg)
         return undefined;
-    const names = labelArg.split(",").map((n) => n.trim());
+    const names = labelArg
+        .split(",")
+        .map((n) => n.trim())
+        .filter(Boolean);
     const ids = [];
+    const unresolved = [];
     for (const name of names) {
         const lower = name.toLowerCase();
         // Match by config key (e.g. "backend_v3") OR display name (e.g. "Backend-v3")
-        const entry = Object.entries(config.labels).find(([key, l]) => key.toLowerCase() === lower || l.name.toLowerCase() === lower);
+        const entry = Object.entries(config.labels ?? {}).find(([key, l]) => key.toLowerCase() === lower || l.name.toLowerCase() === lower);
         if (entry) {
             ids.push(entry[1].id);
         }
         else {
-            console.error(`Warning: label "${name}" not found in config, skipping.`);
+            unresolved.push(name);
+        }
+    }
+    if (unresolved.length > 0) {
+        let sourceLabels;
+        try {
+            sourceLabels = await fetchSourceLabels();
+        }
+        catch {
+            // Fall through to the config-only warning below
+        }
+        for (const name of unresolved) {
+            const found = sourceLabels?.find((l) => l.name.toLowerCase() === name.toLowerCase());
+            if (found) {
+                ids.push(found.id);
+            }
+            else if (sourceLabels) {
+                console.error(`Warning: label "${name}" not found in config or in the source, skipping. Available: ${sourceLabels.map((l) => l.name).join(", ")}`);
+            }
+            else {
+                console.error(`Warning: label "${name}" not found in config (source lookup failed), skipping.`);
+            }
         }
     }
     return ids.length > 0 ? ids : undefined;
@@ -216,7 +246,7 @@ Examples:
     }
     const assigneeId = resolveAssigneeId(config, assigneeKey);
     const statusId = await resolveStatusId(config, adapter, teamId, sourceType === "trello" && !statusName ? "todo" : statusName);
-    const labelIds = resolveLabelIds(config, labelArg);
+    const labelIds = await resolveLabelIds(config, labelArg, () => adapter.getLabels(teamId));
     const parentSourceId = await resolveParentSourceId(adapter, parentId);
     const currentCycle = await adapter.getCurrentCycle(teamId);
     const options = {

package/dist/scripts/done-job.js

@@ -5,6 +5,7 @@
  */
 import { input, select } from "@inquirer/prompts";
 import { handleLinearCompletion, handleTrelloCompletion, parseArgs, printHelp, } from "./lib/done/index.js";
+import { describeNotInProgress, syncUntilStatus, } from "./lib/done/status-check.js";
 import { getLatestCommit } from "./lib/git.js";
 import { fetchIssueDetail, syncSingleIssue } from "./lib/sync.js";
 import { findTaskByIssueId, getSourceType, loadConfig, loadCycleData, loadLocalConfig, saveCycleData, } from "./utils.js";
@@ -14,7 +15,7 @@ async function doneJob() {
         printHelp();
         process.exit(0);
     }
-    const { issueId: argIssueId, message: argMessage, fromRemote, } = parseArgs(args);
+    const { issueId: argIssueId, message: argMessage, fromRemote, commit: commitRef, repo, } = parseArgs(args);
     let issueId = argIssueId;
     const config = await loadConfig();
     const localConfig = await loadLocalConfig();
@@ -45,7 +46,9 @@ async function doneJob() {
         }
         // Find in-progress tasks
         const inProgressTasks = data.tasks.filter((t) => t.localStatus === "in-progress");
-        if (inProgressTasks.length === 0) {
+        // With an explicit issue ID, fall through so the status guard below can
+        // say why that ticket cannot be completed
+        if (inProgressTasks.length === 0 && !issueId) {
             console.log("沒有進行中的任務");
             process.exit(0);
         }
@@ -87,13 +90,17 @@ async function doneJob() {
             process.exit(1);
         }
         if (localTask.localStatus !== "in-progress") {
-            console.log(`⚠️ 任務 ${localTask.id} 不在進行中狀態 (目前: ${localTask.localStatus})`);
+            console.error(describeNotInProgress(localTask));
             process.exit(1);
         }
         task = localTask;
     }
-    // Get latest commit
-    const commit = getLatestCommit();
+    // Get the commit to record: HEAD by default, or the one named with --commit
+    const commit = getLatestCommit({ ref: commitRef, cwd: repo });
+    if ((commitRef || repo) && !commit) {
+        console.error(`Cannot read commit ${commitRef ?? "HEAD"} from ${repo ?? "the current directory"}. Nothing was changed.`);
+        process.exit(1);
+    }
     // Get AI summary message
     let promptMessage = argMessage || "";
     if (!promptMessage && process.stdin.isTTY) {
@@ -135,16 +142,18 @@ async function doneJob() {
     }
     // Sync full issue data from remote (including new comment)
     if (sourceType === "linear") {
-        const syncedTask = await syncSingleIssue(task.id, {
+        // Let remote status determine local status; wait out read-after-write lag
+        // so a stale read is not recorded as the local state
+        const syncedTask = await syncUntilStatus(() => syncSingleIssue(task.id, {
             config,
             localConfig,
-            preserveLocalStatus: false, // Let remote status determine local status
-        });
+            preserveLocalStatus: false,
+        }), completionResult?.status);
         if (syncedTask) {
             console.log(`Synced: ${syncedTask.id} → ${syncedTask.status} (local: ${syncedTask.localStatus})`);
             if (completionResult?.status &&
                 syncedTask.status !== completionResult.status) {
-                console.error(`Remote status verification failed for ${task.id}: expected ${completionResult.status}, got ${syncedTask.status}.`);
+                console.error(`Remote status verification failed for ${task.id}: expected ${completionResult.status}, got ${syncedTask.status}. Another actor (e.g. a Git integration or automation) may have changed it; check the issue in Linear.`);
                 process.exit(1);
             }
         }
@@ -177,4 +186,7 @@ async function doneJob() {
     }
     console.log(`\n🎉 任務完成！`);
 }
-doneJob().catch(console.error);
+doneJob().catch((error) => {
+    console.error(error instanceof Error ? error.message : error);
+    process.exitCode = 1;
+});

package/dist/scripts/lib/adapters/linear-adapter.js

@@ -54,8 +54,13 @@ export class LinearAdapter {
         }));
     }
     async getLabels(teamId) {
+        // Workspace-level labels have no team, so a team-only filter misses them
+        // even though they can be attached to this team's issues
         const labelsData = await this.client.issueLabels({
-            filter: { team: { id: { eq: teamId } } },
+            filter: {
+                or: [{ team: { id: { eq: teamId } } }, { team: { null: true } }],
+            },
+            first: 250,
         });
         return labelsData.nodes.map((label) => ({
             id: label.id,
@@ -92,6 +97,21 @@ export class LinearAdapter {
         if (options.assigneeEmails && options.assigneeEmails.length > 0) {
             filter.assignee = { email: { in: options.assigneeEmails } };
         }
+        if (options.creator?.emails && options.creator.emails.length > 0) {
+            filter.creator = {
+                email: { in: options.creator.emails },
+            };
+        }
+        else if (options.creator?.match) {
+            const needle = options.creator.match;
+            filter.creator = {
+                or: [
+                    { name: { containsIgnoreCase: needle } },
+                    { displayName: { containsIgnoreCase: needle } },
+                    { email: { containsIgnoreCase: needle } },
+                ],
+            };
+        }
         const page = await fetchIssuesPaged(this.client, filter, "fetch issues", options.limit ?? MAX_FETCHED_ISSUES);
         const issues = [];
         const excludeLabels = new Set(options.excludeLabels ?? []);

package/dist/scripts/lib/adapters/trello-adapter.js

@@ -73,6 +73,9 @@ export class TrelloAdapter {
         return null;
     }
     async getIssues(options) {
+        if (options.creator) {
+            throw new Error("Trello cards do not expose a creator, so a creator filter is not supported.");
+        }
         const cards = await this.client.getBoardCards(options.teamId);
         // Ensure lists are cached
         if (!this.listsCache.has(options.teamId)) {

package/dist/scripts/lib/adapters/types.d.ts

@@ -87,6 +87,14 @@ export interface SourceIssue {
     attachments?: SourceAttachment[];
     comments?: SourceComment[];
 }
+/**
+ * Who created an issue. `emails` matches exactly (OR logic); `match` is a
+ * case-insensitive substring over the creator's name, display name and email.
+ */
+export interface CreatorFilter {
+    emails?: string[];
+    match?: string;
+}
 /**
  * Options for fetching issues
  */
@@ -96,6 +104,7 @@ export interface GetIssuesOptions {
     statusNames?: string[];
     labelNames?: string[];
     assigneeEmails?: string[];
+    creator?: CreatorFilter;
     excludeLabels?: string[];
     limit?: number;
 }