Skip to content
CAI
Software that uses CAICheck a score

rahulsom/grooves

58.3

Adequate · 8 November 2026

6.6k

lines of production code

Java

with Kotlin, Groovy

7

measurements over time

CAI band scale
CAI trend line
CAI lens gauges

What this system is

Features

Add CodeNarc static analysis configuration

Introduces a new CodeNarc ruleset configuration file at gradle/codenarc/codenarc.groovy to enable static code analysis for the project. The configuration enables a broad set of rule sets including basic, braces, concurrency, design, enhanced, exceptions, formatting, generic, grails, groovyism, imports, jdbc, junit, logging, naming, serialization, size, and unused rules. Several specific rules are disabled or customized, such as disabling class javadoc requirements, compile static checks, and certain naming conventions, while formatting rules like space around map entry colons are adjusted to specific regex patterns.

gradle/codenarc · high confidence

Add Kotlin-based Spring Boot example application

Introduces a new Kotlin implementation of the Grooves example application within the Spring Boot ecosystem. This includes the main application entry point, a REST controller exposing patient and event endpoints, a bootstrap component for seeding test data, and supporting beans for dependency injection, providing a concrete reference for using the Grooves library with Kotlin and Spring Boot.

grooves-example-springboot-kotlin/src/main/kotlin/grooves/boot/kotlin · high confidence

Add Push Style Event Sourcing example

The grooves-example-pushstyle module has been added to demonstrate a push-based event sourcing pattern using Grooves. This example includes a complete banking application setup with an Application entry point, an EventService that processes transactions via a Guice-injected EventBus, and a Balance snapshot implementation. It introduces ContextAwareScheduler and ContextManager to handle RxJava threading context propagation, ensuring that transaction data is correctly carried across threads during event processing. The example also provides the necessary database schema migration and test cases to verify deposit and withdrawal operations.

grooves-example-pushstyle · high confidence

Add indented method tracing via @Trace annotation

Users can now annotate methods with @Trace to enable hierarchical, indented logging of method entry, exit, and exceptions. This new AspectJ-based feature automatically tracks nesting depth and formats output at the trace level, making it easier to follow complex call flows in logs.

grooves-core/src/main/java/com/github/rahulsom/grooves/logging · high confidence

Add patient account and health query projections

New Kotlin query projections have been added for the Patient aggregate to maintain read-model snapshots. The PatientAccountQuery tracks financial state by updating the balance and money made on procedure and payment events, while the PatientHealthQuery maintains a list of procedures performed. Both components implement the framework's query support interfaces to retrieve snapshots and apply relevant domain events.

grooves-example-springboot-kotlin/src/main/kotlin/grooves/boot/kotlin/queries · high confidence

Added Spring Data MongoDB repositories for patient domain entities

The example application now includes a new \PatientRepository.kt\ file defining Spring Data MongoDB repositories for the patient domain. This introduces blocking and reactive interfaces for \Patient\, \PatientEvent\, \PatientAccount\, and \PatientHealth\, enabling data access operations such as finding events by aggregate ID and position/timestamp ranges, and retrieving account or health snapshots based on the last event position or timestamp.

grooves-example-springboot-kotlin/src/main/kotlin/grooves/boot/kotlin/repositories · high confidence

Compile-time validation of Query event handlers

The grooves-groovy module now includes internal AST transformations that enforce compile-time correctness for Query implementations. When a class is annotated with @Query, the system verifies that it contains properly signed methods (returning Publisher\<EventApplyOutcome\> and accepting the specific Event and Snapshot types) for every event registered to its associated aggregate. If a required handler method is missing or has an incorrect signature, the build fails with a clear error, preventing runtime issues caused by unhandled events.

grooves-groovy/src/main/java/com/github/rahulsom/grooves/groovy/transformations/internal · high confidence

Grooves site now features a dynamic version dropdown and Playwright-based testing

The grooves-site now includes a new landing page (index.html) with a 'Documentation' button that opens a dropdown menu dynamically populated with version links from src/versions.json (categorizing versions as supported, upcoming, and old). This functionality is implemented in src/main.ts using jQuery and Bootstrap 5, and is supported by a new npm build toolchain (npmw, .ntw.sh) and Playwright end-to-end tests (tests/dropdown.spec.ts, tests/layout.spec.ts, tests/responsive.spec.ts, tests/visual.spec.ts) that verify the dropdown behavior, layout, responsiveness, and visual appearance across different viewports.

