Using the 'Dive' tool to explore the ROCK/OCI content is broken

Metadata

Project: rockcraft
Number: #38
Type: issue
State: closed
Author: valentincanonical
Labels: —
Created: 2022-05-19 12:16 PM UTC
Updated: 2022-09-05 07:27 PM UTC
Closed: 2022-09-05 07:27 PM UTC

Current evaluation

Dive failures on ROCK images were caused by dangling whiteout files left after layer flattening. craft-parts PR #274 (commit ea2f679a) filters unnecessary whiteout/opaque-dir markers during migration, shipping in craft-parts 1.13.0; #44 fixed the collapse issue.

Resolution: closed resolved

Reason: Maintainer cmatsuoka reproduced the Dive error and traced it to dangling whiteouts after package-cache layer removal; the final-pass cleanup was merged in craft-parts PR #274 (commit ea2f679a) and released in craft-parts 1.13.0, with tigarmo confirming #44 fixed directory collapsing.

Evaluated by: mr-cal-bot

No scores available.

Issue body

Referring to the https://github.com/wagoodman/dive tool to explore the content of an image, once imported in the local docker registry. I noticed two different situations, 1) As discussed before, sometimes Dive will simply fail to open the image. This seems related to the use of whiteout files and a wrong interpretation of the OCI spec on their end. 2) But even when Dive will open the image and explore it, it is not possible to collapse the directories (hitting Space or Ctrl+Space). This only happened to me with images built using Rockcraft.

Evaluation history

Date	Model	Scores	Action	Summary
2026-10-03 01:03 AM UTC	stealth/space-bunny-alpha	—	closed resolved	Dive failures on ROCK images were caused by dangling whiteout files left after layer flattening. craft-parts PR #274 (commit ea2f679a) filters unnecessary whiteout/opaque-dir markers during migration, shipping in craft-parts 1.13.0; #44 fixed the collapse issue.
2026-09-25 12:07 AM UTC	stealth/space-bunny-alpha	—	closed resolved	Stale whiteout files after layer flattening broke Dive loading and directory collapsing in ROCK images. The cleanup shipped in craft-parts 1.13.0 via ea2f679a (#274).
2026-09-25 12:07 AM UTC	stealth/space-bunny-alpha	—	closed resolved	Dive failures were traced to dangling OCI whiteouts after package-cache layer removal. Whiteout cleanup shipped in craft-parts 1.13.0; rockcraft#44 had already fixed directory collapsing.
2026-09-07 09:22 PM UTC	qwen/qwen3.6-35b-a3b	—	—	Fixed in craft-parts 1.13.0. Dangling whiteout files remaining after package cache layer removal caused Dive to fail opening images. A final cleanup pass now removes these orphaned whiteouts, resolving the OCI content exploration failure.
2026-07-23 02:39 PM UTC	qwen/qwen3.6-35b-a3b	—	—	Fixed in craft-parts 1.13.0. Dangling whiteout files after layer removal caused Dive compatibility issues. A final cleanup pass removes these files, resolving both the directory collapse bug and image opening failures. Related to #44.
2026-07-22 02:51 PM UTC	qwen/qwen3.6-35b-a3b	—	—	Fixed in craft-parts 1.13.0. A final pass now removes dangling whiteout files left after layer removal, resolving Dive opening failures and directory collapse issues in Rockcraft-built OCI images.
2026-07-16 08:58 AM UTC	qwen3.6-35b-a3b-mtp-q6	—	—	Fixed. Dangling whiteout files in OCI layers broke Dive compatibility. A final cleanup pass now removes these files after layer removal. The fix is available in craft-parts 1.13.0.

Update history

No update history recorded yet.

Related work

Likely Fixed By: canonical/craft-parts#274 (confidence 90%)
Merged PR filtering out unnecessary whiteout and opaque-directory files during migration, commit ea2f679a, shipped in craft-parts 1.13.0.
Related To: canonical/rockcraft#44 (confidence 85%)
File permissions/ownership issue referenced by maintainers as the root cause of the folder-collapse symptom, which was confirmed fixed.

Related issues

No related issues found above the similarity threshold.