@diagramers/cli 4.0.0 → 4.0.2

package/README.md

@@ -1,31 +1,60 @@
-# Diagramers CLI
+# @diagramers/cli
 
-A powerful command-line interface for managing Diagramers projects, generating modules, and extending functionality with a comprehensive template system.
+A powerful command-line interface for scaffolding and managing Diagramers projects. The CLI provides comprehensive tools for creating, managing, and extending API and admin dashboard projects with advanced features and automation.
 
 ## 🚀 Features
 
-### Core Capabilities
-- **Project Initialization** - Create new projects from templates
-- **Module Generation** - Generate complete modules with CRUD operations
-- **Table Generation** - Add database tables to existing modules
-- **Endpoint Generation** - Add custom endpoints to existing modules
-- **Relation Management** - Generate database relations within modules
-- **Feature Extension** - Add features to existing projects
-- **Template Management** - Download and update project templates
-
-### Supported Templates
-- **API Projects** - Full-featured Node.js API with TypeScript
-- **Admin Projects** - Modern admin dashboard with React/Vue/Angular support
-- **Custom Templates** - Extensible template system
-
-### Database Support
-- **MongoDB** - Primary database with Mongoose schemas
-- **SQL Databases** - MySQL, PostgreSQL, SQLite support
-- **Schema Generation** - Automatic schema and relation creation
+### Project Management
+- **Project Scaffolding** - Create new API and admin projects from templates
+- **Template Management** - Manage and update project templates
+- **Project Initialization** - Automated project setup and configuration
+- **Environment Setup** - Automatic environment variable configuration
+- **Git Integration** - Automatic Git repository initialization
+
+### Module & Feature Generation
+- **Module Generation** - Create complete modules with CRUD operations
+- **Table Generation** - Generate database tables with relationships
+- **Endpoint Generation** - Create custom API endpoints
+- **Relation Generation** - Set up database relationships (one-to-one, one-to-many, many-to-many)
+- **Feature Extension** - Extend existing modules with new functionality
+
+### Database Management
+- **Database Seeding** - Generate and run database seeders
+- **Migration Support** - Create and manage database migrations
+- **Schema Generation** - Auto-generate database schemas
+- **Relationship Management** - Handle complex database relationships
+- **Data Validation** - Generate validation rules and schemas
+
+### Development Tools
+- **Code Generation** - Generate TypeScript interfaces, services, and controllers
+- **API Documentation** - Auto-generate Swagger/OpenAPI documentation
+- **Testing Setup** - Generate test files and testing configurations
+- **Linting & Formatting** - Set up code quality tools
+- **Build Configuration** - Generate build and deployment configurations
+
+### Authentication & Security
+- **Auth Module Generation** - Generate authentication modules
+- **Provider Integration** - Set up OAuth, SMS, and email providers
+- **Security Configuration** - Configure JWT, CORS, and security headers
+- **Role & Permission System** - Generate role-based access control
+- **Multi-factor Authentication** - Set up MFA providers
+
+### Communication Services
+- **Email System Setup** - Configure email providers and templates
+- **SMS Integration** - Set up SMS providers for notifications
+- **Push Notifications** - Configure push notification services
+- **Webhook Management** - Set up webhook endpoints and handlers
+
+### Deployment & DevOps
+- **Docker Configuration** - Generate Docker and Docker Compose files
+- **CI/CD Setup** - Create GitHub Actions and other CI/CD configurations
+- **Environment Management** - Manage multiple environment configurations
+- **Monitoring Setup** - Configure logging and monitoring tools
+- **Backup Configuration** - Set up automated backup systems
 
 ## 📦 Installation
 
-### Global Installation
+### Global Installation (Recommended)
 ```bash
 npm install -g @diagramers/cli
 ```
@@ -33,805 +62,547 @@ npm install -g @diagramers/cli
 ### Local Installation
 ```bash
 npm install @diagramers/cli
-npx diagramers --help
+npx diagramers-cli --help
 ```
 
-## 🚀 Quick Start
-
+### Development Installation
 ```bash
-# Install the CLI globally
-npm install -g @diagramers/cli
+git clone https://github.com/diagramers/diagramers-cli.git
+cd diagramers-cli
+npm install
+npm link
+```
+
+## 🛠️ Quick Start
 
+### 1. Create a New API Project
+```bash
 # Create a new API project
-diagramers init api my-new-api
+diagramers init api my-api-project
 
 # Navigate to the project
-cd my-new-api
-
-# Set up environment variables
-cp .env.example .env
+cd my-api-project
 
 # Install dependencies
-npm install
-
-# Start development
-npm start
-```
-
-## 📋 Commands
-
-### Project Management
+npm install --legacy-peer-deps
 
-#### Initialize New Project
-```bash
-diagramers init <template-type> <project-name> [options]
+# Start development server
+npm run dev
 ```
 
