hrzndhrn/recode
71.5
Strong · 15 November 2026
5.9k
lines of production code
Elixir
primary language
5
measurements over time
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.