Skip to content
CAI
Software that uses CAICheck a score

tek/splain

57.0

Adequate · 6 November 2026

1.4k

lines of production code

Scala

primary language

4

measurements over time

CAI band scale
CAI trend line
CAI lens gauges

What this system is

Splain is a Scala compiler plugin that enhances diagnostic output by providing detailed type information and implicit resolution diagnostics. It supports Scala 2.13.7+ and earlier 2.13.x versions, offering features such as structured tree visualizations for diverging implicit errors and configurable type detail levels. The system is designed to integrate with sbt and Gradle to improve the clarity of compilation errors for developers.

How it got here

2016–2021 — Scala 2.13 plugin development and testing

16 changes.

The project focused on building and refining a compiler plugin for Scala 2.13.7+ to enhance implicit resolution diagnostics and error reporting. This period involved implementing core analysis features, establishing comprehensive acceptance tests, and modernizing the build infrastructure to support these capabilities.

2022 — Test infrastructure and coverage expansion

4 changes.

This period focused on building comprehensive testing infrastructure for the Scala compiler tool, introducing a new test fixtures module and a \splain.test\ package with runtime and compile-time compilation utilities. The work included implementing \TryCompile\ engines and macros to simulate real-world compilation scenarios, alongside extensive acceptance tests to verify static error reporting and implicit resolution diagnostics.

Features

Added Scala 2.13.7+ compiler plugin for improved type and implicit error messages

This change introduces the 'splain' compiler plugin for Scala 2.13.7 and later, which enhances compiler error messages by providing more detailed type information and implicit resolution diagnostics. The plugin replaces the default analyzer with a custom \SplainAnalyzer\ that includes specialized formatters for functions, tuples, Shapeless records, and refined types, and optionally includes debug output when enabled. It also handles migration of deferred package object openings to ensure compatibility with the compiler's internal state.

core/src/main/scala-2.13.7+ · high confidence

Initial project scaffolding and configuration

The repository is initialized with the core structure for the Splain Scala compiler plugin, including the MIT License, a comprehensive README detailing usage for Scala 2.12/2.13 and integration with sbt/Gradle, and configuration files for code formatting (Scalafmt) and static analysis (Scalafix). The setup also includes a Travis CI build script, Git attributes for line-ending consistency, and a Gradle wrapper to ensure reproducible builds.

(repo-wide) · high confidence

New development and CI automation scripts

The dev directory now includes a suite of shell scripts to streamline local development and continuous integration workflows. These scripts automate key tasks: CI execution (test.sh, .CI.sh, CI-latest.sh), code formatting and static analysis (format-code.sh), dependency management and Gradle wrapper updates (gradle-versions.sh), build logging and dependency tree generation (log-make-all.sh, make-all.sh), and publishing artifacts to Maven Local or Sonatype (publish-all.sh, publishM2-all.sh, publish.sh, publishM2.sh, publish.template.sh). This provides developers with standardized, reusable commands for common build and release operations.

dev · high confidence

Removals

Removal of Scala 2.10 compiler plugin support

The \splain\ compiler plugin implementation for Scala 2.10 has been removed, as indicated by the deletion of \splain/src/plugin.scala\. This change deactivates the plugin for Scala 2.10 due to incompatibilities with that version, meaning users on Scala 2.10 will no longer receive implicit resolution error formatting from this tool.

splain · high confidence

Removal of basic type-triple definitions

The \unit/src/basic.scala\ file, which defined the \\\\*\ type-triple operator and associated type aliases (\T1\, \T2\, \T3\) along with implicit conversions, has been removed from the codebase.

unit · high confidence

Removal of legacy Tryp build infrastructure

The project has removed its legacy Tryp-based build system, deleting the \project/build.scala\ definition, the nested \project/project\ bootstrapping files, and the \tryp.sbt\ plugin configuration files. This cleanup eliminates the dependency on the external \tryp-build\ plugin and the associated Bintray resolver, simplifying the build structure.

project · high confidence

Behavioural changes

Added internal error handling and message definitions for the Scala 2.13.6 analyzer plugin

The splain analyzer plugin now includes a dedicated error class (SplainInternalError) to report internal bugs with a link to the issue tracker, and a Messages object defining specific warning and error strings for implicit expansion diagnostics. These additions support the new capability to explain diverging implicit expansion errors in Scala 2.13.6.

core/src/main/scala/splain · high confidence

Centralized version management for Scala artifacts

