docs: update README and migration guide for final package structure

Reflect the final state: 18 packages, no db/, auth/, testkit/,
or telemetry/otelhttpclient. Update all package tables, dependency
lists, and migration instructions.

Author: ravisuhag

MIGRATION.md

@@ -10,21 +10,27 @@ Update `go.mod` to require Go 1.24:
 go 1.24
 ```
 
-## Package moves
+## Packages removed
 
-Update import paths:
+| Removed | Replacement |
+|---------|-------------|
+| `observability/logger` | Use `*slog.Logger` from `log/slog` directly |
+| `observability/otelgrpc` | Use `connectrpc.com/otelconnect` |
+| `observability/otelhttpclient` | Use `go.opentelemetry.io/contrib/instrumentation/net/http/otelhttp` |
+| `server/mux` | Use `github.com/raystack/salt/server` |
+| `db` | Use your preferred DB library (sqlx, pgx, gorm) directly |
+| `auth/oidc` | Planned as complete CLI auth solution (#86) |
+| `auth/audit` | Planned with standardized schema (#87) |
+| `testing/dockertestx` | Use `ory/dockertest/v3` directly |
+
+## Packages moved
 
 | Old | New |
 |-----|-----|
-| `github.com/raystack/salt/observability/logger` | Removed — use `*slog.Logger` from `log/slog` |
-| `github.com/raystack/salt/observability` | `github.com/raystack/salt/telemetry` |
-| `github.com/raystack/salt/observability/otelhttpclient` | `github.com/raystack/salt/telemetry/otelhttpclient` |
-| `github.com/raystack/salt/observability/otelgrpc` | Removed — use `connectrpc.com/otelconnect` |
-| `github.com/raystack/salt/server/mux` | Removed — use `github.com/raystack/salt/server` |
-| `github.com/raystack/salt/testing/dockertestx` | `github.com/raystack/salt/testkit` |
-| `github.com/raystack/salt/cli/terminator` | `github.com/raystack/salt/cli/terminal` |
-| `github.com/raystack/salt/cli/prompter` | `github.com/raystack/salt/cli/prompt` |
-| `github.com/raystack/salt/cli/releaser` | `github.com/raystack/salt/cli/version` |
+| `observability` | `telemetry` |
+| `cli/terminator` | `cli/terminal` |
+| `cli/prompter` | `cli/prompt` |
+| `cli/releaser` | `cli/version` |
 
 ## Logger
 
@@ -79,14 +85,13 @@ import "github.com/raystack/salt/app"
 app.Run(
     app.WithConfig(&cfg, config.WithFile("config.yaml")),
     app.WithLogger(slog.Default()),
-    app.WithDB(cfg.DB),
-    app.WithTelemetry(cfg.Telemetry),
+    app.WithHTTPMiddleware(middleware.DefaultHTTP(slog.Default())),
     app.WithHandler("/api/", handler),
     app.WithAddr(cfg.Addr),
 )
 ```
 
-HTTP middleware (recovery, request ID, request logging, CORS) is auto-applied using the app's logger.
+HTTP middleware is explicit — use `middleware.DefaultHTTP(logger)` for the standard chain or compose your own. Database connections are managed via `app.WithOnStart` / `app.WithOnStop` hooks.
 
 ## CLI bootstrap
 
@@ -180,10 +185,25 @@ import "github.com/raystack/salt/middleware"
 interceptors := middleware.Default(slog.Default())
 handler := myv1connect.NewServiceHandler(svc, connect.WithInterceptors(interceptors...))
 