-**Options:**
-- `-v, --version <version>` - Specific version of the template to use (e.g., 1.1.17, latest)
-- `-t, --template <template>` - Template version to use (deprecated, use --version)
-- `-y, --yes` - Skip prompts and use defaults
-
-**Examples:**
+### 2. Create a New Admin Dashboard
 ```bash
-# Create API project with latest version
-diagramers init api my-api-project
-
-# Create API project with specific version
-diagramers init api my-api-project -v 1.1.17
-
-# Create admin project with specific version
-diagramers admin init react-typescript my-admin-dashboard -v 1.0.0
-```
+# Create a new admin dashboard
+diagramers init admin my-admin-dashboard
 
-#### Update Project
+# Navigate to the project
+cd my-admin-dashboard
 
-Update an existing project with the latest template features:
+# Install dependencies
+npm install --legacy-peer-deps
 
-```bash
-diagramers update [options]
+# Start development server
+npm start
 ```
 
-**Options:**
-- `-v, --version <version>` - Specific version to update to (e.g., 1.1.27, latest)
-- `-f, --force` - Force update even if conflicts detected
-- `-b, --backup` - Create backup before updating
-
-**Examples:**
+### 3. Generate Your First Module
 ```bash
-# Update to latest version
-diagramers update
-
-# Update to specific version
-diagramers update -v 1.1.27
+# Generate a products module with CRUD operations
+diagramers extend --module products --crud
 
-# Force update (overwrite conflicts)
-diagramers update --force
+# Add categories table to products module
+diagramers extend --table products:categories --fields name,description,slug
 
-# Create backup before updating
-diagramers update --backup
+# Add products table to products module
+diagramers extend --table products:products --fields name,price,description,category_id
 
-# Combine options
-diagramers update -v 1.1.27 --backup --force
+# Create relationship between categories and products
+diagramers extend --relation products:category-product:one-to-many
 ```
 
-#### What Gets Updated
-
-The update command intelligently updates the following:
-
-- **Core Files**: `src/core/`, `src/shared/`, `src/plugins/`
-- **Configuration**: `config/` folder, `webpack.config.js`, `tsconfig.json`
-- **Scripts**: `scripts/` folder with utility scripts
-- **Documentation**: `README.md`, `DEVELOPER_GUIDE.md`
-- **Environment**: `.env.example` template
-- **Package.json**: Updates dependencies and scripts while preserving project-specific fields
+### 4. Add Custom Endpoints
+```bash
+# Add search endpoint
+diagramers extend --endpoint products:search --method GET --description "Search products"
 
-#### Version Management
+# Add featured products endpoint
+diagramers extend --endpoint products:featured --method GET --description "Get featured products"
+```
 
-- **Automatic Version Sync**: Project version is updated to match template version
-- **Project Preservation**: Project-specific fields (name, description, repository, etc.) are preserved
-- **Conflict Detection**: Detects conflicts and allows force overwrite
-- **Backup Support**: Creates timestamped backups before updating
+## 📚 CLI Commands
 
-#### Update Process
+### Project Management Commands
 
-1. **Validation**: Checks if current directory is a valid project
-2. **Version Check**: Shows current project version vs target version
-3. **Backup**: Creates backup if requested
-4. **Download**: Downloads latest template from npm
-5. **Conflict Check**: Identifies files with conflicts
-6. **Update**: Updates files while preserving project-specific settings
-7. **Cleanup**: Removes temporary files
+#### Initialize Projects
+```bash
+# Initialize API project
+diagramers init api <project-name> [options]
 
-#### Example Output
+# Initialize admin dashboard
+diagramers init admin <project-name> [options]
 
-```bash
-🔄 Checking for template updates...
-📦 Current project version: 1.1.26
-📌 Updating to latest version
-📦 Downloading latest template: @diagramers/api
-✅ Template downloaded from npm: @diagramers/api
-📝 Updating project files...
-✅ Updated: src/core/config/index.ts
-✅ Updated: scripts/env-debug.js
-✅ Updated: package.json (version: 1.1.27)
-✅ Project updated successfully!
-📦 Template version: 1.1.27
-📝 Review the changes and test your application
-💡 Run "npm install" to update dependencies if needed
-```
+# Initialize both API and admin projects
+diagramers init <project-name> --api --admin
 
-#### List Available Versions
-```bash
-diagramers versions [options]
+# Initialize with specific template version
+diagramers init api <project-name> --version 4.0.1
 ```
 
-**Options:**
-- `-a, --all` - Show all versions (default: show last 10)
-
-**Examples:**
+#### Project Options
 ```bash
-# Show last 10 versions
-diagramers versions
+# Initialize with custom configuration
+diagramers init api <project-name> \
+  --database mongodb \
+  --auth internal,oauth,sms \
+  --email sendgrid \
+  --deploy firebase
 
