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 |
|---|---|
|
Receipt version, generation number, timestamp, source, and system prefix. |
|
Workspace manifest used to create the generation. |
|
Lockfile used to install the generation. |
|
Installed conda package inventory from |
|
Boot artifact metadata recorded by |
|
Rootfs file and link manifest inventory recorded by |
|
SHA-256 checksums for receipt files recorded by |
generation.toml¶
Current fields:
Field |
Description |
|---|---|
|
Receipt schema version. Current value is |
|
Generation number. |
|
UTC timestamp for the receipt write. |
|
Human-readable source such as |
|
Runtime prefix for the generation, such as |
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.