team-toon-tack 2.1.0 → 2.3.2

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,6 +12,7 @@ const COMMANDS = [
     "work-on",
     "done",
     "status",
+    "show",
     "config",
     "help",
     "version",
@@ -24,14 +25,15 @@ 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
-  status    Show or modify task status
-  config    Configure settings (status mappings, filters)
-  help      Show this help message
-  version   Show version
+  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
+  status     Show or modify task status
+  show       Show issue details or search issues by filters
+  config     Configure settings (status mappings, filters)
+  help       Show this help message
+  version    Show version
 
 GLOBAL OPTIONS:
   -d, --dir <path>    Config directory (default: .ttt)
@@ -46,6 +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 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
@@ -117,6 +122,10 @@ async function main() {
                 process.argv = ["node", "status.js", ...commandArgs];
                 await import(`${scriptDir}status.js`);
                 break;
+            case "show":
+                process.argv = ["node", "show.js", ...commandArgs];
+                await import(`${scriptDir}show.js`);
+                break;
             case "config":
                 process.argv = ["node", "config.js", ...commandArgs];
                 await import(`${scriptDir}config.js`);

package/dist/scripts/config/teams.js

@@ -1,6 +1,6 @@
 import prompts from "prompts";
-import { getLinearClient, saveLocalConfig, } from "../utils.js";
 import { getDefaultStatusTransitions } from "../lib/config-builder.js";
+import { getLinearClient, saveLocalConfig, } from "../utils.js";
 export async function configureTeams(_config, localConfig) {
     console.log("👥 Configure Teams\n");
     const client = getLinearClient();

package/dist/scripts/get-issue.d.ts

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

package/dist/scripts/get-issue.js

@@ -0,0 +1,61 @@
+import { displayTaskFull } from "./lib/display.js";
+import { fetchIssueDetail } from "./lib/sync.js";
+import { loadCycleData } from "./utils.js";
+async function getIssue() {
+    const args = process.argv.slice(2);
+    if (args.includes("--help") || args.includes("-h")) {
+        console.log(`Usage: ttt get-issue <issue-id> [--local]
+
+Fetch and display issue details from Linear.
+
+Arguments:
+  issue-id    Issue ID (e.g., MP-624). Required.
+
+Options:
+  --local     Only show from local cycle data, don't fetch from Linear
+
+Examples:
+  ttt get-issue MP-624         # Fetch from Linear and display
+  ttt get-issue MP-624 --local # Show from local data only`);
+        process.exit(0);
+    }
+    const localOnly = args.includes("--local");
+    const issueId = args.find((arg) => !arg.startsWith("-"));
+    if (!issueId) {
+        console.error("Issue ID is required.");
+        console.error("Usage: ttt get-issue <issue-id>");
+        process.exit(1);
+    }
+    // If local only, get from cycle data
+    if (localOnly) {
+        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 === `MP-${issueId}`);
+        if (!task) {
+            console.error(`Issue ${issueId} not found in local data.`);
+            process.exit(1);
+        }
+        displayTaskFull(task, "📋");
+        return;
+    }
+    // Fetch from Linear
+    console.log(`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;
+        }
+    }
+    displayTaskFull(task, "📋");
+}
+getIssue().catch(console.error);

package/dist/scripts/init.js

@@ -400,147 +400,26 @@ async function updateGitignore(tttDir, interactive) {
         // Silently ignore gitignore errors
     }
 }
-async function installClaudeCommands(interactive, statusSource) {
-    if (!interactive) {
-        return { installed: false, prefix: "" };
-    }
-    console.log("\n🤖 Claude Code Commands:");
-    // Ask if user wants to install commands
-    const { install } = await prompts({
-        type: "confirm",
-        name: "install",
-        message: "Install Claude Code commands? (work-on, done-job, sync-linear)",
-        initial: true,
-    });
-    if (!install) {
-        return { installed: false, prefix: "" };
-    }
-    // Ask for prefix
-    const { prefixChoice } = await prompts({
-        type: "select",
-        name: "prefixChoice",
-        message: "Command prefix style:",
-        choices: [
-            {
-                title: "No prefix (recommended)",
-                value: "",
-                description: "/work-on, /done-job, /sync-linear",
-            },
-            {
-                title: "ttt:",
-                value: "ttt:",
-                description: "/ttt:work-on, /ttt:done-job, /ttt:sync-linear",
-            },
-            {
-                title: "linear:",
-                value: "linear:",
-                description: "/linear:work-on, /linear:done-job, /linear:sync-linear",
-            },
-            {
-                title: "Custom...",
-                value: "custom",
-                description: "Enter your own prefix",
-            },
-        ],
-        initial: 0,
-    });
-    let prefix = prefixChoice || "";
-    if (prefixChoice === "custom") {
-        const { customPrefix } = await prompts({
-            type: "text",
-            name: "customPrefix",
-            message: "Enter custom prefix (e.g., 'my:'):",
-            initial: "",
-        });
-        prefix = customPrefix || "";
-    }
-    // Find templates directory
-    // Try multiple locations: installed package, local dev
-    const possibleTemplatePaths = [
-        path.join(__dirname, "..", "templates", "claude-code-commands"),
-        path.join(__dirname, "..", "..", "templates", "claude-code-commands"),
-        path.join(process.cwd(), "templates", "claude-code-commands"),
-    ];
-    let templateDir = null;
-    for (const p of possibleTemplatePaths) {
-        try {
-            await fs.access(p);
-            templateDir = p;
-            break;
-        }
-        catch {
-            // Try next path
-        }
-    }
-    if (!templateDir) {
-        // Try to get repo URL from package.json
-        let repoUrl = "https://github.com/wayne930242/team-toon-tack";
-        try {
-            const pkgPaths = [
-                path.join(__dirname, "..", "package.json"),
-                path.join(__dirname, "..", "..", "package.json"),
-            ];
-            for (const pkgPath of pkgPaths) {
-                try {
-                    const pkgContent = await fs.readFile(pkgPath, "utf-8");
-                    const pkg = JSON.parse(pkgContent);
-                    if (pkg.repository?.url) {
-                        // Parse git+https://github.com/user/repo.git format
-                        repoUrl = pkg.repository.url
-                            .replace(/^git\+/, "")
-                            .replace(/\.git$/, "");
-                    }
-                    break;
-                }
-                catch {
-                    // Try next path
-                }
-            }
-        }
-        catch {
-            // Use default URL
-        }
-        console.log("  ⚠ Could not find command templates. Please copy manually from:");
-        console.log(`    ${repoUrl}/tree/main/templates/claude-code-commands`);
-        return { installed: false, prefix };
-    }
-    // Create .claude/commands directory
-    const commandsDir = path.join(process.cwd(), ".claude", "commands");
-    await fs.mkdir(commandsDir, { recursive: true });
-    // Copy and rename template files
-    const templateFiles = await fs.readdir(templateDir);
-    const commandFiles = templateFiles.filter((f) => f.endsWith(".md"));
-    for (const file of commandFiles) {
-        const baseName = file.replace(".md", "");
-        const newFileName = prefix ? `${prefix}${baseName}.md` : file;
-        const srcPath = path.join(templateDir, file);
-        const destPath = path.join(commandsDir, newFileName);
-        // Read template content
-        let content = await fs.readFile(srcPath, "utf-8");
-        // Update the name in frontmatter if prefix is used
-        if (prefix) {
-            content = content.replace(/^(---\s*\n[\s\S]*?name:\s*)(\S+)/m, `$1${prefix}${baseName}`);
-        }
-        // Modify content based on statusSource for work-on and done-job
-        if (statusSource === "local") {
-            if (baseName === "work-on" || baseName.endsWith("work-on")) {
-                // Update description for local mode
-                content = content.replace(/Select a task and update status to "In Progress" on both local and Linear\./, 'Select a task and update local status to "In Progress". (Linear will be updated when you run `sync --update`)');
-                // Add reminder after Complete section
-                content = content.replace(/Use `?\/done-job`? to mark task as completed/, "Use `/done-job` to mark task as completed\n\n### 7. Sync to Linear\n\nWhen ready to update Linear with all your changes:\n\n```bash\nttt sync --update\n```");
-            }
-            if (baseName === "done-job" || baseName.endsWith("done-job")) {
-                // Update description for local mode
-                content = content.replace(/Mark a task as done and update Linear with commit details\./, "Mark a task as done locally. (Run `ttt sync --update` to push changes to Linear)");
-                // Add reminder at the end
-                content = content.replace(/## What It Does\n\n- Linear issue status → "Done"/, "## What It Does\n\n- Local status → `completed`");
-                content += `\n## Sync to Linear\n\nAfter completing tasks, push all changes to Linear:\n\n\`\`\`bash\nttt sync --update\n\`\`\`\n`;
-            }
-        }
-        await fs.writeFile(destPath, content, "utf-8");
-        console.log(`  ✓ .claude/commands/${newFileName}`);
-    }
-    return { installed: true, prefix };
+function showPluginInstallInstructions() {
+    console.log("\n🤖 Claude Code Plugin:");
+    console.log("┌─────────────────────────────────────────────────────────────┐");
+    console.log("│  Install team-toon-tack plugin in Claude Code:             │");
+    console.log("├─────────────────────────────────────────────────────────────┤");
+    console.log("│                                                             │");
+    console.log("│  1. Add marketplace:                                        │");
+    console.log("│     /plugin marketplace add wayne930242/team-toon-tack      │");
+    console.log("│                                                             │");
+    console.log("│  2. Install plugin:                                         │");
+    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:show        - Show/search issues                   │");
+    console.log("│                                                             │");
+    console.log("└─────────────────────────────────────────────────────────────┘");
 }
 async function init() {
     const args = process.argv.slice(2);
@@ -732,8 +611,8 @@ async function init() {
     console.log(`  ✓ ${paths.localPath}`);
     // Update .gitignore (always use relative path .ttt)
     await updateGitignore(".ttt", options.interactive ?? true);
-    // Install Claude Code commands
-    const { installed: commandsInstalled, prefix: commandPrefix } = await installClaudeCommands(options.interactive ?? true, statusSource);
+    // Show Claude Code plugin installation instructions
+    showPluginInstallInstructions();
     // Summary
     console.log("\n✅ Initialization complete!\n");
     console.log("Configuration summary:");
@@ -762,21 +641,10 @@ async function init() {
     if (statusTransitions.blocked) {
         console.log(`    Blocked: ${statusTransitions.blocked}`);
     }
-    if (commandsInstalled) {
-        const cmdPrefix = commandPrefix ? `${commandPrefix}` : "";
-        console.log(`  Claude commands: /${cmdPrefix}work-on, /${cmdPrefix}done-job, /${cmdPrefix}sync-linear`);
-    }
     console.log("\nNext steps:");
     console.log("  1. Set LINEAR_API_KEY in your shell profile:");
     console.log(`     export LINEAR_API_KEY="${apiKey}"`);
     console.log("  2. Run sync: ttt sync");
-    if (commandsInstalled) {
-        const cmdPrefix = commandPrefix ? `${commandPrefix}` : "";
-        console.log(`  3. In Claude Code: /${cmdPrefix}work-on next`);
-        console.log(`\n💡 Tip: Edit .claude/commands/${cmdPrefix}work-on.md to customize the "Verify" section for your project.`);
-    }
-    else {
-        console.log("  3. Start working: ttt work-on");
-    }
+    console.log("  3. Start working: ttt work-on");
 }
 init().catch(console.error);

package/dist/scripts/lib/config-builder.d.ts

@@ -1,4 +1,4 @@
-import type { CompletionMode, Config, LocalConfig, QaPmTeamConfig, StatusTransitions, TeamConfig, UserConfig, LabelConfig } from "../utils.js";
+import type { CompletionMode, Config, LabelConfig, LocalConfig, QaPmTeamConfig, StatusTransitions, TeamConfig, UserConfig } from "../utils.js";
 export interface LinearTeam {
     id: string;
     name: string;

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

@@ -1,11 +1,19 @@
 import type { LinearClient } from "@linear/sdk";
 import { type Config, type LocalConfig, type Task } from "../utils.js";
+export interface FetchIssueOptions {
+    client?: LinearClient;
+}
 export interface SyncIssueOptions {
     config: Config;
     localConfig: LocalConfig;
     client?: LinearClient;
     preserveLocalStatus?: boolean;
 }
+/**
+ * Fetch issue details from Linear without saving to local data
+ * Returns Task object or null if issue not found
+ */
+export declare function fetchIssueDetail(issueId: string, options?: FetchIssueOptions): Promise<Task | null>;
 /**
  * Sync a single issue from Linear and update local cycle data
  * Returns the updated task or null if issue not found

package/dist/scripts/lib/sync.js

@@ -1,17 +1,15 @@
-import { getLinearClient, loadCycleData, saveCycleData, getPrioritySortIndex, } from "../utils.js";
+import { getLinearClient, getPrioritySortIndex, loadCycleData, saveCycleData, } from "../utils.js";
 import { getStatusTransitions } from "./linear.js";
 /**
- * Sync a single issue from Linear and update local cycle data
- * Returns the updated task or null if issue not found
+ * Fetch issue details from Linear without saving to local data
+ * Returns Task object or null if issue not found
  */
-export async function syncSingleIssue(issueId, options) {
-    const { config, localConfig: _localConfig, preserveLocalStatus = true, } = options;
+export async function fetchIssueDetail(issueId, options = {}) {
     const client = options.client ?? getLinearClient();
     // Search for the issue
     const searchResult = await client.searchIssues(issueId);
     const matchingIssue = searchResult.nodes.find((i) => i.identifier === issueId);
     if (!matchingIssue) {
-        console.error(`Issue ${issueId} not found in Linear.`);
         return null;
     }
     // Fetch full issue data
@@ -41,34 +39,12 @@ export async function syncSingleIssue(issueId, options) {
             user: user?.displayName ?? user?.email,
         };
     }));
-    // Determine local status
-    let localStatus = "pending";
-    const existingData = await loadCycleData();
-    if (preserveLocalStatus && existingData) {
-        const existingTask = existingData.tasks.find((t) => t.id === issueId);
-        if (existingTask) {
-            localStatus = existingTask.localStatus;
-        }
-    }
-    // Map remote status to local status if not preserving
-    if (!preserveLocalStatus && state) {
-        const transitions = getStatusTransitions(config);
-        if (state.name === transitions.done) {
-            localStatus = "completed";
-        }
-        else if (state.name === transitions.in_progress) {
-            localStatus = "in-progress";
-        }
-        else {
-            localStatus = "pending";
-        }
-    }
     const task = {
         id: issue.identifier,
         linearId: issue.id,
         title: issue.title,
         status: state ? state.name : "Unknown",
-        localStatus: localStatus,
+        localStatus: "pending", // Default, will be overridden by sync if needed
         assignee: assigneeEmail,
         priority: issue.priority,
         labels: labelNames,
@@ -79,6 +55,42 @@ export async function syncSingleIssue(issueId, options) {
         attachments: attachments.length > 0 ? attachments : undefined,
         comments: comments.length > 0 ? comments : undefined,
     };
+    return task;
+}
+/**
+ * Sync a single issue from Linear and update local cycle data
+ * Returns the updated task or null if issue not found
+ */
+export async function syncSingleIssue(issueId, options) {
+    const { config, localConfig: _localConfig, preserveLocalStatus = true, } = options;
+    const client = options.client ?? getLinearClient();
+    // Fetch issue details using shared function
+    const task = await fetchIssueDetail(issueId, { client });
+    if (!task) {
+        console.error(`Issue ${issueId} not found in Linear.`);
+        return null;
+    }
+    // Determine local status
+    const existingData = await loadCycleData();
+    if (preserveLocalStatus && existingData) {
+        const existingTask = existingData.tasks.find((t) => t.id === issueId);
+        if (existingTask) {
+            task.localStatus = existingTask.localStatus;
+        }
+    }
+    // Map remote status to local status if not preserving
+    if (!preserveLocalStatus) {
+        const transitions = getStatusTransitions(config);
+        if (task.status === transitions.done) {
+            task.localStatus = "completed";
+        }
+        else if (task.status === transitions.in_progress) {
+            task.localStatus = "in-progress";
+        }
+        else {
+            task.localStatus = "pending";
+        }
+    }
     // Update cycle data
     if (existingData) {
         const existingTasks = existingData.tasks.filter((t) => t.id !== issueId);

package/dist/scripts/show.d.ts

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