-# Show all available versions
-diagramers versions --all
+# Initialize with specific features
+diagramers init api <project-name> \
+  --features auth,email,sms,notifications,file-upload \
+  --providers google,github,twilio,sendgrid
 ```
 
-### Module Management
-
-#### Generate Module
-```bash
-diagramers extend --module <module-name> [options]
-```
+### Module Management Commands
 
-**Examples:**
+#### Generate Modules
 ```bash
 # Generate basic module
-diagramers extend --module products
+diagramers extend --module <module-name>
 
 # Generate module with CRUD operations
-diagramers extend --module products --crud
+diagramers extend --module <module-name> --crud
 
-# Generate module with custom fields
-diagramers extend --module products --fields name,price,description --crud
-```
+# Generate module with specific fields
+diagramers extend --module users --fields email,username,role,is_active --crud
 
-### Table Management
+# Generate module with authentication
+diagramers extend --module auth --auth --providers internal,oauth,sms
 
-#### Add Table to Module
-```bash
-diagramers extend --table <module:table> --fields <field1,field2,...>
+# Generate module with custom configuration
+diagramers extend --module products \
+  --fields name,price,description,category_id \
+  --crud \
+  --validation \
+  --tests \
+  --docs
 ```
 
-**Examples:**
+#### Module Options
 ```bash
-# Add categories table to products module
-diagramers extend --table products:categories --fields name,description,slug
-
-# Add products table to products module
-diagramers extend --table products:products --fields name,price,category_id
+# Generate with specific features
+diagramers extend --module <module-name> \
+  --crud \
+  --validation \
+  --tests \
+  --docs \
+  --migrations \
+  --seeders
 
-# Add user profiles table to users module
-diagramers extend --table users:profiles --fields bio,avatar,social_links
+# Generate with custom paths
+diagramers extend --module <module-name> \
+  --path src/modules/custom \
+  --template custom-template
 ```
 
-**Field Types (Auto-detected):**
-- `name`, `title`, `description` → String
-- `email`, `phone` → String
-- `price`, `count`, `age` → Number
-- `created_at`, `updated_at` → Date
-- `is_active`, `verified` → Boolean
-- `*_id` → ObjectId
-- `status` → Number
-
-### Endpoint Management
-
-#### Add Endpoint to Module
-```bash
-diagramers extend --endpoint <module:endpoint> [options]
-```
+### Table Generation Commands
 
-**Examples:**
+#### Generate Tables
 ```bash
-# Add GET endpoint
-diagramers extend --endpoint products:search --method GET
+# Add table to existing module
+diagramers extend --table <module>:<table> --fields <field1>,<field2>
 
-# Add POST endpoint
-diagramers extend --endpoint users:reset-password --method POST
+# Generate table with various field types
+diagramers extend --table users:profiles \
+  --fields bio,avatar,birth_date,is_verified,preferences
 
-# Add endpoint with custom path
-diagramers extend --endpoint products:featured --method GET --path /featured --description "Get featured products"
-```
-
-**Supported Methods:**
-- `GET` - Retrieve data
-- `POST` - Create data
-- `PUT` - Update data
-- `DELETE` - Delete data
-
-### Relation Management
+# Generate table with relationships
+diagramers extend --table products:categories \
+  --fields name,description,slug,parent_id \
+  --relations parent:categories:one-to-many
 
-#### Create Relations Within Module
-```bash
-diagramers extend --relation <module:table1-table2[:type]>
+# Generate table with indexes
+diagramers extend --table products:products \
+  --fields name,price,description,category_id,sku \
+  --indexes name,sku,category_id
 ```
 
-**Examples:**
+#### Field Types
 ```bash
-# One-to-many relation (default)
-diagramers extend --relation products:category-product
+# String fields
+diagramers extend --table users:profiles \
+  --fields name:string,email:string,phone:string
 
-# One-to-one relation
-diagramers extend --relation users:user-profile:one-to-one
+# Numeric fields
+diagramers extend --table products:products \
+  --fields price:number,stock:integer,rating:float
 
-# Many-to-many relation
-diagramers extend --relation products:product-tag:many-to-many
-```
+# Date fields
+diagramers extend --table orders:orders \
+  --fields created_at:date,updated_at:date,delivery_date:datetime
 
-**Relation Types:**
-- `one-to-one` - Single record relations
-- `one-to-many` - Parent-child relations (default)
-- `many-to-many` - Junction table relations
+# Boolean fields
+diagramers extend --table users:users \
+  --fields is_active:boolean,email_verified:boolean
 
-### Feature Management
+# Object/JSON fields
+diagramers extend --table users:profiles \
+  --fields preferences:object,metadata:json
 
-#### List Available Features
-```bash
-diagramers extend --list
+# Array fields
+diagramers extend --table products:products \
+  --fields tags:array,images:array
 ```
 
-#### Add Feature
+### Endpoint Generation Commands
+
+#### Generate Endpoints
 ```bash
