auth-bundle-1 Phase 9 + 10: approval-bypass closure + RBAC GUI

# Phase 9 — approval-bypass closure (Decision 9, option a)

* Migration 000033_approval_kinds.up.sql: ALTER TABLE
  issuance_approval_requests ADD COLUMN approval_kind +
  payload JSONB; relax certificate_id + job_id to nullable;
  CHECK (approval_kind IN ('cert_issuance','profile_edit'))
  + CHECK (per-kind nullability invariant) + index on
  approval_kind. Idempotent throughout via DO blocks.
* domain.ApprovalKind enum (cert_issuance / profile_edit) +
  IsValidApprovalKind. ApprovalRequest gains Kind +
  Payload []byte for the pending profile diff.
* postgres.ApprovalRepository.Create + scanApprovalRow extended
  to round-trip the new columns; certificate_id + job_id
  switched to sql.NullString so profile_edit rows persist
  cleanly. Default Kind=cert_issuance preserves back-compat
  for every Phase-7-2026-05-03 caller.
* ApprovalService.RequestProfileEditApproval: new entry point
  that creates a pending profile-edit row carrying the
  serialized profile diff. Bypass mode (CERTCTL_APPROVAL_BYPASS)
  short-circuits the same way it does for cert_issuance.
* ApprovalService.SetProfileEditApply hook: cmd/server/main.go
  registers a closure that deserializes req.Payload + persists
  via profileRepo.Update + emits a profile.edit_applied audit
  row with category=auth. The hook avoids the Approval ↔
  Profile import cycle.
* ProfileService.UpdateProfile: gates when (a) the live
  profile carries RequiresApproval=true, OR (b) the proposed
  edit would set it true. Returns ErrProfileEditPendingApproval
  with the new approval ID; ProfileHandler maps to HTTP 202
  Accepted + {pending_approval_id}. Both arms close the
  flip-flop loophole because every transition through an
  approval-tier profile fires the gate.
* TestProfileEdit_RequiresApprovalLoopholeClosed pins all 3
  bypass attempts (flip-off / kept-on / flip-on) gated; nil-
  approval-service preserves pre-Phase-9 direct-apply for
  test fixtures.
* Approval service tests gain 4 profile_edit rows: pending row
  shape; same-actor self-approve rejected with
  ErrApproveBySameActor (load-bearing two-person integrity);
  approve fails-closed when apply callback unwired;
  apply callback invoked on approve.
* docs/reference/profiles.md (new) explains the gate +
  edit response shape (202) + same-actor invariant + bypass
  + audit hooks.

# Phase 10 — RBAC management GUI

* useAuthMe hook (web/src/hooks/useAuthMe.ts): TanStack Query
  fetches /api/v1/auth/me on app boot, caches for 60s, exposes
  hasPerm(p) + hasAnyPerm + isAdmin predicates. Every Phase-10
  page consumes this on mount + gates affordances against the
  cached effective_permissions slice. Server-side enforcement
  is the load-bearing gate; client-side hide/disable is UX.
* New routes:
   - /auth/roles — list (auth.role.list); create-role modal
     (auth.role.create) hidden when missing.
   - /auth/roles/:id — detail + permissions; edit
     (auth.role.edit), delete (auth.role.delete), add/remove
     permission affordances each gated.
   - /auth/keys — list of every actor with role grants; assign
     + revoke modals (auth.role.assign). actor-demo-anon
     flagged system-managed; mutation buttons hidden for it.
   - /auth/settings — stub showing /v1/auth/me identity +
     bootstrap-endpoint availability via /v1/auth/bootstrap.
* AuditPage extended with category filter ('All categories'
  + the 3 enum values from migration 000032). Selection flows
  to the API call params + the URL-driven query state.
* Layout: 3 new nav entries (Roles / API Keys / Auth Settings).
* api/client.ts: 12 new exported functions for the RBAC
  surface (authMe, list/get/create/update/delete role,
  list/add/remove role permissions, list keys, assign/revoke
  key role, bootstrap-availability probe).
* data-testid attributes on every interactive element so a
  future Playwright suite can assert behavior without brittle
  CSS selectors.
* Empty state, error state, and unsaved-changes warnings on
  every form per the prompt's implementation rules.

# Frontend tests

* RolesPage.test.tsx (6 tests): list render, empty state,
  error state, hide-create-button-without-perm,
  show-create-button-with-perm, submit-create-modal.
* KeysPage.test.tsx (3 tests): demo-anon flagged
  system-managed (no buttons), permission-gated affordance
  hide for auditor caller, assign-modal-POST contract.
* AuthSettingsPage.test.tsx (2 tests): identity surface,
  bootstrap-OPEN-status surface.
* AuditPage.test.tsx (+1): category-filter select renders
  with the 4 documented options.

15 frontend tests total in src/pages/auth/ + the audit
category-filter test; all pass via npx vitest run.

# Verifications

* go vet ./... clean.
* staticcheck across internal/auth + handler + router + cli +
  service + repository + cmd + domain: clean.
