team-toon-tack 1.0.11 → 1.6.0

package/dist/scripts/work-on.d.ts

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

package/dist/scripts/work-on.js

@@ -1,33 +1,17 @@
-import {
-  require_prompts
-} from "../cli-6rkvcjaj.js";
-import {
-  getLinearClient,
-  getPrioritySortIndex,
-  getTeamId,
-  getUserEmail,
-  loadConfig,
-  loadCycleData,
-  loadLocalConfig,
-  saveCycleData
-} from "./utils.js";
-import {
-  __toESM
-} from "../cli-pyanjjwn.js";
-
-// scripts/work-on.ts
-var import_prompts = __toESM(require_prompts(), 1);
-var PRIORITY_LABELS = {
-  0: "⚪ None",
-  1: "\uD83D\uDD34 Urgent",
-  2: "\uD83D\uDFE0 High",
-  3: "\uD83D\uDFE1 Medium",
-  4: "\uD83D\uDFE2 Low"
+import prompts from "prompts";
+import { getLinearClient, getPrioritySortIndex, getTeamId, loadConfig, loadCycleData, loadLocalConfig, saveCycleData, } from "./utils.js";
+const PRIORITY_LABELS = {
+    0: "⚪ None",
+    1: "🔴 Urgent",
+    2: "🟠 High",
+    3: "🟡 Medium",
+    4: "🟢 Low",
 };
 async function workOn() {
-  const args = process.argv.slice(2);
-  if (args.includes("--help") || args.includes("-h")) {
-    console.log(`Usage: ttt work-on [issue-id]
+    const args = process.argv.slice(2);
+    // Handle help flag
+    if (args.includes("--help") || args.includes("-h")) {
+        console.log(`Usage: ttt work-on [issue-id]
 
 Arguments:
   issue-id    Issue ID (e.g., MP-624) or 'next' for auto-select
@@ -37,106 +21,132 @@ Examples:
   ttt work-on           # Interactive selection
   ttt work-on MP-624    # Work on specific issue
   ttt work-on next      # Auto-select highest priority`);
-    process.exit(0);
-  }
-  let issueId = args[0];
-  const config = await loadConfig();
-  const data = await loadCycleData();
-  if (!data) {
-    console.error("No cycle data found. Run /sync-linear first.");
-    process.exit(1);
-  }
-  const userEmail = await getUserEmail();
-  const localConfig = await loadLocalConfig();
-  const excludedEmails = new Set((localConfig.exclude_assignees ?? []).map((key) => config.users[key]?.email).filter(Boolean));
-  const pendingTasks = data.tasks.filter((t) => t.localStatus === "pending" && !excludedEmails.has(t.assignee ?? "")).sort((a, b) => {
-    const pa = getPrioritySortIndex(a.priority, config.priority_order);
-    const pb = getPrioritySortIndex(b.priority, config.priority_order);
-    return pa - pb;
-  });
-  if (!issueId) {
-    if (pendingTasks.length === 0) {
-      console.log("✅ 沒有待處理的任務，所有工作已完成或進行中");
-      process.exit(0);
+        process.exit(0);
+    }
+    let issueId = args[0];
+    const config = await loadConfig();
+    const data = await loadCycleData();
+    if (!data) {
+        console.error("No cycle data found. Run /sync-linear first.");
+        process.exit(1);
     }
-    const choices = pendingTasks.map((task2) => ({
-      title: `${PRIORITY_LABELS[task2.priority] || "⚪"} ${task2.id}: ${task2.title}`,
-      value: task2.id,
-      description: task2.labels.join(", ")
-    }));
-    const response = await import_prompts.default({
-      type: "select",
-      name: "issueId",
-      message: "選擇要處理的任務:",
-      choices
+    const localConfig = await loadLocalConfig();
+    // Build excluded emails list from user keys
+    const excludedEmails = new Set((localConfig.exclude_assignees ?? [])
+        .map((key) => config.users[key]?.email)
+        .filter(Boolean));
+    const pendingTasks = data.tasks
+        .filter((t) => t.localStatus === "pending" && !excludedEmails.has(t.assignee ?? ""))
+        .sort((a, b) => {
+        const pa = getPrioritySortIndex(a.priority, config.priority_order);
+        const pb = getPrioritySortIndex(b.priority, config.priority_order);
+        return pa - pb;
     });
-    if (!response.issueId) {
-      console.log("已取消");
-      process.exit(0);
+    // Phase 0: Issue Resolution
+    if (!issueId) {
+        // Interactive selection
+        if (pendingTasks.length === 0) {
+            console.log("✅ 沒有待處理的任務，所有工作已完成或進行中");
+            process.exit(0);
+        }
+        const choices = pendingTasks.map((task) => ({
+            title: `${PRIORITY_LABELS[task.priority] || "⚪"} ${task.id}: ${task.title}`,
+            value: task.id,
+            description: task.labels.join(", "),
+        }));
+        const response = await prompts({
+            type: "select",
+            name: "issueId",
+            message: "選擇要處理的任務:",
+            choices: choices,
+        });
+        if (!response.issueId) {
+            console.log("已取消");
+            process.exit(0);
+        }
+        issueId = response.issueId;
     }
-    issueId = response.issueId;
-  } else if (["next", "下一個", "下一個工作"].includes(issueId)) {
-    if (pendingTasks.length === 0) {
-      console.log("✅ 沒有待處理的任務，所有工作已完成或進行中");
-      process.exit(0);
+    else if (["next", "下一個", "下一個工作"].includes(issueId)) {
+        // Auto-select highest priority
+        if (pendingTasks.length === 0) {
+            console.log("✅ 沒有待處理的任務，所有工作已完成或進行中");
+            process.exit(0);
+        }
+        issueId = pendingTasks[0].id;
+        console.log(`Auto-selected: ${issueId}`);
     }
-    issueId = pendingTasks[0].id;
-    console.log(`Auto-selected: ${issueId}`);
-  }
-  const task = data.tasks.find((t) => t.id === issueId || t.id === `MP-${issueId}`);
-  if (!task) {
-    console.error(`Issue ${issueId} not found in current cycle.`);
-    process.exit(1);
-  }
-  if (task.localStatus === "in-progress") {
-    console.log(`⚠️ 此任務 ${task.id} 已在進行中`);
-  } else if (task.localStatus === "completed") {
-    console.log(`⚠️ 此任務 ${task.id} 已完成`);
-    process.exit(0);
-  }
-  if (task.localStatus === "pending") {
-    task.localStatus = "in-progress";
-    await saveCycleData(data);
-    console.log(`Local: ${task.id} → in-progress`);
-    if (task.linearId && process.env.LINEAR_API_KEY) {
-      try {
-        const client = getLinearClient();
-        const workflowStates = await client.workflowStates({
-          filter: { team: { id: { eq: getTeamId(config, localConfig.team) } } }
-        });
-        const inProgressState = workflowStates.nodes.find((s) => s.name === "In Progress");
-        if (inProgressState) {
-          await client.updateIssue(task.linearId, { stateId: inProgressState.id });
-          console.log(`Linear: ${task.id} → In Progress`);
+    // Phase 1: Find task
+    const task = data.tasks.find((t) => t.id === issueId || t.id === `MP-${issueId}`);
+    if (!task) {
+        console.error(`Issue ${issueId} not found in current cycle.`);
+        process.exit(1);
+    }
+    // Phase 2: Availability Check
+    if (task.localStatus === "in-progress") {
+        console.log(`⚠️ 此任務 ${task.id} 已在進行中`);
+    }
+    else if (task.localStatus === "completed") {
+        console.log(`⚠️ 此任務 ${task.id} 已完成`);
+        process.exit(0);
+    }
+    // Phase 3: Mark as In Progress
+    if (task.localStatus === "pending") {
+        task.localStatus = "in-progress";
+        await saveCycleData(data);
+        console.log(`Local: ${task.id} → in-progress`);
+        // Update Linear using stored linearId
+        if (task.linearId && process.env.LINEAR_API_KEY) {
+            try {
+                const client = getLinearClient();
+                const workflowStates = await client.workflowStates({
+                    filter: { team: { id: { eq: getTeamId(config, localConfig.team) } } },
+                });
+                // Get status name from config or use default
+                const inProgressStatusName = config.status_transitions?.in_progress || "In Progress";
+                const inProgressState = workflowStates.nodes.find((s) => s.name === inProgressStatusName);
+                if (inProgressState) {
+                    await client.updateIssue(task.linearId, {
+                        stateId: inProgressState.id,
+                    });
+                    console.log(`Linear: ${task.id} → ${inProgressStatusName}`);
+                }
+            }
+            catch (e) {
+                console.error("Failed to update Linear:", e);
+            }
         }
-      } catch (e) {
-        console.error("Failed to update Linear:", e);
-      }
     }
-  }
-  console.log(`
-${"═".repeat(50)}`);
-  console.log(`\uD83D\uDC77 ${task.id}: ${task.title}`);
-  console.log(`${"═".repeat(50)}`);
-  console.log(`Priority: ${PRIORITY_LABELS[task.priority] || "None"}`);
-  console.log(`Labels: ${task.labels.join(", ")}`);
-  console.log(`Branch: ${task.branch || "N/A"}`);
-  if (task.url)
-    console.log(`URL: ${task.url}`);
-  if (task.description) {
-    console.log(`
-\uD83D\uDCDD Description:
-${task.description}`);
-  }
-  if (task.attachments && task.attachments.length > 0) {
-    console.log(`
-\uD83D\uDCCE Attachments:`);
-    for (const att of task.attachments) {
-      console.log(`   - ${att.title}: ${att.url}`);
+    // Phase 4: Display task info
+    console.log(`\n${"═".repeat(50)}`);
+    console.log(`👷 ${task.id}: ${task.title}`);
+    console.log(`${"═".repeat(50)}`);
+    console.log(`Priority: ${PRIORITY_LABELS[task.priority] || "None"}`);
+    console.log(`Labels: ${task.labels.join(", ")}`);
+    console.log(`Branch: ${task.branch || "N/A"}`);
+    if (task.url)
+        console.log(`URL: ${task.url}`);
+    if (task.description) {
+        console.log(`\n📝 Description:\n${task.description}`);
+    }
+    if (task.attachments && task.attachments.length > 0) {
+        console.log(`\n📎 Attachments:`);
+        for (const att of task.attachments) {
+            console.log(`   - ${att.title}: ${att.url}`);
+        }
+    }
+    if (task.comments && task.comments.length > 0) {
+        console.log(`\n💬 Comments (${task.comments.length}):`);
+        for (const comment of task.comments) {
+            const date = new Date(comment.createdAt).toLocaleDateString();
+            console.log(`\n   [${comment.user || "Unknown"} - ${date}]`);
+            // Indent comment body
+            const lines = comment.body.split("\n");
+            for (const line of lines) {
+                console.log(`   ${line}`);
+            }
+        }
     }
-  }
-  console.log(`
-${"─".repeat(50)}`);
-  console.log("Next: bun type-check && bun lint");
+    console.log(`\n${"─".repeat(50)}`);
+    console.log("Next: bun type-check && bun lint");
 }
 workOn().catch(console.error);

package/package.json

@@ -1,50 +1,54 @@
 {
-  "name": "team-toon-tack",
-  "version": "1.0.11",
-  "description": "Linear task sync & management CLI with TOON format",
-  "type": "module",
-  "bin": {
-    "ttt": "./dist/bin/cli.js",
-    "team-toon-tack": "./dist/bin/cli.js"
-  },
-  "exports": {
-    ".": "./dist/scripts/utils.js",
-    "./utils": "./dist/scripts/utils.js"
-  },
-  "files": [
-    "dist",
-    "templates",
-    "package.json"
-  ],
-  "scripts": {
-    "build": "bun build bin/cli.ts scripts/init.ts scripts/sync.ts scripts/work-on.ts scripts/done-job.ts scripts/utils.ts --outdir dist --target node --splitting",
-    "prepublishOnly": "bun run build",
-    "release": "npm config set //registry.npmjs.org/:_authToken=$NPM_PUBLISH_KEY && npm publish"
-  },
-  "dependencies": {
-    "@linear/sdk": "^29.0.0",
-    "@toon-format/toon": "^2.0.0",
-    "prompts": "^2.4.2"
-  },
-  "devDependencies": {
-    "@types/bun": "^1.2.0",
-    "@types/prompts": "^2.4.9"
-  },
-  "keywords": [
-    "linear",
-    "task-management",
-    "cli",
-    "toon",
-    "sync",
-    "project-management"
-  ],
-  "author": "wayne930242",
-  "license": "MIT",
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/wayne930242/team-toon-tack.git"
-  },
-  "engines": {
-    "node": ">=18.0.0"
-  }
+	"name": "team-toon-tack",
+	"version": "1.6.0",
+	"description": "Linear task sync & management CLI with TOON format",
+	"type": "module",
+	"bin": {
+		"ttt": "./dist/bin/cli.js",
+		"team-toon-tack": "./dist/bin/cli.js"
+	},
+	"exports": {
+		".": "./dist/scripts/utils.js",
+		"./utils": "./dist/scripts/utils.js"
+	},
+	"files": [
+		"dist",
+		"templates"
+	],
+	"scripts": {
+		"build": "tsc",
+		"lint": "biome lint .",
+		"format": "biome format --write .",
+		"type": "tsc --noEmit",
+		"prepublishOnly": "npm run build",
+		"release": "npm config set //registry.npmjs.org/:_authToken=$NPM_PUBLISH_KEY && npm publish"
+	},
+	"dependencies": {
+		"@linear/sdk": "^69.0.0",
+		"@toon-format/toon": "^2.1.0",
+		"prompts": "^2.4.2"
+	},
+	"devDependencies": {
+		"@biomejs/biome": "^2.3.11",
+		"@types/node": "^25.0.3",
+		"@types/prompts": "^2.4.9",
+		"typescript": "^5.9.3"
+	},
+	"keywords": [
+		"linear",
+		"task-management",
+		"cli",
+		"toon",
+		"sync",
+		"project-management"
+	],
+	"author": "wayne930242",
+	"license": "MIT",
+	"repository": {
+		"type": "git",
+		"url": "git+https://github.com/wayne930242/team-toon-tack.git"
+	},
+	"engines": {
+		"node": ">=18.0.0"
+	}
 }

package/templates/claude-code-commands/done-job.md

@@ -0,0 +1,45 @@
+---
+name: done-job
+description: Mark a Linear issue as done with AI summary comment
+arguments:
+  - name: issue-id
+    description: Linear issue ID (e.g., MP-624). Optional if only one task is in-progress
+    required: false
+---
+
+# Complete Task
+
+Mark a task as done and update Linear with commit details.
+
+## Process
+
+### 1. Determine Issue ID
+
+Check `.toon/cycle.toon` for tasks with `localStatus: in-progress`.
+
+### 2. Write Fix Summary
+
+Prepare a concise summary (1-3 sentences) covering:
+- Root cause
+- How it was resolved
+- Key code changes
+
+### 3. Run Command
+
+```bash
+ttt done -d .ttt $ARGUMENTS -m "修復說明"
+```
+
+## What It Does
+
+- Linear issue status → "Done"
+- Adds comment with commit hash, message, and diff summary
+- Parent issue (if exists) → "Testing"
+- Local status → `completed` in `.toon/cycle.toon`
+
+## Example Usage
+
+```
+/done-job MP-624
+/done-job
+```

package/templates/claude-code-commands/sync-linear.md

@@ -0,0 +1,32 @@
+---
+name: sync-linear
+description: Sync Linear Frontend issues to local TOON file
+---
+
+# Sync Linear Issues
+
+Fetch current cycle's Frontend issues from Linear to `.toon/cycle.toon`.
+
+## Process
+
+### 1. Run Sync
+
+```bash
+ttt sync -d .ttt
+```
+
+### 2. Review Output
+
+Script displays a summary of tasks in the current cycle.
+
+## When to Use
+
+- Before starting a new work session
+- When task list is missing or outdated
+- After issues are updated in Linear
+
+## Example Usage
+
+```
+/sync-linear
+```

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

@@ -0,0 +1,41 @@
+---
+name: work-on
+description: Select and start working on a Linear issue
+arguments:
+  - name: issue-id
+    description: "Issue ID (e.g., MP-624) or 'next' for auto-select"
+    required: false
+---
+
+# Start Working on Issue
+
+Select a task and update status to "In Progress" on both local and Linear.
+
+## Process
+
+### 1. Run Command
+
+```bash
+ttt work-on -d .ttt $ARGUMENTS
+```
+
+### 2. Review Issue Details
+
+Script displays title, description, priority, labels, and attachments.
+
+### 3. Implement
+
+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
+
+## Example Usage
+
+```
+/work-on
+/work-on MP-624
+/work-on next
+```