chore(main): release 2.0.0 (#24)

* chore(main): release 2.0.0

* Update CHANGELOG for version 2.0.0 release

Document major release changes and new features in v2.0.0.

Author: github-actions[bot]

CHANGELOG.md

@@ -1,5 +1,85 @@
 # Changelog
 
+## [2.0.0](https://github.com/offload-project/laravel-mandate/compare/v1.4.0...v2.0.0) (2026-01-09)
+
+
+This release is a major rewrite of Laravel Mandate with significant new features and architectural improvements.
+
+### Features
+
+#### Code-First Definitions
+* Define permissions, roles, and capabilities as PHP classes with attributes
+* Auto-discovery and synchronization to the database via `mandate:sync`
+* IDE autocompletion and type safety for authorization checks
+* Support for labels, descriptions, guards, and feature associations via attributes
+
+#### Context-Scoped Authorization (Multi-Tenancy)
+* Scope roles and permissions to a polymorphic context model (Team, Organization, etc.)
+* Global fallback option to check unscoped permissions when context check fails
+* Full multi-tenancy support for complex authorization scenarios
+
+#### Capabilities System
+* Semantic groupings of permissions for logical organization
+* Capabilities can be assigned to roles or directly to subjects
+* Hierarchical permission bundling for cleaner role management
+
+#### Feature Integration
+* Integration with Laravel Pennant or Hoist for feature flag gating
+* Tie permissions to feature flags for conditional access
+* Configurable behavior when feature handler is missing (allow/deny/throw)
+
+#### Audit Logging
+* Pluggable `AuditLogger` contract for custom audit implementations
+* Log permission grants, revokes, role assignments, and access denials
+* Optional logging of all permission/role checks for compliance
+* Default logger using Laravel's logging system
+
+#### New Commands
+* `mandate:health` - Check configuration and database health with `--fix` option
+* `mandate:sync` - Synchronize code-first definitions to database
+* `mandate:typescript` - Generate TypeScript constants for frontend
+* `mandate:upgrade-from-spatie` - Migrate from Spatie Laravel Permission
+* `mandate:make:permission` - Scaffold a new permission class
+* `mandate:make:role` - Scaffold a new role class
+* `mandate:make:capability` - Scaffold a new capability class
+* `mandate:make:feature` - Scaffold a new feature class (requires feature generator)
+
+#### Authorizable Contract
+* Type-safe interface for models using Mandate authorization
+* Better IDE support and method documentation
+* Standardized authorization method signatures
+
+#### Model ID Types
+* Support for `int`, `uuid`, or `ulid` primary keys
+* Configurable via `model_id_type` config option
+
+#### Fluent Authorization API
+* Semantic method names: `grantPermission()`, `revokePermission()`, `assignRole()`, `removeRole()`
+* Context parameter support on all authorization methods
+* Feature bypass option for internal checks
+
+#### Consolidated Migrations
+* Simplified migration structure with two main migration files
+* Optional label/description columns migration
+* Cleaner upgrade path for existing installations
+
+### Breaking Changes
+
+* PHP 8.4+ required
+* Laravel 11+ required
+* Spatie Laravel Permission dependency removed - now fully standalone
+* Migration structure has changed - see UPGRADE.md for migration instructions
+* Some method signatures have changed to support context parameter
+* Configuration file structure updated with new sections
+
+### Migration from v1.x
+
+See [UPGRADE.md](UPGRADE.md) for detailed migration instructions including:
+- Database migration updates
+- Configuration file changes
+- Code changes for new method signatures
+
+
 ## [1.4.0](https://github.com/offload-project/laravel-mandate/compare/v1.3.0...v1.4.0) (2026-01-03)