Skip to content
CAI
Software that uses CAICheck a score

excid3/noticed

60.5

Adequate · 5 November 2026

1.2k

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 Appraisal configurations for Rails 7.1, 7.2, 8.0, 8.1, and main

The gemfiles directory now includes new Appraisal configurations for Rails 7.1, 7.2, 8.0, 8.1 (beta), and the Rails main branch. These files enable testing the library against these specific Rails versions, ensuring compatibility as new releases are introduced. The configurations also update the sqlite3 gem version to \~\> 2.0 for Rails 8.0+ and main, and include the trilogy gem for MySQL support.

gemfiles · high confidence

Add bulk delivery methods for Bluesky, Discord, Slack, Test, and Webhook

This change introduces a new \BulkDeliveryMethods\ namespace with five specific delivery implementations: Bluesky (posting to the AT Protocol), Discord (webhook posting), Slack (delegating to existing Slack logic), Test (in-memory tracking), and Webhook (delegating to existing webhook logic). Each class inherits from \BulkDeliveryMethod\ and registers an ActiveSupport load hook, enabling users to configure and send bulk notifications to these platforms via a unified interface.

_lib/noticed/bulk\_delivery\methods · high confidence

Added bin/rails binstub for engine development

A new bin/rails executable has been added to the project. This binstub allows developers to run Rails commands directly within the engine's test/dummy application environment, facilitating easier local development and testing of the engine's integration with a host application.

bin · high confidence

Added generator templates for custom notifiers and delivery methods

The library now includes ERB templates for generating custom Notifiers, Delivery Methods, and Bulk Delivery Methods. Users can run generators to scaffold \ApplicationNotifier\, \ApplicationDeliveryMethod\, and \ApplicationBulkDeliveryMethod\ base classes, as well as specific implementations like \DeliveryMethods::\<Name\>\ and \BulkDeliveryMethods::\<Name\>\. A README template provides setup instructions, including adding \has\_many :notifications\ associations to models and running migrations.

lib/generators/noticed/templates · high confidence

Introduce Noticed job classes for event and delivery processing

Added \Noticed::ApplicationJob\ and \Noticed::EventJob\ to handle background job execution. \EventJob\ orchestrates the delivery process by first enqueuing bulk delivery methods and then processing individual notifications in batches to prevent memory issues with large recipient lists. \ApplicationJob\ serves as the base class, configured to discard jobs that fail due to deserialization errors.

app/jobs · high confidence

Introduce ephemeral notifiers for dynamic, non-persisted notifications

Users can now send notifications without creating persistent database records by using the new \Noticed::Ephemeral\ base class. This change adds \app/models/noticed/ephemeral.rb\, which provides a lightweight notifier structure that includes \ActiveModel::Attributes\, \Noticed::Deliverable\, and \Noticed::Translation\. It allows for dynamic recipient evaluation and supports custom notification methods defined via \notification\_methods\. This enables sending notifications (e.g., via email or push) on-the-fly with custom parameters, bypassing the need for a stored \Noticed::Notification\ record in the database.

app/models/noticed · high confidence

New delivery methods for ActionCable, iOS, FCM, and more

This change introduces a suite of new delivery methods to the library, allowing notifications to be sent via ActionCable, Apple Push Notification Service (iOS), Firebase Cloud Messaging (FCM), Discord, Microsoft Teams, Twilio Messaging, Vonage SMS, and Webhooks. It also adds an ActionPushNative method for native push notifications and enhances the existing Email method with support for enqueued delivery and custom arguments. These additions expand the ways users can distribute notifications beyond the previously available channels.

_lib/noticed/delivery\methods · high confidence

New generators for Notifiers and custom delivery methods

The library now provides dedicated Rails generators to scaffold application components. The \notifier\ generator creates a new Notifier class and an optional base \ApplicationNotifier\ class, while the \delivery\_method\ generator creates custom delivery method classes, supporting both standard and bulk delivery methods via a \--bulk\ flag. An \install\ generator is also added to copy Noticed migrations into the application.

lib/generators/noticed · high confidence

New notification delivery, recipient, and read-state capabilities

This change introduces three new concerns in the notification system. The Deliverable concern adds support for defining custom delivery methods (including bulk delivery), specifying required parameters, and evaluating recipients via a dedicated block or method, while also deprecating the legacy \params\ and \param\ helpers in favor of \required\_params\ and \required\_param\. The NotificationMethods concern allows users to inject custom methods directly into the generated Notification class for each notifier. Finally, the Readable concern adds scopes and instance methods to manage notification states, enabling users to mark notifications as read/unread and seen/unseen, and to check their current status.

app/models/concerns · high confidence

Behavioural changes

Added notification counter cache for improved performance

A new database migration adds a \notifications\_count\ integer column to the \noticed\_events\ table. This counter cache allows the application to track the number of notifications associated with an event without requiring expensive database queries, thereby improving performance when displaying notification counts to users.

db · high confidence

Drops Rails 7.0 support and adds Rails 8.1 beta compatibility

The gem now requires Rails 7.1 or newer, removing support for Rails 7.0. To facilitate testing and development, the Appraisals file has been updated to include configurations for Rails 7.1, 7.2, 8.0, and 8.1 beta, alongside the main Rails branch, ensuring compatibility with the latest Ruby on Rails versions.

