agent foundation

lib/Service/Directory/DirectoryScopeGateway.php

@@ -41,6 +41,9 @@ class DirectoryScopeGateway
         return $this->tenantScopeService->filterTenantIdsForUser($tenantIds, $userId);
     }
 
+    // When a scoped admin updates tenant assignments, they can't see tenants outside their scope.
+    // This merges the requested IDs with any out-of-scope IDs from existing assignments so those
+    // aren't silently dropped when the admin saves.
     public function mergeTenantIdsPreservingOutOfScope(
         array $requestedTenantIds,
         array $existingTenantIds,