cmeeren/Felicity
56.7
Adequate · 15 November 2026
17.9k
lines of production code
F#
primary language
5
measurements over time
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.