ghcr-manager 1.0.3 → 1.0.4

package/CHANGELOG.md

@@ -7,6 +7,24 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 
 ## [Unreleased]
 
+## [v1.0.4] - 2026-06-06
+
+### Added
+
+- Added user-facing cleanup behavior documentation, including the tag-based protection model, graph-aware cleanup
+  explanation, and digest-pull caveats.
+- Added a visualizer grid toggle so graphs can be aligned for screenshots.
+
+### Changed
+
+- Visualizer screenshots and graph-related docs were refreshed.
+- The visualizer graph area now uses a simpler, cleaner white background.
+- Cleanup summary Markdown now uses an updated index icon label in its rendered output.
+
+### Fixed
+
+- Fixed the published `ghcr-manager-visualizer` npm package so `npx ghcr-manager-visualizer` runs correctly under Node.
+
 ## [v1.0.3] - 2026-06-05
 
 ### Changed

package/README.md

@@ -38,7 +38,7 @@ jobs:
 
       - name: Preview GHCR cleanup
         id: ghcr-manager
-        uses: ghcr-manager/ghcr-manager@v1.0.3
+        uses: ghcr-manager/ghcr-manager@v1.0.4
         with:
           command: cleanup
           token: ${{ github.token }}
@@ -81,7 +81,7 @@ The action supports two commands:
 ### Preview cleanup
 
 ```yaml
-- uses: ghcr-manager/ghcr-manager@v1.0.3
+- uses: ghcr-manager/ghcr-manager@v1.0.4
   with:
     command: cleanup
     token: ${{ github.token }}
@@ -102,7 +102,7 @@ The action supports two commands:
 ### Apply cleanup
 
 ```yaml
-- uses: ghcr-manager/ghcr-manager@v1.0.3
+- uses: ghcr-manager/ghcr-manager@v1.0.4
   with:
     command: cleanup
     token: ${{ github.token }}
@@ -124,7 +124,7 @@ off `dry-run`.
 ### Scan one package
 
 ```yaml
-- uses: ghcr-manager/ghcr-manager@v1.0.3
+- uses: ghcr-manager/ghcr-manager@v1.0.4
   with:
     command: scan
     token: ${{ github.token }}
@@ -199,6 +199,8 @@ Current naming:
 
 - [GitHub Action usage](https://github.com/ghcr-manager/ghcr-manager/blob/main/docs/action-usage.md): action commands,
   including `cleanup` and `scan`
+- [Cleanup behavior](https://github.com/ghcr-manager/ghcr-manager/blob/main/docs/cleanup-behavior.md): how graph-aware
+  cleanup decides what stays, what can be deleted, and why some graph sections are removed together
 - [ghcr-manager-visualizer](https://github.com/ghcr-manager/ghcr-manager/blob/main/visualizer/README.md): local graph
   inspection and scan-to-scan comparison
 - [Multi-package workflows](https://github.com/ghcr-manager/ghcr-manager/blob/main/docs/db-merge-workflows.md): cleaning
@@ -223,8 +225,20 @@ For a first look in the visualizer, start with:
 - package: select one with `2images` or `2multiarch` in the name
 - tag search: `image` or `multiarch`
 
-For more details, see
-[visualizer/README.md](https://github.com/ghcr-manager/ghcr-manager/blob/main/visualizer/README.md).
+For more details, see [visualizer](https://github.com/ghcr-manager/ghcr-manager/blob/main/visualizer/README.md) and
+[test-scenarios](https://github.com/ghcr-manager/ghcr-manager/blob/main/docs/test/scenarios.md).
+
+## Cleanup Behavior
+
+Cleanup is tag-based for both selection and protection. Use tags to say what should be cleaned up, and use retained tags
+to keep image and multi-arch graphs protected.
+
+Manifests reachable from retained tags stay protected. Manifests no longer reachable from any retained tag may be
+removed during cleanup. If you pull images by digest, make sure those digests are still reachable through tags that your
+cleanup rules keep.
+
+For the full explanation and graph examples, see
+[cleanup-behavior](https://github.com/ghcr-manager/ghcr-manager/blob/main/docs/cleanup-behavior.md).
 
 ## Project
 

package/dist/cleanup-summary/_cleanup-summary-markdown.js

@@ -17,7 +17,7 @@ export function renderCleanupSummaryMarkdown(summary, options) {
         `| 🔖 Deleted tags | ${summary.changes.deletedTags} |`,
         `| 🖼️ Deleted images | ${summary.changes.deletedImages} |`,
         `| 📚 Deleted multi-arch manifests | ${summary.changes.deletedMultiArchManifests} |`,
-        `| 🧱 Deleted indexes | ${summary.changes.deletedIndexes} |`,
+        `| 🗂️ Deleted indexes | ${summary.changes.deletedIndexes} |`,
         `| 📄 Deleted total | ${summary.changes.deletedTotal} |`,
         `| 🔗 Tag-only updates | ${summary.untagOnlyRoots.length} |`,
         `| 🛡️ Blocked items | ${summary.blockedRoots.length} |`,

package/package.json

@@ -2,7 +2,7 @@
   "name": "ghcr-manager",
   "description": "Inspect, analyze, and manage GitHub Container Registry packages.",
   "homepage": "https://github.com/ghcr-manager/ghcr-manager#readme",
-  "version": "v1.0.3",
+  "version": "v1.0.4",
   "license": "MIT",
   "type": "module",
   "keywords": [