Skip to content
CAI
Software that uses CAICheck a score

mtrudel/thousand_island

69.5

Adequate · 13 November 2026

3.1k

lines of production code

Elixir

primary language

8

measurements over time

CAI band scale
CAI trend line
CAI lens gauges

What this system is

Thousand Island is a pure Elixir socket server library designed as a modern alternative to Ranch, providing a robust architecture for managing TCP and SSL connections. It features a configurable supervision tree, a Handler behavior for application-level logic, and comprehensive telemetry for monitoring server and connection events. The system supports advanced transport options, including TLS with SNI and efficient file transfers, while ensuring stability through graceful error handling and process labeling.

Features

Add SSL transport and expand TCP transport capabilities

Users can now serve HTTPS traffic via a new SSL transport implementation that supports TLS configuration options including keyfile, certfile, sni\_hosts, and sni\_fun, with a custom chunked sendfile implementation for large file transfers. The existing TCP transport has been significantly expanded to include handshake and upgrade stubs, support for inet\_backend configuration, and new methods for retrieving connection statistics, negotiated protocols, and detailed connection information, while also ensuring file descriptors are properly closed during sendfile operations.

_lib/thousand\island/transports · high confidence

Added sample handler implementations for common protocols

The examples directory now includes four new sample handler implementations: Daytime, Echo, HTTPHelloWorld, and Messenger. These files demonstrate how to implement the ThousandIsland.Handler behavior for basic TCP protocols, including handling connections, echoing data, serving simple HTTP responses, and managing bidirectional messaging via GenServer casts.

examples · high confidence

Initial release of Thousand Island socket server

Introduces Thousand Island, a pure Elixir socket server library designed as a modern alternative to Ranch. The module provides a supervision tree for managing server processes, a \Handler\ behaviour for application-level connection logic, and comprehensive configuration options including timeouts, connection limits, and transport settings. It also includes built-in telemetry support for monitoring server, acceptor, and connection events.

lib · high confidence

Project initialization and documentation overhaul

The repository has been initialized with core project files including a CHANGELOG, LICENSE, SECURITY policy, and Code of Conduct. The README has been significantly expanded to provide comprehensive usage instructions, architecture diagrams (rewritten in MermaidJS), and detailed explanations of the supervision tree, handler behavior, and telemetry events. Additionally, developer tooling configurations for Credo, Dialyzer, and ack have been added to support code quality and static analysis.

(repo-wide) · high confidence

Behavioural changes

3 commits (0 fixes) modifying assets

A change to existing behaviour in assets — 3 commits, 5 files.

assets · medium confidence · unverified

Thousand Island server architecture and API overhaul

The server's internal architecture has been restructured to improve stability and observability. The acceptor loop now runs in transient tasks that gracefully handle transient network errors (such as \:emfile\, \:econnaborted\, and \:einval\) by backing off or retrying instead of crashing the server. A new \AcceptorPoolSupervisor\ manages multiple acceptor supervisors, and connection handling has been moved to a dedicated \Connection\ module that manages socket ownership transfer and handler lifecycle. The public API has been updated to use \ThousandIsland.Socket\ for all connection interactions, replacing the previous raw socket approach. Additionally, the library now supports \Process.set\_label/1\ for better process identification on Elixir 1.17+ and exposes comprehensive telemetry events for listeners, acceptors, and connections via the \ThousandIsland.Logger\ and \ThousandIsland.Telemetry\ modules.

_lib/thousand\island · high confidence

Test coverage

Added test support infrastructure for TLS and telemetry verification; Expanded test coverage for server lifecycle and error handling.

Dependencies

Thousand Island 1.5.0 release with Elixir 1.13+ requirement and dev tooling updates

This release bumps the project version to 1.5.0 and raises the minimum supported Elixir version to 1.13. It adds telemetry as a runtime dependency (accepting \~\> 0.4 or \~\> 1.0) and includes the :ssl application in the OTP application list. Development tooling is updated with new versions of ex\_doc (0.40.3), credo (1.7.19), dialyxir (1.4.7), and machete (0.3.12), alongside configuration for Dialyzer and HexDocs packaging.

(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 71 → 69 (-1.2)
  • Rubric changed (rubric-2026.10.5 → rubric-2026.11.3) — scores are not directly comparable.

Lenses

  • Code Health 100 → 100 (+0.0)
  • Architecture 99 → 98 (-0.9)
  • Maturity 65 → 65 (+0.0)
  • Readiness 63 → 63 (-0.1)
  • Security 82 → 74 (-7.4)

New (5)

  • Edited copy of a member (11 corresponding lines) (lib/thousand_island/transports/tcp.ex)
  • Edited copy of a member (5 corresponding lines) (lib/thousand_island/acceptor_supervisor.ex)
  • Edited copy of a member (6 corresponding lines) (lib/thousand_island.ex)
  • Edited copy of a member (7 corresponding lines) (lib/thousand_island/handler_config.ex)
  • Outdated: machete

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

Survey your own repository

mtrudel/thousand_island 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 13 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 3528889b688742ee533c7bdfe355405874481b72 — the exact code this score is about.
  • Scored under rubric-2026.11.3 — 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.57+preprod-8ebfb01cf4c0.