merge: testing → main (reconcile 2-week divergence)

decnet/web/db/sqlite/database.py

@@ -1,5 +1,7 @@
+import os
+
 from sqlalchemy.ext.asyncio import AsyncEngine, AsyncSession, async_sessionmaker, create_async_engine
-from sqlalchemy import create_engine, Engine
+from sqlalchemy import create_engine, Engine, event
 from sqlmodel import SQLModel
 from typing import AsyncGenerator
 
@@ -11,7 +13,34 @@ def get_async_engine(db_path: str) -> AsyncEngine:
     prefix = "sqlite+aiosqlite:///"
     if db_path.startswith(":memory:"):
         prefix = "sqlite+aiosqlite://"
-    return create_async_engine(f"{prefix}{db_path}", echo=False, connect_args={"uri": True})
+
+    pool_size = int(os.environ.get("DECNET_DB_POOL_SIZE", "20"))
+    max_overflow = int(os.environ.get("DECNET_DB_MAX_OVERFLOW", "40"))
+
+    pool_recycle = int(os.environ.get("DECNET_DB_POOL_RECYCLE", "3600"))
+    # SQLite is a local file — dead-connection probes are pure overhead.
+    # Env var stays for network-mounted setups that still want it.
+    pool_pre_ping = os.environ.get("DECNET_DB_POOL_PRE_PING", "false").lower() == "true"
+
+    engine = create_async_engine(
+        f"{prefix}{db_path}",
+        echo=False,
+        pool_size=pool_size,
+        max_overflow=max_overflow,
+        pool_recycle=pool_recycle,
+        pool_pre_ping=pool_pre_ping,
+        connect_args={"uri": True, "timeout": 30},
+    )
+
+    @event.listens_for(engine.sync_engine, "connect")
+    def _set_sqlite_pragmas(dbapi_conn, _conn_record):
+        cursor = dbapi_conn.cursor()
+        cursor.execute("PRAGMA journal_mode=WAL")
+        cursor.execute("PRAGMA synchronous=NORMAL")
+        cursor.execute("PRAGMA busy_timeout=30000")
+        cursor.close()
+
+    return engine
 
 def get_sync_engine(db_path: str) -> Engine:
     prefix = "sqlite:///"