Skip to content
CAI
Software that uses CAICheck a score

hrzndhrn/recode

71.5

Strong · 15 November 2026

5.9k

lines of production code

Elixir

primary language

5

measurements over time

CAI band scale
CAI trend line
CAI lens gauges

What this system is

Recode is an Elixir library and CLI tool that integrates with \mix format\ to provide automated code linting and autocorrection. It operates as an OTP application that executes a configurable suite of tasks, such as enforcing alias ordering, removing debug statements, and optimizing pipe chains, to improve code quality and style. The system processes source files asynchronously, capturing issues and applying transformations based on user-defined configurations.

How it got here

2021 — Initial scaffolding and task framework

7 changes.

The project was initialized with essential configuration and documentation, establishing the foundational structure for the Recode library. A comprehensive suite of linting and formatting tasks was introduced to replace the previous command-line interface, supported by a robust test infrastructure using Mox mocks. This period also involved a major dependency overhaul to support Elixir 1.15+ and upgrade the core code transformation engine.

2022–2025 — Core infrastructure and test suite expansion

16 changes.

This period focused on establishing Recode as a proper OTP application with a robust supervision tree and integrating it with mix format via a dedicated plugin. Significant effort was dedicated to building comprehensive test coverage for core modules, runners, and CLI tasks, alongside adding extensive fixtures and example projects to validate functionality.

Features

Added minimal example library and backup Mix task

The examples directory now includes a minimal library module providing a simple hello world function, alongside a new Mix task that allows users to create and restore project backups by serializing specified directories into a binary file.

_examples/minimal, examples/my\code/lib/mix · high confidence

Expanded example library with new code samples

The example library in \examples/my\_code/lib/my\_code\ has been significantly expanded with numerous new modules to demonstrate various Elixir coding patterns and edge cases. New files include \alias\_expansion.ex\ and \alias\_order.ex\ for aliasing behaviors, \deep.ex\ for nested control flow, \multi.ex\ and \pipe\_fun\_one.ex\ for pipe operator usage, and \raise\_task.ex\ to demonstrate task error handling. Additional samples cover simple functions (\fun.ex\, \happy.ex\), specific formatting scenarios (\same\_line.ex\, \trailing\_comma.ex\), and documentation tags (\tags.ex\). These additions provide a richer set of examples for users to test and understand the tool's capabilities.

_examples/my\_code/lib/my\code · high confidence

Initial project scaffolding and configuration

The repository is initialized with essential configuration files for development and code quality, including a Credo linter setup (.credo.exs), a Dialyzer ignore list (.dialyzer\_ignore.exs), and a default Recode linter configuration (recode.exs). The project also includes standard documentation and legal files such as a CHANGELOG, LICENSE, and Code of Conduct, alongside a .gitignore that excludes temporary files and Dialyzer PLTs.

(repo-wide) · high confidence

New Recode CLI tasks for linting, configuration, and help

This change introduces the \mix recode\ task, which runs the linter on source files (reading from stdin if \-\ is passed) and supports options for autocorrection, dry runs, and specific task selection. It also adds \mix recode.gen.config\ to generate a default \.recode.exs\ configuration file, \mix recode.update.config\ to safely merge and update existing configs while removing deprecated keys, and \mix recode.help\ to list available linting tasks and display their documentation.

lib/mix/tasks · high confidence

New example projects for Recode configuration and usage

Added two new example projects, \minimal\ and \my\_code\, to demonstrate how to configure and use the Recode tool. The \minimal\ example provides a basic \.recode.exs\ configuration with a standard set of tasks (such as AliasExpansion, Dbg, and Specs) and a standard \.formatter.exs\. The \my\_code\ example illustrates a more complex setup, including integration with Credo, custom formatter plugins (FreedomFormatter, Recode.FormatterPlugin), Ecto migrations, and specific task configurations like AliasOrder.

examples · high confidence

New linting and formatting tasks for Elixir code

The \lib/recode/task\ directory now includes a comprehensive suite of new tasks that extend the \mix recode\ tool with additional code quality checks and automatic corrections. These new capabilities include \AliasOrder\ to enforce alphabetical sorting of aliases, \Dbg\ and \IOInspect\ to detect and remove debug calls, \EnforceLineLength\ to collapse multiline expressions, \FilterCount\ to optimize Enum pipelines, \Format\ to run the Elixir formatter, \LocalsWithoutParens\ to remove unnecessary parentheses, \Moduledoc\ to ensure modules have documentation, \Nesting\ to check code depth, \PipeChainStart\ to improve pipe readability, \SinglePipe\ to simplify single-step pipes, \Specs\ to check for type specifications, \TagFIXME\ and \TagTODO\ to find TODO comments, \TestFile\ to validate test file naming, \UnnecessaryIfUnless\ to simplify boolean logic, and \UnusedVariable\ to prefix unused variables with underscores. Additionally, \AliasExpansion\ and \PipeFunOne\ have been refactored to integrate with the new task framework, providing autocorrection for multi-aliases and one-arity function parentheses respectively.

