# ForgePack 0.1.0 Release Notes

Status: draft

ForgePack 0.1.0 is the first V1-readiness release line. It provides a usable
archive container, command line tool, public C++ SDK, and documented format
foundation.

## Highlights

- C++23 implementation with strict GCC/MinGW hardening options
- sectioned archive container with explicit little-endian serialization
- raw and deterministic stored-block zlib storage
- `--compression auto` writer policy that stores the smallest available chunk encoding
- pack, list, stat, cat, compare, extract, selected extraction, test, verify, info, manifest, and capability commands
- public SDK for archive creation, listing, comparison, extraction, validation, verification, and info
- safe extraction policy rejecting traversal, absolute paths, and symlinks
- optional payload integrity metadata
- reserved cold metadata, manifest, recovery, and append-history architecture
- CMake install/export and package config support
- archive size and codec metrics through `fp info`, valid escaped `fp info --json`, and the public SDK

## Compatibility

The release targets V1 archive compatibility for the documented mandatory
sections and supported codecs. Unknown required features and unsupported codecs
are rejected predictably.

## Limitations

This release does not provide cryptographic signing, encryption, full repair,
advanced compression tuning, symlink preservation, or ABI-stable SDK guarantees.

## Upgrade Notes

The file format is still being finalized before a stable V1 tag. Archives created
by this release should be treated as compatibility candidates for the V1 corpus.
