@agility-luhn/cli 1.10.0 → 1.11.0

package/CHANGELOG.md

@@ -1,3 +1,5 @@
+## [1.11.0](https://github.com/flaviorafaelo-agility/luhn-workspace/compare/cli-v1.10.0...cli-v1.11.0) (2026-07-08)
+
 ## [1.10.0](https://github.com/flaviorafaelo-agility/luhn-workspace/compare/cli-v1.9.0...cli-v1.10.0) (2026-07-08)
 
 ## [1.9.0](https://github.com/flaviorafaelo-agility/luhn-workspace/compare/cli-v1.8.0...cli-v1.9.0) (2026-07-08)

package/README.md

@@ -1,19 +1,17 @@
 # LUHN CLI
 
-Official Command-Line Interface for the LUHN Framework - A modern, developer-friendly framework for building scalable applications with type-safe database operations, OData filtering, and automatic code generation.
+Official Command-Line Interface for the LUHN Framework - A modern framework for building scalable applications with type-safe database operations and automatic code generation.
 
 [![npm version](https://badge.fury.io/js/%40agility-luhn%2Fcli.svg)](https://badge.fury.io/js/%40agility-luhn%2Fcli)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 
 ## Features
 
-✨ **Project Initialization** - Bootstrap a new LUHN project with interactive setup
-🏗️ **Compilation** - Transform DSL files into TypeScript, database schemas, and API definitions
-📦 **Module Discovery** - List all modules, entities, and their attributes
-🗄️ **Database Management** - Migrate, sync, and introspect databases
-🚀 **Runtime Server** - Start your application server with hot-reload support
-📝 **Type Safety** - Full TypeScript support with auto-generated types
-🔌 **OData Filtering** - Built-in OData v4 query support
+- ✨ **Project Initialization** - Bootstrap a new LUHN project with interactive setup
+- 🏗️ **Compilation** - Transform DSL files into TypeScript and database schemas
+- 📦 **Module Discovery** - List all modules, entities, and their attributes
+- 🗄️ **Database Management** - Migrate, sync, and introspect databases
+- 🚀 **Development Server** - Start your application server with hot-reload support
 
 ## Installation
 
@@ -21,9 +19,7 @@ Install LUHN CLI globally:
 
 ```bash
 npm install -g @agility-luhn/cli
-# or
 pnpm add -g @agility-luhn/cli
-# or
 yarn global add @agility-luhn/cli
 ```
 
@@ -43,49 +39,11 @@ luhn init
 luhn create
 ```
 
-This will guide you through an interactive setup:
-- Project name
-- Description
-- Package manager selection
-- Initial template selection
-
-```
-$ luhn init
-
-  _                 _   _   _   _   _
- | |               | | | | | | | | | |
- | |     _   _  ___| |_| | | |_| | | |
- | |    | | | |/ _ \  _  | |  _  | | |
- | |____| |_| |  __/| | | | | | | | |_|
- |_____|___/|_|___|_| |_| |_| |_| |_|_|
-
-? Project name: my-app
-? Description: My awesome LUHN application
-? Use TypeScript: Yes
-? Install dependencies: Yes
-
-✅ Project created successfully!
-```
+The CLI will guide you through an interactive setup asking for project name, description, and package manager.
 
 ### 2. Define Your Business Logic
 
-Create `.luhn` files in the `luhn/` directory:
-
-```luhn
-# luhn/user/user.luhn
-business "User" "User Management" {
-  id: uuid
-  name: string
-  email: string
-  createdAt: timestamp?
-}
-
-entity "UserProfile" "Extended user information" {
-  userId: uuid
-  bio: string
-  avatar: string?
-}
-```
+Create `.luhn` files in the `luhn/` directory to define your entities and services.
 
 ### 3. Compile Your Project
 
@@ -93,45 +51,32 @@ entity "UserProfile" "Extended user information" {
 luhn compile
 ```
 
-This generates:
-- TypeScript types and interfaces
-- Database migration files
-- OpenAPI/Swagger definitions
-- SQL schemas
-- Runtime handlers
+Generates TypeScript types, database migrations, and schema files.
 
 ### 4. Manage Your Database
 
 ```bash
-# Create or update database
-luhn db migrate
-
-# Sync with current schema
-luhn db sync
-
-# Introspect existing database
-luhn db introspect
+luhn db migrate    # Apply pending migrations
+luhn db sync       # Sync schema with database
+luhn db introspect # Inspect existing database
 ```
 
 ### 5. Start Development Server
 
 ```bash
-luhn serve
-# or with watch mode
-luhn serve --watch
+luhn serve         # Start development server
+luhn serve --watch # With file watching
 ```
 
-Server runs on `http://localhost:3000` by default.
-
 ## Commands
 
 ### `luhn init` / `luhn create`
 
-Initialize a new LUHN project with templates and dependencies.
+Initialize a new LUHN project.
 
 ```bash
 luhn init [targetDir]
-luhn create my-project  # Create in specific directory
+luhn create my-project
 ```
 
 **Options:**
@@ -141,11 +86,10 @@ luhn create my-project  # Create in specific directory
 
 ### `luhn compile`
 
-Compile LUHN DSL files to artifacts.
+Compile LUHN DSL files to artifacts (TypeScript, schemas, migrations).
 
 ```bash
 luhn compile [sourceDir]
-luhn compile ./luhn    # Compile from specific directory
 ```
 
 **Options:**
@@ -153,106 +97,34 @@ luhn compile ./luhn    # Compile from specific directory
 - `--watch` - Watch for changes and recompile
 - `--strict` - Strict validation mode
 
-**Generates:**
-- TypeScript interfaces and types
-- Database schemas
-- API routes
-- OpenAPI definitions
-
 ### `luhn list` / `luhn ls`
 
 Discover and list all modules, entities, and their attributes.
 
 ```bash
-luhn list
-luhn ls --full          # Show all attributes
-luhn list -m auth       # Filter by module
-luhn list -e User       # Filter by entity
-luhn list --json        # JSON output
+luhn list              # List all modules
+luhn list --full       # Show all attributes
+luhn list -m auth      # Filter by module
+luhn list -e User      # Filter by entity
+luhn list --json       # JSON output
 ```
 
 **Options:**
 - `-m, --module <name>` - Filter by module name
-- `-e, --entity <name>` - Filter by entity/class name
+- `-e, --entity <name>` - Filter by entity name
 - `-f, --full` - Show complete attribute details
-- `--json` - Output as JSON (useful for automation)
-
-**Examples:**
-
-```bash
-# List all modules in project
-$ luhn list
-
-  _                 _   _   _   _   _
- | |               | | | | | | | | | |
- | |     _   _  ___| |_| | | |_| | | |
- | |    | | | |/ _ \  _  | |  _  | | |
- | |____| |_| |  __/| | | | | | | | |_|
- |_____|___/|_|___|_| |_| |_| |_| |_|_|
-
-  LUHN CLI: 1.9.0
-  Node: v22.14.0
-  Package Manager: pnpm 10.20.0
-  OS: win32 x64
-
-📦 LUHN Project Structure
-
-  📂 Module: user
-     🎯 BUSINESS: User ("User Management")
-        └─ 5 attribute(s)
-
-  📂 Module: auth
-     🎯 BUSINESS: Session ("Session Management")
-        └─ 3 attribute(s)
-
-  ✅ Summary:
-     Modules:    2
-     Entities:   2
-     Attributes: 8
-
-  💡 Tip: Use --full flag to see all attributes
-
-# Show full details
-$ luhn list --full
-
-  📂 Module: user
-     🎯 BUSINESS: User ("User Management")
-        ✓ id: uuid
-        ✓ name: string
-        ✓ email: string
-        ○ avatar: string
-        ✓ createdAt: timestamp
-
-# Filter by module
-$ luhn list -m auth
-
-# JSON output for scripting
-$ luhn list --json
-[
-  {
-    "module": "user",
-    "entities": [
-      {
-        "name": "User",
-        "type": "business",
-        "title": "User Management",
-        "attributeCount": 5
-      }
-    ]
-  }
-]
-```
+- `--json` - Output as JSON
 
 ### `luhn db`
 
-Database management commands.
+Manage database operations.
 
 ```bash
-luhn db migrate         # Apply pending migrations
-luhn db sync            # Sync schema with database
-luhn db introspect      # Inspect existing database
-luhn db create          # Create database
-luhn db reset           # Reset database (development only)
+luhn db migrate    # Apply pending migrations
+luhn db sync       # Sync schema with database
+luhn db introspect # Inspect existing database
+luhn db create     # Create database
+luhn db reset      # Reset database (development only)
 ```
 
 **Options:**
@@ -265,7 +137,7 @@ luhn db reset           # Reset database (development only)
 Start the development server.
 
 ```bash
-luhn serve [options]
+luhn serve
 ```
 
 **Options:**
@@ -274,288 +146,12 @@ luhn serve [options]
 - `--debug` - Run with debug logging
 - `--no-reload` - Disable hot-reload
 
-## Project Structure
-
-A typical LUHN project structure:
-
-```
-my-project/
-├── luhn/                    # DSL definitions
-│   ├── user/
-│   │   ├── user.luhn
-│   │   └── profile.luhn
-│   └── auth/
-│       └── session.luhn
-├── src/
-│   ├── generated/          # Auto-generated files
-│   │   ├── types/
-│   │   ├── schema/
-│   │   └── routes/
-│   ├── handlers/           # Business logic
-│   ├── middleware/         # Express/Fastify middleware
-│   └── server.ts           # Main server entry
-├── db/                     # Database files
-│   ├── migrations/
-│   └── seeds/
-├── .env                    # Environment variables
-├── package.json
-├── tsconfig.json
-└── README.md
-```
-
-## Configuration
-
-### `.luhnrc.json` (Optional)
-
-Configure LUHN behavior:
-
-```json
-{
-  "compiler": {
-    "outputDir": "src/generated",
-    "strict": true,
-    "generateOpenAPI": true
-  },
-  "database": {
-    "engine": "postgres",
-    "migrations": "db/migrations"
-  },
-  "server": {
-    "port": 3000,
-    "host": "localhost"
-  }
-}
-```
-
-### Environment Variables
-
-Create a `.env` file:
-
-```env
-# Database
-DB_CONNECTION=postgresql://user:password@localhost:5432/myapp
-
-# Server
-PORT=3000
-NODE_ENV=development
-
-# Optional
-DEBUG=luhn:*
-LOG_LEVEL=info
-```
-
-## DSL Syntax
-
-### Business Entity
-
-```luhn
-business "EntityName" "Description" {
-  fieldName: dataType
-  optionalField: dataType?
-}
-```
-
-### Database Entity
-
-```luhn
-entity "EntityName" "Description" {
-  fieldName: dataType
-}
-```
-
-### Service (API Handlers)
-
-```luhn
-service "ServiceName" "Description" {
-  methodName: dataType
-}
-```
-
-### Supported Data Types
-
-- `uuid` - UUID identifier
-- `string` - Text
-- `number` - Integer or decimal
-- `boolean` - True/false
-- `timestamp` - Date and time
-- `json` - JSON object
-- `text` - Long text
-
-## Examples
-
-### Create a User Management Module
-
-**Step 1: Define the DSL**
-
-```luhn
-# luhn/user/user.luhn
-business "User" "User Management" {
-  id: uuid
-  email: string
-  name: string
-  role: string
-  isActive: boolean
-  createdAt: timestamp?
-  updatedAt: timestamp?
-}
-
-entity "UserPreferences" "User settings" {
-  userId: uuid
-  theme: string?
-  language: string?
-  notifications: boolean
-}
-```
-
-**Step 2: Compile**
-
-```bash
-luhn compile
-```
-
-**Step 3: Check generated files**
-
-```bash
-luhn list -m user --full
-```
-
-**Step 4: Create database migration**
-
-```bash
-luhn db migrate --name "create_user_tables"
-```
-
-**Step 5: Start development**
-
-```bash
-luhn serve --watch
-```
-
-### Export Project Structure
-
-```bash
-# Export to JSON file
-luhn list --json > project-structure.json
-
-# Filter specific module
-luhn list -m auth --json > auth-module.json
-
-# Use in documentation generation
-luhn list --full --json | jq . > docs/structure.json
-```
-
-## Troubleshooting
-
-### `No LUHN directory found`
-
-**Problem:** Getting error when running `luhn list` or `luhn compile`
-
-**Solution:** Make sure you're in a LUHN project directory. The CLI looks for:
-- `./luhn` - Main directory
-- `./src/luhn` - Nested structure
-- `../luhn` - Parent directory
-
-```bash
-# Verify directory structure
-ls -la luhn/
-
-# Or create one
-mkdir -p luhn
-```
-
-### `Failed to compile`
-
-**Problem:** TypeScript compilation errors
-
-**Solution:** Check your DSL syntax and try strict mode:
-
-```bash
-luhn compile --strict
-```
-
-### `Database connection error`
-
-**Problem:** Cannot connect to database
-
-**Solution:** Verify `.env` file:
-
-```bash
-# Check connection string
-cat .env
-
-# Test connection
-luhn db migrate --dry-run
-```
-
-### Version mismatch
-
-**Problem:** CLI version doesn't match package version
-
-**Solution:** Update CLI:
-
-```bash
-npm install -g @agility-luhn/cli@latest
-# or
-pnpm add -g @agility-luhn/cli@latest
-```
-
-## Debugging
-
-Enable debug logging:
-
-```bash
-DEBUG=luhn:* luhn compile
-```
-
-Or set environment variable:
-
-```bash
-export DEBUG=luhn:*
-luhn serve
-```
-
-## Performance Tips
-
-1. **Incremental Compilation** - Use watch mode during development
-   ```bash
-   luhn compile --watch
-   ```
-
-2. **Database Caching** - Cache introspection results
-   ```bash
-   luhn db introspect --cache
-   ```
-
-3. **Parallel Processing** - Enable for large projects
-   ```bash
-   luhn compile --parallel
-   ```
-
-## Release Notes
-
-See [CHANGELOG.md](./CHANGELOG.md) for version history and updates.
-
-## Contributing
+## License
 
-We welcome contributions! Please see our [contribution guidelines](https://github.com/flaviorafaelo-agility/luhn-workspace).
+MIT © [Agility Solutions](https://github.com/flaviorafaelo-agility)
 
 ## Support
 
 - 📖 [Documentation](https://github.com/flaviorafaelo-agility/luhn-workspace)
-- 🐛 [Report Issues](https://github.com/flaviorafaelo-agility/luhn-workspace/issues)
+- 🐛 [Issues](https://github.com/flaviorafaelo-agility/luhn-workspace/issues)
 - 💬 [Discussions](https://github.com/flaviorafaelo-agility/luhn-workspace/discussions)
-
-## License
-
-MIT © [Agility Solutions](https://github.com/flaviorafaelo-agility)
-
-## Related Packages
-
-- **[@agility-luhn/compiler](https://www.npmjs.com/package/@agility-luhn/compiler)** - LUHN compiler core
-- **[@agility-luhn/runtime](https://www.npmjs.com/package/@agility-luhn/runtime)** - Runtime utilities
-- **[@agility-luhn/database](https://www.npmjs.com/package/@agility-luhn/database)** - Database layer
-- **[@agility-luhn/database-postgres](https://www.npmjs.com/package/@agility-luhn/database-postgres)** - PostgreSQL adapter
-
----
-
-**Made with ❤️ by [Agility Solutions](https://agilitysolutions.com.br)**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agility-luhn/cli",
-  "version": "1.10.0",
+  "version": "1.11.0",
   "private": false,
   "description": "CLI oficial para inicializacao e compilacao de projetos LUHN.",
   "license": "MIT",