grooves-site · high confidence

Introduce Asciidoctor extension for rendering Event Sourcing diagrams as SVG

This change adds a new Asciidoctor extension (registered as the \esdiag\ block) that allows users to embed Event Sourcing diagrams directly into their documentation. The extension parses a structured text input representing aggregates and events, then generates a scalable vector graphic (SVG) output. The rendering logic, implemented in Kotlin classes such as \SvgBuilder\, \Aggregate\, and \Event\, handles layout calculations, positioning, and the drawing of visual elements like circles, lines, and paths. Styling is defined in a new SCSS file (\esdiag.scss\) which is compiled and embedded into the SVG, supporting visual distinctions for event types such as Revert, DeprecatedBy, Join, and Disjoin. The extension automatically caches generated SVGs based on a SHA256 hash of the input content.

grooves-diagrams/src/main · high confidence

Introduce GroovesQueryImpl for snapshot computation

Added the default implementation of the GroovesQuery interface, which orchestrates functional components to build snapshots from event streams. This component handles redirects, deprecations, reverts, and exceptions, allowing users to compute aggregate snapshots by applying event logic through the provided providers and classifiers.

grooves-core/src/main/java/com/github/rahulsom/grooves/impl · high confidence

Introduce core event-sourcing query types and builder

The grooves-core module now exposes the foundational types for its event-sourcing query engine. Users can build queries via GroovesQueryBuilder, which validates that all required providers (such as snapshot, event, and deprecation handlers) are configured before creating a GroovesQuery instance. The query engine returns GroovesResult, a sealed interface distinguishing between successful snapshot computations and redirects to other aggregates or versions. Supporting types include EventType (Normal, Revert, Deprecates, DeprecatedBy) to classify event semantics, EventApplyOutcome to control snapshot processing flow, and DeprecatedByResult to track deprecation relationships.

grooves-core/src/main/java/com/github/rahulsom/grooves · high confidence

Introduce functional-style query builders for temporal and versioned snapshots

The queries package now provides a functional, builder-based API for constructing read-model queries. Users can use Grooves.versioned() and Grooves.temporal() to configure snapshot retrieval, event loading, and event application logic via fluent setters (e.g., withSnapshot, withEvents, withEventHandler). This replaces or supplements previous query construction patterns with a more composable, functional style that supports both version-based and timestamp-based snapshot computation, including support for joins and deprecation redirects.

grooves-api/src/main/java/com/github/rahulsom/grooves/queries · high confidence

Java annotation processor for query validation

Added Java support to Grooves, introducing three source-level annotations—@Aggregate, @Event, and @Query—and a corresponding annotation processor (QueryProcessor). The processor validates that every Query implementation includes the required apply methods for all events associated with its target Aggregate, ensuring compile-time consistency between queries, aggregates, and events.

grooves-java/src/main · high confidence

New Gradle plugin to track and enforce test count growth

A new included build plugin (\count-tests\) has been added to the Gradle configuration. It introduces a \countTests\ task that aggregates test results from all submodules, compares current counts against previous runs stored in \test-counts.properties\, and displays a summary of increases or decreases. Crucially, the build will now fail if any module's test count decreases, enforcing a policy that test coverage must not regress.

gradle/plugins/count-tests · high confidence

New Groovy AST transformation annotations for Aggregates, Events, and Queries

The grooves-groovy library now provides three new Java annotations—@Aggregate, @Event, and @Query—in the transformations package to enable compile-time AST transformations. @Aggregate marks a class as an event-sourced aggregate, @Event defines an event type linked to a specific aggregate, and @Query defines a read-model query that computes a Snapshot from an aggregate and its events. These annotations allow developers to use Groovy's AST transformation capabilities to generate implementation code for these domain concepts.

grooves-groovy/src/main/java/com/github/rahulsom/grooves/groovy/transformations · high confidence

New Spring Boot JPA example for event sourcing with RxJava queries

This location introduces a complete example application demonstrating event sourcing using Spring Boot, JPA, and RxJava. It provides REST endpoints for managing Patient and Zipcode aggregates, utilizing JPA repositories to persist events and snapshots in an RDBMS. The example includes domain models for patients and zipcodes, query projections for patient accounts and health records, and a bootstrap component that seeds the database with sample data to illustrate temporal and versioned snapshot queries.

grooves-example-springboot-jpa · high confidence

New domain models for patient management and health tracking

