3c10b3ceb2
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.
377 lines
11 KiB
JavaScript
Executable File
377 lines
11 KiB
JavaScript
Executable File
#!/usr/bin/env node
|
|
|
|
/**
|
|
* Task Master
|
|
* Copyright (c) 2025 Eyal Toledano, Ralph Khreish
|
|
*
|
|
* This software is licensed under the MIT License with Commons Clause.
|
|
* You may use this software for any purpose, including commercial applications,
|
|
* and modify and redistribute it freely, subject to the following restrictions:
|
|
*
|
|
* 1. You may not sell this software or offer it as a service.
|
|
* 2. The origin of this software must not be misrepresented.
|
|
* 3. Altered source versions must be plainly marked as such.
|
|
*
|
|
* For the full license text, see the LICENSE file in the root directory.
|
|
*/
|
|
|
|
/**
|
|
* Claude Task Master CLI
|
|
* Main entry point for globally installed package
|
|
*/
|
|
|
|
import { fileURLToPath } from 'url';
|
|
import { dirname, resolve } from 'path';
|
|
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';
|
|
import { detectCamelCaseFlags } from '../scripts/modules/utils.js';
|
|
import chalk from 'chalk';
|
|
|
|
const __filename = fileURLToPath(import.meta.url);
|
|
const __dirname = dirname(__filename);
|
|
const require = createRequire(import.meta.url);
|
|
|
|
// Get package information
|
|
const packageJson = require('../package.json');
|
|
const version = packageJson.version;
|
|
|
|
// Get paths to script files
|
|
const devScriptPath = resolve(__dirname, '../scripts/dev.js');
|
|
const initScriptPath = resolve(__dirname, '../scripts/init.js');
|
|
|
|
// Helper function to run dev.js with arguments
|
|
function runDevScript(args) {
|
|
// Debug: Show the transformed arguments when DEBUG=1 is set
|
|
if (process.env.DEBUG === '1') {
|
|
console.error('\nDEBUG - CLI Wrapper Analysis:');
|
|
console.error('- Original command: ' + process.argv.join(' '));
|
|
console.error('- Transformed args: ' + args.join(' '));
|
|
console.error(
|
|
'- dev.js will receive: node ' +
|
|
devScriptPath +
|
|
' ' +
|
|
args.join(' ') +
|
|
'\n'
|
|
);
|
|
}
|
|
|
|
// For testing: If TEST_MODE is set, just print args and exit
|
|
if (process.env.TEST_MODE === '1') {
|
|
console.log('Would execute:');
|
|
console.log(`node ${devScriptPath} ${args.join(' ')}`);
|
|
process.exit(0);
|
|
return;
|
|
}
|
|
|
|
const child = spawn('node', [devScriptPath, ...args], {
|
|
stdio: 'inherit',
|
|
cwd: process.cwd()
|
|
});
|
|
|
|
child.on('close', (code) => {
|
|
process.exit(code);
|
|
});
|
|
}
|
|
|
|
// Helper function to detect camelCase and convert to kebab-case
|
|
const toKebabCase = (str) => str.replace(/([A-Z])/g, '-$1').toLowerCase();
|
|
|
|
/**
|
|
* 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) => {
|
|
// Check for camelCase flags and error out with helpful message
|
|
const camelCaseFlags = detectCamelCaseFlags(process.argv);
|
|
|
|
// If camelCase flags were found, show error and exit
|
|
if (camelCaseFlags.length > 0) {
|
|
console.error('\nError: Please use kebab-case for CLI flags:');
|
|
camelCaseFlags.forEach((flag) => {
|
|
console.error(` Instead of: --${flag.original}`);
|
|
console.error(` Use: --${flag.kebabCase}`);
|
|
});
|
|
console.error(
|
|
'\nExample: task-master parse-prd --num-tasks=5 instead of --numTasks=5\n'
|
|
);
|
|
process.exit(1);
|
|
}
|
|
|
|
// Since we've ensured no camelCase flags, we can now just:
|
|
// 1. Start with the command name
|
|
const args = [commandName];
|
|
|
|
// 3. Get positional arguments and explicit flags from the command line
|
|
const commandArgs = [];
|
|
const positionals = new Set(); // Track positional args we've seen
|
|
|
|
// Find the command in raw process.argv to extract args
|
|
const commandIndex = process.argv.indexOf(commandName);
|
|
if (commandIndex !== -1) {
|
|
// Process all args after the command name
|
|
for (let i = commandIndex + 1; i < process.argv.length; i++) {
|
|
const arg = process.argv[i];
|
|
|
|
if (arg.startsWith('--')) {
|
|
// It's a flag - pass through as is
|
|
commandArgs.push(arg);
|
|
// Skip the next arg if this is a flag with a value (not --flag=value format)
|
|
if (
|
|
!arg.includes('=') &&
|
|
i + 1 < process.argv.length &&
|
|
!process.argv[i + 1].startsWith('--')
|
|
) {
|
|
commandArgs.push(process.argv[++i]);
|
|
}
|
|
} else if (!positionals.has(arg)) {
|
|
// It's a positional argument we haven't seen
|
|
commandArgs.push(arg);
|
|
positionals.add(arg);
|
|
}
|
|
}
|
|
}
|
|
|
|
// Add all command line args we collected
|
|
args.push(...commandArgs);
|
|
|
|
// 4. Add default options from Commander if not specified on command line
|
|
// Track which options we've seen on the command line
|
|
const userOptions = new Set();
|
|
for (const arg of commandArgs) {
|
|
if (arg.startsWith('--')) {
|
|
// Extract option name (without -- and value)
|
|
const name = arg.split('=')[0].slice(2);
|
|
userOptions.add(name);
|
|
|
|
// Add the kebab-case version too, to prevent duplicates
|
|
const kebabName = name.replace(/([A-Z])/g, '-$1').toLowerCase();
|
|
userOptions.add(kebabName);
|
|
|
|
// Add the camelCase version as well
|
|
const camelName = kebabName.replace(/-([a-z])/g, (_, letter) =>
|
|
letter.toUpperCase()
|
|
);
|
|
userOptions.add(camelName);
|
|
}
|
|
}
|
|
|
|
// Add Commander-provided defaults for options not specified by user
|
|
Object.entries(options).forEach(([key, value]) => {
|
|
// Debug output to see what keys we're getting
|
|
if (process.env.DEBUG === '1') {
|
|
console.error(`DEBUG - Processing option: ${key} = ${value}`);
|
|
}
|
|
|
|
// Special case for numTasks > num-tasks (a known problem case)
|
|
if (key === 'numTasks') {
|
|
if (process.env.DEBUG === '1') {
|
|
console.error('DEBUG - Converting numTasks to num-tasks');
|
|
}
|
|
if (!userOptions.has('num-tasks') && !userOptions.has('numTasks')) {
|
|
args.push(`--num-tasks=${value}`);
|
|
}
|
|
return;
|
|
}
|
|
|
|
// Skip built-in Commander properties and options the user provided
|
|
if (
|
|
['parent', 'commands', 'options', 'rawArgs'].includes(key) ||
|
|
userOptions.has(key)
|
|
) {
|
|
return;
|
|
}
|
|
|
|
// Also check the kebab-case version of this key
|
|
const kebabKey = key.replace(/([A-Z])/g, '-$1').toLowerCase();
|
|
if (userOptions.has(kebabKey)) {
|
|
return;
|
|
}
|
|
|
|
// Add default values, using kebab-case for the parameter name
|
|
if (value !== undefined) {
|
|
if (typeof value === 'boolean') {
|
|
if (value === true) {
|
|
args.push(`--${kebabKey}`);
|
|
} else if (value === false && key === 'generate') {
|
|
args.push('--skip-generate');
|
|
}
|
|
} else {
|
|
// Always use kebab-case for option names
|
|
args.push(`--${kebabKey}=${value}`);
|
|
}
|
|
}
|
|
});
|
|
|
|
// Special handling for parent parameter (uses -p)
|
|
if (options.parent && !args.includes('-p') && !userOptions.has('parent')) {
|
|
args.push('-p', options.parent);
|
|
}
|
|
|
|
// Debug output for troubleshooting
|
|
if (process.env.DEBUG === '1') {
|
|
console.error('DEBUG - Command args:', commandArgs);
|
|
console.error('DEBUG - User options:', Array.from(userOptions));
|
|
console.error('DEBUG - Commander options:', options);
|
|
console.error('DEBUG - Final args:', args);
|
|
}
|
|
|
|
// Run the script with our processed args
|
|
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();
|
|
|
|
program
|
|
.name('task-master')
|
|
.description('Claude Task Master CLI')
|
|
.version(version)
|
|
.addHelpText('afterAll', () => {
|
|
// Use the same help display function as dev.js for consistency
|
|
displayHelp();
|
|
return ''; // Return empty string to prevent commander's default help
|
|
});
|
|
|
|
// Add custom help option to directly call our help display
|
|
program.helpOption('-h, --help', 'Display help information');
|
|
program.on('--help', () => {
|
|
displayHelp();
|
|
});
|
|
|
|
// // Add special case commands
|
|
// registerInitCommand(program);
|
|
|
|
program
|
|
.command('dev')
|
|
.description('Run the dev.js script')
|
|
.action(() => {
|
|
const args = process.argv.slice(process.argv.indexOf('dev') + 1);
|
|
runDevScript(args);
|
|
});
|
|
|
|
// Use a temporary Command instance to get all command definitions
|
|
const tempProgram = new Command();
|
|
registerCommands(tempProgram);
|
|
|
|
// For each command in the temp instance, add a modified version to our actual program
|
|
tempProgram.commands.forEach((cmd) => {
|
|
if (['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);
|
|
|
|
// Add global error handling for unknown commands and options
|
|
process.on('uncaughtException', (err) => {
|
|
// Check if this is a commander.js unknown option error
|
|
if (err.code === 'commander.unknownOption') {
|
|
const option = err.message.match(/'([^']+)'/)?.[1];
|
|
const commandArg = process.argv.find(
|
|
(arg) =>
|
|
!arg.startsWith('-') &&
|
|
arg !== 'task-master' &&
|
|
!arg.includes('/') &&
|
|
arg !== 'node'
|
|
);
|
|
const command = commandArg || 'unknown';
|
|
|
|
console.error(chalk.red(`Error: Unknown option '${option}'`));
|
|
console.error(
|
|
chalk.yellow(
|
|
`Run 'task-master ${command} --help' to see available options for this command`
|
|
)
|
|
);
|
|
process.exit(1);
|
|
}
|
|
|
|
// Check if this is a commander.js unknown command error
|
|
if (err.code === 'commander.unknownCommand') {
|
|
const command = err.message.match(/'([^']+)'/)?.[1];
|
|
|
|
console.error(chalk.red(`Error: Unknown command '${command}'`));
|
|
console.error(
|
|
chalk.yellow(`Run 'task-master --help' to see available commands`)
|
|
);
|
|
process.exit(1);
|
|
}
|
|
|
|
// Handle other uncaught exceptions
|
|
console.error(chalk.red(`Error: ${err.message}`));
|
|
if (process.env.DEBUG === '1') {
|
|
console.error(err);
|
|
}
|
|
process.exit(1);
|
|
});
|
|
|
|
// Show help if no command was provided (just 'task-master' with no args)
|
|
if (process.argv.length <= 2) {
|
|
displayBanner();
|
|
displayHelp();
|
|
process.exit(0);
|
|
}
|
|
|
|
// Add exports at the end of the file
|
|
export { detectCamelCaseFlags };
|