-diagramers extend --feature <feature-name>
-```
+# Add GET endpoint
+diagramers extend --endpoint <module>:<endpoint> --method GET
 
-## 🎨 Admin Dashboard Management
+# Add POST endpoint with custom path
+diagramers extend --endpoint users:reset-password --method POST --path /reset-password
 
-The CLI provides comprehensive support for managing admin dashboard projects with modern frameworks and features.
+# Add endpoint with validation
+diagramers extend --endpoint products:create --method POST \
+  --validation name:required,price:required:number
 
-### Admin Project Initialization
+# Add endpoint with authentication
+diagramers extend --endpoint users:profile --method GET \
+  --auth required --roles user,admin
 
-#### Initialize New Admin Project
-```bash
-diagramers admin init <template-type> <project-name> [options]
+# Add endpoint with custom logic
+diagramers extend --endpoint products:search --method GET \
+  --description "Search products with filters" \
+  --query name,price_min,price_max,category_id
 ```
 
-**Template Types:**
-- `react-typescript` - React 18 + TypeScript + Tailwind CSS
-- `vue-typescript` - Vue 3 + TypeScript + Tailwind CSS
-- `angular` - Angular 17 + TypeScript + Tailwind CSS
-
-**Options:**
-- `-f, --framework <framework>` - Framework to use (react, vue, angular)
-- `-t, --template <template>` - Template package name
-- `-v, --version <version>` - Template version to use
-- `-y, --yes` - Skip prompts and use defaults
-- `--typescript` - Use TypeScript (default: true)
-- `--tailwind` - Use Tailwind CSS (default: true)
-- `--api-url <url>` - API URL for the backend
-- `--socket-url <url>` - Socket.IO URL for real-time features
-
-**Examples:**
+#### Endpoint Options
 ```bash
-# Create React admin project
-diagramers admin init react-typescript my-admin-app
-
-# Create Vue admin project with specific version
-diagramers admin init vue-typescript my-vue-admin --version 1.0.0
-
-# Create Angular admin project with custom API URL
-diagramers admin init angular my-angular-admin --api-url http://localhost:3000
-
-# Create with all options
-diagramers admin init react-typescript my-admin-app \
-  --framework react \
-  --typescript \
-  --tailwind \
-  --api-url http://localhost:3000 \
-  --socket-url http://localhost:3000
-```
-
-### Admin Project Extension
+# Generate with specific features
+diagramers extend --endpoint <module>:<endpoint> \
+  --method GET \
+  --auth required \
+  --roles admin \
+  --validation \
+  --tests \
+  --docs \
+  --rate-limit 100:1m
 
-#### Extend Admin Project
-```bash
-diagramers admin extend [options]
+# Generate with custom response
+diagramers extend --endpoint products:featured \
+  --method GET \
+  --response "Product[]" \
+  --description "Get featured products"
 ```
 
-**Options:**
-- `-p, --page <name>` - Generate a new page
-- `-c, --component <name>` - Generate a new component
-- `-s, --service <name>` - Generate a new service
-- `-h, --hook <name>` - Generate a new custom hook
-- `-m, --module <name>` - Generate a complete module with CRUD
-- `--crud` - Include CRUD operations for module
-- `--api` - Include API integration for module
-- `--socket` - Include Socket.IO integration for module
-- `--table` - Include data table for module
-- `--form` - Include form components for module
-- `--chart` - Include chart components for module
-- `--auth` - Include authentication for module
-- `--path <path>` - Custom path for generated files
-
-**Examples:**
-```bash
-# Generate a new module with CRUD operations
-diagramers admin extend --module products --crud --api --table
+### Relationship Generation Commands
 
-# Generate a new page
-diagramers admin extend --page analytics
+#### Generate Relationships
+```bash
+# One-to-many relation (default)
+diagramers extend --relation <module>:<relation-name>
 
-# Generate a new component
-diagramers admin extend --component ProductCard
+# One-to-one relation
+diagramers extend --relation users:user-profile:one-to-one
 
-# Generate a new service
-diagramers admin extend --service orderService
+# Many-to-many relation
+diagramers extend --relation products:product-tag:many-to-many
 
-# Generate a new custom hook
-diagramers admin extend --hook useOrders
+# Complex relationships
+diagramers extend --relation orders:order-items:one-to-many \
+  --through products \
+  --fields quantity,price
 
-# Generate complete module with all features
-diagramers admin extend --module orders --crud --api --socket --table --form --chart --auth
+# Self-referencing relationships
+diagramers extend --relation categories:parent-child:one-to-many \
+  --self-referencing
 ```
 
-### Admin Project Updates
+### Authentication Commands
 
-#### Update Admin Project
+#### Generate Auth Modules
 ```bash
-diagramers admin update [options]
-```
+# Generate basic authentication
+diagramers extend --auth --providers internal
 
-**Options:**
-- `-t, --template <template>` - Template to update
-- `-v, --version <version>` - Version to update to
-- `--force` - Force update even if conflicts exist
-- `--backup` - Create backup before updating
+# Generate multi-provider authentication
+diagramers extend --auth --providers internal,oauth,sms,email
 
