Merge pull request #722 from eyaltoledano/changeset-release/main

Version Packages

.changeset/bright-windows-sing.md

@@ -1,44 +0,0 @@
----
-'task-master-ai': minor
----
-
-Add comprehensive AI-powered research command with intelligent context gathering and interactive follow-ups.
-
-The new `research` command provides AI-powered research capabilities that automatically gather relevant project context to answer your questions. The command intelligently selects context from multiple sources and supports interactive follow-up questions in CLI mode.
-
-**Key Features:**
-- **Intelligent Task Discovery**: Automatically finds relevant tasks and subtasks using fuzzy search based on your query keywords, supplementing any explicitly provided task IDs
-- **Multi-Source Context**: Gathers context from tasks, files, project structure, and custom text to provide comprehensive answers
-- **Interactive Follow-ups**: CLI users can ask follow-up questions that build on the conversation history while allowing fresh context discovery for each question
-- **Flexible Detail Levels**: Choose from low (concise), medium (balanced), or high (comprehensive) response detail levels
-- **Token Transparency**: Displays detailed token breakdown showing context size, sources, and estimated costs
-- **Enhanced Display**: Syntax-highlighted code blocks and structured output with clear visual separation
-
-**Usage Examples:**
-```bash
-# Basic research with auto-discovered context
-task-master research "How should I implement user authentication?"
-
-# Research with specific task context
-task-master research "What's the best approach for this?" --id=15,23.2
-
-# Research with file context and project tree
-task-master research "How does the current auth system work?" --files=src/auth.js,config/auth.json --tree
-
-# Research with custom context and low detail
-task-master research "Quick implementation steps?" --context="Using JWT tokens" --detail=low
-```
-
-**Context Sources:**
-- **Tasks**: Automatically discovers relevant tasks/subtasks via fuzzy search, plus any explicitly specified via `--id`
-- **Files**: Include specific files via `--files` for code-aware responses
-- **Project Tree**: Add `--tree` to include project structure overview
-- **Custom Context**: Provide additional context via `--context` for domain-specific information
-
-**Interactive Features (CLI only):**
-- Follow-up questions that maintain conversation history
-- Fresh fuzzy search for each follow-up to discover newly relevant tasks
-- Cumulative context building across the conversation
-- Clean visual separation between exchanges
-
-The research command integrates with the existing AI service layer and supports all configured AI providers. MCP integration provides the same functionality for programmatic access without interactive features.

.changeset/cold-pears-poke.md

@@ -1,13 +0,0 @@
----
-'task-master-ai': patch
----
-
-Fix critical bugs in task move functionality:
-
-- **Fixed moving tasks to become subtasks of empty parents**: When moving a task to become a subtask of a parent that had no existing subtasks (e.g., task 89 → task 98.1), the operation would fail with validation errors.
-
-- **Fixed moving subtasks between parents**: Subtasks can now be properly moved between different parent tasks, including to parents that previously had no subtasks.
-
-- **Improved comma-separated batch moves**: Multiple tasks can now be moved simultaneously using comma-separated IDs (e.g., "88,90" → "92,93") with proper error handling and atomic operations.
-
-These fixes enables proper task hierarchy reorganization for corner cases that were previously broken.

.changeset/hungry-geese-work.md

@@ -1,5 +0,0 @@
----
-'task-master-ai': minor
----
-
-Add AWS bedrock support

.changeset/itchy-taxes-sip.md

@@ -1,13 +0,0 @@
----
-'task-master-ai': minor
----
-
-# Add Google Vertex AI Provider Integration
-
-- Implemented `VertexAIProvider` class extending BaseAIProvider
-- Added authentication and configuration handling for Vertex AI
-- Updated configuration manager with Vertex-specific getters
-- Modified AI services unified system to integrate the provider
-- Added documentation for Vertex AI setup and configuration
-- Updated environment variable examples for Vertex AI support
-- Implemented specialized error handling for Vertex-specific issues

.changeset/lemon-apes-sort.md

@@ -1,5 +0,0 @@
----
-'task-master-ai': minor
----
-
-Add support for Azure

.changeset/moody-results-clean.md

@@ -1,17 +0,0 @@
----
-'task-master-ai': minor
----
-
-Add comprehensive `research` MCP tool for AI-powered research queries
-
-- **New MCP Tool**: `research` tool enables AI-powered research with project context
-- **Context Integration**: Supports task IDs, file paths, custom context, and project tree
-- **Fuzzy Task Discovery**: Automatically finds relevant tasks using semantic search
-- **Token Management**: Detailed token counting and breakdown by context type
-- **Multiple Detail Levels**: Support for low, medium, and high detail research responses
-- **Telemetry Integration**: Full cost tracking and usage analytics
-- **Direct Function**: `researchDirect` with comprehensive parameter validation
-- **Silent Mode**: Prevents console output interference with MCP JSON responses
-- **Error Handling**: Robust error handling with proper MCP response formatting
-
-This completes subtasks 94.5 (Direct Function) and 94.6 (MCP Tool) for the research command implementation, providing a powerful research interface for integrated development environments like Cursor.

.changeset/new-colts-flow.md

@@ -1,5 +0,0 @@
----
-"task-master-ai": minor
----
-
-Increased minimum required node version to > 18 (was > 14)

.changeset/plain-bottles-stand.md

@@ -1,5 +0,0 @@
----
-'task-master-ai': minor
----
-
-Renamed baseUrl to baseURL

.changeset/shaggy-rice-exist.md

@@ -1,5 +0,0 @@
----
-'task-master-ai': patch
----
-
-Fix max_tokens error when trying to use claude-sonnet-4 and claude-opus-4

.changeset/sharp-flies-call.md

@@ -1,7 +0,0 @@
----
-'task-master-ai': minor
----
-
-Add TASK_MASTER_PROJECT_ROOT env variable supported in mcp.json and .env for project root resolution
-
-- Some users were having issues where the MCP wasn't able to detect the location of their project root, you can now set the `TASK_MASTER_PROJECT_ROOT` environment variable to the root of your project.

.changeset/stale-bats-sin.md

@@ -1,19 +0,0 @@
----
-'task-master-ai': minor
----
-
-Enhanced get-task/show command to support comma-separated task IDs for efficient batch operations
-
-**New Features:**
-- **Multiple Task Retrieval**: Pass comma-separated IDs to get/show multiple tasks at once (e.g., `task-master show 1,3,5` or MCP `get_task` with `id: "1,3,5"`)
-- **Smart Display Logic**: Single ID shows detailed view, multiple IDs show compact summary table with interactive options
-- **Batch Action Menu**: Interactive menu for multiple tasks with copy-paste ready commands for common operations (mark as done/in-progress, expand all, view dependencies, etc.)
-- **MCP Array Response**: MCP tool returns structured array of task objects for efficient AI agent context gathering
-
-**Benefits:**
-- **Faster Context Gathering**: AI agents can collect multiple tasks/subtasks in one call instead of iterating
-- **Improved Workflow**: Interactive batch operations reduce repetitive command execution
-- **Better UX**: Responsive layout adapts to terminal width, maintains consistency with existing UI patterns
-- **API Efficiency**: RESTful array responses in MCP format enable more sophisticated integrations
-
-This enhancement maintains full backward compatibility while significantly improving efficiency for both human users and AI agents working with multiple tasks.

.changeset/tidy-seals-rule.md

@@ -1,5 +0,0 @@
----
-'task-master-ai': patch
----
-
-Fix add-task MCP command causing an error

.cursor/mcp.json

@@ -1,44 +1,19 @@
 {
-  "mcpServers": {
-    "task-master-ai-tm": {
-      "command": "node",
-      "args": [
-        "./mcp-server/server.js"
-      ],
-      "env": {
-        "ANTHROPIC_API_KEY": "ANTHROPIC_API_KEY_HERE",
-        "PERPLEXITY_API_KEY": "PERPLEXITY_API_KEY_HERE",
-        "OPENAI_API_KEY": "OPENAI_API_KEY_HERE",
-        "GOOGLE_API_KEY": "GOOGLE_API_KEY_HERE",
-        "XAI_API_KEY": "XAI_API_KEY_HERE",
-        "OPENROUTER_API_KEY": "OPENROUTER_API_KEY_HERE",
-        "MISTRAL_API_KEY": "MISTRAL_API_KEY_HERE",
-        "AZURE_OPENAI_API_KEY": "AZURE_OPENAI_API_KEY_HERE",
-        "OLLAMA_API_KEY": "OLLAMA_API_KEY_HERE"
-      }
-    },
-    "task-master-ai": {
-      "command": "npx",
-      "args": [
-        "-y",
-        "--package=task-master-ai",
-        "task-master-ai"
-      ],
-      "env": {
-        "ANTHROPIC_API_KEY": "ANTHROPIC_API_KEY_HERE",
-        "PERPLEXITY_API_KEY": "PERPLEXITY_API_KEY_HERE",
-        "OPENAI_API_KEY": "OPENAI_API_KEY_HERE",
-        "GOOGLE_API_KEY": "GOOGLE_API_KEY_HERE",
-        "XAI_API_KEY": "XAI_API_KEY_HERE",
-        "OPENROUTER_API_KEY": "OPENROUTER_API_KEY_HERE",
-        "MISTRAL_API_KEY": "MISTRAL_API_KEY_HERE",
-        "AZURE_OPENAI_API_KEY": "AZURE_OPENAI_API_KEY_HERE",
-        "OLLAMA_API_KEY": "OLLAMA_API_KEY_HERE"
-      }
-    }
-  },
-  "env": {
-    "TASKMASTER_TELEMETRY_API_KEY": "339a81c9-5b9c-4d60-92d8-cba2ee2a8cc3",
-    "TASKMASTER_TELEMETRY_USER_EMAIL": "user_1748640077834@taskmaster.dev"
-  }
-}
+	"mcpServers": {
+		"task-master-ai": {
+			"command": "node",
+			"args": ["./mcp-server/server.js"],
+			"env": {
+				"ANTHROPIC_API_KEY": "ANTHROPIC_API_KEY_HERE",
+				"PERPLEXITY_API_KEY": "PERPLEXITY_API_KEY_HERE",
+				"OPENAI_API_KEY": "OPENAI_API_KEY_HERE",
+				"GOOGLE_API_KEY": "GOOGLE_API_KEY_HERE",
+				"XAI_API_KEY": "XAI_API_KEY_HERE",
+				"OPENROUTER_API_KEY": "OPENROUTER_API_KEY_HERE",
+				"MISTRAL_API_KEY": "MISTRAL_API_KEY_HERE",
+				"AZURE_OPENAI_API_KEY": "AZURE_OPENAI_API_KEY_HERE",
+				"OLLAMA_API_KEY": "OLLAMA_API_KEY_HERE"
+			}
+		}
+	}
+}

.cursor/rules/ai_providers.mdc

@@ -50,7 +50,6 @@ This rule guides AI assistants on how to view, configure, and interact with the
     -   **Key Locations** (See [`dev_workflow.mdc`](mdc:.cursor/rules/dev_workflow.mdc) - Configuration Management):
         -   **MCP/Cursor:** Set keys in the `env` section of `.cursor/mcp.json`.
         -   **CLI:** Set keys in a `.env` file in the project root.
-        - As the AI agent, you do not have access to read the .env -- but do not attempt to recreate it!
     -   **Provider List & Keys:**
         -   **`anthropic`**: Requires `ANTHROPIC_API_KEY`.
         -   **`google`**: Requires `GOOGLE_API_KEY`.

.cursor/rules/ai_services.mdc

