team-toon-tack 3.2.12 → 3.2.14

package/README.md

@@ -15,6 +15,7 @@ Optimized task workflow for Claude Code — supports Linear and Trello, saves si
 - **QA Team Support** — Auto-update parent issues in QA team to "Testing" when completing dev tasks (Linear)
 - **Attachment Download** — Auto-download images and files to local `.ttt/output/` for AI vision analysis
 - **Blocked Status** — Set tasks as blocked when waiting on external dependencies
+- **Persistent Estimates** — Store local human-effort estimates that survive future `ttt sync`
 - **Claude Code Plugin** — Install plugin for `/ttt:*` commands and auto-activated skills
 - **Cycle History** — Local `.toon` files preserve cycle data for AI context
 
@@ -76,6 +77,7 @@ In Claude Code (with plugin installed):
 ```
 /ttt:sync              # Fetch all issues/cards for current cycle
 /ttt:work-on next      # Pick highest priority task & start working
+/ttt:estimate MP-123 6 # Save a local 6-hour estimate
 /ttt:done              # Complete task with AI-generated summary
 ```
 
@@ -84,6 +86,7 @@ Or using CLI directly:
 ```bash
 ttt sync
 ttt work-on next
+ttt estimate MP-123 6
 ttt done -m "Completed the task"
 ```
 
@@ -125,6 +128,17 @@ ttt work-on MP-123       # Specific issue
 ttt work-on next         # Auto-select highest priority
 ```
 
+### `ttt estimate`
+
+Save a local human-effort estimate that persists in `.ttt/cycle.toon`.
+
+```bash
+ttt estimate MP-123 6                         # Save a 6-hour estimate
+ttt estimate 2.5                              # Save estimate for current in-progress task
+ttt estimate MP-123 16 --note "API pending"   # Save estimate with a note
+ttt estimate MP-123 --clear                   # Remove saved estimate
+```
+
 ### `ttt done`
 
 Mark task as completed.
@@ -184,7 +198,7 @@ your-project/
 └── .ttt/
     ├── config.toon     # Team config (gitignore recommended)
     ├── local.toon      # Personal settings (gitignore)
-    ├── cycle.toon      # Current cycle data (auto-generated)
+    ├── cycle.toon      # Current cycle data + local estimates (auto-generated)
     └── output/         # Downloaded attachments (images, files)
 ```
 
@@ -229,6 +243,7 @@ Install the plugin for Claude Code integration:
 |---------|-------------|
 | `/ttt:sync` | Sync issues to local cycle data |
 | `/ttt:work-on` | Start working on a task |
+| `/ttt:estimate` | Save a local human-effort estimate |
 | `/ttt:done` | Mark current task as completed |
 | `/ttt:status` | Show or modify task status |
 | `/ttt:show` | Show issue details or search issues |

package/README.zh-TW.md

@@ -15,6 +15,7 @@
 - **QA 團隊支援** — 完成開發任務時自動將 QA 團隊的 parent issue 更新為「Testing」（Linear）
 - **附件下載** — 自動下載圖片和檔案到本地 `.ttt/output/`，供 AI 視覺分析
 - **阻塞狀態** — 等待外部依賴時可設定任務為 blocked
+- **持久化估時** — 把人類工程工時估算寫進本地資料，後續 `ttt sync` 不會洗掉
 - **Claude Code Plugin** — 安裝 plugin 即可使用 `/ttt:*` 指令和自動啟用的技能
 - **Cycle 歷史保存** — 本地 `.toon` 檔案保留 cycle 資料，方便 AI 檢閱
 
@@ -76,6 +77,7 @@ ttt init
 ```
 /ttt:sync              # 取得當前 cycle 所有 issue/card
 /ttt:work-on next      # 挑選最高優先級任務並開始工作
+/ttt:estimate MP-123 6 # 寫入本地 6 小時估時
 /ttt:done              # 完成任務，附上 AI 生成的摘要
 ```
 
