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/curly-months-go.md

@@ -1,5 +0,0 @@
----
-"task-master-ai": patch
----
-
-Fix bedrock issues

.changeset/dirty-webs-jam.md

@@ -1,5 +0,0 @@
----
-"task-master-ai": patch
----
-
-Fix MCP tool calls logging errors

.changeset/loud-dolls-yell.md

@@ -1,5 +0,0 @@
----
-"task-master-ai": patch
----
-
-Update rules for new directory structure

.changeset/odd-banks-fly.md

@@ -1,5 +0,0 @@
----
-"task-master-ai": patch
----
-
-Fix bug in expand_all mcp tool

.changeset/pink-houses-lay.md

@@ -1,7 +0,0 @@
----
-"task-master-ai": patch
----
-
-Fix double .taskmaster directory paths in file resolution utilities
-
-- Closes #636

.changeset/tall-symbols-call.md

@@ -1,5 +0,0 @@
----
-"task-master-ai": patch
----
-
-Fix MCP crashing after certain commands due to console logs

.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/"
+	}
+}

assets/.taskmasterconfig

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

assets/AGENTS.md

@@ -56,24 +56,20 @@ task-master generate                                         # Update task markd
 
 ```
 project/
-├── .taskmaster/
-│   ├── tasks/              # Task files directory
-│   │   ├── tasks.json      # Main task database
-│   │   ├── task-1.md      # Individual task files
-│   │   └── task-2.md
-│   ├── docs/              # Documentation directory
-│   │   ├── prd.txt        # Product requirements
-│   ├── reports/           # Analysis reports directory
-│   │   └── task-complexity-report.json
-│   ├── templates/         # Template files
-│   │   └── example_prd.txt  # Example PRD template
-│   └── config.json        # AI models & settings
+├── tasks/
+│   ├── tasks.json           # Main task database
+│   ├── task-1.md           # Individual task files
+│   └── task-2.md
+├── scripts/
+│   ├── prd.txt             # Product requirements
+│   └── task-complexity-report.json
 ├── .claude/
-│   ├── settings.json      # Claude Code configuration
-│   └── commands/         # Custom slash commands
-├── .env                  # API keys
-├── .mcp.json            # MCP configuration
-└── CLAUDE.md            # This file - auto-loaded by Claude Code
+│   ├── settings.json        # Claude Code configuration
+│   └── commands/           # Custom slash commands
+├── .taskmasterconfig       # AI models & settings
+├── .env                    # API keys
+├── .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": {
-    "generatedAt": "2023-06-15T12:34:56.789Z",
-    "tasksAnalyzed": 20,
-    "thresholdScore": 5,
-    "projectName": "Your Project Name",
-    "usedResearch": true
-  },
-  "complexityAnalysis": [
-    {
-      "taskId": 8,
-      "taskTitle": "Develop Implementation Drift Handling",
-      "complexityScore": 9.5,
-      "recommendedSubtasks": 6,
-      "expansionPrompt": "Create subtasks that handle detecting...",
-      "reasoning": "This task requires sophisticated logic...",
-      "expansionCommand": "task-master expand --id=8 --num=6 --prompt=\"Create subtasks...\" --research"
-    }
-    // More tasks sorted by complexity score (highest first)
-  ]
+	"meta": {
+		"generatedAt": "2023-06-15T12:34:56.789Z",
+		"tasksAnalyzed": 20,
+		"thresholdScore": 5,
+		"projectName": "Your Project Name",
+		"usedResearch": true
+	},
+	"complexityAnalysis": [
+		{
+			"taskId": 8,
+			"taskTitle": "Develop Implementation Drift Handling",
+			"complexityScore": 9.5,
+			"recommendedSubtasks": 6,
+			"expansionPrompt": "Create subtasks that handle detecting...",
+			"reasoning": "This task requires sophisticated logic...",
+			"expansionCommand": "task-master expand --id=8 --num=6 --prompt=\"Create subtasks...\" --research"
+		}
+		// 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') {
-	module.exports = {
-		detectCamelCaseFlags
-	};
-}
+export { 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 },
-			'json'
+			{ session, mcpLog, projectRoot }
 		);
 
 		// 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,10 +1,10 @@
 import path from 'path';
+import fs from 'fs';
 import {
 	findTasksPath as coreFindTasksPath,
 	findPRDPath as coreFindPrdPath,
 	findComplexityReportPath as coreFindComplexityReportPath,
-	findProjectRoot as coreFindProjectRoot,
-	normalizeProjectRoot
+	findProjectRoot as coreFindProjectRoot
 } from '../../../../src/utils/path-utils.js';
 import { PROJECT_MARKERS } from '../../../../src/constants/paths.js';
 
@@ -13,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)
@@ -36,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
@@ -47,27 +62,22 @@ 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 rawProjectRoot = args?.projectRoot;
+	const projectRoot = args?.projectRoot;
 
 	// If explicit path is provided and absolute, use it directly
 	if (explicitPath && path.isAbsolute(explicitPath)) {
 		return explicitPath;
 	}
 
-	// Normalize project root if provided
-	const projectRoot = rawProjectRoot
-		? normalizeProjectRoot(rawProjectRoot)
-		: null;
-
-	// If explicit path is relative, resolve it relative to normalized projectRoot
+	// If explicit path is relative, resolve it relative to projectRoot
 	if (explicitPath && projectRoot) {
 		return path.resolve(projectRoot, explicitPath);
 	}
 
-	// Use core findTasksPath with explicit path and normalized projectRoot context
+	// Use core findTasksPath with explicit path and projectRoot context
 	if (projectRoot) {
 		return coreFindTasksPath(explicitPath, { projectRoot }, log);
 	}
@@ -82,27 +92,22 @@ 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 rawProjectRoot = args?.projectRoot;
+	const projectRoot = args?.projectRoot;
 
 	// If explicit path is provided and absolute, use it directly
 	if (explicitPath && path.isAbsolute(explicitPath)) {
 		return explicitPath;
 	}
 
-	// Normalize project root if provided
-	const projectRoot = rawProjectRoot
-		? normalizeProjectRoot(rawProjectRoot)
-		: null;
-
-	// If explicit path is relative, resolve it relative to normalized projectRoot
+	// If explicit path is relative, resolve it relative to projectRoot
 	if (explicitPath && projectRoot) {
 		return path.resolve(projectRoot, explicitPath);
 	}
 
-	// Use core findPRDPath with explicit path and normalized projectRoot context
+	// Use core findPRDPath with explicit path and projectRoot context
 	if (projectRoot) {
 		return coreFindPrdPath(explicitPath, { projectRoot }, log);
 	}
@@ -117,27 +122,22 @@ 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 rawProjectRoot = args?.projectRoot;
+	const projectRoot = args?.projectRoot;
 
 	// If explicit path is provided and absolute, use it directly
 	if (explicitPath && path.isAbsolute(explicitPath)) {
 		return explicitPath;
 	}
 
-	// Normalize project root if provided
-	const projectRoot = rawProjectRoot
-		? normalizeProjectRoot(rawProjectRoot)
-		: null;
-
-	// If explicit path is relative, resolve it relative to normalized projectRoot
+	// If explicit path is relative, resolve it relative to projectRoot
 	if (explicitPath && projectRoot) {
 		return path.resolve(projectRoot, explicitPath);
 	}
 
-	// Use core findComplexityReportPath with explicit path and normalized projectRoot context
+	// Use core findComplexityReportPath with explicit path and projectRoot context
 	if (projectRoot) {
 		return coreFindComplexityReportPath(explicitPath, { projectRoot }, log);
 	}
@@ -158,16 +158,13 @@ export function resolveProjectPath(relativePath, args) {
 		throw new Error('projectRoot is required in args to resolve project paths');
 	}
 
-	// Normalize the project root to prevent double .taskmaster paths
-	const projectRoot = normalizeProjectRoot(args.projectRoot);
-
 	// If already absolute, return as-is
 	if (path.isAbsolute(relativePath)) {
 		return relativePath;
 	}
 
-	// Resolve relative to normalized projectRoot
-	return path.resolve(projectRoot, relativePath);
+	// Resolve relative to projectRoot
+	return path.resolve(args.projectRoot, relativePath);
 }
 
 /**
@@ -187,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);
 }
 
@@ -197,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);
 }
 
@@ -208,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

@@ -11,7 +11,7 @@ import {
 } from './utils.js';
 import { complexityReportDirect } from '../core/task-master-core.js';
 import { COMPLEXITY_REPORT_FILE } from '../../../src/constants/paths.js';
-import { findComplexityReportPath } from '../core/utils/path-utils.js';
+import path from 'path';
 
 /**
  * Register the complexityReport tool with the MCP server
@@ -38,18 +38,10 @@ export function registerComplexityReportTool(server) {
 					`Getting complexity report with args: ${JSON.stringify(args)}`
 				);
 
-				const pathArgs = {
-					projectRoot: args.projectRoot,
-					complexityReport: args.file
-				};
-
-				const reportPath = findComplexityReportPath(pathArgs, log);
-
-				if (!reportPath) {
-					return createErrorResponse(
-						'No complexity report found. Run task-master analyze-complexity first.'
-					);
-				}
+				// Use args.projectRoot directly (guaranteed by withNormalizedProjectRoot)
+				const reportPath = args.file
+					? path.resolve(args.projectRoot, args.file)
+					: path.resolve(args.projectRoot, COMPLEXITY_REPORT_FILE);
 
 				const result = await complexityReportDirect(
 					{
@@ -59,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(
-						{
-							success: true,
-							data: {
-								moves: results,
-								message: `Successfully moved ${results.length} tasks`
-							}
-						},
-						log
-					);
+					return {
+						success: true,
+						data: {
+							moves: results,
+							message: `Successfully moved ${results.length} tasks`
+						}
+					};
 				} 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}`);
