team-toon-tack 1.0.12 → 1.6.0

package/{scripts → dist/scripts}/work-on.js

@@ -1,16 +1,16 @@
-import prompts from 'prompts';
-import { getLinearClient, loadConfig, loadLocalConfig, loadCycleData, saveCycleData, getUserEmail, getTeamId, getPrioritySortIndex } from './utils.js';
+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'
+    0: "⚪ None",
+    1: "🔴 Urgent",
+    2: "🟠 High",
+    3: "🟡 Medium",
+    4: "🟢 Low",
 };
 async function workOn() {
     const args = process.argv.slice(2);
     // Handle help flag
-    if (args.includes('--help') || args.includes('-h')) {
+    if (args.includes("--help") || args.includes("-h")) {
         console.log(`Usage: ttt work-on [issue-id]
 
 Arguments:
@@ -27,18 +27,16 @@ Examples:
     const config = await loadConfig();
     const data = await loadCycleData();
     if (!data) {
-        console.error('No cycle data found. Run /sync-linear first.');
+        console.error("No cycle data found. Run /sync-linear first.");
         process.exit(1);
     }
-    const userEmail = await getUserEmail();
     const localConfig = await loadLocalConfig();
     // Build excluded emails list from user keys
     const excludedEmails = new Set((localConfig.exclude_assignees ?? [])
-        .map(key => config.users[key]?.email)
+        .map((key) => config.users[key]?.email)
         .filter(Boolean));
     const pendingTasks = data.tasks
-        .filter(t => t.localStatus === 'pending' &&
-        !excludedEmails.has(t.assignee ?? ''))
+        .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);
@@ -48,52 +46,52 @@ Examples:
     if (!issueId) {
         // Interactive selection
         if (pendingTasks.length === 0) {
-            console.log('✅ 沒有待處理的任務，所有工作已完成或進行中');
+            console.log("✅ 沒有待處理的任務，所有工作已完成或進行中");
             process.exit(0);
         }
-        const choices = pendingTasks.map(task => ({
-            title: `${PRIORITY_LABELS[task.priority] || '⚪'} ${task.id}: ${task.title}`,
+        const choices = pendingTasks.map((task) => ({
+            title: `${PRIORITY_LABELS[task.priority] || "⚪"} ${task.id}: ${task.title}`,
             value: task.id,
-            description: task.labels.join(', ')
+            description: task.labels.join(", "),
         }));
         const response = await prompts({
-            type: 'select',
-            name: 'issueId',
-            message: '選擇要處理的任務:',
-            choices: choices
+            type: "select",
+            name: "issueId",
+            message: "選擇要處理的任務:",
+            choices: choices,
         });
         if (!response.issueId) {
-            console.log('已取消');
+            console.log("已取消");
             process.exit(0);
         }
         issueId = response.issueId;
     }
-    else if (['next', '下一個', '下一個工作'].includes(issueId)) {
+    else if (["next", "下一個", "下一個工作"].includes(issueId)) {
         // Auto-select highest priority
         if (pendingTasks.length === 0) {
-            console.log('✅ 沒有待處理的任務，所有工作已完成或進行中');
+            console.log("✅ 沒有待處理的任務，所有工作已完成或進行中");
             process.exit(0);
         }
         issueId = pendingTasks[0].id;
         console.log(`Auto-selected: ${issueId}`);
     }
     // Phase 1: Find task
-    const task = data.tasks.find(t => t.id === issueId || t.id === `MP-${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);
     }
     // Phase 2: Availability Check
-    if (task.localStatus === 'in-progress') {
+    if (task.localStatus === "in-progress") {
         console.log(`⚠️ 此任務 ${task.id} 已在進行中`);
     }
-    else if (task.localStatus === 'completed') {
+    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';
+    if (task.localStatus === "pending") {
+        task.localStatus = "in-progress";
         await saveCycleData(data);
         console.log(`Local: ${task.id} → in-progress`);
         // Update Linear using stored linearId
@@ -101,26 +99,30 @@ Examples:
             try {
                 const client = getLinearClient();
                 const workflowStates = await client.workflowStates({
-                    filter: { team: { id: { eq: getTeamId(config, localConfig.team) } } }
+                    filter: { team: { id: { eq: getTeamId(config, localConfig.team) } } },
                 });
-                const inProgressState = workflowStates.nodes.find(s => s.name === 'In Progress');
+                // 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} → In Progress`);
+                    await client.updateIssue(task.linearId, {
+                        stateId: inProgressState.id,
+                    });
+                    console.log(`Linear: ${task.id} → ${inProgressStatusName}`);
                 }
             }
             catch (e) {
-                console.error('Failed to update Linear:', e);
+                console.error("Failed to update Linear:", e);
             }
         }
     }
     // Phase 4: Display task info
-    console.log(`\n${'═'.repeat(50)}`);
+    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'}`);
+    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) {
@@ -132,7 +134,19 @@ Examples:
             console.log(`   - ${att.title}: ${att.url}`);
         }
     }
-    console.log(`\n${'─'.repeat(50)}`);
-    console.log('Next: bun type-check && bun lint');
+    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(`\n${"─".repeat(50)}`);
+    console.log("Next: bun type-check && bun lint");
 }
 workOn().catch(console.error);

