Port Laravel Pennant

.github/workflows/redis.yml

@@ -61,6 +61,7 @@ jobs:
           vendor/bin/paratest --max-processes=15 tests/Integration/Horizon
           vendor/bin/paratest --max-processes=15 tests/Integration/Http/Redis
           vendor/bin/paratest --max-processes=15 tests/Integration/OpenTelemetry/Redis
+          vendor/bin/paratest --max-processes=15 tests/Integration/Pennant/Redis
           CACHE_STORE=redis vendor/bin/paratest --max-processes=15 tests/Permission
           QUEUE_CONNECTION=redis vendor/bin/paratest --max-processes=15 tests/Integration/Queue
           vendor/bin/paratest --max-processes=15 tests/Integration/RateLimiter/Redis
@@ -209,6 +210,7 @@ jobs:
           vendor/bin/phpunit --no-progress tests/Integration/Horizon
           vendor/bin/phpunit --no-progress tests/Integration/Http/Redis
           vendor/bin/phpunit --no-progress tests/Integration/OpenTelemetry/Redis
+          vendor/bin/phpunit --no-progress tests/Integration/Pennant/Redis
           QUEUE_CONNECTION=redis vendor/bin/phpunit --no-progress tests/Integration/Queue
           vendor/bin/phpunit --no-progress tests/Integration/RateLimiter/Redis
           vendor/bin/phpunit --no-progress tests/Integration/Session/Redis
@@ -279,6 +281,7 @@ jobs:
           vendor/bin/paratest --max-processes=15 tests/Integration/Horizon
           vendor/bin/paratest --max-processes=15 tests/Integration/Http/Redis
           vendor/bin/paratest --max-processes=15 tests/Integration/OpenTelemetry/Redis
+          vendor/bin/paratest --max-processes=15 tests/Integration/Pennant/Redis
           QUEUE_CONNECTION=redis vendor/bin/paratest --max-processes=15 tests/Integration/Queue
           vendor/bin/paratest --max-processes=15 tests/Integration/RateLimiter/Redis
           vendor/bin/paratest --max-processes=15 tests/Integration/Redis

AGENTS.md

@@ -202,7 +202,7 @@ Build complete, long-term solutions, not MVPs or local workarounds. A broad chan
 - **Prefer union types over `mixed` when all types are known** — `mixed` is only for truly unconstrained values or cases that cannot be safely narrowed after control-flow analysis.
 - **Type decisions must be evidence-based** — check corresponding Laravel/Hyperf signatures and docblocks as a reference, then trace the real control flow through method bodies across all callers and callees to confirm the types are correct.
 - **Fail fast with framework and PHP exceptions** — don't add guards, wrapping, or defensive checks unless they handle a reachable invalid case or materially improve the error, and never swallow exceptions. If code would fail anyway (e.g. null passed to a typed parameter), let it fail naturally instead of adding a check that throws a custom exception — the stack trace is enough to diagnose.
-- **Use semantic column types in migrations** — `jsonb()` over `json()`, `uuid()` / `foreignUuid()` / `uuidMorphs()` over strings for UUIDs, `ipAddress()` and `macAddress()` over `string()`. PostgreSQL gets the real types (`jsonb`, `uuid`, `inet`, `macaddr`); the other supported databases fall back automatically to compatible types.
+- **Use semantic column types in migrations** — `uuid()` / `foreignUuid()` / `uuidMorphs()` for UUIDs, `ipAddress()` / `macAddress()` for network addresses, and `jsonb()` for JSON the database queries, indexes or validates. Use `text()` for opaque serialized values that are only read back whole. PostgreSQL gets the real types (`jsonb`, `uuid`, `inet`, `macaddr`); the other supported databases fall back automatically to compatible types.
 - **No arbitrary string lengths** — use `->string('name')`, not `->string('name', 100)`. Don't invent limits; specify a length only when the domain or protocol defines one — exact (UUID: 36, ULID: 26, sha-256 hex token: 64) or a defined maximum (IPv6 address: 45).
 - **No database enums** — use string columns plus PHP enums. Adding a value to a database enum requires a migration.
 - **Use `dateTime` for arbitrary dates** — use `dateTime` instead of `timestamp` for scheduled dates, expiry dates, historical dates, and similar arbitrary dates. Keep `timestamp` for dates recorded when an action happens, such as `created_at`, `updated_at`, and `deleted_at`. On MySQL and MariaDB, `timestamp` only supports 1970–2038.

composer.json

@@ -195,6 +195,7 @@
         "hypervel/pagination": "self.version",
         "hypervel/passkeys": "self.version",
         "hypervel/passport": "self.version",
+        "hypervel/pennant": "self.version",
         "hypervel/permission": "self.version",
         "hypervel/pipeline": "self.version",
         "hypervel/process": "self.version",
@@ -286,6 +287,7 @@
             "Hypervel\\Passkeys\\": "src/passkeys/src/",
             "Hypervel\\Passport\\": "src/passport/src/",
             "Hypervel\\Passport\\Database\\Factories\\": "src/passport/database/factories/",
+            "Hypervel\\Pennant\\": "src/pennant/src/",
             "Hypervel\\Permission\\": "src/permission/src/",
             "Hypervel\\Pipeline\\": "src/pipeline/src/",
             "Hypervel\\Process\\": "src/process/src/",
@@ -336,6 +338,8 @@
             "src/log/src/functions.php",
             "src/prompts/src/helpers.php",
             "src/reflection/src/helpers.php",
+            "src/pennant/src/helpers.php",
+            "src/pennant/src/functions.php",
             "src/permission/src/helpers.php",
             "src/collections/src/functions.php",
             "src/collections/src/helpers.php",
@@ -373,6 +377,7 @@
         },
         "hypervel": {
             "aliases": {
+                "Feature": "Hypervel\\Pennant\\Feature",
                 "Mcp": "Hypervel\\Mcp\\Facades\\Mcp",
                 "OpenTelemetry": "Hypervel\\OpenTelemetry\\Facades\\OpenTelemetry",
                 "Saloon": "Hypervel\\Saloon\\Facades\\Saloon",
@@ -415,6 +420,7 @@
                 "Hypervel\\Fortify\\FortifyServiceProvider",
                 "Hypervel\\Grpc\\GrpcServiceProvider",
                 "Hypervel\\Passport\\PassportServiceProvider",
+                "Hypervel\\Pennant\\PennantServiceProvider",
                 "Hypervel\\Permission\\PermissionServiceProvider",
                 "Hypervel\\Pipeline\\PipelineServiceProvider",
                 "Hypervel\\Queue\\QueueServiceProvider",