@@ -84,6 +86,7 @@ ttt init
 ```bash
 ttt sync
 ttt work-on next
+ttt estimate MP-123 6
 ttt done -m "完成任務"
 ```
 
@@ -125,6 +128,17 @@ ttt work-on MP-123       # 指定 issue
 ttt work-on next         # 自動選擇最高優先級
 ```
 
+### `ttt estimate`
+
+把人類工程工時估算寫進 `.ttt/cycle.toon`，並在之後的同步中保留下來。
+
+```bash
+ttt estimate MP-123 6                         # 寫入 6 小時估時
+ttt estimate 2.5                              # 對目前進行中的任務寫入 2.5 小時
+ttt estimate MP-123 16 --note "API pending"   # 連同註記一起保存
+ttt estimate MP-123 --clear                   # 移除既有估時
+```
+
 ### `ttt done`
 
 標記任務完成。
@@ -184,7 +198,7 @@ your-project/
 └── .ttt/
     ├── config.toon     # 團隊配置（建議 gitignore）
     ├── local.toon      # 個人設定（gitignore）
-    ├── cycle.toon      # 當前 cycle 資料（自動產生）
+    ├── cycle.toon      # 當前 cycle 資料與本地估時（自動產生）
     └── output/         # 下載的附件（圖片、檔案）
 ```
 
@@ -229,6 +243,7 @@ your-project/
 |------|------|
 | `/ttt:sync` | 同步 issue 到本地 |
 | `/ttt:work-on` | 開始處理任務 |
+| `/ttt:estimate` | 寫入本地人力估時 |
 | `/ttt:done` | 標記當前任務完成 |
 | `/ttt:status` | 顯示或修改任務狀態 |
 | `/ttt:show` | 顯示 issue 詳情或搜尋 issue |

package/commands/ttt:estimate.md

@@ -0,0 +1,68 @@
+---
+name: ttt:estimate
+description: Save a local human-effort estimate for a task
+arguments:
+  - name: issue-id
+    description: Issue ID to estimate (e.g., MP-624)
+    required: false
+  - name: hours
+    description: Estimated human engineer hours (supports decimals)
+    required: false
+  - name: note
+    description: Short estimate note or assumption summary
+    required: false
+  - name: clear
+    description: Remove the existing estimate from the task
+    required: false
+---
+
+<law>
+YOU MUST execute the `ttt estimate` command using the Bash tool.
+DO NOT manually edit cycle.toon — the CLI handles persistence safely.
+DO NOT put agent runtime here; store human engineer implementation effort only.
+</law>
+
+# /ttt:estimate — Save Task Estimate
+
+## Execution
+
+```bash
+ttt estimate {{ issue-id }} {{ hours }} {{ "--note \"" + note + "\"" if note }} {{ "--clear" if clear }}
+```
+
+### Common Examples
+
+```bash
+ttt estimate MP-624 6
+ttt estimate 2.5
+ttt estimate MP-624 16 --note "backend contract pending"
+ttt estimate MP-624 --clear
+```
+
+## Full CLI Reference
+
+```
+Usage: ttt estimate [issue-id] [hours] [options]
+
+Arguments:
+  issue-id              Optional. Issue ID (e.g., MP-624)
+  hours                 Estimated human engineer hours (supports decimals)
+
+Options:
+  -n, --note <text>     Short estimate note or assumption summary
+  --clear               Remove existing estimate from the task
+```
+
+## What It Does
+
+- Stores the estimate in local `.ttt/cycle.toon`
+- Preserves that estimate across future `ttt sync` runs
+- Lets `ttt show` and `ttt status` display the saved estimate
+
+## Error Handling
+
+| Error | Solution |
+|-------|----------|
+| `No cycle data found` | Run `ttt sync` first |
+| `No in-progress task found` | Specify `issue-id` explicitly |
+| `Estimated hours must be a positive number` | Pass a number like `2`, `4.5`, or `16` |

package/dist/bin/cli.js

