Skip to content
CAI
Software that uses CAICheck a score

scalacenter/scaladex

38.7

Weak · 7 November 2026

12.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

Features

Add Swagger UI initialization for API documentation

The server now includes a JavaScript initializer that configures and renders the Swagger UI interface. This enables users to interact with the API documentation directly via the browser, supporting both the v1 API endpoint (/api/v1/open-api.json) and the legacy v0 endpoint (/api/open-api.json).

modules/server/src/main/resources/lib · high confidence

Add logging configuration and subindex data for the data module

The data module now includes a logback.xml configuration that sets up console logging with specific log levels for Akka, Elasticsearch, and Flyway, while silencing noisy REST client logs. Additionally, a reference.conf file sets the default environment to 'local', and a new subindex.txt file provides a curated list of Scala libraries and tools to be indexed.

modules/data/src/main/resources · high confidence

Admin service and background job infrastructure for discovery, indexing, and maintenance

The server now exposes a comprehensive AdminService that orchestrates background jobs and on-demand administrative tasks. Users can trigger discovery of new Maven Central namespaces, update GitHub project metadata, find and index missing artifacts, and rewind the discovery cursor for backfilling. The system automatically maintains the latest version of each artifact, synchronizes project data with the search engine, and updates project dependencies. Additionally, a new ScaladocService fetches and caches javadoc jars from Maven Central with bounded disk usage and zip-bomb protection, while the ArtifactConverter handles complex artifact metadata including Scala version detection and non-standard library classification.

modules/server/src/main/scala/scaladex/server/service · high confidence

Automated code formatting via pre-commit hook

A new pre-commit hook has been added to the repository to automatically check code formatting before changes are committed. The hook invokes the scalafmt tool to verify that the codebase adheres to the project's style guidelines, ensuring consistent formatting across contributions.

bin · high confidence

Initial project scaffolding and configuration

The repository is initialized with essential configuration files including \.scalafmt.conf\ (version 3.11.5, Scala 3 dialect), \.scalafix.conf\ (ExplicitResultTypes, OrganizeImports, RemoveUnused), and \.git-blame-ignore-revs\. It introduces submodules for \small-index\ and \contrib\, sets JVM options (\-Xmx2G\, \-Xss2M\), and updates \.gitignore\ to exclude build artifacts and local data directories.

(repo-wide) · high confidence

Introduce REST API v1 with search, dependencies, and project settings

The Scaladex server now exposes a new v1 REST API alongside the existing v0 endpoints. This new API adds capabilities to search projects, retrieve project dependencies and dependents, and manage project settings (including authenticated updates). It also introduces dedicated endpoints for fetching the latest project version and latest artifact. The v1 API is fully documented via OpenAPI specs served at /api/v1/open-api.json, and the implementation includes a new authentication flow for user state resolution and project editing permissions.

modules/server/src/main/scala/scaladex/server/route/api · high confidence

Introduce REST API v1 with search, project, and artifact endpoints

The Scaladex API now includes a new v1 version that provides dedicated endpoints for searching projects, retrieving project details and settings, listing versions and artifacts, and performing autocompletion. This release adds specific request/response models (such as ProjectResponse, ArtifactResponse, and SearchResult) and query parameters for filtering by language, platform, and binary version, while the previous API version is effectively deprecated in this module.

modules/core/shared/src/main/scala/scaladex/core/api · high confidence

Introduces configurable OAuth2 and server settings

The server configuration now includes dedicated support for OAuth2 authentication and explicit server tuning. A new OAuth2Config class allows users to define client credentials and redirect URIs via the application configuration file. Additionally, the ServerConfig has been updated to expose a request timeout setting, enabling users to control how long the server waits for requests to complete.

modules/server/src/main/scala/scaladex/server/config · high confidence

New GitHub data models and decoders for repository metadata and activity

