# What's new

Release highlights, newest first. The full announcements are in
[Release notes 1.1.0](release-notes-1.1.0.md) and
[Release notes 1.0.0](release-notes-1.0.0.md).

## 1.1.0 (2026-10-09)

A feature and correctness release. The public API stays compatible with 1.0.0 (checked at
pack time against the published package via `PackageValidationBaselineVersion`).

### Formats & verification

- **Legacy writers** — `CisoWriter`, `WbfsWriter` and `TgcWriter` complete the container
  matrix and are exposed as `convert -f ciso|wbfs|tgc`; all-zero blocks/clusters are stored
  absent, so scrubbed images shrink.
- **Wii verification** — `DiscVerifier` walks every partition's h0/h1/h2/h3 hash tree plus
  the TMD/H3 tables and reports per-partition issues (`verify --partitions`).
- **Retail ticket keys** — partition keys are now decrypted from the ticket with the Wii
  common key (Dolphin: `TicketReader::GetTitleKey`), so `verify --partitions`, `extract`
  and RVZ writing work on real encrypted discs; RVZ/WIA inputs prefer the container's
  authoritative partition key. `WiiVolume.GetTitleKey(ticket)` exposes the decryption.
- **Extract fixes** — `tmd.bin`/`cert.bin`/`h3.bin` are read at their partition-relative
  offsets (they previously used the wrong base), `h3.bin` is skipped for hashless discs,
  and partition headers are printed by `extract --list`.
- **WBFS fixes** — `hd_sector_count` is relative to the stream position, and the disc
  header copy is written at offset `0x200` for tools that identify discs without decoding.
- **Zero-group decode** — RVZ/WIA partition chunks that are entirely zeroes (padding,
  emptied areas) are stored as zero-size groups with no exception lists; the reader
  decodes them back to zeroes instead of rejecting the missing lists.
- **FST hardening** — corrupt file-system tables fail with a format error instead of an
  internal exception.

### CLI

- `--json` for `convert` and `verify`, `-` stdin/stdout piping, and
  `rvzsharp completions bash|zsh|fish|powershell`. Logs and progress go to stderr, so
  stdout stays machine-readable (including `convert -f iso --json`).
- `convert --verify` honors Ctrl+C (exit code 130) during hashing and verification, and
  writer progress is monotonic, reaching exactly 1.0 when the last byte is read.
- **Extract path safety** — `-s` paths and image file names can no longer escape the
  output folder (absolute paths stay under `-o`, `..` is rejected, hostile names fail
  with a format error); `decode -h` prints usage (exit 0), help runs skip the telemetry
  wait/update prompt, and Ctrl+C is observed while spooling stdin in every command.

### Performance & robustness

- Thread-safe `ReadAt` with a 16 MiB LRU decoded-unit cache, binary-search area lookup and
  ArrayPool group reads; parallel group compression and parallel RVZ/WIA full-image decode
  (`--threads`, byte-identical output for any thread count); parser caps plus a
  mutation/fuzz robustness suite; Native AOT/trimming validated.
- `IBlobReader.Length`, the async API (`CopyToAsync`/`ReadFullyAsync`/`WriteAsync`), split
  plain ISO (`game.part0.iso`), `BlobStream`, `DiscInfo`, `Scrub` and path overloads.
- Parallel decode/encode failures now surface the original exception
  (e.g. `RvzFormatException`) instead of `AggregateException`.

### Tooling & packaging

- GitHub Actions CI (fast tests on `net8.0`/`net9.0`/`net10.0` with coverage, pack with API
  validation + embedded SPDX 2.2 SBOM, smoke-tested CLI artifact) and Dependabot.
- **Release automation** — pushing a `v<version>` tag builds per-platform CLI bundles
  for six runtimes (`win-x64`, `win-arm64`, `linux-x64`, `linux-arm64`, `osx-x64`,
  `osx-arm64`), packs the NuGet package, creates the GitHub Release (notes from
  `release-notes-<version>.md`) and pushes stable versions to nuget.org; `docs/` is
  mirrored to the repository wiki and deployed to GitHub Pages (side menu in both).
- **Lean CLI bundles** — `rvzsharp_v<version>_<rid>.zip` ships the `RVZSharp` executable
  (`RVZSharp.exe` on Windows) as a framework-dependent single-file binary (the .NET 10
  runtime is not embedded and is installed once on the target machine) plus `LICENSE`,
  `README.md`, `WhatsNew.md` and `THIRD-PARTY-NOTICES.md`.
- **609 library tests** on each target framework plus **57 CLI tests** and 276 real-file slow tests (90 RVZ games).

## 1.0.0 (2026-08-15)

First stable release: byte-exact RVZ/WIA decoding and encoding, GCZ writing, legacy decoders
(GCZ, CISO/WBI, WBFS incl. split files, TGC, NFS, plain ISO), Dolphin-compatible CLI and a
fully documented library API. See [Release notes 1.0.0](release-notes-1.0.0.md).