Skip to content
CAI
Software that uses CAICheck a score

eproxus/keysmith

68.9

Adequate · 15 November 2026

512

lines of production code

Erlang

primary language

4

measurements over time

CAI band scale
CAI trend line
CAI lens gauges

What this system is

This system is a library for generating and parsing TypeIDs and UUIDs, providing utilities to handle their internal structures and variants. It exposes functions to parse identifiers into detailed maps containing component fields like version, randomness, and timestamps. The codebase includes automation scripts for managing project releases and synchronizing test data from upstream repositories.

Features

Automated release and test data update scripts

Added \scripts/release.sh\ to automate the Rebar project release process, including version bumping, changelog generation, tagging, and publishing to Hex.pm and GitHub (with dry-run support). Added \scripts/update\_test\_data.sh\ to manage the \test/fixtures/type\_id\ subtree by pulling updates from the upstream \jetify-com/typeid\ repository and cleaning up the local copy.

scripts · high confidence

Behavioural changes

Breaking change: parsed UUIDs now return maps instead of tuples

The output of \keysmith:parse/2\ has changed to return maps for parsed UUIDs instead of the previous tuple format. This is a breaking change for users relying on the old tuple structure, as the function now returns a map containing fields such as \var\, \ver\, \bin\, \hex\, and \val\ (which itself contains \rand\_a\, \rand\_b\, and \unix\_ts\).

(repo-wide) · high confidence

Redefines UUID and TypeID internal types to use maps and adds nil/max variants

The internal Erlang type definitions for UUIDs and TypeIDs have been refactored to use map-based specifications (e.g., \uuid\_map/0\) instead of previous tuple or simple atom representations. This change introduces explicit support for 'nil' and 'max' UUID variants as distinct types (\uuid\_nil/0\, \uuid\_max/0\) and restructures the v4 and v7 UUID specs to expose their components (such as random bits and timestamps) via map keys. Users interacting with these types programmatically will need to adapt to the new map-based structure for parsing and generating IDs.

src · high confidence

Test coverage

Updated tests to reflect UUID parsing returning maps instead of tuples

The test suite for the keysmith library has been updated to align with the internal change where \keysmith:parse/2\ now returns a map structure (containing fields like \var\, \ver\, \val\, \bin\, \hex\) rather than a tuple. This includes updating unit tests in \keysmith\_tests.erl\ to match the new map format for UUID v4 and v7 parsing, and modifying property-based tests in \prop\_keysmith.erl\ to verify the new map structures for UUIDs and TypeIDs.

test · 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 69 → 69 (+0.0)
  • Rubric changed (rubric-2026.10.5 → rubric-2026.11.4) — scores are not directly comparable.

Lenses

  • Code Health 100 → 100 (+0.0)
  • Architecture 69 → 69 (+0.0)
  • Maturity 59 → 59 (+0.0)
  • Readiness 83 → 83 (+0.0)
  • Security 85 → 85 (+0.0)

Resolved (1)

  • Disclosure policy routes reports to a public channel

New (1)

  • Disclosure policy has no reporting contact (SECURITY.md)

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

Survey your own repository

eproxus/keysmith 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 357b567999c0e11a5939fbc107505411ac42bdf2 — 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.