This change introduces the \GithubModel\ module, defining case classes and Circe decoders for parsing GitHub API responses. It adds support for decoding repository details (including license SPDX IDs), contributor lists, community profiles, and commit activity statistics. These models enable the infrastructure layer to correctly ingest and structure GitHub data for downstream processing.

modules/infra/src/main/scala/scaladex/infra/github · high confidence

New SCM URL parser for GitHub repositories

A new \ScmInfoParser\ component has been added to the data cleanup module to parse GitHub SCM URLs. It uses fastparse to extract repository references from various SCM URL formats (including git@, https, git://, and ssh), normalizing them by stripping the .git suffix, and returning a structured Project.Reference for downstream use.

modules/data/src/main/scala/scaladex/data/cleanup · high confidence

New core data models for artifacts, projects, and metadata

The repository introduces a comprehensive set of new case classes in the core model package to represent the domain data used by the application. This includes \Artifact\ (with fields for \scaladocUrl\, \versionScheme\, \developers\, and \fullScalaVersion\), \Project\, \Category\, \MetaCategory\, \Platform\ (supporting JVM, Scala.js, Scala Native, SbtPlugin, and MillPlugin), \License\, \GithubInfo\, and various supporting types like \Contributor\, \DocumentationPattern\, and \Env\. These models form the foundation for the new artifact pages, search API, and project settings features.

repository · high confidence

New data indexing and load-test feeder generation capabilities

The data module now includes a new entry point (Main) that supports 'init', 'subIndex', and 'generateFeeders' steps. The 'init' step populates the database using Flyway migrations and local storage. The 'subIndex' step allows filtering and saving a subset of projects defined in 'subindex.txt' to the filesystem. The 'generateFeeders' step creates CSV files (orgs\_repos.csv, artifacts.csv, search\_terms.csv) from the local index, which are consumed by the Gatling load-test harness. Configuration is now centralized in IndexConfig, loading database, filesystem, and cache settings. A PidLock utility ensures only one instance runs in dev/prod environments.

modules/data/src/main/scala/scaladex/data · high confidence

New utility modules for parsing, HTTP, and Scala extensions

This change introduces several new utility components in the core shared module: JsoupUtils for extracting directory listings and Maven metadata versions from HTML/XML; Parsers providing fastparse-based combinators for alpha, digit, and number parsing; ScalaExtensions adding extension methods for Future, Try, Option, Iterable, Iterator, and FiniteDuration (including pretty/short printing); Secret for safe handling of sensitive strings; and TimeUtils for measuring task duration and calculating percentages.

modules/core/shared/src/main/scala/scaladex/core/util · high confidence

New view layer and admin interface for Scaladex

This change introduces the core view templates and supporting Scala code for the Scaladex website. It adds the main layout, front page, search results, and the new 'Awesome Scala' curated list pages. It also implements the 'Insights' page for Scala version adoption statistics and a new 'Admin' interface for managing background jobs and tasks. Supporting utilities include pluralization helpers, URI builders, and model definitions for ecosystem highlights and install instructions.

modules/template · high confidence

Redesigned web interface with new navigation and admin tools

The server routes have been restructured to introduce several new user-facing pages and capabilities. Users can now browse curated projects on the 'Awesome' pages, view Scala version adoption statistics on the Insights page (restricted to logged-in users), and access a new Admin interface to manage jobs and run maintenance tasks like finding missing artifacts or rewinding the discovery cursor. The project and artifact pages have been reorganized, including a new paginated Dependents tab and a version matrix view. Additionally, Scaladoc pages are now hosted behind a Scaladex-branded shell with an iframe, and the authentication flow has been updated to use GitHub OAuth with session management.

modules/server/src/main/scala/scaladex/server/route · high confidence

Removals

Removal of autowire-based demo scaffolding

The autowire-based client-server scaffolding has been removed from the web application. The JavaScript client entry point (Client.scala) and the JVM server implementation (Server.scala), which previously handled the 'hello' API endpoint and served the basic HTML interface, are no longer present in the codebase.

webapp/js, webapp/jvm · high confidence

Removal of unused Api trait

The \Api\ trait, which previously defined a \hello\ method, has been removed from the shared webapp module. This cleanup eliminates an unused interface definition from the codebase.

webapp/shared · high confidence

Architecture

Introduce new service-layer abstractions for project, search, and external data access

The core service layer now exposes a set of new traits that define how the application interacts with projects, search, and external sources. ProjectService provides methods to retrieve project details, versions, dependencies, and settings, while SearchEngine handles indexing, querying, and filtering of projects. External data access is abstracted through GithubAuth and GithubClient for GitHub integration, MavenCentralClient and MavenCentralIndexClient for Maven Central artifact and index retrieval, and PomResolver for POM file resolution. Additionally, WebDatabase and SchedulerDatabase define the data access contracts for persistent storage and background scheduling tasks.

modules/core/shared/src/main/scala/scaladex/core/service · high confidence

Behavioural changes

2 commits (0 fixes) modifying doc/assets

A change to existing behaviour in doc/assets — 2 commits, 3 files: “Fixed the typo of the link”; “Add GSoC lightning talk PPT/PDF and update README with final report link”.

doc/assets · medium confidence · unverified

The webclient now fixes relative links and images in server-rendered READMEs by rewriting them to point to GitHub's raw and blob URLs, avoiding client-side re-fetches that could hit rate limits. It also introduces an ActiveNavObserver that uses IntersectionObserver to highlight the current section in the navigation bar as the user scrolls, and adds a Sparkline chart to display commit activity on project pages.

modules/webclient · high confidence

Configurable infrastructure defaults and production logging

The application now ships with explicit configuration defaults for Elasticsearch, database connection pools, HTTP clients (GitHub, Maven Central), and caching, allowing users to tune timeouts, pool sizes, and rate limits via environment variables or overrides. Additionally, a new \logback-prod.xml\ file provides structured production logging, including separate rolling file appenders for general logs and HTTP access logs with size caps.

modules/infra/src/main/resources · high confidence

Database migrations to correct platform, language, and artifact metadata

This update introduces a series of Flyway database migrations that clean up and correct artifact metadata in the artifacts table. The changes include splitting the binary\_version column into distinct platform and language\_version fields (V7\_2), fixing incorrect platform and language assignments for Java artifacts (V9), updating new fields like is\_semantic and is\_prerelease (V13\_2), handling Mill plugin platform data (V17), and correcting SBT platform and artifact naming issues (V25, V26). These migrations ensure that artifact records accurately reflect their build tool platform (e.g., sbt, Mill) and language version, improving data consistency for downstream queries and displays.

modules/infra/src/main/scala/scaladex/infra/migrations · high confidence

Database schema evolution and data cleanup

The underlying database schema has been updated to support new features and improve data integrity. Key changes include adding columns for semantic versioning and pre-release status to artifacts, introducing tables for project dependencies and user sessions, and storing license and commit activity information. The schema also now tracks full Scala versions, latest version flags, and discovered group IDs, while removing obsolete tables and fields. Additionally, several data cleanup migrations were applied to correct platform naming conventions, remove Scala 3 pre-release artifacts, and fix category spelling errors.

modules/infra/src/main/resources/migrations · high confidence

Developer documentation updates and restructuring

The developer documentation has been updated with new guides for using the GitHub API (including authentication and README retrieval) and examples of Maven POM files for testing. Additionally, existing documentation files for Bintray and StackOverflow have been moved into the dev directory to better organize development resources.

doc/dev · high confidence

Introduce configurable infrastructure settings for caching, HTTP clients, and databases

This change adds a new set of configuration classes in the infrastructure module that allow users to tune system behavior via external configuration files. Users can now explicitly set cache parameters (refresh/expire durations, max size), Elasticsearch connection pool and timeout settings, PostgreSQL database pool size and statement timeouts, and HTTP client behaviors including throttling, retry policies, and circuit breakers. Additionally, filesystem paths for temporary, index, contribution, and scaladoc storage, as well as Scaladoc disk usage limits, are now configurable.

modules/infra/src/main/scala/scaladex/infra/config · high confidence

Major build infrastructure overhaul: Sbt 1.12, Scala.js 1.22, and integrated test containers

The project's build system has been significantly upgraded and restructured. The SBT version has been bumped from 0.13.11 to 1.12.15, and the Scala.js plugin has been upgraded from 0.6.8 to 1.22.0, enabling modern cross-compilation features. New SBT plugins have been added, including sbt-twirl (2.0.9) for template rendering, sbt-sassify (1.5.2) for CSS processing, sbt-native-packager (1.11.7) for packaging, and gatling-sbt (4.19.1) for load testing. The build now integrates Testcontainers for local development and testing, with new SBT tasks (\startElasticsearch\, \startPostgres\) that automatically manage Docker containers for Elasticsearch (8.19.15) and PostgreSQL (16.15), caching them across reloads. Deployment logic has been consolidated into new \Deployment.scala\ and \Docker.scala\ modules, supporting both direct and jump-host deployments to production and development servers. The legacy \Helper.scala\ has been removed and replaced by \ScalaJSHelper.scala\ and \CurrentThread.scala\ to handle Scala.js packaging and classloader context management for Testcontainers.

project · high confidence

Migrate HTTP client infrastructure to Apache Pekko

The infrastructure layer has been migrated from Akka to Apache Pekko, replacing Akka HTTP and Akka Streams with their Pekko equivalents for all external HTTP communication. This change introduces a new \CommonAkkaHttpClient\ (now backed by Pekko) that provides a unified, configurable HTTP client with support for connection pooling, throttling, and circuit breaking. This client is now used by the \GithubClientImpl\ and \MavenCentralClientImpl\ to fetch repository metadata, commit activity, and artifact information, ensuring consistent error handling and retry policies across the application.

modules/infra/src/main/scala/scaladex/infra · high confidence

Migrate server runtime from Akka to Pekko

The server implementation has been migrated from Akka HTTP to Apache Pekko, updating the underlying actor system and HTTP server infrastructure. This change introduces new server components including a dedicated HTTP access logger for debug-level request tracing, a refactored GitHub OAuth authentication implementation, and updated Twirl template marshalling support, all running on the Pekko platform.

modules/server/src/main/scala/scaladex/server · high confidence

New Elasticsearch mapping and document model for project data

The Elasticsearch infrastructure now defines a dedicated mapping for project fields, including specific analyzers for README text and support for tracking the Scala percentage of a project. A new \RawProjectDocument\ model has been introduced to handle the serialization and validation of project data before indexing, ensuring that fields like languages, platforms, and artifact names are correctly processed.

modules/infra/src/main/scala/scaladex/infra/elasticsearch · high confidence

New SQL persistence layer for artifacts, projects, and dependencies

The infrastructure module now uses a new set of Doobie-based SQL tables to store and query core data. Artifact details (including release dates, licenses, and Scala version info) are persisted in the \artifacts\ table, while dependency relationships are tracked in separate \artifact\_dependencies\ and \project\_dependencies\ tables to support efficient reverse-dependency lookups. Project metadata, GitHub status, and user-configurable settings are stored in \projects\, \github\_info\, and \project\_settings\ tables respectively. Additionally, the system now supports user session management via a \user\_sessions\ table and tracks discovered Maven namespaces in \discovered\_group\_id\ to enable background synchronization.

modules/infra/src/main/scala/scaladex/infra/sql · high confidence

New URL parameter models for artifact pages

Added ArtifactPageParams and ArtifactsPageParams to manage URL query parameters for artifact views. ArtifactPageParams handles an optional binary version filter, while ArtifactsPageParams manages a sequence of binary versions and a stable-only flag, providing a summary string for the selected versions.

modules/core/shared/src/main/scala/scaladex/core/web · high confidence

New database initialization process for project ingestion

The system now uses a dedicated \Init\ component to handle database setup and data population. This process first resets the database schema using Flyway (cleaning and migrating tables) before importing all projects, artifacts, and dependencies from local storage. Upon completion, it logs the total counts of inserted projects, settings, artifacts, and dependencies to verify the operation.

modules/data/src/main/scala/scaladex/data/init · high confidence

New search sorting options and parameter models

The search functionality now supports multiple sorting criteria, including Stars, Commit Activity, Contributors, Dependent, and Created, with Commit Activity added as a new option alongside the existing ones. New model classes (SearchParams, AwesomeParams, Sorting) define the structure for search queries and sorting, replacing previous implementations. This allows users to sort search results by various metrics, with Commit Activity being a newly introduced sorting method.

modules/core/shared/src/main/scala/scaladex/core/model/search · high confidence

New server configuration and stricter bot blocking

The server now ships with explicit configuration files for logging, server settings, and access control. A new logback.xml configures console logging and silences noisy Elasticsearch client warnings, while a commented-out logger allows opt-in for detailed HTTP request tracing. A new reference.conf defines default server endpoints, timeouts, and OAuth2 credentials, alongside Pekko HTTP settings. Additionally, a comprehensive robots.txt file has been added to block major AI crawlers (such as GPTBot, ClaudeBot, and CCBot) and restrict search engine indexing of internal API, admin, and artifact version endpoints.

modules/server/src/main/resources · high confidence

POM conversion now extracts API URL and version scheme from properties

The Maven POM conversion logic in \PomConvert\ has been updated to read the \info.apiURL\ and \info.versionScheme\ properties from the POM model and include them in the resulting \ArtifactModel\. This allows the system to capture and store these specific metadata fields directly from the Maven artifact definition.

modules/data/src/main/scala/scaladex/data/maven · high confidence

Refactor project model and introduce new core data structures

The core model layer has been restructured with the introduction of several new data types and logic. A new \ProjectHeader\ object now encapsulates the logic for resolving default artifacts, aggregating supported languages and platforms, and generating version URLs, replacing previous ad-hoc resolution methods. New case classes \BinaryVersion\ and \ProjectDependency\ have been added to model binary compatibility suffixes and inter-project dependencies respectively, including parsing logic for \BinaryVersion\ via fastparse. Additionally, utility traits and objects such as \AvatarUrl\ for generating sized avatar URLs and \Sha1\ for hashing have been introduced to support these model components.

modules/core/shared/src/main/scala/scaladex/core/model · high confidence

Replaced Bootstrap 3 UI components with custom vanilla CSS

The site's visual layer has been refactored to remove the dependency on Bootstrap 3's JavaScript and CSS framework. The \modules/server/src/main/assets/css\ directory now contains a complete set of custom, vanilla CSS replacements for core UI elements, including the grid system, buttons, forms, navigation tabs, dropdowns, tooltips, and toggle switches. This change ensures the interface renders consistently using only the site's own stylesheets, eliminating the need for external Bootstrap assets while preserving the existing look and feel.

modules/server/src/main/assets · high confidence

Test coverage

Add infrastructure test suite and configuration; Added Gatling load-test harness for performance testing; Added in-memory test infrastructure for core services; Added integration tests for GitHub client and search relevance; Added route tests for assets, badges, and project pages; Added test coverage for API routes and publishing endpoints; Added test for server configuration loading; Added tests for DiscoveryService logic; Added tests for IndexConfig loading; Added tests for POM reading with distributionManagement handling; Added tests for PageParams validation; Added tests for SCM URL parsing; Added tests for core model components.

Dependencies

Major dependency upgrades and Scala 3 migration

The build system has been upgraded to Scala 3.9.0, replacing the previous Scala 2.11 configuration. This change brings significant updates to core libraries, including migrating from Akka to Pekko (e.g., pekko-http, pekko-stream), upgrading the JSON library from json4s to Circe, and updating the HTTP client from Play-WS to endpoints4s fetch-client. Additionally, the logging implementation was updated to logback-classic 1.6.3, and the database migration tool was upgraded to Flyway 12.11.0. The project structure was also reorganized into multiple modules (core, server, webclient, infra, etc.) to support this modernization.

(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 42 → 39 (-2.9)
  • Rubric changed (rubric-2026.10.5 → rubric-2026.11.2) — scores are not directly comparable.

Lenses

  • Code Health 51 → 51 (+0.0)
  • Architecture 79 → 78 (-0.8)
  • Maturity 52 → 62 (+9.8)
  • Readiness 70 → 64 (-5.8)
  • Security 38 → 29 (-9.7)
  • Accessibility 34 → 34 (+0.0)
  • Performance 66 → 70 (+4.0)

Resolved (12)

  • High CVE: [GHSA redacted] (build.sbt)
  • Off-boarding risk: anonymized user #1
  • Off-boarding risk: anonymized user #2
  • Outdated: ch.qos.logback:logback-classic
  • Outdated: com.github.pjfanning:pekko-http-circe_3
  • Outdated: org.endpoints4s:pekko-http-server_3
  • Outdated: org.flywaydb:flyway-core
  • Outdated: org.flywaydb:flyway-database-postgresql
  • Outdated: org.jsoup:jsoup
  • Outdated: org.slf4j:jcl-over-slf4j
  • Outdated: org.webjars:chartjs
  • Outdated: org.webjars:swagger-ui

New (3)

  • Dependency hygiene PARTLY measured — sbt declarations read, dependency currency not (Maven Central unreachable)
  • Off-boarding risk: anonymized user #1
  • Off-boarding risk: anonymized user #2

Changes since last survey

  • 50 commits — 50 feature/other, 0 fixes

By area

  • (repo) — 27 commits
  • (root) — 17 commits
  • project/plugins.sbt — 3 commits
  • .github/workflows — 1 commit
  • project/build.properties — 1 commit
  • scripts/PublishMissingArtifacts.scala — 1 commit

Notable commits

  • change: Bump coursier/cache-action from 8 to 9
  • change: Merge branch 'main' into update/maven-model-builder-4.0.0-rc-7
  • change: Merge branch 'main' into update/pekko-actor-typed-1.7.1
  • change: Merge branch 'main' into update/sbt-scalafix-0.14.9
  • change: Merge branch 'main' into update/scala-java-time-2.9.0
  • change: Merge pull request #1836 from scala-steward/update/sbt-scalafix-0.14.9
  • change: Merge pull request #1837 from scala-steward/update/logback-classic-1.6.6
  • change: Merge pull request #1838 from scala-steward/update/nscala-time-3.2.0
  • change: Merge pull request #1839 from scala-steward/update/pekko-http-circe-3.12.0
  • change: Merge pull request #1840 from scala-steward/update/sbt-native-packager-1.13.0
  • change: Merge pull request #1841 from scala-steward/update/circe-core-0.14.17
  • change: Merge pull request #1842 from scala-steward/update/gatling-sbt-4.19.2
  • change: Merge pull request #1843 from scala-steward/update/gatling-test-framework-3.16.0
  • change: Merge pull request #1844 from scala-steward/update/gatling-charts-highcharts-3.16.0
  • change: Merge pull request #1846 from scala-steward/update/scala-java-time-2.9.0
  • change: Merge pull request #1847 from scala-steward/update/maven-model-builder-4.0.0-rc-7
  • change: Merge pull request #1848 from scala-steward/update/pekko-actor-typed-1.7.1
  • change: Merge pull request #1849 from scala-steward/update/pekko-http-1.4.2
  • change: Merge pull request #1850 from scala-steward/update/algebra-1.14.0
  • change: Merge pull request #1851 from scala-steward/update/fetch-client-4.2.0
  • …and 30 more

Architecture

  • Unchanged — 0 containers · 1 contexts · 0 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/scaladex 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 2e6e420bef92b73f4aaa39d83e78758632144592 — 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-5f8314471808.