Skip to content
CAI
Software that uses CAICheck a score

brotandgames/ciao

50.0

Adequate · 6 November 2026

1.8k

lines of production code

Ruby

primary language

4

measurements over time

CAI band scale
CAI trend line
CAI lens gauges

What this system is

Features

Add CheckMailer for health status and TLS certificate notifications

Users will now receive email notifications for two specific events: when a health check's status changes (e.g., from 200 to 500) and when a TLS certificate is approaching expiration. A new \CheckMailer\ class has been introduced with \change\_status\_mail\ and \tls\_expires\_mail\ actions to handle these alerts, while the base \ApplicationMailer\ has been updated to use a consistent layout string.

app/mailers · high confidence

Checks interface overhaul with TLS monitoring and admin tools

The checks views have been redesigned to provide a richer user experience and new operational capabilities. The index and show pages now display TLS certificate expiration details (days until expiry) for HTTPS checks, alongside last/next contact times and a history of status changes. A new Administration page allows users to recreate scheduled background jobs and trigger immediate TLS checks, while also exposing debugging information like configuration and database pool stats. The dashboard now offers a high-level overview of check health and status code distribution. Additionally, JSON representation links have been added to the index and show views, and the UI has been modernized with improved layout, icons, and confirmation dialogs for deletions.

app/views/checks · high confidence

Introduces configurable webhook and email notification channels for TLS certificate expiration

This change adds the underlying infrastructure to send notifications when TLS/SSL certificates are nearing expiration. It introduces a new notification framework in \app/lib/ciao/notifications\ with base classes and specific implementations for sending emails via \CheckMailer\ (including a dedicated \tls\_expires\_mail\) and posting JSON payloads to configurable webhook endpoints. The system uses environment variables prefixed with \CIAO\_WEBHOOK\ENDPOINT\\ and \CIAO\_WEBHOOK\PAYLOAD\\ to define multiple webhook targets and their custom JSON templates, which are rendered using placeholders like \\_\_tls\_expires\at\\\ and \\\_tls\_expires\_in\days\\_\ via the new \ReplaceRenderer\.

app/lib · high confidence

New email notifications for status changes and TLS certificate expiration

Users will now receive email notifications for two specific events: when a monitored item's status changes (showing the previous and new status) and when a TLS/SSL certificate is approaching expiration (showing the expiry date and remaining days). These new mailer templates provide direct links to the relevant resources.

_app/views/check\mailer · high confidence

Track status changes and calculate uptime history

The system now records every status change for a health check in a dedicated \StatusChange\ model, enabling the calculation of historical uptime percentages over 24-hour, 7-day, and 30-day periods. When a check's status changes, the application automatically logs the event and triggers notifications, while also exposing daily uptime data and absolute URLs for each check in the UI.

ruby · high confidence

Behavioural changes

Application startup, monitoring, and error handling improvements

The application now automatically schedules background jobs for active checks upon startup, ensuring monitoring tasks are ready immediately after launch. A new Prometheus metrics endpoint is available to expose check counts and status breakdowns, while TLS certificate expiration notifications can be configured via environment variables. Error handling is strengthened by catching SSLError in HTTP requests and logging detailed scheduler errors, and the asset pipeline has been modernized by removing legacy configuration files.

config/initializers · high confidence

Ciao Helm chart v2.1.1 release with security and validation improvements

The Ciao Helm chart has been updated to version 2.1.1, upgrading the underlying application to version 1.11.1 to fix a security issue where admin actions were previously triggered by GET requests (hovering over buttons) instead of requiring POST requests. This release also introduces a \values.schema.json\ to validate configuration inputs, ensuring that unknown keys or incorrect types fail installation rather than being silently ignored. Additionally, the chart enforces a single-pod deployment strategy with \Recreate\ rollout, disables service account token mounting and service links for improved security, and generates a persistent \SECRET\_KEY\_BASE\ to maintain CSRF token validity across upgrades.

helm-chart · high confidence

Database schema updates for TLS monitoring and status history