@@ -1,7 +1,6 @@
 ---
 description: Guidelines for interacting with the unified AI service layer.
 globs: scripts/modules/ai-services-unified.js, scripts/modules/task-manager/*.js, scripts/modules/commands.js
-alwaysApply: false
 ---
 
 # AI Services Layer Guidelines
@@ -92,7 +91,7 @@ This document outlines the architecture and usage patterns for interacting with
 *   ✅ **DO**: Centralize **all** LLM calls through `generateTextService` or `generateObjectService`.
 *   ✅ **DO**: Determine the appropriate `role` (`main`, `research`, `fallback`) in your core logic and pass it to the service.
 *   ✅ **DO**: Pass the `session` object (received in the `context` parameter, especially from direct function wrappers) to the service call when in MCP context.
-*   ✅ **DO**: Ensure API keys are correctly configured in `.env` (for CLI) or `.cursor/mcp.json` (for MCP). FYI: As the AI agent, you do not have access to read the .env -- so do not attempt to recreate it!
+*   ✅ **DO**: Ensure API keys are correctly configured in `.env` (for CLI) or `.cursor/mcp.json` (for MCP).
 *   ✅ **DO**: Ensure `.taskmasterconfig` exists and has valid provider/model IDs for the roles you intend to use (manage via `task-master models --setup`).
 *   ✅ **DO**: Use `generateTextService` and implement robust manual JSON parsing (with Zod validation *after* parsing) when structured output is needed, as `generateObjectService` has shown unreliability with some providers/schemas.
 *   ❌ **DON'T**: Import or call anything from the old `ai-services.js`, `ai-client-factory.js`, or `ai-client-utils.js` files.

.cursor/rules/architecture.mdc

@@ -39,12 +39,12 @@ alwaysApply: false
     - **Responsibilities** (See also: [`ai_services.mdc`](mdc:.cursor/rules/ai_services.mdc)):
       - Exports `generateTextService`, `generateObjectService`.
       - Handles provider/model selection based on `role` and `.taskmasterconfig`.
-      - Resolves API keys (from `.env` or `session.env`). As the AI agent, you do not have access to read the .env -- but do not attempt to recreate it!
+      - Resolves API keys (from `.env` or `session.env`).
       - Implements fallback and retry logic.
       - Orchestrates calls to provider-specific implementations (`src/ai-providers/`).
     - Telemetry data generated by the AI service layer is propagated upwards through core logic, direct functions, and MCP tools. See [`telemetry.mdc`](mdc:.cursor/rules/telemetry.mdc) for the detailed integration pattern.
 
-  - **[`src/ai-providers/*.js`](mdc:src/ai-providers): Provider-Specific Implementations**
+  - **[`src/ai-providers/*.js`](mdc:src/ai-providers/): Provider-Specific Implementations**
     - **Purpose**: Provider-specific wrappers for Vercel AI SDK functions.
     - **Responsibilities**: Interact directly with Vercel AI SDK adapters.
 
@@ -63,7 +63,7 @@ alwaysApply: false
       - API Key Resolution (`resolveEnvVariable`).
       - Silent Mode Control (`enableSilentMode`, `disableSilentMode`).
 
-  - **[`mcp-server/`](mdc:mcp-server): MCP Server Integration**
+  - **[`mcp-server/`](mdc:mcp-server/): MCP Server Integration**
     - **Purpose**: Provides MCP interface using FastMCP.
     - **Responsibilities** (See also: [`mcp.mdc`](mdc:.cursor/rules/mcp.mdc)):
       - Registers tools (`mcp-server/src/tools/*.js`). Tool `execute` methods **should be wrapped** with the `withNormalizedProjectRoot` HOF (from `tools/utils.js`) to ensure consistent path handling.

.cursor/rules/commands.mdc

@@ -329,60 +329,6 @@ When implementing commands that delete or remove data (like `remove-task` or `re
   };
   ```
 
-## Context-Aware Command Pattern
-
-For AI-powered commands that benefit from project context, follow the research command pattern:
-
-- **Context Integration**:
-  - ✅ DO: Use `ContextGatherer` utility for multi-source context extraction
-  - ✅ DO: Support task IDs, file paths, custom context, and project tree
-  - ✅ DO: Implement fuzzy search for automatic task discovery
-  - ✅ DO: Display detailed token breakdown for transparency
-
-  ```javascript
-  // ✅ DO: Follow this pattern for context-aware commands
-  programInstance
-    .command('research')
-    .description('Perform AI-powered research queries with project context')
-    .argument('<prompt>', 'Research prompt to investigate')
-    .option('-i, --id <ids>', 'Comma-separated task/subtask IDs to include as context')
-    .option('-f, --files <paths>', 'Comma-separated file paths to include as context')
-    .option('-c, --context <text>', 'Additional custom context')
-    .option('--tree', 'Include project file tree structure')
-    .option('-d, --detail <level>', 'Output detail level: low, medium, high', 'medium')
-    .action(async (prompt, options) => {
-      // 1. Parameter validation and parsing
-      const taskIds = options.id ? parseTaskIds(options.id) : [];
-      const filePaths = options.files ? parseFilePaths(options.files) : [];
-      
-      // 2. Initialize context gatherer
-      const projectRoot = findProjectRoot() || '.';
-      const gatherer = new ContextGatherer(projectRoot, tasksPath);
-      
-      // 3. Auto-discover relevant tasks if none specified
-      if (taskIds.length === 0) {
-        const fuzzySearch = new FuzzyTaskSearch(tasksData.tasks, 'research');
-        const discoveredIds = fuzzySearch.getTaskIds(
-          fuzzySearch.findRelevantTasks(prompt)
-        );
-        taskIds.push(...discoveredIds);
-      }
-      
-      // 4. Gather context with token breakdown
-      const contextResult = await gatherer.gather({
-        tasks: taskIds,
-        files: filePaths,
-        customContext: options.context,
-        includeProjectTree: options.projectTree,
-        format: 'research',
-        includeTokenCounts: true
-      });
-      
-      // 5. Display token breakdown and execute AI call
-      // Implementation continues...
-    });
-  ```
-
 ## Error Handling
 
 - **Exception Management**:

.cursor/rules/context_gathering.mdc

@@ -1,268 +0,0 @@
----
-description: Standardized patterns for gathering and processing context from multiple sources in Task Master commands, particularly for AI-powered features.
-globs: 
-alwaysApply: false
----
-# Context Gathering Patterns and Utilities
-
-This document outlines the standardized patterns for gathering and processing context from multiple sources in Task Master commands, particularly for AI-powered features.
-
-## Core Context Gathering Utility
-
-The `ContextGatherer` class (`scripts/modules/utils/contextGatherer.js`) provides a centralized, reusable utility for extracting context from multiple sources:
-
-### **Key Features**
-- **Multi-source Context**: Tasks, files, custom text, project file tree
-- **Token Counting**: Detailed breakdown using `gpt-tokens` library
-- **Format Support**: Different output formats (research, chat, system-prompt)
-- **Error Handling**: Graceful handling of missing files, invalid task IDs
-- **Performance**: File size limits, depth limits for tree generation
-
-### **Usage Pattern**
-```javascript
-import { ContextGatherer } from '../utils/contextGatherer.js';
-
-// Initialize with project paths
-const gatherer = new ContextGatherer(projectRoot, tasksPath);
-
-// Gather context with detailed token breakdown
-const result = await gatherer.gather({
-    tasks: ['15', '16.2'],           // Task and subtask IDs
-    files: ['src/api.js', 'README.md'], // File paths
-    customContext: 'Additional context text',
-    includeProjectTree: true,        // Include file tree
-    format: 'research',              // Output format
-    includeTokenCounts: true         // Get detailed token breakdown
-});
-
-// Access results
-const contextString = result.context;
-const tokenBreakdown = result.tokenBreakdown;
-```
-
-### **Token Breakdown Structure**
-```javascript
-{
-    customContext: { tokens: 150, characters: 800 },
-    tasks: [
-        { id: '15', type: 'task', title: 'Task Title', tokens: 245, characters: 1200 },
-        { id: '16.2', type: 'subtask', title: 'Subtask Title', tokens: 180, characters: 900 }
-    ],
-    files: [
-        { path: 'src/api.js', tokens: 890, characters: 4500, size: '4.5 KB' }
-    ],
-    projectTree: { tokens: 320, characters: 1600 },
-    total: { tokens: 1785, characters: 8000 }
-}
-```
-
-## Fuzzy Search Integration
-
-The `FuzzyTaskSearch` class (`scripts/modules/utils/fuzzyTaskSearch.js`) provides intelligent task discovery:
-
-### **Key Features**
-- **Semantic Matching**: Uses Fuse.js for similarity scoring
-- **Purpose Categories**: Pattern-based task categorization
-- **Relevance Scoring**: High/medium/low relevance thresholds
-- **Context-Aware**: Different search configurations for different use cases
-
-### **Usage Pattern**
-```javascript
-import { FuzzyTaskSearch } from '../utils/fuzzyTaskSearch.js';
-
-// Initialize with tasks data and context
-const fuzzySearch = new FuzzyTaskSearch(tasksData.tasks, 'research');
-
-// Find relevant tasks
-const searchResults = fuzzySearch.findRelevantTasks(query, {
-    maxResults: 8,
-    includeRecent: true,
-    includeCategoryMatches: true
-});
-
-// Get task IDs for context gathering
-const taskIds = fuzzySearch.getTaskIds(searchResults);
-```
-
-## Implementation Patterns for Commands
-
-### **1. Context-Aware Command Structure**
-```javascript
-// In command action handler
-async function commandAction(prompt, options) {
-    // 1. Parameter validation and parsing
-    const taskIds = options.id ? parseTaskIds(options.id) : [];
-    const filePaths = options.files ? parseFilePaths(options.files) : [];
-    
-    // 2. Initialize context gatherer
-    const projectRoot = findProjectRoot() || '.';
-    const tasksPath = path.join(projectRoot, 'tasks', 'tasks.json');
-    const gatherer = new ContextGatherer(projectRoot, tasksPath);
-    
-    // 3. Auto-discover relevant tasks if none specified
-    if (taskIds.length === 0) {
-        const fuzzySearch = new FuzzyTaskSearch(tasksData.tasks, 'research');
-        const discoveredIds = fuzzySearch.getTaskIds(
-            fuzzySearch.findRelevantTasks(prompt)
-        );
-        taskIds.push(...discoveredIds);
-    }
-    
-    // 4. Gather context with token breakdown
-    const contextResult = await gatherer.gather({
-        tasks: taskIds,
-        files: filePaths,
-        customContext: options.context,
-        includeProjectTree: options.projectTree,
-        format: 'research',
-        includeTokenCounts: true
-    });
-    
-    // 5. Display token breakdown (for CLI)
-    if (outputFormat === 'text') {
-        displayDetailedTokenBreakdown(contextResult.tokenBreakdown);
-    }
-    
-    // 6. Use context in AI call
-    const aiResult = await generateTextService(role, session, systemPrompt, userPrompt);
-    
-    // 7. Display results with enhanced formatting
-    displayResults(aiResult, contextResult.tokenBreakdown);
-}
-```
-
-### **2. Token Display Pattern**
-```javascript
-function displayDetailedTokenBreakdown(tokenBreakdown, systemTokens, userTokens) {
-    const sections = [];
-    
-    // Build context breakdown
-    if (tokenBreakdown.tasks?.length > 0) {
-        const taskDetails = tokenBreakdown.tasks.map(task => 
-            `${task.type === 'subtask' ? '  ' : ''}${task.id}: ${task.tokens.toLocaleString()}`
-        ).join('\n');
-        sections.push(`Tasks (${tokenBreakdown.tasks.reduce((sum, t) => sum + t.tokens, 0).toLocaleString()}):\n${taskDetails}`);
-    }
-    
-    if (tokenBreakdown.files?.length > 0) {
-        const fileDetails = tokenBreakdown.files.map(file =>
-            `  ${file.path}: ${file.tokens.toLocaleString()} (${file.size})`
-        ).join('\n');
-        sections.push(`Files (${tokenBreakdown.files.reduce((sum, f) => sum + f.tokens, 0).toLocaleString()}):\n${fileDetails}`);
-    }
-    
-    // Add prompts breakdown
-    sections.push(`Prompts: system ${systemTokens.toLocaleString()}, user ${userTokens.toLocaleString()}`);
-    
-    // Display in clean box
-    const content = sections.join('\n\n');
-    console.log(boxen(content, {
-        title: chalk.cyan('Token Usage'),
-        padding: { top: 1, bottom: 1, left: 2, right: 2 },
-        borderStyle: 'round',
-        borderColor: 'cyan'
-    }));
-}
-```
-
-### **3. Enhanced Result Display Pattern**
-```javascript
-function displayResults(result, query, detailLevel, tokenBreakdown) {
-    // Header with query info
-    const header = boxen(
-        chalk.green.bold('Research Results') + '\n\n' +
-        chalk.gray('Query: ') + chalk.white(query) + '\n' +
-        chalk.gray('Detail Level: ') + chalk.cyan(detailLevel),
-        {
-            padding: { top: 1, bottom: 1, left: 2, right: 2 },
-            margin: { top: 1, bottom: 0 },
-            borderStyle: 'round',
-            borderColor: 'green'
-        }
-    );
-    console.log(header);
-    
-    // Process and highlight code blocks
-    const processedResult = processCodeBlocks(result);
-    
-    // Main content in clean box
-    const contentBox = boxen(processedResult, {
-        padding: { top: 1, bottom: 1, left: 2, right: 2 },
-        margin: { top: 0, bottom: 1 },
-        borderStyle: 'single',
-        borderColor: 'gray'
-    });
-    console.log(contentBox);
-    
-    console.log(chalk.green('✓ Research complete'));
-}
-```
-
-## Code Block Enhancement
-
-### **Syntax Highlighting Pattern**
-```javascript
-import { highlight } from 'cli-highlight';
-
-function processCodeBlocks(text) {
-    return text.replace(/```(\w+)?\n([\s\S]*?)```/g, (match, language, code) => {
-        try {
-            const highlighted = highlight(code.trim(), { 
-                language: language || 'javascript',
-                theme: 'default'
-            });
-            return `\n${highlighted}\n`;
-        } catch (error) {
-            return `\n${code.trim()}\n`;
-        }
-    });
-}
-```
-
-## Integration Guidelines
-
-### **When to Use Context Gathering**
-- ✅ **DO**: Use for AI-powered commands that benefit from project context
-- ✅ **DO**: Use when users might want to reference specific tasks or files
-- ✅ **DO**: Use for research, analysis, or generation commands
-- ❌ **DON'T**: Use for simple CRUD operations that don't need AI context
-
-### **Performance Considerations**
-- ✅ **DO**: Set reasonable file size limits (50KB default)
-- ✅ **DO**: Limit project tree depth (3-5 levels)
-- ✅ **DO**: Provide token counts to help users understand context size
-- ✅ **DO**: Allow users to control what context is included
-
-### **Error Handling**
-- ✅ **DO**: Gracefully handle missing files with warnings
-- ✅ **DO**: Validate task IDs and provide helpful error messages
-- ✅ **DO**: Continue processing even if some context sources fail
-- ✅ **DO**: Provide fallback behavior when context gathering fails
-
-### **Future Command Integration**
-Commands that should consider adopting this pattern:
-- `analyze-complexity` - Could benefit from file context
-- `expand-task` - Could use related task context
-- `update-task` - Could reference similar tasks for consistency
-- `add-task` - Could use project context for better task generation
-
-## Export Patterns
-
-### **Context Gatherer Module**
-```javascript
-export {
-    ContextGatherer,
-    createContextGatherer  // Factory function
-};
-```
-
-### **Fuzzy Search Module**
-```javascript
-export {
-    FuzzyTaskSearch,
-    PURPOSE_CATEGORIES,
-    RELEVANCE_THRESHOLDS
-};
-```
-
-This context gathering system provides a foundation for building more intelligent, context-aware commands that can leverage project knowledge to provide better AI-powered assistance.

.cursor/rules/dev_workflow.mdc

@@ -104,7 +104,7 @@ Task Master offers two primary ways to interact:
 
 Taskmaster configuration is managed through two main mechanisms:
 
-1.  **`.taskmasterconfig` File (Primary):**
+1.  **`.taskmaster/config.json` File (Primary):**
     *   Located in the project root directory.
     *   Stores most configuration settings: AI model selections (main, research, fallback), parameters (max tokens, temperature), logging level, default subtasks/priority, project name, etc.
     *   **Managed via `task-master models --setup` command.** Do not edit manually unless you know what you are doing.

.cursor/rules/git_workflow.mdc

@@ -1,367 +0,0 @@
----
-description: Git workflow integrated with Task Master for feature development and collaboration
-globs: "**/*"
-alwaysApply: true
----
-
-# Git Workflow with Task Master Integration
-
-## **Branch Strategy**
-
-### **Main Branch Protection**
-- **main** branch contains production-ready code
-- All feature development happens on task-specific branches
-- Direct commits to main are prohibited
-- All changes merge via Pull Requests
-
-### **Task Branch Naming**
-```bash
-# ✅ DO: Use consistent task branch naming
-task-001  # For Task 1
-task-004  # For Task 4
-task-015  # For Task 15
-
-# ❌ DON'T: Use inconsistent naming
-feature/user-auth
-fix-database-issue
-random-branch-name
-```
-
-## **Workflow Overview**
-
-```mermaid
-flowchart TD
-    A[Start: On main branch] --> B[Pull latest changes]
-    B --> C[Create task branch<br/>git checkout -b task-XXX]
-    C --> D[Set task status: in-progress]
-    D --> E[Get task context & expand if needed]
-    E --> F[Identify next subtask]
-    
-    F --> G[Set subtask: in-progress]
-    G --> H[Research & collect context<br/>update_subtask with findings]
-    H --> I[Implement subtask]
-    I --> J[Update subtask with completion]
-    J --> K[Set subtask: done]
-    K --> L[Git commit subtask]
-    
-    L --> M{More subtasks?}
-    M -->|Yes| F
-    M -->|No| N[Run final tests]
-    
-    N --> O[Commit tests if added]
-    O --> P[Push task branch]
-    P --> Q[Create Pull Request]
-    Q --> R[Human review & merge]
-    R --> S[Switch to main & pull]
-    S --> T[Delete task branch]
-    T --> U[Ready for next task]
-    
-    style A fill:#e1f5fe
-    style C fill:#f3e5f5
-    style G fill:#fff3e0
-    style L fill:#e8f5e8
-    style Q fill:#fce4ec
-    style R fill:#f1f8e9
-    style U fill:#e1f5fe
-```
-
-## **Complete Task Development Workflow**
-
-### **Phase 1: Task Preparation**
-```bash
-# 1. Ensure you're on main branch and pull latest
-git checkout main
-git pull origin main
-
-# 2. Check current branch status
-git branch  # Verify you're on main
-
-# 3. Create task-specific branch
-git checkout -b task-004  # For Task 4
-
-# 4. Set task status in Task Master
-# Use: set_task_status tool or `task-master set-status --id=4 --status=in-progress`
-```
-
-### **Phase 2: Task Analysis & Planning**
-```bash
-# 5. Get task context and expand if needed
-# Use: get_task tool or `task-master show 4`
-# Use: expand_task tool or `task-master expand --id=4 --research --force` (if complex)
-
-# 6. Identify next subtask to work on
-# Use: next_task tool or `task-master next`
-```
-
-### **Phase 3: Subtask Implementation Loop**
-For each subtask, follow this pattern:
-
-```bash
-# 7. Mark subtask as in-progress
-# Use: set_task_status tool or `task-master set-status --id=4.1 --status=in-progress`
-
-# 8. Gather context and research (if needed)
-# Use: update_subtask tool with research flag or:
-# `task-master update-subtask --id=4.1 --prompt="Research findings..." --research`
-
-# 9. Collect code context through AI exploration
-# Document findings in subtask using update_subtask
-
-# 10. Implement the subtask
-# Write code, tests, documentation
-
-# 11. Update subtask with completion details
-# Use: update_subtask tool or:
-# `task-master update-subtask --id=4.1 --prompt="Implementation complete..."`
-
-# 12. Mark subtask as done
-# Use: set_task_status tool or `task-master set-status --id=4.1 --status=done`
-
-# 13. Commit the subtask implementation
-git add .
-git commit -m "feat(task-4): Complete subtask 4.1 - [Subtask Title]
-
-- Implementation details
-- Key changes made
-- Any important notes
-
-Subtask 4.1: [Brief description of what was accomplished]
-Relates to Task 4: [Main task title]"
-```
-
-### **Phase 4: Task Completion**
-```bash
-# 14. When all subtasks are complete, run final testing
-# Create test file if needed, ensure all tests pass
-npm test  # or jest, or manual testing
-
-# 15. If tests were added/modified, commit them
-git add .
-git commit -m "test(task-4): Add comprehensive tests for Task 4
-
-- Unit tests for core functionality
-- Integration tests for API endpoints
-- All tests passing
-
-Task 4: [Main task title] - Testing complete"
-
-# 16. Push the task branch
-git push origin task-004
-
-# 17. Create Pull Request
-# Title: "Task 4: [Task Title]"
-# Description should include:
-# - Task overview
-# - Subtasks completed
-# - Testing approach
-# - Any breaking changes or considerations
-```
-
-### **Phase 5: PR Merge & Cleanup**
-```bash
-# 18. Human reviews and merges PR into main
-
-# 19. Switch back to main and pull merged changes
-git checkout main
-git pull origin main
-
-# 20. Delete the feature branch (optional cleanup)
-git branch -d task-004
-git push origin --delete task-004
-```
-
-## **Commit Message Standards**
-
-### **Subtask Commits**
-```bash
-# ✅ DO: Consistent subtask commit format
-git commit -m "feat(task-4): Complete subtask 4.1 - Initialize Express server
-
-- Set up Express.js with TypeScript configuration
-- Added CORS and body parsing middleware
-- Implemented health check endpoints
-- Basic error handling middleware
-
-Subtask 4.1: Initialize project with npm and install dependencies
-Relates to Task 4: Setup Express.js Server Project"
-
-# ❌ DON'T: Vague or inconsistent commits
-git commit -m "fixed stuff"
-git commit -m "working on task"
-```
-
-### **Test Commits**
-```bash
-# ✅ DO: Separate test commits when substantial
-git commit -m "test(task-4): Add comprehensive tests for Express server setup
-
-- Unit tests for middleware configuration
-- Integration tests for health check endpoints
-- Mock tests for database connection
-- All tests passing with 95% coverage
-
-Task 4: Setup Express.js Server Project - Testing complete"
-```
-
-### **Commit Type Prefixes**
-- `feat(task-X):` - New feature implementation
-- `fix(task-X):` - Bug fixes
-- `test(task-X):` - Test additions/modifications
-- `docs(task-X):` - Documentation updates
-- `refactor(task-X):` - Code refactoring
-- `chore(task-X):` - Build/tooling changes
-
-## **Task Master Commands Integration**
-
-### **Essential Commands for Git Workflow**
-```bash
-# Task management
-task-master show <id>           # Get task/subtask details
-task-master next                # Find next task to work on
-task-master set-status --id=<id> --status=<status>
-task-master update-subtask --id=<id> --prompt="..." --research
-
-# Task expansion (for complex tasks)
-task-master expand --id=<id> --research --force
-
-# Progress tracking
-task-master list                # View all tasks and status
-task-master list --status=in-progress  # View active tasks
-```
-
-### **MCP Tool Equivalents**
-When using Cursor or other MCP-integrated tools:
-- `get_task` instead of `task-master show`
-- `next_task` instead of `task-master next`
-- `set_task_status` instead of `task-master set-status`
-- `update_subtask` instead of `task-master update-subtask`
-
-## **Branch Management Rules**
-
-### **Branch Protection**
-```bash
-# ✅ DO: Always work on task branches
-git checkout -b task-005
-# Make changes
-git commit -m "..."
-git push origin task-005
-
-# ❌ DON'T: Commit directly to main
-git checkout main
-git commit -m "..."  # NEVER do this
-```
-
-### **Keeping Branches Updated**
-```bash
-# ✅ DO: Regularly sync with main (for long-running tasks)
-git checkout task-005
-git fetch origin
-git rebase origin/main  # or merge if preferred
-
-# Resolve any conflicts and continue
-```
-
-## **Pull Request Guidelines**
-
-### **PR Title Format**
-```
-Task <ID>: <Task Title>
-
-Examples:
-Task 4: Setup Express.js Server Project
-Task 7: Implement User Authentication
-Task 12: Add Stripe Payment Integration
-```
-
-### **PR Description Template**
-```markdown
-## Task Overview
-Brief description of the main task objective.
-
-## Subtasks Completed
-- [x] 4.1: Initialize project with npm and install dependencies
-- [x] 4.2: Configure TypeScript, ESLint and Prettier  
-- [x] 4.3: Create basic Express app with middleware and health check route
-
-## Implementation Details
-- Key architectural decisions made
-- Important code changes
-- Any deviations from original plan
-
-## Testing
-- [ ] Unit tests added/updated
-- [ ] Integration tests passing
-- [ ] Manual testing completed
-
-## Breaking Changes
-List any breaking changes or migration requirements.
-
-## Related Tasks
-Mention any dependent tasks or follow-up work needed.
-```
-
-## **Conflict Resolution**
-
-### **Task Conflicts**
-```bash
-# If multiple people work on overlapping tasks:
-# 1. Use Task Master's move functionality to reorganize
-task-master move --from=5 --to=25  # Move conflicting task
-
-# 2. Update task dependencies
-task-master add-dependency --id=6 --depends-on=5
-
-# 3. Coordinate through PR comments and task updates
-```
-
-### **Code Conflicts**
-```bash
-# Standard Git conflict resolution
-git fetch origin
-git rebase origin/main
-# Resolve conflicts in files
-git add .
-git rebase --continue
-```
-
-## **Emergency Procedures**
-
-### **Hotfixes**
-```bash
-# For urgent production fixes:
-git checkout main
-git pull origin main
-git checkout -b hotfix-urgent-issue
-
-# Make minimal fix
-git commit -m "hotfix: Fix critical production issue
-
-- Specific fix description
-- Minimal impact change
-- Requires immediate deployment"
-
-git push origin hotfix-urgent-issue
-# Create emergency PR for immediate review
-```
-
-### **Task Abandonment**
-```bash
-# If task needs to be abandoned or significantly changed:
-# 1. Update task status
-task-master set-status --id=<id> --status=cancelled
-
-# 2. Clean up branch
-git checkout main
-git branch -D task-<id>
-git push origin --delete task-<id>
-
-# 3. Document reasoning in task
-task-master update-task --id=<id> --prompt="Task cancelled due to..."
-```
-
----
-
-**References:**
-- [Task Master Workflow](mdc:.cursor/rules/dev_workflow.mdc)
-- [Architecture Guidelines](mdc:.cursor/rules/architecture.mdc)
-- [Task Master Commands](mdc:.cursor/rules/taskmaster.mdc)

