fix(database): env var for db_name is NAME not DB_NAME

Rename field `db_name` to `name` in `DatabaseSettings` so pydantic-settings
constructs the env var as `{PREFIX}NAME` (e.g. `MYAPP_DB_NAME`) instead of
the confusing double-prefix `{PREFIX}DB_NAME`.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

Author: olivermeyer

ATTRIBUTIONS.md

@@ -360,7 +360,7 @@ SOFTWARE.
 
 ```
 
-## aignostics-foundry-core (0.5.0) - MIT License
+## aignostics-foundry-core (0.6.1) - MIT License
 
 🏭 Foundational infrastructure for Foundry components.
 

src/aignostics_foundry_core/database.py

@@ -48,7 +48,7 @@ class DatabaseSettings(OpaqueSettings):
     pool_size: int = 10
     pool_max_overflow: int = 10
     pool_timeout: float = 30.0
-    db_name: str | None = None
+    name: str | None = None
 
     def __init__(self, _env_prefix: str | None = None, **kwargs: Any) -> None:  # noqa: ANN401
         """Initialise settings, deriving env prefix from the active FoundryContext when not given.
@@ -68,17 +68,17 @@ def __init__(self, _env_prefix: str | None = None, **kwargs: Any) -> None:  # no
     def get_url(self) -> str:
         """Return the database URL string, optionally substituting the database name.
 
-        When :attr:`db_name` is set, the path component of the URL is replaced with
-        ``/{db_name}``, leaving the scheme, host, port, query, and fragment unchanged.
+        When :attr:`name` is set, the path component of the URL is replaced with
+        ``/{name}``, leaving the scheme, host, port, query, and fragment unchanged.
 
         Returns:
             The database URL as a plain string.
         """
         raw = self.url.get_secret_value()
-        if self.db_name is None:
+        if self.name is None:
             return raw
         parsed = urllib.parse.urlparse(raw)
-        return urllib.parse.urlunparse(parsed._replace(path=f"/{self.db_name}"))
+        return urllib.parse.urlunparse(parsed._replace(path=f"/{self.name}"))
 
 
 # Global engine and session maker - initialized once per process and kept open

tests/aignostics_foundry_core/database_settings_test.py

@@ -19,6 +19,8 @@
 OVERRIDE_POOL_SIZE = 5
 OVERRIDE_POOL_MAX_OVERFLOW = 20
 OVERRIDE_POOL_TIMEOUT = 60
+TEST_DB_PREFIX = "TEST_DB_"
+TEST_DB_NAME_ENV = "TEST_DB_NAME"
 
 
 @pytest.fixture(autouse=True)
@@ -43,17 +45,17 @@ def test_get_url_returns_plain_url_when_db_name_not_set() -> None:
 
 @pytest.mark.unit
 def test_get_url_replaces_db_name_in_path() -> None:
-    """get_url() substitutes the path component when db_name is set."""
-    settings = DatabaseSettings(_env_prefix="TEST_DB_", url=POSTGRES_URL, db_name="mydb")
+    """get_url() substitutes the path component when name is set."""
+    settings = DatabaseSettings(_env_prefix="TEST_DB_", url=POSTGRES_URL, name="mydb")
     result = settings.get_url()
     assert result.endswith("/mydb")
     assert "postgres" not in result.split("/")[-1]
 
 
 @pytest.mark.unit
 def test_get_url_preserves_scheme_and_host() -> None:
-    """Scheme, host, and port are intact after db_name substitution."""
-    settings = DatabaseSettings(_env_prefix="TEST_DB_", url=POSTGRES_URL, db_name="mydb")
+    """Scheme, host, and port are intact after name substitution."""
+    settings = DatabaseSettings(_env_prefix="TEST_DB_", url=POSTGRES_URL, name="mydb")
     result = settings.get_url()
     assert result.startswith("postgresql+asyncpg://")
     assert "localhost:5432" in result
@@ -120,6 +122,18 @@ def test_pool_overrides_from_env(monkeypatch: pytest.MonkeyPatch) -> None:
 # ---------------------------------------------------------------------------
 
 
+@pytest.mark.unit
+def test_db_name_reads_from_name_env_var(monkeypatch: pytest.MonkeyPatch) -> None:
+    """Setting {PREFIX}NAME populates db_name and get_url() substitutes the database name."""
+    monkeypatch.setenv("TEST_DB_URL", POSTGRES_URL)
+    monkeypatch.setenv(TEST_DB_NAME_ENV, "mydb")
+
+    settings = DatabaseSettings(_env_prefix=TEST_DB_PREFIX)
+
+    assert settings.name == "mydb"
+    assert settings.get_url().endswith("/mydb")
+
+
 @pytest.mark.unit
 def test_url_is_masked_in_repr() -> None:
     """repr(settings) / str(settings) does not expose the raw URL."""