just commands documented in README do not work on installed systems #9

Open
opened 2026-07-15 14:55:34 +00:00 by james.oates · 0 comments
Owner

Found during first installed-system validation on the VM testbed (2026-07-15): just update fails with "error: no justfile found". The README documents just update, just rollback, just --list, just show-tdp etc. as the primary maintenance interface — none of them can work as documented.

Cause (to confirm): our recipes are installed at /usr/share/ublue-os/just/60-glarion.just, which is Universal Blue's convention for their ujust wrapper — but plain just only looks for a justfile in the current directory, and the base image may not ship ujust at all. Pending check: which ujust; ls /usr/share/ublue-os/ on an installed system.

Fix options (pick after the check):

  • If ujust exists in the base: docs change — README says ujust instead of just
  • If not: ship the ublue justfile wiring (or a tiny /usr/bin/glarion wrapper) so the documented commands work
  • Either way: add a boot-test assertion that the documented update command actually runs

Note rpm-ostree update works fine — this is a UX/docs break, not an update-path break. But the README is the user contract; documented commands must work.

Found during first installed-system validation on the VM testbed (2026-07-15): `just update` fails with "error: no justfile found". The README documents `just update`, `just rollback`, `just --list`, `just show-tdp` etc. as the primary maintenance interface — none of them can work as documented. Cause (to confirm): our recipes are installed at `/usr/share/ublue-os/just/60-glarion.just`, which is Universal Blue's convention for their `ujust` wrapper — but plain `just` only looks for a `justfile` in the current directory, and the base image may not ship `ujust` at all. Pending check: `which ujust; ls /usr/share/ublue-os/` on an installed system. Fix options (pick after the check): - If `ujust` exists in the base: docs change — README says `ujust` instead of `just` - If not: ship the ublue justfile wiring (or a tiny `/usr/bin/glarion` wrapper) so the documented commands work - Either way: add a boot-test assertion that the documented update command actually runs Note `rpm-ostree update` works fine — this is a UX/docs break, not an update-path break. But the README is the user contract; documented commands must work.
Sign in to join this conversation.
No labels
No milestone
No project
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set

Reference
Glarion/glarion#9
No description provided.