Skip to content
CAI
Software that uses CAICheck a score

open-cqrs/opencqrs

59.7

Adequate · 9 November 2026

9.2k

lines of production code

Java

primary language

10

measurements over time

CAI band scale
CAI trend line
CAI lens gauges

What this system is

Features

Enable article brainstorming and writing capabilities

The system now includes skills for brainstorming and writing articles. This is implemented by adding symbolic links in the .codex/skills directory that point to the corresponding skill definitions located in the .claude/skills directory, effectively activating these functions for the user.

.codex · high confidence

EventQL query support and API simplification

The ESDB client now supports EventQL queries, introducing a new \eventql\ package with classes like \EventQuery\, \EventQueryBuilder\, and handlers for processing results and errors. The \EsdbClient\ class no longer implements the removed \Client\ interface, simplifying the API surface. Additionally, new preconditions \SubjectIsPopulated\ and \EventQlQueryIsTrue\ allow for more complex write operations, and the \ping\ and \authenticate\ methods now verify specific event types in responses for better compliance.

esdb-client/src/main/java/com/opencqrs/esdb/client · high confidence

Behavioural changes

Adopts Spring Boot 4 health APIs and JSpecify null-safety annotations

The Spring Boot auto-configuration module has been updated to align with Spring Boot 4, migrating health indicator implementations from the legacy \org.springframework.boot.actuate.health\ package to the new \org.springframework.boot.health\ API. This change also introduces JSpecify annotations (via \@NullMarked\) to improve null-safety across the client package, removes unnecessary validation constraints from configuration properties, and renames internal beans (such as the Jackson marshaller) to prevent naming clashes with other frameworks.

esdb-client-spring-boot-autoconfigure · high confidence

Documentation site overhaul: search, blog, and updated framework references

The documentation site now includes a search feature with improved tokenization for CamelCase identifiers, and a new blog section for news and articles. The site URL has changed to docs.opencqrs.com, and the framework version is updated to 2.0.0 with ESDB 1.2.0 and Spring Boot 4.1.0 references. New navigation items include 'Reliable Event Handling in a Distributed Environment' and 'Test Support', while 'Upcasting a Single Event' is renamed to 'Upcasting Events'. A custom macro in main.py now generates Javadoc links for Java classes, and social links are updated to include an email address and LinkedIn.

mkdocs · high confidence

Enhanced null safety and refined command subject precondition handling

The framework now adopts JSpecify annotations for improved null safety, replacing previous Jakarta validation constraints with explicit nullability markers across command handlers, state rebuilding, and event processing components. This change allows command handlers and state rebuilding operations to explicitly accept and return null instances, reflecting real-world state transitions. Additionally, command execution now supports passing explicit preconditions via new \publish\ and \publishRelative\ methods on \CommandEventPublisher\, enabling handlers to enforce additional subject conditions (such as \SubjectIsPristine\ or \SubjectIsPopulated\) beyond those implicitly applied by the router. A new \CommandSubjectConditionViolatedException\ abstract base class unifies subject-related violations, and the \EventHandlingProcessor\ now exposes an \isRunning()\ status check for better lifecycle monitoring.

framework/src/main · high confidence

Fluent test API refactored with JSpecify null safety and simplified generics

The command handling test fixture now uses a redesigned fluent API (GivenDsl, ExpectDsl, EventSpecifierDsl, EventAsserting) that replaces the previous methods like givenNothing() and expectSuccessfulExecution() with a chained style (given().nothing().succeeds()). The fixture class has been simplified by removing the generic result type parameter, reducing CommandHandlingTestFixture from three generics to one. JSpecify annotations (@Nullable, @NullMarked) have been introduced to improve null safety. Additionally, Spring Boot compatibility is updated by migrating type exclude filter imports to the new context filter package and renaming getKnownIncludes.

framework-test/src/main · high confidence

New developer tooling and documentation updates

This change introduces several new configuration files and updates existing documentation. A new \.mcp.json\ file configures the GitHub MCP server for local development, while \jreleaser.yml\ and \MAINTAINER.md\ establish the pipeline for publishing to Maven Central. The \flake.nix\ file is updated to include \jreleaser-cli\, \gh\, and \github-mcp-server\ in the Nix development environment. Documentation is enhanced with a new \CLAUDE.md\ defining article pipeline workflows and terminology, and \README.md\ is updated to include dynamic shields.io badges, corrected version placeholders (\{{version}}\), and a link to sample applications. Additionally, \.gitignore\ and \.envrc\ are refined to better handle local environment files and build artifacts.

(repo-wide) · high confidence

