Skip to content
CAI
Software that uses CAICheck a score

softwaremill/elasticmq

43.7

Weak · 14 November 2026

10k

lines of production code

Scala

with TypeScript

7

measurements over time

CAI band scale
CAI trend line
CAI lens gauges

What this system is

Features

Add ElasticMQ configuration for Docker environment

A new configuration file for ElasticMQ has been added to the Docker server setup. This file includes the standard application configuration, enabling the message queue service to operate correctly within the containerized environment.

server/docker · high confidence

Added example configuration files for ElasticMQ

The examples directory now includes an elasticmq.conf file that demonstrates how to configure the service with specific settings such as binding ports, JDBC storage URIs, and queue definitions including dead-letter and FIFO queues, along with an auto-create-queues template. Additionally, a logback.xml file has been added to provide a default logging configuration that outputs debug-level messages to the console.

examples · high confidence

Introduction of core domain models for message handling and FIFO support

This change introduces several new domain classes within the core package to support advanced message features. New types include \MessageId\, \DeliveryReceipt\, and \CreateQueueDefaults\ (defining default visibility timeout, delay, and receive wait times). The \NewMessageData\ case class has been added to encapsulate message attributes, including fields for \messageGroupId\, \messageDeduplicationId\, \orderIndex\, \tracingId\, \sequenceNumber\, and \deadLetterSourceQueueName\, laying the groundwork for FIFO queue semantics and detailed message tracking.

core/src/main/scala/org/elasticmq · high confidence

New ElasticMQ UI with queue management and real AWS support

A new Next.js-based web interface is introduced for ElasticMQ, enabling users to create, delete, and monitor message queues with a modern, responsive design. The UI supports both local ElasticMQ instances and real AWS accounts, configurable via environment variables, and includes an automatic 1-second state refresh feature (controllable via the NEXT\_PUBLIC\_AUTO\_REFRESH\_DISABLED flag) to keep queue statistics current. Users can send and generate messages, view detailed queue attributes, and manage FIFO queues with content-based deduplication options, all within a theme-aware layout featuring light and dark modes.

ui · high confidence

New JMX metrics MBean for queue statistics

A new JMX MBean interface (QueuesMetricsMBean) and its implementation (QueuesMetrics) have been added to expose queue statistics via JMX. This includes metrics for the number of visible, invisible, and delayed messages per queue, as well as a tabular view of all queues. The implementation uses a cached thread pool for execution and interacts with the queue manager actor via Pekko messages to retrieve the data.

core/src/main/scala/org/elasticmq/metrics · high confidence

Repository restructured with new Next.js UI and updated configuration files

The repository has been reorganized to include a new Next.js-based web UI for monitoring and managing queues, alongside a comprehensive project documentation file (CLAUDE.md) detailing the backend (Pekko/Scala) and frontend (Next.js/TypeScript) architectures. Configuration and tooling have been updated: the code formatter is set to scalafmt 3.11.5 with Scala 2.13 dialect, and dependency management is controlled via .scala-steward.conf which pins logback and Scala 3 library versions while ignoring AWS SDK updates. Docker workflows are supported by a new docker-compose.yaml for running the server and UI together, along with .dockerignore and .gitignore files to exclude build artifacts and sensitive environment variables.

(repo-wide) · high confidence

Behavioural changes

30 commits (2 fixes) modifying server/src/main/resources

