Package-level declarations

# VFS: Bundle Artifacts

Structure of the JSON file which is embedded in a bundle file to enable easy inspection of filesystem contents. The
artifacts file is always appended at the end of the outer bundle tarball, and is always named `artifacts.json.gz`, to
reflect that it is always gzip-encoded.

The artifacts file specifies the following information for each artifact embedded within the file-system:
- The active compression format.
- The artifact's name (path).
- Several hashes of the artifact's un-compressed contents.
- The artifact's un-compressed size.
- The artifact's compressed size using the active compression format.
- The artifact's compressed-data CRC32 checksum.

# VFS: Bundle Header

Defines the packed layout of an Elide VFS bundle's file header. The file header contains just enough data to safely
de-compress and unpack the file-tree metadata, and the associated raw filesystem data. The header is designed to
evolve over time; the format version, at this time, is always `1`.

# VFS: Bundle Info

Structure which defines a full suite of metadata for a given VFS bundle file. This record is only used during
construction or loading of the bundle, as a utility; it is never serialized into the bundle itself.

# VFS: Directory

Describes a directory-type entry within a given `TreeEntry`, within a virtual file system managed by Elide. Directory
entries can hold children (either `File` or other `Directory` objects), by way of their `TreeEntry` children. Entries
of type `Directory` are virtualized and carry no data.

# VFS: File

Describes a single `File`-type entry within a given `TreeEntry`, within a virtual file system managed by Elide. File
entries describe file metadata only; raw file data is enclosed in a compressed blob stored alongside filesystem
metadata.

See individual properties for more information. `File` objects can only be held by `TreeEntry` objects. `Directory`
objects refer to their child `TreeEntry` constituents.

# VFS: File System

Describes a root singleton metadata record which points to the root `TreeEntry` of a given virtual file system
managed by Elide. Only one `Filesystem` may exist per image.

# VFS: Configuration

Describes construction-time configuration values which are used to create a virtual file system for a guest VM. These
properties describe such settings as read-only status, support for virtual links, and so on. Guest VFS configuration
is typically derived at runtime from a combination of VFS policy (see [GuestVFSPolicy]) and top-level VM config.

# VFS: Policy

Specifies configuration values which are included in a guest VM configuration record, and which relate to the guest
VM's behavior for file system access.

# VFS: Known MIME-Type

Enumerates known mime-types to the VM implementation, which can be expressed symbolically rather than in string form.
These types are only created for files which are expected to be frequently used by the VM FS.

# VFS: Tree Entry

Describes a single entry within a given virtual file system managed by Elide. Tree entries can hold `File` or
`Directory` objects. Directories can, themselves, hold child `TreeEntry` objects, but files cannot.