team-toon-tack 3.11.0 → 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.11.0"
+			"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.11.0",
+	"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.11.0",
+	"version": "3.12.0",
 	"description": "透過 ttt CLI 同步與管理 Linear、Trello 任務。",
 	"author": {
 		"name": "wayne930242"

package/README.md

@@ -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`
 
@@ -213,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

@@ -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`
 
@@ -213,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-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/lib/adapters/linear-adapter.js

@@ -97,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;
 }

package/dist/scripts/lib/remote-task.d.ts

@@ -0,0 +1,4 @@
+import type { Task } from "../utils.js";
+import type { SourceIssue, TaskSourceType } from "./adapters/index.js";
+/** Build a local Task from an issue fetched live from the source. */
+export declare function sourceIssueToTask(issue: SourceIssue, sourceType: TaskSourceType): Task;

package/dist/scripts/lib/remote-task.js

@@ -0,0 +1,30 @@
+/** Build a local Task from an issue fetched live from the source. */
+export function sourceIssueToTask(issue, sourceType) {
+    return {
+        id: issue.id,
+        linearId: issue.sourceId,
+        sourceId: issue.sourceId,
+        sourceType,
+        title: issue.title,
+        status: issue.status,
+        localStatus: "pending",
+        assignee: issue.assigneeEmail,
+        priority: issue.priority,
+        labels: issue.labels,
+        description: issue.description,
+        parentIssueId: issue.parentIssueId,
+        url: issue.url,
+        attachments: issue.attachments?.map((a) => ({
+            id: a.id,
+            title: a.title,
+            url: a.url,
+            sourceType: a.sourceType,
+        })),
+        comments: issue.comments?.map((c) => ({
+            id: c.id,
+            body: c.body,
+            createdAt: c.createdAt,
+            user: c.user,
+        })),
+    };
+}

package/dist/scripts/show.js

@@ -1,6 +1,7 @@
-import { createAdapter } from "./lib/adapters/index.js";
+import { createAdapter, } from "./lib/adapters/index.js";
 import { displayTaskFull, getStatusIcon, PRIORITY_LABELS, } from "./lib/display.js";
 import { getStatusTransitions } from "./lib/linear.js";
