team-toon-tack 2.3.0 → 2.3.2

package/.claude-plugin/marketplace.json

@@ -13,7 +13,7 @@
 			"name": "team-toon-tack",
 			"source": "./",
 			"description": "Linear task sync & management CLI with commands and skills",
-			"version": "2.3.0"
+			"version": "2.3.2"
 		}
 	]
 }

package/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
 	"name": "team-toon-tack",
 	"description": "Linear task sync & management CLI for Claude Code - saves tokens vs MCP",
-	"version": "2.3.0",
+	"version": "2.3.2",
 	"author": {
 		"name": "wayne930242",
 		"email": "wayne930242@gmail.com"

package/README.md

@@ -14,7 +14,7 @@ Optimized Linear workflow for Claude Code — saves significant tokens compared
 - **QA Team Support** — Auto-update parent issues in QA team to "Testing" when completing dev tasks
 - **Attachment Download** — Auto-download Linear images and files to local `.ttt/output/` for AI vision analysis
 - **Blocked Status** — Set tasks as blocked when waiting on external dependencies
-- **Claude Code Plugin** — Install plugin for `/ttt-*` commands and auto-activated skills
+- **Claude Code Plugin** — Install plugin for `/ttt:*` commands and auto-activated skills
 - **Cycle History** — Local `.toon` files preserve cycle data for AI context
 - **User Filtering** — Only see issues assigned to you or unassigned
 
@@ -58,9 +58,9 @@ During init, you'll configure:
 In Claude Code (with plugin installed):
 
 ```
-/ttt-sync              # Fetch all Linear issues for current cycle
-/ttt-work-on next      # Pick highest priority task & start working
-/ttt-done              # Complete task with AI-generated summary
+/ttt:sync              # Fetch all Linear issues for current cycle
+/ttt:work-on next      # Pick highest priority task & start working
+/ttt:done              # Complete task with AI-generated summary
 ```
 
 Or using CLI directly:
@@ -128,13 +128,18 @@ ttt status MP-123 --set done    # Mark as done
 ttt status MP-123 --set blocked # Set as blocked (waiting on dependency)
 ```
 
-### `ttt get-issue`
+### `ttt show`
 
-Fetch and display issue details from Linear.
+Show issue details or search issues from local cycle data.
 
 ```bash
-ttt get-issue MP-123           # Fetch from Linear and display
-ttt get-issue MP-123 --local   # Show from local data only
+ttt show                       # Show all issues in local cycle data
+ttt show MP-123                # Show specific issue from local data
+ttt show MP-123 --remote       # Fetch specific issue from Linear
+ttt show --label frontend      # Filter by label
+ttt show --status "In Progress" --user me   # My in-progress issues
+ttt show --priority 1          # Show urgent issues
+ttt show --export              # Export as markdown
 ```
 
 ### `ttt config`
@@ -181,11 +186,11 @@ Install the plugin for Claude Code integration:
 
 | Command | Description |
 |---------|-------------|
-| `/ttt-sync` | Sync Linear issues to local cycle data |
-| `/ttt-work-on` | Start working on a task |
-| `/ttt-done` | Mark current task as completed |
-| `/ttt-status` | Show or modify task status |
-| `/ttt-get-issue` | Fetch and display issue details |
+| `/ttt:sync` | Sync Linear issues to local cycle data |
+| `/ttt:work-on` | Start working on a task |
+| `/ttt:done` | Mark current task as completed |
+| `/ttt:status` | Show or modify task status |
+| `/ttt:show` | Show issue details or search issues |
 
 ### Auto-Activated Skill
 

package/README.zh-TW.md

@@ -14,7 +14,7 @@
 - **QA 團隊支援** — 完成開發任務時自動將 QA 團隊的 parent issue 更新為「Testing」
 - **附件下載** — 自動下載 Linear 圖片和檔案到本地 `.ttt/output/`，供 AI 視覺分析
 - **阻塞狀態** — 等待外部依賴時可設定任務為 blocked
-- **Claude Code Plugin** — 安裝 plugin 即可使用 `/ttt-*` 指令和自動啟用的技能
+- **Claude Code Plugin** — 安裝 plugin 即可使用 `/ttt:*` 指令和自動啟用的技能
 - **Cycle 歷史保存** — 本地 `.toon` 檔案保留 cycle 資料，方便 AI 檢閱
 - **使用者過濾** — 只顯示指派給你或未指派的工作
 
@@ -58,9 +58,9 @@ ttt init
 在 Claude Code 中（安裝 plugin 後）：
 
 ```
-/ttt-sync              # 從 Linear 取得當前 cycle 所有 issue
-/ttt-work-on next      # 挑選最高優先級任務並開始工作
-/ttt-done              # 完成任務，附上 AI 生成的摘要
+/ttt:sync              # 從 Linear 取得當前 cycle 所有 issue
+/ttt:work-on next      # 挑選最高優先級任務並開始工作
+/ttt:done              # 完成任務，附上 AI 生成的摘要
 ```
 
 或直接使用 CLI：
@@ -128,13 +128,18 @@ ttt status MP-123 --set done    # 標記為完成
 ttt status MP-123 --set blocked # 設為阻塞（等待外部依賴）
 ```
 
-### `ttt get-issue`
+### `ttt show`
 
-從 Linear 取得並顯示 issue 詳細資訊。
+顯示 issue 詳情或搜尋 issue。
 
 ```bash
-ttt get-issue MP-123           # 從 Linear 取得並顯示
-ttt get-issue MP-123 --local   # 只從本地資料顯示
+ttt show                       # 顯示本地 cycle 資料中的所有 issue
+ttt show MP-123                # 顯示特定 issue（從本地資料）
+ttt show MP-123 --remote       # 從 Linear 取得特定 issue
+ttt show --label frontend      # 依標籤過濾
+ttt show --status "In Progress" --user me   # 我進行中的 issue
+ttt show --priority 1          # 顯示緊急 issue
+ttt show --export              # 輸出為 markdown 格式
 ```
 
 ### `ttt config`
@@ -181,11 +186,11 @@ your-project/
 
 | 指令 | 說明 |
 |------|------|
-| `/ttt-sync` | 同步 Linear issue 到本地 |
-| `/ttt-work-on` | 開始處理任務 |
-| `/ttt-done` | 標記當前任務完成 |
-| `/ttt-status` | 顯示或修改任務狀態 |
-| `/ttt-get-issue` | 取得並顯示 issue 詳情 |
+| `/ttt:sync` | 同步 Linear issue 到本地 |
+| `/ttt:work-on` | 開始處理任務 |
+| `/ttt:done` | 標記當前任務完成 |
+| `/ttt:status` | 顯示或修改任務狀態 |
+| `/ttt:show` | 顯示 issue 詳情或搜尋 issue |
 
 ### 自動啟用技能
 

package/commands/{ttt-done.md → ttt:done.md}

@@ -1,5 +1,5 @@
 ---
-name: ttt-done
+name: ttt:done
 description: Mark current task as completed
 arguments:
   - name: issue-id
@@ -57,6 +57,8 @@ Also:
 ## Before Running
 
 Ensure you have:
-1. Committed your changes with a meaningful message
-2. Run tests and lint checks
+1. **Run project validation** - Use `/validate` command or validation skill if available
+2. Committed your changes with a meaningful message
 3. Pushed to remote branch (if applicable)
+
+**Important**: If validation fails, fix issues before marking as done.

package/commands/ttt:show.md

@@ -0,0 +1,126 @@
+---
+name: ttt:show
+description: Show issue details or search issues from local cycle data
+arguments:
+  - name: issue-id
+    description: Issue ID to show (e.g., MP-624)
+    required: false
+  - name: label
+    description: Filter by label (--label <label>)
+    required: false
+  - name: status
+    description: Filter by status (--status <status>)
+    required: false
+  - name: user
+    description: Filter by assignee (--user <email|me|unassigned>)
+    required: false
+  - name: priority
+    description: Filter by priority (--priority <0-4>)
+    required: false
+  - name: remote
+    description: Fetch from Linear instead of local data (--remote)
+    required: false
+  - name: export
+    description: Output as markdown format (--export)
+    required: false
+---
+
+# TTT Show Command
+
+Show issue details or search issues from local cycle data.
+
+## Usage
+
+### Show All Issues
+```bash
+ttt show
+```
+
+### Show Specific Issue
+```bash
+ttt show {{ issue-id }}
+```
+
+### Search by Filters
+```bash
+ttt show --label {{ label }}
+ttt show --status "{{ status }}"
+ttt show --user {{ user }}
+ttt show --priority {{ priority }}
+```
+
+### Fetch from Linear (Remote)
+```bash
+ttt show {{ issue-id }} --remote
+ttt show --remote --status todo
+```
+
+## What This Does
+
+1. By default, reads from local cycle.toon data (no API calls)
+2. Supports filtering by label, status, user, priority
+3. Use --remote to fetch fresh data from Linear API
+4. Displays comprehensive information:
+   - Title and description
+   - Status (both Linear and local)
+   - Priority level
+   - Labels
+   - Assignee
+   - Branch name
+   - Parent issue (if subtask)
+   - Attachments with local paths
+   - Comments with timestamps
+
+## Filter Options
+
+| Option | Description | Example |
+|--------|-------------|---------|
+| `--label` | Filter by label name | `--label frontend` |
+| `--status` | Filter by Linear status | `--status "In Progress"` |
+| `--user` | Filter by assignee | `--user me`, `--user unassigned` |
+| `--priority` | Filter by priority (0-4) | `--priority 1` (Urgent) |
+| `--remote` | Fetch from Linear API | `--remote` |
+| `--export` | Output as markdown | `--export` |
+
+## Priority Values
+
+- 0: None
+- 1: Urgent
+- 2: High
+- 3: Medium
+- 4: Low
+
+## Use Cases
+
+- List all issues in current cycle
+- Search issues by label or status
+- Review issue details before starting work
+- Check requirements and acceptance criteria
+- View attachments and mockups
+- Read comment history and discussions
+
+## Examples
+
+```bash
+# Show all local issues
+ttt show
+
+# Show specific issue
+ttt show MP-624
+
+# My in-progress issues
+ttt show --status "In Progress" --user me
+
+# All urgent issues
+ttt show --priority 1
+
+# Frontend issues
+ttt show --label frontend
+
+# Fetch fresh data from Linear
+ttt show MP-624 --remote
+
+# Export as markdown
+ttt show --export
+ttt show MP-624 --export
+```

package/commands/{ttt-status.md → ttt:status.md}

@@ -1,5 +1,5 @@
 ---
-name: ttt-status
+name: ttt:status
 description: Show or modify task status
 arguments:
   - name: issue-id

package/commands/{ttt-sync.md → ttt:sync.md}

@@ -1,5 +1,5 @@
 ---
-name: ttt-sync
+name: ttt:sync
 description: Sync Linear issues to local cycle data
 arguments:
   - name: issue-id

package/commands/{ttt-work-on.md → ttt:work-on.md}

@@ -1,5 +1,5 @@
 ---
-name: ttt-work-on
+name: ttt:work-on
 description: Start working on a Linear task
 arguments:
   - name: issue-id
@@ -44,5 +44,36 @@ ttt work-on next
 
 1. Read the task description and requirements
 2. Check out the suggested branch: `git checkout -b <branch-name>`
-3. Run type-check and lint before starting: `bun type-check && bun lint`
+3. **Run project validation** (see below)
 4. Begin implementation
+
+## Project Validation
+
+Before starting work, check for validation tools:
+
+### 1. Check for Existing Validation
+
+Look for:
+- **Commands**: `/validate`, `/check`, `/lint` in available commands
+- **Skills**: `validate`, `check`, `verify` in available skills
+- **Scripts**: `lint`, `type-check`, `test` in `package.json` or `Makefile`
+
+### 2. If No Validation Found
+
+Ask user:
+```
+No validation command or skill found for this project.
+Would you like to create one? (y/n)
+```
+
+If yes, run:
+```
+/ttt:write-validate
+```
+
+### 3. Run Validation
+
+Once validation is available:
+- Use `/validate` command if exists
+- Or use validation skill if available
+- Or run detected scripts directly

package/commands/ttt:write-validate.md

@@ -0,0 +1,122 @@
+---
+name: ttt:write-validate
+description: Create a project validation command by detecting project type and existing lint/test configurations
+arguments:
+  - name: command-name
+    description: Name for the command (default: validate)
+    required: false
+---
+
+# TTT Write-Validate Command
+
+Create a project-specific validation command by analyzing the codebase.
+
+## Process
+
+### 1. Detect Project Type
+
+Check for project indicators:
+
+| File | Project Type |
+|------|--------------|
+| `package.json` | Node.js / Bun |
+| `Cargo.toml` | Rust |
+| `go.mod` | Go |
+| `pyproject.toml`, `requirements.txt` | Python |
+
+### 2. Find Existing Configurations
+
+Look for static analysis configs:
+
+**Linting**: `biome.json`, `.eslintrc.*`, `ruff.toml`
+**Type Check**: `tsconfig.json`, `mypy.ini`
+**Testing**: `jest.config.*`, `vitest.config.*`, `pytest.ini`
+
+### 3. Check package.json Scripts
+
+If Node.js project:
+```bash
+cat package.json | jq '.scripts | keys[]' 2>/dev/null
+```
+
+Look for: `lint`, `type-check`, `test`, `check`, `validate`
+
+### 4. Create Command File
+
+Create `.claude/commands/{{ $1 | default: "validate" }}.md`:
+
+```markdown
+---
+name: {{ $1 | default: "validate" }}
+description: Run project validation (lint, type-check, test)
+---
+
+# Project Validation
+
+Run validation checks for this project.
+
+## Process
+
+### 1. Lint
+\`\`\`bash
+{{ lint-command }}
+\`\`\`
+
+### 2. Type Check
+\`\`\`bash
+{{ type-check-command }}
+\`\`\`
+
+### 3. Test (optional)
+\`\`\`bash
+{{ test-command }}
+\`\`\`
+
+## Quick Validate All
+
+\`\`\`bash
+{{ combined-command }}
+\`\`\`
+
+## On Failure
+
+1. Show error output
+2. Identify failing file(s) and line(s)
+3. Suggest fixes
+4. Re-run validation after fixes
+```
+
+### 5. Output
+
+After creating:
+1. Show created file path
+2. Display detected validation commands
+3. Suggest running `/{{ $1 | default: "validate" }}` to test
+
+## Examples
+
+### Node.js with Biome
+```
+Detected: Node.js project with Biome + TypeScript
+Created: .claude/commands/validate.md
+
+Commands:
+  Lint: bun run lint
+  Type: bun run type-check
+  Test: bun run test
+
+Try: /validate
+```
+
+### Python with Ruff
+```
+Detected: Python project with Ruff + mypy
+Created: .claude/commands/validate.md
+
+Commands:
+  Lint: ruff check .
+  Type: mypy .
+  Test: pytest
+
+Try: /validate
+```

package/dist/bin/cli.js

@@ -12,7 +12,7 @@ const COMMANDS = [
     "work-on",
     "done",
     "status",
-    "get-issue",
+    "show",
     "config",
     "help",
     "version",
@@ -30,7 +30,7 @@ COMMANDS:
   work-on    Start working on a task (interactive or by ID)
   done       Mark current task as completed
   status     Show or modify task status
-  get-issue  Fetch and display issue details from Linear
+  show       Show issue details or search issues by filters
   config     Configure settings (status mappings, filters)
   help       Show this help message
   version    Show version
@@ -48,7 +48,9 @@ EXAMPLES:
   ttt work-on next              # Auto-select highest priority
   ttt done                      # Complete current task
   ttt done -m "Fixed the bug"   # With completion message
-  ttt get-issue MP-123          # Fetch issue details from Linear
+  ttt show MP-123               # Show issue from local data
+  ttt show --label frontend     # Search local issues by label
+  ttt show --status "In Progress"  # Filter by status
 
 ENVIRONMENT:
   LINEAR_API_KEY    Required. Your Linear API key
@@ -120,9 +122,9 @@ async function main() {
                 process.argv = ["node", "status.js", ...commandArgs];
                 await import(`${scriptDir}status.js`);
                 break;
-            case "get-issue":
-                process.argv = ["node", "get-issue.js", ...commandArgs];
-                await import(`${scriptDir}get-issue.js`);
+            case "show":
+                process.argv = ["node", "show.js", ...commandArgs];
+                await import(`${scriptDir}show.js`);
                 break;
             case "config":
                 process.argv = ["node", "config.js", ...commandArgs];

package/dist/scripts/init.js

@@ -400,21 +400,9 @@ async function updateGitignore(tttDir, interactive) {
         // Silently ignore gitignore errors
     }
 }
-async function showPluginInstallInstructions(interactive) {
-    if (!interactive) {
-        return false;
-    }
+function showPluginInstallInstructions() {
     console.log("\n🤖 Claude Code Plugin:");
-    const { showInstructions } = await prompts({
-        type: "confirm",
-        name: "showInstructions",
-        message: "Show Claude Code plugin installation instructions? (provides /ttt-* commands)",
-        initial: true,
-    });
-    if (!showInstructions) {
-        return false;
-    }
-    console.log("\n┌─────────────────────────────────────────────────────────────┐");
+    console.log("┌─────────────────────────────────────────────────────────────┐");
     console.log("│  Install team-toon-tack plugin in Claude Code:             │");
     console.log("├─────────────────────────────────────────────────────────────┤");
     console.log("│                                                             │");
@@ -425,14 +413,13 @@ async function showPluginInstallInstructions(interactive) {
     console.log("│     /plugin install team-toon-tack@wayne930242              │");
     console.log("│                                                             │");
     console.log("│  Available commands after install:                          │");
-    console.log("│     /ttt-sync        - Sync Linear issues                   │");
-    console.log("│     /ttt-work-on     - Start working on a task              │");
-    console.log("│     /ttt-done        - Complete current task                │");
-    console.log("│     /ttt-status      - Show/modify task status              │");
-    console.log("│     /ttt-get-issue   - Fetch issue details                  │");
+    console.log("│     /ttt:sync        - Sync Linear issues                   │");
+    console.log("│     /ttt:work-on     - Start working on a task              │");
+    console.log("│     /ttt:done        - Complete current task                │");
+    console.log("│     /ttt:status      - Show/modify task status              │");
+    console.log("│     /ttt:show        - Show/search issues                   │");
     console.log("│                                                             │");
     console.log("└─────────────────────────────────────────────────────────────┘");
-    return true;
 }
 async function init() {
     const args = process.argv.slice(2);
@@ -625,7 +612,7 @@ async function init() {
     // Update .gitignore (always use relative path .ttt)
     await updateGitignore(".ttt", options.interactive ?? true);
     // Show Claude Code plugin installation instructions
-    const pluginInstructionsShown = await showPluginInstallInstructions(options.interactive ?? true);
+    showPluginInstallInstructions();
     // Summary
     console.log("\n✅ Initialization complete!\n");
     console.log("Configuration summary:");
@@ -659,8 +646,5 @@ async function init() {
     console.log(`     export LINEAR_API_KEY="${apiKey}"`);
     console.log("  2. Run sync: ttt sync");
     console.log("  3. Start working: ttt work-on");
-    if (pluginInstructionsShown) {
-        console.log("\n💡 Tip: Install the Claude Code plugin for /ttt-* commands.");
-    }
 }
 init().catch(console.error);

package/dist/scripts/show.d.ts

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

package/dist/scripts/show.js

@@ -0,0 +1,319 @@
+import { displayTaskFull, PRIORITY_LABELS, getStatusIcon } from "./lib/display.js";
+import { fetchIssueDetail } from "./lib/sync.js";
+import { getLinearClient, getTeamId, loadConfig, loadCycleData, loadLocalConfig, } from "./utils.js";
+function taskToMarkdown(task) {
+    const lines = [];
+    const priority = PRIORITY_LABELS[task.priority] || "None";
+    lines.push(`## ${task.id}: ${task.title}`);
+    lines.push("");
+    lines.push(`- **Status**: ${task.status} (Local: ${task.localStatus})`);
+    lines.push(`- **Priority**: ${priority}`);
+    lines.push(`- **Labels**: ${task.labels.length > 0 ? task.labels.join(", ") : "-"}`);
+    lines.push(`- **Assignee**: ${task.assignee || "Unassigned"}`);
+    if (task.branch)
+        lines.push(`- **Branch**: \`${task.branch}\``);
+    if (task.url)
+        lines.push(`- **URL**: ${task.url}`);
+    if (task.parentIssueId)
+        lines.push(`- **Parent**: ${task.parentIssueId}`);
+    if (task.description) {
+        lines.push("");
+        lines.push("### Description");
+        lines.push("");
+        lines.push(task.description);
+    }
+    if (task.attachments && task.attachments.length > 0) {
+        lines.push("");
+        lines.push("### Attachments");
+        lines.push("");
+        for (const att of task.attachments) {
+            const path = att.localPath || att.url;
+            lines.push(`- ${att.title}: ${path}`);
+        }
+    }
+    if (task.comments && task.comments.length > 0) {
+        lines.push("");
+        lines.push("### Comments");
+        for (const comment of task.comments) {
+            const date = new Date(comment.createdAt).toLocaleDateString();
+            lines.push("");
+            lines.push(`**${comment.user || "Unknown"}** - ${date}`);
+            lines.push("");
+            lines.push(comment.body);
+        }
+    }
+    return lines.join("\n");
+}
+function tasksToMarkdownList(tasks) {
+    if (tasks.length === 0) {
+        return "No issues found.";
+    }
+    const lines = [];
+    lines.push(`# Issues (${tasks.length})`);
+    lines.push("");
+    for (const task of tasks) {
+        const icon = getStatusIcon(task.localStatus);
+        const priority = PRIORITY_LABELS[task.priority] || "None";
+        const assignee = task.assignee ? task.assignee.split("@")[0] : "unassigned";
+        lines.push(`## ${icon} ${task.id}: ${task.title}`);
+        lines.push("");
+        lines.push(`| Field | Value |`);
+        lines.push(`|-------|-------|`);
+        lines.push(`| Status | ${task.status} |`);
+        lines.push(`| Priority | ${priority} |`);
+        lines.push(`| Assignee | ${assignee} |`);
+        lines.push(`| Labels | ${task.labels.length > 0 ? task.labels.join(", ") : "-"} |`);
+        if (task.url)
+            lines.push(`| URL | ${task.url} |`);
+        lines.push("");
+    }
+    return lines.join("\n");
+}
+function displayTaskList(tasks) {
+    if (tasks.length === 0) {
+        console.log("No issues found.");
+        return;
+    }
+    console.log(`\nFound ${tasks.length} issue(s):\n`);
+    console.log("─".repeat(80));
+    for (const task of tasks) {
+        const icon = getStatusIcon(task.localStatus);
+        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(", ") : "-";
+        console.log(`${icon} ${task.id}: ${task.title}`);
+        console.log(`   Status: ${task.status} | Priority: ${priority} | Assignee: ${assignee}`);
+        console.log(`   Labels: ${labels}`);
+        console.log("─".repeat(80));
+    }
+}
+async function searchIssuesFromLinear(filters) {
+    const config = await loadConfig();
+    const localConfig = await loadLocalConfig();
+    const client = getLinearClient();
+    const teamId = getTeamId(config, localConfig.team);
+    // Build filter
+    const issueFilter = {
+        team: { id: { eq: teamId } },
+    };
+    if (filters.label) {
+        issueFilter.labels = { name: { containsIgnoreCase: filters.label } };
+    }
+    if (filters.status) {
+        issueFilter.state = { name: { containsIgnoreCase: filters.status } };
+    }
+    if (filters.assignee) {
+        if (filters.assignee.toLowerCase() === "me") {
+            issueFilter.assignee = { email: { eq: localConfig.current_user } };
+        }
+        else if (filters.assignee.toLowerCase() === "unassigned") {
+            issueFilter.assignee = { null: true };
+        }
+        else {
+            issueFilter.assignee = { email: { containsIgnoreCase: filters.assignee } };
+        }
+    }
+    if (filters.priority !== undefined) {
+        issueFilter.priority = { eq: filters.priority };
+    }
+    const issues = await client.issues({
+        filter: issueFilter,
+        first: 50,
+    });
+    const tasks = [];
+    for (const issueNode of issues.nodes) {
+        const issue = await client.issue(issueNode.id);
+        const assignee = await issue.assignee;
+        const labels = await issue.labels();
+        const state = await issue.state;
+        const parent = await issue.parent;
+        const task = {
+            id: issue.identifier,
+            linearId: issue.id,
+            title: issue.title,
+            status: state ? state.name : "Unknown",
+            localStatus: "pending",
+            assignee: assignee?.email,
+            priority: issue.priority,
+            labels: labels.nodes.map((l) => l.name),
+            branch: issue.branchName,
+            description: issue.description ?? undefined,
+            parentIssueId: parent ? parent.identifier : undefined,
+            url: issue.url,
+        };
+        tasks.push(task);
+    }
+    return tasks;
+}
+async function searchIssuesFromLocal(data, filters) {
+    let tasks = data.tasks;
+    if (filters.label) {
+        const labelLower = filters.label.toLowerCase();
+        tasks = tasks.filter((t) => t.labels.some((l) => l.toLowerCase().includes(labelLower)));
+    }
+    if (filters.status) {
+        const statusLower = filters.status.toLowerCase();
+        tasks = tasks.filter((t) => t.status.toLowerCase().includes(statusLower));
+    }
+    if (filters.assignee) {
+        const assigneeLower = filters.assignee.toLowerCase();
+        if (assigneeLower === "unassigned") {
+            tasks = tasks.filter((t) => !t.assignee);
+        }
+        else if (assigneeLower === "me") {
+            const localConfig = await loadLocalConfig();
+            const config = await loadConfig();
+            const userEmail = config.users[localConfig.current_user]?.email?.toLowerCase();
+            if (userEmail) {
+                tasks = tasks.filter((t) => t.assignee?.toLowerCase() === userEmail);
+            }
+        }
+        else {
+            tasks = tasks.filter((t) => t.assignee?.toLowerCase().includes(assigneeLower));
+        }
+    }
+    if (filters.priority !== undefined) {
+        tasks = tasks.filter((t) => t.priority === filters.priority);
+    }
+    return tasks;
+}
+async function show() {
+    const args = process.argv.slice(2);
+    if (args.includes("--help") || args.includes("-h")) {
+        console.log(`Usage: ttt show [issue-id] [options]
+
+Show issue details or search for issues from local cycle data.
+
+Arguments:
+  issue-id    Optional. Show specific issue (e.g., MP-624)
+
+Options:
+  --remote          Fetch from Linear instead of local data
+  --export          Output as markdown format
+  --label <label>   Filter by label
+  --status <status> Filter by status
+  --user <email>    Filter by assignee (use "me" for yourself, "unassigned" for no assignee)
+  --priority <n>    Filter by priority (0=None, 1=Urgent, 2=High, 3=Medium, 4=Low)
+
+Examples:
+  ttt show                       # Show all issues in local cycle data
+  ttt show MP-624                # Show specific issue from local data
+  ttt show MP-624 --remote       # Fetch specific issue from Linear
+  ttt show MP-624 --export       # Export issue as markdown
+  ttt show --label frontend      # Filter local issues by label
+  ttt show --status "In Progress" --user me   # My in-progress issues
+  ttt show --priority 1          # Show all urgent issues
+  ttt show --export              # Export all issues as markdown`);
+        process.exit(0);
+    }
+    const useRemote = args.includes("--remote");
+    const exportMarkdown = args.includes("--export");
+    // Parse filters
+    const filters = {};
+    for (let i = 0; i < args.length; i++) {
+        const arg = args[i];
+        if (arg === "--label" && args[i + 1]) {
+            filters.label = args[++i];
+        }
+        else if (arg === "--status" && args[i + 1]) {
+            filters.status = args[++i];
+        }
+        else if (arg === "--user" && args[i + 1]) {
+            filters.assignee = args[++i];
+        }
+        else if (arg === "--priority" && args[i + 1]) {
+            filters.priority = parseInt(args[++i], 10);
+        }
+    }
+    // Check if this is a search (has filters) or single issue lookup
+    const hasFilters = Object.keys(filters).length > 0;
+    // Find issue ID (argument that doesn't start with -)
+    const issueId = args.find((arg) => !arg.startsWith("-") && arg.match(/^[A-Z]+-\d+$/i));
+    // If no issue ID and no filters, show all local issues
+    if (!issueId && !hasFilters) {
+        const data = await loadCycleData();
+        if (!data) {
+            console.error("No cycle data found. Run ttt sync first.");
+            process.exit(1);
+        }
+        if (exportMarkdown) {
+            console.log(tasksToMarkdownList(data.tasks));
+        }
+        else {
+            displayTaskList(data.tasks);
+        }
+        return;
+    }
+    // Search mode: has filters but no specific issue ID
+    if (hasFilters && !issueId) {
+        let tasks;
+        if (useRemote) {
+            console.error("Searching issues from Linear...");
+            tasks = await searchIssuesFromLinear(filters);
+        }
+        else {
+            const data = await loadCycleData();
+            if (!data) {
+                console.error("No cycle data found. Run ttt sync first.");
+                process.exit(1);
+            }
+            tasks = await searchIssuesFromLocal(data, filters);
+        }
+        if (exportMarkdown) {
+            console.log(tasksToMarkdownList(tasks));
+        }
+        else {
+            displayTaskList(tasks);
+        }
+        return;
+    }
+    // Single issue mode
+    if (!issueId) {
+        console.error("Issue ID is required for single issue lookup.");
+        console.error("Usage: ttt show <issue-id> or ttt show --label <label>");
+        process.exit(1);
+    }
+    // Fetch from remote Linear
+    if (useRemote) {
+        console.error(`Fetching ${issueId} from Linear...`);
+        const task = await fetchIssueDetail(issueId);
+        if (!task) {
+            console.error(`Issue ${issueId} not found in Linear.`);
+            process.exit(1);
+        }
+        // Check local data for local status
+        const data = await loadCycleData();
+        if (data) {
+            const localTask = data.tasks.find((t) => t.id === issueId);
+            if (localTask) {
+                task.localStatus = localTask.localStatus;
+            }
+        }
+        if (exportMarkdown) {
+            console.log(taskToMarkdown(task));
+        }
+        else {
+            displayTaskFull(task, "📋");
+        }
+        return;
+    }
+    // Default: get from local cycle data
+    const data = await loadCycleData();
+    if (!data) {
+        console.error("No cycle data found. Run ttt sync first.");
+        process.exit(1);
+    }
+    const task = data.tasks.find((t) => t.id === issueId || t.id === issueId.toUpperCase());
+    if (!task) {
+        console.error(`Issue ${issueId} not found in local data.`);
+        console.error("Use --remote to fetch from Linear.");
+        process.exit(1);
+    }
+    if (exportMarkdown) {
+        console.log(taskToMarkdown(task));
+    }
+    else {
+        displayTaskFull(task, "📋");
+    }
+}
+show().catch(console.error);

package/dist/scripts/sync.js

@@ -17,12 +17,13 @@ Options:
 
 What it does:
   - Fetches active cycle from Linear
-  - Downloads all issues matching configured filters
+  - Downloads all issues in the cycle (regardless of status)
+  - Filters by label if configured
   - Preserves local status for existing tasks
   - Updates config with new cycle info
 
 Examples:
-  ttt sync              # Sync all matching issues
+  ttt sync              # Sync all issues in current cycle
   ttt sync MP-624       # Sync only this specific issue
   ttt sync --update     # Push local changes to Linear, then sync
   ttt sync -d .ttt     # Sync using .ttt directory`);
@@ -150,7 +151,6 @@ Examples:
     const existingTasksMap = new Map(existingData?.tasks.map((t) => [t.id, t]));
     // Phase 4: Fetch current issues with full content
     const filterLabel = localConfig.label;
-    const syncStatuses = [statusTransitions.todo, statusTransitions.in_progress];
     let issues;
     if (singleIssueId) {
         // Sync single issue by ID
@@ -165,12 +165,11 @@ Examples:
     }
     else {
         // Sync all matching issues
-        console.log(`Fetching issues with status: ${syncStatuses.join(", ")}${filterLabel ? ` and label: ${filterLabel}` : ""}...`);
-        // Build filter - label is optional
+        console.log(`Fetching all issues in current cycle${filterLabel ? ` with label: ${filterLabel}` : ""}...`);
+        // Build filter - label is optional, no status filter
         const issueFilter = {
             team: { id: { eq: teamId } },
             cycle: { id: { eq: cycleId } },
-            state: { name: { in: syncStatuses } },
         };
         if (filterLabel) {
             issueFilter.labels = { name: { eq: filterLabel } };
@@ -181,7 +180,7 @@ Examples:
         });
     }
     if (issues.nodes.length === 0) {
-        console.log(`No issues found in current cycle with ${syncStatuses.join("/")} status${filterLabel ? ` and label: ${filterLabel}` : ""}.`);
+        console.log(`No issues found in current cycle${filterLabel ? ` with label: ${filterLabel}` : ""}.`);
     }
     const tasks = [];
     let updatedCount = 0;

package/package.json

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

package/skills/linear-task-manager/SKILL.md

@@ -43,8 +43,14 @@ ttt work-on MP-624
 # Check current task status
 ttt status
 
-# Get full issue details
-ttt get-issue MP-624
+# Show issue details from local data
+ttt show MP-624
+
+# Search issues by filters
+ttt show --status "In Progress" --user me
+
+# Export issues as markdown
+ttt show --export
 
 # Mark task as blocked if waiting on dependency
 ttt status MP-624 --set blocked
@@ -108,10 +114,20 @@ The `ttt done` command behaves differently based on configured mode:
 └── output/         # Downloaded attachments
 ```
 
+## Project Validation
+
+Before starting or completing tasks, run project validation:
+
+1. **Check for validation command/skill**: Look for `/validate`, `/check` commands or validation skills
+2. **Check package.json/Makefile**: Look for `lint`, `type-check`, `test` scripts
+
+If no validation exists, suggest running `/ttt:write-validate` to create a project-specific validation command.
+
 ## Best Practices
 
 ### DO
 - Always `ttt sync` before starting work
+- **Run project validation** before starting and before completing tasks
 - Use `ttt work-on next` for auto-prioritization
 - Include meaningful messages with `ttt done -m "..."`
 - Check `ttt status` to verify state before commits
@@ -120,17 +136,18 @@ The `ttt done` command behaves differently based on configured mode:
 - Don't manually edit `cycle.toon` - use CLI commands
 - Don't skip sync - local data may be stale
 - Don't forget to commit before `ttt done`
+- Don't mark tasks done without running validation
 
 ## Troubleshooting
 
 ### "No cycle data found"
 Run `ttt sync` to fetch issues from Linear.
 
-### "Issue not found in current cycle"
-The issue may not match filters. Check:
-- Issue is in active cycle
-- Issue status is Todo or In Progress
-- Issue matches configured label filter
+### "Issue not found in local data"
+The issue may not be synced. Try:
+- Run `ttt sync` to fetch latest issues
+- Use `ttt show MP-624 --remote` to fetch directly from Linear
+- Check if issue is in active cycle
 
 ### "LINEAR_API_KEY not set"
 ```bash
@@ -157,8 +174,9 @@ ttt work-on next           # Move to next task
 
 ### Example: Check Specific Issue
 ```bash
-ttt get-issue MP-624       # Fetch from Linear
-ttt get-issue MP-624 --local  # Show cached data
+ttt show MP-624            # Show from local data
+ttt show MP-624 --remote   # Fetch from Linear
+ttt show MP-624 --export   # Export as markdown
 ```
 
 ## Important Rules
@@ -166,5 +184,5 @@ ttt get-issue MP-624 --local  # Show cached data
 - Always verify `LINEAR_API_KEY` is set before operations
 - Run `ttt sync` at the start of each work session
 - Commit code before running `ttt done`
-- Use `--local` flag to avoid API calls when checking cached data
+- Use `ttt show` (default) to read from local data; use `--remote` only when needed
 - Check `.ttt/output/` for downloaded attachments and images

package/commands/ttt-get-issue.md

@@ -1,71 +0,0 @@
----
-name: ttt-get-issue
-description: Fetch and display issue details from Linear
-arguments:
-  - name: issue-id
-    description: Issue ID to fetch (e.g., MP-624)
-    required: true
-  - name: local
-    description: Only show from local data (add --local flag)
-    required: false
----
-
-# TTT Get-Issue Command
-
-Fetch and display full issue details from Linear.
-
-## Usage
-
-### Fetch from Linear
-```bash
-ttt get-issue {{ issue-id }}
-```
-
-### Show from Local Data Only
-If `local` is "true" or "--local":
-```bash
-ttt get-issue {{ issue-id }} --local
-```
-
-## What This Does
-
-1. Fetches full issue details from Linear API (or local cache if --local)
-2. Displays comprehensive information:
-   - Title and description
-   - Status (both Linear and local)
-   - Priority level
-   - Labels
-   - Assignee
-   - Branch name
-   - Parent issue (if subtask)
-   - Attachments with local paths
-   - Comments with timestamps
-
-## Use Cases
-
-- Review issue details before starting work
-- Check requirements and acceptance criteria
-- View attachments and mockups
-- Read comment history and discussions
-- Verify issue status without full sync
-
-## Output Format
-
-```
-📋 MP-624: Issue Title
-━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-Status: In Progress | Local: in-progress
-Priority: 🔴 Urgent
-Labels: frontend, bug
-Assignee: developer@example.com
-Branch: feature/mp-624-fix-bug
-
-Description:
-[Full description content]
-
-Attachments:
-- screenshot.png (local: .ttt/output/MP-624/...)
-
-Comments:
-[Comment history]
-```