feat: adds ability to add or remove subtasks. Can also turn subtasks into standalone features. Also refactors the task-master.js by deleting 200+ lines of duplicate code. Instead properly imports the commands from commands.js which is the single source of truth for command definitions.

This commit is contained in:
Eyal Toledano
2025-03-24 21:18:49 -04:00
parent 50cbe5419e
commit a26e7adf8c
17 changed files with 1670 additions and 503 deletions

View File

@@ -11,6 +11,7 @@ import { createRequire } from 'module';
import { spawn } from 'child_process';
import { Command } from 'commander';
import { displayHelp, displayBanner } from '../scripts/modules/ui.js';
import { registerCommands } from '../scripts/modules/commands.js';
const __filename = fileURLToPath(import.meta.url);
const __dirname = dirname(__filename);
@@ -36,6 +37,80 @@ function runDevScript(args) {
});
}
/**
* Create a wrapper action that passes the command to dev.js
* @param {string} commandName - The name of the command
* @returns {Function} Wrapper action function
*/
function createDevScriptAction(commandName) {
return (options, cmd) => {
// Start with the command name
const args = [commandName];
// Handle direct arguments (non-option arguments)
if (cmd && cmd.args && cmd.args.length > 0) {
args.push(...cmd.args);
}
// Add all options
Object.entries(options).forEach(([key, value]) => {
// Skip the Command's built-in properties
if (['parent', 'commands', 'options', 'rawArgs'].includes(key)) {
return;
}
// Handle boolean flags
if (typeof value === 'boolean') {
if (value === true) {
args.push(`--${key}`);
} else if (key.startsWith('no-')) {
// Handle --no-X options
const baseOption = key.substring(3);
args.push(`--${baseOption}`);
}
} else if (value !== undefined) {
args.push(`--${key}`, value.toString());
}
});
runDevScript(args);
};
}
// Special case for the 'init' command which uses a different script
function registerInitCommand(program) {
program
.command('init')
.description('Initialize a new project')
.option('-y, --yes', 'Skip prompts and use default values')
.option('-n, --name <name>', 'Project name')
.option('-d, --description <description>', 'Project description')
.option('-v, --version <version>', 'Project version')
.option('-a, --author <author>', 'Author name')
.option('--skip-install', 'Skip installing dependencies')
.option('--dry-run', 'Show what would be done without making changes')
.action((options) => {
// Pass through any options to the init script
const args = ['--yes', 'name', 'description', 'version', 'author', 'skip-install', 'dry-run']
.filter(opt => options[opt])
.map(opt => {
if (opt === 'yes' || opt === 'skip-install' || opt === 'dry-run') {
return `--${opt}`;
}
return `--${opt}=${options[opt]}`;
});
const child = spawn('node', [initScriptPath, ...args], {
stdio: 'inherit',
cwd: process.cwd()
});
child.on('close', (code) => {
process.exit(code);
});
});
}
// Set up the command-line interface
const program = new Command();
@@ -55,36 +130,8 @@ program.on('--help', () => {
displayHelp();
});
program
.command('init')
.description('Initialize a new project')
.option('-y, --yes', 'Skip prompts and use default values')
.option('-n, --name <name>', 'Project name')
.option('-d, --description <description>', 'Project description')
.option('-v, --version <version>', 'Project version')
.option('-a, --author <author>', 'Author name')
.option('--skip-install', 'Skip installing dependencies')
.option('--dry-run', 'Show what would be done without making changes')
.action((options) => {
// Pass through any options to the init script
const args = ['--yes', 'name', 'description', 'version', 'author', 'skip-install', 'dry-run']
.filter(opt => options[opt])
.map(opt => {
if (opt === 'yes' || opt === 'skip-install' || opt === 'dry-run') {
return `--${opt}`;
}
return `--${opt}=${options[opt]}`;
});
const child = spawn('node', [initScriptPath, ...args], {
stdio: 'inherit',
cwd: process.cwd()
});
child.on('close', (code) => {
process.exit(code);
});
});
// Add special case commands
registerInitCommand(program);
program
.command('dev')
@@ -95,229 +142,34 @@ program
runDevScript(args);
});
// Add shortcuts for common dev.js commands
program
.command('list')
.description('List all tasks')
.option('-s, --status <status>', 'Filter by status')
.option('--with-subtasks', 'Show subtasks for each task')
.option('-f, --file <file>', 'Path to the tasks file', 'tasks/tasks.json')
.action((options) => {
const args = ['list'];
if (options.status) args.push('--status', options.status);
if (options.withSubtasks) args.push('--with-subtasks');
if (options.file) args.push('--file', options.file);
runDevScript(args);
});
// Use a temporary Command instance to get all command definitions
const tempProgram = new Command();
registerCommands(tempProgram);
program
.command('next')
.description('Show the next task to work on')
.option('-f, --file <file>', 'Path to the tasks file', 'tasks/tasks.json')
.action((options) => {
const args = ['next'];
if (options.file) args.push('--file', options.file);
runDevScript(args);
});
program
.command('generate')
.description('Generate task files')
.option('-f, --file <file>', 'Path to the tasks file', 'tasks/tasks.json')
.option('-o, --output <dir>', 'Output directory', 'tasks')
.action((options) => {
const args = ['generate'];
if (options.file) args.push('--file', options.file);
if (options.output) args.push('--output', options.output);
runDevScript(args);
});
// Add all other commands from dev.js
program
.command('parse-prd')
.description('Parse a PRD file and generate tasks')
.argument('[file]', 'Path to the PRD file')
.option('-o, --output <file>', 'Output file path', 'tasks/tasks.json')
.option('-n, --num-tasks <number>', 'Number of tasks to generate', '10')
.action((file, options) => {
const args = ['parse-prd'];
if (file) args.push(file);
if (options.output) args.push('--output', options.output);
if (options.numTasks) args.push('--num-tasks', options.numTasks);
runDevScript(args);
});
program
.command('update')
.description('Update tasks based on new information or implementation changes')
.option('-f, --file <file>', 'Path to the tasks file', 'tasks/tasks.json')
.option('--from <id>', 'Task ID to start updating from', '1')
.option('-p, --prompt <text>', 'Prompt explaining the changes or new context (required)')
.option('-r, --research', 'Use Perplexity AI for research-backed task updates')
.action((options) => {
const args = ['update'];
if (options.file) args.push('--file', options.file);
if (options.from) args.push('--from', options.from);
if (options.prompt) args.push('--prompt', options.prompt);
if (options.research) args.push('--research');
runDevScript(args);
});
program
.command('set-status')
.description('Set the status of a task')
.option('-i, --id <id>', 'Task ID (can be comma-separated for multiple tasks)')
.option('-s, --status <status>', 'New status (todo, in-progress, review, done)')
.option('-f, --file <file>', 'Path to the tasks file', 'tasks/tasks.json')
.action((options) => {
const args = ['set-status'];
if (options.id) args.push('--id', options.id);
if (options.status) args.push('--status', options.status);
if (options.file) args.push('--file', options.file);
runDevScript(args);
});
program
.command('expand')
.description('Break down tasks into detailed subtasks')
.option('-f, --file <file>', 'Path to the tasks file', 'tasks/tasks.json')
.option('-i, --id <id>', 'Task ID to expand')
.option('-a, --all', 'Expand all tasks')
.option('-n, --num <number>', 'Number of subtasks to generate')
.option('--research', 'Enable Perplexity AI for research-backed subtask generation')
.option('-p, --prompt <text>', 'Additional context to guide subtask generation')
.option('--force', 'Force regeneration of subtasks for tasks that already have them')
.action((options) => {
const args = ['expand'];
if (options.file) args.push('--file', options.file);
if (options.id) args.push('--id', options.id);
if (options.all) args.push('--all');
if (options.num) args.push('--num', options.num);
if (options.research) args.push('--research');
if (options.prompt) args.push('--prompt', options.prompt);
if (options.force) args.push('--force');
runDevScript(args);
});
program
.command('analyze-complexity')
.description('Analyze tasks and generate complexity-based expansion recommendations')
.option('-o, --output <file>', 'Output file path for the report', 'scripts/task-complexity-report.json')
.option('-m, --model <model>', 'LLM model to use for analysis')
.option('-t, --threshold <number>', 'Minimum complexity score to recommend expansion (1-10)', '5')
.option('-f, --file <file>', 'Path to the tasks file', 'tasks/tasks.json')
.option('-r, --research', 'Use Perplexity AI for research-backed complexity analysis')
.action((options) => {
const args = ['analyze-complexity'];
if (options.output) args.push('--output', options.output);
if (options.model) args.push('--model', options.model);
if (options.threshold) args.push('--threshold', options.threshold);
if (options.file) args.push('--file', options.file);
if (options.research) args.push('--research');
runDevScript(args);
});
program
.command('clear-subtasks')
.description('Clear subtasks from specified tasks')
.option('-f, --file <file>', 'Path to the tasks file', 'tasks/tasks.json')
.option('-i, --id <ids>', 'Task IDs (comma-separated) to clear subtasks from')
.option('--all', 'Clear subtasks from all tasks')
.action((options) => {
const args = ['clear-subtasks'];
if (options.file) args.push('--file', options.file);
if (options.id) args.push('--id', options.id);
if (options.all) args.push('--all');
runDevScript(args);
});
program
.command('add-task')
.description('Add a new task to tasks.json using AI')
.option('-f, --file <file>', 'Path to the tasks file', 'tasks/tasks.json')
.option('-p, --prompt <text>', 'Description of the task to add (required)')
.option('-d, --dependencies <ids>', 'Comma-separated list of task IDs this task depends on')
.option('--priority <priority>', 'Task priority (high, medium, low)', 'medium')
.action((options) => {
const args = ['add-task'];
if (options.file) args.push('--file', options.file);
if (options.prompt) args.push('--prompt', options.prompt);
if (options.dependencies) args.push('--dependencies', options.dependencies);
if (options.priority) args.push('--priority', options.priority);
runDevScript(args);
});
program
.command('show')
.description('Display detailed information about a specific task')
.argument('[id]', 'Task ID to show')
.option('-i, --id <id>', 'Task ID to show (alternative to argument)')
.option('-f, --file <file>', 'Path to the tasks file', 'tasks/tasks.json')
.action((id, options) => {
const args = ['show'];
if (id) args.push(id);
else if (options.id) args.push('--id', options.id);
if (options.file) args.push('--file', options.file);
runDevScript(args);
});
program
.command('add-dependency')
.description('Add a dependency to a task')
.option('-f, --file <file>', 'Path to the tasks file', 'tasks/tasks.json')
.option('-i, --id <id>', 'ID of the task to add dependency to')
.option('-d, --depends-on <id>', 'ID of the task to add as dependency')
.action((options) => {
const args = ['add-dependency'];
if (options.file) args.push('--file', options.file);
if (options.id) args.push('--id', options.id);
if (options.dependsOn) args.push('--depends-on', options.dependsOn);
runDevScript(args);
});
program
.command('remove-dependency')
.description('Remove a dependency from a task')
.option('-f, --file <file>', 'Path to the tasks file', 'tasks/tasks.json')
.option('-i, --id <id>', 'ID of the task to remove dependency from')
.option('-d, --depends-on <id>', 'ID of the task to remove as dependency')
.action((options) => {
const args = ['remove-dependency'];
if (options.file) args.push('--file', options.file);
if (options.id) args.push('--id', options.id);
if (options.dependsOn) args.push('--depends-on', options.dependsOn);
runDevScript(args);
});
program
.command('validate-dependencies')
.description('Check for and identify invalid dependencies in tasks')
.option('-f, --file <path>', 'Path to the tasks.json file', 'tasks/tasks.json')
.action((options) => {
const args = ['validate-dependencies'];
if (options.file) args.push('--file', options.file);
runDevScript(args);
});
program
.command('fix-dependencies')
.description('Find and fix all invalid dependencies in tasks.json and task files')
.option('-f, --file <path>', 'Path to the tasks.json file', 'tasks/tasks.json')
.action((options) => {
const args = ['fix-dependencies'];
if (options.file) args.push('--file', options.file);
runDevScript(args);
});
program
.command('complexity-report')
.description('Display the complexity analysis report')
.option('-f, --file <path>', 'Path to the complexity report file', 'scripts/task-complexity-report.json')
.action((options) => {
const args = ['complexity-report'];
if (options.file) args.push('--file', options.file);
runDevScript(args);
// For each command in the temp instance, add a modified version to our actual program
tempProgram.commands.forEach(cmd => {
if (['init', 'dev'].includes(cmd.name())) {
// Skip commands we've already defined specially
return;
}
// Create a new command with the same name and description
const newCmd = program
.command(cmd.name())
.description(cmd.description());
// Copy all options
cmd.options.forEach(opt => {
newCmd.option(
opt.flags,
opt.description,
opt.defaultValue
);
});
// Set the action to proxy to dev.js
newCmd.action(createDevScriptAction(cmd.name()));
});
// Parse the command line arguments
program.parse(process.argv);