.cursor/rules/new_features.mdc

@@ -24,22 +24,17 @@ alwaysApply: false
 The standard pattern for adding a feature follows this workflow:
 
 1. **Core Logic**: Implement the business logic in the appropriate module (e.g., [`task-manager.js`](mdc:scripts/modules/task-manager.js)).
-2. **Context Gathering (If Applicable)**: 
-   - For AI-powered commands that benefit from project context, use the standardized context gathering patterns from [`context_gathering.mdc`](mdc:.cursor/rules/context_gathering.mdc).
-   - Import `ContextGatherer` and `FuzzyTaskSearch` utilities for reusable context extraction.
-   - Support multiple context types: tasks, files, custom text, project tree.
-   - Implement detailed token breakdown display for transparency.
-3. **AI Integration (If Applicable)**: 
+2. **AI Integration (If Applicable)**: 
    - Import necessary service functions (e.g., `generateTextService`, `streamTextService`) from [`ai-services-unified.js`](mdc:scripts/modules/ai-services-unified.js).
    - Prepare parameters (`role`, `session`, `systemPrompt`, `prompt`).
    - Call the service function.
    - Handle the response (direct text or stream object).
    - **Important**: Prefer `generateTextService` for calls sending large context (like stringified JSON) where incremental display is not needed. See [`ai_services.mdc`](mdc:.cursor/rules/ai_services.mdc) for detailed usage patterns and cautions.
-4. **UI Components**: Add any display functions to [`ui.js`](mdc:scripts/modules/ui.js) following [`ui.mdc`](mdc:.cursor/rules/ui.mdc). Consider enhanced formatting with syntax highlighting for code blocks.
-5. **Command Integration**: Add the CLI command to [`commands.js`](mdc:scripts/modules/commands.js) following [`commands.mdc`](mdc:.cursor/rules/commands.mdc).
-6. **Testing**: Write tests for all components of the feature (following [`tests.mdc`](mdc:.cursor/rules/tests.mdc))
-7. **Configuration**: Update configuration settings or add new ones in [`config-manager.js`](mdc:scripts/modules/config-manager.js) and ensure getters/setters are appropriate. Update documentation in [`utilities.mdc`](mdc:.cursor/rules/utilities.mdc) and [`taskmaster.mdc`](mdc:.cursor/rules/taskmaster.mdc). Update the `.taskmasterconfig` structure if needed.
-8. **Documentation**: Update help text and documentation in [`dev_workflow.mdc`](mdc:.cursor/rules/dev_workflow.mdc) and [`taskmaster.mdc`](mdc:.cursor/rules/taskmaster.mdc).
+3. **UI Components**: Add any display functions to [`ui.js`](mdc:scripts/modules/ui.js) following [`ui.mdc`](mdc:.cursor/rules/ui.mdc).
+4. **Command Integration**: Add the CLI command to [`commands.js`](mdc:scripts/modules/commands.js) following [`commands.mdc`](mdc:.cursor/rules/commands.mdc).
+5. **Testing**: Write tests for all components of the feature (following [`tests.mdc`](mdc:.cursor/rules/tests.mdc))
+6. **Configuration**: Update configuration settings or add new ones in [`config-manager.js`](mdc:scripts/modules/config-manager.js) and ensure getters/setters are appropriate. Update documentation in [`utilities.mdc`](mdc:.cursor/rules/utilities.mdc) and [`taskmaster.mdc`](mdc:.cursor/rules/taskmaster.mdc). Update the `.taskmasterconfig` structure if needed.
+7. **Documentation**: Update help text and documentation in [`dev_workflow.mdc`](mdc:.cursor/rules/dev_workflow.mdc) and [`taskmaster.mdc`](mdc:.cursor/rules/taskmaster.mdc).
 
 ## Critical Checklist for New Features
 

.cursor/rules/taskmaster.mdc

@@ -36,7 +36,7 @@ This document provides a detailed reference for interacting with Taskmaster, cov
     *   `addAliases`: `Add shell aliases tm and taskmaster. Default is false.` (CLI: `--aliases`)
     *   `yes`: `Skip prompts and use defaults/provided arguments. Default is false.` (CLI: `-y, --yes`)
 *   **Usage:** Run this once at the beginning of a new project, typically via an integrated tool like Cursor. Operates on the current working directory of the MCP server. 
-*   **Important:** Once complete, you *MUST* parse a prd in order to generate tasks. There will be no tasks files until then. The next step after initializing should be to create a PRD using the example PRD in scripts/example_prd.txt. 
+*   **Important:** Once complete, you *MUST* parse a prd in order to generate tasks. There will be no tasks files until then. The next step after initializing should be to create a PRD using the example PRD in .taskmaster/templates/example_prd.txt. 
 
 ### 2. Parse PRD (`parse_prd`)
 
@@ -45,12 +45,12 @@ This document provides a detailed reference for interacting with Taskmaster, cov
 *   **Description:** `Parse a Product Requirements Document, PRD, or text file with Taskmaster to automatically generate an initial set of tasks in tasks.json.`
 *   **Key Parameters/Options:**
     *   `input`: `Path to your PRD or requirements text file that Taskmaster should parse for tasks.` (CLI: `[file]` positional or `-i, --input <file>`)
-    *   `output`: `Specify where Taskmaster should save the generated 'tasks.json' file. Defaults to 'tasks/tasks.json'.` (CLI: `-o, --output <file>`)
+    *   `output`: `Specify where Taskmaster should save the generated 'tasks.json' file. Defaults to '.taskmaster/tasks/tasks.json'.` (CLI: `-o, --output <file>`)
     *   `numTasks`: `Approximate number of top-level tasks Taskmaster should aim to generate from the document.` (CLI: `-n, --num-tasks <number>`)
     *   `force`: `Use this to allow Taskmaster to overwrite an existing 'tasks.json' without asking for confirmation.` (CLI: `-f, --force`)
 *   **Usage:** Useful for bootstrapping a project from an existing requirements document.
 *   **Notes:** Task Master will strictly adhere to any specific requirements mentioned in the PRD, such as libraries, database schemas, frameworks, tech stacks, etc., while filling in any gaps where the PRD isn't fully specified. Tasks are designed to provide the most direct implementation path while avoiding over-engineering.
-*   **Important:** This MCP tool makes AI calls and can take up to a minute to complete. Please inform users to hang tight while the operation is in progress. If the user does not have a PRD, suggest discussing their idea and then use the example PRD in `scripts/example_prd.txt` as a template for creating the PRD based on their idea, for use with `parse-prd`.
+*   **Important:** This MCP tool makes AI calls and can take up to a minute to complete. Please inform users to hang tight while the operation is in progress. If the user does not have a PRD, suggest discussing their idea and then use the example PRD in `.taskmaster/templates/example_prd.txt` as a template for creating the PRD based on their idea, for use with `parse-prd`.
 
 ---
 
@@ -77,10 +77,10 @@ This document provides a detailed reference for interacting with Taskmaster, cov
     *   `--setup`: `Run interactive setup to configure models, including custom Ollama/OpenRouter IDs.`
 *   **Usage (MCP):** Call without set flags to get current config. Use `setMain`, `setResearch`, or `setFallback` with a valid model ID to update the configuration. Use `listAvailableModels: true` to get a list of unassigned models. To set a custom model, provide the model ID and set `ollama: true` or `openrouter: true`.
 *   **Usage (CLI):** Run without flags to view current configuration and available models. Use set flags to update specific roles. Use `--setup` for guided configuration, including custom models. To set a custom model via flags, use `--set-<role>=<model_id>` along with either `--ollama` or `--openrouter`.
-*   **Notes:** Configuration is stored in `.taskmasterconfig` in the project root. This command/tool modifies that file. Use `listAvailableModels` or `task-master models` to see internally supported models. OpenRouter custom models are validated against their live API. Ollama custom models are not validated live.
+*   **Notes:** Configuration is stored in `.taskmaster/config.json` in the project root. This command/tool modifies that file. Use `listAvailableModels` or `task-master models` to see internally supported models. OpenRouter custom models are validated against their live API. Ollama custom models are not validated live.
 *   **API note:** API keys for selected AI providers (based on their model) need to exist in the mcp.json file to be accessible in MCP context. The API keys must be present in the local .env file for the CLI to be able to read them.
 *   **Model costs:** The costs in supported models are expressed in dollars. An input/output value of 3 is $3.00. A value of 0.8 is $0.80. 
-*   **Warning:** DO NOT MANUALLY EDIT THE .taskmasterconfig FILE. Use the included commands either in the MCP or CLI format as needed. Always prioritize MCP tools when available and use the CLI as a fallback.
+*   **Warning:** DO NOT MANUALLY EDIT THE .taskmaster/config.json FILE. Use the included commands either in the MCP or CLI format as needed. Always prioritize MCP tools when available and use the CLI as a fallback.
 
 ---
 
@@ -112,10 +112,9 @@ This document provides a detailed reference for interacting with Taskmaster, cov
 *   **CLI Command:** `task-master show [id] [options]`
 *   **Description:** `Display detailed information for a specific Taskmaster task or subtask by its ID.`
 *   **Key Parameters/Options:**
-    *   `id`: `Required. The ID of the Taskmaster task, e.g., '15', or subtask, e.g., '15.2', you want to view.` (CLI: `[id]. Supports comma-separated list of tasks to get multiple tasks at once.` positional or `-i, --id <id>`)
+    *   `id`: `Required. The ID of the Taskmaster task, e.g., '15', or subtask, e.g., '15.2', you want to view.` (CLI: `[id]` positional or `-i, --id <id>`)
     *   `file`: `Path to your Taskmaster 'tasks.json' file. Default relies on auto-detection.` (CLI: `-f, --file <file>`)
 *   **Usage:** Understand the full details, implementation notes, and test strategy for a specific task before starting work.
-*   **CRITICAL INFORMATION** If you need to collect information from multiple tasks, use comma-separated IDs (i.e. 1,2,3) to receive an array of tasks. Do not needlessly get tasks one at a time if you need to get many as that is wasteful.
 
 ---
 
@@ -349,7 +348,7 @@ This document provides a detailed reference for interacting with Taskmaster, cov
 *   **CLI Command:** `task-master analyze-complexity [options]`
 *   **Description:** `Have Taskmaster analyze your tasks to determine their complexity and suggest which ones need to be broken down further.`
 *   **Key Parameters/Options:**
-    *   `output`: `Where to save the complexity analysis report (default: 'scripts/task-complexity-report.json').` (CLI: `-o, --output <file>`)
+    *   `output`: `Where to save the complexity analysis report (default: '.taskmaster/reports/task-complexity-report.json').` (CLI: `-o, --output <file>`)
     *   `threshold`: `The minimum complexity score (1-10) that should trigger a recommendation to expand a task.` (CLI: `-t, --threshold <number>`)
     *   `research`: `Enable research role for more accurate complexity analysis. Requires appropriate API key.` (CLI: `-r, --research`)
     *   `file`: `Path to your Taskmaster 'tasks.json' file. Default relies on auto-detection.` (CLI: `-f, --file <file>`)
@@ -362,48 +361,11 @@ This document provides a detailed reference for interacting with Taskmaster, cov
 *   **CLI Command:** `task-master complexity-report [options]`
 *   **Description:** `Display the task complexity analysis report in a readable format.`
 *   **Key Parameters/Options:**
-    *   `file`: `Path to the complexity report (default: 'scripts/task-complexity-report.json').` (CLI: `-f, --file <file>`)
+    *   `file`: `Path to the complexity report (default: '.taskmaster/reports/task-complexity-report.json').` (CLI: `-f, --file <file>`)
 *   **Usage:** Review and understand the complexity analysis results after running analyze-complexity.
 
 ---
 
-## AI-Powered Research
-
-### 25. Research (`research`)
-
-*   **MCP Tool:** `research`
-*   **CLI Command:** `task-master research [options]`
-*   **Description:** `Perform AI-powered research queries with project context to get fresh, up-to-date information beyond the AI's knowledge cutoff.`
-*   **Key Parameters/Options:**
-    *   `query`: `Required. Research query/prompt (e.g., "What are the latest best practices for React Query v5?").` (CLI: `[query]` positional or `-q, --query <text>`)
-    *   `taskIds`: `Comma-separated list of task/subtask IDs for context (e.g., "15,16.2,17").` (CLI: `-i, --id <ids>`)
-    *   `filePaths`: `Comma-separated list of file paths for context (e.g., "src/api.js,docs/readme.md").` (CLI: `-f, --files <paths>`)
-    *   `customContext`: `Additional custom context text to include in the research.` (CLI: `-c, --context <text>`)
-    *   `includeProjectTree`: `Include project file tree structure in context (default: false).` (CLI: `--tree`)
-    *   `detailLevel`: `Detail level for the research response: 'low', 'medium', 'high' (default: medium).` (CLI: `--detail <level>`)
-    *   `projectRoot`: `The directory of the project. Must be an absolute path.` (CLI: Determined automatically)
-*   **Usage:** **This is a POWERFUL tool that agents should use FREQUENTLY** to:
-    *   Get fresh information beyond knowledge cutoff dates
-    *   Research latest best practices, library updates, security patches
-    *   Find implementation examples for specific technologies
-    *   Validate approaches against current industry standards
-    *   Get contextual advice based on project files and tasks
-*   **When to Consider Using Research:**
-    *   **Before implementing any task** - Research current best practices
-    *   **When encountering new technologies** - Get up-to-date implementation guidance (libraries, apis, etc)
-    *   **For security-related tasks** - Find latest security recommendations
-    *   **When updating dependencies** - Research breaking changes and migration guides
-    *   **For performance optimization** - Get current performance best practices
-    *   **When debugging complex issues** - Research known solutions and workarounds
-*   **Research + Action Pattern:**
-    *   Use `research` to gather fresh information
-    *   Use `update_subtask` to commit findings with timestamps
-    *   Use `update_task` to incorporate research into task details
-    *   Use `add_task` with research flag for informed task creation
-*   **Important:** This MCP tool makes AI calls and can take up to a minute to complete. The research provides FRESH data beyond the AI's training cutoff, making it invaluable for current best practices and recent developments.
-
----
-
 ## File Management
 
 ### 24. Generate Task Files (`generate`)
