Skip to content
CAI
Software that uses CAICheck a score

apache/pekko-persistence-cassandra

54.9

Adequate · 9 November 2026

9k

lines of production code

Scala

primary language

7

measurements over time

CAI band scale
CAI trend line
CAI lens gauges

What this system is

Features

A configuration file for the site-link-validator tool has been added to define how documentation links are checked. It maps external documentation URLs (such as Pekko persistence Cassandra docs and ScalaDoc) to local file paths for offline validation, and ignores specific external prefixes like Datastax, GitHub, and Javadoc to prevent false positives from rate limiting or access restrictions.

scripts · high confidence

Configurable Cassandra compaction strategies for journal and tag tables

The Cassandra journal now supports configuring the compaction strategy for both the main journal table and the tag views table via the \table-compaction-strategy\ configuration path. Users can choose between SizeTiered, Leveled, and TimeWindow compaction strategies, each exposing specific tuning parameters (such as \sstable\_size\_in\_mb\ for Leveled or \bucket\_high\/\bucket\_low\ for SizeTiered) to optimize storage and performance. The system validates these configuration settings and generates the appropriate CQL \WITH compaction\ clauses during keyspace and table creation.

core/src/main/scala/org/apache/pekko/persistence/cassandra/journal · high confidence

Configurable max buffer size for tag writing

The \EventsByTagSettings\ now exposes a \max-buffer-size\ configuration option that controls the internal buffer capacity for the \TagWriter\. When this limit is reached, the \TagWriter\ rejects new writes with a \TagWriterBufferFullException\ instead of buffering them indefinitely, ensuring that users can tune back-pressure behavior and prevent unbounded memory growth during high write throughput or Cassandra latency issues.

repository · high confidence

Initial Apache Pekko build infrastructure and dependency configuration

The project build system has been established with Apache Pekko as the core framework, replacing the previous Akka foundation. This change introduces the build configuration for Apache Pekko Persistence Cassandra, setting the default Scala version to 2.13.18 with support for Scala 3.3.8 and 3.9.0. It configures the project to depend on Apache Pekko Core 2.0.0-M4, Pekko Connectors Cassandra 2.0.0-M1, and Pekko Management 2.0.0-M1, alongside the Cassandra Java Driver 4.19.3 and Netty 4.2.18.Final. The build also sets up standard Apache 2.0 licensing headers, automated versioning via dynver, and documentation generation using Paradox.

project · high confidence

Initial implementation of Cassandra query stages and support classes

This change introduces the core Scala source files for the Cassandra persistence query module, including the stream processing stages for \AllPersistenceIds\, \EventsByPersistenceId\, and \EventsByTag\, along with supporting components like \CassandraReadJournalProvider\, \CassandraReadStatements\, \QuerySettings\, and \TagViewSequenceNumberScanner\. These files establish the internal API for querying persisted events from Cassandra, handling pagination, buffering, and tag-based event retrieval.

core/src/main/scala/org/apache/pekko/persistence/cassandra/query · high confidence

Initial implementation of Cassandra snapshot store for Apache Pekko

This change introduces the core components for persisting and loading snapshots in Apache Pekko Persistence Cassandra. It adds CassandraSnapshotStatements to define the CQL schema (keyspace and table creation, CRUD operations) and CassandraSnapshotStore to handle the actor-level logic for saving, loading, and deleting snapshots, including support for metadata and retry logic for load attempts. SnapshotSettings is added to configure keyspace/table auto-creation, read/write profiles, and compaction strategies. This provides the foundational snapshot storage capability for Pekko actors using Cassandra.

core/src/main/scala/org/apache/pekko/persistence/cassandra/snapshot · high confidence

Introduction of CassandraReadJournal for Pekko Persistence Query API

The CassandraReadJournal implementation is now available in the \org.apache.pekko.persistence.cassandra.query.scaladsl\ package, enabling users to query persisted events via the standard Pekko Persistence Query API. This component provides Scala API access to read journals, supporting queries for persistence IDs, events by persistence ID, and events by tag, and is retrieved using the identifier \pekko.persistence.cassandra.query\.

core/src/main/scala/org/apache/pekko/persistence/cassandra/query/scaladsl · high confidence

Java API for Cassandra Read Journal

