@beignet/cli 0.0.37 → 0.0.39

package/CHANGELOG.md

@@ -1,5 +1,31 @@
 # @beignet/cli
 
+## 0.0.39
+
+### Patch Changes
+
+- aaa4c7a: Generate connected React upload clients, components, and tests with `make upload --ui`.
+- aeb844f: Standardize CLI provider commands, feature artifact names, and app-scoped options, and include provider preset changes in create dry-run plans.
+- 2009e12: Generate contract-backed React Hook Form components from the feature UI addon, including validation errors, mutation errors, reset, invalidation, client setup, and dependencies.
+  - @beignet/core@0.0.39
+
+## 0.0.38
+
+### Patch Changes
+
+- 1081ac6: Harden HTTP response handling, synchronous upload cleanup, CLI path and registry diagnostics, provider context preservation, Redis subscription observability, and provider documentation.
+- d23b0b3: Continue versioned W3C trace context through outbox, event bus, BullMQ, and
+  Inngest boundaries without making telemetry metadata part of delivery success.
+- 6bd52fc: Rename the canonical runtime port wiring file, value, and CLI config path to `infra/port-wiring.ts`, `initialPorts`, and `paths.portWiring`.
+- 7b918c4: Standardize bounded terminal-only runtime error reporting, structured Sentry metadata redaction, and isolated reporting across HTTP, jobs, schedules, tasks, listeners, and outbox drains.
+- Updated dependencies [443b9a1]
+- Updated dependencies [1081ac6]
+- Updated dependencies [d23b0b3]
+- Updated dependencies [6bd52fc]
+- Updated dependencies [7b918c4]
+- Updated dependencies [7e1a68e]
+  - @beignet/core@0.0.38
+
 ## 0.0.37
 
 ### Patch Changes

package/README.md

@@ -40,8 +40,8 @@ equivalent.
 
 Running create in an interactive terminal without selection flags opens a
 prompt-based setup that asks for the project directory, whether to scaffold
-an API-only app, which database to use, and which provider integrations to
-add. Passing any selection flag (`--api`, `--db`, `--integrations`, or
+an API-only app, which database to use, and which providers to
+add. Passing any selection flag (`--api`, `--db`, `--providers`, or
 `--package-manager`) skips the prompts, and `--yes` forces the
 non-interactive defaults (the full-stack SQLite starter with `bun`) even on a
 terminal. Non-interactive runs in scripts and CI behave exactly as before.
@@ -75,33 +75,32 @@ page and a reduced typed client.
 The starter ships local production-shaped defaults: Better Auth, Drizzle
 persistence, pino logging, UOW, durable idempotency, audit logging, no-op error
 reporting, and devtools. Add workflow artifacts and external service
-integrations only when you want those capabilities:
+providers only when you want those capabilities:
 
 ```bash
-bunx @beignet/cli create my-app --integrations inngest,resend
+bunx @beignet/cli create my-app --providers jobs-inngest,mail-resend
 ```
 
-Available integrations:
+Available starter-native providers:
 
-- `inngest` - Inngest-backed background jobs via `@beignet/provider-jobs-inngest`
-- `resend` - Resend-backed mail via `@beignet/provider-mail-resend`
-- `upstash-rate-limit` - Upstash-backed rate limiting via
+- `jobs-inngest` - Inngest-backed background jobs via `@beignet/provider-jobs-inngest`
+- `mail-resend` - Resend-backed mail via `@beignet/provider-mail-resend`
+- `rate-limit-upstash` - Upstash-backed rate limiting via
   `@beignet/provider-rate-limit-upstash`
 
-`--integrations` also accepts every `beignet providers add` preset
+`--providers` accepts every `beignet provider add` preset
 (`flags-openfeature`, `jobs-bullmq`, `jobs-inngest`, `mail-resend`,
-`mail-smtp`, `payments-stripe`, `redis-cache`, `event-bus-redis`,
-`redis-locks`, `s3-storage`, `search-meilisearch`, `sentry`, and
-`vercel-blob-storage`). Presets are
+`mail-smtp`, `payments-stripe`, `cache-redis`, `event-bus-redis`,
+`locks-redis`, `storage-s3`, `search-meilisearch`, `error-reporting-sentry`, and
+`storage-vercel-blob`). Presets are
 applied to the fresh scaffold with the same machinery as