* gofmt -l clean repo-wide.
* go test -short -count=1 green across internal/service,
  internal/api/handler, internal/api/router, internal/auth,
  internal/auth/bootstrap, internal/service/auth,
  internal/domain/auth, cmd/server, cmd/cli, internal/cli.
* npx tsc --noEmit clean.
* npm run build green (vite build produces dist/index.html
  + 946KB JS bundle; chunk-size warning is pre-existing).
* npx vitest run src/pages/auth/ src/pages/AuditPage.test.tsx
  green (15 tests, 4 files).

web/src/api/client.ts

@@ -103,6 +103,126 @@ export const checkAuth = (key: string) =>
     return r.json() as Promise<AuthCheckResponse>;
   });
 
+// =============================================================================
+// Bundle 1 Phase 10 — RBAC management API surface.
+//
+// Backs the Roles / Keys / Auth Settings GUI pages (web/src/pages/auth/*).
+// Every function maps 1:1 to a Phase-4 / Phase-7 server endpoint;
+// permission gates fire server-side, the GUI's permission-aware
+// renders are a UX layer on top.
+// =============================================================================
+
+export interface AuthRole {
+  id: string;
+  tenant_id: string;
+  name: string;
+  description?: string;
+  created_at?: string;
+  updated_at?: string;
+}
+
+export interface AuthRolePermission {
+  role_id: string;
+  permission_id: string;
+  scope_type: 'global' | 'profile' | 'issuer';
+  scope_id?: string;
+}
+
+export interface AuthPermission {
+  id: string;
+  name: string;
+  namespace: string;
+}
+
+export interface AuthEffectivePermission {
+  permission: string;
+  scope_type: 'global' | 'profile' | 'issuer';
+  scope_id?: string;
+}
+
+export interface AuthMeResponse {
+  actor_id: string;
+  actor_type: string;
+  tenant_id: string;
+  admin: boolean;
+  roles: string[];
+  effective_permissions: AuthEffectivePermission[];
+}
+
+export interface AuthKeyEntry {
+  actor_id: string;
+  actor_type: string;
+  tenant_id: string;
+  role_ids: string[];
+}
+
+export const authMe = () => fetchJSON<AuthMeResponse>(`${BASE}/auth/me`);
+
+export const authListRoles = () =>
+  fetchJSON<{ roles: AuthRole[] }>(`${BASE}/auth/roles`).then(r => r.roles);
+
+export const authGetRole = (id: string) =>
+  fetchJSON<{ role: AuthRole; permissions: AuthRolePermission[] }>(
+    `${BASE}/auth/roles/${id}`,
+  );
+
+export const authCreateRole = (body: { name: string; description?: string }) =>
+  fetchJSON<AuthRole>(`${BASE}/auth/roles`, {
+    method: 'POST',
+    body: JSON.stringify(body),
+  });
+
+export const authUpdateRole = (id: string, body: { name: string; description?: string }) =>
+  fetchJSON<unknown>(`${BASE}/auth/roles/${id}`, {
+    method: 'PUT',
+    body: JSON.stringify(body),
+  });
+
+export const authDeleteRole = (id: string) =>
+  fetchJSON<unknown>(`${BASE}/auth/roles/${id}`, { method: 'DELETE' });
+
+export const authListPermissions = () =>
+  fetchJSON<{ permissions: AuthPermission[] }>(`${BASE}/auth/permissions`).then(
+    r => r.permissions,
+  );
+
+export const authAddRolePermission = (
+  roleId: string,
+  body: { permission: string; scope_type?: string; scope_id?: string },
+) =>
+  fetchJSON<unknown>(`${BASE}/auth/roles/${roleId}/permissions`, {
+    method: 'POST',
+    body: JSON.stringify(body),
+  });
+
+export const authRemoveRolePermission = (roleId: string, perm: string) =>
+  fetchJSON<unknown>(`${BASE}/auth/roles/${roleId}/permissions/${perm}`, {
+    method: 'DELETE',
+  });
+
+export const authListKeys = () =>
+  fetchJSON<{ keys: AuthKeyEntry[] }>(`${BASE}/auth/keys`).then(r => r.keys);
+
+export const authAssignKeyRole = (keyId: string, roleId: string) =>
+  fetchJSON<unknown>(`${BASE}/auth/keys/${keyId}/roles`, {
+    method: 'POST',
+    body: JSON.stringify({ role_id: roleId }),
+  });
+
+export const authRevokeKeyRole = (keyId: string, roleId: string) =>
+  fetchJSON<unknown>(`${BASE}/auth/keys/${keyId}/roles/${roleId}`, {
+    method: 'DELETE',
+  });
+
+export interface BootstrapAvailability {
+  available: boolean;
+}
+
+export const authBootstrapAvailable = () =>
+  fetch(`${BASE}/auth/bootstrap`, {
+    headers: { 'Content-Type': 'application/json' },
+  }).then(r => r.json() as Promise<BootstrapAvailability>);
+
 // Certificates
 export const getCertificates = (params: Record<string, string> = {}) => {
   const qs = new URLSearchParams({ page: '1', per_page: '50', ...params }).toString();