Skip to content
CAI
Software that uses CAICheck a score

scalacenter/scalac-profiling

63.0

Adequate · 7 November 2026

2.2k

lines of production code

Scala

with JavaScript

4

measurements over time

CAI band scale
CAI trend line
CAI lens gauges

What this system is

Features

Add English homepage skeleton for the website

A new React-based homepage component has been added for the English version of the site. This page displays a hero section with a 'Get started' link to the user guide and a features section highlighting capabilities such as speeding up Scala 2 compilation and optimizing macros.

website/pages · high confidence

Add Scala 2.13.18 support

The plugin now supports Scala 2.13.18 by adding a dedicated source directory for this version. This includes a new SettingsOps utility that exposes the statistics-enabled setting, allowing the profiler to correctly detect and handle statistics configuration in Scala 2.13.18.

plugin/src/main/scala-2.13.18 · high confidence

Added AbsolutePath and RelativePath utility classes

The profiledb module now includes new \AbsolutePath\ and \RelativePath\ value classes in the \ch.epfl.scala.profiledb.utils\ package. These utilities provide a structured way to handle file system paths, offering methods to resolve relative paths against a base, convert between absolute and relative representations, and perform basic file operations like checking if a path is a file or directory. This replaces or supplements previous ad-hoc path handling with a more robust, type-safe API for path manipulation within the tool.

profiledb/src/main/scala/ch.epfl.scala.profiledb/utils · high confidence

Added Scala version detection utilities for the plugin

The plugin now includes version-specific implementations of ScalaSettingsOps to distinguish between Scala 2.12 and 2.13 at runtime. This allows the profiler to correctly identify the active Scala version and apply appropriate settings or behaviors for each supported release.

plugin/src/main/scala-2.12, plugin/src/main/scala-2.13 · high confidence

Added case-app integration scaffolding for CLI command definitions and parsers

New files \Commands.scala\ and \Parsers.scala\ have been added to the \integrations\ module to define the structure for a \case-app\ based command-line interface. \Commands.scala\ establishes the command hierarchy (including Help, Autocomplete, Bsp, Compile, Test, Console, and Run) and defines their options, while \Parsers.scala\ provides the necessary implicit parsers and default values to parse these commands. This change introduces the foundational code for integrating \case-app\ argument parsing within the profiling integrations layer.

integrations · high confidence

Initial implementation of ProfileDb for storing and retrieving profile data

This change introduces the core \ProfileDb\ component, which provides the ability to read and write profile database files using Protocol Buffers. It includes \ProfileDbPath\ for validating and constructing file paths with specific extensions and prefixes, ensuring data is stored in the correct location. Users can now persist profiling data to disk and retrieve it reliably, forming the foundation for subsequent features like flamegraph generation.

profiledb/src/main/scala/ch.epfl.scala.profiledb · high confidence

Initial sbt build infrastructure for scalac-profiling

The project now includes a complete sbt build definition (BuildPlugin.scala) that configures the scalac-profiling plugin, including publishing settings, license headers, and developer metadata. It introduces integration test support by pulling in external projects (better-files and wartremover) as source dependencies to verify plugin behavior. The build also defines custom sbt commands and keys for performance debugging, source compiler plugin options, and cross-building support, with sbt versions set to 1.13.0 for the main project and 1.9.9 for the project-level build.

project · high confidence

Initial website configuration and navigation structure

The website now includes a Docusaurus site configuration (siteConfig.js) and sidebar navigation (sidebars.json). Users can access the documentation via a 'Docs' link in the header, which leads to a sidebar organizing content into 'Usage' (motivation, installation, usage) and 'Plugins' (sbt-plugin) sections. The site is configured with Algolia search credentials, specific branding colors, and links to the project's GitHub repository.

website · high confidence

The website core now includes a Footer component that displays site branding, documentation links (Installation, Usage), community links (Discord, Scala Users), and GitHub repository access, along with a GridBlock component that renders structured content blocks with configurable layouts (two, three, or four columns) and image alignment options.

website/core · high confidence

Initial website styling and performance visualization assets

The website now includes a custom CSS stylesheet that defines layout rules for headers, image alignment, and responsive breakpoints, as well as an interactive SVG flamegraph visualizing Scala implicit search performance with zoom and search capabilities.

website/static · high confidence

Introduce ProfileDB schema for storing compilation statistics

