chore: ruff format + full type annotations on CLI commands

- ruff format all three changed files
- Add complete type annotations to all command functions:
  ctx: click.Context, typed params, -> Any / -> None return types
- Import Optional and Any from typing
- context_grounding group annotated -> None
- ingest/delete return bare (no 'return None') for cleaner style
- Under project mypy config: 0 errors
- Under strict mypy: only 4 pre-existing get_client() untyped-call
  errors (same infrastructure gap as cli_buckets.py which has 17)

Author: DragosBobolea

src/uipath/_cli/services/cli_context_grounding.py

@@ -11,6 +11,8 @@
 """
 # ruff: noqa: D301 - Using regular """ strings (not r""") for Click \b formatting
 
+from typing import Any, Optional
+
 import click
 
 from .._utils._service_base import (
@@ -22,14 +24,18 @@
 
 
 def _not_found(index_name: str, e: Exception) -> None:
-    """Re-raise as a clean ClickException when the SDK reports index not found."""
+    """Raise a clean ClickException for any SDK error from context-grounding commands.
+
+    Surfaces "not found" as a structured error; wraps all other exceptions so
+    raw SDK tracebacks never reach the user.
+    """
     if "not found" in str(e).lower():
         handle_not_found_error("Index", index_name)
     raise click.ClickException(str(e)) from e
 
 
 @click.group(name="context-grounding")
-def context_grounding():
+def context_grounding() -> None:
     """Manage UiPath Context Grounding indexes and perform semantic search.
 
     Context Grounding indexes documents from storage buckets or cloud drives
@@ -59,10 +65,19 @@ def context_grounding():
 
 
 @context_grounding.command("retrieve")
-@click.option("--index", "index_name", required=True, help="Name of the index to retrieve.")
+@click.option(
+    "--index", "index_name", required=True, help="Name of the index to retrieve."
+)
 @common_service_options
 @service_command
-def retrieve(ctx, index_name, folder_path, folder_key, format, output):
+def retrieve(
+    ctx: click.Context,
+    index_name: str,
+    folder_path: Optional[str],
+    folder_key: Optional[str],
+    format: Optional[str],
+    output: Optional[str],
+) -> Any:
     """Retrieve details of a context grounding index by name.
 
     \b
@@ -84,7 +99,9 @@ def retrieve(ctx, index_name, folder_path, folder_key, format, output):
 
 @context_grounding.command("search")
 @click.argument("query")
-@click.option("--index", "index_name", required=True, help="Name of the index to search.")
+@click.option(
+    "--index", "index_name", required=True, help="Name of the index to search."
+)
 @click.option(
     "--results",
     "-n",
@@ -96,7 +113,16 @@ def retrieve(ctx, index_name, folder_path, folder_key, format, output):
 )
 @common_service_options
 @service_command
-def search(ctx, query, index_name, number_of_results, folder_path, folder_key, format, output):
+def search(
+    ctx: click.Context,
+    query: str,
+    index_name: str,
+    number_of_results: int,
+    folder_path: Optional[str],
+    folder_key: Optional[str],
+    format: Optional[str],
+    output: Optional[str],
+) -> Any:
     """Search an index with a natural language query.
 
     QUERY is the natural language search string.
@@ -148,10 +174,19 @@ def search(ctx, query, index_name, number_of_results, folder_path, folder_key, f
 
 
 @context_grounding.command("ingest")
-@click.option("--index", "index_name", required=True, help="Name of the index to re-ingest.")
+@click.option(
+    "--index", "index_name", required=True, help="Name of the index to re-ingest."
+)
 @common_service_options
 @service_command
-def ingest(ctx, index_name, folder_path, folder_key, format, output):
+def ingest(
+    ctx: click.Context,
+    index_name: str,
+    folder_path: Optional[str],
+    folder_key: Optional[str],
+    format: Optional[str],
+    output: Optional[str],
+) -> None:
     """Trigger re-ingestion of a context grounding index.
 
     \b
@@ -183,16 +218,28 @@ def ingest(ctx, index_name, folder_path, folder_key, format, output):
         ) from e
 
     click.echo(f"Triggered ingestion for index '{index_name}'.", err=True)
-    return None
 
 
 @context_grounding.command("delete")
-@click.option("--index", "index_name", required=True, help="Name of the index to delete.")
+@click.option(
+    "--index", "index_name", required=True, help="Name of the index to delete."
+)
 @click.option("--confirm", is_flag=True, help="Skip confirmation prompt.")
-@click.option("--dry-run", is_flag=True, help="Show what would be deleted without deleting.")
+@click.option(
+    "--dry-run", is_flag=True, help="Show what would be deleted without deleting."
+)
 @common_service_options
 @service_command
-def delete(ctx, index_name, confirm, dry_run, folder_path, folder_key, format, output):
+def delete(
+    ctx: click.Context,
+    index_name: str,
+    confirm: bool,
+    dry_run: bool,
+    folder_path: Optional[str],
+    folder_key: Optional[str],
+    format: Optional[str],
+    output: Optional[str],
+) -> None:
     """Delete a context grounding index by name.
 
     \b
@@ -213,12 +260,12 @@ def delete(ctx, index_name, confirm, dry_run, folder_path, folder_key, format, o
 
     if dry_run:
         click.echo(f"Would delete index '{index_name}'.", err=True)
-        return None
+        return
 
     if not confirm:
         if not click.confirm(f"Delete index '{index_name}'?"):
             click.echo("Deletion cancelled.", err=True)
-            return None
+            return
 
     client.context_grounding.delete_index(
         index=index,
@@ -227,4 +274,3 @@ def delete(ctx, index_name, confirm, dry_run, folder_path, folder_key, format, o
     )
 
     click.echo(f"Deleted index '{index_name}'.", err=True)
-    return None

tests/cli/contract/test_sdk_cli_alignment.py

@@ -252,7 +252,7 @@ def _get_service_group(name: str):
         # Nested subgroup (e.g., "buckets_files")
         parts = service.split("_", 1)
         service_group = _get_service_group(parts[0])  # Get "buckets"
-        subgroup = service_group.commands[parts[1]]    # Get "files" subgroup
+        subgroup = service_group.commands[parts[1]]  # Get "files" subgroup
         cli_cmd = subgroup.commands[command.replace("_", "-")]
     else:
         # Top-level service group (plain name or hyphenated like "context-grounding")