phoebus_os/docs/adr/0003-desktop-systemd-profile.md
Phoebus 83368f774c
Some checks are pending
ci / test (push) Waiting to run
feat(git): add session context, host doctor, ADRs and git hygiene
Adds scripts/context.sh + 'make context' (one-screen session briefing),
scripts/doctor.sh + 'make doctor' (host prerequisites), docs/HANDOFF.md
(rolling cross-session note), docs/adr/ (BLS, desktop profile, keyring, Rust),
.githooks/commit-msg (Conventional Commits), .gitattributes, scripts/backup-git.sh
+ 'make backup', and a Forgejo Actions CI workflow. Updates AGENTS.md reading
order/work loop and DEVELOPMENT.md.
2026-09-20 02:36:32 -07:00

1.1 KiB

ADR 0003: Desktop installs inherit the Gentoo desktop/systemd profile

  • Status: Accepted
  • Date: 2026-09-20

Context

Reconstructing Wayland/X/dbus/policykit USE flags by hand on top of the minimal systemd profile produced REQUIRED_USE conflicts (cairo[X], libglvnd[X], libxkbcommon[X]) and a circular dependency through Sphinx/Pillow documentation (pillow[truetype] vs harfbuzz[introspection]).

Decision

A desktop install selects the supported stable Gentoo profile default/linux/amd64/23.0/desktop/systemd, and the minimal default/linux/amd64/23.0/systemd is used only for core/server installs. An explicit non-default profile always wins. Base storage tools disable the man docs (sys-fs/{btrfs-progs,cryptsetup} -man) to avoid the documentation chain.

Consequences

  • The transaction resolves and installs; desktop packages compile heavily because desktop USE does not match the signed binhost (a future optimization).
  • Phoebus stays a thin layer over Gentoo profiles rather than carrying its own USE reconstruction.
  • An explicit non-default profile always wins.