Skip to content
CAI
Software that uses CAICheck a score

basho/riak-erlang-client

63.8

Adequate · 23 September 2026

5.8k

lines of production code

Erlang

primary language

5

measurements over time

CAI band scale
CAI trend line
CAI lens gauges

What this system is

This system is an Erlang client library for interacting with the Riak distributed database. It provides a modernized build infrastructure and comprehensive support for Riak's eventually-consistent data types, including counters, flags, registers, sets, hyperloglogs, and maps. The library also facilitates standard database operations such as secondary indexing, search, and MapReduce queries, all backed by extensive unit and integration tests.

Features

Add Riak client type specifications and macros

The \riakc.hrl\ header file is introduced, defining Erlang types and macros for the Riak protocol buffer client. This includes type specifications for client options, bucket and key identifiers, MapReduce query terms, and secondary index result records. It also defines constants for timeouts and connection parameters, enabling the client to support features like secondary indexes, search, and MapReduce with proper type checking.

include · high confidence

Added support for Riak's eventually-consistent data types

The client library now supports Riak's eventually-consistent data types, including counters, flags, registers, sets, generalised sets, hyperloglogs, and maps. These new modules (riakc\_counter, riakc\_flag, riakc\_register, riakc\_set, riakc\_gset, riakc\_hll, and riakc\_map) implement a common datatype behaviour, allowing users to perform local updates that are later applied to the server. The changes also include the addition of the riakc.app.src file to define the application structure and dependencies.

src · high confidence

Removals

Removal of riakc application file

The riakc application file (ebin/riakc.app) has been removed from the project. This change affects the packaging and structure of the Riak client library, potentially impacting how the application is loaded or referenced by the Erlang runtime.

ebin · high confidence

Behavioural changes

Updated styling for generated documentation pages

The visual presentation of the generated documentation (edoc) has been updated with new CSS rules. This includes baseline typography settings (font sizes, line heights, margins) for headings and paragraphs, specific styling for code blocks and preformatted text, and custom formatting for headers, lists, and function specifications to improve readability and visual hierarchy.

priv · high confidence

Upgrade to Erlang/OTP 20+ and modernize build configuration

The client library now requires Erlang/OTP 20 or later, as reflected in the new \require\_otp\_vsn\ constraint in \rebar.config\. The build system has been modernized to use Rebar3, with the \Makefile\ delegating to \./rebar3\ for all build targets. Additionally, the \rebar.config\ file has been expanded to include EUnit verbosity, stricter compiler warnings, platform-specific defines for OTP 19 and 20 deprecations, and Xref checks for unused or undefined functions.

(repo-wide) · high confidence

Test coverage

Added unit and integration tests for the Riak client library

Added new test suites for the Erlang client, including protocol buffer socket connection handling (auto-reconnect, linger options, and disconnected states), timeseries (TS) operations, and utility functions. The tests verify connection stability, client ID management, server version retrieval, and proper error handling for invalid operations like adding to an HLL map.

test · high confidence

Written by watchdog.canine.dev from the codebase's own history, inside the signed delivery this page is composed from.

How this codebase got here

This is the PUBLIC form of this artifact. Findings are listed in full, but the details of SECURITY findings — which rule fired, in which file, on which line, and how to fix it — are deliberately withheld, and any secret-scanner results are excluded entirely. Where detail is absent here it was REMOVED FOR PUBLICATION; it is not missing from the analysis. The complete artifact is available from the repository owner.

Score

  • CAI 54 → 64 (+10.1)
  • Rubric changed (rubric-2026.08.19 → rubric-2026.09.15) — scores are not directly comparable.

Lenses

  • Code Health 94 → 92 (-1.1)
  • Architecture 100 → 100 (+0.0)
  • Maturity 21 → 48 (+26.8)
  • Readiness 74 → 66 (-8.5)
  • Security 87 → 85 (-2.1)

Resolved (8)

  • Coverage not included — suite not readable by the collector
  • Dependency hygiene not measured — dependency manifest found but not parsed for hygiene
  • No exposed public API
  • Test reliability not included
  • TooManyMethods: riakc_obj (src/riakc_obj.erl)
  • TooManyMethods: riakc_pb_socket (src/riakc_pb_socket.erl)
  • complexity unreadable for .erl, .hrl — churn × complexity hotspots could not be measured
  • dormant codebase — no living knowledge left to concentrate

New (27)

  • Coverage not measured — no coverage collector is wired up
  • Dependency hygiene PARTLY measured — rebar3 pinning read, dependency currency not (no rebar.lock-pinned Hex declaration to grade)
  • Documentation: no architecture or design documentation (README.md)
  • Documentation: no installation or build instructions (README.md)
  • Documentation: no usage examples (README.md)
  • Duplicated block (11–13 lines × 9) (src/riakc_pb_socket.erl)
  • Duplicated block (12 lines × 9) (src/riakc_pb_socket.erl)
  • Duplicated block (15 lines × 2) (src/riakc_pb_socket.erl)
  • Duplicated block (16 lines × 8) (src/riakc_pb_socket.erl)
  • Duplicated block (18 lines × 3) (src/riakc_pb_socket.erl)
  • Duplicated block (22 lines × 2) (src/riakc_pb_socket.erl)
  • Duplicated block (22 lines × 2) (src/riakc_pb_socket.erl)
  • Duplicated block (4–12 lines × 3) (src/riakc_pb_socket.erl)
  • Duplicated block (6 lines × 2) (src/riakc_pb_socket.erl)
  • Duplicated block (6 lines × 2) (src/riakc_pb_socket.erl)
  • Duplicated block (6 lines × 2) (src/riakc_ts_get_operator.erl)
  • Duplicated block (8 lines × 2) (src/riakc_pb_socket.erl)
  • High: security finding (details withheld)
  • Medium: security finding (details withheld)
  • Members sharing a duplicated core (9 members, 50+ identical tokens) (src/riakc_pb_socket.erl)
  • …and 7 more

Written by watchdog.canine.dev from the codebase's own history, inside the signed delivery this page is composed from.

Survey your own repository

basho/riak-erlang-client 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 23 September 2026 at a pinned commit. It is not a live figure and does not change until the project is measured again.
  • Measured at commit 3b6ad6e92dcb55833e9add829b2871be8468a68e — the exact code this score is about.
  • Scored under rubric-2026.09.15 — the same rubric and the same method as every other entry in this index.
  • Measured by watchdog.canine.dev using codehealth-analyzer preprod-955b9cee9818.