team-toon-tack 1.6.2 → 1.7.0

package/dist/scripts/done-job.js

@@ -1,7 +1,8 @@
 import prompts from "prompts";
 import { buildCompletionComment, getLatestCommit } from "./lib/git.js";
 import { addComment, getStatusTransitions, getWorkflowStates, updateIssueStatus, } from "./lib/linear.js";
-import { getLinearClient, loadConfig, loadCycleData, loadLocalConfig, saveCycleData, } from "./utils.js";
+import { syncSingleIssue } from "./lib/sync.js";
+import { getLinearClient, loadConfig, loadCycleData, loadLocalConfig, } from "./utils.js";
 function parseArgs(args) {
     let issueId;
     let message;
@@ -144,10 +145,15 @@ Examples:
             }
         }
     }
-    // Update local status
-    task.localStatus = "completed";
-    await saveCycleData(data);
-    console.log(`Local: ${task.id} → completed`);
+    // Sync full issue data from Linear (including new comment)
+    const syncedTask = await syncSingleIssue(task.id, {
+        config,
+        localConfig,
+        preserveLocalStatus: false, // Let remote status determine local status
+    });
+    if (syncedTask) {
+        console.log(`Synced: ${syncedTask.id} → ${syncedTask.status} (local: ${syncedTask.localStatus})`);
+    }
     // Summary
     console.log(`\n${"═".repeat(50)}`);
     console.log(`✅ ${task.id}: ${task.title}`);

package/dist/scripts/lib/config-builder.js