(repo-wide) · high confidence

Migration to Zeitwerk autoloading and introduction of deprecation warnings

The library now uses Zeitwerk for autoloading, which changes how classes are loaded and improves compatibility with modern Rails versions. As part of this structural change, the \Noticed::Base\ and \Noticed::DeliveryMethods::Base\ constants have been deprecated in favor of \Noticed::Event\ and \Noticed::DeliveryMethod\ respectively, with deprecation warnings configured for version 4.0. Additionally, a new \parent\_class\ configuration option has been added, defaulting to \Noticed::ApplicationJob\, and unused rake tasks have been removed.

lib · high confidence

Noticed gem major version bump to 3.1.0 with new delivery and serialization infrastructure

The Noticed gem has been updated to version 3.1.0, introducing a new \ApiClient\ module that standardizes POST requests for delivery methods (supporting JSON, form data, and raw body payloads) and a \Coder\ class that handles argument serialization and deserialization using \ActiveJob::Arguments\ while safely handling missing record errors. The update also adds a \SlackDelivery\ module for sending Slack notifications and a \WebhookDelivery\ module for generic webhook calls, alongside engine initializers that register the \HasNotifications\ concern and deprecator. These changes represent a significant architectural shift in how notifications are delivered and persisted compared to the previous 0.1.0 baseline.

lib/noticed · high confidence

Refactored delivery architecture with new base classes and configurable job options

The delivery system has been restructured to support more flexible job configuration and ephemeral notifications. A new \DeliverBy\ class now handles the construction and enqueuing of delivery jobs, allowing users to specify ActiveJob-compatible options like \wait\, \wait\_until\, \queue\, and \priority\ directly in their notifier configurations. The core \DeliveryMethod\ and \BulkDeliveryMethod\ classes have been refactored to support \if\/\unless\ conditional checks and callbacks (\before\_enqueue\, \deliver\) for controlling delivery behavior. Additionally, the library's base model has been moved to \app/models/noticed/application\record.rb\ with a \noticed\\ table prefix, and the \Event\ and \Notification\ models now include lazy load hooks for extensibility.

noticed · high confidence

Test coverage

Added UserMailer and updated ApplicationMailer defaults for testing; Added comprehensive test coverage for delivery methods, ephemeral notifiers, and notification associations; Added dummy notifiers for testing delivery configurations; Added test coverage for notification delivery methods; Added test dummy models and updated ApplicationRecord for compatibility; Added tests for EventJob enqueueing and before\_enqueue behavior; Added tests for notification delivery logic and read/seen state management; Added tests for the Webhook bulk delivery method; Test dummy app configuration and formatting updates; Updated Rails dummy app initializer templates; Updated dummy app environment configurations for Rails 7.1+ compatibility; Updated test dummy app configuration and layout templates; Updated test dummy app configuration for modern Rails compatibility; Updated test dummy database schema for Rails 7.1 compatibility.

Dependencies

Updated dependencies and raised minimum Rails version to 7.1

The gem now requires Rails 7.1.0 or higher, dropping support for earlier versions. Development dependencies have been updated to include \apnotic\ for iOS notifications, \googleauth\ for Firebase notifications, and \minitest\ (constrained to \< 6.0 to avoid breaking changes). The gemspec also now enforces Multi-Factor Authentication (MFA) for gem pushes.

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

Lenses

  • Code Health 76 → 76 (+0.0)
  • Architecture 69 → 69 (+0.0)
  • Maturity 52 → 57 (+5.2)
  • Readiness 53 → 53 (-0.0)
  • Security 94 → 91 (-3.7)
  • Domain Modelling 100 → 100 (+0.0)

Resolved (5)

  • Confusingly similar method names with different signatures. perform_later and ephemeral_perform_later suggest a simple prefix distinction, but they accept different arguments (event_or_notification vs notifier, recipient, params...), implying different internal mechanisms that are not obvious from the names.
  • Documentation: no project overview (README.md)
  • Duplicate delivery entry points with inconsistent signatures. Deliverable.deliver takes an explicit enqueue_job boolean, while Ephemeral.deliver does not expose this control, forcing users to choose between two different methods for similar intent without a clear distinction in capability.
  • Off-boarding risk: anonymized user #1
  • Semantic redundancy and naming confusion. read/unread and seen/unseen are often used interchangeably in notification systems, yet both pairs are exposed with bang/non-bang variants. This creates 8 methods for essentially two states (read/unread and seen/unseen), leading to user confusion about which pair to use.

New (3)

  • Medium CVE: [GHSA redacted] (Gemfile.lock)
  • Off-boarding risk: anonymized user #1
  • Outdated: rails

Changes since last survey

  • 3 commits — 3 feature/other, 0 fixes

By area

  • (root) — 3 commits

Notable commits

  • change: Keep webhook URLs out of errors and logs (#584)
  • change: Prepare 3.1.1 changelog
  • change: Version bump

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

excid3/noticed 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 5 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 0d91fc5a2723d490f251a1dbf3094c16f8d71638 — 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.