Nebo15/sage

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.

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

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

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

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

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.

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 watchdog.canine.dev from the codebase's own history, inside the signed delivery this page is composed from.

• CAI 54 → 55 (+1.4)
• Rubric changed (rubric-2026.08.19 → rubric-2026.09.15) — scores are not directly comparable.

• Code Health 100 → 99 (-0.1)
• Architecture 69 → 69 (+0.0)
• Maturity 31 → 33 (+1.8)
• Readiness 74 → 68 (-6.4)
• Security 76 → 95 (+19.7)

• Coverage not included — suite not readable by the collector
• Dependency hygiene not measured — no supported dependency manifest was read
• Duplicated block (11 lines × 2) (lib/sage/executor.ex)
• High CVE: [GHSA redacted] (mix.lock)
• 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)
• Medium CVE: EEF-[CVE redacted] (mix.lock)
• No exposed public API
• Orphaned knowledge (lib/sage/executor.ex)
• Test reliability not included
• dormant codebase — no living knowledge left to concentrate

• Documentation: no installation or build instructions (README.md)
• Documentation: no usage examples (README.md)
• Duplicated block (11 lines × 2) (lib/sage/executor.ex)
• High CVE: [GHSA redacted] (mix.lock)
• 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)
• Job token omits the contents scope its checkout needs
• Medium CVE: EEF-[CVE redacted] (mix.lock)
• Medium: security finding (details withheld)
• Medium: security finding (details withheld)
• No dependency advisory monitoring
• Outdated: dialyxir
• Outdated: ex_doc
• Outdated: excoveralls
• Outdated: junit_formatter
• TodoComment (lib/sage/executor.ex)

• 1 commits — 1 feature/other, 0 fixes

• lib/sage — 1 commit

• change: Logger.warn -> Logger.warning (deprecated since Elixir 1.15) (#85)

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

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.