@@ -10,6 +10,7 @@ const COMMANDS = [
     "init",
     "sync",
     "work-on",
+    "estimate",
     "done",
     "status",
     "show",
@@ -28,6 +29,7 @@ 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)
+  estimate   Store a local human-effort estimate for a task
   done       Mark current task as completed
   status     Show or modify task status
   show       Show issue details or search issues by filters
@@ -46,6 +48,7 @@ EXAMPLES:
   ttt work-on                   # Interactive task selection
   ttt work-on MP-123            # Work on specific issue
   ttt work-on next              # Auto-select highest priority
+  ttt estimate MP-123 6         # Save a 6-hour estimate locally
   ttt done                      # Complete current task
   ttt done -m "Fixed the bug"   # With completion message
   ttt show MP-123               # Show issue from local data
@@ -114,6 +117,10 @@ async function main() {
                 process.argv = ["node", "work-on.js", ...commandArgs];
                 await import(`${scriptDir}work-on.js`);
                 break;
+            case "estimate":
+                process.argv = ["node", "estimate.js", ...commandArgs];
+                await import(`${scriptDir}estimate.js`);
+                break;
             case "done":
                 process.argv = ["node", "done-job.js", ...commandArgs];
                 await import(`${scriptDir}done-job.js`);

package/dist/scripts/estimate.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env bun
+export {};

package/dist/scripts/estimate.js

@@ -0,0 +1,139 @@
+#!/usr/bin/env bun
+import { input, select } from "@inquirer/prompts";
+import { loadCycleData, saveCycleData } from "./utils.js";
+function parseEstimateArgs(args) {
+    const parsed = { clear: false };
+    for (let i = 0; i < args.length; i++) {
+        const arg = args[i];
+        if (arg === "--note" || arg === "-n") {
+            parsed.note = args[++i];
+            continue;
+        }
+        if (arg === "--clear") {
+            parsed.clear = true;
+            continue;
+        }
+        if (arg.startsWith("-")) {
+            continue;
+        }
+        if (!parsed.issueId && !/^\d+(\.\d+)?$/.test(arg)) {
+            parsed.issueId = arg;
+            continue;
+        }
+        if (parsed.hours === undefined) {
+            const hours = Number(arg);
+            if (!Number.isNaN(hours)) {
+                parsed.hours = hours;
+            }
+        }
+    }
+    return parsed;
+}
+function findTask(tasks, issueId) {
+    if (issueId) {
+        return tasks.find((task) => task.id === issueId || task.id === `MP-${issueId}`);
+    }
+    const inProgressTasks = tasks.filter((task) => task.localStatus === "in-progress");
+    if (inProgressTasks.length === 1) {
+        return inProgressTasks[0];
+    }
+    return undefined;
+}
+async function resolveTask(tasks, issueId) {
+    const directMatch = findTask(tasks, issueId);
+    if (directMatch) {
+        return directMatch;
+    }
+    if (issueId) {
+        return undefined;
+    }
+    const inProgressTasks = tasks.filter((task) => task.localStatus === "in-progress");
+    if (inProgressTasks.length === 0) {
+        return undefined;
+    }
+    if (!process.stdin.isTTY) {
+        return undefined;
+    }
+    const selectedId = await select({
+        message: "選擇要寫入估時的任務:",
+        choices: inProgressTasks.map((task) => ({
+            name: `${task.id}: ${task.title}`,
+            value: task.id,
+            description: task.estimate
+                ? `目前 ${task.estimate.hours}h`
+                : "尚未寫入 estimate",
+        })),
+    });
+    return tasks.find((task) => task.id === selectedId);
+}
+async function resolveHours(hours) {
+    if (hours !== undefined) {
+        return hours;
+    }
+    if (!process.stdin.isTTY) {
+        return undefined;
+    }
+    const answer = await input({
+        message: "預估工時（小時，可含小數）:",
+    });
+    const parsed = Number(answer);
+    return Number.isNaN(parsed) ? undefined : parsed;
+}
+async function estimate() {
+    const args = process.argv.slice(2);
+    if (args.includes("--help") || args.includes("-h")) {
+        console.log(`Usage: ttt estimate [issue-id] [hours] [options]
+
+Store a local human-effort estimate in cycle.toon.
+
+Arguments:
+  issue-id              Optional. Issue ID (e.g., MP-624). Defaults to current in-progress task.
+  hours                 Estimated hours as a human engineer (supports decimals)
+
+Options:
+  -n, --note <text>     Short note or assumption summary
+  --clear               Remove existing estimate from the task
+
+Examples:
+  ttt estimate MP-624 6
+  ttt estimate 2.5
+  ttt estimate MP-624 16 -n "backend contract pending"
+  ttt estimate MP-624 --clear`);
+        process.exit(0);
+    }
+    const { issueId, hours, note, clear } = parseEstimateArgs(args);
+    const data = await loadCycleData();
+    if (!data) {
+        console.error("No cycle data found. Run ttt sync first.");
+        process.exit(1);
+    }
+    const task = await resolveTask(data.tasks, issueId);
+    if (!task) {
+        console.error(issueId
+            ? `Issue ${issueId} not found in local data.`
+            : "No in-progress task found. Specify issue ID explicitly.");
+        process.exit(1);
+    }
+    if (clear) {
+        delete task.estimate;
+        await saveCycleData(data);
+        console.log(`Local: ${task.id} estimate cleared`);
+        process.exit(0);
+    }
+    const resolvedHours = await resolveHours(hours);
+    if (resolvedHours === undefined ||
+        Number.isNaN(resolvedHours) ||
+        resolvedHours <= 0) {
+        console.error("Estimated hours must be a positive number.");
+        process.exit(1);
+    }
+    task.estimate = {
+        hours: resolvedHours,
+        note: note || undefined,
+        updatedAt: new Date().toISOString(),
+    };
+    await saveCycleData(data);
+    const suffix = task.estimate.note ? ` (${task.estimate.note})` : "";
+    console.log(`Local: ${task.id} estimate → ${task.estimate.hours}h${suffix}`);
+}
+estimate().catch(console.error);

package/dist/scripts/lib/display.js

@@ -30,6 +30,10 @@ export function displayTaskInfo(task) {
     console.log(`Labels: ${task.labels.join(", ")}`);
     if (task.assignee)
         console.log(`Assignee: ${task.assignee}`);
+    if (task.estimate) {
+        const suffix = task.estimate.note ? ` (${task.estimate.note})` : "";
+        console.log(`Estimate: ${task.estimate.hours}h${suffix}`);
+    }
     if (task.url)
         console.log(`URL: ${task.url}`);
 }
@@ -93,6 +97,10 @@ export function displayTaskWithStatus(task) {
     console.log(`  Priority: ${PRIORITY_LABELS[task.priority] || "None"}`);
     console.log(`  Labels: ${task.labels.join(", ")}`);
     console.log(`  Assignee: ${task.assignee || "Unassigned"}`);
+    if (task.estimate) {
+        const suffix = task.estimate.note ? ` (${task.estimate.note})` : "";
+        console.log(`  Estimate: ${task.estimate.hours}h${suffix}`);
+    }
     if (task.url)
         console.log(`  URL: ${task.url}`);
     displayTaskDescription(task);

package/dist/scripts/lib/sync.js

@@ -1,4 +1,4 @@
-import { getLinearClient, getPrioritySortIndex, loadCycleData, saveCycleData, } from "../utils.js";
+import { getLinearClient, getPrioritySortIndex, loadCycleData, preserveLocalTaskFields, saveCycleData, } from "../utils.js";
 import { getStatusTransitions } from "./linear.js";
 import { mapRemoteToLocalStatus } from "./status-helpers.js";
 /**
@@ -65,7 +65,7 @@ export async function syncSingleIssue(issueId, options) {
     const { config, localConfig, preserveLocalStatus = true, } = options;
     const client = options.client ?? getLinearClient();
     // Fetch issue details using shared function
-    const task = await fetchIssueDetail(issueId, { client });
+    let task = await fetchIssueDetail(issueId, { client });
     if (!task) {
         console.error(`Issue ${issueId} not found in Linear.`);
         return null;
@@ -76,6 +76,7 @@ export async function syncSingleIssue(issueId, options) {
         const existingTask = existingData.tasks.find((t) => t.id === issueId);
         if (existingTask) {
             task.localStatus = existingTask.localStatus;
+            task = preserveLocalTaskFields(task, existingTask);
         }
     }
     // Map remote status to local status if not preserving
@@ -83,6 +84,10 @@ export async function syncSingleIssue(issueId, options) {
         const transitions = getStatusTransitions(config);
         task.localStatus = mapRemoteToLocalStatus(task.status, transitions, localConfig);
     }
+    if (existingData) {
+        const existingTask = existingData.tasks.find((t) => t.id === issueId);
+        task = preserveLocalTaskFields(task, existingTask);
+    }
     // Update cycle data
     if (existingData) {
         const existingTasks = existingData.tasks.filter((t) => t.id !== issueId);

package/dist/scripts/show.js

@@ -10,6 +10,10 @@ function taskToMarkdown(task) {
     lines.push(`- **Priority**: ${priority}`);
     lines.push(`- **Labels**: ${task.labels.length > 0 ? task.labels.join(", ") : "-"}`);
     lines.push(`- **Assignee**: ${task.assignee || "Unassigned"}`);
+    if (task.estimate) {
+        const note = task.estimate.note ? ` (${task.estimate.note})` : "";
+        lines.push(`- **Estimate**: ${task.estimate.hours}h${note}`);
+    }
     if (task.url)
         lines.push(`- **URL**: ${task.url}`);
     if (task.parentIssueId)
@@ -60,6 +64,10 @@ function tasksToMarkdownList(tasks) {
         lines.push(`| Status | ${task.status} |`);
         lines.push(`| Priority | ${priority} |`);
         lines.push(`| Assignee | ${assignee} |`);
+        if (task.estimate) {
+            const note = task.estimate.note ? ` (${task.estimate.note})` : "";
+            lines.push(`| Estimate | ${task.estimate.hours}h${note} |`);
+        }
         lines.push(`| Labels | ${task.labels.length > 0 ? task.labels.join(", ") : "-"} |`);
         if (task.url)
             lines.push(`| URL | ${task.url} |`);
@@ -79,8 +87,11 @@ function displayTaskList(tasks) {
         const priority = PRIORITY_LABELS[task.priority] || "⚪ None";
         const assignee = task.assignee ? task.assignee.split("@")[0] : "unassigned";
         const labels = task.labels.length > 0 ? task.labels.join(", ") : "-";
+        const estimate = task.estimate
+            ? ` | Estimate: ${task.estimate.hours}h`
+            : "";
         console.log(`${icon} ${task.id}: ${task.title}`);
-        console.log(`   Status: ${task.status} | Priority: ${priority} | Assignee: ${assignee}`);
+        console.log(`   Status: ${task.status} | Priority: ${priority} | Assignee: ${assignee}${estimate}`);
         console.log(`   Labels: ${labels}`);
         console.log("─".repeat(80));
     }

package/dist/scripts/status.js

@@ -24,6 +24,40 @@ function parseArgs(args) {
     }
     return { issueId, setStatus };
 }
+async function fetchTaskFromRemote(issueId, config) {
+    const adapter = createAdapter(config);
+    const sourceType = getSourceType(config);
+    const issue = await adapter.searchIssue(issueId);
+    if (!issue)
+        return undefined;
+    return {
+        id: issue.id,
+        linearId: issue.sourceId,
+        sourceId: issue.sourceId,
+        sourceType,
+        title: issue.title,
+        status: issue.status,
+        localStatus: "pending",
+        assignee: issue.assigneeEmail,
+        priority: issue.priority,
+        labels: issue.labels,
+        description: issue.description,
+        parentIssueId: issue.parentIssueId,
+        url: issue.url,
+        attachments: issue.attachments?.map((a) => ({
+            id: a.id,
+            title: a.title,
+            url: a.url,
+            sourceType: a.sourceType,
+        })),
+        comments: issue.comments?.map((c) => ({
+            id: c.id,
+            body: c.body,
+            createdAt: c.createdAt,
+            user: c.user,
+        })),
+    };
+}
 async function status() {
     const args = process.argv.slice(2);
     if (args.includes("--help") || args.includes("-h")) {
@@ -65,13 +99,15 @@ Examples:
     // Find task
     let task;
     let issueId = argIssueId;
+    let fromRemote = false;
     if (!issueId) {
         const inProgressTasks = data.tasks.filter((t) => t.localStatus === "in-progress");
         if (inProgressTasks.length === 0) {
             console.log("No in-progress task found.");
             console.log("\nAll tasks:");
             for (const t of data.tasks) {
-                console.log(`  ${getStatusIcon(t.localStatus)} ${t.id}: ${t.title} [${t.localStatus}]`);
+                const estimate = t.estimate ? ` | ${t.estimate.hours}h` : "";
+                console.log(`  ${getStatusIcon(t.localStatus)} ${t.id}: ${t.title} [${t.localStatus}]${estimate}`);
             }
             process.exit(0);
         }
@@ -81,8 +117,15 @@ Examples:
     else {
         task = data.tasks.find((t) => t.id === issueId || t.id === `MP-${issueId}`);
         if (!task) {
-            console.error(`Issue ${issueId} not found in local data.`);
-            process.exit(1);
+            // Fetch from remote
+            console.error(`Issue ${issueId} not in local data. Fetching from remote...`);
+            task = await fetchTaskFromRemote(issueId, config);
+            if (!task) {
+                console.error(`Issue ${issueId} not found.`);
+                process.exit(1);
+            }
+            issueId = task.id;
+            fromRemote = true;
         }
     }
     // If setting status
@@ -181,6 +224,9 @@ Examples:
         }
         // Save if anything changed
         if (needsSave) {
+            if (fromRemote) {
+                data.tasks.push(task);
+            }
             await saveCycleData(data);
             if (newLocalStatus && newLocalStatus !== oldLocalStatus) {
                 console.log(`Local: ${task.id} ${oldLocalStatus} → ${newLocalStatus}`);

package/dist/scripts/sync.js

@@ -1,7 +1,7 @@
 import { createAdapter } from "./lib/adapters/index.js";
 import { clearAllOutput, clearIssueImages, downloadLinearImage, downloadTrelloFile, ensureOutputDir, extractImageUrls, isLinearImageUrl, } from "./lib/files.js";
 import { getReviewStatuses, getSyncStatuses, resolveLocalStatus, } from "./lib/status-helpers.js";
-import { getLinearClient, getPaths, getPrioritySortIndex, getSourceType, getTeamId, loadConfig, loadCycleData, loadLocalConfig, saveConfig, saveCycleData, } from "./utils.js";
+import { getLinearClient, getPaths, getPrioritySortIndex, getSourceType, getTeamId, loadConfig, loadCycleData, loadLocalConfig, preserveLocalTaskFields, saveConfig, saveCycleData, } from "./utils.js";
 async function downloadEmbeddedImages(texts, issueId, attachments, outputDir, downloadFile, titlePrefix, sourceType, filterUrl) {
     let imageIndex = 0;
     for (const text of texts) {
@@ -332,7 +332,8 @@ Examples:
                 localStatus = "completed";
             }
         }
-        const task = {
+        const existingTask = existingTasksMap.get(issue.identifier);
+        const task = preserveLocalTaskFields({
             id: issue.identifier,
             linearId: issue.id,
             title: issue.title,
@@ -346,7 +347,7 @@ Examples:
             url: issue.url,
             attachments: attachments.length > 0 ? attachments : undefined,
             comments: comments.length > 0 ? comments : undefined,
-        };
+        }, existingTask);
         tasks.push(task);
     }
     // Sort by priority using config order
@@ -545,7 +546,8 @@ async function syncTrello(config, localConfig, options) {
         else {
             localStatus = resolveLocalStatus(undefined, issue.status, statusTransitions, localConfig);
         }
-        const task = {
+        const existingTask = existingTasksMap.get(issue.id);
+        const task = preserveLocalTaskFields({
             id: issue.id,
             linearId: issue.sourceId, // For backwards compatibility
             sourceId: issue.sourceId,
@@ -561,7 +563,7 @@ async function syncTrello(config, localConfig, options) {
             url: issue.url,
             attachments: attachments.length > 0 ? attachments : undefined,
             comments: comments.length > 0 ? comments : undefined,
-        };
+        }, existingTask);
         tasks.push(task);
     }
     // Sort by priority

package/dist/scripts/utils.d.ts

@@ -82,6 +82,11 @@ export interface Comment {
     createdAt: string;
     user?: string;
 }
+export interface TaskEstimate {
+    hours: number;
+    note?: string;
+    updatedAt: string;
+}
 export interface Task {
     id: string;
     /** @deprecated Use sourceId instead. Kept for backwards compatibility. */
@@ -103,6 +108,7 @@ export interface Task {
     url?: string;
     attachments?: Attachment[];
     comments?: Comment[];
+    estimate?: TaskEstimate;
 }
 export interface CycleData {
     cycleId: string;
@@ -135,3 +141,4 @@ export declare function getDefaultTeamKey(config: Config): string;
 export declare function getTeamId(config: Config, teamKey?: string): string;
 export declare function getSourceType(config: Config): TaskSourceType;
 export declare function getTaskSourceId(task: Task): string;
+export declare function preserveLocalTaskFields(task: Task, existingTask?: Task): Task;

package/dist/scripts/utils.js

@@ -151,3 +151,13 @@ export function getSourceType(config) {
 export function getTaskSourceId(task) {
     return task.sourceId ?? task.linearId;
 }
+export function preserveLocalTaskFields(task, existingTask) {
+    if (!existingTask) {
+        return task;
+    }
+    return {
+        ...task,
+        branch: existingTask.branch ?? task.branch,
+        estimate: existingTask.estimate ?? task.estimate,
+    };
+}

package/package.json

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

package/skills/managing-linear-tasks/SKILL.md

@@ -23,6 +23,7 @@ Match user intent to the correct `/ttt:*` command:
 | Sync/fetch issues | `/ttt:sync` | "sync my issues", "pull from Linear" |
 | Show/search issues | `/ttt:show` | "show MP-624", "list my tasks", "what issues do I have" |
 | Start working on a task | `/ttt:work-on` | "work on next", "start MP-624" |
+| Record an estimate | `/ttt:estimate` | "estimate MP-624 as 6h", "save 2.5h estimate" |
 | Check/change status | `/ttt:status` | "what's my current task", "set MP-624 to blocked" |
 | Complete a task | `/ttt:done` | "done", "mark complete", "finish task" |
 
@@ -39,6 +40,7 @@ ttt show MP-624             # Show issue details
 ttt show --user me          # My issues
 ttt work-on next            # Auto-select highest priority
 ttt work-on MP-624          # Start specific task
+ttt estimate MP-624 6       # Save a 6-hour human estimate
 ttt status                  # Current in-progress task
 ttt status MP-624 --set +1  # Advance status
 ttt done -m "summary"       # Complete with message
@@ -53,7 +55,7 @@ ttt done -m "summary"       # Complete with message
 ## Standard Workflow
 
 ```
-ttt sync → ttt work-on next → [implement] → git commit → ttt done -m "..."
+ttt sync → ttt work-on next → ttt estimate <id> <hours> → [implement] → git commit → ttt done -m "..."
 ```
 
 ## File Structure
@@ -62,7 +64,7 @@ ttt sync → ttt work-on next → [implement] → git commit → ttt done -m "..
 .ttt/
 ├── config.toon     # Team configuration
 ├── local.toon      # Personal settings
-├── cycle.toon      # Current cycle tasks (auto-generated)
+├── cycle.toon      # Current cycle tasks + local estimates (auto-generated)
 └── output/         # Downloaded attachments
 ```