AI Code Toolkit

import path from 'node:path'; import { icons, messages, ProjectConfigResolver, print, TemplatesManagerService, } from '@agiflowai/aicode-utils'; import { Command } from 'commander'; import { FileSystemService } from '../services/FileSystemService'; import { ScaffoldingMethodsService } from '../services/ScaffoldingMethodsService'; /** * Scaffold CLI command */ export const scaffoldCommand = new Command('scaffold').description( 'Add features to existing projects', ); // List command scaffoldCommand .command('list [projectPath]') .description('List available scaffolding methods for a project or template') .option('-t, --template <name>', 'Template name (e.g., nextjs-15, typescript-mcp-package)') .option('-c, --cursor <cursor>', 'Pagination cursor for next page') .action(async (projectPath, options) => { try { // Require either projectPath or template option if (!projectPath && !options.template) { messages.error('Either projectPath or --template option must be provided'); messages.hint('Examples:'); print.debug(' scaffold-mcp scaffold list ./my-project'); print.debug(' scaffold-mcp scaffold list --template nextjs-15'); process.exit(1); } const templatesDir = await TemplatesManagerService.findTemplatesPath(); if (!templatesDir) { messages.error( 'Templates folder not found. Create a templates folder or specify templatesPath in toolkit.yaml', ); process.exit(1); } const fileSystemService = new FileSystemService(); const scaffoldingMethodsService = new ScaffoldingMethodsService( fileSystemService, templatesDir, ); let result; let displayName: string; if (projectPath) { // Use project path const absolutePath = path.resolve(projectPath); // Verify project configuration exists (supports both monolith and monorepo) const hasConfig = await ProjectConfigResolver.hasConfiguration(absolutePath); if (!hasConfig) { messages.error(`No project configuration found in ${absolutePath}`); messages.hint( 'For monorepo: ensure project.json exists with sourceTemplate field\n' + 'For monolith: ensure toolkit.yaml exists at workspace root\n' + 'Or use --template option to list methods for a specific template', ); process.exit(1); } result = await scaffoldingMethodsService.listScaffoldingMethods( absolutePath, options.cursor, ); displayName = projectPath; } else { // Use template name result = await scaffoldingMethodsService.listScaffoldingMethodsByTemplate( options.template, options.cursor, ); displayName = `template: ${options.template}`; } const methods = result.methods; if (methods.length === 0) { messages.warning(`No scaffolding methods available for ${displayName}.`); return; } print.header(`\n${icons.wrench} Available Scaffolding Methods for ${displayName}:\n`); for (const method of methods) { print.highlight(` ${method.name}`); print.debug( ` ${method.instruction || method.description || 'No description available'}`, ); if (method.variables_schema.required && method.variables_schema.required.length > 0) { print.debug(` Required: ${method.variables_schema.required.join(', ')}`); } print.newline(); } // Show pagination info if there are more results if (result.nextCursor) { print.newline(); print.info(`${icons.info} More results available. Use --cursor to fetch next page:`); const cursorOption = `--cursor "${result.nextCursor}"`; if (projectPath) { print.debug(` scaffold-mcp scaffold list ${projectPath} ${cursorOption}`); } else { print.debug( ` scaffold-mcp scaffold list --template ${options.template} ${cursorOption}`, ); } } } catch (error) { messages.error('Error listing scaffolding methods:', error as Error); process.exit(1); } }); // Add command scaffoldCommand .command('add <featureName>') .description('Add a feature to an existing project') .option('-p, --project <path>', 'Project path', process.cwd()) .option('-v, --vars <json>', 'JSON string containing variables for the feature') .option('--verbose', 'Enable verbose logging') .action(async (featureName, options) => { try { const projectPath = path.resolve(options.project); // Verify project configuration exists (supports both monolith and monorepo) const hasConfig = await ProjectConfigResolver.hasConfiguration(projectPath); if (!hasConfig) { messages.error(`No project configuration found in ${projectPath}`); messages.hint( 'For monorepo: ensure project.json exists with sourceTemplate field\n' + 'For monolith: ensure toolkit.yaml exists at workspace root', ); process.exit(1); } // Parse variables let variables = {}; if (options.vars) { try { variables = JSON.parse(options.vars); } catch (error) { messages.error('Error parsing variables JSON:', error as Error); messages.hint( 'Example: --vars \'{"componentName": "UserProfile", "description": "User profile component"}\'', ); process.exit(1); } } const templatesDir = await TemplatesManagerService.findTemplatesPath(); if (!templatesDir) { messages.error( 'Templates folder not found. Create a templates folder or specify templatesPath in toolkit.yaml', ); process.exit(1); } const fileSystemService = new FileSystemService(); const scaffoldingMethodsService = new ScaffoldingMethodsService( fileSystemService, templatesDir, ); // Get scaffold method info - fetch all pages to find the method let allMethods: any[] = []; let cursor: string | undefined; do { const listResult = await scaffoldingMethodsService.listScaffoldingMethods( projectPath, cursor, ); allMethods = allMethods.concat(listResult.methods); cursor = listResult.nextCursor; } while (cursor); const method = allMethods.find((m) => m.name === featureName); if (!method) { messages.error(`Scaffold method '${featureName}' not found.`); print.warning(`Available methods: ${allMethods.map((m) => m.name).join(', ')}`); print.debug( `Run 'scaffold-mcp scaffold list ${options.project}' to see all available methods`, ); process.exit(1); } // Check for required variables const required = typeof method.variables_schema === 'object' && method.variables_schema !== null && 'required' in method.variables_schema ? (method.variables_schema.required as string[]) : []; const missing = required.filter( (key: string) => !(variables as Record<string, unknown>)[key], ); if (missing.length > 0) { messages.error(`❌ Missing required variables: ${missing.join(', ')}`); messages.hint(`💡 Use --vars with a JSON object containing: ${missing.join(', ')}`); const exampleVars: Record<string, any> = {}; for (const key of required) { if (key.includes('Name')) { exampleVars[key] = 'MyFeature'; } else if (key === 'description') { exampleVars[key] = 'Feature description'; } else { exampleVars[key] = `<${key}>`; } } print.debug( `Example: scaffold-mcp scaffold add ${featureName} --project ${options.project} --vars '${JSON.stringify(exampleVars)}'`, ); process.exit(1); } if (options.verbose) { print.info(`🔧 Feature: ${featureName}`); print.info(`📊 Variables: ${JSON.stringify(variables, null, 2)}`); print.info(`📁 Project Path: ${projectPath}`); } print.info(`🚀 Adding '${featureName}' to project...`); const result = await scaffoldingMethodsService.useScaffoldMethod({ projectPath, scaffold_feature_name: featureName, variables, }); if (result.success) { messages.success('✅ Feature added successfully!'); if (result.createdFiles && result.createdFiles.length > 0) { print.header('\n📁 Created files:'); result.createdFiles.forEach((file) => print.debug(` - ${file}`)); } if (result.warnings && result.warnings.length > 0) { messages.warning('\n⚠️ Warnings:'); result.warnings.forEach((warning) => print.debug(` - ${warning}`)); } print.header('\n📋 Next steps:'); print.debug(' - Review the generated files'); print.debug(' - Update imports if necessary'); print.debug(' - Run tests to ensure everything works'); } else { messages.error(`❌ Failed to add feature: ${result.message}`); process.exit(1); } } catch (error) { messages.error(`❌ Error adding feature: ${(error as Error).message}`); process.exit(1); } }); // Info command scaffoldCommand .command('info <featureName>') .description('Show detailed information about a scaffold method') .option('-p, --project <path>', 'Project path') .option('-t, --template <name>', 'Template name (e.g., nextjs-15, typescript-mcp-package)') .action(async (featureName, options) => { try { // Require either project or template option if (!options.project && !options.template) { messages.error('Either --project or --template option must be provided'); messages.hint('Examples:'); print.debug(' scaffold-mcp scaffold info scaffold-route --project ./my-app'); print.debug(' scaffold-mcp scaffold info scaffold-route --template nextjs-15'); process.exit(1); } const templatesDir = await TemplatesManagerService.findTemplatesPath(); if (!templatesDir) { messages.error( 'Templates folder not found. Create a templates folder or specify templatesPath in toolkit.yaml', ); process.exit(1); } const fileSystemService = new FileSystemService(); const scaffoldingMethodsService = new ScaffoldingMethodsService( fileSystemService, templatesDir, ); // Fetch all pages to find the method let allMethods: any[] = []; let cursor: string | undefined; if (options.project) { // Use project path const projectPath = path.resolve(options.project); // Verify project configuration exists (supports both monolith and monorepo) const hasConfig = await ProjectConfigResolver.hasConfiguration(projectPath); if (!hasConfig) { messages.error(`No project configuration found in ${projectPath}`); messages.hint( 'For monorepo: ensure project.json exists with sourceTemplate field\n' + 'For monolith: ensure toolkit.yaml exists at workspace root\n' + 'Or use --template option to view info for a specific template', ); process.exit(1); } // Fetch all pages do { const result = await scaffoldingMethodsService.listScaffoldingMethods( projectPath, cursor, ); allMethods = allMethods.concat(result.methods); cursor = result.nextCursor; } while (cursor); } else { // Use template name - fetch all pages do { const result = await scaffoldingMethodsService.listScaffoldingMethodsByTemplate( options.template, cursor, ); allMethods = allMethods.concat(result.methods); cursor = result.nextCursor; } while (cursor); } const method = allMethods.find((m) => m.name === featureName); if (!method) { messages.error(`❌ Scaffold method '${featureName}' not found.`); process.exit(1); } print.header(`\n🔧 Scaffold Method: ${method.name}\n`); print.debug(`Description: ${method.description}`); print.header('\n📝 Variables Schema:'); print.debug(JSON.stringify(method.variables_schema, null, 2)); const includes = 'includes' in method ? (method.includes as string[]) : []; if (includes && includes.length > 0) { print.header('\n📁 Files to be created:'); includes.forEach((include: string) => { const parts = include.split('>>'); if (parts.length === 2) { print.debug(` - ${parts[1].trim()}`); } else { print.debug(` - ${include}`); } }); } } catch (error) { messages.error(`❌ Error getting scaffold info: ${(error as Error).message}`); process.exit(1); } });