@@ -420,7 +382,7 @@ This document provides a detailed reference for interacting with Taskmaster, cov
 
 ## Environment Variables Configuration (Updated)
 
-Taskmaster primarily uses the **`.taskmasterconfig`** file (in project root) for configuration (models, parameters, logging level, etc.), managed via `task-master models --setup`.
+Taskmaster primarily uses the **`.taskmaster/config.json`** file (in project root) for configuration (models, parameters, logging level, etc.), managed via `task-master models --setup`.
 
 Environment variables are used **only** for sensitive API keys related to AI providers and specific overrides like the Ollama base URL:
 
@@ -433,12 +395,12 @@ Environment variables are used **only** for sensitive API keys related to AI pro
     *   `AZURE_OPENAI_API_KEY` (Requires `AZURE_OPENAI_ENDPOINT` too)
     *   `OPENROUTER_API_KEY`
     *   `XAI_API_KEY`
-    *   `OLLANA_API_KEY` (Requires `OLLAMA_BASE_URL` too)
-*   **Endpoints (Optional/Provider Specific inside .taskmasterconfig):**
+    *   `OLLAMA_API_KEY` (Requires `OLLAMA_BASE_URL` too)
+*   **Endpoints (Optional/Provider Specific inside .taskmaster/config.json):**
     *   `AZURE_OPENAI_ENDPOINT`
     *   `OLLAMA_BASE_URL` (Default: `http://localhost:11434/api`)
 
-**Set API keys** in your **`.env`** file in the project root (for CLI use) or within the `env` section of your **`.cursor/mcp.json`** file (for MCP/Cursor integration). All other settings (model choice, max tokens, temperature, log level, custom endpoints) are managed in `.taskmasterconfig` via `task-master models` command or `models` MCP tool.
+**Set API keys** in your **`.env`** file in the project root (for CLI use) or within the `env` section of your **`.cursor/mcp.json`** file (for MCP/Cursor integration). All other settings (model choice, max tokens, temperature, log level, custom endpoints) are managed in `.taskmaster/config.json` via `task-master models` command or `models` MCP tool.
 
 ---
 

.cursor/rules/tdd_workflow.mdc

@@ -1,408 +0,0 @@
----
-description: 
-globs: 
-alwaysApply: true
----
-# Test Workflow & Development Process
-
-## **Test-Driven Development (TDD) Integration**
-
-### **Core TDD Cycle with Jest**
-```bash
-# 1. Start development with watch mode
-npm run test:watch
-
-# 2. Write failing test first
-# Create test file: src/utils/newFeature.test.ts
-# Write test that describes expected behavior
-
-# 3. Implement minimum code to make test pass
-# 4. Refactor while keeping tests green
-# 5. Add edge cases and error scenarios
-```
-
-### **TDD Workflow Per Subtask**
-```bash
-# When starting a new subtask:
-task-master set-status --id=4.1 --status=in-progress
-
-# Begin TDD cycle:
-npm run test:watch  # Keep running during development
-
-# Document TDD progress in subtask:
-task-master update-subtask --id=4.1 --prompt="TDD Progress:
-- Written 3 failing tests for core functionality
-- Implemented basic feature, tests now passing
-- Adding edge case tests for error handling"
-
-# Complete subtask with test summary:
-task-master update-subtask --id=4.1 --prompt="Implementation complete:
-- Feature implemented with 8 unit tests
-- Coverage: 95% statements, 88% branches  
-- All tests passing, TDD cycle complete"
-```
-
-## **Testing Commands & Usage**
-
-### **Development Commands**
-```bash
-# Primary development command - use during coding
-npm run test:watch              # Watch mode with Jest
-npm run test:watch -- --testNamePattern="auth"  # Watch specific tests
-
-# Targeted testing during development
-npm run test:unit               # Run only unit tests
-npm run test:unit -- --coverage # Unit tests with coverage
-
-# Integration testing when APIs are ready
-npm run test:integration        # Run integration tests
-npm run test:integration -- --detectOpenHandles  # Debug hanging tests
-
-# End-to-end testing for workflows
-npm run test:e2e               # Run E2E tests
-npm run test:e2e -- --timeout=30000  # Extended timeout for E2E
-```
-
-### **Quality Assurance Commands**
-```bash
-# Full test suite with coverage (before commits)
-npm run test:coverage          # Complete coverage analysis
-
-# All tests (CI/CD pipeline)
-npm test                       # Run all test projects
-
-# Specific test file execution
-npm test -- auth.test.ts       # Run specific test file
-npm test -- --testNamePattern="should handle errors"  # Run specific tests
-```
-
-## **Test Implementation Patterns**
-
-### **Unit Test Development**
-```typescript
-// ✅ DO: Follow established patterns from auth.test.ts
-describe('FeatureName', () => {
-  beforeEach(() => {
-    jest.clearAllMocks();
-    // Setup mocks with proper typing
-  });
-
-  describe('functionName', () => {
-    it('should handle normal case', () => {
-      // Test implementation with specific assertions
-    });
-    
-    it('should throw error for invalid input', async () => {
-      // Error scenario testing
-      await expect(functionName(invalidInput))
-        .rejects.toThrow('Specific error message');
-    });
-  });
-});
-```
-
-### **Integration Test Development**  
-```typescript
-// ✅ DO: Use supertest for API endpoint testing
-import request from 'supertest';
-import { app } from '../../src/app';
-
-describe('POST /api/auth/register', () => {
-  beforeEach(async () => {
-    await integrationTestUtils.cleanupTestData();
-  });
-  
-  it('should register user successfully', async () => {
-    const userData = createTestUser();
-    
-    const response = await request(app)
-      .post('/api/auth/register')
-      .send(userData)
-      .expect(201);
-      
-    expect(response.body).toMatchObject({
-      id: expect.any(String),
-      email: userData.email
-    });
-    
-    // Verify database state
-    const user = await prisma.user.findUnique({
-      where: { email: userData.email }
-    });
-    expect(user).toBeTruthy();
-  });
-});
-```
-
-### **E2E Test Development**
-```typescript
-// ✅ DO: Test complete user workflows
-describe('User Authentication Flow', () => {
-  it('should complete registration → login → protected access', async () => {
-    // Step 1: Register
-    const userData = createTestUser();
-    await request(app)
-      .post('/api/auth/register')
-      .send(userData)
-      .expect(201);
-    
-    // Step 2: Login
-    const loginResponse = await request(app)
-      .post('/api/auth/login')
-      .send({ email: userData.email, password: userData.password })
-      .expect(200);
-    
-    const { token } = loginResponse.body;
-    
-    // Step 3: Access protected resource
-    await request(app)
-      .get('/api/profile')
-      .set('Authorization', `Bearer ${token}`)
-      .expect(200);
-  }, 30000); // Extended timeout for E2E
-});
-```
-
-## **Mocking & Test Utilities**
-
-### **Established Mocking Patterns**
-```typescript
-// ✅ DO: Use established bcrypt mocking pattern
-jest.mock('bcrypt');
-import bcrypt from 'bcrypt';
-const mockHash = bcrypt.hash as jest.MockedFunction<typeof bcrypt.hash>;
-const mockCompare = bcrypt.compare as jest.MockedFunction<typeof bcrypt.compare>;
-
-// ✅ DO: Use Prisma mocking for unit tests
-jest.mock('@prisma/client', () => ({
-  PrismaClient: jest.fn().mockImplementation(() => ({
-    user: {
-      create: jest.fn(),
-      findUnique: jest.fn(),
-    },
-    $connect: jest.fn(),
-    $disconnect: jest.fn(),
-  })),
-}));
-```
-
-### **Test Fixtures Usage**
-```typescript
-// ✅ DO: Use centralized test fixtures
-import { createTestUser, adminUser, invalidUser } from '../fixtures/users';
-
-describe('User Service', () => {
-  it('should handle admin user creation', async () => {
-    const userData = createTestUser(adminUser);
-    // Test implementation
-  });
-  
-  it('should reject invalid user data', async () => {
-    const userData = createTestUser(invalidUser);
-    // Error testing
-  });
-});
-```
-
-## **Coverage Standards & Monitoring**
-
-### **Coverage Thresholds**
-- **Global Standards**: 80% lines/functions, 70% branches
-- **Critical Code**: 90% utils, 85% middleware
-- **New Features**: Must meet or exceed global thresholds
-- **Legacy Code**: Gradual improvement with each change
-
-### **Coverage Reporting & Analysis**
-```bash
-# Generate coverage reports
-npm run test:coverage
-
-# View detailed HTML report
-open coverage/lcov-report/index.html
-
-# Coverage files generated:
-# - coverage/lcov-report/index.html  # Detailed HTML report
-# - coverage/lcov.info               # LCOV format for IDE integration  
-# - coverage/coverage-final.json     # JSON format for tooling
-```
-
-### **Coverage Quality Checks**
-```typescript
-// ✅ DO: Test all code paths
-describe('validateInput', () => {
-  it('should return true for valid input', () => {
-    expect(validateInput('valid')).toBe(true);
-  });
-  
-  it('should return false for various invalid inputs', () => {
-    expect(validateInput('')).toBe(false);      // Empty string
-    expect(validateInput(null)).toBe(false);    // Null value
-    expect(validateInput(undefined)).toBe(false); // Undefined
-  });
-  
-  it('should throw for unexpected input types', () => {
-    expect(() => validateInput(123)).toThrow('Invalid input type');
-  });
-});
-```
-
-## **Testing During Development Phases**
-
-### **Feature Development Phase**
-```bash
-# 1. Start feature development
-task-master set-status --id=X.Y --status=in-progress
-
-# 2. Begin TDD cycle  
-npm run test:watch
-
-# 3. Document test progress in subtask
-task-master update-subtask --id=X.Y --prompt="Test development:
-- Created test file with 5 failing tests
-- Implemented core functionality
-- Tests passing, adding error scenarios"
-
-# 4. Verify coverage before completion
-npm run test:coverage
-
-# 5. Update subtask with final test status
-task-master update-subtask --id=X.Y --prompt="Testing complete:
-- 12 unit tests with full coverage
-- All edge cases and error scenarios covered
-- Ready for integration testing"
-```
-
-### **Integration Testing Phase**
-```bash
-# After API endpoints are implemented
-npm run test:integration
-
-# Update integration test templates
-# Replace placeholder tests with real endpoint calls
-
-# Document integration test results
-task-master update-subtask --id=X.Y --prompt="Integration tests:
-- Updated auth endpoint tests  
-- Database integration verified
-- All HTTP status codes and responses tested"
-```
-
-### **Pre-Commit Testing Phase**
-```bash
-# Before committing code
-npm run test:coverage         # Verify all tests pass with coverage
-npm run test:unit            # Quick unit test verification
-npm run test:integration     # Integration test verification (if applicable)
-
-# Commit pattern for test updates
-git add tests/ src/**/*.test.ts
-git commit -m "test(task-X): Add comprehensive tests for Feature Y
-
-- Unit tests with 95% coverage (exceeds 90% threshold)
-- Integration tests for API endpoints
-- Test fixtures for data generation
-- Proper mocking patterns established
-
-Task X: Feature Y - Testing complete"
-```
-
-## **Error Handling & Debugging**
-
-### **Test Debugging Techniques**
-```typescript
-// ✅ DO: Use test utilities for debugging
-import { testUtils } from '../setup';
-
-it('should debug complex operation', () => {
-  testUtils.withConsole(() => {
-    // Console output visible only for this test
-    console.log('Debug info:', complexData);
-    service.complexOperation();
-  });
-});
-
-// ✅ DO: Use proper async debugging
-it('should handle async operations', async () => {
-  const promise = service.asyncOperation();
-  
-  // Test intermediate state
-  expect(service.isProcessing()).toBe(true);
-  
-  const result = await promise;
-  expect(result).toBe('expected');
-  expect(service.isProcessing()).toBe(false);
-});
-```
-
-### **Common Test Issues & Solutions**
-```bash
-# Hanging tests (common with database connections)
-npm run test:integration -- --detectOpenHandles
-
-# Memory leaks in tests
-npm run test:unit -- --logHeapUsage
-
-# Slow tests identification
-npm run test:coverage -- --verbose
-
-# Mock not working properly
-# Check: mock is declared before imports
-# Check: jest.clearAllMocks() in beforeEach
-# Check: TypeScript typing is correct
-```
-
-## **Continuous Integration Integration**
-
-### **CI/CD Pipeline Testing**
-```yaml
-# Example GitHub Actions integration
-- name: Run tests
-  run: |
-    npm ci
-    npm run test:coverage
-    
-- name: Upload coverage reports
-  uses: codecov/codecov-action@v3
-  with:
-    file: ./coverage/lcov.info
-```
-
-### **Pre-commit Hooks**
-```bash
-# Setup pre-commit testing (recommended)
-# In package.json scripts:
-"pre-commit": "npm run test:unit && npm run test:integration"
-
-# Husky integration example:
-npx husky add .husky/pre-commit "npm run test:unit"
-```
-
-## **Test Maintenance & Evolution**
-
-### **Adding Tests for New Features**
-1. **Create test file** alongside source code or in `tests/unit/`
-2. **Follow established patterns** from `src/utils/auth.test.ts`
-3. **Use existing fixtures** from `tests/fixtures/`
-4. **Apply proper mocking** patterns for dependencies
-5. **Meet coverage thresholds** for the module
-
-### **Updating Integration/E2E Tests**
-1. **Update templates** in `tests/integration/` when APIs change
-2. **Modify E2E workflows** in `tests/e2e/` for new user journeys  
-3. **Update test fixtures** for new data requirements
-4. **Maintain database cleanup** utilities
-
-### **Test Performance Optimization**
-- **Parallel execution**: Jest runs tests in parallel by default
-- **Test isolation**: Use proper setup/teardown for independence
-- **Mock optimization**: Mock heavy dependencies appropriately  
-- **Database efficiency**: Use transaction rollbacks where possible
-
----
-
-**Key References:**
-- [Testing Standards](mdc:.cursor/rules/tests.mdc)
-- [Git Workflow](mdc:.cursor/rules/git_workflow.mdc)
-- [Development Workflow](mdc:.cursor/rules/dev_workflow.mdc)
-- [Jest Configuration](mdc:jest.config.js)
-- [Auth Test Example](mdc:src/utils/auth.test.ts)

.cursor/rules/ui.mdc