-// HTTP middleware (auto-applied by app.Run, or manually)
+// HTTP middleware
 httpMW := middleware.DefaultHTTP(slog.Default())
 ```
 
+## Config
+
+```go
+// Import path for validator changed
+// Before: "github.com/go-playground/validator"
+// After:  "github.com/go-playground/validator/v10"
+
+// If you imported go-defaults directly:
+// Before: "github.com/mcuadros/go-defaults"
+// After:  "github.com/creasty/defaults"
+// API change: defaults.SetDefaults(cfg) → defaults.Set(cfg)
+```
+
+The config package no longer prints warnings to stdout when a config file is missing.
+
 ## Dependency changes
 
 | Removed (direct) | Replacement |
@@ -197,6 +217,9 @@ httpMW := middleware.DefaultHTTP(slog.Default())
 | `pkg/errors` | `fmt.Errorf` with `%w` (stdlib) |
 | `mcuadros/go-defaults` | `creasty/defaults` |
 | `go-playground/validator` v9 | `go-playground/validator/v10` |
+| `jmoiron/sqlx` | Use directly if needed |
+| `golang-migrate` | Use directly if needed |
+| `ory/dockertest` | Use directly if needed |
 
 | Added | Purpose |
 |-------|---------|
@@ -212,18 +235,3 @@ httpMW := middleware.DefaultHTTP(slog.Default())
 | `briandowns/spinner` | v1.18 → v1.23.2 |
 | `schollz/progressbar` | v3.8 → v3.19.0 |
 | `mattn/go-isatty` | v0.0.19 → v0.0.21 |
-
-## Config
-
-The config package no longer prints warnings to stdout when a config file is missing. Missing files are silently ignored (env vars and defaults still apply). Parse errors are now returned as errors.
-
-```go
-// Import path for validator changed
-// Before: "github.com/go-playground/validator"
-// After:  "github.com/go-playground/validator/v10"
-
-// If you imported go-defaults directly in tests:
-// Before: "github.com/mcuadros/go-defaults"
-// After:  "github.com/creasty/defaults"
-// API change: defaults.SetDefaults(cfg) → defaults.Set(cfg)
-```

README.md

@@ -6,7 +6,7 @@
 
 The standard way to build raystack services and CLIs.
 
-Salt provides two entry points — `app.Run()` for services and `cli.Execute()` for command-line tools — along with the building blocks they use: configuration, database, telemetry, middleware, terminal output, and more.
+Salt provides two entry points — `app.Run()` for services and `cli.Execute()` for command-line tools — along with the building blocks they use: configuration, middleware, terminal output, and more.
 
 ## Quick start
 
@@ -20,6 +20,7 @@ import (
 
     "github.com/raystack/salt/app"
     "github.com/raystack/salt/config"
+    "github.com/raystack/salt/middleware"
 )
 
 func main() {
@@ -28,14 +29,14 @@ func main() {
     app.Run(
         app.WithConfig(&cfg, config.WithFile("config.yaml")),
         app.WithLogger(slog.Default()),
-        app.WithDB(cfg.DB),
+        app.WithHTTPMiddleware(middleware.DefaultHTTP(slog.Default())),
         app.WithHandler("/api/", apiHandler),
         app.WithAddr(cfg.Addr),
     )
 }
 ```
 
-H2C, health check at `/ping`, and HTTP middleware (recovery, request ID, request logging, CORS) are enabled by default.
+H2C and health check at `/ping` enabled by default. HTTP middleware is explicit — you choose what runs.
 
 ### CLI
 
@@ -54,7 +55,7 @@ func main() {
 }
 ```
 
-Help, shell completion, and reference docs are enabled by default. Commands access shared output via `cli.Output(cmd)`.
+Help, shell completion, and reference docs enabled by default. Commands access shared output via `cli.Output(cmd)`.
 
 ## Installation
 
@@ -70,7 +71,7 @@ Requires Go 1.24+.
 
 | Package | Description |
 |---------|-------------|
-| [`app`](app/) | Service lifecycle — config, logger, db, telemetry, server, graceful shutdown |
+| [`app`](app/) | Service lifecycle — config, logger, telemetry, server, graceful shutdown |
 | [`cli`](cli/) | CLI lifecycle — root command, help, completion, version check |
 
 ### Server & Middleware
@@ -101,16 +102,7 @@ Requires Go 1.24+.
 | Package | Description |
 |---------|-------------|
 | [`config`](config/) | Configuration from files, env vars, flags, and struct defaults |
-| [`db`](db/) | Database client (sqlx) with connection pooling and migrations |
 | [`telemetry`](telemetry/) | OpenTelemetry initialization — traces and metrics via OTLP |
-| [`telemetry/otelhttpclient`](telemetry/otelhttpclient/) | HTTP client transport with OTel metrics |
-
-### Auth
-
-| Package | Description |
-|---------|-------------|
-| [`auth/oidc`](auth/oidc/) | OpenID Connect authentication with PKCE |
-| [`auth/audit`](auth/audit/) | Audit event logging |
 
 ### Data
 
@@ -119,12 +111,6 @@ Requires Go 1.24+.
 | [`data/rql`](data/rql/) | REST query language — filters, pagination, sorting, search |
 | [`data/jsondiff`](data/jsondiff/) | JSON document diffing and reconstruction |
 
-### Testing
-
-| Package | Description |
-|---------|-------------|
-| [`testkit`](testkit/) | Docker test containers — Postgres, Minio, SpiceDB, Nginx, Cortex |
-
 ## Logging
 
 Salt uses `*slog.Logger` from the Go standard library. No custom logger interface — pass `slog.Default()` or any `*slog.Logger` to packages that need it.