open-cqrs/opencqrs
59.7
Adequate · 9 November 2026
9.2k
lines of production code
Java
primary language
10
measurements over time
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.