fix: switch to ESM export to avoid mixed format

The CLI entrypoint was using `module.exports` alongside ESM `import` statements,
resulting in an invalid mixed module format. Replaced the CommonJS export with
a proper ESM `export` to maintain consistency and prevent module resolution issues.

.changeset/hungry-geese-work.md

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

.changeset/itchy-taxes-sip.md

@@ -0,0 +1,13 @@
+---
+'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

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

.changeset/new-colts-flow.md

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

.changeset/plain-bottles-stand.md

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

.changeset/pre.json

@@ -0,0 +1,18 @@
+{
+  "mode": "exit",
+  "tag": "rc",
+  "initialVersions": {
+    "task-master-ai": "0.15.0"
+  },
+  "changesets": [
+    "hungry-geese-work",
+    "itchy-taxes-sip",
+    "lemon-apes-sort",
+    "new-colts-flow",
+    "plain-bottles-stand",
+    "shaggy-rice-exist",
+    "sharp-flies-call",
+    "spotty-buttons-walk",
+    "tidy-seals-rule"
+  ]
+}

.changeset/shaggy-rice-exist.md

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

.changeset/sharp-flies-call.md

@@ -0,0 +1,7 @@
+---
+'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/spotty-buttons-walk.md

@@ -0,0 +1,31 @@
+---
+"task-master-ai": minor
+---
+
+Consolidate Task Master files into unified .taskmaster directory structure
+
+This release introduces a new consolidated directory structure that organizes all Task Master files under a single `.taskmaster/` directory for better project organization and cleaner workspace management.
+
+**New Directory Structure:**
+
+- `.taskmaster/tasks/` - Task files (previously `tasks/`)
+- `.taskmaster/docs/` - Documentation including PRD files (previously `scripts/`)
+- `.taskmaster/reports/` - Complexity analysis reports (previously `scripts/`)
+- `.taskmaster/templates/` - Template files like example PRD
+- `.taskmaster/config.json` - Configuration (previously `.taskmasterconfig`)
+
+**Migration & Backward Compatibility:**
+
+- Existing projects continue to work with legacy file locations
+- New projects use the consolidated structure automatically
+- Run `task-master migrate` to move existing projects to the new structure
+- All CLI commands and MCP tools automatically detect and use appropriate file locations
+
+**Benefits:**
+
+- Cleaner project root with Task Master files organized in one location
+- Reduced file scatter across multiple directories
+- Improved project navigation and maintenance
+- Consistent file organization across all Task Master projects
+
+This change maintains full backward compatibility while providing a migration path to the improved structure.

.changeset/tidy-seals-rule.md

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

.cursor/rules/taskmaster.mdc

@@ -45,7 +45,7 @@ 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 '.taskmaster/tasks/tasks.json'.` (CLI: `-o, --output <file>`)
+    *   `output`: `Specify where Taskmaster should save the generated 'tasks.json' file. Defaults to '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.

.taskmaster/config.json

@@ -26,7 +26,6 @@
 		"defaultPriority": "medium",
 		"projectName": "Taskmaster",
 		"ollamaBaseURL": "http://localhost:11434/api",
-		"bedrockBaseURL": "https://bedrock.us-east-1.amazonaws.com",
 		"userId": "1234567890",
 		"azureBaseURL": "https://your-endpoint.azure.com/"
 	}

.taskmasterconfig

@@ -0,0 +1,32 @@
+{
+	"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": {
+		"logLevel": "info",
+		"debug": false,
+		"defaultSubtasks": 5,
+		"defaultPriority": "medium",
+		"projectName": "Taskmaster",
+		"ollamaBaseURL": "http://localhost:11434/api",
+		"userId": "1234567890",
+		"azureBaseURL": "https://your-endpoint.azure.com/"
+	}
+}

CHANGELOG.md

@@ -1,79 +1,5 @@
 # task-master-ai
 
