team-toon-tack 3.4.1 → 3.5.0

package/.claude-plugin/marketplace.json

@@ -6,14 +6,14 @@
 	},
 	"metadata": {
 		"description": "Task management tools for Claude Code - supports Linear and Trello, efficient workflow without MCP overhead",
-		"version": "1.0.1"
+		"version": "1.1.0"
 	},
 	"plugins": [
 		{
 			"name": "team-toon-tack",
 			"source": "./",
 			"description": "Linear/Trello task sync & management CLI with commands and skills",
-			"version": "2.6.1"
+			"version": "2.7.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": "2.6.1",
+	"version": "2.7.0",
 	"author": {
 		"name": "wayne930242",
 		"email": "wayne930242@gmail.com"

package/commands/ttt-assign.md

@@ -0,0 +1,59 @@
+---
+name: ttt:assign
+description: Reassign a Linear/Trello issue to a different user
+arguments:
+  - name: issue-id
+    description: Issue ID to reassign (omit for current in-progress task)
+    required: false
+  - name: assignee
+    description: User key from config (omit for interactive select)
+    required: false
+---
+
+<law>
+YOU MUST execute the `ttt assign` command using the Bash tool.
+DO NOT call Linear/Trello APIs directly — the CLI handles adapter selection and local cache updates.
+</law>
+
+# /ttt:assign — Reassign Issue
+
+## Execution
+
+```bash
+ttt assign {{ issue-id }} -a {{ assignee }}
+```
+
+### Common Examples
+
+```bash
+ttt assign MP-123 -a john     # Assign MP-123 to john
+ttt assign -a jane            # Assign current in-progress task to jane
+ttt assign MP-123             # Interactive assignee selection
+```
+
+## Full CLI Reference
+
+```
+Usage: ttt assign [issue-id] [-a <user-key>]
+
+Arguments:
+  issue-id                Optional. Issue ID (omit for current task)
+
+Options:
+  -a, --assignee <key>    User key from config. If omitted, interactive select.
+```
+
+## After Execution
+
+Report:
+- Issue ID and new assignee display name
+- Confirmation that local cache was updated
+
+## Error Handling
+
+| Error | Solution |
+|-------|----------|
+| `No in-progress task found` | Specify issue ID explicitly |
+| `User "<key>" not found` | Check key against `config.users` |
+| `Issue not found` | Verify issue exists in Linear/Trello |
+| `No source ID` | Issue has no remote ID — run `ttt sync` first |

package/commands/ttt-cancel.md

@@ -0,0 +1,64 @@
+---
+name: ttt:cancel
+description: Cancel a Linear/Trello issue (moves to Cancelled status)
+arguments:
+  - name: issue-id
+    description: Issue ID to cancel (required)
+    required: true
+  - name: flags
+    description: "Optional: --yes to skip confirmation"
+    required: false
+---
+
+<law>
+YOU MUST execute the `ttt cancel` command using the Bash tool.
+DO NOT call Linear/Trello APIs directly — the CLI handles adapter selection and cache removal.
+Always confirm with the user before cancelling unless they explicitly pass `--yes`.
+</law>
+
+# /ttt:cancel — Cancel Issue
+
+## Execution
+
+```bash
+ttt cancel {{ issue-id }} {{ flags }}
+```
+
+### Common Examples
+
+```bash
+ttt cancel MP-123           # Cancel with interactive confirmation
+ttt cancel MP-123 --yes     # Cancel without confirmation prompt
+```
+
+## Full CLI Reference
+
+```
+Usage: ttt cancel <issue-id> [--yes]
+
+Arguments:
+  issue-id    Issue ID to cancel (e.g., MP-123)
+
+Options:
+  -y, --yes   Skip confirmation prompt
+```
+
+## Behavior
+
+- Finds the team's "Cancelled" workflow state automatically
+- Removes the task from local `cycle.toon` if it was present
+- Remote-only issues (not in local cache) are cancelled but no local change is made
+
+## After Execution
+
+Report:
+- Issue ID and cancellation confirmation
+- Whether it was removed from local cycle data
+
+## Error Handling
+
+| Error | Solution |
+|-------|----------|
+| `Issue ID is required` | Provide the issue ID as argument |
+| `Issue not found` | Verify the ID exists in Linear/Trello |
+| `No 'cancelled' workflow state found` | Team has no Cancelled state configured in Linear |

package/commands/ttt-create.md

@@ -0,0 +1,69 @@
+---
+name: ttt:create
+description: Create a new Linear/Trello issue and add to local cycle data
+arguments:
+  - name: title
+    description: Issue title (omit to prompt interactively)
+    required: false
+  - name: flags
+    description: "Additional flags: -d <desc>, -a <assignee>, -p <0-4>, -l <labels>, -s <status>, --parent <id>"
+    required: false
+---
+
+<law>
+YOU MUST execute the `ttt create` command using the Bash tool.
+DO NOT call Linear/Trello APIs directly — the CLI handles adapter selection and local cache updates.
+DO NOT manually edit `.ttt/` files.
+</law>
+
+# /ttt:create — Create New Issue
+
+## Execution
+
+```bash
+ttt create -t "{{ title }}" {{ flags }}
+```
+
+If no title is provided, run `ttt create` alone for interactive mode.
+
+### Common Examples
+
+```bash
+ttt create                                   # Interactive mode
+ttt create -t "Fix login bug" -p 2           # Quick create, high priority
+ttt create -t "Subtask" --parent MP-100      # Create as child issue
+ttt create -t "New" -a john -l frontend,bug  # With assignee and labels
+```
+
+## Full CLI Reference
+
+```
+Usage: ttt create [options]
+
+Options:
+  -t, --title <text>       Issue title (required unless interactive)
+  -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)
+  -s, --status <name>      Initial status name
+  --parent <id>            Parent issue identifier (e.g., MP-100)
+  --no-interactive         Skip interactive prompts
+```
+
+## After Execution
+
+Report:
+- Created issue ID and title
+- URL if available
+- Confirmation that local cycle data was updated
+
+## Error Handling
+
+| Error | Solution |
+|-------|----------|
+| `Title is required when --no-interactive is set` | Provide `-t "title"` |
+| `Priority must be 0-4` | Use valid priority value |
+| `User "<key>" not found` | Check assignee key against `config.users` |
+| `Parent issue "<id>" not found` | Verify parent exists in Linear/Trello |
+| `Warning: label "<name>" not found` | Label not in config — will be skipped |

package/commands/ttt-edit.md

@@ -0,0 +1,69 @@
+---
+name: ttt:edit
+description: Edit fields (title, description, priority, labels) of a Linear/Trello issue
+arguments:
+  - name: issue-id
+    description: Issue ID to edit (omit for current in-progress task)
+    required: false
+  - name: flags
+    description: "Field flags: -t <title>, -d <desc>, -p <0-4>, -l <labels>"
+    required: false
+---
+
+<law>
+YOU MUST execute the `ttt edit` command using the Bash tool.
+DO NOT call Linear/Trello APIs directly — the CLI handles adapter selection and cache refresh.
+After a successful edit, the CLI automatically refreshes the local cycle cache from remote.
+</law>
+
+# /ttt:edit — Edit Issue Fields
+
+## Execution
+
+```bash
+ttt edit {{ issue-id }} {{ flags }}
+```
+
+If no flags are provided, interactive mode prompts you to choose which fields to change.
+
+### Common Examples
+
+```bash
+ttt edit MP-123 -t "New title"            # Update title only
+ttt edit MP-123 -p 2                      # Set priority to high
+ttt edit MP-123 -l frontend,urgent        # Replace labels (comma-separated)
+ttt edit -t "Updated" -p 3                # Edit current task
+ttt edit MP-123                           # Interactive field selection
+```
+
+## Full CLI Reference
+
+```
+Usage: ttt edit [issue-id] [options]
+
+Arguments:
+  issue-id                  Optional. Issue ID (omit for current task)
+
+Options:
+  -t, --title <text>        New title
+  -d, --description <text>  New description (empty string clears it)
+  -p, --priority <0-4>      New priority (0=none, 1=urgent, 2=high, 3=medium, 4=low)
+  -l, --label <names>       Set labels (comma-separated, replaces existing)
+  --no-interactive          Skip interactive prompts
+```
+
+## After Execution
+
+Report:
+- Issue ID and which fields were updated
+- Confirmation that local cache was refreshed from remote
+
+## Error Handling
+
+| Error | Solution |
+|-------|----------|
+| `Priority must be 0-4` | Use valid priority value |
+| `No in-progress task` | Specify issue ID |
+| `Issue not found` | Verify the ID exists in Linear/Trello |
+| `Warning: label "<name>" not found` | Label missing from config — will be skipped |
+| `Warning: remote update succeeded but failed to refresh local cache` | Run `ttt sync` to reconcile |

package/dist/bin/cli.js

@@ -15,6 +15,10 @@ const COMMANDS = [
     "status",
     "show",
     "comment",
+    "create",
+    "assign",
+    "edit",
+    "cancel",
     "config",
     "help",
     "version",
@@ -35,6 +39,10 @@ COMMANDS:
   status     Show or modify task status
   show       Show issue details or search issues by filters
   comment    Add a comment to an issue
+  create     Create a new issue
+  assign     Reassign an issue to a user
+  edit       Edit issue fields (title, description, priority, labels)
+  cancel     Cancel an issue
   config     Configure settings (status mappings, filters)
   help       Show this help message
   version    Show version
@@ -141,6 +149,22 @@ async function main() {
                 process.argv = ["node", "comment.js", ...commandArgs];
                 await importScript("comment.js");
                 break;
+            case "create":
+                process.argv = ["node", "create.js", ...commandArgs];
+                await importScript("create.js");
+                break;
+            case "assign":
+                process.argv = ["node", "assign.js", ...commandArgs];
+                await importScript("assign.js");
+                break;
+            case "edit":
+                process.argv = ["node", "edit.js", ...commandArgs];
+                await importScript("edit.js");
+                break;
+            case "cancel":
+                process.argv = ["node", "cancel.js", ...commandArgs];
+                await importScript("cancel.js");
+                break;
             case "config":
                 process.argv = ["node", "config.js", ...commandArgs];
                 await importScript("config.js");

package/dist/scripts/assign.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env bun
+export {};

package/dist/scripts/assign.js

@@ -0,0 +1,120 @@
+#!/usr/bin/env bun
+import { select } from "@inquirer/prompts";
+import { createAdapter } from "./lib/adapters/index.js";
+import { getSourceType, getTaskSourceId, loadConfig, loadCycleData, saveCycleData, } from "./utils.js";
+function parseArgs(args) {
+    let issueId;
+    let assignee;
+    for (let i = 0; i < args.length; i++) {
+        const arg = args[i];
+        if (arg === "-a" || arg === "--assignee") {
+            assignee = args[++i];
+        }
+        else if (!arg.startsWith("-") && !issueId) {
+            issueId = arg;
+        }
+    }
+    return { issueId, assignee };
+}
+async function findTask(issueId, config) {
+    const cycleData = await loadCycleData();
+    if (!issueId) {
+        if (!cycleData) {
+            console.error("No cycle data found. Run ttt sync first.");
+            process.exit(1);
+        }
+        const inProgress = cycleData.tasks.find((t) => t.localStatus === "in-progress");
+        if (!inProgress) {
+            console.error("No in-progress task found. Specify issue ID.");
+            process.exit(1);
+        }
+        return inProgress;
+    }
+    const localTask = cycleData?.tasks.find((t) => t.id === issueId || t.id === issueId.toUpperCase());
+    if (localTask)
+        return localTask;
+    const adapter = createAdapter(config);
+    const issue = await adapter.searchIssue(issueId);
+    if (!issue) {
+        console.error(`Issue ${issueId} not found.`);
+        process.exit(1);
+    }
+    const sourceType = getSourceType(config);
+    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,
+        url: issue.url,
+    };
+}
+async function assign() {
+    const args = process.argv.slice(2);
+    if (args.includes("--help") || args.includes("-h")) {
+        console.log(`Usage: ttt assign [issue-id] [-a <user-key>]
+
+Reassign an issue to a different user.
+
+Arguments:
+  issue-id                Issue ID (e.g., MP-123). If omitted, uses current task.
+
+Options:
+  -a, --assignee <key>    User key from config. If omitted, interactive select.
+
+Examples:
+  ttt assign MP-123 -a john       # Assign MP-123 to john
+  ttt assign -a jane              # Assign current task to jane
+  ttt assign MP-123               # Interactive assignee selection`);
+        process.exit(0);
+    }
+    const parsed = parseArgs(args);
+    const config = await loadConfig();
+    const task = await findTask(parsed.issueId, config);
+    let assigneeKey = parsed.assignee;
+    if (!assigneeKey) {
+        const choices = Object.entries(config.users).map(([key, u]) => ({
+            name: `${u.displayName} (${key})`,
+            value: key,
+        }));
+        assigneeKey = await select({
+            message: `Assign ${task.id} to:`,
+            choices,
+        });
+    }
+    const user = config.users[assigneeKey];
+    if (!user) {
+        console.error(`User "${assigneeKey}" not found.`);
+        console.error(`Available: ${Object.keys(config.users).join(", ")}`);
+        process.exit(1);
+    }
+    const sourceId = getTaskSourceId(task);
+    if (!sourceId) {
+        console.error(`No source ID for ${task.id}.`);
+        process.exit(1);
+    }
+    console.log(`Assigning ${task.id} to ${user.displayName}...`);
+    const adapter = createAdapter(config);
+    const result = await adapter.updateIssue(sourceId, { assigneeId: user.id });
+    if (!result.success) {
+        console.error(`Failed: ${result.error}`);
+        process.exit(1);
+    }
+    console.log(`\n✅ ${task.id} assigned to ${user.displayName}`);
+    const cycleData = await loadCycleData();
+    if (cycleData) {
+        const localTask = cycleData.tasks.find((t) => t.id === task.id);
+        if (localTask) {
+            localTask.assignee = user.email ?? user.displayName;
+            cycleData.updatedAt = new Date().toISOString();
+            await saveCycleData(cycleData);
+            console.log(`   Local cache updated.`);
+        }
+    }
+}
+assign().catch(console.error);

package/dist/scripts/cancel.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env bun
+export {};

package/dist/scripts/cancel.js

@@ -0,0 +1,73 @@
+#!/usr/bin/env bun
+import { confirm } from "@inquirer/prompts";
+import { createAdapter } from "./lib/adapters/index.js";
+import { getTaskSourceId, loadConfig, loadCycleData, removeTaskFromCycleData, } from "./utils.js";
+async function cancel() {
+    const args = process.argv.slice(2);
+    if (args.includes("--help") || args.includes("-h")) {
+        console.log(`Usage: ttt cancel <issue-id> [--yes]
+
+Cancel an issue (moves to Cancelled status in Linear).
+
+Arguments:
+  issue-id    Issue ID (e.g., MP-123)
+
+Options:
+  -y, --yes   Skip confirmation prompt
+
+Examples:
+  ttt cancel MP-123         # Cancel with confirmation
+  ttt cancel MP-123 --yes   # Cancel without confirmation`);
+        process.exit(0);
+    }
+    const issueId = args.find((a) => !a.startsWith("-"));
+    const skipConfirm = args.includes("-y") || args.includes("--yes");
+    if (!issueId) {
+        console.error("Issue ID is required. Usage: ttt cancel <issue-id>");
+        process.exit(1);
+    }
+    const config = await loadConfig();
+    const cycleData = await loadCycleData();
+    const task = cycleData?.tasks.find((t) => t.id === issueId || t.id === issueId.toUpperCase());
+    const displayId = task?.id ?? issueId;
+    const displayTitle = task ? ` (${task.title})` : "";
+    if (!skipConfirm) {
+        const ok = await confirm({
+            message: `Cancel ${displayId}${displayTitle}?`,
+            default: false,
+        });
+        if (!ok) {
+            console.log("Aborted.");
+            process.exit(0);
+        }
+    }
+    let sourceId;
+    const adapter = createAdapter(config);
+    if (task) {
+        sourceId = getTaskSourceId(task);
+    }
+    else {
+        const issue = await adapter.searchIssue(issueId);
+        if (!issue) {
+            console.error(`Issue ${issueId} not found.`);
+            process.exit(1);
+        }
+        sourceId = issue.sourceId;
+    }
+    if (!sourceId) {
+        console.error(`No source ID for ${displayId}.`);
+        process.exit(1);
+    }
+    console.log(`Cancelling ${displayId}...`);
+    const result = await adapter.cancelIssue(sourceId);
+    if (!result.success) {
+        console.error(`Failed: ${result.error}`);
+        process.exit(1);
+    }
+    console.log(`\n✅ ${displayId} cancelled.`);
+    if (cycleData && task) {
+        await removeTaskFromCycleData(task.id, cycleData);
+        console.log(`   Removed from local cycle data.`);
+    }
+}
+cancel().catch(console.error);

package/dist/scripts/create.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env bun
+export {};