Repository navigation
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.