Some checks are pending
ci / test (push) Waiting to run
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.
27 lines
1.1 KiB
Markdown
27 lines
1.1 KiB
Markdown
# 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.
|