-**Examples:**
-```bash
-# Update to latest version
-diagramers admin update
+# Generate OAuth providers
+diagramers extend --auth --providers oauth \
+  --oauth google,github,facebook,twitter
 
-# Update to specific version
-diagramers admin update --version 1.0.0
+# Generate SMS authentication
+diagramers extend --auth --providers sms \
+  --sms twilio,aws-sns,vonage
 
-# Force update with backup
-diagramers admin update --force --backup
+# Generate email authentication
+diagramers extend --auth --providers email \
+  --email sendgrid,aws-ses,mailgun
 ```
 
-### Admin Version Management
-
-#### Check Admin Version
+#### Auth Configuration
 ```bash
-diagramers admin version [options]
+# Generate with specific features
+diagramers extend --auth \
+  --providers internal,oauth,sms \
+  --features registration,login,logout,password-reset,email-verification \
+  --oauth google,github \
+  --sms twilio \
+  --jwt \
+  --refresh-tokens \
+  --rate-limiting
 ```
 
-**Options:**
-- `-c, --check <version>` - Check if specific version exists
+### Communication Commands
 
-**Examples:**
+#### Generate Email System
 ```bash
-# Show current version info
-diagramers admin version
+# Generate email module
+diagramers extend --email --providers sendgrid,aws-ses,mailgun
 
-# Check specific version
-diagramers admin version --check 1.0.0
-```
+# Generate email templates
+diagramers extend --email-templates \
+  --templates welcome,password-reset,verification,notification
 
-#### List Available Admin Versions
-```bash
-diagramers admin versions [options]
+# Generate email configuration
+diagramers extend --email-config \
+  --providers sendgrid,aws-ses \
+  --templates handlebars
 ```
 
-**Options:**
-- `-a, --all` - Show all versions (default: show last 10)
-
-**Examples:**
+#### Generate SMS System
 ```bash
-# Show last 10 versions
-diagramers admin versions
+# Generate SMS module
+diagramers extend --sms --providers twilio,aws-sns,vonage
 
-# Show all available versions
-diagramers admin versions --all
-```
+# Generate SMS templates
+diagramers extend --sms-templates \
+  --templates verification,notification,alert
 
-### Admin Project Features
-
-#### Available Templates
-- **React TypeScript Admin** - React 18 + TypeScript + Tailwind CSS
-- **Vue TypeScript Admin** - Vue 3 + TypeScript + Tailwind CSS  
-- **Angular Admin** - Angular 17 + TypeScript + Tailwind CSS
-
-#### Built-in Features
-- **Authentication System** - Login, register, password reset, JWT management
-- **Dashboard** - Analytics overview, metric cards, chart widgets
-- **User Management** - User CRUD, profiles, role management, activity tracking
-- **Real-time Updates** - Socket.IO integration, live notifications
-- **Data Tables** - Advanced filtering, sorting, pagination, bulk actions
-- **Charts & Analytics** - Line, bar, pie, area charts with real-time data
-- **Form Builder** - Dynamic forms, validation, file uploads, multi-step forms
-- **File Upload** - Drag & drop, progress tracking, file preview
-- **Notifications** - Toast notifications, notification center, push notifications
-- **Settings Panel** - Application settings, user preferences, theme customization
-
-#### Project Structure
-```
-my-admin-app/
-├── src/
-│   ├── components/           # Reusable UI components
-│   │   ├── ui/              # Base UI components
-│   │   └── layout/          # Layout components
-│   ├── features/            # Feature modules
-│   │   ├── auth/           # Authentication
-│   │   ├── dashboard/      # Dashboard
-│   │   ├── users/          # User management
-│   │   └── [modules]/      # Generated modules
-│   ├── hooks/              # Custom React hooks
-│   ├── services/           # API services
-│   ├── lib/                # Utilities and configurations
-│   ├── types/              # TypeScript type definitions
-│   ├── styles/             # Global styles
-│   └── assets/             # Static assets
-├── public/                 # Public assets
-├── package.json           # Dependencies and scripts
-├── tsconfig.json          # TypeScript configuration
-├── tailwind.config.js     # Tailwind CSS configuration
-├── vite.config.ts         # Vite configuration
-└── .env                   # Environment variables
+# Generate SMS configuration
+diagramers extend --sms-config \
+  --providers twilio,aws-sns \
+  --features verification,notifications
 ```
 
-### Email System Management
+### Database Commands
 
-#### Generate Email Module
+#### Database Operations
 ```bash
-diagramers extend --module email --crud
-```
-
-#### Add Email Configuration Table
-```bash
-diagramers extend --table email:configs --fields provider,code,credentials,fromName,fromEmail,default
-```
-
-#### Add Email Templates Table
-```bash
-diagramers extend --table email:templates --fields name,subject,body,isActive,createdAt
-```
-
-#### Add Email Logs Table
-```bash
-diagramers extend --table email:logs --fields to,subject,status,provider,error,createdAt
-```
+# Run database seeding
+diagramers db seed
 
