OnurGumus/FCQRS
48.6
Weak · 15 November 2026
26.3k
lines of production code
F#
with C#, Python
5
measurements over time
What this system is
Features
Add C\# getting-started sample for learning FCQRS
A new C\# sample project has been added to demonstrate the FCQRS framework through a runnable document-store example. The sample includes a \DocumentAggregate\ for managing document state (creation, editing, and publication), a \SlugAggregate\ for slug reservation, and a \PublicationSaga\ that coordinates the publication workflow. It also provides a \LegacyCreationReader\ to adapt older event formats for backward compatibility, along with a \Program.cs\ entry point that supports CLI commands for creating, editing, publishing, and recovering documents, as well as a \--check\ mode to run pure domain, replay, and serialization verification tests.
samples/getting-started-csharp · high confidence
Add F\# getting-started sample project
A new F\# sample project has been added to \samples/getting-started-fsharp\, providing a runnable document-store example for learning FCQRS. The project includes \Program.fs\ for the main application logic (handling commands like create, edit, and publish via CLI arguments) and \Checks.fs\ for pure domain, replay, and serialization verification. A \README.md\ documents how to build and run the sample using the .NET 10 SDK, including instructions for checking state, recovering documents, and testing publication workflows.
samples/getting-started-fsharp · high confidence
Added runnable FCQRS registration samples for C\# and F\#
New sample projects have been added for C\# and F\# that demonstrate how to use FCQRS 6.12.0 to register a user. These samples include the aggregate logic, a projection to query the registered name, and a host setup using SQLite for persistence, allowing developers to run and learn from the code directly.
samples/registration-csharp, samples/registration-fsharp · high confidence
FCQRS 6.15.0 introduces ShiftedScheduler for realistic time-shifting in tests
FCQRS 6.15.0 adds ShiftedScheduler, which uses Akka.NET's default scheduler with a configurable time shift to advance real time in tests. This allows tests to simulate days passing while keeping timers, command timeouts, saga handshakes, and cluster sharding behavior aligned with production, unlike virtual clocks that cannot support these real-time interactions.
(repo-wide) · high confidence
Introduce Expecto integration for Gherkin feature testing
The FCQRS.ExpectoTickSpec library now provides a bridge between TickSpec and Expecto, allowing users to run Gherkin feature files as Expecto tests. Feature files are loaded as embedded resources from the caller's assembly, and scenarios are grouped by Gherkin \Rule:\ tags into nested test lists. Test execution behavior is controlled via Gherkin tags: \@focus\ marks tests as focused (running only those tests), while \@pending\ marks them as pending (skipped but reported). A legacy underscore prefix on feature or scenario names also enables focusing. The library caches step definitions per assembly to optimize performance and handles pending features by building them from source without binding steps, preventing failures when step implementations are not yet available.
src/FCQRS.ExpectoTickSpec · high confidence
Introduce saga-based user verification with distributed tracing
The saga\_sample now demonstrates a user registration flow where a saga handles the verification code generation and email notification. This change adds a new UserSaga that reacts to User.VerificationRequested events, generates a code, and sends a mail via a side-effect actor, while also integrating distributed tracing (ActivitySource/SerilogTracing) and Hocon configuration for the scheduler.
_saga\sample · high confidence
New FCQRS tutorial samples for account management
Added a five-step C\# and F\# learning path in the samples/accounts directory that demonstrates core FCQRS capabilities: opening accounts and handling deposits (step 1), enforcing business rules for withdrawals and rejecting invalid commands (step 2), configuring snapshot policies to optimize state reconstruction on restart (step 3), building a transactional SQL projection to maintain a read-model statement table from the event journal (step 4), and implementing a saga-driven money transfer between accounts with idempotency and refund handling (step 5). Also in this area: 1 commit (0 fixes) modifying samples/accounts.
samples/accounts · medium confidence · unverified
New sample application demonstrating FCQRS with distributed tracing
A new sample application has been added to the 'sample' directory, providing a complete reference implementation for the FCQRS library. This sample introduces a User aggregate with registration and login capabilities, wired up with a SQLite query side and a command-side actor system. A key feature of this sample is the integration of distributed tracing: it configures Serilog with SerilogTracing and Seq, and demonstrates how to propagate W3C traceparent identifiers via command correlation IDs to link command execution with query-side projection events. The sample includes bootstrap logic, environment wrappers, and a program entry point that exercises these tracing flows.
sample · high confidence
Support for C\# 15 discriminated unions in JSON serialization
The FCQRS.Serialization module now round-trips C\# 15 discriminated unions via a new \UnionConverterFactory\ that writes a \$case\ discriminator and \$value\ payload. This enables users to serialize and deserialize C\# union types without losing case information, while also enforcing C\# nullable annotations during (de)serialization.
src/FCQRS.Serialization · high confidence
Removals
Removal of CQRS infrastructure module
The CQRS module has been removed from the codebase. This deletes the core implementation files for the Command Query Responsibility Segregation pattern, including the Akka-based Actor logic for handling sagas and events (Actor.fs), common type definitions for commands, events, and saga starters (Common.fs), query subscription and read-journal integration (Query.fs), and the System.Text.Json-based serialization adapter (Serialization.fs).
src/CQRS · high confidence
Behavioural changes
1 commit (0 fixes) modifying samples/orders/9-guard-the-change
A change to existing behaviour in samples/orders/9-guard-the-change — 1 commit, 6 files: “\[fe\] Add workflow tutorial step 9: guard the change with version”.
samples/orders/9-guard-the-change · medium confidence · unverified
17 commits (1 fix) modifying scripts
A change to existing behaviour in scripts — 17 commits (1 fix), 4 files: “\[fe\] Colour type names in the C\# documentation examples”; “\[fe\] Add the workflow tutorial's first program and its run check”; “\[fe\] Add workflow tutorial step 5: restart during shipping”; and 14 more. Also in this area: 1 commit (0 fixes) modifying scripts; 2 commits (0 fixes) modifying scripts; New documentation build and verification scripts.
scripts · medium confidence · unverified
2 commits (1 fix) modifying samples/orders/10-feed-orders-from-a-stream
A change to existing behaviour in samples/orders/10-feed-orders-from-a-stream — 2 commits (1 fix), 6 files: “\[docs\] Fix the review findings of workflow tutorial step 10”; “\[docs\] Add workflow tutorial step 10, which feeds orders from a stream”.
samples/orders/10-feed-orders-from-a-stream · medium confidence · unverified
21 commits (0 fixes) modifying src/FCQRS.Workflows
A change to existing behaviour in src/FCQRS.Workflows — 21 commits, 10 files: “\[be\] Require qualified ScheduleRule cases so Every keeps meaning snapshots”; “\[docs\] State when the schedule dispatcher reads its index while starts run”; “\[be\] Refuse a schedule fire that arrives before its due time”; and 18 more.
(repo-wide) · medium confidence · unverified
45 commits (4 fixes) modifying saga\_sample/bin/Debug/net9.0
A change to existing behaviour in saga\_sample/bin/Debug/net9.0 — 45 commits (4 fixs), 169 files. Also in this area: 9 commits (0 fixes) modifying src/FCQRS; FCQRS library introduces C\# interoperability, .NET 9 support, and Akka-based time provider; Introduce FCQRS, a new F\#-first event-sourcing and saga framework.
src/FCQRS, src/FCQRS.Model · medium confidence · unverified
9 commits (0 fixes) modifying .livedocs/contexts/workflow-tutorial
A change to existing behaviour in .livedocs/contexts/workflow-tutorial — 9 commits, 9 files: “\[fe\] Add workflow tutorial step 5: restart during shipping”; “\[fe\] Add workflow tutorial step 7: when a step fails for good”; “\[fe\] Add workflow tutorial step 8: add a step while an order runs”; and 6 more. Also in this area: 1 commit (0 fixes) modifying .livedocs; Initial FCQRS documentation site structure and tutorial content.
.livedocs · medium confidence · unverified
Fixes query sorting and pagination logic in SQL provider
The SQL provider's query augmentation logic has been corrected to handle sorting and pagination correctly. Secondary sorting (thenBy/thenByDesc) now properly chains onto primary sorting within the same query expression, preventing the ArgumentException that occurred when previous query shapes were rejected. Additionally, pagination now applies Skip before Take, ensuring correct OFFSET/FETCH behavior instead of the previous inverted composition that returned incorrect result sets.
src/FCQRS.SQLProvider · high confidence
Test coverage
6 commits adding/updating tests in test/Workflows.CSharp.Tests; Added Facade.Tests to verify core FCQRS behaviors.
Dependencies
Samples and core libraries migrate to .NET 10 and .NET 11
The documentation examples, sample applications, and core FCQRS libraries now target .NET 10 (with some samples using .NET 11), replacing the previous .NET 8 baseline. This update aligns the project with the latest .NET runtime and includes corresponding dependency upgrades, such as Akka.NET moving from 1.5.28 to 1.5.59 and Akkling from 0.16.2 to 0.17.
(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 52 → 49 (-3.5)
- Rubric changed (rubric-2026.10.5 → rubric-2026.11.4) — scores are not directly comparable.
Lenses
- Code Health 78 → 81 (+2.9)
- Architecture 99 → 97 (-1.9)
- Maturity 80 → 84 (+4.2)
- Readiness 56 → 42 (-14.0)
- Security 32 → 31 (-1.3)
- Performance 85 → 85 (+0.0)
Resolved (19)
- Duplicated block (12–22 lines × 2) (scripts/check-accounts.py)
- Duplicated block (14 lines × 2) (samples/accounts/5-transfer-money/fsharp/Transfer.fs)
- Duplicated block (18 lines × 3) (samples/accounts/2-withdraw-money/fsharp/Account.fs)
- Duplicated block (27 lines × 2) (samples/accounts/5-transfer-money/fsharp/Account.fs)
- Duplicated block (5 lines × 2) (src/FCQRS/Projections.fs)
- Duplicated block (6 lines × 2) (src/FCQRS.Model/CSharpHelpers.fs)
- Duplicated block (6 lines × 2) (src/FCQRS/Serialization.fs)
- Hotspot: samples/getting-started-csharp/Program.cs (samples/getting-started-csharp/Program.cs)
- Hotspot: src/FCQRS.SQLProvider/Query.fs (src/FCQRS.SQLProvider/Query.fs)
- Hotspot: src/FCQRS/SchedulerController.fs (src/FCQRS/SchedulerController.fs)
- IL efficiency: 14 authored method(s) exceed the IL budget (src/FCQRS/Saga.fs)
- Members sharing a duplicated core (5 members, 50+ identical tokens) (samples/accounts/2-withdraw-money/fsharp/Account.fs)
- build-docs.finish (cognitive 28) (scripts/build-docs.py)
- build-docs.finish (cyclomatic 16) (scripts/build-docs.py)
- build-docs.prepare (cognitive 16) (scripts/build-docs.py)
- check-doc-links.main (cognitive 26) (scripts/check-doc-links.py)
- top-level statements (cognitive 23) (samples/getting-started-csharp/Program.cs)
- top-level statements (cyclomatic 16) (samples/accounts/6-add-a-memo/csharp/Program.cs)
- top-level statements (cyclomatic 20) (samples/getting-started-csharp/Program.cs)
New (104)
- Duplicated block (10–12 lines × 2) (scripts/check-orders.py)
- Duplicated block (11 lines × 5) (samples/orders/10-feed-orders-from-a-stream/csharp/Account.cs)
- Duplicated block (11 lines × 8) (samples/orders/2-retry-the-warehouse/fsharp/Program.fs)
- Duplicated block (12 lines × 2) (src/FCQRS.Workflows/CSharp.fs)
- Duplicated block (12 lines × 5) (samples/orders/10-feed-orders-from-a-stream/fsharp/Order.fs)
- Duplicated block (13 lines × 5) (samples/orders/10-feed-orders-from-a-stream/csharp/Account.cs)
- Duplicated block (14 lines × 2) (samples/orders/6-charge-the-customer/fsharp/Order.fs)
- Duplicated block (14 lines × 4) (samples/orders/10-feed-orders-from-a-stream/csharp/Order.cs)
- Duplicated block (14–19 lines × 8) (samples/orders/2-retry-the-warehouse/csharp/Program.cs)
- Duplicated block (14–20 lines × 5) (samples/orders/5-restart-during-shipping/csharp/Program.cs)
- Duplicated block (15 lines × 3) (samples/orders/7-when-a-step-fails/csharp/Program.cs)
- Duplicated block (15 lines × 6) (samples/orders/4-wait-for-approval/fsharp/Program.fs)
- Duplicated block (15 lines × 7) (samples/orders/10-feed-orders-from-a-stream/csharp/Order.cs)
- Duplicated block (15–16 lines × 3) (samples/orders/3-read-the-clock/fsharp/Program.fs)
- Duplicated block (16 lines × 3) (samples/orders/4-wait-for-approval/fsharp/Order.fs)
- Duplicated block (16–17 lines × 5) (samples/orders/10-feed-orders-from-a-stream/csharp/Order.cs)
- Duplicated block (16–22 lines × 4) (samples/orders/4-wait-for-approval/csharp/Order.cs)
- Duplicated block (17 lines × 3) (samples/orders/4-wait-for-approval/fsharp/Program.fs)
- Duplicated block (17 lines × 4) (samples/orders/10-feed-orders-from-a-stream/fsharp/Order.fs)
- Duplicated block (17 lines × 6) (samples/orders/1-place-an-order/csharp/Program.cs)
- …and 84 more
Changes since last survey
- 88 commits — 86 feature/other, 2 fixes
By area
- src/FCQRS.Workflows — 23 commits
- (root) — 14 commits
- samples/orders — 13 commits
- src/FCQRS — 10 commits
- docs/how-to — 5 commits
- test/Facade.Tests — 5 commits
- docs/workflow-tutorial — 3 commits
- docs/concepts — 2 commits
- docs/content — 2 commits
- .github/workflows — 1 commit
- design/plans — 1 commit
- design/specs — 1 commit
- samples/accounts — 1 commit
- samples/workflows — 1 commit
- scripts/check-learning-snippets.py — 1 commit
- specs/2026-11-13-workflow-tutorial-design.md — 1 commit
- specs/2026-11-14-schedule-index-design.md — 1 commit
- specs/2026-11-14-workflow-schedules-design.md — 1 commit
- specs/2026-11-14-workflow-schedules-plan.md — 1 commit
- specs/2026-11-14-workflow-tutorial-streams-design.md — 1 commit
Notable commits
- fix: [docs] Fix the review findings of workflow tutorial step 10
- fix: [fe] Fix the workflow tutorial's record numbers and check pages against output
- change: Add Agents.MD
- change: ExpectoTickSpec 6.1.0: pending scenarios never bind; discover and a Pending list
- change: [be] Bind the saga-refusal correlation ID before raise so Debug builds can send commands
- change: [be] Bound the due times a schedule catches up on
- change: [be] Bring the next pass back when the clock steps back
- change: [be] Compute schedule due times without an actor system
- change: [be] Decide schedule commands in an aggregate so a stale index cannot start a run
- change: [be] Give C# a WorkflowFlow that emits faulted workflows as elements
- change: [be] Give up a schedule run whose input cannot be read, and reserve fcqrs- projection names
- change: [be] Hand out schedule slots from a ready queue so a burst costs linear work
- change: [be] Keep caller input and unwired starters from terminating the process
- change: [be] Keep the schedule index in a table so restarts stop rereading run history
- change: [be] Let a projection read only the entity types it names
- change: [be] Let a schedule be created without a catch-up policy, as Latest
- change: [be] Let a workflow body recurse to any depth
- change: [be] Match entity filters to escaped persistence IDs and use the SQLite index
- change: [be] Name the schedule index in register's journal error and check it before registering
- change: [be] Read a filtered SQLite listing and capture by journal number
- …and 68 more
API surface
- Unchanged — 4 HTTP endpoints
Written by cca.canine.dev from the codebase's own history, inside the signed delivery this page is composed from.
Survey your own repository
OnurGumus/FCQRS 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 57ae99e7d9bcfc8a5ac65e0a1e249aa6e33e2a5e — 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.