package/package.json

@@ -1,52 +1,54 @@
 {
-  "name": "team-toon-tack",
-  "version": "1.0.12",
-  "description": "Linear task sync & management CLI with TOON format",
-  "type": "module",
-  "bin": {
-    "ttt": "./bin/cli.js",
-    "team-toon-tack": "./bin/cli.js"
-  },
-  "exports": {
-    ".": "./scripts/utils.js",
-    "./utils": "./scripts/utils.js"
-  },
-  "files": [
-    "bin",
-    "scripts",
-    "templates",
-    "package.json"
-  ],
-  "scripts": {
-    "build": "tsc",
-    "prepublishOnly": "npm 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/node": "^20.0.0",
-    "@types/prompts": "^2.4.9",
-    "typescript": "^5.0.0"
-  },
-  "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
+```

package/bin/cli.ts

@@ -1,125 +0,0 @@
-#!/usr/bin/env node
-import { resolve } from 'node:path';
-import { readFileSync } from 'node:fs';
-import { fileURLToPath } from 'node:url';
-import { dirname, join } from 'node:path';
-
-const __dirname = dirname(fileURLToPath(import.meta.url));
-const pkg = JSON.parse(readFileSync(join(__dirname, '..', 'package.json'), 'utf-8'));
-const VERSION = pkg.version;
-
-const COMMANDS = ['init', 'sync', 'work-on', 'done', 'help', 'version'] as const;
-type Command = typeof COMMANDS[number];
-
-function printHelp() {
-  console.log(`
-team-toon-tack (ttt) - Linear task sync & management CLI
-
-USAGE:
-  ttt <command> [options]
-
-COMMANDS:
-  init      Initialize config files in current directory
-  sync      Sync issues from Linear to local cycle.ttt
-  work-on   Start working on a task (interactive or by ID)
-  done      Mark current task as completed
-  help      Show this help message
-  version   Show version
-
-GLOBAL OPTIONS:
-  -d, --dir <path>    Config directory (default: .ttt)
-                      Can also set via TOON_DIR environment variable
-
-EXAMPLES:
-  ttt init                      # Initialize .ttt directory
-  ttt init -d ./custom          # Initialize in custom directory
-  ttt sync                      # Sync from Linear
-  ttt work-on                   # Interactive task selection
-  ttt work-on MP-123            # Work on specific issue
-  ttt work-on next              # Auto-select highest priority
-  ttt done                      # Complete current task
-  ttt done -m "Fixed the bug"   # With completion message
-
-ENVIRONMENT:
-  LINEAR_API_KEY    Required. Your Linear API key
-  TOON_DIR          Optional. Default config directory
-
-More info: https://github.com/wayne930242/team-toon-tack
-`);
-}
-
-function printVersion() {
-  console.log(`team-toon-tack v${VERSION}`);
-}
-
-function parseGlobalArgs(args: string[]): { dir: string; commandArgs: string[] } {
-  let dir = process.env.TOON_DIR || resolve(process.cwd(), '.ttt');
-  const commandArgs: string[] = [];
-
-  for (let i = 0; i < args.length; i++) {
-    const arg = args[i];
-    if (arg === '-d' || arg === '--dir') {
-      dir = resolve(args[++i] || '.');
-    } else {
-      commandArgs.push(arg);
-    }
-  }
-
-  return { dir, commandArgs };
-}
-
-async function main() {
-  const args = process.argv.slice(2);
-
-  if (args.length === 0 || args[0] === 'help' || args[0] === '-h' || args[0] === '--help') {
-    printHelp();
-    process.exit(0);
-  }
-
-  if (args[0] === 'version' || args[0] === '-v' || args[0] === '--version') {
-    printVersion();
-    process.exit(0);
-  }
-
-  const command = args[0] as Command;
-  const restArgs = args.slice(1);
-  const { dir, commandArgs } = parseGlobalArgs(restArgs);
-
-  // Set TOON_DIR for scripts to use
-  process.env.TOON_DIR = dir;
-
-  if (!COMMANDS.includes(command)) {
-    console.error(`Unknown command: ${command}`);
-    console.error(`Run 'ttt help' for usage.`);
-    process.exit(1);
-  }
-
-  // Import and run the appropriate script
-  const scriptDir = new URL('../scripts/', import.meta.url).pathname;
-  try {
-    switch (command) {
-      case 'init':
-        process.argv = ['node', 'init.js', ...commandArgs];
-        await import(`${scriptDir}init.js`);
-        break;
-      case 'sync':
-        await import(`${scriptDir}sync.js`);
-        break;
-      case 'work-on':
-        process.argv = ['node', 'work-on.js', ...commandArgs];
-        await import(`${scriptDir}work-on.js`);
-        break;
-      case 'done':
-        process.argv = ['node', 'done-job.js', ...commandArgs];
-        await import(`${scriptDir}done-job.js`);
-        break;
-    }
-  } catch (error) {
-    if (error instanceof Error) {
-      console.error(`Error: ${error.message}`);
-    }
-    process.exit(1);
-  }
-}
-
-main();