Skip to content
CAI
Software that uses CAICheck a score

avdi/naught

62.9

Adequate · 6 November 2026

1.5k

lines of production code

Ruby

primary language

4

measurements over time

CAI band scale
CAI trend line
CAI lens gauges

What this system is

Features

Add RBS type signatures for the Naught library

This change introduces RBS signature files (sig/naught.rbs) that define the type structure for the Naught null-object toolkit. The signatures cover the core API including the NullClassBuilder DSL, conversion helpers (Null, Maybe, Just, Actual), and the ChainProxy used for tracking method calls on null objects. This enables static type checking for users of the library via Steep or other RBS-compatible tools.

sig · high confidence

Naught null objects now track call stacks and support method chaining

Naught null objects now record the call stack for every method invocation, providing detailed location information (file, line, method name, and arguments) via the new \Naught::CallLocation\ class and \Naught::CallerInfo\ parser. This enables debugging by revealing exactly where null object methods were called. Additionally, chained method calls (e.g., \null.foo.bar\) are now grouped into a single trace entry via \Naught::ChainProxy\, while separate calls remain distinct. The library also introduces a \Conversions\ module with \Null()\, \Maybe()\, \Just()\, and \Actual()\ helpers for handling null-equivalent values, and uses \Naught::BasicObject\ as the base class for generated null objects to ensure minimal footprint.

lib/naught · high confidence

Removals

Removal of Bundler-generated executable wrappers

The \bin/\ directory has been removed, deleting executable wrappers for tools such as \rspec\, \rake\, \pry\, \guard\, \coderay\, \thor\, \autospec\, \htmldiff\, and \ldiff\. These files were standard Bundler-generated shims that facilitated running the corresponding gems; their removal means these commands are no longer available via the local project bin path and must be invoked through other means (e.g., directly from the gem or via \bundle exec\).

bin · high confidence

Architecture

Null object builder refactored into modular command classes

The internal implementation of the null object builder has been restructured from a monolithic class into a set of distinct, composable command classes (such as Callstack, Mimic, Pebble, PredicatesReturn, and NullSafeProxy). This architectural change preserves all existing user-facing capabilities—including method mimicking, predicate overrides, callstack tracking, and null-safe proxies—while improving code maintainability and enabling more granular configuration of null object behaviors.

_lib/naught/null\_class\builder/commands · high confidence

Behavioural changes

Modernized development tooling and added static type checking

The project has been updated to support Ruby 3.2+ and replaced RSpec with Minitest for testing, including running specs in random order to catch order-dependency bugs. Development workflows now use the Standard Ruby style guide and RuboCop for linting, with new Rake tasks for linting, documentation verification, and type checking. Steep static type checking has been added with RBS signatures for the library's dynamic method-discovery DSL, and the release process has been adapted to skip local gem pushing in favor of GitHub Actions.

(repo-wide) · high confidence

Refactor builder logic into dedicated command classes

The internal implementation of the NullClassBuilder has been restructured to extract specific builder operations into individual command classes (such as Callstack, Pebble, and NullSafeProxy). This change moves logic out of the main builder class into separate files, improving code organization and maintainability without altering the public API or user-facing behavior.

_lib/naught/null\_class\builder · high confidence

Refactored null object generation to use a builder DSL

The core mechanism for creating null objects has been restructured from a static \NullObject\ class inheriting from \BasicObject\ to a dynamic builder pattern. Users now generate null object classes via \Naught.build\, which accepts a block to configure the builder (e.g., enabling black hole behavior). This change introduces a new \NullClassBuilder\ and associated command modules, allowing for more flexible null object configurations such as mimicking specific interfaces or combining null object patterns with other behaviors, while maintaining backward compatibility through the \Naught.build\ entry point.

lib · high confidence

Fixes

1 commit (1 fix) fixing (repo-wide), duel

A fix in (repo-wide), duel — 1 commit (1 fix), 9 files: “Add Duel performance regression guards”.

duel · low confidence · unverified

Test coverage

Migrate test suite to Minitest and add comprehensive coverage; Removed RSpec test infrastructure files.

Dependencies

Modernize gem for Ruby 3.2+ and update tooling dependencies

The gem now requires Ruby 3.2.0 or later and has shifted its dependency management from the gemspec to the Gemfile. Development dependencies have been updated to use Minitest (\>= 6) instead of RSpec, and RuboCop has been replaced by the Standard Ruby style guide along with related performance and minitest cops. Additional tooling includes SimpleCov (\>= 1) for coverage, Steep for type checking, and YARD for documentation.

(dependencies) · 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

This is the PUBLIC form of this artifact. Findings are listed in full, but the details of SECURITY findings — which rule fired, in which file, on which line, and how to fix it — are deliberately withheld, and any secret-scanner results are excluded entirely. Where detail is absent here it was REMOVED FOR PUBLICATION; it is not missing from the analysis. The complete artifact is available from the repository owner.

Score

  • CAI 63 → 63 (-0.3)
  • Rubric changed (rubric-2026.10.5 → rubric-2026.11.2) — scores are not directly comparable.

Lenses

  • Code Health 100 → 95 (-5.4)
  • Architecture 69 → 69 (+0.0)
  • Maturity 50 → 50 (+0.0)
  • Readiness 70 → 70 (+0.1)
  • Security 89 → 88 (-1.5)

Resolved (3)

  • High: security finding (details withheld)
  • Off-boarding risk: anonymized user #1
  • Outdated: rubocop-performance

New (6)

  • 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)
  • Off-boarding risk: anonymized user #1

Changes since last survey

  • 7 commits — 6 feature/other, 1 fixes

By area

  • (root) — 5 commits
  • .github/workflows — 2 commits

Notable commits

  • fix: Add Duel performance regression guards
  • change: Bump actions/checkout from 6 to 7
  • change: Keep the Perf workflow's write access out of the Duel job
  • change: Test on JRuby 10.1, ruby-head, and jruby-head
  • change: Update Duel to 0.1.1
  • change: Update Duel to 0.1.2
  • change: Update Duel to 0.1.3

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

Survey your own repository

avdi/naught 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 6 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 2a2dffa736d4709d215f09c17578b9a6c46d8740 — the exact code this score is about.
  • Scored under rubric-2026.11.2 — 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.3+preprod-60d1b390edf0.