refactor(BA-5815): drop BEP refs from AppConfigPolicy GQL/REST surface

Strip `BEP-1052 §X` mentions from docstrings, comments, and inline
notes across the GQL resolver / types and the REST v2 handler /
registry. News fragment retains the BEP wording.

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

Author: jopemachine

src/ai/backend/manager/api/gql/app_config_policy/__init__.py

@@ -18,7 +18,7 @@
     # Queries
     "app_config_policy",
     "app_config_policies",
-    # Bulk mutations (BEP-1052 §3 — bulk-only)
+    # Bulk mutations (bulk-only)
     "admin_bulk_create_app_config_policies",
     "admin_bulk_update_app_config_policies",
     "admin_bulk_purge_app_config_policies",

src/ai/backend/manager/api/gql/app_config_policy/resolver/mutation.py

@@ -1,4 +1,4 @@
-"""AppConfigPolicy GQL mutation resolvers (bulk-only, BEP-1052 §3)."""
+"""AppConfigPolicy GQL mutation resolvers (bulk-only)."""
 
 from __future__ import annotations
 
@@ -40,8 +40,7 @@ async def admin_bulk_create_app_config_policies(
     BackendAIGQLMeta(
         added_version=NEXT_RELEASE_VERSION,
         description=(
-            "Replace `scope_sources`; `config_name` is immutable (BEP-1052 §1). "
-            "Admin only, per-item transaction."
+            "Replace `scope_sources`; `config_name` is immutable. Admin only, per-item transaction."
         ),
     )
 )
@@ -58,8 +57,7 @@ async def admin_bulk_update_app_config_policies(
     BackendAIGQLMeta(
         added_version=NEXT_RELEASE_VERSION,
         description=(
-            "Rejects items whose `config_name` still has referencing fragment rows "
-            "(BEP-1052 §1). Admin only."
+            "Rejects items whose `config_name` still has referencing fragment rows. Admin only."
         ),
     )
 )

src/ai/backend/manager/api/gql/app_config_policy/types/bulk_inputs.py

@@ -1,4 +1,4 @@
-"""AppConfigPolicy bulk-mutation GQL input types (BEP-1052 §3)."""
+"""AppConfigPolicy bulk-mutation GQL input types."""
 
 from __future__ import annotations
 

src/ai/backend/manager/api/gql/app_config_policy/types/bulk_payloads.py

@@ -1,4 +1,4 @@
-"""AppConfigPolicy bulk-mutation GQL payload types (BEP-1052 §3)."""
+"""AppConfigPolicy bulk-mutation GQL payload types."""
 
 from __future__ import annotations
 

src/ai/backend/manager/api/gql/app_config_policy/types/node.py

@@ -21,7 +21,7 @@
 @gql_node_type(
     BackendAIGQLMeta(
         added_version=NEXT_RELEASE_VERSION,
-        description="Scoped app-config policy (BEP-1052 §1).",
+        description="Scoped app-config policy.",
     ),
     name="AppConfigPolicy",
 )

src/ai/backend/manager/api/gql/schema.py

@@ -790,7 +790,7 @@ class Mutation:
     admin_unblock_user = admin_unblock_user
     # IP allowlist self-service mutation
     update_my_allowed_client_ip = update_my_allowed_client_ip
-    # App Config Policy - Bulk admin mutations (BEP-1052 §3 — bulk-only)
+    # App Config Policy - Bulk admin mutations (bulk-only)
     admin_bulk_create_app_config_policies = admin_bulk_create_app_config_policies
     admin_bulk_update_app_config_policies = admin_bulk_update_app_config_policies
     admin_bulk_purge_app_config_policies = admin_bulk_purge_app_config_policies

src/ai/backend/manager/api/rest/v2/app_config_policy/handler.py

@@ -1,8 +1,8 @@
-"""REST v2 handler for the app-config policy domain (BEP-1052 §4).
+"""REST v2 handler for the app-config policy domain.
 
-Writes are **bulk-only** per BEP §3 — the single-item create / update /
-purge endpoints were removed in favour of `/bulk-create`,
-`/bulk-update`, `/bulk-purge` (admin-only).
+Writes are **bulk-only** — the single-item create / update / purge
+endpoints were removed in favour of `/bulk-create`, `/bulk-update`,
+`/bulk-purge` (admin-only).
 """
 
 from __future__ import annotations
@@ -51,7 +51,7 @@ async def search(
         result = await self._adapter.search(body.parsed)
         return APIResponse.build(status_code=HTTPStatus.OK, response_model=result)
 
-    # ── Admin bulk writes (BEP-1052 §3) ──────────────────────────
+    # ── Admin bulk writes ────────────────────────────────────────
 
     async def admin_bulk_create(
         self,

src/ai/backend/manager/api/rest/v2/app_config_policy/registry.py

@@ -1,4 +1,4 @@
-"""Route registration for v2 app-config policy endpoints (BEP-1052 §4)."""
+"""Route registration for v2 app-config policy endpoints."""
 
 from __future__ import annotations
 
@@ -17,18 +17,18 @@ def register_v2_app_config_policy_routes(
     handler: V2AppConfigPolicyHandler,
     route_deps: RouteDeps,
 ) -> RouteRegistry:
-    """Register all v2 app-config policy routes (BEP-1052 §4).
+    """Register all v2 app-config policy routes.
 
     Reads (`GET /{config_name}`, `POST /search`) are available to any
-    authenticated user. Writes are bulk-only and admin-only per BEP
-    §3 — `/bulk-create`, `/bulk-update`, `/bulk-purge`.
+    authenticated user. Writes are bulk-only and admin-only —
+    `/bulk-create`, `/bulk-update`, `/bulk-purge`.
     """
     reg = RouteRegistry.create("app-config-policies", route_deps.cors_options)
 
     # Reads
     reg.add("POST", "/search", handler.search, middlewares=[auth_required])
     reg.add("GET", "/{config_name}", handler.get, middlewares=[auth_required])
-    # Admin bulk writes (BEP-1052 §3)
+    # Admin bulk writes
     reg.add("POST", "/bulk-create", handler.admin_bulk_create, middlewares=[superadmin_required])
     reg.add("POST", "/bulk-update", handler.admin_bulk_update, middlewares=[superadmin_required])
     reg.add("POST", "/bulk-purge", handler.admin_bulk_purge, middlewares=[superadmin_required])