fix(podman): the guidance pins a tag that exists, and the test agrees

[LMPrado-DZ23]

My regression from #63, and the test was right to catch it.

#63 rewrote the docs from :next to :latest. tests/unit/podman-machine-guidance-8497.test.ts asserts the tag the podman guidance names, so it went red on the base — proven by the agent working on #56, who ran it on the tip either side of that merge: 7/7 before, 6/7 after.

It also exposed something #63 left half-done: I changed contrib/podman/README.md but not contrib/podman/omniroute.container next to it, so the Quadlet unit still said :next while the README said :latest. The guidance disagreed with itself.

Why the original pin was right, and why it stopped being right

The test carries its own reasoning, from Fase 8:

:next until a version is released — :latest is only promoted by a SemVer publish, so pinning it here documented a pull that returns "manifest unknown".

Correct when written. v3.8.54 shipped on 2026-09-19:

docker manifest inspect ghcr.io/lmprado-dz23/omniroute:latest  -> present
docker manifest inspect ghcr.io/lmprado-dz23/omniroute:3.8.49  -> absent

The premise expired. This is the same class of staleness #63 fixed one layer up — a correct reason, recorded in a comment, that quietly became false when the world changed. So the comment is rewritten to state the new reason and the evidence, rather than leaving behind a justification that no longer holds.

Change

File	Was	Is
contrib/podman/omniroute.container	Image=…/omniroute:next	Image=…/omniroute:latest
the two assertions in podman-machine-guidance-8497.test.ts	:next	:latest

The test keeps its teeth: it still pins the tag the guidance names, so the next person who changes one and not the other gets the same failure I did.

Gate	Result
tests/unit/podman-machine-guidance-8497.test.ts	7 pass / 0 fail
eslint --max-warnings=0	exit 0
prettier --check	clean
check:doc-links	PASS

🤖 Generated with Claude Code

[coderabbitai]

Important

• 🔍 Trigger review

This repository does not receive automatic reviews because it has fewer than 10 stars.

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Advanced

Run ID: 715e37af-cb64-4cc8-bcbd-eab6601d7084

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands.}