Download the PHP package lucasp1337/laravel-loom without Composer

# Laravel Loom *Architecture as data.* Loom statically analyzes a Laravel app's event-driven primitives and writes a deterministic JSON file: every event, listener, observer, job, schedule, mailable, notification, and dispatch site, each with its file path and line number. It reads source with `nikic/php-parser` — no app boot, no runtime tracing, no `vendor/` required — so it sees what's actually in your code, not just what Laravel happened to register at boot. ## Usage Add `storage/loom/index.json` to `.gitignore` if you don't want to commit it. ## What it finds Click any item to see what gets picked up.

Events — app/Events/**, plus any class dispatched via event() / Event::dispatch()

Listeners — auto-discovery, $listen arrays, Event::listen(), and subscribers

Closure listeners — closures registered as listeners, in their own section

Observers — Model::observe(), #[ObservedBy], and eloquent.* model events

Jobs — app/Jobs/**, plus any class dispatched via dispatch() / X::dispatch(), with queue config

Statically-resolvable dispatch-time modifiers — `->onQueue()`, `->onConnection()`, `->delay()` (integer seconds), `->locale()`, `->mailer()`, `->afterCommit()` — are recorded as an optional `overrides` object on the dispatch site. `queue_config` still reflects class-default declarations; `overrides` records what the call site changed.

Schedule — Kernel::schedule(), bootstrap/app.php, and Schedule::* chains, normalized to cron

Mailables — app/Mail/**, plus Mail::send() and Mail::to()->send() chains, with queue config

Notifications — app/Notifications/**, plus notify() / Notification::send(), with channels

A literal channel-filter argument on `Notification::send()` / `Notification::sendNow()` — an array of string channel names and/or `Class::class` channel constants — is recorded as an optional `channels` array on the `notified_from` dispatch site, using the same value shape as `via()`. It's captured only on the facade form (the `->notify(...)` method form has no channel-filter argument) and omitted when the argument is absent, empty, or non-literal.

Dispatches — every handler body, cross-linked back to the listener, observer, or job it runs in

Dynamic calls Loom can't resolve statically (`event($var)`, container lookups) land in `unresolved_dispatches[]` with a reason and a `file:line` rather than being dropped silently. Per-scanner behavior and limitations live in [docs/scanners/](docs/scanners/). ## Sample output

Click to expand a representative scan against a small Laravel 13 app

The JSON shape is defined by `schema/loom-index.schema.json` and validated on every scan. ## Consuming the index (PHP API) `loom:show` is for humans; for programs, load a written index into typed objects with `IndexLoader`. The getters and lookups on `Index` return read-model value objects from `Lucasp\Loom\Index\Model\` — no raw-array digging. This is the supported surface for tools that consume an index. See [docs/index-api.md](docs/index-api.md) for the full loader, getters, lookups, and value-object reference. ## GitHub Action A composite action gates pull requests on Loom: it scans the branch, checks the index against policy, diffs it against the base ref, and posts a sticky PR comment. The action runs inside your Laravel app (the repo that has laravel-loom installed). Inputs, outputs, and the baseline trade-off are in [docs/github-action.md](docs/github-action.md). ## MCP server `loom:mcp` starts a local, read-only [MCP](https://modelcontextprotocol.io) server over the index, so an AI agent can query your event graph instead of grepping source. It runs embedded — `laravel/mcp` auto-discovers it, nothing to wire up. It exposes eleven tools — lookups (`list-entities`, `get-entity`), edges (`handlers-for`, `dispatch-sites-for`, `dispatches-from`), chains (`events-following`, `route-to-events`), and analysis (`impact-of-change`, `find-orphans`). Point any stdio MCP client at `php artisan loom:mcp` with your project as the working directory. The full tool reference and client config are in [docs/mcp.md](docs/mcp.md). ## Requirements - PHP **8.3+** - Laravel **11, 12, or 13** ## Local development Running the package needs only PHP 8.3+, but the test suite needs `ext-mbstring`, `ext-xml`, `ext-dom`, and `ext-xmlwriter`. A `Dockerfile` and `Justfile` are provided so you can run the full toolchain without those extensions on your host: See [docs/contributing.md](docs/contributing.md) for the full list of recipes. A benchmark suite (`composer bench`) measures scan cost across generated tiny/medium/large apps and gates CI on deterministic counts — see [benchmarks/README.md](benchmarks/README.md). ## Documentation - [Architecture](docs/architecture.md) — pipeline, scanner contract, cross-link pass - [Schema](docs/schema.md) — JSON schema reference - [Index PHP API](docs/index-api.md) — load an index into typed objects (`IndexLoader`, getters, value objects) - [GitHub Action](docs/github-action.md) — the composite action that gates PRs on Loom - [MCP server](docs/mcp.md) — the embedded `loom:mcp` server and its eleven tools for AI agents - [Scanners](docs/scanners/) — per-scanner behavior, edge cases, known limitations - [Contributing](docs/contributing.md) — toolchain, Docker workflow, how to add a scanner ## License The MIT License (MIT). See [LICENSE.md](LICENSE.md).