avdi/naught
62.9
Adequate · 6 November 2026
1.5k
lines of production code
Ruby
primary language
4
measurements over time
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.