unom/punktfunk-plugin-steam
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

0.1.2 on kit 0.4.2 — the cover-art scan a host cannot pick up any other way #3

Merged
enricobuehler merged 1 commits from chore/kit-0.4.2-cover-art-names into main 2026-08-18 20:22:40 +00:00
Conversation 0 Commits 1 Files Changed 1
+2 -2
enricobuehler commented 2026-08-16 08:46:44 +00:00
Owner
Copy Link
Copy Source

Second link in the chain for punktfunk#265, which fixes "Forza Horizon 6 shows a banner instead of a cover".

What the kit fix does

plugin-kit 0.4.2 teaches findLocalArtFile the filenames and layouts Steam actually uses now. Measured against a real 779-app appcache/librarycache:

  • library_capsule.jpg is the newer name for the 2:3 cover — 46 appids have only that one, Forza Horizon 6 among them.
  • header.jpg is the newer name for the header — 594 appids, against 122 for library_header.jpg. No appid carries both.
  • The <appid>/<name> layout, with no hash dir, holds 623 of 779 appids; the scan walked only <appid>/<hash>/<name>.

Per-appid art found locally on that cache: portrait 25 → 328, hero 75 → 323, header 86 → 716, logo 66 → 295, with no appid losing art it already had.

This repo's own source does not change — the kit is --external at build time, so the version bump is the whole delivery mechanism.

Why the range moves to ^0.4.2 instead of resting on ^0.4.1

^0.4.1 already admits 0.4.2, but a host's plugins dir keeps its own bun.lock, and each plugin gets its own nested node_modules/@punktfunk/plugin-kit. Under the old range, bun add @punktfunk/plugin-steam@0.1.2 is free to keep the 0.4.1 it already has and the fix never arrives. That is not hypothetical — on the .41 box, patching the hoisted kit copy changed nothing at all while the runner logged a clean [steam] sync (startup): reconciled 22 entries, because this plugin resolves its own nested copy.

⚠ Ordering: CI is red until the kit is published

ci.yml installs with --frozen-lockfile, and bun.lock still pins @punktfunk/plugin-kit@0.4.1 — the 0.4.2 tarball does not exist yet, so the lockfile cannot be regenerated. Sequence:

  1. merge punktfunk#265, push tag plugin-kit-v0.4.2 → kit publishes
  2. bun install here, commit the regenerated bun.lock → CI goes green
  3. merge, then tag v0.1.2 — merging alone publishes nothing
  4. punktfunk-plugin-index gets version + integrity + verification.reviewedAt

Happy to do step 2 as soon as the tag lands.

Second link in the chain for [punktfunk#265](https://git.unom.io/unom/punktfunk/pulls/265), which fixes "Forza Horizon 6 shows a banner instead of a cover". ## What the kit fix does `plugin-kit` 0.4.2 teaches `findLocalArtFile` the filenames and layouts Steam actually uses now. Measured against a real 779-app `appcache/librarycache`: * **`library_capsule.jpg`** is the newer name for the 2:3 cover — 46 appids have only that one, Forza Horizon 6 among them. * **`header.jpg`** is the newer name for the header — **594** appids, against 122 for `library_header.jpg`. No appid carries both. * The **`<appid>/<name>`** layout, with no hash dir, holds **623 of 779** appids; the scan walked only `<appid>/<hash>/<name>`. Per-appid art found locally on that cache: portrait 25 → 328, hero 75 → 323, header 86 → 716, logo 66 → 295, with no appid losing art it already had. This repo's own source does not change — the kit is `--external` at build time, so the version bump is the whole delivery mechanism. ## Why the range moves to `^0.4.2` instead of resting on `^0.4.1` `^0.4.1` already admits 0.4.2, but a host's plugins dir keeps its **own `bun.lock`**, and each plugin gets its **own nested** `node_modules/@punktfunk/plugin-kit`. Under the old range, `bun add @punktfunk/plugin-steam@0.1.2` is free to keep the 0.4.1 it already has and the fix never arrives. That is not hypothetical — on the .41 box, patching the hoisted kit copy changed nothing at all while the runner logged a clean `[steam] sync (startup): reconciled 22 entries`, because this plugin resolves its own nested copy. ## ⚠ Ordering: CI is red until the kit is published `ci.yml` installs with `--frozen-lockfile`, and `bun.lock` still pins `@punktfunk/plugin-kit@0.4.1` — the 0.4.2 tarball does not exist yet, so the lockfile cannot be regenerated. Sequence: 1. merge punktfunk#265, push tag `plugin-kit-v0.4.2` → kit publishes 2. `bun install` here, commit the regenerated `bun.lock` → CI goes green 3. merge, then tag `v0.1.2` — merging alone publishes nothing 4. `punktfunk-plugin-index` gets version + integrity + `verification.reviewedAt` Happy to do step 2 as soon as the tag lands.
enricobuehler added 1 commit 2026-08-16 08:46:46 +00:00
chore: 0.1.2 on kit 0.4.2 — the cover-art scan a host cannot pick up any other way
CI / build (pull_request) Failing after 22s
Details
CI / publish (pull_request) Skipped
Details
50316d3fdf 
plugin-kit 0.4.2 teaches `findLocalArtFile` the names and layouts Steam
actually uses today: `library_capsule.jpg` beside `library_600x900.jpg`,
`header.jpg` beside `library_header.jpg`, and the `<appid>/<name>` layout
that holds 623 of the 779 appids on the reference cache. Measured there,
per-appid art found locally goes portrait 25 -> 328 and header 86 -> 716,
with no appid losing art it already had.

The range moves to ^0.4.2 rather than resting on ^0.4.1 admitting it. A
host's plugins dir has its own bun.lock pinning the NESTED kit copy, so
`bun add @punktfunk/plugin-steam@0.1.2` under the old range is free to
keep the 0.4.1 it already has — which is exactly the state found on the
.41 box, where patching the hoisted kit did nothing because the plugin
resolves its own nested one.

Nothing in this repo's own source changes: the kit is external at build
time, so this is the version bump that lets the fix travel.
enricobuehler merged commit 88e4cc84ae into main 2026-08-18 20:22:40 +00:00
enricobuehler deleted branch chore/kit-0.4.2-cover-art-names 2026-08-18 20:22:46 +00:00
Sign in to join this conversation.
Reviewers
No Reviewers
Labels
No items
No labels
Milestone
No items
No Milestone
Projects
Clear projects
No projects
Assignees
Clear assignees
enricobuehler (Enrico Bühler)
No Assignees
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: unom/punktfunk-plugin-steam#3