eighteen73 / laravel-ai-assist
eighteen73 Laravel Toolkit
Requires
- php: ^8.2
- composer/semver: ^3.0 || ^4.0
- illuminate/support: ^12.0 || ^13.0
Requires (Dev)
- ergebnis/composer-normalize: ^2.52
- laravel/boost: ^2.0
- laravel/pint: ^1.29
- orchestra/testbench: ^10.0 || ^11.0
- phpunit/phpunit: ^11.0 || ^12.0
Suggests
- pestphp/pest: Required for Pest architecture testing (^3.0).
README
A central package for developer tooling, AI assist agents, shared testing conventions, and architecture standards across eighteen73's Laravel projects.
Installation
You can install the package via Composer as a development dependency:
composer require --dev eighteen73/laravel-toolkit
The package will automatically register its service provider Eighteen73\Toolkit\ToolkitServiceProvider using Laravel's package discovery.
Features
Testing Standards
The package provides shared Pest testing conventions built on Pest 3's arch()->preset()->laravel() and arch()->preset()->security() presets alongside eighteen73 conventions and composer.json verification.
When registered, it automatically enforces:
- Full Laravel framework architecture conventions via
arch()->preset()->laravel()(controllers, models, commands, requests, jobs, mailables, notifications, providers, listeners, middleware, exceptions, and policies). - Insecure function bans via
arch()->preset()->security()(eval,exec,shell_exec,system,unserialize,md5,sha1,rand,uniqid, etc.). - Banning of all leftover debugging functions (
dd,dump,ray, andvar_dump) in CI mode. - Observer suffix conventions (
App\Observersending inObserver). - Validation rule conventions (
App\RulesimplementingIlluminate\Contracts\Validation\ValidationRule). - Agency
composer.jsoncompliance (ergebnis/composer-normalizepresent and allowed,config.platform.phpdefined, and platform PHP version satisfying therequire.phpconstraint).
In your parent application's tests/Arch.php (or tests/Feature/ArchTest.php):
use Eighteen73\Toolkit\Testing\AgencyStandards; AgencyStandards::register();
You can pass project-specific ignores as a list of classes / functions or grouped by category (e.g. allowing md5 for Gravatars or checksums):
AgencyStandards::register( ignores: [ 'App\Models\LegacyData', 'security' => [ 'md5', ], ] );
Laravel Boost AI Agents
When laravel/boost is installed, the package automatically registers eighteen73 custom AI agents (such as the Gemini CLI agent configured for eighteen73 project guidelines and MCP servers).
License
The MIT License (MIT). Please see License File for more information.