feat: update signature for file gen commands (#27)

Consolidates the command interface by renaming file generation commands from mandate:make:* to mandate:* and merging database creation functionality into the same commands via a --db flag. This simplifies the command structure and provides a more intuitive API where the default behavior generates PHP classes (code-first approach) and the --db flag creates database records directly (database-first approach).

Changes:
* Unified command signatures: mandate:permission, mandate:role, mandate:capability, and mandate:feature now support both class generation (default) and database creation (with --db flag)
* Removed separate CreateRoleCommand, CreatePermissionCommand, and CreateCapabilityCommand classes
* Updated all tests, documentation, and configuration references to use the new command names

Author: shavonn

README.md

@@ -73,6 +73,12 @@ php artisan migrate
 
 That's it. No configuration required for most applications.
 
+**Publish the config file for customization:**
+
+```bash
+php artisan vendor:publish --tag=mandate-config
+```
+
 **Optional migrations** (publish only what you need):
 
 ```bash
@@ -383,17 +389,20 @@ User::withoutPermission('admin:access')->get();
 ## Artisan Commands
 
 ```bash
-# Create a permission
-php artisan mandate:permission article:edit
-php artisan mandate:permission article:edit --guard=api
+# Generate a permission class (code-first)
+php artisan mandate:permission ArticlePermissions
+php artisan mandate:permission ArticlePermissions --guard=api
+
+# Generate a role class (code-first)
+php artisan mandate:role SystemRoles
 
-# Create a role
-php artisan mandate:role editor
-php artisan mandate:role editor --permissions=article:edit,article:view
+# Generate a capability class (code-first)
+php artisan mandate:capability ContentCapabilities
 
-# Create a capability (requires capabilities.enabled = true)
-php artisan mandate:capability manage-posts
-php artisan mandate:capability manage-posts --permissions=post:create,post:edit
+# Create directly in database (use --db flag)
+php artisan mandate:permission article:edit --db
+php artisan mandate:role editor --db --permissions=article:edit,article:view
+php artisan mandate:capability manage-posts --db --permissions=post:create,post:edit
 
 # Assign a role to a subject (user, team, etc.)
 php artisan mandate:assign-role 1 admin
@@ -661,10 +670,13 @@ $user->getAllCapabilities(); // Includes both direct and via roles
 ### Artisan Commands for Capabilities
 
 ```bash
-# Create a capability
-php artisan mandate:capability manage-posts
-php artisan mandate:capability manage-posts --guard=api
-php artisan mandate:capability manage-posts --permissions=post:create,post:edit,post:delete
+# Generate a capability class (code-first)
+php artisan mandate:capability ContentCapabilities
+
+# Create capability directly in database
+php artisan mandate:capability manage-posts --db
+php artisan mandate:capability manage-posts --db --guard=api
+php artisan mandate:capability manage-posts --db --permissions=post:create,post:edit,post:delete
 
 # Assign capability to a role
 php artisan mandate:assign-capability editor manage-posts
@@ -1106,14 +1118,14 @@ Generate new definition classes with scaffolded constants:
 
 ```bash
 # Generate a permission class with CRUD constants
-php artisan mandate:make:permission ArticlePermissions
-php artisan mandate:make:permission ArticlePermissions --guard=api
+php artisan mandate:permission ArticlePermissions
+php artisan mandate:permission ArticlePermissions --guard=api
 
 # Generate a role class
-php artisan mandate:make:role SystemRoles
+php artisan mandate:role SystemRoles
 
 # Generate a capability class
-php artisan mandate:make:capability ContentCapabilities
+php artisan mandate:capability ContentCapabilities
 ```
 
 Customize the generated stubs:

UPGRADE.md

@@ -227,14 +227,15 @@ php artisan mandate:role SystemRoles
 **After (2.x):**
 
 ```bash
-# Database-first commands (create directly in database)
-php artisan mandate:permission user:view
-php artisan mandate:role admin
-
-# Code-first commands (generate PHP classes)
-php artisan mandate:make:permission UserPermissions
-php artisan mandate:make:role SystemRoles
-php artisan mandate:make:capability ContentCapabilities
+# Code-first commands (generate PHP classes) - default behavior
+php artisan mandate:permission UserPermissions
+php artisan mandate:role SystemRoles
+php artisan mandate:capability ContentCapabilities
+
+# Database-first commands (use --db flag)
+php artisan mandate:permission user:view --db
+php artisan mandate:role admin --db
+php artisan mandate:capability manage-posts --db
 
 # Sync code-first definitions to database
 php artisan mandate:sync

config/mandate.php

@@ -120,7 +120,7 @@
     | Feature Generator
     |--------------------------------------------------------------------------
     |
-    | Class that handles generating feature classes for the mandate:make:feature
+    | Class that handles generating feature classes for the mandate:feature
     | command. External packages (e.g., Flagged) can provide their own generator.
     | Must implement OffloadProject\Mandate\Contracts\FeatureGenerator.
     |