feat(BA-5832): AppConfig v2 SDK + CLI (BEP-1052) by jopemachine · Pull Request #11295 · lablup/backend.ai

jopemachine · 2026-04-25T07:35:03Z

📚 Stacked PRs

This PR is part of a 10-PR stack delivering BEP-1052. Merge in order:

⬇️ chore(BA-5822): drop legacy AppConfig layer (preparation for BEP-1052) #11265 — chore(BA-5822): drop legacy AppConfig layer
⬇️ feat(BA-5814): AppConfigPolicy foundation (data / repository / service / adapter, bulk-aware) #11266 — feat(BA-5814): AppConfigPolicy foundation
⬇️ feat(BA-5815): AppConfigPolicy GraphQL #11269 — feat(BA-5815): AppConfigPolicy GraphQL
⬇️ feat(BA-5844): AppConfigPolicy REST v2 surface #11312 — feat(BA-5844): AppConfigPolicy REST v2
⬇️ feat(BA-5827): AppConfigFragment foundation (DB + repository + errors) #11282 — feat(BA-5827): AppConfigFragment foundation
⬇️ feat(BA-5836): AppConfigFragment service vertical (service / DTO / adapter) #11296 — feat(BA-5836): AppConfigFragment service vertical
⬇️ feat(BA-5829): AppConfigFragment + AppConfig GraphQL #11285 — feat(BA-5829): AppConfigFragment + AppConfig GraphQL
⬇️ feat(BA-5830): AppConfigFragment + AppConfig REST v2 #11286 — feat(BA-5830): AppConfigFragment + AppConfig REST v2
👉 feat(BA-5832): AppConfig v2 SDK + CLI (BEP-1052) #11295 — feat(BA-5832): AppConfig v2 SDK + CLI ← you are here
⬇️ feat(BA-5837): ValkeyCache for AppConfigFragment merged-view reads #11298 — feat(BA-5837): ValkeyCache for AppConfigFragment merged-view reads