-		return createErrorResponse(errorMsg, versionInfo);
+		// Include cache status in error logs
+		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,
-		version: versionInfo
+		fromCache: result.fromCache, // Get the flag from the original 'result'
+		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.
- *                              Format: { success: boolean, data?: any, error?: { code: string, message: string } }
+ * @returns {Promise<Object>} - An object containing the result, indicating if it was from cache.
+ *                              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) {
-	// Provide fallback version info if not provided
-	if (!versionInfo) {
-		versionInfo = getVersionInfo();
-	}
-
+function createErrorResponse(errorMessage) {
 	return {
 		content: [
 			{
 				type: 'text',
-				text: `Error: ${errorMessage}
-Version: ${versionInfo.version}
-Name: ${versionInfo.name}`
+				text: `Error: ${errorMessage}`
 			}
 		],
 		isError: true

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',
-		bedrockBaseURL: 'https://bedrock.us-east-1.amazonaws.com'
+		ollamaBaseURL: 'http://localhost:11434/api'
 	}
 };
 
@@ -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 {
-	TASKMASTER_CONFIG_FILE,
-	TASKMASTER_TASKS_FILE
-} from '../../src/constants/paths.js';
+import { 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
-	// Use a simple fallback log level instead of calling getLogLevel()
-	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';
-	}
+	// Get log level dynamically from config-manager
+	const configLevel = getLogLevel() || 'info'; // Use getter
 
 	// 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
-	let isDebug = false; // Default fallback
-	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;
-	}
-
+	// Get debug flag dynamically from config-manager
+	const isDebug = getDebugFlag();
 	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
