Module ls 

List Hexz archives in a directory and render their lineage as a tree.

Scans a directory for .hxz files, reads the parent_paths field from each header, and builds a parent→child graph. Files whose parent lives outside the scanned directory are shown with an external-parent annotation.

Common Usage

hexz ls ./checkpoints/
hexz ls .

Output Example

./checkpoints/
├── base.hxz                 12.4 GB  standalone
│   ├── epoch1.hxz            1.2 GB  +162 new blocks
│   │   └── epoch2.hxz        0.8 GB  +97 new blocks
│   └── finetune-v1.hxz       2.1 GB  +389 new blocks
└── unrelated.hxz             4.0 GB  standalone

5 archives   20.5 GB on disk

Functions

run

Print a tree of all .hxz archives found in dir.