slepher/astranaut
65.5
Adequate · 15 November 2026
21.8k
lines of production code
Erlang
primary language
4
measurements over time
What this system is
Features
Added macro compilation benchmarks for performance validation
The benchmark directory now includes a suite of tools to measure macro expansion and compilation performance. This adds a generated workload (\macro\_2000.erl\) with deep nested structures to test AST depth handling, a desensitized real-world workload (\real\_benchmark.erl\) extracted from production code to measure realistic expansion costs, and a runner script (\macro\_compile\_bench.escript\) that reports parse-transform and compilation times. Supporting files include a minimal macro provider (\do\_macro.erl\) and header definitions (\realbench\_min.hrl\) to isolate the benchmark from external dependencies. Also in this area: 1 commit (0 fixes) modifying benchmark.
benchmark · medium confidence · unverified
Introduce new parse\_transform modules for compile metadata, options, and monadic 'do' syntax
This change adds several new Erlang modules to the \src\ directory that extend the Astranaut macro and transformation system. \astranaut\_compile\_meta\_transformer\ and \astranaut\_compile\_opts\ are new parse\_transforms that inject exported functions to expose transformed forms, compile errors, warnings, and the original compile options of a module, enabling better introspection and debugging of the transformation pipeline. \astranaut\_do\ introduces a new \do\ syntax construct that transforms list comprehensions into monadic bind chains, supporting Haskell-style monadic code within Erlang. These modules work in conjunction with the existing macro infrastructure (\astranaut\macro\\*\) to provide a more robust and feature-rich compile-time transformation environment.
src · high confidence
New development and validation tooling scripts
Added several new scripts to the project: \check\_syntax\_schema.escript\ audits \erl\_syntax\ compatibility across OTP versions 21–29 by comparing a local schema against fetched source code; \generate\_syntax\_schema.escript\ compiles the \src/syntax.term\ schema into a direct-dispatch Erlang module (\astranaut\_syntax\_schema.erl\); \cover\_report.escript\ generates a JSON coverage report from rebar3 eunit and common test data; \fetch\_absforms.sh\ and \fetch\_absforms.ps1\ download Erlang/OTP absform documentation for versions 21–29; and \rebar3\_sandbox.ps1\ configures the Erlang inet resolver for sandboxed environments.
scripts · high confidence
Behavioural changes
8 commits (1 fix) modifying common\_tests
A change to existing behaviour in common\_tests — 8 commits (1 fix), 119 files: “Complete struct map type rewriting and optional type generation”; “Migrate unit tests to EUnit”; “Fix reviewed AST and diagnostic bugs and expand regression coverage”; and 5 more.
_common\tests · medium confidence · unverified
Astranaut 0.13: Configurable quote context, macro isolation, and OTP 21+ requirement
Astranaut now requires Erlang/OTP 21 or higher, dropping support for OTP 19 and 20. Quote variables are encoded using a configurable context (defaulting to the current source module) instead of the module name, with options to explicitly set the context or disable it entirely; this is a breaking change requiring a clean rebuild of all modules using Astranaut macros. Local macro support is now an optional, lazily registered capability, meaning modules without \-local\_macro\ declarations no longer load the local macro subsystem. The library also introduces a shared diagnostic formatter protocol, explicit ownership for macro diagnostics, and improved handling of macro exceptions. Additionally, the build configuration has been updated to include cover analysis, specific Erlang first files, and plugins for Docker CI and release tree generation.
(repo-wide) · high confidence
Centralized include files for compile-time transformations and OTP version checks
The project now provides a set of centralized header files in the include directory to manage compile-time behaviors and dependencies. These files introduce parse\_transforms for specific features: \compile\_meta.hrl\ and \compile\_opts.hrl\ enable the \astranaut\_compile\_meta\_transformer\ and \astranaut\_compile\_opts\ respectively; \do.hrl\ enables the \astranaut\_do\ transform; \rebinding.hrl\ enables the \astranaut\_rebinding\ transform; and \struct.hrl\ enables the \astranaut\_struct\_transformer\ while importing necessary macros. Additionally, \otp\_vsn.hrl\ centralizes OTP version checking by defining macros like \ASTRANAUT\_OTP\_VSN\ and \ASTRANAUT\_OTP\_VSN\_GE\, and \astranaut\_struct\name.hrl\ defines internal constants such as \\\struct\\_\ and various return/error atoms used by the library's internal components.
include · high confidence
Test coverage
Added sample Plus module for EUnit testing; Migrate test suite to EUnit and expand coverage.
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 64 → 65 (+1.2)
- Rubric changed (rubric-2026.10.5 → rubric-2026.11.4) — scores are not directly comparable.
Lenses
- Code Health 76 → 75 (-0.8)
- Architecture 78 → 99 (+21.6)
- Maturity 66 → 67 (+1.5)
- Readiness 70 → 70 (+0.0)
- Security 57 → 57 (+0.0)
- Event Sourcing 100 → 100 (+0.0)
Resolved (8)
- Duplicated block (12 lines × 3) (common_tests/astranaut_rebinding_SUITE_data/rebinding_test.erl)
- Duplicated block (19–28 lines × 2) (common_tests/astranaut_rebinding_SUITE_data/rebinding_test.erl)
- FileTooLong: src/astranaut_rebinding.erl (src/astranaut_rebinding.erl)
- Hotspot: src/astranaut_macro.erl (src/astranaut_macro.erl)
- Hotspot: src/astranaut_macro_registry.erl (src/astranaut_macro_registry.erl)
- Hotspot: src/astranaut_struct_transformer.erl (src/astranaut_struct_transformer.erl)
- Projects may be oversized for their cohesion
- Small-team knowledge concentration
New (22)
- Duplicated block (18 lines × 2) (common_tests/astranaut_rebinding_SUITE_data/rebinding_test.erl)
- Duplicated block (21 lines × 3) (common_tests/astranaut_rebinding_SUITE_data/rebinding_test.erl)
- Duplicated block (26 lines × 2) (common_tests/astranaut_rebinding_SUITE_data/rebinding_test.erl)
- Duplicated block (29 lines × 2) (common_tests/astranaut_rebinding_SUITE_data/rebinding_test.erl)
- Edited copy of a member (10 corresponding lines) (src/astranaut_syntax.erl)
- Edited copy of a member (11 corresponding lines) (src/astranaut_forms.erl)
- Edited copy of a member (12 corresponding lines) (src/astranaut_rebinding.erl)
- Edited copy of a member (12 corresponding lines) (src/astranaut_struct.erl)
- Edited copy of a member (13 corresponding lines) (src/astranaut_macro_expander.erl)
- Edited copy of a member (13 corresponding lines) (src/astranaut_traverse.erl)
- Edited copy of a member (19 corresponding lines) (common_tests/astranaut_rebinding_SUITE_data/rebinding_test.erl)
- Edited copy of a member (21 corresponding lines) (common_tests/astranaut_rebinding_SUITE_data/rebinding_test.erl)
- Edited copy of a member (21 corresponding lines) (common_tests/astranaut_rebinding_SUITE_data/rebinding_test.erl)
- Edited copy of a member (21 corresponding lines) (src/astranaut_syntax.erl)
- Edited copy of a member (3 corresponding lines) (src/astranaut_macro_local.erl)
- Edited copy of a member (5 corresponding lines) (common_tests/astranaut_macro_SUITE_data/macro_example.erl)
- Edited copy of a member (5 corresponding lines) (common_tests/astranaut_macro_SUITE_data/macro_pass_export_helper_unlocked_test.erl)
- Edited copy of a member (5 corresponding lines) (src/astranaut.erl)
- Edited copy of a member (8 corresponding lines) (src/astranaut.erl)
- Edited copy of a member (9 corresponding lines) (common_tests/astranaut_macro_SUITE_data/macro_example.erl)
- …and 2 more
Changes since last survey
- 10 commits — 6 feature/other, 4 fixes
By area
- (root) — 5 commits
- common_tests/astranaut_macro_SUITE.erl — 1 commit
- common_tests/astranaut_rebinding_SUITE_data — 1 commit
- docs/plans — 1 commit
- scripts/generate_syntax_schema.escript — 1 commit
- test/astranaut_review_regression_tests.erl — 1 commit
Notable commits
- fix: Fix formatter context and AST validation Dialyzer warnings
- fix: Fix regression test compatibility with older OTP versions
- fix: Fix reviewed AST and diagnostic bugs and expand regression coverage
- fix: Fix variable scope joins and validate OTP 21 through 29
- change: Avoid variable collisions in astranaut do transforms
- change: Complete struct map type rewriting and optional type generation
- change: Extract variable scope analysis and simplify callback contracts
- change: Keep fixture editor warnings quiet while validating test diagnostics
- change: docs: correct callback type and attribute return addendum
- change: docs: refresh committed codebase map and working tree addendum
Written by cca.canine.dev from the codebase's own history, inside the signed delivery this page is composed from.
Survey your own repository
slepher/astranaut 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 947cec2ee87e0c91cacdaa6a58e52f750ab74121 — 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.