residual/auth
=============

authentication, login screen, and session selection for residual.

packages:
  auth/           PAM authenticator interface + implementation (CGO).
                  pam_stub.go provides a no-op fallback for CGO_ENABLED=0.
  auth/tty/       linux TTY management — open, VT switching, wait-active.
  auth/login/     bubbletea login screen UI (branding + password form).
  auth/selector/  bubbletea session picker UI (.desktop file scanning).

binaries:
  res-login   full login flow: TTY setup → authentication → session launch.
              requires CGO for PAM. see etc/pam.d/residual-login.
  res-select  standalone session picker (post-login, or for display managers).

build:
  go build ./cmd/res-login     # requires CGO_ENABLED=1
  CGO_ENABLED=0 go build ./cmd/res-select

module:   git.merith.xyz/residual/auth
requires: git.merith.xyz/residual/core