@beignet/provider-db-drizzle 0.0.47 → 0.0.48

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # @beignet/provider-db-drizzle
 
+## 0.0.48
+
+### Patch Changes
+
+- 728c942: Add read-only migration status reports, connected validation, stable generated migration hashes, preflight pending detection, generated Drizzle status scripts, and serialized deployment guidance.
+
 ## 0.0.47
 
 ## 0.0.46

package/README.md

@@ -126,6 +126,7 @@ normal app-owned migration flow:
 ```bash
 bun beignet db generate
 bun beignet db migrate
+bun beignet db status
 ```
 
 Use `--tables audit,idempotency,outbox` to select a subset when adopting one
@@ -487,9 +488,13 @@ transactions, outbox rows, idempotency rows, or migration assumptions.
 
 ## Deployment notes
 
-Run migrations before booting code that depends on new schema. Keep repository
-interfaces app-owned so switching SQLite, Postgres, or MySQL changes infra
-wiring instead of contracts, use cases, policies, or routes.
+Run one serialized migration job per environment before booting code that
+depends on new schema, then verify the target with `beignet db status` and
+`beignet preflight --connect`. Do not migrate from every web replica. Status is
+read-only and cannot prevent a race; use the deployment platform's concurrency
+lock or an app-owned database advisory-lock wrapper. Keep repository interfaces
+app-owned so switching SQLite, Postgres, or MySQL changes infra wiring instead
+of contracts, use cases, policies, or routes.
 
 ## Unit of work
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@beignet/provider-db-drizzle",
-  "version": "0.0.47",
+  "version": "0.0.48",
   "type": "module",
   "description": "Drizzle ORM database providers for Beignet — typed DbPort, unit of work, audit logs, outbox, and idempotency for SQLite (libSQL/Turso), Postgres, and MySQL.",
   "exports": {

package/skills/database-provider/SKILL.md

@@ -44,6 +44,7 @@ Beignet table exports into the app schema, then run the normal migration flow:
 beignet db schema sync
 beignet db generate
 beignet db migrate
+beignet db status
 ```
 
 Use `--tables audit,idempotency,outbox` when adopting a subset.
@@ -83,6 +84,12 @@ then calls an idempotent `closeDatabaseClient()` so operational commands exit
 without breaking failed-boot retries. When a provider creates its own
 env-backed client, the provider always closes it.
 
+Generated apps also own `infra/db/migration-status.ts`. It compares the
+checked-in Drizzle journal and SQL hashes with the target database without
+mutating either side. Run it through `beignet db status`; exit 0 means current,
+exit 2 means pending, and any other non-zero exit means inspection or migration
+history validation failed.
+
 If a custom injected client does not use the provider's standard URL env var,
 list that exact variable under `providerAudit.ignoreRequiredEnv` in
 `beignet.config.ts`. The exception affects static CLI audit only.
@@ -177,7 +184,8 @@ the current transaction unless rebuilt from `tx`.
 ## Gotchas
 
 - The provider installs `ctx.ports.db`; the app still owns schema,
-  migrations, repository interfaces, seed/reset scripts, and Drizzle config.
+  migrations, repository interfaces, seed/reset/status scripts, and Drizzle
+  config.
 - `ctx.ports.db.drizzle` is an infra escape hatch. Do not make it the normal
   dependency for contracts, use cases, policies, routes, or UI.
 - Register Drizzle before app-local providers that call `ports.db.drizzle` in
@@ -205,7 +213,9 @@ the current transaction unless rebuilt from `tx`.
   and drain from a worker, cron route, or explicit outbox drain route.
 
 Generate and migrate the backing tables before booting code that depends on
-these ports.
+these ports. In deployment, serialize one migration job per environment,
+verify it with `beignet db status`, then run `beignet preflight --connect`.
+Do not migrate independently from every web replica.
 
 ## Testing