Asset library files
dl library push discovers assets from a source directory, with optional
dreamlake.yml configuration. See the library guide
for authoring and reference for
manifest and read-path contracts.
Within an asset directory, discovery preserves the .metadata/ and .thumbs/
payload directories used by NVIDIA SimReady. Their regular files remain at their
original relative paths and keep their original bytes; this preserves provenance
and authored previews. Inclusion does not interpret a physics configuration or
prove that its model loads in MuJoCo.
Other dot-leading files and directories remain excluded, including .env,
.git/ and generated .dreamlake/ state. The two exceptions apply only to
directories, not hidden files with those names. Hidden entries inside them are
still filtered under the same rules, and symlinks are not followed. Explicit
discover.exclude patterns continue to take precedence, including exclusions
of .metadata or .thumbs. There is no general include-hidden switch.
This corrects older CLI discovery, which skipped both payload directories. Previously published manifests remain unchanged; repushing with this behavior can add the retained files and change asset digests. Inspect the resulting manifest/file counts before replacing a published library. For a complete raw repository archive, separately verify its source layout: library discovery is an asset-selection operation, not an unconditional copy of every hidden file.