refactor(BA-5832): tighten admin CLI types, propagate my_bulk rename, drop BEP refs

- Type the admin AppConfig CLI's `user_id` argument and `--user-id` flag
  as `click.UUID` (was `str` parsed via `UUID(...)`); the SDK already
  takes `UUID` so this drops a redundant runtime parse and surfaces
  bad input at click parse time. Also wrap the search filter's
  `user_id` in `UUIDFilter`, matching the DTO shape.
- Carry the `bulk_create_my` / `bulk_update_my` → `my_bulk_create` /
  `my_bulk_update` rename through the v2 SDK (`domains_v2/app_config.py`),
  the self-service CLI (`cli/v2/my/app_config.py`), and the remaining
  GQL / adapter / service touchpoints that leaked through `-X theirs`
  during the stack rebase.
- Strip the residual `BEP-1052 §X` references from CLI / SDK
  docstrings and the GraphQL schema dump comments. Only the news
  fragments retain the BEP wording.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

Author: jopemachine

src/ai/backend/client/cli/v2/admin/__init__.py

@@ -211,7 +211,7 @@ def invitation() -> None:
     name="app-config",
 )
 def app_config() -> None:
-    """Admin merged AppConfig commands (BEP-1052 §5)."""
+    """Admin merged AppConfig commands."""
 
 
 @admin.group(

src/ai/backend/client/cli/v2/admin/app_config.py

@@ -1,4 +1,4 @@
-"""Admin CLI commands for the merged AppConfig view (BEP-1052 §5)."""
+"""Admin CLI commands for the merged AppConfig view."""
 
 from __future__ import annotations
 
@@ -21,15 +21,15 @@ def app_config() -> None:
 
 
 @app_config.command()
-@click.argument("user_id", type=str)
+@click.argument("user_id", type=click.UUID)
 @click.argument("name", type=str)
-def get(user_id: str, name: str) -> None:
+def get(user_id: UUID, name: str) -> None:
     """Read a specific user's merged AppConfig (admin only)."""
 
     async def _run() -> None:
         registry = await create_v2_registry(load_v2_config())
         try:
-            result = await registry.app_config.admin_get(UUID(user_id), name)
+            result = await registry.app_config.admin_get(user_id, name)
             print_result(result)
         finally:
             await registry.close()
@@ -41,7 +41,7 @@ async def _run() -> None:
 @click.option("--limit", type=int, default=None, help="Maximum items to return.")
 @click.option("--offset", type=int, default=None, help="Number of items to skip.")
 @click.option("--name-contains", type=str, default=None, help="Filter `name` by substring.")
-@click.option("--user-id", type=str, default=None, help="Pin to a single user (UUID).")
+@click.option("--user-id", type=click.UUID, default=None, help="Pin to a single user (UUID).")
 @click.option(
     "--order-by",
     multiple=True,
@@ -51,11 +51,11 @@ def search(
     limit: int | None,
     offset: int | None,
     name_contains: str | None,
-    user_id: str | None,
+    user_id: UUID | None,
     order_by: tuple[str, ...],
 ) -> None:
     """Cross-user merged-view search (superadmin only)."""
-    from ai.backend.common.dto.manager.query import StringFilter
+    from ai.backend.common.dto.manager.query import StringFilter, UUIDFilter
     from ai.backend.common.dto.manager.v2.app_config.request import (
         AppConfigFilter,
         AppConfigOrder,
@@ -67,7 +67,7 @@ def search(
     if name_contains is not None or user_id is not None:
         filter_dto = AppConfigFilter(
             name=StringFilter(contains=name_contains) if name_contains is not None else None,
-            user_id=UUID(user_id) if user_id is not None else None,
+            user_id=UUIDFilter(equals=user_id) if user_id is not None else None,
         )
 
     orders = (

src/ai/backend/client/cli/v2/admin/app_config_policy.py

@@ -1,4 +1,4 @@
-"""Admin CLI commands for AppConfigPolicy (bulk-only writes, BEP-1052 §3)."""
+"""Admin CLI commands for AppConfigPolicy (bulk-only writes)."""
 
 from __future__ import annotations
 

src/ai/backend/client/cli/v2/app_config/commands.py

@@ -1,4 +1,4 @@
-"""CLI commands for the merged AppConfig view (BEP-1052 §5).
+"""CLI commands for the merged AppConfig view.
 
 Public entrypoint exposes only the read paths that any authenticated
 user can hit. Self-service writes live under `bai my app-config`;

src/ai/backend/client/cli/v2/my/__init__.py

@@ -90,4 +90,4 @@ def storage_host() -> None:
     name="app-config",
 )
 def app_config() -> None:
-    """My merged AppConfig commands (BEP-1052 §5)."""
+    """My merged AppConfig commands."""

src/ai/backend/client/cli/v2/my/app_config.py

@@ -1,4 +1,4 @@
-"""Self-service CLI commands for the merged AppConfig view (BEP-1052 §5)."""
+"""Self-service CLI commands for the merged AppConfig view."""
 
 from __future__ import annotations
 
@@ -88,8 +88,8 @@ def _load_items(items_arg: str) -> list[dict[str, Any]]:
 def bulk_create(items: str) -> None:
     """Bulk-create USER-scope fragments; returns recomputed merged views."""
     from ai.backend.common.dto.manager.v2.app_config_fragment.request import (
-        BulkCreateMyAppConfigFragmentsInput,
         MyAppConfigFragmentItemInput,
+        MyBulkCreateAppConfigFragmentsInput,
     )
 
     parsed = [MyAppConfigFragmentItemInput.model_validate(item) for item in _load_items(items)]
@@ -98,7 +98,7 @@ async def _run() -> None:
         registry = await create_v2_registry(load_v2_config())
         try:
             result = await registry.app_config.my_bulk_create(
-                BulkCreateMyAppConfigFragmentsInput(items=parsed),
+                MyBulkCreateAppConfigFragmentsInput(items=parsed),
             )
             print_result(result)
         finally:
@@ -116,8 +116,8 @@ async def _run() -> None:
 def bulk_update(items: str) -> None:
     """Bulk-update USER-scope fragments; returns recomputed merged views."""
     from ai.backend.common.dto.manager.v2.app_config_fragment.request import (
-        BulkUpdateMyAppConfigFragmentsInput,
         MyAppConfigFragmentItemInput,
+        MyBulkUpdateAppConfigFragmentsInput,
     )
 
     parsed = [MyAppConfigFragmentItemInput.model_validate(item) for item in _load_items(items)]
@@ -126,7 +126,7 @@ async def _run() -> None:
         registry = await create_v2_registry(load_v2_config())
         try:
             result = await registry.app_config.my_bulk_update(
-                BulkUpdateMyAppConfigFragmentsInput(items=parsed),
+                MyBulkUpdateAppConfigFragmentsInput(items=parsed),
             )
             print_result(result)
         finally:

src/ai/backend/client/v2/domains_v2/app_config.py

@@ -1,4 +1,4 @@
-"""V2 SDK client for the merged AppConfig view (BEP-1052 §5).
+"""V2 SDK client for the merged AppConfig view.
 
 Replaces the legacy upsert-style domain/user app-config SDK; the new
 surface is bulk-only writes against `USER`-scope fragments plus
@@ -15,14 +15,14 @@
     SearchMyAppConfigsInput,
 )
 from ai.backend.common.dto.manager.v2.app_config.response import (
-    BulkCreateMyAppConfigFragmentsPayload,
-    BulkUpdateMyAppConfigFragmentsPayload,
     GetUserAppConfigPayload,
+    MyBulkCreateAppConfigFragmentsPayload,
+    MyBulkUpdateAppConfigFragmentsPayload,
     SearchAppConfigsPayload,
 )
 from ai.backend.common.dto.manager.v2.app_config_fragment.request import (
-    BulkCreateMyAppConfigFragmentsInput,
-    BulkUpdateMyAppConfigFragmentsInput,
+    MyBulkCreateAppConfigFragmentsInput,
+    MyBulkUpdateAppConfigFragmentsInput,
 )
 
 _PATH = "/v2/app-configs"
@@ -67,23 +67,23 @@ async def admin_search(self, request: SearchAppConfigsInput) -> SearchAppConfigs
         )
 
     async def my_bulk_create(
-        self, request: BulkCreateMyAppConfigFragmentsInput
-    ) -> BulkCreateMyAppConfigFragmentsPayload:
+        self, request: MyBulkCreateAppConfigFragmentsInput
+    ) -> MyBulkCreateAppConfigFragmentsPayload:
         """Bulk-create USER-scope fragments; returns recomputed merged views."""
         return await self._client.typed_request(
             "POST",
             f"{_FRAGMENT_PATH}/my/bulk-create",
             request=request,
-            response_model=BulkCreateMyAppConfigFragmentsPayload,
+            response_model=MyBulkCreateAppConfigFragmentsPayload,
         )
 
     async def my_bulk_update(
-        self, request: BulkUpdateMyAppConfigFragmentsInput
-    ) -> BulkUpdateMyAppConfigFragmentsPayload:
+        self, request: MyBulkUpdateAppConfigFragmentsInput
+    ) -> MyBulkUpdateAppConfigFragmentsPayload:
         """Bulk-update USER-scope fragments; returns recomputed merged views."""
         return await self._client.typed_request(
             "POST",
             f"{_FRAGMENT_PATH}/my/bulk-update",
             request=request,
-            response_model=BulkUpdateMyAppConfigFragmentsPayload,
+            response_model=MyBulkUpdateAppConfigFragmentsPayload,
         )

