v19.0.0

v19.0.0

This is an intentional breaking release. The supported application boundary is Runtime → Lane → generated Intent/Observer values → Observation/Reading streams → Receipt. Runtime is the sole root runtime value; the v18 graph-first API and intermediate v19 prototypes are not supported package entry points.

Required migration for retained v18 state

Stop every v18 writer and back up the repository before any v19 process opens it. Rehearse first, then promote once:

npm exec --package=@git-stunts/git-warp@19.0.0 -- git-warp-v18-to-v19 --repo /path/to/repository --graph events
npm exec --package=@git-stunts/git-warp@19.0.0 -- git-warp-v18-to-v19 --repo /path/to/repository --graph events --apply

The rehearsal is non-mutating and disposable; promotion uses a compare-and-swap ref transaction and preserves additive recovery refs. Keep those refs until application reads, writes, and backups are independently verified. See the v19 migration guide.

Performance witness

On the exact merged-main Node 22/Linux gate, the representative 16-property migrated-v18 scan was 31.1% faster cold, 32.1% faster warm, used 20.1–21.3% less operation CPU, and issued 46.6% fewer Git commands than v18.2.1. A separate 256 MiB logical Observer stream completed under a 64 MiB old-space cap with 35.2 MiB peak heap. These are bounded workload contracts, not universal speed claims.

The generated PR list below includes intermediate designs that were intentionally superseded before release. The supported final surface is defined by the v19 README, changelog, and migration guide.

Registry publish summary

• npm: published
• JSR: published

Dist-tag: latest
Version: 19.0.0

If one registry failed, re-run only that job from Actions.

What's Changed

• Move graph exports behind v19 public API boundary by @flyingrobots in #726
• Expose diagnostics materialization scope helpers by @flyingrobots in #727
• Add openWarp timeline facade by @flyingrobots in #728
• Add v19 timeline intents, readings, and drafts by @flyingrobots in #729
• Fix: anchor state-cache payloads against Git GC by @flyingrobots in #732
• Tighten v19 boundary and checkpoint store seam by @flyingrobots in #730
• Enforce the v19 public API contract by @flyingrobots in #733
• Adopt git-cas as the storage composition root by @flyingrobots in #744
• Seal Git substrate out of v19 receipts and evidence by @flyingrobots in #745
• Delete dead WARP caches and homemade CAS paths by @flyingrobots in #746
• refactor(storage): delegate immutable payloads to git-cas by @flyingrobots in #749
• Fix warm state-cache materialization hits by @flyingrobots in #750
• feat(materialize): add retained CAS materialization handles by @flyingrobots in #751
• fix(materialize): stream session reduction by @flyingrobots in #752
• fix(storage): retain trie roots through git-cas by @flyingrobots in #753
• Resume exact materializations from retained git-cas roots by @flyingrobots in #754
• fix: retain bounded materialization roots by @flyingrobots in #755
• Scope retained materializations with git-cas acquisitions by @flyingrobots in #756
• Read retained node liveness without whole-state materialization by @flyingrobots in #757
• Read retained properties through git-cas 6.5 by @flyingrobots in #762
• perf: establish Git object access strategy by @flyingrobots in #763
• Adopt persistent Git object sessions and close them safely by @flyingrobots in #764
• Define witnessed admission and settlement contracts by @flyingrobots in #766
• Classify witnessed intent admission by @flyingrobots in #767
• Classify v19 writes with admission outcomes by @flyingrobots in #768
• feat(api): establish the v19 Runtime and Lane surface by @flyingrobots in #769
• fix(security): bound CBOR decoding by @flyingrobots in #770
• feat: resume retained materialization predecessors by @flyingrobots in #771
• feat: stream many-observer readings by @flyingrobots in #772
• Retain bounded live liveness materializations by @flyingrobots in #773
• Replay targeted cold node properties by @flyingrobots in #774
• Replay targeted cold edge properties by @flyingrobots in #775
• Persist sync replay protection in git-cas by @flyingrobots in #776
• Retain seek cursors with git-cas by @flyingrobots in #777
• Delegate materialization cache diagnostics to git-cas by @flyingrobots in #778
• Delegate read residency to git-cas by @flyingrobots in #779
• Unify checkpoints with retained materializations by @flyingrobots in #780
• Prove warm Observer page reuse across Runtime reopen by @flyingrobots in #781
• Enforce git-cas storage ownership in CI by @flyingrobots in #782
• Prove bounded Observer under a 64 MiB heap cap by @flyingrobots in #783
• Establish v19 materialization performance contract by @flyingrobots in #784
• Prove bounded oversized Observer streaming by @flyingrobots in #785
• Gate v19 performance regressions in CI by @flyingrobots in #787
• Add one-shot v18-to-v19 retained-substrate migration by @flyingrobots in #788
• Publish v19 charts and testing surfaces by @flyingrobots in #789
• Add runtime-backed strand forks by @flyingrobots in #795
• Add revalidated Runtime settlement plans by @flyingrobots in #796
• Generate validated v19 Intent and Observer SDKs by @flyingrobots in #797
• Align CLI and MCP with v19 vocabulary by @flyingrobots in #798
• Enforce one generated v19 vocabulary contract by @flyingrobots in #799
• Gate v19 on migrated retained-read speed by @flyingrobots in #801
• Release v19.0.0 by @flyingrobots in #802

Full Changelog: v18.2.1...v19.0.0