-#### Create Email Relations
-```bash
-# One-to-many: User to Email Configs
-diagramers extend --relation email:user-config:one-to-many
+# Reset and reseed database
+diagramers db seed --reset
 
-# One-to-many: Email Config to Email Logs
-diagramers extend --relation email:config-log:one-to-many
-```
+# Generate seeders for specific modules
+diagramers db seed --modules products,users
 
-#### Add Email Endpoints
-```bash
-# Send email endpoint
-diagramers extend --endpoint email:send --method POST --description "Send email using configured provider"
+# Create database migration
+diagramers db migrate --create <migration-name>
 
-# Test email endpoint
-diagramers extend --endpoint email:test --method POST --description "Test email configuration"
+# Run database migrations
+diagramers db migrate --run
 
-# Get email statistics
-diagramers extend --endpoint email:stats --method GET --description "Get email sending statistics"
+# Rollback migrations
+diagramers db migrate --rollback
 ```
 
-#### Email Provider Setup Commands
+#### Database Configuration
 ```bash
-# Add Gmail SMTP configuration
-diagramers extend --endpoint email:setup-gmail --method POST --description "Setup Gmail SMTP configuration"
+# Generate database configuration
+diagramers db config --type mongodb --connection-pool 10
 
-# Add SendGrid configuration
-diagramers extend --endpoint email:setup-sendgrid --method POST --description "Setup SendGrid configuration"
+# Generate database schemas
+diagramers db schemas --modules products,users,orders
 
-# Add AWS SES configuration
-diagramers extend --endpoint email:setup-ses --method POST --description "Setup AWS SES configuration"
+# Generate database indexes
+diagramers db indexes --modules products --indexes name,price,category_id
 ```
 
-### User Management System
+### Testing Commands
 
-#### Generate User Module
+#### Generate Tests
 ```bash
-diagramers extend --module users --crud
-```
+# Generate unit tests
+diagramers test --unit --modules products,users
 
-#### Add User Profile Table
-```bash
-diagramers extend --table users:profiles --fields bio,avatar,socialLinks,location,website,birthDate,preferences
-```
+# Generate integration tests
+diagramers test --integration --modules products
 
-#### Add User Sessions Table
-```bash
-diagramers extend --table users:sessions --fields userId,deviceInfo,ipAddress,userAgent,isActive,lastActivity
-```
+# Generate API tests
+diagramers test --api --endpoints products,users
 
-#### Add User Activity Table
-```bash
-diagramers extend --table users:activities --fields userId,action,details,ipAddress,userAgent,timestamp
+# Generate test configuration
+diagramers test --config --framework jest --coverage
 ```
 
-#### Create User Relations
+### Documentation Commands
+
+#### Generate Documentation
 ```bash
-# One-to-one: User to Profile
-diagramers extend --relation users:user-profile:one-to-one
+# Generate API documentation
+diagramers docs api --format swagger --output docs/api
 
-# One-to-many: User to Sessions
-diagramers extend --relation users:user-session:one-to-many
+# Generate module documentation
+diagramers docs modules --format markdown --output docs/modules
 
-# One-to-many: User to Activities
-diagramers extend --relation users:user-activity:one-to-many
-```
+# Generate deployment documentation
+diagramers docs deployment --platforms docker,firebase --output docs/deployment
 
-#### Add User Endpoints
-```bash
-# User profile management
-diagramers extend --endpoint users:profile --method GET --description "Get user profile"
-diagramers extend --endpoint users:update-profile --method PUT --description "Update user profile"
-diagramers extend --endpoint users:upload-avatar --method POST --description "Upload user avatar"
-
-# User administration
-diagramers extend --endpoint users:list --method GET --description "List all users (admin)"
-diagramers extend --endpoint users:create --method POST --description "Create user (admin)"
-diagramers extend --endpoint users:update --method PUT --description "Update user (admin)"
-diagramers extend --endpoint users:delete --method DELETE --description "Delete user (admin)"
-
-# User statistics
-diagramers extend --endpoint users:stats --method GET --description "Get user statistics"
-diagramers extend --endpoint users:activity --method GET --description "Get user activity"
+# Generate README files
+diagramers docs readme --modules products,users --output docs
 ```
 
-## 🔧 Workflow Examples
-
-### Complete Product Management System
-
+### Documentation Templates
 ```bash
-# 1. Create new API project
-diagramers init api ecommerce-api
-cd ecommerce-api
-
-# 2. Generate products module
-diagramers extend --module products --crud
-
-# 3. Add categories table
-diagramers extend --table products:categories --fields name,description,slug
-
-# 4. Add products table
-diagramers extend --table products:products --fields name,price,description,category_id
-
-# 5. Create category-product relation
-diagramers extend --relation products:category-product:one-to-many
+# Use custom documentation template
+diagramers docs --template custom-docs --output docs
 
-# 6. Add custom search endpoint
-diagramers extend --endpoint products:search --method GET --description "Search products"
-
-# 7. Install dependencies and start
-npm install
-npm start
+# Generate documentation for specific features
+diagramers docs --features auth,email,sms --output docs/features
 ```
 