-`beignet providers add`; preset names with a template equivalent
-(`jobs-inngest`, `mail-resend`, `upstash-rate-limit`) normalize to it, and
-selections that fill the same app port (for example `resend` plus
+`beignet provider add`; starter-native presets are rendered directly, and
+selections that fill the same app port (for example `mail-resend` plus
 `mail-smtp`) fail before any files are written.
 
-Each selected integration adds its provider package dependencies, wires the
+Each selected provider adds its package dependencies, wires the
 provider in `server/providers.ts`, extends `.env.example`, and writes setup
-notes to `docs/integrations.md`.
+notes to `docs/providers.md`.
 
 Drizzle persistence ships in every starter; pick the backend with `--db`
 (default `sqlite`):
@@ -138,6 +137,10 @@ bunx @beignet/cli create my-app --dry-run
 bunx @beignet/cli create my-app --dry-run --json
 ```
 
+When `--providers` includes post-create presets, the preview composes their
+dependency, wiring, environment, and setup-note changes into the final file
+list without creating the target directory.
+
 The CLI writes files only. After creation:
 
 ```bash
@@ -185,46 +188,46 @@ bun beignet doctor
 
 ```bash
 beignet create [directory] [options]
-beignet task run <name> [options]
-beignet outbox drain [options]
-beignet outbox list [options]
-beignet outbox show <id> [options]
-beignet outbox requeue <id> [options]
-beignet outbox purge [options]
-beignet outbox prune [options]
-beignet schedule run <name> [options]
-beignet make task <feature>/<name> [options]
-beignet make contract <name> [options]
-beignet make event <feature>/<name> [options]
-beignet make factory <feature>/<name> [options]
-beignet make feature <name> [options]
-beignet make job <feature>/<name> [options]
-beignet make notification <feature>/<name> [options]
-beignet make inbox [options]
-beignet make outbox [options]
-beignet make payments [options]
-beignet make tenancy [options]
-beignet make listener <feature>/<name> --event <feature>/<event> [options]
-beignet make schedule <feature>/<name> [options]
-beignet make upload <feature>/<name> [options]
-beignet make port <name> [options]
-beignet make policy <name> [options]
-beignet make adapter <name> [options]
-beignet make resource <name> [options]
-beignet make seed <feature>/<name> [options]
-beignet make test <feature>/<action> [options]
-beignet make use-case <feature>/<action> [options]
-beignet db generate [--dry-run] [--json]
-beignet db migrate [--dry-run] [--json]
-beignet db seed [--dry-run] [--json]
-beignet db reset [--dry-run] [--json]
-beignet db schema sync [--dialect sqlite|postgres|mysql] [--tables audit,idempotency,outbox] [--output <path>] [--dry-run] [--json]
+beignet task run <name> [options] [--cwd <dir>]
+beignet outbox drain [options] [--cwd <dir>]
+beignet outbox list [options] [--cwd <dir>]
+beignet outbox show <id> [options] [--cwd <dir>]
+beignet outbox requeue <id> [options] [--cwd <dir>]
+beignet outbox purge [options] [--cwd <dir>]
+beignet outbox prune [options] [--cwd <dir>]
+beignet schedule run <name> [options] [--cwd <dir>]
+beignet make task <feature.name> [options] [--cwd <dir>]
+beignet make contract <name> [options] [--cwd <dir>]
+beignet make event <feature.name> [options] [--cwd <dir>]
+beignet make factory <feature.name> [options] [--cwd <dir>]
+beignet make feature <name> [options] [--cwd <dir>]
+beignet make job <feature.name> [options] [--cwd <dir>]
+beignet make notification <feature.name> [options] [--cwd <dir>]
+beignet make inbox [options] [--cwd <dir>]
+beignet make outbox [options] [--cwd <dir>]
+beignet make payments [options] [--cwd <dir>]
+beignet make tenancy [options] [--cwd <dir>]
+beignet make listener <feature.name> --event <feature.event> [options] [--cwd <dir>]
+beignet make schedule <feature.name> [options] [--cwd <dir>]
+beignet make upload <feature.name> [--ui] [options] [--cwd <dir>]
+beignet make port <name> [options] [--cwd <dir>]
+beignet make policy <name> [options] [--cwd <dir>]
+beignet make adapter <name> [options] [--cwd <dir>]
+beignet make resource <name> [options] [--cwd <dir>]
+beignet make seed <feature.name> [options] [--cwd <dir>]
+beignet make test <feature.action> [options] [--cwd <dir>]
+beignet make use-case <feature.action> [options] [--cwd <dir>]
+beignet db generate [--dry-run] [--json] [--cwd <dir>]
+beignet db migrate [--dry-run] [--json] [--cwd <dir>]
+beignet db seed [--dry-run] [--json] [--cwd <dir>]
+beignet db reset [--dry-run] [--json] [--cwd <dir>]
+beignet db schema sync [--dialect sqlite|postgres|mysql] [--tables audit,idempotency,outbox] [--output <path>] [--dry-run] [--json] [--cwd <dir>]
 beignet routes [--json] [--cwd <dir>]
 beignet check [--json] [--fix] [--cwd <dir>]
 beignet lint [--json] [--cwd <dir>] [--format human|json|github]
 beignet doctor [--json] [--strict] [--fix] [--cwd <dir>] [--format human|json|github]
-beignet providers add <preset> [--dry-run] [--json] [--cwd <dir>]
-beignet providers audit [--json] [--cwd <dir>]
+beignet provider add <preset> [--dry-run] [--json] [--cwd <dir>]
+beignet provider audit [--json] [--cwd <dir>]
 beignet mcp
 beignet completion install [--shell bash|zsh] [--json]
 beignet completion uninstall [--shell bash|zsh] [--json]
@@ -235,37 +238,38 @@ Options:
   --api                       Scaffold an API-only app without the UI shell.
   --db postgres               Database backend: sqlite (default), postgres, or mysql.
   --package-manager bun       Package manager shown in next steps.
-  --integrations inngest,resend  Add integrations (inngest, resend, upstash-rate-limit) or any providers add preset. Accepts one value or a comma-separated list.
+  --providers jobs-inngest,mail-resend  Add provider presets. Accepts one value or a comma-separated list.
   --yes                       Skip interactive create prompts and use the defaults.
   --force                     Write into a non-empty directory.
   --dry-run                   Preview create/make writes without changing files.
   --json                      Print machine-readable output.
-  --cwd path/to/app           Run routes, check, lint, doctor, provider add, or provider audit against another app directory.
+  --cwd path/to/app           Run an existing-app command against another app directory.
   --format github             Output format for lint and doctor: human, json, or github.
   --input '{"dryRun":true}'   JSON input for `beignet task run`.
   --tenant acme               Tenant id or slug passed to the app's createTaskContext by `beignet task run`, separate from task input.
   --payload '{"date":"..."}'  JSON payload for `beignet schedule run`.
   --module server/tasks.ts    Override the task, outbox, or schedule registry path.
   --batch-size 100            Maximum outbox messages to claim in one drain pass.
-  --id run_123                Provider or app schedule run ID for schedule runs.
+  --run-id run_123            Provider or app schedule run ID for schedule runs.
   --scheduled-at 2026-01-01   Provider scheduled timestamp for schedule runs.
   --triggered-at 2026-01-01   Trigger timestamp for schedule runs.
   --attempt 1                 One-based provider attempt number for schedule runs.
   --source manual             Provider or app source label for schedule runs.
-  --with policy,events        Add optional artifacts to `make feature`; also supports factories, seeds, tasks, listeners, jobs, notifications, schedules, ui, uploads.
+  --with policy,event         Add optional artifacts to `make feature`; supports policy, factory, seed, task, event, listener, job, notification, schedule, ui, and upload.
   --recipe full-slice         Add the canonical full-slice feature recipe: policy, client UI, workflow artifacts, outbox-ready events/jobs, and listener registration.
   make tenancy                Add `features/workspaces` with membership-aware tenant resolution, workspace/member/invite routes, a demo seed, and workspace settings UI on shell apps.
   make payments               Add `features/billing` with free/pro plans, a `createPaymentWebhookRoute(...)` route, billing persistence, entitlement gating, a demo seed, and a plan settings UI on shell apps.
   make inbox                  Add `features/inbox` with a per-user notification inbox, an in-app notification channel, cursor-paginated routes, and an inbox page on shell apps.
-  --auth                      Add authorization metadata, policy wiring, policy tests, and use-case gate checks to `make resource`.
-  --tenant                    Add tenant-scoped schemas, `TenantScope` repository boundaries, and use-case tenant checks to `make resource`.
+  --authorization             Add authorization metadata, policy wiring, policy tests, and use-case gate checks to `make resource`.
+  --tenant-scoped             Add tenant-scoped schemas, `TenantScope` repository boundaries, and use-case tenant checks to `make resource`.
   --events                    Add created, updated, and deleted domain events to `make resource`.
   --soft-delete               Archive resource rows with deletedAt instead of hard-deleting them.
-  --event posts/published     Event for `make listener`.
+  --event posts.published     Event for `make listener`.
   --cron "0 9 * * *"          Cron expression for `make schedule`.
   --timezone America/Chicago  Timezone for `make schedule`.
   --route                     Add a Next.js cron route for `make schedule`.
-  providers add redis-cache   Add dependencies, provider wiring, env examples, and setup notes for a supported provider preset.
+  --ui                        Add a typed upload client, React uploader, and component test to `make upload`.
+  provider add cache-redis   Add dependencies, provider wiring, env examples, and setup notes for a supported provider preset.
   --strict                    Include CI-oriented doctor warnings and fail on warnings.
   --fix                       Apply low-risk doctor fixes before reporting.
   --shell zsh                 Shell for `completion install`/`uninstall`. Defaults to $SHELL.
@@ -323,7 +327,7 @@ shell or source the rc file to activate completions. Zsh completions require
 `compinit` to be loaded, which most zsh setups already do.
 
 Completions cover commands, subcommands, flags, and enum flag values such as
-`--template` and `--integrations`. The shell scripts call the
+`--template` and `--providers`. The shell scripts call the
 `beignet completion propose` helper, which prints one proposal per line for a
 partial command line; it exists for the shell integration and is safe to
 ignore otherwise. Completions complete whatever `beignet` resolves to on your
@@ -351,7 +355,7 @@ The standard app layout includes the files feature generators expect:
 
 ```txt
 app-context.ts
-infra/app-ports.ts
+infra/port-wiring.ts
 ports/index.ts
 lib/routes.ts
 lib/use-case.ts
@@ -380,6 +384,8 @@ export default defineConfig({
 		appContext: "src/app-context.ts",
 		contracts: "src/features",
 		features: "src/features",
+		ports: "src/ports/index.ts",
+		portWiring: "src/infra/port-wiring.ts",
 		routesBuilder: "src/lib/routes.ts",
 		routes: "src/app/api",
 		server: "src/core/server/index.ts",
@@ -427,12 +433,12 @@ option wherever the Drizzle setup statements and ports are created.
 Use `database.schemaSources` when operational table definitions live outside
 the app's canonical `infra/db/schema/`, `drizzle/`, or `infra/db/` files. Each
 entry can be an app-relative file or directory, an `@/` app path, or a package
-specifier such as `@acme/db/schema`. `doctor` and `providers audit` also
+specifier such as `@acme/db/schema`. `doctor` and `provider audit` also
 follow schema-like imports from app database files, but explicit schema
 sources make shared-package layouts predictable.
 
 Provider metadata describes the standard environment requirements checked by
-`doctor --strict` and `providers audit`. When an injected client gets its
+`doctor --strict` and `provider audit`. When an injected client gets its
 configuration from a platform binding, IAM, or another non-env mechanism,
 declare only the irrelevant static requirement as an explicit exception:
 
@@ -494,7 +500,7 @@ around the feature's real workflow.
 Add common feature-owned artifacts with `--with`:
 
 ```bash
-beignet make feature projects --with policy,events,jobs,notifications,ui,uploads
+beignet make feature projects --with policy,event,job,notification,ui,upload
 ```
 
 The optional artifacts use predictable starter names:
@@ -504,6 +510,9 @@ The optional artifacts use predictable starter names:
 - `features/projects/jobs/process.ts`
 - `features/projects/notifications/created.ts`
 - `features/projects/components/projects-panel.tsx`
+- `features/projects/attachment-upload-manifest.ts`
+- `features/projects/client/attachment-upload.ts`
+- `features/projects/components/attachment-uploader.tsx`
 - `features/projects/uploads/attachment.ts`
 
 Event, job, notification, and upload registries are created or updated in the
@@ -515,8 +524,12 @@ beignet make feature projects --with ui
 
 It writes a feature-colocated client helper at
 `features/projects/client/queries.ts` and a React component that consumes those
-query/mutation options through TanStack Query, with error messages from
-`contractErrorMessage` in `@beignet/core/client`.
+query/mutation options through TanStack Query. The component binds the create
+contract through `rhf(contract)`, reuses its body schema for field validation,
+maps server failures with `rootFormError(...)`, resets after success, and
+invalidates the generated list query. If the app does not have one yet, the
+generator also creates the canonical `client/forms.ts` adapter and installs the
+React Hook Form dependencies.
 
 Use the named full-slice recipe when you want a richer reference slice:
 
@@ -527,7 +540,8 @@ beignet make feature projects --recipe full-slice
 The recipe includes the standard contract, schema, use-case, port, route, test,
 repository, and wiring files, then adds policy, factories, seeds, tasks,
 events, listeners, jobs, notifications, schedules, UI client helpers,
-components, uploads, outbox wiring, and `outbox_messages` Drizzle schema. The
+components, an upload definition with a connected uploader, outbox wiring, and
+`outbox_messages` Drizzle schema. The
 generated create use case publishes the generated created event so the event
 artifact is connected, and the listener registry is registered in
 `server/listeners.ts` and wired from `server/providers.ts`. Replace the starter names, listener/job bodies,
@@ -541,10 +555,10 @@ Use `make use-case` inside a Beignet app when you want a focused
 application workflow without generating HTTP contracts or ports:
 
 ```bash
-beignet make use-case projects/archive-project
+beignet make use-case projects.archive-project
 ```
 
-The name uses `feature/action` format. The command writes
+The name uses `feature.action` format. The command writes
 `features/projects/use-cases/archive-project.ts` and creates or updates
 `features/projects/use-cases/index.ts`. Read-style actions that start with `get`, `list`,
 `find`, `search`, or `count` generate `.query(...)`; other actions generate
@@ -558,8 +572,8 @@ repository-oriented tests; `make test` is for adding coverage around an
 additional workflow that does not need a whole new resource slice.
 
 ```bash
-beignet make use-case projects/archive-project
-beignet make test projects/archive-project
+beignet make use-case projects.archive-project
+beignet make test projects.archive-project
 ```
 
 The command writes `features/projects/tests/archive-project.test.ts`, builds the
@@ -622,7 +636,7 @@ main concept is an entity with repository-backed persistence:
 
 ```bash
 beignet make resource projects
-beignet make resource projects --auth --tenant --events --soft-delete
+beignet make resource projects --authorization --tenant-scoped --events --soft-delete
 ```
 
 `make resource` generates a CRUD-shaped slice with list, create, get, update,
@@ -645,8 +659,8 @@ memory and Drizzle repositories include the version in the update check and
 increment it on success. Stale updates become the generated
 `<Resource>Conflict` catalog error.
 
-Use `--auth` to generate authorization metadata, policy wiring, and use-case
-`ctx.gate.authorize(...)` calls. Use `--tenant` to scope repository reads and
+Use `--authorization` to generate authorization metadata, policy wiring, and use-case
+`ctx.gate.authorize(...)` calls. Use `--tenant-scoped` to scope repository reads and
 writes with a branded `TenantScope`; generated use cases call
 `requireTenantScope(ctx)`, repository ports require `scope: TenantScope`, and
 adapters unwrap the storage key with `tenantScopeId(scope)`. `doctor --strict`
@@ -657,7 +671,7 @@ Use `--events` to generate created, updated, and deleted domain events and
 publish them through `ctx.ports.eventBus`. The
 starter ships no event bus, so `--events` also wires one: it adds
 `eventBus: EventBusPort` to `AppPorts`, defers the key in
-`infra/app-ports.ts`, registers `createMemoryEventBusProvider()` in
+`infra/port-wiring.ts`, registers `createMemoryEventBusProvider()` in
 `server/providers.ts`, and adds the `@beignet/provider-event-bus-memory`
 dependency. The wiring is skipped when the ports file already mentions
 `eventBus`, so apps that wired their own bus are left untouched. Use
@@ -674,16 +688,17 @@ In standard apps, the command also creates
 Use feature artifact generators when a workflow grows beyond a single use case:
 
 ```bash
-beignet make task posts/backfill-search
-beignet make event posts/published
-beignet make job posts/send-published-email
-beignet make notification posts/published
-beignet make listener posts/enqueue-published-email --event posts/published
-beignet make schedule posts/daily-summary --cron "0 9 * * *" --timezone America/Chicago --route
-beignet make upload posts/attachment
+beignet make task posts.backfill-search
+beignet make event posts.published
+beignet make job posts.send-published-email
+beignet make notification posts.published
+beignet make listener posts.enqueue-published-email --event posts.published
+beignet make schedule posts.daily-summary --cron "0 9 * * *" --timezone America/Chicago --route
+beignet make upload posts.attachment
+beignet make upload posts.attachment --ui
 ```
 
-These commands use `feature/name` format and write colocated feature files:
+These commands use `feature.name` format and write colocated feature files:
 
 - `features/posts/tasks/backfill-search.ts`
 - `features/posts/domain/events/published.ts`
@@ -693,6 +708,15 @@ These commands use `feature/name` format and write colocated feature files:
 - `features/posts/schedules/daily-summary.ts`
 - `features/posts/uploads/attachment.ts`
 
+Uploads always add a feature-root client-safe manifest so server constraints
+and browser input hints share one source of truth. In full-stack apps, `--ui`
+also writes `features/posts/client/attachment-upload.ts`,
+`features/posts/components/attachment-uploader.tsx`, and
+`features/posts/tests/attachment-uploader.test.tsx`, then installs
+`@beignet/react-uploads`. The component handles progress, cancellation,
+failures, reset, and completion. API-only apps reject `--ui` before writing;
+omit it to generate the backend upload workflow alone.
+
 Each command creates or updates the folder's `index.ts` with an exported
 registry such as `postTasks`, `postJobs`, `postNotifications`,
 `postListeners`, `postSchedules`, or `postUploads`. Task generators also
@@ -719,8 +743,8 @@ event` (and `make resource --events`) wires `eventBus: EventBusPort` with
 `createMemoryMailerProvider()` and `notifications: NotificationPort` with
 `createInlineNotificationsProvider()`, both dev-default providers from
 `@beignet/core`. Each port is wired independently — added to `AppPorts`,
-deferred in `infra/app-ports.ts`, and registered in `server/providers.ts` —
-and skipped when the ports file already has the key, so integrations such as
+deferred in `infra/port-wiring.ts`, and registered in `server/providers.ts` —
+and skipped when the ports file already has the key, so providers such as
 resend (which contributes `mailer`) and app-owned adapters are left
 untouched. Swap the dev-default provider for a production adapter without
 rerunning the generator; the port stays the same.
@@ -748,7 +772,9 @@ Event generators use `@beignet/core/events` directly and upload generators use
 route under `app/api/cron/<feature>/<name>/route.ts`. Generated cron routes
 require `CRON_SECRET` and record schedule start, completion, and failure events
 in devtools. Generated uploads include starter metadata, constraints,
-authorization, storage key, storage metadata, and completion hooks.
+authorization, storage key, storage metadata, and completion hooks. Use
+`make upload <feature.name> --ui` in a full-stack app to add the connected
+React client and uploader.
 
 Use `beignet outbox drain` when you need to drain durable events and jobs from
 an app-owned CLI, CI, or worker entrypoint:
@@ -802,7 +828,7 @@ queue consumers, or interval polling from provider lifecycle hooks in serverless
 apps.
 
 `make listener` expects the event file to exist at the canonical generated path.
-Run `make event <feature>/<event>` first, then generate listeners for that event.
+Run `make event <feature.event>` first, then generate listeners for that event.
 
 `make feature` and `make resource` are idempotent for unchanged generated files:
 repeated runs skip identical files and avoid duplicate wiring. If a generated
@@ -849,8 +875,8 @@ for MySQL.
 Generate feature-owned test factories and local/demo seeds with:
 
 ```bash
-beignet make factory posts/post
-beignet make seed posts/demo-posts
+beignet make factory posts.post
+beignet make seed posts.demo-posts
 ```
 
 Factories are written under `features/posts/tests/factories/` and persist
@@ -934,6 +960,12 @@ paths, and `--json` emits machine-readable output with `schemaVersion: 1`.
 Run it in the deploy pipeline where production configuration is present; it
 exits `1` on any error finding.
 
+`beignet task run`, `beignet schedule run`, and `beignet outbox drain` use an
+optional `ctx.ports.errorReporter` from their app-owned context. They report
+terminal command failures, dead letters, and settlement failures, then perform
+a bounded flush before stopping context. Retryable outbox deliveries remain
+instrumentation/log events rather than incident reports.
+
 ## Lint app architecture
 
 Run `lint` when you want the CLI to enforce Beignet dependency direction:
@@ -951,6 +983,11 @@ feature-specific domain files importing another feature's domain unless the
 target is `features/shared/domain`. Workflow folders include feature-owned
 jobs, listeners, notifications, schedules, and uploads.
 
+Local `@/` imports are resolved through the app's `tsconfig.json` path mapping,
+including `@/* -> ./src/*` layouts, before dependency direction is classified.
+The CLI uses TypeScript's config parser, so JSON comments and extended
+tsconfigs follow the same rules as the compiler.
+
 Import diagnostics include 1-based `line` and `column` positions. Human
 output prints clickable `file.ts:12:3` locations; runtime-boundary
 diagnostics report the chain root file and the full import chain in the
@@ -1056,20 +1093,20 @@ metadata in installed package manifests. The CLI does not import provider
 implementation modules to discover those facts, and it reports malformed
 metadata before using provider-derived doctor rules.
 
-Use `beignet providers add <preset>` to wire a stable provider recipe after
+Use `beignet provider add <preset>` to wire a stable provider recipe after
 app creation. It updates `package.json`, `server/providers.ts`, app port
-types, deferred port wiring, `.env.example`, and `docs/integrations.md`.
+types, deferred port wiring, `.env.example`, and `docs/providers.md`.
 Supported presets are `flags-openfeature`, `jobs-bullmq`, `jobs-inngest`,
-`mail-resend`, `mail-smtp`, `payments-stripe`, `search-meilisearch`, `sentry`,
-`upstash-rate-limit`, `redis-cache`, `event-bus-redis`, `redis-locks`,
-`s3-storage`, and `vercel-blob-storage`; pass `--dry-run --json` to preview
+`mail-resend`, `mail-smtp`, `payments-stripe`, `search-meilisearch`, `error-reporting-sentry`,
+`rate-limit-upstash`, `cache-redis`, `event-bus-redis`, `locks-redis`,
+`storage-s3`, and `storage-vercel-blob`; pass `--dry-run --json` to preview
 the exact file changes. The same presets can be selected at create time with
-`--integrations`.
+`--providers`.
 
-Use `beignet providers audit` when you want a report-only inventory of the
+Use `beignet provider audit` when you want a report-only inventory of the
 provider packages installed in an app. The human audit prints provider
 metadata validity, registration status, required env, required tables, and
-declared app ports. `beignet providers audit --json` returns a versioned
+declared app ports. `beignet provider audit --json` returns a versioned
 `schemaVersion: 1` payload with active variants and watchers for scripts and
 coding agents. The command does not fail CI for missing setup; stable,
 actionable findings belong in `doctor`.
@@ -1113,8 +1150,8 @@ The server exposes six tools:
 - `doctor` - drift diagnostics as JSON, `{ strict?: boolean }` defaults to
   `true` (read-only)
 - `doctor_fix` - apply doctor's low-risk fixes; repairs route-group,
-  schedule, task, and outbox registration drift, while listener drift stays
-  report-only
+  schedule, task, outbox, and fully unregistered listener registry drift when
+  the central registry/provider anchors are recognizable
 - `lint` - architecture dependency-direction diagnostics (read-only)
 - `make` - run a generator with `{ artifact, name, ...options }`, the same
   artifact kinds as `beignet make`

package/dist/choices.d.ts

@@ -13,20 +13,20 @@ export type PackageManager = "bun" | "npm" | "pnpm" | "yarn";
  */
 export type TemplateName = "next";
 /**
- * Optional provider integrations that can be scaffolded into a new app.
+ * Optional providers rendered directly by the starter template.
  *
  * Better Auth, Drizzle/libSQL, and pino ship in every starter, so only
- * integrations that add an external service remain selectable.
+ * providers that add an external service remain selectable.
  */
-export type IntegrationName = "inngest" | "resend" | "upstash-rate-limit";
+export type StarterProviderName = "jobs-inngest" | "mail-resend" | "rate-limit-upstash";
 /**
  * Databases supported by the starter's Drizzle persistence layer.
  */
 export type DatabaseName = "sqlite" | "postgres" | "mysql";
 /**
- * Provider setup presets supported by `beignet providers add`.
+ * Provider setup presets supported by `beignet provider add`.
  */
-export type ProviderPresetName = "flags-openfeature" | "jobs-bullmq" | "jobs-inngest" | "mail-resend" | "mail-smtp" | "payments-stripe" | "search-meilisearch" | "sentry" | "upstash-rate-limit" | "redis-cache" | "event-bus-redis" | "redis-locks" | "s3-storage" | "vercel-blob-storage";
+export type ProviderPresetName = "flags-openfeature" | "jobs-bullmq" | "jobs-inngest" | "mail-resend" | "mail-smtp" | "payments-stripe" | "search-meilisearch" | "error-reporting-sentry" | "rate-limit-upstash" | "cache-redis" | "event-bus-redis" | "locks-redis" | "storage-s3" | "storage-vercel-blob";
 /**
  * Supported scaffold template choices.
  */
@@ -36,9 +36,9 @@ export declare const templateChoices: readonly ["next"];
  */
 export declare const packageManagerChoices: readonly ["bun", "npm", "pnpm", "yarn"];
 /**
- * Supported scaffold integration choices.
+ * Supported providers rendered directly by the starter.
  */
-export declare const integrationChoices: readonly ["inngest", "resend", "upstash-rate-limit"];
+export declare const starterProviderChoices: readonly ["jobs-inngest", "mail-resend", "rate-limit-upstash"];
 /**
  * Supported scaffold database choices.
  */
@@ -46,25 +46,21 @@ export declare const databaseChoices: readonly ["sqlite", "postgres", "mysql"];
 /**
  * Supported provider setup preset choices.
  */
-export declare const providerPresetChoices: readonly ["flags-openfeature", "jobs-bullmq", "jobs-inngest", "mail-resend", "mail-smtp", "payments-stripe", "search-meilisearch", "sentry", "upstash-rate-limit", "redis-cache", "event-bus-redis", "redis-locks", "s3-storage", "vercel-blob-storage"];
+export declare const providerPresetChoices: readonly ["flags-openfeature", "jobs-bullmq", "jobs-inngest", "mail-resend", "mail-smtp", "payments-stripe", "search-meilisearch", "error-reporting-sentry", "rate-limit-upstash", "cache-redis", "event-bus-redis", "locks-redis", "storage-s3", "storage-vercel-blob"];
 /**
- * Values accepted by `beignet create --integrations`: the starter template
- * integrations plus the full `beignet providers add` preset catalog.
+ * Values accepted by `beignet create --providers`.
  */
-export type CreateIntegrationName = IntegrationName | ProviderPresetName;
+export type CreateProviderName = ProviderPresetName;
 /**
- * Supported `beignet create --integrations` choices. Template integrations
- * come first; the rest of the provider preset catalog follows.
+ * Supported `beignet create --providers` choices.
  */
-export declare const createIntegrationChoices: readonly ["inngest", "resend", "upstash-rate-limit", "flags-openfeature", "jobs-bullmq", "jobs-inngest", "mail-resend", "mail-smtp", "payments-stripe", "redis-cache", "event-bus-redis", "redis-locks", "s3-storage", "search-meilisearch", "sentry", "vercel-blob-storage"];
+export declare const createProviderChoices: readonly ["flags-openfeature", "jobs-bullmq", "jobs-inngest", "mail-resend", "mail-smtp", "payments-stripe", "search-meilisearch", "error-reporting-sentry", "rate-limit-upstash", "cache-redis", "event-bus-redis", "locks-redis", "storage-s3", "storage-vercel-blob"];
 /**
- * Split `--integrations` selections into starter template integrations and
- * provider presets applied with the `beignet providers add` machinery after
- * the scaffold is written. Preset names with a template equivalent are
- * normalized to the template integration; duplicates collapse.
+ * Split `--providers` selections into providers rendered directly by the
+ * starter and presets applied after the scaffold is written.
  */
-export declare function splitCreateIntegrations(values: readonly CreateIntegrationName[]): {
-    integrations: IntegrationName[];
+export declare function splitCreateProviders(values: readonly CreateProviderName[]): {
+    starterProviders: StarterProviderName[];
     presets: ProviderPresetName[];
 };
 /**
@@ -98,7 +94,7 @@ export declare const completionShellChoices: readonly ["bash", "zsh"];
 /**
  * Optional artifacts supported by `beignet make feature --with`.
  */
-export declare const makeFeatureAddonChoices: readonly ["policy", "factory", "factories", "event", "events", "job", "jobs", "listener", "listeners", "notification", "notifications", "schedule", "schedules", "seed", "seeds", "task", "tasks", "ui", "upload", "uploads"];
+export declare const makeFeatureAddonChoices: readonly ["policy", "factory", "event", "job", "listener", "notification", "schedule", "seed", "task", "ui", "upload"];
 /**
  * Optional artifact accepted by `beignet make feature --with`.
  */

package/dist/choices.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"choices.d.ts","sourceRoot":"","sources":["../src/choices.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG,KAAK,GAAG,KAAK,GAAG,MAAM,GAAG,MAAM,CAAC;AAC7D;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG,MAAM,CAAC;AAClC;;;;;GAKG;AACH,MAAM,MAAM,eAAe,GAAG,SAAS,GAAG,QAAQ,GAAG,oBAAoB,CAAC;AAC1E;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG,QAAQ,GAAG,UAAU,GAAG,OAAO,CAAC;AAC3D;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAC1B,mBAAmB,GACnB,aAAa,GACb,cAAc,GACd,aAAa,GACb,WAAW,GACX,iBAAiB,GACjB,oBAAoB,GACpB,QAAQ,GACR,oBAAoB,GACpB,aAAa,GACb,iBAAiB,GACjB,aAAa,GACb,YAAY,GACZ,qBAAqB,CAAC;AAE1B;;GAEG;AACH,eAAO,MAAM,eAAe,mBAEgB,CAAC;AAE7C;;GAEG;AACH,eAAO,MAAM,qBAAqB,yCAKY,CAAC;AAE/C;;GAEG;AACH,eAAO,MAAM,kBAAkB,sDAIgB,CAAC;AAEhD;;GAEG;AACH,eAAO,MAAM,eAAe,0CAIgB,CAAC;AAE7C;;GAEG;AACH,eAAO,MAAM,qBAAqB,0PAegB,CAAC;AAEnD;;;GAGG;AACH,MAAM,MAAM,qBAAqB,GAAG,eAAe,GAAG,kBAAkB,CAAC;AAEzE;;;GAGG;AACH,eAAO,MAAM,wBAAwB,+QAiBgB,CAAC;AAgBtD;;;;;GAKG;AACH,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,SAAS,qBAAqB,EAAE,GACvC;IACD,YAAY,EAAE,eAAe,EAAE,CAAC;IAChC,OAAO,EAAE,kBAAkB,EAAE,CAAC;CAC/B,CAoBA;AAED;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAEzD;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,YAAY,EACtB,OAAO,EAAE,MAAM,GACd,MAAM,GAAG,SAAS,CAWpB;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,YAAY,EACtB,OAAO,EAAE,MAAM,GACd,MAAM,CAWR;AAED;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG,MAAM,GAAG,KAAK,CAAC;AAE7C;;GAEG;AACH,eAAO,MAAM,sBAAsB,0BAGY,CAAC;AAEhD;;GAEG;AACH,eAAO,MAAM,uBAAuB,+NAqB1B,CAAC;AAEX;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG,CAAC,OAAO,uBAAuB,CAAC,CAAC,MAAM,CAAC,CAAC;AAExE;;GAEG;AACH,eAAO,MAAM,wBAAwB,yBAA0B,CAAC;AAEhE;;GAEG;AACH,MAAM,MAAM,iBAAiB,GAAG,CAAC,OAAO,wBAAwB,CAAC,CAAC,MAAM,CAAC,CAAC"}
+{"version":3,"file":"choices.d.ts","sourceRoot":"","sources":["../src/choices.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG,KAAK,GAAG,KAAK,GAAG,MAAM,GAAG,MAAM,CAAC;AAC7D;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG,MAAM,CAAC;AAClC;;;;;GAKG;AACH,MAAM,MAAM,mBAAmB,GAC3B,cAAc,GACd,aAAa,GACb,oBAAoB,CAAC;AACzB;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG,QAAQ,GAAG,UAAU,GAAG,OAAO,CAAC;AAC3D;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAC1B,mBAAmB,GACnB,aAAa,GACb,cAAc,GACd,aAAa,GACb,WAAW,GACX,iBAAiB,GACjB,oBAAoB,GACpB,wBAAwB,GACxB,oBAAoB,GACpB,aAAa,GACb,iBAAiB,GACjB,aAAa,GACb,YAAY,GACZ,qBAAqB,CAAC;AAE1B;;GAEG;AACH,eAAO,MAAM,eAAe,mBAEgB,CAAC;AAE7C;;GAEG;AACH,eAAO,MAAM,qBAAqB,yCAKY,CAAC;AAE/C;;GAEG;AACH,eAAO,MAAM,sBAAsB,gEAIgB,CAAC;AAEpD;;GAEG;AACH,eAAO,MAAM,eAAe,0CAIgB,CAAC;AAE7C;;GAEG;AACH,eAAO,MAAM,qBAAqB,0QAegB,CAAC;AAEnD;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAAG,kBAAkB,CAAC;AAEpD;;GAEG;AACH,eAAO,MAAM,qBAAqB,0QAAwB,CAAC;AAE3D;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,SAAS,kBAAkB,EAAE,GAAG;IAC3E,gBAAgB,EAAE,mBAAmB,EAAE,CAAC;IACxC,OAAO,EAAE,kBAAkB,EAAE,CAAC;CAC/B,CAaA;AAED;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAEzD;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,YAAY,EACtB,OAAO,EAAE,MAAM,GACd,MAAM,GAAG,SAAS,CAWpB;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,YAAY,EACtB,OAAO,EAAE,MAAM,GACd,MAAM,CAWR;AAED;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG,MAAM,GAAG,KAAK,CAAC;AAE7C;;GAEG;AACH,eAAO,MAAM,sBAAsB,0BAGY,CAAC;AAEhD;;GAEG;AACH,eAAO,MAAM,uBAAuB,wHAY1B,CAAC;AAEX;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG,CAAC,OAAO,uBAAuB,CAAC,CAAC,MAAM,CAAC,CAAC;AAExE;;GAEG;AACH,eAAO,MAAM,wBAAwB,yBAA0B,CAAC;AAEhE;;GAEG;AACH,MAAM,MAAM,iBAAiB,GAAG,CAAC,OAAO,wBAAwB,CAAC,CAAC,MAAM,CAAC,CAAC"}