src/ai/backend/client/v2/domains_v2/app_config_fragment.py

@@ -1,4 +1,4 @@
-"""V2 SDK client for the app-config fragment domain (BEP-1052 §2).
+"""V2 SDK client for the app-config fragment domain.
 
 Fragments are an admin-only surface — end users interact with the merged
 ``AppConfig`` view (``V2AppConfigClient``) instead. Self-service
@@ -28,7 +28,7 @@
 class V2AppConfigFragmentClient(BaseDomainClient):
     """SDK client for AppConfigFragment admin operations.
 
-    Writes are bulk-only (BEP-1052 §3).
+    Writes are bulk-only.
     """
 
     async def admin_search(

src/ai/backend/client/v2/domains_v2/app_config_policy.py

@@ -1,4 +1,4 @@
-"""V2 SDK client for the app-config policy domain (BEP-1052 §1).
+"""V2 SDK client for the app-config policy domain.
 
 Policies are an admin-only surface — end users observe their effects
 through the merged ``AppConfig`` view (``V2AppConfigClient``), not by
@@ -25,7 +25,7 @@
 class V2AppConfigPolicyClient(BaseDomainClient):
     """SDK client for AppConfigPolicy admin operations.
 
-    Writes are bulk-only (BEP-1052 §3); single-item create / update /
+    Writes are bulk-only; single-item create / update /
     purge are intentionally absent.
     """
 

src/ai/backend/common/dto/manager/v2/app_config/__init__.py

@@ -11,9 +11,9 @@
 )
 from .response import (
     AppConfigNode,
-    BulkCreateMyAppConfigFragmentsPayload,
-    BulkUpdateMyAppConfigFragmentsPayload,
     GetUserAppConfigPayload,
+    MyBulkCreateAppConfigFragmentsPayload,
+    MyBulkUpdateAppConfigFragmentsPayload,
     SearchAppConfigsPayload,
 )
 from .types import (
@@ -28,8 +28,8 @@
     "AppConfigOrder",
     "AppConfigOrderField",
     "AppConfigScopeType",
-    "BulkCreateMyAppConfigFragmentsPayload",
-    "BulkUpdateMyAppConfigFragmentsPayload",
+    "MyBulkCreateAppConfigFragmentsPayload",
+    "MyBulkUpdateAppConfigFragmentsPayload",
     "GetUserAppConfigInput",
     "GetUserAppConfigPayload",
     "OrderDirection",