docs: refresh per-package AGENTS.md + di-explainer to current binders

Six per-package AGENTS.md tables and the di-explainer wiring trace all
showed pre-ADR-014 binder shapes. Refreshed to the post-ADR-015
reality:

- Per-package "Public exports" tables now show the
  (config, tracer, logger, bus, queue) production signature and the
  (tracer, logger, bus, queue) dev-seed companion. auth and
  marketing-pages also list their newly-public ./di/container,
  ./di/symbols, and (marketing-pages only) ./services/mailer +
  ./services/recording-mailer subpaths.
- di-explainer's wiring trace adds the resolveEventsAndJobs* step in
  bindAll(), the (config, tracer, logger, bus, queue) binder
  signature, and the // <gen:event-handlers> / // <gen:jobs>
  injection sites.

No code change; pre-existing AGENTS.md staleness predates ADR-014 +
ADR-015 — this commit catches both up.
This commit is contained in:
2026-05-08 17:51:35 +02:00
parent 9e8ff6411c
commit 5a2234f7ad
6 changed files with 21 additions and 7 deletions

View File

@@ -29,7 +29,12 @@ Pages collection + SiteSettings global for site-wide metadata. Provides marketin
| `./ui` | `pageBySlugQuery`, `siteSettingsQuery` — React Query option builders |
| `./api` | `marketingPagesRouter` (tRPC router) |
| `./cms` | Payload Pages collection + SiteSettings global |
| `./di/bind-production` | `bindProductionMarketingPages(container, config)` |
| `./di/bind-production` | `bindProductionMarketingPages(config, tracer, logger, bus, queue)` — swaps mock impls for real Payload-backed ones at app boot |
| `./di/bind-dev-seed` | `bindDevSeedMarketingPages(tracer, logger, bus, queue)` — replaces the default empty mocks with populated ones for dev / Storybook |
| `./di/container` | `marketingPagesContainer` — the per-feature inversify container (consumed by e2e tests + production Payload event-tasks) |
| `./di/symbols` | `MARKETING_PAGES_SYMBOLS` — DI symbol registry (consumed by e2e tests + production Payload event-tasks) |
| `./services/mailer` | `IMailerService` — interface for the welcome-email seam (ADR-015 proof-of-life) |
| `./services/recording-mailer` | `RecordingMailerService` — test / dev-seed mailer that records calls instead of sending |
## Use-case + controller patterns