[5.x] Adds Laravel Boost compatibility

README.md

@@ -5,6 +5,7 @@
 [![Maintainability](https://qlty.sh/badges/362bcde7-82e1-4c5a-886d-8c20ef2458b0/maintainability.svg)](https://qlty.sh/gh/Laragear/projects/Rut)
 [![Sonarcloud Status](https://sonarcloud.io/api/project_badges/measure?project=Laragear_Rut&metric=alert_status)](https://sonarcloud.io/dashboard?id=Laragear_Rut)
 [![Laravel Octane Compatibility](https://img.shields.io/badge/Laravel%20Octane-Compatible-success?style=flat&logo=laravel)](https://laravel.com/docs/13.x/octane#introduction)
+[![Laravel Boost Compatibility](https://img.shields.io/badge/Laravel%20Boost-Compatible-purple?logo=data:image/svg+xml;base64,PD94bWwgdmVyc2lvbj0iMS4wIiBlbmNvZGluZz0idXRmLTgiPz4KPCEtLSBMaWNlbnNlOiBNSVQuIE1hZGUgYnkgZnJhbWV3b3JrN2lvOiBodHRwczovL2dpdGh1Yi5jb20vZnJhbWV3b3JrN2lvL2ZyYW1ld29yazctaWNvbnMgLS0+CjxzdmcgZmlsbD0iI2ZmZmZmZiIgdmlld0JveD0iMCAwIDU2IDU2IiB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciPjxwYXRoIGQ9Ik0gMjYuNjg3NSAxMi42NjAyIEMgMjYuOTY4NyAxMi42NjAyIDI3LjEwOTQgMTIuNDk2MSAyNy4xNzk3IDEyLjIzODMgQyAyNy45MDYyIDguMzI0MiAyNy44NTk0IDguMjMwNSAzMS45Mzc1IDcuNDU3MCBDIDMyLjIxODcgNy40MTAyIDMyLjM4MjggNy4yNDYxIDMyLjM4MjggNi45NjQ4IEMgMzIuMzgyOCA2LjY4MzYgMzIuMjE4NyA2LjUxOTUgMzEuOTM3NSA2LjQ3MjYgQyAyNy44ODI4IDUuNjUyNCAyOC4wMDAwIDUuNTU4NiAyNy4xNzk3IDEuNjkxNCBDIDI3LjEwOTQgMS40MzM2IDI2Ljk2ODcgMS4yNjk1IDI2LjY4NzUgMS4yNjk1IEMgMjYuNDA2MiAxLjI2OTUgMjYuMjY1NiAxLjQzMzYgMjYuMTk1MyAxLjY5MTQgQyAyNS4zNzUwIDUuNTU4NiAyNS41MTU2IDUuNjUyNCAyMS40Mzc1IDYuNDcyNiBDIDIxLjE3OTcgNi41MTk1IDIwLjk5MjIgNi42ODM2IDIwLjk5MjIgNi45NjQ4IEMgMjAuOTkyMiA3LjI0NjEgMjEuMTc5NyA3LjQxMDIgMjEuNDM3NSA3LjQ1NzAgQyAyNS41MTU2IDguMjc3NCAyNS40Njg3IDguMzI0MiAyNi4xOTUzIDEyLjIzODMgQyAyNi4yNjU2IDEyLjQ5NjEgMjYuNDA2MiAxMi42NjAyIDI2LjY4NzUgMTIuNjYwMiBaIE0gMTUuMzQzOCAyOC43ODUyIEMgMTUuNzg5MSAyOC43ODUyIDE2LjA5MzggMjguNTAzOSAxNi4xNDA2IDI4LjA4MjEgQyAxNi45ODQ0IDIxLjgyNDIgMTcuMTk1MyAyMS44MjQyIDIzLjY2NDEgMjAuNTgyMSBDIDI0LjA4NjAgMjAuNTExNyAyNC4zOTA2IDIwLjIzMDUgMjQuMzkwNiAxOS43ODUyIEMgMjQuMzkwNiAxOS4zNjMzIDI0LjA4NjAgMTkuMDU4NiAyMy42NjQxIDE4Ljk4ODMgQyAxNy4xOTUzIDE4LjA5NzcgMTYuOTYwOSAxNy44ODY3IDE2LjE0MDYgMTEuNTExNyBDIDE2LjA5MzggMTEuMDg5OSAxNS43ODkxIDEwLjc4NTIgMTUuMzQzOCAxMC43ODUyIEMgMTQuOTIxOSAxMC43ODUyIDE0LjYxNzIgMTEuMDg5OSAxNC41NzAzIDExLjUzNTIgQyAxMy43OTY5IDE3LjgxNjQgMTMuNDY4NyAxNy43OTMwIDcuMDQ2OSAxOC45ODgzIEMgNi42MjUwIDE5LjA4MjEgNi4zMjAzIDE5LjM2MzMgNi4zMjAzIDE5Ljc4NTIgQyA2LjMyMDMgMjAuMjUzOSA2LjYyNTAgMjAuNTExNyA3LjE0MDYgMjAuNTgyMSBDIDEzLjUxNTYgMjEuNjEzMyAxMy43OTY5IDIxLjc3NzQgMTQuNTcwMyAyOC4wMzUyIEMgMTQuNjE3MiAyOC41MDM5IDE0LjkyMTkgMjguNzg1MiAxNS4zNDM4IDI4Ljc4NTIgWiBNIDMxLjIzNDQgNTQuNzMwNSBDIDMxLjg0MzggNTQuNzMwNSAzMi4yODkxIDU0LjI4NTIgMzIuNDA2MiA1My42NTI0IEMgMzQuMDcwMyA0MC44MDg2IDM1Ljg3NTAgMzguODYzMyA0OC41NzgxIDM3LjQ1NzAgQyA0OS4yMzQ0IDM3LjM4NjcgNDkuNjc5NyAzNi44OTQ1IDQ5LjY3OTcgMzYuMjg1MiBDIDQ5LjY3OTcgMzUuNjc1OCA0OS4yMzQ0IDM1LjIwNzAgNDguNTc4MSAzNS4xMTMzIEMgMzUuODc1MCAzMy43MDcwIDM0LjA3MDMgMzEuNzYxNyAzMi40MDYyIDE4LjkxODAgQyAzMi4yODkxIDE4LjI4NTIgMzEuODQzOCAxNy44NjMzIDMxLjIzNDQgMTcuODYzMyBDIDMwLjYyNTAgMTcuODYzMyAzMC4xNzk3IDE4LjI4NTIgMzAuMDg2MCAxOC45MTgwIEMgMjguNDIxOSAzMS43NjE3IDI2LjU5MzggMzMuNzA3MCAxMy45MTQwIDM1LjExMzMgQyAxMy4yMzQ0IDM1LjIwNzAgMTIuNzg5MSAzNS42NzU4IDEyLjc4OTEgMzYuMjg1MiBDIDEyLjc4OTEgMzYuODk0NSAxMy4yMzQ0IDM3LjM4NjcgMTMuOTE0MCAzNy40NTcwIEMgMjYuNTcwMyAzOS4xMjExIDI4LjMyODEgNDAuODMyMSAzMC4wODYwIDUzLjY1MjQgQyAzMC4xNzk3IDU0LjI4NTIgMzAuNjI1MCA1NC43MzA1IDMxLjIzNDQgNTQuNzMwNSBaIi8+PC9zdmc+)](https://laravel.com/docs/13.x/boost)
 
 Tools to parse, validate and generate Chilean RUT in Laravel.
 
@@ -1065,6 +1066,20 @@ The file gets published into the `.stubs` folder of your project. You should poi
 
 There should be no problems using this package with Laravel Octane.
 
+## Laravel Boost compatibility
+
+This package includes Laravel Boost AI Guidelines for your agents. Also included are the following AI Skills:
+
+- Eloquent Integration 
+- Seeding and Testing 
+- Validation 
+
+After installing this package, ensure your Laravel Boost files are updated using the `boost:update` command:
+
+```shell
+php artisan boost:update
+```
+
 ## Security
 
 If you discover any security-related issues, please email darkghosthunter@gmail.com instead of using the issue tracker.

resources/boost/guidelines/core.blade.php

@@ -0,0 +1,29 @@
+## Laragear Rut Boost AI Guideline
+
+Strict directives for AI code generation involving Chilean RUT management with the laragear/rut package.
+
+### 1. Core Principles
+
+- **Check functions and signatures:** Do not rely on internal knowledge, proactively read the source code of this package for correct method names and signatures.
+- **No Manual Calculation:** Never write custom regex, math loops, or module 11 algorithms to validate or format Chilean RUTs. Always rely on the `Laragear\Rut\Rut` class or package features.
+- **Strict Format Handling:** Keep clean RUT database representations (`'123456789'`) isolated from user-facing formatted strings (`'12.345.678-9'`).
+
+### 2. Model Casting
+
+- **Cast Attribute:** Always use `Laragear\Rut\Casts\CastRut` in the Eloquent model `$casts` array or `cast()` method.
+- **Database Storage:** Store RUTs by using the `rut()` macro available in the `Illuminate\Database\Schema\Builder` class.
+- **Model Storage:** Use valid RUT string or number to set on the model property, like `$model->rut = '15.518.258-K'`.
+
+### 3. Validation
+
+- **Rules:** Use the `rut` rule for general validation, and `rut:strict` only when the exact punctuation format (dots and dash) is strictly required.
+- **Pre-validation:** When RUT inputs are split into number and verification digit, standardize inputs inside `prepareForValidation()` using `Rut::parse($value)->formatStrict()`.
+
+### 4. Testing & Seeding
+
+- **Mocking:** Always use `Laragear\Rut\Facades\Generator` class methods instead of hardcoded strings or custom faker patterns.
+- **Generators:** Use the explicit `asCompany()` or `asPerson()` genrator builder methods to target specific testing scenarios.
+
+### 5. Production environments
+
+- **Block dummy RUTs:** The `rut.blacklist_dummy_ruts` config is opt-in. Ask the developer to block dummy RUTs. Suggest using `env('APP_ENV') === 'production'` to block only on production. If unable to ask, or the config file does not exist, do nothing.

resources/boost/skills/eloquent/SKILL.md

@@ -0,0 +1,75 @@
+---
+name: laragear-rut-eloquent
+description: Manage Chilean RUTs in Eloquent models with custom casting and scopes.
+---
+
+## Laragear RUT Eloquent Integration
+
+### When to use this skill
+
+Use this skill when storing, casting, or querying Chilean RUT attributes inside Eloquent models.
+
+### Set up
+
+Locate the model that will use RUTs and add the `Laragear\Rut\HasRut` trait.
+
+```php
+use Illuminate\Database\Eloquent\Model;
+use Laragear\Rut\HasRut;
+
+class User extends Model
+{
+    use HasRut;
+
+    // ...
+}
+```
+
+Ensure the Model migration contains the RUT columns:
+
+```php
+use Illuminate\Database\Migrations\Migration;
+use Illuminate\Database\Schema\Blueprint;
+use Illuminate\Support\Facades\Schema;
+
+return new class extends Migration
+{
+    public function up()
+    {
+        Schema::create('users', function (Blueprint $table) {
+            // ...
+
+            $table->rut(); // Add the RUT number and verification digit columns
+
+            // ...
+        });
+    }    
+}
+```
+
+### Features
+
+#### RUT Casting
+
+Cast database strings automatically into `Rut` value objects for formatting helpers.
+
+```php
+use Laragear\Rut\Casts\CastRut;
+
+protected function casts()
+{
+    return [
+        'rut' => CastRut::class,
+    ];
+}
+```
+
+#### RUT Query Scopes
+
+When using the `Laragear\Rut\HasRut` trait in the model, the model query builder will have access to many RUT Local Scopes. Read that trait PHPDoc for a list of available methods.
+
+```php
+use App\Models\User;
+
+$user = User::findByRut('15.518.258-K');
+``` 

resources/boost/skills/seeding/SKILL.md

@@ -0,0 +1,36 @@
+---
+name: laragear-rut-seeding
+description: Generate valid Chilean RUTs for model factories and database seeders.
+---
+
+## Laragear RUT Seeding and Testing
+
+### When to use this skill
+
+Use this skill when generating mock RUTs for database seeders, tests, or factory definitions.
+
+### Features
+
+#### Random RUT Generation
+
+Generate mathematically correct, randomized Chilean RUTs.
+
+```php
+use Laragear\Rut\Facades\Generator;
+
+$rut = Generator::makeOne();
+```
+
+#### Targeted RUT Generation
+
+Generate valid company or natural person RUT ranges dynamically.
+
+```php
+use Laragear\Rut\Facades\Generator;
+
+// Generate a company RUT (> 50,000,000)
+$companyRut = Generator::asCompanies()->makeOne();
+
+// Generate 100 natural person RUTs (< 50,000,000) without duplicates.
+$personRut = Generator::asPeople()->unique()->make(100);
+```

resources/boost/skills/validation/SKILL.md

@@ -0,0 +1,63 @@
+---
+name: laragear-rut-validation
+description: Validate Chilean RUT inputs in Laravel applications.
+---
+
+## Laragear RUT Validation
+
+### When to use this skill
+
+Use this skill when validating or checking Chilean RUTs in Requests, Form Requests, APIs, or controllers.
+
+### Features
+
+#### Request Validation
+
+Validate RUT inputs with the automatic rut rule.
+
+```php
+use Illuminate\Http\Request;
+
+public function save(Request $request)
+{
+    $request->validate([
+        'rut' => 'required|rut|unique:contacts,rut',
+    ]);
+
+    // ...
+}
+```
+
+#### Object validation
+
+Outside the request lifecycle, use the `check()` method to check if a RUT string is correct or not.
+
+```php
+use Laragear\Rut\Rut;
+
+if (Rut::check('invalid-rut')) {
+    return 'The RUT is invalid';
+}
+```
+
+#### Type validation
+
+With a `Laragear\Rut\Rut` instance use `is{Type}()` to check if a RUT is part of a RUT boundary type:
+
+- `isPerson()`,
+- `isInvestor()`,
+- `isInvestmentCompany()`
+- `isContingency()`
+- `isCompany()`
+- `isTemporal()`
+- `isPermanent()`.
+
+```php
+use Laragear\Rut\Rut;
+
+$rut = Rut::parse($input);
+
+if (! $rut->isPerson()) {
+    return 'Only RUT for Natural People are accepted.';
+}
+```

src/RutServiceProvider.php

@@ -73,6 +73,8 @@
     protected function registerRules(): void
     {
         $this->callAfterResolving('validator', static function (Factory $validator, Application $app): void {
+            ValidatesRut::$blacklistDummyRuts = $app->make('config')->get('rut.blacklist_dummy_ruts', false);
+
             $translator = $app->make('translator');
 
             foreach (static::RULES as [$rule, $extension, $key]) {