# cu29-unifiedlog
Unified binary logging primitives used by Copper.
This crate provides the core data structures and I/O abstractions for Copper's
task-data and text-log stream format. It can be used independently if you need
the same log container format in another project.
## Features
- `std` (default): enables memory-mapped file logging backend.
- `compact` (default): favors compact log layout.
## Encapsulation and application content
`UNIFIED_LOG_FORMAT_VERSION` is **1**, unchanged since Copper's original format.
It versions only the file/section encapsulation and layout. **Never bump it for
changes to encoded section content**: CopperLists, payloads, keyframes, and codecs
are decoded by the logreader built for the exact application version that wrote
them. The encapsulation version cannot establish content compatibility.
CopperLists record `id` followed by `msgs`. Their lifecycle `state` is runtime
bookkeeping and is omitted from binary, Serde, Python, and remote-debug output.
A decoded list reconstructs `BeingSerialized` internally; this is not recorded
history. Compressed metadata retains its byte format with the selective
`cu_bincode::Uleb128` wrapper; ordinary integers retain their bincode encoding.