gc-bundles

Documentation

Overview

Command gc-bundles prunes unreferenced GHCR bundles.

Runs in two modes:

--dry-run (default): list candidate versions without deleting.
--confirm: actually delete the candidates. Guarded behind a workflow
           dispatch input; local dev should stick to --dry-run.

A version is a candidate for pruning when it is:

• a container manifest under ghcr.io/<org>/php-core or ghcr.io/<org>/php-ext-<name>;
• older than --min-age-days (default 30);
• not referenced by bundles.lock on any remote branch or any released tag's embedded bundles.lock.

Released-tag lockfile references are load-bearing for product-vision §16 reproducibility and must never be pruned.