-## 0.16.1
-
-### Patch Changes
-
-- [#641](https://github.com/eyaltoledano/claude-task-master/pull/641) [`ad61276`](https://github.com/eyaltoledano/claude-task-master/commit/ad612763ffbdd35aa1b593c9613edc1dc27a8856) Thanks [@Crunchyman-ralph](https://github.com/Crunchyman-ralph)! - Fix bedrock issues
-
-- [#648](https://github.com/eyaltoledano/claude-task-master/pull/648) [`9b4168b`](https://github.com/eyaltoledano/claude-task-master/commit/9b4168bb4e4dfc2f4fb0cf6bd5f81a8565879176) Thanks [@Crunchyman-ralph](https://github.com/Crunchyman-ralph)! - Fix MCP tool calls logging errors
-
-- [#641](https://github.com/eyaltoledano/claude-task-master/pull/641) [`ad61276`](https://github.com/eyaltoledano/claude-task-master/commit/ad612763ffbdd35aa1b593c9613edc1dc27a8856) Thanks [@Crunchyman-ralph](https://github.com/Crunchyman-ralph)! - Update rules for new directory structure
-
-- [#648](https://github.com/eyaltoledano/claude-task-master/pull/648) [`9b4168b`](https://github.com/eyaltoledano/claude-task-master/commit/9b4168bb4e4dfc2f4fb0cf6bd5f81a8565879176) Thanks [@Crunchyman-ralph](https://github.com/Crunchyman-ralph)! - Fix bug in expand_all mcp tool
-
-- [#641](https://github.com/eyaltoledano/claude-task-master/pull/641) [`ad61276`](https://github.com/eyaltoledano/claude-task-master/commit/ad612763ffbdd35aa1b593c9613edc1dc27a8856) Thanks [@Crunchyman-ralph](https://github.com/Crunchyman-ralph)! - Fix MCP crashing after certain commands due to console logs
-
-## 0.16.0
-
-### Minor Changes
-
-- [#607](https://github.com/eyaltoledano/claude-task-master/pull/607) [`6a8a68e`](https://github.com/eyaltoledano/claude-task-master/commit/6a8a68e1a3f34dcdf40b355b4602a08d291f8e38) Thanks [@Crunchyman-ralph](https://github.com/Crunchyman-ralph)! - Add AWS bedrock support
-
-- [#607](https://github.com/eyaltoledano/claude-task-master/pull/607) [`6a8a68e`](https://github.com/eyaltoledano/claude-task-master/commit/6a8a68e1a3f34dcdf40b355b4602a08d291f8e38) Thanks [@Crunchyman-ralph](https://github.com/Crunchyman-ralph)! - # 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
-
-- [#607](https://github.com/eyaltoledano/claude-task-master/pull/607) [`6a8a68e`](https://github.com/eyaltoledano/claude-task-master/commit/6a8a68e1a3f34dcdf40b355b4602a08d291f8e38) Thanks [@Crunchyman-ralph](https://github.com/Crunchyman-ralph)! - Add support for Azure
-
-- [#612](https://github.com/eyaltoledano/claude-task-master/pull/612) [`669b744`](https://github.com/eyaltoledano/claude-task-master/commit/669b744ced454116a7b29de6c58b4b8da977186a) Thanks [@Crunchyman-ralph](https://github.com/Crunchyman-ralph)! - Increased minimum required node version to > 18 (was > 14)
-
-- [#607](https://github.com/eyaltoledano/claude-task-master/pull/607) [`6a8a68e`](https://github.com/eyaltoledano/claude-task-master/commit/6a8a68e1a3f34dcdf40b355b4602a08d291f8e38) Thanks [@Crunchyman-ralph](https://github.com/Crunchyman-ralph)! - Renamed baseUrl to baseURL
-
-- [#604](https://github.com/eyaltoledano/claude-task-master/pull/604) [`80735f9`](https://github.com/eyaltoledano/claude-task-master/commit/80735f9e60c7dda7207e169697f8ac07b6733634) Thanks [@Crunchyman-ralph](https://github.com/Crunchyman-ralph)! - 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.
-
-- [#619](https://github.com/eyaltoledano/claude-task-master/pull/619) [`3f64202`](https://github.com/eyaltoledano/claude-task-master/commit/3f64202c9feef83f2bf383c79e4367d337c37e20) Thanks [@Crunchyman-ralph](https://github.com/Crunchyman-ralph)! - Consolidate Task Master files into unified .taskmaster directory structure
-
-  This release introduces a new consolidated directory structure that organizes all Task Master files under a single `.taskmaster/` directory for better project organization and cleaner workspace management.
-
-  **New Directory Structure:**
-
-  - `.taskmaster/tasks/` - Task files (previously `tasks/`)
-  - `.taskmaster/docs/` - Documentation including PRD files (previously `scripts/`)
-  - `.taskmaster/reports/` - Complexity analysis reports (previously `scripts/`)
-  - `.taskmaster/templates/` - Template files like example PRD
-  - `.taskmaster/config.json` - Configuration (previously `.taskmasterconfig`)
-
-  **Migration & Backward Compatibility:**
-
-  - Existing projects continue to work with legacy file locations
-  - New projects use the consolidated structure automatically
-  - Run `task-master migrate` to move existing projects to the new structure
-  - All CLI commands and MCP tools automatically detect and use appropriate file locations
-
-  **Benefits:**
-
-  - Cleaner project root with Task Master files organized in one location
-  - Reduced file scatter across multiple directories
-  - Improved project navigation and maintenance
-  - Consistent file organization across all Task Master projects
-
-  This change maintains full backward compatibility while providing a migration path to the improved structure.
-
-### Patch Changes
-
-- [#607](https://github.com/eyaltoledano/claude-task-master/pull/607) [`6a8a68e`](https://github.com/eyaltoledano/claude-task-master/commit/6a8a68e1a3f34dcdf40b355b4602a08d291f8e38) Thanks [@Crunchyman-ralph](https://github.com/Crunchyman-ralph)! - Fix max_tokens error when trying to use claude-sonnet-4 and claude-opus-4
-
-- [#625](https://github.com/eyaltoledano/claude-task-master/pull/625) [`2d520de`](https://github.com/eyaltoledano/claude-task-master/commit/2d520de2694da3efe537b475ca52baf3c869edda) Thanks [@Crunchyman-ralph](https://github.com/Crunchyman-ralph)! - Fix add-task MCP command causing an error
-
 ## 0.16.0-rc.0
 
 ### Minor Changes

assets/.taskmasterconfig

@@ -26,7 +26,6 @@
 		"defaultPriority": "medium",
 		"projectName": "Taskmaster",
 		"ollamaBaseURL": "http://localhost:11434/api",
-		"azureOpenaiBaseURL": "https://your-endpoint.openai.azure.com/",
+		"azureOpenaiBaseURL": "https://your-endpoint.openai.azure.com/"
-		"bedrockBaseURL": "https://bedrock.us-east-1.amazonaws.com"
 	}
 }

assets/AGENTS.md

@@ -56,24 +56,20 @@ task-master generate                                         # Update task markd
 
 ```
 project/
-├── .taskmaster/
+├── tasks/
-│   ├── tasks/              # Task files directory
+│   ├── tasks.json           # Main task database
-│   │   ├── tasks.json      # Main task database
+│   ├── task-1.md           # Individual task files
-│   │   ├── task-1.md      # Individual task files
+│   └── task-2.md
-│   │   └── task-2.md
+├── scripts/
-│   ├── docs/              # Documentation directory
+│   ├── prd.txt             # Product requirements
-│   │   ├── prd.txt        # Product requirements
+│   └── task-complexity-report.json
-│   ├── reports/           # Analysis reports directory
-│   │   └── task-complexity-report.json
-│   ├── templates/         # Template files
-│   │   └── example_prd.txt  # Example PRD template
-│   └── config.json        # AI models & settings
 ├── .claude/
-│   ├── settings.json      # Claude Code configuration
+│   ├── settings.json        # Claude Code configuration
-│   └── commands/         # Custom slash commands
+│   └── commands/           # Custom slash commands
-├── .env                  # API keys
+├── .taskmasterconfig       # AI models & settings
-├── .mcp.json            # MCP configuration
+├── .env                    # API keys
-└── CLAUDE.md            # This file - auto-loaded by Claude Code
+├── .mcp.json              # MCP configuration
+└── CLAUDE.md              # This file - auto-loaded by Claude Code
 ```
 
 ## MCP Integration
@@ -388,7 +384,7 @@ These commands make AI calls and may take up to a minute:
 ### File Management
 
 - Never manually edit `tasks.json` - use commands instead
-- Never manually edit `.taskmaster/config.json` - use `task-master models`
+- Never manually edit `.taskmasterconfig` - use `task-master models`
 - Task markdown files in `tasks/` are auto-generated
 - Run `task-master generate` after manual changes to tasks.json
 

assets/env.example

@@ -5,5 +5,5 @@ OPENAI_API_KEY="your_openai_api_key_here"             # Optional, for OpenAI/Ope
 GOOGLE_API_KEY="your_google_api_key_here"             # Optional, for Google Gemini models.
 MISTRAL_API_KEY="your_mistral_key_here"               # Optional, for Mistral AI models.
 XAI_API_KEY="YOUR_XAI_KEY_HERE"                       # Optional, for xAI AI models.
-AZURE_OPENAI_API_KEY="your_azure_key_here"            # Optional, for Azure OpenAI models (requires endpoint in .taskmaster/config.json).
+AZURE_OPENAI_API_KEY="your_azure_key_here"            # Optional, for Azure OpenAI models (requires endpoint in .taskmasterconfig).
 OLLAMA_API_KEY="your_ollama_api_key_here"             # Optional: For remote Ollama servers that require authentication.

assets/scripts_README.md

@@ -20,7 +20,7 @@ In an AI-driven development process—particularly with tools like [Cursor](http
 
 Task Master configuration is now managed through two primary methods:
 
-1.  **`.taskmaster/config.json` File (Project Root - Primary)**
+1.  **`.taskmasterconfig` File (Project Root - Primary)**
 
     - Stores AI model selections (`main`, `research`, `fallback`), model parameters (`maxTokens`, `temperature`), `logLevel`, `defaultSubtasks`, `defaultPriority`, `projectName`, etc.
     - Managed using the `task-master models --setup` command or the `models` MCP tool.
@@ -192,7 +192,7 @@ Notes:
 ## AI Integration (Updated)
 
 - The script now uses a unified AI service layer (`ai-services-unified.js`).
-- Model selection (e.g., Claude vs. Perplexity for `--research`) is determined by the configuration in `.taskmaster/config.json` based on the requested `role` (`main` or `research`).
+- Model selection (e.g., Claude vs. Perplexity for `--research`) is determined by the configuration in `.taskmasterconfig` based on the requested `role` (`main` or `research`).
 - API keys are automatically resolved from your `.env` file (for CLI) or MCP session environment.
 - To use the research capabilities (e.g., `expand --research`), ensure you have:
   1.  Configured a model for the `research` role using `task-master models --setup` (Perplexity models are recommended).
@@ -357,25 +357,25 @@ The output report structure is:
 
 ```json
 {
-  "meta": {
+	"meta": {
-    "generatedAt": "2023-06-15T12:34:56.789Z",
+		"generatedAt": "2023-06-15T12:34:56.789Z",
-    "tasksAnalyzed": 20,
+		"tasksAnalyzed": 20,
-    "thresholdScore": 5,
+		"thresholdScore": 5,
-    "projectName": "Your Project Name",
+		"projectName": "Your Project Name",
-    "usedResearch": true
+		"usedResearch": true
-  },
+	},
-  "complexityAnalysis": [
+	"complexityAnalysis": [
-    {
+		{
-      "taskId": 8,
+			"taskId": 8,
-      "taskTitle": "Develop Implementation Drift Handling",
+			"taskTitle": "Develop Implementation Drift Handling",
-      "complexityScore": 9.5,
+			"complexityScore": 9.5,
-      "recommendedSubtasks": 6,
+			"recommendedSubtasks": 6,
-      "expansionPrompt": "Create subtasks that handle detecting...",
+			"expansionPrompt": "Create subtasks that handle detecting...",
-      "reasoning": "This task requires sophisticated logic...",
+			"reasoning": "This task requires sophisticated logic...",
-      "expansionCommand": "task-master expand --id=8 --num=6 --prompt=\"Create subtasks...\" --research"
+			"expansionCommand": "task-master expand --id=8 --num=6 --prompt=\"Create subtasks...\" --research"
-    }
+		}
-    // More tasks sorted by complexity score (highest first)
+		// More tasks sorted by complexity score (highest first)
-  ]
+	]
 }
 ```
 

bin/task-master.js

@@ -373,8 +373,4 @@ if (process.argv.length <= 2) {
 }
 
 // Add exports at the end of the file
-if (typeof module !== 'undefined') {
+export { detectCamelCaseFlags };
-	module.exports = {
-		detectCamelCaseFlags
-	};
-}

mcp-server/src/core/direct-functions/complexity-report.js

@@ -28,7 +28,8 @@ export async function complexityReportDirect(args, log) {
 			log.error('complexityReportDirect called without reportPath');
 			return {
 				success: false,
-				error: { code: 'MISSING_ARGUMENT', message: 'reportPath is required' }
+				error: { code: 'MISSING_ARGUMENT', message: 'reportPath is required' },
+				fromCache: false
 			};
 		}
 
@@ -110,7 +111,8 @@ export async function complexityReportDirect(args, log) {
 			error: {
 				code: 'UNEXPECTED_ERROR',
 				message: error.message
-			}
+			},
+			fromCache: false
 		};
 	}
 }

mcp-server/src/core/direct-functions/expand-all-tasks.js

@@ -60,8 +60,7 @@ export async function expandAllTasksDirect(args, log, context = {}) {
 			useResearch,
 			additionalContext,
 			forceFlag,
-			{ session, mcpLog, projectRoot },
+			{ session, mcpLog, projectRoot }
-			'json'
 		);
 
 		// Core function now returns a summary object including the *aggregated* telemetryData

mcp-server/src/core/direct-functions/expand-task.js

@@ -29,7 +29,7 @@ import { createLogWrapper } from '../../tools/utils.js';
  * @param {Object} log - Logger object
  * @param {Object} context - Context object containing session
  * @param {Object} [context.session] - MCP Session object
- * @returns {Promise<Object>} - Task expansion result { success: boolean, data?: any, error?: { code: string, message: string } }
+ * @returns {Promise<Object>} - Task expansion result { success: boolean, data?: any, error?: { code: string, message: string }, fromCache: boolean }
  */
 export async function expandTaskDirect(args, log, context = {}) {
 	const { session } = context; // Extract session
@@ -54,7 +54,8 @@ export async function expandTaskDirect(args, log, context = {}) {
 			error: {
 				code: 'MISSING_ARGUMENT',
 				message: 'tasksJsonPath is required'
-			}
+			},
+			fromCache: false
 		};
 	}
 
@@ -72,7 +73,8 @@ export async function expandTaskDirect(args, log, context = {}) {
 			error: {
 				code: 'INPUT_VALIDATION_ERROR',
 				message: 'Task ID is required'
-			}
+			},
+			fromCache: false
 		};
 	}
 
@@ -103,7 +105,8 @@ export async function expandTaskDirect(args, log, context = {}) {
 				error: {
 					code: 'INVALID_TASKS_FILE',
 					message: `No valid tasks found in ${tasksPath}. readJSON returned: ${JSON.stringify(data)}`
-				}
+				},
+				fromCache: false
 			};
 		}
 
@@ -118,7 +121,8 @@ export async function expandTaskDirect(args, log, context = {}) {
 				error: {
 					code: 'TASK_NOT_FOUND',
 					message: `Task with ID ${taskId} not found`
-				}
+				},
+				fromCache: false
 			};
 		}
 
@@ -129,7 +133,8 @@ export async function expandTaskDirect(args, log, context = {}) {
 				error: {
 					code: 'TASK_COMPLETED',
 					message: `Task ${taskId} is already marked as ${task.status} and cannot be expanded`
-				}
+				},
+				fromCache: false
 			};
 		}
 
@@ -146,7 +151,8 @@ export async function expandTaskDirect(args, log, context = {}) {
 					task,
 					subtasksAdded: 0,
 					hasExistingSubtasks
-				}
+				},
+				fromCache: false
 			};
 		}
 