Added the Java DSL implementation for the Cassandra persistence read journal, providing a \CassandraReadJournal\ class that exposes query methods such as \eventsByTag\, \eventsByPersistenceId\, and \currentEventsByPersistenceId\ to Java applications. This component acts as a wrapper around the underlying Scala implementation, enabling Java users to retrieve persisted events via the standard Pekko Persistence Query API.

core/src/main/scala/org/apache/pekko/persistence/cassandra/query/javadsl · high confidence

New Cassandra tag reconciliation API for repairing tag views

A new reconciliation subsystem has been added to the Cassandra persistence plugin, providing a public API to repair inconsistencies between the tag\_views table and the messages table (e.g., after split-brain events or multi-location persistence issues). The \Reconciliation\ class allows users to rebuild tag views for specific persistence IDs via \rebuildTagViewForPersistenceIds\ or delete tag view entries for specific persistence IDs and tags via \deleteTagViewForPersistenceIds\. This feature includes internal components for scanning tag progress, managing tag writer actors, and executing the necessary database operations, with a requirement that reconciliation should not run concurrently with normal application activity.

core/src/main/scala/org/apache/pekko/persistence/cassandra/reconciler · high confidence

New Cleanup tool for deleting persistence events and snapshots

Added a new \Cleanup\ utility class that allows users to delete all events and/or snapshots for a list of \persistenceIds\ without running persistent actors. The tool supports dry-run mode for safe testing, configurable retention policies (keeping N snapshots or those after a specific timestamp), and includes a \close\ method to properly release the reconciliation actor started for tagged event operations. It also introduces a \RetryableFutureEval\ helper to handle lazy, retryable evaluation of Cassandra session preparations.

core/src/main/scala/org/apache/pekko/persistence/cassandra/cleanup · high confidence

Pekko Persistence Cassandra core implementation

The core source files for the Apache Pekko Persistence Cassandra plugin have been introduced, providing the foundational components for event sourcing and snapshotting. This includes the \EventsByTagMigration\ utility for migrating tag data to the new schema, \CassandraStatements\ and \KeyspaceAndTableStatements\ for managing database schema creation, and \Extractors\ for reading and deserializing events from Cassandra rows. The update also adds \PluginSettings\ for configuration validation (including keyspace and table name checks), \Retries\ for handling transient failures, and \CassandraHealthCheck\ for monitoring plugin availability.

core/src/main/scala/org/apache/pekko/persistence/cassandra · high confidence

Repository initialization and governance configuration for Apache Pekko Persistence Cassandra

The repository has been initialized with the Apache Pekko Persistence Cassandra project, establishing the foundational governance and development infrastructure. This includes the addition of the \.asf.yaml\ file to configure GitHub repository settings such as protected branches, required status checks, and community features like discussions. A comprehensive \CONTRIBUTING.md\ guide and \AGENTS.md\/\CLAUDE.md\ files for AI coding agents have been added to define the development workflow, code style requirements (using scalafmt), and licensing rules. The project also introduces a \docker-compose.yml\ to facilitate local testing with Cassandra and ScyllaDB instances, alongside standard Apache artifacts like \LICENSE\, \NOTICE\, and \CHANGELOG.md\. The \README.md\ has been updated to reflect the project's status as a fork of Akka Persistence Cassandra and to direct users to the new Pekko documentation.

(repo-wide) · high confidence

Removals

Removal of Cassandra journal implementation

The Cassandra persistence journal implementation has been removed from the codebase. This change deletes the core journal class, the replay logic trait, the database schema statements, and the utility package object that handled Cassandra-specific conversions, effectively eliminating support for using Cassandra as a persistence store for Akka Persistence.

src/main/scala · high confidence

Behavioural changes

Example application configuration migrated to Apache Pekko

The example application's resource files (common.conf, local.conf, kubernetes.conf, and logback.xml) have been updated to use Apache Pekko instead of Akka. This includes switching actor system providers, persistence journal/snapshot-store plugins, and cluster management settings to their Pekko equivalents, allowing users to run the end-to-end event tagging example against a Cassandra backend using the new Pekko-based stack.

example/src/main/resources · high confidence

Example application migrated to Apache Pekko

The example application in example/src/main/scala has been rewritten to use the Apache Pekko API instead of the previous Akka implementation. This includes updating all actor and persistence imports to the org.apache.pekko namespace, adopting Scala 3 syntax, and adjusting the code to align with Pekko's typed persistence and cluster sharding patterns. Users running this example will now interact with the Pekko-based event sourcing and read-side processing logic.

