The Apps, Services, Users, and Groups admin panels already surface their
dependency counts inline so admins know what's affected before clicking.
The Roles panel previously hid this — admins had to open the delete dialog
to see how many users/groups would be affected. This change adds the same
inline display to the Roles panel for consistency.
Changes
- lib/api-spec/openapi.yaml: Added optional `userCount` and `groupCount`
fields to the `Role` schema (matching the App pattern: optional, populated
only by the admin list endpoint, with descriptive comments).
- artifacts/api-server/src/routes/roles.ts: GET /roles now batches two
grouped count queries (user_roles, group_roles) and merges the counts
into each list item — same shape as GET /apps. Empty-list short-circuits
before running the aggregations.
- lib/api-zod/src/generated/api.ts: Regenerated via the api-spec codegen
script (orval). ListRolesResponseItem now includes the optional counts.
- artifacts/tx-os/src/pages/admin.tsx (RolesPanel): Each role card renders
an inline counts row using the existing `admin.roles.usersCount` /
`admin.roles.groupsCount` translation keys (no new copy needed).
Mirrors the Apps panel pattern: 11px muted-foreground text with bullet
separators, only renders when at least one count is > 0, and exposes
a `data-testid="role-counts-<id>"` for tests.
Notes / deviations
- The task description said "the role list endpoint already returns
userCount/groupCount" but it didn't — the counts only existed on
/roles/:id/usage. Added them to the list endpoint following the same
pattern Apps and Groups already use.
- The pre-existing admin.roles.usersCount/groupsCount keys have no
`_one`/`_other` plural variants; I kept it that way to stay consistent
with the Apps panel keys (which also have no plural variants).
Verification
- `pnpm -w run typecheck` passes for tx-os and roles.ts (pre-existing
unrelated typecheck errors in executive-meetings.ts remain — not touched
by this change).
- e2e test (testing skill, status: success): logged in as the seeded
admin, opened the Roles panel, verified inline counts render on the
admin and user roles, bullet separator is present, and roles with zero
dependencies don't render an empty counts area.
Replit-Task-Id: 8c99d912-8b3a-4e80-aca7-ec167e6e75e6
riyadhafraa
90c319fb25