Permissions Laravel Package

Changed

• Dependencies: Allow spatie/laravel-permission v8 (^7.0|^8.0). Composer resolves v7 on PHP 8.2 / Laravel 11 and v8 on PHP 8.3+ / Laravel 12-13; no code changes required.
• Dev: Test against Laravel 13 via Orchestra Testbench 11 (orchestra/testbench: ^9.0|^10.0|^11.0).

Added

• Docs: AI assistant documentation (docs/ai-assistants/) with universal guide, cursor rules, and usage examples.
• Skills: Added bt-permissions-component Claude Code skill header for the beartropy:skills installer command.

Added

• Livewire 4 support (^3.7|^4.0) with full backward compatibility for Livewire 3
• Route::livewire() routing for Livewire 4, with Route::get() fallback for Livewire 3
• Missing component resolver for Livewire 4's :: namespace separator handling

Changed

• Widened dev dependency constraints for Pest 4, Testbench 10, and Livewire 4

Changed

• Added spatie/laravel-permission v7 support (^6.0|^7.0)

What's New

Authorization System

• Configurable gate authorization on all mutations (gate config key)
• AuthorizesPermissionsAccess trait shared across all components

Bug Fixes

• Fixed hardcoded Spanish fallback with translatable string
• Fixed falsy guard checks (strict === null)
• Spatie permission cache cleared on all delete operations
• N+1 queries eliminated with withCount() on all tables
• Fixed config key names and PHP version in docs

Performance

• Replaced eager loading with aggregate counts on all three tables
• Added #[Computed] caching on filteredPermissions

Code Quality

• Extracted ManagesEntity trait for shared modal logic
• Unique validation scoped to guard for roles/permissions
• Tab input validation, try/catch on sync operations

Test Suite

• 120 tests, 219 assertions (Pest + Livewire + Orchestra Testbench)
• Full coverage: modals, tables, routes, service provider, config

AI Integration

• MCP tools: bt-permissions-component-docs, bt-permissions-list-components, bt-permissions-project-context
• Skills: bt-permissions-setup, bt-permissions-docs-maintenance
• Component documentation for all 8 Livewire components
• Integrity tests for docs/MCP data consistency

Full Changelog: https://github.com/beartropy/permissions/compare/v0.1.2...v0.2.0