Add governed GRB refresh workflow

backend/app/api/routes/datasets.py

@@ -46,6 +46,7 @@ from app.services.vector_feature_service import VectorFeatureService
 from app.services.dataset_service import DatasetService
 from app.services.source_freshness_service import SourceFreshnessService
 from app.services.source_catalog_probe_service import SourceCatalogProbeService
+from app.services.grb_refresh_plan_service import GrbRefreshPlanService
 from app.services.orthophoto_acquisition_service import OrthophotoAcquisitionService
 from app.services.dhmv_acquisition_service import DhmvAcquisitionService
 from app.services.terrain_analysis_service import TerrainAnalysisService
@@ -266,6 +267,22 @@ def probe_dataset_source_catalogs(
     return envelope(report.model_dump())
 
 
+@router.get("/datasets/grb-refresh-plan", response_model=dict)
+def plan_grb_dataset_refresh(
+    project_id: UUID,
+    scope: str = Query(default=GrbRefreshPlanService.SCOPE),
+    refresh_catalog: bool = Query(default=False),
+    db: Session = Depends(get_db),
+):
+    report = GrbRefreshPlanService.build(
+        db,
+        project_id,
+        scope=scope,
+        refresh_catalog=refresh_catalog,
+    )
+    return envelope(report.model_dump())
+
+
 @router.get("/datasets/{dataset_id}", response_model=dict)
 def get_dataset(
     project_id: UUID,