Skip to content
CAI
Software that uses CAICheck a score

slepher/astranaut

65.5

Adequate · 15 November 2026

21.8k

lines of production code

Erlang

primary language

4

measurements over time

CAI band scale
CAI trend line
CAI lens gauges

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.