feat(BA-5829): add AppConfigFragment + AppConfig GQL surface

Adds the GraphQL exposure for AppConfigFragment and the merged
AppConfig view (BEP-1052 §2 / §5).

Service / processor additions (only what the GQL layer needs that is
not already in BA-5827):
- Merged-view actions: get_user_app_config, search_user_app_configs,
  admin_search_app_configs (single-row + paginated reads of the
  computed AppConfig view).
- Service methods + processor wiring + supported_actions for those
  three actions.

Adapter additions:
- Merged-view methods: get_user_app_config / my_app_configs /
  admin_search_app_configs / public_app_config_fragments. `my_*`
  pulls the user from current_user() inside the adapter.
- Bulk-only `my` mutations: my_bulk_create / my_bulk_update —
  bulk admin variants are wired in BA-5827 already.

DTO additions:
- common/dto/manager/v2/app_config/* — AppConfigNode,
  GetUserAppConfigInput / Payload, SearchAppConfigsInput / Payload,
  SearchMyAppConfigsInput, BulkCreate/UpdateMyAppConfigFragmentsPayload
  (the my-bulk payloads live here because they carry AppConfigNode).

GraphQL:
- app_config package: AppConfigGQL, my/admin/public root resolvers.
- app_config_fragment package: scope-bound + admin queries, bulk-only
  mutations (admin + my variants), AppConfigFragmentGQL +
  AppConfigScopeTypeGQL + filter/order/key inputs.
- DataLoader: app_config_fragment_loader for N+1 batching.
- schema.py: register the new root queries / mutations.

Resolves BA-5829.

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

Author: jopemachine

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

@@ -1,5 +1,5 @@
 """
-AppConfig (merged view) DTOs v2 for Manager API.
+AppConfig (merged view) DTOs v2 for Manager API (BEP-1052 §5).
 """
 
 from .request import (
@@ -11,9 +11,9 @@
 )
 from .response import (
     AppConfigNode,
+    BulkCreateMyAppConfigFragmentsPayload,
+    BulkUpdateMyAppConfigFragmentsPayload,
     GetUserAppConfigPayload,
-    MyBulkCreateAppConfigFragmentsPayload,
-    MyBulkUpdateAppConfigFragmentsPayload,
     SearchAppConfigsPayload,
 )
 from .types import (
@@ -28,8 +28,8 @@
     "AppConfigOrder",
     "AppConfigOrderField",
     "AppConfigScopeType",
-    "MyBulkCreateAppConfigFragmentsPayload",
-    "MyBulkUpdateAppConfigFragmentsPayload",
+    "BulkCreateMyAppConfigFragmentsPayload",
+    "BulkUpdateMyAppConfigFragmentsPayload",
     "GetUserAppConfigInput",
     "GetUserAppConfigPayload",
     "OrderDirection",

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

@@ -1,5 +1,5 @@
 """
-Request DTOs for AppConfig (merged view) DTO v2.
+Request DTOs for AppConfig (merged view) DTO v2 (BEP-1052 §5).
 """
 
 from __future__ import annotations
@@ -62,7 +62,7 @@ class SearchMyAppConfigsInput(_AppConfigSearchInputBase):
     """Input for self-service merged-view search (`/v2/app-configs/my/search`).
 
     The adapter pins the caller as the user scope; no `user_id` argument
-    is accepted here.
+    is accepted here (BEP-1052 §5 — `filter.userId` is ignored).
     """
 
 

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

@@ -1,5 +1,5 @@
 """
-Response DTOs for AppConfig (merged view) DTO v2.
+Response DTOs for AppConfig (merged view) DTO v2 (BEP-1052 §5).
 """
 
 from __future__ import annotations
@@ -17,15 +17,15 @@
 
 __all__ = (
     "AppConfigNode",
-    "MyBulkCreateAppConfigFragmentsPayload",
-    "MyBulkUpdateAppConfigFragmentsPayload",
+    "BulkCreateMyAppConfigFragmentsPayload",
+    "BulkUpdateMyAppConfigFragmentsPayload",
     "GetUserAppConfigPayload",
     "SearchAppConfigsPayload",
 )
 
 
 class AppConfigNode(BaseResponseModel):
-    """Merged per-user AppConfig view.
+    """Merged per-user AppConfig view (BEP-1052 §5).
 
     `fragments` are ordered low → high merge priority (matching the
     policy's `scope_sources`). `config` is the deep-merged result,
@@ -62,11 +62,11 @@ class SearchAppConfigsPayload(BaseResponseModel):
     has_previous_page: bool = Field(default=False, description="Whether there is a previous page.")
 
 
-class MyBulkCreateAppConfigFragmentsPayload(BaseResponseModel):
-    """Payload for `myBulkCreateAppConfigFragments`.
+class BulkCreateMyAppConfigFragmentsPayload(BaseResponseModel):
+    """Payload for `bulkCreateMyAppConfigFragments`.
 
     Each successfully created row produces a recomputed merged
-    `AppConfigNode`; failures are collected per-item.
+    `AppConfigNode`; failures are collected per-item (BEP-1052 §3).
     """
 
     created: list[AppConfigNode] = Field(
@@ -75,8 +75,8 @@ class MyBulkCreateAppConfigFragmentsPayload(BaseResponseModel):
     failed: list[AppConfigFragmentBulkError] = Field(description="Per-item failures.")
 
 
-class MyBulkUpdateAppConfigFragmentsPayload(BaseResponseModel):
-    """Payload for `myBulkUpdateAppConfigFragments`."""
+class BulkUpdateMyAppConfigFragmentsPayload(BaseResponseModel):
+    """Payload for `bulkUpdateMyAppConfigFragments`."""
 
     updated: list[AppConfigNode] = Field(
         description="Recomputed merged AppConfig views for each updated USER fragment.",

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

@@ -1,5 +1,5 @@
 """
-Common types for AppConfig (merged view) DTO v2.
+Common types for AppConfig (merged view) DTO v2 (BEP-1052 §5).
 """
 
 from __future__ import annotations

src/ai/backend/manager/api/adapters/app_config_fragment.py

@@ -52,6 +52,8 @@
 from ai.backend.common.dto.manager.v2.app_config_fragment.types import (
     AppConfigScopeType as DTOAppConfigScopeType,
 )
+from ai.backend.common.dto.manager.v2.app_config_fragment.types import OrderDirection
+from ai.backend.common.exception import UnreachableError
 from ai.backend.manager.api.adapter_options.pagination.pagination import PaginationSpec
 from ai.backend.manager.data.app_config.types import AppConfigData
 from ai.backend.manager.data.app_config_fragment.bulk_types import (
@@ -110,10 +112,8 @@
 class AppConfigFragmentAdapter(BaseAdapter):
     """Adapter for AppConfigFragment raw-row operations.
 
-    Writes are bulk-only; single-item create / update /
-    purge entry points are intentionally absent. Self-service my_bulk
-    writes (which return the recomputed merged view) live on
-    `AppConfigAdapter` alongside the merged-view reads.
+    Writes are bulk-only (BEP-1052 §3); single-item create / update /
+    purge entry points are intentionally absent.
     """
 
     async def get(self, key_input: AppConfigFragmentKeyInput) -> GetAppConfigFragmentPayload:
@@ -265,7 +265,143 @@ def _data_to_dto(data: AppConfigFragmentData) -> AppConfigFragmentNode:
             updated_at=data.updated_at,
         )
 
-    # ── Bulk mutations ───────────────────────────────
+    # ── Merged-view (AppConfig, BEP-1052 §5) ───────────────────────
+
+    async def my_app_config(self, name: str) -> GetUserAppConfigPayload:
+        """Read the caller's own merged AppConfig for `name`.
+
+        Resolves the current user from the context; there is no way to
+        target another user through this method.
+        """
+        me = current_user()
+        if me is None:
+            raise UnreachableError("User context is not available")
+        result = await self._processors.app_config_fragment.get_user_app_config.wait_for_complete(
+            GetUserAppConfigAction(user_id=me.user_id, config_name=name)
+        )
+        return GetUserAppConfigPayload(item=self._app_config_data_to_dto(result.app_config))
+
+    async def admin_get_user_app_config(
+        self, input: GetUserAppConfigInput
+    ) -> GetUserAppConfigPayload:
+        """Read a specific user's merged AppConfig (admin only)."""
+        result = await self._processors.app_config_fragment.get_user_app_config.wait_for_complete(
+            GetUserAppConfigAction(user_id=input.user_id, config_name=input.name)
+        )
+        return GetUserAppConfigPayload(item=self._app_config_data_to_dto(result.app_config))
+
+    async def my_search_app_configs(
+        self, input: SearchMyAppConfigsInput
+    ) -> SearchAppConfigsPayload:
+        """Paginated merged-view search over the caller's own AppConfigs."""
+        me = current_user()
+        if me is None:
+            raise UnreachableError("User context is not available")
+        querier = self._build_app_config_querier(input)
+        result = (
+            await self._processors.app_config_fragment.search_user_app_configs.wait_for_complete(
+                SearchUserAppConfigsAction(
+                    scope=UserAppConfigSearchScope(user_id=me.user_id),
+                    querier=querier,
+                )
+            )
+        )
+        return SearchAppConfigsPayload(
+            items=[self._app_config_data_to_dto(item) for item in result.items],
+            total_count=result.total_count,
+            has_next_page=result.has_next_page,
+            has_previous_page=result.has_previous_page,
+        )
+
+    async def admin_search_app_configs(
+        self, input: SearchAppConfigsInput
+    ) -> SearchAppConfigsPayload:
+        """Cross-user merged-view search (admin only).
+
+        `filter.user_id` pins the query to a single user; otherwise
+        pagination walks across every user.
+        """
+        querier = self._build_app_config_querier(input)
+        result = (
+            await self._processors.app_config_fragment.admin_search_app_configs.wait_for_complete(
+                AdminSearchAppConfigsAction(querier=querier)
+            )
+        )
+        return SearchAppConfigsPayload(
+            items=[self._app_config_data_to_dto(item) for item in result.items],
+            total_count=result.total_count,
+            has_next_page=result.has_next_page,
+            has_previous_page=result.has_previous_page,
+        )
+
+    def _build_app_config_querier(
+        self,
+        input: SearchMyAppConfigsInput | SearchAppConfigsInput,
+    ) -> BatchQuerier:
+        """Querier builder shared by `my_search_app_configs` and
+        `admin_search_app_configs`.
+
+        The merged-view SQL resolves cursor/order internally via the
+        repository layer; this helper forwards only the filter / order /
+        pagination fields so cursor tiebreakers stay consistent with
+        the raw-fragment querier.
+        """
+        conditions = self._convert_app_config_filter(input.filter) if input.filter else []
+        orders = self._convert_app_config_orders(input.order) if input.order else []
+        return self._build_querier(
+            conditions=conditions,
+            orders=orders,
+            pagination_spec=self._PAGINATION_SPEC,
+            first=input.first,
+            after=input.after,
+            last=input.last,
+            before=input.before,
+            limit=input.limit,
+            offset=input.offset,
+        )
+
+    def _convert_app_config_filter(self, filter: AppConfigFilter) -> list[QueryCondition]:
+        conditions: list[QueryCondition] = []
+        if filter.name is not None:
+            condition = self.convert_string_filter(
+                filter.name,
+                contains_factory=AppConfigFragmentConditions.by_name_contains,
+                equals_factory=AppConfigFragmentConditions.by_name_equals,
+                starts_with_factory=AppConfigFragmentConditions.by_name_starts_with,
+                ends_with_factory=AppConfigFragmentConditions.by_name_ends_with,
+                in_factory=AppConfigFragmentConditions.by_name_in,
+            )
+            if condition is not None:
+                conditions.append(condition)
+        # `filter.user_id` handling lives inside the merged-view SQL
+        # (repository layer) rather than in a BatchQuerier condition —
+        # see `AppConfigFragmentDBSource.admin_search_app_configs`.
+        return conditions
+
+    @staticmethod
+    def _convert_app_config_orders(orders: list[AppConfigOrder]) -> list[QueryOrder]:
+        result: list[QueryOrder] = []
+        for order in orders:
+            ascending = order.direction == OrderDirection.ASC
+            match order.field:
+                case AppConfigOrderField.NAME:
+                    result.append(AppConfigFragmentOrders.name(ascending))
+                case AppConfigOrderField.USER_ID:
+                    # USER_ID ordering is applied inside the merged-view SQL
+                    # because the raw `app_config_fragments` row does not
+                    # carry a user_id column directly.
+                    continue
+        return result
+
+    def _app_config_data_to_dto(self, data: AppConfigData) -> AppConfigNode:
+        return AppConfigNode(
+            user_id=data.user_id,
+            name=data.name,
+            fragments=[self._data_to_dto(fragment) for fragment in data.fragments],
+            config=dict(data.config) if data.config is not None else None,
+        )
+
+    # ── Bulk mutations (BEP-1052 §3) ───────────────────────────────
     #
     # Each bulk processor returns a `BulkProcessResult[T]` whose
     # `.result` field is the underlying `*ActionResult` produced by the

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

@@ -1,4 +1,4 @@
-"""AppConfig (merged view) GraphQL API package."""
+"""AppConfig (merged view) GraphQL API package (BEP-1052 §5)."""
 
 from .resolver import (
     admin_app_configs,

src/ai/backend/manager/api/gql/app_config/resolver/query.py

@@ -1,4 +1,4 @@
-"""AppConfig (merged view) GQL query resolvers."""
+"""AppConfig (merged view) GQL query resolvers (BEP-1052 §5)."""
 
 from __future__ import annotations
 
@@ -36,7 +36,7 @@
         added_version=NEXT_RELEASE_VERSION,
         description=(
             "Caller's own merged AppConfig list (auth required). Chain per policy "
-            "; the adapter pins `(USER, current_user)` internally."
+            "(BEP-1052 §5); the adapter pins `(USER, current_user)` internally."
         ),
     )
 )  # type: ignore[misc]
@@ -108,7 +108,7 @@ async def admin_app_configs(
         added_version=NEXT_RELEASE_VERSION,
         description=(
             "Public (no-auth) `PUBLIC`-scope app-config fragments — the subset of "
-            "raw fragments that carry no personally-scoped data."
+            "raw fragments that carry no personally-scoped data (BEP-1052 §3)."
         ),
     )
 )  # type: ignore[misc]

src/ai/backend/manager/api/gql/app_config/types/__init__.py

@@ -1,7 +1,3 @@
-from .bulk_payloads import (
-    MyBulkCreateAppConfigFragmentsPayloadGQL,
-    MyBulkUpdateAppConfigFragmentsPayloadGQL,
-)
 from .filters import (
     AppConfigFilterGQL,
     AppConfigOrderByGQL,
@@ -14,6 +10,4 @@
     "AppConfigGQL",
     "AppConfigOrderByGQL",
     "AppConfigOrderFieldGQL",
-    "MyBulkCreateAppConfigFragmentsPayloadGQL",
-    "MyBulkUpdateAppConfigFragmentsPayloadGQL",
 ]

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

@@ -1,4 +1,4 @@
-"""AppConfig (merged view) GQL output types."""
+"""AppConfig (merged view) GQL output types (BEP-1052 §5)."""
 
 from __future__ import annotations
 
@@ -22,7 +22,7 @@
     BackendAIGQLMeta(
         added_version=NEXT_RELEASE_VERSION,
         description=(
-            "Merged per-user AppConfig view. `fragments` are ordered "
+            "Merged per-user AppConfig view (BEP-1052 §5). `fragments` are ordered "
             "low → high merge priority; `config` is the deep-merge result and is "
             "null when every contributing fragment is empty."
         ),

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

@@ -6,8 +6,9 @@
     admin_bulk_purge_app_config_fragments,
     admin_bulk_update_app_config_fragments,
     app_config_fragment,
-    my_bulk_create_app_config_fragments,
-    my_bulk_update_app_config_fragments,
+    bulk_create_my_app_config_fragments,
+    bulk_update_my_app_config_fragments,
+    scoped_app_config_fragments,
 )
 from .types import (
     AppConfigFragmentFilterGQL,
@@ -19,16 +20,16 @@
 )
 
 __all__ = [
-    # Queries — scope-bound list belongs on DomainV2 / UserV2 child fields
+    # Queries
     "app_config_fragment",
     "scoped_app_config_fragments",
     "admin_app_config_fragments",
-    # Bulk mutations
+    # Bulk mutations (BEP-1052 §3 — bulk-only)
     "admin_bulk_create_app_config_fragments",
     "admin_bulk_update_app_config_fragments",
     "admin_bulk_purge_app_config_fragments",
-    "my_bulk_create_app_config_fragments",
-    "my_bulk_update_app_config_fragments",
+    "bulk_create_my_app_config_fragments",
+    "bulk_update_my_app_config_fragments",
     # Types
     "AppConfigFragmentGQL",
     "AppConfigScopeTypeGQL",