fix(common): flatten Bluefin face icons into /usr/share/pixmaps/faces

common ships the Bluefin user-avatar art (including the dinosaur images)
under /usr/share/pixmaps/faces/bluefin/. GNOME's account avatar chooser
scans /usr/share/pixmaps/faces non-recursively, so the files landed in
the image but never appeared in Settings > Users.

Flatten faces/bluefin/* over faces/ in install-commands, matching
ublue-os/bluefin build_files/base/05-override-install.sh. The flattened
filenames collide with the GNOME OS defaults from
core/gnome-control-center.bst, so add /usr/share/pixmaps/faces/* to the
overlap-whitelist.

Closes #353

Assisted-by: Claude Sonnet 4.6 via goose

Author: castrojo

docs/skills/oci-layers.md

@@ -181,3 +181,22 @@ The OCI assembly script in `elements/oci/bluefin.bst` must run steps in this exa
 4. `build-oci` (assemble image)
 
 Running `ldconfig` after `build-oci` has no effect. Running `build-oci` before `dconf update` produces an image with stale/missing dconf databases.
+
+### Bluefin content shipped in a subdirectory GNOME reads non-recursively (2026-08-07)
+
+`projectbluefin/common` ships the Bluefin user-avatar art under
+`system_files/bluefin/usr/share/pixmaps/faces/bluefin/`, which
+`elements/bluefin/common.bst` copies verbatim into the image. GNOME's account
+avatar chooser scans `/usr/share/pixmaps/faces` non-recursively, so the files
+were present in the image but never visible to users (dakota#353).
+
+`ublue-os/bluefin` handles this in `build_files/base/05-override-install.sh` by
+flattening `faces/bluefin/*` over `faces/` at build time. The BST equivalent is
+a flatten step in the `install-commands` of `elements/bluefin/common.bst`, plus
+an `overlap-whitelist` entry for `/usr/share/pixmaps/faces/*` because the
+flattened filenames collide with the GNOME OS defaults from
+`core/gnome-control-center.bst`.
+
+General rule: when `common` places files in a vendor subdirectory, check whether
+the consuming component actually scans subdirectories before assuming the copy
+is sufficient.

elements/bluefin/common.bst

@@ -25,6 +25,9 @@ public:
     - /etc/environment
     - /etc/containers/policy.json
     - /usr/share/pixmaps/gnome-boot-logo.png
+    # Bluefin user-avatar art replaces the GNOME OS defaults shipped by
+    # core/gnome-control-center.bst (same 15 filenames).
+    - /usr/share/pixmaps/faces/*
 
 variables:
   strip-binaries: ""
@@ -64,6 +67,15 @@ config:
     cp "%{install-root}%{datadir}/pixmaps/fedora-logo-icon.png" "%{install-root}%{datadir}/pixmaps/img-logo-icon-dark.png"
     # Override GNOME OS boot logo with Bluefin branding
     cp "%{install-root}%{datadir}/pixmaps/fedora-gdm-logo.png" "%{install-root}%{datadir}/pixmaps/gnome-boot-logo.png"
+    # User-avatar art: common ships Bluefin faces under faces/bluefin/, but
+    # gnome-control-center only reads %{datadir}/pixmaps/faces (non-recursive),
+    # so the images never appear in the account-avatar chooser. Flatten them
+    # over the GNOME OS defaults, matching ublue-os/bluefin's
+    # build_files/base/05-override-install.sh.
+    if [ -d "%{install-root}%{datadir}/pixmaps/faces/bluefin" ]; then
+      mv "%{install-root}%{datadir}/pixmaps/faces/bluefin/"* "%{install-root}%{datadir}/pixmaps/faces/"
+      rmdir "%{install-root}%{datadir}/pixmaps/faces/bluefin"
+    fi
     install -Dm755 bluefin-wallpaper-month-sync "%{install-root}%{prefix}/libexec/bluefin-wallpaper-month-sync"
     install -Dm644 bluefin-wallpaper-month.service "%{install-root}%{prefix}/lib/systemd/system/bluefin-wallpaper-month.service"
     mkdir -p "%{install-root}%{prefix}/lib/systemd/system/multi-user.target.wants"