docs(cli): clarify SyncClient log level control and OpenTelemetry isolation

Author: AlePouroullis

src/humanloop/cli/__main__.py

@@ -219,7 +219,11 @@ def pull(
 
     Currently only supports syncing Prompt and Agent files. Other file types will be skipped."""
     client = get_client(api_key, env_file, base_url)
-    # Although pull() is available on the Humanloop client, we instantiate SyncClient separately as we need to control its log level
+    # Although pull() is available on the Humanloop client, we instantiate SyncClient separately to control its log level.
+    # This allows CLI users to toggle between detailed logging (--verbose) and minimal output without affecting the
+    # main Humanloop client logger. The SyncClient uses its own logger namespace (humanloop.sdk.sync), making this
+    # modification isolated from the client's OpenTelemetry setup. This client instance is short-lived and only
+    # exists for the duration of the CLI command execution.
     sync_client = SyncClient(
         client, base_dir=local_files_directory, log_level=logging.DEBUG if verbose else logging.WARNING
     )