@@ -150,91 +150,4 @@ alwaysApply: false
   ));
   ```
 
-## Enhanced Display Patterns
-
-### **Token Breakdown Display**
-- Use detailed, granular token breakdowns for AI-powered commands
-- Display context sources with individual token counts
-- Show both token count and character count for transparency
-
-  ```javascript
-  // ✅ DO: Display detailed token breakdown
-  function displayDetailedTokenBreakdown(tokenBreakdown, systemTokens, userTokens) {
-    const sections = [];
-    
-    if (tokenBreakdown.tasks?.length > 0) {
-      const taskDetails = tokenBreakdown.tasks.map(task => 
-        `${task.type === 'subtask' ? '  ' : ''}${task.id}: ${task.tokens.toLocaleString()}`
-      ).join('\n');
-      sections.push(`Tasks (${tokenBreakdown.tasks.reduce((sum, t) => sum + t.tokens, 0).toLocaleString()}):\n${taskDetails}`);
-    }
-    
-    const content = sections.join('\n\n');
-    console.log(boxen(content, {
-      title: chalk.cyan('Token Usage'),
-      padding: { top: 1, bottom: 1, left: 2, right: 2 },
-      borderStyle: 'round',
-      borderColor: 'cyan'
-    }));
-  }
-  ```
-
-### **Code Block Syntax Highlighting**
-- Use `cli-highlight` library for syntax highlighting in terminal output
-- Process code blocks in AI responses for better readability
-
-  ```javascript
-  // ✅ DO: Enhance code blocks with syntax highlighting
-  import { highlight } from 'cli-highlight';
-  
-  function processCodeBlocks(text) {
-    return text.replace(/```(\w+)?\n([\s\S]*?)```/g, (match, language, code) => {
-      try {
-        const highlighted = highlight(code.trim(), { 
-          language: language || 'javascript',
-          theme: 'default'
-        });
-        return `\n${highlighted}\n`;
-      } catch (error) {
-        return `\n${code.trim()}\n`;
-      }
-    });
-  }
-  ```
-
-### **Multi-Section Result Display**
-- Use separate boxes for headers, content, and metadata
-- Maintain consistent styling across different result types
-
-  ```javascript
-  // ✅ DO: Use structured result display
-  function displayResults(result, query, detailLevel) {
-    // Header with query info
-    const header = boxen(
-      chalk.green.bold('Research Results') + '\n\n' +
-      chalk.gray('Query: ') + chalk.white(query) + '\n' +
-      chalk.gray('Detail Level: ') + chalk.cyan(detailLevel),
-      {
-        padding: { top: 1, bottom: 1, left: 2, right: 2 },
-        margin: { top: 1, bottom: 0 },
-        borderStyle: 'round',
-        borderColor: 'green'
-      }
-    );
-    console.log(header);
-    
-    // Process and display main content
-    const processedResult = processCodeBlocks(result);
-    const contentBox = boxen(processedResult, {
-      padding: { top: 1, bottom: 1, left: 2, right: 2 },
-      margin: { top: 0, bottom: 1 },
-      borderStyle: 'single',
-      borderColor: 'gray'
-    });
-    console.log(contentBox);
-    
-    console.log(chalk.green('✓ Operation complete'));
-  }
-  ```
-
-Refer to [`ui.js`](mdc:scripts/modules/ui.js) for implementation examples, [`context_gathering.mdc`](mdc:.cursor/rules/context_gathering.mdc) for context display patterns, and [`new_features.mdc`](mdc:.cursor/rules/new_features.mdc) for integration guidelines. 
+Refer to [`ui.js`](mdc:scripts/modules/ui.js) for implementation examples and [`new_features.mdc`](mdc:.cursor/rules/new_features.mdc) for integration guidelines. 

.cursor/rules/utilities.mdc

@@ -46,7 +46,7 @@ alwaysApply: false
 - **Location**:
     - **Core CLI Utilities**: Place utilities used primarily by the core `task-master` CLI logic and command modules (`scripts/modules/*`) into [`scripts/modules/utils.js`](mdc:scripts/modules/utils.js).
     - **MCP Server Utilities**: Place utilities specifically designed to support the MCP server implementation into the appropriate subdirectories within `mcp-server/src/`.
-        - Path/Core Logic Helpers: [`mcp-server/src/core/utils/`](mdc:mcp-server/src/core/utils) (e.g., `path-utils.js`).
+        - Path/Core Logic Helpers: [`mcp-server/src/core/utils/`](mdc:mcp-server/src/core/utils/) (e.g., `path-utils.js`).
         - Tool Execution/Response Helpers: [`mcp-server/src/tools/utils.js`](mdc:mcp-server/src/tools/utils.js).
 
 ## Documentation Standards
@@ -110,7 +110,7 @@ Taskmaster configuration (excluding API keys) is primarily managed through the `
   - ✅ DO: Use appropriate icons for different log levels
   - ✅ DO: Respect the configured log level
   - ❌ DON'T: Add direct console.log calls outside the logging utility
-  - **Note on Passed Loggers**: When a logger object (like the FastMCP `log` object) is passed *as a parameter* (e.g., as `mcpLog`) into core Task Master functions, the receiving function often expects specific methods (`.info`, `.warn`, `.error`, etc.) to be directly callable on that object (e.g., `mcpLog[level](mdc:...)`). If the passed logger doesn't have this exact structure, a wrapper object may be needed. See the **Handling Logging Context (`mcpLog`)** section in [`mcp.mdc`](mdc:.cursor/rules/mcp.mdc) for the standard pattern used in direct functions.
+  - **Note on Passed Loggers**: When a logger object (like the FastMCP `log` object) is passed *as a parameter* (e.g., as `mcpLog`) into core Task Master functions, the receiving function often expects specific methods (`.info`, `.warn`, `.error`, etc.) to be directly callable on that object (e.g., `mcpLog[level](...)`). If the passed logger doesn't have this exact structure, a wrapper object may be needed. See the **Handling Logging Context (`mcpLog`)** section in [`mcp.mdc`](mdc:.cursor/rules/mcp.mdc) for the standard pattern used in direct functions.
 
 - **Logger Wrapper Pattern**: 
   - ✅ DO: Use the logger wrapper pattern when passing loggers to prevent `mcpLog[level] is not a function` errors:
@@ -548,56 +548,4 @@ export {
 };
 ```
 
-## Context Gathering Utilities
-
-### **ContextGatherer** (`scripts/modules/utils/contextGatherer.js`)
-
-- **Multi-Source Context Extraction**:
-  - ✅ DO: Use for AI-powered commands that need project context
-  - ✅ DO: Support tasks, files, custom text, and project tree context
-  - ✅ DO: Implement detailed token counting with `gpt-tokens` library
-  - ✅ DO: Provide multiple output formats (research, chat, system-prompt)
-
-  ```javascript
-  // ✅ DO: Use ContextGatherer for consistent context extraction
-  import { ContextGatherer } from '../utils/contextGatherer.js';
-  
-  const gatherer = new ContextGatherer(projectRoot, tasksPath);
-  const result = await gatherer.gather({
-    tasks: ['15', '16.2'],
-    files: ['src/api.js'],
-    customContext: 'Additional context',
-    includeProjectTree: true,
-    format: 'research',
-    includeTokenCounts: true
-  });
-  ```
-
-### **FuzzyTaskSearch** (`scripts/modules/utils/fuzzyTaskSearch.js`)
-
-- **Intelligent Task Discovery**:
-  - ✅ DO: Use for automatic task relevance detection
-  - ✅ DO: Configure search parameters based on use case context
-  - ✅ DO: Implement purpose-based categorization for better matching
-  - ✅ DO: Sort results by relevance score and task ID
-
-  ```javascript
-  // ✅ DO: Use FuzzyTaskSearch for intelligent task discovery
-  import { FuzzyTaskSearch } from '../utils/fuzzyTaskSearch.js';
-  
-  const fuzzySearch = new FuzzyTaskSearch(tasksData.tasks, 'research');
-  const searchResults = fuzzySearch.findRelevantTasks(query, {
-    maxResults: 8,
-    includeRecent: true,
-    includeCategoryMatches: true
-  });
-  const taskIds = fuzzySearch.getTaskIds(searchResults);
-  ```
-
-- **Integration Guidelines**:
-  - ✅ DO: Use fuzzy search to supplement user-provided task IDs
-  - ✅ DO: Display discovered task IDs to users for transparency
-  - ✅ DO: Sort discovered task IDs numerically for better readability
-  - ❌ DON'T: Replace explicit user task selections with fuzzy results
-
-Refer to [`context_gathering.mdc`](mdc:.cursor/rules/context_gathering.mdc) for detailed implementation patterns, [`mcp.mdc`](mdc:.cursor/rules/mcp.mdc) and [`architecture.mdc`](mdc:.cursor/rules/architecture.mdc) for more context on MCP server architecture and integration. 
+Refer to [`mcp.mdc`](mdc:.cursor/rules/mcp.mdc) and [`architecture.mdc`](mdc:.cursor/rules/architecture.mdc) for more context on MCP server architecture and integration. 

.gitignore

@@ -19,25 +19,12 @@ npm-debug.log*
 yarn-debug.log*
 yarn-error.log*
 lerna-debug.log*
-
-# Coverage directory used by tools like istanbul
-coverage/
-*.lcov
-
-# Jest cache
-.jest/
-
-# Test temporary files and directories
-tests/temp/
 tests/e2e/_runs/
 tests/e2e/log/
-tests/**/*.log
-tests/**/coverage/
 
-# Test database files (if any)
-tests/**/*.db
-tests/**/*.sqlite
-tests/**/*.sqlite3
+# Coverage directory used by tools like istanbul
+coverage
+*.lcov
 
 # Optional npm cache directory
 .npm
@@ -77,17 +64,3 @@ dev-debug.log
 
 # NPMRC
 .npmrc
-
-# Added by Claude Task Master
-# Editor directories and files
-.idea
-.vscode
-*.suo
-*.ntvs*
-*.njsproj
-*.sln
-*.sw?
-# OS specific
-# Task files
-tasks.json
-tasks/ 

.taskmaster/config.json

@@ -0,0 +1,33 @@
+{
+	"models": {
+		"main": {
+			"provider": "anthropic",
+			"modelId": "claude-sonnet-4-20250514",
+			"maxTokens": 50000,
+			"temperature": 0.2
+		},
+		"research": {
+			"provider": "perplexity",
+			"modelId": "sonar-pro",
+			"maxTokens": 8700,
+			"temperature": 0.1
+		},
+		"fallback": {
+			"provider": "anthropic",
+			"modelId": "claude-3-7-sonnet-20250219",
+			"maxTokens": 128000,
+			"temperature": 0.2
+		}
+	},
+	"global": {
+		"userId": "1234567890",
+		"logLevel": "info",
+		"debug": false,
+		"defaultSubtasks": 5,
+		"defaultPriority": "medium",
+		"projectName": "Taskmaster",
+		"ollamaBaseURL": "http://localhost:11434/api",
+		"bedrockBaseURL": "https://bedrock.us-east-1.amazonaws.com",
+		"azureBaseURL": "https://your-endpoint.azure.com/"
+	}
+}

.taskmaster/docs/prd.txt

@@ -0,0 +1,528 @@
+
+# Claude Task Master - Product Requirements Document
+
+<PRD>
+# Technical Architecture  
+
+## System Components
+1. **Task Management Core**
+   - Tasks.json file structure (single source of truth)
+   - Task model with dependencies, priorities, and metadata
+   - Task state management system
+   - Task file generation subsystem
+
+2. **AI Integration Layer**
+   - Anthropic Claude API integration
+   - Perplexity API integration (optional)
+   - Prompt engineering components
+   - Response parsing and processing
+
+3. **Command Line Interface**
+   - Command parsing and execution
+   - Interactive user input handling
+   - Display and formatting utilities
+   - Status reporting and feedback system
+
+4. **Cursor AI Integration**
+   - Cursor rules documentation
+   - Agent interaction patterns
+   - Workflow guideline specifications
+
+## Data Models
+
+### Task Model
+```json
+{
+  "id": 1,
+  "title": "Task Title",
+  "description": "Brief task description",
+  "status": "pending|done|deferred",
+  "dependencies": [0],
+  "priority": "high|medium|low",
+  "details": "Detailed implementation instructions",
+  "testStrategy": "Verification approach details",
+  "subtasks": [
+    {
+      "id": 1,
+      "title": "Subtask Title",
+      "description": "Subtask description",
+      "status": "pending|done|deferred",
+      "dependencies": [],
+      "acceptanceCriteria": "Verification criteria"
+    }
+  ]
+}
+```
+
+### Tasks Collection Model
+```json
+{
+  "meta": {
+    "projectName": "Project Name",
+    "version": "1.0.0",
+    "prdSource": "path/to/prd.txt",
+    "createdAt": "ISO-8601 timestamp",
+    "updatedAt": "ISO-8601 timestamp"
+  },
+  "tasks": [
+    // Array of Task objects
+  ]
+}
+```
+
+### Task File Format
+```
+# Task ID: <id>
+# Title: <title>
+# Status: <status>
+# Dependencies: <comma-separated list of dependency IDs>
+# Priority: <priority>
+# Description: <brief description>
+# Details:
+<detailed implementation notes>
+
+# Test Strategy:
+<verification approach>
+
+# Subtasks:
+1. <subtask title> - <subtask description>
+```
+
+## APIs and Integrations
+1. **Anthropic Claude API**
+   - Authentication via API key
+   - Prompt construction and streaming
+   - Response parsing and extraction
+   - Error handling and retries
+
+2. **Perplexity API (via OpenAI client)**
+   - Authentication via API key
+   - Research-oriented prompt construction
+   - Enhanced contextual response handling
+   - Fallback mechanisms to Claude
+
+3. **File System API**
+   - Reading/writing tasks.json
+   - Managing individual task files
+   - Command execution logging
+   - Debug logging system
+
+## Infrastructure Requirements
+1. **Node.js Runtime**
+   - Version 14.0.0 or higher
+   - ES Module support
+   - File system access rights
+   - Command execution capabilities
+
+2. **Configuration Management**
+   - Environment variable handling
+   - .env file support
+   - Configuration validation
+   - Sensible defaults with overrides
+
+3. **Development Environment**
+   - Git repository
+   - NPM package management
+   - Cursor editor integration
+   - Command-line terminal access
+
+# Development Roadmap  
+
+## Phase 1: Core Task Management System
+1. **Task Data Structure**
+   - Design and implement the tasks.json structure
+   - Create task model validation
+   - Implement basic task operations (create, read, update)
+   - Develop file system interactions
+
+2. **Command Line Interface Foundation**
+   - Implement command parsing with Commander.js
+   - Create help documentation
+   - Implement colorized console output
+   - Add logging system with configurable levels
+
+3. **Basic Task Operations**
+   - Implement task listing functionality
+   - Create task status update capability
+   - Add dependency tracking
+   - Implement priority management
+
+4. **Task File Generation**
+   - Create task file templates
+   - Implement generation from tasks.json
+   - Add bi-directional synchronization
+   - Implement proper file naming and organization
+
+## Phase 2: AI Integration
+1. **Claude API Integration**
+   - Implement API authentication
+   - Create prompt templates for PRD parsing
+   - Design response handlers
+   - Add error management and retries
+
+2. **PRD Parsing System**
+   - Implement PRD file reading
+   - Create PRD to task conversion logic
+   - Add intelligent dependency inference
+   - Implement priority assignment logic
+
+3. **Task Expansion With Claude**
+   - Create subtask generation prompts
+   - Implement subtask creation workflow
+   - Add context-aware expansion capabilities
+   - Implement parent-child relationship management
+
+4. **Implementation Drift Handling**
+   - Add capability to update future tasks
+   - Implement task rewriting based on new context
+   - Create dependency chain updates
+   - Preserve completed work while updating future tasks
+
+## Phase 3: Advanced Features
+1. **Perplexity Integration**
+   - Implement Perplexity API authentication
+   - Create research-oriented prompts
+   - Add fallback to Claude when unavailable
+   - Implement response quality comparison logic
+
+2. **Research-Backed Subtask Generation**
+   - Create specialized research prompts
+   - Implement context enrichment
+   - Add domain-specific knowledge incorporation
+   - Create more detailed subtask generation
+
+3. **Batch Operations**
+   - Implement multi-task status updates
+   - Add bulk subtask generation
+   - Create task filtering and querying
+   - Implement advanced dependency management
+
+4. **Project Initialization**
+   - Create project templating system
+   - Implement interactive setup
+   - Add environment configuration
+   - Create documentation generation
+
+## Phase 4: Cursor AI Integration
+1. **Cursor Rules Implementation**
+   - Create dev_workflow.mdc documentation
+   - Implement cursor_rules.mdc
+   - Add self_improve.mdc
+   - Design rule integration documentation
+
+2. **Agent Workflow Guidelines**
+   - Document task discovery workflow
+   - Create task selection guidelines
+   - Implement implementation guidance
+   - Add verification procedures
+
+3. **Agent Command Integration**
+   - Document command syntax for agents
+   - Create example interactions
+   - Implement agent response patterns
+   - Add context management for agents
+
+4. **User Documentation**
+   - Create detailed README
+   - Add scripts documentation
+   - Implement example workflows
+   - Create troubleshooting guides
+
+# Logical Dependency Chain
+
+## Foundation Layer
+1. **Task Data Structure**
+   - Must be implemented first as all other functionality depends on this
+   - Defines the core data model for the entire system
+   - Establishes the single source of truth concept
+
+2. **Command Line Interface**
+   - Built on top of the task data structure
+   - Provides the primary user interaction mechanism
+   - Required for all subsequent operations to be accessible
+
+3. **Basic Task Operations**
+   - Depends on both task data structure and CLI
+   - Provides the fundamental operations for task management
+   - Enables the minimal viable workflow
+
+## Functional Layer
+4. **Task File Generation**
+   - Depends on task data structure and basic operations
+   - Creates the individual task files for reference
+   - Enables the file-based workflow complementing tasks.json
+
+5. **Claude API Integration**
+   - Independent of most previous components but needs the task data structure
+   - Provides the AI capabilities that enhance the system
+   - Gateway to advanced task generation features
+
+6. **PRD Parsing System**
+   - Depends on Claude API integration and task data structure
+   - Enables the initial task generation workflow
+   - Creates the starting point for new projects
+
+## Enhancement Layer
+7. **Task Expansion With Claude**
+   - Depends on Claude API integration and basic task operations
+   - Enhances existing tasks with more detailed subtasks
+   - Improves the implementation guidance
+
+8. **Implementation Drift Handling**
+   - Depends on Claude API integration and task operations
+   - Addresses a key challenge in AI-driven development
+   - Maintains the relevance of task planning as implementation evolves
+
+9. **Perplexity Integration**
+   - Can be developed in parallel with other features after Claude integration
+   - Enhances the quality of generated content
+   - Provides research-backed improvements
+
+## Advanced Layer
+10. **Research-Backed Subtask Generation**
+    - Depends on Perplexity integration and task expansion
+    - Provides higher quality, more contextual subtasks
+    - Enhances the value of the task breakdown
+
+11. **Batch Operations**
+    - Depends on basic task operations
+    - Improves efficiency for managing multiple tasks
+    - Quality-of-life enhancement for larger projects
+
+12. **Project Initialization**
+    - Depends on most previous components being stable
+    - Provides a smooth onboarding experience
+    - Creates a complete project setup in one step
+
+## Integration Layer
+13. **Cursor Rules Implementation**
+    - Can be developed in parallel after basic functionality
+    - Provides the guidance for Cursor AI agent
+    - Enhances the AI-driven workflow
+
+14. **Agent Workflow Guidelines**
+    - Depends on Cursor rules implementation
+    - Structures how the agent interacts with the system
+    - Ensures consistent agent behavior
+
+15. **Agent Command Integration**
+    - Depends on agent workflow guidelines
+    - Provides specific command patterns for the agent
+    - Optimizes the agent-user interaction
+
+16. **User Documentation**
+    - Should be developed alongside all features
+    - Must be completed before release
+    - Ensures users can effectively use the system
+
+# Risks and Mitigations  
+
+## Technical Challenges
+
+### API Reliability
+**Risk**: Anthropic or Perplexity API could have downtime, rate limiting, or breaking changes.
+**Mitigation**: 
+- Implement robust error handling with exponential backoff
+- Add fallback mechanisms (Claude fallback for Perplexity)
+- Cache important responses to reduce API dependency
+- Support offline mode for critical functions
+
+### Model Output Variability
+**Risk**: AI models may produce inconsistent or unexpected outputs.
+**Mitigation**:
+- Design robust prompt templates with strict output formatting requirements
+- Implement response validation and error detection
+- Add self-correction mechanisms and retries with improved prompts
+- Allow manual editing of generated content
+
+### Node.js Version Compatibility
+**Risk**: Differences in Node.js versions could cause unexpected behavior.
+**Mitigation**:
+- Clearly document minimum Node.js version requirements
+- Use transpilers if needed for compatibility
+- Test across multiple Node.js versions
+- Handle version-specific features gracefully
+
+## MVP Definition
+
+### Feature Prioritization
+**Risk**: Including too many features in the MVP could delay release and adoption.
+**Mitigation**:
+- Define MVP as core task management + basic Claude integration
+- Ensure each phase delivers a complete, usable product
+- Implement feature flags for easy enabling/disabling of features
+- Get early user feedback to validate feature importance
+
+### Scope Creep
+**Risk**: The project could expand beyond its original intent, becoming too complex.
+**Mitigation**:
+- Maintain a strict definition of what the tool is and isn't
+- Focus on task management for AI-driven development
+- Evaluate new features against core value proposition
+- Implement extensibility rather than building every feature
+
+### User Expectations
+**Risk**: Users might expect a full project management solution rather than a task tracking system.
+**Mitigation**:
+- Clearly communicate the tool's purpose and limitations
+- Provide integration points with existing project management tools
+- Focus on the unique value of AI-driven development
+- Document specific use cases and example workflows
+
+## Resource Constraints
+
+### Development Capacity
+**Risk**: Limited development resources could delay implementation.
+**Mitigation**:
+- Phase implementation to deliver value incrementally
+- Focus on core functionality first
+- Leverage open source libraries where possible
+- Design for extensibility to allow community contributions
+
+### AI Cost Management
+**Risk**: Excessive API usage could lead to high costs.
+**Mitigation**:
+- Implement token usage tracking and reporting
+- Add configurable limits to prevent unexpected costs
+- Cache responses where appropriate
+- Optimize prompts for token efficiency
+- Support local LLM options in the future
+
+### Documentation Overhead
+**Risk**: Complexity of the system requires extensive documentation that is time-consuming to maintain.
+**Mitigation**:
+- Use AI to help generate and maintain documentation
+- Create self-documenting commands and features
+- Implement progressive documentation (basic to advanced)
+- Build help directly into the CLI
+
+# Appendix  
+
+## AI Prompt Engineering Specifications
+
+### PRD Parsing Prompt Structure
+```
+You are assisting with transforming a Product Requirements Document (PRD) into a structured set of development tasks.
+
+Given the following PRD, create a comprehensive list of development tasks that would be needed to implement the described product.
+
+For each task:
+1. Assign a short, descriptive title
+2. Write a concise description
+3. Identify dependencies (which tasks must be completed before this one)
+4. Assign a priority (high, medium, low)
+5. Include detailed implementation notes
+6. Describe a test strategy to verify completion
+
+Structure the tasks in a logical order of implementation.
+
+PRD:
+{prd_content}
+```
+
+### Task Expansion Prompt Structure
+```
+You are helping to break down a development task into more manageable subtasks.
+
+Main task:
+Title: {task_title}
+Description: {task_description}
+Details: {task_details}
+
+Please create {num_subtasks} specific subtasks that together would accomplish this main task.
+
+For each subtask, provide:
+1. A clear, actionable title
+2. A concise description
+3. Any dependencies on other subtasks
+4. Specific acceptance criteria to verify completion
+
+Additional context:
+{additional_context}
+```
+
+### Research-Backed Expansion Prompt Structure
+```
+You are a technical researcher and developer helping to break down a software development task into detailed, well-researched subtasks.
+
+Main task:
+Title: {task_title}
+Description: {task_description}
+Details: {task_details}
+
+Research the latest best practices, technologies, and implementation patterns for this type of task. Then create {num_subtasks} specific, actionable subtasks that together would accomplish the main task.
+
+For each subtask:
+1. Provide a clear, specific title
+2. Write a detailed description including technical approach
+3. Identify dependencies on other subtasks
+4. Include specific acceptance criteria
+5. Reference any relevant libraries, tools, or resources that should be used
+
+Consider security, performance, maintainability, and user experience in your recommendations.
+```
+
+## Task File System Specification
+
+### Directory Structure
+```
+/
+├── .cursor/
+│   └── rules/
+│       ├── dev_workflow.mdc
+│       ├── cursor_rules.mdc
+│       └── self_improve.mdc
+├── scripts/
+│   ├── dev.js
+│   └── README.md
+├── tasks/
+│   ├── task_001.txt
+│   ├── task_002.txt
+│   └── ...
+├── .env
+├── .env.example
+├── .gitignore
+├── package.json
+├── README.md
+└── tasks.json
+```
+
+### Task ID Specification
+- Main tasks: Sequential integers (1, 2, 3, ...)
+- Subtasks: Parent ID + dot + sequential integer (1.1, 1.2, 2.1, ...)
+- ID references: Used in dependencies, command parameters
+- ID ordering: Implies suggested implementation order
+
+## Command-Line Interface Specification
+
+### Global Options
+- `--help`: Display help information
+- `--version`: Display version information
+- `--file=<file>`: Specify an alternative tasks.json file
+- `--quiet`: Reduce output verbosity
+- `--debug`: Increase output verbosity
+- `--json`: Output in JSON format (for programmatic use)
+
+### Command Structure
+- `node scripts/dev.js <command> [options]`
+- All commands operate on tasks.json by default
+- Commands follow consistent parameter naming
+- Common parameter styles: `--id=<id>`, `--status=<status>`, `--prompt="<text>"`
+- Boolean flags: `--all`, `--force`, `--with-subtasks`
+
+## API Integration Specifications
+
+### Anthropic API Configuration
+- Authentication: ANTHROPIC_API_KEY environment variable
+- Model selection: MODEL environment variable
+- Default model: claude-3-7-sonnet-20250219
+- Maximum tokens: MAX_TOKENS environment variable (default: 4000)
+- Temperature: TEMPERATURE environment variable (default: 0.7)
+
+### Perplexity API Configuration
+- Authentication: PERPLEXITY_API_KEY environment variable
+- Model selection: PERPLEXITY_MODEL environment variable
+- Default model: sonar-medium-online
+- Connection: Via OpenAI client
+- Fallback: Use Claude if Perplexity unavailable
+</PRD>