@@ -226,7 +232,8 @@ export async function expandTaskDirect(args, log, context = {}) {
 					subtasksAdded,
 					hasExistingSubtasks,
 					telemetryData: coreResult.telemetryData
-				}
+				},
+				fromCache: false
 			};
 		} catch (error) {
 			// Make sure to restore normal logging even if there's an error
@@ -238,7 +245,8 @@ export async function expandTaskDirect(args, log, context = {}) {
 				error: {
 					code: 'CORE_FUNCTION_ERROR',
 					message: error.message || 'Failed to expand task'
-				}
+				},
+				fromCache: false
 			};
 		}
 	} catch (error) {
@@ -248,7 +256,8 @@ export async function expandTaskDirect(args, log, context = {}) {
 			error: {
 				code: 'CORE_FUNCTION_ERROR',
 				message: error.message || 'Failed to expand task'
-			}
+			},
+			fromCache: false
 		};
 	}
 }

mcp-server/src/core/direct-functions/generate-task-files.js

@@ -28,7 +28,8 @@ export async function generateTaskFilesDirect(args, log) {
 			log.error(errorMessage);
 			return {
 				success: false,
-				error: { code: 'MISSING_ARGUMENT', message: errorMessage }
+				error: { code: 'MISSING_ARGUMENT', message: errorMessage },
+				fromCache: false
 			};
 		}
 		if (!outputDir) {
@@ -36,7 +37,8 @@ export async function generateTaskFilesDirect(args, log) {
 			log.error(errorMessage);
 			return {
 				success: false,
-				error: { code: 'MISSING_ARGUMENT', message: errorMessage }
+				error: { code: 'MISSING_ARGUMENT', message: errorMessage },
+				fromCache: false
 			};
 		}
 
@@ -63,7 +65,8 @@ export async function generateTaskFilesDirect(args, log) {
 			log.error(`Error in generateTaskFiles: ${genError.message}`);
 			return {
 				success: false,
-				error: { code: 'GENERATE_FILES_ERROR', message: genError.message }
+				error: { code: 'GENERATE_FILES_ERROR', message: genError.message },
+				fromCache: false
 			};
 		}
 
@@ -76,7 +79,8 @@ export async function generateTaskFilesDirect(args, log) {
 				outputDir: resolvedOutputDir,
 				taskFiles:
 					'Individual task files have been generated in the output directory'
-			}
+			},
+			fromCache: false // This operation always modifies state and should never be cached
 		};
 	} catch (error) {
 		// Make sure to restore normal logging if an outer error occurs
@@ -88,7 +92,8 @@ export async function generateTaskFilesDirect(args, log) {
 			error: {
 				code: 'GENERATE_TASKS_ERROR',
 				message: error.message || 'Unknown error generating task files'
-			}
+			},
+			fromCache: false
 		};
 	}
 }

mcp-server/src/core/direct-functions/initialize-project.js

@@ -41,7 +41,8 @@ export async function initializeProjectDirect(args, log, context = {}) {
 				code: 'INVALID_TARGET_DIRECTORY',
 				message: `Cannot initialize project: Invalid target directory '${targetDirectory}' received. Please ensure a valid workspace/folder is open or specified.`,
 				details: `Received args.projectRoot: ${args.projectRoot}` // Show what was received
-			}
+			},
+			fromCache: false
 		};
 	}
 
@@ -96,8 +97,8 @@ export async function initializeProjectDirect(args, log, context = {}) {
 	}
 
 	if (success) {
-		return { success: true, data: resultData };
+		return { success: true, data: resultData, fromCache: false };
 	} else {
-		return { success: false, error: errorResult };
+		return { success: false, error: errorResult, fromCache: false };
 	}
 }

mcp-server/src/core/direct-functions/list-tasks.js

@@ -14,7 +14,7 @@ import {
  *
  * @param {Object} args - Command arguments (now expecting tasksJsonPath explicitly).
  * @param {Object} log - Logger object.
- * @returns {Promise<Object>} - Task list result { success: boolean, data?: any, error?: { code: string, message: string } }.
+ * @returns {Promise<Object>} - Task list result { success: boolean, data?: any, error?: { code: string, message: string }, fromCache: boolean }.
  */
 export async function listTasksDirect(args, log) {
 	// Destructure the explicit tasksJsonPath from args
@@ -27,7 +27,8 @@ export async function listTasksDirect(args, log) {
 			error: {
 				code: 'MISSING_ARGUMENT',
 				message: 'tasksJsonPath is required'
-			}
+			},
+			fromCache: false
 		};
 	}
 

mcp-server/src/core/direct-functions/next-task.js

@@ -19,7 +19,7 @@ import {
  * @param {Object} args - Command arguments
  * @param {string} args.tasksJsonPath - Explicit path to the tasks.json file.
  * @param {Object} log - Logger object
- * @returns {Promise<Object>} - Next task result { success: boolean, data?: any, error?: { code: string, message: string } }
+ * @returns {Promise<Object>} - Next task result { success: boolean, data?: any, error?: { code: string, message: string }, fromCache: boolean }
  */
 export async function nextTaskDirect(args, log) {
 	// Destructure expected args
@@ -32,7 +32,8 @@ export async function nextTaskDirect(args, log) {
 			error: {
 				code: 'MISSING_ARGUMENT',
 				message: 'tasksJsonPath is required'
-			}
+			},
+			fromCache: false
 		};
 	}
 
