Module local_image 

Local image-store metadata sidecar.

A natively-built image — most notably one produced by the macOS Seatbelt builder — never round-trips a registry, so the OCI manifest + config blobs that normally carry os / architecture are never written anywhere. That left two gaps: inspect had no platform metadata to report, and dispatch routing had no os hint, so a Mac-native bundle could be mis-routed to the Linux VM.

This sidecar closes both. It is a plain JSON file written beside the image’s rootfs/ at {images}/{sanitized_ref}/metadata.json, so it is a durable, single-writer source of truth with none of the redb single-writer-per-file fragility of stamping the shared blob cache from a second process. The builder writes it; image inspection and the composite’s OS-resolution read it back.

Structs

LocalImageMetadata

Platform + identity metadata recorded for a locally-built image.

Constants

LOCAL_IMAGE_METADATA_FILE

File name of the per-image metadata sidecar, stored next to rootfs/ inside the image’s directory.