+import { sourceIssueToTask } from "./lib/remote-task.js";
 import { getSyncStatuses } from "./lib/status-helpers.js";
 import { getSourceType, getUserEmails, loadConfig, loadCycleData, loadLocalConfig, } from "./utils.js";
 function taskToMarkdown(task, includeLocal = true) {
@@ -106,33 +107,7 @@ async function fetchIssueFromRemote(issueId) {
     if (!issue) {
         return null;
     }
-    return {
-        id: issue.id,
-        linearId: issue.sourceId,
-        sourceId: issue.sourceId,
-        sourceType,
-        title: issue.title,
-        status: issue.status,
-        localStatus: "pending",
-        assignee: issue.assigneeEmail,
-        priority: issue.priority,
-        labels: issue.labels,
-        description: issue.description,
-        parentIssueId: issue.parentIssueId,
-        url: issue.url,
-        attachments: issue.attachments?.map((a) => ({
-            id: a.id,
-            title: a.title,
-            url: a.url,
-            sourceType: a.sourceType,
-        })),
-        comments: issue.comments?.map((c) => ({
-            id: c.id,
-            body: c.body,
-            createdAt: c.createdAt,
-            user: c.user,
-        })),
-    };
+    return sourceIssueToTask(issue, sourceType);
 }
 function resolveAssigneeScope(requested, userEmails) {
     const emails = userEmails.map((e) => e.toLowerCase());
@@ -145,6 +120,31 @@ function resolveAssigneeScope(requested, userEmails) {
     }
     return { kind: "match", needle: value };
 }
+/**
+ * Turn `--creator` into an API filter. "me" resolves to the configured
+ * current_user emails, an address matches exactly, anything else is a
+ * case-insensitive substring over the creator's name and email.
+ */
+function resolveCreatorFilter(requested, userEmails) {
+    const value = requested.trim();
+    if (value.toLowerCase() === "me") {
+        return userEmails.length > 0
+            ? { emails: userEmails }
+            : {
+                error: '--creator me needs a current_user with an email. Run "ttt init" or pass an email/name.',
+            };
+    }
+    if (value.includes("@"))
+        return { emails: [value] };
+    return value ? { match: value } : { error: "--creator needs a value." };
+}
+/**
+ * Backlog tickets usually sit outside every cycle, so asking for a backlog
+ * status lifts the cycle scope instead of silently returning nothing.
+ */
+function statusImpliesNoCycle(matched) {
+    return matched.some((s) => s.type === "backlog" || s.name.toLowerCase().includes("backlog"));
+}
 /** True when the scope reaches outside what `ttt sync` stored locally. */
 function scopeEscapesLocalCache(scope, userEmails) {
     return userEmails.length > 0 && scope.kind !== "user";
@@ -195,7 +195,7 @@ function expandNames(needle, available) {
     const matches = available.filter((name) => name.toLowerCase().includes(lower));
     return matches.length > 0 ? matches : null;
 }
-async function searchIssuesFromRemote(filters, scope) {
+async function searchIssuesFromRemote(filters, scope, creator) {
     const config = await loadConfig();
     const localConfig = await loadLocalConfig();
     const adapter = createAdapter(config);
@@ -210,12 +210,16 @@ async function searchIssuesFromRemote(filters, scope) {
     // the scope is what `ttt sync` stores, so an unfiltered --remote search
     // answers the same question as the unfiltered local one.
     let statusNames = getSyncStatuses(getStatusTransitions(config));
+    let noCycleScope = !!filters.anyCycle;
     if (filters.status) {
         const statuses = await adapter.getStatuses(teamId);
         const expanded = expandNames(filters.status, statuses.map((s) => s.name));
         if (!expanded)
             return [];
         statusNames = expanded;
+        if (statusImpliesNoCycle(statuses.filter((s) => expanded.includes(s.name)))) {
+            noCycleScope = true;
+        }
     }
     let labelNames;
     if (filters.label) {
@@ -227,10 +231,11 @@ async function searchIssuesFromRemote(filters, scope) {
     }
     const issues = await adapter.getIssues({
         teamId,
-        cycleId: config.current_cycle?.id,
+        cycleId: noCycleScope ? undefined : config.current_cycle?.id,
         statusNames,
         labelNames,
         assigneeEmails: scope.kind === "user" ? scope.emails : undefined,
+        creator,
     });
     const tasks = issues.map((issue) => ({
         id: issue.id,
@@ -278,11 +283,16 @@ Options:
   --status <status> Filter by status
   --user <email>    Filter by assignee (use "me" for yourself, "unassigned" for no assignee)
   --priority <n>    Filter by priority (0=None, 1=Urgent, 2=High, 3=Medium, 4=Low)
+  --creator <who>   Filter by creator: "me", an email, or a name (needs --remote,
+                    Linear only). Without --user, the assignee scope is lifted so
+                    tickets you created for others or left unassigned show up.
+  --any-cycle       Search outside the current cycle (needs --remote)
 
 Searches are scoped the same way ttt sync is: current cycle, current_user,
 and Todo/In Progress. --status and --user replace the corresponding scope.
-The local cache only holds current_user's issues, so searching another
-assignee needs --remote.
+--status Backlog also lifts the cycle scope, since backlog tickets usually
+belong to no cycle. The local cache only holds current_user's issues, so
+searching another assignee needs --remote.
 
 Examples:
   ttt show                       # Show all issues in local cycle data
@@ -293,6 +303,9 @@ Examples:
   ttt show --status "In Progress" --user me   # My in-progress issues
   ttt show --priority 1          # Show all urgent issues
   ttt show --user tony --remote  # Someone else's issues (needs --remote)
+  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
   ttt show --export              # Export all issues as markdown`);
         process.exit(0);
     }
@@ -317,6 +330,18 @@ Examples:
         else if (arg === "--priority" && args[i + 1]) {
             filters.priority = parseInt(args[++i], 10);
         }
+        else if (arg === "--creator") {
+            const value = args[i + 1];
+            if (!value || value.startsWith("-")) {
+                console.error("--creator needs a value: me, an email, or a name.");
+                process.exit(1);
+            }
+            filters.creator = args[++i];
+        }
+        else if (arg === "--any-cycle") {
+            filters.anyCycle = true;
+            continue;
+        }
         else {
             continue;
         }
@@ -326,18 +351,46 @@ Examples:
     const issueId = args.find((arg, i) => !optionValues.has(i) &&
         !arg.startsWith("-") &&
         (arg.match(/^[A-Z]+-\d+$/i) || arg.match(/^[A-Za-z0-9]{8,}$/)));
+    const remoteOnlyFlag = filters.creator
+        ? "--creator"
+        : filters.anyCycle
+            ? "--any-cycle"
+            : undefined;
+    if (remoteOnlyFlag && (!useRemote || issueId)) {
+        console.error(issueId
+            ? `${remoteOnlyFlag} only applies to searches, not to a single issue.`
+            : `${remoteOnlyFlag} needs --remote: the local cache holds neither creators nor issues outside the cycle.`);
+        process.exit(1);
+    }
     // List mode: no specific issue ID. Filters are optional; --remote runs the
     // same query live instead of reading the cache.
     if (!issueId) {
         const userEmails = await getUserEmails();
-        const scope = resolveAssigneeScope(filters.assignee, userEmails);
+        // A creator search is about tickets nobody may have assigned to the user,
+        // so it must not inherit the default current_user assignee scope.
+        const scope = filters.creator && !filters.assignee
+            ? { kind: "any" }
+            : resolveAssigneeScope(filters.assignee, userEmails);
         let tasks;
         if (useRemote) {
             const config = await loadConfig();
             const sourceType = getSourceType(config);
             const sourceName = sourceType === "trello" ? "Trello" : "Linear";
+            let creator;
+            if (filters.creator) {
+                if (sourceType === "trello") {
+                    console.error("--creator is not supported for Trello: cards do not expose a creator.");
+                    process.exit(1);
+                }
+                const resolved = resolveCreatorFilter(filters.creator, userEmails);
+                if ("error" in resolved) {
+                    console.error(resolved.error);
+                    process.exit(1);
+                }
+                creator = resolved;
+            }
             console.error(`Searching issues from ${sourceName}...`);
-            tasks = await searchIssuesFromRemote(filters, scope);
+            tasks = await searchIssuesFromRemote(filters, scope, creator);
         }
         else {
             const data = await loadCycleData();

package/dist/scripts/test-support/linear-mock.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/scripts/test-support/linear-mock.js

@@ -0,0 +1,87 @@
+/**
+ * Preloaded (`bun --preload`) into CLI subprocesses so they talk to a fake
+ * Linear. Each GraphQL request is appended to MOCK_LINEAR_LOG as one JSON line
+ * `{ name, variables }`, which lets tests assert on what the CLI asked for.
+ */
+import { appendFileSync } from "node:fs";
+const STATES = [
+    { id: "s-backlog", name: "Backlog", type: "backlog" },
+    { id: "s-todo", name: "Todo", type: "unstarted" },
+    { id: "s-progress", name: "In Progress", type: "started" },
+    { id: "s-canceled", name: "Canceled", type: "canceled" },
+];
+const ISSUE = {
+    __typename: "Issue",
+    id: "uuid-backlog-7",
+    identifier: "MP-7",
+    title: "Backlog follow-up",
+    priority: 3,
+    branchName: "mp-7",
+    url: "https://linear.app/x/issue/MP-7",
+    team: { id: "team-dev" },
+    // MOCK_LINEAR_ISSUE_STATE picks the workflow state the fake MP-7 sits in.
+    state: { id: process.env.MOCK_LINEAR_ISSUE_STATE ?? "s-backlog" },
+    labelIds: [],
+    previousIdentifiers: [],
+    reactionData: [],
+    reactions: [],
+};
+const page = (name, nodes) => ({
+    [name]: {
+        __typename: "Connection",
+        nodes,
+        pageInfo: { hasNextPage: false, endCursor: null },
+    },
+});
+function respond(query, variables = {}) {
+    if (query.includes("query workflowStates(")) {
+        return page("workflowStates", STATES.map((s) => ({ __typename: "WorkflowState", ...s })));
+    }
+    if (query.includes("query workflowState(")) {
+        return {
+            workflowState: {
+                __typename: "WorkflowState",
+                ...(STATES.find((s) => s.id === variables.id) ?? STATES[0]),
+            },
+        };
+    }
+    if (query.includes("query issues(")) {
+        return page("issues", [ISSUE]);
+    }
+    if (query.includes("query searchIssues(")) {
+        return {
+            searchIssues: {
+                __typename: "IssueSearchPayload",
+                totalCount: 1,
+                archivePayload: { __typename: "ArchiveResponse", archive: null },
+                pageInfo: { hasNextPage: false, endCursor: null },
+                nodes: [ISSUE],
+            },
+        };
+    }
+    if (query.includes("query issue("))
+        return { issue: ISSUE };
+    if (query.includes("query issueLabels("))
+        return page("issueLabels", []);
+    if (query.includes("mutation") && query.includes("issueUpdate")) {
+        return {
+            issueUpdate: { __typename: "IssuePayload", success: true, issue: ISSUE },
+        };
+    }
+    // Empty relation connections: `query issue_labels(`, `issue_comments(`, ...
+    const relation = /query issue_(\w+)\(/.exec(query)?.[1];
+    if (relation)
+        return { issue: page(relation, []) };
+    throw new Error(`Unmocked Linear query: ${query.slice(0, 80)}`);
+}
+globalThis.fetch = (async (_input, init) => {
+    const body = JSON.parse(String(init?.body));
+    const name = /(?:query|mutation)\s+(\w+)/.exec(body.query)?.[1];
+    if (process.env.MOCK_LINEAR_LOG) {
+        appendFileSync(process.env.MOCK_LINEAR_LOG, `${JSON.stringify({ name, variables: body.variables })}\n`);
+    }
+    return new Response(JSON.stringify({ data: respond(String(body.query), body.variables) }), {
+        status: 200,
+        headers: { "Content-Type": "application/json" },
+    });
+});

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "team-toon-tack",
-	"version": "3.11.0",
+	"version": "3.12.0",
 	"description": "Linear & Trello task sync & management CLI with TOON format",
 	"type": "module",
 	"bin": {

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

@@ -44,9 +44,12 @@ 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 show --remote --status Backlog --creator me  # Backlog tickets I created (any cycle)
+ttt show --remote --status Backlog --user me     # Backlog tickets assigned to me
 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 claim MP-700            # Not in local data (e.g. Backlog)? Fetched from remote, then claimed
 ttt create                  # Create new issue (interactive)
 ttt create -t "Title" -p 2  # Quick create with flags
 ttt assign MP-624 -a john   # Reassign issue