Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion README.md
Original file line number Diff line number Diff line change
Expand Up @@ -65,7 +65,7 @@ Like Bluefin, Utah builds four hardware flavors (`utah`, `utah-nvidia`,
| | count |
| --- | --- |
| Bluefin contract installed | **61** |
| Utah additions (GNOME 51, base-image parity, device firmware, desktop services) | 251 |
| Utah additions (GNOME 51, base-image parity, device firmware, desktop services) | 254 |
| Genuinely unavailable | **7** |

## Known gaps
Expand Down
31 changes: 15 additions & 16 deletions docs/skills/package-contract.md
Original file line number Diff line number Diff line change
Expand Up @@ -107,26 +107,25 @@ The four requested overrides and `ffmpegthumbnailer` are in `[factory].parity`;
their installed releases must carry `.bfin` to prevent base substitution.
Check new names with `just check-repos` and the image's `package-origins.txt`.

`gstreamer1-plugins-bad-free` and `totem-pl-parser` stay out of the install
request until their dependency closures publish (`soundtouch`, `faad2`,
`openal-soft`, `libsrtp`, `uchardet` — tracked by #383). Do not list them
under `[unavailable]`; after publication, re-verify with `just check-repos`
against the reviewed pinned inputs before restoring either request.

The pinned factory `sha256:688e2137` publishes `openh264` 2.7.0 and
`gstreamer1-plugin-openh264` 1.28.6, plus `totem-pl-parser` and `uchardet`.
Utah requests the plugin, real codec, and playlist parser by name and asserts
their factory release identity. The plugin's library requirement alone is insufficient: older
factory pins offered the `noopenh264` compatibility library instead of a
working decoder. Recheck the digest-pinned repodata before carrying forward
an older publication blocker.

Utah also consumes libav, dav1d, bad-free and ugly-free GStreamer plugins,
`ffmpegthumbnailer`, `gnome-epub-thumbnailer`, and the Papers thumbnailer.
Package installation does not prove codec functionality. On Intel hardware,
run `vainfo` against the render device and confirm the iHD driver loads and
advertises the expected decode profiles. Inspect `avdec_h264`, `openh264dec`,
and `vah264dec` with `gst-inspect-1.0`, then test a known H.264 sample.
The audit pin published `gstreamer1-plugin-openh264` but only `noopenh264`;
resolving that library dependency is not proof of a working decoder.
The decoder-load probe in PR #919 failed for H.264 despite libav being installed.

Remaining #383 gaps: `gstreamer1-plugin-libav` (blocked on the gstreamer1
family bump), `papers-thumbnailer` (needs published `libspelling` or another
native PDF provider), and `gst-thumbnailers` (needs the Rust crate stack,
see factory #527). `ffmpegthumbnailer` is consumed; ugly-free, plugin-dav1d, and the
epub thumbnailer are still not in the factory and stay out until
utah-packages publishes them (#383). Full FFmpeg (not `-free`) is the decided
direction; keep #383 open for hardware and codec proof.
Remaining #383 gaps include full FFmpeg (the decided direction, replacing
`-free`) and `gst-thumbnailers` (factory #527); neither is published in this
pin. Keep #383 open for those factory deliveries and hardware/codec proof.

## Repository policy

Expand Down Expand Up @@ -363,7 +362,7 @@ Raise the overlay change as its own pull request against `main`; the bump PR
then picks the fix up on its next rebuild.

Current counts, per the README "Package parity" section: 61 Bluefin contract
packages installed, 251 Utah additions (GNOME 51, base-image parity, device
packages installed, 254 Utah additions (GNOME 51, base-image parity, device
firmware, desktop services), 7 genuinely unavailable. `scripts/check-doc-counts.py` (part of
`just check`) recomputes these from the manifests and fails if either
document drifts from `site/data/packages.json`.
Expand Down
10 changes: 9 additions & 1 deletion packages/utah.toml
Original file line number Diff line number Diff line change
Expand Up @@ -187,7 +187,12 @@ packages = [
"intel-mediasdk",
"intel-vpl-gpu-rt",
"libvpl",
# Totem stays omitted: uchardet is unpublished (#383).
# Playlist parsing and software H.264 decoding now have their dependency
# closures in the pinned factory (#383). Request the real codec explicitly
# so a noopenh264 compatibility library cannot satisfy the plugin alone.
"totem-pl-parser",
"gstreamer1-plugin-openh264",
"openh264",
# Locale and fonts
"langpacks-en",
"langpacks-fonts-en",
Expand Down Expand Up @@ -877,6 +882,9 @@ parity = [
"intel-mediasdk",
"intel-vpl-gpu-rt",
"ffmpegthumbnailer",
"totem-pl-parser",
"gstreamer1-plugin-openh264",
"openh264",
# Bluefin tools consumed from the pinned factory (#263, #388, #392).
"thermald",
"intel-lpmd",
Expand Down
7 changes: 5 additions & 2 deletions site/data/packages.json
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
{
"generated_at": "2026-10-24",
"generated_at": "2026-10-28",
"generator": "scripts/generate-site-data.py",
"groups": [
{
Expand Down Expand Up @@ -184,6 +184,7 @@
"gssproxy",
"gstreamer1-plugin-dav1d",
"gstreamer1-plugin-libav",
"gstreamer1-plugin-openh264",
"gstreamer1-plugins-bad-free",
"gstreamer1-plugins-bad-free-libs",
"gstreamer1-plugins-ugly-free",
Expand Down Expand Up @@ -240,6 +241,7 @@
"nvtop",
"openal-soft",
"openconnect",
"openh264",
"openvpn",
"orca",
"papers-libs",
Expand Down Expand Up @@ -299,6 +301,7 @@
"tcpdump",
"thermald",
"tmux",
"totem-pl-parser",
"tpm2-tools",
"tree",
"unbound-anchor",
Expand Down Expand Up @@ -369,7 +372,7 @@
}
],
"totals": {
"installed": 312,
"installed": 315,
"unavailable": 7
},
"unavailable": [
Expand Down
Loading