The database schema has been updated to support TLS certificate monitoring and status change tracking. New columns have been added to the \checks\ table: \last\_contact\_at\ and \next\_contact\_at\ for scheduling visibility, and \tls\_expires\_at\, \tls\_expires\_in\_days\, and \tls\_job\ to track certificate expiration details and associated jobs. Additionally, a new \status\_changes\ table has been created to record the history of status updates for each check, including a foreign key link back to the \checks\ table.

db · high confidence

Enforce frozen string literals in core channel and job classes

The ApplicationCable::Channel, ApplicationCable::Connection, and ApplicationJob classes now include the \\# frozen\_string\_literal: true\ directive. This change optimizes string handling by preventing unnecessary string duplication, which can improve memory usage and performance for WebSocket connections and background jobs.

app/channels, app/jobs · high confidence

Enhanced status and health check visual indicators

The application now provides more granular visual feedback for check statuses and health metrics. The status display has been upgraded from a simple green/red binary to a five-tier color scheme (secondary, success, info, warning, danger) that maps to specific HTTP status code ranges. Additionally, new helper methods introduce visual indicators for TLS certificate expiration (using danger, warning, or neutral colors based on days remaining), active health check flags (displaying check or minus icons), and overall health percentages (green for 100%, red otherwise).

app/helpers · high confidence

Flash messages now auto-dismiss as toasts

Flash messages are now displayed as auto-dismissing toasts in the upper-right corner of the screen, disappearing after 4 seconds. This change also modernizes the JavaScript asset pipeline by removing the legacy Webpacker setup (including Action Cable consumer and Turbolinks integration) in favor of a simpler Turbo-based entry point.

app/javascript · high confidence

HTTP Basic Authentication and JSON API behavior updates

The application now supports optional HTTP Basic authentication, configurable via the BASIC\_AUTH\_USERNAME and BASIC\_AUTH\_PASSWORD environment variables, using secure string comparison to prevent timing attacks. For JSON API consumers, the controller no longer suppresses forgery protection, and error responses for failed create/update operations now explicitly return a 422 Unprocessable Entity status code. Additionally, new administrative endpoints have been added to view job details, recreate scheduled jobs, and perform on-demand TLS checks.

app/controllers · high confidence

Improved cron and HTTP URL validation with modernized Ruby APIs

The cron and HTTP URL validators have been updated to use more robust and modern Ruby standard library methods. The HTTP URL validator now uses \URI::DEFAULT\_PARSER.escape\ instead of the deprecated \URI.escape\, ensuring reliable URL encoding. The cron validator has been refactored to provide clearer error messaging by directing users to https://crontab.guru for help, and it now logs exceptions to the Rails logger for better debugging, while also adhering to Ruby style guidelines with frozen string literals.

app/validators · high confidence

Modernize Rails configuration and add SMTP mailer support

The application environment configurations have been updated to align with Rails 8.1 conventions, replacing deprecated settings like \cache\_classes\ with \enable\_reloading\ and removing obsolete asset pipeline options. In development, the mailer now uses \letter\_opener\ to display emails in the browser instead of sending them. Production now supports configurable SMTP delivery via environment variables (including SSL/TLS options), and the test environment sets explicit default mailer options and disables exception rendering.

config/environments · high confidence

Modernize development environment by removing Webpacker and Spring

The development workflow has been updated to remove the legacy Webpacker asset pipeline and the Spring application preloader. The \bin/webpack\, \bin/webpack-dev-server\, and \bin/spring\ scripts have been deleted, and \bin/dev\ now uses \foreman\ to manage processes via a \Procfile.dev\. Standard Rails binstubs (\bin/rails\, \bin/rake\) have been updated to use modern Ruby path resolution (\\_\dir\\_\) and include \frozen\_string\_literal\ comments, while \bin/bundle\ has been reformatted for style compliance.

bin · high confidence

Rails 8.1 upgrade, asset pipeline modernization, and new application features

The application has been upgraded to Rails 8.1, which includes a modernized asset pipeline that replaces Webpacker with jsbundling-rails and importmap. This change is accompanied by a shift in secret management from encrypted credentials to environment-variable-backed YAML secrets for better Docker compatibility. New user-facing capabilities include an Administration page, a minimal Dashboard, and on-demand TLS checks, accessible via new routes for jobs, job recreation, and admin actions. Configuration updates also include moving SQLite databases to a subfolder for Docker volume support, disabling Active Storage variants, setting a configurable default time zone, and increasing the default database connection pool size.