@@ -66,8 +66,7 @@ export function getDefaultStatusTransitions(states) {
     const defaultDone = states.find((s) => s.type === "completed")?.name ||
         findStatusByKeyword(states, ["done", "complete"]) ||
         "Done";
-    const defaultTesting = findStatusByKeyword(states, ["testing", "review"]) ||
-        undefined;
+    const defaultTesting = findStatusByKeyword(states, ["testing", "review"]) || undefined;
     return {
         todo: defaultTodo,
         in_progress: defaultInProgress,

package/dist/scripts/lib/sync.d.ts

@@ -0,0 +1,13 @@
+import type { LinearClient } from "@linear/sdk";
+import { type Config, type LocalConfig, type Task } from "../utils.js";
+export interface SyncIssueOptions {
+    config: Config;
+    localConfig: LocalConfig;
+    client?: LinearClient;
+    preserveLocalStatus?: boolean;
+}
+/**
+ * Sync a single issue from Linear and update local cycle data
+ * Returns the updated task or null if issue not found
+ */
+export declare function syncSingleIssue(issueId: string, options: SyncIssueOptions): Promise<Task | null>;

package/dist/scripts/lib/sync.js

@@ -0,0 +1,97 @@
+import { getLinearClient, loadCycleData, saveCycleData, getPrioritySortIndex, } from "../utils.js";
+import { getStatusTransitions } from "./linear.js";
+/**
+ * Sync a single issue from Linear and update local cycle data
+ * Returns the updated task or null if issue not found
+ */
+export async function syncSingleIssue(issueId, options) {
+    const { config, localConfig: _localConfig, preserveLocalStatus = true, } = options;
+    const client = options.client ?? getLinearClient();
+    // Search for the issue
+    const searchResult = await client.searchIssues(issueId);
+    const matchingIssue = searchResult.nodes.find((i) => i.identifier === issueId);
+    if (!matchingIssue) {
+        console.error(`Issue ${issueId} not found in Linear.`);
+        return null;
+    }
+    // Fetch full issue data
+    const issue = await client.issue(matchingIssue.id);
+    const assignee = await issue.assignee;
+    const assigneeEmail = assignee?.email;
+    const labels = await issue.labels();
+    const labelNames = labels.nodes.map((l) => l.name);
+    const state = await issue.state;
+    const parent = await issue.parent;
+    const attachmentsData = await issue.attachments();
+    const commentsData = await issue.comments();
+    // Build attachments list
+    const attachments = attachmentsData.nodes.map((a) => ({
+        id: a.id,
+        title: a.title,
+        url: a.url,
+        sourceType: a.sourceType ?? undefined,
+    }));
+    // Build comments list
+    const comments = await Promise.all(commentsData.nodes.map(async (c) => {
+        const user = await c.user;
+        return {
+            id: c.id,
+            body: c.body,
+            createdAt: c.createdAt.toISOString(),
+            user: user?.displayName ?? user?.email,
+        };
+    }));
+    // Determine local status
+    let localStatus = "pending";
+    const existingData = await loadCycleData();
+    if (preserveLocalStatus && existingData) {
+        const existingTask = existingData.tasks.find((t) => t.id === issueId);
+        if (existingTask) {
+            localStatus = existingTask.localStatus;
+        }
+    }
+    // Map remote status to local status if not preserving
+    if (!preserveLocalStatus && state) {
+        const transitions = getStatusTransitions(config);
+        if (state.name === transitions.done) {
+            localStatus = "completed";
+        }
+        else if (state.name === transitions.in_progress) {
+            localStatus = "in-progress";
+        }
+        else {
+            localStatus = "pending";
+        }
+    }
+    const task = {
+        id: issue.identifier,
+        linearId: issue.id,
+        title: issue.title,
+        status: state ? state.name : "Unknown",
+        localStatus: localStatus,
+        assignee: assigneeEmail,
+        priority: issue.priority,
+        labels: labelNames,
+        branch: issue.branchName,
+        description: issue.description ?? undefined,
+        parentIssueId: parent ? parent.identifier : undefined,
+        url: issue.url,
+        attachments: attachments.length > 0 ? attachments : undefined,
+        comments: comments.length > 0 ? comments : undefined,
+    };
+    // Update cycle data
+    if (existingData) {
+        const existingTasks = existingData.tasks.filter((t) => t.id !== issueId);
+        const finalTasks = [...existingTasks, task];
+        // Sort by priority
+        finalTasks.sort((a, b) => {
+            const pa = getPrioritySortIndex(a.priority, config.priority_order);
+            const pb = getPrioritySortIndex(b.priority, config.priority_order);
+            return pa - pb;
+        });
+        existingData.tasks = finalTasks;
+        existingData.updatedAt = new Date().toISOString();
+        await saveCycleData(existingData);
+    }
+    return task;
+}

package/dist/scripts/status.js

@@ -135,17 +135,13 @@ Examples:
             console.error(`Unknown status: ${setStatus}`);
             process.exit(1);
         }
+        // Track if we need to save
+        let needsSave = false;
+        const oldLocalStatus = task.localStatus;
         // Update local status
-        if (newLocalStatus) {
-            if (newLocalStatus !== task.localStatus) {
-                const oldStatus = task.localStatus;
-                task.localStatus = newLocalStatus;
-                await saveCycleData(data);
-                console.log(`Local: ${task.id} ${oldStatus} → ${newLocalStatus}`);
-            }
-            else {
-                console.log(`Local: ${task.id} already ${newLocalStatus}`);
-            }
+        if (newLocalStatus && newLocalStatus !== task.localStatus) {
+            task.localStatus = newLocalStatus;
+            needsSave = true;
         }
         // Update Linear status
         if (newLinearStatus || newLocalStatus) {
@@ -156,10 +152,22 @@ Examples:
             if (targetStateName) {
                 const success = await updateIssueStatus(task.linearId, targetStateName, config, localConfig.team);
                 if (success) {
+                    task.status = targetStateName;
+                    needsSave = true;
                     console.log(`Linear: ${task.id} → ${targetStateName}`);
                 }
             }
         }
+        // Save if anything changed
+        if (needsSave) {
+            await saveCycleData(data);
+            if (newLocalStatus && newLocalStatus !== oldLocalStatus) {
+                console.log(`Local: ${task.id} ${oldLocalStatus} → ${newLocalStatus}`);
+            }
+        }
+        else if (newLocalStatus) {
+            console.log(`Local: ${task.id} already ${newLocalStatus}`);
+        }
     }
     // Display task info using shared function
     displayTaskWithStatus(task);

package/dist/scripts/work-on.js

@@ -83,16 +83,17 @@ Examples:
     // Mark as In Progress
     if (task.localStatus === "pending") {
         task.localStatus = "in-progress";
-        await saveCycleData(data);
-        console.log(`Local: ${task.id} → in-progress`);
         // Update Linear
         if (task.linearId && process.env.LINEAR_API_KEY) {
             const transitions = getStatusTransitions(config);
             const success = await updateIssueStatus(task.linearId, transitions.in_progress, config, localConfig.team);
             if (success) {
+                task.status = transitions.in_progress;
                 console.log(`Linear: ${task.id} → ${transitions.in_progress}`);
             }
         }
+        await saveCycleData(data);
+        console.log(`Local: ${task.id} → in-progress`);
     }
     // Display task info
     displayTaskFull(task, "👷");

package/package.json

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

package/templates/claude-code-commands/work-on.md

@@ -28,9 +28,20 @@ Script displays title, description, priority, labels, and attachments.
 1. Read the issue description carefully
 2. Explore related code
 3. Implement the fix/feature
-4. Run `bun type-check && bun lint`
-5. Commit with conventional format
-6. Use `/done-job` to complete
+4. Commit with conventional format
+
+### 4. Verify
+
+Run project-required verification before completing:
+
+```bash
+# Run verification procedure defined in project
+# (e.g., type-check, lint, test, build)
+```
+
+### 5. Complete
+
+Use `/done-job` to mark task as completed
 
 ## Example Usage