Changelog
NAME
changelog - fourteen releases, two of them breaking
Also available as an Atom feed and as structured data at /api/releases.json.
CONVENTIONS
- Dates are release dates in UTC. There are no unreleased entries on this page: a change appears here when a tag exists.
- Breaking marks a change that can make a previously passing pipeline fail, including lock format changes.
- Patch releases exist only where a fix mattered enough to cut one. There is no monthly cadence and there will not be one.
- Version 0.x means the lock format may still change. Each change reads the previous format and says what to do.
RELEASES
0.9.4 2026-09-24
- Fixed -
--timeoutwas armed around the whole run but not checked inside the decode loop, so a 40 GB file ignored it until the first record boundary after expiry. It is now checked every 4096 records. - Fixed -
explain --pathon a path ending in[]printed the parent instead of the element shape. - Changed - The header line reports elapsed time in milliseconds below one second, instead of printing
0.18s.
0.9.3 2026-08-20
- Fixed - Windows path handling: a drive-letter path passed to
--schemawas split on the colon and treated as a URL-like prefix. - Fixed - Wildcard
ignorepatterns matched one segment too many, someta.*also hidmeta.a.b. - Fixed - Carriage returns at the end of newline-delimited input produced an input error on the last record only.
0.9.0 2026-06-09
- Added - OCI image, published to
reg.driftpipe.shand built from the release tag. - Added -
--print-config, which resolves every setting and names the source it came from. - Changed - Lock format 3: unions are written sorted with
|, and thesampleandmax_depthused at snapshot time are recorded. Format 2 locks are still read. - Changed - Breaking:
--samplenow defaults to 5000 instead of reading the whole stream. Pipelines that relied on the old behaviour need--sample 0.
0.8.1 2026-02-26
- Fixed - Gzip detection consumed two bytes from standard input and did not put them back, so a gzipped stream on a pipe failed while the same file on disk worked.
0.8.0 2025-12-04
- Added -
--max-depthand thedepth_exceededclass. Previously a pathological document could grow the path set without bound. - Added - Lock format 2, carrying the note and the record count. Format 1 locks are upgraded in place by
snapshot --force. - Changed - A path that is both widened and made nullable is now reported once, as nullability, instead of twice.
0.7.0 2025-08-11
- Added - The
explaincommand, with a text tree and a JSON form. - Added -
--noteon snapshot. - Fixed - The summary line counted an ignored path as a difference when the pattern contained
[].
0.6.1 2025-04-29
- Fixed - Report order depended on map iteration, so two runs over the same input could print the same differences in a different order. Paths are now sorted bytewise before comparison.
0.6.0 2025-04-03
- Added -
--format github, emitting annotation lines that point at the entry in the lock file. - Added -
--fail-onwithanyandbreaking, replacing the older--strictboolean. - Changed -
--strictis accepted as a hidden alias and prints a deprecation line on standard error.
0.5.0 2025-01-15
- Changed - Breaking: the type model was rewritten.
intandfloatare separate types with one widening edge between them, and nullability became its own class rather than a flag on the path. Locks written by 0.4.x cannot be compared and must be re-snapshotted. - Removed - The
numbertype, which collapsed integers and reals and hid the most common real drift we saw in practice.
0.4.1 2024-10-22
- Fixed -
--ignorewith an array segment was matched against the pre-collapse path and never fired.
0.4.0 2024-10-07
- Added - Config file
.driftpipe.yml, therulesmap, and the documented precedence between flag, environment and file. - Added -
DRIFTPIPE_CONFIG.
0.3.0 2024-07-18
- Added -
--format json. - Added - Gzip input, detected from the first two bytes.
- Changed - Colour is disabled automatically when standard output is not a terminal.
0.2.0 2024-05-02
- Added -
--ignore, repeatable, with the path pattern syntax that is still in use. - Changed - Drift exits 3; usage errors keep 1 and input errors move to 2. Before this release everything non-zero was 1, which made the tool unusable in a pipeline that wanted to tell the two apart.
0.1.0 2024-03-12
- Added - First release.
checkandsnapshot, newline-delimited JSON input, text output, lock format 1.
LOCK FORMAT HISTORY
| Format | Introduced | Read by 0.9.4 | Note |
|---|---|---|---|
| 3 | 0.9.0 | yes, current | sorted unions, snapshot settings recorded |
| 2 | 0.8.0 | yes | upgraded in place by snapshot --force |
| 1 | 0.1.0 | no, exit 4 | predates the int and float split; re-snapshot |
A lock written by a future format also exits 4 rather than being read optimistically. The message names both versions, so the fix is obvious from the CI log alone.