Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Original file line number Diff line number Diff line change
Expand Up @@ -133,7 +133,7 @@ enum AuthError { GuardMismatch{ expected:String, actual:String }, BadCredentials
> **As-built note (2026-11-18):** the Status column was checked against the source tree on this date; the Component and Description columns are the original plan and are unchanged. `Done` means every element named in the row exists in reachable non-test code (for a Tests row: a test exists for each named case). Tests were read, not run. Live status: `docs/milestones.md`.
>
> Open items:
> - `F-M3-AUTH-01` — `login`, `parse`, and `refresh` are real over `jsonwebtoken` HS256 + Argon2; `logout` is a no-op with no revocation or deny-list (`crates/rustasea-auth/src/jwt.rs:270`), and `refresh` does not invalidate the old token. The runnable app wires only `SessionGuard`.
> - `F-M3-AUTH-01` — `login`, `parse`, and `refresh` are real over `jsonwebtoken` HS256 + Argon2; `logout` is a no-op with no revocation or deny-list (`crates/rustasea-auth/src/jwt.rs:267`), and `refresh` does not invalidate the old token. The runnable app wires only `SessionGuard`.

## 10. Cross-References
- API: [api-auth](../../api/identity-access/api-auth.md)
Expand Down
6 changes: 3 additions & 3 deletions docs/laravel-parity.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
# RustaSea × Laravel 13.x — API-Surface Parity Map

> **Last updated:** 2026-11-18
> **Last updated:** 2026-11-19
> **Scope:** Maps the Laravel 13.x **API surface** (namespaces, contracts/interfaces, traits, notable classes) to RustaSea crates/modules, with an adoption status per row.
> **Companion docs:** [`docs/laravel-13-research.md`](laravel-13-research.md) (feature-level research) · [`docs/milestones.md`](milestones.md) (M0–M6 implementation status).

Expand Down Expand Up @@ -71,7 +71,7 @@ It is the API-surface parity layer. It is intentionally **not** a 1:1 inventory
| `Illuminate\Bus` | `rustasea-queue` (`BatchHandle`, `BatchId`) | **Partial** | Batch handles plus a durable `DatabaseBatchRepository` over the `job_batches` table (`crates/rustasea-queue/src/batch_db.rs:77`). |
| `lorisleiva/laravel-actions` | `rustasea-action` (`Action`, `ActionController`, `ActionJob`, `ActionCommand`, `ActionListener`) | **Partial** | One action unit invoked from HTTP/queue/CLI/events with validate/authorize hooks; `make:action` generator; scaffold auth actions demonstrate the pattern (ADOPT-028). |
| `Laravel\Horizon` | `rustasea-queue-dashboard` (`DashboardConfig`, `sampler`, `QueueMetricsHistory`) | **Partial** | Queue dashboard (`/queue`): live depth/age, `queue_metrics` history + retention, failed-job retry/forget, worker heartbeats; feature `queue-dashboard` (ADOPT-021). No supervisor/balancing/auto-scaling yet. |
| `Illuminate\Auth` | `rustasea-auth` (`AuthManager`, `Guard`, `JwtGuard`, `SessionGuard`) | **Partial** | JWT/CSRF/throttle real; session guard real over `tower-sessions` (`crates/rustasea-auth/src/session.rs:99`) with an in-memory default store and a database store (`crates/rustasea-auth/src/session/database.rs:74`); users resolve through the database-backed `DatabaseUserProvider` (`crates/rustasea-auth/src/users/provider/database.rs:49`), which the runnable app installs at boot when the `users` table exists (`crates/rustasea-app/src/bootstrap/auth.rs:320`). |
| `Illuminate\Auth` | `rustasea-auth` (`AuthManager`, `Guard`, `JwtGuard`, `SessionGuard`) | **Partial** | JWT/CSRF/throttle real; session guard real over `tower-sessions` (`crates/rustasea-auth/src/session.rs:99`) with an in-memory default store and a database store (`crates/rustasea-auth/src/session/database.rs:74`); users resolve through the database-backed `DatabaseUserProvider` (`crates/rustasea-auth/src/users/provider/database.rs:49`), which the runnable app installs at boot when the `users` table exists (`crates/rustasea-app/src/bootstrap/auth.rs:333`). |
| `Illuminate\Auth\Access` | `rustasea-router` (`AuthorizeRegistry`, `AuthorizeResource`, `#[authorize]` metadata) | **Adopted** | `#[authorize]` metadata is resolved and enforced at dispatch: `Router::authorize_meta` consumes the macro-emitted tuple (`crates/rustasea-router/src/authorize.rs:216`), and `apply_authorize` wraps the route in a fail-closed authorization layer (`crates/rustasea-router/src/dispatch.rs:135`). |
| `Illuminate\Validation` | `rustasea-validation` (`Validatable`, `Rules`, `ErrorBag`, `FormRequest`) | **Partial** | Rules + ErrorBag + form requests real; DB presence verifier absent. |
| `Illuminate\Hashing` | `rustasea-auth` (`PasswordVerifier`, `Argon2Verifier`) | **Partial** | Argon2 verifier real; no hasher manager / rehash policy. |
Expand All @@ -97,7 +97,7 @@ It is the API-surface parity layer. It is intentionally **not** a 1:1 inventory
| `pestphp/pest-plugin-browser` | `rustasea-testing` (`Browser`, `ServerHandle`, `BrowserError`) | **Partial** | Feature-gated WebDriver harness (feature `browser`, `fantoccini`) with Dusk-style `visit`/`fill`/`click`/`select`/`check`/`press`/`wait_for`/`assert_see` helpers, an ephemeral axum `ServerHandle`, and failure screenshots. Auto-skips when `WEBDRIVER_URL` is unreachable rather than failing the default run; `make:test --browser` scaffolds a test (ADOPT-029). No DevTools protocol, parallel browser pool, or Vite integration. |
| `Illuminate\Image` | rustasea-image (Image, ImageBuilder, ImageTransformJob) | Partial | Fluent pipeline (resize/fit/cover/thumbnail/crop/rotate/watermark text+image), EXIF auto-orient, jpeg/png/webp/gif/bmp/tiff encode, storage round-trip + queued transforms (ADOPT-024). No GD/Imagick drivers or animated webp/gif transforms. |
| `Illuminate\JsonSchema` | — | **Planned** | No JSON-schema contract. |
| AI SDK (`laravel/ai`, separate package) | `rustasea-ai` (`AiProvider`, `Agent`, `Tool`) | **Partial** | Provider-agnostic traits real; the agent runtime echoes the prompt and never calls a provider (`crates/rustasea-ai/src/agent.rs:247`); real HTTP-backed OpenAI-style and Anthropic adapters plus a deterministic in-process provider kept for tests (feature `ai`; `crates/rustasea-ai/src/providers/mod.rs:27`, `adapters.rs:50`). Gemini and Bedrock are served through their OpenAI-compatible endpoints (`crates/rustasea-ai/src/providers/client.rs:225`, `:376`); the provider-native APIs are not implemented. Provider-backed embeddings send a dedicated embedding model (`crates/rustasea-ai/src/embed.rs:18`, `providers/client.rs:246`); the engine-agnostic `rustasea-search::Str` keeps a deterministic stub fallback (`crates/rustasea-search/src/embeddings.rs:97`). |
| AI SDK (`laravel/ai`, separate package) | `rustasea-ai` (`AiProvider`, `Agent`, `Tool`) | **Partial** | Provider-agnostic traits real; the agent runtime echoes the prompt and never calls a provider (`crates/rustasea-ai/src/agent.rs:247`); real HTTP-backed OpenAI-style and Anthropic adapters plus a deterministic in-process provider kept for tests (feature `ai`; `crates/rustasea-ai/src/providers/mod.rs:27`, `adapters.rs:50`). Gemini and Bedrock are served through their OpenAI-compatible endpoints (`crates/rustasea-ai/src/providers/client.rs:225`, `:382`); the provider-native APIs are not implemented. Provider-backed embeddings send a dedicated embedding model (`crates/rustasea-ai/src/embed.rs:18`, `providers/client.rs:246`), and Bedrock requires `BEDROCK_EMBEDDING_MODEL`; the engine-agnostic `rustasea-search::Str` keeps a deterministic stub fallback (`crates/rustasea-search/src/embeddings.rs:97`). |
| `spatie/laravel-permission` | `rustasea-auth::rbac` (`Role`, `RbacRegistry`, `HasRoles`, `PermissionResolver`) | **Adopted** | Role/permission assignment with cached permission lookups and a `PermissionResolver` the ability `Gate` consults after its defined abilities (ADOPT-001; `crates/rustasea-auth/src/rbac/{mod,role,registry,has_roles}.rs`). |
| `spatie/laravel-activitylog` | `rustasea-activitylog` (`ActivityLogger`, `ActivityEvent`) | **Adopted** | Model-change audit trail with JSON property diffs and an optional `batch_uuid`, built on the ORM `#[logs_activity]` seam and persisted to the `audit_log` table (ADOPT-002; `crates/rustasea-activitylog/src/{lib,recorder,model}.rs`). |
| `rappasoft/laravel-authentication-log` | `rustasea-authlog` (`AuthenticationLogLogger`, `NewDeviceNotifier`) | **Adopted** | One row per login/failed/lockout/logout with client IP and `User-Agent`; an unknown-IP login triggers a queued new-device notification (ADOPT-003; `crates/rustasea-authlog/src/{lib,recorder,notifier}.rs`). |
Expand Down
Loading
Loading