@elyracode/laravel 0.9.23 → 0.9.25

package/CHANGELOG.md

@@ -1,5 +1,12 @@
 # Changelog
 
+## [0.9.25] - 2026-08-03
+
+### Changed
+- Skill updated for Laravel 13 (June 2026): new "Laravel 13 Additions" section covering route metadata, `whenFilledEnum`, `Bus::bulk()`, non-retryable exceptions, queue attributes on traits, `schema:dump --without-migration-data`, `Cache::rememberWithState()`, notification `attachFromStorage`, Postgres pooler support, MariaDB vector indexes, and a warning that `php artisan dev` is long-running and must not be run by the agent. Also fixed the db-tools tool reference (`get_database_schema`)
+
+## [0.9.24] - 2026-07-24
+
 ## [0.9.23] - 2026-07-23
 
 ## [0.9.22] - 2026-07-23

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@elyracode/laravel",
-  "version": "0.9.23",
+  "version": "0.9.25",
   "description": "Deep Laravel project understanding for Elyra -- model relationships, route mapping, architecture analysis",
   "type": "module",
   "keywords": [

package/skills/elyra-laravel/SKILL.md

@@ -29,7 +29,7 @@ Use Laravel tools when:
 If `@elyracode/db-tools` is installed, use BOTH for full understanding:
 
 1. `laravel_models` — shows PHP-side: relationships, fillable, casts, scopes, traits
-2. `db_schema` or database tools — shows DB-side: actual columns, types, indexes, foreign keys
+2. `get_database_schema` — shows DB-side: actual columns, types, indexes, foreign keys
 
 Compare the two to find gaps:
 - Columns in DB but not in `$fillable` (may need adding)
@@ -92,7 +92,7 @@ Run `laravel_analyze` or `laravel_models` BEFORE generating Laravel code. Match
 
 ## Testing Conventions
 
-- Use Pest for new Laravel 11+ projects
+- Use Pest for new Laravel projects (the default test framework since Laravel 11)
 - One test file per feature or model
 - Use factories for test data, never manual inserts
 - Name test methods descriptively: `it('creates a post with valid data')`
@@ -109,3 +109,25 @@ When adding a new feature, generate in this order:
 7. Routes
 8. Policy (authorization)
 9. Tests
+
+## Laravel 13 Additions (mid-2026)
+
+Prefer these over older workarounds when the project is on Laravel 13:
+
+| Feature | Use instead of |
+|---------|----------------|
+| `Route::metadata([...])` + `$request->route()->getMetadata('key')` | Stuffing route tags into route names or middleware parameters. Group metadata merges recursively into child routes; route-cache safe |
+| `$request->whenFilledEnum('status', Status::class, fn (Status $s) => ...)` | Manual `whenFilled` + `tryFrom` + null guard |
+| `Bus::bulk($jobs)` | Dispatching many jobs in a loop (one insert each) or a batch you don't need. Single bulk insert per queue/connection group |
+| A `retry(): false` method on an exception class, or non-retryable exceptions via `withExceptions()` in `bootstrap/app.php` | try/catch + manual `$this->fail()` in every job |
+| `#[Queue(...)]` on a shared trait | Duplicating queue attributes across job/event classes |
+| `php artisan schema:dump --without-migration-data` | Hand-editing dumps to strip migration rows |
+| `Cache::rememberWithState()` | Double cache checks when you need hit/miss info |
+| `attachFromStorage()` / `attachFromStorageDisk()` on notification `MailMessage` | Reading file contents manually before attaching |
+| Postgres pooler: `'pooled' => true` in the connection config; `::direct` suffix for DDL | Manual PgBouncer/RDS Proxy workarounds |
+| MariaDB vector indexes via the schema builder | Raw SQL for vector indexes (Postgres already supported) |
+| `Str::studly('CBOR', normalize: true)` | Manual lowercasing of ALL-CAPS segments |
+
+Notes:
+- `php artisan dev` replaces the `composer dev` script (server, queue, logs, Vite concurrently). It is long-running — do NOT run it as an agent; the user keeps it running.
+- Scheduler `between()`/`unlessBetween()` are now timezone-order independent — no need to call `timezone()` first.