A change to existing behaviour in server/src/main/resources — 30 commits (2 fixs), 2 files: “Simplification of names for persisted queues config”; “replace sqlite with h2 to make it work with native-image”; “Implement mirror queues support configured via copyTo/moveTo attributes”; and 27 more (refs \#18, \#1276, \#1275, \#1117).

server/src/main/resources · medium confidence · unverified

32 commits (3 fixes) modifying server/src/main/scala/org/elasticmq/server/config

A change to existing behaviour in server/src/main/scala/org/elasticmq/server/config — 32 commits (3 fixs), 1 file: “Simplification of names for persisted queues config”; “Fixes after review”; “Implement mirror queues support configured via copyTo/moveTo attributes”; and 29 more (refs \#1276, \#1275).

server/src/main/scala/org/elasticmq/server/config · medium confidence · unverified

5 commits (0 fixes) modifying integration-tests

A change to existing behaviour in integration-tests — 5 commits, 7 files: “Convert Python integration tests to a uv project on Python 3.14 (\#1274)”; “2.0: Kebab-case config keys, queue URLs from the incoming request by default (\#1276)”; “Build the native image with GraalVM for JDK 25 (\#1260) (\#1272)”; and 2 more (refs \#1274, \#1276, \#1260, \#1272, \#1273, …). Also in this area: New Node.js and Python integration test suites with Docker support.

integration-tests/nodejs, native-server · medium confidence · unverified

79 commits (10 fixes) modifying server/src/main/scala/org/elasticmq/server

A change to existing behaviour in server/src/main/scala/org/elasticmq/server — 79 commits (10 fixs), 2 files: “Simplification of names for persisted queues config”; “fix invalid list match”; “Fixes after review”; and 76 more (refs \#1276, \#931, \#754, \#1275, \#500, …).

server/src/main/scala/org/elasticmq/server · medium confidence · unverified

Actor reply mechanism now supports optional responses

The actor reply system in the core module has been refactored to allow actors to optionally choose whether to send a reply. A new \ReplyAction\ trait with \ReplyWith\ and \DoNotReply\ cases replaces the previous implicit-reply pattern, enabling \ReplyingActor\ implementations to explicitly suppress responses when needed. This change is part of the broader migration to Apache Pekko and Scala 3 compatibility.

core/src/main/scala/org/elasticmq/actor/reply · high confidence

Configurable ARN components in Redrive Policy serialization

The Redrive Policy JSON serialization now supports configurable account IDs and regions within the Amazon Resource Name (ARN). The new \RedrivePolicyJson\ module parses incoming ARNs to extract the region and account ID, and serializes outgoing policies using these specific values rather than hardcoded defaults, allowing for more accurate representation of queue destinations.

rest/rest-sqs/src/main/scala/org/elasticmq/rest/sqs/model · high confidence

Core domain model and queue actor logic refactored for FIFO, DLQ, and message attributes

The core domain model has been restructured to support FIFO queues, Dead Letter Queues (DLQ), and message attributes. New data classes include \CreateQueueData\ and \QueueData\ to manage queue configuration (FIFO, deduplication, copy/move destinations), \MessageData\ to hold message content and attributes, and \DeduplicationId\ for FIFO deduplication. The \Limits\ trait enforces AWS SQS constraints on batch sizes, message lengths, and attribute counts. Queue actor logic is now split into traits like \QueueActorStorage\ and \QueueActorWaitForMessagesOps\, introducing a \ReceiveRequestAttemptCache\ for long-polling and a \FifoDeduplicationIdsHistory\ for tracking deduplication IDs. DLQ support is implemented via \MoveDestination\ and async message moving operations. Also in this area: 2 commits (0 fixes) modifying core, repository; 1 commit (0 fixes) modifying repository.

repository · low confidence · unverified

Migrate configuration to Apache Pekko and align HTTP settings with Amazon SQS specifications

The SQS REST module now uses Apache Pekko instead of Akka, reflected in the new application.conf and reference.conf files. To ensure compatibility with Amazon SQS clients, the HTTP server request timeout is set to 21 seconds (accommodating the 20-second long-polling maximum) and the maximum URI length is increased to 256KB. Additionally, illegal header warnings are suppressed to handle SQS authentication headers, and default node binding is configured for port 9324.

rest/rest-sqs/src/main/resources · high confidence

Refactored SQS request handling and error responses for AWS JSON protocol support

The REST SQS directive layer has been restructured into modular traits (AWSProtocolDirectives, AnyParamDirectives, ExceptionDirectives, etc.) to support the AWS JSON Protocol 1.0 alongside the existing query protocol. This change introduces specific handling for JSON requests, including extracting the action from the X-Amz-Target header and supporting X-Amzn-Trace-Id for tracing. Error responses are now protocol-aware: JSON protocol errors include the X-Amzn-Query-Error header and JSON body, while query protocol errors continue to use XML. Queue name and URL extraction logic has been consolidated to handle context paths and account IDs more robustly across both protocols.

rest/rest-sqs/src/main/scala/org/elasticmq/rest/sqs/directives · high confidence

Refactored file-based queue persistence into new modular components

The file persistence logic has been restructured into three new classes: ConfigBasedQueuePersistenceActor, QueueConfigUtil, and QueuePersister. This change introduces proper queue name validation (including automatic .fifo suffixes for FIFO queues) and ensures that queue configurations are sorted after loading to handle dependencies like dead-letter queues correctly. It also fixes issues where delay and receiveMessageWait settings were not properly loaded from persisted queue configurations, and adds error logging when queue configuration extraction fails.

persistence/persistence-file/src/main · high confidence

Refactored queue internals to support FIFO and Dead Letter Queues

The core queue actor logic has been restructured to introduce native support for FIFO queues and Dead Letter Queues (DLQ). This change introduces a new \InternalMessage\ model that tracks FIFO-specific attributes such as message group IDs, deduplication IDs, and sequence numbers, alongside precise ordering indices. The message queue implementation is now split into traits (\SimpleMessageQueue\ and \FifoMessageQueue\) to handle distinct ordering and deduplication behaviors, while the \QueueActor\ now manages DLQ redirection via \copyTo\/\moveTo\ configurations and listener events. Users benefit from correct FIFO message ordering, automatic deduplication history cleanup, and the ability to configure redrive policies for failed messages.

core/src/main/scala/org/elasticmq/actor/queue · high confidence

Refactored queue management into modular actor components

The queue management logic in the core actor package has been restructured into three distinct components: QueueManagerActor, QueueManagerActorStorage, and QueueManagerMessageOps. QueueManagerActor now handles high-level queue lifecycle operations (create, delete, lookup, list) and delegates specific behaviors to traits. QueueManagerActorStorage provides the shared context and timeout configuration for managing the map of queue actors. QueueManagerMessageOps encapsulates the logic for starting, tracking, and canceling message move tasks between queues, including the ability to identify dead-letter queue sources. This refactoring isolates concerns, making the queue manager more maintainable and easier to extend.

core/src/main/scala/org/elasticmq/actor · high confidence

Refactored queue operations into dedicated traits and implemented FIFO deduplication logic

The message handling logic in the queue actor has been split into separate traits (such as DeleteMessageOps, MoveMessageOps, and SendMessageOp) to improve code organization. For FIFO queues, the system now enforces message deduplication by tracking message deduplication IDs; duplicate messages are rejected or handled according to the history, and when messages are moved to a Dead Letter Queue, the message ID is assigned as the deduplication ID. Additionally, sequence numbers for FIFO messages are now generated within the queue actor rather than the REST layer to align with AWS behavior, and the visibility timeout calculation has been centralized in CommonOperations.

core/src/main/scala/org/elasticmq/actor/queue/operations · high confidence

SQL persistence now supports dead-letter, copy-to, and move-to queue references

The SQL persistence layer now correctly persists and restores queue metadata for dead-letter queues, copy-to destinations, and move-to destinations. This change introduces a topological sort to ensure that referenced queues (such as dead-letter queues) are created before the queues that depend on them, preventing initialization errors when queue dependencies are present. It also adds a new \deadLetterSourceQueueName\ field to message persistence to track the source queue for messages moved to a dead-letter queue.

persistence/persistence-sql · high confidence

SQS REST API implementation migrated to Pekko and modularized

The SQS REST interface has been refactored to use Apache Pekko instead of Akka, introducing new modules for actor system management, attribute handling, and batch request processing. The monolithic directive structure has been split into individual, focused directive files (e.g., CreateQueueDirectives, DeleteMessageDirectives) and a centralized Action enumeration, improving code organization and maintainability while preserving the existing SQS-compatible API surface. Also in this area: 3 commits (0 fixes) modifying rest/rest-sqs; Core domain model and queue actor logic refactored for FIFO, DLQ, and message attributes.

rest/rest-sqs/src/main/scala/org/elasticmq/rest/sqs · medium confidence · unverified

Test coverage

14 commits adding/updating tests in server/src/test/resources; 26 commits adding/updating tests in server/src/test/scala; 27 commits adding/updating tests in rest/rest-sqs/src/test/scala/org/elasticmq/rest/sqs/directives; 28 commits adding/updating tests in rest/rest-sqs/src/test/scala/org/elasticmq/rest/sqs; Added MutableNowProvider test utility; Added actor-level tests for queue operations, deduplication, and event listeners; Added local performance test for REST SQS and in-memory modes; Added test configuration files for SQS testing; Added test infrastructure for ElasticMQ actor tests; Added test utility helpers for timing and temporary directory management; Added tests for FIFO message ordering and receive request attempt caching; Added tests for delivery receipts, FIFO deduplication history, and queue limits; Added tests for file-based queue configuration persistence; New Node.js and Python integration test suites with Docker support; Refactored SQS integration test infrastructure and added new test coverage.

Dependencies

Migrate time utilities from Joda Time to Java 8 java.time

The core utility layer has replaced Joda Time dependencies with the standard Java 8 \java.time\ API. This is implemented via new \NowProvider\ and \OffsetDateTimeUtil\ classes that use \OffsetDateTime\ and \Instant\, ensuring consistent time handling across the application without external legacy libraries.

core/src/main/scala/org/elasticmq/util · high confidence

Update build dependencies and add integration test dependencies

The build configuration (build.sbt) has been updated to use Apache Pekko 1.7.0 and Pekko HTTP 1.4.0 (migrated from Akka), along with Scala 2.12.20, 2.13.18, and 3.3.7. Other Scala dependencies such as pureconfig (0.17.8), scalikejdbc (4.3.5), and H2 (2.2.224) have also been updated. Additionally, new dependency manifests have been added for Node.js integration tests (using @aws-sdk/client-sqs 3.990.0, Jest, and testcontainers) and the UI module (using Next.js 16.1.6, React 19.2.3, and Vitest), establishing the dependency baseline for these new components.

(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 41 → 44 (+2.9)
  • Rubric changed (rubric-2026.10.5 → rubric-2026.11.4) — scores are not directly comparable.

Lenses

  • Code Health 55 → 47 (-8.1)
  • Architecture 90 → 90 (-0.6)
  • Maturity 67 → 67 (-0.2)
  • Readiness 37 → 39 (+2.3)
  • Security 35 → 40 (+4.2)
  • Accessibility 41 → 44 (+3.8)
  • Performance 70 → 100 (+30.0)

Resolved (61)

  • Concentrated knowledge decay
  • Coverage not measured — JavaScript/TypeScript suite
  • Critical vulnerability: [GHSA redacted] (ui/package.json)
  • High CVE: [GHSA redacted] (ui/package-lock.json)
  • High CVE: [GHSA redacted] (ui/package-lock.json)
  • High CVE: [GHSA redacted] (ui/package-lock.json)
  • High CVE: [GHSA redacted] (ui/package-lock.json)
  • High CVE: [GHSA redacted] (ui/package-lock.json)
  • High CVE: [GHSA redacted] (ui/package-lock.json)
  • High CVE: [GHSA redacted] (ui/package-lock.json)
  • High CVE: [GHSA redacted] (ui/package-lock.json)
  • High CVE: [GHSA redacted] (ui/package-lock.json)
  • High CVE: [GHSA redacted] (ui/package-lock.json)
  • High CVE: [GHSA redacted] (ui/package-lock.json)
  • 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)
  • Low CVE: [GHSA redacted] (ui/package-lock.json)
  • …and 41 more

New (12)

  • Edited copies of one member (3 members, 11+ corresponding lines) (rest/rest-sqs/src/main/scala/org/elasticmq/rest/sqs/ChangeMessageVisibilityBatchDirectives.scala)
  • Edited copy of a member (10 corresponding lines) (persistence/persistence-file/src/main/scala/org/elasticmq/persistence/file/ConfigBasedQueuePersistenceActor.scala)
  • Edited copy of a member (10 corresponding lines) (rest/rest-sqs/src/main/scala/org/elasticmq/rest/sqs/AttributesModule.scala)
  • Edited copy of a member (13 corresponding lines) (rest/rest-sqs/src/main/scala/org/elasticmq/rest/sqs/ChangeMessageVisibilityDirectives.scala)
  • Edited copy of a member (20 corresponding lines) (rest/rest-sqs/src/main/scala/org/elasticmq/rest/sqs/ChangeMessageVisibilityBatchDirectives.scala)
  • High: security finding (details withheld)
  • Medium IaC: DS-0001 (native-server/Dockerfile)
  • Medium IaC: WD-DOCKER-0003 (native-server/Dockerfile)
  • No ADRs found (build.sbt)
  • Off the main sequence: persistenceCore
  • Off-boarding risk: anonymized user #1
  • QueueActorQueueOps.receiveAndReplyQueueMsg (cyclomatic 17) (core/src/main/scala/org/elasticmq/actor/queue/QueueActorQueueOps.scala)

Changes since last survey

  • 15 commits — 15 feature/other, 0 fixes

By area

  • (root) — 4 commits
  • core/src — 2 commits
  • docs/BACKLOG.md — 2 commits
  • integration-tests/python — 1 commit
  • native-server/src — 1 commit
  • persistence/persistence-file — 1 commit
  • project/build.properties — 1 commit
  • rest/rest-sqs — 1 commit
  • server/src — 1 commit
  • ui/components — 1 commit

Notable commits

  • change: 2.0: Enforce MessageRetentionPeriod and per-queue MaximumMessageSize (#1277)
  • change: 2.0: Hide Pekko types from the embedding API, move the server into its module (#1275)
  • change: 2.0: Kebab-case config keys, queue URLs from the incoming request by default (#1276)
  • change: Add 2.0 backlog
  • change: Build the native image with GraalVM for JDK 25 (#1260) (#1272)
  • change: Convert Python integration tests to a uv project on Python 3.14 (#1274)
  • change: Drop Scala 2.12. Make Scala 3 default (#1247)
  • change: Match requested message attribute names exactly or by prefix in ReceiveMessage (#1268)
  • change: Publish message snapshots in queue events (#1270) (#1271)
  • change: Remove SQL schema versioning and Pekko HTTP replacement from the 2.0 backlog
  • change: Update logback-classic to 1.6.6 (#1278)
  • change: Update pureconfig-core to 0.17.11 (#1279)
  • change: Update sbt to 2.0.12 (#1269)
  • change: Update typesafe:config to 1.4.10 (#1281)
  • change: Upgrade npm dependencies and move to Node.js 26 LTS (#1273)

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

softwaremill/elasticmq 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 14 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 c7dee33988cd6ebec4793816b13f9c8a16c6367c — the exact code this score is about.
  • Scored under rubric-2026.11.4 — 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.65+preprod-36d4cd83012f.