team-toon-tack 3.1.0 → 3.2.0

package/README.md

@@ -48,7 +48,7 @@ During init, you'll be prompted to select your task source (Linear or Trello) an
 **For Trello:**
 - **Board**: The Trello board to sync
 - **User**: Your Trello username
-- **Status mappings**: Map Trello lists to Todo/In Progress/Done
+- **Status mappings**: Map Trello lists to Todo (supports multiple lists)/In Progress/Done
 - **Label filter**: Optional label to filter cards
 
 ### Completion Modes (Linear only)

package/README.zh-TW.md

@@ -48,7 +48,7 @@ ttt init
 **Trello：**
 - **看板**：要同步的 Trello 看板
 - **使用者**：你的 Trello 使用者名稱
-- **狀態映射**：將 Trello 列表映射到 Todo/In Progress/Done
+- **狀態映射**：將 Trello 列表映射到 Todo（支援多個列表）/In Progress/Done
 - **標籤過濾**：可選的卡片過濾標籤
 
 ### 完成模式（僅 Linear）

package/dist/scripts/config/status.js

@@ -1,5 +1,6 @@
 import { select } from "@inquirer/prompts";
 import { getWorkflowStates } from "../lib/linear.js";
+import { getFirstTodoStatus } from "../lib/status-helpers.js";
 import { saveConfig, } from "../utils.js";
 export async function configureStatus(config, localConfig) {
     console.log("📊 Configure Status Mappings\n");
@@ -14,7 +15,9 @@ export async function configureStatus(config, localConfig) {
     }));
     // Get current values or defaults
     const current = config.status_transitions || {};
-    const defaultTodo = current.todo || states.find((s) => s.type === "unstarted")?.name || "Todo";
+    const defaultTodo = getFirstTodoStatus(current.todo) ||
+        states.find((s) => s.type === "unstarted")?.name ||
+        "Todo";
     const defaultInProgress = current.in_progress ||
         states.find((s) => s.type === "started")?.name ||
         "In Progress";

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