CI on intermediate PRs may show test churn since each one only lands a slice of the new layer. The full picture is guaranteed to build at the tip (#11298).

Summary

Adds the v2 SDK + v2 CLI surface for the three AppConfig entities introduced in BEP-1052.

SDK (`client/v2/domains_v2/`)

Client	Methods
`V2AppConfigPolicyClient` (new)	`get` / `search` / `admin_bulk_create` / `admin_bulk_update` / `admin_bulk_purge`
`V2AppConfigFragmentClient` (new)	`get` (POST + body key) / `scope_search` / `admin_search` / `admin_bulk_create` / `admin_bulk_update` / `admin_bulk_purge`
`V2AppConfigClient` (rewritten)	`my_get` / `my_search` / `admin_get` / `admin_search` / `my_bulk_create` / `my_bulk_update`

The legacy V2AppConfigClient (upsert_* / delete_* for domain / user) is replaced — its backing endpoints were dropped in #11265.

All three clients are registered as @cached_property on V2ClientRegistry.

CLI (`client/cli/v2/`)

Group	Commands
`bai v2 app-config-policy`	`get`, `search`
`bai v2 admin app-config-policy`	`bulk-create`, `bulk-update`, `bulk-purge`
`bai v2 app-config-fragment`	`get`, `scope-search`
`bai v2 admin app-config-fragment`	`search`, `bulk-create`, `bulk-update`, `bulk-purge`
`bai v2 app-config`	`my-get`
`bai v2 my app-config`	`search`, `bulk-create`, `bulk-update`
`bai v2 admin app-config`	`get`, `search`

Legacy bai v2 app-config get-domain / delete-domain / get-user / delete-user / get-merged are removed — their endpoints are gone post #11265.

Bulk write commands accept JSON list inputs via --items / --keys / --config-names, with @path/to/file.json shorthand:

bai v2 admin app-config-policy bulk-create --items '[{"config_name":"theme","scope_sources":["public","user"]}]'
bai v2 admin app-config-fragment bulk-purge --keys @keys.json
bai v2 my app-config bulk-update --items @my-fragments.json

Resolves BA-5832.

📚 Documentation preview 📚: https://sorna--11295.org.readthedocs.build/en/11295/

📚 Documentation preview 📚: https://sorna-ko--11295.org.readthedocs.build/ko/11295/

Extends the legacy-AppConfig drop to the client side: - `client/v2/domains_v2/app_config.py` — `V2AppConfigClient` with `upsert_domain_config` / `delete_user_config` / etc. is removed alongside its `v2_registry` `@cached_property` wiring. - `client/cli/v2/app_config/` — legacy `./bai app-config get-domain`, `upsert-user`, etc. are removed from the CLI tree. - `common/dto/manager/v2/app_config/` — legacy DTO module (`UpsertDomainConfigInput`, `DeleteUserConfigPayload`, ...) is deleted. Per #11295 review: BEP-1052's new SDK / CLI / DTO surfaces will land in their own PRs and should not also have to repeal the legacy versions there.

…ed AppConfig SDK (`client/v2/domains_v2/`): - New `V2AppConfigPolicyClient` — `get`, `search`, `admin_bulk_create / update / purge` (BEP-1052 §3, bulk-only writes). - New `V2AppConfigFragmentClient` — `get` (POST /get with body-key), `scope_search`, `admin_search`, `admin_bulk_create / update / purge`. - Replace legacy `V2AppConfigClient` with the merged-view (BEP-1052 §5) surface — `my_get`, `my_search`, `admin_get`, `admin_search`, `my_bulk_create / update`. Old `upsert_*` / `delete_*` paths are removed (their backing endpoints were dropped in BA-5822). - Register all three clients in `V2ClientRegistry`. CLI (`client/cli/v2/`): - `bai v2 app-config-policy` — `get`, `search`. - `bai v2 admin app-config-policy` — `bulk-create / update / purge`, with `--items '{json}'` or `@file.json`. - `bai v2 app-config-fragment` — `get`, `scope-search`. - `bai v2 admin app-config-fragment` — `search`, `bulk-create / update / purge`. - `bai v2 app-config` (merged-view) — `my-get`. - `bai v2 my app-config` — `search`, `bulk-create`, `bulk-update`. - `bai v2 admin app-config` — `get`, `search`. - Replace the legacy `bai v2 app-config` commands (`get-domain` / `delete-domain` / `get-user` / `delete-user` / `get-merged`) — those REST endpoints are gone post BA-5822. All bulk write commands accept JSON list inputs via `--items` / `--keys` / `--config-names`, with `@path/to/file.json` shorthand for file-loaded payloads. The CLI surface follows `bai admin {entity}` for superadmin-only operations, `bai my {entity}` for self-service writes that act on the caller's own data, and `bai {entity}` for any-authenticated-user reads — mirrors the manager-side adapter convention. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

End users only interact with the merged AppConfig view (`my_get`, `my_search` on `V2AppConfigClient`); raw fragment / policy reads were just an API mirror without convention support. Removes: - SDK `V2AppConfigFragmentClient.get` / `.scope_search` (the latter did not match the per-scope `{scope}_search()` convention used by `user.py`, `session.py`, `vfolder.py`, etc.) - SDK `V2AppConfigPolicyClient.get` / `.search` - CLI groups `./bai app-config-fragment` and `./bai app-config-policy` Admin surface (`admin_search`, `admin_bulk_*`) is unchanged — both clients keep the methods their `admin/` CLI counterparts call.

`list[dict]` was missing the value type parameter and `json.loads` returns `Any`, so mypy flagged 9 type-arg / no-any-return errors. Use `list[dict[str, Any]]` and `cast()` to keep CLAUDE.md's no-`# type: ignore` rule. Also picks up a stale BA-5829 ruff format on Fragment node.py from the JSON-scalar fix cascade.

… 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>

…le GQL leftovers The CLI helptext (`bulk-create` / `bulk-update`) and a few GQL type fields still referenced `extra_config`; align them with the column rename. Also refresh the schema dump for the residual `extraConfig` fields. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

…eyed Track BA-5814 / BA-5815 / BA-5844 DTO refactor: • Use AdminAppConfigPolicyCreateItemInput for bulk-create. • Use AdminAppConfigPolicyUpdateItemInput (id + scope_sources) for bulk-update. • bulk-purge takes --ids (UUID list) instead of --config-names.

github-actions Bot assigned jopemachine Apr 25, 2026

github-actions Bot added size:XL 500~ LoC area:docs Documentations comp:manager Related to Manager component comp:client Related to Client component comp:cli Related to CLI component labels Apr 25, 2026

jopemachine added a commit that referenced this pull request Apr 25, 2026

chore(BA-5832): add news fragment for #11295

eeb51c2

jopemachine marked this pull request as draft April 25, 2026 07:37

jopemachine commented Apr 25, 2026

View reviewed changes

Comment thread changes/11269.feature.md

jopemachine commented Apr 25, 2026

View reviewed changes

Comment thread docs/manager/graphql-reference/supergraph.graphql

jopemachine added a commit that referenced this pull request Apr 25, 2026

chore(BA-5832): add news fragment for #11295

a0bcd11

jopemachine force-pushed the BA-5832 branch from eeb51c2 to a0bcd11 Compare April 25, 2026 07:40

jopemachine commented Apr 25, 2026

View reviewed changes

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

jopemachine force-pushed the BA-5830 branch from 89dda73 to 40ff71d Compare April 25, 2026 08:20

jopemachine added a commit that referenced this pull request Apr 25, 2026

chore(BA-5832): add news fragment for #11295

efc9f50

jopemachine force-pushed the BA-5832 branch from 74d2366 to f6f84c8 Compare April 25, 2026 08:24

jopemachine force-pushed the BA-5830 branch from 40ff71d to 537352d Compare April 25, 2026 08:30

jopemachine added a commit that referenced this pull request Apr 25, 2026

chore(BA-5832): add news fragment for #11295

ea7a0f3

jopemachine force-pushed the BA-5832 branch from f6f84c8 to 0dc29cd Compare April 25, 2026 08:30

jopemachine force-pushed the BA-5830 branch from 537352d to 5c68a95 Compare April 25, 2026 08:37

jopemachine added a commit that referenced this pull request Apr 25, 2026

chore(BA-5832): add news fragment for #11295

b791d60

jopemachine force-pushed the BA-5832 branch from 0dc29cd to 55dff76 Compare April 25, 2026 08:38

jopemachine force-pushed the BA-5830 branch from 5c68a95 to 418b748 Compare April 25, 2026 08:50

jopemachine added a commit that referenced this pull request Apr 25, 2026

chore(BA-5832): add news fragment for #11295

96584fd

jopemachine force-pushed the BA-5832 branch from 30103b2 to 04313c9 Compare April 25, 2026 08:52

jopemachine force-pushed the BA-5830 branch from 418b748 to 352078e Compare April 25, 2026 09:12

jopemachine added a commit that referenced this pull request Apr 25, 2026

chore(BA-5832): add news fragment for #11295

caa87f7

jopemachine force-pushed the BA-5832 branch from 04313c9 to 0cce0fe Compare April 25, 2026 09:13

jopemachine force-pushed the BA-5830 branch from 346b820 to 9ff24a6 Compare April 25, 2026 09:25

jopemachine commented Apr 26, 2026

View reviewed changes

Comment thread src/ai/backend/client/cli/v2/my/app_config.py Outdated

jopemachine force-pushed the BA-5830 branch from 25a47cb to df892f3 Compare April 26, 2026 12:09

jopemachine added a commit that referenced this pull request Apr 26, 2026

chore(BA-5832): add news fragment for #11295

fd50af7

jopemachine force-pushed the BA-5832 branch from fe754bf to 2ccb8b8 Compare April 26, 2026 12:09

jopemachine force-pushed the BA-5830 branch from df892f3 to a627141 Compare April 26, 2026 12:28

jopemachine force-pushed the BA-5832 branch from 2ccb8b8 to 0a7c615 Compare April 26, 2026 12:29

jopemachine added a commit that referenced this pull request Apr 26, 2026

chore(BA-5832): add news fragment for #11295

35f551e

jopemachine force-pushed the BA-5830 branch from 6a2e4b6 to f2a5a98 Compare April 26, 2026 12:56

jopemachine added a commit that referenced this pull request Apr 26, 2026

chore(BA-5832): add news fragment for #11295

47e8efe

jopemachine force-pushed the BA-5832 branch from 907c117 to d3191d2 Compare April 26, 2026 13:01

jopemachine mentioned this pull request Apr 26, 2026

feat(BA-5844): AppConfigPolicy REST v2 surface #11312

Draft

3 tasks

jopemachine force-pushed the BA-5830 branch from 1b82cdd to d03c5de Compare April 26, 2026 13:21

jopemachine added a commit that referenced this pull request Apr 26, 2026

chore(BA-5832): add news fragment for #11295

58fefa0

jopemachine force-pushed the BA-5832 branch from cd8fb4f to d98af50 Compare April 26, 2026 13:22

jopemachine force-pushed the BA-5830 branch from d03c5de to 4e29e4a Compare April 27, 2026 02:01

jopemachine added a commit that referenced this pull request Apr 27, 2026

chore(BA-5832): add news fragment for #11295

78ebd21

jopemachine force-pushed the BA-5832 branch from d98af50 to d5a4710 Compare April 27, 2026 02:03

jopemachine force-pushed the BA-5830 branch from 4e29e4a to d38f451 Compare April 27, 2026 02:11

jopemachine added a commit that referenced this pull request Apr 27, 2026

chore(BA-5832): add news fragment for #11295

223f7bf

jopemachine force-pushed the BA-5832 branch from d5a4710 to 365eaa8 Compare April 27, 2026 02:13

jopemachine force-pushed the BA-5830 branch from d38f451 to 85d0da0 Compare April 27, 2026 02:44

jopemachine and others added 8 commits April 27, 2026 11:45

chore(BA-5832): add news fragment for #11295

c7a59cc

chore(BA-5832): drop BEP-1052 ref from 11295 news fragment

12c9edf

jopemachine force-pushed the BA-5832 branch from 365eaa8 to e6ad6e5 Compare April 27, 2026 02:46

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

feat(BA-5832): AppConfig v2 SDK + CLI (BEP-1052)#11295

feat(BA-5832): AppConfig v2 SDK + CLI (BEP-1052)#11295
jopemachine wants to merge 8 commits intoBA-5830from
BA-5832

jopemachine commented Apr 25, 2026 •

edited

Loading

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

1 participant

Conversation

jopemachine commented Apr 25, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

📚 Stacked PRs

Summary

SDK (client/v2/domains_v2/)

CLI (client/cli/v2/)

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

1 participant

jopemachine commented Apr 25, 2026 •

edited

Loading

SDK (`client/v2/domains_v2/`)

CLI (`client/cli/v2/`)