hnaderi/edomata

Edomata is a functional domain modeling library for Scala that supports both Event Sourcing and CQRS architectural patterns. It provides a core DSL for defining state machines and commands, backed by pluggable persistence drivers for PostgreSQL via Doobie and Skunk. The system includes built-in mechanisms for command caching, retry logic, and outbox-based event publishing, with comprehensive cross-platform testing across JVM, Scala.js, and Scala Native.

Users can now serialize and deserialize JSON and MessagePack data using the Jsoniter library in both the Doobie and Skunk database modules. New \JsoniterCodec\ objects provide \json\, \jsonb\, and \msgpack\ codecs that leverage \com.github.plokhotnyuk.jsoniter\_scala\ for efficient encoding and decoding, allowing applications to switch from default JSON handling to the high-performance Jsoniter implementation.

modules/doobie-jsoniter, modules/skunk-jsoniter · high confidence

Users can now include PlantUML diagrams in their documentation by using the \plantuml\ directive. The new \PlantumlModifier\ registers this capability, allowing code blocks to be rendered as SVG images via the PlantUML server. The implementation defaults to the 'toy' theme for visual styling.

mdoc-plantuml · high confidence

The Doobie backend now includes built-in serialization codecs for JSON and binary formats. Users can leverage \CirceCodec\ to encode/decode data using Circe (supporting JSON and JSONB) and \UpickleCodec\ for Upickle (supporting JSON, JSONB, and MessagePack), simplifying the integration of these libraries with the Doobie persistence layer.

modules/doobie-circe, modules/skunk-circe · high confidence

