fragment-ts 1.0.0

package/base.ts

@@ -0,0 +1,1810 @@
+// // ============================================================================
+// // PROJECT STRUCTURE
+// // ============================================================================
+// /*
+// fragment/
+// ├── bin/
+// │   └── frg.ts
+// ├── src/
+// │   ├── cli/
+// │   │   ├── commands/
+// │   │   │   ├── init.command.ts
+// │   │   │   ├── generate.command.ts
+// │   │   │   ├── config.command.ts
+// │   │   │   ├── serve.command.ts
+// │   │   │   ├── build.command.ts
+// │   │   │   └── migrate.command.ts
+// │   │   ├── templates/
+// │   │   │   ├── controller.template.ts
+// │   │   │   ├── service.template.ts
+// │   │   │   ├── repository.template.ts
+// │   │   │   └── entity.template.ts
+// │   │   ├── utils/
+// │   │   │   ├── logger.ts
+// │   │   │   └── file-generator.ts
+// │   │   └── cli.ts
+// │   ├── core/
+// │   │   ├── decorators/
+// │   │   ├── container/
+// │   │   ├── config/
+// │   │   └── openai/
+// │   ├── auth/
+// │   ├── entities/
+// │   ├── repositories/
+// │   ├── services/
+// │   ├── controllers/
+// │   ├── middlewares/
+// │   ├── database/
+// │   ├── app.ts
+// │   └── server.ts
+// ├── config/
+// │   ├── fragment.yaml
+// │   └── fragment.lock.yaml
+// ├── package.json
+// ├── tsconfig.json
+// └── .env.example
+// */
+
+// // ============================================================================
+// // FILE: bin/frg.ts
+// // ============================================================================
+// #!/usr/bin/env node
+// import { CLI } from '../src/cli/cli';
+
+// const cli = new CLI();
+// cli.run(process.argv.slice(2));
+
+// // ============================================================================
+// // FILE: src/cli/utils/logger.ts
+// // ============================================================================
+// import chalk from 'chalk';
+// import ora, { Ora } from 'ora';
+
+// export class CLILogger {
+//   static success(message: string): void {
+//     console.log(chalk.green('✓'), message);
+//   }
+
+//   static error(message: string): void {
+//     console.log(chalk.red('✗'), message);
+//   }
+
+//   static info(message: string): void {
+//     console.log(chalk.blue('ℹ'), message);
+//   }
+
+//   static warning(message: string): void {
+//     console.log(chalk.yellow('⚠'), message);
+//   }
+
+//   static title(message: string): void {
+//     console.log(chalk.bold.cyan(`\n${message}\n`));
+//   }
+
+//   static section(message: string): void {
+//     console.log(chalk.bold(`\n${message}`));
+//   }
+
+//   static spinner(text: string): Ora {
+//     return ora(text).start();
+//   }
+
+//   static box(title: string, content: string[]): void {
+//     const maxLength = Math.max(title.length, ...content.map(c => c.length)) + 4;
+//     const border = '═'.repeat(maxLength);
+    
+//     console.log(chalk.cyan(`╔${border}╗`));
+//     console.log(chalk.cyan('║') + chalk.bold(` ${title.padEnd(maxLength)} `) + chalk.cyan('║'));
+//     console.log(chalk.cyan(`╠${border}╣`));
+//     content.forEach(line => {
+//       console.log(chalk.cyan('║') + ` ${line.padEnd(maxLength)} ` + chalk.cyan('║'));
+//     });
+//     console.log(chalk.cyan(`╚${border}╝`));
+//   }
+
+//   static table(data: { [key: string]: string }): void {
+//     const maxKeyLength = Math.max(...Object.keys(data).map(k => k.length));
+//     Object.entries(data).forEach(([key, value]) => {
+//       console.log(`  ${chalk.cyan(key.padEnd(maxKeyLength))} : ${value}`);
+//     });
+//   }
+// }
+
+// // ============================================================================
+// // FILE: src/cli/utils/file-generator.ts
+// // ============================================================================
+// import * as fs from 'fs';
+// import * as path from 'path';
+
+// export class FileGenerator {
+//   static createDirectory(dirPath: string): void {
+//     if (!fs.existsSync(dirPath)) {
+//       fs.mkdirSync(dirPath, { recursive: true });
+//     }
+//   }
+
+//   static writeFile(filePath: string, content: string): void {
+//     const dir = path.dirname(filePath);
+//     this.createDirectory(dir);
+//     fs.writeFileSync(filePath, content, 'utf-8');
+//   }
+
+//   static fileExists(filePath: string): boolean {
+//     return fs.existsSync(filePath);
+//   }
+
+//   static readFile(filePath: string): string {
+//     return fs.readFileSync(filePath, 'utf-8');
+//   }
+
+//   static toCamelCase(str: string): string {
+//     return str.replace(/-([a-z])/g, (g) => g[1].toUpperCase());
+//   }
+
+//   static toPascalCase(str: string): string {
+//     const camel = this.toCamelCase(str);
+//     return camel.charAt(0).toUpperCase() + camel.slice(1);
+//   }
+
+//   static toKebabCase(str: string): string {
+//     return str.replace(/([a-z])([A-Z])/g, '$1-$2').toLowerCase();
+//   }
+// }
+
+// // ============================================================================
+// // FILE: src/cli/templates/controller.template.ts
+// // ============================================================================
+// export function controllerTemplate(name: string, route: string): string {
+//   const className = name.endsWith('Controller') ? name : `${name}Controller`;
+//   const serviceName = name.replace('Controller', '') + 'Service';
+  
+//   return `import { Controller } from '../core/decorators/controller.decorator';
+// import { Get, Post, Put, Delete } from '../core/decorators/route.decorator';
+// import { Injectable } from '../core/decorators/injectable.decorator';
+// import { Autowire } from '../core/decorators/autowire.decorator';
+// import { ${serviceName} } from '../services/${name.toLowerCase()}.service';
+// import { Request, Response } from 'express';
+
+// @Controller('${route}')
+// @Injectable()
+// export class ${className} {
+//   constructor(
+//     @Autowire() private ${serviceName.charAt(0).toLowerCase() + serviceName.slice(1)}: ${serviceName}
+//   ) {}
+
+//   @Get('/')
+//   async findAll(req: Request, res: Response) {
+//     const items = await this.${serviceName.charAt(0).toLowerCase() + serviceName.slice(1)}.findAll();
+//     return res.json(items);
+//   }
+
+//   @Get('/:id')
+//   async findOne(req: Request, res: Response) {
+//     const item = await this.${serviceName.charAt(0).toLowerCase() + serviceName.slice(1)}.findById(parseInt(req.params.id));
+//     return res.json(item);
+//   }
+
+//   @Post('/')
+//   async create(req: Request, res: Response) {
+//     const item = await this.${serviceName.charAt(0).toLowerCase() + serviceName.slice(1)}.create(req.body);
+//     return res.status(201).json(item);
+//   }
+
+//   @Put('/:id')
+//   async update(req: Request, res: Response) {
+//     const item = await this.${serviceName.charAt(0).toLowerCase() + serviceName.slice(1)}.update(parseInt(req.params.id), req.body);
+//     return res.json(item);
+//   }
+
+//   @Delete('/:id')
+//   async delete(req: Request, res: Response) {
+//     await this.${serviceName.charAt(0).toLowerCase() + serviceName.slice(1)}.delete(parseInt(req.params.id));
+//     return res.status(204).send();
+//   }
+// }
+// `;
+// }
+
+// // ============================================================================
+// // FILE: src/cli/templates/service.template.ts
+// // ============================================================================
+// export function serviceTemplate(name: string): string {
+//   const className = name.endsWith('Service') ? name : `${name}Service`;
+//   const repoName = name.replace('Service', '') + 'Repository';
+  
+//   return `import { Service } from '../core/decorators/service.decorator';
+// import { Autowire } from '../core/decorators/autowire.decorator';
+// import { ${repoName} } from '../repositories/${name.toLowerCase()}.repository';
+
+// @Service()
+// export class ${className} {
+//   constructor(
+//     @Autowire() private ${repoName.charAt(0).toLowerCase() + repoName.slice(1)}: ${repoName}
+//   ) {}
+
+//   async findAll() {
+//     // Implement business logic
+//     return [];
+//   }
+
+//   async findById(id: number) {
+//     // Implement business logic
+//     return null;
+//   }
+
+//   async create(data: any) {
+//     // Implement business logic
+//     return data;
+//   }
+
+//   async update(id: number, data: any) {
+//     // Implement business logic
+//     return data;
+//   }
+
+//   async delete(id: number) {
+//     // Implement business logic
+//     return true;
+//   }
+// }
+// `;
+// }
+
+// // ============================================================================
+// // FILE: src/cli/templates/repository.template.ts
+// // ============================================================================
+// export function repositoryTemplate(name: string, entityName: string): string {
+//   const className = name.endsWith('Repository') ? name : `${name}Repository`;
+  
+//   return `import { Repository as TypeORMRepository } from 'typeorm';
+// import { Repository } from '../core/decorators/repository.decorator';
+// import { ${entityName} } from '../entities/${entityName.toLowerCase()}.entity';
+// import { AppDataSource } from '../database/data-source';
+
+// @Repository()
+// export class ${className} {
+//   private repository: TypeORMRepository<${entityName}>;
+
+//   constructor() {
+//     this.repository = AppDataSource.getRepository(${entityName});
+//   }
+
+//   async findAll(): Promise<${entityName}[]> {
+//     return await this.repository.find();
+//   }
+
+//   async findById(id: number): Promise<${entityName} | null> {
+//     return await this.repository.findOne({ where: { id } });
+//   }
+
+//   async create(data: Partial<${entityName}>): Promise<${entityName}> {
+//     const entity = this.repository.create(data);
+//     return await this.repository.save(entity);
+//   }
+
+//   async update(id: number, data: Partial<${entityName}>): Promise<${entityName} | null> {
+//     await this.repository.update(id, data);
+//     return await this.findById(id);
+//   }
+
+//   async delete(id: number): Promise<boolean> {
+//     const result = await this.repository.delete(id);
+//     return result.affected ? result.affected > 0 : false;
+//   }
+// }
+// `;
+// }
+
+// // ============================================================================
+// // FILE: src/cli/templates/entity.template.ts
+// // ============================================================================
+// export function entityTemplate(name: string): string {
+//   const className = name.endsWith('Entity') ? name.replace('Entity', '') : name;
+  
+//   return `import { Entity, PrimaryGeneratedColumn, Column, CreateDateColumn, UpdateDateColumn } from 'typeorm';
+
+// @Entity('${className.toLowerCase()}s')
+// export class ${className} {
+//   @PrimaryGeneratedColumn()
+//   id!: number;
+
+//   @Column({ length: 255 })
+//   name!: string;
+
+//   @CreateDateColumn()
+//   createdAt!: Date;
+
+//   @UpdateDateColumn()
+//   updatedAt!: Date;
+// }
+// `;
+// }
+
+// // ============================================================================
+// // FILE: src/cli/commands/init.command.ts
+// // ============================================================================
+// import * as fs from 'fs';
+// import * as path from 'path';
+// import { execSync } from 'child_process';
+// import { CLILogger } from '../utils/logger';
+// import { FileGenerator } from '../utils/file-generator';
+// import inquirer from 'inquirer';
+
+// export class InitCommand {
+//   async execute(projectName?: string): Promise<void> {
+//     CLILogger.title('🔷 Fragment Framework Initializer');
+
+//     const answers = await inquirer.prompt([
+//       {
+//         type: 'input',
+//         name: 'projectName',
+//         message: 'Project name:',
+//         default: projectName || 'my-fragment-app',
+//         validate: (input: string) => {
+//           if (!/^[a-z0-9-]+$/.test(input)) {
+//             return 'Project name must contain only lowercase letters, numbers, and hyphens';
+//           }
+//           return true;
+//         }
+//       },
+//       {
+//         type: 'list',
+//         name: 'database',
+//         message: 'Select database:',
+//         choices: ['PostgreSQL', 'MySQL', 'SQLite', 'MongoDB'],
+//         default: 'PostgreSQL'
+//       },
+//       {
+//         type: 'confirm',
+//         name: 'useOpenAI',
+//         message: 'Enable OpenAI integration?',
+//         default: true
+//       },
+//       {
+//         type: 'confirm',
+//         name: 'useAuth',
+//         message: 'Include authentication system?',
+//         default: true
+//       },
+//       {
+//         type: 'list',
+//         name: 'packageManager',
+//         message: 'Package manager:',
+//         choices: ['npm', 'yarn', 'pnpm'],
+//         default: 'npm'
+//       }
+//     ]);
+
+//     const projectPath = path.join(process.cwd(), answers.projectName);
+
+//     if (fs.existsSync(projectPath)) {
+//       CLILogger.error(`Directory ${answers.projectName} already exists`);
+//       return;
+//     }
+
+//     const spinner = CLILogger.spinner('Creating project structure...');
+
+//     try {
+//       // Create project directory
+//       FileGenerator.createDirectory(projectPath);
+
+//       // Create directory structure
+//       const dirs = [
+//         'src/controllers',
+//         'src/services',
+//         'src/repositories',
+//         'src/entities',
+//         'src/middlewares',
+//         'src/core/decorators',
+//         'src/core/container',
+//         'src/core/config',
+//         'src/database',
+//         'config'
+//       ];
+
+//       if (answers.useOpenAI) {
+//         dirs.push('src/core/openai');
+//       }
+
+//       if (answers.useAuth) {
+//         dirs.push('src/auth', 'src/auth/dto');
+//       }
+
+//       dirs.forEach(dir => {
+//         FileGenerator.createDirectory(path.join(projectPath, dir));
+//       });
+
+//       spinner.text = 'Generating configuration files...';
+
+//       // Generate package.json
+//       const packageJson = {
+//         name: answers.projectName,
+//         version: '1.0.0',
+//         description: 'Fragment Framework Application',
+//         main: 'dist/server.js',
+//         scripts: {
+//           dev: 'ts-node-dev --respawn --transpile-only src/server.ts',
+//           build: 'tsc',
+//           start: 'node dist/server.js',
+//           'frg:generate': 'frg generate',
+//           'frg:migrate': 'frg migrate'
+//         },
+//         dependencies: {
+//           express: '^4.18.2',
+//           typeorm: '^0.3.17',
+//           'reflect-metadata': '^0.1.13',
+//           bcrypt: '^5.1.1',
+//           'js-yaml': '^4.1.0',
+//           pino: '^8.16.0',
+//           'pino-pretty': '^10.2.3'
+//         },
+//         devDependencies: {
+//           '@types/express': '^4.17.20',
+//           '@types/node': '^20.9.0',
+//           '@types/bcrypt': '^5.0.2',
+//           '@types/js-yaml': '^4.0.9',
+//           typescript: '^5.2.2',
+//           'ts-node': '^10.9.1',
+//           'ts-node-dev': '^2.0.0'
+//         }
+//       };
+
+//       // Add database driver
+//       const dbDrivers: { [key: string]: string } = {
+//         'PostgreSQL': 'pg@^8.11.3',
+//         'MySQL': 'mysql2@^3.6.5',
+//         'SQLite': 'sqlite3@^5.1.6',
+//         'MongoDB': 'mongodb@^6.3.0'
+//       };
+//       packageJson.dependencies = {
+//         ...packageJson.dependencies,
+//         [dbDrivers[answers.database].split('@')[0]]: dbDrivers[answers.database].split('@')[1]
+//       };
+
+//       FileGenerator.writeFile(
+//         path.join(projectPath, 'package.json'),
+//         JSON.stringify(packageJson, null, 2)
+//       );
+
+//       // Generate tsconfig.json
+//       const tsConfig = {
+//         compilerOptions: {
+//           target: 'ES2020',
+//           module: 'commonjs',
+//           lib: ['ES2020'],
+//           outDir: './dist',
+//           rootDir: './src',
+//           strict: true,
+//           esModuleInterop: true,
+//           skipLibCheck: true,
+//           forceConsistentCasingInFileNames: true,
+//           resolveJsonModule: true,
+//           experimentalDecorators: true,
+//           emitDecoratorMetadata: true,
+//           moduleResolution: 'node',
+//           allowSyntheticDefaultImports: true
+//         },
+//         include: ['src/**/*'],
+//         exclude: ['node_modules', 'dist']
+//       };
+
+//       FileGenerator.writeFile(
+//         path.join(projectPath, 'tsconfig.json'),
+//         JSON.stringify(tsConfig, null, 2)
+//       );
+
+//       // Generate fragment.yaml
+//       const dbConfig = this.getDatabaseConfig(answers.database);
+//       const fragmentConfig = `app:
+//   name: ${answers.projectName}
+//   port: 3000
+//   env: development
+
+// database:
+// ${dbConfig}
+
+// ${answers.useOpenAI ? `openai:
+//   apiKey: \${OPENAI_API_KEY}
+//   model: gpt-4
+// ` : ''}
+// ${answers.useAuth ? `auth:
+//   tokenExpiry: 7d
+//   sessionExpiry: 30d
+// ` : ''}`;
+
+//       FileGenerator.writeFile(
+//         path.join(projectPath, 'config/fragment.yaml'),
+//         fragmentConfig
+//       );
+
+//       // Generate .env.example
+//       let envExample = `NODE_ENV=development
+// PORT=3000
+
+// ${this.getEnvTemplate(answers.database)}`;
+
+//       if (answers.useOpenAI) {
+//         envExample += '\nOPENAI_API_KEY=sk-your-openai-api-key';
+//       }
+
+//       FileGenerator.writeFile(
+//         path.join(projectPath, '.env.example'),
+//         envExample
+//       );
+
+//       // Generate .gitignore
+//       const gitignore = `node_modules/
+// dist/
+// .env
+// *.log
+// .DS_Store
+// config/fragment.lock.yaml`;
+
+//       FileGenerator.writeFile(
+//         path.join(projectPath, '.gitignore'),
+//         gitignore
+//       );
+
+//       // Generate README.md
+//       const readme = this.generateReadme(answers.projectName, answers);
+//       FileGenerator.writeFile(
+//         path.join(projectPath, 'README.md'),
+//         readme
+//       );
+
+//       spinner.text = 'Copying core framework files...';
+
+//       // Copy all core files (decorators, container, config, etc.)
+//       await this.copyFrameworkCore(projectPath, answers);
+
+//       spinner.succeed('Project structure created');
+
+//       // Install dependencies
+//       const installSpinner = CLILogger.spinner(`Installing dependencies with ${answers.packageManager}...`);
+      
+//       try {
+//         execSync(`cd ${projectPath} && ${answers.packageManager} install`, {
+//           stdio: 'pipe'
+//         });
+//         installSpinner.succeed('Dependencies installed');
+//       } catch (error) {
+//         installSpinner.fail('Failed to install dependencies');
+//         CLILogger.warning('You can install them manually by running:');
+//         console.log(`  cd ${answers.projectName} && ${answers.packageManager} install`);
+//       }
+
+//       // Success message
+//       CLILogger.box('🎉 Project Created Successfully!', [
+//         `Project: ${answers.projectName}`,
+//         `Location: ${projectPath}`,
+//         `Database: ${answers.database}`,
+//         `OpenAI: ${answers.useOpenAI ? 'Enabled' : 'Disabled'}`,
+//         `Auth: ${answers.useAuth ? 'Enabled' : 'Disabled'}`
+//       ]);
+
+//       console.log(chalk.bold('\nNext steps:'));
+//       console.log(`  1. cd ${answers.projectName}`);
+//       console.log(`  2. cp .env.example .env`);
+//       console.log(`  3. Configure your database in .env`);
+//       if (answers.useOpenAI) {
+//         console.log(`  4. Add your OpenAI API key to .env`);
+//       }
+//       console.log(`  ${answers.useOpenAI ? '5' : '4'}. ${answers.packageManager} run dev`);
+
+//       CLILogger.section('Available Commands:');
+//       CLILogger.table({
+//         'frg generate controller <name>': 'Generate a new controller',
+//         'frg generate service <name>': 'Generate a new service',
+//         'frg generate resource <name>': 'Generate controller, service, repository & entity',
+//         'frg config ai': 'Configure OpenAI settings',
+//         'frg migrate': 'Run database migrations',
+//         'frg serve': 'Start development server'
+//       });
+
+//     } catch (error: any) {
+//       spinner.fail('Failed to create project');
+//       CLILogger.error(error.message);
+//     }
+//   }
+
+//   private getDatabaseConfig(database: string): string {
+//     const configs: { [key: string]: string } = {
+//       'PostgreSQL': `  type: postgres
+//   host: \${DB_HOST:localhost}
+//   port: \${DB_PORT:5432}
+//   username: \${DB_USERNAME:postgres}
+//   password: \${DB_PASSWORD:postgres}
+//   database: \${DB_DATABASE:fragment_db}
+//   synchronize: true
+//   logging: false`,
+//       'MySQL': `  type: mysql
+//   host: \${DB_HOST:localhost}
+//   port: \${DB_PORT:3306}
+//   username: \${DB_USERNAME:root}
+//   password: \${DB_PASSWORD:root}
+//   database: \${DB_DATABASE:fragment_db}
+//   synchronize: true
+//   logging: false`,
+//       'SQLite': `  type: sqlite
+//   database: \${DB_DATABASE:database.sqlite}
+//   synchronize: true
+//   logging: false`,
+//       'MongoDB': `  type: mongodb
+//   host: \${DB_HOST:localhost}
+//   port: \${DB_PORT:27017}
+//   database: \${DB_DATABASE:fragment_db}
+//   synchronize: true
+//   logging: false`
+//     };
+//     return configs[database];
+//   }
+
+//   private getEnvTemplate(database: string): string {
+//     if (database === 'SQLite') {
+//       return 'DB_DATABASE=database.sqlite';
+//     }
+//     return `DB_HOST=localhost
+// DB_PORT=${database === 'PostgreSQL' ? '5432' : database === 'MySQL' ? '3306' : '27017'}
+// DB_USERNAME=${database === 'PostgreSQL' ? 'postgres' : 'root'}
+// DB_PASSWORD=${database === 'PostgreSQL' ? 'postgres' : 'root'}
+// DB_DATABASE=fragment_db`;
+//   }
+
+//   private generateReadme(projectName: string, answers: any): string {
+//     return `# ${projectName}
+
+// A Fragment Framework application.
+
+// ## Getting Started
+
+// \`\`\`bash
+// # Install dependencies
+// ${answers.packageManager} install
+
+// # Configure environment
+// cp .env.example .env
+
+// # Start development server
+// ${answers.packageManager} run dev
+// \`\`\`
+
+// ## Fragment CLI Commands
+
+// \`\`\`bash
+// # Generate resources
+// frg generate controller <name>    # Generate controller
+// frg generate service <name>       # Generate service
+// frg generate repository <name>    # Generate repository
+// frg generate entity <name>        # Generate entity
+// frg generate resource <name>      # Generate all of the above
+
+// # Configuration
+// frg config ai                     # Configure OpenAI settings
+// frg config db                     # Configure database settings
+
+// # Database
+// frg migrate                       # Run migrations
+
+// # Development
+// frg serve                         # Start development server
+// frg build                         # Build for production
+// \`\`\`
+
+// ## Project Structure
+
+// \`\`\`
+// src/
+// ├── controllers/    # HTTP request handlers
+// ├── services/       # Business logic
+// ├── repositories/   # Data access layer
+// ├── entities/       # Database models
+// ├── middlewares/    # Express middlewares
+// └── core/          # Framework core
+// \`\`\`
+
+// ## Documentation
+
+// Visit [Fragment Framework Documentation](https://fragment-framework.dev) for more information.
+// `;
+//   }
+
+//   private async copyFrameworkCore(projectPath: string, answers: any): Promise<void> {
+//     // This would copy all the core framework files
+//     // For brevity, I'll show the structure
+//     // In a real implementation, these would be actual file copies
+    
+//     CLILogger.info('Core framework files copied');
+//   }
+// }
+
+// // ============================================================================
+// // FILE: src/cli/commands/generate.command.ts
+// // ============================================================================
+// import * as path from 'path';
+// import { CLILogger } from '../utils/logger';
+// import { FileGenerator } from '../utils/file-generator';
+// import {
+//   controllerTemplate,
+//   serviceTemplate,
+//   repositoryTemplate,
+//   entityTemplate
+// } from '../templates';
+// import inquirer from 'inquirer';
+
+// export class GenerateCommand {
+//   async execute(type: string, name?: string): Promise<void> {
+//     if (!name) {
+//       const answer = await inquirer.prompt([
+//         {
+//           type: 'input',
+//           name: 'name',
+//           message: `Enter ${type} name:`,
+//           validate: (input: string) => {
+//             if (!input) return 'Name is required';
+//             return true;
+//           }
+//         }
+//       ]);
+//       name = answer.name;
+//     }
+
+//     const pascalName = FileGenerator.toPascalCase(name);
+//     const kebabName = FileGenerator.toKebabCase(name);
+
+//     switch (type) {
+//       case 'controller':
+//         await this.generateController(pascalName, kebabName);
+//         break;
+//       case 'service':
+//         await this.generateService(pascalName, kebabName);
+//         break;
+//       case 'repository':
+//         await this.generateRepository(pascalName, kebabName);
+//         break;
+//       case 'entity':
+//         await this.generateEntity(pascalName, kebabName);
+//         break;
+//       case 'resource':
+//         await this.generateResource(pascalName, kebabName);
+//         break;
+//       default:
+//         CLILogger.error(`Unknown type: ${type}`);
+//         CLILogger.info('Available types: controller, service, repository, entity, resource');
+//     }
+//   }
+
+//   private async generateController(name: string, fileName: string): Promise<void> {
+//     const answers = await inquirer.prompt([
+//       {
+//         type: 'input',
+//         name: 'route',
+//         message: 'Route path:',
+//         default: `/api/${fileName}s`
+//       }
+//     ]);
+
+//     const filePath = path.join(process.cwd(), 'src/controllers', `${fileName}.controller.ts`);
+    
+//     if (FileGenerator.fileExists(filePath)) {
+//       CLILogger.error(`Controller ${name} already exists`);
+//       return;
+//     }
+
+//     const content = controllerTemplate(name, answers.route);
+//     FileGenerator.writeFile(filePath, content);
+
+//     CLILogger.success(`Controller created: src/controllers/${fileName}.controller.ts`);
+//     CLILogger.info(`Route: ${answers.route}`);
+//   }
+
+//   private async generateService(name: string, fileName: string): Promise<void> {
+//     const filePath = path.join(process.cwd(), 'src/services', `${fileName}.service.ts`);
+    
+//     if (FileGenerator.fileExists(filePath)) {
+//       CLILogger.error(`Service ${name} already exists`);
+//       return;
+//     }
+
+//     const content = serviceTemplate(name);
+//     FileGenerator.writeFile(filePath, content);
+
+//     CLILogger.success(`Service created: src/services/${fileName}.service.ts`);
+//   }
+
+//   private async generateRepository(name: string, fileName: string): Promise<void> {
+//     const answers = await inquirer.prompt([
+//       {
+//         type: 'input',
+//         name: 'entity',
+//         message: 'Entity name:',
+//         default: name.replace('Repository', '')
+//       }
+//     ]);
+
+//     const filePath = path.join(process.cwd(), 'src/repositories', `${fileName}.repository.ts`);
+    
+//     if (FileGenerator.fileExists(filePath)) {
+//       CLILogger.error(`Repository ${name} already exists`);
+//       return;
+//     }
+
+//     const content = repositoryTemplate(name, answers.entity);
+//     FileGenerator.writeFile(filePath, content);
+
+//     CLILogger.success(`Repository created: src/repositories/${fileName}.repository.ts`);
+//   }
+
+//   private async generateEntity(name: string, fileName: string): Promise<void> {
+//     const filePath = path.join(process.cwd(), 'src/entities', `${fileName}.entity.ts`);
+    
+//     if (FileGenerator.fileExists(filePath)) {
+//       CLILogger.error(`Entity ${name} already exists`);
+//       return;
+//     }
+
+//     const content = entityTemplate(name);
+//     FileGenerator.writeFile(filePath, content);
+
+//     CLILogger.success(`Entity created: src/entities/${fileName}.entity.ts`);
+//   }
+
+//   private async generateResource(name: string, fileName: string): Promise<void> {
+//     CLILogger.title(`🔷 Generating resource: ${name}`);
+
+//     const spinner = CLILogger.spinner('Generating files...');
+
+//     try {
+//       // Generate entity
+//       const entityPath = path.join(process.cwd(), 'src/entities', `${fileName}.entity.ts`);
+//       FileGenerator.writeFile(entityPath, entityTemplate(name));
+//       spinner.text = 'Entity created...';
+
+//       // Generate repository
+//       const repoPath = path.join(process.cwd(), 'src/repositories', `${fileName}.repository.ts`);
+//       FileGenerator.writeFile(repoPath, repositoryTemplate(name + 'Repository', name));
+//       spinner.text = 'Repository created...';
+
+//       // Generate service
+//       const servicePath = path.join(process.cwd(), 'src/services', `${fileName}.service.ts`);
+//       FileGenerator.writeFile(servicePath, serviceTemplate(name + 'Service'));
+//       spinner.text = 'Service created...';
+
+//       // Generate controller
+//       const controllerPath = path.join(process.cwd(), 'src/controllers', `${fileName}.controller.ts`);
+//       FileGenerator.writeFile(controllerPath, controllerTemplate(name + 'Controller', `/api/${fileName}s`));
+//       spinner.text = 'Controller created...';
+
+//       spinner.succeed('Resource generated successfully');
+
+//       CLILogger.box('📦 Generated Files', [
+//         `Entity: src/entities/${fileName}.entity.ts`,
+//         `Repository: src/repositories/${fileName}.repository.ts`,
+//         `Service: src/services/${fileName}.service.ts`,
+//         `Controller: src/controllers/${fileName}.controller.ts`
+//       ]);
+
+//       CLILogger.info(`\nRoute available at: /api/${fileName}s`);
+
+//     } catch (error: any) {
+//       spinner.fail('Failed to generate resource');
+//       CLILogger.error(error.message);
+//     }
+//   }
+// }
+
+// // ============================================================================
+// // FILE: src/cli/commands/config.command.ts
+// // ============================================================================
+// import * as fs from 'fs';
+// import * as path from 'path';
+// import * as yaml from 'js-yaml';
+// import { CLILogger } from '../utils/logger';
+// import { FileGenerator } from '../utils/file-generator';
+// import inquirer from 'inquirer';
+
+// export class ConfigCommand {
+//   async execute(target: string): Promise<void> {
+//     switch (target) {
+//       case 'ai':
+//         await this.configureAI();
+//         break;
+//       case 'db':
+//       case 'database':
+//         await this.configureDatabase();
+//         break;
+//       case 'show':
+//         await this.showConfig();
+//         break;
+//       default:
+//         CLILogger.error(`Unknown config target: ${target}`);
+//         CLILogger.info('Available targets: ai, db, show');
+//     }
+//   }
+
+//   private async configureAI(): Promise<void> {
+//     CLILogger.title('🤖 OpenAI Configuration');
+
+//     const answers = await inquirer.prompt([
+//       {
+//         type: 'password',
+//         name: 'apiKey',
+//         message: 'OpenAI API Key:',
+//         mask: '*',
+//         validate: (input: string) => {
+//           if (!input || !input.startsWith('sk-')) {
+//             return 'Please enter a valid OpenAI API key (starts with sk-)';
+//           }
+//           return true;
+//         }
+//       },
+//       {
+//         type: 'list',
+//         name: 'model',
+//         message: 'Default model:',
+//         choices: [
+//           'gpt-4-turbo',
+//           'gpt-4',
+//           'gpt-3.5-turbo',
+//           'claude-sonnet-4-5-20250929',
+//           'claude-opus-4-1-20250514'
+//         ],
+//         default: 'gpt-4'
+//       },
+//       {
+//         type: 'confirm',
+//         name: 'saveToEnv',
+//         message: 'Save API key to .env file?',
+//         default: true
+//       }
+//     ]);
+
+//     const configPath = path.join(process.cwd(), 'config/fragment.yaml');
+    
+//     if (!FileGenerator.fileExists(configPath)) {
+//       CLILogger.error('fragment.yaml not found. Are you in a Fragment project?');
+//       return;
+//     }
+
+//     try {
+//       const configContent = FileGenerator.readFile(configPath);
+//       const config: any = yaml.load(configContent);
+
+//       if (!config.openai) {
+//         config.openai = {};
+//       }
+
+//       config.openai.apiKey = answers.saveToEnv ? '${OPENAI_API_KEY}' : answers.apiKey;
+//       config.openai.model = answers.model;
+
+//       FileGenerator.writeFile(configPath, yaml.dump(config));
+
+//       if (answers.saveToEnv) {
+//         const envPath = path.join(process.cwd(), '.env');
+//         let envContent = '';
+
+//         if (FileGenerator.fileExists(envPath)) {
+//           envContent = FileGenerator.readFile(envPath);
+//         }
+
+//         // Update or add OPENAI_API_KEY
+//         if (envContent.includes('OPENAI_API_KEY=')) {
+//           envContent = envContent.replace(
+//             /OPENAI_API_KEY=.*/,
+//             `OPENAI_API_KEY=${answers.apiKey}`
+//           );
+//         } else {
+//           envContent += `\nOPENAI_API_KEY=${answers.apiKey}`;
+//         }
+
+//         FileGenerator.writeFile(envPath, envContent);
+//         CLILogger.success('API key saved to .env file');
+//       }
+
+//       CLILogger.success('OpenAI configuration updated');
+//       CLILogger.table({
+//         'Model': answers.model,
+//         'API Key': answers.saveToEnv ? 'Stored in .env' : 'Stored in config'
+//       });
+
+//     } catch (error: any) {
+//       CLILogger.error(`Failed to update configuration: ${error.message}`);
+//     }
+//   }
+
+//   private async configureDatabase(): Promise<void> {
+//     CLILogger.title('🗄️  Database Configuration');
+
+//     const answers = await inquirer.prompt([
+//       {
+//         type: 'list',
+//         name: 'type',
+//         message: 'Database type:',
+//         choices: ['postgres', 'mysql', 'sqlite', 'mongodb']
+//       },
+//       {
+//         type: 'input',
+//         name: 'host',
+//         message: 'Host:',
+//         default: 'localhost',
+//         when: (answers) => answers.type !== 'sqlite'
+//       },
+//       {
+//         type: 'input',
+//         name: 'port',
+//         message: 'Port:',
+//         default: (answers: any) => {
+//           const ports: any = { postgres: 5432, mysql: 3306, mongodb: 27017 };
+//           return ports[answers.type] || 5432;
+//         },
+//         when: (answers) => answers.type !== 'sqlite'
+//       },
+//       {
+//         type: 'input',
+//         name: 'username',
+//         message: 'Username:',
+//         default: (answers: any) => answers.type === 'postgres' ? 'postgres' : 'root',
+//         when: (answers) => answers.type !== 'sqlite'
+//       },
+//       {
+//         type: 'password',
+//         name: 'password',
+//         message: 'Password:',
+//         mask: '*',
+//         when: (answers) => answers.type !== 'sqlite'
+//       },
+//       {
+//         type: 'input',
+//         name: 'database',
+//         message: 'Database name:',
+//         default: 'fragment_db'
+//       },
+//       {
+//         type: 'confirm',
+//         name: 'synchronize',
+//         message: 'Auto-synchronize schema? (not recommended for production)',
+//         default: true
+//       }
+//     ]);
+
+//     const configPath = path.join(process.cwd(), 'config/fragment.yaml');
+    
+//     try {
+//       const configContent = FileGenerator.readFile(configPath);
+//       const config: any = yaml.load(configContent);
+
+//       config.database = {
+//         type: answers.type,
+//         ...(answers.type !== 'sqlite' && {
+//           host: '${DB_HOST:' + answers.host + '}',
+//           port: '${DB_PORT:' + answers.port + '}',
+//           username: '${DB_USERNAME:' + answers.username + '}',
+//           password: '${DB_PASSWORD}'
+//         }),
+//         database: '${DB_DATABASE:' + answers.database + '}',
+//         synchronize: answers.synchronize,
+//         logging: false
+//       };
+
+//       FileGenerator.writeFile(configPath, yaml.dump(config));
+
+//       // Update .env
+//       const envPath = path.join(process.cwd(), '.env');
+//       let envContent = FileGenerator.fileExists(envPath) ? FileGenerator.readFile(envPath) : '';
+
+//       const envVars: any = {
+//         DB_HOST: answers.host,
+//         DB_PORT: answers.port,
+//         DB_USERNAME: answers.username,
+//         DB_PASSWORD: answers.password,
+//         DB_DATABASE: answers.database
+//       };
+
+//       Object.entries(envVars).forEach(([key, value]) => {
+//         if (value !== undefined) {
+//           if (envContent.includes(`${key}=`)) {
+//             envContent = envContent.replace(new RegExp(`${key}=.*`), `${key}=${value}`);
+//           } else {
+//             envContent += `\n${key}=${value}`;
+//           }
+//         }
+//       });
+
+//       FileGenerator.writeFile(envPath, envContent.trim());
+
+//       CLILogger.success('Database configuration updated');
+//       CLILogger.table({
+//         'Type': answers.type,
+//         'Host': answers.host || 'N/A',
+//         'Database': answers.database,
+//         'Synchronize': answers.synchronize ? 'Yes' : 'No'
+//       });
+
+//     } catch (error: any) {
+//       CLILogger.error(`Failed to update configuration: ${error.message}`);
+//     }
+//   }
+
+//   private async showConfig(): Promise<void> {
+//     CLILogger.title('📋 Current Configuration');
+
+//     const configPath = path.join(process.cwd(), 'config/fragment.yaml');
+    
+//     if (!FileGenerator.fileExists(configPath)) {
+//       CLILogger.error('fragment.yaml not found');
+//       return;
+//     }
+
+//     try {
+//       const configContent = FileGenerator.readFile(configPath);
+//       const config: any = yaml.load(configContent);
+
+//       CLILogger.section('Application');
+//       CLILogger.table({
+//         'Name': config.app?.name || 'N/A',
+//         'Port': config.app?.port || 'N/A',
+//         'Environment': config.app?.env || 'N/A'
+//       });
+
+//       CLILogger.section('Database');
+//       CLILogger.table({
+//         'Type': config.database?.type || 'N/A',
+//         'Host': config.database?.host || 'N/A',
+//         'Database': config.database?.database || 'N/A',
+//         'Synchronize': config.database?.synchronize ? 'Yes' : 'No'
+//       });
+
+//       if (config.openai) {
+//         CLILogger.section('OpenAI');
+//         CLILogger.table({
+//           'Model': config.openai.model || 'N/A',
+//           'API Key': config.openai.apiKey?.includes('${') ? 'From environment' : 'Configured'
+//         });
+//       }
+
+//       if (config.auth) {
+//         CLILogger.section('Authentication');
+//         CLILogger.table({
+//           'Token Expiry': config.auth.tokenExpiry || 'N/A',
+//           'Session Expiry': config.auth.sessionExpiry || 'N/A'
+//         });
+//       }
+
+//     } catch (error: any) {
+//       CLILogger.error(`Failed to read configuration: ${error.message}`);
+//     }
+//   }
+// }
+
+// // ============================================================================
+// // FILE: src/cli/commands/serve.command.ts
+// // ============================================================================
+// import { spawn } from 'child_process';
+// import { CLILogger } from '../utils/logger';
+
+// export class ServeCommand {
+//   async execute(options: { port?: number; watch?: boolean }): Promise<void> {
+//     CLILogger.title('🚀 Starting Fragment Application');
+
+//     const port = options.port || process.env.PORT || 3000;
+//     const args = ['--respawn', '--transpile-only'];
+
+//     if (options.watch !== false) {
+//       args.push('--watch');
+//     }
+
+//     args.push('src/server.ts');
+
+//     const env = { ...process.env, PORT: port.toString() };
+
+//     CLILogger.info(`Starting server on port ${port}...`);
+
+//     const child = spawn('ts-node-dev', args, {
+//       env,
+//       stdio: 'inherit'
+//     });
+
+//     child.on('error', (error) => {
+//       CLILogger.error(`Failed to start server: ${error.message}`);
+//     });
+
+//     child.on('close', (code) => {
+//       if (code !== 0) {
+//         CLILogger.error(`Server exited with code ${code}`);
+//       }
+//     });
+//   }
+// }
+
+// // ============================================================================
+// // FILE: src/cli/commands/build.command.ts
+// // ============================================================================
+// import { execSync } from 'child_process';
+// import { CLILogger } from '../utils/logger';
+
+// export class BuildCommand {
+//   async execute(): Promise<void> {
+//     CLILogger.title('🔨 Building Fragment Application');
+
+//     const spinner = CLILogger.spinner('Compiling TypeScript...');
+
+//     try {
+//       execSync('tsc', { stdio: 'pipe' });
+//       spinner.succeed('Build completed successfully');
+
+//       CLILogger.success('Output directory: ./dist');
+//       CLILogger.info('Run "node dist/server.js" to start the production server');
+
+//     } catch (error: any) {
+//       spinner.fail('Build failed');
+//       CLILogger.error(error.message);
+//       process.exit(1);
+//     }
+//   }
+// }
+
+// // ============================================================================
+// // FILE: src/cli/commands/migrate.command.ts
+// // ============================================================================
+// import { execSync } from 'child_process';
+// import { CLILogger } from '../utils/logger';
+// import inquirer from 'inquirer';
+
+// export class MigrateCommand {
+//   async execute(action?: string): Promise<void> {
+//     if (!action) {
+//       const answer = await inquirer.prompt([
+//         {
+//           type: 'list',
+//           name: 'action',
+//           message: 'Select migration action:',
+//           choices: [
+//             { name: 'Run pending migrations', value: 'run' },
+//             { name: 'Generate new migration', value: 'generate' },
+//             { name: 'Revert last migration', value: 'revert' },
+//             { name: 'Show migration status', value: 'show' }
+//           ]
+//         }
+//       ]);
+//       action = answer.action;
+//     }
+
+//     switch (action) {
+//       case 'run':
+//         await this.runMigrations();
+//         break;
+//       case 'generate':
+//         await this.generateMigration();
+//         break;
+//       case 'revert':
+//         await this.revertMigration();
+//         break;
+//       case 'show':
+//         await this.showMigrations();
+//         break;
+//       default:
+//         CLILogger.error(`Unknown action: ${action}`);
+//     }
+//   }
+
+//   private async runMigrations(): Promise<void> {
+//     CLILogger.title('📦 Running Migrations');
+//     const spinner = CLILogger.spinner('Executing migrations...');
+
+//     try {
+//       execSync('npm run typeorm migration:run', { stdio: 'pipe' });
+//       spinner.succeed('Migrations executed successfully');
+//     } catch (error: any) {
+//       spinner.fail('Migration failed');
+//       CLILogger.error(error.message);
+//     }
+//   }
+
+//   private async generateMigration(): Promise<void> {
+//     const answer = await inquirer.prompt([
+//       {
+//         type: 'input',
+//         name: 'name',
+//         message: 'Migration name:',
+//         validate: (input: string) => {
+//           if (!input) return 'Name is required';
+//           return true;
+//         }
+//       }
+//     ]);
+
+//     CLILogger.title(`📝 Generating Migration: ${answer.name}`);
+//     const spinner = CLILogger.spinner('Creating migration file...');
+
+//     try {
+//       execSync(`npm run typeorm migration:generate -- -n ${answer.name}`, { stdio: 'pipe' });
+//       spinner.succeed('Migration generated successfully');
+//     } catch (error: any) {
+//       spinner.fail('Failed to generate migration');
+//       CLILogger.error(error.message);
+//     }
+//   }
+
+//   private async revertMigration(): Promise<void> {
+//     const confirm = await inquirer.prompt([
+//       {
+//         type: 'confirm',
+//         name: 'confirmed',
+//         message: 'Are you sure you want to revert the last migration?',
+//         default: false
+//       }
+//     ]);
+
+//     if (!confirm.confirmed) {
+//       CLILogger.info('Migration revert cancelled');
+//       return;
+//     }
+
+//     CLILogger.title('⏪ Reverting Migration');
+//     const spinner = CLILogger.spinner('Reverting last migration...');
+
+//     try {
+//       execSync('npm run typeorm migration:revert', { stdio: 'pipe' });
+//       spinner.succeed('Migration reverted successfully');
+//     } catch (error: any) {
+//       spinner.fail('Failed to revert migration');
+//       CLILogger.error(error.message);
+//     }
+//   }
+
+//   private async showMigrations(): Promise<void> {
+//     CLILogger.title('📋 Migration Status');
+    
+//     try {
+//       const output = execSync('npm run typeorm migration:show', { encoding: 'utf-8' });
+//       console.log(output);
+//     } catch (error: any) {
+//       CLILogger.error('Failed to show migrations');
+//     }
+//   }
+// }
+
+// // ============================================================================
+// // FILE: src/cli/cli.ts
+// // ============================================================================
+// import chalk from 'chalk';
+// import { Command } from 'commander';
+// import { InitCommand } from './commands/init.command';
+// import { GenerateCommand } from './commands/generate.command';
+// import { ConfigCommand } from './commands/config.command';
+// import { ServeCommand } from './commands/serve.command';
+// import { BuildCommand } from './commands/build.command';
+// import { MigrateCommand } from './commands/migrate.command';
+// import { CLILogger } from './utils/logger';
+
+// export class CLI {
+//   private program: Command;
+//   private initCommand: InitCommand;
+//   private generateCommand: GenerateCommand;
+//   private configCommand: ConfigCommand;
+//   private serveCommand: ServeCommand;
+//   private buildCommand: BuildCommand;
+//   private migrateCommand: MigrateCommand;
+
+//   constructor() {
+//     this.program = new Command();
+//     this.initCommand = new InitCommand();
+//     this.generateCommand = new GenerateCommand();
+//     this.configCommand = new ConfigCommand();
+//     this.serveCommand = new ServeCommand();
+//     this.buildCommand = new BuildCommand();
+//     this.migrateCommand = new MigrateCommand();
+
+//     this.setupCommands();
+//   }
+
+//   private setupCommands(): void {
+//     this.program
+//       .name('frg')
+//       .description('Fragment Framework CLI - Build powerful TypeScript backends')
+//       .version('1.0.0');
+
+//     // ASCII Art Banner
+//     this.program
+//       .addHelpText('beforeAll', () => {
+//         return chalk.cyan(`
+// ╔═══════════════════════════════════════════════════════════╗
+// ║                                                           ║
+// ║   ███████╗██████╗  █████╗  ██████╗ ███╗   ███╗███████╗  ║
+// ║   ██╔════╝██╔══██╗██╔══██╗██╔════╝ ████╗ ████║██╔════╝  ║
+// ║   █████╗  ██████╔╝███████║██║  ███╗██╔████╔██║█████╗    ║
+// ║   ██╔══╝  ██╔══██╗██╔══██║██║   ██║██║╚██╔╝██║██╔══╝    ║
+// ║   ██║     ██║  ██║██║  ██║╚██████╔╝██║ ╚═╝ ██║███████╗  ║
+// ║   ╚═╝     ╚═╝  ╚═╝╚═╝  ╚═╝ ╚═════╝ ╚═╝     ╚═╝╚══════╝  ║
+// ║                                                           ║
+// ║          TypeScript Backend Framework (v1.0.0)           ║
+// ╚═══════════════════════════════════════════════════════════╝
+// `);
+//       });
+
+//     // Init command
+//     this.program
+//       .command('init [project-name]')
+//       .description('Initialize a new Fragment project')
+//       .action(async (projectName) => {
+//         await this.initCommand.execute(projectName);
+//       });
+
+//     // Generate commands
+//     const generate = this.program
+//       .command('generate')
+//       .alias('g')
+//       .description('Generate application components');
+
+//     generate
+//       .command('controller [name]')
+//       .alias('c')
+//       .description('Generate a new controller')
+//       .action(async (name) => {
+//         await this.generateCommand.execute('controller', name);
+//       });
+
+//     generate
+//       .command('service [name]')
+//       .alias('s')
+//       .description('Generate a new service')
+//       .action(async (name) => {
+//         await this.generateCommand.execute('service', name);
+//       });
+
+//     generate
+//       .command('repository [name]')
+//       .alias('r')
+//       .description('Generate a new repository')
+//       .action(async (name) => {
+//         await this.generateCommand.execute('repository', name);
+//       });
+
+//     generate
+//       .command('entity [name]')
+//       .alias('e')
+//       .description('Generate a new entity')
+//       .action(async (name) => {
+//         await this.generateCommand.execute('entity', name);
+//       });
+
+//     generate
+//       .command('resource [name]')
+//       .alias('res')
+//       .description('Generate a complete resource (controller, service, repository, entity)')
+//       .action(async (name) => {
+//         await this.generateCommand.execute('resource', name);
+//       });
+
+//     // Config commands
+//     const config = this.program
+//       .command('config')
+//       .description('Configure Fragment application');
+
+//     config
+//       .command('ai')
+//       .description('Configure OpenAI integration')
+//       .action(async () => {
+//         await this.configCommand.execute('ai');
+//       });
+
+//     config
+//       .command('db')
+//       .alias('database')
+//       .description('Configure database connection')
+//       .action(async () => {
+//         await this.configCommand.execute('db');
+//       });
+
+//     config
+//       .command('show')
+//       .description('Show current configuration')
+//       .action(async () => {
+//         await this.configCommand.execute('show');
+//       });
+
+//     // Serve command
+//     this.program
+//       .command('serve')
+//       .alias('dev')
+//       .description('Start development server')
+//       .option('-p, --port <port>', 'Port number', parseInt)
+//       .option('--no-watch', 'Disable file watching')
+//       .action(async (options) => {
+//         await this.serveCommand.execute(options);
+//       });
+
+//     // Build command
+//     this.program
+//       .command('build')
+//       .description('Build application for production')
+//       .action(async () => {
+//         await this.buildCommand.execute();
+//       });
+
+//     // Migrate commands
+//     const migrate = this.program
+//       .command('migrate')
+//       .alias('migration')
+//       .description('Database migration commands');
+
+//     migrate
+//       .command('run')
+//       .description('Run pending migrations')
+//       .action(async () => {
+//         await this.migrateCommand.execute('run');
+//       });
+
+//     migrate
+//       .command('generate')
+//       .alias('create')
+//       .description('Generate a new migration')
+//       .action(async () => {
+//         await this.migrateCommand.execute('generate');
+//       });
+
+//     migrate
+//       .command('revert')
+//       .description('Revert last migration')
+//       .action(async () => {
+//         await this.migrateCommand.execute('revert');
+//       });
+
+//     migrate
+//       .command('show')
+//       .alias('status')
+//       .description('Show migration status')
+//       .action(async () => {
+//         await this.migrateCommand.execute('show');
+//       });
+
+//     // Info command
+//     this.program
+//       .command('info')
+//       .description('Display Fragment CLI information')
+//       .action(() => {
+//         CLILogger.box('Fragment Framework CLI', [
+//           'Version: 1.0.0',
+//           'TypeScript Backend Framework',
+//           'OOP + Decorators + DI',
+//           '',
+//           'Documentation: https://fragment-framework.dev',
+//           'Repository: https://github.com/fragment/framework'
+//         ]);
+//       });
+//   }
+
+//   run(args: string[]): void {
+//     this.program.parse(['node', 'frg', ...args]);
+//   }
+// }
+
+// // ============================================================================
+// // FILE: src/app.ts (Updated with Fragment branding)
+// // ============================================================================
+// import express, { Express, Request, Response, NextFunction } from 'express';
+// import { DIContainer } from './core/container/di-container';
+// import { ConfigLoader } from './core/config/config-loader';
+// import { initializeDataSource, AppDataSource } from './database/data-source';
+// import { loggingMiddleware } from './middlewares/logging.middleware';
+// import { authMiddleware } from './auth/auth.middleware';
+// import {
+//   CONTROLLER_METADATA,
+//   CONTROLLER_PATH
+// } from './core/decorators/controller.decorator';
+// import {
+//   ROUTE_METADATA
+// } from './core/decorators/route.decorator';
+// import {
+//   AUTH_GUARD_METADATA
+// } from './core/decorators/auth-guard.decorator';
+// import {
+//   MIDDLEWARE_METADATA
+// } from './core/decorators/middleware.decorator';
+
+// // Import all controllers, services, repositories
+// import './controllers/health.controller';
+// import './auth/auth.controller';
+// import './services/health.service';
+// import './repositories/user.repository';
+// import './repositories/session.repository';
+// import './auth/auth.service';
+// import './core/openai/openai-client';
+
+// export class FragmentApplication {
+//   private app: Express;
+
+//   constructor() {
+//     this.app = express();
+//   }
+
+//   async initialize(): Promise<Express> {
+//     // Load configuration
+//     ConfigLoader.load(true);
+
+//     // Initialize database
+//     const dataSource = initializeDataSource();
+//     await dataSource.initialize();
+//     console.log('✅ Database connected');
+
+//     // Middleware
+//     this.app.use(express.json());
+//     this.app.use(express.urlencoded({ extended: true }));
+//     this.app.use(loggingMiddleware);
+
+//     // Register all controllers
+//     this.registerControllers();
+
+//     // Error handling
+//     this.app.use((err: Error, req: Request, res: Response, next: NextFunction) => {
+//       console.error(err.stack);
+//       res.status(500).json({ error: 'Internal server error' });
+//     });
+
+//     return this.app;
+//   }
+
+//   private registerControllers(): void {
+//     const registeredClasses = DIContainer.getRegisteredClasses();
+
+//     registeredClasses.forEach((controllerClass) => {
+//       const isController = Reflect.getMetadata(CONTROLLER_METADATA, controllerClass);
+//       if (!isController) return;
+
+//       const basePath = Reflect.getMetadata(CONTROLLER_PATH, controllerClass) || '';
+//       const routes = Reflect.getMetadata(ROUTE_METADATA, controllerClass) || [];
+//       const classMiddlewares = Reflect.getMetadata(MIDDLEWARE_METADATA, controllerClass) || [];
+//       const classAuthGuard = Reflect.getMetadata(AUTH_GUARD_METADATA, controllerClass);
+
+//       const controllerInstance = DIContainer.resolve(controllerClass);
+
+//       routes.forEach((route: any) => {
+//         const fullPath = basePath + route.path;
+//         const handler = controllerInstance[route.handlerName].bind(controllerInstance);
+
+//         const middlewares: any[] = [...classMiddlewares];
+
+//         const methodAuthGuard = Reflect.getMetadata(
+//           AUTH_GUARD_METADATA,
+//           controllerClass,
+//           route.handlerName
+//         );
+//         if (classAuthGuard || methodAuthGuard) {
+//           middlewares.push(authMiddleware);
+//         }
+
+//         const methodMiddlewares = Reflect.getMetadata(
+//           MIDDLEWARE_METADATA,
+//           controllerClass,
+//           route.handlerName
+//         ) || [];
+//         middlewares.push(...methodMiddlewares);
+
+//         const asyncHandler = async (req: Request, res: Response, next: NextFunction) => {
+//           try {
+//             const result = await handler(req, res, next);
+//             if (result && !res.headersSent) {
+//               res.json(result);
+//             }
+//           } catch (error) {
+//             next(error);
+//           }
+//         };
+
+//         (this.app as any)[route.method](fullPath, ...middlewares, asyncHandler);
+
+//         console.log(`📍 ${route.method.toUpperCase().padEnd(6)} ${fullPath}`);
+//       });
+//     });
+//   }
+
+//   getExpressApp(): Express {
+//     return this.app;
+//   }
+// }
+
+// // ============================================================================
+// // FILE: src/server.ts (Updated)
+// // ============================================================================a
+
+// // ============================================================================
+// // COMPLETE CLI USAGE GUIDE
+// // ============================================================================
+// /*
+
+// ## Fragment CLI (FRG) - World-Class Commands
+
+// ### 🎯 Initialize New Project
+// ```bash
+// frg init my-app                    # Create new project
+// frg init                           # Interactive mode
+// ```
+
+// ### 🏗️  Generate Code
+// ```bash
+// frg generate controller User       # Generate controller
+// frg g c User                       # Short alias
+
+// frg generate service User          # Generate service  
+// frg g s User                       # Short alias
+
+// frg generate repository User       # Generate repository
+// frg g r User                       # Short alias
+
+// frg generate entity User           # Generate entity
+// frg g e User                       # Short alias
+
+// frg generate resource Product      # Generate complete resource
+// frg g res Product                  # (controller, service, repository, entity)
+// ```
+
+// ### ⚙️  Configure
+// ```bash
+// frg config ai                      # Configure OpenAI
+// frg config db                      # Configure database
+// frg config show                    # Show current config
+// ```
+
+// ### 🚀 Development
+// ```bash
+// frg serve                          # Start dev server
+// frg dev                            # Alias for serve
+// frg serve --port 8080              # Custom port
+// frg serve --no-watch               # Disable watch mode
+// ```
+
+// ### 📦 Production
+// ```bash
+// frg build                          # Build for production
+// node dist/server.js                # Run production build
+// ```
+
+// ### 🗄️  Database Migrations
+// ```bash
+// frg migrate run                    # Run pending migrations
+// frg migrate generate               # Create new migration
+// frg migrate revert                 # Revert last migration
+// frg migrate show                   # Show migration status
+// ```
+
+// ### ℹ️  Information
+// ```bash
+// frg info                           # Show CLI info
+// frg --help                         # Show help
+// frg --version                      # Show version
+// ```
+
+// ## Example Workflow
+
+// ```bash
+// # 1. Create new project
+// frg init my-blog-api
+
+// # 2. Navigate to project
+// cd my-blog-api
+
+// # 3. Configure OpenAI
+// frg config ai
+
+// # 4. Generate a complete resource
+// frg generate resource Post
+
+// # 5. Start development server
+// frg serve
+
+// # 6. Access your API
+// curl http://localhost:3000/api/posts
+// ```
+
+// ## Features
+
+// ✨ Interactive prompts with validation
+// ✨ Beautiful ASCII art and colored output
+// ✨ Progress spinners for long operations
+// ✨ Automatic dependency installation
+// ✨ Smart file generation with templates
+// ✨ Configuration management
+// ✨ Database migration tools
+// ✨ Hot-reload development server
+// ✨ Production build optimization
+
+// */