@@ -120,7 +121,7 @@ export async function nextTaskDirect(args, log) {
 	// Use the caching utility
 	try {
 		const result = await coreNextTaskAction();
-		log.info('nextTaskDirect completed.');
+		log.info(`nextTaskDirect completed.`);
 		return result;
 	} catch (error) {
 		log.error(`Unexpected error during nextTask: ${error.message}`);
@@ -129,7 +130,8 @@ export async function nextTaskDirect(args, log) {
 			error: {
 				code: 'UNEXPECTED_ERROR',
 				message: error.message
-			}
+			},
+			fromCache: false
 		};
 	}
 }

mcp-server/src/core/direct-functions/parse-prd.js

@@ -77,7 +77,7 @@ export async function parsePRDDirect(args, log, context = {}) {
 		? path.isAbsolute(outputArg)
 			? outputArg
 			: path.resolve(projectRoot, outputArg)
-		: resolveProjectPath(TASKMASTER_TASKS_FILE, args) ||
+		: resolveProjectPath(TASKMASTER_TASKS_FILE, session) ||
 			path.resolve(projectRoot, TASKMASTER_TASKS_FILE);
 
 	// Check if input file exists

mcp-server/src/core/direct-functions/remove-task.js

@@ -21,7 +21,7 @@ import {
  * @param {string} args.tasksJsonPath - Explicit path to the tasks.json file.
  * @param {string} args.id - The ID(s) of the task(s) or subtask(s) to remove (comma-separated for multiple).
  * @param {Object} log - Logger object
- * @returns {Promise<Object>} - Remove task result { success: boolean, data?: any, error?: { code: string, message: string } }
+ * @returns {Promise<Object>} - Remove task result { success: boolean, data?: any, error?: { code: string, message: string }, fromCache: false }
  */
 export async function removeTaskDirect(args, log) {
 	// Destructure expected args
@@ -35,7 +35,8 @@ export async function removeTaskDirect(args, log) {
 				error: {
 					code: 'MISSING_ARGUMENT',
 					message: 'tasksJsonPath is required'
-				}
+				},
+				fromCache: false
 			};
 		}
 
@@ -47,7 +48,8 @@ export async function removeTaskDirect(args, log) {
 				error: {
 					code: 'INPUT_VALIDATION_ERROR',
 					message: 'Task ID is required'
-				}
+				},
+				fromCache: false
 			};
 		}
 
@@ -66,7 +68,8 @@ export async function removeTaskDirect(args, log) {
 				error: {
 					code: 'INVALID_TASKS_FILE',
 					message: `No valid tasks found in ${tasksJsonPath}`
-				}
+				},
+				fromCache: false
 			};
 		}
 
@@ -80,7 +83,8 @@ export async function removeTaskDirect(args, log) {
 				error: {
 					code: 'INVALID_TASK_ID',
 					message: `The following tasks were not found: ${invalidTasks.join(', ')}`
-				}
+				},
+				fromCache: false
 			};
 		}
 
@@ -129,7 +133,8 @@ export async function removeTaskDirect(args, log) {
 					details: failedRemovals
 						.map((r) => `${r.taskId}: ${r.error}`)
 						.join('; ')
-				}
+				},
+				fromCache: false
 			};
 		}
 
@@ -142,7 +147,8 @@ export async function removeTaskDirect(args, log) {
 				failed: failedRemovals.length,
 				results: results,
 				tasksPath: tasksJsonPath
-			}
+			},
+			fromCache: false
 		};
 	} catch (error) {
 		// Ensure silent mode is disabled even if an outer error occurs
@@ -155,7 +161,8 @@ export async function removeTaskDirect(args, log) {
 			error: {
 				code: 'UNEXPECTED_ERROR',
 				message: error.message
-			}
+			},
+			fromCache: false
 		};
 	}
 }

mcp-server/src/core/direct-functions/set-task-status.js

@@ -29,7 +29,8 @@ export async function setTaskStatusDirect(args, log) {
 			log.error(errorMessage);
 			return {
 				success: false,
-				error: { code: 'MISSING_ARGUMENT', message: errorMessage }
+				error: { code: 'MISSING_ARGUMENT', message: errorMessage },
+				fromCache: false
 			};
 		}
 
@@ -40,7 +41,8 @@ export async function setTaskStatusDirect(args, log) {
 			log.error(errorMessage);
 			return {
 				success: false,
-				error: { code: 'MISSING_TASK_ID', message: errorMessage }
+				error: { code: 'MISSING_TASK_ID', message: errorMessage },
+				fromCache: false
 			};
 		}
 
@@ -50,7 +52,8 @@ export async function setTaskStatusDirect(args, log) {
 			log.error(errorMessage);
 			return {
 				success: false,
-				error: { code: 'MISSING_STATUS', message: errorMessage }
+				error: { code: 'MISSING_STATUS', message: errorMessage },
+				fromCache: false
 			};
 		}
 
@@ -79,7 +82,8 @@ export async function setTaskStatusDirect(args, log) {
 					taskId,
 					status: newStatus,
 					tasksPath: tasksPath // Return the path used
-				}
+				},
+				fromCache: false // This operation always modifies state and should never be cached
 			};
 
 			// If the task was completed, attempt to fetch the next task
@@ -122,7 +126,8 @@ export async function setTaskStatusDirect(args, log) {
 				error: {
 					code: 'SET_STATUS_ERROR',
 					message: error.message || 'Unknown error setting task status'
-				}
+				},
+				fromCache: false
 			};
 		} finally {
 			// ALWAYS restore normal logging in finally block
@@ -140,7 +145,8 @@ export async function setTaskStatusDirect(args, log) {
 			error: {
 				code: 'SET_STATUS_ERROR',
 				message: error.message || 'Unknown error setting task status'
-			}
+			},
+			fromCache: false
 		};
 	}
 }

mcp-server/src/core/direct-functions/update-subtask-by-id.js

@@ -42,7 +42,8 @@ export async function updateSubtaskByIdDirect(args, log, context = {}) {
 			logWrapper.error(errorMessage);
 			return {
 				success: false,
-				error: { code: 'MISSING_ARGUMENT', message: errorMessage }
+				error: { code: 'MISSING_ARGUMENT', message: errorMessage },
+				fromCache: false
 			};
 		}
 
@@ -53,7 +54,8 @@ export async function updateSubtaskByIdDirect(args, log, context = {}) {
 			logWrapper.error(errorMessage);
 			return {
 				success: false,
-				error: { code: 'INVALID_SUBTASK_ID', message: errorMessage }
+				error: { code: 'INVALID_SUBTASK_ID', message: errorMessage },
+				fromCache: false
 			};
 		}
 
@@ -63,7 +65,8 @@ export async function updateSubtaskByIdDirect(args, log, context = {}) {
 			logWrapper.error(errorMessage);
 			return {
 				success: false,
-				error: { code: 'MISSING_PROMPT', message: errorMessage }
+				error: { code: 'MISSING_PROMPT', message: errorMessage },
+				fromCache: false
 			};
 		}
 
@@ -74,7 +77,8 @@ export async function updateSubtaskByIdDirect(args, log, context = {}) {
 			log.error(errorMessage);
 			return {
 				success: false,
-				error: { code: 'INVALID_SUBTASK_ID_TYPE', message: errorMessage }
+				error: { code: 'INVALID_SUBTASK_ID_TYPE', message: errorMessage },
+				fromCache: false
 			};
 		}
 
@@ -84,7 +88,8 @@ export async function updateSubtaskByIdDirect(args, log, context = {}) {
 			log.error(errorMessage);
 			return {
 				success: false,
-				error: { code: 'INVALID_SUBTASK_ID_FORMAT', message: errorMessage }
+				error: { code: 'INVALID_SUBTASK_ID_FORMAT', message: errorMessage },
+				fromCache: false
 			};
 		}
 
@@ -123,7 +128,8 @@ export async function updateSubtaskByIdDirect(args, log, context = {}) {
 				logWrapper.error(message);
 				return {
 					success: false,
-					error: { code: 'SUBTASK_NOT_FOUND', message: message }
+					error: { code: 'SUBTASK_NOT_FOUND', message: message },
+					fromCache: false
 				};
 			}
 
@@ -140,7 +146,8 @@ export async function updateSubtaskByIdDirect(args, log, context = {}) {
 					tasksPath,
 					useResearch,
 					telemetryData: coreResult.telemetryData
-				}
+				},
+				fromCache: false
 			};
 		} catch (error) {
 			logWrapper.error(`Error updating subtask by ID: ${error.message}`);
@@ -149,7 +156,8 @@ export async function updateSubtaskByIdDirect(args, log, context = {}) {
 				error: {
 					code: 'UPDATE_SUBTASK_CORE_ERROR',
 					message: error.message || 'Unknown error updating subtask'
-				}
+				},
+				fromCache: false
 			};
 		} finally {
 			if (!wasSilent && isSilentMode()) {
@@ -166,7 +174,8 @@ export async function updateSubtaskByIdDirect(args, log, context = {}) {
 			error: {
 				code: 'DIRECT_FUNCTION_SETUP_ERROR',
 				message: error.message || 'Unknown setup error'
-			}
+			},
+			fromCache: false
 		};
 	}
 }

