feat(database): implement app-scoped migration management and configuration

- Introduced AppDatabaseConfig to manage app-specific database settings, including migrations and seeds paths.
- Added tests for loading app configurations with and without database sections.
- Enhanced DatabasePlugin to support app-specific migration paths and table names.
- Updated migration commands to accept an app name for scoped operations, improving flexibility in multi-app environments.
- Implemented comprehensive tests for migration path resolution and app name sanitization.

These changes enhance the migration management capabilities, allowing for better organization and control over database migrations in multi-application setups.

Author: juicycleff

cmd/forge/config/app_config.go

@@ -13,15 +13,35 @@ import (
 // This is different from ForgeConfig (project-level) and is used
 // to configure individual applications within a Forge project.
 type AppConfig struct {
-	App   AppSection     `yaml:"app"`
-	Dev   AppDevConfig   `yaml:"dev,omitempty"`
-	Build AppBuildConfig `yaml:"build,omitempty"`
+	App      AppSection        `yaml:"app"`
+	Dev      AppDevConfig      `yaml:"dev,omitempty"`
+	Build    AppBuildConfig    `yaml:"build,omitempty"`
+	Database AppDatabaseConfig `yaml:"database,omitempty"`
 
 	// Internal fields
 	AppDir     string `yaml:"-"` // Directory containing the app's .forge.yaml
 	ConfigPath string `yaml:"-"` // Full path to app's .forge.yaml
 }
 
+// AppDatabaseConfig defines app-specific database configuration.
+// This allows each app to override the default migration path or
+// reference a specific named connection from the project config.
+type AppDatabaseConfig struct {
+	MigrationsPath string `yaml:"migrations_path,omitempty"` // Override migration directory (relative to app dir)
+	SeedsPath      string `yaml:"seeds_path,omitempty"`      // Override seeds directory (relative to app dir)
+	Connection     string `yaml:"connection,omitempty"`      // Reference a named connection from project config
+}
+
+// GetMigrationsPath returns the app-specific migrations path, or empty if not set.
+func (d *AppDatabaseConfig) GetMigrationsPath() string {
+	return d.MigrationsPath
+}
+
+// GetSeedsPath returns the app-specific seeds path, or empty if not set.
+func (d *AppDatabaseConfig) GetSeedsPath() string {
+	return d.SeedsPath
+}
+
 // AppSection defines app metadata.
 type AppSection struct {
 	Name    string `yaml:"name"`

cmd/forge/config/app_config_test.go

@@ -0,0 +1,146 @@
+package config
+
+import (
+	"os"
+	"path/filepath"
+	"testing"
+
+	"github.com/stretchr/testify/assert"
+	"github.com/stretchr/testify/require"
+)
+
+func TestAppDatabaseConfig_GetMigrationsPath(t *testing.T) {
+	t.Run("returns configured path", func(t *testing.T) {
+		cfg := AppDatabaseConfig{MigrationsPath: "./db/migrations"}
+		assert.Equal(t, "./db/migrations", cfg.GetMigrationsPath())
+	})
+
+	t.Run("returns empty when not set", func(t *testing.T) {
+		cfg := AppDatabaseConfig{}
+		assert.Equal(t, "", cfg.GetMigrationsPath())
+	})
+}
+
+func TestAppDatabaseConfig_GetSeedsPath(t *testing.T) {
+	t.Run("returns configured path", func(t *testing.T) {
+		cfg := AppDatabaseConfig{SeedsPath: "./db/seeds"}
+		assert.Equal(t, "./db/seeds", cfg.GetSeedsPath())
+	})
+
+	t.Run("returns empty when not set", func(t *testing.T) {
+		cfg := AppDatabaseConfig{}
+		assert.Equal(t, "", cfg.GetSeedsPath())
+	})
+}
+
+func TestLoadAppConfig_WithDatabaseSection(t *testing.T) {
+	tmpDir := t.TempDir()
+
+	configContent := `app:
+  name: api-gateway
+  type: web
+  version: "1.0.0"
+database:
+  migrations_path: ./custom/migrations
+  seeds_path: ./custom/seeds
+  connection: production
+`
+	require.NoError(t, os.WriteFile(filepath.Join(tmpDir, ".forge.yaml"), []byte(configContent), 0644))
+
+	cfg, err := LoadAppConfig(tmpDir)
+	require.NoError(t, err)
+
+	assert.Equal(t, "api-gateway", cfg.App.Name)
+	assert.Equal(t, "web", cfg.App.Type)
+	assert.Equal(t, "./custom/migrations", cfg.Database.MigrationsPath)
+	assert.Equal(t, "./custom/seeds", cfg.Database.SeedsPath)
+	assert.Equal(t, "production", cfg.Database.Connection)
+}
+
+func TestLoadAppConfig_WithoutDatabaseSection(t *testing.T) {
+	tmpDir := t.TempDir()
+
+	configContent := `app:
+  name: worker
+  type: worker
+`
+	require.NoError(t, os.WriteFile(filepath.Join(tmpDir, ".forge.yaml"), []byte(configContent), 0644))
+
+	cfg, err := LoadAppConfig(tmpDir)
+	require.NoError(t, err)
+
+	assert.Equal(t, "worker", cfg.App.Name)
+	// Database config should be zero-valued
+	assert.Equal(t, "", cfg.Database.MigrationsPath)
+	assert.Equal(t, "", cfg.Database.SeedsPath)
+	assert.Equal(t, "", cfg.Database.Connection)
+}
+
+func TestLoadAppConfig_YmlExtension(t *testing.T) {
+	tmpDir := t.TempDir()
+
+	configContent := `app:
+  name: my-service
+  type: web
+database:
+  migrations_path: ./migrations
+`
+	require.NoError(t, os.WriteFile(filepath.Join(tmpDir, ".forge.yml"), []byte(configContent), 0644))
+
+	cfg, err := LoadAppConfig(tmpDir)
+	require.NoError(t, err)
+
+	assert.Equal(t, "my-service", cfg.App.Name)
+	assert.Equal(t, "./migrations", cfg.Database.MigrationsPath)
+}
+
+func TestLoadAppConfig_NotFound(t *testing.T) {
+	tmpDir := t.TempDir()
+
+	_, err := LoadAppConfig(tmpDir)
+	assert.Error(t, err)
+	assert.Contains(t, err.Error(), "no .forge.yaml or .forge.yml found")
+}
+
+func TestLoadAppConfig_InvalidYAML(t *testing.T) {
+	tmpDir := t.TempDir()
+
+	require.NoError(t, os.WriteFile(filepath.Join(tmpDir, ".forge.yaml"), []byte("invalid: yaml: content: ["), 0644))
+
+	_, err := LoadAppConfig(tmpDir)
+	assert.Error(t, err)
+}
+
+func TestLoadAppConfig_InternalFieldsSet(t *testing.T) {
+	tmpDir := t.TempDir()
+
+	configContent := `app:
+  name: test-app
+`
+	configPath := filepath.Join(tmpDir, ".forge.yaml")
+	require.NoError(t, os.WriteFile(configPath, []byte(configContent), 0644))
+
+	cfg, err := LoadAppConfig(tmpDir)
+	require.NoError(t, err)
+
+	assert.Equal(t, tmpDir, cfg.AppDir)
+	assert.Equal(t, configPath, cfg.ConfigPath)
+}
+
+func TestLoadAppConfig_DatabaseMigrationsPathOnly(t *testing.T) {
+	tmpDir := t.TempDir()
+
+	configContent := `app:
+  name: api
+database:
+  migrations_path: ./db/migrate
+`
+	require.NoError(t, os.WriteFile(filepath.Join(tmpDir, ".forge.yaml"), []byte(configContent), 0644))
+
+	cfg, err := LoadAppConfig(tmpDir)
+	require.NoError(t, err)
+
+	assert.Equal(t, "./db/migrate", cfg.Database.GetMigrationsPath())
+	assert.Equal(t, "", cfg.Database.GetSeedsPath())
+	assert.Equal(t, "", cfg.Database.Connection)
+}