use sqlalchemy pattern

core/db/__init__.py

@@ -1,20 +1,24 @@
-from .assets import (
-    create_asset,
-    delete_asset,
-    get_asset,
-    get_asset_filenames,
-    list_assets,
-    update_asset,
-)
-from .jobs import (
-    create_job,
-    get_job,
-    list_jobs,
-    update_job,
-    update_job_fields,
-)
-from .presets import (
-    get_preset,
-    list_presets,
-)
+"""
+Database layer.
+
+tables.py   — SQLModel table definitions (generated by modelgen, don't edit)
+domain files — session-first query functions for non-trivial operations
+
+Basic CRUD (create, get, update, delete) goes directly through the session:
+    session.add(Job(...))
+    session.get(Job, id)
+    session.get(Job, id); setattr(...); session.commit()
+    session.delete(obj); session.commit()
+"""
+
 from .connection import get_session, create_tables
+
+from .tables import MediaAsset, Job, Timeline, Checkpoint, Brand
+
+from .assets import list_assets, get_asset_filenames
+from .job import list_jobs
+from .checkpoint import (
+    get_latest_checkpoint, get_root_checkpoint,
+    list_checkpoints, list_scenarios,
+)
+from .brand import get_or_create_brand, find_brand_by_text, list_brands, record_airing