Generation Receipt Reference

Den records generation metadata under:

/den/generations/<n>/metadata

The current receipt format is version 1. It is intentionally small and matches what the prototype records today.

Files

File

Purpose

generation.toml

Receipt version, generation number, timestamp, source, and system prefix.

conda.toml

Workspace manifest used to create the generation.

conda.lock

Lockfile used to install the generation.

packages.txt

Installed conda package inventory from conda-meta.

boot.toml

Boot artifact metadata recorded by den update.

rootfs-layout.toml

Rootfs file and link manifest inventory recorded by den update.

checksums.txt

SHA-256 checksums for receipt files recorded by den update.

generation.toml

Current fields:

Field

Description

version

Receipt schema version. Current value is 1.

generation

Generation number.

recorded_at

UTC timestamp for the receipt write.

source

Human-readable source such as rootfs-build or generation-smoke.

system_prefix

Runtime prefix for the generation, such as /den/generations/1/sw.

Example:

version = 1
generation = 1
recorded_at = "2026-06-06T12:00:00Z"
source = "rootfs-build"
system_prefix = "/den/generations/1/sw"

Additional Update Receipts

den update writes these additional files for newly installed generations:

  • boot.toml,

  • rootfs-layout.toml,

  • checksums.txt.

The initial generation may only have the core four files when it was recorded by the rootfs builder. The extra receipts are additive and do not change the meaning of the existing receipt files.