Nebo15/sage
64.3
Adequate · 13 November 2026
1.2k
lines of production code
Elixir
primary language
8
measurements over time
What this system is
Sage is a dependency-free Elixir library that implements the Saga pattern for managing distributed transactions. It provides mechanisms to define transaction and compensation steps, ensuring that partial executions are corrected via compensating actions if errors occur. The system supports configurable retry policies with exponential backoff, asynchronous execution through custom supervisors, and extensible tracing and error handling behaviors for monitoring and debugging.
Features
Initial project setup with formatting, CI, and documentation
This change establishes the foundational structure for the Sage library, introducing Elixir code formatting rules via .formatter.exs, configuring Coveralls for test coverage reporting, and setting up Dialyzer to handle type specification warnings for specific error modules. It also updates the .gitignore to exclude package tarballs and benchmark snapshots, corrects a typo in the license header, and significantly expands the README.md to document the Saga pattern implementation, usage examples, and project goals.
(repo-wide) · high confidence
Introduction of Sage saga pattern library with retry and compensation support
The library now includes the \Sage\ module, a dependency-free implementation of the Saga pattern for distributed transactions in Elixir. This addition allows users to define transaction and compensation functions to ensure that either all transactions in a saga complete successfully or compensating actions are executed to amend partial executions. Key capabilities include configurable retry policies with exponential backoff and jitter, support for asynchronous transactions via custom supervisors, and tracing hooks for monitoring execution steps. The implementation also handles critical error wrapping for transactions and optional error handling for compensations.
lib · high confidence
Behavioural changes
Refactored Sage execution engine with new error handling and tracing behaviors
The Sage library has been refactored to improve error handling, observability, and code structure. A new \Sage.CompensationErrorHandler\ behavior allows users to define custom strategies for handling critical errors during compensation execution, such as retrying or sending notifications. Distinct exception types (e.g., \Sage.AsyncTransactionTimeoutError\, \Sage.MalformedTransactionReturnError\) now provide clearer, structured error messages for runtime issues. The \Sage.Tracer\ behavior enables event-based monitoring of transaction and compensation lifecycle stages. Internally, execution logic has been moved to \Sage.Executor\, which supports passing custom supervisors for async tasks and propagates logger metadata to spawned tasks. The \Sage\ struct now implements a custom \Inspect\ protocol for more readable debugging output.
lib/sage · high confidence
Retry logic moved to dedicated module with improved validation and logging
The retry policy implementation has been extracted into a new dedicated module, Sage.Executor.Retries, to better organize the executor's internal logic. This change introduces stricter validation for retry options, ensuring that base\_backoff and max\_backoff are valid integers greater than or equal to 1; invalid configurations are now logged as errors and ignored rather than potentially causing unexpected behavior. The core retry mechanism, including exponential backoff with optional jitter, remains functionally similar but is now encapsulated within this specific module.
lib/sage/executor · high confidence
Test coverage
Added test support utilities for transaction and compensation testing; Added tests for Executor retry logic; Added tests for Sage executor and inspect protocol; Initial test suite for Sage transaction and compensation logic.
Dependencies
Upgrade to Elixir 1.7 and update development dependencies
The project now requires Elixir 1.7, replacing the previous 1.5 constraint, and updates its development tooling to ex\_doc 0.28.5, excoveralls 0.14.6, and dialyxir 1.2.0. This change also restructures the mix configuration to include proper package metadata, documentation settings, and dialyzer integration for improved build and testing workflows.
(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 62 → 64 (+2.7)
- Rubric changed (rubric-2026.10.5 → rubric-2026.11.3) — scores are not directly comparable.
Lenses
- Code Health 99 → 99 (+0.0)
- Architecture 69 → 69 (+0.0)
- Maturity 46 → 51 (+5.6)
- Readiness 70 → 70 (+0.0)
- Security 96 → 97 (+0.3)
New (2)
- Edited copy of a member (11 corresponding lines) (lib/sage/executor.ex)
- Medium CVE: EEF-[CVE redacted] (mix.lock)
Written by cca.canine.dev from the codebase's own history, inside the signed delivery this page is composed from.
Survey your own repository
Nebo15/sage 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 13 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 242013a2c21f9c5a249f2dc4978f5803f0f2d166 — the exact code this score is about.
- Scored under rubric-2026.11.3 — 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.57+preprod-8ebfb01cf4c0.