feat(cli): add ecrou pull

Fetch or refresh an image's cache entry without booting it. The
command is the CLI face of the run/pull split: runs never contact a
registry on a cached image, pull does - reporting the entry path
and whether anything transferred. --no-cache forces a redownload.
SPEC documents the command and the run/pull trust model.
This commit is contained in:
vhaudiquet committed 2026-10-30 01:04:24 +01:00
1 parent 12a417645d
commit b4dafccae7
3 files changed
+68 -8

No files matched your search

+13
View File
@@ -49,6 +49,19 @@ pub enum Command {
#[arg(last = true)]
command: Vec<String>,
},
/// Fetch or refresh an image's cache entry without booting it:
/// re-checks unpinned OCI tags against the registry and floating
/// distro aliases against the distro, downloading only when the
/// entry is absent or has moved. `run` never contacts the
/// registry on a cached image — this is the refresh operation.
Pull {
/// Distribution name or OCI image reference
image: String,
/// Ignore the cache: re-download even when the entry is
/// present and current
#[arg(long)]
no_cache: bool,
},
/// Report what a run would find on this host
Probe,
}