mcp-server/src/core/direct-functions/update-task-by-id.js

@@ -42,7 +42,8 @@ export async function updateTaskByIdDirect(args, log, context = {}) {
 			logWrapper.error(errorMessage);
 			return {
 				success: false,
-				error: { code: 'MISSING_ARGUMENT', message: errorMessage }
+				error: { code: 'MISSING_ARGUMENT', message: errorMessage },
+				fromCache: false
 			};
 		}
 
@@ -53,7 +54,8 @@ export async function updateTaskByIdDirect(args, log, context = {}) {
 			logWrapper.error(errorMessage);
 			return {
 				success: false,
-				error: { code: 'MISSING_TASK_ID', message: errorMessage }
+				error: { code: 'MISSING_TASK_ID', message: errorMessage },
+				fromCache: false
 			};
 		}
 
@@ -63,7 +65,8 @@ export async function updateTaskByIdDirect(args, log, context = {}) {
 			logWrapper.error(errorMessage);
 			return {
 				success: false,
-				error: { code: 'MISSING_PROMPT', message: errorMessage }
+				error: { code: 'MISSING_PROMPT', message: errorMessage },
+				fromCache: false
 			};
 		}
 
@@ -81,7 +84,8 @@ export async function updateTaskByIdDirect(args, log, context = {}) {
 					logWrapper.error(errorMessage);
 					return {
 						success: false,
-						error: { code: 'INVALID_TASK_ID', message: errorMessage }
+						error: { code: 'INVALID_TASK_ID', message: errorMessage },
+						fromCache: false
 					};
 				}
 			}
@@ -133,7 +137,8 @@ export async function updateTaskByIdDirect(args, log, context = {}) {
 						taskId: taskId,
 						updated: false,
 						telemetryData: coreResult?.telemetryData
-					}
+					},
+					fromCache: false
 				};
 			}
 
@@ -150,7 +155,8 @@ export async function updateTaskByIdDirect(args, log, context = {}) {
 					updated: true,
 					updatedTask: coreResult.updatedTask,
 					telemetryData: coreResult.telemetryData
-				}
+				},
+				fromCache: false
 			};
 		} catch (error) {
 			logWrapper.error(`Error updating task by ID: ${error.message}`);
@@ -159,7 +165,8 @@ export async function updateTaskByIdDirect(args, log, context = {}) {
 				error: {
 					code: 'UPDATE_TASK_CORE_ERROR',
 					message: error.message || 'Unknown error updating task'
-				}
+				},
+				fromCache: false
 			};
 		} finally {
 			if (!wasSilent && isSilentMode()) {
@@ -174,7 +181,8 @@ export async function updateTaskByIdDirect(args, log, context = {}) {
 			error: {
 				code: 'DIRECT_FUNCTION_SETUP_ERROR',
 				message: error.message || 'Unknown setup error'
-			}
+			},
+			fromCache: false
 		};
 	}
 }

mcp-server/src/core/utils/path-utils.js

@@ -1,4 +1,5 @@
 import path from 'path';
