Skip to content
CAI
Software that uses CAICheck a score

hexpm/hex_core

77.1

Strong · 15 November 2026

9.4k

lines of production code

Erlang

primary language

5

measurements over time

CAI band scale
CAI trend line
CAI lens gauges

What this system is

Features

Introduce structured protocol buffers for package metadata, policies, and security advisories

This change adds a new set of Protocol Buffers definitions (proto2) to the \proto/\ directory, establishing the data contracts for the registry. The schema introduces \hex\_pb\_package.proto\ to define package and release structures, including fields for checksums, dependencies, retirement status, and security advisories. It adds \hex\_pb\_policy.proto\ to model repository-level policies, visibility settings, and granular restrictions/overrides (allow, deny, advisory, retirement, cooldown). Security information is formalized in \hex\_pb\_signed.proto\ for payload verification and \hex\_pb\_versions.proto\ for version indexing, including retired and advisory flags. These definitions provide the foundational serialization format for package data, policy enforcement, and security advisory integration.

proto · high confidence

New Hex API client modules and security advisory grouping

This release introduces a comprehensive set of new modules for interacting with the Hex API, including \hex\_api\ (core HTTP request handling), \hex\_api\_auth\ (key testing), \hex\_api\_key\ (key management), \hex\_api\_oauth\ (OAuth device and client credentials flows), \hex\_api\_organization\ and \hex\_api\_organization\_member\ (organization and member management), \hex\_api\_package\ and \hex\_api\_package\_owner\ (package and owner operations), \hex\_api\_release\ (publishing, retiring, and deleting releases), \hex\_api\_short\_url\ (short URL creation), and \hex\_api\_user\ (user account operations). Additionally, \hex\_advisory\ is added to group and deduplicate security advisories from multiple sources (EEF, GHSA, NVD) by identifying primary identifiers and merging aliases, ensuring users see one entry per vulnerability. \hex\_cli\_auth\ provides the CLI authentication layer with support for API keys, OAuth tokens, OTP, and device auth flows, integrating with the new API modules.

src · high confidence

New Hex API example application

Added a new example application (myapp\_hex) that demonstrates how to interact with the Hex package manager API. The example provides functions to retrieve package details, repository versions, and tarballs, utilizing a naive process-dictionary-based HTTP cache for repeated requests and supporting API key authentication via the HEX\_API\_KEY environment variable.

examples · high confidence

Rename to hex\_core and introduce new build tool authentication

The library has been renamed from hex\_erl to hex\_core, with updated documentation and configuration to reflect this identity. A major new capability is added in v0.19.0: the \hex\_cli\_auth\ module provides callback-based authentication for build tools, handling OAuth token exchange, automatic refresh, and OTP prompts via \with\_api/3,4\ and \with\_repo/2,3\ wrappers. This is accompanied by the \hex\_api\_oauth:device\_auth\_flow/4,5\ function for complete OAuth device authorization. The project also updates its build configuration to use rebar3 profiles for development and testing dependencies.

(repo-wide) · high confidence

Test coverage

Add HTTP test fixtures and test helpers; Expanded Common Test suite for security, authentication, and tarball handling.

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 78 → 77 (-0.8)
  • Rubric changed (rubric-2026.10.5 → rubric-2026.11.4) — scores are not directly comparable.

Lenses

  • Code Health 75 → 74 (-1.6)
  • Architecture 100 → 100 (+0.0)
  • Maturity 85 → 83 (-1.4)
  • Readiness 78 → 78 (+0.0)
  • Security 75 → 75 (+0.0)
  • Event Sourcing 100 → 100 (+0.0)

Resolved (1)

  • Off-boarding risk: anonymized user #1

New (23)

  • Edited copies of one member (3 members, 10+ corresponding lines) (examples/myapp_hex.erl)
  • Edited copies of one member (3 members, 3+ corresponding lines) (src/hex_api_package.erl)
  • Edited copies of one member (4 members, 9+ corresponding lines) (src/hex_registry.erl)
  • Edited copies of one member (4 members, 9+ corresponding lines) (src/hex_repo.erl)
  • Edited copy of a member (14 corresponding lines) (src/hex_deflate.erl)
  • Edited copy of a member (15 corresponding lines) (src/hex_erl_tar.erl)
  • Edited copy of a member (15 corresponding lines) (src/hex_http_httpc.erl)
  • Edited copy of a member (18 corresponding lines) (src/hex_tarball.erl)
  • Edited copy of a member (18 corresponding lines) (src/hex_tarball.erl)
  • Edited copy of a member (25 corresponding lines) (src/hex_cli_auth.erl)
  • Edited copy of a member (3 corresponding lines) (src/hex_api_key.erl)
  • Edited copy of a member (3 corresponding lines) (src/hex_api_key.erl)
  • Edited copy of a member (3 corresponding lines) (src/hex_api_package_owner.erl)
  • Edited copy of a member (5 corresponding lines) (src/hex_http.erl)
  • Edited copy of a member (6 corresponding lines) (src/hex_api_organization_member.erl)
  • Edited copy of a member (7 corresponding lines) (src/hex_deflate.erl)
  • Edited copy of a member (7 corresponding lines) (src/hex_erl_tar.erl)
  • Edited copy of a member (8 corresponding lines) (src/hex_erl_tar.erl)
  • Edited copy of a member (9 corresponding lines) (src/hex_erl_tar.erl)
  • Edited copy of a member (9 corresponding lines) (src/hex_repo.erl)
  • …and 3 more

Changes since last survey

  • 6 commits — 6 feature/other, 0 fixes

By area

  • src/hex_api_release.erl — 3 commits
  • .github/workflows — 2 commits
  • (root) — 1 commit

Notable commits

  • change: Add staged release status API (#255)
  • change: Bump zizmorcore/zizmor-action from 0.7.1 to 0.8.0 (#258)
  • change: Check if the release is published with the hex.pm API (#261)
  • change: Do Workload Identity Publish using rebar3_hex (#259)
  • change: Remove hex_api_release:get_staged/2 (#257)
  • change: Send the package owner organization on publish (#260)

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

Survey your own repository

hexpm/hex_core 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 5d09056fde1d16c7e01df8ace1667c9a5e5efcc0 — 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.