The build system now uses a centralized \Versions\ class to manage project metadata and Scala version parsing. This change introduces logic to dynamically determine Scala artifact suffixes based on the major version (using '3' for Scala 3 and the binary version for earlier releases) and validates that the Scala version follows the 'X.Y.Z' format, ensuring consistent dependency resolution across the build.

buildSrc · high confidence

Improved diverging implicit error reporting and formatting

The core module now provides enhanced diagnostics for diverging implicit expansion errors. A new \ImplicitsExtension\ tracks implicit search history to detect and limit repeated diverging errors, preventing excessive output. Additionally, \SplainFormattingExtension\ introduces structured tree visualization for implicit errors, allowing users to see the hierarchy of failed implicit searches with support for both verbose and compact views. These changes are controlled via new plugin settings (\Vimplicits-diverging\, \Vimplicits-diverging-max-depth\, \Vtype-detail\, \Vtype-diffs-detail\) that enable detailed type and diff information.

repository · high confidence

Test coverage

Added BasicFixture with Scala compiler test cases; Added acceptance tests for static compile-time error reporting; Added compile-time and runtime code compilation utilities for testing; Added test coverage for builtin implicit resolution scenarios; Added test coverage for plugin error reporting and type detail features; Added test infrastructure for Splain acceptance tests; Added test resources for implicit and type mismatch error reporting; Added test resources for implicit error scenarios; Added tests for TryCompile static and runtime behavior.

Dependencies

Gradle wrapper updated to version 8.14.3

The project's Gradle wrapper has been initialized or updated to use Gradle 8.14.3. This ensures that all developers and CI environments build the project using a consistent, specific version of the Gradle build tool, eliminating potential discrepancies caused by different locally installed Gradle versions.

gradle · high confidence

Upgrade to Scala 2.13.18 and update test dependencies

The project has upgraded its Scala version to 2.13.18 (previously 2.13.15/16 in earlier commits) and updated the ScalaTest dependency to version 3.2.11. Additionally, the JUnit platform and Jupiter dependencies were updated to version 5.13.4, and the scalatestplus-junit-5-13 adapter was updated to 3.2.19.2. The build configuration also reflects a move to the new Sonatype Central Repository (ossrh-staging-api.central) for publishing artifacts.

(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 54 → 57 (+2.7)
  • Rubric changed (rubric-2026.10.5 → rubric-2026.11.2) — scores are not directly comparable.

Lenses

  • Code Health 72 → 72 (+0.0)
  • Architecture 69 → 69 (+0.0)
  • Maturity 46 → 52 (+5.6)
  • Readiness 54 → 54 (+0.0)
  • Security 69 → 69 (+0.0)

Resolved (71)

  • Dependency hygiene PARTLY measured — Gradle build resolved part of the dependency graph, currency reported but not scored
  • Off-boarding risk: anonymized user #1
  • Outdated (compile): ai.acyclic.scalatestplus:junit-5-13_2.13
  • Outdated (compile): com.chuusai:shapeless_2.13
  • Outdated (compile): com.eed3si9n:shaded-jawn-parser_2.13
  • Outdated (compile): com.eed3si9n:sjson-new-core_2.13
  • Outdated (compile): com.eed3si9n:sjson-new-scalajson_2.13
  • Outdated (compile): com.lmax:disruptor
  • Outdated (compile): dev.zio:izumi-reflect-thirdparty-boopickle-shaded_2.13
  • Outdated (compile): dev.zio:izumi-reflect_2.13
  • Outdated (compile): dev.zio:zio-stacktracer_2.13
  • Outdated (compile): dev.zio:zio_2.13
  • Outdated (compile): io.github.java-diff-utils:java-diff-utils
  • Outdated (compile): net.java.dev.jna:jna
  • Outdated (compile): net.openhft:zero-allocation-hashing
  • Outdated (compile): org.apache.logging.log4j:log4j-api
  • Outdated (compile): org.apache.logging.log4j:log4j-core
  • Outdated (compile): org.fusesource.jansi:jansi
  • Outdated (compile): org.jline:jline
  • Outdated (compile): org.jline:jline-native
  • …and 51 more

New (2)

  • Dependency hygiene PARTLY measured — Maven/Gradle declarations read, no dependency graph resolved
  • Off-boarding risk: anonymized user #1

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

Survey your own repository

tek/splain 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 60c92b5e6422738087a1ed65c70e41a9ebefbc27 — 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.