An AI-powered task-management system you can drop into Cursor, Lovable, Windsurf, Roo, and others.
JavaScript aicursorcursor-aicursorailovablelovable-devroocodetask-managertaskstasks-listwindsurfwindsurf-ai
Phase 1 refactoring path resolution. (#877)
Chris Covingtonde28026b3266
diff --git a/scripts/modules/commands.js b/scripts/modules/commands.jsindex 8b653463..65970c8a 100644--- a/scripts/modules/commands.js+++ b/scripts/modules/commands.js@@ -18,7 +18,6 @@ import {log,readJSON,writeJSON,- findProjectRoot,getCurrentTag,detectCamelCaseFlags,toKebabCase@@ -79,11 +78,12 @@ import { CUSTOM_PROVIDERS } from '../../src/constants/providers.js';import {COMPLEXITY_REPORT_FILE,- PRD_FILE,TASKMASTER_TASKS_FILE,- TASKMASTER_CONFIG_FILE+ TASKMASTER_DOCS_DIR} from '../../src/constants/paths.js';+import { initTaskMaster } from '../../src/task-master.js';+import {displayBanner,displayHelp,@@ -822,25 +822,34 @@ function registerCommands(programInstance) {).option('--tag <tag>', 'Specify tag context for task operations').action(async (file, options) => {- // Use input option if file argument not provided- const inputFile = file || options.input;- const defaultPrdPath = PRD_FILE;+ // Initialize TaskMaster+ let taskMaster;+ try {+ taskMaster = initTaskMaster({+ prdPath: file || options.input || true,+ tasksPath: options.output || true+ });+ } catch (error) {+ console.log(+ boxen(+ `${chalk.white.bold('Parse PRD Help')}\n\n${chalk.cyan('Usage:')}\n task-master parse-prd <prd-file.txt> [options]\n\n${chalk.cyan('Options:')}\n -i, --input <file> Path to the PRD file (alternative to positional argument)\n -o, --output <file> Output file path (default: "${TASKMASTER_TASKS_FILE}")\n -n, --num-tasks <number> Number of tasks to generate (default: 10)\n -f, --force Skip confirmation when overwriting existing tasks\n --append Append new tasks to existing tasks.json instead of overwriting\n -r, --research Use Perplexity AI for research-backed task generation\n\n${chalk.cyan('Example:')}\n task-master parse-prd requirements.txt --num-tasks 15\n task-master parse-prd --input=requirements.txt\n task-master parse-prd --force\n task-master parse-prd requirements_v2.txt --append\n task-master parse-prd requirements.txt --research\n\n${chalk.yellow('Note: This command will:')}\n 1. Look for a PRD file at ${TASKMASTER_DOCS_DIR}/PRD.md by default\n 2. Use the file specified by --input or positional argument if provided\n 3. Generate tasks from the PRD and either:\n - Overwrite any existing tasks.json file (default)\n - Append to existing tasks.json if --append is used`,+ { padding: 1, borderColor: 'blue', borderStyle: 'round' }+ )+ );+ console.error(chalk.red(`\nError: ${error.message}`));+ process.exit(1);+ }+const numTasks = parseInt(options.numTasks, 10);- const outputPath = options.output;const force = options.force || false;const append = options.append || false;const research = options.research || false;let useForce = force;const useAppend = append;- const projectRoot = findProjectRoot();- if (!projectRoot) {- console.error(chalk.red('Error: Could not find project root.'));- process.exit(1);- }-// Resolve tag using standard pattern- const tag = options.tag || getCurrentTag(projectRoot) || 'master';+ const tag =+ options.tag || getCurrentTag(taskMaster.getProjectRoot()) || 'master';// Show current tag contextdisplayCurrentTagIndicator(tag);@@ -849,10 +858,11 @@ function registerCommands(programInstance) {async function confirmOverwriteIfNeeded() {// Check if there are existing tasks in the target taglet hasExistingTasksInTag = false;- if (fs.existsSync(outputPath)) {+ const tasksPath = taskMaster.getTasksPath();+ if (fs.existsSync(tasksPath)) {try {// Read the entire file to check if the tag exists- const existingFileContent = fs.readFileSync(outputPath, 'utf8');+ const existingFileContent = fs.readFileSync(tasksPath, 'utf8');const allData = JSON.parse(existingFileContent);// Check if the target tag exists and has tasks@@ -871,7 +881,7 @@ function registerCommands(programInstance) {// Only show confirmation if there are existing tasks in the target tagif (hasExistingTasksInTag && !useForce && !useAppend) {- const overwrite = await confirmTaskOverwrite(outputPath);+ const overwrite = await confirmTaskOverwrite(tasksPath);if (!overwrite) {log('info', 'Operation cancelled.');return false;@@ -886,50 +896,9 @@ function registerCommands(programInstance) {let spinner;try {- if (!inputFile) {- if (fs.existsSync(defaultPrdPath)) {- console.log(- chalk.blue(`Using default PRD file path: ${defaultPrdPath}`)- );- if (!(await confirmOverwriteIfNeeded())) return;-- console.log(chalk.blue(`Generating ${numTasks} tasks...`));- spinner = ora('Parsing PRD and generating tasks...\n').start();- await parsePRD(defaultPrdPath, outputPath, numTasks, {- append: useAppend, // Changed key from useAppend to append- force: useForce, // Changed key from useForce to force- research: research,- projectRoot: projectRoot,- tag: tag- });- spinner.succeed('Tasks generated successfully!');- return;- }-- console.log(- chalk.yellow(- `No PRD file specified and default PRD file not found at ${PRD_FILE}.`- )- );- console.log(- boxen(- `${chalk.white.bold('Parse PRD Help')}\n\n${chalk.cyan('Usage:')}\n task-master parse-prd <prd-file.txt> [options]\n\n${chalk.cyan('Options:')}\n -i, --input <file> Path to the PRD file (alternative to positional argument)\n -o, --output <file> Output file path (default: "${TASKMASTER_TASKS_FILE}")\n -n, --num-tasks <number> Number of tasks to generate (default: 10)\n -f, --force Skip confirmation when overwriting existing tasks\n --append Append new tasks to existing tasks.json instead of overwriting\n -r, --research Use Perplexity AI for research-backed task generation\n\n${chalk.cyan('Example:')}\n task-master parse-prd requirements.txt --num-tasks 15\n task-master parse-prd --input=requirements.txt\n task-master parse-prd --force\n task-master parse-prd requirements_v2.txt --append\n task-master parse-prd requirements.txt --research\n\n${chalk.yellow('Note: This command will:')}\n 1. Look for a PRD file at ${PRD_FILE} by default\n 2. Use the file specified by --input or positional argument if provided\n 3. Generate tasks from the PRD and either:\n - Overwrite any existing tasks.json file (default)\n - Append to existing tasks.json if --append is used`,- { padding: 1, borderColor: 'blue', borderStyle: 'round' }- )- );- return;- }-- if (!fs.existsSync(inputFile)) {- console.error(- chalk.red(`Error: Input PRD file not found: ${inputFile}`)- );- process.exit(1);- }-if (!(await confirmOverwriteIfNeeded())) return;- console.log(chalk.blue(`Parsing PRD file: ${inputFile}`));+ console.log(chalk.blue(`Parsing PRD file: ${taskMaster.getPrdPath()}`));console.log(chalk.blue(`Generating ${numTasks} tasks...`));if (append) {console.log(chalk.blue('Appending to existing tasks...'));@@ -943,13 +912,18 @@ function registerCommands(programInstance) {}spinner = ora('Parsing PRD and generating tasks...\n').start();- await parsePRD(inputFile, outputPath, numTasks, {- append: useAppend,- force: useForce,- research: research,- projectRoot: projectRoot,- tag: tag- });+ await parsePRD(+ taskMaster.getPrdPath(),+ taskMaster.getTasksPath(),+ numTasks,+ {+ append: useAppend,+ force: useForce,+ research: research,+ projectRoot: taskMaster.getProjectRoot(),+ tag: tag+ }+ );spinner.succeed('Tasks generated successfully!');} catch (error) {if (spinner) {@@ -987,19 +961,18 @@ function registerCommands(programInstance) {).option('--tag <tag>', 'Specify tag context for task operations').action(async (options) => {- const tasksPath = options.file || TASKMASTER_TASKS_FILE;+ // Initialize TaskMaster+ const taskMaster = initTaskMaster({+ tasksPath: options.file || true+ });+const fromId = parseInt(options.from, 10); // Validation happens hereconst prompt = options.prompt;const useResearch = options.research || false;- const projectRoot = findProjectRoot();- if (!projectRoot) {- console.error(chalk.red('Error: Could not find project root.'));- process.exit(1);- }-// Resolve tag using standard pattern- const tag = options.tag || getCurrentTag(projectRoot) || 'master';+ const tag =+ options.tag || getCurrentTag(taskMaster.getProjectRoot()) || 'master';// Show current tag contextdisplayCurrentTagIndicator(tag);@@ -1051,11 +1024,11 @@ function registerCommands(programInstance) {// Call core updateTasks, passing context for CLIawait updateTasks(- tasksPath,+ taskMaster.getTasksPath(),fromId,prompt,useResearch,- { projectRoot, tag } // Pass context with projectRoot and tag+ { projectRoot: taskMaster.getProjectRoot(), tag } // Pass context with projectRoot and tag);});@@ -1086,16 +1059,14 @@ function registerCommands(programInstance) {.option('--tag <tag>', 'Specify tag context for task operations').action(async (options) => {try {- const tasksPath = options.file || TASKMASTER_TASKS_FILE;-- const projectRoot = findProjectRoot();- if (!projectRoot) {- console.error(chalk.red('Error: Could not find project root.'));- process.exit(1);- }+ // Initialize TaskMaster+ const taskMaster = initTaskMaster({+ tasksPath: options.file || true+ });// Resolve tag using standard pattern- const tag = options.tag || getCurrentTag(projectRoot) || 'master';+ const tag =+ options.tag || getCurrentTag(taskMaster.getProjectRoot()) || 'master';// Show current tag contextdisplayCurrentTagIndicator(tag);@@ -1193,7 +1164,7 @@ function registerCommands(programInstance) {taskId,prompt,useResearch,- { projectRoot, tag },+ { projectRoot: taskMaster.getProjectRoot(), tag },'text',options.append || false);@@ -1259,16 +1230,14 @@ function registerCommands(programInstance) {.option('--tag <tag>', 'Specify tag context for task operations').action(async (options) => {try {- const tasksPath = options.file || TASKMASTER_TASKS_FILE;-- const projectRoot = findProjectRoot();- if (!projectRoot) {- console.error(chalk.red('Error: Could not find project root.'));- process.exit(1);- }+ // Initialize TaskMaster+ const taskMaster = initTaskMaster({+ tasksPath: options.file || true+ });// Resolve tag using standard pattern- const tag = options.tag || getCurrentTag(projectRoot) || 'master';+ const tag =+ options.tag || getCurrentTag(taskMaster.getProjectRoot()) || 'master';// Show current tag contextdisplayCurrentTagIndicator(tag);@@ -1368,7 +1337,7 @@ function registerCommands(programInstance) {subtaskId,prompt,useResearch,- { projectRoot, tag }+ { projectRoot: taskMaster.getProjectRoot(), tag });if (!result) {@@ -1426,20 +1395,23 @@ function registerCommands(programInstance) {).option('--tag <tag>', 'Specify tag context for task operations').action(async (options) => {- const tasksPath = options.file || TASKMASTER_TASKS_FILE;+ // Initialize TaskMaster+ const taskMaster = initTaskMaster({+ tasksPath: options.file || true+ });+const outputDir = options.output;const tag = options.tag;- const projectRoot = findProjectRoot();- if (!projectRoot) {- console.error(chalk.red('Error: Could not find project root.'));- process.exit(1);- }-- console.log(chalk.blue(`Generating task files from: ${tasksPath}`));+ console.log(+ chalk.blue(`Generating task files from: ${taskMaster.getTasksPath()}`)+ );console.log(chalk.blue(`Output directory: ${outputDir}`));- await generateTaskFiles(tasksPath, outputDir, { projectRoot, tag });+ await generateTaskFiles(taskMaster.getTasksPath(), outputDir, {+ projectRoot: taskMaster.getProjectRoot(),+ tag+ });});// set-status command@@ -1463,7 +1435,11 @@ function registerCommands(programInstance) {).option('--tag <tag>', 'Specify tag context for task operations').action(async (options) => {- const tasksPath = options.file || TASKMASTER_TASKS_FILE;+ // Initialize TaskMaster+ const taskMaster = initTaskMaster({+ tasksPath: options.file || true+ });+const taskId = options.id;const status = options.status;const tag = options.tag;@@ -1483,22 +1459,19 @@ function registerCommands(programInstance) {process.exit(1);}- // Find project root for tag resolution- const projectRoot = findProjectRoot();- if (!projectRoot) {- console.error(chalk.red('Error: Could not find project root.'));- process.exit(1);- }-// Resolve tag using standard pattern and show current tag context- const resolvedTag = tag || getCurrentTag(projectRoot) || 'master';+ const resolvedTag =+ tag || getCurrentTag(taskMaster.getProjectRoot()) || 'master';displayCurrentTagIndicator(resolvedTag);console.log(chalk.blue(`Setting status of task(s) ${taskId} to: ${status}`));- await setTaskStatus(tasksPath, taskId, status, { projectRoot, tag });+ await setTaskStatus(taskMaster.getTasksPath(), taskId, status, {+ projectRoot: taskMaster.getProjectRoot(),+ tag+ });});// list command@@ -1519,22 +1492,23 @@ function registerCommands(programInstance) {.option('--with-subtasks', 'Show subtasks for each task').option('--tag <tag>', 'Specify tag context for task operations').action(async (options) => {- const projectRoot = findProjectRoot();- if (!projectRoot) {- console.error(chalk.red('Error: Could not find project root.'));- process.exit(1);- }+ // Initialize TaskMaster+ const taskMaster = initTaskMaster({+ tasksPath: options.file || true,+ complexityReportPath: options.report || false+ });- const tasksPath = options.file || TASKMASTER_TASKS_FILE;- const reportPath = options.report;const statusFilter = options.status;const withSubtasks = options.withSubtasks || false;- const tag = options.tag || getCurrentTag(projectRoot) || 'master';+ const tag =+ options.tag || getCurrentTag(taskMaster.getProjectRoot()) || 'master';// Show current tag contextdisplayCurrentTagIndicator(tag);- console.log(chalk.blue(`Listing tasks from: ${tasksPath}`));+ console.log(+ chalk.blue(`Listing tasks from: ${taskMaster.getTasksPath()}`)+ );if (statusFilter) {console.log(chalk.blue(`Filtering by status: ${statusFilter}`));}@@ -1543,13 +1517,13 @@ function registerCommands(programInstance) {}await listTasks(- tasksPath,+ taskMaster.getTasksPath(),statusFilter,- reportPath,+ taskMaster.getComplexityReportPath(),withSubtasks,'text',tag,- { projectRoot }+ { projectRoot: taskMaster.getProjectRoot() });});@@ -1580,16 +1554,16 @@ function registerCommands(programInstance) {) // Allow file override.option('--tag <tag>', 'Specify tag context for task operations').action(async (options) => {- const projectRoot = findProjectRoot();- if (!projectRoot) {- console.error(chalk.red('Error: Could not find project root.'));- process.exit(1);- }- const tasksPath = path.resolve(projectRoot, options.file); // Resolve tasks path+ // Initialize TaskMaster+ const taskMaster = initTaskMaster({+ tasksPath: options.file || true+ });const tag = options.tag;// Show current tag context- displayCurrentTagIndicator(tag || getCurrentTag(projectRoot) || 'master');+ displayCurrentTagIndicator(+ tag || getCurrentTag(taskMaster.getProjectRoot()) || 'master'+ );if (options.all) {// --- Handle expand --all ---@@ -1602,7 +1576,7 @@ function registerCommands(programInstance) {options.research, // Pass research flagoptions.prompt, // Pass additional contextoptions.force, // Pass force flag- { projectRoot, tag } // Pass context with projectRoot and tag+ { projectRoot: taskMaster.getProjectRoot(), tag } // Pass context with projectRoot and tag// outputFormat defaults to 'text' in expandAllTasks for CLI);} catch (error) {@@ -1629,7 +1603,7 @@ function registerCommands(programInstance) {options.num,options.research,options.prompt,- { projectRoot, tag }, // Pass context with projectRoot and tag+ { projectRoot: taskMaster.getProjectRoot(), tag }, // Pass context with projectRoot and tagoptions.force // Pass the force flag down);// expandTask logs its own success/failure for single task@@ -1684,31 +1658,36 @@ function registerCommands(programInstance) {.option('--to <id>', 'Ending task ID in a range to analyze').option('--tag <tag>', 'Specify tag context for task operations').action(async (options) => {- const tasksPath = options.file || TASKMASTER_TASKS_FILE;+ // Initialize TaskMaster+ const taskMaster = initTaskMaster({+ tasksPath: options.file || true,+ complexityReportPath: options.output || true+ });+const tag = options.tag;const modelOverride = options.model;const thresholdScore = parseFloat(options.threshold);const useResearch = options.research || false;- const projectRoot = findProjectRoot();- if (!projectRoot) {- console.error(chalk.red('Error: Could not find project root.'));- process.exit(1);- }-// Use the provided tag, or the current active tag, or default to 'master'- const targetTag = tag || getCurrentTag(projectRoot) || 'master';+ const targetTag =+ tag || getCurrentTag(taskMaster.getProjectRoot()) || 'master';// Show current tag contextdisplayCurrentTagIndicator(targetTag);// Tag-aware output file naming: master -> task-complexity-report.json, other tags -> task-complexity-report_tagname.json+ const baseOutputPath = taskMaster.getComplexityReportPath();const outputPath =options.output === COMPLEXITY_REPORT_FILE && targetTag !== 'master'- ? options.output.replace('.json', `_${targetTag}.json`)- : options.output;+ ? baseOutputPath.replace('.json', `_${targetTag}.json`)+ : baseOutputPath;- console.log(chalk.blue(`Analyzing task complexity from: ${tasksPath}`));+ console.log(+ chalk.blue(+ `Analyzing task complexity from: ${taskMaster.getTasksPath()}`+ )+ );console.log(chalk.blue(`Output report will be saved to: ${outputPath}`));if (options.id) {@@ -1734,7 +1713,8 @@ function registerCommands(programInstance) {...options,output: outputPath,tag: targetTag,- projectRoot: projectRoot+ projectRoot: taskMaster.getProjectRoot(),+ file: taskMaster.getTasksPath()};await analyzeTaskComplexity(updatedOptions);@@ -1879,12 +1859,8 @@ function registerCommands(programInstance) {}}- // Determine project root and tasks file path- const projectRoot = findProjectRoot() || '.';- const tag = options.tag || getCurrentTag(projectRoot) || 'master';- const tasksPath =- options.file ||- path.join(projectRoot, '.taskmaster', 'tasks', 'tasks.json');+ const tag =+ options.tag || getCurrentTag(taskMaster.getProjectRoot()) || 'master';// Show current tag contextdisplayCurrentTagIndicator(tag);@@ -1892,11 +1868,15 @@ function registerCommands(programInstance) {// Validate tasks file exists if task IDs are specifiedif (taskIds.length > 0) {try {- const tasksData = readJSON(tasksPath, projectRoot, tag);+ const tasksData = readJSON(+ taskMaster.getTasksPath(),+ taskMaster.getProjectRoot(),+ tag+ );if (!tasksData || !tasksData.tasks) {console.error(chalk.red(- `Error: No valid tasks found in ${tasksPath} for tag '${tag}'`+ `Error: No valid tasks found in ${taskMaster.getTasksPath()} for tag '${tag}'`));process.exit(1);@@ -1914,7 +1894,7 @@ function registerCommands(programInstance) {for (const filePath of filePaths) {const fullPath = path.isAbsolute(filePath)? filePath- : path.join(projectRoot, filePath);+ : path.join(taskMaster.getProjectRoot(), filePath);if (!fs.existsSync(fullPath)) {console.error(chalk.red(`Error: File not found: ${filePath}`));process.exit(1);@@ -1933,8 +1913,8 @@ function registerCommands(programInstance) {saveToId: options.saveTo ? options.saveTo.trim() : null,allowFollowUp: true, // Always allow follow-up in CLIdetailLevel: options.detail ? options.detail.toLowerCase() : 'medium',- tasksPath: tasksPath,- projectRoot: projectRoot+ tasksPath: taskMaster.getTasksPath(),+ projectRoot: taskMaster.getProjectRoot()};// Display what we're about to do@@ -2116,14 +2096,15 @@ ${result.result}const all = options.all;const tag = options.tag;- const projectRoot = findProjectRoot();- if (!projectRoot) {- console.error(chalk.red('Error: Could not find project root.'));- process.exit(1);- }+ // Initialize TaskMaster+ const taskMaster = initTaskMaster({+ tasksPath: options.file || true+ });// Show current tag context- displayCurrentTagIndicator(tag || getCurrentTag(projectRoot) || 'master');+ displayCurrentTagIndicator(+ tag || getCurrentTag(taskMaster.getProjectRoot()) || 'master'+ );if (!taskIds && !all) {console.error(@@ -2136,15 +2117,25 @@ ${result.result}if (all) {// If --all is specified, get all task IDs- const data = readJSON(tasksPath, projectRoot, tag);+ const data = readJSON(+ taskMaster.getTasksPath(),+ taskMaster.getProjectRoot(),+ tag+ );if (!data || !data.tasks) {console.error(chalk.red('Error: No valid tasks found'));process.exit(1);}const allIds = data.tasks.map((t) => t.id).join(',');- clearSubtasks(tasksPath, allIds, { projectRoot, tag });+ clearSubtasks(taskMaster.getTasksPath(), allIds, {+ projectRoot: taskMaster.getProjectRoot(),+ tag+ });} else {- clearSubtasks(tasksPath, taskIds, { projectRoot, tag });+ clearSubtasks(taskMaster.getTasksPath(), taskIds, {+ projectRoot: taskMaster.getProjectRoot(),+ tag+ });}});@@ -2207,15 +2198,14 @@ ${result.result}}// Correctly determine projectRoot- const projectRoot = findProjectRoot();- if (!projectRoot) {- console.error(chalk.red('Error: Could not find project root.'));- process.exit(1);- }+ // Initialize TaskMaster+ const taskMaster = initTaskMaster({+ tasksPath: options.file || true+ });// Show current tag contextdisplayCurrentTagIndicator(- options.tag || getCurrentTag(projectRoot) || 'master'+ options.tag || getCurrentTag(taskMaster.getProjectRoot()) || 'master');let manualTaskData = null;@@ -2302,16 +2292,21 @@ ${result.result}const reportPath = options.report;const tag = options.tag;- const projectRoot = findProjectRoot();- if (!projectRoot) {- console.error(chalk.red('Error: Could not find project root.'));- process.exit(1);- }+ // Initialize TaskMaster+ const taskMaster = initTaskMaster({+ tasksPath: options.file || true+ });// Show current tag context- displayCurrentTagIndicator(tag || getCurrentTag(projectRoot) || 'master');+ displayCurrentTagIndicator(+ tag || getCurrentTag(taskMaster.getProjectRoot()) || 'master'+ );- await displayNextTask(tasksPath, reportPath, { projectRoot, tag });+ await displayNextTask(+ taskMaster.getTasksPath(),+ taskMaster.getComplexityReportPath(),+ { projectRoot: taskMaster.getProjectRoot(), tag }+ );});// show command@@ -2338,27 +2333,26 @@ ${result.result}).option('--tag <tag>', 'Specify tag context for task operations').action(async (taskId, options) => {- const projectRoot = findProjectRoot();- if (!projectRoot) {- console.error(chalk.red('Error: Could not find project root.'));- process.exit(1);- }+ // Initialize TaskMaster+ const taskMaster = initTaskMaster({+ tasksPath: options.file || true,+ complexityReportPath: options.report || false+ });const idArg = taskId || options.id;const statusFilter = options.status;const tag = options.tag;// Show current tag context- displayCurrentTagIndicator(tag || getCurrentTag(projectRoot) || 'master');+ displayCurrentTagIndicator(+ tag || getCurrentTag(taskMaster.getProjectRoot()) || 'master'+ );if (!idArg) {console.error(chalk.red('Error: Please provide a task ID'));process.exit(1);}- const tasksPath = options.file || TASKMASTER_TASKS_FILE;- const reportPath = options.report;-// Check if multiple IDs are provided (comma-separated)const taskIds = idArg.split(',')@@ -2368,21 +2362,21 @@ ${result.result}if (taskIds.length > 1) {// Multiple tasks - use compact summary view with interactive drill-downawait displayMultipleTasksSummary(- tasksPath,+ taskMaster.getTasksPath(),taskIds,- reportPath,+ taskMaster.getComplexityReportPath(),statusFilter,- { projectRoot, tag }+ { projectRoot: taskMaster.getProjectRoot(), tag });} else {// Single task - use detailed viewawait displayTaskById(- tasksPath,+ taskMaster.getTasksPath(),taskIds[0],- reportPath,+ taskMaster.getComplexityReportPath(),statusFilter,tag,- { projectRoot }+ { projectRoot: taskMaster.getProjectRoot() });}});@@ -2400,18 +2394,17 @@ ${result.result}).option('--tag <tag>', 'Specify tag context for task operations').action(async (options) => {- const tasksPath = options.file || TASKMASTER_TASKS_FILE;+ // Initialize TaskMaster+ const taskMaster = initTaskMaster({+ tasksPath: options.file || true+ });+const taskId = options.id;const dependencyId = options.dependsOn;- const projectRoot = findProjectRoot();- if (!projectRoot) {- console.error(chalk.red('Error: Could not find project root.'));- process.exit(1);- }-// Resolve tag using standard pattern- const tag = options.tag || getCurrentTag(projectRoot) || 'master';+ const tag =+ options.tag || getCurrentTag(taskMaster.getProjectRoot()) || 'master';// Show current tag contextdisplayCurrentTagIndicator(tag);@@ -2432,10 +2425,15 @@ ${result.result}? dependencyId: parseInt(dependencyId, 10);- await addDependency(tasksPath, formattedTaskId, formattedDependencyId, {- projectRoot,- tag- });+ await addDependency(+ taskMaster.getTasksPath(),+ formattedTaskId,+ formattedDependencyId,+ {+ projectRoot: taskMaster.getProjectRoot(),+ tag+ }+ );});// remove-dependency command@@ -2451,18 +2449,17 @@ ${result.result}).option('--tag <tag>', 'Specify tag context for task operations').action(async (options) => {- const tasksPath = options.file || TASKMASTER_TASKS_FILE;+ // Initialize TaskMaster+ const taskMaster = initTaskMaster({+ tasksPath: options.file || true+ });+const taskId = options.id;const dependencyId = options.dependsOn;- const projectRoot = findProjectRoot();- if (!projectRoot) {- console.error(chalk.red('Error: Could not find project root.'));- process.exit(1);- }-// Resolve tag using standard pattern- const tag = options.tag || getCurrentTag(projectRoot) || 'master';+ const tag =+ options.tag || getCurrentTag(taskMaster.getProjectRoot()) || 'master';// Show current tag contextdisplayCurrentTagIndicator(tag);@@ -2484,11 +2481,11 @@ ${result.result}: parseInt(dependencyId, 10);await removeDependency(- tasksPath,+ taskMaster.getTasksPath(),formattedTaskId,formattedDependencyId,{- projectRoot,+ projectRoot: taskMaster.getProjectRoot(),tag});@@ -2507,20 +2504,20 @@ ${result.result}).option('--tag <tag>', 'Specify tag context for task operations').action(async (options) => {- const projectRoot = findProjectRoot();- if (!projectRoot) {- console.error(chalk.red('Error: Could not find project root.'));- process.exit(1);- }+ // Initialize TaskMaster+ const taskMaster = initTaskMaster({+ tasksPath: options.file || true+ });// Resolve tag using standard pattern- const tag = options.tag || getCurrentTag(projectRoot) || 'master';+ const tag =+ options.tag || getCurrentTag(taskMaster.getProjectRoot()) || 'master';// Show current tag contextdisplayCurrentTagIndicator(tag);- await validateDependenciesCommand(options.file || TASKMASTER_TASKS_FILE, {- context: { projectRoot, tag }+ await validateDependenciesCommand(taskMaster.getTasksPath(), {+ context: { projectRoot: taskMaster.getProjectRoot(), tag }});});@@ -2535,20 +2532,20 @@ ${result.result}).option('--tag <tag>', 'Specify tag context for task operations').action(async (options) => {- const projectRoot = findProjectRoot();- if (!projectRoot) {- console.error(chalk.red('Error: Could not find project root.'));- process.exit(1);- }+ // Initialize TaskMaster+ const taskMaster = initTaskMaster({+ tasksPath: options.file || true+ });// Resolve tag using standard pattern- const tag = options.tag || getCurrentTag(projectRoot) || 'master';+ const tag =+ options.tag || getCurrentTag(taskMaster.getProjectRoot()) || 'master';// Show current tag contextdisplayCurrentTagIndicator(tag);- await fixDependenciesCommand(options.file || TASKMASTER_TASKS_FILE, {- context: { projectRoot, tag }+ await fixDependenciesCommand(taskMaster.getTasksPath(), {+ context: { projectRoot: taskMaster.getProjectRoot(), tag }});});@@ -2563,23 +2560,24 @@ ${result.result}).option('--tag <tag>', 'Specify tag context for task operations').action(async (options) => {- const projectRoot = findProjectRoot();- if (!projectRoot) {- console.error(chalk.red('Error: Could not find project root.'));- process.exit(1);- }+ // Initialize TaskMaster+ const taskMaster = initTaskMaster({+ complexityReportPath: options.file || true+ });// Use the provided tag, or the current active tag, or default to 'master'- const targetTag = options.tag || getCurrentTag(projectRoot) || 'master';+ const targetTag =+ options.tag || getCurrentTag(taskMaster.getProjectRoot()) || 'master';// Show current tag contextdisplayCurrentTagIndicator(targetTag);// Tag-aware report file naming: master -> task-complexity-report.json, other tags -> task-complexity-report_tagname.json+ const baseReportPath = taskMaster.getComplexityReportPath();const reportPath =options.file === COMPLEXITY_REPORT_FILE && targetTag !== 'master'- ? options.file.replace('.json', `_${targetTag}.json`)- : options.file || COMPLEXITY_REPORT_FILE;+ ? baseReportPath.replace('.json', `_${targetTag}.json`)+ : baseReportPath;await displayComplexityReport(reportPath);});@@ -2609,19 +2607,18 @@ ${result.result}.option('--skip-generate', 'Skip regenerating task files').option('--tag <tag>', 'Specify tag context for task operations').action(async (options) => {- const projectRoot = findProjectRoot();- if (!projectRoot) {- console.error(chalk.red('Error: Could not find project root.'));- process.exit(1);- }+ // Initialize TaskMaster+ const taskMaster = initTaskMaster({+ tasksPath: options.file || true+ });- const tasksPath = options.file || TASKMASTER_TASKS_FILE;const parentId = options.parent;const existingTaskId = options.taskId;const generateFiles = !options.skipGenerate;// Resolve tag using standard pattern- const tag = options.tag || getCurrentTag(projectRoot) || 'master';+ const tag =+ options.tag || getCurrentTag(taskMaster.getProjectRoot()) || 'master';// Show current tag contextdisplayCurrentTagIndicator(tag);@@ -2654,12 +2651,12 @@ ${result.result}));await addSubtask(- tasksPath,+ taskMaster.getTasksPath(),parentId,existingTaskId,null,generateFiles,- { projectRoot, tag }+ { projectRoot: taskMaster.getProjectRoot(), tag });console.log(chalk.green(@@ -2681,12 +2678,12 @@ ${result.result}};const subtask = await addSubtask(- tasksPath,+ taskMaster.getTasksPath(),parentId,null,newSubtaskData,generateFiles,- { projectRoot, tag }+ { projectRoot: taskMaster.getProjectRoot(), tag });console.log(chalk.green(@@ -2794,18 +2791,16 @@ ${result.result}.option('--skip-generate', 'Skip regenerating task files').option('--tag <tag>', 'Specify tag context for task operations').action(async (options) => {- const tasksPath = options.file || TASKMASTER_TASKS_FILE;+ // Initialize TaskMaster+ const taskMaster = initTaskMaster({+ tasksPath: options.file || true+ });+const subtaskIds = options.id;const convertToTask = options.convert || false;const generateFiles = !options.skipGenerate;const tag = options.tag;- const projectRoot = findProjectRoot();- if (!projectRoot) {- console.error(chalk.red('Error: Could not find project root.'));- process.exit(1);- }-if (!subtaskIds) {console.error(chalk.red(@@ -2840,11 +2835,11 @@ ${result.result}}const result = await removeSubtask(- tasksPath,+ taskMaster.getTasksPath(),subtaskId,convertToTask,generateFiles,- { projectRoot, tag }+ { projectRoot: taskMaster.getProjectRoot(), tag });if (convertToTask && result) {@@ -3097,17 +3092,16 @@ ${result.result}.option('-y, --yes', 'Skip confirmation prompt', false).option('--tag <tag>', 'Specify tag context for task operations').action(async (options) => {- const tasksPath = options.file || TASKMASTER_TASKS_FILE;- const taskIdsString = options.id;+ // Initialize TaskMaster+ const taskMaster = initTaskMaster({+ tasksPath: options.file || true+ });- const projectRoot = findProjectRoot();- if (!projectRoot) {- console.error(chalk.red('Error: Could not find project root.'));- process.exit(1);- }+ const taskIdsString = options.id;// Resolve tag using standard pattern- const tag = options.tag || getCurrentTag(projectRoot) || 'master';+ const tag =+ options.tag || getCurrentTag(taskMaster.getProjectRoot()) || 'master';// Show current tag contextdisplayCurrentTagIndicator(tag);@@ -3134,7 +3128,11 @@ ${result.result}try {// Read data once for checks and confirmation- const data = readJSON(tasksPath, projectRoot, tag);+ const data = readJSON(+ taskMaster.getTasksPath(),+ taskMaster.getProjectRoot(),+ tag+ );if (!data || !data.tasks) {console.error(chalk.red(`Error: No valid tasks found in ${tasksPath}`)@@ -3274,10 +3272,14 @@ ${result.result}const existingIdsString = existingTasksToRemove.map(({ id }) => id).join(',');- const result = await removeTask(tasksPath, existingIdsString, {- projectRoot,- tag- });+ const result = await removeTask(+ taskMaster.getTasksPath(),+ existingIdsString,+ {+ projectRoot: taskMaster.getProjectRoot(),+ tag+ }+ );stopLoadingIndicator(indicator);@@ -3450,11 +3452,10 @@ Examples:$ task-master models --setup # Run interactive setup`).action(async (options) => {- const projectRoot = findProjectRoot();- if (!projectRoot) {- console.error(chalk.red('Error: Could not find project root.'));- process.exit(1);- }+ // Initialize TaskMaster+ const taskMaster = initTaskMaster({+ tasksPath: options.file || true+ });// Validate flags: cannot use multiple provider flags simultaneouslyconst providerFlags = [options.openrouter,@@ -3669,7 +3670,8 @@ Examples:.option('--response <response_language>', 'Set the response language').option('--setup', 'Run interactive setup to configure response language').action(async (options) => {- const projectRoot = findProjectRoot(); // Find project root for context+ const taskMaster = initTaskMaster({});+ const projectRoot = taskMaster.getProjectRoot(); // Find project root for contextconst { response, setup } = options;console.log(chalk.blue('Response language set to:', JSON.stringify(options))@@ -3738,7 +3740,11 @@ Examples:).option('--tag <tag>', 'Specify tag context for task operations').action(async (options) => {- const tasksPath = options.file || TASKMASTER_TASKS_FILE;+ // Initialize TaskMaster+ const taskMaster = initTaskMaster({+ tasksPath: options.file || true+ });+const sourceId = options.from;const destinationId = options.to;const tag = options.tag;@@ -3755,13 +3761,6 @@ Examples:process.exit(1);}- // Find project root for tag resolution- const projectRoot = findProjectRoot();- if (!projectRoot) {- console.error(chalk.red('Error: Could not find project root.'));- process.exit(1);- }-// Check if we're moving multiple tasks (comma-separated IDs)const sourceIds = sourceId.split(',').map((id) => id.trim());const destinationIds = destinationId.split(',').map((id) => id.trim());@@ -3789,7 +3788,11 @@ Examples:try {// Read tasks data once to validate destination IDs- const tasksData = readJSON(tasksPath, projectRoot, tag);+ const tasksData = readJSON(+ taskMaster.getTasksPath(),+ taskMaster.getProjectRoot(),+ tag+ );if (!tasksData || !tasksData.tasks) {console.error(chalk.red(`Error: Invalid or missing tasks file at ${tasksPath}`)@@ -3815,11 +3818,11 @@ Examples:);try {await moveTask(- tasksPath,+ taskMaster.getTasksPath(),fromId,toId,i === sourceIds.length - 1,- { projectRoot, tag }+ { projectRoot: taskMaster.getProjectRoot(), tag });console.log(chalk.green(@@ -3845,11 +3848,11 @@ Examples:try {const result = await moveTask(- tasksPath,+ taskMaster.getTasksPath(),sourceId,destinationId,true,- { projectRoot, tag }+ { projectRoot: taskMaster.getProjectRoot(), tag });console.log(chalk.green(@@ -3886,7 +3889,8 @@ Examples:$ task-master rules --${RULES_SETUP_ACTION} # Interactive setup to select rule profiles`).action(async (action, profiles, options) => {- const projectRoot = findProjectRoot();+ const taskMaster = initTaskMaster({});+ const projectRoot = taskMaster.getProjectRoot();if (!projectRoot) {console.error(chalk.red('Error: Could not find project root.'));process.exit(1);@@ -4186,31 +4190,24 @@ Examples:'Show only tasks matching this status (e.g., pending, done)').action(async (options) => {- const tasksPath = options.file || TASKMASTER_TASKS_FILE;+ // Initialize TaskMaster+ const taskMaster = initTaskMaster({+ tasksPath: options.file || true+ });+const withSubtasks = options.withSubtasks || false;const status = options.status || null;- // Find project root- const projectRoot = findProjectRoot();- if (!projectRoot) {- console.error(- chalk.red(- 'Error: Could not find project root. Make sure you are in a Task Master project directory.'- )- );- process.exit(1);- }-console.log(chalk.blue(`📝 Syncing tasks to README.md${withSubtasks ? ' (with subtasks)' : ''}${status ? ` (status: ${status})` : ''}...`));- const success = await syncTasksToReadme(projectRoot, {+ const success = await syncTasksToReadme(taskMaster.getProjectRoot(), {withSubtasks,status,- tasksPath+ tasksPath: taskMaster.getTasksPath()});if (!success) {@@ -4249,13 +4246,10 @@ Examples:.option('-d, --description <text>', 'Optional description for the tag').action(async (tagName, options) => {try {- const projectRoot = findProjectRoot();- if (!projectRoot) {- console.error(chalk.red('Error: Could not find project root.'));- process.exit(1);- }-- const tasksPath = path.resolve(projectRoot, options.file);+ // Initialize TaskMaster+ const taskMaster = initTaskMaster({+ tasksPath: options.file || true+ });// Validate tasks file existsif (!fs.existsSync(tasksPath)) {@@ -4284,7 +4278,7 @@ Examples:}const context = {- projectRoot,+ projectRoot: taskMaster.getProjectRoot(),commandName: 'add-tag',outputType: 'cli'};@@ -4339,7 +4333,13 @@ Examples:description: options.description};- await createTag(tasksPath, tagName, createOptions, context, 'text');+ await createTag(+ taskMaster.getTasksPath(),+ tagName,+ createOptions,+ context,+ 'text'+ );}// Handle auto-switch if requested@@ -4352,7 +4352,13 @@ Examples:)): tagName;- await useTag(tasksPath, finalTagName, {}, context, 'text');+ await useTag(+ taskMaster.getTasksPath(),+ finalTagName,+ {},+ context,+ 'text'+ );}} catch (error) {console.error(chalk.red(`Error creating tag: ${error.message}`));@@ -4379,13 +4385,10 @@ Examples:.option('-y, --yes', 'Skip confirmation prompts').action(async (tagName, options) => {try {- const projectRoot = findProjectRoot();- if (!projectRoot) {- console.error(chalk.red('Error: Could not find project root.'));- process.exit(1);- }-- const tasksPath = path.resolve(projectRoot, options.file);+ // Initialize TaskMaster+ const taskMaster = initTaskMaster({+ tasksPath: options.file || true+ });// Validate tasks file existsif (!fs.existsSync(tasksPath)) {@@ -4400,12 +4403,18 @@ Examples:};const context = {- projectRoot,+ projectRoot: taskMaster.getProjectRoot(),commandName: 'delete-tag',outputType: 'cli'};- await deleteTag(tasksPath, tagName, deleteOptions, context, 'text');+ await deleteTag(+ taskMaster.getTasksPath(),+ tagName,+ deleteOptions,+ context,+ 'text'+ );} catch (error) {console.error(chalk.red(`Error deleting tag: ${error.message}`));showDeleteTagHelp();@@ -4430,13 +4439,10 @@ Examples:.option('--show-metadata', 'Show detailed metadata for each tag').action(async (options) => {try {- const projectRoot = findProjectRoot();- if (!projectRoot) {- console.error(chalk.red('Error: Could not find project root.'));- process.exit(1);- }-- const tasksPath = path.resolve(projectRoot, options.file);+ // Initialize TaskMaster+ const taskMaster = initTaskMaster({+ tasksPath: options.file || true+ });// Validate tasks file existsif (!fs.existsSync(tasksPath)) {@@ -4452,12 +4458,12 @@ Examples:};const context = {- projectRoot,+ projectRoot: taskMaster.getProjectRoot(),commandName: 'tags',outputType: 'cli'};- await tags(tasksPath, listOptions, context, 'text');+ await tags(taskMaster.getTasksPath(), listOptions, context, 'text');} catch (error) {console.error(chalk.red(`Error listing tags: ${error.message}`));showTagsHelp();@@ -4482,13 +4488,10 @@ Examples:).action(async (tagName, options) => {try {- const projectRoot = findProjectRoot();- if (!projectRoot) {- console.error(chalk.red('Error: Could not find project root.'));- process.exit(1);- }-- const tasksPath = path.resolve(projectRoot, options.file);+ // Initialize TaskMaster+ const taskMaster = initTaskMaster({+ tasksPath: options.file || true+ });// Validate tasks file existsif (!fs.existsSync(tasksPath)) {@@ -4499,12 +4502,12 @@ Examples:}const context = {- projectRoot,+ projectRoot: taskMaster.getProjectRoot(),commandName: 'use-tag',outputType: 'cli'};- await useTag(tasksPath, tagName, {}, context, 'text');+ await useTag(taskMaster.getTasksPath(), tagName, {}, context, 'text');} catch (error) {console.error(chalk.red(`Error switching tag: ${error.message}`));showUseTagHelp();@@ -4530,13 +4533,10 @@ Examples:).action(async (oldName, newName, options) => {try {- const projectRoot = findProjectRoot();- if (!projectRoot) {- console.error(chalk.red('Error: Could not find project root.'));- process.exit(1);- }-- const tasksPath = path.resolve(projectRoot, options.file);+ // Initialize TaskMaster+ const taskMaster = initTaskMaster({+ tasksPath: options.file || true+ });// Validate tasks file existsif (!fs.existsSync(tasksPath)) {@@ -4547,12 +4547,19 @@ Examples:}const context = {- projectRoot,+ projectRoot: taskMaster.getProjectRoot(),commandName: 'rename-tag',outputType: 'cli'};- await renameTag(tasksPath, oldName, newName, {}, context, 'text');+ await renameTag(+ taskMaster.getTasksPath(),+ oldName,+ newName,+ {},+ context,+ 'text'+ );} catch (error) {console.error(chalk.red(`Error renaming tag: ${error.message}`));process.exit(1);@@ -4577,13 +4584,10 @@ Examples:.option('-d, --description <text>', 'Optional description for the new tag').action(async (sourceName, targetName, options) => {try {- const projectRoot = findProjectRoot();- if (!projectRoot) {- console.error(chalk.red('Error: Could not find project root.'));- process.exit(1);- }-- const tasksPath = path.resolve(projectRoot, options.file);+ // Initialize TaskMaster+ const taskMaster = initTaskMaster({+ tasksPath: options.file || true+ });// Validate tasks file existsif (!fs.existsSync(tasksPath)) {@@ -4598,13 +4602,13 @@ Examples:};const context = {- projectRoot,+ projectRoot: taskMaster.getProjectRoot(),commandName: 'copy-tag',outputType: 'cli'};await copyTag(- tasksPath,+ taskMaster.getTasksPath(),sourceName,targetName,copyOptions,@@ -4827,16 +4831,13 @@ async function runCLI(argv = process.argv) {// Check if migration has occurred and show FYI notice oncetry {- const projectRoot = findProjectRoot() || '.';- const tasksPath = path.join(- projectRoot,- '.taskmaster',- 'tasks',- 'tasks.json'- );- const statePath = path.join(projectRoot, '.taskmaster', 'state.json');+ // Use initTaskMaster with no required fields - will only fail if no project root+ const taskMaster = initTaskMaster({});- if (fs.existsSync(tasksPath)) {+ const tasksPath = taskMaster.getTasksPath();+ const statePath = taskMaster.getStatePath();++ if (tasksPath && fs.existsSync(tasksPath)) {// Read raw file to check if it has master key (bypassing tag resolution)const rawData = fs.readFileSync(tasksPath, 'utf8');const parsedData = JSON.parse(rawData);@@ -4844,7 +4845,7 @@ async function runCLI(argv = process.argv) {if (parsedData && parsedData.master) {// Migration has occurred, check if we've shown the noticelet stateData = { migrationNoticeShown: false };- if (fs.existsSync(statePath)) {+ if (statePath && fs.existsSync(statePath)) {// Read state.json directly without tag resolution since it's not a tagged fileconst rawStateData = fs.readFileSync(statePath, 'utf8');stateData = JSON.parse(rawStateData) || stateData;@@ -4856,7 +4857,9 @@ async function runCLI(argv = process.argv) {// Mark as shownstateData.migrationNoticeShown = true;// Write state.json directly without tag resolution since it's not a tagged file- fs.writeFileSync(statePath, JSON.stringify(stateData, null, 2));+ if (statePath) {+ fs.writeFileSync(statePath, JSON.stringify(stateData, null, 2));+ }}}}diff --git a/src/task-master.js b/src/task-master.jsnew file mode 100644index 00000000..71eefb0e--- /dev/null+++ b/src/task-master.js@@ -0,0 +1,288 @@+/**+ * task-master.js+ * This module provides a centralized path management system for the Task Master application.+ * It exports the TaskMaster class and the initTaskMaster factory function to create a single,+ * authoritative source for all critical file and directory paths, resolving circular dependencies.+ */++import path from 'path';+import fs from 'fs';+import {+ TASKMASTER_DIR,+ TASKMASTER_TASKS_FILE,+ LEGACY_TASKS_FILE,+ TASKMASTER_DOCS_DIR,+ TASKMASTER_REPORTS_DIR,+ TASKMASTER_CONFIG_FILE,+ LEGACY_CONFIG_FILE+} from './constants/paths.js';++/**+ * TaskMaster class manages all the paths for the application.+ * An instance of this class is created by the initTaskMaster function.+ */+export class TaskMaster {+ #paths;++ /**+ * The constructor is intended to be used only by the initTaskMaster factory function.+ * @param {object} paths - A pre-resolved object of all application paths.+ */+ constructor(paths) {+ this.#paths = Object.freeze({ ...paths });+ }++ /**+ * @returns {string|null} The absolute path to the project root.+ */+ getProjectRoot() {+ return this.#paths.projectRoot;+ }++ /**+ * @returns {string|null} The absolute path to the .taskmaster directory.+ */+ getTaskMasterDir() {+ return this.#paths.taskMasterDir;+ }++ /**+ * @returns {string|null} The absolute path to the tasks.json file.+ */+ getTasksPath() {+ return this.#paths.tasksPath;+ }++ /**+ * @returns {string|null} The absolute path to the PRD file.+ */+ getPrdPath() {+ return this.#paths.prdPath;+ }++ /**+ * @returns {string|null} The absolute path to the complexity report.+ */+ getComplexityReportPath() {+ return this.#paths.complexityReportPath;+ }++ /**+ * @returns {string|null} The absolute path to the config.json file.+ */+ getConfigPath() {+ return this.#paths.configPath;+ }++ /**+ * @returns {string|null} The absolute path to the state.json file.+ */+ getStatePath() {+ return this.#paths.statePath;+ }++ /**+ * @returns {object} A frozen object containing all resolved paths.+ */+ getAllPaths() {+ return this.#paths;+ }+}++/**+ * Initializes a TaskMaster instance with resolved paths.+ * This function centralizes path resolution logic.+ *+ * @param {object} [overrides={}] - An object with possible path overrides.+ * @param {string} [overrides.projectRoot]+ * @param {string} [overrides.tasksPath]+ * @param {string} [overrides.prdPath]+ * @param {string} [overrides.complexityReportPath]+ * @param {string} [overrides.configPath]+ * @param {string} [overrides.statePath]+ * @returns {TaskMaster} An initialized TaskMaster instance.+ */+export function initTaskMaster(overrides = {}) {+ const findProjectRoot = (startDir = process.cwd()) => {+ const projectMarkers = [TASKMASTER_DIR, LEGACY_CONFIG_FILE];+ let currentDir = path.resolve(startDir);+ const rootDir = path.parse(currentDir).root;+ while (currentDir !== rootDir) {+ for (const marker of projectMarkers) {+ const markerPath = path.join(currentDir, marker);+ if (fs.existsSync(markerPath)) {+ return currentDir;+ }+ }+ currentDir = path.dirname(currentDir);+ }+ return null;+ };++ const resolvePath = (+ pathType,+ override,+ defaultPaths = [],+ basePath = null+ ) => {+ if (typeof override === 'string') {+ const resolvedPath = path.isAbsolute(override)+ ? override+ : path.resolve(basePath || process.cwd(), override);++ if (!fs.existsSync(resolvedPath)) {+ throw new Error(+ `${pathType} override path does not exist: ${resolvedPath}`+ );+ }+ return resolvedPath;+ }++ if (override === true) {+ // Required path - search defaults and fail if not found+ for (const defaultPath of defaultPaths) {+ const fullPath = path.isAbsolute(defaultPath)+ ? defaultPath+ : path.join(basePath || process.cwd(), defaultPath);+ if (fs.existsSync(fullPath)) {+ return fullPath;+ }+ }+ throw new Error(+ `Required ${pathType} not found. Searched: ${defaultPaths.join(', ')}`+ );+ }++ // Optional path (override === false/undefined) - search defaults, return null if not found+ for (const defaultPath of defaultPaths) {+ const fullPath = path.isAbsolute(defaultPath)+ ? defaultPath+ : path.join(basePath || process.cwd(), defaultPath);+ if (fs.existsSync(fullPath)) {+ return fullPath;+ }+ }++ return null;+ };++ const paths = {};++ // Project Root+ if (overrides.projectRoot) {+ const resolvedOverride = path.resolve(overrides.projectRoot);+ if (!fs.existsSync(resolvedOverride)) {+ throw new Error(+ `Project root override path does not exist: ${resolvedOverride}`+ );+ }++ const hasTaskmasterDir = fs.existsSync(+ path.join(resolvedOverride, TASKMASTER_DIR)+ );+ const hasLegacyConfig = fs.existsSync(+ path.join(resolvedOverride, LEGACY_CONFIG_FILE)+ );++ if (!hasTaskmasterDir && !hasLegacyConfig) {+ throw new Error(+ `Project root override is not a valid taskmaster project: ${resolvedOverride}`+ );+ }++ paths.projectRoot = resolvedOverride;+ } else {+ const foundRoot = findProjectRoot();+ if (!foundRoot) {+ throw new Error(+ 'Unable to find project root. No project markers found. Run "init" command first.'+ );+ }+ paths.projectRoot = foundRoot;+ }++ // TaskMaster Directory+ if ('taskMasterDir' in overrides) {+ paths.taskMasterDir = resolvePath(+ 'taskmaster directory',+ overrides.taskMasterDir,+ [TASKMASTER_DIR],+ paths.projectRoot+ );+ } else {+ paths.taskMasterDir = resolvePath(+ 'taskmaster directory',+ false,+ [TASKMASTER_DIR],+ paths.projectRoot+ );+ }++ // Remaining paths - only resolve if key exists in overrides+ if ('configPath' in overrides) {+ paths.configPath = resolvePath(+ 'config file',+ overrides.configPath,+ [TASKMASTER_CONFIG_FILE, LEGACY_CONFIG_FILE],+ paths.projectRoot+ );+ }++ if ('statePath' in overrides) {+ paths.statePath = resolvePath(+ 'state file',+ overrides.statePath,+ ['state.json'],+ paths.taskMasterDir+ );+ }++ if ('tasksPath' in overrides) {+ paths.tasksPath = resolvePath(+ 'tasks file',+ overrides.tasksPath,+ [TASKMASTER_TASKS_FILE, LEGACY_TASKS_FILE],+ paths.projectRoot+ );+ }++ if ('prdPath' in overrides) {+ paths.prdPath = resolvePath(+ 'PRD file',+ overrides.prdPath,+ [+ path.join(TASKMASTER_DOCS_DIR, 'PRD.md'),+ path.join(TASKMASTER_DOCS_DIR, 'prd.md'),+ path.join(TASKMASTER_DOCS_DIR, 'PRD.txt'),+ path.join(TASKMASTER_DOCS_DIR, 'prd.txt'),+ path.join('scripts', 'PRD.md'),+ path.join('scripts', 'prd.md'),+ path.join('scripts', 'PRD.txt'),+ path.join('scripts', 'prd.txt'),+ 'PRD.md',+ 'prd.md',+ 'PRD.txt',+ 'prd.txt'+ ],+ paths.projectRoot+ );+ }++ if ('complexityReportPath' in overrides) {+ paths.complexityReportPath = resolvePath(+ 'complexity report',+ overrides.complexityReportPath,+ [+ path.join(TASKMASTER_REPORTS_DIR, 'task-complexity-report.json'),+ path.join(TASKMASTER_REPORTS_DIR, 'complexity-report.json'),+ path.join('scripts', 'task-complexity-report.json'),+ path.join('scripts', 'complexity-report.json'),+ 'task-complexity-report.json',+ 'complexity-report.json'+ ],+ paths.projectRoot+ );+ }++ return new TaskMaster(paths);+}diff --git a/tests/unit/task-master.test.js b/tests/unit/task-master.test.jsnew file mode 100644index 00000000..26067d12--- /dev/null+++ b/tests/unit/task-master.test.js@@ -0,0 +1,425 @@+/**+ * Tests for task-master.js initTaskMaster function+ */++import { jest } from '@jest/globals';+import path from 'path';+import fs from 'fs';+import os from 'os';+import { initTaskMaster, TaskMaster } from '../../src/task-master.js';+import {+ TASKMASTER_DIR,+ TASKMASTER_TASKS_FILE,+ LEGACY_CONFIG_FILE,+ TASKMASTER_CONFIG_FILE,+ LEGACY_TASKS_FILE+} from '../../src/constants/paths.js';++// Mock the console to prevent noise during tests+jest.spyOn(console, 'error').mockImplementation(() => {});++describe('initTaskMaster', () => {+ let tempDir;+ let originalCwd;++ beforeEach(() => {+ // Create a temporary directory for testing+ tempDir = fs.realpathSync(+ fs.mkdtempSync(path.join(os.tmpdir(), 'taskmaster-test-'))+ );+ originalCwd = process.cwd();++ // Clear all mocks+ jest.clearAllMocks();+ });++ afterEach(() => {+ // Restore original working directory+ process.chdir(originalCwd);++ // Clean up temporary directory+ if (fs.existsSync(tempDir)) {+ fs.rmSync(tempDir, { recursive: true, force: true });+ }+ });++ describe('Project root detection', () => {+ test('should find project root when .taskmaster directory exists', () => {+ // Arrange - Create .taskmaster directory in temp dir+ const taskMasterDir = path.join(tempDir, TASKMASTER_DIR);+ fs.mkdirSync(taskMasterDir, { recursive: true });++ // Change to temp directory+ process.chdir(tempDir);++ // Act+ const taskMaster = initTaskMaster({});++ // Assert+ expect(taskMaster.getProjectRoot()).toBe(tempDir);+ expect(taskMaster).toBeInstanceOf(TaskMaster);+ });++ test('should find project root when legacy config file exists', () => {+ // Arrange - Create legacy config file in temp dir+ const legacyConfigPath = path.join(tempDir, LEGACY_CONFIG_FILE);+ fs.writeFileSync(legacyConfigPath, '{}');++ // Change to temp directory+ process.chdir(tempDir);++ // Act+ const taskMaster = initTaskMaster({});++ // Assert+ expect(taskMaster.getProjectRoot()).toBe(tempDir);+ });++ test('should find project root from subdirectory', () => {+ // Arrange - Create .taskmaster directory in temp dir+ const taskMasterDir = path.join(tempDir, TASKMASTER_DIR);+ fs.mkdirSync(taskMasterDir, { recursive: true });++ // Create a subdirectory and change to it+ const srcDir = path.join(tempDir, 'src');+ fs.mkdirSync(srcDir, { recursive: true });+ process.chdir(srcDir);++ // Act+ const taskMaster = initTaskMaster({});++ // Assert+ expect(taskMaster.getProjectRoot()).toBe(tempDir);+ });++ test('should find project root from deeply nested subdirectory', () => {+ // Arrange - Create .taskmaster directory in temp dir+ const taskMasterDir = path.join(tempDir, TASKMASTER_DIR);+ fs.mkdirSync(taskMasterDir, { recursive: true });++ // Create deeply nested subdirectory and change to it+ const deepDir = path.join(tempDir, 'src', 'components', 'ui');+ fs.mkdirSync(deepDir, { recursive: true });+ process.chdir(deepDir);++ // Act+ const taskMaster = initTaskMaster({});++ // Assert+ expect(taskMaster.getProjectRoot()).toBe(tempDir);+ });++ test('should throw error when no project markers found', () => {+ // Arrange - Empty temp directory, no project markers+ process.chdir(tempDir);++ // Act & Assert+ expect(() => {+ initTaskMaster({});+ }).toThrow(+ 'Unable to find project root. No project markers found. Run "init" command first.'+ );+ });+ });++ describe('Project root override validation', () => {+ test('should accept valid project root override with .taskmaster directory', () => {+ // Arrange - Create .taskmaster directory in temp dir+ const taskMasterDir = path.join(tempDir, TASKMASTER_DIR);+ fs.mkdirSync(taskMasterDir, { recursive: true });++ // Act+ const taskMaster = initTaskMaster({ projectRoot: tempDir });++ // Assert+ expect(taskMaster.getProjectRoot()).toBe(tempDir);+ });++ test('should accept valid project root override with legacy config', () => {+ // Arrange - Create legacy config file in temp dir+ const legacyConfigPath = path.join(tempDir, LEGACY_CONFIG_FILE);+ fs.writeFileSync(legacyConfigPath, '{}');++ // Act+ const taskMaster = initTaskMaster({ projectRoot: tempDir });++ // Assert+ expect(taskMaster.getProjectRoot()).toBe(tempDir);+ });++ test('should throw error when project root override does not exist', () => {+ // Arrange - Non-existent path+ const nonExistentPath = path.join(tempDir, 'does-not-exist');++ // Act & Assert+ expect(() => {+ initTaskMaster({ projectRoot: nonExistentPath });+ }).toThrow(+ `Project root override path does not exist: ${nonExistentPath}`+ );+ });++ test('should throw error when project root override has no project markers', () => {+ // Arrange - Empty temp directory (no project markers)++ // Act & Assert+ expect(() => {+ initTaskMaster({ projectRoot: tempDir });+ }).toThrow(+ `Project root override is not a valid taskmaster project: ${tempDir}`+ );+ });++ test('should resolve relative project root override', () => {+ // Arrange - Create .taskmaster directory in temp dir+ const taskMasterDir = path.join(tempDir, TASKMASTER_DIR);+ fs.mkdirSync(taskMasterDir, { recursive: true });++ // Create subdirectory and change to it+ const srcDir = path.join(tempDir, 'src');+ fs.mkdirSync(srcDir, { recursive: true });+ process.chdir(srcDir);++ // Act - Use relative path '../' to go back to project root+ const taskMaster = initTaskMaster({ projectRoot: '../' });++ // Assert+ expect(taskMaster.getProjectRoot()).toBe(tempDir);+ });+ });++ describe('Path resolution with boolean logic', () => {+ let taskMasterDir, tasksPath, configPath, statePath;++ beforeEach(() => {+ // Setup a valid project structure+ taskMasterDir = path.join(tempDir, TASKMASTER_DIR);+ fs.mkdirSync(taskMasterDir, { recursive: true });++ tasksPath = path.join(tempDir, TASKMASTER_TASKS_FILE);+ fs.mkdirSync(path.dirname(tasksPath), { recursive: true });+ fs.writeFileSync(tasksPath, '[]');++ configPath = path.join(tempDir, TASKMASTER_CONFIG_FILE);+ fs.writeFileSync(configPath, '{}');++ statePath = path.join(taskMasterDir, 'state.json');+ fs.writeFileSync(statePath, '{}');++ process.chdir(tempDir);+ });++ test('should return paths when required (true) and files exist', () => {+ // Act+ const taskMaster = initTaskMaster({+ tasksPath: true,+ configPath: true,+ statePath: true+ });++ // Assert+ expect(taskMaster.getTasksPath()).toBe(tasksPath);+ expect(taskMaster.getConfigPath()).toBe(configPath);+ expect(taskMaster.getStatePath()).toBe(statePath);+ });++ test('should throw error when required (true) files do not exist', () => {+ // Arrange - Remove tasks file+ fs.unlinkSync(tasksPath);++ // Act & Assert+ expect(() => {+ initTaskMaster({ tasksPath: true });+ }).toThrow(+ 'Required tasks file not found. Searched: .taskmaster/tasks/tasks.json, tasks/tasks.json'+ );+ });++ test('should return null when optional (false/undefined) files do not exist', () => {+ // Arrange - Remove tasks file+ fs.unlinkSync(tasksPath);++ // Act+ const taskMaster = initTaskMaster({+ tasksPath: false+ });++ // Assert+ expect(taskMaster.getTasksPath()).toBeNull();+ });++ test('should return null when optional files not specified in overrides', () => {+ // Arrange - Remove all optional files+ fs.unlinkSync(tasksPath);+ fs.unlinkSync(configPath);+ fs.unlinkSync(statePath);++ // Act - Don't specify any optional paths+ const taskMaster = initTaskMaster({});++ // Assert+ expect(taskMaster.getTasksPath()).toBeUndefined();+ expect(taskMaster.getConfigPath()).toBeUndefined();+ expect(taskMaster.getStatePath()).toBeUndefined();+ });+ });++ describe('String path overrides', () => {+ let taskMasterDir;++ beforeEach(() => {+ taskMasterDir = path.join(tempDir, TASKMASTER_DIR);+ fs.mkdirSync(taskMasterDir, { recursive: true });+ process.chdir(tempDir);+ });++ test('should accept valid absolute path override', () => {+ // Arrange - Create custom tasks file+ const customTasksPath = path.join(tempDir, 'custom-tasks.json');+ fs.writeFileSync(customTasksPath, '[]');++ // Act+ const taskMaster = initTaskMaster({+ tasksPath: customTasksPath+ });++ // Assert+ expect(taskMaster.getTasksPath()).toBe(customTasksPath);+ });++ test('should accept valid relative path override', () => {+ // Arrange - Create custom tasks file+ const customTasksPath = path.join(tempDir, 'custom-tasks.json');+ fs.writeFileSync(customTasksPath, '[]');++ // Act+ const taskMaster = initTaskMaster({+ tasksPath: './custom-tasks.json'+ });++ // Assert+ expect(taskMaster.getTasksPath()).toBe(customTasksPath);+ });++ test('should throw error when string path override does not exist', () => {+ // Arrange - Non-existent file path+ const nonExistentPath = path.join(tempDir, 'does-not-exist.json');++ // Act & Assert+ expect(() => {+ initTaskMaster({ tasksPath: nonExistentPath });+ }).toThrow(`tasks file override path does not exist: ${nonExistentPath}`);+ });+ });++ describe('Legacy file support', () => {+ beforeEach(() => {+ // Setup basic project structure+ const taskMasterDir = path.join(tempDir, TASKMASTER_DIR);+ fs.mkdirSync(taskMasterDir, { recursive: true });+ process.chdir(tempDir);+ });++ test('should find legacy tasks file when new format does not exist', () => {+ // Arrange - Create legacy tasks file+ const legacyTasksDir = path.join(tempDir, 'tasks');+ fs.mkdirSync(legacyTasksDir, { recursive: true });+ const legacyTasksPath = path.join(tempDir, LEGACY_TASKS_FILE);+ fs.writeFileSync(legacyTasksPath, '[]');++ // Act+ const taskMaster = initTaskMaster({ tasksPath: true });++ // Assert+ expect(taskMaster.getTasksPath()).toBe(legacyTasksPath);+ });++ test('should prefer new format over legacy when both exist', () => {+ // Arrange - Create both new and legacy files+ const newTasksPath = path.join(tempDir, TASKMASTER_TASKS_FILE);+ fs.mkdirSync(path.dirname(newTasksPath), { recursive: true });+ fs.writeFileSync(newTasksPath, '[]');++ const legacyTasksDir = path.join(tempDir, 'tasks');+ fs.mkdirSync(legacyTasksDir, { recursive: true });+ const legacyTasksPath = path.join(tempDir, LEGACY_TASKS_FILE);+ fs.writeFileSync(legacyTasksPath, '[]');++ // Act+ const taskMaster = initTaskMaster({ tasksPath: true });++ // Assert+ expect(taskMaster.getTasksPath()).toBe(newTasksPath);+ });++ test('should find legacy config file when new format does not exist', () => {+ // Arrange - Create legacy config file+ const legacyConfigPath = path.join(tempDir, LEGACY_CONFIG_FILE);+ fs.writeFileSync(legacyConfigPath, '{}');++ // Act+ const taskMaster = initTaskMaster({ configPath: true });++ // Assert+ expect(taskMaster.getConfigPath()).toBe(legacyConfigPath);+ });+ });++ describe('TaskMaster class methods', () => {+ test('should return all paths via getAllPaths method', () => {+ // Arrange - Setup project with all files+ const taskMasterDir = path.join(tempDir, TASKMASTER_DIR);+ fs.mkdirSync(taskMasterDir, { recursive: true });++ const tasksPath = path.join(tempDir, TASKMASTER_TASKS_FILE);+ fs.mkdirSync(path.dirname(tasksPath), { recursive: true });+ fs.writeFileSync(tasksPath, '[]');++ const configPath = path.join(tempDir, TASKMASTER_CONFIG_FILE);+ fs.writeFileSync(configPath, '{}');++ process.chdir(tempDir);++ // Act+ const taskMaster = initTaskMaster({+ tasksPath: true,+ configPath: true+ });++ // Assert+ const allPaths = taskMaster.getAllPaths();+ expect(allPaths).toEqual(+ expect.objectContaining({+ projectRoot: tempDir,+ taskMasterDir: taskMasterDir,+ tasksPath: tasksPath,+ configPath: configPath+ })+ );++ // Verify paths object is frozen+ expect(() => {+ allPaths.projectRoot = '/different/path';+ }).toThrow();+ });++ test('should return correct individual paths', () => {+ // Arrange+ const taskMasterDir = path.join(tempDir, TASKMASTER_DIR);+ fs.mkdirSync(taskMasterDir, { recursive: true });+ process.chdir(tempDir);++ // Act+ const taskMaster = initTaskMaster({});++ // Assert+ expect(taskMaster.getProjectRoot()).toBe(tempDir);+ expect(taskMaster.getTaskMasterDir()).toBe(taskMasterDir);+ expect(taskMaster.getTasksPath()).toBeUndefined();+ expect(taskMaster.getPrdPath()).toBeUndefined();+ expect(taskMaster.getComplexityReportPath()).toBeUndefined();+ expect(taskMaster.getConfigPath()).toBeUndefined();+ expect(taskMaster.getStatePath()).toBeUndefined();+ });+ });+});