Changelog

All notable changes to this project will be documented in this file.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

[Unreleased]

0.5.2 - 2026-08-29

Fixed

• Removed two unreachable error clauses in Gitility.Mirror and Gitility.Bundle that produced type warnings on Elixir 1.19 compiles.
• mix docs no longer warns about a link to a hidden module in the Gitility.Repository.init_bare/2 docs.
• README documents the optional rustler dependency needed for GITILITY_BUILD=1 source builds.

0.5.1 - 2026-08-29

Changed

• Allow req 0.6 and 0.7 for the optional S3 object store adapter; req 0.5.x is affected by CVE-2026-49755 and CVE-2026-49756.

0.5.0 - 2026-08-22

Added

• Gitility.Mirror.publish/4 and restore/4 for conditional, generation-aware replication of bare mirrors through object stores.
• Gitility.ObjectStore, the Local and optional-Req S3 adapters, and the reusable Gitility.ObjectStore.Conformance suite.
• Gitility.Repository.init_bare/2 for failure-atomic creation of gc-safe bare repositories.
• Gitility.Bundle.write/2 options :generation, :strict_refs, and :mode.

Changed

• Every bare repository created by Gitility is gc-safe: automatic gc, maintenance, and receive autogc are disabled. Existing repositories are never reconfigured.
• Added stable error codes :not_found, :conflict, and :malformed_bundle.

Fixed

• Gitility.history/3 and async_history/3 now return typed :invalid_argument errors naming unsupported :since or :until options instead of raising for an unknown option.

0.4.0 - 2026-08-20

Added

• Gitility.Fetch.fetch/4: bounded, cancellable smart-HTTP fetch into local bare repositories using gix, reqwest, and statically linked rustls, with credential providers, optional prune, destination single-flight leases, and a dedicated two-worker runtime.

Changed

• The Rust MSRV for from-source consumers is now 1.85, required by gix 0.86.

Fixed

• Compile warning on Elixir 1.20: bound variables in binary-size matches are now pinned (binary-size(^length)).

0.3.0 - 2026-08-20

Changed

• Breaking: Gitility.Commit fields renamed for consistency with every sibling type — id → oid, tree_id → tree_oid (matching blob_oid, commit_oid, old_oid/new_oid elsewhere).

Fixed

• Bundle.open/2/start_link/1 with an unsupported or invalid :into destination (e.g. into: :memory on macOS) now returns the documented error tuple instead of exiting the linked caller from inside the supervisor's child start.
• Consumers without the optional postgrex dependency no longer see Postgrex.* is undefined warnings on every compile.
• Gitility.read_file/3 docs now name the result's data field.

0.2.0 - 2026-08-20

Added

First functional release — the complete snapshot-first query library.

• Query API over immutable commit snapshots: Gitility.list_tree/3, read_file/3, search/3, log/2, history/3, diff/3, blame/3, and ancestor?/4 — structured, paginated results with explicit byte/entry/time budgets (Gitility.Limits), cancellable jobs, SHA-1 and SHA-256 repositories.
• Repositories and snapshots: Gitility.Repository.open/2 for local bare/normal directories (worktree never read), selector resolution (:head, {:branch, _}, {:tag, _}, {:ref, _}, {:oid, _}) into pinned Gitility.Snapshots.
• Pluggable storage behaviours: static in-memory object sets, Elixir provider callbacks (Gitility.ODB.Backend), immutable range-addressed pack stores (Gitility.ODB.RangeBackend with a LocalDirectory reference backend and publish/2), and pluggable ref stores (Gitility.RefDB.Backend).
• PackFetch hydration (Gitility.ODB.PackFetch): fetch from a remote immutable pack store under explicit request/byte budgets into a local scratch directory or straight into a bundle file (into: {:bundle, path}), with warm restarts served locally.
• Bundles (Gitility.Bundle): a complete read-only repository in one flat file — write/2 (byte-deterministic, atomic-rename publication), open/2 (into: :memory or {:dir, path}), verify/1, and info/1. Container format frozen as bundle format v1 (docs/format/bundle-v1.md): 0.2+ readers open any v1 bundle; future changes bump the format version rather than reinterpret v1 fields.
• Precompiled NIF targets: macOS arm64/x86_64, Linux glibc x86_64/arm64 (GITILITY_BUILD=1 builds from source elsewhere; Windows unsupported).