Taskmaster

/** * 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. */ import { randomUUID } from 'crypto'; import fs from 'fs'; import path from 'path'; import readline from 'readline'; import { authenticateWithBrowserMFA, ensureOrgSelected, ui } from '@tm/cli'; import { AuthManager } from '@tm/core'; import boxen from 'boxen'; import chalk from 'chalk'; import figlet from 'figlet'; import gradient from 'gradient-string'; import inquirer from 'inquirer'; import open from 'open'; import ora from 'ora'; import { RULE_PROFILES } from '../src/constants/profiles.js'; import { manageGitignoreFile } from '../src/utils/manage-gitignore.js'; import { convertAllRulesToProfileRules, getRulesProfile } from '../src/utils/rule-transformer.js'; import { warmGradient } from './modules/ui.js'; import { updateConfigMaxTokens } from './modules/update-config-tokens.js'; import { isSilentMode } from './modules/utils.js'; import { insideGitWorkTree } from './modules/utils/git-utils.js'; // Import asset resolver import { assetExists, readAsset } from '../src/utils/asset-resolver.js'; import { execSync } from 'child_process'; import { ENV_EXAMPLE_FILE, EXAMPLE_PRD_FILE, GITIGNORE_FILE, TASKMASTER_CONFIG_FILE, TASKMASTER_DIR, TASKMASTER_DOCS_DIR, TASKMASTER_REPORTS_DIR, TASKMASTER_STATE_FILE, TASKMASTER_TASKS_DIR, TASKMASTER_TEMPLATES_DIR } from '../src/constants/paths.js'; // Define box width for boxen displays const BOX_WIDTH = 60; // Define log levels const LOG_LEVELS = { debug: 0, info: 1, warn: 2, error: 3, success: 4 }; // Determine log level from environment variable or default to 'info' const LOG_LEVEL = process.env.TASKMASTER_LOG_LEVEL ? LOG_LEVELS[process.env.TASKMASTER_LOG_LEVEL.toLowerCase()] : LOG_LEVELS.info; // Default to info /** * Display a fancy banner for initialization * Delegates to @tm/cli brand banner component */ function displayBanner() { if (isSilentMode()) return; ui.displayInitBanner(); } // Logging function with icons and colors function log(level, ...args) { const icons = { debug: chalk.gray('•'), info: chalk.blue('→'), warn: chalk.yellow('!'), error: chalk.red('✗'), success: chalk.green('✓') }; if (LOG_LEVELS[level] >= LOG_LEVEL) { const icon = icons[level] || ''; // Only output to console if not in silent mode if (!isSilentMode()) { if (level === 'error') { console.error(icon, chalk.red(...args)); } else if (level === 'warn') { console.warn(icon, chalk.yellow(...args)); } else if (level === 'success') { console.log(icon, chalk.green(...args)); } else if (level === 'info') { console.log(icon, chalk.blue(...args)); } else { console.log(icon, ...args); } } } // Write to debug log if DEBUG=true if (process.env.DEBUG === 'true') { const logMessage = `[${level.toUpperCase()}] ${args.join(' ')}\n`; fs.appendFileSync('init-debug.log', logMessage); } } // Function to create directory if it doesn't exist function ensureDirectoryExists(dirPath) { if (!fs.existsSync(dirPath)) { fs.mkdirSync(dirPath, { recursive: true }); log('info', `Created directory: ${dirPath}`); } } // Function to add shell aliases to the user's shell configuration // Silently checks each alias individually and adds only missing ones function addShellAliases() { const homeDir = process.env.HOME || process.env.USERPROFILE; let shellConfigFile; // Determine which shell config file to use if (process.env.SHELL?.includes('zsh')) { shellConfigFile = path.join(homeDir, '.zshrc'); } else if (process.env.SHELL?.includes('bash')) { shellConfigFile = path.join(homeDir, '.bashrc'); } else { log('debug', 'Could not determine shell type. Aliases not added.'); return false; } try { // Check if file exists if (!fs.existsSync(shellConfigFile)) { log('debug', `Shell config file ${shellConfigFile} not found.`); return false; } const configContent = fs.readFileSync(shellConfigFile, 'utf8'); // Define all aliases we want const aliases = [ { name: 'tm', line: "alias tm='task-master'" }, { name: 'taskmaster', line: "alias taskmaster='task-master'" }, { name: 'hamster', line: "alias hamster='task-master'" }, { name: 'ham', line: "alias ham='task-master'" } ]; // Check which aliases are missing const missingAliases = aliases.filter( (alias) => !configContent.includes(alias.line) ); if (missingAliases.length === 0) { log('debug', 'All Task Master aliases already exist.'); return true; } // Build alias block with only missing aliases const aliasLines = missingAliases.map((a) => a.line).join('\n'); const aliasBlock = ` # Task Master aliases added on ${new Date().toLocaleDateString()} ${aliasLines} `; fs.appendFileSync(shellConfigFile, aliasBlock); log( 'debug', `Added ${missingAliases.length} alias(es): ${missingAliases.map((a) => a.name).join(', ')}` ); return true; } catch (error) { log('debug', `Failed to add aliases: ${error.message}`); return false; } } // Function to create initial state.json file for tag management function createInitialStateFile(targetDir) { const stateFilePath = path.join(targetDir, TASKMASTER_STATE_FILE); // Check if state.json already exists if (fs.existsSync(stateFilePath)) { log('debug', 'State file already exists, preserving current configuration'); return; } // Create initial state configuration const initialState = { currentTag: 'master', lastSwitched: new Date().toISOString(), branchTagMapping: {}, migrationNoticeShown: false }; try { fs.writeFileSync(stateFilePath, JSON.stringify(initialState, null, 2)); log('success', `Created initial state file: ${stateFilePath}`); log('info', 'Default tag set to "master" for task organization'); } catch (error) { log('error', `Failed to create state file: ${error.message}`); } } // Function to copy a file from the package to the target directory function copyTemplateFile(templateName, targetPath, replacements = {}) { // Get the file content from the appropriate source directory // Check if the asset exists if (!assetExists(templateName)) { log('error', `Source file not found: ${templateName}`); return; } // Read the asset content using the resolver let content = readAsset(templateName, 'utf8'); // Replace placeholders with actual values Object.entries(replacements).forEach(([key, value]) => { const regex = new RegExp(`\\{\\{${key}\\}\\}`, 'g'); content = content.replace(regex, value); }); // Handle special files that should be merged instead of overwritten if (fs.existsSync(targetPath)) { const filename = path.basename(targetPath); // Handle .gitignore - append lines that don't exist if (filename === '.gitignore') { log('info', `${targetPath} already exists, merging content...`); const existingContent = fs.readFileSync(targetPath, 'utf8'); const existingLines = new Set( existingContent.split('\n').map((line) => line.trim()) ); const newLines = content .split('\n') .filter((line) => !existingLines.has(line.trim())); if (newLines.length > 0) { // Add a comment to separate the original content from our additions const updatedContent = `${existingContent.trim()}\n\n# Added by Taskmaster\n${newLines.join('\n')}`; fs.writeFileSync(targetPath, updatedContent); log('success', `Updated ${targetPath} with additional entries`); } else { log('info', `No new content to add to ${targetPath}`); } return; } // Handle README.md - offer to preserve or create a different file if (filename === 'README-task-master.md') { log('info', `${targetPath} already exists`); // Create a separate README file specifically for this project const taskMasterReadmePath = path.join( path.dirname(targetPath), 'README-task-master.md' ); fs.writeFileSync(taskMasterReadmePath, content); log( 'success', `Created ${taskMasterReadmePath} (preserved original README-task-master.md)` ); return; } // For other files, warn and prompt before overwriting log('debug', `${targetPath} already exists, skipping.`); return; } // If the file doesn't exist, create it normally fs.writeFileSync(targetPath, content); log('info', `Created file: ${targetPath}`); } // Main function to initialize a new project async function initializeProject(options = {}) { // Receives options as argument // Only display banner if not in silent mode if (!isSilentMode()) { displayBanner(); } // Debug logging only if not in silent mode // if (!isSilentMode()) { // console.log('===== DEBUG: INITIALIZE PROJECT OPTIONS RECEIVED ====='); // console.log('Full options object:', JSON.stringify(options)); // console.log('options.yes:', options.yes); // console.log('=================================================='); // } // Handle boolean git flags if (options.git === true) { options.initGit = true; // --git flag provided } else if (options.git === false) { options.initGit = false; // --no-git flag provided } // If options.git and options.noGit are undefined, we'll prompt for it // Handle boolean gitTasks flags if (options.gitTasks === true) { options.storeTasksInGit = true; // --git-tasks flag provided } else if (options.gitTasks === false) { options.storeTasksInGit = false; // --no-git-tasks flag provided } // If options.gitTasks and options.noGitTasks are undefined, we'll prompt for it const skipPrompts = options.yes || (options.name && options.description); // if (!isSilentMode()) { // console.log('Skip prompts determined:', skipPrompts); // } let selectedRuleProfiles; if (options.rulesExplicitlyProvided) { // If --rules flag was used, always respect it. selectedRuleProfiles = options.rules; } else if (skipPrompts) { // If non-interactive (e.g., --yes) and no rules specified, skip rules setup entirely selectedRuleProfiles = []; } else { // If interactive and no rules specified, default to NONE. // The 'rules --setup' wizard will handle selection if user wants it. selectedRuleProfiles = []; } if (skipPrompts) { if (!isSilentMode()) { console.log('SKIPPING PROMPTS - Using defaults or provided values'); } // Use provided options or defaults const projectName = options.name || 'task-master-project'; const projectDescription = options.description || 'A project managed with Taskmaster'; const projectVersion = options.version || '0.1.0'; const authorName = options.author || 'Vibe coder'; const dryRun = options.dryRun || false; const initGit = options.initGit !== undefined ? options.initGit : true; // Default to true if not specified const storeTasksInGit = options.storeTasksInGit !== undefined ? options.storeTasksInGit : true; // Default to true if not specified if (dryRun) { log('info', 'DRY RUN MODE: No files will be modified'); log('info', 'Would initialize Task Master project'); log('info', 'Would create/update necessary project files'); // Show flag-specific behavior log( 'info', `${initGit ? 'Would initialize Git repository' : 'Would skip Git initialization'}` ); log( 'info', `${storeTasksInGit ? 'Would store tasks in Git' : 'Would exclude tasks from Git'}` ); return { dryRun: true }; } // Default to local storage in non-interactive mode unless explicitly specified const selectedStorage = options.storage || 'local'; const authCredentials = null; // No auth in non-interactive mode await createProjectStructure( true, // Always add aliases initGit, storeTasksInGit, dryRun, { ...options, preferredLanguage: 'English' }, // Default to English in non-interactive mode selectedRuleProfiles, selectedStorage, authCredentials ); } else { // Interactive logic log('debug', 'Required options not provided, proceeding with prompts.'); let rl; try { // Track init_started event // TODO: Send to Segment telemetry when implemented const taskmasterId = generateTaskmasterId(); log('debug', `Init started - taskmaster_id: ${taskmasterId}`); // Prompt for storage selection first let selectedStorage = await promptStorageSelection(); // Track storage_selected event // TODO: Send to Segment telemetry when implemented log( 'debug', `Storage selected: ${selectedStorage} - taskmaster_id: ${taskmasterId}` ); // If cloud storage selected, trigger OAuth flow let authCredentials = null; if (selectedStorage === 'cloud') { try { const authManager = AuthManager.getInstance(); // Check if already authenticated const existingCredentials = await authManager.getAuthCredentials(); if (existingCredentials) { log('success', 'Already authenticated with Hamster'); authCredentials = existingCredentials; } else { // Use shared browser auth with MFA support // This is the SAME auth flow used by 'tm auth login' and 'tm parse-prd' log('info', 'Starting authentication flow...'); console.log(chalk.blue('\n🔐 Authentication Required\n')); console.log( chalk.white( ' Selecting cloud storage will open your browser for authentication.' ) ); console.log( chalk.gray(' This enables sync across devices with Hamster.\n') ); // Use shared auth utility - handles MFA automatically authCredentials = await authenticateWithBrowserMFA(authManager); // Track auth_completed event log('debug', `Auth completed - taskmaster_id: ${taskmasterId}`); } // Ensure org is selected (required for all Hamster operations) // This runs for both new auth AND existing auth // Uses shared utility from @tm/cli const orgResult = await ensureOrgSelected(authManager, { promptMessage: 'Select an organization to continue:' }); if (!orgResult.success) { log('warn', orgResult.message || 'Organization selection required'); } } catch (authError) { log( 'error', `Failed to authenticate: ${authError.message}. Falling back to local storage.` ); // Fall back to local storage if auth fails selectedStorage = 'local'; } } rl = readline.createInterface({ input: process.stdin, output: process.stdout }); // Git-related prompts only make sense for local storage // If cloud storage is selected, tasks are stored in Hamster, not Git let initGitPrompted = true; // Default to true let storeGitPrompted = true; // Default to true if (selectedStorage === 'local') { // Prompt for Git initialization (skip if --git or --no-git flag was provided) if (options.initGit !== undefined) { initGitPrompted = options.initGit; // Use flag value if provided } else { const gitInitInput = await promptQuestion( rl, chalk.cyan('Initialize a Git repository in project root? (Y/n): '), (answer) => { const isYes = answer.trim().toLowerCase() !== 'n'; const icon = isYes ? chalk.green('✓') : chalk.red('✗'); return ( chalk.cyan('Initialize a Git repository in project root?') + ' ' + icon + ' ' + chalk.dim(isYes ? 'Yes' : 'No') ); } ); initGitPrompted = gitInitInput.trim().toLowerCase() !== 'n'; } // Prompt for Git tasks storage (skip if --git-tasks or --no-git-tasks flag was provided) if (options.storeTasksInGit !== undefined) { storeGitPrompted = options.storeTasksInGit; // Use flag value if provided } else { const gitTasksInput = await promptQuestion( rl, chalk.cyan( 'Store tasks in Git (tasks.json and tasks/ directory)? (Y/n): ' ), (answer) => { const isYes = answer.trim().toLowerCase() !== 'n'; const icon = isYes ? chalk.green('✓') : chalk.red('✗'); return ( chalk.cyan( 'Store tasks in Git (tasks.json and tasks/ directory)?' ) + ' ' + icon + ' ' + chalk.dim(isYes ? 'Yes' : 'No') ); } ); storeGitPrompted = gitTasksInput.trim().toLowerCase() !== 'n'; } } else { // Cloud storage: skip Git prompts, but initialize Git repo anyway // (users may still want version control for their code) initGitPrompted = true; // Tasks are in cloud, so don't store them in Git storeGitPrompted = false; } // Prompt for AI IDE rules setup (only if not explicitly provided via --rules) let shouldSetupRules = false; if (!options.rulesExplicitlyProvided) { const setupRulesInput = await promptQuestion( rl, chalk.cyan( 'Set up AI IDE rules for better integration? (Cursor, Windsurf, etc.) (y/N): ' ), (answer) => { const isYes = answer.trim().toLowerCase() === 'y'; const icon = isYes ? chalk.green('✓') : chalk.red('✗'); return ( chalk.cyan('Set up AI IDE rules for better integration?') + ' ' + icon + ' ' + chalk.dim(isYes ? 'Yes' : 'No') ); } ); shouldSetupRules = setupRulesInput.trim().toLowerCase() === 'y'; } else { log( 'info', `Using rule profiles provided via command line: ${selectedRuleProfiles.join(', ')}` ); } // Prompt for response language preference const languageInput = await promptQuestion( rl, chalk.cyan('Preferred response language (English): ') ); const preferredLanguage = languageInput.trim() || 'English'; // Confirm settings with cleaner formatting console.log('\n' + chalk.bold('Taskmaster Project Settings:')); console.log(chalk.dim('─'.repeat(50))); // Storage console.log( ' ' + chalk.dim('Storage:'.padEnd(32)), chalk.white( selectedStorage === 'cloud' ? 'Hamster Studio' : 'Local File Storage' ) ); // AI IDE rules const rulesIcon = shouldSetupRules ? chalk.green('✓') : chalk.dim('✗'); console.log( ' ' + chalk.dim('AI IDE rules:'.padEnd(32)), rulesIcon + ' ' + chalk.dim(shouldSetupRules ? 'Yes' : 'No') ); // Response language console.log( ' ' + chalk.dim('Response language:'.padEnd(32)), chalk.white(preferredLanguage) ); // Only show Git-related settings for local storage if (selectedStorage === 'local') { const gitIcon = initGitPrompted ? chalk.green('✓') : chalk.dim('✗'); console.log( ' ' + chalk.dim('Initialize Git repository:'.padEnd(32)), gitIcon + ' ' + chalk.dim(initGitPrompted ? 'Yes' : 'No') ); const gitTasksIcon = storeGitPrompted ? chalk.green('✓') : chalk.dim('✗'); console.log( ' ' + chalk.dim('Store tasks in Git:'.padEnd(32)), gitTasksIcon + ' ' + chalk.dim(storeGitPrompted ? 'Yes' : 'No') ); } console.log(chalk.dim('─'.repeat(50))); const confirmInput = await promptQuestion( rl, chalk.yellow('\nDo you want to continue with these settings? (Y/n): ') ); const shouldContinue = confirmInput.trim().toLowerCase() !== 'n'; if (!shouldContinue) { rl.close(); log('info', 'Project initialization cancelled by user'); process.exit(0); return; } const dryRun = options.dryRun || false; if (dryRun) { log('info', 'DRY RUN MODE: No files will be modified'); log('info', 'Would initialize Task Master project'); log('info', 'Would create/update necessary project files'); // Show flag-specific behavior log( 'info', `${initGitPrompted ? 'Would initialize Git repository' : 'Would skip Git initialization'}` ); log( 'info', `${storeGitPrompted ? 'Would store tasks in Git' : 'Would exclude tasks from Git'}` ); return { dryRun: true }; } // Create structure using only necessary values // Always add aliases - addShellAliases() handles checking for existing ones await createProjectStructure( true, // Always add aliases initGitPrompted, storeGitPrompted, dryRun, { ...options, shouldSetupRules, preferredLanguage }, // Pass shouldSetupRules and preferredLanguage through options selectedRuleProfiles, selectedStorage, authCredentials ); rl.close(); } catch (error) { if (rl) { rl.close(); } log('error', `Error during initialization process: ${error.message}`); process.exit(1); } } } // Helper function to promisify readline question and overwrite prompt with result function promptQuestion(rl, question, formatResult) { return new Promise((resolve) => { rl.question(question, (answer) => { // After user presses Enter, cursor is on a new line // Move cursor up one line, then clear and write result readline.moveCursor(process.stdout, 0, -1); readline.cursorTo(process.stdout, 0); readline.clearLine(process.stdout, 0); // Show formatted result if provided if (formatResult) { process.stdout.write(formatResult(answer) + '\n'); } resolve(answer); }); }); } /** * Generate a unique taskmaster_id for anonymous tracking * @returns {string} UUID string */ function generateTaskmasterId() { return randomUUID(); } /** * Update config.json with storage configuration * @param {string} configPath - Path to config.json file * @param {string} selectedStorage - Storage type ('cloud' or 'local') * @param {object|null} authCredentials - Auth credentials if cloud storage selected */ function updateStorageConfig(configPath, selectedStorage, authCredentials) { try { if (!fs.existsSync(configPath)) { log('warn', 'Config file does not exist, skipping storage configuration'); return; } const configContent = fs.readFileSync(configPath, 'utf8'); const config = JSON.parse(configContent); // Initialize storage config if it doesn't exist if (!config.storage) { config.storage = {}; } if (selectedStorage === 'cloud') { // Configure for API/cloud storage config.storage.type = 'api'; config.storage.apiEndpoint = process.env.TM_BASE_DOMAIN || process.env.TM_PUBLIC_BASE_DOMAIN || 'https://tryhamster.com/api'; // Note: Access token is stored in ~/.taskmaster/auth.json by AuthManager // We don't store it in config.json for security reasons log('debug', 'Connected to Hamster Studio'); } else { // Configure for local file storage config.storage.type = 'file'; log('debug', 'Configured storage for local file storage'); } // Write updated config back to file fs.writeFileSync(configPath, JSON.stringify(config, null, 2)); log('debug', 'Storage configuration updated in config.json'); } catch (error) { log('error', `Failed to update storage configuration: ${error.message}`); } } /** * Prompt user to select storage backend (Hamster cloud or local) * @returns {Promise<'cloud'|'local'>} Selected storage type */ async function promptStorageSelection() { if (isSilentMode()) { // Default to local in silent mode return 'local'; } try { // Display header console.log(chalk.bold.cyan('You need a plan before you execute.\n')); const { storageType } = await inquirer.prompt([ { type: 'list', name: 'storageType', message: chalk.white('How do you want to build it?\n'), choices: [ { name: [ chalk.bold('Solo (Taskmaster)'), '', chalk.white( ' • Parse your own PRDs into structured task lists and build with any IDE or background agents' ), chalk.white( ' • Agents execute tasks with precision, no scope creep, no going off-track' ), chalk.white( ' • Tasks live in a local JSON file, everything stays in your repo' ), chalk.white( ' • Upgrade to Hamster to bring the Taskmaster experience to your team' ), '' ].join('\n'), value: 'local', short: 'Solo (Taskmaster)' }, { name: [ chalk.bold('Together (Hamster)'), '', chalk.white( ' • Write a brief with your team. Hamster refines it into a plan.' ), chalk.white( ' • Your team drafts, refines, and aligns on the same page before executing' ), chalk.white( ' • One brief, one plan, one source of truth for execution' ), chalk.white( ' • Access tasks on Taskmaster and execute with any AI agent' ), '' ].join('\n'), value: 'cloud', short: 'Together (Hamster)' } ], default: 'local', pageSize: 20 // Increase page size to show both options without scrolling } ]); return storageType; } catch (error) { // Handle Ctrl+C or other interruptions if (error.isTtyError || error.name === 'ExitPromptError') { log('warn', 'Storage selection cancelled, defaulting to local storage'); return 'local'; } throw error; } } // Function to create the project structure async function createProjectStructure( addAliases, initGit, storeTasksInGit, dryRun, options, selectedRuleProfiles = RULE_PROFILES, selectedStorage = 'local', authCredentials = null ) { const targetDir = process.cwd(); log('debug', `Initializing project in ${targetDir}`); // Create NEW .taskmaster directory structure (using constants) ensureDirectoryExists(path.join(targetDir, TASKMASTER_DIR)); ensureDirectoryExists(path.join(targetDir, TASKMASTER_TASKS_DIR)); ensureDirectoryExists(path.join(targetDir, TASKMASTER_DOCS_DIR)); ensureDirectoryExists(path.join(targetDir, TASKMASTER_REPORTS_DIR)); ensureDirectoryExists(path.join(targetDir, TASKMASTER_TEMPLATES_DIR)); // Create initial state.json file for tag management createInitialStateFile(targetDir); // Copy template files with replacements const replacements = { year: new Date().getFullYear() }; // Helper function to create rule profiles function _processSingleProfile(profileName) { const profile = getRulesProfile(profileName); if (profile) { convertAllRulesToProfileRules(targetDir, profile); // Also triggers MCP config setup (if applicable) } else { log('warn', `Unknown rule profile: ${profileName}`); } } // Copy .env.example copyTemplateFile( 'env.example', path.join(targetDir, ENV_EXAMPLE_FILE), replacements ); // Copy config.json with project name to NEW location copyTemplateFile( 'config.json', path.join(targetDir, TASKMASTER_CONFIG_FILE), { ...replacements } ); // Update config.json with correct maxTokens values from supported-models.json const configPath = path.join(targetDir, TASKMASTER_CONFIG_FILE); if (updateConfigMaxTokens(configPath)) { log('debug', 'Updated config with correct maxTokens values'); } else { log('debug', 'Could not update maxTokens in config'); } // Update config.json with storage configuration updateStorageConfig(configPath, selectedStorage, authCredentials); // Copy .gitignore with GitTasks preference try { const templateContent = readAsset('gitignore', 'utf8'); manageGitignoreFile( path.join(targetDir, GITIGNORE_FILE), templateContent, storeTasksInGit, log ); } catch (error) { log('error', `Failed to create .gitignore: ${error.message}`); } // Copy example_prd.txt to NEW location copyTemplateFile('example_prd.txt', path.join(targetDir, EXAMPLE_PRD_FILE)); // Copy example_prd_rpg.txt to templates directory copyTemplateFile( 'example_prd_rpg.txt', path.join(targetDir, TASKMASTER_TEMPLATES_DIR, 'example_prd_rpg.txt') ); // Initialize git repository if git is available try { if (initGit === false) { log('info', 'Git initialization skipped due to --no-git flag.'); } else if (initGit === true) { if (insideGitWorkTree()) { log( 'debug', 'Existing Git repository detected – skipping git init despite --git flag.' ); } else { log('info', 'Initializing Git repository due to --git flag...'); execSync('git init', { cwd: targetDir, stdio: 'ignore' }); log('success', 'Git repository initialized'); } } else { // Default behavior when no flag is provided (from interactive prompt) if (insideGitWorkTree()) { log('debug', 'Existing Git repository detected – skipping git init.'); } else { log( 'info', 'No Git repository detected. Initializing one in project root...' ); execSync('git init', { cwd: targetDir, stdio: 'ignore' }); log('success', 'Git repository initialized'); } } } catch (error) { log('warn', 'Git not available, skipping repository initialization'); } // Only run the manual transformer if rules were provided via flags. // The interactive `rules --setup` wizard handles its own installation. if (options.rulesExplicitlyProvided || options.yes) { log('info', 'Generating profile rules from command-line flags...'); for (const profileName of selectedRuleProfiles) { _processSingleProfile(profileName); } } // Add shell aliases if requested if (addAliases) { addShellAliases(); } // Run npm install automatically const npmInstallOptions = { cwd: targetDir, // Default to inherit for interactive CLI, change if silent stdio: 'inherit' }; if (isSilentMode()) { // If silent (MCP mode), suppress npm install output npmInstallOptions.stdio = 'ignore'; log('info', 'Running npm install silently...'); // Log our own message } // === Add Rule Profiles Setup Step === // Only run if user explicitly said yes (via shouldSetupRules) if ( options.shouldSetupRules && !isSilentMode() && !dryRun && !options?.yes && !options.rulesExplicitlyProvided ) { console.log( boxen(chalk.cyan('Configuring Rule Profiles...'), { padding: 0.5, margin: { top: 1, bottom: 0.5 }, borderStyle: 'round', borderColor: 'cyan', width: BOX_WIDTH }) ); log( 'info', 'Running interactive rules setup. Please select which rule profiles to include.' ); try { // Correct command confirmed by you. execSync('npx task-master rules --setup', { stdio: 'inherit', cwd: targetDir }); log('success', 'Rule profiles configured.'); } catch (error) { log('error', 'Failed to configure rule profiles:', error.message); log('warn', 'You may need to run "task-master rules --setup" manually.'); } } else if (isSilentMode() || dryRun || options?.yes) { // This branch can log why setup was skipped, similar to the model setup logic. if (options.rulesExplicitlyProvided) { log( 'debug', 'Skipping interactive rules setup because --rules flag was used.' ); } else { log('debug', 'Skipping interactive rules setup in non-interactive mode.'); } } else if (!options.shouldSetupRules) { log('debug', 'Skipping rules setup - user declined.'); } // ===================================== // === Add Response Language Step === // Set language directly if provided via interactive prompt if (options.preferredLanguage && !dryRun) { try { const responseLanguageModule = await import( './modules/task-manager/response-language.js' ); const setResponseLanguage = responseLanguageModule.default; setResponseLanguage(options.preferredLanguage, { projectRoot: targetDir, silent: true }); log('debug', `Response language set to: ${options.preferredLanguage}`); } catch (error) { log('warn', `Failed to set response language: ${error.message}`); } } else if (isSilentMode() && !dryRun) { log('debug', 'Skipping response language setup in silent (MCP) mode.'); } else if (dryRun) { log('debug', 'DRY RUN: Skipping response language setup.'); } // ===================================== // === Add Model Configuration Step === // Only configure models for local storage (need API keys for direct AI usage) // Cloud storage (Hamster) manages AI models on the backend - no API keys or extra costs needed if ( !isSilentMode() && !dryRun && !options?.yes && selectedStorage === 'local' ) { console.log( boxen(chalk.cyan('Configuring AI Models...'), { padding: 0.5, margin: { top: 1, bottom: 0.5 }, borderStyle: 'round', borderColor: 'cyan', width: BOX_WIDTH }) ); log( 'info', 'Running interactive model setup. Please select your preferred AI models.' ); try { execSync('npx task-master models --setup', { stdio: 'inherit', cwd: targetDir }); log('success', 'AI Models configured.'); } catch (error) { log('error', 'Failed to configure AI models:', error.message); log('warn', 'You may need to run "task-master models --setup" manually.'); } } else if (selectedStorage === 'cloud' && !dryRun) { console.log( boxen( chalk.green.bold('✓ AI Models Managed by Hamster - go ham!\n\n') + chalk.white('Hamster handles all AI model configuration for you.\n') + chalk.dim('• Optimized model selection for your tasks\n') + chalk.dim('• No API keys required\n') + chalk.dim('• No extra costs'), { padding: 1, margin: { top: 1, bottom: 0.5 }, borderStyle: 'round', borderColor: 'cyan', width: BOX_WIDTH } ) ); } else if (isSilentMode() && !dryRun) { log('info', 'Skipping interactive model setup in silent (MCP) mode.'); log( 'warn', 'Please configure AI models using "task-master models --set-..." or the "models" MCP tool.' ); } else if (dryRun) { log('info', 'DRY RUN: Skipping interactive model setup.'); } else if (options?.yes) { log('info', 'Skipping interactive model setup due to --yes flag.'); log( 'info', 'Default AI models will be used. You can configure different models later using "task-master models --setup" or "task-master models --set-..." commands.' ); } // ==================================== // Add shell aliases if requested if (addAliases && !dryRun) { log('debug', 'Adding shell aliases...'); const aliasResult = addShellAliases(); if (aliasResult) { log('debug', 'Shell aliases added successfully'); } } else if (addAliases && dryRun) { log('debug', 'DRY RUN: Would add shell aliases (tm, taskmaster)'); } // Display success message if (!isSilentMode()) { // Show elegant welcome message for Hamster, regular success for local if (selectedStorage === 'cloud') { // High-fidelity hamster pixel art (displayed without box) const hamsterArt = readAsset('hamster-art.txt', 'utf8'); console.log('\n' + chalk.cyan(hamsterArt)); console.log(''); // Box with connection message and next steps const welcomeMessage = [ chalk.green.bold('✓ Connected to Hamster Studio'), '', chalk.white("Your team's workspace is ready to go ham!\n"), chalk.dim('Draft together. Align once. Build with agents.'), '', chalk.cyan('How to orchestrate with Taskmaster:'), chalk.white(' • Create your first brief at: ') + chalk.underline.cyan('https://tryhamster.com'), chalk.white(' • Connect your brief using ') + chalk.bold('tm context <brief-url>') + chalk.white(' to access tasks in Taskmaster'), chalk.white(' • Orchestrate and implement tasks using ') + chalk.bold('tm next') + chalk.white(' to kickoff any AI agent'), chalk.white(' • Run ') + chalk.bold('tm help') + chalk.white(' to explore other available commands'), chalk.white(' • Run ') + chalk.bold('tm rules --setup') + chalk.white(' to configure AI IDE rules for better integration') ].join('\n'); console.log( boxen(welcomeMessage, { padding: 1, margin: { top: 1, bottom: 0, left: 0, right: 0 }, borderStyle: 'round', borderColor: 'cyan', width: BOX_WIDTH }) ); } else { console.log( boxen( `${warmGradient.multiline( figlet.textSync('Success!', { font: 'Standard' }) )}\n${chalk.green('Project initialized successfully!')}`, { padding: 1, margin: 1, borderStyle: 'double', borderColor: 'green', width: BOX_WIDTH } ) ); } } // Display next steps in a nice box if (!isSilentMode()) { // Different Getting Started for Hamster vs Local let gettingStartedMessage; if (selectedStorage === 'cloud') { // Hamster-specific workflow gettingStartedMessage = `${chalk.cyan.bold("Here's how to execute your Hamster briefs with Taskmaster")}\n\n${chalk.white('1. ')}${chalk.yellow( 'Create your first brief at' )} ${chalk.cyan.underline('https://tryhamster.com')}\n${chalk.white(' └─ ')}${chalk.dim('Hamster will write your brief and generate the full task plan')}\n${chalk.white('2. ')}${chalk.yellow( 'Add rules for your AI IDE(s)' )}\n${chalk.white(' └─ ')}${chalk.dim('CLI: ')}${chalk.cyan('tm rules --setup')}${chalk.dim(' - Opens interactive setup')}\n${chalk.white('3. ')}${chalk.yellow( 'Connect your brief to Taskmaster' )}\n${chalk.white(' └─ ')}${chalk.dim('CLI: ')}${chalk.cyan('tm context <brief-url> OR tm briefs')}\n${chalk.white('4. ')}${chalk.yellow( 'View your tasks from the brief' )}\n${chalk.white(' └─ ')}${chalk.dim('CLI: ')}${chalk.cyan('tm list')}${chalk.dim(' or ')}${chalk.cyan('tm list all')}${chalk.dim(' (with subtasks)')}\n${chalk.white('5. ')}${chalk.yellow( 'Work on tasks with any AI coding assistant or background agent' )}\n${chalk.white(' ├─ ')}${chalk.dim('CLI: ')}${chalk.cyan('tm next')}${chalk.dim(' - Find the next task to work on')}\n${chalk.white(' ├─ ')}${chalk.dim('CLI: ')}${chalk.cyan('tm show <id>')}${chalk.dim(' - View task details')}\n${chalk.white(' ├─ ')}${chalk.dim('CLI: ')}${chalk.cyan('tm status <id> in-progress')}${chalk.dim(' - Mark task started')}\n${chalk.white(' └─ ')}${chalk.dim('CLI: ')}${chalk.cyan('tm status <id> done')}${chalk.dim(' - Mark task complete')}\n${chalk.white('6. ')}${chalk.yellow( 'Add notes or updates to tasks' )}\n${chalk.white(' └─ ')}${chalk.dim('CLI: ')}${chalk.cyan('tm update-task <id> <notes>')}\n${chalk.white('7. ')}${chalk.green.bold('Ship it!')}\n\n${chalk.dim( '* Run ' )}${chalk.cyan('tm help')}${chalk.dim(' to see all available commands')}`; } else { // Local-specific getting started gettingStartedMessage = `${chalk.cyan.bold('Things you should do next:')}\n\n${chalk.white('1. ')}${chalk.yellow( 'Configure AI models and add API keys to `.env`' )}\n${chalk.white(' ├─ ')}${chalk.dim('Models: Use ')}${chalk.cyan('task-master models')}${chalk.dim(' commands')}\n${chalk.white(' └─ ')}${chalk.dim( 'Keys: Add provider API keys to .env (or .cursor/mcp.json)' )}\n${chalk.white('2. ')}${chalk.yellow( 'Discuss your idea with AI and create a PRD' )}\n${chalk.white(' ├─ ')}${chalk.dim('Simple projects: Use ')}${chalk.cyan('example_prd.txt')}${chalk.dim(' template')}\n${chalk.white(' └─ ')}${chalk.dim('Complex systems: Use ')}${chalk.cyan('example_prd_rpg.txt')}${chalk.dim(' template')}\n${chalk.white('3. ')}${chalk.yellow( 'Parse your PRD to generate initial tasks' )}\n${chalk.white(' └─ ')}${chalk.dim('CLI: ')}${chalk.cyan('task-master parse-prd .taskmaster/docs/prd.txt')}\n${chalk.white('4. ')}${chalk.yellow( 'Analyze task complexity' )}\n${chalk.white(' └─ ')}${chalk.dim('CLI: ')}${chalk.cyan('task-master analyze-complexity --research')}\n${chalk.white('5. ')}${chalk.yellow( 'Expand tasks into subtasks' )}\n${chalk.white(' └─ ')}${chalk.dim('CLI: ')}${chalk.cyan('task-master expand --all --research')}\n${chalk.white('6. ')}${chalk.yellow( 'Start working on tasks' )}\n${chalk.white(' └─ ')}${chalk.dim('CLI: ')}${chalk.cyan('task-master next')}\n${chalk.white('7. ')}${chalk.green.bold('Ship it!')}\n\n${chalk.dim( '* Run ' )}${chalk.cyan('task-master --help')}${chalk.dim(' to see all available commands')}\n${chalk.dim( '* Run ' )}${chalk.cyan('tm rules --setup')}${chalk.dim(' to configure AI IDE rules for better integration')}`; } console.log( boxen(chalk.yellow.bold('Workflow\n') + '\n' + gettingStartedMessage, { padding: 1, margin: { top: 0, bottom: 1, left: 0, right: 0 }, borderStyle: 'round', borderColor: 'yellow', width: BOX_WIDTH }) ); } } // Ensure necessary functions are exported export { initializeProject, log };