Skip to content
CAI
Software that uses CAICheck a score

cmeeren/Felicity

56.7

Adequate · 15 November 2026

17.9k

lines of production code

F#

primary language

5

measurements over time

CAI band scale
CAI trend line
CAI lens gauges

What this system is

Features

Add JSON API benchmark for resource inclusion performance

Introduces a new benchmark project in Felicity.Benchmarks that measures the performance of fetching resources with included relationships using Giraffe and BenchmarkDotNet. The benchmark configures a test server with a Resource definition including various attribute types and relationships, allowing users to profile the impact of the \include\ query parameter on response generation.

Felicity.Benchmarks · high confidence

Architecture

Adoption of SLNX solution format and .NET SDK 10

The project has migrated from the legacy .sln format to the new SLNX solution format (Felicity.slnx) and updated the required .NET SDK to version 10.0.303 via global.json. This change also includes the removal of the AppVeyor CI configuration in favor of GitHub Actions, the addition of a .git-blame-ignore-revs file to streamline commit history review, and the adoption of DotNet.ReproducibleBuilds to ensure deterministic builds.

(repo-wide) · high confidence

Behavioural changes

Migrate Felicity from Async workflows to native Tasks and add endpoint configuration

The Felicity framework has switched its internal asynchronous execution model from F\# Async workflows to native .NET Tasks, which simplifies the codebase and improves performance by reducing allocations. This change is accompanied by a significant expansion of the \JsonApiConfigBuilder\ in \IServiceCollectionExtensions.fs\, introducing new configuration options such as \relativeJsonApiRoot\, \getMeta\, \getTopLevelLinksWithMeta\, \readRequestBody\, and strict mode settings for unknown fields and query parameters. Additionally, the \Request\ record in \Misc.fs\ now wraps document parsing in \Lazy\<Task\<...\>\>\ to defer body reading until needed, and the \Link\ type now uses \string\ instead of \Uri\ for better performance.

Felicity · high confidence

Migrate async execution from Hopac Jobs to native .NET Tasks

The Felicity library has replaced the Hopac concurrency library with native .NET Tasks (System.Threading.Tasks). This change updates the core API surface, including attribute getters/setters, relationship helpers, and operation context mappers, to use Task-based asynchronous patterns instead of Hopac Jobs. Users will see that all async definitions now return Task or Task\<Result\> types, and the internal Skippable struct used for optional values has been removed in favor of standard Option types.

src/Felicity · high confidence

Migrate to ASP.NET Core endpoint routing

The sample API has been updated to use the modern ASP.NET Core endpoint routing middleware instead of the legacy Giraffe pipeline. This involves replacing the old \Routes.fs\ module with a new \Endpoints.fs\ file and updating \Startup.fs\ to call \UseRouting\, \UseJsonApiEndpoints\, and \UseEndpoints\. Users will notice that the application now relies on the standard \WebApplication.CreateBuilder\ pattern in \Program.fs\ rather than the older \UseStartup\ approach, aligning the sample with current .NET hosting standards.

src/Felicity.SampleApi · high confidence

Refines error handling and code style in the Sample API

The Sample API now uses string interpolation for the 'Invalid query parameter value' error detail message when parsing DateTimeOffset values, and the comment describing Felicity's built-in error coverage has been updated to reflect 'over 100' conditions. Additionally, the codebase has been reformatted to align with standard indentation and style conventions.

Felicity.SampleApi · high confidence

Test coverage

Added integration tests for Felicity JSON:API features; Added integration tests for Felicity JSON:API framework; Updated sample API documentation and spec configuration.

Dependencies

Upgrade to .NET 9 and update core dependencies

The Felicity library and its associated projects have been upgraded to target .NET 9, replacing the previous .NET Core 3.1 and .NET Standard 2.0 targets. This change includes significant dependency updates: Giraffe has been upgraded to version 7.0.2, FSharp.SystemTextJson to 1.3.13, and FSharp.Core to 9.0.101. Additionally, the sample API and integration tests now use .NET 9, with updated test frameworks like Expecto (10.2.1) and Microsoft.NET.Test.Sdk (17.13.0), and the sample API now uses Serilog 4.2.0 and FsToolkit.ErrorHandling 4.18.0.

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

Lenses

  • Code Health 71 → 52 (-19.3)
  • Architecture 95 → 95 (+0.0)
  • Maturity 54 → 53 (-1.2)
  • Readiness 59 → 63 (+4.1)
  • Security 67 → 59 (-8.2)
  • Performance 83 → 94 (+11.4)

Resolved (7)

  • Duplicated block (18 lines × 3) (src/Felicity/Relationships.fs)
  • Duplicated block (22 lines × 3) (src/Felicity/Relationships.fs)
  • Duplicated block (5 lines × 3) (src/Felicity/Relationships.fs)
  • Duplicated block (5 lines × 6) (src/Felicity/Relationships.fs)
  • Duplicated block (9 lines × 2) (src/Felicity/RoutingOperations.fs)
  • IL efficiency: 8 authored method(s) exceed the IL budget (src/Felicity/Routing.fs)
  • No ADRs found

New (10)

  • Edited copy of a member (46 corresponding lines) (src/Felicity/AttributeExtensions.fs)
  • Hotspot: src/Felicity/Routing.fs (src/Felicity/Routing.fs)
  • Hotspot: src/Felicity/RoutingOperations.fs (src/Felicity/RoutingOperations.fs)
  • Low coverage: src/Felicity/AttributeExtensions.fs (src/Felicity/AttributeExtensions.fs)
  • Low coverage: src/Felicity/Id.fs (src/Felicity/Id.fs)
  • Low coverage: src/Felicity/OperationsExtensions.fs (src/Felicity/OperationsExtensions.fs)
  • Low coverage: src/Felicity/RelationshipsExtensionsfs.fs (src/Felicity/RelationshipsExtensionsfs.fs)
  • Low coverage: src/Felicity/RequestParser.fs (src/Felicity/RequestParser.fs)
  • No ADRs found (src/Felicity.SampleApi/Felicity.SampleApi.fsproj)
  • No test project references Felicity.SampleApi (src/Felicity.SampleApi/Felicity.SampleApi.fsproj)

Changes since last survey

  • 1 commits — 1 feature/other, 0 fixes

By area

  • src/Felicity — 1 commit

Notable commits

  • change: Receive request bodies before taking resource locks

Architecture

  • Unchanged — 0 containers · 4 contexts · 3 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

cmeeren/Felicity 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 15 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 73816cdbba6567f4d346b0ebd49dfbf542d6533e — the exact code this score is about.
  • Scored under rubric-2026.11.4 — 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.65+preprod-3c33c1882dc1.