lib/recode/task · high confidence

Recode introduces a new application supervision tree and formatter plugin for mix format integration

Recode now starts as a proper OTP application with a dedicated supervisor (Recode.Supervisor) and a Task Supervisor, replacing the previous ad-hoc process management. This structural change enables the new Recode.FormatterPlugin, which allows Recode tasks to run automatically during \mix format\ by adding the plugin to \.formatter.exs\. The plugin reads the \.recode.exs\ configuration and executes the defined tasks, providing a seamless way to enforce code style and correctness rules alongside standard formatting.

lib/recode · high confidence

Removals

Removal of the main Recode Mix task

The \Mix.Tasks.Recode\ module has been removed from the codebase. This eliminates the primary command-line interface that previously allowed users to run code transformations (such as alias expansion and pipe function adjustments) on Elixir source files via the \mix recode\ command. Users can no longer invoke this specific task to automatically refactor code in the \lib\ and \test\ directories.

lib/mix/task · high confidence

Behavioural changes

Async task execution with structured error handling

The recode runner now executes tasks asynchronously using a task supervisor, allowing multiple source files to be processed in parallel. This change introduces structured error handling where exceptions during task execution are caught and recorded as issues on the source file rather than crashing the entire run, and it adds event management to notify listeners of task start/finish events and overall progress.

lib/recode/runner · high confidence

Update module documentation and remove placeholder code

The Recode module's documentation has been updated to describe the library as a formatter and linter with autocorrection, replacing the previous generic placeholder text. Additionally, the sample 'hello' function and its associated documentation have been removed from the public API.

lib · high confidence

Test coverage

Added placeholder for PLT test support directory; Added test coverage for Recode core modules; Added test fixtures for Recode.Context; Added test fixtures for the rename task; Added test fixtures for the runner; Added test fixtures for valid and invalid task configurations; Added test support utilities for formatter and task testing; Added tests for Recode Mix tasks; Added tests for Recode tasks; Added tests for Recode.Runner.Impl; Updated test infrastructure with Mox mocks and support files.

Dependencies

Recode 0.9.0: Major dependency overhaul and Elixir 1.15+ support

Recode has been updated to version 0.9.0, raising the minimum supported Elixir version from 1.10 to 1.15. This release replaces the previous \nimble\_options\ dependency with \escape\ and \glob\_ex\, and upgrades the core code transformation engine from \sourceror\ to \rewrite\ (v1.2+). The \sourceror\ dependency is now managed transitively by \rewrite\. Development tooling has also been updated, adding \dialyxir\ for static analysis, \excoveralls\ for test coverage reporting, and \mox\ for mocking in tests.

(dependencies) · high confidence

Housekeeping

Added empty placeholder file in tmp directory

An empty .keep file was added to the tmp directory to ensure the directory is tracked by version control.

tmp · 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 72 → 72 (-0.3)
  • Rubric changed (rubric-2026.10.5 → rubric-2026.11.4) — scores are not directly comparable.

Lenses

  • Code Health 96 → 95 (-0.9)
  • Architecture 98 → 98 (-0.0)
  • Maturity 59 → 59 (+0.0)
  • Readiness 69 → 69 (-0.1)
  • Security 97 → 95 (-2.1)

New (9)

  • Edited copies of one member (3 members, 7+ corresponding lines) (lib/recode/task/filter_count.ex)
  • Edited copies of one member (3 members, 9+ corresponding lines) (lib/recode/task/alias_expansion.ex)
  • Edited copy of a member (12 corresponding lines) (lib/recode/ast.ex)
  • Edited copy of a member (5 corresponding lines) (lib/recode/ast.ex)
  • Edited copy of a member (5 corresponding lines) (lib/recode/ast.ex)
  • Edited copy of a member (5 corresponding lines) (lib/recode/context.ex)
  • Medium CVE: EEF-[CVE redacted] (examples/my_code/mix.lock)
  • Medium CVE: EEF-[CVE redacted] (examples/my_code/mix.lock)
  • Outdated: dialyxir

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

Survey your own repository

hrzndhrn/recode 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 15 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 83d498cadd919e16f36c2339d77bdf0902636725 — 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-3c33c1882dc1.