-### User Management with Profiles
+## 🔍 Troubleshooting
 
-```bash
-# 1. Generate users module (if not exists)
-diagramers extend --module users --crud
+### Common Issues
 
-# 2. Add user profiles table
-diagramers extend --table users:profiles --fields bio,avatar,social_links,birth_date
+#### Project Generation Issues
+```bash
+# Clear CLI cache
+diagramers cache clear
 
-# 3. Create user-profile relation
-diagramers extend --relation users:user-profile:one-to-one
+# Update CLI to latest version
+npm update -g @diagramers/cli
 
-# 4. Add profile endpoints
-diagramers extend --endpoint users:update-profile --method PUT
-diagramers extend --endpoint users:get-profile --method GET
+# Check template availability
+diagramers template list --available
 ```
 
-### Complete Email System Setup
-
+#### Module Generation Issues
 ```bash
-# 1. Generate email module with CRUD operations
-diagramers extend --module email --crud
-
-# 2. Add email configurations table
-diagramers extend --table email:configs --fields provider,code,credentials,fromName,fromEmail,default
-
-# 3. Add email templates table
-diagramers extend --table email:templates --fields name,subject,body,isActive,createdAt
-
-# 4. Add email logs table for tracking
-diagramers extend --table email:logs --fields to,subject,status,provider,error,createdAt
-
-# 5. Create relationships
-diagramers extend --relation email:user-config:one-to-many
-diagramers extend --relation email:config-log:one-to-many
+# Validate module configuration
+diagramers validate --module products
 
-# 6. Add email-specific endpoints
-diagramers extend --endpoint email:send --method POST --description "Send email using configured provider"
-diagramers extend --endpoint email:test --method POST --description "Test email configuration"
-diagramers extend --endpoint email:stats --method GET --description "Get email sending statistics"
+# Check field types
+diagramers validate --fields name:string,price:number
 
-# 7. Add provider setup endpoints
-diagramers extend --endpoint email:setup-gmail --method POST --description "Setup Gmail SMTP configuration"
-diagramers extend --endpoint email:setup-sendgrid --method POST --description "Setup SendGrid configuration"
-
-# 8. Install dependencies and start
-npm install
-npm start
+# Verify relationships
+diagramers validate --relation products:categories
 ```
 
-### Complete User Management System Setup
-
+#### Database Issues
 ```bash
-# 1. Generate users module with CRUD operations
-diagramers extend --module users --crud
-
-# 2. Add user profiles table
-diagramers extend --table users:profiles --fields bio,avatar,socialLinks,location,website,birthDate,preferences
-
-# 3. Add user sessions table for tracking
-diagramers extend --table users:sessions --fields userId,deviceInfo,ipAddress,userAgent,isActive,lastActivity
+# Check database connection
+diagramers db check --connection
 
-# 4. Add user activity table for audit
-diagramers extend --table users:activities --fields userId,action,details,ipAddress,userAgent,timestamp
+# Validate database schema
+diagramers db validate --schema
 
-# 5. Create user relationships
-diagramers extend --relation users:user-profile:one-to-one
-diagramers extend --relation users:user-session:one-to-many
-diagramers extend --relation users:user-activity:one-to-many
-
-# 6. Add user profile endpoints
-diagramers extend --endpoint users:profile --method GET --description "Get user profile"
-diagramers extend --endpoint users:update-profile --method PUT --description "Update user profile"
-diagramers extend --endpoint users:upload-avatar --method POST --description "Upload user avatar"
-
-# 7. Add user administration endpoints
-diagramers extend --endpoint users:list --method GET --description "List all users (admin)"
-diagramers extend --endpoint users:create --method POST --description "Create user (admin)"
-diagramers extend --endpoint users:update --method PUT --description "Update user (admin)"
-diagramers extend --endpoint users:delete --method DELETE --description "Delete user (admin)"
-
-# 8. Add user analytics endpoints
-diagramers extend --endpoint users:stats --method GET --description "Get user statistics"
-diagramers extend --endpoint users:activity --method GET --description "Get user activity"
-
-# 9. Install dependencies and start
-npm install
-npm start
+# Test database operations
+diagramers db test --operations
 ```
 
-## 🛠️ Advanced Usage
-
-### Database Seeding
-
-All generated tables automatically include:
-- **Sample data** - 3 sample records per table
-- **Seeder integration** - Automatic database seeding
-- **Development data** - Realistic test data
-
+### Debug Mode
 ```bash
-# Run database seeding
-npm run seed
+# Enable debug logging
+diagramers --debug init api my-project
 