A new protobuf schema (profiledb.proto) defines the data model for the ProfileDB instance, enabling the storage of global and per-compilation-unit profiling statistics. The schema structures data around Database entries containing RunProfiles (with PhaseProfiles, Timers, and Counters) and CompilationUnitProfiles (tracking Macro and ImplicitSearch metrics), allowing the system to persist and retrieve detailed compilation performance data incrementally.

profiledb/src/main/protobuf · high confidence

Introduce Scala compiler profiling plugin with flamegraph and implicit search analysis

A new \scalac-profiling\ plugin has been added to instrument the Scala compiler for performance analysis. It introduces several command-line options to control data collection: \generate-global-flamegraph\ and \generate-macro-flamegraph\ create visual flamegraphs for implicit searches and macro expansions respectively; \generate-profiledb\ outputs structured profile data; and \show-profiles\ logs detailed statistics on macro and implicit search performance per call-site, file, and type. Users can also filter output using \print-search-result\ to inspect specific implicit search IDs, \print-failed-macro-implicits\ to see trees of failed candidates, and \show-concrete-implicit-tparams\ to display concrete type parameters in implicit flamegraphs. The plugin supports configuration of source and cross-target directories via \sourceroot\ and \cross-target\ options.

plugin/src/main/scala/ch/epfl/scala · high confidence

Introduce sbt-scalac-profiling plugin for compiler warmup and timing

Adds the \sbt-scalac-profiling\ plugin, which provides a \profilingWarmupCompiler\ task and a \warmupCompileFor\ command to warm up the Scala compiler for a specified duration. The plugin tracks compilation times using classloaders and scoped keys, allowing users to measure and optimize compiler startup performance within their sbt builds.

sbt-plugin/src/main · high confidence

New documentation generation and CLI integration infrastructure

This change introduces new components for the documentation generation tool and the CLI integration layer. It adds a \DependencyResolution\ utility in \docs-gen\ to resolve artifacts via Coursier, and a \Sonatype\ helper to fetch the latest release versions from Sonatype staging and release repositories. In the \integrations\ module, it adds \CliOptions\ and \CommonOptions\ for the \caseapp\ integration, defining command-line arguments and environment-specific settings. Additionally, the compiler plugin gains \ImplicitSearchDebugInfo\ to track implicit search firings and source files, and \ProfilingImpl\ is updated to register macro and analyzer plugins, aggregate macro and implicit profiling statistics, and generate flamegraph data for both macros and implicit searches.

repository · high confidence

Behavioural changes

Add Scala 2.13.17 support

The plugin now includes a dedicated source directory for Scala 2.13.17, containing a new SettingsOps utility that exposes the compiler's statistics-enabled setting, enabling the profiler to correctly query and respect statistics configuration for this specific Scala version.

(repo-wide) · high confidence

Added Scala 2.12.18-specific settings helper

A new \SettingsOps\ helper object was added to the Scala 2.12.18 plugin source directory to expose the \areStatisticsEnabled\ setting from the Scala compiler global, enabling the profiler to check if statistics collection is active for this specific compiler version.

plugin/src/main/scala-2.12.18, plugin/src/main/scala-2.13.14 · high confidence

Added Scala 2.13.15-specific settings operations

A new \SettingsOps\ utility object has been added for the Scala 2.13.15 toolchain, providing a method to check if statistics are enabled via the compiler's global settings.

plugin/src/main/scala-2.13.15 · high confidence

Automated documentation generation with dynamic Scala version lists

The documentation build process now automatically generates site variables for supported Scala 2.12 and 2.13 versions, sorting them in descending order to display the most recent versions first. This change introduces a new entry point in the docs-gen module that prepares these version lists and passes them to mdoc, ensuring the generated documentation always reflects the current set of cross-compiled Scala versions without manual updates.

docs-gen · high confidence

Refactor profiler internals with new logging and robust quantity access

The profiler plugin introduces a new Logger utility for structured debug and info output and replaces the previous method of accessing compiler statistics with a QuantitiesHijacker that safely retrieves registered quantities by falling back to method invocation if field access fails. These changes improve the reliability of internal data collection and provide better visibility into profiler operations.

plugin/src/main/scala/ch/epfl/scala/profilers · high confidence

Repository configuration and documentation overhaul

