biberlabs/ddd-embeddables
60.8
Adequate · 9 November 2026
2k
lines of production code
PHP
primary language
10
measurements over time
What this system is
This system is a PHP-based application that manages domain-specific value objects, including color representations, personal information, geographic coordinates, and network addresses. It enforces strict type safety and robust validation for these entities, ensuring they handle empty or null states gracefully. The codebase has been modernized to PHP 8.0 standards, utilizing contemporary testing practices with PHPUnit to verify the behavior of these value objects.
Behavioural changes
Introduce Color value object and modernize existing value objects
Added a new Color value object that provides hexadecimal, RGB, and human-readable name representations. Updated existing value objects (FullName, DateRange, EmailAddress, GeoPoint, IpAddress, and IpRange) to use strict PHP 8 type hints, nullable types, and modernized constructors to allow empty/null states, improving robustness and reducing noise.
src · high confidence
Test coverage
Modernized and expanded test suite for value objects
The test suite for value objects (Color, FullName, GeoPoint, DateRange, EmailAddress, IpAddress, and IpRange) has been modernized to use PHPUnit 6+ syntax, including explicit return types, strict type hints, and the \TestCase\ base class. Invalid inputs now explicitly assert \InvalidArgumentException\ via \expectException\ rather than relying on annotations. New tests cover empty states for all value objects, and the \IpRange\ tests now include a \/32\ CIDR case.
tests · high confidence
Dependencies
Upgrade PHP 8 and modernize dependencies
The project now requires PHP 8.0 or higher, replacing the previous support for PHP 5.6 and 7.1. Additionally, the dependency on doctrine/orm has been updated to version 2.11, and the development dependency phpunit/phpunit has been upgraded to version 9.5 to align with modern testing standards.
(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
Score
- CAI 60 → 61 (+1.3)
- Rubric changed (rubric-2026.10.5 → rubric-2026.11.2) — scores are not directly comparable.
Lenses
- Code Health 71 → 71 (+0.0)
- Architecture 100 → 100 (+0.0)
- Maturity 56 → 61 (+4.6)
- Readiness 48 → 48 (+0.0)
- Security 99 → 100 (+1.3)
Resolved (2)
- Inconsistent naming convention for serialization/conversion methods. Some use 'to' prefix (toHex, toRGB, toRGBString, toArray), while others use 'jsonSerialize' (PSR-15/JSON standard) or 'getName' (domain-specific). Specifically, 'toRGB' returns an array while 'toRGBString' returns a string, but there is no 'toHex()' vs 'toHexString()' distinction, creating ambiguity about whether 'to' implies a primitive or a string representation.
- Inconsistent signature for toArray. DateRange.toArray accepts an optional 'format' parameter, while FullName, GeoPoint, and IpRange do not. This breaks the expectation that 'toArray' produces a consistent, predictable structure across the library.
Written by cca.canine.dev from the codebase's own history, inside the signed delivery this page is composed from.
Survey your own repository
biberlabs/ddd-embeddables 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 9 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 f308856c3491dae52e6ce46a8c463ea375938273 — 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.4+preprod-464a0040a931.