-	let isDebug = false; // Default fallback
-	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;
-	}
-
+	// Get debug flag dynamically from config-manager
+	const isDebug = getDebugFlag();
 	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
-	let isDebug = false; // Default fallback
-	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;
-	}
-
+	// Get debug flag dynamically from config-manager
+	const isDebug = getDebugFlag();
 	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,33 +14,6 @@ import {
 	TASKMASTER_CONFIG_FILE,
 	LEGACY_CONFIG_FILE
 } from '../constants/paths.js';
-import { getLoggerOrDefault } from './logger-utils.js';
-
-/**
- * Normalize project root to ensure it doesn't end with .taskmaster
- * This prevents double .taskmaster paths when using constants that include .taskmaster
- * @param {string} projectRoot - The project root path to normalize
- * @returns {string} - Normalized project root path
- */
-export function normalizeProjectRoot(projectRoot) {
-	if (!projectRoot) return projectRoot;
-
-	// Split the path into segments
-	const segments = projectRoot.split(path.sep);
-
-	// Find the index of .taskmaster segment
-	const taskmasterIndex = segments.findIndex(
-		(segment) => segment === '.taskmaster'
-	);
-
-	if (taskmasterIndex !== -1) {
-		// If .taskmaster is found, return everything up to but not including .taskmaster
-		const normalizedSegments = segments.slice(0, taskmasterIndex);
-		return normalizedSegments.join(path.sep) || path.sep;
-	}
-
-	return projectRoot;
-}
 
 /**
  * Find the project root directory by looking for project markers
@@ -86,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 = getLoggerOrDefault(log);
+	const logger = log || console;
 
 	// 1. If explicit path is provided, use it (highest priority)
 	if (explicitPath) {
@@ -106,17 +78,14 @@ export function findTasksPath(explicitPath = null, args = null, log = null) {
 	}
 
 	// 2. Try to get project root from args (MCP) or find it
-	const rawProjectRoot = args?.projectRoot || findProjectRoot();
+	const projectRoot = args?.projectRoot || findProjectRoot();
 
-	if (!rawProjectRoot) {
+	if (!projectRoot) {
 		logger.warn?.('Could not determine project root directory');
 		return null;
 	}
 
-	// 3. Normalize project root to prevent double .taskmaster paths
-	const projectRoot = normalizeProjectRoot(rawProjectRoot);
-
-	// 4. Check possible locations in order of preference
+	// 3. Check possible locations in order of preference
 	const possiblePaths = [
 		path.join(projectRoot, TASKMASTER_TASKS_FILE), // .taskmaster/tasks/tasks.json (NEW)
 		path.join(projectRoot, 'tasks.json'), // tasks.json in root (LEGACY)
@@ -161,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) {
@@ -180,17 +149,14 @@ export function findPRDPath(explicitPath = null, args = null, log = null) {
 	}
 
 	// 2. Try to get project root from args (MCP) or find it
-	const rawProjectRoot = args?.projectRoot || findProjectRoot();
+	const projectRoot = args?.projectRoot || findProjectRoot();
 
-	if (!rawProjectRoot) {
+	if (!projectRoot) {
 		logger.warn?.('Could not determine project root directory');
 		return null;
 	}
 
-	// 3. Normalize project root to prevent double .taskmaster paths
-	const projectRoot = normalizeProjectRoot(rawProjectRoot);
-
-	// 4. Check possible locations in order of preference
+	// 3. Check possible locations in order of preference
 	const locations = [
 		TASKMASTER_DOCS_DIR, // .taskmaster/docs/ (NEW)
 		'scripts/', // Legacy location
@@ -233,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) {
@@ -252,17 +218,14 @@ export function findComplexityReportPath(
 	}
 
 	// 2. Try to get project root from args (MCP) or find it
-	const rawProjectRoot = args?.projectRoot || findProjectRoot();
+	const projectRoot = args?.projectRoot || findProjectRoot();
 
-	if (!rawProjectRoot) {
+	if (!projectRoot) {
 		logger.warn?.('Could not determine project root directory');
 		return null;
 	}
 
-	// 3. Normalize project root to prevent double .taskmaster paths
-	const projectRoot = normalizeProjectRoot(rawProjectRoot);
-
-	// 4. Check possible locations in order of preference
+	// 3. Check possible locations in order of preference
 	const locations = [
 		TASKMASTER_REPORTS_DIR, // .taskmaster/reports/ (NEW)
 		'scripts/', // Legacy location
@@ -305,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) {
@@ -318,13 +281,9 @@ export function resolveTasksOutputPath(
 	}
 
 	// 2. Try to get project root from args (MCP) or find it
-	const rawProjectRoot =
-		args?.projectRoot || findProjectRoot() || process.cwd();
+	const projectRoot = args?.projectRoot || findProjectRoot() || process.cwd();
 
-	// 3. Normalize project root to prevent double .taskmaster paths
-	const projectRoot = normalizeProjectRoot(rawProjectRoot);
-
-	// 4. Use new .taskmaster structure by default
+	// 3. Use new .taskmaster structure by default
 	const defaultPath = path.join(projectRoot, TASKMASTER_TASKS_FILE);
 	logger.info?.(`Using default output path: ${defaultPath}`);
 
@@ -350,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) {
@@ -365,13 +324,9 @@ export function resolveComplexityReportOutputPath(
 	}
 
 	// 2. Try to get project root from args (MCP) or find it
-	const rawProjectRoot =
-		args?.projectRoot || findProjectRoot() || process.cwd();
+	const projectRoot = args?.projectRoot || findProjectRoot() || process.cwd();
 
-	// 3. Normalize project root to prevent double .taskmaster paths
-	const projectRoot = normalizeProjectRoot(rawProjectRoot);
-
-	// 4. Use new .taskmaster structure by default
+	// 3. Use new .taskmaster structure by default
 	const defaultPath = path.join(projectRoot, COMPLEXITY_REPORT_FILE);
 	logger.info?.(`Using default complexity report output path: ${defaultPath}`);
 
@@ -393,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) {
@@ -412,17 +367,14 @@ export function findConfigPath(explicitPath = null, args = null, log = null) {
 	}
 
 	// 2. Try to get project root from args (MCP) or find it
-	const rawProjectRoot = args?.projectRoot || findProjectRoot();
+	const projectRoot = args?.projectRoot || findProjectRoot();
 
-	if (!rawProjectRoot) {
+	if (!projectRoot) {
 		logger.warn?.('Could not determine project root directory');
 		return null;
 	}
 
-	// 3. Normalize project root to prevent double .taskmaster paths
-	const projectRoot = normalizeProjectRoot(rawProjectRoot);
-
-	// 4. Check possible locations in order of preference
+	// 3. Check possible locations in order of preference
 	const possiblePaths = [
 		path.join(projectRoot, TASKMASTER_CONFIG_FILE), // NEW location
 		path.join(projectRoot, LEGACY_CONFIG_FILE) // LEGACY location
@@ -430,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',
-		bedrockBaseURL: 'https://bedrock.us-east-1.amazonaws.com'
+		ollamaBaseURL: 'http://localhost:11434/api'
 	}
 };
 

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