The repository has been restructured with new configuration files and documentation to improve developer experience and project clarity. A \.gitignore\ file was added to exclude build artifacts, IDE settings, and generated files. The \.scalafmt.conf\ was updated to version 3.11.5 with stricter formatting rules, including preserved trailing commas and specific docstring styles. A \.jvmopts\ file was introduced to set JVM memory and code cache limits for consistent builds. Documentation was significantly expanded: a new \HISTORICALCONTEXT.md\ details the project's origins and goals, \PROPOSAL.md\ outlines the original performance profiling proposal, and \IDEAS.md\ lists future optimization concepts. The \README.md\ was updated with installation instructions, maintenance status, and links to external resources. Additionally, a \.git-blame-ignore-revs\ file was created to ignore formatting commits, and a \.gitmodules\ file was added to include the FlameGraph submodule.

(repo-wide) · high confidence

Fixes

Add Scala 2.12.19-specific SettingsOps utility

A new SettingsOps object has been added for the Scala 2.12.19 plugin variant, providing a helper method to check if statistics are enabled via the compiler's global settings.

plugin/src/main/scala-2.12.19 · high confidence

Test coverage

Added sbt integration tests for compiler warmup profiling; Added shapeless HList test fixture for compiler profiling; Added test infrastructure and implicit resolution tests.

Dependencies

Added FlameGraph submodule

The repository now includes the FlameGraph tool as a Git submodule (commit 85f58b8), making it available for use within the project's external directory.

external · high confidence

Upgrade build infrastructure and update dependencies

The build system has been significantly restructured and updated. Key dependency upgrades include sbt-assembly to 2.4.1, sbt-ci-release to 1.12.1, sbt-scalafmt to 2.6.2, sbt-mdoc to 2.9.2, sbt-buildinfo to 0.13.2, sbt-git to 2.2.0, sbt-protoc to 1.0.8, sbt-ghpages to 0.10.0, junit to 4.13.2, junit-interface to 0.13.3, and pprint to 0.9.0. The project now supports Scala 2.12.18–2.12.21 and 2.13.14–2.13.18, replacing the previous limited version support. The build also introduces a new \profiledb\ module for handling profiling data and updates the main plugin to use \scala-compiler\ directly with improved cross-compilation settings.

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

Lenses

  • Code Health 75 → 75 (+0.0)
  • Architecture 94 → 94 (+0.0)
  • Maturity 48 → 56 (+8.0)
  • Readiness 56 → 60 (+3.7)
  • Security 85 → 75 (-10.2)

Resolved (6)

  • Duplicate intent across types: Both ProfilingSbtPlugin and ProfilingPluginImplementation expose identical lifecycle methods/properties (globalSettings, buildSettings, projectSettings) that return the same type (Seq[Setting[_]]). In an sbt plugin architecture, these methods typically serve the same purpose of registering settings, but their existence in two separate public types suggests redundant implementation or unclear ownership of the configuration logic.
  • Inconsistent naming and intent for warmup configuration: BuildKeys defines keys for 'profilingWarmupDuration' and 'profilingWarmupCompiler', while BuildDefaults provides implementations for 'profilingWarmupCompiler', 'profilingWarmupDuration', and 'profilingWarmupCommand'. The presence of 'profilingWarmupCommand' in BuildDefaults but not in BuildKeys suggests a mismatch in what is considered a 'key' vs a 'default value'. Additionally, 'profilingWarmupCompiler' appears in both, but one is a key and the other is a task initialization, which is standard, but the naming 'WarmupCompiler' vs 'WarmupCommand' is ambiguous—are they related? The duplication of 'profilingWarmupCompiler' and 'profilingWarmupDuration' across keys and defaults is expected, but the addition of 'profilingWarmupCommand' only in defaults without a corresponding key in BuildKeys is inconsistent.
  • Outdated: com.github.alexarchambault:case-app_2.12
  • Outdated: com.lihaoyi:pprint_2.12
  • Outdated: com.thesamet.scalapb:compilerplugin_2.12
  • Outdated: io.get-coursier:interface

New (1)

  • Dependency hygiene PARTLY measured — sbt declarations read, dependency currency not (Maven Central unreachable)

Changes since last survey

  • 2 commits — 2 feature/other, 0 fixes

By area

  • (repo) — 1 commit
  • project/build.properties — 1 commit

Notable commits

  • change: Merge pull request #278 from scala-steward/update/sbt-1.13.1
  • change: Update sbt, scripted-plugin to 1.13.1

Architecture

  • Unchanged — 0 containers · 2 contexts · 1 edges

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

Survey your own repository

scalacenter/scalac-profiling 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 7 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 133d35bbba5f364a3bfb7f746ce41693ae58306a — 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-110e4fee044f.