.taskmaster/reports/task-complexity-report.json

@@ -0,0 +1,357 @@
+{
+	"meta": {
+		"generatedAt": "2025-05-22T05:48:33.026Z",
+		"tasksAnalyzed": 6,
+		"totalTasks": 88,
+		"analysisCount": 43,
+		"thresholdScore": 5,
+		"projectName": "Taskmaster",
+		"usedResearch": true
+	},
+	"complexityAnalysis": [
+		{
+			"taskId": 24,
+			"taskTitle": "Implement AI-Powered Test Generation Command",
+			"complexityScore": 7,
+			"recommendedSubtasks": 5,
+			"expansionPrompt": "Break down the implementation of the AI-powered test generation command into detailed subtasks covering: command structure setup, AI prompt engineering, test file generation logic, integration with Claude API, and comprehensive error handling.",
+			"reasoning": "This task involves complex integration with an AI service (Claude), requires sophisticated prompt engineering, and needs to generate structured code files. The existing 3 subtasks are a good start but could be expanded to include more detailed steps for AI integration, error handling, and test file formatting."
+		},
+		{
+			"taskId": 26,
+			"taskTitle": "Implement Context Foundation for AI Operations",
+			"complexityScore": 6,
+			"recommendedSubtasks": 4,
+			"expansionPrompt": "The current 4 subtasks for implementing the context foundation appear comprehensive. Consider if any additional subtasks are needed for testing, documentation, or integration with existing systems.",
+			"reasoning": "This task involves creating a foundation for context integration with several well-defined components. The existing 4 subtasks cover the main implementation areas (context-file flag, cursor rules integration, context extraction utility, and command handler updates). The complexity is moderate as it requires careful integration with existing systems but has clear requirements."
+		},
+		{
+			"taskId": 27,
+			"taskTitle": "Implement Context Enhancements for AI Operations",
+			"complexityScore": 7,
+			"recommendedSubtasks": 4,
+			"expansionPrompt": "The current 4 subtasks for implementing context enhancements appear well-structured. Consider if any additional subtasks are needed for testing, documentation, or performance optimization.",
+			"reasoning": "This task builds upon the foundation from Task #26 and adds more sophisticated context handling features. The 4 existing subtasks cover the main implementation areas (code context extraction, task history context, PRD context integration, and context formatting). The complexity is higher than the foundation task due to the need for intelligent context selection and optimization."
+		},
+		{
+			"taskId": 28,
+			"taskTitle": "Implement Advanced ContextManager System",
+			"complexityScore": 8,
+			"recommendedSubtasks": 5,
+			"expansionPrompt": "The current 5 subtasks for implementing the advanced ContextManager system appear comprehensive. Consider if any additional subtasks are needed for testing, documentation, or backward compatibility with previous context implementations.",
+			"reasoning": "This task represents the most complex phase of the context implementation, requiring a sophisticated class design, optimization algorithms, and integration with multiple systems. The 5 existing subtasks cover the core implementation areas, but the complexity is high due to the need for intelligent context prioritization, token management, and performance monitoring."
+		},
+		{
+			"taskId": 40,
+			"taskTitle": "Implement 'plan' Command for Task Implementation Planning",
+			"complexityScore": 5,
+			"recommendedSubtasks": 4,
+			"expansionPrompt": "The current 4 subtasks for implementing the 'plan' command appear well-structured. Consider if any additional subtasks are needed for testing, documentation, or integration with existing task management workflows.",
+			"reasoning": "This task involves creating a new command that leverages AI to generate implementation plans. The existing 4 subtasks cover the main implementation areas (retrieving task content, generating plans with AI, formatting in XML, and error handling). The complexity is moderate as it builds on existing patterns for task updates but requires careful AI integration."
+		},
+		{
+			"taskId": 41,
+			"taskTitle": "Implement Visual Task Dependency Graph in Terminal",
+			"complexityScore": 8,
+			"recommendedSubtasks": 10,
+			"expansionPrompt": "The current 10 subtasks for implementing the visual task dependency graph appear comprehensive. Consider if any additional subtasks are needed for performance optimization with large graphs or additional visualization options.",
+			"reasoning": "This task involves creating a sophisticated visualization system for terminal display, which is inherently complex due to layout algorithms, ASCII/Unicode rendering, and handling complex dependency relationships. The 10 existing subtasks cover all major aspects of implementation, from CLI interface to accessibility features."
+		},
+		{
+			"taskId": 42,
+			"taskTitle": "Implement MCP-to-MCP Communication Protocol",
+			"complexityScore": 9,
+			"recommendedSubtasks": 8,
+			"expansionPrompt": "The current 8 subtasks for implementing the MCP-to-MCP communication protocol appear well-structured. Consider if any additional subtasks are needed for security hardening, performance optimization, or comprehensive documentation.",
+			"reasoning": "This task involves designing and implementing a complex communication protocol between different MCP tools and servers. It requires sophisticated adapter patterns, client-server architecture, and handling of multiple operational modes. The complexity is very high due to the need for standardization, security, and backward compatibility."
+		},
+		{
+			"taskId": 44,
+			"taskTitle": "Implement Task Automation with Webhooks and Event Triggers",
+			"complexityScore": 8,
+			"recommendedSubtasks": 7,
+			"expansionPrompt": "The current 7 subtasks for implementing task automation with webhooks appear comprehensive. Consider if any additional subtasks are needed for security testing, rate limiting implementation, or webhook monitoring tools.",
+			"reasoning": "This task involves creating a sophisticated event system with webhooks for integration with external services. The complexity is high due to the need for secure authentication, reliable delivery mechanisms, and handling of various webhook formats and protocols. The existing subtasks cover the main implementation areas but security and monitoring could be emphasized more."
+		},
+		{
+			"taskId": 45,
+			"taskTitle": "Implement GitHub Issue Import Feature",
+			"complexityScore": 6,
+			"recommendedSubtasks": 5,
+			"expansionPrompt": "The current 5 subtasks for implementing the GitHub issue import feature appear well-structured. Consider if any additional subtasks are needed for handling GitHub API rate limiting, caching, or supporting additional issue metadata.",
+			"reasoning": "This task involves integrating with the GitHub API to import issues as tasks. The complexity is moderate as it requires API authentication, data mapping, and error handling. The existing 5 subtasks cover the main implementation areas from design to end-to-end implementation."
+		},
+		{
+			"taskId": 46,
+			"taskTitle": "Implement ICE Analysis Command for Task Prioritization",
+			"complexityScore": 7,
+			"recommendedSubtasks": 5,
+			"expansionPrompt": "The current 5 subtasks for implementing the ICE analysis command appear comprehensive. Consider if any additional subtasks are needed for visualization of ICE scores or integration with other prioritization methods.",
+			"reasoning": "This task involves creating an AI-powered analysis system for task prioritization using the ICE methodology. The complexity is high due to the need for sophisticated scoring algorithms, AI integration, and report generation. The existing subtasks cover the main implementation areas from algorithm design to integration with existing systems."
+		},
+		{
+			"taskId": 47,
+			"taskTitle": "Enhance Task Suggestion Actions Card Workflow",
+			"complexityScore": 6,
+			"recommendedSubtasks": 6,
+			"expansionPrompt": "The current 6 subtasks for enhancing the task suggestion actions card workflow appear well-structured. Consider if any additional subtasks are needed for user testing, accessibility improvements, or performance optimization.",
+			"reasoning": "This task involves redesigning the UI workflow for task expansion and management. The complexity is moderate as it requires careful UX design and state management but builds on existing components. The 6 existing subtasks cover the main implementation areas from design to testing."
+		},
+		{
+			"taskId": 48,
+			"taskTitle": "Refactor Prompts into Centralized Structure",
+			"complexityScore": 4,
+			"recommendedSubtasks": 3,
+			"expansionPrompt": "The current 3 subtasks for refactoring prompts into a centralized structure appear appropriate. Consider if any additional subtasks are needed for prompt versioning, documentation, or testing.",
+			"reasoning": "This task involves a straightforward refactoring to improve code organization. The complexity is relatively low as it primarily involves moving code rather than creating new functionality. The 3 existing subtasks cover the main implementation areas from directory structure to integration."
+		},
+		{
+			"taskId": 49,
+			"taskTitle": "Implement Code Quality Analysis Command",
+			"complexityScore": 8,
+			"recommendedSubtasks": 6,
+			"expansionPrompt": "The current 6 subtasks for implementing the code quality analysis command appear comprehensive. Consider if any additional subtasks are needed for performance optimization with large codebases or integration with existing code quality tools.",
+			"reasoning": "This task involves creating a sophisticated code analysis system with pattern recognition, best practice verification, and AI-powered recommendations. The complexity is high due to the need for code parsing, complex analysis algorithms, and integration with AI services. The existing subtasks cover the main implementation areas from algorithm design to user interface."
+		},
+		{
+			"taskId": 50,
+			"taskTitle": "Implement Test Coverage Tracking System by Task",
+			"complexityScore": 9,
+			"recommendedSubtasks": 5,
+			"expansionPrompt": "The current 5 subtasks for implementing the test coverage tracking system appear well-structured. Consider if any additional subtasks are needed for integration with CI/CD systems, performance optimization, or visualization tools.",
+			"reasoning": "This task involves creating a complex system that maps test coverage to specific tasks and subtasks. The complexity is very high due to the need for sophisticated data structures, integration with coverage tools, and AI-powered test generation. The existing subtasks are comprehensive and cover the main implementation areas from data structure design to AI integration."
+		},
+		{
+			"taskId": 51,
+			"taskTitle": "Implement Perplexity Research Command",
+			"complexityScore": 6,
+			"recommendedSubtasks": 5,
+			"expansionPrompt": "The current 5 subtasks for implementing the Perplexity research command appear comprehensive. Consider if any additional subtasks are needed for caching optimization, result formatting, or integration with other research tools.",
+			"reasoning": "This task involves creating a new command that integrates with the Perplexity AI API for research. The complexity is moderate as it requires API integration, context extraction, and result formatting. The 5 existing subtasks cover the main implementation areas from API client to caching system."
+		},
+		{
+			"taskId": 52,
+			"taskTitle": "Implement Task Suggestion Command for CLI",
+			"complexityScore": 6,
+			"recommendedSubtasks": 5,
+			"expansionPrompt": "The current 5 subtasks for implementing the task suggestion command appear well-structured. Consider if any additional subtasks are needed for suggestion quality evaluation, user feedback collection, or integration with existing task workflows.",
+			"reasoning": "This task involves creating a new CLI command that generates contextually relevant task suggestions using AI. The complexity is moderate as it requires AI integration, context collection, and interactive CLI interfaces. The existing subtasks cover the main implementation areas from data collection to user interface."
+		},
+		{
+			"taskId": 53,
+			"taskTitle": "Implement Subtask Suggestion Feature for Parent Tasks",
+			"complexityScore": 6,
+			"recommendedSubtasks": 6,
+			"expansionPrompt": "The current 6 subtasks for implementing the subtask suggestion feature appear comprehensive. Consider if any additional subtasks are needed for suggestion quality metrics, user feedback collection, or performance optimization.",
+			"reasoning": "This task involves creating a feature that suggests contextually relevant subtasks for parent tasks. The complexity is moderate as it builds on existing task management systems but requires sophisticated AI integration and context analysis. The 6 existing subtasks cover the main implementation areas from validation to testing."
+		},
+		{
+			"taskId": 55,
+			"taskTitle": "Implement Positional Arguments Support for CLI Commands",
+			"complexityScore": 5,
+			"recommendedSubtasks": 5,
+			"expansionPrompt": "The current 5 subtasks for implementing positional arguments support appear well-structured. Consider if any additional subtasks are needed for backward compatibility testing, documentation updates, or user experience improvements.",
+			"reasoning": "This task involves modifying the command parsing logic to support positional arguments alongside the existing flag-based syntax. The complexity is moderate as it requires careful handling of different argument styles and edge cases. The 5 existing subtasks cover the main implementation areas from analysis to documentation."
+		},
+		{
+			"taskId": 57,
+			"taskTitle": "Enhance Task-Master CLI User Experience and Interface",
+			"complexityScore": 7,
+			"recommendedSubtasks": 6,
+			"expansionPrompt": "The current 6 subtasks for enhancing the CLI user experience appear comprehensive. Consider if any additional subtasks are needed for accessibility testing, internationalization, or performance optimization.",
+			"reasoning": "This task involves a significant overhaul of the CLI interface to improve user experience. The complexity is high due to the breadth of changes (logging, visual elements, interactive components, etc.) and the need for consistent design across all commands. The 6 existing subtasks cover the main implementation areas from log management to help systems."
+		},
+		{
+			"taskId": 60,
+			"taskTitle": "Implement Mentor System with Round-Table Discussion Feature",
+			"complexityScore": 8,
+			"recommendedSubtasks": 7,
+			"expansionPrompt": "The current 7 subtasks for implementing the mentor system appear well-structured. Consider if any additional subtasks are needed for mentor personality consistency, discussion quality evaluation, or performance optimization with multiple mentors.",
+			"reasoning": "This task involves creating a sophisticated mentor simulation system with round-table discussions. The complexity is high due to the need for personality simulation, complex LLM integration, and structured discussion management. The 7 existing subtasks cover the main implementation areas from architecture to testing."
+		},
+		{
+			"taskId": 62,
+			"taskTitle": "Add --simple Flag to Update Commands for Direct Text Input",
+			"complexityScore": 4,
+			"recommendedSubtasks": 8,
+			"expansionPrompt": "The current 8 subtasks for implementing the --simple flag appear comprehensive. Consider if any additional subtasks are needed for user experience testing or documentation updates.",
+			"reasoning": "This task involves adding a simple flag option to bypass AI processing for updates. The complexity is relatively low as it primarily involves modifying existing command handlers and adding a flag. The 8 existing subtasks are very detailed and cover all aspects of implementation from command parsing to testing."
+		},
+		{
+			"taskId": 63,
+			"taskTitle": "Add pnpm Support for the Taskmaster Package",
+			"complexityScore": 5,
+			"recommendedSubtasks": 8,
+			"expansionPrompt": "The current 8 subtasks for adding pnpm support appear comprehensive. Consider if any additional subtasks are needed for CI/CD integration, performance comparison, or documentation updates.",
+			"reasoning": "This task involves ensuring the package works correctly with pnpm as an alternative package manager. The complexity is moderate as it requires careful testing of installation processes and scripts across different environments. The 8 existing subtasks cover all major aspects from documentation to binary verification."
+		},
+		{
+			"taskId": 64,
+			"taskTitle": "Add Yarn Support for Taskmaster Installation",
+			"complexityScore": 5,
+			"recommendedSubtasks": 9,
+			"expansionPrompt": "The current 9 subtasks for adding Yarn support appear comprehensive. Consider if any additional subtasks are needed for performance testing, CI/CD integration, or compatibility with different Yarn versions.",
+			"reasoning": "This task involves ensuring the package works correctly with Yarn as an alternative package manager. The complexity is moderate as it requires careful testing of installation processes and scripts across different environments. The 9 existing subtasks are very detailed and cover all aspects from configuration to testing."
+		},
+		{
+			"taskId": 65,
+			"taskTitle": "Add Bun Support for Taskmaster Installation",
+			"complexityScore": 6,
+			"recommendedSubtasks": 6,
+			"expansionPrompt": "The current 6 subtasks for adding Bun support appear well-structured. Consider if any additional subtasks are needed for handling Bun-specific issues, performance testing, or documentation updates.",
+			"reasoning": "This task involves adding support for the newer Bun package manager. The complexity is slightly higher than the other package manager tasks due to Bun's differences from Node.js and potential compatibility issues. The 6 existing subtasks cover the main implementation areas from research to documentation."
+		},
+		{
+			"taskId": 67,
+			"taskTitle": "Add CLI JSON output and Cursor keybindings integration",
+			"complexityScore": 5,
+			"recommendedSubtasks": 5,
+			"expansionPrompt": "The current 5 subtasks for implementing JSON output and Cursor keybindings appear well-structured. Consider if any additional subtasks are needed for testing across different operating systems, documentation updates, or user experience improvements.",
+			"reasoning": "This task involves two distinct features: adding JSON output to CLI commands and creating a keybindings installation command. The complexity is moderate as it requires careful handling of different output formats and OS-specific file paths. The 5 existing subtasks cover the main implementation areas for both features."
+		},
+		{
+			"taskId": 68,
+			"taskTitle": "Ability to create tasks without parsing PRD",
+			"complexityScore": 3,
+			"recommendedSubtasks": 2,
+			"expansionPrompt": "The current 2 subtasks for implementing task creation without PRD appear appropriate. Consider if any additional subtasks are needed for validation, error handling, or integration with existing task management workflows.",
+			"reasoning": "This task involves a relatively simple modification to allow task creation without requiring a PRD document. The complexity is low as it primarily involves creating a form interface and saving functionality. The 2 existing subtasks cover the main implementation areas of UI design and data saving."
+		},
+		{
+			"taskId": 72,
+			"taskTitle": "Implement PDF Generation for Project Progress and Dependency Overview",
+			"complexityScore": 7,
+			"recommendedSubtasks": 6,
+			"expansionPrompt": "The current 6 subtasks for implementing PDF generation appear comprehensive. Consider if any additional subtasks are needed for handling large projects, additional visualization options, or integration with existing reporting tools.",
+			"reasoning": "This task involves creating a feature to generate PDF reports of project progress and dependency visualization. The complexity is high due to the need for PDF generation, data collection, and visualization integration. The 6 existing subtasks cover the main implementation areas from library selection to export options."
+		},
+		{
+			"taskId": 75,
+			"taskTitle": "Integrate Google Search Grounding for Research Role",
+			"complexityScore": 5,
+			"recommendedSubtasks": 4,
+			"expansionPrompt": "The current 4 subtasks for integrating Google Search Grounding appear well-structured. Consider if any additional subtasks are needed for testing with different query types, error handling, or performance optimization.",
+			"reasoning": "This task involves updating the AI service layer to enable Google Search Grounding for research roles. The complexity is moderate as it requires careful integration with the existing AI service architecture and conditional logic. The 4 existing subtasks cover the main implementation areas from service layer modification to testing."
+		},
+		{
+			"taskId": 76,
+			"taskTitle": "Develop E2E Test Framework for Taskmaster MCP Server (FastMCP over stdio)",
+			"complexityScore": 8,
+			"recommendedSubtasks": 7,
+			"expansionPrompt": "The current 7 subtasks for developing the E2E test framework appear comprehensive. Consider if any additional subtasks are needed for test result reporting, CI/CD integration, or performance benchmarking.",
+			"reasoning": "This task involves creating a sophisticated end-to-end testing framework for the MCP server. The complexity is high due to the need for subprocess management, protocol handling, and robust test case definition. The 7 existing subtasks cover the main implementation areas from architecture to documentation."
+		},
+		{
+			"taskId": 77,
+			"taskTitle": "Implement AI Usage Telemetry for Taskmaster (with external analytics endpoint)",
+			"complexityScore": 7,
+			"recommendedSubtasks": 18,
+			"expansionPrompt": "The current 18 subtasks for implementing AI usage telemetry appear very comprehensive. Consider if any additional subtasks are needed for security hardening, privacy compliance, or user feedback collection.",
+			"reasoning": "This task involves creating a telemetry system to track AI usage metrics. The complexity is high due to the need for secure data transmission, comprehensive data collection, and integration across multiple commands. The 18 existing subtasks are extremely detailed and cover all aspects of implementation from core utility to provider-specific updates."
+		},
+		{
+			"taskId": 80,
+			"taskTitle": "Implement Unique User ID Generation and Storage During Installation",
+			"complexityScore": 4,
+			"recommendedSubtasks": 5,
+			"expansionPrompt": "The current 5 subtasks for implementing unique user ID generation appear well-structured. Consider if any additional subtasks are needed for privacy compliance, security auditing, or integration with the telemetry system.",
+			"reasoning": "This task involves generating and storing a unique user identifier during installation. The complexity is relatively low as it primarily involves UUID generation and configuration file management. The 5 existing subtasks cover the main implementation areas from script structure to documentation."
+		},
+		{
+			"taskId": 81,
+			"taskTitle": "Task #81: Implement Comprehensive Local Telemetry System with Future Server Integration Capability",
+			"complexityScore": 8,
+			"recommendedSubtasks": 6,
+			"expansionPrompt": "The current 6 subtasks for implementing the comprehensive local telemetry system appear well-structured. Consider if any additional subtasks are needed for data migration, storage optimization, or visualization tools.",
+			"reasoning": "This task involves expanding the telemetry system to capture additional metrics and implement local storage with future server integration capability. The complexity is high due to the breadth of data collection, storage requirements, and privacy considerations. The 6 existing subtasks cover the main implementation areas from data collection to user-facing benefits."
+		},
+		{
+			"taskId": 82,
+			"taskTitle": "Update supported-models.json with token limit fields",
+			"complexityScore": 3,
+			"recommendedSubtasks": 1,
+			"expansionPrompt": "This task appears straightforward enough to be implemented without further subtasks. Focus on researching accurate token limit values for each model and ensuring backward compatibility.",
+			"reasoning": "This task involves a simple update to the supported-models.json file to include new token limit fields. The complexity is low as it primarily involves research and data entry. No subtasks are necessary as the task is well-defined and focused."
+		},
+		{
+			"taskId": 83,
+			"taskTitle": "Update config-manager.js defaults and getters",
+			"complexityScore": 4,
+			"recommendedSubtasks": 1,
+			"expansionPrompt": "This task appears straightforward enough to be implemented without further subtasks. Focus on updating the DEFAULTS object and related getter functions while maintaining backward compatibility.",
+			"reasoning": "This task involves updating the config-manager.js module to replace maxTokens with more specific token limit fields. The complexity is relatively low as it primarily involves modifying existing code rather than creating new functionality. No subtasks are necessary as the task is well-defined and focused."
+		},
+		{
+			"taskId": 84,
+			"taskTitle": "Implement token counting utility",
+			"complexityScore": 5,
+			"recommendedSubtasks": 1,
+			"expansionPrompt": "This task appears well-defined enough to be implemented without further subtasks. Focus on implementing accurate token counting for different models and proper fallback mechanisms.",
+			"reasoning": "This task involves creating a utility function to count tokens for different AI models. The complexity is moderate as it requires integration with the tiktoken library and handling different tokenization schemes. No subtasks are necessary as the task is well-defined and focused."
+		},
+		{
+			"taskId": 69,
+			"taskTitle": "Enhance Analyze Complexity for Specific Task IDs",
+			"complexityScore": 7,
+			"recommendedSubtasks": 6,
+			"expansionPrompt": "Break down the task 'Enhance Analyze Complexity for Specific Task IDs' into 6 subtasks focusing on: 1) Core logic modification to accept ID parameters, 2) Report merging functionality, 3) CLI interface updates, 4) MCP tool integration, 5) Documentation updates, and 6) Comprehensive testing across all components.",
+			"reasoning": "This task involves modifying existing functionality across multiple components (core logic, CLI, MCP) with complex logic for filtering tasks and merging reports. The implementation requires careful handling of different parameter combinations and edge cases. The task has interdependent components that need to work together seamlessly, and the report merging functionality adds significant complexity."
+		},
+		{
+			"taskId": 70,
+			"taskTitle": "Implement 'diagram' command for Mermaid diagram generation",
+			"complexityScore": 6,
+			"recommendedSubtasks": 5,
+			"expansionPrompt": "Break down the 'diagram' command implementation into 5 subtasks: 1) Command interface and parameter handling, 2) Task data extraction and transformation to Mermaid syntax, 3) Diagram rendering with status color coding, 4) Output formatting and file export functionality, and 5) Error handling and edge case management.",
+			"reasoning": "This task requires implementing a new feature rather than modifying existing code, which reduces complexity from integration challenges. However, it involves working with visualization logic, dependency mapping, and multiple output formats. The color coding based on status and handling of dependency relationships adds moderate complexity. The task is well-defined but requires careful attention to diagram formatting and error handling."
+		},
+		{
+			"taskId": 85,
+			"taskTitle": "Update ai-services-unified.js for dynamic token limits",
+			"complexityScore": 7,
+			"recommendedSubtasks": 5,
+			"expansionPrompt": "Break down the update of ai-services-unified.js for dynamic token limits into subtasks such as: (1) Import and integrate the token counting utility, (2) Refactor _unifiedServiceRunner to calculate and enforce dynamic token limits, (3) Update error handling for token limit violations, (4) Add and verify logging for token usage, (5) Write and execute tests for various prompt and model scenarios.",
+			"reasoning": "This task involves significant code changes to a core function, integration of a new utility, dynamic logic for multiple models, and robust error handling. It also requires comprehensive testing for edge cases and integration, making it moderately complex and best managed by splitting into focused subtasks."
+		},
+		{
+			"taskId": 86,
+			"taskTitle": "Update .taskmasterconfig schema and user guide",
+			"complexityScore": 6,
+			"recommendedSubtasks": 4,
+			"expansionPrompt": "Expand this task into subtasks: (1) Draft a migration guide for users, (2) Update user documentation to explain new config fields, (3) Modify schema validation logic in config-manager.js, (4) Test and validate backward compatibility and error messaging.",
+			"reasoning": "The task spans documentation, schema changes, migration guidance, and validation logic. While not algorithmically complex, it requires careful coordination and thorough testing to ensure a smooth user transition and robust validation."
+		},
+		{
+			"taskId": 87,
+			"taskTitle": "Implement validation and error handling",
+			"complexityScore": 5,
+			"recommendedSubtasks": 4,
+			"expansionPrompt": "Decompose this task into: (1) Add validation logic for model and config loading, (2) Implement error handling and fallback mechanisms, (3) Enhance logging and reporting for token usage, (4) Develop helper functions for configuration suggestions and improvements.",
+			"reasoning": "This task is primarily about adding validation, error handling, and logging. While important for robustness, the logic is straightforward and can be modularized into a few clear subtasks."
+		},
+		{
+			"taskId": 89,
+			"taskTitle": "Introduce Prioritize Command with Enhanced Priority Levels",
+			"complexityScore": 6,
+			"recommendedSubtasks": 5,
+			"expansionPrompt": "Expand this task into: (1) Implement the prioritize command with all required flags and shorthands, (2) Update CLI output and help documentation for new priority levels, (3) Ensure backward compatibility with existing commands, (4) Add error handling for invalid inputs, (5) Write and run tests for all command scenarios.",
+			"reasoning": "This CLI feature requires command parsing, updating internal logic for new priority levels, documentation, and robust error handling. The complexity is moderate due to the need for backward compatibility and comprehensive testing."
+		},
+		{
+			"taskId": 90,
+			"taskTitle": "Implement Subtask Progress Analyzer and Reporting System",
+			"complexityScore": 8,
+			"recommendedSubtasks": 6,
+			"expansionPrompt": "Break down the analyzer implementation into: (1) Design and implement progress tracking logic, (2) Develop status validation and issue detection, (3) Build the reporting system with multiple output formats, (4) Integrate analyzer with the existing task management system, (5) Optimize for performance and scalability, (6) Write unit, integration, and performance tests.",
+			"reasoning": "This is a complex, multi-faceted feature involving data analysis, reporting, integration, and performance optimization. It touches many parts of the system and requires careful design, making it one of the most complex tasks in the list."
+		},
+		{
+			"taskId": 91,
+			"taskTitle": "Implement Move Command for Tasks and Subtasks",
+			"complexityScore": 7,
+			"recommendedSubtasks": 5,
+			"expansionPrompt": "Expand this task into: (1) Implement move logic for tasks and subtasks, (2) Handle edge cases (invalid ids, non-existent parents, circular dependencies), (3) Update CLI to support move command with flags, (4) Ensure data integrity and update relationships, (5) Write and execute tests for various move scenarios.",
+			"reasoning": "Moving tasks and subtasks requires careful handling of hierarchical data, edge cases, and data integrity. The command must be robust and user-friendly, necessitating multiple focused subtasks for safe implementation."
+		}
+	]
+}

