Standard V2 implementation of the Fact.Seam.Storage seam.

This module creates 0 to 3 character buckets (i.e. sub-directories) for events. Directories with a large number of files can cause performance and operational issues.

Most filesystems store directory entries in data structures (like B-trees or linear lists) that degrade as the entry count grows. Listing, searching, or opening files requires scanning or
traversing these structures, which becomes slower as directories grow into thousands or millions of files.

Tool Limitations

Many common tools struggle with huge directories.

• Shell glob expansion can exceed argument length limes or consume excessive memory
• ls becomes slow and unwieldy
• File browsers may hang or become unresponsive
• Backup tools and file synchronization can slow dramatically

Inode and Metadata Overhead

Directory metadata must often be read into memory. A directory with millions of entries can consume significant memory just for the directory itself, separate from the files it contains.

Bucket Configurations

This implementation will create a sub-directory within the base records_path. The default event record encoding is base16, with a default bucket_length of 2, which would result in 256 "buckets" directories for storing events 00 to ff. Using an alternate encoding for record file names or increasing the bucket length will increase this.