# Artifact Reference ## Workspace Archive ```text build/den-workspace.tar.zst ``` Created by: ```bash ct run workspace-archive ``` Used by rootfs staging and generation smoke tests. ## Staged Rootfs ```text build/rootfs ``` Created by: ```bash ct run rootfs ``` This is a directory tree, not a disk image. Receipt: ```text build/rootfs/etc/den/rootfs.receipt.json ``` ## Rootfs Disk Image ```text build/artifacts/den-rootfs.ext4 ``` Created by: ```bash ct run rootfs-image ``` The image size is currently 4 GiB. Receipt: ```text build/artifacts/den-rootfs.ext4.receipt.json ``` ## Buildroot Boot Artifacts ```text build/buildroot/images/Image build/buildroot/images/rootfs.cpio.gz build/buildroot/target/bin/busybox ``` Created by: ```bash den image early-boot ``` Heavy Buildroot output is cached in: ```text build/buildroot-output ``` ## QEMU Bundle ```text build/artifacts/den-qemu-aarch64.tar.zst ``` Created by: ```bash ct run image-bundle ``` Contents: ```text Image rootfs.cpio.gz den-rootfs.ext4 boot-qemu.sh manifest.toml SHA256SUMS receipt.json den-rootfs.ext4.receipt.json ``` `manifest.toml` records: - target, - architecture, - creation time, - source commit, - dirty-source flag, - Buildroot version, - Buildroot defconfig, - current generation, - lockfile hash, - workspace manifest hash, - package count, - per-artifact hashes and sizes. `receipt.json` records the bundle as an in-toto Statement and binds the copied rootfs image receipt when present. ## Artifact Receipts Rootfs, rootfs image, QEMU bundle, and UEFI disk artifacts write JSON receipts using: - `_type = https://in-toto.io/Statement/v1`, - `predicateType = https://den-os.org/schemas/den-artifact-receipt-1.schema.json`, - `subject[]` entries with SHA-256 digests for produced artifacts, - a Den predicate with the artifact kind, target, inputs, and metadata. Den validates these receipts with vendored JSON schemas and the Python `jsonschema` library. Validation is offline and does not fetch schemas from the network. After schema validation, `den verify` recomputes subject hashes, checks receipt input hashes when local input paths are recorded, verifies the staged rootfs tree digest, and rejects unsafe paths or symlink escapes. Individual artifact receipts are integrity and provenance documents, not signatures. The release workflow binds them into an aggregate release receipt and signs that receipt separately with keyless Cosign. ## Release Directory Candidate releases use: ```text https://releases.den-os.org/candidates/2026.6-rc.1/ ``` Promoted releases use: ```text https://releases.den-os.org/2026.6/ ``` Each release contains `qemu-aarch64/` and `qemu-x86_64/` directories plus `SHA256SUMS`, `release.receipt.json`, its Sigstore bundle, and a static index. The release receipt is published last as the completeness marker. Candidate and final locations become supported interfaces only after their workflows have passed against the public URLs. ## Docker/OCI Inspection Image ```text den:dev ``` Created by: ```bash ct run oci-image ``` Verified by: ```bash ct run oci-smoke ``` This is a `FROM scratch` Linux arm64 image containing the staged Den rootfs. It is useful for inspecting files and running simple userland checks through Docker/OrbStack. It is not a bootable VM image and does not run systemd as PID 1 in Docker. It can also be used as a local base image for application containers with: ```Dockerfile FROM den:dev ``` Application containers should usually create their own app environment, for example under `/opt/app`, instead of installing workload dependencies into `/opt/den`. The OCI image is built directly from `build/rootfs`. It does not require the Buildroot kernel or initramfs. The generated image sets: ```text PATH=/opt/den/bin:/run/current-system/sw/bin:/bin:/usr/bin:/sbin:/usr/sbin ``` The rootfs includes `/etc/conda/.condarc` with: ```yaml channels: - conda-forge channel_priority: strict default_channels: [] ``` ## Package And License Reports ```text build/artifacts/reports/conda-packages.json build/artifacts/reports/conda-licenses.md ``` Created by: ```bash den report packages --rootfs build/rootfs --output-dir build/artifacts/reports ct run package-report ``` The reports are generated from the active staged generation's conda prefix metadata. They record installed conda packages, versions, builds, channels, artifact hashes, dependency metadata, and license expressions where conda metadata provides them. ## UEFI Disk Image ```text build/artifacts/den-uefi-aarch64.raw build/artifacts/den-uefi-aarch64.qcow2 build/artifacts/den-uefi-aarch64.receipt.json ``` Created by: ```bash ct run uefi-image ``` Verified by: ```bash ct run uefi-image-smoke ``` The raw disk is a GPT image with: - partition 1: FAT EFI system partition labeled `DEN_ESP`, - partition 2: ext4 Den rootfs labeled by the partition name `DEN_ROOT`. The EFI system partition contains: ```text EFI/BOOT/BOOTAA64.EFI den/Image den/rootfs.cpio.gz ``` `BOOTAA64.EFI` is a GRUB standalone EFI binary with an embedded config that searches for `DEN_ESP`, loads the Buildroot kernel and initramfs, and passes the root partition as `/dev/vda2`. The `.qcow2` file is converted from the raw disk with `qemu-img`. The current artifact is only a first QEMU UEFI disk prototype. It includes Den's NoCloud-style seed handler and first-boot rootfs growth, but it does not query provider metadata services or include provider-specific image metadata. ## VirtualBox VDI ```text build/artifacts/den-virtualbox-aarch64.vdi ``` Created by: ```bash ct run virtualbox-image ``` This is converted from `build/artifacts/den-uefi-aarch64.raw` with `qemu-img -O vdi`. It is not boot-smoked and is not part of the supported runtime matrix yet.