cb372/cats-retry
54.6
Adequate · 6 November 2026
741
lines of production code
Scala
primary language
4
measurements over time
What this system is
This system is a Scala library providing robust retry mechanisms for functional programming contexts. It supports Cats Effect and Cats MTL, offering granular control over retry policies such as exponential backoff and full jitter. The library is structured as a multi-module project compatible with both JVM and Scala.js, ensuring stack safety and overflow protection for retry operations.
Features
Add MTL-based retry support for Handle effects
Users can now retry actions that raise errors via the cats-mtl \Handle\ type class. This change introduces a new \retry.mtl\ module providing \retryingOnErrors\ and a \retryingOnMtlErrors\ syntax extension, allowing retry policies and error handlers to work with \Handle\[F, E\]\ contexts (such as \EitherT\) alongside existing exception-based retry mechanisms.
modules/mtl · high confidence
Removals
Removal of internal retry implementation components
The internal retry logic components in the \src/main/scala/retry\ package have been removed. This includes the deletion of the \NextStep\, \RetryVerdict\, \RetryPolicy\, \RetryPolicies\, \Sleep\, and \package.scala\ files, which previously defined the core retry decision types, policy implementations (such as constant delay and exponential backoff), sleep mechanisms, and the main \retrying\ entry points. Users relying on these specific internal classes or the direct API exposed through this package will no longer have access to this retry functionality.
src/main · high confidence
Behavioural changes
Migration to Scala 3 and Scalafmt 3.11.1
The project has migrated its codebase to Scala 3, updating the build configuration to use the \scala3\ dialect and enabling specific Scala 3 syntax rewrites (such as converting to new syntax and removing optional braces). This change is accompanied by an upgrade to Scalafmt version 3.11.1, which enforces the new formatting rules and increases the maximum column width to 110 characters.
(repo-wide) · high confidence
Retry library rewritten for Cats Effect 2 and Scala 3
The retry module has been completely rewritten to support Cats Effect 2 and Scala 3, introducing a new API with \retryingOnFailures\, \retryingOnErrors\, and \retryingOnFailuresAndErrors\ entry points. The core logic now uses \HandlerDecision\ and \PolicyDecision\ enums to manage retry flow, allowing for more granular control over retry behavior, including the ability to adapt actions during retries. New retry policies like \fibonacciBackoff\ and \fullJitter\ are available, and the library now includes safeguards against integer overflow in delay calculations. The module structure has been simplified, and the codebase is now shared across Scala.js.
modules/core/shared/src/main · high confidence
Test coverage
Added comprehensive test suite for the retry module; Removed retry library test suite.
Dependencies
Upgrade to Scala 3 and Cats 2.13 with multi-module structure
The build configuration has been updated to target Scala 3.3.6 and upgrade core dependencies, including Cats to 2.13.0, Cats-Effect to 3.7.1, and Cats-MTL to 1.7.0. The project structure has been refactored into separate JVM and JS modules for core and MTL functionality, replacing the previous single-module setup. Test dependencies have also been updated to use Munit (1.3.1) and related libraries, and binary compatibility is now checked against version 4.0.0.
(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 54 → 55 (+1.0)
- Rubric changed (rubric-2026.10.5 → rubric-2026.11.2) — scores are not directly comparable.
Lenses
- Code Health 76 → 76 (+0.0)
- Architecture 69 → 69 (+0.0)
- Maturity 38 → 42 (+3.9)
- Readiness 57 → 55 (-2.3)
- Security 86 → 79 (-7.1)
- Performance 100 → 100 (+0.0)
Resolved (2)
- Off-boarding risk: anonymized user #1
- Outdated: software.amazon.awssdk:dynamodb
New (2)
- Dependency hygiene PARTLY measured — sbt declarations read, dependency currency not (Maven Central unreachable)
- Off-boarding risk: anonymized user #1
Written by cca.canine.dev from the codebase's own history, inside the signed delivery this page is composed from.
Survey your own repository
cb372/cats-retry 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 6 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 bd14d6a56d179470d5edeecb9499faac5d2a63c8 — 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-60d1b390edf0.