The \modules/postgres\ module now includes a \PGNamespace\ opaque type that enforces PostgreSQL naming rules at compile time. Users can create namespace identifiers using a macro constructor (\`PGNamespace(

modules/postgres · high confidence

The CQRS backend module now provides a configurable \BackendBuilder\ that assembles a \Backend\ from a \StorageDriver\, an optional in-memory command cache, and a state cache. The command cache prevents redundant command processing by tracking executed command IDs, while the state cache (LRU) reduces database load by storing recent aggregate states. The \CommandHandler\ now includes built-in retry logic with jitter for handling version conflicts, configurable via \withRetryConfig\. Additionally, a \Notifications\ system using circular buffers allows consumers to subscribe to outbox and state update streams.

modules/backend/src/main/scala/cqrs · high confidence

Added a new persistence backend for PostgreSQL using the Doobie library, enabling users to store event-sourced state and command data in a relational database. This change introduces the \edomata.doobie\ package, which includes \DoobieDriver\ for event sourcing (with journal, snapshot, and outbox support) and \DoobieCQRSDriver\ for CQRS-style storage. The implementation provides \BackendCodec\ for serializing state and events as JSON, JSONB, or binary, and defines the necessary database schema (tables for journal, outbox, snapshots, and commands) along with readers and repositories to handle persistence operations.

modules/doobie/src/main · high confidence

The \modules/backend/src/main/scala/eventsourcing\ directory now contains the implementation of the eventsourcing backend. This includes a \BackendBuilder\ that allows configuring command caching (with an in-memory default) and retry policies (with jitter) for command handling. The implementation introduces a \CachedRepository\ to optimize command processing by checking a command store and snapshots before hitting the underlying storage, and a \SnapshotStore\ with support for both in-memory and persisted snapshots, including deduplication of snapshot items on persistence.

modules/backend/src/main/scala/eventsourcing · high confidence

Added two new example files, Example1.scala and StomatonExample.scala, to illustrate the usage of the new Skunk backend and CQRS capabilities. Example1.scala shows a full application setup using the SkunkDriver with Circe codecs for JSONB storage, including session pooling and retry configuration. StomatonExample.scala demonstrates the CQRS model pattern, including the use of SkunkCQRSDriver and event handlers, providing a reference for implementing command/query separation with the new backend modules.

examples · high confidence

The repository has been initialized with the Edomata project, including the Apache 2.0 license, code of conduct, and a README detailing usage for Scala, Scala.js, and Scala Native. Development and CI workflows are established using Nix (flake.nix) and GitHub Actions (ci.sbt), with Docker Compose configured for PostgreSQL test databases. The build is configured with sbt-typelevel, pinned to Scala 3.3 LTS, and uses scalafmt 3.11.5 for code formatting.

(repo-wide) · high confidence

The HTTP route definitions for FSM commands (FSMRoute) and their associated integration tests have been removed from the endpoint module. Additionally, the backend test kit infrastructure—including the DomainSuite trait, FakeCommandHandler, ScenarioCommandHandler, and Timeline utilities used for testing domain logic—has been deleted from the testkits/backend module.

modules/endpoint, testkits/backend · high confidence

The \modules/eventsourcing\ module has been cleared of its initial draft code, removing all core abstractions and implementations. This includes the deletion of the \Journal\ and \SnapshotStore\ traits, their in-memory implementations (\InMemJournal\, \InMemSnapshotStore\), the \ESRepository\ interface and its \MyESRepository\ implementation, along with supporting types like \ConsumerController\, \JournalConsumer\, \SnapshotCache\, and the \Transition\ type. Corresponding unit tests for these components have also been removed.

modules/eventsourcing · high confidence

The backend module has been restructured to support both Event Sourcing and CQRS patterns, replacing the previous single-pattern implementation. Users can now build backends for either domain type via the new \Backend.builder\ entry points. The change introduces an outbox pattern with \OutboxReader\ and \OutboxConsumer\ to handle event publishing, and adds a retry mechanism with jitter in \Helpers\ to handle \VersionConflict\ errors during command processing. Additionally, the internal \LRUCache\ has been refactored to implement a new \Cache\ trait with conditional replace capabilities, and the package has been renamed from \edfsm\ to \edomata\.

modules/backend/src/main/scala · high confidence

The core module has been refactored to introduce a new domain modeling architecture. The previous \edfsm.core\ package has been replaced by \edomata.core\, featuring new \Edomaton\ and \Stomaton\ types for event-driven state machines, alongside a comprehensive DSL (\DomainDSL\, \CQRSDomainDSL\) for constructing domain logic. The response model has been updated from \Response\ to \ResponseD\ (built on \ResponseT\), and the \Action\ monad now wraps \ResponseD\ directly. Additionally, \RequestContext\ and \CommandMessage\ types have been introduced to standardize input handling, while legacy files like \EDFSM\ and \Request\ have been removed.

modules/core/src/main · high confidence

The project documentation site has been rebuilt using the Typelevel Helium theme, replacing the previous microsites setup. This change introduces a new landing page with updated metadata, navigation links to related Typelevel projects (cats, cats-effect, fs2), and specific teasers highlighting Edomata's features such as cross-platform support and functional design. The build infrastructure has been significantly modernized: sbt has been upgraded to version 1.13.0, and the plugin suite has shifted to the Typelevel ecosystem (sbt-typelevel, sbt-typelevel-site) while adding support for Scala Native and Scala.js. Additionally, core library dependencies have been updated to their latest versions, including Cats 2.13.0, Cats Effect 3.7.1, FS2 3.14.0, and Doobie 1.0.0-RC12.

project · high confidence

The \modules/skunk/src/main\ persistence implementation has been completely rewritten to use the \edomata\ package structure and the \BackendCodec\ abstraction for type-safe serialization, replacing the legacy \edfsm\ codebase. Old files such as \DAOError\, \DataAccessLayer\, \Database\, \PGJournal\, and \PGServiceBuilder\ have been removed and replaced with new, modular components including \SkunkDriver\, \SkunkCQRSDriver\, \SkunkRepository\, \SkunkCQRSRepository\, \SkunkJournalReader\, \SkunkOutboxReader\, and \SkunkSnapshotPersistence\. This change introduces a cleaner separation between Event Sourcing and CQRS storage drivers, utilizes \Resource\-based session pooling for safer database access, and standardizes schema management and query definitions within the \Queries\ object.

modules/skunk/src/main · high confidence

Added Doobie integration tests for event sourcing and CQRS backends; Added comprehensive test suites for core Decision, Stomaton, and ResponseT components; Added end-to-end tests for the accounts module with Doobie and Skunk backends; Added integration test suites for backend storage and CQRS implementations; Added munit integration module; Added test coverage for CQRS backend components; Added test suite and test doubles for backend components; Added tests for the eventsourcing backend components; Migrated skunk backend tests to edomata compatibility suites.

The project has upgraded its base Scala version from 3.1.0 to 3.3.6. This change is accompanied by updates to key libraries, including scala-java-time to 2.7.0 for JavaScript platforms and PlantUML to 1.2026.8 for documentation generation. The build structure has also been refactored to use the Typelevel sbt plugin conventions, updating the base version to 0.13 and reorganizing module definitions.

(dependencies) · high confidence

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

• CAI 53 → 67 (+14.0)
• Rubric changed (rubric-2026.08.19 → rubric-2026.09.15) — scores are not directly comparable.

• Code Health 100 → 98 (-1.5)
• Architecture 100 → 99 (-0.6)
• Maturity 42 → 66 (+24.0)
• Readiness 61 → 56 (-5.1)
• Security 42 → 74 (+31.4)
• Domain Modelling 100 → 100 (+0.0)

• Coverage not included — suite not readable by the collector
• Dependency hygiene not measured — dependency manifest found but not parsed for hygiene
• High: security finding (details withheld)
• High: security finding (details withheld)
• High: security finding (details withheld)
• High: security finding (details withheld)
• High: security finding (details withheld)
• High: security finding (details withheld)
• High: security finding (details withheld)
• High: security finding (details withheld)
• High: security finding (details withheld)
• High: security finding (details withheld)
• High: security finding (details withheld)
• High: security finding (details withheld)
• High: security finding (details withheld)
• High: security finding (details withheld)
• High: security finding (details withheld)
• High: security finding (details withheld)
• High: security finding (details withheld)
• High: security finding (details withheld)
• …and 10 more

• Documentation: no contributor guidance (README.md)
• Documentation: no installation or build instructions (README.md)
• Documentation: no usage examples (README.md)
• DoobieCQRSRepository.save (cognitive 19) (modules/doobie/src/main/scala/DoobieCQRSRepository.scala)
• DoobieRepository.append (cognitive 30) (modules/doobie/src/main/scala/DoobieRepository.scala)
• Duplicated block (11 lines × 2) (modules/doobie-upickle/src/main/scala/UpickleCodec.scala)
• Duplicated block (16 lines × 2) (modules/doobie-jsoniter/src/main/scala/JsoniterCodec.scala)
• High: security finding (details withheld)
• High: security finding (details withheld)
• High: security finding (details withheld)
• High: security finding (details withheld)
• High: security finding (details withheld)
• High: security finding (details withheld)
• High: security finding (details withheld)
• High: security finding (details withheld)
• High: security finding (details withheld)
• High: security finding (details withheld)
• High: security finding (details withheld)
• High: security finding (details withheld)
• High: security finding (details withheld)
• …and 13 more

• 17 commits — 17 feature/other, 0 fixes

• project/Dependencies.scala — 6 commits
• project/plugins.sbt — 5 commits
• (root) — 4 commits
• project/build.properties — 2 commits

• change: Removed dead external link
• change: Update cats-effect, cats-effect-testkit to 3.7.1 (#666)
• change: Update fs2-core to 3.14.0 (#675)
• change: Update jsoniter-scala-core to 2.40.1 (#655)
• change: Update jsoniter-scala-core to 2.41.0 (#681)
• change: Update mdoc, sbt-mdoc to 2.9.2 (#671)
• change: Update munit-cats-effect to 2.2.1 (#682)
• change: Update munit-scalacheck to 1.3.1 (#673)
• change: Update plantuml to 1.2026.7 (#667)
• change: Update plantuml to 1.2026.8 (#676)
• change: Update sbt, scripted-plugin to 1.12.15 (#657)
• change: Update sbt, scripted-plugin to 1.13.0 (#663)
• change: Update sbt-buildinfo to 0.13.2 (#679)
• change: Update sbt-scala-native-crossproject to 1.4.0 (#662)
• change: Update sbt-scalafix to 0.14.8 (#677)
• change: Update sbt-scalafix to 0.14.9 (#678)
• change: flake.lock: Update (#670)

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

hnaderi/edomata 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.