@@ -7,3 +7,7 @@ export declare function downloadLinearFile(url: string, issueId: string, attachm
 export declare const downloadLinearImage: typeof downloadLinearFile;
 export declare function clearIssueImages(outputDir: string, issueId: string): Promise<void>;
 export declare function ensureOutputDir(outputDir: string): Promise<void>;
+/**
+ * Clear all files in output directory (for fresh sync)
+ */
+export declare function clearAllOutput(outputDir: string): Promise<void>;

package/dist/scripts/lib/files.js

@@ -134,3 +134,21 @@ export async function clearIssueImages(outputDir, issueId) {
 export async function ensureOutputDir(outputDir) {
     await fs.mkdir(outputDir, { recursive: true });
 }
+/**
+ * Clear all files in output directory (for fresh sync)
+ */
+export async function clearAllOutput(outputDir) {
+    try {
+        const files = await fs.readdir(outputDir);
+        for (const file of files) {
+            const filepath = path.join(outputDir, file);
+            const stat = await fs.stat(filepath);
+            if (stat.isFile()) {
+                await fs.unlink(filepath);
+            }
+        }
+    }
+    catch {
+        // Directory doesn't exist or other error, ignore
+    }
+}

package/dist/scripts/lib/init/linear-init.js

@@ -5,6 +5,7 @@ import fs from "node:fs/promises";
 import { decode, encode } from "@toon-format/toon";
 import { fileExists, getLinearClient, } from "../../utils.js";
 import { buildConfig, buildLocalConfig, buildTeamsConfig, findTeamKey, findUserKey, } from "../config-builder.js";
+import { formatTodoStatus } from "../status-helpers.js";
 import { showPluginInstallInstructions, updateGitignore } from "./file-ops.js";
 import { promptForApiKey, selectCompletionMode, selectDevTeam, selectDevTestingStatus, selectQaPmTeams, selectStatusMappings, } from "./linear-prompts.js";
 import { selectLabelFilter, selectStatusSource, selectUser, } from "./prompts.js";
@@ -195,7 +196,7 @@ export async function initLinear(options, paths) {
         console.log(`  Cycle: ${currentCycle.name || `Cycle #${currentCycle.number}`}`);
     }
     console.log(`  Status mappings:`);
-    console.log(`    Todo: ${statusTransitions.todo}`);
+    console.log(`    Todo: ${formatTodoStatus(statusTransitions.todo)}`);
     console.log(`    In Progress: ${statusTransitions.in_progress}`);
     console.log(`    Done: ${statusTransitions.done}`);
     if (statusTransitions.blocked) {

package/dist/scripts/lib/init/linear-prompts.js

@@ -3,6 +3,7 @@
  */
 import { checkbox, password, select } from "@inquirer/prompts";
 import { getDefaultStatusTransitions, } from "../config-builder.js";
+import { getFirstTodoStatus } from "../status-helpers.js";
 export async function promptForApiKey(options) {
     let apiKey = options.apiKey || process.env.LINEAR_API_KEY;
     if (!apiKey && options.interactive) {
@@ -165,7 +166,7 @@ export async function selectStatusMappings(devStates, options) {
     const todo = await select({
         message: 'Select status for "Todo" (pending tasks):',
         choices: devStateChoices,
-        default: devDefaults.todo,
+        default: getFirstTodoStatus(devDefaults.todo),
     });
     const in_progress = await select({
         message: 'Select status for "In Progress" (working tasks):',

package/dist/scripts/lib/init/trello-init.js

@@ -2,8 +2,9 @@
  * Trello initialization flow
  */
 import fs from "node:fs/promises";
-import { select } from "@inquirer/prompts";
+import { checkbox, select } from "@inquirer/prompts";
 import { encode } from "@toon-format/toon";
+import { formatTodoStatus } from "../status-helpers.js";
 import { TrelloClient } from "../trello.js";
 import { updateGitignore } from "./file-ops.js";
 import { selectLabelFilter, selectStatusSource } from "./prompts.js";
@@ -71,16 +72,23 @@ export async function initTrello(options, paths) {
     let statusTransitions;
     if (options.interactive && lists.length > 0) {
         console.log("\n📊 Configure status mappings (lists):");
-        const defaultTodo = lists.find((l) => /todo|backlog|to do/i.test(l.name))?.name ||
-            lists[0]?.name;
-        const defaultInProgress = lists.find((l) => /progress|doing|working/i.test(l.name))?.name ||
-            lists[1]?.name;
-        const defaultDone = lists.find((l) => /done|complete|finished/i.test(l.name))?.name ||
+        // Smart defaults for checkbox - pre-check matching lists
+        const todoPattern = /todo|backlog|to do|proposed/i;
+        const inProgressPattern = /progress|doing|working|active/i;
+        const donePattern = /done|complete|finished|closed/i;
+        const defaultInProgress = lists.find((l) => inProgressPattern.test(l.name))?.name || lists[1]?.name;
+        const defaultDone = lists.find((l) => donePattern.test(l.name))?.name ||
             lists[lists.length - 1]?.name;
-        const todo = await select({
-            message: 'Select list for "Todo" (pending tasks):',
-            choices: listChoices,
-            default: defaultTodo,
+        // Todo uses checkbox for multi-select
+        const todoChoices = lists.map((l) => ({
+            name: l.name,
+            value: l.name,
+            checked: todoPattern.test(l.name),
+        }));
+        const todo = await checkbox({
+            message: 'Select list(s) for "Todo" (pending tasks - multi-select):',
+            choices: todoChoices,
+            required: true,
         });
         const in_progress = await select({
             message: 'Select list for "In Progress":',
@@ -93,7 +101,7 @@ export async function initTrello(options, paths) {
             default: defaultDone,
         });
         statusTransitions = {
-            todo: todo || lists[0]?.name || "Todo",
+            todo: todo.length === 1 ? todo[0] : todo,
             in_progress: in_progress || lists[1]?.name || "In Progress",
             done: done || lists[lists.length - 1]?.name || "Done",
         };
@@ -192,7 +200,7 @@ export async function initTrello(options, paths) {
     console.log(`  Label filters: ${defaultLabel && defaultLabel.length > 0 ? defaultLabel.join(", ") : "(none)"}`);
     console.log(`  Status source: ${statusSource === "local" ? "local" : "remote"}`);
     console.log(`  Status mappings:`);
-    console.log(`    Todo: ${statusTransitions.todo}`);
+    console.log(`    Todo: ${formatTodoStatus(statusTransitions.todo)}`);
     console.log(`    In Progress: ${statusTransitions.in_progress}`);
     console.log(`    Done: ${statusTransitions.done}`);
     console.log("\nNext steps:");

package/dist/scripts/lib/linear.js

@@ -1,4 +1,5 @@
 import { getLinearClient, getTeamId, } from "../utils.js";
+import { getFirstTodoStatus } from "./status-helpers.js";
 export async function getWorkflowStates(config, teamKey) {
     const client = getLinearClient();
     const teamId = getTeamId(config, teamKey);
@@ -50,7 +51,7 @@ export function mapLocalStatusToLinear(localStatus, config) {
     const transitions = getStatusTransitions(config);
     switch (localStatus) {
         case "pending":
-            return transitions.todo;
+            return getFirstTodoStatus(transitions.todo);
         case "in-progress":
             return transitions.in_progress;
         case "in-review":

package/dist/scripts/lib/status-helpers.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Helper functions for status transitions
+ * Handles the case where `todo` can be string | string[]
+ */
+import type { StatusTransitions } from "../utils.js";
+/**
+ * Normalize todo status value to array
+ * Only `todo` supports multiple values for sync filtering
+ */
+export declare function normalizeTodoStatuses(todo: string | string[] | undefined): string[];
+/**
+ * Check if a status name matches the todo transition (supports string | string[])
+ */
+export declare function isTodoStatus(statusName: string, transitions: StatusTransitions): boolean;
+/**
+ * Get all statuses to sync (flattens todo array + in_progress)
+ */
+export declare function getSyncStatuses(transitions: StatusTransitions): string[];
+/**
+ * Map remote status to local status using transitions
+ */
+export declare function mapRemoteToLocalStatus(remoteStatus: string, transitions: StatusTransitions): "pending" | "in-progress" | "completed" | "in-review" | "blocked";
+/**
+ * Format todo status for display (handles string | string[])
+ */
+export declare function formatTodoStatus(todo: string | string[]): string;
+/**
+ * Get first todo status (for defaults and pushing to remote)
+ */
+export declare function getFirstTodoStatus(todo: string | string[] | undefined): string | undefined;

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

@@ -0,0 +1,58 @@
+/**
+ * Helper functions for status transitions
+ * Handles the case where `todo` can be string | string[]
+ */
+/**
+ * Normalize todo status value to array
+ * Only `todo` supports multiple values for sync filtering
+ */
+export function normalizeTodoStatuses(todo) {
+    if (!todo)
+        return [];
+    return Array.isArray(todo) ? todo : [todo];
+}
+/**
+ * Check if a status name matches the todo transition (supports string | string[])
+ */
+export function isTodoStatus(statusName, transitions) {
+    const todoStatuses = normalizeTodoStatuses(transitions.todo);
+    return todoStatuses.includes(statusName);
+}
+/**
+ * Get all statuses to sync (flattens todo array + in_progress)
+ */
+export function getSyncStatuses(transitions) {
+    return [...normalizeTodoStatuses(transitions.todo), transitions.in_progress];
+}
+/**
+ * Map remote status to local status using transitions
+ */
+export function mapRemoteToLocalStatus(remoteStatus, transitions) {
+    if (remoteStatus === transitions.done) {
+        return "completed";
+    }
+    if (remoteStatus === transitions.in_progress) {
+        return "in-progress";
+    }
+    if (transitions.testing && remoteStatus === transitions.testing) {
+        return "in-review";
+    }
+    if (transitions.blocked && remoteStatus === transitions.blocked) {
+        return "blocked";
+    }
+    return "pending";
+}
+/**
+ * Format todo status for display (handles string | string[])
+ */
+export function formatTodoStatus(todo) {
+    return Array.isArray(todo) ? todo.join(", ") : todo;
+}
+/**
+ * Get first todo status (for defaults and pushing to remote)
+ */
+export function getFirstTodoStatus(todo) {
+    if (!todo)
+        return undefined;
+    return Array.isArray(todo) ? todo[0] : todo;
+}

package/dist/scripts/status.js

@@ -2,6 +2,7 @@
 import { createAdapter } from "./lib/adapters/index.js";
 import { displayTaskWithStatus, getStatusIcon } from "./lib/display.js";
 import { getStatusTransitions, mapLocalStatusToLinear } from "./lib/linear.js";
+import { getFirstTodoStatus } from "./lib/status-helpers.js";
 import { getSourceType, loadConfig, loadCycleData, loadLocalConfig, saveCycleData, } from "./utils.js";
 const LOCAL_STATUS_ORDER = [
     "pending",
@@ -111,17 +112,21 @@ Examples:
         }
         else if (["todo", "in_progress", "done", "testing"].includes(setStatus)) {
             const transitions = getStatusTransitions(config);
-            newLinearStatus =
-                transitions[setStatus] ?? undefined;
             if (setStatus === "todo") {
+                newLinearStatus = getFirstTodoStatus(transitions.todo);
                 newLocalStatus = "pending";
             }
             else if (setStatus === "in_progress") {
+                newLinearStatus = transitions.in_progress;
                 newLocalStatus = "in-progress";
             }
             else if (setStatus === "done") {
+                newLinearStatus = transitions.done;
                 newLocalStatus = "completed";
             }
+            else if (setStatus === "testing") {
+                newLinearStatus = transitions.testing;
+            }
         }
         else {
             console.error(`Unknown status: ${setStatus}`);

package/dist/scripts/sync.js

@@ -1,5 +1,6 @@
 import { createAdapter } from "./lib/adapters/index.js";
-import { clearIssueImages, downloadLinearImage, ensureOutputDir, extractLinearImageUrls, isLinearImageUrl, } from "./lib/files.js";
+import { clearAllOutput, clearIssueImages, downloadLinearImage, ensureOutputDir, extractLinearImageUrls, isLinearImageUrl, } from "./lib/files.js";
+import { getSyncStatuses } from "./lib/status-helpers.js";
 import { getLinearClient, getPaths, getPrioritySortIndex, getSourceType, getTeamId, loadConfig, loadCycleData, loadLocalConfig, saveConfig, saveCycleData, } from "./utils.js";
 async function sync() {
     const args = process.argv.slice(2);
@@ -55,6 +56,10 @@ Examples:
     const teamId = getTeamId(config, localConfig.team);
     // Ensure output directory exists
     await ensureOutputDir(outputPath);
+    // Clear previous output for full sync (not single-issue)
+    if (!singleIssueId) {
+        await clearAllOutput(outputPath);
+    }
     // Build excluded labels set
     const excludedLabels = new Set(localConfig.exclude_labels ?? []);
     // Phase 1: Fetch active cycle directly from team
@@ -166,7 +171,7 @@ Examples:
     const existingTasksMap = new Map(existingData?.tasks.map((t) => [t.id, t]));
     // Phase 4: Fetch current issues with full content
     const filterLabels = localConfig.labels;
-    const syncStatuses = [statusTransitions.todo, statusTransitions.in_progress];
+    const syncStatuses = getSyncStatuses(statusTransitions);
     const labelDesc = filterLabels && filterLabels.length > 0
         ? ` with labels: ${filterLabels.join(", ")}`
         : "";
@@ -391,6 +396,10 @@ async function syncTrello(config, localConfig, options) {
     }
     // Ensure output directory exists
     await ensureOutputDir(outputPath);
+    // Clear previous output for full sync (not single-issue)
+    if (!singleIssueId) {
+        await clearAllOutput(outputPath);
+    }
     // Build excluded labels set
     const excludedLabels = new Set(localConfig.exclude_labels ?? []);
     // Get team (board) ID
@@ -405,7 +414,7 @@ async function syncTrello(config, localConfig, options) {
         in_progress: "In Progress",
         done: "Done",
     };
-    const syncStatuses = [statusTransitions.todo, statusTransitions.in_progress];
+    const syncStatuses = getSyncStatuses(statusTransitions);
     // Load existing data
     const existingData = await loadCycleData();
     const existingTasksMap = new Map(existingData?.tasks.map((t) => [t.id, t]));

package/dist/scripts/utils.d.ts

@@ -29,7 +29,7 @@ export interface CycleInfo {
     end_date: string;
 }
 export interface StatusTransitions {
-    todo: string;
+    todo: string | string[];
     in_progress: string;
     done: string;
     testing?: string;

package/package.json

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