team-toon-tack 3.7.5 → 3.7.7

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": "2.8.1"
+			"version": "2.8.5"
 		}
 	]
 }

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.8.1",
+	"version": "2.8.5",
 	"author": {
 		"name": "wayne930242",
 		"email": "wayne930242@gmail.com"

package/commands/ttt-work-on.md

@@ -55,15 +55,18 @@ Skipping phases is not "pragmatic", it is debt.
 
 ### 1. Branch
 
+Check current branch and repo convention first (e.g. recent `git log --oneline -10`, existing branch naming pattern).
+If unclear whether to branch or what name to use, ask the user instead of assuming.
+
 ```bash
-git checkout -b <suggested-branch-name>
+git checkout -b <branch-name-matching-user-convention>
 ```
 
 ### 2. Plan
 
 Scope decides depth.
 
-- Unclear requirements or 3+ files touched → invoke `superpowers:brainstorming`, then `superpowers:writing-plans`.
+- Unclear requirements or 3+ files touched → if your environment has a brainstorming/planning skill, use it; otherwise clarify scope with the user and write a short plan before coding.
 - Clear and small (≤2 files, obvious change) → state a 2–3 bullet plan inline before coding.
 
 Never go straight to code.
@@ -71,8 +74,6 @@ Planning collapses ambiguity before implementation.
 
 ### 3. Test First (TDD)
 
-Invoke `superpowers:test-driven-development`.
-
 Red → Green → Refactor per behavior:
 
 1. Write one failing test naming the behavior.
@@ -85,9 +86,7 @@ No production code without a failing test first.
 
 ### 4. Review (before `/ttt:done`)
 
-Invoke `superpowers:verification-before-completion`.
-
-Run and confirm output:
+Verify before claiming completion — run and confirm output:
 
 - Full test suite passes.
 - `npm run lint` / `npm run type` clean (or project-specific commands).

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

@@ -59,7 +59,7 @@ Skipping phases is debt, not pragmatism.
 
 ## 1. Plan
 
-- Unclear scope or 3+ files → use `superpowers:brainstorming` → `superpowers:writing-plans`.
+- Unclear scope or 3+ files → use a brainstorming/planning skill if your environment has one, else clarify scope with the user first.
 - Small, clear change → state a 2–3 bullet plan inline before coding.
 
 Branch naming:
@@ -69,7 +69,6 @@ Branch naming:
 
 ## 2. Test First (TDD)
 
-Invoke `superpowers:test-driven-development`.
 No production code without a failing test first.
 
 Red → Green → Refactor:
@@ -89,7 +88,6 @@ Match existing style — do not refactor adjacent code.
 
 ## 4. Review (before `/ttt:done`)
 
-Invoke `superpowers:verification-before-completion`.
 Run every command and confirm the actual output.
 
 \`\`\`bash

package/dist/bin/cli.js

@@ -49,8 +49,10 @@ COMMANDS:
   version    Show version
 
 GLOBAL OPTIONS:
-  -d, --dir <path>    Config directory (default: .ttt)
+  --dir <path>        Config directory (default: .ttt)
                       Can also set via TOON_DIR environment variable
+  -d <path>           Shortcut for --dir; ignored for create/edit/comment
+                      (where -d means --description)
 
 EXAMPLES:
   ttt init                      # Initialize .ttt directory
@@ -76,12 +78,20 @@ More info: https://github.com/wayne930242/team-toon-tack
 function printVersion() {
     console.log(`team-toon-tack v${VERSION}`);
 }
-function parseGlobalArgs(args) {
+// Subcommands where `-d` is a subcommand flag (e.g. --description) — never
+// consume `-d` as the global config-dir flag for these. `--dir` always works.
+const SHORT_D_RESERVED_FOR_SUBCOMMAND = new Set([
+    "create",
+    "edit",
+    "comment",
+]);
+function parseGlobalArgs(command, args) {
     let dir = process.env.TOON_DIR || resolve(process.cwd(), ".ttt");
     const commandArgs = [];
+    const allowShortD = !SHORT_D_RESERVED_FOR_SUBCOMMAND.has(command);
     for (let i = 0; i < args.length; i++) {
         const arg = args[i];
-        if (arg === "-d" || arg === "--dir") {
+        if (arg === "--dir" || (allowShortD && arg === "-d")) {
             dir = resolve(args[++i] || ".");
         }
         else {
@@ -105,7 +115,7 @@ async function main() {
     }
     const command = args[0];
     const restArgs = args.slice(1);
-    const { dir, commandArgs } = parseGlobalArgs(restArgs);
+    const { dir, commandArgs } = parseGlobalArgs(command, restArgs);
     // Set TOON_DIR for scripts to use
     process.env.TOON_DIR = dir;
     // Load .ttt/.env (if present) and resolve configured Linear API key env

package/dist/scripts/create.js

@@ -59,11 +59,39 @@ function resolveAssigneeId(config, assigneeKey) {
     }
     return user.id;
 }
-function resolveStatusId(config, statusName) {
-    if (!statusName || !config.statuses)
+async function resolveStatusId(config, adapter, teamId, statusName) {
+    if (!statusName)
         return undefined;
-    const entry = Object.entries(config.statuses).find(([, s]) => s.name.toLowerCase() === statusName.toLowerCase());
-    return entry ? entry[0] : undefined;
+    // Resolve `status_transitions` aliases (e.g. "todo" → "Todo", "in_progress" → "In Progress")
+    const transitions = config.status_transitions;
+    let targetName = statusName;
+    if (transitions) {
+        const aliasKey = statusName.toLowerCase().replace(/[\s-]+/g, "_");
+        const aliased = aliasKey === "todo"
+            ? Array.isArray(transitions.todo)
+                ? transitions.todo[0]
+                : transitions.todo
+            : aliasKey === "in_progress"
+                ? transitions.in_progress
+                : aliasKey === "done"
+                    ? transitions.done
+                    : aliasKey === "testing"
+                        ? transitions.testing
+                        : aliasKey === "blocked"
+                            ? transitions.blocked
+                            : undefined;
+        if (aliased)
+            targetName = aliased;
+    }
+    const statuses = await adapter.getStatuses(teamId);
+    const target = statuses.find((s) => s.name.toLowerCase() === targetName.toLowerCase());
+    if (!target) {
+        console.error(`Status "${statusName}" not found. Available: ${statuses
+            .map((s) => s.name)
+            .join(", ")}`);
+        process.exit(1);
+    }
+    return target.id;
 }
 function resolveLabelIds(config, labelArg) {
     if (!labelArg || !config.labels)
@@ -71,9 +99,11 @@ function resolveLabelIds(config, labelArg) {
     const names = labelArg.split(",").map((n) => n.trim());
     const ids = [];
     for (const name of names) {
-        const entry = Object.entries(config.labels).find(([, l]) => l.name.toLowerCase() === name.toLowerCase());
+        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);
         if (entry) {
-            ids.push(entry[0]);
+            ids.push(entry[1].id);
         }
         else {
             console.error(`Warning: label "${name}" not found in config, skipping.`);
@@ -81,10 +111,9 @@ function resolveLabelIds(config, labelArg) {
     }
     return ids.length > 0 ? ids : undefined;
 }
-async function resolveParentSourceId(config, parentIdentifier) {
+async function resolveParentSourceId(adapter, parentIdentifier) {
     if (!parentIdentifier)
         return undefined;
-    const adapter = createAdapter(config);
     const parent = await adapter.searchIssue(parentIdentifier);
     if (!parent) {
         console.error(`Parent issue "${parentIdentifier}" not found.`);
@@ -174,11 +203,11 @@ Examples:
         }
     }
     console.log("Creating issue...");
+    const adapter = createAdapter(config);
     const assigneeId = resolveAssigneeId(config, assigneeKey);
-    const statusId = resolveStatusId(config, statusName);
+    const statusId = await resolveStatusId(config, adapter, teamId, statusName);
     const labelIds = resolveLabelIds(config, labelArg);
-    const parentSourceId = await resolveParentSourceId(config, parentId);
-    const adapter = createAdapter(config);
+    const parentSourceId = await resolveParentSourceId(adapter, parentId);
     const currentCycle = await adapter.getCurrentCycle(teamId);
     const options = {
         teamId,

package/dist/scripts/edit.js

@@ -111,9 +111,10 @@ Examples:
         const ids = [];
         if (config.labels) {
             for (const name of names) {
-                const entry = Object.entries(config.labels).find(([, l]) => l.name.toLowerCase() === name.toLowerCase());
+                const lower = name.toLowerCase();
+                const entry = Object.entries(config.labels).find(([key, l]) => key.toLowerCase() === lower || l.name.toLowerCase() === lower);
                 if (entry) {
-                    ids.push(entry[0]);
+                    ids.push(entry[1].id);
                 }
                 else {
                     console.error(`Warning: label "${name}" not found in config, skipping.`);
@@ -173,9 +174,9 @@ Examples:
                 }
                 case "labels": {
                     if (config.labels) {
-                        const labelChoices = Object.entries(config.labels).map(([id, l]) => ({
+                        const labelChoices = Object.entries(config.labels).map(([, l]) => ({
                             name: l.name,
-                            value: id,
+                            value: l.id,
                             checked: task?.labels.includes(l.name) ?? false,
                         }));
                         fields.labelIds = await checkbox({

package/dist/scripts/lib/status-helpers.js

@@ -76,6 +76,21 @@ export function resolveLocalStatus(existingLocalStatus, remoteStatus, transition
         remoteLocalStatus === "blocked") {
         return remoteLocalStatus;
     }
+    // Remote already advanced past a stale local "pending" cache (e.g. another
+    // checkout/session started the task first) — adopt it, otherwise the task
+    // stays selectable by `work-on next` even though it's already claimed.
+    if (remoteLocalStatus === "in-progress" &&
+        existingLocalStatus === "pending") {
+        return remoteLocalStatus;
+    }
+    // "in-review" is never set by a local command (only by a prior sync), so
+    // it can't be an unconfirmed optimistic write. If remote has since moved
+    // off it (e.g. sent back to in-progress after failing review), that's an
+    // explicit remote change — adopt it instead of leaving the task stuck
+    // showing "in-review" forever.
+    if (existingLocalStatus === "in-review") {
+        return remoteLocalStatus;
+    }
     return existingLocalStatus;
 }
 /**

package/dist/scripts/lib/sync.js

@@ -62,7 +62,7 @@ export async function fetchIssueDetail(issueId, options = {}) {
  * Returns the updated task or null if issue not found
  */
 export async function syncSingleIssue(issueId, options) {
-    const { config, localConfig, preserveLocalStatus = true, } = options;
+    const { config, localConfig, preserveLocalStatus = true } = options;
     const client = options.client ?? getLinearClient();
     // Fetch issue details using shared function
     let task = await fetchIssueDetail(issueId, { client });

package/package.json

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