Rebrand example application to OpenCQRS and update configuration

The example application has been rebranded from 'dxfrontiers' to 'OpenCQRS', involving a package rename from \de.dxfrontiers.cqrs.example\ to \com.opencqrs.example\ across all Java sources, including the main entry point (now \LibraryApplication\), domain models, and REST controllers. This change is accompanied by a behavioral update to the Spring Boot configuration, where the application property prefix has been renamed from \cqrs\ to \opencqrs\. Additionally, the \JdbcProgressTracker\ bean now explicitly sets \setProceedTransactionally(true)\ to ensure transactional progress tracking, and the event type resolver has been updated to use the new \com.opencqrs.example\ namespace for event identifiers.

example-application/src/main · high confidence

Spring Boot auto-configuration overhaul: renamed beans, new property prefix, and null-safety

The Spring Boot auto-configuration layer has been refactored to improve compatibility and safety. All auto-configured beans (such as command routers, event handlers, and caches) are now prefixed with 'openCqrs' to prevent name clashes with other frameworks. The configuration property prefix has changed from 'cqrs' to 'opencqrs' (e.g., 'opencqrs.event-handling'). The framework now honors the Spring @Order annotation on @StateRebuilding and @EventHandling handlers, allowing users to control execution order. Additionally, the codebase has adopted JSpecify for improved null safety, and the default transactional behavior for event handlers using JdbcProgressTracker has been changed to non-transactional to avoid unintended side effects.

framework-spring-boot-autoconfigure/src/main · high confidence

Support for read subjects API and EventQL preconditions with improved null safety

The Jackson marshaller now supports the new read subjects API, adding methods to serialize base subject requests and deserialize subject response lines, as well as handling subject elements in response streams. It also introduces two new preconditions, isSubjectPopulated and isEventQLQueryTrue, allowing users to enforce subject presence and EventQL query conditions. Under the hood, the implementation migrates from the standard Jackson library to the tools.jackson variant, removes strict validation annotations (like @NotNull and @NotBlank) from event payload records in favor of JSpecify's @Nullable annotations, and marks the package as null-marked to improve overall null safety.

esdb-client/src/main/java/com/opencqrs/esdb/client/jackson · high confidence

Test coverage

Added tests for EventQL query preconditions and error handling; Added tests for Spring Boot auto-configuration ordering, property prefixes, and lifecycle fallbacks; Refactored command handling test fixtures and configuration; Updated example application tests to use fluent test API; Updated tests for Spring Boot 4, JSpecify null-safety, and command concurrency preconditions.

Dependencies

Gradle Wrapper upgraded to version 9.6.0

The Gradle wrapper has been updated to use Gradle 9.6.0 (previously 8.14). This change ensures that builds are executed with the new Gradle version, which may include performance improvements, bug fixes, and new features available in the 9.x release line.

gradle · high confidence

Upgrade to Spring Boot 4 and introduce null-safety checks

The project has upgraded its core dependency from Spring Boot 3.4.5 to version 4.1.0, which also updates the EventSourcingDB client to version 1.2.0. To support this major version jump, the build now targets Java 21 and replaces legacy starters (such as \spring-boot-starter-web\ and \spring-boot-starter-validation\) with their modern equivalents like \spring-boot-starter-webmvc\ and \spring-boot-starter-jackson\. Additionally, the build system now enforces null-safety using NullAway and JSpecify, and includes new Gradle tasks to generate documentation and dynamic shields.io badges for the project's versioning.

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

Lenses

  • Code Health 96 → 96 (+0.0)
  • Architecture 86 → 86 (-0.2)
  • Maturity 66 → 74 (+7.4)
  • Readiness 38 → 38 (+0.0)
  • Security 77 → 77 (+0.0)
  • Domain Modelling 89 → 89 (+0.0)

Resolved (3)

  • Documentation: contradicts the code (mkdocs/docs/reference/modules/index.md)
  • Documentation: no architecture or design documentation (README.md)
  • Off-boarding risk: anonymized user #1

New (3)

  • Off-boarding risk: anonymized user #1
  • Outdated (compile): net.minidev:accessors-smart
  • Outdated (compile): net.minidev:json-smart

Changes since last survey

  • 1 commits — 1 feature/other, 0 fixes

By area

  • mkdocs/hooks — 1 commit

Notable commits

  • change: docs(blog): point every post's canonical link to its copy on digitalfrontiers.de

Architecture

  • Unchanged — 0 containers · 6 contexts · 8 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

open-cqrs/opencqrs 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 901be15cb762f61a32020e37fa3a4789b3db8589 — 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-b921b700395b.