.taskmaster/tasks/task_045.txt

@@ -0,0 +1,87 @@
+# Task ID: 45
+# Title: Implement GitHub Issue Import Feature
+# Status: pending
+# Dependencies: None
+# Priority: medium
+# Description: Add a '--from-github' flag to the add-task command that accepts a GitHub issue URL and automatically generates a corresponding task with relevant details.
+# Details:
+Implement a new flag '--from-github' for the add-task command that allows users to create tasks directly from GitHub issues. The implementation should:
+
+1. Accept a GitHub issue URL as an argument (e.g., 'taskmaster add-task --from-github https://github.com/owner/repo/issues/123')
+2. Parse the URL to extract the repository owner, name, and issue number
+3. Use the GitHub API to fetch the issue details including:
+   - Issue title (to be used as task title)
+   - Issue description (to be used as task description)
+   - Issue labels (to be potentially used as tags)
+   - Issue assignees (for reference)
+   - Issue status (open/closed)
+4. Generate a well-formatted task with this information
+5. Include a reference link back to the original GitHub issue
+6. Handle authentication for private repositories using GitHub tokens from environment variables or config file
+7. Implement proper error handling for:
+   - Invalid URLs
+   - Non-existent issues
+   - API rate limiting
+   - Authentication failures
+   - Network issues
+8. Allow users to override or supplement the imported details with additional command-line arguments
+9. Add appropriate documentation in help text and user guide
+
+# Test Strategy:
+Testing should cover the following scenarios:
+
+1. Unit tests:
+   - Test URL parsing functionality with valid and invalid GitHub issue URLs
+   - Test GitHub API response parsing with mocked API responses
+   - Test error handling for various failure cases
+
+2. Integration tests:
+   - Test with real GitHub public issues (use well-known repositories)
+   - Test with both open and closed issues
+   - Test with issues containing various elements (labels, assignees, comments)
+
+3. Error case tests:
+   - Invalid URL format
+   - Non-existent repository
+   - Non-existent issue number
+   - API rate limit exceeded
+   - Authentication failures for private repos
+
+4. End-to-end tests:
+   - Verify that a task created from a GitHub issue contains all expected information
+   - Verify that the task can be properly managed after creation
+   - Test the interaction with other flags and commands
+
+Create mock GitHub API responses for testing to avoid hitting rate limits during development and testing. Use environment variables to configure test credentials if needed.
+
+# Subtasks:
+## 1. Design GitHub API integration architecture [pending]
+### Dependencies: None
+### Description: Create a technical design document outlining the architecture for GitHub API integration, including authentication flow, rate limiting considerations, and error handling strategies.
+### Details:
+Document should include: API endpoints to be used, authentication method (OAuth vs Personal Access Token), data flow diagrams, and security considerations. Research GitHub API rate limits and implement appropriate throttling mechanisms.
+
+## 2. Implement GitHub URL parsing and validation [pending]
+### Dependencies: 45.1
+### Description: Create a module to parse and validate GitHub issue URLs, extracting repository owner, repository name, and issue number.
+### Details:
+Handle various GitHub URL formats (e.g., github.com/owner/repo/issues/123, github.com/owner/repo/pull/123). Implement validation to ensure the URL points to a valid issue or pull request. Return structured data with owner, repo, and issue number for valid URLs.
+
+## 3. Develop GitHub API client for issue fetching [pending]
+### Dependencies: 45.1, 45.2
+### Description: Create a service to authenticate with GitHub and fetch issue details using the GitHub REST API.
+### Details:
+Implement authentication using GitHub Personal Access Tokens or OAuth. Handle API responses, including error cases (rate limiting, authentication failures, not found). Extract relevant issue data: title, description, labels, assignees, and comments.
+
+## 4. Create task formatter for GitHub issues [pending]
+### Dependencies: 45.3
+### Description: Develop a formatter to convert GitHub issue data into the application's task format.
+### Details:
+Map GitHub issue fields to task fields (title, description, etc.). Convert GitHub markdown to the application's supported format. Handle special GitHub features like issue references and user mentions. Generate appropriate tags based on GitHub labels.
+
+## 5. Implement end-to-end import flow with UI [pending]
+### Dependencies: 45.4
+### Description: Create the user interface and workflow for importing GitHub issues, including progress indicators and error handling.
+### Details:
+Design and implement UI for URL input and import confirmation. Show loading states during API calls. Display meaningful error messages for various failure scenarios. Allow users to review and modify imported task details before saving. Add automated tests for the entire import flow.
+