+import fs from 'fs';
 import {
 	findTasksPath as coreFindTasksPath,
 	findPRDPath as coreFindPrdPath,
@@ -12,22 +13,22 @@ import { PROJECT_MARKERS } from '../../../../src/constants/paths.js';
  * This module handles session-specific path resolution for the MCP server
  */
 
-/**
- * Silent logger for MCP context to prevent console output
- */
-const silentLogger = {
-	info: () => {},
-	warn: () => {},
-	error: () => {},
-	debug: () => {},
-	success: () => {}
-};
-
 /**
  * Cache for last found project root to improve performance
  */
 export const lastFoundProjectRoot = null;
 
+/**
+ * Find tasks.json file with MCP support
+ * @param {string} [explicitPath] - Explicit path to tasks.json (highest priority)
+ * @param {Object} [args] - Arguments object for context
+ * @param {Object} [log] - Logger object to prevent console logging
+ * @returns {string|null} - Resolved path to tasks.json or null if not found
+ */
+export function findTasksPathCore(explicitPath, args = null, log = null) {
+	return coreFindTasksPath(explicitPath, args, log);
+}
+
 /**
  * Find PRD file with MCP support
  * @param {string} [explicitPath] - Explicit path to PRD file (highest priority)
@@ -35,10 +36,25 @@ export const lastFoundProjectRoot = null;
  * @param {Object} [log] - Logger object to prevent console logging
  * @returns {string|null} - Resolved path to PRD file or null if not found
  */
-export function findPrdPath(explicitPath, args = null, log = silentLogger) {
+export function findPrdPath(explicitPath, args = null, log = null) {
 	return coreFindPrdPath(explicitPath, args, log);
 }
 
+/**
+ * Find complexity report file with MCP support
+ * @param {string} [explicitPath] - Explicit path to complexity report (highest priority)
+ * @param {Object} [args] - Arguments object for context
+ * @param {Object} [log] - Logger object to prevent console logging
+ * @returns {string|null} - Resolved path to complexity report or null if not found
+ */
+export function findComplexityReportPathCore(
+	explicitPath,
+	args = null,
+	log = null
+) {
+	return coreFindComplexityReportPath(explicitPath, args, log);
+}
+
 /**
  * Resolve tasks.json path from arguments
  * Prioritizes explicit path parameter, then uses fallback logic
@@ -46,7 +62,7 @@ export function findPrdPath(explicitPath, args = null, log = silentLogger) {
  * @param {Object} [log] - Logger object to prevent console logging
  * @returns {string|null} - Resolved path to tasks.json or null if not found
  */
-export function resolveTasksPath(args, log = silentLogger) {
+export function resolveTasksPath(args, log = null) {
 	// Get explicit path from args.file if provided
 	const explicitPath = args?.file;
 	const projectRoot = args?.projectRoot;
@@ -76,7 +92,7 @@ export function resolveTasksPath(args, log = silentLogger) {
  * @param {Object} [log] - Logger object to prevent console logging
  * @returns {string|null} - Resolved path to PRD file or null if not found
  */
-export function resolvePrdPath(args, log = silentLogger) {
+export function resolvePrdPath(args, log = null) {
 	// Get explicit path from args.input if provided
 	const explicitPath = args?.input;
 	const projectRoot = args?.projectRoot;
@@ -106,7 +122,7 @@ export function resolvePrdPath(args, log = silentLogger) {
  * @param {Object} [log] - Logger object to prevent console logging
  * @returns {string|null} - Resolved path to complexity report or null if not found
  */
-export function resolveComplexityReportPath(args, log = silentLogger) {
+export function resolveComplexityReportPath(args, log = null) {
 	// Get explicit path from args.complexityReport if provided
 	const explicitPath = args?.complexityReport;
 	const projectRoot = args?.projectRoot;
@@ -168,7 +184,7 @@ export function findProjectRoot(startDir) {
  * @param {Object} [log] - Log function to prevent console logging
  * @returns {string|null} - Resolved path to tasks.json or null if not found
  */
-export function findTasksPath(args, log = silentLogger) {
+export function findTasksPath(args, log = null) {
 	return resolveTasksPath(args, log);
 }
 
@@ -178,7 +194,7 @@ export function findTasksPath(args, log = silentLogger) {
  * @param {Object} [log] - Log function to prevent console logging
  * @returns {string|null} - Resolved path to complexity report or null if not found
  */
-export function findComplexityReportPath(args, log = silentLogger) {
+export function findComplexityReportPath(args, log = null) {
 	return resolveComplexityReportPath(args, log);
 }
 
@@ -189,7 +205,7 @@ export function findComplexityReportPath(args, log = silentLogger) {
  * @param {Object} [log] - Logger object to prevent console logging
  * @returns {string|null} - Resolved path to PRD file or null if not found
  */
-export function findPRDPath(explicitPath, args = null, log = silentLogger) {
+export function findPRDPath(explicitPath, args = null, log = null) {
 	return findPrdPath(explicitPath, args, log);
 }
 

mcp-server/src/tools/complexity-report.js

@@ -51,7 +51,9 @@ export function registerComplexityReportTool(server) {
 				);
 
 				if (result.success) {
-					log.info('Successfully retrieved complexity report');
+					log.info(
+						`Successfully retrieved complexity report${result.fromCache ? ' (from cache)' : ''}`
+					);
 				} else {
 					log.error(
 						`Failed to retrieve complexity report: ${result.error.message}`

mcp-server/src/tools/get-task.js

@@ -116,7 +116,9 @@ export function registerShowTaskTool(server) {
 				);
 
 				if (result.success) {
-					log.info(`Successfully retrieved task details for ID: ${args.id}`);
+					log.info(
+						`Successfully retrieved task details for ID: ${args.id}${result.fromCache ? ' (from cache)' : ''}`
+					);
 				} else {
 					log.error(`Failed to get task: ${result.error.message}`);
 				}

mcp-server/src/tools/get-tasks.js

@@ -58,7 +58,7 @@ export function registerListTasksTool(server) {
 				// Resolve the path to tasks.json using new path utilities
 				let tasksJsonPath;
 				try {
-					tasksJsonPath = resolveTasksPath(args, log);
+					tasksJsonPath = resolveTasksPath(args, session);
 				} catch (error) {
 					log.error(`Error finding tasks.json: ${error.message}`);
 					return createErrorResponse(
@@ -87,7 +87,7 @@ export function registerListTasksTool(server) {
 				);
 
 				log.info(
-					`Retrieved ${result.success ? result.data?.tasks?.length || 0 : 0} tasks`
+					`Retrieved ${result.success ? result.data?.tasks?.length || 0 : 0} tasks${result.fromCache ? ' (from cache)' : ''}`
 				);
 				return handleApiResult(result, log, 'Error getting tasks');
 			} catch (error) {

mcp-server/src/tools/models.js

@@ -47,6 +47,7 @@ export function registerModelsTool(server) {
 				),
 			projectRoot: z
 				.string()
+				.optional()
 				.describe('The directory of the project. Must be an absolute path.'),
 			openrouter: z
 				.boolean()

mcp-server/src/tools/move-task.js

@@ -34,6 +34,7 @@ export function registerMoveTaskTool(server) {
 			file: z.string().optional().describe('Custom path to tasks.json file'),
 			projectRoot: z
 				.string()
+				.optional()
 				.describe(
 					'Root directory of the project (typically derived from session)'
 				)
@@ -94,16 +95,13 @@ export function registerMoveTaskTool(server) {
 						}
 					}
 
-					return handleApiResult(
+					return {
-						{
+						success: true,
-							success: true,
+						data: {
-							data: {
+							moves: results,
-								moves: results,
+							message: `Successfully moved ${results.length} tasks`
-								message: `Successfully moved ${results.length} tasks`
+						}
-							}
+					};
-						},
-						log
-					);
 				} else {
 					// Moving a single task
 					return handleApiResult(

mcp-server/src/tools/parse-prd.js

@@ -32,6 +32,7 @@ export function registerParsePRDTool(server) {
 				.describe('Absolute path to the PRD document file (.txt, .md, etc.)'),
 			projectRoot: z
 				.string()
+				.optional()
 				.describe('The directory of the project. Must be an absolute path.'),
 			output: z
 				.string()

mcp-server/src/tools/utils.js

@@ -7,7 +7,6 @@ import { spawnSync } from 'child_process';
 import path from 'path';
 import fs from 'fs';
 import { contextManager } from '../core/context-manager.js'; // Import the singleton
-import { fileURLToPath } from 'url';
 
 // Import path utilities to ensure consistent path resolution
 import {
@@ -15,50 +14,6 @@ import {
 	PROJECT_MARKERS
 } from '../core/utils/path-utils.js';
 
-const __filename = fileURLToPath(import.meta.url);
-
-// Cache for version info to avoid repeated file reads
-let cachedVersionInfo = null;
-
-/**
- * Get version information from package.json
- * @returns {Object} Version information
- */
-function getVersionInfo() {
-	// Return cached version if available
-	if (cachedVersionInfo) {
-		return cachedVersionInfo;
-	}
-
-	try {
-		// Navigate to the project root from the tools directory
-		const packageJsonPath = path.join(
-			path.dirname(__filename),
-			'../../../package.json'
-		);
-		if (fs.existsSync(packageJsonPath)) {
-			const packageJson = JSON.parse(fs.readFileSync(packageJsonPath, 'utf-8'));
-			cachedVersionInfo = {
-				version: packageJson.version,
-				name: packageJson.name
-			};
-			return cachedVersionInfo;
-		}
-		cachedVersionInfo = {
-			version: 'unknown',
-			name: 'task-master-ai'
-		};
-		return cachedVersionInfo;
-	} catch (error) {
-		// Fallback version info if package.json can't be read
-		cachedVersionInfo = {
-			version: 'unknown',
-			name: 'task-master-ai'
-		};
-		return cachedVersionInfo;
-	}
-}
-
 /**
  * Get normalized project root path
  * @param {string|undefined} projectRootRaw - Raw project root from arguments
@@ -244,19 +199,17 @@ function getProjectRootFromSession(session, log) {
  * @param {Function} processFunction - Optional function to process successful result data
  * @returns {Object} - Standardized MCP response object
  */
-async function handleApiResult(
+function handleApiResult(
 	result,
 	log,
 	errorPrefix = 'API error',
 	processFunction = processMCPResponseData
 ) {
-	// Get version info for every response
-	const versionInfo = getVersionInfo();
-
 	if (!result.success) {
 		const errorMsg = result.error?.message || `Unknown ${errorPrefix}`;
-		log.error(`${errorPrefix}: ${errorMsg}`);
+		// Include cache status in error logs
-		return createErrorResponse(errorMsg, versionInfo);
+		log.error(`${errorPrefix}: ${errorMsg}. From cache: ${result.fromCache}`); // Keep logging cache status on error
+		return createErrorResponse(errorMsg);
 	}
 
 	// Process the result data if needed
@@ -264,14 +217,16 @@ async function handleApiResult(
 		? processFunction(result.data)
 		: result.data;
 
-	log.info('Successfully completed operation');
+	// Log success including cache status
+	log.info(`Successfully completed operation. From cache: ${result.fromCache}`); // Add success log with cache status
 
-	// Create the response payload including version info
+	// Create the response payload including the fromCache flag
 	const responsePayload = {
-		data: processedData,
+		fromCache: result.fromCache, // Get the flag from the original 'result'
-		version: versionInfo
+		data: processedData // Nest the processed data under a 'data' key
 	};
 
+	// Pass this combined payload to createContentResponse
 	return createContentResponse(responsePayload);
 }
 
@@ -365,8 +320,8 @@ function executeTaskMasterCommand(
  * @param {Function} options.actionFn - The async function to execute if the cache misses.
  *                                      Should return an object like { success: boolean, data?: any, error?: { code: string, message: string } }.
  * @param {Object} options.log - The logger instance.
- * @returns {Promise<Object>} - An object containing the result.
+ * @returns {Promise<Object>} - An object containing the result, indicating if it was from cache.
- *                              Format: { success: boolean, data?: any, error?: { code: string, message: string } }
+ *                              Format: { success: boolean, data?: any, error?: { code: string, message: string }, fromCache: boolean }
  */
 async function getCachedOrExecute({ cacheKey, actionFn, log }) {
 	// Check cache first
@@ -374,7 +329,11 @@ async function getCachedOrExecute({ cacheKey, actionFn, log }) {
 
 	if (cachedResult !== undefined) {
 		log.info(`Cache hit for key: ${cacheKey}`);
-		return cachedResult;
+		// Return the cached data in the same structure as a fresh result
+		return {
+			...cachedResult, // Spread the cached result to maintain its structure
+			fromCache: true // Just add the fromCache flag
+		};
 	}
 
 	log.info(`Cache miss for key: ${cacheKey}. Executing action function.`);
@@ -382,10 +341,12 @@ async function getCachedOrExecute({ cacheKey, actionFn, log }) {
 	// Execute the action function if cache missed
 	const result = await actionFn();
 
-	// If the action was successful, cache the result
+	// If the action was successful, cache the result (but without fromCache flag)
 	if (result.success && result.data !== undefined) {
 		log.info(`Action successful. Caching result for key: ${cacheKey}`);
-		contextManager.setCachedData(cacheKey, result);
+		// Cache the entire result structure (minus the fromCache flag)
+		const { fromCache, ...resultToCache } = result;
+		contextManager.setCachedData(cacheKey, resultToCache);
 	} else if (!result.success) {
 		log.warn(
 			`Action failed for cache key ${cacheKey}. Result not cached. Error: ${result.error?.message}`
@@ -396,7 +357,11 @@ async function getCachedOrExecute({ cacheKey, actionFn, log }) {
 		);
 	}
 
-	return result;
+	// Return the fresh result, indicating it wasn't from cache
+	return {
+		...result,
+		fromCache: false
+	};
 }
 
 /**
@@ -495,22 +460,14 @@ function createContentResponse(content) {
 /**
  * Creates error response for tools
  * @param {string} errorMessage - Error message to include in response
- * @param {Object} [versionInfo] - Optional version information object
  * @returns {Object} - Error content response object in FastMCP format
  */
-function createErrorResponse(errorMessage, versionInfo) {
+function createErrorResponse(errorMessage) {
-	// Provide fallback version info if not provided
-	if (!versionInfo) {
-		versionInfo = getVersionInfo();
-	}
-
 	return {
 		content: [
 			{
 				type: 'text',
-				text: `Error: ${errorMessage}
+				text: `Error: ${errorMessage}`
-Version: ${versionInfo.version}
-Name: ${versionInfo.name}`
 			}
 		],
 		isError: true

package.json

@@ -1,6 +1,6 @@
 {
 	"name": "task-master-ai",
-	"version": "0.16.1",
+	"version": "0.16.0-rc.0",
 	"description": "A task management system for ambitious AI-driven development that doesn't overwhelm and confuse Cursor.",
 	"main": "index.js",
 	"type": "module",

scripts/init.js

@@ -509,9 +509,9 @@ function createProjectStructure(addAliases, dryRun, options) {
 		replacements
 	);
 
-	// Copy config.json with project name to NEW location
+	// Copy .taskmasterconfig with project name to NEW location
 	copyTemplateFile(
-		'config.json',
+		'.taskmasterconfig',
 		path.join(targetDir, TASKMASTER_CONFIG_FILE),
 		{
 			...replacements

scripts/modules/ai-services-unified.js

@@ -22,7 +22,6 @@ import {
 	isApiKeySet,
 	getOllamaBaseURL,
 	getAzureBaseURL,
-	getBedrockBaseURL,
 	getVertexProjectId,
 	getVertexLocation
 } from './config-manager.js';
@@ -411,10 +410,6 @@ async function _unifiedServiceRunner(serviceType, params) {
 				// For Ollama, use the global Ollama base URL if role-specific URL is not configured
 				baseURL = getOllamaBaseURL(effectiveProjectRoot);
 				log('debug', `Using global Ollama base URL: ${baseURL}`);
-			} else if (providerName?.toLowerCase() === 'bedrock' && !baseURL) {
-				// For Bedrock, use the global Bedrock base URL if role-specific URL is not configured
-				baseURL = getBedrockBaseURL(effectiveProjectRoot);
-				log('debug', `Using global Bedrock base URL: ${baseURL}`);
 			}
 
 			// Get AI parameters for the current role

scripts/modules/config-manager.js

@@ -61,8 +61,7 @@ const DEFAULTS = {
 		defaultSubtasks: 5,
 		defaultPriority: 'medium',
 		projectName: 'Task Master',
-		ollamaBaseURL: 'http://localhost:11434/api',
+		ollamaBaseURL: 'http://localhost:11434/api'
-		bedrockBaseURL: 'https://bedrock.us-east-1.amazonaws.com'
 	}
 };
 
@@ -383,11 +382,6 @@ function getAzureBaseURL(explicitRoot = null) {
 	return getGlobalConfig(explicitRoot).azureBaseURL;
 }
 
-function getBedrockBaseURL(explicitRoot = null) {
-	// Directly return value from config
-	return getGlobalConfig(explicitRoot).bedrockBaseURL;
-}
-
 /**
  * Gets the Google Cloud project ID for Vertex AI from configuration
  * @param {string|null} explicitRoot - Optional explicit path to the project root.
@@ -785,7 +779,6 @@ export {
 	getProjectName,
 	getOllamaBaseURL,
 	getAzureBaseURL,
-	getBedrockBaseURL,
 	getParametersForRole,
 	getUserId,
 	// API Key Checkers (still relevant)

scripts/modules/task-manager/models.js

@@ -482,11 +482,6 @@ async function setModel(role, modelId, options = {}) {
 							`Model ID "${modelId}" not found in the Ollama instance. Please verify the model is pulled and available. You can check available models with: curl ${tagsUrl}`
 						);
 					}
-				} else if (providerHint === 'bedrock') {
-					// Set provider without model validation since Bedrock models are managed by AWS
-					determinedProvider = 'bedrock';
-					warningMessage = `Warning: Custom Bedrock model '${modelId}' set. Please ensure the model ID is valid and accessible in your AWS account.`;
-					report('warn', warningMessage);
 				} else {
 					// Invalid provider hint - should not happen
 					throw new Error(`Invalid provider hint received: ${providerHint}`);

scripts/modules/ui.js

@@ -24,10 +24,7 @@ import {
 } from './task-manager.js';
 import { getProjectName, getDefaultSubtasks } from './config-manager.js';
 import { TASK_STATUS_OPTIONS } from '../../src/constants/task-status.js';
-import {
+import { TASKMASTER_TASKS_FILE } from '../../src/constants/paths.js';
-	TASKMASTER_CONFIG_FILE,
-	TASKMASTER_TASKS_FILE
-} from '../../src/constants/paths.js';
 import { getTaskMasterVersion } from '../../src/utils/getVersion.js';
 
 // Create a color gradient for the banner
@@ -690,7 +687,7 @@ function displayHelp() {
 
 	configTable.push(
 		[
-			`${chalk.yellow(TASKMASTER_CONFIG_FILE)}${chalk.reset('')}`,
+			`${chalk.yellow('.taskmasterconfig')}${chalk.reset('')}`,
 			`${chalk.white('AI model configuration file (project root)')}${chalk.reset('')}`,
 			`${chalk.dim('Managed by models cmd')}${chalk.reset('')}`
 		],
@@ -1854,7 +1851,7 @@ function displayApiKeyStatus(statusReport) {
 	console.log(table.toString());
 	console.log(
 		chalk.gray(
-			`  Note: Some providers (e.g., Azure, Ollama) may require additional endpoint configuration in ${TASKMASTER_CONFIG_FILE}.`
+			'  Note: Some providers (e.g., Azure, Ollama) may require additional endpoint configuration in .taskmasterconfig.'
 		)
 	);
 }

scripts/modules/utils.js

@@ -155,17 +155,8 @@ function log(level, ...args) {
 		return;
 	}
 
-	// GUARD: Prevent circular dependency during config loading
+	// Get log level dynamically from config-manager
-	// Use a simple fallback log level instead of calling getLogLevel()
+	const configLevel = getLogLevel() || 'info'; // Use getter
-	let configLevel = 'info'; // Default fallback
-	try {
-		// Only try to get config level if we're not in the middle of config loading
-		configLevel = getLogLevel() || 'info';
-	} catch (error) {
-		// If getLogLevel() fails (likely due to circular dependency),
-		// use default 'info' level and continue
-		configLevel = 'info';
-	}
 
 	// Use text prefixes instead of emojis
 	const prefixes = {
@@ -199,17 +190,8 @@ function log(level, ...args) {
  * @returns {Object|null} Parsed JSON data or null if error occurs
  */
 function readJSON(filepath) {
-	// GUARD: Prevent circular dependency during config loading
+	// Get debug flag dynamically from config-manager
-	let isDebug = false; // Default fallback
+	const isDebug = getDebugFlag();
-	try {
-		// Only try to get debug flag if we're not in the middle of config loading
-		isDebug = getDebugFlag();
-	} catch (error) {
-		// If getDebugFlag() fails (likely due to circular dependency),
-		// use default false and continue
-		isDebug = false;
-	}
-
 	try {
 		const rawData = fs.readFileSync(filepath, 'utf8');
 		return JSON.parse(rawData);
@@ -230,17 +212,8 @@ function readJSON(filepath) {
  * @param {Object} data - Data to write
  */
 function writeJSON(filepath, data) {
-	// GUARD: Prevent circular dependency during config loading
+	// Get debug flag dynamically from config-manager
-	let isDebug = false; // Default fallback
+	const isDebug = getDebugFlag();
-	try {
-		// Only try to get debug flag if we're not in the middle of config loading
-		isDebug = getDebugFlag();
-	} catch (error) {
-		// If getDebugFlag() fails (likely due to circular dependency),
-		// use default false and continue
-		isDebug = false;
-	}
-
 	try {
 		const dir = path.dirname(filepath);
 		if (!fs.existsSync(dir)) {
@@ -273,17 +246,8 @@ function sanitizePrompt(prompt) {
  * @returns {Object|null} The parsed complexity report or null if not found
  */
 function readComplexityReport(customPath = null) {
-	// GUARD: Prevent circular dependency during config loading
+	// Get debug flag dynamically from config-manager
-	let isDebug = false; // Default fallback
+	const isDebug = getDebugFlag();
-	try {
-		// Only try to get debug flag if we're not in the middle of config loading
-		isDebug = getDebugFlag();
-	} catch (error) {
-		// If getDebugFlag() fails (likely due to circular dependency),
-		// use default false and continue
-		isDebug = false;
-	}
-
 	try {
 		let reportPath;
 		if (customPath) {

src/utils/logger-utils.js

@@ -1,31 +0,0 @@
-/**
- * Logger utility functions for Task Master
- * Provides standardized logging patterns for both CLI and utility contexts
- */
-
-import { log as utilLog } from '../../scripts/modules/utils.js';
-
-/**
- * Creates a standard logger object that wraps the utility log function
- * This provides a consistent logger interface across different parts of the application
- * @returns {Object} A logger object with standard logging methods (info, warn, error, debug, success)
- */
-export function createStandardLogger() {
-	return {
-		info: (msg, ...args) => utilLog('info', msg, ...args),
-		warn: (msg, ...args) => utilLog('warn', msg, ...args),
-		error: (msg, ...args) => utilLog('error', msg, ...args),
-		debug: (msg, ...args) => utilLog('debug', msg, ...args),
-		success: (msg, ...args) => utilLog('success', msg, ...args)
-	};
-}
-
-/**
- * Creates a logger using either the provided logger or a default standard logger
- * This is the recommended pattern for functions that accept an optional logger parameter
- * @param {Object|null} providedLogger - Optional logger object passed from caller
- * @returns {Object} A logger object with standard logging methods
- */
-export function getLoggerOrDefault(providedLogger = null) {
-	return providedLogger || createStandardLogger();
-}

src/utils/path-utils.js

@@ -14,7 +14,6 @@ import {
 	TASKMASTER_CONFIG_FILE,
 	LEGACY_CONFIG_FILE
 } from '../constants/paths.js';
-import { getLoggerOrDefault } from './logger-utils.js';
 
 /**
  * Find the project root directory by looking for project markers
@@ -60,8 +59,7 @@ export function findProjectRoot(startDir = process.cwd()) {
  * @returns {string|null} - Resolved tasks.json path or null if not found
  */
 export function findTasksPath(explicitPath = null, args = null, log = null) {
-	// Use the passed logger if available, otherwise use the default logger
+	const logger = log || console;
-	const logger = getLoggerOrDefault(log);
 
 	// 1. If explicit path is provided, use it (highest priority)
 	if (explicitPath) {
@@ -132,7 +130,7 @@ export function findTasksPath(explicitPath = null, args = null, log = null) {
  * @returns {string|null} - Resolved PRD document path or null if not found
  */
 export function findPRDPath(explicitPath = null, args = null, log = null) {
-	const logger = getLoggerOrDefault(log);
+	const logger = log || console;
 
 	// 1. If explicit path is provided, use it (highest priority)
 	if (explicitPath) {
@@ -201,7 +199,7 @@ export function findComplexityReportPath(
 	args = null,
 	log = null
 ) {
-	const logger = getLoggerOrDefault(log);
+	const logger = log || console;
 
 	// 1. If explicit path is provided, use it (highest priority)
 	if (explicitPath) {
@@ -270,7 +268,7 @@ export function resolveTasksOutputPath(
 	args = null,
 	log = null
 ) {
-	const logger = getLoggerOrDefault(log);
+	const logger = log || console;
 
 	// 1. If explicit path is provided, use it
 	if (explicitPath) {
@@ -311,7 +309,7 @@ export function resolveComplexityReportOutputPath(
 	args = null,
 	log = null
 ) {
-	const logger = getLoggerOrDefault(log);
+	const logger = log || console;
 
 	// 1. If explicit path is provided, use it
 	if (explicitPath) {
@@ -350,7 +348,7 @@ export function resolveComplexityReportOutputPath(
  * @returns {string|null} - Resolved config file path or null if not found
  */
 export function findConfigPath(explicitPath = null, args = null, log = null) {
-	const logger = getLoggerOrDefault(log);
+	const logger = log || console;
 
 	// 1. If explicit path is provided, use it (highest priority)
 	if (explicitPath) {
@@ -384,6 +382,12 @@ export function findConfigPath(explicitPath = null, args = null, log = null) {
 
 	for (const configPath of possiblePaths) {
 		if (fs.existsSync(configPath)) {
+			try {
+				logger.info?.(`Found config file at: ${configPath}`);
+			} catch (error) {
+				// Silently handle logging errors during testing
+			}
+
 			// Issue deprecation warning for legacy paths
 			if (configPath?.endsWith(LEGACY_CONFIG_FILE)) {
 				logger.warn?.(

tests/integration/mcp-server/direct-functions.test.js

@@ -253,7 +253,8 @@ describe('MCP Server Direct Functions', () => {
 					error: {
 						code: 'FILE_NOT_FOUND_ERROR',
 						message: 'Tasks file not found'
-					}
+					},
+					fromCache: false
 				};
 			}
 
@@ -287,7 +288,8 @@ describe('MCP Server Direct Functions', () => {
 								.length,
 							pending: tasksData.filter((t) => t.status === 'pending').length
 						}
-					}
+					},
+					fromCache: false
 				};
 			}
 
@@ -303,7 +305,8 @@ describe('MCP Server Direct Functions', () => {
 							total: tasksData.length,
 							filtered: filteredTasks.length
 						}
-					}
+					},
+					fromCache: false
 				};
 			}
 
@@ -317,7 +320,8 @@ describe('MCP Server Direct Functions', () => {
 						stats: {
 							total: tasksData.length
 						}
-					}
+					},
+					fromCache: false
 				};
 			}
 
@@ -437,7 +441,8 @@ describe('MCP Server Direct Functions', () => {
 					error: {
 						code: 'INPUT_VALIDATION_ERROR',
 						message: 'Task ID is required'
-					}
+					},
+					fromCache: false
 				};
 			}
 
@@ -449,7 +454,8 @@ describe('MCP Server Direct Functions', () => {
 					error: {
 						code: 'TASK_NOT_FOUND',
 						message: `Task with ID ${args.id} not found`
-					}
+					},
+					fromCache: false
 				};
 			}
 
@@ -463,7 +469,8 @@ describe('MCP Server Direct Functions', () => {
 					error: {
 						code: 'TASK_COMPLETED',
 						message: `Task ${args.id} is already marked as done and cannot be expanded`
-					}
+					},
+					fromCache: false
 				};
 			}
 
@@ -488,7 +495,8 @@ describe('MCP Server Direct Functions', () => {
 					task: expandedTask,
 					subtasksAdded: expandedTask.subtasks.length,
 					hasExistingSubtasks: false
-				}
+				},
+				fromCache: false
 			};
 		}
 

tests/unit/ai-services-unified.test.js

@@ -43,7 +43,6 @@ const mockGetBaseUrlForRole = jest.fn();
 const mockGetAllProviders = jest.fn();
 const mockGetOllamaBaseURL = jest.fn();
 const mockGetAzureBaseURL = jest.fn();
-const mockGetBedrockBaseURL = jest.fn();
 const mockGetVertexProjectId = jest.fn();
 const mockGetVertexLocation = jest.fn();
 const mockGetAvailableModels = jest.fn();
@@ -114,7 +113,6 @@ jest.unstable_mockModule('../../scripts/modules/config-manager.js', () => ({
 	getAllProviders: mockGetAllProviders,
 	getOllamaBaseURL: mockGetOllamaBaseURL,
 	getAzureBaseURL: mockGetAzureBaseURL,
-	getBedrockBaseURL: mockGetBedrockBaseURL,
 	getVertexProjectId: mockGetVertexProjectId,
 	getVertexLocation: mockGetVertexLocation,
 	getMcpApiKeyStatus: mockGetMcpApiKeyStatus

tests/unit/config-manager.test.js

@@ -139,8 +139,7 @@ const DEFAULT_CONFIG = {
 		defaultSubtasks: 5,
 		defaultPriority: 'medium',
 		projectName: 'Task Master',
-		ollamaBaseURL: 'http://localhost:11434/api',
+		ollamaBaseURL: 'http://localhost:11434/api'
-		bedrockBaseURL: 'https://bedrock.us-east-1.amazonaws.com'
 	}
 };
 

tests/unit/scripts/modules/task-manager/analyze-task-complexity.test.js

@@ -127,7 +127,6 @@ jest.unstable_mockModule(
 		getProjectName: jest.fn(() => 'Test Project'),
 		getOllamaBaseURL: jest.fn(() => 'http://localhost:11434/api'),
 		getAzureBaseURL: jest.fn(() => undefined),
-		getBedrockBaseURL: jest.fn(() => undefined),
 		getParametersForRole: jest.fn(() => ({
 			maxTokens: 4000,
 			temperature: 0.7