semantic markup update

backend/src/api/routes/environments.py

@@ -43,10 +43,13 @@ class DatabaseResponse(BaseModel):
 
 # [DEF:get_environments:Function]
 # @PURPOSE: List all configured environments.
+# @PRE:     config_manager is injected via Depends.
+# @POST:    Returns a list of EnvironmentResponse objects.
 # @RETURN:  List[EnvironmentResponse]
 @router.get("", response_model=List[EnvironmentResponse])
 async def get_environments(config_manager=Depends(get_config_manager)):
-    envs = config_manager.get_environments()
+    with belief_scope("get_environments"):
+        envs = config_manager.get_environments()
     # Ensure envs is a list
     if not isinstance(envs, list):
         envs = []
@@ -65,6 +68,8 @@ async def get_environments(config_manager=Depends(get_config_manager)):
 
 # [DEF:update_environment_schedule:Function]
 # @PURPOSE: Update backup schedule for an environment.
+# @PRE:     Environment id exists, schedule is valid ScheduleSchema.
+# @POST:    Backup schedule updated and scheduler reloaded.
 # @PARAM:   id (str) - The environment ID.
 # @PARAM:   schedule (ScheduleSchema) - The new schedule.
 @router.put("/{id}/schedule")
@@ -74,7 +79,8 @@ async def update_environment_schedule(
     config_manager=Depends(get_config_manager),
     scheduler_service=Depends(get_scheduler_service)
 ):
-    envs = config_manager.get_environments()
+    with belief_scope("update_environment_schedule", f"id={id}"):
+        envs = config_manager.get_environments()
     env = next((e for e in envs if e.id == id), None)
     if not env:
         raise HTTPException(status_code=404, detail="Environment not found")
@@ -93,11 +99,14 @@ async def update_environment_schedule(
 
 # [DEF:get_environment_databases:Function]
 # @PURPOSE: Fetch the list of databases from a specific environment.
+# @PRE:     Environment id exists.
+# @POST:    Returns a list of database summaries from the environment.
 # @PARAM:   id (str) - The environment ID.
 # @RETURN:  List[Dict] - List of databases.
 @router.get("/{id}/databases")
 async def get_environment_databases(id: str, config_manager=Depends(get_config_manager)):
-    envs = config_manager.get_environments()
+    with belief_scope("get_environment_databases", f"id={id}"):
+        envs = config_manager.get_environments()
     env = next((e for e in envs if e.id == id), None)
     if not env:
         raise HTTPException(status_code=404, detail="Environment not found")