.taskmaster/tasks/task_051.txt

@@ -1,11 +1,11 @@
 # Task ID: 51
-# Title: Implement Interactive 'Explore' Command REPL
+# Title: Implement Perplexity Research Command
 # Status: pending
 # Dependencies: None
 # Priority: medium
-# Description: Create an interactive 'explore' command that launches a REPL-style chat interface for AI-powered research and project exploration with conversation context and session management.
+# Description: Create an interactive REPL-style chat interface for AI-powered research that maintains conversation context, integrates project information, and provides session management capabilities.
 # Details:
-Develop an interactive 'explore' command that provides a REPL-style chat interface for AI-powered research and project exploration. The system should:
+Develop an interactive REPL-style chat interface for AI-powered research that allows users to have ongoing research conversations with context awareness. The system should:
 
 1. Create an interactive REPL using inquirer that:
    - Maintains conversation history and context
@@ -31,7 +31,6 @@ Develop an interactive 'explore' command that provides a REPL-style chat interfa
    - `/copy` - Copy last response to clipboard
    - `/summary` - Generate summary of conversation
    - `/detail` - Adjust research depth level
-   - `/context` - Show current context information
 
 5. Create session management capabilities:
    - Generate and track unique session IDs
@@ -45,19 +44,13 @@ Develop an interactive 'explore' command that provides a REPL-style chat interfa
    - Progressive display of AI responses
    - Clear visual hierarchy and readability
 
-7. Command specification:
-   - Command name: `task-master explore` or `tm explore`
-   - Accept optional parameters: --tasks, --files, --session
-   - Generate project file tree for system context
-   - Launch interactive REPL session
-
-8. Follow the "taskmaster way":
+7. Follow the "taskmaster way":
    - Create something new and exciting
    - Focus on usefulness and practicality
    - Avoid over-engineering
    - Maintain consistency with existing patterns
 
-The explore command should feel like a natural conversation while providing powerful research capabilities that integrate seamlessly with the rest of the system.
+The REPL should feel like a natural conversation while providing powerful research capabilities that integrate seamlessly with the rest of the system.
 
 # Test Strategy:
 1. Unit tests:
@@ -73,7 +66,7 @@ The explore command should feel like a natural conversation while providing powe
    - Verify context switching between different tasks and files
 
 3. User acceptance testing:
-   - Have team members use the explore command for real research needs
+   - Have team members use the REPL for real research needs
    - Test the conversation flow and command usability
    - Verify the UI is intuitive and responsive
    - Test with various terminal sizes and environments
@@ -90,7 +83,6 @@ The explore command should feel like a natural conversation while providing powe
    - Verify export features create properly formatted files
    - Test session recovery from simulated crashes
    - Validate handling of special characters and unicode
-   - Test command line parameter parsing for --tasks, --files, --session
 
 # Subtasks:
 ## 1. Create Perplexity API Client Service [cancelled]
@@ -170,30 +162,31 @@ REFACTORED IMPLEMENTATION:
 This approach leverages our existing sophisticated search logic rather than rebuilding from scratch, while making it more flexible and reusable across the application.
 </info added on 2025-05-23T21:11:44.560Z>
 
-## 3. Build Explore Command CLI Interface [pending]
-### Dependencies: 51.2
-### Description: Implement the Commander.js command structure for the 'explore' command with all required options and parameters to launch the interactive REPL.
+## 3. Build Research Command CLI Interface [pending]
+### Dependencies: 51.1, 51.2
+### Description: Implement the Commander.js command structure for the 'research' command with all required options and parameters.
 ### Details:
 Implementation details:
-1. Create a new command file `commands/explore.js`
+1. Create a new command file `commands/research.js`
 2. Set up the Commander.js command structure with the following options:
-   - `--tasks` or `-t` option for task/subtask IDs (comma-separated)
-   - `--files` or `-f` option for file paths (comma-separated)
-   - `--session` or `-s` option to resume a previous session
-   - `--context` or `-c` option for custom initial context
-3. Implement command validation logic for parameters
-4. Create entry point that launches the interactive REPL
-5. Integrate context initialization from command line parameters
+   - Required search query parameter
+   - `--task` or `-t` option for task/subtask ID
+   - `--prompt` or `-p` option for custom research prompt
+   - `--save` or `-s` option to save results to a file
+   - `--copy` or `-c` option to copy results to clipboard
+   - `--summary` or `-m` option to generate a summary
+   - `--detail` or `-d` option to set research depth (default: medium)
+3. Implement command validation logic
+4. Connect the command to the Perplexity service created in subtask 1
+5. Integrate the context extraction logic from subtask 2
 6. Register the command in the main CLI application
-7. Add help text and usage examples
-8. Implement parameter parsing for task IDs and file paths
+7. Add help text and examples
 
 Testing approach:
 - Test command registration and option parsing
 - Verify command validation logic works correctly
 - Test with various combinations of options
 - Ensure proper error messages for invalid inputs
-- Test parameter parsing for complex task ID formats
 <info added on 2025-05-23T21:09:08.478Z>
 Implementation details:
 1. Create a new module `repl/research-chat.js` for the interactive research experience
@@ -229,45 +222,30 @@ Testing approach:
 - Validate UI consistency across different terminal environments
 </info added on 2025-05-23T21:09:08.478Z>
 
-## 4. Implement Chat Formatting and Display System [pending]
-### Dependencies: 51.3
-### Description: Create functionality to format and display conversational research interactions in the terminal with streaming responses and markdown support.
+## 4. Implement Results Processing and Output Formatting [pending]
+### Dependencies: 51.1, 51.3
+### Description: Create functionality to process, format, and display research results in the terminal with options for saving, copying, and summarizing.
 ### Details:
 Implementation details:
-1. Create a new module `utils/chatFormatter.js` for REPL interface formatting
-2. Implement terminal output formatting for conversational display:
-   - Color-coded messages distinguishing user inputs and AI responses
-   - Proper text wrapping and indentation for readability
-   - Support for markdown rendering in terminal
-   - Visual indicators for system messages and status updates
-3. Implement streaming/progressive display of AI responses:
-   - Character-by-character or chunk-by-chunk display
-   - Cursor animations during response generation
-   - Ability to interrupt long responses
-4. Design chat history visualization:
-   - Scrollable history with clear message boundaries
-   - Timestamp display options
-   - Session identification
-5. Create specialized formatters for different content types:
-   - Code blocks with syntax highlighting
-   - Bulleted and numbered lists
-   - Tables and structured data
-   - Citations and references
-6. Implement export functionality:
-   - Save conversations to markdown or text files
-   - Export individual responses
-   - Copy responses to clipboard
-7. Adapt existing ui.js patterns for conversational context:
-   - Maintain consistent styling while supporting chat flow
-   - Handle multi-turn context appropriately
+1. Create a new module `utils/researchFormatter.js`
+2. Implement terminal output formatting with:
+   - Color-coded sections for better readability
+   - Proper text wrapping for terminal width
+   - Highlighting of key points
+3. Add functionality to save results to a file:
+   - Create a `research-results` directory if it doesn't exist
+   - Save results with timestamp and query in filename
+   - Support multiple formats (text, markdown, JSON)
+4. Implement clipboard copying using a library like `clipboardy`
+5. Create a summarization function that extracts key points from research results
+6. Add progress indicators during API calls
+7. Implement pagination for long results
 
 Testing approach:
-- Test streaming display with various response lengths and speeds
-- Verify markdown rendering accuracy for complex formatting
-- Test history navigation and scrolling functionality
-- Verify export features create properly formatted files
-- Test display on various terminal sizes and configurations
-- Verify handling of special characters and unicode
+- Test output formatting with various result lengths and content types
+- Verify file saving functionality creates proper files with correct content
+- Test clipboard functionality
+- Verify summarization produces useful results
 <info added on 2025-05-23T21:10:00.181Z>
 Implementation details:
 1. Create a new module `utils/chatFormatter.js` for REPL interface formatting
@@ -405,7 +383,7 @@ Testing approach:
 
 ## 7. Create REPL Command System [pending]
 ### Dependencies: 51.3
-### Description: Implement a flexible command system for the explore REPL that allows users to control the conversation flow, manage sessions, and access additional functionality.
+### Description: Implement a flexible command system for the research REPL that allows users to control the conversation flow, manage sessions, and access additional functionality.
 ### Details:
 Implementation details:
 1. Create a new module `repl/commands.js` for REPL command handling
@@ -429,7 +407,6 @@ Implementation details:
    - `/clear` - Clear conversation
    - `/project` - Refresh project context
    - `/session <id|new>` - Switch/create session
-   - `/context` - Show current context information
 5. Add command completion and suggestions
 6. Implement error handling for invalid commands
 7. Create a help system with examples
@@ -443,23 +420,22 @@ Testing approach:
 
 ## 8. Integrate with AI Services Unified [pending]
 ### Dependencies: 51.3, 51.4
-### Description: Integrate the explore REPL with the existing ai-services-unified.js to leverage the unified AI service architecture with research mode.
+### Description: Integrate the research REPL with the existing ai-services-unified.js to leverage the unified AI service architecture with research mode.
 ### Details:
 Implementation details:
 1. Update `repl/research-chat.js` to integrate with ai-services-unified.js
 2. Configure research mode in AI service:
-   - Set appropriate system prompts for exploration and research
+   - Set appropriate system prompts
    - Configure temperature and other parameters
    - Enable streaming responses
 3. Implement context management:
    - Format conversation history for AI context
    - Include task and project context
    - Handle context window limitations
-4. Add support for different exploration styles:
+4. Add support for different research styles:
    - Exploratory research with broader context
    - Focused research with specific questions
    - Comparative analysis between concepts
-   - Code exploration and analysis
 5. Implement response handling:
    - Process streaming chunks
    - Format and display responses
@@ -472,44 +448,5 @@ Testing approach:
 - Verify context formatting and management
 - Test streaming response handling
 - Verify error handling and recovery
-- Test with various exploration styles and queries
-
-## 9. Implement Session Management System [pending]
-### Dependencies: 51.4, 51.7
-### Description: Create a comprehensive session management system for the explore REPL that handles session persistence, recovery, and switching between multiple exploration sessions.
-### Details:
-Implementation details:
-1. Create a session management system for the explore REPL:
-   - Generate and track unique session IDs
-   - Store conversation history with timestamps
-   - Maintain context and state between interactions
-2. Implement session persistence:
-   - Save sessions to disk automatically
-   - Load previous sessions on startup
-   - Handle graceful recovery from crashes
-3. Build session browser and selector:
-   - List available sessions with preview
-   - Filter sessions by date, topic, or content
-   - Enable quick switching between sessions
-4. Implement conversation state serialization:
-   - Capture full conversation context
-   - Preserve user preferences per session
-   - Handle state migration during updates
-5. Add session sharing capabilities:
-   - Export sessions to portable formats
-   - Import sessions from files
-   - Generate shareable session summaries
-6. Create session management commands:
-   - Create new sessions
-   - Clone existing sessions
-   - Archive or delete old sessions
-7. Integrate with command line --session parameter
-
-Testing approach:
-- Verify session persistence across application restarts
-- Test session recovery from simulated crashes
-- Validate state serialization with complex conversations
-- Ensure session switching maintains proper context
-- Test session import/export functionality
-- Verify performance with large conversation histories
+- Test with various research styles and queries