Skip to content

CHANGELOG.md

Latest commit

 

History

History
113 lines (101 loc) · 6.65 KB

CHANGELOG.md

File metadata and controls

113 lines (101 loc) · 6.65 KB
Raw

Unreleased

  • Materialize per-shard exact and slash-prefix process-group cardinalities so Group.member_count/3 and Group.local_member_count/3 no longer scan memberships. Counts follow resident-row diffs across local writes, replication, snapshots, and peer eviction, and rebuild from primary ETS rows after a shard restart.
  • Add layered anti-entropy qualification: three-node StreamData lifecycle models, seeded adversarial transport histories, TLA+ models for convergence, chunk assembly, and permanent peer eviction, plus a Docker-backed Jepsen oracle across distribution, a test-only sideband TCP lane, and lossy/reordering transports. mix test is the every-PR ExUnit/property/checker gate and mix test.soak runs the six-profile nightly/release campaign.
  • Breaking: move the replica transport API from Group.Replica.Transport.* to Group.Transport.*; the default adapter is now Group.Transport.DistErl. The boundary also names logical direction rather than implementation mechanics: adapters implement outgoing/5, sideband adapters use Group.Transport.Outbox.push/5, and receiving adapters call Group.Transport.incoming/4 or incoming_batch/4. No compatibility aliases are provided.
  • Rename the internal replica wire helper from Group.Replica.Protocol to Group.Replica.WireProtocol to avoid overloading Elixir protocol terminology. The standalone TCP adapter is retained only as hidden test infrastructure; Group ships the transport contract, dist-Erlang adapter, and outbox helper.
  • Breaking: replica protocol v3 streams exact snapshots as provisional, transport-neutral byte-targeted chunks (1 MiB by default) followed by an independently retryable terminal manifest. The sender scans once and retains only its current chunk; a concurrent mutation suppresses commit. Receivers stage in reusable shard-owned private ETS and advance the cursor only after one exact, authority-fenced assembly is complete. Chunk/commit loss, duplication, reordering, conflicting retransmission, supersession, expiry, and shard crashes remain repairable by anti-entropy. Sideband transports can use per-shard local outboxes for bounded batching without adding a hop to the default dist-Erlang adapter. Late-starting replica lanes now rebuild their view from shared exact authority when startup fanout races registration.
  • Replace replica state sends/snapshots with per-origin, generation- and cluster-epoch-fenced streams: sequenced deltas repair gaps from a bounded oplog and fall back to exact origin snapshots after pruning. Replica data now uses a pluggable nonblocking transport (dist Erlang by default via send_nosuspend), while dist Erlang remains the control plane. Nonblocking control heartbeats lease peer state, requesting a fresh authoritative hello on generation or epoch-revision changes, so a stopped Group on a connected VM cannot leave permanent registry or membership rows. Reconnects also sweep superseded per-shard receive cursors and reconstruct epochless PG rows, so reordered cluster controls cannot strand live rows from an older epoch. Full epoch authority is installed once by shard 0; matching data shards exchange constant-size lane hellos and retain shard-to-shard transport ordering. Authority capture is serialized with epoch activation, and exact versus incrementally observed revisions are tracked separately so a concurrent partial snapshot cannot be mistaken for complete authority.
  • Registry authority is retained per origin separately from the visible winner. Conflict callbacks select the winner; Group now records and propagates an authoritative loser delete, and each owner node terminates only its own losing process. This also applies to custom conflict callbacks.
  • Add Group.monitor_generation/1 so long-lived registration owners can terminate and re-register when the local membership ETS generation is lost.
  • Breaking: Group.disconnect/3 now discards the complete local view of each departed cluster — remote entries included, and monitors receive :unregistered/:left events for them — instead of removing only locally owned rows. Reconnecting resyncs through the normal snapshot exchange. connect/disconnect also raise ArgumentError for non-binary cluster names instead of silently tolerating them.
  • The registry conflict resolver now consistently includes the winner's metadata in the losing process's {:group_registry_conflict, key, winner_meta} exit reason.
  • Breaking: Group.dispatch/4 remote sends and process-DOWN replication are now non-suspending and never auto-connect. Busy dispatch drops still force a disconnect and bounded reconnect retry; replica messages are dropped and repaired by anti-entropy without disturbing the dist-Erlang control connection. Previously dispatch could block the caller and initiate new connections.
  • Configured function-form extract_meta callbacks are now applied on reads and lifecycle events (previously they were silently ignored and full metadata was exposed), and invalid :extract_meta values raise ArgumentError at startup.
  • Group.lookup/3 no longer converts ArgumentError raised by metadata extraction callbacks into a nil miss; extractor errors now propagate to the caller.
  • Invalid :shards values (zero, negative, non-integer) raise ArgumentError at startup instead of failing later during key routing.

0.2.1 (2026-07-17)

  • Add bounded Group.members/3 queries with limit: and local-owner process-group queries through Group.local_members/3

0.2.0 (2026-04-17)

  • remove deprecate message handling

0.1.8 (2026-04-17)

  • Use send_nosuspend for remote shard sends and add bounded reconnect retries after busy-link disconnects to avoid any single bad link from blocking a shard

0.1.7 (2026-04-17)

  • Fix local shard request reply leaks by using reply aliases and draining any already-delivered timeout replies

0.1.6 (2026-04-16)

  • Add bounded local PG turn-taking and bulk local PG ETS application
  • Add sender-side replicated registry / PG batching by target node

0.1.5 (2026-04-14)

  • Add receiver-side batching and fairness for replicated registry traffic

0.1.4 (2026-03-31)

  • Add named-cluster Group.connect(..., ttl: ms) leases

0.1.3 (2026-03-31)

  • Add configurable timeouts to the public register/unregister/join/leave/connect/disconnect APIs
  • Add Group.local_entries/1 for local tagged registry and process-group entries
  • Buffer replicated PG join/leave receives with configurable receiver-side flush settings and bulk ETS application

0.1.2 (2026-03-30)

  • Optimize pg ops

0.1.1 (2026-03-19)

  • Optimize DOWN handling

0.1.0 (2026-02-12) 🚀

  • Initial release!