refactor(cli): Refactor CLI to support lazy app resolution and enhance migration command handling

- Updated `buildServeCommand`, `buildMigrateCommand`, and related functions to resolve the app context lazily during command execution.
- Introduced `appProvider` in CLI configuration for deferred app creation.
- Enhanced migration command registration and execution, ensuring commands can access the app context dynamically.
- Added tests for lazy app resolution and global flag injection.
- Updated documentation to reflect changes in running apps and CLI options.
- Improved error handling for app availability in command contexts.

Author: juicycleff

app.go

@@ -41,6 +41,9 @@ type App interface {
 	// Extensions
 	Extensions() []Extension
 	GetExtension(name string) (Extension, error)
+
+	// Configuration queries
+	MigrationsDisabled() bool
 }
 
 // AppConfig configures the application.
@@ -93,6 +96,9 @@ type AppConfig struct {
 	EnvPrefix        string // Prefix for environment variables (default: app name uppercase, e.g., "MYAPP_")
 	EnvSeparator     string // Separator for nested keys in env vars (default: "_")
 	EnvOverridesFile bool   // Whether env vars override file config values (default: true)
+
+	// Database / Migration
+	DisableMigrations bool // When true, skip auto-migrations on serve (default: false). Also settable via .forge.yaml database.disable_migrations.
 }
 
 // DefaultAppConfig returns a default application configuration.
@@ -319,6 +325,12 @@ func WithEnvOverridesFile(override bool) AppOption {
 	}
 }
 
+// WithDisableMigrations disables auto-migrations on serve.
+// This can also be set via .forge.yaml under database.disable_migrations.
+func WithDisableMigrations() AppOption {
+	return func(c *AppConfig) { c.DisableMigrations = true }
+}
+
 // NewApp creates a new Forge application.
 func NewApp(config AppConfig) App {
 	return newApp(config)

app_impl.go

@@ -476,6 +476,11 @@ func (a *app) Environment() string {
 	return a.config.Environment
 }
 
+// MigrationsDisabled returns true if auto-migrations are disabled via config or .forge.yaml.
+func (a *app) MigrationsDisabled() bool {
+	return a.config.DisableMigrations
+}
+
 // StartTime returns the application start time.
 func (a *app) StartTime() time.Time {
 	a.mu.RLock()
@@ -1367,6 +1372,9 @@ type forgeYAMLConfig struct {
 	Build struct {
 		Output string `yaml:"output"`
 	} `yaml:"build"`
+	Database struct {
+		DisableMigrations bool `yaml:"disable_migrations"`
+	} `yaml:"database"`
 }
 
 // loadForgeYAMLConfig searches for and loads .forge.yaml to configure runtime settings.
@@ -1455,5 +1463,13 @@ func loadForgeYAMLConfig(config AppConfig, logger Logger) AppConfig {
 		}
 	}
 
+	// Set DisableMigrations from .forge.yaml if not already set programmatically
+	if !config.DisableMigrations && forgeConfig.Database.DisableMigrations {
+		config.DisableMigrations = true
+		if logger != nil {
+			logger.Info("migrations disabled via .forge.yaml", F("path", forgeConfigPath))
+		}
+	}
+
 	return config
 }