config · high confidence

Redesigned navigation, toast notifications, and modernized asset pipeline

The application layout has been updated to use the Tabler CSS framework, replacing the previous styling with styled buttons for navigation links (Checks, New Check, Admin) and adding a footer that displays the application version. Flash messages are now rendered as auto-dismissing toast notifications in the top-right corner instead of plain text. Additionally, the asset pipeline has been modernized by switching from Webpacker to importmap for JavaScript and using a specific Tabler stylesheet, while also enabling Turbo tracking for assets.

app/views/layouts · high confidence

Updated UI styling to match Tabler 1.4.0 and Bootstrap 5

The application's visual appearance has been updated to align with the new Tabler 1.4.0 design system and Bootstrap 5 components. This change introduces tighter table rows, adjusted icon sizing, and compact count badges to restore previous styling nuances. It also fixes form layout gaps, ensures badges display white text correctly, and restores proper spacing between sibling cards, ensuring the interface looks consistent with the latest framework updates.

app/assets · high confidence

Updated application version to 1.10.1

The public version file has been updated to reflect the current release version 1.10.1, ensuring that any client-side version checks or footer displays accurately report the latest deployed build.

public · high confidence

Upgrade to Ruby 4.0.6 and Rails 8.1 with modernized asset pipeline

The application runtime has been upgraded from Ruby 2.5.5 to 4.0.6, and the framework has been upgraded to Rails 8.1. This change replaces the legacy Webpacker/Babel/PostCSS asset pipeline with the modern \jsbundling-rails\ approach, removing \babel.config.js\, \postcss.config.js\, and \.browserslistrc\. The Dockerfile has been refactored to use a multi-stage build with a non-root user for improved security and smaller image size, and the startup process now uses a dedicated \start.sh\ script that handles secret key generation and database migrations. Additionally, a Prometheus metrics endpoint is now available at \/metrics\ when the \PROMETHEUS\_ENABLED\ environment variable is set to true.

(repo-wide) · high confidence

Test coverage

Expanded test coverage for checks, notifications, and mailers

Added comprehensive tests for the checks controller, model, and helpers, including validation, CRUD operations, and JSON API responses. Introduced tests for the new status change and TLS expiration mailers, along with their previews. Added unit tests for the notification system, covering mail and webhook notifications, as well as the webhook parser and replace renderer. Updated fixtures and test helpers to support these new tests, including enabling SimpleCov for coverage reporting.

test · high confidence

Dependencies

139 commits updating dependencies (4 manifests)

A dependency / build maintenance change in (dependencies) — 139 commits (2 fixs), 4 files: “Add Prometheus Metrics (endpoint /metrics) (\#24)”; “Bump rails from 6.1.4.7 to 6.1.5”; “Bump puma from 3.12.3 to 3.12.4”; and 132 more (refs \#24, \#145, \#160, \#168, \#46, …).

(dependencies) · high confidence · unverified

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

Lenses

  • Code Health 73 → 73 (+0.0)
  • Architecture 80 → 80 (+0.0)
  • Maturity 55 → 59 (+3.7)
  • Readiness 46 → 46 (-0.1)
  • Security 70 → 65 (-4.9)
  • Domain Modelling 43 → 43 (+0.0)
  • Accessibility 66 → 66 (+0.0)

Resolved (3)

  • Documentation: no contributor guidance (README.md)
  • No AppArmor/SELinux confinement (helm-chart/ciao/templates/deployment.yaml)
  • No seccomp profile (helm-chart/ciao/templates/deployment.yaml)

New (4)

  • Medium CVE: [GHSA redacted] (Gemfile.lock)
  • Outdated: bootsnap
  • Outdated: rails
  • Outdated: selenium-webdriver

Changes since last survey

  • 2 commits — 2 feature/other, 0 fixes

By area

  • helm-chart/ciao — 1 commit
  • public/version — 1 commit

Notable commits

  • change: Release 1.12.0
  • change: Release ciao Helm chart 2.2.0

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

brotandgames/ciao 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 f440e5f07fcb1e952641a5ae13e631affab621ee — 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.2+preprod-5c4e66d9318b.