-# Reset and reseed database
-npm run seed --reset
-```
-
-### Template Updates
+# Verbose output
+diagramers --verbose extend --module products
 
-```bash
-# Update project with latest template
-diagramers update
-
-# Force update with backup
-diagramers update --force --backup
+# Dry run (preview changes)
+diagramers --dry-run extend --module products
 ```
 
-### Custom Field Types
-
-The CLI automatically detects field types based on naming conventions:
+## 🤝 Contributing
 
+### Development Setup
 ```bash
-# These fields will be auto-typed:
-diagramers extend --table products:products --fields \
-  name,description,price,stock_count,created_at,is_active,category_id
-```
+# Clone repository
+git clone https://github.com/diagramers/diagramers-cli.git
+cd diagramers-cli
 
-**Auto-detection:**
-- `name`, `title`, `description` → String
-- `price`, `count`, `stock_count` → Number
-- `created_at`, `updated_at` → Date
-- `is_active`, `verified` → Boolean
-- `category_id`, `user_id` → ObjectId
+# Install dependencies
+npm install
 
-## 📚 Project Structure
+# Link for development
+npm link
 
-Generated projects follow this structure:
+# Run tests
+npm test
 
+# Build project
+npm run build
 ```
-my-project/
-├── src/
-│   ├── modules/
-│   │   ├── products/
-│   │   │   ├── controllers/
-│   │   │   ├── entities/
-│   │   │   ├── schemas/
-│   │   │   ├── services/
-│   │   │   └── routes/
-│   │   └── users/
-│   ├── core/
-│   │   ├── database/
-│   │   ├── config/
-│   │   └── server/
-│   └── shared/
-├── scripts/
-└── package.json
-```
-
-## 🔍 Troubleshooting
 
-### Common Issues
+### Contributing Guidelines
+1. Fork the repository
+2. Create a feature branch
+3. Make your changes
+4. Add tests for new functionality
+5. Ensure all tests pass
+6. Submit a pull request
 
-#### Module Not Found
-```bash
-❌ Module 'inventory' does not exist
-```
-**Solution:** Create the module first:
+### Code Style
 ```bash
-diagramers extend --module inventory
-```
+# Run linting
+npm run lint
 
-#### Table Already Exists
-```bash
-❌ Table 'products' already exists in module 'products'
-```
-**Solution:** Use a different table name or check existing tables
-
-#### Invalid Relation
-```bash
-❌ Table 'categories' does not exist in module 'products'
-```
-**Solution:** Create both tables before creating relations:
-```bash
-diagramers extend --table products:categories --fields name,description
-diagramers extend --table products:products --fields name,price
-diagramers extend --relation products:category-product
-```
+# Fix linting issues
+npm run lint:fix
 
-### Getting Help
+# Format code
+npm run format
 
-```bash
-# General help
-diagramers --help
-
-# Command-specific help
-diagramers init --help
-diagramers extend --help
-diagramers update --help
+# Type checking
+npm run type-check
 ```
 
-## 🤝 Contributing
-
-We welcome contributions! Please see our [Contributing Guide](CONTRIBUTING.md) for details.
-
 ## 📄 License
 
-MIT License - see [LICENSE](LICENSE) file for details.
+MIT License - see LICENSE file for details
 
 ## 🔗 Related Packages
 
-- [@diagramers/api](https://npmjs.com/package/@diagramers/api) - API template package
-- [@diagramers/admin](https://npmjs.com/package/@diagramers/admin) - Admin template package
+- [@diagramers/api](./diagramers-api) - Node.js API template
+- [@diagramers/admin](./diagramers-admin) - React admin dashboard template
 
 ## 📞 Support
 
-- **Issues**: [GitHub Issues](https://github.com/diagramers/diagramers-cli/issues)
-- **Documentation**: [Official Docs](https://docs.diagramers.com)
-- **Community**: [Discord Server](https://discord.gg/diagramers) 
+For support and questions:
+- Create an issue on GitHub
+- Check the documentation
+- Review the examples in the codebase
+- Join our community discussions
+
+## 🗺️ Roadmap
+
+### Upcoming Features
+- [ ] GraphQL support
+- [ ] Microservices architecture
+- [ ] Kubernetes deployment
+- [ ] Advanced caching strategies
+- [ ] Real-time analytics
+- [ ] Advanced security features
+- [ ] Multi-tenant support
+- [ ] API versioning
+- [ ] Advanced rate limiting
+- [ ] Webhook system
+
+### Plugin Ecosystem
+- [ ] Plugin marketplace
+- [ ] Community plugins
+- [ ] Plugin development tools
+- [ ] Plugin testing framework
+- [ ] Plugin documentation generator
+
+### Integration Features
+- [ ] Third-party service integrations
+- [ ] Payment gateway integrations
+- [ ] Analytics integrations
+- [ ] Monitoring integrations
+- [ ] Backup service integrations 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@diagramers/cli",
-  "version": "4.0.0",
+  "version": "4.0.2",
   "description": "Diagramers CLI - Command-line tools for managing Diagramers projects",
   "main": "dist/index.js",
   "bin": {