rabbitmq/khepri
62.3
Adequate · 13 November 2026
21.3k
lines of production code
Erlang
primary language
8
measurements over time
What this system is
Features
Introduce advanced API and Elixir-friendly bang functions
The library now exposes a new \khepri\_adv\ module providing variants of standard functions that return more detailed results, such as distinguishing between a node with an \undefined\ payload and one with no payload, or retrieving the payload version for manual transactional operations. Additionally, a new \khepri\_bang\ header introduces Elixir-style 'bang' functions (e.g., \get!\, \get\_or!\) that unwrap results directly, simplifying pipeline usage for Elixir consumers.
src · high confidence
Behavioural changes
Documentation site receives a custom visual identity
The generated documentation now features a dedicated brand look, replacing the previous generic GitHub Markdown styling with a custom stylesheet (\stylesheet.css\) that applies a beige navbar and displays the Khepri logo as a background for the main heading. A custom SVG favicon (\khepri-favicon.svg\) is now served in the browser tab, and a GitHub fork ribbon is added to the page header via an external CSS library. To support this new design, the project has removed the bundled \github-markdown.css\, \prism.css\, and \prism.js\ assets, and added optimized SVG assets for the logo (\khepri-logo.svg\, \khepri-logo-inkscape.svg\) and a social media preview image (\khepri-social-preview.svg\).
doc · high confidence
Dual licensing and dependency overhaul
The project now supports dual licensing under Apache-2.0 and Mozilla Public License 2.0, with the Apache license text renamed to LICENSE-Apache-2.0 and the MPL-2.0 text added as LICENSE-MPL-2.0. The build configuration has been significantly updated: the minimum required Erlang/OTP version is raised to 27, and dependencies are now fetched from Hex.pm instead of Git, specifically pinning Ra to 3.2.0 and introducing Horus 0.5.0. The legacy rebar.config.script used for Coveralls integration has been removed, and the project now uses the rebar3\_hex plugin for documentation generation.
(repo-wide) · high confidence
Khepri API refactoring: macro renaming, stricter type checking, and new condition records
The public API in \include/khepri.hrl\ has been refactored to improve type safety and consistency. Path-related macros (e.g., \IS\_NODE\_ID\, \ROOT\NODE\) are renamed with a \KHEPRI\\ prefix (e.g., \IS\_KHEPRI\_NODE\_ID\, \KHEPRI\_ROOT\_NODE\) to avoid namespace collisions. The \IS\_KHEPRI\_CONDITION/1\ macro is now stricter, explicitly checking for specific record types rather than just tuple existence. New condition records \if\_has\_payload\ and \if\_has\_sproc\ are added, and the \if\_data\_matches\ record now supports an optional \conditions\ field. Additionally, the \if\_child\_list\_count\ record is renamed to \if\_child\_list\_length\, and error/exception macros are standardized to \khepri\_error/2\ and \khepri\_exception/2\.
include · high confidence
Test coverage
Added EUnit test suites for advanced Khepri API operations
Added new EUnit test files in the test directory to cover the advanced Khepri API (\khepri\_adv\ and \khepri\_tx\_adv\). These tests verify the behavior of node creation, insertion, update, deletion, and payload clearing operations, including both direct API calls and those executed within read-write or read-only transactions. The test coverage extends to edge cases such as non-existing nodes, wildcard path restrictions, conditional deletes, and async options.
test · high confidence
Dependencies
Dependency and application metadata management refactored to use external config files
The project's build configuration (mix.exs) has been updated to automatically derive the application name, description, and version from the source file src/khepri.app.src, and to read the list of dependencies and their version constraints from rebar.config. This change eliminates manual duplication of metadata and dependency definitions within the Mix project file, ensuring that these values remain consistent with the Rebar-based build configuration.
(dependencies) · high confidence
Written by cca.canine.dev from the codebase's own history, inside the signed delivery this page is composed from.
How this codebase got here
Score
- CAI 63 → 62 (-0.7)
- Rubric changed (rubric-2026.10.5 → rubric-2026.11.3) — scores are not directly comparable.
Lenses
- Code Health 76 → 76 (-0.1)
- Architecture 100 → 100 (+0.0)
- Maturity 55 → 55 (+0.0)
- Readiness 56 → 58 (+2.4)
- Security 78 → 68 (-10.8)
- Event Sourcing 100 → 100 (+0.0)
New (43)
- Edited copies of one member (3 members, 12+ corresponding lines) (src/khepri_cluster.erl)
- Edited copies of one member (3 members, 12+ corresponding lines) (src/khepri_export_erlang.erl)
- Edited copies of one member (3 members, 14+ corresponding lines) (src/khepri_tx.erl)
- Edited copies of one member (3 members, 6+ corresponding lines) (src/khepri.erl)
- Edited copies of one member (3 members, 7+ corresponding lines) (src/khepri_tx_adv.erl)
- Edited copies of one member (4 members, 12+ corresponding lines) (src/khepri.erl)
- Edited copies of one member (8 members, 5+ corresponding lines) (src/khepri.erl)
- Edited copy of a member (11 corresponding lines) (src/khepri.erl)
- Edited copy of a member (12 corresponding lines) (src/khepri_path.erl)
- Edited copy of a member (14 corresponding lines) (src/khepri_machine.erl)
- Edited copy of a member (15 corresponding lines) (src/khepri_tree.erl)
- Edited copy of a member (15 corresponding lines) (src/khepri_tx_adv.erl)
- Edited copy of a member (17 corresponding lines) (src/khepri_projection.erl)
- Edited copy of a member (19 corresponding lines) (src/khepri_sproc.erl)
- Edited copy of a member (20 corresponding lines) (src/khepri_export_erlang.erl)
- Edited copy of a member (22 corresponding lines) (src/khepri_machine.erl)
- Edited copy of a member (22 corresponding lines) (src/khepri_tree.erl)
- Edited copy of a member (24 corresponding lines) (src/khepri_tree.erl)
- Edited copy of a member (25 corresponding lines) (src/khepri.erl)
- Edited copy of a member (4 corresponding lines) (src/khepri.erl)
- …and 23 more
Changes since last survey
- 20 commits — 18 feature/other, 2 fixes
By area
- (repo) — 10 commits
- src/khepri_machine.erl — 5 commits
- src/khepri.erl — 2 commits
- test/trigger_shape_upgrade.erl — 2 commits
- .github/workflows — 1 commit
Notable commits
- fix: Merge pull request #443 from rgfaber/fix/trigger-v1-to-v2-conversion
- fix: Merge pull request #445 from rabbitmq/small-fixes-to-trigger_shape_upgrade-testsuite
- change: GitHub Actions: Ignore failures of the publish_docs_preview step
- change: Merge branch 'v0.14.x' into v0.15.x
- change: Merge branch 'v0.15.x' into v0.16.x
- change: Merge branch 'v0.16.x' into v0.17.x
- change: Merge branch 'v0.17.x' into v0.18.x
- change: Merge branch 'v0.18.x' into v0.19.x
- change: Merge branch 'v0.19.x'
- change: Merge pull request #436 from rabbitmq/rework-how-tx-returns-value
- change: Merge pull request #444 from rabbitmq/ignore-publish_docs_preview-failure-in-ci
- change: Store a trigger in the old format before `extended_trigger'
- change: khepri_machine: Distinguish handling of sync vs. async tx return values
- change: khepri_machine: Don't throw exceptions from khepri:handle_async_ret()
- change: khepri_machine: Make transaction functions "transparent" like stored procs
- change: khepri_machine: Move tx command return value handling to a dedicated function
- change: khepri_machine: Move tx function execution to a dedicated function
- change: khepri_machine: Set logger domain to the logged machine crash
- change: test/trigger_shape_upgrade: Add the missing copyright line
- change: test/trigger_shape_upgrade: Wrap line crossing the 80-column boundary
Written by cca.canine.dev from the codebase's own history, inside the signed delivery this page is composed from.
Survey your own repository
rabbitmq/khepri was measured the same way every project in this corpus was: the same rubric, at a pinned commit, with the result published in full. Point a surveyor at a repository you know and see whether you agree with it.
About this page
- The score is its most recent published measurement, taken on 13 November 2026 at a pinned commit. It is not a live figure and does not change until the project is measured again.
- Measured at commit a501382b46d671726ee65f18b58add5962bd0312 — the exact code this score is about.
- Scored under rubric-2026.11.3 — the same rubric and the same method as every other entry in this index.
- Measured by Canine Code Analyzer (cca.canine.dev) using cca measure-2026.11.61+preprod-b8b1a43ae4c3.