example/src/main/scala · high confidence

Migration to Pekko configuration namespace

The default configuration file (reference.conf) has been updated to use the 'pekko.persistence.cassandra' namespace instead of the previous 'akka.persistence.cassandra' namespace. This change aligns the plugin with the Pekko ecosystem, requiring users to update their configuration references to point to the new Pekko-based plugin identifiers and settings paths.

core/src/main/resources · high confidence

Removal of default Cassandra journal configuration

The default configuration file for the Cassandra persistence journal (reference.conf) has been removed. Users can no longer rely on the built-in defaults for connection details such as contact points, keyspace, table names, and consistency levels; these settings must now be explicitly provided in the application's own configuration.

src/main/resources · high confidence

Suppress binary compatibility warnings for internal API changes

This update adds exclusion filters for sbt-mima-plugin 1.2.0 to suppress binary compatibility warnings regarding internal, non-public API changes. Specifically, it excludes warnings for \TagWriterSettings\ (which gained a \maxBufferSize\ field) and \TaggedPreparedStatements\ (where return types changed from \Future\ to \RetryableFutureEval\). These changes affect only \@InternalApi\ classes and do not impact the public API.

core/src/main/mima-filters · high confidence

Test coverage

Added DSE-specific test infrastructure and session provider example; Added compile-only documentation tests for Cassandra Reconciliation API; Added comprehensive test coverage for Cassandra query operations; Added comprehensive test suite for Cassandra journal; Added comprehensive test suite for Cassandra persistence plugin; Added multi-node tests for Cassandra-backed EventsByTag persistence; Added test coverage for Cassandra reconciler tag view operations; Added test for Cluster Sharding quick termination behavior; Added test resource configurations for logging and driver metrics; Added tests for Cassandra compaction strategy configuration; Added tests for Cassandra snapshot store metrics, retry logic, and metadata handling; Added tests for Cleanup lifecycle and deletion operations; Added tests for RetryableFutureEval behavior; Removal of Cassandra journal integration tests.

Dependencies

Migration from Akka to Apache Pekko

The project has been rebranded and migrated from Akka to Apache Pekko. The build configuration now uses Pekko dependencies (such as pekko-persistence, pekko-stream, and pekko-connectors-cassandra) instead of Akka equivalents, and the artifact name has changed from akka-persistence-cassandra to apache-pekko-persistence-cassandra. This is a foundational dependency update that affects the entire library's runtime and build environment.

(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 52 → 55 (+2.4)
  • Rubric changed (rubric-2026.10.5 → rubric-2026.11.2) — scores are not directly comparable.

Lenses

  • Code Health 71 → 71 (+0.0)
  • Architecture 73 → 72 (-1.2)
  • Maturity 34 → 50 (+16.4)
  • Readiness 73 → 74 (+0.9)
  • Security 64 → 46 (-18.1)
  • Performance 82 → 100 (+18.3)

Resolved (3)

  • Dependency hygiene PARTLY measured — sbt declarations read, dependency currency not (Maven Central unreachable)
  • Documentation: no project overview (docs/src/main/paradox/read-journal.md)
  • Off-boarding risk: anonymized user #1

New (2)

  • Off-boarding risk: anonymized user #1
  • Outdated: org.hdrhistogram:HdrHistogram

Changes since last survey

  • 6 commits — 6 feature/other, 0 fixes

By area

  • project/Dependencies.scala — 3 commits
  • .github/workflows — 1 commit
  • core/src — 1 commit
  • project/build.properties — 1 commit

Notable commits

  • change: Bump coursier/cache-action from 8.2.0 to 9.0.1 (#520)
  • change: Update Pekko core to 2.0.0 (#521)
  • change: Update logback-classic to 1.6.6 (#517)
  • change: Update netty-handler to 4.2.20.Final (#522)
  • change: Update sbt, scripted-plugin to 1.13.1 (#519)
  • change: Update scala3-library to 3.3.9 (#518)

Architecture

  • Unchanged — 0 containers · 1 contexts · 0 edges

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

Survey your own repository

apache/pekko-persistence-cassandra 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 9 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 b205fd97ada79794bb505de94e11af362943d05f — the exact code this score is about.
  • Scored under rubric-2026.11.2 — 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.3+preprod-bb0cb800cd0f.