Error:
  type: object
  required:
    - error
  properties:
    error:
      type: string
      description: Human-readable error message.
      example: Missing or invalid Authorization header.
HealthResponse:
  type: object
  required:
    - status
    - database
  properties:
    status:
      type: string
      description: Process health marker.
      example: ok
    database:
      type: string
      description: Database ping result.
      example: up
MeResponse:
  type: object
  required:
    - id
    - email
    - name
    - role
  properties:
    id:
      type: string
      format: uuid
      description: Internal user primary key.
      example: 11111111-1111-4111-8111-111111111111
    email:
      type: string
      format: email
      description: Caller email address.
      example: admin@seahavenind.com
    name:
      type: string
      description: Display name for the caller.
      example: Dev Admin
    role:
      type: string
      description: Authorization role for RBAC checks.
      enum:
        - admin
        - ap_processor
        - approver
        - viewer
      example: admin