// Package migrate integrates pressly/goose with go-toolkit [app.Module] lifecycles.
//
// # Setup
//
// Embed migration SQL, configure [MigrationOpts] with SQLO, Dialect, FS, and optional
// BasePath, then register [ModuleMigrations] before dependent modules such as
// [ModuleAutoMigrate] or CLI commands via [gitea.auvem.com/go-toolkit/migrate/cli].
//
// # BasePath
//
// When BasePath is not ".", migration files are read from fs.Sub(FS, BasePath) for
// the goose Provider. Keep CLI create paths aligned with BasePath.
//
// # Zero version
//
// Goose requires a version-0 migration when bootstrapping a fresh database.
package migrate