Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
6 changes: 6 additions & 0 deletions .github/workflows/formal.yml
Original file line number Diff line number Diff line change
Expand Up @@ -47,6 +47,12 @@ jobs:
# satisfiable by a protocol that never acks anyone.
- cfg: DgenRegistryReplicationAckReachable
expect: fail
# The gather's deadline modeled: the version-defined `degraded` flag is
# sound (DegradedFlagSound), and its canary proves the path is reached.
- cfg: DgenRegistryReplicationDegradedAssume
expect: pass
- cfg: DgenRegistryReplicationDegradedReachable
expect: fail
steps:
- uses: actions/checkout@v3
- uses: actions/setup-java@v4
Expand Down
19 changes: 19 additions & 0 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,24 @@
# Changelog

## v0.4.3 (TBD)

### Bug fixes

- When a follower forwards a registration and the leader changes at the same
time, the registration is now re-driven to the new leader rather than answered
with `no`.
- A buffered unregister is no longer lost when the leader changes mid-commit.
- A partition heal no longer stalls the leader on conflict-detection liveness
probes; they run off its loop.
- `whereis_name/1` and `get_metadata/1` no longer briefly read a bound name as
`undefined` while a member re-baselines its replica (a resync or handoff).

### Enhancements

- `dgen_registery_member`'s internal implementation is refactored into
`dgen_registry_replica`, `dgen_registry_intents`, `dgen_registry_pipeline`,
and `dgen_registry_conflicts`.

## v0.4.2 (2026-10-04)

### Enahancements
Expand Down
17 changes: 7 additions & 10 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -20,13 +20,12 @@ in theory, be substituted, but for now FDB is the only implemented backend.
- **`dgen_server`** — the `gen_server` programming model (same callbacks, same
return shapes), backed by durable state and a durable message queue instead
of process memory. Any number of processes, on any number of nodes, can
consume from the same server concurrently. See the
[dgen_server design doc](docs/design/dgen_server_design.md).
consume from the same server concurrently, and via strict serializability
of FoundationDB, `gen_server` semantics are preserved.
- **`dgen_registry`** — an OTP-compatible process registry: give a running
process a logical name and find or message it by name from anywhere in the
cluster, via the standard `{via, dgen_registry, {RegistryName, LogicalName}}`
contract. See the
[dgen_registry design doc](docs/design/dgen_registry_design.md).
contract.

Both are built on the same idea: push state and coordination into a
strongly-consistent backend, so the OTP programming model you already know
Expand Down Expand Up @@ -74,17 +73,15 @@ end
configuration.
- [formal/README.md](formal/README.md) — the TLA+ model of `dgen_registry`'s
replication protocol.
- [`eta`](https://hexdocs.pm/eta) — `dgen_registry` is partally
tested with Deterministic Simulation Testing, to assist in verification
of the actual implementation of the TLA+ model, including its invariants.
The framework for driving the simulation was extracted to a separate
library for general use.
- [test/support/sim/README.md](test/support/sim/README.md) — deterministic
simulation testing of `dgen_registry` against the same invariants, driven by
[`eta`](https://hexdocs.pm/eta).
- API reference and getting-started guides: <https://hexdocs.pm/dgen>.
- [CHANGELOG.md](CHANGELOG.md) — release notes.

## AI full disclosure

- This software is developed with strong assistance from LLMs and with humans
- This software is developed with strong assistance from LLMs and with humans
leading the ideas, testing, and debugging. We say this openly because it shaped
how the project was built. If you are not happy with AI-developed code, this
software is not for you. This disclosure was adopted from [antirez/ds4](https://github.com/antirez/ds4).
Expand Down
1,305 changes: 407 additions & 898 deletions docs/design/dgen_registry_design.md

Large diffs are not rendered by default.

Loading
Loading