Repository navigation
Releases
Releases · nagarjunak-pixel/helios-consensus
v1.1.0 — Library-Style Raft, Segmented WAL, Jepsen DST & WGL Linearizability
Changelog
All notable changes to helios-consensus are documented in this file.
[1.1.0] - 2026-11-18
Added
- Library-Style Raft Core (
helios_consensus.core): Pure deterministic state machine (RaftNode,RaftLog,Progress) withPreVote(§9.6), two-windowCheckQuorum+ leader stickiness (§6),Probe/Replicate/Snapshotflow control, conflict-term log backtracking,ReadIndexlinearizable reads (§8),TimeoutNowleadership transfer (§3.10), single-serverADD_LEARNER/PROMOTE/REMOVE, and Ongaro §6 two-phaseJoint Consensus(C_{old,new}->C_new). - Crash-Safe Binary Storage & Chunked Snapshots:
SegmentedWALwith25-byte CastagnoliCRC32Cbinary frames, segment rotation, snapshot garbage collection,PosixDiskFS(os.fsync+ atomic directory sync),SimulatedDiskFS(volatile page cache vs durable platters, torn power-cut tails, silent bitrot injection), andSnapshotAssembler(CRC32Cper chunk + RFC-6962 SHA-256 Merkle root). - 520-Line Native C++20 Acceleration Engine (
_csrc/helios_kernels.cpp): Slicing-by-8CRC32C, Lamping–Veach Jump Consistent Hash, binary WAL encoder/recovery scanner, Wing–Gong–Lowe bitmask register linearizability solver (N <= 62), single/joint quorum watermark, and FIPS 180-4 SHA-256 + RFC-6962 Merkle root — packaged inside the wheel with bit-exact Python fallbacks. - Asyncio TCP Transport & Multi-Raft Sharding:
RaftTCPServerandRaftKVClient(CRC32C-framed loopback/LAN RPCs, leader hints,(client_id, seq)session deduplication, chunkedInstallSnapshotcatch-up) plusMultiRaftCluster(Jump-Hash shard placement, onlinesplit_rangewith session table cloning and epoch fencing, andTimeoutNowleader rebalancing). - Jepsen-Style Simulator, WGL Linearizability & 7-Mutant Suite: Seeded fault-injection harness (
SimCluster), P-compositional Wing–Gong–Lowe(READ, WRITE, CAS)linearizability checker, andhelios kill-mutantsverifying7/7(100%) protocol & unsynced-WAL bug kills (double_vote,no_election_restriction,no_truncate_on_conflict,stale_read,commit_prior_term,volatile_vote,unsynced_wal_power_cut).
Changed
- Moved C++20 kernel source into
src/helios_consensus/_csrc/helios_kernels.cppand addedpy.typed, classifiers, sdist includes, and accurateApache-2.0SPDX metadata for PyPI distribution. - Expanded
pytest+Hypothesistest suite to 59 test cases (97.39%line coverage across4,150+Python statements).
[1.0.0] - 2026-11-16
Added
- Initial logical-tick 5-node Raft split-brain simulator, bounded 3-node explicit-state BFS checker (
985states), HotStuff 3-chain BFT simulation, C++20 Jump-Hash/CRC32C helper, FastAPI server, and React Workbench UI.
HeliosConsensus v1.0.0 — Deterministic Raft DST, TLA+ BFS Prover & HotStuff 3-Chain BFT
Initial v1.0.0 release of HeliosConsensus (helios-consensus):
- FoundationDB-Style Deterministic Simulation Raft Engine: 54-tick asymmetric split-brain partition + heal (
197routed /69dropped,4linearizable commits, SHA-25656f7268125480081, Hypothesis randomized schedule verified). - TLA+-Style Explicit-State BFS Model Checker: Explores
985reachable states /2,064transitions (depth=7) provingElectionSafety,LogMatching, andLeaderCompleteness, and synthesizes a minimal 4-step BFS counterexample when Ongaro§5.4.1is mutated. - Chained HotStuff 3-Chain BFT Finality (
N=7, f=2):2f+1=5Quorum Certificates (>=3overlap),6finalized blocks across9views,16Byzantine double-vote equivocations rejected. - Native C++20 Jump Consistent Hash & Castagnoli CRC32C WAL Kernels:
clang++ -O30.07660keys moved on12->13shards vs1/13 = 0.07692ideal (0Python mismatches across20,000keys) and64/64(100%) single-bit WAL corruptions caught (0xE3069283RFC-3720 verified). - Live
qwen3.5:4bQuorum-Invariant CEGIS Gate: Lifts rawPass@1from3/6(50.0%) to5/6(83.33%,+33.33%lift) while fail-closed blocking1/6unsafe hybrid BFT config (0split-brain leaks).