docs(test): add integration test coverage table to docstring

Author: fede-kamel

tests/test_oci_client.py

@@ -1,6 +1,27 @@
-"""Integration tests for OCI Generative AI client.
-
-These tests require:
+"""Integration and unit tests for OCI Generative AI client.
+
+All integration tests are validated against the live OCI Generative AI inference
+layer (us-chicago-1). The OciClientV2 uses the V2 Cohere API format (COHEREV2)
+and communicates with the OCI inference endpoint at:
+    https://inference.generativeai.{region}.oci.oraclecloud.com
+
+Integration test coverage:
+
+    Test                            Model                      What it proves
+    ------------------------------- -------------------------- ------------------------------------------
+    test_embed_v2                   embed-english-v3.0         V2 embed returns 2x 1024-dim vectors
+    test_embed_with_model_prefix_v2 cohere.embed-english-v3.0  Model normalization works
+    test_chat_v2                    command-a-03-2025          V2 chat returns message
+    test_chat_stream_v2             command-a-03-2025          V2 SSE streaming with content-delta events
+    test_config_file_auth           embed-english-v3.0         API key auth from config file
+    test_custom_profile_auth        embed-english-v3.0         Custom OCI profile auth
+    test_embed_english_v3           embed-english-v3.0         1024-dim embeddings
+    test_embed_multilingual_v3      embed-multilingual-v3.0    Multilingual model works
+    test_command_a_chat             command-a-03-2025          Command A chat via V2
+    test_invalid_model              invalid-model-name         Error handling works
+    test_missing_compartment_id     --                         Raises TypeError
+
+Requirements:
 1. OCI SDK installed: pip install oci
 2. OCI credentials configured in ~/.oci/config
 3. TEST_OCI environment variable set to run