Skip to content
CAI
Software that uses CAICheck a score

biberlabs/ddd-embeddables

60.8

Adequate · 9 November 2026

2k

lines of production code

PHP

primary language

10

measurements over time

CAI band scale
CAI trend line
CAI lens gauges

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.