This change introduces the core domain classes for the patient example: \Patient\ as the base aggregate, \PatientAccount\ and \PatientHealth\ as snapshot aggregates managing financial balances and medical procedures respectively, and \PatientEvent\ defining the event stream including creation, procedure, payment, and deprecation events. These classes implement the Grooves framework's \Snapshot\ and \BaseEvent\ interfaces to enable event sourcing capabilities for patient data.

grooves-example-springboot-kotlin/src/main/kotlin/grooves/boot/kotlin/domain · high confidence

Behavioural changes

2 commits (0 fixes) modifying scripts

A change to existing behaviour in scripts — 2 commits, 3 files: “Add tagged manual backfill and snapshot menu generation”; “Automate tagged manual publishing and refresh version menu”.

scripts · medium confidence · unverified

35 commits (1 fix) modifying grooves-docs/src/docs/asciidoc

A change to existing behaviour in grooves-docs/src/docs/asciidoc — 35 commits (1 fix), 11 files: “docs: Cleanup javadoc problems”; “Upgrade asciidoctor”; “chore: Upgrade prism css”; and 32 more (refs \#1669).

grooves-docs/src/docs/asciidoc · medium confidence · unverified

Core event-sourcing function interfaces added

The \grooves-core\ module now exposes a set of Java functional interfaces in the \functions\ package to define event-sourcing behavior, replacing previous Kotlin implementations. These interfaces include \EventHandler\ for applying events to snapshots, \SnapshotProvider\ and \EmptySnapshotProvider\ for retrieving or creating snapshots, \EventsProvider\ for fetching event streams, and specialized handlers for deprecation (\Deprecator\, \DeprecatedByProvider\), event classification (\EventClassifier\), versioning (\EventVersioner\, \SnapshotVersioner\), and exception handling (\ExceptionHandler\).

grooves-core/src/main/java/com/github/rahulsom/grooves/functions · high confidence

Internal query execution logic refactored for modern Java idioms

The internal query execution components (BaseQuery, Executor, JoinExecutor, QueryExecutor, SimpleExecutor, Utils) have been refactored to use modern Java language features. This includes converting the Pair class to a record, replacing lambda expressions with method references, using pattern matching for instanceof checks, and updating list operations to use sequenced collection methods (e.g., removeLast, addFirst, getLast). Additionally, switch statements have been converted to enhanced switch expressions, and generic typing has been tightened. These changes improve code readability and maintainability without altering the external behavior of the query execution engine.

grooves-api/src/main/java/com/github/rahulsom/grooves/queries/internal · high confidence

Introduction of reactive snapshot and join interfaces

The internal snapshot API now defines \BaseSnapshot\ and \BaseJoin\ interfaces that utilize Reactive Streams (\Publisher\) for aggregate retrieval and deprecation tracking. \BaseSnapshot\ exposes methods to get and set the current aggregate, as well as track deprecation relationships, while \BaseJoin\ extends this to manage joined aggregates. This shifts the underlying data access pattern to be reactive, allowing consumers to handle aggregate state and relationships asynchronously.

grooves-types/src/main/kotlin/com/github/rahulsom/grooves/api/snapshots/internal · high confidence

JavaEE example now runs tests in Docker via Testcontainers

The JavaEE example application has been updated to use Testcontainers for its test execution, replacing the previous setup. Tests now spin up an isolated Open Liberty container (using the \openliberty/open-liberty:full-java21-openj9-ubi-minimal\ image) to deploy the application WAR and run acceptance tests against it. This change eliminates the need for a local Liberty installation, ensures a consistent testing environment across different platforms, and improves CI/CD integration by containerizing the runtime.

grooves-example-javaee · high confidence

Migrate event types to Kotlin and introduce reactive stream interfaces

The event type definitions in the \grooves-types\ module have been rewritten from Groovy to Kotlin. This change introduces a new \EventApplyOutcome\ enum to control event processing flow and establishes a set of reactive interfaces (\BaseEvent\, \JoinEvent\, \DisjoinEvent\, \Deprecates\, \DeprecatedBy\, \RevertEvent\) that utilize \org.reactivestreams.Publisher\ for aggregate references. Additionally, the legacy \EventApplyOutcome\ Groovy enum has been removed and replaced with a \GroovesException\ class to handle errors.

grooves-types/src/main/kotlin/com/github/rahulsom/grooves/api/events · high confidence

Project license changed to Apache 2.0 and build environment standardized

The project license has been updated to Apache 2.0, replacing the previous license terms. Additionally, the Gradle wrapper scripts (gradlew and gradlew.bat) have been upgraded to a newer version that includes improved POSIX compliance, better error handling, and explicit JVM memory settings (-Xmx64m/-Xms64m). New configuration files have been added to enforce consistent code formatting via EditorConfig and to ignore specific IDE and build artifacts in .gitignore.

(repo-wide) · high confidence

Removal of Groovy AST-based annotation processing and core API interfaces

The Grooves API has removed its compile-time annotation processing infrastructure, specifically deleting the \@Aggregate\, \@Event\, and \@Query\ annotations along with their corresponding AST transformations (\AggregateASTTransformation\, \EventASTTransformation\, \QueryASTTransformation\). This change eliminates the automatic generation of query interfaces and event application logic that previously relied on these annotations. Additionally, the core API interfaces \AggregateType\, \BaseEvent\, \Snapshot\, \DeprecatedBy\, and \Deprecates\, as well as the \QueryUtil\ trait for computing snapshots, have been removed, indicating a significant restructuring or simplification of the library's core domain model and event handling mechanisms.

grooves-api/src/main/groovy · high confidence

Snapshot interfaces now expose last event timestamp and position

The snapshot API in the grooves-types module has been refactored to make temporal and versioned tracking explicit. The new TemporalSnapshot interface exposes a lastEventTimestamp property, while VersionedSnapshot exposes a lastEventPosition property, allowing users to identify suitable snapshots based on event timing or sequence position. Additionally, new Join interfaces (Join, TemporalJoin, VersionedJoin) have been introduced to handle joined entity snapshots, extending the existing snapshot hierarchy.

grooves-types/src/main/kotlin/com/github/rahulsom/grooves/api/snapshots · high confidence

Test coverage

4 commits adding/updating tests in grooves-groovy/src/test/groovy; Added Groovy test resources for reactive query and domain models; Added Java domain model test resources for event sourcing; Added Java-based test infrastructure for the Grooves example; Added acceptance and builder validation tests for the Grooves query system; Added integration tests for the Spring Boot Kotlin example; Added test infrastructure configuration for JUnit extensions and logging; Added test resources for Java query validation; Added tests for Java query processor validation; Added tests for SVG diagram generation.

Dependencies

Gradle wrapper upgraded to version 9.7.1 with enhanced network configuration

The Gradle wrapper has been updated from version 3.4 to 9.7.1, requiring a significant upgrade for users building the project. The configuration now includes explicit network timeout settings (10 seconds), retry logic with a 500ms backoff, and distribution URL validation to improve build reliability and security.

gradle/wrapper · high confidence

Migrate build system to Gradle version catalogs and Kotlin DSL

The project build has been converted from Groovy to Kotlin DSL (build.gradle.kts) and now uses Gradle version catalogs (gradle/libs.versions.toml) to centrally manage dependency and plugin versions. This change introduces a standardized, type-safe dependency resolution mechanism across all subprojects, including the root build, API, core, diagrams, docs, and example modules, while also configuring Spotless, Checkstyle, JaCoCo, and SonarQube via the catalog.

(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

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

Lenses

  • Code Health 78 → 78 (+0.0)
  • Architecture 97 → 97 (-0.1)
  • Maturity 54 → 54 (+0.0)
  • Readiness 71 → 59 (-12.4)
  • Security 82 → 75 (-7.5)
  • Domain Modelling 66 → 66 (+0.0)
  • Accessibility 58 → 58 (+0.0)

Resolved (37)

  • High: security finding (details withheld)
  • Medium: security finding (details withheld)
  • No assertions: contextLoads (grooves-example-javaee/src/test/java/grooves/example/javaee/PatientTest.java)
  • Outdated (compile): com.google.auto.value:auto-value-annotations
  • Outdated (compile): com.google.testing.compile:compile-testing
  • Outdated (compile): com.h2database:h2
  • Outdated (compile): com.puppycrawl.tools:checkstyle
  • Outdated (compile): net.sf.saxon:Saxon-HE
  • Outdated (compile): org.apache.ant:ant
  • Outdated (compile): org.apache.ant:ant-launcher
  • Outdated (compile): org.apache.commons:commons-lang3
  • Outdated (compile): org.apache.groovy:groovy
  • Outdated (compile): org.apache.groovy:groovy-all
  • Outdated (compile): org.apache.groovy:groovy-bom
  • Outdated (compile): org.apache.groovy:groovy-cli-picocli
  • Outdated (compile): org.apache.groovy:groovy-console
  • Outdated (compile): org.apache.groovy:groovy-datetime
  • Outdated (compile): org.apache.groovy:groovy-dateutil
  • Outdated (compile): org.apache.groovy:groovy-groovysh
  • Outdated (compile): org.apache.groovy:groovy-jmx
  • …and 17 more

New (39)

  • Dependency hygiene PARTLY measured — Gradle build resolved part of the dependency graph, currency reported but not scored
  • High: security finding (details withheld)
  • High: security finding (details withheld)
  • High: security finding (details withheld)
  • No assertions (empty test): contextLoads (grooves-example-javaee/src/test/java/grooves/example/javaee/PatientTest.java)
  • Outdated (compile): com.fasterxml.jackson.core:jackson-annotations
  • Outdated (compile): com.fasterxml.jackson.core:jackson-core
  • Outdated (compile): com.fasterxml.jackson.datatype:jackson-datatype-jsr310
  • Outdated (compile): com.fasterxml.jackson:jackson-bom
  • Outdated (compile): com.fasterxml.woodstox:woodstox-core
  • Outdated (compile): com.formdev:flatlaf
  • Outdated (compile): com.formdev:flatlaf-extras
  • Outdated (compile): com.github.javaparser:javaparser-core
  • Outdated (compile): com.github.weisj:jsvg
  • Outdated (compile): com.google.code.gson:gson
  • Outdated (compile): com.google.errorprone:error_prone_annotations
  • Outdated (compile): net.minidev:accessors-smart
  • Outdated (compile): net.minidev:json-smart
  • Outdated (compile): org.apache.maven.resolver:maven-resolver-api
  • Outdated (compile): org.apache.maven.resolver:maven-resolver-connector-basic
  • …and 19 more

Changes since last survey

  • 48 commits — 33 feature/other, 15 fixes

By area

  • gradle/libs.versions.toml — 18 commits
  • (repo) — 7 commits
  • (root) — 6 commits
  • grooves-site/npmw — 5 commits
  • .github/workflows — 3 commits
  • grooves-site/package-lock.json — 3 commits
  • gradle/wrapper — 2 commits
  • grooves-docs/build.gradle.kts — 1 commit
  • grooves-groovy/src — 1 commit
  • grooves-site/index.html — 1 commit
  • grooves-site/src — 1 commit

Notable commits

  • fix: Fix manual publication output and favicon links
  • fix: Merge pull request #1762 from rahulsom/fix/spotless-jgit-conflict
  • fix: Merge pull request #1772 from rahulsom/codex/manual-publishing-fixes
  • fix: fix(deps): update dependency ch.qos.logback:logback-classic to v1.6.6 (#1761)
  • fix: fix(deps): update dependency com.fasterxml.jackson.core:jackson-databind to v2.23.0 (#1782)
  • fix: fix(deps): update dependency com.google.testing.compile:compile-testing to v0.24.0 (#1753)
  • fix: fix(deps): update dependency com.h2database:h2 to v2.5.252 (#1754)
  • fix: fix(deps): update dependency com.puppycrawl.tools:checkstyle to v14.3.0 (#1755)
  • fix: fix(deps): update dependency com.puppycrawl.tools:checkstyle to v14.4.0 (#1771)
  • fix: fix(deps): update dependency com.squareup.okhttp3:okhttp to v5.5.1 (#1747)
  • fix: fix(deps): update dependency org.apache.commons:commons-lang3 to v3.21.0 (#1756)
  • fix: fix(deps): update dependency org.aspectj:aspectjrt to v1.9.26 (#1748)
  • fix: fix(deps): update dependency org.aspectj:aspectjrt to v1.9.27 (#1776)
  • fix: fix(deps): update groovy monorepo to v6 (#1759)
  • fix: fix: remove jgit from spotless metadata to resolve jreleaser conflict
  • change: Add animated SVG favicon generated from Monoton 'G' logo (#1764)
  • change: Add tagged manual backfill and snapshot menu generation
  • change: Automate tagged manual publishing and refresh version menu
  • change: Merge pull request #1760 from rahulsom/ignore-dot-kotlin
  • change: Merge pull request #1763 from rahulsom/drop-codenarc-jacoco-gradle-files-2070123796306238304
  • …and 28 more

Architecture

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

rahulsom/grooves 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 8 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 4631482f6acf01b38352713a6f9d3013bcd6a0ee — 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-45ab2cab63de.